soundlink 2.4.0 → 2.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # soundlink
2
2
 
3
+ ## 2.6.0
4
+
5
+ ### Minor Changes
6
+
7
+ - [#33](https://github.com/Fan-ID/typescript-sdk/pull/33) [`a251c84`](https://github.com/Fan-ID/typescript-sdk/commit/a251c8444945bdfce96876b1682299d58a59cf29) Thanks [@jotanarciso](https://github.com/jotanarciso)! - Add `pixels.list`, `pixels.update`, and `pixels.sendTestEvent` for `/v1/pixels` (SOU-7393). Requires `pixels:read` / `pixels:write`.
8
+
9
+ ## 2.5.0
10
+
11
+ ### Minor Changes
12
+
13
+ - [#27](https://github.com/Fan-ID/typescript-sdk/pull/27) [`7cf85a7`](https://github.com/Fan-ID/typescript-sdk/commit/7cf85a7277a6d1a070de8a872249ca365a12a079) Thanks [@jotanarciso](https://github.com/jotanarciso)! - Add `campaigns.activity` (`GET /v1/campaigns/{id}/activity`) and `metrics.creativeDaily` (`GET /v1/campaigns/{id}/metrics/creative-daily`). Creative variants include `timestamp_start_ms` and `timestamp_end_ms`.
14
+
15
+ - [#29](https://github.com/Fan-ID/typescript-sdk/pull/29) [`3abddcb`](https://github.com/Fan-ID/typescript-sdk/commit/3abddcb4b6fab4c0007cb3aba6f9b74b87a44dc0) Thanks [@jotanarciso](https://github.com/jotanarciso)! - Sync Public API field types with schema 1.1 and recent campaign/soundlink additions (SOU-7393): `nextRenewalAt`, overview/breakdown `total_listeners` (and breakdown new/returning splits), tier `learningStatus` / `acknowledgeLearningWarning`, and soundlink `attributionEnabled`. Re-sync the bundled OpenAPI spec.
16
+
3
17
  ## 2.4.0
4
18
 
5
19
  ### Minor Changes
package/README.md CHANGED
@@ -86,6 +86,10 @@ const { data, error } = await soundlink.campaigns.list({
86
86
  const { data: campaign } = await soundlink.campaigns.get('camp_abc123');
87
87
  // campaign.generation === 3 → wallet (writable)
88
88
 
89
+ const { data: activity } = await soundlink.campaigns.activity('camp_abc123', {
90
+ startDate: '2026-03-01',
91
+ });
92
+
89
93
  // Async iterator across all pages
90
94
  for await (const item of soundlink.campaigns.listAll({ pageSize: 100 })) {
91
95
  console.log(item.campaignId, item.generation);
@@ -146,6 +150,19 @@ const { data: wallet } = await soundlink.wallet.get();
146
150
  // wallet.available is balance minus reserved
147
151
  ```
148
152
 
153
+ ### Pixels (`pixels:read` / `pixels:write`)
154
+
155
+ ```typescript
156
+ const { data: pixels } = await soundlink.pixels.list();
157
+
158
+ await soundlink.pixels.update('1234567890123456', {
159
+ platform: 'meta',
160
+ accessToken: process.env.META_CAPI_TOKEN!,
161
+ });
162
+
163
+ await soundlink.pixels.sendTestEvent('1234567890123456');
164
+ ```
165
+
149
166
  Custom strategy create (requires `tierTargeting`):
150
167
 
151
168
  ```typescript
@@ -218,6 +235,11 @@ const { data: overview } = await soundlink.metrics.overview('camp_abc123', {
218
235
  const { data: creatives } = await soundlink.metrics.creatives('camp_abc123');
219
236
  // lifetime snapshot, grouped by background video. No date range.
220
237
 
238
+ const { data: creativeDaily } = await soundlink.metrics.creativeDaily('camp_abc123', {
239
+ startDate: '2026-03-01',
240
+ endDate: '2026-03-31',
241
+ });
242
+
221
243
  const { data: breakdown } = await soundlink.metrics.breakdown.list('camp_abc123', {
222
244
  page: 1,
223
245
  pageSize: 50,
@@ -511,6 +511,62 @@ var StrategiesResource = class {
511
511
  return this.http.get({ path: "/strategies" });
512
512
  }
513
513
  };
514
+ var PixelsResource = class {
515
+ constructor(http) {
516
+ this.http = http;
517
+ }
518
+ http;
519
+ /**
520
+ * List Meta pixels saved for the organization.
521
+ *
522
+ * Maps to `GET /v1/pixels`. Requires `pixels:read`.
523
+ * Returns `403 custom_pixel_not_enabled` when the feature is off.
524
+ *
525
+ * @example
526
+ * ```ts
527
+ * const { data } = await soundlink.pixels.list();
528
+ * ```
529
+ */
530
+ list() {
531
+ return this.http.get({ path: "/pixels" });
532
+ }
533
+ /**
534
+ * Save or rotate a Meta pixel access token.
535
+ *
536
+ * Maps to `PUT /v1/pixels/{pixelId}`. Requires `pixels:write`.
537
+ * Does not require an `Idempotency-Key`. The access token is never returned.
538
+ *
539
+ * @example
540
+ * ```ts
541
+ * const { data } = await soundlink.pixels.update('1234567890123456', {
542
+ * platform: 'meta',
543
+ * accessToken: process.env.META_CAPI_TOKEN!,
544
+ * });
545
+ * ```
546
+ */
547
+ update(pixelId, body) {
548
+ return this.http.put({
549
+ path: `/pixels/${encodeURIComponent(pixelId)}`,
550
+ body
551
+ });
552
+ }
553
+ /**
554
+ * Send a live Meta Conversions API test event to a saved pixel.
555
+ *
556
+ * Maps to `POST /v1/pixels/{pixelId}/test-events`. Requires `pixels:write`.
557
+ * This is not a sandbox event — it appears in Events Manager.
558
+ *
559
+ * @example
560
+ * ```ts
561
+ * const { data } = await soundlink.pixels.sendTestEvent('1234567890123456');
562
+ * ```
563
+ */
564
+ sendTestEvent(pixelId) {
565
+ return this.http.post({
566
+ path: `/pixels/${encodeURIComponent(pixelId)}/test-events`
567
+ });
568
+ }
569
+ };
514
570
  var CampaignTiersResource = class {
515
571
  constructor(http) {
516
572
  this.http = http;
@@ -584,6 +640,22 @@ var CampaignsResource = class {
584
640
  path: `/campaigns/${encodeURIComponent(campaignId)}`
585
641
  });
586
642
  }
643
+ /**
644
+ * Page of creative adds, budget changes, and other campaign events.
645
+ *
646
+ * Maps to `GET /v1/campaigns/{campaignId}/activity`. Requires `campaigns:read`.
647
+ * Omit `startDate` for the full history. Max `pageSize` is **100**.
648
+ */
649
+ activity(campaignId, params = {}) {
650
+ return this.http.get({
651
+ path: `/campaigns/${encodeURIComponent(campaignId)}/activity`,
652
+ query: {
653
+ startDate: params.startDate,
654
+ page: params.page,
655
+ pageSize: params.pageSize
656
+ }
657
+ });
658
+ }
587
659
  /**
588
660
  * Create a wallet-funded campaign.
589
661
  *
@@ -927,6 +999,24 @@ var MetricsResource = class {
927
999
  path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/creatives`
928
1000
  });
929
1001
  }
1002
+ /**
1003
+ * One row per day and Meta ad creative.
1004
+ *
1005
+ * Maps to `GET /v1/campaigns/{campaignId}/metrics/creative-daily`.
1006
+ * Requires `metrics:read`. Omit both dates for every day that has rows.
1007
+ * Max `pageSize` is **500**.
1008
+ */
1009
+ creativeDaily(campaignId, params = {}) {
1010
+ return this.http.get({
1011
+ path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/creative-daily`,
1012
+ query: {
1013
+ startDate: params.startDate,
1014
+ endDate: params.endDate,
1015
+ page: params.page,
1016
+ pageSize: params.pageSize
1017
+ }
1018
+ });
1019
+ }
930
1020
  };
931
1021
  var BreakdownMetricsResource = class {
932
1022
  constructor(http) {
@@ -1000,6 +1090,8 @@ var Soundlink = class {
1000
1090
  wallet;
1001
1091
  /** Growth strategy catalog. Requires `campaigns:read` scope. */
1002
1092
  strategies;
1093
+ /** Organization Meta pixels. Read needs `pixels:read`; write needs `pixels:write`. */
1094
+ pixels;
1003
1095
  /** List, fetch, and manage campaigns. Read needs `campaigns:read`; writes need `campaigns:write`. */
1004
1096
  campaigns;
1005
1097
  /** Self-serve soundlinks. Read needs `soundlinks:read`; create/delete need `soundlinks:write`. */
@@ -1017,6 +1109,7 @@ var Soundlink = class {
1017
1109
  this.ping = pingResource.ping.bind(pingResource);
1018
1110
  this.wallet = new WalletResource(http);
1019
1111
  this.strategies = new StrategiesResource(http);
1112
+ this.pixels = new PixelsResource(http);
1020
1113
  this.campaigns = new CampaignsResource(http);
1021
1114
  this.soundlinks = new SoundlinksResource(http);
1022
1115
  this.metrics = new MetricsResource(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":";;;AAAO,IAAM,gBAAA,GAAmB;AAEzB,IAAM,kBAAA,GAAqB;AAE3B,IAAM,mBAAA,GAAsB;AAE5B,IAAM,cAAA,GAAiB;AAEvB,IAAM,uBAAA,GAA0B;AAEhC,IAAM,wBAAA,GAA2B;AAEjC,IAAM,qBAAA,GAAwB;AAQ9B,IAAM,kBAAA,GAAqB,KAAA;;;ACX3B,SAAS,mBAAmB,IAAA,EAAyC;AAC1E,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,KAAS,IAAA,EAAM;AAC7C,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,IAAA;AACf,EAAA,OACE,OAAO,MAAA,CAAO,KAAA,KAAU,QAAA,IACxB,OAAO,KAAA,KAAU,IAAA,IACjB,OAAQ,MAAA,CAAO,MAAkC,IAAA,KAAS,QAAA,IAC1D,OAAQ,MAAA,CAAO,MAAkC,OAAA,KAAY,QAAA;AAEjE;AAEO,SAAS,qBAAwB,IAAA,EAA8C;AACpF,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,KAAS,IAAA,EAAM;AAC7C,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,IAAA;AACf,EAAA,OAAO,UAAU,MAAA,IAAU,OAAO,OAAO,IAAA,KAAS,QAAA,IAAY,OAAO,IAAA,KAAS,IAAA;AAChF;AAEO,SAAS,UAAA,CACd,QAAA,EACA,MAAA,EACA,UAAA,EACU;AACV,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,QAAA,CAAS,KAAA;AAE7B,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAS,KAAA,CAAM,IAAA;AAAA,IACrB,OAAA,EAAS,SAAS,KAAA,CAAM,OAAA;AAAA,IACxB,MAAA;AAAA,IACA,SAAA,EAAW,SAAS,IAAA,CAAK,SAAA;AAAA,IACzB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe,EAAC;AAAA,IACjD,GAAI,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,KAAY;AAAC,GAC7C;AACF;AAEO,SAAS,eAAA,CAAmB,MAAS,IAAA,EAA+B;AACzE,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,KAAA,EAAO,IAAA;AAAA,IACP;AAAA,GACF;AACF;AAEO,SAAS,cAAiB,KAAA,EAAiC;AAChE,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,IAAA;AAAA,IACN,KAAA;AAAA,IACA,GAAI,KAAA,CAAM,SAAA,GAAY,EAAE,IAAA,EAAM,EAAE,SAAA,EAAW,KAAA,CAAM,SAAA,EAAU,EAAE,GAAI;AAAC,GACpE;AACF;AAEO,SAAS,sBAAsB,KAAA,EAA0C;AAC9E,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,QAAA,CAAS,KAAA,EAAO,EAAE,CAAA;AACzC,EAAA,IAAI,MAAA,CAAO,QAAA,CAAS,OAAO,CAAA,IAAK,WAAW,CAAA,EAAG;AAC5C,IAAA,OAAO,OAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA;AAC/B,EAAA,IAAI,MAAA,CAAO,QAAA,CAAS,MAAM,CAAA,EAAG;AAC3B,IAAA,MAAM,eAAe,IAAA,CAAK,IAAA,CAAA,CAAM,SAAS,IAAA,CAAK,GAAA,MAAS,GAAI,CAAA;AAC3D,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,YAAA,EAAc,CAAC,CAAA;AAAA,EACjC;AAEA,EAAA,OAAO,MAAA;AACT;;;AC7EO,IAAM,iBAAA,GAAN,MAAM,kBAAA,SAA0B,KAAA,CAAM;AAAA,EAC3C,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,mBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,kBAAA,CAAkB,SAAS,CAAA;AAAA,EACzD;AACF;AAGO,IAAM,mBAAA,GAAN,MAAM,oBAAA,SAA4B,iBAAA,CAAkB;AAAA,EACzD,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,qBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,oBAAA,CAAoB,SAAS,CAAA;AAAA,EAC3D;AACF;AAGO,IAAM,oBAAA,GAAN,MAAM,qBAAA,SAA6B,iBAAA,CAAkB;AAAA,EAC1D,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,qBAAA,CAAqB,SAAS,CAAA;AAAA,EAC5D;AACF;;;AC3BA,gBAAuB,iBAAA,CACrB,MACA,eAAA,EACmB;AACnB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,MAAA,GAAS,KAAK,SAAA,EAAU;AAC9B,EAAA,MAAM,OAAA,GAAU,IAAI,WAAA,EAAY;AAChC,EAAA,IAAI,MAAA,GAAS,EAAA;AAEb,EAAA,IAAI;AACF,IAAA,WAAS;AACP,MAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,MAAA,IAAI,IAAA,EAAM;AACR,QAAA;AAAA,MACF;AAEA,MAAA,MAAA,IAAU,QAAQ,MAAA,CAAO,KAAA,EAAO,EAAE,MAAA,EAAQ,MAAM,CAAA;AAChD,MAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA;AAC/B,MAAA,MAAA,GAAS,KAAA,CAAM,KAAI,IAAK,EAAA;AAExB,MAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,QAAA,MAAM,OAAA,GAAU,KAAK,IAAA,EAAK;AAC1B,QAAA,IAAI,CAAC,OAAA,EAAS;AACZ,UAAA;AAAA,QACF;AAEA,QAAA,IAAI;AACF,UAAA,MAAM,IAAA,CAAK,MAAM,OAAO,CAAA;AAAA,QAC1B,SAAS,KAAA,EAAO;AACd,UAAA,eAAA,GAAkB,SAAS,KAAK,CAAA;AAChC,UAAA,MAAM,IAAI,oBAAoB,oCAAoC,CAAA;AAAA,QACpE;AAAA,MACF;AAAA,IACF;AAEA,IAAA,MAAM,QAAA,GAAW,OAAO,IAAA,EAAK;AAC7B,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAK,MAAM,QAAQ,CAAA;AAAA,MAC3B,SAAS,KAAA,EAAO;AACd,QAAA,eAAA,GAAkB,UAAU,KAAK,CAAA;AACjC,QAAA,MAAM,IAAI,oBAAoB,oCAAoC,CAAA;AAAA,MACpE;AAAA,IACF;AAAA,EACF,CAAA,SAAE;AACA,IAAA,MAAA,CAAO,WAAA,EAAY;AAAA,EACrB;AACF;AAEA,eAAsB,oBACpB,MAAA,EAC0C;AAC1C,EAAA,MAAM,OAAY,EAAC;AACnB,EAAA,WAAA,MAAiB,OAAO,MAAA,EAAQ;AAC9B,IAAA,IAAA,CAAK,KAAK,GAAG,CAAA;AAAA,EACf;AACA,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,UAAU,IAAA,CAAK;AAAA,GACjB;AACF;;;ACjEO,SAAS,iBACd,MAAA,EACQ;AACR,EAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AAEzC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AACjD,IAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,IAAQ,UAAU,EAAA,EAAI;AACzD,MAAA;AAAA,IACF;AACA,IAAA,YAAA,CAAa,GAAA,CAAI,GAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACrC;AAEA,EAAA,MAAM,KAAA,GAAQ,aAAa,QAAA,EAAS;AACpC,EAAA,OAAO,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAA;AAC/B;AAEO,SAAS,OAAA,CAAQ,SAAiB,IAAA,EAAsB;AAC7D,EAAA,MAAM,cAAA,GAAiB,QAAQ,QAAA,CAAS,GAAG,IAAI,OAAA,CAAQ,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAAI,OAAA;AACtE,EAAA,MAAM,iBAAiB,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA,GAAI,IAAA,GAAO,IAAI,IAAI,CAAA,CAAA;AAC7D,EAAA,OAAO,CAAA,EAAG,cAAc,CAAA,EAAG,cAAc,CAAA,CAAA;AAC3C;AAEO,SAAS,MAAM,EAAA,EAA2B;AAC/C,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY;AAC9B,IAAA,UAAA,CAAW,SAAS,EAAE,CAAA;AAAA,EACxB,CAAC,CAAA;AACH;AAEO,SAAS,mBAAmB,OAAA,EAAyB;AAC1D,EAAA,MAAM,IAAA,GAAO,GAAA;AACb,EAAA,MAAM,SAAS,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,GAAG,CAAA;AAC7C,EAAA,OAAO,IAAA,GAAO,KAAK,OAAA,GAAU,MAAA;AAC/B;;;AC0BO,SAAS,qBACd,OAAA,EACgC;AAChC,EAAA,MAAM,aAAa,OAAO,OAAA,KAAY,WAAW,EAAE,MAAA,EAAQ,SAAQ,GAAI,OAAA;AAEvE,EAAA,MAAM,MAAA,GAAS,UAAA,CAAW,MAAA,CAAO,IAAA,EAAK;AACtC,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,qBAAqB,qBAAqB,CAAA;AAAA,EACtD;AAEA,EAAA,IAAI,CAAC,MAAA,CAAO,UAAA,CAAW,cAAc,CAAA,EAAG;AACtC,IAAA,MAAM,IAAI,oBAAA;AAAA,MACR,yDAAyD,cAAc,CAAA,EAAA;AAAA,KACzE;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,OAAA,EAAS,WAAW,OAAA,IAAW,gBAAA;AAAA,IAC/B,OAAA,EAAS,WAAW,OAAA,IAAW,kBAAA;AAAA,IAC/B,UAAA,EAAY,WAAW,UAAA,IAAc,mBAAA;AAAA,IACrC,OAAO,UAAA,CAAW,KAAA,IAAS,UAAA,CAAW,KAAA,CAAM,KAAK,UAAU;AAAA,GAC7D;AACF;AAEO,IAAM,aAAN,MAAiB;AAAA,EACL,OAAA;AAAA,EAEjB,YAAY,OAAA,EAA2B;AACrC,IAAA,IAAA,CAAK,OAAA,GAAU,qBAAqB,OAAO,CAAA;AAAA,EAC7C;AAAA,EAEA,IAAI,eAAA,GAAkD;AACpD,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,MAAM,GAAA,CAAO,EAAE,IAAA,EAAM,OAAM,EAA4C;AACrE,IAAA,MAAM,GAAA,GAAM,OAAA;AAAA,MACV,KAAK,OAAA,CAAQ,OAAA;AAAA,MACb,CAAA,EAAG,kBAAkB,CAAA,EAAG,IAAI,GAAG,gBAAA,CAAiB,KAAA,IAAS,EAAE,CAAC,CAAA;AAAA,KAC9D;AAEA,IAAA,OAAO,IAAA,CAAK,YAAe,GAAA,EAAK;AAAA,MAC9B,MAAA,EAAQ,KAAA;AAAA,MACR,OAAA,EAAS,KAAK,YAAA;AAAa,KAC5B,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,IAAA,CAAQ;AAAA,IACZ,IAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA;AAAA,IACA,OAAA;AAAA,IACA;AAAA,GACF,EAAiD;AAC/C,IAAA,OAAO,IAAA,CAAK,WAAc,MAAA,EAAQ;AAAA,MAChC,IAAA;AAAA,MACA,IAAA;AAAA,MACA,KAAA;AAAA,MACA,OAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,KAAA,CAAS;AAAA,IACb,IAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA;AAAA,IACA,OAAA;AAAA,IACA;AAAA,GACF,EAAiD;AAC/C,IAAA,OAAO,IAAA,CAAK,WAAc,OAAA,EAAS;AAAA,MACjC,IAAA;AAAA,MACA,IAAA;AAAA,MACA,KAAA;AAAA,MACA,OAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,GAAA,CAAO;AAAA,IACX,IAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA;AAAA,IACA,OAAA;AAAA,IACA;AAAA,GACF,EAAiD;AAC/C,IAAA,OAAO,IAAA,CAAK,WAAc,KAAA,EAAO;AAAA,MAC/B,IAAA;AAAA,MACA,IAAA;AAAA,MACA,KAAA;AAAA,MACA,OAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,MAAA,CAAU;AAAA,IACd,IAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA;AAAA,IACA,OAAA;AAAA,IACA;AAAA,GACF,EAAiD;AAC/C,IAAA,OAAO,IAAA,CAAK,WAAc,QAAA,EAAU;AAAA,MAClC,IAAA;AAAA,MACA,IAAA;AAAA,MACA,KAAA;AAAA,MACA,OAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,QAAA,CAAY;AAAA,IAChB,IAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA,GAAS;AAAA,GACX,EAA2D;AACzD,IAAA,MAAM,GAAA,GAAM,OAAA;AAAA,MACV,KAAK,OAAA,CAAQ,OAAA;AAAA,MACb,CAAA,EAAG,kBAAkB,CAAA,EAAG,IAAI,GAAG,gBAAA,CAAiB,KAAA,IAAS,EAAE,CAAC,CAAA;AAAA,KAC9D;AAEA,IAAA,IAAI,QAAA;AACJ,IAAA,IAAI;AACF,MAAA,QAAA,GAAW,MAAM,IAAA,CAAK,cAAA,CAAe,GAAA,EAAK;AAAA,QACxC,MAAA,EAAQ,KAAA;AAAA,QACR,OAAA,EAAS;AAAA,UACP,GAAG,KAAK,YAAA,EAAa;AAAA,UACrB,MAAA,EAAQ;AAAA;AACV,OACD,CAAA;AAAA,IACH,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,iBAAiB,KAAK,CAAA;AAAA,IAC9B;AAEA,IAAA,MAAM,aAAa,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAE5E,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,OAAO,IAAA,CAAK,kBAAA,CAAmC,QAAA,EAAU,UAAU,CAAA;AAAA,IACrE;AAEA,IAAA,MAAM,WAAA,GAAc,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,cAAc,CAAA,IAAK,EAAA;AAC5D,IAAA,IAAI,WAAA,CAAY,QAAA,CAAS,kBAAkB,CAAA,EAAG;AAC5C,MAAA,OAAO,IAAA,CAAK,kBAAA,CAAmC,QAAA,EAAU,UAAU,CAAA;AAAA,IACrE;AAEA,IAAA,MAAM,cAAA,GAAiB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAA;AACzD,IAAA,MAAM,iBACJ,cAAA,KAAmB,IAAA,GAAO,OAAO,QAAA,CAAS,cAAA,EAAgB,EAAE,CAAA,GAAI,MAAA;AAElE,IAAA,MAAM,MAAA,GAAS,iBAAA,CAAqB,QAAA,CAAS,IAAI,CAAA;AACjD,IAAA,MAAM,IAAA,GAAO,sBAAA,CAAuB,MAAA,EAAQ,cAAc,CAAA;AAE1D,IAAA,OAAO;AAAA,MACL,IAAA;AAAA,MACA,KAAA,EAAO;AAAA,KACT;AAAA,EACF;AAAA,EAEQ,UAAA,CACN,QACA,EAAE,IAAA,EAAM,MAAM,KAAA,EAAO,OAAA,EAAS,gBAAe,EACpB;AACzB,IAAA,MAAM,GAAA,GAAM,OAAA;AAAA,MACV,KAAK,OAAA,CAAQ,OAAA;AAAA,MACb,CAAA,EAAG,kBAAkB,CAAA,EAAG,IAAI,GAAG,gBAAA,CAAiB,KAAA,IAAS,EAAE,CAAC,CAAA;AAAA,KAC9D;AAEA,IAAA,MAAM,cAAA,GAAiB,KAAK,YAAA,CAAa;AAAA,MACvC,GAAI,IAAA,KAAS,MAAA,GAAY,EAAE,cAAA,EAAgB,kBAAA,KAAuB,EAAC;AAAA,MACnE,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAE,iBAAA,EAAmB,cAAA,KAAmB,EAAC;AAAA,MAC5E,GAAG;AAAA,KACJ,CAAA;AAED,IAAA,OAAO,IAAA,CAAK,YAAe,GAAA,EAAK;AAAA,MAC9B,MAAA;AAAA,MACA,OAAA,EAAS,cAAA;AAAA,MACT,GAAI,IAAA,KAAS,MAAA,GAAY,EAAE,IAAA,EAAM,KAAK,SAAA,CAAU,IAAI,CAAA,EAAE,GAAI;AAAC,KAC5D,CAAA;AAAA,EACH;AAAA,EAEQ,YAAA,CAAa,KAAA,GAAgC,EAAC,EAA2B;AAC/E,IAAA,OAAO;AAAA,MACL,aAAA,EAAe,CAAA,OAAA,EAAU,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAA,CAAA;AAAA,MAC5C,MAAA,EAAQ,kBAAA;AAAA,MACR,GAAG;AAAA,KACL;AAAA,EACF;AAAA,EAEA,MAAc,WAAA,CACZ,GAAA,EACA,IAAA,EACyB;AACzB,IAAA,IAAI,QAAA;AAEJ,IAAA,IAAI;AACF,MAAA,QAAA,GAAW,MAAM,IAAA,CAAK,cAAA,CAAe,GAAA,EAAK,IAAI,CAAA;AAAA,IAChD,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,iBAAiB,KAAK,CAAA;AAAA,IAC9B;AAEA,IAAA,MAAM,aAAa,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAE5E,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,OAAO,IAAA,CAAK,kBAAA,CAAsB,QAAA,EAAU,UAAU,CAAA;AAAA,IACxD;AAEA,IAAA,IAAI,IAAA;AACJ,IAAA,IAAI;AACF,MAAA,IAAA,GAAO,MAAM,SAAS,IAAA,EAAK;AAAA,IAC7B,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,mBAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AAEA,IAAA,IAAI,kBAAA,CAAmB,IAAI,CAAA,EAAG;AAC5B,MAAA,OAAO,cAAc,UAAA,CAAW,IAAA,EAAM,QAAA,CAAS,MAAA,EAAQ,UAAU,CAAC,CAAA;AAAA,IACpE;AAEA,IAAA,IAAI,oBAAA,CAAwB,IAAI,CAAA,EAAG;AACjC,MAAA,OAAO,eAAA,CAAgB,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,IAAI,CAAA;AAAA,IAC7C;AAEA,IAAA,MAAM,IAAI,oBAAoB,+CAA+C,CAAA;AAAA,EAC/E;AAAA,EAEA,MAAc,kBAAA,CACZ,QAAA,EACA,UAAA,EACyB;AACzB,IAAA,IAAI,IAAA,GAAgB,IAAA;AAEpB,IAAA,IAAI;AACF,MAAA,IAAA,GAAO,MAAM,SAAS,IAAA,EAAK;AAAA,IAC7B,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,aAAA,CAAc;AAAA,QACnB,IAAA,EAAM,gBAAA;AAAA,QACN,OAAA,EAAS,CAAA,2BAAA,EAA8B,MAAA,CAAO,QAAA,CAAS,MAAM,CAAC,CAAA,CAAA,CAAA;AAAA,QAC9D,QAAQ,QAAA,CAAS,MAAA;AAAA,QACjB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe;AAAC,OAClD,CAAA;AAAA,IACH;AAEA,IAAA,IAAI,kBAAA,CAAmB,IAAI,CAAA,EAAG;AAC5B,MAAA,OAAO,cAAc,UAAA,CAAW,IAAA,EAAM,QAAA,CAAS,MAAA,EAAQ,UAAU,CAAC,CAAA;AAAA,IACpE;AAEA,IAAA,OAAO,aAAA,CAAc;AAAA,MACnB,IAAA,EAAM,gBAAA;AAAA,MACN,OAAA,EAAS,CAAA,2BAAA,EAA8B,MAAA,CAAO,QAAA,CAAS,MAAM,CAAC,CAAA,CAAA,CAAA;AAAA,MAC9D,QAAQ,QAAA,CAAS,MAAA;AAAA,MACjB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe;AAAC,KAClD,CAAA;AAAA,EACH;AAAA,EAEA,MAAc,cAAA,CAAe,GAAA,EAAa,IAAA,EAAsC;AAC9E,IAAA,MAAM,EAAE,UAAA,EAAY,OAAA,EAAS,KAAA,KAAU,IAAA,CAAK,OAAA;AAC5C,IAAA,IAAI,OAAA,GAAU,CAAA;AAEd,IAAA,IAAI,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,MAC9B,GAAG,IAAA;AAAA,MACH,MAAA,EAAQ,WAAA,CAAY,OAAA,CAAQ,OAAO;AAAA,KACpC,CAAA;AAED,IAAA,OACE,UAAU,UAAA,KACT,QAAA,CAAS,WAAW,GAAA,IAAO,QAAA,CAAS,UAAU,GAAA,CAAA,EAC/C;AACA,MAAA,MAAM,aAAa,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAC5E,MAAA,MAAM,UACJ,UAAA,KAAe,MAAA,GAAY,UAAA,GAAa,GAAA,GAAO,mBAAmB,OAAO,CAAA;AAE3E,MAAA,OAAA,IAAW,CAAA;AACX,MAAA,MAAM,MAAM,OAAO,CAAA;AAEnB,MAAA,QAAA,GAAW,MAAM,MAAM,GAAA,EAAK;AAAA,QAC1B,GAAG,IAAA;AAAA,QACH,MAAA,EAAQ,WAAA,CAAY,OAAA,CAAQ,OAAO;AAAA,OACpC,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,QAAA;AAAA,EACT;AACF;AAEA,SAAS,iBAAiB,KAAA,EAAqC;AAC7D,EAAA,IAAI,iBAAiB,KAAA,EAAO;AAC1B,IAAA,OAAO,IAAI,mBAAA,CAAoB,CAAA,wBAAA,EAA2B,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AAAA,EAC3E;AAEA,EAAA,OAAO,IAAI,oBAAoB,yBAAyB,CAAA;AAC1D;AAEA,SAAS,sBAAA,CACP,QACA,QAAA,EACgB;AAChB,EAAA,MAAM,WAAA,GAA8B;AAAA,IAClC,QAAQ,MAAA,CAAO,aAAa,CAAA,GAAI;AAC9B,MAAA,WAAA,MAAiB,OAAO,MAAA,EAAQ;AAC9B,QAAA,MAAM,GAAA;AAAA,MACR;AAAA,IACF;AAAA,GACF;AAEA,EAAA,IAAI,aAAa,MAAA,IAAa,CAAC,MAAA,CAAO,KAAA,CAAM,QAAQ,CAAA,EAAG;AACrD,IAAA,WAAA,CAAY,QAAA,GAAW,QAAA;AAAA,EACzB;AAEA,EAAA,OAAO,WAAA;AACT;AAOO,SAAS,kBAAqB,MAAA,EAA8C;AACjF,EAAA,IAAI,OAAO,MAAA,KAAW,QAAA,IAAY,UAAA,IAAc,MAAA,EAAQ;AACtD,IAAA,MAAM,QAAS,MAAA,CAA0B,QAAA;AACzC,IAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,MAAA;AAAA,EAC7C;AAEA,EAAA,OAAO,MAAA;AACT;;;ACrTA,SAAS,oBAAA,CACP,IAAA,EACA,SAAA,EACA,UAAA,EAGsB;AACtB,EAAA,MAAM,QAAA,IAAY,CAAC,EAAA,EAAY,MAAA,GAAY,EAAC,KAAW;AACrD,IAAA,OAAO,KAAK,QAAA,CAAY;AAAA,MACtB,IAAA,EAAM,UAAU,EAAE,CAAA;AAAA,MAClB,KAAA,EAAO,WAAW,MAAM;AAAA,KACzB,CAAA;AAAA,EACH,CAAA,CAAA;AAEA,EAAA,QAAA,CAAS,OAAA,GAAU,OAAO,EAAA,EAAY,MAAA,GAAY,EAAC,KAAW;AAC5D,IAAA,MAAM,QAAA,GAAW,MAAM,QAAA,CAAS,EAAA,EAAI,MAAM,CAAA;AAE1C,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,iBAAN,MAAqB;AAAA,EAC1B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA,EAAnB,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAY7B,GAAA,GAAwC;AACtC,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA,CAAgB,EAAE,IAAA,EAAM,WAAW,CAAA;AAAA,EACtD;AACF,CAAA;AAGO,IAAM,qBAAN,MAAyB;AAAA,EAC9B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA,EAAnB,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAY7B,IAAA,GAAoD;AAClD,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA,CAA2B,EAAE,IAAA,EAAM,eAAe,CAAA;AAAA,EACrE;AACF,CAAA;AAGO,IAAM,wBAAN,MAA4B;AAAA,EACjC,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA,EAAnB,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7B,IAAI,UAAA,EAA6D;AAC/D,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAuB;AAAA,MACtC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,MAAA;AAAA,KACnD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAA,CACE,YACA,IAAA,EACyC;AACzC,IAAA,OAAO,IAAA,CAAK,KAAK,KAAA,CAAyB;AAAA,MACxC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,MAAA,CAAA;AAAA,MAClD;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAA;AAGO,IAAM,oBAAN,MAAwB;AAAA,EAI7B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAI,qBAAA,CAAsB,IAAI,CAAA;AAAA,EAC7C;AAAA,EAF6B,IAAA;AAAA;AAAA,EAFpB,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBT,IAAA,CAAK,MAAA,GAA6B,EAAC,EAA2C;AAC5E,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAsB;AAAA,MACrC,IAAA,EAAM,YAAA;AAAA,MACN,KAAA,EAAO;AAAA,QACL,MAAM,MAAA,CAAO,IAAA;AAAA,QACb,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,WAAW,MAAA,CAAO;AAAA;AACpB,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,IAAI,UAAA,EAA0D;AAC5D,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAoB;AAAA,MACnC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA;AAAA,KACnD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,MAAA,CACE,MACA,OAAA,EAC0C;AAC1C,IAAA,OAAO,IAAA,CAAK,KAAK,IAAA,CAAyB;AAAA,MACxC,IAAA,EAAM,YAAA;AAAA,MACN,IAAA;AAAA,MACA,gBAAgB,OAAA,CAAQ;AAAA,KACzB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAA,CACE,YACA,OAAA,EACwC;AACxC,IAAA,OAAO,IAAA,CAAK,KAAK,IAAA,CAAuB;AAAA,MACtC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,KAAA,CAAA;AAAA,MAClD,gBAAgB,OAAA,CAAQ;AAAA,KACzB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,cAAA,CACE,UAAA,EACA,IAAA,EACA,OAAA,EACkD;AAClD,IAAA,OAAO,IAAA,CAAK,KAAK,IAAA,CAAiC;AAAA,MAChD,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,gBAAA,CAAA;AAAA,MAClD,IAAA;AAAA,MACA,gBAAgB,OAAA,CAAQ;AAAA,KACzB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,cAAA,CACE,UAAA,EACA,IAAA,EACA,OAAA,EACkD;AAClD,IAAA,OAAO,IAAA,CAAK,KAAK,IAAA,CAAiC;AAAA,MAChD,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,gBAAA,CAAA;AAAA,MAClD,IAAA;AAAA,MACA,gBAAgB,OAAA,CAAQ;AAAA,KACzB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,eAAA,CACE,UAAA,EACA,IAAA,EACA,OAAA,EAC6C;AAC7C,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAA2B;AAAA,MAC1C,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,WAAA,CAAA;AAAA,MAClD,IAAA;AAAA,MACA,gBAAgB,OAAA,CAAQ;AAAA,KACzB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,OAAO,OAAA,CACL,MAAA,GAA2C,EAAC,EACmB;AAC/D,IAAA,IAAI,IAAA,GAAO,CAAA;AACX,IAAA,IAAI,UAAA,GAAa,CAAA;AAEjB,IAAA,OAAO,QAAQ,UAAA,EAAY;AACzB,MAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,CAAK,EAAE,GAAG,MAAA,EAAQ,MAAM,CAAA;AAEpD,MAAA,IAAI,QAAA,CAAS,KAAA,IAAS,CAAC,QAAA,CAAS,IAAA,EAAM;AACpC,QAAA;AAAA,MACF;AAEA,MAAA,KAAA,MAAW,IAAA,IAAQ,QAAA,CAAS,IAAA,CAAK,KAAA,EAAO;AACtC,QAAA,MAAM,IAAA;AAAA,MACR;AAEA,MAAA,UAAA,GAAa,QAAA,CAAS,KAAK,UAAA,CAAW,UAAA;AACtC,MAAA,IAAA,IAAQ,CAAA;AAAA,IACV;AAAA,EACF;AACF,CAAA;AAkBO,IAAM,qBAAN,MAAyB;AAAA,EAO9B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,iCAAA,CAAkC,IAAI,CAAA;AAC3D,IAAA,IAAA,CAAK,UAAA,GAAa,IAAI,kCAAA,CAAmC,IAAI,CAAA;AAAA,EAC/D;AAAA,EAH6B,IAAA;AAAA;AAAA,EALpB,SAAA;AAAA;AAAA,EAGA,UAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBT,IAAA,CAAK,MAAA,GAA8B,EAAC,EAA4C;AAC9E,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAuB;AAAA,MACtC,IAAA,EAAM,aAAA;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;AAAA,EAUA,IAAI,WAAA,EAA4D;AAC9D,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAqB;AAAA,MACpC,IAAA,EAAM,CAAA,YAAA,EAAe,kBAAA,CAAmB,WAAW,CAAC,CAAA;AAAA,KACrD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,MAAA,CACE,MACA,OAAA,EACuC;AACvC,IAAA,OAAO,IAAA,CAAK,KAAK,IAAA,CAAsB;AAAA,MACrC,IAAA,EAAM,aAAA;AAAA,MACN,IAAA;AAAA,MACA,gBAAgB,OAAA,CAAQ;AAAA,KACzB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,WAAA,EAA4D;AACjE,IAAA,OAAO,IAAA,CAAK,KAAK,MAAA,CAAwB;AAAA,MACvC,IAAA,EAAM,CAAA,YAAA,EAAe,kBAAA,CAAmB,WAAW,CAAC,CAAA;AAAA,KACrD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,eAAA,CACE,WAAA,EACA,MAAA,GAA0B,EAAC,EACqB;AAChD,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAA8B;AAAA,MAC7C,IAAA,EAAM,CAAA,YAAA,EAAe,kBAAA,CAAmB,WAAW,CAAC,CAAA,iBAAA,CAAA;AAAA,MACpD,KAAA,EAAO;AAAA,QACL,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO;AAAA;AAClB,KACD,CAAA;AAAA,EACH;AACF,CAAA;AAOO,IAAM,oCAAN,MAAwC;AAAA,EAQ7C,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,MAAA,GAAS,oBAAA;AAAA,MACZ,IAAA;AAAA,MACA,CAAC,WAAA,KACC,CAAA,YAAA,EAAe,kBAAA,CAAmB,WAAW,CAAC,CAAA,yBAAA,CAAA;AAAA,MAChD,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,WAAA,EACA,MAAA,GAAuC,EAAC,EACU;AAClD,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAgC;AAAA,MAC/C,IAAA,EAAM,CAAA,YAAA,EAAe,kBAAA,CAAmB,WAAW,CAAC,CAAA,kBAAA,CAAA;AAAA,MACpD,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,qCAAN,MAAyC;AAAA,EAQ9C,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,MAAA,GAAS,oBAAA;AAAA,MACZ,IAAA;AAAA,MACA,CAAC,WAAA,KACC,CAAA,YAAA,EAAe,kBAAA,CAAmB,WAAW,CAAC,CAAA,0BAAA,CAAA;AAAA,MAChD,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,WAAA,EACA,MAAA,GAAwC,EAAC,EACU;AACnD,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAiC;AAAA,MAChD,IAAA,EAAM,CAAA,YAAA,EAAe,kBAAA,CAAmB,WAAW,CAAC,CAAA,mBAAA,CAAA;AAAA,MACpD,KAAA,EAAO;AAAA,QACL,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO,OAAA;AAAA,QAChB,mBAAmB,MAAA,CAAO,iBAAA;AAAA,QAC1B,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;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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,UAAA,EAA2D;AACnE,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAqB;AAAA,MACpC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,kBAAA;AAAA,KACnD,CAAA;AAAA,EACH;AACF,CAAA;AAOO,IAAM,2BAAN,MAA+B;AAAA,EAQpC,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,MAAA,GAAS,oBAAA;AAAA,MACZ,IAAA;AAAA,MACA,CAAC,UAAA,KACC,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,yBAAA,CAAA;AAAA,MAC9C,CAAC,MAAA,MAAY;AAAA,QACX,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO;AAAA,OAClB;AAAA,KACF;AAAA,EACF;AAAA,EAV6B,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAFpB,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBT,IAAA,CACE,UAAA,EACA,MAAA,GAA8B,EAAC,EACU;AACzC,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAuB;AAAA,MACtC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,kBAAA,CAAA;AAAA,MAClD,KAAA,EAAO;AAAA,QACL,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO,OAAA;AAAA,QAChB,MAAM,MAAA,CAAO,IAAA;AAAA,QACb,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,WAAW,MAAA,CAAO;AAAA;AACpB,KACD,CAAA;AAAA,EACH;AACF,CAAA;AAOO,IAAM,4BAAN,MAAgC;AAAA,EAQrC,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,MAAA,GAAS,oBAAA;AAAA,MACZ,IAAA;AAAA,MACA,CAAC,UAAA,KACC,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,0BAAA,CAAA;AAAA,MAC9C,CAAC,MAAA,MAAY;AAAA,QACX,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO,OAAA;AAAA,QAChB,mBAAmB,MAAA,CAAO;AAAA,OAC5B;AAAA,KACF;AAAA,EACF;AAAA,EAX6B,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAFpB,MAAA;AAcX,CAAA;;;AC5tBO,IAAM,YAAN,MAAgB;AAAA;AAAA,EAEZ,IAAA;AAAA;AAAA,EAGA,MAAA;AAAA;AAAA,EAGA,UAAA;AAAA;AAAA,EAGA,SAAA;AAAA;AAAA,EAGA,UAAA;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,MAAA,GAAS,IAAI,cAAA,CAAe,IAAI,CAAA;AACrC,IAAA,IAAA,CAAK,UAAA,GAAa,IAAI,kBAAA,CAAmB,IAAI,CAAA;AAC7C,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,iBAAA,CAAkB,IAAI,CAAA;AAC3C,IAAA,IAAA,CAAK,UAAA,GAAa,IAAI,kBAAA,CAAmB,IAAI,CAAA;AAC7C,IAAA,IAAA,CAAK,OAAA,GAAU,IAAI,eAAA,CAAgB,IAAI,CAAA;AAAA,EACzC;AACF","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 SOUNDLINKS_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 SOUNDLINKS_DEFAULT_PAGE_SIZE = 10;\n\nexport const API_VERSION_PREFIX = '/v1';\n","import type {\n ApiEnvelopeError,\n ApiEnvelopeSuccess,\n ApiMeta,\n ApiError,\n ApiResponse,\n PublicApiErrorCode,\n} from '../types/api.js';\n\nexport function isApiEnvelopeError(body: unknown): body is ApiEnvelopeError {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return (\n typeof record.error === 'object' &&\n record.error !== null &&\n typeof (record.error as Record<string, unknown>).code === 'string' &&\n typeof (record.error as Record<string, unknown>).message === 'string'\n );\n}\n\nexport function isApiEnvelopeSuccess<T>(body: unknown): body is ApiEnvelopeSuccess<T> {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return 'data' in record && typeof record.meta === 'object' && record.meta !== null;\n}\n\nexport function toApiError(\n envelope: ApiEnvelopeError,\n status: number,\n retryAfter?: number,\n): ApiError {\n const { details } = envelope.error;\n\n return {\n code: envelope.error.code as PublicApiErrorCode,\n message: envelope.error.message,\n status,\n requestId: envelope.meta.requestId,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n ...(details !== undefined ? { details } : {}),\n };\n}\n\nexport function successResponse<T>(data: T, meta: ApiMeta): ApiResponse<T> {\n return {\n data,\n error: null,\n meta,\n };\n}\n\nexport function errorResponse<T>(error: ApiError): ApiResponse<T> {\n return {\n data: null,\n error,\n ...(error.requestId ? { meta: { requestId: error.requestId } } : {}),\n };\n}\n\nexport function parseRetryAfterHeader(value: string | null): number | undefined {\n if (!value) {\n return undefined;\n }\n\n const seconds = Number.parseInt(value, 10);\n if (Number.isFinite(seconds) && seconds >= 0) {\n return seconds;\n }\n\n const dateMs = Date.parse(value);\n if (Number.isFinite(dateMs)) {\n const deltaSeconds = Math.ceil((dateMs - Date.now()) / 1000);\n return Math.max(deltaSeconds, 0);\n }\n\n return undefined;\n}\n","/**\n * Base error for unexpected SDK failures (configuration, parsing, transport).\n *\n * HTTP/API errors from Soundlink are returned as `{ data: null, error }` and do not throw.\n */\nexport class SoundlinkSdkError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkSdkError';\n Object.setPrototypeOf(this, SoundlinkSdkError.prototype);\n }\n}\n\n/** Thrown when a response body cannot be parsed or the network request fails unexpectedly. */\nexport class SoundlinkParseError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkParseError';\n Object.setPrototypeOf(this, SoundlinkParseError.prototype);\n }\n}\n\n/** Thrown when the client is misconfigured (missing or invalid API key, etc.). */\nexport class SoundlinkConfigError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkConfigError';\n Object.setPrototypeOf(this, SoundlinkConfigError.prototype);\n }\n}\n","import { SoundlinkParseError } from '../errors/sdk-error.js';\n\nexport async function* parseNdjsonStream<T>(\n body: ReadableStream<Uint8Array> | null,\n onMalformedLine?: (line: string, error: unknown) => void,\n): AsyncGenerator<T> {\n if (!body) {\n return;\n }\n\n const reader = body.getReader();\n const decoder = new TextDecoder();\n let buffer = '';\n\n try {\n for (;;) {\n const { done, value } = await reader.read();\n if (done) {\n break;\n }\n\n buffer += decoder.decode(value, { stream: true });\n const lines = buffer.split('\\n');\n buffer = lines.pop() ?? '';\n\n for (const line of lines) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n\n try {\n yield JSON.parse(trimmed) as T;\n } catch (error) {\n onMalformedLine?.(trimmed, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n }\n\n const trailing = buffer.trim();\n if (trailing) {\n try {\n yield JSON.parse(trailing) as T;\n } catch (error) {\n onMalformedLine?.(trailing, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n } finally {\n reader.releaseLock();\n }\n}\n\nexport async function collectNdjsonStream<T>(\n stream: AsyncIterable<T>,\n): Promise<{ rows: T[]; rowCount: number }> {\n const rows: T[] = [];\n for await (const row of stream) {\n rows.push(row);\n }\n return {\n rows,\n rowCount: rows.length,\n };\n}\n\nexport function parseNdjsonText<T>(text: string): T[] {\n const rows: T[] = [];\n for (const line of text.split('\\n')) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n rows.push(JSON.parse(trimmed) as T);\n }\n\n return rows;\n}\n","export function buildQueryString(\n params: Record<string, string | number | boolean | undefined | null>,\n): string {\n const searchParams = new URLSearchParams();\n\n for (const [key, value] of Object.entries(params)) {\n if (value === undefined || value === null || value === '') {\n continue;\n }\n searchParams.set(key, String(value));\n }\n\n const query = searchParams.toString();\n return query ? `?${query}` : '';\n}\n\nexport function joinUrl(baseUrl: string, path: string): string {\n const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n return `${normalizedBase}${normalizedPath}`;\n}\n\nexport function sleep(ms: number): Promise<void> {\n return new Promise((resolve) => {\n setTimeout(resolve, ms);\n });\n}\n\nexport function calculateBackoffMs(attempt: number): number {\n const base = 250;\n const jitter = Math.floor(Math.random() * 100);\n return base * 2 ** attempt + jitter;\n}\n","import {\n API_KEY_PREFIX,\n API_VERSION_PREFIX,\n DEFAULT_BASE_URL,\n DEFAULT_MAX_RETRIES,\n DEFAULT_TIMEOUT_MS,\n} from '../constants/defaults.js';\nimport {\n errorResponse,\n isApiEnvelopeError,\n isApiEnvelopeSuccess,\n parseRetryAfterHeader,\n successResponse,\n toApiError,\n} from '../core/api-response.js';\nimport { parseNdjsonStream } from '../core/jsonl.js';\nimport { SoundlinkConfigError, SoundlinkParseError } from '../errors/sdk-error.js';\nimport type { ApiResponse, JsonlStream, SoundlinkOptions } from '../types/api.js';\nimport {\n buildQueryString,\n calculateBackoffMs,\n joinUrl,\n sleep,\n} from '../utils/query.js';\n\nexport type { JsonlStream };\n\nexport interface HttpGetOptions {\n path: string;\n query?: Record<string, string | number | boolean | undefined | null>;\n}\n\nexport interface HttpJsonlOptions extends HttpGetOptions {\n accept?: string;\n}\n\nexport interface HttpMutationOptions {\n path: string;\n body?: unknown;\n query?: Record<string, string | number | boolean | undefined | null>;\n headers?: Record<string, string>;\n /** Sent as the `Idempotency-Key` header when set. */\n idempotencyKey?: string;\n}\n\nexport interface ResolvedSoundlinkClientOptions {\n apiKey: string;\n baseUrl: string;\n timeout: number;\n maxRetries: number;\n fetch: typeof fetch;\n}\n\n/**\n * Normalize constructor options and validate the API key format.\n *\n * @throws {@link SoundlinkConfigError} When the key is missing or does not start with `sk_`.\n */\nexport function resolveClientOptions(\n options: SoundlinkOptions,\n): ResolvedSoundlinkClientOptions {\n const normalized = typeof options === 'string' ? { apiKey: options } : options;\n\n const apiKey = normalized.apiKey.trim();\n if (!apiKey) {\n throw new SoundlinkConfigError('apiKey is required.');\n }\n\n if (!apiKey.startsWith(API_KEY_PREFIX)) {\n throw new SoundlinkConfigError(\n `Invalid API key format. Expected a key starting with \"${API_KEY_PREFIX}\".`,\n );\n }\n\n return {\n apiKey,\n baseUrl: normalized.baseUrl ?? DEFAULT_BASE_URL,\n timeout: normalized.timeout ?? DEFAULT_TIMEOUT_MS,\n maxRetries: normalized.maxRetries ?? DEFAULT_MAX_RETRIES,\n fetch: normalized.fetch ?? globalThis.fetch.bind(globalThis),\n };\n}\n\nexport class HttpClient {\n private readonly options: ResolvedSoundlinkClientOptions;\n\n constructor(options: SoundlinkOptions) {\n this.options = resolveClientOptions(options);\n }\n\n get resolvedOptions(): ResolvedSoundlinkClientOptions {\n return this.options;\n }\n\n async get<T>({ path, query }: HttpGetOptions): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n return this.requestJson<T>(url, {\n method: 'GET',\n headers: this.buildHeaders(),\n });\n }\n\n async post<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('POST', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async patch<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('PATCH', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async put<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('PUT', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async delete<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('DELETE', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async getJsonl<T>({\n path,\n query,\n accept = 'application/x-ndjson',\n }: HttpJsonlOptions): Promise<ApiResponse<JsonlStream<T>>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n let response: Response;\n try {\n response = await this.fetchWithRetry(url, {\n method: 'GET',\n headers: {\n ...this.buildHeaders(),\n Accept: accept,\n },\n });\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const contentType = response.headers.get('Content-Type') ?? '';\n if (contentType.includes('application/json')) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const rowCountHeader = response.headers.get('X-Row-Count');\n const parsedRowCount =\n rowCountHeader !== null ? Number.parseInt(rowCountHeader, 10) : undefined;\n\n const stream = parseNdjsonStream<T>(response.body);\n const data = attachRowCountMetadata(stream, parsedRowCount);\n\n return {\n data,\n error: null,\n };\n }\n\n private mutateJson<T>(\n method: 'POST' | 'PATCH' | 'PUT' | 'DELETE',\n { path, body, query, headers, idempotencyKey }: HttpMutationOptions,\n ): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n const requestHeaders = this.buildHeaders({\n ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),\n ...(idempotencyKey !== undefined ? { 'Idempotency-Key': idempotencyKey } : {}),\n ...headers,\n });\n\n return this.requestJson<T>(url, {\n method,\n headers: requestHeaders,\n ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n });\n }\n\n private buildHeaders(extra: Record<string, string> = {}): Record<string, string> {\n return {\n Authorization: `Bearer ${this.options.apiKey}`,\n Accept: 'application/json',\n ...extra,\n };\n }\n\n private async requestJson<T>(\n url: string,\n init: RequestInit,\n ): Promise<ApiResponse<T>> {\n let response: Response;\n\n try {\n response = await this.fetchWithRetry(url, init);\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<T>(response, retryAfter);\n }\n\n let body: unknown;\n try {\n body = await response.json();\n } catch {\n throw new SoundlinkParseError(\n 'Failed to parse JSON response from Soundlink API.',\n );\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n if (isApiEnvelopeSuccess<T>(body)) {\n return successResponse(body.data, body.meta);\n }\n\n throw new SoundlinkParseError('Unexpected response shape from Soundlink API.');\n }\n\n private async parseErrorEnvelope<T>(\n response: Response,\n retryAfter?: number,\n ): Promise<ApiResponse<T>> {\n let body: unknown = null;\n\n try {\n body = await response.json();\n } catch {\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n private async fetchWithRetry(url: string, init: RequestInit): Promise<Response> {\n const { maxRetries, timeout, fetch } = this.options;\n let attempt = 0;\n\n let response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n\n while (\n attempt < maxRetries &&\n (response.status === 429 || response.status >= 500)\n ) {\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n const delayMs =\n retryAfter !== undefined ? retryAfter * 1000 : calculateBackoffMs(attempt);\n\n attempt += 1;\n await sleep(delayMs);\n\n response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n }\n\n return response;\n }\n}\n\nfunction toTransportError(error: unknown): SoundlinkParseError {\n if (error instanceof Error) {\n return new SoundlinkParseError(`Network request failed: ${error.message}`);\n }\n\n return new SoundlinkParseError('Network request failed.');\n}\n\nfunction attachRowCountMetadata<T>(\n stream: AsyncIterable<T>,\n rowCount?: number,\n): JsonlStream<T> {\n const jsonlStream: JsonlStream<T> = {\n async *[Symbol.asyncIterator]() {\n for await (const row of stream) {\n yield row;\n }\n },\n };\n\n if (rowCount !== undefined && !Number.isNaN(rowCount)) {\n jsonlStream.rowCount = rowCount;\n }\n\n return jsonlStream;\n}\n\n/**\n * Read `rowCount` from a {@link JsonlStream} when the API sent `X-Row-Count`.\n *\n * @returns Row count, or `undefined` if not available.\n */\nexport function getStreamRowCount<T>(stream: AsyncIterable<T>): number | undefined {\n if (typeof stream === 'object' && 'rowCount' in stream) {\n const value = (stream as JsonlStream<T>).rowCount;\n return typeof value === 'number' ? value : undefined;\n }\n\n return undefined;\n}\n","import type { HttpClient } from '../client/http-client.js';\nimport type { JsonlStream } from '../types/api.js';\nimport { collectNdjsonStream } from '../core/jsonl.js';\nimport type {\n ApiResponse,\n BreakdownExportParams,\n BreakdownListData,\n BreakdownListParams,\n BreakdownRow,\n CampaignAutoRenewData,\n CampaignCreateData,\n CampaignDetail,\n CampaignListData,\n CampaignListParams,\n CampaignStopData,\n CampaignTiersData,\n CreateCampaignRequest,\n CreateSoundlinkRequest,\n CreativeMetrics,\n DateRangeParams,\n DecreaseCampaignBudgetData,\n DecreaseCampaignBudgetRequest,\n EngagementExportParams,\n EngagementRow,\n ExportCollection,\n IdempotencyOptions,\n IncreaseCampaignBudgetData,\n IncreaseCampaignBudgetRequest,\n MetricsOverview,\n PingData,\n SoundlinkBreakdownListData,\n SoundlinkBreakdownListParams,\n SoundlinkBreakdownRow,\n SoundlinkDetail,\n SoundlinkEngagementListData,\n SoundlinkEngagementListParams,\n SoundlinkEngagementRow,\n SoundlinkListData,\n SoundlinkListParams,\n SoundlinkMetricsOverview,\n StrategiesCatalogData,\n UpdateCampaignAutoRenewRequest,\n UpdateCampaignTiersRequest,\n WalletData,\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 id - Campaign or soundlink ID.\n * @param params - Optional date range (max 90 days per request).\n */\n (id: 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(id: string, params?: P): Promise<ApiResponse<ExportCollection<T>>>;\n}\n\nfunction createExportResource<T, P extends DateRangeParams>(\n http: HttpClient,\n buildPath: (id: string) => string,\n buildQuery: (\n params: P,\n ) => Record<string, string | number | boolean | undefined | null>,\n): ExportResource<T, P> {\n const exportFn = ((id: string, params: P = {} as P) => {\n return http.getJsonl<T>({\n path: buildPath(id),\n query: buildQuery(params),\n });\n }) as ExportResource<T, P>;\n\n exportFn.collect = async (id: string, params: P = {} as P) => {\n const response = await exportFn(id, 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/** Organization wallet (`GET /v1/wallet`). Requires `wallet:read`. */\nexport class WalletResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Wallet snapshot for the organization on the API key.\n *\n * Maps to `GET /v1/wallet`. `available` is balance minus active reservations.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.wallet.get();\n * ```\n */\n get(): Promise<ApiResponse<WalletData>> {\n return this.http.get<WalletData>({ path: '/wallet' });\n }\n}\n\n/** Strategy catalog (`GET /v1/strategies`). Requires `campaigns:read`. */\nexport class StrategiesResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * List growth strategies available for wallet campaign create.\n *\n * Maps to `GET /v1/strategies`.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.strategies.list();\n * ```\n */\n list(): Promise<ApiResponse<StrategiesCatalogData>> {\n return this.http.get<StrategiesCatalogData>({ path: '/strategies' });\n }\n}\n\n/** Campaign tiers (`/v1/campaigns/{id}/tiers`). Wallet only (`generation: 3`). */\nexport class CampaignTiersResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Get current tier allocation for a wallet campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/tiers`. Wallet campaigns only (`generation: 3`).\n */\n get(campaignId: string): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.get<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n });\n }\n\n /**\n * Update tier enablement and budget shares.\n *\n * Maps to `PATCH /v1/campaigns/{campaignId}/tiers`. Requires `campaigns:write`.\n * Allocation percents across items must sum to 100.\n * Use each tier's `tierId` from {@link CampaignTiersResource.get} as `targetingTierId`.\n * Does not require an `Idempotency-Key` (unlike create / stop / budget).\n */\n update(\n campaignId: string,\n body: UpdateCampaignTiersRequest,\n ): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.patch<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n body,\n });\n }\n}\n\n/** Campaign listing, detail, and wallet write surface (`/v1/campaigns/*`). */\nexport class CampaignsResource {\n /** Tier allocation for wallet campaigns (`generation: 3`). */\n readonly tiers: CampaignTiersResource;\n\n constructor(private readonly http: HttpClient) {\n this.tiers = new CampaignTiersResource(http);\n }\n\n /**\n * List campaigns for the authenticated organization.\n *\n * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**. Requires `campaigns:read`.\n *\n * @param params - Pagination and sort options.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.list({ page: 1, pageSize: 100 });\n * ```\n */\n list(params: CampaignListParams = {}): Promise<ApiResponse<CampaignListData>> {\n return this.http.get<CampaignListData>({\n path: '/campaigns',\n query: {\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n\n /**\n * Fetch full details for a single campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}`. Requires `campaigns:read`.\n *\n * @param campaignId - Campaign identifier returned by {@link CampaignsResource.list}.\n */\n get(campaignId: string): Promise<ApiResponse<CampaignDetail>> {\n return this.http.get<CampaignDetail>({\n path: `/campaigns/${encodeURIComponent(campaignId)}`,\n });\n }\n\n /**\n * Create a wallet-funded campaign.\n *\n * Maps to `POST /v1/campaigns`. Requires `campaigns:write` and `Idempotency-Key`.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.create(\n * {\n * spotifyUrl: 'https://open.spotify.com/track/...',\n * dailyBudget: 20,\n * durationDays: 7,\n * genre: 'Pop',\n * strategyType: 'maximum_growth',\n * },\n * { idempotencyKey: 'create-mytrack-01' },\n * );\n * ```\n */\n create(\n body: CreateCampaignRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignCreateData>> {\n return this.http.post<CampaignCreateData>({\n path: '/campaigns',\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Stop a wallet campaign and refund unspent budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/stop`. Requires `campaigns:write`\n * and `Idempotency-Key`. Wallet campaigns only (`generation: 3`).\n */\n stop(\n campaignId: string,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignStopData>> {\n return this.http.post<CampaignStopData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/stop`,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Increase wallet campaign budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/increase`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n increaseBudget(\n campaignId: string,\n body: IncreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<IncreaseCampaignBudgetData>> {\n return this.http.post<IncreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/increase`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Decrease wallet campaign daily budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/decrease`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n decreaseBudget(\n campaignId: string,\n body: DecreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<DecreaseCampaignBudgetData>> {\n return this.http.post<DecreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/decrease`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Set auto-renew for a wallet campaign.\n *\n * Maps to `PUT /v1/campaigns/{campaignId}/auto-renew`. Requires `campaigns:write`\n * and `Idempotency-Key`. Wallet campaigns only (`generation: 3`).\n */\n updateAutoRenew(\n campaignId: string,\n body: UpdateCampaignAutoRenewRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignAutoRenewData>> {\n return this.http.put<CampaignAutoRenewData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/auto-renew`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Async iterator over every campaign across all pages.\n *\n * Stops silently if a page request returns an error.\n *\n * @param params - Same as {@link CampaignsResource.list} except `page` is managed automatically.\n *\n * @example\n * ```ts\n * for await (const campaign of soundlink.campaigns.listAll({ pageSize: 100 })) {\n * console.log(campaign.campaignId);\n * }\n * ```\n */\n async *listAll(\n params: Omit<CampaignListParams, 'page'> = {},\n ): AsyncGenerator<CampaignListData['items'][number], void, void> {\n let page = 1;\n let totalPages = 1;\n\n while (page <= totalPages) {\n const response = await this.list({ ...params, page });\n\n if (response.error || !response.data) {\n return;\n }\n\n for (const item of response.data.items) {\n yield item;\n }\n\n totalPages = response.data.pagination.totalPages;\n page += 1;\n }\n }\n}\n\n/**\n * Self-serve soundlinks (`/v1/soundlinks/*`).\n *\n * List, get, and metrics require `soundlinks:read`. Create and delete require\n * `soundlinks:write`. Only soundlinks that are **not** linked to a campaign.\n * Campaign-backed soundlinks are served by the Campaigns API.\n *\n * @example\n * ```ts\n * await soundlink.soundlinks.list();\n * await soundlink.soundlinks.get(soundlinkId);\n * await soundlink.soundlinks.create({ name, spotifyUrl }, { idempotencyKey });\n * await soundlink.soundlinks.delete(soundlinkId);\n * await soundlink.soundlinks.metricsOverview(soundlinkId);\n * ```\n */\nexport class SoundlinksResource {\n /** Per-day country breakdown and JSONL export. */\n readonly breakdown: SoundlinkBreakdownMetricsResource;\n\n /** Per-day track engagement and JSONL export. */\n readonly engagement: SoundlinkEngagementMetricsResource;\n\n constructor(private readonly http: HttpClient) {\n this.breakdown = new SoundlinkBreakdownMetricsResource(http);\n this.engagement = new SoundlinkEngagementMetricsResource(http);\n }\n\n /**\n * List self-serve soundlinks for the authenticated organization.\n *\n * Maps to `GET /v1/soundlinks`. Max `pageSize` is **100**. Requires `soundlinks:read`.\n *\n * @param params - Pagination and sort options.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.soundlinks.list({ page: 1, pageSize: 100 });\n * ```\n */\n list(params: SoundlinkListParams = {}): Promise<ApiResponse<SoundlinkListData>> {\n return this.http.get<SoundlinkListData>({\n path: '/soundlinks',\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 details for a single self-serve soundlink.\n *\n * Maps to `GET /v1/soundlinks/{soundlinkId}`. Requires `soundlinks:read`.\n * Campaign-linked soundlinks return `404`.\n *\n * @param soundlinkId - Identifier returned by {@link SoundlinksResource.list}.\n */\n get(soundlinkId: string): Promise<ApiResponse<SoundlinkDetail>> {\n return this.http.get<SoundlinkDetail>({\n path: `/soundlinks/${encodeURIComponent(soundlinkId)}`,\n });\n }\n\n /**\n * Create a self-serve soundlink.\n *\n * Maps to `POST /v1/soundlinks`. Requires `soundlinks:write` and\n * `Idempotency-Key`. Does not create a campaign.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.soundlinks.create(\n * {\n * name: 'Midnight Drive',\n * spotifyUrl: 'https://open.spotify.com/track/...',\n * },\n * { idempotencyKey: 'create-midnight-drive-01' },\n * );\n * ```\n */\n create(\n body: CreateSoundlinkRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<SoundlinkDetail>> {\n return this.http.post<SoundlinkDetail>({\n path: '/soundlinks',\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Archive a self-serve soundlink (`status: archived`). Same as Archive in the app.\n *\n * Maps to `DELETE /v1/soundlinks/{soundlinkId}`. Requires `soundlinks:write`.\n * Does not send `Idempotency-Key`. List and detail still return the row.\n */\n delete(soundlinkId: string): Promise<ApiResponse<SoundlinkDetail>> {\n return this.http.delete<SoundlinkDetail>({\n path: `/soundlinks/${encodeURIComponent(soundlinkId)}`,\n });\n }\n\n /**\n * Soundlink-level metric totals for a date range.\n *\n * Maps to `GET /v1/soundlinks/{soundlinkId}/metrics/overview`.\n * Omit `startDate` to default to the soundlink creation date.\n * No financial fields. Requires `soundlinks:read`.\n *\n * @param soundlinkId - Soundlink identifier.\n * @param params - Inclusive `YYYY-MM-DD` date range.\n */\n metricsOverview(\n soundlinkId: string,\n params: DateRangeParams = {},\n ): Promise<ApiResponse<SoundlinkMetricsOverview>> {\n return this.http.get<SoundlinkMetricsOverview>({\n path: `/soundlinks/${encodeURIComponent(soundlinkId)}/metrics/overview`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n },\n });\n }\n}\n\n/**\n * Country-level daily metrics (`soundlink_country_daily` schema).\n *\n * Access via `soundlink.soundlinks.breakdown`.\n */\nexport class SoundlinkBreakdownMetricsResource {\n /**\n * Stream full breakdown export as JSONL.\n *\n * Maps to `GET /v1/soundlinks/{soundlinkId}/metrics/breakdown/export`.\n */\n readonly export: ExportResource<SoundlinkBreakdownRow, BreakdownExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<SoundlinkBreakdownRow, BreakdownExportParams>(\n http,\n (soundlinkId) =>\n `/soundlinks/${encodeURIComponent(soundlinkId)}/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/soundlinks/{soundlinkId}/metrics/breakdown`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param soundlinkId - Soundlink identifier.\n * @param params - Date range, pagination, and sort options.\n */\n list(\n soundlinkId: string,\n params: SoundlinkBreakdownListParams = {},\n ): Promise<ApiResponse<SoundlinkBreakdownListData>> {\n return this.http.get<SoundlinkBreakdownListData>({\n path: `/soundlinks/${encodeURIComponent(soundlinkId)}/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 (`soundlink_engagement_daily` schema).\n *\n * Access via `soundlink.soundlinks.engagement`.\n */\nexport class SoundlinkEngagementMetricsResource {\n /**\n * Stream full engagement export as JSONL.\n *\n * Maps to `GET /v1/soundlinks/{soundlinkId}/metrics/engagement/export`.\n */\n readonly export: ExportResource<SoundlinkEngagementRow, EngagementExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<SoundlinkEngagementRow, EngagementExportParams>(\n http,\n (soundlinkId) =>\n `/soundlinks/${encodeURIComponent(soundlinkId)}/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/soundlinks/{soundlinkId}/metrics/engagement`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param soundlinkId - Soundlink identifier.\n * @param params - Date range, engagement context filter, pagination, and sort.\n */\n list(\n soundlinkId: string,\n params: SoundlinkEngagementListParams = {},\n ): Promise<ApiResponse<SoundlinkEngagementListData>> {\n return this.http.get<SoundlinkEngagementListData>({\n path: `/soundlinks/${encodeURIComponent(soundlinkId)}/metrics/engagement`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n engagementContext: params.engagementContext,\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n}\n\n/**\n * Campaign metrics (`/v1/campaigns/{id}/metrics/*`). Requires `metrics:read`.\n *\n * @example\n * ```ts\n * await soundlink.metrics.overview(campaignId);\n * await soundlink.metrics.breakdown.list(campaignId);\n * await soundlink.metrics.engagement.export(campaignId);\n * ```\n */\nexport class MetricsResource {\n /** Per-day country breakdown and JSONL export. */\n readonly breakdown: BreakdownMetricsResource;\n\n /** Per-track engagement JSONL export. */\n readonly engagement: EngagementMetricsResource;\n\n constructor(private readonly http: HttpClient) {\n this.breakdown = new BreakdownMetricsResource(http);\n this.engagement = new EngagementMetricsResource(http);\n }\n\n /**\n * Campaign-level metric totals for a date range.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/overview`.\n * Aggregates across all countries — use {@link BreakdownMetricsResource.list} for daily rows.\n *\n * @param campaignId - Campaign identifier.\n * @param params - Inclusive `YYYY-MM-DD` date range. Omit for API defaults.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.metrics.overview(campaignId, {\n * startDate: '2026-01-01',\n * endDate: '2026-03-31',\n * });\n * ```\n */\n overview(\n campaignId: string,\n params: DateRangeParams = {},\n ): Promise<ApiResponse<MetricsOverview>> {\n return this.http.get<MetricsOverview>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/overview`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n },\n });\n }\n\n /**\n * Lifetime creative performance, grouped by background video.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/creatives`.\n * Snapshot only — do not send a date range.\n */\n creatives(campaignId: string): Promise<ApiResponse<CreativeMetrics>> {\n return this.http.get<CreativeMetrics>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/creatives`,\n });\n }\n}\n\n/**\n * Country-level daily metrics (`campaign_country_daily` schema).\n *\n * Access via `soundlink.metrics.breakdown`.\n */\nexport class BreakdownMetricsResource {\n /**\n * Stream full breakdown export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown/export`.\n */\n readonly export: ExportResource<BreakdownRow, BreakdownExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<BreakdownRow, BreakdownExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n }),\n );\n }\n\n /**\n * Paginated per-day, per-country breakdown rows.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param campaignId - Campaign identifier.\n * @param params - Date range, pagination, and sort options.\n */\n list(\n campaignId: string,\n params: BreakdownListParams = {},\n ): Promise<ApiResponse<BreakdownListData>> {\n return this.http.get<BreakdownListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n}\n\n/**\n * Per-track engagement metrics (`campaign_engagement_daily` schema).\n *\n * Access via `soundlink.metrics.engagement`. Only JSONL export is shipped.\n */\nexport class EngagementMetricsResource {\n /**\n * Stream full engagement export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement/export`.\n */\n readonly export: ExportResource<EngagementRow, EngagementExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<EngagementRow, EngagementExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n engagementContext: params.engagementContext,\n }),\n );\n }\n}\n","import { HttpClient } from './http-client.js';\nimport {\n CampaignsResource,\n MetricsResource,\n PingResource,\n SoundlinksResource,\n StrategiesResource,\n WalletResource,\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 /** Organization wallet snapshot. Requires `wallet:read` scope. */\n readonly wallet: WalletResource;\n\n /** Growth strategy catalog. Requires `campaigns:read` scope. */\n readonly strategies: StrategiesResource;\n\n /** List, fetch, and manage campaigns. Read needs `campaigns:read`; writes need `campaigns:write`. */\n readonly campaigns: CampaignsResource;\n\n /** Self-serve soundlinks. Read needs `soundlinks:read`; create/delete need `soundlinks:write`. */\n readonly soundlinks: SoundlinksResource;\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.wallet = new WalletResource(http);\n this.strategies = new StrategiesResource(http);\n this.campaigns = new CampaignsResource(http);\n this.soundlinks = new SoundlinksResource(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 SOUNDLINKS_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 SOUNDLINKS_DEFAULT_PAGE_SIZE = 10;\n\nexport const API_VERSION_PREFIX = '/v1';\n","import type {\n ApiEnvelopeError,\n ApiEnvelopeSuccess,\n ApiMeta,\n ApiError,\n ApiResponse,\n PublicApiErrorCode,\n} from '../types/api.js';\n\nexport function isApiEnvelopeError(body: unknown): body is ApiEnvelopeError {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return (\n typeof record.error === 'object' &&\n record.error !== null &&\n typeof (record.error as Record<string, unknown>).code === 'string' &&\n typeof (record.error as Record<string, unknown>).message === 'string'\n );\n}\n\nexport function isApiEnvelopeSuccess<T>(body: unknown): body is ApiEnvelopeSuccess<T> {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return 'data' in record && typeof record.meta === 'object' && record.meta !== null;\n}\n\nexport function toApiError(\n envelope: ApiEnvelopeError,\n status: number,\n retryAfter?: number,\n): ApiError {\n const { details } = envelope.error;\n\n return {\n code: envelope.error.code as PublicApiErrorCode,\n message: envelope.error.message,\n status,\n requestId: envelope.meta.requestId,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n ...(details !== undefined ? { details } : {}),\n };\n}\n\nexport function successResponse<T>(data: T, meta: ApiMeta): ApiResponse<T> {\n return {\n data,\n error: null,\n meta,\n };\n}\n\nexport function errorResponse<T>(error: ApiError): ApiResponse<T> {\n return {\n data: null,\n error,\n ...(error.requestId ? { meta: { requestId: error.requestId } } : {}),\n };\n}\n\nexport function parseRetryAfterHeader(value: string | null): number | undefined {\n if (!value) {\n return undefined;\n }\n\n const seconds = Number.parseInt(value, 10);\n if (Number.isFinite(seconds) && seconds >= 0) {\n return seconds;\n }\n\n const dateMs = Date.parse(value);\n if (Number.isFinite(dateMs)) {\n const deltaSeconds = Math.ceil((dateMs - Date.now()) / 1000);\n return Math.max(deltaSeconds, 0);\n }\n\n return undefined;\n}\n","/**\n * Base error for unexpected SDK failures (configuration, parsing, transport).\n *\n * HTTP/API errors from Soundlink are returned as `{ data: null, error }` and do not throw.\n */\nexport class SoundlinkSdkError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkSdkError';\n Object.setPrototypeOf(this, SoundlinkSdkError.prototype);\n }\n}\n\n/** Thrown when a response body cannot be parsed or the network request fails unexpectedly. */\nexport class SoundlinkParseError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkParseError';\n Object.setPrototypeOf(this, SoundlinkParseError.prototype);\n }\n}\n\n/** Thrown when the client is misconfigured (missing or invalid API key, etc.). */\nexport class SoundlinkConfigError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkConfigError';\n Object.setPrototypeOf(this, SoundlinkConfigError.prototype);\n }\n}\n","import { SoundlinkParseError } from '../errors/sdk-error.js';\n\nexport async function* parseNdjsonStream<T>(\n body: ReadableStream<Uint8Array> | null,\n onMalformedLine?: (line: string, error: unknown) => void,\n): AsyncGenerator<T> {\n if (!body) {\n return;\n }\n\n const reader = body.getReader();\n const decoder = new TextDecoder();\n let buffer = '';\n\n try {\n for (;;) {\n const { done, value } = await reader.read();\n if (done) {\n break;\n }\n\n buffer += decoder.decode(value, { stream: true });\n const lines = buffer.split('\\n');\n buffer = lines.pop() ?? '';\n\n for (const line of lines) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n\n try {\n yield JSON.parse(trimmed) as T;\n } catch (error) {\n onMalformedLine?.(trimmed, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n }\n\n const trailing = buffer.trim();\n if (trailing) {\n try {\n yield JSON.parse(trailing) as T;\n } catch (error) {\n onMalformedLine?.(trailing, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n } finally {\n reader.releaseLock();\n }\n}\n\nexport async function collectNdjsonStream<T>(\n stream: AsyncIterable<T>,\n): Promise<{ rows: T[]; rowCount: number }> {\n const rows: T[] = [];\n for await (const row of stream) {\n rows.push(row);\n }\n return {\n rows,\n rowCount: rows.length,\n };\n}\n\nexport function parseNdjsonText<T>(text: string): T[] {\n const rows: T[] = [];\n for (const line of text.split('\\n')) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n rows.push(JSON.parse(trimmed) as T);\n }\n\n return rows;\n}\n","export function buildQueryString(\n params: Record<string, string | number | boolean | undefined | null>,\n): string {\n const searchParams = new URLSearchParams();\n\n for (const [key, value] of Object.entries(params)) {\n if (value === undefined || value === null || value === '') {\n continue;\n }\n searchParams.set(key, String(value));\n }\n\n const query = searchParams.toString();\n return query ? `?${query}` : '';\n}\n\nexport function joinUrl(baseUrl: string, path: string): string {\n const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n return `${normalizedBase}${normalizedPath}`;\n}\n\nexport function sleep(ms: number): Promise<void> {\n return new Promise((resolve) => {\n setTimeout(resolve, ms);\n });\n}\n\nexport function calculateBackoffMs(attempt: number): number {\n const base = 250;\n const jitter = Math.floor(Math.random() * 100);\n return base * 2 ** attempt + jitter;\n}\n","import {\n API_KEY_PREFIX,\n API_VERSION_PREFIX,\n DEFAULT_BASE_URL,\n DEFAULT_MAX_RETRIES,\n DEFAULT_TIMEOUT_MS,\n} from '../constants/defaults.js';\nimport {\n errorResponse,\n isApiEnvelopeError,\n isApiEnvelopeSuccess,\n parseRetryAfterHeader,\n successResponse,\n toApiError,\n} from '../core/api-response.js';\nimport { parseNdjsonStream } from '../core/jsonl.js';\nimport { SoundlinkConfigError, SoundlinkParseError } from '../errors/sdk-error.js';\nimport type { ApiResponse, JsonlStream, SoundlinkOptions } from '../types/api.js';\nimport {\n buildQueryString,\n calculateBackoffMs,\n joinUrl,\n sleep,\n} from '../utils/query.js';\n\nexport type { JsonlStream };\n\nexport interface HttpGetOptions {\n path: string;\n query?: Record<string, string | number | boolean | undefined | null>;\n}\n\nexport interface HttpJsonlOptions extends HttpGetOptions {\n accept?: string;\n}\n\nexport interface HttpMutationOptions {\n path: string;\n body?: unknown;\n query?: Record<string, string | number | boolean | undefined | null>;\n headers?: Record<string, string>;\n /** Sent as the `Idempotency-Key` header when set. */\n idempotencyKey?: string;\n}\n\nexport interface ResolvedSoundlinkClientOptions {\n apiKey: string;\n baseUrl: string;\n timeout: number;\n maxRetries: number;\n fetch: typeof fetch;\n}\n\n/**\n * Normalize constructor options and validate the API key format.\n *\n * @throws {@link SoundlinkConfigError} When the key is missing or does not start with `sk_`.\n */\nexport function resolveClientOptions(\n options: SoundlinkOptions,\n): ResolvedSoundlinkClientOptions {\n const normalized = typeof options === 'string' ? { apiKey: options } : options;\n\n const apiKey = normalized.apiKey.trim();\n if (!apiKey) {\n throw new SoundlinkConfigError('apiKey is required.');\n }\n\n if (!apiKey.startsWith(API_KEY_PREFIX)) {\n throw new SoundlinkConfigError(\n `Invalid API key format. Expected a key starting with \"${API_KEY_PREFIX}\".`,\n );\n }\n\n return {\n apiKey,\n baseUrl: normalized.baseUrl ?? DEFAULT_BASE_URL,\n timeout: normalized.timeout ?? DEFAULT_TIMEOUT_MS,\n maxRetries: normalized.maxRetries ?? DEFAULT_MAX_RETRIES,\n fetch: normalized.fetch ?? globalThis.fetch.bind(globalThis),\n };\n}\n\nexport class HttpClient {\n private readonly options: ResolvedSoundlinkClientOptions;\n\n constructor(options: SoundlinkOptions) {\n this.options = resolveClientOptions(options);\n }\n\n get resolvedOptions(): ResolvedSoundlinkClientOptions {\n return this.options;\n }\n\n async get<T>({ path, query }: HttpGetOptions): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n return this.requestJson<T>(url, {\n method: 'GET',\n headers: this.buildHeaders(),\n });\n }\n\n async post<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('POST', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async patch<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('PATCH', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async put<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('PUT', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async delete<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('DELETE', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async getJsonl<T>({\n path,\n query,\n accept = 'application/x-ndjson',\n }: HttpJsonlOptions): Promise<ApiResponse<JsonlStream<T>>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n let response: Response;\n try {\n response = await this.fetchWithRetry(url, {\n method: 'GET',\n headers: {\n ...this.buildHeaders(),\n Accept: accept,\n },\n });\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const contentType = response.headers.get('Content-Type') ?? '';\n if (contentType.includes('application/json')) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const rowCountHeader = response.headers.get('X-Row-Count');\n const parsedRowCount =\n rowCountHeader !== null ? Number.parseInt(rowCountHeader, 10) : undefined;\n\n const stream = parseNdjsonStream<T>(response.body);\n const data = attachRowCountMetadata(stream, parsedRowCount);\n\n return {\n data,\n error: null,\n };\n }\n\n private mutateJson<T>(\n method: 'POST' | 'PATCH' | 'PUT' | 'DELETE',\n { path, body, query, headers, idempotencyKey }: HttpMutationOptions,\n ): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n const requestHeaders = this.buildHeaders({\n ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),\n ...(idempotencyKey !== undefined ? { 'Idempotency-Key': idempotencyKey } : {}),\n ...headers,\n });\n\n return this.requestJson<T>(url, {\n method,\n headers: requestHeaders,\n ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n });\n }\n\n private buildHeaders(extra: Record<string, string> = {}): Record<string, string> {\n return {\n Authorization: `Bearer ${this.options.apiKey}`,\n Accept: 'application/json',\n ...extra,\n };\n }\n\n private async requestJson<T>(\n url: string,\n init: RequestInit,\n ): Promise<ApiResponse<T>> {\n let response: Response;\n\n try {\n response = await this.fetchWithRetry(url, init);\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<T>(response, retryAfter);\n }\n\n let body: unknown;\n try {\n body = await response.json();\n } catch {\n throw new SoundlinkParseError(\n 'Failed to parse JSON response from Soundlink API.',\n );\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n if (isApiEnvelopeSuccess<T>(body)) {\n return successResponse(body.data, body.meta);\n }\n\n throw new SoundlinkParseError('Unexpected response shape from Soundlink API.');\n }\n\n private async parseErrorEnvelope<T>(\n response: Response,\n retryAfter?: number,\n ): Promise<ApiResponse<T>> {\n let body: unknown = null;\n\n try {\n body = await response.json();\n } catch {\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n private async fetchWithRetry(url: string, init: RequestInit): Promise<Response> {\n const { maxRetries, timeout, fetch } = this.options;\n let attempt = 0;\n\n let response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n\n while (\n attempt < maxRetries &&\n (response.status === 429 || response.status >= 500)\n ) {\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n const delayMs =\n retryAfter !== undefined ? retryAfter * 1000 : calculateBackoffMs(attempt);\n\n attempt += 1;\n await sleep(delayMs);\n\n response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n }\n\n return response;\n }\n}\n\nfunction toTransportError(error: unknown): SoundlinkParseError {\n if (error instanceof Error) {\n return new SoundlinkParseError(`Network request failed: ${error.message}`);\n }\n\n return new SoundlinkParseError('Network request failed.');\n}\n\nfunction attachRowCountMetadata<T>(\n stream: AsyncIterable<T>,\n rowCount?: number,\n): JsonlStream<T> {\n const jsonlStream: JsonlStream<T> = {\n async *[Symbol.asyncIterator]() {\n for await (const row of stream) {\n yield row;\n }\n },\n };\n\n if (rowCount !== undefined && !Number.isNaN(rowCount)) {\n jsonlStream.rowCount = rowCount;\n }\n\n return jsonlStream;\n}\n\n/**\n * Read `rowCount` from a {@link JsonlStream} when the API sent `X-Row-Count`.\n *\n * @returns Row count, or `undefined` if not available.\n */\nexport function getStreamRowCount<T>(stream: AsyncIterable<T>): number | undefined {\n if (typeof stream === 'object' && 'rowCount' in stream) {\n const value = (stream as JsonlStream<T>).rowCount;\n return typeof value === 'number' ? value : undefined;\n }\n\n return undefined;\n}\n","import type { HttpClient } from '../client/http-client.js';\nimport type { JsonlStream } from '../types/api.js';\nimport { collectNdjsonStream } from '../core/jsonl.js';\nimport type {\n ApiResponse,\n BreakdownExportParams,\n BreakdownListData,\n BreakdownListParams,\n BreakdownRow,\n CampaignActivityData,\n CampaignActivityParams,\n CampaignAutoRenewData,\n CampaignCreateData,\n CampaignDetail,\n CampaignListData,\n CampaignListParams,\n CampaignStopData,\n CampaignTiersData,\n CreateCampaignRequest,\n CreateSoundlinkRequest,\n CreativeDailyData,\n CreativeDailyParams,\n CreativeMetrics,\n DateRangeParams,\n DecreaseCampaignBudgetData,\n DecreaseCampaignBudgetRequest,\n EngagementExportParams,\n EngagementRow,\n ExportCollection,\n IdempotencyOptions,\n IncreaseCampaignBudgetData,\n IncreaseCampaignBudgetRequest,\n MetricsOverview,\n Pixel,\n PixelListData,\n PixelTestEventData,\n PingData,\n SoundlinkBreakdownListData,\n SoundlinkBreakdownListParams,\n SoundlinkBreakdownRow,\n SoundlinkDetail,\n SoundlinkEngagementListData,\n SoundlinkEngagementListParams,\n SoundlinkEngagementRow,\n SoundlinkListData,\n SoundlinkListParams,\n SoundlinkMetricsOverview,\n StrategiesCatalogData,\n UpdateCampaignAutoRenewRequest,\n UpdateCampaignTiersRequest,\n UpdatePixelRequest,\n WalletData,\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 id - Campaign or soundlink ID.\n * @param params - Optional date range (max 90 days per request).\n */\n (id: 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(id: string, params?: P): Promise<ApiResponse<ExportCollection<T>>>;\n}\n\nfunction createExportResource<T, P extends DateRangeParams>(\n http: HttpClient,\n buildPath: (id: string) => string,\n buildQuery: (\n params: P,\n ) => Record<string, string | number | boolean | undefined | null>,\n): ExportResource<T, P> {\n const exportFn = ((id: string, params: P = {} as P) => {\n return http.getJsonl<T>({\n path: buildPath(id),\n query: buildQuery(params),\n });\n }) as ExportResource<T, P>;\n\n exportFn.collect = async (id: string, params: P = {} as P) => {\n const response = await exportFn(id, 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/** Organization wallet (`GET /v1/wallet`). Requires `wallet:read`. */\nexport class WalletResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Wallet snapshot for the organization on the API key.\n *\n * Maps to `GET /v1/wallet`. `available` is balance minus active reservations.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.wallet.get();\n * ```\n */\n get(): Promise<ApiResponse<WalletData>> {\n return this.http.get<WalletData>({ path: '/wallet' });\n }\n}\n\n/** Strategy catalog (`GET /v1/strategies`). Requires `campaigns:read`. */\nexport class StrategiesResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * List growth strategies available for wallet campaign create.\n *\n * Maps to `GET /v1/strategies`.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.strategies.list();\n * ```\n */\n list(): Promise<ApiResponse<StrategiesCatalogData>> {\n return this.http.get<StrategiesCatalogData>({ path: '/strategies' });\n }\n}\n\n/**\n * Organization Meta pixels (`/v1/pixels`).\n * Read needs `pixels:read`; write and test-events need `pixels:write`.\n */\nexport class PixelsResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * List Meta pixels saved for the organization.\n *\n * Maps to `GET /v1/pixels`. Requires `pixels:read`.\n * Returns `403 custom_pixel_not_enabled` when the feature is off.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.pixels.list();\n * ```\n */\n list(): Promise<ApiResponse<PixelListData>> {\n return this.http.get<PixelListData>({ path: '/pixels' });\n }\n\n /**\n * Save or rotate a Meta pixel access token.\n *\n * Maps to `PUT /v1/pixels/{pixelId}`. Requires `pixels:write`.\n * Does not require an `Idempotency-Key`. The access token is never returned.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.pixels.update('1234567890123456', {\n * platform: 'meta',\n * accessToken: process.env.META_CAPI_TOKEN!,\n * });\n * ```\n */\n update(pixelId: string, body: UpdatePixelRequest): Promise<ApiResponse<Pixel>> {\n return this.http.put<Pixel>({\n path: `/pixels/${encodeURIComponent(pixelId)}`,\n body,\n });\n }\n\n /**\n * Send a live Meta Conversions API test event to a saved pixel.\n *\n * Maps to `POST /v1/pixels/{pixelId}/test-events`. Requires `pixels:write`.\n * This is not a sandbox event — it appears in Events Manager.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.pixels.sendTestEvent('1234567890123456');\n * ```\n */\n sendTestEvent(pixelId: string): Promise<ApiResponse<PixelTestEventData>> {\n return this.http.post<PixelTestEventData>({\n path: `/pixels/${encodeURIComponent(pixelId)}/test-events`,\n });\n }\n}\n\n/** Campaign tiers (`/v1/campaigns/{id}/tiers`). Wallet only (`generation: 3`). */\nexport class CampaignTiersResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Get current tier allocation for a wallet campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/tiers`. Wallet campaigns only (`generation: 3`).\n */\n get(campaignId: string): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.get<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n });\n }\n\n /**\n * Update tier enablement and budget shares.\n *\n * Maps to `PATCH /v1/campaigns/{campaignId}/tiers`. Requires `campaigns:write`.\n * Allocation percents across items must sum to 100.\n * Use each tier's `tierId` from {@link CampaignTiersResource.get} as `targetingTierId`.\n * Does not require an `Idempotency-Key` (unlike create / stop / budget).\n */\n update(\n campaignId: string,\n body: UpdateCampaignTiersRequest,\n ): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.patch<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n body,\n });\n }\n}\n\n/** Campaign listing, detail, and wallet write surface (`/v1/campaigns/*`). */\nexport class CampaignsResource {\n /** Tier allocation for wallet campaigns (`generation: 3`). */\n readonly tiers: CampaignTiersResource;\n\n constructor(private readonly http: HttpClient) {\n this.tiers = new CampaignTiersResource(http);\n }\n\n /**\n * List campaigns for the authenticated organization.\n *\n * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**. Requires `campaigns:read`.\n *\n * @param params - Pagination and sort options.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.list({ page: 1, pageSize: 100 });\n * ```\n */\n list(params: CampaignListParams = {}): Promise<ApiResponse<CampaignListData>> {\n return this.http.get<CampaignListData>({\n path: '/campaigns',\n query: {\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n\n /**\n * Fetch full details for a single campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}`. Requires `campaigns:read`.\n *\n * @param campaignId - Campaign identifier returned by {@link CampaignsResource.list}.\n */\n get(campaignId: string): Promise<ApiResponse<CampaignDetail>> {\n return this.http.get<CampaignDetail>({\n path: `/campaigns/${encodeURIComponent(campaignId)}`,\n });\n }\n\n /**\n * Page of creative adds, budget changes, and other campaign events.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/activity`. Requires `campaigns:read`.\n * Omit `startDate` for the full history. Max `pageSize` is **100**.\n */\n activity(\n campaignId: string,\n params: CampaignActivityParams = {},\n ): Promise<ApiResponse<CampaignActivityData>> {\n return this.http.get<CampaignActivityData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/activity`,\n query: {\n startDate: params.startDate,\n page: params.page,\n pageSize: params.pageSize,\n },\n });\n }\n\n /**\n * Create a wallet-funded campaign.\n *\n * Maps to `POST /v1/campaigns`. Requires `campaigns:write` and `Idempotency-Key`.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.create(\n * {\n * spotifyUrl: 'https://open.spotify.com/track/...',\n * dailyBudget: 20,\n * durationDays: 7,\n * genre: 'Pop',\n * strategyType: 'maximum_growth',\n * },\n * { idempotencyKey: 'create-mytrack-01' },\n * );\n * ```\n */\n create(\n body: CreateCampaignRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignCreateData>> {\n return this.http.post<CampaignCreateData>({\n path: '/campaigns',\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Stop a wallet campaign and refund unspent budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/stop`. Requires `campaigns:write`\n * and `Idempotency-Key`. Wallet campaigns only (`generation: 3`).\n */\n stop(\n campaignId: string,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignStopData>> {\n return this.http.post<CampaignStopData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/stop`,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Increase wallet campaign budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/increase`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n increaseBudget(\n campaignId: string,\n body: IncreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<IncreaseCampaignBudgetData>> {\n return this.http.post<IncreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/increase`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Decrease wallet campaign daily budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/decrease`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n decreaseBudget(\n campaignId: string,\n body: DecreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<DecreaseCampaignBudgetData>> {\n return this.http.post<DecreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/decrease`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Set auto-renew for a wallet campaign.\n *\n * Maps to `PUT /v1/campaigns/{campaignId}/auto-renew`. Requires `campaigns:write`\n * and `Idempotency-Key`. Wallet campaigns only (`generation: 3`).\n */\n updateAutoRenew(\n campaignId: string,\n body: UpdateCampaignAutoRenewRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignAutoRenewData>> {\n return this.http.put<CampaignAutoRenewData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/auto-renew`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Async iterator over every campaign across all pages.\n *\n * Stops silently if a page request returns an error.\n *\n * @param params - Same as {@link CampaignsResource.list} except `page` is managed automatically.\n *\n * @example\n * ```ts\n * for await (const campaign of soundlink.campaigns.listAll({ pageSize: 100 })) {\n * console.log(campaign.campaignId);\n * }\n * ```\n */\n async *listAll(\n params: Omit<CampaignListParams, 'page'> = {},\n ): AsyncGenerator<CampaignListData['items'][number], void, void> {\n let page = 1;\n let totalPages = 1;\n\n while (page <= totalPages) {\n const response = await this.list({ ...params, page });\n\n if (response.error || !response.data) {\n return;\n }\n\n for (const item of response.data.items) {\n yield item;\n }\n\n totalPages = response.data.pagination.totalPages;\n page += 1;\n }\n }\n}\n\n/**\n * Self-serve soundlinks (`/v1/soundlinks/*`).\n *\n * List, get, and metrics require `soundlinks:read`. Create and delete require\n * `soundlinks:write`. Only soundlinks that are **not** linked to a campaign.\n * Campaign-backed soundlinks are served by the Campaigns API.\n *\n * @example\n * ```ts\n * await soundlink.soundlinks.list();\n * await soundlink.soundlinks.get(soundlinkId);\n * await soundlink.soundlinks.create({ name, spotifyUrl }, { idempotencyKey });\n * await soundlink.soundlinks.delete(soundlinkId);\n * await soundlink.soundlinks.metricsOverview(soundlinkId);\n * ```\n */\nexport class SoundlinksResource {\n /** Per-day country breakdown and JSONL export. */\n readonly breakdown: SoundlinkBreakdownMetricsResource;\n\n /** Per-day track engagement and JSONL export. */\n readonly engagement: SoundlinkEngagementMetricsResource;\n\n constructor(private readonly http: HttpClient) {\n this.breakdown = new SoundlinkBreakdownMetricsResource(http);\n this.engagement = new SoundlinkEngagementMetricsResource(http);\n }\n\n /**\n * List self-serve soundlinks for the authenticated organization.\n *\n * Maps to `GET /v1/soundlinks`. Max `pageSize` is **100**. Requires `soundlinks:read`.\n *\n * @param params - Pagination and sort options.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.soundlinks.list({ page: 1, pageSize: 100 });\n * ```\n */\n list(params: SoundlinkListParams = {}): Promise<ApiResponse<SoundlinkListData>> {\n return this.http.get<SoundlinkListData>({\n path: '/soundlinks',\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 details for a single self-serve soundlink.\n *\n * Maps to `GET /v1/soundlinks/{soundlinkId}`. Requires `soundlinks:read`.\n * Campaign-linked soundlinks return `404`.\n *\n * @param soundlinkId - Identifier returned by {@link SoundlinksResource.list}.\n */\n get(soundlinkId: string): Promise<ApiResponse<SoundlinkDetail>> {\n return this.http.get<SoundlinkDetail>({\n path: `/soundlinks/${encodeURIComponent(soundlinkId)}`,\n });\n }\n\n /**\n * Create a self-serve soundlink.\n *\n * Maps to `POST /v1/soundlinks`. Requires `soundlinks:write` and\n * `Idempotency-Key`. Does not create a campaign.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.soundlinks.create(\n * {\n * name: 'Midnight Drive',\n * spotifyUrl: 'https://open.spotify.com/track/...',\n * },\n * { idempotencyKey: 'create-midnight-drive-01' },\n * );\n * ```\n */\n create(\n body: CreateSoundlinkRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<SoundlinkDetail>> {\n return this.http.post<SoundlinkDetail>({\n path: '/soundlinks',\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Archive a self-serve soundlink (`status: archived`). Same as Archive in the app.\n *\n * Maps to `DELETE /v1/soundlinks/{soundlinkId}`. Requires `soundlinks:write`.\n * Does not send `Idempotency-Key`. List and detail still return the row.\n */\n delete(soundlinkId: string): Promise<ApiResponse<SoundlinkDetail>> {\n return this.http.delete<SoundlinkDetail>({\n path: `/soundlinks/${encodeURIComponent(soundlinkId)}`,\n });\n }\n\n /**\n * Soundlink-level metric totals for a date range.\n *\n * Maps to `GET /v1/soundlinks/{soundlinkId}/metrics/overview`.\n * Omit `startDate` to default to the soundlink creation date.\n * No financial fields. Requires `soundlinks:read`.\n *\n * @param soundlinkId - Soundlink identifier.\n * @param params - Inclusive `YYYY-MM-DD` date range.\n */\n metricsOverview(\n soundlinkId: string,\n params: DateRangeParams = {},\n ): Promise<ApiResponse<SoundlinkMetricsOverview>> {\n return this.http.get<SoundlinkMetricsOverview>({\n path: `/soundlinks/${encodeURIComponent(soundlinkId)}/metrics/overview`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n },\n });\n }\n}\n\n/**\n * Country-level daily metrics (`soundlink_country_daily` schema).\n *\n * Access via `soundlink.soundlinks.breakdown`.\n */\nexport class SoundlinkBreakdownMetricsResource {\n /**\n * Stream full breakdown export as JSONL.\n *\n * Maps to `GET /v1/soundlinks/{soundlinkId}/metrics/breakdown/export`.\n */\n readonly export: ExportResource<SoundlinkBreakdownRow, BreakdownExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<SoundlinkBreakdownRow, BreakdownExportParams>(\n http,\n (soundlinkId) =>\n `/soundlinks/${encodeURIComponent(soundlinkId)}/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/soundlinks/{soundlinkId}/metrics/breakdown`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param soundlinkId - Soundlink identifier.\n * @param params - Date range, pagination, and sort options.\n */\n list(\n soundlinkId: string,\n params: SoundlinkBreakdownListParams = {},\n ): Promise<ApiResponse<SoundlinkBreakdownListData>> {\n return this.http.get<SoundlinkBreakdownListData>({\n path: `/soundlinks/${encodeURIComponent(soundlinkId)}/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 (`soundlink_engagement_daily` schema).\n *\n * Access via `soundlink.soundlinks.engagement`.\n */\nexport class SoundlinkEngagementMetricsResource {\n /**\n * Stream full engagement export as JSONL.\n *\n * Maps to `GET /v1/soundlinks/{soundlinkId}/metrics/engagement/export`.\n */\n readonly export: ExportResource<SoundlinkEngagementRow, EngagementExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<SoundlinkEngagementRow, EngagementExportParams>(\n http,\n (soundlinkId) =>\n `/soundlinks/${encodeURIComponent(soundlinkId)}/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/soundlinks/{soundlinkId}/metrics/engagement`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param soundlinkId - Soundlink identifier.\n * @param params - Date range, engagement context filter, pagination, and sort.\n */\n list(\n soundlinkId: string,\n params: SoundlinkEngagementListParams = {},\n ): Promise<ApiResponse<SoundlinkEngagementListData>> {\n return this.http.get<SoundlinkEngagementListData>({\n path: `/soundlinks/${encodeURIComponent(soundlinkId)}/metrics/engagement`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n engagementContext: params.engagementContext,\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n}\n\n/**\n * Campaign metrics (`/v1/campaigns/{id}/metrics/*`). Requires `metrics:read`.\n *\n * @example\n * ```ts\n * await soundlink.metrics.overview(campaignId);\n * await soundlink.metrics.breakdown.list(campaignId);\n * await soundlink.metrics.engagement.export(campaignId);\n * ```\n */\nexport class MetricsResource {\n /** Per-day country breakdown and JSONL export. */\n readonly breakdown: BreakdownMetricsResource;\n\n /** Per-track engagement JSONL export. */\n readonly engagement: EngagementMetricsResource;\n\n constructor(private readonly http: HttpClient) {\n this.breakdown = new BreakdownMetricsResource(http);\n this.engagement = new EngagementMetricsResource(http);\n }\n\n /**\n * Campaign-level metric totals for a date range.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/overview`.\n * Aggregates across all countries — use {@link BreakdownMetricsResource.list} for daily rows.\n *\n * @param campaignId - Campaign identifier.\n * @param params - Inclusive `YYYY-MM-DD` date range. Omit for API defaults.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.metrics.overview(campaignId, {\n * startDate: '2026-01-01',\n * endDate: '2026-03-31',\n * });\n * ```\n */\n overview(\n campaignId: string,\n params: DateRangeParams = {},\n ): Promise<ApiResponse<MetricsOverview>> {\n return this.http.get<MetricsOverview>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/overview`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n },\n });\n }\n\n /**\n * Lifetime creative performance, grouped by background video.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/creatives`.\n * Snapshot only — do not send a date range.\n */\n creatives(campaignId: string): Promise<ApiResponse<CreativeMetrics>> {\n return this.http.get<CreativeMetrics>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/creatives`,\n });\n }\n\n /**\n * One row per day and Meta ad creative.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/creative-daily`.\n * Requires `metrics:read`. Omit both dates for every day that has rows.\n * Max `pageSize` is **500**.\n */\n creativeDaily(\n campaignId: string,\n params: CreativeDailyParams = {},\n ): Promise<ApiResponse<CreativeDailyData>> {\n return this.http.get<CreativeDailyData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/creative-daily`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n page: params.page,\n pageSize: params.pageSize,\n },\n });\n }\n}\n\n/**\n * Country-level daily metrics (`campaign_country_daily` schema).\n *\n * Access via `soundlink.metrics.breakdown`.\n */\nexport class BreakdownMetricsResource {\n /**\n * Stream full breakdown export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown/export`.\n */\n readonly export: ExportResource<BreakdownRow, BreakdownExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<BreakdownRow, BreakdownExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n }),\n );\n }\n\n /**\n * Paginated per-day, per-country breakdown rows.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param campaignId - Campaign identifier.\n * @param params - Date range, pagination, and sort options.\n */\n list(\n campaignId: string,\n params: BreakdownListParams = {},\n ): Promise<ApiResponse<BreakdownListData>> {\n return this.http.get<BreakdownListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n}\n\n/**\n * Per-track engagement metrics (`campaign_engagement_daily` schema).\n *\n * Access via `soundlink.metrics.engagement`. Only JSONL export is shipped.\n */\nexport class EngagementMetricsResource {\n /**\n * Stream full engagement export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement/export`.\n */\n readonly export: ExportResource<EngagementRow, EngagementExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<EngagementRow, EngagementExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n engagementContext: params.engagementContext,\n }),\n );\n }\n}\n","import { HttpClient } from './http-client.js';\nimport {\n CampaignsResource,\n MetricsResource,\n PingResource,\n PixelsResource,\n SoundlinksResource,\n StrategiesResource,\n WalletResource,\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 /** Organization wallet snapshot. Requires `wallet:read` scope. */\n readonly wallet: WalletResource;\n\n /** Growth strategy catalog. Requires `campaigns:read` scope. */\n readonly strategies: StrategiesResource;\n\n /** Organization Meta pixels. Read needs `pixels:read`; write needs `pixels:write`. */\n readonly pixels: PixelsResource;\n\n /** List, fetch, and manage campaigns. Read needs `campaigns:read`; writes need `campaigns:write`. */\n readonly campaigns: CampaignsResource;\n\n /** Self-serve soundlinks. Read needs `soundlinks:read`; create/delete need `soundlinks:write`. */\n readonly soundlinks: SoundlinksResource;\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.wallet = new WalletResource(http);\n this.strategies = new StrategiesResource(http);\n this.pixels = new PixelsResource(http);\n this.campaigns = new CampaignsResource(http);\n this.soundlinks = new SoundlinksResource(http);\n this.metrics = new MetricsResource(http);\n }\n}\n\nexport { HttpClient, resolveClientOptions } from './http-client.js';\n"]}