@octomil/browser 1.0.0 → 1.1.0

package/dist/control.js

@@ -0,0 +1,317 @@
+/**
+ * @octomil/browser — Control client
+ *
+ * Device registration and heartbeat management. Builds on top of
+ * the DeviceAuth module to provide the full control-plane namespace
+ * required by the SDK facade contract.
+ */
+import { OctomilError } from "./types.js";
+import { SPAN_NAMES } from "./_generated/span_names.js";
+import { SPAN_ATTRIBUTES } from "./_generated/span_attributes.js";
+// ---------------------------------------------------------------------------
+// ControlClient
+// ---------------------------------------------------------------------------
+export class ControlClient {
+    serverUrl;
+    apiKey;
+    orgId;
+    serverDeviceId = null;
+    heartbeatTimer = null;
+    heartbeatSequence = 0;
+    deviceContext;
+    telemetry;
+    constructor(options) {
+        this.serverUrl = (options.serverUrl || "https://api.octomil.com").replace(/\/+$/, "");
+        this.apiKey = options.apiKey;
+        this.orgId = options.orgId;
+        this.deviceContext = options.deviceContext ?? null;
+        this.serverDeviceId = this.deviceContext?.serverDeviceId ?? null;
+        this.telemetry = options.telemetry ?? null;
+    }
+    // -----------------------------------------------------------------------
+    // Public
+    // -----------------------------------------------------------------------
+    /** Fetch current device assignments from the server. */
+    async refresh() {
+        if (!this.serverDeviceId) {
+            return {
+                updated: false,
+                configVersion: "",
+                assignmentsChanged: false,
+                fetchedAt: new Date().toISOString(),
+            };
+        }
+        const headers = {};
+        Object.assign(headers, this.resolveAuthHeaders());
+        const resp = await fetch(`${this.serverUrl}/api/v1/devices/${this.serverDeviceId}/assignments`, { headers });
+        if (!resp.ok) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Refresh assignments failed: ${resp.status}`);
+        }
+        const data = (await resp.json());
+        return {
+            updated: data.updated ?? true,
+            configVersion: data.config_version ?? "",
+            assignmentsChanged: data.assignments_changed ?? false,
+            fetchedAt: new Date().toISOString(),
+        };
+    }
+    /** Register a device with the Octomil server. */
+    async register(deviceId) {
+        const effectiveDeviceId = deviceId || this.deviceContext?.installationId || (await this.generateDeviceId());
+        const payload = {
+            device_identifier: effectiveDeviceId,
+            installation_id: this.deviceContext?.installationId ?? effectiveDeviceId,
+            app_id: this.deviceContext?.appId ?? undefined,
+            platform: "browser",
+            os_version: typeof navigator !== "undefined" ? navigator.userAgent : "unknown",
+            sdk_version: "1.0.0",
+            locale: typeof navigator !== "undefined" ? navigator.language : undefined,
+            timezone: typeof Intl !== "undefined"
+                ? Intl.DateTimeFormat().resolvedOptions().timeZone
+                : undefined,
+            device_info: this.collectDeviceInfo(),
+        };
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        Object.assign(headers, this.resolveAuthHeaders());
+        if (this.deviceContext?.appId) {
+            headers["X-App-Id"] = this.deviceContext.appId;
+        }
+        const registerUrl = new URL(`${this.serverUrl}/api/v1/devices/register`);
+        if (this.orgId) {
+            registerUrl.searchParams.set("org_id", this.orgId);
+        }
+        let resp;
+        try {
+            resp = await fetch(registerUrl.toString(), {
+                method: "POST",
+                headers,
+                body: JSON.stringify(payload),
+            });
+        }
+        catch (err) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Registration request failed: ${String(err)}`, err);
+        }
+        if (!resp.ok) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Registration failed: ${resp.status}`);
+        }
+        const data = (await resp.json());
+        this.serverDeviceId = data.device_id ?? data.id ?? null;
+        if (this.serverDeviceId &&
+            this.deviceContext &&
+            data.access_token &&
+            data.expires_at) {
+            this.deviceContext._updateRegistered(this.serverDeviceId, data.access_token, new Date(data.expires_at));
+        }
+        return {
+            id: this.serverDeviceId ?? "",
+            deviceIdentifier: effectiveDeviceId,
+            orgId: this.orgId || "",
+            status: data.status || "active",
+        };
+    }
+    /** Send a heartbeat to the server for the registered device. */
+    async heartbeat() {
+        if (!this.serverDeviceId) {
+            throw new OctomilError("INVALID_INPUT", "Device not registered");
+        }
+        const seq = this.heartbeatSequence++;
+        this.telemetry?.track({
+            name: SPAN_NAMES.octomilControlHeartbeat,
+            timestamp: new Date().toISOString(),
+            attributes: {
+                [SPAN_ATTRIBUTES.heartbeatSequence]: seq,
+            },
+        });
+        const payload = {
+            sdk_version: "1.0.0",
+            platform: "browser",
+            os_version: typeof navigator !== "undefined" ? navigator.userAgent : "unknown",
+        };
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        Object.assign(headers, this.resolveAuthHeaders());
+        let resp;
+        try {
+            resp = await fetch(`${this.serverUrl}/api/v1/devices/${this.serverDeviceId}/heartbeat`, { method: "PUT", headers, body: JSON.stringify(payload) });
+        }
+        catch (err) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Heartbeat request failed: ${String(err)}`, err);
+        }
+        if (!resp.ok) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Heartbeat failed: ${resp.status}`);
+        }
+        const data = (await resp.json());
+        return { status: data.status || "ok", serverTime: data.server_time };
+    }
+    /**
+     * Report observed device state to the server (GAP-05).
+     * POSTs per-model statuses and runtime metadata to
+     * `/api/v1/devices/{id}/observed-state`.
+     *
+     * Typically called by {@link SyncManager} after a reconcile cycle, but can
+     * also be invoked manually for custom reporting.
+     */
+    async reportObservedState(models = []) {
+        if (!this.serverDeviceId) {
+            throw new OctomilError("INVALID_INPUT", "Device not registered");
+        }
+        const payload = {
+            schemaVersion: "1.4.0",
+            deviceId: this.serverDeviceId,
+            reportedAt: new Date().toISOString(),
+            models,
+            active_bindings: models
+                .filter((model) => model.status === "active")
+                .map((model) => ({
+                binding_key: model.bindingKey ?? model.useCase ?? model.modelId,
+                base_model_id: model.modelId,
+                base_version: model.version ?? "",
+                use_case: model.useCase,
+                deployment_id: model.deploymentId,
+                deployment_key: model.deploymentKey,
+                model_name: model.modelName,
+                model_ref: model.modelRef,
+            })),
+            sdkVersion: "1.0.0",
+            osVersion: typeof navigator !== "undefined" ? navigator.userAgent : "unknown",
+        };
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        Object.assign(headers, this.resolveAuthHeaders());
+        let resp;
+        try {
+            resp = await fetch(`${this.serverUrl}/api/v1/devices/${this.serverDeviceId}/observed-state`, { method: "POST", headers, body: JSON.stringify(payload) });
+        }
+        catch (err) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Report observed state failed: ${String(err)}`, err);
+        }
+        if (!resp.ok) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Report observed state failed: ${resp.status}`);
+        }
+    }
+    /**
+     * Fetch server-authoritative desired state (GAP-13).
+     * GETs `/api/v1/devices/{id}/desired-state`.
+     *
+     * Typically called by {@link SyncManager} during reconciliation, but can
+     * also be invoked manually for inspection.
+     */
+    async fetchDesiredState() {
+        if (!this.serverDeviceId) {
+            throw new OctomilError("INVALID_INPUT", "Device not registered");
+        }
+        const headers = {};
+        Object.assign(headers, this.resolveAuthHeaders());
+        let resp;
+        try {
+            resp = await fetch(`${this.serverUrl}/api/v1/devices/${this.serverDeviceId}/desired-state`, { headers });
+        }
+        catch (err) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Fetch desired state failed: ${String(err)}`, err);
+        }
+        if (!resp.ok) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Fetch desired state failed: ${resp.status}`);
+        }
+        return (await resp.json());
+    }
+    async sync(request = {}) {
+        if (!this.serverDeviceId) {
+            throw new OctomilError("INVALID_INPUT", "Device not registered");
+        }
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        Object.assign(headers, this.resolveAuthHeaders());
+        let resp;
+        try {
+            resp = await fetch(`${this.serverUrl}/api/v1/devices/${this.serverDeviceId}/sync`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({
+                    schemaVersion: request.schemaVersion ?? "1.12.0",
+                    deviceId: this.serverDeviceId,
+                    requestedAt: request.requestedAt ?? new Date().toISOString(),
+                    knownStateVersion: request.knownStateVersion,
+                    sdkVersion: request.sdkVersion,
+                    platform: request.platform ?? "browser",
+                    appId: request.appId,
+                    appVersion: request.appVersion,
+                    modelInventory: request.modelInventory ?? [],
+                    activeVersions: request.activeVersions ?? [],
+                    availableStorageBytes: request.availableStorageBytes,
+                }),
+            });
+        }
+        catch (err) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Device sync failed: ${String(err)}`, err);
+        }
+        if (!resp.ok) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Device sync failed: ${resp.status}`);
+        }
+        return (await resp.json());
+    }
+    /** Start periodic heartbeats at the given interval. */
+    startHeartbeat(intervalMs = 300_000) {
+        this.stopHeartbeat();
+        this.heartbeatTimer = setInterval(() => {
+            this.heartbeat().catch(() => { });
+        }, intervalMs);
+    }
+    /** Stop periodic heartbeats. */
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    /** The server-assigned device ID, set after registration. */
+    get registeredDeviceId() {
+        return this.serverDeviceId;
+    }
+    // -----------------------------------------------------------------------
+    // Internal helpers
+    // -----------------------------------------------------------------------
+    /** Generate a stable device ID by hashing browser fingerprint data. */
+    async generateDeviceId() {
+        const raw = [
+            typeof navigator !== "undefined" ? navigator.userAgent : "unknown",
+            typeof screen !== "undefined" ? screen.width : 0,
+            typeof screen !== "undefined" ? screen.height : 0,
+            typeof Intl !== "undefined"
+                ? Intl.DateTimeFormat().resolvedOptions().timeZone
+                : "UTC",
+        ].join("|");
+        const buf = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(raw));
+        return Array.from(new Uint8Array(buf))
+            .map((b) => b.toString(16).padStart(2, "0"))
+            .join("");
+    }
+    /** Collect device info for registration payloads. */
+    collectDeviceInfo() {
+        return {
+            platform: "browser",
+            user_agent: typeof navigator !== "undefined" ? navigator.userAgent : "unknown",
+            screen_width: typeof screen !== "undefined" ? screen.width : 0,
+            screen_height: typeof screen !== "undefined" ? screen.height : 0,
+            device_memory_gb: typeof navigator !== "undefined"
+                ? // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    navigator.deviceMemory || 0
+                : 0,
+            language: typeof navigator !== "undefined" ? navigator.language : "unknown",
+        };
+    }
+    resolveAuthHeaders() {
+        return this.deviceContext?.authHeaders() ?? this.resolveApiKeyHeaders();
+    }
+    resolveApiKeyHeaders() {
+        if (!this.apiKey) {
+            return {};
+        }
+        return { Authorization: `Bearer ${this.apiKey}` };
+    }
+}
+//# sourceMappingURL=control.js.map

package/dist/control.js.map

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

package/dist/device-auth.d.ts

@@ -5,7 +5,7 @@
  * authenticated model downloads and training round participation.
  */
 import type { DeviceAuthConfig } from "./types.js";
-export declare class DeviceAuthManager {
+export declare class DeviceAuth {
     private readonly serverUrl;
     private readonly apiKey;
     private token;

package/dist/device-auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device-auth.d.ts","sourceRoot":"","sources":["../src/device-auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAYpB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,gBAAgB;IASpC,6DAA6D;IACvD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC7C,sDAAsD;IAChD,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAiBjC,iCAAiC;IAC3B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA0CnC,sDAAsD;IAChD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBlC,+CAA+C;IAC/C,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,iCAAiC;IACjC,IAAI,eAAe,IAAI,MAAM,GAAG,IAAI,CAEnC;IAED,sBAAsB;IACtB,OAAO,IAAI,IAAI;YAUD,OAAO;IAYrB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,UAAU;IAKlB,uEAAuE;IACjE,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBzC,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;CAQ1B"}
+{"version":3,"file":"device-auth.d.ts","sourceRoot":"","sources":["../src/device-auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAYpB,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,gBAAgB;IASpC,6DAA6D;IACvD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC7C,sDAAsD;IAChD,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAiBjC,iCAAiC;IAC3B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA0CnC,sDAAsD;IAChD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBlC,+CAA+C;IAC/C,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,iCAAiC;IACjC,IAAI,eAAe,IAAI,MAAM,GAAG,IAAI,CAEnC;IAED,sBAAsB;IACtB,OAAO,IAAI,IAAI;YAUD,OAAO;IAYrB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,UAAU;IAKlB,uEAAuE;IACjE,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBzC,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;CAQ1B"}

package/dist/device-auth.js

@@ -10,9 +10,9 @@ import { OctomilError } from "./types.js";
 // ---------------------------------------------------------------------------
 const REFRESH_BUFFER_MS = 30_000; // refresh 30s before expiry
 // ---------------------------------------------------------------------------
-// DeviceAuthManager
+// DeviceAuth
 // ---------------------------------------------------------------------------
-export class DeviceAuthManager {
+export class DeviceAuth {
     serverUrl;
     apiKey;
     token = null;
@@ -41,7 +41,7 @@ export class DeviceAuthManager {
             }),
         });
         if (!response.ok) {
-            throw new OctomilError("NETWORK_ERROR", `Device registration failed: HTTP ${response.status}`);
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Device registration failed: HTTP ${response.status}`);
         }
         const data = (await response.json());
         this.token = {
@@ -55,7 +55,7 @@ export class DeviceAuthManager {
     async getToken() {
         this.ensureNotDisposed();
         if (!this.token) {
-            throw new OctomilError("NETWORK_ERROR", "Not authenticated. Call bootstrap() first.");
+            throw new OctomilError("NETWORK_UNAVAILABLE", "Not authenticated. Call bootstrap() first.");
         }
         if (this.isTokenExpiringSoon()) {
             await this.refreshToken();
@@ -66,7 +66,7 @@ export class DeviceAuthManager {
     async refreshToken() {
         this.ensureNotDisposed();
         if (!this.token) {
-            throw new OctomilError("NETWORK_ERROR", "No token to refresh. Call bootstrap() first.");
+            throw new OctomilError("NETWORK_UNAVAILABLE", "No token to refresh. Call bootstrap() first.");
         }
         const response = await this.request("/api/v1/auth/refresh", {
             method: "POST",
@@ -78,7 +78,7 @@ export class DeviceAuthManager {
         if (!response.ok) {
             // Token expired beyond repair — clear state
             this.token = null;
-            throw new OctomilError("NETWORK_ERROR", `Token refresh failed: HTTP ${response.status}`);
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Token refresh failed: HTTP ${response.status}`);
         }
         const data = (await response.json());
         this.token = {
@@ -196,7 +196,7 @@ export class DeviceAuthManager {
     }
     ensureNotDisposed() {
         if (this.disposed) {
-            throw new OctomilError("SESSION_DISPOSED", "DeviceAuthManager has been disposed.");
+            throw new OctomilError("CANCELLED", "DeviceAuth has been disposed.");
         }
     }
 }

package/dist/device-auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"device-auth.js","sourceRoot":"","sources":["../src/device-auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1C,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,MAAM,CAAC,CAAC,4BAA4B;AAE9D,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,OAAO,iBAAiB;IACX,SAAS,CAAS;IAClB,MAAM,CAAS;IACxB,KAAK,GAA2B,IAAI,CAAC;IACrC,QAAQ,GAAkB,IAAI,CAAC;IAC/B,YAAY,GAAyC,IAAI,CAAC;IAC1D,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAAY,MAAwB;QAClC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,0EAA0E;IAC1E,SAAS;IACT,0EAA0E;IAE1E,6DAA6D;IAC7D,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,0BAA0B,EAAE;YAC9D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,MAAM,EAAE,KAAK;gBACb,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,UAAU;aACjB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,oCAAoC,QAAQ,CAAC,MAAM,EAAE,CACtD,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIlC,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG;YACX,WAAW,EAAE,IAAI,CAAC,KAAK;YACvB,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;SAC/C,CAAC;QAEF,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,4CAA4C,CAC7C,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;IAChC,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,8CAA8C,CAC/C,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE;YAC1D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY;gBACtC,SAAS,EAAE,IAAI,CAAC,QAAQ;aACzB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,4CAA4C;YAC5C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CAChD,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIlC,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG;YACX,WAAW,EAAE,IAAI,CAAC,KAAK;YACvB,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;SAC/C,CAAC;QAEF,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE;gBACxC,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;oBAC7B,SAAS,EAAE,IAAI,CAAC,QAAQ;iBACzB,CAAC;aACH,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;IACvD,CAAC;IAED,iCAAiC;IACjC,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,sBAAsB;IACtB,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;IAED,0EAA0E;IAC1E,WAAW;IACX,0EAA0E;IAElE,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAiB;QACnD,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;SACvC,CAAC;QAEF,OAAO,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,EAAE;YACvC,GAAG,IAAI;YACP,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,GAAI,IAAI,CAAC,OAAkC,EAAE;SACrE,CAAC,CAAC;IACL,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAC7B,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;IAC5C,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAC7B,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,iBAAiB,CAAC;IAChE,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,iBAAiB,CAAC,CAAC;QAEjF,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YAClC,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;gBAClC,6DAA6D;YAC/D,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;IAEO,iBAAiB;QACvB,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC/B,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,gBAAgB;QACpB,MAAM,GAAG,GAAG;YACV,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YAClE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK;YAC1E,OAAO,IAAI,KAAK,WAAW;gBACzB,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ;gBAClD,CAAC,CAAC,KAAK;YACT,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;SAC7D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEZ,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;QAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;aACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IAEO,iBAAiB;QACvB,OAAO;YACL,SAAS,EAAE,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YAC7E,QAAQ,EAAE,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;YACtE,WAAW,EAAE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC7D,YAAY,EAAE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/D,QAAQ,EACN,OAAO,IAAI,KAAK,WAAW;gBACzB,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ;gBAClD,CAAC,CAAC,KAAK;YACX,MAAM,EAAE,OAAO,SAAS,KAAK,WAAW,IAAI,KAAK,IAAI,SAAS;SAC/D,CAAC;IACJ,CAAC;IAEO,iBAAiB;QACvB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,YAAY,CACpB,kBAAkB,EAClB,sCAAsC,CACvC,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"device-auth.js","sourceRoot":"","sources":["../src/device-auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1C,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,MAAM,CAAC,CAAC,4BAA4B;AAE9D,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,OAAO,UAAU;IACJ,SAAS,CAAS;IAClB,MAAM,CAAS;IACxB,KAAK,GAA2B,IAAI,CAAC;IACrC,QAAQ,GAAkB,IAAI,CAAC;IAC/B,YAAY,GAAyC,IAAI,CAAC;IAC1D,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAAY,MAAwB;QAClC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,0EAA0E;IAC1E,SAAS;IACT,0EAA0E;IAE1E,6DAA6D;IAC7D,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,0BAA0B,EAAE;YAC9D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,MAAM,EAAE,KAAK;gBACb,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,UAAU;aACjB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,YAAY,CACpB,qBAAqB,EACrB,oCAAoC,QAAQ,CAAC,MAAM,EAAE,CACtD,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIlC,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG;YACX,WAAW,EAAE,IAAI,CAAC,KAAK;YACvB,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;SAC/C,CAAC;QAEF,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,YAAY,CACpB,qBAAqB,EACrB,4CAA4C,CAC7C,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;IAChC,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,YAAY,CACpB,qBAAqB,EACrB,8CAA8C,CAC/C,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE;YAC1D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY;gBACtC,SAAS,EAAE,IAAI,CAAC,QAAQ;aACzB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,4CAA4C;YAC5C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,MAAM,IAAI,YAAY,CACpB,qBAAqB,EACrB,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CAChD,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIlC,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG;YACX,WAAW,EAAE,IAAI,CAAC,KAAK;YACvB,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE;SAC/C,CAAC;QAEF,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE;gBACxC,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;oBAC7B,SAAS,EAAE,IAAI,CAAC,QAAQ;iBACzB,CAAC;aACH,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;IACvD,CAAC;IAED,iCAAiC;IACjC,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,sBAAsB;IACtB,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;IAED,0EAA0E;IAC1E,WAAW;IACX,0EAA0E;IAElE,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAiB;QACnD,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;SACvC,CAAC;QAEF,OAAO,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,EAAE;YACvC,GAAG,IAAI;YACP,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,GAAI,IAAI,CAAC,OAAkC,EAAE;SACrE,CAAC,CAAC;IACL,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAC7B,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;IAC5C,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAC7B,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,iBAAiB,CAAC;IAChE,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,iBAAiB,CAAC,CAAC;QAEjF,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YAClC,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;gBAClC,6DAA6D;YAC/D,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;IAEO,iBAAiB;QACvB,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC/B,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,gBAAgB;QACpB,MAAM,GAAG,GAAG;YACV,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YAClE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK;YAC1E,OAAO,IAAI,KAAK,WAAW;gBACzB,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ;gBAClD,CAAC,CAAC,KAAK;YACT,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;SAC7D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEZ,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;QAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;aACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IAEO,iBAAiB;QACvB,OAAO;YACL,SAAS,EAAE,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YAC7E,QAAQ,EAAE,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;YACtE,WAAW,EAAE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC7D,YAAY,EAAE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/D,QAAQ,EACN,OAAO,IAAI,KAAK,WAAW;gBACzB,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ;gBAClD,CAAC,CAAC,KAAK;YACX,MAAM,EAAE,OAAO,SAAS,KAAK,WAAW,IAAI,KAAK,IAAI,SAAS;SAC/D,CAAC;IACJ,CAAC;IAEO,iBAAiB;QACvB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,YAAY,CACpB,WAAW,EACX,+BAA+B,CAChC,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/device-context.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @octomil/browser — Device context for silent registration
+ *
+ * Tracks installation identity, registration state, and auth tokens
+ * for the device registration flow. Uses crypto.randomUUID() for
+ * installation IDs (NOT browser fingerprinting) and persists to
+ * localStorage where available.
+ */
+export type RegistrationState = "pending" | "registered" | "failed";
+export type TokenState = {
+    type: "none";
+} | {
+    type: "valid";
+    accessToken: string;
+    expiresAt: Date;
+} | {
+    type: "expired";
+};
+export declare class DeviceContext {
+    readonly installationId: string;
+    readonly orgId: string | null;
+    readonly appId: string | null;
+    private _registrationState;
+    private _tokenState;
+    private _serverDeviceId;
+    constructor(opts: {
+        installationId: string;
+        orgId?: string | null;
+        appId?: string | null;
+    });
+    get registrationState(): RegistrationState;
+    get tokenState(): TokenState;
+    get serverDeviceId(): string | null;
+    get isRegistered(): boolean;
+    authHeaders(): Record<string, string> | null;
+    telemetryResource(): Record<string, string>;
+    /** @internal */
+    _updateRegistered(serverDeviceId: string, accessToken: string, expiresAt: Date): void;
+    /** @internal */
+    _updateToken(accessToken: string, expiresAt: Date): void;
+    /** @internal */
+    _markFailed(): void;
+    /** @internal */
+    _markTokenExpired(): void;
+    private static readonly STORAGE_KEY;
+    static getOrCreateInstallationId(): string;
+}
+//# sourceMappingURL=device-context.d.ts.map

package/dist/device-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-context.d.ts","sourceRoot":"","sources":["../src/device-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEpE,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAMxB,qBAAa,aAAa;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,OAAO,CAAC,kBAAkB,CAAgC;IAC1D,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,eAAe,CAAuB;gBAElC,IAAI,EAAE;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB;IAMD,IAAI,iBAAiB,IAAI,iBAAiB,CAEzC;IACD,IAAI,UAAU,IAAI,UAAU,CAE3B;IACD,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAElC;IACD,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAS5C,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAU3C,gBAAgB;IAChB,iBAAiB,CACf,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,GACd,IAAI;IAMP,gBAAgB;IAChB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI;IAIxD,gBAAgB;IAChB,WAAW,IAAI,IAAI;IAInB,gBAAgB;IAChB,iBAAiB,IAAI,IAAI;IAQzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAEhE,MAAM,CAAC,yBAAyB,IAAI,MAAM;CAY3C"}

package/dist/device-context.js

@@ -0,0 +1,92 @@
+/**
+ * @octomil/browser — Device context for silent registration
+ *
+ * Tracks installation identity, registration state, and auth tokens
+ * for the device registration flow. Uses crypto.randomUUID() for
+ * installation IDs (NOT browser fingerprinting) and persists to
+ * localStorage where available.
+ */
+// ---------------------------------------------------------------------------
+// DeviceContext
+// ---------------------------------------------------------------------------
+export class DeviceContext {
+    installationId;
+    orgId;
+    appId;
+    _registrationState = "pending";
+    _tokenState = { type: "none" };
+    _serverDeviceId = null;
+    constructor(opts) {
+        this.installationId = opts.installationId;
+        this.orgId = opts.orgId ?? null;
+        this.appId = opts.appId ?? null;
+    }
+    get registrationState() {
+        return this._registrationState;
+    }
+    get tokenState() {
+        return this._tokenState;
+    }
+    get serverDeviceId() {
+        return this._serverDeviceId;
+    }
+    get isRegistered() {
+        return this._registrationState === "registered";
+    }
+    authHeaders() {
+        if (this._tokenState.type === "valid") {
+            if (this._tokenState.expiresAt > new Date()) {
+                return { Authorization: `Bearer ${this._tokenState.accessToken}` };
+            }
+        }
+        return null;
+    }
+    telemetryResource() {
+        const resource = {
+            "device.id": this.installationId,
+            platform: "browser",
+        };
+        if (this.orgId)
+            resource["org.id"] = this.orgId;
+        if (this.appId)
+            resource["app.id"] = this.appId;
+        return resource;
+    }
+    /** @internal */
+    _updateRegistered(serverDeviceId, accessToken, expiresAt) {
+        this._serverDeviceId = serverDeviceId;
+        this._tokenState = { type: "valid", accessToken, expiresAt };
+        this._registrationState = "registered";
+    }
+    /** @internal */
+    _updateToken(accessToken, expiresAt) {
+        this._tokenState = { type: "valid", accessToken, expiresAt };
+    }
+    /** @internal */
+    _markFailed() {
+        this._registrationState = "failed";
+    }
+    /** @internal */
+    _markTokenExpired() {
+        this._tokenState = { type: "expired" };
+    }
+    // -----------------------------------------------------------------------
+    // Installation ID persistence
+    // -----------------------------------------------------------------------
+    static STORAGE_KEY = "octomil_installation_id";
+    static getOrCreateInstallationId() {
+        try {
+            const existing = localStorage.getItem(DeviceContext.STORAGE_KEY);
+            if (existing)
+                return existing;
+            const newId = crypto.randomUUID();
+            localStorage.setItem(DeviceContext.STORAGE_KEY, newId);
+            return newId;
+        }
+        catch {
+            // localStorage unavailable (private browsing, etc.)
+            return crypto.randomUUID();
+        }
+    }
+}
+//# sourceMappingURL=device-context.js.map

package/dist/device-context.js.map

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

package/dist/devices.d.ts

@@ -0,0 +1,17 @@
+import type { ControlClient, DesiredState, DeviceSyncRequest, DeviceSyncResponse, ObservedModelStatus } from "./control.js";
+export declare class DevicesClient {
+    private readonly control;
+    constructor(control: ControlClient);
+    desiredState(): Promise<DesiredState>;
+    observedState(models?: ObservedModelStatus[]): Promise<void>;
+    sync(request?: {
+        knownStateVersion?: string;
+        sdkVersion?: string;
+        appId?: string;
+        appVersion?: string;
+        modelInventory?: DeviceSyncRequest["modelInventory"];
+        activeVersions?: DeviceSyncRequest["activeVersions"];
+        availableStorageBytes?: number;
+    }): Promise<DeviceSyncResponse>;
+}
+//# sourceMappingURL=devices.d.ts.map

package/dist/devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../src/devices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAEtB,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE7C,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAIrC,aAAa,CAAC,MAAM,GAAE,mBAAmB,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,IAAI,CAAC,OAAO,GAAE;QAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;QACrD,cAAc,CAAC,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;QACrD,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAGrC"}

package/dist/devices.js

@@ -0,0 +1,16 @@
+export class DevicesClient {
+    control;
+    constructor(control) {
+        this.control = control;
+    }
+    async desiredState() {
+        return this.control.fetchDesiredState();
+    }
+    async observedState(models = []) {
+        await this.control.reportObservedState(models);
+    }
+    async sync(request = {}) {
+        return this.control.sync(request);
+    }
+}
+//# sourceMappingURL=devices.js.map

package/dist/devices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.js","sourceRoot":"","sources":["../src/devices.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;IAAG,CAAC;IAEvD,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAgC,EAAE;QACpD,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAQP,EAAE;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF"}