@rocapine/rocalytics-sdk 0.0.0-stage → 0.3.0

package/dist/core/httpSink.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHttpSink = createHttpSink;
+const sink_1 = require("./sink");
+/**
+ * A sink that POSTs each payload to an HTTP collector.
+ *
+ * The outcome comes from the response BODY only: `{"outcome": "accepted" |
+ * "ignored" | "rejected"}`. The status code is not read, because a proxy or
+ * gateway can answer 401, 404 or 413 without having looked at the payload, so
+ * any response without an outcome, and no response at all, is transient.
+ * It never throws.
+ *
+ * Its `destination` is `url`, marked ` (custom fetch)` when a `fetch` is
+ * passed: that one may never reach `url` (a test double), so it never counts
+ * as the same destination as the real one. Headers are not part of it.
+ */
+function createHttpSink(options) {
+    var _a;
+    const timeoutMs = (_a = options.timeoutMs) !== null && _a !== void 0 ? _a : 15000;
+    return {
+        destination: options.fetch ? `${options.url} (custom fetch)` : options.url,
+        async send(payload) {
+            var _a;
+            const doFetch = (_a = options.fetch) !== null && _a !== void 0 ? _a : globalThis.fetch;
+            if (!doFetch)
+                return { outcome: "transient", reason: "no fetch available" };
+            const Abort = globalThis.AbortController;
+            const controller = Abort ? new Abort() : null;
+            let timer;
+            try {
+                const extra = typeof options.headers === "function" ? await options.headers() : options.headers;
+                const request = doFetch(options.url, {
+                    method: "POST",
+                    headers: { ...extra, "content-type": "application/json" },
+                    body: JSON.stringify(payload),
+                    signal: controller === null || controller === void 0 ? void 0 : controller.signal,
+                }).then((res) => res.text());
+                const timeout = new Promise((_, reject) => {
+                    timer = setTimeout(() => {
+                        controller === null || controller === void 0 ? void 0 : controller.abort();
+                        reject(new Error("timeout"));
+                    }, timeoutMs);
+                });
+                const text = await Promise.race([request, timeout]);
+                let body = undefined;
+                try {
+                    body = JSON.parse(text);
+                }
+                catch {
+                    // Not JSON: no outcome, so transient.
+                }
+                return (0, sink_1.normalizeResult)(body);
+            }
+            catch (error) {
+                return { outcome: "transient", reason: String(error) };
+            }
+            finally {
+                if (timer !== undefined)
+                    clearTimeout(timer);
+            }
+        },
+    };
+}
+//# sourceMappingURL=httpSink.js.map

package/dist/core/httpSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpSink.js","sourceRoot":"","sources":["../../src/core/httpSink.ts"],"names":[],"mappings":";;AA8BA,wCAuCC;AArED,iCAAqE;AAiBrE;;;;;;;;;;;;GAYG;AACH,SAAgB,cAAc,CAAC,OAAwB;;IACrD,MAAM,SAAS,GAAG,MAAA,OAAO,CAAC,SAAS,mCAAI,KAAM,CAAC;IAC9C,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG;QAC1E,KAAK,CAAC,IAAI,CAAC,OAAO;;YAChB,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,KAAK,mCAAK,UAAU,CAAC,KAA6C,CAAC;YAC3F,IAAI,CAAC,OAAO;gBAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;YAC5E,MAAM,KAAK,GAAI,UAAiF,CAAC,eAAe,CAAC;YACjH,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9C,IAAI,KAAgD,CAAC;YACrD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;gBAChG,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;oBACnC,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBACzD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;oBAC7B,MAAM,EAAE,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,MAAM;iBAC3B,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC7B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBAC/C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;wBACtB,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,KAAK,EAAE,CAAC;wBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;oBAC/B,CAAC,EAAE,SAAS,CAAC,CAAC;gBAChB,CAAC,CAAC,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBACpD,IAAI,IAAI,GAAY,SAAS,CAAC;gBAC9B,IAAI,CAAC;oBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,sCAAsC;gBACxC,CAAC;gBACD,OAAO,IAAA,sBAAe,EAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,CAAC;oBAAS,CAAC;gBACT,IAAI,KAAK,KAAK,SAAS;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/ids.d.ts

@@ -0,0 +1,16 @@
+import type { Clock } from "./time";
+/**
+ * A lowercase UUIDv7 (RFC 9562): 48 bits of millisecond time, then random
+ * bits. It sorts by creation time, which is why the contract recommends it.
+ * `random` must hold at least 16 bytes; only the bits after the time are used.
+ */
+export declare function uuidv7(nowMs: number, random: Uint8Array): string;
+/**
+ * 16 random bytes from `crypto.getRandomValues` when the runtime has it, and
+ * from `Math.random` otherwise. A run id needs to be unique, not secret, so
+ * the fallback is acceptable on a runtime with no crypto global.
+ */
+export declare function randomBytes16(): Uint8Array;
+/** The default id minter: UUIDv7 from the injected clock. */
+export declare function createUuid(clock: Clock): () => string;
+//# sourceMappingURL=ids.d.ts.map

package/dist/core/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/core/ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAQpC;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAWhE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAS1C;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,MAAM,CAErD"}

package/dist/core/ids.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uuidv7 = uuidv7;
+exports.randomBytes16 = randomBytes16;
+exports.createUuid = createUuid;
+const hex = (bytes, from, to) => {
+    let out = "";
+    for (let i = from; i < to; i++)
+        out += (bytes[i] + 0x100).toString(16).slice(1);
+    return out;
+};
+/**
+ * A lowercase UUIDv7 (RFC 9562): 48 bits of millisecond time, then random
+ * bits. It sorts by creation time, which is why the contract recommends it.
+ * `random` must hold at least 16 bytes; only the bits after the time are used.
+ */
+function uuidv7(nowMs, random) {
+    var _a;
+    const b = new Uint8Array(16);
+    for (let i = 0; i < 16; i++)
+        b[i] = (_a = random[i]) !== null && _a !== void 0 ? _a : 0;
+    let t = Math.max(0, Math.floor(nowMs));
+    for (let i = 5; i >= 0; i--) {
+        b[i] = t % 256;
+        t = Math.floor(t / 256);
+    }
+    b[6] = 0x70 | (b[6] & 0x0f); // version 7
+    b[8] = 0x80 | (b[8] & 0x3f); // variant 10xx
+    return `${hex(b, 0, 4)}-${hex(b, 4, 6)}-${hex(b, 6, 8)}-${hex(b, 8, 10)}-${hex(b, 10, 16)}`;
+}
+/**
+ * 16 random bytes from `crypto.getRandomValues` when the runtime has it, and
+ * from `Math.random` otherwise. A run id needs to be unique, not secret, so
+ * the fallback is acceptable on a runtime with no crypto global.
+ */
+function randomBytes16() {
+    const out = new Uint8Array(16);
+    const c = globalThis.crypto;
+    if (c && typeof c.getRandomValues === "function") {
+        c.getRandomValues(out);
+        return out;
+    }
+    for (let i = 0; i < 16; i++)
+        out[i] = Math.floor(Math.random() * 256);
+    return out;
+}
+/** The default id minter: UUIDv7 from the injected clock. */
+function createUuid(clock) {
+    return () => uuidv7(clock.now(), randomBytes16());
+}
+//# sourceMappingURL=ids.js.map

package/dist/core/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/core/ids.ts"],"names":[],"mappings":";;AAaA,wBAWC;AAOD,sCASC;AAGD,gCAEC;AA3CD,MAAM,GAAG,GAAG,CAAC,KAAiB,EAAE,IAAY,EAAE,EAAU,EAAE,EAAE;IAC1D,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChF,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF;;;;GAIG;AACH,SAAgB,MAAM,CAAC,KAAa,EAAE,MAAkB;;IACtD,MAAM,CAAC,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;QAAE,CAAC,CAAC,CAAC,CAAC,GAAG,MAAA,MAAM,CAAC,CAAC,CAAC,mCAAI,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACf,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,YAAY;IACzC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe;IAC5C,OAAO,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;AAC9F,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa;IAC3B,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAC/B,MAAM,CAAC,GAAI,UAA+E,CAAC,MAAM,CAAC;IAClG,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QACjD,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IACtE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6DAA6D;AAC7D,SAAgB,UAAU,CAAC,KAAY;IACrC,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,17 @@
+export { captureRunContext } from "./context";
+export type { RunContextInput, WireRunContext } from "./context";
+export { consoleDiagnostics, safeDiagnostics } from "./diagnostics";
+export type { Diagnostic, DiagnosticHandler } from "./diagnostics";
+export { createDelivery } from "./delivery";
+export type { Delivery, DeliveryOptions, Outbound, RetryPolicy } from "./delivery";
+export { createHttpSink } from "./httpSink";
+export type { HttpSinkOptions } from "./httpSink";
+export { createUuid, randomBytes16, uuidv7 } from "./ids";
+export { normalizeResult } from "./sink";
+export type { Sink, SinkOutcome, SinkResult } from "./sink";
+export { createSerialStore, memoryStorage } from "./storage";
+export type { KeyValueStorage, SerialStore } from "./storage";
+export { codePointLength, utf8ByteLength } from "./text";
+export { systemClock, systemTimers, toTimestamp } from "./time";
+export type { Clock, Timers } from "./time";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACzC,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAChE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,32 @@
+"use strict";
+// @rocapine/rocalytics-sdk/core: shared building blocks for the surface subpaths.
+// Internal: exported so a custom sink or another surface can use it, with no
+// stability promise beyond what /onboarding re-exports.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toTimestamp = exports.systemTimers = exports.systemClock = exports.utf8ByteLength = exports.codePointLength = exports.memoryStorage = exports.createSerialStore = exports.normalizeResult = exports.uuidv7 = exports.randomBytes16 = exports.createUuid = exports.createHttpSink = exports.createDelivery = exports.safeDiagnostics = exports.consoleDiagnostics = exports.captureRunContext = void 0;
+var context_1 = require("./context");
+Object.defineProperty(exports, "captureRunContext", { enumerable: true, get: function () { return context_1.captureRunContext; } });
+var diagnostics_1 = require("./diagnostics");
+Object.defineProperty(exports, "consoleDiagnostics", { enumerable: true, get: function () { return diagnostics_1.consoleDiagnostics; } });
+Object.defineProperty(exports, "safeDiagnostics", { enumerable: true, get: function () { return diagnostics_1.safeDiagnostics; } });
+var delivery_1 = require("./delivery");
+Object.defineProperty(exports, "createDelivery", { enumerable: true, get: function () { return delivery_1.createDelivery; } });
+var httpSink_1 = require("./httpSink");
+Object.defineProperty(exports, "createHttpSink", { enumerable: true, get: function () { return httpSink_1.createHttpSink; } });
+var ids_1 = require("./ids");
+Object.defineProperty(exports, "createUuid", { enumerable: true, get: function () { return ids_1.createUuid; } });
+Object.defineProperty(exports, "randomBytes16", { enumerable: true, get: function () { return ids_1.randomBytes16; } });
+Object.defineProperty(exports, "uuidv7", { enumerable: true, get: function () { return ids_1.uuidv7; } });
+var sink_1 = require("./sink");
+Object.defineProperty(exports, "normalizeResult", { enumerable: true, get: function () { return sink_1.normalizeResult; } });
+var storage_1 = require("./storage");
+Object.defineProperty(exports, "createSerialStore", { enumerable: true, get: function () { return storage_1.createSerialStore; } });
+Object.defineProperty(exports, "memoryStorage", { enumerable: true, get: function () { return storage_1.memoryStorage; } });
+var text_1 = require("./text");
+Object.defineProperty(exports, "codePointLength", { enumerable: true, get: function () { return text_1.codePointLength; } });
+Object.defineProperty(exports, "utf8ByteLength", { enumerable: true, get: function () { return text_1.utf8ByteLength; } });
+var time_1 = require("./time");
+Object.defineProperty(exports, "systemClock", { enumerable: true, get: function () { return time_1.systemClock; } });
+Object.defineProperty(exports, "systemTimers", { enumerable: true, get: function () { return time_1.systemTimers; } });
+Object.defineProperty(exports, "toTimestamp", { enumerable: true, get: function () { return time_1.toTimestamp; } });
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA,kFAAkF;AAClF,6EAA6E;AAC7E,wDAAwD;;;AAExD,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA;AAE1B,6CAAoE;AAA3D,iHAAA,kBAAkB,OAAA;AAAE,8GAAA,eAAe,OAAA;AAE5C,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AAEvB,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AAEvB,6BAA0D;AAAjD,iGAAA,UAAU,OAAA;AAAE,oGAAA,aAAa,OAAA;AAAE,6FAAA,MAAM,OAAA;AAC1C,+BAAyC;AAAhC,uGAAA,eAAe,OAAA;AAExB,qCAA6D;AAApD,4GAAA,iBAAiB,OAAA;AAAE,wGAAA,aAAa,OAAA;AAEzC,+BAAyD;AAAhD,uGAAA,eAAe,OAAA;AAAE,sGAAA,cAAc,OAAA;AACxC,+BAAgE;AAAvD,mGAAA,WAAW,OAAA;AAAE,oGAAA,YAAY,OAAA;AAAE,mGAAA,WAAW,OAAA"}

package/dist/core/sink.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The three outcomes an ingest can give a snapshot, carried in its response
+ * body. Anything else (no response, an error, a response without one of these)
+ * is transient: the snapshot is kept and sent again.
+ */
+export type SinkOutcome = "accepted" | "ignored" | "rejected";
+export type SinkResult = {
+    outcome: SinkOutcome;
+    reason?: string;
+} | {
+    outcome: "transient";
+    reason?: string;
+};
+/**
+ * Delivers one payload somewhere. A sink reports what happened; it does not
+ * retry, and it may throw: the caller treats a throw as transient.
+ *
+ * The caller sends one payload of a run at a time, and counts a send with no
+ * answer after its attempt timeout (30 s by default) as transient. A sink that
+ * keeps working past that timeout can therefore overlap with the retry. Both
+ * carry the same seq and body, so this is safe against an ingest that ignores
+ * an equal seq, but a sink should give up before the attempt timeout (the
+ * stock HTTP sink gives up after 15 s).
+ */
+export interface Sink<T = unknown> {
+    /**
+     * Where payloads go, such as the collector's URL. Two sinks with the same
+     * destination are interchangeable: a reconfigure hands the old tracker's
+     * unsent snapshots to the new one, and stored ones are sent by either.
+     * Without it, only the same sink object counts as the same destination.
+     * A test double must not claim a real destination: the stock sinks mark
+     * theirs ` (custom fetch)` when given a `fetch`. Headers are not part of it.
+     */
+    readonly destination?: string;
+    send(payload: T): Promise<SinkResult> | SinkResult;
+}
+/** Reads a sink's answer strictly: only the three named outcomes end a send. */
+export declare function normalizeResult(value: unknown): SinkResult;
+//# sourceMappingURL=sink.d.ts.map

package/dist/core/sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../src/core/sink.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAE9D,MAAM,MAAM,UAAU,GAClB;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO;IAC/B;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;CACpD;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAS1D"}

package/dist/core/sink.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeResult = normalizeResult;
+/** Reads a sink's answer strictly: only the three named outcomes end a send. */
+function normalizeResult(value) {
+    if (value && typeof value === "object") {
+        const { outcome, reason } = value;
+        if (outcome === "accepted" || outcome === "ignored" || outcome === "rejected") {
+            return typeof reason === "string" ? { outcome, reason } : { outcome };
+        }
+        if (typeof reason === "string")
+            return { outcome: "transient", reason };
+    }
+    return { outcome: "transient" };
+}
+//# sourceMappingURL=sink.js.map

package/dist/core/sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.js","sourceRoot":"","sources":["../../src/core/sink.ts"],"names":[],"mappings":";;AAoCA,0CASC;AAVD,gFAAgF;AAChF,SAAgB,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAgD,CAAC;QAC7E,IAAI,OAAO,KAAK,UAAU,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;YAC9E,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QACxE,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC1E,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAClC,CAAC"}

package/dist/core/storage.d.ts

@@ -0,0 +1,52 @@
+/**
+ * A string key-value store. The shape matches `@react-native-async-storage/async-storage`
+ * and `localStorage`, so either can be passed as is; this package depends on neither.
+ */
+export interface KeyValueStorage {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+}
+/** An in-memory `KeyValueStorage`. Survives nothing; useful for tests and for opting out of persistence. */
+export declare function memoryStorage(): KeyValueStorage & {
+    dump(): Record<string, string>;
+};
+/** What a read found: a value (or nothing stored), a value that is not JSON, or no answer from storage at all. */
+export type ReadResult<T> = {
+    status: "ok";
+    value: T | null;
+} | {
+    status: "invalid";
+    error: unknown;
+} | {
+    status: "failed";
+    error: unknown;
+};
+export interface SerialStore<T> {
+    /** Reads the value, after every write queued before it. Null when absent or unreadable. */
+    load(): Promise<T | null>;
+    /**
+     * Reads the value, after every write queued before it, telling a value that
+     * is not JSON (`invalid`) from storage that did not answer (`failed`). A
+     * failed read is retried once, in the same turn, before it counts as failed.
+     * `waitFirst` is awaited inside that turn, before reading: operations queued
+     * after this read still wait for it, so it can be ordered behind work done
+     * elsewhere (another store's last writes) without them overtaking it.
+     */
+    read(waitFirst?: Promise<unknown>): Promise<ReadResult<T>>;
+    /** Queues a write (null removes the key). Never throws; failures go to `onError`. */
+    save(value: T | null): void;
+    /**
+     * Queues a write whose value is computed when its turn comes, so it is the
+     * latest one; `undefined` skips the write. Resolves once done. Never rejects.
+     */
+    saveWith(produce: () => T | null | undefined | Promise<T | null | undefined>): Promise<void>;
+    /** Resolves once every queued operation has finished. */
+    idle(): Promise<void>;
+}
+/**
+ * JSON values under one key, with every read and write applied in call order,
+ * so an older write can never land after a newer one.
+ */
+export declare function createSerialStore<T>(storage: KeyValueStorage, key: string, onError: (error: unknown) => void): SerialStore<T>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/core/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/core/storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,4GAA4G;AAC5G,wBAAgB,aAAa,IAAI,eAAe,GAAG;IAAE,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAQpF;AAED,kHAAkH;AAClH,MAAM,MAAM,UAAU,CAAC,CAAC,IACpB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,2FAA2F;IAC3F,IAAI,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1B;;;;;;;OAOG;IACH,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,qFAAqF;IACrF,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7F,yDAAyD;IACzD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAChC,WAAW,CAAC,CAAC,CAAC,CAqDhB"}

package/dist/core/storage.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryStorage = memoryStorage;
+exports.createSerialStore = createSerialStore;
+/** An in-memory `KeyValueStorage`. Survives nothing; useful for tests and for opting out of persistence. */
+function memoryStorage() {
+    const map = new Map();
+    return {
+        getItem: (k) => { var _a; return (_a = map.get(k)) !== null && _a !== void 0 ? _a : null; },
+        setItem: (k, v) => void map.set(k, v),
+        removeItem: (k) => void map.delete(k),
+        dump: () => Object.fromEntries(map),
+    };
+}
+/**
+ * JSON values under one key, with every read and write applied in call order,
+ * so an older write can never land after a newer one.
+ */
+function createSerialStore(storage, key, onError) {
+    const queue = { chain: Promise.resolve() };
+    const enqueue = (op, fallback) => {
+        const next = queue.chain.then(op).catch((e) => {
+            onError(e);
+            return fallback;
+        });
+        queue.chain = next;
+        return next;
+    };
+    const getRaw = async () => {
+        try {
+            return await storage.getItem(key);
+        }
+        catch {
+            return await storage.getItem(key); // one retry, still inside this turn of the queue
+        }
+    };
+    const read = (waitFirst) => enqueue(async () => {
+        if (waitFirst)
+            await waitFirst.catch(() => undefined);
+        let raw;
+        try {
+            raw = await getRaw();
+        }
+        catch (error) {
+            return { status: "failed", error };
+        }
+        if (raw == null)
+            return { status: "ok", value: null };
+        try {
+            return { status: "ok", value: JSON.parse(raw) };
+        }
+        catch (error) {
+            return { status: "invalid", error };
+        }
+    }, { status: "failed", error: undefined });
+    const write = async (value) => {
+        if (value === null)
+            await storage.removeItem(key);
+        else
+            await storage.setItem(key, JSON.stringify(value));
+    };
+    return {
+        load: () => read().then((r) => {
+            if (r.status === "ok")
+                return r.value;
+            onError(r.error);
+            return null;
+        }),
+        read,
+        save: (value) => void enqueue(() => write(value), undefined),
+        saveWith: (produce) => enqueue(async () => {
+            const value = await produce();
+            if (value !== undefined)
+                await write(value);
+        }, undefined),
+        idle: () => enqueue(() => undefined, undefined),
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/core/storage.js.map

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

package/dist/core/text.d.ts

@@ -0,0 +1,9 @@
+/**
+ * UTF-8 length of `s` in bytes, without `TextEncoder` or `Buffer` (neither is
+ * guaranteed on every JavaScript runtime an app ships on). A lone surrogate
+ * counts as the 3-byte replacement character, as an encoder would write it.
+ */
+export declare function utf8ByteLength(s: string): number;
+/** Length in code points: what JSON Schema's `minLength` / `maxLength` count. */
+export declare function codePointLength(s: string): number;
+//# sourceMappingURL=text.d.ts.map

package/dist/core/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/core/text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAiBhD;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAWjD"}

package/dist/core/text.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.utf8ByteLength = utf8ByteLength;
+exports.codePointLength = codePointLength;
+/**
+ * UTF-8 length of `s` in bytes, without `TextEncoder` or `Buffer` (neither is
+ * guaranteed on every JavaScript runtime an app ships on). A lone surrogate
+ * counts as the 3-byte replacement character, as an encoder would write it.
+ */
+function utf8ByteLength(s) {
+    let bytes = 0;
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (c < 0x80)
+            bytes += 1;
+        else if (c < 0x800)
+            bytes += 2;
+        else if (c >= 0xd800 && c <= 0xdbff && i + 1 < s.length) {
+            const next = s.charCodeAt(i + 1);
+            if (next >= 0xdc00 && next <= 0xdfff) {
+                bytes += 4;
+                i++;
+            }
+            else {
+                bytes += 3;
+            }
+        }
+        else
+            bytes += 3;
+    }
+    return bytes;
+}
+/** Length in code points: what JSON Schema's `minLength` / `maxLength` count. */
+function codePointLength(s) {
+    let n = 0;
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (c >= 0xd800 && c <= 0xdbff && i + 1 < s.length) {
+            const next = s.charCodeAt(i + 1);
+            if (next >= 0xdc00 && next <= 0xdfff)
+                i++;
+        }
+        n++;
+    }
+    return n;
+}
+//# sourceMappingURL=text.js.map

package/dist/core/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/core/text.ts"],"names":[],"mappings":";;AAKA,wCAiBC;AAGD,0CAWC;AApCD;;;;GAIG;AACH,SAAgB,cAAc,CAAC,CAAS;IACtC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,IAAI;YAAE,KAAK,IAAI,CAAC,CAAC;aACpB,IAAI,CAAC,GAAG,KAAK;YAAE,KAAK,IAAI,CAAC,CAAC;aAC1B,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACxD,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACjC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACrC,KAAK,IAAI,CAAC,CAAC;gBACX,CAAC,EAAE,CAAC;YACN,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;QACH,CAAC;;YAAM,KAAK,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iFAAiF;AACjF,SAAgB,eAAe,CAAC,CAAS;IACvC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACjC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM;gBAAE,CAAC,EAAE,CAAC;QAC5C,CAAC;QACD,CAAC,EAAE,CAAC;IACN,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/core/time.d.ts

@@ -0,0 +1,18 @@
+/** A source of the current time, in milliseconds since the epoch. Injected so tests can fix it. */
+export interface Clock {
+    now(): number;
+}
+/** The two timer functions the core uses. Injected so tests can drive time. */
+export interface Timers {
+    setTimeout(fn: () => void, ms: number): unknown;
+    clearTimeout(handle: unknown): void;
+}
+export declare const systemClock: Clock;
+export declare const systemTimers: Timers;
+/**
+ * A UTC timestamp with exactly three fractional digits and a `Z`, e.g.
+ * `2026-01-10T09:00:00.000Z`: the only timestamp form the contract accepts.
+ * `toISOString` produces exactly that for every year from 0 to 9999.
+ */
+export declare function toTimestamp(ms: number): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/core/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/core/time.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,WAAW,KAAK;IACpB,GAAG,IAAI,MAAM,CAAC;CACf;AAED,+EAA+E;AAC/E,MAAM,WAAW,MAAM;IACrB,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACrC;AAED,eAAO,MAAM,WAAW,EAAE,KAAiC,CAAC;AAE5D,eAAO,MAAM,YAAY,EAAE,MAG1B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/core/time.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.systemTimers = exports.systemClock = void 0;
+exports.toTimestamp = toTimestamp;
+exports.systemClock = { now: () => Date.now() };
+exports.systemTimers = {
+    setTimeout: (fn, ms) => setTimeout(fn, ms),
+    clearTimeout: (handle) => clearTimeout(handle),
+};
+/**
+ * A UTC timestamp with exactly three fractional digits and a `Z`, e.g.
+ * `2026-01-10T09:00:00.000Z`: the only timestamp form the contract accepts.
+ * `toISOString` produces exactly that for every year from 0 to 9999.
+ */
+function toTimestamp(ms) {
+    return new Date(ms).toISOString();
+}
+//# sourceMappingURL=time.js.map

package/dist/core/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/core/time.ts"],"names":[],"mappings":";;;AAuBA,kCAEC;AAdY,QAAA,WAAW,GAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AAE/C,QAAA,YAAY,GAAW;IAClC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC;IAC1C,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAuC,CAAC;CAChF,CAAC;AAEF;;;;GAIG;AACH,SAAgB,WAAW,CAAC,EAAU;IACpC,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC"}