soundlink 1.1.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # soundlink
2
2
 
3
+ ## 1.1.1
4
+
5
+ ### Patch Changes
6
+
7
+ - [`57ed16a`](https://github.com/Fan-ID/lib-sdk/commit/57ed16a090e91297845608935cbec8c074d6e15c) Thanks [@jotanarciso](https://github.com/jotanarciso)! - Add TSDoc comments on public methods and types for IDE hover hints and IntelliSense.
8
+
3
9
  ## 1.1.0
4
10
 
5
11
  ### Minor Changes
@@ -377,6 +377,18 @@ var PingResource = class {
377
377
  this.http = http;
378
378
  }
379
379
  http;
380
+ /**
381
+ * Verify connectivity and API key authentication.
382
+ *
383
+ * Accepts any valid v1 key scope. Does not require `campaigns:read` or `metrics:read`.
384
+ *
385
+ * @returns `{ data: { status: 'ok' }, error: null }` on success.
386
+ *
387
+ * @example
388
+ * ```ts
389
+ * const { data, error, meta } = await soundlink.ping();
390
+ * ```
391
+ */
380
392
  ping() {
381
393
  return this.http.get({ path: "/ping" });
382
394
  }
@@ -386,6 +398,18 @@ var CampaignsResource = class {
386
398
  this.http = http;
387
399
  }
388
400
  http;
401
+ /**
402
+ * List campaigns for the authenticated organization.
403
+ *
404
+ * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**.
405
+ *
406
+ * @param params - Pagination and sort options.
407
+ *
408
+ * @example
409
+ * ```ts
410
+ * const { data, error } = await soundlink.campaigns.list({ page: 1, pageSize: 100 });
411
+ * ```
412
+ */
389
413
  list(params = {}) {
390
414
  return this.http.get({
391
415
  path: "/campaigns",
@@ -397,11 +421,32 @@ var CampaignsResource = class {
397
421
  }
398
422
  });
399
423
  }
424
+ /**
425
+ * Fetch full details for a single campaign.
426
+ *
427
+ * Maps to `GET /v1/campaigns/{campaignId}`.
428
+ *
429
+ * @param campaignId - Campaign identifier returned by {@link CampaignsResource.list}.
430
+ */
400
431
  get(campaignId) {
401
432
  return this.http.get({
402
433
  path: `/campaigns/${encodeURIComponent(campaignId)}`
403
434
  });
404
435
  }
436
+ /**
437
+ * Async iterator over every campaign across all pages.
438
+ *
439
+ * Stops silently if a page request returns an error.
440
+ *
441
+ * @param params - Same as {@link CampaignsResource.list} except `page` is managed automatically.
442
+ *
443
+ * @example
444
+ * ```ts
445
+ * for await (const campaign of soundlink.campaigns.listAll({ pageSize: 100 })) {
446
+ * console.log(campaign.campaignId);
447
+ * }
448
+ * ```
449
+ */
405
450
  async *listAll(params = {}) {
406
451
  let page = 1;
407
452
  let totalPages = 1;
@@ -425,8 +470,27 @@ var MetricsResource = class {
425
470
  this.engagement = new EngagementMetricsResource(http);
426
471
  }
427
472
  http;
473
+ /** Per-day country breakdown and JSONL export. */
428
474
  breakdown;
475
+ /** Per-track engagement breakdown and JSONL export. */
429
476
  engagement;
477
+ /**
478
+ * Campaign-level metric totals for a date range.
479
+ *
480
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/overview`.
481
+ * Aggregates across all countries — use {@link BreakdownMetricsResource.list} for daily rows.
482
+ *
483
+ * @param campaignId - Campaign identifier.
484
+ * @param params - Inclusive `YYYY-MM-DD` date range. Omit for API defaults.
485
+ *
486
+ * @example
487
+ * ```ts
488
+ * const { data } = await soundlink.metrics.overview(campaignId, {
489
+ * startDate: '2026-01-01',
490
+ * endDate: '2026-03-31',
491
+ * });
492
+ * ```
493
+ */
430
494
  overview(campaignId, params = {}) {
431
495
  return this.http.get({
432
496
  path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/overview`,
@@ -450,7 +514,21 @@ var BreakdownMetricsResource = class {
450
514
  );
451
515
  }
452
516
  http;
517
+ /**
518
+ * Stream full breakdown export as JSONL.
519
+ *
520
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown/export`.
521
+ */
453
522
  export;
523
+ /**
524
+ * Paginated per-day, per-country breakdown rows.
525
+ *
526
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown`.
527
+ * Max `pageSize` is **500** (default 50).
528
+ *
529
+ * @param campaignId - Campaign identifier.
530
+ * @param params - Date range, pagination, and sort options.
531
+ */
454
532
  list(campaignId, params = {}) {
455
533
  return this.http.get({
456
534
  path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown`,
@@ -479,7 +557,21 @@ var EngagementMetricsResource = class {
479
557
  );
480
558
  }
481
559
  http;
560
+ /**
561
+ * Stream full engagement export as JSONL.
562
+ *
563
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement/export`.
564
+ */
482
565
  export;
566
+ /**
567
+ * Paginated per-day, per-track engagement rows.
568
+ *
569
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement`.
570
+ * Max `pageSize` is **500** (default 50).
571
+ *
572
+ * @param campaignId - Campaign identifier.
573
+ * @param params - Date range, pagination, sort, and optional `engagementContext` filter.
574
+ */
483
575
  list(campaignId, params = {}) {
484
576
  return this.http.get({
485
577
  path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement`,
@@ -498,9 +590,17 @@ var EngagementMetricsResource = class {
498
590
 
499
591
  // src/client/soundlink.ts
500
592
  var Soundlink = class {
593
+ /** Verify connectivity and authentication. Maps to `GET /v1/ping`. */
501
594
  ping;
595
+ /** List and fetch campaigns. Requires `campaigns:read` scope. */
502
596
  campaigns;
597
+ /** Campaign metrics, breakdowns, and JSONL exports. Requires `metrics:read` scope. */
503
598
  metrics;
599
+ /**
600
+ * Create a Soundlink client.
601
+ *
602
+ * @param options - API key string (`sk_*`) or {@link SoundlinkClientOptions}.
603
+ */
504
604
  constructor(options) {
505
605
  const http = new HttpClient(options);
506
606
  const pingResource = new PingResource(http);
@@ -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 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 };\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","export class SoundlinkSdkError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkSdkError';\n Object.setPrototypeOf(this, SoundlinkSdkError.prototype);\n }\n}\n\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\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 ResolvedSoundlinkClientOptions {\n apiKey: string;\n baseUrl: string;\n timeout: number;\n maxRetries: number;\n fetch: typeof fetch;\n}\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 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 buildHeaders(): Record<string, string> {\n return {\n 'x-api-key': this.options.apiKey,\n Accept: 'application/json',\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\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 CampaignDetail,\n CampaignListData,\n CampaignListParams,\n DateRangeParams,\n EngagementExportParams,\n EngagementListData,\n EngagementListParams,\n EngagementRow,\n ExportCollection,\n MetricsOverview,\n PingData,\n} from '../types/api.js';\n\nexport interface ExportResource<T, P extends DateRangeParams> {\n (campaignId: string, params?: P): Promise<ApiResponse<JsonlStream<T>>>;\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\nexport class PingResource {\n constructor(private readonly http: HttpClient) {}\n\n ping(): Promise<ApiResponse<PingData>> {\n return this.http.get<PingData>({ path: '/ping' });\n }\n}\n\nexport class CampaignsResource {\n constructor(private readonly http: HttpClient) {}\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 get(campaignId: string): Promise<ApiResponse<CampaignDetail>> {\n return this.http.get<CampaignDetail>({\n path: `/campaigns/${encodeURIComponent(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\nexport class MetricsResource {\n readonly breakdown: BreakdownMetricsResource;\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 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\nclass BreakdownMetricsResource {\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 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\nclass EngagementMetricsResource {\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 list(\n campaignId: string,\n params: EngagementListParams = {},\n ): Promise<ApiResponse<EngagementListData>> {\n return this.http.get<EngagementListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement`,\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 engagementContext: params.engagementContext,\n },\n });\n }\n}\n\nexport { BreakdownMetricsResource, EngagementMetricsResource };\n","import { HttpClient } from './http-client.js';\nimport {\n CampaignsResource,\n MetricsResource,\n PingResource,\n} from '../resources/index.js';\nimport type { SoundlinkOptions } from '../types/api.js';\n\nexport class Soundlink {\n readonly ping: PingResource['ping'];\n readonly campaigns: CampaignsResource;\n readonly metrics: MetricsResource;\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.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 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 };\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 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 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 buildHeaders(): Record<string, string> {\n return {\n 'x-api-key': this.options.apiKey,\n Accept: 'application/json',\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 CampaignDetail,\n CampaignListData,\n CampaignListParams,\n DateRangeParams,\n EngagementExportParams,\n EngagementListData,\n EngagementListParams,\n EngagementRow,\n ExportCollection,\n MetricsOverview,\n PingData,\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/** Campaign listing and detail (`/v1/campaigns/*`). Requires `campaigns:read`. */\nexport class CampaignsResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * List campaigns for the authenticated organization.\n *\n * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**.\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}`.\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 * 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 breakdown and 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`.\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 /**\n * Paginated per-day, per-track engagement rows.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param campaignId - Campaign identifier.\n * @param params - Date range, pagination, sort, and optional `engagementContext` filter.\n */\n list(\n campaignId: string,\n params: EngagementListParams = {},\n ): Promise<ApiResponse<EngagementListData>> {\n return this.http.get<EngagementListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement`,\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 engagementContext: params.engagementContext,\n },\n });\n }\n}\n","import { HttpClient } from './http-client.js';\nimport {\n CampaignsResource,\n MetricsResource,\n PingResource,\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 /** List and fetch campaigns. Requires `campaigns:read` scope. */\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.campaigns = new CampaignsResource(http);\n this.metrics = new MetricsResource(http);\n }\n}\n\nexport { HttpClient, resolveClientOptions } from './http-client.js';\n"]}
@@ -1,53 +1,98 @@
1
+ /** Stable snake_case error codes returned by the Soundlink Public API. */
1
2
  type PublicApiErrorCode = 'invalid_api_key' | 'api_key_revoked' | 'api_key_expired' | 'mixed_credentials' | 'insufficient_scope' | 'not_found' | 'campaign_not_found' | 'invalid_query_parameter' | 'invalid_date_range' | 'page_size_exceeded' | 'rate_limit_exceeded' | 'internal_error';
3
+ /** Campaign lifecycle status. */
2
4
  type CampaignStatus = 'creating' | 'active' | 'paused' | 'completed' | 'failed';
5
+ /** Ad platform used by the campaign. */
3
6
  type SocialPlatform = 'meta';
7
+ /**
8
+ * Engagement context for per-track metrics.
9
+ *
10
+ * - `catalog` — same-artist spillover and promoted track plays.
11
+ * - `playlist` — per-track performance inside a promoted playlist.
12
+ */
4
13
  type EngagementContext = 'catalog' | 'playlist';
14
+ /** Allowed `sortBy` values for {@link CampaignListParams}. */
5
15
  type CampaignSortBy = 'createdAt' | 'status';
16
+ /** Allowed `sortBy` values for breakdown list requests. */
6
17
  type BreakdownSortBy = 'report_date' | 'spend_total';
18
+ /** Allowed `sortBy` values for engagement list requests. */
7
19
  type EngagementSortBy = 'report_date' | 'streams' | 'listeners';
20
+ /** Sort direction for list endpoints. */
8
21
  type SortOrder = 'asc' | 'desc';
22
+ /** Server-generated request metadata. Include `requestId` when contacting Soundlink support. */
9
23
  interface ApiMeta {
24
+ /** UUID for this API request. */
10
25
  requestId: string;
11
26
  }
27
+ /** API error returned in `{ data: null, error }` — never thrown by SDK methods. */
12
28
  interface ApiError {
29
+ /** Stable error code from the Public API. */
13
30
  code: PublicApiErrorCode;
31
+ /** Human-readable description. Do not parse programmatically. */
14
32
  message: string;
33
+ /** HTTP status code. */
15
34
  status: number;
35
+ /** Same as `meta.requestId` when present. */
16
36
  requestId?: string;
37
+ /** Seconds to wait before retrying, from the `Retry-After` header on `429`. */
17
38
  retryAfter?: number;
18
39
  }
40
+ /**
41
+ * Standard SDK response shape for every Public API method.
42
+ *
43
+ * @typeParam T - Success payload type. `null` when `error` is set.
44
+ */
19
45
  interface ApiResponse<T> {
46
+ /** Success payload, or `null` when the API returned an error. */
20
47
  data: T | null;
48
+ /** API error details, or `null` on success. */
21
49
  error: ApiError | null;
50
+ /** Request metadata (always present on successful envelope responses). */
22
51
  meta?: ApiMeta;
23
52
  }
53
+ /** Pagination metadata included in list responses. */
24
54
  interface Pagination {
55
+ /** Current page (1-indexed). */
25
56
  page: number;
57
+ /** Items per page. */
26
58
  pageSize: number;
59
+ /** Total items across all pages. */
27
60
  totalCount: number;
61
+ /** Total number of pages. */
28
62
  totalPages: number;
29
63
  }
64
+ /** Campaign summary returned by {@link CampaignsResource.list}. */
30
65
  interface CampaignSummary {
31
66
  campaignId: string;
32
67
  organizationId: string;
33
68
  status: CampaignStatus;
34
69
  socialPlatform: SocialPlatform;
70
+ /** Daily budget in USD. */
35
71
  dailyBudget: number;
72
+ /** Total budget in USD. */
36
73
  totalBudget: number;
74
+ /** Campaign duration in days. */
37
75
  campaignDuration: number;
76
+ /** ISO 8601 creation timestamp. */
38
77
  createdAt: string;
78
+ /** ISO 8601 last update timestamp. */
39
79
  updatedAt: string;
40
80
  }
81
+ /** Full campaign detail from {@link CampaignsResource.get}. */
41
82
  interface CampaignDetail extends CampaignSummary {
83
+ /** Growth strategy (e.g. `custom`, `maximum_growth`). */
42
84
  strategyType?: string;
43
85
  }
86
+ /** Paginated campaign list payload. */
44
87
  interface CampaignListData {
45
88
  items: CampaignSummary[];
46
89
  pagination: Pagination;
47
90
  }
91
+ /** Successful `GET /v1/ping` payload. */
48
92
  interface PingData {
49
93
  status: 'ok';
50
94
  }
95
+ /** Campaign-level metric totals from {@link MetricsResource.overview}. */
51
96
  interface MetricsOverview {
52
97
  listeners: number;
53
98
  streams: number;
@@ -55,18 +100,25 @@ interface MetricsOverview {
55
100
  impressions: number | null;
56
101
  ad_clicks: number | null;
57
102
  link_clicks: number | null;
103
+ /** Meta ad spend excluding Soundlink fees (USD). */
58
104
  spend_media: number;
105
+ /** Total billed amount including fees (USD). */
59
106
  spend_total: number;
107
+ /** Soundlink service fee (USD). */
60
108
  fees: number;
61
109
  currency: string;
110
+ /** Cost per listener. */
62
111
  cpl: number;
112
+ /** Cost per follower. */
63
113
  cpf: number;
64
114
  streams_per_listener: number;
65
115
  }
116
+ /** One row of the `campaign_country_daily` v1.0 schema. */
66
117
  interface BreakdownRow {
67
118
  provider: 'soundlink';
68
119
  account_id: string;
69
120
  schema_version: string;
121
+ /** UTC calendar date (`YYYY-MM-DD`). */
70
122
  report_date: string;
71
123
  report_date_timezone: 'UTC';
72
124
  exported_at: string;
@@ -97,6 +149,7 @@ interface BreakdownRow {
97
149
  cost_per_result: number;
98
150
  result_type: 'lp_click' | 'stream' | 'follow' | null;
99
151
  }
152
+ /** One row of the `campaign_engagement_daily` v1.0 schema. */
100
153
  interface EngagementRow {
101
154
  provider: 'soundlink';
102
155
  account_id: string;
@@ -125,57 +178,88 @@ interface EngagementRow {
125
178
  streams: number;
126
179
  spl: number;
127
180
  }
181
+ /** Paginated breakdown list payload. */
128
182
  interface BreakdownListData {
129
183
  schemaVersion: string;
130
184
  items: BreakdownRow[];
131
185
  pagination: Pagination;
132
186
  }
187
+ /** Paginated engagement list payload. */
133
188
  interface EngagementListData {
134
189
  schemaVersion: string;
135
190
  items: EngagementRow[];
136
191
  pagination: Pagination;
137
192
  }
193
+ /** In-memory result from {@link ExportResource.collect}. */
138
194
  interface ExportCollection<T> {
139
195
  rows: T[];
196
+ /** Same as `rows.length`. */
140
197
  rowCount: number;
141
198
  }
199
+ /** Async iterable JSONL stream from export endpoints. May include `rowCount` from `X-Row-Count`. */
142
200
  interface JsonlStream<T> extends AsyncIterable<T> {
201
+ /** Total rows when the API sent the `X-Row-Count` header. */
143
202
  rowCount?: number;
144
203
  }
204
+ /** Options for {@link Soundlink} and {@link HttpClient}. */
145
205
  interface SoundlinkClientOptions {
206
+ /** Soundlink API key (`sk_<prefix>_<secret>`). Sent as the `x-api-key` header. */
146
207
  apiKey: string;
208
+ /** API base URL. Defaults to `https://api.getsoundlink.com`. */
147
209
  baseUrl?: string;
210
+ /** Request timeout in milliseconds. Default: `30000`. */
148
211
  timeout?: number;
212
+ /** Retries on `429` and `5xx`. Default: `2`. */
149
213
  maxRetries?: number;
214
+ /** Custom `fetch` implementation (tests, Edge runtimes). */
150
215
  fetch?: typeof fetch;
151
216
  }
217
+ /** API key string or full options object. */
152
218
  type SoundlinkOptions = SoundlinkClientOptions | string;
219
+ /** Query params for {@link CampaignsResource.list}. */
153
220
  interface CampaignListParams {
221
+ /** Page number (1-indexed). Default: `1`. */
154
222
  page?: number;
223
+ /** Items per page. Default: `10`. Max: **100**. */
155
224
  pageSize?: number;
225
+ /** Sort field. Default: `createdAt`. */
156
226
  sortBy?: CampaignSortBy;
227
+ /** Sort direction. Default: `desc`. */
157
228
  sortOrder?: SortOrder;
158
229
  }
230
+ /** Inclusive date range filter (`YYYY-MM-DD`). */
159
231
  interface DateRangeParams {
232
+ /** Inclusive start date. */
160
233
  startDate?: string;
234
+ /** Inclusive end date. Must not be before `startDate`. */
161
235
  endDate?: string;
162
236
  }
237
+ /** Query params for {@link BreakdownMetricsResource.list}. */
163
238
  interface BreakdownListParams extends DateRangeParams {
164
239
  page?: number;
240
+ /** Default: `50`. Max: **500**. */
165
241
  pageSize?: number;
242
+ /** Default: `report_date`. */
166
243
  sortBy?: BreakdownSortBy;
244
+ /** Default: `asc`. */
167
245
  sortOrder?: SortOrder;
168
246
  }
247
+ /** Query params for {@link EngagementMetricsResource.list}. */
169
248
  interface EngagementListParams extends DateRangeParams {
170
249
  page?: number;
250
+ /** Default: `50`. Max: **500**. */
171
251
  pageSize?: number;
252
+ /** Default: `report_date`. */
172
253
  sortBy?: EngagementSortBy;
173
254
  sortOrder?: SortOrder;
255
+ /** Filter to `catalog` or `playlist`. Omit for both. */
174
256
  engagementContext?: EngagementContext;
175
257
  }
258
+ /** Query params for engagement JSONL export. */
176
259
  interface EngagementExportParams extends DateRangeParams {
177
260
  engagementContext?: EngagementContext;
178
261
  }
262
+ /** Query params for breakdown JSONL export. Max **90 days** per request. */
179
263
  type BreakdownExportParams = DateRangeParams;
180
264
 
181
265
  interface HttpGetOptions {
@@ -192,6 +276,11 @@ interface ResolvedSoundlinkClientOptions {
192
276
  maxRetries: number;
193
277
  fetch: typeof fetch;
194
278
  }
279
+ /**
280
+ * Normalize constructor options and validate the API key format.
281
+ *
282
+ * @throws {@link SoundlinkConfigError} When the key is missing or does not start with `sk_`.
283
+ */
195
284
  declare function resolveClientOptions(options: SoundlinkOptions): ResolvedSoundlinkClientOptions;
196
285
  declare class HttpClient {
197
286
  private readonly options;
@@ -204,57 +293,235 @@ declare class HttpClient {
204
293
  private parseErrorEnvelope;
205
294
  private fetchWithRetry;
206
295
  }
296
+ /**
297
+ * Read `rowCount` from a {@link JsonlStream} when the API sent `X-Row-Count`.
298
+ *
299
+ * @returns Row count, or `undefined` if not available.
300
+ */
207
301
  declare function getStreamRowCount<T>(stream: AsyncIterable<T>): number | undefined;
208
302
 
303
+ /**
304
+ * JSONL export endpoint: stream rows with {@link ExportResource.collect} or iterate the stream directly.
305
+ *
306
+ * @example
307
+ * ```ts
308
+ * const { data: stream } = await soundlink.metrics.breakdown.export(campaignId);
309
+ * for await (const row of stream!) { ... }
310
+ *
311
+ * const { data } = await soundlink.metrics.breakdown.export.collect(campaignId);
312
+ * ```
313
+ */
209
314
  interface ExportResource<T, P extends DateRangeParams> {
315
+ /**
316
+ * Stream export rows as newline-delimited JSON.
317
+ *
318
+ * @param campaignId - Soundlink campaign ID.
319
+ * @param params - Optional date range (max 90 days per request).
320
+ */
210
321
  (campaignId: string, params?: P): Promise<ApiResponse<JsonlStream<T>>>;
322
+ /**
323
+ * Download all export rows into memory.
324
+ *
325
+ * Prefer {@link ExportResource | the stream} for large datasets.
326
+ */
211
327
  collect(campaignId: string, params?: P): Promise<ApiResponse<ExportCollection<T>>>;
212
328
  }
329
+ /** System endpoints (`GET /v1/ping`). */
213
330
  declare class PingResource {
214
331
  private readonly http;
215
332
  constructor(http: HttpClient);
333
+ /**
334
+ * Verify connectivity and API key authentication.
335
+ *
336
+ * Accepts any valid v1 key scope. Does not require `campaigns:read` or `metrics:read`.
337
+ *
338
+ * @returns `{ data: { status: 'ok' }, error: null }` on success.
339
+ *
340
+ * @example
341
+ * ```ts
342
+ * const { data, error, meta } = await soundlink.ping();
343
+ * ```
344
+ */
216
345
  ping(): Promise<ApiResponse<PingData>>;
217
346
  }
347
+ /** Campaign listing and detail (`/v1/campaigns/*`). Requires `campaigns:read`. */
218
348
  declare class CampaignsResource {
219
349
  private readonly http;
220
350
  constructor(http: HttpClient);
351
+ /**
352
+ * List campaigns for the authenticated organization.
353
+ *
354
+ * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**.
355
+ *
356
+ * @param params - Pagination and sort options.
357
+ *
358
+ * @example
359
+ * ```ts
360
+ * const { data, error } = await soundlink.campaigns.list({ page: 1, pageSize: 100 });
361
+ * ```
362
+ */
221
363
  list(params?: CampaignListParams): Promise<ApiResponse<CampaignListData>>;
364
+ /**
365
+ * Fetch full details for a single campaign.
366
+ *
367
+ * Maps to `GET /v1/campaigns/{campaignId}`.
368
+ *
369
+ * @param campaignId - Campaign identifier returned by {@link CampaignsResource.list}.
370
+ */
222
371
  get(campaignId: string): Promise<ApiResponse<CampaignDetail>>;
372
+ /**
373
+ * Async iterator over every campaign across all pages.
374
+ *
375
+ * Stops silently if a page request returns an error.
376
+ *
377
+ * @param params - Same as {@link CampaignsResource.list} except `page` is managed automatically.
378
+ *
379
+ * @example
380
+ * ```ts
381
+ * for await (const campaign of soundlink.campaigns.listAll({ pageSize: 100 })) {
382
+ * console.log(campaign.campaignId);
383
+ * }
384
+ * ```
385
+ */
223
386
  listAll(params?: Omit<CampaignListParams, 'page'>): AsyncGenerator<CampaignListData['items'][number], void, void>;
224
387
  }
388
+ /**
389
+ * Campaign metrics (`/v1/campaigns/{id}/metrics/*`). Requires `metrics:read`.
390
+ *
391
+ * @example
392
+ * ```ts
393
+ * await soundlink.metrics.overview(campaignId);
394
+ * await soundlink.metrics.breakdown.list(campaignId);
395
+ * await soundlink.metrics.engagement.export(campaignId);
396
+ * ```
397
+ */
225
398
  declare class MetricsResource {
226
399
  private readonly http;
400
+ /** Per-day country breakdown and JSONL export. */
227
401
  readonly breakdown: BreakdownMetricsResource;
402
+ /** Per-track engagement breakdown and JSONL export. */
228
403
  readonly engagement: EngagementMetricsResource;
229
404
  constructor(http: HttpClient);
405
+ /**
406
+ * Campaign-level metric totals for a date range.
407
+ *
408
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/overview`.
409
+ * Aggregates across all countries — use {@link BreakdownMetricsResource.list} for daily rows.
410
+ *
411
+ * @param campaignId - Campaign identifier.
412
+ * @param params - Inclusive `YYYY-MM-DD` date range. Omit for API defaults.
413
+ *
414
+ * @example
415
+ * ```ts
416
+ * const { data } = await soundlink.metrics.overview(campaignId, {
417
+ * startDate: '2026-01-01',
418
+ * endDate: '2026-03-31',
419
+ * });
420
+ * ```
421
+ */
230
422
  overview(campaignId: string, params?: DateRangeParams): Promise<ApiResponse<MetricsOverview>>;
231
423
  }
424
+ /**
425
+ * Country-level daily metrics (`campaign_country_daily` schema).
426
+ *
427
+ * Access via `soundlink.metrics.breakdown`.
428
+ */
232
429
  declare class BreakdownMetricsResource {
233
430
  private readonly http;
431
+ /**
432
+ * Stream full breakdown export as JSONL.
433
+ *
434
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown/export`.
435
+ */
234
436
  readonly export: ExportResource<BreakdownRow, BreakdownExportParams>;
235
437
  constructor(http: HttpClient);
438
+ /**
439
+ * Paginated per-day, per-country breakdown rows.
440
+ *
441
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown`.
442
+ * Max `pageSize` is **500** (default 50).
443
+ *
444
+ * @param campaignId - Campaign identifier.
445
+ * @param params - Date range, pagination, and sort options.
446
+ */
236
447
  list(campaignId: string, params?: BreakdownListParams): Promise<ApiResponse<BreakdownListData>>;
237
448
  }
449
+ /**
450
+ * Per-track engagement metrics (`campaign_engagement_daily` schema).
451
+ *
452
+ * Access via `soundlink.metrics.engagement`.
453
+ */
238
454
  declare class EngagementMetricsResource {
239
455
  private readonly http;
456
+ /**
457
+ * Stream full engagement export as JSONL.
458
+ *
459
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement/export`.
460
+ */
240
461
  readonly export: ExportResource<EngagementRow, EngagementExportParams>;
241
462
  constructor(http: HttpClient);
463
+ /**
464
+ * Paginated per-day, per-track engagement rows.
465
+ *
466
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement`.
467
+ * Max `pageSize` is **500** (default 50).
468
+ *
469
+ * @param campaignId - Campaign identifier.
470
+ * @param params - Date range, pagination, sort, and optional `engagementContext` filter.
471
+ */
242
472
  list(campaignId: string, params?: EngagementListParams): Promise<ApiResponse<EngagementListData>>;
243
473
  }
244
474
 
475
+ /**
476
+ * Official Soundlink Public API client.
477
+ *
478
+ * All methods return `{ data, error, meta? }` and never throw on HTTP/API errors.
479
+ * SDK configuration, parsing, and transport failures throw {@link SoundlinkSdkError}.
480
+ *
481
+ * @example
482
+ * ```ts
483
+ * import { Soundlink } from 'soundlink';
484
+ *
485
+ * const soundlink = new Soundlink(process.env.SOUNDLINK_API_KEY!);
486
+ *
487
+ * const { data, error } = await soundlink.ping();
488
+ * if (error) {
489
+ * console.error(error.code, error.message);
490
+ * } else {
491
+ * console.log(data.status);
492
+ * }
493
+ * ```
494
+ *
495
+ * @see https://docs.getsoundlink.com
496
+ */
245
497
  declare class Soundlink {
498
+ /** Verify connectivity and authentication. Maps to `GET /v1/ping`. */
246
499
  readonly ping: PingResource['ping'];
500
+ /** List and fetch campaigns. Requires `campaigns:read` scope. */
247
501
  readonly campaigns: CampaignsResource;
502
+ /** Campaign metrics, breakdowns, and JSONL exports. Requires `metrics:read` scope. */
248
503
  readonly metrics: MetricsResource;
504
+ /**
505
+ * Create a Soundlink client.
506
+ *
507
+ * @param options - API key string (`sk_*`) or {@link SoundlinkClientOptions}.
508
+ */
249
509
  constructor(options: SoundlinkOptions);
250
510
  }
251
511
 
512
+ /**
513
+ * Base error for unexpected SDK failures (configuration, parsing, transport).
514
+ *
515
+ * HTTP/API errors from Soundlink are returned as `{ data: null, error }` and do not throw.
516
+ */
252
517
  declare class SoundlinkSdkError extends Error {
253
518
  constructor(message: string);
254
519
  }
520
+ /** Thrown when a response body cannot be parsed or the network request fails unexpectedly. */
255
521
  declare class SoundlinkParseError extends SoundlinkSdkError {
256
522
  constructor(message: string);
257
523
  }
524
+ /** Thrown when the client is misconfigured (missing or invalid API key, etc.). */
258
525
  declare class SoundlinkConfigError extends SoundlinkSdkError {
259
526
  constructor(message: string);
260
527
  }
package/dist/esm/index.js CHANGED
@@ -375,6 +375,18 @@ var PingResource = class {
375
375
  this.http = http;
376
376
  }
377
377
  http;
378
+ /**
379
+ * Verify connectivity and API key authentication.
380
+ *
381
+ * Accepts any valid v1 key scope. Does not require `campaigns:read` or `metrics:read`.
382
+ *
383
+ * @returns `{ data: { status: 'ok' }, error: null }` on success.
384
+ *
385
+ * @example
386
+ * ```ts
387
+ * const { data, error, meta } = await soundlink.ping();
388
+ * ```
389
+ */
378
390
  ping() {
379
391
  return this.http.get({ path: "/ping" });
380
392
  }
@@ -384,6 +396,18 @@ var CampaignsResource = class {
384
396
  this.http = http;
385
397
  }
386
398
  http;
399
+ /**
400
+ * List campaigns for the authenticated organization.
401
+ *
402
+ * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**.
403
+ *
404
+ * @param params - Pagination and sort options.
405
+ *
406
+ * @example
407
+ * ```ts
408
+ * const { data, error } = await soundlink.campaigns.list({ page: 1, pageSize: 100 });
409
+ * ```
410
+ */
387
411
  list(params = {}) {
388
412
  return this.http.get({
389
413
  path: "/campaigns",
@@ -395,11 +419,32 @@ var CampaignsResource = class {
395
419
  }
396
420
  });
397
421
  }
422
+ /**
423
+ * Fetch full details for a single campaign.
424
+ *
425
+ * Maps to `GET /v1/campaigns/{campaignId}`.
426
+ *
427
+ * @param campaignId - Campaign identifier returned by {@link CampaignsResource.list}.
428
+ */
398
429
  get(campaignId) {
399
430
  return this.http.get({
400
431
  path: `/campaigns/${encodeURIComponent(campaignId)}`
401
432
  });
402
433
  }
434
+ /**
435
+ * Async iterator over every campaign across all pages.
436
+ *
437
+ * Stops silently if a page request returns an error.
438
+ *
439
+ * @param params - Same as {@link CampaignsResource.list} except `page` is managed automatically.
440
+ *
441
+ * @example
442
+ * ```ts
443
+ * for await (const campaign of soundlink.campaigns.listAll({ pageSize: 100 })) {
444
+ * console.log(campaign.campaignId);
445
+ * }
446
+ * ```
447
+ */
403
448
  async *listAll(params = {}) {
404
449
  let page = 1;
405
450
  let totalPages = 1;
@@ -423,8 +468,27 @@ var MetricsResource = class {
423
468
  this.engagement = new EngagementMetricsResource(http);
424
469
  }
425
470
  http;
471
+ /** Per-day country breakdown and JSONL export. */
426
472
  breakdown;
473
+ /** Per-track engagement breakdown and JSONL export. */
427
474
  engagement;
475
+ /**
476
+ * Campaign-level metric totals for a date range.
477
+ *
478
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/overview`.
479
+ * Aggregates across all countries — use {@link BreakdownMetricsResource.list} for daily rows.
480
+ *
481
+ * @param campaignId - Campaign identifier.
482
+ * @param params - Inclusive `YYYY-MM-DD` date range. Omit for API defaults.
483
+ *
484
+ * @example
485
+ * ```ts
486
+ * const { data } = await soundlink.metrics.overview(campaignId, {
487
+ * startDate: '2026-01-01',
488
+ * endDate: '2026-03-31',
489
+ * });
490
+ * ```
491
+ */
428
492
  overview(campaignId, params = {}) {
429
493
  return this.http.get({
430
494
  path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/overview`,
@@ -448,7 +512,21 @@ var BreakdownMetricsResource = class {
448
512
  );
449
513
  }
450
514
  http;
515
+ /**
516
+ * Stream full breakdown export as JSONL.
517
+ *
518
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown/export`.
519
+ */
451
520
  export;
521
+ /**
522
+ * Paginated per-day, per-country breakdown rows.
523
+ *
524
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown`.
525
+ * Max `pageSize` is **500** (default 50).
526
+ *
527
+ * @param campaignId - Campaign identifier.
528
+ * @param params - Date range, pagination, and sort options.
529
+ */
452
530
  list(campaignId, params = {}) {
453
531
  return this.http.get({
454
532
  path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown`,
@@ -477,7 +555,21 @@ var EngagementMetricsResource = class {
477
555
  );
478
556
  }
479
557
  http;
558
+ /**
559
+ * Stream full engagement export as JSONL.
560
+ *
561
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement/export`.
562
+ */
480
563
  export;
564
+ /**
565
+ * Paginated per-day, per-track engagement rows.
566
+ *
567
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement`.
568
+ * Max `pageSize` is **500** (default 50).
569
+ *
570
+ * @param campaignId - Campaign identifier.
571
+ * @param params - Date range, pagination, sort, and optional `engagementContext` filter.
572
+ */
481
573
  list(campaignId, params = {}) {
482
574
  return this.http.get({
483
575
  path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement`,
@@ -496,9 +588,17 @@ var EngagementMetricsResource = class {
496
588
 
497
589
  // src/client/soundlink.ts
498
590
  var Soundlink = class {
591
+ /** Verify connectivity and authentication. Maps to `GET /v1/ping`. */
499
592
  ping;
593
+ /** List and fetch campaigns. Requires `campaigns:read` scope. */
500
594
  campaigns;
595
+ /** Campaign metrics, breakdowns, and JSONL exports. Requires `metrics:read` scope. */
501
596
  metrics;
597
+ /**
598
+ * Create a Soundlink client.
599
+ *
600
+ * @param options - API key string (`sk_*`) or {@link SoundlinkClientOptions}.
601
+ */
502
602
  constructor(options) {
503
603
  const http = new HttpClient(options);
504
604
  const pingResource = new PingResource(http);
@@ -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 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 };\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","export class SoundlinkSdkError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkSdkError';\n Object.setPrototypeOf(this, SoundlinkSdkError.prototype);\n }\n}\n\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\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 ResolvedSoundlinkClientOptions {\n apiKey: string;\n baseUrl: string;\n timeout: number;\n maxRetries: number;\n fetch: typeof fetch;\n}\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 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 buildHeaders(): Record<string, string> {\n return {\n 'x-api-key': this.options.apiKey,\n Accept: 'application/json',\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\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 CampaignDetail,\n CampaignListData,\n CampaignListParams,\n DateRangeParams,\n EngagementExportParams,\n EngagementListData,\n EngagementListParams,\n EngagementRow,\n ExportCollection,\n MetricsOverview,\n PingData,\n} from '../types/api.js';\n\nexport interface ExportResource<T, P extends DateRangeParams> {\n (campaignId: string, params?: P): Promise<ApiResponse<JsonlStream<T>>>;\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\nexport class PingResource {\n constructor(private readonly http: HttpClient) {}\n\n ping(): Promise<ApiResponse<PingData>> {\n return this.http.get<PingData>({ path: '/ping' });\n }\n}\n\nexport class CampaignsResource {\n constructor(private readonly http: HttpClient) {}\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 get(campaignId: string): Promise<ApiResponse<CampaignDetail>> {\n return this.http.get<CampaignDetail>({\n path: `/campaigns/${encodeURIComponent(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\nexport class MetricsResource {\n readonly breakdown: BreakdownMetricsResource;\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 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\nclass BreakdownMetricsResource {\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 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\nclass EngagementMetricsResource {\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 list(\n campaignId: string,\n params: EngagementListParams = {},\n ): Promise<ApiResponse<EngagementListData>> {\n return this.http.get<EngagementListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement`,\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 engagementContext: params.engagementContext,\n },\n });\n }\n}\n\nexport { BreakdownMetricsResource, EngagementMetricsResource };\n","import { HttpClient } from './http-client.js';\nimport {\n CampaignsResource,\n MetricsResource,\n PingResource,\n} from '../resources/index.js';\nimport type { SoundlinkOptions } from '../types/api.js';\n\nexport class Soundlink {\n readonly ping: PingResource['ping'];\n readonly campaigns: CampaignsResource;\n readonly metrics: MetricsResource;\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.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":";AAAO,IAAM,gBAAA,GAAmB;AAEzB,IAAM,kBAAA,GAAqB;AAE3B,IAAM,mBAAA,GAAsB;AAE5B,IAAM,cAAA,GAAiB;AAEvB,IAAM,uBAAA,GAA0B;AAEhC,IAAM,qBAAA,GAAwB;AAM9B,IAAM,kBAAA,GAAqB,KAAA;;;ACP3B,SAAS,mBAAmB,IAAA,EAAyC;AAC1E,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,KAAS,IAAA,EAAM;AAC7C,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,IAAA;AACf,EAAA,OACE,OAAO,MAAA,CAAO,KAAA,KAAU,QAAA,IACxB,OAAO,KAAA,KAAU,IAAA,IACjB,OAAQ,MAAA,CAAO,MAAkC,IAAA,KAAS,QAAA,IAC1D,OAAQ,MAAA,CAAO,MAAkC,OAAA,KAAY,QAAA;AAEjE;AAEO,SAAS,qBAAwB,IAAA,EAA8C;AACpF,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,KAAS,IAAA,EAAM;AAC7C,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,IAAA;AACf,EAAA,OAAO,UAAU,MAAA,IAAU,OAAO,OAAO,IAAA,KAAS,QAAA,IAAY,OAAO,IAAA,KAAS,IAAA;AAChF;AAEO,SAAS,UAAA,CACd,QAAA,EACA,MAAA,EACA,UAAA,EACU;AACV,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAS,KAAA,CAAM,IAAA;AAAA,IACrB,OAAA,EAAS,SAAS,KAAA,CAAM,OAAA;AAAA,IACxB,MAAA;AAAA,IACA,SAAA,EAAW,SAAS,IAAA,CAAK,SAAA;AAAA,IACzB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe;AAAC,GACnD;AACF;AAEO,SAAS,eAAA,CAAmB,MAAS,IAAA,EAA+B;AACzE,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,KAAA,EAAO,IAAA;AAAA,IACP;AAAA,GACF;AACF;AAEO,SAAS,cAAiB,KAAA,EAAiC;AAChE,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,IAAA;AAAA,IACN,KAAA;AAAA,IACA,GAAI,KAAA,CAAM,SAAA,GAAY,EAAE,IAAA,EAAM,EAAE,SAAA,EAAW,KAAA,CAAM,SAAA,EAAU,EAAE,GAAI;AAAC,GACpE;AACF;AAEO,SAAS,sBAAsB,KAAA,EAA0C;AAC9E,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,QAAA,CAAS,KAAA,EAAO,EAAE,CAAA;AACzC,EAAA,IAAI,MAAA,CAAO,QAAA,CAAS,OAAO,CAAA,IAAK,WAAW,CAAA,EAAG;AAC5C,IAAA,OAAO,OAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA;AAC/B,EAAA,IAAI,MAAA,CAAO,QAAA,CAAS,MAAM,CAAA,EAAG;AAC3B,IAAA,MAAM,eAAe,IAAA,CAAK,IAAA,CAAA,CAAM,SAAS,IAAA,CAAK,GAAA,MAAS,GAAI,CAAA;AAC3D,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,YAAA,EAAc,CAAC,CAAA;AAAA,EACjC;AAEA,EAAA,OAAO,MAAA;AACT;;;AC1EO,IAAM,iBAAA,GAAN,MAAM,kBAAA,SAA0B,KAAA,CAAM;AAAA,EAC3C,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,mBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,kBAAA,CAAkB,SAAS,CAAA;AAAA,EACzD;AACF;AAGO,IAAM,mBAAA,GAAN,MAAM,oBAAA,SAA4B,iBAAA,CAAkB;AAAA,EACzD,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,qBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,oBAAA,CAAoB,SAAS,CAAA;AAAA,EAC3D;AACF;AAGO,IAAM,oBAAA,GAAN,MAAM,qBAAA,SAA6B,iBAAA,CAAkB;AAAA,EAC1D,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,qBAAA,CAAqB,SAAS,CAAA;AAAA,EAC5D;AACF;;;AC3BA,gBAAuB,iBAAA,CACrB,MACA,eAAA,EACmB;AACnB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,MAAA,GAAS,KAAK,SAAA,EAAU;AAC9B,EAAA,MAAM,OAAA,GAAU,IAAI,WAAA,EAAY;AAChC,EAAA,IAAI,MAAA,GAAS,EAAA;AAEb,EAAA,IAAI;AACF,IAAA,WAAS;AACP,MAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,MAAA,IAAI,IAAA,EAAM;AACR,QAAA;AAAA,MACF;AAEA,MAAA,MAAA,IAAU,QAAQ,MAAA,CAAO,KAAA,EAAO,EAAE,MAAA,EAAQ,MAAM,CAAA;AAChD,MAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA;AAC/B,MAAA,MAAA,GAAS,KAAA,CAAM,KAAI,IAAK,EAAA;AAExB,MAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,QAAA,MAAM,OAAA,GAAU,KAAK,IAAA,EAAK;AAC1B,QAAA,IAAI,CAAC,OAAA,EAAS;AACZ,UAAA;AAAA,QACF;AAEA,QAAA,IAAI;AACF,UAAA,MAAM,IAAA,CAAK,MAAM,OAAO,CAAA;AAAA,QAC1B,SAAS,KAAA,EAAO;AACd,UAAA,eAAA,GAAkB,SAAS,KAAK,CAAA;AAChC,UAAA,MAAM,IAAI,oBAAoB,oCAAoC,CAAA;AAAA,QACpE;AAAA,MACF;AAAA,IACF;AAEA,IAAA,MAAM,QAAA,GAAW,OAAO,IAAA,EAAK;AAC7B,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAK,MAAM,QAAQ,CAAA;AAAA,MAC3B,SAAS,KAAA,EAAO;AACd,QAAA,eAAA,GAAkB,UAAU,KAAK,CAAA;AACjC,QAAA,MAAM,IAAI,oBAAoB,oCAAoC,CAAA;AAAA,MACpE;AAAA,IACF;AAAA,EACF,CAAA,SAAE;AACA,IAAA,MAAA,CAAO,WAAA,EAAY;AAAA,EACrB;AACF;AAEA,eAAsB,oBACpB,MAAA,EAC0C;AAC1C,EAAA,MAAM,OAAY,EAAC;AACnB,EAAA,WAAA,MAAiB,OAAO,MAAA,EAAQ;AAC9B,IAAA,IAAA,CAAK,KAAK,GAAG,CAAA;AAAA,EACf;AACA,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,UAAU,IAAA,CAAK;AAAA,GACjB;AACF;;;ACjEO,SAAS,iBACd,MAAA,EACQ;AACR,EAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AAEzC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AACjD,IAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,IAAQ,UAAU,EAAA,EAAI;AACzD,MAAA;AAAA,IACF;AACA,IAAA,YAAA,CAAa,GAAA,CAAI,GAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACrC;AAEA,EAAA,MAAM,KAAA,GAAQ,aAAa,QAAA,EAAS;AACpC,EAAA,OAAO,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAA;AAC/B;AAEO,SAAS,OAAA,CAAQ,SAAiB,IAAA,EAAsB;AAC7D,EAAA,MAAM,cAAA,GAAiB,QAAQ,QAAA,CAAS,GAAG,IAAI,OAAA,CAAQ,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAAI,OAAA;AACtE,EAAA,MAAM,iBAAiB,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA,GAAI,IAAA,GAAO,IAAI,IAAI,CAAA,CAAA;AAC7D,EAAA,OAAO,CAAA,EAAG,cAAc,CAAA,EAAG,cAAc,CAAA,CAAA;AAC3C;AAEO,SAAS,MAAM,EAAA,EAA2B;AAC/C,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY;AAC9B,IAAA,UAAA,CAAW,SAAS,EAAE,CAAA;AAAA,EACxB,CAAC,CAAA;AACH;AAEO,SAAS,mBAAmB,OAAA,EAAyB;AAC1D,EAAA,MAAM,IAAA,GAAO,GAAA;AACb,EAAA,MAAM,SAAS,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,GAAG,CAAA;AAC7C,EAAA,OAAO,IAAA,GAAO,KAAK,OAAA,GAAU,MAAA;AAC/B;;;ACiBO,SAAS,qBACd,OAAA,EACgC;AAChC,EAAA,MAAM,aAAa,OAAO,OAAA,KAAY,WAAW,EAAE,MAAA,EAAQ,SAAQ,GAAI,OAAA;AAEvE,EAAA,MAAM,MAAA,GAAS,UAAA,CAAW,MAAA,CAAO,IAAA,EAAK;AACtC,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,qBAAqB,qBAAqB,CAAA;AAAA,EACtD;AAEA,EAAA,IAAI,CAAC,MAAA,CAAO,UAAA,CAAW,cAAc,CAAA,EAAG;AACtC,IAAA,MAAM,IAAI,oBAAA;AAAA,MACR,yDAAyD,cAAc,CAAA,EAAA;AAAA,KACzE;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,OAAA,EAAS,WAAW,OAAA,IAAW,gBAAA;AAAA,IAC/B,OAAA,EAAS,WAAW,OAAA,IAAW,kBAAA;AAAA,IAC/B,UAAA,EAAY,WAAW,UAAA,IAAc,mBAAA;AAAA,IACrC,OAAO,UAAA,CAAW,KAAA,IAAS,UAAA,CAAW,KAAA,CAAM,KAAK,UAAU;AAAA,GAC7D;AACF;AAEO,IAAM,aAAN,MAAiB;AAAA,EACL,OAAA;AAAA,EAEjB,YAAY,OAAA,EAA2B;AACrC,IAAA,IAAA,CAAK,OAAA,GAAU,qBAAqB,OAAO,CAAA;AAAA,EAC7C;AAAA,EAEA,IAAI,eAAA,GAAkD;AACpD,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,MAAM,GAAA,CAAO,EAAE,IAAA,EAAM,OAAM,EAA4C;AACrE,IAAA,MAAM,GAAA,GAAM,OAAA;AAAA,MACV,KAAK,OAAA,CAAQ,OAAA;AAAA,MACb,CAAA,EAAG,kBAAkB,CAAA,EAAG,IAAI,GAAG,gBAAA,CAAiB,KAAA,IAAS,EAAE,CAAC,CAAA;AAAA,KAC9D;AAEA,IAAA,OAAO,IAAA,CAAK,YAAe,GAAA,EAAK;AAAA,MAC9B,MAAA,EAAQ,KAAA;AAAA,MACR,OAAA,EAAS,KAAK,YAAA;AAAa,KAC5B,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,QAAA,CAAY;AAAA,IAChB,IAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA,GAAS;AAAA,GACX,EAA2D;AACzD,IAAA,MAAM,GAAA,GAAM,OAAA;AAAA,MACV,KAAK,OAAA,CAAQ,OAAA;AAAA,MACb,CAAA,EAAG,kBAAkB,CAAA,EAAG,IAAI,GAAG,gBAAA,CAAiB,KAAA,IAAS,EAAE,CAAC,CAAA;AAAA,KAC9D;AAEA,IAAA,IAAI,QAAA;AACJ,IAAA,IAAI;AACF,MAAA,QAAA,GAAW,MAAM,IAAA,CAAK,cAAA,CAAe,GAAA,EAAK;AAAA,QACxC,MAAA,EAAQ,KAAA;AAAA,QACR,OAAA,EAAS;AAAA,UACP,GAAG,KAAK,YAAA,EAAa;AAAA,UACrB,MAAA,EAAQ;AAAA;AACV,OACD,CAAA;AAAA,IACH,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,iBAAiB,KAAK,CAAA;AAAA,IAC9B;AAEA,IAAA,MAAM,aAAa,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAE5E,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,OAAO,IAAA,CAAK,kBAAA,CAAmC,QAAA,EAAU,UAAU,CAAA;AAAA,IACrE;AAEA,IAAA,MAAM,WAAA,GAAc,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,cAAc,CAAA,IAAK,EAAA;AAC5D,IAAA,IAAI,WAAA,CAAY,QAAA,CAAS,kBAAkB,CAAA,EAAG;AAC5C,MAAA,OAAO,IAAA,CAAK,kBAAA,CAAmC,QAAA,EAAU,UAAU,CAAA;AAAA,IACrE;AAEA,IAAA,MAAM,cAAA,GAAiB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAA;AACzD,IAAA,MAAM,iBACJ,cAAA,KAAmB,IAAA,GAAO,OAAO,QAAA,CAAS,cAAA,EAAgB,EAAE,CAAA,GAAI,MAAA;AAElE,IAAA,MAAM,MAAA,GAAS,iBAAA,CAAqB,QAAA,CAAS,IAAI,CAAA;AACjD,IAAA,MAAM,IAAA,GAAO,sBAAA,CAAuB,MAAA,EAAQ,cAAc,CAAA;AAE1D,IAAA,OAAO;AAAA,MACL,IAAA;AAAA,MACA,KAAA,EAAO;AAAA,KACT;AAAA,EACF;AAAA,EAEQ,YAAA,GAAuC;AAC7C,IAAA,OAAO;AAAA,MACL,WAAA,EAAa,KAAK,OAAA,CAAQ,MAAA;AAAA,MAC1B,MAAA,EAAQ;AAAA,KACV;AAAA,EACF;AAAA,EAEA,MAAc,WAAA,CACZ,GAAA,EACA,IAAA,EACyB;AACzB,IAAA,IAAI,QAAA;AAEJ,IAAA,IAAI;AACF,MAAA,QAAA,GAAW,MAAM,IAAA,CAAK,cAAA,CAAe,GAAA,EAAK,IAAI,CAAA;AAAA,IAChD,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,iBAAiB,KAAK,CAAA;AAAA,IAC9B;AAEA,IAAA,MAAM,aAAa,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAE5E,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,OAAO,IAAA,CAAK,kBAAA,CAAsB,QAAA,EAAU,UAAU,CAAA;AAAA,IACxD;AAEA,IAAA,IAAI,IAAA;AACJ,IAAA,IAAI;AACF,MAAA,IAAA,GAAO,MAAM,SAAS,IAAA,EAAK;AAAA,IAC7B,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,mBAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AAEA,IAAA,IAAI,kBAAA,CAAmB,IAAI,CAAA,EAAG;AAC5B,MAAA,OAAO,cAAc,UAAA,CAAW,IAAA,EAAM,QAAA,CAAS,MAAA,EAAQ,UAAU,CAAC,CAAA;AAAA,IACpE;AAEA,IAAA,IAAI,oBAAA,CAAwB,IAAI,CAAA,EAAG;AACjC,MAAA,OAAO,eAAA,CAAgB,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,IAAI,CAAA;AAAA,IAC7C;AAEA,IAAA,MAAM,IAAI,oBAAoB,+CAA+C,CAAA;AAAA,EAC/E;AAAA,EAEA,MAAc,kBAAA,CACZ,QAAA,EACA,UAAA,EACyB;AACzB,IAAA,IAAI,IAAA,GAAgB,IAAA;AAEpB,IAAA,IAAI;AACF,MAAA,IAAA,GAAO,MAAM,SAAS,IAAA,EAAK;AAAA,IAC7B,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,aAAA,CAAc;AAAA,QACnB,IAAA,EAAM,gBAAA;AAAA,QACN,OAAA,EAAS,CAAA,2BAAA,EAA8B,MAAA,CAAO,QAAA,CAAS,MAAM,CAAC,CAAA,CAAA,CAAA;AAAA,QAC9D,QAAQ,QAAA,CAAS,MAAA;AAAA,QACjB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe;AAAC,OAClD,CAAA;AAAA,IACH;AAEA,IAAA,IAAI,kBAAA,CAAmB,IAAI,CAAA,EAAG;AAC5B,MAAA,OAAO,cAAc,UAAA,CAAW,IAAA,EAAM,QAAA,CAAS,MAAA,EAAQ,UAAU,CAAC,CAAA;AAAA,IACpE;AAEA,IAAA,OAAO,aAAA,CAAc;AAAA,MACnB,IAAA,EAAM,gBAAA;AAAA,MACN,OAAA,EAAS,CAAA,2BAAA,EAA8B,MAAA,CAAO,QAAA,CAAS,MAAM,CAAC,CAAA,CAAA,CAAA;AAAA,MAC9D,QAAQ,QAAA,CAAS,MAAA;AAAA,MACjB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe;AAAC,KAClD,CAAA;AAAA,EACH;AAAA,EAEA,MAAc,cAAA,CAAe,GAAA,EAAa,IAAA,EAAsC;AAC9E,IAAA,MAAM,EAAE,UAAA,EAAY,OAAA,EAAS,KAAA,KAAU,IAAA,CAAK,OAAA;AAC5C,IAAA,IAAI,OAAA,GAAU,CAAA;AAEd,IAAA,IAAI,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,MAC9B,GAAG,IAAA;AAAA,MACH,MAAA,EAAQ,WAAA,CAAY,OAAA,CAAQ,OAAO;AAAA,KACpC,CAAA;AAED,IAAA,OACE,UAAU,UAAA,KACT,QAAA,CAAS,WAAW,GAAA,IAAO,QAAA,CAAS,UAAU,GAAA,CAAA,EAC/C;AACA,MAAA,MAAM,aAAa,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAC5E,MAAA,MAAM,UACJ,UAAA,KAAe,MAAA,GAAY,UAAA,GAAa,GAAA,GAAO,mBAAmB,OAAO,CAAA;AAE3E,MAAA,OAAA,IAAW,CAAA;AACX,MAAA,MAAM,MAAM,OAAO,CAAA;AAEnB,MAAA,QAAA,GAAW,MAAM,MAAM,GAAA,EAAK;AAAA,QAC1B,GAAG,IAAA;AAAA,QACH,MAAA,EAAQ,WAAA,CAAY,OAAA,CAAQ,OAAO;AAAA,OACpC,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,QAAA;AAAA,EACT;AACF;AAEA,SAAS,iBAAiB,KAAA,EAAqC;AAC7D,EAAA,IAAI,iBAAiB,KAAA,EAAO;AAC1B,IAAA,OAAO,IAAI,mBAAA,CAAoB,CAAA,wBAAA,EAA2B,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AAAA,EAC3E;AAEA,EAAA,OAAO,IAAI,oBAAoB,yBAAyB,CAAA;AAC1D;AAEA,SAAS,sBAAA,CACP,QACA,QAAA,EACgB;AAChB,EAAA,MAAM,WAAA,GAA8B;AAAA,IAClC,QAAQ,MAAA,CAAO,aAAa,CAAA,GAAI;AAC9B,MAAA,WAAA,MAAiB,OAAO,MAAA,EAAQ;AAC9B,QAAA,MAAM,GAAA;AAAA,MACR;AAAA,IACF;AAAA,GACF;AAEA,EAAA,IAAI,aAAa,MAAA,IAAa,CAAC,MAAA,CAAO,KAAA,CAAM,QAAQ,CAAA,EAAG;AACrD,IAAA,WAAA,CAAY,QAAA,GAAW,QAAA;AAAA,EACzB;AAEA,EAAA,OAAO,WAAA;AACT;AAOO,SAAS,kBAAqB,MAAA,EAA8C;AACjF,EAAA,IAAI,OAAO,MAAA,KAAW,QAAA,IAAY,UAAA,IAAc,MAAA,EAAQ;AACtD,IAAA,MAAM,QAAS,MAAA,CAA0B,QAAA;AACzC,IAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,MAAA;AAAA,EAC7C;AAEA,EAAA,OAAO,MAAA;AACT;;;AC7OA,SAAS,oBAAA,CACP,IAAA,EACA,SAAA,EACA,UAAA,EAGsB;AACtB,EAAA,MAAM,QAAA,IAAY,CAAC,UAAA,EAAoB,MAAA,GAAY,EAAC,KAAW;AAC7D,IAAA,OAAO,KAAK,QAAA,CAAY;AAAA,MACtB,IAAA,EAAM,UAAU,UAAU,CAAA;AAAA,MAC1B,KAAA,EAAO,WAAW,MAAM;AAAA,KACzB,CAAA;AAAA,EACH,CAAA,CAAA;AAEA,EAAA,QAAA,CAAS,OAAA,GAAU,OAAO,UAAA,EAAoB,MAAA,GAAY,EAAC,KAAW;AACpE,IAAA,MAAM,QAAA,GAAW,MAAM,QAAA,CAAS,UAAA,EAAY,MAAM,CAAA;AAElD,IAAA,IAAI,QAAA,CAAS,KAAA,IAAS,CAAC,QAAA,CAAS,IAAA,EAAM;AACpC,MAAA,OAAO;AAAA,QACL,IAAA,EAAM,IAAA;AAAA,QACN,OAAO,QAAA,CAAS,KAAA;AAAA,QAChB,MAAM,QAAA,CAAS;AAAA,OACjB;AAAA,IACF;AAEA,IAAA,MAAM,SAAA,GAAY,MAAM,mBAAA,CAAoB,QAAA,CAAS,IAAI,CAAA;AAEzD,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,SAAA;AAAA,MACN,KAAA,EAAO,IAAA;AAAA,MACP,MAAM,QAAA,CAAS;AAAA,KACjB;AAAA,EACF,CAAA;AAEA,EAAA,OAAO,QAAA;AACT;AAGO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA,EAAnB,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAc7B,IAAA,GAAuC;AACrC,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA,CAAc,EAAE,IAAA,EAAM,SAAS,CAAA;AAAA,EAClD;AACF,CAAA;AAGO,IAAM,oBAAN,MAAwB;AAAA,EAC7B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA,EAAnB,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAc7B,IAAA,CAAK,MAAA,GAA6B,EAAC,EAA2C;AAC5E,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAsB;AAAA,MACrC,IAAA,EAAM,YAAA;AAAA,MACN,KAAA,EAAO;AAAA,QACL,MAAM,MAAA,CAAO,IAAA;AAAA,QACb,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,WAAW,MAAA,CAAO;AAAA;AACpB,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,IAAI,UAAA,EAA0D;AAC5D,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAoB;AAAA,MACnC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA;AAAA,KACnD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,OAAO,OAAA,CACL,MAAA,GAA2C,EAAC,EACmB;AAC/D,IAAA,IAAI,IAAA,GAAO,CAAA;AACX,IAAA,IAAI,UAAA,GAAa,CAAA;AAEjB,IAAA,OAAO,QAAQ,UAAA,EAAY;AACzB,MAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,CAAK,EAAE,GAAG,MAAA,EAAQ,MAAM,CAAA;AAEpD,MAAA,IAAI,QAAA,CAAS,KAAA,IAAS,CAAC,QAAA,CAAS,IAAA,EAAM;AACpC,QAAA;AAAA,MACF;AAEA,MAAA,KAAA,MAAW,IAAA,IAAQ,QAAA,CAAS,IAAA,CAAK,KAAA,EAAO;AACtC,QAAA,MAAM,IAAA;AAAA,MACR;AAEA,MAAA,UAAA,GAAa,QAAA,CAAS,KAAK,UAAA,CAAW,UAAA;AACtC,MAAA,IAAA,IAAQ,CAAA;AAAA,IACV;AAAA,EACF;AACF,CAAA;AAYO,IAAM,kBAAN,MAAsB;AAAA,EAO3B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,wBAAA,CAAyB,IAAI,CAAA;AAClD,IAAA,IAAA,CAAK,UAAA,GAAa,IAAI,yBAAA,CAA0B,IAAI,CAAA;AAAA,EACtD;AAAA,EAH6B,IAAA;AAAA;AAAA,EALpB,SAAA;AAAA;AAAA,EAGA,UAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBT,QAAA,CACE,UAAA,EACA,MAAA,GAA0B,EAAC,EACY;AACvC,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAqB;AAAA,MACpC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,iBAAA,CAAA;AAAA,MAClD,KAAA,EAAO;AAAA,QACL,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO;AAAA;AAClB,KACD,CAAA;AAAA,EACH;AACF,CAAA;AAOO,IAAM,2BAAN,MAA+B;AAAA,EAQpC,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,MAAA,GAAS,oBAAA;AAAA,MACZ,IAAA;AAAA,MACA,CAAC,UAAA,KACC,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,yBAAA,CAAA;AAAA,MAC9C,CAAC,MAAA,MAAY;AAAA,QACX,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO;AAAA,OAClB;AAAA,KACF;AAAA,EACF;AAAA,EAV6B,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAFpB,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBT,IAAA,CACE,UAAA,EACA,MAAA,GAA8B,EAAC,EACU;AACzC,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAuB;AAAA,MACtC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,kBAAA,CAAA;AAAA,MAClD,KAAA,EAAO;AAAA,QACL,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO,OAAA;AAAA,QAChB,MAAM,MAAA,CAAO,IAAA;AAAA,QACb,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,WAAW,MAAA,CAAO;AAAA;AACpB,KACD,CAAA;AAAA,EACH;AACF,CAAA;AAOO,IAAM,4BAAN,MAAgC;AAAA,EAQrC,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,MAAA,GAAS,oBAAA;AAAA,MACZ,IAAA;AAAA,MACA,CAAC,UAAA,KACC,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,0BAAA,CAAA;AAAA,MAC9C,CAAC,MAAA,MAAY;AAAA,QACX,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO,OAAA;AAAA,QAChB,mBAAmB,MAAA,CAAO;AAAA,OAC5B;AAAA,KACF;AAAA,EACF;AAAA,EAX6B,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAFpB,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBT,IAAA,CACE,UAAA,EACA,MAAA,GAA+B,EAAC,EACU;AAC1C,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAwB;AAAA,MACvC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,mBAAA,CAAA;AAAA,MAClD,KAAA,EAAO;AAAA,QACL,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO,OAAA;AAAA,QAChB,MAAM,MAAA,CAAO,IAAA;AAAA,QACb,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,mBAAmB,MAAA,CAAO;AAAA;AAC5B,KACD,CAAA;AAAA,EACH;AACF,CAAA;;;ACzTO,IAAM,YAAN,MAAgB;AAAA;AAAA,EAEZ,IAAA;AAAA;AAAA,EAGA,SAAA;AAAA;AAAA,EAGA,OAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,YAAY,OAAA,EAA2B;AACrC,IAAA,MAAM,IAAA,GAAO,IAAI,UAAA,CAAW,OAAO,CAAA;AACnC,IAAA,MAAM,YAAA,GAAe,IAAI,YAAA,CAAa,IAAI,CAAA;AAE1C,IAAA,IAAA,CAAK,IAAA,GAAO,YAAA,CAAa,IAAA,CAAK,IAAA,CAAK,YAAY,CAAA;AAC/C,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,iBAAA,CAAkB,IAAI,CAAA;AAC3C,IAAA,IAAA,CAAK,OAAA,GAAU,IAAI,eAAA,CAAgB,IAAI,CAAA;AAAA,EACzC;AACF","file":"index.js","sourcesContent":["export const DEFAULT_BASE_URL = 'https://api.getsoundlink.com';\n\nexport const DEFAULT_TIMEOUT_MS = 30_000;\n\nexport const DEFAULT_MAX_RETRIES = 2;\n\nexport const API_KEY_PREFIX = 'sk_';\n\nexport const CAMPAIGNS_MAX_PAGE_SIZE = 100;\n\nexport const METRICS_MAX_PAGE_SIZE = 500;\n\nexport const METRICS_DEFAULT_PAGE_SIZE = 50;\n\nexport const CAMPAIGNS_DEFAULT_PAGE_SIZE = 10;\n\nexport const API_VERSION_PREFIX = '/v1';\n","import type {\n ApiEnvelopeError,\n ApiEnvelopeSuccess,\n ApiMeta,\n ApiError,\n ApiResponse,\n PublicApiErrorCode,\n} from '../types/api.js';\n\nexport function isApiEnvelopeError(body: unknown): body is ApiEnvelopeError {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return (\n typeof record.error === 'object' &&\n record.error !== null &&\n typeof (record.error as Record<string, unknown>).code === 'string' &&\n typeof (record.error as Record<string, unknown>).message === 'string'\n );\n}\n\nexport function isApiEnvelopeSuccess<T>(body: unknown): body is ApiEnvelopeSuccess<T> {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return 'data' in record && typeof record.meta === 'object' && record.meta !== null;\n}\n\nexport function toApiError(\n envelope: ApiEnvelopeError,\n status: number,\n retryAfter?: number,\n): ApiError {\n 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 };\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 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 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 buildHeaders(): Record<string, string> {\n return {\n 'x-api-key': this.options.apiKey,\n Accept: 'application/json',\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 CampaignDetail,\n CampaignListData,\n CampaignListParams,\n DateRangeParams,\n EngagementExportParams,\n EngagementListData,\n EngagementListParams,\n EngagementRow,\n ExportCollection,\n MetricsOverview,\n PingData,\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/** Campaign listing and detail (`/v1/campaigns/*`). Requires `campaigns:read`. */\nexport class CampaignsResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * List campaigns for the authenticated organization.\n *\n * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**.\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}`.\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 * 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 breakdown and 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`.\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 /**\n * Paginated per-day, per-track engagement rows.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param campaignId - Campaign identifier.\n * @param params - Date range, pagination, sort, and optional `engagementContext` filter.\n */\n list(\n campaignId: string,\n params: EngagementListParams = {},\n ): Promise<ApiResponse<EngagementListData>> {\n return this.http.get<EngagementListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement`,\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 engagementContext: params.engagementContext,\n },\n });\n }\n}\n","import { HttpClient } from './http-client.js';\nimport {\n CampaignsResource,\n MetricsResource,\n PingResource,\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 /** List and fetch campaigns. Requires `campaigns:read` scope. */\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.campaigns = new CampaignsResource(http);\n this.metrics = new MetricsResource(http);\n }\n}\n\nexport { HttpClient, resolveClientOptions } from './http-client.js';\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "soundlink",
3
- "version": "1.1.0",
3
+ "version": "1.1.1",
4
4
  "description": "Official TypeScript SDK for the Soundlink Public API",
5
5
  "license": "MIT",
6
6
  "type": "module",