@ontrails/store 1.0.0-beta.14 → 1.0.0-beta.15

package/.turbo/turbo-lint.log

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

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @ontrails/store
 
+## 1.0.0-beta.15
+
+### Patch Changes
+
+- Updated dependencies [4ad6b25]
+  - @ontrails/core@1.0.0-beta.15
+
 ## 1.0.0-beta.14
 
 ### Minor Changes

package/README.md

@@ -2,7 +2,7 @@
 
 Schema-derived persistence for Trails.
 
-The root package owns the connector-agnostic `store(...)` declaration. Connector packages such as `@ontrails/store/drizzle` bind that declaration to a concrete runtime, just like a trailhead connector binds a topo to CLI, MCP, or HTTP.
+The root package owns the connector-agnostic `store(...)` declaration. External connector packages such as `@ontrails/drizzle` bind that declaration to a concrete runtime, and first-party built-ins such as `@ontrails/store/jsonfile` live as opt-in subpaths on the same package.
 
 ## The two layers
 
@@ -14,13 +14,14 @@ import { store } from '@ontrails/store';
 export const db = store({
   gists: {
     schema: gistSchema,
-    primaryKey: 'id',
+    identity: 'id',
     generated: ['id', 'createdAt', 'updatedAt'],
-    indexes: ['owner', 'createdAt'],
+    indexed: ['owner', 'createdAt'],
+    versioned: true,
   },
   files: {
     schema: fileSchema,
-    primaryKey: 'id',
+    identity: 'id',
     generated: ['id'],
     references: { gistId: 'gists' },
   },
@@ -33,8 +34,11 @@ This declaration is pure metadata:
 - insert schema
 - update schema
 - fixture schema
+- derived change-signal handles (`table.signals.created|updated|removed`)
+- identity field
 - generated-field metadata
-- indexes
+- optional framework-managed version tracking
+- indexed markers
 - references
 
 No database connection is opened here. The returned value is the durable authored source of truth.
@@ -43,12 +47,12 @@ No database connection is opened here. The returned value is the durable authore
 
 ```typescript
 import { store } from '@ontrails/store';
-import { connectDrizzle } from '@ontrails/store/drizzle';
+import { connectDrizzle } from '@ontrails/drizzle';
 
 const definition = store({
   gists: {
     schema: gistSchema,
-    primaryKey: 'id',
+    identity: 'id',
     generated: ['id', 'createdAt', 'updatedAt'],
   },
 });
@@ -59,11 +63,11 @@ export const db = connectDrizzle(definition, {
 });
 ```
 
-The bound store is a provision. Use it directly in trails:
+The bound store is a resource. Use it directly in trails:
 
 ```typescript
 export const list = trail('gist.list', {
-  provisions: [db],
+  resources: [db],
   intent: 'read',
   blaze: async (_input, ctx) => {
     const conn = db.from(ctx);
@@ -73,32 +77,76 @@ export const list = trail('gist.list', {
 });
 ```
 
+### Built-in local backend
+
+For a zero-extra-package local backend, use the first-party JSON file binding:
+
+```typescript
+import { store } from '@ontrails/store';
+import { jsonFile } from '@ontrails/store/jsonfile';
+
+const definition = store({
+  gists: {
+    schema: gistSchema,
+    identity: 'id',
+    generated: ['id', 'createdAt', 'updatedAt'],
+  },
+});
+
+export const db = jsonFile(definition, {
+  dir: './data',
+});
+```
+
 ## Typed accessors
 
-Every table on a bound connection exposes typed CRUD accessors:
+Every writable table on a bound connection exposes the connector-agnostic accessor contract:
 
 ```typescript
 const conn = db.from(ctx);
 
-const created = await conn.gists.insert({
-  owner: 'matt',
+const created = await conn.gists.upsert({
+  ownerId: 'matt',
   description: 'Hello, Trails',
 });
 
 const found = await conn.gists.get(created.id);
-const page = await conn.gists.list({ owner: 'matt' }, { limit: 20, offset: 0 });
-const updated = await conn.gists.update(created.id, {
+const page = await conn.gists.list({ ownerId: 'matt' }, { limit: 20, offset: 0 });
+const updated = await conn.gists.upsert({
   description: 'Updated description',
+  id: created.id,
+  ownerId: 'matt',
 });
 const removed = await conn.gists.remove(created.id);
 ```
 
 Types are derived from the Zod schema:
 
-- `insert()` uses the entity schema minus generated fields
-- `update()` uses the entity schema minus generated fields, then makes it partial
+- `upsert()` uses the fixture/entity shape with generated fields optional
 - `get()` returns `Entity | null`
 - `list()` accepts typed partial filters and pagination options
+- `versioned: true` adds a framework-managed `version` field to returned entities and lets `upsert()` accept an expected `version` for optimistic concurrency
+
+Each normalized table also derives typed change signals from the same schema:
+
+```typescript
+const createdHandle = definition.tables.gists.signals.created;
+const updatedHandle = definition.tables.gists.signals.updated;
+const removedHandle = definition.tables.gists.signals.removed;
+```
+
+These pre-bind handles preserve payload shape, but the canonical signal id materializes only when a connector binds the store to a resource. The bound form is always `resource:table.event`:
+
+```typescript
+const created = db.store.tables.gists.signals.created;
+
+created.id;
+// "db.main:gists.created"
+```
+
+Writable bindings fire those canonical scoped signals automatically when you access the resource through `db.from(ctx)` inside a trail context.
+
+Tabular connectors such as `@ontrails/drizzle` also expose `insert()` and `update()` as convenience methods when the backend natively distinguishes create and patch operations.
 
 ## Fixtures and mocks
 
@@ -108,44 +156,43 @@ Fixtures belong on the root definition:
 export const db = store({
   gists: {
     schema: gistSchema,
-    primaryKey: 'id',
+    identity: 'id',
     generated: ['id', 'createdAt', 'updatedAt'],
     fixtures: [
-      { id: 'g_1', owner: 'matt', description: 'Seed gist' },
+      { id: 'g_1', ownerId: 'matt', description: 'Seed gist' },
     ],
   },
 });
 ```
 
-When a connector binds the store, those fixtures feed the provision mock automatically. Connector options can also add or override seed data for tests.
+When a connector binds the store, those fixtures feed the resource mock automatically. Connector options can also add or override seed data for tests.
 
-That means `testAll(app)` can auto-resolve connector-bound store provisions without extra ceremony, as long as the provision is registered in the topo.
+That means `testAll(app)` can auto-resolve connector-bound store resources without extra ceremony, as long as the resource is registered in the topo.
 
 ## Read-only bindings
 
-Use the Drizzle connector's read-only helpers when a trail should inspect persisted state without exposing writes:
+Use the Drizzle connector's read-only binding when a trail should inspect persisted state without exposing writes:
 
 ```typescript
-import { connectReadOnlyDrizzle, readonlyStore } from '@ontrails/store/drizzle';
+import { connectReadOnlyDrizzle } from '@ontrails/drizzle';
 
 const analytics = connectReadOnlyDrizzle(definition, {
   id: 'analytics.db',
   url: './data/analytics.sqlite',
 });
+```
 
-const auditLog = readonlyStore(
-  {
-    entries: {
-      schema: auditEntrySchema,
-      primaryKey: 'id',
-      generated: ['id', 'createdAt'],
-    },
-  },
-  { id: 'audit.db', url: './data/audit.sqlite' }
-);
+Read-only bindings expose `get()`, `list()`, and `query()`, but not `upsert()`, `remove()`, `insert()`, or `update()`.
+
+## Accessor contract testing
+
+Connectors can reuse the shared writable-accessor contract tests from `@ontrails/store/testing`:
+
+```typescript
+import { createStoreAccessorContractCases } from '@ontrails/store/testing';
 ```
 
-Read-only bindings expose `get()`, `list()`, and `query()`, but not `insert()`, `update()`, or `remove()`.
+That helper provides reusable cases for the baseline `get()`, `list()`, `upsert()`, and `remove()` behavior so connector suites only need to wrap them with their normal `test(...)` calls and add backend-specific coverage on top.
 
 ## Drizzle escape hatch
 
@@ -163,51 +210,69 @@ const rows = await conn.query(({ drizzle, tables }) =>
 
 This keeps the default happy path derived and typed, while still giving you full access to the underlying connector when the CRUD accessors are not enough.
 
-## Connector conveniences
+## Connector binding
 
-`@ontrails/store/drizzle` also exports one-line conveniences when you want declaration and binding together:
+`@ontrails/drizzle` keeps the durable `store(...)` declaration in
+`@ontrails/store` and binds it to a concrete runtime:
 
 ```typescript
-import { store, readonlyStore } from '@ontrails/store/drizzle';
-
-export const writable = store(
-  {
-    gists: {
-      schema: gistSchema,
-      primaryKey: 'id',
-      generated: ['id', 'createdAt', 'updatedAt'],
-    },
-  },
-  { url: ':memory:' }
-);
+import { connectDrizzle, connectReadOnlyDrizzle } from '@ontrails/drizzle';
+import { store } from '@ontrails/store';
 
-export const readonly = readonlyStore(
-  {
-    gists: {
-      schema: gistSchema,
-      primaryKey: 'id',
-      generated: ['id', 'createdAt', 'updatedAt'],
-    },
+const definition = store({
+  gists: {
+    schema: gistSchema,
+    identity: 'id',
+    generated: ['id', 'createdAt', 'updatedAt'],
   },
-  { url: './data/gists.sqlite' }
-);
+});
+
+export const writable = connectDrizzle(definition, { url: ':memory:' });
+
+export const readonly = connectReadOnlyDrizzle(definition, {
+  url: './data/gists.sqlite',
+});
 ```
 
-These are conveniences, not the architectural source of truth. The root package still owns the durable authored `store(...)` model.
+The root package still owns the authored persistence model; connector packages
+project that model into runnable resources.
 
 ## Schema export for external tooling
 
-If you need the raw derived Drizzle tables for tooling such as `drizzle-kit`, use `getSchema()`:
+If you need the raw derived Drizzle tables for tooling such as `drizzle-kit`,
+read them from the bound resource's `tables` field:
 
 ```typescript
-import { getSchema } from '@ontrails/store/drizzle';
+import { connectDrizzle } from '@ontrails/drizzle';
+import { store } from '@ontrails/store';
+
+const definition = store({
+  gists: {
+    schema: gistSchema,
+    identity: 'id',
+    generated: ['id', 'createdAt', 'updatedAt'],
+  },
+});
 
-const schema = getSchema(db);
+const db = connectDrizzle(definition, { url: ':memory:' });
+const schema = db.tables;
 ```
 
 ## Installation
 
 ```bash
 bun add @ontrails/store zod
-bun add drizzle-orm
 ```
+
+Add Drizzle only when you want the external SQLite/ORM connector:
+
+```bash
+bun add @ontrails/drizzle
+```
+
+## Migration
+
+The Drizzle binding now lives in `@ontrails/drizzle`.
+
+- Replace `import { ... } from '@ontrails/store/drizzle'` with `import { ... } from '@ontrails/drizzle'`
+- Keep connector-agnostic store declarations on `@ontrails/store`

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { entitySchemaOf, fixtureSchemaOf, insertSchemaOf, store, updateSchemaOf, } from './store.js';
-export type { AnyStoreDefinition, AnyStoreTable, EntityOf, FiltersOf, FixtureInputOf, FixtureOf, FixturesOfInput, GeneratedFieldsOfInput, GeneratedKeysOf, IndexFieldsOfInput, InsertOf, PrimaryKeyOf, ReadOnlyStoreConnection, ReadOnlyStoreTableAccessor, ReferencesOfInput, StoreAccessMode, StoreConnection, StoreDefinition, StoreFieldKey, StoreFixtureInput, StoreFixtureRow, StoreIdentifierOf, StoreListOptions, StoreObjectSchema, StoreSearchDefinition, StoreTable, StoreTableAccessor, StoreTableInput, StoreTablesInput, UpdateOf, } from './types.js';
+export { store, versionFieldName } from './store.js';
+export type { AnyStoreDefinition, AnyStoreTable, EntityOf, FiltersOf, FixtureInputOf, FixtureOf, FixturesOfInput, GeneratedFieldsOfInput, GeneratedKeysOf, IdentityFieldOfInput, IdentityOf, IndexFieldsOfInput, IndexedFieldsOfInput, InsertOf, ReadOnlyStoreConnection, StoreAccessor, ReadOnlyStoreTableAccessor, ReferencesOfInput, StoreAccessMode, StoreConnection, StoreConnectorOptions, StoreDefinition, StoreFieldKey, StoreFixtureInput, StoreFixtureRow, StoreIdentifierOf, StoreKind, StoreListOptions, StoreMockSeed, StoreObjectSchema, StoreOptions, StoreSearchDefinition, StoreTable, StoreTableSignals, StoreTableAccessor, StoreTableConnection, StoreTableInput, StoreTablesInput, UpsertOf, UpdateOf, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,KAAK,EACL,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,QAAQ,EACR,SAAS,EACT,cAAc,EACd,SAAS,EACT,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,QAAQ,GACT,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,QAAQ,EACR,SAAS,EACT,cAAc,EACd,SAAS,EACT,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,QAAQ,EACR,uBAAuB,EACvB,aAAa,EACb,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,QAAQ,GACT,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { entitySchemaOf, fixtureSchemaOf, insertSchemaOf, store, updateSchemaOf, } from './store.js';
+export { store, versionFieldName } from './store.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,KAAK,EACL,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/internal/signal-identity.d.ts

@@ -0,0 +1,17 @@
+import type { z } from 'zod';
+import type { AnyStoreDefinition, StoreTableSignals } from '../types.js';
+type StoreSignalEvent = 'created' | 'removed' | 'updated';
+export declare const createStoreTableSignals: <TPayload>(tableName: string, payload: z.ZodType<TPayload>) => StoreTableSignals<TPayload>;
+export declare const composeStoreSignalId: (scope: string, tableName: string, event: StoreSignalEvent) => string;
+/**
+ * Verifies that a resource id is safe to compose into a scoped signal id.
+ *
+ * Scoped signal ids are matched by the `SCOPED_SIGNAL_ID` pattern in
+ * `@ontrails/core` (`^[^:\s]+:[^:.\s]+(?:\.[^:.\s]+)+$`). A resource id used
+ * as the scope segment must therefore be a non-empty string that contains
+ * neither `":"` nor any whitespace.
+ */
+export declare const isValidResourceId: (resourceId: string) => boolean;
+export declare const bindStoreDefinition: <TStore extends AnyStoreDefinition>(definition: TStore, scope: string) => TStore;
+export type { StoreSignalEvent };
+//# sourceMappingURL=signal-identity.d.ts.map

package/dist/internal/signal-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-identity.d.ts","sourceRoot":"","sources":["../../src/internal/signal-identity.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EACV,kBAAkB,EAElB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAMrB,KAAK,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAsC1D,eAAO,MAAM,uBAAuB,GAAI,QAAQ,EAC9C,WAAW,MAAM,EACjB,SAAS,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAC3B,iBAAiB,CAAC,QAAQ,CAKzB,CAAC;AAEL,eAAO,MAAM,oBAAoB,GAC/B,OAAO,MAAM,EACb,WAAW,MAAM,EACjB,OAAO,gBAAgB,KACtB,MAA0C,CAAC;AAkC9C;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,KAAG,OACuB,CAAC;AAU/E,eAAO,MAAM,mBAAmB,GAAI,MAAM,SAAS,kBAAkB,EACnE,YAAY,MAAM,EAClB,OAAO,MAAM,KACZ,MAiCF,CAAC;AAEF,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/internal/signal-identity.js

@@ -0,0 +1,81 @@
+import { signal, ValidationError } from '@ontrails/core';
+import { attachLateBoundSignalRef, cloneSignalWithId, } from '@ontrails/core/internal/signal-ref';
+const createStoreSignalDescription = (tableName, event) => {
+    switch (event) {
+        case 'created': {
+            return `Fired after a "${tableName}" entity is created.`;
+        }
+        case 'removed': {
+            return `Fired after a "${tableName}" entity is removed.`;
+        }
+        case 'updated': {
+            return `Fired after a "${tableName}" entity is updated.`;
+        }
+        default: {
+            throw new Error(`Unsupported store signal event: ${event}`);
+        }
+    }
+};
+const createStoreSignal = (tableName, event, payload) => attachLateBoundSignalRef(signal(`${tableName}.${event}`, {
+    description: createStoreSignalDescription(tableName, event),
+    payload,
+}), {
+    kind: 'store-derived',
+    token: Bun.randomUUIDv7(),
+});
+export const createStoreTableSignals = (tableName, payload) => Object.freeze({
+    created: createStoreSignal(tableName, 'created', payload),
+    removed: createStoreSignal(tableName, 'removed', payload),
+    updated: createStoreSignal(tableName, 'updated', payload),
+});
+export const composeStoreSignalId = (scope, tableName, event) => `${scope}:${tableName}.${event}`;
+const bindTableSignals = (scope, table) => Object.freeze({
+    created: cloneSignalWithId(table.signals.created, composeStoreSignalId(scope, table.name, 'created')),
+    removed: cloneSignalWithId(table.signals.removed, composeStoreSignalId(scope, table.name, 'removed')),
+    updated: cloneSignalWithId(table.signals.updated, composeStoreSignalId(scope, table.name, 'updated')),
+});
+const collectStoreSignals = (normalized, tableNames) => Object.freeze(tableNames.flatMap((name) => {
+    const table = normalized[name];
+    return table === undefined
+        ? []
+        : [table.signals.created, table.signals.updated, table.signals.removed];
+}));
+/**
+ * Verifies that a resource id is safe to compose into a scoped signal id.
+ *
+ * Scoped signal ids are matched by the `SCOPED_SIGNAL_ID` pattern in
+ * `@ontrails/core` (`^[^:\s]+:[^:.\s]+(?:\.[^:.\s]+)+$`). A resource id used
+ * as the scope segment must therefore be a non-empty string that contains
+ * neither `":"` nor any whitespace.
+ */
+export const isValidResourceId = (resourceId) => resourceId.length > 0 && !resourceId.includes(':') && !/\s/.test(resourceId);
+const assertValidScope = (scope) => {
+    if (!isValidResourceId(scope)) {
+        throw new ValidationError(`Store resource id "${scope}" is invalid: must be a non-empty string with no ":" characters and no whitespace.`);
+    }
+};
+export const bindStoreDefinition = (definition, scope) => {
+    assertValidScope(scope);
+    const tableNames = definition.tableNames;
+    const tables = {};
+    for (const tableName of tableNames) {
+        const table = definition.tables[tableName];
+        if (table === undefined) {
+            continue;
+        }
+        tables[tableName] = Object.freeze({
+            ...table,
+            signals: bindTableSignals(scope, table),
+        });
+    }
+    const get = 'get' in definition && typeof definition.get === 'function'
+        ? (name) => tables[name]
+        : undefined;
+    return Object.freeze({
+        ...definition,
+        ...(get ? { get } : {}),
+        signals: collectStoreSignals(tables, tableNames),
+        tables: Object.freeze(tables),
+    });
+};
+//# sourceMappingURL=signal-identity.js.map

package/dist/internal/signal-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-identity.js","sourceRoot":"","sources":["../../src/internal/signal-identity.ts"],"names":[],"mappings":"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"}

package/dist/jsonfile/index.d.ts

@@ -0,0 +1,3 @@
+export { connectJsonFile, jsonFile, jsonFile as store } from './runtime.js';
+export type { JsonFileConnection, JsonFileStoreOptions, JsonFileStoreResource, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/jsonfile/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jsonfile/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,IAAI,KAAK,EAAE,MAAM,cAAc,CAAC;AAC5E,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/jsonfile/index.js

@@ -0,0 +1,2 @@
+export { connectJsonFile, jsonFile, jsonFile as store } from './runtime.js';
+//# sourceMappingURL=index.js.map

package/dist/jsonfile/index.js.map

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

package/dist/jsonfile/runtime.d.ts

@@ -0,0 +1,19 @@
+import type { AnyStoreDefinition } from '../types.js';
+import type { JsonFileConnection, JsonFileStoreOptions, JsonFileStoreResource } from './types.js';
+/**
+ * Connect to a JSON-file-backed store.
+ *
+ * Creates one `<tableName>.json` file per table in the target directory.
+ * Each file holds a JSON array of entities. The entire dataset is loaded
+ * into memory on connect and flushed to disk on every write.
+ */
+export declare const connectJsonFile: <TStore extends AnyStoreDefinition>(definition: TStore, options: JsonFileStoreOptions<TStore>) => Promise<JsonFileConnection<TStore["tables"]>>;
+/**
+ * Create a JSON-file-backed store resource.
+ *
+ * Returns a `Resource` that can be registered in a topo and resolved from
+ * trail context via `db.from(ctx)`.
+ */
+export declare const jsonFile: <TStore extends AnyStoreDefinition>(definition: TStore, options: JsonFileStoreOptions<TStore>) => JsonFileStoreResource<TStore["tables"]>;
+export { jsonFile as store };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/jsonfile/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/jsonfile/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EASnB,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAglBpB;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAU,MAAM,SAAS,kBAAkB,EACrE,YAAY,MAAM,EAClB,SAAS,oBAAoB,CAAC,MAAM,CAAC,KACpC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAmB9C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,SAAS,kBAAkB,EACxD,YAAY,MAAM,EAClB,SAAS,oBAAoB,CAAC,MAAM,CAAC,KACpC,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAgDxC,CAAC;AAEF,OAAO,EAAE,QAAQ,IAAI,KAAK,EAAE,CAAC"}