@nicia-ai/typegraph 0.3.1 → 0.4.0

package/dist/backend/drizzle/index.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunkCMHFS34N_cjs = require('../../chunk-CMHFS34N.cjs');
-var chunkF23W4W3A_cjs = require('../../chunk-F23W4W3A.cjs');
-require('../../chunk-SFY2PPOY.cjs');
+var chunkNYDXJGA3_cjs = require('../../chunk-NYDXJGA3.cjs');
+var chunkLUARLSYT_cjs = require('../../chunk-LUARLSYT.cjs');
+require('../../chunk-7RVSDXT3.cjs');
 var chunkXZL6MCZJ_cjs = require('../../chunk-XZL6MCZJ.cjs');
 var chunkNU2XNMVI_cjs = require('../../chunk-NU2XNMVI.cjs');
-require('../../chunk-OYL2SGBD.cjs');
+require('../../chunk-44SXEVF4.cjs');
 require('../../chunk-JQDWEX6V.cjs');
 require('../../chunk-2WVFEIHR.cjs');
 require('../../chunk-P5CNM325.cjs');
@@ -14,11 +14,11 @@ require('../../chunk-P5CNM325.cjs');
 
 Object.defineProperty(exports, "createSqliteBackend", {
   enumerable: true,
-  get: function () { return chunkCMHFS34N_cjs.createSqliteBackend; }
+  get: function () { return chunkNYDXJGA3_cjs.createSqliteBackend; }
 });
 Object.defineProperty(exports, "createPostgresBackend", {
   enumerable: true,
-  get: function () { return chunkF23W4W3A_cjs.createPostgresBackend; }
+  get: function () { return chunkLUARLSYT_cjs.createPostgresBackend; }
 });
 Object.defineProperty(exports, "createSqliteTables", {
   enumerable: true,

package/dist/backend/drizzle/index.d.cts

@@ -2,7 +2,7 @@ export { SqliteBackendOptions, createSqliteBackend } from './sqlite.cjs';
 export { PostgresBackendOptions, createPostgresBackend } from './postgres.cjs';
 export { PostgresTables, createPostgresTables, tables as postgresTables } from './schema/postgres.cjs';
 export { SqliteTables, createSqliteTables, tables as sqliteTables } from './schema/sqlite.cjs';
-import '../../types-DDP0MGBF.cjs';
+import '../../types-BUy-pHKH.cjs';
 import 'drizzle-orm';
 import '../../types-DTJEu_-h.cjs';
 import 'zod';

package/dist/backend/drizzle/index.d.ts

@@ -2,7 +2,7 @@ export { SqliteBackendOptions, createSqliteBackend } from './sqlite.js';
 export { PostgresBackendOptions, createPostgresBackend } from './postgres.js';
 export { PostgresTables, createPostgresTables, tables as postgresTables } from './schema/postgres.js';
 export { SqliteTables, createSqliteTables, tables as sqliteTables } from './schema/sqlite.js';
-import '../../types-Cdbi4hcx.js';
+import '../../types-6EKrWTs9.js';
 import 'drizzle-orm';
 import '../../types-DTJEu_-h.js';
 import 'zod';

package/dist/backend/drizzle/index.js

@@ -1,9 +1,9 @@
-export { createSqliteBackend } from '../../chunk-F2BZSEFE.js';
-export { createPostgresBackend } from '../../chunk-46YY2FRV.js';
-import '../../chunk-4HARSV2G.js';
+export { createSqliteBackend } from '../../chunk-ZO2FRJ2U.js';
+export { createPostgresBackend } from '../../chunk-Q6PXIKRQ.js';
+import '../../chunk-ZQGOBVXZ.js';
 export { createSqliteTables, tables as sqliteTables } from '../../chunk-OGGLFYFA.js';
 export { createPostgresTables, tables as postgresTables } from '../../chunk-3PURVEA4.js';
-import '../../chunk-O5XPCJLF.js';
+import '../../chunk-SJ2QMDXY.js';
 import '../../chunk-U3452TEU.js';
 import '../../chunk-54WJF3DW.js';
 import '../../chunk-K7SQ3SWP.js';

package/dist/backend/drizzle/postgres.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkF23W4W3A_cjs = require('../../chunk-F23W4W3A.cjs');
-require('../../chunk-SFY2PPOY.cjs');
+var chunkLUARLSYT_cjs = require('../../chunk-LUARLSYT.cjs');
+require('../../chunk-7RVSDXT3.cjs');
 var chunkNU2XNMVI_cjs = require('../../chunk-NU2XNMVI.cjs');
-require('../../chunk-OYL2SGBD.cjs');
+require('../../chunk-44SXEVF4.cjs');
 require('../../chunk-JQDWEX6V.cjs');
 require('../../chunk-2WVFEIHR.cjs');
 require('../../chunk-P5CNM325.cjs');
@@ -12,7 +12,7 @@ require('../../chunk-P5CNM325.cjs');
 
 Object.defineProperty(exports, "createPostgresBackend", {
   enumerable: true,
-  get: function () { return chunkF23W4W3A_cjs.createPostgresBackend; }
+  get: function () { return chunkLUARLSYT_cjs.createPostgresBackend; }
 });
 Object.defineProperty(exports, "createPostgresTables", {
   enumerable: true,

package/dist/backend/drizzle/postgres.d.cts

@@ -1,4 +1,4 @@
-import { G as GraphBackend } from '../../types-DDP0MGBF.cjs';
+import { G as GraphBackend } from '../../types-BUy-pHKH.cjs';
 import { PgDatabase, PgQueryResultHKT } from 'drizzle-orm/pg-core';
 import { PostgresTables } from './schema/postgres.cjs';
 export { PostgresTableNames, createPostgresTables, tables } from './schema/postgres.cjs';

package/dist/backend/drizzle/postgres.d.ts

@@ -1,4 +1,4 @@
-import { G as GraphBackend } from '../../types-Cdbi4hcx.js';
+import { G as GraphBackend } from '../../types-6EKrWTs9.js';
 import { PgDatabase, PgQueryResultHKT } from 'drizzle-orm/pg-core';
 import { PostgresTables } from './schema/postgres.js';
 export { PostgresTableNames, createPostgresTables, tables } from './schema/postgres.js';

package/dist/backend/drizzle/postgres.js

@@ -1,7 +1,7 @@
-export { createPostgresBackend } from '../../chunk-46YY2FRV.js';
-import '../../chunk-4HARSV2G.js';
+export { createPostgresBackend } from '../../chunk-Q6PXIKRQ.js';
+import '../../chunk-ZQGOBVXZ.js';
 export { createPostgresTables, tables } from '../../chunk-3PURVEA4.js';
-import '../../chunk-O5XPCJLF.js';
+import '../../chunk-SJ2QMDXY.js';
 import '../../chunk-U3452TEU.js';
 import '../../chunk-54WJF3DW.js';
 import '../../chunk-K7SQ3SWP.js';

package/dist/backend/drizzle/sqlite.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkCMHFS34N_cjs = require('../../chunk-CMHFS34N.cjs');
-require('../../chunk-SFY2PPOY.cjs');
+var chunkNYDXJGA3_cjs = require('../../chunk-NYDXJGA3.cjs');
+require('../../chunk-7RVSDXT3.cjs');
 var chunkXZL6MCZJ_cjs = require('../../chunk-XZL6MCZJ.cjs');
-require('../../chunk-OYL2SGBD.cjs');
+require('../../chunk-44SXEVF4.cjs');
 require('../../chunk-JQDWEX6V.cjs');
 require('../../chunk-2WVFEIHR.cjs');
 require('../../chunk-P5CNM325.cjs');
@@ -12,7 +12,7 @@ require('../../chunk-P5CNM325.cjs');
 
 Object.defineProperty(exports, "createSqliteBackend", {
   enumerable: true,
-  get: function () { return chunkCMHFS34N_cjs.createSqliteBackend; }
+  get: function () { return chunkNYDXJGA3_cjs.createSqliteBackend; }
 });
 Object.defineProperty(exports, "createSqliteTables", {
   enumerable: true,

package/dist/backend/drizzle/sqlite.d.cts

@@ -1,4 +1,4 @@
-import { G as GraphBackend } from '../../types-DDP0MGBF.cjs';
+import { G as GraphBackend } from '../../types-BUy-pHKH.cjs';
 import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
 import { SqliteTables } from './schema/sqlite.cjs';
 export { SqliteTableNames, createSqliteTables, tables } from './schema/sqlite.cjs';

package/dist/backend/drizzle/sqlite.d.ts

@@ -1,4 +1,4 @@
-import { G as GraphBackend } from '../../types-Cdbi4hcx.js';
+import { G as GraphBackend } from '../../types-6EKrWTs9.js';
 import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
 import { SqliteTables } from './schema/sqlite.js';
 export { SqliteTableNames, createSqliteTables, tables } from './schema/sqlite.js';

package/dist/backend/drizzle/sqlite.js

@@ -1,7 +1,7 @@
-export { createSqliteBackend } from '../../chunk-F2BZSEFE.js';
-import '../../chunk-4HARSV2G.js';
+export { createSqliteBackend } from '../../chunk-ZO2FRJ2U.js';
+import '../../chunk-ZQGOBVXZ.js';
 export { createSqliteTables, tables } from '../../chunk-OGGLFYFA.js';
-import '../../chunk-O5XPCJLF.js';
+import '../../chunk-SJ2QMDXY.js';
 import '../../chunk-U3452TEU.js';
 import '../../chunk-54WJF3DW.js';
 import '../../chunk-K7SQ3SWP.js';

package/dist/backend/postgres/index.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
 var chunkUYMT4LO2_cjs = require('../../chunk-UYMT4LO2.cjs');
-var chunkF23W4W3A_cjs = require('../../chunk-F23W4W3A.cjs');
-require('../../chunk-SFY2PPOY.cjs');
+var chunkLUARLSYT_cjs = require('../../chunk-LUARLSYT.cjs');
+require('../../chunk-7RVSDXT3.cjs');
 require('../../chunk-XZL6MCZJ.cjs');
 var chunkNU2XNMVI_cjs = require('../../chunk-NU2XNMVI.cjs');
-require('../../chunk-OYL2SGBD.cjs');
+require('../../chunk-44SXEVF4.cjs');
 require('../../chunk-JQDWEX6V.cjs');
 require('../../chunk-2WVFEIHR.cjs');
 require('../../chunk-P5CNM325.cjs');
@@ -22,7 +22,7 @@ Object.defineProperty(exports, "getPostgresMigrationSQL", {
 });
 Object.defineProperty(exports, "createPostgresBackend", {
   enumerable: true,
-  get: function () { return chunkF23W4W3A_cjs.createPostgresBackend; }
+  get: function () { return chunkLUARLSYT_cjs.createPostgresBackend; }
 });
 Object.defineProperty(exports, "createPostgresTables", {
   enumerable: true,

package/dist/backend/postgres/index.d.cts

@@ -1,7 +1,7 @@
 export { PostgresBackendOptions, createPostgresBackend } from '../drizzle/postgres.cjs';
 export { PostgresTableNames, PostgresTables, createPostgresTables, edges, embeddings, nodes, schemaVersions, tables, uniques } from '../drizzle/schema/postgres.cjs';
 export { g as generatePostgresDDL, a as getPostgresMigrationSQL } from '../../test-helpers-DPRFVky4.cjs';
-import '../../types-DDP0MGBF.cjs';
+import '../../types-BUy-pHKH.cjs';
 import 'drizzle-orm';
 import '../../types-DTJEu_-h.cjs';
 import 'zod';

package/dist/backend/postgres/index.d.ts

@@ -1,7 +1,7 @@
 export { PostgresBackendOptions, createPostgresBackend } from '../drizzle/postgres.js';
 export { PostgresTableNames, PostgresTables, createPostgresTables, edges, embeddings, nodes, schemaVersions, tables, uniques } from '../drizzle/schema/postgres.js';
 export { g as generatePostgresDDL, a as getPostgresMigrationSQL } from '../../test-helpers-CIq1Hhj1.js';
-import '../../types-Cdbi4hcx.js';
+import '../../types-6EKrWTs9.js';
 import 'drizzle-orm';
 import '../../types-DTJEu_-h.js';
 import 'zod';

package/dist/backend/postgres/index.js

@@ -1,9 +1,9 @@
 export { generatePostgresDDL, getPostgresMigrationSQL } from '../../chunk-SMLIWLS7.js';
-export { createPostgresBackend } from '../../chunk-46YY2FRV.js';
-import '../../chunk-4HARSV2G.js';
+export { createPostgresBackend } from '../../chunk-Q6PXIKRQ.js';
+import '../../chunk-ZQGOBVXZ.js';
 import '../../chunk-OGGLFYFA.js';
 export { createPostgresTables, edges, embeddings, nodes, schemaVersions, tables, uniques } from '../../chunk-3PURVEA4.js';
-import '../../chunk-O5XPCJLF.js';
+import '../../chunk-SJ2QMDXY.js';
 import '../../chunk-U3452TEU.js';
 import '../../chunk-54WJF3DW.js';
 import '../../chunk-K7SQ3SWP.js';

package/dist/backend/sqlite/index.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
 var chunkUYMT4LO2_cjs = require('../../chunk-UYMT4LO2.cjs');
-var chunkCMHFS34N_cjs = require('../../chunk-CMHFS34N.cjs');
-require('../../chunk-SFY2PPOY.cjs');
+var chunkNYDXJGA3_cjs = require('../../chunk-NYDXJGA3.cjs');
+require('../../chunk-7RVSDXT3.cjs');
 var chunkXZL6MCZJ_cjs = require('../../chunk-XZL6MCZJ.cjs');
 require('../../chunk-NU2XNMVI.cjs');
-var chunkOYL2SGBD_cjs = require('../../chunk-OYL2SGBD.cjs');
+var chunk44SXEVF4_cjs = require('../../chunk-44SXEVF4.cjs');
 require('../../chunk-JQDWEX6V.cjs');
 require('../../chunk-2WVFEIHR.cjs');
 require('../../chunk-P5CNM325.cjs');
@@ -37,7 +37,7 @@ function createDatabase(path) {
     const message = getUnknownErrorMessage(error);
     const mismatch = parseNodeModuleVersionMismatchMessage(message);
     if (!mismatch) throw error;
-    throw new chunkOYL2SGBD_cjs.ConfigurationError(
+    throw new chunk44SXEVF4_cjs.ConfigurationError(
       [
         "Failed to load better-sqlite3 native addon.",
         `It was compiled for NODE_MODULE_VERSION ${mismatch.compiled}, but this Node.js runtime requires ${mismatch.required}.`,
@@ -63,7 +63,7 @@ function createLocalSqliteBackend(options = {}) {
   for (const statement of ddlStatements) {
     sqlite.exec(statement);
   }
-  const backend = chunkCMHFS34N_cjs.createSqliteBackend(db, {
+  const backend = chunkNYDXJGA3_cjs.createSqliteBackend(db, {
     executionProfile: {
       isD1: false,
       isSync: true
@@ -91,7 +91,7 @@ Object.defineProperty(exports, "getSqliteMigrationSQL", {
 });
 Object.defineProperty(exports, "createSqliteBackend", {
   enumerable: true,
-  get: function () { return chunkCMHFS34N_cjs.createSqliteBackend; }
+  get: function () { return chunkNYDXJGA3_cjs.createSqliteBackend; }
 });
 Object.defineProperty(exports, "createSqliteTables", {
   enumerable: true,

package/dist/backend/sqlite/index.d.cts

@@ -1,6 +1,6 @@
 import { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
 export { SqliteBackendOptions, createSqliteBackend } from '../drizzle/sqlite.cjs';
-import { G as GraphBackend } from '../../types-DDP0MGBF.cjs';
+import { G as GraphBackend } from '../../types-BUy-pHKH.cjs';
 import { SqliteTables } from '../drizzle/schema/sqlite.cjs';
 export { SqliteTableNames, createSqliteTables, edges, nodes, schemaVersions, tables, uniques } from '../drizzle/schema/sqlite.cjs';
 export { b as generateSqliteDDL, c as getSqliteMigrationSQL } from '../../test-helpers-DPRFVky4.cjs';

package/dist/backend/sqlite/index.d.ts

@@ -1,6 +1,6 @@
 import { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
 export { SqliteBackendOptions, createSqliteBackend } from '../drizzle/sqlite.js';
-import { G as GraphBackend } from '../../types-Cdbi4hcx.js';
+import { G as GraphBackend } from '../../types-6EKrWTs9.js';
 import { SqliteTables } from '../drizzle/schema/sqlite.js';
 export { SqliteTableNames, createSqliteTables, edges, nodes, schemaVersions, tables, uniques } from '../drizzle/schema/sqlite.js';
 export { b as generateSqliteDDL, c as getSqliteMigrationSQL } from '../../test-helpers-CIq1Hhj1.js';

package/dist/backend/sqlite/index.js

@@ -1,12 +1,12 @@
 import { generateSqliteDDL } from '../../chunk-SMLIWLS7.js';
 export { generateSqliteDDL, getSqliteMigrationSQL } from '../../chunk-SMLIWLS7.js';
-import { createSqliteBackend } from '../../chunk-F2BZSEFE.js';
-export { createSqliteBackend } from '../../chunk-F2BZSEFE.js';
-import '../../chunk-4HARSV2G.js';
+import { createSqliteBackend } from '../../chunk-ZO2FRJ2U.js';
+export { createSqliteBackend } from '../../chunk-ZO2FRJ2U.js';
+import '../../chunk-ZQGOBVXZ.js';
 import { tables } from '../../chunk-OGGLFYFA.js';
 export { createSqliteTables, edges, nodes, schemaVersions, tables, uniques } from '../../chunk-OGGLFYFA.js';
 import '../../chunk-3PURVEA4.js';
-import { ConfigurationError } from '../../chunk-O5XPCJLF.js';
+import { ConfigurationError } from '../../chunk-SJ2QMDXY.js';
 import '../../chunk-U3452TEU.js';
 import '../../chunk-54WJF3DW.js';
 import '../../chunk-K7SQ3SWP.js';

package/dist/{chunk-OYL2SGBD.cjs → chunk-44SXEVF4.cjs}

@@ -123,6 +123,21 @@ var KindNotFoundError = class extends TypeGraphError {
     this.name = "KindNotFoundError";
   }
 };
+var NodeConstraintNotFoundError = class extends TypeGraphError {
+  constructor(constraintName, kind, options) {
+    super(
+      `Constraint not found: "${constraintName}" on node kind "${kind}"`,
+      "CONSTRAINT_NOT_FOUND",
+      {
+        details: { constraintName, kind },
+        category: "user",
+        suggestion: `Verify the constraint name "${constraintName}" is defined in the unique constraints for "${kind}".`,
+        cause: options?.cause
+      }
+    );
+    this.name = "NodeConstraintNotFoundError";
+  }
+};
 var EndpointNotFoundError = class extends TypeGraphError {
   constructor(details, options) {
     super(
@@ -328,6 +343,7 @@ exports.EndpointError = EndpointError;
 exports.EndpointNotFoundError = EndpointNotFoundError;
 exports.KindNotFoundError = KindNotFoundError;
 exports.MigrationError = MigrationError;
+exports.NodeConstraintNotFoundError = NodeConstraintNotFoundError;
 exports.NodeNotFoundError = NodeNotFoundError;
 exports.RestrictedDeleteError = RestrictedDeleteError;
 exports.SchemaMismatchError = SchemaMismatchError;
@@ -341,5 +357,5 @@ exports.isConstraintError = isConstraintError;
 exports.isSystemError = isSystemError;
 exports.isTypeGraphError = isTypeGraphError;
 exports.isUserRecoverable = isUserRecoverable;
-//# sourceMappingURL=chunk-OYL2SGBD.cjs.map
-//# sourceMappingURL=chunk-OYL2SGBD.cjs.map
+//# sourceMappingURL=chunk-44SXEVF4.cjs.map
+//# sourceMappingURL=chunk-44SXEVF4.cjs.map

package/dist/chunk-44SXEVF4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/index.ts"],"names":[],"mappings":"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","file":"chunk-44SXEVF4.cjs","sourcesContent":["/**\n * TypeGraph Error Hierarchy\n *\n * All errors extend TypeGraphError with:\n * - `code`: Machine-readable error code for programmatic handling\n * - `category`: Classification for error handling strategies\n * - `suggestion`: Optional recovery guidance for users\n * - `details`: Structured context about the error\n *\n * @example\n * ```typescript\n * try {\n *   await store.nodes.Person.create({ name: \"\" });\n * } catch (error) {\n *   if (isTypeGraphError(error)) {\n *     console.error(error.toUserMessage());\n *     if (isUserRecoverable(error)) {\n *       // Show to user for correction\n *     }\n *   }\n * }\n * ```\n */\n\n// ============================================================\n// Types\n// ============================================================\n\n/**\n * Error category for programmatic handling.\n *\n * - `user`: Caused by invalid input or incorrect usage. Recoverable by fixing input.\n * - `constraint`: Business rule or schema constraint violation. Recoverable by changing data.\n * - `system`: Internal error or infrastructure issue. May require investigation or retry.\n */\nexport type ErrorCategory = \"user\" | \"constraint\" | \"system\";\n\n/**\n * Options for TypeGraphError constructor.\n */\nexport type TypeGraphErrorOptions = Readonly<{\n  /** Structured context about the error */\n  details?: Record<string, unknown>;\n  /** Error category for handling strategies */\n  category: ErrorCategory;\n  /** Recovery guidance for users */\n  suggestion?: string;\n  /** Underlying cause of the error */\n  cause?: unknown;\n}>;\n\nfunction formatCause(cause: unknown): string {\n  if (cause instanceof Error) {\n    return cause.stack ?? cause.message;\n  }\n  if (typeof cause === \"string\") {\n    return cause;\n  }\n  if (\n    typeof cause === \"number\" ||\n    typeof cause === \"boolean\" ||\n    typeof cause === \"bigint\"\n  ) {\n    return String(cause);\n  }\n  if (typeof cause === \"symbol\") {\n    return cause.description ?? \"Symbol\";\n  }\n  if (cause === undefined) {\n    return \"Unknown cause\";\n  }\n\n  try {\n    return JSON.stringify(cause);\n  } catch (error) {\n    return `Unserializable cause: ${\n      error instanceof Error ? error.message : \"Unknown error\"\n    }`;\n  }\n}\n\n// ============================================================\n// Base Error\n// ============================================================\n\n/**\n * Base error class for all TypeGraph errors.\n *\n * Provides structured error information for both programmatic handling\n * and user-friendly messages.\n */\nexport class TypeGraphError extends Error {\n  /** Machine-readable error code (e.g., \"VALIDATION_ERROR\") */\n  readonly code: string;\n\n  /** Error category for handling strategies */\n  readonly category: ErrorCategory;\n\n  /** Structured context about the error */\n  readonly details: Readonly<Record<string, unknown>>;\n\n  /** Recovery guidance for users */\n  readonly suggestion?: string;\n\n  constructor(message: string, code: string, options: TypeGraphErrorOptions) {\n    super(message, options.cause ? { cause: options.cause } : undefined);\n    this.name = \"TypeGraphError\";\n    this.code = code;\n    this.category = options.category;\n    this.details = Object.freeze(options.details ?? {});\n    if (options.suggestion !== undefined) {\n      this.suggestion = options.suggestion;\n    }\n  }\n\n  /**\n   * Returns a user-friendly error message with suggestion if available.\n   */\n  toUserMessage(): string {\n    if (this.suggestion) {\n      return `${this.message}\\n\\nSuggestion: ${this.suggestion}`;\n    }\n    return this.message;\n  }\n\n  /**\n   * Returns a detailed string representation for logging.\n   */\n  toLogString(): string {\n    const lines = [\n      `[${this.code}] ${this.message}`,\n      `  Category: ${this.category}`,\n    ];\n\n    if (this.suggestion) {\n      lines.push(`  Suggestion: ${this.suggestion}`);\n    }\n\n    const detailKeys = Object.keys(this.details);\n    if (detailKeys.length > 0) {\n      lines.push(`  Details: ${JSON.stringify(this.details)}`);\n    }\n\n    if (this.cause) {\n      lines.push(`  Cause: ${formatCause(this.cause)}`);\n    }\n\n    return lines.join(\"\\n\");\n  }\n}\n\n// ============================================================\n// Validation Errors (category: \"user\")\n// ============================================================\n\n/**\n * Validation issue from Zod or custom validation.\n */\nexport type ValidationIssue = Readonly<{\n  /** Path to the invalid field (e.g., \"address.city\") */\n  path: string;\n  /** Human-readable error message */\n  message: string;\n  /** Zod error code if from Zod validation */\n  code?: string;\n}>;\n\n/**\n * Details for ValidationError.\n */\nexport type ValidationErrorDetails = Readonly<{\n  /** Type of entity being validated */\n  entityType?: \"node\" | \"edge\";\n  /** Kind/type name of the entity */\n  kind?: string;\n  /** Operation being performed */\n  operation?: \"create\" | \"update\";\n  /** Entity ID if updating */\n  id?: string;\n  /** Individual validation issues */\n  issues: readonly ValidationIssue[];\n}>;\n\n/**\n * Thrown when schema validation fails during node or edge operations.\n *\n * @example\n * ```typescript\n * try {\n *   await store.nodes.Person.create({ email: \"invalid\" });\n * } catch (error) {\n *   if (error instanceof ValidationError) {\n *     console.log(error.details.issues);\n *     // [{ path: \"email\", message: \"Invalid email\" }]\n *   }\n * }\n * ```\n */\nexport class ValidationError extends TypeGraphError {\n  declare readonly details: ValidationErrorDetails;\n\n  constructor(\n    message: string,\n    details: ValidationErrorDetails,\n    options?: { cause?: unknown; suggestion?: string },\n  ) {\n    const fieldList =\n      details.issues.length > 0 ?\n        details.issues.map((index) => index.path || \"(root)\").join(\", \")\n      : \"unknown\";\n\n    super(message, \"VALIDATION_ERROR\", {\n      details,\n      category: \"user\",\n      suggestion:\n        options?.suggestion ??\n        `Check the following fields: ${fieldList}. See error.details.issues for specific validation failures.`,\n      cause: options?.cause,\n    });\n    this.name = \"ValidationError\";\n  }\n}\n\n// ============================================================\n// Not Found Errors (category: \"user\")\n// ============================================================\n\n/**\n * Thrown when a node is not found.\n *\n * @example\n * ```typescript\n * try {\n *   await store.nodes.Person.get(\"nonexistent-id\");\n * } catch (error) {\n *   if (error instanceof NodeNotFoundError) {\n *     console.log(error.details.kind, error.details.id);\n *   }\n * }\n * ```\n */\nexport class NodeNotFoundError extends TypeGraphError {\n  constructor(kind: string, id: string, options?: { cause?: unknown }) {\n    super(`Node not found: ${kind}/${id}`, \"NODE_NOT_FOUND\", {\n      details: { kind, id },\n      category: \"user\",\n      suggestion: `Verify the node ID \"${id}\" exists and has not been deleted.`,\n      cause: options?.cause,\n    });\n    this.name = \"NodeNotFoundError\";\n  }\n}\n\n/**\n * Thrown when an edge is not found.\n */\nexport class EdgeNotFoundError extends TypeGraphError {\n  constructor(kind: string, id: string, options?: { cause?: unknown }) {\n    super(`Edge not found: ${kind}/${id}`, \"EDGE_NOT_FOUND\", {\n      details: { kind, id },\n      category: \"user\",\n      suggestion: `Verify the edge ID \"${id}\" exists and has not been deleted.`,\n      cause: options?.cause,\n    });\n    this.name = \"EdgeNotFoundError\";\n  }\n}\n\n/**\n * Thrown when a kind is not found in the graph registry.\n */\nexport class KindNotFoundError extends TypeGraphError {\n  constructor(\n    kind: string,\n    type: \"node\" | \"edge\",\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `${type === \"node\" ? \"Node\" : \"Edge\"} kind not found: ${kind}`,\n      \"KIND_NOT_FOUND\",\n      {\n        details: { kind, type },\n        category: \"user\",\n        suggestion: `Verify \"${kind}\" is defined in your graph schema and spelled correctly.`,\n        cause: options?.cause,\n      },\n    );\n    this.name = \"KindNotFoundError\";\n  }\n}\n\n/**\n * Thrown when a uniqueness constraint name is not found on a node kind.\n */\nexport class NodeConstraintNotFoundError extends TypeGraphError {\n  constructor(\n    constraintName: string,\n    kind: string,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Constraint not found: \"${constraintName}\" on node kind \"${kind}\"`,\n      \"CONSTRAINT_NOT_FOUND\",\n      {\n        details: { constraintName, kind },\n        category: \"user\",\n        suggestion: `Verify the constraint name \"${constraintName}\" is defined in the unique constraints for \"${kind}\".`,\n        cause: options?.cause,\n      },\n    );\n    this.name = \"NodeConstraintNotFoundError\";\n  }\n}\n\n// ============================================================\n// Constraint Errors (category: \"constraint\")\n// ============================================================\n\n/**\n * Thrown when edge endpoint node does not exist or is deleted.\n */\nexport class EndpointNotFoundError extends TypeGraphError {\n  constructor(\n    details: Readonly<{\n      edgeKind: string;\n      endpoint: \"from\" | \"to\";\n      nodeKind: string;\n      nodeId: string;\n    }>,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Endpoint node not found for edge \"${details.edgeKind}\": ${details.nodeKind}/${details.nodeId} (${details.endpoint})`,\n      \"ENDPOINT_NOT_FOUND\",\n      {\n        details,\n        category: \"constraint\",\n        suggestion: `Ensure the ${details.endpoint} node exists before creating the edge.`,\n        cause: options?.cause,\n      },\n    );\n    this.name = \"EndpointNotFoundError\";\n  }\n}\n\n/**\n * Thrown when edge endpoint has wrong node type.\n */\nexport class EndpointError extends TypeGraphError {\n  constructor(\n    details: Readonly<{\n      edgeKind: string;\n      endpoint: \"from\" | \"to\";\n      actualKind: string;\n      expectedKinds: readonly string[];\n    }>,\n    options?: { cause?: unknown },\n  ) {\n    const expected = details.expectedKinds.join(\" | \");\n    super(\n      `Invalid ${details.endpoint} endpoint for edge \"${details.edgeKind}\": got \"${details.actualKind}\", expected ${expected}`,\n      \"ENDPOINT_ERROR\",\n      {\n        details,\n        category: \"constraint\",\n        suggestion: `Use a node of type ${expected} as the ${details.endpoint} endpoint.`,\n        cause: options?.cause,\n      },\n    );\n    this.name = \"EndpointError\";\n  }\n}\n\n/**\n * Thrown when uniqueness constraint is violated.\n */\nexport class UniquenessError extends TypeGraphError {\n  constructor(\n    details: Readonly<{\n      constraintName: string;\n      kind: string;\n      existingId: string;\n      newId: string;\n      fields: readonly string[];\n    }>,\n    options?: { cause?: unknown },\n  ) {\n    const fieldList = details.fields.join(\", \");\n    super(\n      `Uniqueness violation on \"${details.kind}\": constraint \"${details.constraintName}\" (fields: ${fieldList}) conflicts with existing node ${details.existingId}`,\n      \"UNIQUENESS_VIOLATION\",\n      {\n        details,\n        category: \"constraint\",\n        suggestion: `Change the values for fields [${fieldList}] to be unique, or update the existing node ${details.existingId} instead.`,\n        cause: options?.cause,\n      },\n    );\n    this.name = \"UniquenessError\";\n  }\n}\n\n/**\n * Thrown when cardinality constraint is violated.\n */\nexport class CardinalityError extends TypeGraphError {\n  constructor(\n    details: Readonly<{\n      edgeKind: string;\n      fromKind: string;\n      fromId: string;\n      cardinality: string;\n      existingCount: number;\n    }>,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Cardinality violation: \"${details.edgeKind}\" from ${details.fromKind}/${details.fromId} allows \"${details.cardinality}\" but ${details.existingCount} edge(s) already exist`,\n      \"CARDINALITY_ERROR\",\n      {\n        details,\n        category: \"constraint\",\n        suggestion:\n          details.cardinality === \"one\" || details.cardinality === \"unique\" ?\n            `Delete the existing edge before creating a new one, or use cardinality \"many\".`\n          : `Check if the cardinality constraint \"${details.cardinality}\" is correct for your use case.`,\n        cause: options?.cause,\n      },\n    );\n    this.name = \"CardinalityError\";\n  }\n}\n\n/**\n * Thrown when disjointness constraint is violated.\n *\n * Disjoint types cannot share the same ID - a node cannot be both\n * a Person and an Organization if they are declared disjoint.\n */\nexport class DisjointError extends TypeGraphError {\n  constructor(\n    details: Readonly<{\n      nodeId: string;\n      attemptedKind: string;\n      conflictingKind: string;\n    }>,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Disjoint constraint violation: cannot create ${details.attemptedKind} with ID \"${details.nodeId}\" - conflicts with existing ${details.conflictingKind}`,\n      \"DISJOINT_ERROR\",\n      {\n        details,\n        category: \"constraint\",\n        suggestion: `Use a different ID for the new ${details.attemptedKind} node, or delete the existing ${details.conflictingKind}/${details.nodeId} first.`,\n        cause: options?.cause,\n      },\n    );\n    this.name = \"DisjointError\";\n  }\n}\n\n/**\n * Thrown when deletion is blocked due to existing edges (restrict behavior).\n */\nexport class RestrictedDeleteError extends TypeGraphError {\n  constructor(\n    details: Readonly<{\n      nodeKind: string;\n      nodeId: string;\n      edgeCount: number;\n      edgeKinds: readonly string[];\n    }>,\n    options?: { cause?: unknown },\n  ) {\n    const edgeList = details.edgeKinds.join(\", \");\n    super(\n      `Cannot delete ${details.nodeKind}/${details.nodeId}: ${details.edgeCount} connected edge(s) exist (${edgeList})`,\n      \"RESTRICTED_DELETE\",\n      {\n        details,\n        category: \"constraint\",\n        suggestion: `Delete the connected edges first, or change onDelete behavior to \"cascade\" (auto-delete edges) or \"disconnect\" (soft-delete edges).`,\n        cause: options?.cause,\n      },\n    );\n    this.name = \"RestrictedDeleteError\";\n  }\n}\n\n// ============================================================\n// Concurrency Errors (category: \"system\")\n// ============================================================\n\n/**\n * Thrown when optimistic locking detects a concurrent modification.\n *\n * This occurs when two operations try to update the same entity simultaneously.\n * The operation with the stale version fails.\n */\nexport class VersionConflictError extends TypeGraphError {\n  constructor(\n    details: Readonly<{\n      kind: string;\n      id: string;\n      expectedVersion: number;\n      actualVersion: number;\n    }>,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Version conflict on ${details.kind}/${details.id}: expected version ${details.expectedVersion}, found ${details.actualVersion}`,\n      \"VERSION_CONFLICT\",\n      {\n        details,\n        category: \"system\",\n        suggestion: `Fetch the latest version of the entity and retry the operation. This error indicates concurrent modification.`,\n        cause: options?.cause,\n      },\n    );\n    this.name = \"VersionConflictError\";\n  }\n}\n\n// ============================================================\n// Schema Errors (category: \"system\")\n// ============================================================\n\n/**\n * Thrown when the schema in code doesn't match the schema in the database.\n */\nexport class SchemaMismatchError extends TypeGraphError {\n  constructor(\n    details: Readonly<{\n      graphId: string;\n      expectedHash: string;\n      actualHash: string;\n    }>,\n    options?: { cause?: unknown },\n  ) {\n    super(\n      `Schema mismatch for graph \"${details.graphId}\": code schema differs from database schema`,\n      \"SCHEMA_MISMATCH\",\n      {\n        details,\n        category: \"system\",\n        suggestion: `Run schema migration to update the database, or use createStoreWithSchema() for automatic migration.`,\n        cause: options?.cause,\n      },\n    );\n    this.name = \"SchemaMismatchError\";\n  }\n}\n\n/**\n * Thrown when schema migration fails.\n */\nexport class MigrationError extends TypeGraphError {\n  constructor(\n    message: string,\n    details: Readonly<{\n      graphId: string;\n      fromVersion: number;\n      toVersion: number;\n      reason?: string;\n    }>,\n    options?: { cause?: unknown },\n  ) {\n    super(message, \"MIGRATION_ERROR\", {\n      details,\n      category: \"system\",\n      suggestion: `Review the schema changes and ensure they are backwards compatible, or implement a data migration.`,\n      cause: options?.cause,\n    });\n    this.name = \"MigrationError\";\n  }\n}\n\n// ============================================================\n// Configuration Errors (category: \"user\")\n// ============================================================\n\n/**\n * Thrown when graph configuration is invalid.\n *\n * This includes invalid schema definitions, ontology conflicts,\n * and other configuration issues detected at graph creation time.\n */\nexport class ConfigurationError extends TypeGraphError {\n  constructor(\n    message: string,\n    details: Record<string, unknown> = {},\n    options?: { cause?: unknown; suggestion?: string },\n  ) {\n    super(message, \"CONFIGURATION_ERROR\", {\n      details,\n      category: \"user\",\n      suggestion:\n        options?.suggestion ?? `Review your graph definition for errors.`,\n      cause: options?.cause,\n    });\n    this.name = \"ConfigurationError\";\n  }\n}\n\n// ============================================================\n// Database Errors (category: \"system\")\n// ============================================================\n\n/**\n * Thrown when a database operation fails unexpectedly.\n *\n * This indicates a system-level failure in the database backend,\n * not a user-recoverable error.\n */\nexport class DatabaseOperationError extends TypeGraphError {\n  constructor(\n    message: string,\n    details: Readonly<{ operation: string; entity: string }>,\n    options?: { cause?: unknown },\n  ) {\n    super(message, \"DATABASE_OPERATION_ERROR\", {\n      details,\n      category: \"system\",\n      suggestion: `This is a system-level database error. Check the database connection and retry the operation. If the problem persists, investigate the underlying cause.`,\n      cause: options?.cause,\n    });\n    this.name = \"DatabaseOperationError\";\n  }\n}\n\n// ============================================================\n// Query Errors (category: \"system\")\n// ============================================================\n\n/**\n * Thrown when a query predicate cannot be compiled for the target database.\n */\nexport class UnsupportedPredicateError extends TypeGraphError {\n  constructor(\n    message: string,\n    details: Readonly<Record<string, unknown>> = {},\n    options?: { cause?: unknown; suggestion?: string },\n  ) {\n    super(message, \"UNSUPPORTED_PREDICATE\", {\n      details,\n      category: \"system\",\n      suggestion:\n        options?.suggestion ??\n        `This predicate may not be supported by your database backend. Check the documentation for supported predicates.`,\n      cause: options?.cause,\n    });\n    this.name = \"UnsupportedPredicateError\";\n  }\n}\n\n// ============================================================\n// Compiler Errors (category: \"system\")\n// ============================================================\n\n/**\n * Thrown when a compiler invariant is violated.\n *\n * This indicates a bug in the query compiler — the compiler reached\n * a state that should be unreachable. These errors are not user-recoverable.\n */\nexport class CompilerInvariantError extends TypeGraphError {\n  constructor(\n    message: string,\n    details?: Readonly<Record<string, unknown>>,\n    options?: { cause?: unknown },\n  ) {\n    super(message, \"COMPILER_INVARIANT_ERROR\", {\n      details: details ?? {},\n      category: \"system\",\n      suggestion: `This is an internal compiler error. Please report it as a bug with the query that triggered it.`,\n      cause: options?.cause,\n    });\n    this.name = \"CompilerInvariantError\";\n  }\n}\n\n// ============================================================\n// Utility Functions\n// ============================================================\n\n/**\n * Type guard for TypeGraphError.\n *\n * @example\n * ```typescript\n * try {\n *   await store.nodes.Person.create({});\n * } catch (error) {\n *   if (isTypeGraphError(error)) {\n *     console.log(error.code, error.category);\n *   }\n * }\n * ```\n */\nexport function isTypeGraphError(error: unknown): error is TypeGraphError {\n  return error instanceof TypeGraphError;\n}\n\n/**\n * Check if error is recoverable by user action (user or constraint error).\n *\n * User-recoverable errors can typically be resolved by:\n * - Fixing invalid input data\n * - Using different IDs or values\n * - Deleting conflicting data first\n *\n * @example\n * ```typescript\n * if (isUserRecoverable(error)) {\n *   showErrorToUser(error.toUserMessage());\n * } else {\n *   logAndAlertOps(error);\n * }\n * ```\n */\nexport function isUserRecoverable(error: unknown): boolean {\n  if (!isTypeGraphError(error)) return false;\n  return error.category === \"user\" || error.category === \"constraint\";\n}\n\n/**\n * Check if error indicates a system/infrastructure issue.\n *\n * System errors typically require:\n * - Retry logic (for transient failures)\n * - Investigation (for persistent failures)\n * - Ops team notification\n */\nexport function isSystemError(error: unknown): boolean {\n  return isTypeGraphError(error) && error.category === \"system\";\n}\n\n/**\n * Check if error is a constraint violation.\n */\nexport function isConstraintError(error: unknown): boolean {\n  return isTypeGraphError(error) && error.category === \"constraint\";\n}\n\n/**\n * Extract suggestion from error if available.\n */\nexport function getErrorSuggestion(error: unknown): string | undefined {\n  return isTypeGraphError(error) ? error.suggestion : undefined;\n}\n"]}

package/dist/{chunk-SFY2PPOY.cjs → chunk-7RVSDXT3.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkOYL2SGBD_cjs = require('./chunk-OYL2SGBD.cjs');
+var chunk44SXEVF4_cjs = require('./chunk-44SXEVF4.cjs');
 var drizzleOrm = require('drizzle-orm');
 
 // src/backend/types.ts
@@ -42,7 +42,7 @@ var D1_CAPABILITIES = {
 // src/backend/drizzle/row-mappers.ts
 function requireTimestamp(value, field) {
   if (value === void 0) {
-    throw new chunkOYL2SGBD_cjs.DatabaseOperationError(
+    throw new chunk44SXEVF4_cjs.DatabaseOperationError(
       `Expected non-null ${field} timestamp`,
       { operation: "select", entity: "row" }
     );
@@ -153,7 +153,7 @@ function createCommonOperationBackend(options) {
       const timestamp = nowIso2();
       const query = operationStrategy.buildInsertNode(params, timestamp);
       const row = await execution.execGet(query);
-      if (!row) throw new chunkOYL2SGBD_cjs.DatabaseOperationError("Insert node failed: no row returned", { operation: "insert", entity: "node" });
+      if (!row) throw new chunk44SXEVF4_cjs.DatabaseOperationError("Insert node failed: no row returned", { operation: "insert", entity: "node" });
       return rowMappers.toNodeRow(row);
     },
     async insertNodeNoReturn(params) {
@@ -203,7 +203,7 @@ function createCommonOperationBackend(options) {
       const timestamp = nowIso2();
       const query = operationStrategy.buildUpdateNode(params, timestamp);
       const row = await execution.execGet(query);
-      if (!row) throw new chunkOYL2SGBD_cjs.DatabaseOperationError("Update node failed: no row returned", { operation: "update", entity: "node" });
+      if (!row) throw new chunk44SXEVF4_cjs.DatabaseOperationError("Update node failed: no row returned", { operation: "update", entity: "node" });
       return rowMappers.toNodeRow(row);
     },
     async deleteNode(params) {
@@ -238,7 +238,7 @@ function createCommonOperationBackend(options) {
       const timestamp = nowIso2();
       const query = operationStrategy.buildInsertEdge(params, timestamp);
       const row = await execution.execGet(query);
-      if (!row) throw new chunkOYL2SGBD_cjs.DatabaseOperationError("Insert edge failed: no row returned", { operation: "insert", entity: "edge" });
+      if (!row) throw new chunk44SXEVF4_cjs.DatabaseOperationError("Insert edge failed: no row returned", { operation: "insert", entity: "edge" });
       return rowMappers.toEdgeRow(row);
     },
     async insertEdgeNoReturn(params) {
@@ -288,7 +288,7 @@ function createCommonOperationBackend(options) {
       const timestamp = nowIso2();
       const query = operationStrategy.buildUpdateEdge(params, timestamp);
       const row = await execution.execGet(query);
-      if (!row) throw new chunkOYL2SGBD_cjs.DatabaseOperationError("Update edge failed: no row returned", { operation: "update", entity: "edge" });
+      if (!row) throw new chunk44SXEVF4_cjs.DatabaseOperationError("Update edge failed: no row returned", { operation: "update", entity: "edge" });
       return rowMappers.toEdgeRow(row);
     },
     async deleteEdge(params) {
@@ -339,7 +339,7 @@ function createCommonOperationBackend(options) {
       const query = operationStrategy.buildInsertUnique(params);
       const result = await execution.execGet(query);
       if (result && result.node_id !== params.nodeId) {
-        throw new chunkOYL2SGBD_cjs.UniquenessError({
+        throw new chunk44SXEVF4_cjs.UniquenessError({
           constraintName: params.constraintName,
           kind: params.nodeKind,
           existingId: result.node_id,
@@ -358,6 +358,12 @@ function createCommonOperationBackend(options) {
       const row = await execution.execGet(query);
       return row ? rowMappers.toUniqueRow(row) : void 0;
     },
+    async checkUniqueBatch(params) {
+      if (params.keys.length === 0) return [];
+      const query = operationStrategy.buildCheckUniqueBatch(params);
+      const rows = await execution.execAll(query);
+      return rows.map((row) => rowMappers.toUniqueRow(row));
+    },
     async getActiveSchema(graphId) {
       const query = operationStrategy.buildGetActiveSchema(graphId);
       const row = await execution.execGet(query);
@@ -367,7 +373,7 @@ function createCommonOperationBackend(options) {
       const timestamp = nowIso2();
       const query = operationStrategy.buildInsertSchema(params, timestamp);
       const row = await execution.execGet(query);
-      if (!row) throw new chunkOYL2SGBD_cjs.DatabaseOperationError("Insert schema failed: no row returned", { operation: "insert", entity: "schema" });
+      if (!row) throw new chunk44SXEVF4_cjs.DatabaseOperationError("Insert schema failed: no row returned", { operation: "insert", entity: "schema" });
       return rowMappers.toSchemaVersionRow(row);
     },
     async getSchemaVersion(graphId, version) {
@@ -1009,6 +1015,15 @@ function buildHardDeleteEmbeddingsByNode(tables, graphId, nodeKind, nodeId) {
 }
 function buildCheckUnique(tables, params) {
   const { uniques } = tables;
+  if (params.includeDeleted) {
+    return drizzleOrm.sql`
+      SELECT * FROM ${uniques}
+      WHERE ${uniques.graphId} = ${params.graphId}
+        AND ${uniques.nodeKind} = ${params.nodeKind}
+        AND ${uniques.constraintName} = ${params.constraintName}
+        AND ${uniques.key} = ${params.key}
+    `;
+  }
   return drizzleOrm.sql`
     SELECT * FROM ${uniques}
     WHERE ${uniques.graphId} = ${params.graphId}
@@ -1018,6 +1033,30 @@ function buildCheckUnique(tables, params) {
       AND ${uniques.deletedAt} IS NULL
   `;
 }
+function buildCheckUniqueBatch(tables, params) {
+  const { uniques } = tables;
+  const keyPlaceholders = drizzleOrm.sql.join(
+    params.keys.map((key) => drizzleOrm.sql`${key}`),
+    drizzleOrm.sql`, `
+  );
+  if (params.includeDeleted) {
+    return drizzleOrm.sql`
+      SELECT * FROM ${uniques}
+      WHERE ${uniques.graphId} = ${params.graphId}
+        AND ${uniques.nodeKind} = ${params.nodeKind}
+        AND ${uniques.constraintName} = ${params.constraintName}
+        AND ${uniques.key} IN (${keyPlaceholders})
+    `;
+  }
+  return drizzleOrm.sql`
+    SELECT * FROM ${uniques}
+    WHERE ${uniques.graphId} = ${params.graphId}
+      AND ${uniques.nodeKind} = ${params.nodeKind}
+      AND ${uniques.constraintName} = ${params.constraintName}
+      AND ${uniques.key} IN (${keyPlaceholders})
+      AND ${uniques.deletedAt} IS NULL
+  `;
+}
 function assertFiniteNumberArray(array, name) {
   for (const [index, value] of array.entries()) {
     if (typeof value !== "number" || !Number.isFinite(value)) {
@@ -1214,6 +1253,7 @@ var COMMON_TABLE_OPERATION_BUILDERS = {
   buildHardDeleteUniquesByNode,
   buildHardDeleteEmbeddingsByNode,
   buildCheckUnique,
+  buildCheckUniqueBatch,
   buildGetSchemaVersion
 };
 function createCommonOperationStrategy(tables, dialect) {
@@ -1465,5 +1505,5 @@ exports.dropSqliteVectorIndex = dropSqliteVectorIndex;
 exports.formatPostgresTimestamp = formatPostgresTimestamp;
 exports.generateVectorIndexName = generateVectorIndexName;
 exports.nowIso = nowIso;
-//# sourceMappingURL=chunk-SFY2PPOY.cjs.map
-//# sourceMappingURL=chunk-SFY2PPOY.cjs.map
+//# sourceMappingURL=chunk-7RVSDXT3.cjs.map
+//# sourceMappingURL=chunk-7RVSDXT3.cjs.map