@capxul/sdk 3.1.0 → 4.0.0

package/dist/node/index.mjs

@@ -1,5 +1,5 @@
-import { E as toAddress, a as parseCachedJwt, i as parseAuthSession, n as InMemoryAuthCacheAdapter, o as AuthCacheError, r as BrowserAuthCacheAdapter, s as AuthCachePortTag } from "../clock-m_aHLaNm.mjs";
-import { t as oauthBearerAuthClient } from "../OAuthBearerAuthClient-DfS4QOg7.mjs";
+import { D as toAddress, a as parseCachedJwt, i as parseAuthSession, n as InMemoryAuthCacheAdapter, o as AuthCacheError, r as BrowserAuthCacheAdapter, s as AuthCachePortTag } from "../clock-C2AUlq1V.mjs";
+import { t as oauthBearerAuthClient } from "../OAuthBearerAuthClient-BHvDR8_0.mjs";
 import { Effect, FileSystem, Layer, Path } from "effect";
 import { privateKeyToAccount } from "viem/accounts";
 import * as os from "node:os";

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

@@ -1,6 +1,6 @@
-import { $ as RoleKey, A as AnonymousDistinctId, B as DurationMs, D as Address$1, F as BudgetId, G as PartyId, H as EpochMs, I as ChainId, J as PayrollRunId, K as PaymentCommandId, L as CountryCode, M as AuthSession, N as AuthUserId, O as AllowanceKey, P as BlockNumber, Q as PublishableKey, R as CurrencyCode, T as Account$1, U as Money, V as Email, W as OrgId, X as PermissionId, Y as PermissionAssignmentId, Z as Profile, _ as ClockPort, _t as FailureMode, a as SignerStatusStore, c as AccountProviderSource, ct as CapxulErrorCode, dt as Failure, et as SessionToken, g as SmartAccount$1, h as Session$1, j as AppId, k as AllowedOrigin, l as AccountRequirement, lt as CapxulErrorDetails, m as Profile$1, n as CapxulSigner, nt as TxHash, p as CapxulResult, q as PayrollGroupId, rt as WeiAmount, st as CapxulError, tt as SmartAccount, v as AuthClientPort, x as AuthCachePort, y as CanSendOtpStatus, z as DocumentHash } from "./signer-BpjdawiY.mjs";
-import { Hex } from "viem";
+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";
 //#region src/domain/machine/shell.d.ts
 declare const INVOCATION_PARENT_SPAN: unique symbol;
@@ -260,6 +260,7 @@ declare const isClaimed: (state: IdentityState) => boolean;
  */
 interface HandledErrorReportContext {
   readonly layer?: string;
+  /** Host input is normalized at the reporting boundary. */
   readonly operation?: string;
   readonly failure_mode?: FailureMode;
   readonly provider?: string;
@@ -278,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 = {
@@ -322,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];
@@ -721,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";
@@ -1016,15 +1019,24 @@ interface SmartAccountMethods {
 }
 //#endregion
 //#region src/surface/identity.d.ts
+interface CompleteProfileInput {
+  readonly displayName: string;
+  readonly country: string;
+  readonly handle: string;
+}
 interface IdentityMethods {
   loadCurrent(options?: {
     readonly signal?: AbortSignal;
   }): Promise<CapxulResult<Profile$1 | null>>;
+  /** 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;
@@ -1086,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;
@@ -1113,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;
@@ -1121,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;
@@ -1147,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?: {
@@ -1174,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;
@@ -1233,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;
 }
@@ -1248,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
@@ -1461,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;
@@ -1481,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;
@@ -1592,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";
@@ -1633,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;
@@ -1864,6 +1859,38 @@ interface AccountInternalSurface {
   retryProvisioning(): Promise<CapxulResult<ProvisioningPhase>>;
 }
 //#endregion
+//#region src/surface/onboarding.d.ts
+type PersonOnboardingInput = CompleteProfileInput;
+type ReadyAccountLifecycle = Extract<AccountLifecycle, {
+  readonly status: "ready";
+}>;
+type CompletedPersonProfile = Omit<Profile$1, "displayName" | "handle"> & {
+  readonly displayName: 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
 interface AccountsMethods {
   read(options?: {
@@ -1994,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;
@@ -2016,6 +2045,7 @@ interface PermissionMethods {
 interface OrganizationPaymentItemInput {
   readonly to: Ref$1;
   readonly amount: PaymentMoney;
+  readonly externalAddressAcknowledged?: true;
   readonly paymentType?: PaymentType;
   readonly document?: AttachablePaymentDocumentEnvelopeV1;
 }
@@ -2035,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
@@ -2173,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;
@@ -2504,7 +2538,7 @@ type IdentityRuntimeSendResult = {
 type IdentityProfileDetails = {
   readonly displayName: string;
   readonly country: string;
-  readonly username?: string;
+  readonly handle: string;
 };
 interface IdentityRuntime {
   readonly snapshot: () => IdentityState;
@@ -2516,6 +2550,7 @@ interface IdentityRuntime {
   } | {
     readonly ok: false;
     readonly reason: CapxulErrorCode;
+    readonly error?: CapxulError;
   }>;
   /** @internal Optional facade bridge for consumer test doubles. */
   readonly runFacade?: <T>(verb: IdentityFacadeVerb, controls: InvocationControls | undefined, run: (controls: InvocationControls) => Promise<T>) => Promise<T>;
@@ -2524,6 +2559,7 @@ interface CapxulClient {
   readonly auth: AuthMethods;
   readonly smartAccount: SmartAccountMethods;
   readonly identity: IdentityMethods;
+  readonly onboarding: OnboardingMethods;
   /** `health(nonce)` returns the nonce from the configured deployment. Use it to verify backend liveness before sign-in. */
   readonly system: SystemMethods;
   /**
@@ -2539,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;
   /**
@@ -2600,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>;
   };
 }
@@ -2794,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 $, OrgLane as $n, MeMethods as $t, OrgView as A, AccountSetupStep as An, ActivityFilter as At, PayrollGroupInput as B, SubmittedPermissionExecution as Bn, ActivitySummaryTotal as Bt, DetectPendingOrgInvitationsResult as C, RecipientResolutionKind as Cn, AddressBookMethods as Ct, OrgMethods as D, TargetsMethods as Dn, ActivityAnnotation as Dt, MemberView as E, TargetReference as En, InboxMethods as Et, RoleSpendCap as F, OrgLifecycle as Fn, ActivityPage as Ft, PayrollRun as G, RequestStatus as Gn, DestinationKind as Gt, PayrollGroupsMethods as H, PAYMENT_DIRECTIONS as Hn, DepositInstructions as Ht, RoleView as I, OrgSetupStep as In, ActivityRange as It, PayrollRuns as J, TelemetryIdentifyInput as Jn, DestinationRail as Jt, PayrollRunItemInput as K, TelemetryEvent as Kn, DestinationListInput as Kt, AuthorizeRunInput as L, ActorRef as Ln, ActivityReference as Lt, OrganizationAuditLogItem as M, IdentityMethods as Mn, ActivityKind as Mt, ResendInviteTokenInput as N, SmartAccountMethods as Nn, ActivityListParams as Nt, OrgScopedMethods as O, fingerprintPaymentIntent as On, ActivityAnnotationInput as Ot, RoleDefinition as P, AuthMethods as Pn, ActivityMethods as Pt, OrganizationPaymentItemInput as Q, IdentityState as Qn, HandlesMethods as Qt, PayrollEngagementTerms as R, CurrentHoldings as Rn, ActivitySummary as Rt, CreateOrgInput as S, RecipientResolution as Sn, AddressBookLabelInput as St, MemberStatus as T, ResolvedTarget as Tn, InboxItem as Tt, PayrollMethods as U, PAYMENT_STATUSES as Un, Destination as Ut, PayrollGroupMember as V, InboxStatus as Vn, ActorReference as Vt, PayrollOptions as W, PaymentStatus$1 as Wn, DestinationAddInput as Wt, OrganizationPaymentBatchInput as X, Destination$1 as Xn, DestinationsMethods as Xt, PayrollTermsUnit as Y, TelemetryPort as Yn, DestinationRemoveInput as Yt, OrganizationPaymentInput as Z, IdentityEvent as Zn, FinancialOpsMethods as Zt, SystemMethods as _, PaymentStatus as _n, ActorRequest as _t, SdkFailureObservation as a, OfframpStatus as an, IdentityTransition as ar, PermissionReplaceInput as at, CurrentUserContext as b, PaymentsMethods as bn, AddressBookAddInput as bt, PostHogObservabilityOptions as c, Payment as cn, Budget as ct, CreateCapxulClientInput as d, PaymentDocumentKind as dn, OrgMeOptions as dt, MeProfile as en, Readiness as er, PermissionAssignInput as et, IdentityProfileDetails as f, PaymentDocumentRef as fn, AccountsMethods as ft, Holding as g, PaymentMoney as gn, ActorRelationshipMethods as gt, HoldingsMethods as h, PaymentDocumentsMethods as hn, ActorProfileMethods as ht, ObservationDelivery as i, OfframpQuoteInput as in, isRestoring as ir, PermissionOptions as it, OrganizationAccount as j, isSettingUpLifecycle as jn, ActivityItem as jt, OrgTemplate as k, AccountLifecycle as kn, ActivityDetail as kt, postHogObservability as l, PaymentActivityEvidence as ln, OrgMe as lt, IdentityRuntimeSendResult as m, PaymentDocumentVerification as mn, ActorProfile as mt, ObservationAdapter as n, OfframpMethods as nn, destination as nr, PermissionCreateInput as nt, HostObservability as o, Payee as on, InvocationControls as or, PermissionRevokeInput as ot, IdentityRuntime as p, PaymentDocumentRender as pn, AccountMethods as pt, PayrollRunStatus as q, TelemetryGroupInput as qn, DestinationPayload as qt, ObservationContext as r, OfframpQuote as rn, isClaimed as rr, PermissionMethods as rt, PostHogObservabilityClient as s, PayeesMethods as sn, PermissionReadResult as st, CAPXUL_SDK_EXPECTED_OUTCOME_EVENT as t, MovementActivityEvidence as tn, StateLabel as tr, PermissionChangeInput as tt, CapxulClient as u, PaymentDirection as un, OrgMeMethod as ut, SystemHealth as v, PaymentTiming as vn, ActorRequestIssueInput as vt, InviteMemberInput as w, Ref$1 as wn, InboxApproveInput as wt, CurrentUserMethods as x, PaymentsPayInput as xn, AddressBookEntry as xt, MediaMethods as y, PaymentType as yn, ActorRequestsMethods as yt, PayrollGroup as z, Permission as zn, ActivitySummaryParams 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-BpjdawiY.d.mts → signer-C0hZ6Kiy.d.mts}

@@ -1,5 +1,5 @@
-import { Account, Address, Hex } from "viem";
 import { Context, Effect } from "effect";
+import { Account, Address, Hex } from "viem";
 //#region ../errors/src/chain-cause.d.ts
 /**
  * Why an operation failed — the one flat vocabulary. The first four are the
@@ -257,6 +257,10 @@ declare const Errors: {
   }) => CapxulError;
 };
 //#endregion
+//#region ../config/src/capxul-payments-v2.d.ts
+/** Immutable CapxulPaymentsV2 deployment on Base Sepolia. */
+declare const CAPXUL_PAYMENTS_V2_ADDRESS: Address;
+//#endregion
 //#region ../types/src/brand.d.ts
 /**
  * Nominal type helper. `Brand<T, B>` is structurally a `T` at runtime but
@@ -272,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;
@@ -308,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">;
@@ -339,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: "$";
@@ -362,12 +371,10 @@ 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 ../config/src/capxul-payments-v2.d.ts
-/** Immutable CapxulPaymentsV2 deployment on Base Sepolia. */
-declare const CAPXUL_PAYMENTS_V2_ADDRESS: Address;
-//#endregion
 //#region src/ports/auth-cache.d.ts
 /**
  * AuthCachePort stores the user session and the cached
@@ -594,4 +601,4 @@ interface Eip1193RequestProvider {
  */
 declare function injectedWalletSigner(provider: Eip1193RequestProvider): CapxulSigner;
 //#endregion
-export { RoleKey as $, AnonymousDistinctId as A, DurationMs as B, CachedJwt as C, Address$1 as D, AccountId as E, BudgetId as F, PartyId as G, EpochMs as H, ChainId as I, PayrollRunId as J, PaymentCommandId as K, CountryCode as L, AuthSession as M, AuthUserId as N, AllowanceKey as O, BlockNumber as P, PublishableKey as Q, CurrencyCode as R, AuthCachePortTag as S, Account$1 as T, Money as U, Email as V, OrgId as W, PermissionId as X, PermissionAssignmentId as Y, Profile$1 as Z, ClockPort as _, FailureMode as _t, SignerStatusStore as a, toCountryCode as at, AuthCacheError as b, AccountProviderSource as c, CapxulErrorCode as ct, eip1193AccountProvider as d, Failure as dt, SessionToken as et, localPrivateKeyAccountProvider as f, isCapxulError as ft, SmartAccount as g, FAILURE_MODES as gt, Session as h, ChainUpstream as ht, SignerStatus as i, toAddress as it, AppId as j, AllowedOrigin as k, AccountRequirement as l, CapxulErrorDetails as lt, Profile as m, ChainCause as mt, CapxulSigner as n, TxHash as nt, injectedWalletSigner as o, CAPXUL_ERROR_CODES as ot, CapxulResult as p, CHAIN_UPSTREAMS as pt, PayrollGroupId as q, Eip1193RequestProvider as r, WeiAmount as rt, AccountProvider as s, CapxulError as st, CapxulDigestSigner as t, SmartAccount$1 as tt, Eip1193Provider as u, Errors as ut, AuthClientPort as v, RevertSummary as vt, CAPXUL_PAYMENTS_V2_ADDRESS as w, AuthCachePort as x, CanSendOtpStatus as y, DocumentHash 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 { Jn as TelemetryIdentifyInput, Kn as TelemetryEvent, ar as IdentityTransition, n as ObservationAdapter, qn as TelemetryGroupInput, u as CapxulClient } from "../observation-B3PCugGC.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,7 +1,7 @@
-import { F as fromWei, _ as convexCallErrorFromCapxul, c as redactTelemetryEvent, h as identityErrorFromCapxul, i as smartAccountErrorFromCapxul, o as accountReadErrorFromCapxul, p as wireChainId, t as assembleCapxulClient, x as toWei, y as bootstrapErrorFromCapxul } from "../create-capxul-client-dk67qjlK.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-m_aHLaNm.mjs";
-import { keccak256 } from "viem";
+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-DyCEJZtD.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";
 //#region src/testing/account/InMemoryAccountReadAdapter.ts
 var InMemoryAccountReadAdapter = class {
@@ -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: 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.1.0",
+  "version": "4.0.0",
   "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/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/observability": "3.1.0"
+    "@capxul/observability": "4.0.0",
+    "@capxul/wire": "0.7.0",
+    "@capxul/types": "0.3.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": {