@furystack/repository 10.1.10 → 11.0.0

package/esm/define-data-set.d.ts

@@ -0,0 +1,89 @@
+import type { Constructable, StoreToken, WithOptionalId } from '@furystack/core';
+import type { Token } from '@furystack/inject';
+import type { DataSetSettings } from './data-set-setting.js';
+import { DataSet } from './data-set.js';
+/**
+ * A DI token that resolves to a {@link DataSet} and carries its model and
+ * primary key metadata (mirrored from the backing {@link StoreToken}).
+ *
+ * Consumers can `injector.get(token)` to obtain the dataset, or read the
+ * `model` / `primaryKey` fields to drive reflection-style tooling such as
+ * entity sync and OpenAPI generation.
+ */
+export type DataSetToken<T, TPrimaryKey extends keyof T, TWritableData = WithOptionalId<T, TPrimaryKey>> = Token<DataSet<T, TPrimaryKey, TWritableData>, 'singleton'> & {
+    readonly model: Constructable<T>;
+    readonly primaryKey: TPrimaryKey;
+};
+/**
+ * Settings accepted by {@link defineDataSet}. A subset of
+ * {@link DataSetSettings}: the physical store is supplied by the store token
+ * and must not be passed here.
+ */
+export type DefineDataSetSettings<T, TPrimaryKey extends keyof T, TWritableData = WithOptionalId<T, TPrimaryKey>> = Omit<DataSetSettings<T, TPrimaryKey, TWritableData>, 'physicalStore'>;
+/**
+ * Options accepted by {@link defineDataSet}.
+ *
+ * `settings` is wrapped in `NoInfer` so the `store` token alone fixes the
+ * generic parameters. Without it, an inline callback inside `settings`
+ * (e.g. a `modifyOnAdd` arrow) triggers bidirectional inference where
+ * TypeScript widens `TPrimaryKey` back to `keyof T` to satisfy the
+ * callback's contextual typing.
+ */
+export type DefineDataSetOptions<T, TPrimaryKey extends keyof T, TWritableData = WithOptionalId<T, TPrimaryKey>> = {
+    /**
+     * Human-readable identifier used for debug/readability. Token identity is
+     * established by the returned {@link DataSetToken} object reference.
+     */
+    name: string;
+    /**
+     * The store this data set is backed by. Its `model` and `primaryKey` are
+     * propagated onto the returned token.
+     */
+    store: StoreToken<T, TPrimaryKey>;
+    /**
+     * Authorizers, modification hooks and filter post-processors. Optional —
+     * a data set without settings performs no authorization and forwards
+     * operations straight to the physical store.
+     */
+    settings?: NoInfer<DefineDataSetSettings<T, TPrimaryKey, TWritableData>>;
+};
+/**
+ * Defines a {@link DataSet} as a first-class DI token backed by a
+ * {@link StoreToken}.
+ *
+ * The returned token resolves to a singleton `DataSet`. On the first
+ * resolution the factory:
+ *
+ * 1. Resolves the backing physical store through the injector.
+ * 2. Constructs a {@link DataSet} with the supplied {@link DefineDataSetSettings}
+ *    and that store.
+ * 3. Registers a disposal callback that clears the DataSet's event
+ *    subscriptions when the owning injector is disposed.
+ *
+ * The token also carries the `model` and `primaryKey` of the backing store so
+ * that downstream tooling (entity sync, OpenAPI generators, test harnesses)
+ * can discover the dataset's shape without additional wiring.
+ *
+ * @example
+ * ```ts
+ * const UserStore = defineStore({
+ *   name: 'my-app/UserStore',
+ *   model: User,
+ *   primaryKey: 'username',
+ *   factory: () => new InMemoryStore({ model: User, primaryKey: 'username' }),
+ * })
+ *
+ * export const UserDataSet = defineDataSet({
+ *   name: 'my-app/UserDataSet',
+ *   store: UserStore,
+ *   settings: {
+ *     authorizeAdd: async ({ injector, entity }) => ({ isAllowed: true }),
+ *   },
+ * })
+ *
+ * const ds = injector.get(UserDataSet)
+ * await ds.add(injector, { username: 'alice', roles: [] })
+ * ```
+ */
+export declare const defineDataSet: <T, const TPrimaryKey extends keyof T, TWritableData = WithOptionalId<T, TPrimaryKey>>(options: DefineDataSetOptions<T, TPrimaryKey, TWritableData>) => DataSetToken<T, TPrimaryKey, TWritableData>;
+//# sourceMappingURL=define-data-set.d.ts.map

package/esm/define-data-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-data-set.d.ts","sourceRoot":"","sources":["../src/define-data-set.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAiB,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC/F,OAAO,KAAK,EAAkB,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAkBvC;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,WAAW,SAAS,MAAM,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI,KAAK,CAC9G,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,EACtC,WAAW,CACZ,GAAG;IACF,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAChC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAA;CACjC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,CAC/B,CAAC,EACD,WAAW,SAAS,MAAM,CAAC,EAC3B,aAAa,GAAG,cAAc,CAAC,CAAC,EAAE,WAAW,CAAC,IAC5C,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,eAAe,CAAC,CAAA;AAEzE;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,EAAE,WAAW,SAAS,MAAM,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI;IACjH;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,KAAK,EAAE,UAAU,CAAC,CAAC,EAAE,WAAW,CAAC,CAAA;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAA;CACzE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,KAAK,CAAC,WAAW,SAAS,MAAM,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC,EAAE,WAAW,CAAC,EAChH,SAAS,oBAAoB,CAAC,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,KAC3D,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,aAAa,CAsB5C,CAAA"}

package/esm/define-data-set.js

@@ -0,0 +1,75 @@
+import { defineService } from '@furystack/inject';
+import { DataSet } from './data-set.js';
+/**
+ * Resolves a {@link StoreToken} to a {@link PhysicalStore} whose
+ * `TWritableData` generic matches the owning data set. `StoreToken` defaults
+ * `TWritableData` to `WithOptionalId`, while a {@link DataSet} may narrow it
+ * (e.g. to strip system-owned fields). The write surface of `PhysicalStore`
+ * is contravariant in `TWritableData` — a store that accepts
+ * `WithOptionalId<T, TPK>` also accepts any narrower shape — but TypeScript
+ * cannot express that with the default generic, so the cast is localized
+ * here with this explanation rather than scattered at call sites.
+ */
+const resolvePhysicalStore = (ctx, store) => ctx.inject(store);
+/**
+ * Defines a {@link DataSet} as a first-class DI token backed by a
+ * {@link StoreToken}.
+ *
+ * The returned token resolves to a singleton `DataSet`. On the first
+ * resolution the factory:
+ *
+ * 1. Resolves the backing physical store through the injector.
+ * 2. Constructs a {@link DataSet} with the supplied {@link DefineDataSetSettings}
+ *    and that store.
+ * 3. Registers a disposal callback that clears the DataSet's event
+ *    subscriptions when the owning injector is disposed.
+ *
+ * The token also carries the `model` and `primaryKey` of the backing store so
+ * that downstream tooling (entity sync, OpenAPI generators, test harnesses)
+ * can discover the dataset's shape without additional wiring.
+ *
+ * @example
+ * ```ts
+ * const UserStore = defineStore({
+ *   name: 'my-app/UserStore',
+ *   model: User,
+ *   primaryKey: 'username',
+ *   factory: () => new InMemoryStore({ model: User, primaryKey: 'username' }),
+ * })
+ *
+ * export const UserDataSet = defineDataSet({
+ *   name: 'my-app/UserDataSet',
+ *   store: UserStore,
+ *   settings: {
+ *     authorizeAdd: async ({ injector, entity }) => ({ isAllowed: true }),
+ *   },
+ * })
+ *
+ * const ds = injector.get(UserDataSet)
+ * await ds.add(injector, { username: 'alice', roles: [] })
+ * ```
+ */
+export const defineDataSet = (options) => {
+    const token = defineService({
+        name: options.name,
+        lifetime: 'singleton',
+        factory: (ctx) => {
+            const physicalStore = resolvePhysicalStore(ctx, options.store);
+            const dataSet = new DataSet({
+                ...options.settings,
+                physicalStore,
+            });
+            // Disposal is delegated to the injector via `onDispose`; the dataset
+            // outlives this factory invocation and is torn down on scope teardown.
+            // eslint-disable-next-line furystack/prefer-using-wrapper
+            ctx.onDispose(() => dataSet[Symbol.dispose]());
+            return dataSet;
+        },
+    });
+    const result = Object.assign(token, {
+        model: options.store.model,
+        primaryKey: options.store.primaryKey,
+    });
+    return result;
+};
+//# sourceMappingURL=define-data-set.js.map

package/esm/define-data-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-data-set.js","sourceRoot":"","sources":["../src/define-data-set.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC;;;;;;;;;GASG;AACH,MAAM,oBAAoB,GAAG,CAC3B,GAAgC,EAChC,KAAiC,EACa,EAAE,CAChD,GAAG,CAAC,MAAM,CAAC,KAAK,CAA4D,CAAA;AAyD9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,OAA4D,EACf,EAAE;IAC/C,MAAM,KAAK,GAAG,aAAa,CAAC;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,CAAC,GAAgC,EAAE,EAAE;YAC5C,MAAM,aAAa,GAAG,oBAAoB,CAAgC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;YAC7F,MAAM,OAAO,GAAG,IAAI,OAAO,CAAgC;gBACzD,GAAG,OAAO,CAAC,QAAQ;gBACnB,aAAa;aACoC,CAAC,CAAA;YACpD,qEAAqE;YACrE,uEAAuE;YACvE,0DAA0D;YAC1D,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;YAC9C,OAAO,OAAO,CAAA;QAChB,CAAC;KACF,CAAC,CAAA;IACF,MAAM,MAAM,GAAgD,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;QAC/E,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK;QAC1B,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU;KACrC,CAAC,CAAA;IACF,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/esm/define-data-set.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=define-data-set.spec.d.ts.map

package/esm/define-data-set.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-data-set.spec.d.ts","sourceRoot":"","sources":["../src/define-data-set.spec.ts"],"names":[],"mappings":""}

package/esm/define-data-set.spec.js

@@ -0,0 +1,134 @@
+import { defineStore, InMemoryStore } from '@furystack/core';
+import { createInjector } from '@furystack/inject';
+import { usingAsync } from '@furystack/utils';
+import { describe, expect, it, vi } from 'vitest';
+import { DataSet } from './data-set.js';
+import { defineDataSet } from './define-data-set.js';
+class Test {
+}
+// Store tokens are declared at module scope so TypeScript keeps the literal
+// primary-key narrowing. Wrapping `defineStore` in an arrow function would
+// widen the inferred `TPrimaryKey` back to `keyof Test` in the return type.
+const BasicStore = defineStore({
+    name: 'test/BasicStore',
+    model: Test,
+    primaryKey: 'id',
+    factory: () => new InMemoryStore({ model: Test, primaryKey: 'id' }),
+});
+const SingletonStore = defineStore({
+    name: 'test/SingletonStore',
+    model: Test,
+    primaryKey: 'id',
+    factory: () => new InMemoryStore({ model: Test, primaryKey: 'id' }),
+});
+const MetaStore = defineStore({
+    name: 'test/MetaStore',
+    model: Test,
+    primaryKey: 'id',
+    factory: () => new InMemoryStore({ model: Test, primaryKey: 'id' }),
+});
+const HooksStore = defineStore({
+    name: 'test/HooksStore',
+    model: Test,
+    primaryKey: 'id',
+    factory: () => new InMemoryStore({ model: Test, primaryKey: 'id' }),
+});
+const EventsStore = defineStore({
+    name: 'test/EventsStore',
+    model: Test,
+    primaryKey: 'id',
+    factory: () => new InMemoryStore({ model: Test, primaryKey: 'id' }),
+});
+const DisposeStore = defineStore({
+    name: 'test/DisposeStore',
+    model: Test,
+    primaryKey: 'id',
+    factory: () => new InMemoryStore({ model: Test, primaryKey: 'id' }),
+});
+const RebindStore = defineStore({
+    name: 'test/RebindStore',
+    model: Test,
+    primaryKey: 'id',
+    factory: () => new InMemoryStore({ model: Test, primaryKey: 'id' }),
+});
+const modifyOnAddSpy = vi.fn();
+const BasicDataSet = defineDataSet({ name: 'test/BasicDataSet', store: BasicStore });
+const SingletonDataSet = defineDataSet({ name: 'test/SingletonDataSet', store: SingletonStore });
+const MetaDataSet = defineDataSet({ name: 'test/MetaDataSet', store: MetaStore });
+// The `settings` callback participates in bidirectional inference against the
+// surrounding generics. Even with `NoInfer` on the settings position, inline
+// callbacks currently widen `TPrimaryKey` to `keyof T` because TypeScript has
+// to contextually type the callback before it can commit to the store-driven
+// inference. The runtime value of `token.primaryKey` is still correct; only
+// the entity parameter is typed as the wider `WithOptionalId<Test, keyof Test>`.
+// The non-null assertion on `entity.value` reflects that widening.
+const HooksDataSet = defineDataSet({
+    name: 'test/HooksDataSet',
+    store: HooksStore,
+    settings: {
+        modifyOnAdd: async ({ entity }) => {
+            modifyOnAddSpy();
+            return { ...entity, value: entity.value.toUpperCase() };
+        },
+    },
+});
+const EventsDataSet = defineDataSet({ name: 'test/EventsDataSet', store: EventsStore });
+const DisposeDataSet = defineDataSet({ name: 'test/DisposeDataSet', store: DisposeStore });
+const RebindDataSet = defineDataSet({ name: 'test/RebindDataSet', store: RebindStore });
+describe('defineDataSet', () => {
+    it('resolves to a DataSet backed by the supplied store', async () => {
+        await usingAsync(createInjector(), async (i) => {
+            const ds = i.get(BasicDataSet);
+            expect(ds).toBeInstanceOf(DataSet);
+            expect(ds.settings.physicalStore).toBe(i.get(BasicStore));
+        });
+    });
+    it('caches the DataSet as a singleton across resolutions', async () => {
+        await usingAsync(createInjector(), async (i) => {
+            expect(i.get(SingletonDataSet)).toBe(i.get(SingletonDataSet));
+        });
+    });
+    it('mirrors the model and primary key from the backing store token', () => {
+        expect(MetaDataSet.model).toBe(Test);
+        expect(MetaDataSet.primaryKey).toBe('id');
+    });
+    it('applies the configured authorizers and hooks', async () => {
+        modifyOnAddSpy.mockClear();
+        await usingAsync(createInjector(), async (i) => {
+            const ds = i.get(HooksDataSet);
+            await ds.add(i, { id: 1, value: 'asd' });
+            const stored = await ds.get(i, 1);
+            expect(modifyOnAddSpy).toHaveBeenCalledTimes(1);
+            expect(stored?.value).toBe('ASD');
+        });
+    });
+    it('emits change events through the DataSet EventHub', async () => {
+        await usingAsync(createInjector(), async (i) => {
+            const added = vi.fn();
+            const ds = i.get(EventsDataSet);
+            ds.addListener('onEntityAdded', added);
+            await ds.add(i, { id: 1, value: 'x' });
+            expect(added).toHaveBeenCalledWith(expect.objectContaining({ entity: { id: 1, value: 'x' } }));
+        });
+    });
+    it('clears DataSet listeners when the injector is disposed', async () => {
+        const i = createInjector();
+        const ds = i.get(DisposeDataSet);
+        const listener = vi.fn();
+        ds.addListener('onEntityAdded', listener);
+        await i[Symbol.asyncDispose]();
+        // After disposal the DataSet's event subscriptions are cleared;
+        // emitting directly would be a no-op.
+        ds.emit('onEntityAdded', { injector: i, entity: { id: 1, value: 'x' } });
+        expect(listener).not.toHaveBeenCalled();
+    });
+    it('allows rebinding the backing store for tests', async () => {
+        await usingAsync(createInjector(), async (i) => {
+            const replacement = new InMemoryStore({ model: Test, primaryKey: 'id' });
+            i.bind(RebindStore, () => replacement);
+            const ds = i.get(RebindDataSet);
+            expect(ds.settings.physicalStore).toBe(replacement);
+        });
+    });
+});
+//# sourceMappingURL=define-data-set.spec.js.map

package/esm/define-data-set.spec.js.map

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

package/esm/helpers.d.ts

@@ -1,25 +1,25 @@
-import type { Constructable, Injector } from '@furystack/inject';
-import { Repository } from './repository.js';
+import type { WithOptionalId } from '@furystack/core';
+import type { Injector } from '@furystack/inject';
+import type { DataSet } from './data-set.js';
+import type { DataSetToken } from './define-data-set.js';
 /**
- * Returns a Repository on an injector
- * @param injector The Injector instance
- * @returns The Repository instance
- */
-export declare const getRepository: (injector: Injector) => Repository;
-/**
- * Gets a DataSet for a specific model from the repository.
+ * Resolves the {@link DataSet} identified by the supplied {@link DataSetToken}
+ * on the given injector.
  *
- * The DataSet is the recommended way to perform all entity mutations (add, update, remove).
- * Writing through the DataSet ensures that authorization, modification hooks, and change events
- * are properly triggered -- which is required for features like entity sync.
+ * Writing through the returned DataSet ensures authorization, modification
+ * hooks and change events (required for features such as entity sync) are
+ * triggered. Prefer this over direct physical-store access in application
+ * code.
  *
- * For server-side or background operations that don't originate from an HTTP request,
- * use {@link useSystemIdentityContext} to create a scoped child injector with elevated privileges.
+ * For server-side or background operations that don't originate from an HTTP
+ * request, use
+ * {@link import('@furystack/core').useSystemIdentityContext | useSystemIdentityContext}
+ * to create a scoped child injector with elevated privileges before calling
+ * this helper.
  *
- * @param injector The Injector instance
- * @param model The Model
- * @param primaryKey The Primary Key field
- * @returns A Repository DataSet for a specific model
+ * @param injector - Any injector in the scope chain.
+ * @param token - The data-set token created by `defineDataSet`.
+ * @returns The cached {@link DataSet} instance.
  *
  * @example
  * ```ts
@@ -27,15 +27,14 @@ export declare const getRepository: (injector: Injector) => Repository;
  * import { getDataSetFor } from '@furystack/repository'
  * import { usingAsync } from '@furystack/utils'
  *
- * // In a background job or service
  * await usingAsync(
  *   useSystemIdentityContext({ injector, username: 'background-job' }),
  *   async (systemInjector) => {
- *     const dataSet = getDataSetFor(systemInjector, MyModel, 'id')
- *     await dataSet.add(systemInjector, newEntity)
+ *     const dataSet = getDataSetFor(systemInjector, UserDataSet)
+ *     await dataSet.add(systemInjector, { username: 'alice', roles: [] })
  *   },
  * )
  * ```
  */
-export declare const getDataSetFor: <T, TPrimaryKey extends keyof T>(injector: Injector, model: Constructable<T>, primaryKey: TPrimaryKey) => import("./data-set.js").DataSet<T, TPrimaryKey, import("@furystack/core").WithOptionalId<T, TPrimaryKey>>;
+export declare const getDataSetFor: <T, TPrimaryKey extends keyof T, TWritableData = WithOptionalId<T, TPrimaryKey>>(injector: Injector, token: DataSetToken<T, TPrimaryKey, TWritableData>) => DataSet<T, TPrimaryKey, TWritableData>;
 //# sourceMappingURL=helpers.d.ts.map

package/esm/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,QAAQ,eAAqC,CAAA;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,WAAW,SAAS,MAAM,CAAC,EAC1D,UAAU,QAAQ,EAClB,OAAO,aAAa,CAAC,CAAC,CAAC,EACvB,YAAY,WAAW,8GAC6C,CAAA"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,WAAW,SAAS,MAAM,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC,EAAE,WAAW,CAAC,EAC1G,UAAU,QAAQ,EAClB,OAAO,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,KACjD,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,aAAa,CAAwB,CAAA"}

package/esm/helpers.js

@@ -1,24 +1,21 @@
-import { Repository } from './repository.js';
 /**
- * Returns a Repository on an injector
- * @param injector The Injector instance
- * @returns The Repository instance
- */
-export const getRepository = (injector) => injector.getInstance(Repository);
-/**
- * Gets a DataSet for a specific model from the repository.
+ * Resolves the {@link DataSet} identified by the supplied {@link DataSetToken}
+ * on the given injector.
  *
- * The DataSet is the recommended way to perform all entity mutations (add, update, remove).
- * Writing through the DataSet ensures that authorization, modification hooks, and change events
- * are properly triggered -- which is required for features like entity sync.
+ * Writing through the returned DataSet ensures authorization, modification
+ * hooks and change events (required for features such as entity sync) are
+ * triggered. Prefer this over direct physical-store access in application
+ * code.
  *
- * For server-side or background operations that don't originate from an HTTP request,
- * use {@link useSystemIdentityContext} to create a scoped child injector with elevated privileges.
+ * For server-side or background operations that don't originate from an HTTP
+ * request, use
+ * {@link import('@furystack/core').useSystemIdentityContext | useSystemIdentityContext}
+ * to create a scoped child injector with elevated privileges before calling
+ * this helper.
  *
- * @param injector The Injector instance
- * @param model The Model
- * @param primaryKey The Primary Key field
- * @returns A Repository DataSet for a specific model
+ * @param injector - Any injector in the scope chain.
+ * @param token - The data-set token created by `defineDataSet`.
+ * @returns The cached {@link DataSet} instance.
  *
  * @example
  * ```ts
@@ -26,15 +23,14 @@ export const getRepository = (injector) => injector.getInstance(Repository);
  * import { getDataSetFor } from '@furystack/repository'
  * import { usingAsync } from '@furystack/utils'
  *
- * // In a background job or service
  * await usingAsync(
  *   useSystemIdentityContext({ injector, username: 'background-job' }),
  *   async (systemInjector) => {
- *     const dataSet = getDataSetFor(systemInjector, MyModel, 'id')
- *     await dataSet.add(systemInjector, newEntity)
+ *     const dataSet = getDataSetFor(systemInjector, UserDataSet)
+ *     await dataSet.add(systemInjector, { username: 'alice', roles: [] })
  *   },
  * )
  * ```
  */
-export const getDataSetFor = (injector, model, primaryKey) => injector.getInstance(Repository).getDataSetFor(model, primaryKey);
+export const getDataSetFor = (injector, token) => injector.get(token);
 //# sourceMappingURL=helpers.js.map

package/esm/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAkB,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAA;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,QAAkB,EAClB,KAAuB,EACvB,UAAuB,EACvB,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,QAAkB,EAClB,KAAkD,EACV,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA"}

package/esm/index.d.ts

@@ -1,5 +1,5 @@
-export * from './repository.js';
-export * from './data-set.js';
 export * from './data-set-setting.js';
+export * from './data-set.js';
+export * from './define-data-set.js';
 export * from './helpers.js';
 //# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,cAAc,CAAA"}

package/esm/index.js

@@ -1,5 +1,5 @@
-export * from './repository.js';
-export * from './data-set.js';
 export * from './data-set-setting.js';
+export * from './data-set.js';
+export * from './define-data-set.js';
 export * from './helpers.js';
 //# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,cAAc,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@furystack/repository",
-  "version": "10.1.10",
+  "version": "11.0.0",
   "description": "Repository implementation for FuryStack",
   "type": "module",
   "scripts": {
@@ -38,13 +38,13 @@
   },
   "homepage": "https://github.com/furystack/furystack",
   "dependencies": {
-    "@furystack/core": "^16.0.3",
-    "@furystack/inject": "^12.0.35",
-    "@furystack/utils": "^8.2.4"
+    "@furystack/core": "^17.0.0",
+    "@furystack/inject": "^13.0.0",
+    "@furystack/utils": "^9.0.0"
   },
   "devDependencies": {
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.2"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.4"
   },
   "engines": {
     "node": ">=22.0.0"