@dynamic-labs-sdk/client 1.17.1 → 1.19.0

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

@@ -9,11 +9,22 @@ type SignMessageParams = {
  * This function uses the wallet's private key to cryptographically sign
  * the provided message.
  *
+ * @example
+ * ```ts
+ * const wallets = getWalletAccounts();
+ * const { signature } = await signMessage({
+ *   walletAccount: wallets[0],
+ *   message: 'Hello Dynamic!',
+ * });
+ * ```
+ *
  * @param params.walletAccount - The wallet account to use for signing.
  * @param params.message - The message to sign.
  * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
  * @returns A promise that resolves to an object containing the signature.
-  * @instrumented
+ * @see getWalletAccounts
+ * @see connectWithWalletProvider
+ * @instrumented
  */
 export declare const signMessage: ({ walletAccount, message }: SignMessageParams, client?: import("../../../exports").DynamicClient) => Promise<{
     signature: string;

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

@@ -1 +1 @@
-{"version":3,"file":"signMessage.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/signMessage/signMessage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,+BACM,iBAAiB,wDAE5C,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAgB/B,CAAC"}
+{"version":3,"file":"signMessage.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/signMessage/signMessage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,WAAW,+BACM,iBAAiB,wDAE5C,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAgB/B,CAAC"}

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

@@ -5,14 +5,25 @@ import type { TransferAmountParams } from '../walletProvider/walletProvider.type
  * Supports native token transfers and, where supported by the chain,
  * fungible/token transfers via the optional `token` parameter.
  *
+ * @example
+ * ```ts
+ * const { transactionHash } = await transferAmount({
+ *   walletAccount: wallets[0],
+ *   amount: '0.1',
+ *   recipient: '0x1234...abcd',
+ * });
+ * ```
+ *
  * @param params.walletAccount - The wallet account to transfer from.
  * @param params.amount - The amount to transfer as a decimal string (e.g. "1.5").
  * @param params.recipient - The recipient address.
- * @param params.token - Optional token info for non-native transfers.
+ * @param [params.token] - Optional token info for non-native transfers.
  * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
  * @returns A promise that resolves to an object containing the transaction hash.
  * @throws If the wallet provider does not support the transfer amount method.
-  * @instrumented
+ * @see getWalletAccounts
+ * @see signMessage
+ * @instrumented
  */
 export declare const transferAmount: ({ walletAccount, amount, recipient, token }: TransferAmountParams, client?: import("../../../exports").DynamicClient) => Promise<{
     transactionHash: string;

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

@@ -1 +1 @@
-{"version":3,"file":"transferAmount.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/transferAmount/transferAmount.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAEnF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,gDACoB,oBAAoB,wDAEhE,OAAO,CAAC;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAkBrC,CAAC"}
+{"version":3,"file":"transferAmount.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/transferAmount/transferAmount.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,cAAc,gDACoB,oBAAoB,wDAEhE,OAAO,CAAC;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAkBrC,CAAC"}

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

@@ -7,10 +7,19 @@ type TransferWalletAccountParams = {
  * This function requires the user to sign a message to prove wallet ownership,
  * then transfers the wallet account to the current user's account.
  *
+ * @example
+ * ```ts
+ * const walletAccount = await transferWalletAccount({
+ *   walletProviderKey: 'metamaskevm',
+ * });
+ * ```
+ *
  * @param params.walletProviderKey - The key of the wallet provider of the wallet account to transfer.
  * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
  * @returns A promise that resolves to the transferred wallet account.
-  * @instrumented
+ * @see connectWithWalletProvider
+ * @see verifyWalletAccount
+ * @instrumented
  */
 export declare const transferWalletAccount: ({ walletProviderKey }: TransferWalletAccountParams, client?: import("../../../exports").DynamicClient) => Promise<import("../walletAccount").BaseWalletAccount<import("../../chain").Chain>>;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"transferWalletAccount.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/transferWalletAccount/transferWalletAccount.ts"],"names":[],"mappings":"AAIA,KAAK,2BAA2B,GAAG;IACjC,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,0BACT,2BAA2B,0IAenD,CAAC"}
+{"version":3,"file":"transferWalletAccount.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/transferWalletAccount/transferWalletAccount.ts"],"names":[],"mappings":"AAIA,KAAK,2BAA2B,GAAG;IACjC,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,qBAAqB,0BACT,2BAA2B,0IAenD,CAAC"}

package/dist/modules/wallets/utils/getWalletAccountFromAddress/getWalletAccountFromAddress.d.ts

@@ -9,11 +9,21 @@ type GetWalletAccountFromAddressParams = {
  * This function searches through the current session's wallet accounts
  * to find one matching the specified address and chain.
  *
+ * @example
+ * ```ts
+ * const account = getWalletAccountFromAddress({
+ *   address: '0x1234...abcd',
+ *   chain: 'EVM',
+ * });
+ * ```
+ *
  * @param params.address - The wallet address to search for.
  * @param params.chain - The blockchain the wallet belongs to.
  * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
  * @returns The matching wallet account, or undefined if not found.
-  * @notInstrumented
+ * @see getWalletAccounts
+ * @see isWalletAccountVerified
+ * @notInstrumented
  */
 export declare const getWalletAccountFromAddress: ({ address, chain }: GetWalletAccountFromAddressParams, client?: import("../../../../exports").DynamicClient) => import("../../walletAccount").BaseWalletAccount<Chain> | undefined;
 export {};

package/dist/modules/wallets/utils/getWalletAccountFromAddress/getWalletAccountFromAddress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWalletAccountFromAddress.d.ts","sourceRoot":"","sources":["../../../../../src/modules/wallets/utils/getWalletAccountFromAddress/getWalletAccountFromAddress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAG5C,KAAK,iCAAiC,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,uBAClB,iCAAiC,6HAStD,CAAC"}
+{"version":3,"file":"getWalletAccountFromAddress.d.ts","sourceRoot":"","sources":["../../../../../src/modules/wallets/utils/getWalletAccountFromAddress/getWalletAccountFromAddress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAG5C,KAAK,iCAAiC,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,2BAA2B,uBAClB,iCAAiC,6HAStD,CAAC"}

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

@@ -19,6 +19,9 @@ 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 MergeAccountsConfirmationError If the credential belongs to another user and the backend is offering to merge the accounts.
+ * @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,EAGV,UAAU,EACV,cAAc,EAEd,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAK3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAKlF,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;;;;;;;;;GASG;AACH,eAAO,MAAM,+BAA+B,2JAYvC,qCAAqC,UAChC,aAAa,KACpB,OAAO,CAAC,cAAc,CAoFxB,CAAC"}

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

@@ -10,12 +10,23 @@ type VerifyWalletAccountParams = {
  * This function requires the user to sign a message to prove wallet ownership,
  * then sets the wallet account as verified.
  *
+ * @example
+ * ```ts
+ * const walletAccount = await connectWithWalletProvider({
+ *   walletProviderKey: 'metamaskevm',
+ * });
+ * const verified = await verifyWalletAccount({ walletAccount });
+ * ```
+ *
  * @param params.walletAccount - The wallet account to verify ownership of.
+ * @param [params.requestedScopes] - Optional token scopes to request during verification.
  * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
  * @returns A promise that resolves to the verified wallet account.
  * @throws WalletAccountAlreadyVerifiedError If the wallet is already verified.
  * @throws WalletAlreadyLinkedToAnotherUserError If the wallet is linked to another user.
-  * @instrumented
+ * @see connectWithWalletProvider
+ * @see connectAndVerifyWithWalletProvider
+ * @instrumented
  */
 export declare const verifyWalletAccount: ({ walletAccount, requestedScopes }: VerifyWalletAccountParams, client?: import("../../../exports").DynamicClient) => Promise<WalletAccount>;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"verifyWalletAccount.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/verifyWalletAccount/verifyWalletAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,KAAK,yBAAyB,GAAG;IAC/B,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,uCACM,yBAAyB,wDAE5D,OAAO,CAAC,aAAa,CASvB,CAAC"}
+{"version":3,"file":"verifyWalletAccount.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/verifyWalletAccount/verifyWalletAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,KAAK,yBAAyB,GAAG;IAC/B,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,mBAAmB,uCACM,yBAAyB,wDAE5D,OAAO,CAAC,aAAa,CASvB,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"}