crewly 1.5.17 → 1.5.19

package/dist/backend/backend/src/services/provisioning/deployment-orchestrator.types.js

@@ -0,0 +1,84 @@
+/**
+ * Deployment Orchestrator Types
+ *
+ * Type definitions for the deployment orchestration pipeline that bridges
+ * DigitalOcean provisioning with the Crewly node setup scripts.
+ *
+ * @module services/provisioning/deployment-orchestrator.types
+ */
+// ---------------------------------------------------------------------------
+// Deployment Phases
+// ---------------------------------------------------------------------------
+/** Ordered phases of a full-stack deployment. */
+export var DeploymentPhase;
+(function (DeploymentPhase) {
+    DeploymentPhase["CREATING_DROPLET"] = "CREATING_DROPLET";
+    DeploymentPhase["WAITING_FOR_DROPLET"] = "WAITING_FOR_DROPLET";
+    DeploymentPhase["PROVISIONING_BASE"] = "PROVISIONING_BASE";
+    DeploymentPhase["INSTALLING_OSS"] = "INSTALLING_OSS";
+    DeploymentPhase["INSTALLING_PRO"] = "INSTALLING_PRO";
+    DeploymentPhase["CONFIGURING_ACCOUNT"] = "CONFIGURING_ACCOUNT";
+    DeploymentPhase["CONNECTING_CLOUD"] = "CONNECTING_CLOUD";
+    DeploymentPhase["READY"] = "READY";
+    DeploymentPhase["FAILED"] = "FAILED";
+})(DeploymentPhase || (DeploymentPhase = {}));
+/** Phases in execution order (excludes terminal states). */
+export const DEPLOYMENT_PHASE_ORDER = [
+    DeploymentPhase.CREATING_DROPLET,
+    DeploymentPhase.WAITING_FOR_DROPLET,
+    DeploymentPhase.PROVISIONING_BASE,
+    DeploymentPhase.INSTALLING_OSS,
+    DeploymentPhase.INSTALLING_PRO,
+    DeploymentPhase.CONFIGURING_ACCOUNT,
+    DeploymentPhase.CONNECTING_CLOUD,
+    DeploymentPhase.READY,
+];
+/**
+ * Custom error for deployment failures with phase context.
+ */
+export class DeploymentError extends Error {
+    /** Structured error code. */
+    code;
+    /** Phase where the failure occurred. */
+    phase;
+    /** Associated deployment ID. */
+    deploymentId;
+    constructor(code, message, phase, deploymentId) {
+        super(message);
+        this.name = 'DeploymentError';
+        this.code = code;
+        this.phase = phase;
+        this.deploymentId = deploymentId;
+    }
+}
+// ---------------------------------------------------------------------------
+// Type Guards
+// ---------------------------------------------------------------------------
+/**
+ * Check whether a string is a valid DeploymentPhase.
+ *
+ * @param value - Value to check
+ * @returns True if value is a valid DeploymentPhase
+ */
+export function isDeploymentPhase(value) {
+    return typeof value === 'string' && Object.values(DeploymentPhase).includes(value);
+}
+/**
+ * Check whether a value is a DeploymentError.
+ *
+ * @param value - Value to check
+ * @returns True if value is a DeploymentError
+ */
+export function isDeploymentError(value) {
+    return value instanceof DeploymentError;
+}
+/**
+ * Check whether a deployment phase is a terminal state.
+ *
+ * @param phase - Phase to check
+ * @returns True if the phase is READY or FAILED
+ */
+export function isTerminalPhase(phase) {
+    return phase === DeploymentPhase.READY || phase === DeploymentPhase.FAILED;
+}
+//# sourceMappingURL=deployment-orchestrator.types.js.map

package/dist/backend/backend/src/services/provisioning/deployment-orchestrator.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-orchestrator.types.js","sourceRoot":"","sources":["../../../../../../backend/src/services/provisioning/deployment-orchestrator.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,iDAAiD;AACjD,MAAM,CAAN,IAAY,eAUX;AAVD,WAAY,eAAe;IACzB,wDAAqC,CAAA;IACrC,8DAA2C,CAAA;IAC3C,0DAAuC,CAAA;IACvC,oDAAiC,CAAA;IACjC,oDAAiC,CAAA;IACjC,8DAA2C,CAAA;IAC3C,wDAAqC,CAAA;IACrC,kCAAe,CAAA;IACf,oCAAiB,CAAA;AACnB,CAAC,EAVW,eAAe,KAAf,eAAe,QAU1B;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAA+B;IAChE,eAAe,CAAC,gBAAgB;IAChC,eAAe,CAAC,mBAAmB;IACnC,eAAe,CAAC,iBAAiB;IACjC,eAAe,CAAC,cAAc;IAC9B,eAAe,CAAC,cAAc;IAC9B,eAAe,CAAC,mBAAmB;IACnC,eAAe,CAAC,gBAAgB;IAChC,eAAe,CAAC,KAAK;CACb,CAAC;AAuJX;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,6BAA6B;IACpB,IAAI,CAAsB;IACnC,wCAAwC;IAC/B,KAAK,CAAkB;IAChC,gCAAgC;IACvB,YAAY,CAAU;IAE/B,YAAY,IAAyB,EAAE,OAAe,EAAE,KAAsB,EAAE,YAAqB;QACnG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,KAAwB,CAAC,CAAC;AACxG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,YAAY,eAAe,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,OAAO,KAAK,KAAK,eAAe,CAAC,KAAK,IAAI,KAAK,KAAK,eAAe,CAAC,MAAM,CAAC;AAC7E,CAAC"}

package/dist/backend/backend/src/services/provisioning/deployment-status.service.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Deployment Status Service
+ *
+ * Tracks deployment progress through phases with real-time event emission.
+ * Stores deployment history in-memory keyed by deploymentId. Emits events
+ * via EventEmitter for real-time status updates (SSE, WebSocket, etc.).
+ *
+ * @module services/provisioning/deployment-status.service
+ */
+import { EventEmitter } from 'node:events';
+import { DeploymentPhase, type DeploymentConfig } from './deployment-orchestrator.types.js';
+/** Event name for deployment status updates. */
+export declare const DEPLOYMENT_STATUS_EVENT = "deployment:status";
+/** Event name for deployment completion. */
+export declare const DEPLOYMENT_COMPLETE_EVENT = "deployment:complete";
+/** A single status update entry for a deployment phase. */
+export interface DeploymentStatusEntry {
+    /** Phase this update relates to. */
+    phase: DeploymentPhase;
+    /** Human-readable message. */
+    message: string;
+    /** ISO 8601 timestamp of the update. */
+    timestamp: string;
+}
+/** Full deployment status record. */
+export interface DeploymentStatusRecord {
+    /** Unique deployment identifier. */
+    deploymentId: string;
+    /** Current phase. */
+    currentPhase: DeploymentPhase;
+    /** Whether the deployment has finished (READY or FAILED). */
+    isComplete: boolean;
+    /** Droplet name from the original config. */
+    dropletName: string;
+    /** Customer ID if provided. */
+    customerId?: string;
+    /** Ordered list of status updates. */
+    updates: DeploymentStatusEntry[];
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+    /** ISO 8601 last update timestamp. */
+    updatedAt: string;
+}
+/** Payload emitted with status events. */
+export interface DeploymentStatusEventPayload {
+    /** Deployment identifier. */
+    deploymentId: string;
+    /** Phase that was updated. */
+    phase: DeploymentPhase;
+    /** Human-readable message. */
+    message: string;
+    /** Whether the deployment is now complete. */
+    isComplete: boolean;
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+}
+/**
+ * Tracks and emits real-time deployment status updates.
+ *
+ * Uses an in-memory Map for storage and Node.js EventEmitter for
+ * real-time notifications. Suitable for single-process deployments;
+ * for multi-process, back with Redis pub/sub.
+ *
+ * @example
+ * ```typescript
+ * const statusService = new DeploymentStatusService();
+ *
+ * statusService.on(DEPLOYMENT_STATUS_EVENT, (payload) => {
+ *   console.log(`[${payload.deploymentId}] ${payload.phase}: ${payload.message}`);
+ * });
+ *
+ * statusService.createDeployment('deploy-1', { dropletName: 'node-1' });
+ * statusService.updatePhase('deploy-1', DeploymentPhase.CREATING_DROPLET, 'Creating...');
+ * ```
+ */
+export declare class DeploymentStatusService extends EventEmitter {
+    private readonly deployments;
+    /**
+     * Create a new DeploymentStatusService.
+     */
+    constructor();
+    /**
+     * Initialize tracking for a new deployment.
+     *
+     * @param deploymentId - Unique deployment identifier
+     * @param config - Deployment configuration (for metadata)
+     * @returns The created status record
+     */
+    createDeployment(deploymentId: string, config: Pick<DeploymentConfig, 'dropletName' | 'customerId'>): DeploymentStatusRecord;
+    /**
+     * Update the phase and status of an existing deployment.
+     *
+     * @param deploymentId - Deployment identifier
+     * @param phase - New deployment phase
+     * @param message - Human-readable status message
+     * @returns Updated status record, or undefined if deployment not found
+     */
+    updatePhase(deploymentId: string, phase: DeploymentPhase, message: string): DeploymentStatusRecord | undefined;
+    /**
+     * Get the current status of a deployment.
+     *
+     * @param deploymentId - Deployment identifier
+     * @returns Status record, or undefined if not found
+     */
+    getDeploymentStatus(deploymentId: string): DeploymentStatusRecord | undefined;
+    /**
+     * List all tracked deployments, optionally filtered.
+     *
+     * @param filter - Optional filter criteria
+     * @param filter.isComplete - Filter by completion status
+     * @param filter.customerId - Filter by customer ID
+     * @returns Array of matching deployment status records
+     */
+    listDeployments(filter?: {
+        isComplete?: boolean;
+        customerId?: string;
+    }): DeploymentStatusRecord[];
+    /**
+     * Remove a deployment record from the in-memory store.
+     *
+     * @param deploymentId - Deployment identifier
+     * @returns True if the deployment was found and removed
+     */
+    removeDeployment(deploymentId: string): boolean;
+    /**
+     * Get the total number of tracked deployments.
+     *
+     * @returns Count of deployment records
+     */
+    getDeploymentCount(): number;
+    /**
+     * Clear all deployment records. Useful for testing.
+     */
+    clearAll(): void;
+    /**
+     * Emit a status event for real-time listeners.
+     *
+     * @param deploymentId - Deployment identifier
+     * @param phase - Current phase
+     * @param message - Status message
+     * @param isComplete - Whether the deployment is complete
+     */
+    private emitStatusEvent;
+    /**
+     * Enforce the maximum history limit by removing oldest completed deployments.
+     */
+    private enforceHistoryLimit;
+}
+//# sourceMappingURL=deployment-status.service.d.ts.map

package/dist/backend/backend/src/services/provisioning/deployment-status.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-status.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/provisioning/deployment-status.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EAEtB,MAAM,oCAAoC,CAAC;AAS5C,gDAAgD;AAChD,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAE3D,4CAA4C;AAC5C,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;AAM/D,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,KAAK,EAAE,eAAe,CAAC;IACvB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,sBAAsB;IACrC,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,YAAY,EAAE,eAAe,CAAC;IAC9B,6DAA6D;IAC7D,UAAU,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0CAA0C;AAC1C,MAAM,WAAW,4BAA4B;IAC3C,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkD;IAE9E;;OAEG;;IAUH;;;;;;OAMG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,YAAY,CAAC,GAAG,sBAAsB;IAyB5H;;;;;;;OAOG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IA2B9G;;;;;OAKG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAI7E;;;;;;;OAOG;IACH,eAAe,CAAC,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,sBAAsB,EAAE;IAcjG;;;;;OAKG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAI/C;;;;OAIG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAe5B"}

package/dist/backend/backend/src/services/provisioning/deployment-status.service.js

@@ -0,0 +1,201 @@
+/**
+ * Deployment Status Service
+ *
+ * Tracks deployment progress through phases with real-time event emission.
+ * Stores deployment history in-memory keyed by deploymentId. Emits events
+ * via EventEmitter for real-time status updates (SSE, WebSocket, etc.).
+ *
+ * @module services/provisioning/deployment-status.service
+ */
+import { EventEmitter } from 'node:events';
+import { DeploymentPhase, isTerminalPhase, } from './deployment-orchestrator.types.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Maximum number of deployments to keep in history. */
+const MAX_DEPLOYMENT_HISTORY = 100;
+/** Event name for deployment status updates. */
+export const DEPLOYMENT_STATUS_EVENT = 'deployment:status';
+/** Event name for deployment completion. */
+export const DEPLOYMENT_COMPLETE_EVENT = 'deployment:complete';
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Tracks and emits real-time deployment status updates.
+ *
+ * Uses an in-memory Map for storage and Node.js EventEmitter for
+ * real-time notifications. Suitable for single-process deployments;
+ * for multi-process, back with Redis pub/sub.
+ *
+ * @example
+ * ```typescript
+ * const statusService = new DeploymentStatusService();
+ *
+ * statusService.on(DEPLOYMENT_STATUS_EVENT, (payload) => {
+ *   console.log(`[${payload.deploymentId}] ${payload.phase}: ${payload.message}`);
+ * });
+ *
+ * statusService.createDeployment('deploy-1', { dropletName: 'node-1' });
+ * statusService.updatePhase('deploy-1', DeploymentPhase.CREATING_DROPLET, 'Creating...');
+ * ```
+ */
+export class DeploymentStatusService extends EventEmitter {
+    deployments = new Map();
+    /**
+     * Create a new DeploymentStatusService.
+     */
+    constructor() {
+        super();
+        this.setMaxListeners(50);
+    }
+    // -----------------------------------------------------------------------
+    // Public API
+    // -----------------------------------------------------------------------
+    /**
+     * Initialize tracking for a new deployment.
+     *
+     * @param deploymentId - Unique deployment identifier
+     * @param config - Deployment configuration (for metadata)
+     * @returns The created status record
+     */
+    createDeployment(deploymentId, config) {
+        const now = new Date().toISOString();
+        const record = {
+            deploymentId,
+            currentPhase: DeploymentPhase.CREATING_DROPLET,
+            isComplete: false,
+            dropletName: config.dropletName,
+            customerId: config.customerId,
+            updates: [{
+                    phase: DeploymentPhase.CREATING_DROPLET,
+                    message: 'Deployment initialized',
+                    timestamp: now,
+                }],
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.deployments.set(deploymentId, record);
+        this.enforceHistoryLimit();
+        this.emitStatusEvent(deploymentId, DeploymentPhase.CREATING_DROPLET, 'Deployment initialized', false);
+        return record;
+    }
+    /**
+     * Update the phase and status of an existing deployment.
+     *
+     * @param deploymentId - Deployment identifier
+     * @param phase - New deployment phase
+     * @param message - Human-readable status message
+     * @returns Updated status record, or undefined if deployment not found
+     */
+    updatePhase(deploymentId, phase, message) {
+        const record = this.deployments.get(deploymentId);
+        if (!record) {
+            return undefined;
+        }
+        const now = new Date().toISOString();
+        const isComplete = isTerminalPhase(phase);
+        record.currentPhase = phase;
+        record.isComplete = isComplete;
+        record.updatedAt = now;
+        record.updates.push({
+            phase,
+            message,
+            timestamp: now,
+        });
+        this.emitStatusEvent(deploymentId, phase, message, isComplete);
+        if (isComplete) {
+            this.emit(DEPLOYMENT_COMPLETE_EVENT, { deploymentId, phase, message });
+        }
+        return record;
+    }
+    /**
+     * Get the current status of a deployment.
+     *
+     * @param deploymentId - Deployment identifier
+     * @returns Status record, or undefined if not found
+     */
+    getDeploymentStatus(deploymentId) {
+        return this.deployments.get(deploymentId);
+    }
+    /**
+     * List all tracked deployments, optionally filtered.
+     *
+     * @param filter - Optional filter criteria
+     * @param filter.isComplete - Filter by completion status
+     * @param filter.customerId - Filter by customer ID
+     * @returns Array of matching deployment status records
+     */
+    listDeployments(filter) {
+        let records = Array.from(this.deployments.values());
+        if (filter?.isComplete !== undefined) {
+            records = records.filter((r) => r.isComplete === filter.isComplete);
+        }
+        if (filter?.customerId) {
+            records = records.filter((r) => r.customerId === filter.customerId);
+        }
+        // Return newest first
+        return records.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    /**
+     * Remove a deployment record from the in-memory store.
+     *
+     * @param deploymentId - Deployment identifier
+     * @returns True if the deployment was found and removed
+     */
+    removeDeployment(deploymentId) {
+        return this.deployments.delete(deploymentId);
+    }
+    /**
+     * Get the total number of tracked deployments.
+     *
+     * @returns Count of deployment records
+     */
+    getDeploymentCount() {
+        return this.deployments.size;
+    }
+    /**
+     * Clear all deployment records. Useful for testing.
+     */
+    clearAll() {
+        this.deployments.clear();
+    }
+    // -----------------------------------------------------------------------
+    // Private Helpers
+    // -----------------------------------------------------------------------
+    /**
+     * Emit a status event for real-time listeners.
+     *
+     * @param deploymentId - Deployment identifier
+     * @param phase - Current phase
+     * @param message - Status message
+     * @param isComplete - Whether the deployment is complete
+     */
+    emitStatusEvent(deploymentId, phase, message, isComplete) {
+        const payload = {
+            deploymentId,
+            phase,
+            message,
+            isComplete,
+            timestamp: new Date().toISOString(),
+        };
+        this.emit(DEPLOYMENT_STATUS_EVENT, payload);
+    }
+    /**
+     * Enforce the maximum history limit by removing oldest completed deployments.
+     */
+    enforceHistoryLimit() {
+        if (this.deployments.size <= MAX_DEPLOYMENT_HISTORY) {
+            return;
+        }
+        // Remove oldest completed deployments first
+        const sorted = Array.from(this.deployments.entries())
+            .filter(([, record]) => record.isComplete)
+            .sort(([, a], [, b]) => a.createdAt.localeCompare(b.createdAt));
+        const toRemove = this.deployments.size - MAX_DEPLOYMENT_HISTORY;
+        for (let i = 0; i < toRemove && i < sorted.length; i++) {
+            this.deployments.delete(sorted[i][0]);
+        }
+    }
+}
+//# sourceMappingURL=deployment-status.service.js.map

package/dist/backend/backend/src/services/provisioning/deployment-status.service.js.map

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

package/dist/backend/backend/src/services/provisioning/provisioning.service.d.ts

@@ -0,0 +1,135 @@
+/**
+ * DigitalOcean Provisioning Service
+ *
+ * Wraps the DigitalOcean REST API v2 for automated Droplet lifecycle
+ * management. Provides create, destroy, status, list, and wait-for-ready
+ * operations with structured error handling.
+ *
+ * All API interactions use the native `fetch` API — no external HTTP
+ * libraries required.
+ *
+ * @module services/provisioning/provisioning.service
+ */
+import { type ProvisioningServiceConfig, type CreateDropletConfig, type DropletInfo, type DropletStatus } from './provisioning.types.js';
+/**
+ * Service for managing DigitalOcean Droplets via the REST API v2.
+ *
+ * @example
+ * ```typescript
+ * const svc = new ProvisioningService({ apiToken: 'dop_v1_xxx' });
+ * const droplet = await svc.createDroplet({ name: 'my-node' });
+ * const ready = await svc.waitForDropletReady(droplet.id);
+ * console.log(ready.networks); // [{ ipAddress: '...', type: 'public' }]
+ * ```
+ */
+export declare class ProvisioningService {
+    private readonly apiToken;
+    private readonly defaultRegion;
+    private readonly defaultSize;
+    /**
+     * Create a new ProvisioningService.
+     *
+     * @param config - Service configuration
+     * @param config.apiToken - DigitalOcean personal access token
+     * @param config.defaultRegion - Default region slug (defaults to nyc1)
+     * @param config.defaultSize - Default size slug (defaults to s-2vcpu-4gb)
+     */
+    constructor(config: ProvisioningServiceConfig);
+    /**
+     * Create a new DigitalOcean Droplet.
+     *
+     * The Droplet is always tagged with the `crewly-pro` tag. Additional tags
+     * may be specified via `config.tags`.
+     *
+     * @param config - Droplet creation configuration
+     * @returns Normalized Droplet info after creation (status will be 'new')
+     * @throws {ProvisioningError} On API failure
+     *
+     * @example
+     * ```typescript
+     * const info = await svc.createDroplet({
+     *   name: 'worker-1',
+     *   region: 'sfo3',
+     *   userData: '#!/bin/bash\napt-get update',
+     * });
+     * ```
+     */
+    createDroplet(config: CreateDropletConfig): Promise<DropletInfo>;
+    /**
+     * Destroy (permanently delete) a Droplet by ID.
+     *
+     * @param dropletId - The Droplet ID to destroy
+     * @throws {ProvisioningError} On API failure (e.g. NOT_FOUND)
+     */
+    destroyDroplet(dropletId: number): Promise<void>;
+    /**
+     * Get the current status of a Droplet.
+     *
+     * @param dropletId - The Droplet ID to query
+     * @returns The Droplet's current status
+     * @throws {ProvisioningError} On API failure
+     */
+    getDropletStatus(dropletId: number): Promise<DropletStatus>;
+    /**
+     * List Droplets, optionally filtered by tag.
+     *
+     * @param tag - Tag to filter by (defaults to listing all Droplets)
+     * @returns Array of normalized Droplet info objects
+     * @throws {ProvisioningError} On API failure
+     */
+    listDroplets(tag?: string): Promise<DropletInfo[]>;
+    /**
+     * Poll until a Droplet reaches the 'active' status.
+     *
+     * @param dropletId - The Droplet ID to watch
+     * @param timeoutMs - Maximum time to wait in milliseconds (default: 300s)
+     * @returns Normalized Droplet info once active
+     * @throws {ProvisioningError} With code 'TIMEOUT' if the Droplet does not
+     *   become active within the timeout period
+     *
+     * @example
+     * ```typescript
+     * const ready = await svc.waitForDropletReady(droplet.id, 60_000);
+     * ```
+     */
+    waitForDropletReady(dropletId: number, timeoutMs?: number): Promise<DropletInfo>;
+    /**
+     * Make an authenticated request to the DigitalOcean API.
+     *
+     * @param path - API path (e.g. '/droplets')
+     * @param method - HTTP method
+     * @param body - Optional request body (will be JSON-serialized)
+     * @returns Parsed JSON response body
+     * @throws {ProvisioningError} On HTTP errors or network failures
+     */
+    private doRequest;
+    /**
+     * Map an HTTP error response to a structured ProvisioningError.
+     *
+     * @param response - The failed fetch Response
+     * @throws {ProvisioningError} Always throws
+     */
+    private handleErrorResponse;
+    /**
+     * Map an HTTP status code to a ProvisioningErrorCode.
+     *
+     * @param status - HTTP status code
+     * @returns Corresponding error code
+     */
+    private mapHttpStatusToErrorCode;
+    /**
+     * Normalize a raw DO API Droplet object into our DropletInfo shape.
+     *
+     * @param raw - Raw Droplet from the DO API
+     * @returns Normalized DropletInfo
+     */
+    private normalizeDroplet;
+    /**
+     * Sleep for a given number of milliseconds.
+     *
+     * @param ms - Duration in milliseconds
+     * @returns Promise that resolves after the delay
+     */
+    private sleep;
+}
+//# sourceMappingURL=provisioning.service.d.ts.map

package/dist/backend/backend/src/services/provisioning/provisioning.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisioning.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/provisioning/provisioning.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,aAAa,EAgBnB,MAAM,yBAAyB,CAAC;AAMjC;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC;;;;;;;OAOG;gBACS,MAAM,EAAE,yBAAyB;IAa7C;;;;;;;;;;;;;;;;;;OAkBG;IACG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAqBtE;;;;;OAKG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;;;;;OAMG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAYjE;;;;;;OAMG;IACG,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IASxD;;;;;;;;;;;;;OAaG;IACG,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAiC,GAC3C,OAAO,CAAC,WAAW,CAAC;IA0BvB;;;;;;;;OAQG;YACW,SAAS;IAoCvB;;;;;OAKG;YACW,mBAAmB;IAgBjC;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAgBhC;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;;;;OAKG;IACH,OAAO,CAAC,KAAK;CAGd"}