@adobe/data 0.1.2

package/ecs/action-ecs/action-ecs.d.ts

@@ -0,0 +1,19 @@
+import { ECSArchetypes, ECSComponents, ECSResources } from "../ecs/ecs-types.js";
+import { TransactionECS } from "../transaction-ecs/transaction-types.js";
+import { ActionECS, ECSActionFunctions } from "./action-types.js";
+export declare function createActionECS<C extends ECSComponents, A extends ECSArchetypes, R extends ECSResources, F extends ECSActionFunctions = {}>(options?: {
+    ecs?: TransactionECS<C, A, R>;
+    /**
+     * A unique user identifier for the current user.
+     */
+    user?: string;
+    /**
+     * A function which returns a unique, increasing time in UTC milliseconds.
+     * The function cannot return the same value twice but must increment if needed.
+     */
+    getUniqueTimeMs?: () => number;
+    /**
+     * Maximum time in milliseconds to wait for applied actions to be reordered.
+     */
+    maxSynchronizeDurationMs?: number;
+}): ActionECS<C, A, R, F>;

package/ecs/action-ecs/action-ecs.js

@@ -0,0 +1,203 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { isAsyncGenerator } from "../../core/functions/is-async-generator.js";
+import { createObservableEvent } from "../../observe/create-observable-event.js";
+import { createTransactionECS } from "../transaction-ecs/transaction-ecs.js";
+import { compareActionOrder, isSameAction, } from "./action-types.js";
+let lastTime = 0;
+function uniqueTime() {
+    const currentTime = Date.now();
+    lastTime = Math.max(currentTime, lastTime + 1);
+    return lastTime;
+}
+export function createActionECS(options = {}) {
+    const { ecs = createTransactionECS(), getUniqueTimeMs = uniqueTime, user = "", maxSynchronizeDurationMs = 5000, } = options;
+    const { createTransaction, observe, withComponents, withArchetypes, withResources, ...rest } = ecs;
+    const transactionFunctions = {};
+    const actions = {};
+    const actionSequences = {};
+    //  these are only stored in memory.
+    const applied = [];
+    const getInsertIndex = (action) => {
+        for (let i = applied.length - 1; i >= 0; i--) {
+            if (isSameAction(action, applied[i].action)) {
+                return i;
+            }
+            const sort = compareActionOrder(action, applied[i].action);
+            if (sort >= 0) {
+                return i + 1;
+            }
+        }
+        return 0;
+    };
+    const [observeActions, notifyActions] = createObservableEvent();
+    const apply = (newAction) => {
+        const index = getInsertIndex(newAction);
+        const actionAtIndex = applied[index]?.action;
+        const isSame = actionAtIndex && isSameAction(newAction, actionAtIndex);
+        const mainTransaction = ecs.createTransaction({ undoable: false, createdBy: newAction.createdBy, createdTime: newAction.createdTime });
+        for (let i = applied.length - 1; i >= index && i < applied.length; i--) {
+            mainTransaction.batch(applied[i].commit.undoOperations);
+        }
+        applied.splice(index, isSame ? 1 : 0, { action: newAction, commit: undefined });
+        for (let i = index; i < applied.length; i++) {
+            const oldAction = applied[i];
+            if (!oldAction) {
+                console.error(`Missing applied action. Shouldn't happen. Notify codeowner!`, { index, i, newAction, applied });
+                continue;
+            }
+            const { action: reapplyAction } = oldAction;
+            if (reapplyAction.type !== "cancel") {
+                const childTransaction = mainTransaction.createTransaction();
+                transactionFunctions[reapplyAction.name](childTransaction, ...reapplyAction.args);
+                oldAction.commit = childTransaction.commit();
+            }
+        }
+        mainTransaction.commit();
+        //  notify action observers
+        notifyActions(newAction);
+        pruneOldActions(newAction.createdTime);
+    };
+    const pruneOldActions = (currentTime) => {
+        const canPrune = (action) => action.type !== "transient" &&
+            action.createdTime < currentTime - maxSynchronizeDurationMs;
+        //  remove any actions which are no longer needed because they are older than the maxSynchronizeDurationMs
+        while (applied.length > 0 && canPrune(applied[0].action)) {
+            applied.shift();
+        }
+    };
+    /**
+     * Implements async execution of actions.
+     * If the argProvider is an async generator, then the action is executed as a sequence.
+     * If the argProvider is a promise, then the action is executed directly once awaited.
+     */
+    const execute = async (action, argProvider) => {
+        const argsGeneratorOrPromise = await argProvider();
+        if (isAsyncGenerator(argsGeneratorOrPromise)) {
+            let sequence;
+            try {
+                for await (const args of argsGeneratorOrPromise) {
+                    sequence = sequence?.update(...args) ?? actionSequences[action](...args);
+                }
+                sequence?.commit();
+            }
+            catch (e) {
+                // cancel the sequence
+                sequence?.cancel();
+                // rethrow the error
+                throw e;
+            }
+        }
+        else {
+            // args is still a promise so we must await it.
+            const args = await argsGeneratorOrPromise;
+            actions[action](...args);
+        }
+    };
+    const getTransientActionCount = () => {
+        return applied.reduce((acc, a) => acc + (a.action.type === "transient" ? 1 : 0), 0);
+    };
+    const actionECS = {
+        ...rest,
+        apply,
+        getTransientActionCount,
+        actions,
+        actionSequences,
+        withComponents: (newComponents) => {
+            withComponents(newComponents);
+            return actionECS;
+        },
+        withArchetypes: (newArchetypes) => {
+            withArchetypes(newArchetypes);
+            return actionECS;
+        },
+        withResources: (newResources) => {
+            withResources(newResources);
+            return actionECS;
+        },
+        withActions: (newTransactionFunctions) => {
+            for (const name in newTransactionFunctions) {
+                const action = newTransactionFunctions[name];
+                if (transactionFunctions[name]) {
+                    throw new Error(`Action already exists: ${name}`);
+                }
+                transactionFunctions[name] = action;
+                actions[name] = (...args) => {
+                    const firstArg = args[0];
+                    // handle new async execution pattern.
+                    if (typeof firstArg === "function") {
+                        return execute(name, firstArg);
+                    }
+                    const createdTime = getUniqueTimeMs();
+                    apply({ type: "commit", createdTime, createdBy: user, name, args });
+                };
+                actionSequences[name] = (...originalArgs) => {
+                    const createdTime = getUniqueTimeMs();
+                    if (typeof originalArgs[0] === "function") {
+                        throw new Error("Cannot use a function as argument to a sequence. For async execution you want to use ecs.actions instead of ecs.actionSequences.");
+                    }
+                    let args = originalArgs;
+                    const sequence = {
+                        update: (...updateArgs) => {
+                            args = updateArgs;
+                            apply({
+                                type: "transient",
+                                createdTime,
+                                createdBy: user,
+                                name,
+                                args,
+                            });
+                            return sequence;
+                        },
+                        commit: () => {
+                            apply({
+                                type: "commit",
+                                createdTime,
+                                createdBy: user,
+                                name,
+                                args,
+                            });
+                        },
+                        cancel: () => {
+                            apply({
+                                type: "cancel",
+                                createdTime,
+                                createdBy: user,
+                                name,
+                                args,
+                            });
+                        },
+                    };
+                    sequence.update(...originalArgs);
+                    return sequence;
+                };
+            }
+            return actionECS;
+        },
+        observe: {
+            ...observe,
+            actions: observeActions,
+        },
+    };
+    return actionECS;
+}
+//# sourceMappingURL=action-ecs.js.map

package/ecs/action-ecs/action-ecs.js.map

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

package/ecs/action-ecs/action-ecs.test.d.ts

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

package/ecs/action-ecs/action-ecs.test.js

@@ -0,0 +1,362 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { describe, expect, test } from "vitest";
+import { createActionECS } from "./action-ecs.js";
+import { Float32Schema, Tuple } from "../../schemas/schemas.js";
+const user = "test";
+const createECSWithMassAndSize = () => {
+    return createActionECS({ user })
+        .withComponents({
+        mass: { type: "number", minimum: 0 },
+        size: { enum: ["small", "medium", "large"] },
+        checkCreatedTime: { type: "integer" },
+        checkCreatedBy: { type: "string" },
+    })
+        .withArchetypes({
+        physical: ["id", "mass", "size"],
+        sized: ["id", "size"],
+        check: ["id", "checkCreatedTime", "checkCreatedBy"],
+    })
+        .withResources({
+        gravity: 9.8,
+    })
+        .withActions({
+        createPhysical(t, mass, size) {
+            t.createEntity(t.ecs.archetypes.physical, { mass, size });
+        },
+        deletePhysical(t, entity) {
+            t.deleteEntity(entity);
+        },
+        setMass(t, entity, mass) {
+            t.setComponentValue(entity, "mass", mass);
+        },
+        setSize(t, entity, size) {
+            t.setComponentValue(entity, "size", size);
+        },
+        setGravity(t, gravity) {
+            t.resources.gravity = gravity;
+        },
+    })
+        .withActions({
+        //  higher order actions based on the previous actions
+        setMassAndSize(t, entity, mass, size) {
+            this.setMass(t, entity, mass);
+            this.setSize(t, entity, size);
+        },
+        checkTransactionOptions(t) {
+            t.createEntity(t.ecs.archetypes.check, {
+                checkCreatedTime: t.options.createdTime,
+                checkCreatedBy: t.options.createdBy,
+            });
+        }
+    });
+};
+let FIRST_ENTITY;
+{
+    const ecs = createECSWithMassAndSize();
+    ecs.actions.createPhysical(1, "small");
+    FIRST_ENTITY = ecs.selectEntities(ecs.archetypes.physical)[0];
+}
+describe("ActionECS", () => {
+    test("can call an action to create an entity", () => {
+        const ecs = createECSWithMassAndSize();
+        ecs.actions.createPhysical(1, "small");
+        expect(ecs.selectEntityValues(ecs.archetypes.physical)).toEqual([
+            { id: FIRST_ENTITY, mass: 1, size: "small" },
+        ]);
+    });
+    test("calling an action includes createdTime and createdBy on options", () => {
+        const ecs = createECSWithMassAndSize();
+        ecs.actions.checkTransactionOptions();
+        const check = ecs.selectEntityValues(ecs.archetypes.check)[0];
+        expect(check).toEqual({
+            id: FIRST_ENTITY,
+            checkCreatedTime: expect.any(Number),
+            checkCreatedBy: user,
+        });
+    });
+    test("calling an apply action includes createdTime and createdBy on options", () => {
+        const ecs = createECSWithMassAndSize();
+        //  now we check that the time is exactly what we expect
+        const time = Date.now();
+        ecs.apply({ type: "commit", createdTime: time, createdBy: user, name: "checkTransactionOptions", args: [] });
+        const check = ecs.selectEntityValues(ecs.archetypes.check)[0];
+        expect(check).toEqual({
+            id: FIRST_ENTITY,
+            checkCreatedTime: time,
+            checkCreatedBy: user,
+        });
+    });
+    test("can call an action twice to create two entities", () => {
+        const ecs = createECSWithMassAndSize();
+        ecs.actions.createPhysical(1, "small");
+        ecs.actions.createPhysical(5, "large");
+        expect(ecs.selectEntityValues(ecs.archetypes.physical)).toEqual([
+            { id: FIRST_ENTITY, mass: 1, size: "small" },
+            { id: FIRST_ENTITY + 1, mass: 5, size: "large" },
+        ]);
+    });
+    test("can use higher order actions", () => {
+        const ecs = createECSWithMassAndSize();
+        ecs.actions.createPhysical(1, "small");
+        ecs.actions.setMassAndSize(FIRST_ENTITY, 10, "medium");
+        expect(ecs.selectEntityValues(ecs.archetypes.physical)).toEqual([
+            { id: FIRST_ENTITY, mass: 10, size: "medium" },
+        ]);
+    });
+    test("can call sequential actions and commit", () => {
+        const ecs = createECSWithMassAndSize();
+        ecs.actionSequences.setGravity(10).update(11).update(12).commit();
+        expect(ecs.resources.gravity).toBe(12);
+    });
+    test("can call sequential actions and cancel", () => {
+        const ecs = createECSWithMassAndSize();
+        ecs.actionSequences.setGravity(10).update(11).update(12).cancel();
+        expect(ecs.resources.gravity).toBe(9.8);
+    });
+    test("can execute sequential actions and commit", async () => {
+        const ecs = createECSWithMassAndSize();
+        expect(ecs.getTransientActionCount()).toBe(0);
+        await ecs.actions.setGravity(async function* () {
+            expect(ecs.getTransientActionCount()).toBe(0);
+            yield [10];
+            expect(ecs.resources.gravity).toBe(10); // in flight
+            expect(ecs.getTransientActionCount()).toBe(1);
+            yield [11];
+            expect(ecs.resources.gravity).toBe(11); // in flight
+            expect(ecs.getTransientActionCount()).toBe(1);
+            yield [12];
+            expect(ecs.resources.gravity).toBe(12); // in flight
+            expect(ecs.getTransientActionCount()).toBe(1);
+        });
+        expect(ecs.getTransientActionCount()).toBe(0);
+        expect(ecs.resources.gravity).toBe(12);
+    });
+    test("can execute sequential actions and throw an error which cancels", async () => {
+        const ecs = createECSWithMassAndSize();
+        let cleanup = false;
+        try {
+            await ecs.actions.setGravity(async function* () {
+                try {
+                    yield [10];
+                    yield [11];
+                    yield [12];
+                    throw new Error("test");
+                }
+                finally {
+                    cleanup = true;
+                }
+            });
+        }
+        catch (error) {
+            expect(cleanup).toBe(true);
+            expect(error).toBeInstanceOf(Error);
+            expect(error.message).toBe("test");
+        }
+        expect(ecs.resources.gravity).toBe(9.8);
+    });
+    test("can execute promise action and commit", async () => {
+        const ecs = createECSWithMassAndSize();
+        await ecs.actions.setGravity(async () => {
+            return [10];
+        });
+        expect(ecs.resources.gravity).toBe(10);
+    });
+    test("can use apply directly", () => {
+        const ecs = createECSWithMassAndSize();
+        const time = Date.now();
+        ecs.apply({
+            type: "commit",
+            createdTime: time,
+            createdBy: user,
+            name: "createPhysical",
+            args: [1, "small"],
+        });
+        expect(ecs.selectEntityValues(ecs.archetypes.physical)).toEqual([
+            { id: FIRST_ENTITY, mass: 1, size: "small" },
+        ]);
+    });
+    test("can resolve out of order apply calls", () => {
+        const ecs = createECSWithMassAndSize();
+        const time = Date.now();
+        //  this later one is applied first
+        ecs.apply({
+            type: "commit",
+            createdTime: time + 1,
+            createdBy: user,
+            name: "createPhysical",
+            args: [5, "large"],
+        });
+        //  this earlier one is applied second
+        ecs.apply({
+            type: "commit",
+            createdTime: time,
+            createdBy: user,
+            name: "createPhysical",
+            args: [1, "small"],
+        });
+        //  the entities are sorted and reapplied by updatedTime
+        expect(ecs.selectEntityValues(ecs.archetypes.physical)).toEqual([
+            { id: FIRST_ENTITY, mass: 1, size: "small" },
+            { id: FIRST_ENTITY + 1, mass: 5, size: "large" },
+        ]);
+    });
+    test("with subsequent updates, created order is still retained", () => {
+        //  we *could* change order later to use an updatedTime for final ordering
+        //  but would still have to roll back apply calls based on last ordering
+        const ecs = createECSWithMassAndSize();
+        const time = Date.now();
+        ecs.apply({
+            type: "transient",
+            createdTime: time,
+            createdBy: user,
+            name: "createPhysical",
+            args: [1, "small"],
+        });
+        ecs.apply({
+            type: "commit",
+            createdTime: time + 1,
+            createdBy: user,
+            name: "createPhysical",
+            args: [2, "medium"],
+        });
+        ecs.apply({
+            type: "transient",
+            createdTime: time,
+            createdBy: user,
+            name: "createPhysical",
+            args: [5, "large"],
+        });
+        ecs.apply({
+            type: "transient",
+            createdTime: time,
+            createdBy: user,
+            name: "createPhysical",
+            args: [10, "large"],
+        });
+        expect(ecs.selectEntityValues(ecs.archetypes.physical)).toEqual([
+            { id: FIRST_ENTITY, mass: 10, size: "large" },
+            { id: FIRST_ENTITY + 1, mass: 2, size: "medium" },
+        ]);
+    });
+    test("can observe actions", () => {
+        const ecs = createECSWithMassAndSize();
+        const actions = [];
+        ecs.observe.actions((action) => actions.push(action));
+        ecs.actions.createPhysical(1, "small");
+        ecs.actions.createPhysical(5, "large");
+        expect(actions).toEqual([
+            {
+                type: "commit",
+                createdTime: expect.any(Number),
+                createdBy: user,
+                name: "createPhysical",
+                args: [1, "small"],
+            },
+            {
+                type: "commit",
+                createdTime: expect.any(Number),
+                createdBy: user,
+                name: "createPhysical",
+                args: [5, "large"],
+            },
+        ]);
+    });
+});
+// sample ECS creation
+const Vector3Schema = Tuple(Float32Schema, 3);
+const Vector4Schema = Tuple(Float32Schema, 4);
+//  create an action ecs
+const ecs = createActionECS()
+    //  define components with schemas
+    .withComponents({
+    position: Vector3Schema,
+    velocity: Vector3Schema,
+    color: Vector4Schema,
+    size: { type: "number" },
+    health: { type: "number" },
+    player: { const: true },
+})
+    //  define archetypes with component names
+    .withArchetypes({
+    particle: ["position", "velocity", "color", "size"],
+    player: ["position", "health", "player"],
+})
+    //  define resources with initial values
+    .withResources({
+    gravity: 9.8,
+})
+    //  define actions with transactional functions
+    .withActions({
+    createParticle(t, props) {
+        t.createEntity(t.ecs.archetypes.particle, props);
+    },
+    deleteParticle(t, entity) {
+        t.deleteEntity(entity);
+    },
+    createPlayer(t, position) {
+        t.createEntity(t.ecs.archetypes.player, { position, health: 100, player: true });
+    },
+    movePlayer(t, entity, position) {
+        t.setComponentValue(entity, "position", position);
+    },
+    setGravity(t, gravity) {
+        t.resources.gravity = gravity;
+    },
+});
+//  call some actions to modify the ECS
+ecs.actions.createParticle({ position: [0, 0, 0], velocity: [0, 0, 0], color: [1, 0, 0, 0], size: 1 });
+ecs.actions.createParticle({ position: [1, 1, 1], velocity: [1, 1, 1], color: [1, 1, 1, 1], size: 2 });
+ecs.actions.createPlayer([10, 20, 0]);
+//  read out the player entity
+const playerEntity = ecs.selectEntities(ecs.archetypes.player)[0];
+ecs.actions.movePlayer(playerEntity, [10, 20, 0]);
+//  read some values from the ECS
+const particles = ecs.selectEntities(ecs.archetypes.particle);
+//  observe changes to the ECS
+ecs.observe.archetypeEntities(ecs.archetypes.player)((playerEntities) => {
+    for (const playerEntity of playerEntities) {
+        const player = ecs.getEntityValues(playerEntity);
+        // console.log("Player entity changed", player);
+    }
+});
+{
+    //  some type checks.
+    const ecs = createActionECS()
+        .withComponents({
+        position: { type: "string" },
+    })
+        .withComponents({
+        size: { type: "number" },
+    })
+        .withResources({
+        gravity: 9.8,
+    })
+        .withResources({
+        time: 0,
+    })
+        .withArchetypes({
+        position_size: ["id", "position", "size"],
+        position: ["id", "position"],
+    });
+}
+//# sourceMappingURL=action-ecs.test.js.map

package/ecs/action-ecs/action-ecs.test.js.map

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