@legatoacc3/workflow-api 0.1.0-alpha.0

package/README.md

@@ -0,0 +1,35 @@
+# Workflow API
+
+`@legatoacc3/workflow-api` is the planned typed SDK boundary for workflow integration.
+
+## Purpose
+
+This package is for:
+
+- workflow draft CRUD
+- validate and publish calls
+- builder node metadata loading
+- workflow request submission
+- workflow runs and node executions
+- approval tasks
+- pause/resume actions
+
+## Current State
+
+This package is scaffolded with:
+
+- starter DTOs
+- a fetch-based API client
+- clear method groupings for builder and runtime flows
+
+It is intended to replace app-local wrappers currently found in:
+
+- `apps/lsflow-web/app/features/builder/api/workflow-drafts.ts`
+- `apps/lsflow-web/app/features/runtime/api/workflow-runtime.ts`
+- `apps/lsflow-web/app/features/builder/debug/builder-debug-api.ts`
+
+## Notes
+
+This is a starter boundary, not the final extracted implementation.
+
+The DTOs should later be aligned against the canonical shared contracts used by both frontend and backend systems.

package/dist/client.d.ts

@@ -0,0 +1,62 @@
+import type { BuilderDebugRunResources, BuilderDebugRunSummary, BuilderNodeMetadataResponse, PublishedWorkflowSummary, RuntimeActorContext, WorkflowActorContext, WorkflowApprovalTask, WorkflowDraft, WorkflowDraftCreateInput, WorkflowDraftUpdateInput, WorkflowNodeExecutionRecord, WorkflowPauseResumeInput, WorkflowRequestInstance, WorkflowRequestSubmissionResult, WorkflowRunEventRecord, WorkflowRunRecord, WorkflowWorkItemRecord } from './contracts';
+export interface WorkflowApiClientOptions {
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+}
+export interface WorkflowApiClient {
+    listWorkflowDrafts(): Promise<WorkflowDraft[]>;
+    createWorkflowDraft(input?: Partial<WorkflowDraftCreateInput>): Promise<WorkflowDraft>;
+    fetchWorkflowDraft(draftId: string): Promise<WorkflowDraft>;
+    updateWorkflowDraft(draftId: string, input: WorkflowDraftUpdateInput): Promise<WorkflowDraft>;
+    validateWorkflowDraft(draftId: string): Promise<WorkflowDraft>;
+    publishWorkflowDraft(draftId: string): Promise<WorkflowDraft>;
+    fetchBuilderNodeMetadata(): Promise<BuilderNodeMetadataResponse>;
+    listPublishedWorkflows(): Promise<PublishedWorkflowSummary[]>;
+    getPublishedWorkflow(workflowId: string): Promise<PublishedWorkflowSummary>;
+    submitWorkflowRequest(workflowId: string, values: Record<string, unknown>): Promise<WorkflowRequestSubmissionResult>;
+    listWorkflowRequests(mine?: boolean): Promise<WorkflowRequestInstance[]>;
+    getWorkflowRequest(requestId: string): Promise<WorkflowRequestInstance>;
+    listWorkflowRuns(input?: {
+        requestId?: string;
+        workflowId?: string;
+    }): Promise<WorkflowRunRecord[]>;
+    getWorkflowRun(workflowRunId: string): Promise<WorkflowRunRecord>;
+    listWorkflowRunEvents(workflowRunId: string): Promise<WorkflowRunEventRecord[]>;
+    listWorkflowNodeExecutions(workflowRunId: string): Promise<WorkflowNodeExecutionRecord[]>;
+    listWorkflowWorkItems(workflowRunId: string): Promise<WorkflowWorkItemRecord[]>;
+    resumeWorkflowHumanInput(workflowRunId: string, input: WorkflowPauseResumeInput): Promise<WorkflowRequestInstance>;
+    listApprovalTasks(mine?: boolean): Promise<Array<{
+        request: WorkflowRequestInstance;
+        task: WorkflowApprovalTask;
+    }>>;
+    decideApprovalTask(taskId: string, decision: 'approve' | 'reject'): Promise<WorkflowRequestInstance>;
+    startBuilderDebugRun(input: {
+        publishedWorkflowVersionId: string;
+        inputPayload: Record<string, unknown>;
+    }): Promise<BuilderDebugRunResources>;
+    startBuilderSingleNodeDebugRun(input: {
+        publishedWorkflowVersionId: string;
+        nodeId: string;
+        inputPayload: Record<string, unknown>;
+        baseWorkflowRunId?: string;
+        variableOverrides?: Record<string, unknown>;
+    }): Promise<BuilderDebugRunResources>;
+    getBuilderDebugRun(workflowRunId: string): Promise<BuilderDebugRunResources>;
+    listBuilderDebugRuns(workflowId: string): Promise<BuilderDebugRunSummary[]>;
+    resumeBuilderDebugHumanInput(workflowRunId: string, input: WorkflowPauseResumeInput): Promise<BuilderDebugRunResources>;
+    resumeBuilderDebugApproval(workflowRunId: string, input: {
+        taskId?: string;
+        decision: 'approve' | 'reject';
+    }): Promise<BuilderDebugRunResources>;
+}
+export declare function createWorkflowActorHeaders(context: WorkflowActorContext): {
+    'x-lsflow-role': import("./contracts").WorkflowActorRole;
+    'x-lsflow-tenant-id': string;
+    'x-lsflow-workspace-id': string;
+    'x-lsflow-user-id': string;
+    'x-lsflow-user-name': string;
+};
+export declare function createWorkflowApiClient(options?: WorkflowApiClientOptions): WorkflowApiClient;
+export declare function createWorkflowApiClientForActor(context: RuntimeActorContext, options?: WorkflowApiClientOptions): WorkflowApiClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/contracts.d.ts

@@ -0,0 +1,205 @@
+import type { WorkflowDraft, WorkflowDraftCreateInput, PublishedWorkflowDefinition } from '@legatoacc3/workflow-builder/domain';
+import type { BuilderNodeMetadataResponse } from '@legatoacc3/workflow-builder/builder-node-metadata-response';
+export type { BuilderNodeMetadataResponse, PublishedWorkflowDefinition, WorkflowDraft, WorkflowDraftCreateInput };
+export type WorkflowActorRole = 'requester' | 'approver' | 'operator' | 'admin';
+export interface WorkflowActorContext {
+    role: WorkflowActorRole;
+    tenantId: string;
+    workspaceId: string;
+    userId: string;
+    displayName: string;
+}
+export type BuilderAdminContext = WorkflowActorContext & {
+    role: 'admin';
+};
+export type RuntimeActorContext = WorkflowActorContext;
+export type WorkflowDraftUpdateInput = WorkflowDraft;
+export type WorkflowRequestStatus = 'submitted' | 'in-progress' | 'pending-approval' | 'approved' | 'rejected' | 'rerouted' | 'escalated' | 'completed' | 'failed';
+export type WorkflowRunStatus = 'running' | 'waiting' | 'completed' | 'failed' | 'cancelled';
+export type WorkflowRunEventType = 'run-created' | 'run-started' | 'run-waiting' | 'run-resumed' | 'run-completed' | 'run-failed' | 'node-entered' | 'node-completed' | 'node-waiting' | 'node-failed' | 'approval-task-created' | 'approval-task-rerouted' | 'approval-task-escalated' | 'approval-task-decided' | 'secure-link-generated' | 'secure-link-used';
+export type WorkflowRunTriggerSource = 'request-submission' | 'approval-decision' | 'secure-approval-decision' | 'operator-resume' | 'batch-execution' | 'debug-single-step';
+export type WorkflowRunPauseKind = 'approval' | 'human-input' | 'timer';
+export type WorkflowNodeExecutionStatus = 'running' | 'waiting' | 'succeeded' | 'failed' | 'skipped' | 'cancelled';
+export type WorkflowWorkItemStatus = 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled';
+export type WorkflowWorkItemKind = 'execute-node';
+export interface WorkflowRunPauseState {
+    kind: WorkflowRunPauseKind;
+    nodeId: string;
+    nodeLabel: string;
+    reason: string;
+    taskId?: string;
+}
+export interface WorkflowRunRecord {
+    id: string;
+    tenantId: string;
+    workspaceId: string;
+    requestId: string;
+    workflowId: string;
+    workflowVersionId: string;
+    workflowVersionNumber: number;
+    workflowName: string;
+    status: WorkflowRunStatus;
+    triggerSource: WorkflowRunTriggerSource;
+    startedByActorId: string;
+    startedByActorName: string;
+    startedAt: string;
+    updatedAt: string;
+    completedAt: string | null;
+    currentNodeId: string | null;
+    currentNodeLabel: string | null;
+    outcome: Extract<WorkflowRequestStatus, 'approved' | 'rejected' | 'completed' | 'failed'> | null;
+    pauseState: WorkflowRunPauseState | null;
+    latestEventId: string | null;
+}
+export interface WorkflowNodeExecutionRecord {
+    id: string;
+    tenantId: string;
+    workspaceId: string;
+    workflowRunId: string;
+    requestId: string;
+    workflowId: string;
+    workflowVersionId: string;
+    workflowVersionNumber: number;
+    nodeId: string;
+    nodeKind: string;
+    nodeLabel: string;
+    predecessorNodeId: string | null;
+    status: WorkflowNodeExecutionStatus;
+    attempt: number;
+    startedAt: string;
+    finishedAt: string | null;
+    inputSnapshot: Record<string, unknown> | null;
+    outputSnapshot: Record<string, unknown> | null;
+    errorDetail: string | null;
+    waitState: WorkflowRunPauseState | null;
+}
+export interface WorkflowRunEventRecord {
+    id: string;
+    tenantId: string;
+    workspaceId: string;
+    workflowRunId: string;
+    requestId: string;
+    workflowId: string;
+    workflowVersionId: string;
+    workflowVersionNumber: number;
+    nodeExecutionId: string | null;
+    nodeId: string | null;
+    nodeLabel: string | null;
+    type: WorkflowRunEventType;
+    actorId: string;
+    actorName: string;
+    timestamp: string;
+    summary: string;
+    detail: string;
+    payload: Record<string, unknown> | null;
+}
+export interface WorkflowWorkItemRecord {
+    id: string;
+    tenantId: string;
+    workspaceId: string;
+    workflowRunId: string;
+    requestId: string;
+    workflowId: string;
+    workflowVersionId: string;
+    workflowVersionNumber: number;
+    kind: WorkflowWorkItemKind;
+    status: WorkflowWorkItemStatus;
+    nodeId: string;
+    predecessorNodeId: string | null;
+    sequenceNumber: number;
+    retryCount: number;
+    availableAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+    workerId: string | null;
+    payload: Record<string, unknown> | null;
+    errorDetail: string | null;
+}
+export interface WorkflowApprovalTask {
+    id: string;
+    requestId: string;
+    workflowId: string;
+    workflowVersionId: string;
+    nodeId: string;
+    nodeLabel: string;
+    status: 'pending' | 'approved' | 'rejected' | 'rerouted' | 'escalated' | 'cancelled';
+    assigneeId: string;
+    assigneeName: string;
+    createdAt: string;
+    updatedAt: string;
+    decidedAt: string | null;
+    decision: 'approve' | 'reject' | null;
+    lastRouteReason: string | null;
+    history: Array<Record<string, unknown>>;
+}
+export interface WorkflowRequestHistoryEntry {
+    id: string;
+    action: string;
+    actorId: string;
+    actorName: string;
+    timestamp: string;
+    detail: string;
+    status: WorkflowRequestStatus;
+}
+export interface WorkflowRequestInstance {
+    id: string;
+    tenantId: string;
+    workspaceId: string;
+    workflowRunId: string;
+    workflowId: string;
+    workflowVersionId: string;
+    workflowVersionNumber: number;
+    formVersionId: string;
+    workflowName: string;
+    requesterId: string;
+    requesterName: string;
+    status: WorkflowRequestStatus;
+    currentNodeId: string | null;
+    currentNodeLabel: string | null;
+    submittedAt: string;
+    updatedAt: string;
+    completedAt: string | null;
+    failureDetail: string | null;
+    submittedData: Record<string, unknown>;
+    workflowDefinition: PublishedWorkflowDefinition;
+    approvalTasks: WorkflowApprovalTask[];
+    history: WorkflowRequestHistoryEntry[];
+    runtimeState: Record<string, unknown>;
+}
+export interface PublishedWorkflowSummary {
+    tenantId: string;
+    workspaceId: string;
+    workflowId: string;
+    workflowVersionId: string;
+    workflowVersionNumber: number;
+    workflowName: string;
+    workflowDescription: string;
+    publishedAt: string;
+    formSchema: PublishedWorkflowDefinition['formSchema'];
+}
+export interface WorkflowRequestSubmissionInput {
+    workflowId: string;
+    values: Record<string, unknown>;
+}
+export interface WorkflowRequestSubmissionResult {
+    request: WorkflowRequestInstance;
+    confirmation: {
+        requestId: string;
+        status: WorkflowRequestStatus;
+        message: string;
+    };
+}
+export interface WorkflowPauseResumeInput {
+    taskId?: string;
+    submittedData: Record<string, unknown>;
+}
+export interface BuilderDebugRunResources {
+    run: WorkflowRunRecord;
+    executions: WorkflowNodeExecutionRecord[];
+    events: WorkflowRunEventRecord[];
+    workItems: WorkflowWorkItemRecord[];
+}
+export type BuilderDebugRunSummary = WorkflowRunRecord;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './client';
+export * from './contracts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,173 @@
+//#region src/client.ts
+function trimTrailingSlash(value) {
+	return value.endsWith("/") ? value.slice(0, -1) : value;
+}
+function isHeaders(value) {
+	return typeof Headers !== "undefined" && value instanceof Headers;
+}
+function normalizeHeaders(value) {
+	if (!value) return {};
+	if (isHeaders(value)) return Object.fromEntries(value.entries());
+	if (Array.isArray(value)) return Object.fromEntries(value);
+	return { ...value };
+}
+async function resolveHeaders(input) {
+	return normalizeHeaders(typeof input === "function" ? await input() : input);
+}
+function createWorkflowActorHeaders(context) {
+	return {
+		"x-lsflow-role": context.role,
+		"x-lsflow-tenant-id": context.tenantId,
+		"x-lsflow-workspace-id": context.workspaceId,
+		"x-lsflow-user-id": context.userId,
+		"x-lsflow-user-name": context.displayName
+	};
+}
+function buildQuery(input) {
+	const query = new URLSearchParams();
+	for (const [key, value] of Object.entries(input)) if (value !== void 0) query.set(key, String(value));
+	return query.size > 0 ? `?${query.toString()}` : "";
+}
+function createWorkflowApiClient(options = {}) {
+	const baseUrl = options.baseUrl ? trimTrailingSlash(options.baseUrl) : "";
+	const fetchImpl = options.fetch ?? globalThis.fetch;
+	if (!fetchImpl) throw new Error("A fetch implementation is required to create a workflow API client.");
+	async function request(path, init = {}) {
+		const headers = await resolveHeaders(options.headers);
+		const response = await fetchImpl(`${baseUrl}${path}`, {
+			...init,
+			headers: {
+				...init.body ? { "content-type": "application/json" } : {},
+				...headers,
+				...normalizeHeaders(init.headers)
+			}
+		});
+		if (!response.ok) {
+			const errorBody = await response.text();
+			throw new Error(`Workflow API request failed (${response.status}): ${errorBody}`);
+		}
+		if (response.status === 204) return;
+		return response.json();
+	}
+	return {
+		listWorkflowDrafts() {
+			return request("/api/workflow-drafts");
+		},
+		createWorkflowDraft(input = {}) {
+			return request("/api/workflow-drafts", {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		},
+		fetchWorkflowDraft(draftId) {
+			return request(`/api/workflow-drafts/${draftId}`);
+		},
+		updateWorkflowDraft(draftId, input) {
+			return request(`/api/workflow-drafts/${draftId}`, {
+				method: "PATCH",
+				body: JSON.stringify(input)
+			});
+		},
+		validateWorkflowDraft(draftId) {
+			return request(`/api/workflow-drafts/${draftId}/validate`, { method: "POST" });
+		},
+		publishWorkflowDraft(draftId) {
+			return request(`/api/workflow-drafts/${draftId}/publish`, { method: "POST" });
+		},
+		fetchBuilderNodeMetadata() {
+			return request("/api/builder-node-metadata");
+		},
+		listPublishedWorkflows() {
+			return request("/api/published-workflows");
+		},
+		getPublishedWorkflow(workflowId) {
+			return request(`/api/published-workflows/${workflowId}`);
+		},
+		submitWorkflowRequest(workflowId, values) {
+			return request("/api/workflow-requests", {
+				method: "POST",
+				body: JSON.stringify({
+					workflowId,
+					values
+				})
+			});
+		},
+		listWorkflowRequests(mine = true) {
+			return request(`/api/workflow-requests${buildQuery({ mine })}`);
+		},
+		getWorkflowRequest(requestId) {
+			return request(`/api/workflow-requests/${requestId}`);
+		},
+		listWorkflowRuns(input = {}) {
+			return request("/api/workflow-runs" + buildQuery(input));
+		},
+		getWorkflowRun(workflowRunId) {
+			return request(`/api/workflow-runs/${workflowRunId}`);
+		},
+		listWorkflowRunEvents(workflowRunId) {
+			return request(`/api/workflow-runs/${workflowRunId}/events`);
+		},
+		listWorkflowNodeExecutions(workflowRunId) {
+			return request(`/api/workflow-runs/${workflowRunId}/node-executions`);
+		},
+		listWorkflowWorkItems(workflowRunId) {
+			return request(`/api/workflow-runs/${workflowRunId}/work-items`);
+		},
+		resumeWorkflowHumanInput(workflowRunId, input) {
+			return request(`/api/workflow-runs/${workflowRunId}/resume-human-input`, {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		},
+		listApprovalTasks(mine = true) {
+			return request(`/api/approval-tasks${buildQuery({ mine })}`);
+		},
+		decideApprovalTask(taskId, decision) {
+			return request(`/api/approval-tasks/${taskId}/decision`, {
+				method: "POST",
+				body: JSON.stringify({ decision })
+			});
+		},
+		startBuilderDebugRun(input) {
+			return request("/api/workflow-debug-runs", {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		},
+		startBuilderSingleNodeDebugRun(input) {
+			return request("/api/workflow-debug-runs/start-single-node", {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		},
+		getBuilderDebugRun(workflowRunId) {
+			return request(`/api/workflow-debug-runs/${workflowRunId}`);
+		},
+		listBuilderDebugRuns(workflowId) {
+			return request(`/api/workflow-debug-runs${buildQuery({ workflowId })}`);
+		},
+		resumeBuilderDebugHumanInput(workflowRunId, input) {
+			return request(`/api/workflow-debug-runs/${workflowRunId}/resume-human-input`, {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		},
+		resumeBuilderDebugApproval(workflowRunId, input) {
+			return request(`/api/workflow-debug-runs/${workflowRunId}/resume-approval`, {
+				method: "POST",
+				body: JSON.stringify(input)
+			});
+		}
+	};
+}
+function createWorkflowApiClientForActor(context, options = {}) {
+	return createWorkflowApiClient({
+		...options,
+		headers: async () => ({
+			...createWorkflowActorHeaders(context),
+			...normalizeHeaders(typeof options.headers === "function" ? await options.headers() : options.headers)
+		})
+	});
+}
+//#endregion
+export { createWorkflowActorHeaders, createWorkflowApiClient, createWorkflowApiClientForActor };

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@legatoacc3/workflow-api",
+  "version": "0.1.0-alpha.0",
+  "description": "Typed workflow API client for drafts, runtime state, approvals, metadata, and publish flows.",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@legatoacc3/workflow-builder": "^0.1.0-alpha.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.12.2",
+    "typescript": "~6.0.2",
+    "vite": "^8.0.4"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
+  "scripts": {
+    "clean": "node -e \"const fs=require('node:fs'); fs.rmSync('dist',{recursive:true,force:true}); fs.rmSync('tsconfig.build.tsbuildinfo',{force:true})\"",
+    "build": "pnpm run clean && vite build && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}