@traffical/core-io 0.3.0

package/dist/decision-client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * DecisionClient
+ *
+ * I/O client for Traffical server-evaluated resolution and per-entity decisions.
+ * Platform-agnostic (uses standard fetch API).
+ */
+import type { Id, Context, EdgeDecideRequest, EdgeDecideResponse, ServerResolveRequest, ServerResolveResponse } from "@traffical/core";
+export interface DecisionClientConfig {
+    /** Base URL for the edge worker (e.g., "https://sdk.traffical.io") */
+    baseUrl: string;
+    /** Organization ID */
+    orgId: Id;
+    /** Project ID */
+    projectId: Id;
+    /** Environment */
+    env: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Default timeout in milliseconds (default: 5000 for resolve, 100 for decide) */
+    defaultTimeoutMs?: number;
+}
+export declare class DecisionClient {
+    private readonly config;
+    private readonly defaultTimeout;
+    constructor(config: DecisionClientConfig);
+    /**
+     * Full server-side resolution via POST /v1/resolve.
+     * Returns all parameter assignments resolved on the edge worker.
+     */
+    resolve(request: ServerResolveRequest): Promise<ServerResolveResponse | null>;
+    /**
+     * Per-entity edge decision via POST /v1/decide/:policyId.
+     */
+    decideEntity(request: EdgeDecideRequest, timeoutMs?: number): Promise<EdgeDecideResponse | null>;
+    /**
+     * Batch per-entity edge decisions via POST /v1/decide/batch.
+     */
+    decideEntityBatch(requests: EdgeDecideRequest[], timeoutMs?: number): Promise<(EdgeDecideResponse | null)[]>;
+    private _headers;
+}
+/**
+ * Creates an edge decide request from policy and context.
+ *
+ * @param policyId - The policy ID
+ * @param entityKeys - Array of context keys that identify the entity
+ * @param context - The evaluation context
+ * @param unitKeyValue - The unit key value
+ * @param allocationCount - Number of allocations (for dynamic)
+ * @returns The decide request, or null if entity ID cannot be built
+ */
+export declare function createEdgeDecideRequest(policyId: Id, entityKeys: string[], context: Context, unitKeyValue: string, allocationCount?: number): EdgeDecideRequest | null;
+//# sourceMappingURL=decision-client.d.ts.map

package/dist/decision-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-client.d.ts","sourceRoot":"","sources":["../src/decision-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,EAAE,EACF,OAAO,EACP,iBAAiB,EACjB,kBAAkB,EAElB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAMzB,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,KAAK,EAAE,EAAE,CAAC;IACV,iBAAiB;IACjB,SAAS,EAAE,EAAE,CAAC;IACd,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,EAAE,oBAAoB;IAKxC;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAqCnF;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,iBAAiB,EAC1B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAwCrC;;OAEG;IACG,iBAAiB,CACrB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,CAAC;IA0CzC,OAAO,CAAC,QAAQ;CASjB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,EAAE,EACZ,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,MAAM,GACvB,iBAAiB,GAAG,IAAI,CAkB1B"}

package/dist/decision-client.js

@@ -0,0 +1,170 @@
+/**
+ * DecisionClient
+ *
+ * I/O client for Traffical server-evaluated resolution and per-entity decisions.
+ * Platform-agnostic (uses standard fetch API).
+ */
+// =============================================================================
+// DecisionClient
+// =============================================================================
+export class DecisionClient {
+    config;
+    defaultTimeout;
+    constructor(config) {
+        this.config = config;
+        this.defaultTimeout = config.defaultTimeoutMs ?? 5000;
+    }
+    /**
+     * Full server-side resolution via POST /v1/resolve.
+     * Returns all parameter assignments resolved on the edge worker.
+     */
+    async resolve(request) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.defaultTimeout);
+            const url = `${this.config.baseUrl}/v1/resolve`;
+            const response = await fetch(url, {
+                method: "POST",
+                headers: this._headers(),
+                body: JSON.stringify({
+                    context: request.context,
+                    env: request.env ?? this.config.env,
+                    parameters: request.parameters,
+                }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                console.warn(`[Traffical] Resolve failed: ${response.status} ${response.statusText}`);
+                return null;
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                console.warn(`[Traffical] Resolve timed out after ${this.defaultTimeout}ms`);
+            }
+            else {
+                console.warn(`[Traffical] Resolve error:`, error);
+            }
+            return null;
+        }
+    }
+    /**
+     * Per-entity edge decision via POST /v1/decide/:policyId.
+     */
+    async decideEntity(request, timeoutMs) {
+        const timeout = timeoutMs ?? Math.min(this.defaultTimeout, 100);
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeout);
+            const url = `${this.config.baseUrl}/v1/decide/${request.policyId}`;
+            const response = await fetch(url, {
+                method: "POST",
+                headers: this._headers(),
+                body: JSON.stringify({
+                    entityId: request.entityId,
+                    unitKeyValue: request.unitKeyValue,
+                    allocationCount: request.allocationCount,
+                    context: request.context,
+                }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                console.warn(`[Traffical] Edge decide failed: ${response.status} ${response.statusText}`);
+                return null;
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                console.warn(`[Traffical] Edge decide timed out after ${timeout}ms`);
+            }
+            else {
+                console.warn(`[Traffical] Edge decide error:`, error);
+            }
+            return null;
+        }
+    }
+    /**
+     * Batch per-entity edge decisions via POST /v1/decide/batch.
+     */
+    async decideEntityBatch(requests, timeoutMs) {
+        if (requests.length === 0)
+            return [];
+        if (requests.length === 1) {
+            const result = await this.decideEntity(requests[0], timeoutMs);
+            return [result];
+        }
+        const timeout = timeoutMs ?? Math.min(this.defaultTimeout, 200);
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeout);
+            const url = `${this.config.baseUrl}/v1/decide/batch`;
+            const response = await fetch(url, {
+                method: "POST",
+                headers: this._headers(),
+                body: JSON.stringify({ requests }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                console.warn(`[Traffical] Edge batch decide failed: ${response.status} ${response.statusText}`);
+                return requests.map(() => null);
+            }
+            const data = (await response.json());
+            return data.responses;
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                console.warn(`[Traffical] Edge batch decide timed out after ${timeout}ms`);
+            }
+            else {
+                console.warn(`[Traffical] Edge batch decide error:`, error);
+            }
+            return requests.map(() => null);
+        }
+    }
+    _headers() {
+        return {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.config.apiKey}`,
+            "X-Org-Id": this.config.orgId,
+            "X-Project-Id": this.config.projectId,
+            "X-Env": this.config.env,
+        };
+    }
+}
+// =============================================================================
+// Utility Functions (moved from @traffical/core)
+// =============================================================================
+/**
+ * Creates an edge decide request from policy and context.
+ *
+ * @param policyId - The policy ID
+ * @param entityKeys - Array of context keys that identify the entity
+ * @param context - The evaluation context
+ * @param unitKeyValue - The unit key value
+ * @param allocationCount - Number of allocations (for dynamic)
+ * @returns The decide request, or null if entity ID cannot be built
+ */
+export function createEdgeDecideRequest(policyId, entityKeys, context, unitKeyValue, allocationCount) {
+    const parts = [];
+    for (const key of entityKeys) {
+        const value = context[key];
+        if (value === undefined || value === null) {
+            return null;
+        }
+        parts.push(String(value));
+    }
+    const entityId = parts.join("_");
+    return {
+        policyId,
+        entityId,
+        unitKeyValue,
+        allocationCount,
+        context,
+    };
+}
+//# sourceMappingURL=decision-client.js.map

package/dist/decision-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @traffical/core-io
+ *
+ * I/O layer for Traffical SDK.
+ * Provides DecisionClient for server-evaluated resolution and per-entity decisions.
+ */
+export { DecisionClient, createEdgeDecideRequest, type DecisionClientConfig, } from "./decision-client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * @traffical/core-io
+ *
+ * I/O layer for Traffical SDK.
+ * Provides DecisionClient for server-evaluated resolution and per-entity decisions.
+ */
+export { DecisionClient, createEdgeDecideRequest, } from "./decision-client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,uBAAuB,GAExB,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@traffical/core-io",
+  "version": "0.3.0",
+  "description": "I/O layer for Traffical SDK - DecisionClient for server-evaluated resolution",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@traffical/core": "0.3.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.3.0"
+  },
+  "keywords": [
+    "traffical",
+    "feature-flags",
+    "experimentation",
+    "decision-client"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/traffical/js-sdk"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}