@capxul/sdk-react 0.1.0-alpha.10 → 0.1.0-alpha.12

package/CHANGELOG.md

@@ -1,10 +1,18 @@
 # @capxul/sdk-react
 
-## 0.1.0-alpha.10
+## 0.1.0-alpha.12
+
+### Minor Changes
+
+- f497aef: Publish the post-alpha.11 SDK and React SDK surface: funds v1 sub-account
+  runtime coverage, React hook wiring, payments list support, and the latest
+  generated Convex API snapshots used by current alpha consumers.
 
 ### Patch Changes
 
 - d252aa7: Widen the published React peer dependency to `>=18.2.0 <20` so React 18 consumers, including the Ink reference proof app, can install the alpha SDK without peer conflicts.
+- Updated dependencies [f497aef]
+  - @capxul/sdk@0.1.0-alpha.12
 
 ## 0.1.0-alpha.9
 

package/dist/index.cjs

@@ -81,10 +81,16 @@ var Errors = {
     `Shield API error (${status}): ${detail}`,
     { details: { provider: "shield", status } }
   ),
-  providerError: (provider, operation, cause) => new CapxulError(
-    "PROVIDER_ERROR",
-    `${provider} ${operation} failed: ${cause instanceof Error ? cause.message : String(cause)}`,
-    { cause, details: { provider, operation } }
+  providerError: (provider, operation, cause) => (
+    // Public `message` is redacted to a fixed shape so provider-side
+    // exception text never leaks to the client. The original `cause`
+    // is preserved on `Error.cause` for server-side debugging via
+    // observability sinks (Sentry, console traces).
+    new CapxulError(
+      "PROVIDER_ERROR",
+      `Provider error: ${provider} ${operation}`,
+      { cause, details: { provider, operation } }
+    )
   ),
   invalidInput: (field, reason) => new CapxulError(
     "INVALID_INPUT",
@@ -473,8 +479,12 @@ function useExternalAccount(args) {
     [capxul, args.ownerKind, args.ownerId, args.externalAccountId]
   );
 }
-function useSubAccount(_subAccountId) {
-  return notImplementedQuery("useSubAccount");
+function useSubAccount(subAccountId) {
+  const capxul = useCapxul();
+  return useSdkQuery(
+    () => capxul.subAccounts.retrieve(subAccountId),
+    [capxul, subAccountId]
+  );
 }
 function useVirtualAccount(_virtualAccountId) {
   return notImplementedQuery("useVirtualAccount");
@@ -538,8 +548,14 @@ function useExternalAccounts(args) {
     [capxul, args.ownerKind, args.ownerId]
   );
 }
-function useSubAccounts(_args) {
-  return notImplementedQuery("useSubAccounts");
+function useSubAccounts(args) {
+  const capxul = useCapxul();
+  return useSdkQuery(
+    () => args.ownerKind === "account" ? capxul.accounts.subAccounts.list({ accountId: args.ownerId }) : capxul.organizations.subAccounts.list({
+      organizationId: args.ownerId
+    }),
+    [capxul, args.ownerKind, args.ownerId]
+  );
 }
 function useVirtualAccounts(_filters) {
   return notImplementedQuery("useVirtualAccounts");

package/dist/index.d.cts

@@ -270,7 +270,19 @@ declare function useKybProfile(_organizationId: OrganizationId): QueryResult<Kyb
  * differ but the wire shape is identical.
  */
 declare function useExternalAccount(args: UseExternalAccountArgs): QueryResult<ExternalAccount>;
-declare function useSubAccount(_subAccountId: SubAccountId): QueryResult<SubAccount>;
+/**
+ * Funds v1 PR-2b (#421) — wired through `capxul.subAccounts.retrieve`.
+ *
+ * The top-level `subAccounts.retrieve` resolves to the same Convex
+ * query handler as `accounts.subAccounts.retrieve` /
+ * `organizations.subAccounts.retrieve`; visibility is gated server-side
+ * (canon §sub_account read contract — cross-scope reads surface as
+ * `NOT_FOUND` rather than a distinct permission code). The SDK has
+ * already branded the wire shape via `tryBrandSubAccount`, so the hook
+ * receives a fully-branded `SubAccount` (`SubAccountId`, `Money`,
+ * `TimestampIso`).
+ */
+declare function useSubAccount(subAccountId: SubAccountId): QueryResult<SubAccount>;
 declare function useVirtualAccount(_virtualAccountId: VirtualAccountId): QueryResult<VirtualAccount>;
 declare function useVirtualCard(_virtualCardId: VirtualCardId): QueryResult<VirtualCard>;
 declare function usePayment(_paymentId: PaymentId): QueryResult<Payment>;
@@ -392,7 +404,24 @@ declare function useMembers(_organizationId: OrganizationId): QueryResult<List<M
  * `pending_verification` rows visible (D5).
  */
 declare function useExternalAccounts(args: OwnerRef): QueryResult<List<ExternalAccount>>;
-declare function useSubAccounts(_args: OwnerRef): QueryResult<List<SubAccount>>;
+/**
+ * Funds v1 PR-2b (#421) — wired through the SDK.
+ *
+ * Branches on `args.ownerKind`: `account` scope reads through
+ * `capxul.accounts.subAccounts.list({ accountId })`; `organization`
+ * scope reads through `capxul.organizations.subAccounts.list({
+ * organizationId })`. Both resolve to the same Convex domain (server
+ * derives the writer scope per Pattern A — see `sdk.md`). The SDK
+ * has already branded each row via `tryBrandSubAccount`, so consumers
+ * receive `List<SubAccount>` with `SubAccountId`, `Money`, and
+ * `TimestampIso` in place.
+ *
+ * Note: `OwnerRef` admits only `"account" | "organization"`. A
+ * `sub_account` owner is a type error at the call site — not a runtime
+ * not-supported branch — because there is no `listChildSubAccounts`
+ * backend endpoint.
+ */
+declare function useSubAccounts(args: OwnerRef): QueryResult<List<SubAccount>>;
 declare function useVirtualAccounts(_filters?: VirtualAccountsFilters): QueryResult<List<VirtualAccount>>;
 declare function useVirtualCards(_filters?: VirtualCardsFilters): QueryResult<List<VirtualCard>>;
 /**

package/dist/index.d.ts

@@ -270,7 +270,19 @@ declare function useKybProfile(_organizationId: OrganizationId): QueryResult<Kyb
  * differ but the wire shape is identical.
  */
 declare function useExternalAccount(args: UseExternalAccountArgs): QueryResult<ExternalAccount>;
-declare function useSubAccount(_subAccountId: SubAccountId): QueryResult<SubAccount>;
+/**
+ * Funds v1 PR-2b (#421) — wired through `capxul.subAccounts.retrieve`.
+ *
+ * The top-level `subAccounts.retrieve` resolves to the same Convex
+ * query handler as `accounts.subAccounts.retrieve` /
+ * `organizations.subAccounts.retrieve`; visibility is gated server-side
+ * (canon §sub_account read contract — cross-scope reads surface as
+ * `NOT_FOUND` rather than a distinct permission code). The SDK has
+ * already branded the wire shape via `tryBrandSubAccount`, so the hook
+ * receives a fully-branded `SubAccount` (`SubAccountId`, `Money`,
+ * `TimestampIso`).
+ */
+declare function useSubAccount(subAccountId: SubAccountId): QueryResult<SubAccount>;
 declare function useVirtualAccount(_virtualAccountId: VirtualAccountId): QueryResult<VirtualAccount>;
 declare function useVirtualCard(_virtualCardId: VirtualCardId): QueryResult<VirtualCard>;
 declare function usePayment(_paymentId: PaymentId): QueryResult<Payment>;
@@ -392,7 +404,24 @@ declare function useMembers(_organizationId: OrganizationId): QueryResult<List<M
  * `pending_verification` rows visible (D5).
  */
 declare function useExternalAccounts(args: OwnerRef): QueryResult<List<ExternalAccount>>;
-declare function useSubAccounts(_args: OwnerRef): QueryResult<List<SubAccount>>;
+/**
+ * Funds v1 PR-2b (#421) — wired through the SDK.
+ *
+ * Branches on `args.ownerKind`: `account` scope reads through
+ * `capxul.accounts.subAccounts.list({ accountId })`; `organization`
+ * scope reads through `capxul.organizations.subAccounts.list({
+ * organizationId })`. Both resolve to the same Convex domain (server
+ * derives the writer scope per Pattern A — see `sdk.md`). The SDK
+ * has already branded each row via `tryBrandSubAccount`, so consumers
+ * receive `List<SubAccount>` with `SubAccountId`, `Money`, and
+ * `TimestampIso` in place.
+ *
+ * Note: `OwnerRef` admits only `"account" | "organization"`. A
+ * `sub_account` owner is a type error at the call site — not a runtime
+ * not-supported branch — because there is no `listChildSubAccounts`
+ * backend endpoint.
+ */
+declare function useSubAccounts(args: OwnerRef): QueryResult<List<SubAccount>>;
 declare function useVirtualAccounts(_filters?: VirtualAccountsFilters): QueryResult<List<VirtualAccount>>;
 declare function useVirtualCards(_filters?: VirtualCardsFilters): QueryResult<List<VirtualCard>>;
 /**

package/dist/index.js

@@ -79,10 +79,16 @@ var Errors = {
     `Shield API error (${status}): ${detail}`,
     { details: { provider: "shield", status } }
   ),
-  providerError: (provider, operation, cause) => new CapxulError(
-    "PROVIDER_ERROR",
-    `${provider} ${operation} failed: ${cause instanceof Error ? cause.message : String(cause)}`,
-    { cause, details: { provider, operation } }
+  providerError: (provider, operation, cause) => (
+    // Public `message` is redacted to a fixed shape so provider-side
+    // exception text never leaks to the client. The original `cause`
+    // is preserved on `Error.cause` for server-side debugging via
+    // observability sinks (Sentry, console traces).
+    new CapxulError(
+      "PROVIDER_ERROR",
+      `Provider error: ${provider} ${operation}`,
+      { cause, details: { provider, operation } }
+    )
   ),
   invalidInput: (field, reason) => new CapxulError(
     "INVALID_INPUT",
@@ -471,8 +477,12 @@ function useExternalAccount(args) {
     [capxul, args.ownerKind, args.ownerId, args.externalAccountId]
   );
 }
-function useSubAccount(_subAccountId) {
-  return notImplementedQuery("useSubAccount");
+function useSubAccount(subAccountId) {
+  const capxul = useCapxul();
+  return useSdkQuery(
+    () => capxul.subAccounts.retrieve(subAccountId),
+    [capxul, subAccountId]
+  );
 }
 function useVirtualAccount(_virtualAccountId) {
   return notImplementedQuery("useVirtualAccount");
@@ -536,8 +546,14 @@ function useExternalAccounts(args) {
     [capxul, args.ownerKind, args.ownerId]
   );
 }
-function useSubAccounts(_args) {
-  return notImplementedQuery("useSubAccounts");
+function useSubAccounts(args) {
+  const capxul = useCapxul();
+  return useSdkQuery(
+    () => args.ownerKind === "account" ? capxul.accounts.subAccounts.list({ accountId: args.ownerId }) : capxul.organizations.subAccounts.list({
+      organizationId: args.ownerId
+    }),
+    [capxul, args.ownerKind, args.ownerId]
+  );
 }
 function useVirtualAccounts(_filters) {
   return notImplementedQuery("useVirtualAccounts");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/sdk-react",
-  "version": "0.1.0-alpha.10",
+  "version": "0.1.0-alpha.12",
   "description": "React provider + hooks for the @capxul/sdk headless client.",
   "license": "UNLICENSED",
   "private": false,
@@ -46,7 +46,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@capxul/sdk": "0.1.0-alpha.9"
+    "@capxul/sdk": "0.1.0-alpha.12"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5",
@@ -70,10 +70,10 @@
     "typescript": "5.9.2",
     "viem": "2.47.10",
     "vitest": "^4.1.2",
-    "@repo/observability": "0.0.0",
     "@repo/config": "0.0.0",
-    "@repo/typescript-config": "0.0.0",
-    "@repo/platform-kernel": "0.0.0"
+    "@repo/observability": "0.0.0",
+    "@repo/platform-kernel": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
   },
   "scripts": {
     "build": "tsup",