@adobe/data 0.9.60 → 0.9.61

package/dist/ecs/database/index-api-proof.type-test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ecs/database/index-api-proof.type-test.js

@@ -0,0 +1,88 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+// ============================================================================
+// 1. Single-column unique lookup — `byEmail`
+// ============================================================================
+{
+}
+// ============================================================================
+// 2. Multi-column compound unique — `playerSlot`
+// ============================================================================
+{
+}
+// ============================================================================
+// 3. Non-unique by single column — `childrenOf`
+// ============================================================================
+{
+}
+// ============================================================================
+// 4. Sorted children — `orderedChildrenOf`
+// ============================================================================
+{
+}
+// ============================================================================
+// 5. Multi-value (array column → fan-out) — `tasksByAssignee`
+// ============================================================================
+{
+}
+// ============================================================================
+// 6. Computed scalar (case-insensitive email) — `byEmailCi`
+// ============================================================================
+{
+}
+// ============================================================================
+// 7. Multi-value computed (compute returns array → fan-out) — `docsByKeyword`
+// ============================================================================
+{
+}
+// ============================================================================
+// 8. Compound from nested data — `playerByRoster`
+// ============================================================================
+{
+}
+// ============================================================================
+// 9. Sorted from nested data — `orderedChildrenOfFoo`
+// ============================================================================
+{
+}
+// ============================================================================
+// 10. Mixed identity + derived parts — `playerByTeamRole`
+// ============================================================================
+{
+}
+// ============================================================================
+// 11. Computed mapped + sorted — `orderedRoster`
+// ============================================================================
+{
+}
+// ============================================================================
+// 12. Custom comparator — `tasksByPriority`
+// ============================================================================
+{
+}
+// ============================================================================
+// NEGATIVE TYPE CHECKS — these declarations should fail to typecheck.
+// ============================================================================
+{
+}
+{
+}
+{
+    // @ts-expect-error - "bogus" is not a column on C
+    const _decl = { team: "team", role: "bogus" };
+    void _decl;
+}
+{
+    const goodCompare = (a, b) => a.fractIndex.localeCompare(b.fractIndex);
+    void goodCompare;
+    // Reading an undeclared column inside compare is a compile error.
+    const badCompare = (a, b) => 
+    // @ts-expect-error - `priority` is not in `Pick<C, "fractIndex">`
+    a.priority - b.priority;
+    void badCompare;
+}
+{
+}
+{
+}
+export {};
+//# sourceMappingURL=index-api-proof.type-test.js.map

package/dist/ecs/database/index-api-proof.type-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-api-proof.type-test.js","sourceRoot":"","sources":["../../../src/ecs/database/index-api-proof.type-test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAkGvD,+EAA+E;AAC/E,6CAA6C;AAC7C,+EAA+E;AAE/E,CAAC;AAQD,CAAC;AAED,+EAA+E;AAC/E,iDAAiD;AACjD,+EAA+E;AAE/E,CAAC;AASD,CAAC;AAED,+EAA+E;AAC/E,gDAAgD;AAChD,+EAA+E;AAE/E,CAAC;AAOD,CAAC;AAED,+EAA+E;AAC/E,2CAA2C;AAC3C,+EAA+E;AAE/E,CAAC;AASD,CAAC;AAED,+EAA+E;AAC/E,8DAA8D;AAC9D,+EAA+E;AAE/E,CAAC;AAMD,CAAC;AAED,+EAA+E;AAC/E,4DAA4D;AAC5D,+EAA+E;AAE/E,CAAC;AAKD,CAAC;AAED,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAE/E,CAAC;AAMD,CAAC;AAED,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAE/E,CAAC;AAeD,CAAC;AAED,+EAA+E;AAC/E,sDAAsD;AACtD,+EAA+E;AAE/E,CAAC;AAYD,CAAC;AAED,+EAA+E;AAC/E,0DAA0D;AAC1D,+EAA+E;AAE/E,CAAC;AAcD,CAAC;AAED,+EAA+E;AAC/E,iDAAiD;AACjD,+EAA+E;AAE/E,CAAC;AAmBD,CAAC;AAED,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E,CAAC;AAeD,CAAC;AAED,+EAA+E;AAC/E,sEAAsE;AACtE,+EAA+E;AAE/E,CAAC;AAID,CAAC;AAED,CAAC;AAOD,CAAC;AAED,CAAC;IAMG,kDAAkD;IAClD,MAAM,KAAK,GAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvD,KAAK,KAAK,CAAC;AACf,CAAC;AAED,CAAC;IAMG,MAAM,WAAW,GAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACzF,KAAK,WAAW,CAAC;IAEjB,kEAAkE;IAClE,MAAM,UAAU,GAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;IAC1C,kEAAkE;IAClE,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC5B,KAAK,UAAU,CAAC;AACpB,CAAC;AAED,CAAC;AAID,CAAC;AAED,CAAC;AAQD,CAAC"}

package/dist/ecs/database/index-registry/create-index-registry.d.ts

@@ -0,0 +1,53 @@
+import type { Entity } from "../../entity/entity.js";
+import type { TransactionResult } from "../transactional-store/index.js";
+import { IndexKeyDecl, IndexOrderDecl, RuntimeIndex } from "./create-index.js";
+/**
+ * Reads the post-transaction values of an entity, or returns null when the
+ * entity does not exist. Supplied by `createStore` so the registry stays
+ * decoupled from the store layer.
+ */
+export type EntityReader = (entity: Entity) => Readonly<Record<string, unknown>> | null;
+/**
+ * Plugin-level declaration object as it appears in `plugin.indexes[name]`.
+ * The registry holds the *exact* reference so the same-name re-registration
+ * check can compare identity (`===`) — matching the rule
+ * `combinePlugins` already enforces for components / transactions / etc.
+ *
+ * Mirrors the public `Index` type from `store/index-types.ts` at the
+ * value layer (the registry doesn't have access to the host component
+ * map, so this version is loose-typed).
+ */
+export type IndexDeclarationObject = {
+    readonly key: IndexKeyDecl;
+    readonly order?: IndexOrderDecl;
+    readonly unique?: boolean;
+    readonly components?: readonly string[];
+};
+export interface IndexRegistry {
+    readonly indexes: ReadonlyMap<string, RuntimeIndex>;
+    /**
+     * Registers a new index from its plugin declaration object.
+     *
+     * - Same `name` with identity-equal `decl`: no-op (returns null).
+     * - Same `name` with a different `decl` object: throws.
+     * - Different `name` with structurally identical declaration: throws.
+     *
+     * Returns the new `RuntimeIndex` for the caller to seed from archetypes.
+     */
+    register(name: string, decl: IndexDeclarationObject): RuntimeIndex | null;
+    /** Apply a transaction's changes to every registered index. */
+    apply(result: TransactionResult<any>): void;
+    /** Drop all bucket entries without reseeding. */
+    clear(): void;
+    /** Reflect a single insert. Throws on unique conflict — pre-check first. */
+    applyInsert(entity: Entity, values: Readonly<Record<string, unknown>>): void;
+    /** Reflect a single update by re-reading the entity's full values. */
+    applyUpdate(entity: Entity): void;
+    /** Reflect a single delete. */
+    applyDelete(entity: Entity): void;
+    /** Throws if any unique index would collide. Call before mutating. */
+    checkUniqueAvailableForInsert(values: Readonly<Record<string, unknown>>): void;
+    /** Like the insert version, but excludes self-collisions for `entity`. */
+    checkUniqueAvailableForUpdate(entity: Entity, patch: Readonly<Record<string, unknown>>): void;
+}
+export declare const createIndexRegistry: (read: EntityReader) => IndexRegistry;

package/dist/ecs/database/index-registry/create-index-registry.js

@@ -0,0 +1,174 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { createIndex } from "./create-index.js";
+/**
+ * Assigns a stable numeric id to each distinct function the registry sees
+ * (used inside the structural-duplicate shape key). Two indexes with the
+ * same key shape but different extractor functions are NOT duplicates.
+ */
+const fnIds = new WeakMap();
+let nextFnId = 0;
+const fnIdent = (fn) => {
+    let id = fnIds.get(fn);
+    if (id === undefined) {
+        id = nextFnId++;
+        fnIds.set(fn, id);
+    }
+    return `f${id}`;
+};
+const keyIdent = (key) => {
+    if (typeof key === "string")
+        return `s:${key}`;
+    if (Array.isArray(key))
+        return `t:${key.join("\x1f")}`;
+    if (typeof key === "function")
+        return `f:${fnIdent(key)}`;
+    // Slot map — sort slot names for stable ordering.
+    const slots = Object.entries(key).sort();
+    return "m:" + slots.map(([slot, v]) => typeof v === "string" ? `${slot}=s:${v}` : `${slot}=${fnIdent(v)}`).join("\x1f");
+};
+const orderIdent = (order) => {
+    if (!order)
+        return "";
+    const by = order.by.join("\x1f");
+    const cmp = order.compare ? fnIdent(order.compare) : "default";
+    return `${by}|${cmp}`;
+};
+const shapeKey = (decl) => [
+    decl.unique ?? false,
+    keyIdent(decl.key),
+    orderIdent(decl.order),
+].join("\x1f");
+const formatShape = (decl) => {
+    const unique = decl.unique ? " unique" : "";
+    const order = decl.order ? ` order=[${decl.order.by.join(",")}]` : "";
+    return `key=${keyIdent(decl.key)}${unique}${order}`;
+};
+export const createIndexRegistry = (read) => {
+    const indexes = new Map();
+    const entries = new Map();
+    const shapeToName = new Map();
+    const register = (name, decl) => {
+        const existing = entries.get(name);
+        if (existing) {
+            if (existing.decl === decl)
+                return null;
+            throw new Error(`Index "${name}" already registered with a different declaration object. ` +
+                `Indexes must reuse the same declaration reference across plugins. ` +
+                `existing ${formatShape(existing.decl)}, new ${formatShape(decl)}`);
+        }
+        const sk = shapeKey(decl);
+        const dupName = shapeToName.get(sk);
+        if (dupName !== undefined) {
+            throw new Error(`Indexes "${dupName}" and "${name}" have identical shape ` +
+                `(${formatShape(decl)}). Almost certainly an unintentional ` +
+                `duplicate — collapse them to a single declaration.`);
+        }
+        const state = {
+            key: decl.key,
+            order: decl.order,
+            unique: decl.unique ?? false,
+            components: decl.components,
+        };
+        const idx = createIndex(state);
+        indexes.set(name, idx);
+        entries.set(name, { decl, index: idx });
+        shapeToName.set(sk, name);
+        return idx;
+    };
+    const reflectEntity = (entity, change) => {
+        if (change === null) {
+            for (const idx of indexes.values())
+                idx.remove(entity);
+            return;
+        }
+        const values = read(entity);
+        if (values === null) {
+            for (const idx of indexes.values())
+                idx.remove(entity);
+            return;
+        }
+        for (const idx of indexes.values())
+            idx.update(entity, values);
+    };
+    const apply = (result) => {
+        if (indexes.size === 0)
+            return;
+        for (const [entity, change] of result.changedEntities) {
+            reflectEntity(entity, change);
+        }
+    };
+    const clear = () => {
+        for (const idx of indexes.values())
+            idx.clear();
+    };
+    const applyInsert = (entity, values) => {
+        if (indexes.size === 0)
+            return;
+        for (const idx of indexes.values())
+            idx.add(entity, values);
+    };
+    const applyUpdate = (entity) => {
+        if (indexes.size === 0)
+            return;
+        const values = read(entity);
+        if (values === null) {
+            for (const idx of indexes.values())
+                idx.remove(entity);
+            return;
+        }
+        for (const idx of indexes.values())
+            idx.update(entity, values);
+    };
+    const applyDelete = (entity) => {
+        if (indexes.size === 0)
+            return;
+        for (const idx of indexes.values())
+            idx.remove(entity);
+    };
+    const checkUniqueAvailableForInsert = (values) => {
+        for (const [name, idx] of indexes) {
+            if (!idx.unique)
+                continue;
+            const collidesWith = idx.checkUniqueAvailable(values, null);
+            if (collidesWith !== null) {
+                throw new Error(`Unique index conflict on "${name}": existing entity ${collidesWith}.`);
+            }
+        }
+    };
+    const checkUniqueAvailableForUpdate = (entity, patch) => {
+        let hasUnique = false;
+        for (const idx of indexes.values()) {
+            if (idx.unique) {
+                hasUnique = true;
+                break;
+            }
+        }
+        if (!hasUnique)
+            return;
+        const current = read(entity);
+        if (current === null)
+            return;
+        const effective = { ...current, ...patch };
+        for (const [name, idx] of indexes) {
+            if (!idx.unique)
+                continue;
+            const collidesWith = idx.checkUniqueAvailable(effective, entity);
+            if (collidesWith !== null) {
+                throw new Error(`Unique index conflict on "${name}": existing entity ${collidesWith} ` +
+                    `would collide with the update of entity ${entity}.`);
+            }
+        }
+    };
+    return {
+        indexes,
+        register,
+        apply,
+        clear,
+        applyInsert,
+        applyUpdate,
+        applyDelete,
+        checkUniqueAvailableForInsert,
+        checkUniqueAvailableForUpdate,
+    };
+};
+//# sourceMappingURL=create-index-registry.js.map

package/dist/ecs/database/index-registry/create-index-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-index-registry.js","sourceRoot":"","sources":["../../../../src/ecs/database/index-registry/create-index-registry.ts"],"names":[],"mappings":"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"}

package/dist/ecs/database/index-registry/create-index.d.ts

@@ -0,0 +1,60 @@
+import type { Entity } from "../../entity/entity.js";
+/**
+ * `key` declaration variants. See `Index` in `store/index-types.ts` for
+ * the type-level mirror that drives `find` / `get` argument inference.
+ */
+export type IndexKeyDecl = string | readonly string[] | ((...args: any[]) => unknown) | {
+    readonly [slot: string]: string | ((...args: any[]) => unknown);
+};
+/** `order` declaration: read columns + optional comparator. */
+export type IndexOrderDecl = {
+    readonly by: readonly string[];
+    readonly compare?: (a: any, b: any) => number;
+};
+/**
+ * The shape a user (or higher layer) hands to `createIndex` for a single
+ * index. Mirrors the public `Index` type but loose-typed at this layer
+ * because the runtime doesn't have access to the host component map.
+ */
+export interface IndexState {
+    readonly key: IndexKeyDecl;
+    readonly order?: IndexOrderDecl;
+    readonly unique?: boolean;
+    /**
+     * Columns extractor functions read. Only required when at least one
+     * function in `key` reads from a column not already covered by a
+     * string identity in `key` or `order.by`.
+     */
+    readonly components?: readonly string[];
+}
+/**
+ * Runtime instance of a single declared index. Public methods mirror
+ * `Index.Handle` in `store/index-types.ts`.
+ */
+export interface RuntimeIndex {
+    readonly unique: boolean;
+    /** Columns the index reads from entities, for the store-layer seed path. */
+    readonly readColumns: readonly string[];
+    /** Whether this index is sorted (`order` was declared). */
+    readonly sorted: boolean;
+    /** Underlying key declaration — exposed for the auto-router and dedup. */
+    readonly key: IndexKeyDecl;
+    /** Underlying order declaration, if any. */
+    readonly order: IndexOrderDecl | undefined;
+    add(entity: Entity, values: Readonly<Record<string, unknown>>): void;
+    remove(entity: Entity): void;
+    update(entity: Entity, values: Readonly<Record<string, unknown>>): void;
+    clear(): void;
+    readonly size: number;
+    find(arg: unknown): readonly Entity[];
+    findRange(arg: unknown): readonly Entity[];
+    get(arg: unknown): Entity | null;
+    /**
+     * For unique indexes: returns the existing entity holding any bucket
+     * key the new `values` would land in (excluding `excludeEntity` if
+     * provided), or null. Used by the Store-layer pre-check so unique
+     * conflicts throw before the column mutation.
+     */
+    checkUniqueAvailable(values: Readonly<Record<string, unknown>>, excludeEntity: Entity | null): Entity | null;
+}
+export declare const createIndex: (state: IndexState) => RuntimeIndex;