@capxul/sdk-react 0.1.0-alpha.1 → 0.1.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # @capxul/sdk-react
 
+## 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.
+
+- Updated dependencies
+  - @capxul/sdk@0.1.0-alpha.3
+
+## 0.1.0-alpha.2
+
+### Patch Changes
+
+- Add `convex` as a peer dependency.
+
+  `@capxul/sdk`'s bundled `_generated/api` snapshot calls
+  `anyApi` / `componentsGeneric` from `convex/server` at runtime — they
+  are not just types — and tsup correctly externalizes `convex` /
+  `convex/server` / `convex/react` so the consumer's own Convex install
+  is reused. The peer was missing from the published manifest, so
+  `require('@capxul/sdk')` failed with `Cannot find module 'convex/server'`
+  in any spike that hadn't already installed `convex`.
+
+  `@capxul/sdk-react` mirrors the peer because its bundle re-exports
+  flow-machine constructors from `@capxul/sdk` and may transitively
+  pull in the same module.
+
+  Caught during alpha.1 spike-install verification.
+
+- Updated dependencies
+  - @capxul/sdk@0.1.0-alpha.2
+
 ## 0.1.0-alpha.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -322,12 +322,8 @@ function useBalanceLedgerEntry(_args) {
 function useDocument(_documentId) {
   return notImplementedQuery("useDocument");
 }
-function useWithdrawal(withdrawalId) {
-  const capxul = useCapxul();
-  return useSdkQuery(() => capxul.withdrawals.retrieve(withdrawalId), [
-    capxul,
-    withdrawalId
-  ]);
+function useWithdrawal(_withdrawalId) {
+  return notImplementedQuery("useWithdrawal");
 }
 function useOperation(operationId) {
   const capxul = useCapxul();
@@ -383,19 +379,11 @@ function useDocuments(_filters) {
 function useOrgDocuments(_args) {
   return notImplementedQuery("useOrgDocuments");
 }
-function useWithdrawals(filters) {
-  const capxul = useCapxul();
-  return useSdkQuery(
-    () => capxul.withdrawals.list(filters),
-    [capxul, filters?.limit, filters?.cursor]
-  );
+function useWithdrawals(_filters) {
+  return notImplementedQuery("useWithdrawals");
 }
-function useOrgWithdrawals(args) {
-  const capxul = useCapxul();
-  return useSdkQuery(
-    () => capxul.organizations.withdrawals.list(args),
-    [capxul, args.organizationId, args.limit, args.cursor]
-  );
+function useOrgWithdrawals(_args) {
+  return notImplementedQuery("useOrgWithdrawals");
 }
 function useApiKeys(_organizationId) {
   return notImplementedQuery("useApiKeys");

package/dist/index.d.cts

@@ -249,12 +249,7 @@ declare function useTransfer(_transferId: TransferId): QueryResult<Transfer>;
  */
 declare function useBalanceLedgerEntry(_args: UseBalanceLedgerEntryArgs): QueryResult<BalanceLedgerEntry>;
 declare function useDocument(_documentId: DocumentId): QueryResult<Document>;
-/**
- * Withdrawals v1 slice 1 (#440) — wired through `capxul.withdrawals.retrieve`.
- * Mirrors `useOperation` (the canonical evidence subscription) since
- * the withdrawal resource is operation-shaped at its core.
- */
-declare function useWithdrawal(withdrawalId: WithdrawalId): QueryResult<Withdrawal>;
+declare function useWithdrawal(_withdrawalId: WithdrawalId): QueryResult<Withdrawal>;
 /**
  * The canonical evidence subscription per CANON.md §3.3 —
  * `operationId` + `correlationId` are the cross-layer join keys for
@@ -357,15 +352,8 @@ declare function useBalanceLedger(_args: OwnerScopedFilters): QueryResult<List<B
  */
 declare function useDocuments(_filters?: DocumentsFilters): QueryResult<List<Document>>;
 declare function useOrgDocuments(_args: OrgDocumentsFilters): QueryResult<List<Document>>;
-/**
- * Withdrawals v1 slice 1 (#440) — wired through `capxul.withdrawals.list`.
- */
-declare function useWithdrawals(filters?: WithdrawalsFilters): QueryResult<List<Withdrawal>>;
-/**
- * Withdrawals v1 slice 1 (#440) — wired through
- * `capxul.organizations.withdrawals.list`.
- */
-declare function useOrgWithdrawals(args: OrgScopedFilters): QueryResult<List<Withdrawal>>;
+declare function useWithdrawals(_filters?: WithdrawalsFilters): QueryResult<List<Withdrawal>>;
+declare function useOrgWithdrawals(_args: OrgScopedFilters): QueryResult<List<Withdrawal>>;
 /**
  * Org-admin lens only — the hook NEVER returns `secret` for any row.
  */

package/dist/index.d.ts

@@ -249,12 +249,7 @@ declare function useTransfer(_transferId: TransferId): QueryResult<Transfer>;
  */
 declare function useBalanceLedgerEntry(_args: UseBalanceLedgerEntryArgs): QueryResult<BalanceLedgerEntry>;
 declare function useDocument(_documentId: DocumentId): QueryResult<Document>;
-/**
- * Withdrawals v1 slice 1 (#440) — wired through `capxul.withdrawals.retrieve`.
- * Mirrors `useOperation` (the canonical evidence subscription) since
- * the withdrawal resource is operation-shaped at its core.
- */
-declare function useWithdrawal(withdrawalId: WithdrawalId): QueryResult<Withdrawal>;
+declare function useWithdrawal(_withdrawalId: WithdrawalId): QueryResult<Withdrawal>;
 /**
  * The canonical evidence subscription per CANON.md §3.3 —
  * `operationId` + `correlationId` are the cross-layer join keys for
@@ -357,15 +352,8 @@ declare function useBalanceLedger(_args: OwnerScopedFilters): QueryResult<List<B
  */
 declare function useDocuments(_filters?: DocumentsFilters): QueryResult<List<Document>>;
 declare function useOrgDocuments(_args: OrgDocumentsFilters): QueryResult<List<Document>>;
-/**
- * Withdrawals v1 slice 1 (#440) — wired through `capxul.withdrawals.list`.
- */
-declare function useWithdrawals(filters?: WithdrawalsFilters): QueryResult<List<Withdrawal>>;
-/**
- * Withdrawals v1 slice 1 (#440) — wired through
- * `capxul.organizations.withdrawals.list`.
- */
-declare function useOrgWithdrawals(args: OrgScopedFilters): QueryResult<List<Withdrawal>>;
+declare function useWithdrawals(_filters?: WithdrawalsFilters): QueryResult<List<Withdrawal>>;
+declare function useOrgWithdrawals(_args: OrgScopedFilters): QueryResult<List<Withdrawal>>;
 /**
  * Org-admin lens only — the hook NEVER returns `secret` for any row.
  */

package/dist/index.js

@@ -320,12 +320,8 @@ function useBalanceLedgerEntry(_args) {
 function useDocument(_documentId) {
   return notImplementedQuery("useDocument");
 }
-function useWithdrawal(withdrawalId) {
-  const capxul = useCapxul();
-  return useSdkQuery(() => capxul.withdrawals.retrieve(withdrawalId), [
-    capxul,
-    withdrawalId
-  ]);
+function useWithdrawal(_withdrawalId) {
+  return notImplementedQuery("useWithdrawal");
 }
 function useOperation(operationId) {
   const capxul = useCapxul();
@@ -381,19 +377,11 @@ function useDocuments(_filters) {
 function useOrgDocuments(_args) {
   return notImplementedQuery("useOrgDocuments");
 }
-function useWithdrawals(filters) {
-  const capxul = useCapxul();
-  return useSdkQuery(
-    () => capxul.withdrawals.list(filters),
-    [capxul, filters?.limit, filters?.cursor]
-  );
+function useWithdrawals(_filters) {
+  return notImplementedQuery("useWithdrawals");
 }
-function useOrgWithdrawals(args) {
-  const capxul = useCapxul();
-  return useSdkQuery(
-    () => capxul.organizations.withdrawals.list(args),
-    [capxul, args.organizationId, args.limit, args.cursor]
-  );
+function useOrgWithdrawals(_args) {
+  return notImplementedQuery("useOrgWithdrawals");
 }
 function useApiKeys(_organizationId) {
   return notImplementedQuery("useApiKeys");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/sdk-react",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "description": "React provider + hooks for the @capxul/sdk headless client.",
   "license": "UNLICENSED",
   "private": false,
@@ -41,11 +41,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@capxul/sdk": "0.1.0-alpha.1"
+    "@capxul/sdk": "0.1.0-alpha.3"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5",
     "@xstate/react": "^5",
+    "convex": ">=1.0.0",
     "react": ">=19.0.0",
     "viem": ">=2.0.0"
   },