@capxul/sdk 2.1.1 → 2.2.0

package/dist/{create-capxul-client-BI-6Za6X.d.mts → observation-BwPo8qeo.d.mts}

@@ -1,4 +1,4 @@
-import { $ as CapxulErrorDetails, A as CountryCode, B as PermissionAssignmentId, C as AllowedOrigin, D as AuthUserId, E as AuthSession, F as EpochMs, G as SessionToken, H as Profile, I as Money, J as WeiAmount, K as SmartAccount, L as MovementId, M as DocumentHash, N as DurationMs, O as BlockNumber, P as Email, Q as CapxulErrorCode, R as OrgId, S as AllowanceKey, T as AppId, U as PublishableKey, V as PermissionId, W as RoleKey, Z as CapxulError, d as CapxulResult, et as Failure, f as Profile$1, g as AuthCachePort, j as CurrencyCode, k as ChainId, m as SmartAccount$1, n as CapxulSigner, o as AccountProviderSource, p as Session$1, q as TxHash, s as AccountRequirement, tt as FailureMode, v as CachedJwt, w as AnonymousDistinctId, x as Address$1, y as Account$1, z as PaymentCommandId } from "./signer-Bj4F-RwT.mjs";
+import { $ as CapxulError, A as CountryCode, B as PaymentCommandId, C as AllowedOrigin, D as AuthUserId, E as AuthSession, F as EpochMs, G as RoleKey, H as PermissionId, I as Money, J as TxHash, K as SessionToken, L as MovementId, M as DocumentHash, N as DurationMs, O as BlockNumber, P as Email, R as OrgId, S as AllowanceKey, T as AppId, U as Profile, V as PermissionAssignmentId, W as PublishableKey, Y as WeiAmount, d as CapxulResult, et as CapxulErrorCode, f as Profile$1, g as AuthCachePort, it as FailureMode, j as CurrencyCode, k as ChainId, m as SmartAccount$1, n as CapxulSigner, o as AccountProviderSource, p as Session$1, q as SmartAccount, rt as Failure, s as AccountRequirement, tt as CapxulErrorDetails, v as CachedJwt, w as AnonymousDistinctId, x as Address$1, y as Account$1, z as PartyId } from "./signer-D4roBkcX.mjs";
 import { Address, Hex } from "viem";
 import { Context, Effect, Layer, Schema, Scope, Tracer } from "effect";
 import { FunctionReference } from "convex/server";
@@ -1107,6 +1107,9 @@ type TargetReference = {
 } | {
   readonly kind: "payee";
   readonly id: string;
+} | {
+  readonly kind: "party";
+  readonly partyId: PartyId;
 } | {
   readonly kind: "destination";
   readonly id: string;
@@ -1142,6 +1145,9 @@ type Ref$1 = {
 } | {
   readonly kind: "payeeId";
   readonly payeeId: string;
+} | {
+  readonly kind: "party";
+  readonly partyId: PartyId;
 };
 interface MeProfile {
   readonly authUserId: string;
@@ -1243,7 +1249,7 @@ interface Payment {
     readonly transactionHash: string;
   } | null;
   readonly recipient: {
-    readonly kind: "handle" | "email" | "payee" | "capxulUserId" | "me" | "org" | "external_address";
+    readonly kind: "handle" | "email" | "payee" | "capxulUserId" | "me" | "org" | "party" | "external_address";
     readonly label: string;
     readonly payeeId?: string;
   };
@@ -1589,35 +1595,54 @@ interface ActorProfile {
   readonly email?: string;
   readonly handle?: string;
 }
+/**
+ * How a counterparty entered the book, and what they are to the actor today.
+ *
+ * The first six values are the backend edge provenance VERBATIM (ADR-0022 R2);
+ * `employed` is projected from an open employment edge. The pre-substrate
+ * union published `requested` (a value that collapsed two directions) and
+ * `employee` (a value no backend path ever wrote).
+ */
+type AddressBookRelationship = "paid" | "paidBy" | "invoiced" | "invoicedBy" | "member" | "manual" | "employed";
 interface AddressBookEntry {
-  readonly id: string;
+  /**
+   * The counterparty's `PartyId`. It is stable: the id you read before a
+   * counterparty signs up is the id you read after (ADR-0022 R1). The old id
+   * was a derived string that changed at signup.
+   */
+  readonly id: PartyId;
   readonly ref: Ref$1;
   readonly label: string;
-  readonly relationship: readonly ("paid" | "paidBy" | "requested" | "member" | "employee")[];
+  readonly relationship: readonly AddressBookRelationship[];
   readonly hidden: boolean;
+  /** Epoch milliseconds of the most recent activity with this counterparty. */
+  readonly lastActivityAt: number;
 }
 interface AddressBookAddInput {
   readonly ref: Ref$1;
   readonly label?: string;
 }
 interface AddressBookLabelInput {
-  readonly entryId: string;
+  readonly entryId: PartyId;
   readonly label: string;
 }
+interface AddressBookListInput {
+  readonly includeHidden?: boolean;
+}
 interface AddressBookMethods {
-  list(options?: {
+  list(input?: AddressBookListInput, options?: {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<readonly AddressBookEntry[]>>;
-  get(entryId: string, options?: {
+  get(entryId: PartyId, options?: {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<AddressBookEntry | null>>;
   add(input: AddressBookAddInput, options?: {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<AddressBookEntry>>;
-  hide(entryId: string, options?: {
+  hide(entryId: PartyId, options?: {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<AddressBookEntry>>;
-  unhide(entryId: string, options?: {
+  unhide(entryId: PartyId, options?: {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<AddressBookEntry>>;
   label(input: AddressBookLabelInput, options?: {
@@ -2281,7 +2306,7 @@ interface CapxulClient {
      * NOT on the public `client.accounts` surface.
      */
     readonly accounts: AccountsFaucetMethods; /** Quarantined Reference-harness evidence; never a product Organization method. */
-    readonly organizationSetup: OrganizationSetupProofMethods; /** Telemetry port for error reporting. Used by React hooks to report errors before throwing. */
+    readonly organizationSetup: OrganizationSetupProofMethods; /** Product telemetry projection for internal composition and test harnesses. */
     readonly telemetry?: TelemetryPort;
     readonly close?: () => Promise<void>;
   };
@@ -2357,4 +2382,63 @@ interface CreateCapxulClientInput {
   };
 }
 //#endregion
-export { InboxMethods as $, OrgLifecycle as $t, OrganizationPaymentsMethods as A, PaymentDocumentRef as At, AccountMethods as B, RecipientResolution as Bt, ResendInviteTokenInput as C, OfframpQuoteInput as Ct, OrganizationPaymentBatchInput as D, Payment as Dt, RoleView as E, PayeesMethods as Et, PermissionOptions as F, PaymentStatus as Ft, ActorRequestIssueInput as G, TargetsMethods as Gt, ActorProfileMethods as H, Ref$1 as Ht, PermissionReplaceInput as I, PaymentTiming as It, AddressBookEntry as J, AccountSetupStep as Jt, ActorRequestsMethods as K, fingerprintPaymentIntent as Kt, PermissionRevokeInput as L, PaymentType as Lt, PermissionChangeInput as M, PaymentDocumentVerification as Mt, PermissionCreateInput as N, PaymentDocumentsMethods as Nt, OrganizationPaymentInput as O, PaymentDirection as Ot, PermissionMethods as P, PaymentMoney as Pt, InboxItem as Q, AuthMethods as Qt, PermissionReadResult as R, PaymentsMethods as Rt, OrganizationAuditLogItem as S, OfframpQuote as St, RoleSpendCap as T, Payee as Tt, ActorRelationshipMethods as U, ResolvedTarget as Ut, ActorProfile as V, RecipientResolutionKind as Vt, ActorRequest as W, TargetReference as Wt, AddressBookMethods as X, IdentityMethods as Xt, AddressBookLabelInput as Y, isSettingUpLifecycle as Yt, InboxApproveInput as Z, SmartAccountMethods as Zt, OrgMethods as _, StateLabel as _n, FinancialOpsMethods as _t, IdentityRuntimeSendResult as a, SubmittedPermissionExecution as an, ActivityPage as at, OrgView as b, InvocationControls as bn, MeProfile as bt, SystemHealth as c, TelemetryGroupInput as cn, DepositInstructions as ct, CurrentUserMethods as d, CAPXUL_PAYMENTS_V2_ADDRESS as dn, DestinationKind as dt, OrgSetupStep as en, ActivityAnnotationInput as et, CreateOrgInput as f, Destination$1 as fn, DestinationListInput as ft, MemberView as g, Readiness as gn, DestinationsMethods as gt, MemberStatus as h, OrgLane as hn, DestinationRemoveInput as ht, IdentityRuntime as i, Permission as in, ActivityMethods as it, PermissionAssignInput as j, PaymentDocumentRender as jt, OrganizationPaymentItemInput as k, PaymentDocumentKind as kt, MediaMethods as l, TelemetryIdentifyInput as ln, Destination as lt, InviteMemberInput as m, IdentityState as mn, DestinationRail as mt, CreateCapxulClientInput as n, CurrentHoldings as nn, ActivityItem as nt, HoldingsMethods as o, CapxulEnv as on, ActivityReference as ot, DetectPendingOrgInvitationsResult as p, IdentityEvent as pn, DestinationPayload as pt, AddressBookAddInput as q, AccountLifecycle as qt, IdentityProfileDetails as r, MovementAnnotation as rn, ActivityListParams as rt, SystemMethods as s, TelemetryEvent as sn, ActorReference as st, CapxulClient as t, WireObservationContext as tn, ActivityDetail as tt, CurrentUserContext as u, TelemetryPort as un, DestinationAddInput as ut, OrgScopedMethods as v, destination as vn, HandlesMethods as vt, RoleDefinition as w, OfframpStatus as wt, OrganizationAccount as x, OfframpMethods as xt, OrgTemplate as y, IdentityTransition as yn, MeMethods as yt, AccountsMethods as z, PaymentsPayInput as zt };
+//#region src/host-observability.d.ts
+/** One host-owned observability module at the SDK consumer boundary. */
+interface HostObservability {
+  readonly failures: ObservationAdapter;
+  readonly product: TelemetryPort;
+}
+interface PostHogObservabilityClient {
+  capture(event: string, properties?: Readonly<Record<string, unknown>>): unknown;
+  captureException?(exception: Error, properties?: Readonly<Record<string, unknown>>): unknown;
+  identify?(distinctId: string, properties?: Readonly<Record<string, unknown>>): unknown;
+  group?(groupType: string, groupKey: string, properties?: Readonly<Record<string, unknown>>): unknown;
+  reset?(): unknown;
+}
+interface PostHogObservabilityOptions {
+  /** Consent / kill-switch seam. Defaults to enabled. */
+  readonly enabled?: boolean | (() => boolean);
+  /** Host environment stamped on every SDK-owned product event. */
+  readonly capxulEnv?: CapxulEnv;
+  /** Host-owned correlation context shared by product and failure delivery. */
+  readonly context?: ObservationContext | (() => ObservationContext | undefined);
+}
+/** Build the SDK's one host module around an already-initialized PostHog client. */
+declare function postHogObservability(client: PostHogObservabilityClient | null | undefined, options?: PostHogObservabilityOptions): HostObservability;
+//#endregion
+//#region src/observation.d.ts
+/** Host-owned correlation fields that are safe to attach to an SDK failure. */
+interface ObservationContext extends Omit<WireObservationContext, "applicationId"> {}
+/**
+ * The small, SDK-owned failure envelope delivered to observation adapters.
+ * Method arguments, response bodies, wallet payloads, and arbitrary error
+ * details are deliberately absent.
+ */
+interface SdkFailureObservation {
+  readonly exception: Error;
+  readonly sdkVersion: string;
+  readonly operation: string;
+  readonly errorKind: string;
+  /** Invocation snapshot; failure correlation wins over later host state. */
+  readonly context?: ObservationContext;
+}
+type ObservationDelivery = void | PromiseLike<void>;
+/**
+ * High-level host observation boundary. The SDK owns when each method is
+ * called; the host owns the destination client, consent, and delivery policy.
+ */
+interface ObservationAdapter {
+  /**
+   * Optional read-only invocation context. Transport adapters snapshot it once
+   * at call start; implementations must not mutate global SDK state.
+   */
+  readonly resolveContext?: () => ObservationContext | undefined;
+  /** A method returned the SDK's typed `{ ok: false, error }` result. */
+  captureOperationFailure(failure: SdkFailureObservation): ObservationDelivery;
+  /** A method unexpectedly threw or rejected instead of returning a typed result. */
+  captureException(exception: SdkFailureObservation): ObservationDelivery;
+}
+/** Stable PostHog event used for typed failures that are expected product outcomes. */
+declare const CAPXUL_SDK_EXPECTED_OUTCOME_EVENT = "capxul_sdk_expected_outcome";
+//#endregion
+export { ActorRequest as $, TargetReference as $t, OrganizationAccount as A, OfframpMethods as At, PermissionAssignInput as B, PaymentDocumentRender as Bt, InviteMemberInput as C, Readiness as Cn, DestinationRail as Ct, OrgScopedMethods as D, InvocationControls as Dn, HandlesMethods as Dt, OrgMethods as E, IdentityTransition as En, FinancialOpsMethods as Et, RoleView as F, PayeesMethods as Ft, PermissionReplaceInput as G, PaymentTiming as Gt, PermissionCreateInput as H, PaymentDocumentsMethods as Ht, OrganizationPaymentBatchInput as I, Payment as It, AccountsMethods as J, PaymentsPayInput as Jt, PermissionRevokeInput as K, PaymentType as Kt, OrganizationPaymentInput as L, PaymentDirection as Lt, ResendInviteTokenInput as M, OfframpQuoteInput as Mt, RoleDefinition as N, OfframpStatus as Nt, OrgTemplate as O, MeMethods as Ot, RoleSpendCap as P, Payee as Pt, ActorRelationshipMethods as Q, ResolvedTarget as Qt, OrganizationPaymentItemInput as R, PaymentDocumentKind as Rt, DetectPendingOrgInvitationsResult as S, OrgLane as Sn, DestinationPayload as St, MemberView as T, destination as Tn, DestinationsMethods as Tt, PermissionMethods as U, PaymentMoney as Ut, PermissionChangeInput as V, PaymentDocumentVerification as Vt, PermissionOptions as W, PaymentStatus as Wt, ActorProfile as X, RecipientResolutionKind as Xt, AccountMethods as Y, RecipientResolution as Yt, ActorProfileMethods as Z, Ref$1 as Zt, SystemHealth as _, TelemetryPort as _n, DepositInstructions as _t, SdkFailureObservation as a, IdentityMethods as an, AddressBookMethods as at, CurrentUserMethods as b, IdentityEvent as bn, DestinationKind as bt, PostHogObservabilityOptions as c, OrgLifecycle as cn, InboxMethods as ct, CreateCapxulClientInput as d, MovementAnnotation as dn, ActivityItem as dt, TargetsMethods as en, ActorRequestIssueInput as et, IdentityProfileDetails as f, Permission as fn, ActivityListParams as ft, SystemMethods as g, TelemetryIdentifyInput as gn, ActorReference as gt, HoldingsMethods as h, TelemetryGroupInput as hn, ActivityReference as ht, ObservationDelivery as i, isSettingUpLifecycle as in, AddressBookLabelInput as it, OrganizationAuditLogItem as j, OfframpQuote as jt, OrgView as k, MeProfile as kt, postHogObservability as l, OrgSetupStep as ln, ActivityAnnotationInput as lt, IdentityRuntimeSendResult as m, TelemetryEvent as mn, ActivityPage as mt, ObservationAdapter as n, AccountLifecycle as nn, AddressBookAddInput as nt, HostObservability as o, SmartAccountMethods as on, InboxApproveInput as ot, IdentityRuntime as p, SubmittedPermissionExecution as pn, ActivityMethods as pt, PermissionReadResult as q, PaymentsMethods as qt, ObservationContext as r, AccountSetupStep as rn, AddressBookEntry as rt, PostHogObservabilityClient as s, AuthMethods as sn, InboxItem as st, CAPXUL_SDK_EXPECTED_OUTCOME_EVENT as t, fingerprintPaymentIntent as tn, ActorRequestsMethods as tt, CapxulClient as u, CurrentHoldings as un, ActivityDetail as ut, MediaMethods as v, CAPXUL_PAYMENTS_V2_ADDRESS as vn, Destination as vt, MemberStatus as w, StateLabel as wn, DestinationRemoveInput as wt, CreateOrgInput as x, IdentityState as xn, DestinationListInput as xt, CurrentUserContext as y, Destination$1 as yn, DestinationAddInput as yt, OrganizationPaymentsMethods as z, PaymentDocumentRef as zt };

package/dist/{signer-Bj4F-RwT.d.mts → signer-D4roBkcX.d.mts}

@@ -34,6 +34,13 @@ interface Failure {
   readonly error?: CapxulError;
 }
 type CapxulErrorDetails = Record<string, unknown>;
+type SignerSource = "openfort-embedded" | "injected-eip1193" | "local-private-key";
+type VerificationRequiredDetails = {
+  readonly requiredTier: number;
+} | {
+  readonly rail: string;
+  readonly currentKind: string;
+};
 type CapxulErrorOptions = {
   readonly cause?: unknown;
   readonly details?: CapxulErrorDetails;
@@ -48,6 +55,91 @@ declare class CapxulError extends Error {
   constructor(code: CapxulErrorCode, message: string, options?: CapxulErrorOptions);
 }
 declare function isCapxulError(value: unknown): value is CapxulError;
+declare const Errors: {
+  readonly notAuthenticated: (message?: string, opts?: {
+    readonly failure_mode?: FailureMode;
+  }) => CapxulError;
+  readonly emailDeliveryFailed: (detail: string) => CapxulError;
+  readonly profileNotFound: (authUserId: string) => CapxulError;
+  readonly smartAccountMissing: (authUserId: string) => CapxulError;
+  readonly playerNotFound: (playerId?: string) => CapxulError;
+  readonly accountNotFound: (accountId?: string) => CapxulError;
+  readonly providerError: (provider: string, operation: string, cause: unknown, opts?: {
+    readonly failure_mode?: FailureMode;
+  }) => CapxulError;
+  readonly capabilityUnavailable: (provider: string, operation: string) => CapxulError;
+  readonly invalidInput: (field: string, reason: string) => CapxulError;
+  readonly envMissing: (name: string) => CapxulError;
+  readonly notImplemented: (domain: string, method: string) => CapxulError;
+  /**
+   * Sibling factory to {@link Errors.providerError} for the per-state timeout
+   * path in flows. Same `PROVIDER_ERROR` code as
+   * `providerError`, plus a `details.reason: "timeout"` discriminator so
+   * downstream observers can distinguish failure modes without parsing the
+   * message string. The redacted message names the timeout budget; the
+   * native `cause` carries the same information for `reportError` fidelity.
+   */
+  readonly providerTimeout: (provider: string, operation: string, timeoutMs: number) => CapxulError;
+  readonly verificationRequired: (details: VerificationRequiredDetails) => CapxulError;
+  readonly insufficientBalance: (asset: string, available: string, required: string) => CapxulError;
+  readonly invalidRecipient: (reason: string) => CapxulError;
+  /**
+   * The org Zodiac Roles modifier REFUSED the spend on-chain (G4 · #547): the
+   * member's role condition (per-tx cap, per-day allowance, allowed recipient,
+   * or membership) was violated, so `execTransactionWithRole` reverted. This is
+   * a PERMISSION denial — explicitly NOT an `INSUFFICIENT_BALANCE` (the treasury
+   * held the funds; the role's authority is what bound). `reason` discriminates
+   * the violated condition (`over_cap` / `daily_cap` / `not_member` /
+   * `disallowed_recipient` / `condition_violation`); leak-safe — no on-chain
+   * identifiers ever enter the details.
+   */
+  readonly rolePermissionDenied: (details: {
+    readonly reason: "over_cap" | "daily_cap" | "not_member" | "disallowed_recipient" | "condition_violation";
+    readonly operation?: string;
+  }) => CapxulError;
+  /**
+   * A transaction (or sponsored UserOp) failed. `details.reason` discriminates
+   * the failure mode for callers that must distinguish a CONFIRMED on-chain
+   * revert (`"onchain_revert"` — the op executed and reverted, e.g. a Zodiac
+   * Roles condition violation) from an inconclusive infra failure. A confirmed
+   * revert is the ONLY mode the org spend port may map to a roles denial.
+   */
+  readonly transactionFailed: (operation: string, cause?: unknown, extra?: {
+    readonly reason?: string;
+  }) => CapxulError;
+  readonly rateLimited: (details?: {
+    readonly retryAfterMs?: number;
+    readonly resource?: string;
+  }) => CapxulError;
+  readonly networkError: (operation: string, cause?: unknown) => CapxulError;
+  readonly unknown: (cause?: unknown) => CapxulError;
+  readonly otpExpired: (details?: {
+    readonly email?: string;
+    readonly expiredAt?: number;
+  }) => CapxulError;
+  readonly signerRejected: (details: {
+    readonly source: SignerSource;
+    readonly reason?: string;
+    readonly cause?: unknown;
+  }) => CapxulError;
+  readonly cancelled: (details?: {
+    readonly operation?: string;
+    readonly reason?: string;
+  }) => CapxulError;
+  /**
+   * Method called from a flow state where its precondition fails (TA16). The
+   * SDK's method API short-circuits with this error before driving the
+   * internal state machine. `currentState` is the Effect-machine snapshot
+   * tag (stringified from the SDK's actor-shell snapshot; see
+   * `packages/errors/CONTEXT.md`); `validStates`
+   * enumerates the states the method accepts.
+   */
+  readonly wrongState: (details: {
+    readonly method: string;
+    readonly currentState: string;
+    readonly validStates: readonly string[];
+  }) => CapxulError;
+};
 //#endregion
 //#region ../types/src/brand.d.ts
 /**
@@ -99,6 +191,7 @@ type Account$1 = {
 type AuthUserId = Brand<string, "AuthUserId">;
 type AnonymousDistinctId = Brand<string, "AnonymousDistinctId">;
 type AccountId = Brand<string, "AccountId">;
+type PartyId = Brand<string, "PartyId">;
 type MovementId = Brand<string, "MovementId">;
 type PermissionId = Brand<string, "PermissionId">;
 type PermissionAssignmentId = Brand<string, "PermissionAssignmentId">;
@@ -292,4 +385,4 @@ interface Eip1193RequestProvider {
  */
 declare function injectedWalletSigner(provider: Eip1193RequestProvider): CapxulSigner;
 //#endregion
-export { CapxulErrorDetails as $, CountryCode as A, PermissionAssignmentId as B, AllowedOrigin as C, AuthUserId as D, AuthSession as E, EpochMs as F, SessionToken as G, Profile$1 as H, Money as I, WeiAmount as J, SmartAccount$1 as K, MovementId as L, DocumentHash as M, DurationMs as N, BlockNumber as O, Email as P, CapxulErrorCode as Q, OrgId as R, AllowanceKey as S, AppId as T, PublishableKey as U, PermissionId as V, RoleKey as W, toCountryCode as X, toAddress as Y, CapxulError as Z, AuthCachePortTag as _, AccountProvider as a, AccountId as b, Eip1193Provider as c, CapxulResult as d, Failure as et, Profile as f, AuthCachePort as g, AuthCacheError as h, injectedWalletSigner as i, CurrencyCode as j, ChainId as k, eip1193AccountProvider as l, SmartAccount as m, CapxulSigner as n, isCapxulError as nt, AccountProviderSource as o, Session as p, TxHash as q, Eip1193RequestProvider as r, AccountRequirement as s, CapxulDigestSigner as t, FailureMode as tt, localPrivateKeyAccountProvider as u, CachedJwt as v, AnonymousDistinctId as w, Address$1 as x, Account$1 as y, PaymentCommandId as z };
+export { CapxulError as $, CountryCode as A, PaymentCommandId as B, AllowedOrigin as C, AuthUserId as D, AuthSession as E, EpochMs as F, RoleKey as G, PermissionId as H, Money as I, TxHash as J, SessionToken as K, MovementId as L, DocumentHash as M, DurationMs as N, BlockNumber as O, Email as P, CAPXUL_ERROR_CODES as Q, OrgId as R, AllowanceKey as S, AppId as T, Profile$1 as U, PermissionAssignmentId as V, PublishableKey as W, toAddress as X, WeiAmount as Y, toCountryCode as Z, AuthCachePortTag as _, AccountProvider as a, isCapxulError as at, AccountId as b, Eip1193Provider as c, CapxulResult as d, CapxulErrorCode as et, Profile as f, AuthCachePort as g, AuthCacheError as h, injectedWalletSigner as i, FailureMode as it, CurrencyCode as j, ChainId as k, eip1193AccountProvider as l, SmartAccount as m, CapxulSigner as n, Errors as nt, AccountProviderSource as o, Session as p, SmartAccount$1 as q, Eip1193RequestProvider as r, Failure as rt, AccountRequirement as s, CapxulDigestSigner as t, CapxulErrorDetails as tt, localPrivateKeyAccountProvider as u, CachedJwt as v, AnonymousDistinctId as w, Address$1 as x, Account$1 as y, PartyId as z };

package/dist/testing/index.d.mts

@@ -1,4 +1,4 @@
-import { cn as TelemetryGroupInput, ln as TelemetryIdentifyInput, sn as TelemetryEvent, t as CapxulClient, yn as IdentityTransition } from "../create-capxul-client-BI-6Za6X.mjs";
+import { En as IdentityTransition, gn as TelemetryIdentifyInput, hn as TelemetryGroupInput, mn as TelemetryEvent, n as ObservationAdapter, u as CapxulClient } from "../observation-BwPo8qeo.mjs";
 import { Effect, Layer } from "effect";
 
 //#region src/testing/telemetry/RecordingTelemetryAdapter.d.ts
@@ -18,6 +18,8 @@ type RecordingTelemetryOperation = {
 //#region src/testing/index.d.ts
 interface CreateCapxulTestClientOptions {
   readonly requirement?: "none" | "counterfactual" | "deployed";
+  /** Optional Core SDK failure adapter for packed consumer proofs. */
+  readonly failureObservation?: ObservationAdapter;
 }
 interface SeedTestIdentityInput {
   readonly authUserId: string;

package/dist/testing/index.mjs

@@ -1,5 +1,5 @@
-import { C as bootstrapErrorFromCapxul, G as deriveCapxulSafeAddress, O as toWei, _ as identityErrorFromCapxul, f as smartAccountErrorFromCapxul, h as wireChainId, k as fromWei, m as accountReadErrorFromCapxul, t as assembleCapxulClient, u as redactTelemetryEvent, w as authClientPortFromPromiseAdapter, y as convexCallErrorFromCapxul } from "../create-capxul-client-CPhTPz_9.mjs";
-import { A as toSessionToken, C as toEpochMs, E as toKycTier, M as CapxulError, O as toPublishableKey, P as Errors, S as toEmail, T as toJwtToken, _ as toAuthUserId, g as toAppId, h as toAllowedOrigin, m as toAddress, p as toAccountId, t as InMemoryAuthCacheAdapter, v as toChainId, w as toEpochSeconds, x as toDurationMs, y as toCountryCode } from "../InMemoryAuthCacheAdapter-Rc8tCtml.mjs";
+import { E as authClientPortFromPromiseAdapter, J as deriveCapxulSafeAddress, M as fromWei, T as bootstrapErrorFromCapxul, _ as wireChainId, f as redactTelemetryEvent, g as accountReadErrorFromCapxul, j as toWei, m as smartAccountErrorFromCapxul, t as assembleCapxulClient, x as convexCallErrorFromCapxul, y as identityErrorFromCapxul } from "../create-capxul-client-B8qMV-_e.mjs";
+import { A as toPublishableKey, C as toEmail, D as toKycTier, E as toJwtToken, F as CapxulError, L as Errors, M as toSessionToken, S as toDurationMs, T as toEpochSeconds, _ as toAppId, b as toCountryCode, g as toAllowedOrigin, h as toAddress, m as toAccountId, t as InMemoryAuthCacheAdapter, v as toAuthUserId, w as toEpochMs, y as toChainId } from "../InMemoryAuthCacheAdapter-PycLJWeW.mjs";
 import { keccak256 } from "viem";
 import { Effect, Result, Semaphore } from "effect";
 import { getFunctionName } from "convex/server";
@@ -884,7 +884,8 @@ function createCapxulTestClient(options = {}) {
 		},
 		bootstrap: TEST_BOOTSTRAP,
 		authCache,
-		requirement: options.requirement ?? "none"
+		requirement: options.requirement ?? "none",
+		...options.failureObservation === void 0 ? {} : { failureObservation: options.failureObservation }
 	});
 	const transitions = [];
 	const unsubscribe = client._internal.identity.subscribeTransitions((record) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/sdk",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Xelmar-tech/infrastructure.git",
@@ -48,10 +48,10 @@
     "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.23",
     "@capxul/config": "0.2.0",
     "@capxul/errors": "0.0.1",
-    "@capxul/observability": "2.1.1",
-    "@capxul/typescript-config": "0.0.0",
     "@capxul/types": "0.1.0",
-    "@capxul/wire": "0.3.0"
+    "@capxul/wire": "0.3.0",
+    "@capxul/observability": "2.2.0",
+    "@capxul/typescript-config": "0.0.0"
   },
   "_permissionlessPinReason": "permissionless.toSafeSmartAccount is pinned to 0.3.4 for live Safe deployment E2E. Counterfactual address fixtures captured 2026-05-17 in packages/backend/convex/_shared/__tests__/counterfactual.test.ts and packages/config/tests/safe.test.ts must be re-verified before upgrading.",
   "scripts": {