crewly 1.20.131 → 1.20.133

package/dist/cli/backend/src/services/cloud/cloud-device-pairing.client.js

@@ -0,0 +1,228 @@
+/**
+ * Cloud device-code pairing client.
+ *
+ * Talks to crewly-auth's `/api/cloud/device/*` endpoints so this machine can
+ * sign in to the owner's Crewly account without anyone at it:
+ *
+ * 1. {@link startCloudDevicePairing} — get a secret `deviceCode`, a short
+ *    `userCode` (`ABCD-2345`) and the link the owner opens
+ *    (`crewlyai.com/cloud/pair?code=ABCD-2345`).
+ * 2. {@link waitForCloudDeviceApproval} — poll at the Cloud's interval
+ *    (backing off on `slow_down` and rate limits) until the owner approves,
+ *    denies, or the pairing expires. On approval the Cloud hands over the
+ *    token pair exactly once.
+ *
+ * Shared by `crewly cloud login` (CLI) and {@link CloudDevicePairingService}
+ * (backend, for `/setup` and Settings → Cloud). No state; the device code
+ * never leaves the caller's memory.
+ *
+ * @module services/cloud/cloud-device-pairing.client
+ */
+import { CLOUD_DEVICE_PAIRING_CONSTANTS } from '../../../../config/constants.js';
+const C = CLOUD_DEVICE_PAIRING_CONSTANTS;
+/** Milliseconds per second. */
+const MS_PER_S = 1000;
+/** HTTP 429. */
+const HTTP_TOO_MANY_REQUESTS = 429;
+/** Lowest HTTP status treated as a server-side (retryable) failure. */
+const HTTP_SERVER_ERROR_MIN = 500;
+/** A request the Cloud refused (or could not answer). */
+export class DevicePairingError extends Error {
+    status;
+    retryable;
+    /**
+     * @param message - Human-readable reason (never contains a secret)
+     * @param status - HTTP status, 0 when the Cloud was unreachable
+     * @param retryable - True for network errors, 5xx and 429
+     */
+    constructor(message, status, retryable) {
+        super(message);
+        this.status = status;
+        this.retryable = retryable;
+        this.name = 'DevicePairingError';
+    }
+}
+/**
+ * POST JSON to crewly-auth and unwrap `{ success, data }`.
+ *
+ * @param fetchImpl - fetch
+ * @param url - Absolute URL
+ * @param body - JSON body
+ * @returns `data`
+ * @throws DevicePairingError on transport errors and non-success replies
+ */
+async function postJson(fetchImpl, url, body) {
+    let response;
+    try {
+        response = await fetchImpl(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(C.REQUEST_TIMEOUT_MS),
+        });
+    }
+    catch (err) {
+        throw new DevicePairingError(`Crewly Cloud unreachable: ${err instanceof Error ? err.message : String(err)}`, 0, true);
+    }
+    let parsed = {};
+    try {
+        parsed = (await response.json());
+    }
+    catch {
+        // handled below
+    }
+    if (!response.ok || !parsed.success || parsed.data === undefined) {
+        const retryable = response.status === HTTP_TOO_MANY_REQUESTS || response.status >= HTTP_SERVER_ERROR_MIN;
+        throw new DevicePairingError(parsed.error || `Crewly Cloud returned HTTP ${response.status}`, response.status, retryable);
+    }
+    return parsed.data;
+}
+/**
+ * Join the Cloud base URL and an endpoint path.
+ *
+ * @param cloudUrl - Cloud API base URL
+ * @param path - Endpoint path
+ * @returns Absolute URL
+ */
+function endpoint(cloudUrl, path) {
+    return `${cloudUrl.replace(/\/+$/, '')}${path}`;
+}
+/**
+ * Ask the Cloud for a pairing.
+ *
+ * @param cloudUrl - Cloud API base URL (e.g. https://api.crewlyai.com)
+ * @param input - How the device introduces itself on the approve page
+ * @param fetchImpl - fetch (tests)
+ * @returns Device code, user code, link, lifetime and interval
+ * @throws DevicePairingError when the Cloud refuses or is unreachable
+ */
+export async function startCloudDevicePairing(cloudUrl, input, fetchImpl = fetch) {
+    const data = await postJson(fetchImpl, endpoint(cloudUrl, C.CLOUD_ENDPOINTS.START), input);
+    if (!data.deviceCode || !data.userCode || !data.verificationUrl) {
+        throw new DevicePairingError('Crewly Cloud returned an incomplete pairing', 0, false);
+    }
+    return {
+        deviceCode: data.deviceCode,
+        userCode: data.userCode,
+        verificationUrl: data.verificationUrl,
+        ...(data.verificationUri ? { verificationUri: data.verificationUri } : {}),
+        expiresIn: typeof data.expiresIn === 'number' ? data.expiresIn : C.DEFAULT_EXPIRES_IN_S,
+        interval: typeof data.interval === 'number' ? data.interval : C.DEFAULT_INTERVAL_S,
+    };
+}
+/**
+ * Poll a pairing once.
+ *
+ * @param cloudUrl - Cloud API base URL
+ * @param deviceCode - Secret from {@link startCloudDevicePairing}
+ * @param fetchImpl - fetch (tests)
+ * @returns The Cloud's answer
+ * @throws DevicePairingError when the request fails (see `retryable`)
+ */
+export async function pollCloudDevicePairing(cloudUrl, deviceCode, fetchImpl = fetch) {
+    const data = await postJson(fetchImpl, endpoint(cloudUrl, C.CLOUD_ENDPOINTS.POLL), { deviceCode });
+    switch (data.status) {
+        case C.POLL_STATUS.APPROVED:
+            if (!data.token || !data.refreshToken) {
+                throw new DevicePairingError('Crewly Cloud approved the device but sent no tokens', 0, false);
+            }
+            return {
+                status: 'approved',
+                credentials: { token: data.token, refreshToken: data.refreshToken, tier: data.tier || 'free', ...(data.email ? { email: data.email } : {}) },
+            };
+        case C.POLL_STATUS.PENDING:
+        case C.POLL_STATUS.SLOW_DOWN:
+            return { status: data.status, ...(typeof data.interval === 'number' ? { interval: data.interval } : {}) };
+        case C.POLL_STATUS.DENIED:
+            return { status: 'denied' };
+        case C.POLL_STATUS.EXPIRED:
+            return { status: 'expired' };
+        default:
+            throw new DevicePairingError(`Unexpected pairing status: ${String(data.status)}`, 0, false);
+    }
+}
+/**
+ * Wait `ms`, resolving early when `signal` aborts.
+ *
+ * @param ms - Milliseconds
+ * @param signal - Optional abort signal
+ * @returns Resolves after the delay or on abort
+ */
+export function abortableSleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/**
+ * Poll until the owner approves or denies, or the pairing expires.
+ *
+ * Honours the Cloud's interval, adds {@link CLOUD_DEVICE_PAIRING_CONSTANTS.SLOW_DOWN_INCREMENT_S}
+ * on `slow_down` / HTTP 429 (capped), and rides out up to
+ * {@link CLOUD_DEVICE_PAIRING_CONSTANTS.MAX_CONSECUTIVE_POLL_ERRORS} network
+ * or server errors in a row (a laptop changing Wi-Fi mid-login).
+ *
+ * @param options - Cloud URL, the started pairing and hooks
+ * @returns How it ended; `approved` carries the token pair
+ * @throws DevicePairingError on a non-retryable refusal or too many errors in a row
+ */
+export async function waitForCloudDeviceApproval(options) {
+    const { cloudUrl, start, signal, onPoll } = options;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const sleep = options.sleep ?? abortableSleep;
+    const now = options.now ?? (() => Date.now());
+    const deadline = now() + start.expiresIn * MS_PER_S;
+    let intervalS = Math.max(1, start.interval || C.DEFAULT_INTERVAL_S);
+    let consecutiveErrors = 0;
+    for (;;) {
+        await sleep(intervalS * MS_PER_S, signal);
+        if (signal?.aborted)
+            return { status: 'cancelled' };
+        if (now() >= deadline)
+            return { status: 'expired' };
+        let result;
+        try {
+            result = await pollCloudDevicePairing(cloudUrl, start.deviceCode, fetchImpl);
+            consecutiveErrors = 0;
+        }
+        catch (err) {
+            if (!(err instanceof DevicePairingError) || !err.retryable)
+                throw err;
+            consecutiveErrors++;
+            if (consecutiveErrors > C.MAX_CONSECUTIVE_POLL_ERRORS)
+                throw err;
+            if (err.status === HTTP_TOO_MANY_REQUESTS) {
+                intervalS = Math.min(C.MAX_INTERVAL_S, intervalS + C.SLOW_DOWN_INCREMENT_S);
+            }
+            continue;
+        }
+        if (signal?.aborted)
+            return { status: 'cancelled' };
+        onPoll?.(result.status, intervalS);
+        switch (result.status) {
+            case 'approved':
+                return result;
+            case 'expired':
+            case 'denied':
+                return { status: result.status };
+            case 'slow_down':
+                intervalS = Math.min(C.MAX_INTERVAL_S, result.interval ?? intervalS + C.SLOW_DOWN_INCREMENT_S);
+                break;
+            default:
+                if (typeof result.interval === 'number')
+                    intervalS = Math.min(C.MAX_INTERVAL_S, Math.max(1, result.interval));
+        }
+    }
+}
+//# sourceMappingURL=cloud-device-pairing.client.js.map

package/dist/cli/backend/src/services/cloud/cloud-device-pairing.client.js.map

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

package/dist/cli/backend/src/services/marketplace/marketplace.service.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Marketplace Service
+ *
+ * Handles fetching the marketplace registry from the Crewly webapp API,
+ * managing the local installed-items manifest, and enriching items
+ * with install status information.
+ *
+ * @module services/marketplace/marketplace.service
+ */
+import { MarketplaceRegistry, MarketplaceItemWithStatus, MarketplaceFilter, InstalledItemsManifest, InstalledItemRecord, type MarketplaceItemType } from '../../types/marketplace.types.js';
+/**
+ * Fetches the marketplace registry from the Crewly webapp API.
+ * Uses in-memory caching with a 1-hour TTL. Concurrent callers share
+ * the same in-flight request to avoid duplicate network fetches.
+ *
+ * On network failure, falls back to the previously cached registry
+ * if one is available. Throws only when no cached data exists.
+ *
+ * @param forceRefresh - If true, bypasses the cache and fetches fresh data
+ * @returns The marketplace registry containing all available items
+ * @throws Error if the fetch fails and no cached registry is available
+ */
+export declare function fetchRegistry(forceRefresh?: boolean): Promise<MarketplaceRegistry>;
+/**
+ * Loads the locally installed items manifest from disk.
+ *
+ * Returns an empty manifest (schemaVersion 1, no items) if the
+ * manifest file does not exist or cannot be parsed.
+ *
+ * @returns The installed items manifest
+ */
+export declare function loadManifest(): Promise<InstalledItemsManifest>;
+/**
+ * Saves the installed items manifest to disk.
+ *
+ * Creates the marketplace directory if it does not exist.
+ *
+ * @param manifest - The manifest to persist
+ */
+export declare function saveManifest(manifest: InstalledItemsManifest): Promise<void>;
+/**
+ * Returns a single marketplace item by ID, enriched with install status.
+ *
+ * @param id - The marketplace item ID to look up
+ * @returns The item with install status, or null if not found in the registry
+ */
+export declare function getItem(id: string): Promise<MarketplaceItemWithStatus | null>;
+/**
+ * Lists marketplace items with optional filtering, enriched with install status.
+ *
+ * Supports filtering by type, category, and free-text search (matches name,
+ * description, and tags). Results are sorted by the specified sort option,
+ * defaulting to most popular (highest downloads).
+ *
+ * @param filter - Optional filter and sort criteria
+ * @returns Filtered and sorted list of items with install status
+ */
+export declare function listItems(filter?: MarketplaceFilter): Promise<MarketplaceItemWithStatus[]>;
+/**
+ * Returns marketplace items that have updates available.
+ *
+ * An item has an update available when the installed version differs
+ * from the latest version in the registry.
+ *
+ * @returns Items with installStatus 'update_available'
+ */
+export declare function getUpdatableItems(): Promise<MarketplaceItemWithStatus[]>;
+/**
+ * Returns locally installed items from the manifest.
+ *
+ * @returns Array of installed item records
+ */
+export declare function getInstalledItems(): Promise<InstalledItemRecord[]>;
+/**
+ * Searches marketplace items by query string.
+ *
+ * Convenience wrapper around listItems with a search filter.
+ *
+ * @param query - Free-text search query
+ * @returns Matching items with install status
+ */
+export declare function searchItems(query: string): Promise<MarketplaceItemWithStatus[]>;
+export declare function getInstallPath(type: MarketplaceItemType, id: string): string;
+/**
+ * Retrieves the README.md content for a marketplace item.
+ *
+ * Looks for a README.md file in the item's install directory. Tries multiple
+ * filenames (README.md, readme.md, SKILL.md) for flexibility.
+ *
+ * @param id - The marketplace item ID
+ * @returns The README content as a string, or null if not found
+ * @throws Error if the item ID is invalid (path traversal protection)
+ */
+export declare function getItemReadme(id: string): Promise<string | null>;
+/**
+ * Resets the in-memory registry cache.
+ *
+ * Used primarily for testing to ensure a clean state between test runs.
+ */
+export declare function resetRegistryCache(): void;
+//# sourceMappingURL=marketplace.service.d.ts.map

package/dist/cli/backend/src/services/marketplace/marketplace.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/marketplace/marketplace.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EACL,mBAAmB,EAEnB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,mBAAmB,EACzB,MAAM,kCAAkC,CAAC;AAyB1C;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuBtF;AAwID;;;;;;;GAOG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAOpE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlF;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAOnF;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAuChG;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAG9E;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAGxE;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAErF;AA2CD,wBAAgB,cAAc,CAAC,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsBtE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC"}