@origintrail-official/dkg-core 10.0.19 → 10.0.21

package/dist/experimental-exact-batch-stream.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Opt-in exact-batch transport over the router's existing encrypted libp2p
+ * connections. Core owns framing; KA proofs/gzip/verified atomic commits stay agent-owned.
+ * No pooled RESPONSE frame, new cipher, default registration or payload replay.
+ */
+import type { Stream } from '@libp2p/interface';
+import { type ProtocolRouter, type DuplexStreamOptions } from './protocol-router.js';
+import { type ExactBatchFrame, type ExactBatchFrameKind, type ExactBatchRefusal } from './experimental-exact-batch-wire.js';
+export { EXACT_BATCH_STREAM_PROTOCOL as EXPERIMENTAL_EXACT_BATCH_STREAM_PROTOCOL, EXACT_BATCH_STREAM_WINDOW_SIZE as EXPERIMENTAL_EXACT_BATCH_STREAM_WINDOW_SIZE, } from './experimental-exact-batch-wire.js';
+/** Closed numeric observations; never request text, scope identifiers or peers. */
+export type ExactBatchTransportEvent = Readonly<{
+    event: 'streamReady';
+    elapsedMs: number;
+}> | Readonly<{
+    event: 'bytes';
+    direction: 'sent' | 'received';
+    byteLength: number;
+}> | Readonly<{
+    event: 'frame';
+    direction: 'sent' | 'received';
+    frameKind: ExactBatchFrameKind;
+}>;
+export interface ExactBatchTransportOptions extends DuplexStreamOptions {
+    /** Fixed experimental wire profile; window1 is contract unit-test coverage only. */
+    windowSize: 2;
+    maxRequestBytes: number;
+    maxFrameBytes: number;
+    /** Existing effective wire/phase ceiling, not an aggregate buffered batch. */
+    maxResponseBytes: number;
+    /**
+     * Best-effort only. Sent bytes are encoded payload accepted by native send,
+     * including a send that subsequently fails drain; sent frame counts follow
+     * successful send/drain. Received bytes include a later rejected raw chunk.
+     * These exclude Noise, muxer and TCP overhead. Never awaited by transport.
+     */
+    onTransportEvent?: (event: ExactBatchTransportEvent) => void | Promise<void>;
+}
+/** Only before START bytes: legacy fallback must never replay an ambiguous request. */
+export declare class ExperimentalExactBatchUnsupportedError extends Error {
+    readonly code = "EXPERIMENTAL_EXACT_BATCH_UNSUPPORTED";
+    constructor(cause: unknown);
+}
+export declare class ExactBatchTransportSession {
+    private readonly stream;
+    readonly signal: AbortSignal;
+    private readonly options;
+    private readonly frames;
+    readonly windowSize: 2;
+    private authorizedAssets?;
+    get assetUals(): readonly string[];
+    constructor(stream: Stream, signal: AbortSignal, options: ExactBatchTransportOptions, assetUals?: readonly string[]);
+    authorizeAssets(assetUals: readonly string[]): void;
+    next(): Promise<ExactBatchFrame | undefined>;
+    send(frame: ExactBatchFrame): Promise<void>;
+    dispose(): Promise<void>;
+}
+/** Client owns REQUEST and subsequent ACKs on the same duplex stream. */
+export declare function exchangeExperimentalExactBatch<T>(router: ProtocolRouter, peerId: string, request: ExactBatchFrame, options: ExactBatchTransportOptions & {
+    assetUals: readonly string[];
+}, consume: (session: ExactBatchTransportSession) => Promise<T>): Promise<T>;
+/** Core binds the selected assets and passes the caller's context through without interpreting it. */
+export interface ExactBatchResponderAuthorization<Context> {
+    readonly assetUals: readonly string[];
+    readonly context: Context;
+}
+/**
+ * Thrown by a responder callback to end the exchange with a refusal frame the
+ * requester can read, where any other error aborts the stream and looks like a
+ * broken connection. Only the closed wire code is sent, never the cause.
+ */
+export declare class ExactBatchResponderRefusal extends Error {
+    readonly refusal: ExactBatchRefusal;
+    constructor(refusal: ExactBatchRefusal, options?: ErrorOptions);
+}
+/** Explicit responder registration. Authorization precedes any scoped export. */
+export declare function registerExperimentalExactBatchResponder<Context>(router: ProtocolRouter, options: ExactBatchTransportOptions, authorizeRequest: (request: Uint8Array, peerId: string, signal: AbortSignal) => Promise<ExactBatchResponderAuthorization<Context>>, respond: (context: Context, session: ExactBatchTransportSession, peerId: string) => Promise<void>): void;
+//# sourceMappingURL=experimental-exact-batch-stream.d.ts.map

package/dist/experimental-exact-batch-stream.d.ts.map

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

package/dist/experimental-exact-batch-stream.js

@@ -0,0 +1,198 @@
+import { isProtocolUnsupportedError } from './protocol-router.js';
+import { EXACT_BATCH_STREAM_PROTOCOL, EXACT_BATCH_STREAM_WINDOW_SIZE, EXACT_BATCH_FRAME_KIND, EXACT_BATCH_BATCH_INDEX, EXACT_BATCH_MAX_REQUEST_BYTES, EXACT_BATCH_MAX_FRAME_BYTES, EXACT_BATCH_FRAME_HEADER_BYTES, EXACT_BATCH_MAX_ASSETS, encodeExactBatchFrame, decodeExactBatchFrames, validateExactBatchFrame, } from './experimental-exact-batch-wire.js';
+export { EXACT_BATCH_STREAM_PROTOCOL as EXPERIMENTAL_EXACT_BATCH_STREAM_PROTOCOL, EXACT_BATCH_STREAM_WINDOW_SIZE as EXPERIMENTAL_EXACT_BATCH_STREAM_WINDOW_SIZE, } from './experimental-exact-batch-wire.js';
+function observe(options, event) {
+    if (!options.onTransportEvent)
+        return;
+    try {
+        const pending = options.onTransportEvent(Object.freeze(event));
+        if (pending)
+            void Promise.resolve(pending).catch(() => undefined);
+    }
+    catch { /* An observer cannot turn a transport outcome into a failure. */ }
+}
+function observeFrame(options, direction, kind) {
+    if (!options.onTransportEvent)
+        return;
+    if (Number.isInteger(kind) && kind >= 1 && kind <= 7) {
+        observe(options, { event: 'frame', direction, frameKind: kind });
+    }
+}
+function checkSignal(signal) {
+    if (signal.aborted)
+        throw signal.reason instanceof Error ? signal.reason : new Error('Exact batch stream aborted');
+}
+function validateLimits(options) {
+    for (const value of [options.maxRequestBytes, options.maxFrameBytes, options.maxResponseBytes]) {
+        if (!Number.isSafeInteger(value) || value <= 0)
+            throw new RangeError('Exact batch transport limits must be positive safe integers');
+    }
+    if (options.maxRequestBytes > EXACT_BATCH_MAX_REQUEST_BYTES || options.maxFrameBytes > EXACT_BATCH_MAX_FRAME_BYTES + EXACT_BATCH_FRAME_HEADER_BYTES
+        || options.maxReadBufferBytes > options.maxFrameBytes * 2)
+        throw new RangeError('Exact batch transport exceeds experimental wire limits');
+    if (options.windowSize !== 2)
+        throw new Error('Experimental exact-batch profile requires window2');
+}
+function validateAssets(assetUals) {
+    if (!Array.isArray(assetUals) || assetUals.length < 1 || assetUals.length > EXACT_BATCH_MAX_ASSETS
+        || assetUals.some((ual) => typeof ual !== 'string' || ual.length === 0)
+        || new Set(assetUals).size !== assetUals.length)
+        throw new Error('Exact batch requires 1-10 distinct authorized asset UALs');
+}
+/** Only before START bytes: legacy fallback must never replay an ambiguous request. */
+export class ExperimentalExactBatchUnsupportedError extends Error {
+    code = 'EXPERIMENTAL_EXACT_BATCH_UNSUPPORTED';
+    constructor(cause) { super('Experimental exact-batch protocol unsupported before START', { cause }); }
+}
+export class ExactBatchTransportSession {
+    stream;
+    signal;
+    options;
+    frames;
+    windowSize = EXACT_BATCH_STREAM_WINDOW_SIZE;
+    authorizedAssets;
+    get assetUals() {
+        if (!this.authorizedAssets)
+            throw new Error('Exact batch asset scope has not been authorized');
+        return this.authorizedAssets;
+    }
+    constructor(stream, signal, options, assetUals) {
+        this.stream = stream;
+        this.signal = signal;
+        this.options = options;
+        if (assetUals)
+            this.authorizeAssets(assetUals);
+        let wireBytes = 0;
+        const source = {
+            async *[Symbol.asyncIterator]() {
+                for await (const incoming of stream) {
+                    checkSignal(signal);
+                    const length = incoming.byteLength;
+                    observe(options, { event: 'bytes', direction: 'received', byteLength: length });
+                    if (length > options.maxResponseBytes - wireBytes)
+                        throw new RangeError('Exact batch wire byte limit exceeded');
+                    wireBytes += length;
+                    // Preserve one iterator; never end it after reading the START frame.
+                    for (let offset = 0; offset < length; offset += options.maxFrameBytes) {
+                        yield incoming.subarray(offset, Math.min(offset + options.maxFrameBytes, length));
+                    }
+                }
+            },
+        };
+        this.frames = decodeExactBatchFrames(source, { signal });
+    }
+    authorizeAssets(assetUals) {
+        if (this.authorizedAssets)
+            throw new Error('Exact batch asset scope is already bound');
+        validateAssets(assetUals);
+        this.authorizedAssets = Object.freeze([...assetUals]);
+    }
+    async next() {
+        checkSignal(this.signal);
+        const frame = await this.frames.next();
+        if (!frame.done)
+            observeFrame(this.options, 'received', frame.value.kind);
+        checkSignal(this.signal);
+        return frame.done ? undefined : frame.value;
+    }
+    async send(frame) {
+        checkSignal(this.signal);
+        const frameKind = frame.kind;
+        const bytes = encodeExactBatchFrame(frame);
+        if (bytes.byteLength > this.options.maxFrameBytes)
+            throw new RangeError('Exact batch frame byte limit exceeded');
+        if (this.stream.writableNeedsDrain)
+            await this.stream.onDrain({ signal: this.signal });
+        checkSignal(this.signal);
+        const accepted = this.stream.send(bytes);
+        observe(this.options, { event: 'bytes', direction: 'sent', byteLength: bytes.byteLength });
+        if (!accepted)
+            await this.stream.onDrain({ signal: this.signal });
+        checkSignal(this.signal);
+        observeFrame(this.options, 'sent', frameKind);
+    }
+    async dispose() {
+        // Router must first close/abort the physical stream, unblocking any read.
+        await this.frames.return(undefined).catch(() => undefined);
+    }
+}
+/** Client owns REQUEST and subsequent ACKs on the same duplex stream. */
+export async function exchangeExperimentalExactBatch(router, peerId, request, options, consume) {
+    const enteredAt = performance.now();
+    validateLimits(options);
+    validateStart(request, options.maxRequestBytes);
+    validateAssets(options.assetUals);
+    const stableRequest = { ...request, payload: request.payload.slice() };
+    const stableOptions = Object.freeze({ ...options, assetUals: Object.freeze([...options.assetUals]) });
+    let session;
+    try {
+        return await router.withDuplexStream(peerId, EXACT_BATCH_STREAM_PROTOCOL, stableOptions, async (stream, signal) => {
+            session = new ExactBatchTransportSession(stream, signal, stableOptions, stableOptions.assetUals);
+            observe(stableOptions, { event: 'streamReady', elapsedMs: performance.now() - enteredAt });
+            await session.send(stableRequest);
+            return consume(session);
+        });
+    }
+    catch (error) {
+        if (!session && isProtocolUnsupportedError(error))
+            throw new ExperimentalExactBatchUnsupportedError(error);
+        throw error;
+    }
+    finally {
+        await session?.dispose();
+    }
+}
+/**
+ * Thrown by a responder callback to end the exchange with a refusal frame the
+ * requester can read, where any other error aborts the stream and looks like a
+ * broken connection. Only the closed wire code is sent, never the cause.
+ */
+export class ExactBatchResponderRefusal extends Error {
+    refusal;
+    constructor(refusal, options) {
+        super(`Exact batch responder refused: ${refusal}`, options);
+        this.refusal = refusal;
+        this.name = 'ExactBatchResponderRefusal';
+    }
+}
+/** Explicit responder registration. Authorization precedes any scoped export. */
+export function registerExperimentalExactBatchResponder(router, options, authorizeRequest, respond) {
+    validateLimits(options);
+    const stableOptions = Object.freeze({ ...options });
+    router.registerDuplexStream(EXACT_BATCH_STREAM_PROTOCOL, async (stream, signal) => {
+        const session = new ExactBatchTransportSession(stream, signal, stableOptions);
+        try {
+            const start = await session.next();
+            if (!start)
+                throw new Error('Exact batch START missing');
+            validateStart(start, stableOptions.maxRequestBytes);
+            return { requestData: start.payload, continuation: session, dispose: () => session.dispose() };
+        }
+        catch (error) {
+            stream.abort(error instanceof Error ? error : new Error('Exact batch START failed'));
+            await session.dispose();
+            throw error;
+        }
+    }, async ({ requestData, peerId, continuation: session, signal }) => {
+        try {
+            const authorized = await authorizeRequest(requestData, peerId, signal);
+            session.authorizeAssets(authorized.assetUals);
+            checkSignal(signal);
+            await respond(authorized.context, session, peerId);
+        }
+        catch (error) {
+            if (!(error instanceof ExactBatchResponderRefusal))
+                throw error;
+            // `send` rejects in a cancelled scope, which then aborts as before.
+            await session.send({ kind: EXACT_BATCH_FRAME_KIND.REFUSE, assetIndex: EXACT_BATCH_BATCH_INDEX,
+                sequence: 0, payload: new TextEncoder().encode(error.refusal) });
+        }
+    }, stableOptions);
+}
+function validateStart(frame, limit) {
+    validateExactBatchFrame(frame);
+    if (frame.kind !== EXACT_BATCH_FRAME_KIND.REQUEST || frame.assetIndex !== EXACT_BATCH_BATCH_INDEX || frame.sequence !== 0
+        || frame.payload.byteLength > limit)
+        throw new Error('Invalid bounded exact-batch START');
+}
+//# sourceMappingURL=experimental-exact-batch-stream.js.map

package/dist/experimental-exact-batch-stream.js.map

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

package/dist/experimental-exact-batch-wire.d.ts

@@ -0,0 +1,41 @@
+/** Fixed experimental wire contract; registration and authorization belong to the host. */
+export declare const EXACT_BATCH_STREAM_PROTOCOL = "/dkg/experimental/exact-batch-stream/1.0.0";
+/** Fixed experimental profile, not an additional signed request field. */
+export declare const EXACT_BATCH_STREAM_WINDOW_SIZE: 2;
+export declare const EXACT_BATCH_FRAME_KIND: Readonly<{
+    REQUEST: 1;
+    META: 2;
+    DATA: 3;
+    ASSET_END: 4;
+    ACK: 5;
+    BATCH_END: 6;
+    REFUSE: 7;
+}>;
+export declare const EXACT_BATCH_BATCH_INDEX = 255;
+export declare const EXACT_BATCH_FRAME_HEADER_BYTES = 16;
+export declare const EXACT_BATCH_MAX_FRAME_BYTES: number;
+export declare const EXACT_BATCH_MAX_REQUEST_BYTES: number;
+export declare const EXACT_BATCH_MAX_ASSETS = 10;
+export declare const EXACT_BATCH_MAX_CHUNKS_PER_ASSET = 1024;
+/**
+ * `BUSY` (added after the first five) says the responder is alive and could not
+ * admit the request now. A requester built before it rejects the frame as an
+ * unknown refusal, which it handles like the stream reset it got before.
+ */
+export declare const EXACT_BATCH_REFUSALS: readonly ["UNSUPPORTED", "RESOURCE_LIMIT", "SOURCE_CHANGED", "ASSET_MISSING", "DENIED", "BUSY"];
+export type ExactBatchFrameKind = typeof EXACT_BATCH_FRAME_KIND[keyof typeof EXACT_BATCH_FRAME_KIND];
+export type ExactBatchRefusal = typeof EXACT_BATCH_REFUSALS[number];
+export interface ExactBatchFrame {
+    readonly kind: number;
+    readonly assetIndex: number;
+    readonly sequence: number;
+    readonly payload: Uint8Array;
+}
+/** Validate a wire frame without interpreting its asset or compression payload. */
+export declare function validateExactBatchFrame(frame: ExactBatchFrame): void;
+export declare function encodeExactBatchFrame(frame: ExactBatchFrame): Uint8Array;
+/** Incremental header-first parsing: never concatenate unbounded source chunks. */
+export declare function decodeExactBatchFrames(source: AsyncIterable<Uint8Array>, options?: {
+    readonly signal?: AbortSignal;
+}): AsyncGenerator<ExactBatchFrame>;
+//# sourceMappingURL=experimental-exact-batch-wire.d.ts.map

package/dist/experimental-exact-batch-wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"experimental-exact-batch-wire.d.ts","sourceRoot":"","sources":["../src/experimental-exact-batch-wire.ts"],"names":[],"mappings":"AACA,2FAA2F;AAC3F,eAAO,MAAM,2BAA2B,+CAA+C,CAAC;AACxF,0EAA0E;AAC1E,eAAO,MAAM,8BAA8B,EAAG,CAAU,CAAC;AACzD,eAAO,MAAM,sBAAsB;;;;;;;;EAAiG,CAAC;AACrI,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,8BAA8B,KAAK,CAAC;AACjD,eAAO,MAAM,2BAA2B,QAAY,CAAC;AACrD,eAAO,MAAM,6BAA6B,QAAW,CAAC;AACtD,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,iGAAiH,CAAC;AACnJ,MAAM,MAAM,mBAAmB,GAAG,OAAO,sBAAsB,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAC;AACrG,MAAM,MAAM,iBAAiB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;CAC9B;AAwBD,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAGpE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAOxE;AAED,mFAAmF;AACnF,wBAAuB,sBAAsB,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAAG,cAAc,CAAC,eAAe,CAAC,CA8BjK"}

package/dist/experimental-exact-batch-wire.js

@@ -0,0 +1,116 @@
+// SPDX-License-Identifier: Apache-2.0
+/** Fixed experimental wire contract; registration and authorization belong to the host. */
+export const EXACT_BATCH_STREAM_PROTOCOL = '/dkg/experimental/exact-batch-stream/1.0.0';
+/** Fixed experimental profile, not an additional signed request field. */
+export const EXACT_BATCH_STREAM_WINDOW_SIZE = 2;
+export const EXACT_BATCH_FRAME_KIND = Object.freeze({ REQUEST: 1, META: 2, DATA: 3, ASSET_END: 4, ACK: 5, BATCH_END: 6, REFUSE: 7 });
+export const EXACT_BATCH_BATCH_INDEX = 255;
+export const EXACT_BATCH_FRAME_HEADER_BYTES = 16;
+export const EXACT_BATCH_MAX_FRAME_BYTES = 64 * 1024;
+export const EXACT_BATCH_MAX_REQUEST_BYTES = 8 * 1024;
+export const EXACT_BATCH_MAX_ASSETS = 10;
+export const EXACT_BATCH_MAX_CHUNKS_PER_ASSET = 1024;
+const MAGIC = new Uint8Array([68, 75, 66, 49]); // DKB1
+/**
+ * `BUSY` (added after the first five) says the responder is alive and could not
+ * admit the request now. A requester built before it rejects the frame as an
+ * unknown refusal, which it handles like the stream reset it got before.
+ */
+export const EXACT_BATCH_REFUSALS = Object.freeze(['UNSUPPORTED', 'RESOURCE_LIMIT', 'SOURCE_CHANGED', 'ASSET_MISSING', 'DENIED', 'BUSY']);
+function uint(value, max) { return Number.isInteger(value) && value >= 0 && value <= max; }
+function validateHeader(kind, index, sequence, length) {
+    if (!uint(kind, 7) || kind === 0 || !uint(index, 255) || !uint(sequence, 0xffff_ffff) || !uint(length, EXACT_BATCH_MAX_FRAME_BYTES)) {
+        throw new Error('Invalid exact batch frame header');
+    }
+    const batch = kind === EXACT_BATCH_FRAME_KIND.REQUEST || kind === EXACT_BATCH_FRAME_KIND.BATCH_END || kind === EXACT_BATCH_FRAME_KIND.REFUSE;
+    if (batch ? index !== EXACT_BATCH_BATCH_INDEX : index >= EXACT_BATCH_MAX_ASSETS)
+        throw new Error('Invalid exact batch frame index');
+    if (kind === EXACT_BATCH_FRAME_KIND.REQUEST && (sequence !== 0 || length < 1 || length > EXACT_BATCH_MAX_REQUEST_BYTES))
+        throw new Error('Invalid exact batch request');
+    if (kind === EXACT_BATCH_FRAME_KIND.META && (sequence !== 0 || length < 1))
+        throw new Error('Invalid exact batch metadata');
+    if (kind === EXACT_BATCH_FRAME_KIND.DATA && (length < 1 || sequence >= EXACT_BATCH_MAX_CHUNKS_PER_ASSET))
+        throw new Error('Invalid exact batch data frame');
+    if ((kind === EXACT_BATCH_FRAME_KIND.ASSET_END || kind === EXACT_BATCH_FRAME_KIND.ACK || kind === EXACT_BATCH_FRAME_KIND.BATCH_END) && length !== 0)
+        throw new Error('Invalid exact batch control payload');
+    if ((kind === EXACT_BATCH_FRAME_KIND.ASSET_END || kind === EXACT_BATCH_FRAME_KIND.ACK) && (sequence < 1 || sequence > EXACT_BATCH_MAX_CHUNKS_PER_ASSET))
+        throw new Error('Invalid exact batch chunk count');
+    if (kind === EXACT_BATCH_FRAME_KIND.BATCH_END && (sequence < 1 || sequence > EXACT_BATCH_MAX_ASSETS))
+        throw new Error('Invalid exact batch end count');
+    if (kind === EXACT_BATCH_FRAME_KIND.REFUSE && (sequence !== 0 || length < 1 || length > 64))
+        throw new Error('Invalid exact batch refusal');
+}
+function validatePayload(frame) {
+    if (frame.kind === EXACT_BATCH_FRAME_KIND.REFUSE) {
+        const code = new TextDecoder('utf-8', { fatal: true }).decode(frame.payload);
+        if (!EXACT_BATCH_REFUSALS.includes(code))
+            throw new Error('Unknown exact batch refusal');
+    }
+}
+/** Validate a wire frame without interpreting its asset or compression payload. */
+export function validateExactBatchFrame(frame) {
+    if (!(frame.payload instanceof Uint8Array))
+        throw new TypeError('Exact batch payload must be bytes');
+    validateHeader(frame.kind, frame.assetIndex, frame.sequence, frame.payload.byteLength);
+    validatePayload(frame);
+}
+export function encodeExactBatchFrame(frame) {
+    validateExactBatchFrame(frame);
+    const result = new Uint8Array(EXACT_BATCH_FRAME_HEADER_BYTES + frame.payload.byteLength);
+    result.set(MAGIC);
+    const view = new DataView(result.buffer);
+    view.setUint8(4, frame.kind);
+    view.setUint8(5, frame.assetIndex);
+    view.setUint32(8, frame.sequence);
+    view.setUint32(12, frame.payload.byteLength);
+    result.set(frame.payload, EXACT_BATCH_FRAME_HEADER_BYTES);
+    return result;
+}
+/** Incremental header-first parsing: never concatenate unbounded source chunks. */
+export async function* decodeExactBatchFrames(source, options = {}) {
+    const header = new Uint8Array(EXACT_BATCH_FRAME_HEADER_BYTES);
+    let headerBytes = 0, body, bodyBytes = 0;
+    let kind = 0, index = 0, sequence = 0;
+    for await (const chunk of source) {
+        options.signal?.throwIfAborted();
+        if (!(chunk instanceof Uint8Array))
+            throw new TypeError('Exact batch stream must yield bytes');
+        let offset = 0;
+        while (offset < chunk.byteLength) {
+            options.signal?.throwIfAborted();
+            if (body === undefined) {
+                const take = Math.min(header.byteLength - headerBytes, chunk.byteLength - offset);
+                header.set(chunk.subarray(offset, offset + take), headerBytes);
+                headerBytes += take;
+                offset += take;
+                if (headerBytes < header.byteLength)
+                    continue;
+                const view = new DataView(header.buffer);
+                if (!MAGIC.every((byte, i) => header[i] === byte) || view.getUint16(6) !== 0)
+                    throw new Error('Invalid exact batch magic or reserved bits');
+                kind = view.getUint8(4);
+                index = view.getUint8(5);
+                sequence = view.getUint32(8);
+                const length = view.getUint32(12);
+                validateHeader(kind, index, sequence, length);
+                body = new Uint8Array(length);
+                bodyBytes = 0;
+            }
+            const take = Math.min(body.byteLength - bodyBytes, chunk.byteLength - offset);
+            body.set(chunk.subarray(offset, offset + take), bodyBytes);
+            bodyBytes += take;
+            offset += take;
+            if (bodyBytes === body.byteLength) {
+                const frame = Object.freeze({ kind, assetIndex: index, sequence, payload: body });
+                validatePayload(frame);
+                body = undefined;
+                headerBytes = 0;
+                yield frame;
+            }
+        }
+    }
+    options.signal?.throwIfAborted();
+    if (headerBytes !== 0 || body !== undefined)
+        throw new Error('Truncated exact batch stream frame');
+}
+//# sourceMappingURL=experimental-exact-batch-wire.js.map

package/dist/experimental-exact-batch-wire.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types.js';
+export { gzipBounded, gunzipBounded, BoundedGzipLimitError, BoundedGzipCapacityError, type BoundedGzipOptions } from './bounded-gzip.js';
 export * from './constants.js';
 export * from './storage-ack-protocols.js';
 export * from './context-graph-storage-uri.js';
@@ -55,15 +56,19 @@ export * from './backpressure-observability.js';
 export { Logger, createOperationContext, formatLogRecord, type OperationContext, type OperationName, type LogSink, type LogRecord, type LogRecordFormatOptions, type CanonicalLogRecord, type LogLevel, LOG_LEVELS, normalizeLogLevel, } from './logger.js';
 export { KA_LIFECYCLE_ROLES, KA_LIFECYCLE_STAGES, isKaPublishLifecycleDebugLoggingEnabled, logKaLifecycleEvent, resolveKaLifecycleLogDetail, setKaPublishLifecycleDebugLoggingEnabled, type KaLifecycleLogDetail, type KaLifecycleLogEvent, type KaLifecycleLogLevel, type KaLifecycleMetadataValue, type KaLifecycleRole, type KaLifecycleStage, } from './ka-lifecycle-logger.js';
 export { createLogRedactor, redactLogEntry, redactMessage, DEFAULT_SENSITIVE_KEYS, REDACTED } from './log-redaction.js';
+export { createBoundedKeyedLimiter, type BoundedKeyedLimiterOptions } from './bounded-denial-logger.js';
 export type { LogRedactor } from './log-redaction.js';
 export { getTracer, withSpan, linkedSpan, currentTraceIds, activeSpanContext, getMetrics, rebuildMetrics, type WithSpanOpts, type DkgMetrics, } from './telemetry-api.js';
 export * from './crypto/index.js';
 export * from './proto/index.js';
 export { DEFAULT_RELAY_SERVER_CAPACITY, RELAY_CAPACITY_MULTIPLIER, RELAY_DEFAULT_DURATION_LIMIT_MS, RELAY_RESERVATION_TTL_MS, EDGE_NODE_MAX_CONNECTIONS, deriveRelayCaps, validateRelayServerCapacity, type RelayCapacityValidation, type DerivedRelayCaps, DEFAULT_RELAY_RESERVATION_COUNT, MAX_RELAY_RESERVATION_COUNT, validateRelayReservationCount, type RelayReservationCountValidation, } from './relay-capacity-policy.js';
 export { DKGNode, type RelayStats, type RelayReservationDetail, type NetworkTunables, pickNetworkTunables, isPublicLikeAddress, isLocalOrInternalHostname, } from './node.js';
+export { isIpLoopbackAddress, isLocalhostAddress, isLocalhostHostname, isLoopbackAddress, isUnspecifiedAddress, } from './network/address-policy.js';
 export { peerIdFromRelayAddress } from './network-peer-dial-policy.js';
 export { type Network, type PeerConnectionNetwork, type NodeIdentity, type Address, type DialOpts, type PeerConnectOpts, type ProtocolHandler, LibP2PNetwork, canonicalPeerIdString, tryCanonicalPeerIdString, type CanonicalPeerId, type NetworkStateRegistry, StubNetworkStateRegistry, type AgentDirectoryLookup, type PeerResolverDeps, type PeerConnectionOutcome, connectLibp2pCandidate, parseLibp2pConnectCandidate, Libp2pConnectCandidateParseError, type Libp2pConnectCandidate, type Libp2pConnectHost, type PeerResolverLogger, type ResolveOpts, type ConnectOpts, PeerResolver, dkgGossipMsgId, dkgGossipMsgIdRaw, type DkgGossipMsgIdInput, DkgGossipUnsignedMessageError, DkgGossipMissingPublisherError, } from './network/index.js';
-export { ProtocolRouter, QuietRetryableHandlerError, type AdmissionCheckOptions, type ProtocolRegistrationOptions, type ProtocolRouterOptions, type SendOptions, DEFAULT_MAX_READ_BYTES, DEFAULT_SEND_TIMEOUT_MS, isRecoverableSendError, isProtocolUnsupportedError, } from './protocol-router.js';
+export { ProtocolRouter, QuietRetryableHandlerError, type AdmissionCheckOptions, type DuplexStreamOptions, type DuplexStreamRequest, type ProtocolRegistrationOptions, type ProtocolRouterOptions, type SendOptions, DEFAULT_MAX_READ_BYTES, DEFAULT_SEND_TIMEOUT_MS, isRecoverableSendError, isProtocolUnsupportedError, } from './protocol-router.js';
+export { EXPERIMENTAL_EXACT_BATCH_STREAM_PROTOCOL, EXPERIMENTAL_EXACT_BATCH_STREAM_WINDOW_SIZE, exchangeExperimentalExactBatch, registerExperimentalExactBatchResponder, ExperimentalExactBatchUnsupportedError, ExactBatchResponderRefusal, type ExactBatchTransportSession, type ExactBatchTransportOptions, type ExactBatchTransportEvent, type ExactBatchResponderAuthorization, } from './experimental-exact-batch-stream.js';
+export { EXACT_BATCH_STREAM_PROTOCOL, EXACT_BATCH_STREAM_WINDOW_SIZE, EXACT_BATCH_FRAME_KIND, EXACT_BATCH_BATCH_INDEX, EXACT_BATCH_FRAME_HEADER_BYTES, EXACT_BATCH_MAX_FRAME_BYTES, EXACT_BATCH_MAX_REQUEST_BYTES, EXACT_BATCH_MAX_ASSETS, EXACT_BATCH_MAX_CHUNKS_PER_ASSET, EXACT_BATCH_REFUSALS, encodeExactBatchFrame, decodeExactBatchFrames, validateExactBatchFrame, type ExactBatchFrame, type ExactBatchFrameKind, type ExactBatchRefusal, } from './experimental-exact-batch-wire.js';
 export { MessageStreamPool, POOLED_MESSAGE_PROTOCOL, DEFAULT_KEEPALIVE_MS, DEFAULT_IDLE_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, PooledStreamResetError, type MessageStreamPoolOptions, type PooledStreamHandler, type PerPeerStats, type PoolNode, } from './message-stream-pool.js';
 export { FrameType, encodeFrame, encodeVarint, tryDecodeVarint, decodeFrames, DEFAULT_MAX_FRAME_BYTES, type DecodedFrame, } from './message-frame.js';
 export { GossipSubManager, type GossipMessageHandler } from './gossipsub-manager.js';
@@ -83,9 +88,10 @@ export { DEFAULT_SETUP_NETWORK, LEGACY_FALLBACK_NETWORK, SELECTABLE_SETUP_NETWOR
 export { resolveCliPackageDir } from './resolve-cli-package-dir.js';
 export { resolveDkgCli, type ResolvedDkgCli } from './resolve-dkg-cli.js';
 export { startDaemon } from './daemon-lifecycle.js';
-export { assertSafeIri, isSafeIri, sparqlIri, escapeSparqlLiteral, sparqlString, sparqlInt, assertSafeRdfTerm, } from './sparql-safe.js';
+export { assertSafeIri, isSafeIri, sparqlIri, escapeSparqlLiteral, sparqlString, sparqlInt, assertSafeRdfTerm, UnsafeSparqlValueError, } from './sparql-safe.js';
+export { formatIriPrefix, formatSparqlTerm, SparqlTermValidationError, unwrapIri, type SparqlTermContext, type SparqlTermKind, type SparqlTermPosition, } from './sparql-terms.js';
 export { JAVA_WRITE_UTF_MAX_BYTES, DKG_RDF_LITERAL_SAFE_MUTF8_BYTES, OVERSIZED_RDF_LITERAL_ERROR_CODE, OversizedRdfLiteralError, javaModifiedUtf8ByteLength, rdfLiteralTermMutf8ByteLength, isOversizedRdfLiteralError, assertRdfLiteralMutf8Safe, assertQuadLiteralsMutf8Safe, type RdfLiteralSizeContext, type QuadLiteralLike, } from './rdf-literal-size.js';
-export { DKGError, DKGUserError, DKGInternalError, PayloadTooLargeError, SwmGossipPayloadTooLargeError, toErrorMessage, hasErrorCode, NO_FUNDED_PUBLISHER_WALLET_CODE, NO_FUNDED_PUBLISHER_WALLET_MESSAGE_PREFIX, PUBLISH_AUTHOR_NOT_CUSTODIAL_CODE, PUBLISH_AUTHOR_NOT_CUSTODIAL_MESSAGE_MARKER, AMBIGUOUS_ASSERTION_AUTHOR_CODE, ASSERTION_AUTHOR_NOT_RESIDENT_CODE, PUBLISH_AUTHOR_SELECTION_CONFLICT_CODE, messageIndicatesNoFundedPublisherWallet, messageIndicatesPublishAuthorNotCustodial, formatPublishAuthorNotCustodialMessage, } from './errors.js';
+export { DKGError, DKGUserError, DKGInternalError, PayloadTooLargeError, SwmGossipPayloadTooLargeError, toErrorMessage, hasErrorCode, NO_FUNDED_PUBLISHER_WALLET_CODE, NO_FUNDED_PUBLISHER_WALLET_MESSAGE_PREFIX, PUBLISH_AUTHOR_NOT_CUSTODIAL_CODE, PUBLISH_AUTHOR_NOT_CUSTODIAL_MESSAGE_MARKER, AMBIGUOUS_ASSERTION_AUTHOR_CODE, ASSERTION_AUTHOR_NOT_RESIDENT_CODE, PUBLISH_AUTHOR_SELECTION_CONFLICT_CODE, RFC64_LEGACY_SWM_BOUNDARY_RETIREMENT_IN_PROGRESS_CODE, isRfc64LegacySwmBoundaryRetirementInProgressError, UNSCOPED_QUERY_INVALIDATED_CODE, UNSCOPED_QUERY_INVALIDATED_MESSAGE, messageIndicatesNoFundedPublisherWallet, messageIndicatesPublishAuthorNotCustodial, formatPublishAuthorNotCustodialMessage, } from './errors.js';
 export { dkgHomeDir, resolveDkgConfigHome, dkgAuthTokenPath, isDkgMonorepoRoot, findDkgMonorepoRoot, resolveDkgHome, readDaemonPid, isProcessAlive, readDkgApiPort, loadAuthTokenSync, loadAuthToken, toEip55Checksum, } from './dkg-home.js';
 export { type Quad as ExtractionQuad, type ExtractionInput, type ConverterOutput, type ExtractionOutput, type ExtractionPipeline, ExtractionPipelineRegistry, } from './extraction-pipeline.js';
 export * from './transducers.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './types.js';
+export { gzipBounded, gunzipBounded, BoundedGzipLimitError, BoundedGzipCapacityError } from './bounded-gzip.js';
 export * from './constants.js';
 export * from './storage-ack-protocols.js';
 export * from './context-graph-storage-uri.js';
@@ -54,6 +55,7 @@ export * from './backpressure-observability.js';
 export { Logger, createOperationContext, formatLogRecord, LOG_LEVELS, normalizeLogLevel, } from './logger.js';
 export { KA_LIFECYCLE_ROLES, KA_LIFECYCLE_STAGES, isKaPublishLifecycleDebugLoggingEnabled, logKaLifecycleEvent, resolveKaLifecycleLogDetail, setKaPublishLifecycleDebugLoggingEnabled, } from './ka-lifecycle-logger.js';
 export { createLogRedactor, redactLogEntry, redactMessage, DEFAULT_SENSITIVE_KEYS, REDACTED } from './log-redaction.js';
+export { createBoundedKeyedLimiter } from './bounded-denial-logger.js';
 export { getTracer, withSpan, linkedSpan, currentTraceIds, activeSpanContext, getMetrics, rebuildMetrics, } from './telemetry-api.js';
 export * from './crypto/index.js';
 export * from './proto/index.js';
@@ -69,6 +71,7 @@ export { DKGNode, pickNetworkTunables,
 // advertise as `dkg:multiaddr` so peers don't learn RFC1918/CGNAT
 // entries from the phonebook).
 isPublicLikeAddress, isLocalOrInternalHostname, } from './node.js';
+export { isIpLoopbackAddress, isLocalhostAddress, isLocalhostHostname, isLoopbackAddress, isUnspecifiedAddress, } from './network/address-policy.js';
 // Transport-level network isolation. `peerIdFromRelayAddress` is shared with
 // the CLI, which derives other-network relay ids from bundled network configs.
 export { peerIdFromRelayAddress } from './network-peer-dial-policy.js';
@@ -86,6 +89,9 @@ export { peerIdFromRelayAddress } from './network-peer-dial-policy.js';
 // deep-import it from `../src/node.js`.
 export { LibP2PNetwork, canonicalPeerIdString, tryCanonicalPeerIdString, StubNetworkStateRegistry, connectLibp2pCandidate, parseLibp2pConnectCandidate, Libp2pConnectCandidateParseError, PeerResolver, dkgGossipMsgId, dkgGossipMsgIdRaw, DkgGossipUnsignedMessageError, DkgGossipMissingPublisherError, } from './network/index.js';
 export { ProtocolRouter, QuietRetryableHandlerError, DEFAULT_MAX_READ_BYTES, DEFAULT_SEND_TIMEOUT_MS, isRecoverableSendError, isProtocolUnsupportedError, } from './protocol-router.js';
+// Explicit experimental capability only; importing Core installs no handler.
+export { EXPERIMENTAL_EXACT_BATCH_STREAM_PROTOCOL, EXPERIMENTAL_EXACT_BATCH_STREAM_WINDOW_SIZE, exchangeExperimentalExactBatch, registerExperimentalExactBatchResponder, ExperimentalExactBatchUnsupportedError, ExactBatchResponderRefusal, } from './experimental-exact-batch-stream.js';
+export { EXACT_BATCH_STREAM_PROTOCOL, EXACT_BATCH_STREAM_WINDOW_SIZE, EXACT_BATCH_FRAME_KIND, EXACT_BATCH_BATCH_INDEX, EXACT_BATCH_FRAME_HEADER_BYTES, EXACT_BATCH_MAX_FRAME_BYTES, EXACT_BATCH_MAX_REQUEST_BYTES, EXACT_BATCH_MAX_ASSETS, EXACT_BATCH_MAX_CHUNKS_PER_ASSET, EXACT_BATCH_REFUSALS, encodeExactBatchFrame, decodeExactBatchFrames, validateExactBatchFrame, } from './experimental-exact-batch-wire.js';
 export { MessageStreamPool, POOLED_MESSAGE_PROTOCOL, DEFAULT_KEEPALIVE_MS, DEFAULT_IDLE_TIMEOUT_MS, DEFAULT_REQUEST_TIMEOUT_MS, PooledStreamResetError, } from './message-stream-pool.js';
 export { FrameType, encodeFrame, encodeVarint, tryDecodeVarint, decodeFrames, DEFAULT_MAX_FRAME_BYTES, } from './message-frame.js';
 export { GossipSubManager } from './gossipsub-manager.js';
@@ -105,9 +111,10 @@ export { DEFAULT_SETUP_NETWORK, LEGACY_FALLBACK_NETWORK, SELECTABLE_SETUP_NETWOR
 export { resolveCliPackageDir } from './resolve-cli-package-dir.js';
 export { resolveDkgCli } from './resolve-dkg-cli.js';
 export { startDaemon } from './daemon-lifecycle.js';
-export { assertSafeIri, isSafeIri, sparqlIri, escapeSparqlLiteral, sparqlString, sparqlInt, assertSafeRdfTerm, } from './sparql-safe.js';
+export { assertSafeIri, isSafeIri, sparqlIri, escapeSparqlLiteral, sparqlString, sparqlInt, assertSafeRdfTerm, UnsafeSparqlValueError, } from './sparql-safe.js';
+export { formatIriPrefix, formatSparqlTerm, SparqlTermValidationError, unwrapIri, } from './sparql-terms.js';
 export { JAVA_WRITE_UTF_MAX_BYTES, DKG_RDF_LITERAL_SAFE_MUTF8_BYTES, OVERSIZED_RDF_LITERAL_ERROR_CODE, OversizedRdfLiteralError, javaModifiedUtf8ByteLength, rdfLiteralTermMutf8ByteLength, isOversizedRdfLiteralError, assertRdfLiteralMutf8Safe, assertQuadLiteralsMutf8Safe, } from './rdf-literal-size.js';
-export { DKGError, DKGUserError, DKGInternalError, PayloadTooLargeError, SwmGossipPayloadTooLargeError, toErrorMessage, hasErrorCode, NO_FUNDED_PUBLISHER_WALLET_CODE, NO_FUNDED_PUBLISHER_WALLET_MESSAGE_PREFIX, PUBLISH_AUTHOR_NOT_CUSTODIAL_CODE, PUBLISH_AUTHOR_NOT_CUSTODIAL_MESSAGE_MARKER, AMBIGUOUS_ASSERTION_AUTHOR_CODE, ASSERTION_AUTHOR_NOT_RESIDENT_CODE, PUBLISH_AUTHOR_SELECTION_CONFLICT_CODE, messageIndicatesNoFundedPublisherWallet, messageIndicatesPublishAuthorNotCustodial, formatPublishAuthorNotCustodialMessage, } from './errors.js';
+export { DKGError, DKGUserError, DKGInternalError, PayloadTooLargeError, SwmGossipPayloadTooLargeError, toErrorMessage, hasErrorCode, NO_FUNDED_PUBLISHER_WALLET_CODE, NO_FUNDED_PUBLISHER_WALLET_MESSAGE_PREFIX, PUBLISH_AUTHOR_NOT_CUSTODIAL_CODE, PUBLISH_AUTHOR_NOT_CUSTODIAL_MESSAGE_MARKER, AMBIGUOUS_ASSERTION_AUTHOR_CODE, ASSERTION_AUTHOR_NOT_RESIDENT_CODE, PUBLISH_AUTHOR_SELECTION_CONFLICT_CODE, RFC64_LEGACY_SWM_BOUNDARY_RETIREMENT_IN_PROGRESS_CODE, isRfc64LegacySwmBoundaryRetirementInProgressError, UNSCOPED_QUERY_INVALIDATED_CODE, UNSCOPED_QUERY_INVALIDATED_MESSAGE, messageIndicatesNoFundedPublisherWallet, messageIndicatesPublishAuthorNotCustodial, formatPublishAuthorNotCustodialMessage, } from './errors.js';
 export { dkgHomeDir, resolveDkgConfigHome, dkgAuthTokenPath, isDkgMonorepoRoot, findDkgMonorepoRoot, resolveDkgHome, readDaemonPid, isProcessAlive, readDkgApiPort, loadAuthTokenSync, loadAuthToken, toEip55Checksum, } from './dkg-home.js';
 export { ExtractionPipelineRegistry, } from './extraction-pipeline.js';
 export * from './transducers.js';