soundlink 1.1.1 → 1.2.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 +7 -1
- package/README.md +103 -24
- package/dist/cjs/index.cjs +175 -30
- package/dist/cjs/index.cjs.map +1 -1
- package/dist/esm/index.d.ts +254 -41
- package/dist/esm/index.js +175 -30
- package/dist/esm/index.js.map +1 -1
- package/openapi/soundlink-public-api-v1.yaml +1309 -211
- package/package.json +1 -1
package/dist/cjs/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/constants/defaults.ts","../../src/core/api-response.ts","../../src/errors/sdk-error.ts","../../src/core/jsonl.ts","../../src/utils/query.ts","../../src/client/http-client.ts","../../src/resources/index.ts","../../src/client/soundlink.ts"],"names":[],"mappings":";;;AAAO,IAAM,gBAAA,GAAmB;AAEzB,IAAM,kBAAA,GAAqB;AAE3B,IAAM,mBAAA,GAAsB;AAE5B,IAAM,cAAA,GAAiB;AAEvB,IAAM,uBAAA,GAA0B;AAEhC,IAAM,qBAAA,GAAwB;AAM9B,IAAM,kBAAA,GAAqB,KAAA;;;ACP3B,SAAS,mBAAmB,IAAA,EAAyC;AAC1E,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,KAAS,IAAA,EAAM;AAC7C,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,IAAA;AACf,EAAA,OACE,OAAO,MAAA,CAAO,KAAA,KAAU,QAAA,IACxB,OAAO,KAAA,KAAU,IAAA,IACjB,OAAQ,MAAA,CAAO,MAAkC,IAAA,KAAS,QAAA,IAC1D,OAAQ,MAAA,CAAO,MAAkC,OAAA,KAAY,QAAA;AAEjE;AAEO,SAAS,qBAAwB,IAAA,EAA8C;AACpF,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,KAAS,IAAA,EAAM;AAC7C,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,IAAA;AACf,EAAA,OAAO,UAAU,MAAA,IAAU,OAAO,OAAO,IAAA,KAAS,QAAA,IAAY,OAAO,IAAA,KAAS,IAAA;AAChF;AAEO,SAAS,UAAA,CACd,QAAA,EACA,MAAA,EACA,UAAA,EACU;AACV,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAS,KAAA,CAAM,IAAA;AAAA,IACrB,OAAA,EAAS,SAAS,KAAA,CAAM,OAAA;AAAA,IACxB,MAAA;AAAA,IACA,SAAA,EAAW,SAAS,IAAA,CAAK,SAAA;AAAA,IACzB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe;AAAC,GACnD;AACF;AAEO,SAAS,eAAA,CAAmB,MAAS,IAAA,EAA+B;AACzE,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,KAAA,EAAO,IAAA;AAAA,IACP;AAAA,GACF;AACF;AAEO,SAAS,cAAiB,KAAA,EAAiC;AAChE,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,IAAA;AAAA,IACN,KAAA;AAAA,IACA,GAAI,KAAA,CAAM,SAAA,GAAY,EAAE,IAAA,EAAM,EAAE,SAAA,EAAW,KAAA,CAAM,SAAA,EAAU,EAAE,GAAI;AAAC,GACpE;AACF;AAEO,SAAS,sBAAsB,KAAA,EAA0C;AAC9E,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,QAAA,CAAS,KAAA,EAAO,EAAE,CAAA;AACzC,EAAA,IAAI,MAAA,CAAO,QAAA,CAAS,OAAO,CAAA,IAAK,WAAW,CAAA,EAAG;AAC5C,IAAA,OAAO,OAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,KAAK,CAAA;AAC/B,EAAA,IAAI,MAAA,CAAO,QAAA,CAAS,MAAM,CAAA,EAAG;AAC3B,IAAA,MAAM,eAAe,IAAA,CAAK,IAAA,CAAA,CAAM,SAAS,IAAA,CAAK,GAAA,MAAS,GAAI,CAAA;AAC3D,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,YAAA,EAAc,CAAC,CAAA;AAAA,EACjC;AAEA,EAAA,OAAO,MAAA;AACT;;;AC1EO,IAAM,iBAAA,GAAN,MAAM,kBAAA,SAA0B,KAAA,CAAM;AAAA,EAC3C,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,mBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,kBAAA,CAAkB,SAAS,CAAA;AAAA,EACzD;AACF;AAGO,IAAM,mBAAA,GAAN,MAAM,oBAAA,SAA4B,iBAAA,CAAkB;AAAA,EACzD,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,qBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,oBAAA,CAAoB,SAAS,CAAA;AAAA,EAC3D;AACF;AAGO,IAAM,oBAAA,GAAN,MAAM,qBAAA,SAA6B,iBAAA,CAAkB;AAAA,EAC1D,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AACZ,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,qBAAA,CAAqB,SAAS,CAAA;AAAA,EAC5D;AACF;;;AC3BA,gBAAuB,iBAAA,CACrB,MACA,eAAA,EACmB;AACnB,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,MAAA,GAAS,KAAK,SAAA,EAAU;AAC9B,EAAA,MAAM,OAAA,GAAU,IAAI,WAAA,EAAY;AAChC,EAAA,IAAI,MAAA,GAAS,EAAA;AAEb,EAAA,IAAI;AACF,IAAA,WAAS;AACP,MAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,MAAA,IAAI,IAAA,EAAM;AACR,QAAA;AAAA,MACF;AAEA,MAAA,MAAA,IAAU,QAAQ,MAAA,CAAO,KAAA,EAAO,EAAE,MAAA,EAAQ,MAAM,CAAA;AAChD,MAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA;AAC/B,MAAA,MAAA,GAAS,KAAA,CAAM,KAAI,IAAK,EAAA;AAExB,MAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,QAAA,MAAM,OAAA,GAAU,KAAK,IAAA,EAAK;AAC1B,QAAA,IAAI,CAAC,OAAA,EAAS;AACZ,UAAA;AAAA,QACF;AAEA,QAAA,IAAI;AACF,UAAA,MAAM,IAAA,CAAK,MAAM,OAAO,CAAA;AAAA,QAC1B,SAAS,KAAA,EAAO;AACd,UAAA,eAAA,GAAkB,SAAS,KAAK,CAAA;AAChC,UAAA,MAAM,IAAI,oBAAoB,oCAAoC,CAAA;AAAA,QACpE;AAAA,MACF;AAAA,IACF;AAEA,IAAA,MAAM,QAAA,GAAW,OAAO,IAAA,EAAK;AAC7B,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAK,MAAM,QAAQ,CAAA;AAAA,MAC3B,SAAS,KAAA,EAAO;AACd,QAAA,eAAA,GAAkB,UAAU,KAAK,CAAA;AACjC,QAAA,MAAM,IAAI,oBAAoB,oCAAoC,CAAA;AAAA,MACpE;AAAA,IACF;AAAA,EACF,CAAA,SAAE;AACA,IAAA,MAAA,CAAO,WAAA,EAAY;AAAA,EACrB;AACF;AAEA,eAAsB,oBACpB,MAAA,EAC0C;AAC1C,EAAA,MAAM,OAAY,EAAC;AACnB,EAAA,WAAA,MAAiB,OAAO,MAAA,EAAQ;AAC9B,IAAA,IAAA,CAAK,KAAK,GAAG,CAAA;AAAA,EACf;AACA,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,UAAU,IAAA,CAAK;AAAA,GACjB;AACF;;;ACjEO,SAAS,iBACd,MAAA,EACQ;AACR,EAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AAEzC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AACjD,IAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,IAAQ,UAAU,EAAA,EAAI;AACzD,MAAA;AAAA,IACF;AACA,IAAA,YAAA,CAAa,GAAA,CAAI,GAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACrC;AAEA,EAAA,MAAM,KAAA,GAAQ,aAAa,QAAA,EAAS;AACpC,EAAA,OAAO,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAA;AAC/B;AAEO,SAAS,OAAA,CAAQ,SAAiB,IAAA,EAAsB;AAC7D,EAAA,MAAM,cAAA,GAAiB,QAAQ,QAAA,CAAS,GAAG,IAAI,OAAA,CAAQ,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAAI,OAAA;AACtE,EAAA,MAAM,iBAAiB,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA,GAAI,IAAA,GAAO,IAAI,IAAI,CAAA,CAAA;AAC7D,EAAA,OAAO,CAAA,EAAG,cAAc,CAAA,EAAG,cAAc,CAAA,CAAA;AAC3C;AAEO,SAAS,MAAM,EAAA,EAA2B;AAC/C,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY;AAC9B,IAAA,UAAA,CAAW,SAAS,EAAE,CAAA;AAAA,EACxB,CAAC,CAAA;AACH;AAEO,SAAS,mBAAmB,OAAA,EAAyB;AAC1D,EAAA,MAAM,IAAA,GAAO,GAAA;AACb,EAAA,MAAM,SAAS,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,GAAG,CAAA;AAC7C,EAAA,OAAO,IAAA,GAAO,KAAK,OAAA,GAAU,MAAA;AAC/B;;;ACiBO,SAAS,qBACd,OAAA,EACgC;AAChC,EAAA,MAAM,aAAa,OAAO,OAAA,KAAY,WAAW,EAAE,MAAA,EAAQ,SAAQ,GAAI,OAAA;AAEvE,EAAA,MAAM,MAAA,GAAS,UAAA,CAAW,MAAA,CAAO,IAAA,EAAK;AACtC,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,qBAAqB,qBAAqB,CAAA;AAAA,EACtD;AAEA,EAAA,IAAI,CAAC,MAAA,CAAO,UAAA,CAAW,cAAc,CAAA,EAAG;AACtC,IAAA,MAAM,IAAI,oBAAA;AAAA,MACR,yDAAyD,cAAc,CAAA,EAAA;AAAA,KACzE;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,OAAA,EAAS,WAAW,OAAA,IAAW,gBAAA;AAAA,IAC/B,OAAA,EAAS,WAAW,OAAA,IAAW,kBAAA;AAAA,IAC/B,UAAA,EAAY,WAAW,UAAA,IAAc,mBAAA;AAAA,IACrC,OAAO,UAAA,CAAW,KAAA,IAAS,UAAA,CAAW,KAAA,CAAM,KAAK,UAAU;AAAA,GAC7D;AACF;AAEO,IAAM,aAAN,MAAiB;AAAA,EACL,OAAA;AAAA,EAEjB,YAAY,OAAA,EAA2B;AACrC,IAAA,IAAA,CAAK,OAAA,GAAU,qBAAqB,OAAO,CAAA;AAAA,EAC7C;AAAA,EAEA,IAAI,eAAA,GAAkD;AACpD,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA,EAEA,MAAM,GAAA,CAAO,EAAE,IAAA,EAAM,OAAM,EAA4C;AACrE,IAAA,MAAM,GAAA,GAAM,OAAA;AAAA,MACV,KAAK,OAAA,CAAQ,OAAA;AAAA,MACb,CAAA,EAAG,kBAAkB,CAAA,EAAG,IAAI,GAAG,gBAAA,CAAiB,KAAA,IAAS,EAAE,CAAC,CAAA;AAAA,KAC9D;AAEA,IAAA,OAAO,IAAA,CAAK,YAAe,GAAA,EAAK;AAAA,MAC9B,MAAA,EAAQ,KAAA;AAAA,MACR,OAAA,EAAS,KAAK,YAAA;AAAa,KAC5B,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,QAAA,CAAY;AAAA,IAChB,IAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA,GAAS;AAAA,GACX,EAA2D;AACzD,IAAA,MAAM,GAAA,GAAM,OAAA;AAAA,MACV,KAAK,OAAA,CAAQ,OAAA;AAAA,MACb,CAAA,EAAG,kBAAkB,CAAA,EAAG,IAAI,GAAG,gBAAA,CAAiB,KAAA,IAAS,EAAE,CAAC,CAAA;AAAA,KAC9D;AAEA,IAAA,IAAI,QAAA;AACJ,IAAA,IAAI;AACF,MAAA,QAAA,GAAW,MAAM,IAAA,CAAK,cAAA,CAAe,GAAA,EAAK;AAAA,QACxC,MAAA,EAAQ,KAAA;AAAA,QACR,OAAA,EAAS;AAAA,UACP,GAAG,KAAK,YAAA,EAAa;AAAA,UACrB,MAAA,EAAQ;AAAA;AACV,OACD,CAAA;AAAA,IACH,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,iBAAiB,KAAK,CAAA;AAAA,IAC9B;AAEA,IAAA,MAAM,aAAa,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAE5E,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,OAAO,IAAA,CAAK,kBAAA,CAAmC,QAAA,EAAU,UAAU,CAAA;AAAA,IACrE;AAEA,IAAA,MAAM,WAAA,GAAc,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,cAAc,CAAA,IAAK,EAAA;AAC5D,IAAA,IAAI,WAAA,CAAY,QAAA,CAAS,kBAAkB,CAAA,EAAG;AAC5C,MAAA,OAAO,IAAA,CAAK,kBAAA,CAAmC,QAAA,EAAU,UAAU,CAAA;AAAA,IACrE;AAEA,IAAA,MAAM,cAAA,GAAiB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAA;AACzD,IAAA,MAAM,iBACJ,cAAA,KAAmB,IAAA,GAAO,OAAO,QAAA,CAAS,cAAA,EAAgB,EAAE,CAAA,GAAI,MAAA;AAElE,IAAA,MAAM,MAAA,GAAS,iBAAA,CAAqB,QAAA,CAAS,IAAI,CAAA;AACjD,IAAA,MAAM,IAAA,GAAO,sBAAA,CAAuB,MAAA,EAAQ,cAAc,CAAA;AAE1D,IAAA,OAAO;AAAA,MACL,IAAA;AAAA,MACA,KAAA,EAAO;AAAA,KACT;AAAA,EACF;AAAA,EAEQ,YAAA,GAAuC;AAC7C,IAAA,OAAO;AAAA,MACL,WAAA,EAAa,KAAK,OAAA,CAAQ,MAAA;AAAA,MAC1B,MAAA,EAAQ;AAAA,KACV;AAAA,EACF;AAAA,EAEA,MAAc,WAAA,CACZ,GAAA,EACA,IAAA,EACyB;AACzB,IAAA,IAAI,QAAA;AAEJ,IAAA,IAAI;AACF,MAAA,QAAA,GAAW,MAAM,IAAA,CAAK,cAAA,CAAe,GAAA,EAAK,IAAI,CAAA;AAAA,IAChD,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,iBAAiB,KAAK,CAAA;AAAA,IAC9B;AAEA,IAAA,MAAM,aAAa,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAE5E,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,OAAO,IAAA,CAAK,kBAAA,CAAsB,QAAA,EAAU,UAAU,CAAA;AAAA,IACxD;AAEA,IAAA,IAAI,IAAA;AACJ,IAAA,IAAI;AACF,MAAA,IAAA,GAAO,MAAM,SAAS,IAAA,EAAK;AAAA,IAC7B,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,mBAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AAEA,IAAA,IAAI,kBAAA,CAAmB,IAAI,CAAA,EAAG;AAC5B,MAAA,OAAO,cAAc,UAAA,CAAW,IAAA,EAAM,QAAA,CAAS,MAAA,EAAQ,UAAU,CAAC,CAAA;AAAA,IACpE;AAEA,IAAA,IAAI,oBAAA,CAAwB,IAAI,CAAA,EAAG;AACjC,MAAA,OAAO,eAAA,CAAgB,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,IAAI,CAAA;AAAA,IAC7C;AAEA,IAAA,MAAM,IAAI,oBAAoB,+CAA+C,CAAA;AAAA,EAC/E;AAAA,EAEA,MAAc,kBAAA,CACZ,QAAA,EACA,UAAA,EACyB;AACzB,IAAA,IAAI,IAAA,GAAgB,IAAA;AAEpB,IAAA,IAAI;AACF,MAAA,IAAA,GAAO,MAAM,SAAS,IAAA,EAAK;AAAA,IAC7B,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,aAAA,CAAc;AAAA,QACnB,IAAA,EAAM,gBAAA;AAAA,QACN,OAAA,EAAS,CAAA,2BAAA,EAA8B,MAAA,CAAO,QAAA,CAAS,MAAM,CAAC,CAAA,CAAA,CAAA;AAAA,QAC9D,QAAQ,QAAA,CAAS,MAAA;AAAA,QACjB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe;AAAC,OAClD,CAAA;AAAA,IACH;AAEA,IAAA,IAAI,kBAAA,CAAmB,IAAI,CAAA,EAAG;AAC5B,MAAA,OAAO,cAAc,UAAA,CAAW,IAAA,EAAM,QAAA,CAAS,MAAA,EAAQ,UAAU,CAAC,CAAA;AAAA,IACpE;AAEA,IAAA,OAAO,aAAA,CAAc;AAAA,MACnB,IAAA,EAAM,gBAAA;AAAA,MACN,OAAA,EAAS,CAAA,2BAAA,EAA8B,MAAA,CAAO,QAAA,CAAS,MAAM,CAAC,CAAA,CAAA,CAAA;AAAA,MAC9D,QAAQ,QAAA,CAAS,MAAA;AAAA,MACjB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe;AAAC,KAClD,CAAA;AAAA,EACH;AAAA,EAEA,MAAc,cAAA,CAAe,GAAA,EAAa,IAAA,EAAsC;AAC9E,IAAA,MAAM,EAAE,UAAA,EAAY,OAAA,EAAS,KAAA,KAAU,IAAA,CAAK,OAAA;AAC5C,IAAA,IAAI,OAAA,GAAU,CAAA;AAEd,IAAA,IAAI,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,MAC9B,GAAG,IAAA;AAAA,MACH,MAAA,EAAQ,WAAA,CAAY,OAAA,CAAQ,OAAO;AAAA,KACpC,CAAA;AAED,IAAA,OACE,UAAU,UAAA,KACT,QAAA,CAAS,WAAW,GAAA,IAAO,QAAA,CAAS,UAAU,GAAA,CAAA,EAC/C;AACA,MAAA,MAAM,aAAa,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAC,CAAA;AAC5E,MAAA,MAAM,UACJ,UAAA,KAAe,MAAA,GAAY,UAAA,GAAa,GAAA,GAAO,mBAAmB,OAAO,CAAA;AAE3E,MAAA,OAAA,IAAW,CAAA;AACX,MAAA,MAAM,MAAM,OAAO,CAAA;AAEnB,MAAA,QAAA,GAAW,MAAM,MAAM,GAAA,EAAK;AAAA,QAC1B,GAAG,IAAA;AAAA,QACH,MAAA,EAAQ,WAAA,CAAY,OAAA,CAAQ,OAAO;AAAA,OACpC,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,QAAA;AAAA,EACT;AACF;AAEA,SAAS,iBAAiB,KAAA,EAAqC;AAC7D,EAAA,IAAI,iBAAiB,KAAA,EAAO;AAC1B,IAAA,OAAO,IAAI,mBAAA,CAAoB,CAAA,wBAAA,EAA2B,KAAA,CAAM,OAAO,CAAA,CAAE,CAAA;AAAA,EAC3E;AAEA,EAAA,OAAO,IAAI,oBAAoB,yBAAyB,CAAA;AAC1D;AAEA,SAAS,sBAAA,CACP,QACA,QAAA,EACgB;AAChB,EAAA,MAAM,WAAA,GAA8B;AAAA,IAClC,QAAQ,MAAA,CAAO,aAAa,CAAA,GAAI;AAC9B,MAAA,WAAA,MAAiB,OAAO,MAAA,EAAQ;AAC9B,QAAA,MAAM,GAAA;AAAA,MACR;AAAA,IACF;AAAA,GACF;AAEA,EAAA,IAAI,aAAa,MAAA,IAAa,CAAC,MAAA,CAAO,KAAA,CAAM,QAAQ,CAAA,EAAG;AACrD,IAAA,WAAA,CAAY,QAAA,GAAW,QAAA;AAAA,EACzB;AAEA,EAAA,OAAO,WAAA;AACT;AAOO,SAAS,kBAAqB,MAAA,EAA8C;AACjF,EAAA,IAAI,OAAO,MAAA,KAAW,QAAA,IAAY,UAAA,IAAc,MAAA,EAAQ;AACtD,IAAA,MAAM,QAAS,MAAA,CAA0B,QAAA;AACzC,IAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,MAAA;AAAA,EAC7C;AAEA,EAAA,OAAO,MAAA;AACT;;;AC7OA,SAAS,oBAAA,CACP,IAAA,EACA,SAAA,EACA,UAAA,EAGsB;AACtB,EAAA,MAAM,QAAA,IAAY,CAAC,UAAA,EAAoB,MAAA,GAAY,EAAC,KAAW;AAC7D,IAAA,OAAO,KAAK,QAAA,CAAY;AAAA,MACtB,IAAA,EAAM,UAAU,UAAU,CAAA;AAAA,MAC1B,KAAA,EAAO,WAAW,MAAM;AAAA,KACzB,CAAA;AAAA,EACH,CAAA,CAAA;AAEA,EAAA,QAAA,CAAS,OAAA,GAAU,OAAO,UAAA,EAAoB,MAAA,GAAY,EAAC,KAAW;AACpE,IAAA,MAAM,QAAA,GAAW,MAAM,QAAA,CAAS,UAAA,EAAY,MAAM,CAAA;AAElD,IAAA,IAAI,QAAA,CAAS,KAAA,IAAS,CAAC,QAAA,CAAS,IAAA,EAAM;AACpC,MAAA,OAAO;AAAA,QACL,IAAA,EAAM,IAAA;AAAA,QACN,OAAO,QAAA,CAAS,KAAA;AAAA,QAChB,MAAM,QAAA,CAAS;AAAA,OACjB;AAAA,IACF;AAEA,IAAA,MAAM,SAAA,GAAY,MAAM,mBAAA,CAAoB,QAAA,CAAS,IAAI,CAAA;AAEzD,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,SAAA;AAAA,MACN,KAAA,EAAO,IAAA;AAAA,MACP,MAAM,QAAA,CAAS;AAAA,KACjB;AAAA,EACF,CAAA;AAEA,EAAA,OAAO,QAAA;AACT;AAGO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA,EAAnB,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAc7B,IAAA,GAAuC;AACrC,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA,CAAc,EAAE,IAAA,EAAM,SAAS,CAAA;AAAA,EAClD;AACF,CAAA;AAGO,IAAM,oBAAN,MAAwB;AAAA,EAC7B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA,EAAnB,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAc7B,IAAA,CAAK,MAAA,GAA6B,EAAC,EAA2C;AAC5E,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAsB;AAAA,MACrC,IAAA,EAAM,YAAA;AAAA,MACN,KAAA,EAAO;AAAA,QACL,MAAM,MAAA,CAAO,IAAA;AAAA,QACb,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,WAAW,MAAA,CAAO;AAAA;AACpB,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,IAAI,UAAA,EAA0D;AAC5D,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAoB;AAAA,MACnC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA;AAAA,KACnD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,OAAO,OAAA,CACL,MAAA,GAA2C,EAAC,EACmB;AAC/D,IAAA,IAAI,IAAA,GAAO,CAAA;AACX,IAAA,IAAI,UAAA,GAAa,CAAA;AAEjB,IAAA,OAAO,QAAQ,UAAA,EAAY;AACzB,MAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,CAAK,EAAE,GAAG,MAAA,EAAQ,MAAM,CAAA;AAEpD,MAAA,IAAI,QAAA,CAAS,KAAA,IAAS,CAAC,QAAA,CAAS,IAAA,EAAM;AACpC,QAAA;AAAA,MACF;AAEA,MAAA,KAAA,MAAW,IAAA,IAAQ,QAAA,CAAS,IAAA,CAAK,KAAA,EAAO;AACtC,QAAA,MAAM,IAAA;AAAA,MACR;AAEA,MAAA,UAAA,GAAa,QAAA,CAAS,KAAK,UAAA,CAAW,UAAA;AACtC,MAAA,IAAA,IAAQ,CAAA;AAAA,IACV;AAAA,EACF;AACF,CAAA;AAYO,IAAM,kBAAN,MAAsB;AAAA,EAO3B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,wBAAA,CAAyB,IAAI,CAAA;AAClD,IAAA,IAAA,CAAK,UAAA,GAAa,IAAI,yBAAA,CAA0B,IAAI,CAAA;AAAA,EACtD;AAAA,EAH6B,IAAA;AAAA;AAAA,EALpB,SAAA;AAAA;AAAA,EAGA,UAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBT,QAAA,CACE,UAAA,EACA,MAAA,GAA0B,EAAC,EACY;AACvC,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAqB;AAAA,MACpC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,iBAAA,CAAA;AAAA,MAClD,KAAA,EAAO;AAAA,QACL,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO;AAAA;AAClB,KACD,CAAA;AAAA,EACH;AACF,CAAA;AAOO,IAAM,2BAAN,MAA+B;AAAA,EAQpC,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,MAAA,GAAS,oBAAA;AAAA,MACZ,IAAA;AAAA,MACA,CAAC,UAAA,KACC,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,yBAAA,CAAA;AAAA,MAC9C,CAAC,MAAA,MAAY;AAAA,QACX,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO;AAAA,OAClB;AAAA,KACF;AAAA,EACF;AAAA,EAV6B,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAFpB,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBT,IAAA,CACE,UAAA,EACA,MAAA,GAA8B,EAAC,EACU;AACzC,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAuB;AAAA,MACtC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,kBAAA,CAAA;AAAA,MAClD,KAAA,EAAO;AAAA,QACL,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO,OAAA;AAAA,QAChB,MAAM,MAAA,CAAO,IAAA;AAAA,QACb,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,WAAW,MAAA,CAAO;AAAA;AACpB,KACD,CAAA;AAAA,EACH;AACF,CAAA;AAOO,IAAM,4BAAN,MAAgC;AAAA,EAQrC,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAC3B,IAAA,IAAA,CAAK,MAAA,GAAS,oBAAA;AAAA,MACZ,IAAA;AAAA,MACA,CAAC,UAAA,KACC,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,0BAAA,CAAA;AAAA,MAC9C,CAAC,MAAA,MAAY;AAAA,QACX,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO,OAAA;AAAA,QAChB,mBAAmB,MAAA,CAAO;AAAA,OAC5B;AAAA,KACF;AAAA,EACF;AAAA,EAX6B,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAFpB,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBT,IAAA,CACE,UAAA,EACA,MAAA,GAA+B,EAAC,EACU;AAC1C,IAAA,OAAO,IAAA,CAAK,KAAK,GAAA,CAAwB;AAAA,MACvC,IAAA,EAAM,CAAA,WAAA,EAAc,kBAAA,CAAmB,UAAU,CAAC,CAAA,mBAAA,CAAA;AAAA,MAClD,KAAA,EAAO;AAAA,QACL,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,SAAS,MAAA,CAAO,OAAA;AAAA,QAChB,MAAM,MAAA,CAAO,IAAA;AAAA,QACb,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,WAAW,MAAA,CAAO,SAAA;AAAA,QAClB,mBAAmB,MAAA,CAAO;AAAA;AAC5B,KACD,CAAA;AAAA,EACH;AACF,CAAA;;;ACzTO,IAAM,YAAN,MAAgB;AAAA;AAAA,EAEZ,IAAA;AAAA;AAAA,EAGA,SAAA;AAAA;AAAA,EAGA,OAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,YAAY,OAAA,EAA2B;AACrC,IAAA,MAAM,IAAA,GAAO,IAAI,UAAA,CAAW,OAAO,CAAA;AACnC,IAAA,MAAM,YAAA,GAAe,IAAI,YAAA,CAAa,IAAI,CAAA;AAE1C,IAAA,IAAA,CAAK,IAAA,GAAO,YAAA,CAAa,IAAA,CAAK,IAAA,CAAK,YAAY,CAAA;AAC/C,IAAA,IAAA,CAAK,SAAA,GAAY,IAAI,iBAAA,CAAkB,IAAI,CAAA;AAC3C,IAAA,IAAA,CAAK,OAAA,GAAU,IAAI,eAAA,CAAgB,IAAI,CAAA;AAAA,EACzC;AACF","file":"index.cjs","sourcesContent":["export const DEFAULT_BASE_URL = 'https://api.getsoundlink.com';\n\nexport const DEFAULT_TIMEOUT_MS = 30_000;\n\nexport const DEFAULT_MAX_RETRIES = 2;\n\nexport const API_KEY_PREFIX = 'sk_';\n\nexport const CAMPAIGNS_MAX_PAGE_SIZE = 100;\n\nexport const METRICS_MAX_PAGE_SIZE = 500;\n\nexport const METRICS_DEFAULT_PAGE_SIZE = 50;\n\nexport const CAMPAIGNS_DEFAULT_PAGE_SIZE = 10;\n\nexport const API_VERSION_PREFIX = '/v1';\n","import type {\n ApiEnvelopeError,\n ApiEnvelopeSuccess,\n ApiMeta,\n ApiError,\n ApiResponse,\n PublicApiErrorCode,\n} from '../types/api.js';\n\nexport function isApiEnvelopeError(body: unknown): body is ApiEnvelopeError {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return (\n typeof record.error === 'object' &&\n record.error !== null &&\n typeof (record.error as Record<string, unknown>).code === 'string' &&\n typeof (record.error as Record<string, unknown>).message === 'string'\n );\n}\n\nexport function isApiEnvelopeSuccess<T>(body: unknown): body is ApiEnvelopeSuccess<T> {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return 'data' in record && typeof record.meta === 'object' && record.meta !== null;\n}\n\nexport function toApiError(\n envelope: ApiEnvelopeError,\n status: number,\n retryAfter?: number,\n): ApiError {\n return {\n code: envelope.error.code as PublicApiErrorCode,\n message: envelope.error.message,\n status,\n requestId: envelope.meta.requestId,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n };\n}\n\nexport function successResponse<T>(data: T, meta: ApiMeta): ApiResponse<T> {\n return {\n data,\n error: null,\n meta,\n };\n}\n\nexport function errorResponse<T>(error: ApiError): ApiResponse<T> {\n return {\n data: null,\n error,\n ...(error.requestId ? { meta: { requestId: error.requestId } } : {}),\n };\n}\n\nexport function parseRetryAfterHeader(value: string | null): number | undefined {\n if (!value) {\n return undefined;\n }\n\n const seconds = Number.parseInt(value, 10);\n if (Number.isFinite(seconds) && seconds >= 0) {\n return seconds;\n }\n\n const dateMs = Date.parse(value);\n if (Number.isFinite(dateMs)) {\n const deltaSeconds = Math.ceil((dateMs - Date.now()) / 1000);\n return Math.max(deltaSeconds, 0);\n }\n\n return undefined;\n}\n","/**\n * Base error for unexpected SDK failures (configuration, parsing, transport).\n *\n * HTTP/API errors from Soundlink are returned as `{ data: null, error }` and do not throw.\n */\nexport class SoundlinkSdkError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkSdkError';\n Object.setPrototypeOf(this, SoundlinkSdkError.prototype);\n }\n}\n\n/** Thrown when a response body cannot be parsed or the network request fails unexpectedly. */\nexport class SoundlinkParseError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkParseError';\n Object.setPrototypeOf(this, SoundlinkParseError.prototype);\n }\n}\n\n/** Thrown when the client is misconfigured (missing or invalid API key, etc.). */\nexport class SoundlinkConfigError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkConfigError';\n Object.setPrototypeOf(this, SoundlinkConfigError.prototype);\n }\n}\n","import { SoundlinkParseError } from '../errors/sdk-error.js';\n\nexport async function* parseNdjsonStream<T>(\n body: ReadableStream<Uint8Array> | null,\n onMalformedLine?: (line: string, error: unknown) => void,\n): AsyncGenerator<T> {\n if (!body) {\n return;\n }\n\n const reader = body.getReader();\n const decoder = new TextDecoder();\n let buffer = '';\n\n try {\n for (;;) {\n const { done, value } = await reader.read();\n if (done) {\n break;\n }\n\n buffer += decoder.decode(value, { stream: true });\n const lines = buffer.split('\\n');\n buffer = lines.pop() ?? '';\n\n for (const line of lines) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n\n try {\n yield JSON.parse(trimmed) as T;\n } catch (error) {\n onMalformedLine?.(trimmed, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n }\n\n const trailing = buffer.trim();\n if (trailing) {\n try {\n yield JSON.parse(trailing) as T;\n } catch (error) {\n onMalformedLine?.(trailing, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n } finally {\n reader.releaseLock();\n }\n}\n\nexport async function collectNdjsonStream<T>(\n stream: AsyncIterable<T>,\n): Promise<{ rows: T[]; rowCount: number }> {\n const rows: T[] = [];\n for await (const row of stream) {\n rows.push(row);\n }\n return {\n rows,\n rowCount: rows.length,\n };\n}\n\nexport function parseNdjsonText<T>(text: string): T[] {\n const rows: T[] = [];\n for (const line of text.split('\\n')) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n rows.push(JSON.parse(trimmed) as T);\n }\n\n return rows;\n}\n","export function buildQueryString(\n params: Record<string, string | number | boolean | undefined | null>,\n): string {\n const searchParams = new URLSearchParams();\n\n for (const [key, value] of Object.entries(params)) {\n if (value === undefined || value === null || value === '') {\n continue;\n }\n searchParams.set(key, String(value));\n }\n\n const query = searchParams.toString();\n return query ? `?${query}` : '';\n}\n\nexport function joinUrl(baseUrl: string, path: string): string {\n const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n return `${normalizedBase}${normalizedPath}`;\n}\n\nexport function sleep(ms: number): Promise<void> {\n return new Promise((resolve) => {\n setTimeout(resolve, ms);\n });\n}\n\nexport function calculateBackoffMs(attempt: number): number {\n const base = 250;\n const jitter = Math.floor(Math.random() * 100);\n return base * 2 ** attempt + jitter;\n}\n","import {\n API_KEY_PREFIX,\n API_VERSION_PREFIX,\n DEFAULT_BASE_URL,\n DEFAULT_MAX_RETRIES,\n DEFAULT_TIMEOUT_MS,\n} from '../constants/defaults.js';\nimport {\n errorResponse,\n isApiEnvelopeError,\n isApiEnvelopeSuccess,\n parseRetryAfterHeader,\n successResponse,\n toApiError,\n} from '../core/api-response.js';\nimport { parseNdjsonStream } from '../core/jsonl.js';\nimport { SoundlinkConfigError, SoundlinkParseError } from '../errors/sdk-error.js';\nimport type { ApiResponse, JsonlStream, SoundlinkOptions } from '../types/api.js';\nimport {\n buildQueryString,\n calculateBackoffMs,\n joinUrl,\n sleep,\n} from '../utils/query.js';\n\nexport type { JsonlStream };\n\nexport interface HttpGetOptions {\n path: string;\n query?: Record<string, string | number | boolean | undefined | null>;\n}\n\nexport interface HttpJsonlOptions extends HttpGetOptions {\n accept?: string;\n}\n\nexport interface ResolvedSoundlinkClientOptions {\n apiKey: string;\n baseUrl: string;\n timeout: number;\n maxRetries: number;\n fetch: typeof fetch;\n}\n\n/**\n * Normalize constructor options and validate the API key format.\n *\n * @throws {@link SoundlinkConfigError} When the key is missing or does not start with `sk_`.\n */\nexport function resolveClientOptions(\n options: SoundlinkOptions,\n): ResolvedSoundlinkClientOptions {\n const normalized = typeof options === 'string' ? { apiKey: options } : options;\n\n const apiKey = normalized.apiKey.trim();\n if (!apiKey) {\n throw new SoundlinkConfigError('apiKey is required.');\n }\n\n if (!apiKey.startsWith(API_KEY_PREFIX)) {\n throw new SoundlinkConfigError(\n `Invalid API key format. Expected a key starting with \"${API_KEY_PREFIX}\".`,\n );\n }\n\n return {\n apiKey,\n baseUrl: normalized.baseUrl ?? DEFAULT_BASE_URL,\n timeout: normalized.timeout ?? DEFAULT_TIMEOUT_MS,\n maxRetries: normalized.maxRetries ?? DEFAULT_MAX_RETRIES,\n fetch: normalized.fetch ?? globalThis.fetch.bind(globalThis),\n };\n}\n\nexport class HttpClient {\n private readonly options: ResolvedSoundlinkClientOptions;\n\n constructor(options: SoundlinkOptions) {\n this.options = resolveClientOptions(options);\n }\n\n get resolvedOptions(): ResolvedSoundlinkClientOptions {\n return this.options;\n }\n\n async get<T>({ path, query }: HttpGetOptions): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n return this.requestJson<T>(url, {\n method: 'GET',\n headers: this.buildHeaders(),\n });\n }\n\n async getJsonl<T>({\n path,\n query,\n accept = 'application/x-ndjson',\n }: HttpJsonlOptions): Promise<ApiResponse<JsonlStream<T>>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n let response: Response;\n try {\n response = await this.fetchWithRetry(url, {\n method: 'GET',\n headers: {\n ...this.buildHeaders(),\n Accept: accept,\n },\n });\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const contentType = response.headers.get('Content-Type') ?? '';\n if (contentType.includes('application/json')) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const rowCountHeader = response.headers.get('X-Row-Count');\n const parsedRowCount =\n rowCountHeader !== null ? Number.parseInt(rowCountHeader, 10) : undefined;\n\n const stream = parseNdjsonStream<T>(response.body);\n const data = attachRowCountMetadata(stream, parsedRowCount);\n\n return {\n data,\n error: null,\n };\n }\n\n private buildHeaders(): Record<string, string> {\n return {\n 'x-api-key': this.options.apiKey,\n Accept: 'application/json',\n };\n }\n\n private async requestJson<T>(\n url: string,\n init: RequestInit,\n ): Promise<ApiResponse<T>> {\n let response: Response;\n\n try {\n response = await this.fetchWithRetry(url, init);\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<T>(response, retryAfter);\n }\n\n let body: unknown;\n try {\n body = await response.json();\n } catch {\n throw new SoundlinkParseError(\n 'Failed to parse JSON response from Soundlink API.',\n );\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n if (isApiEnvelopeSuccess<T>(body)) {\n return successResponse(body.data, body.meta);\n }\n\n throw new SoundlinkParseError('Unexpected response shape from Soundlink API.');\n }\n\n private async parseErrorEnvelope<T>(\n response: Response,\n retryAfter?: number,\n ): Promise<ApiResponse<T>> {\n let body: unknown = null;\n\n try {\n body = await response.json();\n } catch {\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n private async fetchWithRetry(url: string, init: RequestInit): Promise<Response> {\n const { maxRetries, timeout, fetch } = this.options;\n let attempt = 0;\n\n let response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n\n while (\n attempt < maxRetries &&\n (response.status === 429 || response.status >= 500)\n ) {\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n const delayMs =\n retryAfter !== undefined ? retryAfter * 1000 : calculateBackoffMs(attempt);\n\n attempt += 1;\n await sleep(delayMs);\n\n response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n }\n\n return response;\n }\n}\n\nfunction toTransportError(error: unknown): SoundlinkParseError {\n if (error instanceof Error) {\n return new SoundlinkParseError(`Network request failed: ${error.message}`);\n }\n\n return new SoundlinkParseError('Network request failed.');\n}\n\nfunction attachRowCountMetadata<T>(\n stream: AsyncIterable<T>,\n rowCount?: number,\n): JsonlStream<T> {\n const jsonlStream: JsonlStream<T> = {\n async *[Symbol.asyncIterator]() {\n for await (const row of stream) {\n yield row;\n }\n },\n };\n\n if (rowCount !== undefined && !Number.isNaN(rowCount)) {\n jsonlStream.rowCount = rowCount;\n }\n\n return jsonlStream;\n}\n\n/**\n * Read `rowCount` from a {@link JsonlStream} when the API sent `X-Row-Count`.\n *\n * @returns Row count, or `undefined` if not available.\n */\nexport function getStreamRowCount<T>(stream: AsyncIterable<T>): number | undefined {\n if (typeof stream === 'object' && 'rowCount' in stream) {\n const value = (stream as JsonlStream<T>).rowCount;\n return typeof value === 'number' ? value : undefined;\n }\n\n return undefined;\n}\n","import type { HttpClient } from '../client/http-client.js';\nimport type { JsonlStream } from '../types/api.js';\nimport { collectNdjsonStream } from '../core/jsonl.js';\nimport type {\n ApiResponse,\n BreakdownExportParams,\n BreakdownListData,\n BreakdownListParams,\n BreakdownRow,\n CampaignDetail,\n CampaignListData,\n CampaignListParams,\n DateRangeParams,\n EngagementExportParams,\n EngagementListData,\n EngagementListParams,\n EngagementRow,\n ExportCollection,\n MetricsOverview,\n PingData,\n} from '../types/api.js';\n\n/**\n * JSONL export endpoint: stream rows with {@link ExportResource.collect} or iterate the stream directly.\n *\n * @example\n * ```ts\n * const { data: stream } = await soundlink.metrics.breakdown.export(campaignId);\n * for await (const row of stream!) { ... }\n *\n * const { data } = await soundlink.metrics.breakdown.export.collect(campaignId);\n * ```\n */\nexport interface ExportResource<T, P extends DateRangeParams> {\n /**\n * Stream export rows as newline-delimited JSON.\n *\n * @param campaignId - Soundlink campaign ID.\n * @param params - Optional date range (max 90 days per request).\n */\n (campaignId: string, params?: P): Promise<ApiResponse<JsonlStream<T>>>;\n\n /**\n * Download all export rows into memory.\n *\n * Prefer {@link ExportResource | the stream} for large datasets.\n */\n collect(campaignId: string, params?: P): Promise<ApiResponse<ExportCollection<T>>>;\n}\n\nfunction createExportResource<T, P extends DateRangeParams>(\n http: HttpClient,\n buildPath: (campaignId: string) => string,\n buildQuery: (\n params: P,\n ) => Record<string, string | number | boolean | undefined | null>,\n): ExportResource<T, P> {\n const exportFn = ((campaignId: string, params: P = {} as P) => {\n return http.getJsonl<T>({\n path: buildPath(campaignId),\n query: buildQuery(params),\n });\n }) as ExportResource<T, P>;\n\n exportFn.collect = async (campaignId: string, params: P = {} as P) => {\n const response = await exportFn(campaignId, params);\n\n if (response.error || !response.data) {\n return {\n data: null,\n error: response.error,\n meta: response.meta,\n };\n }\n\n const collected = await collectNdjsonStream(response.data);\n\n return {\n data: collected,\n error: null,\n meta: response.meta,\n };\n };\n\n return exportFn;\n}\n\n/** System endpoints (`GET /v1/ping`). */\nexport class PingResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Verify connectivity and API key authentication.\n *\n * Accepts any valid v1 key scope. Does not require `campaigns:read` or `metrics:read`.\n *\n * @returns `{ data: { status: 'ok' }, error: null }` on success.\n *\n * @example\n * ```ts\n * const { data, error, meta } = await soundlink.ping();\n * ```\n */\n ping(): Promise<ApiResponse<PingData>> {\n return this.http.get<PingData>({ path: '/ping' });\n }\n}\n\n/** Campaign listing and detail (`/v1/campaigns/*`). Requires `campaigns:read`. */\nexport class CampaignsResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * List campaigns for the authenticated organization.\n *\n * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**.\n *\n * @param params - Pagination and sort options.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.list({ page: 1, pageSize: 100 });\n * ```\n */\n list(params: CampaignListParams = {}): Promise<ApiResponse<CampaignListData>> {\n return this.http.get<CampaignListData>({\n path: '/campaigns',\n query: {\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n\n /**\n * Fetch full details for a single campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}`.\n *\n * @param campaignId - Campaign identifier returned by {@link CampaignsResource.list}.\n */\n get(campaignId: string): Promise<ApiResponse<CampaignDetail>> {\n return this.http.get<CampaignDetail>({\n path: `/campaigns/${encodeURIComponent(campaignId)}`,\n });\n }\n\n /**\n * Async iterator over every campaign across all pages.\n *\n * Stops silently if a page request returns an error.\n *\n * @param params - Same as {@link CampaignsResource.list} except `page` is managed automatically.\n *\n * @example\n * ```ts\n * for await (const campaign of soundlink.campaigns.listAll({ pageSize: 100 })) {\n * console.log(campaign.campaignId);\n * }\n * ```\n */\n async *listAll(\n params: Omit<CampaignListParams, 'page'> = {},\n ): AsyncGenerator<CampaignListData['items'][number], void, void> {\n let page = 1;\n let totalPages = 1;\n\n while (page <= totalPages) {\n const response = await this.list({ ...params, page });\n\n if (response.error || !response.data) {\n return;\n }\n\n for (const item of response.data.items) {\n yield item;\n }\n\n totalPages = response.data.pagination.totalPages;\n page += 1;\n }\n }\n}\n\n/**\n * Campaign metrics (`/v1/campaigns/{id}/metrics/*`). Requires `metrics:read`.\n *\n * @example\n * ```ts\n * await soundlink.metrics.overview(campaignId);\n * await soundlink.metrics.breakdown.list(campaignId);\n * await soundlink.metrics.engagement.export(campaignId);\n * ```\n */\nexport class MetricsResource {\n /** Per-day country breakdown and JSONL export. */\n readonly breakdown: BreakdownMetricsResource;\n\n /** Per-track engagement breakdown and JSONL export. */\n readonly engagement: EngagementMetricsResource;\n\n constructor(private readonly http: HttpClient) {\n this.breakdown = new BreakdownMetricsResource(http);\n this.engagement = new EngagementMetricsResource(http);\n }\n\n /**\n * Campaign-level metric totals for a date range.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/overview`.\n * Aggregates across all countries — use {@link BreakdownMetricsResource.list} for daily rows.\n *\n * @param campaignId - Campaign identifier.\n * @param params - Inclusive `YYYY-MM-DD` date range. Omit for API defaults.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.metrics.overview(campaignId, {\n * startDate: '2026-01-01',\n * endDate: '2026-03-31',\n * });\n * ```\n */\n overview(\n campaignId: string,\n params: DateRangeParams = {},\n ): Promise<ApiResponse<MetricsOverview>> {\n return this.http.get<MetricsOverview>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/overview`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n },\n });\n }\n}\n\n/**\n * Country-level daily metrics (`campaign_country_daily` schema).\n *\n * Access via `soundlink.metrics.breakdown`.\n */\nexport class BreakdownMetricsResource {\n /**\n * Stream full breakdown export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown/export`.\n */\n readonly export: ExportResource<BreakdownRow, BreakdownExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<BreakdownRow, BreakdownExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n }),\n );\n }\n\n /**\n * Paginated per-day, per-country breakdown rows.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param campaignId - Campaign identifier.\n * @param params - Date range, pagination, and sort options.\n */\n list(\n campaignId: string,\n params: BreakdownListParams = {},\n ): Promise<ApiResponse<BreakdownListData>> {\n return this.http.get<BreakdownListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n}\n\n/**\n * Per-track engagement metrics (`campaign_engagement_daily` schema).\n *\n * Access via `soundlink.metrics.engagement`.\n */\nexport class EngagementMetricsResource {\n /**\n * Stream full engagement export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement/export`.\n */\n readonly export: ExportResource<EngagementRow, EngagementExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<EngagementRow, EngagementExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n engagementContext: params.engagementContext,\n }),\n );\n }\n\n /**\n * Paginated per-day, per-track engagement rows.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param campaignId - Campaign identifier.\n * @param params - Date range, pagination, sort, and optional `engagementContext` filter.\n */\n list(\n campaignId: string,\n params: EngagementListParams = {},\n ): Promise<ApiResponse<EngagementListData>> {\n return this.http.get<EngagementListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n engagementContext: params.engagementContext,\n },\n });\n }\n}\n","import { HttpClient } from './http-client.js';\nimport {\n CampaignsResource,\n MetricsResource,\n PingResource,\n} from '../resources/index.js';\nimport type { SoundlinkOptions } from '../types/api.js';\n\n/**\n * Official Soundlink Public API client.\n *\n * All methods return `{ data, error, meta? }` and never throw on HTTP/API errors.\n * SDK configuration, parsing, and transport failures throw {@link SoundlinkSdkError}.\n *\n * @example\n * ```ts\n * import { Soundlink } from 'soundlink';\n *\n * const soundlink = new Soundlink(process.env.SOUNDLINK_API_KEY!);\n *\n * const { data, error } = await soundlink.ping();\n * if (error) {\n * console.error(error.code, error.message);\n * } else {\n * console.log(data.status);\n * }\n * ```\n *\n * @see https://docs.getsoundlink.com\n */\nexport class Soundlink {\n /** Verify connectivity and authentication. Maps to `GET /v1/ping`. */\n readonly ping: PingResource['ping'];\n\n /** List and fetch campaigns. Requires `campaigns:read` scope. */\n readonly campaigns: CampaignsResource;\n\n /** Campaign metrics, breakdowns, and JSONL exports. Requires `metrics:read` scope. */\n readonly metrics: MetricsResource;\n\n /**\n * Create a Soundlink client.\n *\n * @param options - API key string (`sk_*`) or {@link SoundlinkClientOptions}.\n */\n constructor(options: SoundlinkOptions) {\n const http = new HttpClient(options);\n const pingResource = new PingResource(http);\n\n this.ping = pingResource.ping.bind(pingResource);\n this.campaigns = new CampaignsResource(http);\n this.metrics = new MetricsResource(http);\n }\n}\n\nexport { HttpClient, resolveClientOptions } from './http-client.js';\n"]}
|
|
1
|
+
{"version":3,"sources":["../../src/constants/defaults.ts","../../src/core/api-response.ts","../../src/errors/sdk-error.ts","../../src/core/jsonl.ts","../../src/utils/query.ts","../../src/client/http-client.ts","../../src/resources/index.ts","../../src/client/soundlink.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export const DEFAULT_BASE_URL = 'https://api.getsoundlink.com';\n\nexport const DEFAULT_TIMEOUT_MS = 30_000;\n\nexport const DEFAULT_MAX_RETRIES = 2;\n\nexport const API_KEY_PREFIX = 'sk_';\n\nexport const CAMPAIGNS_MAX_PAGE_SIZE = 100;\n\nexport const METRICS_MAX_PAGE_SIZE = 500;\n\nexport const METRICS_DEFAULT_PAGE_SIZE = 50;\n\nexport const CAMPAIGNS_DEFAULT_PAGE_SIZE = 10;\n\nexport const API_VERSION_PREFIX = '/v1';\n","import type {\n ApiEnvelopeError,\n ApiEnvelopeSuccess,\n ApiMeta,\n ApiError,\n ApiResponse,\n PublicApiErrorCode,\n} from '../types/api.js';\n\nexport function isApiEnvelopeError(body: unknown): body is ApiEnvelopeError {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return (\n typeof record.error === 'object' &&\n record.error !== null &&\n typeof (record.error as Record<string, unknown>).code === 'string' &&\n typeof (record.error as Record<string, unknown>).message === 'string'\n );\n}\n\nexport function isApiEnvelopeSuccess<T>(body: unknown): body is ApiEnvelopeSuccess<T> {\n if (typeof body !== 'object' || body === null) {\n return false;\n }\n\n const record = body as Record<string, unknown>;\n return 'data' in record && typeof record.meta === 'object' && record.meta !== null;\n}\n\nexport function toApiError(\n envelope: ApiEnvelopeError,\n status: number,\n retryAfter?: number,\n): ApiError {\n const { details } = envelope.error;\n\n return {\n code: envelope.error.code as PublicApiErrorCode,\n message: envelope.error.message,\n status,\n requestId: envelope.meta.requestId,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n ...(details !== undefined ? { details } : {}),\n };\n}\n\nexport function successResponse<T>(data: T, meta: ApiMeta): ApiResponse<T> {\n return {\n data,\n error: null,\n meta,\n };\n}\n\nexport function errorResponse<T>(error: ApiError): ApiResponse<T> {\n return {\n data: null,\n error,\n ...(error.requestId ? { meta: { requestId: error.requestId } } : {}),\n };\n}\n\nexport function parseRetryAfterHeader(value: string | null): number | undefined {\n if (!value) {\n return undefined;\n }\n\n const seconds = Number.parseInt(value, 10);\n if (Number.isFinite(seconds) && seconds >= 0) {\n return seconds;\n }\n\n const dateMs = Date.parse(value);\n if (Number.isFinite(dateMs)) {\n const deltaSeconds = Math.ceil((dateMs - Date.now()) / 1000);\n return Math.max(deltaSeconds, 0);\n }\n\n return undefined;\n}\n","/**\n * Base error for unexpected SDK failures (configuration, parsing, transport).\n *\n * HTTP/API errors from Soundlink are returned as `{ data: null, error }` and do not throw.\n */\nexport class SoundlinkSdkError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkSdkError';\n Object.setPrototypeOf(this, SoundlinkSdkError.prototype);\n }\n}\n\n/** Thrown when a response body cannot be parsed or the network request fails unexpectedly. */\nexport class SoundlinkParseError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkParseError';\n Object.setPrototypeOf(this, SoundlinkParseError.prototype);\n }\n}\n\n/** Thrown when the client is misconfigured (missing or invalid API key, etc.). */\nexport class SoundlinkConfigError extends SoundlinkSdkError {\n constructor(message: string) {\n super(message);\n this.name = 'SoundlinkConfigError';\n Object.setPrototypeOf(this, SoundlinkConfigError.prototype);\n }\n}\n","import { SoundlinkParseError } from '../errors/sdk-error.js';\n\nexport async function* parseNdjsonStream<T>(\n body: ReadableStream<Uint8Array> | null,\n onMalformedLine?: (line: string, error: unknown) => void,\n): AsyncGenerator<T> {\n if (!body) {\n return;\n }\n\n const reader = body.getReader();\n const decoder = new TextDecoder();\n let buffer = '';\n\n try {\n for (;;) {\n const { done, value } = await reader.read();\n if (done) {\n break;\n }\n\n buffer += decoder.decode(value, { stream: true });\n const lines = buffer.split('\\n');\n buffer = lines.pop() ?? '';\n\n for (const line of lines) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n\n try {\n yield JSON.parse(trimmed) as T;\n } catch (error) {\n onMalformedLine?.(trimmed, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n }\n\n const trailing = buffer.trim();\n if (trailing) {\n try {\n yield JSON.parse(trailing) as T;\n } catch (error) {\n onMalformedLine?.(trailing, error);\n throw new SoundlinkParseError('Failed to parse JSONL export line.');\n }\n }\n } finally {\n reader.releaseLock();\n }\n}\n\nexport async function collectNdjsonStream<T>(\n stream: AsyncIterable<T>,\n): Promise<{ rows: T[]; rowCount: number }> {\n const rows: T[] = [];\n for await (const row of stream) {\n rows.push(row);\n }\n return {\n rows,\n rowCount: rows.length,\n };\n}\n\nexport function parseNdjsonText<T>(text: string): T[] {\n const rows: T[] = [];\n for (const line of text.split('\\n')) {\n const trimmed = line.trim();\n if (!trimmed) {\n continue;\n }\n rows.push(JSON.parse(trimmed) as T);\n }\n\n return rows;\n}\n","export function buildQueryString(\n params: Record<string, string | number | boolean | undefined | null>,\n): string {\n const searchParams = new URLSearchParams();\n\n for (const [key, value] of Object.entries(params)) {\n if (value === undefined || value === null || value === '') {\n continue;\n }\n searchParams.set(key, String(value));\n }\n\n const query = searchParams.toString();\n return query ? `?${query}` : '';\n}\n\nexport function joinUrl(baseUrl: string, path: string): string {\n const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n return `${normalizedBase}${normalizedPath}`;\n}\n\nexport function sleep(ms: number): Promise<void> {\n return new Promise((resolve) => {\n setTimeout(resolve, ms);\n });\n}\n\nexport function calculateBackoffMs(attempt: number): number {\n const base = 250;\n const jitter = Math.floor(Math.random() * 100);\n return base * 2 ** attempt + jitter;\n}\n","import {\n API_KEY_PREFIX,\n API_VERSION_PREFIX,\n DEFAULT_BASE_URL,\n DEFAULT_MAX_RETRIES,\n DEFAULT_TIMEOUT_MS,\n} from '../constants/defaults.js';\nimport {\n errorResponse,\n isApiEnvelopeError,\n isApiEnvelopeSuccess,\n parseRetryAfterHeader,\n successResponse,\n toApiError,\n} from '../core/api-response.js';\nimport { parseNdjsonStream } from '../core/jsonl.js';\nimport { SoundlinkConfigError, SoundlinkParseError } from '../errors/sdk-error.js';\nimport type { ApiResponse, JsonlStream, SoundlinkOptions } from '../types/api.js';\nimport {\n buildQueryString,\n calculateBackoffMs,\n joinUrl,\n sleep,\n} from '../utils/query.js';\n\nexport type { JsonlStream };\n\nexport interface HttpGetOptions {\n path: string;\n query?: Record<string, string | number | boolean | undefined | null>;\n}\n\nexport interface HttpJsonlOptions extends HttpGetOptions {\n accept?: string;\n}\n\nexport interface HttpMutationOptions {\n path: string;\n body?: unknown;\n query?: Record<string, string | number | boolean | undefined | null>;\n headers?: Record<string, string>;\n /** Sent as the `Idempotency-Key` header when set. */\n idempotencyKey?: string;\n}\n\nexport interface ResolvedSoundlinkClientOptions {\n apiKey: string;\n baseUrl: string;\n timeout: number;\n maxRetries: number;\n fetch: typeof fetch;\n}\n\n/**\n * Normalize constructor options and validate the API key format.\n *\n * @throws {@link SoundlinkConfigError} When the key is missing or does not start with `sk_`.\n */\nexport function resolveClientOptions(\n options: SoundlinkOptions,\n): ResolvedSoundlinkClientOptions {\n const normalized = typeof options === 'string' ? { apiKey: options } : options;\n\n const apiKey = normalized.apiKey.trim();\n if (!apiKey) {\n throw new SoundlinkConfigError('apiKey is required.');\n }\n\n if (!apiKey.startsWith(API_KEY_PREFIX)) {\n throw new SoundlinkConfigError(\n `Invalid API key format. Expected a key starting with \"${API_KEY_PREFIX}\".`,\n );\n }\n\n return {\n apiKey,\n baseUrl: normalized.baseUrl ?? DEFAULT_BASE_URL,\n timeout: normalized.timeout ?? DEFAULT_TIMEOUT_MS,\n maxRetries: normalized.maxRetries ?? DEFAULT_MAX_RETRIES,\n fetch: normalized.fetch ?? globalThis.fetch.bind(globalThis),\n };\n}\n\nexport class HttpClient {\n private readonly options: ResolvedSoundlinkClientOptions;\n\n constructor(options: SoundlinkOptions) {\n this.options = resolveClientOptions(options);\n }\n\n get resolvedOptions(): ResolvedSoundlinkClientOptions {\n return this.options;\n }\n\n async get<T>({ path, query }: HttpGetOptions): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n return this.requestJson<T>(url, {\n method: 'GET',\n headers: this.buildHeaders(),\n });\n }\n\n async post<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('POST', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async patch<T>({\n path,\n body,\n query,\n headers,\n idempotencyKey,\n }: HttpMutationOptions): Promise<ApiResponse<T>> {\n return this.mutateJson<T>('PATCH', {\n path,\n body,\n query,\n headers,\n idempotencyKey,\n });\n }\n\n async getJsonl<T>({\n path,\n query,\n accept = 'application/x-ndjson',\n }: HttpJsonlOptions): Promise<ApiResponse<JsonlStream<T>>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n let response: Response;\n try {\n response = await this.fetchWithRetry(url, {\n method: 'GET',\n headers: {\n ...this.buildHeaders(),\n Accept: accept,\n },\n });\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const contentType = response.headers.get('Content-Type') ?? '';\n if (contentType.includes('application/json')) {\n return this.parseErrorEnvelope<JsonlStream<T>>(response, retryAfter);\n }\n\n const rowCountHeader = response.headers.get('X-Row-Count');\n const parsedRowCount =\n rowCountHeader !== null ? Number.parseInt(rowCountHeader, 10) : undefined;\n\n const stream = parseNdjsonStream<T>(response.body);\n const data = attachRowCountMetadata(stream, parsedRowCount);\n\n return {\n data,\n error: null,\n };\n }\n\n private mutateJson<T>(\n method: 'POST' | 'PATCH',\n { path, body, query, headers, idempotencyKey }: HttpMutationOptions,\n ): Promise<ApiResponse<T>> {\n const url = joinUrl(\n this.options.baseUrl,\n `${API_VERSION_PREFIX}${path}${buildQueryString(query ?? {})}`,\n );\n\n const requestHeaders = this.buildHeaders({\n ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),\n ...(idempotencyKey !== undefined ? { 'Idempotency-Key': idempotencyKey } : {}),\n ...headers,\n });\n\n return this.requestJson<T>(url, {\n method,\n headers: requestHeaders,\n ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n });\n }\n\n private buildHeaders(extra: Record<string, string> = {}): Record<string, string> {\n return {\n 'x-api-key': this.options.apiKey,\n Accept: 'application/json',\n ...extra,\n };\n }\n\n private async requestJson<T>(\n url: string,\n init: RequestInit,\n ): Promise<ApiResponse<T>> {\n let response: Response;\n\n try {\n response = await this.fetchWithRetry(url, init);\n } catch (error) {\n throw toTransportError(error);\n }\n\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n\n if (!response.ok) {\n return this.parseErrorEnvelope<T>(response, retryAfter);\n }\n\n let body: unknown;\n try {\n body = await response.json();\n } catch {\n throw new SoundlinkParseError(\n 'Failed to parse JSON response from Soundlink API.',\n );\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n if (isApiEnvelopeSuccess<T>(body)) {\n return successResponse(body.data, body.meta);\n }\n\n throw new SoundlinkParseError('Unexpected response shape from Soundlink API.');\n }\n\n private async parseErrorEnvelope<T>(\n response: Response,\n retryAfter?: number,\n ): Promise<ApiResponse<T>> {\n let body: unknown = null;\n\n try {\n body = await response.json();\n } catch {\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n if (isApiEnvelopeError(body)) {\n return errorResponse(toApiError(body, response.status, retryAfter));\n }\n\n return errorResponse({\n code: 'internal_error',\n message: `Request failed with status ${String(response.status)}.`,\n status: response.status,\n ...(retryAfter !== undefined ? { retryAfter } : {}),\n });\n }\n\n private async fetchWithRetry(url: string, init: RequestInit): Promise<Response> {\n const { maxRetries, timeout, fetch } = this.options;\n let attempt = 0;\n\n let response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n\n while (\n attempt < maxRetries &&\n (response.status === 429 || response.status >= 500)\n ) {\n const retryAfter = parseRetryAfterHeader(response.headers.get('Retry-After'));\n const delayMs =\n retryAfter !== undefined ? retryAfter * 1000 : calculateBackoffMs(attempt);\n\n attempt += 1;\n await sleep(delayMs);\n\n response = await fetch(url, {\n ...init,\n signal: AbortSignal.timeout(timeout),\n });\n }\n\n return response;\n }\n}\n\nfunction toTransportError(error: unknown): SoundlinkParseError {\n if (error instanceof Error) {\n return new SoundlinkParseError(`Network request failed: ${error.message}`);\n }\n\n return new SoundlinkParseError('Network request failed.');\n}\n\nfunction attachRowCountMetadata<T>(\n stream: AsyncIterable<T>,\n rowCount?: number,\n): JsonlStream<T> {\n const jsonlStream: JsonlStream<T> = {\n async *[Symbol.asyncIterator]() {\n for await (const row of stream) {\n yield row;\n }\n },\n };\n\n if (rowCount !== undefined && !Number.isNaN(rowCount)) {\n jsonlStream.rowCount = rowCount;\n }\n\n return jsonlStream;\n}\n\n/**\n * Read `rowCount` from a {@link JsonlStream} when the API sent `X-Row-Count`.\n *\n * @returns Row count, or `undefined` if not available.\n */\nexport function getStreamRowCount<T>(stream: AsyncIterable<T>): number | undefined {\n if (typeof stream === 'object' && 'rowCount' in stream) {\n const value = (stream as JsonlStream<T>).rowCount;\n return typeof value === 'number' ? value : undefined;\n }\n\n return undefined;\n}\n","import type { HttpClient } from '../client/http-client.js';\nimport type { JsonlStream } from '../types/api.js';\nimport { collectNdjsonStream } from '../core/jsonl.js';\nimport type {\n ApiResponse,\n BreakdownExportParams,\n BreakdownListData,\n BreakdownListParams,\n BreakdownRow,\n CampaignCreateData,\n CampaignDetail,\n CampaignListData,\n CampaignListParams,\n CampaignStopData,\n CampaignTiersData,\n CreateCampaignRequest,\n DateRangeParams,\n DecreaseCampaignBudgetData,\n DecreaseCampaignBudgetRequest,\n EngagementExportParams,\n EngagementRow,\n ExportCollection,\n IdempotencyOptions,\n IncreaseCampaignBudgetData,\n IncreaseCampaignBudgetRequest,\n MetricsOverview,\n PingData,\n StrategiesCatalogData,\n UpdateCampaignTiersRequest,\n} from '../types/api.js';\n\n/**\n * JSONL export endpoint: stream rows with {@link ExportResource.collect} or iterate the stream directly.\n *\n * @example\n * ```ts\n * const { data: stream } = await soundlink.metrics.breakdown.export(campaignId);\n * for await (const row of stream!) { ... }\n *\n * const { data } = await soundlink.metrics.breakdown.export.collect(campaignId);\n * ```\n */\nexport interface ExportResource<T, P extends DateRangeParams> {\n /**\n * Stream export rows as newline-delimited JSON.\n *\n * @param campaignId - Soundlink campaign ID.\n * @param params - Optional date range (max 90 days per request).\n */\n (campaignId: string, params?: P): Promise<ApiResponse<JsonlStream<T>>>;\n\n /**\n * Download all export rows into memory.\n *\n * Prefer {@link ExportResource | the stream} for large datasets.\n */\n collect(campaignId: string, params?: P): Promise<ApiResponse<ExportCollection<T>>>;\n}\n\nfunction createExportResource<T, P extends DateRangeParams>(\n http: HttpClient,\n buildPath: (campaignId: string) => string,\n buildQuery: (\n params: P,\n ) => Record<string, string | number | boolean | undefined | null>,\n): ExportResource<T, P> {\n const exportFn = ((campaignId: string, params: P = {} as P) => {\n return http.getJsonl<T>({\n path: buildPath(campaignId),\n query: buildQuery(params),\n });\n }) as ExportResource<T, P>;\n\n exportFn.collect = async (campaignId: string, params: P = {} as P) => {\n const response = await exportFn(campaignId, params);\n\n if (response.error || !response.data) {\n return {\n data: null,\n error: response.error,\n meta: response.meta,\n };\n }\n\n const collected = await collectNdjsonStream(response.data);\n\n return {\n data: collected,\n error: null,\n meta: response.meta,\n };\n };\n\n return exportFn;\n}\n\n/** System endpoints (`GET /v1/ping`). */\nexport class PingResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Verify connectivity and API key authentication.\n *\n * Accepts any valid v1 key scope. Does not require `campaigns:read` or `metrics:read`.\n *\n * @returns `{ data: { status: 'ok' }, error: null }` on success.\n *\n * @example\n * ```ts\n * const { data, error, meta } = await soundlink.ping();\n * ```\n */\n ping(): Promise<ApiResponse<PingData>> {\n return this.http.get<PingData>({ path: '/ping' });\n }\n}\n\n/** Strategy catalog (`GET /v1/strategies`). Requires `campaigns:read`. */\nexport class StrategiesResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * List growth strategies available for wallet campaign create.\n *\n * Maps to `GET /v1/strategies`.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.strategies.list();\n * ```\n */\n list(): Promise<ApiResponse<StrategiesCatalogData>> {\n return this.http.get<StrategiesCatalogData>({ path: '/strategies' });\n }\n}\n\n/** Campaign tiers (`/v1/campaigns/{id}/tiers`). Wallet only (`generation: 3`). */\nexport class CampaignTiersResource {\n constructor(private readonly http: HttpClient) {}\n\n /**\n * Get current tier allocation for a wallet campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/tiers`. Wallet campaigns only (`generation: 3`).\n */\n get(campaignId: string): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.get<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n });\n }\n\n /**\n * Update tier enablement and budget shares.\n *\n * Maps to `PATCH /v1/campaigns/{campaignId}/tiers`. Requires `campaigns:write`.\n * Allocation percents across items must sum to 100.\n * Use each tier's `tierId` from {@link CampaignTiersResource.get} as `targetingTierId`.\n * Does not require an `Idempotency-Key` (unlike create / stop / budget).\n */\n update(\n campaignId: string,\n body: UpdateCampaignTiersRequest,\n ): Promise<ApiResponse<CampaignTiersData>> {\n return this.http.patch<CampaignTiersData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/tiers`,\n body,\n });\n }\n}\n\n/** Campaign listing, detail, and wallet write surface (`/v1/campaigns/*`). */\nexport class CampaignsResource {\n /** Tier allocation for wallet campaigns (`generation: 3`). */\n readonly tiers: CampaignTiersResource;\n\n constructor(private readonly http: HttpClient) {\n this.tiers = new CampaignTiersResource(http);\n }\n\n /**\n * List campaigns for the authenticated organization.\n *\n * Maps to `GET /v1/campaigns`. Max `pageSize` is **100**. Requires `campaigns:read`.\n *\n * @param params - Pagination and sort options.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.list({ page: 1, pageSize: 100 });\n * ```\n */\n list(params: CampaignListParams = {}): Promise<ApiResponse<CampaignListData>> {\n return this.http.get<CampaignListData>({\n path: '/campaigns',\n query: {\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n\n /**\n * Fetch full details for a single campaign.\n *\n * Maps to `GET /v1/campaigns/{campaignId}`. Requires `campaigns:read`.\n *\n * @param campaignId - Campaign identifier returned by {@link CampaignsResource.list}.\n */\n get(campaignId: string): Promise<ApiResponse<CampaignDetail>> {\n return this.http.get<CampaignDetail>({\n path: `/campaigns/${encodeURIComponent(campaignId)}`,\n });\n }\n\n /**\n * Create a wallet-funded campaign.\n *\n * Maps to `POST /v1/campaigns`. Requires `campaigns:write` and `Idempotency-Key`.\n *\n * @example\n * ```ts\n * const { data, error } = await soundlink.campaigns.create(\n * {\n * spotifyUrl: 'https://open.spotify.com/track/...',\n * dailyBudget: 20,\n * durationDays: 7,\n * genre: 'Pop',\n * strategyType: 'maximum_growth',\n * },\n * { idempotencyKey: 'create-mytrack-01' },\n * );\n * ```\n */\n create(\n body: CreateCampaignRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignCreateData>> {\n return this.http.post<CampaignCreateData>({\n path: '/campaigns',\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Stop a wallet campaign and refund unspent budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/stop`. Requires `campaigns:write`\n * and `Idempotency-Key`. Wallet campaigns only (`generation: 3`).\n */\n stop(\n campaignId: string,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<CampaignStopData>> {\n return this.http.post<CampaignStopData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/stop`,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Increase wallet campaign budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/increase`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n increaseBudget(\n campaignId: string,\n body: IncreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<IncreaseCampaignBudgetData>> {\n return this.http.post<IncreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/increase`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Decrease wallet campaign daily budget.\n *\n * Maps to `POST /v1/campaigns/{campaignId}/budget/decrease`.\n * Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).\n */\n decreaseBudget(\n campaignId: string,\n body: DecreaseCampaignBudgetRequest,\n options: IdempotencyOptions,\n ): Promise<ApiResponse<DecreaseCampaignBudgetData>> {\n return this.http.post<DecreaseCampaignBudgetData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/budget/decrease`,\n body,\n idempotencyKey: options.idempotencyKey,\n });\n }\n\n /**\n * Async iterator over every campaign across all pages.\n *\n * Stops silently if a page request returns an error.\n *\n * @param params - Same as {@link CampaignsResource.list} except `page` is managed automatically.\n *\n * @example\n * ```ts\n * for await (const campaign of soundlink.campaigns.listAll({ pageSize: 100 })) {\n * console.log(campaign.campaignId);\n * }\n * ```\n */\n async *listAll(\n params: Omit<CampaignListParams, 'page'> = {},\n ): AsyncGenerator<CampaignListData['items'][number], void, void> {\n let page = 1;\n let totalPages = 1;\n\n while (page <= totalPages) {\n const response = await this.list({ ...params, page });\n\n if (response.error || !response.data) {\n return;\n }\n\n for (const item of response.data.items) {\n yield item;\n }\n\n totalPages = response.data.pagination.totalPages;\n page += 1;\n }\n }\n}\n\n/**\n * Campaign metrics (`/v1/campaigns/{id}/metrics/*`). Requires `metrics:read`.\n *\n * @example\n * ```ts\n * await soundlink.metrics.overview(campaignId);\n * await soundlink.metrics.breakdown.list(campaignId);\n * await soundlink.metrics.engagement.export(campaignId);\n * ```\n */\nexport class MetricsResource {\n /** Per-day country breakdown and JSONL export. */\n readonly breakdown: BreakdownMetricsResource;\n\n /** Per-track engagement JSONL export. */\n readonly engagement: EngagementMetricsResource;\n\n constructor(private readonly http: HttpClient) {\n this.breakdown = new BreakdownMetricsResource(http);\n this.engagement = new EngagementMetricsResource(http);\n }\n\n /**\n * Campaign-level metric totals for a date range.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/overview`.\n * Aggregates across all countries — use {@link BreakdownMetricsResource.list} for daily rows.\n *\n * @param campaignId - Campaign identifier.\n * @param params - Inclusive `YYYY-MM-DD` date range. Omit for API defaults.\n *\n * @example\n * ```ts\n * const { data } = await soundlink.metrics.overview(campaignId, {\n * startDate: '2026-01-01',\n * endDate: '2026-03-31',\n * });\n * ```\n */\n overview(\n campaignId: string,\n params: DateRangeParams = {},\n ): Promise<ApiResponse<MetricsOverview>> {\n return this.http.get<MetricsOverview>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/overview`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n },\n });\n }\n}\n\n/**\n * Country-level daily metrics (`campaign_country_daily` schema).\n *\n * Access via `soundlink.metrics.breakdown`.\n */\nexport class BreakdownMetricsResource {\n /**\n * Stream full breakdown export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown/export`.\n */\n readonly export: ExportResource<BreakdownRow, BreakdownExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<BreakdownRow, BreakdownExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n }),\n );\n }\n\n /**\n * Paginated per-day, per-country breakdown rows.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/breakdown`.\n * Max `pageSize` is **500** (default 50).\n *\n * @param campaignId - Campaign identifier.\n * @param params - Date range, pagination, and sort options.\n */\n list(\n campaignId: string,\n params: BreakdownListParams = {},\n ): Promise<ApiResponse<BreakdownListData>> {\n return this.http.get<BreakdownListData>({\n path: `/campaigns/${encodeURIComponent(campaignId)}/metrics/breakdown`,\n query: {\n startDate: params.startDate,\n endDate: params.endDate,\n page: params.page,\n pageSize: params.pageSize,\n sortBy: params.sortBy,\n sortOrder: params.sortOrder,\n },\n });\n }\n}\n\n/**\n * Per-track engagement metrics (`campaign_engagement_daily` schema).\n *\n * Access via `soundlink.metrics.engagement`. Only JSONL export is shipped.\n */\nexport class EngagementMetricsResource {\n /**\n * Stream full engagement export as JSONL.\n *\n * Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement/export`.\n */\n readonly export: ExportResource<EngagementRow, EngagementExportParams>;\n\n constructor(private readonly http: HttpClient) {\n this.export = createExportResource<EngagementRow, EngagementExportParams>(\n http,\n (campaignId) =>\n `/campaigns/${encodeURIComponent(campaignId)}/metrics/engagement/export`,\n (params) => ({\n startDate: params.startDate,\n endDate: params.endDate,\n engagementContext: params.engagementContext,\n }),\n );\n }\n}\n","import { HttpClient } from './http-client.js';\nimport {\n CampaignsResource,\n MetricsResource,\n PingResource,\n StrategiesResource,\n} from '../resources/index.js';\nimport type { SoundlinkOptions } from '../types/api.js';\n\n/**\n * Official Soundlink Public API client.\n *\n * All methods return `{ data, error, meta? }` and never throw on HTTP/API errors.\n * SDK configuration, parsing, and transport failures throw {@link SoundlinkSdkError}.\n *\n * @example\n * ```ts\n * import { Soundlink } from 'soundlink';\n *\n * const soundlink = new Soundlink(process.env.SOUNDLINK_API_KEY!);\n *\n * const { data, error } = await soundlink.ping();\n * if (error) {\n * console.error(error.code, error.message);\n * } else {\n * console.log(data.status);\n * }\n * ```\n *\n * @see https://docs.getsoundlink.com\n */\nexport class Soundlink {\n /** Verify connectivity and authentication. Maps to `GET /v1/ping`. */\n readonly ping: PingResource['ping'];\n\n /** Growth strategy catalog. Requires `campaigns:read` scope. */\n readonly strategies: StrategiesResource;\n\n /** List, fetch, and manage campaigns. Read needs `campaigns:read`; writes need `campaigns:write`. */\n readonly campaigns: CampaignsResource;\n\n /** Campaign metrics, breakdowns, and JSONL exports. Requires `metrics:read` scope. */\n readonly metrics: MetricsResource;\n\n /**\n * Create a Soundlink client.\n *\n * @param options - API key string (`sk_*`) or {@link SoundlinkClientOptions}.\n */\n constructor(options: SoundlinkOptions) {\n const http = new HttpClient(options);\n const pingResource = new PingResource(http);\n\n this.ping = pingResource.ping.bind(pingResource);\n this.strategies = new StrategiesResource(http);\n this.campaigns = new CampaignsResource(http);\n this.metrics = new MetricsResource(http);\n }\n}\n\nexport { HttpClient, resolveClientOptions } from './http-client.js';\n"]}
|
package/dist/esm/index.d.ts
CHANGED
|
@@ -1,9 +1,22 @@
|
|
|
1
1
|
/** Stable snake_case error codes returned by the Soundlink Public API. */
|
|
2
|
-
type PublicApiErrorCode = 'invalid_api_key' | 'api_key_revoked' | 'api_key_expired' | 'mixed_credentials' | 'insufficient_scope' | 'not_found' | 'campaign_not_found' | 'invalid_query_parameter' | 'invalid_date_range' | 'page_size_exceeded' | 'rate_limit_exceeded' | 'internal_error';
|
|
3
|
-
/**
|
|
4
|
-
|
|
2
|
+
type PublicApiErrorCode = 'invalid_api_key' | 'api_key_revoked' | 'api_key_expired' | 'mixed_credentials' | 'insufficient_scope' | 'not_found' | 'campaign_not_found' | 'invalid_query_parameter' | 'invalid_date_range' | 'page_size_exceeded' | 'invalid_request' | 'invalid_genre' | 'invalid_duration_or_budget' | 'invalid_daily_budget' | 'invalid_duration_days' | 'invalid_spotify_url' | 'invalid_tier_budget_allocation' | 'invalid_tier_status' | 'tier_update_cooldown' | 'wallet_not_enabled' | 'insufficient_credit' | 'idempotency_key_conflict' | 'rate_limit_exceeded' | 'invalid_video_url' | 'video_import_limit_exceeded' | 'video_import_session_not_found' | 'internal_error';
|
|
3
|
+
/**
|
|
4
|
+
* Campaign lifecycle status.
|
|
5
|
+
*
|
|
6
|
+
* Includes OpenAPI values plus `inactive` (observed on wallet campaigns in
|
|
7
|
+
* production; may be aligned in a later OpenAPI revision).
|
|
8
|
+
*/
|
|
9
|
+
type CampaignStatus = 'creating' | 'active' | 'paused' | 'stopped' | 'completed' | 'failed' | 'ended' | 'inactive';
|
|
5
10
|
/** Ad platform used by the campaign. */
|
|
6
11
|
type SocialPlatform = 'meta';
|
|
12
|
+
/**
|
|
13
|
+
* Campaign resource generation.
|
|
14
|
+
*
|
|
15
|
+
* - `1` — Stripe / one-time / subscription / legacy
|
|
16
|
+
* - `2` — managed
|
|
17
|
+
* - `3` — wallet (writable via Public API)
|
|
18
|
+
*/
|
|
19
|
+
type CampaignGeneration = 1 | 2 | 3;
|
|
7
20
|
/**
|
|
8
21
|
* Engagement context for per-track metrics.
|
|
9
22
|
*
|
|
@@ -15,10 +28,23 @@ type EngagementContext = 'catalog' | 'playlist';
|
|
|
15
28
|
type CampaignSortBy = 'createdAt' | 'status';
|
|
16
29
|
/** Allowed `sortBy` values for breakdown list requests. */
|
|
17
30
|
type BreakdownSortBy = 'report_date' | 'spend_total';
|
|
18
|
-
/** Allowed `sortBy` values for engagement list requests. */
|
|
19
|
-
type EngagementSortBy = 'report_date' | 'streams' | 'listeners';
|
|
20
31
|
/** Sort direction for list endpoints. */
|
|
21
32
|
type SortOrder = 'asc' | 'desc';
|
|
33
|
+
/** Growth strategy for campaign create / catalog. */
|
|
34
|
+
type StrategyType = 'maximum_growth' | 'market_discovery' | 'revenue_maximization' | 'custom';
|
|
35
|
+
/** Non-custom strategies (platform default tiering; no `tierTargeting`). */
|
|
36
|
+
type BuiltInStrategyType = Exclude<StrategyType, 'custom'>;
|
|
37
|
+
/** Strictly validated genre list from the Public API. */
|
|
38
|
+
type Genre = 'Alternative/Indie' | 'Ambient/Sleep' | 'Chill/Background' | 'Classical' | 'Country' | 'Electronic/Dance' | 'Hip-Hop/R&B' | 'Latin/Reggaeton' | 'Pop' | 'Rock' | 'Christmas';
|
|
39
|
+
/** Budget increase mode for wallet campaigns. */
|
|
40
|
+
type BudgetIncreaseMode = 'current_cycle' | 'next_renewal' | 'current_and_renewals';
|
|
41
|
+
/** Budget decrease mode for wallet campaigns. */
|
|
42
|
+
type BudgetDecreaseMode = 'current_cycle' | 'current_and_renewals';
|
|
43
|
+
/** Options for write methods that require an `Idempotency-Key` header. */
|
|
44
|
+
interface IdempotencyOptions {
|
|
45
|
+
/** Client-generated key; reused retries must send the same body. */
|
|
46
|
+
idempotencyKey: string;
|
|
47
|
+
}
|
|
22
48
|
/** Server-generated request metadata. Include `requestId` when contacting Soundlink support. */
|
|
23
49
|
interface ApiMeta {
|
|
24
50
|
/** UUID for this API request. */
|
|
@@ -36,6 +62,11 @@ interface ApiError {
|
|
|
36
62
|
requestId?: string;
|
|
37
63
|
/** Seconds to wait before retrying, from the `Retry-After` header on `429`. */
|
|
38
64
|
retryAfter?: number;
|
|
65
|
+
/**
|
|
66
|
+
* Error-code-specific context from the API (e.g. `available` / `required` on
|
|
67
|
+
* `insufficient_credit`). Absent when the API sends no `details`.
|
|
68
|
+
*/
|
|
69
|
+
details?: Record<string, unknown> | null;
|
|
39
70
|
}
|
|
40
71
|
/**
|
|
41
72
|
* Standard SDK response shape for every Public API method.
|
|
@@ -73,6 +104,8 @@ interface CampaignSummary {
|
|
|
73
104
|
totalBudget: number;
|
|
74
105
|
/** Campaign duration in days. */
|
|
75
106
|
campaignDuration: number;
|
|
107
|
+
/** Resource generation — writable Public API methods require `3`. */
|
|
108
|
+
generation: CampaignGeneration;
|
|
76
109
|
/** ISO 8601 creation timestamp. */
|
|
77
110
|
createdAt: string;
|
|
78
111
|
/** ISO 8601 last update timestamp. */
|
|
@@ -80,8 +113,8 @@ interface CampaignSummary {
|
|
|
80
113
|
}
|
|
81
114
|
/** Full campaign detail from {@link CampaignsResource.get}. */
|
|
82
115
|
interface CampaignDetail extends CampaignSummary {
|
|
83
|
-
/** Growth strategy (e.g. `custom`, `maximum_growth`). */
|
|
84
|
-
strategyType?:
|
|
116
|
+
/** Growth strategy set at creation (e.g. `custom`, `maximum_growth`). */
|
|
117
|
+
strategyType?: StrategyType;
|
|
85
118
|
}
|
|
86
119
|
/** Paginated campaign list payload. */
|
|
87
120
|
interface CampaignListData {
|
|
@@ -92,6 +125,121 @@ interface CampaignListData {
|
|
|
92
125
|
interface PingData {
|
|
93
126
|
status: 'ok';
|
|
94
127
|
}
|
|
128
|
+
/** One entry from `GET /v1/strategies`. */
|
|
129
|
+
interface StrategyCatalogItem {
|
|
130
|
+
strategyType: StrategyType;
|
|
131
|
+
/** When `false`, omit `tierTargeting` on create. */
|
|
132
|
+
tierTargetingAllowed: boolean;
|
|
133
|
+
}
|
|
134
|
+
/** Payload from `GET /v1/strategies`. */
|
|
135
|
+
interface StrategiesCatalogData {
|
|
136
|
+
strategies: StrategyCatalogItem[];
|
|
137
|
+
}
|
|
138
|
+
/** Shared fields for wallet campaign create. */
|
|
139
|
+
interface CreateCampaignRequestBase {
|
|
140
|
+
/** Spotify track or playlist URL. */
|
|
141
|
+
spotifyUrl: string;
|
|
142
|
+
/** USD per day (minimum 10). */
|
|
143
|
+
dailyBudget: number;
|
|
144
|
+
/** Duration in days: 7–30, or 60, or 90. */
|
|
145
|
+
durationDays: number;
|
|
146
|
+
genre: Genre;
|
|
147
|
+
/** Optional; server generates a default when omitted. */
|
|
148
|
+
campaignName?: string;
|
|
149
|
+
creativeDirection?: CreativeDirection;
|
|
150
|
+
trackOptions?: {
|
|
151
|
+
artistIdFollow?: string;
|
|
152
|
+
};
|
|
153
|
+
/** Lineage only — does not copy settings from the source campaign. */
|
|
154
|
+
clonedFromCampaignId?: string;
|
|
155
|
+
}
|
|
156
|
+
interface DoItForMeCreativeDirection {
|
|
157
|
+
type: 'do_it_for_me';
|
|
158
|
+
}
|
|
159
|
+
interface FullControlCreativeDirection {
|
|
160
|
+
type: 'full_control';
|
|
161
|
+
selectedCreatives: Array<{
|
|
162
|
+
videoId: string;
|
|
163
|
+
}>;
|
|
164
|
+
}
|
|
165
|
+
type CreativeDirection = DoItForMeCreativeDirection | FullControlCreativeDirection;
|
|
166
|
+
interface CustomTier {
|
|
167
|
+
name: string;
|
|
168
|
+
percentBudget: number;
|
|
169
|
+
countries?: string[];
|
|
170
|
+
language?: string;
|
|
171
|
+
}
|
|
172
|
+
interface TierTargeting {
|
|
173
|
+
customTierIds?: number[];
|
|
174
|
+
customTiers?: CustomTier[];
|
|
175
|
+
}
|
|
176
|
+
/** Create with a built-in strategy (no `tierTargeting`). */
|
|
177
|
+
interface CreateCampaignRequestBuiltIn extends CreateCampaignRequestBase {
|
|
178
|
+
strategyType: BuiltInStrategyType;
|
|
179
|
+
tierTargeting?: never;
|
|
180
|
+
}
|
|
181
|
+
/** Create with `custom` strategy (requires `tierTargeting`). */
|
|
182
|
+
interface CreateCampaignRequestCustom extends CreateCampaignRequestBase {
|
|
183
|
+
strategyType: 'custom';
|
|
184
|
+
tierTargeting: TierTargeting;
|
|
185
|
+
}
|
|
186
|
+
/** Body for `POST /v1/campaigns`. */
|
|
187
|
+
type CreateCampaignRequest = CreateCampaignRequestBuiltIn | CreateCampaignRequestCustom;
|
|
188
|
+
/** Success payload from campaign create. */
|
|
189
|
+
interface CampaignCreateData {
|
|
190
|
+
campaignId: string;
|
|
191
|
+
status: CampaignStatus;
|
|
192
|
+
}
|
|
193
|
+
/** Success payload from campaign stop. */
|
|
194
|
+
interface CampaignStopData {
|
|
195
|
+
campaignId: string;
|
|
196
|
+
status: CampaignStatus;
|
|
197
|
+
}
|
|
198
|
+
interface IncreaseCampaignBudgetRequest {
|
|
199
|
+
amount: number;
|
|
200
|
+
mode?: BudgetIncreaseMode;
|
|
201
|
+
targetDailyBudget?: number;
|
|
202
|
+
}
|
|
203
|
+
interface IncreaseCampaignBudgetData {
|
|
204
|
+
campaignId: string;
|
|
205
|
+
mode: BudgetIncreaseMode;
|
|
206
|
+
amount: number;
|
|
207
|
+
walletBalance: number;
|
|
208
|
+
walletNextCycleDailyBudget?: number | null;
|
|
209
|
+
}
|
|
210
|
+
interface DecreaseCampaignBudgetRequest {
|
|
211
|
+
targetDailyBudget: number;
|
|
212
|
+
mode?: BudgetDecreaseMode;
|
|
213
|
+
}
|
|
214
|
+
interface DecreaseCampaignBudgetData {
|
|
215
|
+
campaignId: string;
|
|
216
|
+
mode: BudgetDecreaseMode;
|
|
217
|
+
targetDailyBudget: number;
|
|
218
|
+
accepted: true;
|
|
219
|
+
walletNextCycleDailyBudget?: number | null;
|
|
220
|
+
}
|
|
221
|
+
interface CampaignTier {
|
|
222
|
+
tierId: number;
|
|
223
|
+
tierName: string;
|
|
224
|
+
isEnabled: boolean;
|
|
225
|
+
allocationPercent: number;
|
|
226
|
+
}
|
|
227
|
+
interface CampaignTiersData {
|
|
228
|
+
lastUpdate: string | null;
|
|
229
|
+
tiers: CampaignTier[];
|
|
230
|
+
}
|
|
231
|
+
interface TierStatusUpdateItem {
|
|
232
|
+
/**
|
|
233
|
+
* Targeting tier id — same value as `tierId` returned by
|
|
234
|
+
* `campaigns.tiers.get` (`CampaignTier.tierId`).
|
|
235
|
+
*/
|
|
236
|
+
targetingTierId: number;
|
|
237
|
+
isEnabled: boolean;
|
|
238
|
+
newAllocationPercent: number;
|
|
239
|
+
}
|
|
240
|
+
interface UpdateCampaignTiersRequest {
|
|
241
|
+
items: TierStatusUpdateItem[];
|
|
242
|
+
}
|
|
95
243
|
/** Campaign-level metric totals from {@link MetricsResource.overview}. */
|
|
96
244
|
interface MetricsOverview {
|
|
97
245
|
listeners: number;
|
|
@@ -184,12 +332,6 @@ interface BreakdownListData {
|
|
|
184
332
|
items: BreakdownRow[];
|
|
185
333
|
pagination: Pagination;
|
|
186
334
|
}
|
|
187
|
-
/** Paginated engagement list payload. */
|
|
188
|
-
interface EngagementListData {
|
|
189
|
-
schemaVersion: string;
|
|
190
|
-
items: EngagementRow[];
|
|
191
|
-
pagination: Pagination;
|
|
192
|
-
}
|
|
193
335
|
/** In-memory result from {@link ExportResource.collect}. */
|
|
194
336
|
interface ExportCollection<T> {
|
|
195
337
|
rows: T[];
|
|
@@ -244,17 +386,6 @@ interface BreakdownListParams extends DateRangeParams {
|
|
|
244
386
|
/** Default: `asc`. */
|
|
245
387
|
sortOrder?: SortOrder;
|
|
246
388
|
}
|
|
247
|
-
/** Query params for {@link EngagementMetricsResource.list}. */
|
|
248
|
-
interface EngagementListParams extends DateRangeParams {
|
|
249
|
-
page?: number;
|
|
250
|
-
/** Default: `50`. Max: **500**. */
|
|
251
|
-
pageSize?: number;
|
|
252
|
-
/** Default: `report_date`. */
|
|
253
|
-
sortBy?: EngagementSortBy;
|
|
254
|
-
sortOrder?: SortOrder;
|
|
255
|
-
/** Filter to `catalog` or `playlist`. Omit for both. */
|
|
256
|
-
engagementContext?: EngagementContext;
|
|
257
|
-
}
|
|
258
389
|
/** Query params for engagement JSONL export. */
|
|
259
390
|
interface EngagementExportParams extends DateRangeParams {
|
|
260
391
|
engagementContext?: EngagementContext;
|
|
@@ -269,6 +400,14 @@ interface HttpGetOptions {
|
|
|
269
400
|
interface HttpJsonlOptions extends HttpGetOptions {
|
|
270
401
|
accept?: string;
|
|
271
402
|
}
|
|
403
|
+
interface HttpMutationOptions {
|
|
404
|
+
path: string;
|
|
405
|
+
body?: unknown;
|
|
406
|
+
query?: Record<string, string | number | boolean | undefined | null>;
|
|
407
|
+
headers?: Record<string, string>;
|
|
408
|
+
/** Sent as the `Idempotency-Key` header when set. */
|
|
409
|
+
idempotencyKey?: string;
|
|
410
|
+
}
|
|
272
411
|
interface ResolvedSoundlinkClientOptions {
|
|
273
412
|
apiKey: string;
|
|
274
413
|
baseUrl: string;
|
|
@@ -287,7 +426,10 @@ declare class HttpClient {
|
|
|
287
426
|
constructor(options: SoundlinkOptions);
|
|
288
427
|
get resolvedOptions(): ResolvedSoundlinkClientOptions;
|
|
289
428
|
get<T>({ path, query }: HttpGetOptions): Promise<ApiResponse<T>>;
|
|
429
|
+
post<T>({ path, body, query, headers, idempotencyKey, }: HttpMutationOptions): Promise<ApiResponse<T>>;
|
|
430
|
+
patch<T>({ path, body, query, headers, idempotencyKey, }: HttpMutationOptions): Promise<ApiResponse<T>>;
|
|
290
431
|
getJsonl<T>({ path, query, accept, }: HttpJsonlOptions): Promise<ApiResponse<JsonlStream<T>>>;
|
|
432
|
+
private mutateJson;
|
|
291
433
|
private buildHeaders;
|
|
292
434
|
private requestJson;
|
|
293
435
|
private parseErrorEnvelope;
|
|
@@ -344,14 +486,52 @@ declare class PingResource {
|
|
|
344
486
|
*/
|
|
345
487
|
ping(): Promise<ApiResponse<PingData>>;
|
|
346
488
|
}
|
|
347
|
-
/**
|
|
489
|
+
/** Strategy catalog (`GET /v1/strategies`). Requires `campaigns:read`. */
|
|
490
|
+
declare class StrategiesResource {
|
|
491
|
+
private readonly http;
|
|
492
|
+
constructor(http: HttpClient);
|
|
493
|
+
/**
|
|
494
|
+
* List growth strategies available for wallet campaign create.
|
|
495
|
+
*
|
|
496
|
+
* Maps to `GET /v1/strategies`.
|
|
497
|
+
*
|
|
498
|
+
* @example
|
|
499
|
+
* ```ts
|
|
500
|
+
* const { data } = await soundlink.strategies.list();
|
|
501
|
+
* ```
|
|
502
|
+
*/
|
|
503
|
+
list(): Promise<ApiResponse<StrategiesCatalogData>>;
|
|
504
|
+
}
|
|
505
|
+
/** Campaign tiers (`/v1/campaigns/{id}/tiers`). Wallet only (`generation: 3`). */
|
|
506
|
+
declare class CampaignTiersResource {
|
|
507
|
+
private readonly http;
|
|
508
|
+
constructor(http: HttpClient);
|
|
509
|
+
/**
|
|
510
|
+
* Get current tier allocation for a wallet campaign.
|
|
511
|
+
*
|
|
512
|
+
* Maps to `GET /v1/campaigns/{campaignId}/tiers`. Wallet campaigns only (`generation: 3`).
|
|
513
|
+
*/
|
|
514
|
+
get(campaignId: string): Promise<ApiResponse<CampaignTiersData>>;
|
|
515
|
+
/**
|
|
516
|
+
* Update tier enablement and budget shares.
|
|
517
|
+
*
|
|
518
|
+
* Maps to `PATCH /v1/campaigns/{campaignId}/tiers`. Requires `campaigns:write`.
|
|
519
|
+
* Allocation percents across items must sum to 100.
|
|
520
|
+
* Use each tier's `tierId` from {@link CampaignTiersResource.get} as `targetingTierId`.
|
|
521
|
+
* Does not require an `Idempotency-Key` (unlike create / stop / budget).
|
|
522
|
+
*/
|
|
523
|
+
update(campaignId: string, body: UpdateCampaignTiersRequest): Promise<ApiResponse<CampaignTiersData>>;
|
|
524
|
+
}
|
|
525
|
+
/** Campaign listing, detail, and wallet write surface (`/v1/campaigns/*`). */
|
|
348
526
|
declare class CampaignsResource {
|
|
349
527
|
private readonly http;
|
|
528
|
+
/** Tier allocation for wallet campaigns (`generation: 3`). */
|
|
529
|
+
readonly tiers: CampaignTiersResource;
|
|
350
530
|
constructor(http: HttpClient);
|
|
351
531
|
/**
|
|
352
532
|
* List campaigns for the authenticated organization.
|
|
353
533
|
*
|
|
354
|
-
* Maps to `GET /v1/campaigns`. Max `pageSize` is **100**.
|
|
534
|
+
* Maps to `GET /v1/campaigns`. Max `pageSize` is **100**. Requires `campaigns:read`.
|
|
355
535
|
*
|
|
356
536
|
* @param params - Pagination and sort options.
|
|
357
537
|
*
|
|
@@ -364,11 +544,52 @@ declare class CampaignsResource {
|
|
|
364
544
|
/**
|
|
365
545
|
* Fetch full details for a single campaign.
|
|
366
546
|
*
|
|
367
|
-
* Maps to `GET /v1/campaigns/{campaignId}`.
|
|
547
|
+
* Maps to `GET /v1/campaigns/{campaignId}`. Requires `campaigns:read`.
|
|
368
548
|
*
|
|
369
549
|
* @param campaignId - Campaign identifier returned by {@link CampaignsResource.list}.
|
|
370
550
|
*/
|
|
371
551
|
get(campaignId: string): Promise<ApiResponse<CampaignDetail>>;
|
|
552
|
+
/**
|
|
553
|
+
* Create a wallet-funded campaign.
|
|
554
|
+
*
|
|
555
|
+
* Maps to `POST /v1/campaigns`. Requires `campaigns:write` and `Idempotency-Key`.
|
|
556
|
+
*
|
|
557
|
+
* @example
|
|
558
|
+
* ```ts
|
|
559
|
+
* const { data, error } = await soundlink.campaigns.create(
|
|
560
|
+
* {
|
|
561
|
+
* spotifyUrl: 'https://open.spotify.com/track/...',
|
|
562
|
+
* dailyBudget: 20,
|
|
563
|
+
* durationDays: 7,
|
|
564
|
+
* genre: 'Pop',
|
|
565
|
+
* strategyType: 'maximum_growth',
|
|
566
|
+
* },
|
|
567
|
+
* { idempotencyKey: 'create-mytrack-01' },
|
|
568
|
+
* );
|
|
569
|
+
* ```
|
|
570
|
+
*/
|
|
571
|
+
create(body: CreateCampaignRequest, options: IdempotencyOptions): Promise<ApiResponse<CampaignCreateData>>;
|
|
572
|
+
/**
|
|
573
|
+
* Stop a wallet campaign and refund unspent budget.
|
|
574
|
+
*
|
|
575
|
+
* Maps to `POST /v1/campaigns/{campaignId}/stop`. Requires `campaigns:write`
|
|
576
|
+
* and `Idempotency-Key`. Wallet campaigns only (`generation: 3`).
|
|
577
|
+
*/
|
|
578
|
+
stop(campaignId: string, options: IdempotencyOptions): Promise<ApiResponse<CampaignStopData>>;
|
|
579
|
+
/**
|
|
580
|
+
* Increase wallet campaign budget.
|
|
581
|
+
*
|
|
582
|
+
* Maps to `POST /v1/campaigns/{campaignId}/budget/increase`.
|
|
583
|
+
* Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).
|
|
584
|
+
*/
|
|
585
|
+
increaseBudget(campaignId: string, body: IncreaseCampaignBudgetRequest, options: IdempotencyOptions): Promise<ApiResponse<IncreaseCampaignBudgetData>>;
|
|
586
|
+
/**
|
|
587
|
+
* Decrease wallet campaign daily budget.
|
|
588
|
+
*
|
|
589
|
+
* Maps to `POST /v1/campaigns/{campaignId}/budget/decrease`.
|
|
590
|
+
* Requires `campaigns:write` and `Idempotency-Key`. Wallet only (`generation: 3`).
|
|
591
|
+
*/
|
|
592
|
+
decreaseBudget(campaignId: string, body: DecreaseCampaignBudgetRequest, options: IdempotencyOptions): Promise<ApiResponse<DecreaseCampaignBudgetData>>;
|
|
372
593
|
/**
|
|
373
594
|
* Async iterator over every campaign across all pages.
|
|
374
595
|
*
|
|
@@ -399,7 +620,7 @@ declare class MetricsResource {
|
|
|
399
620
|
private readonly http;
|
|
400
621
|
/** Per-day country breakdown and JSONL export. */
|
|
401
622
|
readonly breakdown: BreakdownMetricsResource;
|
|
402
|
-
/** Per-track engagement
|
|
623
|
+
/** Per-track engagement JSONL export. */
|
|
403
624
|
readonly engagement: EngagementMetricsResource;
|
|
404
625
|
constructor(http: HttpClient);
|
|
405
626
|
/**
|
|
@@ -449,7 +670,7 @@ declare class BreakdownMetricsResource {
|
|
|
449
670
|
/**
|
|
450
671
|
* Per-track engagement metrics (`campaign_engagement_daily` schema).
|
|
451
672
|
*
|
|
452
|
-
* Access via `soundlink.metrics.engagement`.
|
|
673
|
+
* Access via `soundlink.metrics.engagement`. Only JSONL export is shipped.
|
|
453
674
|
*/
|
|
454
675
|
declare class EngagementMetricsResource {
|
|
455
676
|
private readonly http;
|
|
@@ -460,16 +681,6 @@ declare class EngagementMetricsResource {
|
|
|
460
681
|
*/
|
|
461
682
|
readonly export: ExportResource<EngagementRow, EngagementExportParams>;
|
|
462
683
|
constructor(http: HttpClient);
|
|
463
|
-
/**
|
|
464
|
-
* Paginated per-day, per-track engagement rows.
|
|
465
|
-
*
|
|
466
|
-
* Maps to `GET /v1/campaigns/{campaignId}/metrics/engagement`.
|
|
467
|
-
* Max `pageSize` is **500** (default 50).
|
|
468
|
-
*
|
|
469
|
-
* @param campaignId - Campaign identifier.
|
|
470
|
-
* @param params - Date range, pagination, sort, and optional `engagementContext` filter.
|
|
471
|
-
*/
|
|
472
|
-
list(campaignId: string, params?: EngagementListParams): Promise<ApiResponse<EngagementListData>>;
|
|
473
684
|
}
|
|
474
685
|
|
|
475
686
|
/**
|
|
@@ -497,7 +708,9 @@ declare class EngagementMetricsResource {
|
|
|
497
708
|
declare class Soundlink {
|
|
498
709
|
/** Verify connectivity and authentication. Maps to `GET /v1/ping`. */
|
|
499
710
|
readonly ping: PingResource['ping'];
|
|
500
|
-
/**
|
|
711
|
+
/** Growth strategy catalog. Requires `campaigns:read` scope. */
|
|
712
|
+
readonly strategies: StrategiesResource;
|
|
713
|
+
/** List, fetch, and manage campaigns. Read needs `campaigns:read`; writes need `campaigns:write`. */
|
|
501
714
|
readonly campaigns: CampaignsResource;
|
|
502
715
|
/** Campaign metrics, breakdowns, and JSONL exports. Requires `metrics:read` scope. */
|
|
503
716
|
readonly metrics: MetricsResource;
|
|
@@ -533,4 +746,4 @@ declare const API_KEY_PREFIX = "sk_";
|
|
|
533
746
|
declare const CAMPAIGNS_MAX_PAGE_SIZE = 100;
|
|
534
747
|
declare const METRICS_MAX_PAGE_SIZE = 500;
|
|
535
748
|
|
|
536
|
-
export { API_KEY_PREFIX, type ApiError, type ApiMeta, type ApiResponse, type BreakdownExportParams, type BreakdownListData, type BreakdownListParams, type BreakdownRow, CAMPAIGNS_MAX_PAGE_SIZE, type CampaignDetail, type CampaignListData, type CampaignListParams, type CampaignSortBy, type CampaignStatus, type CampaignSummary, DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, type DateRangeParams, type
|
|
749
|
+
export { API_KEY_PREFIX, type ApiError, type ApiMeta, type ApiResponse, type BreakdownExportParams, type BreakdownListData, type BreakdownListParams, type BreakdownRow, type BudgetDecreaseMode, type BudgetIncreaseMode, type BuiltInStrategyType, CAMPAIGNS_MAX_PAGE_SIZE, type CampaignCreateData, type CampaignDetail, type CampaignGeneration, type CampaignListData, type CampaignListParams, type CampaignSortBy, type CampaignStatus, type CampaignStopData, type CampaignSummary, type CampaignTier, type CampaignTiersData, type CreateCampaignRequest, type CreateCampaignRequestBase, type CreateCampaignRequestBuiltIn, type CreateCampaignRequestCustom, type CreativeDirection, type CustomTier, DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, type DateRangeParams, type DecreaseCampaignBudgetData, type DecreaseCampaignBudgetRequest, type DoItForMeCreativeDirection, type EngagementContext, type EngagementExportParams, type EngagementRow, type ExportCollection, type ExportResource, type FullControlCreativeDirection, type Genre, HttpClient, type IdempotencyOptions, type IncreaseCampaignBudgetData, type IncreaseCampaignBudgetRequest, type JsonlStream, METRICS_MAX_PAGE_SIZE, type MetricsOverview, type Pagination, type PingData, type PublicApiErrorCode, type SocialPlatform, type SortOrder, Soundlink, type SoundlinkClientOptions, SoundlinkConfigError, type SoundlinkOptions, SoundlinkParseError, SoundlinkSdkError, type StrategiesCatalogData, type StrategyCatalogItem, type StrategyType, type TierStatusUpdateItem, type TierTargeting, type UpdateCampaignTiersRequest, getStreamRowCount, resolveClientOptions };
|