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 +6 -0
- package/README.md +3 -3
- package/dist/cjs/index.cjs +1 -1
- package/dist/cjs/index.cjs.map +1 -1
- package/dist/esm/index.d.ts +1 -1
- package/dist/esm/index.js +1 -1
- package/dist/esm/index.js.map +1 -1
- package/openapi/soundlink-public-api-v1.yaml +48 -9
- package/package.json +1 -1
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:** `
|
|
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
|
|
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
|
|
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
|
|
package/dist/cjs/index.cjs
CHANGED
package/dist/cjs/index.cjs.map
CHANGED
|
@@ -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"]}
|
package/dist/esm/index.d.ts
CHANGED
|
@@ -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
|
|
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
package/dist/esm/index.js.map
CHANGED
|
@@ -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.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:**
|
|
11
|
-
|
|
12
|
-
|
|
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-
|
|
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
|
|
2018
|
-
Populated
|
|
2019
|
-
`null` for catalog rows
|
|
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
|
|
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:
|