dotdo 0.0.1 → 0.1.0

package/dist/lib/capabilities.js

@@ -0,0 +1,268 @@
+/**
+ * Capability Lazy Loading System
+ *
+ * Provides lazy loading of capability modules ($.fs, $.git, $.bash, etc.)
+ * Modules are loaded on first access and cached for subsequent use.
+ */
+// ============================================================================
+// CAPABILITY ERROR
+// ============================================================================
+/**
+ * Error thrown when accessing an unavailable capability
+ */
+export class CapabilityError extends Error {
+    capability;
+    reason;
+    name = 'CapabilityError';
+    constructor(capability, reason, message) {
+        const defaultMessage = CapabilityError.getDefaultMessage(capability, reason);
+        super(message || defaultMessage);
+        this.capability = capability;
+        this.reason = reason;
+    }
+    static getDefaultMessage(capability, reason) {
+        switch (reason) {
+            case 'not_available':
+                return `Capability '${capability}' is not registered`;
+            case 'permission_denied':
+                return `Permission denied for capability '${capability}'`;
+            case 'load_failed':
+                return `Failed to load capability '${capability}'`;
+        }
+    }
+}
+// ============================================================================
+// CAPABILITY REGISTRY
+// ============================================================================
+/**
+ * Registry for capability modules with lazy loading support
+ */
+export class CapabilityRegistry {
+    /** Registered module constructors */
+    modules = new Map();
+    /** Cached capability instances (loaded lazily) */
+    instances = new Map();
+    /**
+     * Register a capability module (constructor)
+     */
+    register(name, module, options = {}) {
+        if (this.modules.has(name) && !options.force) {
+            throw new Error(`Capability '${name}' is already registered. Use { force: true } to override.`);
+        }
+        // If force re-registering, clear any cached instance
+        if (options.force && this.instances.has(name)) {
+            this.instances.delete(name);
+        }
+        this.modules.set(name, {
+            type: 'module',
+            module,
+            options,
+        });
+    }
+    /**
+     * Register a capability factory (async function)
+     */
+    registerFactory(name, factory, options = {}) {
+        if (this.modules.has(name) && !options.force) {
+            throw new Error(`Capability '${name}' is already registered. Use { force: true } to override.`);
+        }
+        // If force re-registering, clear any cached instance
+        if (options.force && this.instances.has(name)) {
+            this.instances.delete(name);
+        }
+        this.modules.set(name, {
+            type: 'factory',
+            factory,
+            options,
+        });
+    }
+    /**
+     * Unregister a capability
+     */
+    unregister(name) {
+        const existed = this.modules.has(name);
+        this.modules.delete(name);
+        this.instances.delete(name);
+        return existed;
+    }
+    /**
+     * Check if a capability is registered
+     */
+    has(name) {
+        return this.modules.has(name);
+    }
+    /**
+     * List all registered capability names
+     */
+    list() {
+        return Array.from(this.modules.keys());
+    }
+    /**
+     * Check if a capability has been loaded (instantiated)
+     */
+    isLoaded(name) {
+        return this.instances.has(name);
+    }
+    /**
+     * Get a capability instance, lazily loading if needed
+     * Handles both sync modules and async factories
+     */
+    get(name) {
+        // Return cached instance if available
+        if (this.instances.has(name)) {
+            return this.instances.get(name);
+        }
+        const registered = this.modules.get(name);
+        if (!registered) {
+            const available = this.list();
+            const availableStr = available.length > 0 ? `Available capabilities: ${available.join(', ')}` : 'No capabilities registered';
+            throw new CapabilityError(name, 'not_available', `Capability '${name}' is not registered. ${availableStr}`);
+        }
+        // Handle async factory - return a promise-like proxy
+        if (registered.type === 'factory' && registered.factory) {
+            return this.loadFactory(name, registered);
+        }
+        // Handle sync module constructor
+        if (registered.type === 'module' && registered.module) {
+            return this.loadModule(name, registered);
+        }
+        throw new CapabilityError(name, 'load_failed', `Invalid capability registration for '${name}'`);
+    }
+    /**
+     * Load a module constructor synchronously
+     */
+    loadModule(name, registered) {
+        const Module = registered.module;
+        let instance;
+        if (registered.options.passContext) {
+            instance = new Module({ registry: this });
+        }
+        else {
+            instance = new Module();
+        }
+        this.instances.set(name, instance);
+        return instance;
+    }
+    /**
+     * Load an async factory
+     * Returns a proxy that awaits the factory on method calls
+     */
+    loadFactory(name, registered) {
+        const factory = registered.factory;
+        const registry = this;
+        // Create a lazy-loading proxy for async factory
+        let instancePromise = null;
+        let resolvedInstance = undefined;
+        let isResolved = false;
+        const getOrCreateInstance = async () => {
+            if (isResolved)
+                return resolvedInstance;
+            if (!instancePromise) {
+                instancePromise = factory().then((inst) => {
+                    resolvedInstance = inst;
+                    isResolved = true;
+                    registry.instances.set(name, inst);
+                    return inst;
+                });
+            }
+            return instancePromise;
+        };
+        // Return a proxy that handles method calls
+        return new Proxy({}, {
+            get(_, prop) {
+                if (typeof prop !== 'string')
+                    return undefined;
+                // Return an async function that awaits the instance and calls the method
+                return async (...args) => {
+                    const instance = await getOrCreateInstance();
+                    const method = instance[prop];
+                    if (typeof method === 'function') {
+                        return method.apply(instance, args);
+                    }
+                    return method;
+                };
+            },
+        });
+    }
+    /**
+     * Destroy the registry, cleaning up all loaded capabilities
+     */
+    async destroy() {
+        const errors = [];
+        for (const [name, instance] of this.instances) {
+            try {
+                await this.disposeInstance(instance);
+            }
+            catch (error) {
+                errors.push({
+                    capability: name,
+                    error: error instanceof Error ? error : new Error(String(error)),
+                });
+            }
+        }
+        // Clear all cached instances
+        this.instances.clear();
+        return { errors };
+    }
+    /**
+     * Dispose a single instance, checking for dispose methods
+     */
+    async disposeInstance(instance) {
+        if (!instance || typeof instance !== 'object')
+            return;
+        const obj = instance;
+        // Check for Symbol.dispose first (explicit cleanup)
+        if (typeof obj[Symbol.dispose] === 'function') {
+            ;
+            obj[Symbol.dispose]();
+            return;
+        }
+        // Check for dispose method
+        if (typeof obj.dispose === 'function') {
+            await obj.dispose();
+            return;
+        }
+    }
+}
+// ============================================================================
+// CAPABILITY PROXY
+// ============================================================================
+/**
+ * Create a proxy for accessing capabilities on the workflow context
+ */
+export function createCapabilityProxy(registry, options = {}) {
+    const { reservedNames = [] } = options;
+    return new Proxy({}, {
+        get(_target, prop) {
+            if (typeof prop !== 'string')
+                return undefined;
+            // Reserved names return undefined instead of throwing
+            if (reservedNames.includes(prop)) {
+                return undefined;
+            }
+            return registry.get(prop);
+        },
+        has(_target, prop) {
+            if (typeof prop !== 'string')
+                return false;
+            return registry.has(prop);
+        },
+        ownKeys() {
+            return registry.list();
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (typeof prop !== 'string')
+                return undefined;
+            if (registry.has(prop)) {
+                return {
+                    configurable: true,
+                    enumerable: true,
+                    writable: false,
+                    value: registry.get(prop),
+                };
+            }
+            return undefined;
+        },
+    });
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/lib/capabilities.js.map

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

package/dist/lib/channels/base.js

@@ -0,0 +1,106 @@
+/**
+ * Base Channel Infrastructure
+ *
+ * Provides abstract base class and utilities for channel implementations.
+ */
+// ============================================================================
+// ABSTRACT BASE CLASS
+// ============================================================================
+/**
+ * Abstract base class for channel implementations
+ *
+ * Provides common functionality:
+ * - Channel name and type identification
+ * - Message ID generation
+ * - Timeout utilities
+ *
+ * Note: Existing channels don't need to extend this class - it's provided
+ * for future implementations and as a reference implementation.
+ */
+export class BaseChannel {
+    /** Channel display name */
+    name;
+    /** Channel type identifier */
+    type;
+    /** Channel configuration */
+    config;
+    constructor(config, name, type) {
+        this.config = config;
+        this.name = name;
+        this.type = type;
+    }
+    /**
+     * Generate a unique message ID
+     */
+    generateMessageId() {
+        return `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Wrap a promise with a timeout
+     *
+     * @param promise - The promise to wrap
+     * @param timeoutMs - Timeout in milliseconds
+     * @param errorMessage - Error message on timeout
+     */
+    withTimeout(promise, timeoutMs, errorMessage = 'Operation timed out') {
+        return Promise.race([
+            promise,
+            new Promise((_, reject) => setTimeout(() => reject(new Error(errorMessage)), timeoutMs)),
+        ]);
+    }
+}
+/**
+ * Abstract base class for channels that support interactive responses
+ */
+export class InteractiveBaseChannel extends BaseChannel {
+}
+// ============================================================================
+// UTILITY FUNCTIONS
+// ============================================================================
+/**
+ * Generate a unique message ID
+ * Standalone function for channels that don't extend BaseChannel
+ */
+export function generateMessageId() {
+    return `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * Wrap a promise with a timeout
+ * Standalone function for channels that don't extend BaseChannel
+ *
+ * @param promise - The promise to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @param errorMessage - Error message on timeout
+ */
+export function withTimeout(promise, timeoutMs, errorMessage = 'Operation timed out') {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(errorMessage)), timeoutMs)),
+    ]);
+}
+/**
+ * Parse action ID format used by Slack/Discord: "action_requestId"
+ *
+ * @param actionId - The action ID string (e.g., "approve_req-123")
+ * @returns Parsed action and requestId
+ */
+export function parseActionId(actionId) {
+    const underscoreIndex = actionId.indexOf('_');
+    if (underscoreIndex > -1) {
+        return {
+            action: actionId.substring(0, underscoreIndex),
+            requestId: actionId.substring(underscoreIndex + 1),
+        };
+    }
+    return { action: actionId };
+}
+/**
+ * Build action ID from action and requestId
+ *
+ * @param action - The action name
+ * @param requestId - The request ID
+ */
+export function buildActionId(action, requestId) {
+    return `${action}_${requestId}`;
+}
+//# sourceMappingURL=base.js.map

package/dist/lib/channels/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../lib/channels/base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,OAAgB,WAAW;IAK/B,2BAA2B;IACX,IAAI,CAAQ;IAE5B,8BAA8B;IACd,IAAI,CAAa;IAEjC,4BAA4B;IAClB,MAAM,CAAS;IAEzB,YAAY,MAAe,EAAE,IAAY,EAAE,IAAiB;QAC1D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAOD;;OAEG;IACO,iBAAiB;QACzB,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;IACvE,CAAC;IAED;;;;;;OAMG;IACO,WAAW,CACnB,OAAmB,EACnB,SAAiB,EACjB,YAAY,GAAG,qBAAqB;QAEpC,OAAO,OAAO,CAAC,IAAI,CAAC;YAClB,OAAO;YACP,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC3B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,CAC7D;SACF,CAAC,CAAA;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAgB,sBAKpB,SAAQ,WAAuC;CAKhD;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;AACvE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,OAAmB,EACnB,SAAiB,EACjB,YAAY,GAAG,qBAAqB;IAEpC,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,OAAO;QACP,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC3B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,CAC7D;KACF,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC7C,IAAI,eAAe,GAAG,CAAC,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,eAAe,CAAC;YAC9C,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,eAAe,GAAG,CAAC,CAAC;SACnD,CAAA;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,SAAiB;IAC7D,OAAO,GAAG,MAAM,IAAI,SAAS,EAAE,CAAA;AACjC,CAAC"}

package/dist/lib/channels/discord.js

@@ -0,0 +1,94 @@
+/**
+ * Discord Webhook Channel Adapter
+ */
+import { buildActionId } from './base';
+export function buildEmbed(options) {
+    const embed = {
+        title: options.title,
+        description: options.description,
+    };
+    if (options.color !== undefined) {
+        embed.color = options.color;
+    }
+    if (options.fields) {
+        embed.fields = options.fields;
+    }
+    if (options.timestamp) {
+        embed.timestamp = new Date().toISOString();
+    }
+    return embed;
+}
+const BUTTON_STYLES = {
+    primary: 1,
+    secondary: 2,
+    success: 3,
+    danger: 4,
+    link: 5,
+};
+export function buildActionRow(options) {
+    const components = options.actions.map(action => {
+        const button = {
+            type: 2,
+            label: action.label,
+            style: BUTTON_STYLES[action.style] || 2,
+        };
+        if (action.style === 'link') {
+            button.url = action.value;
+        }
+        else {
+            button.custom_id = buildActionId(action.value, options.requestId);
+        }
+        return button;
+    });
+    return {
+        type: 1,
+        components,
+    };
+}
+const EMOJI_ACTION_MAP = {
+    '\u2705': 'approve', // check mark
+    '\u274C': 'reject', // cross mark
+    '\uD83D\uDC4D': 'approve', // thumbs up
+    '\uD83D\uDC4E': 'reject', // thumbs down
+};
+export class DiscordChannel {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async send(payload) {
+        let content = payload.message;
+        if (payload.mentions && payload.mentions.length > 0) {
+            content = `${payload.mentions.join(' ')} ${content}`;
+        }
+        const body = {
+            content,
+        };
+        if (payload.embeds) {
+            body.embeds = payload.embeds;
+        }
+        if (payload.components) {
+            body.components = payload.components;
+        }
+        const response = await fetch(this.config.webhookUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        const data = await response.json();
+        return {
+            delivered: true,
+            messageId: data.id,
+        };
+    }
+    async handleReaction(reaction) {
+        const action = EMOJI_ACTION_MAP[reaction.emoji.name] || 'unknown';
+        return {
+            action,
+            userId: reaction.user_id,
+        };
+    }
+}
+//# sourceMappingURL=discord.js.map

package/dist/lib/channels/discord.js.map

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