@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/core/Hex.js

@@ -1,161 +0,0 @@
-/**
- * Flat-top hexagon geometry, addressed the same way a square grid is: `x` the column, `y`
- * the row, both integers - which is what lets `mwg/roguelike`'s `Level` (grid logic) and
- * `mwg/render`'s `TileMap` (pixel positions) each reuse it without depending on the other.
- * It lives in `mwg/core` for exactly that reason: neither of those two modules is allowed
- * to depend on the other, and this needs to sit below both.
- *
- * Internally this converts to and from cube coordinates (`x + y + z = 0`) for every
- * calculation, because the six neighbour directions are then a fixed, orientation-agnostic
- * list rather than a column-parity-dependent table someone has to get right twice. The
- * offset "odd-q" scheme below - odd columns pushed half a row down - is what makes that
- * cube math round-trip back to integers; nothing about it is rot.js's, which is deliberate
- * (see the roadmap: rot.js's own hex `Path` topology is doubled-width coordinates built for
- * *pointy-top* hexagons, and does not match this orientation).
- *
- * @example
- * ```ts
- * import { hexNeighbors, hexDistance, hexLine, hexRange, hexToPixel, pixelToHex } from '@datamoc/mw_games/core';
- *
- * const start = { x: 2, y: 2 };
- * const neighbours = hexNeighbors(start.x, start.y); // the 6 adjacent cells
- * const cellsAway = hexDistance(start, { x: 4, y: 1 });
- * const path = hexLine(start, { x: 4, y: 1 }); // every cell the line crosses
- * const nearby = hexRange(start, 2); // every cell within 2 hexes
- *
- * const pixel = hexToPixel(start.x, start.y, 32, 28); // tile width/height in pixels
- * const backToHex = pixelToHex(pixel.x, pixel.y, 32, 28); // round-trips to { x: 2, y: 2 }
- * ```
- */
-function toCube(x, y) {
-    const cx = x;
-    const cz = y - (x - (x & 1)) / 2;
-    return { x: cx, y: -cx - cz, z: cz };
-}
-function fromCube(cube) {
-    const x = cube.x;
-    const y = cube.z + (cube.x - (cube.x & 1)) / 2;
-    return { x, y };
-}
-//the six cube directions - orientation-agnostic, and each other's negation in pairs, which
-//is what makes the neighbour relation below symmetric by construction
-const CUBE_DIRECTIONS = [
-    { x: 1, y: -1, z: 0 },
-    { x: 1, y: 0, z: -1 },
-    { x: 0, y: 1, z: -1 },
-    { x: -1, y: 1, z: 0 },
-    { x: -1, y: 0, z: 1 },
-    { x: 0, y: -1, z: 1 },
-];
-/** the six cells sharing an edge with `(x, y)` */
-export function hexNeighbors(x, y) {
-    const cube = toCube(x, y);
-    return CUBE_DIRECTIONS.map((d) => fromCube({ x: cube.x + d.x, y: cube.y + d.y, z: cube.z + d.z }));
-}
-/** the number of hex steps between two cells */
-export function hexDistance(a, b) {
-    const ca = toCube(a.x, a.y);
-    const cb = toCube(b.x, b.y);
-    return Math.max(Math.abs(ca.x - cb.x), Math.abs(ca.y - cb.y), Math.abs(ca.z - cb.z));
-}
-function cubeRound(cube) {
-    let rx = Math.round(cube.x);
-    let ry = Math.round(cube.y);
-    let rz = Math.round(cube.z);
-    const dx = Math.abs(rx - cube.x);
-    const dy = Math.abs(ry - cube.y);
-    const dz = Math.abs(rz - cube.z);
-    //whichever coordinate drifted furthest from its rounded value is reconstructed from the
-    //other two, so x + y + z = 0 still holds exactly
-    if (dx > dy && dx > dz)
-        rx = -ry - rz;
-    else if (dy > dz)
-        ry = -rx - rz;
-    else
-        rz = -rx - ry;
-    return { x: rx, y: ry, z: rz };
-}
-/**
- * Every cell a straight line crosses from `a` to `b`, both included - the hex-grid analogue
- * of `mwg/roguelike`'s `traceLine`, and what a simple (non-shadowcast) hex field of view is
- * built from: walk the line to a candidate cell and see whether anything on it is opaque.
- */
-export function hexLine(a, b) {
-    const distance = hexDistance(a, b);
-    if (distance === 0)
-        return [{ x: a.x, y: a.y }];
-    const ca = toCube(a.x, a.y);
-    const cb = toCube(b.x, b.y);
-    const points = [];
-    for (let step = 0; step <= distance; step++) {
-        const t = step / distance;
-        points.push(fromCube(cubeRound({
-            x: ca.x + (cb.x - ca.x) * t,
-            y: ca.y + (cb.y - ca.y) * t,
-            z: ca.z + (cb.z - ca.z) * t,
-        })));
-    }
-    return points;
-}
-/** every cell within `radius` hex steps of `center`, `center` itself included */
-export function hexRange(center, radius) {
-    const cc = toCube(center.x, center.y);
-    const out = [];
-    for (let dx = -radius; dx <= radius; dx++) {
-        for (let dy = Math.max(-radius, -dx - radius); dy <= Math.min(radius, -dx + radius); dy++) {
-            const dz = -dx - dy;
-            out.push(fromCube({ x: cc.x + dx, y: cc.y + dy, z: cc.z + dz }));
-        }
-    }
-    return out;
-}
-/**
- * The pixel position of a hex cell's centre.
- *
- * `tileWidth`/`tileHeight` are the tile as drawn, so a flat-top hex is `0.75` of its width between
- * columns and its full height between rows; a pointy-top one is the transpose of that.
- */
-export function hexToPixel(x, y, tileWidth, tileHeight, shape = {}) {
-    const parity = (shape.offset ?? 'odd') === 'odd' ? 1 : 0;
-    if ((shape.orientation ?? 'flat-top') === 'pointy-top') {
-        return {
-            x: x * tileWidth + ((y & 1) === parity ? tileWidth / 2 : 0) + tileWidth / 2,
-            y: y * tileHeight * 0.75 + tileHeight / 2,
-        };
-    }
-    return {
-        x: x * tileWidth * 0.75 + tileWidth / 2,
-        y: y * tileHeight + ((x & 1) === parity ? tileHeight / 2 : 0) + tileHeight / 2,
-    };
-}
-/**
- * The hex cell under a pixel position - the inverse of `hexToPixel`.
- *
- * The answer is the nearest cell centre, searched over the cells around the one the pixel looks
- * like it is in, and that is deliberate: a hexagonal tiling has no ties, the containing cell *is* the
- * nearest centre, and a search needs no second set of formulas to stay the inverse of the four
- * orientation-and-offset combinations above. A closed-form inverse would be four more chances to be
- * subtly wrong at a hex's edge, where a click has to land somewhere sensible.
- */
-export function pixelToHex(px, py, tileWidth, tileHeight, shape = {}) {
-    const pointy = (shape.orientation ?? 'flat-top') === 'pointy-top';
-    const stepX = pointy ? tileWidth : tileWidth * 0.75;
-    const stepY = pointy ? tileHeight * 0.75 : tileHeight;
-    const guessX = Math.round((px - tileWidth / 2) / stepX);
-    const guessY = Math.round((py - tileHeight / 2) / stepY);
-    let best = { x: guessX, y: guessY };
-    let bestDistance = Infinity;
-    for (let dx = -2; dx <= 2; dx++) {
-        for (let dy = -2; dy <= 2; dy++) {
-            const candidate = { x: guessX + dx, y: guessY + dy };
-            const centre = hexToPixel(candidate.x, candidate.y, tileWidth, tileHeight, shape);
-            const distance = (centre.x - px) ** 2 + (centre.y - py) ** 2;
-            if (distance < bestDistance) {
-                bestDistance = distance;
-                best = candidate;
-            }
-        }
-    }
-    return best;
-}
-//# sourceMappingURL=Hex.js.map

package/dist/core/Hex.js.map

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

package/dist/core/Hooks.d.ts

@@ -1,48 +0,0 @@
-/**
- * A named-event registry whose handlers can be removed in bulk by whatever registered them.
- *
- * Distinct from `Signal`, which is one event with one payload and a consuming, LIFO listener
- * order: this is many events keyed by name, dispatched in registration order, with a `source`
- * tag so everything an ability or a worn item put here comes off in one call when that thing
- * leaves. `mwg` names no events of its own - the strings are whatever a game's own loop
- * actually fires.
- *
- * `battle.BattleHooks` and `roguelike.CombatHooks` are both this, with their argument types
- * fixed and their own documentation attached. They used to be two line-for-line copies of the
- * same class; the difference between them was never the registry, only what a handler is
- * handed when it runs.
- *
- * @example
- * ```ts
- * import { HookRegistry } from '@datamoc/mw_games/core';
- *
- * const hooks = new HookRegistry<[amount: number]>();
- * const poisonRing = {};
- *
- * hooks.on('turnStart', (amount) => console.log('poison ticks for', amount), poisonRing);
- * hooks.emit('turnStart', 3);
- *
- * // the ring is removed - every hook it registered comes off in one call
- * hooks.offSource(poisonRing);
- * ```
- */
-export interface Hook<TArgs extends unknown[]> {
-    event: string;
-    handler: (...args: TArgs) => void;
-    /** whatever registered this hook - an ability, a held item - for bulk removal via `offSource` */
-    source?: unknown;
-}
-export declare class HookRegistry<TArgs extends unknown[]> {
-    private hooks;
-    on(event: string, handler: (...args: TArgs) => void, source?: unknown): void;
-    /** removes one specific handler; `offSource` is the usual way, this is for a one-off */
-    off(handler: (...args: TArgs) => void): void;
-    /** removes every hook registered with this `source` - a fainted creature's ability leaving */
-    offSource(source: unknown): void;
-    /** runs every handler registered for `event`, in registration order */
-    emit(event: string, ...args: TArgs): void;
-    /** how many handlers are registered, across every event */
-    get size(): number;
-    clear(): void;
-}
-//# sourceMappingURL=Hooks.d.ts.map

package/dist/core/Hooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Hooks.d.ts","sourceRoot":"","sources":["../../src/core/Hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,IAAI,CAAC,KAAK,SAAS,OAAO,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC;IAElC,iGAAiG;IACjG,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,YAAY,CAAC,KAAK,SAAS,OAAO,EAAE;IAChD,OAAO,CAAC,KAAK,CAAqB;IAElC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAE3E;IAED,wFAAwF;IACxF,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAE3C;IAED,8FAA8F;IAC9F,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAE/B;IAED,uEAAuE;IACvE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,CAMxC;IAED,2DAA2D;IAC3D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI,CAEZ;CACD"}

package/dist/core/Hooks.js

@@ -1,33 +0,0 @@
-export class HookRegistry {
-    constructor() {
-        this.hooks = [];
-    }
-    on(event, handler, source) {
-        this.hooks.push({ event, handler, source });
-    }
-    /** removes one specific handler; `offSource` is the usual way, this is for a one-off */
-    off(handler) {
-        this.hooks = this.hooks.filter((hook) => hook.handler !== handler);
-    }
-    /** removes every hook registered with this `source` - a fainted creature's ability leaving */
-    offSource(source) {
-        this.hooks = this.hooks.filter((hook) => hook.source !== source);
-    }
-    /** runs every handler registered for `event`, in registration order */
-    emit(event, ...args) {
-        //iterate a copy: a handler may remove itself or another, which must not shift the
-        //iteration out from under this loop mid-dispatch
-        for (const hook of [...this.hooks]) {
-            if (hook.event === event)
-                hook.handler(...args);
-        }
-    }
-    /** how many handlers are registered, across every event */
-    get size() {
-        return this.hooks.length;
-    }
-    clear() {
-        this.hooks = [];
-    }
-}
-//# sourceMappingURL=Hooks.js.map

package/dist/core/Hooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Hooks.js","sourceRoot":"","sources":["../../src/core/Hooks.ts"],"names":[],"mappings":"AAoCA,MAAM,OAAO,YAAY;IAAzB;QACS,UAAK,GAAkB,EAAE,CAAC;IAiCnC,CAAC;IA/BA,EAAE,CAAC,KAAa,EAAE,OAAiC,EAAE,MAAgB;QACpE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,wFAAwF;IACxF,GAAG,CAAC,OAAiC;QACpC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,8FAA8F;IAC9F,SAAS,CAAC,MAAe;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,uEAAuE;IACvE,IAAI,CAAC,KAAa,EAAE,GAAG,IAAW;QACjC,kFAAkF;QAClF,iDAAiD;QACjD,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;gBAAE,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACjD,CAAC;IACF,CAAC;IAED,2DAA2D;IAC3D,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IACjB,CAAC;CACD"}

package/dist/core/HttpTransport.d.ts

@@ -1,53 +0,0 @@
-export interface HttpTransportOptions {
-    endpoint: string;
-    timeoutMs?: number;
-    fetch?: typeof globalThis.fetch;
-    /** largest response body read, in bytes; defaults to 10 MB */
-    maxResponseBytes?: number;
-    /** accept `http://` to a host other than this machine; off by default */
-    allowInsecure?: boolean;
-}
-/**
- * Throws unless `url` is encrypted (`https:`/`wss:`) or stays on this machine (`localhost`,
- * `127.0.0.1`, `[::1]`), or `allowInsecure` says otherwise. A save, a telemetry event or a
- * multiplayer input sent in clear text is readable and alterable by anyone on the path; a
- * relative url inherits the page's own scheme, so it is accepted as is.
- */
-export declare function assertSecureUrl(url: string, label: string, allowInsecure?: boolean): void;
-/**
- * The constructor validation and timeout-wrapped fetch shared by every injectable HTTPS
- * transport here (`FeedbackClient`, `NewsClient`, `SaveSyncClient`, `TelemetryClient`) - each one is a
- * plain request/response against a game's own endpoint, differing only in what they send and
- * expect back, not in how the endpoint/timeout/fetch options are validated or how a request
- * is aborted after `timeoutMs`. `label` names the concrete client in its own error messages
- * ("feedback endpoint is required", not a generic one that would leave a game guessing which
- * of several clients threw).
- *
- * @example
- * ```ts
- * import { HttpTransport, type HttpTransportOptions } from '@datamoc/mw_games/core';
- *
- * class ScoreClient extends HttpTransport {
- * 	constructor(options: HttpTransportOptions) {
- * 		super(options, 'score');
- * 	}
- * }
- *
- * const client = new ScoreClient({ endpoint: 'https://example.com/scores' });
- * console.log(client instanceof HttpTransport); // true
- * ```
- */
-export declare abstract class HttpTransport {
-    protected readonly endpoint: string;
-    protected readonly timeoutMs: number;
-    protected readonly fetchFn: typeof globalThis.fetch;
-    protected readonly maxResponseBytes: number;
-    private readonly label;
-    constructor(options: HttpTransportOptions, label: string);
-    protected withTimeout<T>(run: (signal: AbortSignal) => Promise<T>): Promise<T>;
-    /** the response body as text, refused as soon as it passes `maxResponseBytes` rather than after it is all in memory */
-    protected readText(response: Response): Promise<string>;
-    /** `readText`, then `parseInbound` */
-    protected readJson(response: Response, what: string): Promise<unknown>;
-}
-//# sourceMappingURL=HttpTransport.d.ts.map

package/dist/core/HttpTransport.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"HttpTransport.d.ts","sourceRoot":"","sources":["../../src/core/HttpTransport.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,UAAQ,GAAG,IAAI,CAQvF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,8BAAsB,aAAa;IAClC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACpD,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,YAAY,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAUvD;IAED,UAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQnF;IAED,uHAAuH;IACvH,UAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B5D;IAED,sCAAsC;IACtC,UAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK3E;CACD"}

package/dist/core/HttpTransport.js

@@ -1,108 +0,0 @@
-import { checkSize, parseInbound } from './Sanitize.js';
-const LOCAL_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]']);
-/**
- * Throws unless `url` is encrypted (`https:`/`wss:`) or stays on this machine (`localhost`,
- * `127.0.0.1`, `[::1]`), or `allowInsecure` says otherwise. A save, a telemetry event or a
- * multiplayer input sent in clear text is readable and alterable by anyone on the path; a
- * relative url inherits the page's own scheme, so it is accepted as is.
- */
-export function assertSecureUrl(url, label, allowInsecure = false) {
-    if (allowInsecure || !/^[a-z][a-z0-9+.-]*:/i.test(url))
-        return;
-    const parsed = new URL(url);
-    if (parsed.protocol === 'https:' || parsed.protocol === 'wss:')
-        return;
-    if ((parsed.protocol === 'http:' || parsed.protocol === 'ws:') && LOCAL_HOSTS.has(parsed.hostname))
-        return;
-    throw new Error(`${label} url must use https: or wss: (got ${parsed.protocol}//${parsed.host}); pass allowInsecure: true to accept it`);
-}
-/**
- * The constructor validation and timeout-wrapped fetch shared by every injectable HTTPS
- * transport here (`FeedbackClient`, `NewsClient`, `SaveSyncClient`, `TelemetryClient`) - each one is a
- * plain request/response against a game's own endpoint, differing only in what they send and
- * expect back, not in how the endpoint/timeout/fetch options are validated or how a request
- * is aborted after `timeoutMs`. `label` names the concrete client in its own error messages
- * ("feedback endpoint is required", not a generic one that would leave a game guessing which
- * of several clients threw).
- *
- * @example
- * ```ts
- * import { HttpTransport, type HttpTransportOptions } from '@datamoc/mw_games/core';
- *
- * class ScoreClient extends HttpTransport {
- * 	constructor(options: HttpTransportOptions) {
- * 		super(options, 'score');
- * 	}
- * }
- *
- * const client = new ScoreClient({ endpoint: 'https://example.com/scores' });
- * console.log(client instanceof HttpTransport); // true
- * ```
- */
-export class HttpTransport {
-    constructor(options, label) {
-        if (!options.endpoint)
-            throw new Error(`${label} endpoint is required`);
-        assertSecureUrl(options.endpoint, `${label} endpoint`, options.allowInsecure);
-        this.endpoint = options.endpoint;
-        this.label = label;
-        this.maxResponseBytes = options.maxResponseBytes ?? 10 * 1024 * 1024;
-        this.timeoutMs = options.timeoutMs ?? 10000;
-        if (!(this.timeoutMs > 0))
-            throw new Error(`${label} timeout must be positive`);
-        this.fetchFn = options.fetch ?? globalThis.fetch;
-        if (!this.fetchFn)
-            throw new Error(`fetch is unavailable; provide ${label}Options.fetch`);
-    }
-    async withTimeout(run) {
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
-        try {
-            return await run(controller.signal);
-        }
-        finally {
-            clearTimeout(timer);
-        }
-    }
-    /** the response body as text, refused as soon as it passes `maxResponseBytes` rather than after it is all in memory */
-    async readText(response) {
-        const limit = this.maxResponseBytes;
-        const declared = Number(response.headers?.get?.('content-length'));
-        if (declared > limit)
-            throw new Error(`${this.label} response exceeds the ${limit}-byte limit (${declared} bytes)`);
-        if (!response.body) {
-            const text = await response.text();
-            checkSize(text, { maxBytes: limit });
-            return text;
-        }
-        const reader = response.body.getReader();
-        const chunks = [];
-        let size = 0;
-        for (;;) {
-            const { done, value } = await reader.read();
-            if (done)
-                break;
-            size += value.byteLength;
-            if (size > limit) {
-                await reader.cancel();
-                throw new Error(`${this.label} response exceeds the ${limit}-byte limit`);
-            }
-            chunks.push(value);
-        }
-        const bytes = new Uint8Array(size);
-        let offset = 0;
-        for (const chunk of chunks) {
-            bytes.set(chunk, offset);
-            offset += chunk.byteLength;
-        }
-        return new TextDecoder().decode(bytes);
-    }
-    /** `readText`, then `parseInbound` */
-    async readJson(response, what) {
-        return parseInbound(await this.readText(response), {
-            maxBytes: this.maxResponseBytes,
-            label: `${this.label} ${what}`,
-        });
-    }
-}
-//# sourceMappingURL=HttpTransport.js.map

package/dist/core/HttpTransport.js.map

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