@streamotter/contracts 0.1.0-rc.1

package/dist/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEtD,6EAA6E;AAC7E,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAoB1C,CAAC;AAEH,eAAO,MAAM,UAAU,EAAkC,SAAS,CAAC,MAAM,MAAM,CAAC,EAAE,CAAC;AAEnF,wBAAgB,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,CAE5E;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CA4CxF"}

package/dist/limits.js

@@ -0,0 +1,76 @@
+import { pointer } from "./schema.js";
+/** Starting bounds from the specification; not published capacity claims. */
+export const DEFAULT_LIMITS = Object.freeze({
+    maxConnections: 1_000,
+    maxSubscriptionsPerConnection: 50,
+    maxSourceRecordBytes: 1_048_576,
+    maxDataFrameBytes: 65_536,
+    maxParamsBytes: 4_096,
+    maxPendingFramesPerSubscription: 100,
+    maxPendingBytesPerSubscription: 1_048_576,
+    maxPendingBytesPerConnection: 4_194_304,
+    maxPendingBytesGateway: 67_108_864,
+    maxMapOutputs: 100,
+    maxConcurrentSnapshots: 32,
+    handlerTimeoutMs: 2_000,
+    snapshotTimeoutMs: 10_000,
+    receiptTimeoutMs: 5_000,
+    maxSyncAttempts: 3,
+    maxTraceEntries: 10_000,
+    maxTraceBytes: 8_388_608,
+    maxControlFrameBytes: 16_384,
+    controlRequestsPerSecond: 20
+});
+export const LIMIT_KEYS = Object.keys(DEFAULT_LIMITS);
+export function resolveLimits(overrides) {
+    return { ...DEFAULT_LIMITS, ...(overrides ?? {}) };
+}
+/** Validates override values and cross-field consistency of the resolved limits. */
+export function validateLimits(input, path, issues) {
+    if (input === undefined)
+        return;
+    if (typeof input !== "object" || input === null || Array.isArray(input)) {
+        issues.push({ path, code: "INVALID_TYPE", message: "limits must be an object." });
+        return;
+    }
+    const overrides = {};
+    let valid = true;
+    for (const [key, value] of Object.entries(input)) {
+        if (!LIMIT_KEYS.includes(key)) {
+            issues.push({ path: pointer(path, key), code: "UNKNOWN_KEY", message: `Unknown limit "${key}".` });
+            valid = false;
+            continue;
+        }
+        if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) {
+            issues.push({ path: pointer(path, key), code: "INVALID_VALUE", message: `${key} must be a positive integer.` });
+            valid = false;
+            continue;
+        }
+        overrides[key] = value;
+    }
+    if (!valid)
+        return;
+    const limits = resolveLimits(overrides);
+    const ordered = [
+        ["maxDataFrameBytes", "maxPendingBytesPerSubscription"],
+        ["maxPendingBytesPerSubscription", "maxPendingBytesPerConnection"],
+        ["maxPendingBytesPerConnection", "maxPendingBytesGateway"],
+        ["maxParamsBytes", "maxControlFrameBytes"]
+    ];
+    for (const [smaller, larger] of ordered) {
+        if (limits[smaller] > limits[larger]) {
+            issues.push({
+                path: pointer(path, smaller),
+                code: "INCONSISTENT_LIMITS",
+                message: `${smaller} (${limits[smaller]}) must not exceed ${larger} (${limits[larger]}).`
+            });
+        }
+    }
+    if (limits.maxControlFrameBytes < 1_024) {
+        issues.push({ path: pointer(path, "maxControlFrameBytes"), code: "INCONSISTENT_LIMITS", message: "maxControlFrameBytes must be at least 1024." });
+    }
+    if (limits.maxDataFrameBytes < 1_024) {
+        issues.push({ path: pointer(path, "maxDataFrameBytes"), code: "INCONSISTENT_LIMITS", message: "maxDataFrameBytes must be at least 1024." });
+    }
+}
+//# sourceMappingURL=limits.js.map

package/dist/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAqB,MAAM,CAAC,MAAM,CAAC;IAC5D,cAAc,EAAE,KAAK;IACrB,6BAA6B,EAAE,EAAE;IACjC,oBAAoB,EAAE,SAAS;IAC/B,iBAAiB,EAAE,MAAM;IACzB,cAAc,EAAE,KAAK;IACrB,+BAA+B,EAAE,GAAG;IACpC,8BAA8B,EAAE,SAAS;IACzC,4BAA4B,EAAE,SAAS;IACvC,sBAAsB,EAAE,UAAU;IAClC,aAAa,EAAE,GAAG;IAClB,sBAAsB,EAAE,EAAE;IAC1B,gBAAgB,EAAE,KAAK;IACvB,iBAAiB,EAAE,MAAM;IACzB,gBAAgB,EAAE,KAAK;IACvB,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,MAAM;IACvB,aAAa,EAAE,SAAS;IACxB,oBAAoB,EAAE,MAAM;IAC5B,wBAAwB,EAAE,EAAE;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAA8B,CAAC;AAEnF,MAAM,UAAU,aAAa,CAAC,SAAsC;IAClE,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,IAAY,EAAE,MAAqB;IAChF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;QAClF,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAoB,EAAE,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,CAAC;IACjB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,CAAE,UAAgC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,EAAE,CAAC,CAAC;YACnG,KAAK,GAAG,KAAK,CAAC;YACd,SAAS;QACX,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC5E,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,GAAG,8BAA8B,EAAE,CAAC,CAAC;YAChH,KAAK,GAAG,KAAK,CAAC;YACd,SAAS;QACX,CAAC;QACD,SAAS,CAAC,GAAmB,CAAC,GAAG,KAAK,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,OAAO,GAAmC;QAC9C,CAAC,mBAAmB,EAAE,gCAAgC,CAAC;QACvD,CAAC,gCAAgC,EAAE,8BAA8B,CAAC;QAClE,CAAC,8BAA8B,EAAE,wBAAwB,CAAC;QAC1D,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;KAC3C,CAAC;IACF,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;gBAC5B,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,GAAG,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,qBAAqB,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI;aAC1F,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,oBAAoB,GAAG,KAAK,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,sBAAsB,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC,CAAC;IACpJ,CAAC;IACD,IAAI,MAAM,CAAC,iBAAiB,GAAG,KAAK,EAAE,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC,CAAC;IAC9I,CAAC;AACH,CAAC"}

package/dist/primitives.d.ts

@@ -0,0 +1,29 @@
+import type { Json, Revision } from "./types.ts";
+export declare const MAX_NESTING_DEPTH = 16;
+export declare const IDENTIFIER_PATTERN: RegExp;
+export declare const REVISION_PATTERN: RegExp;
+export declare const UUID_PATTERN: RegExp;
+export declare function isIdentifier(value: unknown): value is string;
+export declare function isUuid(value: unknown): value is string;
+export declare function isRevision(value: unknown): value is Revision;
+/** Numeric comparison of canonical revisions without converting to number. */
+export declare function compareRevisions(a: Revision, b: Revision): -1 | 0 | 1;
+/** Parses a UTC RFC3339 timestamp; returns NaN when malformed. */
+export declare function parseUtcTimestamp(value: unknown): number;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/** UTF-8 byte length without allocating an encoded copy. */
+export declare function utf8ByteLength(text: string): number;
+export declare function codePointLength(text: string): number;
+/**
+ * Checks that a value is plain JSON data within the nesting limit: finite
+ * numbers, plain objects/arrays, no undefined or functions.
+ */
+export declare function isJsonValue(value: unknown, depth?: number): value is Json;
+/**
+ * Canonical JSON: sorted object keys, -0 normalized to 0, no whitespace.
+ * Throws on values that are not JSON data.
+ */
+export declare function canonicalJson(value: unknown): string;
+/** Pretty canonical JSON (sorted keys, two-space indent, trailing newline) for files. */
+export declare function canonicalJsonPretty(value: unknown): string;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,kBAAkB,QAAkC,CAAC;AAClE,eAAO,MAAM,gBAAgB,QAA6B,CAAC;AAC3D,eAAO,MAAM,YAAY,QAAoE,CAAC;AAG9F,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE5D;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEtD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAIrE;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGxD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9E;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWpD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,KAAK,IAAI,IAAI,CAOpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAsBD,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE1D"}

package/dist/primitives.js

@@ -0,0 +1,123 @@
+export const MAX_NESTING_DEPTH = 16;
+export const IDENTIFIER_PATTERN = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
+export const REVISION_PATTERN = /^(?:0|[1-9][0-9]{0,38})$/;
+export const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const RFC3339_UTC_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?Z$/;
+export function isIdentifier(value) {
+    return typeof value === "string" && IDENTIFIER_PATTERN.test(value);
+}
+export function isUuid(value) {
+    return typeof value === "string" && UUID_PATTERN.test(value);
+}
+export function isRevision(value) {
+    return typeof value === "string" && REVISION_PATTERN.test(value);
+}
+/** Numeric comparison of canonical revisions without converting to number. */
+export function compareRevisions(a, b) {
+    if (a.length !== b.length)
+        return a.length < b.length ? -1 : 1;
+    if (a === b)
+        return 0;
+    return a < b ? -1 : 1;
+}
+/** Parses a UTC RFC3339 timestamp; returns NaN when malformed. */
+export function parseUtcTimestamp(value) {
+    if (typeof value !== "string" || !RFC3339_UTC_PATTERN.test(value))
+        return Number.NaN;
+    return Date.parse(value);
+}
+export function isPlainObject(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/** UTF-8 byte length without allocating an encoded copy. */
+export function utf8ByteLength(text) {
+    let bytes = 0;
+    for (let i = 0; i < text.length; i++) {
+        const code = text.charCodeAt(i);
+        if (code < 0x80)
+            bytes += 1;
+        else if (code < 0x800)
+            bytes += 2;
+        else if (code >= 0xd800 && code <= 0xdbff && i + 1 < text.length) {
+            const next = text.charCodeAt(i + 1);
+            if (next >= 0xdc00 && next <= 0xdfff) {
+                bytes += 4;
+                i++;
+            }
+            else
+                bytes += 3;
+        }
+        else
+            bytes += 3;
+    }
+    return bytes;
+}
+export function codePointLength(text) {
+    let length = 0;
+    for (let i = 0; i < text.length; i++) {
+        const code = text.charCodeAt(i);
+        if (code >= 0xd800 && code <= 0xdbff && i + 1 < text.length) {
+            const next = text.charCodeAt(i + 1);
+            if (next >= 0xdc00 && next <= 0xdfff)
+                i++;
+        }
+        length++;
+    }
+    return length;
+}
+/**
+ * Checks that a value is plain JSON data within the nesting limit: finite
+ * numbers, plain objects/arrays, no undefined or functions.
+ */
+export function isJsonValue(value, depth = 1) {
+    if (depth > MAX_NESTING_DEPTH)
+        return false;
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number")
+        return Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.every(item => isJsonValue(item, depth + 1));
+    if (isPlainObject(value))
+        return Object.values(value).every(item => isJsonValue(item, depth + 1));
+    return false;
+}
+/**
+ * Canonical JSON: sorted object keys, -0 normalized to 0, no whitespace.
+ * Throws on values that are not JSON data.
+ */
+export function canonicalJson(value) {
+    return JSON.stringify(canonicalize(value, 1));
+}
+function canonicalize(value, depth) {
+    if (depth > MAX_NESTING_DEPTH)
+        throw new TypeError("Value exceeds the maximum nesting depth");
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new TypeError("Non-finite numbers are not JSON data");
+        return Object.is(value, -0) ? 0 : value;
+    }
+    if (Array.isArray(value))
+        return value.map(item => canonicalize(item, depth + 1));
+    if (isPlainObject(value)) {
+        const sorted = {};
+        for (const key of Object.keys(value).sort()) {
+            const item = value[key];
+            if (item === undefined)
+                continue;
+            Object.defineProperty(sorted, key, { value: canonicalize(item, depth + 1), enumerable: true, writable: true, configurable: true });
+        }
+        return sorted;
+    }
+    throw new TypeError("Value is not JSON data");
+}
+/** Pretty canonical JSON (sorted keys, two-space indent, trailing newline) for files. */
+export function canonicalJsonPretty(value) {
+    return `${JSON.stringify(JSON.parse(canonicalJson(value)), null, 2)}\n`;
+}
+//# sourceMappingURL=primitives.js.map

package/dist/primitives.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,32 @@
+import type { Capabilities } from "./types.ts";
+export declare const PROTOCOL_VERSION: 1;
+export declare const DEFAULT_SOCKET_PATH = "/streamotter/socket.io";
+export declare const DEFAULT_GATEWAY_PORT = 7400;
+export declare const DEFAULT_MANAGEMENT_PORT = 7401;
+export declare const CAPABILITIES: Capabilities;
+export declare const EVENTS: Readonly<{
+    readonly hello: "so:hello";
+    readonly state: "so:state";
+    readonly data: "so:data";
+    readonly error: "so:error";
+    readonly subscribe: "so:subscribe";
+    readonly unsubscribe: "so:unsubscribe";
+    readonly resync: "so:resync";
+    readonly receipt: "so:receipt";
+}>;
+/** Protocol timings fixed by the V1 specification. */
+export declare const HELLO_TIMEOUT_MS = 10000;
+export declare const CONTROL_CALLBACK_TIMEOUT_MS = 5000;
+export declare const UNSUBSCRIBE_TIMEOUT_MS = 5000;
+export declare const GET_TOKEN_TIMEOUT_MS = 10000;
+export declare const DEFAULT_READY_TIMEOUT_MS = 30000;
+export declare const TOKEN_REFRESH_LEAD_MS = 30000;
+export declare const RECONNECT_BASE_MS = 500;
+export declare const RECONNECT_CAP_MS = 30000;
+export declare const MAX_TOKEN_BYTES = 8192;
+export declare const REQUEST_CACHE_ENTRIES = 256;
+export declare const REQUEST_CACHE_TTL_MS = 60000;
+export declare const STARTUP_DEADLINE_MS = 30000;
+export declare const DEFAULT_STOP_TIMEOUT_MS = 10000;
+export declare const PREVIEW_TOKEN_TTL_MS: number;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAC3C,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAC5D,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,eAAO,MAAM,YAAY,EAAE,YAMzB,CAAC;AAEH,eAAO,MAAM,MAAM;;;;;;;;;EASR,CAAC;AAEZ,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,QAAS,CAAC;AACvC,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AACjD,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAC5C,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAC5C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,gBAAgB,QAAS,CAAC;AACvC,eAAO,MAAM,eAAe,OAAQ,CAAC;AACrC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAC1C,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAC9C,eAAO,MAAM,oBAAoB,QAAa,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,37 @@
+export const PROTOCOL_VERSION = 1;
+export const DEFAULT_SOCKET_PATH = "/streamotter/socket.io";
+export const DEFAULT_GATEWAY_PORT = 7400;
+export const DEFAULT_MANAGEMENT_PORT = 7401;
+export const CAPABILITIES = Object.freeze({
+    protocolVersion: PROTOCOL_VERSION,
+    configVersions: Object.freeze([1]),
+    transport: "socket.io",
+    deliveryModes: Object.freeze(["state"]),
+    operations: Object.freeze(["subscribe", "unsubscribe", "resync", "receipt"])
+});
+export const EVENTS = Object.freeze({
+    hello: "so:hello",
+    state: "so:state",
+    data: "so:data",
+    error: "so:error",
+    subscribe: "so:subscribe",
+    unsubscribe: "so:unsubscribe",
+    resync: "so:resync",
+    receipt: "so:receipt"
+});
+/** Protocol timings fixed by the V1 specification. */
+export const HELLO_TIMEOUT_MS = 10_000;
+export const CONTROL_CALLBACK_TIMEOUT_MS = 5_000;
+export const UNSUBSCRIBE_TIMEOUT_MS = 5_000;
+export const GET_TOKEN_TIMEOUT_MS = 10_000;
+export const DEFAULT_READY_TIMEOUT_MS = 30_000;
+export const TOKEN_REFRESH_LEAD_MS = 30_000;
+export const RECONNECT_BASE_MS = 500;
+export const RECONNECT_CAP_MS = 30_000;
+export const MAX_TOKEN_BYTES = 8_192;
+export const REQUEST_CACHE_ENTRIES = 256;
+export const REQUEST_CACHE_TTL_MS = 60_000;
+export const STARTUP_DEADLINE_MS = 30_000;
+export const DEFAULT_STOP_TIMEOUT_MS = 10_000;
+export const PREVIEW_TOKEN_TTL_MS = 5 * 60_000;
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,MAAM,CAAC,MAAM,YAAY,GAAiB,MAAM,CAAC,MAAM,CAAC;IACtD,eAAe,EAAE,gBAAgB;IACjC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAU,CAAC;IAC3C,SAAS,EAAE,WAAW;IACtB,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAU,CAAC;IAChD,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;CACtF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,SAAS,EAAE,cAAc;IACzB,WAAW,EAAE,gBAAgB;IAC7B,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;CACb,CAAC,CAAC;AAEZ,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AACvC,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,CAAC;AACjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAC5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAC1C,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAG,MAAM,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,34 @@
+import type { ConfigIssue, Json, Params, Schema } from "./types.ts";
+/** JSON-Pointer path segment escaping. */
+export declare function pointer(base: string, segment: string | number): string;
+/**
+ * Validates a schema definition against the V1 dialect. Unsupported keywords are
+ * rejected rather than ignored. Returns true when no issues were added.
+ */
+export declare function validateSchemaDefinition(schema: unknown, path: string, issues: ConfigIssue[], depth?: number): schema is Schema;
+/**
+ * Parameter schemas are closed objects whose properties are all required and
+ * are strings, booleans, or integers. Call after validateSchemaDefinition.
+ */
+export declare function validateParamsSchema(schema: Schema, path: string, issues: ConfigIssue[]): boolean;
+export interface ValueIssue {
+    path: string;
+    message: string;
+}
+/** Validates a value against a schema. Returns the first issue, or null when valid. */
+export declare function validateValue(schema: Schema, value: unknown, path?: string, depth?: number): ValueIssue | null;
+export type CanonicalParamsResult = {
+    ok: true;
+    params: Params;
+    canonical: string;
+} | {
+    ok: false;
+    issue: ValueIssue;
+};
+/**
+ * Validates parameters and produces their canonical encoding: -0 normalized to 0,
+ * keys sorted, JSON encoded. String case and Unicode are not normalized.
+ */
+export declare function canonicalizeParams(schema: Schema, params: unknown): CanonicalParamsResult;
+export declare function isJsonData(value: unknown): value is Json;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAYpE,0CAA0C;AAC1C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEtE;AAMD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,SAAI,GAAG,MAAM,IAAI,MAAM,CA6G1H;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CA0BjG;AAED,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAE7D,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,SAAM,EAAE,KAAK,SAAI,GAAG,UAAU,GAAG,IAAI,CAkDtG;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAErC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,qBAAqB,CAazF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAOxD"}

package/dist/schema.js

@@ -0,0 +1,267 @@
+import { canonicalJson, codePointLength, isPlainObject, MAX_NESTING_DEPTH } from "./primitives.js";
+const KEYWORDS = {
+    string: ["type", "minLength", "maxLength", "enum"],
+    number: ["type", "minimum", "maximum"],
+    integer: ["type", "minimum", "maximum"],
+    boolean: ["type"],
+    null: ["type"],
+    array: ["type", "items", "maxItems"],
+    object: ["type", "properties", "required", "additionalProperties"]
+};
+/** JSON-Pointer path segment escaping. */
+export function pointer(base, segment) {
+    return `${base}/${String(segment).replaceAll("~", "~0").replaceAll("/", "~1")}`;
+}
+function isNonNegativeSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+/**
+ * Validates a schema definition against the V1 dialect. Unsupported keywords are
+ * rejected rather than ignored. Returns true when no issues were added.
+ */
+export function validateSchemaDefinition(schema, path, issues, depth = 1) {
+    const before = issues.length;
+    if (depth > MAX_NESTING_DEPTH) {
+        issues.push({ path, code: "SCHEMA_DEPTH_EXCEEDED", message: `Schemas may nest at most ${MAX_NESTING_DEPTH} levels.` });
+        return false;
+    }
+    if (!isPlainObject(schema)) {
+        issues.push({ path, code: "INVALID_TYPE", message: "A schema must be an object." });
+        return false;
+    }
+    const type = schema["type"];
+    if (typeof type !== "string" || !Object.hasOwn(KEYWORDS, type)) {
+        issues.push({
+            path: pointer(path, "type"),
+            code: "SCHEMA_UNSUPPORTED_TYPE",
+            message: "type must be one of string, number, integer, boolean, null, array, or object (unions are not supported in V1)."
+        });
+        return false;
+    }
+    const allowed = KEYWORDS[type] ?? [];
+    for (const key of Object.keys(schema)) {
+        if (!allowed.includes(key)) {
+            issues.push({
+                path: pointer(path, key),
+                code: "SCHEMA_UNSUPPORTED_KEYWORD",
+                message: `"${key}" is not supported for ${type} schemas in V1.`
+            });
+        }
+    }
+    switch (type) {
+        case "string": {
+            const { minLength, maxLength } = schema;
+            if (minLength !== undefined && !isNonNegativeSafeInteger(minLength)) {
+                issues.push({ path: pointer(path, "minLength"), code: "INVALID_VALUE", message: "minLength must be a non-negative integer." });
+            }
+            if (maxLength !== undefined && !isNonNegativeSafeInteger(maxLength)) {
+                issues.push({ path: pointer(path, "maxLength"), code: "INVALID_VALUE", message: "maxLength must be a non-negative integer." });
+            }
+            if (isNonNegativeSafeInteger(minLength) && isNonNegativeSafeInteger(maxLength) && minLength > maxLength) {
+                issues.push({ path: pointer(path, "minLength"), code: "INVALID_VALUE", message: "minLength must not exceed maxLength." });
+            }
+            const values = schema["enum"];
+            if (values !== undefined) {
+                if (!Array.isArray(values) || values.length === 0 || !values.every(item => typeof item === "string")) {
+                    issues.push({ path: pointer(path, "enum"), code: "INVALID_VALUE", message: "enum must be a non-empty array of strings." });
+                }
+                else if (new Set(values).size !== values.length) {
+                    issues.push({ path: pointer(path, "enum"), code: "INVALID_VALUE", message: "enum values must be unique." });
+                }
+            }
+            break;
+        }
+        case "number":
+        case "integer": {
+            const { minimum, maximum } = schema;
+            for (const [key, bound] of [["minimum", minimum], ["maximum", maximum]]) {
+                if (bound === undefined)
+                    continue;
+                if (typeof bound !== "number" || !Number.isFinite(bound) || (type === "integer" && !Number.isSafeInteger(bound))) {
+                    issues.push({ path: pointer(path, key), code: "INVALID_VALUE", message: `${key} must be a finite ${type === "integer" ? "safe integer" : "number"}.` });
+                }
+            }
+            if (typeof minimum === "number" && typeof maximum === "number" && minimum > maximum) {
+                issues.push({ path: pointer(path, "minimum"), code: "INVALID_VALUE", message: "minimum must not exceed maximum." });
+            }
+            break;
+        }
+        case "array": {
+            if (!isNonNegativeSafeInteger(schema["maxItems"])) {
+                issues.push({ path: pointer(path, "maxItems"), code: "REQUIRED", message: "Arrays require a non-negative integer maxItems bound." });
+            }
+            if (schema["items"] === undefined) {
+                issues.push({ path: pointer(path, "items"), code: "REQUIRED", message: "Arrays require an items schema." });
+            }
+            else {
+                validateSchemaDefinition(schema["items"], pointer(path, "items"), issues, depth + 1);
+            }
+            break;
+        }
+        case "object": {
+            if (schema["additionalProperties"] !== false) {
+                issues.push({ path: pointer(path, "additionalProperties"), code: "REQUIRED", message: "Objects must declare additionalProperties: false." });
+            }
+            const properties = schema["properties"];
+            if (!isPlainObject(properties)) {
+                issues.push({ path: pointer(path, "properties"), code: "REQUIRED", message: "Objects require a properties map." });
+            }
+            else {
+                for (const [name, child] of Object.entries(properties)) {
+                    validateSchemaDefinition(child, pointer(pointer(path, "properties"), name), issues, depth + 1);
+                }
+            }
+            const required = schema["required"];
+            if (!Array.isArray(required) || !required.every(item => typeof item === "string")) {
+                issues.push({ path: pointer(path, "required"), code: "REQUIRED", message: "Objects require a required array of property names." });
+            }
+            else {
+                if (new Set(required).size !== required.length) {
+                    issues.push({ path: pointer(path, "required"), code: "INVALID_VALUE", message: "required names must be unique." });
+                }
+                if (isPlainObject(properties)) {
+                    for (const name of required) {
+                        if (!Object.hasOwn(properties, name)) {
+                            issues.push({ path: pointer(path, "required"), code: "UNKNOWN_REFERENCE", message: `required property "${name}" is not declared in properties.` });
+                        }
+                    }
+                }
+            }
+            break;
+        }
+        default:
+            break;
+    }
+    return issues.length === before;
+}
+/**
+ * Parameter schemas are closed objects whose properties are all required and
+ * are strings, booleans, or integers. Call after validateSchemaDefinition.
+ */
+export function validateParamsSchema(schema, path, issues) {
+    const before = issues.length;
+    if (schema.type !== "object") {
+        issues.push({ path, code: "INVALID_PARAMS_SCHEMA", message: "Parameter schemas must be objects." });
+        return false;
+    }
+    const names = Object.keys(schema.properties);
+    for (const name of names) {
+        const child = schema.properties[name];
+        if (child === undefined)
+            continue;
+        if (child.type !== "string" && child.type !== "boolean" && child.type !== "integer") {
+            issues.push({
+                path: pointer(pointer(path, "properties"), name),
+                code: "INVALID_PARAMS_SCHEMA",
+                message: "Parameters may only be strings, booleans, or integers in V1."
+            });
+        }
+        if (!schema.required.includes(name)) {
+            issues.push({
+                path: pointer(pointer(path, "properties"), name),
+                code: "INVALID_PARAMS_SCHEMA",
+                message: "Every parameter must be required; optional parameters are not supported in V1."
+            });
+        }
+    }
+    return issues.length === before;
+}
+/** Validates a value against a schema. Returns the first issue, or null when valid. */
+export function validateValue(schema, value, path = "$", depth = 1) {
+    if (depth > MAX_NESTING_DEPTH)
+        return { path, message: `Values may nest at most ${MAX_NESTING_DEPTH} levels.` };
+    switch (schema.type) {
+        case "string": {
+            if (typeof value !== "string")
+                return { path, message: "Expected a string." };
+            if (schema.enum !== undefined && !schema.enum.includes(value))
+                return { path, message: "Value is not one of the allowed strings." };
+            const length = (schema.minLength !== undefined || schema.maxLength !== undefined) ? codePointLength(value) : 0;
+            if (schema.minLength !== undefined && length < schema.minLength)
+                return { path, message: `Expected at least ${schema.minLength} characters.` };
+            if (schema.maxLength !== undefined && length > schema.maxLength)
+                return { path, message: `Expected at most ${schema.maxLength} characters.` };
+            return null;
+        }
+        case "number":
+        case "integer": {
+            if (typeof value !== "number" || !Number.isFinite(value))
+                return { path, message: "Expected a finite number." };
+            if (schema.type === "integer" && !Number.isSafeInteger(value))
+                return { path, message: "Expected a safe integer." };
+            if (schema.minimum !== undefined && value < schema.minimum)
+                return { path, message: `Expected a value of at least ${schema.minimum}.` };
+            if (schema.maximum !== undefined && value > schema.maximum)
+                return { path, message: `Expected a value of at most ${schema.maximum}.` };
+            return null;
+        }
+        case "boolean":
+            return typeof value === "boolean" ? null : { path, message: "Expected a boolean." };
+        case "null":
+            return value === null ? null : { path, message: "Expected null." };
+        case "array": {
+            if (!Array.isArray(value))
+                return { path, message: "Expected an array." };
+            if (value.length > schema.maxItems)
+                return { path, message: `Expected at most ${schema.maxItems} items.` };
+            for (let i = 0; i < value.length; i++) {
+                const issue = validateValue(schema.items, value[i], `${path}[${i}]`, depth + 1);
+                if (issue !== null)
+                    return issue;
+            }
+            return null;
+        }
+        case "object": {
+            if (!isPlainObject(value))
+                return { path, message: "Expected an object." };
+            for (const key of Object.keys(value)) {
+                if (!Object.hasOwn(schema.properties, key))
+                    return { path: `${path}.${key}`, message: "Property is not allowed." };
+            }
+            for (const key of schema.required) {
+                if (!Object.hasOwn(value, key))
+                    return { path: `${path}.${key}`, message: "Required property is missing." };
+            }
+            for (const [key, child] of Object.entries(schema.properties)) {
+                if (!Object.hasOwn(value, key))
+                    continue;
+                const issue = validateValue(child, value[key], `${path}.${key}`, depth + 1);
+                if (issue !== null)
+                    return issue;
+            }
+            return null;
+        }
+        default:
+            return { path, message: "Unsupported schema." };
+    }
+}
+/**
+ * Validates parameters and produces their canonical encoding: -0 normalized to 0,
+ * keys sorted, JSON encoded. String case and Unicode are not normalized.
+ */
+export function canonicalizeParams(schema, params) {
+    const issue = validateValue(schema, params);
+    if (issue !== null)
+        return { ok: false, issue };
+    const normalized = {};
+    for (const key of Object.keys(params).sort()) {
+        const value = params[key];
+        if (value === undefined)
+            continue;
+        Object.defineProperty(normalized, key, {
+            value: typeof value === "number" && Object.is(value, -0) ? 0 : value,
+            enumerable: true, writable: true, configurable: true
+        });
+    }
+    return { ok: true, params: normalized, canonical: canonicalJson(normalized) };
+}
+export function isJsonData(value) {
+    try {
+        canonicalJson(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=schema.js.map