@nicia-ai/typegraph 0.2.0 → 0.3.0

package/dist/schema/index.cjs

@@ -0,0 +1,145 @@
+'use strict';
+
+var chunkDD6ONEBN_cjs = require('../chunk-DD6ONEBN.cjs');
+require('../chunk-ZJHQZZT2.cjs');
+require('../chunk-OYL2SGBD.cjs');
+
+// src/schema/deserializer.ts
+function deserializeSchema(schema) {
+  const nodeNames = Object.keys(schema.nodes);
+  const edgeNames = Object.keys(schema.edges);
+  const metaEdgeNames = Object.keys(schema.ontology.metaEdges);
+  return {
+    graphId: schema.graphId,
+    version: schema.version,
+    generatedAt: schema.generatedAt,
+    getNode: (name) => schema.nodes[name],
+    getNodeNames: () => nodeNames,
+    getEdge: (name) => schema.edges[name],
+    getEdgeNames: () => edgeNames,
+    getMetaEdge: (name) => schema.ontology.metaEdges[name],
+    getMetaEdgeNames: () => metaEdgeNames,
+    getRelations: () => schema.ontology.relations,
+    getClosures: () => schema.ontology.closures,
+    getDefaults: () => schema.defaults,
+    getRaw: () => schema,
+    buildRegistry: () => buildRegistryFromClosures(schema)
+  };
+}
+function buildRegistryFromClosures(schema) {
+  const { closures } = schema.ontology;
+  const subClassAncestors = recordToMap(closures.subClassAncestors);
+  const subClassDescendants = recordToMap(closures.subClassDescendants);
+  const broaderClosure = recordToMap(closures.broaderClosure);
+  const narrowerClosure = recordToMap(closures.narrowerClosure);
+  const equivalenceSets = recordToMap(closures.equivalenceSets);
+  const partOfClosure = recordToMap(closures.partOfClosure);
+  const hasPartClosure = recordToMap(closures.hasPartClosure);
+  const iriToKind = simpleRecordToMap(closures.iriToKind);
+  const disjointPairs = new Set(closures.disjointPairs);
+  const edgeInverses = simpleRecordToMap(closures.edgeInverses);
+  const edgeImplicationsClosure = recordToMap(closures.edgeImplicationsClosure);
+  const edgeImplyingClosure = recordToMap(closures.edgeImplyingClosure);
+  const nodeKinds = /* @__PURE__ */ new Map();
+  const edgeKinds = /* @__PURE__ */ new Map();
+  return new chunkDD6ONEBN_cjs.KindRegistry(nodeKinds, edgeKinds, {
+    subClassAncestors,
+    subClassDescendants,
+    broaderClosure,
+    narrowerClosure,
+    equivalenceSets,
+    iriToKind,
+    disjointPairs,
+    partOfClosure,
+    hasPartClosure,
+    edgeInverses,
+    edgeImplicationsClosure,
+    edgeImplyingClosure
+  });
+}
+function recordToMap(record) {
+  const result = /* @__PURE__ */ new Map();
+  for (const [key, values] of Object.entries(record)) {
+    result.set(key, new Set(values));
+  }
+  return result;
+}
+function simpleRecordToMap(record) {
+  return new Map(Object.entries(record));
+}
+
+Object.defineProperty(exports, "computeSchemaDiff", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.computeSchemaDiff; }
+});
+Object.defineProperty(exports, "computeSchemaHash", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.computeSchemaHash; }
+});
+Object.defineProperty(exports, "createValidationError", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.createValidationError; }
+});
+Object.defineProperty(exports, "deserializeWherePredicate", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.deserializeWherePredicate; }
+});
+Object.defineProperty(exports, "ensureSchema", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.ensureSchema; }
+});
+Object.defineProperty(exports, "getActiveSchema", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.getActiveSchema; }
+});
+Object.defineProperty(exports, "getMigrationActions", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.getMigrationActions; }
+});
+Object.defineProperty(exports, "getSchemaChanges", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.getSchemaChanges; }
+});
+Object.defineProperty(exports, "initializeSchema", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.initializeSchema; }
+});
+Object.defineProperty(exports, "isBackwardsCompatible", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.isBackwardsCompatible; }
+});
+Object.defineProperty(exports, "isSchemaInitialized", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.isSchemaInitialized; }
+});
+Object.defineProperty(exports, "migrateSchema", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.migrateSchema; }
+});
+Object.defineProperty(exports, "rollbackSchema", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.rollbackSchema; }
+});
+Object.defineProperty(exports, "serializeSchema", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.serializeSchema; }
+});
+Object.defineProperty(exports, "validateEdgeProps", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.validateEdgeProps; }
+});
+Object.defineProperty(exports, "validateNodeProps", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.validateNodeProps; }
+});
+Object.defineProperty(exports, "validateProps", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.validateProps; }
+});
+Object.defineProperty(exports, "wrapZodError", {
+  enumerable: true,
+  get: function () { return chunkDD6ONEBN_cjs.wrapZodError; }
+});
+exports.deserializeSchema = deserializeSchema;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/schema/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/schema/deserializer.ts"],"names":["KindRegistry"],"mappings":";;;;;;;AA6EO,SAAS,kBACd,MAAA,EACoB;AACpB,EAAA,MAAM,SAAA,GAAY,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA;AAC1C,EAAA,MAAM,SAAA,GAAY,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA;AAC1C,EAAA,MAAM,aAAA,GAAgB,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,SAAS,SAAS,CAAA;AAE3D,EAAA,OAAO;AAAA,IACL,SAAS,MAAA,CAAO,OAAA;AAAA,IAChB,SAAS,MAAA,CAAO,OAAA;AAAA,IAChB,aAAa,MAAA,CAAO,WAAA;AAAA,IAEpB,OAAA,EAAS,CAAC,IAAA,KAAS,MAAA,CAAO,MAAM,IAAI,CAAA;AAAA,IACpC,cAAc,MAAM,SAAA;AAAA,IAEpB,OAAA,EAAS,CAAC,IAAA,KAAS,MAAA,CAAO,MAAM,IAAI,CAAA;AAAA,IACpC,cAAc,MAAM,SAAA;AAAA,IAEpB,aAAa,CAAC,IAAA,KAAS,MAAA,CAAO,QAAA,CAAS,UAAU,IAAI,CAAA;AAAA,IACrD,kBAAkB,MAAM,aAAA;AAAA,IAExB,YAAA,EAAc,MAAM,MAAA,CAAO,QAAA,CAAS,SAAA;AAAA,IACpC,WAAA,EAAa,MAAM,MAAA,CAAO,QAAA,CAAS,QAAA;AAAA,IAEnC,WAAA,EAAa,MAAM,MAAA,CAAO,QAAA;AAAA,IAC1B,QAAQ,MAAM,MAAA;AAAA,IAEd,aAAA,EAAe,MAAM,yBAAA,CAA0B,MAAM;AAAA,GACvD;AACF;AAWA,SAAS,0BAA0B,MAAA,EAAwC;AACzE,EAAA,MAAM,EAAE,QAAA,EAAS,GAAI,MAAA,CAAO,QAAA;AAG5B,EAAA,MAAM,iBAAA,GAAoB,WAAA,CAAY,QAAA,CAAS,iBAAiB,CAAA;AAChE,EAAA,MAAM,mBAAA,GAAsB,WAAA,CAAY,QAAA,CAAS,mBAAmB,CAAA;AACpE,EAAA,MAAM,cAAA,GAAiB,WAAA,CAAY,QAAA,CAAS,cAAc,CAAA;AAC1D,EAAA,MAAM,eAAA,GAAkB,WAAA,CAAY,QAAA,CAAS,eAAe,CAAA;AAC5D,EAAA,MAAM,eAAA,GAAkB,WAAA,CAAY,QAAA,CAAS,eAAe,CAAA;AAC5D,EAAA,MAAM,aAAA,GAAgB,WAAA,CAAY,QAAA,CAAS,aAAa,CAAA;AACxD,EAAA,MAAM,cAAA,GAAiB,WAAA,CAAY,QAAA,CAAS,cAAc,CAAA;AAC1D,EAAA,MAAM,SAAA,GAAY,iBAAA,CAAkB,QAAA,CAAS,SAAS,CAAA;AACtD,EAAA,MAAM,aAAA,GAAgB,IAAI,GAAA,CAAI,QAAA,CAAS,aAAa,CAAA;AACpD,EAAA,MAAM,YAAA,GAAe,iBAAA,CAAkB,QAAA,CAAS,YAAY,CAAA;AAC5D,EAAA,MAAM,uBAAA,GAA0B,WAAA,CAAY,QAAA,CAAS,uBAAuB,CAAA;AAC5E,EAAA,MAAM,mBAAA,GAAsB,WAAA,CAAY,QAAA,CAAS,mBAAmB,CAAA;AAGpE,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAI;AAC1B,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAI;AAE1B,EAAA,OAAO,IAAIA,8BAAA,CAAa,SAAA,EAAW,SAAA,EAAW;AAAA,IAC5C,iBAAA;AAAA,IACA,mBAAA;AAAA,IACA,cAAA;AAAA,IACA,eAAA;AAAA,IACA,eAAA;AAAA,IACA,SAAA;AAAA,IACA,aAAA;AAAA,IACA,aAAA;AAAA,IACA,cAAA;AAAA,IACA,YAAA;AAAA,IACA,uBAAA;AAAA,IACA;AAAA,GACD,CAAA;AACH;AAKA,SAAS,YACP,MAAA,EAC0C;AAC1C,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAyB;AAC5C,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,MAAM,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AAClD,IAAA,MAAA,CAAO,GAAA,CAAI,GAAA,EAAK,IAAI,GAAA,CAAI,MAAM,CAAC,CAAA;AAAA,EACjC;AACA,EAAA,OAAO,MAAA;AACT;AAKA,SAAS,kBACP,MAAA,EAC6B;AAC7B,EAAA,OAAO,IAAI,GAAA,CAAI,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAC,CAAA;AACvC","file":"index.cjs","sourcesContent":["/**\n * Schema deserializer for loading stored schemas.\n *\n * Reconstructs runtime objects from SerializedSchema.\n * Note: Zod schemas cannot be fully reconstructed from JSON Schema,\n * so this provides access to the serialized data for introspection.\n */\nimport { KindRegistry } from \"../registry/kind-registry\";\nimport {\n  type SerializedClosures,\n  type SerializedEdgeDef,\n  type SerializedMetaEdge,\n  type SerializedNodeDef,\n  type SerializedOntologyRelation,\n  type SerializedSchema,\n} from \"./types\";\n\n// ============================================================\n// Deserialized Schema\n// ============================================================\n\n/**\n * A deserialized schema provides read-only access to schema metadata.\n *\n * Note: Unlike the original GraphDef, this does not include Zod schemas\n * since those cannot be reconstructed from JSON Schema. Use this for\n * introspection and metadata access only.\n */\nexport type DeserializedSchema = Readonly<{\n  graphId: string;\n  version: number;\n  generatedAt: string;\n\n  /** Get node definition by name */\n  getNode: (name: string) => SerializedNodeDef | undefined;\n\n  /** Get all node names */\n  getNodeNames: () => readonly string[];\n\n  /** Get edge definition by name */\n  getEdge: (name: string) => SerializedEdgeDef | undefined;\n\n  /** Get all edge names */\n  getEdgeNames: () => readonly string[];\n\n  /** Get meta-edge definition by name */\n  getMetaEdge: (name: string) => SerializedMetaEdge | undefined;\n\n  /** Get all meta-edge names */\n  getMetaEdgeNames: () => readonly string[];\n\n  /** Get all ontology relations */\n  getRelations: () => readonly SerializedOntologyRelation[];\n\n  /** Get precomputed closures */\n  getClosures: () => SerializedClosures;\n\n  /** Get graph defaults */\n  getDefaults: () => SerializedSchema[\"defaults\"];\n\n  /** Get the raw serialized schema */\n  getRaw: () => SerializedSchema;\n\n  /** Build a KindRegistry from the closures */\n  buildRegistry: () => KindRegistry;\n}>;\n\n// ============================================================\n// Deserialization\n// ============================================================\n\n/**\n * Deserializes a SerializedSchema into a DeserializedSchema.\n *\n * @param schema - The serialized schema to deserialize\n * @returns A deserialized schema with accessor methods\n */\nexport function deserializeSchema(\n  schema: SerializedSchema,\n): DeserializedSchema {\n  const nodeNames = Object.keys(schema.nodes);\n  const edgeNames = Object.keys(schema.edges);\n  const metaEdgeNames = Object.keys(schema.ontology.metaEdges);\n\n  return {\n    graphId: schema.graphId,\n    version: schema.version,\n    generatedAt: schema.generatedAt,\n\n    getNode: (name) => schema.nodes[name],\n    getNodeNames: () => nodeNames,\n\n    getEdge: (name) => schema.edges[name],\n    getEdgeNames: () => edgeNames,\n\n    getMetaEdge: (name) => schema.ontology.metaEdges[name],\n    getMetaEdgeNames: () => metaEdgeNames,\n\n    getRelations: () => schema.ontology.relations,\n    getClosures: () => schema.ontology.closures,\n\n    getDefaults: () => schema.defaults,\n    getRaw: () => schema,\n\n    buildRegistry: () => buildRegistryFromClosures(schema),\n  };\n}\n\n// ============================================================\n// Registry Building\n// ============================================================\n\n/**\n * Builds a KindRegistry from serialized closures.\n *\n * This allows query execution without recomputing closures.\n */\nfunction buildRegistryFromClosures(schema: SerializedSchema): KindRegistry {\n  const { closures } = schema.ontology;\n\n  // Convert Record<string, string[]> back to Map<string, Set<string>>\n  const subClassAncestors = recordToMap(closures.subClassAncestors);\n  const subClassDescendants = recordToMap(closures.subClassDescendants);\n  const broaderClosure = recordToMap(closures.broaderClosure);\n  const narrowerClosure = recordToMap(closures.narrowerClosure);\n  const equivalenceSets = recordToMap(closures.equivalenceSets);\n  const partOfClosure = recordToMap(closures.partOfClosure);\n  const hasPartClosure = recordToMap(closures.hasPartClosure);\n  const iriToKind = simpleRecordToMap(closures.iriToKind);\n  const disjointPairs = new Set(closures.disjointPairs);\n  const edgeInverses = simpleRecordToMap(closures.edgeInverses);\n  const edgeImplicationsClosure = recordToMap(closures.edgeImplicationsClosure);\n  const edgeImplyingClosure = recordToMap(closures.edgeImplyingClosure);\n\n  // Build empty node/edge kind maps (we don't have the actual Zod schemas)\n  const nodeKinds = new Map();\n  const edgeKinds = new Map();\n\n  return new KindRegistry(nodeKinds, edgeKinds, {\n    subClassAncestors,\n    subClassDescendants,\n    broaderClosure,\n    narrowerClosure,\n    equivalenceSets,\n    iriToKind,\n    disjointPairs,\n    partOfClosure,\n    hasPartClosure,\n    edgeInverses,\n    edgeImplicationsClosure,\n    edgeImplyingClosure,\n  });\n}\n\n/**\n * Converts Record<string, string[]> to Map<string, Set<string>>.\n */\nfunction recordToMap(\n  record: Record<string, readonly string[]>,\n): ReadonlyMap<string, ReadonlySet<string>> {\n  const result = new Map<string, Set<string>>();\n  for (const [key, values] of Object.entries(record)) {\n    result.set(key, new Set(values));\n  }\n  return result;\n}\n\n/**\n * Converts Record<string, string> to Map<string, string>.\n */\nfunction simpleRecordToMap(\n  record: Record<string, string>,\n): ReadonlyMap<string, string> {\n  return new Map(Object.entries(record));\n}\n"]}

package/dist/schema/index.d.cts

@@ -0,0 +1,237 @@
+import { K as KindRegistry, G as GraphDef } from '../manager-Jc5Btay9.cjs';
+export { C as ChangeSeverity, a as ChangeType, E as EdgeChange, M as MigrationHookContext, N as NodeChange, O as OntologyChange, S as SchemaDiff, b as SchemaManagerOptions, c as SchemaValidationResult, d as computeSchemaDiff, e as ensureSchema, g as getActiveSchema, f as getMigrationActions, h as getSchemaChanges, i as initializeSchema, j as isBackwardsCompatible, k as isSchemaInitialized, m as migrateSchema, r as rollbackSchema } from '../manager-Jc5Btay9.cjs';
+import { S as SerializedNodeDef, a as SerializedEdgeDef, b as SerializedMetaEdge, c as SerializedOntologyRelation, d as SerializedClosures, e as SerializedSchema, f as SchemaHash } from '../types-DDP0MGBF.cjs';
+export { J as JsonSchema, g as SerializedOntology, h as SerializedUniqueConstraint } from '../types-DDP0MGBF.cjs';
+import { ZodType, ZodError } from 'zod';
+import { V as ValidationIssue, a as ValidationError } from '../index-Dkicw49A.cjs';
+import '../types-DTJEu_-h.cjs';
+import 'drizzle-orm';
+import '../types-BRzHlhKC.cjs';
+
+/**
+ * Schema deserializer for loading stored schemas.
+ *
+ * Reconstructs runtime objects from SerializedSchema.
+ * Note: Zod schemas cannot be fully reconstructed from JSON Schema,
+ * so this provides access to the serialized data for introspection.
+ */
+
+/**
+ * A deserialized schema provides read-only access to schema metadata.
+ *
+ * Note: Unlike the original GraphDef, this does not include Zod schemas
+ * since those cannot be reconstructed from JSON Schema. Use this for
+ * introspection and metadata access only.
+ */
+type DeserializedSchema = Readonly<{
+    graphId: string;
+    version: number;
+    generatedAt: string;
+    /** Get node definition by name */
+    getNode: (name: string) => SerializedNodeDef | undefined;
+    /** Get all node names */
+    getNodeNames: () => readonly string[];
+    /** Get edge definition by name */
+    getEdge: (name: string) => SerializedEdgeDef | undefined;
+    /** Get all edge names */
+    getEdgeNames: () => readonly string[];
+    /** Get meta-edge definition by name */
+    getMetaEdge: (name: string) => SerializedMetaEdge | undefined;
+    /** Get all meta-edge names */
+    getMetaEdgeNames: () => readonly string[];
+    /** Get all ontology relations */
+    getRelations: () => readonly SerializedOntologyRelation[];
+    /** Get precomputed closures */
+    getClosures: () => SerializedClosures;
+    /** Get graph defaults */
+    getDefaults: () => SerializedSchema["defaults"];
+    /** Get the raw serialized schema */
+    getRaw: () => SerializedSchema;
+    /** Build a KindRegistry from the closures */
+    buildRegistry: () => KindRegistry;
+}>;
+/**
+ * Deserializes a SerializedSchema into a DeserializedSchema.
+ *
+ * @param schema - The serialized schema to deserialize
+ * @returns A deserialized schema with accessor methods
+ */
+declare function deserializeSchema(schema: SerializedSchema): DeserializedSchema;
+
+/**
+ * Serializes a GraphDef to a SerializedSchema.
+ *
+ * @param graph - The graph definition to serialize
+ * @param version - The schema version number
+ * @returns The serialized schema
+ */
+declare function serializeSchema<G extends GraphDef>(graph: G, version: number): SerializedSchema;
+/**
+ * A serialized predicate structure (matches UniqueConstraintPredicate from core/types).
+ */
+type SerializedPredicate = Readonly<{
+    __type: "unique_predicate";
+    field: string;
+    op: "isNull" | "isNotNull";
+}>;
+/**
+ * Field builder returned by the predicate proxy.
+ */
+type FieldPredicateBuilder = Readonly<{
+    isNull: () => SerializedPredicate;
+    isNotNull: () => SerializedPredicate;
+}>;
+/**
+ * Predicate builder type for where clause serialization.
+ */
+type PredicateBuilder = Readonly<Record<string, FieldPredicateBuilder>>;
+/**
+ * Deserializes a where predicate JSON back to a predicate function.
+ *
+ * This can be used to reconstruct a UniqueConstraint's where clause
+ * from a serialized schema.
+ *
+ * @param serialized - The JSON string from serialization
+ * @returns A where function that returns the predicate structure
+ */
+/**
+ * Unique predicate result type.
+ */
+type UniquePredicate = Readonly<{
+    __type: "unique_predicate";
+    field: string;
+    op: "isNull" | "isNotNull";
+}>;
+declare function deserializeWherePredicate(serialized: string): (builder: PredicateBuilder) => UniquePredicate;
+/**
+ * Computes a hash of the schema content for change detection.
+ *
+ * Excludes version and generatedAt since those change on every save.
+ */
+declare function computeSchemaHash(schema: SerializedSchema): Promise<SchemaHash>;
+
+/**
+ * Contextual Validation Utilities
+ *
+ * Provides Zod validation wrappers that include full context about
+ * which entity (node/edge) and operation (create/update) failed.
+ *
+ * @example
+ * ```typescript
+ * const props = validateNodeProps(schema, input, {
+ *   kind: "Person",
+ *   operation: "create",
+ * });
+ * ```
+ */
+
+/**
+ * Context for validation operations.
+ */
+type ValidationContext = Readonly<{
+    /** Type of entity being validated */
+    entityType: "node" | "edge";
+    /** Kind/type name of the entity */
+    kind: string;
+    /** Operation being performed */
+    operation: "create" | "update";
+    /** Entity ID (for updates) */
+    id?: string;
+}>;
+/**
+ * Validates props with full context for error messages.
+ *
+ * @param schema - Zod schema to validate against
+ * @param props - Properties to validate
+ * @param context - Context about the entity and operation
+ * @returns Validated and transformed props
+ * @throws ValidationError with full context if validation fails
+ *
+ * @example
+ * ```typescript
+ * const validatedProps = validateProps(personSchema, input, {
+ *   entityType: "node",
+ *   kind: "Person",
+ *   operation: "create",
+ * });
+ * ```
+ */
+declare function validateProps<T>(schema: ZodType<T>, props: unknown, context: ValidationContext): T;
+/**
+ * Validates node props with full context.
+ *
+ * Convenience wrapper around validateProps for node operations.
+ *
+ * @example
+ * ```typescript
+ * const props = validateNodeProps(schema, input, {
+ *   kind: "Person",
+ *   operation: "create",
+ * });
+ * ```
+ */
+declare function validateNodeProps<T>(schema: ZodType<T>, props: unknown, context: Readonly<{
+    kind: string;
+    operation: "create" | "update";
+    id?: string;
+}>): T;
+/**
+ * Validates edge props with full context.
+ *
+ * Convenience wrapper around validateProps for edge operations.
+ *
+ * @example
+ * ```typescript
+ * const props = validateEdgeProps(schema, input, {
+ *   kind: "worksAt",
+ *   operation: "create",
+ * });
+ * ```
+ */
+declare function validateEdgeProps<T>(schema: ZodType<T>, props: unknown, context: Readonly<{
+    kind: string;
+    operation: "create" | "update";
+    id?: string;
+}>): T;
+/**
+ * Wraps a Zod error with TypeGraph context.
+ *
+ * Use this when you've already caught a ZodError and want to
+ * convert it to a ValidationError with context.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   schema.parse(input);
+ * } catch (error) {
+ *   if (error instanceof ZodError) {
+ *     throw wrapZodError(error, {
+ *       entityType: "node",
+ *       kind: "Person",
+ *       operation: "create",
+ *     });
+ *   }
+ *   throw error;
+ * }
+ * ```
+ */
+declare function wrapZodError(error: ZodError, context: ValidationContext): ValidationError;
+/**
+ * Creates a simple ValidationError without Zod context.
+ *
+ * Use this for custom validation rules that aren't part of a Zod schema.
+ *
+ * @example
+ * ```typescript
+ * if (startDate > endDate) {
+ *   throw createValidationError(
+ *     "Start date must be before end date",
+ *     [{ path: "startDate", message: "Must be before endDate" }],
+ *     { entityType: "edge", kind: "employment", operation: "create" }
+ *   );
+ * }
+ * ```
+ */
+declare function createValidationError(message: string, issues: ValidationIssue[], context?: Partial<ValidationContext>): ValidationError;
+
+export { type DeserializedSchema, SchemaHash, SerializedClosures, SerializedEdgeDef, SerializedMetaEdge, SerializedNodeDef, SerializedOntologyRelation, SerializedSchema, type ValidationContext, computeSchemaHash, createValidationError, deserializeSchema, deserializeWherePredicate, serializeSchema, validateEdgeProps, validateNodeProps, validateProps, wrapZodError };

package/dist/schema/index.d.ts

@@ -0,0 +1,237 @@
+import { K as KindRegistry, G as GraphDef } from '../manager-e9LXthrx.js';
+export { C as ChangeSeverity, a as ChangeType, E as EdgeChange, M as MigrationHookContext, N as NodeChange, O as OntologyChange, S as SchemaDiff, b as SchemaManagerOptions, c as SchemaValidationResult, d as computeSchemaDiff, e as ensureSchema, g as getActiveSchema, f as getMigrationActions, h as getSchemaChanges, i as initializeSchema, j as isBackwardsCompatible, k as isSchemaInitialized, m as migrateSchema, r as rollbackSchema } from '../manager-e9LXthrx.js';
+import { S as SerializedNodeDef, a as SerializedEdgeDef, b as SerializedMetaEdge, c as SerializedOntologyRelation, d as SerializedClosures, e as SerializedSchema, f as SchemaHash } from '../types-Cdbi4hcx.js';
+export { J as JsonSchema, g as SerializedOntology, h as SerializedUniqueConstraint } from '../types-Cdbi4hcx.js';
+import { ZodType, ZodError } from 'zod';
+import { V as ValidationIssue, a as ValidationError } from '../index-Dkicw49A.js';
+import '../types-DTJEu_-h.js';
+import 'drizzle-orm';
+import '../types-BRzHlhKC.js';
+
+/**
+ * Schema deserializer for loading stored schemas.
+ *
+ * Reconstructs runtime objects from SerializedSchema.
+ * Note: Zod schemas cannot be fully reconstructed from JSON Schema,
+ * so this provides access to the serialized data for introspection.
+ */
+
+/**
+ * A deserialized schema provides read-only access to schema metadata.
+ *
+ * Note: Unlike the original GraphDef, this does not include Zod schemas
+ * since those cannot be reconstructed from JSON Schema. Use this for
+ * introspection and metadata access only.
+ */
+type DeserializedSchema = Readonly<{
+    graphId: string;
+    version: number;
+    generatedAt: string;
+    /** Get node definition by name */
+    getNode: (name: string) => SerializedNodeDef | undefined;
+    /** Get all node names */
+    getNodeNames: () => readonly string[];
+    /** Get edge definition by name */
+    getEdge: (name: string) => SerializedEdgeDef | undefined;
+    /** Get all edge names */
+    getEdgeNames: () => readonly string[];
+    /** Get meta-edge definition by name */
+    getMetaEdge: (name: string) => SerializedMetaEdge | undefined;
+    /** Get all meta-edge names */
+    getMetaEdgeNames: () => readonly string[];
+    /** Get all ontology relations */
+    getRelations: () => readonly SerializedOntologyRelation[];
+    /** Get precomputed closures */
+    getClosures: () => SerializedClosures;
+    /** Get graph defaults */
+    getDefaults: () => SerializedSchema["defaults"];
+    /** Get the raw serialized schema */
+    getRaw: () => SerializedSchema;
+    /** Build a KindRegistry from the closures */
+    buildRegistry: () => KindRegistry;
+}>;
+/**
+ * Deserializes a SerializedSchema into a DeserializedSchema.
+ *
+ * @param schema - The serialized schema to deserialize
+ * @returns A deserialized schema with accessor methods
+ */
+declare function deserializeSchema(schema: SerializedSchema): DeserializedSchema;
+
+/**
+ * Serializes a GraphDef to a SerializedSchema.
+ *
+ * @param graph - The graph definition to serialize
+ * @param version - The schema version number
+ * @returns The serialized schema
+ */
+declare function serializeSchema<G extends GraphDef>(graph: G, version: number): SerializedSchema;
+/**
+ * A serialized predicate structure (matches UniqueConstraintPredicate from core/types).
+ */
+type SerializedPredicate = Readonly<{
+    __type: "unique_predicate";
+    field: string;
+    op: "isNull" | "isNotNull";
+}>;
+/**
+ * Field builder returned by the predicate proxy.
+ */
+type FieldPredicateBuilder = Readonly<{
+    isNull: () => SerializedPredicate;
+    isNotNull: () => SerializedPredicate;
+}>;
+/**
+ * Predicate builder type for where clause serialization.
+ */
+type PredicateBuilder = Readonly<Record<string, FieldPredicateBuilder>>;
+/**
+ * Deserializes a where predicate JSON back to a predicate function.
+ *
+ * This can be used to reconstruct a UniqueConstraint's where clause
+ * from a serialized schema.
+ *
+ * @param serialized - The JSON string from serialization
+ * @returns A where function that returns the predicate structure
+ */
+/**
+ * Unique predicate result type.
+ */
+type UniquePredicate = Readonly<{
+    __type: "unique_predicate";
+    field: string;
+    op: "isNull" | "isNotNull";
+}>;
+declare function deserializeWherePredicate(serialized: string): (builder: PredicateBuilder) => UniquePredicate;
+/**
+ * Computes a hash of the schema content for change detection.
+ *
+ * Excludes version and generatedAt since those change on every save.
+ */
+declare function computeSchemaHash(schema: SerializedSchema): Promise<SchemaHash>;
+
+/**
+ * Contextual Validation Utilities
+ *
+ * Provides Zod validation wrappers that include full context about
+ * which entity (node/edge) and operation (create/update) failed.
+ *
+ * @example
+ * ```typescript
+ * const props = validateNodeProps(schema, input, {
+ *   kind: "Person",
+ *   operation: "create",
+ * });
+ * ```
+ */
+
+/**
+ * Context for validation operations.
+ */
+type ValidationContext = Readonly<{
+    /** Type of entity being validated */
+    entityType: "node" | "edge";
+    /** Kind/type name of the entity */
+    kind: string;
+    /** Operation being performed */
+    operation: "create" | "update";
+    /** Entity ID (for updates) */
+    id?: string;
+}>;
+/**
+ * Validates props with full context for error messages.
+ *
+ * @param schema - Zod schema to validate against
+ * @param props - Properties to validate
+ * @param context - Context about the entity and operation
+ * @returns Validated and transformed props
+ * @throws ValidationError with full context if validation fails
+ *
+ * @example
+ * ```typescript
+ * const validatedProps = validateProps(personSchema, input, {
+ *   entityType: "node",
+ *   kind: "Person",
+ *   operation: "create",
+ * });
+ * ```
+ */
+declare function validateProps<T>(schema: ZodType<T>, props: unknown, context: ValidationContext): T;
+/**
+ * Validates node props with full context.
+ *
+ * Convenience wrapper around validateProps for node operations.
+ *
+ * @example
+ * ```typescript
+ * const props = validateNodeProps(schema, input, {
+ *   kind: "Person",
+ *   operation: "create",
+ * });
+ * ```
+ */
+declare function validateNodeProps<T>(schema: ZodType<T>, props: unknown, context: Readonly<{
+    kind: string;
+    operation: "create" | "update";
+    id?: string;
+}>): T;
+/**
+ * Validates edge props with full context.
+ *
+ * Convenience wrapper around validateProps for edge operations.
+ *
+ * @example
+ * ```typescript
+ * const props = validateEdgeProps(schema, input, {
+ *   kind: "worksAt",
+ *   operation: "create",
+ * });
+ * ```
+ */
+declare function validateEdgeProps<T>(schema: ZodType<T>, props: unknown, context: Readonly<{
+    kind: string;
+    operation: "create" | "update";
+    id?: string;
+}>): T;
+/**
+ * Wraps a Zod error with TypeGraph context.
+ *
+ * Use this when you've already caught a ZodError and want to
+ * convert it to a ValidationError with context.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   schema.parse(input);
+ * } catch (error) {
+ *   if (error instanceof ZodError) {
+ *     throw wrapZodError(error, {
+ *       entityType: "node",
+ *       kind: "Person",
+ *       operation: "create",
+ *     });
+ *   }
+ *   throw error;
+ * }
+ * ```
+ */
+declare function wrapZodError(error: ZodError, context: ValidationContext): ValidationError;
+/**
+ * Creates a simple ValidationError without Zod context.
+ *
+ * Use this for custom validation rules that aren't part of a Zod schema.
+ *
+ * @example
+ * ```typescript
+ * if (startDate > endDate) {
+ *   throw createValidationError(
+ *     "Start date must be before end date",
+ *     [{ path: "startDate", message: "Must be before endDate" }],
+ *     { entityType: "edge", kind: "employment", operation: "create" }
+ *   );
+ * }
+ * ```
+ */
+declare function createValidationError(message: string, issues: ValidationIssue[], context?: Partial<ValidationContext>): ValidationError;
+
+export { type DeserializedSchema, SchemaHash, SerializedClosures, SerializedEdgeDef, SerializedMetaEdge, SerializedNodeDef, SerializedOntologyRelation, SerializedSchema, type ValidationContext, computeSchemaHash, createValidationError, deserializeSchema, deserializeWherePredicate, serializeSchema, validateEdgeProps, validateNodeProps, validateProps, wrapZodError };