@deadair/plugin-sdk 0.52.2 → 0.54.0

package/dist/plugin.config.fields.d.ts

@@ -205,8 +205,8 @@ export interface ConfigFieldColumn {
      * rule that hid a cell there would hide it on the one row that most needs filling in.
      *
      * A `secret` cell that does not apply keeps whatever is stored rather than being cleared.
-     * Absent already means "keep it" in `plugin.config.rows.ts`, and reading a visibility rule as
-     * an instruction to destroy a credential would be a surprise nobody asked for.
+     * Absent already means "keep it" in the host's `shared/config.rows.ts`, and reading a visibility
+     * rule as an instruction to destroy a credential would be a surprise nobody asked for.
      */
     dependsOn?: string;
     /**
@@ -216,6 +216,12 @@ export interface ConfigFieldColumn {
      * an author who knows that one knows this.
      */
     dependsOnValues?: string[];
+    /**
+     * Key of the `url` (or `string`) column in the same list that this `secret` cell is SENT to.
+     * Ignored on every other type. See {@link ConfigField.sentTo}, which is the same declaration for
+     * a field: a row whose address moves to another origin has to have its credential typed again.
+     */
+    sentTo?: string;
 }
 /**
  * The chosen values of a `multiselect`, out of the string it is stored as.
@@ -418,7 +424,35 @@ export interface ConfigField {
      * for that.
      */
     rangeWith?: string;
+    /**
+     * Key of the `url` (or `string`) field in the same form that this `secret` is SENT to. Ignored
+     * on every other type.
+     *
+     * A secret is write-only and an omitted one is kept, which is what lets an operator save the
+     * rest of a form without retyping a key. Without this, the same rule lets anybody allowed to
+     * save the form point the address at a server of their own and have the station send it a
+     * credential the console never shows them. Declared, the host refuses a save that KEEPS this
+     * secret while moving the field it names to another origin (scheme, host and port), and asks
+     * for the secret again. A changed path on the same server is not a move, and a secret typed
+     * fresh or cleared in the same save is never refused.
+     *
+     * Declare it on every secret that goes to an address the operator types. Leave it off one that
+     * goes to a fixed vendor whatever the form says: there is no address to move.
+     *
+     * A field that is empty counts as wherever the field's `default` points, or as "no address" if
+     * there is none, so filling in an address that was empty is a move too.
+     */
+    sentTo?: string;
 }
+/**
+ * What is wrong with the `sentTo` declarations in one form, as sentences. Empty when nothing is.
+ *
+ * A `sentTo` naming nothing would be worse than none at all: the host would compare an address that
+ * is never there with itself, find nothing moved, and the protection the author meant to declare
+ * would be silently off. So the manifest schema refuses one, at load, and a station setting's
+ * registry test asks the same question of the station's own form.
+ */
+export declare function sentToProblems(fields: readonly ConfigField[]): string[];
 export declare const configFieldOptionSchema: z.ZodObject<{
     value: z.ZodString;
     label: z.ZodString;
@@ -503,6 +537,7 @@ export declare const configFieldColumnSchema: z.ZodObject<{
     }>>;
     dependsOn: z.ZodOptional<z.ZodString>;
     dependsOnValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sentTo: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const configFieldPresetSchema: z.ZodObject<{
     label: z.ZodString;
@@ -585,6 +620,7 @@ export declare const configFieldSchema: z.ZodObject<{
         }>>;
         dependsOn: z.ZodOptional<z.ZodString>;
         dependsOnValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sentTo: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     presets: z.ZodOptional<z.ZodArray<z.ZodObject<{
         label: z.ZodString;
@@ -592,6 +628,7 @@ export declare const configFieldSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     dependsOn: z.ZodOptional<z.ZodString>;
     rangeWith: z.ZodOptional<z.ZodString>;
+    sentTo: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export {};
 //# sourceMappingURL=plugin.config.fields.d.ts.map

package/dist/plugin.config.fields.d.ts.map

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

package/dist/plugin.error.d.ts

@@ -107,6 +107,19 @@ export declare class PluginError extends Error {
      * Diagnostic only: the host never forwards it as its own response status.
      */
     upstreamStatus?: number;
+    /**
+     * The upstream's own code for what went wrong, as it sent it: Last.fm's
+     * error number, Spotify's `reason`, an analyzer's `unfetchable` against
+     * `undecodable`. Finer than {@link code}, which is the host's vocabulary
+     * and the only thing the host maps to a response.
+     *
+     * This is the one place for it. A subclass that wants to branch on its
+     * upstream's code reads it here rather than declaring a field of its own,
+     * so the code survives the invoker's wrapping and reaches the host's logs.
+     * A capability that reads it says which values it knows, and the host
+     * ignores one it does not.
+     */
+    upstreamCode?: string | number;
     constructor(message: string, options?: {
         cause?: unknown;
     });
@@ -119,6 +132,7 @@ export declare class PluginError extends Error {
      */
     withRetry(retryAfterMs: number): this;
     withUpstreamStatus(upstreamStatus: number): this;
+    withUpstreamCode(upstreamCode: string | number): this;
 }
 /**
  * Whether `value` is one of ours: an error this copy of the module built.

package/dist/plugin.error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.error.d.ts","sourceRoot":"","sources":["../src/plugin.error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,eAAe;AACvB,qFAAqF;AACnF,MAAM;AACR,8FAA8F;GAC5F,QAAQ;AACV,kFAAkF;GAChF,WAAW;AACb;;;;GAIG;GACD,WAAW;AACb,wEAAwE;GACtE,cAAc;AAChB,uCAAuC;GACrC,SAAS;AACX,gEAAgE;GAC9D,aAAa;AACf,0DAA0D;GACxD,aAAa;AACf,6DAA6D;GAC3D,UAAU;AACZ,oDAAoD;GAClD,UAAU,CAAC;AAEjB,+FAA+F;AAC/F,eAAO,MAAM,kBAAkB,wIAWrB,CAAC;AAoBX;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAEnE;AAwBD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,kBAAkB,eAAwC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAClC,uFAAuF;IACvF,QAAQ,CAAC,CAAC,kBAAkB,CAAC,QAAQ;IAErC,iGAAiG;IACjG,IAAI,EAAE,eAAe,CAAc;IACnC,yFAAyF;IACzF,SAAS,EAAE,OAAO,CAA8B;IAChD,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;IAW1D,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,eAAe;IAM9B;;;;OAIG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM;IAM9B,kBAAkB,CAAC,cAAc,EAAE,MAAM;CAI5C;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAEvD,CAAC;AAcF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,eAA4B,GAAG,WAAW,CAgBjG;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,MAAkE,CAAC"}
+{"version":3,"file":"plugin.error.d.ts","sourceRoot":"","sources":["../src/plugin.error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,eAAe;AACvB,qFAAqF;AACnF,MAAM;AACR,8FAA8F;GAC5F,QAAQ;AACV,kFAAkF;GAChF,WAAW;AACb;;;;GAIG;GACD,WAAW;AACb,wEAAwE;GACtE,cAAc;AAChB,uCAAuC;GACrC,SAAS;AACX,gEAAgE;GAC9D,aAAa;AACf,0DAA0D;GACxD,aAAa;AACf,6DAA6D;GAC3D,UAAU;AACZ,oDAAoD;GAClD,UAAU,CAAC;AAEjB,+FAA+F;AAC/F,eAAO,MAAM,kBAAkB,wIAWrB,CAAC;AAoBX;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAEnE;AAwBD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,kBAAkB,eAAwC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAClC,uFAAuF;IACvF,QAAQ,CAAC,CAAC,kBAAkB,CAAC,QAAQ;IAErC,iGAAiG;IACjG,IAAI,EAAE,eAAe,CAAc;IACnC,yFAAyF;IACzF,SAAS,EAAE,OAAO,CAA8B;IAChD,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;IAW1D,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,eAAe;IAM9B;;;;OAIG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM;IAM9B,kBAAkB,CAAC,cAAc,EAAE,MAAM;IAKzC,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;CAIjD;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAEvD,CAAC;AAcF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,eAA4B,GAAG,WAAW,CAkBjG;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,MAAkE,CAAC"}

package/dist/plugin.host.d.ts

@@ -216,6 +216,23 @@ export interface TrackFetchRequest {
     trackId: string;
     session: TrackFetchSession;
 }
+/**
+ * One record, asked of a PLAYER the station runs rather than of a protocol shim.
+ *
+ * No session, and that is the difference from {@link TrackFetchRequest} rather than an omission. A
+ * shim is lent a login per call because it speaks the provider's protocol as the operator's account.
+ * A player holds its own sign-in — an operator authorized it once, in a browser, and it keeps that —
+ * so there is nothing for the plugin to lend it and nothing it would do with a token if it had one.
+ *
+ * What is on the other side today is `stream/apple-player`: Chrome with a Widevine CDM driving Apple's
+ * own web player, recording what it plays. A provider whose audio can only be PERFORMED — decoded
+ * inside a player that will not hand over a URL — is the shape this exists for, and it is a different
+ * shape from Spotify's encrypted CDN, which is why it is a second method and not a flag on the first.
+ */
+export interface PlayerFetchRequest {
+    /** Provider-scoped track id, exactly as the plugin's own catalog reports it. */
+    trackId: string;
+}
 /**
  * One page of a playlist, asked of the fetcher rather than of the provider's own API.
  *
@@ -262,6 +279,18 @@ export interface PluginTrackFetcher {
      * stream side up is a normal state, not a fault.
      */
     serve(request: TrackFetchRequest): Promise<ProviderStream | undefined>;
+    /**
+     * Get a URL for one record from a player the station runs.
+     *
+     * Resolves to `undefined` on exactly the terms {@link PluginTrackFetcher.serve} does: this station
+     * has no such player configured, which a plugin passes straight through as "cannot resolve this
+     * item". An operator who has not set the stream side up is a normal state, not a fault.
+     *
+     * The URL it answers with is signed by the HOST and carries its own authorization, so it satisfies
+     * `resolveStreamUrl`'s contract unchanged — and it will take as long to fetch as the record takes
+     * to play, which is why the stream it comes back in carries `fetchBudgetMs`. Pass that through.
+     */
+    servePlayer(request: PlayerFetchRequest): Promise<ProviderStream | undefined>;
     /**
      * Read a page of a playlist your own API will not hand over.
      *

package/dist/plugin.host.d.ts.map

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

package/dist/plugin.manifest.d.ts

@@ -363,6 +363,7 @@ export declare const pluginManifestSchema: z.ZodObject<{
             }>>;
             dependsOn: z.ZodOptional<z.ZodString>;
             dependsOnValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            sentTo: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         presets: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodString;
@@ -370,6 +371,7 @@ export declare const pluginManifestSchema: z.ZodObject<{
         }, z.core.$strip>>>;
         dependsOn: z.ZodOptional<z.ZodString>;
         rangeWith: z.ZodOptional<z.ZodString>;
+        sentTo: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     configSchema: z.ZodCustom<PluginConfigSchema, PluginConfigSchema>;
 }, z.core.$strip>;

package/dist/plugin.manifest.d.ts.map

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

package/dist/testing/fake.plugin.host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fake.plugin.host.d.ts","sourceRoot":"","sources":["../../src/testing/fake.plugin.host.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,eAAe,EACf,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EAChB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;GAcG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC5C,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,uDAAuD;IACvD,QAAQ,IAAI,OAAO,EAAE,CAAC;IACtB,wDAAwD;IACxD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uCAAuC;IACvC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,uEAAuE;IACvE,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzD;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IACxD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC/C,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,uEAAuE;IACvE,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAC9C,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IACpC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mEAAmE;IACnE,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChD,yEAAyE;IACzE,YAAY,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACnF,sDAAsD;IACtD,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClD,wDAAwD;IACxD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,mEAAmE;IACnE,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,mEAAmE;IACnE,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,kDAAkD;IAClD,WAAW,IAAI,MAAM,EAAE,CAAC;IACxB,wEAAwE;IACxE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACjD,uEAAuE;IACvE,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACrD,0GAA0G;IAC1G,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAAC;IAC3D;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;IACvE,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IACrC,4FAA4F;IAC5F,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;IAC9C,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAC3C,yFAAyF;IACzF,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;IAC1C;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/E;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,cAAc,KAAK,iBAAiB,EAAE,CAAC,GAAG,IAAI,CAAC;CACtG;AAaD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,gBAAqB,GAAG,QAAQ,CAa3E;AAED,uGAAuG;AACvG,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAoCpE;AAED,+GAA+G;AAC/G,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,mBAAmB,CAiCtG;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAmIrD"}
+{"version":3,"file":"fake.plugin.host.d.ts","sourceRoot":"","sources":["../../src/testing/fake.plugin.host.ts"],"names":[],"mappings":"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"}

package/dist/testing/index.js

@@ -183,6 +183,11 @@ function createFakePluginHost() {
     },
     trackFetcher: {
       serve: vi.fn(async () => fetchedTrack),
+      // Answers the same canned stream as `serve`: a plugin under test cares that it asked the
+      // host for audio and passed the answer through, not which helper the station happens to run
+      // behind it. `fetchedTrack` is what a test sets to say "the station has a fetcher" or, as
+      // undefined, "it has not got one".
+      servePlayer: vi.fn(async () => fetchedTrack),
       playlistTracks: vi.fn(async () => {
         if (fetchedPlaylist instanceof Error) throw fetchedPlaylist;
         return fetchedPlaylist;

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/fake.plugin.host.ts"],"sourcesContent":["import { vi } from 'vitest';\n\nimport type {\n    DiscoveredService,\n    DiscoveryQuery,\n    HostFetchInit,\n    HostFetchMethod,\n    PluginHost,\n    PluginSocket,\n    PluginTlsOptions,\n    PluginTlsSocket,\n    ProviderStream,\n    ProviderTrack,\n} from '../index.js';\n\n/**\n * Shipped from the SDK rather than copied into each plugin, which three of them\n * were doing — two of those carrying a comment saying the copy was deliberate\n * because plugins do not depend on each other.\n *\n * That reasoning held for the copies and does not hold for this: every plugin\n * already depends on the SDK, and `PluginHost` is the SDK's own contract, so its\n * test double belongs beside the interface it doubles. A plugin importing this\n * gains no dependency on any other plugin. It also means a host method added to\n * the contract turns up in one fake rather than being added to three and\n * forgotten in the other three.\n *\n * Reached as `@deadair/plugin-sdk/testing`, which is kept out of the runtime\n * entry so nothing ships a dependency on vitest.\n */\n\n/** One `host.fetch` call, recorded with only the fields tests care about. */\nexport interface RecordedFetchCall {\n    url: string;\n    method: HostFetchMethod | undefined;\n    headers: Record<string, string> | undefined;\n    body: string | undefined;\n}\n\n/**\n * One `host.socket` the plugin opened, driven from the test: frames the plugin sent are in `sent`,\n * and `receive` / `closeFromServer` play the far end.\n */\nexport interface FakePluginSocket extends PluginSocket {\n    readonly url: string;\n    /** Every text frame the plugin sent, in order. */\n    readonly sent: string[];\n    /** Whether either end has closed it. */\n    readonly closed: boolean;\n    /** The frames the plugin sent, each parsed as JSON. */\n    sentJson(): unknown[];\n    /** Deliver one text frame to the plugin's listeners. */\n    receive(text: string): void;\n    /** Deliver `JSON.stringify(value)`. */\n    receiveJson(value: unknown): void;\n    /** Close it from the far end, telling the plugin's close listeners. */\n    closeFromServer(code?: number, reason?: string): void;\n}\n\n/**\n * One `host.tls` connection the plugin opened, driven from the test: bytes the plugin wrote are in\n * `sent`, and `receive` / `closeFromServer` play the device.\n */\nexport interface FakePluginTlsSocket extends PluginTlsSocket {\n    readonly url: string;\n    /** The options the plugin opened it with. */\n    readonly options: PluginTlsOptions | undefined;\n    /** Every write the plugin made, in order, one entry per `send`. */\n    readonly sent: Uint8Array[];\n    /** Whether either end has closed it. */\n    readonly closed: boolean;\n    /** Deliver one chunk to the plugin's data listeners. */\n    receive(bytes: Uint8Array): void;\n    /** Close it from the far end, telling the plugin's close listeners. */\n    closeFromServer(reason?: string): void;\n}\n\n/**\n * A `PluginHost` for tests. `fetch` replays a queue of scripted\n * `Response`s (FIFO, one per call) — or a custom handler installed\n * with `setFetchImpl`, for call-count-driven scenarios like a 401-then-200\n * retry — and records every call it received in `calls`. `storage`, `config`,\n * `secrets` and the `oauth` vault are in-memory and can be seeded or read\n * directly, bypassing the `PluginHost` methods, so a test can assert on state\n * without going through the code under test twice.\n */\nexport interface FakePluginHost extends PluginHost {\n    /** Every `host.fetch` call so far, in call order. */\n    readonly calls: RecordedFetchCall[];\n    /** Set what `host.remainingMs()` reports, for testing budget shedding. */\n    seedRemainingMs(ms: number): void;\n    /** Push one scripted response onto the back of the reply queue. */\n    queueResponse(response: FakeResponseInit): void;\n    /** Replace the fetch handler outright; overrides the queue while set. */\n    setFetchImpl(impl: (url: string, init?: HostFetchInit) => Promise<Response>): void;\n    /** Seed the value `host.config.get()` resolves to. */\n    seedConfig(config: Record<string, unknown>): void;\n    /** Seed a value `host.secrets.get(key)` resolves to. */\n    seedSecret(key: string, value: string): void;\n    /** Seed a storage entry directly, bypassing `host.storage.set`. */\n    seedStorage(key: string, value: unknown): void;\n    /** Read a storage entry directly, bypassing `host.storage.get`. */\n    getStorageEntry(key: string): unknown;\n    /** All storage keys currently set, unfiltered. */\n    storageKeys(): string[];\n    /** Seed the oauth vault directly, bypassing `host.oauth.saveTokens`. */\n    seedTokens(tokens: Record<string, string>): void;\n    /** Read the oauth vault directly, bypassing `host.oauth.getTokens`. */\n    getVaultTokens(): Record<string, string> | undefined;\n    /** Set what `host.trackFetcher.serve()` answers with; `undefined` means \"this station has no fetcher\". */\n    seedFetchedTrack(stream: ProviderStream | undefined): void;\n    /**\n     * Set what `host.trackFetcher.playlistTracks()` answers with. `undefined` means \"this station\n     * has no fetcher\"; pass an `Error` to make it throw, which is the fetcher having tried and\n     * failed and is a different case for a plugin to handle.\n     */\n    seedFetchedPlaylist(tracks: ProviderTrack[] | Error | undefined): void;\n    /** Every socket `host.socket` opened, in order, closed ones included. */\n    readonly sockets: FakePluginSocket[];\n    /** Make every later `host.socket` reject with `error`; `undefined` lets them open again. */\n    refuseSockets(error: Error | undefined): void;\n    /** Every connection `host.tls` opened, in order, closed ones included. */\n    readonly tlsSockets: FakePluginTlsSocket[];\n    /** Make every later `host.tls` reject with `error`; `undefined` lets them open again. */\n    refuseTls(error: Error | undefined): void;\n    /**\n     * Called with each connection as `host.tls` opens it, before the plugin sees it, so a test can\n     * script the device's answers to whatever the plugin writes.\n     */\n    onTlsOpen(listener: ((socket: FakePluginTlsSocket) => void) | undefined): void;\n    /**\n     * What `host.discover` answers from now on: a fixed list, or one worked out per query. Nothing\n     * is found until a test says otherwise, which is what a station on a bridge network sees.\n     */\n    seedDiscovery(found: DiscoveredService[] | ((query: DiscoveryQuery) => DiscoveredService[])): void;\n}\n\n/**\n * What `host.remainingMs()` reports unless a test says otherwise: what a live\n * call reads on its first line. The host's default per-call deadline is 8s, and\n * the clock has already been running for a few milliseconds by the time plugin\n * code asks, so a live call never sees the whole 8s. A plugin that refuses to\n * start unless a full request timeout is left therefore never starts at all,\n * and a default above the real deadline hid exactly that: every test passed\n * while every live call returned nothing.\n */\nconst DEFAULT_REMAINING_MS = 8_000 - 5;\n\n/**\n * What a test says a scripted reply should be.\n *\n * Not `ResponseInit`, because `url` is not on it: `host.fetch` reports the last\n * hop of the redirect chain there, and a `Response` built by hand has an empty\n * one unless it is defined in.\n */\nexport interface FakeResponseInit {\n    status?: number;\n    statusText?: string;\n    headers?: Record<string, string>;\n    /**\n     * Text for a JSON or error reply, bytes for a binary one.\n     *\n     * `Uint8Array<ArrayBuffer>` rather than a bare `Uint8Array`: the DOM lib's\n     * `BodyInit` accepts a view over a real `ArrayBuffer`, and the unparameterized\n     * form widens to `ArrayBufferLike`, which includes `SharedArrayBuffer` and is\n     * not something `Response` will take. `new Uint8Array([...])` already has the\n     * narrow type, so no test has to say so.\n     */\n    body?: string | Uint8Array<ArrayBuffer>;\n    url?: string;\n}\n\n/** Statuses whose `Response` must carry a null body, or the constructor throws. */\nconst NULL_BODY_STATUSES = new Set([101, 204, 205, 304]);\n\n/** Builds a default 200 `Response`, overridable field by field. */\nexport function fakeHostFetchResponse(init: FakeResponseInit = {}): Response {\n    const status = init.status ?? 200;\n\n    const response = new Response(NULL_BODY_STATUSES.has(status) ? null : (init.body ?? ''), {\n        status,\n        statusText: init.statusText ?? 'OK',\n        headers: init.headers ?? { 'content-type': 'application/json' },\n    });\n\n    // Read-only on a constructed response, and part of what the host promises.\n    Object.defineProperty(response, 'url', { value: init.url ?? 'https://example.test/' });\n\n    return response;\n}\n\n/** A socket that is open until either end closes it. Exported for a test that wants one on its own. */\nexport function createFakePluginSocket(url: string): FakePluginSocket {\n    const messageListeners: ((text: string) => void)[] = [];\n    const closeListeners: ((code?: number, reason?: string) => void)[] = [];\n    const sent: string[] = [];\n    let closed = false;\n\n    const shut = (code: number | undefined, reason: string | undefined): void => {\n        if (closed) return;\n        closed = true;\n        for (const listener of closeListeners) listener(code, reason);\n    };\n\n    return {\n        url,\n        sent,\n        get closed() {\n            return closed;\n        },\n        send: vi.fn((text: string) => {\n            if (!closed) sent.push(text);\n        }),\n        close: vi.fn((code?: number, reason?: string) => shut(code ?? 1000, reason)),\n        onMessage: listener => void messageListeners.push(listener),\n        onClose: listener => void closeListeners.push(listener),\n        sentJson: () => sent.map(text => JSON.parse(text) as unknown),\n        receive(text) {\n            if (closed) throw new Error(`fake plugin socket: ${url} is closed`);\n            for (const listener of messageListeners) listener(text);\n        },\n        receiveJson(value) {\n            this.receive(JSON.stringify(value));\n        },\n        closeFromServer(code = 1000, reason = '') {\n            shut(code, reason);\n        },\n    };\n}\n\n/** A TLS connection that is open until either end closes it. Exported for a test that wants one on its own. */\nexport function createFakePluginTlsSocket(url: string, options?: PluginTlsOptions): FakePluginTlsSocket {\n    const dataListeners: ((bytes: Uint8Array) => void)[] = [];\n    const closeListeners: ((reason?: string) => void)[] = [];\n    const sent: Uint8Array[] = [];\n    let closed = false;\n\n    const shut = (reason: string | undefined): void => {\n        if (closed) return;\n        closed = true;\n        for (const listener of closeListeners) listener(reason);\n    };\n\n    return {\n        url,\n        options,\n        sent,\n        get closed() {\n            return closed;\n        },\n        send: vi.fn((bytes: Uint8Array) => {\n            if (!closed) sent.push(bytes);\n        }),\n        close: vi.fn(() => shut(undefined)),\n        onData: listener => void dataListeners.push(listener),\n        onClose: listener => void closeListeners.push(listener),\n        receive(bytes) {\n            if (closed) throw new Error(`fake plugin tls socket: ${url} is closed`);\n            for (const listener of dataListeners) listener(bytes);\n        },\n        closeFromServer(reason) {\n            shut(reason);\n        },\n    };\n}\n\nexport function createFakePluginHost(): FakePluginHost {\n    const calls: RecordedFetchCall[] = [];\n    const queue: Response[] = [];\n    let customImpl: ((url: string, init?: HostFetchInit) => Promise<Response>) | undefined;\n\n    const storageData = new Map<string, unknown>();\n    let configData: Record<string, unknown> = {};\n    const secretsData = new Map<string, string>();\n    let tokens: Record<string, string> | undefined;\n    let remainingMs = DEFAULT_REMAINING_MS;\n    let fetchedTrack: ProviderStream | undefined = { url: 'http://127.0.0.1:3679/track/song-1?t=signed', expiresAt: 1_893_456_000_000 };\n    // Nothing by default: a plugin should ask its own API first, and a test that means to exercise\n    // the fetcher says so.\n    let fetchedPlaylist: ProviderTrack[] | Error | undefined;\n    const sockets: FakePluginSocket[] = [];\n    let socketRefusal: Error | undefined;\n    const tlsSockets: FakePluginTlsSocket[] = [];\n    let tlsRefusal: Error | undefined;\n    let tlsOpened: ((socket: FakePluginTlsSocket) => void) | undefined;\n    let discovered: (query: DiscoveryQuery) => DiscoveredService[] = () => [];\n\n    const fetchImpl = vi.fn(async (url: string, init?: HostFetchInit): Promise<Response> => {\n        calls.push({ url, method: init?.method, headers: init?.headers, body: init?.body });\n        if (customImpl) return customImpl(url, init);\n        const next = queue.shift();\n        if (!next) throw new Error(`fake plugin host: no response queued for ${init?.method ?? 'GET'} ${url}`);\n        return next;\n    });\n\n    const host: FakePluginHost = {\n        logger: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },\n        fetch: fetchImpl,\n        socket: vi.fn(async (url: string) => {\n            if (socketRefusal !== undefined) throw socketRefusal;\n            const socket = createFakePluginSocket(url);\n            sockets.push(socket);\n            return socket;\n        }),\n        tls: vi.fn(async (url: string, options?: PluginTlsOptions) => {\n            if (tlsRefusal !== undefined) throw tlsRefusal;\n            const socket = createFakePluginTlsSocket(url, options);\n            tlsSockets.push(socket);\n            tlsOpened?.(socket);\n            return socket;\n        }),\n        discover: vi.fn(async (query: DiscoveryQuery) => discovered(query)),\n        // Never aborts: these tests are about what a plugin does with a reply,\n        // not about being cancelled half way through one.\n        signal: new AbortController().signal,\n        remainingMs: vi.fn(() => remainingMs),\n        storage: {\n            get: vi.fn(async (key: string) => storageData.get(key)),\n            set: vi.fn(async (key: string, value: unknown) => {\n                storageData.set(key, value);\n            }),\n            delete: vi.fn(async (key: string) => {\n                storageData.delete(key);\n            }),\n            list: vi.fn(async (prefix?: string) => [...storageData.keys()].filter(key => !prefix || key.startsWith(prefix))),\n        },\n        secrets: { get: vi.fn(async (key: string) => secretsData.get(key)) },\n        config: { get: vi.fn(async () => configData) },\n        oauth: {\n            getRedirectUri: vi.fn(async () => 'https://example.test/callback'),\n            saveTokens: vi.fn(async (next: Record<string, string>) => {\n                tokens = next;\n            }),\n            getTokens: vi.fn(async () => tokens),\n        },\n        events: { emit: vi.fn() },\n        trackFetcher: {\n            serve: vi.fn(async () => fetchedTrack),\n            playlistTracks: vi.fn(async () => {\n                if (fetchedPlaylist instanceof Error) throw fetchedPlaylist;\n                return fetchedPlaylist;\n            }),\n        },\n        calls,\n        sockets,\n        refuseSockets(error) {\n            socketRefusal = error;\n        },\n        tlsSockets,\n        refuseTls(error) {\n            tlsRefusal = error;\n        },\n        onTlsOpen(listener) {\n            tlsOpened = listener;\n        },\n        seedDiscovery(found) {\n            discovered = typeof found === 'function' ? found : () => found;\n        },\n        seedRemainingMs(ms) {\n            remainingMs = ms;\n        },\n        queueResponse(response: FakeResponseInit) {\n            queue.push(fakeHostFetchResponse(response));\n        },\n        setFetchImpl(impl) {\n            customImpl = impl;\n        },\n        seedConfig(config) {\n            configData = config;\n        },\n        seedSecret(key, value) {\n            secretsData.set(key, value);\n        },\n        seedStorage(key, value) {\n            storageData.set(key, value);\n        },\n        getStorageEntry(key) {\n            return storageData.get(key);\n        },\n        storageKeys() {\n            return [...storageData.keys()];\n        },\n        seedTokens(next) {\n            tokens = next;\n        },\n        getVaultTokens() {\n            return tokens;\n        },\n        seedFetchedTrack(stream) {\n            fetchedTrack = stream;\n        },\n        seedFetchedPlaylist(tracks) {\n            fetchedPlaylist = tracks;\n        },\n    };\n\n    return host;\n}\n"],"mappings":"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","names":["vi","DEFAULT_REMAINING_MS","NULL_BODY_STATUSES","Set","fakeHostFetchResponse","init","status","response","Response","has","body","statusText","headers","Object","defineProperty","value","url","createFakePluginSocket","messageListeners","closeListeners","sent","closed","shut","code","reason","listener","send","vi","fn","text","push","close","onMessage","onClose","sentJson","map","JSON","parse","receive","Error","receiveJson","stringify","closeFromServer","createFakePluginTlsSocket","options","dataListeners","bytes","undefined","onData","createFakePluginHost","calls","queue","customImpl","storageData","Map","configData","secretsData","tokens","remainingMs","fetchedTrack","expiresAt","fetchedPlaylist","sockets","socketRefusal","tlsSockets","tlsRefusal","tlsOpened","discovered","fetchImpl","method","next","shift","host","logger","debug","info","warn","error","fetch","socket","tls","discover","query","signal","AbortController","storage","get","key","set","delete","list","prefix","keys","filter","startsWith","secrets","config","oauth","getRedirectUri","saveTokens","getTokens","events","emit","trackFetcher","serve","playlistTracks","refuseSockets","refuseTls","onTlsOpen","seedDiscovery","found","seedRemainingMs","ms","queueResponse","setFetchImpl","impl","seedConfig","seedSecret","seedStorage","getStorageEntry","storageKeys","seedTokens","getVaultTokens","seedFetchedTrack","stream","seedFetchedPlaylist","tracks"]}
+{"version":3,"sources":["../../src/testing/fake.plugin.host.ts"],"sourcesContent":["import { vi } from 'vitest';\n\nimport type {\n    DiscoveredService,\n    DiscoveryQuery,\n    HostFetchInit,\n    HostFetchMethod,\n    PluginHost,\n    PluginSocket,\n    PluginTlsOptions,\n    PluginTlsSocket,\n    ProviderStream,\n    ProviderTrack,\n} from '../index.js';\n\n/**\n * Shipped from the SDK rather than copied into each plugin, which three of them\n * were doing — two of those carrying a comment saying the copy was deliberate\n * because plugins do not depend on each other.\n *\n * That reasoning held for the copies and does not hold for this: every plugin\n * already depends on the SDK, and `PluginHost` is the SDK's own contract, so its\n * test double belongs beside the interface it doubles. A plugin importing this\n * gains no dependency on any other plugin. It also means a host method added to\n * the contract turns up in one fake rather than being added to three and\n * forgotten in the other three.\n *\n * Reached as `@deadair/plugin-sdk/testing`, which is kept out of the runtime\n * entry so nothing ships a dependency on vitest.\n */\n\n/** One `host.fetch` call, recorded with only the fields tests care about. */\nexport interface RecordedFetchCall {\n    url: string;\n    method: HostFetchMethod | undefined;\n    headers: Record<string, string> | undefined;\n    body: string | undefined;\n}\n\n/**\n * One `host.socket` the plugin opened, driven from the test: frames the plugin sent are in `sent`,\n * and `receive` / `closeFromServer` play the far end.\n */\nexport interface FakePluginSocket extends PluginSocket {\n    readonly url: string;\n    /** Every text frame the plugin sent, in order. */\n    readonly sent: string[];\n    /** Whether either end has closed it. */\n    readonly closed: boolean;\n    /** The frames the plugin sent, each parsed as JSON. */\n    sentJson(): unknown[];\n    /** Deliver one text frame to the plugin's listeners. */\n    receive(text: string): void;\n    /** Deliver `JSON.stringify(value)`. */\n    receiveJson(value: unknown): void;\n    /** Close it from the far end, telling the plugin's close listeners. */\n    closeFromServer(code?: number, reason?: string): void;\n}\n\n/**\n * One `host.tls` connection the plugin opened, driven from the test: bytes the plugin wrote are in\n * `sent`, and `receive` / `closeFromServer` play the device.\n */\nexport interface FakePluginTlsSocket extends PluginTlsSocket {\n    readonly url: string;\n    /** The options the plugin opened it with. */\n    readonly options: PluginTlsOptions | undefined;\n    /** Every write the plugin made, in order, one entry per `send`. */\n    readonly sent: Uint8Array[];\n    /** Whether either end has closed it. */\n    readonly closed: boolean;\n    /** Deliver one chunk to the plugin's data listeners. */\n    receive(bytes: Uint8Array): void;\n    /** Close it from the far end, telling the plugin's close listeners. */\n    closeFromServer(reason?: string): void;\n}\n\n/**\n * A `PluginHost` for tests. `fetch` replays a queue of scripted\n * `Response`s (FIFO, one per call) — or a custom handler installed\n * with `setFetchImpl`, for call-count-driven scenarios like a 401-then-200\n * retry — and records every call it received in `calls`. `storage`, `config`,\n * `secrets` and the `oauth` vault are in-memory and can be seeded or read\n * directly, bypassing the `PluginHost` methods, so a test can assert on state\n * without going through the code under test twice.\n */\nexport interface FakePluginHost extends PluginHost {\n    /** Every `host.fetch` call so far, in call order. */\n    readonly calls: RecordedFetchCall[];\n    /** Set what `host.remainingMs()` reports, for testing budget shedding. */\n    seedRemainingMs(ms: number): void;\n    /** Push one scripted response onto the back of the reply queue. */\n    queueResponse(response: FakeResponseInit): void;\n    /** Replace the fetch handler outright; overrides the queue while set. */\n    setFetchImpl(impl: (url: string, init?: HostFetchInit) => Promise<Response>): void;\n    /** Seed the value `host.config.get()` resolves to. */\n    seedConfig(config: Record<string, unknown>): void;\n    /** Seed a value `host.secrets.get(key)` resolves to. */\n    seedSecret(key: string, value: string): void;\n    /** Seed a storage entry directly, bypassing `host.storage.set`. */\n    seedStorage(key: string, value: unknown): void;\n    /** Read a storage entry directly, bypassing `host.storage.get`. */\n    getStorageEntry(key: string): unknown;\n    /** All storage keys currently set, unfiltered. */\n    storageKeys(): string[];\n    /** Seed the oauth vault directly, bypassing `host.oauth.saveTokens`. */\n    seedTokens(tokens: Record<string, string>): void;\n    /** Read the oauth vault directly, bypassing `host.oauth.getTokens`. */\n    getVaultTokens(): Record<string, string> | undefined;\n    /** Set what `host.trackFetcher.serve()` answers with; `undefined` means \"this station has no fetcher\". */\n    seedFetchedTrack(stream: ProviderStream | undefined): void;\n    /**\n     * Set what `host.trackFetcher.playlistTracks()` answers with. `undefined` means \"this station\n     * has no fetcher\"; pass an `Error` to make it throw, which is the fetcher having tried and\n     * failed and is a different case for a plugin to handle.\n     */\n    seedFetchedPlaylist(tracks: ProviderTrack[] | Error | undefined): void;\n    /** Every socket `host.socket` opened, in order, closed ones included. */\n    readonly sockets: FakePluginSocket[];\n    /** Make every later `host.socket` reject with `error`; `undefined` lets them open again. */\n    refuseSockets(error: Error | undefined): void;\n    /** Every connection `host.tls` opened, in order, closed ones included. */\n    readonly tlsSockets: FakePluginTlsSocket[];\n    /** Make every later `host.tls` reject with `error`; `undefined` lets them open again. */\n    refuseTls(error: Error | undefined): void;\n    /**\n     * Called with each connection as `host.tls` opens it, before the plugin sees it, so a test can\n     * script the device's answers to whatever the plugin writes.\n     */\n    onTlsOpen(listener: ((socket: FakePluginTlsSocket) => void) | undefined): void;\n    /**\n     * What `host.discover` answers from now on: a fixed list, or one worked out per query. Nothing\n     * is found until a test says otherwise, which is what a station on a bridge network sees.\n     */\n    seedDiscovery(found: DiscoveredService[] | ((query: DiscoveryQuery) => DiscoveredService[])): void;\n}\n\n/**\n * What `host.remainingMs()` reports unless a test says otherwise: what a live\n * call reads on its first line. The host's default per-call deadline is 8s, and\n * the clock has already been running for a few milliseconds by the time plugin\n * code asks, so a live call never sees the whole 8s. A plugin that refuses to\n * start unless a full request timeout is left therefore never starts at all,\n * and a default above the real deadline hid exactly that: every test passed\n * while every live call returned nothing.\n */\nconst DEFAULT_REMAINING_MS = 8_000 - 5;\n\n/**\n * What a test says a scripted reply should be.\n *\n * Not `ResponseInit`, because `url` is not on it: `host.fetch` reports the last\n * hop of the redirect chain there, and a `Response` built by hand has an empty\n * one unless it is defined in.\n */\nexport interface FakeResponseInit {\n    status?: number;\n    statusText?: string;\n    headers?: Record<string, string>;\n    /**\n     * Text for a JSON or error reply, bytes for a binary one.\n     *\n     * `Uint8Array<ArrayBuffer>` rather than a bare `Uint8Array`: the DOM lib's\n     * `BodyInit` accepts a view over a real `ArrayBuffer`, and the unparameterized\n     * form widens to `ArrayBufferLike`, which includes `SharedArrayBuffer` and is\n     * not something `Response` will take. `new Uint8Array([...])` already has the\n     * narrow type, so no test has to say so.\n     */\n    body?: string | Uint8Array<ArrayBuffer>;\n    url?: string;\n}\n\n/** Statuses whose `Response` must carry a null body, or the constructor throws. */\nconst NULL_BODY_STATUSES = new Set([101, 204, 205, 304]);\n\n/** Builds a default 200 `Response`, overridable field by field. */\nexport function fakeHostFetchResponse(init: FakeResponseInit = {}): Response {\n    const status = init.status ?? 200;\n\n    const response = new Response(NULL_BODY_STATUSES.has(status) ? null : (init.body ?? ''), {\n        status,\n        statusText: init.statusText ?? 'OK',\n        headers: init.headers ?? { 'content-type': 'application/json' },\n    });\n\n    // Read-only on a constructed response, and part of what the host promises.\n    Object.defineProperty(response, 'url', { value: init.url ?? 'https://example.test/' });\n\n    return response;\n}\n\n/** A socket that is open until either end closes it. Exported for a test that wants one on its own. */\nexport function createFakePluginSocket(url: string): FakePluginSocket {\n    const messageListeners: ((text: string) => void)[] = [];\n    const closeListeners: ((code?: number, reason?: string) => void)[] = [];\n    const sent: string[] = [];\n    let closed = false;\n\n    const shut = (code: number | undefined, reason: string | undefined): void => {\n        if (closed) return;\n        closed = true;\n        for (const listener of closeListeners) listener(code, reason);\n    };\n\n    return {\n        url,\n        sent,\n        get closed() {\n            return closed;\n        },\n        send: vi.fn((text: string) => {\n            if (!closed) sent.push(text);\n        }),\n        close: vi.fn((code?: number, reason?: string) => shut(code ?? 1000, reason)),\n        onMessage: listener => void messageListeners.push(listener),\n        onClose: listener => void closeListeners.push(listener),\n        sentJson: () => sent.map(text => JSON.parse(text) as unknown),\n        receive(text) {\n            if (closed) throw new Error(`fake plugin socket: ${url} is closed`);\n            for (const listener of messageListeners) listener(text);\n        },\n        receiveJson(value) {\n            this.receive(JSON.stringify(value));\n        },\n        closeFromServer(code = 1000, reason = '') {\n            shut(code, reason);\n        },\n    };\n}\n\n/** A TLS connection that is open until either end closes it. Exported for a test that wants one on its own. */\nexport function createFakePluginTlsSocket(url: string, options?: PluginTlsOptions): FakePluginTlsSocket {\n    const dataListeners: ((bytes: Uint8Array) => void)[] = [];\n    const closeListeners: ((reason?: string) => void)[] = [];\n    const sent: Uint8Array[] = [];\n    let closed = false;\n\n    const shut = (reason: string | undefined): void => {\n        if (closed) return;\n        closed = true;\n        for (const listener of closeListeners) listener(reason);\n    };\n\n    return {\n        url,\n        options,\n        sent,\n        get closed() {\n            return closed;\n        },\n        send: vi.fn((bytes: Uint8Array) => {\n            if (!closed) sent.push(bytes);\n        }),\n        close: vi.fn(() => shut(undefined)),\n        onData: listener => void dataListeners.push(listener),\n        onClose: listener => void closeListeners.push(listener),\n        receive(bytes) {\n            if (closed) throw new Error(`fake plugin tls socket: ${url} is closed`);\n            for (const listener of dataListeners) listener(bytes);\n        },\n        closeFromServer(reason) {\n            shut(reason);\n        },\n    };\n}\n\nexport function createFakePluginHost(): FakePluginHost {\n    const calls: RecordedFetchCall[] = [];\n    const queue: Response[] = [];\n    let customImpl: ((url: string, init?: HostFetchInit) => Promise<Response>) | undefined;\n\n    const storageData = new Map<string, unknown>();\n    let configData: Record<string, unknown> = {};\n    const secretsData = new Map<string, string>();\n    let tokens: Record<string, string> | undefined;\n    let remainingMs = DEFAULT_REMAINING_MS;\n    let fetchedTrack: ProviderStream | undefined = { url: 'http://127.0.0.1:3679/track/song-1?t=signed', expiresAt: 1_893_456_000_000 };\n    // Nothing by default: a plugin should ask its own API first, and a test that means to exercise\n    // the fetcher says so.\n    let fetchedPlaylist: ProviderTrack[] | Error | undefined;\n    const sockets: FakePluginSocket[] = [];\n    let socketRefusal: Error | undefined;\n    const tlsSockets: FakePluginTlsSocket[] = [];\n    let tlsRefusal: Error | undefined;\n    let tlsOpened: ((socket: FakePluginTlsSocket) => void) | undefined;\n    let discovered: (query: DiscoveryQuery) => DiscoveredService[] = () => [];\n\n    const fetchImpl = vi.fn(async (url: string, init?: HostFetchInit): Promise<Response> => {\n        calls.push({ url, method: init?.method, headers: init?.headers, body: init?.body });\n        if (customImpl) return customImpl(url, init);\n        const next = queue.shift();\n        if (!next) throw new Error(`fake plugin host: no response queued for ${init?.method ?? 'GET'} ${url}`);\n        return next;\n    });\n\n    const host: FakePluginHost = {\n        logger: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },\n        fetch: fetchImpl,\n        socket: vi.fn(async (url: string) => {\n            if (socketRefusal !== undefined) throw socketRefusal;\n            const socket = createFakePluginSocket(url);\n            sockets.push(socket);\n            return socket;\n        }),\n        tls: vi.fn(async (url: string, options?: PluginTlsOptions) => {\n            if (tlsRefusal !== undefined) throw tlsRefusal;\n            const socket = createFakePluginTlsSocket(url, options);\n            tlsSockets.push(socket);\n            tlsOpened?.(socket);\n            return socket;\n        }),\n        discover: vi.fn(async (query: DiscoveryQuery) => discovered(query)),\n        // Never aborts: these tests are about what a plugin does with a reply,\n        // not about being cancelled half way through one.\n        signal: new AbortController().signal,\n        remainingMs: vi.fn(() => remainingMs),\n        storage: {\n            get: vi.fn(async (key: string) => storageData.get(key)),\n            set: vi.fn(async (key: string, value: unknown) => {\n                storageData.set(key, value);\n            }),\n            delete: vi.fn(async (key: string) => {\n                storageData.delete(key);\n            }),\n            list: vi.fn(async (prefix?: string) => [...storageData.keys()].filter(key => !prefix || key.startsWith(prefix))),\n        },\n        secrets: { get: vi.fn(async (key: string) => secretsData.get(key)) },\n        config: { get: vi.fn(async () => configData) },\n        oauth: {\n            getRedirectUri: vi.fn(async () => 'https://example.test/callback'),\n            saveTokens: vi.fn(async (next: Record<string, string>) => {\n                tokens = next;\n            }),\n            getTokens: vi.fn(async () => tokens),\n        },\n        events: { emit: vi.fn() },\n        trackFetcher: {\n            serve: vi.fn(async () => fetchedTrack),\n            // Answers the same canned stream as `serve`: a plugin under test cares that it asked the\n            // host for audio and passed the answer through, not which helper the station happens to run\n            // behind it. `fetchedTrack` is what a test sets to say \"the station has a fetcher\" or, as\n            // undefined, \"it has not got one\".\n            servePlayer: vi.fn(async () => fetchedTrack),\n            playlistTracks: vi.fn(async () => {\n                if (fetchedPlaylist instanceof Error) throw fetchedPlaylist;\n                return fetchedPlaylist;\n            }),\n        },\n        calls,\n        sockets,\n        refuseSockets(error) {\n            socketRefusal = error;\n        },\n        tlsSockets,\n        refuseTls(error) {\n            tlsRefusal = error;\n        },\n        onTlsOpen(listener) {\n            tlsOpened = listener;\n        },\n        seedDiscovery(found) {\n            discovered = typeof found === 'function' ? found : () => found;\n        },\n        seedRemainingMs(ms) {\n            remainingMs = ms;\n        },\n        queueResponse(response: FakeResponseInit) {\n            queue.push(fakeHostFetchResponse(response));\n        },\n        setFetchImpl(impl) {\n            customImpl = impl;\n        },\n        seedConfig(config) {\n            configData = config;\n        },\n        seedSecret(key, value) {\n            secretsData.set(key, value);\n        },\n        seedStorage(key, value) {\n            storageData.set(key, value);\n        },\n        getStorageEntry(key) {\n            return storageData.get(key);\n        },\n        storageKeys() {\n            return [...storageData.keys()];\n        },\n        seedTokens(next) {\n            tokens = next;\n        },\n        getVaultTokens() {\n            return tokens;\n        },\n        seedFetchedTrack(stream) {\n            fetchedTrack = stream;\n        },\n        seedFetchedPlaylist(tracks) {\n            fetchedPlaylist = tracks;\n        },\n    };\n\n    return host;\n}\n"],"mappings":"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","names":["vi","DEFAULT_REMAINING_MS","NULL_BODY_STATUSES","Set","fakeHostFetchResponse","init","status","response","Response","has","body","statusText","headers","Object","defineProperty","value","url","createFakePluginSocket","messageListeners","closeListeners","sent","closed","shut","code","reason","listener","send","vi","fn","text","push","close","onMessage","onClose","sentJson","map","JSON","parse","receive","Error","receiveJson","stringify","closeFromServer","createFakePluginTlsSocket","options","dataListeners","bytes","undefined","onData","createFakePluginHost","calls","queue","customImpl","storageData","Map","configData","secretsData","tokens","remainingMs","fetchedTrack","expiresAt","fetchedPlaylist","sockets","socketRefusal","tlsSockets","tlsRefusal","tlsOpened","discovered","fetchImpl","method","next","shift","host","logger","debug","info","warn","error","fetch","socket","tls","discover","query","signal","AbortController","storage","get","key","set","delete","list","prefix","keys","filter","startsWith","secrets","config","oauth","getRedirectUri","saveTokens","getTokens","events","emit","trackFetcher","serve","servePlayer","playlistTracks","refuseSockets","refuseTls","onTlsOpen","seedDiscovery","found","seedRemainingMs","ms","queueResponse","setFetchImpl","impl","seedConfig","seedSecret","seedStorage","getStorageEntry","storageKeys","seedTokens","getVaultTokens","seedFetchedTrack","stream","seedFetchedPlaylist","tracks"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deadair/plugin-sdk",
-  "version": "0.52.2",
+  "version": "0.54.0",
   "description": "The contract a deadair plugin is written against: the manifest, the capabilities, the host it is handed, and a fake host for its tests.",
   "keywords": [
     "deadair",