@capxul/sdk 2.3.2 → 2.5.0

package/README.md

@@ -43,6 +43,28 @@ if ("kind" in amount) {
 `parseMoney` returns validation errors as values. `formatMoney` rejects a
 malformed `Money` record with `INVALID_INPUT`.
 
+## The asset a screen shows
+
+`holdings.primary` picks the one asset a hero balance or a summary total
+should show. It returns the renderable holding with the largest available
+balance. A chain row that carries no `decimals`, no `symbol`, or a symbol that
+stands for no supported currency is skipped, because it cannot be rendered.
+
+```ts
+import { formatMoney, type Holding } from "@capxul/sdk";
+
+const result = await client.holdings.primary();
+
+if (result.ok && result.value !== null) {
+  const holding: Holding = result.value;
+  console.log(holding.symbol); // "USDX" — the token symbol the chain reported
+  console.log(formatMoney(holding.available, { grammar: "code" })); // e.g. "1,250.50 USD"
+}
+```
+
+`null` means no row is renderable. It is a value, not an error, so give the
+screen its own rule for showing nothing.
+
 ## Observability
 
 Hosts can attach the PostHog client they already initialized through one

package/dist/{InMemoryAuthCacheAdapter-qMpBOGb3.mjs → InMemoryAuthCacheAdapter-D5Cv0yz0.mjs}

@@ -293,6 +293,12 @@ function toPartyId(raw) {
 function toBudgetId(raw) {
 	return toNonEmptyStringBrand(raw, "budgetId");
 }
+function toPayrollRunId(raw) {
+	return toNonEmptyStringBrand(raw, "payrollRunId");
+}
+function toPayrollGroupId(raw) {
+	return toNonEmptyStringBrand(raw, "payrollGroupId");
+}
 function toOrgId(raw) {
 	return toNonEmptyStringBrand(raw, "orgId");
 }
@@ -488,4 +494,4 @@ Layer.effect(AuthCachePortTag, Effect.sync(() => new InMemoryAuthCacheAdapter())
 	cause
 }))));
 //#endregion
-export { toPartyId as A, toDurationMs as C, toJwtToken as D, toEpochSeconds as E, CAPXUL_ERROR_CODES as F, CapxulError as I, EXPECTED_OPERATION_OUTCOMES as L, toRoleKey as M, toSessionToken as N, toKycTier as O, decodeConvexError as P, Errors as R, toCurrencyCode as S, toEpochMs as T, toAppId as _, AuthCacheError as a, toChainId as b, BYTES32_RE as c, WEI_RE as d, ZERO_BYTES32 as f, toAllowedOrigin as g, toAddress as h, parseCachedJwt as i, toPublishableKey as j, toOrgId as k, EVM_ADDRESS_RE as l, toAccountId as m, BrowserAuthCacheAdapter as n, AuthCachePortTag as o, currencySymbolFor as p, parseAuthSession as r, APP_ID_RE as s, InMemoryAuthCacheAdapter as t, SUPPORTED_CURRENCY_CODES as u, toAuthUserId as v, toEmail as w, toCountryCode as x, toBudgetId as y, isCapxulError as z };
+export { toPartyId as A, Errors as B, toDurationMs as C, toJwtToken as D, toEpochSeconds as E, toSessionToken as F, decodeConvexError as I, CAPXUL_ERROR_CODES as L, toPayrollRunId as M, toPublishableKey as N, toKycTier as O, toRoleKey as P, CapxulError as R, toCurrencyCode as S, toEpochMs as T, isCapxulError as V, toAppId as _, AuthCacheError as a, toChainId as b, BYTES32_RE as c, WEI_RE as d, ZERO_BYTES32 as f, toAllowedOrigin as g, toAddress as h, parseCachedJwt as i, toPayrollGroupId as j, toOrgId as k, EVM_ADDRESS_RE as l, toAccountId as m, BrowserAuthCacheAdapter as n, AuthCachePortTag as o, currencySymbolFor as p, parseAuthSession as r, APP_ID_RE as s, InMemoryAuthCacheAdapter as t, SUPPORTED_CURRENCY_CODES as u, toAuthUserId as v, toEmail as w, toCountryCode as x, toBudgetId as y, EXPECTED_OPERATION_OUTCOMES as z };