@capxul/sdk 3.2.0 → 4.0.1

package/dist/{observation-B76zFxd6.d.mts → observation-DtzTdv20.d.mts}

@@ -1,4 +1,4 @@
-import { $ as SessionToken, A as AppId, B as Email, D as AllowanceKey, E as Address$1, F as ChainId, G as PaymentCommandId, H as Money, I as CountryCode, J as PermissionAssignmentId, K as PayrollGroupId, L as CurrencyCode, M as AuthUserId, N as BlockNumber, O as AllowedOrigin, P as BudgetId, Q as RoleKey, R as DocumentHash, U as OrgId, V as EpochMs, W as PartyId, X as Profile, Y as PermissionId, Z as PublishableKey, _ as ClockPort, _t as FailureMode, a as SignerStatusStore, c as AccountProviderSource, ct as CapxulErrorCode, dt as Failure, et as SmartAccount, g as SmartAccount$1, h as Session$1, j as AuthSession, k as AnonymousDistinctId, l as AccountRequirement, lt as CapxulErrorDetails, m as Profile$1, n as CapxulSigner, nt as WeiAmount, p as CapxulResult, q as PayrollRunId, st as CapxulError, tt as TxHash, v as AuthClientPort, w as Account$1, x as AuthCachePort, y as CanSendOtpStatus, z as DurationMs } from "./signer-DOqb8M1Y.mjs";
+import { $ as PublishableKey, A as AppId, D as AllowanceKey, E as Address$1, F as ChainId, G as OrgId, H as EpochMs, I as CountryCode, J as PayrollGroupId, K as PartyId, L as CurrencyCode, M as AuthUserId, N as BlockNumber, O as AllowedOrigin, P as BudgetId, Q as Profile, R as DocumentHash, St as FailureMode, V as Email, W as Money, X as PermissionAssignmentId, Y as PayrollRunId, Z as PermissionId, _ as ClockPort, a as SignerStatusStore, at as WeiAmount, c as AccountProviderSource, et as RoleKey, ft as CapxulError, g as SmartAccount$1, gt as Failure, h as Session$1, it as TxHash, j as AuthSession, k as AnonymousDistinctId, l as AccountRequirement, m as Profile$1, mt as CapxulErrorDetails, n as CapxulSigner, nt as SmartAccount, p as CapxulResult, pt as CapxulErrorCode, q as PaymentCommandId, rt as TesterKind, tt as SessionToken, v as AuthClientPort, w as Account$1, x as AuthCachePort, y as CanSendOtpStatus, z as DurationMs } from "./signer-C0hZ6Kiy.mjs";
 import { Context, Effect, Layer, Schema, Scope, Tracer } from "effect";
 import { Hex } from "viem";
 import { FunctionReference } from "convex/server";
@@ -279,7 +279,7 @@ interface TelemetryPort {
 }
 //#endregion
 //#region ../observability/src/index.d.ts
-declare const TELEMETRY_EVENT_NAMES: readonly ["auth_otp_requested", "auth_otp_delivered", "auth_otp_expired", "auth_verified", "auth_failed", "auth_signed_out", "onboarding_intent_selected", "onboarding_profile_submitted", "onboarding_organization_submitted", "onboarding_dashboard_reached", "provisioning_safe_created", "provisioning_safe_confirmed", "bootstrap_resolved", "bootstrap_failed", "member_activation_started", "member_activation_ready", "member_activation_failed", "organization_creation_started", "organization_creation_ready", "organization_creation_failed", "chain_upstream_fallback", "bundler_error", "receipt_pending", "operation_retried", "account_balance_read", "account_balance_failed", "faucet_requested", "faucet_confirmed", "faucet_failed", "org_create_started", "org_safe_created", "org_safe_confirmed", "org_roles_seeded", "org_created", "org_create_failed", "org_invite_sent", "org_invite_accepted", "org_invite_expired", "payment_initiated", "payment_settled", "payment_failed", "payment_verification_retry", "deposit_initiated", "deposit_settled", "permission_mirror_verification", "movement_scan_window", "movement_scan_checkpoint", "movement_scan_incident"];
+declare const TELEMETRY_EVENT_NAMES: readonly ["auth_otp_requested", "auth_otp_delivered", "auth_otp_expired", "auth_verified", "auth_failed", "auth_signed_out", "onboarding_intent_selected", "onboarding_profile_submitted", "onboarding_organization_submitted", "onboarding_dashboard_reached", "provisioning_safe_created", "provisioning_safe_confirmed", "bootstrap_resolved", "bootstrap_failed", "member_activation_started", "member_activation_ready", "member_activation_failed", "organization_creation_started", "organization_creation_ready", "organization_creation_failed", "chain_upstream_fallback", "bundler_error", "receipt_pending", "operation_retried", "account_balance_read", "account_balance_failed", "faucet_requested", "faucet_confirmed", "faucet_failed", "org_create_started", "org_safe_created", "org_safe_confirmed", "org_roles_seeded", "org_created", "org_create_failed", "org_invite_sent", "org_invite_accepted", "org_invite_expired", "payment_initiated", "payment_settled", "payment_failed", "payment_verification_retry", "payment_lifecycle_transition", "quick_pay_external_address_acknowledged", "deposit_initiated", "deposit_settled", "permission_mirror_verification", "movement_scan_window", "movement_scan_checkpoint", "movement_scan_incident"];
 type TelemetryEventName = (typeof TELEMETRY_EVENT_NAMES)[number];
 type TelemetryProps = Record<string, unknown>;
 type TelemetryEvent = {
@@ -323,8 +323,10 @@ type EngineeringTelemetryBootstrapPolicyV1 = Schema.Schema.Type<typeof Engineeri
 //#endregion
 //#region ../wire/src/status.d.ts
 /** The closed Payment status authority. */
-declare const PAYMENT_STATUSES: readonly ["pending", "settling", "scheduled", "streaming", "pending_claim", "settled", "cancelled", "failed"];
+declare const PAYMENT_STATUSES: readonly ["pending", "settling", "unresolved", "scheduled", "streaming", "pending_claim", "settled", "cancelled", "failed"];
 type PaymentStatus$1 = (typeof PAYMENT_STATUSES)[number];
+declare const PAYMENT_EXECUTION_STATUSES: readonly ["pending", "included", "dropped", "replaced", "expired", "unresolved", "superseded", "failed", "settled"];
+type PaymentExecutionStatus = (typeof PAYMENT_EXECUTION_STATUSES)[number];
 /** The payment direction relative to the current actor. */
 declare const PAYMENT_DIRECTIONS: readonly ["in", "out", "self"];
 type PaymentDirection$1 = (typeof PAYMENT_DIRECTIONS)[number];
@@ -722,8 +724,8 @@ type CompleteOnboardingIdentityInput = {
   readonly displayName: string;
   readonly country: CountryCode;
   readonly withdrawalAddress?: Address$1;
-  /** #1062: optional globally-unique handle — store-when-present, backend-normalized. */
-  readonly username?: string;
+  /** One globally unique Party handle. */
+  readonly handle: string;
 };
 declare const IdentityError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "IdentityError";
@@ -1020,21 +1022,21 @@ interface SmartAccountMethods {
 interface CompleteProfileInput {
   readonly displayName: string;
   readonly country: string;
-  readonly username: string;
+  readonly handle: string;
 }
 interface IdentityMethods {
   loadCurrent(options?: {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<Profile$1 | null>>;
-  /** Complete the Person profile. A normalized, globally unique username is required. */
+  /** Complete the Person profile. A normalized, globally unique handle is required. */
   completeProfile(profile: CompleteProfileInput, options?: {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<Profile$1>>;
   /**
-   * #1062: availability probe for the username the user is typing. Returns the
+   * #1062: availability probe for the handle the user is typing. Returns the
    * canonical stored form so the UI can echo it.
    */
-  usernameAvailable(username: string, options?: {
+  handleAvailable(handle: string, options?: {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<{
     readonly available: boolean;
@@ -1096,22 +1098,22 @@ type TargetReference = {
   readonly kind: "email";
   readonly email: string;
 } | {
-  readonly kind: "organization";
-  readonly handle: string;
-} | {
-  readonly kind: "payee";
-  readonly id: string;
+  readonly kind: "address";
+  readonly address: Address$1;
 } | {
   readonly kind: "party";
   readonly partyId: PartyId;
-} | {
-  readonly kind: "destination";
-  readonly id: string;
 };
 interface ResolvedTarget {
   readonly reference: TargetReference;
   readonly label: string;
-  readonly kind: "person" | "organization" | "payee" | "destination";
+  readonly status: RecipientResolution["status"];
+  readonly kind: "person" | "organization" | "external_address" | "unresolved";
+  readonly safeAddress: Address$1;
+  readonly isCapxulAccount: boolean;
+  readonly partyId?: PartyId;
+  readonly handle?: string;
+  readonly requiresAcknowledgement?: true;
   readonly capabilities: {
     readonly canPay: boolean;
     readonly canRequest: boolean;
@@ -1123,7 +1125,6 @@ interface TargetsMethods {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<ResolvedTarget>>;
 }
-type RecipientResolutionKind = "email" | "org" | "payee";
 type Ref$1 = {
   readonly kind: "handle";
   readonly handle: string;
@@ -1131,14 +1132,8 @@ type Ref$1 = {
   readonly kind: "email";
   readonly email: string;
 } | {
-  readonly kind: "orgHandle";
-  readonly orgHandle: string;
-} | {
-  readonly kind: "capxulUserId";
-  readonly capxulUserId: string;
-} | {
-  readonly kind: "payeeId";
-  readonly payeeId: string;
+  readonly kind: "address";
+  readonly address: Address$1;
 } | {
   readonly kind: "party";
   readonly partyId: PartyId;
@@ -1157,24 +1152,19 @@ interface DepositInstructions {
   readonly label: string;
 }
 interface RecipientResolution {
-  readonly kind: RecipientResolutionKind;
-  readonly recipient: string;
+  readonly status: "known_party" | "new_email" | "external_address";
+  readonly kind: "party" | "email" | "external_address";
+  readonly locatorKind: Ref$1["kind"];
+  readonly recipient: Ref$1;
   readonly label: string;
   readonly safeAddress: string;
-  readonly payeeId?: string;
-  readonly orgId?: string;
+  readonly isCapxulAccount: boolean;
+  readonly partyId?: string;
+  readonly partyKind?: "person" | "org";
   readonly handle?: string;
   readonly email?: string;
-}
-interface Payee {
-  readonly payeeId: string;
-  readonly label: string;
-  readonly recipientRef: string;
-  readonly handle: string | null;
-  readonly destinationKind: "email" | "org" | "payeeHandle";
-  readonly safeAddress: string;
-  readonly createdAt: number;
-  readonly updatedAt: number;
+  readonly address?: string;
+  readonly requiresAcknowledgement?: true;
 }
 interface MeMethods {
   get(options?: {
@@ -1184,26 +1174,6 @@ interface MeMethods {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<DepositInstructions>>;
 }
-interface HandlesMethods {
-  resolve(handle: string, options?: {
-    readonly signal?: AbortSignal;
-  }): Promise<CapxulResult<RecipientResolution>>;
-}
-interface PayeesMethods {
-  create(input: {
-    readonly label: string;
-    readonly recipient: string;
-    readonly handle?: string;
-  }, options?: {
-    readonly signal?: AbortSignal;
-  }): Promise<CapxulResult<Payee>>;
-  get(payeeId: string, options?: {
-    readonly signal?: AbortSignal;
-  }): Promise<CapxulResult<Payee | null>>;
-  resolve(recipient: string, options?: {
-    readonly signal?: AbortSignal;
-  }): Promise<CapxulResult<RecipientResolution>>;
-}
 interface PaymentMoney {
   readonly currency: string;
   readonly value: string;
@@ -1243,14 +1213,21 @@ interface Payment {
     readonly transactionHash: string;
   } | null;
   readonly recipient: {
-    readonly kind: "handle" | "email" | "payee" | "capxulUserId" | "me" | "org" | "party" | "external_address";
+    readonly kind: "party";
+    readonly partyId: string;
+    readonly label: string;
+  } | {
+    readonly kind: "external_address";
     readonly label: string;
-    readonly payeeId?: string;
   };
   readonly documents: readonly PaymentDocumentRef[];
   readonly timing: PaymentTiming;
   readonly released: PaymentMoney;
   readonly availableToClaim: PaymentMoney;
+  readonly execution?: {
+    readonly status: PaymentExecutionStatus;
+    readonly retryRequired: boolean;
+  };
   readonly createdAt: number;
   readonly updatedAt: number;
 }
@@ -1258,6 +1235,7 @@ interface PaymentsPayInput {
   readonly actor?: ActorReference;
   readonly to: TargetReference;
   readonly amount: PaymentMoney;
+  readonly externalAddressAcknowledged?: true;
   /**
    * How the payment is classified on the ledger. When a `document` is
    * attached, the type derived from the document kind is AUTHORITATIVE
@@ -1471,6 +1449,9 @@ interface PaymentActivityEvidence {
   readonly transactionHash: string;
   readonly blockNumber: number;
   readonly blockHash: string;
+  readonly inclusion: "included";
+  readonly verification: "verified";
+  /** @deprecated Use `inclusion` and `verification`. */
   readonly finality: "finalized";
   readonly paymentEventLogIndex: number | null;
   readonly transferLogIndex: number;
@@ -1491,6 +1472,9 @@ interface MovementActivityEvidence {
   readonly transactionHash: string;
   readonly blockNumber: number;
   readonly blockHash: string;
+  readonly inclusion: "included";
+  readonly verification: "verified";
+  /** @deprecated Use `inclusion` and `verification`. */
   readonly canonicalState: "finalized";
   readonly transferLogIndex: number;
   readonly source: string;
@@ -1602,6 +1586,9 @@ interface PaymentsMethods {
   pay(input: PaymentsPayInput, options?: {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<Payment>>;
+  retry(paymentId: string, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<CapxulResult<readonly Payment[]>>;
   createCommitment(input: PaymentsPayInput & {
     readonly timing: Exclude<PaymentTiming, {
       readonly kind: "instant";
@@ -1643,8 +1630,6 @@ interface PaymentDocumentsMethods {
 }
 interface FinancialOpsMethods {
   readonly me: MeMethods;
-  readonly handles: HandlesMethods;
-  readonly payees: PayeesMethods;
   readonly targets: TargetsMethods;
   readonly destinations: DestinationsMethods;
   readonly payments: PaymentsMethods;
@@ -1879,18 +1864,31 @@ type PersonOnboardingInput = CompleteProfileInput;
 type ReadyAccountLifecycle = Extract<AccountLifecycle, {
   readonly status: "ready";
 }>;
-type CompletedPersonProfile = Omit<Profile$1, "displayName" | "username"> & {
+type CompletedPersonProfile = Omit<Profile$1, "displayName" | "handle"> & {
   readonly displayName: string;
-  readonly username: string;
+  readonly handle: string;
 };
 interface PersonOnboarding {
   readonly profile: CompletedPersonProfile;
   readonly account: ReadyAccountLifecycle;
 }
+interface OrganizationOnboardingInput {
+  readonly name: string;
+  readonly handle: string;
+  readonly country: string;
+  readonly bio?: string;
+  readonly size?: string;
+}
+interface OrganizationOnboarding {
+  readonly organizationId: string;
+}
 interface OnboardingMethods {
   completePerson(input: PersonOnboardingInput, options?: {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<PersonOnboarding>>;
+  completeOrganization(input: OrganizationOnboardingInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<CapxulResult<OrganizationOnboarding>>;
 }
 //#endregion
 //#region src/surface/accounts.d.ts
@@ -2023,6 +2021,8 @@ type PermissionAssignInput = {
   readonly requestKey: string;
   readonly permissionId: string;
   readonly accountId: string;
+  /** Bind a staff activation to the invited Person at the backend authority boundary. */
+  readonly expectedMemberEmail?: string;
 };
 type PermissionRevokeInput = {
   readonly requestKey: string;
@@ -2045,6 +2045,7 @@ interface PermissionMethods {
 interface OrganizationPaymentItemInput {
   readonly to: Ref$1;
   readonly amount: PaymentMoney;
+  readonly externalAddressAcknowledged?: true;
   readonly paymentType?: PaymentType;
   readonly document?: AttachablePaymentDocumentEnvelopeV1;
 }
@@ -2064,6 +2065,9 @@ interface OrganizationPaymentsMethods {
   payBatch(input: OrganizationPaymentBatchInput, options?: {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<readonly Payment[]>>;
+  retry(paymentId: string, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<CapxulResult<readonly Payment[]>>;
 }
 //#endregion
 //#region src/surface/payroll.d.ts
@@ -2202,6 +2206,7 @@ interface PayrollMethods {
 type MemberStatus = "pending" | "pending_safe" | "pending_grant" | "active" | "revoked" | "expired";
 /** One Organization that the current user can access. */
 type OrgView = {
+  readonly creationSource?: TesterKind;
   readonly id: OrgId;
   readonly name: string;
   readonly handle: string;
@@ -2533,7 +2538,7 @@ type IdentityRuntimeSendResult = {
 type IdentityProfileDetails = {
   readonly displayName: string;
   readonly country: string;
-  readonly username?: string;
+  readonly handle: string;
 };
 interface IdentityRuntime {
   readonly snapshot: () => IdentityState;
@@ -2570,8 +2575,6 @@ interface CapxulClient {
   readonly accounts: AccountsMethods;
   readonly currentUser: CurrentUserMethods;
   readonly me: MeMethods;
-  readonly handles: HandlesMethods;
-  readonly payees: PayeesMethods;
   readonly targets: TargetsMethods;
   readonly destinations: DestinationsMethods;
   /**
@@ -2631,6 +2634,7 @@ interface CapxulClient {
     readonly organizationSetup: OrganizationSetupProofMethods;
     /** Product telemetry projection for internal composition and test harnesses. */
     readonly telemetry?: TelemetryPort;
+    readonly captureExternalAddressAcknowledged: (address: string, organizationId?: string) => void;
     readonly close?: () => Promise<void>;
   };
 }
@@ -2825,4 +2829,4 @@ interface ObservationAdapter {
 /** 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 { OrganizationPaymentsMethods as $, TelemetryGroupInput as $n, DestinationRail as $t, OrgView as A, ResolvedTarget as An, InboxItem as At, PayrollGroupInput as B, AuthMethods as Bn, ActivityPage as Bt, DetectPendingOrgInvitationsResult as C, PaymentTiming as Cn, ActorRequestIssueInput as Ct, OrgMethods as D, RecipientResolution as Dn, AddressBookLabelInput as Dt, MemberView as E, PaymentsPayInput as En, AddressBookEntry as Et, RoleSpendCap as F, AccountSetupStep as Fn, ActivityFilter as Ft, PayrollRun as G, Permission as Gn, ActivitySummaryTotal as Gt, PayrollGroupsMethods as H, OrgSetupStep as Hn, ActivityReference as Ht, RoleView as I, isSettingUpLifecycle as In, ActivityItem as It, PayrollRuns as J, PAYMENT_DIRECTIONS as Jn, Destination as Jt, PayrollRunItemInput as K, SubmittedPermissionExecution as Kn, ActorReference as Kt, AuthorizeRunInput as L, CompleteProfileInput as Ln, ActivityKind as Lt, OrganizationAuditLogItem as M, TargetsMethods as Mn, ActivityAnnotation as Mt, ResendInviteTokenInput as N, fingerprintPaymentIntent as Nn, ActivityAnnotationInput as Nt, OrgScopedMethods as O, RecipientResolutionKind as On, AddressBookMethods as Ot, RoleDefinition as P, AccountLifecycle as Pn, ActivityDetail as Pt, OrganizationPaymentItemInput as Q, TelemetryEvent as Qn, DestinationPayload as Qt, PayrollEngagementTerms as R, IdentityMethods as Rn, ActivityListParams as Rt, CreateOrgInput as S, PaymentStatus as Sn, ActorRequest as St, MemberStatus as T, PaymentsMethods as Tn, AddressBookAddInput as Tt, PayrollMethods as U, ActorRef as Un, ActivitySummary as Ut, PayrollGroupMember as V, OrgLifecycle as Vn, ActivityRange as Vt, PayrollOptions as W, CurrentHoldings as Wn, ActivitySummaryParams as Wt, OrganizationPaymentBatchInput as X, PaymentStatus$1 as Xn, DestinationKind as Xt, PayrollTermsUnit as Y, PAYMENT_STATUSES as Yn, DestinationAddInput as Yt, OrganizationPaymentInput as Z, RequestStatus as Zn, DestinationListInput as Zt, SystemMethods as _, PaymentDocumentRef as _n, ReadyAccountLifecycle as _t, SdkFailureObservation as a, MeProfile as an, OrgLane as ar, PermissionReplaceInput as at, CurrentUserContext as b, PaymentDocumentsMethods as bn, ActorProfileMethods as bt, PostHogObservabilityOptions as c, OfframpQuote as cn, destination as cr, Budget as ct, CreateCapxulClientInput as d, Payee as dn, IdentityTransition as dr, OrgMeOptions as dt, DestinationRemoveInput as en, TelemetryIdentifyInput as er, PermissionAssignInput as et, IdentityProfileDetails as f, PayeesMethods as fn, InvocationControls as fr, AccountsMethods as ft, Holding as g, PaymentDocumentKind as gn, PersonOnboardingInput as gt, HoldingsMethods as h, PaymentDirection as hn, PersonOnboarding as ht, ObservationDelivery as i, MeMethods as in, IdentityState as ir, PermissionOptions as it, OrganizationAccount as j, TargetReference as jn, InboxMethods as jt, OrgTemplate as k, Ref$1 as kn, InboxApproveInput as kt, postHogObservability as l, OfframpQuoteInput as ln, isClaimed as lr, OrgMe as lt, IdentityRuntimeSendResult as m, PaymentActivityEvidence as mn, OnboardingMethods as mt, ObservationAdapter as n, FinancialOpsMethods as nn, Destination$1 as nr, PermissionCreateInput as nt, HostObservability as o, MovementActivityEvidence as on, Readiness as or, PermissionRevokeInput as ot, IdentityRuntime as p, Payment as pn, CompletedPersonProfile as pt, PayrollRunStatus as q, InboxStatus as qn, DepositInstructions as qt, ObservationContext as r, HandlesMethods as rn, IdentityEvent as rr, PermissionMethods as rt, PostHogObservabilityClient as s, OfframpMethods as sn, StateLabel as sr, PermissionReadResult as st, CAPXUL_SDK_EXPECTED_OUTCOME_EVENT as t, DestinationsMethods as tn, TelemetryPort as tr, PermissionChangeInput as tt, CapxulClient as u, OfframpStatus as un, isRestoring as ur, OrgMeMethod as ut, SystemHealth as v, PaymentDocumentRender as vn, AccountMethods as vt, InviteMemberInput as w, PaymentType as wn, ActorRequestsMethods as wt, CurrentUserMethods as x, PaymentMoney as xn, ActorRelationshipMethods as xt, MediaMethods as y, PaymentDocumentVerification as yn, ActorProfile as yt, PayrollGroup as z, SmartAccountMethods as zn, ActivityMethods as zt };
+export { OrganizationPaymentsMethods as $, TelemetryPort as $n, DestinationListInput as $t, OrgView as A, TargetsMethods as An, AddressBookMethods as At, PayrollGroupInput as B, OrgSetupStep as Bn, ActivityListParams as Bt, DetectPendingOrgInvitationsResult as C, PaymentType as Cn, ActorRelationshipMethods as Ct, OrgMethods as D, Ref$1 as Dn, AddressBookAddInput as Dt, MemberView as E, RecipientResolution as En, ActorRequestsMethods as Et, RoleSpendCap as F, CompleteProfileInput as Fn, ActivityAnnotationInput as Ft, PayrollRun as G, InboxStatus as Gn, ActivitySummary as Gt, PayrollGroupsMethods as H, CurrentHoldings as Hn, ActivityPage as Ht, RoleView as I, IdentityMethods as In, ActivityDetail as It, PayrollRuns as J, PaymentStatus$1 as Jn, ActorReference as Jt, PayrollRunItemInput as K, PAYMENT_DIRECTIONS as Kn, ActivitySummaryParams as Kt, AuthorizeRunInput as L, SmartAccountMethods as Ln, ActivityFilter as Lt, OrganizationAuditLogItem as M, AccountLifecycle as Mn, InboxItem as Mt, ResendInviteTokenInput as N, AccountSetupStep as Nn, InboxMethods as Nt, OrgScopedMethods as O, ResolvedTarget as On, AddressBookEntry as Ot, RoleDefinition as P, isSettingUpLifecycle as Pn, ActivityAnnotation as Pt, OrganizationPaymentItemInput as Q, TelemetryIdentifyInput as Qn, DestinationKind as Qt, PayrollEngagementTerms as R, AuthMethods as Rn, ActivityItem as Rt, CreateOrgInput as S, PaymentTiming as Sn, ActorProfileMethods as St, MemberStatus as T, PaymentsPayInput as Tn, ActorRequestIssueInput as Tt, PayrollMethods as U, Permission as Un, ActivityRange as Ut, PayrollGroupMember as V, ActorRef as Vn, ActivityMethods as Vt, PayrollOptions as W, SubmittedPermissionExecution as Wn, ActivityReference as Wt, OrganizationPaymentBatchInput as X, TelemetryEvent as Xn, Destination as Xt, PayrollTermsUnit as Y, RequestStatus as Yn, DepositInstructions as Yt, OrganizationPaymentInput as Z, TelemetryGroupInput as Zn, DestinationAddInput as Zt, SystemMethods as _, PaymentDocumentRender as _n, PersonOnboarding as _t, SdkFailureObservation as a, MeMethods as an, StateLabel as ar, PermissionReplaceInput as at, CurrentUserContext as b, PaymentMoney as bn, AccountMethods as bt, PostHogObservabilityOptions as c, OfframpMethods as cn, isRestoring as cr, Budget as ct, CreateCapxulClientInput as d, OfframpStatus as dn, OrgMeOptions as dt, DestinationPayload as en, Destination$1 as er, PermissionAssignInput as et, IdentityProfileDetails as f, Payment as fn, AccountsMethods as ft, Holding as g, PaymentDocumentRef as gn, OrganizationOnboardingInput as gt, HoldingsMethods as h, PaymentDocumentKind as hn, OrganizationOnboarding as ht, ObservationDelivery as i, FinancialOpsMethods as in, Readiness as ir, PermissionOptions as it, OrganizationAccount as j, fingerprintPaymentIntent as jn, InboxApproveInput as jt, OrgTemplate as k, TargetReference as kn, AddressBookLabelInput as kt, postHogObservability as l, OfframpQuote as ln, IdentityTransition as lr, OrgMe as lt, IdentityRuntimeSendResult as m, PaymentDirection as mn, OnboardingMethods as mt, ObservationAdapter as n, DestinationRemoveInput as nn, IdentityState as nr, PermissionCreateInput as nt, HostObservability as o, MeProfile as on, destination as or, PermissionRevokeInput as ot, IdentityRuntime as p, PaymentActivityEvidence as pn, CompletedPersonProfile as pt, PayrollRunStatus as q, PAYMENT_STATUSES as qn, ActivitySummaryTotal as qt, ObservationContext as r, DestinationsMethods as rn, OrgLane as rr, PermissionMethods as rt, PostHogObservabilityClient as s, MovementActivityEvidence as sn, isClaimed as sr, PermissionReadResult as st, CAPXUL_SDK_EXPECTED_OUTCOME_EVENT as t, DestinationRail as tn, IdentityEvent as tr, PermissionChangeInput as tt, CapxulClient as u, OfframpQuoteInput as un, InvocationControls as ur, OrgMeMethod as ut, SystemHealth as v, PaymentDocumentVerification as vn, PersonOnboardingInput as vt, InviteMemberInput as w, PaymentsMethods as wn, ActorRequest as wt, CurrentUserMethods as x, PaymentStatus as xn, ActorProfile as xt, MediaMethods as y, PaymentDocumentsMethods as yn, ReadyAccountLifecycle as yt, PayrollGroup as z, OrgLifecycle as zn, ActivityKind as zt };

package/dist/{signer-DOqb8M1Y.d.mts → signer-C0hZ6Kiy.d.mts}

@@ -276,14 +276,16 @@ type Brand<T, B extends string> = T & {
 //#region ../types/src/index.d.ts
 type Address$1 = Brand<string, "Address">;
 type Email = Brand<string, "Email">;
+type TesterKind = "human" | "e2e" | "agent";
 type Profile$1 = {
+  readonly testerKind?: TesterKind;
   readonly authUserId: AuthUserId;
   readonly email: Email;
   readonly displayName: string | null;
   readonly country: CountryCode | null;
   readonly onboarded: boolean;
   readonly withdrawalAddress: Address$1 | null;
-  readonly username: string | null;
+  readonly handle: Handle | null;
   readonly imageUrl: string | null;
   readonly kycTier: KycTier;
   readonly createdAt: EpochMs;
@@ -312,6 +314,8 @@ type AuthUserId = Brand<string, "AuthUserId">;
 type AnonymousDistinctId = Brand<string, "AnonymousDistinctId">;
 type AccountId = Brand<string, "AccountId">;
 type PartyId = Brand<string, "PartyId">;
+/** One globally unique public name for a claimed person or Organization Party. */
+type Handle = Brand<string, "Handle">;
 type PermissionId = Brand<string, "PermissionId">;
 type PermissionAssignmentId = Brand<string, "PermissionAssignmentId">;
 type BudgetId = Brand<string, "BudgetId">;
@@ -343,6 +347,7 @@ type AuthSession = {
   readonly token: SessionToken;
   readonly expiresAt: EpochMs;
 };
+declare const EVM_ADDRESS_RE: RegExp;
 declare const SUPPORTED_CURRENCIES: readonly [{
   readonly code: "USD";
   readonly symbol: "$";
@@ -366,6 +371,8 @@ declare const SUPPORTED_CURRENCIES: readonly [{
 }];
 type SupportedCurrencyCode = (typeof SUPPORTED_CURRENCIES)[number]["code"];
 declare function toAddress(raw: unknown): Address$1;
+declare function toPartyId(raw: unknown): PartyId;
+declare function toHandle(raw: unknown): Handle;
 declare function toCountryCode(raw: unknown): CountryCode;
 //#endregion
 //#region src/ports/auth-cache.d.ts
@@ -594,4 +601,4 @@ interface Eip1193RequestProvider {
  */
 declare function injectedWalletSigner(provider: Eip1193RequestProvider): CapxulSigner;
 //#endregion
-export { SessionToken as $, AppId as A, Email as B, CachedJwt as C, AllowanceKey as D, Address$1 as E, ChainId as F, PaymentCommandId as G, Money as H, CountryCode as I, PermissionAssignmentId as J, PayrollGroupId as K, CurrencyCode as L, AuthUserId as M, BlockNumber as N, AllowedOrigin as O, BudgetId as P, RoleKey as Q, DocumentHash as R, AuthCachePortTag as S, AccountId as T, OrgId as U, EpochMs as V, PartyId as W, Profile$1 as X, PermissionId as Y, PublishableKey as Z, ClockPort as _, FailureMode as _t, SignerStatusStore as a, CAPXUL_PAYMENTS_V2_ADDRESS as at, AuthCacheError as b, AccountProviderSource as c, CapxulErrorCode as ct, eip1193AccountProvider as d, Failure as dt, SmartAccount$1 as et, localPrivateKeyAccountProvider as f, isCapxulError as ft, SmartAccount as g, FAILURE_MODES as gt, Session as h, ChainUpstream as ht, SignerStatus as i, toCountryCode as it, AuthSession as j, AnonymousDistinctId as k, AccountRequirement as l, CapxulErrorDetails as lt, Profile as m, ChainCause as mt, CapxulSigner as n, WeiAmount as nt, injectedWalletSigner as o, CAPXUL_ERROR_CODES as ot, CapxulResult as p, CHAIN_UPSTREAMS as pt, PayrollRunId as q, Eip1193RequestProvider as r, toAddress as rt, AccountProvider as s, CapxulError as st, CapxulDigestSigner as t, TxHash as tt, Eip1193Provider as u, Errors as ut, AuthClientPort as v, RevertSummary as vt, Account$1 as w, AuthCachePort as x, CanSendOtpStatus as y, DurationMs as z };
+export { PublishableKey as $, AppId as A, EVM_ADDRESS_RE as B, CachedJwt as C, RevertSummary as Ct, AllowanceKey as D, Address$1 as E, ChainId as F, OrgId as G, EpochMs as H, CountryCode as I, PayrollGroupId as J, PartyId as K, CurrencyCode as L, AuthUserId as M, BlockNumber as N, AllowedOrigin as O, BudgetId as P, Profile$1 as Q, DocumentHash as R, AuthCachePortTag as S, FailureMode as St, AccountId as T, Handle as U, Email as V, Money as W, PermissionAssignmentId as X, PayrollRunId as Y, PermissionId as Z, ClockPort as _, isCapxulError as _t, SignerStatusStore as a, WeiAmount as at, AuthCacheError as b, ChainUpstream as bt, AccountProviderSource as c, toHandle as ct, eip1193AccountProvider as d, CAPXUL_ERROR_CODES as dt, RoleKey as et, localPrivateKeyAccountProvider as f, CapxulError as ft, SmartAccount as g, Failure as gt, Session as h, Errors as ht, SignerStatus as i, TxHash as it, AuthSession as j, AnonymousDistinctId as k, AccountRequirement as l, toPartyId as lt, Profile as m, CapxulErrorDetails as mt, CapxulSigner as n, SmartAccount$1 as nt, injectedWalletSigner as o, toAddress as ot, CapxulResult as p, CapxulErrorCode as pt, PaymentCommandId as q, Eip1193RequestProvider as r, TesterKind as rt, AccountProvider as s, toCountryCode as st, CapxulDigestSigner as t, SessionToken as tt, Eip1193Provider as u, CAPXUL_PAYMENTS_V2_ADDRESS as ut, AuthClientPort as v, CHAIN_UPSTREAMS as vt, Account$1 as w, AuthCachePort as x, FAILURE_MODES as xt, CanSendOtpStatus as y, ChainCause as yt, DurationMs as z };

package/dist/testing/index.d.mts

@@ -1,4 +1,4 @@
-import { $n as TelemetryGroupInput, Qn as TelemetryEvent, dr as IdentityTransition, er as TelemetryIdentifyInput, n as ObservationAdapter, u as CapxulClient } from "../observation-B76zFxd6.mjs";
+import { Qn as TelemetryIdentifyInput, Xn as TelemetryEvent, Zn as TelemetryGroupInput, lr as IdentityTransition, n as ObservationAdapter, u as CapxulClient } from "../observation-DtzTdv20.mjs";
 import { Effect, Layer } from "effect";
 //#region src/testing/telemetry/RecordingTelemetryAdapter.d.ts
 type RecordingTelemetryOperation = {

package/dist/testing/index.mjs

@@ -1,5 +1,5 @@
-import { M as fromWei, Z as redactTelemetryEvent, f as identityErrorFromCapxul, g as bootstrapErrorFromCapxul, i as smartAccountErrorFromCapxul, m as convexCallErrorFromCapxul, o as accountReadErrorFromCapxul, t as assembleCapxulClient, u as wireChainId, v as toWei } from "../create-capxul-client-BCq08ppe.mjs";
-import { D as toAllowedOrigin, E as toAddress, F as toEmail, I as toEpochMs, K as toSessionToken, L as toEpochSeconds, M as toCountryCode, O as toAppId, P as toDurationMs, R as toJwtToken, T as toAccountId, W as toPublishableKey, Y as CapxulError, Z as Errors, _ as deriveCapxulSafeAddress, j as toChainId, k as toAuthUserId, n as InMemoryAuthCacheAdapter, t as readClockNow, u as authClientPortFromPromiseAdapter, z as toKycTier } from "../clock-CWpcQlLy.mjs";
+import { M as fromWei, Z as redactTelemetryEvent, f as identityErrorFromCapxul, g as bootstrapErrorFromCapxul, i as smartAccountErrorFromCapxul, m as convexCallErrorFromCapxul, o as accountReadErrorFromCapxul, t as assembleCapxulClient, u as wireChainId, v as toWei } from "../create-capxul-client-5Bk0PS0R.mjs";
+import { $ as CapxulError, A as toAuthUserId, B as toJwtToken, D as toAddress, E as toAccountId, F as toDurationMs, I as toEmail, J as toSessionToken, K as toPublishableKey, L as toEpochMs, M as toChainId, N as toCountryCode, O as toAllowedOrigin, R as toEpochSeconds, V as toKycTier, _ as deriveCapxulSafeAddress, k as toAppId, n as InMemoryAuthCacheAdapter, t as readClockNow, tt as Errors, u as authClientPortFromPromiseAdapter, v as validateHandle, z as toHandle } from "../clock-C2AUlq1V.mjs";
 import { Effect, Result, Semaphore } from "effect";
 import { keccak256 } from "viem";
 import { getFunctionName } from "convex/server";
@@ -506,7 +506,7 @@ var InMemoryIdentityAdapter = class {
 				country: input.country ?? null,
 				onboarded: false,
 				withdrawalAddress: null,
-				username: null,
+				handle: null,
 				imageUrl: null,
 				kycTier: toKycTier(0),
 				createdAt: now,
@@ -531,7 +531,7 @@ var InMemoryIdentityAdapter = class {
 				country: input.country !== void 0 ? input.country : existing.country,
 				onboarded: existing.onboarded,
 				withdrawalAddress: existing.withdrawalAddress,
-				username: existing.username,
+				handle: existing.handle,
 				imageUrl: existing.imageUrl,
 				updatedAt: now
 			};
@@ -551,7 +551,7 @@ var InMemoryIdentityAdapter = class {
 				country: input.country,
 				onboarded: true,
 				withdrawalAddress: input.withdrawalAddress ?? existing?.withdrawalAddress ?? null,
-				username: input.username ?? existing?.username ?? null,
+				handle: toHandle(validateHandle(input.handle)),
 				imageUrl: existing?.imageUrl ?? null,
 				kycTier: existing?.kycTier ?? toKycTier(0),
 				createdAt: existing?.createdAt ?? now,
@@ -576,7 +576,7 @@ function cloneProfile(profile) {
 		country: profile.country,
 		onboarded: profile.onboarded,
 		withdrawalAddress: profile.withdrawalAddress,
-		username: profile.username,
+		handle: profile.handle,
 		imageUrl: profile.imageUrl,
 		kycTier: profile.kycTier,
 		createdAt: profile.createdAt,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/sdk",
-  "version": "3.2.0",
+  "version": "4.0.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Xelmar-tech/infrastructure.git",
@@ -47,12 +47,12 @@
     "vite": "npm:@voidzero-dev/vite-plus-core@0.3.0",
     "vite-plus": "0.3.0",
     "vitest": "4.1.11",
-    "@capxul/config": "0.2.3",
-    "@capxul/errors": "0.2.0",
-    "@capxul/observability": "3.2.0",
-    "@capxul/types": "0.2.3",
+    "@capxul/config": "0.3.0",
+    "@capxul/errors": "0.3.0",
     "@capxul/typescript-config": "0.0.0",
-    "@capxul/wire": "0.6.0"
+    "@capxul/wire": "0.7.0",
+    "@capxul/types": "0.3.0",
+    "@capxul/observability": "4.0.1"
   },
   "_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": {