@furystack/repository 10.1.11 → 11.0.1

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,41 +1,24 @@
-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.
- *
- * 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.
- *
- * 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.
- *
- * @param injector The Injector instance
- * @param model The Model
- * @param primaryKey The Primary Key field
- * @returns A Repository DataSet for a specific model
+ * Resolves the {@link DataSet} for `token` on `injector`. The preferred
+ * write gateway for application code — `furystack/no-direct-store-token`
+ * forbids resolving the underlying `StoreToken` directly. For server-side
+ * or background work, wrap `injector` with `useSystemIdentityContext` from
+ * `@furystack/core` to obtain an elevated identity before calling this.
  *
  * @example
  * ```ts
- * import { useSystemIdentityContext } from '@furystack/core'
- * 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;;;;;;;;;;;;;;;;;GAiBG;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,40 +1,20 @@
-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.
- *
- * 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.
- *
- * 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.
- *
- * @param injector The Injector instance
- * @param model The Model
- * @param primaryKey The Primary Key field
- * @returns A Repository DataSet for a specific model
+ * Resolves the {@link DataSet} for `token` on `injector`. The preferred
+ * write gateway for application code — `furystack/no-direct-store-token`
+ * forbids resolving the underlying `StoreToken` directly. For server-side
+ * or background work, wrap `injector` with `useSystemIdentityContext` from
+ * `@furystack/core` to obtain an elevated identity before calling this.
  *
  * @example
  * ```ts
- * import { useSystemIdentityContext } from '@furystack/core'
- * 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;;;;;;;;;;;;;;;;;GAiBG;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.11",
+  "version": "11.0.1",
   "description": "Repository implementation for FuryStack",
   "type": "module",
   "scripts": {
@@ -38,13 +38,13 @@
   },
   "homepage": "https://github.com/furystack/furystack",
   "dependencies": {
-    "@furystack/core": "^16.0.4",
-    "@furystack/inject": "^12.0.36",
-    "@furystack/utils": "^8.2.5"
+    "@furystack/core": "^17.1.0",
+    "@furystack/inject": "^13.0.1",
+    "@furystack/utils": "^9.0.1"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
-    "vitest": "^4.1.4"
+    "vitest": "^4.1.7"
   },
   "engines": {
     "node": ">=22.0.0"

package/src/data-set-setting.ts

@@ -1,90 +1,76 @@
-import type { FindOptions, PhysicalStore, WithOptionalId } from '@furystack/core'
+import type { AuthorizationError, FindOptions, PhysicalStore, WithOptionalId } from '@furystack/core'
 import type { Injector } from '@furystack/inject'
+import type { DataSet } from './data-set.js'
 
-/**
- * The result model returned by authorizers
- */
+/** Discriminated union returned by authorizer callbacks. */
 export type AuthorizationResult = SuccessfullyValidationResult | FailedValidationResult
 
 export interface SuccessfullyValidationResult {
-  /**
-   * Indicates if the validation was successful
-   */
   isAllowed: true
 }
 
 export interface FailedValidationResult {
-  /**
-   * Indicates if the validation was successful
-   */
-
   isAllowed: false
-  /**
-   * The error message string
-   */
+  /** Surfaced as the message of the thrown {@link AuthorizationError}. */
   message: string
 }
 
 /**
- * Model for authorizers
+ * Configuration for a {@link DataSet}: backing store + authorization +
+ * modification hooks + filter post-processing. Every callback is optional —
+ * an empty `DataSetSettings` performs no checks and forwards calls straight
+ * to the physical store.
+ *
+ * Authorization callbacks come in two flavours:
+ *
+ * - `authorizeX` — runs **before** the entity is loaded. Use for cheap,
+ *   identity-only checks ("is the user logged in?", "is the user an admin?").
+ *   When omitted, no pre-check is performed.
+ * - `authorizeXEntity` — runs **after** the entity is loaded, with the
+ *   loaded entity in scope. Use for ownership / row-level checks. Missing
+ *   entities skip the per-entity check entirely.
+ *
+ * A callback returning `{ isAllowed: false }` makes the operation throw
+ * {@link AuthorizationError}.
  */
 export interface DataSetSettings<T, TPrimaryKey extends keyof T, TWritableData = WithOptionalId<T, TPrimaryKey>> {
-  /**
-   * An instance of a physical store
-   */
   physicalStore: PhysicalStore<T, TPrimaryKey, TWritableData>
 
-  /**
-   * Authorizes the entity creation
-   */
+  /** Pre-persist authorization for `add`. */
   authorizeAdd?: (options: { injector: Injector; entity: TWritableData }) => Promise<AuthorizationResult>
 
-  /**
-   * modifies an entity before persisting on creation
-   */
+  /** Pre-persist mutation for `add` (default fields, hashing, normalisation). */
   modifyOnAdd?: (options: { injector: Injector; entity: TWritableData }) => Promise<TWritableData>
 
-  /**
-   * Authorizes entity updates (before the entity gets loaded from the store)
-   */
+  /** Pre-load authorization for `update`. Sees the change, not the entity. */
   authorizeUpdate?: (options: { injector: Injector; change: Partial<T> }) => Promise<AuthorizationResult>
 
-  /**
-   * Authorizes entity updates per loaded entity
-   */
+  /** Post-load authorization for `update`. Sees both the loaded entity and the change. */
   authorizeUpdateEntity?: (options: {
     injector: Injector
     entity: T
     change: Partial<T>
   }) => Promise<AuthorizationResult>
 
-  /**
-   * modifies an entity before persisting on update
-   */
+  /** Pre-persist mutation for `update`. */
   modifyOnUpdate?: (options: { injector: Injector; id: T[keyof T]; entity: Partial<T> }) => Promise<Partial<T>>
 
-  /**
-   * Authorizes entity removal (before the entity gets loaded from the store)
-   */
+  /** Pre-load authorization for `remove`. */
   authorizeRemove?: (options: { injector: Injector }) => Promise<AuthorizationResult>
 
-  /**
-   * Authorizes entity removal per loaded entity
-   */
+  /** Post-load authorization for `remove`, per loaded entity. */
   authorizeRemoveEntity?: (options: { injector: Injector; entity: T }) => Promise<AuthorizationResult>
 
-  /**
-   * Authorizes entity retrieval without entity loading
-   */
+  /** Pre-load authorization for `get` / `find` / `count`. No entity in scope. */
   authorizeGet?: (options: { injector: Injector }) => Promise<AuthorizationResult>
 
-  /**
-   * Authorizes entity retrieval
-   */
+  /** Post-load authorization for `get`, per loaded entity. */
   authorizeGetEntity?: (options: { injector: Injector; entity: T }) => Promise<AuthorizationResult>
 
   /**
-   * Additional filter parsing to be appended per filter / query
+   * Filter post-processor. Receives the caller's {@link FindOptions} and
+   * returns a (potentially augmented) one. Use to inject mandatory clauses
+   * (tenant scoping, soft-delete masks) the caller cannot bypass.
    */
   addFilter?: <TFields extends Array<keyof T>>(options: {
     injector: Injector