@nicia-ai/typegraph 0.1.0

package/dist/types-a5rAxC92.d.cts

@@ -0,0 +1,152 @@
+import { z } from 'zod';
+import { A as AnyEdgeType, E as EdgeType, J as JsonPointer, V as ValueType, a as JsonPointerFor, b as JsonPointerSegmentsFor, N as NodeType } from './ast-BVyihVbP.cjs';
+
+type IndexScope = 
+/**
+ * Prefix index keys with `(graph_id, kind)` (nodes) or `(graph_id, kind)` (edges).
+ *
+ * This matches TypeGraph queries which always filter on `graph_id` and `kind`
+ * (often as `IN (...)` due to ontology expansion).
+ */
+"graphAndKind"
+/**
+ * Prefix index keys with `graph_id` only.
+ */
+ | "graph"
+/**
+ * Do not prefix index keys with TypeGraph system columns.
+ */
+ | "none";
+type IndexWhereOp = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn";
+type IndexWhereExpression = Readonly<{
+    __type: "index_where_and";
+    predicates: readonly IndexWhereExpression[];
+}> | Readonly<{
+    __type: "index_where_or";
+    predicates: readonly IndexWhereExpression[];
+}> | Readonly<{
+    __type: "index_where_not";
+    predicate: IndexWhereExpression;
+}> | Readonly<{
+    __type: "index_where_comparison";
+    left: IndexWhereOperand;
+    op: IndexWhereOp;
+    right: IndexWhereLiteral | readonly IndexWhereLiteral[];
+}> | Readonly<{
+    __type: "index_where_null_check";
+    operand: IndexWhereOperand;
+    op: "isNull" | "isNotNull";
+}>;
+type IndexWhereOperand = Readonly<{
+    __type: "index_operand_system";
+    column: SystemColumnName;
+    valueType: ValueType | undefined;
+}> | Readonly<{
+    __type: "index_operand_prop";
+    field: string;
+    valueType: ValueType | undefined;
+}>;
+type IndexWhereLiteral = Readonly<{
+    __type: "index_where_literal";
+    value: string | number | boolean;
+    valueType: ValueType;
+}>;
+type IndexWhereComparableValue<T> = NonNullable<T> extends string ? string : NonNullable<T> extends number ? number : NonNullable<T> extends boolean ? boolean : NonNullable<T> extends Date ? Date | string : never;
+type IndexWhereFieldBuilder<T> = Readonly<{
+    eq: (value: IndexWhereComparableValue<T>) => IndexWhereExpression;
+    neq: (value: IndexWhereComparableValue<T>) => IndexWhereExpression;
+    gt: (value: IndexWhereComparableValue<T>) => IndexWhereExpression;
+    gte: (value: IndexWhereComparableValue<T>) => IndexWhereExpression;
+    lt: (value: IndexWhereComparableValue<T>) => IndexWhereExpression;
+    lte: (value: IndexWhereComparableValue<T>) => IndexWhereExpression;
+    in: (values: readonly IndexWhereComparableValue<T>[]) => IndexWhereExpression;
+    notIn: (values: readonly IndexWhereComparableValue<T>[]) => IndexWhereExpression;
+    isNull: () => IndexWhereExpression;
+    isNotNull: () => IndexWhereExpression;
+}>;
+type NodeIndexWhereBuilder<N extends NodeType> = Readonly<{
+    graphId: IndexWhereFieldBuilder<string>;
+    kind: IndexWhereFieldBuilder<string>;
+    id: IndexWhereFieldBuilder<string>;
+    deletedAt: IndexWhereFieldBuilder<string | undefined>;
+    validFrom: IndexWhereFieldBuilder<string | undefined>;
+    validTo: IndexWhereFieldBuilder<string | undefined>;
+    createdAt: IndexWhereFieldBuilder<string>;
+    updatedAt: IndexWhereFieldBuilder<string>;
+    version: IndexWhereFieldBuilder<number>;
+} & {
+    [K in keyof z.infer<N["schema"]>]-?: IndexWhereFieldBuilder<z.infer<N["schema"]>[K]>;
+}>;
+type EdgeIndexWhereBuilder<E extends AnyEdgeType> = Readonly<{
+    graphId: IndexWhereFieldBuilder<string>;
+    kind: IndexWhereFieldBuilder<string>;
+    id: IndexWhereFieldBuilder<string>;
+    fromKind: IndexWhereFieldBuilder<string>;
+    fromId: IndexWhereFieldBuilder<string>;
+    toKind: IndexWhereFieldBuilder<string>;
+    toId: IndexWhereFieldBuilder<string>;
+    deletedAt: IndexWhereFieldBuilder<string | undefined>;
+    validFrom: IndexWhereFieldBuilder<string | undefined>;
+    validTo: IndexWhereFieldBuilder<string | undefined>;
+    createdAt: IndexWhereFieldBuilder<string>;
+    updatedAt: IndexWhereFieldBuilder<string>;
+} & {
+    [K in keyof z.infer<E["schema"]>]-?: IndexWhereFieldBuilder<z.infer<E["schema"]>[K]>;
+}>;
+type IndexWhereInput<Builder> = IndexWhereExpression | ((where: Builder) => IndexWhereExpression);
+type NonEmptyJsonPointerFor<T> = Exclude<JsonPointerFor<T>, "">;
+type NonEmptyJsonPointerSegmentsFor<T> = Exclude<JsonPointerSegmentsFor<T>, readonly []>;
+type IndexFieldInput<T> = (keyof T & string) | NonEmptyJsonPointerFor<T> | NonEmptyJsonPointerSegmentsFor<T> | JsonPointer;
+type NodeIndexConfig<N extends NodeType> = Readonly<{
+    fields: readonly IndexFieldInput<z.infer<N["schema"]>>[];
+    coveringFields?: readonly IndexFieldInput<z.infer<N["schema"]>>[] | undefined;
+    unique?: boolean | undefined;
+    name?: string | undefined;
+    scope?: IndexScope | undefined;
+    where?: IndexWhereInput<NodeIndexWhereBuilder<N>> | undefined;
+}>;
+type EdgeIndexDirection = "out" | "in" | "none";
+type EdgeIndexConfig<E extends AnyEdgeType> = Readonly<{
+    fields: readonly IndexFieldInput<z.infer<E["schema"]>>[];
+    coveringFields?: readonly IndexFieldInput<z.infer<E["schema"]>>[] | undefined;
+    unique?: boolean | undefined;
+    name?: string | undefined;
+    scope?: IndexScope | undefined;
+    /**
+     * Optional direction hint to prefix edge indexes with the join key that
+     * TypeGraph traversal queries use (`from_id` for out, `to_id` for in).
+     */
+    direction?: EdgeIndexDirection | undefined;
+    where?: IndexWhereInput<EdgeIndexWhereBuilder<E>> | undefined;
+}>;
+type NodeIndex<N extends NodeType = NodeType> = Readonly<{
+    __type: "typegraph_node_index";
+    node: N;
+    nodeKind: N["name"];
+    fields: readonly JsonPointer[];
+    fieldValueTypes: readonly (ValueType | undefined)[];
+    coveringFields: readonly JsonPointer[];
+    coveringFieldValueTypes: readonly (ValueType | undefined)[];
+    unique: boolean;
+    scope: IndexScope;
+    where: IndexWhereExpression | undefined;
+    name: string;
+}>;
+type EdgeIndex<E extends AnyEdgeType = EdgeType> = Readonly<{
+    __type: "typegraph_edge_index";
+    edge: E;
+    edgeKind: E["name"];
+    fields: readonly JsonPointer[];
+    fieldValueTypes: readonly (ValueType | undefined)[];
+    coveringFields: readonly JsonPointer[];
+    coveringFieldValueTypes: readonly (ValueType | undefined)[];
+    unique: boolean;
+    scope: IndexScope;
+    direction: EdgeIndexDirection;
+    where: IndexWhereExpression | undefined;
+    name: string;
+}>;
+type TypeGraphIndex = NodeIndex | EdgeIndex;
+type SystemColumnName = "graph_id" | "kind" | "id" | "from_kind" | "from_id" | "to_kind" | "to_id" | "deleted_at" | "valid_from" | "valid_to" | "created_at" | "updated_at" | "version";
+
+export type { EdgeIndex as E, IndexWhereExpression as I, NodeIndex as N, SystemColumnName as S, TypeGraphIndex as T, EdgeIndexConfig as a, NodeIndexConfig as b, EdgeIndexDirection as c, EdgeIndexWhereBuilder as d, IndexScope as e, IndexWhereFieldBuilder as f, IndexWhereInput as g, NodeIndexWhereBuilder as h };

package/package.json

@@ -0,0 +1,201 @@
+{
+  "name": "@nicia-ai/typegraph",
+  "version": "0.1.0",
+  "description": "TypeScript-first embedded knowledge graph library with ontological reasoning",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./interchange": {
+      "import": {
+        "types": "./dist/interchange/index.d.ts",
+        "default": "./dist/interchange/index.js"
+      },
+      "require": {
+        "types": "./dist/interchange/index.d.cts",
+        "default": "./dist/interchange/index.cjs"
+      }
+    },
+    "./profiler": {
+      "import": {
+        "types": "./dist/profiler/index.d.ts",
+        "default": "./dist/profiler/index.js"
+      },
+      "require": {
+        "types": "./dist/profiler/index.d.cts",
+        "default": "./dist/profiler/index.cjs"
+      }
+    },
+    "./indexes": {
+      "import": {
+        "types": "./dist/indexes/index.d.ts",
+        "default": "./dist/indexes/index.js"
+      },
+      "require": {
+        "types": "./dist/indexes/index.d.cts",
+        "default": "./dist/indexes/index.cjs"
+      }
+    },
+    "./sqlite": {
+      "import": {
+        "types": "./dist/backend/sqlite/index.d.ts",
+        "default": "./dist/backend/sqlite/index.js"
+      },
+      "require": {
+        "types": "./dist/backend/sqlite/index.d.cts",
+        "default": "./dist/backend/sqlite/index.cjs"
+      }
+    },
+    "./postgres": {
+      "import": {
+        "types": "./dist/backend/postgres/index.d.ts",
+        "default": "./dist/backend/postgres/index.js"
+      },
+      "require": {
+        "types": "./dist/backend/postgres/index.d.cts",
+        "default": "./dist/backend/postgres/index.cjs"
+      }
+    },
+    "./drizzle": {
+      "import": {
+        "types": "./dist/backend/drizzle/index.d.ts",
+        "default": "./dist/backend/drizzle/index.js"
+      },
+      "require": {
+        "types": "./dist/backend/drizzle/index.d.cts",
+        "default": "./dist/backend/drizzle/index.cjs"
+      }
+    },
+    "./drizzle/sqlite": {
+      "import": {
+        "types": "./dist/backend/drizzle/sqlite.d.ts",
+        "default": "./dist/backend/drizzle/sqlite.js"
+      },
+      "require": {
+        "types": "./dist/backend/drizzle/sqlite.d.cts",
+        "default": "./dist/backend/drizzle/sqlite.cjs"
+      }
+    },
+    "./drizzle/postgres": {
+      "import": {
+        "types": "./dist/backend/drizzle/postgres.d.ts",
+        "default": "./dist/backend/drizzle/postgres.js"
+      },
+      "require": {
+        "types": "./dist/backend/drizzle/postgres.d.cts",
+        "default": "./dist/backend/drizzle/postgres.cjs"
+      }
+    },
+    "./drizzle/schema/sqlite": {
+      "import": {
+        "types": "./dist/backend/drizzle/schema/sqlite.d.ts",
+        "default": "./dist/backend/drizzle/schema/sqlite.js"
+      },
+      "require": {
+        "types": "./dist/backend/drizzle/schema/sqlite.d.cts",
+        "default": "./dist/backend/drizzle/schema/sqlite.cjs"
+      }
+    },
+    "./drizzle/schema/postgres": {
+      "import": {
+        "types": "./dist/backend/drizzle/schema/postgres.d.ts",
+        "default": "./dist/backend/drizzle/schema/postgres.js"
+      },
+      "require": {
+        "types": "./dist/backend/drizzle/schema/postgres.d.cts",
+        "default": "./dist/backend/drizzle/schema/postgres.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "graph",
+    "knowledge-graph",
+    "typescript",
+    "sqlite",
+    "drizzle",
+    "zod",
+    "ontology",
+    "semantic"
+  ],
+  "author": "Nicia AI, Inc.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nicia-ai/typegraph.git",
+    "directory": "packages/typegraph"
+  },
+  "bugs": {
+    "url": "https://github.com/nicia-ai/typegraph/issues"
+  },
+  "homepage": "https://typegraph.dev",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "peerDependencies": {
+    "better-sqlite3": ">=9.0.0",
+    "drizzle-orm": ">=0.35.0",
+    "zod": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "nanoid": "^5.1.6"
+  },
+  "devDependencies": {
+    "@stryker-mutator/core": "^9.5.1",
+    "@stryker-mutator/vitest-runner": "^9.5.1",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^24.10.11",
+    "@types/pg": "^8.16.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "better-sqlite3": "^12.6.2",
+    "drizzle-orm": "^0.45.1",
+    "eslint": "^9.39.2",
+    "fast-check": "^4.5.3",
+    "pg": "^8.18.0",
+    "sqlite-vec": "0.1.7-alpha.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "zod": "^4.3.6",
+    "@typegraph/eslint-config": "0.1.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit --skipLibCheck",
+    "pretest": "node --import tsx scripts/ensure-native-sqlite.ts",
+    "test": "vitest run",
+    "pretest:unit": "node --import tsx scripts/ensure-native-sqlite.ts",
+    "test:unit": "vitest run",
+    "pretest:property": "node --import tsx scripts/ensure-native-sqlite.ts",
+    "test:property": "vitest run tests/property",
+    "test:postgres": "./scripts/test-postgres.sh",
+    "test:coverage": "vitest run --coverage",
+    "test:mutation": "stryker run"
+  }
+}