@heojeongbo/wirestage 0.0.0-stage → 0.1.0

package/dist/shared/lib/envelope/envelope.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The length-prefixed message framing that gRPC, gRPC-web and Connect
+ * streaming share: one flag byte, a 4-byte big-endian length, the payload.
+ *
+ * Every hand-written gRPC-web stub ends up re-deriving this; getting the
+ * trailer bit or the length endianness wrong produces a response the client
+ * rejects with an error that names neither.
+ */
+export declare const EnvelopeFlag: {
+    /** gRPC / gRPC-web / Connect: the payload is compressed. */
+    readonly compressed: 1;
+    /** Connect streaming: the payload is the end-of-stream JSON. */
+    readonly endStream: 2;
+    /** gRPC-web: the payload is the trailer block, not a message. */
+    readonly trailer: 128;
+};
+export interface Envelope {
+    readonly flags: number;
+    readonly data: Uint8Array;
+}
+export declare function encodeEnvelope(flags: number, data: Uint8Array): Uint8Array;
+export declare function encodeEnvelopes(envelopes: readonly Envelope[]): Uint8Array;
+export interface EnvelopeReader {
+    /** Feed bytes; returns every envelope they complete, in order. */
+    push(chunk: Uint8Array): Envelope[];
+    /** Bytes held back because they do not complete an envelope yet. */
+    readonly buffered: number;
+}
+/**
+ * Incremental reader for a byte stream that may split an envelope anywhere,
+ * including inside the 5-byte header — which is exactly how HTTP chunking
+ * delivers a long server stream.
+ *
+ * Chunks that do not complete an envelope are kept as they came and joined
+ * only once it is complete, so a large message arriving in small chunks is
+ * copied once, not once per chunk.
+ */
+export declare function createEnvelopeReader(): EnvelopeReader;
+/** Decode a complete body. `rest` holds a truncated tail, if any. */
+export declare function decodeEnvelopes(bytes: Uint8Array): {
+    readonly envelopes: Envelope[];
+    readonly rest: number;
+};
+/**
+ * Parse a gRPC-web trailer block (`name: value\r\n` lines). Names are
+ * lower-cased; HTTP/1.1 header names are case-insensitive and gRPC-web
+ * servers disagree on the spelling.
+ */
+export declare function parseTrailerBlock(data: Uint8Array): Record<string, string>;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/shared/lib/envelope/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/envelope/envelope.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;IACxB,4DAA4D;;IAE5D,gEAAgE;;IAEhE,iEAAiE;;CAExD,CAAC;AAEX,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC1B;AAID,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,UAAU,CAM1E;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,UAAU,CAE1E;AAED,MAAM,WAAW,cAAc;IAC9B,kEAAkE;IAClE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,EAAE,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAmDrD;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG;IACnD,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB,CAIA;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU1E"}

package/dist/shared/lib/envelope/envelope.js

@@ -0,0 +1,111 @@
+import { concatBytes, utf8 } from "../bytes/index.js";
+/**
+ * The length-prefixed message framing that gRPC, gRPC-web and Connect
+ * streaming share: one flag byte, a 4-byte big-endian length, the payload.
+ *
+ * Every hand-written gRPC-web stub ends up re-deriving this; getting the
+ * trailer bit or the length endianness wrong produces a response the client
+ * rejects with an error that names neither.
+ */
+export const EnvelopeFlag = {
+    /** gRPC / gRPC-web / Connect: the payload is compressed. */
+    compressed: 0b0000_0001,
+    /** Connect streaming: the payload is the end-of-stream JSON. */
+    endStream: 0b0000_0010,
+    /** gRPC-web: the payload is the trailer block, not a message. */
+    trailer: 0b1000_0000,
+};
+const HEADER = 5;
+export function encodeEnvelope(flags, data) {
+    const out = new Uint8Array(HEADER + data.byteLength);
+    out[0] = flags;
+    new DataView(out.buffer).setUint32(1, data.byteLength, false);
+    out.set(data, HEADER);
+    return out;
+}
+export function encodeEnvelopes(envelopes) {
+    return concatBytes(envelopes.map((e) => encodeEnvelope(e.flags, e.data)));
+}
+/**
+ * Incremental reader for a byte stream that may split an envelope anywhere,
+ * including inside the 5-byte header — which is exactly how HTTP chunking
+ * delivers a long server stream.
+ *
+ * Chunks that do not complete an envelope are kept as they came and joined
+ * only once it is complete, so a large message arriving in small chunks is
+ * copied once, not once per chunk.
+ */
+export function createEnvelopeReader() {
+    let pending = [];
+    let buffered = 0;
+    /** Whether the pending chunks hold at least one whole envelope. */
+    const complete = () => {
+        if (buffered < HEADER)
+            return false;
+        // The header may itself straddle chunks: gather just those five bytes.
+        const header = new Uint8Array(HEADER);
+        let filled = 0;
+        for (const chunk of pending) {
+            const part = chunk.subarray(0, HEADER - filled);
+            header.set(part, filled);
+            filled += part.byteLength;
+            if (filled === HEADER)
+                break;
+        }
+        const length = new DataView(header.buffer).getUint32(1, false);
+        return buffered >= HEADER + length;
+    };
+    return {
+        push(chunk) {
+            pending.push(chunk);
+            buffered += chunk.byteLength;
+            if (!complete())
+                return [];
+            const bytes = concatBytes(pending);
+            const out = [];
+            let offset = 0;
+            while (bytes.byteLength - offset >= HEADER) {
+                const view = new DataView(bytes.buffer, bytes.byteOffset + offset, HEADER);
+                const length = view.getUint32(1, false);
+                if (bytes.byteLength - offset - HEADER < length)
+                    break;
+                out.push({
+                    flags: view.getUint8(0),
+                    data: bytes.subarray(offset + HEADER, offset + HEADER + length),
+                });
+                offset += HEADER + length;
+            }
+            const rest = bytes.subarray(offset);
+            pending = rest.byteLength === 0 ? [] : [rest];
+            buffered = rest.byteLength;
+            return out;
+        },
+        get buffered() {
+            return buffered;
+        },
+    };
+}
+/** Decode a complete body. `rest` holds a truncated tail, if any. */
+export function decodeEnvelopes(bytes) {
+    const reader = createEnvelopeReader();
+    const envelopes = reader.push(bytes);
+    return { envelopes, rest: reader.buffered };
+}
+/**
+ * Parse a gRPC-web trailer block (`name: value\r\n` lines). Names are
+ * lower-cased; HTTP/1.1 header names are case-insensitive and gRPC-web
+ * servers disagree on the spelling.
+ */
+export function parseTrailerBlock(data) {
+    const out = {};
+    for (const line of utf8(data).split(/\r?\n/)) {
+        const colon = line.indexOf(":");
+        if (colon <= 0)
+            continue;
+        out[line.slice(0, colon).trim().toLowerCase()] = line
+            .slice(colon + 1)
+            .trim();
+    }
+    return out;
+}
+//# sourceMappingURL=envelope.js.map

package/dist/shared/lib/envelope/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../../src/shared/lib/envelope/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,4DAA4D;IAC5D,UAAU,EAAE,WAAW;IACvB,gEAAgE;IAChE,SAAS,EAAE,WAAW;IACtB,iEAAiE;IACjE,OAAO,EAAE,WAAW;CACX,CAAC;AAOX,MAAM,MAAM,GAAG,CAAC,CAAC;AAEjB,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,IAAgB;IAC7D,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACf,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC9D,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtB,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAA8B;IAC7D,OAAO,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AASD;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB;IACnC,IAAI,OAAO,GAAiB,EAAE,CAAC;IAC/B,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,mEAAmE;IACnE,MAAM,QAAQ,GAAG,GAAY,EAAE;QAC9B,IAAI,QAAQ,GAAG,MAAM;YAAE,OAAO,KAAK,CAAC;QACpC,uEAAuE;QACvE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzB,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC;YAC1B,IAAI,MAAM,KAAK,MAAM;gBAAE,MAAM;QAC9B,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC/D,OAAO,QAAQ,IAAI,MAAM,GAAG,MAAM,CAAC;IACpC,CAAC,CAAC;IAEF,OAAO;QACN,IAAI,CAAC,KAAK;YACT,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC;YAC7B,IAAI,CAAC,QAAQ,EAAE;gBAAE,OAAO,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACnC,MAAM,GAAG,GAAe,EAAE,CAAC;YAC3B,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,OAAO,KAAK,CAAC,UAAU,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;gBAC5C,MAAM,IAAI,GAAG,IAAI,QAAQ,CACxB,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,GAAG,MAAM,EACzB,MAAM,CACN,CAAC;gBACF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBACxC,IAAI,KAAK,CAAC,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;oBAAE,MAAM;gBACvD,GAAG,CAAC,IAAI,CAAC;oBACR,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;oBACvB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;iBAC/D,CAAC,CAAC;gBACH,MAAM,IAAI,MAAM,GAAG,MAAM,CAAC;YAC3B,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpC,OAAO,GAAG,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9C,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC;YAC3B,OAAO,GAAG,CAAC;QACZ,CAAC;QACD,IAAI,QAAQ;YACX,OAAO,QAAQ,CAAC;QACjB,CAAC;KACD,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,KAAiB;IAIhD,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IACjD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QACzB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,IAAI;aACnD,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;aAChB,IAAI,EAAE,CAAC;IACV,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/shared/lib/envelope/index.d.ts

@@ -0,0 +1,3 @@
+export type { Envelope, EnvelopeReader } from "./envelope.js";
+export { createEnvelopeReader, decodeEnvelopes, EnvelopeFlag, encodeEnvelope, encodeEnvelopes, parseTrailerBlock, } from "./envelope.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/lib/envelope/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/envelope/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EACN,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,iBAAiB,GACjB,MAAM,eAAe,CAAC"}

package/dist/shared/lib/envelope/index.js

@@ -0,0 +1,2 @@
+export { createEnvelopeReader, decodeEnvelopes, EnvelopeFlag, encodeEnvelope, encodeEnvelopes, parseTrailerBlock, } from "./envelope.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/lib/envelope/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/lib/envelope/index.ts"],"names":[],"mappings":"AACA,OAAO,EACN,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,iBAAiB,GACjB,MAAM,eAAe,CAAC"}

package/dist/shared/lib/errors/index.d.ts

@@ -0,0 +1,3 @@
+export type { WirestageErrorCode, WirestageErrorOptions, } from "./wirestage-error.js";
+export { isWirestageError, WirestageError } from "./wirestage-error.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/lib/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/errors/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,kBAAkB,EAClB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/shared/lib/errors/index.js

@@ -0,0 +1,2 @@
+export { isWirestageError, WirestageError } from "./wirestage-error.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/lib/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/lib/errors/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/shared/lib/errors/wirestage-error.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Every failure the library raises on purpose carries a code, so a test can
+ * assert on the kind of failure instead of on message text that will change.
+ */
+export type WirestageErrorCode = 
+/** A caller passed something the API cannot work with. */
+"INVALID_ARGUMENT"
+/** The call is valid but not now: before attach, after dispose, twice. */
+ | "INVALID_STATE"
+/** A wait ran out of time. The message lists what did arrive. */
+ | "TIMEOUT"
+/** The environment cannot do this, e.g. a live stream on an https page without TLS. */
+ | "UNSUPPORTED"
+/** The stream, connection or stage this call needs has already closed. */
+ | "CLOSED";
+export interface WirestageErrorOptions {
+    readonly cause?: unknown;
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+export declare class WirestageError extends Error {
+    readonly name = "WirestageError";
+    readonly code: WirestageErrorCode;
+    readonly details: Readonly<Record<string, unknown>>;
+    constructor(code: WirestageErrorCode, message: string, options?: WirestageErrorOptions);
+}
+/** True when `value` is a WirestageError, optionally of one code. */
+export declare function isWirestageError(value: unknown, code?: WirestageErrorCode): value is WirestageError;
+//# sourceMappingURL=wirestage-error.d.ts.map

package/dist/shared/lib/errors/wirestage-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wirestage-error.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/errors/wirestage-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,kBAAkB;AAC7B,0DAA0D;AACxD,kBAAkB;AACpB,0EAA0E;GACxE,eAAe;AACjB,iEAAiE;GAC/D,SAAS;AACX,uFAAuF;GACrF,aAAa;AACf,0EAA0E;GACxE,QAAQ,CAAC;AAEZ,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,qBAAa,cAAe,SAAQ,KAAK;IACxC,SAAkB,IAAI,oBAAoB;IAC1C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;gBAGnD,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,qBAA0B;CASpC;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE,kBAAkB,GACvB,KAAK,IAAI,cAAc,CAKzB"}

package/dist/shared/lib/errors/wirestage-error.js

@@ -0,0 +1,16 @@
+export class WirestageError extends Error {
+    name = "WirestageError";
+    code;
+    details;
+    constructor(code, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.code = code;
+        this.details = options.details ?? {};
+    }
+}
+/** True when `value` is a WirestageError, optionally of one code. */
+export function isWirestageError(value, code) {
+    return (value instanceof WirestageError &&
+        (code === undefined || value.code === code));
+}
+//# sourceMappingURL=wirestage-error.js.map

package/dist/shared/lib/errors/wirestage-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wirestage-error.js","sourceRoot":"","sources":["../../../../src/shared/lib/errors/wirestage-error.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,cAAe,SAAQ,KAAK;IACtB,IAAI,GAAG,gBAAgB,CAAC;IACjC,IAAI,CAAqB;IACzB,OAAO,CAAoC;IAEpD,YACC,IAAwB,EACxB,OAAe,EACf,UAAiC,EAAE;QAEnC,KAAK,CACJ,OAAO,EACP,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAClE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,CAAC;CACD;AAED,qEAAqE;AACrE,MAAM,UAAU,gBAAgB,CAC/B,KAAc,EACd,IAAyB;IAEzB,OAAO,CACN,KAAK,YAAY,cAAc;QAC/B,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAC3C,CAAC;AACH,CAAC"}

package/dist/shared/lib/id/id.d.ts

@@ -0,0 +1,10 @@
+/** `prefix1`, `prefix2`, ... — short ids that read well in a frame dump. */
+export declare function createSequence(prefix: string): () => string;
+/**
+ * A stable id per object, without holding the object alive: a closed page
+ * must be collectable even though its frames still name it.
+ */
+export declare function createObjectIds<T extends object>(prefix: string): (value: T) => string;
+/** An unguessable token, for URLs a page could otherwise stumble onto. */
+export declare function randomToken(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/shared/lib/id/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/id/id.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,MAAM,CAG3D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC/C,MAAM,EAAE,MAAM,GACZ,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAWtB;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,IAAI,MAAM,CAEpC"}

package/dist/shared/lib/id/id.js

@@ -0,0 +1,26 @@
+/** `prefix1`, `prefix2`, ... — short ids that read well in a frame dump. */
+export function createSequence(prefix) {
+    let next = 0;
+    return () => `${prefix}${++next}`;
+}
+/**
+ * A stable id per object, without holding the object alive: a closed page
+ * must be collectable even though its frames still name it.
+ */
+export function createObjectIds(prefix) {
+    const ids = new WeakMap();
+    const nextId = createSequence(prefix);
+    return (value) => {
+        let id = ids.get(value);
+        if (id === undefined) {
+            id = nextId();
+            ids.set(value, id);
+        }
+        return id;
+    };
+}
+/** An unguessable token, for URLs a page could otherwise stumble onto. */
+export function randomToken() {
+    return crypto.randomUUID().replaceAll("-", "");
+}
+//# sourceMappingURL=id.js.map

package/dist/shared/lib/id/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../../src/shared/lib/id/id.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,MAAc;IAC5C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,GAAG,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC9B,MAAc;IAEd,MAAM,GAAG,GAAG,IAAI,OAAO,EAAa,CAAC;IACrC,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,KAAK,EAAE,EAAE;QAChB,IAAI,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACtB,EAAE,GAAG,MAAM,EAAE,CAAC;YACd,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,EAAE,CAAC;IACX,CAAC,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,WAAW;IAC1B,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/shared/lib/id/index.d.ts

@@ -0,0 +1,2 @@
+export { createObjectIds, createSequence, randomToken } from "./id.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/lib/id/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/id/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/shared/lib/id/index.js

@@ -0,0 +1,2 @@
+export { createObjectIds, createSequence, randomToken } from "./id.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/lib/id/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/lib/id/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/shared/lib/logger/index.d.ts

@@ -0,0 +1,3 @@
+export type { LogFields, LogScope, LogThreshold, ScopedLogger, } from "./logger.js";
+export { createScopedLogger, getLogThreshold, parseLogThreshold, setLogThreshold, } from "./logger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/lib/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/logger/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,YAAY,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,eAAe,GACf,MAAM,aAAa,CAAC"}

package/dist/shared/lib/logger/index.js

@@ -0,0 +1,2 @@
+export { createScopedLogger, getLogThreshold, parseLogThreshold, setLogThreshold, } from "./logger.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/lib/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/lib/logger/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACN,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,eAAe,GACf,MAAM,aAAa,CAAC"}

package/dist/shared/lib/logger/logger.d.ts

@@ -0,0 +1,46 @@
+import { type LogLevel } from "@heojeongbo/log-palette";
+/**
+ * The library's logging surface, and the only module that imports log-palette.
+ *
+ * The loggers are the library's own. log-palette also keeps a process-wide
+ * registry (`getLogger`, `setGlobalLevel`, `disableAll`, `configure`) that an
+ * app or a test suite using the same package shares; going through it would
+ * let importing this library change the level of loggers that are not its
+ * own, so nothing here touches it.
+ *
+ * Output goes to the test runner's stdout. Node ignores the `%c` styling
+ * log-palette emits, so the badge reads as plain `[...Stage]` text there.
+ */
+/**
+ * The stage's own subsystems, plus whatever scope a plugin brings. The
+ * built-in names are spelled out so `"Http"` and `"HTTP"` cannot become two
+ * badges for one subsystem; eight characters fit the badge column, and a
+ * longer scope is cut to fit.
+ */
+export type LogScope = "Stage" | "Http" | "Socket" | "Stream" | "Page" | "Connect" | "Rest" | "Sse" | "Ws" | "Rtc" | "Fixture" | "Plugin" | (string & {});
+/** A level, or `silent` for no output at all. */
+export type LogThreshold = LogLevel | "silent";
+export type LogFields = Readonly<Record<string, unknown>>;
+export interface ScopedLogger {
+    debug(message: string, fields?: LogFields, error?: unknown): void;
+    info(message: string, fields?: LogFields, error?: unknown): void;
+    warn(message: string, fields?: LogFields, error?: unknown): void;
+    error(message: string, fields?: LogFields, error?: unknown): void;
+    /**
+     * Log without paying for `build` when the level would drop the line.
+     * log-palette checks the level inside its emit, so arguments are built
+     * even for a dropped `debug` — a frame dump on every request adds up.
+     */
+    lazy(level: LogLevel, message: string, build: () => LogFields): void;
+}
+/**
+ * The default is `warn`: a test suite's output is for the test results, and
+ * the library only speaks up when something is wrong. `WIRESTAGE_LOG=debug`
+ * (read by the Playwright fixture) turns the rest on.
+ */
+export declare function setLogThreshold(next: LogThreshold): void;
+export declare function getLogThreshold(): LogThreshold;
+/** Parse an environment value. Unknown values return `undefined`, never throw. */
+export declare function parseLogThreshold(value: string | undefined): LogThreshold | undefined;
+export declare function createScopedLogger(scope: LogScope): ScopedLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/shared/lib/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEtE;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GACjB,OAAO,GACP,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,SAAS,GACT,MAAM,GACN,KAAK,GACL,IAAI,GACJ,KAAK,GACL,SAAS,GACT,QAAQ,GACR,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEjB,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/C,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACjE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClE;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;CACrE;AAsBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAGxD;AAED,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,YAAY,GAAG,SAAS,CAK1B;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,YAAY,CA2BhE"}

package/dist/shared/lib/logger/logger.js

@@ -0,0 +1,67 @@
+import { createLogger } from "@heojeongbo/log-palette";
+const RANK = {
+    debug: 0,
+    log: 1,
+    info: 2,
+    warn: 3,
+    error: 4,
+    silent: 5,
+};
+/** One logger per scope, so a scope's badge colour is stable. */
+const loggers = new Map();
+let threshold = "warn";
+function apply(logger) {
+    logger.setEnabled(threshold !== "silent");
+    if (threshold !== "silent")
+        logger.setLevel(threshold);
+}
+/**
+ * The default is `warn`: a test suite's output is for the test results, and
+ * the library only speaks up when something is wrong. `WIRESTAGE_LOG=debug`
+ * (read by the Playwright fixture) turns the rest on.
+ */
+export function setLogThreshold(next) {
+    threshold = next;
+    for (const logger of loggers.values())
+        apply(logger);
+}
+export function getLogThreshold() {
+    return threshold;
+}
+/** Parse an environment value. Unknown values return `undefined`, never throw. */
+export function parseLogThreshold(value) {
+    const normalized = value?.trim().toLowerCase();
+    return normalized !== undefined && normalized in RANK
+        ? normalized
+        : undefined;
+}
+export function createScopedLogger(scope) {
+    let base = loggers.get(scope);
+    if (base === undefined) {
+        base = createLogger(scope);
+        apply(base);
+        loggers.set(scope, base);
+    }
+    const palette = base;
+    const emit = (level) => (message, fields, error) => {
+        const args = [message];
+        if (fields !== undefined)
+            args.push(fields);
+        // The error goes last and raw, so the stack survives.
+        if (error !== undefined)
+            args.push(error);
+        palette[level](...args);
+    };
+    return {
+        debug: emit("debug"),
+        info: emit("info"),
+        warn: emit("warn"),
+        error: emit("error"),
+        lazy(level, message, build) {
+            if (RANK[level] < RANK[threshold])
+                return;
+            palette[level](message, build());
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/shared/lib/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../src/shared/lib/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiB,MAAM,yBAAyB,CAAC;AAsDtE,MAAM,IAAI,GAAiC;IAC1C,KAAK,EAAE,CAAC;IACR,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACT,CAAC;AAIF,iEAAiE;AACjE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;AAC3C,IAAI,SAAS,GAAiB,MAAM,CAAC;AAErC,SAAS,KAAK,CAAC,MAAe;IAC7B,MAAM,CAAC,UAAU,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC;IAC1C,IAAI,SAAS,KAAK,QAAQ;QAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB;IACjD,SAAS,GAAG,IAAI,CAAC;IACjB,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,eAAe;IAC9B,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,iBAAiB,CAChC,KAAyB;IAEzB,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/C,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,IAAI,IAAI;QACpD,CAAC,CAAE,UAA2B;QAC9B,CAAC,CAAC,SAAS,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAe;IACjD,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC;IACrB,MAAM,IAAI,GACT,CAAC,KAAe,EAAE,EAAE,CACpB,CAAC,OAAe,EAAE,MAAkB,EAAE,KAAe,EAAQ,EAAE;QAC9D,MAAM,IAAI,GAAc,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,sDAAsD;QACtD,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;IACH,OAAO;QACN,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;QACpB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;QACpB,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK;YACzB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;gBAAE,OAAO;YAC1C,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAClC,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/shared/lib/match/index.d.ts

@@ -0,0 +1,3 @@
+export type { GlobSource, UrlMatcher } from "./url-matcher.js";
+export { compileUrlMatcher, globSource, globToRegExp, } from "./url-matcher.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/lib/match/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/match/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EACN,iBAAiB,EACjB,UAAU,EACV,YAAY,GACZ,MAAM,kBAAkB,CAAC"}

package/dist/shared/lib/match/index.js

@@ -0,0 +1,2 @@
+export { compileUrlMatcher, globSource, globToRegExp, } from "./url-matcher.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/lib/match/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared/lib/match/index.ts"],"names":[],"mappings":"AACA,OAAO,EACN,iBAAiB,EACjB,UAAU,EACV,YAAY,GACZ,MAAM,kBAAkB,CAAC"}

package/dist/shared/lib/match/url-matcher.d.ts

@@ -0,0 +1,27 @@
+/**
+ * What a rule matches: a glob, a RegExp over the full URL, or a predicate.
+ *
+ * Globs follow Playwright's routing semantics (`*` stops at `/`, `**` does
+ * not, a `**` directory may be absent, `{a,b}` alternates), with one
+ * addition: a glob that starts with `/` matches the PATH on any origin, and
+ * so ignores the query. A stub for `/api/...` means the same thing on the
+ * dev server, the preview build and CI, whose origins all differ.
+ */
+export type UrlMatcher = string | RegExp | ((url: URL) => boolean);
+export declare function compileUrlMatcher(matcher: UrlMatcher): (url: URL) => boolean;
+/** Translate a glob into an anchored RegExp. */
+export declare function globToRegExp(glob: string): RegExp;
+/** A glob as RegExp source (unanchored), and the params it captures, in order. */
+export interface GlobSource {
+    readonly source: string;
+    readonly params: readonly string[];
+}
+/**
+ * The RegExp source of a glob. With `params`, a `:name` (a letter or `_`,
+ * then word characters) matches one segment and captures it: the routes of a
+ * REST plugin, in the same glob language as every other pattern.
+ */
+export declare function globSource(glob: string, options?: {
+    readonly params?: boolean;
+}): GlobSource;
+//# sourceMappingURL=url-matcher.d.ts.map

package/dist/shared/lib/match/url-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-matcher.d.ts","sourceRoot":"","sources":["../../../../src/shared/lib/match/url-matcher.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;AAEnE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAmB5E;AAKD,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,kFAAkF;AAClF,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,UAAU,CA8CZ"}

package/dist/shared/lib/match/url-matcher.js

@@ -0,0 +1,88 @@
+import { WirestageError } from "../errors/index.js";
+export function compileUrlMatcher(matcher) {
+    if (typeof matcher === "function")
+        return matcher;
+    if (matcher instanceof RegExp) {
+        return (url) => {
+            // A /g or /y RegExp is stateful: without the reset every other
+            // request to the same URL would miss.
+            matcher.lastIndex = 0;
+            return matcher.test(url.href);
+        };
+    }
+    const pattern = globToRegExp(matcher);
+    if (!matcher.startsWith("/"))
+        return (url) => pattern.test(url.href);
+    if (matcher.includes("?"))
+        // It would compile, and then never match anything.
+        throw new WirestageError("INVALID_ARGUMENT", `"${matcher}" matches the path, which has no query: drop the "?…", or match the whole URL ("**${matcher}")`);
+    return (url) => pattern.test(url.pathname);
+}
+/** Characters with a meaning in a RegExp: escaped wherever a glob means them literally. */
+const SPECIAL = /[.*+?^${}()|[\]\\/]/;
+/** Translate a glob into an anchored RegExp. */
+export function globToRegExp(glob) {
+    return new RegExp(`^${globSource(glob).source}$`);
+}
+/**
+ * The RegExp source of a glob. With `params`, a `:name` (a letter or `_`,
+ * then word characters) matches one segment and captures it: the routes of a
+ * REST plugin, in the same glob language as every other pattern.
+ */
+export function globSource(glob, options = {}) {
+    const params = [];
+    let source = "";
+    let inGroup = false;
+    for (let i = 0; i < glob.length; i++) {
+        const char = glob.charAt(i);
+        if (char === "\\" && i + 1 < glob.length) {
+            source += escapeChar(glob.charAt(++i));
+        }
+        else if (char === "*") {
+            if (glob.charAt(i + 1) !== "*") {
+                source += "[^/]*";
+            }
+            else if (glob.charAt(i + 2) === "/") {
+                // `a/**/b` matches `a/b` too: the directories may be none.
+                source += "(?:.+/)?";
+                i += 2;
+            }
+            else {
+                source += ".*";
+                i++;
+            }
+        }
+        else if (char === "{") {
+            inGroup = true;
+            source += "(?:";
+        }
+        else if (char === "}" && inGroup) {
+            inGroup = false;
+            source += ")";
+        }
+        else if (char === "," && inGroup) {
+            source += "|";
+        }
+        else if (char === ":" && options.params) {
+            // `:8080` in an origin is not a param: a name starts with a letter.
+            const name = /^[A-Za-z_]\w*/.exec(glob.slice(i + 1))?.[0];
+            if (name === undefined)
+                source += char;
+            else {
+                params.push(name);
+                source += "([^/]+)";
+                i += name.length;
+            }
+        }
+        else {
+            source += escapeChar(char);
+        }
+    }
+    if (inGroup)
+        throw new WirestageError("INVALID_ARGUMENT", `glob "${glob}" opens a "{" it never closes; write a literal brace as "\\{"`);
+    return { source, params };
+}
+function escapeChar(char) {
+    return SPECIAL.test(char) ? `\\${char}` : char;
+}
+//# sourceMappingURL=url-matcher.js.map

package/dist/shared/lib/match/url-matcher.js.map

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

package/dist/sse.d.ts

@@ -0,0 +1,3 @@
+/** @heojeongbo/wirestage/sse — server-sent events. */
+export * from "./features/sse/index.js";
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,cAAc,yBAAyB,CAAC"}

package/dist/sse.js

@@ -0,0 +1,3 @@
+/** @heojeongbo/wirestage/sse — server-sent events. */
+export * from "./features/sse/index.js";
+//# sourceMappingURL=sse.js.map