@ankhorage/runtime 0.1.1 → 0.2.1

package/dist/runtimeActionRegistry.js

@@ -0,0 +1,323 @@
+import { createRuntimeBindingOperationKey, resolveBindingInputMap, } from './runtimeBindings';
+export function createRuntimeActionRegistry(options = {}) {
+    const actionHandlers = { ...(options.actionHandlers ?? {}) };
+    return {
+        async dispatchComponentEvent(args) {
+            await dispatchRuntimeComponentEvent({
+                ...args,
+                actionHandlers,
+                dataBindings: args.dataBindings ?? options.dataBindings,
+                dataSources: args.dataSources ?? options.dataSources,
+                executeAction: args.executeAction ?? options.executeAction,
+                executeOperation: args.executeOperation ?? options.executeOperation,
+                operationResults: args.operationResults ?? options.operationResults,
+                writeOperationResult: args.writeOperationResult ?? options.writeOperationResult,
+            });
+        },
+        registerActionHandler(type, handler) {
+            actionHandlers[type] = handler;
+            return () => {
+                delete actionHandlers[type];
+            };
+        },
+    };
+}
+export async function dispatchRuntimeComponentEvent(args) {
+    const { node, event, eventName = inferLocalEventName(event.type), actionHandlers } = args;
+    const eventBindings = args.dataBindings?.[node.id]?.events?.[eventName] ??
+        args.dataBindings?.[node.id]?.events?.[event.type] ??
+        [];
+    const diagnostics = [];
+    const dispatchOperationResults = {
+        ...(args.operationResults ?? {}),
+    };
+    const resolutionArgs = {
+        ...args,
+        operationResults: dispatchOperationResults,
+    };
+    for (const binding of eventBindings) {
+        if (!matchesBindingCondition(binding.when, resolutionArgs))
+            continue;
+        if (binding.target.kind === 'action') {
+            const resolvedPayload = await resolveObjectEventBindingInput(binding.input, resolutionArgs, diagnostics);
+            const action = resolvedPayload === undefined
+                ? { type: binding.target.type }
+                : { type: binding.target.type, payload: resolvedPayload };
+            if (resolutionArgs.executeAction) {
+                await resolutionArgs.executeAction({
+                    action,
+                    event,
+                    node,
+                    resolvedPayload,
+                });
+                continue;
+            }
+            const handler = actionHandlers?.[binding.target.type];
+            if (handler) {
+                await handler({
+                    action,
+                    event,
+                    node,
+                    resolvedPayload,
+                });
+                continue;
+            }
+            diagnostics.push({
+                code: 'missing-action-handler',
+                message: `Action '${binding.target.type}' could not be executed because no runtime executor or handler is registered.`,
+                severity: 'error',
+            });
+            continue;
+        }
+        const operationSucceeded = await dispatchRuntimeOperationEventBinding({
+            args: resolutionArgs,
+            binding,
+            diagnostics,
+            operationResults: dispatchOperationResults,
+            target: binding.target,
+        });
+        if (!operationSucceeded) {
+            break;
+        }
+    }
+    return diagnostics;
+}
+export function wrapRuntimeEventProps(args) {
+    const { node, props, disableActions, dispatchComponentEvent } = args;
+    const wrappedProps = { ...props };
+    const nodeEventBindings = args.dataBindings?.[node.id]?.events;
+    if (disableActions || !nodeEventBindings) {
+        return wrappedProps;
+    }
+    for (const eventName of Object.keys(nodeEventBindings)) {
+        const propName = eventNameToCallbackProp(eventName);
+        const existingHandler = wrappedProps[propName];
+        wrappedProps[propName] = (...handlerArgs) => {
+            let existingResult;
+            if (isRuntimeEventHandler(existingHandler)) {
+                existingResult = existingHandler(...handlerArgs);
+            }
+            void dispatchComponentEvent({
+                context: args.context,
+                dataBindings: args.dataBindings,
+                event: createComponentEventFromHandlerArgs({ eventName, handlerArgs, node }),
+                eventName,
+                node,
+                operationResults: args.operationResults,
+                state: args.state,
+            });
+            return existingResult;
+        };
+    }
+    return wrappedProps;
+}
+export function createComponentEventFromHandlerArgs(args) {
+    const { node, eventName, handlerArgs } = args;
+    return {
+        payload: createPayloadForEvent(eventName, handlerArgs),
+        sourceNodeId: node.id,
+        type: localEventNameToEventType(eventName),
+    };
+}
+export function resolveRuntimeActionPayload(payload, args) {
+    if (payload === undefined) {
+        return undefined;
+    }
+    return resolveRuntimeActionValue(payload, args);
+}
+export function resolveRuntimeActionValue(value, args) {
+    if (!isRecord(value))
+        return undefined;
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, resolveRuntimeActionValueEntry(entry, args)]));
+}
+async function dispatchRuntimeOperationEventBinding(args) {
+    const { binding, diagnostics, target } = args;
+    if (args.args.executeOperation === undefined) {
+        diagnostics.push({
+            code: 'missing-adapter',
+            dataSourceId: target.operation.dataSourceId,
+            endpointId: target.operation.endpointId,
+            operationId: target.operation.operationId,
+            message: 'Event operation binding requires an injected operation executor.',
+            severity: 'error',
+        });
+        return false;
+    }
+    const dataSource = args.args.dataSources?.[target.operation.dataSourceId];
+    if (dataSource === undefined) {
+        diagnostics.push({
+            code: 'missing-data-source',
+            dataSourceId: target.operation.dataSourceId,
+            endpointId: target.operation.endpointId,
+            operationId: target.operation.operationId,
+            message: `Data source '${target.operation.dataSourceId}' could not be found.`,
+            severity: 'error',
+        });
+        return false;
+    }
+    const endpoint = resolveEventOperationEndpoint(target, dataSource);
+    const result = await args.args.executeOperation({
+        dataSource,
+        endpoint,
+        input: await resolveEventBindingInput(binding.input, args.args, diagnostics),
+        node: args.args.node,
+        operation: target.operation,
+    });
+    diagnostics.push(...(result.diagnostics ?? []));
+    if (result.ok) {
+        const operationKey = createRuntimeBindingOperationKey(target.operation);
+        args.operationResults[operationKey] = result.data;
+        args.args.writeOperationResult?.(operationKey, result.data);
+        return true;
+    }
+    return false;
+}
+function resolveRuntimeActionValueEntry(value, args) {
+    if (Array.isArray(value))
+        return value.map((item) => resolveRuntimeActionValueEntry(item, args));
+    if (!isRecord(value))
+        return value;
+    if (!('valueFrom' in value)) {
+        return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
+            key,
+            resolveRuntimeActionValueEntry(entry, args),
+        ]));
+    }
+    return undefined;
+}
+async function resolveObjectEventBindingInput(input, args, diagnostics) {
+    const value = await resolveEventBindingInput(input, args, diagnostics);
+    return isRecord(value) ? value : undefined;
+}
+async function resolveEventBindingInput(input, args, diagnostics) {
+    return resolveBindingInputMap(input, {
+        context: args.context,
+        dataBindings: args.dataBindings,
+        dataSources: args.dataSources,
+        event: args.event,
+        executeOperation: args.executeOperation,
+        operationResults: args.operationResults,
+    }, diagnostics);
+}
+function matchesBindingCondition(condition, args) {
+    if (condition === undefined)
+        return true;
+    const value = readBindingConditionSource(condition, args);
+    switch (condition.operator) {
+        case 'eq':
+            return value === condition.value;
+        case 'exists':
+            return value !== undefined;
+        case 'neq':
+            return value !== condition.value;
+        case 'notExists':
+            return value === undefined;
+    }
+}
+function readBindingConditionSource(condition, args) {
+    switch (condition.source.kind) {
+        case 'context':
+            return readPath(args.context, condition.source.path);
+        case 'event':
+            return readPath(args.event, condition.source.path);
+        case 'literal':
+            return condition.source.value;
+        case 'operation': {
+            const operationResult = args.operationResults?.[createRuntimeBindingOperationKey(condition.source.operation)];
+            return condition.source.path === undefined
+                ? operationResult
+                : readPath(operationResult, condition.source.path);
+        }
+        case 'state':
+            return readPath(args.state, condition.source.path);
+    }
+}
+function resolveEventOperationEndpoint(target, dataSource) {
+    if (target.operation.endpointId !== undefined) {
+        return dataSource.endpoints[target.operation.endpointId];
+    }
+    return Object.values(dataSource.endpoints).find((endpoint) => endpoint.operations[target.operation.operationId] !== undefined);
+}
+function createPayloadForEvent(eventName, handlerArgs) {
+    if (eventName === 'barcodeScanned') {
+        return createBarcodeScannedPayload(handlerArgs[0]);
+    }
+    if (eventName === 'submit') {
+        return { values: asRecord(handlerArgs[0]) ?? {} };
+    }
+    if (eventName === 'itemPress') {
+        const item = asRecord(handlerArgs[0]) ?? {};
+        const itemId = readItemId(handlerArgs[0]);
+        return itemId === undefined ? { item } : { itemId, item };
+    }
+    if (eventName === 'changeText' || eventName === 'valueChange') {
+        return { value: handlerArgs[0] };
+    }
+    if (eventName === 'checkedChange') {
+        return { checked: handlerArgs[0] };
+    }
+    if (eventName === 'manualEntry') {
+        return handlerArgs[0] === undefined ? {} : { value: handlerArgs[0] };
+    }
+    if (eventName === 'requestPermission') {
+        return {};
+    }
+    return {};
+}
+function localEventNameToEventType(eventName) {
+    if (eventName === 'itemPress')
+        return 'collection.itemPress';
+    if (eventName === 'press')
+        return 'button.press';
+    if (eventName === 'submit')
+        return 'form.submit';
+    return eventName;
+}
+function inferLocalEventName(eventType) {
+    const parts = eventType.split('.');
+    return parts.at(-1) ?? eventType;
+}
+function eventNameToCallbackProp(eventName) {
+    return `on${eventName.charAt(0).toUpperCase()}${eventName.slice(1)}`;
+}
+function isRuntimeEventHandler(value) {
+    return typeof value === 'function';
+}
+function readPath(source, path) {
+    if (path.length === 0)
+        return source;
+    return path.split('.').reduce((currentValue, part) => {
+        if (!isRecord(currentValue))
+            return undefined;
+        return currentValue[part];
+    }, source);
+}
+function createBarcodeScannedPayload(value) {
+    if (typeof value === 'string') {
+        return { value };
+    }
+    if (!isRecord(value)) {
+        return {};
+    }
+    const payload = {};
+    if (typeof value.value === 'string')
+        payload.value = value.value;
+    if (typeof value.type === 'string')
+        payload.type = value.type;
+    return payload;
+}
+function readItemId(value) {
+    if (typeof value === 'string' || typeof value === 'number')
+        return value;
+    if (!isRecord(value))
+        return undefined;
+    const id = value.id ?? value.itemId;
+    return typeof id === 'string' || typeof id === 'number' ? id : undefined;
+}
+function asRecord(value) {
+    return isRecord(value) ? value : undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=runtimeActionRegistry.js.map

package/dist/runtimeActionRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeActionRegistry.js","sourceRoot":"","sources":["../src/runtimeActionRegistry.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  BindingCondition,\n  BindingInputMap,\n  BindingValue,\n  ComponentDataBindingRegistry,\n  ComponentEventDto,\n  DataEndpointConfig,\n  DataSourceConfig,\n  DataSourceDiagnostic,\n  DataSourceRegistry,\n  EventBinding,\n  EventBindingTarget,\n  UiNode,\n} from '@ankhorage/contracts';\n\nimport {\n  createRuntimeBindingOperationKey,\n  resolveBindingInputMap,\n  type RuntimeBindingOperationExecutor,\n  type RuntimeBindingOperationResultCache,\n  type RuntimeBindingOperationResultWriter,\n} from './runtimeBindings';\nimport type { RuntimeActionHandler, RuntimeActionHandlers } from './RuntimeRendererConfig';\n\ntype RuntimeEventPayload = Record<string, unknown>;\n\ntype RuntimeEventHandler = (...args: unknown[]) => unknown;\n\ntype RuntimeOperationEventTarget = Extract<EventBindingTarget, { readonly kind: 'operation' }>;\n\nexport interface RuntimeActionRegistry {\n  dispatchComponentEvent(args: RuntimeComponentEventDispatchArgs): Promise<void>;\n  registerActionHandler(type: string, handler: RuntimeActionHandler): () => void;\n}\n\nexport interface RuntimeActionResolutionScope {\n  readonly context?: Record<string, unknown>;\n  readonly operationResults?: RuntimeBindingOperationResultCache;\n  readonly state?: Record<string, unknown>;\n}\n\nexport interface RuntimeActionResolutionArgs extends RuntimeActionResolutionScope {\n  readonly event: ComponentEventDto<string, object>;\n}\n\nexport interface RuntimeComponentEventDispatchArgs extends RuntimeActionResolutionScope {\n  readonly node: UiNode;\n  readonly event: ComponentEventDto<string, object>;\n  readonly eventName?: string;\n  readonly executeAction?: RuntimeActionHandler;\n  readonly dataSources?: DataSourceRegistry;\n  readonly dataBindings?: ComponentDataBindingRegistry;\n  readonly executeOperation?: RuntimeBindingOperationExecutor;\n  readonly writeOperationResult?: RuntimeBindingOperationResultWriter;\n}\n\nexport interface RuntimeEventPropWrapArgs extends RuntimeActionResolutionScope {\n  readonly node: UiNode;\n  readonly props: Record<string, unknown>;\n  readonly disableActions: boolean;\n  readonly dataBindings?: ComponentDataBindingRegistry;\n  readonly dispatchComponentEvent: (\n    args: RuntimeComponentEventDispatchArgs,\n  ) => Promise<void> | void;\n}\n\nexport function createRuntimeActionRegistry(\n  options: {\n    actionHandlers?: RuntimeActionHandlers;\n    dataSources?: DataSourceRegistry;\n    dataBindings?: ComponentDataBindingRegistry;\n    executeAction?: RuntimeActionHandler;\n    executeOperation?: RuntimeBindingOperationExecutor;\n    operationResults?: RuntimeBindingOperationResultCache;\n    writeOperationResult?: RuntimeBindingOperationResultWriter;\n  } = {},\n): RuntimeActionRegistry {\n  const actionHandlers: RuntimeActionHandlers = { ...(options.actionHandlers ?? {}) };\n\n  return {\n    async dispatchComponentEvent(args) {\n      await dispatchRuntimeComponentEvent({\n        ...args,\n        actionHandlers,\n        dataBindings: args.dataBindings ?? options.dataBindings,\n        dataSources: args.dataSources ?? options.dataSources,\n        executeAction: args.executeAction ?? options.executeAction,\n        executeOperation: args.executeOperation ?? options.executeOperation,\n        operationResults: args.operationResults ?? options.operationResults,\n        writeOperationResult: args.writeOperationResult ?? options.writeOperationResult,\n      });\n    },\n    registerActionHandler(type, handler) {\n      actionHandlers[type] = handler;\n\n      return () => {\n        delete actionHandlers[type];\n      };\n    },\n  };\n}\n\nexport async function dispatchRuntimeComponentEvent(\n  args: RuntimeComponentEventDispatchArgs & {\n    readonly actionHandlers?: RuntimeActionHandlers;\n  },\n): Promise<readonly DataSourceDiagnostic[]> {\n  const { node, event, eventName = inferLocalEventName(event.type), actionHandlers } = args;\n  const eventBindings: readonly EventBinding[] =\n    args.dataBindings?.[node.id]?.events?.[eventName] ??\n    args.dataBindings?.[node.id]?.events?.[event.type] ??\n    [];\n  const diagnostics: DataSourceDiagnostic[] = [];\n  const dispatchOperationResults: Record<string, BindingValue | undefined> = {\n    ...(args.operationResults ?? {}),\n  };\n  const resolutionArgs: RuntimeComponentEventDispatchArgs = {\n    ...args,\n    operationResults: dispatchOperationResults,\n  };\n\n  for (const binding of eventBindings) {\n    if (!matchesBindingCondition(binding.when, resolutionArgs)) continue;\n\n    if (binding.target.kind === 'action') {\n      const resolvedPayload = await resolveObjectEventBindingInput(\n        binding.input,\n        resolutionArgs,\n        diagnostics,\n      );\n      const action =\n        resolvedPayload === undefined\n          ? { type: binding.target.type }\n          : { type: binding.target.type, payload: resolvedPayload };\n      if (resolutionArgs.executeAction) {\n        await resolutionArgs.executeAction({\n          action,\n          event,\n          node,\n          resolvedPayload,\n        });\n        continue;\n      }\n\n      const handler = actionHandlers?.[binding.target.type];\n      if (handler) {\n        await handler({\n          action,\n          event,\n          node,\n          resolvedPayload,\n        });\n        continue;\n      }\n\n      diagnostics.push({\n        code: 'missing-action-handler',\n        message: `Action '${binding.target.type}' could not be executed because no runtime executor or handler is registered.`,\n        severity: 'error',\n      });\n      continue;\n    }\n\n    const operationSucceeded = await dispatchRuntimeOperationEventBinding({\n      args: resolutionArgs,\n      binding,\n      diagnostics,\n      operationResults: dispatchOperationResults,\n      target: binding.target,\n    });\n\n    if (!operationSucceeded) {\n      break;\n    }\n  }\n\n  return diagnostics;\n}\n\nexport function wrapRuntimeEventProps(args: RuntimeEventPropWrapArgs): Record<string, unknown> {\n  const { node, props, disableActions, dispatchComponentEvent } = args;\n  const wrappedProps: Record<string, unknown> = { ...props };\n  const nodeEventBindings = args.dataBindings?.[node.id]?.events;\n\n  if (disableActions || !nodeEventBindings) {\n    return wrappedProps;\n  }\n\n  for (const eventName of Object.keys(nodeEventBindings)) {\n    const propName = eventNameToCallbackProp(eventName);\n    const existingHandler = wrappedProps[propName];\n\n    wrappedProps[propName] = (...handlerArgs: unknown[]) => {\n      let existingResult: unknown;\n\n      if (isRuntimeEventHandler(existingHandler)) {\n        existingResult = existingHandler(...handlerArgs);\n      }\n\n      void dispatchComponentEvent({\n        context: args.context,\n        dataBindings: args.dataBindings,\n        event: createComponentEventFromHandlerArgs({ eventName, handlerArgs, node }),\n        eventName,\n        node,\n        operationResults: args.operationResults,\n        state: args.state,\n      });\n\n      return existingResult;\n    };\n  }\n\n  return wrappedProps;\n}\n\nexport function createComponentEventFromHandlerArgs(args: {\n  readonly node: UiNode;\n  readonly eventName: string;\n  readonly handlerArgs: readonly unknown[];\n}): ComponentEventDto<string, RuntimeEventPayload> {\n  const { node, eventName, handlerArgs } = args;\n\n  return {\n    payload: createPayloadForEvent(eventName, handlerArgs),\n    sourceNodeId: node.id,\n    type: localEventNameToEventType(eventName),\n  };\n}\n\nexport function resolveRuntimeActionPayload(\n  payload: object | undefined,\n  args: RuntimeActionResolutionArgs,\n): object | undefined {\n  if (payload === undefined) {\n    return undefined;\n  }\n\n  return resolveRuntimeActionValue(payload, args);\n}\n\nexport function resolveRuntimeActionValue(\n  value: unknown,\n  args: RuntimeActionResolutionArgs,\n): object | undefined {\n  if (!isRecord(value)) return undefined;\n\n  return Object.fromEntries(\n    Object.entries(value).map(([key, entry]) => [key, resolveRuntimeActionValueEntry(entry, args)]),\n  );\n}\n\nasync function dispatchRuntimeOperationEventBinding(args: {\n  readonly args: RuntimeComponentEventDispatchArgs;\n  readonly binding: EventBinding;\n  readonly diagnostics: DataSourceDiagnostic[];\n  readonly operationResults: Record<string, BindingValue | undefined>;\n  readonly target: RuntimeOperationEventTarget;\n}): Promise<boolean> {\n  const { binding, diagnostics, target } = args;\n\n  if (args.args.executeOperation === undefined) {\n    diagnostics.push({\n      code: 'missing-adapter',\n      dataSourceId: target.operation.dataSourceId,\n      endpointId: target.operation.endpointId,\n      operationId: target.operation.operationId,\n      message: 'Event operation binding requires an injected operation executor.',\n      severity: 'error',\n    });\n    return false;\n  }\n\n  const dataSource = args.args.dataSources?.[target.operation.dataSourceId];\n  if (dataSource === undefined) {\n    diagnostics.push({\n      code: 'missing-data-source',\n      dataSourceId: target.operation.dataSourceId,\n      endpointId: target.operation.endpointId,\n      operationId: target.operation.operationId,\n      message: `Data source '${target.operation.dataSourceId}' could not be found.`,\n      severity: 'error',\n    });\n    return false;\n  }\n\n  const endpoint = resolveEventOperationEndpoint(target, dataSource);\n  const result = await args.args.executeOperation({\n    dataSource,\n    endpoint,\n    input: await resolveEventBindingInput(binding.input, args.args, diagnostics),\n    node: args.args.node,\n    operation: target.operation,\n  });\n  diagnostics.push(...(result.diagnostics ?? []));\n\n  if (result.ok) {\n    const operationKey = createRuntimeBindingOperationKey(target.operation);\n    args.operationResults[operationKey] = result.data;\n    args.args.writeOperationResult?.(operationKey, result.data);\n    return true;\n  }\n\n  return false;\n}\n\nfunction resolveRuntimeActionValueEntry(\n  value: unknown,\n  args: RuntimeActionResolutionArgs,\n): unknown {\n  if (Array.isArray(value)) return value.map((item) => resolveRuntimeActionValueEntry(item, args));\n  if (!isRecord(value)) return value;\n  if (!('valueFrom' in value)) {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, entry]) => [\n        key,\n        resolveRuntimeActionValueEntry(entry, args),\n      ]),\n    );\n  }\n\n  return undefined;\n}\n\nasync function resolveObjectEventBindingInput(\n  input: BindingInputMap | undefined,\n  args: RuntimeComponentEventDispatchArgs,\n  diagnostics: DataSourceDiagnostic[],\n): Promise<object | undefined> {\n  const value = await resolveEventBindingInput(input, args, diagnostics);\n  return isRecord(value) ? value : undefined;\n}\n\nasync function resolveEventBindingInput(\n  input: BindingInputMap | undefined,\n  args: RuntimeComponentEventDispatchArgs,\n  diagnostics: DataSourceDiagnostic[],\n) {\n  return resolveBindingInputMap(\n    input,\n    {\n      context: args.context,\n      dataBindings: args.dataBindings,\n      dataSources: args.dataSources,\n      event: args.event,\n      executeOperation: args.executeOperation,\n      operationResults: args.operationResults,\n    },\n    diagnostics,\n  );\n}\n\nfunction matchesBindingCondition(\n  condition: BindingCondition | undefined,\n  args: RuntimeActionResolutionArgs,\n): boolean {\n  if (condition === undefined) return true;\n\n  const value = readBindingConditionSource(condition, args);\n\n  switch (condition.operator) {\n    case 'eq':\n      return value === condition.value;\n    case 'exists':\n      return value !== undefined;\n    case 'neq':\n      return value !== condition.value;\n    case 'notExists':\n      return value === undefined;\n  }\n}\n\nfunction readBindingConditionSource(\n  condition: BindingCondition,\n  args: RuntimeActionResolutionArgs,\n): unknown {\n  switch (condition.source.kind) {\n    case 'context':\n      return readPath(args.context, condition.source.path);\n    case 'event':\n      return readPath(args.event, condition.source.path);\n    case 'literal':\n      return condition.source.value;\n    case 'operation': {\n      const operationResult =\n        args.operationResults?.[createRuntimeBindingOperationKey(condition.source.operation)];\n      return condition.source.path === undefined\n        ? operationResult\n        : readPath(operationResult, condition.source.path);\n    }\n    case 'state':\n      return readPath(args.state, condition.source.path);\n  }\n}\n\nfunction resolveEventOperationEndpoint(\n  target: RuntimeOperationEventTarget,\n  dataSource: DataSourceConfig,\n): DataEndpointConfig | undefined {\n  if (target.operation.endpointId !== undefined) {\n    return dataSource.endpoints[target.operation.endpointId];\n  }\n\n  return Object.values(dataSource.endpoints).find(\n    (endpoint) => endpoint.operations[target.operation.operationId] !== undefined,\n  );\n}\n\nfunction createPayloadForEvent(\n  eventName: string,\n  handlerArgs: readonly unknown[],\n): RuntimeEventPayload {\n  if (eventName === 'barcodeScanned') {\n    return createBarcodeScannedPayload(handlerArgs[0]);\n  }\n\n  if (eventName === 'submit') {\n    return { values: asRecord(handlerArgs[0]) ?? {} };\n  }\n\n  if (eventName === 'itemPress') {\n    const item = asRecord(handlerArgs[0]) ?? {};\n    const itemId = readItemId(handlerArgs[0]);\n\n    return itemId === undefined ? { item } : { itemId, item };\n  }\n\n  if (eventName === 'changeText' || eventName === 'valueChange') {\n    return { value: handlerArgs[0] };\n  }\n\n  if (eventName === 'checkedChange') {\n    return { checked: handlerArgs[0] };\n  }\n\n  if (eventName === 'manualEntry') {\n    return handlerArgs[0] === undefined ? {} : { value: handlerArgs[0] };\n  }\n\n  if (eventName === 'requestPermission') {\n    return {};\n  }\n\n  return {};\n}\n\nfunction localEventNameToEventType(eventName: string): string {\n  if (eventName === 'itemPress') return 'collection.itemPress';\n  if (eventName === 'press') return 'button.press';\n  if (eventName === 'submit') return 'form.submit';\n\n  return eventName;\n}\n\nfunction inferLocalEventName(eventType: string): string {\n  const parts = eventType.split('.');\n\n  return parts.at(-1) ?? eventType;\n}\n\nfunction eventNameToCallbackProp(eventName: string): string {\n  return `on${eventName.charAt(0).toUpperCase()}${eventName.slice(1)}`;\n}\n\nfunction isRuntimeEventHandler(value: unknown): value is RuntimeEventHandler {\n  return typeof value === 'function';\n}\n\nfunction readPath(source: unknown, path: string): unknown {\n  if (path.length === 0) return source;\n\n  return path.split('.').reduce<unknown>((currentValue, part) => {\n    if (!isRecord(currentValue)) return undefined;\n    return currentValue[part];\n  }, source);\n}\n\nfunction createBarcodeScannedPayload(value: unknown): RuntimeEventPayload {\n  if (typeof value === 'string') {\n    return { value };\n  }\n\n  if (!isRecord(value)) {\n    return {};\n  }\n\n  const payload: RuntimeEventPayload = {};\n  if (typeof value.value === 'string') payload.value = value.value;\n  if (typeof value.type === 'string') payload.type = value.type;\n\n  return payload;\n}\n\nfunction readItemId(value: unknown): string | number | undefined {\n  if (typeof value === 'string' || typeof value === 'number') return value;\n  if (!isRecord(value)) return undefined;\n\n  const id = value.id ?? value.itemId;\n\n  return typeof id === 'string' || typeof id === 'number' ? id : undefined;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n  return isRecord(value) ? value : undefined;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"]}

package/dist/runtimeApiLoaders.d.ts

@@ -0,0 +1,35 @@
+import type { ApiScreenDataLoaderDefinition, AppDataManifest, StateAdapter, StateValue } from '@ankhorage/contracts';
+export type RuntimeApiLoaderMode = 'byId' | 'list' | 'one' | 'random';
+export type RuntimeApiLoaderDefinition = ApiScreenDataLoaderDefinition;
+export interface RuntimeApiLoaderDiagnostic {
+    readonly code: 'invalid-record' | 'missing-api' | 'missing-target-path' | 'state-set-failed' | 'unsupported-loader';
+    readonly message: string;
+    readonly apiId?: string;
+    readonly targetPath?: string;
+}
+export interface RuntimeApiLoaderExecutionResult {
+    readonly diagnostics: readonly RuntimeApiLoaderDiagnostic[];
+}
+export interface RuntimeApiLoaderMaterializationResult {
+    readonly state: Readonly<Record<string, StateValue>>;
+    readonly diagnostics: readonly RuntimeApiLoaderDiagnostic[];
+}
+export declare function materializeRuntimeApiLoaderState(args: {
+    readonly data?: AppDataManifest;
+    readonly loaders: readonly RuntimeApiLoaderDefinition[];
+}): RuntimeApiLoaderMaterializationResult;
+export declare function executeRuntimeApiLoaders(args: {
+    readonly data?: AppDataManifest;
+    readonly loaders: readonly RuntimeApiLoaderDefinition[];
+    readonly stateAdapter: StateAdapter;
+}): RuntimeApiLoaderExecutionResult;
+export declare function useRuntimeApiStateLoaders(args: {
+    readonly data?: AppDataManifest;
+    readonly loaders?: readonly RuntimeApiLoaderDefinition[];
+    readonly stateAdapter?: StateAdapter;
+}): {
+    readonly diagnostics: readonly RuntimeApiLoaderDiagnostic[];
+    readonly stateAdapter: StateAdapter;
+    readonly stateVersion: number;
+};
+//# sourceMappingURL=runtimeApiLoaders.d.ts.map

package/dist/runtimeApiLoaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeApiLoaders.d.ts","sourceRoot":"","sources":["../src/runtimeApiLoaders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAG7B,eAAe,EAEf,YAAY,EAEZ,UAAU,EACX,MAAM,sBAAsB,CAAC;AAK9B,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEtE,MAAM,MAAM,0BAA0B,GAAG,6BAA6B,CAAC;AAEvE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EACT,gBAAgB,GAChB,aAAa,GACb,qBAAqB,GACrB,kBAAkB,GAClB,oBAAoB,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,WAAW,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC7D;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,WAAW,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC7D;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,0BAA0B,EAAE,CAAC;CACzD,GAAG,qCAAqC,CAuDxC;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACxD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACrC,GAAG,+BAA+B,CAmBlC;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC,GAAG;IACF,QAAQ,CAAC,WAAW,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC5D,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAsBA"}

package/dist/runtimeApiLoaders.js

@@ -0,0 +1,218 @@
+import React from 'react';
+import { createRuntimeMemoryStateAdapter } from './runtimeStateAdapter';
+export function materializeRuntimeApiLoaderState(args) {
+    const state = {};
+    const diagnostics = [];
+    for (const loader of args.loaders) {
+        const targetPath = loader.targetPath.trim();
+        if (targetPath.length === 0) {
+            diagnostics.push({
+                code: 'missing-target-path',
+                apiId: loader.apiId,
+                message: `API loader for ${loader.apiId} must define a target path.`,
+            });
+            continue;
+        }
+        const api = args.data?.apis?.[loader.apiId];
+        const resource = getGeneratedApiCollectionResource(api);
+        if (api?.kind !== 'generated' || resource === null) {
+            diagnostics.push({
+                code: 'missing-api',
+                apiId: loader.apiId,
+                targetPath,
+                message: `Generated API ${loader.apiId} could not be found.`,
+            });
+            continue;
+        }
+        const selectedValue = selectApiLoaderValue({ api, resource, loader, diagnostics, targetPath });
+        if (selectedValue === undefined) {
+            continue;
+        }
+        const stateValue = toStateValue(selectedValue);
+        if (stateValue === undefined) {
+            diagnostics.push({
+                code: 'invalid-record',
+                apiId: loader.apiId,
+                targetPath,
+                message: `Generated API ${loader.apiId} produced a value that cannot be represented as runtime state.`,
+            });
+            continue;
+        }
+        const setResult = writeObjectPath(state, targetPath, stateValue);
+        if (!setResult.ok) {
+            diagnostics.push({
+                code: 'state-set-failed',
+                apiId: loader.apiId,
+                targetPath,
+                message: setResult.error.message,
+            });
+        }
+    }
+    return { state, diagnostics };
+}
+export function executeRuntimeApiLoaders(args) {
+    const materialized = materializeRuntimeApiLoaderState({
+        data: args.data,
+        loaders: args.loaders,
+    });
+    const diagnostics = [...materialized.diagnostics];
+    for (const [targetPath, value] of flattenStateEntries(materialized.state)) {
+        const result = args.stateAdapter.set(targetPath, value);
+        if (!result.ok) {
+            diagnostics.push({
+                code: 'state-set-failed',
+                targetPath,
+                message: result.error.message,
+            });
+        }
+    }
+    return { diagnostics };
+}
+export function useRuntimeApiStateLoaders(args) {
+    const fallbackStateAdapter = React.useMemo(() => createRuntimeMemoryStateAdapter(), []);
+    const stateAdapter = args.stateAdapter ?? fallbackStateAdapter;
+    const loaders = args.loaders ?? [];
+    const [stateVersion, setStateVersion] = React.useState(0);
+    const [diagnostics, setDiagnostics] = React.useState([]);
+    React.useEffect(() => {
+        const result = executeRuntimeApiLoaders({
+            data: args.data,
+            loaders,
+            stateAdapter,
+        });
+        setDiagnostics(result.diagnostics);
+        setStateVersion((current) => current + 1);
+    }, [args.data, loaders, stateAdapter]);
+    return {
+        diagnostics,
+        stateAdapter,
+        stateVersion,
+    };
+}
+function getGeneratedApiCollectionResource(api) {
+    if (api?.kind !== 'generated' || api.resource?.kind !== 'collection') {
+        return null;
+    }
+    return api.resource;
+}
+function selectApiLoaderValue(args) {
+    const seed = args.resource.seed ?? [];
+    const primaryKey = args.resource.collection.primaryKey ?? 'id';
+    switch (args.loader.mode) {
+        case 'list':
+            return seed;
+        case 'one':
+            return seed[0];
+        case 'random': {
+            const index = deterministicIndex(args.api.id, seed.length);
+            return index === undefined ? undefined : seed[index];
+        }
+        case 'byId': {
+            const loaderId = normalizePrimitiveId(args.loader.id);
+            if (loaderId === undefined)
+                return undefined;
+            return seed.find((record) => {
+                return normalizePrimitiveId(record[primaryKey]) === loaderId;
+            });
+        }
+        default:
+            args.diagnostics.push({
+                code: 'unsupported-loader',
+                apiId: args.loader.apiId,
+                targetPath: args.targetPath,
+                message: `API loader mode ${String(args.loader.mode)} is not supported.`,
+            });
+            return undefined;
+    }
+}
+function normalizePrimitiveId(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value.toString() : undefined;
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    return undefined;
+}
+function deterministicIndex(apiId, length) {
+    if (length === 0)
+        return undefined;
+    let hash = 0;
+    for (const char of apiId) {
+        hash = (hash * 31 + char.charCodeAt(0)) % length;
+    }
+    return hash;
+}
+function writeObjectPath(target, path, value) {
+    const parts = path
+        .split('.')
+        .map((part) => part.trim())
+        .filter(Boolean);
+    const [head, ...tail] = parts;
+    if (head === undefined) {
+        return {
+            ok: false,
+            error: {
+                code: 'invalid_path',
+                message: 'State target path must contain at least one segment.',
+            },
+        };
+    }
+    if (tail.length === 0) {
+        target[head] = value;
+        return { ok: true };
+    }
+    const existing = target[head];
+    const child = existing === undefined ? {} : existing;
+    if (!isMutableStateRecord(child)) {
+        return {
+            ok: false,
+            error: {
+                code: 'path_conflict',
+                message: `Cannot set nested state below non-object path segment "${head}".`,
+            },
+        };
+    }
+    target[head] = child;
+    return writeObjectPath(child, tail.join('.'), value);
+}
+function flattenStateEntries(source, prefix = '') {
+    return Object.entries(source).flatMap(([key, value]) => {
+        const path = prefix.length > 0 ? `${prefix}.${key}` : key;
+        return [[path, value]];
+    });
+}
+function toStateValue(value) {
+    if (value === null)
+        return null;
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        const items = [];
+        for (const item of value) {
+            const stateItem = toStateValue(item);
+            if (stateItem === undefined)
+                return undefined;
+            items.push(stateItem);
+        }
+        return items;
+    }
+    if (!isUnknownRecord(value))
+        return undefined;
+    const record = {};
+    for (const [key, entry] of Object.entries(value)) {
+        const stateEntry = toStateValue(entry);
+        if (stateEntry === undefined)
+            return undefined;
+        record[key] = stateEntry;
+    }
+    return record;
+}
+function isUnknownRecord(value) {
+    return typeof value === 'object' && value != null && !Array.isArray(value);
+}
+function isMutableStateRecord(value) {
+    return typeof value === 'object' && value != null && !Array.isArray(value);
+}
+//# sourceMappingURL=runtimeApiLoaders.js.map