@capxul/sdk-react 2.8.0 → 3.0.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { A as useCapxulAuth, C as CreateOrganizationSubmission, D as ProfileDetails, E as OrganizationDetails, M as useCapxulIdentity, N as useCapxulSend, O as SendResult, P as useCapxulTransitions, S as CapxulSend, T as InvocationOptions, _ as ReadyDestination, a as AuthenticationSlots, b as Slot, c as ControllerAction, d as OnboardingControllerProps, f as OrgFailure, g as ProfileSlotProps, h as PendingAuthState, i as AuthenticatedState, j as useCapxulDestination, k as entered, l as FaultedState, m as OtpPendingState, n as AccountProgress, o as CapxulAuthenticationController, p as OrgProgress, r as ActionResult, s as CapxulOnboardingController, t as AccountFailure, u as NavigationAction, v as RetryAction, w as Destination, x as CapxulAuth, y as SignedOutState } from "./controllers-CJEsthW2.mjs";
 import { ReactNode, RefCallback } from "react";
 import { QueryClient, UseMutationResult, UseQueryResult } from "@tanstack/react-query";
-import { Account, AccountRequirement, ActivityAnnotation, ActivityAnnotationInput, ActivityDetail, ActivityKind, ActivityListParams, ActivityPage, ActivityPhase, ActivityRange, ActivityReference, ActorReference, AddressBookEntry, CapxulClient, CapxulError, CapxulResult, CapxulSigner, CreateOrgInput, CurrentHoldings, HostObservability, IdentityDestination, InviteMemberInput, MemberView, Money, MoneyParseErrorReason, OrgId, OrgView, OrganizationPaymentBatchInput, OrganizationPaymentInput, PartyId, Payment, PaymentDirection, PaymentDocumentRef, PaymentDocumentRender, PaymentStatus, PaymentTiming, PaymentType, PaymentsPayInput, PayrollGroupId, PayrollGroupInput, PayrollRunId, PayrollRunStatus, Permission, PermissionReadResult, Profile, RoleView, isClaimed, isRestoring } from "@capxul/sdk";
+import { Account, AccountRequirement, ActivityAnnotation, ActivityAnnotationInput, ActivityDetail, ActivityKind, ActivityListParams, ActivityPage, ActivityPhase, ActivityRange, ActivityReference, ActorReference, AddressBookEntry, BudgetId, CapxulClient, CapxulError, CapxulResult, CapxulSigner, CreateOrgInput, CurrentHoldings, HostObservability, IdentityDestination, InviteMemberInput, MemberView, Money, MoneyParseErrorReason, OrgId, OrgView, OrganizationPaymentBatchInput, OrganizationPaymentInput, PartyId, Payment, PaymentDirection, PaymentDocumentRef, PaymentDocumentRender, PaymentStatus, PaymentTiming, PaymentType, PaymentsPayInput, PayrollGroupId, PayrollGroupInput, PayrollRunId, PayrollRunStatus, Permission, PermissionMethods, PermissionReadResult, Profile, RoleView, SubmittedPermissionExecution, isClaimed, isRestoring } from "@capxul/sdk";
 //#region src/provider.d.ts
 type CapxulProviderSharedProps = {
   /** Bring your own QueryClient; otherwise the provider creates one. */
@@ -113,243 +113,14 @@ declare function useCapxulPayment(paymentId: string | undefined, options?: {
 declare function useCapxulOrganizationPay(orgId: OrgId | undefined): UseMutationResult<Payment, CapxulError, OrganizationPaymentInput>;
 declare function useCapxulOrganizationPayBatch(orgId: OrgId): UseMutationResult<readonly Payment[], CapxulError, OrganizationPaymentBatchInput>;
 //#endregion
-//#region ../types/src/brand.d.ts
-/**
- * Nominal type helper. `Brand<T, B>` is structurally a `T` at runtime but
- * distinct at compile time, preventing accidental swaps between primitives.
- *
- * @internal
- */
-declare const brand: unique symbol;
-type Brand<T, B extends string> = T & {
-  readonly [brand]: B;
-};
-//#endregion
-//#region ../types/src/index.d.ts
-type Address = Brand<string, "Address">;
-type PermissionId = Brand<string, "PermissionId">;
-type PermissionAssignmentId = Brand<string, "PermissionAssignmentId">;
-type BudgetId = Brand<string, "BudgetId">;
-type PaymentCommandId = Brand<string, "PaymentCommandId">;
-type OrgId$1 = Brand<string, "OrgId">;
-type CurrencyCode = Brand<SupportedCurrencyCode, "CurrencyCode">;
-type WeiAmount = Brand<string, "WeiAmount">;
-type RoleKey = Brand<string, "RoleKey">;
-type AllowanceKey = Brand<string, "AllowanceKey">;
-declare const SUPPORTED_CURRENCIES: readonly [{
-  readonly code: "USD";
-  readonly symbol: "$";
-  readonly name: "US Dollar";
-}, {
-  readonly code: "NGN";
-  readonly symbol: "NGN";
-  readonly name: "Nigerian Naira";
-}, {
-  readonly code: "GHS";
-  readonly symbol: "GHS";
-  readonly name: "Ghanaian Cedi";
-}, {
-  readonly code: "KES";
-  readonly symbol: "KSh";
-  readonly name: "Kenyan Shilling";
-}, {
-  readonly code: "UGX";
-  readonly symbol: "USh";
-  readonly name: "Ugandan Shilling";
-}];
-type SupportedCurrencyCode = (typeof SUPPORTED_CURRENCIES)[number]["code"];
-//#endregion
 //#region src/hooks/use-capxul-permissions.d.ts
-declare const useCapxulPermissionCreate: (orgId: OrgId) => UseMutationResult<{
-  readonly status: "submitted";
-  readonly executionId: string;
-  readonly commandId: PaymentCommandId;
-  readonly userOpHash: string;
-  readonly value: readonly {
-    readonly permissionId: PermissionId;
-    readonly orgId: string;
-    readonly type: "budget" | "managePeople";
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-    readonly revision: number;
-    readonly roleKey: RoleKey;
-    readonly tokenAddress?: Address | undefined;
-    readonly limitRaw?: WeiAmount | undefined;
-    readonly allowanceKey?: AllowanceKey | undefined;
-  }[] | {
-    readonly permissionId: PermissionId;
-    readonly orgId: string;
-    readonly type: "budget" | "managePeople";
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-    readonly revision: number;
-    readonly roleKey: RoleKey;
-    readonly tokenAddress?: Address | undefined;
-    readonly limitRaw?: WeiAmount | undefined;
-    readonly allowanceKey?: AllowanceKey | undefined;
-  } | {
-    readonly permissionAssignmentId: PermissionAssignmentId;
-    readonly permissionId: PermissionId;
-    readonly actor: {
-      readonly kind: "account";
-      readonly accountId: string;
-    } | {
-      readonly kind: "organization";
-      readonly orgId: string;
-    };
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-  };
-}, CapxulError, import("@capxul/sdk").PermissionCreateInput>;
-declare const useCapxulPermissionChange: (orgId: OrgId) => UseMutationResult<{
-  readonly status: "submitted";
-  readonly executionId: string;
-  readonly commandId: PaymentCommandId;
-  readonly userOpHash: string;
-  readonly value: readonly {
-    readonly permissionId: PermissionId;
-    readonly orgId: string;
-    readonly type: "budget" | "managePeople";
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-    readonly revision: number;
-    readonly roleKey: RoleKey;
-    readonly tokenAddress?: Address | undefined;
-    readonly limitRaw?: WeiAmount | undefined;
-    readonly allowanceKey?: AllowanceKey | undefined;
-  }[] | {
-    readonly permissionId: PermissionId;
-    readonly orgId: string;
-    readonly type: "budget" | "managePeople";
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-    readonly revision: number;
-    readonly roleKey: RoleKey;
-    readonly tokenAddress?: Address | undefined;
-    readonly limitRaw?: WeiAmount | undefined;
-    readonly allowanceKey?: AllowanceKey | undefined;
-  } | {
-    readonly permissionAssignmentId: PermissionAssignmentId;
-    readonly permissionId: PermissionId;
-    readonly actor: {
-      readonly kind: "account";
-      readonly accountId: string;
-    } | {
-      readonly kind: "organization";
-      readonly orgId: string;
-    };
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-  };
-}, CapxulError, import("@capxul/sdk").PermissionChangeInput>;
-declare const useCapxulPermissionAssign: (orgId: OrgId) => UseMutationResult<{
-  readonly status: "submitted";
-  readonly executionId: string;
-  readonly commandId: PaymentCommandId;
-  readonly userOpHash: string;
-  readonly value: readonly {
-    readonly permissionId: PermissionId;
-    readonly orgId: string;
-    readonly type: "budget" | "managePeople";
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-    readonly revision: number;
-    readonly roleKey: RoleKey;
-    readonly tokenAddress?: Address | undefined;
-    readonly limitRaw?: WeiAmount | undefined;
-    readonly allowanceKey?: AllowanceKey | undefined;
-  }[] | {
-    readonly permissionId: PermissionId;
-    readonly orgId: string;
-    readonly type: "budget" | "managePeople";
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-    readonly revision: number;
-    readonly roleKey: RoleKey;
-    readonly tokenAddress?: Address | undefined;
-    readonly limitRaw?: WeiAmount | undefined;
-    readonly allowanceKey?: AllowanceKey | undefined;
-  } | {
-    readonly permissionAssignmentId: PermissionAssignmentId;
-    readonly permissionId: PermissionId;
-    readonly actor: {
-      readonly kind: "account";
-      readonly accountId: string;
-    } | {
-      readonly kind: "organization";
-      readonly orgId: string;
-    };
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-  };
-}, CapxulError, import("@capxul/sdk").PermissionAssignInput>;
-declare const useCapxulPermissionRevoke: (orgId: OrgId) => UseMutationResult<{
-  readonly status: "submitted";
-  readonly executionId: string;
-  readonly commandId: PaymentCommandId;
-  readonly userOpHash: string;
-  readonly value: readonly {
-    readonly permissionId: PermissionId;
-    readonly orgId: string;
-    readonly type: "budget" | "managePeople";
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-    readonly revision: number;
-    readonly roleKey: RoleKey;
-    readonly tokenAddress?: Address | undefined;
-    readonly limitRaw?: WeiAmount | undefined;
-    readonly allowanceKey?: AllowanceKey | undefined;
-  }[] | {
-    readonly permissionId: PermissionId;
-    readonly orgId: string;
-    readonly type: "budget" | "managePeople";
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-    readonly revision: number;
-    readonly roleKey: RoleKey;
-    readonly tokenAddress?: Address | undefined;
-    readonly limitRaw?: WeiAmount | undefined;
-    readonly allowanceKey?: AllowanceKey | undefined;
-  } | {
-    readonly permissionAssignmentId: PermissionAssignmentId;
-    readonly permissionId: PermissionId;
-    readonly actor: {
-      readonly kind: "account";
-      readonly accountId: string;
-    } | {
-      readonly kind: "organization";
-      readonly orgId: string;
-    };
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-  };
-}, CapxulError, import("@capxul/sdk").PermissionRevokeInput>;
-declare const useCapxulPermissionReplace: (orgId: OrgId) => UseMutationResult<{
-  readonly status: "submitted";
-  readonly executionId: string;
-  readonly commandId: PaymentCommandId;
-  readonly userOpHash: string;
-  readonly value: readonly {
-    readonly permissionId: PermissionId;
-    readonly orgId: string;
-    readonly type: "budget" | "managePeople";
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-    readonly revision: number;
-    readonly roleKey: RoleKey;
-    readonly tokenAddress?: Address | undefined;
-    readonly limitRaw?: WeiAmount | undefined;
-    readonly allowanceKey?: AllowanceKey | undefined;
-  }[] | {
-    readonly permissionId: PermissionId;
-    readonly orgId: string;
-    readonly type: "budget" | "managePeople";
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-    readonly revision: number;
-    readonly roleKey: RoleKey;
-    readonly tokenAddress?: Address | undefined;
-    readonly limitRaw?: WeiAmount | undefined;
-    readonly allowanceKey?: AllowanceKey | undefined;
-  } | {
-    readonly permissionAssignmentId: PermissionAssignmentId;
-    readonly permissionId: PermissionId;
-    readonly actor: {
-      readonly kind: "account";
-      readonly accountId: string;
-    } | {
-      readonly kind: "organization";
-      readonly orgId: string;
-    };
-    readonly state: "active" | "pending" | "revoked" | "superseded" | "suspended";
-  };
-}, CapxulError, import("@capxul/sdk").PermissionReplaceInput>;
+type Operation = "create" | "change" | "assign" | "revoke" | "replace";
+type Input<K extends Operation> = Parameters<PermissionMethods[K]>[0];
+declare const useCapxulPermissionCreate: (orgId: OrgId) => UseMutationResult<SubmittedPermissionExecution, CapxulError, Input<"create">>;
+declare const useCapxulPermissionChange: (orgId: OrgId) => UseMutationResult<SubmittedPermissionExecution, CapxulError, Input<"change">>;
+declare const useCapxulPermissionAssign: (orgId: OrgId) => UseMutationResult<SubmittedPermissionExecution, CapxulError, Input<"assign">>;
+declare const useCapxulPermissionRevoke: (orgId: OrgId) => UseMutationResult<SubmittedPermissionExecution, CapxulError, Input<"revoke">>;
+declare const useCapxulPermissionReplace: (orgId: OrgId) => UseMutationResult<SubmittedPermissionExecution, CapxulError, Input<"replace">>;
 declare function useCapxulPermissions(orgId: OrgId, options?: {
   readonly enabled?: boolean;
 }): UseQueryResult<PermissionReadResult, CapxulError>;
@@ -569,7 +340,7 @@ type ContactsActor = {
   readonly kind: "personal";
 } | {
   readonly kind: "organization";
-  readonly orgId: OrgId$1 | undefined;
+  readonly orgId: OrgId | undefined;
 };
 /**
  * How a contact entered the book. Taken from the shipped surface rather than
@@ -868,7 +639,7 @@ type SendActor = {
   readonly kind: "personal";
 } | {
   readonly kind: "organization";
-  readonly orgId: OrgId$1 | undefined;
+  readonly orgId: OrgId | undefined;
 };
 type SentPayment = {
   /** The backend payment row. */
@@ -1064,7 +835,7 @@ interface PayrollGroupRow {
     /** The `partyId` — the stable id (ruling Q1), never an email. */
     readonly recipientId: string;
     readonly amount: string;
-    readonly currency: CurrencyCode;
+    readonly currency: Money["currency"];
   }[];
 }
 interface PayrollSummarySlice {
@@ -1150,8 +921,8 @@ interface PayrollRunAmountEntry {
   readonly error: MoneyParseErrorReason | null;
   /** True while the value is one we seeded and the employer has not edited. */
   readonly prefilled: boolean;
-  /** The treasury asset's currency — the one-option dropdown stays. */
-  readonly currency: CurrencyCode;
+  /** The treasury asset's currency. Rows stay absent until this value exists. */
+  readonly currency: Money["currency"];
 }
 interface PayrollRunAmountsSlice {
   readonly entries: readonly PayrollRunAmountEntry[];

package/dist/index.mjs

@@ -2647,13 +2647,6 @@ function termsSeeds(terms, asset, period) {
 //#region src/headless/payroll/use-payroll-run.ts
 const GRAMMAR = { grammar: "code" };
 /**
-* The one place the composer states a currency it has not read yet. The token
-* dropdown holds exactly one option — the treasury's — so before that read
-* lands there is no currency to name, and naming a wrong one would be a fake
-* green on the money itself.
-*/
-const CURRENCY_UNREAD = "";
-/**
 * The period this composer composes: an INSTANT run (ruling Q3). `authorizeRun`
 * stamps `start === end === runAt` at submit, and the payslip's period renders
 * that date.
@@ -2762,19 +2755,22 @@ function usePayrollRun(input) {
 		return resolved;
 	}, [refs, selected]);
 	const seeds = useMemo(() => termsSeeds(terms.data ?? [], assetMoney, INSTANT_RUN_PERIOD), [assetMoney, terms.data]);
-	const entries = useMemo(() => selected.map((recipientId) => {
-		const value = amountText(amounts, seeds, recipientId);
-		const parsed = assetMoney === null || value.trim() === "" ? null : parseMoney(value, assetMoney);
-		return {
-			recipientId,
-			name: named.get(recipientId)?.name ?? recipientId,
-			value,
-			change: (text) => change(recipientId, text),
-			error: parsed !== null && isMoneyParseError(parsed) ? parsed.reason : null,
-			prefilled: amounts[recipientId]?.prefilled ?? seeds.has(recipientId),
-			currency: assetMoney?.currency ?? CURRENCY_UNREAD
-		};
-	}), [
+	const entries = useMemo(() => {
+		if (assetMoney === null) return [];
+		return selected.map((recipientId) => {
+			const value = amountText(amounts, seeds, recipientId);
+			const parsed = value.trim() === "" ? null : parseMoney(value, assetMoney);
+			return {
+				recipientId,
+				name: named.get(recipientId)?.name ?? recipientId,
+				value,
+				change: (text) => change(recipientId, text),
+				error: parsed !== null && isMoneyParseError(parsed) ? parsed.reason : null,
+				prefilled: amounts[recipientId]?.prefilled ?? seeds.has(recipientId),
+				currency: assetMoney.currency
+			};
+		});
+	}, [
 		amounts,
 		assetMoney,
 		change,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/sdk-react",
-  "version": "2.8.0",
+  "version": "3.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Xelmar-tech/infrastructure.git",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@capxul/sdk": "2.8.0"
+    "@capxul/sdk": "3.0.0"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.66.9",
@@ -43,8 +43,8 @@
     "vite": "npm:@voidzero-dev/vite-plus-core@0.3.0",
     "vite-plus": "0.3.0",
     "vitest": "4.1.11",
-    "@capxul/types": "0.2.1",
     "@capxul/errors": "0.0.2",
+    "@capxul/types": "0.2.1",
     "@capxul/typescript-config": "0.0.0"
   },
   "peerDependencies": {