@logixjs/core 0.0.1 → 1.0.0

package/dist/Workflow-DmydkHO8.d.cts

@@ -0,0 +1,415 @@
+import { ServiceMap } from 'effect';
+import { J as JsonValue } from './ReadQuery-DXLzCE0E.cjs';
+import { M as ModuleTag, o as AnyModuleShape, q as ModuleLogic } from './module-Ds4tarcI.cjs';
+
+type WorkflowAstVersion = 1;
+type WorkflowLocalId = string;
+type StepKey = string;
+type WorkflowTriggerV1 = {
+    readonly kind: 'action';
+    readonly actionTag: string;
+} | {
+    readonly kind: 'lifecycle';
+    readonly phase: 'onStart' | 'onInit';
+};
+type WorkflowPolicyV1 = {
+    readonly concurrency?: 'latest' | 'exhaust' | 'parallel';
+    readonly priority?: 'urgent' | 'nonUrgent';
+};
+type InputExprV1 = {
+    readonly kind: 'payload';
+} | {
+    readonly kind: 'payload.path';
+    readonly pointer: string;
+} | {
+    readonly kind: 'const';
+    readonly value: JsonValue;
+} | {
+    readonly kind: 'object';
+    readonly fields: {
+        readonly [k: string]: InputExprV1;
+    };
+} | {
+    readonly kind: 'merge';
+    readonly items: ReadonlyArray<InputExprV1>;
+};
+type WorkflowStepV1 = {
+    readonly kind: 'dispatch';
+    readonly key: StepKey;
+    readonly actionTag: string;
+    readonly payload?: InputExprV1;
+} | {
+    readonly kind: 'delay';
+    readonly key: StepKey;
+    readonly ms: number;
+} | {
+    readonly kind: 'call';
+    readonly key: StepKey;
+    readonly serviceId: string;
+    readonly input?: InputExprV1;
+    readonly timeoutMs?: number;
+    readonly retry?: {
+        readonly times: number;
+    };
+    readonly onSuccess: ReadonlyArray<WorkflowStepV1>;
+    readonly onFailure: ReadonlyArray<WorkflowStepV1>;
+};
+type WorkflowDefV1 = {
+    readonly astVersion: WorkflowAstVersion;
+    readonly localId: WorkflowLocalId;
+    readonly trigger: WorkflowTriggerV1;
+    readonly policy?: WorkflowPolicyV1;
+    readonly steps: ReadonlyArray<WorkflowStepV1>;
+    readonly sources?: {
+        readonly [stepKey: string]: {
+            readonly fragmentId?: string;
+        };
+    };
+    readonly meta?: {
+        readonly generator?: JsonValue;
+    };
+};
+type WorkflowStaticIrVersion = 1;
+type WorkflowStableId = string;
+type WorkflowNodeId = string;
+type WorkflowSource = {
+    readonly fragmentId?: string;
+    readonly stepKey?: string;
+};
+type WorkflowEdgeKind = 'next' | 'success' | 'failure';
+type WorkflowEdge = {
+    readonly from: WorkflowNodeId;
+    readonly to: WorkflowNodeId;
+    readonly kind?: WorkflowEdgeKind;
+};
+type WorkflowStaticTrigger = {
+    readonly kind: 'action';
+    readonly actionTag: string;
+} | {
+    readonly kind: 'lifecycle';
+    readonly phase: 'onStart' | 'onInit';
+};
+type WorkflowStaticStep = {
+    readonly kind: 'dispatch';
+    readonly actionTag: string;
+    readonly payload?: InputExprV1;
+} | {
+    readonly kind: 'call';
+    readonly serviceId: string;
+    readonly input?: InputExprV1;
+    readonly policy?: {
+        readonly timeoutMs?: number;
+        readonly retry?: {
+            readonly times: number;
+        };
+    };
+} | {
+    readonly kind: 'delay';
+    readonly ms: number;
+};
+type WorkflowStaticNode = {
+    readonly id: WorkflowNodeId;
+    readonly kind: 'trigger';
+    readonly trigger: WorkflowStaticTrigger;
+} | {
+    readonly id: WorkflowNodeId;
+    readonly kind: 'step';
+    readonly step: WorkflowStaticStep;
+    readonly source?: WorkflowSource;
+};
+type WorkflowStaticIrV1 = {
+    readonly version: WorkflowStaticIrVersion;
+    readonly programId: WorkflowStableId;
+    readonly digest: string;
+    readonly nodes: ReadonlyArray<WorkflowStaticNode>;
+    readonly edges: ReadonlyArray<WorkflowEdge>;
+    readonly policy?: WorkflowPolicyV1;
+    readonly meta?: Record<string, JsonValue>;
+};
+
+type ActionTagsOfModule<M> = M extends {
+    readonly actions: infer A;
+} ? Extract<keyof A, string> : string;
+type WorkflowTrigger<ActionTag extends string = string> = {
+    readonly kind: 'action';
+    readonly actionTag: ActionTag;
+} | {
+    readonly kind: 'lifecycle';
+    readonly phase: 'onStart' | 'onInit';
+};
+type WorkflowPolicy = WorkflowPolicyV1;
+type WorkflowStep<ActionTag extends string = string> = {
+    readonly kind: 'dispatch';
+    readonly key: string;
+    readonly actionTag: ActionTag;
+    readonly payload?: InputExprV1;
+} | {
+    readonly kind: 'delay';
+    readonly key: string;
+    readonly ms: number;
+} | {
+    readonly kind: 'call';
+    readonly key: string;
+    readonly serviceId: string;
+    readonly input?: InputExprV1;
+    readonly timeoutMs?: number;
+    readonly retry?: {
+        readonly times: number;
+    };
+    readonly onSuccess: ReadonlyArray<WorkflowStep<ActionTag>>;
+    readonly onFailure: ReadonlyArray<WorkflowStep<ActionTag>>;
+};
+type WorkflowDef<ActionTag extends string = string> = {
+    readonly astVersion: 1;
+    readonly localId: string;
+    readonly trigger: WorkflowTrigger<ActionTag>;
+    readonly policy?: WorkflowPolicyV1;
+    readonly steps: ReadonlyArray<WorkflowStep<ActionTag>>;
+    readonly sources?: WorkflowDefV1['sources'];
+    readonly meta?: {
+        readonly generator?: JsonValue;
+    };
+};
+type WorkflowStaticIr = WorkflowStaticIrV1;
+type InputExpr = InputExprV1;
+type WorkflowFragment<ActionTag extends string = string> = {
+    readonly fragmentId: string;
+    readonly steps: ReadonlyArray<WorkflowStep<ActionTag>>;
+    readonly sources?: WorkflowDefV1['sources'];
+    readonly policy?: WorkflowPolicyV1;
+};
+type WorkflowComposeResult<ActionTag extends string = string> = {
+    readonly steps: ReadonlyArray<WorkflowStep<ActionTag>>;
+    readonly sources?: WorkflowDefV1['sources'];
+    readonly policy?: WorkflowPolicyV1;
+};
+type WorkflowPart<ActionTag extends string = string> = ReadonlyArray<WorkflowStep<ActionTag>> | WorkflowFragment<ActionTag> | WorkflowComposeResult<ActionTag>;
+declare const KernelSourceRefreshPortTagImpl_base: ServiceMap.ServiceClass<KernelSourceRefreshPortTagImpl, "logix/kernel/sourceRefresh", unknown>;
+declare class KernelSourceRefreshPortTagImpl extends KernelSourceRefreshPortTagImpl_base {
+}
+declare const KernelPorts: {
+    readonly sourceRefresh: typeof KernelSourceRefreshPortTagImpl;
+};
+declare const forModule: <M extends {
+    readonly actions: Record<string, unknown>;
+}>(_module: M) => {
+    readonly onAction: (actionTag: ActionTagsOfModule<M>) => {
+        readonly kind: "action";
+        readonly actionTag: ActionTagsOfModule<M>;
+    };
+    readonly onStart: () => {
+        readonly kind: "lifecycle";
+        readonly phase: "onStart";
+    };
+    readonly onInit: () => {
+        readonly kind: "lifecycle";
+        readonly phase: "onInit";
+    };
+    readonly payload: () => InputExprV1;
+    readonly payloadPath: (pointer: string) => InputExprV1;
+    readonly constValue: (value: JsonValue) => InputExprV1;
+    readonly object: (fields: Record<string, InputExprV1>) => InputExprV1;
+    readonly merge: (items: ReadonlyArray<InputExprV1>) => InputExprV1;
+    readonly dispatch: (args: {
+        readonly key: string;
+        readonly actionTag: ActionTagsOfModule<M>;
+        readonly payload?: InputExpr;
+    }) => {
+        readonly kind: "dispatch";
+        readonly key: string;
+        readonly actionTag: ActionTagsOfModule<M>;
+        readonly payload?: InputExprV1;
+    };
+    readonly delay: (args: {
+        readonly key: string;
+        readonly ms: number;
+    }) => Extract<WorkflowStep, {
+        kind: "delay";
+    }>;
+    readonly callById: (args: {
+        readonly key: string;
+        readonly serviceId: string;
+        readonly input?: InputExpr;
+        readonly timeoutMs?: number;
+        readonly retry?: {
+            readonly times: number;
+        };
+        readonly onSuccess?: ReadonlyArray<WorkflowStep<ActionTagsOfModule<M>>>;
+        readonly onFailure?: ReadonlyArray<WorkflowStep<ActionTagsOfModule<M>>>;
+    }) => {
+        readonly kind: "call";
+        readonly key: string;
+        readonly serviceId: string;
+        readonly input?: InputExprV1;
+        readonly timeoutMs?: number;
+        readonly retry?: {
+            readonly times: number;
+        };
+        readonly onSuccess: readonly WorkflowStep<ActionTagsOfModule<M>>[];
+        readonly onFailure: readonly WorkflowStep<ActionTagsOfModule<M>>[];
+    };
+    readonly call: <Id, Svc>(args: {
+        readonly key: string;
+        readonly service: ServiceMap.Key<Id, Svc>;
+        readonly input?: InputExpr;
+        readonly timeoutMs?: number;
+        readonly retry?: {
+            readonly times: number;
+        };
+        readonly onSuccess?: ReadonlyArray<WorkflowStep<ActionTagsOfModule<M>>>;
+        readonly onFailure?: ReadonlyArray<WorkflowStep<ActionTagsOfModule<M>>>;
+    }) => {
+        readonly kind: "call";
+        readonly key: string;
+        readonly serviceId: string;
+        readonly input?: InputExprV1;
+        readonly timeoutMs?: number;
+        readonly retry?: {
+            readonly times: number;
+        };
+        readonly onSuccess: readonly WorkflowStep<ActionTagsOfModule<M>>[];
+        readonly onFailure: readonly WorkflowStep<ActionTagsOfModule<M>>[];
+    };
+    readonly fragment: (fragmentId: string, steps: ReadonlyArray<WorkflowStep<ActionTagsOfModule<M>>>) => WorkflowFragment<ActionTagsOfModule<M>>;
+    readonly withPolicy: (patch: WithPolicyPatch, part: WorkflowPart<ActionTagsOfModule<M>>) => WorkflowComposeResult<ActionTagsOfModule<M>>;
+    readonly compose: (...parts: ReadonlyArray<WorkflowPart<ActionTagsOfModule<M>>>) => WorkflowComposeResult<ActionTagsOfModule<M>>;
+    readonly make: (input: {
+        readonly astVersion?: 1;
+        readonly localId: string;
+        readonly trigger: WorkflowTrigger<ActionTagsOfModule<M>>;
+        readonly policy?: WorkflowPolicy;
+        readonly steps: WorkflowStepsInput<ActionTagsOfModule<M>>;
+        readonly meta?: {
+            readonly generator?: JsonValue;
+        };
+    }) => Workflow;
+    readonly fromJSON: (def: WorkflowDef<ActionTagsOfModule<M>>) => Workflow;
+};
+type WithPolicyPatch = {
+    readonly concurrency?: WorkflowPolicyV1['concurrency'];
+    readonly priority?: WorkflowPolicyV1['priority'];
+    /** Default for call.timeoutMs (only fills when step.timeoutMs is missing). */
+    readonly timeoutMs?: number;
+    /** Default for call.retry.times (only fills when step.retry is missing). */
+    readonly retry?: {
+        readonly times: number;
+    };
+};
+type WorkflowStepsInput<ActionTag extends string = string> = ReadonlyArray<WorkflowStep<ActionTag>> | (WorkflowComposeResult<ActionTag> & {
+    readonly steps: ReadonlyArray<WorkflowStep<ActionTag>>;
+});
+interface Workflow {
+    readonly _tag: 'Workflow';
+    readonly def: WorkflowDefV1;
+    readonly toJSON: () => WorkflowDefV1;
+    readonly validate: () => void;
+    readonly exportStaticIr: (moduleId: string) => WorkflowStaticIrV1;
+    readonly install: (moduleTag: ModuleTag<string, AnyModuleShape>) => ModuleLogic<AnyModuleShape, unknown, never>;
+}
+declare const onAction: <ActionTag extends string>(actionTag: ActionTag) => Extract<WorkflowTrigger<ActionTag>, {
+    kind: "action";
+}>;
+declare const onStart: () => {
+    readonly kind: "lifecycle";
+    readonly phase: "onStart";
+};
+declare const onInit: () => {
+    readonly kind: "lifecycle";
+    readonly phase: "onInit";
+};
+declare const payload: () => InputExprV1;
+declare const payloadPath: (pointer: string) => InputExprV1;
+declare const constValue: (value: JsonValue) => InputExprV1;
+declare const object: (fields: Record<string, InputExprV1>) => InputExprV1;
+declare const merge: (items: ReadonlyArray<InputExprV1>) => InputExprV1;
+declare const dispatch: <ActionTag extends string>(args: {
+    readonly key: string;
+    readonly actionTag: ActionTag;
+    readonly payload?: InputExprV1;
+}) => Extract<WorkflowStep<ActionTag>, {
+    kind: "dispatch";
+}>;
+declare const delay: (args: {
+    readonly key: string;
+    readonly ms: number;
+}) => Extract<WorkflowStep, {
+    kind: "delay";
+}>;
+declare const callById: <ActionTag extends string = never>(args: {
+    readonly key: string;
+    readonly serviceId: string;
+    readonly input?: InputExprV1;
+    readonly timeoutMs?: number;
+    readonly retry?: {
+        readonly times: number;
+    };
+    readonly onSuccess?: ReadonlyArray<WorkflowStep<ActionTag>>;
+    readonly onFailure?: ReadonlyArray<WorkflowStep<ActionTag>>;
+}) => Extract<WorkflowStep<ActionTag>, {
+    kind: "call";
+}>;
+declare const call: <Id, Svc, ActionTag extends string = never>(args: {
+    readonly key: string;
+    readonly service: ServiceMap.Key<Id, Svc>;
+    readonly input?: InputExprV1;
+    readonly timeoutMs?: number;
+    readonly retry?: {
+        readonly times: number;
+    };
+    readonly onSuccess?: ReadonlyArray<WorkflowStep<ActionTag>>;
+    readonly onFailure?: ReadonlyArray<WorkflowStep<ActionTag>>;
+}) => Extract<WorkflowStep<ActionTag>, {
+    kind: "call";
+}>;
+declare const fragment: <ActionTag extends string = never>(fragmentId: string, steps: ReadonlyArray<WorkflowStep<ActionTag>>) => WorkflowFragment<ActionTag>;
+declare const withPolicy: <ActionTag extends string = never>(patch: WithPolicyPatch, part: WorkflowPart<ActionTag>) => WorkflowComposeResult<ActionTag>;
+declare const compose: <ActionTag extends string = never>(...parts: ReadonlyArray<WorkflowPart<ActionTag>>) => WorkflowComposeResult<ActionTag>;
+declare const make: <M = unknown>(input: {
+    readonly astVersion?: 1;
+    readonly localId: string;
+    readonly trigger: WorkflowTrigger<ActionTagsOfModule<M>>;
+    readonly policy?: WorkflowPolicyV1;
+    readonly steps: WorkflowStepsInput<ActionTagsOfModule<M>>;
+    readonly meta?: {
+        readonly generator?: JsonValue;
+    };
+}) => Workflow;
+declare const fromJSON: <ActionTag extends string = string>(def: WorkflowDef<ActionTag>) => Workflow;
+
+type Workflow$1_ActionTagsOfModule<M> = ActionTagsOfModule<M>;
+type Workflow$1_InputExpr = InputExpr;
+declare const Workflow$1_KernelPorts: typeof KernelPorts;
+type Workflow$1_WithPolicyPatch = WithPolicyPatch;
+type Workflow$1_Workflow = Workflow;
+type Workflow$1_WorkflowComposeResult<ActionTag extends string = string> = WorkflowComposeResult<ActionTag>;
+type Workflow$1_WorkflowDef<ActionTag extends string = string> = WorkflowDef<ActionTag>;
+type Workflow$1_WorkflowFragment<ActionTag extends string = string> = WorkflowFragment<ActionTag>;
+type Workflow$1_WorkflowPart<ActionTag extends string = string> = WorkflowPart<ActionTag>;
+type Workflow$1_WorkflowPolicy = WorkflowPolicy;
+type Workflow$1_WorkflowStaticIr = WorkflowStaticIr;
+type Workflow$1_WorkflowStep<ActionTag extends string = string> = WorkflowStep<ActionTag>;
+type Workflow$1_WorkflowStepsInput<ActionTag extends string = string> = WorkflowStepsInput<ActionTag>;
+type Workflow$1_WorkflowTrigger<ActionTag extends string = string> = WorkflowTrigger<ActionTag>;
+declare const Workflow$1_call: typeof call;
+declare const Workflow$1_callById: typeof callById;
+declare const Workflow$1_compose: typeof compose;
+declare const Workflow$1_constValue: typeof constValue;
+declare const Workflow$1_delay: typeof delay;
+declare const Workflow$1_dispatch: typeof dispatch;
+declare const Workflow$1_forModule: typeof forModule;
+declare const Workflow$1_fragment: typeof fragment;
+declare const Workflow$1_fromJSON: typeof fromJSON;
+declare const Workflow$1_make: typeof make;
+declare const Workflow$1_merge: typeof merge;
+declare const Workflow$1_object: typeof object;
+declare const Workflow$1_onAction: typeof onAction;
+declare const Workflow$1_onInit: typeof onInit;
+declare const Workflow$1_onStart: typeof onStart;
+declare const Workflow$1_payload: typeof payload;
+declare const Workflow$1_payloadPath: typeof payloadPath;
+declare const Workflow$1_withPolicy: typeof withPolicy;
+declare namespace Workflow$1 {
+  export { type Workflow$1_ActionTagsOfModule as ActionTagsOfModule, type Workflow$1_InputExpr as InputExpr, Workflow$1_KernelPorts as KernelPorts, type Workflow$1_WithPolicyPatch as WithPolicyPatch, type Workflow$1_Workflow as Workflow, type Workflow$1_WorkflowComposeResult as WorkflowComposeResult, type Workflow$1_WorkflowDef as WorkflowDef, type Workflow$1_WorkflowFragment as WorkflowFragment, type Workflow$1_WorkflowPart as WorkflowPart, type Workflow$1_WorkflowPolicy as WorkflowPolicy, type Workflow$1_WorkflowStaticIr as WorkflowStaticIr, type Workflow$1_WorkflowStep as WorkflowStep, type Workflow$1_WorkflowStepsInput as WorkflowStepsInput, type Workflow$1_WorkflowTrigger as WorkflowTrigger, Workflow$1_call as call, Workflow$1_callById as callById, Workflow$1_compose as compose, Workflow$1_constValue as constValue, Workflow$1_delay as delay, Workflow$1_dispatch as dispatch, Workflow$1_forModule as forModule, Workflow$1_fragment as fragment, Workflow$1_fromJSON as fromJSON, Workflow$1_make as make, Workflow$1_merge as merge, Workflow$1_object as object, Workflow$1_onAction as onAction, Workflow$1_onInit as onInit, Workflow$1_onStart as onStart, Workflow$1_payload as payload, Workflow$1_payloadPath as payloadPath, Workflow$1_withPolicy as withPolicy };
+}
+
+export { type ActionTagsOfModule as A, withPolicy as B, compose as C, make as D, fromJSON as E, type InputExpr as I, KernelPorts as K, Workflow$1 as W, type WorkflowStaticIrV1 as a, type Workflow as b, type WorkflowTrigger as c, type WorkflowPolicy as d, type WorkflowStep as e, type WorkflowDef as f, type WorkflowStaticIr as g, type WorkflowFragment as h, type WorkflowComposeResult as i, type WorkflowPart as j, forModule as k, type WithPolicyPatch as l, type WorkflowStepsInput as m, onStart as n, onAction as o, onInit as p, payload as q, payloadPath as r, constValue as s, object as t, merge as u, dispatch as v, delay as w, callById as x, call as y, fragment as z };