@configdirector/nextjs-sdk 1.13.0 → 1.14.0

package/dist/client/testing.d.cts

@@ -1,5 +1,5 @@
 
-import { a as NativeJsonValue, c as ConfigDirectorContext, l as ConfigDirectorLogger, n as ConfigDirectorClient, o as NativeValue, s as NativeValues } from "./types-CRVL6Yi2.cjs";
+import { _ as TrackedEvent, a as NativeJsonValue, c as ConfigDirectorContext, l as ConfigDirectorLogger, n as ConfigDirectorClient, o as NativeValue, s as NativeValues, v as TrackedEventDetailValue, y as TrackedEventDetails } from "./types-P8frfCGH.cjs";
 
 //#region ../shared/src/errors.d.ts
 declare class ConfigDirectorConnectionError extends Error {
@@ -29,7 +29,9 @@ type TestClientOptions = {
    */
   timeout?: number;
   /**
-   * The logger the SDK client uses. Defaults to the SDK's console logger at `warn` level.
+   * The logger the SDK client uses. Defaults to the SDK's console logger at `warn` level. Since the
+   * test client sends no telemetry, every tracked event that is not recorded as it was tracked logs
+   * a warning, rather than each cause once per telemetry batch.
    */
   logger?: ConfigDirectorLogger;
 };
@@ -98,6 +100,13 @@ interface TestClient {
    * the client connects without it. Resumes are not recorded.
    */
   readonly contextUpdates: ConfigDirectorContext[];
+  /**
+   * Every event the code under test tracked through the client, in call order, with the context
+   * the client had at that moment, as the SDK would report it: an event whose name does not have
+   * 1 to 150 characters is not recorded, and a value or details the SDK would leave out are missing
+   * from the record. The limit of 1,000 events per telemetry batch does not apply.
+   */
+  readonly trackedEvents: TrackedEvent[];
 }
 //#endregion
 //#region ../js-client-core/src/testing/installTestClient.d.ts
@@ -147,5 +156,5 @@ declare const installTestClient: (testClient: TestClient) => (() => void);
  */
 declare const createTestClient: (options?: TestClientOptions) => TestClient;
 //#endregion
-export { ConfigDirectorConnectionError, ConfigDirectorValidationError, type TestClient, type TestClientOptions, type NativeJsonValue as TestJsonValue, type NativeValue as TestValue, type NativeValues as TestValues, createTestClient, installTestClient };
+export { ConfigDirectorConnectionError, ConfigDirectorValidationError, type TestClient, type TestClientOptions, type NativeJsonValue as TestJsonValue, type NativeValue as TestValue, type NativeValues as TestValues, type TrackedEvent, type TrackedEventDetailValue, type TrackedEventDetails, createTestClient, installTestClient };
 //# sourceMappingURL=testing.d.cts.map

package/dist/client/testing.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.cts","names":[],"sources":["../../../shared/src/errors.ts","../../../js-client-core/src/testing/TestClient.ts","../../../js-client-core/src/testing/installTestClient.ts","../../src/client/testing.ts"],"mappings":";;;;cAAa,6BAAA,SAAsC,KAAA;EAAA,SACxB,IAAA;EAAA,SACT,MAAA;cAEJ,OAAA,UAAiB,MAAA;AAAA;AAAA,cAQlB,6BAAA,SAAsC,KAAA;EAAA,SACxB,IAAA;cAEb,OAAA;AAAA;;;;AAfd;;KCYY,iBAAA;EDZ4C;;;;;ECkBtD,MAAA,GAAS,YAAA;EDdoB;;;AAQ/B;ECWE,OAAA;;;;EAIA,MAAA,GAAS,oBAAA;AAAA;;;;;;;AAfX;;UA0BiB,UAAA;EAXc;;;;EAAA,SAgBpB,MAAA,EAAQ,oBAAA;EAhBR;;;AAWX;EAWE,QAAA,CAAS,GAAA,UAAa,KAAA,EAAO,WAAA;;;;;EAM7B,WAAA,CAAY,GAAA;EAiDkC;;;;EA3C9C,aAAA,CAAc,MAAA,EAAQ,YAAA;EAZb;;;;EAkBT,kBAAA;EANA;;;;EAYA,sBAAA;EAMA;;;;EAAA,kBAAA;EAyByB;;;;EAnBzB,iBAAA;;AC7DF;;;EDmEE,qBAAA;ECnEsD;;;;EDyEtD,iBAAA;EElED;;;;;EAAA,SFyEU,cAAA,EAAgB,qBAAA;AAAA;;;;;ADxG3B;;;;;;;;;;;;AAYA;;;;;;;cEYa,iBAAA,GAAqB,UAAA,EAAY,UAAA;;;;;;;;;;;;;;AFZ9C;;;;;;;;;cGiBa,gBAAA,GAAoB,OAAA,GAAU,iBAAA,KAAoB,UAAA"}
+{"version":3,"file":"testing.d.cts","names":[],"sources":["../../../shared/src/errors.ts","../../../js-client-core/src/testing/TestClient.ts","../../../js-client-core/src/testing/installTestClient.ts","../../src/client/testing.ts"],"mappings":";;;;cAAa,6BAAA,SAAsC,KAAA;EAAA,SACxB,IAAA;EAAA,SACT,MAAA;cAEJ,OAAA,UAAiB,MAAA;AAAA;AAAA,cAQlB,6BAAA,SAAsC,KAAA;EAAA,SACxB,IAAA;cAEb,OAAA;AAAA;;;;AAfd;;KCmBY,iBAAA;EDnB4C;;;;;ECyBtD,MAAA,GAAS,YAAA;EDrBoB;;;AAQ/B;ECkBE,OAAA;;;;;;EAMA,MAAA,GAAS,oBAAA;AAAA;;;;;AAjBX;;;;UA4BiB,UAAA;EAtBN;;;;EAAA,SA2BA,MAAA,EAAQ,oBAAA;EAhBY;AAW/B;;;EAWE,QAAA,CAAS,GAAA,UAAa,KAAA,EAAO,WAAA;EAAA;;;;EAM7B,WAAA,CAAY,GAAA;EAyDwB;;;;EAnDpC,aAAA,CAAc,MAAA,EAAQ,YAAA;EAZO;;;;EAkB7B,kBAAA;EANsB;;;;EAYtB,sBAAA;EAYA;;;;EANA,kBAAA;EAiCS;;;;EA3BT,iBAAA;;;ACtEF;;ED4EE,qBAAA;EC5E4C;;;;EDkF5C,iBAAA;EE5EW;;;;;EAAA,SFmFF,cAAA,EAAgB,qBAAA;EEnFoC;;;;;;EAAA,SF2FpD,aAAA,EAAe,YAAA;AAAA;;;;;ADzH1B;;;;;;;;;;;;AAYA;;;;;;;cEYa,iBAAA,GAAqB,UAAA,EAAY,UAAA;;;;;;;;;;;;;AFZ9C;;;;;;;;;;cGkBa,gBAAA,GAAoB,OAAA,GAAU,iBAAA,KAAoB,UAAA"}

package/dist/client/testing.d.mts

@@ -1,5 +1,5 @@
 
-import { a as NativeJsonValue, c as ConfigDirectorContext, l as ConfigDirectorLogger, n as ConfigDirectorClient, o as NativeValue, s as NativeValues } from "./types-B4kvU3bh.mjs";
+import { _ as TrackedEvent, a as NativeJsonValue, c as ConfigDirectorContext, l as ConfigDirectorLogger, n as ConfigDirectorClient, o as NativeValue, s as NativeValues, v as TrackedEventDetailValue, y as TrackedEventDetails } from "./types-CdyMdj5l.mjs";
 
 //#region ../shared/src/errors.d.ts
 declare class ConfigDirectorConnectionError extends Error {
@@ -29,7 +29,9 @@ type TestClientOptions = {
    */
   timeout?: number;
   /**
-   * The logger the SDK client uses. Defaults to the SDK's console logger at `warn` level.
+   * The logger the SDK client uses. Defaults to the SDK's console logger at `warn` level. Since the
+   * test client sends no telemetry, every tracked event that is not recorded as it was tracked logs
+   * a warning, rather than each cause once per telemetry batch.
    */
   logger?: ConfigDirectorLogger;
 };
@@ -98,6 +100,13 @@ interface TestClient {
    * the client connects without it. Resumes are not recorded.
    */
   readonly contextUpdates: ConfigDirectorContext[];
+  /**
+   * Every event the code under test tracked through the client, in call order, with the context
+   * the client had at that moment, as the SDK would report it: an event whose name does not have
+   * 1 to 150 characters is not recorded, and a value or details the SDK would leave out are missing
+   * from the record. The limit of 1,000 events per telemetry batch does not apply.
+   */
+  readonly trackedEvents: TrackedEvent[];
 }
 //#endregion
 //#region ../js-client-core/src/testing/installTestClient.d.ts
@@ -147,5 +156,5 @@ declare const installTestClient: (testClient: TestClient) => (() => void);
  */
 declare const createTestClient: (options?: TestClientOptions) => TestClient;
 //#endregion
-export { ConfigDirectorConnectionError, ConfigDirectorValidationError, type TestClient, type TestClientOptions, type NativeJsonValue as TestJsonValue, type NativeValue as TestValue, type NativeValues as TestValues, createTestClient, installTestClient };
+export { ConfigDirectorConnectionError, ConfigDirectorValidationError, type TestClient, type TestClientOptions, type NativeJsonValue as TestJsonValue, type NativeValue as TestValue, type NativeValues as TestValues, type TrackedEvent, type TrackedEventDetailValue, type TrackedEventDetails, createTestClient, installTestClient };
 //# sourceMappingURL=testing.d.mts.map

package/dist/client/testing.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.mts","names":[],"sources":["../../../shared/src/errors.ts","../../../js-client-core/src/testing/TestClient.ts","../../../js-client-core/src/testing/installTestClient.ts","../../src/client/testing.ts"],"mappings":";;;;cAAa,6BAAA,SAAsC,KAAA;EAAA,SACxB,IAAA;EAAA,SACT,MAAA;cAEJ,OAAA,UAAiB,MAAA;AAAA;AAAA,cAQlB,6BAAA,SAAsC,KAAA;EAAA,SACxB,IAAA;cAEb,OAAA;AAAA;;;;AAfd;;KCYY,iBAAA;EDZ4C;;;;;ECkBtD,MAAA,GAAS,YAAA;EDdoB;;;AAQ/B;ECWE,OAAA;;;;EAIA,MAAA,GAAS,oBAAA;AAAA;;;;;;;AAfX;;UA0BiB,UAAA;EAXc;;;;EAAA,SAgBpB,MAAA,EAAQ,oBAAA;EAhBR;;;AAWX;EAWE,QAAA,CAAS,GAAA,UAAa,KAAA,EAAO,WAAA;;;;;EAM7B,WAAA,CAAY,GAAA;EAiDkC;;;;EA3C9C,aAAA,CAAc,MAAA,EAAQ,YAAA;EAZb;;;;EAkBT,kBAAA;EANA;;;;EAYA,sBAAA;EAMA;;;;EAAA,kBAAA;EAyByB;;;;EAnBzB,iBAAA;;AC7DF;;;EDmEE,qBAAA;ECnEsD;;;;EDyEtD,iBAAA;EElED;;;;;EAAA,SFyEU,cAAA,EAAgB,qBAAA;AAAA;;;;;ADxG3B;;;;;;;;;;;;AAYA;;;;;;;cEYa,iBAAA,GAAqB,UAAA,EAAY,UAAA;;;;;;;;;;;;;;AFZ9C;;;;;;;;;cGiBa,gBAAA,GAAoB,OAAA,GAAU,iBAAA,KAAoB,UAAA"}
+{"version":3,"file":"testing.d.mts","names":[],"sources":["../../../shared/src/errors.ts","../../../js-client-core/src/testing/TestClient.ts","../../../js-client-core/src/testing/installTestClient.ts","../../src/client/testing.ts"],"mappings":";;;;cAAa,6BAAA,SAAsC,KAAA;EAAA,SACxB,IAAA;EAAA,SACT,MAAA;cAEJ,OAAA,UAAiB,MAAA;AAAA;AAAA,cAQlB,6BAAA,SAAsC,KAAA;EAAA,SACxB,IAAA;cAEb,OAAA;AAAA;;;;AAfd;;KCmBY,iBAAA;EDnB4C;;;;;ECyBtD,MAAA,GAAS,YAAA;EDrBoB;;;AAQ/B;ECkBE,OAAA;;;;;;EAMA,MAAA,GAAS,oBAAA;AAAA;;;;;AAjBX;;;;UA4BiB,UAAA;EAtBN;;;;EAAA,SA2BA,MAAA,EAAQ,oBAAA;EAhBY;AAW/B;;;EAWE,QAAA,CAAS,GAAA,UAAa,KAAA,EAAO,WAAA;EAAA;;;;EAM7B,WAAA,CAAY,GAAA;EAyDwB;;;;EAnDpC,aAAA,CAAc,MAAA,EAAQ,YAAA;EAZO;;;;EAkB7B,kBAAA;EANsB;;;;EAYtB,sBAAA;EAYA;;;;EANA,kBAAA;EAiCS;;;;EA3BT,iBAAA;;;ACtEF;;ED4EE,qBAAA;EC5E4C;;;;EDkF5C,iBAAA;EE5EW;;;;;EAAA,SFmFF,cAAA,EAAgB,qBAAA;EEnFoC;;;;;;EAAA,SF2FpD,aAAA,EAAe,YAAA;AAAA;;;;;ADzH1B;;;;;;;;;;;;AAYA;;;;;;;cEYa,iBAAA,GAAqB,UAAA,EAAY,UAAA;;;;;;;;;;;;;AFZ9C;;;;;;;;;;cGkBa,gBAAA,GAAoB,OAAA,GAAU,iBAAA,KAAoB,UAAA"}

package/dist/client/testing.mjs

@@ -1,3 +1,3 @@
 "use client";
-"use client";import{c as e,d as t,f as n,h as r,l as i,m as a,p as o,r as s,t as c}from"./installedTestClient-DNVY-qrM.mjs";const l={environmentId:`test-environment`,projectId:`test-project`},u=e=>{switch(e){case`initialization`:return`initialize`;case`context update`:return`updateContext`;default:return}};var d=class{constructor(e,t){this.logger=e,this.emitter=new a,this.configs=new Map,this.recordedContexts=[],this.pendingDeliveries=[],this.armed={initialize:`nothing`,updateContext:`nothing`},this.connected=!1,this.delivering=!1,this.revision=0,this.attemptGeneration=0,this.on=(e,t)=>this.emitter.on(e,t),this.off=(e,t)=>this.emitter.off(e,t),this.store(t)}get contextUpdates(){return[...this.recordedContexts]}setValue(e,t){let n=this.encode(e,t);this.configs.set(e,n),this.deliverIfConnected(r(r({},l),{},{kind:`delta`,configs:{[e]:n}}))}removeValue(e){this.configs.delete(e),this.deliverIfConnected(this.fullUpdate())}replaceValues(e){let t=this.encodeAll(e);this.configs.clear(),t.forEach((e,t)=>this.configs.set(t,e)),this.armed.initialize=`nothing`,this.armed.updateContext=`nothing`,this.deliverIfConnected(this.fullUpdate())}hold(e){this.armed[e]=`hold`}complete(e){var t;((t=this.pendingHold)==null?void 0:t.attempt)===e?this.pendingHold.complete():this.armed[e]===`hold`&&(this.armed[e]=`nothing`)}fail(e){var t;((t=this.pendingHold)==null?void 0:t.attempt)===e?this.pendingHold.fail():this.armed[e]=`failure`}connect(e,t,n){this.endAttempt();let r=u(n);if(!r)return this.connectNow();this.recordedContexts.push(e);let i=this.armed[r];switch(this.armed[r]=`nothing`,i){case`failure`:return this.failNow(n);case`hold`:return this.holdNow(r,n,t);default:return this.connectNow()}}clear(){this.emitter.clear()}close(){this.endAttempt()}dispose(){this.close(),this.clear()}endAttempt(){var e;this.attemptGeneration++,this.connected=!1,(e=this.pendingHold)==null||e.end()}connectNow(){let e=Promise.resolve(this);return this.scheduleFirstDelivery(),e}holdNow(e,t,n){return new Promise((r,i)=>{let a=setTimeout(()=>{var e;return(e=this.pendingHold)==null?void 0:e.end()},n),o=()=>{clearTimeout(a),this.pendingHold=void 0};this.pendingHold={attempt:e,end:()=>{o(),r(this)},complete:()=>{o(),r(this),this.scheduleFirstDelivery()},fail:()=>{o();let e=this.fatalError(t);this.emitter.emit(`connectionError`,e),i(e)}}})}failNow(e){let t=this.fatalError(e);return this.emitter.emit(`connectionError`,t),Promise.reject(t)}fatalError(e){return new n(`Connection failed with status: 401. Error: the test client failed this ${e}. This is an unrecoverable error, will not attempt to reconnect.`,401)}scheduleFirstDelivery(){let e=this.attemptGeneration;Promise.resolve().then(()=>{}).then(()=>{e===this.attemptGeneration&&(this.connected=!0,this.deliver(this.fullUpdate()))})}deliverIfConnected(e){this.connected&&this.deliver(e)}deliver(e){if(this.pendingDeliveries.push(e),!this.delivering){this.delivering=!0;try{let e=this.pendingDeliveries.shift();for(;e;)this.emitCaught(e),e=this.pendingDeliveries.shift()}finally{this.delivering=!1}}}emitCaught(e){try{this.emitter.emit(`configSetReceived`,e)}catch(e){this.logger.error(`[InMemoryConnection] Error dispatching a config update from the test client: `,e)}}fullUpdate(){return r(r({},l),{},{kind:`full`,configs:Object.fromEntries(this.configs)})}store(e){this.encodeAll(e).forEach((e,t)=>this.configs.set(t,e))}encodeAll(e){let t=new Map;for(let[n,r]of Object.entries(e))t.set(n,this.encode(n,r));return t}encode(e,n){return t(`test-config:${e}`,e,n,`test-value:${e}:${++this.revision}`)}},f=class{constructor(e,t){this.client=e,this.connection=t}setValue(e,t){this.connection.setValue(e,t)}removeValue(e){this.connection.removeValue(e)}replaceValues(e){this.connection.replaceValues(e)}holdInitialization(){this.connection.hold(`initialize`)}completeInitialization(){this.connection.complete(`initialize`)}failInitialization(){this.connection.fail(`initialize`)}holdContextUpdate(){this.connection.hold(`updateContext`)}completeContextUpdate(){this.connection.complete(`updateContext`)}failContextUpdate(){this.connection.fail(`updateContext`)}get contextUpdates(){return this.connection.contextUpdates}};const p=(t,n)=>{var r,a;let o=(r=n==null?void 0:n.logger)==null?i():r,c=new d(o,(a=n==null?void 0:n.values)==null?{}:a);return new f(new s(()=>e,`test-client`,t,{logger:o,connection:{timeout:n==null?void 0:n.timeout}},{transport:c}),c)},m=e=>{let t=globalThis,n=t[c];return t[c]=e.client,()=>{t[c]=n}},h=e=>p({sdkName:`nextjs-sdk`,sdkVersion:`1.13.0`},e);export{n as ConfigDirectorConnectionError,o as ConfigDirectorValidationError,h as createTestClient,m as installTestClient};
+"use client";import{_ as e,c as t,d as n,f as r,l as i,m as a,p as o,r as s,t as c,v as l}from"./installedTestClient-CL4AQC58.mjs";const u=(e,t)=>l(l(l({name:e.name},t===void 0?{}:{context:t}),e.value===void 0?{}:{value:e.value}),e.details===void 0?{}:{details:e.details});var d=class{constructor(e){this.logger=e,this.events=[]}record(t,n){switch(t.warnings.forEach(t=>this.logger.warn(e[t])),t.outcome){case`dropped`:return;case`admitted`:this.events.push(u(t.entry,n));return}}};const f={environmentId:`test-environment`,projectId:`test-project`},p=e=>{switch(e){case`initialization`:return`initialize`;case`context update`:return`updateContext`;default:return}};var m=class{constructor(e,t){this.logger=e,this.emitter=new a,this.configs=new Map,this.recordedContexts=[],this.pendingDeliveries=[],this.armed={initialize:`nothing`,updateContext:`nothing`},this.connected=!1,this.delivering=!1,this.revision=0,this.attemptGeneration=0,this.on=(e,t)=>this.emitter.on(e,t),this.off=(e,t)=>this.emitter.off(e,t),this.store(t)}get contextUpdates(){return[...this.recordedContexts]}setValue(e,t){let n=this.encode(e,t);this.configs.set(e,n),this.deliverIfConnected(l(l({},f),{},{kind:`delta`,configs:{[e]:n}}))}removeValue(e){this.configs.delete(e),this.deliverIfConnected(this.fullUpdate())}replaceValues(e){let t=this.encodeAll(e);this.configs.clear(),t.forEach((e,t)=>this.configs.set(t,e)),this.armed.initialize=`nothing`,this.armed.updateContext=`nothing`,this.deliverIfConnected(this.fullUpdate())}hold(e){this.armed[e]=`hold`}complete(e){var t;((t=this.pendingHold)==null?void 0:t.attempt)===e?this.pendingHold.complete():this.armed[e]===`hold`&&(this.armed[e]=`nothing`)}fail(e){var t;((t=this.pendingHold)==null?void 0:t.attempt)===e?this.pendingHold.fail():this.armed[e]=`failure`}connect(e,t,n){this.endAttempt();let r=p(n);if(!r)return this.connectNow();this.recordedContexts.push(e);let i=this.armed[r];switch(this.armed[r]=`nothing`,i){case`failure`:return this.failNow(n);case`hold`:return this.holdNow(r,n,t);default:return this.connectNow()}}clear(){this.emitter.clear()}close(){this.endAttempt()}dispose(){this.close(),this.clear()}endAttempt(){var e;this.attemptGeneration++,this.connected=!1,(e=this.pendingHold)==null||e.end()}connectNow(){let e=Promise.resolve(this);return this.scheduleFirstDelivery(),e}holdNow(e,t,n){return new Promise((r,i)=>{let a=setTimeout(()=>{var e;return(e=this.pendingHold)==null?void 0:e.end()},n),o=()=>{clearTimeout(a),this.pendingHold=void 0};this.pendingHold={attempt:e,end:()=>{o(),r(this)},complete:()=>{o(),r(this),this.scheduleFirstDelivery()},fail:()=>{o();let e=this.fatalError(t);this.emitter.emit(`connectionError`,e),i(e)}}})}failNow(e){let t=this.fatalError(e);return this.emitter.emit(`connectionError`,t),Promise.reject(t)}fatalError(e){return new r(`Connection failed with status: 401. Error: the test client failed this ${e}. This is an unrecoverable error, will not attempt to reconnect.`,401)}scheduleFirstDelivery(){let e=this.attemptGeneration;Promise.resolve().then(()=>{}).then(()=>{e===this.attemptGeneration&&(this.connected=!0,this.deliver(this.fullUpdate()))})}deliverIfConnected(e){this.connected&&this.deliver(e)}deliver(e){if(this.pendingDeliveries.push(e),!this.delivering){this.delivering=!0;try{let e=this.pendingDeliveries.shift();for(;e;)this.emitCaught(e),e=this.pendingDeliveries.shift()}finally{this.delivering=!1}}}emitCaught(e){try{this.emitter.emit(`configSetReceived`,e)}catch(e){this.logger.error(`[InMemoryConnection] Error dispatching a config update from the test client: `,e)}}fullUpdate(){return l(l({},f),{},{kind:`full`,configs:Object.fromEntries(this.configs)})}store(e){this.encodeAll(e).forEach((e,t)=>this.configs.set(t,e))}encodeAll(e){let t=new Map;for(let[n,r]of Object.entries(e))t.set(n,this.encode(n,r));return t}encode(e,t){return n(`test-config:${e}`,e,t,`test-value:${e}:${++this.revision}`)}},h=class{constructor(e,t,n){this.client=e,this.connection=t,this.trackedEvents=n}setValue(e,t){this.connection.setValue(e,t)}removeValue(e){this.connection.removeValue(e)}replaceValues(e){this.connection.replaceValues(e)}holdInitialization(){this.connection.hold(`initialize`)}completeInitialization(){this.connection.complete(`initialize`)}failInitialization(){this.connection.fail(`initialize`)}holdContextUpdate(){this.connection.hold(`updateContext`)}completeContextUpdate(){this.connection.complete(`updateContext`)}failContextUpdate(){this.connection.fail(`updateContext`)}get contextUpdates(){return this.connection.contextUpdates}};const g=(e,n)=>{var r,a;let o=(r=n==null?void 0:n.logger)==null?i():r,c=new m(o,(a=n==null?void 0:n.values)==null?{}:a),u=new d(o);return new h(new s(()=>l(l({},t),{},{trackedEvent:(e,t)=>u.record(e,t)}),`test-client`,e,{logger:o,connection:{timeout:n==null?void 0:n.timeout}},{transport:c}),c,u.events)},_=e=>{let t=globalThis,n=t[c];return t[c]=e.client,()=>{t[c]=n}},v=e=>g({sdkName:`nextjs-sdk`,sdkVersion:`1.14.0`},e);export{r as ConfigDirectorConnectionError,o as ConfigDirectorValidationError,v as createTestClient,_ as installTestClient};
 //# sourceMappingURL=testing.mjs.map

package/dist/client/testing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.mjs","names":["createTestClient"],"sources":["../../../js-client-core/src/testing/InMemoryConnection.ts","../../../js-client-core/src/testing/TestClient.ts","../../../js-client-core/src/testing/installTestClient.ts","../../src/client/testing.ts"],"sourcesContent":["import type {\n  ClientConnectAction,\n  ConfigDirectorContext,\n  ConfigDirectorLogger,\n  ConfigSet,\n  ConfigState,\n  Transport,\n  TransportEvents,\n} from \"../types\";\nimport { Emitter } from \"../Emitter\";\nimport { ConfigDirectorConnectionError } from \"../errors\";\nimport type { TestValue, TestValues } from \"./values\";\nimport { nativeValueConfigState } from \"../native-values\";\n\ntype ControlledAttempt = \"initialize\" | \"updateContext\";\n\ntype Armed = \"nothing\" | \"hold\" | \"failure\";\n\ntype PendingHold = {\n  attempt: ControlledAttempt;\n  end: () => void;\n  complete: () => void;\n  fail: () => void;\n};\n\nconst TEST_ENVIRONMENT = { environmentId: \"test-environment\", projectId: \"test-project\" };\n\nconst controlledAttemptFor = (reason: ClientConnectAction): ControlledAttempt | undefined => {\n  switch (reason) {\n    case \"initialization\":\n      return \"initialize\";\n    case \"context update\":\n      return \"updateContext\";\n    default:\n      return undefined;\n  }\n};\n\nexport class InMemoryConnection implements Transport {\n  private readonly emitter = new Emitter<TransportEvents>();\n  private readonly configs = new Map<string, ConfigState>();\n  private readonly recordedContexts: ConfigDirectorContext[] = [];\n  private readonly pendingDeliveries: ConfigSet[] = [];\n  private readonly armed: Record<ControlledAttempt, Armed> = { initialize: \"nothing\", updateContext: \"nothing\" };\n  private pendingHold: PendingHold | undefined;\n  private connected = false;\n  private delivering = false;\n  private revision = 0;\n  private attemptGeneration = 0;\n\n  constructor(\n    private readonly logger: ConfigDirectorLogger,\n    values: TestValues,\n  ) {\n    this.store(values);\n  }\n\n  public get contextUpdates(): ConfigDirectorContext[] {\n    return [...this.recordedContexts];\n  }\n\n  public setValue(key: string, value: TestValue) {\n    const configState = this.encode(key, value);\n    this.configs.set(key, configState);\n    this.deliverIfConnected({ ...TEST_ENVIRONMENT, kind: \"delta\", configs: { [key]: configState } });\n  }\n\n  public removeValue(key: string) {\n    this.configs.delete(key);\n    this.deliverIfConnected(this.fullUpdate());\n  }\n\n  public replaceValues(values: TestValues) {\n    const encoded = this.encodeAll(values);\n    this.configs.clear();\n    encoded.forEach((configState, key) => this.configs.set(key, configState));\n    this.armed.initialize = \"nothing\";\n    this.armed.updateContext = \"nothing\";\n    this.deliverIfConnected(this.fullUpdate());\n  }\n\n  public hold(attempt: ControlledAttempt) {\n    this.armed[attempt] = \"hold\";\n  }\n\n  public complete(attempt: ControlledAttempt) {\n    if (this.pendingHold?.attempt === attempt) {\n      this.pendingHold.complete();\n    } else if (this.armed[attempt] === \"hold\") {\n      this.armed[attempt] = \"nothing\";\n    }\n  }\n\n  public fail(attempt: ControlledAttempt) {\n    if (this.pendingHold?.attempt === attempt) {\n      this.pendingHold.fail();\n    } else {\n      this.armed[attempt] = \"failure\";\n    }\n  }\n\n  public connect(context: ConfigDirectorContext, timeout: number, reason: ClientConnectAction): Promise<this> {\n    this.endAttempt();\n    const attempt = controlledAttemptFor(reason);\n    if (!attempt) {\n      return this.connectNow();\n    }\n    this.recordedContexts.push(context);\n    const armed = this.armed[attempt];\n    this.armed[attempt] = \"nothing\";\n    switch (armed) {\n      case \"failure\":\n        return this.failNow(reason);\n      case \"hold\":\n        return this.holdNow(attempt, reason, timeout);\n      default:\n        return this.connectNow();\n    }\n  }\n\n  public on: Transport[\"on\"] = (name, handler) => this.emitter.on(name, handler);\n\n  public off: Transport[\"off\"] = (name, handler) => this.emitter.off(name, handler);\n\n  public clear() {\n    this.emitter.clear();\n  }\n\n  public close() {\n    this.endAttempt();\n  }\n\n  public dispose() {\n    this.close();\n    this.clear();\n  }\n\n  private endAttempt() {\n    this.attemptGeneration++;\n    this.connected = false;\n    this.pendingHold?.end();\n  }\n\n  private connectNow(): Promise<this> {\n    const connected = Promise.resolve(this);\n    this.scheduleFirstDelivery();\n    return connected;\n  }\n\n  private holdNow(attempt: ControlledAttempt, reason: ClientConnectAction, timeout: number): Promise<this> {\n    return new Promise<this>((resolve, reject) => {\n      const timer = setTimeout(() => this.pendingHold?.end(), timeout);\n      const release = () => {\n        clearTimeout(timer);\n        this.pendingHold = undefined;\n      };\n      this.pendingHold = {\n        attempt,\n        end: () => {\n          release();\n          resolve(this);\n        },\n        complete: () => {\n          release();\n          resolve(this);\n          this.scheduleFirstDelivery();\n        },\n        fail: () => {\n          release();\n          const error = this.fatalError(reason);\n          this.emitter.emit(\"connectionError\", error);\n          reject(error);\n        },\n      };\n    });\n  }\n\n  private failNow(reason: ClientConnectAction): Promise<this> {\n    const error = this.fatalError(reason);\n    this.emitter.emit(\"connectionError\", error);\n    return Promise.reject(error);\n  }\n\n  private fatalError(reason: ClientConnectAction) {\n    return new ConfigDirectorConnectionError(\n      `Connection failed with status: 401. Error: the test client failed this ${reason}. This is an unrecoverable error, will not attempt to reconnect.`,\n      401,\n    );\n  }\n\n  private scheduleFirstDelivery() {\n    const generation = this.attemptGeneration;\n    void Promise.resolve()\n      .then(() => {})\n      .then(() => {\n        if (generation !== this.attemptGeneration) {\n          return;\n        }\n        this.connected = true;\n        this.deliver(this.fullUpdate());\n      });\n  }\n\n  private deliverIfConnected(configSet: ConfigSet) {\n    if (this.connected) {\n      this.deliver(configSet);\n    }\n  }\n\n  private deliver(configSet: ConfigSet) {\n    this.pendingDeliveries.push(configSet);\n    if (this.delivering) {\n      return;\n    }\n    this.delivering = true;\n    try {\n      let next = this.pendingDeliveries.shift();\n      while (next) {\n        this.emitCaught(next);\n        next = this.pendingDeliveries.shift();\n      }\n    } finally {\n      this.delivering = false;\n    }\n  }\n\n  private emitCaught(configSet: ConfigSet) {\n    try {\n      this.emitter.emit(\"configSetReceived\", configSet);\n    } catch (error) {\n      this.logger.error(\"[InMemoryConnection] Error dispatching a config update from the test client: \", error);\n    }\n  }\n\n  private fullUpdate(): ConfigSet {\n    return { ...TEST_ENVIRONMENT, kind: \"full\", configs: Object.fromEntries(this.configs) };\n  }\n\n  private store(values: TestValues) {\n    this.encodeAll(values).forEach((configState, key) => this.configs.set(key, configState));\n  }\n\n  private encodeAll(values: TestValues): Map<string, ConfigState> {\n    const encoded = new Map<string, ConfigState>();\n    for (const [key, value] of Object.entries(values)) {\n      encoded.set(key, this.encode(key, value));\n    }\n    return encoded;\n  }\n\n  private encode(key: string, value: TestValue): ConfigState {\n    return nativeValueConfigState(`test-config:${key}`, key, value, `test-value:${key}:${++this.revision}`);\n  }\n}\n","import { DefaultConfigDirectorClient } from \"../DefaultConfigDirectorClient\";\nimport { createDefaultLogger } from \"../logger\";\nimport type { ConfigDirectorClient, ConfigDirectorContext, ConfigDirectorLogger, IdentifyingSdkOptions } from \"../types\";\nimport { discardingTelemetryClient } from \"../telemetry/discarding\";\nimport { InMemoryConnection } from \"./InMemoryConnection\";\nimport type { TestValue, TestValues } from \"./values\";\n\nconst TEST_CLIENT_SDK_KEY = \"test-client\";\n\n/**\n * Options for {@link createTestClient}. Every option is optional.\n */\nexport type TestClientOptions = {\n  /**\n   * The config values the test client serves once its client connects, keyed by config key. The\n   * config type follows from each value: a boolean, an integral number (`integer`), any other\n   * number (`float`), a string, or a plain object or array (`json`).\n   */\n  values?: TestValues;\n  /**\n   * The connection timeout of the SDK client, in milliseconds. It bounds how long a held\n   * `initialize` or `updateContext` waits. Defaults to the SDK's production timeout.\n   */\n  timeout?: number;\n  /**\n   * The logger the SDK client uses. Defaults to the SDK's console logger at `warn` level.\n   */\n  logger?: ConfigDirectorLogger;\n};\n\n/**\n * A real ConfigDirector client connected to an in-memory server that the test controls.\n *\n * The client under {@link TestClient.client} is the SDK's production client: value parsing, watchers,\n * events, and readiness behave as they do against ConfigDirector. Only the network connection and\n * telemetry are replaced, so no request is ever made and nothing is left running after the client is\n * disposed.\n */\nexport interface TestClient {\n  /**\n   * The SDK client to hand to the code under test. It starts uninitialized, like a production\n   * client; `initialize` completes at once with the seeded values unless initialization is held.\n   */\n  readonly client: ConfigDirectorClient;\n\n  /**\n   * Stores `value` under `key` and, when the client is connected, delivers it as an update, so\n   * reads, watchers, and `configsUpdated` handlers see it.\n   */\n  setValue(key: string, value: TestValue): void;\n\n  /**\n   * Removes `key` and, when the client is connected, delivers a full update without it, so reads\n   * fall back to the in-code default value and watchers of `key` receive that default.\n   */\n  removeValue(key: string): void;\n\n  /**\n   * Replaces every stored value with `values`, disarms any armed hold or failure, and, when the\n   * client is connected, delivers the new values as a full update.\n   */\n  replaceValues(values: TestValues): void;\n\n  /**\n   * Makes the next `initialize` wait until {@link completeInitialization} or\n   * {@link failInitialization} is called, or until the client's timeout elapses.\n   */\n  holdInitialization(): void;\n\n  /**\n   * Delivers the stored values to a held `initialize`, so it completes with the client ready. When\n   * a hold is armed but no `initialize` has started, it disarms the hold instead.\n   */\n  completeInitialization(): void;\n\n  /**\n   * Fails a held `initialize` with an unrecoverable connection error, or arms the next `initialize`\n   * to fail. `initialize` completes promptly with the client not ready and `connectionError` fires.\n   */\n  failInitialization(): void;\n\n  /**\n   * Makes the next `updateContext` wait until {@link completeContextUpdate} or\n   * {@link failContextUpdate} is called, or until the client's timeout elapses.\n   */\n  holdContextUpdate(): void;\n\n  /**\n   * Delivers the stored values to a held `updateContext`, or disarms an armed hold that no\n   * `updateContext` has picked up.\n   */\n  completeContextUpdate(): void;\n\n  /**\n   * Fails a held `updateContext` with an unrecoverable connection error, or arms the next\n   * `updateContext` to fail.\n   */\n  failContextUpdate(): void;\n\n  /**\n   * The context of every `initialize` and `updateContext` call, in call order. `initialize` without\n   * a context records an empty context, and so does a call whose context has an invalid kind, since\n   * the client connects without it. Resumes are not recorded.\n   */\n  readonly contextUpdates: ConfigDirectorContext[];\n}\n\nclass InMemoryTestClient implements TestClient {\n  constructor(\n    public readonly client: ConfigDirectorClient,\n    private readonly connection: InMemoryConnection,\n  ) {}\n\n  public setValue(key: string, value: TestValue) {\n    this.connection.setValue(key, value);\n  }\n\n  public removeValue(key: string) {\n    this.connection.removeValue(key);\n  }\n\n  public replaceValues(values: TestValues) {\n    this.connection.replaceValues(values);\n  }\n\n  public holdInitialization() {\n    this.connection.hold(\"initialize\");\n  }\n\n  public completeInitialization() {\n    this.connection.complete(\"initialize\");\n  }\n\n  public failInitialization() {\n    this.connection.fail(\"initialize\");\n  }\n\n  public holdContextUpdate() {\n    this.connection.hold(\"updateContext\");\n  }\n\n  public completeContextUpdate() {\n    this.connection.complete(\"updateContext\");\n  }\n\n  public failContextUpdate() {\n    this.connection.fail(\"updateContext\");\n  }\n\n  public get contextUpdates(): ConfigDirectorContext[] {\n    return this.connection.contextUpdates;\n  }\n}\n\nexport const createTestClient = (sdkOptions: IdentifyingSdkOptions, options?: TestClientOptions): TestClient => {\n  const logger = options?.logger ?? createDefaultLogger();\n  const connection = new InMemoryConnection(logger, options?.values ?? {});\n  const client = new DefaultConfigDirectorClient(\n    () => discardingTelemetryClient,\n    TEST_CLIENT_SDK_KEY,\n    sdkOptions,\n    { logger, connection: { timeout: options?.timeout } },\n    { transport: connection },\n  );\n  return new InMemoryTestClient(client, connection);\n};\n","import { INSTALLED_TEST_CLIENT_SLOT, type InstalledTestClientSlot } from \"../installedTestClient\";\nimport type { TestClient } from \"./TestClient\";\n\n/**\n * Makes every `ConfigDirectorProvider` mounted without a `client` prop, and every client\n * `withProvider` would build, use `testClient.client` instead of building a client, until the\n * returned function uninstalls it. Construction props such as `sdkKey` are ignored while installed;\n * `context` and `hooks` apply to the installed client as they do for a `client` prop. A provider\n * reads the installed client when it is constructed, so install before rendering.\n *\n * Installing again replaces the installed test client. Each uninstall function restores the test\n * client that was installed when it was created, so nested installs are uninstalled in reverse order.\n *\n * @param testClient The test client whose `client` providers should use\n * @returns A function that uninstalls it\n *\n * @example\n * let uninstallTestClient: () => void;\n * beforeEach(() => {\n *   testClient = createTestClient({ values: { \"new-checkout\": true } });\n *   uninstallTestClient = installTestClient(testClient);\n * });\n * afterEach(() => uninstallTestClient());\n */\nexport const installTestClient = (testClient: TestClient): (() => void) => {\n  const slot = globalThis as InstalledTestClientSlot;\n  const previous = slot[INSTALLED_TEST_CLIENT_SLOT];\n  slot[INSTALLED_TEST_CLIENT_SLOT] = testClient.client;\n  return () => {\n    slot[INSTALLED_TEST_CLIENT_SLOT] = previous;\n  };\n};\n","\"use client\";\n\nimport { createTestClient as createCoreTestClient } from \"@js-client-core/testing/index\";\nimport type { TestClient, TestClientOptions } from \"@js-client-core/testing/index\";\n\nexport { installTestClient } from \"@js-client-core/testing/index\";\nexport type { TestClient, TestClientOptions, TestValue, TestValues, TestJsonValue } from \"@js-client-core/testing/index\";\nexport { ConfigDirectorConnectionError, ConfigDirectorValidationError } from \"@shared/errors\";\n\n/**\n * Creates a {@link TestClient}: a real browser `ConfigDirectorClient` connected to an in-memory\n * server that the test controls. No network connection is opened and no telemetry is sent. Render\n * the client `ConfigDirectorProvider` with `client={testClient.client}`, or install it with\n * `installTestClient` for components that render their own provider.\n *\n * @param options {@link TestClientOptions}: the initial values, the client's timeout, and its logger\n * @returns A {@link TestClient} whose `client` is passed to the code under test\n *\n * @example\n * import { createTestClient } from \"@configdirector/nextjs-sdk/client/testing\";\n *\n * const testClient = createTestClient({ values: { \"new-checkout\": true } });\n * render(\n *   <ConfigDirectorProvider client={testClient.client}>\n *     <Checkout />\n *   </ConfigDirectorProvider>,\n * );\n * act(() => testClient.setValue(\"new-checkout\", false));\n */\nexport const createTestClient = (options?: TestClientOptions): TestClient => {\n  return createCoreTestClient({ sdkName: \"nextjs-sdk\", sdkVersion: \"__VERSION__\" }, options);\n};\n"],"mappings":"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"}
+{"version":3,"file":"testing.mjs","names":["createTestClient"],"sources":["../../../shared/src/telemetry/RecordedTrackedEvents.ts","../../../js-client-core/src/testing/InMemoryConnection.ts","../../../js-client-core/src/testing/TestClient.ts","../../../js-client-core/src/testing/installTestClient.ts","../../src/client/testing.ts"],"sourcesContent":["import type { ConfigDirectorContext, ConfigDirectorLogger, TrackedEvent } from \"../types\";\nimport { trackedEventWarningMessages } from \"./tracked-events\";\nimport type { TrackedEventAdmission, TrackedEventEntry } from \"./tracked-events\";\n\nconst recordedEventOf = (entry: TrackedEventEntry, context: ConfigDirectorContext | undefined): TrackedEvent => ({\n  name: entry.name,\n  ...(context === undefined ? {} : { context }),\n  ...(entry.value === undefined ? {} : { value: entry.value }),\n  ...(entry.details === undefined ? {} : { details: entry.details }),\n});\n\nexport class RecordedTrackedEvents {\n  public readonly events: TrackedEvent[] = [];\n\n  constructor(private readonly logger: ConfigDirectorLogger) {}\n\n  public record(admission: TrackedEventAdmission, context: ConfigDirectorContext | undefined): void {\n    admission.warnings.forEach((warning) => this.logger.warn(trackedEventWarningMessages[warning]));\n    switch (admission.outcome) {\n      case \"dropped\":\n        return;\n      case \"admitted\":\n        this.events.push(recordedEventOf(admission.entry, context));\n        return;\n    }\n  }\n}\n","import type {\n  ClientConnectAction,\n  ConfigDirectorContext,\n  ConfigDirectorLogger,\n  ConfigSet,\n  ConfigState,\n  Transport,\n  TransportEvents,\n} from \"../types\";\nimport { Emitter } from \"../Emitter\";\nimport { ConfigDirectorConnectionError } from \"../errors\";\nimport type { TestValue, TestValues } from \"./values\";\nimport { nativeValueConfigState } from \"../native-values\";\n\ntype ControlledAttempt = \"initialize\" | \"updateContext\";\n\ntype Armed = \"nothing\" | \"hold\" | \"failure\";\n\ntype PendingHold = {\n  attempt: ControlledAttempt;\n  end: () => void;\n  complete: () => void;\n  fail: () => void;\n};\n\nconst TEST_ENVIRONMENT = { environmentId: \"test-environment\", projectId: \"test-project\" };\n\nconst controlledAttemptFor = (reason: ClientConnectAction): ControlledAttempt | undefined => {\n  switch (reason) {\n    case \"initialization\":\n      return \"initialize\";\n    case \"context update\":\n      return \"updateContext\";\n    default:\n      return undefined;\n  }\n};\n\nexport class InMemoryConnection implements Transport {\n  private readonly emitter = new Emitter<TransportEvents>();\n  private readonly configs = new Map<string, ConfigState>();\n  private readonly recordedContexts: ConfigDirectorContext[] = [];\n  private readonly pendingDeliveries: ConfigSet[] = [];\n  private readonly armed: Record<ControlledAttempt, Armed> = { initialize: \"nothing\", updateContext: \"nothing\" };\n  private pendingHold: PendingHold | undefined;\n  private connected = false;\n  private delivering = false;\n  private revision = 0;\n  private attemptGeneration = 0;\n\n  constructor(\n    private readonly logger: ConfigDirectorLogger,\n    values: TestValues,\n  ) {\n    this.store(values);\n  }\n\n  public get contextUpdates(): ConfigDirectorContext[] {\n    return [...this.recordedContexts];\n  }\n\n  public setValue(key: string, value: TestValue) {\n    const configState = this.encode(key, value);\n    this.configs.set(key, configState);\n    this.deliverIfConnected({ ...TEST_ENVIRONMENT, kind: \"delta\", configs: { [key]: configState } });\n  }\n\n  public removeValue(key: string) {\n    this.configs.delete(key);\n    this.deliverIfConnected(this.fullUpdate());\n  }\n\n  public replaceValues(values: TestValues) {\n    const encoded = this.encodeAll(values);\n    this.configs.clear();\n    encoded.forEach((configState, key) => this.configs.set(key, configState));\n    this.armed.initialize = \"nothing\";\n    this.armed.updateContext = \"nothing\";\n    this.deliverIfConnected(this.fullUpdate());\n  }\n\n  public hold(attempt: ControlledAttempt) {\n    this.armed[attempt] = \"hold\";\n  }\n\n  public complete(attempt: ControlledAttempt) {\n    if (this.pendingHold?.attempt === attempt) {\n      this.pendingHold.complete();\n    } else if (this.armed[attempt] === \"hold\") {\n      this.armed[attempt] = \"nothing\";\n    }\n  }\n\n  public fail(attempt: ControlledAttempt) {\n    if (this.pendingHold?.attempt === attempt) {\n      this.pendingHold.fail();\n    } else {\n      this.armed[attempt] = \"failure\";\n    }\n  }\n\n  public connect(context: ConfigDirectorContext, timeout: number, reason: ClientConnectAction): Promise<this> {\n    this.endAttempt();\n    const attempt = controlledAttemptFor(reason);\n    if (!attempt) {\n      return this.connectNow();\n    }\n    this.recordedContexts.push(context);\n    const armed = this.armed[attempt];\n    this.armed[attempt] = \"nothing\";\n    switch (armed) {\n      case \"failure\":\n        return this.failNow(reason);\n      case \"hold\":\n        return this.holdNow(attempt, reason, timeout);\n      default:\n        return this.connectNow();\n    }\n  }\n\n  public on: Transport[\"on\"] = (name, handler) => this.emitter.on(name, handler);\n\n  public off: Transport[\"off\"] = (name, handler) => this.emitter.off(name, handler);\n\n  public clear() {\n    this.emitter.clear();\n  }\n\n  public close() {\n    this.endAttempt();\n  }\n\n  public dispose() {\n    this.close();\n    this.clear();\n  }\n\n  private endAttempt() {\n    this.attemptGeneration++;\n    this.connected = false;\n    this.pendingHold?.end();\n  }\n\n  private connectNow(): Promise<this> {\n    const connected = Promise.resolve(this);\n    this.scheduleFirstDelivery();\n    return connected;\n  }\n\n  private holdNow(attempt: ControlledAttempt, reason: ClientConnectAction, timeout: number): Promise<this> {\n    return new Promise<this>((resolve, reject) => {\n      const timer = setTimeout(() => this.pendingHold?.end(), timeout);\n      const release = () => {\n        clearTimeout(timer);\n        this.pendingHold = undefined;\n      };\n      this.pendingHold = {\n        attempt,\n        end: () => {\n          release();\n          resolve(this);\n        },\n        complete: () => {\n          release();\n          resolve(this);\n          this.scheduleFirstDelivery();\n        },\n        fail: () => {\n          release();\n          const error = this.fatalError(reason);\n          this.emitter.emit(\"connectionError\", error);\n          reject(error);\n        },\n      };\n    });\n  }\n\n  private failNow(reason: ClientConnectAction): Promise<this> {\n    const error = this.fatalError(reason);\n    this.emitter.emit(\"connectionError\", error);\n    return Promise.reject(error);\n  }\n\n  private fatalError(reason: ClientConnectAction) {\n    return new ConfigDirectorConnectionError(\n      `Connection failed with status: 401. Error: the test client failed this ${reason}. This is an unrecoverable error, will not attempt to reconnect.`,\n      401,\n    );\n  }\n\n  private scheduleFirstDelivery() {\n    const generation = this.attemptGeneration;\n    void Promise.resolve()\n      .then(() => {})\n      .then(() => {\n        if (generation !== this.attemptGeneration) {\n          return;\n        }\n        this.connected = true;\n        this.deliver(this.fullUpdate());\n      });\n  }\n\n  private deliverIfConnected(configSet: ConfigSet) {\n    if (this.connected) {\n      this.deliver(configSet);\n    }\n  }\n\n  private deliver(configSet: ConfigSet) {\n    this.pendingDeliveries.push(configSet);\n    if (this.delivering) {\n      return;\n    }\n    this.delivering = true;\n    try {\n      let next = this.pendingDeliveries.shift();\n      while (next) {\n        this.emitCaught(next);\n        next = this.pendingDeliveries.shift();\n      }\n    } finally {\n      this.delivering = false;\n    }\n  }\n\n  private emitCaught(configSet: ConfigSet) {\n    try {\n      this.emitter.emit(\"configSetReceived\", configSet);\n    } catch (error) {\n      this.logger.error(\"[InMemoryConnection] Error dispatching a config update from the test client: \", error);\n    }\n  }\n\n  private fullUpdate(): ConfigSet {\n    return { ...TEST_ENVIRONMENT, kind: \"full\", configs: Object.fromEntries(this.configs) };\n  }\n\n  private store(values: TestValues) {\n    this.encodeAll(values).forEach((configState, key) => this.configs.set(key, configState));\n  }\n\n  private encodeAll(values: TestValues): Map<string, ConfigState> {\n    const encoded = new Map<string, ConfigState>();\n    for (const [key, value] of Object.entries(values)) {\n      encoded.set(key, this.encode(key, value));\n    }\n    return encoded;\n  }\n\n  private encode(key: string, value: TestValue): ConfigState {\n    return nativeValueConfigState(`test-config:${key}`, key, value, `test-value:${key}:${++this.revision}`);\n  }\n}\n","import { DefaultConfigDirectorClient } from \"../DefaultConfigDirectorClient\";\nimport { createDefaultLogger } from \"../logger\";\nimport type {\n  ConfigDirectorClient,\n  ConfigDirectorContext,\n  ConfigDirectorLogger,\n  IdentifyingSdkOptions,\n  TrackedEvent,\n} from \"../types\";\nimport { RecordedTrackedEvents } from \"@shared/telemetry/RecordedTrackedEvents\";\nimport { discardingTelemetryClient } from \"../telemetry/discarding\";\nimport { InMemoryConnection } from \"./InMemoryConnection\";\nimport type { TestValue, TestValues } from \"./values\";\n\nconst TEST_CLIENT_SDK_KEY = \"test-client\";\n\n/**\n * Options for {@link createTestClient}. Every option is optional.\n */\nexport type TestClientOptions = {\n  /**\n   * The config values the test client serves once its client connects, keyed by config key. The\n   * config type follows from each value: a boolean, an integral number (`integer`), any other\n   * number (`float`), a string, or a plain object or array (`json`).\n   */\n  values?: TestValues;\n  /**\n   * The connection timeout of the SDK client, in milliseconds. It bounds how long a held\n   * `initialize` or `updateContext` waits. Defaults to the SDK's production timeout.\n   */\n  timeout?: number;\n  /**\n   * The logger the SDK client uses. Defaults to the SDK's console logger at `warn` level. Since the\n   * test client sends no telemetry, every tracked event that is not recorded as it was tracked logs\n   * a warning, rather than each cause once per telemetry batch.\n   */\n  logger?: ConfigDirectorLogger;\n};\n\n/**\n * A real ConfigDirector client connected to an in-memory server that the test controls.\n *\n * The client under {@link TestClient.client} is the SDK's production client: value parsing, watchers,\n * events, and readiness behave as they do against ConfigDirector. Only the network connection and\n * telemetry are replaced, so no request is ever made and nothing is left running after the client is\n * disposed.\n */\nexport interface TestClient {\n  /**\n   * The SDK client to hand to the code under test. It starts uninitialized, like a production\n   * client; `initialize` completes at once with the seeded values unless initialization is held.\n   */\n  readonly client: ConfigDirectorClient;\n\n  /**\n   * Stores `value` under `key` and, when the client is connected, delivers it as an update, so\n   * reads, watchers, and `configsUpdated` handlers see it.\n   */\n  setValue(key: string, value: TestValue): void;\n\n  /**\n   * Removes `key` and, when the client is connected, delivers a full update without it, so reads\n   * fall back to the in-code default value and watchers of `key` receive that default.\n   */\n  removeValue(key: string): void;\n\n  /**\n   * Replaces every stored value with `values`, disarms any armed hold or failure, and, when the\n   * client is connected, delivers the new values as a full update.\n   */\n  replaceValues(values: TestValues): void;\n\n  /**\n   * Makes the next `initialize` wait until {@link completeInitialization} or\n   * {@link failInitialization} is called, or until the client's timeout elapses.\n   */\n  holdInitialization(): void;\n\n  /**\n   * Delivers the stored values to a held `initialize`, so it completes with the client ready. When\n   * a hold is armed but no `initialize` has started, it disarms the hold instead.\n   */\n  completeInitialization(): void;\n\n  /**\n   * Fails a held `initialize` with an unrecoverable connection error, or arms the next `initialize`\n   * to fail. `initialize` completes promptly with the client not ready and `connectionError` fires.\n   */\n  failInitialization(): void;\n\n  /**\n   * Makes the next `updateContext` wait until {@link completeContextUpdate} or\n   * {@link failContextUpdate} is called, or until the client's timeout elapses.\n   */\n  holdContextUpdate(): void;\n\n  /**\n   * Delivers the stored values to a held `updateContext`, or disarms an armed hold that no\n   * `updateContext` has picked up.\n   */\n  completeContextUpdate(): void;\n\n  /**\n   * Fails a held `updateContext` with an unrecoverable connection error, or arms the next\n   * `updateContext` to fail.\n   */\n  failContextUpdate(): void;\n\n  /**\n   * The context of every `initialize` and `updateContext` call, in call order. `initialize` without\n   * a context records an empty context, and so does a call whose context has an invalid kind, since\n   * the client connects without it. Resumes are not recorded.\n   */\n  readonly contextUpdates: ConfigDirectorContext[];\n\n  /**\n   * Every event the code under test tracked through the client, in call order, with the context\n   * the client had at that moment, as the SDK would report it: an event whose name does not have\n   * 1 to 150 characters is not recorded, and a value or details the SDK would leave out are missing\n   * from the record. The limit of 1,000 events per telemetry batch does not apply.\n   */\n  readonly trackedEvents: TrackedEvent[];\n}\n\nclass InMemoryTestClient implements TestClient {\n  constructor(\n    public readonly client: ConfigDirectorClient,\n    private readonly connection: InMemoryConnection,\n    public readonly trackedEvents: TrackedEvent[],\n  ) {}\n\n  public setValue(key: string, value: TestValue) {\n    this.connection.setValue(key, value);\n  }\n\n  public removeValue(key: string) {\n    this.connection.removeValue(key);\n  }\n\n  public replaceValues(values: TestValues) {\n    this.connection.replaceValues(values);\n  }\n\n  public holdInitialization() {\n    this.connection.hold(\"initialize\");\n  }\n\n  public completeInitialization() {\n    this.connection.complete(\"initialize\");\n  }\n\n  public failInitialization() {\n    this.connection.fail(\"initialize\");\n  }\n\n  public holdContextUpdate() {\n    this.connection.hold(\"updateContext\");\n  }\n\n  public completeContextUpdate() {\n    this.connection.complete(\"updateContext\");\n  }\n\n  public failContextUpdate() {\n    this.connection.fail(\"updateContext\");\n  }\n\n  public get contextUpdates(): ConfigDirectorContext[] {\n    return this.connection.contextUpdates;\n  }\n}\n\nexport const createTestClient = (sdkOptions: IdentifyingSdkOptions, options?: TestClientOptions): TestClient => {\n  const logger = options?.logger ?? createDefaultLogger();\n  const connection = new InMemoryConnection(logger, options?.values ?? {});\n  const recordedTrackedEvents = new RecordedTrackedEvents(logger);\n  const client = new DefaultConfigDirectorClient(\n    () => ({\n      ...discardingTelemetryClient,\n      trackedEvent: (admission, context) => recordedTrackedEvents.record(admission, context),\n    }),\n    TEST_CLIENT_SDK_KEY,\n    sdkOptions,\n    { logger, connection: { timeout: options?.timeout } },\n    { transport: connection },\n  );\n  return new InMemoryTestClient(client, connection, recordedTrackedEvents.events);\n};\n","import { INSTALLED_TEST_CLIENT_SLOT, type InstalledTestClientSlot } from \"../installedTestClient\";\nimport type { TestClient } from \"./TestClient\";\n\n/**\n * Makes every `ConfigDirectorProvider` mounted without a `client` prop, and every client\n * `withProvider` would build, use `testClient.client` instead of building a client, until the\n * returned function uninstalls it. Construction props such as `sdkKey` are ignored while installed;\n * `context` and `hooks` apply to the installed client as they do for a `client` prop. A provider\n * reads the installed client when it is constructed, so install before rendering.\n *\n * Installing again replaces the installed test client. Each uninstall function restores the test\n * client that was installed when it was created, so nested installs are uninstalled in reverse order.\n *\n * @param testClient The test client whose `client` providers should use\n * @returns A function that uninstalls it\n *\n * @example\n * let uninstallTestClient: () => void;\n * beforeEach(() => {\n *   testClient = createTestClient({ values: { \"new-checkout\": true } });\n *   uninstallTestClient = installTestClient(testClient);\n * });\n * afterEach(() => uninstallTestClient());\n */\nexport const installTestClient = (testClient: TestClient): (() => void) => {\n  const slot = globalThis as InstalledTestClientSlot;\n  const previous = slot[INSTALLED_TEST_CLIENT_SLOT];\n  slot[INSTALLED_TEST_CLIENT_SLOT] = testClient.client;\n  return () => {\n    slot[INSTALLED_TEST_CLIENT_SLOT] = previous;\n  };\n};\n","\"use client\";\n\nimport { createTestClient as createCoreTestClient } from \"@js-client-core/testing/index\";\nimport type { TestClient, TestClientOptions } from \"@js-client-core/testing/index\";\n\nexport { installTestClient } from \"@js-client-core/testing/index\";\nexport type { TestClient, TestClientOptions, TestValue, TestValues, TestJsonValue } from \"@js-client-core/testing/index\";\nexport type { TrackedEvent, TrackedEventDetails, TrackedEventDetailValue } from \"@shared/types\";\nexport { ConfigDirectorConnectionError, ConfigDirectorValidationError } from \"@shared/errors\";\n\n/**\n * Creates a {@link TestClient}: a real browser `ConfigDirectorClient` connected to an in-memory\n * server that the test controls. No network connection is opened and no telemetry is sent. Render\n * the client `ConfigDirectorProvider` with `client={testClient.client}`, or install it with\n * `installTestClient` for components that render their own provider.\n *\n * @param options {@link TestClientOptions}: the initial values, the client's timeout, and its logger\n * @returns A {@link TestClient} whose `client` is passed to the code under test\n *\n * @example\n * import { createTestClient } from \"@configdirector/nextjs-sdk/client/testing\";\n *\n * const testClient = createTestClient({ values: { \"new-checkout\": true } });\n * render(\n *   <ConfigDirectorProvider client={testClient.client}>\n *     <Checkout />\n *   </ConfigDirectorProvider>,\n * );\n * act(() => testClient.setValue(\"new-checkout\", false));\n */\nexport const createTestClient = (options?: TestClientOptions): TestClient => {\n  return createCoreTestClient({ sdkName: \"nextjs-sdk\", sdkVersion: \"__VERSION__\" }, options);\n};\n"],"mappings":";mIAIA,MAAM,GAAmB,EAA0B,IAAA,EAAA,EAAA,EAAA,CACjD,KAAM,EAAM,KAAA,CACR,IAAY,IAAA,GAAY,EAAE,CAAG,CAAE,UAAS,CAAA,CACxC,EAAM,QAAU,IAAA,GAAY,EAAE,CAAG,CAAE,MAAO,EAAM,MAAO,CAAA,CACvD,EAAM,UAAY,IAAA,GAAY,EAAE,CAAG,CAAE,QAAS,EAAM,QAAS,CAClE,CAED,IAAa,EAAb,KAAmC,CAGjC,YAAY,EAA+C,CAA9B,KAAA,OAAA,EAF7B,KAAgB,OAAyB,EAAE,CAI3C,OAAc,EAAkC,EAAkD,CAEhG,OADA,EAAU,SAAS,QAAS,GAAY,KAAK,OAAO,KAAK,EAA4B,GAAS,CAAC,CACvF,EAAU,QAAlB,CACE,IAAK,UACH,OACF,IAAK,WACH,KAAK,OAAO,KAAK,EAAgB,EAAU,MAAO,EAAQ,CAAC,CAC3D,UCER,MAAM,EAAmB,CAAE,cAAe,mBAAoB,UAAW,eAAgB,CAEnF,EAAwB,GAA+D,CAC3F,OAAQ,EAAR,CACE,IAAK,iBACH,MAAO,aACT,IAAK,iBACH,MAAO,gBACT,QACE,SAIN,IAAa,EAAb,KAAqD,CAYnD,YACE,EACA,EACA,CAFiB,KAAA,OAAA,EAZnB,KAAiB,QAAU,IAAI,EAC/B,KAAiB,QAAU,IAAI,IAC/B,KAAiB,iBAA4C,EAAE,CAC/D,KAAiB,kBAAiC,EAAE,CACpD,KAAiB,MAA0C,CAAE,WAAY,UAAW,cAAe,UAAW,CAE9G,KAAQ,UAAY,GACpB,KAAQ,WAAa,GACrB,KAAQ,SAAW,EACnB,KAAQ,kBAAoB,EAwE5B,KAAO,IAAuB,EAAM,IAAY,KAAK,QAAQ,GAAG,EAAM,EAAQ,CAE9E,KAAO,KAAyB,EAAM,IAAY,KAAK,QAAQ,IAAI,EAAM,EAAQ,CApE/E,KAAK,MAAM,EAAO,CAGpB,IAAW,gBAA0C,CACnD,MAAO,CAAC,GAAG,KAAK,iBAAiB,CAGnC,SAAgB,EAAa,EAAkB,CAC7C,IAAM,EAAc,KAAK,OAAO,EAAK,EAAM,CAC3C,KAAK,QAAQ,IAAI,EAAK,EAAY,CAClC,KAAK,mBAAA,EAAA,EAAA,EAAA,CAAwB,EAAA,CAAA,EAAA,CAAA,CAAkB,KAAM,QAAS,QAAS,EAAG,GAAM,EAAa,EAAE,CAAC,CAGlG,YAAmB,EAAa,CAC9B,KAAK,QAAQ,OAAO,EAAI,CACxB,KAAK,mBAAmB,KAAK,YAAY,CAAC,CAG5C,cAAqB,EAAoB,CACvC,IAAM,EAAU,KAAK,UAAU,EAAO,CACtC,KAAK,QAAQ,OAAO,CACpB,EAAQ,SAAS,EAAa,IAAQ,KAAK,QAAQ,IAAI,EAAK,EAAY,CAAC,CACzE,KAAK,MAAM,WAAa,UACxB,KAAK,MAAM,cAAgB,UAC3B,KAAK,mBAAmB,KAAK,YAAY,CAAC,CAG5C,KAAY,EAA4B,CACtC,KAAK,MAAM,GAAW,OAGxB,SAAgB,EAA4B,SAC1C,EAAI,KAAK,cAAA,KAAA,IAAA,GAAA,EAAa,WAAY,EAChC,KAAK,YAAY,UAAU,CAClB,KAAK,MAAM,KAAa,SACjC,KAAK,MAAM,GAAW,WAI1B,KAAY,EAA4B,SACtC,EAAI,KAAK,cAAA,KAAA,IAAA,GAAA,EAAa,WAAY,EAChC,KAAK,YAAY,MAAM,CAEvB,KAAK,MAAM,GAAW,UAI1B,QAAe,EAAgC,EAAiB,EAA4C,CAC1G,KAAK,YAAY,CACjB,IAAM,EAAU,EAAqB,EAAO,CAC5C,GAAI,CAAC,EACH,OAAO,KAAK,YAAY,CAE1B,KAAK,iBAAiB,KAAK,EAAQ,CACnC,IAAM,EAAQ,KAAK,MAAM,GAEzB,OADA,KAAK,MAAM,GAAW,UACd,EAAR,CACE,IAAK,UACH,OAAO,KAAK,QAAQ,EAAO,CAC7B,IAAK,OACH,OAAO,KAAK,QAAQ,EAAS,EAAQ,EAAQ,CAC/C,QACE,OAAO,KAAK,YAAY,EAQ9B,OAAe,CACb,KAAK,QAAQ,OAAO,CAGtB,OAAe,CACb,KAAK,YAAY,CAGnB,SAAiB,CACf,KAAK,OAAO,CACZ,KAAK,OAAO,CAGd,YAAqB,OACnB,KAAK,oBACL,KAAK,UAAY,IACjB,EAAA,KAAK,cAAA,MAAA,EAAa,KAAK,CAGzB,YAAoC,CAClC,IAAM,EAAY,QAAQ,QAAQ,KAAK,CAEvC,OADA,KAAK,uBAAuB,CACrB,EAGT,QAAgB,EAA4B,EAA6B,EAAgC,CACvG,OAAO,IAAI,SAAe,EAAS,IAAW,CAC5C,IAAM,EAAQ,eAAiB,qBAAK,cAAA,KAAA,IAAA,GAAA,EAAa,KAAK,EAAE,EAAQ,CAC1D,MAAgB,CACpB,aAAa,EAAM,CACnB,KAAK,YAAc,IAAA,IAErB,KAAK,YAAc,CACjB,UACA,QAAW,CACT,GAAS,CACT,EAAQ,KAAK,EAEf,aAAgB,CACd,GAAS,CACT,EAAQ,KAAK,CACb,KAAK,uBAAuB,EAE9B,SAAY,CACV,GAAS,CACT,IAAM,EAAQ,KAAK,WAAW,EAAO,CACrC,KAAK,QAAQ,KAAK,kBAAmB,EAAM,CAC3C,EAAO,EAAM,EAEhB,EACD,CAGJ,QAAgB,EAA4C,CAC1D,IAAM,EAAQ,KAAK,WAAW,EAAO,CAErC,OADA,KAAK,QAAQ,KAAK,kBAAmB,EAAM,CACpC,QAAQ,OAAO,EAAM,CAG9B,WAAmB,EAA6B,CAC9C,OAAO,IAAI,EACT,0EAA0E,EAAO,kEACjF,IACD,CAGH,uBAAgC,CAC9B,IAAM,EAAa,KAAK,kBACnB,QAAQ,SAAS,CACnB,SAAW,GAAG,CACd,SAAW,CACN,IAAe,KAAK,oBAGxB,KAAK,UAAY,GACjB,KAAK,QAAQ,KAAK,YAAY,CAAC,GAC/B,CAGN,mBAA2B,EAAsB,CAC3C,KAAK,WACP,KAAK,QAAQ,EAAU,CAI3B,QAAgB,EAAsB,CACpC,QAAK,kBAAkB,KAAK,EAAU,CAClC,MAAK,WAGT,MAAK,WAAa,GAClB,GAAI,CACF,IAAI,EAAO,KAAK,kBAAkB,OAAO,CACzC,KAAO,GACL,KAAK,WAAW,EAAK,CACrB,EAAO,KAAK,kBAAkB,OAAO,QAE/B,CACR,KAAK,WAAa,KAItB,WAAmB,EAAsB,CACvC,GAAI,CACF,KAAK,QAAQ,KAAK,oBAAqB,EAAU,OAC1C,EAAO,CACd,KAAK,OAAO,MAAM,gFAAiF,EAAM,EAI7G,YAAgC,CAC9B,OAAA,EAAA,EAAA,EAAA,CAAY,EAAA,CAAA,EAAA,CAAA,CAAkB,KAAM,OAAQ,QAAS,OAAO,YAAY,KAAK,QAAQ,EAAE,CAGzF,MAAc,EAAoB,CAChC,KAAK,UAAU,EAAO,CAAC,SAAS,EAAa,IAAQ,KAAK,QAAQ,IAAI,EAAK,EAAY,CAAC,CAG1F,UAAkB,EAA8C,CAC9D,IAAM,EAAU,IAAI,IACpB,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,EAAO,CAC/C,EAAQ,IAAI,EAAK,KAAK,OAAO,EAAK,EAAM,CAAC,CAE3C,OAAO,EAGT,OAAe,EAAa,EAA+B,CACzD,OAAO,EAAuB,eAAe,IAAO,EAAK,EAAO,cAAc,EAAI,GAAG,EAAE,KAAK,WAAW,GC/HrG,EAAN,KAA+C,CAC7C,YACE,EACA,EACA,EACA,CAHgB,KAAA,OAAA,EACC,KAAA,WAAA,EACD,KAAA,cAAA,EAGlB,SAAgB,EAAa,EAAkB,CAC7C,KAAK,WAAW,SAAS,EAAK,EAAM,CAGtC,YAAmB,EAAa,CAC9B,KAAK,WAAW,YAAY,EAAI,CAGlC,cAAqB,EAAoB,CACvC,KAAK,WAAW,cAAc,EAAO,CAGvC,oBAA4B,CAC1B,KAAK,WAAW,KAAK,aAAa,CAGpC,wBAAgC,CAC9B,KAAK,WAAW,SAAS,aAAa,CAGxC,oBAA4B,CAC1B,KAAK,WAAW,KAAK,aAAa,CAGpC,mBAA2B,CACzB,KAAK,WAAW,KAAK,gBAAgB,CAGvC,uBAA+B,CAC7B,KAAK,WAAW,SAAS,gBAAgB,CAG3C,mBAA2B,CACzB,KAAK,WAAW,KAAK,gBAAgB,CAGvC,IAAW,gBAA0C,CACnD,OAAO,KAAK,WAAW,iBAI3B,MAAaA,GAAoB,EAAmC,IAA4C,SAC9G,IAAM,GAAA,EAAA,GAAA,KAAA,IAAA,GAAS,EAAS,SAAA,KAAU,GAAqB,CAA/B,EAClB,EAAa,IAAI,EAAmB,GAAA,EAAA,GAAA,KAAA,IAAA,GAAQ,EAAS,SAAA,KAAU,EAAE,CAAZ,EAAa,CAClE,EAAwB,IAAI,EAAsB,EAAO,CAW/D,OAAO,IAAI,EAVI,IAAI,MAAA,EAAA,EAAA,EAAA,CAEZ,EAAA,CAAA,EAAA,CAAA,CACH,cAAe,EAAW,IAAY,EAAsB,OAAO,EAAW,EAAQ,CAAA,CACvF,CACD,cACA,EACA,CAAE,SAAQ,WAAY,CAAE,QAAA,GAAA,KAAA,IAAA,GAAS,EAAS,QAAS,CAAE,CACrD,CAAE,UAAW,EAAY,CAC1B,CACqC,EAAY,EAAsB,OAAO,EClKpE,EAAqB,GAAyC,CACzE,IAAM,EAAO,WACP,EAAW,EAAK,GAEtB,MADA,GAAK,GAA8B,EAAW,WACjC,CACX,EAAK,GAA8B,ICC1B,EAAoB,GACxB,EAAqB,CAAE,QAAS,aAAc,WAAY,SAAe,CAAE,EAAQ"}

package/dist/client/{types-CRVL6Yi2.d.cts → types-CdyMdj5l.d.mts}

@@ -22,6 +22,12 @@ type ConfigState = {
   type: ConfigType;
   value: string | undefined | null;
   valueId?: string | undefined | null;
+  variation?: {
+    id: string;
+    name?: string | undefined | null;
+  } | undefined | null;
+  ruleId?: string | undefined | null;
+  shareId?: string | undefined | null;
 };
 type ConfigDirectorLoggingLevel = "debug" | "info" | "warn" | "error" | "off";
 interface ConfigDirectorLogger {
@@ -32,24 +38,72 @@ interface ConfigDirectorLogger {
 }
 /**
  * Why an evaluation returned the value it did. `found-match` returns a value from ConfigDirector,
- * and `cached` a value kept on the device while a client SDK waits for live values. `value-missing`
+ * and `cached` a value kept on the device while a client SDK waits for live values.
+ * `rollout-skipped-no-identifier` returns the default targeting rule value: a server SDK skipped a
+ * percentage rollout because the context has no `id` to place it in a share. `value-missing`
  * returns the in-code default value because the config has no value. Every other reason returns the
  * in-code default value because of an error: the config does not exist (`config-state-missing`), no
  * values have arrived yet (`client-not-ready`), or the value cannot be read as the type of the in-code
  * default value.
  */
-type EvaluationReason = "found-match" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean" | "cached";
+type EvaluationReason = "found-match" | "rollout-skipped-no-identifier" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean" | "cached";
+/**
+ * One of the values a config can serve, such as the control or a treatment of an experiment.
+ */
+type Variation = {
+  /** The ID ConfigDirector assigned to the variation, which stays the same when it is renamed. */id: string; /** The variation's name, when it has one. */
+  name?: string;
+};
 /**
  * One evaluation of a config: the value it returned, why, and the context it was evaluated for.
  */
 type ConfigEvaluation<T extends ConfigValueType = ConfigValueType> = {
   /** The config key that was evaluated. */key: string; /** The value returned, which is the in-code default value when {@link isDefaultValue} is `true`. */
   value: T; /** The ID ConfigDirector assigned to the value returned, when ConfigDirector sent one with it. */
-  valueId?: string; /** Whether the evaluation returned the in-code default value. */
+  valueId?: string;
+  /**
+   * The variation that was served. It is `undefined` when the config has no variations or the
+   * in-code default value is returned.
+   */
+  variation?: Variation; /** Whether the evaluation returned the in-code default value. */
   isDefaultValue: boolean; /** Why the evaluation returned this value. */
   reason: EvaluationReason; /** The context the config was evaluated for, if any. */
   context?: ConfigDirectorContext;
 };
+/**
+ * A value in the details of a tracked event: a string, a number, a boolean, or an array or object
+ * of such values.
+ */
+type TrackedEventDetailValue = string | number | boolean | TrackedEventDetailValue[] | {
+  [key: string]: TrackedEventDetailValue;
+};
+/**
+ * Details of a tracked event, such as the plan a customer chose. Details with more than 20
+ * top-level keys, or larger than 1 KB as JSON, are left out and the event is still reported.
+ */
+type TrackedEventDetails = {
+  [key: string]: TrackedEventDetailValue;
+};
+/**
+ * What a tracked event carries besides its name.
+ */
+type TrackOptions = {
+  /**
+   * A number the event measures, such as an amount of money, a count or a duration. A value that
+   * is not a finite number is left out and the event is still reported.
+   */
+  value?: number; /** Details of the event. */
+  details?: TrackedEventDetails;
+};
+/**
+ * An event the code under test tracked, as a test client recorded it.
+ */
+type TrackedEvent = {
+  /** The name the event was tracked with. */name: string; /** The context the event was tracked for, if any. */
+  context?: ConfigDirectorContext; /** The value the event was tracked with, when it is a finite number. */
+  value?: number; /** The details the event was tracked with, when they are within the limits. */
+  details?: TrackedEventDetails;
+};
 /**
  * The context to be sent to ConfigDirector: the user or other entity, such as a device or an
  * organization, that configs are evaluated for. This context will be used for targeting rules
@@ -227,8 +281,8 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
   getValue<T extends ConfigValueType>(configKey: string, defaultValue: T): T;
   /**
    * Evaluates a config as {@link getValue} does and returns the evaluation: the value, the reason it
-   * was served and its value ID. Like every read, it fires `configEvaluated` and is counted in
-   * telemetry.
+   * was served, its value ID and its variation. Like every read, it fires `configEvaluated` and is
+   * counted in telemetry.
    *
    * @returns The evaluation, whose `value` is what {@link getValue} returns
    * @param configKey The config key to evaluate
@@ -260,6 +314,20 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
    * Removes all subscribers from all config keys
    */
   unwatchAll(): void;
+  /**
+   * Reports to ConfigDirector that something happened for the current context, such as a completed
+   * checkout, so it can be counted. The event is sent with the next telemetry batch. `track` never
+   * throws, and does nothing in `offline` mode.
+   *
+   * An event counts for an experiment only when the current context has an `id`, the one the
+   * experiment's config was evaluated for. Before the client has a context, or for a context
+   * without an `id`, the event is still reported.
+   *
+   * @param eventName The name of the event, 1 to 150 characters. An event with any other name is
+   * not reported and a warning is logged.
+   * @param options The event's {@link TrackOptions.value} and {@link TrackOptions.details} (optional)
+   */
+  track(eventName: string, options?: TrackOptions): void;
   /**
    * Pauses the network connection without clearing event handlers, watch handlers, or config
    * state. Intended for mobile environments where the OS may kill background connections (e.g.
@@ -282,5 +350,5 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
   dispose(): void;
 }
 //#endregion
-export { NativeJsonValue as a, ConfigDirectorContext as c, ConfigEvaluation as d, ConfigState as f, EvaluationReason as h, OfflineValues as i, ConfigDirectorLogger as l, ConnectionMode as m, ConfigDirectorClient as n, NativeValue as o, ConfigValueType as p, OfflineValue as r, NativeValues as s, ClientHooks as t, ConfigDirectorLoggingLevel as u };
-//# sourceMappingURL=types-CRVL6Yi2.d.cts.map
+export { TrackedEvent as _, NativeJsonValue as a, Variation as b, ConfigDirectorContext as c, ConfigEvaluation as d, ConfigState as f, TrackOptions as g, EvaluationReason as h, OfflineValues as i, ConfigDirectorLogger as l, ConnectionMode as m, ConfigDirectorClient as n, NativeValue as o, ConfigValueType as p, OfflineValue as r, NativeValues as s, ClientHooks as t, ConfigDirectorLoggingLevel as u, TrackedEventDetailValue as v, TrackedEventDetails as y };
+//# sourceMappingURL=types-CdyMdj5l.d.mts.map

package/dist/client/types-CdyMdj5l.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-CdyMdj5l.d.mts","names":[],"sources":["../../../js-client-core/src/Emitter.ts","../../../shared/src/types.ts","../../../shared/src/native-values.ts","../../../js-client-core/src/types.ts"],"mappings":"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"}

package/dist/client/{types-B4kvU3bh.d.mts → types-P8frfCGH.d.cts}

@@ -22,6 +22,12 @@ type ConfigState = {
   type: ConfigType;
   value: string | undefined | null;
   valueId?: string | undefined | null;
+  variation?: {
+    id: string;
+    name?: string | undefined | null;
+  } | undefined | null;
+  ruleId?: string | undefined | null;
+  shareId?: string | undefined | null;
 };
 type ConfigDirectorLoggingLevel = "debug" | "info" | "warn" | "error" | "off";
 interface ConfigDirectorLogger {
@@ -32,24 +38,72 @@ interface ConfigDirectorLogger {
 }
 /**
  * Why an evaluation returned the value it did. `found-match` returns a value from ConfigDirector,
- * and `cached` a value kept on the device while a client SDK waits for live values. `value-missing`
+ * and `cached` a value kept on the device while a client SDK waits for live values.
+ * `rollout-skipped-no-identifier` returns the default targeting rule value: a server SDK skipped a
+ * percentage rollout because the context has no `id` to place it in a share. `value-missing`
  * returns the in-code default value because the config has no value. Every other reason returns the
  * in-code default value because of an error: the config does not exist (`config-state-missing`), no
  * values have arrived yet (`client-not-ready`), or the value cannot be read as the type of the in-code
  * default value.
  */
-type EvaluationReason = "found-match" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean" | "cached";
+type EvaluationReason = "found-match" | "rollout-skipped-no-identifier" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean" | "cached";
+/**
+ * One of the values a config can serve, such as the control or a treatment of an experiment.
+ */
+type Variation = {
+  /** The ID ConfigDirector assigned to the variation, which stays the same when it is renamed. */id: string; /** The variation's name, when it has one. */
+  name?: string;
+};
 /**
  * One evaluation of a config: the value it returned, why, and the context it was evaluated for.
  */
 type ConfigEvaluation<T extends ConfigValueType = ConfigValueType> = {
   /** The config key that was evaluated. */key: string; /** The value returned, which is the in-code default value when {@link isDefaultValue} is `true`. */
   value: T; /** The ID ConfigDirector assigned to the value returned, when ConfigDirector sent one with it. */
-  valueId?: string; /** Whether the evaluation returned the in-code default value. */
+  valueId?: string;
+  /**
+   * The variation that was served. It is `undefined` when the config has no variations or the
+   * in-code default value is returned.
+   */
+  variation?: Variation; /** Whether the evaluation returned the in-code default value. */
   isDefaultValue: boolean; /** Why the evaluation returned this value. */
   reason: EvaluationReason; /** The context the config was evaluated for, if any. */
   context?: ConfigDirectorContext;
 };
+/**
+ * A value in the details of a tracked event: a string, a number, a boolean, or an array or object
+ * of such values.
+ */
+type TrackedEventDetailValue = string | number | boolean | TrackedEventDetailValue[] | {
+  [key: string]: TrackedEventDetailValue;
+};
+/**
+ * Details of a tracked event, such as the plan a customer chose. Details with more than 20
+ * top-level keys, or larger than 1 KB as JSON, are left out and the event is still reported.
+ */
+type TrackedEventDetails = {
+  [key: string]: TrackedEventDetailValue;
+};
+/**
+ * What a tracked event carries besides its name.
+ */
+type TrackOptions = {
+  /**
+   * A number the event measures, such as an amount of money, a count or a duration. A value that
+   * is not a finite number is left out and the event is still reported.
+   */
+  value?: number; /** Details of the event. */
+  details?: TrackedEventDetails;
+};
+/**
+ * An event the code under test tracked, as a test client recorded it.
+ */
+type TrackedEvent = {
+  /** The name the event was tracked with. */name: string; /** The context the event was tracked for, if any. */
+  context?: ConfigDirectorContext; /** The value the event was tracked with, when it is a finite number. */
+  value?: number; /** The details the event was tracked with, when they are within the limits. */
+  details?: TrackedEventDetails;
+};
 /**
  * The context to be sent to ConfigDirector: the user or other entity, such as a device or an
  * organization, that configs are evaluated for. This context will be used for targeting rules
@@ -227,8 +281,8 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
   getValue<T extends ConfigValueType>(configKey: string, defaultValue: T): T;
   /**
    * Evaluates a config as {@link getValue} does and returns the evaluation: the value, the reason it
-   * was served and its value ID. Like every read, it fires `configEvaluated` and is counted in
-   * telemetry.
+   * was served, its value ID and its variation. Like every read, it fires `configEvaluated` and is
+   * counted in telemetry.
    *
    * @returns The evaluation, whose `value` is what {@link getValue} returns
    * @param configKey The config key to evaluate
@@ -260,6 +314,20 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
    * Removes all subscribers from all config keys
    */
   unwatchAll(): void;
+  /**
+   * Reports to ConfigDirector that something happened for the current context, such as a completed
+   * checkout, so it can be counted. The event is sent with the next telemetry batch. `track` never
+   * throws, and does nothing in `offline` mode.
+   *
+   * An event counts for an experiment only when the current context has an `id`, the one the
+   * experiment's config was evaluated for. Before the client has a context, or for a context
+   * without an `id`, the event is still reported.
+   *
+   * @param eventName The name of the event, 1 to 150 characters. An event with any other name is
+   * not reported and a warning is logged.
+   * @param options The event's {@link TrackOptions.value} and {@link TrackOptions.details} (optional)
+   */
+  track(eventName: string, options?: TrackOptions): void;
   /**
    * Pauses the network connection without clearing event handlers, watch handlers, or config
    * state. Intended for mobile environments where the OS may kill background connections (e.g.
@@ -282,5 +350,5 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
   dispose(): void;
 }
 //#endregion
-export { NativeJsonValue as a, ConfigDirectorContext as c, ConfigEvaluation as d, ConfigState as f, EvaluationReason as h, OfflineValues as i, ConfigDirectorLogger as l, ConnectionMode as m, ConfigDirectorClient as n, NativeValue as o, ConfigValueType as p, OfflineValue as r, NativeValues as s, ClientHooks as t, ConfigDirectorLoggingLevel as u };
-//# sourceMappingURL=types-B4kvU3bh.d.mts.map
+export { TrackedEvent as _, NativeJsonValue as a, Variation as b, ConfigDirectorContext as c, ConfigEvaluation as d, ConfigState as f, TrackOptions as g, EvaluationReason as h, OfflineValues as i, ConfigDirectorLogger as l, ConnectionMode as m, ConfigDirectorClient as n, NativeValue as o, ConfigValueType as p, OfflineValue as r, NativeValues as s, ClientHooks as t, ConfigDirectorLoggingLevel as u, TrackedEventDetailValue as v, TrackedEventDetails as y };
+//# sourceMappingURL=types-P8frfCGH.d.cts.map

package/dist/client/types-P8frfCGH.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-P8frfCGH.d.cts","names":[],"sources":["../../../js-client-core/src/Emitter.ts","../../../shared/src/types.ts","../../../shared/src/native-values.ts","../../../js-client-core/src/types.ts"],"mappings":"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"}