soundlink 1.2.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # soundlink
2
2
 
3
+ ## 2.0.0
4
+
5
+ ### Major Changes
6
+
7
+ - [#SOU-6455](https://linear.app/getsoundlink/issue/SOU-6455) — **Breaking:** the SDK sends `Authorization: Bearer sk_...` instead of the deprecated `x-api-key` header. Constructor API is unchanged (`new Soundlink({ apiKey })`). Migrate by upgrading the package; no code changes required unless you were reading request headers in tests or proxies that expected `x-api-key`.
8
+
3
9
  ## 1.2.0
4
10
 
5
11
  ### Minor Changes
package/README.md CHANGED
@@ -8,7 +8,7 @@ Official TypeScript SDK for the [Soundlink Public API](https://docs.getsoundlink
8
8
  npm install soundlink
9
9
  ```
10
10
 
11
- > **Version note:** `1.0.0` on npm was an empty placeholder. Use **`>=1.1.0`** for the SDK. Write surface (create / budget / stop / tiers) ships in **`1.2.0`**.
11
+ > **Version note:** `2.x` is the current line. `1.x` sent the deprecated `x-api-key` header — upgrade to `2.0.0+` for `Authorization: Bearer`. Write surface (create / budget / stop / tiers) shipped in `1.2.0` and remains in `2.x`.
12
12
 
13
13
  Requires **Node.js 18+** (native `fetch`). Works in Edge Runtime when `fetch` is available.
14
14
 
@@ -40,9 +40,9 @@ const soundlink = new Soundlink('sk_your_prefix_your_secret');
40
40
  ## Authentication
41
41
 
42
42
  Pass your Soundlink API key (`sk_<prefix>_<secret>`) via the client constructor.
43
- The SDK sends it in the `x-api-key` header on every request.
43
+ The SDK sends it as `Authorization: Bearer sk_...` on every request.
44
44
 
45
- Your organization is determined from the key. Do not send Firebase Bearer tokens on the Public API host.
45
+ Your organization is determined from the key. Do not send Firebase ID tokens on the Public API host.
46
46
 
47
47
  Write methods require the `campaigns:write` scope and an `Idempotency-Key` (passed as `idempotencyKey` on the method options).
48
48
 
@@ -294,7 +294,7 @@ var HttpClient = class {
294
294
  }
295
295
  buildHeaders(extra = {}) {
296
296
  return {
297
- "x-api-key": this.options.apiKey,
297
+ Authorization: `Bearer ${this.options.apiKey}`,
298
298
  Accept: "application/json",
299
299
  ...extra
300
300
  };
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/constants/defaults.ts","../../src/core/api-response.ts","../../src/errors/sdk-error.ts","../../src/core/jsonl.ts","../../src/utils/query.ts","../../src/client/http-client.ts","../../src/resources/index.ts","../../src/client/soundlink.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export const DEFAULT_BASE_URL = 'https://api.getsoundlink.com';\n\nexport const DEFAULT_TIMEOUT_MS = 30_000;\n\nexport const DEFAULT_MAX_RETRIES = 2;\n\nexport const API_KEY_PREFIX = 'sk_';\n\nexport const CAMPAIGNS_MAX_PAGE_SIZE = 100;\n\nexport const METRICS_MAX_PAGE_SIZE = 500;\n\nexport const METRICS_DEFAULT_PAGE_SIZE = 50;\n\nexport const CAMPAIGNS_DEFAULT_PAGE_SIZE = 10;\n\nexport const API_VERSION_PREFIX = '/v1';\n","import type {\n ApiEnvelopeError,\n ApiEnvelopeSuccess,\n ApiMeta,\n ApiError,\n ApiResponse,\n PublicApiErrorCode,\n} from '../types/api.js';\n\nexport function isApiEnvelopeError(body: unknown): body is ApiEnvelopeError {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return (\n typeof record.error === 'object' &&\n record.error !== null &&\n typeof (record.error as Record<string, unknown>).code === 'string' &&\n typeof (record.error as Record<string, unknown>).message === 'string'\n );\n}\n\nexport function isApiEnvelopeSuccess<T>(body: unknown): body is ApiEnvelopeSuccess<T> {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return 'data' in record && typeof record.meta === 'object' && record.meta !== null;\n}\n\nexport function toApiError(\n envelope: ApiEnvelopeError,\n status: number,\n retryAfter?: number,\n): ApiError {\n const { details } = envelope.error;\n\n return {\n code: envelope.error.code as PublicApiErrorCode,\n message: envelope.error.message,\n status,\n requestId: envelope.meta.requestId,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n ...(details !== undefined ? { details } : {}),\n };\n}\n\nexport function successResponse<T>(data: T, meta: ApiMeta): ApiResponse<T> {\n return {\n data,\n error: null,\n meta,\n };\n}\n\nexport function errorResponse<T>(error: ApiError): ApiResponse<T> {\n return {\n data: null,\n error,\n ...(error.requestId ? { meta: { requestId: error.requestId } } : {}),\n };\n}\n\nexport function parseRetryAfterHeader(value: string | null): number | undefined {\n if (!value) {\n return undefined;\n }\n\n const seconds = Number.parseInt(value, 10);\n if (Number.isFinite(seconds) && seconds >= 0) {\n return seconds;\n }\n\n const dateMs = Date.parse(value);\n if (Number.isFinite(dateMs)) {\n const deltaSeconds = Math.ceil((dateMs - Date.now()) / 1000);\n return Math.max(deltaSeconds, 0);\n }\n\n return undefined;\n}\n","/**\n * Base error for unexpected SDK failures (configuration, parsing, transport).\n *\n * HTTP/API errors from Soundlink are returned as `{ data: null, error }` and do not throw.\n */\nexport class SoundlinkSdkError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkSdkError';\n Object.setPrototypeOf(this, SoundlinkSdkError.prototype);\n }\n}\n\n/** Thrown when a response body cannot be parsed or the network request fails unexpectedly. */\nexport class SoundlinkParseError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkParseError';\n Object.setPrototypeOf(this, SoundlinkParseError.prototype);\n }\n}\n\n/** Thrown when the client is misconfigured (missing or invalid API key, etc.). */\nexport class SoundlinkConfigError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkConfigError';\n Object.setPrototypeOf(this, SoundlinkConfigError.prototype);\n }\n}\n","import { SoundlinkParseError } from '../errors/sdk-error.js';\n\nexport async function* parseNdjsonStream<T>(\n body: ReadableStream<Uint8Array> | null,\n onMalformedLine?: (line: string, error: unknown) => void,\n): AsyncGenerator<T> {\n if (!body) {\n return;\n }\n\n const reader = body.getReader();\n const decoder = new TextDecoder();\n let buffer = '';\n\n try {\n for (;;) {\n const { done, value } = await reader.read();\n if (done) {\n break;\n }\n\n buffer += decoder.decode(value, { stream: true });\n const lines = buffer.split('\\n');\n buffer = lines.pop() ?? '';\n\n for (const line of lines) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n\n try {\n yield JSON.parse(trimmed) as T;\n } catch (error) {\n onMalformedLine?.(trimmed, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n }\n\n const trailing = buffer.trim();\n if (trailing) {\n try {\n yield JSON.parse(trailing) as T;\n } catch (error) {\n onMalformedLine?.(trailing, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n } finally {\n reader.releaseLock();\n }\n}\n\nexport async function collectNdjsonStream<T>(\n stream: AsyncIterable<T>,\n): Promise<{ rows: T[]; rowCount: number }> {\n const rows: T[] = [];\n for await (const row of stream) {\n rows.push(row);\n }\n return {\n rows,\n rowCount: rows.length,\n };\n}\n\nexport function parseNdjsonText<T>(text: string): T[] {\n const rows: T[] = [];\n for (const line of text.split('\\n')) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n rows.push(JSON.parse(trimmed) as T);\n }\n\n return rows;\n}\n","export function buildQueryString(\n params: Record<string, string | number | boolean | undefined | null>,\n): string {\n const searchParams = new URLSearchParams();\n\n for (const [key, value] of Object.entries(params)) {\n if (value === undefined || value === null || value === '') {\n continue;\n }\n searchParams.set(key, String(value));\n }\n\n const query = searchParams.toString();\n return query ? `?${query}` : '';\n}\n\nexport function joinUrl(baseUrl: string, path: string): string {\n const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n return `${normalizedBase}${normalizedPath}`;\n}\n\nexport function sleep(ms: number): Promise<void> {\n return new Promise((resolve) => {\n setTimeout(resolve, ms);\n });\n}\n\nexport function calculateBackoffMs(attempt: number): number {\n const base = 250;\n const jitter = Math.floor(Math.random() * 100);\n return base * 2 ** attempt + jitter;\n}\n","import {\n API_KEY_PREFIX,\n API_VERSION_PREFIX,\n DEFAULT_BASE_URL,\n DEFAULT_MAX_RETRIES,\n DEFAULT_TIMEOUT_MS,\n} from '../constants/defaults.js';\nimport {\n errorResponse,\n isApiEnvelopeError,\n isApiEnvelopeSuccess,\n parseRetryAfterHeader,\n successResponse,\n toApiError,\n} from '../core/api-response.js';\nimport { parseNdjsonStream } from '../core/jsonl.js';\nimport { SoundlinkConfigError, SoundlinkParseError } from '../errors/sdk-error.js';\nimport type { ApiResponse, JsonlStream, SoundlinkOptions } from '../types/api.js';\nimport {\n buildQueryString,\n calculateBackoffMs,\n joinUrl,\n sleep,\n} from '../utils/query.js';\n\nexport type { JsonlStream };\n\nexport interface HttpGetOptions {\n path: string;\n query?: Record<string, string | number | boolean | undefined | null>;\n}\n\nexport interface HttpJsonlOptions extends HttpGetOptions {\n accept?: string;\n}\n\nexport interface HttpMutationOptions {\n path: string;\n body?: unknown;\n query?: Record<string, string | number | boolean | undefined | null>;\n headers?: Record<string, string>;\n /** Sent as the `Idempotency-Key` header when set. */\n idempotencyKey?: string;\n}\n\nexport interface ResolvedSoundlinkClientOptions {\n apiKey: string;\n baseUrl: string;\n timeout: number;\n maxRetries: number;\n fetch: typeof fetch;\n}\n\n/**\n * Normalize constructor options and validate the API key format.\n *\n * @throws {@link SoundlinkConfigError} When the key is missing or does not start with `sk_`.\n */\nexport function resolveClientOptions(\n options: SoundlinkOptions,\n): ResolvedSoundlinkClientOptions {\n const normalized = typeof options === 'string' ? { apiKey: options } : options;\n\n const apiKey = normalized.apiKey.trim();\n if (!apiKey) {\n throw new SoundlinkConfigError('apiKey is required.');\n }\n\n if (!apiKey.startsWith(API_KEY_PREFIX)) {\n throw new SoundlinkConfigError(\n `Invalid API key format. Expected a key starting with \"${API_KEY_PREFIX}\".`,\n );\n }\n\n return {\n apiKey,\n baseUrl: normalized.baseUrl ?? DEFAULT_BASE_URL,\n timeout: normalized.timeout ?? DEFAULT_TIMEOUT_MS,\n maxRetries: normalized.maxRetries ?? DEFAULT_MAX_RETRIES,\n fetch: normalized.fetch ?? globalThis.fetch.bind(globalThis),\n };\n}\n\nexport class HttpClient {\n private readonly options: ResolvedSoundlinkClientOptions;\n\n constructor(options: SoundlinkOptions) {\n this.options = resolveClientOptions(options);\n }\n\n get resolvedOptions(): ResolvedSoundlinkClientOptions {\n return this.options;\n }\n\n async get<T>({ path, query }: HttpGetOptions): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n return this.requestJson<T>(url, {\n method: 'GET',\n headers: this.buildHeaders(),\n });\n }\n\n async post<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('POST', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async patch<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('PATCH', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async getJsonl<T>({\n path,\n query,\n accept = 'application/x-ndjson',\n }: HttpJsonlOptions): Promise<ApiResponse<JsonlStream<T>>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n let response: Response;\n try {\n response = await this.fetchWithRetry(url, {\n method: 'GET',\n headers: {\n ...this.buildHeaders(),\n Accept: accept,\n },\n });\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const contentType = response.headers.get('Content-Type') ?? '';\n if (contentType.includes('application/json')) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const rowCountHeader = response.headers.get('X-Row-Count');\n const parsedRowCount =\n rowCountHeader !== null ? Number.parseInt(rowCountHeader, 10) : undefined;\n\n const stream = parseNdjsonStream<T>(response.body);\n const data = attachRowCountMetadata(stream, parsedRowCount);\n\n return {\n data,\n error: null,\n };\n }\n\n private mutateJson<T>(\n method: 'POST' | 'PATCH',\n { path, body, query, headers, idempotencyKey }: HttpMutationOptions,\n ): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n const requestHeaders = this.buildHeaders({\n ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),\n ...(idempotencyKey !== undefined ? { 'Idempotency-Key': idempotencyKey } : {}),\n ...headers,\n });\n\n return this.requestJson<T>(url, {\n method,\n headers: requestHeaders,\n ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n });\n }\n\n private buildHeaders(extra: Record<string, string> = {}): Record<string, string> {\n return {\n 'x-api-key': this.options.apiKey,\n Accept: 'application/json',\n ...extra,\n };\n }\n\n private async requestJson<T>(\n url: string,\n init: RequestInit,\n ): Promise<ApiResponse<T>> {\n let response: Response;\n\n try {\n response = await this.fetchWithRetry(url, init);\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<T>(response, retryAfter);\n }\n\n let body: unknown;\n try {\n body = await response.json();\n } catch {\n throw new SoundlinkParseError(\n 'Failed to parse JSON response from Soundlink API.',\n );\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n if (isApiEnvelopeSuccess<T>(body)) {\n return successResponse(body.data, body.meta);\n }\n\n throw new SoundlinkParseError('Unexpected response shape from Soundlink API.');\n }\n\n private async parseErrorEnvelope<T>(\n response: Response,\n retryAfter?: number,\n ): Promise<ApiResponse<T>> {\n let body: unknown = null;\n\n try {\n body = await response.json();\n } catch {\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n private async fetchWithRetry(url: string, init: RequestInit): Promise<Response> {\n const { maxRetries, timeout, fetch } = this.options;\n let attempt = 0;\n\n let response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n\n while (\n attempt < maxRetries &&\n (response.status === 429 || response.status >= 500)\n ) {\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n const delayMs =\n retryAfter !== undefined ? retryAfter * 1000 : calculateBackoffMs(attempt);\n\n attempt += 1;\n await sleep(delayMs);\n\n response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n }\n\n return response;\n }\n}\n\nfunction toTransportError(error: unknown): SoundlinkParseError {\n if (error instanceof Error) {\n return new SoundlinkParseError(`Network request failed: ${error.message}`);\n }\n\n return new SoundlinkParseError('Network request failed.');\n}\n\nfunction attachRowCountMetadata<T>(\n stream: AsyncIterable<T>,\n rowCount?: number,\n): JsonlStream<T> {\n const jsonlStream: JsonlStream<T> = {\n async *[Symbol.asyncIterator]() {\n for await (const row of stream) {\n yield row;\n }\n },\n };\n\n if (rowCount !== undefined && !Number.isNaN(rowCount)) {\n jsonlStream.rowCount = rowCount;\n }\n\n return jsonlStream;\n}\n\n/**\n * Read `rowCount` from a {@link JsonlStream} when the API sent `X-Row-Count`.\n *\n * @returns Row count, or `undefined` if not available.\n */\nexport function getStreamRowCount<T>(stream: AsyncIterable<T>): number | undefined {\n if (typeof stream === 'object' && 'rowCount' in stream) {\n const value = (stream as JsonlStream<T>).rowCount;\n return typeof value === 'number' ? value : undefined;\n }\n\n return undefined;\n}\n","import type { HttpClient } from '../client/http-client.js';\nimport type { JsonlStream } from '../types/api.js';\nimport { collectNdjsonStream } from '../core/jsonl.js';\nimport type {\n ApiResponse,\n BreakdownExportParams,\n BreakdownListData,\n BreakdownListParams,\n BreakdownRow,\n CampaignCreateData,\n CampaignDetail,\n CampaignListData,\n CampaignListParams,\n CampaignStopData,\n CampaignTiersData,\n CreateCampaignRequest,\n DateRangeParams,\n DecreaseCampaignBudgetData,\n DecreaseCampaignBudgetRequest,\n EngagementExportParams,\n EngagementRow,\n ExportCollection,\n IdempotencyOptions,\n IncreaseCampaignBudgetData,\n IncreaseCampaignBudgetRequest,\n MetricsOverview,\n PingData,\n StrategiesCatalogData,\n UpdateCampaignTiersRequest,\n} from '../types/api.js';\n\n/**\n * JSONL export endpoint: stream rows with {@link ExportResource.collect} or iterate the stream directly.\n *\n * @example\n * ```ts\n * const { data: stream } = await soundlink.metrics.breakdown.export(campaignId);\n * for await (const row of stream!) { ... }\n *\n * const { data } = await soundlink.metrics.breakdown.export.collect(campaignId);\n * ```\n */\nexport interface ExportResource<T, P extends DateRangeParams> {\n /**\n * Stream export rows as newline-delimited JSON.\n *\n * @param campaignId - Soundlink campaign ID.\n * @param params - Optional date range (max 90 days per request).\n */\n (campaignId: string, params?: P): Promise<ApiResponse<JsonlStream<T>>>;\n\n /**\n * Download all export rows into memory.\n *\n * Prefer {@link ExportResource | the stream} for large datasets.\n */\n collect(campaignId: string, params?: P): Promise<ApiResponse<ExportCollection<T>>>;\n}\n\nfunction createExportResource<T, P extends DateRangeParams>(\n http: HttpClient,\n buildPath: (campaignId: string) => string,\n buildQuery: (\n params: P,\n ) => Record<string, string | number | boolean | undefined | null>,\n): ExportResource<T, P> {\n const exportFn = ((campaignId: string, params: P = {} as P) => {\n return http.getJsonl<T>({\n path: buildPath(campaignId),\n query: buildQuery(params),\n });\n }) as ExportResource<T, P>;\n\n exportFn.collect = async (campaignId: string, params: P = {} as P) => {\n const response = await exportFn(campaignId, params);\n\n if (response.error || !response.data) {\n return {\n data: null,\n error: response.error,\n meta: response.meta,\n };\n }\n\n const collected = await collectNdjsonStream(response.data);\n\n return {\n data: collected,\n error: null,\n meta: response.meta,\n };\n };\n\n return exportFn;\n}\n\n/** System endpoints (`GET /v1/ping`). */\nexport class PingResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Verify connectivity and API key authentication.\n *\n * Accepts any valid v1 key scope. Does not require `campaigns:read` or `metrics:read`.\n *\n * @returns `{ data: { status: 'ok' }, error: null }` on success.\n *\n * @example\n * ```ts\n * const { data, error, meta } = await soundlink.ping();\n * ```\n */\n ping(): Promise<ApiResponse<PingData>> {\n return this.http.get<PingData>({ path: '/ping' });\n }\n}\n\n/** Strategy catalog (`GET /v1/strategies`). Requires `campaigns:read`. */\nexport class StrategiesResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * List growth strategies available for wallet campaign create.\n *\n * Maps to `GET /v1/strategies`.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.strategies.list();\n * ```\n */\n list(): Promise<ApiResponse<StrategiesCatalogData>> {\n return this.http.get<StrategiesCatalogData>({ path: '/strategies' });\n }\n}\n\n/** Campaign tiers (`/v1/campaigns/{id}/tiers`). Wallet only (`generation: 3`). */\nexport class CampaignTiersResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Get current tier allocation for a wallet campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/tiers`. Wallet campaigns only (`generation: 3`).\n */\n get(campaignId: string): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.get<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n });\n }\n\n /**\n * Update tier enablement and budget shares.\n *\n * Maps to `PATCH /v1/campaigns/{campaignId}/tiers`. Requires `campaigns:write`.\n * Allocation percents across items must sum to 100.\n * Use each tier's `tierId` from {@link CampaignTiersResource.get} as `targetingTierId`.\n * Does not require an `Idempotency-Key` (unlike create / stop / budget).\n */\n update(\n campaignId: string,\n body: UpdateCampaignTiersRequest,\n ): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.patch<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n body,\n });\n }\n}\n\n/** Campaign listing, detail, and wallet write surface (`/v1/campaigns/*`). */\nexport class CampaignsResource {\n /** Tier allocation for wallet campaigns (`generation: 3`). */\n readonly tiers: CampaignTiersResource;\n\n constructor(private readonly http: HttpClient) {\n this.tiers = new CampaignTiersResource(http);\n }\n\n /**\n * List campaigns for the authenticated organization.\n *\n * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**. Requires `campaigns:read`.\n *\n * @param params - Pagination and sort options.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.list({ page: 1, pageSize: 100 });\n * ```\n */\n list(params: CampaignListParams = {}): Promise<ApiResponse<CampaignListData>> {\n return this.http.get<CampaignListData>({\n path: '/campaigns',\n query: {\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n\n /**\n * Fetch full details for a single campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}`. Requires `campaigns:read`.\n *\n * @param campaignId - Campaign identifier returned by {@link CampaignsResource.list}.\n */\n get(campaignId: string): Promise<ApiResponse<CampaignDetail>> {\n return this.http.get<CampaignDetail>({\n path: `/campaigns/${encodeURIComponent(campaignId)}`,\n });\n }\n\n /**\n * Create a wallet-funded campaign.\n *\n * Maps to `POST /v1/campaigns`. Requires `campaigns:write` and `Idempotency-Key`.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.create(\n * {\n * spotifyUrl: 'https://open.spotify.com/track/...',\n * dailyBudget: 20,\n * durationDays: 7,\n * genre: 'Pop',\n * strategyType: 'maximum_growth',\n * },\n * { idempotencyKey: 'create-mytrack-01' },\n * );\n * ```\n */\n create(\n body: CreateCampaignRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignCreateData>> {\n return this.http.post<CampaignCreateData>({\n path: '/campaigns',\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Stop a wallet campaign and refund unspent budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/stop`. Requires `campaigns:write`\n * and `Idempotency-Key`. Wallet campaigns only (`generation: 3`).\n */\n stop(\n campaignId: string,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignStopData>> {\n return this.http.post<CampaignStopData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/stop`,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Increase wallet campaign budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/increase`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n increaseBudget(\n campaignId: string,\n body: IncreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<IncreaseCampaignBudgetData>> {\n return this.http.post<IncreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/increase`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Decrease wallet campaign daily budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/decrease`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n decreaseBudget(\n campaignId: string,\n body: DecreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<DecreaseCampaignBudgetData>> {\n return this.http.post<DecreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/decrease`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Async iterator over every campaign across all pages.\n *\n * Stops silently if a page request returns an error.\n *\n * @param params - Same as {@link CampaignsResource.list} except `page` is managed automatically.\n *\n * @example\n * ```ts\n * for await (const campaign of soundlink.campaigns.listAll({ pageSize: 100 })) {\n * console.log(campaign.campaignId);\n * }\n * ```\n */\n async *listAll(\n params: Omit<CampaignListParams, 'page'> = {},\n ): AsyncGenerator<CampaignListData['items'][number], void, void> {\n let page = 1;\n let totalPages = 1;\n\n while (page <= totalPages) {\n const response = await this.list({ ...params, page });\n\n if (response.error || !response.data) {\n return;\n }\n\n for (const item of response.data.items) {\n yield item;\n }\n\n totalPages = response.data.pagination.totalPages;\n page += 1;\n }\n }\n}\n\n/**\n * Campaign metrics (`/v1/campaigns/{id}/metrics/*`). Requires `metrics:read`.\n *\n * @example\n * ```ts\n * await soundlink.metrics.overview(campaignId);\n * await soundlink.metrics.breakdown.list(campaignId);\n * await soundlink.metrics.engagement.export(campaignId);\n * ```\n */\nexport class MetricsResource {\n /** Per-day country breakdown and JSONL export. */\n readonly breakdown: BreakdownMetricsResource;\n\n /** Per-track engagement JSONL export. */\n readonly engagement: EngagementMetricsResource;\n\n constructor(private readonly http: HttpClient) {\n this.breakdown = new BreakdownMetricsResource(http);\n this.engagement = new EngagementMetricsResource(http);\n }\n\n /**\n * Campaign-level metric totals for a date range.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/overview`.\n * Aggregates across all countries — use {@link BreakdownMetricsResource.list} for daily rows.\n *\n * @param campaignId - Campaign identifier.\n * @param params - Inclusive `YYYY-MM-DD` date range. Omit for API defaults.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.metrics.overview(campaignId, {\n * startDate: '2026-01-01',\n * endDate: '2026-03-31',\n * });\n * ```\n */\n overview(\n campaignId: string,\n params: DateRangeParams = {},\n ): Promise<ApiResponse<MetricsOverview>> {\n return this.http.get<MetricsOverview>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/overview`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n },\n });\n }\n}\n\n/**\n * Country-level daily metrics (`campaign_country_daily` schema).\n *\n * Access via `soundlink.metrics.breakdown`.\n */\nexport class BreakdownMetricsResource {\n /**\n * Stream full breakdown export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown/export`.\n */\n readonly export: ExportResource<BreakdownRow, BreakdownExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<BreakdownRow, BreakdownExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n }),\n );\n }\n\n /**\n * Paginated per-day, per-country breakdown rows.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param campaignId - Campaign identifier.\n * @param params - Date range, pagination, and sort options.\n */\n list(\n campaignId: string,\n params: BreakdownListParams = {},\n ): Promise<ApiResponse<BreakdownListData>> {\n return this.http.get<BreakdownListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n}\n\n/**\n * Per-track engagement metrics (`campaign_engagement_daily` schema).\n *\n * Access via `soundlink.metrics.engagement`. Only JSONL export is shipped.\n */\nexport class EngagementMetricsResource {\n /**\n * Stream full engagement export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement/export`.\n */\n readonly export: ExportResource<EngagementRow, EngagementExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<EngagementRow, EngagementExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n engagementContext: params.engagementContext,\n }),\n );\n }\n}\n","import { HttpClient } from './http-client.js';\nimport {\n CampaignsResource,\n MetricsResource,\n PingResource,\n StrategiesResource,\n} from '../resources/index.js';\nimport type { SoundlinkOptions } from '../types/api.js';\n\n/**\n * Official Soundlink Public API client.\n *\n * All methods return `{ data, error, meta? }` and never throw on HTTP/API errors.\n * SDK configuration, parsing, and transport failures throw {@link SoundlinkSdkError}.\n *\n * @example\n * ```ts\n * import { Soundlink } from 'soundlink';\n *\n * const soundlink = new Soundlink(process.env.SOUNDLINK_API_KEY!);\n *\n * const { data, error } = await soundlink.ping();\n * if (error) {\n * console.error(error.code, error.message);\n * } else {\n * console.log(data.status);\n * }\n * ```\n *\n * @see https://docs.getsoundlink.com\n */\nexport class Soundlink {\n /** Verify connectivity and authentication. Maps to `GET /v1/ping`. */\n readonly ping: PingResource['ping'];\n\n /** Growth strategy catalog. Requires `campaigns:read` scope. */\n readonly strategies: StrategiesResource;\n\n /** List, fetch, and manage campaigns. Read needs `campaigns:read`; writes need `campaigns:write`. */\n readonly campaigns: CampaignsResource;\n\n /** Campaign metrics, breakdowns, and JSONL exports. Requires `metrics:read` scope. */\n readonly metrics: MetricsResource;\n\n /**\n * Create a Soundlink client.\n *\n * @param options - API key string (`sk_*`) or {@link SoundlinkClientOptions}.\n */\n constructor(options: SoundlinkOptions) {\n const http = new HttpClient(options);\n const pingResource = new PingResource(http);\n\n this.ping = pingResource.ping.bind(pingResource);\n this.strategies = new StrategiesResource(http);\n this.campaigns = new CampaignsResource(http);\n this.metrics = new MetricsResource(http);\n }\n}\n\nexport { HttpClient, resolveClientOptions } from './http-client.js';\n"]}
1
+ {"version":3,"sources":["../../src/constants/defaults.ts","../../src/core/api-response.ts","../../src/errors/sdk-error.ts","../../src/core/jsonl.ts","../../src/utils/query.ts","../../src/client/http-client.ts","../../src/resources/index.ts","../../src/client/soundlink.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export const DEFAULT_BASE_URL = 'https://api.getsoundlink.com';\n\nexport const DEFAULT_TIMEOUT_MS = 30_000;\n\nexport const DEFAULT_MAX_RETRIES = 2;\n\nexport const API_KEY_PREFIX = 'sk_';\n\nexport const CAMPAIGNS_MAX_PAGE_SIZE = 100;\n\nexport const METRICS_MAX_PAGE_SIZE = 500;\n\nexport const METRICS_DEFAULT_PAGE_SIZE = 50;\n\nexport const CAMPAIGNS_DEFAULT_PAGE_SIZE = 10;\n\nexport const API_VERSION_PREFIX = '/v1';\n","import type {\n ApiEnvelopeError,\n ApiEnvelopeSuccess,\n ApiMeta,\n ApiError,\n ApiResponse,\n PublicApiErrorCode,\n} from '../types/api.js';\n\nexport function isApiEnvelopeError(body: unknown): body is ApiEnvelopeError {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return (\n typeof record.error === 'object' &&\n record.error !== null &&\n typeof (record.error as Record<string, unknown>).code === 'string' &&\n typeof (record.error as Record<string, unknown>).message === 'string'\n );\n}\n\nexport function isApiEnvelopeSuccess<T>(body: unknown): body is ApiEnvelopeSuccess<T> {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return 'data' in record && typeof record.meta === 'object' && record.meta !== null;\n}\n\nexport function toApiError(\n envelope: ApiEnvelopeError,\n status: number,\n retryAfter?: number,\n): ApiError {\n const { details } = envelope.error;\n\n return {\n code: envelope.error.code as PublicApiErrorCode,\n message: envelope.error.message,\n status,\n requestId: envelope.meta.requestId,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n ...(details !== undefined ? { details } : {}),\n };\n}\n\nexport function successResponse<T>(data: T, meta: ApiMeta): ApiResponse<T> {\n return {\n data,\n error: null,\n meta,\n };\n}\n\nexport function errorResponse<T>(error: ApiError): ApiResponse<T> {\n return {\n data: null,\n error,\n ...(error.requestId ? { meta: { requestId: error.requestId } } : {}),\n };\n}\n\nexport function parseRetryAfterHeader(value: string | null): number | undefined {\n if (!value) {\n return undefined;\n }\n\n const seconds = Number.parseInt(value, 10);\n if (Number.isFinite(seconds) && seconds >= 0) {\n return seconds;\n }\n\n const dateMs = Date.parse(value);\n if (Number.isFinite(dateMs)) {\n const deltaSeconds = Math.ceil((dateMs - Date.now()) / 1000);\n return Math.max(deltaSeconds, 0);\n }\n\n return undefined;\n}\n","/**\n * Base error for unexpected SDK failures (configuration, parsing, transport).\n *\n * HTTP/API errors from Soundlink are returned as `{ data: null, error }` and do not throw.\n */\nexport class SoundlinkSdkError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkSdkError';\n Object.setPrototypeOf(this, SoundlinkSdkError.prototype);\n }\n}\n\n/** Thrown when a response body cannot be parsed or the network request fails unexpectedly. */\nexport class SoundlinkParseError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkParseError';\n Object.setPrototypeOf(this, SoundlinkParseError.prototype);\n }\n}\n\n/** Thrown when the client is misconfigured (missing or invalid API key, etc.). */\nexport class SoundlinkConfigError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkConfigError';\n Object.setPrototypeOf(this, SoundlinkConfigError.prototype);\n }\n}\n","import { SoundlinkParseError } from '../errors/sdk-error.js';\n\nexport async function* parseNdjsonStream<T>(\n body: ReadableStream<Uint8Array> | null,\n onMalformedLine?: (line: string, error: unknown) => void,\n): AsyncGenerator<T> {\n if (!body) {\n return;\n }\n\n const reader = body.getReader();\n const decoder = new TextDecoder();\n let buffer = '';\n\n try {\n for (;;) {\n const { done, value } = await reader.read();\n if (done) {\n break;\n }\n\n buffer += decoder.decode(value, { stream: true });\n const lines = buffer.split('\\n');\n buffer = lines.pop() ?? '';\n\n for (const line of lines) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n\n try {\n yield JSON.parse(trimmed) as T;\n } catch (error) {\n onMalformedLine?.(trimmed, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n }\n\n const trailing = buffer.trim();\n if (trailing) {\n try {\n yield JSON.parse(trailing) as T;\n } catch (error) {\n onMalformedLine?.(trailing, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n } finally {\n reader.releaseLock();\n }\n}\n\nexport async function collectNdjsonStream<T>(\n stream: AsyncIterable<T>,\n): Promise<{ rows: T[]; rowCount: number }> {\n const rows: T[] = [];\n for await (const row of stream) {\n rows.push(row);\n }\n return {\n rows,\n rowCount: rows.length,\n };\n}\n\nexport function parseNdjsonText<T>(text: string): T[] {\n const rows: T[] = [];\n for (const line of text.split('\\n')) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n rows.push(JSON.parse(trimmed) as T);\n }\n\n return rows;\n}\n","export function buildQueryString(\n params: Record<string, string | number | boolean | undefined | null>,\n): string {\n const searchParams = new URLSearchParams();\n\n for (const [key, value] of Object.entries(params)) {\n if (value === undefined || value === null || value === '') {\n continue;\n }\n searchParams.set(key, String(value));\n }\n\n const query = searchParams.toString();\n return query ? `?${query}` : '';\n}\n\nexport function joinUrl(baseUrl: string, path: string): string {\n const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n return `${normalizedBase}${normalizedPath}`;\n}\n\nexport function sleep(ms: number): Promise<void> {\n return new Promise((resolve) => {\n setTimeout(resolve, ms);\n });\n}\n\nexport function calculateBackoffMs(attempt: number): number {\n const base = 250;\n const jitter = Math.floor(Math.random() * 100);\n return base * 2 ** attempt + jitter;\n}\n","import {\n API_KEY_PREFIX,\n API_VERSION_PREFIX,\n DEFAULT_BASE_URL,\n DEFAULT_MAX_RETRIES,\n DEFAULT_TIMEOUT_MS,\n} from '../constants/defaults.js';\nimport {\n errorResponse,\n isApiEnvelopeError,\n isApiEnvelopeSuccess,\n parseRetryAfterHeader,\n successResponse,\n toApiError,\n} from '../core/api-response.js';\nimport { parseNdjsonStream } from '../core/jsonl.js';\nimport { SoundlinkConfigError, SoundlinkParseError } from '../errors/sdk-error.js';\nimport type { ApiResponse, JsonlStream, SoundlinkOptions } from '../types/api.js';\nimport {\n buildQueryString,\n calculateBackoffMs,\n joinUrl,\n sleep,\n} from '../utils/query.js';\n\nexport type { JsonlStream };\n\nexport interface HttpGetOptions {\n path: string;\n query?: Record<string, string | number | boolean | undefined | null>;\n}\n\nexport interface HttpJsonlOptions extends HttpGetOptions {\n accept?: string;\n}\n\nexport interface HttpMutationOptions {\n path: string;\n body?: unknown;\n query?: Record<string, string | number | boolean | undefined | null>;\n headers?: Record<string, string>;\n /** Sent as the `Idempotency-Key` header when set. */\n idempotencyKey?: string;\n}\n\nexport interface ResolvedSoundlinkClientOptions {\n apiKey: string;\n baseUrl: string;\n timeout: number;\n maxRetries: number;\n fetch: typeof fetch;\n}\n\n/**\n * Normalize constructor options and validate the API key format.\n *\n * @throws {@link SoundlinkConfigError} When the key is missing or does not start with `sk_`.\n */\nexport function resolveClientOptions(\n options: SoundlinkOptions,\n): ResolvedSoundlinkClientOptions {\n const normalized = typeof options === 'string' ? { apiKey: options } : options;\n\n const apiKey = normalized.apiKey.trim();\n if (!apiKey) {\n throw new SoundlinkConfigError('apiKey is required.');\n }\n\n if (!apiKey.startsWith(API_KEY_PREFIX)) {\n throw new SoundlinkConfigError(\n `Invalid API key format. Expected a key starting with \"${API_KEY_PREFIX}\".`,\n );\n }\n\n return {\n apiKey,\n baseUrl: normalized.baseUrl ?? DEFAULT_BASE_URL,\n timeout: normalized.timeout ?? DEFAULT_TIMEOUT_MS,\n maxRetries: normalized.maxRetries ?? DEFAULT_MAX_RETRIES,\n fetch: normalized.fetch ?? globalThis.fetch.bind(globalThis),\n };\n}\n\nexport class HttpClient {\n private readonly options: ResolvedSoundlinkClientOptions;\n\n constructor(options: SoundlinkOptions) {\n this.options = resolveClientOptions(options);\n }\n\n get resolvedOptions(): ResolvedSoundlinkClientOptions {\n return this.options;\n }\n\n async get<T>({ path, query }: HttpGetOptions): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n return this.requestJson<T>(url, {\n method: 'GET',\n headers: this.buildHeaders(),\n });\n }\n\n async post<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('POST', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async patch<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('PATCH', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async getJsonl<T>({\n path,\n query,\n accept = 'application/x-ndjson',\n }: HttpJsonlOptions): Promise<ApiResponse<JsonlStream<T>>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n let response: Response;\n try {\n response = await this.fetchWithRetry(url, {\n method: 'GET',\n headers: {\n ...this.buildHeaders(),\n Accept: accept,\n },\n });\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const contentType = response.headers.get('Content-Type') ?? '';\n if (contentType.includes('application/json')) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const rowCountHeader = response.headers.get('X-Row-Count');\n const parsedRowCount =\n rowCountHeader !== null ? Number.parseInt(rowCountHeader, 10) : undefined;\n\n const stream = parseNdjsonStream<T>(response.body);\n const data = attachRowCountMetadata(stream, parsedRowCount);\n\n return {\n data,\n error: null,\n };\n }\n\n private mutateJson<T>(\n method: 'POST' | 'PATCH',\n { path, body, query, headers, idempotencyKey }: HttpMutationOptions,\n ): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n const requestHeaders = this.buildHeaders({\n ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),\n ...(idempotencyKey !== undefined ? { 'Idempotency-Key': idempotencyKey } : {}),\n ...headers,\n });\n\n return this.requestJson<T>(url, {\n method,\n headers: requestHeaders,\n ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n });\n }\n\n private buildHeaders(extra: Record<string, string> = {}): Record<string, string> {\n return {\n Authorization: `Bearer ${this.options.apiKey}`,\n Accept: 'application/json',\n ...extra,\n };\n }\n\n private async requestJson<T>(\n url: string,\n init: RequestInit,\n ): Promise<ApiResponse<T>> {\n let response: Response;\n\n try {\n response = await this.fetchWithRetry(url, init);\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<T>(response, retryAfter);\n }\n\n let body: unknown;\n try {\n body = await response.json();\n } catch {\n throw new SoundlinkParseError(\n 'Failed to parse JSON response from Soundlink API.',\n );\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n if (isApiEnvelopeSuccess<T>(body)) {\n return successResponse(body.data, body.meta);\n }\n\n throw new SoundlinkParseError('Unexpected response shape from Soundlink API.');\n }\n\n private async parseErrorEnvelope<T>(\n response: Response,\n retryAfter?: number,\n ): Promise<ApiResponse<T>> {\n let body: unknown = null;\n\n try {\n body = await response.json();\n } catch {\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n private async fetchWithRetry(url: string, init: RequestInit): Promise<Response> {\n const { maxRetries, timeout, fetch } = this.options;\n let attempt = 0;\n\n let response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n\n while (\n attempt < maxRetries &&\n (response.status === 429 || response.status >= 500)\n ) {\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n const delayMs =\n retryAfter !== undefined ? retryAfter * 1000 : calculateBackoffMs(attempt);\n\n attempt += 1;\n await sleep(delayMs);\n\n response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n }\n\n return response;\n }\n}\n\nfunction toTransportError(error: unknown): SoundlinkParseError {\n if (error instanceof Error) {\n return new SoundlinkParseError(`Network request failed: ${error.message}`);\n }\n\n return new SoundlinkParseError('Network request failed.');\n}\n\nfunction attachRowCountMetadata<T>(\n stream: AsyncIterable<T>,\n rowCount?: number,\n): JsonlStream<T> {\n const jsonlStream: JsonlStream<T> = {\n async *[Symbol.asyncIterator]() {\n for await (const row of stream) {\n yield row;\n }\n },\n };\n\n if (rowCount !== undefined && !Number.isNaN(rowCount)) {\n jsonlStream.rowCount = rowCount;\n }\n\n return jsonlStream;\n}\n\n/**\n * Read `rowCount` from a {@link JsonlStream} when the API sent `X-Row-Count`.\n *\n * @returns Row count, or `undefined` if not available.\n */\nexport function getStreamRowCount<T>(stream: AsyncIterable<T>): number | undefined {\n if (typeof stream === 'object' && 'rowCount' in stream) {\n const value = (stream as JsonlStream<T>).rowCount;\n return typeof value === 'number' ? value : undefined;\n }\n\n return undefined;\n}\n","import type { HttpClient } from '../client/http-client.js';\nimport type { JsonlStream } from '../types/api.js';\nimport { collectNdjsonStream } from '../core/jsonl.js';\nimport type {\n ApiResponse,\n BreakdownExportParams,\n BreakdownListData,\n BreakdownListParams,\n BreakdownRow,\n CampaignCreateData,\n CampaignDetail,\n CampaignListData,\n CampaignListParams,\n CampaignStopData,\n CampaignTiersData,\n CreateCampaignRequest,\n DateRangeParams,\n DecreaseCampaignBudgetData,\n DecreaseCampaignBudgetRequest,\n EngagementExportParams,\n EngagementRow,\n ExportCollection,\n IdempotencyOptions,\n IncreaseCampaignBudgetData,\n IncreaseCampaignBudgetRequest,\n MetricsOverview,\n PingData,\n StrategiesCatalogData,\n UpdateCampaignTiersRequest,\n} from '../types/api.js';\n\n/**\n * JSONL export endpoint: stream rows with {@link ExportResource.collect} or iterate the stream directly.\n *\n * @example\n * ```ts\n * const { data: stream } = await soundlink.metrics.breakdown.export(campaignId);\n * for await (const row of stream!) { ... }\n *\n * const { data } = await soundlink.metrics.breakdown.export.collect(campaignId);\n * ```\n */\nexport interface ExportResource<T, P extends DateRangeParams> {\n /**\n * Stream export rows as newline-delimited JSON.\n *\n * @param campaignId - Soundlink campaign ID.\n * @param params - Optional date range (max 90 days per request).\n */\n (campaignId: string, params?: P): Promise<ApiResponse<JsonlStream<T>>>;\n\n /**\n * Download all export rows into memory.\n *\n * Prefer {@link ExportResource | the stream} for large datasets.\n */\n collect(campaignId: string, params?: P): Promise<ApiResponse<ExportCollection<T>>>;\n}\n\nfunction createExportResource<T, P extends DateRangeParams>(\n http: HttpClient,\n buildPath: (campaignId: string) => string,\n buildQuery: (\n params: P,\n ) => Record<string, string | number | boolean | undefined | null>,\n): ExportResource<T, P> {\n const exportFn = ((campaignId: string, params: P = {} as P) => {\n return http.getJsonl<T>({\n path: buildPath(campaignId),\n query: buildQuery(params),\n });\n }) as ExportResource<T, P>;\n\n exportFn.collect = async (campaignId: string, params: P = {} as P) => {\n const response = await exportFn(campaignId, params);\n\n if (response.error || !response.data) {\n return {\n data: null,\n error: response.error,\n meta: response.meta,\n };\n }\n\n const collected = await collectNdjsonStream(response.data);\n\n return {\n data: collected,\n error: null,\n meta: response.meta,\n };\n };\n\n return exportFn;\n}\n\n/** System endpoints (`GET /v1/ping`). */\nexport class PingResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Verify connectivity and API key authentication.\n *\n * Accepts any valid v1 key scope. Does not require `campaigns:read` or `metrics:read`.\n *\n * @returns `{ data: { status: 'ok' }, error: null }` on success.\n *\n * @example\n * ```ts\n * const { data, error, meta } = await soundlink.ping();\n * ```\n */\n ping(): Promise<ApiResponse<PingData>> {\n return this.http.get<PingData>({ path: '/ping' });\n }\n}\n\n/** Strategy catalog (`GET /v1/strategies`). Requires `campaigns:read`. */\nexport class StrategiesResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * List growth strategies available for wallet campaign create.\n *\n * Maps to `GET /v1/strategies`.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.strategies.list();\n * ```\n */\n list(): Promise<ApiResponse<StrategiesCatalogData>> {\n return this.http.get<StrategiesCatalogData>({ path: '/strategies' });\n }\n}\n\n/** Campaign tiers (`/v1/campaigns/{id}/tiers`). Wallet only (`generation: 3`). */\nexport class CampaignTiersResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Get current tier allocation for a wallet campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/tiers`. Wallet campaigns only (`generation: 3`).\n */\n get(campaignId: string): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.get<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n });\n }\n\n /**\n * Update tier enablement and budget shares.\n *\n * Maps to `PATCH /v1/campaigns/{campaignId}/tiers`. Requires `campaigns:write`.\n * Allocation percents across items must sum to 100.\n * Use each tier's `tierId` from {@link CampaignTiersResource.get} as `targetingTierId`.\n * Does not require an `Idempotency-Key` (unlike create / stop / budget).\n */\n update(\n campaignId: string,\n body: UpdateCampaignTiersRequest,\n ): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.patch<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n body,\n });\n }\n}\n\n/** Campaign listing, detail, and wallet write surface (`/v1/campaigns/*`). */\nexport class CampaignsResource {\n /** Tier allocation for wallet campaigns (`generation: 3`). */\n readonly tiers: CampaignTiersResource;\n\n constructor(private readonly http: HttpClient) {\n this.tiers = new CampaignTiersResource(http);\n }\n\n /**\n * List campaigns for the authenticated organization.\n *\n * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**. Requires `campaigns:read`.\n *\n * @param params - Pagination and sort options.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.list({ page: 1, pageSize: 100 });\n * ```\n */\n list(params: CampaignListParams = {}): Promise<ApiResponse<CampaignListData>> {\n return this.http.get<CampaignListData>({\n path: '/campaigns',\n query: {\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n\n /**\n * Fetch full details for a single campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}`. Requires `campaigns:read`.\n *\n * @param campaignId - Campaign identifier returned by {@link CampaignsResource.list}.\n */\n get(campaignId: string): Promise<ApiResponse<CampaignDetail>> {\n return this.http.get<CampaignDetail>({\n path: `/campaigns/${encodeURIComponent(campaignId)}`,\n });\n }\n\n /**\n * Create a wallet-funded campaign.\n *\n * Maps to `POST /v1/campaigns`. Requires `campaigns:write` and `Idempotency-Key`.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.create(\n * {\n * spotifyUrl: 'https://open.spotify.com/track/...',\n * dailyBudget: 20,\n * durationDays: 7,\n * genre: 'Pop',\n * strategyType: 'maximum_growth',\n * },\n * { idempotencyKey: 'create-mytrack-01' },\n * );\n * ```\n */\n create(\n body: CreateCampaignRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignCreateData>> {\n return this.http.post<CampaignCreateData>({\n path: '/campaigns',\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Stop a wallet campaign and refund unspent budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/stop`. Requires `campaigns:write`\n * and `Idempotency-Key`. Wallet campaigns only (`generation: 3`).\n */\n stop(\n campaignId: string,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignStopData>> {\n return this.http.post<CampaignStopData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/stop`,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Increase wallet campaign budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/increase`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n increaseBudget(\n campaignId: string,\n body: IncreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<IncreaseCampaignBudgetData>> {\n return this.http.post<IncreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/increase`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Decrease wallet campaign daily budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/decrease`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n decreaseBudget(\n campaignId: string,\n body: DecreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<DecreaseCampaignBudgetData>> {\n return this.http.post<DecreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/decrease`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Async iterator over every campaign across all pages.\n *\n * Stops silently if a page request returns an error.\n *\n * @param params - Same as {@link CampaignsResource.list} except `page` is managed automatically.\n *\n * @example\n * ```ts\n * for await (const campaign of soundlink.campaigns.listAll({ pageSize: 100 })) {\n * console.log(campaign.campaignId);\n * }\n * ```\n */\n async *listAll(\n params: Omit<CampaignListParams, 'page'> = {},\n ): AsyncGenerator<CampaignListData['items'][number], void, void> {\n let page = 1;\n let totalPages = 1;\n\n while (page <= totalPages) {\n const response = await this.list({ ...params, page });\n\n if (response.error || !response.data) {\n return;\n }\n\n for (const item of response.data.items) {\n yield item;\n }\n\n totalPages = response.data.pagination.totalPages;\n page += 1;\n }\n }\n}\n\n/**\n * Campaign metrics (`/v1/campaigns/{id}/metrics/*`). Requires `metrics:read`.\n *\n * @example\n * ```ts\n * await soundlink.metrics.overview(campaignId);\n * await soundlink.metrics.breakdown.list(campaignId);\n * await soundlink.metrics.engagement.export(campaignId);\n * ```\n */\nexport class MetricsResource {\n /** Per-day country breakdown and JSONL export. */\n readonly breakdown: BreakdownMetricsResource;\n\n /** Per-track engagement JSONL export. */\n readonly engagement: EngagementMetricsResource;\n\n constructor(private readonly http: HttpClient) {\n this.breakdown = new BreakdownMetricsResource(http);\n this.engagement = new EngagementMetricsResource(http);\n }\n\n /**\n * Campaign-level metric totals for a date range.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/overview`.\n * Aggregates across all countries — use {@link BreakdownMetricsResource.list} for daily rows.\n *\n * @param campaignId - Campaign identifier.\n * @param params - Inclusive `YYYY-MM-DD` date range. Omit for API defaults.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.metrics.overview(campaignId, {\n * startDate: '2026-01-01',\n * endDate: '2026-03-31',\n * });\n * ```\n */\n overview(\n campaignId: string,\n params: DateRangeParams = {},\n ): Promise<ApiResponse<MetricsOverview>> {\n return this.http.get<MetricsOverview>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/overview`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n },\n });\n }\n}\n\n/**\n * Country-level daily metrics (`campaign_country_daily` schema).\n *\n * Access via `soundlink.metrics.breakdown`.\n */\nexport class BreakdownMetricsResource {\n /**\n * Stream full breakdown export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown/export`.\n */\n readonly export: ExportResource<BreakdownRow, BreakdownExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<BreakdownRow, BreakdownExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n }),\n );\n }\n\n /**\n * Paginated per-day, per-country breakdown rows.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param campaignId - Campaign identifier.\n * @param params - Date range, pagination, and sort options.\n */\n list(\n campaignId: string,\n params: BreakdownListParams = {},\n ): Promise<ApiResponse<BreakdownListData>> {\n return this.http.get<BreakdownListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n}\n\n/**\n * Per-track engagement metrics (`campaign_engagement_daily` schema).\n *\n * Access via `soundlink.metrics.engagement`. Only JSONL export is shipped.\n */\nexport class EngagementMetricsResource {\n /**\n * Stream full engagement export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement/export`.\n */\n readonly export: ExportResource<EngagementRow, EngagementExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<EngagementRow, EngagementExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n engagementContext: params.engagementContext,\n }),\n );\n }\n}\n","import { HttpClient } from './http-client.js';\nimport {\n CampaignsResource,\n MetricsResource,\n PingResource,\n StrategiesResource,\n} from '../resources/index.js';\nimport type { SoundlinkOptions } from '../types/api.js';\n\n/**\n * Official Soundlink Public API client.\n *\n * All methods return `{ data, error, meta? }` and never throw on HTTP/API errors.\n * SDK configuration, parsing, and transport failures throw {@link SoundlinkSdkError}.\n *\n * @example\n * ```ts\n * import { Soundlink } from 'soundlink';\n *\n * const soundlink = new Soundlink(process.env.SOUNDLINK_API_KEY!);\n *\n * const { data, error } = await soundlink.ping();\n * if (error) {\n * console.error(error.code, error.message);\n * } else {\n * console.log(data.status);\n * }\n * ```\n *\n * @see https://docs.getsoundlink.com\n */\nexport class Soundlink {\n /** Verify connectivity and authentication. Maps to `GET /v1/ping`. */\n readonly ping: PingResource['ping'];\n\n /** Growth strategy catalog. Requires `campaigns:read` scope. */\n readonly strategies: StrategiesResource;\n\n /** List, fetch, and manage campaigns. Read needs `campaigns:read`; writes need `campaigns:write`. */\n readonly campaigns: CampaignsResource;\n\n /** Campaign metrics, breakdowns, and JSONL exports. Requires `metrics:read` scope. */\n readonly metrics: MetricsResource;\n\n /**\n * Create a Soundlink client.\n *\n * @param options - API key string (`sk_*`) or {@link SoundlinkClientOptions}.\n */\n constructor(options: SoundlinkOptions) {\n const http = new HttpClient(options);\n const pingResource = new PingResource(http);\n\n this.ping = pingResource.ping.bind(pingResource);\n this.strategies = new StrategiesResource(http);\n this.campaigns = new CampaignsResource(http);\n this.metrics = new MetricsResource(http);\n }\n}\n\nexport { HttpClient, resolveClientOptions } from './http-client.js';\n"]}
@@ -345,7 +345,7 @@ interface JsonlStream<T> extends AsyncIterable<T> {
345
345
  }
346
346
  /** Options for {@link Soundlink} and {@link HttpClient}. */
347
347
  interface SoundlinkClientOptions {
348
- /** Soundlink API key (`sk_<prefix>_<secret>`). Sent as the `x-api-key` header. */
348
+ /** Soundlink API key (`sk_<prefix>_<secret>`). Sent as `Authorization: Bearer`. */
349
349
  apiKey: string;
350
350
  /** API base URL. Defaults to `https://api.getsoundlink.com`. */
351
351
  baseUrl?: string;
package/dist/esm/index.js CHANGED
@@ -292,7 +292,7 @@ var HttpClient = class {
292
292
  }
293
293
  buildHeaders(extra = {}) {
294
294
  return {
295
- "x-api-key": this.options.apiKey,
295
+ Authorization: `Bearer ${this.options.apiKey}`,
296
296
  Accept: "application/json",
297
297
  ...extra
298
298
  };
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/constants/defaults.ts","../../src/core/api-response.ts","../../src/errors/sdk-error.ts","../../src/core/jsonl.ts","../../src/utils/query.ts","../../src/client/http-client.ts","../../src/resources/index.ts","../../src/client/soundlink.ts"],"names":[],"mappings":";AAAO,IAAM,gBAAA,GAAmB;AAEzB,IAAM,kBAAA,GAAqB;AAE3B,IAAM,mBAAA,GAAsB;AAE5B,IAAM,cAAA,GAAiB;AAEvB,IAAM,uBAAA,GAA0B;AAEhC,IAAM,qBAAA,GAAwB;AAM9B,IAAM,kBAAA,GAAqB,KAAA;;;ACP3B,SAAS,mBAAmB,IAAA,EAAyC;AAC1E,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,KAAS,IAAA,EAAM;AAC7C,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,IAAA;AACf,EAAA,OACE,OAAO,MAAA,CAAO,KAAA,KAAU,QAAA,IACxB,OAAO,KAAA,KAAU,IAAA,IACjB,OAAQ,MAAA,CAAO,MAAkC,IAAA,KAAS,QAAA,IAC1D,OAAQ,MAAA,CAAO,MAAkC,OAAA,KAAY,QAAA;AAEjE;AAEO,SAAS,qBAAwB,IAAA,EAA8C;AACpF,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,KAAS,IAAA,EAAM;AAC7C,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,IAAA;AACf,EAAA,OAAO,UAAU,MAAA,IAAU,OAAO,OAAO,IAAA,KAAS,QAAA,IAAY,OAAO,IAAA,KAAS,IAAA;AAChF;AAEO,SAAS,UAAA,CACd,QAAA,EACA,MAAA,EACA,UAAA,EACU;AACV,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,QAAA,CAAS,KAAA;AAE7B,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAS,KAAA,CAAM,IAAA;AAAA,IACrB,OAAA,EAAS,SAAS,KAAA,CAAM,OAAA;AAAA,IACxB,MAAA;AAAA,IACA,SAAA,EAAW,SAAS,IAAA,CAAK,SAAA;AAAA,IACzB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe,EAAC;AAAA,IACjD,GAAI,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,KAAY;AAAC,GAC7C;AACF;AAEO,SAAS,eAAA,CAAmB,MAAS,IAAA,EAA+B;AACzE,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,KAAA,EAAO,IAAA;AAAA,IACP;AAAA,GACF;AACF;AAEO,SAAS,cAAiB,KAAA,EAAiC;AAChE,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,IAAA;AAAA,IACN,KAAA;AAAA,IACA,GAAI,KAAA,CAAM,SAAA,GAAY,EAAE,IAAA,EAAM,EAAE,SAAA,EAAW,KAAA,CAAM,SAAA,EAAU,EAAE,GAAI;AAAC,GACpE;AACF;AAEO,SAAS,sBAAsB,KAAA,EAA0C;AAC9E,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,QAAA,CAAS,KAAA,EAAO,EAAE,CAAA;AACzC,EAAA,IAAI,MAAA,CAAO,QAAA,CAAS,OAAO,CAAA,IAAK,WAAW,CAAA,EAAG;AAC5C,IAAA,OAAO,OAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA;AAC/B,EAAA,IAAI,MAAA,CAAO,QAAA,CAAS,MAAM,CAAA,EAAG;AAC3B,IAAA,MAAM,eAAe,IAAA,CAAK,IAAA,CAAA,CAAM,SAAS,IAAA,CAAK,GAAA,MAAS,GAAI,CAAA;AAC3D,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,YAAA,EAAc,CAAC,CAAA;AAAA,EACjC;AAEA,EAAA,OAAO,MAAA;AACT;;;AC7EO,IAAM,iBAAA,GAAN,MAAM,kBAAA,SAA0B,KAAA,CAAM;AAAA,EAC3C,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,mBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,kBAAA,CAAkB,SAAS,CAAA;AAAA,EACzD;AACF;AAGO,IAAM,mBAAA,GAAN,MAAM,oBAAA,SAA4B,iBAAA,CAAkB;AAAA,EACzD,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,qBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,oBAAA,CAAoB,SAAS,CAAA;AAAA,EAC3D;AACF;AAGO,IAAM,oBAAA,GAAN,MAAM,qBAAA,SAA6B,iBAAA,CAAkB;AAAA,EAC1D,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,qBAAA,CAAqB,SAAS,CAAA;AAAA,EAC5D;AACF;;;AC3BA,gBAAuB,iBAAA,CACrB,MACA,eAAA,EACmB;AACnB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,MAAA,GAAS,KAAK,SAAA,EAAU;AAC9B,EAAA,MAAM,OAAA,GAAU,IAAI,WAAA,EAAY;AAChC,EAAA,IAAI,MAAA,GAAS,EAAA;AAEb,EAAA,IAAI;AACF,IAAA,WAAS;AACP,MAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,MAAA,IAAI,IAAA,EAAM;AACR,QAAA;AAAA,MACF;AAEA,MAAA,MAAA,IAAU,QAAQ,MAAA,CAAO,KAAA,EAAO,EAAE,MAAA,EAAQ,MAAM,CAAA;AAChD,MAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA;AAC/B,MAAA,MAAA,GAAS,KAAA,CAAM,KAAI,IAAK,EAAA;AAExB,MAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,QAAA,MAAM,OAAA,GAAU,KAAK,IAAA,EAAK;AAC1B,QAAA,IAAI,CAAC,OAAA,EAAS;AACZ,UAAA;AAAA,QACF;AAEA,QAAA,IAAI;AACF,UAAA,MAAM,IAAA,CAAK,MAAM,OAAO,CAAA;AAAA,QAC1B,SAAS,KAAA,EAAO;AACd,UAAA,eAAA,GAAkB,SAAS,KAAK,CAAA;AAChC,UAAA,MAAM,IAAI,oBAAoB,oCAAoC,CAAA;AAAA,QACpE;AAAA,MACF;AAAA,IACF;AAEA,IAAA,MAAM,QAAA,GAAW,OAAO,IAAA,EAAK;AAC7B,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAK,MAAM,QAAQ,CAAA;AAAA,MAC3B,SAAS,KAAA,EAAO;AACd,QAAA,eAAA,GAAkB,UAAU,KAAK,CAAA;AACjC,QAAA,MAAM,IAAI,oBAAoB,oCAAoC,CAAA;AAAA,MACpE;AAAA,IACF;AAAA,EACF,CAAA,SAAE;AACA,IAAA,MAAA,CAAO,WAAA,EAAY;AAAA,EACrB;AACF;AAEA,eAAsB,oBACpB,MAAA,EAC0C;AAC1C,EAAA,MAAM,OAAY,EAAC;AACnB,EAAA,WAAA,MAAiB,OAAO,MAAA,EAAQ;AAC9B,IAAA,IAAA,CAAK,KAAK,GAAG,CAAA;AAAA,EACf;AACA,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,UAAU,IAAA,CAAK;AAAA,GACjB;AACF;;;ACjEO,SAAS,iBACd,MAAA,EACQ;AACR,EAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AAEzC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AACjD,IAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,IAAQ,UAAU,EAAA,EAAI;AACzD,MAAA;AAAA,IACF;AACA,IAAA,YAAA,CAAa,GAAA,CAAI,GAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACrC;AAEA,EAAA,MAAM,KAAA,GAAQ,aAAa,QAAA,EAAS;AACpC,EAAA,OAAO,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAA;AAC/B;AAEO,SAAS,OAAA,CAAQ,SAAiB,IAAA,EAAsB;AAC7D,EAAA,MAAM,cAAA,GAAiB,QAAQ,QAAA,CAAS,GAAG,IAAI,OAAA,CAAQ,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAAI,OAAA;AACtE,EAAA,MAAM,iBAAiB,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA,GAAI,IAAA,GAAO,IAAI,IAAI,CAAA,CAAA;AAC7D,EAAA,OAAO,CAAA,EAAG,cAAc,CAAA,EAAG,cAAc,CAAA,CAAA;AAC3C;AAEO,SAAS,MAAM,EAAA,EAA2B;AAC/C,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY;AAC9B,IAAA,UAAA,CAAW,SAAS,EAAE,CAAA;AAAA,EACxB,CAAC,CAAA;AACH;AAEO,SAAS,mBAAmB,OAAA,EAAyB;AAC1D,EAAA,MAAM,IAAA,GAAO,GAAA;AACb,EAAA,MAAM,SAAS,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,GAAG,CAAA;AAC7C,EAAA,OAAO,IAAA,GAAO,KAAK,OAAA,GAAU,MAAA;AAC/B;;;AC0BO,SAAS,qBACd,OAAA,EACgC;AAChC,EAAA,MAAM,aAAa,OAAO,OAAA,KAAY,WAAW,EAAE,MAAA,EAAQ,SAAQ,GAAI,OAAA;AAEvE,EAAA,MAAM,MAAA,GAAS,UAAA,CAAW,MAAA,CAAO,IAAA,EAAK;AACtC,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,qBAAqB,qBAAqB,CAAA;AAAA,EACtD;AAEA,EAAA,IAAI,CAAC,MAAA,CAAO,UAAA,CAAW,cAAc,CAAA,EAAG;AACtC,IAAA,MAAM,IAAI,oBAAA;AAAA,MACR,yDAAyD,cAAc,CAAA,EAAA;AAAA,KACzE;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,OAAA,EAAS,WAAW,OAAA,IAAW,gBAAA;AAAA,IAC/B,OAAA,EAAS,WAAW,OAAA,IAAW,kBAAA;AAAA,IAC/B,UAAA,EAAY,WAAW,UAAA,IAAc,mBAAA;AAAA,IACrC,OAAO,UAAA,CAAW,KAAA,IAAS,UAAA,CAAW,KAAA,CAAM,KAAK,UAAU;AAAA,GAC7D;AACF;AAEO,IAAM,aAAN,MAAiB;AAAA,EACL,OAAA;AAAA,EAEjB,YAAY,OAAA,EAA2B;AACrC,IAAA,IAAA,CAAK,OAAA,GAAU,qBAAqB,OAAO,CAAA;AAAA,EAC7C;AAAA,EAEA,IAAI,eAAA,GAAkD;AACpD,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,MAAM,GAAA,CAAO,EAAE,IAAA,EAAM,OAAM,EAA4C;AACrE,IAAA,MAAM,GAAA,GAAM,OAAA;AAAA,MACV,KAAK,OAAA,CAAQ,OAAA;AAAA,MACb,CAAA,EAAG,kBAAkB,CAAA,EAAG,IAAI,GAAG,gBAAA,CAAiB,KAAA,IAAS,EAAE,CAAC,CAAA;AAAA,KAC9D;AAEA,IAAA,OAAO,IAAA,CAAK,YAAe,GAAA,EAAK;AAAA,MAC9B,MAAA,EAAQ,KAAA;AAAA,MACR,OAAA,EAAS,KAAK,YAAA;AAAa,KAC5B,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,IAAA,CAAQ;AAAA,IACZ,IAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA;AAAA,IACA,OAAA;AAAA,IACA;AAAA,GACF,EAAiD;AAC/C,IAAA,OAAO,IAAA,CAAK,WAAc,MAAA,EAAQ;AAAA,MAChC,IAAA;AAAA,MACA,IAAA;AAAA,MACA,KAAA;AAAA,MACA,OAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,KAAA,CAAS;AAAA,IACb,IAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA;AAAA,IACA,OAAA;AAAA,IACA;AAAA,GACF,EAAiD;AAC/C,IAAA,OAAO,IAAA,CAAK,WAAc,OAAA,EAAS;AAAA,MACjC,IAAA;AAAA,MACA,IAAA;AAAA,MACA,KAAA;AAAA,MACA,OAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,QAAA,CAAY;AAAA,IAChB,IAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA,GAAS;AAAA,GACX,EAA2D;AACzD,IAAA,MAAM,GAAA,GAAM,OAAA;AAAA,MACV,KAAK,OAAA,CAAQ,OAAA;AAAA,MACb,CAAA,EAAG,kBAAkB,CAAA,EAAG,IAAI,GAAG,gBAAA,CAAiB,KAAA,IAAS,EAAE,CAAC,CAAA;AAAA,KAC9D;AAEA,IAAA,IAAI,QAAA;AACJ,IAAA,IAAI;AACF,MAAA,QAAA,GAAW,MAAM,IAAA,CAAK,cAAA,CAAe,GAAA,EAAK;AAAA,QACxC,MAAA,EAAQ,KAAA;AAAA,QACR,OAAA,EAAS;AAAA,UACP,GAAG,KAAK,YAAA,EAAa;AAAA,UACrB,MAAA,EAAQ;AAAA;AACV,OACD,CAAA;AAAA,IACH,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,iBAAiB,KAAK,CAAA;AAAA,IAC9B;AAEA,IAAA,MAAM,aAAa,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAE5E,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,OAAO,IAAA,CAAK,kBAAA,CAAmC,QAAA,EAAU,UAAU,CAAA;AAAA,IACrE;AAEA,IAAA,MAAM,WAAA,GAAc,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,cAAc,CAAA,IAAK,EAAA;AAC5D,IAAA,IAAI,WAAA,CAAY,QAAA,CAAS,kBAAkB,CAAA,EAAG;AAC5C,MAAA,OAAO,IAAA,CAAK,kBAAA,CAAmC,QAAA,EAAU,UAAU,CAAA;AAAA,IACrE;AAEA,IAAA,MAAM,cAAA,GAAiB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAA;AACzD,IAAA,MAAM,iBACJ,cAAA,KAAmB,IAAA,GAAO,OAAO,QAAA,CAAS,cAAA,EAAgB,EAAE,CAAA,GAAI,MAAA;AAElE,IAAA,MAAM,MAAA,GAAS,iBAAA,CAAqB,QAAA,CAAS,IAAI,CAAA;AACjD,IAAA,MAAM,IAAA,GAAO,sBAAA,CAAuB,MAAA,EAAQ,cAAc,CAAA;AAE1D,IAAA,OAAO;AAAA,MACL,IAAA;AAAA,MACA,KAAA,EAAO;AAAA,KACT;AAAA,EACF;AAAA,EAEQ,UAAA,CACN,QACA,EAAE,IAAA,EAAM,MAAM,KAAA,EAAO,OAAA,EAAS,gBAAe,EACpB;AACzB,IAAA,MAAM,GAAA,GAAM,OAAA;AAAA,MACV,KAAK,OAAA,CAAQ,OAAA;AAAA,MACb,CAAA,EAAG,kBAAkB,CAAA,EAAG,IAAI,GAAG,gBAAA,CAAiB,KAAA,IAAS,EAAE,CAAC,CAAA;AAAA,KAC9D;AAEA,IAAA,MAAM,cAAA,GAAiB,KAAK,YAAA,CAAa;AAAA,MACvC,GAAI,IAAA,KAAS,MAAA,GAAY,EAAE,cAAA,EAAgB,kBAAA,KAAuB,EAAC;AAAA,MACnE,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAE,iBAAA,EAAmB,cAAA,KAAmB,EAAC;AAAA,MAC5E,GAAG;AAAA,KACJ,CAAA;AAED,IAAA,OAAO,IAAA,CAAK,YAAe,GAAA,EAAK;AAAA,MAC9B,MAAA;AAAA,MACA,OAAA,EAAS,cAAA;AAAA,MACT,GAAI,IAAA,KAAS,MAAA,GAAY,EAAE,IAAA,EAAM,KAAK,SAAA,CAAU,IAAI,CAAA,EAAE,GAAI;AAAC,KAC5D,CAAA;AAAA,EACH;AAAA,EAEQ,YAAA,CAAa,KAAA,GAAgC,EAAC,EAA2B;AAC/E,IAAA,OAAO;AAAA,MACL,WAAA,EAAa,KAAK,OAAA,CAAQ,MAAA;AAAA,MAC1B,MAAA,EAAQ,kBAAA;AAAA,MACR,GAAG;AAAA,KACL;AAAA,EACF;AAAA,EAEA,MAAc,WAAA,CACZ,GAAA,EACA,IAAA,EACyB;AACzB,IAAA,IAAI,QAAA;AAEJ,IAAA,IAAI;AACF,MAAA,QAAA,GAAW,MAAM,IAAA,CAAK,cAAA,CAAe,GAAA,EAAK,IAAI,CAAA;AAAA,IAChD,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,iBAAiB,KAAK,CAAA;AAAA,IAC9B;AAEA,IAAA,MAAM,aAAa,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAE5E,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,OAAO,IAAA,CAAK,kBAAA,CAAsB,QAAA,EAAU,UAAU,CAAA;AAAA,IACxD;AAEA,IAAA,IAAI,IAAA;AACJ,IAAA,IAAI;AACF,MAAA,IAAA,GAAO,MAAM,SAAS,IAAA,EAAK;AAAA,IAC7B,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,mBAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AAEA,IAAA,IAAI,kBAAA,CAAmB,IAAI,CAAA,EAAG;AAC5B,MAAA,OAAO,cAAc,UAAA,CAAW,IAAA,EAAM,QAAA,CAAS,MAAA,EAAQ,UAAU,CAAC,CAAA;AAAA,IACpE;AAEA,IAAA,IAAI,oBAAA,CAAwB,IAAI,CAAA,EAAG;AACjC,MAAA,OAAO,eAAA,CAAgB,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,IAAI,CAAA;AAAA,IAC7C;AAEA,IAAA,MAAM,IAAI,oBAAoB,+CAA+C,CAAA;AAAA,EAC/E;AAAA,EAEA,MAAc,kBAAA,CACZ,QAAA,EACA,UAAA,EACyB;AACzB,IAAA,IAAI,IAAA,GAAgB,IAAA;AAEpB,IAAA,IAAI;AACF,MAAA,IAAA,GAAO,MAAM,SAAS,IAAA,EAAK;AAAA,IAC7B,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,aAAA,CAAc;AAAA,QACnB,IAAA,EAAM,gBAAA;AAAA,QACN,OAAA,EAAS,CAAA,2BAAA,EAA8B,MAAA,CAAO,QAAA,CAAS,MAAM,CAAC,CAAA,CAAA,CAAA;AAAA,QAC9D,QAAQ,QAAA,CAAS,MAAA;AAAA,QACjB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe;AAAC,OAClD,CAAA;AAAA,IACH;AAEA,IAAA,IAAI,kBAAA,CAAmB,IAAI,CAAA,EAAG;AAC5B,MAAA,OAAO,cAAc,UAAA,CAAW,IAAA,EAAM,QAAA,CAAS,MAAA,EAAQ,UAAU,CAAC,CAAA;AAAA,IACpE;AAEA,IAAA,OAAO,aAAA,CAAc;AAAA,MACnB,IAAA,EAAM,gBAAA;AAAA,MACN,OAAA,EAAS,CAAA,2BAAA,EAA8B,MAAA,CAAO,QAAA,CAAS,MAAM,CAAC,CAAA,CAAA,CAAA;AAAA,MAC9D,QAAQ,QAAA,CAAS,MAAA;AAAA,MACjB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe;AAAC,KAClD,CAAA;AAAA,EACH;AAAA,EAEA,MAAc,cAAA,CAAe,GAAA,EAAa,IAAA,EAAsC;AAC9E,IAAA,MAAM,EAAE,UAAA,EAAY,OAAA,EAAS,KAAA,KAAU,IAAA,CAAK,OAAA;AAC5C,IAAA,IAAI,OAAA,GAAU,CAAA;AAEd,IAAA,IAAI,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,MAC9B,GAAG,IAAA;AAAA,MACH,MAAA,EAAQ,WAAA,CAAY,OAAA,CAAQ,OAAO;AAAA,KACpC,CAAA;AAED,IAAA,OACE,UAAU,UAAA,KACT,QAAA,CAAS,WAAW,GAAA,IAAO,QAAA,CAAS,UAAU,GAAA,CAAA,EAC/C;AACA,MAAA,MAAM,aAAa,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAC5E,MAAA,MAAM,UACJ,UAAA,KAAe,MAAA,GAAY,UAAA,GAAa,GAAA,GAAO,mBAAmB,OAAO,CAAA;AAE3E,MAAA,OAAA,IAAW,CAAA;AACX,MAAA,MAAM,MAAM,OAAO,CAAA;AAEnB,MAAA,QAAA,GAAW,MAAM,MAAM,GAAA,EAAK;AAAA,QAC1B,GAAG,IAAA;AAAA,QACH,MAAA,EAAQ,WAAA,CAAY,OAAA,CAAQ,OAAO;AAAA,OACpC,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,QAAA;AAAA,EACT;AACF;AAEA,SAAS,iBAAiB,KAAA,EAAqC;AAC7D,EAAA,IAAI,iBAAiB,KAAA,EAAO;AAC1B,IAAA,OAAO,IAAI,mBAAA,CAAoB,CAAA,wBAAA,EAA2B,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AAAA,EAC3E;AAEA,EAAA,OAAO,IAAI,oBAAoB,yBAAyB,CAAA;AAC1D;AAEA,SAAS,sBAAA,CACP,QACA,QAAA,EACgB;AAChB,EAAA,MAAM,WAAA,GAA8B;AAAA,IAClC,QAAQ,MAAA,CAAO,aAAa,CAAA,GAAI;AAC9B,MAAA,WAAA,MAAiB,OAAO,MAAA,EAAQ;AAC9B,QAAA,MAAM,GAAA;AAAA,MACR;AAAA,IACF;AAAA,GACF;AAEA,EAAA,IAAI,aAAa,MAAA,IAAa,CAAC,MAAA,CAAO,KAAA,CAAM,QAAQ,CAAA,EAAG;AACrD,IAAA,WAAA,CAAY,QAAA,GAAW,QAAA;AAAA,EACzB;AAEA,EAAA,OAAO,WAAA;AACT;AAOO,SAAS,kBAAqB,MAAA,EAA8C;AACjF,EAAA,IAAI,OAAO,MAAA,KAAW,QAAA,IAAY,UAAA,IAAc,MAAA,EAAQ;AACtD,IAAA,MAAM,QAAS,MAAA,CAA0B,QAAA;AACzC,IAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,MAAA;AAAA,EAC7C;AAEA,EAAA,OAAO,MAAA;AACT;;;ACpSA,SAAS,oBAAA,CACP,IAAA,EACA,SAAA,EACA,UAAA,EAGsB;AACtB,EAAA,MAAM,QAAA,IAAY,CAAC,UAAA,EAAoB,MAAA,GAAY,EAAC,KAAW;AAC7D,IAAA,OAAO,KAAK,QAAA,CAAY;AAAA,MACtB,IAAA,EAAM,UAAU,UAAU,CAAA;AAAA,MAC1B,KAAA,EAAO,WAAW,MAAM;AAAA,KACzB,CAAA;AAAA,EACH,CAAA,CAAA;AAEA,EAAA,QAAA,CAAS,OAAA,GAAU,OAAO,UAAA,EAAoB,MAAA,GAAY,EAAC,KAAW;AACpE,IAAA,MAAM,QAAA,GAAW,MAAM,QAAA,CAAS,UAAA,EAAY,MAAM,CAAA;AAElD,IAAA,IAAI,QAAA,CAAS,KAAA,IAAS,CAAC,QAAA,CAAS,IAAA,EAAM;AACpC,MAAA,OAAO;AAAA,QACL,IAAA,EAAM,IAAA;AAAA,QACN,OAAO,QAAA,CAAS,KAAA;AAAA,QAChB,MAAM,QAAA,CAAS;AAAA,OACjB;AAAA,IACF;AAEA,IAAA,MAAM,SAAA,GAAY,MAAM,mBAAA,CAAoB,QAAA,CAAS,IAAI,CAAA;AAEzD,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,SAAA;AAAA,MACN,KAAA,EAAO,IAAA;AAAA,MACP,MAAM,QAAA,CAAS;AAAA,KACjB;AAAA,EACF,CAAA;AAEA,EAAA,OAAO,QAAA;AACT;AAGO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA,EAAnB,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAc7B,IAAA,GAAuC;AACrC,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA,CAAc,EAAE,IAAA,EAAM,SAAS,CAAA;AAAA,EAClD;AACF,CAAA;AAGO,IAAM,qBAAN,MAAyB;AAAA,EAC9B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA,EAAnB,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAY7B,IAAA,GAAoD;AAClD,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA,CAA2B,EAAE,IAAA,EAAM,eAAe,CAAA;AAAA,EACrE;AACF,CAAA;AAGO,IAAM,wBAAN,MAA4B;AAAA,EACjC,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA,EAAnB,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7B,IAAI,UAAA,EAA6D;AAC/D,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAuB;AAAA,MACtC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,MAAA;AAAA,KACnD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAA,CACE,YACA,IAAA,EACyC;AACzC,IAAA,OAAO,IAAA,CAAK,KAAK,KAAA,CAAyB;AAAA,MACxC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,MAAA,CAAA;AAAA,MAClD;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAA;AAGO,IAAM,oBAAN,MAAwB;AAAA,EAI7B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAI,qBAAA,CAAsB,IAAI,CAAA;AAAA,EAC7C;AAAA,EAF6B,IAAA;AAAA;AAAA,EAFpB,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBT,IAAA,CAAK,MAAA,GAA6B,EAAC,EAA2C;AAC5E,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAsB;AAAA,MACrC,IAAA,EAAM,YAAA;AAAA,MACN,KAAA,EAAO;AAAA,QACL,MAAM,MAAA,CAAO,IAAA;AAAA,QACb,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,WAAW,MAAA,CAAO;AAAA;AACpB,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,IAAI,UAAA,EAA0D;AAC5D,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAoB;AAAA,MACnC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA;AAAA,KACnD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,MAAA,CACE,MACA,OAAA,EAC0C;AAC1C,IAAA,OAAO,IAAA,CAAK,KAAK,IAAA,CAAyB;AAAA,MACxC,IAAA,EAAM,YAAA;AAAA,MACN,IAAA;AAAA,MACA,gBAAgB,OAAA,CAAQ;AAAA,KACzB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAA,CACE,YACA,OAAA,EACwC;AACxC,IAAA,OAAO,IAAA,CAAK,KAAK,IAAA,CAAuB;AAAA,MACtC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,KAAA,CAAA;AAAA,MAClD,gBAAgB,OAAA,CAAQ;AAAA,KACzB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,cAAA,CACE,UAAA,EACA,IAAA,EACA,OAAA,EACkD;AAClD,IAAA,OAAO,IAAA,CAAK,KAAK,IAAA,CAAiC;AAAA,MAChD,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,gBAAA,CAAA;AAAA,MAClD,IAAA;AAAA,MACA,gBAAgB,OAAA,CAAQ;AAAA,KACzB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,cAAA,CACE,UAAA,EACA,IAAA,EACA,OAAA,EACkD;AAClD,IAAA,OAAO,IAAA,CAAK,KAAK,IAAA,CAAiC;AAAA,MAChD,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,gBAAA,CAAA;AAAA,MAClD,IAAA;AAAA,MACA,gBAAgB,OAAA,CAAQ;AAAA,KACzB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,OAAO,OAAA,CACL,MAAA,GAA2C,EAAC,EACmB;AAC/D,IAAA,IAAI,IAAA,GAAO,CAAA;AACX,IAAA,IAAI,UAAA,GAAa,CAAA;AAEjB,IAAA,OAAO,QAAQ,UAAA,EAAY;AACzB,MAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,CAAK,EAAE,GAAG,MAAA,EAAQ,MAAM,CAAA;AAEpD,MAAA,IAAI,QAAA,CAAS,KAAA,IAAS,CAAC,QAAA,CAAS,IAAA,EAAM;AACpC,QAAA;AAAA,MACF;AAEA,MAAA,KAAA,MAAW,IAAA,IAAQ,QAAA,CAAS,IAAA,CAAK,KAAA,EAAO;AACtC,QAAA,MAAM,IAAA;AAAA,MACR;AAEA,MAAA,UAAA,GAAa,QAAA,CAAS,KAAK,UAAA,CAAW,UAAA;AACtC,MAAA,IAAA,IAAQ,CAAA;AAAA,IACV;AAAA,EACF;AACF,CAAA;AAYO,IAAM,kBAAN,MAAsB;AAAA,EAO3B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,wBAAA,CAAyB,IAAI,CAAA;AAClD,IAAA,IAAA,CAAK,UAAA,GAAa,IAAI,yBAAA,CAA0B,IAAI,CAAA;AAAA,EACtD;AAAA,EAH6B,IAAA;AAAA;AAAA,EALpB,SAAA;AAAA;AAAA,EAGA,UAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBT,QAAA,CACE,UAAA,EACA,MAAA,GAA0B,EAAC,EACY;AACvC,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAqB;AAAA,MACpC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,iBAAA,CAAA;AAAA,MAClD,KAAA,EAAO;AAAA,QACL,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO;AAAA;AAClB,KACD,CAAA;AAAA,EACH;AACF,CAAA;AAOO,IAAM,2BAAN,MAA+B;AAAA,EAQpC,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,MAAA,GAAS,oBAAA;AAAA,MACZ,IAAA;AAAA,MACA,CAAC,UAAA,KACC,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,yBAAA,CAAA;AAAA,MAC9C,CAAC,MAAA,MAAY;AAAA,QACX,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO;AAAA,OAClB;AAAA,KACF;AAAA,EACF;AAAA,EAV6B,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAFpB,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBT,IAAA,CACE,UAAA,EACA,MAAA,GAA8B,EAAC,EACU;AACzC,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAuB;AAAA,MACtC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,kBAAA,CAAA;AAAA,MAClD,KAAA,EAAO;AAAA,QACL,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO,OAAA;AAAA,QAChB,MAAM,MAAA,CAAO,IAAA;AAAA,QACb,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,WAAW,MAAA,CAAO;AAAA;AACpB,KACD,CAAA;AAAA,EACH;AACF,CAAA;AAOO,IAAM,4BAAN,MAAgC;AAAA,EAQrC,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,MAAA,GAAS,oBAAA;AAAA,MACZ,IAAA;AAAA,MACA,CAAC,UAAA,KACC,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,0BAAA,CAAA;AAAA,MAC9C,CAAC,MAAA,MAAY;AAAA,QACX,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO,OAAA;AAAA,QAChB,mBAAmB,MAAA,CAAO;AAAA,OAC5B;AAAA,KACF;AAAA,EACF;AAAA,EAX6B,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAFpB,MAAA;AAcX,CAAA;;;AClbO,IAAM,YAAN,MAAgB;AAAA;AAAA,EAEZ,IAAA;AAAA;AAAA,EAGA,UAAA;AAAA;AAAA,EAGA,SAAA;AAAA;AAAA,EAGA,OAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,YAAY,OAAA,EAA2B;AACrC,IAAA,MAAM,IAAA,GAAO,IAAI,UAAA,CAAW,OAAO,CAAA;AACnC,IAAA,MAAM,YAAA,GAAe,IAAI,YAAA,CAAa,IAAI,CAAA;AAE1C,IAAA,IAAA,CAAK,IAAA,GAAO,YAAA,CAAa,IAAA,CAAK,IAAA,CAAK,YAAY,CAAA;AAC/C,IAAA,IAAA,CAAK,UAAA,GAAa,IAAI,kBAAA,CAAmB,IAAI,CAAA;AAC7C,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,iBAAA,CAAkB,IAAI,CAAA;AAC3C,IAAA,IAAA,CAAK,OAAA,GAAU,IAAI,eAAA,CAAgB,IAAI,CAAA;AAAA,EACzC;AACF","file":"index.js","sourcesContent":["export const DEFAULT_BASE_URL = 'https://api.getsoundlink.com';\n\nexport const DEFAULT_TIMEOUT_MS = 30_000;\n\nexport const DEFAULT_MAX_RETRIES = 2;\n\nexport const API_KEY_PREFIX = 'sk_';\n\nexport const CAMPAIGNS_MAX_PAGE_SIZE = 100;\n\nexport const METRICS_MAX_PAGE_SIZE = 500;\n\nexport const METRICS_DEFAULT_PAGE_SIZE = 50;\n\nexport const CAMPAIGNS_DEFAULT_PAGE_SIZE = 10;\n\nexport const API_VERSION_PREFIX = '/v1';\n","import type {\n ApiEnvelopeError,\n ApiEnvelopeSuccess,\n ApiMeta,\n ApiError,\n ApiResponse,\n PublicApiErrorCode,\n} from '../types/api.js';\n\nexport function isApiEnvelopeError(body: unknown): body is ApiEnvelopeError {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return (\n typeof record.error === 'object' &&\n record.error !== null &&\n typeof (record.error as Record<string, unknown>).code === 'string' &&\n typeof (record.error as Record<string, unknown>).message === 'string'\n );\n}\n\nexport function isApiEnvelopeSuccess<T>(body: unknown): body is ApiEnvelopeSuccess<T> {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return 'data' in record && typeof record.meta === 'object' && record.meta !== null;\n}\n\nexport function toApiError(\n envelope: ApiEnvelopeError,\n status: number,\n retryAfter?: number,\n): ApiError {\n const { details } = envelope.error;\n\n return {\n code: envelope.error.code as PublicApiErrorCode,\n message: envelope.error.message,\n status,\n requestId: envelope.meta.requestId,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n ...(details !== undefined ? { details } : {}),\n };\n}\n\nexport function successResponse<T>(data: T, meta: ApiMeta): ApiResponse<T> {\n return {\n data,\n error: null,\n meta,\n };\n}\n\nexport function errorResponse<T>(error: ApiError): ApiResponse<T> {\n return {\n data: null,\n error,\n ...(error.requestId ? { meta: { requestId: error.requestId } } : {}),\n };\n}\n\nexport function parseRetryAfterHeader(value: string | null): number | undefined {\n if (!value) {\n return undefined;\n }\n\n const seconds = Number.parseInt(value, 10);\n if (Number.isFinite(seconds) && seconds >= 0) {\n return seconds;\n }\n\n const dateMs = Date.parse(value);\n if (Number.isFinite(dateMs)) {\n const deltaSeconds = Math.ceil((dateMs - Date.now()) / 1000);\n return Math.max(deltaSeconds, 0);\n }\n\n return undefined;\n}\n","/**\n * Base error for unexpected SDK failures (configuration, parsing, transport).\n *\n * HTTP/API errors from Soundlink are returned as `{ data: null, error }` and do not throw.\n */\nexport class SoundlinkSdkError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkSdkError';\n Object.setPrototypeOf(this, SoundlinkSdkError.prototype);\n }\n}\n\n/** Thrown when a response body cannot be parsed or the network request fails unexpectedly. */\nexport class SoundlinkParseError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkParseError';\n Object.setPrototypeOf(this, SoundlinkParseError.prototype);\n }\n}\n\n/** Thrown when the client is misconfigured (missing or invalid API key, etc.). */\nexport class SoundlinkConfigError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkConfigError';\n Object.setPrototypeOf(this, SoundlinkConfigError.prototype);\n }\n}\n","import { SoundlinkParseError } from '../errors/sdk-error.js';\n\nexport async function* parseNdjsonStream<T>(\n body: ReadableStream<Uint8Array> | null,\n onMalformedLine?: (line: string, error: unknown) => void,\n): AsyncGenerator<T> {\n if (!body) {\n return;\n }\n\n const reader = body.getReader();\n const decoder = new TextDecoder();\n let buffer = '';\n\n try {\n for (;;) {\n const { done, value } = await reader.read();\n if (done) {\n break;\n }\n\n buffer += decoder.decode(value, { stream: true });\n const lines = buffer.split('\\n');\n buffer = lines.pop() ?? '';\n\n for (const line of lines) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n\n try {\n yield JSON.parse(trimmed) as T;\n } catch (error) {\n onMalformedLine?.(trimmed, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n }\n\n const trailing = buffer.trim();\n if (trailing) {\n try {\n yield JSON.parse(trailing) as T;\n } catch (error) {\n onMalformedLine?.(trailing, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n } finally {\n reader.releaseLock();\n }\n}\n\nexport async function collectNdjsonStream<T>(\n stream: AsyncIterable<T>,\n): Promise<{ rows: T[]; rowCount: number }> {\n const rows: T[] = [];\n for await (const row of stream) {\n rows.push(row);\n }\n return {\n rows,\n rowCount: rows.length,\n };\n}\n\nexport function parseNdjsonText<T>(text: string): T[] {\n const rows: T[] = [];\n for (const line of text.split('\\n')) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n rows.push(JSON.parse(trimmed) as T);\n }\n\n return rows;\n}\n","export function buildQueryString(\n params: Record<string, string | number | boolean | undefined | null>,\n): string {\n const searchParams = new URLSearchParams();\n\n for (const [key, value] of Object.entries(params)) {\n if (value === undefined || value === null || value === '') {\n continue;\n }\n searchParams.set(key, String(value));\n }\n\n const query = searchParams.toString();\n return query ? `?${query}` : '';\n}\n\nexport function joinUrl(baseUrl: string, path: string): string {\n const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n return `${normalizedBase}${normalizedPath}`;\n}\n\nexport function sleep(ms: number): Promise<void> {\n return new Promise((resolve) => {\n setTimeout(resolve, ms);\n });\n}\n\nexport function calculateBackoffMs(attempt: number): number {\n const base = 250;\n const jitter = Math.floor(Math.random() * 100);\n return base * 2 ** attempt + jitter;\n}\n","import {\n API_KEY_PREFIX,\n API_VERSION_PREFIX,\n DEFAULT_BASE_URL,\n DEFAULT_MAX_RETRIES,\n DEFAULT_TIMEOUT_MS,\n} from '../constants/defaults.js';\nimport {\n errorResponse,\n isApiEnvelopeError,\n isApiEnvelopeSuccess,\n parseRetryAfterHeader,\n successResponse,\n toApiError,\n} from '../core/api-response.js';\nimport { parseNdjsonStream } from '../core/jsonl.js';\nimport { SoundlinkConfigError, SoundlinkParseError } from '../errors/sdk-error.js';\nimport type { ApiResponse, JsonlStream, SoundlinkOptions } from '../types/api.js';\nimport {\n buildQueryString,\n calculateBackoffMs,\n joinUrl,\n sleep,\n} from '../utils/query.js';\n\nexport type { JsonlStream };\n\nexport interface HttpGetOptions {\n path: string;\n query?: Record<string, string | number | boolean | undefined | null>;\n}\n\nexport interface HttpJsonlOptions extends HttpGetOptions {\n accept?: string;\n}\n\nexport interface HttpMutationOptions {\n path: string;\n body?: unknown;\n query?: Record<string, string | number | boolean | undefined | null>;\n headers?: Record<string, string>;\n /** Sent as the `Idempotency-Key` header when set. */\n idempotencyKey?: string;\n}\n\nexport interface ResolvedSoundlinkClientOptions {\n apiKey: string;\n baseUrl: string;\n timeout: number;\n maxRetries: number;\n fetch: typeof fetch;\n}\n\n/**\n * Normalize constructor options and validate the API key format.\n *\n * @throws {@link SoundlinkConfigError} When the key is missing or does not start with `sk_`.\n */\nexport function resolveClientOptions(\n options: SoundlinkOptions,\n): ResolvedSoundlinkClientOptions {\n const normalized = typeof options === 'string' ? { apiKey: options } : options;\n\n const apiKey = normalized.apiKey.trim();\n if (!apiKey) {\n throw new SoundlinkConfigError('apiKey is required.');\n }\n\n if (!apiKey.startsWith(API_KEY_PREFIX)) {\n throw new SoundlinkConfigError(\n `Invalid API key format. Expected a key starting with \"${API_KEY_PREFIX}\".`,\n );\n }\n\n return {\n apiKey,\n baseUrl: normalized.baseUrl ?? DEFAULT_BASE_URL,\n timeout: normalized.timeout ?? DEFAULT_TIMEOUT_MS,\n maxRetries: normalized.maxRetries ?? DEFAULT_MAX_RETRIES,\n fetch: normalized.fetch ?? globalThis.fetch.bind(globalThis),\n };\n}\n\nexport class HttpClient {\n private readonly options: ResolvedSoundlinkClientOptions;\n\n constructor(options: SoundlinkOptions) {\n this.options = resolveClientOptions(options);\n }\n\n get resolvedOptions(): ResolvedSoundlinkClientOptions {\n return this.options;\n }\n\n async get<T>({ path, query }: HttpGetOptions): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n return this.requestJson<T>(url, {\n method: 'GET',\n headers: this.buildHeaders(),\n });\n }\n\n async post<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('POST', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async patch<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('PATCH', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async getJsonl<T>({\n path,\n query,\n accept = 'application/x-ndjson',\n }: HttpJsonlOptions): Promise<ApiResponse<JsonlStream<T>>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n let response: Response;\n try {\n response = await this.fetchWithRetry(url, {\n method: 'GET',\n headers: {\n ...this.buildHeaders(),\n Accept: accept,\n },\n });\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const contentType = response.headers.get('Content-Type') ?? '';\n if (contentType.includes('application/json')) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const rowCountHeader = response.headers.get('X-Row-Count');\n const parsedRowCount =\n rowCountHeader !== null ? Number.parseInt(rowCountHeader, 10) : undefined;\n\n const stream = parseNdjsonStream<T>(response.body);\n const data = attachRowCountMetadata(stream, parsedRowCount);\n\n return {\n data,\n error: null,\n };\n }\n\n private mutateJson<T>(\n method: 'POST' | 'PATCH',\n { path, body, query, headers, idempotencyKey }: HttpMutationOptions,\n ): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n const requestHeaders = this.buildHeaders({\n ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),\n ...(idempotencyKey !== undefined ? { 'Idempotency-Key': idempotencyKey } : {}),\n ...headers,\n });\n\n return this.requestJson<T>(url, {\n method,\n headers: requestHeaders,\n ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n });\n }\n\n private buildHeaders(extra: Record<string, string> = {}): Record<string, string> {\n return {\n 'x-api-key': this.options.apiKey,\n Accept: 'application/json',\n ...extra,\n };\n }\n\n private async requestJson<T>(\n url: string,\n init: RequestInit,\n ): Promise<ApiResponse<T>> {\n let response: Response;\n\n try {\n response = await this.fetchWithRetry(url, init);\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<T>(response, retryAfter);\n }\n\n let body: unknown;\n try {\n body = await response.json();\n } catch {\n throw new SoundlinkParseError(\n 'Failed to parse JSON response from Soundlink API.',\n );\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n if (isApiEnvelopeSuccess<T>(body)) {\n return successResponse(body.data, body.meta);\n }\n\n throw new SoundlinkParseError('Unexpected response shape from Soundlink API.');\n }\n\n private async parseErrorEnvelope<T>(\n response: Response,\n retryAfter?: number,\n ): Promise<ApiResponse<T>> {\n let body: unknown = null;\n\n try {\n body = await response.json();\n } catch {\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n private async fetchWithRetry(url: string, init: RequestInit): Promise<Response> {\n const { maxRetries, timeout, fetch } = this.options;\n let attempt = 0;\n\n let response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n\n while (\n attempt < maxRetries &&\n (response.status === 429 || response.status >= 500)\n ) {\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n const delayMs =\n retryAfter !== undefined ? retryAfter * 1000 : calculateBackoffMs(attempt);\n\n attempt += 1;\n await sleep(delayMs);\n\n response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n }\n\n return response;\n }\n}\n\nfunction toTransportError(error: unknown): SoundlinkParseError {\n if (error instanceof Error) {\n return new SoundlinkParseError(`Network request failed: ${error.message}`);\n }\n\n return new SoundlinkParseError('Network request failed.');\n}\n\nfunction attachRowCountMetadata<T>(\n stream: AsyncIterable<T>,\n rowCount?: number,\n): JsonlStream<T> {\n const jsonlStream: JsonlStream<T> = {\n async *[Symbol.asyncIterator]() {\n for await (const row of stream) {\n yield row;\n }\n },\n };\n\n if (rowCount !== undefined && !Number.isNaN(rowCount)) {\n jsonlStream.rowCount = rowCount;\n }\n\n return jsonlStream;\n}\n\n/**\n * Read `rowCount` from a {@link JsonlStream} when the API sent `X-Row-Count`.\n *\n * @returns Row count, or `undefined` if not available.\n */\nexport function getStreamRowCount<T>(stream: AsyncIterable<T>): number | undefined {\n if (typeof stream === 'object' && 'rowCount' in stream) {\n const value = (stream as JsonlStream<T>).rowCount;\n return typeof value === 'number' ? value : undefined;\n }\n\n return undefined;\n}\n","import type { HttpClient } from '../client/http-client.js';\nimport type { JsonlStream } from '../types/api.js';\nimport { collectNdjsonStream } from '../core/jsonl.js';\nimport type {\n ApiResponse,\n BreakdownExportParams,\n BreakdownListData,\n BreakdownListParams,\n BreakdownRow,\n CampaignCreateData,\n CampaignDetail,\n CampaignListData,\n CampaignListParams,\n CampaignStopData,\n CampaignTiersData,\n CreateCampaignRequest,\n DateRangeParams,\n DecreaseCampaignBudgetData,\n DecreaseCampaignBudgetRequest,\n EngagementExportParams,\n EngagementRow,\n ExportCollection,\n IdempotencyOptions,\n IncreaseCampaignBudgetData,\n IncreaseCampaignBudgetRequest,\n MetricsOverview,\n PingData,\n StrategiesCatalogData,\n UpdateCampaignTiersRequest,\n} from '../types/api.js';\n\n/**\n * JSONL export endpoint: stream rows with {@link ExportResource.collect} or iterate the stream directly.\n *\n * @example\n * ```ts\n * const { data: stream } = await soundlink.metrics.breakdown.export(campaignId);\n * for await (const row of stream!) { ... }\n *\n * const { data } = await soundlink.metrics.breakdown.export.collect(campaignId);\n * ```\n */\nexport interface ExportResource<T, P extends DateRangeParams> {\n /**\n * Stream export rows as newline-delimited JSON.\n *\n * @param campaignId - Soundlink campaign ID.\n * @param params - Optional date range (max 90 days per request).\n */\n (campaignId: string, params?: P): Promise<ApiResponse<JsonlStream<T>>>;\n\n /**\n * Download all export rows into memory.\n *\n * Prefer {@link ExportResource | the stream} for large datasets.\n */\n collect(campaignId: string, params?: P): Promise<ApiResponse<ExportCollection<T>>>;\n}\n\nfunction createExportResource<T, P extends DateRangeParams>(\n http: HttpClient,\n buildPath: (campaignId: string) => string,\n buildQuery: (\n params: P,\n ) => Record<string, string | number | boolean | undefined | null>,\n): ExportResource<T, P> {\n const exportFn = ((campaignId: string, params: P = {} as P) => {\n return http.getJsonl<T>({\n path: buildPath(campaignId),\n query: buildQuery(params),\n });\n }) as ExportResource<T, P>;\n\n exportFn.collect = async (campaignId: string, params: P = {} as P) => {\n const response = await exportFn(campaignId, params);\n\n if (response.error || !response.data) {\n return {\n data: null,\n error: response.error,\n meta: response.meta,\n };\n }\n\n const collected = await collectNdjsonStream(response.data);\n\n return {\n data: collected,\n error: null,\n meta: response.meta,\n };\n };\n\n return exportFn;\n}\n\n/** System endpoints (`GET /v1/ping`). */\nexport class PingResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Verify connectivity and API key authentication.\n *\n * Accepts any valid v1 key scope. Does not require `campaigns:read` or `metrics:read`.\n *\n * @returns `{ data: { status: 'ok' }, error: null }` on success.\n *\n * @example\n * ```ts\n * const { data, error, meta } = await soundlink.ping();\n * ```\n */\n ping(): Promise<ApiResponse<PingData>> {\n return this.http.get<PingData>({ path: '/ping' });\n }\n}\n\n/** Strategy catalog (`GET /v1/strategies`). Requires `campaigns:read`. */\nexport class StrategiesResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * List growth strategies available for wallet campaign create.\n *\n * Maps to `GET /v1/strategies`.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.strategies.list();\n * ```\n */\n list(): Promise<ApiResponse<StrategiesCatalogData>> {\n return this.http.get<StrategiesCatalogData>({ path: '/strategies' });\n }\n}\n\n/** Campaign tiers (`/v1/campaigns/{id}/tiers`). Wallet only (`generation: 3`). */\nexport class CampaignTiersResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Get current tier allocation for a wallet campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/tiers`. Wallet campaigns only (`generation: 3`).\n */\n get(campaignId: string): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.get<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n });\n }\n\n /**\n * Update tier enablement and budget shares.\n *\n * Maps to `PATCH /v1/campaigns/{campaignId}/tiers`. Requires `campaigns:write`.\n * Allocation percents across items must sum to 100.\n * Use each tier's `tierId` from {@link CampaignTiersResource.get} as `targetingTierId`.\n * Does not require an `Idempotency-Key` (unlike create / stop / budget).\n */\n update(\n campaignId: string,\n body: UpdateCampaignTiersRequest,\n ): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.patch<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n body,\n });\n }\n}\n\n/** Campaign listing, detail, and wallet write surface (`/v1/campaigns/*`). */\nexport class CampaignsResource {\n /** Tier allocation for wallet campaigns (`generation: 3`). */\n readonly tiers: CampaignTiersResource;\n\n constructor(private readonly http: HttpClient) {\n this.tiers = new CampaignTiersResource(http);\n }\n\n /**\n * List campaigns for the authenticated organization.\n *\n * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**. Requires `campaigns:read`.\n *\n * @param params - Pagination and sort options.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.list({ page: 1, pageSize: 100 });\n * ```\n */\n list(params: CampaignListParams = {}): Promise<ApiResponse<CampaignListData>> {\n return this.http.get<CampaignListData>({\n path: '/campaigns',\n query: {\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n\n /**\n * Fetch full details for a single campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}`. Requires `campaigns:read`.\n *\n * @param campaignId - Campaign identifier returned by {@link CampaignsResource.list}.\n */\n get(campaignId: string): Promise<ApiResponse<CampaignDetail>> {\n return this.http.get<CampaignDetail>({\n path: `/campaigns/${encodeURIComponent(campaignId)}`,\n });\n }\n\n /**\n * Create a wallet-funded campaign.\n *\n * Maps to `POST /v1/campaigns`. Requires `campaigns:write` and `Idempotency-Key`.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.create(\n * {\n * spotifyUrl: 'https://open.spotify.com/track/...',\n * dailyBudget: 20,\n * durationDays: 7,\n * genre: 'Pop',\n * strategyType: 'maximum_growth',\n * },\n * { idempotencyKey: 'create-mytrack-01' },\n * );\n * ```\n */\n create(\n body: CreateCampaignRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignCreateData>> {\n return this.http.post<CampaignCreateData>({\n path: '/campaigns',\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Stop a wallet campaign and refund unspent budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/stop`. Requires `campaigns:write`\n * and `Idempotency-Key`. Wallet campaigns only (`generation: 3`).\n */\n stop(\n campaignId: string,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignStopData>> {\n return this.http.post<CampaignStopData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/stop`,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Increase wallet campaign budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/increase`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n increaseBudget(\n campaignId: string,\n body: IncreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<IncreaseCampaignBudgetData>> {\n return this.http.post<IncreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/increase`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Decrease wallet campaign daily budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/decrease`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n decreaseBudget(\n campaignId: string,\n body: DecreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<DecreaseCampaignBudgetData>> {\n return this.http.post<DecreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/decrease`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Async iterator over every campaign across all pages.\n *\n * Stops silently if a page request returns an error.\n *\n * @param params - Same as {@link CampaignsResource.list} except `page` is managed automatically.\n *\n * @example\n * ```ts\n * for await (const campaign of soundlink.campaigns.listAll({ pageSize: 100 })) {\n * console.log(campaign.campaignId);\n * }\n * ```\n */\n async *listAll(\n params: Omit<CampaignListParams, 'page'> = {},\n ): AsyncGenerator<CampaignListData['items'][number], void, void> {\n let page = 1;\n let totalPages = 1;\n\n while (page <= totalPages) {\n const response = await this.list({ ...params, page });\n\n if (response.error || !response.data) {\n return;\n }\n\n for (const item of response.data.items) {\n yield item;\n }\n\n totalPages = response.data.pagination.totalPages;\n page += 1;\n }\n }\n}\n\n/**\n * Campaign metrics (`/v1/campaigns/{id}/metrics/*`). Requires `metrics:read`.\n *\n * @example\n * ```ts\n * await soundlink.metrics.overview(campaignId);\n * await soundlink.metrics.breakdown.list(campaignId);\n * await soundlink.metrics.engagement.export(campaignId);\n * ```\n */\nexport class MetricsResource {\n /** Per-day country breakdown and JSONL export. */\n readonly breakdown: BreakdownMetricsResource;\n\n /** Per-track engagement JSONL export. */\n readonly engagement: EngagementMetricsResource;\n\n constructor(private readonly http: HttpClient) {\n this.breakdown = new BreakdownMetricsResource(http);\n this.engagement = new EngagementMetricsResource(http);\n }\n\n /**\n * Campaign-level metric totals for a date range.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/overview`.\n * Aggregates across all countries — use {@link BreakdownMetricsResource.list} for daily rows.\n *\n * @param campaignId - Campaign identifier.\n * @param params - Inclusive `YYYY-MM-DD` date range. Omit for API defaults.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.metrics.overview(campaignId, {\n * startDate: '2026-01-01',\n * endDate: '2026-03-31',\n * });\n * ```\n */\n overview(\n campaignId: string,\n params: DateRangeParams = {},\n ): Promise<ApiResponse<MetricsOverview>> {\n return this.http.get<MetricsOverview>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/overview`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n },\n });\n }\n}\n\n/**\n * Country-level daily metrics (`campaign_country_daily` schema).\n *\n * Access via `soundlink.metrics.breakdown`.\n */\nexport class BreakdownMetricsResource {\n /**\n * Stream full breakdown export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown/export`.\n */\n readonly export: ExportResource<BreakdownRow, BreakdownExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<BreakdownRow, BreakdownExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n }),\n );\n }\n\n /**\n * Paginated per-day, per-country breakdown rows.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param campaignId - Campaign identifier.\n * @param params - Date range, pagination, and sort options.\n */\n list(\n campaignId: string,\n params: BreakdownListParams = {},\n ): Promise<ApiResponse<BreakdownListData>> {\n return this.http.get<BreakdownListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n}\n\n/**\n * Per-track engagement metrics (`campaign_engagement_daily` schema).\n *\n * Access via `soundlink.metrics.engagement`. Only JSONL export is shipped.\n */\nexport class EngagementMetricsResource {\n /**\n * Stream full engagement export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement/export`.\n */\n readonly export: ExportResource<EngagementRow, EngagementExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<EngagementRow, EngagementExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n engagementContext: params.engagementContext,\n }),\n );\n }\n}\n","import { HttpClient } from './http-client.js';\nimport {\n CampaignsResource,\n MetricsResource,\n PingResource,\n StrategiesResource,\n} from '../resources/index.js';\nimport type { SoundlinkOptions } from '../types/api.js';\n\n/**\n * Official Soundlink Public API client.\n *\n * All methods return `{ data, error, meta? }` and never throw on HTTP/API errors.\n * SDK configuration, parsing, and transport failures throw {@link SoundlinkSdkError}.\n *\n * @example\n * ```ts\n * import { Soundlink } from 'soundlink';\n *\n * const soundlink = new Soundlink(process.env.SOUNDLINK_API_KEY!);\n *\n * const { data, error } = await soundlink.ping();\n * if (error) {\n * console.error(error.code, error.message);\n * } else {\n * console.log(data.status);\n * }\n * ```\n *\n * @see https://docs.getsoundlink.com\n */\nexport class Soundlink {\n /** Verify connectivity and authentication. Maps to `GET /v1/ping`. */\n readonly ping: PingResource['ping'];\n\n /** Growth strategy catalog. Requires `campaigns:read` scope. */\n readonly strategies: StrategiesResource;\n\n /** List, fetch, and manage campaigns. Read needs `campaigns:read`; writes need `campaigns:write`. */\n readonly campaigns: CampaignsResource;\n\n /** Campaign metrics, breakdowns, and JSONL exports. Requires `metrics:read` scope. */\n readonly metrics: MetricsResource;\n\n /**\n * Create a Soundlink client.\n *\n * @param options - API key string (`sk_*`) or {@link SoundlinkClientOptions}.\n */\n constructor(options: SoundlinkOptions) {\n const http = new HttpClient(options);\n const pingResource = new PingResource(http);\n\n this.ping = pingResource.ping.bind(pingResource);\n this.strategies = new StrategiesResource(http);\n this.campaigns = new CampaignsResource(http);\n this.metrics = new MetricsResource(http);\n }\n}\n\nexport { HttpClient, resolveClientOptions } from './http-client.js';\n"]}
1
+ {"version":3,"sources":["../../src/constants/defaults.ts","../../src/core/api-response.ts","../../src/errors/sdk-error.ts","../../src/core/jsonl.ts","../../src/utils/query.ts","../../src/client/http-client.ts","../../src/resources/index.ts","../../src/client/soundlink.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export const DEFAULT_BASE_URL = 'https://api.getsoundlink.com';\n\nexport const DEFAULT_TIMEOUT_MS = 30_000;\n\nexport const DEFAULT_MAX_RETRIES = 2;\n\nexport const API_KEY_PREFIX = 'sk_';\n\nexport const CAMPAIGNS_MAX_PAGE_SIZE = 100;\n\nexport const METRICS_MAX_PAGE_SIZE = 500;\n\nexport const METRICS_DEFAULT_PAGE_SIZE = 50;\n\nexport const CAMPAIGNS_DEFAULT_PAGE_SIZE = 10;\n\nexport const API_VERSION_PREFIX = '/v1';\n","import type {\n ApiEnvelopeError,\n ApiEnvelopeSuccess,\n ApiMeta,\n ApiError,\n ApiResponse,\n PublicApiErrorCode,\n} from '../types/api.js';\n\nexport function isApiEnvelopeError(body: unknown): body is ApiEnvelopeError {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return (\n typeof record.error === 'object' &&\n record.error !== null &&\n typeof (record.error as Record<string, unknown>).code === 'string' &&\n typeof (record.error as Record<string, unknown>).message === 'string'\n );\n}\n\nexport function isApiEnvelopeSuccess<T>(body: unknown): body is ApiEnvelopeSuccess<T> {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return 'data' in record && typeof record.meta === 'object' && record.meta !== null;\n}\n\nexport function toApiError(\n envelope: ApiEnvelopeError,\n status: number,\n retryAfter?: number,\n): ApiError {\n const { details } = envelope.error;\n\n return {\n code: envelope.error.code as PublicApiErrorCode,\n message: envelope.error.message,\n status,\n requestId: envelope.meta.requestId,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n ...(details !== undefined ? { details } : {}),\n };\n}\n\nexport function successResponse<T>(data: T, meta: ApiMeta): ApiResponse<T> {\n return {\n data,\n error: null,\n meta,\n };\n}\n\nexport function errorResponse<T>(error: ApiError): ApiResponse<T> {\n return {\n data: null,\n error,\n ...(error.requestId ? { meta: { requestId: error.requestId } } : {}),\n };\n}\n\nexport function parseRetryAfterHeader(value: string | null): number | undefined {\n if (!value) {\n return undefined;\n }\n\n const seconds = Number.parseInt(value, 10);\n if (Number.isFinite(seconds) && seconds >= 0) {\n return seconds;\n }\n\n const dateMs = Date.parse(value);\n if (Number.isFinite(dateMs)) {\n const deltaSeconds = Math.ceil((dateMs - Date.now()) / 1000);\n return Math.max(deltaSeconds, 0);\n }\n\n return undefined;\n}\n","/**\n * Base error for unexpected SDK failures (configuration, parsing, transport).\n *\n * HTTP/API errors from Soundlink are returned as `{ data: null, error }` and do not throw.\n */\nexport class SoundlinkSdkError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkSdkError';\n Object.setPrototypeOf(this, SoundlinkSdkError.prototype);\n }\n}\n\n/** Thrown when a response body cannot be parsed or the network request fails unexpectedly. */\nexport class SoundlinkParseError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkParseError';\n Object.setPrototypeOf(this, SoundlinkParseError.prototype);\n }\n}\n\n/** Thrown when the client is misconfigured (missing or invalid API key, etc.). */\nexport class SoundlinkConfigError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkConfigError';\n Object.setPrototypeOf(this, SoundlinkConfigError.prototype);\n }\n}\n","import { SoundlinkParseError } from '../errors/sdk-error.js';\n\nexport async function* parseNdjsonStream<T>(\n body: ReadableStream<Uint8Array> | null,\n onMalformedLine?: (line: string, error: unknown) => void,\n): AsyncGenerator<T> {\n if (!body) {\n return;\n }\n\n const reader = body.getReader();\n const decoder = new TextDecoder();\n let buffer = '';\n\n try {\n for (;;) {\n const { done, value } = await reader.read();\n if (done) {\n break;\n }\n\n buffer += decoder.decode(value, { stream: true });\n const lines = buffer.split('\\n');\n buffer = lines.pop() ?? '';\n\n for (const line of lines) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n\n try {\n yield JSON.parse(trimmed) as T;\n } catch (error) {\n onMalformedLine?.(trimmed, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n }\n\n const trailing = buffer.trim();\n if (trailing) {\n try {\n yield JSON.parse(trailing) as T;\n } catch (error) {\n onMalformedLine?.(trailing, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n } finally {\n reader.releaseLock();\n }\n}\n\nexport async function collectNdjsonStream<T>(\n stream: AsyncIterable<T>,\n): Promise<{ rows: T[]; rowCount: number }> {\n const rows: T[] = [];\n for await (const row of stream) {\n rows.push(row);\n }\n return {\n rows,\n rowCount: rows.length,\n };\n}\n\nexport function parseNdjsonText<T>(text: string): T[] {\n const rows: T[] = [];\n for (const line of text.split('\\n')) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n rows.push(JSON.parse(trimmed) as T);\n }\n\n return rows;\n}\n","export function buildQueryString(\n params: Record<string, string | number | boolean | undefined | null>,\n): string {\n const searchParams = new URLSearchParams();\n\n for (const [key, value] of Object.entries(params)) {\n if (value === undefined || value === null || value === '') {\n continue;\n }\n searchParams.set(key, String(value));\n }\n\n const query = searchParams.toString();\n return query ? `?${query}` : '';\n}\n\nexport function joinUrl(baseUrl: string, path: string): string {\n const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n return `${normalizedBase}${normalizedPath}`;\n}\n\nexport function sleep(ms: number): Promise<void> {\n return new Promise((resolve) => {\n setTimeout(resolve, ms);\n });\n}\n\nexport function calculateBackoffMs(attempt: number): number {\n const base = 250;\n const jitter = Math.floor(Math.random() * 100);\n return base * 2 ** attempt + jitter;\n}\n","import {\n API_KEY_PREFIX,\n API_VERSION_PREFIX,\n DEFAULT_BASE_URL,\n DEFAULT_MAX_RETRIES,\n DEFAULT_TIMEOUT_MS,\n} from '../constants/defaults.js';\nimport {\n errorResponse,\n isApiEnvelopeError,\n isApiEnvelopeSuccess,\n parseRetryAfterHeader,\n successResponse,\n toApiError,\n} from '../core/api-response.js';\nimport { parseNdjsonStream } from '../core/jsonl.js';\nimport { SoundlinkConfigError, SoundlinkParseError } from '../errors/sdk-error.js';\nimport type { ApiResponse, JsonlStream, SoundlinkOptions } from '../types/api.js';\nimport {\n buildQueryString,\n calculateBackoffMs,\n joinUrl,\n sleep,\n} from '../utils/query.js';\n\nexport type { JsonlStream };\n\nexport interface HttpGetOptions {\n path: string;\n query?: Record<string, string | number | boolean | undefined | null>;\n}\n\nexport interface HttpJsonlOptions extends HttpGetOptions {\n accept?: string;\n}\n\nexport interface HttpMutationOptions {\n path: string;\n body?: unknown;\n query?: Record<string, string | number | boolean | undefined | null>;\n headers?: Record<string, string>;\n /** Sent as the `Idempotency-Key` header when set. */\n idempotencyKey?: string;\n}\n\nexport interface ResolvedSoundlinkClientOptions {\n apiKey: string;\n baseUrl: string;\n timeout: number;\n maxRetries: number;\n fetch: typeof fetch;\n}\n\n/**\n * Normalize constructor options and validate the API key format.\n *\n * @throws {@link SoundlinkConfigError} When the key is missing or does not start with `sk_`.\n */\nexport function resolveClientOptions(\n options: SoundlinkOptions,\n): ResolvedSoundlinkClientOptions {\n const normalized = typeof options === 'string' ? { apiKey: options } : options;\n\n const apiKey = normalized.apiKey.trim();\n if (!apiKey) {\n throw new SoundlinkConfigError('apiKey is required.');\n }\n\n if (!apiKey.startsWith(API_KEY_PREFIX)) {\n throw new SoundlinkConfigError(\n `Invalid API key format. Expected a key starting with \"${API_KEY_PREFIX}\".`,\n );\n }\n\n return {\n apiKey,\n baseUrl: normalized.baseUrl ?? DEFAULT_BASE_URL,\n timeout: normalized.timeout ?? DEFAULT_TIMEOUT_MS,\n maxRetries: normalized.maxRetries ?? DEFAULT_MAX_RETRIES,\n fetch: normalized.fetch ?? globalThis.fetch.bind(globalThis),\n };\n}\n\nexport class HttpClient {\n private readonly options: ResolvedSoundlinkClientOptions;\n\n constructor(options: SoundlinkOptions) {\n this.options = resolveClientOptions(options);\n }\n\n get resolvedOptions(): ResolvedSoundlinkClientOptions {\n return this.options;\n }\n\n async get<T>({ path, query }: HttpGetOptions): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n return this.requestJson<T>(url, {\n method: 'GET',\n headers: this.buildHeaders(),\n });\n }\n\n async post<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('POST', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async patch<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('PATCH', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async getJsonl<T>({\n path,\n query,\n accept = 'application/x-ndjson',\n }: HttpJsonlOptions): Promise<ApiResponse<JsonlStream<T>>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n let response: Response;\n try {\n response = await this.fetchWithRetry(url, {\n method: 'GET',\n headers: {\n ...this.buildHeaders(),\n Accept: accept,\n },\n });\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const contentType = response.headers.get('Content-Type') ?? '';\n if (contentType.includes('application/json')) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const rowCountHeader = response.headers.get('X-Row-Count');\n const parsedRowCount =\n rowCountHeader !== null ? Number.parseInt(rowCountHeader, 10) : undefined;\n\n const stream = parseNdjsonStream<T>(response.body);\n const data = attachRowCountMetadata(stream, parsedRowCount);\n\n return {\n data,\n error: null,\n };\n }\n\n private mutateJson<T>(\n method: 'POST' | 'PATCH',\n { path, body, query, headers, idempotencyKey }: HttpMutationOptions,\n ): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n const requestHeaders = this.buildHeaders({\n ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),\n ...(idempotencyKey !== undefined ? { 'Idempotency-Key': idempotencyKey } : {}),\n ...headers,\n });\n\n return this.requestJson<T>(url, {\n method,\n headers: requestHeaders,\n ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n });\n }\n\n private buildHeaders(extra: Record<string, string> = {}): Record<string, string> {\n return {\n Authorization: `Bearer ${this.options.apiKey}`,\n Accept: 'application/json',\n ...extra,\n };\n }\n\n private async requestJson<T>(\n url: string,\n init: RequestInit,\n ): Promise<ApiResponse<T>> {\n let response: Response;\n\n try {\n response = await this.fetchWithRetry(url, init);\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<T>(response, retryAfter);\n }\n\n let body: unknown;\n try {\n body = await response.json();\n } catch {\n throw new SoundlinkParseError(\n 'Failed to parse JSON response from Soundlink API.',\n );\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n if (isApiEnvelopeSuccess<T>(body)) {\n return successResponse(body.data, body.meta);\n }\n\n throw new SoundlinkParseError('Unexpected response shape from Soundlink API.');\n }\n\n private async parseErrorEnvelope<T>(\n response: Response,\n retryAfter?: number,\n ): Promise<ApiResponse<T>> {\n let body: unknown = null;\n\n try {\n body = await response.json();\n } catch {\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n private async fetchWithRetry(url: string, init: RequestInit): Promise<Response> {\n const { maxRetries, timeout, fetch } = this.options;\n let attempt = 0;\n\n let response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n\n while (\n attempt < maxRetries &&\n (response.status === 429 || response.status >= 500)\n ) {\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n const delayMs =\n retryAfter !== undefined ? retryAfter * 1000 : calculateBackoffMs(attempt);\n\n attempt += 1;\n await sleep(delayMs);\n\n response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n }\n\n return response;\n }\n}\n\nfunction toTransportError(error: unknown): SoundlinkParseError {\n if (error instanceof Error) {\n return new SoundlinkParseError(`Network request failed: ${error.message}`);\n }\n\n return new SoundlinkParseError('Network request failed.');\n}\n\nfunction attachRowCountMetadata<T>(\n stream: AsyncIterable<T>,\n rowCount?: number,\n): JsonlStream<T> {\n const jsonlStream: JsonlStream<T> = {\n async *[Symbol.asyncIterator]() {\n for await (const row of stream) {\n yield row;\n }\n },\n };\n\n if (rowCount !== undefined && !Number.isNaN(rowCount)) {\n jsonlStream.rowCount = rowCount;\n }\n\n return jsonlStream;\n}\n\n/**\n * Read `rowCount` from a {@link JsonlStream} when the API sent `X-Row-Count`.\n *\n * @returns Row count, or `undefined` if not available.\n */\nexport function getStreamRowCount<T>(stream: AsyncIterable<T>): number | undefined {\n if (typeof stream === 'object' && 'rowCount' in stream) {\n const value = (stream as JsonlStream<T>).rowCount;\n return typeof value === 'number' ? value : undefined;\n }\n\n return undefined;\n}\n","import type { HttpClient } from '../client/http-client.js';\nimport type { JsonlStream } from '../types/api.js';\nimport { collectNdjsonStream } from '../core/jsonl.js';\nimport type {\n ApiResponse,\n BreakdownExportParams,\n BreakdownListData,\n BreakdownListParams,\n BreakdownRow,\n CampaignCreateData,\n CampaignDetail,\n CampaignListData,\n CampaignListParams,\n CampaignStopData,\n CampaignTiersData,\n CreateCampaignRequest,\n DateRangeParams,\n DecreaseCampaignBudgetData,\n DecreaseCampaignBudgetRequest,\n EngagementExportParams,\n EngagementRow,\n ExportCollection,\n IdempotencyOptions,\n IncreaseCampaignBudgetData,\n IncreaseCampaignBudgetRequest,\n MetricsOverview,\n PingData,\n StrategiesCatalogData,\n UpdateCampaignTiersRequest,\n} from '../types/api.js';\n\n/**\n * JSONL export endpoint: stream rows with {@link ExportResource.collect} or iterate the stream directly.\n *\n * @example\n * ```ts\n * const { data: stream } = await soundlink.metrics.breakdown.export(campaignId);\n * for await (const row of stream!) { ... }\n *\n * const { data } = await soundlink.metrics.breakdown.export.collect(campaignId);\n * ```\n */\nexport interface ExportResource<T, P extends DateRangeParams> {\n /**\n * Stream export rows as newline-delimited JSON.\n *\n * @param campaignId - Soundlink campaign ID.\n * @param params - Optional date range (max 90 days per request).\n */\n (campaignId: string, params?: P): Promise<ApiResponse<JsonlStream<T>>>;\n\n /**\n * Download all export rows into memory.\n *\n * Prefer {@link ExportResource | the stream} for large datasets.\n */\n collect(campaignId: string, params?: P): Promise<ApiResponse<ExportCollection<T>>>;\n}\n\nfunction createExportResource<T, P extends DateRangeParams>(\n http: HttpClient,\n buildPath: (campaignId: string) => string,\n buildQuery: (\n params: P,\n ) => Record<string, string | number | boolean | undefined | null>,\n): ExportResource<T, P> {\n const exportFn = ((campaignId: string, params: P = {} as P) => {\n return http.getJsonl<T>({\n path: buildPath(campaignId),\n query: buildQuery(params),\n });\n }) as ExportResource<T, P>;\n\n exportFn.collect = async (campaignId: string, params: P = {} as P) => {\n const response = await exportFn(campaignId, params);\n\n if (response.error || !response.data) {\n return {\n data: null,\n error: response.error,\n meta: response.meta,\n };\n }\n\n const collected = await collectNdjsonStream(response.data);\n\n return {\n data: collected,\n error: null,\n meta: response.meta,\n };\n };\n\n return exportFn;\n}\n\n/** System endpoints (`GET /v1/ping`). */\nexport class PingResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Verify connectivity and API key authentication.\n *\n * Accepts any valid v1 key scope. Does not require `campaigns:read` or `metrics:read`.\n *\n * @returns `{ data: { status: 'ok' }, error: null }` on success.\n *\n * @example\n * ```ts\n * const { data, error, meta } = await soundlink.ping();\n * ```\n */\n ping(): Promise<ApiResponse<PingData>> {\n return this.http.get<PingData>({ path: '/ping' });\n }\n}\n\n/** Strategy catalog (`GET /v1/strategies`). Requires `campaigns:read`. */\nexport class StrategiesResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * List growth strategies available for wallet campaign create.\n *\n * Maps to `GET /v1/strategies`.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.strategies.list();\n * ```\n */\n list(): Promise<ApiResponse<StrategiesCatalogData>> {\n return this.http.get<StrategiesCatalogData>({ path: '/strategies' });\n }\n}\n\n/** Campaign tiers (`/v1/campaigns/{id}/tiers`). Wallet only (`generation: 3`). */\nexport class CampaignTiersResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Get current tier allocation for a wallet campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/tiers`. Wallet campaigns only (`generation: 3`).\n */\n get(campaignId: string): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.get<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n });\n }\n\n /**\n * Update tier enablement and budget shares.\n *\n * Maps to `PATCH /v1/campaigns/{campaignId}/tiers`. Requires `campaigns:write`.\n * Allocation percents across items must sum to 100.\n * Use each tier's `tierId` from {@link CampaignTiersResource.get} as `targetingTierId`.\n * Does not require an `Idempotency-Key` (unlike create / stop / budget).\n */\n update(\n campaignId: string,\n body: UpdateCampaignTiersRequest,\n ): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.patch<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n body,\n });\n }\n}\n\n/** Campaign listing, detail, and wallet write surface (`/v1/campaigns/*`). */\nexport class CampaignsResource {\n /** Tier allocation for wallet campaigns (`generation: 3`). */\n readonly tiers: CampaignTiersResource;\n\n constructor(private readonly http: HttpClient) {\n this.tiers = new CampaignTiersResource(http);\n }\n\n /**\n * List campaigns for the authenticated organization.\n *\n * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**. Requires `campaigns:read`.\n *\n * @param params - Pagination and sort options.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.list({ page: 1, pageSize: 100 });\n * ```\n */\n list(params: CampaignListParams = {}): Promise<ApiResponse<CampaignListData>> {\n return this.http.get<CampaignListData>({\n path: '/campaigns',\n query: {\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n\n /**\n * Fetch full details for a single campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}`. Requires `campaigns:read`.\n *\n * @param campaignId - Campaign identifier returned by {@link CampaignsResource.list}.\n */\n get(campaignId: string): Promise<ApiResponse<CampaignDetail>> {\n return this.http.get<CampaignDetail>({\n path: `/campaigns/${encodeURIComponent(campaignId)}`,\n });\n }\n\n /**\n * Create a wallet-funded campaign.\n *\n * Maps to `POST /v1/campaigns`. Requires `campaigns:write` and `Idempotency-Key`.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.create(\n * {\n * spotifyUrl: 'https://open.spotify.com/track/...',\n * dailyBudget: 20,\n * durationDays: 7,\n * genre: 'Pop',\n * strategyType: 'maximum_growth',\n * },\n * { idempotencyKey: 'create-mytrack-01' },\n * );\n * ```\n */\n create(\n body: CreateCampaignRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignCreateData>> {\n return this.http.post<CampaignCreateData>({\n path: '/campaigns',\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Stop a wallet campaign and refund unspent budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/stop`. Requires `campaigns:write`\n * and `Idempotency-Key`. Wallet campaigns only (`generation: 3`).\n */\n stop(\n campaignId: string,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignStopData>> {\n return this.http.post<CampaignStopData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/stop`,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Increase wallet campaign budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/increase`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n increaseBudget(\n campaignId: string,\n body: IncreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<IncreaseCampaignBudgetData>> {\n return this.http.post<IncreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/increase`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Decrease wallet campaign daily budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/decrease`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n decreaseBudget(\n campaignId: string,\n body: DecreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<DecreaseCampaignBudgetData>> {\n return this.http.post<DecreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/decrease`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Async iterator over every campaign across all pages.\n *\n * Stops silently if a page request returns an error.\n *\n * @param params - Same as {@link CampaignsResource.list} except `page` is managed automatically.\n *\n * @example\n * ```ts\n * for await (const campaign of soundlink.campaigns.listAll({ pageSize: 100 })) {\n * console.log(campaign.campaignId);\n * }\n * ```\n */\n async *listAll(\n params: Omit<CampaignListParams, 'page'> = {},\n ): AsyncGenerator<CampaignListData['items'][number], void, void> {\n let page = 1;\n let totalPages = 1;\n\n while (page <= totalPages) {\n const response = await this.list({ ...params, page });\n\n if (response.error || !response.data) {\n return;\n }\n\n for (const item of response.data.items) {\n yield item;\n }\n\n totalPages = response.data.pagination.totalPages;\n page += 1;\n }\n }\n}\n\n/**\n * Campaign metrics (`/v1/campaigns/{id}/metrics/*`). Requires `metrics:read`.\n *\n * @example\n * ```ts\n * await soundlink.metrics.overview(campaignId);\n * await soundlink.metrics.breakdown.list(campaignId);\n * await soundlink.metrics.engagement.export(campaignId);\n * ```\n */\nexport class MetricsResource {\n /** Per-day country breakdown and JSONL export. */\n readonly breakdown: BreakdownMetricsResource;\n\n /** Per-track engagement JSONL export. */\n readonly engagement: EngagementMetricsResource;\n\n constructor(private readonly http: HttpClient) {\n this.breakdown = new BreakdownMetricsResource(http);\n this.engagement = new EngagementMetricsResource(http);\n }\n\n /**\n * Campaign-level metric totals for a date range.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/overview`.\n * Aggregates across all countries — use {@link BreakdownMetricsResource.list} for daily rows.\n *\n * @param campaignId - Campaign identifier.\n * @param params - Inclusive `YYYY-MM-DD` date range. Omit for API defaults.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.metrics.overview(campaignId, {\n * startDate: '2026-01-01',\n * endDate: '2026-03-31',\n * });\n * ```\n */\n overview(\n campaignId: string,\n params: DateRangeParams = {},\n ): Promise<ApiResponse<MetricsOverview>> {\n return this.http.get<MetricsOverview>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/overview`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n },\n });\n }\n}\n\n/**\n * Country-level daily metrics (`campaign_country_daily` schema).\n *\n * Access via `soundlink.metrics.breakdown`.\n */\nexport class BreakdownMetricsResource {\n /**\n * Stream full breakdown export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown/export`.\n */\n readonly export: ExportResource<BreakdownRow, BreakdownExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<BreakdownRow, BreakdownExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n }),\n );\n }\n\n /**\n * Paginated per-day, per-country breakdown rows.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param campaignId - Campaign identifier.\n * @param params - Date range, pagination, and sort options.\n */\n list(\n campaignId: string,\n params: BreakdownListParams = {},\n ): Promise<ApiResponse<BreakdownListData>> {\n return this.http.get<BreakdownListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n}\n\n/**\n * Per-track engagement metrics (`campaign_engagement_daily` schema).\n *\n * Access via `soundlink.metrics.engagement`. Only JSONL export is shipped.\n */\nexport class EngagementMetricsResource {\n /**\n * Stream full engagement export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement/export`.\n */\n readonly export: ExportResource<EngagementRow, EngagementExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<EngagementRow, EngagementExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n engagementContext: params.engagementContext,\n }),\n );\n }\n}\n","import { HttpClient } from './http-client.js';\nimport {\n CampaignsResource,\n MetricsResource,\n PingResource,\n StrategiesResource,\n} from '../resources/index.js';\nimport type { SoundlinkOptions } from '../types/api.js';\n\n/**\n * Official Soundlink Public API client.\n *\n * All methods return `{ data, error, meta? }` and never throw on HTTP/API errors.\n * SDK configuration, parsing, and transport failures throw {@link SoundlinkSdkError}.\n *\n * @example\n * ```ts\n * import { Soundlink } from 'soundlink';\n *\n * const soundlink = new Soundlink(process.env.SOUNDLINK_API_KEY!);\n *\n * const { data, error } = await soundlink.ping();\n * if (error) {\n * console.error(error.code, error.message);\n * } else {\n * console.log(data.status);\n * }\n * ```\n *\n * @see https://docs.getsoundlink.com\n */\nexport class Soundlink {\n /** Verify connectivity and authentication. Maps to `GET /v1/ping`. */\n readonly ping: PingResource['ping'];\n\n /** Growth strategy catalog. Requires `campaigns:read` scope. */\n readonly strategies: StrategiesResource;\n\n /** List, fetch, and manage campaigns. Read needs `campaigns:read`; writes need `campaigns:write`. */\n readonly campaigns: CampaignsResource;\n\n /** Campaign metrics, breakdowns, and JSONL exports. Requires `metrics:read` scope. */\n readonly metrics: MetricsResource;\n\n /**\n * Create a Soundlink client.\n *\n * @param options - API key string (`sk_*`) or {@link SoundlinkClientOptions}.\n */\n constructor(options: SoundlinkOptions) {\n const http = new HttpClient(options);\n const pingResource = new PingResource(http);\n\n this.ping = pingResource.ping.bind(pingResource);\n this.strategies = new StrategiesResource(http);\n this.campaigns = new CampaignsResource(http);\n this.metrics = new MetricsResource(http);\n }\n}\n\nexport { HttpClient, resolveClientOptions } from './http-client.js';\n"]}
@@ -7,10 +7,19 @@ info:
7
7
 
8
8
  **Base URL:** `https://api.getsoundlink.com`
9
9
 
10
- **Authentication:** `x-api-key` header using a `sk_*` API key created in the Soundlink app (Settings → Developer → API keys).
11
- ```
12
- x-api-key: sk_abc123_<token>
13
- ```
10
+ **Authentication:** send a `sk_*` API key created in the Soundlink app (Settings → Developer → API keys) using one of:
11
+
12
+ 1. **`Authorization: Bearer` (recommended)**:
13
+ ```
14
+ Authorization: Bearer sk_abc123_<token>
15
+ ```
16
+
17
+ 2. **`x-api-key` header (deprecated, retiring 2026-08-17)** — migrate to Bearer above before then:
18
+ ```
19
+ x-api-key: sk_abc123_<token>
20
+ ```
21
+
22
+ Sending both headers returns `401 mixed_credentials`.
14
23
 
15
24
  All responses are wrapped in a standard envelope:
16
25
  ```json
@@ -25,6 +34,7 @@ servers:
25
34
 
26
35
  security:
27
36
  - apiKeyAuth: []
37
+ - apiKeyBearerAuth: []
28
38
 
29
39
  tags:
30
40
  - name: System
@@ -48,6 +58,7 @@ paths:
48
58
  tags: [System]
49
59
  security:
50
60
  - apiKeyAuth: []
61
+ - apiKeyBearerAuth: []
51
62
  responses:
52
63
  '200':
53
64
  description: Authenticated and reachable
@@ -88,6 +99,7 @@ paths:
88
99
  tags: [Campaigns]
89
100
  security:
90
101
  - apiKeyAuth: []
102
+ - apiKeyBearerAuth: []
91
103
  x-required-scope: campaigns:read
92
104
  responses:
93
105
  '200':
@@ -124,6 +136,7 @@ paths:
124
136
  tags: [Campaigns]
125
137
  security:
126
138
  - apiKeyAuth: []
139
+ - apiKeyBearerAuth: []
127
140
  parameters:
128
141
  - $ref: '#/components/parameters/page'
129
142
  - $ref: '#/components/parameters/pageSize100'
@@ -180,6 +193,7 @@ paths:
180
193
  tags: [Campaigns]
181
194
  security:
182
195
  - apiKeyAuth: []
196
+ - apiKeyBearerAuth: []
183
197
  x-required-scope: campaigns:write
184
198
  parameters:
185
199
  - $ref: '#/components/parameters/idempotencyKey'
@@ -273,6 +287,7 @@ paths:
273
287
  tags: [Campaigns]
274
288
  security:
275
289
  - apiKeyAuth: []
290
+ - apiKeyBearerAuth: []
276
291
  parameters:
277
292
  - $ref: '#/components/parameters/campaignId'
278
293
  responses:
@@ -320,6 +335,7 @@ paths:
320
335
  x-required-scope: campaigns:write
321
336
  security:
322
337
  - apiKeyAuth: []
338
+ - apiKeyBearerAuth: []
323
339
  parameters:
324
340
  - $ref: '#/components/parameters/campaignId'
325
341
  - $ref: '#/components/parameters/idempotencyKey'
@@ -365,6 +381,7 @@ paths:
365
381
  x-required-scope: campaigns:write
366
382
  security:
367
383
  - apiKeyAuth: []
384
+ - apiKeyBearerAuth: []
368
385
  parameters:
369
386
  - $ref: '#/components/parameters/campaignId'
370
387
  - $ref: '#/components/parameters/idempotencyKey'
@@ -437,6 +454,7 @@ paths:
437
454
  x-required-scope: campaigns:write
438
455
  security:
439
456
  - apiKeyAuth: []
457
+ - apiKeyBearerAuth: []
440
458
  parameters:
441
459
  - $ref: '#/components/parameters/campaignId'
442
460
  - $ref: '#/components/parameters/idempotencyKey'
@@ -487,6 +505,7 @@ paths:
487
505
  x-required-scope: campaigns:read
488
506
  security:
489
507
  - apiKeyAuth: []
508
+ - apiKeyBearerAuth: []
490
509
  parameters:
491
510
  - $ref: '#/components/parameters/campaignId'
492
511
  responses:
@@ -537,6 +556,7 @@ paths:
537
556
  x-required-scope: campaigns:write
538
557
  security:
539
558
  - apiKeyAuth: []
559
+ - apiKeyBearerAuth: []
540
560
  parameters:
541
561
  - $ref: '#/components/parameters/campaignId'
542
562
  requestBody:
@@ -601,6 +621,7 @@ paths:
601
621
  tags: [Metrics]
602
622
  security:
603
623
  - apiKeyAuth: []
624
+ - apiKeyBearerAuth: []
604
625
  parameters:
605
626
  - $ref: '#/components/parameters/campaignId'
606
627
  - $ref: '#/components/parameters/startDate'
@@ -659,6 +680,7 @@ paths:
659
680
  tags: [Metrics]
660
681
  security:
661
682
  - apiKeyAuth: []
683
+ - apiKeyBearerAuth: []
662
684
  parameters:
663
685
  - $ref: '#/components/parameters/campaignId'
664
686
  - $ref: '#/components/parameters/startDate'
@@ -761,6 +783,7 @@ paths:
761
783
  tags: [Metrics]
762
784
  security:
763
785
  - apiKeyAuth: []
786
+ - apiKeyBearerAuth: []
764
787
  parameters:
765
788
  - $ref: '#/components/parameters/campaignId'
766
789
  - $ref: '#/components/parameters/startDate'
@@ -830,6 +853,7 @@ paths:
830
853
  tags: [Metrics]
831
854
  security:
832
855
  - apiKeyAuth: []
856
+ - apiKeyBearerAuth: []
833
857
  parameters:
834
858
  - $ref: '#/components/parameters/campaignId'
835
859
  - $ref: '#/components/parameters/startDate'
@@ -862,7 +886,7 @@ paths:
862
886
  $ref: '#/components/schemas/EngagementRow'
863
887
  example: |
864
888
  {"provider":"soundlink","account_id":"a7ac3173-2f71-4e79-921f-d15d7112cc9a","schema_version":"1.0","report_date":"2026-04-08","report_date_timezone":"UTC","exported_at":"2026-05-22T10:12:11Z","campaign_id":"8ccd7b88-2591-4b94-848f-f142f5c6bba1","campaign_name":"9 To 5","campaign_target_type":"track","campaign_target_isrc":"DEXW62500272","campaign_target_spotify_track_id":"2RkZ5WPkKyBf0u8vN3dNgb","campaign_target_playlist_id":null,"status":"ended","engagement_context":"catalog","country_code":"US","engaged_track_isrc":"DEXW62500001","engaged_spotify_track_id":"4cOdK2wGLETKBW3PvgPWqT","engaged_track_name":"Till The Sunrise","playlist_position":null,"new_listeners":42,"returning_listeners":18,"listeners":60,"new_listener_streams":58,"returning_listener_streams":31,"streams":89,"spl":1.48}
865
- {"provider":"soundlink","account_id":"a7ac3173-2f71-4e79-921f-d15d7112cc9a","schema_version":"1.0","report_date":"2026-04-08","report_date_timezone":"UTC","exported_at":"2026-05-22T10:12:11Z","campaign_id":"8ccd7b88-2591-4b94-848f-f142f5c6bba1","campaign_name":"9 To 5","campaign_target_type":"track","campaign_target_isrc":"DEXW62500272","campaign_target_spotify_track_id":"2RkZ5WPkKyBf0u8vN3dNgb","campaign_target_playlist_id":null,"status":"ended","engagement_context":"catalog","country_code":"DE","engaged_track_isrc":"DEXW62500001","engaged_spotify_track_id":"4cOdK2wGLETKBW3PvgPWqT","engaged_track_name":"Till The Sunrise","playlist_position":14,"new_listeners":19,"returning_listeners":7,"listeners":26,"new_listener_streams":24,"returning_listener_streams":11,"streams":35,"spl":1.35}
889
+ {"provider":"soundlink","account_id":"a7ac3173-2f71-4e79-921f-d15d7112dd11","schema_version":"1.0","report_date":"2026-04-08","report_date_timezone":"UTC","exported_at":"2026-05-22T10:12:11Z","campaign_id":"f1e28d31-c358-4284-9bef-00a2334625fd","campaign_name":"Sleep Playlist","campaign_target_type":"playlist","campaign_target_isrc":null,"campaign_target_spotify_track_id":null,"campaign_target_playlist_id":"37i9dQZF1DXcBWIGoYBM5M","status":"active","engagement_context":"playlist","country_code":"DE","engaged_track_isrc":"DEXW62500001","engaged_spotify_track_id":"4cOdK2wGLETKBW3PvgPWqT","engaged_track_name":"Till The Sunrise","playlist_position":14,"new_listeners":19,"returning_listeners":7,"listeners":26,"new_listener_streams":24,"returning_listener_streams":11,"streams":35,"spl":1.35}
866
890
  '400': { $ref: '#/components/responses/BadRequest' }
867
891
  '401': { $ref: '#/components/responses/Unauthorized' }
868
892
  '403': { $ref: '#/components/responses/Forbidden' }
@@ -888,6 +912,7 @@ paths:
888
912
  tags: [Videos]
889
913
  security:
890
914
  - apiKeyAuth: []
915
+ - apiKeyBearerAuth: []
891
916
  x-required-scope: videos:write
892
917
  requestBody:
893
918
  required: true
@@ -926,6 +951,7 @@ paths:
926
951
  tags: [Videos]
927
952
  security:
928
953
  - apiKeyAuth: []
954
+ - apiKeyBearerAuth: []
929
955
  x-required-scope: videos:write
930
956
  parameters:
931
957
  - name: sessionId
@@ -958,6 +984,17 @@ components:
958
984
  Pass your Soundlink `sk_*` API key in the `x-api-key` header.
959
985
  Keys can carry explicit scopes (for example `campaigns:read`, `metrics:read`, `videos:write`) enforced by the backend.
960
986
 
987
+ **Deprecated, retiring 2026-08-17** — migrate to `Authorization: Bearer sk_...` (see `apiKeyBearerAuth`) before then.
988
+
989
+ apiKeyBearerAuth:
990
+ type: http
991
+ scheme: bearer
992
+ description: |
993
+ Pass your Soundlink `sk_*` API key as a Bearer token:
994
+ `Authorization: Bearer sk_<prefix>_<token>`. Verified with the exact
995
+ same key as `apiKeyAuth` — just the recommended header for the same
996
+ `sk_*` credential. Do not combine with `x-api-key`.
997
+
961
998
  parameters:
962
999
  campaignId:
963
1000
  name: campaignId
@@ -2014,9 +2051,11 @@ components:
2014
2051
  nullable: true
2015
2052
  minimum: 1
2016
2053
  description: |
2017
- 1-based slot index of the engaged track in the promoted playlist on `report_date`.
2018
- Populated for `engagement_context = playlist` when playlist snapshot data is available.
2019
- `null` for catalog rows and until position data is delivered (reserved for future delivery in v1.0).
2054
+ 1-based slot of the engaged track on the promoted playlist for `report_date` (1 = top).
2055
+ Populated only when `engagement_context = playlist` and that day's playlist crawl listed the track.
2056
+ `null` for catalog rows; before the day's crawl completes (current UTC day is often null until later morning UTC);
2057
+ when the track was not listed or could not be matched to that day's crawl; or while historical backfill is still catching up.
2058
+ Field is beta until historical backfill finishes. Treat `null` as unavailable — not an error.
2020
2059
  new_listeners:
2021
2060
  type: integer
2022
2061
  minimum: 0
@@ -2180,7 +2219,7 @@ components:
2180
2219
  value:
2181
2220
  error:
2182
2221
  code: invalid_api_key
2183
- message: 'Missing or malformed x-api-key header.'
2222
+ message: 'Missing or malformed API key. Expected: sk_<prefix>_<token> (sent via x-api-key or Authorization: Bearer).'
2184
2223
  meta:
2185
2224
  requestId: 550e8400-e29b-41d4-a716-446655440000
2186
2225
  api_key_revoked:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "soundlink",
3
- "version": "1.2.0",
3
+ "version": "2.0.0",
4
4
  "description": "Official TypeScript SDK for the Soundlink Public API",
5
5
  "license": "MIT",
6
6
  "type": "module",