@ankhorage/runtime 0.2.4 → 1.0.0

package/dist/appExtensionRegistry.d.ts

@@ -1,3 +0,0 @@
-import type { ComponentRegistry } from './componentRegistry';
-export declare const APP_EXTENSION_COMPONENT_REGISTRY: ComponentRegistry;
-//# sourceMappingURL=appExtensionRegistry.d.ts.map

package/dist/appExtensionRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"appExtensionRegistry.d.ts","sourceRoot":"","sources":["../src/appExtensionRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,eAAO,MAAM,gCAAgC,EAAE,iBAAsB,CAAC"}

package/dist/appExtensionRegistry.js

@@ -1,2 +0,0 @@
-export const APP_EXTENSION_COMPONENT_REGISTRY = {};
-//# sourceMappingURL=appExtensionRegistry.js.map

package/dist/appExtensionRegistry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"appExtensionRegistry.js","sourceRoot":"","sources":["../src/appExtensionRegistry.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gCAAgC,GAAsB,EAAE,CAAC","sourcesContent":["import type { ComponentRegistry } from './componentRegistry';\n\nexport const APP_EXTENSION_COMPONENT_REGISTRY: ComponentRegistry = {};\n"]}

package/dist/runtimeApiLoaders.d.ts

@@ -1,35 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,218 +0,0 @@
-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

package/dist/runtimeApiLoaders.js.map

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