@wwdrew/expo-spotify-sdk 2.0.0 → 2.2.0

package/build/auth/index.js

@@ -1,6 +1,7 @@
 import { Platform } from "expo-modules-core";
 import ExpoSpotifySDKModule from "../ExpoSpotifySDKModule";
 import { AuthError } from "./error";
+import { createNativeErrorRethrow } from "../internal/native-errors";
 export { AuthError } from "./error";
 // ---------------------------------------------------------------------------
 // Internal helpers
@@ -10,40 +11,22 @@ const ANDROID_TOKEN_FLOW_WARNING = "[expo-spotify-sdk] You are using Auth.authen
     "the actual granted scopes through this path; see the README's " +
     "'Android implicit (TOKEN) flow is not recommended' section.";
 let warnedAboutAndroidTokenFlow = false;
-const VALID_AUTH_CODES = new Set([
-    "USER_CANCELLED",
-    "AUTH_IN_PROGRESS",
-    "INVALID_CONFIG",
-    "NETWORK_ERROR",
-    "TOKEN_SWAP_FAILED",
-    "TOKEN_SWAP_PARSE_ERROR",
-    "SPOTIFY_NOT_INSTALLED",
-    "AUTH_ERROR",
-    "UNKNOWN",
-]);
-const CAUSE_SEPARATOR = "→ Caused by: ";
-const LEGACY_CODE_PREFIX_RE = /^([A-Z_][A-Z0-9_]*):\s*(.*)$/s;
-function unwrapReason(message) {
-    const idx = message.lastIndexOf(CAUSE_SEPARATOR);
-    return idx === -1 ? message : message.slice(idx + CAUSE_SEPARATOR.length);
-}
-function rethrowAsAuthError(err) {
-    if (err instanceof AuthError)
-        throw err;
-    if (err instanceof Error) {
-        const reason = unwrapReason(err.message);
-        const maybeCode = err.code;
-        if (maybeCode && VALID_AUTH_CODES.has(maybeCode)) {
-            throw new AuthError(maybeCode, reason);
-        }
-        const m = reason.match(LEGACY_CODE_PREFIX_RE);
-        if (m && VALID_AUTH_CODES.has(m[1])) {
-            throw new AuthError(m[1], m[2]);
-        }
-        throw new AuthError("UNKNOWN", reason);
-    }
-    throw new AuthError("UNKNOWN", String(err));
-}
+const rethrowAsAuthError = createNativeErrorRethrow({
+    ErrorClass: AuthError,
+    unknownCode: "UNKNOWN",
+    legacyCodePrefix: true,
+    validCodes: new Set([
+        "USER_CANCELLED",
+        "AUTH_IN_PROGRESS",
+        "INVALID_CONFIG",
+        "NETWORK_ERROR",
+        "TOKEN_SWAP_FAILED",
+        "TOKEN_SWAP_PARSE_ERROR",
+        "SPOTIFY_NOT_INSTALLED",
+        "AUTH_ERROR",
+        "UNKNOWN",
+    ]),
+});
 function normaliseSession(raw) {
     if (!raw || typeof raw !== "object") {
         throw new AuthError("UNKNOWN", "Native module returned a non-object session");

package/build/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventSubscription } from \"expo-modules-core\";\nimport { Platform } from \"expo-modules-core\";\n\nimport ExpoSpotifySDKModule from \"../ExpoSpotifySDKModule\";\nimport { AuthError, type AuthErrorCode } from \"./error\";\n\nexport type { AuthErrorCode } from \"./error\";\nexport { AuthError } from \"./error\";\n\n// ---------------------------------------------------------------------------\n// Auth-specific types\n// ---------------------------------------------------------------------------\n\nexport interface SpotifySession {\n  /** OAuth access token. */\n  accessToken: string;\n  /**\n   * OAuth refresh token. `null` on Android when no `tokenSwapURL` is provided\n   * (the Spotify Android SDK does not expose a refresh token for implicit\n   * grants).\n   */\n  refreshToken: string | null;\n  /** Expiration timestamp as Unix epoch milliseconds. */\n  expirationDate: number;\n  /** Scopes the access token was granted (or requested, on Android implicit). */\n  scopes: SpotifyScope[];\n}\n\nexport type SpotifyScope =\n  | \"ugc-image-upload\"\n  | \"user-read-playback-state\"\n  | \"user-modify-playback-state\"\n  | \"user-read-currently-playing\"\n  | \"app-remote-control\"\n  | \"streaming\"\n  | \"playlist-read-private\"\n  | \"playlist-read-collaborative\"\n  | \"playlist-modify-private\"\n  | \"playlist-modify-public\"\n  | \"user-follow-modify\"\n  | \"user-follow-read\"\n  | \"user-top-read\"\n  | \"user-read-recently-played\"\n  | \"user-library-modify\"\n  | \"user-library-read\"\n  | \"user-read-email\"\n  | \"user-read-private\";\n\nexport interface AuthenticateConfig {\n  /** OAuth scopes to request. Must contain at least one entry. */\n  scopes: SpotifyScope[];\n  /**\n   * If supplied, requests an authorization code rather than an implicit\n   * token, then POSTs the code to this URL to exchange it for tokens.\n   * **Required on Android** to receive a usable `refreshToken`.\n   */\n  tokenSwapURL?: string;\n  /**\n   * Used by the iOS SDK to refresh access tokens automatically, and by\n   * `Auth.refresh()` on both platforms.\n   */\n  tokenRefreshURL?: string;\n  /**\n   * If `true`, forces Spotify to show the authorization dialog even when the\n   * user already has an active session. Defaults to `false`.\n   */\n  showDialog?: boolean;\n}\n\nexport interface RefreshConfig {\n  /** The refresh token from a previous `Auth.authenticate()` call. */\n  refreshToken: string;\n  /** URL of your token refresh server endpoint. */\n  tokenRefreshURL: string;\n  /**\n   * Scopes that were granted by the previous session. Used as a fallback when\n   * the refresh response omits the `scope` field.\n   */\n  scopes?: SpotifyScope[];\n}\n\n/**\n * Payload delivered to `Auth.addListener(\"sessionChange\", ...)` subscribers.\n */\nexport type SessionChangeEvent =\n  | { type: \"didInitiate\"; session: SpotifySession }\n  | { type: \"didRenew\"; session: SpotifySession }\n  | { type: \"didFail\"; error: { code: AuthErrorCode; message: string } };\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nconst ANDROID_TOKEN_FLOW_WARNING =\n  \"[expo-spotify-sdk] You are using Auth.authenticate on Android without a \" +\n  \"tokenSwapURL. The Spotify Android SDK does NOT return a refresh token or \" +\n  \"the actual granted scopes through this path; see the README's \" +\n  \"'Android implicit (TOKEN) flow is not recommended' section.\";\n\nlet warnedAboutAndroidTokenFlow = false;\n\nconst VALID_AUTH_CODES = new Set<AuthErrorCode>([\n  \"USER_CANCELLED\",\n  \"AUTH_IN_PROGRESS\",\n  \"INVALID_CONFIG\",\n  \"NETWORK_ERROR\",\n  \"TOKEN_SWAP_FAILED\",\n  \"TOKEN_SWAP_PARSE_ERROR\",\n  \"SPOTIFY_NOT_INSTALLED\",\n  \"AUTH_ERROR\",\n  \"UNKNOWN\",\n]);\n\nconst CAUSE_SEPARATOR = \"→ Caused by: \";\nconst LEGACY_CODE_PREFIX_RE = /^([A-Z_][A-Z0-9_]*):\\s*(.*)$/s;\n\nfunction unwrapReason(message: string): string {\n  const idx = message.lastIndexOf(CAUSE_SEPARATOR);\n  return idx === -1 ? message : message.slice(idx + CAUSE_SEPARATOR.length);\n}\n\nfunction rethrowAsAuthError(err: unknown): never {\n  if (err instanceof AuthError) throw err;\n  if (err instanceof Error) {\n    const reason = unwrapReason(err.message);\n    const maybeCode = (err as Error & { code?: string }).code;\n    if (maybeCode && VALID_AUTH_CODES.has(maybeCode as AuthErrorCode)) {\n      throw new AuthError(maybeCode as AuthErrorCode, reason);\n    }\n    const m = reason.match(LEGACY_CODE_PREFIX_RE);\n    if (m && VALID_AUTH_CODES.has(m[1] as AuthErrorCode)) {\n      throw new AuthError(m[1] as AuthErrorCode, m[2]!);\n    }\n    throw new AuthError(\"UNKNOWN\", reason);\n  }\n  throw new AuthError(\"UNKNOWN\", String(err));\n}\n\nfunction normaliseSession(raw: unknown): SpotifySession {\n  if (!raw || typeof raw !== \"object\") {\n    throw new AuthError(\"UNKNOWN\", \"Native module returned a non-object session\");\n  }\n  const r = raw as Record<string, unknown>;\n  const accessToken = r.accessToken;\n  if (typeof accessToken !== \"string\" || accessToken.length === 0) {\n    throw new AuthError(\"UNKNOWN\", \"Session is missing accessToken\");\n  }\n  const expirationDate = r.expirationDate;\n  if (typeof expirationDate !== \"number\") {\n    throw new AuthError(\"UNKNOWN\", \"Session is missing expirationDate\");\n  }\n  const refreshTokenRaw = r.refreshToken;\n  const refreshToken =\n    typeof refreshTokenRaw === \"string\" && refreshTokenRaw.length > 0\n      ? refreshTokenRaw\n      : null;\n  const scopesRaw = r.scopes;\n  const scopes = Array.isArray(scopesRaw)\n    ? (scopesRaw.filter((s) => typeof s === \"string\") as SpotifyScope[])\n    : [];\n  return { accessToken, refreshToken, expirationDate, scopes };\n}\n\n// ---------------------------------------------------------------------------\n// Auth namespace\n// ---------------------------------------------------------------------------\n\n/**\n * Spotify Auth namespace. Handles OAuth authentication and session lifecycle.\n *\n * @example\n * ```ts\n * import { Auth } from \"@wwdrew/expo-spotify-sdk\";\n *\n * const session = await Auth.authenticate({ scopes: [\"streaming\"] });\n * ```\n */\nexport const Auth = {\n  /**\n   * Returns `true` if the Spotify app is installed on the device.\n   */\n  isAvailable(): boolean {\n    return ExpoSpotifySDKModule.isAvailable();\n  },\n\n  /**\n   * Starts a Spotify OAuth flow. Resolves with a {@link SpotifySession};\n   * rejects with an {@link AuthError} carrying a `code`.\n   */\n  authenticate(config: AuthenticateConfig): Promise<SpotifySession> {\n    if (!config.scopes || config.scopes.length === 0) {\n      return Promise.reject(\n        new AuthError(\"INVALID_CONFIG\", \"scopes must contain at least one entry\"),\n      );\n    }\n    if (\n      Platform.OS === \"android\" &&\n      !config.tokenSwapURL &&\n      !warnedAboutAndroidTokenFlow\n    ) {\n      warnedAboutAndroidTokenFlow = true;\n      console.warn(ANDROID_TOKEN_FLOW_WARNING);\n    }\n    return ExpoSpotifySDKModule.authenticateAsync(config)\n      .then(normaliseSession)\n      .catch(rethrowAsAuthError);\n  },\n\n  /**\n   * Exchanges a refresh token for a new access token via your token refresh\n   * server. Resolves with a fresh {@link SpotifySession}; rejects with an\n   * {@link AuthError}.\n   */\n  refresh(config: RefreshConfig): Promise<SpotifySession> {\n    if (!config.refreshToken) {\n      return Promise.reject(\n        new AuthError(\"INVALID_CONFIG\", \"refreshToken is required\"),\n      );\n    }\n    if (!config.tokenRefreshURL) {\n      return Promise.reject(\n        new AuthError(\"INVALID_CONFIG\", \"tokenRefreshURL is required\"),\n      );\n    }\n    return ExpoSpotifySDKModule.refreshSessionAsync(config)\n      .then(normaliseSession)\n      .catch(rethrowAsAuthError);\n  },\n\n  /**\n   * Forcibly cancel any in-flight `Auth.authenticate()` call. No-op on\n   * Android (the Android coordinator self-cleans via structured concurrency).\n   *\n   * Use before `Auth.authenticate()` to defensively clear any leaked iOS\n   * coordinator state (the `SPTSessionManager` delegate callbacks are not\n   * guaranteed to fire).\n   */\n  cancelPending(): Promise<void> {\n    if (Platform.OS !== \"ios\") {\n      return Promise.resolve();\n    }\n    return ExpoSpotifySDKModule.cancelPendingAuthAsync();\n  },\n\n  /**\n   * Subscribes to session lifecycle events.\n   *\n   * Events fire for every `Auth.authenticate()` and `Auth.refresh()` call,\n   * regardless of whether the call was awaited. Useful for persisting tokens\n   * in a central store without coupling the store to the call sites.\n   *\n   * Returns a `Subscription` — call `.remove()` to unsubscribe.\n   *\n   * @example\n   * ```ts\n   * const sub = Auth.addListener(\"sessionChange\", (event) => {\n   *   if (event.type === \"didInitiate\" || event.type === \"didRenew\") {\n   *     store.setSession(event.session);\n   *   }\n   * });\n   * // later:\n   * sub.remove();\n   * ```\n   */\n  addListener(\n    event: \"sessionChange\",\n    listener: (event: SessionChangeEvent) => void,\n  ): EventSubscription {\n    return ExpoSpotifySDKModule.addListener(\n      \"onSessionChange\",\n      listener,\n    ) as EventSubscription;\n  },\n} as const;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventSubscription } from \"expo-modules-core\";\nimport { Platform } from \"expo-modules-core\";\n\nimport ExpoSpotifySDKModule from \"../ExpoSpotifySDKModule\";\nimport { AuthError, type AuthErrorCode } from \"./error\";\nimport { createNativeErrorRethrow } from \"../internal/native-errors\";\n\nexport type { AuthErrorCode } from \"./error\";\nexport { AuthError } from \"./error\";\n\n// ---------------------------------------------------------------------------\n// Auth-specific types\n// ---------------------------------------------------------------------------\n\nexport interface SpotifySession {\n  /** OAuth access token. */\n  accessToken: string;\n  /**\n   * OAuth refresh token. `null` on Android when no `tokenSwapURL` is provided\n   * (the Spotify Android SDK does not expose a refresh token for implicit\n   * grants).\n   */\n  refreshToken: string | null;\n  /** Expiration timestamp as Unix epoch milliseconds. */\n  expirationDate: number;\n  /** Scopes the access token was granted (or requested, on Android implicit). */\n  scopes: SpotifyScope[];\n}\n\nexport type SpotifyScope =\n  | \"ugc-image-upload\"\n  | \"user-read-playback-state\"\n  | \"user-modify-playback-state\"\n  | \"user-read-currently-playing\"\n  | \"app-remote-control\"\n  | \"streaming\"\n  | \"playlist-read-private\"\n  | \"playlist-read-collaborative\"\n  | \"playlist-modify-private\"\n  | \"playlist-modify-public\"\n  | \"user-follow-modify\"\n  | \"user-follow-read\"\n  | \"user-top-read\"\n  | \"user-read-recently-played\"\n  | \"user-library-modify\"\n  | \"user-library-read\"\n  | \"user-read-email\"\n  | \"user-read-private\";\n\nexport interface AuthenticateConfig {\n  /** OAuth scopes to request. Must contain at least one entry. */\n  scopes: SpotifyScope[];\n  /**\n   * If supplied, requests an authorization code rather than an implicit\n   * token, then POSTs the code to this URL to exchange it for tokens.\n   * **Required on Android** to receive a usable `refreshToken`.\n   */\n  tokenSwapURL?: string;\n  /**\n   * Used by the iOS SDK to refresh access tokens automatically, and by\n   * `Auth.refresh()` on both platforms.\n   */\n  tokenRefreshURL?: string;\n  /**\n   * If `true`, forces Spotify to show the authorization dialog even when the\n   * user already has an active session. Defaults to `false`.\n   */\n  showDialog?: boolean;\n}\n\nexport interface RefreshConfig {\n  /** The refresh token from a previous `Auth.authenticate()` call. */\n  refreshToken: string;\n  /** URL of your token refresh server endpoint. */\n  tokenRefreshURL: string;\n  /**\n   * Scopes that were granted by the previous session. Used as a fallback when\n   * the refresh response omits the `scope` field.\n   */\n  scopes?: SpotifyScope[];\n}\n\n/**\n * Payload delivered to `Auth.addListener(\"sessionChange\", ...)` subscribers.\n */\nexport type SessionChangeEvent =\n  | { type: \"didInitiate\"; session: SpotifySession }\n  | { type: \"didRenew\"; session: SpotifySession }\n  | { type: \"didFail\"; error: { code: AuthErrorCode; message: string } };\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nconst ANDROID_TOKEN_FLOW_WARNING =\n  \"[expo-spotify-sdk] You are using Auth.authenticate on Android without a \" +\n  \"tokenSwapURL. The Spotify Android SDK does NOT return a refresh token or \" +\n  \"the actual granted scopes through this path; see the README's \" +\n  \"'Android implicit (TOKEN) flow is not recommended' section.\";\n\nlet warnedAboutAndroidTokenFlow = false;\n\nconst rethrowAsAuthError = createNativeErrorRethrow({\n  ErrorClass: AuthError,\n  unknownCode: \"UNKNOWN\",\n  legacyCodePrefix: true,\n  validCodes: new Set<AuthErrorCode>([\n    \"USER_CANCELLED\",\n    \"AUTH_IN_PROGRESS\",\n    \"INVALID_CONFIG\",\n    \"NETWORK_ERROR\",\n    \"TOKEN_SWAP_FAILED\",\n    \"TOKEN_SWAP_PARSE_ERROR\",\n    \"SPOTIFY_NOT_INSTALLED\",\n    \"AUTH_ERROR\",\n    \"UNKNOWN\",\n  ]),\n});\n\nfunction normaliseSession(raw: unknown): SpotifySession {\n  if (!raw || typeof raw !== \"object\") {\n    throw new AuthError(\n      \"UNKNOWN\",\n      \"Native module returned a non-object session\",\n    );\n  }\n  const r = raw as Record<string, unknown>;\n  const accessToken = r.accessToken;\n  if (typeof accessToken !== \"string\" || accessToken.length === 0) {\n    throw new AuthError(\"UNKNOWN\", \"Session is missing accessToken\");\n  }\n  const expirationDate = r.expirationDate;\n  if (typeof expirationDate !== \"number\") {\n    throw new AuthError(\"UNKNOWN\", \"Session is missing expirationDate\");\n  }\n  const refreshTokenRaw = r.refreshToken;\n  const refreshToken =\n    typeof refreshTokenRaw === \"string\" && refreshTokenRaw.length > 0\n      ? refreshTokenRaw\n      : null;\n  const scopesRaw = r.scopes;\n  const scopes = Array.isArray(scopesRaw)\n    ? (scopesRaw.filter((s) => typeof s === \"string\") as SpotifyScope[])\n    : [];\n  return { accessToken, refreshToken, expirationDate, scopes };\n}\n\n// ---------------------------------------------------------------------------\n// Auth namespace\n// ---------------------------------------------------------------------------\n\n/**\n * Spotify Auth namespace. Handles OAuth authentication and session lifecycle.\n *\n * @example\n * ```ts\n * import { Auth } from \"@wwdrew/expo-spotify-sdk\";\n *\n * const session = await Auth.authenticate({ scopes: [\"streaming\"] });\n * ```\n */\nexport const Auth = {\n  /**\n   * Returns `true` if the Spotify app is installed on the device.\n   */\n  isAvailable(): boolean {\n    return ExpoSpotifySDKModule.isAvailable();\n  },\n\n  /**\n   * Starts a Spotify OAuth flow. Resolves with a {@link SpotifySession};\n   * rejects with an {@link AuthError} carrying a `code`.\n   */\n  authenticate(config: AuthenticateConfig): Promise<SpotifySession> {\n    if (!config.scopes || config.scopes.length === 0) {\n      return Promise.reject(\n        new AuthError(\n          \"INVALID_CONFIG\",\n          \"scopes must contain at least one entry\",\n        ),\n      );\n    }\n    if (\n      Platform.OS === \"android\" &&\n      !config.tokenSwapURL &&\n      !warnedAboutAndroidTokenFlow\n    ) {\n      warnedAboutAndroidTokenFlow = true;\n      console.warn(ANDROID_TOKEN_FLOW_WARNING);\n    }\n    return ExpoSpotifySDKModule.authenticateAsync(config)\n      .then(normaliseSession)\n      .catch(rethrowAsAuthError);\n  },\n\n  /**\n   * Exchanges a refresh token for a new access token via your token refresh\n   * server. Resolves with a fresh {@link SpotifySession}; rejects with an\n   * {@link AuthError}.\n   */\n  refresh(config: RefreshConfig): Promise<SpotifySession> {\n    if (!config.refreshToken) {\n      return Promise.reject(\n        new AuthError(\"INVALID_CONFIG\", \"refreshToken is required\"),\n      );\n    }\n    if (!config.tokenRefreshURL) {\n      return Promise.reject(\n        new AuthError(\"INVALID_CONFIG\", \"tokenRefreshURL is required\"),\n      );\n    }\n    return ExpoSpotifySDKModule.refreshSessionAsync(config)\n      .then(normaliseSession)\n      .catch(rethrowAsAuthError);\n  },\n\n  /**\n   * Forcibly cancel any in-flight `Auth.authenticate()` call. No-op on\n   * Android (the Android coordinator self-cleans via structured concurrency).\n   *\n   * Use before `Auth.authenticate()` to defensively clear any leaked iOS\n   * coordinator state (the `SPTSessionManager` delegate callbacks are not\n   * guaranteed to fire).\n   */\n  cancelPending(): Promise<void> {\n    if (Platform.OS !== \"ios\") {\n      return Promise.resolve();\n    }\n    return ExpoSpotifySDKModule.cancelPendingAuthAsync();\n  },\n\n  /**\n   * Subscribes to session lifecycle events.\n   *\n   * Events fire for every `Auth.authenticate()` and `Auth.refresh()` call,\n   * regardless of whether the call was awaited. Useful for persisting tokens\n   * in a central store without coupling the store to the call sites.\n   *\n   * Returns a `Subscription` — call `.remove()` to unsubscribe.\n   *\n   * @example\n   * ```ts\n   * const sub = Auth.addListener(\"sessionChange\", (event) => {\n   *   if (event.type === \"didInitiate\" || event.type === \"didRenew\") {\n   *     store.setSession(event.session);\n   *   }\n   * });\n   * // later:\n   * sub.remove();\n   * ```\n   */\n  addListener(\n    event: \"sessionChange\",\n    listener: (event: SessionChangeEvent) => void,\n  ): EventSubscription {\n    return ExpoSpotifySDKModule.addListener(\n      \"onSessionChange\",\n      listener,\n    ) as EventSubscription;\n  },\n} as const;\n"]}

package/build/content/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AASvC,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AA6BD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO;IAClB;;OAEG;gDAC8B,WAAW,KAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAMrE;;OAEG;iCACe,WAAW,KAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAG9C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAQA,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAaD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO;IAClB;;OAEG;gDAC8B,WAAW,KAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAMrE;;OAEG;iCACe,WAAW,KAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAK9C,CAAC"}

package/build/content/index.js

@@ -1,33 +1,20 @@
-export { ContentError } from "./error";
 // ---------------------------------------------------------------------------
 // Types
 // ---------------------------------------------------------------------------
 import ExpoSpotifySDKModule from "../ExpoSpotifySDKModule";
 import { ContentError } from "./error";
-const VALID_CONTENT_CODES = new Set([
-    "NOT_CONNECTED",
-    "CONNECTION_LOST",
-    "CONTENT_API_UNAVAILABLE",
-    "UNKNOWN",
-]);
-const CAUSE_SEPARATOR = "→ Caused by: ";
-function unwrapReason(message) {
-    const idx = message.lastIndexOf(CAUSE_SEPARATOR);
-    return idx === -1 ? message : message.slice(idx + CAUSE_SEPARATOR.length);
-}
-function rethrowAsContentError(err) {
-    if (err instanceof ContentError)
-        throw err;
-    if (err instanceof Error) {
-        const reason = unwrapReason(err.message);
-        const maybeCode = err.code;
-        if (maybeCode && VALID_CONTENT_CODES.has(maybeCode)) {
-            throw new ContentError(maybeCode, reason);
-        }
-        throw new ContentError("UNKNOWN", reason);
-    }
-    throw new ContentError("UNKNOWN", String(err));
-}
+import { createNativeErrorRethrow } from "../internal/native-errors";
+export { ContentError } from "./error";
+const rethrowAsContentError = createNativeErrorRethrow({
+    ErrorClass: ContentError,
+    unknownCode: "UNKNOWN",
+    validCodes: new Set([
+        "NOT_CONNECTED",
+        "CONNECTION_LOST",
+        "CONTENT_API_UNAVAILABLE",
+        "UNKNOWN",
+    ]),
+});
 /**
  * Spotify Content namespace. Browse Spotify's curated content tree.
  * Requires `AppRemote.connect()` to be resolved before any call.

package/build/content/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,OAAO,oBAAoB,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAyB,MAAM,SAAS,CAAC;AAkB9D,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAmB;IACpD,eAAe;IACf,iBAAiB;IACjB,yBAAyB;IACzB,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,eAAe,CAAC;AAExC,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IACjD,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAY;IACzC,IAAI,GAAG,YAAY,YAAY;QAAE,MAAM,GAAG,CAAC;IAC3C,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,SAAS,GAAI,GAAiC,CAAC,IAAI,CAAC;QAC1D,IAAI,SAAS,IAAI,mBAAmB,CAAC,GAAG,CAAC,SAA6B,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,YAAY,CAAC,SAA6B,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB;;OAEG;IACH,0BAA0B,CAAC,IAAiB;QAC1C,OAAO,oBAAoB,CAAC,iCAAiC,CAAC,IAAI,CAAC,CAAC,KAAK,CACvE,qBAAqB,CACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAiB;QAC3B,OAAO,oBAAoB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACpF,CAAC;CACO,CAAC","sourcesContent":["export type { ContentErrorCode } from \"./error\";\nexport { ContentError } from \"./error\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nimport ExpoSpotifySDKModule from \"../ExpoSpotifySDKModule\";\nimport { ContentError, type ContentErrorCode } from \"./error\";\n\nexport type ContentType = \"default\" | \"navigation\" | \"fitness\" | \"gaming\";\n\nexport interface ContentItem {\n  title: string | null;\n  subtitle: string | null;\n  contentDescription: string | null;\n  identifier: string;\n  uri: string;\n  imageIdentifier: string | null;\n  isAvailableOffline: boolean;\n  isPlayable: boolean;\n  isContainer: boolean;\n  isPinned: boolean;\n  children?: ContentItem[];\n}\n\nconst VALID_CONTENT_CODES = new Set<ContentErrorCode>([\n  \"NOT_CONNECTED\",\n  \"CONNECTION_LOST\",\n  \"CONTENT_API_UNAVAILABLE\",\n  \"UNKNOWN\",\n]);\n\nconst CAUSE_SEPARATOR = \"→ Caused by: \";\n\nfunction unwrapReason(message: string): string {\n  const idx = message.lastIndexOf(CAUSE_SEPARATOR);\n  return idx === -1 ? message : message.slice(idx + CAUSE_SEPARATOR.length);\n}\n\nfunction rethrowAsContentError(err: unknown): never {\n  if (err instanceof ContentError) throw err;\n  if (err instanceof Error) {\n    const reason = unwrapReason(err.message);\n    const maybeCode = (err as Error & { code?: string }).code;\n    if (maybeCode && VALID_CONTENT_CODES.has(maybeCode as ContentErrorCode)) {\n      throw new ContentError(maybeCode as ContentErrorCode, reason);\n    }\n    throw new ContentError(\"UNKNOWN\", reason);\n  }\n  throw new ContentError(\"UNKNOWN\", String(err));\n}\n\n/**\n * Spotify Content namespace. Browse Spotify's curated content tree.\n * Requires `AppRemote.connect()` to be resolved before any call.\n *\n * @example\n * ```ts\n * import { Content } from \"@wwdrew/expo-spotify-sdk\";\n *\n * const items = await Content.getRecommendedContentItems(\"default\");\n * ```\n */\nexport const Content = {\n  /**\n   * Returns Spotify-curated recommended content for the given feed type.\n   */\n  getRecommendedContentItems(type: ContentType): Promise<ContentItem[]> {\n    return ExpoSpotifySDKModule.contentGetRecommendedContentItems(type).catch(\n      rethrowAsContentError,\n    );\n  },\n\n  /**\n   * Returns children of a browsable (container) content item.\n   */\n  getChildren(item: ContentItem): Promise<ContentItem[]> {\n    return ExpoSpotifySDKModule.contentGetChildren(item).catch(rethrowAsContentError);\n  },\n} as const;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,OAAO,oBAAoB,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAyB,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAkBvC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;IACrD,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,SAAS;IACtB,UAAU,EAAE,IAAI,GAAG,CAAmB;QACpC,eAAe;QACf,iBAAiB;QACjB,yBAAyB;QACzB,SAAS;KACV,CAAC;CACH,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB;;OAEG;IACH,0BAA0B,CAAC,IAAiB;QAC1C,OAAO,oBAAoB,CAAC,iCAAiC,CAAC,IAAI,CAAC,CAAC,KAAK,CACvE,qBAAqB,CACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAiB;QAC3B,OAAO,oBAAoB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,KAAK,CACxD,qBAAqB,CACtB,CAAC;IACJ,CAAC;CACO,CAAC","sourcesContent":["// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nimport ExpoSpotifySDKModule from \"../ExpoSpotifySDKModule\";\nimport { ContentError, type ContentErrorCode } from \"./error\";\nimport { createNativeErrorRethrow } from \"../internal/native-errors\";\n\nexport type { ContentErrorCode } from \"./error\";\nexport { ContentError } from \"./error\";\n\nexport type ContentType = \"default\" | \"navigation\" | \"fitness\" | \"gaming\";\n\nexport interface ContentItem {\n  title: string | null;\n  subtitle: string | null;\n  contentDescription: string | null;\n  identifier: string;\n  uri: string;\n  imageIdentifier: string | null;\n  isAvailableOffline: boolean;\n  isPlayable: boolean;\n  isContainer: boolean;\n  isPinned: boolean;\n  children?: ContentItem[];\n}\n\nconst rethrowAsContentError = createNativeErrorRethrow({\n  ErrorClass: ContentError,\n  unknownCode: \"UNKNOWN\",\n  validCodes: new Set<ContentErrorCode>([\n    \"NOT_CONNECTED\",\n    \"CONNECTION_LOST\",\n    \"CONTENT_API_UNAVAILABLE\",\n    \"UNKNOWN\",\n  ]),\n});\n\n/**\n * Spotify Content namespace. Browse Spotify's curated content tree.\n * Requires `AppRemote.connect()` to be resolved before any call.\n *\n * @example\n * ```ts\n * import { Content } from \"@wwdrew/expo-spotify-sdk\";\n *\n * const items = await Content.getRecommendedContentItems(\"default\");\n * ```\n */\nexport const Content = {\n  /**\n   * Returns Spotify-curated recommended content for the given feed type.\n   */\n  getRecommendedContentItems(type: ContentType): Promise<ContentItem[]> {\n    return ExpoSpotifySDKModule.contentGetRecommendedContentItems(type).catch(\n      rethrowAsContentError,\n    );\n  },\n\n  /**\n   * Returns children of a browsable (container) content item.\n   */\n  getChildren(item: ContentItem): Promise<ContentItem[]> {\n    return ExpoSpotifySDKModule.contentGetChildren(item).catch(\n      rethrowAsContentError,\n    );\n  },\n} as const;\n"]}

package/build/hooks/index.d.ts

@@ -1,8 +1,8 @@
 import { type ConnectionState } from "../app-remote";
 import { type SpotifySession } from "../auth";
 import { type PlayerState, type Track } from "../player";
-import { type Capabilities, type LibraryState } from "../user";
 import type { SpotifyURI as SpotifyURIType } from "../uri";
+import { type Capabilities, type LibraryState } from "../user";
 /**
  * Returns the current Spotify OAuth session, or `null` when not authenticated.
  * Updates automatically whenever `Auth.authenticate()` or `Auth.refresh()`

package/build/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAU,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAQ,MAAM,SAAS,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,QAAQ,CAAC;AAmR3D;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,cAAc,GAAG,IAAI,CAElD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAMpD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,KAAK,GAAG,IAAI,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAMrD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAMxE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAEpD,OAAO,EAAU,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAQ,MAAM,SAAS,CAAC;AAsMrE;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,cAAc,GAAG,IAAI,CAMlD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAMpD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAMnD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,KAAK,GAAG,IAAI,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAMrD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAMxE"}

package/build/hooks/index.js

@@ -1,80 +1,36 @@
 import { useSyncExternalStore } from "react";
 import { AppRemote } from "../app-remote";
 import { Auth } from "../auth";
+import { createSyncExternalStore } from "../internal/sync-external-store";
 import { Player } from "../player";
 import { User } from "../user";
 // ---------------------------------------------------------------------------
 // Connection-state store
-//
-// A module-level singleton that caches the latest ConnectionState, exposes a
-// subscribe function for useSyncExternalStore, and stays in sync via the
-// native onConnectionStateChange event. Initialised lazily on first use.
 // ---------------------------------------------------------------------------
-let _connectionState = "disconnected";
-const _connectionListeners = new Set();
-let _connectionStoreInitialised = false;
-function initConnectionStore() {
-    if (_connectionStoreInitialised)
-        return;
-    _connectionStoreInitialised = true;
-    // Seed with the current native state so the first snapshot is accurate.
+const connectionStore = createSyncExternalStore("disconnected", (store) => {
     AppRemote.getConnectionState().then((state) => {
-        if (state !== _connectionState) {
-            _connectionState = state;
-            _connectionListeners.forEach((l) => l());
-        }
+        store.update(state);
     });
     AppRemote.addListener("connectionStateChange", ({ state }) => {
-        _connectionState = state;
-        _connectionListeners.forEach((l) => l());
+        store.update(state);
     });
-}
-function subscribeConnectionState(listener) {
-    initConnectionStore();
-    _connectionListeners.add(listener);
-    return () => _connectionListeners.delete(listener);
-}
-function getConnectionSnapshot() {
-    return _connectionState;
-}
+});
 // ---------------------------------------------------------------------------
 // Session store
 // ---------------------------------------------------------------------------
-let _session = null;
-const _sessionListeners = new Set();
-let _sessionStoreInitialised = false;
-function initSessionStore() {
-    if (_sessionStoreInitialised)
-        return;
-    _sessionStoreInitialised = true;
+const sessionStore = createSyncExternalStore(null, (store) => {
     Auth.addListener("sessionChange", (event) => {
         if (event.type === "didInitiate" || event.type === "didRenew") {
-            _session = event.session;
+            store.update(event.session);
         }
         else {
-            _session = null;
+            store.update(null);
         }
-        _sessionListeners.forEach((l) => l());
     });
-}
-function subscribeSession(listener) {
-    initSessionStore();
-    _sessionListeners.add(listener);
-    return () => _sessionListeners.delete(listener);
-}
-function getSessionSnapshot() {
-    return _session;
-}
+});
 // ---------------------------------------------------------------------------
 // Player-state store
-//
-// Seeded from the first playerStateChange event after subscription. The
-// native side automatically starts streaming player state updates once the
-// App Remote connection is established.
 // ---------------------------------------------------------------------------
-let _playerState = null;
-const _playerListeners = new Set();
-let _playerStoreInitialised = false;
 function normalizePlayerState(nextState, previousState) {
     const nextName = nextState.track.name?.trim() ?? "";
     const previousName = previousState?.track.name?.trim() ?? "";
@@ -93,95 +49,62 @@ function normalizePlayerState(nextState, previousState) {
     }
     return nextState;
 }
-function notifyPlayerListeners() {
-    _playerListeners.forEach((l) => l());
-}
-async function hydratePlayerState() {
+let playerHydrationVersion = 0;
+async function hydratePlayerState(store, version) {
     try {
         const state = await Player.getPlayerState();
-        _playerState = normalizePlayerState(state, _playerState);
-        notifyPlayerListeners();
+        if (version !== playerHydrationVersion)
+            return;
+        store.update((previous) => normalizePlayerState(state, previous));
     }
     catch {
         // Ignore one-shot hydration failures (e.g., connection races). Event stream
         // updates still populate this store once available.
     }
 }
-function initPlayerStore() {
-    if (_playerStoreInitialised)
-        return;
-    _playerStoreInitialised = true;
-    // Hydrate immediately if the module is already connected before any consumer
-    // subscribes to player events.
+const playerStore = createSyncExternalStore(null, (store) => {
     AppRemote.getConnectionState().then((state) => {
         if (state === "connected") {
-            void hydratePlayerState();
+            const version = ++playerHydrationVersion;
+            hydratePlayerState(store, version).catch(() => { });
         }
     });
-    // Refresh the one-shot snapshot whenever App Remote reconnects, and clear on
-    // disconnect so stale "now playing" data is not retained.
     AppRemote.addListener("connectionStateChange", ({ state }) => {
         if (state === "connected") {
-            void hydratePlayerState();
+            const version = ++playerHydrationVersion;
+            hydratePlayerState(store, version).catch(() => { });
             return;
         }
-        if (_playerState !== null) {
-            _playerState = null;
-            notifyPlayerListeners();
-        }
+        ++playerHydrationVersion;
+        store.update((current) => (current === null ? current : null));
     });
     Player.addListener("playerStateChange", (state) => {
-        _playerState = normalizePlayerState(state, _playerState);
-        notifyPlayerListeners();
+        store.update((previous) => normalizePlayerState(state, previous));
     });
-}
-function subscribePlayerState(listener) {
-    initPlayerStore();
-    _playerListeners.add(listener);
-    return () => _playerListeners.delete(listener);
-}
-function getPlayerSnapshot() {
-    return _playerState;
-}
+});
 // ---------------------------------------------------------------------------
 // Capabilities store
 // ---------------------------------------------------------------------------
-let _capabilities = null;
-const _capabilitiesListeners = new Set();
-let _capabilitiesStoreInitialised = false;
-function initCapabilitiesStore() {
-    if (_capabilitiesStoreInitialised)
-        return;
-    _capabilitiesStoreInitialised = true;
+const capabilitiesStore = createSyncExternalStore(null, (store) => {
     User.getCapabilities()
         .then((capabilities) => {
-        _capabilities = capabilities;
-        _capabilitiesListeners.forEach((l) => l());
+        store.update(capabilities);
     })
         .catch(() => {
         // Swallow initial read failures (e.g., not connected yet). The event
         // stream will hydrate this later.
     });
     User.addListener("capabilitiesChange", (capabilities) => {
-        _capabilities = capabilities;
-        _capabilitiesListeners.forEach((l) => l());
+        store.update(capabilities);
     });
-}
-function subscribeCapabilities(listener) {
-    initCapabilitiesStore();
-    _capabilitiesListeners.add(listener);
-    return () => _capabilitiesListeners.delete(listener);
-}
-function getCapabilitiesSnapshot() {
-    return _capabilities;
-}
-const _libraryStores = new Map();
+});
+const libraryStores = new Map();
 function getOrCreateLibraryStore(uri) {
     const key = String(uri);
-    let store = _libraryStores.get(key);
+    let store = libraryStores.get(key);
     if (!store) {
         store = { state: null, listeners: new Set(), initialised: false };
-        _libraryStores.set(key, store);
+        libraryStores.set(key, store);
     }
     return store;
 }
@@ -193,7 +116,7 @@ function initLibraryStore(uri) {
     User.getLibraryState(uri)
         .then((state) => {
         store.state = state;
-        store.listeners.forEach((l) => l());
+        store.listeners.forEach((listener) => listener());
     })
         .catch(() => {
         // Not connected / unavailable yet; listener updates can still arrive later.
@@ -201,7 +124,7 @@ function initLibraryStore(uri) {
     User.addLibraryStateListener(uri, (state) => {
         const next = getOrCreateLibraryStore(uri);
         next.state = state;
-        next.listeners.forEach((l) => l());
+        next.listeners.forEach((listener) => listener());
     });
 }
 function subscribeLibraryState(uri, listener) {
@@ -210,14 +133,14 @@ function subscribeLibraryState(uri, listener) {
     const store = getOrCreateLibraryStore(uri);
     store.listeners.add(listener);
     return () => {
-        const current = _libraryStores.get(key);
+        const current = libraryStores.get(key);
         if (!current)
             return;
         current.listeners.delete(listener);
     };
 }
 function getLibrarySnapshot(uri) {
-    return _libraryStores.get(String(uri))?.state ?? null;
+    return libraryStores.get(String(uri))?.state ?? null;
 }
 // ---------------------------------------------------------------------------
 // Public hooks
@@ -230,7 +153,7 @@ function getLibrarySnapshot(uri) {
  * Built on `useSyncExternalStore` for tearing-free React rendering.
  */
 export function useSession() {
-    return useSyncExternalStore(subscribeSession, getSessionSnapshot, getSessionSnapshot);
+    return useSyncExternalStore(sessionStore.subscribe, sessionStore.getSnapshot, sessionStore.getSnapshot);
 }
 /**
  * Returns the current App Remote {@link ConnectionState}
@@ -248,7 +171,7 @@ export function useSession() {
  * ```
  */
 export function useConnectionState() {
-    return useSyncExternalStore(subscribeConnectionState, getConnectionSnapshot, getConnectionSnapshot);
+    return useSyncExternalStore(connectionStore.subscribe, connectionStore.getSnapshot, connectionStore.getSnapshot);
 }
 /**
  * Returns the latest {@link PlayerState} from the Spotify app, or `null`
@@ -270,7 +193,7 @@ export function useConnectionState() {
  * ```
  */
 export function usePlayerState() {
-    return useSyncExternalStore(subscribePlayerState, getPlayerSnapshot, getPlayerSnapshot);
+    return useSyncExternalStore(playerStore.subscribe, playerStore.getSnapshot, playerStore.getSnapshot);
 }
 /**
  * Returns the currently playing {@link Track}, or `null` when nothing is
@@ -312,7 +235,7 @@ export function usePlaybackPosition() {
  * Derived from `User.getCapabilities()` + `User.addListener("capabilitiesChange")`.
  */
 export function useCapabilities() {
-    return useSyncExternalStore(subscribeCapabilities, getCapabilitiesSnapshot, getCapabilitiesSnapshot);
+    return useSyncExternalStore(capabilitiesStore.subscribe, capabilitiesStore.getSnapshot, capabilitiesStore.getSnapshot);
 }
 /**
  * Returns the library state for a specific URI, or `null` before the first

package/build/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAwB,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,IAAI,EAAuB,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,MAAM,EAAgC,MAAM,WAAW,CAAC;AACjE,OAAO,EAAwC,IAAI,EAAE,MAAM,SAAS,CAAC;AASrE,8EAA8E;AAC9E,yBAAyB;AACzB,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,yEAAyE;AACzE,8EAA8E;AAE9E,IAAI,gBAAgB,GAAoB,cAAc,CAAC;AACvD,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAY,CAAC;AACjD,IAAI,2BAA2B,GAAG,KAAK,CAAC;AAExC,SAAS,mBAAmB;IAC1B,IAAI,2BAA2B;QAAE,OAAO;IACxC,2BAA2B,GAAG,IAAI,CAAC;IAEnC,wEAAwE;IACxE,SAAS,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QAC5C,IAAI,KAAK,KAAK,gBAAgB,EAAE,CAAC;YAC/B,gBAAgB,GAAG,KAAK,CAAC;YACzB,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,WAAW,CAAC,uBAAuB,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3D,gBAAgB,GAAG,KAAK,CAAC;QACzB,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAkB;IAClD,mBAAmB,EAAE,CAAC;IACtB,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnC,OAAO,GAAG,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,qBAAqB;IAC5B,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,IAAI,QAAQ,GAA0B,IAAI,CAAC;AAC3C,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAY,CAAC;AAC9C,IAAI,wBAAwB,GAAG,KAAK,CAAC;AAErC,SAAS,gBAAgB;IACvB,IAAI,wBAAwB;QAAE,OAAO;IACrC,wBAAwB,GAAG,IAAI,CAAC;IAEhC,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;QAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9D,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAkB;IAC1C,gBAAgB,EAAE,CAAC;IACnB,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,qBAAqB;AACrB,EAAE;AACF,wEAAwE;AACxE,2EAA2E;AAC3E,wCAAwC;AACxC,8EAA8E;AAE9E,IAAI,YAAY,GAAuB,IAAI,CAAC;AAC5C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAY,CAAC;AAC7C,IAAI,uBAAuB,GAAG,KAAK,CAAC;AAEpC,SAAS,oBAAoB,CAC3B,SAAsB,EACtB,aAAiC;IAEjC,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACpD,MAAM,YAAY,GAAG,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC7D,MAAM,SAAS,GACb,aAAa,IAAI,IAAI,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;IAE3E,yEAAyE;IACzE,wEAAwE;IACxE,yCAAyC;IACzC,IAAI,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO;YACL,GAAG,SAAS;YACZ,KAAK,EAAE;gBACL,GAAG,SAAS,CAAC,KAAK;gBAClB,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI;aAC/B;SACF,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB;IAC5B,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,kBAAkB;IAC/B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5C,YAAY,GAAG,oBAAoB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QACzD,qBAAqB,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;QAC5E,oDAAoD;IACtD,CAAC;AACH,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,uBAAuB;QAAE,OAAO;IACpC,uBAAuB,GAAG,IAAI,CAAC;IAE/B,6EAA6E;IAC7E,+BAA+B;IAC/B,SAAS,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QAC5C,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;YAC1B,KAAK,kBAAkB,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,6EAA6E;IAC7E,0DAA0D;IAC1D,SAAS,CAAC,WAAW,CAAC,uBAAuB,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3D,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;YAC1B,KAAK,kBAAkB,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,YAAY,GAAG,IAAI,CAAC;YACpB,qBAAqB,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,WAAW,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;QAChD,YAAY,GAAG,oBAAoB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QACzD,qBAAqB,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAkB;IAC9C,eAAe,EAAE,CAAC;IAClB,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,GAAG,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,IAAI,aAAa,GAAwB,IAAI,CAAC;AAC9C,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAY,CAAC;AACnD,IAAI,6BAA6B,GAAG,KAAK,CAAC;AAE1C,SAAS,qBAAqB;IAC5B,IAAI,6BAA6B;QAAE,OAAO;IAC1C,6BAA6B,GAAG,IAAI,CAAC;IAErC,IAAI,CAAC,eAAe,EAAE;SACnB,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE;QACrB,aAAa,GAAG,YAAY,CAAC;QAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE;QACV,qEAAqE;QACrE,kCAAkC;IACpC,CAAC,CAAC,CAAC;IAEL,IAAI,CAAC,WAAW,CAAC,oBAAoB,EAAE,CAAC,YAAY,EAAE,EAAE;QACtD,aAAa,GAAG,YAAY,CAAC;QAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAkB;IAC/C,qBAAqB,EAAE,CAAC;IACxB,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,GAAG,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO,aAAa,CAAC;AACvB,CAAC;AAYD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEvD,SAAS,uBAAuB,CAAC,GAAmB;IAClD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QAClE,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAmB;IAC3C,MAAM,KAAK,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO;IAC9B,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;IAEzB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;SACtB,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QACd,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE;QACV,4EAA4E;IAC9E,CAAC,CAAC,CAAC;IAEL,IAAI,CAAC,uBAAuB,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;QAC1C,MAAM,IAAI,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAmB,EAAE,QAAkB;IACpE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACtB,MAAM,KAAK,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC3C,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO,GAAG,EAAE;QACV,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAmB;IAC7C,OAAO,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AACxD,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,oBAAoB,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;AACxF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,oBAAoB,CACzB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,CACtB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,oBAAoB,CAAC,oBAAoB,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,cAAc,EAAE,EAAE,KAAK,IAAI,IAAI,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,cAAc,EAAE,EAAE,gBAAgB,IAAI,CAAC,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,oBAAoB,CACzB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,CACxB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAmB;IACjD,OAAO,oBAAoB,CACzB,CAAC,QAAQ,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,EAAE,QAAQ,CAAC,EAClD,GAAG,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAC7B,GAAG,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAC9B,CAAC;AACJ,CAAC","sourcesContent":["import { useSyncExternalStore } from \"react\";\n\nimport { AppRemote, type ConnectionState } from \"../app-remote\";\nimport { Auth, type SpotifySession } from \"../auth\";\nimport { Player, type PlayerState, type Track } from \"../player\";\nimport { type Capabilities, type LibraryState, User } from \"../user\";\nimport type { SpotifyURI as SpotifyURIType } from \"../uri\";\n\n// ---------------------------------------------------------------------------\n// Shared utilities\n// ---------------------------------------------------------------------------\n\ntype Listener = () => void;\n\n// ---------------------------------------------------------------------------\n// Connection-state store\n//\n// A module-level singleton that caches the latest ConnectionState, exposes a\n// subscribe function for useSyncExternalStore, and stays in sync via the\n// native onConnectionStateChange event. Initialised lazily on first use.\n// ---------------------------------------------------------------------------\n\nlet _connectionState: ConnectionState = \"disconnected\";\nconst _connectionListeners = new Set<Listener>();\nlet _connectionStoreInitialised = false;\n\nfunction initConnectionStore() {\n  if (_connectionStoreInitialised) return;\n  _connectionStoreInitialised = true;\n\n  // Seed with the current native state so the first snapshot is accurate.\n  AppRemote.getConnectionState().then((state) => {\n    if (state !== _connectionState) {\n      _connectionState = state;\n      _connectionListeners.forEach((l) => l());\n    }\n  });\n\n  AppRemote.addListener(\"connectionStateChange\", ({ state }) => {\n    _connectionState = state;\n    _connectionListeners.forEach((l) => l());\n  });\n}\n\nfunction subscribeConnectionState(listener: Listener): () => void {\n  initConnectionStore();\n  _connectionListeners.add(listener);\n  return () => _connectionListeners.delete(listener);\n}\n\nfunction getConnectionSnapshot(): ConnectionState {\n  return _connectionState;\n}\n\n// ---------------------------------------------------------------------------\n// Session store\n// ---------------------------------------------------------------------------\n\nlet _session: SpotifySession | null = null;\nconst _sessionListeners = new Set<Listener>();\nlet _sessionStoreInitialised = false;\n\nfunction initSessionStore() {\n  if (_sessionStoreInitialised) return;\n  _sessionStoreInitialised = true;\n\n  Auth.addListener(\"sessionChange\", (event) => {\n    if (event.type === \"didInitiate\" || event.type === \"didRenew\") {\n      _session = event.session;\n    } else {\n      _session = null;\n    }\n    _sessionListeners.forEach((l) => l());\n  });\n}\n\nfunction subscribeSession(listener: Listener): () => void {\n  initSessionStore();\n  _sessionListeners.add(listener);\n  return () => _sessionListeners.delete(listener);\n}\n\nfunction getSessionSnapshot(): SpotifySession | null {\n  return _session;\n}\n\n// ---------------------------------------------------------------------------\n// Player-state store\n//\n// Seeded from the first playerStateChange event after subscription. The\n// native side automatically starts streaming player state updates once the\n// App Remote connection is established.\n// ---------------------------------------------------------------------------\n\nlet _playerState: PlayerState | null = null;\nconst _playerListeners = new Set<Listener>();\nlet _playerStoreInitialised = false;\n\nfunction normalizePlayerState(\n  nextState: PlayerState,\n  previousState: PlayerState | null,\n): PlayerState {\n  const nextName = nextState.track.name?.trim() ?? \"\";\n  const previousName = previousState?.track.name?.trim() ?? \"\";\n  const sameTrack =\n    previousState != null && previousState.track.uri === nextState.track.uri;\n\n  // App Remote can occasionally emit a transient blank title between valid\n  // snapshots for the same URI; keep the last non-empty title to avoid UI\n  // flicker/regression in hooks consumers.\n  if (sameTrack && nextName.length === 0 && previousName.length > 0) {\n    return {\n      ...nextState,\n      track: {\n        ...nextState.track,\n        name: previousState.track.name,\n      },\n    };\n  }\n\n  return nextState;\n}\n\nfunction notifyPlayerListeners() {\n  _playerListeners.forEach((l) => l());\n}\n\nasync function hydratePlayerState() {\n  try {\n    const state = await Player.getPlayerState();\n    _playerState = normalizePlayerState(state, _playerState);\n    notifyPlayerListeners();\n  } catch {\n    // Ignore one-shot hydration failures (e.g., connection races). Event stream\n    // updates still populate this store once available.\n  }\n}\n\nfunction initPlayerStore() {\n  if (_playerStoreInitialised) return;\n  _playerStoreInitialised = true;\n\n  // Hydrate immediately if the module is already connected before any consumer\n  // subscribes to player events.\n  AppRemote.getConnectionState().then((state) => {\n    if (state === \"connected\") {\n      void hydratePlayerState();\n    }\n  });\n\n  // Refresh the one-shot snapshot whenever App Remote reconnects, and clear on\n  // disconnect so stale \"now playing\" data is not retained.\n  AppRemote.addListener(\"connectionStateChange\", ({ state }) => {\n    if (state === \"connected\") {\n      void hydratePlayerState();\n      return;\n    }\n\n    if (_playerState !== null) {\n      _playerState = null;\n      notifyPlayerListeners();\n    }\n  });\n\n  Player.addListener(\"playerStateChange\", (state) => {\n    _playerState = normalizePlayerState(state, _playerState);\n    notifyPlayerListeners();\n  });\n}\n\nfunction subscribePlayerState(listener: Listener): () => void {\n  initPlayerStore();\n  _playerListeners.add(listener);\n  return () => _playerListeners.delete(listener);\n}\n\nfunction getPlayerSnapshot(): PlayerState | null {\n  return _playerState;\n}\n\n// ---------------------------------------------------------------------------\n// Capabilities store\n// ---------------------------------------------------------------------------\n\nlet _capabilities: Capabilities | null = null;\nconst _capabilitiesListeners = new Set<Listener>();\nlet _capabilitiesStoreInitialised = false;\n\nfunction initCapabilitiesStore() {\n  if (_capabilitiesStoreInitialised) return;\n  _capabilitiesStoreInitialised = true;\n\n  User.getCapabilities()\n    .then((capabilities) => {\n      _capabilities = capabilities;\n      _capabilitiesListeners.forEach((l) => l());\n    })\n    .catch(() => {\n      // Swallow initial read failures (e.g., not connected yet). The event\n      // stream will hydrate this later.\n    });\n\n  User.addListener(\"capabilitiesChange\", (capabilities) => {\n    _capabilities = capabilities;\n    _capabilitiesListeners.forEach((l) => l());\n  });\n}\n\nfunction subscribeCapabilities(listener: Listener): () => void {\n  initCapabilitiesStore();\n  _capabilitiesListeners.add(listener);\n  return () => _capabilitiesListeners.delete(listener);\n}\n\nfunction getCapabilitiesSnapshot(): Capabilities | null {\n  return _capabilities;\n}\n\n// ---------------------------------------------------------------------------\n// Per-URI library-state store\n// ---------------------------------------------------------------------------\n\ninterface LibraryStore {\n  state: LibraryState | null;\n  listeners: Set<Listener>;\n  initialised: boolean;\n}\n\nconst _libraryStores = new Map<string, LibraryStore>();\n\nfunction getOrCreateLibraryStore(uri: SpotifyURIType): LibraryStore {\n  const key = String(uri);\n  let store = _libraryStores.get(key);\n  if (!store) {\n    store = { state: null, listeners: new Set(), initialised: false };\n    _libraryStores.set(key, store);\n  }\n  return store;\n}\n\nfunction initLibraryStore(uri: SpotifyURIType) {\n  const store = getOrCreateLibraryStore(uri);\n  if (store.initialised) return;\n  store.initialised = true;\n\n  User.getLibraryState(uri)\n    .then((state) => {\n      store.state = state;\n      store.listeners.forEach((l) => l());\n    })\n    .catch(() => {\n      // Not connected / unavailable yet; listener updates can still arrive later.\n    });\n\n  User.addLibraryStateListener(uri, (state) => {\n    const next = getOrCreateLibraryStore(uri);\n    next.state = state;\n    next.listeners.forEach((l) => l());\n  });\n}\n\nfunction subscribeLibraryState(uri: SpotifyURIType, listener: Listener): () => void {\n  const key = String(uri);\n  initLibraryStore(uri);\n  const store = getOrCreateLibraryStore(uri);\n  store.listeners.add(listener);\n  return () => {\n    const current = _libraryStores.get(key);\n    if (!current) return;\n    current.listeners.delete(listener);\n  };\n}\n\nfunction getLibrarySnapshot(uri: SpotifyURIType): LibraryState | null {\n  return _libraryStores.get(String(uri))?.state ?? null;\n}\n\n// ---------------------------------------------------------------------------\n// Public hooks\n// ---------------------------------------------------------------------------\n\n/**\n * Returns the current Spotify OAuth session, or `null` when not authenticated.\n * Updates automatically whenever `Auth.authenticate()` or `Auth.refresh()`\n * resolves, and on session failure.\n *\n * Built on `useSyncExternalStore` for tearing-free React rendering.\n */\nexport function useSession(): SpotifySession | null {\n  return useSyncExternalStore(subscribeSession, getSessionSnapshot, getSessionSnapshot);\n}\n\n/**\n * Returns the current App Remote {@link ConnectionState}\n * (`\"disconnected\"` | `\"connecting\"` | `\"connected\"`). Updates automatically\n * on every state transition driven by `AppRemote.connect()` and `disconnect()`.\n *\n * Built on `useSyncExternalStore` for tearing-free React rendering.\n *\n * @example\n * ```tsx\n * function ConnectionBanner() {\n *   const state = useConnectionState();\n *   return <Text>{state === \"connected\" ? \"Connected\" : \"Disconnected\"}</Text>;\n * }\n * ```\n */\nexport function useConnectionState(): ConnectionState {\n  return useSyncExternalStore(\n    subscribeConnectionState,\n    getConnectionSnapshot,\n    getConnectionSnapshot,\n  );\n}\n\n/**\n * Returns the latest {@link PlayerState} from the Spotify app, or `null`\n * before the first update arrives (i.e., before `AppRemote.connect()` resolves\n * and the native subscription emits its first event).\n *\n * Updates on every state change reported by the Spotify app (track change,\n * pause/resume, seek, shuffle/repeat toggle, etc.).\n *\n * Built on `useSyncExternalStore` for tearing-free React rendering.\n *\n * @example\n * ```tsx\n * function NowPlaying() {\n *   const state = usePlayerState();\n *   if (!state) return <Text>Not playing</Text>;\n *   return <Text>{state.track.name} — {state.isPaused ? \"Paused\" : \"Playing\"}</Text>;\n * }\n * ```\n */\nexport function usePlayerState(): PlayerState | null {\n  return useSyncExternalStore(subscribePlayerState, getPlayerSnapshot, getPlayerSnapshot);\n}\n\n/**\n * Returns the currently playing {@link Track}, or `null` when nothing is\n * playing or before the first state update arrives.\n *\n * Derived from `usePlayerState`.\n */\nexport function useCurrentTrack(): Track | null {\n  return usePlayerState()?.track ?? null;\n}\n\n/**\n * Returns `true` when the Spotify player is actively playing (not paused),\n * and `false` otherwise (including before the first state update arrives).\n *\n * Derived from `usePlayerState`.\n */\nexport function useIsPlaying(): boolean {\n  const state = usePlayerState();\n  return state !== null && !state.isPaused;\n}\n\n/**\n * Returns the current playback position in milliseconds. Returns `0` before\n * the first state update arrives.\n *\n * **Note:** This value updates whenever the native side emits a player state\n * change (track transitions, pause/resume, seek, etc.) — not on a fixed timer.\n * For a progress bar that ticks smoothly, combine this with a local `Date.now`\n * offset and `requestAnimationFrame`.\n *\n * Derived from `usePlayerState`.\n */\nexport function usePlaybackPosition(): number {\n  return usePlayerState()?.playbackPosition ?? 0;\n}\n\n/**\n * Returns the latest Spotify user capabilities, or `null` before the first\n * snapshot arrives.\n *\n * Derived from `User.getCapabilities()` + `User.addListener(\"capabilitiesChange\")`.\n */\nexport function useCapabilities(): Capabilities | null {\n  return useSyncExternalStore(\n    subscribeCapabilities,\n    getCapabilitiesSnapshot,\n    getCapabilitiesSnapshot,\n  );\n}\n\n/**\n * Returns the library state for a specific URI, or `null` before the first\n * snapshot arrives.\n *\n * Derived from `User.getLibraryState(uri)` + `User.addLibraryStateListener(uri, ...)`.\n */\nexport function useLibraryState(uri: SpotifyURIType): LibraryState | null {\n  return useSyncExternalStore(\n    (listener) => subscribeLibraryState(uri, listener),\n    () => getLibrarySnapshot(uri),\n    () => getLibrarySnapshot(uri),\n  );\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { useSyncExternalStore } from \"react\";\n\nimport { AppRemote, type ConnectionState } from \"../app-remote\";\nimport { Auth, type SpotifySession } from \"../auth\";\nimport { createSyncExternalStore } from \"../internal/sync-external-store\";\nimport { Player, type PlayerState, type Track } from \"../player\";\nimport type { SpotifyURI as SpotifyURIType } from \"../uri\";\nimport { type Capabilities, type LibraryState, User } from \"../user\";\n\ntype Listener = () => void;\n\n// ---------------------------------------------------------------------------\n// Connection-state store\n// ---------------------------------------------------------------------------\n\nconst connectionStore = createSyncExternalStore<ConnectionState>(\n  \"disconnected\",\n  (store) => {\n    AppRemote.getConnectionState().then((state) => {\n      store.update(state);\n    });\n\n    AppRemote.addListener(\"connectionStateChange\", ({ state }) => {\n      store.update(state);\n    });\n  },\n);\n\n// ---------------------------------------------------------------------------\n// Session store\n// ---------------------------------------------------------------------------\n\nconst sessionStore = createSyncExternalStore<SpotifySession | null>(\n  null,\n  (store) => {\n    Auth.addListener(\"sessionChange\", (event) => {\n      if (event.type === \"didInitiate\" || event.type === \"didRenew\") {\n        store.update(event.session);\n      } else {\n        store.update(null);\n      }\n    });\n  },\n);\n\n// ---------------------------------------------------------------------------\n// Player-state store\n// ---------------------------------------------------------------------------\n\nfunction normalizePlayerState(\n  nextState: PlayerState,\n  previousState: PlayerState | null,\n): PlayerState {\n  const nextName = nextState.track.name?.trim() ?? \"\";\n  const previousName = previousState?.track.name?.trim() ?? \"\";\n  const sameTrack =\n    previousState != null && previousState.track.uri === nextState.track.uri;\n\n  // App Remote can occasionally emit a transient blank title between valid\n  // snapshots for the same URI; keep the last non-empty title to avoid UI\n  // flicker/regression in hooks consumers.\n  if (sameTrack && nextName.length === 0 && previousName.length > 0) {\n    return {\n      ...nextState,\n      track: {\n        ...nextState.track,\n        name: previousState.track.name,\n      },\n    };\n  }\n\n  return nextState;\n}\n\nlet playerHydrationVersion = 0;\n\nasync function hydratePlayerState(\n  store: ReturnType<typeof createSyncExternalStore<PlayerState | null>>,\n  version: number,\n) {\n  try {\n    const state = await Player.getPlayerState();\n    if (version !== playerHydrationVersion) return;\n    store.update((previous) => normalizePlayerState(state, previous));\n  } catch {\n    // Ignore one-shot hydration failures (e.g., connection races). Event stream\n    // updates still populate this store once available.\n  }\n}\n\nconst playerStore = createSyncExternalStore<PlayerState | null>(\n  null,\n  (store) => {\n    AppRemote.getConnectionState().then((state) => {\n      if (state === \"connected\") {\n        const version = ++playerHydrationVersion;\n        hydratePlayerState(store, version).catch(() => {});\n      }\n    });\n\n    AppRemote.addListener(\"connectionStateChange\", ({ state }) => {\n      if (state === \"connected\") {\n        const version = ++playerHydrationVersion;\n        hydratePlayerState(store, version).catch(() => {});\n        return;\n      }\n\n      ++playerHydrationVersion;\n      store.update((current) => (current === null ? current : null));\n    });\n\n    Player.addListener(\"playerStateChange\", (state) => {\n      store.update((previous) => normalizePlayerState(state, previous));\n    });\n  },\n);\n\n// ---------------------------------------------------------------------------\n// Capabilities store\n// ---------------------------------------------------------------------------\n\nconst capabilitiesStore = createSyncExternalStore<Capabilities | null>(\n  null,\n  (store) => {\n    User.getCapabilities()\n      .then((capabilities) => {\n        store.update(capabilities);\n      })\n      .catch(() => {\n        // Swallow initial read failures (e.g., not connected yet). The event\n        // stream will hydrate this later.\n      });\n\n    User.addListener(\"capabilitiesChange\", (capabilities) => {\n      store.update(capabilities);\n    });\n  },\n);\n\n// ---------------------------------------------------------------------------\n// Per-URI library-state store\n// ---------------------------------------------------------------------------\n\ninterface LibraryStore {\n  state: LibraryState | null;\n  listeners: Set<Listener>;\n  initialised: boolean;\n}\n\nconst libraryStores = new Map<string, LibraryStore>();\n\nfunction getOrCreateLibraryStore(uri: SpotifyURIType): LibraryStore {\n  const key = String(uri);\n  let store = libraryStores.get(key);\n  if (!store) {\n    store = { state: null, listeners: new Set(), initialised: false };\n    libraryStores.set(key, store);\n  }\n  return store;\n}\n\nfunction initLibraryStore(uri: SpotifyURIType) {\n  const store = getOrCreateLibraryStore(uri);\n  if (store.initialised) return;\n  store.initialised = true;\n\n  User.getLibraryState(uri)\n    .then((state) => {\n      store.state = state;\n      store.listeners.forEach((listener) => listener());\n    })\n    .catch(() => {\n      // Not connected / unavailable yet; listener updates can still arrive later.\n    });\n\n  User.addLibraryStateListener(uri, (state) => {\n    const next = getOrCreateLibraryStore(uri);\n    next.state = state;\n    next.listeners.forEach((listener) => listener());\n  });\n}\n\nfunction subscribeLibraryState(\n  uri: SpotifyURIType,\n  listener: Listener,\n): () => void {\n  const key = String(uri);\n  initLibraryStore(uri);\n  const store = getOrCreateLibraryStore(uri);\n  store.listeners.add(listener);\n  return () => {\n    const current = libraryStores.get(key);\n    if (!current) return;\n    current.listeners.delete(listener);\n  };\n}\n\nfunction getLibrarySnapshot(uri: SpotifyURIType): LibraryState | null {\n  return libraryStores.get(String(uri))?.state ?? null;\n}\n\n// ---------------------------------------------------------------------------\n// Public hooks\n// ---------------------------------------------------------------------------\n\n/**\n * Returns the current Spotify OAuth session, or `null` when not authenticated.\n * Updates automatically whenever `Auth.authenticate()` or `Auth.refresh()`\n * resolves, and on session failure.\n *\n * Built on `useSyncExternalStore` for tearing-free React rendering.\n */\nexport function useSession(): SpotifySession | null {\n  return useSyncExternalStore(\n    sessionStore.subscribe,\n    sessionStore.getSnapshot,\n    sessionStore.getSnapshot,\n  );\n}\n\n/**\n * Returns the current App Remote {@link ConnectionState}\n * (`\"disconnected\"` | `\"connecting\"` | `\"connected\"`). Updates automatically\n * on every state transition driven by `AppRemote.connect()` and `disconnect()`.\n *\n * Built on `useSyncExternalStore` for tearing-free React rendering.\n *\n * @example\n * ```tsx\n * function ConnectionBanner() {\n *   const state = useConnectionState();\n *   return <Text>{state === \"connected\" ? \"Connected\" : \"Disconnected\"}</Text>;\n * }\n * ```\n */\nexport function useConnectionState(): ConnectionState {\n  return useSyncExternalStore(\n    connectionStore.subscribe,\n    connectionStore.getSnapshot,\n    connectionStore.getSnapshot,\n  );\n}\n\n/**\n * Returns the latest {@link PlayerState} from the Spotify app, or `null`\n * before the first update arrives (i.e., before `AppRemote.connect()` resolves\n * and the native subscription emits its first event).\n *\n * Updates on every state change reported by the Spotify app (track change,\n * pause/resume, seek, shuffle/repeat toggle, etc.).\n *\n * Built on `useSyncExternalStore` for tearing-free React rendering.\n *\n * @example\n * ```tsx\n * function NowPlaying() {\n *   const state = usePlayerState();\n *   if (!state) return <Text>Not playing</Text>;\n *   return <Text>{state.track.name} — {state.isPaused ? \"Paused\" : \"Playing\"}</Text>;\n * }\n * ```\n */\nexport function usePlayerState(): PlayerState | null {\n  return useSyncExternalStore(\n    playerStore.subscribe,\n    playerStore.getSnapshot,\n    playerStore.getSnapshot,\n  );\n}\n\n/**\n * Returns the currently playing {@link Track}, or `null` when nothing is\n * playing or before the first state update arrives.\n *\n * Derived from `usePlayerState`.\n */\nexport function useCurrentTrack(): Track | null {\n  return usePlayerState()?.track ?? null;\n}\n\n/**\n * Returns `true` when the Spotify player is actively playing (not paused),\n * and `false` otherwise (including before the first state update arrives).\n *\n * Derived from `usePlayerState`.\n */\nexport function useIsPlaying(): boolean {\n  const state = usePlayerState();\n  return state !== null && !state.isPaused;\n}\n\n/**\n * Returns the current playback position in milliseconds. Returns `0` before\n * the first state update arrives.\n *\n * **Note:** This value updates whenever the native side emits a player state\n * change (track transitions, pause/resume, seek, etc.) — not on a fixed timer.\n * For a progress bar that ticks smoothly, combine this with a local `Date.now`\n * offset and `requestAnimationFrame`.\n *\n * Derived from `usePlayerState`.\n */\nexport function usePlaybackPosition(): number {\n  return usePlayerState()?.playbackPosition ?? 0;\n}\n\n/**\n * Returns the latest Spotify user capabilities, or `null` before the first\n * snapshot arrives.\n *\n * Derived from `User.getCapabilities()` + `User.addListener(\"capabilitiesChange\")`.\n */\nexport function useCapabilities(): Capabilities | null {\n  return useSyncExternalStore(\n    capabilitiesStore.subscribe,\n    capabilitiesStore.getSnapshot,\n    capabilitiesStore.getSnapshot,\n  );\n}\n\n/**\n * Returns the library state for a specific URI, or `null` before the first\n * snapshot arrives.\n *\n * Derived from `User.getLibraryState(uri)` + `User.addLibraryStateListener(uri, ...)`.\n */\nexport function useLibraryState(uri: SpotifyURIType): LibraryState | null {\n  return useSyncExternalStore(\n    (listener) => subscribeLibraryState(uri, listener),\n    () => getLibrarySnapshot(uri),\n    () => getLibrarySnapshot(uri),\n  );\n}\n"]}

package/build/images/index.d.ts

@@ -1,7 +1,7 @@
-export type { ImagesErrorCode } from "./error";
-export { ImagesError } from "./error";
 import type { ContentItem } from "../content";
 import type { Track } from "../player";
+export type { ImagesErrorCode } from "./error";
+export { ImagesError } from "./error";
 export type ImageSize = "small" | "medium" | "large";
 export interface ImageResult {
     uri: string;

package/build/images/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/images/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAOtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGvC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,8DAA8D;AAC9D,UAAU,kBAAkB;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,6DAA6D;AAC7D,UAAU,gBAAgB;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,WAAW,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAwC7F;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;0BACQ,kBAAkB,QAAQ,SAAS,KAAG,OAAO,CAAC,WAAW,CAAC;CAM7D,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/images/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGvC,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,8DAA8D;AAC9D,UAAU,kBAAkB;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,6DAA6D;AAC7D,UAAU,gBAAgB;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,kBAAkB,GAC1B,KAAK,GACL,WAAW,GACX,gBAAgB,GAChB,kBAAkB,CAAC;AAwBvB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;0BACQ,kBAAkB,QAAQ,SAAS,KAAG,OAAO,CAAC,WAAW,CAAC;CAM7D,CAAC"}