@dbx-tools/appkit-lakebox 0.0.0-stage → 0.9.132

package/lib/src/_resource-registry.js

@@ -0,0 +1,128 @@
+import { CacheManager } from "@databricks/appkit";
+import { LakeboxApiError } from "@dbx-tools/lakebox/rest";
+import { withAdvisoryLock } from "@dbx-tools/postgres";
+import { log } from "@dbx-tools/shared-core";
+import { z } from "zod";
+const CACHE_NAMESPACE = "appkit-lakebox:resource";
+const RESOURCE_TTL_SECONDS = 365 * 24 * 60 * 60;
+const LEGACY_PREFIX = "dbx-lakebox-";
+const logger = log.logger("appkit-lakebox:resource");
+const LakeboxResourceReferenceSchema = z
+    .object({ sandboxId: z.string().min(1).describe("Databricks Lakebox identifier.") })
+    .strict()
+    .describe("Persistent pointer to the Databricks-assigned app Lakebox.");
+/**
+ * Persists the Databricks-assigned Lakebox ID and serializes first creation
+ * across app replicas with the Lakebase service-principal pool.
+ */
+export class LakeboxResourceRegistry {
+    application;
+    pool;
+    cache;
+    pending = new Map();
+    legacyChecked = new Set();
+    constructor(application, pool, cache = () => CacheManager.getInstanceSync()) {
+        this.application = application;
+        this.pool = pool;
+        this.cache = cache;
+    }
+    /** Resolves the current app Lakebox without creating one. */
+    async read(client, signal) {
+        const scope = await client.workspaceScope();
+        return this.resolve(client, scope, signal);
+    }
+    /** Returns the current app Lakebox or creates one with a Databricks-assigned name. */
+    async getOrCreate(client, signal) {
+        const scope = await client.workspaceScope();
+        const current = this.pending.get(scope);
+        if (current)
+            return current;
+        const pending = this.withLock(scope, async () => {
+            const existing = await this.resolve(client, scope, signal);
+            if (existing)
+                return existing;
+            const created = await client.create(signal);
+            try {
+                await this.write(scope, created.sandboxId);
+            }
+            catch (error) {
+                await client.delete(created.sandboxId, signal).catch(() => undefined);
+                throw error;
+            }
+            logger.info("created app Lakebox", { id: created.sandboxId });
+            return created;
+        }).finally(() => this.pending.delete(scope));
+        this.pending.set(scope, pending);
+        return pending;
+    }
+    /** Clears the persisted pointer after the managed Lakebox is deleted. */
+    async clear(client) {
+        const scope = await client.workspaceScope();
+        await this.cache().delete(this.key(scope));
+        this.legacyChecked.add(scope);
+    }
+    async resolve(client, scope, signal) {
+        const key = this.key(scope);
+        const value = await this.cache().get(key);
+        const parsed = LakeboxResourceReferenceSchema.safeParse(value);
+        if (value !== null && !parsed.success) {
+            logger.warn("discarded invalid cached Lakebox resource reference", {
+                application: this.application,
+            });
+            await this.cache().delete(key);
+        }
+        if (parsed.success) {
+            try {
+                return await client.get(parsed.data.sandboxId, signal);
+            }
+            catch (error) {
+                if (!(error instanceof LakeboxApiError) || error.status !== 404)
+                    throw error;
+                await this.cache().delete(key);
+                this.legacyChecked.add(scope);
+                return undefined;
+            }
+        }
+        if (this.legacyChecked.has(scope))
+            return undefined;
+        this.legacyChecked.add(scope);
+        const legacy = selectLegacyLakebox(await client.list(signal), legacyLakeboxName(this.application));
+        if (!legacy)
+            return undefined;
+        await this.write(scope, legacy.sandboxId);
+        logger.info("adopted legacy named app Lakebox", { id: legacy.sandboxId });
+        return legacy;
+    }
+    async write(scope, sandboxId) {
+        await this.cache().set(this.key(scope), LakeboxResourceReferenceSchema.parse({ sandboxId }), {
+            ttl: RESOURCE_TTL_SECONDS,
+        });
+    }
+    key(scope) {
+        return this.cache().generateKey([CACHE_NAMESPACE, this.application], scope);
+    }
+    withLock(scope, fn) {
+        if (!this.pool)
+            return fn();
+        return withAdvisoryLock(this.pool, [CACHE_NAMESPACE, this.application, scope], fn);
+    }
+}
+function legacyLakeboxName(application) {
+    const slug = application
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 200);
+    if (!slug)
+        throw new Error("A managed Lakebox requires a non-empty application key");
+    return `${LEGACY_PREFIX}${slug}`;
+}
+function selectLegacyLakebox(entries, name) {
+    return entries
+        .filter((entry) => entry.name === name)
+        .sort((left, right) => (Date.parse(left.createTime ?? "") || Number.MAX_SAFE_INTEGER) -
+        (Date.parse(right.createTime ?? "") || Number.MAX_SAFE_INTEGER) ||
+        left.sandboxId.localeCompare(right.sandboxId))[0];
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiX3Jlc291cmNlLXJlZ2lzdHJ5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL19yZXNvdXJjZS1yZWdpc3RyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDbEQsT0FBTyxFQUFFLGVBQWUsRUFBcUIsTUFBTSx5QkFBeUIsQ0FBQztBQUM3RSxPQUFPLEVBQUUsZ0JBQWdCLEVBQW1CLE1BQU0scUJBQXFCLENBQUM7QUFDeEUsT0FBTyxFQUFFLEdBQUcsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQzdDLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsTUFBTSxlQUFlLEdBQUcseUJBQXlCLENBQUM7QUFDbEQsTUFBTSxvQkFBb0IsR0FBRyxHQUFHLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxFQUFFLENBQUM7QUFDaEQsTUFBTSxhQUFhLEdBQUcsY0FBYyxDQUFDO0FBQ3JDLE1BQU0sTUFBTSxHQUFHLEdBQUcsQ0FBQyxNQUFNLENBQUMseUJBQXlCLENBQUMsQ0FBQztBQUVyRCxNQUFNLDhCQUE4QixHQUFHLENBQUM7S0FDckMsTUFBTSxDQUFDLEVBQUUsU0FBUyxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsUUFBUSxDQUFDLGdDQUFnQyxDQUFDLEVBQUUsQ0FBQztLQUNuRixNQUFNLEVBQUU7S0FDUixRQUFRLENBQUMsNERBQTRELENBQUMsQ0FBQztBQWtCMUU7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLHVCQUF1QjtJQUtmO0lBQ0E7SUFDQTtJQU5GLE9BQU8sR0FBRyxJQUFJLEdBQUcsRUFBaUMsQ0FBQztJQUNuRCxhQUFhLEdBQUcsSUFBSSxHQUFHLEVBQVUsQ0FBQztJQUVuRCxZQUNtQixXQUFtQixFQUNuQixJQUFpQixFQUNqQixRQUFRLEdBQWtCLEVBQUUsQ0FBQyxZ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S0FBSyxDQUFDLENBQUMsRUFBRSxHQUFHLENBQUMsQ0FBQztJQUNqQixJQUFJLENBQUMsSUFBSTtRQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsd0RBQXdELENBQUMsQ0FBQztJQUNyRixPQUFPLEdBQUcsYUFBYSxHQUFHLElBQUksRUFBRSxDQUFDO0FBQ25DLENBQUM7QUFFRCxTQUFTLG1CQUFtQixDQUMxQixPQUFnQyxFQUNoQyxJQUFZO0lBRVosT0FBTyxPQUFPO1NBQ1gsTUFBTSxDQUFDLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxLQUFLLENBQUMsSUFBSSxLQUFLLElBQUksQ0FBQztTQUN0QyxJQUFJLENBQ0gsQ0FBQyxJQUFJLEVBQUUsS0FBSyxFQUFFLEVBQUUsQ0FDZCxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLFVBQVUsSUFBSSxFQUFFLENBQUMsSUFBSSxNQUFNLENBQUMsZ0JBQWdCLENBQUM7UUFDNUQsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLEtBQUssQ0FBQyxVQUFVLElBQUksRUFBRSxDQUFDLElBQUksTUFBTSxDQUFDLGdCQUFnQixDQUFDO1FBQ2pFLElBQUksQ0FBQyxTQUFTLENBQUMsYUFBYSxDQUFDLEtBQUssQ0FBQyxTQUFTLENBQUMsQ0FDaEQsQ0FBQyxDQUFDLENBQUMsQ0FBQztBQUNULENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBDYWNoZU1hbmFnZXIgfSBmcm9tIFwiQGRhdGFicmlja3MvYXBwa2l0XCI7XG5pbXBvcnQgeyBMYWtlYm94QXBpRXJyb3IsIHR5cGUgTGFrZWJveEVudHJ5IH0gZnJvbSBcIkBkYngtdG9vbHMvbGFrZWJveC9yZXN0XCI7XG5pbXBvcnQgeyB3aXRoQWR2aXNvcnlMb2NrLCB0eXBlIFBnUG9vbExpa2UgfSBmcm9tIFwiQGRieC10b29scy9wb3N0Z3Jlc1wiO1xuaW1wb3J0IHsgbG9nIH0gZnJvbSBcIkBkYngtdG9vbHMvc2hhcmVkLWNvcmVcIjtcbmltcG9ydCB7IHogfSBmcm9tIFwiem9kXCI7XG5cbmNvbnN0IENBQ0hFX05BTUVTUEFDRSA9IFwiYXBwa2l0LWxha2Vib3g6cmVzb3VyY2VcIjtcbmNvbnN0IFJFU09VUkNFX1RUTF9TRUNPTkRTID0gMzY1ICogMjQgKiA2MCAqIDYwO1xuY29uc3QgTEVHQUNZX1BSRUZJWCA9IFwiZGJ4LWxha2Vib3gtXCI7XG5jb25zdCBsb2dnZXIgPSBsb2cubG9nZ2VyKFwiYXBwa2l0LWxha2Vib3g6cmVzb3VyY2VcIik7XG5cbmNvbnN0IExha2Vib3hSZXNvdXJjZVJlZmVyZW5jZVNjaGVtYSA9IHpcbiAgLm9iamVjdCh7IHNhbmRib3hJZDogei5zdHJpbmcoKS5taW4oMSkuZGVzY3JpYmUoXCJEYXRhYnJpY2tzIExha2Vib3ggaWRlbnRpZmllci5cIikgfSlcbiAgLnN0cmljdCgpXG4gIC5kZXNjcmliZShcIlBlcnNpc3RlbnQgcG9pbnRlciB0byB0aGUgRGF0YWJyaWNrcy1hc3NpZ25lZCBhcHAgTGFrZWJveC5cIik7XG5cbmludGVyZmFjZSBSZXNvdXJjZUNhY2hlIHtcbiAgZ2VuZXJhdGVLZXkocGFydHM6IChzdHJpbmcgfCBudW1iZXIgfCBvYmplY3QpW10sIHVzZXJLZXk6IHN0cmluZyk6IHN0cmluZztcbiAgZ2V0PFQ+KGtleTogc3RyaW5nKTogUHJvbWlzZTxUIHwgbnVsbD47XG4gIHNldDxUPihrZXk6IHN0cmluZywgdmFsdWU6IFQsIG9wdGlvbnM/OiB7IHR0bD86IG51bWJlciB9KTogUHJvbWlzZTx2b2lkPjtcbiAgZGVsZXRlKGtleTogc3RyaW5nKTogUHJvbWlzZTx2b2lkPjtcbn1cblxuLyoqIExha2Vib3ggY2xpZW50IGNhcGFiaWxpdGllcyByZXF1aXJlZCBieSB0aGUgcGVyc2lzdGVudCByZXNvdXJjZSByZWdpc3RyeS4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTGFrZWJveFJlc291cmNlQ2xpZW50IHtcbiAgd29ya3NwYWNlU2NvcGUoKTogUHJvbWlzZTxzdHJpbmc+O1xuICBsaXN0KHNpZ25hbD86IEFib3J0U2lnbmFsKTogUHJvbWlzZTxMYWtlYm94RW50cnlbXT47XG4gIGdldChpZDogc3RyaW5nLCBzaWduYWw/OiBBYm9ydFNpZ25hbCk6IFByb21pc2U8TGFrZWJveEVudHJ5PjtcbiAgY3JlYXRlKHNpZ25hbD86IEFib3J0U2lnbmFsKTogUHJvbWlzZTxMYWtlYm94RW50cnk+O1xuICBkZWxldGUoaWQ6IHN0cmluZywgc2lnbmFsPzogQWJvcnRTaWduYWwpOiBQcm9taXNlPHZvaWQ+O1xufVxuXG4vKipcbiAqIFBlcnNpc3RzIHRoZSBEYXRhYnJpY2tzLWFzc2lnbmVkIExha2Vib3ggSUQgYW5kIHNlcmlhbGl6ZXMgZmlyc3QgY3JlYXRpb25cbiAqIGFjcm9zcyBhcHAgcmVwbGljYXMgd2l0aCB0aGUgTGFrZWJhc2Ugc2VydmljZS1wcmluY2lwYWwgcG9vbC5cbiAqL1xuZXhwb3J0IGNsYXNzIExha2Vib3hSZXNvdXJjZVJlZ2lzdHJ5IHtcbiAgcHJpdmF0ZSByZWFkb25seSBwZW5kaW5nID0gbmV3IE1hcDxzdHJpbmcsIFByb21pc2U8TGFrZWJveEVudHJ5Pj4oKTtcbiAgcHJpdmF0ZSByZWFkb25seSBsZWdhY3lDaGVja2VkID0gbmV3IFNldDxzdHJpbmc+KCk7XG5cbiAgY29uc3RydWN0b3IoXG4gICAgcHJpdmF0ZSByZWFkb25seSBhcHBsaWNhdGlvbjogc3RyaW5nLFxuICAgIHByaXZhdGUgcmVhZG9ubHkgcG9vbD86IFBnUG9vbExpa2UsXG4gICAgcHJpdmF0ZSByZWFkb25seSBjYWNoZSA9ICgpOiBSZXNvdXJjZUNhY2hlID0+IENhY2hlTWFuYWdlci5nZXRJbnN0YW5jZVN5bmMoKSxcbiAgKSB7fVxuXG4gIC8qKiBSZXNvbHZlcyB0aGUgY3VycmVudCBhcHAgTGFrZWJveCB3aXRob3V0IGNyZWF0aW5nIG9uZS4gKi9cbiAgYXN5bmMgcmVhZChcbiAgICBjbGllbnQ6IExha2Vib3hSZXNvdXJjZUNsaWVudCxcbiAgICBzaWduYWw/OiBBYm9ydFNpZ25hbCxcbiAgKTogUHJvbWlzZTxMYWtlYm94RW50cnkgfCB1bmRlZmluZWQ+IHtcbiAgICBjb25zdCBzY29wZSA9IGF3YWl0IGNsaWVudC53b3Jrc3BhY2VTY29wZSgpO1xuICAgIHJldHVybiB0aGlzLnJlc29sdmUoY2xpZW50LCBzY29wZSwgc2lnbmFsKTtcbiAgfVxuXG4gIC8qKiBSZXR1cm5zIHRoZSBjdXJyZW50IGFwcCBMYWtlYm94IG9yIGNyZWF0ZXMgb25lIHdpdGggYSBEYXRhYnJpY2tzLWFzc2lnbmVkIG5hbWUuICovXG4gIGFzeW5jIGdldE9yQ3JlYXRlKGNsaWVudDogTGFrZWJveFJlc291cmNlQ2xpZW50LCBzaWduYWw/OiBBYm9ydFNpZ25hbCk6IFByb21pc2U8TGFrZWJveEVudHJ5PiB7XG4gICAgY29uc3Qgc2NvcGUgPSBhd2FpdCBjbGllbnQud29ya3NwYWNlU2NvcGUoKTtcbiAgICBjb25zdCBjdXJyZW50ID0gdGhpcy5wZW5kaW5nLmdldChzY29wZSk7XG4gICAgaWYgKGN1cnJlbnQpIHJldHVybiBjdXJyZW50O1xuICAgIGNvbnN0IHBlbmRpbmcgPSB0aGlzLndpdGhMb2NrKHNjb3BlLCBhc3luYyAoKSA9PiB7XG4gICAgICBjb25zdCBleGlzdGluZyA9IGF3YWl0IHRoaXMucmVzb2x2ZShjbGllbnQsIHNjb3BlLCBzaWduYWwpO1xuICAgICAgaWYgKGV4aXN0aW5nKSByZXR1cm4gZXhpc3Rpbmc7XG4gICAgICBjb25zdCBjcmVhdGVkID0gYXdhaXQgY2xpZW50LmNyZWF0ZShzaWduYWwpO1xuICAgICAgdHJ5IHtcbiAgICAgICAgYXdhaXQgdGhpcy53cml0ZShzY29wZSwgY3JlYXRlZC5zYW5kYm94SWQpO1xuICAgICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgICAgYXdhaXQgY2xpZW50LmRlbGV0ZShjcmVhdGVkLnNhbmRib3hJZCwgc2lnbmFsKS5jYXRjaCgoKSA9PiB1bmRlZmluZWQpO1xuICAgICAgICB0aHJvdyBlcnJvcjtcbiAgICAgIH1cbiAgICAgIGxvZ2dlci5pbmZvKFwiY3JlYXRlZCBhcHAgTGFrZWJveFwiLCB7IGlkOiBjcmVhdGVkLnNhbmRib3hJZCB9KTtcbiAgICAgIHJldHVybiBjcmVhdGVkO1xuICAgIH0pLmZpbmFsbHkoKCkgPT4gdGhpcy5wZW5kaW5nLmRlbGV0ZShzY29wZSkpO1xuICAgIHRoaXMucGVuZGluZy5zZXQoc2NvcGUsIHBlbmRpbmcpO1xuICAgIHJldHVybiBwZW5kaW5nO1xuICB9XG5cbiAgLyoqIENsZWFycyB0aGUgcGVyc2lzdGVkIHBvaW50ZXIgYWZ0ZXIgdGhlIG1hbmFnZWQgTGFrZWJveCBpcyBkZWxldGVkLiAqL1xuICBhc3luYyBjbGVhcihjbGllbnQ6IExha2Vib3hSZXNvdXJjZUNsaWVudCk6IFByb21pc2U8dm9pZD4ge1xuICAgIGNvbnN0IHNjb3BlID0gYXdhaXQgY2xpZW50LndvcmtzcGFjZVNjb3BlKCk7XG4gICAgYXdhaXQgdGhpcy5jYWNoZSgpLmRlbGV0ZSh0aGlzLmtleShzY29wZSkpO1xuICAgIHRoaXMubGVnYWN5Q2hlY2tlZC5hZGQoc2NvcGUpO1xuICB9XG5cbiAgcHJpdmF0ZSBhc3luYyByZXNvbHZlKFxuICAgIGNsaWVudDogTGFrZWJveFJlc291cmNlQ2xpZW50LFxuICAgIHNjb3BlOiBzdHJpbmcsXG4gICAgc2lnbmFsPzogQWJvcnRTaWduYWwsXG4gICk6IFByb21pc2U8TGFrZWJveEVudHJ5IHwgdW5kZWZpbmVkPiB7XG4gICAgY29uc3Qga2V5ID0gdGhpcy5rZXkoc2NvcGUpO1xuICAgIGNvbnN0IHZhbHVlID0gYXdhaXQgdGhpcy5jYWNoZSgpLmdldDx1bmtub3duPihrZXkpO1xuICAgIGNvbnN0IHBhcnNlZCA9IExha2Vib3hSZXNvdXJjZVJlZmVyZW5jZVNjaGVtYS5zYWZlUGFyc2UodmFsdWUpO1xuICAgIGlmICh2YWx1ZSAhPT0gbnVsbCAmJiAhcGFyc2VkLnN1Y2Nlc3MpIHtcbiAgICAgIGxvZ2dlci53YXJuKFwiZGlzY2FyZGVkIGludmFsaWQgY2FjaGVkIExha2Vib3ggcmVzb3VyY2UgcmVmZXJlbmNlXCIsIHtcbiAgICAgICAgYXBwbGljYXRpb246IHRoaXMuYXBwbGljYXRpb24sXG4gICAgICB9KTtcbiAgICAgIGF3YWl0IHRoaXMuY2FjaGUoKS5kZWxldGUoa2V5KTtcbiAgICB9XG4gICAgaWYgKHBhcnNlZC5zdWNjZXNzKSB7XG4gICAgICB0cnkge1xuICAgICAgICByZXR1cm4gYXdhaXQgY2xpZW50LmdldChwYXJzZWQuZGF0YS5zYW5kYm94SWQsIHNpZ25hbCk7XG4gICAgICB9IGNhdGNoIChlcnJvcikge1xuICAgICAgICBpZiAoIShlcnJvciBpbnN0YW5jZW9mIExha2Vib3hBcGlFcnJvcikgfHwgZXJyb3Iuc3RhdHVzICE9PSA0MDQpIHRocm93IGVycm9yO1xuICAgICAgICBhd2FpdCB0aGlzLmNhY2hlKCkuZGVsZXRlKGtleSk7XG4gICAgICAgIHRoaXMubGVnYWN5Q2hlY2tlZC5hZGQoc2NvcGUpO1xuICAgICAgICByZXR1cm4gdW5kZWZpbmVkO1xuICAgICAgfVxuICAgIH1cbiAgICBpZiAodGhpcy5sZWdhY3lDaGVja2VkLmhhcyhzY29wZSkpIHJldHVybiB1bmRlZmluZWQ7XG4gICAgdGhpcy5sZWdhY3lDaGVja2VkLmFkZChzY29wZSk7XG4gICAgY29uc3QgbGVnYWN5ID0gc2VsZWN0TGVnYWN5TGFrZWJveChcbiAgICAgIGF3YWl0IGNsaWVudC5saXN0KHNpZ25hbCksXG4gICAgICBsZWdhY3lMYWtlYm94TmFtZSh0aGlzLmFwcGxpY2F0aW9uKSxcbiAgICApO1xuICAgIGlmICghbGVnYWN5KSByZXR1cm4gdW5kZWZpbmVkO1xuICAgIGF3YWl0IHRoaXMud3JpdGUoc2NvcGUsIGxlZ2FjeS5zYW5kYm94SWQpO1xuICAgIGxvZ2dlci5pbmZvKFwiYWRvcHRlZCBsZWdhY3kgbmFtZWQgYXBwIExha2Vib3hcIiwgeyBpZDogbGVnYWN5LnNhbmRib3hJZCB9KTtcbiAgICByZXR1cm4gbGVnYWN5O1xuICB9XG5cbiAgcHJpdmF0ZSBhc3luYyB3cml0ZShzY29wZTogc3RyaW5nLCBzYW5kYm94SWQ6IHN0cmluZyk6IFByb21pc2U8dm9pZD4ge1xuICAgIGF3YWl0IHRoaXMuY2FjaGUoKS5zZXQodGhpcy5rZXkoc2NvcGUpLCBMYWtlYm94UmVzb3VyY2VSZWZlcmVuY2VTY2hlbWEucGFyc2UoeyBzYW5kYm94SWQgfSksIHtcbiAgICAgIHR0bDogUkVTT1VSQ0VfVFRMX1NFQ09ORFMsXG4gICAgfSk7XG4gIH1cblxuICBwcml2YXRlIGtleShzY29wZTogc3RyaW5nKTogc3RyaW5nIHtcbiAgICByZXR1cm4gdGhpcy5jYWNoZSgpLmdlbmVyYXRlS2V5KFtDQUNIRV9OQU1FU1BBQ0UsIHRoaXMuYXBwbGljYXRpb25dLCBzY29wZSk7XG4gIH1cblxuICBwcml2YXRlIHdpdGhMb2NrPFQ+KHNjb3BlOiBzdHJpbmcsIGZuOiAoKSA9PiBQcm9taXNlPFQ+KTogUHJvbWlzZTxUPiB7XG4gICAgaWYgKCF0aGlzLnBvb2wpIHJldHVybiBmbigpO1xuICAgIHJldHVybiB3aXRoQWR2aXNvcnlMb2NrKHRoaXMucG9vbCwgW0NBQ0hFX05BTUVTUEFDRSwgdGhpcy5hcHBsaWNhdGlvbiwgc2NvcGVdLCBmbik7XG4gIH1cbn1cblxuZnVuY3Rpb24gbGVnYWN5TGFrZWJveE5hbWUoYXBwbGljYXRpb246IHN0cmluZyk6IHN0cmluZyB7XG4gIGNvbnN0IHNsdWcgPSBhcHBsaWNhdGlvblxuICAgIC50cmltKClcbiAgICAudG9Mb3dlckNhc2UoKVxuICAgIC5yZXBsYWNlKC9bXmEtejAtOV0rL2csIFwiLVwiKVxuICAgIC5yZXBsYWNlKC9eLXwtJC9nLCBcIlwiKVxuICAgIC5zbGljZSgwLCAyMDApO1xuICBpZiAoIXNsdWcpIHRocm93IG5ldyBFcnJvcihcIkEgbWFuYWdlZCBMYWtlYm94IHJlcXVpcmVzIGEgbm9uLWVtcHR5IGFwcGxpY2F0aW9uIGtleVwiKTtcbiAgcmV0dXJuIGAke0xFR0FDWV9QUkVGSVh9JHtzbHVnfWA7XG59XG5cbmZ1bmN0aW9uIHNlbGVjdExlZ2FjeUxha2Vib3goXG4gIGVudHJpZXM6IHJlYWRvbmx5IExha2Vib3hFbnRyeVtdLFxuICBuYW1lOiBzdHJpbmcsXG4pOiBMYWtlYm94RW50cnkgfCB1bmRlZmluZWQge1xuICByZXR1cm4gZW50cmllc1xuICAgIC5maWx0ZXIoKGVudHJ5KSA9PiBlbnRyeS5uYW1lID09PSBuYW1lKVxuICAgIC5zb3J0KFxuICAgICAgKGxlZnQsIHJpZ2h0KSA9PlxuICAgICAgICAoRGF0ZS5wYXJzZShsZWZ0LmNyZWF0ZVRpbWUgPz8gXCJcIikgfHwgTnVtYmVyLk1BWF9TQUZFX0lOVEVHRVIpIC1cbiAgICAgICAgICAoRGF0ZS5wYXJzZShyaWdodC5jcmVhdGVUaW1lID8/IFwiXCIpIHx8IE51bWJlci5NQVhfU0FGRV9JTlRFR0VSKSB8fFxuICAgICAgICBsZWZ0LnNhbmRib3hJZC5sb2NhbGVDb21wYXJlKHJpZ2h0LnNhbmRib3hJZCksXG4gICAgKVswXTtcbn1cbiJdfQ==

package/lib/src/_service-snapshots.d.ts

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { type LakeboxControllerService } from "./services.ts";
+export declare const LakeboxServiceSnapshotSchema: z.ZodObject<{
+    observedAt: z.ZodString;
+    definitions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodEnum<{
+            terminal: "terminal";
+            desktop: "desktop";
+            image: "image";
+        }>;
+        image: z.ZodOptional<z.ZodString>;
+        pull: z.ZodDefault<z.ZodEnum<{
+            missing: "missing";
+            always: "always";
+        }>>;
+        command: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        env: z.ZodRecord<z.ZodString, z.ZodString>;
+        workingDirectory: z.ZodOptional<z.ZodString>;
+        mounts: z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            target: z.ZodString;
+            readOnly: z.ZodBoolean;
+        }, z.core.$strict>>;
+        port: z.ZodNumber;
+        readiness: z.ZodEnum<{
+            tcp: "tcp";
+            none: "none";
+        }>;
+        readySeconds: z.ZodNumber;
+        autostart: z.ZodBoolean;
+        route: z.ZodBoolean;
+        stripPrefix: z.ZodBoolean;
+        openPath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type LakeboxServiceSnapshot = z.infer<typeof LakeboxServiceSnapshotSchema>;
+/** Projects saved definitions into explicitly non-live stopped service records. */
+export declare function stoppedSnapshotServices(snapshot: LakeboxServiceSnapshot): Map<string, LakeboxControllerService>;
+interface SnapshotCache {
+    generateKey(parts: (string | number | object)[], userKey: string): string;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, options?: {
+        ttl?: number;
+    }): Promise<void>;
+}
+/** Best-effort persistent snapshots backed by AppKit's configured cache. */
+export declare class LakeboxServiceSnapshots {
+    private readonly cache;
+    constructor(cache?: () => SnapshotCache);
+    read(lakeboxId: string, userHash: string): Promise<LakeboxServiceSnapshot | undefined>;
+    write(lakeboxId: string, userHash: string, snapshot: LakeboxServiceSnapshot): Promise<void>;
+    private key;
+}
+export {};

package/lib/src/_service-snapshots.js

@@ -0,0 +1,65 @@
+import { CacheManager } from "@databricks/appkit";
+import { errorUtils, log } from "@dbx-tools/shared-core";
+import { z } from "zod";
+import { LakeboxControllerDefinitionSchema } from "./services.js";
+const CACHE_NAMESPACE = "appkit-lakebox:service-snapshot";
+const SNAPSHOT_TTL_SECONDS = 365 * 24 * 60 * 60;
+const logger = log.logger("appkit-lakebox:service-snapshot");
+export const LakeboxServiceSnapshotSchema = z
+    .object({
+    observedAt: z.string().datetime().describe("Time the controller last returned this list."),
+    definitions: z
+        .array(LakeboxControllerDefinitionSchema)
+        .describe("Last observed saved service definitions; never authoritative live state."),
+})
+    .strict()
+    .describe("Best-effort last-known Lakebox service definitions for an unavailable machine.");
+/** Projects saved definitions into explicitly non-live stopped service records. */
+export function stoppedSnapshotServices(snapshot) {
+    return new Map(snapshot.definitions.map((definition) => [
+        definition.name,
+        { name: definition.name, state: "stopped", definition },
+    ]));
+}
+/** Best-effort persistent snapshots backed by AppKit's configured cache. */
+export class LakeboxServiceSnapshots {
+    cache;
+    constructor(cache = () => CacheManager.getInstanceSync()) {
+        this.cache = cache;
+    }
+    async read(lakeboxId, userHash) {
+        try {
+            const value = await this.cache().get(this.key(lakeboxId, userHash));
+            if (value === null)
+                return undefined;
+            const parsed = LakeboxServiceSnapshotSchema.safeParse(value);
+            if (parsed.success)
+                return parsed.data;
+            logger.warn("ignored invalid cached service snapshot", { lakeboxId, userHash });
+        }
+        catch (error) {
+            logger.warn("unable to read cached service snapshot", {
+                lakeboxId,
+                userHash,
+                error: errorUtils.toError(error),
+            });
+        }
+        return undefined;
+    }
+    async write(lakeboxId, userHash, snapshot) {
+        try {
+            await this.cache().set(this.key(lakeboxId, userHash), LakeboxServiceSnapshotSchema.parse(snapshot), { ttl: SNAPSHOT_TTL_SECONDS });
+        }
+        catch (error) {
+            logger.warn("unable to cache service snapshot", {
+                lakeboxId,
+                userHash,
+                error: errorUtils.toError(error),
+            });
+        }
+    }
+    key(lakeboxId, userHash) {
+        return this.cache().generateKey([CACHE_NAMESPACE, lakeboxId], userHash);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiX3NlcnZpY2Utc25hcHNob3RzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL19zZXJ2aWNlLXNuYXBzaG90cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDbEQsT0FBTyxFQUFFLFVBQVUsRUFBRSxHQUFHLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUN6RCxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBQ3hCLE9BQU8sRUFBRSxpQ0FBaUMsRUFBaUMsTUFBTSxlQUFlLENBQUM7QUFFakcsTUFBTSxlQUFlLEdBQUcsaUNBQWlDLENBQUM7QUFDMUQsTUFBTSxvQkFBb0IsR0FBRyxHQUFHLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxFQUFFLENBQUM7QUFDaEQsTUFBTSxNQUFNLEdBQUcsR0FBRyxDQUFDLE1BQU0sQ0FBQyxpQ0FBaUMsQ0FBQyxDQUFDO0FBRTdELE1BQU0sQ0FBQyxNQUFNLDRCQUE0QixHQUFHLENBQUM7S0FDMUMsTUFBTSxDQUFDO0lBQ04sVUFBVSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLEVBQUUsQ0FBQyxRQUFRLENBQUMsOENBQThDLENBQUM7SUFDMUYsV0FBVyxFQUFFLENBQUM7U0FDWCxLQUFLLENBQUMsaUNBQWlDLENBQUM7U0FDeEMsUUFBUSxDQUFDLDBFQUEwRSxDQUFDO0NBQ3hGLENBQUM7S0FDRCxNQUFNLEVBQUU7S0FDUixRQUFRLENBQUMsZ0ZBQWdGLENBQUMsQ0FBQztBQUk5RixtRkFBbUY7QUFDbkYsTUFBTSxVQUFVLHVCQUF1QixDQUNyQyxRQUFnQztJQUVoQyxPQUFPLElBQUksR0FBRyxDQUNaLFFBQVEsQ0FBQyxXQUFXLENBQUMsR0FBRyxDQUFDLENBQUMsVUFBVSxFQUFFLEVBQUUsQ0FBQztRQUN2QyxVQUFVLENBQUMsSUFBSTtRQUNmLEVBQUUsSUFBSSxFQUFFLFVBQVUsQ0FBQyxJQUFJLEVBQUUsS0FBSyxFQUFFLFNBQVMsRUFBRSxVQUFVLEVBQUU7S0FDeEQsQ0FBQyxDQUNILENBQUM7QUFDSixDQUFDO0FBUUQsNEVBQTRFO0FBQzVFLE1BQU0sT0FBTyx1QkFBdUI7SUFDTDtJQUE3QixZQUE2QixRQUFRLEdBQWtCLEVBQUUsQ0FBQyxZQUFZLENBQUMsZUFBZSxFQUFFO1FBQTNELFVBQUssR0FBTCxLQUFLLENBQXNEO0lBQUcsQ0FBQztJQUU1RixLQUFLLENBQUMsSUFBSSxDQUFDLFNBQWlCLEVBQUUsUUFBZ0I7UUFDNUMsSUFBSSxDQUFDO1lBQ0gsTUFBTSxLQUFLLEdBQUcsTUFBTSxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUMsR0FBRyxDQUFVLElBQUksQ0FBQyxHQUFHLENBQUMsU0FBUyxFQUFFLFFBQVEsQ0FBQyxDQUFDLENBQUM7WUFDN0UsSUFBSSxLQUFLLEtBQUssSUFBSTtnQkFBRSxPQUFPLFNBQVMsQ0FBQztZQUNyQyxNQUFNLE1BQU0sR0FBRyw0QkFBNEIsQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLENBQUM7WUFDN0QsSUFBSSxNQUFNLENBQUMsT0FBTztnQkFBRSxPQUFPLE1BQU0sQ0FBQyxJQUFJLENBQUM7WUFDdkMsTUFBTSxDQUFDLElBQUksQ0FBQyx5Q0FBeUMsRUFBRSxFQUFFLFNBQVMsRUFBRSxRQUFRLEVBQUUsQ0FBQyxDQUFDO1FBQ2xGLENBQUM7UUFBQyxPQUFPLEtBQUssRUFBRSxDQUFDO1lBQ2YsTUFBTSxDQUFDLElBQUksQ0FBQyx3Q0FBd0MsRUFBRTtnQkFDcEQsU0FBUztnQkFDVCxRQUFRO2dCQUNSLEtBQUssRUFBRSxVQUFVLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQzthQUNqQyxDQUFDLENBQUM7UUFDTCxDQUFDO1FBQ0QsT0FBTyxTQUFTLENBQUM7SUFDbkIsQ0FBQztJQUVELEtBQUssQ0FBQyxLQUFLLENBQ1QsU0FBaUIsRUFDakIsUUFBZ0IsRUFDaEIsUUFBZ0M7UUFFaEMsSUFBSSxDQUFDO1lBQ0gsTUFBTSxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUMsR0FBRyxDQUNwQixJQUFJLENBQUMsR0FBRyxDQUFDLFNBQVMsRUFBRSxRQUFRLENBQUMsRUFDN0IsNEJBQTRCLENBQUMsS0FBSyxDQUFDLFFBQVEsQ0FBQyxFQUM1QyxFQUFFLEdBQUcsRUFBRSxvQkFBb0IsRUFBRSxDQUM5QixDQUFDO1FBQ0osQ0FBQztRQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7WUFDZixNQUFNLENBQUMsSUFBSSxDQUFDLGtDQUFrQyxFQUFFO2dCQUM5QyxTQUFTO2dCQUNULFFBQVE7Z0JBQ1IsS0FBSyxFQUFFLFVBQVUsQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDO2FBQ2pDLENBQUMsQ0FBQztRQUNMLENBQUM7SUFDSCxDQUFDO0lBRU8sR0FBRyxDQUFDLFNBQWlCLEVBQUUsUUFBZ0I7UUFDN0MsT0FBTyxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUMsV0FBVyxDQUFDLENBQUMsZUFBZSxFQUFFLFNBQVMsQ0FBQyxFQUFFLFFBQVEsQ0FBQyxDQUFDO0lBQzFFLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IENhY2hlTWFuYWdlciB9IGZyb20gXCJAZGF0YWJyaWNrcy9hcHBraXRcIjtcbmltcG9ydCB7IGVycm9yVXRpbHMsIGxvZyB9IGZyb20gXCJAZGJ4LXRvb2xzL3NoYXJlZC1jb3JlXCI7XG5pbXBvcnQgeyB6IH0gZnJvbSBcInpvZFwiO1xuaW1wb3J0IHsgTGFrZWJveENvbnRyb2xsZXJEZWZpbml0aW9uU2NoZW1hLCB0eXBlIExha2Vib3hDb250cm9sbGVyU2VydmljZSB9IGZyb20gXCIuL3NlcnZpY2VzLnRzXCI7XG5cbmNvbnN0IENBQ0hFX05BTUVTUEFDRSA9IFwiYXBwa2l0LWxha2Vib3g6c2VydmljZS1zbmFwc2hvdFwiO1xuY29uc3QgU05BUFNIT1RfVFRMX1NFQ09ORFMgPSAzNjUgKiAyNCAqIDYwICogNjA7XG5jb25zdCBsb2dnZXIgPSBsb2cubG9nZ2VyKFwiYXBwa2l0LWxha2Vib3g6c2VydmljZS1zbmFwc2hvdFwiKTtcblxuZXhwb3J0IGNvbnN0IExha2Vib3hTZXJ2aWNlU25hcHNob3RTY2hlbWEgPSB6XG4gIC5vYmplY3Qoe1xuICAgIG9ic2VydmVkQXQ6IHouc3RyaW5nKCkuZGF0ZXRpbWUoKS5kZXNjcmliZShcIlRpbWUgdGhlIGNvbnRyb2xsZXIgbGFzdCByZXR1cm5lZCB0aGlzIGxpc3QuXCIpLFxuICAgIGRlZmluaXRpb25zOiB6XG4gICAgICAuYXJyYXkoTGFrZWJveENvbnRyb2xsZXJEZWZpbml0aW9uU2NoZW1hKVxuICAgICAgLmRlc2NyaWJlKFwiTGFzdCBvYnNlcnZlZCBzYXZlZCBzZXJ2aWNlIGRlZmluaXRpb25zOyBuZXZlciBhdXRob3JpdGF0aXZlIGxpdmUgc3RhdGUuXCIpLFxuICB9KVxuICAuc3RyaWN0KClcbiAgLmRlc2NyaWJlKFwiQmVzdC1lZmZvcnQgbGFzdC1rbm93biBMYWtlYm94IHNlcnZpY2UgZGVmaW5pdGlvbnMgZm9yIGFuIHVuYXZhaWxhYmxlIG1hY2hpbmUuXCIpO1xuXG5leHBvcnQgdHlwZSBMYWtlYm94U2VydmljZVNuYXBzaG90ID0gei5pbmZlcjx0eXBlb2YgTGFrZWJveFNlcnZpY2VTbmFwc2hvdFNjaGVtYT47XG5cbi8qKiBQcm9qZWN0cyBzYXZlZCBkZWZpbml0aW9ucyBpbnRvIGV4cGxpY2l0bHkgbm9uLWxpdmUgc3RvcHBlZCBzZXJ2aWNlIHJlY29yZHMuICovXG5leHBvcnQgZnVuY3Rpb24gc3RvcHBlZFNuYXBzaG90U2VydmljZXMoXG4gIHNuYXBzaG90OiBMYWtlYm94U2VydmljZVNuYXBzaG90LFxuKTogTWFwPHN0cmluZywgTGFrZWJveENvbnRyb2xsZXJTZXJ2aWNlPiB7XG4gIHJldHVybiBuZXcgTWFwKFxuICAgIHNuYXBzaG90LmRlZmluaXRpb25zLm1hcCgoZGVmaW5pdGlvbikgPT4gW1xuICAgICAgZGVmaW5pdGlvbi5uYW1lLFxuICAgICAgeyBuYW1lOiBkZWZpbml0aW9uLm5hbWUsIHN0YXRlOiBcInN0b3BwZWRcIiwgZGVmaW5pdGlvbiB9LFxuICAgIF0pLFxuICApO1xufVxuXG5pbnRlcmZhY2UgU25hcHNob3RDYWNoZSB7XG4gIGdlbmVyYXRlS2V5KHBhcnRzOiAoc3RyaW5nIHwgbnVtYmVyIHwgb2JqZWN0KVtdLCB1c2VyS2V5OiBzdHJpbmcpOiBzdHJpbmc7XG4gIGdldDxUPihrZXk6IHN0cmluZyk6IFByb21pc2U8VCB8IG51bGw+O1xuICBzZXQ8VD4oa2V5OiBzdHJpbmcsIHZhbHVlOiBULCBvcHRpb25zPzogeyB0dGw/OiBudW1iZXIgfSk6IFByb21pc2U8dm9pZD47XG59XG5cbi8qKiBCZXN0LWVmZm9ydCBwZXJzaXN0ZW50IHNuYXBzaG90cyBiYWNrZWQgYnkgQXBwS2l0J3MgY29uZmlndXJlZCBjYWNoZS4gKi9cbmV4cG9ydCBjbGFzcyBMYWtlYm94U2VydmljZVNuYXBzaG90cyB7XG4gIGNvbnN0cnVjdG9yKHByaXZhdGUgcmVhZG9ubHkgY2FjaGUgPSAoKTogU25hcHNob3RDYWNoZSA9PiBDYWNoZU1hbmFnZXIuZ2V0SW5zdGFuY2VTeW5jKCkpIHt9XG5cbiAgYXN5bmMgcmVhZChsYWtlYm94SWQ6IHN0cmluZywgdXNlckhhc2g6IHN0cmluZyk6IFByb21pc2U8TGFrZWJveFNlcnZpY2VTbmFwc2hvdCB8IHVuZGVmaW5lZD4ge1xuICAgIHRyeSB7XG4gICAgICBjb25zdCB2YWx1ZSA9IGF3YWl0IHRoaXMuY2FjaGUoKS5nZXQ8dW5rbm93bj4odGhpcy5rZXkobGFrZWJveElkLCB1c2VySGFzaCkpO1xuICAgICAgaWYgKHZhbHVlID09PSBudWxsKSByZXR1cm4gdW5kZWZpbmVkO1xuICAgICAgY29uc3QgcGFyc2VkID0gTGFrZWJveFNlcnZpY2VTbmFwc2hvdFNjaGVtYS5zYWZlUGFyc2UodmFsdWUpO1xuICAgICAgaWYgKHBhcnNlZC5zdWNjZXNzKSByZXR1cm4gcGFyc2VkLmRhdGE7XG4gICAgICBsb2dnZXIud2FybihcImlnbm9yZWQgaW52YWxpZCBjYWNoZWQgc2VydmljZSBzbmFwc2hvdFwiLCB7IGxha2Vib3hJZCwgdXNlckhhc2ggfSk7XG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIGxvZ2dlci53YXJuKFwidW5hYmxlIHRvIHJlYWQgY2FjaGVkIHNlcnZpY2Ugc25hcHNob3RcIiwge1xuICAgICAgICBsYWtlYm94SWQsXG4gICAgICAgIHVzZXJIYXNoLFxuICAgICAgICBlcnJvcjogZXJyb3JVdGlscy50b0Vycm9yKGVycm9yKSxcbiAgICAgIH0pO1xuICAgIH1cbiAgICByZXR1cm4gdW5kZWZpbmVkO1xuICB9XG5cbiAgYXN5bmMgd3JpdGUoXG4gICAgbGFrZWJveElkOiBzdHJpbmcsXG4gICAgdXNlckhhc2g6IHN0cmluZyxcbiAgICBzbmFwc2hvdDogTGFrZWJveFNlcnZpY2VTbmFwc2hvdCxcbiAgKTogUHJvbWlzZTx2b2lkPiB7XG4gICAgdHJ5IHtcbiAgICAgIGF3YWl0IHRoaXMuY2FjaGUoKS5zZXQoXG4gICAgICAgIHRoaXMua2V5KGxha2Vib3hJZCwgdXNlckhhc2gpLFxuICAgICAgICBMYWtlYm94U2VydmljZVNuYXBzaG90U2NoZW1hLnBhcnNlKHNuYXBzaG90KSxcbiAgICAgICAgeyB0dGw6IFNOQVBTSE9UX1RUTF9TRUNPTkRTIH0sXG4gICAgICApO1xuICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICBsb2dnZXIud2FybihcInVuYWJsZSB0byBjYWNoZSBzZXJ2aWNlIHNuYXBzaG90XCIsIHtcbiAgICAgICAgbGFrZWJveElkLFxuICAgICAgICB1c2VySGFzaCxcbiAgICAgICAgZXJyb3I6IGVycm9yVXRpbHMudG9FcnJvcihlcnJvciksXG4gICAgICB9KTtcbiAgICB9XG4gIH1cblxuICBwcml2YXRlIGtleShsYWtlYm94SWQ6IHN0cmluZywgdXNlckhhc2g6IHN0cmluZyk6IHN0cmluZyB7XG4gICAgcmV0dXJuIHRoaXMuY2FjaGUoKS5nZW5lcmF0ZUtleShbQ0FDSEVfTkFNRVNQQUNFLCBsYWtlYm94SWRdLCB1c2VySGFzaCk7XG4gIH1cbn1cbiJdfQ==

package/lib/src/config.d.ts

@@ -0,0 +1,40 @@
+import type { BasePluginConfig } from "@databricks/appkit";
+import { z } from "zod";
+export declare const LakeboxPluginConfigSchema: z.ZodObject<{
+    auto: z.ZodDefault<z.ZodBoolean>;
+    application: z.ZodString;
+    idleTimeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    routePrefix: z.ZodDefault<z.ZodString>;
+    gatewayPort: z.ZodDefault<z.ZodNumber>;
+    connectTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    commandTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    metricsIntervalSeconds: z.ZodDefault<z.ZodNumber>;
+    sshTransport: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodEnum<{
+        auto: "auto";
+        openssh: "openssh";
+        ssh2: "ssh2";
+    }>>>;
+    ssh2Patch: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodEnum<{
+        true: "true";
+        false: "false";
+        auto: "auto";
+    }>>>;
+    keyDirectory: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SerializableLakeboxPluginConfig = z.input<typeof LakeboxPluginConfigSchema>;
+export type ResolvedLakeboxPluginConfig = z.output<typeof LakeboxPluginConfigSchema>;
+/**
+ * Configuration accepted by the Lakebox AppKit plugin.
+ *
+ * Pass a shared runtime when the plugin and the Mastra workspace resolver must
+ * use the same sessions, routes, and metrics.
+ */
+export type LakeboxPluginConfig = BasePluginConfig & Partial<SerializableLakeboxPluginConfig> & {
+    runtime?: import("./runtime.ts").LakeboxRuntime;
+};
+/**
+ * Resolves defaults through configUtils and removes AppKit-only fields.
+ *
+ * @throws A Zod validation error when a field has an invalid type or range.
+ */
+export declare function resolveLakeboxPluginConfig(config?: LakeboxPluginConfig): ResolvedLakeboxPluginConfig;

package/lib/src/config.js

@@ -0,0 +1,86 @@
+import { basename } from "node:path";
+import { configUtils, projectUtils } from "@dbx-tools/core";
+import { Ssh2PatchModeSchema, SshTransportModeSchema } from "@dbx-tools/lakebox/transport";
+import { LAKEBOX_DEFAULT_ROUTE_PREFIX } from "@dbx-tools/shared-lakebox";
+import { z } from "zod";
+const APPLICATION_CONFIG_KEY = "LAKEBOX_APPLICATION";
+const IDLE_TIMEOUT_CONFIG_KEY = "LAKEBOX_IDLE_TIMEOUT_SECONDS";
+const SSH_TRANSPORT_CONFIG_KEY = "LAKEBOX_SSH_TRANSPORT";
+const SSH2_PATCH_CONFIG_KEY = "LAKEBOX_SSH_SSH2_PATCH";
+export const LakeboxPluginConfigSchema = z
+    .object({
+    auto: z
+        .boolean()
+        .default(true)
+        .describe("Whether commands, services, and routes create or start the app Lakebox on demand. Defaults to true."),
+    application: z
+        .string()
+        .trim()
+        .min(1)
+        .describe(`Stable application key for the persisted Lakebox resource ID. Defaults to ${configUtils.name(APPLICATION_CONFIG_KEY)}, then DATABRICKS_APP_NAME, then the project directory name.`),
+    idleTimeoutSeconds: z
+        .number()
+        .int()
+        .min(60)
+        .max(86_400)
+        .default(3_600)
+        .describe(`Platform idle timeout that stops the Lakebox after inactivity, from 60 to 86400 seconds. Defaults to 3600; configure with ${configUtils.name(IDLE_TIMEOUT_CONFIG_KEY)}.`),
+    routePrefix: z
+        .string()
+        .startsWith("/")
+        .default(LAKEBOX_DEFAULT_ROUTE_PREFIX)
+        .describe("AppKit root path for user service routes. Defaults to /lakebox."),
+    gatewayPort: z
+        .number()
+        .int()
+        .min(1)
+        .max(65535)
+        .default(2222)
+        .describe("Lakebox SSH gateway port. Defaults to 2222."),
+    connectTimeoutMs: z
+        .number()
+        .int()
+        .positive()
+        .default(30_000)
+        .describe("SSH connection timeout in milliseconds. Defaults to 30000."),
+    commandTimeoutMs: z
+        .number()
+        .int()
+        .positive()
+        .default(120_000)
+        .describe("Default command timeout in milliseconds. Defaults to 120000."),
+    metricsIntervalSeconds: z
+        .number()
+        .int()
+        .min(1)
+        .max(300)
+        .default(5)
+        .describe("Interval between metrics samples while the Lakebox runs. Defaults to 5."),
+    sshTransport: SshTransportModeSchema.describe(`SSH transport: auto, openssh, or ssh2. Configure with ${configUtils.name(SSH_TRANSPORT_CONFIG_KEY)}.`),
+    ssh2Patch: Ssh2PatchModeSchema.describe(`ssh2 missing-exec-reply workaround: auto, true, or false. Configure with ${configUtils.name(SSH2_PATCH_CONFIG_KEY)}.`),
+    keyDirectory: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Server-side directory for the app SSH key and gateway host keys."),
+})
+    .strict()
+    .describe("Serializable Lakebox AppKit plugin configuration.");
+/**
+ * Resolves defaults through configUtils and removes AppKit-only fields.
+ *
+ * @throws A Zod validation error when a field has an invalid type or range.
+ */
+export function resolveLakeboxPluginConfig(config = {}) {
+    const { runtime: _runtime, name: _name, host: _host, context: _context, telemetry: _telemetry, streamConfig: _stream, application, idleTimeoutSeconds, sshTransport, ssh2Patch, ...serializable } = config;
+    return LakeboxPluginConfigSchema.parse({
+        ...serializable,
+        application: configUtils.string(application, APPLICATION_CONFIG_KEY) ??
+            configUtils.string(undefined, "DATABRICKS_APP_NAME", configUtils.ENV_ONLY) ??
+            basename(projectUtils.root() ?? process.cwd()),
+        idleTimeoutSeconds: configUtils.positiveInt(idleTimeoutSeconds, IDLE_TIMEOUT_CONFIG_KEY, 3_600),
+        sshTransport: configUtils.string(sshTransport, SSH_TRANSPORT_CONFIG_KEY),
+        ssh2Patch: configUtils.string(ssh2Patch, SSH2_PATCH_CONFIG_KEY),
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBRXJDLE9BQU8sRUFBRSxXQUFXLEVBQUUsWUFBWSxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFDNUQsT0FBTyxFQUFFLG1CQUFtQixFQUFFLHNCQUFzQixFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFDM0YsT0FBTyxFQUFFLDRCQUE0QixFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDekUsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixNQUFNLHNCQUFzQixHQUFHLHFCQUFxQixDQUFDO0FBQ3JELE1BQU0sdUJBQXVCLEdBQUcsOEJBQThCLENBQUM7QUFDL0QsTUFBTSx3QkFBd0IsR0FBRyx1QkFBdUIsQ0FBQztBQUN6RCxNQUFNLHFCQUFxQixHQUFHLHdCQUF3QixDQUFDO0FBRXZELE1BQU0sQ0FBQyxNQUFNLHlCQUF5QixHQUFHLENBQUM7S0FDdkMsTUFBTSxDQUFDO0lBQ04sSUFBSSxFQUFFLENBQUM7U0FDSixPQUFPLEVBQUU7U0FDVCxPQUFPLENBQUMsSUFBSSxDQUFDO1NBQ2IsUUFBUSxDQUNQLHFHQUFxRyxDQUN0RztJQUNILFdBQVcsRUFBRSxDQUFDO1NBQ1gsTUFBTSxFQUFFO1NBQ1IsSUFBSSxFQUFFO1NBQ04sR0FBRyxDQUFDLENBQUMsQ0FBQztTQUNOLFFBQVEsQ0FDUCw2RUFBNkUsV0FBVyxDQUFDLElBQUksQ0FBQyxzQkFBc0IsQ0FBQyw4REFBOEQsQ0FDcEw7SUFDSCxrQkFBa0IsRUFBRSxDQUFDO1NBQ2xCLE1BQU0sRUFBRTtTQUNSLEdBQUcsRUFBRTtTQUNMLEdBQUcsQ0FBQyxFQUFFLENBQUM7U0FDUCxHQUFHLENBQUMsTUFBTSxDQUFDO1NBQ1gsT0FBTyxDQUFDLEtBQUssQ0FBQztTQUNkLFFB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OlsiaW1wb3J0IHsgYmFzZW5hbWUgfSBmcm9tIFwibm9kZTpwYXRoXCI7XG5pbXBvcnQgdHlwZSB7IEJhc2VQbHVnaW5Db25maWcgfSBmcm9tIFwiQGRhdGFicmlja3MvYXBwa2l0XCI7XG5pbXBvcnQgeyBjb25maWdVdGlscywgcHJvamVjdFV0aWxzIH0gZnJvbSBcIkBkYngtdG9vbHMvY29yZVwiO1xuaW1wb3J0IHsgU3NoMlBhdGNoTW9kZVNjaGVtYSwgU3NoVHJhbnNwb3J0TW9kZVNjaGVtYSB9IGZyb20gXCJAZGJ4LXRvb2xzL2xha2Vib3gvdHJhbnNwb3J0XCI7XG5pbXBvcnQgeyBMQUtFQk9YX0RFRkFVTFRfUk9VVEVfUFJFRklYIH0gZnJvbSBcIkBkYngtdG9vbHMvc2hhcmVkLWxha2Vib3hcIjtcbmltcG9ydCB7IHogfSBmcm9tIFwiem9kXCI7XG5cbmNvbnN0IEFQUExJQ0FUSU9OX0NPTkZJR19LRVkgPSBcIkxBS0VCT1hfQVBQTElDQVRJT05cIjtcbmNvbnN0IElETEVfVElNRU9VVF9DT05GSUdfS0VZID0gXCJMQUtFQk9YX0lETEVfVElNRU9VVF9TRUNPTkRTXCI7XG5jb25zdCBTU0hfVFJBTlNQT1JUX0NPTkZJR19LRVkgPSBcIkxBS0VCT1hfU1NIX1RSQU5TUE9SVFwiO1xuY29uc3QgU1NIMl9QQVRDSF9DT05GSUdfS0VZID0gXCJMQUtFQk9YX1NTSF9TU0gyX1BBVENIXCI7XG5cbmV4cG9ydCBjb25zdCBMYWtlYm94UGx1Z2luQ29uZmlnU2NoZW1hID0gelxuICAub2JqZWN0KHtcbiAgICBhdXRvOiB6XG4gICAgICAuYm9vbGVhbigpXG4gICAgICAuZGVmYXVsdCh0cnVlKVxuICAgICAgLmRlc2NyaWJlKFxuICAgICAgICBcIldoZXRoZXIgY29tbWFuZHMsIHNlcnZpY2VzLCBhbmQgcm91dGVzIGNyZWF0ZSBvciBzdGFydCB0aGUgYXBwIExha2Vib3ggb24gZGVtYW5kLiBEZWZhdWx0cyB0byB0cnVlLlwiLFxuICAgICAgKSxcbiAgICBhcHBsaWNhdGlvbjogelxuICAgICAgLnN0cmluZygpXG4gICAgICAudHJpbSgpXG4gICAgICAubWluKDEpXG4gICAgICAuZGVzY3JpYmUoXG4gICAgICAgIGBTdGFibGUgYXBwbGljYXRpb24ga2V5IGZvciB0aGUgcGVyc2lzdGVkIExha2Vib3ggcmVzb3VyY2UgSUQuIERlZmF1bHRzIHRvICR7Y29uZmlnVXRpbHMubmFtZShBUFBMSUNBVElPTl9DT05GSUdfS0VZKX0sIHRoZW4gREFUQUJSSUNLU19BUFBfTkFNRSwgdGhlbiB0aGUgcHJvamVjdCBkaXJlY3RvcnkgbmFtZS5gLFxuICAgICAgKSxcbiAgICBpZGxlVGltZW91dFNlY29uZHM6IHpcbiAgICAgIC5udW1iZXIoKVxuICAgICAgLmludCgpXG4gICAgICAubWluKDYwKVxuICAgICAgLm1heCg4Nl80MDApXG4gICAgICAuZGVmYXVsdCgzXzYwMClcbiAgICAgIC5kZXNjcmliZShcbiAgICAgICAgYFBsYXRmb3JtIGlkbGUgdGltZW91dCB0aGF0IHN0b3BzIHRoZSBMYWtlYm94IGFmdGVyIGluYWN0aXZpdHksIGZyb20gNjAgdG8gODY0MDAgc2Vjb25kcy4gRGVmYXVsdHMgdG8gMzYwMDsgY29uZmlndXJlIHdpdGggJHtjb25maWdVdGlscy5uYW1lKElETEVfVElNRU9VVF9DT05GSUdfS0VZKX0uYCxcbiAgICAgICksXG4gICAgcm91dGVQcmVmaXg6IHpcbiAgICAgIC5zdHJpbmcoKVxuICAgICAgLnN0YXJ0c1dpdGgoXCIvXCIpXG4gICAgICAuZGVmYXVsdChMQUtFQk9YX0RFRkFVTFRfUk9VVEVfUFJFRklYKVxuICAgICAgLmRlc2NyaWJlKFwiQXBwS2l0IHJvb3QgcGF0aCBmb3IgdXNlciBzZXJ2aWNlIHJvdXRlcy4gRGVmYXVsdHMgdG8gL2xha2Vib3guXCIpLFxuICAgIGdhdGV3YXlQb3J0OiB6XG4gICAgICAubnVtYmVyKClcbiAgICAgIC5pbnQoKVxuICAgICAgLm1pbigxKVxuICAgICAgLm1heCg2NTUzNSlcbiAgICAgIC5kZWZhdWx0KDIyMjIpXG4gICAgICAuZGVzY3JpYmUoXCJMYWtlYm94IFNTSCBnYXRld2F5IHBvcnQuIERlZmF1bHRzIHRvIDIyMjIuXCIpLFxuICAgIGNvbm5lY3RUaW1lb3V0TXM6IHpcbiAgICAgIC5udW1iZXIoKVxuICAgICAgLmludCgpXG4gICAgICAucG9zaXRpdmUoKVxuICAgICAgLmRlZmF1bHQoMzBfMDAwKVxuICAgICAgLmRlc2NyaWJlKFwiU1NIIGNvbm5lY3Rpb24gdGltZW91dCBpbiBtaWxsaXNlY29uZHMuIERlZmF1bHRzIHRvIDMwMDAwLlwiKSxcbiAgICBjb21tYW5kVGltZW91dE1zOiB6XG4gICAgICAubnVtYmVyKClcbiAgICAgIC5pbnQoKVxuICAgICAgLnBvc2l0aXZlKClcbiAgICAgIC5kZWZhdWx0KDEyMF8wMDApXG4gICAgICAuZGVzY3JpYmUoXCJEZWZhdWx0IGNvbW1hbmQgdGltZW91dCBpbiBtaWxsaXNlY29uZHMuIERlZmF1bHRzIHRvIDEyMDAwMC5cIiksXG4gICAgbWV0cmljc0ludGVydmFsU2Vjb25kczogelxuICAgICAgLm51bWJlcigpXG4gICAgICAuaW50KClcbiAgICAgIC5taW4oMSlcbiAgICAgIC5tYXgoMzAwKVxuICAgICAgLmRlZmF1bHQoNSlcbiAgICAgIC5kZXNjcmliZShcIkludGVydmFsIGJldHdlZW4gbWV0cmljcyBzYW1wbGVzIHdoaWxlIHRoZSBMYWtlYm94IHJ1bnMuIERlZmF1bHRzIHRvIDUuXCIpLFxuICAgIHNzaFRyYW5zcG9ydDogU3NoVHJhbnNwb3J0TW9kZVNjaGVtYS5kZXNjcmliZShcbiAgICAgIGBTU0ggdHJhbnNwb3J0OiBhdXRvLCBvcGVuc3NoLCBvciBzc2gyLiBDb25maWd1cmUgd2l0aCAke2NvbmZpZ1V0aWxzLm5hbWUoU1NIX1RSQU5TUE9SVF9DT05GSUdfS0VZKX0uYCxcbiAgICApLFxuICAgIHNzaDJQYXRjaDogU3NoMlBhdGNoTW9kZVNjaGVtYS5kZXNjcmliZShcbiAgICAgIGBzc2gyIG1pc3NpbmctZXhlYy1yZXBseSB3b3JrYXJvdW5kOiBhdXRvLCB0cnVlLCBvciBmYWxzZS4gQ29uZmlndXJlIHdpdGggJHtjb25maWdVdGlscy5uYW1lKFNTSDJfUEFUQ0hfQ09ORklHX0tFWSl9LmAsXG4gICAgKSxcbiAgICBrZXlEaXJlY3Rvcnk6IHpcbiAgICAgIC5zdHJpbmcoKVxuICAgICAgLm1pbigxKVxuICAgICAgLm9wdGlvbmFsKClcbiAgICAgIC5kZXNjcmliZShcIlNlcnZlci1zaWRlIGRpcmVjdG9yeSBmb3IgdGhlIGFwcCBTU0gga2V5IGFuZCBnYXRld2F5IGhvc3Qga2V5cy5cIiksXG4gIH0pXG4gIC5zdHJpY3QoKVxuICAuZGVzY3JpYmUoXCJTZXJpYWxpemFibGUgTGFrZWJveCBBcHBLaXQgcGx1Z2luIGNvbmZpZ3VyYXRpb24uXCIpO1xuXG5leHBvcnQgdHlwZSBTZXJpYWxpemFibGVMYWtlYm94UGx1Z2luQ29uZmlnID0gei5pbnB1dDx0eXBlb2YgTGFrZWJveFBsdWdpbkNvbmZpZ1NjaGVtYT47XG5leHBvcnQgdHlwZSBSZXNvbHZlZExha2Vib3hQbHVnaW5Db25maWcgPSB6Lm91dHB1dDx0eXBlb2YgTGFrZWJveFBsdWdpbkNvbmZpZ1NjaGVtYT47XG5cbi8qKlxuICogQ29uZmlndXJhdGlvbiBhY2NlcHRlZCBieSB0aGUgTGFrZWJveCBBcHBLaXQgcGx1Z2luLlxuICpcbiAqIFBhc3MgYSBzaGFyZWQgcnVudGltZSB3aGVuIHRoZSBwbHVnaW4gYW5kIHRoZSBNYXN0cmEgd29ya3NwYWNlIHJlc29sdmVyIG11c3RcbiAqIHVzZSB0aGUgc2FtZSBzZXNzaW9ucywgcm91dGVzLCBhbmQgbWV0cmljcy5cbiAqL1xuZXhwb3J0IHR5cGUgTGFrZWJveFBsdWdpbkNvbmZpZyA9IEJhc2VQbHVnaW5Db25maWcgJlxuICBQYXJ0aWFsPFNlcmlhbGl6YWJsZUxha2Vib3hQbHVnaW5Db25maWc+ICYge1xuICAgIHJ1bnRpbWU/OiBpbXBvcnQoXCIuL3J1bnRpbWUudHNcIikuTGFrZWJveFJ1bnRpbWU7XG4gIH07XG5cbi8qKlxuICogUmVzb2x2ZXMgZGVmYXVsdHMgdGhyb3VnaCBjb25maWdVdGlscyBhbmQgcmVtb3ZlcyBBcHBLaXQtb25seSBmaWVsZHMuXG4gKlxuICogQHRocm93cyBBIFpvZCB2YWxpZGF0aW9uIGVycm9yIHdoZW4gYSBmaWVsZCBoYXMgYW4gaW52YWxpZCB0eXBlIG9yIHJhbmdlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVzb2x2ZUxha2Vib3hQbHVnaW5Db25maWcoXG4gIGNvbmZpZzogTGFrZWJveFBsdWdpbkNvbmZpZyA9IHt9LFxuKTogUmVzb2x2ZWRMYWtlYm94UGx1Z2luQ29uZmlnIHtcbiAgY29uc3Qge1xuICAgIHJ1bnRpbWU6IF9ydW50aW1lLFxuICAgIG5hbWU6IF9uYW1lLFxuICAgIGhvc3Q6IF9ob3N0LFxuICAgIGNvbnRleHQ6IF9jb250ZXh0LFxuICAgIHRlbGVtZXRyeTogX3RlbGVtZXRyeSxcbiAgICBzdHJlYW1Db25maWc6IF9zdHJlYW0sXG4gICAgYXBwbGljYXRpb24sXG4gICAgaWRsZVRpbWVvdXRTZWNvbmRzLFxuICAgIHNzaFRyYW5zcG9ydCxcbiAgICBzc2gyUGF0Y2gsXG4gICAgLi4uc2VyaWFsaXphYmxlXG4gIH0gPSBjb25maWc7XG4gIHJldHVybiBMYWtlYm94UGx1Z2luQ29uZmlnU2NoZW1hLnBhcnNlKHtcbiAgICAuLi5zZXJpYWxpemFibGUsXG4gICAgYXBwbGljYXRpb246XG4gICAgICBjb25maWdVdGlscy5zdHJpbmcoYXBwbGljYXRpb24sIEFQUExJQ0FUSU9OX0NPTkZJR19LRVkpID8/XG4gICAgICBjb25maWdVdGlscy5zdHJpbmcodW5kZWZpbmVkLCBcIkRBVEFCUklDS1NfQVBQX05BTUVcIiwgY29uZmlnVXRpbHMuRU5WX09OTFkpID8/XG4gICAgICBiYXNlbmFtZShwcm9qZWN0VXRpbHMucm9vdCgpID8/IHByb2Nlc3MuY3dkKCkpLFxuICAgIGlkbGVUaW1lb3V0U2Vjb25kczogY29uZmlnVXRpbHMucG9zaXRpdmVJbnQoaWRsZVRpbWVvdXRTZWNvbmRzLCBJRExFX1RJTUVPVVRfQ09ORklHX0tFWSwgM182MDApLFxuICAgIHNzaFRyYW5zcG9ydDogY29uZmlnVXRpbHMuc3RyaW5nKHNzaFRyYW5zcG9ydCwgU1NIX1RSQU5TUE9SVF9DT05GSUdfS0VZKSxcbiAgICBzc2gyUGF0Y2g6IGNvbmZpZ1V0aWxzLnN0cmluZyhzc2gyUGF0Y2gsIFNTSDJfUEFUQ0hfQ09ORklHX0tFWSksXG4gIH0pO1xufVxuIl19

package/lib/src/desktop.d.ts

@@ -0,0 +1,6 @@
+/** Markup injected into the KasmVNC client page to apply dbx-tools branding. */
+export declare const desktopHtmlHead: string;
+/** Browser entry URL for the built-in KasmVNC desktop. */
+export declare function desktopOpenUrl(path: string): string;
+/** Branding environment consumed by the packaged desktop session entrypoint. */
+export declare function desktopEnvironment(): Readonly<Record<string, string>>;

package/lib/src/desktop.js

@@ -0,0 +1,88 @@
+import { brandUtils } from "@dbx-tools/shared-core";
+import { dbxToolsAssetDataUrls, dbxToolsAssetSvg } from "@dbx-tools/ui/branding/assets";
+const BRAND = brandUtils.defaultBrandContext;
+const BRAND_COLORS = BRAND.colors;
+const WALLPAPER_LOGO = dbxToolsAssetSvg.logoDark.replace("<svg ", '<svg x="500" y="378" width="600" height="135" ');
+const DBX_TOOLS_WALLPAPER = 
+// ============================================================================
+/*xml*/ `
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="1000" viewBox="0 0 1600 1000">
+  <defs>
+    <linearGradient id="background" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#0B161B"/>
+      <stop offset="0.55" stop-color="${BRAND_COLORS.primary}"/>
+      <stop offset="1" stop-color="${BRAND_COLORS.primaryHover}"/>
+    </linearGradient>
+    <pattern id="grid" width="64" height="64" patternUnits="userSpaceOnUse">
+      <path d="M64 0H0V64" fill="none" stroke="${BRAND_COLORS.surface}" stroke-opacity="0.045"/>
+    </pattern>
+  </defs>
+  <rect width="1600" height="1000" fill="url(#background)"/>
+  <rect width="1600" height="1000" fill="url(#grid)"/>
+  <path d="M0 780C310 650 475 920 780 775s500-220 820-55v280H0Z" fill="${BRAND_COLORS.accent}" fill-opacity="0.13"/>
+  <path d="M0 835c300-125 510 105 790-10s500-170 810-65" fill="none" stroke="${BRAND_COLORS.accent}" stroke-width="4" stroke-opacity="0.7"/>
+  ${WALLPAPER_LOGO}
+  <text x="800" y="558" text-anchor="middle" fill="${BRAND_COLORS.muted}" font-family="${BRAND.typography.sans}" font-size="24" letter-spacing="5">LAKEBOX DESKTOP</text>
+</svg>
+`
+    // ============================================================================
+    .trim();
+const DBX_TOOLS_TERMINAL_ICON = 
+// ============================================================================
+/*xml*/ `
+<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 64 64">
+  <rect x="4" y="6" width="56" height="52" rx="12" fill="${BRAND_COLORS.primary}"/>
+  <rect x="8" y="10" width="48" height="44" rx="8" fill="${BRAND_COLORS.primaryHover}"/>
+  <path d="m18 23 9 9-9 9" fill="none" stroke="${BRAND_COLORS.surface}" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M34 41h12" fill="none" stroke="${BRAND_COLORS.accent}" stroke-width="4" stroke-linecap="round"/>
+</svg>
+`
+    // ============================================================================
+    .trim();
+const DESKTOP_BRAND_HEAD = 
+// ============================================================================
+/*html*/ `
+<style id="dbx-tools-desktop-brand">
+html,body{width:100%;max-width:100%;height:100%;max-height:100%;min-width:0;min-height:0;overflow:hidden}
+body{position:fixed;inset:0;width:var(--dbx-tools-viewport-width,100vw);height:var(--dbx-tools-viewport-height,100dvh)}
+#noVNC_container{width:100%!important;max-width:100%;height:100%!important;max-height:100%;overflow:hidden}
+.noVNC_logo,h1.noVNC_logo,a[title="KasmVNC Learn More"]{display:none!important}
+#noVNC_fallback_errormsg{overflow-wrap:anywhere}
+</style>
+<link data-dbx-tools-desktop-icon rel="icon" href="${dbxToolsAssetDataUrls.iconDark}">
+<script id="dbx-tools-kasm-mobile-guard">(()=>{const ignored=(error)=>error instanceof ReferenceError&&/^Can't find variable: W[0-9A-F]{32}$/.test(error.message);window.addEventListener("error",(event)=>{if(ignored(event.error)){event.preventDefault();event.stopImmediatePropagation()}},true);window.addEventListener("unhandledrejection",(event)=>{if(ignored(event.reason)){event.preventDefault();event.stopImmediatePropagation()}},true);let timer;const sync=()=>{const viewport=window.visualViewport;document.documentElement.style.setProperty("--dbx-tools-viewport-width",String(Math.round(viewport?.width??window.innerWidth))+"px");document.documentElement.style.setProperty("--dbx-tools-viewport-height",String(Math.round(viewport?.height??window.innerHeight))+"px");window.dispatchEvent(new Event("resize"))};const schedule=()=>{clearTimeout(timer);sync();setTimeout(sync,250);timer=setTimeout(sync,750)};window.visualViewport?.addEventListener("resize",schedule);window.visualViewport?.addEventListener("scroll",schedule);window.addEventListener("orientationchange",schedule);window.addEventListener("pageshow",schedule);document.readyState==="loading"?document.addEventListener("DOMContentLoaded",schedule,{once:true}):schedule()})();</script>
+<script id="dbx-tools-desktop-brand-script">(()=>{const icon=${JSON.stringify(dbxToolsAssetDataUrls.iconDark)};const rewrite=(root)=>{if(root.nodeType===Node.TEXT_NODE){if(root.nodeValue?.includes("KasmVNC"))root.nodeValue=root.nodeValue.replaceAll("KasmVNC","dbx tools Desktop");return}const walker=document.createTreeWalker(root,NodeFilter.SHOW_TEXT);let node;while(node=walker.nextNode())if(node.nodeValue?.includes("KasmVNC"))node.nodeValue=node.nodeValue.replaceAll("KasmVNC","dbx tools Desktop")};const apply=()=>{document.title="dbx tools Desktop";for(const link of document.querySelectorAll('link[rel~="icon"],link[rel="apple-touch-icon"]'))link.setAttribute("href",icon);if(document.body)rewrite(document.body)};if(document.readyState==="loading")document.addEventListener("DOMContentLoaded",apply,{once:true});else apply();new MutationObserver((entries)=>{for(const entry of entries){if(entry.type==="characterData")rewrite(entry.target);else for(const node of entry.addedNodes)rewrite(node)}}).observe(document.documentElement,{childList:true,subtree:true,characterData:true})})();</script>
+`
+    // ============================================================================
+    .trim();
+/** Markup injected into the KasmVNC client page to apply dbx-tools branding. */
+export const desktopHtmlHead = DESKTOP_BRAND_HEAD;
+/** Browser entry URL for the built-in KasmVNC desktop. */
+export function desktopOpenUrl(path) {
+    const normalized = path.replace(/\/+$/, "");
+    const websocketPath = `${normalized.replace(/^\/+/, "")}/websockify`;
+    const parameters = new URLSearchParams({
+        autoconnect: "1",
+        resize: "remote",
+        show_dot: "1",
+        clipboard_seamless: "0",
+        enable_webp: "0",
+        kasmvnc_mode_preference: "-1027",
+        path: websocketPath,
+    });
+    return `${normalized}/?${parameters.toString()}`;
+}
+/** Branding environment consumed by the packaged desktop session entrypoint. */
+export function desktopEnvironment() {
+    return {
+        DBX_TOOLS_DESKTOP_WALLPAPER_BASE64: Buffer.from(DBX_TOOLS_WALLPAPER).toString("base64"),
+        DBX_TOOLS_DESKTOP_BRAND_ICON_BASE64: Buffer.from(dbxToolsAssetSvg.iconDark).toString("base64"),
+        DBX_TOOLS_DESKTOP_TERMINAL_ICON_BASE64: Buffer.from(DBX_TOOLS_TERMINAL_ICON).toString("base64"),
+        DBX_TOOLS_DESKTOP_HOMEPAGE_BASE64: Buffer.from(BRAND.links.website).toString("base64"),
+        DBX_TOOLS_DESKTOP_PRIMARY: BRAND_COLORS.primary,
+        DBX_TOOLS_DESKTOP_PRIMARY_HOVER: BRAND_COLORS.primaryHover,
+        DBX_TOOLS_DESKTOP_SURFACE: BRAND_COLORS.surface,
+        DBX_TOOLS_DESKTOP_FONT: "DejaVu Sans",
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVza3RvcC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9kZXNrdG9wLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUNwRCxPQUFPLEVBQUUscUJBQXFCLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUV4RixNQUFNLEtBQUssR0FBRyxVQUFVLENBQUMsbUJBQW1CLENBQUM7QUFDN0MsTUFBTSxZQUFZLEdBQUcsS0FBSyxDQUFDLE1BQU0sQ0FBQztBQUNsQyxNQUFNLGNBQWMsR0FBRyxnQkFBZ0IsQ0FBQyxRQUFRLENBQUMsT0FBTyxDQUN0RCxPQUFPLEVBQ1AsZ0RBQWdELENBQ2pELENBQUM7QUFFRixNQUFNLG1CQUFtQjtBQUN2QiwrRUFBK0U7QUFDL0UsT0FBTyxDQUFDOzs7Ozt3Q0FLOEIsWUFBWSxDQUFDLE9BQU87cUNBQ3ZCLFlBQVksQ0FBQyxZQUFZOzs7aURBR2IsWUFBWSxDQUFDLE9BQU87Ozs7O3lFQUtJLFlBQVksQ0FBQyxNQUFNOytFQUNiLFlBQVksQ0FBQyxNQUFNO0lBQzlGLGNBQWM7cURBQ21DLFlBQVksQ0FBQyxLQUFLLGtCQUFrQixLQUFLLENBQUMsVUFBVSxDQUFDLElBQUk7O0NBRTdHO0lBQ0csK0VBQStFO0tBQzlFLElBQUksRUFBRSxDQUFDO0FBRVosTUFBTSx1QkFBdUI7QUFDM0IsK0VBQStFO0FBQy9FLE9BQU8sQ0FBQzs7MkRBRWlELFlBQVksQ0FBQyxPQUFPOzJEQUNwQixZQUFZLENBQUMsWUFBWTtpREFDbkMsWUFBWSxDQUFDLE9BQU87NENBQ3pCLFlBQVksQ0FBQyxNQUFNOztDQUU5RDtJQUNHLCtFQUErRTtLQUM5RSxJQUFJLEVBQUUsQ0FBQztBQUVaLE1BQU0sa0JBQWtCO0FBQ3RCLCtFQUErRTtBQUMvRSxRQUFRLENBQUM7Ozs7Ozs7O3FEQVEwQyxxQkFBcUIsQ0FBQyxRQUFROzsrREFFcEIsSUFBSSxDQUFDLFNBQVMsQ0FBQyxxQkFBcUIsQ0FBQyxRQUFRLENBQUM7Q0FDNUc7SUFDRywrRUFBK0U7S0FDOUUsSUFBSSxFQUFFLENBQUM7QUFFWixnRkFBZ0Y7QUFDaEYsTUFBTSxDQUFDLE1BQU0sZUFBZSxHQUFHLGtCQUFrQixDQUFDO0FBRWxELDBEQUEwRDtBQUMxRCxNQUFNLFVBQVUsY0FBYyxDQUFDLElBQVk7SUFDekMsTUFBTSxVQUFVLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDNUMsTUFBTSxhQUFhLEdBQUcsR0FBRyxVQUFVLENBQUMsT0FBTyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsYUFBYSxDQUFDO0lBQ3JFLE1BQU0sVUFBVSxHQUFHLElBQUksZUFBZSxDQUFDO1FBQ3JDLFdBQVcsRUFBRSxHQUFHO1FBQ2hCLE1BQU0sRUFBRSxRQUFRO1FBQ2hCLFFBQVEsRUFBRSxHQUFHO1FBQ2Isa0JBQWtCLEVBQUUsR0FBRztRQUN2QixXQUFXLEVBQUUsR0FBRztRQUNoQix1QkFBdUIsRUFBRSxPQUFPO1FBQ2hDLElBQUksRUFBRSxhQUFhO0tBQ3BCLENBQUMsQ0FBQztJQUNILE9BQU8sR0FBRyxVQUFVLEtBQUssVUFBVSxDQUFDLFFBQVEsRUFBRSxFQUFFLENBQUM7QUFDbkQsQ0FBQztBQUVELGdGQUFnRjtBQUNoRixNQUFNLFVBQVUsa0JBQWtCO0lBQ2hDLE9BQU87UUFDTCxrQ0FBa0MsRUFBRSxNQUFNLENBQUMsSUFBSSxDQUFDLG1CQUFtQixDQUFDLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQztRQUN2RixtQ0FBbUMsRUFBRSxNQUFNLENBQUMsSUFBSSxDQUFDLGdCQUFnQixDQUFDLFFBQVEsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUM7UUFDOUYsc0NBQXNDLEVBQUUsTUFBTSxDQUFDLElBQUksQ0FBQyx1QkFBdUIsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUM7UUFDL0YsaUNBQWlDLEVBQUUsTUFBTSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUM7UUFDdEYseUJBQXlCLEVBQUUsWUFBWSxDQUFDLE9BQU87UUFDL0MsK0JBQStCLEVBQUUsWUFBWSxDQUFDLFlBQVk7UUFDMUQseUJBQXlCLEVBQUUsWUFBWSxDQUFDLE9BQU87UUFDL0Msc0JBQXNCLEVBQUUsYUFBYTtLQUN0QyxDQUFDO0FBQ0osQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IGJyYW5kVXRpbHMgfSBmcm9tIFwiQGRieC10b29scy9zaGFyZWQtY29yZVwiO1xuaW1wb3J0IHsgZGJ4VG9vbHNBc3NldERhdGFVcmxzLCBkYnhUb29sc0Fzc2V0U3ZnIH0gZnJvbSBcIkBkYngtdG9vbHMvdWkvYnJhbmRpbmcvYXNzZXRzXCI7XG5cbmNvbnN0IEJSQU5EID0gYnJhbmRVdGlscy5kZWZhdWx0QnJhbmRDb250ZXh0O1xuY29uc3QgQlJBTkRfQ09MT1JTID0gQlJBTkQuY29sb3JzO1xuY29uc3QgV0FMTFBBUEVSX0xPR08gPSBkYnhUb29sc0Fzc2V0U3ZnLmxvZ29EYXJrLnJlcGxhY2UoXG4gIFwiPHN2ZyBcIixcbiAgJzxzdmcgeD1cIjUwMFwiIHk9XCIzNzhcIiB3aWR0aD1cIjYwMFwiIGhlaWdodD1cIjEzNVwiICcsXG4pO1xuXG5jb25zdCBEQlhfVE9PTFNfV0FMTFBBUEVSID1cbiAgLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuICAvKnhtbCovIGBcbjxzdmcgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiIHdpZHRoPVwiMTYwMFwiIGhlaWdodD1cIjEwMDBcIiB2aWV3Qm94PVwiMCAwIDE2MDAgMTAwMFwiPlxuICA8ZGVmcz5cbiAgICA8bGluZWFyR3JhZGllbnQgaWQ9XCJiYWNrZ3JvdW5kXCIgeDE9XCIwXCIgeTE9XCIwXCIgeDI9XCIxXCIgeTI9XCIxXCI+XG4gICAgICA8c3RvcCBvZmZzZXQ9XCIwXCIgc3RvcC1jb2xvcj1cIiMwQjE2MUJcIi8+XG4gICAgICA8c3RvcCBvZmZzZXQ9XCIwLjU1XCIgc3RvcC1jb2xvcj1cIiR7QlJBTkRfQ09MT1JTLnByaW1hcnl9XCIvPlxuICAgICAgPHN0b3Agb2Zmc2V0PVwiMVwiIHN0b3AtY29sb3I9XCIke0JSQU5EX0NPTE9SUy5wcmltYXJ5SG92ZXJ9XCIvPlxuICAgIDwvbGluZWFyR3JhZGllbnQ+XG4gICAgPHBhdHRlcm4gaWQ9XCJncmlkXCIgd2lkdGg9XCI2NFwiIGhlaWdodD1cIjY0XCIgcGF0dGVyblVuaXRzPVwidXNlclNwYWNlT25Vc2VcIj5cbiAgICAgIDxwYXRoIGQ9XCJNNjQgMEgwVjY0XCIgZmlsbD1cIm5vbmVcIiBzdHJva2U9XCIke0JSQU5EX0NPTE9SUy5zdXJmYWNlfVwiIHN0cm9rZS1vcGFjaXR5PVwiMC4wNDVcIi8+XG4gICAgPC9wYXR0ZXJuPlxuICA8L2RlZnM+XG4gIDxyZWN0IHdpZHRoPVwiMTYwMFwiIGhlaWdodD1cIjEwMDBcIiBmaWxsPVwidXJsKCNiYWNrZ3JvdW5kKVwiLz5cbiAgPHJlY3Qgd2lkdGg9XCIxNjAwXCIgaGVpZ2h0PVwiMTAwMFwiIGZpbGw9XCJ1cmwoI2dyaWQpXCIvPlxuICA8cGF0aCBkPVwiTTAgNzgwQzMxMCA2NTAgNDc1IDkyMCA3ODAgNzc1czUwMC0yMjAgODIwLTU1djI4MEgwWlwiIGZpbGw9XCIke0JSQU5EX0NPTE9SUy5hY2NlbnR9XCIgZmlsbC1vcGFjaXR5PVwiMC4xM1wiLz5cbiAgPHBhdGggZD1cIk0wIDgzNWMzMDAtMTI1IDUxMCAxMDUgNzkwLTEwczUwMC0xNzAgODEwLTY1XCIgZmlsbD1cIm5vbmVcIiBzdHJva2U9XCIke0JSQU5EX0NPTE9SUy5hY2NlbnR9XCIgc3Ryb2tlLXdpZHRoPVwiNFwiIHN0cm9rZS1vcGFjaXR5PVwiMC43XCIvPlxuICAke1dBTExQQVBFUl9MT0dPfVxuICA8dGV4dCB4PVwiODAwXCIgeT1cIjU1OFwiIHRleHQtYW5jaG9yPVwibWlkZGxlXCIgZmlsbD1cIiR7QlJBTkRfQ09MT1JTLm11dGVkfVwiIGZvbnQtZmFtaWx5PVwiJHtCUkFORC50eXBvZ3JhcGh5LnNhbnN9XCIgZm9udC1zaXplPVwiMjRcIiBsZXR0ZXItc3BhY2luZz1cIjVcIj5MQUtFQk9YIERFU0tUT1A8L3RleHQ+XG48L3N2Zz5cbmBcbiAgICAvLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4gICAgLnRyaW0oKTtcblxuY29uc3QgREJYX1RPT0xTX1RFUk1JTkFMX0lDT04gPVxuICAvLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4gIC8qeG1sKi8gYFxuPHN2ZyB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCIgd2lkdGg9XCI2NFwiIGhlaWdodD1cIjY0XCIgdmlld0JveD1cIjAgMCA2NCA2NFwiPlxuICA8cmVjdCB4PVwiNFwiIHk9XCI2XCIgd2lkdGg9XCI1NlwiIGhlaWdodD1cIjUyXCIgcng9XCIxMlwiIGZpbGw9XCIke0JSQU5EX0NPTE9SUy5wcmltYXJ5fVwiLz5cbiAgPHJlY3QgeD1cIjhcIiB5PVwiMTBcIiB3aWR0aD1cIjQ4XCIgaGVpZ2h0PVwiNDRcIiByeD1cIjhcIiBmaWxsPVwiJHtCUkFORF9DT0xPUlMucHJpbWFyeUhvdmVyfVwiLz5cbiAgPHBhdGggZD1cIm0xOCAyMyA5IDktOSA5XCIgZmlsbD1cIm5vbmVcIiBzdHJva2U9XCIke0JSQU5EX0NPTE9SUy5zdXJmYWNlfVwiIHN0cm9rZS13aWR0aD1cIjRcIiBzdHJva2UtbGluZWNhcD1cInJvdW5kXCIgc3Ryb2tlLWxpbmVqb2luPVwicm91bmRcIi8+XG4gIDxwYXRoIGQ9XCJNMzQgNDFoMTJcIiBmaWxsPVwibm9uZVwiIHN0cm9rZT1cIiR7QlJBTkRfQ09MT1JTLmFjY2VudH1cIiBzdHJva2Utd2lkdGg9XCI0XCIgc3Ryb2tlLWxpbmVjYXA9XCJyb3VuZFwiLz5cbjwvc3ZnPlxuYFxuICAgIC8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbiAgICAudHJpbSgpO1xuXG5jb25zdCBERVNLVE9QX0JSQU5EX0hFQUQgPVxuICAvLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4gIC8qaHRtbCovIGBcbjxzdHlsZSBpZD1cImRieC10b29scy1kZXNrdG9wLWJyYW5kXCI+XG5odG1sLGJvZHl7d2lkdGg6MTAwJTttYXgtd2lkdGg6MTAwJTtoZWlnaHQ6MTAwJTttYXgtaGVpZ2h0OjEwMCU7bWluLXdpZHRoOjA7bWluLWhlaWdodDowO292ZXJmbG93OmhpZGRlbn1cbmJvZHl7cG9zaXRpb246Zml4ZWQ7aW5zZXQ6MDt3aWR0aDp2YXIoLS1kYngtdG9vbHMtdmlld3BvcnQtd2lkdGgsMTAwdncpO2hlaWdodDp2YXIoLS1kYngtdG9vbHMtdmlld3BvcnQtaGVpZ2h0LDEwMGR2aCl9XG4jbm9WTkNfY29udGFpbmVye3dpZHRoOjEwMCUhaW1wb3J0YW50O21heC13aWR0aDoxMDAlO2hlaWdodDoxMDAlIWltcG9ydGFudDttYXgtaGVpZ2h0OjEwMCU7b3ZlcmZsb3c6aGlkZGVufVxuLm5vVk5DX2xvZ28saDEubm9WTkNfbG9nbyxhW3RpdGxlPVwiS2FzbVZOQyBMZWFybiBNb3JlXCJde2Rpc3BsYXk6bm9uZSFpbXBvcnRhbnR9XG4jbm9WTkNfZmFsbGJhY2tfZXJyb3Jtc2d7b3ZlcmZsb3ctd3JhcDphbnl3aGVyZX1cbjwvc3R5bGU+XG48bGluayBkYXRhLWRieC10b29scy1kZXNrdG9wLWljb24gcmVsPVwiaWNvblwiIGhyZWY9XCIke2RieFRvb2xzQXNzZXREYXRhVXJscy5pY29uRGFya31cIj5cbjxzY3JpcHQgaWQ9XCJkYngtdG9vbHMta2FzbS1tb2JpbGUtZ3VhcmRcIj4oKCk9Pntjb25zdCBpZ25vcmVkPShlcnJvcik9PmVycm9yIGluc3RhbmNlb2YgUmVmZXJlbmNlRXJyb3ImJi9eQ2FuJ3QgZmluZCB2YXJpYWJsZTogV1swLTlBLUZdezMyfSQvLnRlc3QoZXJyb3IubWVzc2FnZSk7d2luZG93LmFkZEV2ZW50TGlzdGVuZXIoXCJlcnJvclwiLChldmVudCk9PntpZihpZ25vcmVkKGV2ZW50LmVycm9yKSl7ZXZlbnQucHJldmVudERlZmF1bHQoKTtldmVudC5zdG9wSW1tZWRpYXRlUHJvcGFnYXRpb24oKX19LHRydWUpO3dpbmRvdy5hZGRFdmVudExpc3RlbmVyKFwidW5oYW5kbGVkcmVqZWN0aW9uXCIsKGV2ZW50KT0+e2lmKGlnbm9yZWQoZXZlbnQucmVhc29uKSl7ZXZlbnQucHJldmVudERlZmF1bHQoKTtldmVudC5zdG9wSW1tZWRpYXRlUHJvcGFnYXRpb24oKX19LHRydWUpO2xldCB0aW1lcjtjb25zdCBzeW5jPSgpPT57Y29uc3Qgdmlld3BvcnQ9d2luZG93LnZpc3VhbFZpZXdwb3J0O2RvY3VtZW50LmRvY3VtZW50RWxlbWVudC5zdHlsZS5zZXRQcm9wZXJ0eShcIi0tZGJ4LXRvb2xzLXZpZXdwb3J0LXdpZHRoXCIsU3RyaW5nKE1hdGgucm91bmQodmlld3BvcnQ/LndpZHRoPz93aW5kb3cuaW5uZXJXaWR0aCkpK1wicHhcIik7ZG9jdW1lbnQuZG9jdW1lbnRFbGVtZW50LnN0eWxlLnNldFByb3BlcnR5KFwiLS1kYngtdG9vbHMtdmlld3BvcnQtaGVpZ2h0XCIsU3RyaW5nKE1hdGgucm91bmQodmlld3BvcnQ/LmhlaWdodD8/d2luZG93LmlubmVySGVpZ2h0KSkrXCJweFwiKTt3aW5kb3cuZGlzcGF0Y2hFdmVudChuZXcgRXZlbnQoXCJyZXNpemVcIikpfTtjb25zdCBzY2hlZHVsZT0oKT0+e2NsZWFyVGltZW91dCh0aW1lcik7c3luYygpO3NldFRpbWVvdXQoc3luYywyNTApO3RpbWVyPXNldFRpbWVvdXQoc3luYyw3NTApfTt3aW5kb3cudmlzdWFsVmlld3BvcnQ/LmFkZEV2ZW50TGlzdGVuZXIoXCJyZXNpemVcIixzY2hlZHVsZSk7d2luZG93LnZpc3VhbFZpZXdwb3J0Py5hZGRFdmVudExpc3RlbmVyKFwic2Nyb2xsXCIsc2NoZWR1bGUpO3dpbmRvdy5hZGRFdmVudExpc3RlbmVyKFwib3JpZW50YXRpb25jaGFuZ2VcIixzY2hlZHVsZSk7d2luZG93LmFkZEV2ZW50TGlzdGVuZXIoXCJwYWdlc2hvd1wiLHNjaGVkdWxlKTtkb2N1bWVudC5yZWFkeVN0YXRlPT09XCJsb2FkaW5nXCI/ZG9jdW1lbnQuYWRkRXZlbnRMaXN0ZW5lcihcIkRPTUNvbnRlbnRMb2FkZWRcIixzY2hlZHVsZSx7b25jZTp0cnVlfSk6c2NoZWR1bGUoKX0pKCk7PC9zY3JpcHQ+XG48c2NyaXB0IGlkPVwiZGJ4LXRvb2xzLWRlc2t0b3AtYnJhbmQtc2NyaXB0XCI+KCgpPT57Y29uc3QgaWNvbj0ke0pTT04uc3RyaW5naWZ5KGRieFRvb2xzQXNzZXREYXRhVXJscy5pY29uRGFyayl9O2NvbnN0IHJld3JpdGU9KHJvb3QpPT57aWYocm9vdC5ub2RlVHlwZT09PU5vZGUuVEVYVF9OT0RFKXtpZihyb290Lm5vZGVWYWx1ZT8uaW5jbHVkZXMoXCJLYXNtVk5DXCIpKXJvb3Qubm9kZVZhbHVlPXJvb3Qubm9kZVZhbHVlLnJlcGxhY2VBbGwoXCJLYXNtVk5DXCIsXCJkYnggdG9vbHMgRGVza3RvcFwiKTtyZXR1cm59Y29uc3Qgd2Fsa2VyPWRvY3VtZW50LmNyZWF0ZVRyZWVXYWxrZXIocm9vdCxOb2RlRmlsdGVyLlNIT1dfVEVYVCk7bGV0IG5vZGU7d2hpbGUobm9kZT13YWxrZXIubmV4dE5vZGUoKSlpZihub2RlLm5vZGVWYWx1ZT8uaW5jbHVkZXMoXCJLYXNtVk5DXCIpKW5vZGUubm9kZVZhbHVlPW5vZGUubm9kZVZhbHVlLnJlcGxhY2VBbGwoXCJLYXNtVk5DXCIsXCJkYnggdG9vbHMgRGVza3RvcFwiKX07Y29uc3QgYXBwbHk9KCk9Pntkb2N1bWVudC50aXRsZT1cImRieCB0b29scyBEZXNrdG9wXCI7Zm9yKGNvbnN0IGxpbmsgb2YgZG9jdW1lbnQucXVlcnlTZWxlY3RvckFsbCgnbGlua1tyZWx+PVwiaWNvblwiXSxsaW5rW3JlbD1cImFwcGxlLXRvdWNoLWljb25cIl0nKSlsaW5rLnNldEF0dHJpYnV0ZShcImhyZWZcIixpY29uKTtpZihkb2N1bWVudC5ib2R5KXJld3JpdGUoZG9jdW1lbnQuYm9keSl9O2lmKGRvY3VtZW50LnJlYWR5U3RhdGU9PT1cImxvYWRpbmdcIilkb2N1bWVudC5hZGRFdmVudExpc3RlbmVyKFwiRE9NQ29udGVudExvYWRlZFwiLGFwcGx5LHtvbmNlOnRydWV9KTtlbHNlIGFwcGx5KCk7bmV3IE11dGF0aW9uT2JzZXJ2ZXIoKGVudHJpZXMpPT57Zm9yKGNvbnN0IGVudHJ5IG9mIGVudHJpZXMpe2lmKGVudHJ5LnR5cGU9PT1cImNoYXJhY3RlckRhdGFcIilyZXdyaXRlKGVudHJ5LnRhcmdldCk7ZWxzZSBmb3IoY29uc3Qgbm9kZSBvZiBlbnRyeS5hZGRlZE5vZGVzKXJld3JpdGUobm9kZSl9fSkub2JzZXJ2ZShkb2N1bWVudC5kb2N1bWVudEVsZW1lbnQse2NoaWxkTGlzdDp0cnVlLHN1YnRyZWU6dHJ1ZSxjaGFyYWN0ZXJEYXRhOnRydWV9KX0pKCk7PC9zY3JpcHQ+XG5gXG4gICAgLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuICAgIC50cmltKCk7XG5cbi8qKiBNYXJrdXAgaW5qZWN0ZWQgaW50byB0aGUgS2FzbVZOQyBjbGllbnQgcGFnZSB0byBhcHBseSBkYngtdG9vbHMgYnJhbmRpbmcuICovXG5leHBvcnQgY29uc3QgZGVza3RvcEh0bWxIZWFkID0gREVTS1RPUF9CUkFORF9IRUFEO1xuXG4vKiogQnJvd3NlciBlbnRyeSBVUkwgZm9yIHRoZSBidWlsdC1pbiBLYXNtVk5DIGRlc2t0b3AuICovXG5leHBvcnQgZnVuY3Rpb24gZGVza3RvcE9wZW5VcmwocGF0aDogc3RyaW5nKTogc3RyaW5nIHtcbiAgY29uc3Qgbm9ybWFsaXplZCA9IHBhdGgucmVwbGFjZSgvXFwvKyQvLCBcIlwiKTtcbiAgY29uc3Qgd2Vic29ja2V0UGF0aCA9IGAke25vcm1hbGl6ZWQucmVwbGFjZSgvXlxcLysvLCBcIlwiKX0vd2Vic29ja2lmeWA7XG4gIGNvbnN0IHBhcmFtZXRlcnMgPSBuZXcgVVJMU2VhcmNoUGFyYW1zKHtcbiAgICBhdXRvY29ubmVjdDogXCIxXCIsXG4gICAgcmVzaXplOiBcInJlbW90ZVwiLFxuICAgIHNob3dfZG90OiBcIjFcIixcbiAgICBjbGlwYm9hcmRfc2VhbWxlc3M6IFwiMFwiLFxuICAgIGVuYWJsZV93ZWJwOiBcIjBcIixcbiAgICBrYXNtdm5jX21vZGVfcHJlZmVyZW5jZTogXCItMTAyN1wiLFxuICAgIHBhdGg6IHdlYnNvY2tldFBhdGgsXG4gIH0pO1xuICByZXR1cm4gYCR7bm9ybWFsaXplZH0vPyR7cGFyYW1ldGVycy50b1N0cmluZygpfWA7XG59XG5cbi8qKiBCcmFuZGluZyBlbnZpcm9ubWVudCBjb25zdW1lZCBieSB0aGUgcGFja2FnZWQgZGVza3RvcCBzZXNzaW9uIGVudHJ5cG9pbnQuICovXG5leHBvcnQgZnVuY3Rpb24gZGVza3RvcEVudmlyb25tZW50KCk6IFJlYWRvbmx5PFJlY29yZDxzdHJpbmcsIHN0cmluZz4+IHtcbiAgcmV0dXJuIHtcbiAgICBEQlhfVE9PTFNfREVTS1RPUF9XQUxMUEFQRVJfQkFTRTY0OiBCdWZmZXIuZnJvbShEQlhfVE9PTFNfV0FMTFBBUEVSKS50b1N0cmluZyhcImJhc2U2NFwiKSxcbiAgICBEQlhfVE9PTFNfREVTS1RPUF9CUkFORF9JQ09OX0JBU0U2NDogQnVmZmVyLmZyb20oZGJ4VG9vbHNBc3NldFN2Zy5pY29uRGFyaykudG9TdHJpbmcoXCJiYXNlNjRcIiksXG4gICAgREJYX1RPT0xTX0RFU0tUT1BfVEVSTUlOQUxfSUNPTl9CQVNFNjQ6IEJ1ZmZlci5mcm9tKERCWF9UT09MU19URVJNSU5BTF9JQ09OKS50b1N0cmluZyhcImJhc2U2NFwiKSxcbiAgICBEQlhfVE9PTFNfREVTS1RPUF9IT01FUEFHRV9CQVNFNjQ6IEJ1ZmZlci5mcm9tKEJSQU5ELmxpbmtzLndlYnNpdGUpLnRvU3RyaW5nKFwiYmFzZTY0XCIpLFxuICAgIERCWF9UT09MU19ERVNLVE9QX1BSSU1BUlk6IEJSQU5EX0NPTE9SUy5wcmltYXJ5LFxuICAgIERCWF9UT09MU19ERVNLVE9QX1BSSU1BUllfSE9WRVI6IEJSQU5EX0NPTE9SUy5wcmltYXJ5SG92ZXIsXG4gICAgREJYX1RPT0xTX0RFU0tUT1BfU1VSRkFDRTogQlJBTkRfQ09MT1JTLnN1cmZhY2UsXG4gICAgREJYX1RPT0xTX0RFU0tUT1BfRk9OVDogXCJEZWphVnUgU2Fuc1wiLFxuICB9O1xufVxuIl19

package/lib/src/metrics.d.ts

@@ -0,0 +1,59 @@
+import { EventEmitter } from "node:events";
+import type { LakeboxMetricsSnapshot } from "@dbx-tools/shared-lakebox";
+/** Raw cumulative counters read from one sample. */
+export interface LakeboxCounters {
+    at: number;
+    cores: number;
+    cpuBusy: number;
+    cpuTotal: number;
+    load1: number;
+    memoryTotalBytes: number;
+    memoryAvailableBytes: number;
+    storageTotalBytes: number;
+    storageUsedBytes: number;
+    rxBytes: number;
+    txBytes: number;
+}
+/** Events emitted by {@link LakeboxMetrics}. */
+export interface LakeboxMetricsEvents {
+    snapshot: [LakeboxMetricsSnapshot];
+}
+/**
+ * In-process metrics emitter for the app Lakebox.
+ *
+ * Sampling runs only between {@link start} and {@link stop}, which the runtime
+ * ties to the Lakebox running state. Samples contain machine-level CPU,
+ * memory, persistent storage, and network counters; they never contain
+ * process names, arguments, environment, or per-process usage.
+ */
+export declare class LakeboxMetrics extends EventEmitter<LakeboxMetricsEvents> {
+    private readonly read;
+    private readonly intervalMs;
+    private readonly capacity;
+    private readonly samples;
+    private previous?;
+    private timer?;
+    private controller?;
+    /** Creates a stopped emitter that reads raw counters with `read`. */
+    constructor(read: (signal: AbortSignal) => Promise<string>, intervalMs: number, capacity?: number);
+    /** Whether sampling is active. */
+    get running(): boolean;
+    /** Recent samples, oldest first. */
+    series(): readonly LakeboxMetricsSnapshot[];
+    /** Seeds one validated sample without starting the recurring sampler or emitting an event. */
+    seed(output: string, at?: number): LakeboxMetricsSnapshot;
+    /** Starts sampling. Repeated calls are ignored. */
+    start(): void;
+    /** Stops sampling and clears the series. */
+    stop(): void;
+    private tick;
+    private record;
+}
+/**
+ * Parses the package-owned metrics command output.
+ *
+ * @throws When a required counter is missing.
+ */
+export declare function parseLakeboxCounters(output: string, at?: number): LakeboxCounters;
+/** Converts cumulative counters to one snapshot using the previous sample for rates. */
+export declare function toSnapshot(current: LakeboxCounters, previous?: LakeboxCounters): LakeboxMetricsSnapshot;