@nicia-ai/typegraph 0.24.1 → 0.25.0

package/dist/types-Qk2l3IkQ.d.ts

@@ -1,1254 +0,0 @@
-import { SQL } from 'drizzle-orm';
-import { z } from 'zod';
-
-/** Brand key for NodeType */
-declare const NODE_TYPE_BRAND: "__nodeType";
-/** Brand key for EdgeType */
-declare const EDGE_TYPE_BRAND: "__edgeType";
-/** Brand symbol for NodeId */
-declare const __nodeId: unique symbol;
-/** Brand symbol for EdgeId */
-declare const __edgeId: unique symbol;
-/**
- * A node type definition.
- *
- * Created via `defineNode()`. Represents a type of node in the graph
- * with an associated Zod schema for properties.
- */
-type NodeType<K extends string = string, S extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>> = Readonly<{
-    [NODE_TYPE_BRAND]: true;
-    kind: K;
-    schema: S;
-    description: string | undefined;
-}>;
-/**
- * Branded node ID type.
- *
- * Prevents mixing IDs from different node types at compile time.
- */
-type NodeId<N extends NodeType> = string & Readonly<{
-    [__nodeId]: N;
-}>;
-/**
- * Infer the props type from a NodeType.
- */
-type NodeProps<N extends NodeType> = z.infer<N["schema"]>;
-/**
- * An edge type definition.
- *
- * Created via `defineEdge()`. Represents a type of edge in the graph
- * with an optional Zod schema for properties.
- *
- * Optionally includes `from` and `to` arrays that define the allowed
- * source and target node types (domain and range constraints).
- */
-type EdgeType<K extends string = string, S extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>, From extends readonly NodeType[] | undefined = undefined, To extends readonly NodeType[] | undefined = undefined> = Readonly<{
-    [EDGE_TYPE_BRAND]: true;
-    kind: K;
-    schema: S;
-    description: string | undefined;
-    from: From;
-    to: To;
-}>;
-/**
- * Base edge type for use in constraints - accepts any from/to configuration.
- */
-type AnyEdgeType = EdgeType<string, z.ZodObject<z.ZodRawShape>, readonly NodeType[] | undefined, readonly NodeType[] | undefined>;
-/**
- * An edge type that has both from and to constraints defined.
- * Can be used directly in defineGraph without an EdgeRegistration wrapper.
- */
-type EdgeTypeWithEndpoints = EdgeType<string, z.ZodObject<z.ZodRawShape>, readonly NodeType[], readonly NodeType[]>;
-/**
- * Branded edge ID type.
- *
- * Prevents mixing IDs from different edge types at compile time.
- */
-type EdgeId<E extends AnyEdgeType = AnyEdgeType> = string & Readonly<{
-    [__edgeId]: E;
-}>;
-/**
- * Infer the props type from an EdgeType.
- */
-type EdgeProps<E extends AnyEdgeType> = z.infer<E["schema"]>;
-/**
- * Delete behaviors for nodes.
- */
-type DeleteBehavior = "restrict" | "cascade" | "disconnect";
-/**
- * Edge cardinality constraints.
- */
-type Cardinality = "many" | "one" | "unique" | "oneActive";
-/**
- * Endpoint existence modes for edge validation.
- */
-type EndpointExistence = "notDeleted" | "currentlyValid" | "ever";
-/**
- * Temporal query modes.
- */
-type TemporalMode = "current" | "asOf" | "includeEnded" | "includeTombstones";
-/**
- * Uniqueness constraint scope.
- */
-type UniquenessScope = "kind" | "kindWithSubClasses";
-/**
- * Collation for uniqueness constraints.
- */
-type Collation = "binary" | "caseInsensitive";
-/**
- * Uniqueness constraint definition.
- */
-type UniqueConstraint<S extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>> = Readonly<{
-    name: string;
-    fields: readonly (keyof z.infer<S> & string)[];
-    where?: (props: UniqueConstraintPredicateBuilder<S>) => UniqueConstraintPredicate;
-    scope: UniquenessScope;
-    collation: Collation;
-}>;
-/**
- * Predicate builder for uniqueness constraint where clause.
- * Uses -? to make all fields required in the builder, even if optional in the schema.
- */
-type UniqueConstraintPredicateBuilder<S extends z.ZodObject<z.ZodRawShape>> = Readonly<{
-    [K in keyof z.infer<S>]-?: UniqueConstraintField;
-}>;
-/**
- * Field operations for uniqueness constraint predicates.
- */
-type UniqueConstraintField = Readonly<{
-    isNull: () => UniqueConstraintPredicate;
-    isNotNull: () => UniqueConstraintPredicate;
-}>;
-/**
- * A uniqueness constraint predicate (internal representation).
- */
-type UniqueConstraintPredicate = Readonly<{
-    __type: "unique_predicate";
-    field: string;
-    op: "isNull" | "isNotNull";
-}>;
-/**
- * Node registration in a graph definition.
- */
-type NodeRegistration<N extends NodeType = NodeType> = Readonly<{
-    type: N;
-    unique?: readonly UniqueConstraint<N["schema"]>[];
-    onDelete?: DeleteBehavior;
-}>;
-/**
- * Edge registration in a graph definition.
- */
-type EdgeRegistration<E extends AnyEdgeType = AnyEdgeType, FromTypes extends NodeType = NodeType, ToTypes extends NodeType = NodeType> = Readonly<{
-    type: E;
-    from: readonly FromTypes[];
-    to: readonly ToTypes[];
-    cardinality?: Cardinality;
-    endpointExistence?: EndpointExistence;
-}>;
-/**
- * Default settings for a graph.
- */
-type GraphDefaults = Readonly<{
-    onNodeDelete?: DeleteBehavior;
-    temporalMode?: TemporalMode;
-}>;
-/**
- * Checks if a value is a NodeType.
- */
-declare function isNodeType(value: unknown): value is NodeType;
-/**
- * Checks if a value is an EdgeType.
- */
-declare function isEdgeType(value: unknown): value is AnyEdgeType;
-/**
- * Checks if a value is an EdgeType with both from and to constraints defined.
- * Such edges can be used directly in defineGraph without an EdgeRegistration wrapper.
- */
-declare function isEdgeTypeWithEndpoints(value: unknown): value is EdgeTypeWithEndpoints;
-
-/** Brand key for MetaEdge */
-declare const META_EDGE_BRAND: "__metaEdge";
-/**
- * How a meta-edge affects queries and validation.
- */
-type InferenceType = "subsumption" | "hierarchy" | "substitution" | "constraint" | "composition" | "association" | "none";
-/**
- * Properties of a meta-edge.
- */
-type MetaEdgeProperties = Readonly<{
-    transitive: boolean;
-    symmetric: boolean;
-    reflexive: boolean;
-    inverse: string | undefined;
-    inference: InferenceType;
-    description: string | undefined;
-}>;
-/**
- * A meta-edge definition.
- *
- * Meta-edges represent type-level relationships (between kinds),
- * not instance-level relationships (between nodes).
- */
-type MetaEdge<K extends string = string> = Readonly<{
-    [META_EDGE_BRAND]: true;
-    name: K;
-    properties: MetaEdgeProperties;
-}>;
-/**
- * A relation in the ontology (instance of meta-edge between types).
- *
- * @example
- * ```typescript
- * // Podcast subClassOf Media
- * subClassOf(Podcast, Media)
- *
- * // Person equivalentTo schema:Person
- * equivalentTo(Person, "https://schema.org/Person")
- * ```
- */
-type OntologyRelation = Readonly<{
-    metaEdge: MetaEdge;
-    from: NodeType | EdgeType | string;
-    to: NodeType | EdgeType | string;
-}>;
-/**
- * Checks if a value is a MetaEdge.
- */
-declare function isMetaEdge(value: unknown): value is MetaEdge;
-
-/**
- * SQL Schema Configuration for Query Compilation
- *
- * Provides table and column identifiers that the query compiler uses.
- * This allows the compiler to work with custom table names instead of
- * hard-coded defaults.
- */
-
-/**
- * Table names for TypeGraph SQL schema.
- */
-type SqlTableNames = Readonly<{
-    /** Nodes table name (default: "typegraph_nodes") */
-    nodes: string;
-    /** Edges table name (default: "typegraph_edges") */
-    edges: string;
-    /** Node embeddings table name (default: "typegraph_node_embeddings") */
-    embeddings: string;
-    /** Node fulltext table name (default: "typegraph_node_fulltext") */
-    fulltext: string;
-}>;
-/**
- * SQL schema configuration for query compilation.
- * Contains table identifiers and utility methods for generating SQL references.
- */
-type SqlSchema = Readonly<{
-    /** Table names */
-    tables: SqlTableNames;
-    /** Get a SQL reference to the nodes table */
-    nodesTable: SQL;
-    /** Get a SQL reference to the edges table */
-    edgesTable: SQL;
-    /** Get a SQL reference to the embeddings table */
-    embeddingsTable: SQL;
-    /** Get a SQL reference to the fulltext table */
-    fulltextTable: SQL;
-}>;
-/**
- * Creates a SqlSchema configuration from table names.
- *
- * Table names are validated to ensure they are valid SQL identifiers.
- * This prevents SQL injection and ensures compatibility across databases.
- *
- * @param names - Optional custom table names (defaults to standard names)
- * @returns SqlSchema configuration for query compilation
- * @throws Error if any table name is invalid
- *
- * @example
- * ```typescript
- * // Use default table names
- * const schema = createSqlSchema();
- *
- * // Use custom table names
- * const schema = createSqlSchema({
- *   nodes: "myapp_nodes",
- *   edges: "myapp_edges",
- *   embeddings: "myapp_embeddings",
- * });
- * ```
- */
-declare function createSqlSchema(names?: Partial<SqlTableNames>): SqlSchema;
-/**
- * Default SqlSchema using standard TypeGraph table names.
- */
-declare const DEFAULT_SQL_SCHEMA: SqlSchema;
-
-/**
- * Fulltext Strategy — pluggable DDL + SQL generation for a dialect's
- * fulltext stack. A strategy owns every SQL statement that touches its
- * backing table: DDL, upsert (single + batch), delete (single + batch),
- * MATCH condition, rank expression, and snippet expression.
- *
- * A dialect picks one as its default; `createPostgresBackend` /
- * `createSqliteBackend` accept an override for alternate Postgres stacks
- * (pg_trgm, ParadeDB/pg_search, pgroonga) to swap the entire fulltext
- * pipeline without forking TypeGraph.
- */
-
-/**
- * A pluggable fulltext implementation. Each strategy is expected to be
- * self-contained: given a table name, a query string, and a parse mode,
- * it emits every SQL statement the compiler and backend need — DDL,
- * reads, and writes. No out-of-band conventions across layers.
- */
-interface FulltextStrategy {
-    /** Human-readable identifier used in error messages and telemetry. */
-    readonly name: string;
-    /**
-     * Parse modes this strategy can translate. Callers validate against
-     * this list before emitting SQL; a mode outside the set means the
-     * strategy rejects the query at compile time.
-     */
-    readonly supportedModes: readonly FulltextQueryMode[];
-    /**
-     * Whether the strategy can emit a per-row highlighted snippet. When
-     * false, `snippetExpression` returns a literal `NULL` so callers can
-     * leave the `snippet` column in place without a branch.
-     */
-    readonly supportsSnippets: boolean;
-    /**
-     * Whether the strategy supports prefix queries (`foo*`). Used to
-     * populate `BackendCapabilities.fulltext.prefixQueries`. A strategy
-     * may support prefix queries via dedicated syntax without advertising
-     * "raw" mode (and vice-versa).
-     */
-    readonly supportsPrefix: boolean;
-    /**
-     * Whether a per-query `language` override is honored. Postgres' tsvector
-     * accepts any installed regconfig at query time; SQLite FTS5's tokenizer
-     * is fixed at table-create time, so the override is silently ignored.
-     * Callers may surface a warning when the user passes `language` to a
-     * strategy that doesn't honor it.
-     */
-    readonly supportsLanguageOverride: boolean;
-    /**
-     * Languages / tokenizer names understood by the strategy. Advisory — a
-     * runtime backend like Postgres may accept other installed regconfigs.
-     * Used to populate `BackendCapabilities.fulltext.languages`.
-     */
-    readonly languages: readonly string[];
-    /**
-     * Emits the WHERE-side MATCH expression.
-     *
-     * @example
-     * tsvector: `"typegraph_node_fulltext"."tsv" @@ websearch_to_tsquery('english', 'cats')`
-     * fts5:     `"typegraph_node_fulltext" MATCH '"cats"'`
-     */
-    matchCondition(tableName: string, query: string, mode: FulltextQueryMode, language?: string): SQL;
-    /**
-     * Emits the relevance expression. Higher values = more relevant. The
-     * compiler orders by this expression DESC, and both builder and
-     * backend-direct paths use the same form so their top-k results agree.
-     */
-    rankExpression(tableName: string, query: string, mode: FulltextQueryMode, language?: string): SQL;
-    /**
-     * Emits a per-row highlighted snippet expression, or `NULL` when
-     * `supportsSnippets` is false. Snippet markup is `<mark>…</mark>` in
-     * both shipped strategies so consumers can apply one stylesheet.
-     */
-    snippetExpression(tableName: string, query: string, mode: FulltextQueryMode, language?: string): SQL;
-    /**
-     * DDL statements to create the backing table and any supporting
-     * indexes. Idempotent (`CREATE ... IF NOT EXISTS`). Called once from
-     * `bootstrapTables()` on a fresh database.
-     */
-    generateDdl(tableName: string): readonly string[];
-    /**
-     * Emits the statements that upsert a single fulltext row. Returns one
-     * or more statements — some backends (SQLite FTS5) cannot emulate
-     * upsert in a single statement and need DELETE + INSERT.
-     */
-    buildUpsert(tableName: string, params: UpsertFulltextParams, timestamp: string): readonly SQL[];
-    /**
-     * Emits the statements that upsert many fulltext rows at once. Input
-     * rows are expected to be de-duplicated last-write-wins by the
-     * strategy if the underlying SQL statement cannot tolerate duplicate
-     * conflict keys. Returns `[]` when `params.rows` is empty.
-     */
-    buildBatchUpsert(tableName: string, params: UpsertFulltextBatchParams, timestamp: string): readonly SQL[];
-    /**
-     * Emits the statements that delete a single fulltext row. Normally a
-     * single PK-scoped DELETE, but strategies that maintain auxiliary
-     * indexes (delete-triggered external stores, ParadeDB-style secondary
-     * structures) may need more.
-     */
-    buildDelete(tableName: string, params: DeleteFulltextParams): readonly SQL[];
-    /**
-     * Emits the statements that delete many fulltext rows at once. Returns
-     * `[]` when `params.nodeIds` is empty.
-     */
-    buildBatchDelete(tableName: string, params: DeleteFulltextBatchParams): readonly SQL[];
-}
-declare const tsvectorStrategy: FulltextStrategy;
-declare const fts5Strategy: FulltextStrategy;
-
-/**
- * Types for serialized schema storage.
- *
- * These types represent the JSON-serializable format used for
- * homoiconic schema storage in the database.
- *
- * The Zod schema (serializedSchemaZod) is the single source of truth.
- * The TypeScript type (SerializedSchema) is inferred from it.
- */
-
-/**
- * JSON Schema type (subset used by Zod toJSONSchema).
- *
- * This is a simplified version - the actual JSON Schema has many more properties.
- */
-type JsonSchema = Readonly<{
-    $schema?: string;
-    type?: string | readonly string[];
-    properties?: Record<string, JsonSchema>;
-    required?: readonly string[];
-    items?: JsonSchema;
-    additionalProperties?: boolean | JsonSchema;
-    enum?: readonly unknown[];
-    const?: unknown;
-    anyOf?: readonly JsonSchema[];
-    oneOf?: readonly JsonSchema[];
-    allOf?: readonly JsonSchema[];
-    not?: JsonSchema;
-    description?: string;
-    default?: unknown;
-    minimum?: number;
-    maximum?: number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    format?: string;
-    [key: string]: unknown;
-}>;
-/**
- * Serialized representation of a meta-edge.
- */
-type SerializedMetaEdge = Readonly<{
-    name: string;
-    transitive: boolean;
-    symmetric: boolean;
-    reflexive: boolean;
-    inverse: string | undefined;
-    inference: InferenceType;
-    description: string | undefined;
-}>;
-/**
- * Serialized representation of an ontology relation.
- */
-type SerializedOntologyRelation = Readonly<{
-    metaEdge: string;
-    from: string;
-    to: string;
-}>;
-/**
- * Precomputed closures stored in the schema for fast runtime lookup.
- */
-type SerializedClosures = Readonly<{
-    subClassAncestors: Record<string, readonly string[]>;
-    subClassDescendants: Record<string, readonly string[]>;
-    broaderClosure: Record<string, readonly string[]>;
-    narrowerClosure: Record<string, readonly string[]>;
-    equivalenceSets: Record<string, readonly string[]>;
-    disjointPairs: readonly string[];
-    partOfClosure: Record<string, readonly string[]>;
-    hasPartClosure: Record<string, readonly string[]>;
-    iriToKind: Record<string, string>;
-    edgeInverses: Record<string, string>;
-    edgeImplicationsClosure: Record<string, readonly string[]>;
-    edgeImplyingClosure: Record<string, readonly string[]>;
-}>;
-/**
- * Complete serialized ontology section.
- */
-type SerializedOntology = Readonly<{
-    metaEdges: Record<string, SerializedMetaEdge>;
-    relations: readonly SerializedOntologyRelation[];
-    closures: SerializedClosures;
-}>;
-/**
- * Serialized representation of a uniqueness constraint.
- */
-type SerializedUniqueConstraint = Readonly<{
-    name: string;
-    fields: readonly string[];
-    where: string | undefined;
-    scope: UniquenessScope;
-    collation: Collation;
-}>;
-/**
- * Serialized representation of a node kind.
- */
-type SerializedNodeDef = Readonly<{
-    kind: string;
-    properties: JsonSchema;
-    uniqueConstraints: readonly SerializedUniqueConstraint[];
-    onDelete: DeleteBehavior;
-    description: string | undefined;
-}>;
-/**
- * Serialized representation of an edge kind.
- */
-type SerializedEdgeDef = Readonly<{
-    kind: string;
-    fromKinds: readonly string[];
-    toKinds: readonly string[];
-    properties: JsonSchema;
-    cardinality: Cardinality;
-    endpointExistence: EndpointExistence;
-    description: string | undefined;
-}>;
-/**
- * Complete serialized schema document.
- *
- * This is the format stored in the schema_doc column of
- * typegraph_schema_versions. The type is kept explicit rather than
- * inferred from the Zod schema so that downstream code sees the
- * precise literal union types (DeleteBehavior, TemporalMode, etc.)
- * instead of the broader `string` type that Zod's passthrough schema uses.
- */
-type SerializedSchema = Readonly<{
-    graphId: string;
-    version: number;
-    generatedAt: string;
-    nodes: Record<string, SerializedNodeDef>;
-    edges: Record<string, SerializedEdgeDef>;
-    ontology: SerializedOntology;
-    defaults: Readonly<{
-        onNodeDelete: DeleteBehavior;
-        temporalMode: TemporalMode;
-    }>;
-}>;
-/**
- * A schema hash for detecting changes.
- *
- * We hash the schema content (excluding version and generatedAt)
- * to detect if the schema has actually changed.
- */
-type SchemaHash = string;
-
-/**
- * SQL Dialect Abstraction Layer
- *
- * Provides a unified interface for dialect-specific SQL generation.
- * Implementing a new dialect (MySQL, SQL Server, etc.) requires
- * implementing this interface.
- */
-
-/**
- * Supported SQL dialects.
- */
-type SqlDialect = "sqlite" | "postgres";
-
-/**
- * Backend interface types for TypeGraph storage.
- *
- * The backend abstracts database operations, allowing different
- * SQL implementations (SQLite, PostgreSQL) behind a common interface.
- */
-
-/**
- * Supported vector similarity metrics.
- */
-type VectorMetric = "cosine" | "l2" | "inner_product";
-/**
- * Supported vector index types.
- */
-type VectorIndexType = "hnsw" | "ivfflat" | "none";
-/**
- * Vector search capabilities.
- */
-type VectorCapabilities = Readonly<{
-    /** Whether the backend supports vector operations */
-    supported: boolean;
-    /** Supported similarity metrics */
-    metrics: readonly VectorMetric[];
-    /** Supported index types */
-    indexTypes: readonly VectorIndexType[];
-    /** Maximum dimensions supported */
-    maxDimensions: number;
-}>;
-/**
- * Query modes for fulltext search.
- *
- * - "websearch": Google-style syntax (quoted phrases, +required, -excluded).
- *    Postgres: `websearch_to_tsquery`. SQLite: translated to FTS5 MATCH.
- * - "phrase": treats the whole query as a phrase.
- *    Postgres: `phraseto_tsquery`. SQLite: FTS5 `"..."` phrase.
- * - "plain": splits on whitespace and ANDs terms.
- *    Postgres: `plainto_tsquery`. SQLite: default FTS5 AND.
- * - "raw": dialect-native syntax passed through unchanged.
- */
-type FulltextQueryMode = "websearch" | "phrase" | "plain" | "raw";
-/**
- * Fulltext search capabilities declared by a backend.
- */
-type FulltextCapabilities = Readonly<{
-    /** Whether the backend supports fulltext operations */
-    supported: boolean;
-    /**
-     * Language / tokenizer names understood by this backend.
-     * Postgres: installed regconfigs (english, simple, ...).
-     * SQLite FTS5: tokenizer names (unicode61, porter, trigram).
-     */
-    languages: readonly string[];
-    /** Whether phrase queries are supported. */
-    phraseQueries: boolean;
-    /** Whether prefix (`foo*`) queries are supported. */
-    prefixQueries: boolean;
-    /** Whether highlighting / snippets are supported. */
-    highlighting: boolean;
-}>;
-
-/**
- * Backend capabilities that vary by dialect.
- */
-type BackendCapabilities = Readonly<{
-    /** Whether the backend supports JSONB type (vs TEXT for JSON) */
-    jsonb: boolean;
-    /** Whether the backend supports partial indexes */
-    partialIndexes: boolean;
-    /** Whether the backend supports GIN indexes for JSON */
-    ginIndexes: boolean;
-    /** Whether the backend supports CTE (WITH) queries */
-    cte: boolean;
-    /** Whether the backend supports RETURNING clause */
-    returning: boolean;
-    /** Whether the backend supports atomic transactions (D1 does not) */
-    transactions: boolean;
-    /** Vector search capabilities (undefined if not configured) */
-    vector?: VectorCapabilities | undefined;
-    /** Fulltext search capabilities (undefined if not configured) */
-    fulltext?: FulltextCapabilities | undefined;
-}>;
-/**
- * A row from the typegraph_nodes table.
- */
-type NodeRow = Readonly<{
-    graph_id: string;
-    kind: string;
-    id: string;
-    props: string;
-    version: number;
-    valid_from: string | undefined;
-    valid_to: string | undefined;
-    created_at: string;
-    updated_at: string;
-    deleted_at: string | undefined;
-}>;
-/**
- * A row from the typegraph_edges table.
- */
-type EdgeRow = Readonly<{
-    graph_id: string;
-    id: string;
-    kind: string;
-    from_kind: string;
-    from_id: string;
-    to_kind: string;
-    to_id: string;
-    props: string;
-    valid_from: string | undefined;
-    valid_to: string | undefined;
-    created_at: string;
-    updated_at: string;
-    deleted_at: string | undefined;
-}>;
-/**
- * A row from the typegraph_node_uniques table.
- */
-type UniqueRow = Readonly<{
-    graph_id: string;
-    node_kind: string;
-    constraint_name: string;
-    key: string;
-    node_id: string;
-    concrete_kind: string;
-    deleted_at: string | undefined;
-}>;
-/**
- * A row from the typegraph_schema_versions table.
- */
-type SchemaVersionRow = Readonly<{
-    graph_id: string;
-    version: number;
-    schema_hash: string;
-    schema_doc: string;
-    created_at: string;
-    is_active: boolean;
-}>;
-/**
- * A row from the typegraph_node_embeddings table.
- */
-type EmbeddingRow = Readonly<{
-    graph_id: string;
-    node_kind: string;
-    node_id: string;
-    field_path: string;
-    embedding: readonly number[];
-    dimensions: number;
-    created_at: string;
-    updated_at: string;
-}>;
-/**
- * Parameters for inserting a node.
- */
-type InsertNodeParams = Readonly<{
-    graphId: string;
-    kind: string;
-    id: string;
-    props: Readonly<Record<string, unknown>>;
-    validFrom?: string;
-    validTo?: string;
-}>;
-/**
- * Parameters for updating a node.
- */
-type UpdateNodeParams = Readonly<{
-    graphId: string;
-    kind: string;
-    id: string;
-    props: Readonly<Record<string, unknown>>;
-    validTo?: string;
-    incrementVersion?: boolean;
-    /** If true, clears deleted_at (un-deletes the node). Used by upsert. */
-    clearDeleted?: boolean;
-}>;
-/**
- * Parameters for deleting a node (soft delete).
- */
-type DeleteNodeParams = Readonly<{
-    graphId: string;
-    kind: string;
-    id: string;
-}>;
-/**
- * Parameters for inserting an edge.
- */
-type InsertEdgeParams = Readonly<{
-    graphId: string;
-    id: string;
-    kind: string;
-    fromKind: string;
-    fromId: string;
-    toKind: string;
-    toId: string;
-    props: Readonly<Record<string, unknown>>;
-    validFrom?: string;
-    validTo?: string;
-}>;
-/**
- * Parameters for updating an edge.
- */
-type UpdateEdgeParams = Readonly<{
-    graphId: string;
-    id: string;
-    props: Readonly<Record<string, unknown>>;
-    validTo?: string;
-    clearDeleted?: boolean;
-}>;
-/**
- * Parameters for deleting an edge (soft delete).
- */
-type DeleteEdgeParams = Readonly<{
-    graphId: string;
-    id: string;
-}>;
-/**
- * Parameters for hard deleting a node (permanent removal).
- */
-type HardDeleteNodeParams = Readonly<{
-    graphId: string;
-    kind: string;
-    id: string;
-}>;
-/**
- * Parameters for hard deleting an edge (permanent removal).
- */
-type HardDeleteEdgeParams = Readonly<{
-    graphId: string;
-    id: string;
-}>;
-/**
- * Parameters for inserting or updating an embedding.
- */
-type UpsertEmbeddingParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    nodeId: string;
-    fieldPath: string;
-    embedding: readonly number[];
-    dimensions: number;
-}>;
-/**
- * Parameters for deleting an embedding.
- */
-type DeleteEmbeddingParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    nodeId: string;
-    fieldPath: string;
-}>;
-/**
- * Parameters for vector similarity search.
- */
-type VectorSearchParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    fieldPath: string;
-    queryEmbedding: readonly number[];
-    metric: VectorMetric;
-    limit: number;
-    minScore?: number;
-}>;
-/**
- * Result from a vector similarity search.
- */
-type VectorSearchResult = Readonly<{
-    nodeId: string;
-    /**
-     * Cosine metric returns similarity score (higher is better).
-     * L2 and inner_product return raw distance (lower is better).
-     */
-    score: number;
-}>;
-/**
- * Parameters for creating a vector index.
- */
-type CreateVectorIndexParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    fieldPath: string;
-    dimensions: number;
-    metric: VectorMetric;
-    indexType: VectorIndexType;
-    /** Index-specific parameters */
-    indexParams?: Readonly<{
-        /** HNSW: max connections per layer */
-        m?: number;
-        /** HNSW: construction search depth */
-        efConstruction?: number;
-        /** IVFFlat: number of lists */
-        lists?: number;
-    }>;
-}>;
-/**
- * Parameters for dropping a vector index.
- */
-type DropVectorIndexParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    fieldPath: string;
-}>;
-/**
- * Parameters for inserting or updating a fulltext entry.
- *
- * One row per node. Callers concatenate the searchable fields into
- * `content` so a single MATCH query can find terms spread across fields.
- */
-type UpsertFulltextParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    nodeId: string;
-    content: string;
-    language: string;
-}>;
-/**
- * Parameters for deleting a single fulltext entry.
- */
-type DeleteFulltextParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    nodeId: string;
-}>;
-/**
- * A single row in a fulltext batch upsert.
- */
-type FulltextBatchRow = Readonly<{
-    nodeId: string;
-    content: string;
-    language: string;
-}>;
-/**
- * Parameters for a batched fulltext upsert.
- *
- * Homogeneous: one graph, one node kind, many nodes. Duplicate `nodeId`
- * values within a single batch are deduplicated last-write-wins by the
- * builders before SQL generation — Postgres `ON CONFLICT` errors on
- * repeated conflict keys in one statement, and SQLite `DELETE + INSERT`
- * would create duplicate virtual-table rows otherwise.
- */
-type UpsertFulltextBatchParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    rows: readonly FulltextBatchRow[];
-}>;
-/**
- * Parameters for a batched fulltext delete.
- */
-type DeleteFulltextBatchParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    nodeIds: readonly string[];
-}>;
-/**
- * Parameters for fulltext search.
- */
-type FulltextSearchParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    /** The user-supplied query string. */
-    query: string;
-    /** How to parse `query`. Default: "websearch". */
-    mode?: FulltextQueryMode;
-    /**
-     * Language override. Default: per-row language (as stored at insert time).
-     * Postgres: passed as the regconfig to `to_tsquery` / `websearch_to_tsquery`.
-     * SQLite: informational only (FTS5 tokenizer is fixed at table-create time).
-     */
-    language?: string;
-    /** Max rows to return. */
-    limit: number;
-    /** Minimum rank to include (backend-dependent units). */
-    minScore?: number;
-    /** Whether to return a highlighted snippet per match. */
-    includeSnippets?: boolean;
-}>;
-/**
- * Result from a fulltext search.
- *
- * Score semantics differ by backend; prefer `rank` (1-based) when fusing
- * with another source via RRF.
- */
-type FulltextSearchResult = Readonly<{
-    nodeId: string;
-    /**
-     * Backend-native relevance score.
-     * Postgres: `ts_rank_cd` (higher is better).
-     * SQLite FTS5: negated `bm25()` (higher is better; FTS5 returns lower-is-better).
-     */
-    score: number;
-    /** 1-based rank within the result set, suitable for RRF. */
-    rank: number;
-    /** Highlighted snippet of the content (if `includeSnippets` was set). */
-    snippet?: string;
-}>;
-/**
- * Parameters for creating a fulltext index.
- *
- * The canonical index (Postgres GIN on `tsv`, SQLite FTS5 virtual table)
- * is created when the fulltext table itself is created. This is reserved
- * for advanced per-kind specializations.
- */
-type CreateFulltextIndexParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    language: string;
-}>;
-/**
- * Parameters for dropping a fulltext index created via createFulltextIndex.
- */
-type DropFulltextIndexParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-}>;
-/**
- * Transaction options.
- */
-type TransactionOptions = Readonly<{
-    /** Transaction isolation level (if supported) */
-    isolationLevel?: "read_uncommitted" | "read_committed" | "repeatable_read" | "serializable";
-}>;
-/**
- * Transaction backend - a backend scoped to a transaction.
- */
-type TransactionBackend = Omit<GraphBackend, "transaction" | "close" | "refreshStatistics">;
-/**
- * The GraphBackend interface abstracts database operations.
- *
- * Implementations should provide:
- * - SQLite backend via better-sqlite3 or libsql
- * - PostgreSQL backend via pg or postgres
- */
-type GraphBackend = Readonly<{
-    /** The SQL dialect */
-    dialect: SqlDialect;
-    /** Backend capabilities */
-    capabilities: BackendCapabilities;
-    /** Table names used by this backend (for query schema auto-derivation) */
-    tableNames?: SqlTableNames | undefined;
-    /**
-     * Optional fulltext strategy override. When present, both the compiler
-     * (for `$fulltext.matches()` in query builder) and backend-direct
-     * search paths use this instead of the dialect's default strategy —
-     * allowing a Postgres backend to ship pg_trgm, ParadeDB, pgroonga etc.
-     * When absent, the dialect's default strategy is used.
-     */
-    fulltextStrategy?: FulltextStrategy | undefined;
-    insertNode: (params: InsertNodeParams) => Promise<NodeRow>;
-    insertNodeNoReturn?: (params: InsertNodeParams) => Promise<void>;
-    insertNodesBatch?: (params: readonly InsertNodeParams[]) => Promise<void>;
-    insertNodesBatchReturning?: (params: readonly InsertNodeParams[]) => Promise<readonly NodeRow[]>;
-    updateNode: (params: UpdateNodeParams) => Promise<NodeRow>;
-    deleteNode: (params: DeleteNodeParams) => Promise<void>;
-    hardDeleteNode: (params: HardDeleteNodeParams) => Promise<void>;
-    getNode: (graphId: string, kind: string, id: string) => Promise<NodeRow | undefined>;
-    getNodes?: (graphId: string, kind: string, ids: readonly string[]) => Promise<readonly NodeRow[]>;
-    insertEdge: (params: InsertEdgeParams) => Promise<EdgeRow>;
-    insertEdgeNoReturn?: (params: InsertEdgeParams) => Promise<void>;
-    insertEdgesBatch?: (params: readonly InsertEdgeParams[]) => Promise<void>;
-    insertEdgesBatchReturning?: (params: readonly InsertEdgeParams[]) => Promise<readonly EdgeRow[]>;
-    updateEdge: (params: UpdateEdgeParams) => Promise<EdgeRow>;
-    deleteEdge: (params: DeleteEdgeParams) => Promise<void>;
-    hardDeleteEdge: (params: HardDeleteEdgeParams) => Promise<void>;
-    getEdge: (graphId: string, id: string) => Promise<EdgeRow | undefined>;
-    getEdges?: (graphId: string, ids: readonly string[]) => Promise<readonly EdgeRow[]>;
-    countEdgesFrom: (params: CountEdgesFromParams) => Promise<number>;
-    edgeExistsBetween: (params: EdgeExistsBetweenParams) => Promise<boolean>;
-    findEdgesConnectedTo: (params: FindEdgesConnectedToParams) => Promise<readonly EdgeRow[]>;
-    findNodesByKind: (params: FindNodesByKindParams) => Promise<readonly NodeRow[]>;
-    countNodesByKind: (params: CountNodesByKindParams) => Promise<number>;
-    findEdgesByKind: (params: FindEdgesByKindParams) => Promise<readonly EdgeRow[]>;
-    countEdgesByKind: (params: CountEdgesByKindParams) => Promise<number>;
-    insertUnique: (params: InsertUniqueParams) => Promise<void>;
-    deleteUnique: (params: DeleteUniqueParams) => Promise<void>;
-    checkUnique: (params: CheckUniqueParams) => Promise<UniqueRow | undefined>;
-    checkUniqueBatch?: (params: CheckUniqueBatchParams) => Promise<readonly UniqueRow[]>;
-    getActiveSchema: (graphId: string) => Promise<SchemaVersionRow | undefined>;
-    getSchemaVersion: (graphId: string, version: number) => Promise<SchemaVersionRow | undefined>;
-    insertSchema: (params: InsertSchemaParams) => Promise<SchemaVersionRow>;
-    setActiveSchema: (graphId: string, version: number) => Promise<void>;
-    upsertEmbedding?: (params: UpsertEmbeddingParams) => Promise<void>;
-    deleteEmbedding?: (params: DeleteEmbeddingParams) => Promise<void>;
-    getEmbedding?: (graphId: string, nodeKind: string, nodeId: string, fieldPath: string) => Promise<EmbeddingRow | undefined>;
-    vectorSearch?: (params: VectorSearchParams) => Promise<readonly VectorSearchResult[]>;
-    createVectorIndex?: (params: CreateVectorIndexParams) => Promise<void>;
-    dropVectorIndex?: (params: DropVectorIndexParams) => Promise<void>;
-    upsertFulltext?: (params: UpsertFulltextParams) => Promise<void>;
-    deleteFulltext?: (params: DeleteFulltextParams) => Promise<void>;
-    /**
-     * Batched variant of `upsertFulltext`. Optional — callers fall back to
-     * per-row `upsertFulltext` when unset.
-     */
-    upsertFulltextBatch?: (params: UpsertFulltextBatchParams) => Promise<void>;
-    /**
-     * Batched variant of `deleteFulltext`. Optional — callers fall back to
-     * per-row `deleteFulltext` when unset.
-     */
-    deleteFulltextBatch?: (params: DeleteFulltextBatchParams) => Promise<void>;
-    fulltextSearch?: (params: FulltextSearchParams) => Promise<readonly FulltextSearchResult[]>;
-    createFulltextIndex?: (params: CreateFulltextIndexParams) => Promise<void>;
-    dropFulltextIndex?: (params: DropFulltextIndexParams) => Promise<void>;
-    /**
-     * Hard-deletes all data for a graph (nodes, edges, uniques, embeddings, schema versions).
-     * Intended for import-replacement workflows. No hooks, no per-row logic.
-     */
-    clearGraph: (graphId: string) => Promise<void>;
-    /**
-     * Creates the base TypeGraph tables if they don't already exist.
-     *
-     * Called automatically by `createStoreWithSchema()` when a fresh database
-     * is detected. Users who manage DDL themselves via `createStore()` never
-     * hit this path.
-     */
-    bootstrapTables?: () => Promise<void>;
-    /**
-     * Refreshes the backend's query-planner statistics.
-     *
-     * Call this once after a large initial import or bulk backfill. Without
-     * up-to-date statistics, the planner can pick suboptimal execution plans
-     * — on PostgreSQL this is the difference between a 0.5ms and a 5ms
-     * forward traversal; on SQLite it's the difference between 0.9ms and
-     * 23ms fulltext search. Autovacuum / background statistics collection
-     * will catch up eventually, but calling this explicitly after a bulk
-     * load gives you correct latencies immediately.
-     *
-     * Implementations:
-     * - SQLite runs `ANALYZE`, which populates `sqlite_stat1`
-     * - PostgreSQL runs `ANALYZE` on the TypeGraph-managed tables
-     *
-     * Safe to call at any time; costs a few tens of milliseconds on the
-     * sizes this library is designed for.
-     */
-    refreshStatistics: () => Promise<void>;
-    execute: <T>(query: SQL) => Promise<readonly T[]>;
-    /** Execute pre-compiled SQL text with bound parameters. Available on sync SQLite and pg backends. */
-    executeRaw?: <T>(sqlText: string, params: readonly unknown[]) => Promise<readonly T[]>;
-    /** Compile a Drizzle SQL object to { sql, params } without executing. */
-    compileSql?: (query: SQL) => Readonly<{
-        sql: string;
-        params: readonly unknown[];
-    }>;
-    transaction: <T>(fn: (tx: TransactionBackend) => Promise<T>, options?: TransactionOptions) => Promise<T>;
-    close: () => Promise<void>;
-}>;
-/**
- * Parameters for inserting a unique constraint entry.
- */
-type InsertUniqueParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    constraintName: string;
-    key: string;
-    nodeId: string;
-    concreteKind: string;
-}>;
-/**
- * Parameters for deleting a unique constraint entry.
- */
-type DeleteUniqueParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    constraintName: string;
-    key: string;
-}>;
-/**
- * Parameters for checking a unique constraint.
- */
-type CheckUniqueParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    constraintName: string;
-    key: string;
-    /** If true, also returns soft-deleted entries. Used by get-or-create operations. */
-    includeDeleted?: boolean;
-}>;
-/**
- * Parameters for batch-checking unique constraints.
- */
-type CheckUniqueBatchParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    constraintName: string;
-    keys: readonly string[];
-    /** If true, also returns soft-deleted entries. Used by get-or-create operations. */
-    includeDeleted?: boolean;
-}>;
-/**
- * Parameters for inserting a schema version.
- */
-type InsertSchemaParams = Readonly<{
-    graphId: string;
-    version: number;
-    schemaHash: string;
-    schemaDoc: SerializedSchema;
-    isActive: boolean;
-}>;
-/**
- * Parameters for counting edges from a source node.
- */
-type CountEdgesFromParams = Readonly<{
-    graphId: string;
-    edgeKind: string;
-    fromKind: string;
-    fromId: string;
-    /** If true, only count edges where valid_to IS NULL */
-    activeOnly?: boolean;
-}>;
-/**
- * Parameters for checking if an edge exists between two nodes.
- */
-type EdgeExistsBetweenParams = Readonly<{
-    graphId: string;
-    edgeKind: string;
-    fromKind: string;
-    fromId: string;
-    toKind: string;
-    toId: string;
-}>;
-/**
- * Parameters for finding edges connected to a node.
- */
-type FindEdgesConnectedToParams = Readonly<{
-    graphId: string;
-    nodeKind: string;
-    nodeId: string;
-}>;
-/**
- * Parameters for finding nodes by kind.
- */
-type FindNodesByKindParams = Readonly<{
-    graphId: string;
-    kind: string;
-    /** Max rows to return. */
-    limit?: number;
-    /** Offset. Present for backward compat; rebuild uses `after` instead. */
-    offset?: number;
-    /** If true, exclude deleted nodes. Default true. */
-    excludeDeleted?: boolean;
-    /** Temporal mode for filtering by validity period. */
-    temporalMode?: TemporalMode;
-    /** Timestamp for "current" and "asOf" temporal modes. */
-    asOf?: string;
-    /**
-     * Stable ordering for keyset pagination. Default: "created_at" (existing
-     * behavior). Rebuild should use "id" for iteration that is stable under
-     * concurrent writes and shared timestamps.
-     */
-    orderBy?: "id" | "created_at";
-    /**
-     * Keyset cursor. Returns rows strictly greater (by `orderBy`) than this
-     * value. When `orderBy: "id"`, compared lexicographically. Mutually
-     * exclusive with `offset` — callers pick one.
-     */
-    after?: string;
-}>;
-/**
- * Parameters for counting nodes by kind.
- */
-type CountNodesByKindParams = Readonly<{
-    graphId: string;
-    kind: string;
-    /** If true, exclude deleted nodes. Default true. */
-    excludeDeleted?: boolean;
-    /** Temporal mode for filtering by validity period. */
-    temporalMode?: TemporalMode;
-    /** Timestamp for "current" and "asOf" temporal modes. */
-    asOf?: string;
-}>;
-/**
- * Parameters for finding edges by kind.
- */
-type FindEdgesByKindParams = Readonly<{
-    graphId: string;
-    kind: string;
-    fromKind?: string;
-    fromId?: string;
-    toKind?: string;
-    toId?: string;
-    limit?: number;
-    offset?: number;
-    /** If true, exclude deleted edges. Default true. */
-    excludeDeleted?: boolean;
-    /** Temporal mode for filtering by validity period. */
-    temporalMode?: TemporalMode;
-    /** Timestamp for "current" and "asOf" temporal modes. */
-    asOf?: string;
-}>;
-/**
- * Parameters for counting edges by kind.
- */
-type CountEdgesByKindParams = Readonly<{
-    graphId: string;
-    kind: string;
-    fromKind?: string;
-    fromId?: string;
-    toKind?: string;
-    toId?: string;
-    /** If true, exclude deleted edges. Default true. */
-    excludeDeleted?: boolean;
-    /** Temporal mode for filtering by validity period. */
-    temporalMode?: TemporalMode;
-    /** Timestamp for "current" and "asOf" temporal modes. */
-    asOf?: string;
-}>;
-
-export { type SerializedSchema as $, type AnyEdgeType as A, type BackendCapabilities as B, type Cardinality as C, DEFAULT_SQL_SCHEMA as D, type EdgeType as E, type FulltextBatchRow as F, type GraphBackend as G, isEdgeTypeWithEndpoints as H, type InferenceType as I, isMetaEdge as J, isNodeType as K, tsvectorStrategy as L, type MetaEdge as M, type NodeType as N, type OntologyRelation as O, type EdgeRow as P, type NodeRow as Q, type VectorMetric as R, type SqlDialect as S, type TemporalMode as T, type UniqueConstraint as U, type VectorCapabilities as V, type SerializedNodeDef as W, type SerializedEdgeDef as X, type SerializedMetaEdge as Y, type SerializedOntologyRelation as Z, type SerializedClosures as _, type Collation as a, type SchemaHash as a0, type JsonSchema as a1, type SerializedOntology as a2, type SerializedUniqueConstraint as a3, type SchemaVersionRow as a4, type DeleteBehavior as b, type DeleteFulltextBatchParams as c, type EdgeId as d, type EdgeProps as e, type EdgeRegistration as f, type EdgeTypeWithEndpoints as g, type EndpointExistence as h, type FulltextCapabilities as i, type FulltextQueryMode as j, type FulltextSearchParams as k, type FulltextSearchResult as l, type FulltextStrategy as m, type GraphDefaults as n, type MetaEdgeProperties as o, type NodeId as p, type NodeProps as q, type NodeRegistration as r, type SqlSchema as s, type SqlTableNames as t, type TransactionBackend as u, type UniquenessScope as v, type UpsertFulltextBatchParams as w, createSqlSchema as x, fts5Strategy as y, isEdgeType as z };