@octomil/browser 1.0.0

package/dist/experiments.js

@@ -0,0 +1,135 @@
+/**
+ * @octomil/browser — A/B testing and experiments client
+ *
+ * Deterministic variant assignment, experiment config caching,
+ * and metric reporting for model experiments.
+ */
+import { OctomilError } from "./types.js";
+// ---------------------------------------------------------------------------
+// ExperimentsClient
+// ---------------------------------------------------------------------------
+export class ExperimentsClient {
+    serverUrl;
+    apiKey;
+    cacheTtlMs;
+    onTelemetry;
+    experimentsCache = null;
+    constructor(options) {
+        this.serverUrl = options.serverUrl;
+        this.apiKey = options.apiKey;
+        this.cacheTtlMs = options.cacheTtlMs ?? 5 * 60 * 1000; // 5 min
+        this.onTelemetry = options.onTelemetry;
+    }
+    /** Fetch all active experiments (cached). */
+    async getActiveExperiments() {
+        if (this.experimentsCache &&
+            Date.now() - this.experimentsCache.fetchedAt < this.cacheTtlMs) {
+            return this.experimentsCache.experiments;
+        }
+        const url = `${this.serverUrl}/api/v1/experiments?status=active`;
+        const headers = { Accept: "application/json" };
+        if (this.apiKey)
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        const response = await fetch(url, { headers });
+        if (!response.ok) {
+            throw new OctomilError("NETWORK_ERROR", `Failed to fetch experiments: HTTP ${response.status}`);
+        }
+        const data = (await response.json());
+        this.experimentsCache = {
+            experiments: data.experiments,
+            fetchedAt: Date.now(),
+        };
+        return data.experiments;
+    }
+    /** Get full experiment config by ID. */
+    async getExperimentConfig(experimentId) {
+        const url = `${this.serverUrl}/api/v1/experiments/${encodeURIComponent(experimentId)}`;
+        const headers = { Accept: "application/json" };
+        if (this.apiKey)
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        const response = await fetch(url, { headers });
+        if (!response.ok) {
+            throw new OctomilError("NETWORK_ERROR", `Failed to fetch experiment: HTTP ${response.status}`);
+        }
+        return (await response.json());
+    }
+    /**
+     * Deterministic variant assignment.
+     * Hash(deviceId + experimentId) → bucket → variant by cumulative traffic %.
+     */
+    getVariant(experiment, deviceId) {
+        if (experiment.variants.length === 0)
+            return null;
+        const bucket = deterministicBucket(deviceId + experiment.id);
+        let cumulative = 0;
+        for (const variant of experiment.variants) {
+            cumulative += variant.trafficPercentage;
+            if (bucket < cumulative) {
+                return variant;
+            }
+        }
+        // Fallback to last variant if percentages don't sum to 100
+        return experiment.variants[experiment.variants.length - 1] ?? null;
+    }
+    /** Check if a device is enrolled in a specific experiment. */
+    isEnrolled(experiment, deviceId) {
+        return this.getVariant(experiment, deviceId) !== null;
+    }
+    /**
+     * Find which experiment (if any) affects a given model, and return
+     * the variant this device should use.
+     */
+    async resolveModelExperiment(modelId, deviceId) {
+        const experiments = await this.getActiveExperiments();
+        for (const exp of experiments) {
+            const affectsModel = exp.variants.some((v) => v.modelId === modelId);
+            if (!affectsModel)
+                continue;
+            const variant = this.getVariant(exp, deviceId);
+            if (variant) {
+                return { experiment: exp, variant };
+            }
+        }
+        return null;
+    }
+    /** Report a metric for an experiment. */
+    async trackMetric(experimentId, metricName, value, deviceId) {
+        const url = `${this.serverUrl}/api/v1/experiments/${encodeURIComponent(experimentId)}/metrics`;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey)
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                metric_name: metricName,
+                value,
+                device_id: deviceId,
+                timestamp: Date.now(),
+            }),
+        });
+        this.onTelemetry?.({
+            type: "experiment_metric",
+            model: experimentId,
+            metadata: { metricName, value },
+            timestamp: Date.now(),
+        });
+    }
+    /** Clear the experiment cache. */
+    clearCache() {
+        this.experimentsCache = null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function deterministicBucket(input) {
+    let hash = 5381;
+    for (let i = 0; i < input.length; i++) {
+        hash = ((hash << 5) + hash + input.charCodeAt(i)) | 0;
+    }
+    return Math.abs(hash) % 100;
+}
+//# sourceMappingURL=experiments.js.map

package/dist/experiments.js.map

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

package/dist/federated.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @octomil/browser — Federated learning client
+ *
+ * Participates in federated training rounds: local weight extraction,
+ * delta computation, and update submission. Actual gradient computation
+ * is delegated to user-provided training hooks since ONNX Runtime Web
+ * has limited training support.
+ */
+import type { TrainingConfig, FederatedRound, WeightMap, TelemetryEvent } from "./types.js";
+/** Extract and compare model weights stored as named Float32Arrays. */
+export declare class WeightExtractor {
+    /**
+     * Compute element-wise delta between two weight maps.
+     * `delta = after - before`
+     */
+    static computeDelta(before: WeightMap, after: WeightMap): WeightMap;
+    /** Apply a delta to weights: `result = weights + delta`. */
+    static applyDelta(weights: WeightMap, delta: WeightMap): WeightMap;
+    /** Compute L2 norm of a weight map (flattened). */
+    static l2Norm(weights: WeightMap): number;
+}
+export declare class FederatedClient {
+    private readonly serverUrl;
+    private readonly apiKey?;
+    private readonly deviceId;
+    private readonly onTelemetry?;
+    constructor(options: {
+        serverUrl: string;
+        apiKey?: string;
+        deviceId: string;
+        onTelemetry?: (event: TelemetryEvent) => void;
+    });
+    /** Fetch the current training round from the server. */
+    getTrainingRound(federationId: string): Promise<FederatedRound>;
+    /** Join a training round. */
+    joinRound(federationId: string, roundId: string): Promise<void>;
+    /**
+     * Run local training using a user-provided step function.
+     *
+     * Browser ONNX Runtime Web does not support training natively, so the
+     * caller provides `onTrainStep` which receives the current weights and
+     * a batch of data, and returns updated weights.
+     */
+    train(initialWeights: WeightMap, config: TrainingConfig): Promise<{
+        finalWeights: WeightMap;
+        delta: WeightMap;
+    }>;
+    /** Submit a weight update to the aggregation server. */
+    submitUpdate(federationId: string, roundId: string, delta: WeightMap, metrics?: Record<string, number>): Promise<void>;
+    private request;
+    private cloneWeights;
+}
+//# sourceMappingURL=federated.d.ts.map

package/dist/federated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federated.d.ts","sourceRoot":"","sources":["../src/federated.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,SAAS,EACT,cAAc,EACf,MAAM,YAAY,CAAC;AAOpB,uEAAuE;AACvE,qBAAa,eAAe;IAC1B;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS;IAoBnE,4DAA4D;IAC5D,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS;IAmBlE,mDAAmD;IACnD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM;CAU1C;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAkC;gBAEnD,OAAO,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;KAC/C;IAOD,wDAAwD;IAClD,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAarE,6BAA6B;IACvB,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrE;;;;;;OAMG;IACG,KAAK,CACT,cAAc,EAAE,SAAS,EACzB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC;QAAE,YAAY,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC;IA8BzD,wDAAwD;IAClD,YAAY,CAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;YAmCF,OAAO;IAcrB,OAAO,CAAC,YAAY;CAOrB"}

package/dist/federated.js

@@ -0,0 +1,180 @@
+/**
+ * @octomil/browser — Federated learning client
+ *
+ * Participates in federated training rounds: local weight extraction,
+ * delta computation, and update submission. Actual gradient computation
+ * is delegated to user-provided training hooks since ONNX Runtime Web
+ * has limited training support.
+ */
+import { OctomilError } from "./types.js";
+// ---------------------------------------------------------------------------
+// WeightExtractor
+// ---------------------------------------------------------------------------
+/** Extract and compare model weights stored as named Float32Arrays. */
+export class WeightExtractor {
+    /**
+     * Compute element-wise delta between two weight maps.
+     * `delta = after - before`
+     */
+    static computeDelta(before, after) {
+        const delta = {};
+        for (const key of Object.keys(before)) {
+            const b = before[key];
+            const a = after[key];
+            if (!b || !a || b.length !== a.length) {
+                throw new OctomilError("INVALID_INPUT", `Weight dimension mismatch for "${key}".`);
+            }
+            const d = new Float32Array(b.length);
+            for (let i = 0; i < b.length; i++) {
+                d[i] = a[i] - b[i];
+            }
+            delta[key] = d;
+        }
+        return delta;
+    }
+    /** Apply a delta to weights: `result = weights + delta`. */
+    static applyDelta(weights, delta) {
+        const result = {};
+        for (const key of Object.keys(weights)) {
+            const w = weights[key];
+            const d = delta[key];
+            if (!w)
+                continue;
+            if (!d || w.length !== d.length) {
+                result[key] = new Float32Array(w);
+                continue;
+            }
+            const r = new Float32Array(w.length);
+            for (let i = 0; i < w.length; i++) {
+                r[i] = w[i] + d[i];
+            }
+            result[key] = r;
+        }
+        return result;
+    }
+    /** Compute L2 norm of a weight map (flattened). */
+    static l2Norm(weights) {
+        let sumSq = 0;
+        for (const arr of Object.values(weights)) {
+            if (!arr)
+                continue;
+            for (let i = 0; i < arr.length; i++) {
+                sumSq += arr[i] * arr[i];
+            }
+        }
+        return Math.sqrt(sumSq);
+    }
+}
+// ---------------------------------------------------------------------------
+// FederatedClient
+// ---------------------------------------------------------------------------
+export class FederatedClient {
+    serverUrl;
+    apiKey;
+    deviceId;
+    onTelemetry;
+    constructor(options) {
+        this.serverUrl = options.serverUrl;
+        this.apiKey = options.apiKey;
+        this.deviceId = options.deviceId;
+        this.onTelemetry = options.onTelemetry;
+    }
+    /** Fetch the current training round from the server. */
+    async getTrainingRound(federationId) {
+        const response = await this.request(`/api/v1/federations/${encodeURIComponent(federationId)}/rounds/current`);
+        if (!response.ok) {
+            throw new OctomilError("NETWORK_ERROR", `Failed to fetch training round: HTTP ${response.status}`);
+        }
+        return (await response.json());
+    }
+    /** Join a training round. */
+    async joinRound(federationId, roundId) {
+        const response = await this.request(`/api/v1/federations/${encodeURIComponent(federationId)}/rounds/${encodeURIComponent(roundId)}/join`, {
+            method: "POST",
+            body: JSON.stringify({ device_id: this.deviceId }),
+        });
+        if (!response.ok) {
+            throw new OctomilError("NETWORK_ERROR", `Failed to join round: HTTP ${response.status}`);
+        }
+    }
+    /**
+     * Run local training using a user-provided step function.
+     *
+     * Browser ONNX Runtime Web does not support training natively, so the
+     * caller provides `onTrainStep` which receives the current weights and
+     * a batch of data, and returns updated weights.
+     */
+    async train(initialWeights, config) {
+        const start = performance.now();
+        let weights = this.cloneWeights(initialWeights);
+        for (let epoch = 0; epoch < config.epochs; epoch++) {
+            const stepResult = await config.onTrainStep(weights, {
+                epoch,
+                batchSize: config.batchSize,
+                learningRate: config.learningRate,
+            });
+            weights = stepResult.weights;
+        }
+        const delta = WeightExtractor.computeDelta(initialWeights, weights);
+        const durationMs = performance.now() - start;
+        this.onTelemetry?.({
+            type: "training_complete",
+            model: config.modelId ?? "unknown",
+            durationMs,
+            metadata: {
+                epochs: config.epochs,
+                deltaNorm: WeightExtractor.l2Norm(delta),
+            },
+            timestamp: Date.now(),
+        });
+        return { finalWeights: weights, delta };
+    }
+    /** Submit a weight update to the aggregation server. */
+    async submitUpdate(federationId, roundId, delta, metrics) {
+        // Serialize WeightMap to a transferable format
+        const serialized = {};
+        for (const [key, arr] of Object.entries(delta)) {
+            if (!arr)
+                continue;
+            serialized[key] = {
+                data: Array.from(arr),
+                shape: [arr.length],
+            };
+        }
+        const response = await this.request(`/api/v1/federations/${encodeURIComponent(federationId)}/rounds/${encodeURIComponent(roundId)}/submit`, {
+            method: "POST",
+            body: JSON.stringify({
+                device_id: this.deviceId,
+                delta: serialized,
+                metrics,
+            }),
+        });
+        if (!response.ok) {
+            throw new OctomilError("NETWORK_ERROR", `Failed to submit update: HTTP ${response.status}`);
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    async request(path, init) {
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        return fetch(`${this.serverUrl}${path}`, {
+            ...init,
+            headers: { ...headers, ...init?.headers },
+        });
+    }
+    cloneWeights(weights) {
+        const cloned = {};
+        for (const [key, arr] of Object.entries(weights)) {
+            if (arr)
+                cloned[key] = new Float32Array(arr);
+        }
+        return cloned;
+    }
+}
+//# sourceMappingURL=federated.js.map

package/dist/federated.js.map

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