business-as-code 2.3.0 → 2.4.0

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/vision.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Vision statement definition
+ */
+import type { VisionDefinition } from './types.js';
+/**
+ * Define a business vision statement with timeframe and success indicators
+ *
+ * @example
+ * ```ts
+ * const vision = Vision({
+ *   statement: 'To become the world\'s most trusted widget platform',
+ *   timeframe: '5 years',
+ *   successIndicators: [
+ *     '10M+ active users',
+ *     'Present in 50+ countries',
+ *     'Industry-leading NPS score',
+ *     '$1B+ annual revenue',
+ *   ],
+ * })
+ * ```
+ */
+export declare function Vision(definition: VisionDefinition): VisionDefinition;
+/**
+ * Check if a success indicator has been achieved
+ */
+export declare function checkIndicator(vision: VisionDefinition, indicator: string, currentMetrics: Record<string, number | boolean>): boolean;
+/**
+ * Calculate vision progress based on achieved indicators
+ */
+export declare function calculateProgress(vision: VisionDefinition, currentMetrics: Record<string, number | boolean>): number;
+/**
+ * Validate vision definition
+ */
+export declare function validateVision(vision: VisionDefinition): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=vision.d.ts.map

package/dist/vision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.d.ts","sourceRoot":"","sources":["../src/vision.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,gBAAgB,GAAG,gBAAgB,CAYrE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAC/C,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,gBAAgB,EACxB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAC/C,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAe7F"}

package/dist/vision.js

@@ -0,0 +1,68 @@
+/**
+ * Vision statement definition
+ */
+/**
+ * Define a business vision statement with timeframe and success indicators
+ *
+ * @example
+ * ```ts
+ * const vision = Vision({
+ *   statement: 'To become the world\'s most trusted widget platform',
+ *   timeframe: '5 years',
+ *   successIndicators: [
+ *     '10M+ active users',
+ *     'Present in 50+ countries',
+ *     'Industry-leading NPS score',
+ *     '$1B+ annual revenue',
+ *   ],
+ * })
+ * ```
+ */
+export function Vision(definition) {
+    // Validate required fields
+    if (!definition.statement) {
+        throw new Error('Vision statement is required');
+    }
+    // Return validated vision definition
+    return {
+        ...definition,
+        successIndicators: definition.successIndicators || [],
+        metadata: definition.metadata || {},
+    };
+}
+/**
+ * Check if a success indicator has been achieved
+ */
+export function checkIndicator(vision, indicator, currentMetrics) {
+    // Simple check - would need more sophisticated parsing in production
+    return Object.entries(currentMetrics).some(([key, value]) => {
+        return indicator.toLowerCase().includes(key.toLowerCase()) && Boolean(value);
+    });
+}
+/**
+ * Calculate vision progress based on achieved indicators
+ */
+export function calculateProgress(vision, currentMetrics) {
+    if (!vision.successIndicators || vision.successIndicators.length === 0) {
+        return 0;
+    }
+    const achieved = vision.successIndicators.filter(indicator => checkIndicator(vision, indicator, currentMetrics)).length;
+    return (achieved / vision.successIndicators.length) * 100;
+}
+/**
+ * Validate vision definition
+ */
+export function validateVision(vision) {
+    const errors = [];
+    if (!vision.statement) {
+        errors.push('Vision statement is required');
+    }
+    if (vision.statement && vision.statement.length < 10) {
+        errors.push('Vision statement should be at least 10 characters');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=vision.js.map

package/dist/vision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.js","sourceRoot":"","sources":["../src/vision.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,MAAM,CAAC,UAA4B;IACjD,2BAA2B;IAC3B,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACjD,CAAC;IAED,qCAAqC;IACrC,OAAO;QACL,GAAG,UAAU;QACb,iBAAiB,EAAE,UAAU,CAAC,iBAAiB,IAAI,EAAE;QACrD,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,EAAE;KACpC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAwB,EACxB,SAAiB,EACjB,cAAgD;IAEhD,qEAAqE;IACrE,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC1D,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAwB,EACxB,cAAgD;IAEhD,IAAI,CAAC,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO,CAAC,CAAA;IACV,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAC3D,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC,CAClD,CAAC,MAAM,CAAA;IAER,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,GAAG,GAAG,CAAA;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAwB;IACrD,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;IAC7C,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAA;IAClE,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAA;AACH,CAAC"}

package/dist/workflow.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Workflow definition (automation sequences)
+ */
+import type { WorkflowDefinition, WorkflowAction, WorkflowTrigger } from './types.js';
+/**
+ * Define an automated workflow with triggers and actions
+ *
+ * @example
+ * ```ts
+ * const workflow = Workflow({
+ *   name: 'New Customer Welcome',
+ *   description: 'Automated welcome sequence for new customers',
+ *   trigger: {
+ *     type: 'event',
+ *     event: 'Customer.created',
+ *   },
+ *   actions: [
+ *     {
+ *       order: 1,
+ *       type: 'send',
+ *       description: 'Send welcome email',
+ *       params: {
+ *         template: 'welcome_email',
+ *         to: '{{customer.email}}',
+ *       },
+ *     },
+ *     {
+ *       order: 2,
+ *       type: 'create',
+ *       description: 'Create onboarding task',
+ *       params: {
+ *         type: 'Task',
+ *         title: 'Onboard {{customer.name}}',
+ *         assignee: 'customer_success_team',
+ *       },
+ *     },
+ *     {
+ *       order: 3,
+ *       type: 'wait',
+ *       description: 'Wait 24 hours',
+ *       params: {
+ *         duration: '24 hours',
+ *       },
+ *     },
+ *     {
+ *       order: 4,
+ *       type: 'notify',
+ *       description: 'Send setup reminder',
+ *       params: {
+ *         channel: 'email',
+ *         message: 'Reminder to complete setup',
+ *       },
+ *       condition: 'customer.setupCompleted === false',
+ *     },
+ *   ],
+ * })
+ * ```
+ */
+export declare function Workflow(definition: WorkflowDefinition): WorkflowDefinition;
+/**
+ * Get actions in execution order
+ */
+export declare function getActionsInOrder(workflow: WorkflowDefinition): WorkflowAction[];
+/**
+ * Get actions by type
+ */
+export declare function getActionsByType(workflow: WorkflowDefinition, type: WorkflowAction['type']): WorkflowAction[];
+/**
+ * Get conditional actions
+ */
+export declare function getConditionalActions(workflow: WorkflowDefinition): WorkflowAction[];
+/**
+ * Add action to workflow
+ */
+export declare function addAction(workflow: WorkflowDefinition, action: WorkflowAction): WorkflowDefinition;
+/**
+ * Remove action from workflow
+ */
+export declare function removeAction(workflow: WorkflowDefinition, order: number): WorkflowDefinition;
+/**
+ * Update action in workflow
+ */
+export declare function updateAction(workflow: WorkflowDefinition, order: number, updates: Partial<WorkflowAction>): WorkflowDefinition;
+/**
+ * Check if trigger is event-based
+ */
+export declare function isEventTrigger(trigger: WorkflowTrigger): boolean;
+/**
+ * Check if trigger is schedule-based
+ */
+export declare function isScheduleTrigger(trigger: WorkflowTrigger): boolean;
+/**
+ * Check if trigger is webhook-based
+ */
+export declare function isWebhookTrigger(trigger: WorkflowTrigger): boolean;
+/**
+ * Parse wait duration to milliseconds
+ */
+export declare function parseWaitDuration(duration: string): number;
+/**
+ * Evaluate condition (simple implementation)
+ */
+export declare function evaluateCondition(condition: string, context: Record<string, unknown>): boolean;
+/**
+ * Fill template with context values
+ */
+export declare function fillTemplate(template: string, context: Record<string, unknown>): string;
+/**
+ * Validate workflow definition
+ */
+export declare function validateWorkflow(workflow: WorkflowDefinition): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,kBAAkB,CAc3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAEhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,GAC3B,cAAc,EAAE,CAElB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAEpF;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,cAAc,GACrB,kBAAkB,CAKpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAK5F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,kBAAkB,CAQpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAEhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAElE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiC1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAgB9F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAKvF;AASD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG;IAC9D,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB,CA2CA"}

package/dist/workflow.js

@@ -0,0 +1,248 @@
+/**
+ * Workflow definition (automation sequences)
+ */
+/**
+ * Define an automated workflow with triggers and actions
+ *
+ * @example
+ * ```ts
+ * const workflow = Workflow({
+ *   name: 'New Customer Welcome',
+ *   description: 'Automated welcome sequence for new customers',
+ *   trigger: {
+ *     type: 'event',
+ *     event: 'Customer.created',
+ *   },
+ *   actions: [
+ *     {
+ *       order: 1,
+ *       type: 'send',
+ *       description: 'Send welcome email',
+ *       params: {
+ *         template: 'welcome_email',
+ *         to: '{{customer.email}}',
+ *       },
+ *     },
+ *     {
+ *       order: 2,
+ *       type: 'create',
+ *       description: 'Create onboarding task',
+ *       params: {
+ *         type: 'Task',
+ *         title: 'Onboard {{customer.name}}',
+ *         assignee: 'customer_success_team',
+ *       },
+ *     },
+ *     {
+ *       order: 3,
+ *       type: 'wait',
+ *       description: 'Wait 24 hours',
+ *       params: {
+ *         duration: '24 hours',
+ *       },
+ *     },
+ *     {
+ *       order: 4,
+ *       type: 'notify',
+ *       description: 'Send setup reminder',
+ *       params: {
+ *         channel: 'email',
+ *         message: 'Reminder to complete setup',
+ *       },
+ *       condition: 'customer.setupCompleted === false',
+ *     },
+ *   ],
+ * })
+ * ```
+ */
+export function Workflow(definition) {
+    if (!definition.name) {
+        throw new Error('Workflow name is required');
+    }
+    if (!definition.trigger) {
+        throw new Error('Workflow trigger is required');
+    }
+    return {
+        ...definition,
+        actions: definition.actions || [],
+        metadata: definition.metadata || {},
+    };
+}
+/**
+ * Get actions in execution order
+ */
+export function getActionsInOrder(workflow) {
+    return [...(workflow.actions || [])].sort((a, b) => a.order - b.order);
+}
+/**
+ * Get actions by type
+ */
+export function getActionsByType(workflow, type) {
+    return workflow.actions?.filter((action) => action.type === type) || [];
+}
+/**
+ * Get conditional actions
+ */
+export function getConditionalActions(workflow) {
+    return workflow.actions?.filter((action) => action.condition) || [];
+}
+/**
+ * Add action to workflow
+ */
+export function addAction(workflow, action) {
+    return {
+        ...workflow,
+        actions: [...(workflow.actions || []), action],
+    };
+}
+/**
+ * Remove action from workflow
+ */
+export function removeAction(workflow, order) {
+    const actions = workflow.actions?.filter((a) => a.order !== order);
+    const result = { ...workflow };
+    if (actions !== undefined)
+        result.actions = actions;
+    return result;
+}
+/**
+ * Update action in workflow
+ */
+export function updateAction(workflow, order, updates) {
+    const actions = workflow.actions?.map((action) => action.order === order ? { ...action, ...updates } : action);
+    const result = { ...workflow };
+    if (actions !== undefined)
+        result.actions = actions;
+    return result;
+}
+/**
+ * Check if trigger is event-based
+ */
+export function isEventTrigger(trigger) {
+    return trigger.type === 'event';
+}
+/**
+ * Check if trigger is schedule-based
+ */
+export function isScheduleTrigger(trigger) {
+    return trigger.type === 'schedule';
+}
+/**
+ * Check if trigger is webhook-based
+ */
+export function isWebhookTrigger(trigger) {
+    return trigger.type === 'webhook';
+}
+/**
+ * Parse wait duration to milliseconds
+ */
+export function parseWaitDuration(duration) {
+    const match = duration.match(/(\d+)\s*(ms|millisecond|milliseconds|s|second|seconds|m|minute|minutes|h|hour|hours|d|day|days)/);
+    if (!match)
+        return 0;
+    const value = parseInt(match[1] || '0', 10);
+    const unit = match[2];
+    switch (unit) {
+        case 'ms':
+        case 'millisecond':
+        case 'milliseconds':
+            return value;
+        case 's':
+        case 'second':
+        case 'seconds':
+            return value * 1000;
+        case 'm':
+        case 'minute':
+        case 'minutes':
+            return value * 60 * 1000;
+        case 'h':
+        case 'hour':
+        case 'hours':
+            return value * 60 * 60 * 1000;
+        case 'd':
+        case 'day':
+        case 'days':
+            return value * 24 * 60 * 60 * 1000;
+        default:
+            return 0;
+    }
+}
+/**
+ * Evaluate condition (simple implementation)
+ */
+export function evaluateCondition(condition, context) {
+    // This is a simplified implementation
+    // In production, use a proper expression evaluator
+    try {
+        // Replace variable references with actual values
+        let expression = condition;
+        for (const [key, value] of Object.entries(context)) {
+            const regex = new RegExp(`\\b${key}\\b`, 'g');
+            expression = expression.replace(regex, JSON.stringify(value));
+        }
+        // Evaluate the expression (unsafe in production - use a proper evaluator)
+        return Boolean(eval(expression));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Fill template with context values
+ */
+export function fillTemplate(template, context) {
+    return template.replace(/\{\{([^}]+)\}\}/g, (_, path) => {
+        const value = getNestedValue(context, path.trim());
+        return String(value ?? '');
+    });
+}
+/**
+ * Get nested value from object by path
+ */
+function getNestedValue(obj, path) {
+    return path.split('.').reduce((acc, part) => acc?.[part], obj);
+}
+/**
+ * Validate workflow definition
+ */
+export function validateWorkflow(workflow) {
+    const errors = [];
+    if (!workflow.name) {
+        errors.push('Workflow name is required');
+    }
+    if (!workflow.trigger) {
+        errors.push('Workflow trigger is required');
+    }
+    else {
+        if (workflow.trigger.type === 'event' && !workflow.trigger.event) {
+            errors.push('Event trigger must specify an event name');
+        }
+        if (workflow.trigger.type === 'schedule' && !workflow.trigger.schedule) {
+            errors.push('Schedule trigger must specify a schedule expression');
+        }
+        if (workflow.trigger.type === 'webhook' && !workflow.trigger.webhook) {
+            errors.push('Webhook trigger must specify a webhook URL');
+        }
+    }
+    if (workflow.actions) {
+        const orders = new Set();
+        for (const action of workflow.actions) {
+            if (!action.type) {
+                errors.push(`Action at order ${action.order} must have a type`);
+            }
+            if (orders.has(action.order)) {
+                errors.push(`Duplicate action order: ${action.order}`);
+            }
+            orders.add(action.order);
+            // Validate action-specific requirements
+            if (action.type === 'wait' && !action.params?.['duration']) {
+                errors.push(`Wait action at order ${action.order} must specify duration`);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAM,UAAU,QAAQ,CAAC,UAA8B;IACrD,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAC9C,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACjD,CAAC;IAED,OAAO;QACL,GAAG,UAAU;QACb,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,EAAE;QACjC,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,EAAE;KACpC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAA4B;IAC5D,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAA4B,EAC5B,IAA4B;IAE5B,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAA;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAA4B;IAChE,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,QAA4B,EAC5B,MAAsB;IAEtB,OAAO;QACL,GAAG,QAAQ;QACX,OAAO,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC;KAC/C,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAA4B,EAAE,KAAa;IACtE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;IAClE,MAAM,MAAM,GAAuB,EAAE,GAAG,QAAQ,EAAE,CAAA;IAClD,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;IACnD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,QAA4B,EAC5B,KAAa,EACb,OAAgC;IAEhC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC/C,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAC5D,CAAA;IAED,MAAM,MAAM,GAAuB,EAAE,GAAG,QAAQ,EAAE,CAAA;IAClD,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;IACnD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAwB;IACrD,OAAO,OAAO,CAAC,IAAI,KAAK,OAAO,CAAA;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAwB;IACxD,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,OAAO,OAAO,CAAC,IAAI,KAAK,SAAS,CAAA;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAC1B,iGAAiG,CAClG,CAAA;IACD,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAA;IAEpB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IAErB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,IAAI,CAAC;QACV,KAAK,aAAa,CAAC;QACnB,KAAK,cAAc;YACjB,OAAO,KAAK,CAAA;QACd,KAAK,GAAG,CAAC;QACT,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,KAAK,GAAG,IAAI,CAAA;QACrB,KAAK,GAAG,CAAC;QACT,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,KAAK,GAAG,EAAE,GAAG,IAAI,CAAA;QAC1B,KAAK,GAAG,CAAC;QACT,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;QAC/B,KAAK,GAAG,CAAC;QACT,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;QACpC;YACE,OAAO,CAAC,CAAA;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,OAAgC;IACnF,sCAAsC;IACtC,mDAAmD;IACnD,IAAI,CAAC;QACH,iDAAiD;QACjD,IAAI,UAAU,GAAG,SAAS,CAAA;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,GAAG,CAAC,CAAA;YAC7C,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;QAC/D,CAAC;QAED,0EAA0E;QAC1E,OAAO,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAA;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,OAAgC;IAC7E,OAAO,QAAQ,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE;QACtD,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAClD,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,GAA4B,EAAE,IAAY;IAChE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAA;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA4B;IAI3D,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;IAC1C,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;IAC7C,CAAC;SAAM,CAAC;QACN,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAA;QACzD,CAAC;QACD,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvE,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAA;QACpE,CAAC;QACD,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAA;QAChC,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,KAAK,mBAAmB,CAAC,CAAA;YACjE,CAAC;YACD,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,2BAA2B,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;YACxD,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAExB,wCAAwC;YACxC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3D,MAAM,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,KAAK,wBAAwB,CAAC,CAAA;YAC3E,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "business-as-code",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Primitives for expressing business logic and processes as code",
   "type": "module",
   "main": "dist/index.js",
@@ -9,6 +9,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./finance": {
+      "import": "./dist/finance/index.js",
+      "types": "./dist/finance/index.d.ts"
     }
   },
   "scripts": {
@@ -20,9 +24,9 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "ai-database": "2.3.0",
-    "ai-functions": "2.3.0",
-    "digital-workers": "2.3.0",
+    "ai-database": "2.4.0",
+    "ai-functions": "2.4.0",
+    "digital-workers": "2.4.0",
     "org.ai": "0.0.1"
   },
   "devDependencies": {},

package/src/finance/account.ts

@@ -0,0 +1,48 @@
+/**
+ * Account — bank/treasury/wallet account abstraction across providers.
+ * Stripe Treasury, Mercury, Column, Increase, Privy non-custodial wallet, etc.
+ */
+
+import type { Currency, Money } from './types.js'
+
+export interface Account {
+  $id: string
+  $type: 'Account'
+  /** Tenant the account belongs to (ThingRef shape). */
+  tenantRef?: string
+  purpose: string
+  currency: Currency
+  providerData: {
+    provider: string
+    externalId: string
+  }
+}
+
+export interface AccountSpec {
+  tenantRef?: string
+  purpose: string
+  currency: Currency
+}
+
+export interface TransferOpts {
+  fromAccountRef: string
+  toAccountRef: string
+  amount: Money
+  /** Idempotency key for at-most-once semantics. */
+  idempotencyKey?: string
+}
+
+export interface TransferResult {
+  $id: string
+  $type: 'Transfer'
+  fromAccountRef: string
+  toAccountRef: string
+  amount: Money
+  status: 'pending' | 'settled' | 'failed' | 'reversed'
+  /** ISO-8601 timestamp. */
+  createdAt: string
+  providerData: {
+    provider: string
+    externalId: string
+  }
+}

package/src/finance/authority.ts

@@ -0,0 +1,42 @@
+/**
+ * AuthorityBoundary — typed regulatory marker on a Service.
+ * The 12-tag catalog (per startup-builder SERVICES.md) lets a cascade
+ * declare the boundary it operates within; routing and HITL gates
+ * compose against the boundary.
+ *
+ * 10 regulated tags + 2 sentinels (none, self-only).
+ */
+
+export type AuthorityBoundaryRef =
+  | 'self-only' // sentinel: agent acts for itself; no externally-binding outputs
+  | 'tenant-only' // sentinel: outputs bind only the tenant; no external counterparties
+  | 'unlicensed-advisory' // general-knowledge advisory; no professional license claimed
+  | 'cpa-attest' // CPA-signed attestation required
+  | 'jd-bar-admitted' // attorney admitted to relevant bar
+  | 'md-licensed' // physician with current state license
+  | 'fiduciary-investment-advice' // RIA / fiduciary-grade investment recommendation
+  | 'broker-dealer' // broker-dealer scope (FINRA-registered context)
+  | 'insurance-licensed' // licensed insurance producer
+  | 'real-estate-licensed' // licensed real-estate broker / agent
+  | 'pe-stamp' // PE-stamped engineering output
+  | 'kyc-aml-required' // identity + AML screening before action
+  | (string & { __brand?: 'AuthorityBoundaryRef' })
+
+/**
+ * Catalog of canonical AuthorityBoundary tags with policy hints. Consumers
+ * reference by id; substrate enforces gating + HITL routing per tag.
+ */
+export const AuthorityBoundaries = {
+  'self-only': { regulated: false, requiresHumanSign: false, requiresKYC: false },
+  'tenant-only': { regulated: false, requiresHumanSign: false, requiresKYC: false },
+  'unlicensed-advisory': { regulated: false, requiresHumanSign: false, requiresKYC: false },
+  'cpa-attest': { regulated: true, requiresHumanSign: true, requiresKYC: true },
+  'jd-bar-admitted': { regulated: true, requiresHumanSign: true, requiresKYC: true },
+  'md-licensed': { regulated: true, requiresHumanSign: true, requiresKYC: true },
+  'fiduciary-investment-advice': { regulated: true, requiresHumanSign: true, requiresKYC: true },
+  'broker-dealer': { regulated: true, requiresHumanSign: true, requiresKYC: true },
+  'insurance-licensed': { regulated: true, requiresHumanSign: true, requiresKYC: true },
+  'real-estate-licensed': { regulated: true, requiresHumanSign: true, requiresKYC: true },
+  'pe-stamp': { regulated: true, requiresHumanSign: true, requiresKYC: false },
+  'kyc-aml-required': { regulated: true, requiresHumanSign: false, requiresKYC: true },
+} as const

package/src/finance/card.ts

@@ -0,0 +1,38 @@
+/**
+ * Card — virtual card issued by a finance provider (Stripe Issuing, Brex, Lithic, etc.).
+ * Per-Worker / per-Function / per-Task lifecycle.
+ */
+
+import type { Money } from './types.js'
+
+export interface Card {
+  $id: string
+  $type: 'Card'
+  scope: 'single-use' | 'recurring'
+  /** Worker the card is issued to (Person/Agent/Role); ThingRef shape. */
+  workerRef?: string
+  caps: {
+    perTransaction?: Money
+    daily?: Money
+    total?: Money
+  }
+  /** Allowed Merchant Category Codes. */
+  mccAllowed?: string[]
+  /** Velocity controls. */
+  velocity?: {
+    maxTxPerDay?: number
+  }
+  state: 'issued' | 'active' | 'locked' | 'disposed'
+  providerData: {
+    provider: string
+    externalId: string
+  }
+}
+
+export interface CardSpec {
+  scope: 'single-use' | 'recurring'
+  workerRef?: string
+  caps: Card['caps']
+  mccAllowed?: string[]
+  velocity?: Card['velocity']
+}