@molda-org/workflow-actions-audit 0.1.0-next.2 → 0.1.0-next.21

package/dist/index.d.ts

@@ -0,0 +1,176 @@
+import type { MoldaModuleDefinition, MoldaModuleShape } from '@molda-org/module-contracts';
+import { z } from 'zod';
+import { type ModuleRepository } from '@molda-org/module-runtime';
+export type WorkflowActionsAuditAction = 'executeWorkflowAction' | 'approveWorkflowAction' | 'compensateWorkflowAction';
+export type WorkflowActionsAuditView = 'workflowHistory' | 'actionAuditLog' | 'pendingApprovals';
+export type WorkflowActionsAuditHook = 'useWorkflowHistory' | 'useActionAuditLog' | 'usePendingApprovals';
+export interface WorkflowActionsAuditModuleShape extends MoldaModuleShape<'workflow-actions-audit', WorkflowActionsAuditAction, WorkflowActionsAuditView, WorkflowActionsAuditHook> {
+    readonly stage: 'initial';
+    readonly category: 'platform-core';
+    readonly purpose: 'Long-running actions, approvals, compensation, immutable audit evidence, and operational history.';
+}
+export type WorkflowActionsAuditModule = MoldaModuleDefinition<WorkflowActionsAuditModuleShape>;
+export declare const WorkflowActionsAuditActionIds: readonly ["executeWorkflowAction", "approveWorkflowAction", "compensateWorkflowAction"];
+export declare const WorkflowActionsAuditViewIds: readonly ["workflowHistory", "actionAuditLog", "pendingApprovals"];
+export declare const WorkflowActionsAuditHookIds: readonly ["useWorkflowHistory", "useActionAuditLog", "usePendingApprovals"];
+export declare const WorkflowActionsAuditSpecification: {
+    readonly id: "workflow-actions-audit";
+    readonly version: "1.0.0";
+    readonly collections: {
+        readonly 'workflow-actions': z.ZodObject<{
+            type: z.ZodString;
+            status: z.ZodEnum<{
+                "pending-approval": "pending-approval";
+                approved: "approved";
+                completed: "completed";
+                failed: "failed";
+                compensated: "compensated";
+            }>;
+            payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            transitionReason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly 'action-audit': z.ZodObject<{
+            actionId: z.ZodString;
+            actorId: z.ZodString;
+            outcome: z.ZodString;
+            occurredAt: z.ZodString;
+        }, z.core.$strict>;
+    };
+    readonly actions: {
+        readonly executeWorkflowAction: {
+            readonly kind: "create";
+            readonly collection: "workflow-actions";
+            readonly permission: "execute.workflow.action";
+            readonly event: "execute.workflow.action";
+        };
+        readonly approveWorkflowAction: {
+            readonly kind: "transition";
+            readonly collection: "workflow-actions";
+            readonly permission: "approve.workflow.action";
+            readonly event: "approve.workflow.action";
+            readonly status: "approved";
+            readonly allowedFrom: readonly ["pending-approval"];
+            readonly confirmation: "required";
+        };
+        readonly compensateWorkflowAction: {
+            readonly kind: "transition";
+            readonly collection: "workflow-actions";
+            readonly permission: "compensate.workflow.action";
+            readonly event: "compensate.workflow.action";
+            readonly status: "compensated";
+            readonly allowedFrom: readonly ["completed", "failed"];
+            readonly confirmation: "required";
+        };
+    };
+    readonly views: {
+        readonly workflowHistory: {
+            readonly kind: "list";
+            readonly collection: "workflow-actions";
+            readonly permission: "workflow.history.read";
+        };
+        readonly actionAuditLog: {
+            readonly kind: "list";
+            readonly collection: "action-audit";
+            readonly permission: "action.audit.log.read";
+        };
+        readonly pendingApprovals: {
+            readonly kind: "list";
+            readonly collection: "workflow-actions";
+            readonly permission: "pending.approvals.read";
+            readonly where: {
+                readonly status: "pending-approval";
+            };
+        };
+    };
+    readonly migrations: readonly [{
+        readonly version: 1;
+        readonly description: "Create workflow-actions-audit collections and indexes";
+    }];
+    readonly fixtures: readonly [{
+        readonly id: "workflow-actions-audit-baseline";
+        readonly description: "Deterministic workflow-actions-audit production-case fixture";
+        readonly records: readonly [{
+            readonly collection: "workflow-actions";
+            readonly id: "workflow-fixture";
+            readonly value: {
+                readonly type: "fixture.review";
+                readonly status: "pending-approval";
+                readonly payload: {
+                    readonly source: "fixture";
+                };
+            };
+        }];
+    }];
+};
+export declare const WorkflowActionsAuditBlueprint: import("@molda-org/module-runtime").ModuleBlueprint<{
+    [k: string]: import("@molda-org/module-runtime").ModuleActionDefinition<{
+        id: string;
+        data: Record<string, unknown>;
+    }, import("@molda-org/module-runtime").ModuleRecord<Readonly<Record<string, unknown>>>> | import("@molda-org/module-runtime").ModuleActionDefinition<{
+        data: Record<string, unknown>;
+    }, import("@molda-org/module-runtime").ModuleRecord<Readonly<Record<string, unknown>>>> | import("@molda-org/module-runtime").ModuleActionDefinition<{
+        id: string;
+        expectedRevision: number;
+        patch: Record<string, unknown>;
+        reason?: string | undefined;
+    }, import("@molda-org/module-runtime").ModuleRecord<Readonly<Record<string, unknown>>>> | import("@molda-org/module-runtime").ModuleActionDefinition<{
+        id: string;
+        expectedRevision: number;
+        patch: Record<string, unknown>;
+    }, import("@molda-org/module-runtime").ModuleRecord<Readonly<Record<string, unknown>>>>;
+}, {
+    [k: string]: import("@molda-org/module-runtime").ModuleViewDefinition<{
+        id: string;
+    }, import("@molda-org/module-runtime").ModuleRecord<Readonly<Record<string, unknown>>>> | import("@molda-org/module-runtime").ModuleViewDefinition<{
+        limit: number;
+        equals?: Record<string, unknown> | undefined;
+    }, readonly import("@molda-org/module-runtime").ModuleRecord<Record<string, unknown>>[]>;
+}>;
+export declare function createWorkflowActionsAuditService(repository: ModuleRepository): {
+    blueprint: import("@molda-org/module-runtime").ModuleBlueprint<{
+        [k: string]: import("@molda-org/module-runtime").ModuleActionDefinition<{
+            id: string;
+            data: Record<string, unknown>;
+        }, import("@molda-org/module-runtime").ModuleRecord<Readonly<Record<string, unknown>>>> | import("@molda-org/module-runtime").ModuleActionDefinition<{
+            data: Record<string, unknown>;
+        }, import("@molda-org/module-runtime").ModuleRecord<Readonly<Record<string, unknown>>>> | import("@molda-org/module-runtime").ModuleActionDefinition<{
+            id: string;
+            expectedRevision: number;
+            patch: Record<string, unknown>;
+            reason?: string | undefined;
+        }, import("@molda-org/module-runtime").ModuleRecord<Readonly<Record<string, unknown>>>> | import("@molda-org/module-runtime").ModuleActionDefinition<{
+            id: string;
+            expectedRevision: number;
+            patch: Record<string, unknown>;
+        }, import("@molda-org/module-runtime").ModuleRecord<Readonly<Record<string, unknown>>>>;
+    }, {
+        [k: string]: import("@molda-org/module-runtime").ModuleViewDefinition<{
+            id: string;
+        }, import("@molda-org/module-runtime").ModuleRecord<Readonly<Record<string, unknown>>>> | import("@molda-org/module-runtime").ModuleViewDefinition<{
+            limit: number;
+            equals?: Record<string, unknown> | undefined;
+        }, readonly import("@molda-org/module-runtime").ModuleRecord<Record<string, unknown>>[]>;
+    }>;
+    executeAction<TKey extends string>(actionId: TKey, unsafeInput: {
+        id: string;
+        data: Record<string, unknown>;
+    } | {
+        data: Record<string, unknown>;
+    } | {
+        id: string;
+        expectedRevision: number;
+        patch: Record<string, unknown>;
+        reason?: string | undefined;
+    } | {
+        id: string;
+        expectedRevision: number;
+        patch: Record<string, unknown>;
+    }, invocation: import("@molda-org/module-runtime").ModuleActionInvocation): Promise<import("@molda-org/module-runtime").ModuleActionExecution<never>>;
+    executeView<TKey extends string>(viewId: TKey, unsafeInput: {
+        id: string;
+    } | {
+        limit: number;
+        equals?: Record<string, unknown> | undefined;
+    }, context: import("@molda-org/module-runtime").ModuleExecutionContext): Promise<never>;
+};
+export declare function createWorkflowActionsAuditRuntimeModule(repository: ModuleRepository): import("@molda-org/module-runtime").ResourceModuleContribution;

package/dist/index.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { createResourceModuleContribution, createResourceModuleService, defineResourceModule, } from '@molda-org/module-runtime';
+export const WorkflowActionsAuditActionIds = ["executeWorkflowAction", "approveWorkflowAction", "compensateWorkflowAction"];
+export const WorkflowActionsAuditViewIds = ["workflowHistory", "actionAuditLog", "pendingApprovals"];
+export const WorkflowActionsAuditHookIds = ["useWorkflowHistory", "useActionAuditLog", "usePendingApprovals"];
+export const WorkflowActionsAuditSpecification = {
+    id: 'workflow-actions-audit',
+    version: '1.0.0',
+    collections: {
+        'workflow-actions': z.object({ type: z.string().min(1).max(160), status: z.enum(['pending-approval', 'approved', 'completed', 'failed', 'compensated']), payload: z.record(z.string(), z.unknown()), transitionReason: z.string().max(1_000).optional() }).strict(),
+        'action-audit': z.object({ actionId: z.string().min(1).max(200), actorId: z.string().min(1).max(200), outcome: z.string().min(1).max(120), occurredAt: z.string().datetime({ offset: true }) }).strict(),
+    },
+    actions: {
+        executeWorkflowAction: { kind: 'create', collection: 'workflow-actions', permission: 'execute.workflow.action', event: 'execute.workflow.action' },
+        approveWorkflowAction: { kind: 'transition', collection: 'workflow-actions', permission: 'approve.workflow.action', event: 'approve.workflow.action', status: 'approved', allowedFrom: ["pending-approval"], confirmation: 'required' },
+        compensateWorkflowAction: { kind: 'transition', collection: 'workflow-actions', permission: 'compensate.workflow.action', event: 'compensate.workflow.action', status: 'compensated', allowedFrom: ["completed", "failed"], confirmation: 'required' },
+    },
+    views: {
+        workflowHistory: { kind: 'list', collection: 'workflow-actions', permission: 'workflow.history.read' },
+        actionAuditLog: { kind: 'list', collection: 'action-audit', permission: 'action.audit.log.read' },
+        pendingApprovals: { kind: 'list', collection: 'workflow-actions', permission: 'pending.approvals.read', where: { status: 'pending-approval' } },
+    },
+    migrations: [{ version: 1, description: 'Create workflow-actions-audit collections and indexes' }],
+    fixtures: [{ id: 'workflow-actions-audit-baseline', description: 'Deterministic workflow-actions-audit production-case fixture', records: [
+                { collection: 'workflow-actions', id: 'workflow-fixture', value: { type: 'fixture.review', status: 'pending-approval', payload: { source: 'fixture' } } },
+            ] }],
+};
+export const WorkflowActionsAuditBlueprint = defineResourceModule(WorkflowActionsAuditSpecification);
+export function createWorkflowActionsAuditService(repository) {
+    return createResourceModuleService(WorkflowActionsAuditSpecification, repository);
+}
+export function createWorkflowActionsAuditRuntimeModule(repository) {
+    return createResourceModuleContribution(WorkflowActionsAuditSpecification, repository);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,18 +1,29 @@
 {
   "name": "@molda-org/workflow-actions-audit",
-  "version": "0.1.0-next.2",
+  "version": "0.1.0-next.21",
   "type": "module",
-  "types": "./index.d.ts",
   "exports": {
     ".": {
-      "types": "./index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
   "files": [
-    "index.d.ts"
+    "dist"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
   "dependencies": {
-    "@molda-org/module-contracts": "0.1.0-next.2"
+    "@molda-org/module-contracts": "0.1.0-next.21",
+    "@molda-org/module-runtime": "0.1.0-next.21",
+    "zod": "4.6.5"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.19",
+    "typescript": "5.9.3"
   },
   "publishConfig": {
     "access": "public",

package/index.d.ts

@@ -1,20 +0,0 @@
-import type { MoldaModuleDefinition, MoldaModuleShape } from '@molda-org/module-contracts';
-
-export type WorkflowActionsAuditAction = 'executeWorkflowAction' | 'approveWorkflowAction' | 'compensateWorkflowAction';
-export type WorkflowActionsAuditView = 'workflowHistory' | 'actionAuditLog' | 'pendingApprovals';
-export type WorkflowActionsAuditHook = 'useExecuteAction' | 'useActionAudit';
-
-export interface WorkflowActionsAuditModuleShape
-  extends MoldaModuleShape<
-    'workflow-actions-audit',
-    WorkflowActionsAuditAction,
-    WorkflowActionsAuditView,
-    WorkflowActionsAuditHook
-  > {
-  readonly stage: 'initial';
-  readonly category: 'platform-core';
-  readonly purpose: 'State transitions, deterministic actions, approvals, idempotency, audit, and compensation.';
-}
-
-export type WorkflowActionsAuditModule = MoldaModuleDefinition<WorkflowActionsAuditModuleShape>;
-