@nicia-ai/typegraph 0.34.0 → 0.35.0

package/dist/{chunk-V3QNTB7Z.js → chunk-JBTOYDMN.js}

@@ -1,9 +1,186 @@
-import { likeEscapeClause, LIKE_ESCAPE_CHARACTER } from './chunk-GZCNZ7QW.js';
-import { resolveFieldTypeInfoAtJsonPointer } from './chunk-XLUNB2TZ.js';
-import { UnsupportedPredicateError, CompilerInvariantError } from './chunk-TQOYM4LN.js';
-import { normalizeJsonPointer, joinJsonPointers, jsonPointer } from './chunk-K5P5OZXS.js';
+import { nowIso } from './chunk-I7ZUZKFD.js';
+import { likeEscapeClause, LIKE_ESCAPE_CHARACTER } from './chunk-OHMP6N2J.js';
+import { resolveFieldTypeInfoAtJsonPointer } from './chunk-SNXVDZAJ.js';
+import { ConfigurationError, UnsupportedPredicateError, CompilerInvariantError } from './chunk-MP2JQKSG.js';
+import { normalizeJsonPointer, joinJsonPointers, jsonPointer } from './chunk-G6Q5UM7U.js';
 import { sql } from 'drizzle-orm';
 
+// src/backend/types.ts
+function rowPropsToObject(props) {
+  return typeof props === "string" ? JSON.parse(props) : props;
+}
+function rowPropsToJsonText(props) {
+  return typeof props === "string" ? props : JSON.stringify(props);
+}
+function isLiveNodeRow(row) {
+  return row.deleted_at === void 0;
+}
+function isTombstonedNodeRow(row) {
+  return row.deleted_at !== void 0;
+}
+function createBackendOverlay(target, overlay) {
+  const boundTargetMethods = /* @__PURE__ */ new Map();
+  function hasOverlayProperty(property) {
+    return Object.hasOwn(overlay, property);
+  }
+  function targetValue(targetObject, property) {
+    const value = Reflect.get(targetObject, property, targetObject);
+    if (typeof value !== "function") return value;
+    const cached = boundTargetMethods.get(property);
+    if (cached !== void 0) return cached;
+    const method = value;
+    const bound = method.bind(targetObject);
+    boundTargetMethods.set(property, bound);
+    return bound;
+  }
+  return new Proxy(target, {
+    get(targetObject, property) {
+      if (hasOverlayProperty(property)) {
+        return Reflect.get(overlay, property, overlay);
+      }
+      return targetValue(targetObject, property);
+    },
+    has(targetObject, property) {
+      return hasOverlayProperty(property) || Reflect.has(targetObject, property);
+    },
+    ownKeys(targetObject) {
+      return [
+        .../* @__PURE__ */ new Set([
+          ...Reflect.ownKeys(targetObject),
+          ...Reflect.ownKeys(overlay)
+        ])
+      ];
+    },
+    getOwnPropertyDescriptor(targetObject, property) {
+      if (hasOverlayProperty(property)) {
+        const descriptor = Reflect.getOwnPropertyDescriptor(overlay, property);
+        if (descriptor === void 0) return;
+        return { ...descriptor, configurable: true };
+      }
+      return Reflect.getOwnPropertyDescriptor(targetObject, property);
+    },
+    set(targetObject, property, value) {
+      if (hasOverlayProperty(property)) {
+        return Reflect.set(overlay, property, value, overlay);
+      }
+      return Reflect.set(targetObject, property, value, targetObject);
+    },
+    defineProperty(targetObject, property, attributes) {
+      if (hasOverlayProperty(property)) {
+        return Reflect.defineProperty(overlay, property, attributes);
+      }
+      return Reflect.defineProperty(targetObject, property, attributes);
+    },
+    deleteProperty(targetObject, property) {
+      if (hasOverlayProperty(property)) {
+        return Reflect.deleteProperty(overlay, property);
+      }
+      return Reflect.deleteProperty(targetObject, property);
+    }
+  });
+}
+function wrapWithManagedClose(backend, teardown) {
+  let isClosed = false;
+  return createBackendOverlay(backend, {
+    async close() {
+      if (isClosed) return;
+      isClosed = true;
+      await backend.close();
+      await teardown();
+    }
+  });
+}
+async function runOptionallyInTransaction(backend, fn, fallback) {
+  if ("transaction" in backend && backend.capabilities.transactions) {
+    return backend.transaction((tx) => fn(tx));
+  }
+  return fn(fallback ?? backend);
+}
+var SQLITE_MAX_BIND_PARAMETERS = 999;
+var MODERN_SQLITE_MAX_BIND_PARAMETERS = 32766;
+var D1_MAX_BIND_PARAMETERS = 100;
+var POSTGRES_MAX_BIND_PARAMETERS = 65535;
+var SQLITE_CAPABILITIES = {
+  transactions: true,
+  // SQLite supports transactions
+  windowFunctions: true,
+  // SQLite has supported window functions since 3.25.0
+  returning: true,
+  // SQLite has supported RETURNING since 3.35.0
+  maxBindParameters: SQLITE_MAX_BIND_PARAMETERS
+};
+var POSTGRES_CAPABILITIES = {
+  transactions: true,
+  // PostgreSQL supports transactions
+  windowFunctions: true,
+  // PostgreSQL supports ROW_NUMBER() and related windows
+  returning: true,
+  // PostgreSQL has supported RETURNING since 8.2
+  maxBindParameters: POSTGRES_MAX_BIND_PARAMETERS
+};
+var pinnedReadInstant;
+function withPinnedReadInstant(emit) {
+  if (pinnedReadInstant !== void 0) return emit();
+  pinnedReadInstant = nowIso();
+  try {
+    return emit();
+  } finally {
+    pinnedReadInstant = void 0;
+  }
+}
+function currentReadInstant() {
+  return sql`${pinnedReadInstant ?? nowIso()}`;
+}
+var CURRENT_READ_INSTANT_PLACEHOLDER = "__typegraph_current_read_instant__";
+function currentReadInstantPlaceholder() {
+  return sql`${sql.placeholder(CURRENT_READ_INSTANT_PLACEHOLDER)}`;
+}
+function currentReadInstantFor(mode) {
+  return mode === "placeholder" ? currentReadInstantPlaceholder() : currentReadInstant();
+}
+function compileTemporalFilter(options) {
+  const { mode, asOf, tableAlias, currentTimestamp, recordedAsOf } = options;
+  const prefix = tableAlias ? sql.raw(`${tableAlias}.`) : sql.raw("");
+  const deletedAt = sql`${prefix}deleted_at`;
+  const validFrom = sql`${prefix}valid_from`;
+  const validTo = sql`${prefix}valid_to`;
+  const validFilter = (() => {
+    switch (mode) {
+      case "current": {
+        const now = recordedAsOf === void 0 ? currentTimestamp ?? currentReadInstant() : sql`${recordedAsOf}`;
+        return sql`${deletedAt} IS NULL AND (${validFrom} IS NULL OR ${validFrom} <= ${now}) AND (${validTo} IS NULL OR ${validTo} > ${now})`;
+      }
+      case "asOf": {
+        if (asOf === void 0) {
+          throw new Error(
+            `asOf timestamp is required for temporal mode "asOf"`
+          );
+        }
+        const timestamp = asOf;
+        return sql`${deletedAt} IS NULL AND (${validFrom} IS NULL OR ${validFrom} <= ${timestamp}) AND (${validTo} IS NULL OR ${validTo} > ${timestamp})`;
+      }
+      case "includeEnded": {
+        return sql`${deletedAt} IS NULL`;
+      }
+      case "includeTombstones": {
+        return sql.raw("1=1");
+      }
+    }
+  })();
+  if (recordedAsOf === void 0) return validFilter;
+  const recordedFrom = sql`${prefix}recorded_from`;
+  const recordedTo = sql`${prefix}recorded_to`;
+  return sql`(${validFilter}) AND ${recordedFrom} <= ${recordedAsOf} AND ${recordedAsOf} < ${recordedTo}`;
+}
+function extractTemporalOptions(ast, tableAlias) {
+  return {
+    mode: ast.temporalMode.mode,
+    asOf: ast.temporalMode.asOf,
+    recordedAsOf: ast.recordedAsOf,
+    tableAlias
+  };
+}
+
 // src/query/subquery-utils.ts
 function normalizeValueType(valueType) {
   if (valueType === void 0 || valueType === "unknown") {
@@ -80,6 +257,12 @@ function predicate(expr) {
   };
 }
 function param(name) {
+  if (name === CURRENT_READ_INSTANT_PLACEHOLDER) {
+    throw new ConfigurationError(
+      `Parameter name "${name}" is reserved for internal use`,
+      { parameterName: name }
+    );
+  }
   return { __type: "parameter", name };
 }
 function isParameterRef(value) {
@@ -312,7 +495,10 @@ function vectorSimilarity(field, queryEmbedding, limit, options) {
     // here would mis-rank l2/inner_product fields and bypass their ANN index.
     ...options?.metric !== void 0 && { metric: options.metric },
     limit,
-    ...options?.minScore !== void 0 && { minScore: options.minScore }
+    ...options?.minScore !== void 0 && { minScore: options.minScore },
+    ...options?.approximate !== void 0 && {
+      approximate: options.approximate
+    }
   };
   return predicate(expr);
 }
@@ -539,112 +725,6 @@ function assertCompatibleSubqueryValueTypes(field, subquery) {
     }
   );
 }
-
-// src/backend/types.ts
-function isLiveNodeRow(row) {
-  return row.deleted_at === void 0;
-}
-function isTombstonedNodeRow(row) {
-  return row.deleted_at !== void 0;
-}
-function createBackendOverlay(target, overlay) {
-  const boundTargetMethods = /* @__PURE__ */ new Map();
-  function hasOverlayProperty(property) {
-    return Object.hasOwn(overlay, property);
-  }
-  function targetValue(targetObject, property) {
-    const value = Reflect.get(targetObject, property, targetObject);
-    if (typeof value !== "function") return value;
-    const cached = boundTargetMethods.get(property);
-    if (cached !== void 0) return cached;
-    const method = value;
-    const bound = method.bind(targetObject);
-    boundTargetMethods.set(property, bound);
-    return bound;
-  }
-  return new Proxy(target, {
-    get(targetObject, property) {
-      if (hasOverlayProperty(property)) {
-        return Reflect.get(overlay, property, overlay);
-      }
-      return targetValue(targetObject, property);
-    },
-    has(targetObject, property) {
-      return hasOverlayProperty(property) || Reflect.has(targetObject, property);
-    },
-    ownKeys(targetObject) {
-      return [
-        .../* @__PURE__ */ new Set([
-          ...Reflect.ownKeys(targetObject),
-          ...Reflect.ownKeys(overlay)
-        ])
-      ];
-    },
-    getOwnPropertyDescriptor(targetObject, property) {
-      if (hasOverlayProperty(property)) {
-        const descriptor = Reflect.getOwnPropertyDescriptor(overlay, property);
-        if (descriptor === void 0) return;
-        return { ...descriptor, configurable: true };
-      }
-      return Reflect.getOwnPropertyDescriptor(targetObject, property);
-    },
-    set(targetObject, property, value) {
-      if (hasOverlayProperty(property)) {
-        return Reflect.set(overlay, property, value, overlay);
-      }
-      return Reflect.set(targetObject, property, value, targetObject);
-    },
-    defineProperty(targetObject, property, attributes) {
-      if (hasOverlayProperty(property)) {
-        return Reflect.defineProperty(overlay, property, attributes);
-      }
-      return Reflect.defineProperty(targetObject, property, attributes);
-    },
-    deleteProperty(targetObject, property) {
-      if (hasOverlayProperty(property)) {
-        return Reflect.deleteProperty(overlay, property);
-      }
-      return Reflect.deleteProperty(targetObject, property);
-    }
-  });
-}
-function wrapWithManagedClose(backend, teardown) {
-  let isClosed = false;
-  return createBackendOverlay(backend, {
-    async close() {
-      if (isClosed) return;
-      isClosed = true;
-      await backend.close();
-      await teardown();
-    }
-  });
-}
-async function runOptionallyInTransaction(backend, fn, fallback) {
-  if ("transaction" in backend && backend.capabilities.transactions) {
-    return backend.transaction((tx) => fn(tx));
-  }
-  return fn(fallback ?? backend);
-}
-var SQLITE_MAX_BIND_PARAMETERS = 999;
-var POSTGRES_MAX_BIND_PARAMETERS = 65535;
-var SQLITE_CAPABILITIES = {
-  transactions: true,
-  // SQLite supports transactions
-  windowFunctions: true,
-  // SQLite has supported window functions since 3.25.0
-  returning: true,
-  // SQLite has supported RETURNING since 3.35.0
-  maxBindParameters: SQLITE_MAX_BIND_PARAMETERS
-};
-var POSTGRES_CAPABILITIES = {
-  transactions: true,
-  // PostgreSQL supports transactions
-  windowFunctions: true,
-  // PostgreSQL supports ROW_NUMBER() and related windows
-  returning: true,
-  // PostgreSQL has supported RETURNING since 8.2
-  maxBindParameters: POSTGRES_MAX_BIND_PARAMETERS
-};
 var COMPARISON_OP_SQL = {
   eq: "=",
   neq: "!=",
@@ -1346,6 +1426,6 @@ function isPresent(value) {
   return value !== null && value !== void 0;
 }
 
-export { POSTGRES_CAPABILITIES, POSTGRES_MAX_BIND_PARAMETERS, SQLITE_CAPABILITIES, SQLITE_MAX_BIND_PARAMETERS, arrayField, baseField, buildFieldBuilderForTypeInfo, buildPredicateIndex, chunk, compileFieldValue, compileKindFilter, compilePredicateClauses, compilePredicateExpression, createBackendOverlay, createFulltextAccessor, dateField, exists, extractFulltextMatchPredicates, extractVectorSimilarityPredicates, fieldRef, getHybridTargetAlias, getNodeKindsForAlias, getPredicatesForAlias, groupBy, inSubquery, isLiveNodeRow, isParameterRef, isPresent, isTombstonedNodeRow, notExists, notInSubquery, numberField, objectField, param, runOptionallyInTransaction, sqlValueList, stringField, wrapWithManagedClose };
-//# sourceMappingURL=chunk-V3QNTB7Z.js.map
-//# sourceMappingURL=chunk-V3QNTB7Z.js.map
+export { CURRENT_READ_INSTANT_PLACEHOLDER, D1_MAX_BIND_PARAMETERS, MODERN_SQLITE_MAX_BIND_PARAMETERS, POSTGRES_CAPABILITIES, POSTGRES_MAX_BIND_PARAMETERS, SQLITE_CAPABILITIES, SQLITE_MAX_BIND_PARAMETERS, arrayField, baseField, buildFieldBuilderForTypeInfo, buildPredicateIndex, chunk, compileFieldValue, compileKindFilter, compilePredicateClauses, compilePredicateExpression, compileTemporalFilter, createBackendOverlay, createFulltextAccessor, currentReadInstant, currentReadInstantFor, dateField, exists, extractFulltextMatchPredicates, extractTemporalOptions, extractVectorSimilarityPredicates, fieldRef, getFieldPointer, getHybridTargetAlias, getNodeKindsForAlias, getPredicatesForAlias, groupBy, inSubquery, isLiveNodeRow, isParameterRef, isPresent, isTombstonedNodeRow, notExists, notInSubquery, numberField, objectField, param, rowPropsToJsonText, rowPropsToObject, runOptionallyInTransaction, sqlValueList, stringField, withPinnedReadInstant, wrapWithManagedClose };
+//# sourceMappingURL=chunk-JBTOYDMN.js.map
+//# sourceMappingURL=chunk-JBTOYDMN.js.map