@capxul/sdk 0.1.0-alpha.2 → 0.1.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @capxul/sdk
 
+## 0.1.0-alpha.3
+
+### Patch Changes
+
+- Re-export `tryCatch` from `@capxul/sdk`.
+
+  `tryCatch` is referenced in `packages/sdk/README.md` (live on npm at
+  `0.1.0-alpha.2`) and in `.claude/rules/sdk.md` as the canonical
+  async-error helper for SDK operations:
+
+  ```ts
+  import { tryCatch } from "@capxul/sdk";
+
+  const [err, payment] = await tryCatch(capxul.payments.create({ ... }));
+  ```
+
+  The helper lives at `@repo/observability/try-catch.ts` and is bundled
+  into the SDK dist via tsup `noExternal`, but it was never re-exported
+  from `packages/sdk/src/index.ts`. Consumers following the README example
+  hit `Module '"@capxul/sdk"' has no exported member 'tryCatch'.` at
+  import time.
+
+  Caught during alpha.2 spike-install verification (REVIEW.html, "What's
+  not proven" row 6). One-line public-export addition; no runtime change.
+
 ## 0.1.0-alpha.2
 
 ### Patch Changes

package/dist/{client-CweJSkaY.d.ts → client-BI863O0y.d.ts}

@@ -2,7 +2,7 @@ import { Account as Account$1 } from 'viem';
 import { AnyStateMachine } from 'xstate';
 import { A as AccountId, S as SafeId, c as KycProfileId, b as ExternalAccountId, f as SubAccountId, d as OrganizationId, a as ApiKeyId, X as TimestampIso, D as DocumentId, O as OperationId, P as PaymentId, g as TransferId, k as WithdrawalId, W as WebhookEndpointId, j as WebhookEventId, M as MemberId, K as KybProfileId, V as VirtualAccountId, i as VirtualCardId } from './next-action-DkrwXYay.js';
 import { d as CapxulResult, C as CapxulError } from './errors-QHD5Tlok.js';
-import { A as Account, U as UserIdentifier, a as AccountLookupResult, S as Safe, i as KycProfile, E as ExternalAccount, L as List, v as SubAccount, B as BalanceLedgerEntry, b as ApiKey, D as Document, O as Operation, l as OperationStatus, k as Money, C as CreatePaymentResult, o as Payment, F as TransferEndpoint, f as CreateTransferResult, y as Transfer, g as CreateWithdrawalResult, _ as Withdrawal, Y as WebhookEndpoint, Z as WebhookEvent, n as Organization, J as Treasury, M as Member, K as KybProfile, V as VirtualAccount, Q as VirtualCard } from './types-75UokagF.js';
+import { A as Account, U as UserIdentifier, a as AccountLookupResult, S as Safe, i as KycProfile, E as ExternalAccount, L as List, v as SubAccount, B as BalanceLedgerEntry, b as ApiKey, D as Document, O as Operation, l as OperationStatus, k as Money, C as CreatePaymentResult, o as Payment, F as TransferEndpoint, f as CreateTransferResult, y as Transfer, g as CreateWithdrawalResult, _ as Withdrawal, Y as WebhookEndpoint, Z as WebhookEvent, n as Organization, J as Treasury, M as Member, K as KybProfile, V as VirtualAccount, Q as VirtualCard } from './types-BE3tVIOI.js';
 import * as types from '@repo/api-contract/gen/types';
 
 /**
@@ -473,35 +473,13 @@ type OrgTransfersClient = {
 
 /**
  * Withdrawals domain — funds exit Capxul via an `external_account` per
- * sdk-surface.md §1a + §4.52 + withdrawal-orchestration.mdx (slice 1
- * of Withdrawals v1, #440).
- *
- * Slice 1 NOTE — transitional input shape:
- * Until the `external_accounts` resource lands (slice 1.x or v2), the
- * destination input includes a `kind` field so the backend + SDK can
- * route to the chain_wallet rail without a real external_accounts
- * lookup. When the resource lands, `kind` becomes optional / ignored
- * and the kind is inferred from the resolved row.
- *
- * Slice 1 NOTE — chain_wallet rail integration:
- * For evm destinations, the `externalAccountId` is treated as the
- * destination address (must start with `0x`) so the chain_wallet rail
- * can call `transferAsOwner` directly. For solana / starknet the SDK
- * accepts the create call but does NOT execute the rail submission —
- * the row stays in `processing` until external_accounts lands. The
- * caller can transition it via `markFailed` if needed.
+ * sdk-surface.md §1a + §4.52.
  */
 
 type WithdrawalsCreateInput = {
     readonly amount: Money;
     readonly destination: {
         readonly externalAccountId: ExternalAccountId;
-        /**
-         * Slice 1 transitional field. Required until the
-         * `external_accounts` resource lands; will become optional / ignored
-         * when the resource is the source of truth for kind.
-         */
-        readonly kind: "evm" | "solana" | "starknet" | "bank" | "momo" | "card_payout";
     };
     readonly source?: {
         readonly subAccountId: SubAccountId;

package/dist/{client-D-0KTn8D.d.cts → client-CwcnMbGv.d.cts}

@@ -2,7 +2,7 @@ import { Account as Account$1 } from 'viem';
 import { AnyStateMachine } from 'xstate';
 import { A as AccountId, S as SafeId, c as KycProfileId, b as ExternalAccountId, f as SubAccountId, d as OrganizationId, a as ApiKeyId, X as TimestampIso, D as DocumentId, O as OperationId, P as PaymentId, g as TransferId, k as WithdrawalId, W as WebhookEndpointId, j as WebhookEventId, M as MemberId, K as KybProfileId, V as VirtualAccountId, i as VirtualCardId } from './next-action-DkrwXYay.cjs';
 import { d as CapxulResult, C as CapxulError } from './errors-GgKrSUKp.cjs';
-import { A as Account, U as UserIdentifier, a as AccountLookupResult, S as Safe, i as KycProfile, E as ExternalAccount, L as List, v as SubAccount, B as BalanceLedgerEntry, b as ApiKey, D as Document, O as Operation, l as OperationStatus, k as Money, C as CreatePaymentResult, o as Payment, F as TransferEndpoint, f as CreateTransferResult, y as Transfer, g as CreateWithdrawalResult, _ as Withdrawal, Y as WebhookEndpoint, Z as WebhookEvent, n as Organization, J as Treasury, M as Member, K as KybProfile, V as VirtualAccount, Q as VirtualCard } from './types-DVWojoy4.cjs';
+import { A as Account, U as UserIdentifier, a as AccountLookupResult, S as Safe, i as KycProfile, E as ExternalAccount, L as List, v as SubAccount, B as BalanceLedgerEntry, b as ApiKey, D as Document, O as Operation, l as OperationStatus, k as Money, C as CreatePaymentResult, o as Payment, F as TransferEndpoint, f as CreateTransferResult, y as Transfer, g as CreateWithdrawalResult, _ as Withdrawal, Y as WebhookEndpoint, Z as WebhookEvent, n as Organization, J as Treasury, M as Member, K as KybProfile, V as VirtualAccount, Q as VirtualCard } from './types-z4VLz9rS.cjs';
 import * as types from '@repo/api-contract/gen/types';
 
 /**
@@ -473,35 +473,13 @@ type OrgTransfersClient = {
 
 /**
  * Withdrawals domain — funds exit Capxul via an `external_account` per
- * sdk-surface.md §1a + §4.52 + withdrawal-orchestration.mdx (slice 1
- * of Withdrawals v1, #440).
- *
- * Slice 1 NOTE — transitional input shape:
- * Until the `external_accounts` resource lands (slice 1.x or v2), the
- * destination input includes a `kind` field so the backend + SDK can
- * route to the chain_wallet rail without a real external_accounts
- * lookup. When the resource lands, `kind` becomes optional / ignored
- * and the kind is inferred from the resolved row.
- *
- * Slice 1 NOTE — chain_wallet rail integration:
- * For evm destinations, the `externalAccountId` is treated as the
- * destination address (must start with `0x`) so the chain_wallet rail
- * can call `transferAsOwner` directly. For solana / starknet the SDK
- * accepts the create call but does NOT execute the rail submission —
- * the row stays in `processing` until external_accounts lands. The
- * caller can transition it via `markFailed` if needed.
+ * sdk-surface.md §1a + §4.52.
  */
 
 type WithdrawalsCreateInput = {
     readonly amount: Money;
     readonly destination: {
         readonly externalAccountId: ExternalAccountId;
-        /**
-         * Slice 1 transitional field. Required until the
-         * `external_accounts` resource lands; will become optional / ignored
-         * when the resource is the source of truth for kind.
-         */
-        readonly kind: "evm" | "solana" | "starknet" | "bank" | "momo" | "card_payout";
     };
     readonly source?: {
         readonly subAccountId: SubAccountId;

package/dist/client.cjs

@@ -1100,298 +1100,24 @@ function createOrgTransfersClient() {
     cancel: async () => stub("organizations.transfers.cancel")
   };
 }
-var EVM_ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
-function createWithdrawalsClient(config = {}) {
+
+// src/core/withdrawals.ts
+function createWithdrawalsClient() {
   return {
-    create: async (input) => {
-      if (!config.data) {
-        return stub("withdrawals.create");
-      }
-      let created = null;
-      let submitted = null;
-      try {
-        created = await config.data.mutation(
-          api.withdrawals.mutations.create,
-          {
-            amount: input.amount,
-            destination: {
-              externalAccountId: input.destination.externalAccountId,
-              kind: input.destination.kind
-            },
-            source: input.source,
-            reference: input.reference,
-            idempotencyKey: input.idempotencyKey
-          }
-        );
-        if (!created) {
-          return [
-            new CapxulError({
-              code: "NETWORK_ERROR",
-              message: "withdrawals.create returned no withdrawal resource"
-            }),
-            null
-          ];
-        }
-        if (created.status !== "processing" || created.operation.status !== "processing") {
-          return [null, created];
-        }
-        if (input.destination.kind !== "evm") {
-          return [null, created];
-        }
-        if (!config.signer || !config.signing) {
-          return [null, created];
-        }
-        if (!EVM_ADDRESS_RE.test(input.destination.externalAccountId)) {
-          throw new CapxulError({
-            code: "INVALID_INPUT",
-            message: "destination.externalAccountId must be a 0x-prefixed EVM address while external_accounts resolution is pending (slice 1).",
-            details: { field: "destination.externalAccountId" }
-          });
-        }
-        const currentSigner = await config.data.query(
-          api.safe.queries.getMySignerAddress,
-          {}
-        );
-        if (!currentSigner?.address) {
-          throw new CapxulError({
-            code: "PERMISSION_DENIED",
-            message: "No signer is registered for the authenticated account.",
-            details: { withdrawalId: created.id }
-          });
-        }
-        if (viem.getAddress(currentSigner.address) !== viem.getAddress(config.signer.address)) {
-          throw new CapxulError({
-            code: "PERMISSION_DENIED",
-            message: "Configured signer does not match the authenticated account signer.",
-            details: {
-              withdrawalId: created.id,
-              expectedSignerAddress: currentSigner.address,
-              actualSignerAddress: config.signer.address
-            }
-          });
-        }
-        const submission = await config.data.query(
-          api.withdrawals.queries.prepareSubmission,
-          { withdrawalId: created.id }
-        );
-        if (!submission?.externalAccountId) {
-          throw new CapxulError({
-            code: "NETWORK_ERROR",
-            message: "withdrawals.prepareSubmission returned no destination.",
-            details: { withdrawalId: created.id }
-          });
-        }
-        const transfer = await transferAsOwner(
-          {
-            signer: config.signer,
-            signing: config.signing
-          },
-          {
-            tokenAddress: resolvePaymentTokenAddress(submission.amount.currency),
-            recipientAddress: submission.externalAccountId,
-            amount: toTokenUnits(submission.amount.value, 6)
-          }
-        );
-        if (!transfer.success) {
-          throw new CapxulError({
-            code: "NETWORK_ERROR",
-            message: "Bundler submission did not succeed.",
-            details: {
-              withdrawalId: created.id,
-              txHash: transfer.txHash,
-              userOpHash: transfer.userOpHash
-            }
-          });
-        }
-        submitted = {
-          txHash: transfer.txHash,
-          userOpHash: transfer.userOpHash
-        };
-        await config.data.mutation(
-          api.withdrawals.mutations.recordSubmitted,
-          {
-            withdrawalId: created.id,
-            txHash: transfer.txHash,
-            userOpHash: transfer.userOpHash
-          }
-        );
-        return [null, created];
-      } catch (cause) {
-        const error = mapCreateError2(fromConvexError(cause));
-        if (created?.id && created.status === "processing" && !submitted) {
-          await bestEffortMarkFailed2({ data: config.data }, created.id, error);
-        }
-        if (submitted && created?.id) {
-          return [
-            new CapxulError({
-              code: "NETWORK_ERROR",
-              message: "Withdrawal was submitted on-chain, but backend submission tracking failed.",
-              cause,
-              details: {
-                withdrawalId: created.id,
-                txHash: submitted.txHash,
-                userOpHash: submitted.userOpHash
-              }
-            }),
-            null
-          ];
-        }
-        return [error, null];
-      }
-    },
-    retrieve: async (withdrawalId) => {
-      if (!config.data) {
-        return stub("withdrawals.retrieve");
-      }
-      try {
-        const withdrawal = await config.data.query(
-          api.withdrawals.queries.retrieve,
-          { withdrawalId }
-        );
-        if (!withdrawal) {
-          return [
-            new CapxulError({
-              code: "NOT_FOUND",
-              message: `withdrawal ${withdrawalId} not found`
-            }),
-            null
-          ];
-        }
-        return [null, withdrawal];
-      } catch (cause) {
-        return [
-          fromConvexError(cause),
-          null
-        ];
-      }
-    },
-    list: async (input) => {
-      if (!config.data) {
-        return stub("withdrawals.list");
-      }
-      try {
-        const result = await config.data.query(
-          api.withdrawals.queries.list,
-          {
-            limit: input?.limit,
-            cursor: input?.cursor
-          }
-        );
-        return [null, result];
-      } catch (cause) {
-        return [
-          fromConvexError(cause),
-          null
-        ];
-      }
-    }
+    create: async () => stub("withdrawals.create"),
+    retrieve: async () => stub("withdrawals.retrieve"),
+    list: async () => stub("withdrawals.list")
   };
 }
-function createOrgWithdrawalsClient(config = {}) {
+function createOrgWithdrawalsClient() {
   return {
-    // Slice 1 ships personal-scope only end-to-end; org-scope create
-    // remains stubbed pending org-scoped backend mutation. List + retrieve
-    // are wired through the org-aware query.
     create: async () => stub(
       "organizations.withdrawals.create"
     ),
-    retrieve: async (input) => {
-      if (!config.data) {
-        return stub(
-          "organizations.withdrawals.retrieve"
-        );
-      }
-      try {
-        const withdrawal = await config.data.query(
-          api.withdrawals.queries.retrieve,
-          { withdrawalId: input.withdrawalId }
-        );
-        if (!withdrawal) {
-          return [
-            new CapxulError({
-              code: "NOT_FOUND",
-              message: `withdrawal ${input.withdrawalId} not found`
-            }),
-            null
-          ];
-        }
-        const ownerCheck = withdrawal.owner;
-        if (ownerCheck?.type !== "organization" || ownerCheck.id !== input.organizationId) {
-          return [
-            new CapxulError({
-              code: "NOT_FOUND",
-              message: `withdrawal ${input.withdrawalId} does not belong to organization ${input.organizationId}`
-            }),
-            null
-          ];
-        }
-        return [null, withdrawal];
-      } catch (cause) {
-        return [
-          fromConvexError(cause),
-          null
-        ];
-      }
-    },
-    list: async (input) => {
-      if (!config.data) {
-        return stub(
-          "organizations.withdrawals.list"
-        );
-      }
-      try {
-        const result = await config.data.query(
-          api.withdrawals.queries.listOrg,
-          {
-            organizationId: input.organizationId,
-            limit: input.limit,
-            cursor: input.cursor
-          }
-        );
-        return [null, result];
-      } catch (cause) {
-        return [
-          fromConvexError(cause),
-          null
-        ];
-      }
-    }
+    retrieve: async () => stub("organizations.withdrawals.retrieve"),
+    list: async () => stub("organizations.withdrawals.list")
   };
 }
-async function bestEffortMarkFailed2(config, withdrawalId, error) {
-  try {
-    await config.data.mutation(api.withdrawals.mutations.markFailed, {
-      withdrawalId,
-      errorCode: error.code,
-      errorMessage: error.message
-    });
-  } catch {
-  }
-}
-function mapCreateError2(error) {
-  switch (error.code) {
-    case "NOT_AUTHENTICATED":
-    case "PERMISSION_DENIED":
-    case "INVALID_INPUT":
-    case "INSUFFICIENT_BALANCE":
-    case "IDEMPOTENCY_CONFLICT":
-    case "KYC_REQUIRED":
-    case "POLICY_DENIED":
-    case "RATE_LIMITED":
-    case "NETWORK_ERROR":
-      return error;
-    default:
-      return new CapxulError({
-        code: "NETWORK_ERROR",
-        message: error.message,
-        cause: error,
-        details: error.details,
-        operationId: error.operationId,
-        correlationId: error.correlationId,
-        retryable: error.retryable
-      });
-  }
-}
 
 // src/core/webhook-endpoints.ts
 function createWebhookEndpointsClient() {
@@ -1491,7 +1217,7 @@ function createOrganizationsClient(config = {}) {
     },
     payments: createOrgPaymentsClient(),
     transfers: createOrgTransfersClient(),
-    withdrawals: createOrgWithdrawalsClient(config),
+    withdrawals: createOrgWithdrawalsClient(),
     documents: createOrgDocumentsClient(),
     webhookEndpoints: createWebhookEndpointsClient(),
     webhookEvents: createWebhookEventsClient()
@@ -2249,7 +1975,7 @@ function createCapxulClient(config = {}) {
     organizations: createOrganizationsClient(config),
     payments: createPaymentsClient(config),
     transfers: createTransfersClient(),
-    withdrawals: createWithdrawalsClient(config),
+    withdrawals: createWithdrawalsClient(),
     documents: createDocumentsClient(),
     subAccounts: createSubAccountsClient(),
     virtualAccounts: createVirtualAccountsClient(),

package/dist/client.d.cts

@@ -1,7 +1,7 @@
 import 'viem';
 import 'xstate';
-export { f as CapxulAuthConfig, C as CapxulClient, g as CapxulConfig, h as CapxulDataClient, i as CapxulFlowFactories, j as CapxulSigningConfig, y as createCapxulClient } from './client-D-0KTn8D.cjs';
+export { f as CapxulAuthConfig, C as CapxulClient, g as CapxulConfig, h as CapxulDataClient, i as CapxulFlowFactories, j as CapxulSigningConfig, y as createCapxulClient } from './client-CwcnMbGv.cjs';
 import './next-action-DkrwXYay.cjs';
 import './errors-GgKrSUKp.cjs';
-import './types-DVWojoy4.cjs';
+import './types-z4VLz9rS.cjs';
 import '@repo/api-contract/gen/types';

package/dist/client.d.ts

@@ -1,7 +1,7 @@
 import 'viem';
 import 'xstate';
-export { f as CapxulAuthConfig, C as CapxulClient, g as CapxulConfig, h as CapxulDataClient, i as CapxulFlowFactories, j as CapxulSigningConfig, y as createCapxulClient } from './client-CweJSkaY.js';
+export { f as CapxulAuthConfig, C as CapxulClient, g as CapxulConfig, h as CapxulDataClient, i as CapxulFlowFactories, j as CapxulSigningConfig, y as createCapxulClient } from './client-BI863O0y.js';
 import './next-action-DkrwXYay.js';
 import './errors-QHD5Tlok.js';
-import './types-75UokagF.js';
+import './types-BE3tVIOI.js';
 import '@repo/api-contract/gen/types';