@nicia-ai/typegraph 0.1.0

package/dist/chunk-L642L24T.js

@@ -0,0 +1,142 @@
+import { ValidationError, ConfigurationError } from './chunk-JKTO7TW3.js';
+
+// src/core/types.ts
+var NODE_TYPE_BRAND = "__nodeType";
+var EDGE_TYPE_BRAND = "__edgeType";
+function isNodeType(value) {
+  return typeof value === "object" && value !== null && NODE_TYPE_BRAND in value && value[NODE_TYPE_BRAND] === true;
+}
+function isEdgeType(value) {
+  return typeof value === "object" && value !== null && EDGE_TYPE_BRAND in value && value[EDGE_TYPE_BRAND] === true;
+}
+function isEdgeTypeWithEndpoints(value) {
+  return isEdgeType(value) && Array.isArray(value.from) && value.from.length > 0 && Array.isArray(value.to) && value.to.length > 0;
+}
+
+// src/core/define-graph.ts
+var GRAPH_DEF_BRAND = "__graphDef";
+function validateConstraintNarrowing(name, edgeType, registration) {
+  const builtInFromNames = new Set(edgeType.from.map((n) => n.name));
+  for (const fromNode of registration.from) {
+    if (!builtInFromNames.has(fromNode.name)) {
+      throw new ConfigurationError(
+        `Edge "${name}" registration has 'from' kind "${fromNode.name}" not in edge's built-in domain: [${[...builtInFromNames].join(", ")}]`,
+        {
+          edgeName: name,
+          invalidFrom: fromNode.name,
+          allowedFrom: [...builtInFromNames]
+        },
+        {
+          suggestion: `Edge registration can only narrow, not widen, the edge type's built-in constraints.`
+        }
+      );
+    }
+  }
+  const builtInToNames = new Set(edgeType.to.map((n) => n.name));
+  for (const toNode of registration.to) {
+    if (!builtInToNames.has(toNode.name)) {
+      throw new ConfigurationError(
+        `Edge "${name}" registration has 'to' kind "${toNode.name}" not in edge's built-in range: [${[...builtInToNames].join(", ")}]`,
+        {
+          edgeName: name,
+          invalidTo: toNode.name,
+          allowedTo: [...builtInToNames]
+        },
+        {
+          suggestion: `Edge registration can only narrow, not widen, the edge type's built-in constraints.`
+        }
+      );
+    }
+  }
+}
+function normalizeEdgeEntry(name, entry) {
+  if (isEdgeTypeWithEndpoints(entry)) {
+    return {
+      type: entry,
+      from: entry.from,
+      to: entry.to
+    };
+  }
+  if (isEdgeTypeWithEndpoints(entry.type)) {
+    validateConstraintNarrowing(name, entry.type, entry);
+  }
+  return entry;
+}
+function normalizeEdges(edges) {
+  const result = {};
+  for (const [name, entry] of Object.entries(edges)) {
+    result[name] = normalizeEdgeEntry(name, entry);
+  }
+  return result;
+}
+function defineGraph(config) {
+  const defaults = {
+    onNodeDelete: config.defaults?.onNodeDelete ?? "restrict",
+    temporalMode: config.defaults?.temporalMode ?? "current"
+  };
+  const normalizedEdges = normalizeEdges(config.edges);
+  return Object.freeze({
+    [GRAPH_DEF_BRAND]: true,
+    id: config.id,
+    nodes: config.nodes,
+    edges: normalizedEdges,
+    ontology: config.ontology ?? [],
+    defaults
+  });
+}
+function isGraphDef(value) {
+  return typeof value === "object" && value !== null && GRAPH_DEF_BRAND in value && value[GRAPH_DEF_BRAND] === true;
+}
+function getNodeTypeNames(graph) {
+  return Object.keys(graph.nodes);
+}
+function getEdgeTypeNames(graph) {
+  return Object.keys(graph.edges);
+}
+
+// src/utils/date.ts
+var ISO_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$/;
+function isValidIsoDate(value) {
+  if (!ISO_DATE_PATTERN.test(value)) {
+    return false;
+  }
+  const date = new Date(value);
+  return !Number.isNaN(date.getTime());
+}
+function validateIsoDate(value, fieldName) {
+  if (!isValidIsoDate(value)) {
+    throw new ValidationError(
+      `Invalid ISO 8601 datetime for "${fieldName}": "${value}". Expected format: YYYY-MM-DDTHH:mm:ss.sssZ`,
+      {
+        issues: [
+          {
+            path: fieldName,
+            message: `Invalid ISO 8601 datetime format. Expected: YYYY-MM-DDTHH:mm:ss.sssZ, got: "${value}"`
+          }
+        ]
+      },
+      {
+        suggestion: `Use a valid ISO 8601 UTC datetime like "2024-01-15T10:30:00.000Z"`
+      }
+    );
+  }
+  return value;
+}
+function validateOptionalIsoDate(value, fieldName) {
+  if (value === void 0) return void 0;
+  return validateIsoDate(value, fieldName);
+}
+function encodeDate(date) {
+  return date.toISOString();
+}
+function decodeDate(isoString) {
+  validateIsoDate(isoString, "date");
+  return new Date(isoString);
+}
+function nowIso() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+
+export { EDGE_TYPE_BRAND, NODE_TYPE_BRAND, decodeDate, defineGraph, encodeDate, getEdgeTypeNames, getNodeTypeNames, isEdgeType, isEdgeTypeWithEndpoints, isGraphDef, isNodeType, nowIso, validateOptionalIsoDate };
+//# sourceMappingURL=chunk-L642L24T.js.map
+//# sourceMappingURL=chunk-L642L24T.js.map

package/dist/chunk-L642L24T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/types.ts","../src/core/define-graph.ts","../src/utils/date.ts"],"names":[],"mappings":"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","file":"chunk-L642L24T.js","sourcesContent":["import { type z } from \"zod\";\n\n// ============================================================\n// Brand Keys for Nominal Typing\n// ============================================================\n\n/** Brand key for NodeType */\nexport const NODE_TYPE_BRAND = \"__nodeType\" as const;\n\n/** Brand key for EdgeType */\nexport const EDGE_TYPE_BRAND = \"__edgeType\" as const;\n\n/** Brand symbol for NodeId */\ndeclare const __nodeId: unique symbol;\n\n// ============================================================\n// Node Type\n// ============================================================\n\n/**\n * A node type definition.\n *\n * Created via `defineNode()`. Represents a type of node in the graph\n * with an associated Zod schema for properties.\n */\nexport type NodeType<\n  K extends string = string,\n  S extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>,\n> = Readonly<{\n  [NODE_TYPE_BRAND]: true;\n  name: K;\n  schema: S;\n  description: string | undefined;\n}>;\n\n/**\n * Branded node ID type.\n *\n * Prevents mixing IDs from different node types at compile time.\n */\nexport type NodeId<N extends NodeType> = string &\n  Readonly<{\n    [__nodeId]: N;\n  }>;\n\n/**\n * Infer the props type from a NodeType.\n */\nexport type NodeProps<N extends NodeType> = z.infer<N[\"schema\"]>;\n\n// ============================================================\n// Edge Type\n// ============================================================\n\n/**\n * An edge type definition.\n *\n * Created via `defineEdge()`. Represents a type of edge in the graph\n * with an optional Zod schema for properties.\n *\n * Optionally includes `from` and `to` arrays that define the allowed\n * source and target node types (domain and range constraints).\n */\nexport type EdgeType<\n  K extends string = string,\n  S extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>,\n  From extends readonly NodeType[] | undefined = undefined,\n  To extends readonly NodeType[] | undefined = undefined,\n> = Readonly<{\n  [EDGE_TYPE_BRAND]: true;\n  name: K;\n  schema: S;\n  description: string | undefined;\n  from: From;\n  to: To;\n}>;\n\n/**\n * Base edge type for use in constraints - accepts any from/to configuration.\n */\nexport type AnyEdgeType = EdgeType<\n  string,\n  z.ZodObject<z.ZodRawShape>,\n  readonly NodeType[] | undefined,\n  readonly NodeType[] | undefined\n>;\n\n/**\n * An edge type that has both from and to constraints defined.\n * Can be used directly in defineGraph without an EdgeRegistration wrapper.\n */\nexport type EdgeTypeWithEndpoints = EdgeType<\n  string,\n  z.ZodObject<z.ZodRawShape>,\n  readonly NodeType[],\n  readonly NodeType[]\n>;\n\n/**\n * Infer the props type from an EdgeType.\n */\nexport type EdgeProps<E extends AnyEdgeType> = z.infer<E[\"schema\"]>;\n\n// ============================================================\n// Configuration Types\n// ============================================================\n\n/**\n * Delete behaviors for nodes.\n */\nexport type DeleteBehavior = \"restrict\" | \"cascade\" | \"disconnect\";\n\n/**\n * Edge cardinality constraints.\n */\nexport type Cardinality =\n  | \"many\" // No constraint (default)\n  | \"one\" // At most one edge of this kind from any source node\n  | \"unique\" // At most one edge of this kind between any (source, target) pair\n  | \"oneActive\"; // At most one edge with valid_to IS NULL from any source\n\n/**\n * Endpoint existence modes for edge validation.\n */\nexport type EndpointExistence =\n  | \"notDeleted\" // Endpoint deleted_at IS NULL (default)\n  | \"currentlyValid\" // Endpoint not deleted AND temporally valid\n  | \"ever\"; // Endpoint exists in any state\n\n/**\n * Temporal query modes.\n */\nexport type TemporalMode =\n  | \"current\" // Valid now AND not deleted\n  | \"asOf\" // Valid at specific date AND not deleted\n  | \"includeEnded\" // All validity periods AND not deleted\n  | \"includeTombstones\"; // Everything including soft-deleted\n\n/**\n * Uniqueness constraint scope.\n */\nexport type UniquenessScope =\n  | \"kind\" // Unique within this exact kind only\n  | \"kindWithSubClasses\"; // Unique across this kind and all subclasses\n\n/**\n * Collation for uniqueness constraints.\n */\nexport type Collation = \"binary\" | \"caseInsensitive\";\n\n// ============================================================\n// Uniqueness Constraint\n// ============================================================\n\n/**\n * Uniqueness constraint definition.\n */\nexport type UniqueConstraint<\n  S extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>,\n> = Readonly<{\n  name: string;\n  fields: readonly (keyof z.infer<S> & string)[];\n  where?: (\n    props: UniqueConstraintPredicateBuilder<S>,\n  ) => UniqueConstraintPredicate;\n  scope: UniquenessScope;\n  collation: Collation;\n}>;\n\n/**\n * Predicate builder for uniqueness constraint where clause.\n * Uses -? to make all fields required in the builder, even if optional in the schema.\n */\nexport type UniqueConstraintPredicateBuilder<\n  S extends z.ZodObject<z.ZodRawShape>,\n> = Readonly<{\n  [K in keyof z.infer<S>]-?: UniqueConstraintField;\n}>;\n\n/**\n * Field operations for uniqueness constraint predicates.\n */\ntype UniqueConstraintField = Readonly<{\n  isNull: () => UniqueConstraintPredicate;\n  isNotNull: () => UniqueConstraintPredicate;\n}>;\n\n/**\n * A uniqueness constraint predicate (internal representation).\n */\nexport type UniqueConstraintPredicate = Readonly<{\n  __type: \"unique_predicate\";\n  field: string;\n  op: \"isNull\" | \"isNotNull\";\n}>;\n\n// ============================================================\n// Node Registration\n// ============================================================\n\n/**\n * Node registration in a graph definition.\n */\nexport type NodeRegistration<N extends NodeType = NodeType> = Readonly<{\n  type: N;\n  unique?: readonly UniqueConstraint<N[\"schema\"]>[];\n  onDelete?: DeleteBehavior;\n}>;\n\n// ============================================================\n// Edge Registration\n// ============================================================\n\n/**\n * Edge registration in a graph definition.\n */\nexport type EdgeRegistration<\n  E extends AnyEdgeType = AnyEdgeType,\n  FromTypes extends NodeType = NodeType,\n  ToTypes extends NodeType = NodeType,\n> = Readonly<{\n  type: E;\n  from: readonly FromTypes[];\n  to: readonly ToTypes[];\n  cardinality?: Cardinality;\n  endpointExistence?: EndpointExistence;\n}>;\n\n// ============================================================\n// Graph Defaults\n// ============================================================\n\n/**\n * Default settings for a graph.\n */\nexport type GraphDefaults = Readonly<{\n  onNodeDelete?: DeleteBehavior;\n  temporalMode?: TemporalMode;\n}>;\n\n// ============================================================\n// Type Helpers\n// ============================================================\n\n/**\n * Checks if a value is a NodeType.\n */\nexport function isNodeType(value: unknown): value is NodeType {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    NODE_TYPE_BRAND in value &&\n    (value as Record<string, unknown>)[NODE_TYPE_BRAND] === true\n  );\n}\n\n/**\n * Checks if a value is an EdgeType.\n */\nexport function isEdgeType(value: unknown): value is AnyEdgeType {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    EDGE_TYPE_BRAND in value &&\n    (value as Record<string, unknown>)[EDGE_TYPE_BRAND] === true\n  );\n}\n\n/**\n * Checks if a value is an EdgeType with both from and to constraints defined.\n * Such edges can be used directly in defineGraph without an EdgeRegistration wrapper.\n */\nexport function isEdgeTypeWithEndpoints(\n  value: unknown,\n): value is EdgeTypeWithEndpoints {\n  return (\n    isEdgeType(value) &&\n    Array.isArray(value.from) &&\n    value.from.length > 0 &&\n    Array.isArray(value.to) &&\n    value.to.length > 0\n  );\n}\n","import { ConfigurationError } from \"../errors/index\";\nimport { type OntologyRelation } from \"../ontology/types\";\nimport {\n  type DeleteBehavior,\n  type EdgeRegistration,\n  type EdgeTypeWithEndpoints,\n  type GraphDefaults,\n  isEdgeTypeWithEndpoints,\n  type NodeRegistration,\n  type NodeType,\n  type TemporalMode,\n} from \"./types\";\n\n// ============================================================\n// Graph Definition Brand Symbol\n// ============================================================\n\n/** Brand key for GraphDef */\nconst GRAPH_DEF_BRAND = \"__graphDef\" as const;\n\n// ============================================================\n// Edge Entry Types\n// ============================================================\n\n/**\n * An edge entry in the graph definition.\n * Can be:\n * - EdgeType directly (if it has from/to defined)\n * - EdgeRegistration object (always works, can override/narrow defaults)\n */\ntype EdgeEntry = EdgeRegistration | EdgeTypeWithEndpoints;\n\n/**\n * Normalized edge map type - all entries become EdgeRegistration.\n */\ntype NormalizedEdges<TEdges extends Record<string, EdgeEntry>> = {\n  [K in keyof TEdges]: TEdges[K] extends EdgeRegistration ? TEdges[K]\n  : TEdges[K] extends EdgeTypeWithEndpoints ?\n    EdgeRegistration<\n      TEdges[K],\n      TEdges[K][\"from\"][number],\n      TEdges[K][\"to\"][number]\n    >\n  : never;\n};\n\n// ============================================================\n// Edge Normalization Functions\n// ============================================================\n\n/**\n * Validates that an EdgeRegistration's constraints don't widen beyond\n * the edge type's built-in domain/range constraints.\n */\nfunction validateConstraintNarrowing(\n  name: string,\n  edgeType: EdgeTypeWithEndpoints,\n  registration: EdgeRegistration,\n): void {\n  const builtInFromNames = new Set(edgeType.from.map((n) => n.name));\n  for (const fromNode of registration.from) {\n    if (!builtInFromNames.has(fromNode.name)) {\n      throw new ConfigurationError(\n        `Edge \"${name}\" registration has 'from' kind \"${fromNode.name}\" ` +\n          `not in edge's built-in domain: [${[...builtInFromNames].join(\", \")}]`,\n        {\n          edgeName: name,\n          invalidFrom: fromNode.name,\n          allowedFrom: [...builtInFromNames],\n        },\n        {\n          suggestion: `Edge registration can only narrow, not widen, the edge type's built-in constraints.`,\n        },\n      );\n    }\n  }\n\n  const builtInToNames = new Set(edgeType.to.map((n) => n.name));\n  for (const toNode of registration.to) {\n    if (!builtInToNames.has(toNode.name)) {\n      throw new ConfigurationError(\n        `Edge \"${name}\" registration has 'to' kind \"${toNode.name}\" ` +\n          `not in edge's built-in range: [${[...builtInToNames].join(\", \")}]`,\n        {\n          edgeName: name,\n          invalidTo: toNode.name,\n          allowedTo: [...builtInToNames],\n        },\n        {\n          suggestion: `Edge registration can only narrow, not widen, the edge type's built-in constraints.`,\n        },\n      );\n    }\n  }\n}\n\n/**\n * Normalizes a single edge entry to EdgeRegistration.\n */\nfunction normalizeEdgeEntry(name: string, entry: EdgeEntry): EdgeRegistration {\n  if (isEdgeTypeWithEndpoints(entry)) {\n    // EdgeType with from/to - convert to EdgeRegistration\n    return {\n      type: entry,\n      from: entry.from,\n      to: entry.to,\n    };\n  }\n\n  // Already EdgeRegistration - validate narrowing if edge has built-in constraints\n  if (isEdgeTypeWithEndpoints(entry.type)) {\n    validateConstraintNarrowing(name, entry.type, entry);\n  }\n\n  return entry;\n}\n\n/**\n * Normalizes all edge entries to EdgeRegistration.\n */\nfunction normalizeEdges(\n  edges: Record<string, EdgeEntry>,\n): Record<string, EdgeRegistration> {\n  const result: Record<string, EdgeRegistration> = {};\n  for (const [name, entry] of Object.entries(edges)) {\n    result[name] = normalizeEdgeEntry(name, entry);\n  }\n  return result;\n}\n\n// ============================================================\n// Graph Definition Configuration\n// ============================================================\n\n/**\n * Configuration for defineGraph.\n */\ntype GraphDefConfig<\n  TNodes extends Record<string, NodeRegistration>,\n  TEdges extends Record<string, EdgeEntry>,\n  TOntology extends readonly OntologyRelation[],\n> = Readonly<{\n  /** Unique identifier for this graph */\n  id: string;\n  /** Node registrations */\n  nodes: TNodes;\n  /** Edge registrations or EdgeTypes with built-in domain/range */\n  edges: TEdges;\n  /** Ontology relations */\n  ontology?: TOntology;\n  /** Graph-wide defaults */\n  defaults?: GraphDefaults;\n}>;\n\n// ============================================================\n// Graph Definition Type\n// ============================================================\n\n/**\n * A graph definition.\n *\n * This is a compile-time artifact that describes the structure of a graph.\n * Use `createStore()` to create a runtime store from this definition.\n */\nexport type GraphDef<\n  TNodes extends Record<string, NodeRegistration> = Record<\n    string,\n    NodeRegistration\n  >,\n  TEdges extends Record<string, EdgeRegistration> = Record<\n    string,\n    EdgeRegistration\n  >,\n  TOntology extends readonly OntologyRelation[] = readonly OntologyRelation[],\n> = Readonly<{\n  [GRAPH_DEF_BRAND]: true;\n  id: string;\n  nodes: TNodes;\n  edges: TEdges;\n  ontology: TOntology;\n  defaults: Readonly<{\n    onNodeDelete: DeleteBehavior;\n    temporalMode: TemporalMode;\n  }>;\n}>;\n\n// ============================================================\n// Type Helpers\n// ============================================================\n\n/**\n * Extract node type names from a GraphDef.\n */\nexport type NodeTypeNames<G extends GraphDef> = keyof G[\"nodes\"] & string;\n\n/**\n * Extract edge type names from a GraphDef.\n */\nexport type EdgeTypeNames<G extends GraphDef> = keyof G[\"edges\"] & string;\n\n/**\n * Get a NodeType from a GraphDef by name.\n */\nexport type GetNodeType<\n  G extends GraphDef,\n  K extends NodeTypeNames<G>,\n> = G[\"nodes\"][K][\"type\"];\n\n/**\n * Get an EdgeType from a GraphDef by name.\n */\nexport type GetEdgeType<\n  G extends GraphDef,\n  K extends EdgeTypeNames<G>,\n> = G[\"edges\"][K][\"type\"];\n\n/**\n * Get all NodeTypes from a GraphDef.\n */\nexport type AllNodeTypes<G extends GraphDef> = {\n  [K in NodeTypeNames<G>]: G[\"nodes\"][K][\"type\"];\n}[NodeTypeNames<G>];\n\n/**\n * Get all EdgeTypes from a GraphDef.\n */\nexport type AllEdgeTypes<G extends GraphDef> = {\n  [K in EdgeTypeNames<G>]: G[\"edges\"][K][\"type\"];\n}[EdgeTypeNames<G>];\n\n// ============================================================\n// Define Graph Function\n// ============================================================\n\n/**\n * Creates a graph definition.\n *\n * @example\n * ```typescript\n * const graph = defineGraph({\n *   id: \"my_graph\",\n *   nodes: {\n *     Person: { type: Person },\n *     Company: { type: Company },\n *   },\n *   edges: {\n *     // Traditional EdgeRegistration syntax\n *     worksAt: {\n *       type: worksAt,\n *       from: [Person],\n *       to: [Company],\n *       cardinality: \"many\",\n *     },\n *     // Or use EdgeType directly if it has from/to defined\n *     knows,  // EdgeType with built-in domain/range\n *   },\n *   ontology: [\n *     subClassOf(Company, Organization),\n *     disjointWith(Person, Organization),\n *   ],\n *   defaults: {\n *     onNodeDelete: \"restrict\",\n *     temporalMode: \"current\",\n *   },\n * });\n * ```\n */\nexport function defineGraph<\n  TNodes extends Record<string, NodeRegistration<NodeType>>,\n  TEdges extends Record<string, EdgeEntry>,\n  TOntology extends readonly OntologyRelation[],\n>(\n  config: GraphDefConfig<TNodes, TEdges, TOntology>,\n): GraphDef<TNodes, NormalizedEdges<TEdges>, TOntology> {\n  const defaults = {\n    onNodeDelete: config.defaults?.onNodeDelete ?? \"restrict\",\n    temporalMode: config.defaults?.temporalMode ?? \"current\",\n  } as const;\n\n  const normalizedEdges = normalizeEdges(config.edges);\n\n  return Object.freeze({\n    [GRAPH_DEF_BRAND]: true as const,\n    id: config.id,\n    nodes: config.nodes,\n    edges: normalizedEdges,\n    ontology: config.ontology ?? ([] as unknown as TOntology),\n    defaults,\n  }) as GraphDef<TNodes, NormalizedEdges<TEdges>, TOntology>;\n}\n\n// ============================================================\n// Graph Definition Utilities\n// ============================================================\n\n/**\n * Checks if a value is a GraphDef.\n */\nexport function isGraphDef(value: unknown): value is GraphDef {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    GRAPH_DEF_BRAND in value &&\n    (value as Record<string, unknown>)[GRAPH_DEF_BRAND] === true\n  );\n}\n\n/**\n * Gets all node type names from a GraphDef.\n */\nexport function getNodeTypeNames<G extends GraphDef>(\n  graph: G,\n): readonly string[] {\n  return Object.keys(graph.nodes);\n}\n\n/**\n * Gets all edge type names from a GraphDef.\n */\nexport function getEdgeTypeNames<G extends GraphDef>(\n  graph: G,\n): readonly string[] {\n  return Object.keys(graph.edges);\n}\n","/**\n * Date encoding utilities for consistent storage.\n *\n * Contract: All dates are stored as ISO 8601 strings in UTC.\n * - Always includes milliseconds\n * - Always UTC (Z suffix)\n * - Sorts correctly as strings\n */\n\nimport { ValidationError } from \"../errors\";\n\n/**\n * ISO 8601 datetime pattern.\n * Matches formats like:\n * - 2024-01-15T10:30:00.000Z\n * - 2024-01-15T10:30:00Z\n * - 2024-01-15T10:30:00.123Z\n */\nconst ISO_DATE_PATTERN = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?Z$/;\n\n/**\n * Checks if a string is a valid ISO 8601 datetime.\n *\n * @param value - String to validate\n * @returns True if valid ISO 8601 datetime\n */\nexport function isValidIsoDate(value: string): boolean {\n  if (!ISO_DATE_PATTERN.test(value)) {\n    return false;\n  }\n  // Also check that Date parsing produces a valid date\n  const date = new Date(value);\n  return !Number.isNaN(date.getTime());\n}\n\n/**\n * Validates that a string is a valid ISO 8601 datetime.\n * Throws ValidationError if invalid.\n *\n * @param value - String to validate\n * @param fieldName - Name of field for error message\n * @returns The validated string\n * @throws ValidationError if not a valid ISO datetime\n */\nexport function validateIsoDate(value: string, fieldName: string): string {\n  if (!isValidIsoDate(value)) {\n    throw new ValidationError(\n      `Invalid ISO 8601 datetime for \"${fieldName}\": \"${value}\". ` +\n        `Expected format: YYYY-MM-DDTHH:mm:ss.sssZ`,\n      {\n        issues: [\n          {\n            path: fieldName,\n            message: `Invalid ISO 8601 datetime format. Expected: YYYY-MM-DDTHH:mm:ss.sssZ, got: \"${value}\"`,\n          },\n        ],\n      },\n      {\n        suggestion: `Use a valid ISO 8601 UTC datetime like \"2024-01-15T10:30:00.000Z\"`,\n      },\n    );\n  }\n  return value;\n}\n\n/**\n * Validates an optional ISO date string.\n * Returns undefined if value is undefined, otherwise validates.\n */\nexport function validateOptionalIsoDate(\n  value: string | undefined,\n  fieldName: string,\n): string | undefined {\n  if (value === undefined) return undefined;\n  return validateIsoDate(value, fieldName);\n}\n\n/**\n * Encodes a Date to an ISO 8601 string for storage.\n */\nexport function encodeDate(date: Date): string {\n  return date.toISOString();\n}\n\n/**\n * Decodes an ISO 8601 string to a Date.\n * Validates the string format first.\n *\n * @throws ValidationError if not a valid ISO datetime\n */\nexport function decodeDate(isoString: string): Date {\n  validateIsoDate(isoString, \"date\");\n  return new Date(isoString);\n}\n\n/**\n * Returns the current timestamp as an ISO string.\n */\nexport function nowIso(): string {\n  return new Date().toISOString();\n}\n"]}

package/dist/chunk-MFVCSNIY.cjs

@@ -0,0 +1,308 @@
+'use strict';
+
+var chunkF32HCHYA_cjs = require('./chunk-F32HCHYA.cjs');
+var chunkN4AOJ3VF_cjs = require('./chunk-N4AOJ3VF.cjs');
+var chunkSV5H3XM5_cjs = require('./chunk-SV5H3XM5.cjs');
+var drizzleOrm = require('drizzle-orm');
+
+function nowIso() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function nullToUndefined(value) {
+  return value ?? void 0;
+}
+function toNodeRow(row) {
+  return {
+    graph_id: row.graph_id,
+    kind: row.kind,
+    id: row.id,
+    props: row.props,
+    version: row.version,
+    valid_from: nullToUndefined(row.valid_from),
+    valid_to: nullToUndefined(row.valid_to),
+    created_at: row.created_at,
+    updated_at: row.updated_at,
+    deleted_at: nullToUndefined(row.deleted_at)
+  };
+}
+function toEdgeRow(row) {
+  return {
+    graph_id: row.graph_id,
+    id: row.id,
+    kind: row.kind,
+    from_kind: row.from_kind,
+    from_id: row.from_id,
+    to_kind: row.to_kind,
+    to_id: row.to_id,
+    props: row.props,
+    valid_from: nullToUndefined(row.valid_from),
+    valid_to: nullToUndefined(row.valid_to),
+    created_at: row.created_at,
+    updated_at: row.updated_at,
+    deleted_at: nullToUndefined(row.deleted_at)
+  };
+}
+function toUniqueRow(row) {
+  return {
+    graph_id: row.graph_id,
+    node_kind: row.node_kind,
+    constraint_name: row.constraint_name,
+    key: row.key,
+    node_id: row.node_id,
+    concrete_kind: row.concrete_kind,
+    deleted_at: nullToUndefined(row.deleted_at)
+  };
+}
+function toSchemaVersionRow(row) {
+  const isActiveValue = row.is_active;
+  const isActive = isActiveValue === 1 || isActiveValue === "1" || isActiveValue === true;
+  return {
+    graph_id: row.graph_id,
+    version: row.version,
+    schema_hash: row.schema_hash,
+    schema_doc: row.schema_doc,
+    created_at: row.created_at,
+    is_active: isActive
+  };
+}
+function getSessionName(db) {
+  const dbAny = db;
+  if (dbAny.session?.constructor?.name) {
+    return dbAny.session.constructor.name;
+  }
+  if (dbAny._?.session?.constructor?.name) {
+    return dbAny._.session.constructor.name;
+  }
+  return void 0;
+}
+function isD1Database(db) {
+  return getSessionName(db) === "SQLiteD1Session";
+}
+function isSyncDatabase(db) {
+  const sessionName = getSessionName(db);
+  return sessionName === "BetterSQLiteSession" || sessionName === "BunSQLiteSession";
+}
+function createSqliteBackend(db, options = {}) {
+  const tables2 = options.tables ?? chunkN4AOJ3VF_cjs.tables;
+  const isD1 = isD1Database(db);
+  const isSync = isSyncDatabase(db);
+  async function execGet(query) {
+    const result = db.get(query);
+    return result instanceof Promise ? await result : result;
+  }
+  async function execAll(query) {
+    const result = db.all(query);
+    return result instanceof Promise ? await result : result;
+  }
+  async function execRun(query) {
+    const result = db.run(query);
+    if (result instanceof Promise) await result;
+  }
+  const backend = {
+    dialect: "sqlite",
+    capabilities: isD1 ? chunkF32HCHYA_cjs.D1_CAPABILITIES : chunkF32HCHYA_cjs.SQLITE_CAPABILITIES,
+    // === Node Operations ===
+    async insertNode(params) {
+      const timestamp = nowIso();
+      const query = chunkF32HCHYA_cjs.buildInsertNode(tables2, params, timestamp);
+      const row = await execGet(query);
+      if (!row) throw new Error("Insert node failed: no row returned");
+      return toNodeRow(row);
+    },
+    async getNode(graphId, kind, id) {
+      const query = chunkF32HCHYA_cjs.buildGetNode(tables2, graphId, kind, id);
+      const row = await execGet(query);
+      return row ? toNodeRow(row) : void 0;
+    },
+    async updateNode(params) {
+      const timestamp = nowIso();
+      const query = chunkF32HCHYA_cjs.buildUpdateNode(tables2, params, timestamp);
+      const row = await execGet(query);
+      if (!row) throw new Error("Update node failed: no row returned");
+      return toNodeRow(row);
+    },
+    async deleteNode(params) {
+      const timestamp = nowIso();
+      const query = chunkF32HCHYA_cjs.buildDeleteNode(tables2, params, timestamp);
+      await execRun(query);
+    },
+    async hardDeleteNode(params) {
+      const deleteUniquesQuery = chunkF32HCHYA_cjs.buildHardDeleteUniquesByNode(
+        tables2,
+        params.graphId,
+        params.id
+      );
+      await execRun(deleteUniquesQuery);
+      const deleteEmbeddingsQuery = chunkF32HCHYA_cjs.buildHardDeleteEmbeddingsByNode(
+        tables2,
+        params.graphId,
+        params.kind,
+        params.id
+      );
+      await execRun(deleteEmbeddingsQuery);
+      const query = chunkF32HCHYA_cjs.buildHardDeleteNode(tables2, params);
+      await execRun(query);
+    },
+    // === Edge Operations ===
+    async insertEdge(params) {
+      const timestamp = nowIso();
+      const query = chunkF32HCHYA_cjs.buildInsertEdge(tables2, params, timestamp);
+      const row = await execGet(query);
+      if (!row) throw new Error("Insert edge failed: no row returned");
+      return toEdgeRow(row);
+    },
+    async getEdge(graphId, id) {
+      const query = chunkF32HCHYA_cjs.buildGetEdge(tables2, graphId, id);
+      const row = await execGet(query);
+      return row ? toEdgeRow(row) : void 0;
+    },
+    async updateEdge(params) {
+      const timestamp = nowIso();
+      const query = chunkF32HCHYA_cjs.buildUpdateEdge(tables2, params, timestamp);
+      const row = await execGet(query);
+      if (!row) throw new Error("Update edge failed: no row returned");
+      return toEdgeRow(row);
+    },
+    async deleteEdge(params) {
+      const timestamp = nowIso();
+      const query = chunkF32HCHYA_cjs.buildDeleteEdge(tables2, params, timestamp);
+      await execRun(query);
+    },
+    async hardDeleteEdge(params) {
+      const query = chunkF32HCHYA_cjs.buildHardDeleteEdge(tables2, params);
+      await execRun(query);
+    },
+    // === Edge Cardinality Operations ===
+    async countEdgesFrom(params) {
+      const query = chunkF32HCHYA_cjs.buildCountEdgesFrom(tables2, params);
+      const row = await execGet(query);
+      return row?.count ?? 0;
+    },
+    async edgeExistsBetween(params) {
+      const query = chunkF32HCHYA_cjs.buildEdgeExistsBetween(tables2, params);
+      const row = await execGet(query);
+      return row !== void 0;
+    },
+    // === Edge Query Operations ===
+    async findEdgesConnectedTo(params) {
+      const query = chunkF32HCHYA_cjs.buildFindEdgesConnectedTo(tables2, params);
+      const rows = await execAll(query);
+      return rows.map((row) => toEdgeRow(row));
+    },
+    // === Collection Query Operations ===
+    async findNodesByKind(params) {
+      const query = chunkF32HCHYA_cjs.buildFindNodesByKind(tables2, params);
+      const rows = await execAll(query);
+      return rows.map((row) => toNodeRow(row));
+    },
+    async countNodesByKind(params) {
+      const query = chunkF32HCHYA_cjs.buildCountNodesByKind(tables2, params);
+      const row = await execGet(query);
+      return row?.count ?? 0;
+    },
+    async findEdgesByKind(params) {
+      const query = chunkF32HCHYA_cjs.buildFindEdgesByKind(tables2, params);
+      const rows = await execAll(query);
+      return rows.map((row) => toEdgeRow(row));
+    },
+    async countEdgesByKind(params) {
+      const query = chunkF32HCHYA_cjs.buildCountEdgesByKind(tables2, params);
+      const row = await execGet(query);
+      return row?.count ?? 0;
+    },
+    // === Unique Constraint Operations ===
+    async insertUnique(params) {
+      const query = chunkF32HCHYA_cjs.buildInsertUnique(tables2, "sqlite", params);
+      const result = await execGet(query);
+      if (result && result.node_id !== params.nodeId) {
+        throw new chunkSV5H3XM5_cjs.UniquenessError({
+          constraintName: params.constraintName,
+          kind: params.nodeKind,
+          existingId: result.node_id,
+          newId: params.nodeId,
+          fields: []
+          // Fields not available at this level
+        });
+      }
+    },
+    async deleteUnique(params) {
+      const timestamp = nowIso();
+      const query = chunkF32HCHYA_cjs.buildDeleteUnique(tables2, params, timestamp);
+      await execRun(query);
+    },
+    async checkUnique(params) {
+      const query = chunkF32HCHYA_cjs.buildCheckUnique(tables2, params);
+      const row = await execGet(query);
+      return row ? toUniqueRow(row) : void 0;
+    },
+    // === Schema Operations ===
+    async getActiveSchema(graphId) {
+      const query = chunkF32HCHYA_cjs.buildGetActiveSchema(tables2, graphId);
+      const row = await execGet(query);
+      return row ? toSchemaVersionRow(row) : void 0;
+    },
+    async insertSchema(params) {
+      const timestamp = nowIso();
+      const query = chunkF32HCHYA_cjs.buildInsertSchema(tables2, params, timestamp);
+      const row = await execGet(query);
+      if (!row) throw new Error("Insert schema failed: no row returned");
+      return toSchemaVersionRow(row);
+    },
+    async getSchemaVersion(graphId, version) {
+      const query = chunkF32HCHYA_cjs.buildGetSchemaVersion(tables2, graphId, version);
+      const row = await execGet(query);
+      return row ? toSchemaVersionRow(row) : void 0;
+    },
+    async setActiveSchema(graphId, version) {
+      const queries = chunkF32HCHYA_cjs.buildSetActiveSchema(tables2, graphId, version);
+      await execRun(queries.deactivateAll);
+      await execRun(queries.activateVersion);
+    },
+    // === Query Execution ===
+    async execute(query) {
+      return execAll(query);
+    },
+    // === Transaction ===
+    async transaction(fn, _options) {
+      if (isD1) {
+        throw new chunkSV5H3XM5_cjs.ConfigurationError(
+          "Cloudflare D1 does not support atomic transactions. Operations within a transaction are not rolled back on failure. Use backend.capabilities.transactions to check for transaction support, or use individual operations with manual error handling.",
+          {
+            backend: "D1",
+            capability: "transactions",
+            supportsTransactions: false
+          }
+        );
+      }
+      if (isSync) {
+        const txBackend = createTransactionBackend(db, tables2);
+        db.run(drizzleOrm.sql`BEGIN`);
+        try {
+          const result = await fn(txBackend);
+          db.run(drizzleOrm.sql`COMMIT`);
+          return result;
+        } catch (error) {
+          db.run(drizzleOrm.sql`ROLLBACK`);
+          throw error;
+        }
+      }
+      return db.transaction(async (tx) => {
+        const txBackend = createTransactionBackend(tx, tables2);
+        return fn(txBackend);
+      });
+    },
+    // === Lifecycle ===
+    async close() {
+    }
+  };
+  return backend;
+}
+function createTransactionBackend(tx, tables2) {
+  const txBackend = createSqliteBackend(tx, { tables: tables2 });
+  const { transaction: _tx, close: _close, ...ops } = txBackend;
+  return ops;
+}
+
+exports.createSqliteBackend = createSqliteBackend;
+//# sourceMappingURL=chunk-MFVCSNIY.cjs.map
+//# sourceMappingURL=chunk-MFVCSNIY.cjs.map

package/dist/chunk-MFVCSNIY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/backend/drizzle/sqlite.ts"],"names":["tables","D1_CAPABILITIES","SQLITE_CAPABILITIES","buildInsertNode","buildGetNode","buildUpdateNode","buildDeleteNode","buildHardDeleteUniquesByNode","buildHardDeleteEmbeddingsByNode","buildHardDeleteNode","buildInsertEdge","buildGetEdge","buildUpdateEdge","buildDeleteEdge","buildHardDeleteEdge","buildCountEdgesFrom","buildEdgeExistsBetween","buildFindEdgesConnectedTo","buildFindNodesByKind","buildCountNodesByKind","buildFindEdgesByKind","buildCountEdgesByKind","buildInsertUnique","UniquenessError","buildDeleteUnique","buildCheckUnique","buildGetActiveSchema","buildInsertSchema","buildGetSchemaVersion","buildSetActiveSchema","ConfigurationError","sql"],"mappings":"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","file":"chunk-MFVCSNIY.cjs","sourcesContent":["/**\n * SQLite backend adapter for TypeGraph.\n *\n * Works with any Drizzle SQLite database instance:\n * - better-sqlite3\n * - libsql / Turso\n * - Cloudflare D1\n * - bun:sqlite\n * - sql.js\n *\n * @example\n * ```typescript\n * import { drizzle } from \"drizzle-orm/better-sqlite3\";\n * import Database from \"better-sqlite3\";\n * import { createSqliteBackend } from \"@nicia-ai/typegraph/drizzle/sqlite\";\n * import { tables } from \"@nicia-ai/typegraph/drizzle/schema/sqlite\";\n *\n * const sqlite = new Database(\"app.db\");\n * const db = drizzle(sqlite);\n * const backend = createSqliteBackend(db, { tables });\n * ```\n */\nimport { type SQL,sql } from \"drizzle-orm\";\nimport { type BaseSQLiteDatabase } from \"drizzle-orm/sqlite-core\";\n\nimport { ConfigurationError, UniquenessError } from \"../../errors\";\nimport {\n  type CheckUniqueParams,\n  type CountEdgesByKindParams,\n  type CountEdgesFromParams,\n  type CountNodesByKindParams,\n  D1_CAPABILITIES,\n  type DeleteEdgeParams,\n  type DeleteNodeParams,\n  type DeleteUniqueParams,\n  type EdgeExistsBetweenParams,\n  type EdgeRow,\n  type FindEdgesByKindParams,\n  type FindEdgesConnectedToParams,\n  type FindNodesByKindParams,\n  type GraphBackend,\n  type HardDeleteEdgeParams,\n  type HardDeleteNodeParams,\n  type InsertEdgeParams,\n  type InsertNodeParams,\n  type InsertSchemaParams,\n  type InsertUniqueParams,\n  type NodeRow,\n  type SchemaVersionRow,\n  SQLITE_CAPABILITIES,\n  type TransactionBackend,\n  type TransactionOptions,\n  type UniqueRow,\n  type UpdateEdgeParams,\n  type UpdateNodeParams,\n} from \"../types\";\nimport * as ops from \"./operations\";\nimport { type SqliteTables,tables as defaultTables } from \"./schema/sqlite\";\n\n// ============================================================\n// Types\n// ============================================================\n\n/**\n * Options for creating a SQLite backend.\n */\nexport type SqliteBackendOptions = Readonly<{\n  /**\n   * Custom table definitions. Use createSqliteTables() to customize table names.\n   * Defaults to standard TypeGraph table names.\n   */\n  tables?: SqliteTables;\n}>;\n\n/**\n * Any Drizzle SQLite database instance.\n */\ntype AnySqliteDatabase = BaseSQLiteDatabase<\"sync\" | \"async\", unknown>;\n\n// ============================================================\n// Utilities\n// ============================================================\n\n/**\n * Gets the current timestamp in ISO format.\n */\nfunction nowIso(): string {\n  return new Date().toISOString();\n}\n\n/**\n * Converts null to undefined.\n */\nfunction nullToUndefined<T>(value: T | null): T | undefined {\n  return value ?? undefined;\n}\n\n/**\n * Converts a database row to NodeRow type.\n * Raw SQL returns snake_case column names.\n */\nfunction toNodeRow(row: Record<string, unknown>): NodeRow {\n  return {\n    graph_id: row.graph_id as string,\n    kind: row.kind as string,\n    id: row.id as string,\n    props: row.props as string,\n    version: row.version as number,\n    valid_from: nullToUndefined(row.valid_from as string | null),\n    valid_to: nullToUndefined(row.valid_to as string | null),\n    created_at: row.created_at as string,\n    updated_at: row.updated_at as string,\n    deleted_at: nullToUndefined(row.deleted_at as string | null),\n  };\n}\n\n/**\n * Converts a database row to EdgeRow type.\n * Raw SQL returns snake_case column names.\n */\nfunction toEdgeRow(row: Record<string, unknown>): EdgeRow {\n  return {\n    graph_id: row.graph_id as string,\n    id: row.id as string,\n    kind: row.kind as string,\n    from_kind: row.from_kind as string,\n    from_id: row.from_id as string,\n    to_kind: row.to_kind as string,\n    to_id: row.to_id as string,\n    props: row.props as string,\n    valid_from: nullToUndefined(row.valid_from as string | null),\n    valid_to: nullToUndefined(row.valid_to as string | null),\n    created_at: row.created_at as string,\n    updated_at: row.updated_at as string,\n    deleted_at: nullToUndefined(row.deleted_at as string | null),\n  };\n}\n\n/**\n * Converts a database row to UniqueRow type.\n * Raw SQL returns snake_case column names.\n */\nfunction toUniqueRow(row: Record<string, unknown>): UniqueRow {\n  return {\n    graph_id: row.graph_id as string,\n    node_kind: row.node_kind as string,\n    constraint_name: row.constraint_name as string,\n    key: row.key as string,\n    node_id: row.node_id as string,\n    concrete_kind: row.concrete_kind as string,\n    deleted_at: nullToUndefined(row.deleted_at as string | null),\n  };\n}\n\n/**\n * Converts a database row to SchemaVersionRow type.\n * Raw SQL returns snake_case column names.\n */\nfunction toSchemaVersionRow(row: Record<string, unknown>): SchemaVersionRow {\n  // SQLite returns is_active as number (0 or 1) or string ('0' or '1')\n  // Boolean('0') is true in JavaScript, so we need explicit conversion\n  const isActiveValue = row.is_active;\n  const isActive = isActiveValue === 1 || isActiveValue === \"1\" || isActiveValue === true;\n\n  return {\n    graph_id: row.graph_id as string,\n    version: row.version as number,\n    schema_hash: row.schema_hash as string,\n    schema_doc: row.schema_doc as string,\n    created_at: row.created_at as string,\n    is_active: isActive,\n  };\n}\n\n/**\n * Gets the session class name from a Drizzle database instance.\n */\nfunction getSessionName(db: AnySqliteDatabase): string | undefined {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const dbAny: any = db;\n\n  // Try db.session first (current Drizzle structure)\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n  if (dbAny.session?.constructor?.name) {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n    return dbAny.session.constructor.name as string;\n  }\n\n  // Fallback to db._.session (older Drizzle structure)\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n  if (dbAny._?.session?.constructor?.name) {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n    return dbAny._.session.constructor.name as string;\n  }\n\n  return undefined;\n}\n\n/**\n * Detects if the database is a D1 database (no transaction support).\n */\nfunction isD1Database(db: AnySqliteDatabase): boolean {\n  return getSessionName(db) === \"SQLiteD1Session\";\n}\n\n/**\n * Detects if the database is a synchronous SQLite database (better-sqlite3, bun:sqlite).\n * These drivers don't support async transaction callbacks.\n */\nfunction isSyncDatabase(db: AnySqliteDatabase): boolean {\n  const sessionName = getSessionName(db);\n  // BetterSQLiteSession is better-sqlite3\n  // BunSQLiteSession is bun:sqlite\n  return sessionName === \"BetterSQLiteSession\" || sessionName === \"BunSQLiteSession\";\n}\n\n// ============================================================\n// Backend Factory\n// ============================================================\n\n/**\n * Creates a TypeGraph backend for SQLite databases.\n *\n * Works with any Drizzle SQLite instance regardless of the underlying driver.\n *\n * @param db - A Drizzle SQLite database instance\n * @param options - Backend configuration\n * @returns A GraphBackend implementation\n */\nexport function createSqliteBackend(\n  db: AnySqliteDatabase,\n  options: SqliteBackendOptions = {},\n): GraphBackend {\n  const tables = options.tables ?? defaultTables;\n  const isD1 = isD1Database(db);\n  const isSync = isSyncDatabase(db);\n\n  /**\n   * Helper to execute a query and handle sync/async uniformly.\n   */\n  async function execGet<T>(query: SQL): Promise<T | undefined> {\n    const result = db.get(query);\n    return (result instanceof Promise ? await result : result) as T | undefined;\n  }\n\n  async function execAll<T>(query: SQL): Promise<T[]> {\n    const result = db.all(query);\n    return (result instanceof Promise ? await result : result) as T[];\n  }\n\n  async function execRun(query: SQL): Promise<void> {\n    const result = db.run(query);\n    if (result instanceof Promise) await result;\n  }\n\n  // Create the backend operations\n  const backend: GraphBackend = {\n    dialect: \"sqlite\",\n    capabilities: isD1 ? D1_CAPABILITIES : SQLITE_CAPABILITIES,\n\n    // === Node Operations ===\n\n    async insertNode(params: InsertNodeParams): Promise<NodeRow> {\n      const timestamp = nowIso();\n      const query = ops.buildInsertNode(tables, params, timestamp);\n      const row = await execGet<Record<string, unknown>>(query);\n      if (!row) throw new Error(\"Insert node failed: no row returned\");\n      return toNodeRow(row);\n    },\n\n    async getNode(\n      graphId: string,\n      kind: string,\n      id: string,\n    ): Promise<NodeRow | undefined> {\n      const query = ops.buildGetNode(tables, graphId, kind, id);\n      const row = await execGet<Record<string, unknown>>(query);\n      return row ? toNodeRow(row) : undefined;\n    },\n\n    async updateNode(params: UpdateNodeParams): Promise<NodeRow> {\n      const timestamp = nowIso();\n      const query = ops.buildUpdateNode(tables, params, timestamp);\n      const row = await execGet<Record<string, unknown>>(query);\n      if (!row) throw new Error(\"Update node failed: no row returned\");\n      return toNodeRow(row);\n    },\n\n    async deleteNode(params: DeleteNodeParams): Promise<void> {\n      const timestamp = nowIso();\n      const query = ops.buildDeleteNode(tables, params, timestamp);\n      await execRun(query);\n    },\n\n    async hardDeleteNode(params: HardDeleteNodeParams): Promise<void> {\n      // Delete associated uniqueness entries\n      const deleteUniquesQuery = ops.buildHardDeleteUniquesByNode(\n        tables,\n        params.graphId,\n        params.id,\n      );\n      await execRun(deleteUniquesQuery);\n\n      // Delete associated embeddings (if embeddings table exists)\n      const deleteEmbeddingsQuery = ops.buildHardDeleteEmbeddingsByNode(\n        tables,\n        params.graphId,\n        params.kind,\n        params.id,\n      );\n      await execRun(deleteEmbeddingsQuery);\n\n      // Delete the node itself\n      const query = ops.buildHardDeleteNode(tables, params);\n      await execRun(query);\n    },\n\n    // === Edge Operations ===\n\n    async insertEdge(params: InsertEdgeParams): Promise<EdgeRow> {\n      const timestamp = nowIso();\n      const query = ops.buildInsertEdge(tables, params, timestamp);\n      const row = await execGet<Record<string, unknown>>(query);\n      if (!row) throw new Error(\"Insert edge failed: no row returned\");\n      return toEdgeRow(row);\n    },\n\n    async getEdge(graphId: string, id: string): Promise<EdgeRow | undefined> {\n      const query = ops.buildGetEdge(tables, graphId, id);\n      const row = await execGet<Record<string, unknown>>(query);\n      return row ? toEdgeRow(row) : undefined;\n    },\n\n    async updateEdge(params: UpdateEdgeParams): Promise<EdgeRow> {\n      const timestamp = nowIso();\n      const query = ops.buildUpdateEdge(tables, params, timestamp);\n      const row = await execGet<Record<string, unknown>>(query);\n      if (!row) throw new Error(\"Update edge failed: no row returned\");\n      return toEdgeRow(row);\n    },\n\n    async deleteEdge(params: DeleteEdgeParams): Promise<void> {\n      const timestamp = nowIso();\n      const query = ops.buildDeleteEdge(tables, params, timestamp);\n      await execRun(query);\n    },\n\n    async hardDeleteEdge(params: HardDeleteEdgeParams): Promise<void> {\n      const query = ops.buildHardDeleteEdge(tables, params);\n      await execRun(query);\n    },\n\n    // === Edge Cardinality Operations ===\n\n    async countEdgesFrom(params: CountEdgesFromParams): Promise<number> {\n      const query = ops.buildCountEdgesFrom(tables, params);\n      const row = await execGet<{ count: number }>(query);\n      return row?.count ?? 0;\n    },\n\n    async edgeExistsBetween(params: EdgeExistsBetweenParams): Promise<boolean> {\n      const query = ops.buildEdgeExistsBetween(tables, params);\n      const row = await execGet<Record<string, unknown>>(query);\n      return row !== undefined;\n    },\n\n    // === Edge Query Operations ===\n\n    async findEdgesConnectedTo(\n      params: FindEdgesConnectedToParams,\n    ): Promise<readonly EdgeRow[]> {\n      const query = ops.buildFindEdgesConnectedTo(tables, params);\n      const rows = await execAll<Record<string, unknown>>(query);\n      return rows.map((row) => toEdgeRow(row));\n    },\n\n    // === Collection Query Operations ===\n\n    async findNodesByKind(\n      params: FindNodesByKindParams,\n    ): Promise<readonly NodeRow[]> {\n      const query = ops.buildFindNodesByKind(tables, params);\n      const rows = await execAll<Record<string, unknown>>(query);\n      return rows.map((row) => toNodeRow(row));\n    },\n\n    async countNodesByKind(params: CountNodesByKindParams): Promise<number> {\n      const query = ops.buildCountNodesByKind(tables, params);\n      const row = await execGet<{ count: number }>(query);\n      return row?.count ?? 0;\n    },\n\n    async findEdgesByKind(\n      params: FindEdgesByKindParams,\n    ): Promise<readonly EdgeRow[]> {\n      const query = ops.buildFindEdgesByKind(tables, params);\n      const rows = await execAll<Record<string, unknown>>(query);\n      return rows.map((row) => toEdgeRow(row));\n    },\n\n    async countEdgesByKind(params: CountEdgesByKindParams): Promise<number> {\n      const query = ops.buildCountEdgesByKind(tables, params);\n      const row = await execGet<{ count: number }>(query);\n      return row?.count ?? 0;\n    },\n\n    // === Unique Constraint Operations ===\n\n    async insertUnique(params: InsertUniqueParams): Promise<void> {\n      const query = ops.buildInsertUnique(tables, \"sqlite\", params);\n      const result = await execGet<{ node_id: string }>(query);\n\n      // Check if the returned node_id matches our input\n      // If different, another node holds this key (race condition or conflict)\n      if (result && result.node_id !== params.nodeId) {\n        throw new UniquenessError({\n          constraintName: params.constraintName,\n          kind: params.nodeKind,\n          existingId: result.node_id,\n          newId: params.nodeId,\n          fields: [], // Fields not available at this level\n        });\n      }\n    },\n\n    async deleteUnique(params: DeleteUniqueParams): Promise<void> {\n      const timestamp = nowIso();\n      const query = ops.buildDeleteUnique(tables, params, timestamp);\n      await execRun(query);\n    },\n\n    async checkUnique(\n      params: CheckUniqueParams,\n    ): Promise<UniqueRow | undefined> {\n      const query = ops.buildCheckUnique(tables, params);\n      const row = await execGet<Record<string, unknown>>(query);\n      return row ? toUniqueRow(row) : undefined;\n    },\n\n    // === Schema Operations ===\n\n    async getActiveSchema(\n      graphId: string,\n    ): Promise<SchemaVersionRow | undefined> {\n      const query = ops.buildGetActiveSchema(tables, graphId);\n      const row = await execGet<Record<string, unknown>>(query);\n      return row ? toSchemaVersionRow(row) : undefined;\n    },\n\n    async insertSchema(params: InsertSchemaParams): Promise<SchemaVersionRow> {\n      const timestamp = nowIso();\n      const query = ops.buildInsertSchema(tables, params, timestamp);\n      const row = await execGet<Record<string, unknown>>(query);\n      if (!row) throw new Error(\"Insert schema failed: no row returned\");\n      return toSchemaVersionRow(row);\n    },\n\n    async getSchemaVersion(\n      graphId: string,\n      version: number,\n    ): Promise<SchemaVersionRow | undefined> {\n      const query = ops.buildGetSchemaVersion(tables, graphId, version);\n      const row = await execGet<Record<string, unknown>>(query);\n      return row ? toSchemaVersionRow(row) : undefined;\n    },\n\n    async setActiveSchema(graphId: string, version: number): Promise<void> {\n      const queries = ops.buildSetActiveSchema(tables, graphId, version);\n      await execRun(queries.deactivateAll);\n      await execRun(queries.activateVersion);\n    },\n\n    // === Query Execution ===\n\n    async execute<T>(query: SQL): Promise<readonly T[]> {\n      return execAll<T>(query);\n    },\n\n    // === Transaction ===\n\n    async transaction<T>(\n      fn: (tx: TransactionBackend) => Promise<T>,\n      _options?: TransactionOptions,\n    ): Promise<T> {\n      if (isD1) {\n        // D1 doesn't support atomic transactions - operations are auto-committed.\n        // This is a critical limitation that could cause data corruption if\n        // a multi-step operation fails partway through.\n        throw new ConfigurationError(\n          \"Cloudflare D1 does not support atomic transactions. \" +\n            \"Operations within a transaction are not rolled back on failure. \" +\n            \"Use backend.capabilities.transactions to check for transaction support, \" +\n            \"or use individual operations with manual error handling.\",\n          {\n            backend: \"D1\",\n            capability: \"transactions\",\n            supportsTransactions: false,\n          },\n        );\n      }\n\n      if (isSync) {\n        // Synchronous drivers (better-sqlite3, bun:sqlite) don't support\n        // async transaction callbacks. Use raw SQL BEGIN/COMMIT/ROLLBACK.\n        const txBackend = createTransactionBackend(db, tables);\n\n        // Begin transaction synchronously\n        db.run(sql`BEGIN`);\n\n        try {\n          const result = await fn(txBackend);\n          db.run(sql`COMMIT`);\n          return result;\n        } catch (error) {\n          db.run(sql`ROLLBACK`);\n          throw error;\n        }\n      }\n\n      // Use Drizzle's transaction API for async drivers (libsql, etc.)\n      return db.transaction(async (tx) => {\n        const txBackend = createTransactionBackend(tx as AnySqliteDatabase, tables);\n        return fn(txBackend);\n      }) as Promise<T>;\n    },\n\n    // === Lifecycle ===\n\n    async close(): Promise<void> {\n      // Drizzle doesn't expose a close method\n      // Users manage connection lifecycle themselves\n    },\n  };\n\n  return backend;\n}\n\n/**\n * Creates a transaction backend from a Drizzle transaction.\n */\nfunction createTransactionBackend(\n  tx: AnySqliteDatabase,\n  tables: SqliteTables,\n): TransactionBackend {\n  // Create a new backend using the transaction\n  const txBackend = createSqliteBackend(tx, { tables });\n\n  // Return without transaction and close methods\n  const { transaction: _tx, close: _close, ...ops } = txBackend;\n  void _tx;\n  void _close;\n  return ops;\n}\n\n// Re-export schema utilities\nexport type { SqliteTables, TableNames } from \"./schema/sqlite\";\nexport { createSqliteTables, tables } from \"./schema/sqlite\";\n"]}