@dynamic-labs-sdk/client 1.17.0 → 1.18.0

package/dist/modules/user/updateUser/updateUser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateUser.d.ts","sourceRoot":"","sources":["../../../../src/modules/user/updateUser/updateUser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,KAAK,gBAAgB,GAAG;IACtB,UAAU,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,mBACL,gBAAgB,wDAE/B,OAAO,CAAC,eAAe,GAAG,SAAS,CA4BrC,CAAC"}
+{"version":3,"file":"updateUser.d.ts","sourceRoot":"","sources":["../../../../src/modules/user/updateUser/updateUser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,KAAK,gBAAgB,GAAG;IACtB,UAAU,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,mBACL,gBAAgB,wDAE/B,OAAO,CAAC,eAAe,GAAG,SAAS,CA4BrC,CAAC"}

package/dist/modules/wallets/getWalletProviderDataByKey/getWalletProviderDataByKey.d.ts

@@ -8,7 +8,8 @@ type GetWalletProviderDataByKeyParams = {
  * @param params.walletProviderKey - The key of the wallet provider to retrieve data for.
  * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
  * @returns The data for the wallet provider.
-  * @notInstrumented
+ * @notInstrumented
+ * @hook Exposed as a hook so consumers get reactive wallet provider data, updated when the wallet provider registry changes.
  */
 export declare const getWalletProviderDataByKey: ({ walletProviderKey }: GetWalletProviderDataByKeyParams, client?: import("../../../exports").DynamicClient) => WalletProviderData;
 export {};

package/dist/modules/wallets/getWalletProviderDataByKey/getWalletProviderDataByKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWalletProviderDataByKey.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/getWalletProviderDataByKey/getWalletProviderDataByKey.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,KAAK,gCAAgC,GAAG;IACtC,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,0BACd,gCAAgC,wDAEtD,kBAKF,CAAC"}
+{"version":3,"file":"getWalletProviderDataByKey.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/getWalletProviderDataByKey/getWalletProviderDataByKey.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,KAAK,gCAAgC,GAAG;IACtC,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,0BACd,gCAAgC,wDAEtD,kBAKF,CAAC"}

package/dist/modules/wallets/networks/getTransactionHistory/getTransactionHistory.d.ts

@@ -4,7 +4,7 @@ export type GetTransactionHistoryParams = {
     address: string;
     chain: Chain;
     limit?: number;
-    networkId: number;
+    networkId: number | string;
     offset?: string;
     tokenAddress?: string;
 };

package/dist/modules/wallets/networks/getTransactionHistory/getTransactionHistory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getTransactionHistory.d.ts","sourceRoot":"","sources":["../../../../../src/modules/wallets/networks/getTransactionHistory/getTransactionHistory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC3B,MAAM,4BAA4B,CAAC;AAKpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAExD,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AAEvE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,WACxB,2BAA2B,2DAElC,OAAO,CAAC,0BAA0B,CAgBpC,CAAC"}
+{"version":3,"file":"getTransactionHistory.d.ts","sourceRoot":"","sources":["../../../../../src/modules/wallets/networks/getTransactionHistory/getTransactionHistory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC3B,MAAM,4BAA4B,CAAC;AAKpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAExD,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AAEvE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,WACxB,2BAA2B,2DAElC,OAAO,CAAC,0BAA0B,CAgBpC,CAAC"}

package/dist/modules/wallets/verifyMessageSignatureOwnership/verifyMessageSignatureOwnership.d.ts

@@ -19,6 +19,8 @@ type VerifyMessageSignatureOwnershipParams = {
  * depending on whether the user is signing in, linking or transferring a wallet.
  *
  * Does NOT call updateAuthFromVerifyResponse, it should be called from the return of this function.
+ * @throws WalletAlreadyLinkedToAnotherUserError If the wallet is already linked to another user.
+ * @throws WalletScreeningBlockedError If the wallet was blocked by the project's compliance screening.
   * @notInstrumented
  */
 export declare const verifyMessageSignatureOwnership: ({ messageToSign, walletAddress, addressesWithTypes, signature, chain, isTransfer, walletDisplayName, walletProviderType, networkId, requestedScopes, }: VerifyMessageSignatureOwnershipParams, client: DynamicClient) => Promise<VerifyResponse>;

package/dist/modules/wallets/verifyMessageSignatureOwnership/verifyMessageSignatureOwnership.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verifyMessageSignatureOwnership.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/verifyMessageSignatureOwnership/verifyMessageSignatureOwnership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,UAAU,EACV,cAAc,EAEd,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAGlF,KAAK,qCAAqC,GAAG;IAC3C,kBAAkB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC7C,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,kBAAkB,CAAC;CACxC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,2JAYvC,qCAAqC,UAChC,aAAa,KACpB,OAAO,CAAC,cAAc,CAgExB,CAAC"}
+{"version":3,"file":"verifyMessageSignatureOwnership.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/verifyMessageSignatureOwnership/verifyMessageSignatureOwnership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,UAAU,EACV,cAAc,EAEd,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAIlF,KAAK,qCAAqC,GAAG;IAC3C,kBAAkB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC7C,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,kBAAkB,CAAC;CACxC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,2JAYvC,qCAAqC,UAChC,aAAa,KACpB,OAAO,CAAC,cAAc,CAsExB,CAAC"}

package/dist/modules/wallets/walletProviderRegistry/events.d.ts

@@ -2,7 +2,8 @@ import type { WalletProvider } from '../walletProvider/walletProvider.types';
 declare global {
     interface DynamicEvents {
         /**
-         * Event emitted when an wallet provider is registered, updated or unregistered
+         * Event emitted when a wallet provider is registered or updated. It is NOT
+         * emitted on unregister — listen to `walletProviderUnregistered` for that.
          */
         walletProviderChanged: (args: {
             walletProviderKey: string;

package/dist/modules/wallets/walletProviderRegistry/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/walletProviderRegistry/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,aAAa;QACrB;;WAEG;QACH,qBAAqB,EAAE,CAAC,IAAI,EAAE;YAAE,iBAAiB,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;QAErE;;WAEG;QACH,wBAAwB,EAAE,CAAC,IAAI,EAAE;YAC/B,cAAc,EAAE,cAAc,CAAC;SAChC,KAAK,IAAI,CAAC;QAEX;;WAEG;QACH,0BAA0B,EAAE,CAAC,IAAI,EAAE;YAAE,iBAAiB,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;KAC3E;CACF;AAED,OAAO,EAAE,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/walletProviderRegistry/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,aAAa;QACrB;;;WAGG;QACH,qBAAqB,EAAE,CAAC,IAAI,EAAE;YAAE,iBAAiB,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;QAErE;;WAEG;QACH,wBAAwB,EAAE,CAAC,IAAI,EAAE;YAC/B,cAAc,EAAE,cAAc,CAAC;SAChC,KAAK,IAAI,CAAC;QAEX;;WAEG;QACH,0BAA0B,EAAE,CAAC,IAAI,EAAE;YAAE,iBAAiB,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;KAC3E;CACF;AAED,OAAO,EAAE,CAAC"}

package/dist/services/instrumentation/createInstrumentation/createInstrumentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createInstrumentation.d.ts","sourceRoot":"","sources":["../../../../src/services/instrumentation/createInstrumentation/createInstrumentation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EAGtB,MAAM,0BAA0B,CAAC;AAElC,KAAK,2BAA2B,GAAG;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACzC,CAAC;AASF;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,qBAAqB,8BAE/B,2BAA2B,KAAQ,eA0BrC,CAAC"}
+{"version":3,"file":"createInstrumentation.d.ts","sourceRoot":"","sources":["../../../../src/services/instrumentation/createInstrumentation/createInstrumentation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,eAAe,EACf,qBAAqB,EAEtB,MAAM,0BAA0B,CAAC;AAElC,KAAK,2BAA2B,GAAG;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACzC,CAAC;AASF;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,qBAAqB,8BAE/B,2BAA2B,KAAQ,eA0BrC,CAAC"}

package/dist/services/instrumentation/instrumentFunction/instrumentFunction.d.ts

@@ -1,7 +1,8 @@
 import type { DynamicCore } from '../../../client/core/types/DynamicCore';
-type InstrumentFunctionParams<T extends (...args: unknown[]) => unknown> = {
+import type { InstrumentationPayloadSelectors } from '../instrumentation.types';
+type InstrumentFunctionParams<Args extends unknown[], Result> = {
     /** The original function to wrap. */
-    fn: T;
+    fn: (...args: Args) => Result;
     /** Human-readable name recorded in every emitted event. */
     functionName: string;
     /**
@@ -11,64 +12,69 @@ type InstrumentFunctionParams<T extends (...args: unknown[]) => unknown> = {
      */
     getCore: () => DynamicCore | undefined;
     /**
-     * When `true`, every field in `parameters` and `resolvedValue` is replaced
-     * with `"[redacted]"` regardless of `piiFields`. Use this for functions
-     * whose arguments are inherently sensitive (e.g., signing, authentication).
+     * Optional explicit payload selectors. When provided, their returned
+     * {@link SafePayload} is attached to the corresponding event. When omitted,
+     * events carry only the safe envelope.
      */
-    redactAll?: boolean;
+    selectors?: InstrumentationPayloadSelectors<Args, Result>;
 };
 /**
  * Wraps a function so that each invocation emits a structured
  * `FunctionInstrumentationEvent` at three lifecycle points:
  *
- * - **started** — immediately before the function body executes, with the
- *   PII-scrubbed call parameters.
+ * - **started** — immediately before the function body executes.
  * - **resolved** — after the function (or its returned Promise) settles
- *   successfully, with the PII-scrubbed return value.
+ *   successfully, with the call duration.
  * - **rejected** — if the function throws synchronously or its returned
- *   Promise rejects.
+ *   Promise rejects, with the duration and the error's class name/code.
+ *
+ * Events carry only the safe envelope (function name, phase, timing, error
+ * class, SDK/runtime metadata, identifiers). **Raw arguments and return values
+ * are never captured.** A function that needs additional fields supplies
+ * `selectors` that build an explicit, primitive-only {@link SafePayload} — the
+ * only path from arguments/return value into a log.
  *
  * The original return value (or thrown error) is always forwarded to the
- * caller unchanged — instrumentation is purely observational.
+ * caller unchanged — instrumentation is purely observational, and a throwing
+ * selector cannot change that.
+ *
+ * ## Providing selectors
  *
- * ## Usage
+ * A function opts into a payload by supplying selectors that map its arguments
+ * (`started`) and/or its awaited return value (`resolved`) to a primitive-only
+ * {@link SafePayload}. Pick individual known-safe fields — never spread a whole
+ * object, which is exactly what the model prevents.
  *
  * ```ts
  * const transfer = instrumentFunction({
  *   fn: rawTransfer,
  *   functionName: 'transfer',
  *   getCore: () => core,
+ *   selectors: {
+ *     // `args` is the argument tuple the wrapped function was called with.
+ *     started: ([{ chainId, amount }]) => ({ amount, chainId }),
+ *     // `result` is the awaited return value (never the Promise).
+ *     resolved: ({ txHash }) => ({ txHash }),
+ *   },
  * });
- *
- * // When called, three events are emitted automatically:
- * await transfer({ amount: 1, to: '0xabc' });
  * ```
  *
+ * A selector that throws (or whose output fails scrubbing) is swallowed: the
+ * event is still emitted without a payload, and the error is logged at `debug`.
+ *
  * ## How functions are wrapped
  *
- * `instrumentFunction` is not called manually in application code. Instead,
- * the esbuild instrumentation plugin (`tools/instrumentation-plugin`) injects
- * it at build time: any exported function annotated with `@instrumented` in its
- * JSDoc is automatically wrapped by the plugin during the build step.
- * The plugin strips the original `export`, renames the function, and re-exports
- * it under the original name via `instrumentFunction(...)` — so the public API
- * is unchanged and no call sites need to be updated.
+ * `instrumentFunction` is not called manually in application code. The esbuild
+ * instrumentation plugin (`tools/instrumentation-plugin`) injects it at build
+ * time for any exported function annotated with `@instrumented` in its JSDoc.
  *
  * ## Opting out
  *
- * Instrumentation is skipped entirely when:
- * - `getCore()` returns `undefined` (SDK not initialised), or
- * - `core.instrumentation.config.enabled` is `false`.
- *
- * In both cases the original function is called directly with no overhead.
- *
- * ## PII scrubbing
- *
- * All string values whose key appears in `piiFields` are replaced with
- * `"[redacted]"` before events are emitted. Pass `redactAll: true` to redact
- * every field, regardless of key name.
+ * Instrumentation is skipped entirely when `getCore()` returns `undefined`
+ * (SDK not initialised) or when `core.instrumentation.config.enabled` is
+ * `false`; in both cases the original function is called directly.
  * @notInstrumented
  */
-export declare const instrumentFunction: <T extends (...args: unknown[]) => unknown>({ fn, functionName, getCore, redactAll, }: InstrumentFunctionParams<T>) => T;
+export declare const instrumentFunction: <Args extends unknown[], Result>({ fn, functionName, getCore, selectors, }: InstrumentFunctionParams<Args, Result>) => ((...args: Args) => Result);
 export {};
 //# sourceMappingURL=instrumentFunction.d.ts.map

package/dist/services/instrumentation/instrumentFunction/instrumentFunction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentFunction.d.ts","sourceRoot":"","sources":["../../../../src/services/instrumentation/instrumentFunction/instrumentFunction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAsB1E,KAAK,wBAAwB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,IAAI;IACzE,qCAAqC;IACrC,EAAE,EAAE,CAAC,CAAC;IACN,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,OAAO,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IACvC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,6CAKzE,wBAAwB,CAAC,CAAC,CAAC,KAAG,CAkGhC,CAAC"}
+{"version":3,"file":"instrumentFunction.d.ts","sourceRoot":"","sources":["../../../../src/services/instrumentation/instrumentFunction/instrumentFunction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAO1E,OAAO,KAAK,EAGV,+BAA+B,EAEhC,MAAM,0BAA0B,CAAC;AAiFlC,KAAK,wBAAwB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,IAAI;IAC9D,qCAAqC;IACrC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,OAAO,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IACvC;;;;OAIG;IACH,SAAS,CAAC,EAAE,+BAA+B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;CAC3D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH,eAAO,MAAM,kBAAkB,GAAI,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,6CAK9D,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,KAAG,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAgFrE,CAAC"}

package/dist/services/instrumentation/instrumentation.types.d.ts

@@ -7,16 +7,15 @@ export type InstrumentationEventPhase = 'started' | 'resolved' | 'rejected';
  */
 export type InstrumentationStatus = 'error' | 'info' | 'debug';
 /**
- * Common fields shared by all instrumentation events.
- *
- * All string values that match piiFields are redacted before this event is
- * constructed, so it is safe to forward to an external transport.
+ * Fields shared by every instrumentation event. All values here are either
+ * SDK-controlled metadata or non-sensitive identifiers — none derive from a
+ * function's arguments or return value, so the context is always safe to
+ * forward to an external transport.
  */
-export type InstrumentationEvent = {
+export type InstrumentationContext = {
     environmentId: string;
     /** The operating system the SDK is executing on. */
     operatingSystem: SdkOperatingSystem;
-    parameters: Record<string, unknown>;
     /** The runtime platform the SDK is executing on. */
     platform: SdkPlatform;
     /** Extension keys registered on the client at the time the event was emitted. */
@@ -30,29 +29,61 @@ export type InstrumentationEvent = {
     userId: string | null;
 };
 /**
- * A telemetry record emitted by instrumentFunction for each phase of a
- * function call (started, resolved, rejected). Extends InstrumentationEvent
- * with function-execution-specific fields.
+ * An explicit, opt-in telemetry payload. Restricting values to primitives is
+ * the core guardrail of the explicit-logging model: a selector can only forward
+ * individually chosen, known-safe fields (e.g. `{ scope }`) and can never hand
+ * a whole object/array (e.g. `{ user }`) to a transport, where nested secrets
+ * or PII would ride along unnoticed. Keeping the type primitive-only makes each
+ * logged field a deliberate, statically reviewable decision.
+ */
+export type SafePayload = Record<string, string | number | boolean | null>;
+/**
+ * Co-located selectors that build an explicit {@link SafePayload} from a
+ * function's arguments (started) and/or resolved value (resolved). A function
+ * with no selectors emits envelope-only events. This is the only path from
+ * arguments/return value into a log, and it is statically reviewable.
+ *
+ * `resolved` receives the awaited value, so selectors for async functions see
+ * the unwrapped result (not the Promise).
+ */
+export type InstrumentationPayloadSelectors<Args extends unknown[], Result> = {
+    resolved?: (result: Awaited<Result>) => SafePayload;
+    started?: (args: Args) => SafePayload;
+};
+/**
+ * General instrumentation event emitted by the logger bridge. Retains a
+ * free-form (key-scrubbed) `parameters` bag because it forwards arbitrary
+ * error diagnostics rather than a single function's call shape.
  */
-/** Serializable representation of a caught error, safe for JSON.stringify. */
-export type SerializedError = {
-    message: string;
-    name: string;
-    stack?: string;
+export type InstrumentationEvent = InstrumentationContext & {
+    parameters: Record<string, unknown>;
 };
-export type FunctionInstrumentationEvent = InstrumentationEvent & {
+/**
+ * A telemetry record emitted by instrumentFunction for each phase of a
+ * function call (started, resolved, rejected). Carries only the safe envelope
+ * plus an optional explicit {@link SafePayload} — never raw arguments or
+ * return values.
+ */
+export type FunctionInstrumentationEvent = InstrumentationContext & {
+    /** Wall-clock duration of the call. Present on resolved/rejected only. */
+    durationMs?: number;
+    /** Stable error code on the rejected phase, when the error extends BaseError. */
+    errorCode?: string;
+    /** Error subclass name on the rejected phase. Never the message or stack. */
+    errorName?: string;
     functionName: string;
+    payload?: SafePayload;
     phase: InstrumentationEventPhase;
-    rejectedError?: SerializedError;
-    resolvedValue?: unknown;
 };
+/** Any event the transport may receive. */
+export type AnyInstrumentationEvent = InstrumentationEvent | FunctionInstrumentationEvent;
 export type InstrumentationConfig = {
     enabled: boolean;
     piiFields: string[];
 };
-/** Pluggable sink that receives fully-scrubbed events for forwarding. */
+/** Pluggable sink that receives events for forwarding. */
 export type InstrumentationTransport = {
-    log: (event: InstrumentationEvent) => void;
+    log: (event: AnyInstrumentationEvent) => void;
 };
 /**
  * The instrumentation service instance held on DynamicCore.

package/dist/services/instrumentation/instrumentation.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.types.d.ts","sourceRoot":"","sources":["../../../src/services/instrumentation/instrumentation.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yDAAyD,CAAC;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAE7E,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5E;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,eAAe,EAAE,kBAAkB,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,oDAAoD;IACpD,QAAQ,EAAE,WAAW,CAAC;IACtB,iFAAiF;IACjF,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,8EAA8E;AAC9E,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,GAAG;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,yBAAyB,CAAC;IACjC,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,wBAAwB,GAAG;IACrC,GAAG,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC5C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,GAAG,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC3C,WAAW,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI,CAAC;IAC3D,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,YAAY,EAAE,CAAC,SAAS,EAAE,wBAAwB,KAAK,IAAI,CAAC;CAC7D,CAAC"}
+{"version":3,"file":"instrumentation.types.d.ts","sourceRoot":"","sources":["../../../src/services/instrumentation/instrumentation.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yDAAyD,CAAC;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAE7E,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5E;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,eAAe,EAAE,kBAAkB,CAAC;IACpC,oDAAoD;IACpD,QAAQ,EAAE,WAAW,CAAC;IACtB,iFAAiF;IACjF,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;AAE3E;;;;;;;;GAQG;AACH,MAAM,MAAM,+BAA+B,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,IAAI;IAC5E,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,WAAW,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,WAAW,CAAC;CACvC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,GAAG;IAC1D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG;IAClE,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,yBAAyB,CAAC;CAClC,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,uBAAuB,GAC/B,oBAAoB,GACpB,4BAA4B,CAAC;AAEjC,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,wBAAwB,GAAG;IACrC,GAAG,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,GAAG,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC3C,WAAW,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI,CAAC;IAC3D,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,YAAY,EAAE,CAAC,SAAS,EAAE,wBAAwB,KAAK,IAAI,CAAC;CAC7D,CAAC"}

package/dist/services/keychain/createKeychainService/createKeychainService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createKeychainService.d.ts","sourceRoot":"","sources":["../../../../src/services/keychain/createKeychainService/createKeychainService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAS3E,uBAAuB;AACvB,eAAO,MAAM,qBAAqB,EAAE,qBAyInC,CAAC"}
+{"version":3,"file":"createKeychainService.d.ts","sourceRoot":"","sources":["../../../../src/services/keychain/createKeychainService/createKeychainService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,+BAA+B,CAAC;AASvC,uBAAuB;AACvB,eAAO,MAAM,qBAAqB,EAAE,qBAyJnC,CAAC"}

package/dist/services/navigate/createNavigationHandler/createNavigationHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createNavigationHandler.d.ts","sourceRoot":"","sources":["../../../../src/services/navigate/createNavigationHandler/createNavigationHandler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAO,iBAY1C,CAAC"}
+{"version":3,"file":"createNavigationHandler.d.ts","sourceRoot":"","sources":["../../../../src/services/navigate/createNavigationHandler/createNavigationHandler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAO,iBAiB1C,CAAC"}

package/dist/services/openDeeplink/createWebDeeplinkOpener/createWebDeeplinkOpener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createWebDeeplinkOpener.d.ts","sourceRoot":"","sources":["../../../../src/services/openDeeplink/createWebDeeplinkOpener/createWebDeeplinkOpener.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB,QAAO,YAY1C,CAAC"}
+{"version":3,"file":"createWebDeeplinkOpener.d.ts","sourceRoot":"","sources":["../../../../src/services/openDeeplink/createWebDeeplinkOpener/createWebDeeplinkOpener.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB,QAAO,YAkB1C,CAAC"}