@adobe/data 0.9.20 → 0.9.22

package/dist/service/dynamic-service/create.d.ts

@@ -0,0 +1,84 @@
+import { Observe } from "../../observe/index.js";
+import { Schema } from "../../schema/index.js";
+import type { ActionError } from "./dynamic-service.js";
+import type { DynamicService } from "./dynamic-service.js";
+/**
+ * Internal types for the create configuration entries.
+ * These are the runtime shapes after going through the typed helpers.
+ */
+type StateEntry = {
+    schema: Schema;
+    enabled?: Observe<boolean>;
+    value: Observe<unknown>;
+};
+type ActionEntry = {
+    description: string;
+    schema: Schema | false;
+    enabled?: Observe<boolean>;
+    execute: (...args: any[]) => Promise<void | ActionError> | void;
+};
+/**
+ * Creates a typed state entry for use with `create()`.
+ * Captures the schema type as a direct generic parameter, ensuring
+ * Schema.ToType<S> resolves correctly for the value observable.
+ */
+export declare const state: <const S extends Schema>(config: {
+    schema: S;
+    enabled?: Observe<boolean>;
+    value: Observe<Schema.ToType<S>>;
+}) => StateEntry;
+/**
+ * Creates a typed action entry for use with `create()`.
+ * Captures the schema type as a direct generic parameter, ensuring
+ * Schema.ToType<S> resolves correctly for the execute input parameter.
+ *
+ * TypeScript cannot resolve Schema.ToType<AS[K]> through indexed access
+ * types in mapped types for complex schemas (objects, arrays, etc.).
+ * This helper works around that by using a direct generic S parameter.
+ */
+export declare const action: {
+    <const S extends Schema>(config: {
+        description: string;
+        schema: S;
+        enabled?: Observe<boolean>;
+        execute: (input: Schema.ToType<S>) => Promise<void | ActionError> | void;
+    }): ActionEntry;
+    (config: {
+        description: string;
+        schema: false;
+        enabled?: Observe<boolean>;
+        execute: () => Promise<void | ActionError> | void;
+    }): ActionEntry;
+};
+/**
+ * Creates a DynamicService from a configuration of states and actions.
+ *
+ * Use `DynamicService.state()` and `DynamicService.action()` helpers
+ * for each entry to get strict type inference on value observables
+ * and execute input parameters:
+ *
+ * ```ts
+ * DynamicService.create({
+ *   states: {
+ *     health: DynamicService.state({
+ *       schema: { type: "number" },
+ *       value: healthObserve,
+ *     }),
+ *   },
+ *   actions: {
+ *     heal: DynamicService.action({
+ *       description: "Heal the player",
+ *       schema: { type: "number" },
+ *       execute: (input) => { // input: number ✓
+ *         healPlayer(input);
+ *       },
+ *     }),
+ *   },
+ * });
+ * ```
+ */
+export declare const create: (props: {
+    states: Record<string, StateEntry>;
+    actions: Record<string, ActionEntry>;
+}) => DynamicService;
+export {};

package/dist/service/dynamic-service/create.js

@@ -0,0 +1,97 @@
+import { Observe } from "../../observe/index.js";
+/**
+ * Creates a typed state entry for use with `create()`.
+ * Captures the schema type as a direct generic parameter, ensuring
+ * Schema.ToType<S> resolves correctly for the value observable.
+ */
+export const state = (config) => config;
+/**
+ * Creates a typed action entry for use with `create()`.
+ * Captures the schema type as a direct generic parameter, ensuring
+ * Schema.ToType<S> resolves correctly for the execute input parameter.
+ *
+ * TypeScript cannot resolve Schema.ToType<AS[K]> through indexed access
+ * types in mapped types for complex schemas (objects, arrays, etc.).
+ * This helper works around that by using a direct generic S parameter.
+ */
+export const action = (config) => config;
+/**
+ * Creates a DynamicService from a configuration of states and actions.
+ *
+ * Use `DynamicService.state()` and `DynamicService.action()` helpers
+ * for each entry to get strict type inference on value observables
+ * and execute input parameters:
+ *
+ * ```ts
+ * DynamicService.create({
+ *   states: {
+ *     health: DynamicService.state({
+ *       schema: { type: "number" },
+ *       value: healthObserve,
+ *     }),
+ *   },
+ *   actions: {
+ *     heal: DynamicService.action({
+ *       description: "Heal the player",
+ *       schema: { type: "number" },
+ *       execute: (input) => { // input: number ✓
+ *         healPlayer(input);
+ *       },
+ *     }),
+ *   },
+ * });
+ * ```
+ */
+export const create = (props) => {
+    const alwaysEnabled = Observe.fromConstant(true);
+    // Build per-state observables combining enabled + value
+    const stateEntries = Object.entries(props.states);
+    const perStateObservables = {};
+    const stateSchemas = {};
+    for (const [key, entry] of stateEntries) {
+        stateSchemas[key] = entry.schema;
+        perStateObservables[key] = Observe.fromProperties({
+            enabled: entry.enabled ?? alwaysEnabled,
+            value: entry.value,
+        });
+    }
+    const states = Observe.withMap(Observe.fromProperties(perStateObservables), (raw) => {
+        const result = {};
+        for (const [key, entry] of Object.entries(raw)) {
+            const { enabled, value } = entry;
+            if (enabled) {
+                result[key] = { schema: stateSchemas[key], value };
+            }
+        }
+        return result;
+    });
+    // Build per-action enabled observables, capture execute functions
+    const actionEntries = Object.entries(props.actions);
+    const actionMeta = {};
+    const enabledObservables = {};
+    for (const [key, entry] of actionEntries) {
+        actionMeta[key] = { description: entry.description, schema: entry.schema, execute: entry.execute };
+        enabledObservables[key] = entry.enabled ?? alwaysEnabled;
+    }
+    const actions = Observe.withMap(Observe.fromProperties(enabledObservables), (enabledMap) => {
+        const result = {};
+        for (const [key, enabled] of Object.entries(enabledMap)) {
+            if (!enabled)
+                continue;
+            const { description, schema, execute } = actionMeta[key];
+            result[key] = { description, schema, execute };
+        }
+        return result;
+    });
+    // Track current actions for execute dispatch
+    let currentActions = {};
+    actions((a) => { currentActions = a; });
+    const execute = async (action, input) => {
+        const entry = currentActions[action];
+        if (!entry)
+            return `Action "${action}" is not available`;
+        return entry.execute(input);
+    };
+    return { serviceName: "dynamic-service", states, actions, execute };
+};
+//# sourceMappingURL=create.js.map

package/dist/service/dynamic-service/create.js.map

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

package/dist/service/dynamic-service/create.test.d.ts

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