@disconetwork/core 0.0.9 → 0.0.11

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/README.md CHANGED
@@ -26,10 +26,10 @@ runtime dependency.
26
26
 
27
27
  Authenticate with a **scoped public API key**:
28
28
 
29
- | Prefix | Environment |
30
- | -------------------- | ----------------- |
31
- | `disco_pk_live_…` | production |
32
- | `disco_pk_sandbox_…` | staging / sandbox |
29
+ | Prefix | Use |
30
+ | -------------------- | ----------------------- |
31
+ | `disco_pk_sandbox_…` | Testing and validation |
32
+ | `disco_pk_live_…` | Live production traffic |
33
33
 
34
34
  Anything else — including a **secret** (`disco_sk_…`) key — is rejected:
35
35
  `DiscoClient` is public-key only.
@@ -62,7 +62,7 @@ for (const [groupKey, entries] of Object.entries(data.recommendationGroups)) {
62
62
 
63
63
  ```ts
64
64
  const disco = new DiscoClient({
65
- apiKey: "disco_pk_live_…", // required; selects the environment
65
+ apiKey: "disco_pk_live_…", // required; use a live key for live production traffic
66
66
  apiVersion: "1.0.0", // optional; sent as the X-API-Version header (default "1.0.0")
67
67
  fetch: customFetch, // optional; defaults to globalThis.fetch
68
68
  });
@@ -72,7 +72,7 @@ const disco = new DiscoClient({
72
72
 
73
73
  | Field | Type | Required | Description |
74
74
  | ------------ | -------------- | -------- | --------------------------------------------------------------------- |
75
- | `apiKey` | `string` | yes | Scoped public key. Prefix selects production vs. staging. |
75
+ | `apiKey` | `string` | yes | Scoped public key. Use sandbox keys for testing and validation, and live keys for live production traffic. |
76
76
  | `apiVersion` | `string` | no | Value for the required `X-API-Version` header. Defaults to `"1.0.0"`. |
77
77
  | `fetch` | `typeof fetch` | no | Custom fetch implementation. Defaults to the global `fetch`. |
78
78
 
@@ -124,7 +124,7 @@ with the native `AbortError` (see [Error handling](#error-handling)).
124
124
 
125
125
  Convenience for the common case: fetch recommendations **and** create a tracker
126
126
  already bound to the response's session, in one call. Returns
127
- `{ data, tracker }`. The tracker inherits the client's API key and environment.
127
+ `{ data, tracker }`. The tracker uses the client's API key.
128
128
 
129
129
  ```ts
130
130
  const { data, tracker } = await disco.getRecommendationsWithTracker(request);
@@ -1,19 +1,3 @@
1
- //#region src/env.d.ts
2
- type DiscoEnv = "production" | "staging";
3
- /**
4
- * Derive the environment from a Disco public API key.
5
- *
6
- * Public keys are prefixed `disco_pk_<env>_…`, where `<env>` is `live`
7
- * (→ production) or `sandbox` (→ staging). The key is the single source
8
- * of truth for which backend the SDK talks to — there is no separate
9
- * `env` to pass or keep in sync, and a `live` key can't be pointed at
10
- * staging (or vice versa).
11
- *
12
- * Throws on anything that isn't a recognized public key — including a
13
- * secret (`disco_sk_…`) key, which must never be used in browser code.
14
- */
15
- declare function envFromApiKey(apiKey: string): DiscoEnv;
16
- //#endregion
17
1
  //#region src/api/generated/recommendations/types.gen.d.ts
18
2
  /**
19
3
  * DisplayMode
@@ -369,5 +353,5 @@ declare class DiscoNetworkError extends DiscoError {
369
353
  constructor(message: string, cause: unknown);
370
354
  }
371
355
  //#endregion
372
- export { DisplayMode as A, OfferMetadata as C, RecommendationsRequest as D, RecommendationGroupProperty as E, View as F, DiscoEnv as I, envFromApiKey as L, PlatformType as M, SubView as N, RecommendationsResponse as O, Title as P, OfferDisclosureDetails as S, RecommendationGroupEntry as T, Advertiser as _, BrandClickInitiatingTarget as a, OfferAsset as b, BrandVisibilityEventType as c, EventPlacementDetails as d, EventTracker as f, WidgetEventType as g, ProductProperties as h, DiscoValidationError as i, Gender as j, RunningExperiment as k, ElementClickInitiatingTarget as l, ProductEventType as m, DiscoError as n, BrandDisplayInitiatingTarget as o, ProductDisplayInitiatingTarget as p, DiscoNetworkError as r, BrandProperties as s, DiscoApiError as t, EventPayload as u, Footer as v, Recommendation as w, OfferCtaDetails as x, Offer as y };
373
- //# sourceMappingURL=errors-DnUNDlsa.d.ts.map
356
+ export { DisplayMode as A, OfferMetadata as C, RecommendationsRequest as D, RecommendationGroupProperty as E, View as F, PlatformType as M, SubView as N, RecommendationsResponse as O, Title as P, OfferDisclosureDetails as S, RecommendationGroupEntry as T, Advertiser as _, BrandClickInitiatingTarget as a, OfferAsset as b, BrandVisibilityEventType as c, EventPlacementDetails as d, EventTracker as f, WidgetEventType as g, ProductProperties as h, DiscoValidationError as i, Gender as j, RunningExperiment as k, ElementClickInitiatingTarget as l, ProductEventType as m, DiscoError as n, BrandDisplayInitiatingTarget as o, ProductDisplayInitiatingTarget as p, DiscoNetworkError as r, BrandProperties as s, DiscoApiError as t, EventPayload as u, Footer as v, Recommendation as w, OfferCtaDetails as x, Offer as y };
357
+ //# sourceMappingURL=errors-BhsYlfvH.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors-BhsYlfvH.d.ts","names":[],"sources":["../src/api/generated/recommendations/types.gen.ts","../src/external/recommendations.ts","../src/types.ts","../src/errors.ts"],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,13 +1,18 @@
1
- import { A as DisplayMode, C as OfferMetadata, D as RecommendationsRequest, E as RecommendationGroupProperty, F as View, I as DiscoEnv, M as PlatformType, N as SubView, O as RecommendationsResponse, P as Title, S as OfferDisclosureDetails, T as RecommendationGroupEntry, _ as Advertiser, a as BrandClickInitiatingTarget, b as OfferAsset, c as BrandVisibilityEventType, d as EventPlacementDetails, f as EventTracker, g as WidgetEventType, i as DiscoValidationError, j as Gender, k as RunningExperiment, l as ElementClickInitiatingTarget, m as ProductEventType, n as DiscoError, o as BrandDisplayInitiatingTarget, p as ProductDisplayInitiatingTarget, r as DiscoNetworkError, s as BrandProperties, t as DiscoApiError, u as EventPayload, v as Footer, w as Recommendation, x as OfferCtaDetails, y as Offer } from "./errors-DnUNDlsa.js";
1
+ import { A as DisplayMode, C as OfferMetadata, D as RecommendationsRequest, E as RecommendationGroupProperty, F as View, M as PlatformType, N as SubView, O as RecommendationsResponse, P as Title, S as OfferDisclosureDetails, T as RecommendationGroupEntry, _ as Advertiser, a as BrandClickInitiatingTarget, b as OfferAsset, c as BrandVisibilityEventType, d as EventPlacementDetails, f as EventTracker, g as WidgetEventType, i as DiscoValidationError, j as Gender, k as RunningExperiment, l as ElementClickInitiatingTarget, m as ProductEventType, n as DiscoError, o as BrandDisplayInitiatingTarget, p as ProductDisplayInitiatingTarget, r as DiscoNetworkError, s as BrandProperties, t as DiscoApiError, u as EventPayload, v as Footer, w as Recommendation, x as OfferCtaDetails, y as Offer } from "./errors-BhsYlfvH.js";
2
2
 
3
3
  //#region src/external/DiscoClient.d.ts
4
4
  /**
5
5
  * Authenticate with a scoped public API key (`disco_pk_live_…` /
6
- * `disco_pk_sandbox_…`). The prefix selects the environment, so there is no
7
- * separate `env` to set.
6
+ * `disco_pk_sandbox_…`). Both prefixes default to production. Use `baseUrl`
7
+ * to override the gateway for recommendations and events.
8
8
  */
9
9
  type DiscoClientConfig = {
10
10
  apiKey: string;
11
+ /**
12
+ * Absolute HTTP(S) gateway root, without a query or fragment. The SDK appends
13
+ * `/recommendations` and `/events`. Defaults to `https://partners.disconetwork.com`.
14
+ */
15
+ baseUrl?: string;
11
16
  /**
12
17
  * Value for the required `X-API-Version` header. Defaults to
13
18
  * `DEFAULT_API_VERSION` (see `config.ts`).
@@ -32,7 +37,7 @@ type RecommendationsWithTracker = {
32
37
  /**
33
38
  * Typed client for the Disco recommendations API — calls
34
39
  * `disco-recommendations-api` **directly** (no proxy) at
35
- * `partners.disconetwork(-staging).com/recommendations`.
40
+ * `/recommendations` on the configured gateway (production by default).
36
41
  *
37
42
  * This is the recommended, partner-facing client. It maps the friendly
38
43
  * camelCase request into the rec-api wire body (sending `x-api-key` +
@@ -44,7 +49,7 @@ type RecommendationsWithTracker = {
44
49
  */
45
50
  declare class DiscoClient {
46
51
  #private;
47
- get env(): DiscoEnv;
52
+ get baseUrl(): string;
48
53
  constructor(config: DiscoClientConfig);
49
54
  /**
50
55
  * Fetch recommendations for the given request.
@@ -59,7 +64,7 @@ declare class DiscoClient {
59
64
  getRecommendations: (request: RecommendationsRequest, options?: GetRecommendationsOptions) => Promise<RecommendationsResponse>;
60
65
  /**
61
66
  * Fetch recommendations and create a session-bound events tracker in one
62
- * call. The tracker inherits this client's API key and environment.
67
+ * call. The tracker inherits this client's API key and base URL.
63
68
  */
64
69
  getRecommendationsWithTracker: (request: RecommendationsRequest, options?: GetRecommendationsOptions & CreateTrackingManagerOptions) => Promise<RecommendationsWithTracker>;
65
70
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../src/external/DiscoClient.ts","../src/events/dedupe.ts"],"mappings":";;;AAiCA;;;;;AAAA,KAAY,iBAAA;EACV,MAAA;EAMe;;AAAK;AAGtB;EAJE,UAAA;EACA,KAAA,UAAe,KAAK;AAAA;AAAA,KAGV,yBAAA;EAKA,uEAHV,MAAA,GAAS,WAAW;AAAA;AAAA,KAGV,4BAAA;EAEU,8EAApB,KAAA,UAAe,KAAK;AAAA;;;;;KAOV,0BAAA;EACV,IAAA,EAAM,uBAAA;EACN,OAAA,EAAS,YAAY;AAAA;AAgBvB;;;;;;;;;;;;;AAAA,cAAa,WAAA;EAAA;MAMP,GAAA,CAAA,GAAO,QAAA;cAIC,MAAA,EAAQ,iBAAA;EA4GL;;;;;;;;;;EA/Ef,kBAAA,GACE,OAAA,EAAS,sBAAA,EACT,OAAA,GAAU,yBAAA,KACT,OAAA,CAAQ,uBAAA;EADT;;;;EAkDF,6BAAA,GACE,OAAA,EAAS,sBAAA,EACT,OAAA,GAAU,yBAAA,GAA4B,4BAAA,KACrC,OAAA,CAAQ,0BAAA;EAFT;;;;;;;;;;;EAuBF,qBAAA,GACE,SAAA,UACA,OAAA,GAAU,4BAAA,KACT,YAAA;AAAA;;;;;AAhKL;;;;;;iBCZgB,oBAAA,CAAqB,KAAA,EAAO,YAAA,GAAe,YAAY"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../src/external/DiscoClient.ts","../src/events/dedupe.ts"],"mappings":";;;;AAiCA;;;;KAAY,iBAAA;EACV,MAAA;EAUA;;;;EALA,OAAA;EASU;;;;EAJV,UAAA;EACA,KAAA,UAAe,KAAK;AAAA;AAAA,KAGV,yBAAA;EAOV,uEALA,MAAA,GAAS,WAAW;AAAA;AAAA,KAGV,4BAAA;gFAEV,KAAA,UAAe,KAAK;AAAA;;;;;KAOV,0BAAA;EACV,IAAA,EAAM,uBAAA;EACN,OAAA,EAAS,YAAY;AAAA;;;;;;;;;;;;;;cAgBV,WAAA;EAAA;MAMP,OAAA,CAAA;cAIQ,MAAA,EAAQ,iBAAA;EAAA;;;;;;;;;;EA6BpB,kBAAA,GACE,OAAA,EAAS,sBAAA,EACT,OAAA,GAAU,yBAAA,KACT,OAAA,CAAQ,uBAAA;EAkDT;;;;EADF,6BAAA,GACE,OAAA,EAAS,sBAAA,EACT,OAAA,GAAU,yBAAA,GAA4B,4BAAA,KACrC,OAAA,CAAQ,0BAAA;EAAA;;;;;;;AAwBI;;;;EAHf,qBAAA,GACE,SAAA,UACA,OAAA,GAAU,4BAAA,KACT,YAAA;AAAA;;;;;AArKL;;;;;;iBCZgB,oBAAA,CAAqB,KAAA,EAAO,YAAA,GAAe,YAAY"}
package/dist/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  "use client";
2
- import { a as DiscoError, c as isAbortError, d as zRecommendationsResponse2, i as DiscoApiError, l as envFromApiKey, n as transformResponse, o as DiscoNetworkError, s as DiscoValidationError, t as transformRequest, u as zRecommendationsBody } from "./recommendationsTransforms-Brm4hw4e.js";
2
+ import { a as DiscoError, c as isAbortError, d as zRecommendationsResponse2, i as DiscoApiError, l as validatePublicApiKey, n as transformResponse, o as DiscoNetworkError, s as DiscoValidationError, t as transformRequest, u as zRecommendationsBody } from "./recommendationsTransforms-DzSawW-a.js";
3
3
  import * as z from "zod/v4";
4
4
  import { ZodError } from "zod/v4";
5
5
  //#region src/api/generated/recommendations/core/bodySerializer.gen.ts
@@ -1236,9 +1236,8 @@ const createClient = (config = {}) => {
1236
1236
  /**
1237
1237
  * Build a dedicated, per-instance recommendations transport client from an
1238
1238
  * already-resolved base URL and auth headers. This is intentionally a pure
1239
- * transport factory: environment derivation and header construction are the
1240
- * caller's responsibility (see `env.ts` / `config.ts`), so there is a single
1241
- * owner of key → env → config resolution rather than one per client.
1239
+ * transport factory: public-key validation, URL selection, and header
1240
+ * construction are the caller's responsibility (see `apiKey.ts` / `config.ts`).
1242
1241
  *
1243
1242
  * Pass the **gateway root** as `baseUrl` — the SDK appends the operation path
1244
1243
  * (`/recommendations`), so it must not be included.
@@ -1247,9 +1246,9 @@ const createClient = (config = {}) => {
1247
1246
  * via its `client` option, e.g.:
1248
1247
  *
1249
1248
  * ```ts
1250
- * const env = envFromApiKey(apiKey);
1249
+ * validatePublicApiKey(apiKey);
1251
1250
  * const client = createRecommendationsClient({
1252
- * baseUrl: GATEWAY_BASE_URL[env],
1251
+ * baseUrl: resolveGatewayBaseUrl(),
1253
1252
  * headers: authHeaders({ apiKey }),
1254
1253
  * });
1255
1254
  * await recommendations({ client, body, throwOnError: true });
@@ -1268,10 +1267,10 @@ function createRecommendationsClient(config) {
1268
1267
  /**
1269
1268
  * Build a per-instance events transport client for the generated events SDK,
1270
1269
  * mirroring {@link createRecommendationsClient}. Pure transport: callers own
1271
- * env → URL/header resolution (see `config.ts` / `env.ts`).
1270
+ * URL/header resolution (see `config.ts`).
1272
1271
  *
1273
1272
  * Unlike recommendations, the events SDK posts to `/`, so pass the **full events
1274
- * URL** as `baseUrl` (e.g. `${GATEWAY_BASE_URL[env]}/events`), not the gateway
1273
+ * URL** as `baseUrl` (e.g. `${resolveGatewayBaseUrl()}/events`), not the gateway
1275
1274
  * origin. The SDK reuses an `x-api-key` header from `headers` for its declared
1276
1275
  * security rather than re-deriving a token.
1277
1276
  *
@@ -1522,6 +1521,10 @@ const GATEWAY_BASE_URL = {
1522
1521
  production: "https://partners.disconetwork.com",
1523
1522
  staging: "https://partners.disconetwork-staging.com"
1524
1523
  };
1524
+ /** Apply the gateway default and normalize the caller-provided root. */
1525
+ function resolveGatewayBaseUrl(baseUrl = GATEWAY_BASE_URL.production) {
1526
+ return baseUrl.trim().replace(/\/+$/, "");
1527
+ }
1525
1528
  /**
1526
1529
  * Default value for the required `X-API-Version` header. Overridable per client
1527
1530
  * via `apiVersion`.
@@ -1627,7 +1630,7 @@ function toPlacement(placement) {
1627
1630
  /**
1628
1631
  * Typed client for the Disco recommendations API — calls
1629
1632
  * `disco-recommendations-api` **directly** (no proxy) at
1630
- * `partners.disconetwork(-staging).com/recommendations`.
1633
+ * `/recommendations` on the configured gateway (production by default).
1631
1634
  *
1632
1635
  * This is the recommended, partner-facing client. It maps the friendly
1633
1636
  * camelCase request into the rec-api wire body (sending `x-api-key` +
@@ -1641,21 +1644,21 @@ var DiscoClient = class {
1641
1644
  #recommendationsClient;
1642
1645
  #eventsClient;
1643
1646
  #fetch;
1644
- #env;
1645
- get env() {
1646
- return this.#env;
1647
+ #baseUrl;
1648
+ get baseUrl() {
1649
+ return this.#baseUrl;
1647
1650
  }
1648
1651
  constructor(config) {
1649
- const env = envFromApiKey(config.apiKey);
1650
- this.#env = env;
1652
+ validatePublicApiKey(config.apiKey);
1653
+ this.#baseUrl = resolveGatewayBaseUrl(config.baseUrl);
1651
1654
  this.#fetch = config.fetch ?? globalThis.fetch.bind(globalThis);
1652
1655
  this.#recommendationsClient = createRecommendationsClient({
1653
- baseUrl: GATEWAY_BASE_URL[env],
1656
+ baseUrl: this.#baseUrl,
1654
1657
  headers: authHeaders(config),
1655
1658
  fetch: this.#fetch
1656
1659
  });
1657
1660
  this.#eventsClient = createEventsClient({
1658
- baseUrl: `${GATEWAY_BASE_URL[env]}/events`,
1661
+ baseUrl: `${this.#baseUrl}/events`,
1659
1662
  headers: { "x-api-key": config.apiKey },
1660
1663
  fetch: this.#fetch
1661
1664
  });
@@ -1690,7 +1693,7 @@ var DiscoClient = class {
1690
1693
  };
1691
1694
  /**
1692
1695
  * Fetch recommendations and create a session-bound events tracker in one
1693
- * call. The tracker inherits this client's API key and environment.
1696
+ * call. The tracker inherits this client's API key and base URL.
1694
1697
  */
1695
1698
  getRecommendationsWithTracker = async (request, options) => {
1696
1699
  const data = await this.getRecommendations(request, { signal: options?.signal });