cliodot 1.2.3 → 1.2.4

package/dist/decorators/workflow.js

@@ -1 +1,52 @@
-'use strict';const _0x51f7a9=_0x31a9;(function(_0x3c1de5,_0x233b66){const _0x4e1448=_0x31a9,_0x2d1e04=_0x3c1de5();while(!![]){try{const _0x2ebc44=-parseInt(_0x4e1448(0x169))/0x1+parseInt(_0x4e1448(0x16c))/0x2+parseInt(_0x4e1448(0x170))/0x3*(-parseInt(_0x4e1448(0x168))/0x4)+-parseInt(_0x4e1448(0x166))/0x5+-parseInt(_0x4e1448(0x178))/0x6+parseInt(_0x4e1448(0x171))/0x7*(-parseInt(_0x4e1448(0x16f))/0x8)+parseInt(_0x4e1448(0x16b))/0x9;if(_0x2ebc44===_0x233b66)break;else _0x2d1e04['push'](_0x2d1e04['shift']());}catch(_0x981436){_0x2d1e04['push'](_0x2d1e04['shift']());}}}(_0x49cb,0xa758f));Object[_0x51f7a9(0x167)](exports,_0x51f7a9(0x16e),{'value':!![]}),exports[_0x51f7a9(0x172)]=Workflow,exports[_0x51f7a9(0x179)]=Http,exports[_0x51f7a9(0x17b)]=Webhook,exports[_0x51f7a9(0x175)]=Job,exports['Schedule']=Schedule;const workflow_1=require(_0x51f7a9(0x173)),metadata_1=require(_0x51f7a9(0x176));function Workflow(_0x1230ff,_0x1af7f2){return function(_0x5009a8){const _0x5f2fa4=_0x31a9,_0x4ff460=(0x0,metadata_1[_0x5f2fa4(0x177)])(_0x5009a8);if(_0x1230ff)_0x4ff460[_0x5f2fa4(0x17c)]=_0x1230ff;if(_0x1af7f2)_0x4ff460['workflowName']=_0x1af7f2;};}function Http(_0x5acd2a,_0x1b1630){return function(_0x944811){const _0x29958b=_0x31a9,_0x312356=(0x0,metadata_1[_0x29958b(0x177)])(_0x944811),_0x1651ae={'type':workflow_1[_0x29958b(0x16a)][_0x29958b(0x16d)],'webhook_url':_0x1b1630,'webhookMethod':_0x5acd2a};_0x312356[_0x29958b(0x174)]=_0x1651ae;};}function Webhook(_0x339e86,_0x4797b2){return Http(_0x339e86,_0x4797b2);}function Job(_0x5bab73,_0x1604c9){return function(_0x57229b){const _0x387761=_0x31a9,_0x1de06c=(0x0,metadata_1[_0x387761(0x177)])(_0x57229b);_0x1de06c[_0x387761(0x174)]={'type':workflow_1[_0x387761(0x16a)]['JOB'],'cron':_0x5bab73??'*\x20*\x20*\x20*\x20*','timezone':_0x1604c9};};}function Schedule(_0x12cb75,_0x229ac4){return function(_0x32bed2){const _0x3f31fc=_0x31a9,_0x52ab5a=(0x0,metadata_1[_0x3f31fc(0x177)])(_0x32bed2);_0x52ab5a['trigger']={'type':workflow_1[_0x3f31fc(0x16a)][_0x3f31fc(0x17a)],'cron':_0x12cb75,'timezone':_0x229ac4};};}function _0x31a9(_0x18564d,_0x347387){_0x18564d=_0x18564d-0x166;const _0x49cb8b=_0x49cb();let _0x31a92b=_0x49cb8b[_0x18564d];if(_0x31a9['DHSaeO']===undefined){var _0x117cde=function(_0x40afca){const _0x3f1aa5='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x1230ff='',_0x1af7f2='';for(let _0x5009a8=0x0,_0x4ff460,_0x5acd2a,_0x1b1630=0x0;_0x5acd2a=_0x40afca['charAt'](_0x1b1630++);~_0x5acd2a&&(_0x4ff460=_0x5009a8%0x4?_0x4ff460*0x40+_0x5acd2a:_0x5acd2a,_0x5009a8++%0x4)?_0x1230ff+=String['fromCharCode'](0xff&_0x4ff460>>(-0x2*_0x5009a8&0x6)):0x0){_0x5acd2a=_0x3f1aa5['indexOf'](_0x5acd2a);}for(let _0x944811=0x0,_0x312356=_0x1230ff['length'];_0x944811<_0x312356;_0x944811++){_0x1af7f2+='%'+('00'+_0x1230ff['charCodeAt'](_0x944811)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x1af7f2);};_0x31a9['NjcLmC']=_0x117cde,_0x31a9['ZbMbtx']={},_0x31a9['DHSaeO']=!![];}const _0xe24d85=_0x49cb8b[0x0],_0x35e4fa=_0x18564d+_0xe24d85,_0x5345b0=_0x31a9['ZbMbtx'][_0x35e4fa];return!_0x5345b0?(_0x31a92b=_0x31a9['NjcLmC'](_0x31a92b),_0x31a9['ZbMbtx'][_0x35e4fa]=_0x31a92b):_0x31a92b=_0x5345b0,_0x31a92b;}function _0x49cb(){const _0x5b7250=['mJi2mdm0mtbJC2nvDhq','mJCZmdiYnKvVB2XWva','sfruua','x19LC01VzhvSzq','mZu0nda4DLnJAhfv','mJC2odDKEuzmqw0','mZvwtKTKCLO','v29YA2zSB3C','lI4VDhLWzxmVD29YA2zSB3C','DhjPz2DLCG','sM9I','lI9TzxrHzgf0yq','z2v0t3jdCMvHDgvxB3jRzMXVD01LDge','ndiZmte3nK5RrvDpEG','shr0Ca','u0nirurvteu','v2vIAg9VAW','D29YA2zSB3Djza','mZK5ntiYmhDurffPrq','zgvMAw5LuhjVCgvYDhK','mZq4q2XhzMzn','nJyYndGWr3bdvNf3','v29YA2zSB3DuCMLNz2vYvhLWzq'];_0x49cb=function(){return _0x5b7250;};return _0x49cb();}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Workflow = Workflow;
+exports.Http = Http;
+exports.Webhook = Webhook;
+exports.Job = Job;
+exports.Schedule = Schedule;
+const workflow_1 = require("../types/workflow");
+const metadata_1 = require("./metadata");
+function Workflow(workflowId, workflowName) {
+    return function (ctor) {
+        const meta = (0, metadata_1.getOrCreateWorkflowMeta)(ctor);
+        if (workflowId)
+            meta.workflowId = workflowId;
+        if (workflowName)
+            meta.workflowName = workflowName;
+    };
+}
+function Http(method, path) {
+    return function (ctor) {
+        const meta = (0, metadata_1.getOrCreateWorkflowMeta)(ctor);
+        const trigger = {
+            type: workflow_1.WorkflowTriggerType.HTTP,
+            webhook_url: path,
+            webhookMethod: method,
+        };
+        meta.trigger = trigger;
+    };
+}
+function Webhook(method, path) {
+    return Http(method, path);
+}
+function Job(cron, timezone) {
+    return function (ctor) {
+        const meta = (0, metadata_1.getOrCreateWorkflowMeta)(ctor);
+        meta.trigger = {
+            type: workflow_1.WorkflowTriggerType.JOB,
+            cron: cron ?? "* * * * *",
+            timezone,
+        };
+    };
+}
+function Schedule(cron, timezone) {
+    return function (ctor) {
+        const meta = (0, metadata_1.getOrCreateWorkflowMeta)(ctor);
+        meta.trigger = {
+            type: workflow_1.WorkflowTriggerType.SCHEDULE,
+            cron,
+            timezone,
+        };
+    };
+}

package/dist/errors.js

@@ -1 +1,76 @@
-'use strict';const _0x190f4d=_0x2746;(function(_0x37d98c,_0x45c28c){const _0x48c929=_0x2746,_0x19f938=_0x37d98c();while(!![]){try{const _0x2964c2=parseInt(_0x48c929(0x98))/0x1+parseInt(_0x48c929(0x92))/0x2+parseInt(_0x48c929(0x86))/0x3+-parseInt(_0x48c929(0x8c))/0x4+-parseInt(_0x48c929(0x97))/0x5+parseInt(_0x48c929(0x7e))/0x6+-parseInt(_0x48c929(0x89))/0x7*(parseInt(_0x48c929(0x93))/0x8);if(_0x2964c2===_0x45c28c)break;else _0x19f938['push'](_0x19f938['shift']());}catch(_0x4a3fd9){_0x19f938['push'](_0x19f938['shift']());}}}(_0x17cb,0xda1e3));function _0x17cb(){const _0x3e5a15=['q2XPB2rVDefWAuvYCM9Y','zgf0yq','CMvXDwvZDa','y29Kzq','uMvXDwvZDcbMywLSzwq','C3rYAw5N','mZaYodq1mKzxCvvrDa','CMvZCg9UC2u','zgvMAw5LuhjVCgvYDhK','ndL4wffpvKy','C3rYAw5NAwz5','AgvHzgvYCW','mty0mdmXmMjOy1bWDa','y29UzMLN','BMfTzq','BwvZC2fNzq','B2jQzwn0','CgfYC2vbCgLfCNjVCKnVzgu','mta4mZGXogHlEfLvwa','odK3nZG0D2Tdu2n4','x19LC01VzhvSzq','CgfYC2vbCgLfCNjVCLn0yxr1CW','y2XPB2rVDefWAuvYCM9YrNjVBuf4Aw9Z','nJG2nJyYnwreDgvnAq','nte1mJy4Exblthjb','DhjPBq','C2v0uhjVDg90ExbLt2y','C3rHDhvZ','odm3ndi4nhHjrffmrq','CgfYC2vbCgLfCNjVCK1LC3nHz2u'];_0x17cb=function(){return _0x3e5a15;};return _0x17cb();}Object[_0x190f4d(0x88)](exports,_0x190f4d(0x94),{'value':!![]}),exports[_0x190f4d(0x80)]=void 0x0,exports[_0x190f4d(0x96)]=cliodotApiErrorFromAxios;const parse_api_error_1=require('./http/parse-api-error');function coerceErrorMessage(_0xac1e1f,_0x18225e){const _0x4e43be=_0x190f4d;if(typeof _0xac1e1f===_0x4e43be(0x85)&&_0xac1e1f[_0x4e43be(0x99)]())return _0xac1e1f['trim']();if(_0xac1e1f&&typeof _0xac1e1f===_0x4e43be(0x90)){const _0x1708e7=(0x0,parse_api_error_1[_0x4e43be(0x7f)])(_0xac1e1f);if(_0x1708e7)return _0x1708e7;try{return JSON[_0x4e43be(0x8a)](_0xac1e1f);}catch{return _0x18225e;}}return _0x18225e;}function _0x2746(_0x1b4bd4,_0x279520){_0x1b4bd4=_0x1b4bd4-0x7e;const _0x17cbf4=_0x17cb();let _0x2746cf=_0x17cbf4[_0x1b4bd4];if(_0x2746['CFzeGf']===undefined){var _0x2b9466=function(_0x3504d8){const _0x2a8388='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0xac1e1f='',_0x18225e='';for(let _0x1708e7=0x0,_0x1c7957,_0x436944,_0x2d41c2=0x0;_0x436944=_0x3504d8['charAt'](_0x2d41c2++);~_0x436944&&(_0x1c7957=_0x1708e7%0x4?_0x1c7957*0x40+_0x436944:_0x436944,_0x1708e7++%0x4)?_0xac1e1f+=String['fromCharCode'](0xff&_0x1c7957>>(-0x2*_0x1708e7&0x6)):0x0){_0x436944=_0x2a8388['indexOf'](_0x436944);}for(let _0x25172d=0x0,_0x56f76b=_0xac1e1f['length'];_0x25172d<_0x56f76b;_0x25172d++){_0x18225e+='%'+('00'+_0xac1e1f['charCodeAt'](_0x25172d)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x18225e);};_0x2746['iKRzjE']=_0x2b9466,_0x2746['BLBqMl']={},_0x2746['CFzeGf']=!![];}const _0x5912a6=_0x17cbf4[0x0],_0xd97f8d=_0x1b4bd4+_0x5912a6,_0x299be9=_0x2746['BLBqMl'][_0xd97f8d];return!_0x299be9?(_0x2746cf=_0x2746['iKRzjE'](_0x2746cf),_0x2746['BLBqMl'][_0xd97f8d]=_0x2746cf):_0x2746cf=_0x299be9,_0x2746cf;}function isAxiosLikeResponse(value){const _0x386126=_0x190f4d;if(!value||typeof value!=='object')return![];const _0x1c7957=value;return _0x386126(0x81)in _0x1c7957&&(_0x386126(0x8d)in _0x1c7957||_0x386126(0x82)in _0x1c7957||_0x386126(0x8b)in _0x1c7957);}function resolveApiBody(_0x436944){const _0x3dd195=_0x190f4d;if(_0x436944?.[_0x3dd195(0x81)]!==undefined)return _0x436944[_0x3dd195(0x81)];if(isAxiosLikeResponse(_0x436944?.['response']))return _0x436944?.[_0x3dd195(0x87)]?.[_0x3dd195(0x81)];return _0x436944?.['response'];}class CliodotApiError extends Error{constructor(_0x2d41c2,_0x25172d){const _0x4229e4=_0x190f4d,_0x56f76b=resolveApiBody(_0x25172d),_0x24a58d=coerceErrorMessage(_0x2d41c2,'')||(0x0,parse_api_error_1[_0x4229e4(0x7f)])(_0x56f76b)||_0x4229e4(0x84);super(_0x24a58d),this['name']=_0x4229e4(0x80),this[_0x4229e4(0x9b)]=_0x25172d?.[_0x4229e4(0x9b)]??(0x0,parse_api_error_1[_0x4229e4(0x95)])(_0x56f76b,isAxiosLikeResponse(_0x25172d?.[_0x4229e4(0x87)])?_0x25172d?.[_0x4229e4(0x87)]?.['status']:undefined),this[_0x4229e4(0x87)]=_0x56f76b,this['data']=_0x56f76b,this[_0x4229e4(0x83)]=_0x25172d?.[_0x4229e4(0x83)]??(0x0,parse_api_error_1['parseApiErrorCode'])(this[_0x4229e4(0x81)]),Object[_0x4229e4(0x9a)](this,new.target.prototype);}['toJSON'](){const _0x5b0262=_0x190f4d;return{'name':this[_0x5b0262(0x8e)],'message':this[_0x5b0262(0x8f)],'status':this['status'],'code':this[_0x5b0262(0x83)],'data':this['data'],'response':this[_0x5b0262(0x87)]};}}exports[_0x190f4d(0x80)]=CliodotApiError;function cliodotApiErrorFromAxios(_0x1e53ca,_0x4e3cbb){const _0x5c377f=_0x190f4d,_0x4324ef=_0x1e53ca?.[_0x5c377f(0x87)]?.['data'],_0x1f42c1=(0x0,parse_api_error_1['parseApiErrorMessage'])(_0x4324ef)||_0x1e53ca?.[_0x5c377f(0x8f)]||_0x4e3cbb;return new CliodotApiError(_0x1f42c1,{'status':(0x0,parse_api_error_1[_0x5c377f(0x95)])(_0x4324ef,_0x1e53ca?.[_0x5c377f(0x87)]?.[_0x5c377f(0x9b)]),'data':_0x4324ef,'code':(0x0,parse_api_error_1[_0x5c377f(0x91)])(_0x4324ef)});}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliodotApiError = void 0;
+exports.cliodotApiErrorFromAxios = cliodotApiErrorFromAxios;
+const parse_api_error_1 = require("./http/parse-api-error");
+function coerceErrorMessage(message, fallback) {
+    if (typeof message === "string" && message.trim())
+        return message.trim();
+    if (message && typeof message === "object") {
+        const parsed = (0, parse_api_error_1.parseApiErrorMessage)(message);
+        if (parsed)
+            return parsed;
+        try {
+            return JSON.stringify(message);
+        }
+        catch {
+            return fallback;
+        }
+    }
+    return fallback;
+}
+function isAxiosLikeResponse(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const candidate = value;
+    return ("data" in candidate &&
+        ("config" in candidate || "request" in candidate || "headers" in candidate));
+}
+function resolveApiBody(options) {
+    if (options?.data !== undefined) {
+        return options.data;
+    }
+    if (isAxiosLikeResponse(options?.response)) {
+        return options?.response?.data;
+    }
+    return options?.response;
+}
+class CliodotApiError extends Error {
+    constructor(message, options) {
+        const data = resolveApiBody(options);
+        const resolved = coerceErrorMessage(message, "") ||
+            (0, parse_api_error_1.parseApiErrorMessage)(data) ||
+            "Request failed";
+        super(resolved);
+        this.name = "CliodotApiError";
+        this.status =
+            options?.status ??
+                (0, parse_api_error_1.parseApiErrorStatus)(data, isAxiosLikeResponse(options?.response)
+                    ? options?.response?.status
+                    : undefined);
+        this.response = data;
+        this.data = data;
+        this.code = options?.code ?? (0, parse_api_error_1.parseApiErrorCode)(this.data);
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            status: this.status,
+            code: this.code,
+            data: this.data,
+            response: this.response,
+        };
+    }
+}
+exports.CliodotApiError = CliodotApiError;
+function cliodotApiErrorFromAxios(err, fallbackMessage) {
+    const data = err?.response?.data;
+    const message = (0, parse_api_error_1.parseApiErrorMessage)(data) || err?.message || fallbackMessage;
+    return new CliodotApiError(message, {
+        status: (0, parse_api_error_1.parseApiErrorStatus)(data, err?.response?.status),
+        data,
+        code: (0, parse_api_error_1.parseApiErrorCode)(data),
+    });
+}

package/dist/http/__tests__/cliodot-request.environment.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cliodot-request.environment.test.d.ts.map

package/dist/http/__tests__/cliodot-request.environment.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliodot-request.environment.test.d.ts","sourceRoot":"","sources":["../../../src/http/__tests__/cliodot-request.environment.test.ts"],"names":[],"mappings":""}

package/dist/http/__tests__/cliodot-request.environment.test.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cliodot_request_1 = require("../cliodot-request");
+describe("SDK environment headers", () => {
+    it("normalizes aliases and ignores invalid values", () => {
+        expect((0, cliodot_request_1.normalizeSdkEnvironment)("development")).toBe("dev");
+        expect((0, cliodot_request_1.normalizeSdkEnvironment)("production")).toBe("prod");
+        expect((0, cliodot_request_1.normalizeSdkEnvironment)("staging")).toBeUndefined();
+    });
+    it("adds x-environment on bearer auth when pinned", () => {
+        const headers = (0, cliodot_request_1.resolveBearerAuthHeaders)({
+            appId: "psv_app_1",
+            apiKey: "pak_test",
+            environment: "prod",
+        });
+        expect(headers).toMatchObject({
+            "x-cliodot-app-id": "psv_app_1",
+            Authorization: "Bearer pak_test",
+            "x-environment": "prod",
+        });
+    });
+    it("omits x-environment when the client is not pinned", () => {
+        const headers = (0, cliodot_request_1.resolveBearerAuthHeaders)({
+            appId: "psv_app_1",
+            apiKey: "pak_test",
+        });
+        expect(headers).toMatchObject({
+            "x-cliodot-app-id": "psv_app_1",
+            Authorization: "Bearer pak_test",
+        });
+        expect(headers["x-environment"]).toBeUndefined();
+    });
+    it("does not add a header for unknown environment values", () => {
+        const headers = (0, cliodot_request_1.applyEnvironmentHeader)({}, "staging");
+        expect(headers["x-environment"]).toBeUndefined();
+    });
+});

package/dist/http/__tests__/cliodot-result.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cliodot-result.test.d.ts.map

package/dist/http/__tests__/cliodot-result.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliodot-result.test.d.ts","sourceRoot":"","sources":["../../../src/http/__tests__/cliodot-result.test.ts"],"names":[],"mappings":""}

package/dist/http/__tests__/cliodot-result.test.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cliodot_result_1 = require("../cliodot-result");
+describe("cliodot-result", () => {
+    it("cliodotFail builds structured failure", () => {
+        const result = (0, cliodot_result_1.cliodotFail)("TEST", "boom", { status: 400 });
+        expect(result).toEqual({
+            ok: false,
+            error: { code: "TEST", message: "boom", status: 400 },
+        });
+    });
+    it("isCliodotOk / isCliodotFail discriminate", () => {
+        expect((0, cliodot_result_1.isCliodotOk)((0, cliodot_result_1.cliodotOk)({ value: 1 }))).toBe(true);
+        expect((0, cliodot_result_1.isCliodotFail)((0, cliodot_result_1.cliodotValidationFail)("bad"))).toBe(true);
+    });
+    it("resolveConfigError returns first invalid check", () => {
+        expect((0, cliodot_result_1.resolveConfigError)([
+            { valid: true, message: "ok" },
+            { valid: false, message: "missing baseUrl" },
+        ])).toEqual({ code: cliodot_result_1.SDK_ERROR.CONFIG, message: "missing baseUrl" });
+    });
+    it("resolveRequiredString validates non-empty strings", () => {
+        expect((0, cliodot_result_1.resolveRequiredString)("", "service")).toEqual({
+            ok: false,
+            error: { code: cliodot_result_1.SDK_ERROR.VALIDATION, message: "service is required" },
+        });
+        expect((0, cliodot_result_1.resolveRequiredString)("pay", "service")).toBeNull();
+    });
+    it("ensureOkTrue wraps bodies without ok", () => {
+        expect((0, cliodot_result_1.ensureOkTrue)({ keys: [] })).toEqual({ ok: true, keys: [] });
+        expect((0, cliodot_result_1.ensureOkTrue)({ ok: true, keys: [] })).toEqual({ ok: true, keys: [] });
+    });
+    it("normalizeApiFailure reads nested error objects", () => {
+        expect((0, cliodot_result_1.normalizeApiFailure)({ ok: false, error: { code: "X", message: "nope" } }, 502)).toEqual({
+            ok: false,
+            error: { code: "X", message: "nope", status: 502, details: { ok: false, error: { code: "X", message: "nope" } } },
+        });
+    });
+    it("failureFromCaught maps axios-like errors", () => {
+        const err = {
+            response: {
+                status: 401,
+                data: { ok: false, error: { code: "UNAUTHORIZED", message: "bad key" } },
+            },
+            message: "Request failed with status code 401",
+        };
+        expect((0, cliodot_result_1.failureFromCaught)(err, "fallback")).toEqual({
+            ok: false,
+            error: {
+                code: "UNAUTHORIZED",
+                message: "bad key",
+                status: 401,
+                details: err.response.data,
+            },
+        });
+    });
+});

package/dist/http/__tests__/events-instance-id.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events-instance-id.test.d.ts.map

package/dist/http/__tests__/events-instance-id.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-instance-id.test.d.ts","sourceRoot":"","sources":["../../../src/http/__tests__/events-instance-id.test.ts"],"names":[],"mappings":""}

package/dist/http/__tests__/events-instance-id.test.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const crypto_1 = require("crypto");
+const events_instance_id_1 = require("../events-instance-id");
+jest.mock("os", () => ({
+    hostname: jest.fn(() => "pc-one"),
+    platform: jest.fn(() => "darwin"),
+    arch: jest.fn(() => "arm64"),
+    userInfo: jest.fn(() => ({ username: "huios" })),
+    homedir: jest.fn(() => "/Users/huios"),
+    cpus: jest.fn(() => [{ model: "Apple M-series" }]),
+}));
+const os = require("os");
+describe("resolveEventsInstanceId", () => {
+    beforeEach(() => {
+        os.hostname.mockReturnValue("pc-one");
+    });
+    it("keeps the same id on the same computer", () => {
+        const a = (0, events_instance_id_1.resolveEventsInstanceId)({ appId: "evt_app_1" });
+        const b = (0, events_instance_id_1.resolveEventsInstanceId)({ appId: "evt_app_1" });
+        expect(a).toBe(b);
+        expect(a).toHaveLength(64);
+    });
+    it("changes when the computer hostname changes", () => {
+        const first = (0, events_instance_id_1.resolveEventsInstanceId)({ appId: "evt_app_1" });
+        os.hostname.mockReturnValue("pc-two");
+        const second = (0, events_instance_id_1.resolveEventsInstanceId)({ appId: "evt_app_1" });
+        expect(second).not.toBe(first);
+    });
+    it("accepts a stable override", () => {
+        expect((0, events_instance_id_1.resolveEventsInstanceId)({
+            appId: "evt_app_1",
+            instanceId: "test-instance",
+        })).toBe("test-instance");
+    });
+    it("hashes a short override", () => {
+        const hashed = (0, events_instance_id_1.resolveEventsInstanceId)({
+            appId: "evt_app_1",
+            instanceId: "pc1",
+        });
+        expect(hashed).toBe((0, crypto_1.createHash)("sha256")
+            .update("cliodot-events:evt_app_1:override:pc1")
+            .digest("hex"));
+    });
+});

package/dist/http/cliodot-request.d.ts

@@ -0,0 +1,35 @@
+import type { AxiosInstance } from "axios";
+import { type CliodotFail, type CliodotMethodResult, type CliodotStructuredError } from "./cliodot-result";
+export type AuthHeadersResult = Record<string, string> | CliodotFail;
+export type SdkEnvironment = "dev" | "prod";
+export declare function normalizeSdkEnvironment(value?: string): SdkEnvironment | undefined;
+export declare function applyEnvironmentHeader(headers: Record<string, string>, environment?: string): Record<string, string>;
+export type ExecuteCliodotRequestOptions<T extends object> = {
+    configError?: CliodotStructuredError | null;
+    authHeaders: AuthHeadersResult;
+    axios: AxiosInstance;
+    method: string;
+    path: string;
+    body?: unknown;
+    params?: Record<string, unknown>;
+    validateStatus?: (status: number) => boolean;
+    transformErrorMessage?: (message: string, code?: string) => string;
+    passThrough?: (data: unknown, status: number) => T | CliodotFail | null;
+    fallbackMessage?: string;
+};
+export declare function executeCliodotRequest<T extends object>(options: ExecuteCliodotRequestOptions<T>): Promise<CliodotMethodResult<T>>;
+export declare function resolveBearerAuthHeaders(input: {
+    appId: string;
+    apiKey?: string;
+    appSecret?: string;
+    environment?: string;
+    missingMessage?: string;
+}): AuthHeadersResult;
+export declare function resolveS2SAuthHeaders(input: {
+    appId: string;
+    appApiKey?: string;
+    appSecret?: string;
+    missingMessage?: string;
+}): AuthHeadersResult;
+export declare function parseFailureFromBody(data: unknown, status?: number): CliodotFail;
+//# sourceMappingURL=cliodot-request.d.ts.map

package/dist/http/cliodot-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliodot-request.d.ts","sourceRoot":"","sources":["../../src/http/cliodot-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAE5B,MAAM,kBAAkB,CAAC;AAG1B,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5C,wBAAgB,uBAAuB,CACrC,KAAK,CAAC,EAAE,MAAM,GACb,cAAc,GAAG,SAAS,CAM5B;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxB;AAED,MAAM,MAAM,4BAA4B,CAAC,CAAC,SAAS,MAAM,IAAI;IAC3D,WAAW,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5C,WAAW,EAAE,iBAAiB,CAAC;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACnE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAcF,wBAAsB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAC1D,OAAO,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAwCjC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,iBAAiB,CAkBpB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,iBAAiB,CAcpB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAIhF"}

package/dist/http/cliodot-request.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeSdkEnvironment = normalizeSdkEnvironment;
+exports.applyEnvironmentHeader = applyEnvironmentHeader;
+exports.executeCliodotRequest = executeCliodotRequest;
+exports.resolveBearerAuthHeaders = resolveBearerAuthHeaders;
+exports.resolveS2SAuthHeaders = resolveS2SAuthHeaders;
+exports.parseFailureFromBody = parseFailureFromBody;
+const cliodot_result_1 = require("./cliodot-result");
+const parse_api_error_1 = require("./parse-api-error");
+function normalizeSdkEnvironment(value) {
+    if (!value)
+        return undefined;
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "dev" || normalized === "development")
+        return "dev";
+    if (normalized === "prod" || normalized === "production")
+        return "prod";
+    return undefined;
+}
+function applyEnvironmentHeader(headers, environment) {
+    const normalized = normalizeSdkEnvironment(environment);
+    if (normalized) {
+        headers["x-environment"] = normalized;
+    }
+    return headers;
+}
+function cleanParams(params) {
+    if (!params)
+        return undefined;
+    const out = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        out[key] = value;
+    }
+    return Object.keys(out).length ? out : undefined;
+}
+async function executeCliodotRequest(options) {
+    if (options.configError) {
+        return (0, cliodot_result_1.cliodotFail)(options.configError.code, options.configError.message);
+    }
+    if ((0, cliodot_result_1.isCliodotFail)(options.authHeaders)) {
+        return options.authHeaders;
+    }
+    const fallbackMessage = options.fallbackMessage || `Request failed: ${options.method} ${options.path}`;
+    try {
+        const response = await options.axios({
+            method: options.method,
+            url: options.path,
+            headers: options.authHeaders,
+            data: options.body,
+            params: cleanParams(options.params),
+            ...(options.validateStatus ? { validateStatus: options.validateStatus } : {}),
+        });
+        const data = response.data;
+        const status = response.status;
+        if (options.passThrough) {
+            const passed = options.passThrough(data, status);
+            if (passed !== null) {
+                return passed;
+            }
+        }
+        if (status >= 400 || (data && typeof data === "object" && data.ok === false)) {
+            return (0, cliodot_result_1.normalizeApiFailure)(data, status, options.transformErrorMessage);
+        }
+        return (0, cliodot_result_1.ensureOkTrue)(data);
+    }
+    catch (err) {
+        return (0, cliodot_result_1.failureFromCaught)(err, fallbackMessage, options.transformErrorMessage);
+    }
+}
+function resolveBearerAuthHeaders(input) {
+    const headers = {
+        "x-cliodot-app-id": input.appId,
+    };
+    applyEnvironmentHeader(headers, input.environment);
+    if (input.apiKey) {
+        headers.Authorization = `Bearer ${input.apiKey}`;
+        return headers;
+    }
+    if (input.appSecret) {
+        headers.Authorization = `Bearer ${input.appSecret}`;
+        headers["x-cliodot-app-secret"] = input.appSecret;
+        return headers;
+    }
+    return (0, cliodot_result_1.cliodotFail)(cliodot_result_1.SDK_ERROR.AUTH, input.missingMessage || "App credentials required (apiKey/appApiKey or appSecret)");
+}
+function resolveS2SAuthHeaders(input) {
+    if (input.appApiKey) {
+        return { Authorization: `Bearer ${input.appApiKey}` };
+    }
+    if (input.appSecret) {
+        return {
+            "X-Cliodot-App-Id": input.appId,
+            "X-Cliodot-App-Secret": input.appSecret,
+        };
+    }
+    return (0, cliodot_result_1.cliodotFail)(cliodot_result_1.SDK_ERROR.AUTH, input.missingMessage || "App credentials required (appApiKey or appSecret)");
+}
+function parseFailureFromBody(data, status) {
+    const code = (0, parse_api_error_1.parseApiErrorCode)(data) || (status ? `HTTP_${status}` : cliodot_result_1.SDK_ERROR.REQUEST_FAILED);
+    const message = (0, parse_api_error_1.parseApiErrorMessage)(data) || "Request failed";
+    return (0, cliodot_result_1.cliodotFail)(code, message, { status, details: data });
+}

package/dist/http/cliodot-result.d.ts

@@ -0,0 +1,40 @@
+export type CliodotStructuredError = {
+    code: string;
+    message: string;
+    status?: number;
+    details?: unknown;
+};
+export type CliodotFail = {
+    ok: false;
+    error: CliodotStructuredError;
+};
+export type CliodotOk<T extends object = Record<string, never>> = {
+    ok: true;
+} & T;
+export type CliodotMethodResult<T extends object = Record<string, never>> = CliodotOk<T> | CliodotFail;
+export declare const SDK_ERROR: {
+    readonly CONFIG: "SDK_CONFIG_INVALID";
+    readonly VALIDATION: "SDK_VALIDATION";
+    readonly AUTH: "SDK_AUTH_MISSING";
+    readonly NETWORK: "NETWORK_ERROR";
+    readonly UNKNOWN: "UNKNOWN";
+    readonly REQUEST_FAILED: "REQUEST_FAILED";
+};
+export declare function cliodotFail(code: string, message: string, extras?: {
+    status?: number;
+    details?: unknown;
+}): CliodotFail;
+export declare function cliodotValidationFail(message: string): CliodotFail;
+export declare function cliodotOk<T extends object>(data: T): CliodotOk<T>;
+export declare function isCliodotFail(value: unknown): value is CliodotFail;
+export declare function isCliodotOk<T extends object>(value: CliodotMethodResult<T> | unknown): value is CliodotOk<T>;
+export declare function resolveConfigError(checks: Array<{
+    valid: boolean;
+    message: string;
+    code?: string;
+}>): CliodotStructuredError | null;
+export declare function resolveRequiredString(value: unknown, label: string): CliodotFail | null;
+export declare function ensureOkTrue<T extends object>(data: unknown): CliodotMethodResult<T>;
+export declare function normalizeApiFailure(data: unknown, status?: number, transformMessage?: (message: string, code?: string) => string): CliodotFail;
+export declare function failureFromCaught(err: unknown, fallbackMessage: string, transformMessage?: (message: string, code?: string) => string): CliodotFail;
+//# sourceMappingURL=cliodot-result.d.ts.map

package/dist/http/cliodot-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliodot-result.d.ts","sourceRoot":"","sources":["../../src/http/cliodot-result.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,sBAAsB,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI;IAChE,EAAE,EAAE,IAAI,CAAC;CACV,GAAG,CAAC,CAAC;AAEN,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IACpE,SAAS,CAAC,CAAC,CAAC,GACZ,WAAW,CAAC;AAEhB,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC;AAEX,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9C,WAAW,CAUb;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAElE;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAEjE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CASlE;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAC1C,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,OAAO,GACtC,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,CAEvB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAChE,sBAAsB,GAAG,IAAI,CAO/B;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,WAAW,GAAG,IAAI,CAKpB;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,IAAI,EAAE,OAAO,GACZ,mBAAmB,CAAC,CAAC,CAAC,CAYxB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,GAC5D,WAAW,CAYb;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,eAAe,EAAE,MAAM,EACvB,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,GAC5D,WAAW,CAgEb"}

package/dist/http/cliodot-result.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_ERROR = void 0;
+exports.cliodotFail = cliodotFail;
+exports.cliodotValidationFail = cliodotValidationFail;
+exports.cliodotOk = cliodotOk;
+exports.isCliodotFail = isCliodotFail;
+exports.isCliodotOk = isCliodotOk;
+exports.resolveConfigError = resolveConfigError;
+exports.resolveRequiredString = resolveRequiredString;
+exports.ensureOkTrue = ensureOkTrue;
+exports.normalizeApiFailure = normalizeApiFailure;
+exports.failureFromCaught = failureFromCaught;
+const parse_api_error_1 = require("./parse-api-error");
+exports.SDK_ERROR = {
+    CONFIG: "SDK_CONFIG_INVALID",
+    VALIDATION: "SDK_VALIDATION",
+    AUTH: "SDK_AUTH_MISSING",
+    NETWORK: "NETWORK_ERROR",
+    UNKNOWN: "UNKNOWN",
+    REQUEST_FAILED: "REQUEST_FAILED",
+};
+function cliodotFail(code, message, extras) {
+    return {
+        ok: false,
+        error: {
+            code,
+            message,
+            ...(extras?.status !== undefined ? { status: extras.status } : {}),
+            ...(extras?.details !== undefined ? { details: extras.details } : {}),
+        },
+    };
+}
+function cliodotValidationFail(message) {
+    return cliodotFail(exports.SDK_ERROR.VALIDATION, message);
+}
+function cliodotOk(data) {
+    return { ok: true, ...data };
+}
+function isCliodotFail(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        value.ok === false &&
+        !!value.error &&
+        typeof value.error.code === "string" &&
+        typeof value.error.message === "string");
+}
+function isCliodotOk(value) {
+    return !!value && typeof value === "object" && value.ok === true;
+}
+function resolveConfigError(checks) {
+    const failed = checks.find((check) => !check.valid);
+    if (!failed)
+        return null;
+    return {
+        code: failed.code || exports.SDK_ERROR.CONFIG,
+        message: failed.message,
+    };
+}
+function resolveRequiredString(value, label) {
+    if (typeof value !== "string" || !value.trim()) {
+        return cliodotValidationFail(`${label} is required`);
+    }
+    return null;
+}
+function ensureOkTrue(data) {
+    if (!data || typeof data !== "object") {
+        return cliodotFail(exports.SDK_ERROR.UNKNOWN, "Invalid response body");
+    }
+    const body = data;
+    if (body.ok === false) {
+        return normalizeApiFailure(body);
+    }
+    if (body.ok === true) {
+        return body;
+    }
+    return cliodotOk(body);
+}
+function normalizeApiFailure(data, status, transformMessage) {
+    let code = (0, parse_api_error_1.parseApiErrorCode)(data) || (status ? `HTTP_${status}` : exports.SDK_ERROR.REQUEST_FAILED);
+    let message = (0, parse_api_error_1.parseApiErrorMessage)(data) || "Request failed";
+    if (transformMessage) {
+        message = transformMessage(message, code);
+    }
+    return cliodotFail(code, message, {
+        status,
+        details: data,
+    });
+}
+function failureFromCaught(err, fallbackMessage, transformMessage) {
+    if (isCliodotFail(err)) {
+        return err;
+    }
+    const axiosResponse = err &&
+        typeof err === "object" &&
+        "response" in err
+        ? err.response
+        : undefined;
+    if (axiosResponse) {
+        const status = axiosResponse.status;
+        const data = axiosResponse.data;
+        if (data && typeof data === "object" && data.ok === false) {
+            return normalizeApiFailure(data, status, transformMessage);
+        }
+        let message = fallbackMessage;
+        if (data && typeof data === "object") {
+            const rawMessage = data.message;
+            if (typeof rawMessage === "string" && rawMessage.trim()) {
+                message = rawMessage.trim();
+            }
+        }
+        else if (typeof err.message === "string" &&
+            String(err.message).trim()) {
+            message = String(err.message).trim();
+        }
+        const code = (0, parse_api_error_1.parseApiErrorCode)(data) || (status ? `HTTP_${status}` : exports.SDK_ERROR.NETWORK);
+        const finalMessage = transformMessage ? transformMessage(message, code) : message;
+        return cliodotFail(code, finalMessage, { status, details: data ?? err });
+    }
+    if (err && typeof err === "object" && "code" in err && "message" in err) {
+        const structured = err;
+        const message = transformMessage
+            ? transformMessage(structured.message, structured.code)
+            : structured.message;
+        return cliodotFail(structured.code, message, {
+            status: structured.status,
+            details: structured.details,
+        });
+    }
+    const message = (err instanceof Error && err.message.trim()) ||
+        (typeof err === "string" && err.trim()) ||
+        fallbackMessage;
+    const finalMessage = transformMessage ? transformMessage(message) : message;
+    const isNetwork = err &&
+        typeof err === "object" &&
+        ("code" in err || "errno" in err) &&
+        !axiosResponse;
+    return cliodotFail(isNetwork ? exports.SDK_ERROR.NETWORK : exports.SDK_ERROR.UNKNOWN, finalMessage, { details: err });
+}

package/dist/http/create-client.d.ts

@@ -0,0 +1,3 @@
+import { AxiosInstance, CreateAxiosDefaults } from "axios";
+export declare function createCliodotAxios(config?: CreateAxiosDefaults): AxiosInstance;
+//# sourceMappingURL=create-client.d.ts.map

package/dist/http/create-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-client.d.ts","sourceRoot":"","sources":["../../src/http/create-client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAGlE,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,mBAAwB,GAC/B,aAAa,CAKf"}