@astrale-os/kernel-protocol 0.5.0-beta.2

package/dist/invocation/http/binary.js

@@ -0,0 +1,89 @@
+import { CODES, ProtocolError } from '../../errors/index.js';
+export const BINARY_HEADERS_FIELD = 'x-astrale-binary-headers';
+export const REQUEST_ID_FIELD = 'x-astrale-request-id';
+const HEADER_NAME = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/u;
+const MAXIMUM_MANIFEST_BYTES = 8_192;
+const MAXIMUM_MANIFEST_NAMES = 128;
+const EMPTY_MANIFEST = '-';
+const RESERVED = new Set([
+    'authorization',
+    'cache-control',
+    'connection',
+    'content-encoding',
+    'content-length',
+    'content-type',
+    'cookie',
+    'date',
+    'etag',
+    'host',
+    'keep-alive',
+    'location',
+    'proxy-authenticate',
+    'proxy-authorization',
+    'referrer-policy',
+    'server',
+    'set-cookie',
+    'trailer',
+    'transfer-encoding',
+    'upgrade',
+    'vary',
+    'www-authenticate',
+    EMPTY_MANIFEST,
+    BINARY_HEADERS_FIELD,
+    REQUEST_ID_FIELD,
+    'x-astrale-stream-framing',
+]);
+export function isApplicationBinaryHeader(name) {
+    const normalized = name.toLowerCase();
+    return (HEADER_NAME.test(normalized) &&
+        !normalized.startsWith('access-control-') &&
+        !normalized.startsWith('sec-websocket-') &&
+        !RESERVED.has(normalized));
+}
+export function encodeBinaryHeaderNames(headers) {
+    const names = [];
+    const seen = new Set();
+    for (const input of Object.keys(headers ?? {})) {
+        const name = input.toLowerCase();
+        if (!HEADER_NAME.test(name) || seen.has(name))
+            invalid();
+        seen.add(name);
+        if (!isApplicationBinaryHeader(name))
+            continue;
+        names.push(name);
+    }
+    if (names.length > MAXIMUM_MANIFEST_NAMES)
+        invalid();
+    const manifest = names.length === 0 ? EMPTY_MANIFEST : names.sort().join(', ');
+    if (new TextEncoder().encode(manifest).byteLength > MAXIMUM_MANIFEST_BYTES)
+        invalid();
+    return manifest;
+}
+export function decodeBinaryHeaderNames(input) {
+    if (input === EMPTY_MANIFEST)
+        return Object.freeze([]);
+    if (input === null || input === '')
+        invalid();
+    if (new TextEncoder().encode(input).byteLength > MAXIMUM_MANIFEST_BYTES)
+        invalid();
+    const names = input.split(',');
+    if (names.length > MAXIMUM_MANIFEST_NAMES)
+        invalid();
+    const admitted = [];
+    const seen = new Set();
+    for (const item of names) {
+        const name = item.trim().toLowerCase();
+        if (!isApplicationBinaryHeader(name) || seen.has(name))
+            invalid();
+        seen.add(name);
+        admitted.push(name);
+    }
+    return Object.freeze(admitted);
+}
+function invalid() {
+    throw new ProtocolError({
+        code: CODES.INVALID_REQUEST,
+        message: 'HTTP binary application-header manifest is invalid.',
+    });
+}
+//# sourceMappingURL=binary.js.map

package/dist/invocation/http/binary.js.map

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

package/dist/invocation/http/index.d.ts

@@ -0,0 +1,5 @@
+export { BINARY_HEADERS_FIELD, decodeBinaryHeaderNames, encodeBinaryHeaderNames, isApplicationBinaryHeader, REQUEST_ID_FIELD, } from './binary.js';
+export { codecForContentType, negotiateResponseCodec } from './negotiation.js';
+export { encodeStreamFrame, LENGTH_PREFIX_V1, STREAM_FRAMING_FIELD } from './stream.js';
+export { BAGGAGE_FIELD, decodeTraceHeaders, encodeTraceHeaders, TRACEPARENT_FIELD, TRACESTATE_FIELD, } from './trace.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/invocation/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../invocation/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC9E,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvF,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAA"}

package/dist/invocation/http/index.js

@@ -0,0 +1,5 @@
+export { BINARY_HEADERS_FIELD, decodeBinaryHeaderNames, encodeBinaryHeaderNames, isApplicationBinaryHeader, REQUEST_ID_FIELD, } from './binary.js';
+export { codecForContentType, negotiateResponseCodec } from './negotiation.js';
+export { encodeStreamFrame, LENGTH_PREFIX_V1, STREAM_FRAMING_FIELD } from './stream.js';
+export { BAGGAGE_FIELD, decodeTraceHeaders, encodeTraceHeaders, TRACEPARENT_FIELD, TRACESTATE_FIELD, } from './trace.js';
+//# sourceMappingURL=index.js.map

package/dist/invocation/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../invocation/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC9E,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvF,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAA"}

package/dist/invocation/http/negotiation.d.ts

@@ -0,0 +1,4 @@
+import type { Codec } from '../../codecs/index.js';
+export declare function codecForContentType(contentType: string | null, supported: readonly Codec[]): Codec | undefined;
+export declare function negotiateResponseCodec(accept: string | null, requestCodec: Codec, supported: readonly Codec[]): Codec | undefined;
+//# sourceMappingURL=negotiation.d.ts.map

package/dist/invocation/http/negotiation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiation.d.ts","sourceRoot":"","sources":["../../../invocation/http/negotiation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAiBlD,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,SAAS,EAAE,SAAS,KAAK,EAAE,GAC1B,KAAK,GAAG,SAAS,CAYnB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,YAAY,EAAE,KAAK,EACnB,SAAS,EAAE,SAAS,KAAK,EAAE,GAC1B,KAAK,GAAG,SAAS,CAmCnB"}

package/dist/invocation/http/negotiation.js

@@ -0,0 +1,208 @@
+import { CONTENT_TYPE_JSON, CONTENT_TYPE_MSGPACK } from '../../codecs/index.js';
+import { admitSupportedCodecs } from '../binding-codecs.js';
+const TOKEN = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/u;
+const QVALUE = /^(?:0(?:\.\d{0,3})?|1(?:\.0{0,3})?)$/u;
+export function codecForContentType(contentType, supported) {
+    const admitted = admitSupportedCodecs(supported);
+    if (contentType === null || contentType.trim() === '')
+        return undefined;
+    const mediaType = parseContentType(contentType);
+    if (mediaType === undefined)
+        return undefined;
+    const profile = mediaType === CONTENT_TYPE_JSON
+        ? 'json'
+        : mediaType === CONTENT_TYPE_MSGPACK
+            ? 'msgpack'
+            : undefined;
+    return admitted.find((entry) => entry.profile === profile)?.codec;
+}
+export function negotiateResponseCodec(accept, requestCodec, supported) {
+    const admitted = admitSupportedCodecs(supported);
+    const request = admitted.find((entry) => entry.codec === requestCodec);
+    if (request === undefined)
+        throw new TypeError('requestCodec must occur exactly once in supported.');
+    if (accept === null || accept.trim() === '')
+        return request.codec;
+    const ranges = parseAccept(accept);
+    if (ranges.length === 0)
+        return undefined;
+    const candidates = admitted.flatMap((entry) => {
+        const [type, subtype] = contentTypeOf(entry.profile).split('/');
+        const governing = ranges
+            .filter((range) => range.mediaParameters === 0 &&
+            (range.type === '*' || range.type === type) &&
+            (range.subtype === '*' || range.subtype === subtype))
+            .sort((left, right) => right.specificity - left.specificity || left.index - right.index)[0];
+        return governing === undefined || governing.quality === 0 ? [] : [{ ...entry, governing }];
+    });
+    if (candidates.length === 0)
+        return undefined;
+    candidates.sort((left, right) => {
+        const quality = right.governing.quality - left.governing.quality;
+        if (quality !== 0)
+            return quality;
+        if (left.codec === request.codec)
+            return -1;
+        if (right.codec === request.codec)
+            return 1;
+        const order = left.governing.index - right.governing.index;
+        if (order !== 0)
+            return order;
+        if (left.profile === 'json')
+            return -1;
+        if (right.profile === 'json')
+            return 1;
+        return 0;
+    });
+    return candidates[0]?.codec;
+}
+function contentTypeOf(profile) {
+    return profile === 'json' ? CONTENT_TYPE_JSON : CONTENT_TYPE_MSGPACK;
+}
+function parseContentType(input) {
+    if (splitOutsideQuotes(input, ',')?.length !== 1)
+        return undefined;
+    const parts = splitOutsideQuotes(input, ';');
+    if (parts === undefined)
+        return undefined;
+    const mediaType = parts.shift()?.trim().toLowerCase();
+    if (mediaType === undefined || parseType(mediaType, false) === undefined)
+        return undefined;
+    const names = new Set();
+    for (const part of parts) {
+        const parameter = parseParameter(part);
+        if (parameter === undefined || names.has(parameter.name))
+            return undefined;
+        names.add(parameter.name);
+    }
+    return mediaType;
+}
+function parseAccept(input) {
+    const members = splitOutsideQuotes(input, ',');
+    if (members === undefined)
+        return [];
+    const ranges = [];
+    for (const [index, member] of members.entries()) {
+        const parts = splitOutsideQuotes(member, ';');
+        if (parts === undefined)
+            continue;
+        const media = parseType(parts.shift()?.trim().toLowerCase() ?? '', true);
+        if (media === undefined)
+            continue;
+        let quality = 1;
+        let qualitySeen = false;
+        let mediaParameters = 0;
+        let invalid = false;
+        const names = new Set();
+        for (const part of parts) {
+            const parameter = parseParameter(part);
+            if (parameter === undefined || names.has(parameter.name)) {
+                invalid = true;
+                break;
+            }
+            names.add(parameter.name);
+            if (parameter.name === 'q') {
+                if (qualitySeen || !QVALUE.test(parameter.value)) {
+                    invalid = true;
+                    break;
+                }
+                qualitySeen = true;
+                quality = Number(parameter.value);
+            }
+            else if (!qualitySeen) {
+                mediaParameters += 1;
+            }
+        }
+        if (invalid)
+            continue;
+        ranges.push({
+            ...media,
+            quality,
+            specificity: media.type === '*' ? 0 : media.subtype === '*' ? 1 : 2,
+            index,
+            mediaParameters,
+        });
+    }
+    return ranges;
+}
+function parseType(input, wildcards) {
+    const separator = input.indexOf('/');
+    if (separator <= 0 || separator !== input.lastIndexOf('/'))
+        return undefined;
+    const type = input.slice(0, separator);
+    const subtype = input.slice(separator + 1);
+    if (subtype === '')
+        return undefined;
+    const typeValid = TOKEN.test(type) || (wildcards && type === '*');
+    const subtypeValid = TOKEN.test(subtype) || (wildcards && subtype === '*');
+    if (!typeValid || !subtypeValid || (type === '*' && subtype !== '*'))
+        return undefined;
+    return { type, subtype };
+}
+function parseParameter(input) {
+    const separator = input.indexOf('=');
+    if (separator <= 0)
+        return undefined;
+    const name = input.slice(0, separator).trim().toLowerCase();
+    const value = input.slice(separator + 1).trim();
+    if (!TOKEN.test(name) || (!TOKEN.test(value) && !quotedString(value)))
+        return undefined;
+    return { name, value: unquote(value) };
+}
+function quotedString(input) {
+    if (input.length < 2 || input[0] !== '"' || input.at(-1) !== '"')
+        return false;
+    for (let index = 1; index < input.length - 1; index += 1) {
+        const code = input.charCodeAt(index);
+        if (input[index] === '\\') {
+            index += 1;
+            if (index >= input.length - 1)
+                return false;
+            continue;
+        }
+        if (input[index] === '"' || code === 0x7f || (code < 0x20 && code !== 0x09))
+            return false;
+    }
+    return true;
+}
+function unquote(input) {
+    if (input[0] !== '"')
+        return input;
+    let output = '';
+    for (let index = 1; index < input.length - 1; index += 1) {
+        if (input[index] === '\\')
+            index += 1;
+        output += input[index];
+    }
+    return output;
+}
+function splitOutsideQuotes(input, separator) {
+    const parts = [];
+    let quoted = false;
+    let escaped = false;
+    let start = 0;
+    for (let index = 0; index < input.length; index += 1) {
+        const character = input[index];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (quoted && character === '\\') {
+            escaped = true;
+            continue;
+        }
+        if (character === '"') {
+            quoted = !quoted;
+            continue;
+        }
+        if (!quoted && character === separator) {
+            parts.push(input.slice(start, index));
+            start = index + 1;
+        }
+    }
+    if (quoted || escaped)
+        return undefined;
+    parts.push(input.slice(start));
+    return parts;
+}
+//# sourceMappingURL=negotiation.js.map

package/dist/invocation/http/negotiation.js.map

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

package/dist/invocation/http/stream.d.ts

@@ -0,0 +1,6 @@
+import type { Codec } from '../../codecs/index.js';
+import type { StreamFrame } from '../stream.js';
+export declare const STREAM_FRAMING_FIELD: 'x-astrale-stream-framing';
+export declare const LENGTH_PREFIX_V1: 'length-prefix-v1';
+export declare function encodeStreamFrame(codec: Codec, frame: StreamFrame): Uint8Array;
+//# sourceMappingURL=stream.d.ts.map

package/dist/invocation/http/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../invocation/http/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,eAAO,MAAM,oBAAoB,EAAG,0BAAmC,CAAA;AACvE,eAAO,MAAM,gBAAgB,EAAG,kBAA2B,CAAA;AAK3D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,GAAG,UAAU,CAU9E"}

package/dist/invocation/http/stream.js

@@ -0,0 +1,16 @@
+export const STREAM_FRAMING_FIELD = 'x-astrale-stream-framing';
+export const LENGTH_PREFIX_V1 = 'length-prefix-v1';
+const encoder = new TextEncoder();
+const MAXIMUM_UINT32 = 0xffff_ffff;
+export function encodeStreamFrame(codec, frame) {
+    const encoded = codec.encode(frame);
+    const payload = typeof encoded === 'string' ? encoder.encode(encoded) : encoded;
+    if (payload.byteLength > MAXIMUM_UINT32) {
+        throw new RangeError('stream frame exceeds the uint32 length-prefix-v1 payload bound.');
+    }
+    const output = new Uint8Array(4 + payload.byteLength);
+    new DataView(output.buffer).setUint32(0, payload.byteLength);
+    output.set(payload, 4);
+    return output;
+}
+//# sourceMappingURL=stream.js.map

package/dist/invocation/http/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../invocation/http/stream.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,oBAAoB,GAAG,0BAAmC,CAAA;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAA2B,CAAA;AAE3D,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;AACjC,MAAM,cAAc,GAAG,WAAW,CAAA;AAElC,MAAM,UAAU,iBAAiB,CAAC,KAAY,EAAE,KAAkB;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACnC,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IAC/E,IAAI,OAAO,CAAC,UAAU,GAAG,cAAc,EAAE,CAAC;QACxC,MAAM,IAAI,UAAU,CAAC,iEAAiE,CAAC,CAAA;IACzF,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACrD,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IAC5D,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IACtB,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/invocation/http/trace.d.ts

@@ -0,0 +1,7 @@
+import type { Trace } from '../trace.js';
+export declare const TRACEPARENT_FIELD = "traceparent";
+export declare const TRACESTATE_FIELD = "tracestate";
+export declare const BAGGAGE_FIELD = "baggage";
+export declare function decodeTraceHeaders(traceparent: string | null, tracestate: string | null): Trace | undefined;
+export declare function encodeTraceHeaders(carrier: Trace | undefined): Readonly<Record<string, string>>;
+//# sourceMappingURL=trace.d.ts.map

package/dist/invocation/http/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../invocation/http/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAIxC,eAAO,MAAM,iBAAiB,gBAAgB,CAAA;AAC9C,eAAO,MAAM,gBAAgB,eAAe,CAAA;AAC5C,eAAO,MAAM,aAAa,YAAY,CAAA;AAItC,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,KAAK,GAAG,SAAS,CAMnB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQ/F"}

package/dist/invocation/http/trace.js

@@ -0,0 +1,25 @@
+import { admitTrace } from '../trace.js';
+export const TRACEPARENT_FIELD = 'traceparent';
+export const TRACESTATE_FIELD = 'tracestate';
+export const BAGGAGE_FIELD = 'baggage';
+const EMPTY_HEADERS = Object.freeze({});
+export function decodeTraceHeaders(traceparent, tracestate) {
+    if (traceparent === null)
+        return undefined;
+    return admitTrace({
+        traceparent,
+        ...(tracestate === null ? {} : { tracestate }),
+    });
+}
+export function encodeTraceHeaders(carrier) {
+    if (carrier === undefined)
+        return EMPTY_HEADERS;
+    const admitted = admitTrace(carrier);
+    if (admitted === undefined)
+        return EMPTY_HEADERS;
+    return Object.freeze({
+        [TRACEPARENT_FIELD]: admitted.traceparent,
+        ...(admitted.tracestate === undefined ? {} : { [TRACESTATE_FIELD]: admitted.tracestate }),
+    });
+}
+//# sourceMappingURL=trace.js.map

package/dist/invocation/http/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../invocation/http/trace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAA;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAA;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAA;AAEtC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AAEvC,MAAM,UAAU,kBAAkB,CAChC,WAA0B,EAC1B,UAAyB;IAEzB,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,SAAS,CAAA;IAC1C,OAAO,UAAU,CAAC;QAChB,WAAW;QACX,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;KAC/C,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAA0B;IAC3D,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,aAAa,CAAA;IAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACpC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,aAAa,CAAA;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,WAAW;QACzC,GAAG,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;KAC1F,CAAC,CAAA;AACJ,CAAC"}

package/dist/invocation/idempotency.d.ts

@@ -0,0 +1,11 @@
+declare const IDEMPOTENCY_KEY: unique symbol;
+/** Caller-selected identity for one logical root invocation attempt group. */
+export type IdempotencyKey = string & {
+    readonly [IDEMPOTENCY_KEY]: true;
+};
+export declare const HTTP_IDEMPOTENCY_KEY: 'x-astrale-idempotency-key';
+export declare const MAXIMUM_IDEMPOTENCY_KEY_LENGTH = 128;
+/** Admit an opaque URL-safe ASCII key without assigning it semantic structure. */
+export declare function acceptIdempotencyKey(input: unknown, label?: string): IdempotencyKey;
+export {};
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/invocation/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../invocation/idempotency.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,eAAe,EAAE,OAAO,MAAM,CAAA;AAE5C,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,IAAI,CAAA;CAAE,CAAA;AAE1E,eAAO,MAAM,oBAAoB,EAAG,2BAAoC,CAAA;AACxE,eAAO,MAAM,8BAA8B,MAAM,CAAA;AAEjD,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAoB,GAAG,cAAc,CAU9F"}

package/dist/invocation/idempotency.js

@@ -0,0 +1,14 @@
+import { invalid } from './admission.js';
+export const HTTP_IDEMPOTENCY_KEY = 'x-astrale-idempotency-key';
+export const MAXIMUM_IDEMPOTENCY_KEY_LENGTH = 128;
+/** Admit an opaque URL-safe ASCII key without assigning it semantic structure. */
+export function acceptIdempotencyKey(input, label = 'idempotency key') {
+    if (typeof input !== 'string' ||
+        input.length < 1 ||
+        input.length > MAXIMUM_IDEMPOTENCY_KEY_LENGTH ||
+        !/^[A-Za-z0-9._~-]+$/u.test(input)) {
+        invalid(`${label} must contain 1-128 URL-safe ASCII characters`);
+    }
+    return input;
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/invocation/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../invocation/idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAOxC,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAAoC,CAAA;AACxE,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAA;AAEjD,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,KAAK,GAAG,iBAAiB;IAC5E,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,KAAK,CAAC,MAAM,GAAG,8BAA8B;QAC7C,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAClC,CAAC;QACD,OAAO,CAAC,GAAG,KAAK,+CAA+C,CAAC,CAAA;IAClE,CAAC;IACD,OAAO,KAAuB,CAAA;AAChC,CAAC"}

package/dist/invocation/index.d.ts

@@ -0,0 +1,20 @@
+export { decodeBinaryResponse, type BinaryResponse } from './binary.js';
+export { decodeCancelRequest, type CancelRequest } from './cancellation.js';
+export { type RequestId } from './correlation.js';
+export { acceptIdempotencyKey, HTTP_IDEMPOTENCY_KEY, MAXIMUM_IDEMPOTENCY_KEY_LENGTH, type IdempotencyKey, } from './idempotency.js';
+export * as http from './http/index.js';
+export { acceptDelegate, type Delegate } from './delegate.js';
+export { decodeMiss, miss, type Miss } from './miss.js';
+export { acceptRoute, decodeRedirect, remoteRoute, type RemoteBindingInput, type Redirect, type Route, } from './redirect.js';
+export { decodeRequest, type Request } from './request.js';
+export { admitTrace, MAXIMUM_TRACEPARENT_BYTES, MAXIMUM_TRACESTATE_BYTES, MAXIMUM_TRACESTATE_MEMBERS, type Trace, } from './trace.js';
+export { acceptRouting, type Refresh, type Routing, type Via } from './routing.js';
+export { acceptSchemaTarget, type SchemaTarget } from './schema.js';
+export { decodeResponse, type ErrorResponse, type Response, type SuccessResponse, } from './response.js';
+export { SCHEMA_UPGRADE_REQUIRED, SERVICE_CANDIDATE_INVALID, SERVICE_TRUST_REQUIRED, SERVICE_UNAVAILABLE, serviceErrorOf, type SchemaUpgradeRequiredDetails, type SchemaUpgradeRequiredReason, type ServiceCandidateInvalidDetails, type ServiceCandidateInvalidReason, type ServiceErrorPayload, type ServiceReason, type ServiceTrustRequiredDetails, type ServiceTrustRequiredReason, type ServiceUnavailableDetails, type ServiceUnavailableReason, } from './service-reason.js';
+export { decodeStale, stale, type Stale } from './stale-route.js';
+export { decodeStreamFrame, type StreamEndFrame, type StreamErrorFrame, type StreamFrame, type StreamItemFrame, type StreamStartFrame, } from './stream.js';
+export { acceptCall, type Call } from './target.js';
+export { VERSION, type Version } from './version.js';
+export * as websocket from './websocket/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../invocation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC3E,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,CAAA;AACvD,OAAO,EACL,WAAW,EACX,cAAc,EACd,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,KAAK,KAAK,GACX,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EACL,UAAU,EACV,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,KAAK,KAAK,GACX,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,cAAc,CAAA;AAClF,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,EACL,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,UAAU,EAAE,KAAK,IAAI,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAA"}

package/dist/invocation/index.js

@@ -0,0 +1,20 @@
+export { decodeBinaryResponse } from './binary.js';
+export { decodeCancelRequest } from './cancellation.js';
+export {} from './correlation.js';
+export { acceptIdempotencyKey, HTTP_IDEMPOTENCY_KEY, MAXIMUM_IDEMPOTENCY_KEY_LENGTH, } from './idempotency.js';
+export * as http from './http/index.js';
+export { acceptDelegate } from './delegate.js';
+export { decodeMiss, miss } from './miss.js';
+export { acceptRoute, decodeRedirect, remoteRoute, } from './redirect.js';
+export { decodeRequest } from './request.js';
+export { admitTrace, MAXIMUM_TRACEPARENT_BYTES, MAXIMUM_TRACESTATE_BYTES, MAXIMUM_TRACESTATE_MEMBERS, } from './trace.js';
+export { acceptRouting } from './routing.js';
+export { acceptSchemaTarget } from './schema.js';
+export { decodeResponse, } from './response.js';
+export { SCHEMA_UPGRADE_REQUIRED, SERVICE_CANDIDATE_INVALID, SERVICE_TRUST_REQUIRED, SERVICE_UNAVAILABLE, serviceErrorOf, } from './service-reason.js';
+export { decodeStale, stale } from './stale-route.js';
+export { decodeStreamFrame, } from './stream.js';
+export { acceptCall } from './target.js';
+export { VERSION } from './version.js';
+export * as websocket from './websocket/index.js';
+//# sourceMappingURL=index.js.map

package/dist/invocation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../invocation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAuB,MAAM,aAAa,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAsB,MAAM,mBAAmB,CAAA;AAC3E,OAAO,EAAkB,MAAM,kBAAkB,CAAA;AACjD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,GAE/B,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,cAAc,EAAiB,MAAM,eAAe,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAa,MAAM,WAAW,CAAA;AACvD,OAAO,EACL,WAAW,EACX,cAAc,EACd,WAAW,GAIZ,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,aAAa,EAAgB,MAAM,cAAc,CAAA;AAC1D,OAAO,EACL,UAAU,EACV,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,GAE3B,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,aAAa,EAAwC,MAAM,cAAc,CAAA;AAClF,OAAO,EAAE,kBAAkB,EAAqB,MAAM,aAAa,CAAA;AACnE,OAAO,EACL,cAAc,GAIf,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,GAWf,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,WAAW,EAAE,KAAK,EAAc,MAAM,kBAAkB,CAAA;AACjE,OAAO,EACL,iBAAiB,GAMlB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,UAAU,EAAa,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAA;AACpD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAA"}

package/dist/invocation/miss.d.ts

@@ -0,0 +1,8 @@
+import type { RequestId } from './correlation.js';
+export interface Miss {
+    readonly kind: 'miss';
+    readonly id: RequestId;
+}
+export declare function decodeMiss(input: unknown): Miss;
+export declare function miss(id: RequestId): Miss;
+//# sourceMappingURL=miss.d.ts.map

package/dist/invocation/miss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miss.d.ts","sourceRoot":"","sources":["../../invocation/miss.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAIjD,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAA;CACvB;AAID,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAM/C;AAED,wBAAgB,IAAI,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAExC"}

package/dist/invocation/miss.js

@@ -0,0 +1,14 @@
+import { exactFields, invalid, portableObject, requestId, required } from './admission.js';
+const FIELDS = new Set(['kind', 'id']);
+export function decodeMiss(input) {
+    const object = portableObject(input, 'miss control');
+    exactFields(object, FIELDS, 'miss control');
+    required(object, ['kind', 'id'], 'miss control');
+    if (object.kind !== 'miss')
+        invalid('miss control.kind must be "miss"');
+    return Object.freeze({ kind: 'miss', id: requestId(object.id, 'miss control.id') });
+}
+export function miss(id) {
+    return Object.freeze({ kind: 'miss', id });
+}
+//# sourceMappingURL=miss.js.map

package/dist/invocation/miss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"miss.js","sourceRoot":"","sources":["../../invocation/miss.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAO1F,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;AAEtC,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;IACpD,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,CAAC,CAAA;IAChD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,CAAC,kCAAkC,CAAC,CAAA;IACvE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAA;AACrF,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,EAAa;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;AAC5C,CAAC"}

package/dist/invocation/redirect.d.ts

@@ -0,0 +1,33 @@
+import type { IssuerId } from '@astrale-os/kernel-core/auth';
+import type { Key } from '@astrale-os/kernel-dsl/v1';
+import type { RequestId } from './correlation.js';
+import type { Trace } from './trace.js';
+import * as publication from '../publication/index.js';
+export interface Route {
+    readonly endpoint: publication.InvocationEndpoints;
+    readonly via: {
+        readonly kind: 'via';
+        readonly publication: publication.PublicationRef;
+        readonly issuer: IssuerId;
+    };
+}
+export interface Redirect {
+    readonly kind: 'redirect';
+    readonly id: RequestId;
+    readonly route: Route;
+    readonly credential?: string;
+    /** Ephemeral one-hop correlation hint; never cached or treated as authority. */
+    readonly trace?: Trace;
+}
+export interface RemoteBindingInput {
+    readonly endpoint: publication.InvocationEndpoints;
+    readonly issuer: IssuerId;
+    readonly subject: string;
+    readonly revision: publication.PublicationRef['revision'];
+    readonly etag: publication.Etag;
+}
+export declare function acceptRoute(input: unknown): Route;
+/** Project one semantic remote binding into its admitted protocol route representation. */
+export declare function remoteRoute(origin: Key.Origin, binding: RemoteBindingInput, issuer: IssuerId): Route;
+export declare function decodeRedirect(input: unknown): Redirect;
+//# sourceMappingURL=redirect.d.ts.map

package/dist/invocation/redirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect.d.ts","sourceRoot":"","sources":["../../invocation/redirect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAA;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAA;AAYtD,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,mBAAmB,CAAA;IAClD,QAAQ,CAAC,GAAG,EAAE;QACZ,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;QACpB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,cAAc,CAAA;QAChD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;KAC1B,CAAA;CACF;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,mBAAmB,CAAA;IAClD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,CAAA;IACzD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAA;CAChC;AAMD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAuBjD;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CACzB,MAAM,EAAE,GAAG,CAAC,MAAM,EAClB,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,QAAQ,GACf,KAAK,CAcP;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAoBvD"}