@limrun/api 0.46.1 → 0.46.3

package/xcode-cache.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XcodeCacheTimeoutError = exports.XcodeCacheGoneError = void 0;
+exports.isRestoreTerminal = isRestoreTerminal;
+exports.isRestoreFailure = isRestoreFailure;
+exports.isSaveTerminal = isSaveTerminal;
+exports.isCacheTerminal = isCacheTerminal;
+exports.followXcodeCache = followXcodeCache;
+const eventsource_client_1 = require("eventsource-client");
+const proxy_transport_1 = require("./internal/proxy-transport.js");
+/**
+ * The instance was gone before it said anything about its cache, so there is no last state to
+ * summarise. Distinct from a follow that ends with `gone: true`, which at least saw one.
+ */
+class XcodeCacheGoneError extends Error {
+    constructor(instanceId) {
+        super(`Instance ${instanceId} was gone before it reported any cache status`);
+        this.instanceId = instanceId;
+        this.name = 'XcodeCacheGoneError';
+    }
+}
+exports.XcodeCacheGoneError = XcodeCacheGoneError;
+class XcodeCacheTimeoutError extends Error {
+    constructor(side, timeoutMs, cache) {
+        super(`Timed out after ${Math.round(timeoutMs / 1000)}s waiting for the cache ${side} to finish` +
+            (cache ? ` (last phase: ${cache[side].phase})` : ''));
+        this.side = side;
+        this.timeoutMs = timeoutMs;
+        this.cache = cache;
+        this.name = 'XcodeCacheTimeoutError';
+    }
+}
+exports.XcodeCacheTimeoutError = XcodeCacheTimeoutError;
+const DEFAULT_TIMEOUT_MS = {
+    restore: 20 * 60 * 1000,
+    save: 12 * 60 * 1000,
+};
+/** Phases past which nothing more will happen. */
+function isRestoreTerminal(phase) {
+    return (phase === 'disabled' ||
+        phase === 'unsupported' ||
+        phase === 'restored' ||
+        phase === 'skipped' ||
+        phase === 'failed');
+}
+/**
+ * Separates the one outcome worth reacting to from the terminal phases that just mean "cold,
+ * carry on". A caller that created an instance for a warm workspace deletes it on a failure,
+ * but a fallback to a cold build leaves a perfectly usable instance behind.
+ */
+function isRestoreFailure(phase) {
+    return phase === 'failed';
+}
+function isSaveTerminal(phase) {
+    return (phase === 'disabled' ||
+        phase === 'published' ||
+        phase === 'skipped' ||
+        phase === 'failed' ||
+        phase === 'timed_out');
+}
+function isCacheTerminal(cache, side) {
+    return side === 'restore' ? isRestoreTerminal(cache.restore.phase) : isSaveTerminal(cache.save.phase);
+}
+/**
+ * Follows an instance's cache status until the chosen side reaches a terminal phase, the
+ * instance is collected, or the wait times out.
+ *
+ * The transport is the same endpoint that serves a JSON snapshot, asked for as an event
+ * stream. The server emits on phase change only, so every callback is a real transition.
+ */
+function followXcodeCache(target, options = {}) {
+    const side = options.side ?? 'restore';
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS[side];
+    let base = target.baseURL;
+    while (base.endsWith('/'))
+        base = base.slice(0, -1);
+    const url = `${base}/v1/xcode_instances/${encodeURIComponent(target.instanceId)}/cache`;
+    return new Promise((resolve, reject) => {
+        let last;
+        let lastKey = '';
+        let settled = false;
+        const finish = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', onAbort);
+            try {
+                source.close();
+            }
+            catch {
+                // A stream that never opened has nothing to close.
+            }
+            fn();
+        };
+        const timer = setTimeout(() => finish(() => reject(new XcodeCacheTimeoutError(side, timeoutMs, last))), timeoutMs);
+        const onAbort = () => finish(() => reject(options.signal?.reason ?? new Error('aborted')));
+        let confirming = false;
+        const confirmGone = () => {
+            if (confirming || settled)
+                return;
+            confirming = true;
+            proxy_transport_1.nodeProxyTransport
+                .fetch(url, {
+                headers: { Authorization: `Bearer ${target.apiKey}`, Accept: 'application/json' },
+            })
+                .then(async (res) => {
+                confirming = false;
+                if (res.status !== 404) {
+                    await res.text().catch(() => undefined);
+                    return;
+                }
+                finish(() => last ? resolve({ cache: last, gone: true }) : reject(new XcodeCacheGoneError(target.instanceId)));
+            })
+                .catch(() => {
+                confirming = false;
+            });
+        };
+        // The endpoint answers from the region, which keeps the instance while it terminates and
+        // drops it once it is collected, so a 404 is the instance being over rather than a fault.
+        // Without this the client treats it as a connection to retry and follows a gone instance
+        // until the timeout, which is minutes of a command that looks hung and says nothing.
+        const fetchOrGone = async (input, init) => {
+            const res = await proxy_transport_1.nodeProxyTransport.fetch(input, init);
+            if (res.status === 404) {
+                finish(() => last ? resolve({ cache: last, gone: true }) : reject(new XcodeCacheGoneError(target.instanceId)));
+            }
+            return res;
+        };
+        const source = (0, eventsource_client_1.createEventSource)({
+            url,
+            fetch: fetchOrGone,
+            onConnect: () => options.onOpen?.(),
+            headers: {
+                Authorization: `Bearer ${target.apiKey}`,
+                Accept: 'text/event-stream',
+            },
+            onMessage: (message) => {
+                if (message.event !== 'cache' && message.event !== 'gone')
+                    return;
+                let cache;
+                try {
+                    cache = JSON.parse(typeof message.data === 'string' ? message.data : String(message.data));
+                }
+                catch (err) {
+                    finish(() => reject(new Error(`Cache stream sent unreadable data: ${err}`)));
+                    return;
+                }
+                last = cache;
+                if (message.event === 'gone') {
+                    // The server also ends the stream this way when its own watch is cut short, which
+                    // Kubernetes does routinely on a long one, so a snapshot decides which it was. The
+                    // client library reconnects on its own when the instance is in fact still there.
+                    confirmGone();
+                    return;
+                }
+                // A reconnect replays the current state, which is not a transition.
+                const key = `${cache.restore.phase}/${cache.restore.reason ?? ''}|${cache.save.phase}/${cache.save.reason ?? ''}`;
+                if (key !== lastKey) {
+                    lastKey = key;
+                    options.onUpdate?.(cache);
+                }
+                if (isCacheTerminal(cache, side)) {
+                    finish(() => resolve({ cache, gone: false }));
+                }
+            },
+        });
+        if (options.signal?.aborted) {
+            onAbort();
+            return;
+        }
+        options.signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=xcode-cache.js.map

package/xcode-cache.js.map

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

package/xcode-cache.mjs

@@ -0,0 +1,165 @@
+import { createEventSource } from 'eventsource-client';
+import { nodeProxyTransport } from "./internal/proxy-transport.mjs";
+/**
+ * The instance was gone before it said anything about its cache, so there is no last state to
+ * summarise. Distinct from a follow that ends with `gone: true`, which at least saw one.
+ */
+export class XcodeCacheGoneError extends Error {
+    constructor(instanceId) {
+        super(`Instance ${instanceId} was gone before it reported any cache status`);
+        this.instanceId = instanceId;
+        this.name = 'XcodeCacheGoneError';
+    }
+}
+export class XcodeCacheTimeoutError extends Error {
+    constructor(side, timeoutMs, cache) {
+        super(`Timed out after ${Math.round(timeoutMs / 1000)}s waiting for the cache ${side} to finish` +
+            (cache ? ` (last phase: ${cache[side].phase})` : ''));
+        this.side = side;
+        this.timeoutMs = timeoutMs;
+        this.cache = cache;
+        this.name = 'XcodeCacheTimeoutError';
+    }
+}
+const DEFAULT_TIMEOUT_MS = {
+    restore: 20 * 60 * 1000,
+    save: 12 * 60 * 1000,
+};
+/** Phases past which nothing more will happen. */
+export function isRestoreTerminal(phase) {
+    return (phase === 'disabled' ||
+        phase === 'unsupported' ||
+        phase === 'restored' ||
+        phase === 'skipped' ||
+        phase === 'failed');
+}
+/**
+ * Separates the one outcome worth reacting to from the terminal phases that just mean "cold,
+ * carry on". A caller that created an instance for a warm workspace deletes it on a failure,
+ * but a fallback to a cold build leaves a perfectly usable instance behind.
+ */
+export function isRestoreFailure(phase) {
+    return phase === 'failed';
+}
+export function isSaveTerminal(phase) {
+    return (phase === 'disabled' ||
+        phase === 'published' ||
+        phase === 'skipped' ||
+        phase === 'failed' ||
+        phase === 'timed_out');
+}
+export function isCacheTerminal(cache, side) {
+    return side === 'restore' ? isRestoreTerminal(cache.restore.phase) : isSaveTerminal(cache.save.phase);
+}
+/**
+ * Follows an instance's cache status until the chosen side reaches a terminal phase, the
+ * instance is collected, or the wait times out.
+ *
+ * The transport is the same endpoint that serves a JSON snapshot, asked for as an event
+ * stream. The server emits on phase change only, so every callback is a real transition.
+ */
+export function followXcodeCache(target, options = {}) {
+    const side = options.side ?? 'restore';
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS[side];
+    let base = target.baseURL;
+    while (base.endsWith('/'))
+        base = base.slice(0, -1);
+    const url = `${base}/v1/xcode_instances/${encodeURIComponent(target.instanceId)}/cache`;
+    return new Promise((resolve, reject) => {
+        let last;
+        let lastKey = '';
+        let settled = false;
+        const finish = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', onAbort);
+            try {
+                source.close();
+            }
+            catch {
+                // A stream that never opened has nothing to close.
+            }
+            fn();
+        };
+        const timer = setTimeout(() => finish(() => reject(new XcodeCacheTimeoutError(side, timeoutMs, last))), timeoutMs);
+        const onAbort = () => finish(() => reject(options.signal?.reason ?? new Error('aborted')));
+        let confirming = false;
+        const confirmGone = () => {
+            if (confirming || settled)
+                return;
+            confirming = true;
+            nodeProxyTransport
+                .fetch(url, {
+                headers: { Authorization: `Bearer ${target.apiKey}`, Accept: 'application/json' },
+            })
+                .then(async (res) => {
+                confirming = false;
+                if (res.status !== 404) {
+                    await res.text().catch(() => undefined);
+                    return;
+                }
+                finish(() => last ? resolve({ cache: last, gone: true }) : reject(new XcodeCacheGoneError(target.instanceId)));
+            })
+                .catch(() => {
+                confirming = false;
+            });
+        };
+        // The endpoint answers from the region, which keeps the instance while it terminates and
+        // drops it once it is collected, so a 404 is the instance being over rather than a fault.
+        // Without this the client treats it as a connection to retry and follows a gone instance
+        // until the timeout, which is minutes of a command that looks hung and says nothing.
+        const fetchOrGone = async (input, init) => {
+            const res = await nodeProxyTransport.fetch(input, init);
+            if (res.status === 404) {
+                finish(() => last ? resolve({ cache: last, gone: true }) : reject(new XcodeCacheGoneError(target.instanceId)));
+            }
+            return res;
+        };
+        const source = createEventSource({
+            url,
+            fetch: fetchOrGone,
+            onConnect: () => options.onOpen?.(),
+            headers: {
+                Authorization: `Bearer ${target.apiKey}`,
+                Accept: 'text/event-stream',
+            },
+            onMessage: (message) => {
+                if (message.event !== 'cache' && message.event !== 'gone')
+                    return;
+                let cache;
+                try {
+                    cache = JSON.parse(typeof message.data === 'string' ? message.data : String(message.data));
+                }
+                catch (err) {
+                    finish(() => reject(new Error(`Cache stream sent unreadable data: ${err}`)));
+                    return;
+                }
+                last = cache;
+                if (message.event === 'gone') {
+                    // The server also ends the stream this way when its own watch is cut short, which
+                    // Kubernetes does routinely on a long one, so a snapshot decides which it was. The
+                    // client library reconnects on its own when the instance is in fact still there.
+                    confirmGone();
+                    return;
+                }
+                // A reconnect replays the current state, which is not a transition.
+                const key = `${cache.restore.phase}/${cache.restore.reason ?? ''}|${cache.save.phase}/${cache.save.reason ?? ''}`;
+                if (key !== lastKey) {
+                    lastKey = key;
+                    options.onUpdate?.(cache);
+                }
+                if (isCacheTerminal(cache, side)) {
+                    finish(() => resolve({ cache, gone: false }));
+                }
+            },
+        });
+        if (options.signal?.aborted) {
+            onAbort();
+            return;
+        }
+        options.signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=xcode-cache.mjs.map

package/xcode-cache.mjs.map

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