@nicia-ai/typegraph 0.46.2 → 0.48.0

package/dist/ddl-D_oW-EVO.d.ts

@@ -0,0 +1,78 @@
+import { aK as FulltextStrategy } from './types-BqFZTQmV.js';
+import { P as PostgresTables } from './postgres-CcL4bAHS.js';
+import { S as SqliteTables } from './sqlite-D7Oz0SQh.js';
+
+/**
+ * Declare the connection this backend serializes on, when TypeGraph cannot
+ * detect it (Bun `SQL`, `expo-sqlite`, `op-sqlite`, `sqlite-proxy`, `pg-proxy`,
+ * a postgres-js pool capped through a string the driver does not coerce — the
+ * KNOWN GAPS in this module's inventory). Two wrappers that pass the same
+ * object are treated as one serialized resource, exactly as two wrappers over a
+ * detected client are.
+ *
+ * - `"detect"` (the default, and the same behavior as omitting the option):
+ *   whatever the factory's driver predicates find, and nothing else.
+ * - `"shared"`: the given object IS the serialized resource. Refused with a
+ *   {@link ConfigurationError} when the factory detected a DIFFERENT resource —
+ *   silently overriding would let two wrappers over one handle be given two
+ *   different sentinels and quietly de-serialize a pair that really does share.
+ * - `"independent"`: statements can run on independent connections. The
+ *   documented escape hatch for a mis-detection, so a user surprised by a
+ *   refusal is never stuck.
+ *
+ * SCOPE — read this before using `"independent"`: this option controls the
+ * SHARED-RESOURCE arm of {@link snapshotExportContention} only. It cannot lift
+ * the object-identity arm, under which ONE SQLite backend object exporting into
+ * ITSELF is refused with `same-sqlite-backend`. That arm is a driver fact (one
+ * handle, one open snapshot transaction), not a claim about connection
+ * topology, so no declaration can make it false.
+ *
+ * That surviving arm is SQLITE-ONLY, deliberately: it is gated on
+ * `dialect === "sqlite"`, so on Postgres a backend declared `"independent"`
+ * exporting into ITSELF is not refused either — a Postgres client that hands
+ * out independent connections is exactly what the declaration claims, and the
+ * snapshot and the writes it contends with land on different ones.
+ */
+type SerializedResourceDeclaration = Readonly<{
+    mode: "detect";
+}> | Readonly<{
+    mode: "shared";
+    resource: object;
+}> | Readonly<{
+    mode: "independent";
+}>;
+
+/**
+ * Generates all DDL statements for the given SQLite tables.
+ *
+ * Iterates the unified contribution set (#129) — base tables first,
+ * then strategy-owned tables. Per-contribution ordering is
+ * table-then-its-own-indexes; safe because TypeGraph's tables carry no
+ * cross-table foreign keys.
+ */
+declare function generateSqliteDDL(tables?: SqliteTables, fulltextStrategy?: FulltextStrategy): string[];
+/**
+ * Generates a single SQL string for SQLite migrations.
+ * Convenience function that joins all DDL statements.
+ */
+declare function generateSqliteMigrationSQL(tables?: SqliteTables, fulltextStrategy?: FulltextStrategy): string;
+/**
+ * Generates all DDL statements for the given PostgreSQL tables.
+ *
+ * Iterates the unified contribution set (#129) — base tables first,
+ * then strategy-owned tables. Per-contribution ordering is
+ * table-then-its-own-indexes; safe because TypeGraph's tables carry no
+ * cross-table foreign keys.
+ */
+declare function generatePostgresDDL(tables?: PostgresTables, fulltextStrategy?: FulltextStrategy): string[];
+/**
+ * Generates a single SQL string for PostgreSQL migrations.
+ * Convenience function that joins all DDL statements.
+ *
+ * Includes CREATE EXTENSION for pgvector since the per-`(kind, field)`
+ * embedding tables `pgvectorStrategy` materializes at runtime use the
+ * native VECTOR type.
+ */
+declare function generatePostgresMigrationSQL(tables?: PostgresTables, fulltextStrategy?: FulltextStrategy): string;
+
+export { type SerializedResourceDeclaration as S, generatePostgresMigrationSQL as a, generateSqliteDDL as b, generateSqliteMigrationSQL as c, generatePostgresDDL as g };

package/dist/graph-extension/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunk6LAXM4J2_cjs = require('../chunk-6LAXM4J2.cjs');
-var chunk6BD6ZBKT_cjs = require('../chunk-6BD6ZBKT.cjs');
+var chunkMKJ4KXL5_cjs = require('../chunk-MKJ4KXL5.cjs');
+var chunkGYEG3ZLZ_cjs = require('../chunk-GYEG3ZLZ.cjs');
 require('../chunk-XUO3KQFO.cjs');
-require('../chunk-D6GCNNMK.cjs');
-require('../chunk-KCH7WQA5.cjs');
+require('../chunk-6NGW27EO.cjs');
+require('../chunk-MRDBBHIZ.cjs');
 require('../chunk-A7J2YDDI.cjs');
 require('../chunk-N66HCGCY.cjs');
 
@@ -12,67 +12,67 @@ require('../chunk-N66HCGCY.cjs');
 
 Object.defineProperty(exports, "defineGraphExtension", {
   enumerable: true,
-  get: function () { return chunk6LAXM4J2_cjs.defineGraphExtension; }
+  get: function () { return chunkMKJ4KXL5_cjs.defineGraphExtension; }
 });
 Object.defineProperty(exports, "CURRENT_GRAPH_EXTENSION_VERSION", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.CURRENT_GRAPH_EXTENSION_VERSION; }
+  get: function () { return chunkGYEG3ZLZ_cjs.CURRENT_GRAPH_EXTENSION_VERSION; }
 });
 Object.defineProperty(exports, "GRAPH_EXTENSION_ISSUE_CODES", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.GRAPH_EXTENSION_ISSUE_CODES; }
+  get: function () { return chunkGYEG3ZLZ_cjs.GRAPH_EXTENSION_ISSUE_CODES; }
 });
 Object.defineProperty(exports, "GRAPH_EXTENSION_TOP_LEVEL_KEYS", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.GRAPH_EXTENSION_TOP_LEVEL_KEYS; }
+  get: function () { return chunkGYEG3ZLZ_cjs.GRAPH_EXTENSION_TOP_LEVEL_KEYS; }
 });
 Object.defineProperty(exports, "GraphExtensionError", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.GraphExtensionError; }
+  get: function () { return chunkGYEG3ZLZ_cjs.GraphExtensionError; }
 });
 Object.defineProperty(exports, "GraphExtensionUnresolvedEndpointError", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.GraphExtensionUnresolvedEndpointError; }
+  get: function () { return chunkGYEG3ZLZ_cjs.GraphExtensionUnresolvedEndpointError; }
 });
 Object.defineProperty(exports, "GraphExtensionUnresolvedOntologyEndpointError", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.GraphExtensionUnresolvedOntologyEndpointError; }
+  get: function () { return chunkGYEG3ZLZ_cjs.GraphExtensionUnresolvedOntologyEndpointError; }
 });
 Object.defineProperty(exports, "GraphExtensionValidationError", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.GraphExtensionValidationError; }
+  get: function () { return chunkGYEG3ZLZ_cjs.GraphExtensionValidationError; }
 });
 Object.defineProperty(exports, "GraphExtensionVersionUnsupportedError", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.GraphExtensionVersionUnsupportedError; }
+  get: function () { return chunkGYEG3ZLZ_cjs.GraphExtensionVersionUnsupportedError; }
 });
 Object.defineProperty(exports, "INCOMPATIBLE_CHANGE_TYPES", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.INCOMPATIBLE_CHANGE_TYPES; }
+  get: function () { return chunkGYEG3ZLZ_cjs.INCOMPATIBLE_CHANGE_TYPES; }
 });
 Object.defineProperty(exports, "IncompatibleChangeError", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.IncompatibleChangeError; }
+  get: function () { return chunkGYEG3ZLZ_cjs.IncompatibleChangeError; }
 });
 Object.defineProperty(exports, "KindCollisionError", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.KindCollisionError; }
+  get: function () { return chunkGYEG3ZLZ_cjs.KindCollisionError; }
 });
 Object.defineProperty(exports, "KindHasReferentsError", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.KindHasReferentsError; }
+  get: function () { return chunkGYEG3ZLZ_cjs.KindHasReferentsError; }
 });
 Object.defineProperty(exports, "LEGACY_GRAPH_EXTENSION_VERSION", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.LEGACY_GRAPH_EXTENSION_VERSION; }
+  get: function () { return chunkGYEG3ZLZ_cjs.LEGACY_GRAPH_EXTENSION_VERSION; }
 });
 Object.defineProperty(exports, "RemoveCompileTimeKindError", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.RemoveCompileTimeKindError; }
+  get: function () { return chunkGYEG3ZLZ_cjs.RemoveCompileTimeKindError; }
 });
 Object.defineProperty(exports, "validateGraphExtension", {
   enumerable: true,
-  get: function () { return chunk6BD6ZBKT_cjs.validateGraphExtension; }
+  get: function () { return chunkGYEG3ZLZ_cjs.validateGraphExtension; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/graph-extension/index.d.cts

@@ -1,9 +1,9 @@
-import { b4 as GraphExtension, K as KindEntity } from '../types-Du78EvpN.cjs';
-export { aq as CURRENT_GRAPH_EXTENSION_VERSION, de as ExtensionArrayItemType, df as ExtensionArrayProperty, dg as ExtensionBooleanProperty, a9 as ExtensionEdgeDef, dh as ExtensionEdgeIndex, di as ExtensionEmbeddingModifier, dj as ExtensionEnumProperty, ab as ExtensionIndex, dk as ExtensionIndexWhere, a8 as ExtensionNodeDef, dl as ExtensionNodeIndex, dm as ExtensionNumberProperty, dn as ExtensionObjectFieldProperty, dp as ExtensionObjectProperty, aa as ExtensionOntologyRelation, dr as ExtensionPropertyType, ds as ExtensionSearchableModifier, dt as ExtensionStringProperty, du as ExtensionUniqueConstraint, dv as ExtensionUniqueWhere, et as GRAPH_EXTENSION_TOP_LEVEL_KEYS, eu as GraphExtensionTopLevelKey, a7 as GraphExtensionVersion, bf as LEGACY_GRAPH_EXTENSION_VERSION } from '../types-Du78EvpN.cjs';
-import { T as TypeGraphError, x as ErrorCategory } from '../index-DrRS51Ld.cjs';
+import { aP as GraphExtension, bj as KindEntity } from '../types-BqFZTQmV.cjs';
+export { du as CURRENT_GRAPH_EXTENSION_VERSION, ab as ExtensionArrayItemType, ac as ExtensionArrayProperty, ad as ExtensionBooleanProperty, ae as ExtensionEdgeDef, af as ExtensionEdgeIndex, ag as ExtensionEmbeddingModifier, ah as ExtensionEnumProperty, ai as ExtensionIndex, aj as ExtensionIndexWhere, ak as ExtensionNodeDef, al as ExtensionNodeIndex, am as ExtensionNumberProperty, an as ExtensionObjectFieldProperty, ao as ExtensionObjectProperty, ap as ExtensionOntologyRelation, ar as ExtensionPropertyType, as as ExtensionSearchableModifier, at as ExtensionStringProperty, au as ExtensionUniqueConstraint, av as ExtensionUniqueWhere, eu as GRAPH_EXTENSION_TOP_LEVEL_KEYS, ev as GraphExtensionTopLevelKey, aQ as GraphExtensionVersion, dL as LEGACY_GRAPH_EXTENSION_VERSION } from '../types-BqFZTQmV.cjs';
+import { aj as TypeGraphError, w as ErrorCategory } from '../index-COs_z6nV.cjs';
 import { R as Result } from '../result-DWo6mUVz.cjs';
 import 'zod';
-import '../materialize-indexes-BXz77YqO.cjs';
+import '../materialize-indexes-DTtAnvfY.cjs';
 
 /**
  * Validates and freezes a graph-extension document.

package/dist/graph-extension/index.d.ts

@@ -1,9 +1,9 @@
-import { b4 as GraphExtension, K as KindEntity } from '../types-Du78EvpN.js';
-export { aq as CURRENT_GRAPH_EXTENSION_VERSION, de as ExtensionArrayItemType, df as ExtensionArrayProperty, dg as ExtensionBooleanProperty, a9 as ExtensionEdgeDef, dh as ExtensionEdgeIndex, di as ExtensionEmbeddingModifier, dj as ExtensionEnumProperty, ab as ExtensionIndex, dk as ExtensionIndexWhere, a8 as ExtensionNodeDef, dl as ExtensionNodeIndex, dm as ExtensionNumberProperty, dn as ExtensionObjectFieldProperty, dp as ExtensionObjectProperty, aa as ExtensionOntologyRelation, dr as ExtensionPropertyType, ds as ExtensionSearchableModifier, dt as ExtensionStringProperty, du as ExtensionUniqueConstraint, dv as ExtensionUniqueWhere, et as GRAPH_EXTENSION_TOP_LEVEL_KEYS, eu as GraphExtensionTopLevelKey, a7 as GraphExtensionVersion, bf as LEGACY_GRAPH_EXTENSION_VERSION } from '../types-Du78EvpN.js';
-import { T as TypeGraphError, x as ErrorCategory } from '../index-Deyu8IXL.js';
+import { aP as GraphExtension, bj as KindEntity } from '../types-BqFZTQmV.js';
+export { du as CURRENT_GRAPH_EXTENSION_VERSION, ab as ExtensionArrayItemType, ac as ExtensionArrayProperty, ad as ExtensionBooleanProperty, ae as ExtensionEdgeDef, af as ExtensionEdgeIndex, ag as ExtensionEmbeddingModifier, ah as ExtensionEnumProperty, ai as ExtensionIndex, aj as ExtensionIndexWhere, ak as ExtensionNodeDef, al as ExtensionNodeIndex, am as ExtensionNumberProperty, an as ExtensionObjectFieldProperty, ao as ExtensionObjectProperty, ap as ExtensionOntologyRelation, ar as ExtensionPropertyType, as as ExtensionSearchableModifier, at as ExtensionStringProperty, au as ExtensionUniqueConstraint, av as ExtensionUniqueWhere, eu as GRAPH_EXTENSION_TOP_LEVEL_KEYS, ev as GraphExtensionTopLevelKey, aQ as GraphExtensionVersion, dL as LEGACY_GRAPH_EXTENSION_VERSION } from '../types-BqFZTQmV.js';
+import { aj as TypeGraphError, w as ErrorCategory } from '../index-D7d1u2gr.js';
 import { R as Result } from '../result-DWo6mUVz.js';
 import 'zod';
-import '../materialize-indexes-CpXoggWU.js';
+import '../materialize-indexes-DJ3ykH59.js';
 
 /**
  * Validates and freezes a graph-extension document.

package/dist/graph-extension/index.js

@@ -1,8 +1,8 @@
-export { defineGraphExtension } from '../chunk-FCIZNUW5.js';
-export { CURRENT_GRAPH_EXTENSION_VERSION, GRAPH_EXTENSION_ISSUE_CODES, GRAPH_EXTENSION_TOP_LEVEL_KEYS, GraphExtensionError, GraphExtensionUnresolvedEndpointError, GraphExtensionUnresolvedOntologyEndpointError, GraphExtensionValidationError, GraphExtensionVersionUnsupportedError, INCOMPATIBLE_CHANGE_TYPES, IncompatibleChangeError, KindCollisionError, KindHasReferentsError, LEGACY_GRAPH_EXTENSION_VERSION, RemoveCompileTimeKindError, validateGraphExtension } from '../chunk-SXWLLQ3D.js';
+export { defineGraphExtension } from '../chunk-CHAOFCHV.js';
+export { CURRENT_GRAPH_EXTENSION_VERSION, GRAPH_EXTENSION_ISSUE_CODES, GRAPH_EXTENSION_TOP_LEVEL_KEYS, GraphExtensionError, GraphExtensionUnresolvedEndpointError, GraphExtensionUnresolvedOntologyEndpointError, GraphExtensionValidationError, GraphExtensionVersionUnsupportedError, INCOMPATIBLE_CHANGE_TYPES, IncompatibleChangeError, KindCollisionError, KindHasReferentsError, LEGACY_GRAPH_EXTENSION_VERSION, RemoveCompileTimeKindError, validateGraphExtension } from '../chunk-D5R42W5D.js';
 import '../chunk-JXXDZTMN.js';
-import '../chunk-OZJCH7ZS.js';
-import '../chunk-62ZXBMSD.js';
+import '../chunk-XVWOYKIK.js';
+import '../chunk-ZLONH2UD.js';
 import '../chunk-FWJKWH6U.js';
 import '../chunk-DYATYRY4.js';
 //# sourceMappingURL=index.js.map