@iamjulianacosta/mobx-data 1.0.1

package/dist/store/RecordArray.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Observable array proxies for store query results.
+ *
+ * Two classes are provided:
+ *
+ * ## `RecordArray<T>`
+ * A live, read-only view of all records of a given type in the store's
+ * identity map.  The contents are derived via an injected `source` function
+ * so they stay in sync automatically with the identity map.
+ *
+ * Supports `update()` to trigger a background re-fetch if an `update` callback
+ * is provided.
+ *
+ * ## `AdapterPopulatedRecordArray<T>`
+ * A subclass used for the results of `store.query()`.  Unlike `RecordArray`,
+ * its contents are determined by the last adapter response (order preserved,
+ * no auto-sync with new pushes).
+ *
+ * Adds `meta`, `links`, and `query` properties that are set by the store after
+ * each adapter call.
+ */
+import type { Model } from '@mobx-data/model';
+/** Constructor options for `RecordArray`. */
+export interface RecordArrayOptions<T extends Model> {
+    /** Registered model name. */
+    modelName: string;
+    /** Function that returns the current record list (called on each access). */
+    source: () => T[];
+    /** Optional async callback invoked by `update()`. */
+    update?: () => Promise<void>;
+    /**
+     * When `true`, the internal MobX computed retains its cached value even when
+     * no observers are actively subscribed.  Prevents expensive recomputation
+     * for long-lived filtered views (e.g. `liveQuery` results).
+     */
+    keepAlive?: boolean;
+}
+/**
+ * Live, read-only view of all records of a given type.
+ *
+ * The `source` function is called on each observable access so the array
+ * always reflects the current store state.  MobX tracks the `source` call
+ * as part of `resolved`, so any computed prop that reads from this array
+ * will re-run when the underlying identity map changes.
+ */
+export declare class RecordArray<T extends Model = Model> implements Iterable<T> {
+    private readonly opts;
+    /** `true` while `update()` is in progress. */
+    protected updating: boolean;
+    constructor(opts: RecordArrayOptions<T>);
+    /** Current record list, derived from the injected `source` function. */
+    protected get resolved(): T[];
+    /** `true` while a background `update()` call is in progress. */
+    get isLoading(): boolean;
+    /** Alias for `isLoading`. */
+    get isUpdating(): boolean;
+    /** Number of records in the array. */
+    get length(): number;
+    /** The registered model name for the records in this array. */
+    get modelName(): string;
+    /** Returns the record at `index`, or `undefined`. */
+    at(index: number): T | undefined;
+    /** Returns a plain array snapshot of all records. */
+    toArray(): T[];
+    /** Maps over records. */
+    map<R>(callback: (record: T, i: number) => R): R[];
+    /** Filters records. */
+    filter(predicate: (record: T, i: number) => boolean): T[];
+    /** Iterates records. */
+    forEach(callback: (record: T, i: number) => void): void;
+    /** Returns `true` when `record` is in the array. */
+    includes(record: T): boolean;
+    /**
+     * Triggers the `update` callback (if any) to refresh the array from the
+     * adapter.  Sets `isLoading` while the request is in flight.
+     */
+    update(): Promise<this>;
+    [Symbol.iterator](): Iterator<T>;
+}
+/** Constructor options for `AdapterPopulatedRecordArray`. */
+export interface AdapterPopulatedRecordArrayOptions<T extends Model> extends RecordArrayOptions<T> {
+    /** Query parameters that produced this result set. */
+    query: Record<string, unknown>;
+    /** Server-side metadata (pagination, total counts, etc.). */
+    meta?: Record<string, unknown>;
+    /** Pagination or related links. */
+    links?: Record<string, string>;
+}
+/**
+ * Record array populated by an adapter query response.
+ *
+ * The store creates one of these for each `store.query()` call.  Its contents
+ * are driven by the id list returned from the last adapter call, not by live
+ * identity map iteration.
+ *
+ * Call `.update()` to re-issue the original query and refresh the contents.
+ */
+export declare class AdapterPopulatedRecordArray<T extends Model = Model> extends RecordArray<T> {
+    private queryParams;
+    private metaData;
+    private linksData;
+    constructor(opts: AdapterPopulatedRecordArrayOptions<T>);
+    /** Server-side metadata attached to the last response (e.g. pagination). */
+    get meta(): Record<string, unknown>;
+    /** Links attached to the last response. */
+    get links(): Record<string, string>;
+    /** The query parameters that produced this array. */
+    get query(): Record<string, unknown>;
+    /** Called by the store to update `meta` after a successful query. */
+    _setMeta(meta: Record<string, unknown>): void;
+    /** Called by the store to update `links` after a successful query. */
+    _setLinks(links: Record<string, string>): void;
+}
+//# sourceMappingURL=RecordArray.d.ts.map

package/dist/store/RecordArray.d.ts.map

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

package/dist/store/Store.d.ts

@@ -0,0 +1,395 @@
+/**
+ * Central store — the top-level coordinator for the mobx-data runtime.
+ *
+ * `Store` orchestrates every aspect of the data layer:
+ *
+ * - **Identity Map** — a two-level `IdentityMap` keyed by `modelName → id`.
+ *   Records are merged in-place on repeated `push` calls so live references
+ *   always reflect the latest server state.
+ *
+ * - **Finding records** — `findRecord`, `findAll`, `query`, `queryRecord`
+ *   delegate to the registered adapter, then pass the raw response through the
+ *   registered serializer before pushing normalized data into the identity map.
+ *
+ * - **Saving records** — `saveRecord` calls `adapter.createRecord` or
+ *   `adapter.updateRecord` depending on `record.isNew`, then applies the
+ *   server response back onto the record via `_applyServerData`.
+ *
+ * - **Relationships** — `resolveRelationship` returns sync (`ManyArray`) or
+ *   async (`AsyncBelongsTo` / `AsyncHasMany`) proxy objects backed by the
+ *   store.  `setRelationshipValue` updates `belongsTo` refs and keeps their
+ *   inverses in sync.  `_hasManyAppend` / `_hasManyRemove` manage `hasMany`
+ *   refs and their inverses.
+ *
+ * - **Inverse tracking** — `addInverse` / `removeInverse` keep both sides of
+ *   a declared `inverse` relationship consistent when either side is mutated.
+ *
+ * ## Registration
+ *
+ * ```ts
+ * store.registerAdapter('application', new RestAdapter());
+ * store.registerSerializer('application', new JsonSerializer());
+ * ```
+ *
+ * Adapters and serializers are looked up first by exact model name, then by
+ * the special `'application'` fallback.
+ */
+import { SchemaService, type RelationshipDef, type AttributeDef } from '@mobx-data/schema';
+import { Model, type RelationshipRef, type ModelStoreLike, type SaveOptions } from '@mobx-data/model';
+import { IdentityMap } from './IdentityMap.js';
+import { RecordArray, AdapterPopulatedRecordArray } from './RecordArray.js';
+/** Options forwarded from the Store to adapter fetch methods. */
+export interface AdapterFetchOptions {
+    include?: string;
+    adapterOptions?: Record<string, unknown>;
+}
+/** Minimal adapter interface the Store depends on. */
+export interface AdapterLike {
+    findRecord(store: Store, modelName: string, id: string, snapshot: unknown, options?: AdapterFetchOptions): Promise<unknown>;
+    findAll(store: Store, modelName: string, sinceToken: string | null, snapshotArray: unknown, options?: AdapterFetchOptions): Promise<unknown>;
+    findMany?(store: Store, modelName: string, ids: string[], snapshots: unknown): Promise<unknown>;
+    query(store: Store, modelName: string, query: Record<string, unknown>, recordArray: AdapterPopulatedRecordArray): Promise<unknown>;
+    queryRecord(store: Store, modelName: string, query: Record<string, unknown>): Promise<unknown>;
+    createRecord(store: Store, modelName: string, snapshot: unknown): Promise<unknown>;
+    updateRecord(store: Store, modelName: string, snapshot: unknown): Promise<unknown>;
+    patchRecord?(store: Store, modelName: string, snapshot: unknown): Promise<unknown>;
+    deleteRecord(store: Store, modelName: string, snapshot: unknown): Promise<unknown>;
+    /** When `true` the store coalesces multiple `findRecord` calls into one `findMany`. */
+    coalesceFindRequests?: boolean;
+}
+/** Minimal serializer interface the Store depends on. */
+export interface SerializerLike {
+    normalize(store: Store, modelClass: unknown, payload: unknown, prop?: string): unknown;
+    normalizeResponse(store: Store, modelClass: unknown, payload: unknown, id: string | null, requestType: string): unknown;
+    serialize(snapshot: unknown, options?: Record<string, unknown>): unknown;
+    extractErrors?(store: Store, modelClass: unknown, payload: unknown, id: string | null): Record<string, string[]>;
+}
+/** Options for `findRecord` and `findAll`. */
+export interface FindOptions {
+    /** When `true`, bypass the cache and always hit the network. */
+    reload?: boolean;
+    /** When `true`, return the cached value and refetch in the background. */
+    backgroundReload?: boolean;
+    /** Adapter-specific options forwarded to the adapter method. */
+    adapterOptions?: Record<string, unknown>;
+    /** Comma-separated relationship paths to include (e.g. `'author,comments'`). */
+    include?: string;
+}
+/** Normalized resource shape consumed internally by the store. */
+export interface NormalizedResource {
+    type: string;
+    id: string | null;
+    attributes?: Record<string, unknown>;
+    relationships?: Record<string, RelationshipRef>;
+}
+/** Normalized document containing primary data and optional side-loaded records. */
+export interface NormalizedDocument {
+    data: NormalizedResource | NormalizedResource[] | null;
+    included?: NormalizedResource[];
+    meta?: Record<string, unknown>;
+    links?: Record<string, string>;
+}
+/** Internal snapshot interface created and consumed by the store. */
+interface Snapshot {
+    id: string | null;
+    modelName: string;
+    record: Model;
+    attr(key: string): unknown;
+    belongsTo(key: string, options?: {
+        id?: boolean;
+    }): unknown;
+    hasMany(key: string, options?: {
+        ids?: boolean;
+    }): unknown;
+    changedAttributes(): Record<string, [unknown, unknown]>;
+    eachAttribute(fn: (key: string, meta: AttributeDef) => void): void;
+    eachRelationship(fn: (key: string, meta: RelationshipDef) => void): void;
+}
+export declare class Store implements ModelStoreLike {
+    static refEquals(a: {
+        type: string;
+        id: string;
+    }, b: {
+        type: string;
+        id: string;
+    }): boolean;
+    /** Schema registry used to look up model classes and their metadata. */
+    readonly schema: SchemaService;
+    /** Two-level identity map: `modelName → id → record`. */
+    readonly identityMap: IdentityMap;
+    private adapters;
+    private serializers;
+    /** Tracks unsaved (new) records by model name. */
+    private newRecords;
+    /** Reverse index: record → modelName for O(1) untrackNewRecord. */
+    private newRecordTypes;
+    /** Per-record cache of relationship proxy objects (ManyArray / AsyncBelongsTo / AsyncHasMany). */
+    private relationshipCache;
+    /** Tracks new records that have been appended to a hasMany but not yet saved. */
+    private pendingMembers;
+    constructor(schema: SchemaService);
+    /** Registers an adapter for a given model name (or `'application'` as a fallback). */
+    registerAdapter(modelName: string, adapter: AdapterLike): void;
+    /** Registers a serializer for a given model name (or `'application'` as a fallback). */
+    registerSerializer(modelName: string, serializer: SerializerLike): void;
+    /**
+     * Returns the adapter for `modelName`, falling back to `'application'`.
+     * @throws when no adapter is registered.
+     */
+    adapterFor(modelName: string): AdapterLike;
+    /**
+     * Returns the serializer for `modelName`, falling back to `'application'`.
+     * @throws when no serializer is registered.
+     */
+    serializerFor(modelName: string): SerializerLike;
+    /**
+     * Creates a new (unsaved) record of the given type with optional initial data.
+     * The record is tracked in `newRecords` until it is saved or rolled back.
+     *
+     * @throws when `modelName` has not been registered with `SchemaService`.
+     */
+    createRecord<T extends Model = Model>(modelName: string, data?: Record<string, unknown>): T;
+    private trackNewRecord;
+    private untrackNewRecord;
+    /**
+     * Synchronously returns a record from the identity map, or `null` when not
+     * found.  Does not trigger a network request.
+     */
+    peekRecord<T extends Model = Model>(modelName: string, id: string): T | null;
+    /**
+     * Returns a live `RecordArray` backed by the identity map for `modelName`.
+     * New (unsaved) records are included at the end.
+     * Does not trigger a network request.
+     */
+    peekAll<T extends Model = Model>(modelName: string): RecordArray<T>;
+    /**
+     * Pushes a normalized document into the identity map.
+     * Side-loaded (`included`) records are pushed first.
+     *
+     * @returns The primary record(s), or `null` for empty payloads.
+     */
+    push(doc: unknown): Model | Model[] | null;
+    /**
+     * Normalizes a raw payload via the registered serializer and pushes the
+     * result.  `modelName` is optional; when omitted the payload is pushed
+     * directly without normalization.
+     */
+    pushPayload(modelNameOrPayload: string | unknown, payload?: unknown): void;
+    /**
+     * Normalizes a raw payload for `modelName` via the registered serializer
+     * and returns the `NormalizedDocument` without pushing it.
+     */
+    normalize(modelName: string, payload: unknown): NormalizedDocument;
+    /**
+     * Inserts or merges a single normalized resource into the identity map.
+     * - Existing record → calls `_applyServerData` to merge attributes and
+     *   relationships in place (preserving the live reference).
+     * - New record → instantiates via `Model.push` and sets it in the map.
+     *
+     * @throws when `type` has not been registered or `id` is `null`.
+     */
+    private pushResource;
+    /**
+     * After pushing a resource, updates the inverse side of every declared
+     * inverse relationship so both sides stay consistent.
+     */
+    private trackInverseForResource;
+    /**
+     * Adds `inverseRecord` to the inverse relationship on `targetType:targetId`.
+     * No-ops when the target record is not in the identity map.
+     */
+    private addInverse;
+    /**
+     * Removes `inverseRecord` from the inverse relationship on `targetType:targetId`.
+     * No-ops when the target record is not in the identity map.
+     */
+    private removeInverse;
+    /**
+     * Removes a record from the identity map and clears its relationship cache.
+     * Called by `record.unloadRecord()` and internally after `deleteRecord`.
+     */
+    unloadRecord(record: Model): void;
+    /**
+     * Unloads all records for `modelName`, or all records across all types when
+     * `modelName` is omitted.
+     */
+    unloadAll(modelName?: string): void;
+    /**
+     * Finds a single record by id.  Returns the cached record immediately when
+     * `options.reload` is not set; otherwise re-fetches.
+     *
+     * When the adapter has `coalesceFindRequests: true` and `findMany` is
+     * implemented, multiple concurrent `findRecord` calls for the same type
+     * are batched into a single `findMany` network request.
+     */
+    findRecord<T extends Model = Model>(modelName: string, id: string, options?: FindOptions): Promise<T>;
+    /**
+     * Fetches all records of `modelName` from the server and returns a
+     * `RecordArray` backed by the identity map.
+     */
+    findAll<T extends Model = Model>(modelName: string, options?: FindOptions): Promise<RecordArray<T>>;
+    /**
+     * Executes an adapter query and returns an `AdapterPopulatedRecordArray`
+     * whose `update()` method re-issues the same query.
+     */
+    query<T extends Model = Model>(modelName: string, params: Record<string, unknown>): Promise<AdapterPopulatedRecordArray<T>>;
+    private runQuery;
+    /**
+     * Executes an adapter query that returns at most one record.
+     * Returns `null` when the adapter returns an empty payload.
+     */
+    queryRecord<T extends Model = Model>(modelName: string, params: Record<string, unknown>): Promise<T | null>;
+    /**
+     * Persists a record to the server.
+     * - New records → `adapter.createRecord` (POST)
+     * - Existing dirty records → `adapter.updateRecord` (PUT) by default
+     * - With `{ patch: true }` → `adapter.patchRecord` (PATCH, partial payload)
+     *
+     * After the response is received the server data is applied back to the
+     * record via `_applyServerData` so it transitions to `saved`.
+     */
+    saveRecord<T extends Model>(record: T, options?: SaveOptions): Promise<T>;
+    /**
+     * Issues a DELETE request and unloads the record from the identity map.
+     */
+    deleteRecord<T extends Model>(record: T): Promise<T>;
+    /**
+     * Re-fetches a record from the server and merges the response into the
+     * existing instance.
+     */
+    reloadRecord<T extends Model>(record: T): Promise<T>;
+    /**
+     * Creates a `Snapshot` for a live record.
+     * The snapshot reads directly from the record's internal state so it
+     * reflects the current (possibly dirty) values.
+     */
+    createSnapshot(record: Model): Snapshot;
+    /**
+     * Creates a placeholder `Snapshot` for a record that is not yet in the
+     * identity map (used when fetching a record that isn't cached).
+     */
+    private createEmptySnapshot;
+    private getRelationshipCache;
+    private setRelationshipCache;
+    /**
+     * Called by the `Model` relationship getter to resolve a relationship.
+     *
+     * - **Async** `belongsTo` → returns an `AsyncBelongsTo` wrapper.
+     * - **Async** `hasMany`   → returns an `AsyncHasMany` wrapper.
+     * - **Sync** `belongsTo`  → peeks the related record from the identity map.
+     * - **Sync** `hasMany`    → returns a `ManyArray` backed by the store.
+     *
+     * Results are cached per record + name so the same proxy is returned on
+     * repeated accesses (important for MobX observability).
+     */
+    resolveRelationship(record: Model, name: string, meta: RelationshipDef): unknown;
+    /**
+     * Called by the `Model` `belongsTo` setter to update a relationship ref
+     * and keep its inverse in sync.
+     */
+    setRelationshipValue(record: Model, name: string, meta: RelationshipDef, value: unknown): void;
+    /** Returns the raw relationship ref stored on `record` for `name`. */
+    _getRelationshipRefFor(record: Model, name: string): RelationshipRef | null;
+    /** Returns any pending (unsaved) members for a `hasMany` relationship. */
+    _getPendingMembers(record: Model, name: string): Iterable<Model>;
+    private addPendingMember;
+    private removePendingMember;
+    /**
+     * Appends `value` to the `hasMany` relationship ref on `record` and syncs
+     * the inverse.  Unsaved records (`value.id === null`) are tracked as
+     * "pending members" until they are persisted.
+     */
+    _hasManyAppend(record: Model, name: string, meta: RelationshipDef, value: Model): void;
+    /**
+     * Removes `value` from the `hasMany` relationship ref on `record` and syncs
+     * the inverse.  Pending members are removed from the pending set.
+     */
+    _hasManyRemove(record: Model, name: string, meta: RelationshipDef, value: Model): void;
+    private coalescePending;
+    private coalesceScheduled;
+    private scheduleCoalescedFind;
+    private flushCoalescedFind;
+    /**
+     * Returns a reactive `RecordArray` that auto-updates whenever records matching
+     * the predicate are added, removed, or mutated in the identity map.
+     *
+     * The underlying computed uses `keepAlive: true` so it remains cached even
+     * without active MobX observers — useful for long-lived filtered views.
+     *
+     * @param modelName - The registered model type to query.
+     * @param predicate - Filter function applied to each record of `modelName`.
+     * @returns A live `RecordArray` containing only records that satisfy `predicate`.
+     */
+    liveQuery<T extends Model = Model>(modelName: string, predicate: (record: T) => boolean): RecordArray<T>;
+    /**
+     * Applies attribute changes to a record immediately (optimistically), then
+     * executes `persistFn`.  If `persistFn` throws, the record is automatically
+     * rolled back to its state before the optimistic update.
+     *
+     * @param record - The record to update optimistically.
+     * @param optimisticAttributes - Attributes to apply before persistence.
+     * @param persistFn - Async function that persists the change (e.g. `record.save()`).
+     * @returns The record on success.
+     * @throws Re-throws the error from `persistFn` after rollback.
+     */
+    optimisticUpdate<T extends Model>(record: T, optimisticAttributes: Partial<Record<string, unknown>>, persistFn: () => Promise<unknown>): Promise<T>;
+    /**
+     * Executes multiple store mutations as a single MobX action, guaranteeing
+     * that observers (and therefore UI renders) react only once — after all
+     * mutations have been applied.
+     *
+     * @param callback - Synchronous function containing one or more store mutations.
+     */
+    runInTransaction(callback: () => void): void;
+    /**
+     * Produces a JSON-serializable snapshot of all records in the identity map.
+     * Designed for server-side rendering: serialize on the server, transfer as
+     * JSON, then `hydrate()` on the client to restore the full store state
+     * without network requests.
+     *
+     * @param options.exclude - Per-model-type list of attribute keys to omit
+     *   (e.g. `{ user: ['password', 'token'] }`) to prevent leaking sensitive
+     *   data in SSR payloads.
+     * @returns A snapshot object safe to pass through `JSON.stringify`.
+     */
+    serialize(options?: {
+        exclude?: Record<string, string[]>;
+    }): {
+        records: Record<string, Array<{
+            id: string;
+            attributes: Record<string, unknown>;
+            relationships?: Record<string, RelationshipRef>;
+        }>>;
+    };
+    /**
+     * Restores records from a snapshot produced by `serialize()` into this store
+     * instance.  All records are pushed into the identity map in `loaded.saved`
+     * state — no network requests are issued.
+     *
+     * @param snapshot - A snapshot object previously returned by `serialize()`.
+     */
+    hydrate(snapshot: {
+        records: Record<string, Array<{
+            id: string;
+            attributes: Record<string, unknown>;
+            relationships?: Record<string, RelationshipRef>;
+        }>>;
+    }): void;
+    /**
+     * Factory method that creates a new `Store` and immediately hydrates it from
+     * the given snapshot.  Convenience for SSR client-side bootstrap.
+     *
+     * @param schema - SchemaService with all model types registered.
+     * @param snapshot - A snapshot object previously returned by `serialize()`.
+     * @returns A fully populated `Store` instance ready for use.
+     */
+    static hydrate(schema: SchemaService, snapshot: {
+        records: Record<string, Array<{
+            id: string;
+            attributes: Record<string, unknown>;
+            relationships?: Record<string, RelationshipRef>;
+        }>>;
+    }): Store;
+}
+export {};
+//# sourceMappingURL=Store.d.ts.map

package/dist/store/Store.d.ts.map

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

package/dist/store/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../Store-BdwMrbDi.cjs");exports.AdapterPopulatedRecordArray=e.AdapterPopulatedRecordArray;exports.IdentityMap=e.IdentityMap;exports.RecordArray=e.RecordArray;Object.defineProperty(exports,"Store",{enumerable:!0,get:()=>e.Store});
+//# sourceMappingURL=index.cjs.map

package/dist/store/index.cjs.map

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

package/dist/store/index.d.ts

@@ -0,0 +1,5 @@
+export { Store } from './Store.js';
+export type { AdapterLike, AdapterFetchOptions, SerializerLike, FindOptions, NormalizedDocument, NormalizedResource, } from './Store.js';
+export { IdentityMap } from './IdentityMap.js';
+export { RecordArray, AdapterPopulatedRecordArray } from './RecordArray.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/store/index.js

@@ -0,0 +1,8 @@
+import { A as e, I as o, R as t, S as d } from "../Store-CZ7Z-Nme.js";
+export {
+  e as AdapterPopulatedRecordArray,
+  o as IdentityMap,
+  t as RecordArray,
+  d as Store
+};
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/transforms/Transform.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Interface and abstract base class for data transforms.
+ *
+ * A transform converts attribute values between the wire format used by the
+ * server (External) and the in-memory format used by the application
+ * (Internal).
+ *
+ * - `deserialize` — called when the store receives data from the server
+ *   (normalize direction, server → app).
+ * - `serialize` — called when the store sends data to the server
+ *   (serialize direction, app → server).
+ *
+ * Built-in transforms: `StringTransform`, `NumberTransform`,
+ * `BooleanTransform`, `DateTransform`.
+ *
+ * Custom transforms can be implemented by extending `BaseTransform`:
+ *
+ * ```ts
+ * @injectable()
+ * class UpperCaseTransform extends BaseTransform<string, string> {
+ *   deserialize(value: string) { return value.toUpperCase(); }
+ *   serialize(value: string)   { return value.toLowerCase(); }
+ * }
+ * ```
+ */
+/** Bidirectional value converter for a single attribute type. */
+export interface Transform<External = unknown, Internal = unknown> {
+    /**
+     * Converts a raw server value to the application-side type.
+     * @param serialized - Raw value as it arrived from the server.
+     * @param options    - Extra options forwarded from the `@attr` decorator.
+     */
+    deserialize(serialized: External, options?: Record<string, unknown>): Internal;
+    /**
+     * Converts an application-side value back to the wire format.
+     * @param deserialized - Current in-memory value.
+     * @param options      - Extra options forwarded from the `@attr` decorator.
+     */
+    serialize(deserialized: Internal, options?: Record<string, unknown>): External;
+}
+/**
+ * Convenience abstract class that implements `Transform` and can be extended
+ * to create custom transforms without repeating the interface declaration.
+ */
+export declare abstract class BaseTransform<External = unknown, Internal = unknown> implements Transform<External, Internal> {
+    abstract deserialize(serialized: External, options?: Record<string, unknown>): Internal;
+    abstract serialize(deserialized: Internal, options?: Record<string, unknown>): External;
+}
+//# sourceMappingURL=Transform.d.ts.map

package/dist/transforms/Transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../src/transforms/Transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,iEAAiE;AACjE,MAAM,WAAW,SAAS,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO;IAC/D;;;;OAIG;IACH,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC;IAE/E;;;;OAIG;IACH,SAAS,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC;CAChF;AAED;;;GAGG;AACH,8BAAsB,aAAa,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,CAC1E,YAAW,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ;IACvF,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ;CACxF"}

package/dist/transforms/boolean.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Transform that converts between arbitrary wire values and booleans.
+ *
+ * Deserialization coercions:
+ * - `null` / `undefined` → `false` (or `null` when `allowNull: true`)
+ * - `boolean` → passed through
+ * - `number` → `true` only when the value is exactly `1`
+ * - `string` → `true` for `'true'`, `'t'`, or `'1'` (case-insensitive)
+ * - anything else → `Boolean(value)`
+ *
+ * Serialization: `Boolean(value)` (preserves `null` when `allowNull: true`).
+ */
+import { BaseTransform } from './Transform.js';
+/** Options accepted by `BooleanTransform`. */
+export interface BooleanTransformOptions {
+    /**
+     * When `true`, `null` / `undefined` input is preserved as `null` rather
+     * than coerced to `false`.
+     */
+    allowNull?: boolean;
+}
+export declare class BooleanTransform extends BaseTransform<unknown, boolean | null> {
+    deserialize(serialized: unknown, options?: BooleanTransformOptions): boolean | null;
+    serialize(deserialized: boolean | null, options?: BooleanTransformOptions): unknown;
+}
+//# sourceMappingURL=boolean.d.ts.map

package/dist/transforms/boolean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.d.ts","sourceRoot":"","sources":["../../src/transforms/boolean.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,8CAA8C;AAC9C,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBACa,gBAAiB,SAAQ,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1E,WAAW,CACT,UAAU,EAAE,OAAO,EACnB,OAAO,GAAE,uBAA4B,GACpC,OAAO,GAAG,IAAI;IAiBjB,SAAS,CACP,YAAY,EAAE,OAAO,GAAG,IAAI,EAC5B,OAAO,GAAE,uBAA4B,GACpC,OAAO;CAMX"}