@datamoc/mw_games 0.2.1 → 0.4.0

package/dist/assets/paths.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Where a game's assets come from, as pure path arithmetic.
+ *
+ * In a built game, `tools/compile-resources` has already turned every asset into a `data:`
+ * URI inside a script that runs before the game does. `resolve` then hands back that URI
+ * instead of a path, which is what lets the page work from `file://`: see the tool for
+ * why plain files next to the page do not.
+ *
+ * During development there is no compiled bundle, so paths are used as they are and the
+ * dev server serves them. Game code says `load('tiles.png')` either way.
+ *
+ * Kept separate from `loader.ts` because none of this needs a renderer. Resolving a path is
+ * string-and-map work; only actually fetching and decoding an asset needs Pixi's loader. That
+ * split is what lets `mwg/3d` resolve a `.glb` path through the same compiled-asset map every
+ * 2D game uses while handing the fetch to Babylon, without a Babylon-only game importing
+ * Pixi at all - which it did, transitively, purely because these two halves shared a file.
+ */
+declare global {
+    interface Window {
+        __MWG_ASSETS__?: Record<string, string>;
+    }
+}
+/** points dev-mode lookups at the folder assets are served from */
+export declare function setBase(path: string): void;
+/** true when running against a compiled bundle rather than a dev server */
+export declare function isCompiled(): boolean;
+export declare function paths(): string[];
+export declare function has(path: string): boolean;
+/** an asset path resolved to something the browser can actually load */
+export declare function resolve(path: string): string;
+/**
+ * 0 (started) to 1 (complete) - a count of assets finished, not a byte count. Pixi's own
+ * loaders do not expose bytes transferred across every asset type uniformly, so this reports
+ * what is actually available rather than a byte figure it cannot back with a real number.
+ *
+ * Lives here rather than with the loader so `Streaming.ts` can name it without either file
+ * importing the other's module barrel, which is what made these two a cycle before.
+ */
+export type AssetProgress = (fraction: number) => void;
+//# sourceMappingURL=paths.d.ts.map

package/dist/assets/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/assets/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC;CACD;AAKD,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1C;AAMD,2EAA2E;AAC3E,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,wBAAgB,KAAK,IAAI,MAAM,EAAE,CAEhC;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzC;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW5C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC"}

package/dist/assets/paths.js

@@ -0,0 +1,49 @@
+/**
+ * Where a game's assets come from, as pure path arithmetic.
+ *
+ * In a built game, `tools/compile-resources` has already turned every asset into a `data:`
+ * URI inside a script that runs before the game does. `resolve` then hands back that URI
+ * instead of a path, which is what lets the page work from `file://`: see the tool for
+ * why plain files next to the page do not.
+ *
+ * During development there is no compiled bundle, so paths are used as they are and the
+ * dev server serves them. Game code says `load('tiles.png')` either way.
+ *
+ * Kept separate from `loader.ts` because none of this needs a renderer. Resolving a path is
+ * string-and-map work; only actually fetching and decoding an asset needs Pixi's loader. That
+ * split is what lets `mwg/3d` resolve a `.glb` path through the same compiled-asset map every
+ * 2D game uses while handing the fetch to Babylon, without a Babylon-only game importing
+ * Pixi at all - which it did, transitively, purely because these two halves shared a file.
+ */
+/** the base for dev-mode paths, when assets are served rather than compiled in */
+let base = '';
+/** points dev-mode lookups at the folder assets are served from */
+export function setBase(path) {
+    base = path.endsWith('/') || path === '' ? path : path + '/';
+}
+function compiled() {
+    return typeof window === 'undefined' ? undefined : window.__MWG_ASSETS__;
+}
+/** true when running against a compiled bundle rather than a dev server */
+export function isCompiled() {
+    return compiled() !== undefined;
+}
+export function paths() {
+    return Object.keys(compiled() ?? {});
+}
+export function has(path) {
+    const map = compiled();
+    return map ? path in map : true;
+}
+/** an asset path resolved to something the browser can actually load */
+export function resolve(path) {
+    const map = compiled();
+    if (!map)
+        return base + path;
+    const found = map[path];
+    if (found === undefined) {
+        throw new Error(`asset "${path}" is not in this build - check it is under the folder passed to compile-resources`);
+    }
+    return found;
+}
+//# sourceMappingURL=paths.js.map

package/dist/assets/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/assets/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,kFAAkF;AAClF,IAAI,IAAI,GAAG,EAAE,CAAC;AAEd,mEAAmE;AACnE,MAAM,UAAU,OAAO,CAAC,IAAY;IACnC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC;AAC9D,CAAC;AAED,SAAS,QAAQ;IAChB,OAAO,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;AAC1E,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,UAAU;IACzB,OAAO,QAAQ,EAAE,KAAK,SAAS,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,KAAK;IACpB,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAY;IAC/B,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;IACvB,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,OAAO,CAAC,IAAY;IACnC,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;IACvB,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,GAAG,IAAI,CAAC;IAE7B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACd,UAAU,IAAI,mFAAmF,CACjG,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/audio/Music.d.ts

@@ -12,10 +12,20 @@ export declare class Music {
     private current;
     private fades;
     private create;
+    private trackQueue;
+    private playlistFade;
     volume: number;
     constructor(options?: MusicOptions);
     /** @param fadeDuration seconds; 0 switches immediately with no crossfade */
     play(path: string, fadeDuration?: number): void;
+    /**
+     * Plays the supplied sequence repeatedly. This is deliberately small and backend-agnostic:
+     * callers can repeat entries to weight a track, while HTMLAudioElement's optional `onended`
+     * advances the queue when available.
+     */
+    playTracks(paths: readonly string[], fadeDuration?: number): void;
+    private startNextTrack;
+    private start;
     stop(fadeDuration?: number): void;
     update(dt: number): void;
 }

package/dist/audio/Music.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Music.d.ts","sourceRoot":"","sources":["../../src/audio/Music.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAW3D,MAAM,WAAW,YAAY;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC;CACpC;AAED;;;;GAIG;AACH,qBAAa,KAAK;IACjB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAA6B;IAC3C,MAAM,EAAE,MAAM,CAAC;IAEf,YAAY,OAAO,GAAE,YAAiB,EAGrC;IAED,4EAA4E;IAC5E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,IAAI,CA+BzC;IAED,IAAI,CAAC,YAAY,SAAI,GAAG,IAAI,CAU3B;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAevB;CACD"}
+{"version":3,"file":"Music.d.ts","sourceRoot":"","sources":["../../src/audio/Music.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAW3D,MAAM,WAAW,YAAY;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC;CACpC;AAED;;;;GAIG;AACH,qBAAa,KAAK;IACjB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,YAAY,CAAK;IACzB,MAAM,EAAE,MAAM,CAAC;IAEf,YAAY,OAAO,GAAE,YAAiB,EAGrC;IAED,4EAA4E;IAC5E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,IAAI,CAGzC;IAED;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,YAAY,SAAI,GAAG,IAAI,CAQ3D;IAED,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,KAAK;IAuCb,IAAI,CAAC,YAAY,SAAI,GAAG,IAAI,CAW3B;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAevB;CACD"}

package/dist/audio/Music.js

@@ -8,13 +8,47 @@ export class Music {
     constructor(options = {}) {
         this.current = null;
         this.fades = [];
+        this.trackQueue = null;
+        this.playlistFade = 1;
         this.volume = options.volume ?? 1;
         this.create = options.create ?? createAudio;
     }
     /** @param fadeDuration seconds; 0 switches immediately with no crossfade */
     play(path, fadeDuration = 1) {
+        this.trackQueue = null;
+        this.start(path, fadeDuration, true);
+    }
+    /**
+     * Plays the supplied sequence repeatedly. This is deliberately small and backend-agnostic:
+     * callers can repeat entries to weight a track, while HTMLAudioElement's optional `onended`
+     * advances the queue when available.
+     */
+    playTracks(paths, fadeDuration = 1) {
+        if (paths.length === 0) {
+            this.stop(fadeDuration);
+            return;
+        }
+        this.trackQueue = [...paths];
+        this.playlistFade = fadeDuration;
+        this.startNextTrack();
+    }
+    startNextTrack() {
+        if (!this.trackQueue?.length)
+            return;
+        const path = this.trackQueue.shift();
+        this.trackQueue.push(path);
+        this.start(path, this.playlistFade, false);
+    }
+    start(path, fadeDuration, loop) {
         const incoming = this.create(path);
-        incoming.loop = true;
+        incoming.loop = loop;
+        if (!loop && incoming.onended !== undefined) {
+            // A delayed event from a fading-out track must not advance a newer playlist.
+            incoming.onended = () => {
+                if (this.current === incoming)
+                    this.startNextTrack();
+            };
+        }
         const previous = this.current;
         this.current = incoming;
         if (fadeDuration <= 0) {
@@ -41,6 +75,7 @@ export class Music {
         }
     }
     stop(fadeDuration = 1) {
+        this.trackQueue = null;
         const audio = this.current;
         if (!audio)
             return;

package/dist/audio/Music.js.map

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

package/dist/audio/Playable.d.ts

@@ -10,6 +10,9 @@ export interface Playable {
     currentTime: number;
     volume: number;
     loop: boolean;
+    /** Optional completion hook, matching HTMLAudioElement.onended. Backends without an
+     * end event can omit it; single-track Music remains fully usable there. */
+    onended?: ((event: Event) => unknown) | null;
 }
 /** the real thing: an `HTMLAudioElement` pointed at a resolved asset path */
 export declare function createAudio(path: string): Playable;

package/dist/audio/Playable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Playable.d.ts","sourceRoot":"","sources":["../../src/audio/Playable.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACxB,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACd;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAElD"}
+{"version":3,"file":"Playable.d.ts","sourceRoot":"","sources":["../../src/audio/Playable.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACxB,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd;+EAC2E;IAC3E,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;CAC7C;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAElD"}

package/dist/audio/Playable.js

@@ -1,4 +1,4 @@
-import * as Resources from '../assets/index.js';
+import * as Resources from '../assets/paths.js';
 /** the real thing: an `HTMLAudioElement` pointed at a resolved asset path */
 export function createAudio(path) {
     return new Audio(Resources.resolve(path));

package/dist/audio/Playable.js.map

@@ -1 +1 @@
-{"version":3,"file":"Playable.js","sourceRoot":"","sources":["../../src/audio/Playable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAgBhD,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,OAAO,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"Playable.js","sourceRoot":"","sources":["../../src/audio/Playable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAmBhD,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,OAAO,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/battle/Field.d.ts

@@ -19,7 +19,7 @@ export declare class Field {
     get(id: string): FieldCondition | undefined;
     clear(id: string): void;
     get active(): readonly FieldCondition[];
-    /** ticks every timed condition down by one round, clearing any that just ran out */
-    advance(): void;
+    /** ticks every timed condition down by `rounds`, clearing any that just ran out */
+    advance(rounds?: number): void;
 }
 //# sourceMappingURL=Field.d.ts.map

package/dist/battle/Field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../src/battle/Field.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,KAAK;IACjB,OAAO,CAAC,UAAU,CAAqC;IAEvD,GAAG,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAEnC;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEvB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE1C;IAED,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtB;IAED,IAAI,MAAM,IAAI,SAAS,cAAc,EAAE,CAEtC;IAED,oFAAoF;IACpF,OAAO,IAAI,IAAI,CAOd;CACD"}
+{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../src/battle/Field.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,KAAK;IACjB,OAAO,CAAC,UAAU,CAAqC;IAEvD,GAAG,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAEnC;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEvB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE1C;IAED,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtB;IAED,IAAI,MAAM,IAAI,SAAS,cAAc,EAAE,CAEtC;IAED,mFAAmF;IACnF,OAAO,CAAC,MAAM,SAAI,GAAG,IAAI,CAOxB;CACD"}

package/dist/battle/Field.js

@@ -17,12 +17,12 @@ export class Field {
     get active() {
         return [...this.conditions.values()];
     }
-    /** ticks every timed condition down by one round, clearing any that just ran out */
-    advance() {
+    /** ticks every timed condition down by `rounds`, clearing any that just ran out */
+    advance(rounds = 1) {
         for (const [id, condition] of this.conditions) {
             if (condition.duration === undefined)
                 continue;
-            condition.duration -= 1;
+            condition.duration -= rounds;
             if (condition.duration <= 0)
                 this.conditions.delete(id);
         }

package/dist/battle/Field.js.map

@@ -1 +1 @@
-{"version":3,"file":"Field.js","sourceRoot":"","sources":["../../src/battle/Field.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,KAAK;IAAlB;QACS,eAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;IA+BxD,CAAC;IA7BA,GAAG,CAAC,SAAyB;QAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,EAAU;QACf,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,oFAAoF;IACpF,OAAO;QACN,KAAK,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC/C,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS;gBAAE,SAAS;YAE/C,SAAS,CAAC,QAAQ,IAAI,CAAC,CAAC;YACxB,IAAI,SAAS,CAAC,QAAQ,IAAI,CAAC;gBAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"Field.js","sourceRoot":"","sources":["../../src/battle/Field.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,KAAK;IAAlB;QACS,eAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;IA+BxD,CAAC;IA7BA,GAAG,CAAC,SAAyB;QAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,EAAU;QACf,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,mFAAmF;IACnF,OAAO,CAAC,MAAM,GAAG,CAAC;QACjB,KAAK,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC/C,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS;gBAAE,SAAS;YAE/C,SAAS,CAAC,QAAQ,IAAI,MAAM,CAAC;YAC7B,IAAI,SAAS,CAAC,QAAQ,IAAI,CAAC;gBAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;IACF,CAAC;CACD"}

package/dist/battle/Hooks.d.ts

@@ -1,3 +1,4 @@
+import { HookRegistry } from '../core/Hooks.ts';
 /**
  * A battle-scoped place for passive effects to run code, not just push a number - the seam
  * `mwg/actors`' `StatBlock` modifiers and `applyStatusEffect` do not cover, since both are
@@ -11,19 +12,12 @@
  * check is a plain convention on top of this, not special-cased: a handler mutates a shared
  * `context` object (`{ skip: false }`, say) the same way any other side effect would, and
  * the battle loop reads it back after `emit` returns.
+ *
+ * The registry itself is `core.HookRegistry`, shared with `roguelike.CombatHooks`. What is
+ * battle-specific is only the shape of what a handler receives: the creature the event is
+ * about, plus that optional shared context.
  */
-export interface BattleHook<C> {
-    event: string;
-    handler: (creature: C, context?: unknown) => void;
-    /** whatever registered this hook - an ability, a held item - for bulk removal via `offSource` */
-    source?: unknown;
-}
-export declare class BattleHooks<C> {
-    private hooks;
-    on(event: string, handler: (creature: C, context?: unknown) => void, source?: unknown): 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, creature: C, context?: unknown): void;
+export declare class BattleHooks<C> extends HookRegistry<[creature: C, context?: unknown]> {
 }
+export type { Hook as BattleHook } from '../core/Hooks.ts';
 //# sourceMappingURL=Hooks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Hooks.d.ts","sourceRoot":"","sources":["../../src/battle/Hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,iGAAiG;IACjG,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,WAAW,CAAC,CAAC;IACzB,OAAO,CAAC,KAAK,CAAuB;IAEpC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAE3F;IAED,8FAA8F;IAC9F,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAE/B;IAED,uEAAuE;IACvE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAIxD;CACD"}
+{"version":3,"file":"Hooks.d.ts","sourceRoot":"","sources":["../../src/battle/Hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;CAAG;AAErF,YAAY,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/battle/Hooks.js

@@ -1,20 +1,22 @@
-export class BattleHooks {
-    constructor() {
-        this.hooks = [];
-    }
-    on(event, handler, source) {
-        this.hooks.push({ event, handler, source });
-    }
-    /** 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, creature, context) {
-        for (const hook of this.hooks) {
-            if (hook.event === event)
-                hook.handler(creature, context);
-        }
-    }
+import { HookRegistry } from '../core/Hooks.js';
+/**
+ * A battle-scoped place for passive effects to run code, not just push a number - the seam
+ * `mwg/actors`' `StatBlock` modifiers and `applyStatusEffect` do not cover, since both are
+ * numeric-only. An ability reacting to "this creature switched in," a held item reacting to
+ * "this creature was hit," or a sleep/paralysis status answering "can this creature act this
+ * turn" are all the same shape: register a handler for a named event, and a game's battle
+ * loop calls it at the right moment.
+ *
+ * `mwg` names no events of its own beyond the strings a game passes - `'switchIn'`, `'hit'`,
+ * `'turnStart'`, whatever a game's battle loop actually fires. A "can this creature act"
+ * check is a plain convention on top of this, not special-cased: a handler mutates a shared
+ * `context` object (`{ skip: false }`, say) the same way any other side effect would, and
+ * the battle loop reads it back after `emit` returns.
+ *
+ * The registry itself is `core.HookRegistry`, shared with `roguelike.CombatHooks`. What is
+ * battle-specific is only the shape of what a handler receives: the creature the event is
+ * about, plus that optional shared context.
+ */
+export class BattleHooks extends HookRegistry {
 }
 //# sourceMappingURL=Hooks.js.map

package/dist/battle/Hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"Hooks.js","sourceRoot":"","sources":["../../src/battle/Hooks.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,WAAW;IAAxB;QACS,UAAK,GAAoB,EAAE,CAAC;IAiBrC,CAAC;IAfA,EAAE,CAAC,KAAa,EAAE,OAAiD,EAAE,MAAgB;QACpF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,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,QAAW,EAAE,OAAiB;QACjD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;gBAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3D,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"Hooks.js","sourceRoot":"","sources":["../../src/battle/Hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,WAAe,SAAQ,YAA8C;CAAG"}

package/dist/core/Feedback.d.ts

@@ -1,22 +1,16 @@
+import { HttpTransport, type HttpTransportOptions } from './HttpTransport.ts';
 export interface FeedbackRequest {
     message: string;
     contact?: string;
     context?: Record<string, string | number | boolean>;
 }
-export interface FeedbackOptions {
-    endpoint: string;
-    timeoutMs?: number;
-    fetch?: typeof globalThis.fetch;
-}
+export type FeedbackOptions = HttpTransportOptions;
 export interface FeedbackResponse {
     ok: boolean;
     status: number;
 }
 /** Small, injectable transport for a game's own feedback endpoint. */
-export declare class FeedbackClient {
-    private readonly endpoint;
-    private readonly timeoutMs;
-    private readonly fetchFn;
+export declare class FeedbackClient extends HttpTransport {
     constructor(options: FeedbackOptions);
     submit(request: FeedbackRequest): Promise<FeedbackResponse>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"Feedback.d.ts","sourceRoot":"","sources":["../../src/core/Feedback.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CACf;AAED,sEAAsE;AACtE,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAElD,YAAY,OAAO,EAAE,eAAe,EAOnC;IAEK,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgBhE;CACD"}
+{"version":3,"file":"Feedback.d.ts","sourceRoot":"","sources":["../../src/core/Feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACpD;AAED,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CACf;AAED,sEAAsE;AACtE,qBAAa,cAAe,SAAQ,aAAa;IAChD,YAAY,OAAO,EAAE,eAAe,EAEnC;IAEK,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAYhE;CACD"}

package/dist/core/Feedback.js

@@ -1,35 +1,23 @@
+import { HttpTransport } from './HttpTransport.js';
 /** Small, injectable transport for a game's own feedback endpoint. */
-export class FeedbackClient {
+export class FeedbackClient extends HttpTransport {
     constructor(options) {
-        if (!options.endpoint)
-            throw new Error('feedback endpoint is required');
-        this.endpoint = options.endpoint;
-        this.timeoutMs = options.timeoutMs ?? 10000;
-        if (!(this.timeoutMs > 0))
-            throw new Error('feedback timeout must be positive');
-        this.fetchFn = options.fetch ?? globalThis.fetch;
-        if (!this.fetchFn)
-            throw new Error('fetch is unavailable; provide FeedbackOptions.fetch');
+        super(options, 'feedback');
     }
     async submit(request) {
         if (!request.message?.trim())
             throw new Error('feedback message cannot be empty');
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
-        try {
+        return this.withTimeout(async (signal) => {
             const response = await this.fetchFn(this.endpoint, {
                 method: 'POST',
                 headers: { 'content-type': 'application/json' },
                 body: JSON.stringify(request),
-                signal: controller.signal,
+                signal,
             });
             if (!response.ok)
                 throw new Error(`feedback request failed with HTTP ${response.status}`);
             return { ok: true, status: response.status };
-        }
-        finally {
-            clearTimeout(timer);
-        }
+        });
     }
 }
 //# sourceMappingURL=Feedback.js.map

package/dist/core/Feedback.js.map

@@ -1 +1 @@
-{"version":3,"file":"Feedback.js","sourceRoot":"","sources":["../../src/core/Feedback.ts"],"names":[],"mappings":"AAiBA,sEAAsE;AACtE,MAAM,OAAO,cAAc;IAK1B,YAAY,OAAwB;QACnC,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAChF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAC3F,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAwB;QACpC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAClF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACnE,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE;gBAClD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;aACzB,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1F,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC9C,CAAC;gBAAS,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"Feedback.js","sourceRoot":"","sources":["../../src/core/Feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA6B,MAAM,oBAAoB,CAAC;AAe9E,sEAAsE;AACtE,MAAM,OAAO,cAAe,SAAQ,aAAa;IAChD,YAAY,OAAwB;QACnC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAwB;QACpC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAClF,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE;gBAClD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC7B,MAAM;aACN,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1F,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC9C,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/core/Hooks.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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.
+ */
+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

@@ -0,0 +1 @@
+{"version":3,"file":"Hooks.d.ts","sourceRoot":"","sources":["../../src/core/Hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;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

@@ -0,0 +1,33 @@
+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

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

@@ -0,0 +1,22 @@
+export interface HttpTransportOptions {
+    endpoint: string;
+    timeoutMs?: number;
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * The constructor validation and timeout-wrapped fetch shared by every injectable HTTPS
+ * transport here (`FeedbackClient`, `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).
+ */
+export declare abstract class HttpTransport {
+    protected readonly endpoint: string;
+    protected readonly timeoutMs: number;
+    protected readonly fetchFn: typeof globalThis.fetch;
+    constructor(options: HttpTransportOptions, label: string);
+    protected withTimeout<T>(run: (signal: AbortSignal) => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=HttpTransport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HttpTransport.d.ts","sourceRoot":"","sources":["../../src/core/HttpTransport.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC;AAED;;;;;;;;GAQG;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;IAEpD,YAAY,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAOvD;IAED,UAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQnF;CACD"}

package/dist/core/HttpTransport.js

@@ -0,0 +1,33 @@
+/**
+ * The constructor validation and timeout-wrapped fetch shared by every injectable HTTPS
+ * transport here (`FeedbackClient`, `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).
+ */
+export class HttpTransport {
+    constructor(options, label) {
+        if (!options.endpoint)
+            throw new Error(`${label} endpoint is required`);
+        this.endpoint = options.endpoint;
+        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);
+        }
+    }
+}
+//# sourceMappingURL=HttpTransport.js.map

package/dist/core/HttpTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpTransport.js","sourceRoot":"","sources":["../../src/core/HttpTransport.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,MAAM,OAAgB,aAAa;IAKlC,YAAY,OAA6B,EAAE,KAAa;QACvD,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,uBAAuB,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,2BAA2B,CAAC,CAAC;QAChF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,eAAe,CAAC,CAAC;IAC3F,CAAC;IAES,KAAK,CAAC,WAAW,CAAI,GAAwC;QACtE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACnE,IAAI,CAAC;YACJ,OAAO,MAAM,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;gBAAS,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACF,CAAC;CACD"}