noormme 1.1.0 → 1.2.0

package/dist/esm/util/security-validator.js

@@ -53,7 +53,12 @@ export function validateIdentifier(identifier, context = 'identifier') {
     }
     // Additional check: prevent reserved SQLite keywords that could be dangerous
     const reservedKeywords = [
-        'PRAGMA', 'ATTACH', 'DETACH', 'VACUUM', 'ANALYZE', 'REINDEX'
+        'PRAGMA',
+        'ATTACH',
+        'DETACH',
+        'VACUUM',
+        'ANALYZE',
+        'REINDEX',
     ];
     for (const keyword of reservedKeywords) {
         if (identifier.toUpperCase() === keyword) {
@@ -74,7 +79,11 @@ export function validateTableReference(tableRef) {
     }
     // Validate each part
     parts.forEach((part, index) => {
-        const context = index === 0 ? (parts.length === 2 ? 'schema name' : 'table name') : 'table name';
+        const context = index === 0
+            ? parts.length === 2
+                ? 'schema name'
+                : 'table name'
+            : 'table name';
         validateIdentifier(part, context);
     });
 }
@@ -99,7 +108,8 @@ export function validateColumnReference(columnRef) {
             context = index === 0 ? 'table name' : 'column name';
         }
         else {
-            context = index === 0 ? 'schema name' : (index === 1 ? 'table name' : 'column name');
+            context =
+                index === 0 ? 'schema name' : index === 1 ? 'table name' : 'column name';
         }
         validateIdentifier(part, context);
     });
@@ -131,7 +141,7 @@ export function validateFilePath(filePath, allowedExtensions) {
     }
     // Validate file extension if specified
     if (allowedExtensions && allowedExtensions.length > 0) {
-        const hasValidExtension = allowedExtensions.some(ext => filePath.toLowerCase().endsWith(ext.toLowerCase()));
+        const hasValidExtension = allowedExtensions.some((ext) => filePath.toLowerCase().endsWith(ext.toLowerCase()));
         if (!hasValidExtension) {
             throw new Error(`Invalid file extension for "${filePath}". ` +
                 `Allowed extensions: ${allowedExtensions.join(', ')}`);
@@ -155,7 +165,9 @@ export function validateFilePath(filePath, allowedExtensions) {
 export function sanitizeDatabasePath(dbPath) {
     validateFilePath(dbPath, ['.db', '.sqlite', '.sqlite3', '.db3']);
     // Ensure the path doesn't escape current directory
-    if (dbPath.includes('..') || dbPath.startsWith('/') || /^[a-zA-Z]:/.test(dbPath)) {
+    if (dbPath.includes('..') ||
+        dbPath.startsWith('/') ||
+        /^[a-zA-Z]:/.test(dbPath)) {
         throw new Error(`Database path "${dbPath}" must be a relative path within the current directory`);
     }
     return dbPath;
@@ -212,8 +224,7 @@ export class RateLimiter {
     maxAttempts;
     windowMs;
     attempts = new Map();
-    constructor(maxAttempts = 10, windowMs = 60000 // 1 minute
-    ) {
+    constructor(maxAttempts = 10, windowMs = 60000) {
         this.maxAttempts = maxAttempts;
         this.windowMs = windowMs;
     }
@@ -221,7 +232,7 @@ export class RateLimiter {
         const now = Date.now();
         const attempts = this.attempts.get(key) || [];
         // Remove old attempts outside the window
-        const recentAttempts = attempts.filter(time => now - time < this.windowMs);
+        const recentAttempts = attempts.filter((time) => now - time < this.windowMs);
         if (recentAttempts.length >= this.maxAttempts) {
             throw new Error(`Rate limit exceeded for ${key}. Please wait before trying again.`);
         }
@@ -234,7 +245,7 @@ export class RateLimiter {
     }
     cleanup(now) {
         for (const [key, attempts] of this.attempts.entries()) {
-            const recentAttempts = attempts.filter(time => now - time < this.windowMs);
+            const recentAttempts = attempts.filter((time) => now - time < this.windowMs);
             if (recentAttempts.length === 0) {
                 this.attempts.delete(key);
             }

package/dist/esm/utils/errorHelpers.js

@@ -1,5 +1,5 @@
 /// <reference types="./errorHelpers.d.ts" />
-import { NoormError, ColumnNotFoundError, TableNotFoundError, ConnectionError } from '../errors/NoormError.js';
+import { NoormError, ColumnNotFoundError, TableNotFoundError, ConnectionError, } from '../errors/NoormError.js';
 /**
  * Wraps Kysely errors with more context-aware NoormError instances
  */
@@ -20,11 +20,15 @@ export function wrapKyselyError(error, context) {
         }
     }
     // Handle connection errors
-    if (message.includes('connect') || message.includes('ECONNREFUSED') || message.includes('ENOTFOUND')) {
+    if (message.includes('connect') ||
+        message.includes('ECONNREFUSED') ||
+        message.includes('ENOTFOUND')) {
         return new ConnectionError(message, error);
     }
     // Handle authentication errors
-    if (message.includes('authentication') || message.includes('password') || message.includes('SASL')) {
+    if (message.includes('authentication') ||
+        message.includes('password') ||
+        message.includes('SASL')) {
         return new ConnectionError('Authentication failed. Check your username and password.', error);
     }
     // Handle syntax errors
@@ -32,17 +36,19 @@ export function wrapKyselyError(error, context) {
         return new NoormError(`SQL syntax error: ${message}`, {
             table: context.table,
             operation: context.operation,
-            suggestion: 'Check your query syntax or report this as a bug if you\'re using NOORMME methods',
-            originalError: error
+            suggestion: "Check your query syntax or report this as a bug if you're using NOORMME methods",
+            originalError: error,
         });
     }
     // Handle constraint violations
-    if (message.includes('constraint') || message.includes('duplicate') || message.includes('unique')) {
+    if (message.includes('constraint') ||
+        message.includes('duplicate') ||
+        message.includes('unique')) {
         return new NoormError(`Database constraint violation: ${extractConstraintMessage(message)}`, {
             table: context.table,
             operation: context.operation,
             suggestion: 'Check for duplicate values or foreign key violations',
-            originalError: error
+            originalError: error,
         });
     }
     // Generic wrapper for other errors
@@ -50,7 +56,7 @@ export function wrapKyselyError(error, context) {
         table: context.table,
         operation: context.operation,
         suggestion: 'Check the database connection and query parameters',
-        originalError: error
+        originalError: error,
     });
 }
 /**
@@ -115,14 +121,15 @@ export function suggestCorrections(input, available, maxSuggestions = 3) {
     const suggestions = [];
     for (const option of available) {
         const score = calculateSimilarity(input.toLowerCase(), option.toLowerCase());
-        if (score > 0.3) { // Only suggest if similarity > 30%
+        if (score > 0.3) {
+            // Only suggest if similarity > 30%
             suggestions.push({ name: option, score });
         }
     }
     return suggestions
         .sort((a, b) => b.score - a.score)
         .slice(0, maxSuggestions)
-        .map(s => s.name);
+        .map((s) => s.name);
 }
 /**
  * Calculate string similarity using Jaro-Winkler algorithm (simplified)
@@ -167,7 +174,10 @@ function calculateSimilarity(str1, str2) {
             transpositions++;
         k++;
     }
-    const jaro = (matches / len1 + matches / len2 + (matches - transpositions / 2) / matches) / 3;
+    const jaro = (matches / len1 +
+        matches / len2 +
+        (matches - transpositions / 2) / matches) /
+        3;
     // Jaro-Winkler bonus for common prefix
     let prefix = 0;
     for (let i = 0; i < Math.min(len1, len2, 4); i++) {

package/dist/esm/watch/schema-watcher.js

@@ -25,7 +25,7 @@ export class SchemaWatcher {
             ignoreViews: true,
             ignoredTables: [],
             enabled: options.enabled !== undefined ? options.enabled : defaultEnabled,
-            ...options
+            ...options,
         };
     }
     /**
@@ -55,7 +55,7 @@ export class SchemaWatcher {
         }
         this.isWatching = true;
         this.intervalId = setInterval(() => {
-            this.checkForChanges().catch(error => {
+            this.checkForChanges().catch((error) => {
                 this.logger.error('Error checking for schema changes:', error);
             });
         }, this.options.pollInterval);
@@ -139,23 +139,22 @@ export class SchemaWatcher {
         // Create a deterministic string representation of the schema
         const schemaString = JSON.stringify({
             tables: schema.tables
-                .filter(table => !this.options.ignoredTables?.includes(table.name))
-                .map(table => ({
+                .filter((table) => !this.options.ignoredTables?.includes(table.name))
+                .map((table) => ({
                 name: table.name,
-                columns: table.columns.map(col => ({
+                columns: table.columns.map((col) => ({
                     name: col.name,
                     type: col.type,
                     nullable: col.nullable,
                     isPrimaryKey: col.isPrimaryKey,
-                    defaultValue: col.defaultValue
+                    defaultValue: col.defaultValue,
                 })),
                 primaryKey: table.primaryKey,
                 foreignKeys: table.foreignKeys,
-                indexes: table.indexes
+                indexes: table.indexes,
             }))
                 .sort((a, b) => a.name.localeCompare(b.name)),
-            relationships: schema.relationships
-                .sort((a, b) => `${a.fromTable}.${a.name}`.localeCompare(`${b.fromTable}.${b.name}`))
+            relationships: schema.relationships.sort((a, b) => `${a.fromTable}.${a.name}`.localeCompare(`${b.fromTable}.${b.name}`)),
         });
         return createHash('sha256').update(schemaString).digest('hex');
     }
@@ -173,20 +172,20 @@ export class SchemaWatcher {
                 changes.push({
                     type: 'table_added',
                     table: table.name,
-                    details: { columns: table.columns.length }
+                    details: { columns: table.columns.length },
                 });
             }
             return changes;
         }
-        const oldTablesMap = new Map(oldSchema.tables.map(t => [t.name, t]));
-        const newTablesMap = new Map(newSchema.tables.map(t => [t.name, t]));
+        const oldTablesMap = new Map(oldSchema.tables.map((t) => [t.name, t]));
+        const newTablesMap = new Map(newSchema.tables.map((t) => [t.name, t]));
         // Check for added tables
         for (const table of newSchema.tables) {
             if (!oldTablesMap.has(table.name)) {
                 changes.push({
                     type: 'table_added',
                     table: table.name,
-                    details: { columns: table.columns.length }
+                    details: { columns: table.columns.length },
                 });
             }
         }
@@ -195,7 +194,7 @@ export class SchemaWatcher {
             if (!newTablesMap.has(table.name)) {
                 changes.push({
                     type: 'table_removed',
-                    table: table.name
+                    table: table.name,
                 });
             }
         }
@@ -203,8 +202,8 @@ export class SchemaWatcher {
         for (const newTable of newSchema.tables) {
             const oldTable = oldTablesMap.get(newTable.name);
             if (oldTable) {
-                const oldColumnsMap = new Map(oldTable.columns.map(c => [c.name, c]));
-                const newColumnsMap = new Map(newTable.columns.map(c => [c.name, c]));
+                const oldColumnsMap = new Map(oldTable.columns.map((c) => [c.name, c]));
+                const newColumnsMap = new Map(newTable.columns.map((c) => [c.name, c]));
                 // Check for added columns
                 for (const column of newTable.columns) {
                     if (!oldColumnsMap.has(column.name)) {
@@ -212,7 +211,7 @@ export class SchemaWatcher {
                             type: 'column_added',
                             table: newTable.name,
                             column: column.name,
-                            details: { type: column.type }
+                            details: { type: column.type },
                         });
                     }
                 }
@@ -222,7 +221,7 @@ export class SchemaWatcher {
                         changes.push({
                             type: 'column_removed',
                             table: newTable.name,
-                            column: column.name
+                            column: column.name,
                         });
                     }
                     else {
@@ -235,8 +234,8 @@ export class SchemaWatcher {
                                 column: column.name,
                                 details: {
                                     old: { type: column.type, nullable: column.nullable },
-                                    new: { type: newColumn.type, nullable: newColumn.nullable }
-                                }
+                                    new: { type: newColumn.type, nullable: newColumn.nullable },
+                                },
                             });
                         }
                     }
@@ -246,15 +245,15 @@ export class SchemaWatcher {
         return changes;
     }
     isColumnModified(oldCol, newCol) {
-        return oldCol.type !== newCol.type ||
+        return (oldCol.type !== newCol.type ||
             oldCol.nullable !== newCol.nullable ||
-            oldCol.isPrimaryKey !== newCol.isPrimaryKey;
+            oldCol.isPrimaryKey !== newCol.isPrimaryKey);
     }
     /**
      * Notify all registered callbacks about schema changes
      */
     notifyCallbacks(changes) {
-        this.callbacks.forEach(callback => {
+        this.callbacks.forEach((callback) => {
             try {
                 callback(changes);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "noormme",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "NOORMME - The Agentic Data Engine. High-fidelity persistence and cognitive governance for Autonomous AI Agents.",
   "repository": {
     "type": "git",
@@ -60,48 +60,6 @@
       "default": "./dist/cjs/cli/index.js"
     }
   },
-  "scripts": {
-    "clean": "rm -rf dist & rm -rf test/node/dist & rm -rf test/browser/bundle.js & rm -rf helpers",
-    "bench:ts": "pnpm build && cd ./test/ts-benchmarks && node --experimental-strip-types ./index.ts",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "test:unit": "jest tests/unit",
-    "test:integration": "jest tests/integration",
-    "test:cli": "jest tests/cli",
-    "test:original": "pnpm build && pnpm test:node:build && pnpm test:node:run && pnpm test:typings && pnpm test:esmimports && pnpm test:exports",
-    "test:node:build": "tsc -p test/node",
-    "test:node": "pnpm build && pnpm test:node:build && pnpm test:node:run",
-    "test:node:run": "mocha --timeout 15000 test/node/dist/**/*.test.js",
-    "test:browser:build": "rm -rf test/browser/bundle.js && esbuild test/browser/main.ts --bundle --outfile=test/browser/bundle.js",
-    "test:browser": "pnpm build && pnpm test:browser:build && node test/browser/test.js",
-    "test:bun": "pnpm build && bun link && cd test/bun && bun install && bun run test",
-    "test:cloudflare-workers": "pnpm build && pnpm -r test --filter kysely-cloudflare-workers-test",
-    "test:deno": "deno run --allow-env --allow-read --allow-net --no-lock test/deno/local.test.ts && deno run --allow-env --allow-read --allow-net --no-lock test/deno/cdn.test.ts",
-    "test:typings": "tsd test/typings",
-    "test:esmimports": "node scripts/check-esm-imports.js",
-    "test:esbuild": "esbuild --bundle --platform=node --external:pg-native dist/esm/index.js --outfile=/dev/null",
-    "test:exports": "attw --pack . && node scripts/check-exports.js",
-    "test:jsdocs": "deno check --doc-only --no-lock --unstable-sloppy-imports --config=\"deno.check.json\" ./src",
-    "test:outdatedts": "pnpm build && cd test/outdated-ts && pnpm i && pnpm test",
-    "prettier": "prettier --write 'src/**/*.ts' 'test/**/*.ts'",
-    "build": "pnpm clean && (pnpm build:esm & pnpm build:cjs) && pnpm script:module-fixup && pnpm script:copy-interface-doc",
-    "build:esm": "tsc -p tsconfig.json && pnpm script:add-deno-type-references",
-    "build:cjs": "tsc -p tsconfig-cjs.json",
-    "script:module-fixup": "node scripts/module-fixup.js",
-    "script:copy-interface-doc": "node scripts/copy-interface-documentation.js",
-    "script:add-deno-type-references": "node scripts/add-deno-type-references.js",
-    "script:align-site-version": "node --experimental-strip-types scripts/align-site-version.mts",
-    "script:generate-site-examples": "node scripts/generate-site-examples.js",
-    "script:exclude-test-files-for-backwards-compat": "node --experimental-strip-types scripts/exclude-test-files-for-backwards-compat.mts",
-    "prepublishOnly": "pnpm build",
-    "version": "pnpm script:align-site-version && git add .",
-    "postversion": "pnpm publish --no-git-checks",
-    "prepack": "pnpm build",
-    "postpack": "echo 'Package ready for npm publish'",
-    "publish:dry-run": "pnpm build && npm pack --dry-run",
-    "publish:check": "pnpm build && npm publish --dry-run"
-  },
   "author": "NOORMME Team",
   "license": "MIT",
   "devDependencies": {
@@ -136,7 +94,6 @@
     "tsd": "^0.33.0",
     "typescript": "~5.9.2"
   },
-  "packageManager": "pnpm@10.16.1+sha512.0e155aa2629db8672b49e8475da6226aa4bdea85fdcdfdc15350874946d4f3c91faaf64cbdc4a5d1ab8002f473d5c3fcedcd197989cf0390f9badd3c04678706",
   "dependencies": {
     "better-sqlite3": "^12.4.1",
     "chalk": "^5.0.0",
@@ -149,5 +106,44 @@
   },
   "bin": {
     "noormme": "./dist/cjs/cli/index.js"
+  },
+  "scripts": {
+    "clean": "rm -rf dist & rm -rf test/node/dist & rm -rf test/browser/bundle.js & rm -rf helpers",
+    "bench:ts": "pnpm build && cd ./test/ts-benchmarks && node --experimental-strip-types ./index.ts",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:unit": "jest tests/unit",
+    "test:integration": "jest tests/integration",
+    "test:cli": "jest tests/cli",
+    "test:original": "pnpm build && pnpm test:node:build && pnpm test:node:run && pnpm test:typings && pnpm test:esmimports && pnpm test:exports",
+    "test:node:build": "tsc -p test/node",
+    "test:node": "pnpm build && pnpm test:node:build && pnpm test:node:run",
+    "test:node:run": "mocha --timeout 15000 test/node/dist/**/*.test.js",
+    "test:browser:build": "rm -rf test/browser/bundle.js && esbuild test/browser/main.ts --bundle --outfile=test/browser/bundle.js",
+    "test:browser": "pnpm build && pnpm test:browser:build && node test/browser/test.js",
+    "test:bun": "pnpm build && bun link && cd test/bun && bun install && bun run test",
+    "test:cloudflare-workers": "pnpm build && pnpm -r test --filter kysely-cloudflare-workers-test",
+    "test:deno": "deno run --allow-env --allow-read --allow-net --no-lock test/deno/local.test.ts && deno run --allow-env --allow-read --allow-net --no-lock test/deno/cdn.test.ts",
+    "test:typings": "tsd test/typings",
+    "test:esmimports": "node scripts/check-esm-imports.js",
+    "test:esbuild": "esbuild --bundle --platform=node --external:pg-native dist/esm/index.js --outfile=/dev/null",
+    "test:exports": "attw --pack . && node scripts/check-exports.js",
+    "test:jsdocs": "deno check --doc-only --no-lock --unstable-sloppy-imports --config=\"deno.check.json\" ./src",
+    "test:outdatedts": "pnpm build && cd test/outdated-ts && pnpm i && pnpm test",
+    "prettier": "prettier --write 'src/**/*.ts' 'test/**/*.ts'",
+    "build": "pnpm clean && (pnpm build:esm & pnpm build:cjs) && pnpm script:module-fixup && pnpm script:copy-interface-doc",
+    "build:esm": "tsc -p tsconfig.json && pnpm script:add-deno-type-references",
+    "build:cjs": "tsc -p tsconfig-cjs.json",
+    "script:module-fixup": "node scripts/module-fixup.js",
+    "script:copy-interface-doc": "node scripts/copy-interface-documentation.js",
+    "script:add-deno-type-references": "node scripts/add-deno-type-references.js",
+    "script:align-site-version": "node --experimental-strip-types scripts/align-site-version.mts",
+    "script:generate-site-examples": "node scripts/generate-site-examples.js",
+    "script:exclude-test-files-for-backwards-compat": "node --experimental-strip-types scripts/exclude-test-files-for-backwards-compat.mts",
+    "version": "pnpm script:align-site-version && git add .",
+    "postversion": "pnpm publish --no-git-checks",
+    "publish:dry-run": "pnpm build && npm pack --dry-run",
+    "publish:check": "pnpm build && npm publish --dry-run"
   }
 }