@ontrails/drizzle 1.0.0-beta.15 → 1.0.0-beta.17

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # @ontrails/drizzle
 
+## 1.0.0-beta.17
+
+### Patch Changes
+
+- Updated dependencies [3dc8254]
+  - @ontrails/core@1.0.0-beta.17
+  - @ontrails/store@1.0.0-beta.17
+
+## 1.0.0-beta.16
+
+### Patch Changes
+
+- f5c6777: Move adapter package workspaces from `connectors/*` to `adapters/*` as part of
+  the package-boundary taxonomy cutover. Package names and public APIs are
+  unchanged.
+- 3395234: Move store adapter-binding helpers to `@ontrails/store/adapter-support` and topographer direct database/admin helpers to `@ontrails/topographer/backend-support`, keeping root exports focused on contract-level APIs.
+- 6300f70: BREAKING: rename the shared store backend option type from `StoreConnectorOptions` to `StoreAdapterOptions`.
+- 49c2e7d: Refresh published package README taxonomy to use adapter language instead of retired connector vocabulary.
+- df9a7d0: Add project-aware public export-map governance for @ontrails workspace docs,
+  imports, root barrels, and bin-only package surfaces.
+- Updated dependencies [73622ae]
+- Updated dependencies [6300f70]
+- Updated dependencies [d172013]
+- Updated dependencies [c3fc5c3]
+- Updated dependencies [20d7a5c]
+- Updated dependencies [be5fb46]
+- Updated dependencies [e898cc4]
+- Updated dependencies [3395234]
+- Updated dependencies [bcdc484]
+- Updated dependencies [6300f70]
+- Updated dependencies [49c2e7d]
+- Updated dependencies [331e3a9]
+- Updated dependencies [4399fdb]
+- Updated dependencies [4b8d13b]
+- Updated dependencies [112b9f2]
+- Updated dependencies [893025e]
+- Updated dependencies [eec5e9d]
+- Updated dependencies [ebd4434]
+- Updated dependencies [863d473]
+- Updated dependencies [344f2f7]
+- Updated dependencies [26f9ffd]
+- Updated dependencies [10eae9a]
+- Updated dependencies [22c6c06]
+- Updated dependencies [df9a7d0]
+  - @ontrails/core@1.0.0-beta.16
+  - @ontrails/store@1.0.0-beta.16
+
 ## 1.0.0-beta.15
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,6 @@
 # @ontrails/drizzle
 
-Drizzle connector for Trails stores. Use this package to bind a connector-agnostic `store(...)` definition from `@ontrails/store` to a concrete Drizzle runtime.
+Drizzle adapter for Trails stores. Use this package to bind a backend-agnostic `store(...)` definition from `@ontrails/store` to a concrete Drizzle runtime.
 
 ## Usage
 
@@ -30,7 +30,9 @@ bun add @ontrails/store @ontrails/drizzle zod
 
 ## Migration
 
+<!-- warden-ignore-next-line -->
 This package replaces the old `@ontrails/store/drizzle` subpath.
 
+<!-- warden-ignore-next-line -->
 - Before: `import { connectDrizzle } from '@ontrails/store/drizzle'`
 - After: `import { connectDrizzle } from '@ontrails/drizzle'`

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "@ontrails/drizzle",
-  "version": "1.0.0-beta.15",
+  "version": "1.0.0-beta.17",
+  "files": [
+    "src/**/*.ts",
+    "!src/**/__tests__/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.test-d.ts",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "type": "module",
   "exports": {
     ".": "./src/index.ts",
@@ -14,11 +22,11 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@ontrails/core": "^1.0.0-beta.14",
+    "@ontrails/core": "^1.0.0-beta.16",
     "drizzle-orm": "^0.45.2"
   },
   "peerDependencies": {
-    "@ontrails/store": "^1.0.0-beta.14",
+    "@ontrails/store": "^1.0.0-beta.16",
     "zod": "^4.3.5"
   }
 }

package/src/runtime.ts

@@ -11,7 +11,7 @@ import {
   resource,
 } from '@ontrails/core';
 import { versionFieldName } from '@ontrails/store';
-import { bindStoreDefinition } from '@ontrails/store/internal/signal-identity';
+import { bindStoreDefinition } from '@ontrails/store/adapter-support';
 import type {
   AnyStoreDefinition,
   AnyStoreTable,
@@ -32,7 +32,7 @@ import { and, eq, sql } from 'drizzle-orm';
 import { drizzle } from 'drizzle-orm/bun-sqlite';
 import type { AnySQLiteColumn, AnySQLiteTable } from 'drizzle-orm/sqlite-core';
 import type { z } from 'zod';
-import type { TrailContext } from '@ontrails/core';
+import type { Signal, TrailContext } from '@ontrails/core';
 
 import {
   deriveDrizzleTables,
@@ -196,7 +196,7 @@ const isVersionManagedField = <TTable extends AnyStoreTable>(
 /**
  * Synthesize a value for a generated field during insert.
  *
- * The connector recognizes these conventions for generated fields:
+ * The adapter recognizes these conventions for generated fields:
  *
  * - **Primary key** (`integer` type): auto-increment, left to SQLite.
  * - **Timestamp fields** (`createdAt`, `updatedAt`, `created_at`,
@@ -474,7 +474,7 @@ const ensureNotCyclic = (
   }
 
   throw new ValidationError(
-    `Store definition contains a reference cycle involving "${tableName}", which the SQLite connector cannot seed automatically`
+    `Store definition contains a reference cycle involving "${tableName}", which the SQLite adapter cannot seed automatically`
   );
 };
 
@@ -1045,19 +1045,16 @@ type BoundFireFn = NonNullable<TrailContext['fire']>;
  */
 const fireDerivedSignal = async <TTable extends AnyStoreTable>(
   fire: BoundFireFn,
-  signalId: string,
+  derivedSignal: Signal<unknown>,
   entity: EntityOf<TTable>
 ): Promise<void> => {
   try {
-    const fired = await fire(signalId, entity);
-    if (fired.isErr()) {
-      console.warn(
-        `[drizzle] signal "${signalId}" emission failed:`,
-        fired.error
-      );
-    }
+    await fire(derivedSignal, entity);
   } catch (error) {
-    console.warn(`[drizzle] signal "${signalId}" emission threw:`, error);
+    console.warn(
+      `[drizzle] signal "${derivedSignal.id}" emission threw:`,
+      error
+    );
   }
 };
 
@@ -1084,7 +1081,7 @@ const bindWritableAccessorSignals = <TTable extends AnyStoreTable>(
     ...accessor,
     async insert(input: InsertOf<TTable>) {
       const created = await accessor.insert(input);
-      await fireDerivedSignal(fire, table.signals.created.id, created);
+      await fireDerivedSignal(fire, table.signals.created, created);
       return created;
     },
     async remove(id: StoreIdentifierOf<TTable>) {
@@ -1095,7 +1092,7 @@ const bindWritableAccessorSignals = <TTable extends AnyStoreTable>(
       const existing = await accessor.get(id);
       const removed = await accessor.remove(id);
       if (removed.deleted && existing !== null) {
-        await fireDerivedSignal(fire, table.signals.removed.id, existing);
+        await fireDerivedSignal(fire, table.signals.removed, existing);
       }
       return removed;
     },
@@ -1106,14 +1103,14 @@ const bindWritableAccessorSignals = <TTable extends AnyStoreTable>(
         // and fire unconditionally on successful update.
         const updated = await accessor.update(id, input);
         if (updated !== null) {
-          await fireDerivedSignal(fire, table.signals.updated.id, updated);
+          await fireDerivedSignal(fire, table.signals.updated, updated);
         }
         return updated;
       }
       const existing = await accessor.get(id);
       const updated = await accessor.update(id, input);
       if (changedEntity(existing, updated)) {
-        await fireDerivedSignal(fire, table.signals.updated.id, updated);
+        await fireDerivedSignal(fire, table.signals.updated, updated);
       }
       return updated;
     },
@@ -1128,12 +1125,12 @@ const bindWritableAccessorSignals = <TTable extends AnyStoreTable>(
       const written = await accessor.upsert(input);
 
       if (existing === null) {
-        await fireDerivedSignal(fire, table.signals.created.id, written);
+        await fireDerivedSignal(fire, table.signals.created, written);
         return written;
       }
 
       if (changedEntity(existing, written)) {
-        await fireDerivedSignal(fire, table.signals.updated.id, written);
+        await fireDerivedSignal(fire, table.signals.updated, written);
       }
       return written;
     },
@@ -1238,7 +1235,7 @@ const connectionHealth = (
  * `Database` client is tracked via `WeakMap`).
  *
  * Note: the `search` field on `StoreTableInput` is not yet interpreted by
- * this connector — it is reserved for future full-text search support.
+ * this adapter — it is reserved for future full-text search support.
  */
 export const connectDrizzle = <const TStore extends AnyStoreDefinition>(
   definition: TStore,
@@ -1264,6 +1261,14 @@ export const connectDrizzle = <const TStore extends AnyStoreDefinition>(
             throw error;
           }
           const db = drizzle({ client, schema: tables });
+          if (options.seed !== undefined) {
+            try {
+              seedFixtures(store, tables, db, options.seed);
+            } catch (error) {
+              client.close();
+              throw error;
+            }
+          }
           return Result.ok(createWritableConnection(store, tables, db, client));
         } catch (error) {
           return Result.err(

package/src/schema.ts

@@ -200,7 +200,7 @@ const inferFieldKind = (
     }
     default: {
       throw new ValidationError(
-        `Store field "${field}" uses unsupported schema type "${schema.def.type}" for the Drizzle SQLite connector`
+        `Store field "${field}" uses unsupported schema type "${schema.def.type}" for the Drizzle SQLite adapter`
       );
     }
   }

package/src/types.ts

@@ -3,7 +3,8 @@ import type {
   AnyStoreDefinition,
   ReadOnlyStoreConnection,
   StoreAccessMode,
-  StoreConnectorOptions,
+  StoreAdapterOptions,
+  StoreMockSeed,
   StoreTableConnection,
 } from '@ontrails/store';
 import type { BunSQLiteDatabase } from 'drizzle-orm/bun-sqlite';
@@ -21,17 +22,32 @@ export interface DrizzleQueryContext<TStore extends AnyStoreDefinition> {
 }
 
 /**
- * Options accepted by the Drizzle store connector.
+ * Options accepted by the Drizzle store adapter.
  *
- * Extends {@link StoreConnectorOptions} with drizzle-specific fields. The
+ * Extends {@link StoreAdapterOptions} with drizzle-specific fields. The
  * read-only vs writable distinction is enforced by the factory that consumes
  * these options, not by the options type itself.
  */
 export interface DrizzleStoreOptions<
   TDef extends AnyStoreDefinition = AnyStoreDefinition,
-> extends StoreConnectorOptions<TDef> {
+> extends StoreAdapterOptions<TDef> {
   /** Path to the SQLite database file. Use `":memory:"` for ephemeral runs. */
   readonly url: string;
+  /**
+   * Optional fixture overrides applied when the writable runtime database is
+   * first created.
+   *
+   * Mirrors {@link StoreAdapterOptions.mockSeed} but for the `create`
+   * (runtime) path: when supplied, the adapter seeds these rows into the
+   * writable database immediately after schema initialization. Use this for
+   * demo/dogfood apps that want commands and examples to find pre-loaded
+   * entities on a fresh `:memory:` boot. Defaults to `undefined` — runtime
+   * databases are not auto-seeded from `table.fixtures`.
+   *
+   * Has no effect on the read-only adapter, which receives runtime data
+   * from disk rather than from fixtures.
+   */
+  readonly seed?: StoreMockSeed<TDef>;
 }
 
 export type ReadOnlyDrizzleStoreConnection<TStore extends AnyStoreDefinition> =

package/.turbo/turbo-build.log

@@ -1 +0,0 @@
-$ tsc -b

package/.turbo/turbo-lint.log

@@ -1,3 +0,0 @@
-$ oxlint ./src
-Found 0 warnings and 0 errors.
-Finished in 62ms on 5 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

@@ -1 +0,0 @@
-$ tsc --noEmit

package/dist/index.d.ts

@@ -1,3 +0,0 @@
-export { connectDrizzle, connectReadOnlyDrizzle } from './runtime.js';
-export type { DrizzleQueryContext, DrizzleStoreConnection, DrizzleStoreOptions, DrizzleStoreResource, DrizzleStoreSchema, ReadOnlyDrizzleStoreConnection, } from './types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +0,0 @@
-export { connectDrizzle, connectReadOnlyDrizzle } from './runtime.js';
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/runtime.d.ts

@@ -1,17 +0,0 @@
-import type { AnyStoreDefinition } from '@ontrails/store';
-import type { DrizzleStoreConnection, DrizzleStoreOptions, DrizzleStoreResource, ReadOnlyDrizzleStoreConnection } from './types.js';
-/**
- * Bind a store definition to a Drizzle-backed SQLite resource.
- *
- * The returned resource manages its own connection lifecycle. The `mock()`
- * factory creates an in-memory SQLite database seeded with fixtures — callers
- * who obtain a mock connection are responsible for calling `closeConnection()`
- * when done, or letting the connection be garbage-collected (the underlying
- * `Database` client is tracked via `WeakMap`).
- *
- * Note: the `search` field on `StoreTableInput` is not yet interpreted by
- * this connector — it is reserved for future full-text search support.
- */
-export declare const connectDrizzle: <const TStore extends AnyStoreDefinition>(definition: TStore, options: DrizzleStoreOptions<TStore>) => DrizzleStoreResource<TStore, DrizzleStoreConnection<TStore>, "readwrite">;
-export declare const connectReadOnlyDrizzle: <const TStore extends AnyStoreDefinition>(definition: TStore, options: DrizzleStoreOptions<TStore>) => DrizzleStoreResource<TStore, ReadOnlyDrizzleStoreConnection<TStore>, "readonly">;
-//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,kBAAkB,EAcnB,MAAM,iBAAiB,CAAC;AAYzB,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EAEpB,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AA+pCpB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,CAAC,MAAM,SAAS,kBAAkB,EACpE,YAAY,MAAM,EAClB,SAAS,mBAAmB,CAAC,MAAM,CAAC,KACnC,oBAAoB,CACrB,MAAM,EACN,sBAAsB,CAAC,MAAM,CAAC,EAC9B,WAAW,CAqDZ,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,KAAK,CAAC,MAAM,SAAS,kBAAkB,EAC5E,YAAY,MAAM,EAClB,SAAS,mBAAmB,CAAC,MAAM,CAAC,KACnC,oBAAoB,CACrB,MAAM,EACN,8BAA8B,CAAC,MAAM,CAAC,EACtC,UAAU,CAoCX,CAAC"}