@beignet/core 0.0.48 → 0.0.50

package/dist/contracts/query-transport.d.ts.map

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

package/dist/contracts/query-transport.js

@@ -0,0 +1,406 @@
+const QUERY_EXTENSION_PREFIX = "~beignet-query:v1:";
+const EMPTY_ARRAY_EXTENSION = `${QUERY_EXTENSION_PREFIX}{"kind":"empty-preserving","value":[]}`;
+const EMPTY_OBJECT_EXTENSION = `${QUERY_EXTENSION_PREFIX}{"kind":"empty-preserving","value":{}}`;
+const DATE_TIME_PATTERN = /^(\d{4})-(\d{2})-(\d{2})[Tt](\d{2}):(\d{2}):(\d{2})(?:\.\d+)?([Zz]|([+-])(\d{2}):(\d{2}))$/;
+const NUMBER_PATTERN = /^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/;
+const UNSAFE_QUERY_NAMES = new Set(["__proto__", "constructor", "prototype"]);
+/** Raised when an HTTP query cannot be encoded or decoded as declared. */
+export class QueryTransportError extends Error {
+    issues;
+    constructor(issue) {
+        super(issue.message);
+        this.name = "QueryTransportError";
+        this.issues = [issue];
+    }
+}
+/** Built-in, OpenAPI-inspectable query parameter transports. */
+export const query = {
+    string() {
+        return Object.freeze({ kind: "string" });
+    },
+    number() {
+        return Object.freeze({ kind: "number" });
+    },
+    integer() {
+        return Object.freeze({ kind: "integer" });
+    },
+    boolean() {
+        return Object.freeze({ kind: "boolean" });
+    },
+    dateTime() {
+        return Object.freeze({ kind: "date-time" });
+    },
+    date() {
+        return Object.freeze({ kind: "date" });
+    },
+    array(item, options = {}) {
+        return Object.freeze({
+            kind: "array",
+            item,
+            empty: options.empty ?? "omit",
+        });
+    },
+    deepObject(fields, options = {}) {
+        assertFieldNames(fields, "deepObject");
+        return Object.freeze({
+            kind: "deep-object",
+            fields: copyFields(fields),
+            empty: options.empty ?? "omit",
+        });
+    },
+};
+/** Define a reusable deterministic query transport. */
+export function defineQueryTransport(fields) {
+    assertFieldNames(fields, "query");
+    return Object.freeze({
+        kind: "query-transport",
+        fields: copyFields(fields),
+    });
+}
+function copyFields(fields) {
+    return Object.freeze({ ...fields });
+}
+function assertFieldNames(fields, location) {
+    for (const name of Object.keys(fields)) {
+        if (name.length === 0 ||
+            name.includes("[") ||
+            name.includes("]") ||
+            UNSAFE_QUERY_NAMES.has(name)) {
+            throw new Error(`Invalid ${location} transport field "${name}". Query transport field names must be non-empty, must not contain brackets, and must not use prototype-related names.`);
+        }
+    }
+}
+function queryRecord() {
+    return Object.create(null);
+}
+function issue(path, message) {
+    throw new QueryTransportError({ path, message });
+}
+function isLeapYear(year) {
+    return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+}
+function daysInMonth(year, month) {
+    if (month === 2)
+        return isLeapYear(year) ? 29 : 28;
+    return [4, 6, 9, 11].includes(month) ? 30 : 31;
+}
+function isDateTime(value) {
+    const match = DATE_TIME_PATTERN.exec(value);
+    if (!match)
+        return false;
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const hour = Number(match[4]);
+    const minute = Number(match[5]);
+    const second = Number(match[6]);
+    const offsetHour = match[9] === undefined ? 0 : Number(match[9]);
+    const offsetMinute = match[10] === undefined ? 0 : Number(match[10]);
+    const componentsAreValid = month >= 1 &&
+        month <= 12 &&
+        day >= 1 &&
+        day <= daysInMonth(year, month) &&
+        hour <= 23 &&
+        minute <= 59 &&
+        second <= 60 &&
+        offsetHour <= 23 &&
+        offsetMinute <= 59;
+    if (!componentsAreValid)
+        return false;
+    if (second < 60)
+        return Number.isFinite(Date.parse(value));
+    const precedingSecond = value.replace(/^(\d{4}-\d{2}-\d{2}[Tt]\d{2}:\d{2}:)60/, (_match, prefix) => `${prefix}59`);
+    const parsed = Date.parse(precedingSecond);
+    if (!Number.isFinite(parsed))
+        return false;
+    const utc = new Date(parsed);
+    return (utc.getUTCHours() === 23 &&
+        utc.getUTCMinutes() === 59 &&
+        utc.getUTCSeconds() === 59 &&
+        ((utc.getUTCMonth() === 5 && utc.getUTCDate() === 30) ||
+            (utc.getUTCMonth() === 11 && utc.getUTCDate() === 31)));
+}
+function decodeScalar(transport, value, path) {
+    switch (transport.kind) {
+        case "string":
+            return value;
+        case "number": {
+            if (!NUMBER_PATTERN.test(value)) {
+                return issue(path, "Expected a finite number query value.");
+            }
+            const decoded = Number(value);
+            return Number.isFinite(decoded)
+                ? decoded
+                : issue(path, "Expected a finite number query value.");
+        }
+        case "integer": {
+            if (!NUMBER_PATTERN.test(value)) {
+                return issue(path, "Expected an integer query value.");
+            }
+            const decoded = Number(value);
+            return Number.isSafeInteger(decoded)
+                ? decoded
+                : issue(path, "Expected a safe integer query value.");
+        }
+        case "boolean":
+            if (value === "true")
+                return true;
+            if (value === "false")
+                return false;
+            return issue(path, 'Expected a boolean query value ("true" or "false").');
+        case "date-time":
+            return isDateTime(value)
+                ? value
+                : issue(path, "Expected an RFC 3339 date-time query value.");
+        case "date": {
+            if (!isDateTime(value)) {
+                return issue(path, "Expected an RFC 3339 date-time query value.");
+            }
+            const decoded = new Date(value);
+            return Number.isFinite(decoded.getTime())
+                ? decoded
+                : issue(path, "Expected an RFC 3339 date-time representable by JavaScript Date.");
+        }
+    }
+}
+function encodeScalar(transport, value, path) {
+    switch (transport.kind) {
+        case "string":
+            return typeof value === "string"
+                ? value
+                : issue(path, "Expected a string query value.");
+        case "number":
+            return typeof value === "number" && Number.isFinite(value)
+                ? String(value)
+                : issue(path, "Expected a finite number query value.");
+        case "integer":
+            return typeof value === "number" && Number.isSafeInteger(value)
+                ? String(value)
+                : issue(path, "Expected a safe integer query value.");
+        case "boolean":
+            return typeof value === "boolean"
+                ? String(value)
+                : issue(path, "Expected a boolean query value.");
+        case "date-time":
+            return typeof value === "string" && isDateTime(value)
+                ? value
+                : issue(path, "Expected an RFC 3339 date-time query value.");
+        case "date":
+            return value instanceof Date && Number.isFinite(value.getTime())
+                ? value.toISOString()
+                : issue(path, "Expected a valid Date query value.");
+    }
+}
+function oneValue(values, path) {
+    if (values.length !== 1) {
+        return issue(path, "Expected exactly one query value.");
+    }
+    return values[0];
+}
+function rawQuery(searchParams) {
+    const result = queryRecord();
+    for (const name of new Set(searchParams.keys())) {
+        const values = searchParams.getAll(name);
+        result[name] = values.length === 1 ? values[0] : values;
+    }
+    return result;
+}
+function encodeArrayItem(field, value, path) {
+    const encoded = encodeScalar(field.item, value, path);
+    if (field.empty === "preserve" &&
+        field.item.kind === "string" &&
+        encoded.startsWith(QUERY_EXTENSION_PREFIX)) {
+        return `${QUERY_EXTENSION_PREFIX}${JSON.stringify({
+            kind: "literal",
+            value: encoded,
+        })}`;
+    }
+    return encoded;
+}
+function decodeArrayItem(field, value, path) {
+    if (field.empty === "preserve" &&
+        field.item.kind === "string" &&
+        value.startsWith(QUERY_EXTENSION_PREFIX)) {
+        try {
+            const extension = JSON.parse(value.slice(QUERY_EXTENSION_PREFIX.length));
+            if (extension &&
+                typeof extension === "object" &&
+                "kind" in extension &&
+                extension.kind === "literal" &&
+                "value" in extension &&
+                typeof extension.value === "string") {
+                return extension.value;
+            }
+        }
+        catch {
+            // Unknown extension-looking strings remain ordinary string values.
+        }
+    }
+    return decodeScalar(field.item, value, path);
+}
+/** Decode URL query values exactly once according to a contract transport. */
+export function decodeQueryTransport(transport, searchParams) {
+    const decoded = rawQuery(searchParams);
+    for (const [name, field] of Object.entries(transport.fields)) {
+        const values = searchParams.getAll(name);
+        if (field.kind === "deep-object") {
+            const direct = values.length > 0;
+            const prefix = `${name}[`;
+            const nestedNames = [...new Set(searchParams.keys())].filter((key) => key.startsWith(prefix));
+            if (direct && nestedNames.length > 0) {
+                issue([name], "Query parameter conflicts with its deepObject fields.");
+            }
+            if (direct) {
+                if (field.empty === "preserve" &&
+                    values.length === 1 &&
+                    values[0] === EMPTY_OBJECT_EXTENSION) {
+                    decoded[name] = {};
+                    continue;
+                }
+                issue([name], "Expected a deepObject query parameter.");
+            }
+            if (nestedNames.length === 0)
+                continue;
+            const object = queryRecord();
+            for (const nestedName of nestedNames) {
+                const suffix = nestedName.slice(prefix.length);
+                if (!suffix.endsWith("]") || suffix.slice(0, -1).includes("[")) {
+                    issue([name], "Expected a flat deepObject query parameter.");
+                }
+                const childName = suffix.slice(0, -1);
+                const child = field.fields[childName];
+                if (!child) {
+                    issue([name, childName], "Query transport does not declare this deepObject field.");
+                }
+                object[childName] = decodeScalar(child, oneValue(searchParams.getAll(nestedName), [name, childName]), [name, childName]);
+                delete decoded[nestedName];
+            }
+            decoded[name] = object;
+            continue;
+        }
+        if (values.length === 0)
+            continue;
+        if (field.kind === "array") {
+            if (field.empty === "preserve" &&
+                values.length === 1 &&
+                values[0] === EMPTY_ARRAY_EXTENSION) {
+                decoded[name] = [];
+            }
+            else {
+                decoded[name] = values.map((value, index) => decodeArrayItem(field, value, [name, index]));
+            }
+            continue;
+        }
+        decoded[name] = decodeScalar(field, oneValue(values, [name]), [name]);
+    }
+    return Object.fromEntries(Object.entries(decoded));
+}
+function isPlainObject(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+/** Encode typed query input according to the same contract transport. */
+export function encodeQueryTransport(transport, value) {
+    if (!isPlainObject(value)) {
+        issue([], "Expected query input to be an object.");
+    }
+    const params = new URLSearchParams();
+    for (const name of Object.keys(value)) {
+        if (value[name] !== undefined && !transport.fields[name]) {
+            issue([name], "Query transport does not declare this field.");
+        }
+    }
+    for (const [name, field] of Object.entries(transport.fields)) {
+        const fieldValue = value[name];
+        if (fieldValue === undefined)
+            continue;
+        if (fieldValue === null) {
+            issue([name], "Null query values are not representable; omit the parameter instead.");
+        }
+        if (field.kind === "array") {
+            if (!Array.isArray(fieldValue)) {
+                issue([name], "Expected an array query value.");
+            }
+            if (fieldValue.length === 0) {
+                if (field.empty === "preserve") {
+                    params.append(name, EMPTY_ARRAY_EXTENSION);
+                }
+                continue;
+            }
+            fieldValue.forEach((entry, index) => {
+                params.append(name, encodeArrayItem(field, entry, [name, index]));
+            });
+            continue;
+        }
+        if (field.kind === "deep-object") {
+            if (!isPlainObject(fieldValue)) {
+                issue([name], "Expected an object query value.");
+            }
+            for (const childName of Object.keys(fieldValue)) {
+                if (fieldValue[childName] !== undefined && !field.fields[childName]) {
+                    issue([name, childName], "Query transport does not declare this deepObject field.");
+                }
+            }
+            const entries = Object.entries(fieldValue).filter(([, entry]) => entry !== undefined);
+            if (entries.length === 0) {
+                if (field.empty === "preserve") {
+                    params.append(name, EMPTY_OBJECT_EXTENSION);
+                }
+                continue;
+            }
+            for (const [childName, entry] of entries) {
+                const child = field.fields[childName];
+                if (!child)
+                    continue;
+                params.append(`${name}[${childName}]`, encodeScalar(child, entry, [name, childName]));
+            }
+            continue;
+        }
+        params.append(name, encodeScalar(field, fieldValue, [name]));
+    }
+    return params;
+}
+/** OpenAPI schema keywords implied by a query field transport. */
+export function queryTransportSchema(field) {
+    switch (field.kind) {
+        case "string":
+            return { type: "string" };
+        case "number":
+            return { type: "number" };
+        case "integer":
+            return {
+                type: "integer",
+                minimum: Number.MIN_SAFE_INTEGER,
+                maximum: Number.MAX_SAFE_INTEGER,
+            };
+        case "boolean":
+            return { type: "boolean" };
+        case "date-time":
+        case "date":
+            return { type: "string", format: "date-time" };
+        case "array":
+            return {
+                type: "array",
+                items: queryTransportSchema(field.item),
+                ...(field.empty === "preserve"
+                    ? { "x-beignet-empty-query": "v1" }
+                    : {}),
+            };
+        case "deep-object":
+            return {
+                type: "object",
+                properties: Object.fromEntries(Object.entries(field.fields).map(([name, child]) => [
+                    name,
+                    queryTransportSchema(child),
+                ])),
+                additionalProperties: false,
+                ...(field.empty === "preserve"
+                    ? { "x-beignet-empty-query": "v1" }
+                    : {}),
+            };
+    }
+}
+//# sourceMappingURL=query-transport.js.map

package/dist/contracts/query-transport.js.map

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

package/dist/contracts/schema-shape.d.ts

@@ -34,4 +34,15 @@ export declare function formatPathParamsMismatch(args: {
     missingKeys: readonly string[];
     extraKeys: readonly string[];
 }): string;
+/** Compare an introspected query schema's fields with its transport fields. */
+export declare function compareQueryTransportFields(args: {
+    schemaKeys: readonly string[];
+    transportKeys: readonly string[];
+}): boolean;
+/** Format a query schema/transport mismatch consistently across consumers. */
+export declare function formatQueryTransportMismatch(args: {
+    contractName: string;
+    schemaKeys: readonly string[];
+    transportKeys: readonly string[];
+}): string;
 //# sourceMappingURL=schema-shape.d.ts.map

package/dist/contracts/schema-shape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-shape.d.ts","sourceRoot":"","sources":["../../src/contracts/schema-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAkBrC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,GAAG;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAQjD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,GAAG,MAAM,CAWT"}
+{"version":3,"file":"schema-shape.d.ts","sourceRoot":"","sources":["../../src/contracts/schema-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAkBrC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,GAAG;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAQjD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,GAAG,MAAM,CAWT;AAED,+EAA+E;AAC/E,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,GAAG,OAAO,CAOV;AAED,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,GAAG,MAAM,CAIT"}

package/dist/contracts/schema-shape.js

@@ -58,4 +58,17 @@ export function formatPathParamsMismatch(args) {
         .filter(Boolean)
         .join("; ");
 }
+/** Compare an introspected query schema's fields with its transport fields. */
+export function compareQueryTransportFields(args) {
+    const schemaKeys = [...args.schemaKeys].sort();
+    const transportKeys = [...args.transportKeys].sort();
+    return (schemaKeys.length === transportKeys.length &&
+        schemaKeys.every((key, index) => key === transportKeys[index]));
+}
+/** Format a query schema/transport mismatch consistently across consumers. */
+export function formatQueryTransportMismatch(args) {
+    const schemaKeys = [...args.schemaKeys].sort();
+    const transportKeys = [...args.transportKeys].sort();
+    return `Query transport fields for contract "${args.contractName}" must match its query schema fields (schema: ${schemaKeys.join(", ") || "none"}; transport: ${transportKeys.join(", ") || "none"}).`;
+}
 //# sourceMappingURL=schema-shape.js.map

package/dist/contracts/schema-shape.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-shape.js","sourceRoot":"","sources":["../../src/contracts/schema-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAe;IAEf,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAE5D,MAAM,SAAS,GAAI,MAAkC,EAAE,IAAI,CAAC;IAC5D,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAElE,IAAI,CAAC,CAAC,OAAO,IAAI,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAE9C,IAAI,KAAc,CAAC;IACnB,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC1C,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;SAAM,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/C,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAE1D,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAG3C;IACC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CACtC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CACvC,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CACrC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CACtC,CAAC;IACF,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAGxC;IACC,OAAO;QACL,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;YACzB,CAAC,CAAC,4BAA4B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC3D,CAAC,CAAC,SAAS;QACb,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;YACvB,CAAC,CAAC,0BAA0B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACvD,CAAC,CAAC,SAAS;KACd;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}
+{"version":3,"file":"schema-shape.js","sourceRoot":"","sources":["../../src/contracts/schema-shape.ts"],"names":[],"mappings":"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"}

package/dist/contracts/types.d.ts

@@ -2,6 +2,7 @@ import type { StandardSchemaV1 } from "@standard-schema/spec";
 import type { IdempotencyMeta } from "../idempotency/index.js";
 import type { ContractDeprecationMeta } from "./lifecycle.js";
 import type { OpenAPIOperationMeta } from "./openapi-meta.js";
+import type { QueryTransport } from "./query-transport.js";
 import type { RateLimitMeta } from "./rate-limit.js";
 /**
  * Any Standard Schema compatible validator.
@@ -207,6 +208,10 @@ export type HttpContractConfig<TMethod extends HttpMethod = HttpMethod, TPathPar
      * Query parameter schema.
      */
     query: TQuery;
+    /**
+     * Deterministic HTTP encoding for the query schema.
+     */
+    queryTransport: QueryTransport | null;
     /**
      * Request header schema or schemas.
      */

package/dist/contracts/types.d.ts.map

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

package/dist/contracts/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/contracts/types.ts"],"names":[],"mappings":"AAkGA;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAuB,CAAC;AA6DlE;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM;IACN,KAAK;IACL,OAAO;CACqC,CAAC;AAE/C;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAkB;IAElB,OAAQ,iBAA2C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAgC;IACzE,WAAW,EAAE;QACX,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,SAAS;QACjB,QAAQ,CAAC,KAAK;YACZ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,OAAO;oBACL,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;iBAC9D,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,KAAgC,CAAC;YAC9C,MAAM,MAAM,GAA6B,EAAE,CAAC;YAC5C,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACrC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;gBACvE,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,CAAC;YAED,OAAO;gBACL,KAAK,EAAE;oBACL,IAAI,EAAE,IAAI,CAAC,IAAc;oBACzB,OAAO,EAAE,IAAI,CAAC,OAAiB;oBAC/B,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS;wBAC9B,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAmB,EAAE;wBACzC,CAAC,CAAC,EAAE,CAAC;iBACR;aACF,CAAC;QACJ,CAAC;KACF;CACF,CAAC;AAmJF;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAA0C;IAE1C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAC3B,CAAC,CAAE,OAAqC;QACxC,CAAC,CAAC,CAAC,OAAyB,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/contracts/types.ts"],"names":[],"mappings":"AAmGA;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAuB,CAAC;AA6DlE;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM;IACN,KAAK;IACL,OAAO;CACqC,CAAC;AAE/C;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAkB;IAElB,OAAQ,iBAA2C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAgC;IACzE,WAAW,EAAE;QACX,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,SAAS;QACjB,QAAQ,CAAC,KAAK;YACZ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,OAAO;oBACL,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;iBAC9D,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,KAAgC,CAAC;YAC9C,MAAM,MAAM,GAA6B,EAAE,CAAC;YAC5C,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACrC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;gBACvE,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,CAAC;YAED,OAAO;gBACL,KAAK,EAAE;oBACL,IAAI,EAAE,IAAI,CAAC,IAAc;oBACzB,OAAO,EAAE,IAAI,CAAC,OAAiB;oBAC/B,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS;wBAC9B,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAmB,EAAE;wBACzC,CAAC,CAAC,EAAE,CAAC;iBACR;aACF,CAAC;QACJ,CAAC;KACF;CACF,CAAC;AAuJF;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAA0C;IAE1C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAC3B,CAAC,CAAE,OAAqC;QACxC,CAAC,CAAC,CAAC,OAAyB,CAAC,CAAC;AAClC,CAAC"}

package/dist/events/index.d.ts

@@ -47,6 +47,45 @@ export interface EventPublishOptions {
     /** Versioned trace context captured by the event producer. */
     trace?: TraceCarrier;
 }
+/**
+ * Lifecycle handle for one event subscription or a composed listener
+ * registration.
+ *
+ * `ready` proves initial transport readiness. It does not represent ongoing
+ * connectivity, durability, replay, or handler success after startup.
+ */
+export interface EventSubscription {
+    /** Resolves when the subscription can receive events. */
+    readonly ready: Promise<void>;
+    /** Stop local delivery and await transport cleanup. Idempotent. */
+    unsubscribe(): Promise<void>;
+}
+/** Error used when a subscription closes before initial readiness. */
+export declare class EventSubscriptionClosedError extends Error {
+    constructor(message?: string);
+}
+/** Error thrown when a listener registry misses its readiness deadline. */
+export declare class ListenerRegistrationTimeoutError extends Error {
+    /** Configured readiness deadline in milliseconds. */
+    readonly timeoutMs: number;
+    /** Listener names that were part of the registration. */
+    readonly listenerNames: readonly string[];
+    constructor(args: {
+        timeoutMs: number;
+        listenerNames: readonly string[];
+    });
+}
+/** Error thrown when listener rollback misses the registration deadline. */
+export declare class ListenerRegistrationCleanupTimeoutError extends Error {
+    /** Configured registration deadline in milliseconds. */
+    readonly timeoutMs: number;
+    /** Listener names that were part of the registration. */
+    readonly listenerNames: readonly string[];
+    constructor(args: {
+        timeoutMs: number;
+        listenerNames: readonly string[];
+    });
+}
 /**
  * Options for `defineEvent(...)`.
  */
@@ -120,9 +159,9 @@ export interface EventBusLike {
      */
     publish<E extends EventPayloadDef>(event: E, payload: InferEventPayload<E>, options?: EventPublishOptions): MaybePromise<void>;
     /**
-     * Subscribe to an event and return an unsubscribe function.
+     * Subscribe to an event and return its readiness and cleanup handle.
      */
-    subscribe<E extends EventPayloadDef>(event: E, handler: (payload: InferEventPayload<E>, options?: EventPublishOptions) => MaybePromise<void>): () => void;
+    subscribe<E extends EventPayloadDef>(event: E, handler: (payload: InferEventPayload<E>, options?: EventPublishOptions) => MaybePromise<void>): EventSubscription;
 }
 /**
  * Options for `registerListeners(...)`.
@@ -142,6 +181,12 @@ export interface RegisterListenersOptions<Ctx> {
      * the event bus subscription callback.
      */
     onError?: (error: unknown, listener: ListenerDef<EventDef, Ctx>) => void;
+    /**
+     * Maximum time for the complete listener registry to become ready. The same
+     * registration deadline bounds automatic rollback after startup failure.
+     * Defaults to 10 seconds.
+     */
+    readyTimeoutMs?: number;
 }
 /**
  * Context-bound listener helper factory.
@@ -181,12 +226,16 @@ export declare function parseEventPayload<E extends EventPayloadDef>(event: E, p
  */
 export declare function publishEvent<E extends EventPayloadDef>(eventBus: EventBusLike, event: E, payload: InferEventPayload<E>, options?: EventPublishOptions): Promise<void>;
 /**
- * Register listeners against an event bus and return an unsubscribe function.
+ * Register listeners against an event bus and return a composite lifecycle
+ * handle.
  *
  * Payloads are validated before listener handlers run. Listener context is
- * resolved per delivery when `options.ctx` is a factory.
+ * resolved per delivery when `options.ctx` is a factory. Initial registration
+ * starts every child cleanup after a synchronous subscribe failure, rejected
+ * readiness promise, or readiness timeout. Cleanup that cannot finish inside
+ * the registration deadline is reported without extending startup forever.
  */
-export declare function registerListeners<Ctx>(eventBus: EventBusLike, listeners: readonly ListenerDef<EventDef, Ctx>[], options?: RegisterListenersOptions<Ctx>): () => void;
+export declare function registerListeners<Ctx>(eventBus: EventBusLike, listeners: readonly ListenerDef<EventDef, Ctx>[], options?: RegisterListenersOptions<Ctx>): EventSubscription;
 /**
  * Create listener helper methods bound to an application context type.
  *