@lssm/example.workflow-system 0.0.0-canary-20251217083314 → 0.0.0-canary-20251219202229

package/dist/instance/instance.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.handler.js","names":["instance: WorkflowInstanceRecord","state: StateMachineState","transitionContext: TransitionContext"],"sources":["../../src/instance/instance.handler.ts"],"sourcesContent":["/**\n * Workflow instance handlers.\n */\n\nimport type { StateMachineState, TransitionContext } from '../state-machine';\nimport {\n  createStateMachineEngine,\n  buildStateMachineDefinition,\n} from '../state-machine';\nimport type { WorkflowInstanceRecord, HandlerContext } from '../shared/types';\nimport { mockDataStore } from '../shared/mock-data';\nimport { createApprovalRequests } from '../approval/approval.handler';\n\nexport async function handleStartWorkflow(\n  input: {\n    workflowKey: string;\n    contextData?: Record<string, unknown>;\n    referenceId?: string;\n    referenceType?: string;\n    priority?: number;\n    dueAt?: Date;\n  },\n  context: HandlerContext\n): Promise<WorkflowInstanceRecord> {\n  // Find active workflow by key\n  const workflow = Array.from(mockDataStore.workflows.values()).find(\n    (w) =>\n      w.key === input.workflowKey &&\n      w.status === 'ACTIVE' &&\n      w.organizationId === context.organizationId\n  );\n\n  if (!workflow) {\n    throw new Error(`Active workflow ${input.workflowKey} not found`);\n  }\n\n  const id = `inst_${Date.now()}`;\n  const now = new Date();\n\n  const instance: WorkflowInstanceRecord = {\n    id,\n    workflowDefinitionId: workflow.id,\n    referenceId: input.referenceId,\n    referenceType: input.referenceType,\n    status: 'RUNNING',\n    currentStepId: workflow.initialStepId,\n    contextData: input.contextData ?? {},\n    triggeredBy: context.userId,\n    organizationId: context.organizationId,\n    priority: input.priority ?? 0,\n    dueAt: input.dueAt,\n    createdAt: now,\n    updatedAt: now,\n    startedAt: now,\n  };\n\n  mockDataStore.instances.set(id, instance);\n\n  // Check if first step is an approval step\n  if (workflow.initialStepId) {\n    const firstStep = mockDataStore.steps.get(workflow.initialStepId);\n    if (firstStep?.type === 'APPROVAL') {\n      instance.status = 'WAITING';\n      await createApprovalRequests(instance, firstStep, context);\n    }\n  }\n\n  return instance;\n}\n\nexport async function handleTransitionWorkflow(\n  input: {\n    instanceId: string;\n    action: string;\n    data?: Record<string, unknown>;\n    comment?: string;\n  },\n  context: HandlerContext\n): Promise<{\n  success: boolean;\n  instance: WorkflowInstanceRecord;\n  previousStepKey?: string;\n  currentStepKey?: string;\n  message?: string;\n}> {\n  const instance = mockDataStore.instances.get(input.instanceId);\n  if (!instance) {\n    throw new Error(`Instance ${input.instanceId} not found`);\n  }\n\n  const workflow = mockDataStore.workflows.get(instance.workflowDefinitionId);\n  if (!workflow) {\n    throw new Error(`Workflow ${instance.workflowDefinitionId} not found`);\n  }\n\n  // Get all steps for this workflow\n  const steps = Array.from(mockDataStore.steps.values()).filter(\n    (s) => s.workflowDefinitionId === workflow.id\n  );\n\n  // Build state machine\n  const definition = buildStateMachineDefinition(\n    {\n      key: workflow.key,\n      name: workflow.name,\n      version: workflow.version,\n      initialStepId: workflow.initialStepId ?? null,\n    },\n    steps\n  );\n  const currentStep = steps.find((s) => s.id === instance.currentStepId);\n\n  const state: StateMachineState = {\n    currentStepKey: currentStep?.key ?? '',\n    status: instance.status,\n    contextData: instance.contextData,\n    history: [],\n  };\n\n  const transitionContext: TransitionContext = {\n    userId: context.userId,\n    userRoles: context.userRoles,\n    data: input.data,\n  };\n\n  const engine = createStateMachineEngine();\n  const result = engine.transition(\n    definition,\n    state,\n    input.action,\n    transitionContext\n  );\n\n  if (!result.success) {\n    return {\n      success: false,\n      instance,\n      message: result.error,\n    };\n  }\n\n  // Update instance\n  const previousStepKey = currentStep?.key;\n  const newStep = steps.find((s) => s.key === result.currentStepKey);\n\n  instance.currentStepId = newStep?.id;\n  instance.status = result.status;\n  instance.contextData = { ...instance.contextData, ...input.data };\n  instance.updatedAt = new Date();\n\n  if (result.status === 'COMPLETED') {\n    instance.completedAt = new Date();\n    instance.outcome = input.action;\n  }\n\n  // Handle approval steps\n  if (newStep?.type === 'APPROVAL') {\n    instance.status = 'WAITING';\n    await createApprovalRequests(instance, newStep, context);\n  }\n\n  return {\n    success: true,\n    instance,\n    previousStepKey,\n    currentStepKey: result.currentStepKey ?? undefined,\n  };\n}\n"],"mappings":";;;;;AAaA,eAAsB,oBACpB,OAQA,SACiC;CAEjC,MAAM,WAAW,MAAM,KAAK,cAAc,UAAU,QAAQ,CAAC,CAAC,MAC3D,MACC,EAAE,QAAQ,MAAM,eAChB,EAAE,WAAW,YACb,EAAE,mBAAmB,QAAQ,eAChC;AAED,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,mBAAmB,MAAM,YAAY,YAAY;CAGnE,MAAM,KAAK,QAAQ,KAAK,KAAK;CAC7B,MAAM,sBAAM,IAAI,MAAM;CAEtB,MAAMA,WAAmC;EACvC;EACA,sBAAsB,SAAS;EAC/B,aAAa,MAAM;EACnB,eAAe,MAAM;EACrB,QAAQ;EACR,eAAe,SAAS;EACxB,aAAa,MAAM,eAAe,EAAE;EACpC,aAAa,QAAQ;EACrB,gBAAgB,QAAQ;EACxB,UAAU,MAAM,YAAY;EAC5B,OAAO,MAAM;EACb,WAAW;EACX,WAAW;EACX,WAAW;EACZ;AAED,eAAc,UAAU,IAAI,IAAI,SAAS;AAGzC,KAAI,SAAS,eAAe;EAC1B,MAAM,YAAY,cAAc,MAAM,IAAI,SAAS,cAAc;AACjE,MAAI,WAAW,SAAS,YAAY;AAClC,YAAS,SAAS;AAClB,SAAM,uBAAuB,UAAU,WAAW,QAAQ;;;AAI9D,QAAO;;AAGT,eAAsB,yBACpB,OAMA,SAOC;CACD,MAAM,WAAW,cAAc,UAAU,IAAI,MAAM,WAAW;AAC9D,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,YAAY,MAAM,WAAW,YAAY;CAG3D,MAAM,WAAW,cAAc,UAAU,IAAI,SAAS,qBAAqB;AAC3E,KAAI,CAAC,SACH,OAAM,IAAI,MAAM,YAAY,SAAS,qBAAqB,YAAY;CAIxE,MAAM,QAAQ,MAAM,KAAK,cAAc,MAAM,QAAQ,CAAC,CAAC,QACpD,MAAM,EAAE,yBAAyB,SAAS,GAC5C;CAGD,MAAM,aAAa,4BACjB;EACE,KAAK,SAAS;EACd,MAAM,SAAS;EACf,SAAS,SAAS;EAClB,eAAe,SAAS,iBAAiB;EAC1C,EACD,MACD;CACD,MAAM,cAAc,MAAM,MAAM,MAAM,EAAE,OAAO,SAAS,cAAc;CAEtE,MAAMC,QAA2B;EAC/B,gBAAgB,aAAa,OAAO;EACpC,QAAQ,SAAS;EACjB,aAAa,SAAS;EACtB,SAAS,EAAE;EACZ;CAED,MAAMC,oBAAuC;EAC3C,QAAQ,QAAQ;EAChB,WAAW,QAAQ;EACnB,MAAM,MAAM;EACb;CAGD,MAAM,SADS,0BAA0B,CACnB,WACpB,YACA,OACA,MAAM,QACN,kBACD;AAED,KAAI,CAAC,OAAO,QACV,QAAO;EACL,SAAS;EACT;EACA,SAAS,OAAO;EACjB;CAIH,MAAM,kBAAkB,aAAa;CACrC,MAAM,UAAU,MAAM,MAAM,MAAM,EAAE,QAAQ,OAAO,eAAe;AAElE,UAAS,gBAAgB,SAAS;AAClC,UAAS,SAAS,OAAO;AACzB,UAAS,cAAc;EAAE,GAAG,SAAS;EAAa,GAAG,MAAM;EAAM;AACjE,UAAS,4BAAY,IAAI,MAAM;AAE/B,KAAI,OAAO,WAAW,aAAa;AACjC,WAAS,8BAAc,IAAI,MAAM;AACjC,WAAS,UAAU,MAAM;;AAI3B,KAAI,SAAS,SAAS,YAAY;AAChC,WAAS,SAAS;AAClB,QAAM,uBAAuB,UAAU,SAAS,QAAQ;;AAG1D,QAAO;EACL,SAAS;EACT;EACA;EACA,gBAAgB,OAAO,kBAAkB;EAC1C"}

package/dist/instance/instance.schema.d.ts

@@ -1,222 +1,223 @@
-import * as _lssm_lib_schema340 from "@lssm/lib.schema";
+import * as _lssm_lib_schema0 from "@lssm/lib.schema";
 
 //#region src/instance/instance.schema.d.ts
 /**
  * A running workflow instance.
  */
-declare const WorkflowInstanceModel: _lssm_lib_schema340.SchemaModel<{
+declare const WorkflowInstanceModel: _lssm_lib_schema0.SchemaModel<{
   id: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   workflowDefinitionId: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   referenceId: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   referenceType: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   status: {
-    type: _lssm_lib_schema340.EnumType<[string, string, string, string, string, string, string, string]>;
+    type: _lssm_lib_schema0.EnumType<[string, string, string, string, string, string, string, string]>;
     isOptional: false;
   };
   currentStepId: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   contextData: {
-    type: _lssm_lib_schema340.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema0.FieldType<unknown, unknown>;
     isOptional: true;
   };
   triggeredBy: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   organizationId: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   priority: {
-    type: _lssm_lib_schema340.FieldType<number, number>;
+    type: _lssm_lib_schema0.FieldType<number, number>;
     isOptional: false;
   };
   dueAt: {
-    type: _lssm_lib_schema340.FieldType<Date, string>;
+    type: _lssm_lib_schema0.FieldType<Date, string>;
     isOptional: true;
   };
   outcome: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   resultData: {
-    type: _lssm_lib_schema340.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema0.FieldType<unknown, unknown>;
     isOptional: true;
   };
   errorMessage: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   createdAt: {
-    type: _lssm_lib_schema340.FieldType<Date, string>;
+    type: _lssm_lib_schema0.FieldType<Date, string>;
     isOptional: false;
   };
   startedAt: {
-    type: _lssm_lib_schema340.FieldType<Date, string>;
+    type: _lssm_lib_schema0.FieldType<Date, string>;
     isOptional: true;
   };
   completedAt: {
-    type: _lssm_lib_schema340.FieldType<Date, string>;
+    type: _lssm_lib_schema0.FieldType<Date, string>;
     isOptional: true;
   };
 }>;
 /**
  * Input for starting a workflow.
  */
-declare const StartWorkflowInputModel: _lssm_lib_schema340.SchemaModel<{
+declare const StartWorkflowInputModel: _lssm_lib_schema0.SchemaModel<{
   workflowKey: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   contextData: {
-    type: _lssm_lib_schema340.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema0.FieldType<unknown, unknown>;
     isOptional: true;
   };
   referenceId: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   referenceType: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   priority: {
-    type: _lssm_lib_schema340.FieldType<number, number>;
+    type: _lssm_lib_schema0.FieldType<number, number>;
     isOptional: true;
   };
   dueAt: {
-    type: _lssm_lib_schema340.FieldType<Date, string>;
+    type: _lssm_lib_schema0.FieldType<Date, string>;
     isOptional: true;
   };
 }>;
 /**
  * Input for transitioning a workflow.
  */
-declare const TransitionInputModel: _lssm_lib_schema340.SchemaModel<{
+declare const TransitionInputModel: _lssm_lib_schema0.SchemaModel<{
   instanceId: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   action: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   data: {
-    type: _lssm_lib_schema340.FieldType<unknown, unknown>;
+    type: _lssm_lib_schema0.FieldType<unknown, unknown>;
     isOptional: true;
   };
   comment: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
 }>;
 /**
  * Result of a workflow transition.
  */
-declare const TransitionResultModel: _lssm_lib_schema340.SchemaModel<{
+declare const TransitionResultModel: _lssm_lib_schema0.SchemaModel<{
   success: {
-    type: _lssm_lib_schema340.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
     isOptional: false;
   };
   instance: {
-    type: _lssm_lib_schema340.SchemaModel<{
+    type: _lssm_lib_schema0.SchemaModel<{
       id: {
-        type: _lssm_lib_schema340.FieldType<string, string>;
+        type: _lssm_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       workflowDefinitionId: {
-        type: _lssm_lib_schema340.FieldType<string, string>;
+        type: _lssm_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       referenceId: {
-        type: _lssm_lib_schema340.FieldType<string, string>;
+        type: _lssm_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       referenceType: {
-        type: _lssm_lib_schema340.FieldType<string, string>;
+        type: _lssm_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       status: {
-        type: _lssm_lib_schema340.EnumType<[string, string, string, string, string, string, string, string]>;
+        type: _lssm_lib_schema0.EnumType<[string, string, string, string, string, string, string, string]>;
         isOptional: false;
       };
       currentStepId: {
-        type: _lssm_lib_schema340.FieldType<string, string>;
+        type: _lssm_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       contextData: {
-        type: _lssm_lib_schema340.FieldType<unknown, unknown>;
+        type: _lssm_lib_schema0.FieldType<unknown, unknown>;
         isOptional: true;
       };
       triggeredBy: {
-        type: _lssm_lib_schema340.FieldType<string, string>;
+        type: _lssm_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       organizationId: {
-        type: _lssm_lib_schema340.FieldType<string, string>;
+        type: _lssm_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       priority: {
-        type: _lssm_lib_schema340.FieldType<number, number>;
+        type: _lssm_lib_schema0.FieldType<number, number>;
         isOptional: false;
       };
       dueAt: {
-        type: _lssm_lib_schema340.FieldType<Date, string>;
+        type: _lssm_lib_schema0.FieldType<Date, string>;
         isOptional: true;
       };
       outcome: {
-        type: _lssm_lib_schema340.FieldType<string, string>;
+        type: _lssm_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       resultData: {
-        type: _lssm_lib_schema340.FieldType<unknown, unknown>;
+        type: _lssm_lib_schema0.FieldType<unknown, unknown>;
         isOptional: true;
       };
       errorMessage: {
-        type: _lssm_lib_schema340.FieldType<string, string>;
+        type: _lssm_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       createdAt: {
-        type: _lssm_lib_schema340.FieldType<Date, string>;
+        type: _lssm_lib_schema0.FieldType<Date, string>;
         isOptional: false;
       };
       startedAt: {
-        type: _lssm_lib_schema340.FieldType<Date, string>;
+        type: _lssm_lib_schema0.FieldType<Date, string>;
         isOptional: true;
       };
       completedAt: {
-        type: _lssm_lib_schema340.FieldType<Date, string>;
+        type: _lssm_lib_schema0.FieldType<Date, string>;
         isOptional: true;
       };
     }>;
     isOptional: false;
   };
   previousStepKey: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   currentStepKey: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   message: {
-    type: _lssm_lib_schema340.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
 }>;
 //#endregion
-export { StartWorkflowInputModel, TransitionInputModel, TransitionResultModel, WorkflowInstanceModel };
+export { StartWorkflowInputModel, TransitionInputModel, TransitionResultModel, WorkflowInstanceModel };
+//# sourceMappingURL=instance.schema.d.ts.map

package/dist/instance/instance.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.schema.d.ts","names":[],"sources":["../../src/instance/instance.schema.ts"],"sourcesContent":[],"mappings":";;;;;;AAMa,cAAA,qBAqCX,oBArCgC,WAqChC,CAAA;EAAA,EAAA,EAAA;UAAA,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;;qCArCgC,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,IAAA;EA0CrB,CAAA;EAcX,WAAA,EAAA;;;;;;;;EAdkC,cAAA,EAAA;IAmBvB,IAAA,6BASX,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;gBAT+B,KAAA;EAAA,CAAA;EAcpB,KAAA,EAAA;IAgBX,IAAA,6BAAA,KAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;CAhBgC,CAAA;;;;cAjCrB,2CAAuB;;UAclC,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;cAKW,wCAAoB;;UAS/B,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;cAKW,yCAAqB;;UAgBhC,iBAAA,CAAA"}

package/dist/instance/instance.schema.js

@@ -1,30 +1,28 @@
-import { ScalarTypeEnum } from "../libs/schema/dist/ScalarTypeEnum.js";
-import { defineSchemaModel } from "../libs/schema/dist/SchemaModel.js";
-import "../libs/schema/dist/index.js";
+import { E5, K5 } from "../libs/schema/dist/index.js";
 import { InstanceStatusEnum } from "./instance.enum.js";
 
 //#region src/instance/instance.schema.ts
 /**
 * A running workflow instance.
 */
-const WorkflowInstanceModel = defineSchemaModel({
+const WorkflowInstanceModel = K5({
 	name: "WorkflowInstanceModel",
 	description: "A running workflow instance",
 	fields: {
 		id: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		workflowDefinitionId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		referenceId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		referenceType: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		status: {
@@ -32,51 +30,51 @@ const WorkflowInstanceModel = defineSchemaModel({
 			isOptional: false
 		},
 		currentStepId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		contextData: {
-			type: ScalarTypeEnum.JSON(),
+			type: E5.JSON(),
 			isOptional: true
 		},
 		triggeredBy: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		organizationId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		priority: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: E5.Int_unsecure(),
 			isOptional: false
 		},
 		dueAt: {
-			type: ScalarTypeEnum.DateTime(),
+			type: E5.DateTime(),
 			isOptional: true
 		},
 		outcome: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		resultData: {
-			type: ScalarTypeEnum.JSON(),
+			type: E5.JSON(),
 			isOptional: true
 		},
 		errorMessage: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		createdAt: {
-			type: ScalarTypeEnum.DateTime(),
+			type: E5.DateTime(),
 			isOptional: false
 		},
 		startedAt: {
-			type: ScalarTypeEnum.DateTime(),
+			type: E5.DateTime(),
 			isOptional: true
 		},
 		completedAt: {
-			type: ScalarTypeEnum.DateTime(),
+			type: E5.DateTime(),
 			isOptional: true
 		}
 	}
@@ -84,32 +82,32 @@ const WorkflowInstanceModel = defineSchemaModel({
 /**
 * Input for starting a workflow.
 */
-const StartWorkflowInputModel = defineSchemaModel({
+const StartWorkflowInputModel = K5({
 	name: "StartWorkflowInput",
 	description: "Input for starting a workflow",
 	fields: {
 		workflowKey: {
-			type: ScalarTypeEnum.NonEmptyString(),
+			type: E5.NonEmptyString(),
 			isOptional: false
 		},
 		contextData: {
-			type: ScalarTypeEnum.JSON(),
+			type: E5.JSON(),
 			isOptional: true
 		},
 		referenceId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		referenceType: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		priority: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: E5.Int_unsecure(),
 			isOptional: true
 		},
 		dueAt: {
-			type: ScalarTypeEnum.DateTime(),
+			type: E5.DateTime(),
 			isOptional: true
 		}
 	}
@@ -117,24 +115,24 @@ const StartWorkflowInputModel = defineSchemaModel({
 /**
 * Input for transitioning a workflow.
 */
-const TransitionInputModel = defineSchemaModel({
+const TransitionInputModel = K5({
 	name: "TransitionInput",
 	description: "Input for transitioning a workflow",
 	fields: {
 		instanceId: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: false
 		},
 		action: {
-			type: ScalarTypeEnum.NonEmptyString(),
+			type: E5.NonEmptyString(),
 			isOptional: false
 		},
 		data: {
-			type: ScalarTypeEnum.JSON(),
+			type: E5.JSON(),
 			isOptional: true
 		},
 		comment: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		}
 	}
@@ -142,12 +140,12 @@ const TransitionInputModel = defineSchemaModel({
 /**
 * Result of a workflow transition.
 */
-const TransitionResultModel = defineSchemaModel({
+const TransitionResultModel = K5({
 	name: "TransitionResult",
 	description: "Result of a workflow transition",
 	fields: {
 		success: {
-			type: ScalarTypeEnum.Boolean(),
+			type: E5.Boolean(),
 			isOptional: false
 		},
 		instance: {
@@ -155,19 +153,20 @@ const TransitionResultModel = defineSchemaModel({
 			isOptional: false
 		},
 		previousStepKey: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		currentStepKey: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		},
 		message: {
-			type: ScalarTypeEnum.String_unsecure(),
+			type: E5.String_unsecure(),
 			isOptional: true
 		}
 	}
 });
 
 //#endregion
-export { StartWorkflowInputModel, TransitionInputModel, TransitionResultModel, WorkflowInstanceModel };
+export { StartWorkflowInputModel, TransitionInputModel, TransitionResultModel, WorkflowInstanceModel };
+//# sourceMappingURL=instance.schema.js.map

package/dist/instance/instance.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.schema.js","names":["defineSchemaModel","ScalarTypeEnum"],"sources":["../../src/instance/instance.schema.ts"],"sourcesContent":["import { defineSchemaModel, ScalarTypeEnum } from '@lssm/lib.schema';\nimport { InstanceStatusEnum } from './instance.enum';\n\n/**\n * A running workflow instance.\n */\nexport const WorkflowInstanceModel = defineSchemaModel({\n  name: 'WorkflowInstanceModel',\n  description: 'A running workflow instance',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    workflowDefinitionId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    referenceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    referenceType: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    status: { type: InstanceStatusEnum, isOptional: false },\n    currentStepId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    contextData: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    triggeredBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    organizationId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    priority: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    dueAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    outcome: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    resultData: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    errorMessage: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n    startedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n    completedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n  },\n});\n\n/**\n * Input for starting a workflow.\n */\nexport const StartWorkflowInputModel = defineSchemaModel({\n  name: 'StartWorkflowInput',\n  description: 'Input for starting a workflow',\n  fields: {\n    workflowKey: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    contextData: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    referenceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    referenceType: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    priority: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    dueAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n  },\n});\n\n/**\n * Input for transitioning a workflow.\n */\nexport const TransitionInputModel = defineSchemaModel({\n  name: 'TransitionInput',\n  description: 'Input for transitioning a workflow',\n  fields: {\n    instanceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    action: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    data: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    comment: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\n/**\n * Result of a workflow transition.\n */\nexport const TransitionResultModel = defineSchemaModel({\n  name: 'TransitionResult',\n  description: 'Result of a workflow transition',\n  fields: {\n    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    instance: { type: WorkflowInstanceModel, isOptional: false },\n    previousStepKey: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    currentStepKey: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    message: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n"],"mappings":";;;;;;;AAMA,MAAa,wBAAwBA,GAAkB;CACrD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,IAAI;GAAE,MAAMC,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACjE,sBAAsB;GACpB,MAAMA,GAAe,iBAAiB;GACtC,YAAY;GACb;EACD,aAAa;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACzE,eAAe;GACb,MAAMA,GAAe,iBAAiB;GACtC,YAAY;GACb;EACD,QAAQ;GAAE,MAAM;GAAoB,YAAY;GAAO;EACvD,eAAe;GACb,MAAMA,GAAe,iBAAiB;GACtC,YAAY;GACb;EACD,aAAa;GAAE,MAAMA,GAAe,MAAM;GAAE,YAAY;GAAM;EAC9D,aAAa;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAO;EAC1E,gBAAgB;GACd,MAAMA,GAAe,iBAAiB;GACtC,YAAY;GACb;EACD,UAAU;GAAE,MAAMA,GAAe,cAAc;GAAE,YAAY;GAAO;EACpE,OAAO;GAAE,MAAMA,GAAe,UAAU;GAAE,YAAY;GAAM;EAC5D,SAAS;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACrE,YAAY;GAAE,MAAMA,GAAe,MAAM;GAAE,YAAY;GAAM;EAC7D,cAAc;GACZ,MAAMA,GAAe,iBAAiB;GACtC,YAAY;GACb;EACD,WAAW;GAAE,MAAMA,GAAe,UAAU;GAAE,YAAY;GAAO;EACjE,WAAW;GAAE,MAAMA,GAAe,UAAU;GAAE,YAAY;GAAM;EAChE,aAAa;GAAE,MAAMA,GAAe,UAAU;GAAE,YAAY;GAAM;EACnE;CACF,CAAC;;;;AAKF,MAAa,0BAA0BD,GAAkB;CACvD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,aAAa;GAAE,MAAMC,GAAe,gBAAgB;GAAE,YAAY;GAAO;EACzE,aAAa;GAAE,MAAMA,GAAe,MAAM;GAAE,YAAY;GAAM;EAC9D,aAAa;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACzE,eAAe;GACb,MAAMA,GAAe,iBAAiB;GACtC,YAAY;GACb;EACD,UAAU;GAAE,MAAMA,GAAe,cAAc;GAAE,YAAY;GAAM;EACnE,OAAO;GAAE,MAAMA,GAAe,UAAU;GAAE,YAAY;GAAM;EAC7D;CACF,CAAC;;;;AAKF,MAAa,uBAAuBD,GAAkB;CACpD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,YAAY;GAAE,MAAMC,GAAe,iBAAiB;GAAE,YAAY;GAAO;EACzE,QAAQ;GAAE,MAAMA,GAAe,gBAAgB;GAAE,YAAY;GAAO;EACpE,MAAM;GAAE,MAAMA,GAAe,MAAM;GAAE,YAAY;GAAM;EACvD,SAAS;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACtE;CACF,CAAC;;;;AAKF,MAAa,wBAAwBD,GAAkB;CACrD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,SAAS;GAAE,MAAMC,GAAe,SAAS;GAAE,YAAY;GAAO;EAC9D,UAAU;GAAE,MAAM;GAAuB,YAAY;GAAO;EAC5D,iBAAiB;GACf,MAAMA,GAAe,iBAAiB;GACtC,YAAY;GACb;EACD,gBAAgB;GACd,MAAMA,GAAe,iBAAiB;GACtC,YAAY;GACb;EACD,SAAS;GAAE,MAAMA,GAAe,iBAAiB;GAAE,YAAY;GAAM;EACtE;CACF,CAAC"}

package/dist/libs/contracts/dist/capabilities/openbanking.js

@@ -85,4 +85,5 @@ const openBankingBalancesReadCapability = {
 	}]
 };
 
-//#endregion
+//#endregion
+//# sourceMappingURL=openbanking.js.map

package/dist/libs/contracts/dist/capabilities/openbanking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openbanking.js","names":[],"sources":["../../../../../../../libs/contracts/dist/capabilities/openbanking.js"],"sourcesContent":["import { StabilityEnum } from \"../ownership.js\";\n\n//#region src/capabilities/openbanking.ts\nconst OWNERS = [\"platform.finance\"];\nconst TAGS = [\"open-banking\", \"finance\"];\nconst openBankingAccountsReadCapability = {\n\tmeta: {\n\t\tkey: \"openbanking.accounts.read\",\n\t\tversion: 1,\n\t\tkind: \"integration\",\n\t\ttitle: \"Open Banking Accounts (Read)\",\n\t\tdescription: \"Provides read-only access to linked bank accounts, including account summaries and metadata.\",\n\t\tdomain: \"finance\",\n\t\towners: [...OWNERS],\n\t\ttags: [...TAGS],\n\t\tstability: StabilityEnum.Experimental\n\t},\n\tprovides: [\n\t\t{\n\t\t\tsurface: \"operation\",\n\t\t\tname: \"openbanking.accounts.list\",\n\t\t\tversion: 1,\n\t\t\tdescription: \"List bank accounts linked to a Powens open banking connection.\"\n\t\t},\n\t\t{\n\t\t\tsurface: \"operation\",\n\t\t\tname: \"openbanking.accounts.get\",\n\t\t\tversion: 1,\n\t\t\tdescription: \"Retrieve the canonical bank account record for a specific account.\"\n\t\t},\n\t\t{\n\t\t\tsurface: \"operation\",\n\t\t\tname: \"openbanking.accounts.sync\",\n\t\t\tversion: 1,\n\t\t\tdescription: \"Trigger a refresh of bank account metadata from the open banking provider.\"\n\t\t}\n\t]\n};\nconst openBankingTransactionsReadCapability = {\n\tmeta: {\n\t\tkey: \"openbanking.transactions.read\",\n\t\tversion: 1,\n\t\tkind: \"integration\",\n\t\ttitle: \"Open Banking Transactions (Read)\",\n\t\tdescription: \"Enables retrieval of transaction history for linked bank accounts via open banking providers.\",\n\t\tdomain: \"finance\",\n\t\towners: [...OWNERS],\n\t\ttags: [...TAGS, \"transactions\"],\n\t\tstability: StabilityEnum.Experimental\n\t},\n\tprovides: [{\n\t\tsurface: \"operation\",\n\t\tname: \"openbanking.transactions.list\",\n\t\tversion: 1,\n\t\tdescription: \"List transactions for a given bank account with optional date filtering.\"\n\t}, {\n\t\tsurface: \"operation\",\n\t\tname: \"openbanking.transactions.sync\",\n\t\tversion: 1,\n\t\tdescription: \"Synchronise transactions from the open banking provider into the canonical ledger.\"\n\t}]\n};\nconst openBankingBalancesReadCapability = {\n\tmeta: {\n\t\tkey: \"openbanking.balances.read\",\n\t\tversion: 1,\n\t\tkind: \"integration\",\n\t\ttitle: \"Open Banking Balances (Read)\",\n\t\tdescription: \"Allows querying of current and available balances for linked bank accounts via open banking providers.\",\n\t\tdomain: \"finance\",\n\t\towners: [...OWNERS],\n\t\ttags: [...TAGS, \"balances\"],\n\t\tstability: StabilityEnum.Experimental\n\t},\n\tprovides: [{\n\t\tsurface: \"operation\",\n\t\tname: \"openbanking.balances.get\",\n\t\tversion: 1,\n\t\tdescription: \"Retrieve the latest known balances for a specified bank account.\"\n\t}, {\n\t\tsurface: \"operation\",\n\t\tname: \"openbanking.balances.refresh\",\n\t\tversion: 1,\n\t\tdescription: \"Force a balance refresh from the open banking provider.\"\n\t}]\n};\nfunction registerOpenBankingCapabilities(registry) {\n\treturn registry.register(openBankingAccountsReadCapability).register(openBankingTransactionsReadCapability).register(openBankingBalancesReadCapability);\n}\n\n//#endregion\nexport { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities };\n//# sourceMappingURL=openbanking.js.map"],"mappings":";;;AAGA,MAAM,SAAS,CAAC,mBAAmB;AACnC,MAAM,OAAO,CAAC,gBAAgB,UAAU;AACxC,MAAM,oCAAoC;CACzC,MAAM;EACL,KAAK;EACL,SAAS;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM,CAAC,GAAG,KAAK;EACf,WAAW,cAAc;EACzB;CACD,UAAU;EACT;GACC,SAAS;GACT,MAAM;GACN,SAAS;GACT,aAAa;GACb;EACD;GACC,SAAS;GACT,MAAM;GACN,SAAS;GACT,aAAa;GACb;EACD;GACC,SAAS;GACT,MAAM;GACN,SAAS;GACT,aAAa;GACb;EACD;CACD;AACD,MAAM,wCAAwC;CAC7C,MAAM;EACL,KAAK;EACL,SAAS;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM,CAAC,GAAG,MAAM,eAAe;EAC/B,WAAW,cAAc;EACzB;CACD,UAAU,CAAC;EACV,SAAS;EACT,MAAM;EACN,SAAS;EACT,aAAa;EACb,EAAE;EACF,SAAS;EACT,MAAM;EACN,SAAS;EACT,aAAa;EACb,CAAC;CACF;AACD,MAAM,oCAAoC;CACzC,MAAM;EACL,KAAK;EACL,SAAS;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM,CAAC,GAAG,MAAM,WAAW;EAC3B,WAAW,cAAc;EACzB;CACD,UAAU,CAAC;EACV,SAAS;EACT,MAAM;EACN,SAAS;EACT,aAAa;EACb,EAAE;EACF,SAAS;EACT,MAAM;EACN,SAAS;EACT,aAAa;EACb,CAAC;CACF"}

package/dist/libs/contracts/dist/contract-registry/schemas.js

@@ -57,4 +57,5 @@ const ContractRegistryManifestSchema = z.object({
 });
 
 //#endregion
-export { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema };
+export { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema };
+//# sourceMappingURL=schemas.js.map

package/dist/libs/contracts/dist/contract-registry/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","names":[],"sources":["../../../../../../../libs/contracts/dist/contract-registry/schemas.js"],"sourcesContent":["import { StabilityEnum } from \"../ownership.js\";\nimport z from \"zod\";\n\n//#region src/contract-registry/schemas.ts\nconst ContractRegistryItemTypeValues = [\n\t\"contractspec:operation\",\n\t\"contractspec:event\",\n\t\"contractspec:presentation\",\n\t\"contractspec:form\",\n\t\"contractspec:feature\",\n\t\"contractspec:workflow\",\n\t\"contractspec:template\",\n\t\"contractspec:integration\",\n\t\"contractspec:data-view\",\n\t\"contractspec:migration\",\n\t\"contractspec:telemetry\",\n\t\"contractspec:experiment\",\n\t\"contractspec:app-config\",\n\t\"contractspec:knowledge\"\n];\nconst ContractRegistryItemTypeSchema = z.enum(ContractRegistryItemTypeValues);\nconst ContractRegistryFileSchema = z.object({\n\tpath: z.string().min(1),\n\ttype: z.string().min(1),\n\tcontent: z.string().optional()\n});\nconst ContractRegistryItemSchema = z.object({\n\tname: z.string().min(1),\n\ttype: ContractRegistryItemTypeSchema,\n\tversion: z.number().int().nonnegative(),\n\ttitle: z.string().min(1),\n\tdescription: z.string().min(1),\n\tmeta: z.object({\n\t\tstability: z.enum([\n\t\t\tStabilityEnum.Idea,\n\t\t\tStabilityEnum.InCreation,\n\t\t\tStabilityEnum.Experimental,\n\t\t\tStabilityEnum.Beta,\n\t\t\tStabilityEnum.Stable,\n\t\t\tStabilityEnum.Deprecated\n\t\t]),\n\t\towners: z.array(z.string().min(1)).default([]),\n\t\ttags: z.array(z.string().min(1)).default([])\n\t}),\n\tdependencies: z.array(z.string().min(1)).optional(),\n\tregistryDependencies: z.array(z.string().min(1)).optional(),\n\tfiles: z.array(ContractRegistryFileSchema).min(1),\n\tschema: z.object({\n\t\tinput: z.unknown().optional(),\n\t\toutput: z.unknown().optional()\n\t}).optional()\n});\nconst ContractRegistryManifestSchema = z.object({\n\t$schema: z.string().min(1).optional(),\n\tname: z.string().min(1),\n\thomepage: z.string().min(1).optional(),\n\titems: z.array(ContractRegistryItemSchema)\n});\n\n//#endregion\nexport { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema };\n//# sourceMappingURL=schemas.js.map"],"mappings":";;;;AAoBA,MAAM,iCAAiC,EAAE,KAhBF;CACtC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAC4E;AAC7E,MAAM,6BAA6B,EAAE,OAAO;CAC3C,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,SAAS,EAAE,QAAQ,CAAC,UAAU;CAC9B,CAAC;AACF,MAAM,6BAA6B,EAAE,OAAO;CAC3C,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,MAAM;CACN,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;CACvC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE;CACxB,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE;CAC9B,MAAM,EAAE,OAAO;EACd,WAAW,EAAE,KAAK;GACjB,cAAc;GACd,cAAc;GACd,cAAc;GACd,cAAc;GACd,cAAc;GACd,cAAc;GACd,CAAC;EACF,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;EAC9C,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;EAC5C,CAAC;CACF,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU;CACnD,sBAAsB,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU;CAC3D,OAAO,EAAE,MAAM,2BAA2B,CAAC,IAAI,EAAE;CACjD,QAAQ,EAAE,OAAO;EAChB,OAAO,EAAE,SAAS,CAAC,UAAU;EAC7B,QAAQ,EAAE,SAAS,CAAC,UAAU;EAC9B,CAAC,CAAC,UAAU;CACb,CAAC;AACF,MAAM,iCAAiC,EAAE,OAAO;CAC/C,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU;CACrC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU;CACtC,OAAO,EAAE,MAAM,2BAA2B;CAC1C,CAAC"}

package/dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js

@@ -13,4 +13,5 @@ const accessibility_wcag_compliance_specs_DocBlocks = [{
 }];
 registerDocBlocks(accessibility_wcag_compliance_specs_DocBlocks);
 
-//#endregion
+//#endregion
+//# sourceMappingURL=accessibility_wcag_compliance_specs.docblock.js.map

package/dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility_wcag_compliance_specs.docblock.js","names":[],"sources":["../../../../../../../libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"./registry.js\";\n\n//#region src/docs/accessibility_wcag_compliance_specs.docblock.ts\nconst accessibility_wcag_compliance_specs_DocBlocks = [{\n\tid: \"docs.accessibility_wcag_compliance_specs\",\n\ttitle: \"Accessibility & WCAG Compliance — **specs.md**\",\n\tsummary: \"> **Goal:** Ship interfaces that are usable by everyone, by default. This spec sets non‑negotiable rules, checklists, and CI gates to meet **WCAG\\xA02.2 AA** (aim for AAA where low‑cost), align with **EN\\xA0301\\xA0549** (EU), and keep parity on **web (Next.js)** and **mobile (Expo/React\\xA0Native)**.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/accessibility_wcag_compliance_specs\",\n\ttags: [\"accessibility_wcag_compliance_specs\"],\n\tbody: \"# Accessibility & WCAG Compliance — **specs.md**\\n\\n> **Goal:** Ship interfaces that are usable by everyone, by default. This spec sets non‑negotiable rules, checklists, and CI gates to meet **WCAG\\xA02.2 AA** (aim for AAA where low‑cost), align with **EN\\xA0301\\xA0549** (EU), and keep parity on **web (Next.js)** and **mobile (Expo/React\\xA0Native)**.\\n\\n---\\n\\n## 0) Scope & Principles\\n\\n- **Standards:** WCAG\\xA02.2\\xA0AA (incl. new 2.2 SCs: Focus Not Obscured, Focus Appearance, Target Size, Dragging Movements, Accessible Authentication, Redundant Entry). EN\\xA0301\\xA0549 compliance by conformance to WCAG.\\n- **Principles:** Perceivable, Operable, Understandable, Robust (POUR).\\n- **Rule of ARIA:** “No ARIA is better than bad ARIA.” Prefer native elements.\\n- **Definition of Done (DoD):** No Critical/Major a11y issues in CI; keyboard complete; SR (screen reader) smoke test passed; contrasts pass; acceptance criteria below satisfied.\\n- **Repo Alignment:** Web apps use **Radix Primitives + shadcn** wrappers centralized in `packages/lssm/libs/ui-kit-web`. Prefer those components over per‑app duplicates (`packages/*/apps/*/src/components/ui`). When missing, add to `ui-kit-web` first, then adopt app‑side.\\n\\n---\\n\\n## 1) Design Requirements (Design System & Tokens)\\n\\n**1.1 Color & Contrast**\\n\\n- Body text, icons essential to meaning: **≥\\xA04.5:1**; large text (≥\\xA018.66px regular / 14px bold): **≥\\xA03:1**.\\n- Interactive states (default/hover/active/disabled/focus) must maintain contrast **≥\\xA03:1** against adjacent colors; text within components follows text ratios.\\n- Provide light & dark themes with tokens that guarantee minimums. **Never rely solely on color** to convey meaning; pair with text, shape, or icon.\\n\\n**1.2 Focus Indicators (WCAG\\xA02.4.11/12)**\\n\\n- Every interactive element has a **visible focus** with clear offset; indicator contrast **≥\\xA03:1** vs adjacent colors and indicator **area ≥\\xA02\\xA0CSS\\xA0px** thick.\\n- Focus **must not be obscured** by sticky headers/footers or scroll containers.\\n\\n**1.3 Motion & Preferences**\\n\\n- Respect `prefers-reduced-motion`: suppress large parallax, auto‑animations; provide instant alternatives.\\n- Avoid motion that could trigger vestibular issues; under PRM, use fade/scale under **150ms**.\\n\\n**1.4 Target Size (2.5.8)**\\n\\n- Hit areas **≥\\xA024×24\\xA0CSS\\xA0px** (web) and **≥\\xA044×44\\xA0dp** (mobile) unless exempt.\\n\\n**1.5 Typography & Layout**\\n\\n- Support zoom to **400%** without loss of content/functionality; responsive reflow at **320\\xA0CSS\\xA0px** width.\\n- Maintain clear heading hierarchy (h1…h6), one **h1** per view.\\n\\n- Repository baseline (Web): default body text uses Tailwind `text-lg` (≈18px). As of 2025‑09‑20, the repository bumped all Tailwind typography scale usages by +1 step (e.g., `text-sm`→`text-base`, `text-base`→`text-lg`, …, `text-8xl`→`text-9xl`). For long‑form content, default to `prose-lg`.\\n- Do not use `text-xs` for body copy. Reserve `text-sm` only for non‑essential meta (timestamps, fine print) while ensuring contrast and touch targets remain compliant.\\n- When increasing font size, ensure line height supports readability. Prefer Tailwind defaults or `leading-relaxed`/`leading-7` for body text where dense blocks appear.\\n\\n**1.6 Iconography & Imagery**\\n\\n- Decorative images: `alt=\\\"\\\"` or `aria-hidden=\\\"true\\\"`.\\n- Informative images: concise, specific **alt**; complex charts require a **data table or long description**.\\n\\n---\\n\\n## 2) Content Requirements (UX Writing)\\n\\n- Links say **what happens** (avoid “click here”).\\n- Buttons start with verbs; avoid ambiguous labels.\\n- Form labels are **visible**; placeholders are **not labels**.\\n- Error messages: human + programmatic association; avoid color‑only.\\n- Authentication: allow **copy/paste**, password managers, and avoid cognitive tests alone (**3.3.7/3.3.8/3.3.9**).\\n- Avoid CAPTCHAs that block users; if unavoidable, provide **multiple alternatives** (logic-free).\\n\\n---\\n\\n## 3) Engineering Requirements (Web — Next.js/React)\\n\\n> Use and extend `packages/lssm/libs/ui-kit-web` as the default UI surface. It wraps **Radix** primitives with sensible a11y defaults (focus rings, roles, keyboard, ARIA binding). When a gap exists, add it to `ui-kit-web` first.\\n\\n**3.1 Semantics & Landmarks**\\n\\n- Use native elements: `<button>`, `<a href>`, `<label for>`, `<fieldset>`, `<legend>`, `<table>`, etc.\\n- Landmarks per page: `header`, `nav`, `main`, `aside`, `footer`. Provide a **Skip to main content** link.\\n- Provide a **Route Announcer** (`aria-live=\\\"polite\\\"`) and move focus to page **h1** after navigation.\\n\\n**3.2 Keyboard**\\n\\n- All functionality available with keyboard alone. Tab order follows DOM/visual order; **no keyboard traps**.\\n- Common bindings:\\n  - Space/Enter → activate button; Enter on link;\\n  - Esc closes dialogs/menus;\\n  - Arrow keys for lists/menus/tablists with **roving tabindex**.\\n\\n**3.3 Focus Management**\\n\\n- On route change (Next.js), move focus to the page `<h1>` or container and announce via a live region.\\n- Dialogs/menus: **trap focus** inside; return focus to invoking control on close.\\n- Don’t steal focus except after explicit user action.\\n\\n**3.4 Forms**\\n\\n- Each input has a `<label>` or `aria-label`. Group related inputs with `<fieldset><legend>`.\\n- Associate errors via `aria-describedby` or inline IDs; announce with `role=\\\"alert\\\"` (assertive only for critical).\\n- Provide **autocomplete** tokens for known fields; show **inline validation** and do not block on **onBlur** alone.\\n\\n**3.5 ARIA Usage**\\n\\n- Only when needed; match patterns (dialog, menu, combobox, tablist, listbox) per ARIA Authoring Practices.\\n- Ensure **name/role/value** are programmatically determinable.\\n\\n**3.6 Media**\\n\\n- Videos: **captions**; provide **transcripts** for audio; audio descriptions for essential visual info.\\n- No auto‑playing audio. Auto‑playing video must be muted and pausable; provide controls.\\n\\n**3.7 Tables & Data**\\n\\n- Use `<th scope>` for headers; captions via `<caption>`; announce sorting via `aria-sort`.\\n- Provide CSV/JSON export where charts are primary.\\n\\n**3.8 Performance & Robustness**\\n\\n- Avoid content shifts that move focus; reserve space or use skeletons.\\n- Maintain accessible names through hydration/SSR; avoid `dangerouslySetInnerHTML` where possible.\\n\\n**3.9 Next.js specifics**\\n\\n- Use `next/link` for navigation; ensure links are **links**, not buttons.\\n- `next/image` must include **alt** (empty if decorative).\\n- Announce route changes with a **global live region** and shift focus to the new view.\\n\\n**3.10 Accessibility library integration**\\n\\n- Import `@lssm/lib.accessibility` at app root. It auto-imports its `styles.css` via the package entry; ensure bundlers keep CSS side effects. If your app tree-shakes CSS, explicitly import the stylesheet once in your root layout:\\n\\n```tsx\\n// app/layout.tsx\\nimport '@lssm/lib.accessibility'; // includes tokens and provider exports\\n// or if needed: import '@lssm/lib.accessibility/src/styles.css';\\n```\\n\\n- Wrap the app with `AccessibilityProvider` and include an element with `id=\\\"main\\\"` for the skip link target.\\n\\n---\\n\\n## 3b) lssm/ui-kit-web — Component Patterns & Defaults\\n\\n> Source: `packages/lssm/libs/ui-kit-web/ui/*`\\n\\n- **Button/Input/Textarea**: Built‑in `focus-visible` rings; ensure visible labels via `FormLabel` or `aria-label`.\\n- **Form** (`form.tsx`): `FormControl` wires `aria-invalid` and `aria-describedby` to `FormMessage` and `FormDescription`. Prefer `FormMessage` for inline errors. Add `role=\\\"alert\\\"` only for critical.\\n- **Dialog/Sheet/Dropdown**: Use Radix wrappers for focus‑trap and return‑focus. Provide `DialogTitle` + `DialogDescription` for name/description.\\n- **Select/Combobox**: Prefer `SelectTrigger` with visible label; for icon‑only triggers, supply `aria-label`. Document examples in each app.\\n- **Tabs**: Use `TabsList`, `TabsTrigger`, `TabsContent`; names are programmatically determinable.\\n- **Toast/Toaster**: Prefer non‑blocking announcements; map critical to assertive region; include action buttons with clear labels.\\n- **Table**: Use `TableCaption`; ensure `TableHead` cells use proper `scope`. Provide `aria-sort` on sortable headers.\\n- **Utilities to add (repo action)**:\\n  - `SkipLink` component and pattern in layouts.\\n  - `RouteAnnouncer` (`aria-live=\\\"polite\\\"`) and **FocusOnRouteChange** helper.\\n  - `VisuallyHidden` wrapper (Radix visually-hidden or minimal utility).\\n  - `useReducedMotion` helper; honor in animated components.\\n  - Touch‑size variants (≥44×44) for interactive atoms.\\n\\n---\\n\\n## 4) Engineering Requirements (Mobile — Expo/React\\xA0Native)\\n\\n- Set `accessibilityLabel`, `accessibilityHint`, and `accessibilityRole` on touchables.\\n- Ensure **hit slop** / min size **≥\\xA044×44\\xA0dp**.\\n- Support Dynamic Type / font scaling; no clipped text at **200%**.\\n- Respect **Invert Colors** and **Reduce Motion**; avoid flashing.\\n- Group related items with `accessibilityElements` ordering; hide decoration with `accessible={false}` or `importantForAccessibility=\\\"no-hide-descendants\\\"` when appropriate.\\n- Test with **VoiceOver (iOS)** and **TalkBack (Android)**.\\n\\n---\\n\\n## 5) Component Patterns (Acceptance Rules)\\n\\n**Buttons & Links**\\n\\n- Use `<button>` for actions, `<a href>` for navigation. Provide disabled states that are perceivable beyond color.\\n\\n**Navigation**\\n\\n- Provide **Skip link**. One primary nav landmark. Indicate current page (`aria-current=\\\"page\\\"`).\\n\\n**Menus/Combobox/Autocomplete**\\n\\n- Follow ARIA patterns: focus moves into list; `aria-expanded`, `aria-controls`, `aria-activedescendant` when applicable; Esc closes; typing filters.\\n\\n**Modals/Dialogs**\\n\\n- `role=\\\"dialog\\\"` or `alertdialog` with **label**; focus trapped; background inert; Esc closes; return focus to trigger.\\n\\n**Tabs**\\n\\n- `role=\\\"tablist\\\"`; tabs are in the tab order; arrow keys switch focus; content is `role=\\\"tabpanel\\\"` with `aria-labelledby`.\\n\\n**Toasts/Notifications**\\n\\n- Non-critical: `aria-live=\\\"polite\\\"`; critical: `role=\\\"alert\\\"` sparingly.\\n\\n**Infinite Scroll / “Load More”**\\n\\n- Provide **Load more** control; announce new content to SR; preserve keyboard position.\\n\\n**Drag & Drop (2.5.7)**\\n\\n- Provide **non‑drag** alternative (e.g., move up/down buttons).\\n\\n**Charts & Maps**\\n\\n- Provide **table alternative** or textual summary; keyboard access to datapoints where interactive.\\n\\n---\\n\\n## 6) Testing & CI (Blocking Gates)\\n\\n**Static & Unit**\\n\\n- `eslint-plugin-jsx-a11y` — error on violations.\\n- `jest-axe` — unit tests for components.\\n\\n**Automated Integration**\\n\\n- `axe-core` via Playwright or Cypress on critical flows.\\n- `pa11y-ci` on key routes; threshold: **0 Critical / 0 Serious** to merge.\\n- Lighthouse CI a11y score **≥\\xA095** on target pages.\\n\\n**Manual QA (per release)**\\n\\n- **Keyboard patrol:** navigate primary flows without mouse.\\n- **Screen reader smoke:** NVDA (Windows) or VoiceOver (macOS/iOS) across login, navigation, forms, dialogs.\\n- **Zoom & Reflow:** 200–400% & 320\\xA0px width.\\n- **Color/Contrast check:** tokens in both themes.\\n\\n**Reporting**\\n\\n- A11y issues labeled: `a11y-blocker`, `a11y-bug`, `a11y-enhancement` with WCAG ref.\\n\\n---\\n\\n## 7) Repository‑Specific Adoption Plan\\n\\n- Centralize UI usage on `packages/lssm/libs/ui-kit-web` and de‑duplicate per‑app `components/ui` where feasible.\\n- Introduce `SkipLink`, `RouteAnnouncer`, `FocusOnRouteChange`, and `VisuallyHidden` in `ui-kit-web`. Adopt in app layouts (`app/layout.tsx`) first.\\n- Add `useReducedMotion` and wire into animated components (e.g., `drawer`, `tooltip`, `carousel`).\\n- Add touch‑size variants to `Button`, `IconButton`, `TabsTrigger`, toggles.\\n- Document Select label patterns and error association in Forms.\\n\\n---\\n\\n## 8) Code Snippets\\n\\n**Skip Link**\\n\\n```html\\n<a\\n  class=\\\"sr-only focus:not-sr-only focus-visible:outline focus-visible:ring-4 focus-visible:ring-offset-2\\\"\\n  href=\\\"#main\\\"\\n  >Skip to main content</a\\n>\\n<main id=\\\"main\\\">…</main>\\n```\\n\\n**Dialog (Radix + shadcn/ui) — essentials**\\n\\n```tsx\\n// Ensure label, description, focus trap, and return focus on close remain intact\\n<Dialog>\\n  <DialogTrigger asChild>\\n    <button aria-haspopup=\\\"dialog\\\">Open settings</button>\\n  </DialogTrigger>\\n  <DialogContent aria-describedby=\\\"settings-desc\\\">\\n    <DialogTitle>Settings</DialogTitle>\\n    <p id=\\\"settings-desc\\\">Update your preferences.</p>\\n    <DialogClose asChild>\\n      <button>Close</button>\\n    </DialogClose>\\n  </DialogContent>\\n</Dialog>\\n```\\n\\n**Form error association**\\n\\n```tsx\\n<label htmlFor=\\\"email\\\">Email</label>\\n<input id=\\\"email\\\" name=\\\"email\\\" type=\\\"email\\\" aria-describedby=\\\"email-err\\\" />\\n<p id=\\\"email-err\\\" role=\\\"alert\\\">Enter a valid email.</p>\\n```\\n\\n**Route change announcement (Next.js)**\\n\\n```tsx\\n// Add once at app root\\n<div\\n  aria-live=\\\"polite\\\"\\n  aria-atomic=\\\"true\\\"\\n  id=\\\"route-announcer\\\"\\n  className=\\\"sr-only\\\"\\n/>\\n```\\n\\n---\\n\\n## 9) Exceptions & Waivers\\n\\n- If a criterion cannot be met, file an issue with: context, attempted alternatives, WCAG reference, impact assessment, and a remediation date. **Temporary waivers only.**\\n\\n---\\n\\n## 10) Ownership\\n\\n- **Design:** maintains token contrast, component specs.\\n- **Engineering:** enforces CI gates, implements patterns.\\n- **QA:** runs manual checks per release.\\n- **PM:** blocks release if AA not met on user‑visible flows.\\n\\n---\\n\\n## 11) References (internalize; no external dependency at runtime)\\n\\n- WCAG\\xA02.2 (AA), EN\\xA0301\\xA0549. ARIA Authoring Practices. Platform HIG (Apple, Material).\\n- `packages/lssm/libs/ui-kit-web` as the canonical UI source for web.\\n\\n> **Bottom line:** Shipping means **accessible by default**. We don’t trade a11y for speed; we bake it into speed.\\n\\n---\\n\\n## 12) Adoption Status (2025-09-23)\\n\\n- web-artisan: AccessibilityProvider integrated; sr-only/forced-colors applied; 44x44 targets; forms announce errors; jest-axe and cypress-axe in place.\\n- web-strit: AccessibilityProvider integrated; forced-colors, sr-only; forms announce errors; 44x44 targets; contrast tokens and text-scale wired; jest-axe and cypress-axe in place.\\n- web-coliving: AccessibilityProvider integrated; forced-colors and focus visibility added; text-scale wired; landing pages converted to `Section`/stacks with text-lg defaults; CTA capture standardized; ESLint guard for text-xs in main content; jest-axe and cypress-axe in place. Next: audit icon-only controls and ensure 44x44 targets; add role=\\\"alert\\\" where critical.\\n\\n> CI gates: run eslint a11y, jest-axe on components, and cypress-axe on critical flows per app.\\n\\n---\\n\\n## 13) CI Hardening & Visual QA\\n\\n- Linting: Run eslint with jsx-a11y rules across all web apps; block on violations.\\n- Unit: Run jest-axe for ui-kit-web and app-level components.\\n- Integration: cypress-axe on key flows (auth, forms, dialogs, tables).\\n- Synthetic scans: pa11y-ci on critical pages (0 Critical/Serious policy).\\n- Performance/A11y audit: Lighthouse CI with a11y score >= 95 on target routes.\\n- Artifacts: Upload pa11y and Lighthouse reports per PR; annotate failures.\\n\\n### Recent additions (2025-09-26)\\n\\n- AutocompleteInput (groceries): Upgraded to ARIA combobox pattern with `aria-controls`, `aria-activedescendant`, `Escape`/`Tab` handling, and labelled listbox.\\n- Cypress a11y tests added for furniture and incidents modules on `/modules` and operators flows; checks run axe with critical/serious impacts.\\n\\n## 14) Accessibility Telemetry (PostHog)\\n\\n- Events (anonymized): a11y_pref_changed (text_scale, contrast_mode, reduce_motion), a11y_panel_opened.\\n- Properties: app, route, previous_value, new_value, timestamp.\\n- Dashboards: Adoption over time, per app/route; correlation with reduced bounce on forms.\\n- Privacy: No PII; aggregate only.\\n\"\n}];\nregisterDocBlocks(accessibility_wcag_compliance_specs_DocBlocks);\n\n//#endregion\nexport { accessibility_wcag_compliance_specs_DocBlocks };\n//# sourceMappingURL=accessibility_wcag_compliance_specs.docblock.js.map"],"mappings":";;;AAGA,MAAM,gDAAgD,CAAC;CACtD,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,sCAAsC;CAC7C,MAAM;CACN,CAAC;AACF,kBAAkB,8CAA8C"}

package/dist/libs/contracts/dist/docs/index.js

@@ -1,12 +1,8 @@
 import { docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes } from "./presentations.js";
 import { DocRegistry, defaultDocRegistry, registerDocBlocks } from "./registry.js";
-import "./PUBLISHING.docblock.js";
+import { techContractsDocs } from "./tech-contracts.docs.js";
+import { metaDocs } from "./meta.docs.js";
 import "./accessibility_wcag_compliance_specs.docblock.js";
-import "./tech/PHASE_1_QUICKSTART.docblock.js";
-import "./tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js";
-import "./tech/PHASE_3_AUTO_EVOLUTION.docblock.js";
-import "./tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js";
-import "./tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js";
 import "./tech/lifecycle-stage-system.docblock.js";
 import "./tech/presentation-runtime.docblock.js";
 import "./tech/auth/better-auth-nextjs.docblock.js";