Initial vibecoded proof of concept

lua/notex/utils/init.lua

@@ -0,0 +1,213 @@
+-- Core utility functions
+local M = {}
+
+-- Import submodules
+local logging = require('notex.utils.logging')
+local errors = require('notex.utils.errors')
+local types = require('notex.utils.types')
+local validation = require('notex.utils.validation')
+local date_utils = require('notex.utils.date')
+local cache = require('notex.utils.cache')
+
+-- Generate unique ID
+function M.generate_id()
+  local template = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'
+  return string.gsub(template, '[xy]', function(c)
+    local v = (c == 'x') and math.random(0, 0xf) or math.random(8, 0xb)
+    return string.format('%x', v)
+  end)
+end
+
+-- Generate SHA256 hash
+function M.sha256(data)
+  local cmd = string.format("echo '%s' | sha256sum | cut -d' ' -f1", data)
+  local handle = io.popen(cmd)
+  if not handle then
+    return nil
+  end
+
+  local result = handle:read("*a")
+  handle:close()
+
+  return result:gsub("%s+", "")
+end
+
+-- Deep merge tables
+function M.deep_merge(target, source)
+  for key, value in pairs(source) do
+    if type(value) == 'table' and type(target[key]) == 'table' then
+      M.deep_merge(target[key], value)
+    else
+      target[key] = value
+    end
+  end
+  return target
+end
+
+-- Check if file exists
+function M.file_exists(path)
+  local f = io.open(path, "r")
+  if f then
+    f:close()
+    return true
+  end
+  return false
+end
+
+-- Read file content
+function M.read_file(path)
+  local file = io.open(path, "r")
+  if not file then
+    return nil, "Cannot open file: " .. path
+  end
+
+  local content = file:read("*a")
+  file:close()
+
+  return content
+end
+
+-- Write file content
+function M.write_file(path, content)
+  local file = io.open(path, "w")
+  if not file then
+    return false, "Cannot write to file: " .. path
+  end
+
+  file:write(content)
+  file:close()
+
+  return true
+end
+
+-- Get file modification time
+function M.get_file_mtime(path)
+  local handle = io.popen("stat -c %Y " .. path .. " 2>/dev/null")
+  if not handle then
+    return nil
+  end
+
+  local result = handle:read("*a")
+  handle:close()
+
+  local mtime = tonumber(result:gsub("%s+", ""))
+  return mtime
+end
+
+-- Validate file encoding (UTF-8 check)
+function M.is_utf8(path)
+  local file = io.open(path, "rb")
+  if not file then
+    return false
+  end
+
+  local content = file:read("*a")
+  file:close()
+
+  -- Simple UTF-8 validation
+  local valid, pos = utf8.len(content)
+  return valid ~= nil
+end
+
+-- Format error message
+function M.format_error(error_type, message, context)
+  local error_obj = {
+    error_type = error_type,
+    message = message,
+    timestamp = os.time()
+  }
+
+  if context then
+    error_obj.context = context
+  end
+
+  return error_obj
+end
+
+-- Forward logging functions to centralized logging
+M.trace = logging.trace
+M.debug = logging.debug
+M.info = logging.info
+M.warn = logging.warn
+M.error = logging.error
+M.fatal = logging.fatal
+M.log = logging.log
+M.timer = logging.timer
+
+-- Forward error handling functions
+M.handle_error = errors.handle_error
+M.safe_execute = errors.safe_execute
+M.wrap = errors.wrap
+M.create_error = errors.create_error
+
+-- Forward type utilities
+M.detect_type = types.detect_type
+M.convert_to_type = types.convert_to_type
+M.infer_schema = types.infer_schema
+
+-- Forward validation utilities
+M.validate_value = validation.validate_value
+M.validate_document_properties = validation.validate_document_properties
+M.sanitize_input = validation.sanitize_input
+
+-- Forward date utilities
+M.parse_date = date_utils.parse_date
+M.format_date = date_utils.format_date
+M.get_relative_time = date_utils.get_relative_time
+
+-- Forward cache utilities
+M.cache_set = cache.set
+M.cache_get = cache.get
+M.cache_get_or_set = cache.get_or_set
+M.cache_invalidate = cache.invalidate
+M.cache_clear_all = cache.clear_all
+M.cache_get_stats = cache.get_stats
+M.cache_init = cache.init
+
+-- Simple timer for backward compatibility
+function M.simple_timer(name)
+  local start_time = vim.loop.hrtime()
+
+  return function()
+    local end_time = vim.loop.hrtime()
+    local elapsed_ms = (end_time - start_time) / 1e6
+    M.log("INFO", string.format("%s completed in %.2fms", name, elapsed_ms))
+    return elapsed_ms
+  end
+end
+
+-- Validate data types
+function M.validate_type(value, expected_type)
+  local actual_type = type(value)
+
+  if expected_type == "number" then
+    return actual_type == "number"
+  elseif expected_type == "string" then
+    return actual_type == "string"
+  elseif expected_type == "boolean" then
+    return actual_type == "boolean"
+  elseif expected_type == "table" then
+    return actual_type == "table"
+  elseif expected_type == "function" then
+    return actual_type == "function"
+  end
+
+  return false
+end
+
+-- Escape SQL values
+function M.escape_sql(value)
+  if type(value) == "string" then
+    return "'" .. value:gsub("'", "''") .. "'"
+  elseif type(value) == "number" then
+    return tostring(value)
+  elseif type(value) == "boolean" then
+    return value and "1" or "0"
+  elseif value == nil then
+    return "NULL"
+  else
+    return "'" .. tostring(value):gsub("'", "''") .. "'"
+  end
+end
+
+return M