@lumenflow/control-plane-sdk 4.24.0 → 5.0.1

package/dist/wu-events.js

@@ -0,0 +1,109 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Apache-2.0 mirror of @lumenflow/core's WU event schema (ADR-011 §1).
+ *
+ * lumenflow-cloud is proprietary and cannot link AGPL code; the canonical
+ * WUEvent schema in @lumenflow/core/wu-state-schema.ts (AGPL-3.0-only) is
+ * mirrored here — not re-exported — so the Apache-2.0 SDK does not drag an
+ * AGPL dependency into the cloud's closure. Shape must stay byte-identical;
+ * a conformance test in WU-2638 keeps the two copies in sync.
+ */
+import { z } from 'zod';
+/**
+ * WU event type literals mirrored from @lumenflow/core/wu-state-schema.ts.
+ */
+export const WU_EVENT_TYPES = [
+    'create',
+    'claim',
+    'block',
+    'unblock',
+    'complete',
+    'checkpoint',
+    'delegation',
+    'release',
+    'wu_renamed',
+];
+const WU_ID_PATTERN = /^WU-\d+$/;
+const ERROR_MESSAGES = {
+    EVENT_TYPE: `Event type must be one of: ${WU_EVENT_TYPES.join(', ')}`,
+    WU_ID: 'WU ID must match pattern WU-XXX (e.g., WU-2637)',
+    LANE_REQUIRED: 'Lane is required',
+    TITLE_REQUIRED: 'Title is required',
+    REASON_REQUIRED: 'Reason is required',
+    TIMESTAMP_REQUIRED: 'Timestamp is required',
+    CHECKPOINT_NOTE_REQUIRED: 'Checkpoint note is required',
+    DELEGATION_PARENT_REQUIRED: 'Parent WU ID must match pattern WU-XXX',
+    DELEGATION_ID_REQUIRED: 'Delegation ID is required',
+};
+const BaseEventSchema = z.object({
+    type: z.enum(WU_EVENT_TYPES, { error: ERROR_MESSAGES.EVENT_TYPE }),
+    wuId: z.string().regex(WU_ID_PATTERN, { message: ERROR_MESSAGES.WU_ID }),
+    timestamp: z.string().datetime({ message: ERROR_MESSAGES.TIMESTAMP_REQUIRED }),
+});
+export const CreateEventSchema = BaseEventSchema.extend({
+    type: z.literal('create'),
+    lane: z.string().min(1, { message: ERROR_MESSAGES.LANE_REQUIRED }),
+    title: z.string().min(1, { message: ERROR_MESSAGES.TITLE_REQUIRED }),
+});
+export const ClaimEventSchema = BaseEventSchema.extend({
+    type: z.literal('claim'),
+    lane: z.string().min(1, { message: ERROR_MESSAGES.LANE_REQUIRED }),
+    title: z.string().min(1, { message: ERROR_MESSAGES.TITLE_REQUIRED }),
+});
+export const BlockEventSchema = BaseEventSchema.extend({
+    type: z.literal('block'),
+    reason: z.string().min(1, { message: ERROR_MESSAGES.REASON_REQUIRED }),
+});
+export const UnblockEventSchema = BaseEventSchema.extend({
+    type: z.literal('unblock'),
+});
+export const CompleteEventSchema = BaseEventSchema.extend({
+    type: z.literal('complete'),
+});
+export const CheckpointEventSchema = BaseEventSchema.extend({
+    type: z.literal('checkpoint'),
+    note: z.string().min(1, { message: ERROR_MESSAGES.CHECKPOINT_NOTE_REQUIRED }),
+    sessionId: z.string().optional(),
+    progress: z.string().optional(),
+    nextSteps: z.string().optional(),
+});
+export const DelegationEventSchema = BaseEventSchema.extend({
+    type: z.literal('delegation'),
+    parentWuId: z
+        .string()
+        .regex(WU_ID_PATTERN, { message: ERROR_MESSAGES.DELEGATION_PARENT_REQUIRED }),
+    delegationId: z.string().min(1, { message: ERROR_MESSAGES.DELEGATION_ID_REQUIRED }),
+});
+export const ReleaseEventSchema = BaseEventSchema.extend({
+    type: z.literal('release'),
+    reason: z.string().min(1, { message: ERROR_MESSAGES.REASON_REQUIRED }),
+});
+export const WURenamedEventSchema = BaseEventSchema.extend({
+    type: z.literal('wu_renamed'),
+    from: z.string().regex(WU_ID_PATTERN, { message: ERROR_MESSAGES.WU_ID }),
+    to: z.string().regex(WU_ID_PATTERN, { message: ERROR_MESSAGES.WU_ID }),
+    reason: z.string().optional(),
+});
+export const WUEventSchema = z.discriminatedUnion('type', [
+    CreateEventSchema,
+    ClaimEventSchema,
+    BlockEventSchema,
+    UnblockEventSchema,
+    CompleteEventSchema,
+    CheckpointEventSchema,
+    DelegationEventSchema,
+    ReleaseEventSchema,
+    WURenamedEventSchema,
+]);
+/**
+ * Validates WU event data against the mirrored WUEventSchema.
+ *
+ * Cloud consumers should prefer this over ad-hoc parsing so that schema drift
+ * between @lumenflow/core and @lumenflow/control-plane-sdk surfaces as an
+ * explicit validation failure rather than silent data loss.
+ */
+export function validateWUEvent(data) {
+    return WUEventSchema.safeParse(data);
+}
+//# sourceMappingURL=wu-events.js.map

package/dist/wu-events.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/control-plane-sdk",
-  "version": "4.24.0",
+  "version": "5.0.1",
   "description": "Control plane sync contracts and adapters for LumenFlow runtime",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,6 +10,9 @@
     "LICENSE",
     "README.md"
   ],
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",
     "typescript": "^5.9.3",