@typicalday/firegraph 0.7.0 → 0.8.0

package/dist/serialization-C6JNNOCS.js

@@ -0,0 +1,13 @@
+import {
+  SERIALIZATION_TAG,
+  deserializeFirestoreTypes,
+  isTaggedValue,
+  serializeFirestoreTypes
+} from "./chunk-6OQW5OKO.js";
+export {
+  SERIALIZATION_TAG,
+  deserializeFirestoreTypes,
+  isTaggedValue,
+  serializeFirestoreTypes
+};
+//# sourceMappingURL=serialization-C6JNNOCS.js.map

package/dist/serialization-C6JNNOCS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{index-B9aodfYD.d.cts → types-BVtx9zLv.d.cts}

@@ -104,6 +104,24 @@ declare function defineConfig(config: FiregraphConfig): FiregraphConfig;
  */
 declare function resolveView(resolverConfig: ViewResolverConfig | undefined, availableViewNames: string[], context?: ViewContext): string;
 
+/**
+ * Backend-agnostic timestamp.
+ *
+ * Structurally compatible with `@google-cloud/firestore`'s `Timestamp` so
+ * that records returned by either the Firestore or SQLite backend can be
+ * consumed through the same `StoredGraphRecord` shape.
+ *
+ * Firestore's native `Timestamp` already satisfies this interface, so
+ * existing Firestore consumers see no behavior change. The SQLite backend
+ * returns instances of `GraphTimestampImpl` which also satisfies it.
+ */
+interface GraphTimestamp {
+    readonly seconds: number;
+    readonly nanoseconds: number;
+    toDate(): Date;
+    toMillis(): number;
+}
+
 interface GraphRecord {
     aType: string;
     aUid: string;
@@ -123,8 +141,13 @@ interface StoredGraphRecord {
     bType: string;
     bUid: string;
     data: Record<string, unknown>;
-    createdAt: Timestamp;
-    updatedAt: Timestamp;
+    /**
+     * Backend-agnostic timestamp. Firestore returns its native `Timestamp`
+     * (which structurally satisfies `GraphTimestamp`); the SQLite backends
+     * return a `GraphTimestampImpl` instance.
+     */
+    createdAt: GraphTimestamp;
+    updatedAt: GraphTimestamp;
     /** Schema version — set automatically when the registry entry has migrations. */
     v?: number;
 }
@@ -618,26 +641,4 @@ interface CascadeResult extends BulkResult {
     nodeDeleted: boolean;
 }
 
-/**
- * Code generation — produces TypeScript type definitions from JSON Schema
- * files discovered via the entity folder convention.
- *
- * Uses `json-schema-to-typescript` to compile each entity's `schema.json`
- * into a TypeScript interface.
- *
- * Naming convention:
- * - Nodes:  `{PascalName}Data`       (e.g. `TaskData`)
- * - Edges:  `{PascalName}EdgeData`   (e.g. `HasStepEdgeData`)
- */
-
-interface CodegenOptions {
-    /** Add banner comment at top of output. Defaults to true. */
-    banner?: boolean;
-}
-/**
- * Generate TypeScript type definitions from a DiscoveryResult.
- * Returns the full file content as a string.
- */
-declare function generateTypes(discovery: DiscoveryResult, options?: CodegenOptions): Promise<string>;
-
-export { type ScanProtection as A, type BulkBatchError as B, type CascadeResult as C, type DynamicRegistryConfig as D, type EdgeTopology as E, type FindEdgesParams as F, type GraphClientOptions as G, type HopDefinition as H, type TraversalOptions as I, type TraversalResult as J, type ViewDefaultsConfig as K, type ViewResolverConfig as L, type MigrationExecutor as M, type NodeTypeData as N, defineConfig as O, generateTypes as P, type QueryPlan as Q, type RegistryEntry as R, type StoredMigrationStep as S, type TraversalBuilder as T, resolveView as U, type ViewContext as V, type WhereClause as W, type DynamicGraphClient as a, type GraphClient as b, type GraphRegistry as c, type DiscoveryResult as d, type GraphReader as e, type GraphRecord as f, type FindNodesParams as g, type MigrationFn as h, type MigrationStep as i, type StoredGraphRecord as j, type MigrationWriteBack as k, type QueryFilter as l, type BulkOptions as m, type BulkProgress as n, type BulkResult as o, type CodegenOptions as p, type DefineTypeOptions as q, type DiscoveredEntity as r, type EdgeTypeData as s, type FiregraphConfig as t, type GraphBatch as u, type GraphTransaction as v, type GraphWriter as w, type HopResult as x, type QueryMode as y, type QueryOptions as z };
+export { type TraversalOptions as A, type BulkOptions as B, type CascadeResult as C, type DynamicRegistryConfig as D, type EdgeTopology as E, type FindEdgesParams as F, type GraphClientOptions as G, type HopDefinition as H, type TraversalResult as I, type ViewDefaultsConfig as J, type ViewResolverConfig as K, defineConfig as L, type MigrationExecutor as M, type NodeTypeData as N, resolveView as O, type QueryFilter as Q, type RegistryEntry as R, type StoredGraphRecord as S, type TraversalBuilder as T, type ViewContext as V, type WhereClause as W, type DynamicGraphClient as a, type GraphClient as b, type QueryOptions as c, type GraphReader as d, type BulkResult as e, type DiscoveryResult as f, type GraphRegistry as g, type MigrationWriteBack as h, type MigrationStep as i, type QueryPlan as j, type FindNodesParams as k, type GraphRecord as l, type MigrationFn as m, type StoredMigrationStep as n, type BulkBatchError as o, type BulkProgress as p, type DefineTypeOptions as q, type DiscoveredEntity as r, type EdgeTypeData as s, type FiregraphConfig as t, type GraphBatch as u, type GraphTransaction as v, type GraphWriter as w, type HopResult as x, type QueryMode as y, type ScanProtection as z };

package/dist/{index-B9aodfYD.d.ts → types-BVtx9zLv.d.ts}

@@ -104,6 +104,24 @@ declare function defineConfig(config: FiregraphConfig): FiregraphConfig;
  */
 declare function resolveView(resolverConfig: ViewResolverConfig | undefined, availableViewNames: string[], context?: ViewContext): string;
 
+/**
+ * Backend-agnostic timestamp.
+ *
+ * Structurally compatible with `@google-cloud/firestore`'s `Timestamp` so
+ * that records returned by either the Firestore or SQLite backend can be
+ * consumed through the same `StoredGraphRecord` shape.
+ *
+ * Firestore's native `Timestamp` already satisfies this interface, so
+ * existing Firestore consumers see no behavior change. The SQLite backend
+ * returns instances of `GraphTimestampImpl` which also satisfies it.
+ */
+interface GraphTimestamp {
+    readonly seconds: number;
+    readonly nanoseconds: number;
+    toDate(): Date;
+    toMillis(): number;
+}
+
 interface GraphRecord {
     aType: string;
     aUid: string;
@@ -123,8 +141,13 @@ interface StoredGraphRecord {
     bType: string;
     bUid: string;
     data: Record<string, unknown>;
-    createdAt: Timestamp;
-    updatedAt: Timestamp;
+    /**
+     * Backend-agnostic timestamp. Firestore returns its native `Timestamp`
+     * (which structurally satisfies `GraphTimestamp`); the SQLite backends
+     * return a `GraphTimestampImpl` instance.
+     */
+    createdAt: GraphTimestamp;
+    updatedAt: GraphTimestamp;
     /** Schema version — set automatically when the registry entry has migrations. */
     v?: number;
 }
@@ -618,26 +641,4 @@ interface CascadeResult extends BulkResult {
     nodeDeleted: boolean;
 }
 
-/**
- * Code generation — produces TypeScript type definitions from JSON Schema
- * files discovered via the entity folder convention.
- *
- * Uses `json-schema-to-typescript` to compile each entity's `schema.json`
- * into a TypeScript interface.
- *
- * Naming convention:
- * - Nodes:  `{PascalName}Data`       (e.g. `TaskData`)
- * - Edges:  `{PascalName}EdgeData`   (e.g. `HasStepEdgeData`)
- */
-
-interface CodegenOptions {
-    /** Add banner comment at top of output. Defaults to true. */
-    banner?: boolean;
-}
-/**
- * Generate TypeScript type definitions from a DiscoveryResult.
- * Returns the full file content as a string.
- */
-declare function generateTypes(discovery: DiscoveryResult, options?: CodegenOptions): Promise<string>;
-
-export { type ScanProtection as A, type BulkBatchError as B, type CascadeResult as C, type DynamicRegistryConfig as D, type EdgeTopology as E, type FindEdgesParams as F, type GraphClientOptions as G, type HopDefinition as H, type TraversalOptions as I, type TraversalResult as J, type ViewDefaultsConfig as K, type ViewResolverConfig as L, type MigrationExecutor as M, type NodeTypeData as N, defineConfig as O, generateTypes as P, type QueryPlan as Q, type RegistryEntry as R, type StoredMigrationStep as S, type TraversalBuilder as T, resolveView as U, type ViewContext as V, type WhereClause as W, type DynamicGraphClient as a, type GraphClient as b, type GraphRegistry as c, type DiscoveryResult as d, type GraphReader as e, type GraphRecord as f, type FindNodesParams as g, type MigrationFn as h, type MigrationStep as i, type StoredGraphRecord as j, type MigrationWriteBack as k, type QueryFilter as l, type BulkOptions as m, type BulkProgress as n, type BulkResult as o, type CodegenOptions as p, type DefineTypeOptions as q, type DiscoveredEntity as r, type EdgeTypeData as s, type FiregraphConfig as t, type GraphBatch as u, type GraphTransaction as v, type GraphWriter as w, type HopResult as x, type QueryMode as y, type QueryOptions as z };
+export { type TraversalOptions as A, type BulkOptions as B, type CascadeResult as C, type DynamicRegistryConfig as D, type EdgeTopology as E, type FindEdgesParams as F, type GraphClientOptions as G, type HopDefinition as H, type TraversalResult as I, type ViewDefaultsConfig as J, type ViewResolverConfig as K, defineConfig as L, type MigrationExecutor as M, type NodeTypeData as N, resolveView as O, type QueryFilter as Q, type RegistryEntry as R, type StoredGraphRecord as S, type TraversalBuilder as T, type ViewContext as V, type WhereClause as W, type DynamicGraphClient as a, type GraphClient as b, type QueryOptions as c, type GraphReader as d, type BulkResult as e, type DiscoveryResult as f, type GraphRegistry as g, type MigrationWriteBack as h, type MigrationStep as i, type QueryPlan as j, type FindNodesParams as k, type GraphRecord as l, type MigrationFn as m, type StoredMigrationStep as n, type BulkBatchError as o, type BulkProgress as p, type DefineTypeOptions as q, type DiscoveredEntity as r, type EdgeTypeData as s, type FiregraphConfig as t, type GraphBatch as u, type GraphTransaction as v, type GraphWriter as w, type HopResult as x, type QueryMode as y, type ScanProtection as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typicalday/firegraph",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Generic Firestore adjacency graph client with smart query planning",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -46,6 +46,26 @@
         "types": "./dist/query-client/index.d.cts",
         "default": "./dist/query-client/index.cjs"
       }
+    },
+    "./d1": {
+      "import": {
+        "types": "./dist/d1.d.ts",
+        "default": "./dist/d1.js"
+      },
+      "require": {
+        "types": "./dist/d1.d.cts",
+        "default": "./dist/d1.cjs"
+      }
+    },
+    "./do-sqlite": {
+      "import": {
+        "types": "./dist/do-sqlite.d.ts",
+        "default": "./dist/do-sqlite.js"
+      },
+      "require": {
+        "types": "./dist/do-sqlite.d.cts",
+        "default": "./dist/do-sqlite.cjs"
+      }
     }
   },
   "bin": {
@@ -57,7 +77,11 @@
     "skills"
   ],
   "scripts": {
-    "prepare": "tsup && (npm run build:editor || true)",
+    "prepare": "husky && tsup && (npm run build:editor || true)",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
     "build": "tsup",
     "build:editor:client": "cd editor && npx vite build",
     "build:editor:server": "node editor/build-server.mjs",
@@ -68,6 +92,7 @@
     "test": "vitest run",
     "test:unit": "vitest run tests/unit/",
     "test:integration": "vitest run tests/integration/",
+    "test:sqlite:integration": "BACKEND=sqlite vitest run tests/integration/",
     "test:emulator": "bash tests/scripts/test-with-emulator.sh",
     "test:emulator:unit": "bash tests/scripts/test-with-emulator.sh tests/unit/",
     "test:emulator:integration": "bash tests/scripts/test-with-emulator.sh tests/integration/",
@@ -104,9 +129,21 @@
     "ses": "^1.15.0"
   },
   "devDependencies": {
+    "@commitlint/cli": "^20.5.0",
+    "@commitlint/config-conventional": "^20.5.0",
     "@google-cloud/firestore": "^8.3.0",
+    "@types/better-sqlite3": "^7.6.13",
+    "@typescript-eslint/eslint-plugin": "^8.57.2",
+    "@typescript-eslint/parser": "^8.57.2",
     "@vitest/coverage-v8": "^3.0.0",
+    "better-sqlite3": "^12.9.0",
+    "eslint": "^10.1.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "husky": "^9.1.7",
     "json-schema-to-typescript": "^15.0.4",
+    "lint-staged": "^16.4.0",
+    "prettier": "^3.8.1",
     "tsup": "^8.4.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"