@adobe/data 0.2.9 → 0.2.10

package/dist/ecs/transaction-ecs/transaction-types.d.ts

@@ -0,0 +1,135 @@
+import { Data, FromSchema, Schema } from "../../core/index.js";
+import { Observe } from "../../observe/types.js";
+import { Simplify } from "../../types/types.js";
+import { EntityCreateValues, Entity, EntityValues, EntityUpdateValues, CoreComponents } from "../core-ecs/core-ecs-types.js";
+import { Archetype, ECS, ECSArchetypes, ECSComponents, ECSResources, ECSWrite, SelectOptions } from "../ecs/ecs-types.js";
+export interface TransactionECS<C extends ECSComponents, //  name => Component Value Type
+A extends ECSArchetypes, //  name => Entity Values Type
+R extends ECSResources> extends Pick<ECS<C, A, R>, "components" | "archetypes" | "getComponentValue" | "getArchetype" | "getEntityValues" | "countEntities" | "selectEntities" | "selectEntityValues" | "toJSON">, TransactionProvider<C, A, R> {
+    resources: {
+        +readonly [K in keyof R]: R[K];
+    };
+    withComponents<S extends {
+        [K: string]: Schema;
+    }, T = {
+        -readonly [K in keyof S]: FromSchema<S[K]>;
+    }>(components: S): TransactionECS<Simplify<C & T>, A, R>;
+    withArchetypes<S extends {
+        [K: string]: ReadonlyArray<keyof C>;
+    }>(archetypes: S): TransactionECS<C, Simplify<A & {
+        [AN in keyof S]: Archetype<{
+            [PN in S[AN][number]]: C[PN];
+        }>;
+    }>, R>;
+    withResources<S extends {
+        [K: string]: Data;
+    }>(resources: S): TransactionECS<C, A, Simplify<R & S>>;
+    observe: TransactionObservables<C, A, R>;
+}
+export interface TransactionObservables<C extends ECSComponents = any, //  name => Component Value Type
+A extends ECSArchetypes = any, //  name => Entity Values Type
+R extends ECSResources = any> {
+    transactions: Observe<TransactionCommit<C>>;
+    resource: {
+        <K extends keyof R>(key: K): Observe<R[K]>;
+    } & {
+        [K in keyof R]: Observe<R[K]>;
+    };
+    entityValues<A extends Archetype>(id: Entity, archetype: A & Partial<EntityValues<C>>): Observe<EntityValuesFor<A> | null | undefined>;
+    entityValues(id: Entity): Observe<EntityValues<C> | undefined>;
+    entityChanges(entity: Entity): Observe<void>;
+    componentChanges<K extends keyof C>(component: K): Observe<void>;
+    archetypeChanges<A extends CoreComponents>(archetype: Archetype<A>): Observe<void>;
+    archetypeEntities<A extends CoreComponents>(archetype: Archetype<A>, options?: Omit<SelectOptions<C, A>, "components">): Observe<Entity[]>;
+}
+/**
+ * Options when creating an ECSTransaction.
+ */
+export interface TransactionOptions {
+    /**
+     * Will this transaction be added to the undo stack?
+     * Defaults to true.
+     */
+    undoable?: boolean;
+    /**
+     * When was this transactions created in UTC time.
+     */
+    createdTime?: number;
+    /**
+     * The unique identifier for the user creating the transaction.
+     */
+    createdBy?: string;
+}
+interface TransactionProvider<C extends ECSComponents, //  name => Component Value Type
+A extends ECSArchetypes, //  name => Entity Values Type
+R extends ECSResources> {
+    createTransaction(options?: TransactionOptions): Transaction<C, A, R>;
+}
+/**
+ * Type alias for a CreateOperation in the ECS (Entity Component System).
+ * Represents an operation to create a new entity with the specified components.
+ * @template C - Components used by the entity.
+ */
+export type TransactionCreateOperation<C> = {
+    type: "create";
+    values: EntityCreateValues<C>;
+};
+/**
+ * Type alias for an UpdateOperation in the ECS (Entity Component System).
+ * Represents an operation to update an existing entity with the specified components.
+ * @template C - Components used by the entity.
+ */
+export type TransactionUpdateOperation<C> = {
+    type: "update";
+    entity: Entity;
+    values: EntityUpdateValues<C>;
+};
+/**
+ * Type alias for a DeleteOperation in the ECS (Entity Component System).
+ * Represents an operation to delete an existing entity.
+ */
+export type TransactionDeleteOperation = {
+    type: "delete";
+    entity: Entity;
+};
+/**
+ * Type alias for a WriteOperation in the ECS (Entity Component System).
+ * Represents an operation to create, update, or delete an entity.
+ * @template C - Components used by the entity.
+ */
+export type TransactionWriteOperation<C> = TransactionCreateOperation<C> | TransactionUpdateOperation<C> | TransactionDeleteOperation;
+/**
+ * Represents a completed transaction in the ECS, which can either be a commit or a cancel.
+ * @template C - Components used in the transaction.
+ */
+export type TransactionComplete<C> = TransactionCommit<C> | TransactionCancel;
+/**
+ * Represents a committed transaction in the ECS.
+ * @template C - Components used in the transaction.
+ */
+export interface TransactionCommit<C> {
+    committed: true;
+    options: TransactionOptions;
+    redoOperations: TransactionWriteOperation<C>[];
+    undoOperations: TransactionWriteOperation<C>[];
+}
+/**
+ * Represents a cancelled transaction in the ECS.
+ */
+export interface TransactionCancel {
+    committed: false;
+    options: TransactionOptions;
+}
+export interface Transaction<C extends ECSComponents, //  name => Component Value Type
+A extends ECSArchetypes, //  name => Entity Values Type
+R extends ECSResources> extends TransactionProvider<C, A, R>, ECSWrite<C> {
+    readonly ecs: TransactionECS<C, A, R>;
+    readonly options: Required<TransactionOptions>;
+    readonly resources: {
+        -readonly [K in keyof R]: R[K];
+    };
+    batch(operations: TransactionWriteOperation<C>[]): this;
+    commit(): TransactionCommit<C>;
+    cancel(): TransactionCancel;
+}
+export {};

package/dist/ecs/transaction-ecs/transaction-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transaction-types.js.map

package/dist/ecs/transaction-ecs/transaction-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-types.js","sourceRoot":"","sources":["../../../src/ecs/transaction-ecs/transaction-types.ts"],"names":[],"mappings":""}

package/dist/ecs/transaction-ecs/transactions.d.ts

@@ -0,0 +1,5 @@
+import { ECS, ECSArchetypes, ECSComponents, ECSResources } from "../ecs/ecs-types.js";
+import { Transaction, TransactionChanges, TransactionCommit, TransactionECS, TransactionOptions } from "./transaction-types.js";
+export declare function createECSTransaction<C extends ECSComponents, //  name => Component Value Type
+A extends ECSArchetypes, //  name => Entity Values Type
+R extends ECSResources>(tecs: TransactionECS<C, A, R>, ecs: ECS<C, A, R>, options: Required<TransactionOptions>, transactionCommmitted: (value: TransactionCommit<C>, changes: TransactionChanges<C>) => void, parent?: Transaction<C, A, R>): Transaction<C, A, R>;

package/dist/ecs/transaction-ecs/transactions.js

@@ -0,0 +1,158 @@
+/*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 { DELETE } from "../core-ecs/core-ecs.js";
+export function createECSTransaction(tecs, ecs, options, transactionCommmitted, parent) {
+    const write = parent ?? ecs;
+    const redoOperations = [];
+    const undoOperationsInReverseOrder = [];
+    const changed = {
+        entities: new Set(),
+        components: new Set(),
+        archetypes: new Set(),
+    };
+    function createEntity(archetype, values) {
+        const entity = archetype && values
+            ? write.createEntity(archetype, values)
+            : write.createEntity();
+        redoOperations.push({
+            type: "create",
+            values: (values ?? {}),
+        });
+        undoOperationsInReverseOrder.push({ type: "delete", entity });
+        changed.entities.add(entity);
+        changed.archetypes.add(ecs.getEntityArchetype(entity));
+        for (const key in values) {
+            changed.components.add(key);
+        }
+        return entity;
+    }
+    function updateEntity(entity, values) {
+        const oldValues = ecs.getEntityValues(entity);
+        const replacedValues = {};
+        for (const name in values) {
+            const newValue = values[name];
+            let oldValue = oldValues[name];
+            if (newValue !== oldValue) {
+                if (oldValue === undefined) {
+                    oldValue = DELETE;
+                }
+                replacedValues[name] = oldValue;
+                changed.components.add(name);
+            }
+        }
+        changed.entities.add(entity);
+        changed.archetypes.add(ecs.getEntityArchetype(entity));
+        write.updateEntity(entity, values);
+        //  archetype may have changed after update so we need to add new one.
+        changed.archetypes.add(ecs.getEntityArchetype(entity));
+        // maybe collapse adjacent updates to same entity.
+        const lastUndoOperation = undoOperationsInReverseOrder[undoOperationsInReverseOrder.length - 1];
+        if (lastUndoOperation?.type === "update" &&
+            lastUndoOperation.entity === entity) {
+            const lastRedoOperation = redoOperations[redoOperations.length - 1];
+            lastRedoOperation.values = { ...lastRedoOperation.values, ...values };
+            lastUndoOperation.values = {
+                ...replacedValues,
+                ...lastUndoOperation.values,
+            };
+        }
+        else {
+            redoOperations.push({ type: "update", entity, values });
+            undoOperationsInReverseOrder.push({
+                type: "update",
+                entity,
+                values: replacedValues,
+            });
+        }
+    }
+    function deleteEntity(entity) {
+        changed.archetypes.add(ecs.getEntityArchetype(entity));
+        changed.entities.add(entity);
+        const { id: _ignore, ...oldValues } = ecs.getEntityValues(entity);
+        for (const key in oldValues) {
+            changed.components.add(key);
+        }
+        write.deleteEntity(entity);
+        redoOperations.push({ type: "delete", entity });
+        undoOperationsInReverseOrder.push({ type: "create", values: oldValues });
+    }
+    function batch(operations) {
+        for (const operation of operations) {
+            switch (operation.type) {
+                case "create": {
+                    const archetype = ecs.getArchetype("id", ...Object.keys(operation.values));
+                    createEntity(archetype, operation.values);
+                    break;
+                }
+                case "update":
+                    updateEntity(operation.entity, operation.values);
+                    break;
+                case "delete":
+                    deleteEntity(operation.entity);
+                    break;
+            }
+        }
+        return transaction;
+    }
+    function complete(committed) {
+        const undoOperations = undoOperationsInReverseOrder.slice(0).reverse();
+        if (!committed) {
+            batch(undoOperations);
+        }
+        if (committed) {
+            const result = { committed, options, redoOperations, undoOperations };
+            if (!parent && committed) {
+                transactionCommmitted(result, changed);
+            }
+            return result;
+        }
+        else {
+            return { committed, options };
+        }
+    }
+    const setComponentValue = (id, component, value) => {
+        updateEntity(id, { [component]: value });
+    };
+    const transaction = {
+        ecs: tecs,
+        options,
+        resources: new Proxy(ecs.resources, {
+            set: (_target, p, value, _receiver) => {
+                const archetype = ecs.getArchetype("id", p);
+                const [table] = ecs.getTables(archetype, { mode: "read", exact: true });
+                const id = table.columns.id.get(0);
+                updateEntity(id, { [p]: value });
+                return true;
+            },
+        }),
+        setComponentValue,
+        createTransaction: () => createECSTransaction(tecs, ecs, options, transactionCommmitted, transaction),
+        batch,
+        commit: () => complete(true),
+        cancel: () => complete(false),
+        createEntity,
+        updateEntity,
+        deleteEntity,
+    };
+    return transaction;
+}
+//# sourceMappingURL=transactions.js.map

package/dist/ecs/transaction-ecs/transactions.js.map

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

package/dist/internal/typed-array/get-byte-size.d.ts

@@ -1,2 +1,2 @@
 import type { TypedArrayConstructor } from "../../types/typed-array-constructer.js";
-export declare const getByteSize: (typedArrayConstructor: TypedArrayConstructor) => 4 | 8 | 1 | 2;
+export declare const getByteSize: (typedArrayConstructor: TypedArrayConstructor) => 1 | 2 | 4 | 8;

package/dist/package.json

@@ -0,0 +1,129 @@
+{
+  "name": "@adobe/data",
+  "version": "0.2.0",
+  "description": "Adobe data oriented programming library",
+  "type": "module",
+  "sideEffects": true,
+  "private": false,
+  "scripts": {
+    "build": "pnpm build-assembly && run-p build:*",
+    "build:code": "pnpm copy && tsc -b",
+    "build:apidocs": "typedoc",
+    "build-assembly": "run-p asbuild:release",
+    "clean": "rm -rf dist build node_modules",
+    "copy": "mkdir -p dist && cp README.md dist && sed '/publish\":/d' package.json > dist/package.json",
+    "deploy-docs": "pnpm build && ./scripts/deploy-docs.sh",
+    "dev": "run-p dev:*",
+    "dev:build": "pnpm copy && tsc -b -w --preserveWatchOutput",
+    "dev:test": "pnpm test",
+    "dev:apidocs": "nodemon -w README.md -w dist -x typedoc --delay 100",
+    "dev:assembly": "nodemon -w assembly -e ts -x pnpm run asbuild:release --delay 100",
+    "lint": "pnpm eslint .",
+    "lint-fix": "pnpm eslint . --fix",
+    "debug": "vitest --inspect-brk --no-file-parallelism --test-timeout 1000000",
+    "link": "pnpm build && pnpm link --global",
+    "bump": "pnpm version patch --no-git-tag-version && git commit -am 'bumped patch version' && pnpm run publish",
+    "pre-commit": "lint-staged",
+    "perftest": "node dist/perftest/index.js",
+    "test": "vitest",
+    "asbuild:debug": "asc assembly/index.ts -o dist/assembly/index.wasm --target debug --enable simd && echo built dist/assembly/index.wasm",
+    "asbuild:release": "asc assembly/index.ts -o dist/assembly/index.wasm --target release --enable simd --optimize && echo built dist/assembly/index.wasm",
+    "start": "npx serve ."
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./cache": {
+      "import": "./dist/cache/index.js",
+      "types": "./dist/cache/index.d.ts"
+    },
+    "./schema": {
+      "import": "./dist/schema/index.js",
+      "types": "./dist/schema/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types/index.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./observe": {
+      "import": "./dist/observe/index.js",
+      "types": "./dist/observe/index.d.ts"
+    },
+    "./ecs": {
+      "import": "./dist/ecs/index.js",
+      "types": "./dist/ecs/index.d.ts"
+    },
+    "./old-ecs": {
+      "import": "./dist/old-ecs/index.js",
+      "types": "./dist/old-ecs/index.d.ts"
+    },
+    "./lit": {
+      "import": "./dist/lit/index.js",
+      "types": "./dist/lit/index.d.ts"
+    },
+    "./service": {
+      "import": "./dist/service/index.js",
+      "types": "./dist/service/index.d.ts"
+    },
+    "./table": {
+      "import": "./dist/table/index.js",
+      "types": "./dist/table/index.d.ts"
+    },
+    "./typed-buffer": {
+      "import": "./dist/typed-buffer/index.js",
+      "types": "./dist/typed-buffer/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "@assemblyscript/loader": "^0.27.30",
+    "@trivago/prettier-plugin-sort-imports": "^4.3.0",
+    "@types/jsonpath": "^0.2.4",
+    "@types/uuid": "^10.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "@vitest/browser": "^1.6.0",
+    "@webgpu/types": "^0.1.61",
+    "assemblyscript": "^0.27.30",
+    "eslint": "^8.56.0",
+    "eslint-config-airbnb-typescript": "^17.1.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-formatter-pretty": "^5.0.0",
+    "eslint-plugin-header": "^3.1.1",
+    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-lit": "^1.11.0",
+    "eslint-plugin-lit-a11y": "^4.1.2",
+    "eslint-plugin-notice": "^0.9.10",
+    "eslint-plugin-prettier": "^5.1.3",
+    "glob": "^10.3.10",
+    "jsdom": "^24.1.0",
+    "lint-staged": "^13.2.2",
+    "nodemon": "^3.1.7",
+    "npm-run-all": "^4.1.5",
+    "playwright": "^1.46.1",
+    "prettier": "^3.2.5",
+    "prettier-package-json": "^2.8.0",
+    "pretty-quick": "^4.0.0",
+    "riteway": "v8.0.0-RC4",
+    "stylelint": "^16.2.1",
+    "stylelint-config-standard": "^36.0.0",
+    "typedoc": "^0.26.7",
+    "typescript": "^5.8.3",
+    "uuid": "^10.0.0",
+    "vite": "^5.1.1",
+    "vitest": "^1.6.0",
+    "webdriverio": "^9.0.9"
+  },
+  "lint-staged": {
+    "*.ts": "pnpm lint:ts && pnpm lint:css",
+    "*.css": "pnpm lint:css",
+    "package.json": "pnpm lint:packagejson"
+  },
+  "dependencies": {
+    "@cfworker/json-schema": "^4.1.1",
+    "@lit/context": "^1.1.5",
+    "jsonpath": "^1.1.1",
+    "lit": "^3.3.0"
+  }
+}

package/dist/schema/schema.d.ts

@@ -59,6 +59,7 @@ export type FromSchemas<T> = {
     [K in keyof T]: FromSchema<T[K]>;
 };
 export type FromSchema<T, Depth extends number = 5> = DeepReadonly<Depth extends 0 ? any : T extends {
+    type?: undefined;
     default: infer D;
 } ? D : T extends {
     const: infer Const;

package/dist/schemas/index.d.ts

@@ -0,0 +1 @@
+export * from "../core/schemas.js";

package/dist/schemas/index.js

@@ -0,0 +1,23 @@
+/*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.*/
+export * from "../core/schemas.js";
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,cAAc,oBAAoB,CAAC"}

package/dist/schemas/schemas.d.ts

@@ -0,0 +1,45 @@
+import { Schema } from "../core/index.js";
+export declare function Nullable<T extends Schema>(schema: T): {
+    oneOf: [T, {
+        type: "null";
+    }];
+};
+export declare function Tuple<T extends Schema, N extends number>(items: T, length: N): {
+    readonly type: "array";
+    readonly items: T;
+    readonly minItems: N;
+    readonly maxItems: N;
+};
+export declare const TrueSchema: {
+    readonly const: true;
+};
+export declare const BooleanSchema: {
+    readonly type: "boolean";
+};
+export declare const Float32Schema: {
+    readonly type: "number";
+    readonly precision: 1;
+};
+export declare const Float64Schema: {
+    readonly type: "number";
+    readonly precision: 2;
+};
+export declare const TimeSchema: {
+    readonly type: "number";
+    readonly precision: 2;
+};
+export declare const Uint8Schema: {
+    readonly type: "integer";
+    readonly minimum: 0;
+    readonly maximum: 255;
+};
+export declare const Uint16Schema: {
+    readonly type: "integer";
+    readonly minimum: 0;
+    readonly maximum: 65535;
+};
+export declare const Uint32Schema: {
+    readonly type: "integer";
+    readonly minimum: 0;
+    readonly maximum: 4294967295;
+};

package/dist/schemas/schemas.js

@@ -0,0 +1,39 @@
+export function Nullable(schema) {
+    return {
+        oneOf: [schema, { type: "null" }],
+    };
+}
+export function Tuple(items, length) {
+    return { type: "array", items, minItems: length, maxItems: length };
+}
+export const TrueSchema = {
+    const: true,
+};
+export const BooleanSchema = {
+    type: "boolean",
+};
+export const Float32Schema = {
+    type: "number",
+    precision: 1,
+};
+export const Float64Schema = {
+    type: "number",
+    precision: 2,
+};
+export const TimeSchema = Float64Schema;
+export const Uint8Schema = {
+    type: "integer",
+    minimum: 0,
+    maximum: 0xff,
+};
+export const Uint16Schema = {
+    type: "integer",
+    minimum: 0,
+    maximum: 0xffff,
+};
+export const Uint32Schema = {
+    type: "integer",
+    minimum: 0,
+    maximum: 0xffffffff,
+};
+//# sourceMappingURL=schemas.js.map

package/dist/schemas/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/schemas/schemas.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,QAAQ,CACtB,MAAS;IAET,OAAO;QACL,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,KAAK,CAAqC,KAAQ,EAAE,MAAS;IAC3E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAA4B,CAAC;AAChG,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,IAAI;CACc,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,SAAS;CACU,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,CAAC;CACa,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,CAAC;CACa,CAAC;AAE5B,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AAExC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,IAAI;CACY,CAAC;AAE5B,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,MAAM;CACU,CAAC;AAE5B,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,UAAU;CACM,CAAC"}

package/dist/service/sequential-action.d.ts

@@ -0,0 +1,18 @@
+import { Data } from '../core/data.js';
+export type SequentialActionResult<Args extends Data[]> = {
+    update: (...args: Args) => SequentialActionResult<Args>;
+    cancel: () => void;
+    commit: () => void;
+};
+/**
+ * A function that represents a transient, sequential series of actions that must end with a commit or cancel.
+ * This is the only service action which can return a value other than void.
+ * It is intended to be used for multiframe transactions.
+ */
+export type SequentialAction<Args extends Data[]> = (...args: Args) => SequentialActionResult<Args>;
+/**
+ * Executes a sequential action using an async iterable iterator that provides the arguments.
+ * @param action - The action to execute.
+ * @param argProvider - An async iterable iterator of arguments to pass to the action.
+ */
+export declare function executeSequentialAction<Arg extends Data>(action: SequentialAction<[Arg]>, argProvider: AsyncIterableIterator<Arg>): Promise<void>;

package/dist/service/sequential-action.js

@@ -0,0 +1,45 @@
+/*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.*/
+/**
+ * Executes a sequential action using an async iterable iterator that provides the arguments.
+ * @param action - The action to execute.
+ * @param argProvider - An async iterable iterator of arguments to pass to the action.
+ */
+export async function executeSequentialAction(action, argProvider) {
+    let sequence;
+    try {
+        //  get the next arguments from the arg provider
+        for await (const arg of argProvider) {
+            //  then write them into the multiframe transaction (persisting this set of updates into database)
+            sequence = (sequence?.update ?? action)(arg);
+        }
+        //  everything succeeded, finalize this transaction.
+        sequence?.commit();
+    }
+    catch (e) {
+        //  cancel the sequence
+        sequence?.cancel();
+        //  allow the async iterable iterator to finalize and close any open resources
+        argProvider.throw?.(e);
+    }
+}
+//# sourceMappingURL=sequential-action.js.map

package/dist/service/sequential-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequential-action.js","sourceRoot":"","sources":["../../src/service/sequential-action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAiBX;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAmB,MAA+B,EAAE,WAAuC;IACpI,IAAI,QAAmD,CAAC;IACxD,IAAI,CAAC;QACD,gDAAgD;QAChD,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAClC,kGAAkG;YAClG,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;QACjD,CAAC;QACD,oDAAoD;QACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,CAAC,EAAE,CAAC;QACP,uBAAuB;QACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,8EAA8E;QAC9E,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;AACL,CAAC"}