@nicia-ai/typegraph 0.45.0 → 0.46.1

package/dist/backend/sqlite/local-store.js

@@ -1,46 +1,49 @@
-import { createLocalSqliteBackend } from '../../chunk-VTN3C3CH.js';
-export { DEFAULT_LOCAL_SQLITE_PRAGMAS } from '../../chunk-VTN3C3CH.js';
-import '../../chunk-4GUTQPVO.js';
-import '../../chunk-DXEEHSGN.js';
-import { createStoreWithSchema } from '../../chunk-ID4WXTKL.js';
-import '../../chunk-4QIKLIGG.js';
-import '../../chunk-QT6V3YRH.js';
-import '../../chunk-YMTXMPV6.js';
-import { createSqliteTables } from '../../chunk-BGYJW37L.js';
-import '../../chunk-EFEOOCJ3.js';
-import '../../chunk-Q6EDCUXV.js';
-import '../../chunk-TKORQCG4.js';
-import '../../chunk-35S6P5ZU.js';
-import '../../chunk-MIJKEVV7.js';
-import { closeAfterFailure } from '../../chunk-55ITBQJI.js';
-import '../../chunk-2L54C2C2.js';
-import '../../chunk-FQ7ZPOTZ.js';
-import '../../chunk-DRACN6XG.js';
-import '../../chunk-TKP5T34P.js';
-import '../../chunk-DK2S42XB.js';
-import '../../chunk-UR7W5YQK.js';
-import '../../chunk-V34A6R5V.js';
-import '../../chunk-S4KQ5LV4.js';
-import '../../chunk-KCO5EFJU.js';
-import '../../chunk-FL5UQRES.js';
-import '../../chunk-QLUXRWKL.js';
-import '../../chunk-FLEQ2HBK.js';
+import { createLocalSqliteBackend } from '../../chunk-HFHTMECK.js';
+export { DEFAULT_LOCAL_SQLITE_PRAGMAS } from '../../chunk-HFHTMECK.js';
+import '../../chunk-C23WSN5E.js';
+import '../../chunk-7VQXLT5O.js';
+import { createStoreWithSchema } from '../../chunk-S6PW7VV5.js';
+import '../../chunk-BKCUOV7A.js';
+import '../../chunk-YWGVVALJ.js';
+import '../../chunk-NMWDXFPH.js';
+import { createSqliteTables } from '../../chunk-5UVRGXD3.js';
+import '../../chunk-UV3SN74I.js';
+import '../../chunk-L65OU2U3.js';
+import '../../chunk-M3WP7RQZ.js';
+import '../../chunk-LGHCOKTT.js';
+import '../../chunk-JXA2ZP2Q.js';
+import '../../chunk-GF3KXUTW.js';
+import '../../chunk-NLI2AVEF.js';
+import '../../chunk-JBQQ7THH.js';
+import '../../chunk-JZUR7ZWE.js';
+import '../../chunk-MSY7FSX4.js';
+import { closeAfterFailure } from '../../chunk-AKLS3BYZ.js';
+import '../../chunk-775A4ZMN.js';
+import '../../chunk-WDGA7IYB.js';
+import '../../chunk-XL7SLCXS.js';
+import '../../chunk-DCQVHAYQ.js';
+import '../../chunk-CBTIUB76.js';
+import '../../chunk-I5MOXA4H.js';
 import '../../chunk-K34OPSJK.js';
 import '../../chunk-2EBMPJBO.js';
-import '../../chunk-PVUI6KGR.js';
-import '../../chunk-6DCB664D.js';
-import '../../chunk-D7PG5D5K.js';
-import '../../chunk-SNXVDZAJ.js';
-import '../../chunk-QMQLUA66.js';
+import '../../chunk-YDFDBE6D.js';
+import '../../chunk-PQBQG7IM.js';
+import '../../chunk-AMKPPFUO.js';
+import '../../chunk-W6OG3HDG.js';
 import '../../chunk-PC2UBAUB.js';
-import '../../chunk-4GUBTVPV.js';
-import '../../chunk-GYA4JRP5.js';
-import '../../chunk-42PYUGLS.js';
-import '../../chunk-ITE4IXAK.js';
-import '../../chunk-4MB3AQAQ.js';
-import '../../chunk-G6Q5UM7U.js';
+import '../../chunk-T4XNKYXB.js';
+import '../../chunk-JXXDZTMN.js';
+import '../../chunk-K5ELX2GT.js';
+import '../../chunk-J3WZ3FA2.js';
+import '../../chunk-FWJKWH6U.js';
+import '../../chunk-DYATYRY4.js';
 
 // src/backend/sqlite/local-store.ts
+function withoutSchemaOverride(schemaManagement) {
+  if (schemaManagement === void 0) return {};
+  const { schema: smuggled, ...rest } = schemaManagement;
+  return rest;
+}
 async function createLocalSqliteStore(graph, options = {}) {
   const tables = options.store?.schema === void 0 ? void 0 : createSqliteTables(options.store.schema.tables);
   const { backend } = createLocalSqliteBackend({
@@ -52,7 +55,10 @@ async function createLocalSqliteStore(graph, options = {}) {
   try {
     const [store] = await createStoreWithSchema(graph, backend, {
       ...options.store,
-      ...options.schemaManagement
+      // The type already excludes `schema` here; the runtime strip guards
+      // untyped callers, so the provisioned schema (or the default tables)
+      // can never diverge from the one the Store reads.
+      ...withoutSchemaOverride(options.schemaManagement)
     });
     return store;
   } catch (error) {

package/dist/backend/sqlite/local-store.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/backend/sqlite/local-store.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6EA,eAAsB,sBAAA,CACpB,KAAA,EACA,OAAA,GAAmC,EAAC,EACwB;AAC5D,EAAA,MAAM,MAAA,GACJ,OAAA,CAAQ,KAAA,EAAO,MAAA,KAAW,MAAA,GACxB,SACA,kBAAA,CAAmB,OAAA,CAAQ,KAAA,CAAM,MAAA,CAAO,MAAM,CAAA;AAClD,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,wBAAA,CAAyB;AAAA,IAC3C,GAAI,QAAQ,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AAAA,IAC3D,GAAI,QAAQ,OAAA,KAAY,MAAA,GAAY,EAAC,GAAI,EAAE,OAAA,EAAS,OAAA,CAAQ,OAAA,EAAQ;AAAA,IACpE,GAAI,QAAQ,YAAA,KAAiB,MAAA,GAC3B,EAAC,GACD,EAAE,YAAA,EAAc,OAAA,CAAQ,YAAA,EAAa;AAAA,IACvC,GAAI,MAAA,KAAW,MAAA,GAAY,EAAC,GAAI,EAAE,MAAA;AAAO,GAC1C,CAAA;AACD,EAAA,IAAI;AACF,IAAA,MAAM,CAAC,KAAK,CAAA,GAAI,MAAM,qBAAA,CAAsB,OAAO,OAAA,EAAS;AAAA,MAC1D,GAAG,OAAA,CAAQ,KAAA;AAAA,MACX,GAAG,OAAA,CAAQ;AAAA,KACZ,CAAA;AACD,IAAA,OAAO,KAAA;AAAA,EACT,SAAS,KAAA,EAAO;AACd,IAAA,OAAO,iBAAA,CAAkB,SAAS,KAAK,CAAA;AAAA,EACzC;AACF","file":"local-store.js","sourcesContent":["/**\n * Batteries-included local SQLite Store for strict TypeScript consumers.\n *\n * This entrypoint owns the connection and intentionally exposes the portable\n * TypeGraph Store surface rather than the adapter-native Drizzle handle.\n */\nimport { type GraphDef } from \"../../core/define-graph\";\nimport { type SchemaManagerOptions } from \"../../schema/manager\";\nimport {\n  createStoreWithSchema,\n  type HistoryStore,\n  type RecordedReadStore,\n  type Store,\n} from \"../../store/store\";\nimport {\n  type HistoryStoreOptions,\n  type LiveStoreOptions,\n  type RecordedReadStoreOptions,\n  type StoreOptions,\n  type UnboundLiveStoreOptions,\n} from \"../../store/types\";\nimport { createSqliteTables } from \"../drizzle/schema/sqlite\";\nimport { type BackendCapabilities, closeAfterFailure } from \"../types\";\nimport { createLocalSqliteBackend } from \"./local\";\nimport { type LocalSqlitePragmaOptions } from \"./local-options\";\n\nexport type {\n  ContributionDiagnostic,\n  ContributionDiagnosticState,\n  ContributionRepairEntry,\n  ContributionRepairResult,\n} from \"../types\";\nexport {\n  DEFAULT_LOCAL_SQLITE_PRAGMAS,\n  type LocalSqliteJournalMode,\n  type LocalSqlitePragmaOptions,\n  type LocalSqliteSynchronousMode,\n} from \"./local-options\";\n\nexport type LocalSqliteStoreOptions<\n  TStoreOptions extends StoreOptions = StoreOptions,\n> = Readonly<{\n  /** SQLite file path. Defaults to an in-memory database. */\n  path?: string;\n  /** Connection pragmas applied when the owned database is opened. */\n  pragmas?: LocalSqlitePragmaOptions | false;\n  /** Optional backend capability overrides, primarily for controlled hosts. */\n  capabilities?: Partial<BackendCapabilities>;\n  /** Store behavior, including hooks, history, and custom table names. */\n  store?: TStoreOptions;\n  /** Schema initialization and migration policy. */\n  schemaManagement?: SchemaManagerOptions;\n}>;\n\n/** Creates, provisions, and returns a full typed local SQLite Store. */\nexport function createLocalSqliteStore<G extends GraphDef>(\n  graph: G,\n  options?: LocalSqliteStoreOptions<UnboundLiveStoreOptions>,\n): Promise<Store<G>>;\nexport function createLocalSqliteStore<G extends GraphDef>(\n  graph: G,\n  options: LocalSqliteStoreOptions<HistoryStoreOptions> &\n    Readonly<{ store: HistoryStoreOptions }>,\n): Promise<HistoryStore<G>>;\nexport function createLocalSqliteStore<G extends GraphDef>(\n  graph: G,\n  options: LocalSqliteStoreOptions<RecordedReadStoreOptions> &\n    Readonly<{ store: RecordedReadStoreOptions }>,\n): Promise<RecordedReadStore<G>>;\nexport function createLocalSqliteStore<G extends GraphDef>(\n  graph: G,\n  options: LocalSqliteStoreOptions<LiveStoreOptions>,\n): Promise<Store<G> | RecordedReadStore<G>>;\nexport function createLocalSqliteStore<G extends GraphDef>(\n  graph: G,\n  options: LocalSqliteStoreOptions,\n): Promise<Store<G> | HistoryStore<G> | RecordedReadStore<G>>;\nexport async function createLocalSqliteStore<G extends GraphDef>(\n  graph: G,\n  options: LocalSqliteStoreOptions = {},\n): Promise<Store<G> | HistoryStore<G> | RecordedReadStore<G>> {\n  const tables =\n    options.store?.schema === undefined ?\n      undefined\n    : createSqliteTables(options.store.schema.tables);\n  const { backend } = createLocalSqliteBackend({\n    ...(options.path === undefined ? {} : { path: options.path }),\n    ...(options.pragmas === undefined ? {} : { pragmas: options.pragmas }),\n    ...(options.capabilities === undefined ?\n      {}\n    : { capabilities: options.capabilities }),\n    ...(tables === undefined ? {} : { tables }),\n  });\n  try {\n    const [store] = await createStoreWithSchema(graph, backend, {\n      ...options.store,\n      ...options.schemaManagement,\n    });\n    return store;\n  } catch (error) {\n    return closeAfterFailure(backend, error);\n  }\n}\n"]}
+{"version":3,"sources":["../../../src/backend/sqlite/local-store.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6EA,SAAS,sBACP,gBAAA,EACsC;AACtC,EAAA,IAAI,gBAAA,KAAqB,MAAA,EAAW,OAAO,EAAC;AAC5C,EAAA,MAAM,EAAE,MAAA,EAAQ,QAAA,EAAU,GAAG,MAAK,GAChC,gBAAA;AAEF,EAAA,OAAO,IAAA;AACT;AAyBA,eAAsB,sBAAA,CACpB,KAAA,EACA,OAAA,GAAmC,EAAC,EACwB;AAC5D,EAAA,MAAM,MAAA,GACJ,OAAA,CAAQ,KAAA,EAAO,MAAA,KAAW,MAAA,GACxB,SACA,kBAAA,CAAmB,OAAA,CAAQ,KAAA,CAAM,MAAA,CAAO,MAAM,CAAA;AAClD,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,wBAAA,CAAyB;AAAA,IAC3C,GAAI,QAAQ,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AAAA,IAC3D,GAAI,QAAQ,OAAA,KAAY,MAAA,GAAY,EAAC,GAAI,EAAE,OAAA,EAAS,OAAA,CAAQ,OAAA,EAAQ;AAAA,IACpE,GAAI,QAAQ,YAAA,KAAiB,MAAA,GAC3B,EAAC,GACD,EAAE,YAAA,EAAc,OAAA,CAAQ,YAAA,EAAa;AAAA,IACvC,GAAI,MAAA,KAAW,MAAA,GAAY,EAAC,GAAI,EAAE,MAAA;AAAO,GAC1C,CAAA;AACD,EAAA,IAAI;AACF,IAAA,MAAM,CAAC,KAAK,CAAA,GAAI,MAAM,qBAAA,CAAsB,OAAO,OAAA,EAAS;AAAA,MAC1D,GAAG,OAAA,CAAQ,KAAA;AAAA;AAAA;AAAA;AAAA,MAIX,GAAG,qBAAA,CAAsB,OAAA,CAAQ,gBAAgB;AAAA,KAClD,CAAA;AACD,IAAA,OAAO,KAAA;AAAA,EACT,SAAS,KAAA,EAAO;AACd,IAAA,OAAO,iBAAA,CAAkB,SAAS,KAAK,CAAA;AAAA,EACzC;AACF","file":"local-store.js","sourcesContent":["/**\n * Batteries-included local SQLite Store for strict TypeScript consumers.\n *\n * This entrypoint owns the connection and intentionally exposes the portable\n * TypeGraph Store surface rather than the adapter-native Drizzle handle.\n */\nimport { type GraphDef } from \"../../core/define-graph\";\nimport { type SchemaManagerOptions } from \"../../schema/manager\";\nimport {\n  createStoreWithSchema,\n  type HistoryStore,\n  type RecordedReadStore,\n  type Store,\n} from \"../../store/store\";\nimport {\n  type HistoryStoreOptions,\n  type LiveStoreOptions,\n  type RecordedReadStoreOptions,\n  type StoreOptions,\n  type UnboundLiveStoreOptions,\n} from \"../../store/types\";\nimport { createSqliteTables } from \"../drizzle/schema/sqlite\";\nimport { type BackendCapabilities, closeAfterFailure } from \"../types\";\nimport { createLocalSqliteBackend } from \"./local\";\nimport { type LocalSqlitePragmaOptions } from \"./local-options\";\n\nexport type { GraphIdentityConfig } from \"../../core/define-graph\";\nexport type {\n  IdentityAssertion,\n  IdentityAssertionId,\n  IdentityAssertionResult,\n  IdentityFacade,\n  IdentityNode,\n  IdentityNodeRefInput,\n  IdentityPair,\n  IdentityReadFacade,\n  IdentityRelation,\n  IdentityWriteSummary,\n} from \"../../identity\";\nexport type {\n  ContributionDiagnostic,\n  ContributionDiagnosticState,\n  ContributionRepairEntry,\n  ContributionRepairResult,\n} from \"../types\";\nexport {\n  DEFAULT_LOCAL_SQLITE_PRAGMAS,\n  type LocalSqliteJournalMode,\n  type LocalSqlitePragmaOptions,\n  type LocalSqliteSynchronousMode,\n} from \"./local-options\";\n\nexport type LocalSqliteStoreOptions<\n  TStoreOptions extends StoreOptions = StoreOptions,\n> = Readonly<{\n  /** SQLite file path. Defaults to an in-memory database. */\n  path?: string;\n  /** Connection pragmas applied when the owned database is opened. */\n  pragmas?: LocalSqlitePragmaOptions | false;\n  /** Optional backend capability overrides, primarily for controlled hosts. */\n  capabilities?: Partial<BackendCapabilities>;\n  /** Store behavior, including hooks, history, and custom table names. */\n  store?: TStoreOptions;\n  /**\n   * Schema initialization and migration policy. `schema` is excluded here:\n   * the effective SqlSchema has exactly one source — `store.schema` — which\n   * this constructor also uses to provision the physical tables, so a\n   * second schema could name tables that were never created.\n   */\n  schemaManagement?: Omit<SchemaManagerOptions, \"schema\">;\n}>;\n\n/**\n * Drops a smuggled `schema` from the nested schema-management options: the\n * effective `SqlSchema` has exactly one source (`store.schema`), which also\n * drives physical table provisioning in this constructor.\n */\nfunction withoutSchemaOverride(\n  schemaManagement: Omit<SchemaManagerOptions, \"schema\"> | undefined,\n): Omit<SchemaManagerOptions, \"schema\"> {\n  if (schemaManagement === undefined) return {};\n  const { schema: smuggled, ...rest } =\n    schemaManagement as SchemaManagerOptions;\n  void smuggled;\n  return rest;\n}\n\n/** Creates, provisions, and returns a full typed local SQLite Store. */\nexport function createLocalSqliteStore<G extends GraphDef>(\n  graph: G,\n  options?: LocalSqliteStoreOptions<UnboundLiveStoreOptions>,\n): Promise<Store<G>>;\nexport function createLocalSqliteStore<G extends GraphDef>(\n  graph: G,\n  options: LocalSqliteStoreOptions<HistoryStoreOptions> &\n    Readonly<{ store: HistoryStoreOptions }>,\n): Promise<HistoryStore<G>>;\nexport function createLocalSqliteStore<G extends GraphDef>(\n  graph: G,\n  options: LocalSqliteStoreOptions<RecordedReadStoreOptions> &\n    Readonly<{ store: RecordedReadStoreOptions }>,\n): Promise<RecordedReadStore<G>>;\nexport function createLocalSqliteStore<G extends GraphDef>(\n  graph: G,\n  options: LocalSqliteStoreOptions<LiveStoreOptions>,\n): Promise<Store<G> | RecordedReadStore<G>>;\nexport function createLocalSqliteStore<G extends GraphDef>(\n  graph: G,\n  options: LocalSqliteStoreOptions,\n): Promise<Store<G> | HistoryStore<G> | RecordedReadStore<G>>;\nexport async function createLocalSqliteStore<G extends GraphDef>(\n  graph: G,\n  options: LocalSqliteStoreOptions = {},\n): Promise<Store<G> | HistoryStore<G> | RecordedReadStore<G>> {\n  const tables =\n    options.store?.schema === undefined ?\n      undefined\n    : createSqliteTables(options.store.schema.tables);\n  const { backend } = createLocalSqliteBackend({\n    ...(options.path === undefined ? {} : { path: options.path }),\n    ...(options.pragmas === undefined ? {} : { pragmas: options.pragmas }),\n    ...(options.capabilities === undefined ?\n      {}\n    : { capabilities: options.capabilities }),\n    ...(tables === undefined ? {} : { tables }),\n  });\n  try {\n    const [store] = await createStoreWithSchema(graph, backend, {\n      ...options.store,\n      // The type already excludes `schema` here; the runtime strip guards\n      // untyped callers, so the provisioned schema (or the default tables)\n      // can never diverge from the one the Store reads.\n      ...withoutSchemaOverride(options.schemaManagement),\n    });\n    return store;\n  } catch (error) {\n    return closeAfterFailure(backend, error);\n  }\n}\n"]}

package/dist/backend/sqlite/local.cjs

@@ -1,35 +1,34 @@
 'use strict';
 
-var chunkVVQM4CZD_cjs = require('../../chunk-VVQM4CZD.cjs');
-require('../../chunk-P7GTYOLB.cjs');
-require('../../chunk-H7VE3FL4.cjs');
-require('../../chunk-NAAMUYMS.cjs');
-require('../../chunk-4SZ6XPTG.cjs');
-require('../../chunk-F4NHQHEZ.cjs');
-require('../../chunk-Z3WO6MND.cjs');
-require('../../chunk-OOA273IJ.cjs');
-require('../../chunk-ZDH3DX3C.cjs');
-require('../../chunk-EKFUG4G7.cjs');
-require('../../chunk-ACSVZPK7.cjs');
-require('../../chunk-JQXSZHF2.cjs');
-require('../../chunk-5GAONX5G.cjs');
+var chunk3DHZCOT7_cjs = require('../../chunk-3DHZCOT7.cjs');
+require('../../chunk-YVWGEQJE.cjs');
+require('../../chunk-MUK4BU7K.cjs');
+require('../../chunk-PNN7RHVR.cjs');
+require('../../chunk-A4OC4DVN.cjs');
+require('../../chunk-YAAM3M2S.cjs');
+require('../../chunk-RMQLSPA2.cjs');
+require('../../chunk-U5SON7R2.cjs');
+require('../../chunk-PWLJ77UV.cjs');
+require('../../chunk-BSFJMMV3.cjs');
+require('../../chunk-XBYVV3MP.cjs');
+require('../../chunk-XCAGZAKP.cjs');
 require('../../chunk-ZY4GXIVN.cjs');
 require('../../chunk-NAUA4PW5.cjs');
-require('../../chunk-JXUTCSXX.cjs');
-require('../../chunk-U5W4LKZV.cjs');
-require('../../chunk-764JHTLT.cjs');
-require('../../chunk-C4F7VJ5D.cjs');
-require('../../chunk-TDXIBCGY.cjs');
+require('../../chunk-4UGOKMI5.cjs');
+require('../../chunk-VCRRKBLN.cjs');
+require('../../chunk-NI72YOJB.cjs');
+require('../../chunk-A7J2YDDI.cjs');
+require('../../chunk-N66HCGCY.cjs');
 
 
 
 Object.defineProperty(exports, "DEFAULT_LOCAL_SQLITE_PRAGMAS", {
   enumerable: true,
-  get: function () { return chunkVVQM4CZD_cjs.DEFAULT_LOCAL_SQLITE_PRAGMAS; }
+  get: function () { return chunk3DHZCOT7_cjs.DEFAULT_LOCAL_SQLITE_PRAGMAS; }
 });
 Object.defineProperty(exports, "createLocalSqliteBackend", {
   enumerable: true,
-  get: function () { return chunkVVQM4CZD_cjs.createLocalSqliteBackend; }
+  get: function () { return chunk3DHZCOT7_cjs.createLocalSqliteBackend; }
 });
 //# sourceMappingURL=local.cjs.map
 //# sourceMappingURL=local.cjs.map

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

@@ -1,8 +1,8 @@
 import { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
-import { B as BackendCapabilities, A as AdapterBackend } from '../../types-Ch9a0Dx6.cjs';
-export { C as ContributionDiagnostic, a as ContributionDiagnosticState, b as ContributionRepairEntry, c as ContributionRepairResult } from '../../types-Ch9a0Dx6.cjs';
+import { B as BackendCapabilities, A as AdapterBackend } from '../../types-HkveCCx0.cjs';
+export { C as ContributionDiagnostic, a as ContributionDiagnosticState, b as ContributionRepairEntry, c as ContributionRepairResult, G as GraphIdentityConfig } from '../../types-HkveCCx0.cjs';
 import { A as AnySqliteDatabase } from '../../sqlite-execution-DwbE2a9y.cjs';
-import { S as SqliteTables } from '../../sqlite-DY0WODUK.cjs';
+import { S as SqliteTables } from '../../sqlite-DitnISa9.cjs';
 import { L as LocalSqlitePragmaOptions } from '../../local-options-CZ1BnIoF.cjs';
 export { D as DEFAULT_LOCAL_SQLITE_PRAGMAS, a as LocalSqliteJournalMode, b as LocalSqliteSynchronousMode } from '../../local-options-CZ1BnIoF.cjs';
 import 'zod';

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

@@ -1,8 +1,8 @@
 import { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
-import { B as BackendCapabilities, A as AdapterBackend } from '../../types-Ch9a0Dx6.js';
-export { C as ContributionDiagnostic, a as ContributionDiagnosticState, b as ContributionRepairEntry, c as ContributionRepairResult } from '../../types-Ch9a0Dx6.js';
+import { B as BackendCapabilities, A as AdapterBackend } from '../../types-HkveCCx0.js';
+export { C as ContributionDiagnostic, a as ContributionDiagnosticState, b as ContributionRepairEntry, c as ContributionRepairResult, G as GraphIdentityConfig } from '../../types-HkveCCx0.js';
 import { A as AnySqliteDatabase } from '../../sqlite-execution-DwbE2a9y.js';
-import { S as SqliteTables } from '../../sqlite-L-VIRzqA.js';
+import { S as SqliteTables } from '../../sqlite-DerU5tc7.js';
 import { L as LocalSqlitePragmaOptions } from '../../local-options-CZ1BnIoF.js';
 export { D as DEFAULT_LOCAL_SQLITE_PRAGMAS, a as LocalSqliteJournalMode, b as LocalSqliteSynchronousMode } from '../../local-options-CZ1BnIoF.js';
 import 'zod';

package/dist/backend/sqlite/local.js

@@ -1,22 +1,21 @@
-export { DEFAULT_LOCAL_SQLITE_PRAGMAS, createLocalSqliteBackend } from '../../chunk-VTN3C3CH.js';
-import '../../chunk-4GUTQPVO.js';
-import '../../chunk-DXEEHSGN.js';
-import '../../chunk-4QIKLIGG.js';
-import '../../chunk-QT6V3YRH.js';
-import '../../chunk-YMTXMPV6.js';
-import '../../chunk-BGYJW37L.js';
-import '../../chunk-EFEOOCJ3.js';
-import '../../chunk-35S6P5ZU.js';
-import '../../chunk-55ITBQJI.js';
-import '../../chunk-UR7W5YQK.js';
-import '../../chunk-V34A6R5V.js';
-import '../../chunk-QLUXRWKL.js';
+export { DEFAULT_LOCAL_SQLITE_PRAGMAS, createLocalSqliteBackend } from '../../chunk-HFHTMECK.js';
+import '../../chunk-C23WSN5E.js';
+import '../../chunk-7VQXLT5O.js';
+import '../../chunk-BKCUOV7A.js';
+import '../../chunk-YWGVVALJ.js';
+import '../../chunk-NMWDXFPH.js';
+import '../../chunk-5UVRGXD3.js';
+import '../../chunk-UV3SN74I.js';
+import '../../chunk-JBQQ7THH.js';
+import '../../chunk-JZUR7ZWE.js';
+import '../../chunk-AKLS3BYZ.js';
+import '../../chunk-CBTIUB76.js';
 import '../../chunk-K34OPSJK.js';
 import '../../chunk-2EBMPJBO.js';
-import '../../chunk-PVUI6KGR.js';
-import '../../chunk-6DCB664D.js';
-import '../../chunk-QMQLUA66.js';
-import '../../chunk-4MB3AQAQ.js';
-import '../../chunk-G6Q5UM7U.js';
+import '../../chunk-YDFDBE6D.js';
+import '../../chunk-PQBQG7IM.js';
+import '../../chunk-J3WZ3FA2.js';
+import '../../chunk-FWJKWH6U.js';
+import '../../chunk-DYATYRY4.js';
 //# sourceMappingURL=local.js.map
 //# sourceMappingURL=local.js.map

package/dist/{chunk-S3ZRKJHY.js → chunk-2LG2XB2M.js}

@@ -1,4 +1,4 @@
-import { META_EDGE_BRAND } from './chunk-TKP5T34P.js';
+import { META_EDGE_BRAND } from './chunk-JXA2ZP2Q.js';
 import { z } from 'zod';
 
 // src/core/meta-edge.ts
@@ -46,5 +46,5 @@ function createExternalRef(table) {
 }
 
 export { createExternalRef, externalRef, getExternalRefTable, isExternalRefSchema, metaEdge };
-//# sourceMappingURL=chunk-S3ZRKJHY.js.map
-//# sourceMappingURL=chunk-S3ZRKJHY.js.map
+//# sourceMappingURL=chunk-2LG2XB2M.js.map
+//# sourceMappingURL=chunk-2LG2XB2M.js.map

package/dist/{chunk-S3ZRKJHY.js.map → chunk-2LG2XB2M.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/meta-edge.ts","../src/core/external-ref.ts"],"names":[],"mappings":";;;;AA8CO,SAAS,QAAA,CACd,IAAA,EACA,OAAA,GAA2B,EAAC,EACf;AACb,EAAA,MAAM,UAAA,GAAiC;AAAA,IACrC,UAAA,EAAY,QAAQ,UAAA,IAAc,KAAA;AAAA,IAClC,SAAA,EAAW,QAAQ,SAAA,IAAa,KAAA;AAAA,IAChC,SAAA,EAAW,QAAQ,SAAA,IAAa,KAAA;AAAA,IAChC,SAAS,OAAA,CAAQ,OAAA;AAAA,IACjB,SAAA,EAAW,QAAQ,SAAA,IAAa,MAAA;AAAA,IAChC,aAAa,OAAA,CAAQ;AAAA,GACvB;AAEA,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,CAAC,eAAe,GAAG,IAAA;AAAA,IACnB,IAAA;AAAA,IACA;AAAA,GACD,CAAA;AACH;AC/CO,IAAM,sBAAA,GAAyB,mBAAA;AA6E/B,SAAS,YAA8B,KAAA,EAAgC;AAC5E,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,WAAW,CAAA,EAAG;AACnD,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,0DAAA,EAA6D,OAAO,KAAA,KAAU,QAAA,GAAW,IAAI,KAAK,CAAA,CAAA,CAAA,GAAM,OAAO,KAAK,CAAA;AAAA,KACtH;AAAA,EACF;AAEA,EAAA,MAAM,MAAA,GAAS,EAAE,MAAA,CAAO;AAAA,IACtB,KAAA,EAAO,CAAA,CAAE,OAAA,CAAQ,KAAK,CAAA;AAAA,IACtB,IAAI,CAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,GAAG,yCAAyC;AAAA,GAChE,CAAA;AAGD,EAAA,OAAO,MAAA,CAAO,OAAO,MAAA,EAAQ;AAAA,IAC3B,CAAC,sBAAsB,GAAG;AAAA,GAC3B,CAAA;AACH;AASO,SAAS,oBACd,KAAA,EAC4B;AAC5B,EAAA,OACE,OAAO,KAAA,KAAU,QAAA,IACjB,KAAA,KAAU,IAAA,IACV,0BAA0B,KAAA,IAC1B,OAAQ,KAAA,CAAkC,sBAAsB,CAAA,KAC9D,QAAA;AAEN;AAMO,SAAS,oBAAoB,MAAA,EAAuC;AACzE,EAAA,IAAI,mBAAA,CAAoB,MAAM,CAAA,EAAG;AAC/B,IAAA,OAAO,OAAO,sBAAsB,CAAA;AAAA,EACtC;AACA,EAAA,OAAO,MAAA;AACT;AAoBO,SAAS,kBACd,KAAA,EACqC;AACrC,EAAA,OAAO,CAAC,EAAA,MAAgB,EAAE,KAAA,EAAO,EAAA,EAAG,CAAA;AACtC","file":"chunk-S3ZRKJHY.js","sourcesContent":["import {\n  type InferenceType,\n  META_EDGE_BRAND,\n  type MetaEdge,\n  type MetaEdgeProperties,\n} from \"../ontology/types\";\n\n// ============================================================\n// Meta-Edge Factory Options\n// ============================================================\n\n/**\n * Options for creating a meta-edge.\n */\nexport type MetaEdgeOptions = Readonly<{\n  /** Whether the relationship is transitive (A→B, B→C implies A→C) */\n  transitive?: boolean;\n  /** Whether the relationship is symmetric (A→B implies B→A) */\n  symmetric?: boolean;\n  /** Whether the relationship is reflexive (A→A is always true) */\n  reflexive?: boolean;\n  /** Name of the inverse meta-edge */\n  inverse?: string;\n  /** How this meta-edge affects queries and validation */\n  inference?: InferenceType;\n  /** Optional description */\n  description?: string;\n}>;\n\n// ============================================================\n// Meta-Edge Factory\n// ============================================================\n\n/**\n * Creates a custom meta-edge definition.\n *\n * @example\n * ```typescript\n * // Custom meta-edge for regulatory relationships\n * const regulatedBy = metaEdge(\"regulatedBy\", {\n *   description: \"Type X is regulated by authority type Y\",\n *   transitive: false,\n *   symmetric: false,\n * });\n * ```\n */\nexport function metaEdge<K extends string>(\n  name: K,\n  options: MetaEdgeOptions = {},\n): MetaEdge<K> {\n  const properties: MetaEdgeProperties = {\n    transitive: options.transitive ?? false,\n    symmetric: options.symmetric ?? false,\n    reflexive: options.reflexive ?? false,\n    inverse: options.inverse,\n    inference: options.inference ?? \"none\",\n    description: options.description,\n  };\n\n  return Object.freeze({\n    [META_EDGE_BRAND]: true as const,\n    name,\n    properties,\n  });\n}\n","/**\n * External reference type for hybrid overlay patterns.\n *\n * Creates a Zod-compatible schema for referencing entities in external\n * data sources (e.g., existing application tables) from TypeGraph nodes.\n */\nimport { z } from \"zod\";\n\n// ============================================================\n// External Reference Metadata Symbol\n// ============================================================\n\n/**\n * Symbol key for storing external table name on the schema.\n * This allows the schema introspector to detect external reference types\n * and extract source information.\n */\nexport const EXTERNAL_REF_TABLE_KEY = \"_externalRefTable\" as const;\n\n// ============================================================\n// External Reference Value Type\n// ============================================================\n\n/**\n * The shape of an external reference value.\n * Contains the source table identifier and the ID of the referenced record.\n */\nexport type ExternalRefValue<T extends string = string> = Readonly<{\n  table: T;\n  id: string;\n}>;\n\n// ============================================================\n// External Reference Schema Type\n// ============================================================\n\n/**\n * A Zod schema for external references with attached table metadata.\n */\nexport type ExternalRefSchema<T extends string = string> = z.ZodType<\n  ExternalRefValue<T>\n> &\n  Readonly<{\n    [EXTERNAL_REF_TABLE_KEY]: T;\n  }>;\n\n// ============================================================\n// External Reference Factory\n// ============================================================\n\n/**\n * Creates a Zod schema for referencing external data sources.\n *\n * Use this when building a hybrid overlay where TypeGraph stores\n * graph relationships and metadata while your existing tables\n * remain the source of truth for entity data.\n *\n * @param table - The identifier for the external table/source (e.g., \"users\", \"documents\")\n * @returns A Zod schema that validates external reference objects\n *\n * @example\n * ```typescript\n * import { defineNode, externalRef, embedding } from \"@nicia-ai/typegraph\";\n *\n * // Reference documents from your existing application database\n * const Document = defineNode(\"Document\", {\n *   schema: z.object({\n *     source: externalRef(\"documents\"),\n *     embedding: embedding(1536).optional(),\n *     extractedTopics: z.array(z.string()).optional(),\n *   }),\n * });\n *\n * // Create a node referencing an external document\n * await store.nodes.Document.create({\n *   source: { table: \"documents\", id: \"doc_abc123\" },\n *   embedding: await generateEmbedding(docContent),\n * });\n *\n * // Query and hydrate with external data\n * const results = await store\n *   .query()\n *   .from(\"Document\", \"d\")\n *   .whereNode(\"d\", (d) => d.embedding.similarTo(query, 10))\n *   .select((ctx) => ctx.d.source)\n *   .execute();\n *\n * // Fetch full data from your app database\n * const externalIds = results.map((r) => r.id);\n * const fullDocs = await appDb.query.documents.findMany({\n *   where: inArray(documents.id, externalIds),\n * });\n * ```\n */\nexport function externalRef<T extends string>(table: T): ExternalRefSchema<T> {\n  if (typeof table !== \"string\" || table.length === 0) {\n    throw new Error(\n      `External reference table must be a non-empty string, got: ${typeof table === \"string\" ? `\"${table}\"` : typeof table}`,\n    );\n  }\n\n  const schema = z.object({\n    table: z.literal(table),\n    id: z.string().min(1, \"External reference ID must be non-empty\"),\n  });\n\n  // Attach table metadata for introspection\n  return Object.assign(schema, {\n    [EXTERNAL_REF_TABLE_KEY]: table,\n  });\n}\n\n// ============================================================\n// Type Guards\n// ============================================================\n\n/**\n * Checks if a value is an external reference schema.\n */\nexport function isExternalRefSchema(\n  value: unknown,\n): value is ExternalRefSchema {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    EXTERNAL_REF_TABLE_KEY in value &&\n    typeof (value as Record<string, unknown>)[EXTERNAL_REF_TABLE_KEY] ===\n      \"string\"\n  );\n}\n\n/**\n * Gets the table name from an external reference schema.\n * Returns undefined if the schema is not an external reference schema.\n */\nexport function getExternalRefTable(schema: z.ZodType): string | undefined {\n  if (isExternalRefSchema(schema)) {\n    return schema[EXTERNAL_REF_TABLE_KEY];\n  }\n  return undefined;\n}\n\n// ============================================================\n// Helper for creating reference values\n// ============================================================\n\n/**\n * Helper function to create a typed external reference value.\n * Useful when you want to avoid repeating the table name.\n *\n * @example\n * ```typescript\n * const docRef = createExternalRef(\"documents\");\n *\n * await store.nodes.Document.create({\n *   source: docRef(\"doc_123\"),\n *   embedding: [...],\n * });\n * ```\n */\nexport function createExternalRef<T extends string>(\n  table: T,\n): (id: string) => ExternalRefValue<T> {\n  return (id: string) => ({ table, id });\n}\n"]}
+{"version":3,"sources":["../src/core/meta-edge.ts","../src/core/external-ref.ts"],"names":[],"mappings":";;;;AA8CO,SAAS,QAAA,CACd,IAAA,EACA,OAAA,GAA2B,EAAC,EACf;AACb,EAAA,MAAM,UAAA,GAAiC;AAAA,IACrC,UAAA,EAAY,QAAQ,UAAA,IAAc,KAAA;AAAA,IAClC,SAAA,EAAW,QAAQ,SAAA,IAAa,KAAA;AAAA,IAChC,SAAA,EAAW,QAAQ,SAAA,IAAa,KAAA;AAAA,IAChC,SAAS,OAAA,CAAQ,OAAA;AAAA,IACjB,SAAA,EAAW,QAAQ,SAAA,IAAa,MAAA;AAAA,IAChC,aAAa,OAAA,CAAQ;AAAA,GACvB;AAEA,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,CAAC,eAAe,GAAG,IAAA;AAAA,IACnB,IAAA;AAAA,IACA;AAAA,GACD,CAAA;AACH;AC/CO,IAAM,sBAAA,GAAyB,mBAAA;AA6E/B,SAAS,YAA8B,KAAA,EAAgC;AAC5E,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,WAAW,CAAA,EAAG;AACnD,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,0DAAA,EAA6D,OAAO,KAAA,KAAU,QAAA,GAAW,IAAI,KAAK,CAAA,CAAA,CAAA,GAAM,OAAO,KAAK,CAAA;AAAA,KACtH;AAAA,EACF;AAEA,EAAA,MAAM,MAAA,GAAS,EAAE,MAAA,CAAO;AAAA,IACtB,KAAA,EAAO,CAAA,CAAE,OAAA,CAAQ,KAAK,CAAA;AAAA,IACtB,IAAI,CAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,GAAG,yCAAyC;AAAA,GAChE,CAAA;AAGD,EAAA,OAAO,MAAA,CAAO,OAAO,MAAA,EAAQ;AAAA,IAC3B,CAAC,sBAAsB,GAAG;AAAA,GAC3B,CAAA;AACH;AASO,SAAS,oBACd,KAAA,EAC4B;AAC5B,EAAA,OACE,OAAO,KAAA,KAAU,QAAA,IACjB,KAAA,KAAU,IAAA,IACV,0BAA0B,KAAA,IAC1B,OAAQ,KAAA,CAAkC,sBAAsB,CAAA,KAC9D,QAAA;AAEN;AAMO,SAAS,oBAAoB,MAAA,EAAuC;AACzE,EAAA,IAAI,mBAAA,CAAoB,MAAM,CAAA,EAAG;AAC/B,IAAA,OAAO,OAAO,sBAAsB,CAAA;AAAA,EACtC;AACA,EAAA,OAAO,MAAA;AACT;AAoBO,SAAS,kBACd,KAAA,EACqC;AACrC,EAAA,OAAO,CAAC,EAAA,MAAgB,EAAE,KAAA,EAAO,EAAA,EAAG,CAAA;AACtC","file":"chunk-2LG2XB2M.js","sourcesContent":["import {\n  type InferenceType,\n  META_EDGE_BRAND,\n  type MetaEdge,\n  type MetaEdgeProperties,\n} from \"../ontology/types\";\n\n// ============================================================\n// Meta-Edge Factory Options\n// ============================================================\n\n/**\n * Options for creating a meta-edge.\n */\nexport type MetaEdgeOptions = Readonly<{\n  /** Whether the relationship is transitive (A→B, B→C implies A→C) */\n  transitive?: boolean;\n  /** Whether the relationship is symmetric (A→B implies B→A) */\n  symmetric?: boolean;\n  /** Whether the relationship is reflexive (A→A is always true) */\n  reflexive?: boolean;\n  /** Name of the inverse meta-edge */\n  inverse?: string;\n  /** How this meta-edge affects queries and validation */\n  inference?: InferenceType;\n  /** Optional description */\n  description?: string;\n}>;\n\n// ============================================================\n// Meta-Edge Factory\n// ============================================================\n\n/**\n * Creates a custom meta-edge definition.\n *\n * @example\n * ```typescript\n * // Custom meta-edge for regulatory relationships\n * const regulatedBy = metaEdge(\"regulatedBy\", {\n *   description: \"Type X is regulated by authority type Y\",\n *   transitive: false,\n *   symmetric: false,\n * });\n * ```\n */\nexport function metaEdge<K extends string>(\n  name: K,\n  options: MetaEdgeOptions = {},\n): MetaEdge<K> {\n  const properties: MetaEdgeProperties = {\n    transitive: options.transitive ?? false,\n    symmetric: options.symmetric ?? false,\n    reflexive: options.reflexive ?? false,\n    inverse: options.inverse,\n    inference: options.inference ?? \"none\",\n    description: options.description,\n  };\n\n  return Object.freeze({\n    [META_EDGE_BRAND]: true as const,\n    name,\n    properties,\n  });\n}\n","/**\n * External reference type for hybrid overlay patterns.\n *\n * Creates a Zod-compatible schema for referencing entities in external\n * data sources (e.g., existing application tables) from TypeGraph nodes.\n */\nimport { z } from \"zod\";\n\n// ============================================================\n// External Reference Metadata Symbol\n// ============================================================\n\n/**\n * Symbol key for storing external table name on the schema.\n * This allows the schema introspector to detect external reference types\n * and extract source information.\n */\nexport const EXTERNAL_REF_TABLE_KEY = \"_externalRefTable\" as const;\n\n// ============================================================\n// External Reference Value Type\n// ============================================================\n\n/**\n * The shape of an external reference value.\n * Contains the source table identifier and the ID of the referenced record.\n */\nexport type ExternalRefValue<T extends string = string> = Readonly<{\n  table: T;\n  id: string;\n}>;\n\n// ============================================================\n// External Reference Schema Type\n// ============================================================\n\n/**\n * A Zod schema for external references with attached table metadata.\n */\nexport type ExternalRefSchema<T extends string = string> = z.ZodType<\n  ExternalRefValue<T>\n> &\n  Readonly<{\n    [EXTERNAL_REF_TABLE_KEY]: T;\n  }>;\n\n// ============================================================\n// External Reference Factory\n// ============================================================\n\n/**\n * Creates a Zod schema for referencing external data sources.\n *\n * Use this when building a hybrid overlay where TypeGraph stores\n * graph relationships and metadata while your existing tables\n * remain the source of truth for entity data.\n *\n * @param table - The identifier for the external table/source (e.g., \"users\", \"documents\")\n * @returns A Zod schema that validates external reference objects\n *\n * @example\n * ```typescript\n * import { defineNode, externalRef, embedding } from \"@nicia-ai/typegraph\";\n *\n * // Reference documents from your existing application database\n * const Document = defineNode(\"Document\", {\n *   schema: z.object({\n *     source: externalRef(\"documents\"),\n *     embedding: embedding(1536).optional(),\n *     extractedTopics: z.array(z.string()).optional(),\n *   }),\n * });\n *\n * // Create a node referencing an external document\n * await store.nodes.Document.create({\n *   source: { table: \"documents\", id: \"doc_abc123\" },\n *   embedding: await generateEmbedding(docContent),\n * });\n *\n * // Query and hydrate with external data\n * const results = await store\n *   .query()\n *   .from(\"Document\", \"d\")\n *   .whereNode(\"d\", (d) => d.embedding.similarTo(query, 10))\n *   .select((ctx) => ctx.d.source)\n *   .execute();\n *\n * // Fetch full data from your app database\n * const externalIds = results.map((r) => r.id);\n * const fullDocs = await appDb.query.documents.findMany({\n *   where: inArray(documents.id, externalIds),\n * });\n * ```\n */\nexport function externalRef<T extends string>(table: T): ExternalRefSchema<T> {\n  if (typeof table !== \"string\" || table.length === 0) {\n    throw new Error(\n      `External reference table must be a non-empty string, got: ${typeof table === \"string\" ? `\"${table}\"` : typeof table}`,\n    );\n  }\n\n  const schema = z.object({\n    table: z.literal(table),\n    id: z.string().min(1, \"External reference ID must be non-empty\"),\n  });\n\n  // Attach table metadata for introspection\n  return Object.assign(schema, {\n    [EXTERNAL_REF_TABLE_KEY]: table,\n  });\n}\n\n// ============================================================\n// Type Guards\n// ============================================================\n\n/**\n * Checks if a value is an external reference schema.\n */\nexport function isExternalRefSchema(\n  value: unknown,\n): value is ExternalRefSchema {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    EXTERNAL_REF_TABLE_KEY in value &&\n    typeof (value as Record<string, unknown>)[EXTERNAL_REF_TABLE_KEY] ===\n      \"string\"\n  );\n}\n\n/**\n * Gets the table name from an external reference schema.\n * Returns undefined if the schema is not an external reference schema.\n */\nexport function getExternalRefTable(schema: z.ZodType): string | undefined {\n  if (isExternalRefSchema(schema)) {\n    return schema[EXTERNAL_REF_TABLE_KEY];\n  }\n  return undefined;\n}\n\n// ============================================================\n// Helper for creating reference values\n// ============================================================\n\n/**\n * Helper function to create a typed external reference value.\n * Useful when you want to avoid repeating the table name.\n *\n * @example\n * ```typescript\n * const docRef = createExternalRef(\"documents\");\n *\n * await store.nodes.Document.create({\n *   source: docRef(\"doc_123\"),\n *   embedding: [...],\n * });\n * ```\n */\nexport function createExternalRef<T extends string>(\n  table: T,\n): (id: string) => ExternalRefValue<T> {\n  return (id: string) => ({ table, id });\n}\n"]}

package/dist/{chunk-7PF2L3H6.cjs → chunk-2NA5DYLO.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkBNS75YNF_cjs = require('./chunk-BNS75YNF.cjs');
+var chunkNK5Q7UNE_cjs = require('./chunk-NK5Q7UNE.cjs');
 var zod = require('zod');
 
 // src/core/meta-edge.ts
@@ -14,7 +14,7 @@ function metaEdge(name, options = {}) {
     description: options.description
   };
   return Object.freeze({
-    [chunkBNS75YNF_cjs.META_EDGE_BRAND]: true,
+    [chunkNK5Q7UNE_cjs.META_EDGE_BRAND]: true,
     name,
     properties
   });
@@ -52,5 +52,5 @@ exports.externalRef = externalRef;
 exports.getExternalRefTable = getExternalRefTable;
 exports.isExternalRefSchema = isExternalRefSchema;
 exports.metaEdge = metaEdge;
-//# sourceMappingURL=chunk-7PF2L3H6.cjs.map
-//# sourceMappingURL=chunk-7PF2L3H6.cjs.map
+//# sourceMappingURL=chunk-2NA5DYLO.cjs.map
+//# sourceMappingURL=chunk-2NA5DYLO.cjs.map

package/dist/{chunk-7PF2L3H6.cjs.map → chunk-2NA5DYLO.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/meta-edge.ts","../src/core/external-ref.ts"],"names":["META_EDGE_BRAND","z"],"mappings":";;;;;;AA8CO,SAAS,QAAA,CACd,IAAA,EACA,OAAA,GAA2B,EAAC,EACf;AACb,EAAA,MAAM,UAAA,GAAiC;AAAA,IACrC,UAAA,EAAY,QAAQ,UAAA,IAAc,KAAA;AAAA,IAClC,SAAA,EAAW,QAAQ,SAAA,IAAa,KAAA;AAAA,IAChC,SAAA,EAAW,QAAQ,SAAA,IAAa,KAAA;AAAA,IAChC,SAAS,OAAA,CAAQ,OAAA;AAAA,IACjB,SAAA,EAAW,QAAQ,SAAA,IAAa,MAAA;AAAA,IAChC,aAAa,OAAA,CAAQ;AAAA,GACvB;AAEA,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,CAACA,iCAAe,GAAG,IAAA;AAAA,IACnB,IAAA;AAAA,IACA;AAAA,GACD,CAAA;AACH;AC/CO,IAAM,sBAAA,GAAyB,mBAAA;AA6E/B,SAAS,YAA8B,KAAA,EAAgC;AAC5E,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,WAAW,CAAA,EAAG;AACnD,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,0DAAA,EAA6D,OAAO,KAAA,KAAU,QAAA,GAAW,IAAI,KAAK,CAAA,CAAA,CAAA,GAAM,OAAO,KAAK,CAAA;AAAA,KACtH;AAAA,EACF;AAEA,EAAA,MAAM,MAAA,GAASC,MAAE,MAAA,CAAO;AAAA,IACtB,KAAA,EAAOA,KAAA,CAAE,OAAA,CAAQ,KAAK,CAAA;AAAA,IACtB,IAAIA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,GAAG,yCAAyC;AAAA,GAChE,CAAA;AAGD,EAAA,OAAO,MAAA,CAAO,OAAO,MAAA,EAAQ;AAAA,IAC3B,CAAC,sBAAsB,GAAG;AAAA,GAC3B,CAAA;AACH;AASO,SAAS,oBACd,KAAA,EAC4B;AAC5B,EAAA,OACE,OAAO,KAAA,KAAU,QAAA,IACjB,KAAA,KAAU,IAAA,IACV,0BAA0B,KAAA,IAC1B,OAAQ,KAAA,CAAkC,sBAAsB,CAAA,KAC9D,QAAA;AAEN;AAMO,SAAS,oBAAoB,MAAA,EAAuC;AACzE,EAAA,IAAI,mBAAA,CAAoB,MAAM,CAAA,EAAG;AAC/B,IAAA,OAAO,OAAO,sBAAsB,CAAA;AAAA,EACtC;AACA,EAAA,OAAO,MAAA;AACT;AAoBO,SAAS,kBACd,KAAA,EACqC;AACrC,EAAA,OAAO,CAAC,EAAA,MAAgB,EAAE,KAAA,EAAO,EAAA,EAAG,CAAA;AACtC","file":"chunk-7PF2L3H6.cjs","sourcesContent":["import {\n  type InferenceType,\n  META_EDGE_BRAND,\n  type MetaEdge,\n  type MetaEdgeProperties,\n} from \"../ontology/types\";\n\n// ============================================================\n// Meta-Edge Factory Options\n// ============================================================\n\n/**\n * Options for creating a meta-edge.\n */\nexport type MetaEdgeOptions = Readonly<{\n  /** Whether the relationship is transitive (A→B, B→C implies A→C) */\n  transitive?: boolean;\n  /** Whether the relationship is symmetric (A→B implies B→A) */\n  symmetric?: boolean;\n  /** Whether the relationship is reflexive (A→A is always true) */\n  reflexive?: boolean;\n  /** Name of the inverse meta-edge */\n  inverse?: string;\n  /** How this meta-edge affects queries and validation */\n  inference?: InferenceType;\n  /** Optional description */\n  description?: string;\n}>;\n\n// ============================================================\n// Meta-Edge Factory\n// ============================================================\n\n/**\n * Creates a custom meta-edge definition.\n *\n * @example\n * ```typescript\n * // Custom meta-edge for regulatory relationships\n * const regulatedBy = metaEdge(\"regulatedBy\", {\n *   description: \"Type X is regulated by authority type Y\",\n *   transitive: false,\n *   symmetric: false,\n * });\n * ```\n */\nexport function metaEdge<K extends string>(\n  name: K,\n  options: MetaEdgeOptions = {},\n): MetaEdge<K> {\n  const properties: MetaEdgeProperties = {\n    transitive: options.transitive ?? false,\n    symmetric: options.symmetric ?? false,\n    reflexive: options.reflexive ?? false,\n    inverse: options.inverse,\n    inference: options.inference ?? \"none\",\n    description: options.description,\n  };\n\n  return Object.freeze({\n    [META_EDGE_BRAND]: true as const,\n    name,\n    properties,\n  });\n}\n","/**\n * External reference type for hybrid overlay patterns.\n *\n * Creates a Zod-compatible schema for referencing entities in external\n * data sources (e.g., existing application tables) from TypeGraph nodes.\n */\nimport { z } from \"zod\";\n\n// ============================================================\n// External Reference Metadata Symbol\n// ============================================================\n\n/**\n * Symbol key for storing external table name on the schema.\n * This allows the schema introspector to detect external reference types\n * and extract source information.\n */\nexport const EXTERNAL_REF_TABLE_KEY = \"_externalRefTable\" as const;\n\n// ============================================================\n// External Reference Value Type\n// ============================================================\n\n/**\n * The shape of an external reference value.\n * Contains the source table identifier and the ID of the referenced record.\n */\nexport type ExternalRefValue<T extends string = string> = Readonly<{\n  table: T;\n  id: string;\n}>;\n\n// ============================================================\n// External Reference Schema Type\n// ============================================================\n\n/**\n * A Zod schema for external references with attached table metadata.\n */\nexport type ExternalRefSchema<T extends string = string> = z.ZodType<\n  ExternalRefValue<T>\n> &\n  Readonly<{\n    [EXTERNAL_REF_TABLE_KEY]: T;\n  }>;\n\n// ============================================================\n// External Reference Factory\n// ============================================================\n\n/**\n * Creates a Zod schema for referencing external data sources.\n *\n * Use this when building a hybrid overlay where TypeGraph stores\n * graph relationships and metadata while your existing tables\n * remain the source of truth for entity data.\n *\n * @param table - The identifier for the external table/source (e.g., \"users\", \"documents\")\n * @returns A Zod schema that validates external reference objects\n *\n * @example\n * ```typescript\n * import { defineNode, externalRef, embedding } from \"@nicia-ai/typegraph\";\n *\n * // Reference documents from your existing application database\n * const Document = defineNode(\"Document\", {\n *   schema: z.object({\n *     source: externalRef(\"documents\"),\n *     embedding: embedding(1536).optional(),\n *     extractedTopics: z.array(z.string()).optional(),\n *   }),\n * });\n *\n * // Create a node referencing an external document\n * await store.nodes.Document.create({\n *   source: { table: \"documents\", id: \"doc_abc123\" },\n *   embedding: await generateEmbedding(docContent),\n * });\n *\n * // Query and hydrate with external data\n * const results = await store\n *   .query()\n *   .from(\"Document\", \"d\")\n *   .whereNode(\"d\", (d) => d.embedding.similarTo(query, 10))\n *   .select((ctx) => ctx.d.source)\n *   .execute();\n *\n * // Fetch full data from your app database\n * const externalIds = results.map((r) => r.id);\n * const fullDocs = await appDb.query.documents.findMany({\n *   where: inArray(documents.id, externalIds),\n * });\n * ```\n */\nexport function externalRef<T extends string>(table: T): ExternalRefSchema<T> {\n  if (typeof table !== \"string\" || table.length === 0) {\n    throw new Error(\n      `External reference table must be a non-empty string, got: ${typeof table === \"string\" ? `\"${table}\"` : typeof table}`,\n    );\n  }\n\n  const schema = z.object({\n    table: z.literal(table),\n    id: z.string().min(1, \"External reference ID must be non-empty\"),\n  });\n\n  // Attach table metadata for introspection\n  return Object.assign(schema, {\n    [EXTERNAL_REF_TABLE_KEY]: table,\n  });\n}\n\n// ============================================================\n// Type Guards\n// ============================================================\n\n/**\n * Checks if a value is an external reference schema.\n */\nexport function isExternalRefSchema(\n  value: unknown,\n): value is ExternalRefSchema {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    EXTERNAL_REF_TABLE_KEY in value &&\n    typeof (value as Record<string, unknown>)[EXTERNAL_REF_TABLE_KEY] ===\n      \"string\"\n  );\n}\n\n/**\n * Gets the table name from an external reference schema.\n * Returns undefined if the schema is not an external reference schema.\n */\nexport function getExternalRefTable(schema: z.ZodType): string | undefined {\n  if (isExternalRefSchema(schema)) {\n    return schema[EXTERNAL_REF_TABLE_KEY];\n  }\n  return undefined;\n}\n\n// ============================================================\n// Helper for creating reference values\n// ============================================================\n\n/**\n * Helper function to create a typed external reference value.\n * Useful when you want to avoid repeating the table name.\n *\n * @example\n * ```typescript\n * const docRef = createExternalRef(\"documents\");\n *\n * await store.nodes.Document.create({\n *   source: docRef(\"doc_123\"),\n *   embedding: [...],\n * });\n * ```\n */\nexport function createExternalRef<T extends string>(\n  table: T,\n): (id: string) => ExternalRefValue<T> {\n  return (id: string) => ({ table, id });\n}\n"]}
+{"version":3,"sources":["../src/core/meta-edge.ts","../src/core/external-ref.ts"],"names":["META_EDGE_BRAND","z"],"mappings":";;;;;;AA8CO,SAAS,QAAA,CACd,IAAA,EACA,OAAA,GAA2B,EAAC,EACf;AACb,EAAA,MAAM,UAAA,GAAiC;AAAA,IACrC,UAAA,EAAY,QAAQ,UAAA,IAAc,KAAA;AAAA,IAClC,SAAA,EAAW,QAAQ,SAAA,IAAa,KAAA;AAAA,IAChC,SAAA,EAAW,QAAQ,SAAA,IAAa,KAAA;AAAA,IAChC,SAAS,OAAA,CAAQ,OAAA;AAAA,IACjB,SAAA,EAAW,QAAQ,SAAA,IAAa,MAAA;AAAA,IAChC,aAAa,OAAA,CAAQ;AAAA,GACvB;AAEA,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,CAACA,iCAAe,GAAG,IAAA;AAAA,IACnB,IAAA;AAAA,IACA;AAAA,GACD,CAAA;AACH;AC/CO,IAAM,sBAAA,GAAyB,mBAAA;AA6E/B,SAAS,YAA8B,KAAA,EAAgC;AAC5E,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,CAAM,WAAW,CAAA,EAAG;AACnD,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,0DAAA,EAA6D,OAAO,KAAA,KAAU,QAAA,GAAW,IAAI,KAAK,CAAA,CAAA,CAAA,GAAM,OAAO,KAAK,CAAA;AAAA,KACtH;AAAA,EACF;AAEA,EAAA,MAAM,MAAA,GAASC,MAAE,MAAA,CAAO;AAAA,IACtB,KAAA,EAAOA,KAAA,CAAE,OAAA,CAAQ,KAAK,CAAA;AAAA,IACtB,IAAIA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,GAAG,yCAAyC;AAAA,GAChE,CAAA;AAGD,EAAA,OAAO,MAAA,CAAO,OAAO,MAAA,EAAQ;AAAA,IAC3B,CAAC,sBAAsB,GAAG;AAAA,GAC3B,CAAA;AACH;AASO,SAAS,oBACd,KAAA,EAC4B;AAC5B,EAAA,OACE,OAAO,KAAA,KAAU,QAAA,IACjB,KAAA,KAAU,IAAA,IACV,0BAA0B,KAAA,IAC1B,OAAQ,KAAA,CAAkC,sBAAsB,CAAA,KAC9D,QAAA;AAEN;AAMO,SAAS,oBAAoB,MAAA,EAAuC;AACzE,EAAA,IAAI,mBAAA,CAAoB,MAAM,CAAA,EAAG;AAC/B,IAAA,OAAO,OAAO,sBAAsB,CAAA;AAAA,EACtC;AACA,EAAA,OAAO,MAAA;AACT;AAoBO,SAAS,kBACd,KAAA,EACqC;AACrC,EAAA,OAAO,CAAC,EAAA,MAAgB,EAAE,KAAA,EAAO,EAAA,EAAG,CAAA;AACtC","file":"chunk-2NA5DYLO.cjs","sourcesContent":["import {\n  type InferenceType,\n  META_EDGE_BRAND,\n  type MetaEdge,\n  type MetaEdgeProperties,\n} from \"../ontology/types\";\n\n// ============================================================\n// Meta-Edge Factory Options\n// ============================================================\n\n/**\n * Options for creating a meta-edge.\n */\nexport type MetaEdgeOptions = Readonly<{\n  /** Whether the relationship is transitive (A→B, B→C implies A→C) */\n  transitive?: boolean;\n  /** Whether the relationship is symmetric (A→B implies B→A) */\n  symmetric?: boolean;\n  /** Whether the relationship is reflexive (A→A is always true) */\n  reflexive?: boolean;\n  /** Name of the inverse meta-edge */\n  inverse?: string;\n  /** How this meta-edge affects queries and validation */\n  inference?: InferenceType;\n  /** Optional description */\n  description?: string;\n}>;\n\n// ============================================================\n// Meta-Edge Factory\n// ============================================================\n\n/**\n * Creates a custom meta-edge definition.\n *\n * @example\n * ```typescript\n * // Custom meta-edge for regulatory relationships\n * const regulatedBy = metaEdge(\"regulatedBy\", {\n *   description: \"Type X is regulated by authority type Y\",\n *   transitive: false,\n *   symmetric: false,\n * });\n * ```\n */\nexport function metaEdge<K extends string>(\n  name: K,\n  options: MetaEdgeOptions = {},\n): MetaEdge<K> {\n  const properties: MetaEdgeProperties = {\n    transitive: options.transitive ?? false,\n    symmetric: options.symmetric ?? false,\n    reflexive: options.reflexive ?? false,\n    inverse: options.inverse,\n    inference: options.inference ?? \"none\",\n    description: options.description,\n  };\n\n  return Object.freeze({\n    [META_EDGE_BRAND]: true as const,\n    name,\n    properties,\n  });\n}\n","/**\n * External reference type for hybrid overlay patterns.\n *\n * Creates a Zod-compatible schema for referencing entities in external\n * data sources (e.g., existing application tables) from TypeGraph nodes.\n */\nimport { z } from \"zod\";\n\n// ============================================================\n// External Reference Metadata Symbol\n// ============================================================\n\n/**\n * Symbol key for storing external table name on the schema.\n * This allows the schema introspector to detect external reference types\n * and extract source information.\n */\nexport const EXTERNAL_REF_TABLE_KEY = \"_externalRefTable\" as const;\n\n// ============================================================\n// External Reference Value Type\n// ============================================================\n\n/**\n * The shape of an external reference value.\n * Contains the source table identifier and the ID of the referenced record.\n */\nexport type ExternalRefValue<T extends string = string> = Readonly<{\n  table: T;\n  id: string;\n}>;\n\n// ============================================================\n// External Reference Schema Type\n// ============================================================\n\n/**\n * A Zod schema for external references with attached table metadata.\n */\nexport type ExternalRefSchema<T extends string = string> = z.ZodType<\n  ExternalRefValue<T>\n> &\n  Readonly<{\n    [EXTERNAL_REF_TABLE_KEY]: T;\n  }>;\n\n// ============================================================\n// External Reference Factory\n// ============================================================\n\n/**\n * Creates a Zod schema for referencing external data sources.\n *\n * Use this when building a hybrid overlay where TypeGraph stores\n * graph relationships and metadata while your existing tables\n * remain the source of truth for entity data.\n *\n * @param table - The identifier for the external table/source (e.g., \"users\", \"documents\")\n * @returns A Zod schema that validates external reference objects\n *\n * @example\n * ```typescript\n * import { defineNode, externalRef, embedding } from \"@nicia-ai/typegraph\";\n *\n * // Reference documents from your existing application database\n * const Document = defineNode(\"Document\", {\n *   schema: z.object({\n *     source: externalRef(\"documents\"),\n *     embedding: embedding(1536).optional(),\n *     extractedTopics: z.array(z.string()).optional(),\n *   }),\n * });\n *\n * // Create a node referencing an external document\n * await store.nodes.Document.create({\n *   source: { table: \"documents\", id: \"doc_abc123\" },\n *   embedding: await generateEmbedding(docContent),\n * });\n *\n * // Query and hydrate with external data\n * const results = await store\n *   .query()\n *   .from(\"Document\", \"d\")\n *   .whereNode(\"d\", (d) => d.embedding.similarTo(query, 10))\n *   .select((ctx) => ctx.d.source)\n *   .execute();\n *\n * // Fetch full data from your app database\n * const externalIds = results.map((r) => r.id);\n * const fullDocs = await appDb.query.documents.findMany({\n *   where: inArray(documents.id, externalIds),\n * });\n * ```\n */\nexport function externalRef<T extends string>(table: T): ExternalRefSchema<T> {\n  if (typeof table !== \"string\" || table.length === 0) {\n    throw new Error(\n      `External reference table must be a non-empty string, got: ${typeof table === \"string\" ? `\"${table}\"` : typeof table}`,\n    );\n  }\n\n  const schema = z.object({\n    table: z.literal(table),\n    id: z.string().min(1, \"External reference ID must be non-empty\"),\n  });\n\n  // Attach table metadata for introspection\n  return Object.assign(schema, {\n    [EXTERNAL_REF_TABLE_KEY]: table,\n  });\n}\n\n// ============================================================\n// Type Guards\n// ============================================================\n\n/**\n * Checks if a value is an external reference schema.\n */\nexport function isExternalRefSchema(\n  value: unknown,\n): value is ExternalRefSchema {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    EXTERNAL_REF_TABLE_KEY in value &&\n    typeof (value as Record<string, unknown>)[EXTERNAL_REF_TABLE_KEY] ===\n      \"string\"\n  );\n}\n\n/**\n * Gets the table name from an external reference schema.\n * Returns undefined if the schema is not an external reference schema.\n */\nexport function getExternalRefTable(schema: z.ZodType): string | undefined {\n  if (isExternalRefSchema(schema)) {\n    return schema[EXTERNAL_REF_TABLE_KEY];\n  }\n  return undefined;\n}\n\n// ============================================================\n// Helper for creating reference values\n// ============================================================\n\n/**\n * Helper function to create a typed external reference value.\n * Useful when you want to avoid repeating the table name.\n *\n * @example\n * ```typescript\n * const docRef = createExternalRef(\"documents\");\n *\n * await store.nodes.Document.create({\n *   source: docRef(\"doc_123\"),\n *   embedding: [...],\n * });\n * ```\n */\nexport function createExternalRef<T extends string>(\n  table: T,\n): (id: string) => ExternalRefValue<T> {\n  return (id: string) => ({ table, id });\n}\n"]}

package/dist/chunk-2Z2Z3ZD6.js

@@ -0,0 +1,58 @@
+import { buildValidatedKindRegistry } from './chunk-LGHCOKTT.js';
+import { hasOwnKey } from './chunk-DYATYRY4.js';
+
+// 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,
+    // Own-key reads, for the same reason {@link buildEdgeEndpointKinds} below
+    // uses a `Map`: `schema` is parsed out of a stored JSON document and the
+    // caller supplies the name, so a raw read hands back an `Object.prototype`
+    // member typed as a definition for any name no kind is registered under.
+    getNode: (name) => hasOwnKey(schema.nodes, name) ? schema.nodes[name] : void 0,
+    getNodeNames: () => nodeNames,
+    getEdge: (name) => hasOwnKey(schema.edges, name) ? schema.edges[name] : void 0,
+    getEdgeNames: () => edgeNames,
+    getMetaEdge: (name) => hasOwnKey(schema.ontology.metaEdges, name) ? schema.ontology.metaEdges[name] : void 0,
+    getMetaEdgeNames: () => metaEdgeNames,
+    getRelations: () => schema.ontology.relations,
+    getClosures: () => schema.ontology.closures,
+    getDefaults: () => schema.defaults,
+    getIdentity: () => schema.identity,
+    getRaw: () => schema,
+    buildRegistry: () => buildRegistryFromRelations(schema)
+  };
+}
+function buildRegistryFromRelations(schema) {
+  const nodeKinds = /* @__PURE__ */ new Map();
+  const edgeKinds = /* @__PURE__ */ new Map();
+  return buildValidatedKindRegistry({
+    nodeKinds,
+    edgeKinds,
+    ontology: schema.ontology.relations.map(
+      (relation) => ({
+        metaEdge: relation.metaEdge,
+        from: relation.from,
+        to: relation.to
+      })
+    ),
+    edgeEndpoints: buildEdgeEndpointKinds(schema.edges),
+    ...schema.identity === void 0 ? {} : { identity: schema.identity }
+  });
+}
+function buildEdgeEndpointKinds(edges) {
+  const result = /* @__PURE__ */ new Map();
+  for (const [kind, def] of Object.entries(edges)) {
+    result.set(kind, { from: def.fromKinds, to: def.toKinds });
+  }
+  return result;
+}
+
+export { deserializeSchema };
+//# sourceMappingURL=chunk-2Z2Z3ZD6.js.map
+//# sourceMappingURL=chunk-2Z2Z3ZD6.js.map

package/dist/chunk-2Z2Z3ZD6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema/deserializer.ts"],"names":[],"mappings":";;;;AAqFO,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;AAAA;AAAA;AAAA;AAAA,IAMpB,OAAA,EAAS,CAAC,IAAA,KACR,SAAA,CAAU,MAAA,CAAO,KAAA,EAAO,IAAI,CAAA,GAAI,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA,GAAI,MAAA;AAAA,IACvD,cAAc,MAAM,SAAA;AAAA,IAEpB,OAAA,EAAS,CAAC,IAAA,KACR,SAAA,CAAU,MAAA,CAAO,KAAA,EAAO,IAAI,CAAA,GAAI,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA,GAAI,MAAA;AAAA,IACvD,cAAc,MAAM,SAAA;AAAA,IAEpB,WAAA,EAAa,CAAC,IAAA,KACZ,SAAA,CAAU,MAAA,CAAO,QAAA,CAAS,SAAA,EAAW,IAAI,CAAA,GACvC,MAAA,CAAO,QAAA,CAAS,SAAA,CAAU,IAAI,CAAA,GAC9B,MAAA;AAAA,IACJ,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,WAAA,EAAa,MAAM,MAAA,CAAO,QAAA;AAAA,IAC1B,QAAQ,MAAM,MAAA;AAAA,IAEd,aAAA,EAAe,MAAM,0BAAA,CAA2B,MAAM;AAAA,GACxD;AACF;AAYA,SAAS,2BAA2B,MAAA,EAAwC;AAE1E,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAsB;AAC5C,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAyB;AAC/C,EAAA,OAAO,0BAAA,CAA2B;AAAA,IAChC,SAAA;AAAA,IACA,SAAA;AAAA,IACA,QAAA,EAAU,MAAA,CAAO,QAAA,CAAS,SAAA,CAAU,GAAA;AAAA,MAClC,CAAC,QAAA,MAAqC;AAAA,QACpC,UAAU,QAAA,CAAS,QAAA;AAAA,QACnB,MAAM,QAAA,CAAS,IAAA;AAAA,QACf,IAAI,QAAA,CAAS;AAAA,OACf;AAAA,KACF;AAAA,IACA,aAAA,EAAe,sBAAA,CAAuB,MAAA,CAAO,KAAK,CAAA;AAAA,IAClD,GAAI,OAAO,QAAA,KAAa,MAAA,GAAY,EAAC,GAAI,EAAE,QAAA,EAAU,MAAA,CAAO,QAAA;AAAS,GACtE,CAAA;AACH;AASA,SAAS,uBACP,KAAA,EACwC;AACxC,EAAA,MAAM,MAAA,uBAAa,GAAA,EAA+B;AAClD,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,GAAG,KAAK,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,EAAG;AAC/C,IAAA,MAAA,CAAO,GAAA,CAAI,MAAM,EAAE,IAAA,EAAM,IAAI,SAAA,EAAW,EAAA,EAAI,GAAA,CAAI,OAAA,EAAS,CAAA;AAAA,EAC3D;AACA,EAAA,OAAO,MAAA;AACT","file":"chunk-2Z2Z3ZD6.js","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 { type AnyEdgeType, type NodeType } from \"../core/types\";\nimport { type NamedOntologyRelation } from \"../ontology/validation\";\nimport { buildValidatedKindRegistry } from \"../registry/build-validated\";\nimport type { KindRegistry } from \"../registry/kind-registry\";\nimport { type EdgeEndpointKinds } from \"../registry/validate-implies\";\nimport { hasOwnKey } from \"../utils/object\";\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 durable TypeGraph Identity Profile configuration. */\n  getIdentity: () => SerializedSchema[\"identity\"];\n\n  /** Get the raw serialized schema */\n  getRaw: () => SerializedSchema;\n\n  /** Build a validated KindRegistry by recomputing closures from relations */\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    // Own-key reads, for the same reason {@link buildEdgeEndpointKinds} below\n    // uses a `Map`: `schema` is parsed out of a stored JSON document and the\n    // caller supplies the name, so a raw read hands back an `Object.prototype`\n    // member typed as a definition for any name no kind is registered under.\n    getNode: (name) =>\n      hasOwnKey(schema.nodes, name) ? schema.nodes[name] : undefined,\n    getNodeNames: () => nodeNames,\n\n    getEdge: (name) =>\n      hasOwnKey(schema.edges, name) ? schema.edges[name] : undefined,\n    getEdgeNames: () => edgeNames,\n\n    getMetaEdge: (name) =>\n      hasOwnKey(schema.ontology.metaEdges, name) ?\n        schema.ontology.metaEdges[name]\n      : undefined,\n    getMetaEdgeNames: () => metaEdgeNames,\n\n    getRelations: () => schema.ontology.relations,\n    getClosures: () => schema.ontology.closures,\n\n    getDefaults: () => schema.defaults,\n    getIdentity: () => schema.identity,\n    getRaw: () => schema,\n\n    buildRegistry: () => buildRegistryFromRelations(schema),\n  };\n}\n\n// ============================================================\n// Registry Building\n// ============================================================\n\n/**\n * Builds a KindRegistry from serialized relations.\n *\n * Persisted closures are a legacy inspection artifact. Relations are validated\n * and closures are recomputed so old schemas gain current hardening rules.\n */\nfunction buildRegistryFromRelations(schema: SerializedSchema): KindRegistry {\n  // Build empty node/edge kind maps (we don't have the actual Zod schemas)\n  const nodeKinds = new Map<string, NodeType>();\n  const edgeKinds = new Map<string, AnyEdgeType>();\n  return buildValidatedKindRegistry({\n    nodeKinds,\n    edgeKinds,\n    ontology: schema.ontology.relations.map(\n      (relation): NamedOntologyRelation => ({\n        metaEdge: relation.metaEdge,\n        from: relation.from,\n        to: relation.to,\n      }),\n    ),\n    edgeEndpoints: buildEdgeEndpointKinds(schema.edges),\n    ...(schema.identity === undefined ? {} : { identity: schema.identity }),\n  });\n}\n\n/**\n * Maps each edge kind's serialized definition to its domain/range kind\n * names, for `validateImpliesEndpointCompatibility`. A `Map` (rather than\n * the plain `schema.edges` object) so a lookup for an edge kind literally\n * named \"toString\" or another `Object.prototype` member can't resolve to\n * an inherited member instead of `undefined`.\n */\nfunction buildEdgeEndpointKinds(\n  edges: Record<string, SerializedEdgeDef>,\n): ReadonlyMap<string, EdgeEndpointKinds> {\n  const result = new Map<string, EdgeEndpointKinds>();\n  for (const [kind, def] of Object.entries(edges)) {\n    result.set(kind, { from: def.fromKinds, to: def.toKinds });\n  }\n  return result;\n}\n"]}

package/dist/{chunk-VVQM4CZD.cjs → chunk-3DHZCOT7.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkP7GTYOLB_cjs = require('./chunk-P7GTYOLB.cjs');
-var chunkNAAMUYMS_cjs = require('./chunk-NAAMUYMS.cjs');
-var chunkZ3WO6MND_cjs = require('./chunk-Z3WO6MND.cjs');
-var chunkEKFUG4G7_cjs = require('./chunk-EKFUG4G7.cjs');
-var chunkC4F7VJ5D_cjs = require('./chunk-C4F7VJ5D.cjs');
+var chunkYVWGEQJE_cjs = require('./chunk-YVWGEQJE.cjs');
+var chunkPNN7RHVR_cjs = require('./chunk-PNN7RHVR.cjs');
+var chunkRMQLSPA2_cjs = require('./chunk-RMQLSPA2.cjs');
+var chunkXBYVV3MP_cjs = require('./chunk-XBYVV3MP.cjs');
+var chunkNI72YOJB_cjs = require('./chunk-NI72YOJB.cjs');
 var module$1 = require('module');
 var Database = require('better-sqlite3');
 var betterSqlite3 = require('drizzle-orm/better-sqlite3');
@@ -25,7 +25,7 @@ var DEFAULT_LOCAL_SQLITE_PRAGMAS = {
 };
 
 // src/backend/sqlite/local.ts
-var nodeRequire = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-VVQM4CZD.cjs', document.baseURI).href)));
+var nodeRequire = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-3DHZCOT7.cjs', document.baseURI).href)));
 function getUnknownErrorMessage(error) {
   if (error instanceof Error) return error.message;
   return String(error);
@@ -47,7 +47,7 @@ function createDatabase(path) {
     const message = getUnknownErrorMessage(error);
     const mismatch = parseNodeModuleVersionMismatchMessage(message);
     if (!mismatch) throw error;
-    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+    throw new chunkNI72YOJB_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}.`,
@@ -86,37 +86,37 @@ function applyConnectionPragmas(sqlite, pragmas) {
     ...pragmas
   };
   if (!LOCAL_SQLITE_JOURNAL_MODES.includes(resolved.journalMode)) {
-    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+    throw new chunkNI72YOJB_cjs.ConfigurationError(
       `Invalid journalMode pragma: ${resolved.journalMode}. Expected one of: ${LOCAL_SQLITE_JOURNAL_MODES.join(", ")}.`,
       { journalMode: resolved.journalMode }
     );
   }
   if (!LOCAL_SQLITE_SYNCHRONOUS_MODES.includes(resolved.synchronous)) {
-    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+    throw new chunkNI72YOJB_cjs.ConfigurationError(
       `Invalid synchronous pragma: ${resolved.synchronous}. Expected one of: ${LOCAL_SQLITE_SYNCHRONOUS_MODES.join(", ")}.`,
       { synchronous: resolved.synchronous }
     );
   }
   if (!Number.isSafeInteger(resolved.busyTimeoutMs) || resolved.busyTimeoutMs < 0) {
-    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+    throw new chunkNI72YOJB_cjs.ConfigurationError(
       `Invalid busyTimeoutMs pragma: ${String(resolved.busyTimeoutMs)}. Expected a non-negative integer number of milliseconds.`,
       { busyTimeoutMs: resolved.busyTimeoutMs }
     );
   }
   if (resolved.cacheSizeKib !== void 0 && (!Number.isSafeInteger(resolved.cacheSizeKib) || resolved.cacheSizeKib >= 0)) {
-    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+    throw new chunkNI72YOJB_cjs.ConfigurationError(
       `Invalid cacheSizeKib pragma: ${String(resolved.cacheSizeKib)}. Expected a negative safe integer \u2014 SQLite's own cache_size pragma interprets a positive value as a page count, not KiB, so a caller who passes e.g. 131072 meaning "131072 KiB" silently gets 131072 pages (~512MiB at the default 4KiB page size) instead.`,
       { cacheSizeKib: resolved.cacheSizeKib }
     );
   }
   if (resolved.mmapSizeBytes !== void 0 && (!Number.isSafeInteger(resolved.mmapSizeBytes) || resolved.mmapSizeBytes < 0)) {
-    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+    throw new chunkNI72YOJB_cjs.ConfigurationError(
       `Invalid mmapSizeBytes pragma: ${String(resolved.mmapSizeBytes)}. Expected a non-negative safe integer number of bytes.`,
       { mmapSizeBytes: resolved.mmapSizeBytes }
     );
   }
   if (resolved.walAutocheckpointPages !== void 0 && (!Number.isSafeInteger(resolved.walAutocheckpointPages) || resolved.walAutocheckpointPages < 0 || resolved.walAutocheckpointPages > SQLITE_MAX_WAL_AUTOCHECKPOINT_PAGES)) {
-    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+    throw new chunkNI72YOJB_cjs.ConfigurationError(
       `Invalid walAutocheckpointPages pragma: ${String(resolved.walAutocheckpointPages)}. Expected an integer between 0 and ${SQLITE_MAX_WAL_AUTOCHECKPOINT_PAGES} WAL pages (0 disables automatic checkpointing entirely).`,
       { walAutocheckpointPages: resolved.walAutocheckpointPages }
     );
@@ -136,22 +136,22 @@ function applyConnectionPragmas(sqlite, pragmas) {
 }
 function createLocalSqliteBackend(options = {}) {
   const path = options.path ?? ":memory:";
-  const tables2 = options.tables ?? chunkZ3WO6MND_cjs.tables2;
+  const tables2 = options.tables ?? chunkRMQLSPA2_cjs.tables2;
   const sqlite = createDatabase(path);
   try {
     applyConnectionPragmas(sqlite, options.pragmas);
     const hasSqliteVec = tryLoadSqliteVec(sqlite);
     const db = betterSqlite3.drizzle(sqlite);
-    const ddlStatements = chunkZ3WO6MND_cjs.generateSqliteDDL(tables2);
+    const ddlStatements = chunkRMQLSPA2_cjs.generateSqliteDDL(tables2);
     for (const statement of ddlStatements) {
       sqlite.exec(statement);
     }
-    const backend = chunkP7GTYOLB_cjs.createSqliteBackend(db, {
+    const backend = chunkYVWGEQJE_cjs.createSqliteBackend(db, {
       executionProfile: {
         isSync: true
       },
       tables: tables2,
-      ...hasSqliteVec ? { vector: chunkNAAMUYMS_cjs.sqliteVecStrategy } : {},
+      ...hasSqliteVec ? { vector: chunkPNN7RHVR_cjs.sqliteVecStrategy } : {},
       capabilities: {
         ...options.capabilities,
         graphAnalytics: {
@@ -160,7 +160,7 @@ function createLocalSqliteBackend(options = {}) {
         }
       }
     });
-    const managedBackend = chunkEKFUG4G7_cjs.wrapWithManagedClose(backend, () => {
+    const managedBackend = chunkXBYVV3MP_cjs.wrapWithManagedClose(backend, () => {
       sqlite.close();
     });
     return { backend: managedBackend, db };
@@ -187,5 +187,5 @@ function tryLoadSqliteVec(sqlite) {
 
 exports.DEFAULT_LOCAL_SQLITE_PRAGMAS = DEFAULT_LOCAL_SQLITE_PRAGMAS;
 exports.createLocalSqliteBackend = createLocalSqliteBackend;
-//# sourceMappingURL=chunk-VVQM4CZD.cjs.map
-//# sourceMappingURL=chunk-VVQM4CZD.cjs.map
+//# sourceMappingURL=chunk-3DHZCOT7.cjs.map
+//# sourceMappingURL=chunk-3DHZCOT7.cjs.map