@adobe/data 0.9.4 → 0.9.6

package/ecs/database/create-plugin-type.type.test.js

@@ -0,0 +1,563 @@
+/*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 { createPlugin } from "./create-plugin.js";
+/**
+ * Type-only tests for createPlugin type inference and constraints.
+ *
+ * These tests verify that:
+ * 1. Type inference works correctly for all valid plugin configurations
+ * 2. Invalid property usage is properly blocked by TypeScript
+ *
+ * Note: These are compile-time type checks only - they don't need to execute.
+ */
+// ============================================================================
+// VALID TYPE INFERENCE TESTS
+// ============================================================================
+function validTypeInferenceTests() {
+    // Test: Empty plugin inference
+    const emptyPlugin = createPlugin({});
+    // type CheckEmptyPlugin = Assert<Equal<typeof emptyPlugin, Database.Plugin<{}, {}, {}, {}, never, {}>>>;
+    // Test: Valid archetype component references
+    const validArchetypePlugin = createPlugin({
+        components: {
+            a: { type: "number" },
+            b: { type: "string" }
+        },
+        archetypes: {
+            A: ["a", "b"],
+            ABTransient: ["a", "b", "transient"],
+            Transient: ["transient"],
+        }
+    });
+    // Test: Valid transactions with components, resources, and archetypes
+    const validTransactionPlugin = createPlugin({
+        components: {
+            a: { type: "number" },
+            b: { type: "string" }
+        },
+        resources: {
+            c: { default: false }
+        },
+        archetypes: {
+            A: ["a", "b"],
+            ABTransient: ["a", "b", "transient"],
+        },
+        transactions: {
+            testChanges: (store) => {
+                // valid resource assignment
+                store.resources.c = true;
+                // valid archetype 
+                store.archetypes.A.insert({ a: 1, b: "2" });
+                // valid update
+                store.update(0, { a: 2 });
+            }
+        },
+    });
+    // Test: Valid systems with transactions
+    const validSystemPlugin = createPlugin({
+        components: {
+            a: { type: "number" },
+            b: { type: "string" }
+        },
+        resources: {
+            c: { default: false }
+        },
+        archetypes: {
+            A: ["a", "b"],
+        },
+        transactions: {
+            testChanges: (store) => {
+                store.resources.c = true;
+            }
+        },
+        systems: {
+            update: {
+                create: (db) => () => {
+                    db.transactions.testChanges();
+                }
+            },
+            render: {
+                create: (db) => () => { },
+                schedule: {
+                    after: ["update"],
+                }
+            }
+        },
+    });
+    // Test: Valid base plugin with all properties
+    const basePlugin = createPlugin({
+        components: {
+            alpha: { type: "number" },
+            beta: { type: "string" }
+        },
+        resources: {
+            charlie: { default: false }
+        },
+        archetypes: {
+            Foo: ["alpha", "beta"],
+            FooTransient: ["alpha", "beta", "transient"],
+        },
+        transactions: {
+            doAlpha: (store, input) => { },
+            doBeta: (store) => { }
+        },
+        actions: {
+            doAction: (db) => {
+                db.transactions.doAlpha({ a: 1, b: "2" });
+                db.transactions.doBeta();
+            },
+            doOtherAction: (db) => {
+            }
+        },
+        systems: {
+            input: {
+                create: (db) => () => {
+                    db.transactions.doAlpha({ a: 1, b: "2" });
+                    db.transactions.doBeta();
+                }
+            },
+            output: {
+                create: (db) => () => {
+                    db.actions.doAction();
+                    db.actions.doOtherAction();
+                }
+            }
+        },
+    });
+    // Test: Valid extended plugin accessing base plugin properties
+    const extendedPlugin = createPlugin({
+        components: {
+            a: { type: "number" },
+            b: { type: "string" },
+        },
+        resources: {
+            c: { default: false }
+        },
+        archetypes: {
+            A: ["a", "b", "alpha", "beta"],
+            ABTransient: ["a", "b", "alpha", "beta", "transient"],
+        },
+        transactions: {
+            testChanges: (store) => {
+                // assign to resources from this plugin
+                store.resources.c = true;
+                // valid archetype 
+                store.archetypes.A.insert({ a: 1, b: "2", alpha: 3, beta: "4" });
+                // valid update using base components
+                store.update(0, { a: 2, alpha: 3 });
+            }
+        },
+        systems: {
+            update: {
+                create: (db) => () => {
+                    db.transactions.doAlpha({ a: 1, b: "2" });
+                    db.transactions.doBeta();
+                    db.transactions.testChanges();
+                },
+                schedule: {},
+            },
+            render: {
+                create: (db) => () => {
+                    db.transactions.testChanges();
+                },
+                schedule: {},
+            }
+        },
+        actions: {
+            doExtendedAction: (db) => {
+                db.transactions.doAlpha({ a: 1, b: "2" });
+                db.transactions.doBeta();
+                db.transactions.testChanges();
+            },
+            doOtherExtendedAction: (db) => {
+            }
+        },
+        extends: basePlugin
+    });
+}
+// ============================================================================
+// INVALID TYPE INFERENCE TESTS
+// ============================================================================
+/**
+ * ⚠️ CRITICAL: Why Invalid Tests Must Be Isolated
+ *
+ * Invalid type tests (those using @ts-expect-error) MUST be in separate
+ * plugin definitions from valid tests. This is because:
+ *
+ * 1. **Type Inference Failure Propagation**: When TypeScript encounters a type
+ *    error in a plugin definition, it can cause the entire plugin's type
+ *    inference to fail or degrade. This means that if you have both valid and
+ *    invalid usage in the same plugin, the invalid errors can break the
+ *    inference for the valid parts, making it impossible to verify that valid
+ *    code actually works correctly.
+ *
+ * 2. **Constraint Satisfaction**: The createPlugin function uses complex
+ *    generic constraints that depend on all properties being valid. If one
+ *    property has an error, TypeScript may fail to satisfy the constraints
+ *    for other properties, even if those other properties are themselves valid.
+ *
+ * 3. **Type Narrowing**: Errors in one part of a plugin can cause TypeScript
+ *    to narrow types incorrectly or give up on inference entirely, leading to
+ *    `any` types or overly permissive types that don't actually test what we
+ *    want to test.
+ *
+ * 4. **Test Isolation**: By isolating invalid tests, we ensure that:
+ *    - Each test verifies exactly one constraint
+ *    - Valid inference tests aren't affected by invalid ones
+ *    - We can verify that our type system actually blocks invalid usage
+ *      rather than just allowing `any` types
+ *
+ * Therefore, each invalid test below is in its own isolated plugin definition
+ * that only tests the specific invalid usage pattern.
+ */
+// Test: Invalid archetype component reference (no components defined)
+function invalidArchetypeComponentReference() {
+    createPlugin({
+        archetypes: {
+            // @ts-expect-error - invalid archetype reference (component "bar" does not exist)
+            InvalidArchetype: ["bar"],
+        }
+    });
+}
+// Test: Invalid archetype component reference (component not in schema)
+function invalidArchetypeComponentReference2() {
+    createPlugin({
+        components: {
+            a: { type: "number" }
+        },
+        archetypes: {
+            // @ts-expect-error - invalid archetype reference (component "b" does not exist)
+            InvalidArchetype: ["b"],
+        }
+    });
+}
+// Test: Invalid resource access in transaction
+function invalidResourceAccessInTransaction() {
+    createPlugin({
+        resources: {
+            c: { default: false }
+        },
+        transactions: {
+            testChanges: (store) => {
+                // @ts-expect-error - invalid resource assignment (resource "d" does not exist)
+                store.resources.d = true;
+            }
+        },
+    });
+}
+// Test: Invalid archetype access in transaction
+function invalidArchetypeAccessInTransaction() {
+    createPlugin({
+        components: {
+            a: { type: "number" }
+        },
+        archetypes: {
+            A: ["a"],
+        },
+        transactions: {
+            testChanges: (store) => {
+                // @ts-expect-error - invalid archetype reference (archetype "foo" does not exist)
+                store.archetypes.foo;
+            }
+        },
+    });
+}
+// Test: Invalid component update in transaction
+function invalidComponentUpdateInTransaction() {
+    createPlugin({
+        components: {
+            a: { type: "number" },
+            b: { type: "string" }
+        },
+        transactions: {
+            testChanges: (store) => {
+                // @ts-expect-error - invalid update (component "d" does not exist)
+                store.update(0, { d: 10 });
+            }
+        },
+    });
+}
+// Test: Invalid system self-reference in schedule
+function invalidSystemSelfReference() {
+    createPlugin({
+        systems: {
+            render: {
+                create: (db) => () => { },
+                schedule: {
+                    // @ts-expect-error - render would be a self-reference (prevented by Exclude<S | SX, K>)
+                    before: ["render"],
+                }
+            }
+        },
+    });
+}
+// Test: Invalid system reference in schedule
+function invalidSystemReference() {
+    createPlugin({
+        systems: {
+            update: {
+                create: (db) => () => { },
+            },
+            render: {
+                create: (db) => () => { },
+                schedule: {
+                    // @ts-expect-error - invalid system reference (system "invalid" does not exist)
+                    during: ["invalid"],
+                }
+            }
+        },
+    });
+}
+// Test: Invalid transaction call in action
+function invalidTransactionCallInAction() {
+    createPlugin({
+        transactions: {
+            validTransaction: (store) => { },
+        },
+        actions: {
+            doAction: (db) => {
+                // @ts-expect-error - invalid transaction call (transaction "doesNotExist" does not exist)
+                db.transactions.doesNotExist();
+            }
+        },
+    });
+}
+// Test: Invalid action call in system
+function invalidActionCallInSystem() {
+    createPlugin({
+        actions: {
+            validAction: (db) => { },
+        },
+        systems: {
+            testSystem: {
+                create: (db) => () => {
+                    // @ts-expect-error - invalid action call (action "doesNotExist" does not exist)
+                    db.actions.doesNotExist();
+                }
+            }
+        },
+    });
+}
+// Test: Invalid resource access in system
+function invalidResourceAccessInSystem() {
+    createPlugin({
+        resources: {
+            validResource: { default: 0 }
+        },
+        systems: {
+            testSystem: {
+                create: (db) => () => {
+                    // @ts-expect-error - invalid resource access (resource "invalidResource" does not exist)
+                    const value = db.resources.invalidResource;
+                }
+            }
+        },
+    });
+}
+// Test: Invalid archetype access in system
+function invalidArchetypeAccessInSystem() {
+    createPlugin({
+        components: {
+            a: { type: "number" }
+        },
+        archetypes: {
+            A: ["a"],
+        },
+        systems: {
+            testSystem: {
+                create: (db) => () => {
+                    // @ts-expect-error - invalid archetype access (archetype "invalid" does not exist)
+                    db.archetypes.invalid;
+                }
+            }
+        },
+    });
+}
+// Test: Invalid extended plugin - invalid resource access
+function invalidExtendedPluginResourceAccess() {
+    const basePlugin = createPlugin({
+        resources: {
+            charlie: { default: false }
+        },
+    });
+    createPlugin({
+        resources: {
+            c: { default: false }
+        },
+        transactions: {
+            testChanges: (store) => {
+                // @ts-expect-error - invalid resource assignment (resource "delta" does not exist in base or current)
+                store.resources.delta = true;
+            }
+        },
+        extends: basePlugin
+    });
+}
+// Test: Invalid extended plugin - invalid archetype access
+function invalidExtendedPluginArchetypeAccess() {
+    const basePlugin = createPlugin({
+        components: {
+            alpha: { type: "number" }
+        },
+        archetypes: {
+            Foo: ["alpha"],
+        },
+    });
+    createPlugin({
+        components: {
+            a: { type: "number" }
+        },
+        transactions: {
+            testChanges: (store) => {
+                // @ts-expect-error - invalid archetype reference (archetype "foo" does not exist in base or current)
+                store.archetypes.foo;
+            }
+        },
+        extends: basePlugin
+    });
+}
+// Test: Invalid extended plugin - invalid system reference in schedule
+function invalidExtendedPluginSystemReference() {
+    const basePlugin = createPlugin({
+        systems: {
+            input: {
+                create: (db) => () => { },
+            }
+        },
+    });
+    createPlugin({
+        systems: {
+            render: {
+                create: (db) => () => { },
+                schedule: {
+                    // @ts-expect-error - invalid system reference (system "invalid" does not exist in base or current)
+                    after: ["invalid"],
+                }
+            }
+        },
+        extends: basePlugin
+    });
+}
+// Test: Invalid extended plugin - invalid transaction call
+function invalidExtendedPluginTransactionCall() {
+    const basePlugin = createPlugin({
+        transactions: {
+            doAlpha: (store) => { },
+        },
+    });
+    createPlugin({
+        systems: {
+            testSystem: {
+                create: (db) => () => {
+                    // @ts-expect-error - invalid transaction call (transaction "doesNotExist" does not exist)
+                    db.transactions.doesNotExist();
+                    db.transactions.doAlpha();
+                    // @ts-expect-error - invalid transaction call (transaction "doAlpha" does not takes input)
+                    db.transactions.doAlpha({ a: 1, b: "2" });
+                }
+            }
+        },
+        extends: basePlugin
+    });
+}
+// Test: Invalid extended plugin - invalid action call
+function invalidExtendedPluginActionCall() {
+    const basePlugin = createPlugin({
+        actions: {
+            doAction: (db) => { },
+        },
+    });
+    createPlugin({
+        systems: {
+            testSystem: {
+                create: (db) => () => {
+                    // @ts-expect-error - invalid action call (action "doesNotExist" does not exist)
+                    db.actions.doesNotExist();
+                    db.actions.doAction();
+                    // @ts-expect-error - invalid action call (action "doAction" does not take input)
+                    db.actions.doAction({ a: 1, b: "2" });
+                }
+            }
+        },
+        extends: basePlugin
+    });
+}
+// Test: Invalid action call in action (same plugin) - actions can only call actions from extended plugin
+function invalidActionCallInActionSamePlugin() {
+    createPlugin({
+        actions: {
+            action1: (db) => {
+                // @ts-expect-error - actions cannot call other actions from same plugin (only from extended plugin)
+                db.actions.action2();
+            },
+            action2: (db) => { },
+        },
+    });
+}
+// Test: Invalid component access in transaction (component doesn't exist)
+function invalidComponentAccessInTransaction() {
+    createPlugin({
+        components: {
+            a: { type: "number" }
+        },
+        transactions: {
+            testChanges: (store) => {
+                // @ts-expect-error - invalid component access (component "b" does not exist)
+                const value = store.components.b;
+            }
+        },
+    });
+}
+// Test: Invalid component access in system (component doesn't exist)
+function invalidComponentAccessInSystem() {
+    createPlugin({
+        components: {
+            a: { type: "number" }
+        },
+        systems: {
+            testSystem: {
+                create: (db) => () => {
+                    // @ts-expect-error - invalid component access (component "b" does not exist)
+                    const value = db.components.b;
+                }
+            }
+        },
+    });
+}
+// Test: Valid action call in action (from extended plugin)
+function validActionCallInActionFromExtended() {
+    const basePlugin = createPlugin({
+        actions: {
+            baseAction: (db) => { },
+        },
+    });
+    createPlugin({
+        actions: {
+            extendedAction: (db) => {
+                // Valid - can call actions from extended plugin
+                db.actions.baseAction();
+            }
+        },
+        extends: basePlugin
+    });
+}
+//# sourceMappingURL=create-plugin-type.type.test.js.map

package/ecs/database/create-plugin-type.type.test.js.map

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

package/ecs/database/create-plugin.d.ts

@@ -7,10 +7,41 @@ import type { ActionDeclarations, ToActionFunctions } from "../store/action-func
 import type { FromSchemas } from "../../schema/index.js";
 import type { StringKeyof, Simplify, NoInfer } from "../../types/types.js";
 import { CombinePlugins } from "./combine-plugins.js";
+import { Store } from "../store/store.js";
 type RemoveIndex<T> = Simplify<{
     [K in keyof T as string extends K ? never : number extends K ? never : symbol extends K ? never : K]: T[K];
 }>;
+/**
+ * Creates a Database.Plugin from a plugin descriptor.
+ *
+ * **IMPORTANT: Property Order Requirement**
+ *
+ * Properties MUST be defined in this exact order:
+ * 1. extends (optional) - Base plugin to extend
+ * 2. components (optional) - Component schema definitions
+ * 3. resources (optional) - Resource schema definitions
+ * 4. archetypes (optional) - Archetype definitions
+ * 5. transactions (optional) - Transaction declarations
+ * 6. actions (optional) - Action declarations
+ * 7. systems (optional) - System declarations
+ *
+ * Example:
+ * ```ts
+ * Database.Plugin.create({
+ *   extends: basePlugin,     // 1. extends first
+ *   components: { ... },     // 2. components
+ *   resources: { ... },      // 3. resources
+ *   archetypes: { ... },     // 4. archetypes
+ *   transactions: { ... },   // 5. transactions
+ *   actions: { ... },        // 6. actions
+ *   systems: { ... }         // 7. systems last
+ * })
+ * ```
+ *
+ * @throws Error if properties are not in the correct order
+ */
 export declare function createPlugin<const XP extends Database.Plugin<{}, {}, {}, {}, never, {}>, const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<RemoveIndex<CS> & XP['components']>>, const TD extends TransactionDeclarations<FromSchemas<RemoveIndex<CS> & XP['components']>, FromSchemas<RemoveIndex<RS> & XP['resources']>, RemoveIndex<A> & XP['archetypes']>, const AD, const S extends string = never>(plugins: {
+    extends?: XP;
     components?: CS;
     resources?: RS;
     archetypes?: A;
@@ -20,7 +51,9 @@ export declare function createPlugin<const XP extends Database.Plugin<{}, {}, {}
     };
     systems?: {
         readonly [K in S]: {
-            readonly create: (db: Database<FromSchemas<RemoveIndex<CS> & XP['components']>, FromSchemas<RemoveIndex<RS> & XP['resources']>, RemoveIndex<A> & XP['archetypes'], ToTransactionFunctions<RemoveIndex<TD> & XP['transactions']>, string, ToActionFunctions<RemoveIndex<AD> & XP['actions']>>) => SystemFunction | void;
+            readonly create: (db: Database<FromSchemas<RemoveIndex<CS> & XP['components']>, FromSchemas<RemoveIndex<RS> & XP['resources']>, RemoveIndex<A> & XP['archetypes'], ToTransactionFunctions<RemoveIndex<TD> & XP['transactions']>, string, ToActionFunctions<RemoveIndex<AD> & XP['actions']>> & {
+                readonly store: Store<FromSchemas<RemoveIndex<CS> & XP['components']>, FromSchemas<RemoveIndex<RS> & XP['resources']>, RemoveIndex<A> & XP['archetypes']>;
+            }) => SystemFunction | void;
             readonly schedule?: {
                 readonly before?: readonly NoInfer<Exclude<S | StringKeyof<XP['systems']>, K>>[];
                 readonly after?: readonly NoInfer<Exclude<S | StringKeyof<XP['systems']>, K>>[];
@@ -28,7 +61,6 @@ export declare function createPlugin<const XP extends Database.Plugin<{}, {}, {}
             };
         };
     };
-    extends?: XP;
 }): CombinePlugins<[
     XP,
     Database.Plugin<RemoveIndex<CS>, RemoveIndex<RS>, RemoveIndex<A>, RemoveIndex<TD>, S, AD & ActionDeclarations<FromSchemas<RemoveIndex<CS>>, FromSchemas<RemoveIndex<RS>>, RemoveIndex<A>, ToTransactionFunctions<RemoveIndex<TD>>, S>>