@touchcastllc/napster-companion-api-dev 1.0.0-alpha.83 → 1.0.0-alpha.85

package/lib/services/micAccess.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Acquire the microphone, normalising any failure into a ConnectionError whose
+ * `context.name` carries the underlying DOMException ("NotAllowedError" vs
+ * "NotFoundError") so apps can tell a refusal from a missing device.
+ *
+ * The manager caches the stream, so every later caller reuses it and the user
+ * sees exactly one browser prompt per session.
+ */
+export declare function requestMicrophone(): Promise<void>;

package/lib/types/index.d.ts

@@ -530,6 +530,26 @@ export interface NapsterCompanionApiSDK {
      * when run inside the persistence site frame.
      */
     initWithButton(getToken: () => Promise<string>, config?: Partial<NapsterCompanionApiConfig>): import("../button").NapsterCompanionApiController;
+    /**
+     * Prompt for the microphone WITHOUT starting a session, so permission is settled
+     * before a connection token exists. A connection's lifetime starts the moment the
+     * backend creates it, and a prompt the user leaves open for seconds spends that
+     * budget before signaling runs — the session then fails to come up.
+     *
+     * `initWithButton` does this internally. Use it on the `init` path, where the host
+     * app owns when the token is minted:
+     *
+     * ```js
+     * await SDK.requestMicrophoneAccess();
+     * const token = await mintConnectionToken();
+     * await SDK.init(token, config);
+     * ```
+     *
+     * Rejects with a `ConnectionError` whose `context.name` is the underlying
+     * DOMException — `"NotAllowedError"` (refused) or `"NotFoundError"` (no device).
+     * Calling it is free once granted: the stream is cached and reused by the session.
+     */
+    requestMicrophoneAccess(): Promise<void>;
     /** The SDK version string (useful for diagnostics). */
     version: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@touchcastllc/napster-companion-api-dev",
-  "version": "1.0.0-alpha.83",
+  "version": "1.0.0-alpha.85",
   "keywords": [
     "napster",
     "companion-api",