@whop/elements-react-native 0.1.0

package/lib/typescript/src/core/address/engine.d.ts

@@ -0,0 +1,97 @@
+/**
+ * The Chromium libaddressinput format engine, ported AS DATA from the developer-platform
+ * address-form fork (parse-remote-country-data). Three deliberate fixes over the fork:
+ *  - `zipRegex` is ENFORCED (validateAddressForm) — it was parsed-but-dead there;
+ *  - per-country `upper` flags apply at EMIT (emitAddress), never scattered through the UI;
+ *  - ISO2 is the ONE country boundary — uppercased once at the edge (normalizeCountry), and the
+ *    subdivision iso codes read the dataset's real `sub_isoids` key (the fork read a
+ *    `sub_iso_codes` field that never existed in the data).
+ */
+export interface RemoteCountryData {
+    /** Field order + availability: %-prefixed tokens (%N %O %A %C %S %Z %D %X, %n = newline)
+     *  mixed with literal text the postal service prints ("SE-", "SINGAPORE"). */
+    fmt?: string;
+    /** Latin variant of fmt for countries whose native script is non-latin. */
+    lfmt?: string;
+    /** Required-field flag characters (e.g. "ACSZ"). */
+    require?: string;
+    /** Fields the postal service expects uppercased (e.g. "CS"). */
+    upper?: string;
+    /** Country-level postal-code regex (unanchored in the dataset). */
+    zip?: string;
+    /** Example postal codes, comma-separated. */
+    zipex?: string;
+    zip_name_type?: string;
+    state_name_type?: string;
+    /** Subdivision keys / display names / latin names / iso codes, '~'-separated. */
+    sub_keys?: string;
+    sub_names?: string;
+    sub_lnames?: string;
+    sub_isoids?: string;
+}
+type FormatFieldType = 'name' | 'organization' | 'line1' | 'city' | 'state' | 'postal_code' | 'dependent_locality' | 'sorting_code';
+export interface StateOption {
+    key: string;
+    name: string;
+    iso?: string;
+}
+export interface FormatField {
+    type: FormatFieldType;
+    required: boolean;
+    upper: boolean;
+    postalPlaceholder?: string;
+}
+export interface CountryFormat {
+    country: string;
+    fields: FormatField[];
+    zipRegex?: string;
+    stateOptions: StateOption[];
+    stateLabel: StateLabelKind;
+    postalLabel: PostalLabelKind;
+}
+declare const STATE_LABELS: readonly ["province", "state", "county", "area", "emirate", "island", "parish", "prefecture", "oblast", "department", "do_si"];
+export type StateLabelKind = (typeof STATE_LABELS)[number];
+declare const POSTAL_LABELS: readonly ["postal", "zip", "pin", "eircode"];
+export type PostalLabelKind = (typeof POSTAL_LABELS)[number];
+export declare function normalizeCountry(code: string | undefined): string | undefined;
+export declare function parseCountryFormat(countryCode: string, rawData: RemoteCountryData | undefined): CountryFormat;
+/**
+ * Statically imported, unlike the web element's lazy chunk.
+ *
+ * Metro produces one bundle with no async chunks, so a dynamic `import()` fails at runtime with
+ * "Could not load bundle". Nothing is saved by deferring it either: the data ships in the bundle
+ * either way.
+ */
+export declare function loadCountryCatalog(): Promise<Record<string, RemoteCountryData>>;
+export declare function postalCodeMatches(zipRegex: string | undefined, value: string): boolean;
+export interface EmittedAddress {
+    name?: string;
+    first_name?: string;
+    last_name?: string;
+    organization?: string;
+    organization_type?: 'business' | 'individual';
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+    country: string;
+}
+/** The ONE emit boundary: trims, applies the country's upper flags, uppercases ISO2, and maps
+ *  internal values onto the frozen contract keys (postal_code naming matches ctok
+ *  billing_details 1:1). Empty values are dropped except the always-present country. */
+export declare function emitAddress(format: CountryFormat, values: {
+    name?: string;
+    first_name?: string;
+    last_name?: string;
+    organization?: string;
+    organization_type?: 'business' | 'individual' | '';
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+}): EmittedAddress;
+export declare function currencyCountry(currency: string | undefined): string | undefined;
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/lib/typescript/src/core/address/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../src/core/address/engine.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/core/address/form-state.d.ts

@@ -0,0 +1,144 @@
+import type { CountryFormat, EmittedAddress } from './engine.js';
+/**
+ * The address form's ONE state atom (useReducer shape) + the schema-driven central validator.
+ * Country lives IN the atom; hydration is ONE seed (defaultValues > detected IP country >
+ * currency-country hint > US) computed before first paint; reveal-vs-autofill is reducer
+ * state, not component-local flags. Pure module — the jsdom suites drive it directly.
+ */
+import type { ParsedPlaceAddress } from './places.js';
+export type AddressValueKey = 'name' | 'first_name' | 'last_name' | 'organization' | 'line1' | 'line2' | 'city' | 'state' | 'postal_code';
+export type AddressValues = Partial<Record<AddressValueKey, string>>;
+export interface CustomFieldSpec {
+    key: string;
+    label: string;
+    type: 'text' | 'select' | 'date' | 'phone';
+    position: 'after_name' | 'after_organization' | 'before_country' | 'after_address';
+    required?: boolean;
+    options?: string[];
+    format?: string;
+    autocomplete?: string;
+}
+export interface AddressFormConfig {
+    mode: 'billing' | 'shipping';
+    layout: 'compact' | 'full';
+    scope: 'minimal' | 'full';
+    name: 'combined' | 'split' | 'none';
+    organization: 'none' | 'name' | 'name_with_type';
+    line2: 'toggle' | 'always' | 'never';
+    autocomplete: boolean;
+    allowedCountries?: string[];
+    customFields?: CustomFieldSpec[];
+    /** Composed-mode method floor: contract keys the selected payment method additionally
+     *  requires (unioned into the visible + required set). */
+    requiredFloor?: string[];
+}
+export interface AddressSeedInput {
+    defaultValues?: {
+        name?: string;
+        address?: Partial<EmittedAddress>;
+    };
+    detectedCountry?: string;
+    countryHint?: string;
+}
+export interface AddressFormState {
+    country: string;
+    values: AddressValues;
+    organizationType: 'business' | 'individual' | '';
+    custom: Record<string, string>;
+    revealed: boolean;
+    line2Open: boolean;
+    selecting: boolean;
+    touched: Partial<Record<string, boolean>>;
+    showAllErrors: boolean;
+}
+export type AddressFormAction = {
+    type: 'edit';
+    field: AddressValueKey;
+    value: string;
+    autofilled?: boolean;
+} | {
+    type: 'edit-custom';
+    key: string;
+    value: string;
+} | {
+    type: 'set-organization-type';
+    value: 'business' | 'individual' | '';
+} | {
+    type: 'set-country';
+    country: string;
+} | {
+    type: 'begin-select';
+} | {
+    type: 'select-failed';
+} | {
+    type: 'apply-place';
+    parsed: ParsedPlaceAddress;
+    allowed: string[];
+} | {
+    type: 'reveal';
+    autofill?: boolean;
+} | {
+    type: 'toggle-line2';
+} | {
+    type: 'blur';
+    field: string;
+} | {
+    type: 'show-errors';
+};
+export declare function allowedCountryList(config: AddressFormConfig, catalogCountries: string[]): string[];
+export declare function seedAddressForm(config: AddressFormConfig, seed: AddressSeedInput, catalogCountries: string[]): AddressFormState;
+export declare function addressFormReducer(state: AddressFormState, action: AddressFormAction): AddressFormState;
+export type AddressErrorCode = 'required' | 'invalid';
+export interface AddressValidation {
+    errors: Partial<Record<string, AddressErrorCode>>;
+    complete: boolean;
+}
+export interface FieldPlan {
+    /** Address-grid fields in the country format's order, filtered to the config scope. */
+    gridFields: Array<'line1' | 'city' | 'state' | 'postal_code'>;
+    required: ReadonlySet<string>;
+}
+/** The commit-point allow gate ([] = unrestricted): a restrictive list declines a foreign OR
+ *  country-less parse — unknown provenance must not land foreign locality data under the locked
+ *  ISO2. Shared by the reducer arm and the placeSelected reaction (which must know BEFORE
+ *  reducing whether to mark the commit `placed` — a declined pick must not bump placeSeq). */
+/** The Places-gate allow list: [] = unrestricted. DISTINCT from allowedCountryList (the
+ *  country-select options, which falls back to the whole catalog) — feeding that catalog
+ *  fallback into placeAllowed would wrongly decline catalog-missing territories on
+ *  unrestricted configs. */
+/**
+ * The floor a scope implies, which is what makes `scope="minimal"` mean anything.
+ *
+ * Minimal renders EXACTLY the floor, so an empty floor renders an empty grid: the element shipped a
+ * country select and nothing else, and a buyer could complete that form while the card confirm then
+ * refused at the AVS check for a postal code never collected. Web wires the same value at
+ * apps/web/src/elements/payments/address.tsx:317.
+ */
+export declare function requiredFloorFor(scope: AddressFormConfig['scope']): string[] | undefined;
+export declare function placeAllowList(config: AddressFormConfig, catalogCountries: string[]): string[];
+export declare function placeAllowed(allowed: string[], parsed: ParsedPlaceAddress): boolean;
+/** The schema for a (country, config) pair: which grid fields exist and which fields are
+ *  required. Full scope = the country format's fields (its `require` flags) ∪ the floor;
+ *  minimal scope = EXACTLY the floor (plus country, the form's spine). */
+export declare function planFields(config: AddressFormConfig, format: CountryFormat): FieldPlan;
+export declare function validateAddressForm(config: AddressFormConfig, format: CountryFormat, state: AddressFormState): AddressValidation;
+/** Compact = city and postal share ONE row (format order within it), state below. */
+export declare function pairedGridRows(gridFields: FieldPlan['gridFields']): Array<Array<'city' | 'state' | 'postal_code'>>;
+/** Box-shadows follow the element's OWN border-radius, so the compact group's rounded
+ *  container cannot round the focus/invalid rings its cells paint — first- and last-row cells
+ *  carry their corner radii themselves (7px = the container's 8px radius minus its 1px
+ *  border), each cell of a two-column row rounding only its outer corner. Derived from the
+ *  same config + field plan that orders the rows: country formats drop and reorder fields,
+ *  and until the grid reveals the visible group ends at line1. */
+export declare function compactCellCorners(config: AddressFormConfig, gridFields: FieldPlan['gridFields'], visible: {
+    line2: boolean;
+    revealed: boolean;
+}): Record<string, string>;
+export interface AddressSnapshot {
+    complete: boolean;
+    address: EmittedAddress;
+    custom: Record<string, string>;
+    errors: Partial<Record<string, AddressErrorCode>>;
+}
+export declare function snapshotAddressForm(config: AddressFormConfig, format: CountryFormat, state: AddressFormState): AddressSnapshot;
+//# sourceMappingURL=form-state.d.ts.map

package/lib/typescript/src/core/address/form-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-state.d.ts","sourceRoot":"","sources":["../../../../../src/core/address/form-state.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/core/address/places.d.ts

@@ -0,0 +1,23 @@
+/** A resolved suggestion, in the same wire keys the address form emits. */
+export interface ParsedPlaceAddress {
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+    country?: string;
+}
+/**
+ * The country the buyer is dialling from, used as the address form's default before the buyer picks
+ * one. A miss falls through to `countryHint` and then US.
+ *
+ * Cloudflare's trace endpoint, which is what the web element reads — it uses the same-origin
+ * `/cdn-cgi/trace` because every rail it ships on sits behind Cloudflare. A native app has no
+ * origin, so this asks whop.com for the same thing.
+ *
+ * The previous port invented `https://whop.com/api/geo/`, which has never existed: it 404s (and
+ * `/api/geo` merely redirects to the same 404), so detection silently failed for every buyer and
+ * the form always opened on US.
+ */
+export declare function detectIpCountry(timeoutMs?: number): Promise<string | undefined>;
+//# sourceMappingURL=places.d.ts.map

package/lib/typescript/src/core/address/places.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"places.d.ts","sourceRoot":"","sources":["../../../../../src/core/address/places.ts"],"names":[],"mappings":"AAGA,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAanF"}

package/lib/typescript/src/core/address/suggest.d.ts

@@ -0,0 +1,47 @@
+import type { ParsedPlaceAddress } from './places.js';
+/** One row in the suggestion list. Display only — components arrive from `resolve`. */
+export interface AddressSuggestion {
+    id: string;
+    label: string;
+}
+/** The raw components a resolved pick carries, before per-country composition. */
+export interface RawComponents {
+    streetNumber?: string;
+    street?: string;
+    /** Set only when the platform had no street components but did name the place. */
+    line1?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    country?: string;
+}
+export declare function composeLine1(streetNumber: string | undefined, street: string | undefined, country: string | undefined): string | undefined;
+/** The suggestion rows a `suggest` call returned. */
+export declare function parseSuggestions(json: string): AddressSuggestion[];
+/**
+ * A resolved pick, in the wire keys the address form emits.
+ *
+ * `formCountry` backfills a resolve that names no country, which both geocoders do occasionally.
+ * Without it `composeLine1` orders the street as if it were number-last, and `placeAllowed` rejects
+ * a country-less parse whenever an allow list is active — so the pick silently no-ops.
+ */
+export declare function parseComponents(json: string, formCountry?: string): ParsedPlaceAddress | null;
+/**
+ * A geocoder's subdivision, as the catalog key the address engine validates against.
+ *
+ * The engine keys subdivisions by `sub_key` and builds each option's display name by joining the
+ * native and latin names — `[names[i] || key, latinNames[i]].join(' — ')` at
+ * core/address/engine.ts:141, so Tokyo's option is key `東京都` and name `東京都 — Tokyo`. A geocoder
+ * answers with ONE of those halves and never the joined form, so matching the whole `name` string
+ * misses every country whose catalog carries both scripts.
+ *
+ * An unmatched value resolves to undefined rather than to itself: it would render the state Select
+ * on its placeholder while still being emitted, so `apply-place` writing '' and surfacing the
+ * required-state error is the honest outcome.
+ */
+export declare function resolveSubdivision(value: string | undefined, options: {
+    key: string;
+    name: string;
+    iso?: string;
+}[]): string | undefined;
+//# sourceMappingURL=suggest.d.ts.map

package/lib/typescript/src/core/address/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../../../../src/core/address/suggest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAU,CAAC;AAEnD,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AA2CD,wBAAgB,YAAY,CAC3B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,GAAG,SAAS,CAMpB;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAclE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAuB7F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GACpD,MAAM,GAAG,SAAS,CAKpB"}

package/lib/typescript/src/core/address/use-suggestions.d.ts

@@ -0,0 +1,3 @@
+import type { AddressSuggestion } from './suggest.js';
+export declare function useAddressSuggestions(enabled: boolean, query: string): AddressSuggestion[];
+//# sourceMappingURL=use-suggestions.d.ts.map

package/lib/typescript/src/core/address/use-suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-suggestions.d.ts","sourceRoot":"","sources":["../../../../../src/core/address/use-suggestions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAW,CAAC;AAMnD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,CA2B1F"}

package/lib/typescript/src/core/payments/address-change.d.ts

@@ -0,0 +1,52 @@
+import type { EmittedAddress } from '../address/engine.js';
+/**
+ * The postal address the payment element's `addressChange` event carries: every place-identifying
+ * field the billing block collects, with the optionality the form itself has. Only `country` is
+ * guaranteed — each country's format collects its own field set (no state in the Netherlands, no
+ * postal code in Ireland, no line2 unless the buyer fills one), so a key is absent whenever the
+ * form did not collect a value for it. Name, organization, and email are not part of an address
+ * and stay off this event.
+ */
+export interface PostalAddress {
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+    country: string;
+}
+export interface AddressChange {
+    complete: boolean;
+    address: PostalAddress;
+}
+/**
+ * A buyer typing a postal code produces one form snapshot per keystroke, and the consumer turns
+ * every emit into a tax quote or a shipping-rate lookup — one network call per character is the
+ * failure mode this guards. 300ms is the settle window: longer than the gap between keystrokes at
+ * any real typing speed (so a whole postal code collapses into ONE emit), short enough that the
+ * quote is back before the buyer reaches the pay button. TRAILING edge only — a leading emit would
+ * fire on the first character, which is the one value guaranteed to be useless.
+ */
+export declare const ADDRESS_CHANGE_DEBOUNCE_MS = 300;
+export declare function postalAddressOf(address: EmittedAddress): PostalAddress;
+export interface AddressChangePublisher {
+    publish: (owner: string, change: AddressChange) => void;
+    /**
+     * The owner's block stopped being the address in force before its queued change settled — drop
+     * it. Scoped to the OWNER, not to the change object: a deselected block can still deliver one
+     * last snapshot in the very commit that deselects it (the form dispatches from a child effect,
+     * which flushes before this block's own), so a queue keyed on the change would miss the one
+     * actually in flight. A no-op once another block has queued its own — whichever order the two
+     * blocks' effects run in during a switch.
+     */
+    abandon: (owner: string) => void;
+}
+export declare const AddressChangePublishProvider: import("react").Provider<AddressChangePublisher>;
+export declare function usePublishAddressChange(): AddressChangePublisher;
+/**
+ * ELEMENT-SCOPED on purpose: every method tile mounts its own billing block, so the debounce
+ * timer and the last-emitted memory have to be shared across them — a per-block memory would
+ * suppress the republish that a tile switch back to an earlier address depends on.
+ */
+export declare function useAddressChangePublisher(emit: (change: AddressChange) => void): AddressChangePublisher;
+//# sourceMappingURL=address-change.d.ts.map

package/lib/typescript/src/core/payments/address-change.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-change.d.ts","sourceRoot":"","sources":["../../../../../src/core/payments/address-change.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAmB,CAAC;AAIxD;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAI9C,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAOtE;AAUD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IACxD;;;;;;;OAOG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAOD,eAAO,MAAM,4BAA4B,kDAAuC,CAAC;AAEjF,wBAAgB,uBAAuB,IAAI,sBAAsB,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,sBAAsB,CAkCvG"}

package/lib/typescript/src/core/payments/billing-merge.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The billing-details precedence merge for the confirm rail: explicit
+ * `createConfirmationToken({ billingDetails })` input > standalone address element values >
+ * the payment element's internal billing block. Applied twice along the cascade (controller
+ * merges the address element under the input; the payment element merges its block under the
+ * result) — scalars merge field-level, the address object is ATOMIC per source (a mixed-source
+ * address would be incoherent), which keeps the two applications associative.
+ */
+import type { EmittedAddress } from '../address/engine.js';
+interface BillingAddressBag {
+    country?: string;
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+}
+export interface BillingDetailsBag {
+    email?: string;
+    name?: string;
+    phone?: string;
+    address?: BillingAddressBag;
+}
+export interface CollectedAddressSnapshot {
+    complete: boolean;
+    completeWithoutPhone?: boolean;
+    phoneRequired?: boolean;
+    address: EmittedAddress;
+    phone?: string;
+}
+/**
+ * Merge a collected form snapshot UNDER an explicit billing-details bag. When the collected
+ * form is the address source actually being used and it is incomplete, the merge throws — a
+ * confirm over a half-filled form must fail loud, exactly like the surfaces' own validation
+ * (an explicit complete input keeps winning silently).
+ */
+export declare function mergeBillingWithCollected(explicit: BillingDetailsBag | undefined, collected: CollectedAddressSnapshot | undefined): BillingDetailsBag | undefined;
+export {};
+//# sourceMappingURL=billing-merge.d.ts.map

package/lib/typescript/src/core/payments/billing-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-merge.d.ts","sourceRoot":"","sources":["../../../../../src/core/payments/billing-merge.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAmB,CAAC;AAExD,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyBD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,SAAS,EAAE,wBAAwB,GAAG,SAAS,GAC9C,iBAAiB,GAAG,SAAS,CAsB/B"}

package/lib/typescript/src/core/payments/browser-info.d.ts

@@ -0,0 +1,12 @@
+import type { BrowserInfo } from '../../api/types.js';
+/**
+ * The React Native counterpart of the web element's `browser_info` capture.
+ *
+ * The field names are the wire's, because the backend feeds them to 3DS, which was specified for
+ * browsers. An app has no `navigator`, so each value is the nearest honest platform fact rather
+ * than a fabricated browser one — omitted where there is no honest answer.
+ */
+export declare function capturedBrowserInfo(): BrowserInfo;
+/** The one platform read; kept separate so the locale default can reuse it. */
+export declare function deviceLocale(): string | undefined;
+//# sourceMappingURL=browser-info.d.ts.map

package/lib/typescript/src/core/payments/browser-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-info.d.ts","sourceRoot":"","sources":["../../../../../src/core/payments/browser-info.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAiB,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,CAcjD;AAOD,+EAA+E;AAC/E,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CASjD"}

package/lib/typescript/src/core/payments/bt.d.ts

@@ -0,0 +1,55 @@
+import type { useBasisTheory } from '@basis-theory/react-native-elements';
+import type { WhopClient } from '../../api/client.js';
+import type { PaymentTokenizationErrorCode } from './errors.js';
+/** The package re-exports the hook but not its return type, so derive it rather than reach into a
+ *  deep path that could move. */
+export type BasisTheoryElements = NonNullable<ReturnType<typeof useBasisTheory>['bt']>;
+/** The opaque handle a Basis Theory element hands out. It carries an id and a formatter, never the
+ *  value the buyer typed — which is the whole isolation guarantee. */
+export interface CardRefs {
+    number: unknown;
+    expiryMonth: unknown;
+    expiryYear: unknown;
+    cvc: unknown;
+}
+export type CardFieldFailure = 'incomplete' | 'invalid' | undefined;
+export interface CardFieldFailures {
+    number?: CardFieldFailure;
+    expiry?: CardFieldFailure;
+    cvc?: CardFieldFailure;
+}
+export interface CardTokenizationFailure {
+    ok: false;
+    code: PaymentTokenizationErrorCode;
+    message: string;
+    fields?: CardFieldFailures;
+}
+export type CardTokenizationResult = {
+    ok: true;
+    token: string;
+} | CardTokenizationFailure;
+/**
+ * Assemble one Basis Theory card token from the three field refs.
+ *
+ * This is the web ceremony (`card-fields/bt.ts`) with the frame hops removed: a BT session anchors
+ * a nonce-derived container, the number seeds an ephemeral token into it, the Whop backend
+ * authorizes the session for that container alone, and the remaining fields patch in under the
+ * session key. The web element splits these across three iframes and threads a serializable grant
+ * between them; here all three refs live in one realm, so the grant never leaves this function.
+ *
+ * The ceremony is kept rather than collapsed into a single create because it is what the
+ * card-assembly Basis Theory application is configured to permit: the backend authorizes
+ * `token:update` scoped to `starts_with` the derived container, for ten minutes.
+ */
+export declare function tokenizeCard(bt: BasisTheoryElements, refs: CardRefs, command: {
+    accountId: string;
+    publicKey: string;
+}, sdk: WhopClient): Promise<CardTokenizationResult>;
+/**
+ * Must byte-match the backend's `Digest::SHA256.hexdigest` — lowercase hex, no separators.
+ *
+ * `@noble/hashes` UTF-8 encodes a string input itself, which is also why this does not reach for
+ * `TextEncoder`: React Native has no DOM and does not guarantee one.
+ */
+export declare function sha256Hex(value: string): string;
+//# sourceMappingURL=bt.d.ts.map

package/lib/typescript/src/core/payments/bt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bt.d.ts","sourceRoot":"","sources":["../../../../../src/core/payments/bt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,aAAU,CAAC;AAE7D;iCACiC;AACjC,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAEvF;sEACsE;AACtE,MAAM,WAAW,QAAQ;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;CACb;AAED,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IACjC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACvC,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,MAAM,sBAAsB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,uBAAuB,CAAC;AAI3F;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CACjC,EAAE,EAAE,mBAAmB,EACvB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EACjD,GAAG,EAAE,UAAU,GACb,OAAO,CAAC,sBAAsB,CAAC,CA2EjC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/lib/typescript/src/core/payments/currency.d.ts

@@ -0,0 +1,7 @@
+export declare function currencyMinorDigits(currency: string): number;
+/** Major-unit decimal (how money rides the wire) → the minor-unit integer a charge takes, on the
+ *  backend's factor above — never Intl's. toFixed(4) first (kills float-scale artifacts like
+ *  29.99×100 → 2998.999…), then trunc (a genuinely sub-minor fraction never rounds the charge UP). */
+export declare function toMinorUnits(majorAmount: number, currency: string): number;
+export declare function currencyDisplayDigits(currency: string): number;
+//# sourceMappingURL=currency.d.ts.map

package/lib/typescript/src/core/payments/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../../../../src/core/payments/currency.ts"],"names":[],"mappings":"AAgCA,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;sGAEsG;AACtG,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1E;AAKD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI9D"}

package/lib/typescript/src/core/payments/detail.d.ts

@@ -0,0 +1,53 @@
+import type { PaymentMethodConfigurationShape, PaymentMethodTypeResource } from '../../api/types.js';
+export type MatrixEntry = PaymentMethodTypeResource & {
+    next_action_render_modes?: string[];
+    supports_fresh_collection?: boolean;
+    submit_button?: {
+        label?: string;
+        kind?: string;
+    };
+};
+export type { PaymentMethodConfigurationShape };
+/**
+ * Which checkout is asking. The matrix leaves out methods that do not serve the named surface, and
+ * the axis is who BUILT the checkout, not where it runs.
+ *
+ * A React Native mount is `direct_checkout`: it owns its own presentation the way a first-party
+ * whop.com document does, and unlike an iframe it can hand a full-page step to the system browser.
+ * Sending `external_checkout` would drop every `full_page`-only method from the list.
+ */
+export type CheckoutSurface = 'direct_checkout' | 'embedded_checkout' | 'modal_checkout' | 'external_checkout';
+declare const TEMPLATES: readonly ["redirect", "bnpl_confirm", "bank_connect", "bank_wire", "wallet_sheet", "none"];
+export type DetailTemplate = (typeof TEMPLATES)[number];
+export interface WalletAvailability {
+    applePay?: boolean;
+    googlePay?: boolean;
+}
+export declare function detailTemplate(entry: MatrixEntry): DetailTemplate;
+export declare function passesConfiguration(type: string, configuration: PaymentMethodConfigurationShape | undefined, platformDefault?: boolean): boolean;
+/** The entry's category-keyed config block, read generically. */
+export declare function methodConfigBlock(entry: MatrixEntry): Record<string, unknown>;
+export declare function methodTokenizerKey(entry: MatrixEntry): string | undefined;
+/**
+ * Whether the entry is offered for this charge on this surface.
+ *
+ * Amount-gated methods are excluded outright rather than rendered disabled, and every absent field
+ * reads as unrestricted so an older matrix keeps its behavior.
+ */
+export declare function presentMethod(entry: MatrixEntry, currency: string, amount: number, setupFutureUsage: 'off_session' | 'on_session' | undefined, walletAvailability: WalletAvailability | undefined, configuration: PaymentMethodConfigurationShape | undefined, surface: CheckoutSurface, country?: string): boolean;
+/** Listed types take their list position; unlisted types share the tail rank, so a stable sort
+ *  preserves their incoming order. */
+export declare function orderRank(type: string, order: readonly string[]): number;
+export declare function formatMinorAmount(amount: number, currency: string, locale: string): string;
+export declare function fieldLabel(name: string): string;
+/** A declared field's country-keyed pattern, `*` as the fallback. Never throws on a bad pattern. */
+export declare function fieldMatches(formats: Record<string, string> | undefined, country: string | undefined, value: string): boolean;
+/**
+ * The billing countries a method constrains the buyer to, or null when it constrains nothing.
+ *
+ * `*` anywhere in the entry's per-currency list means unrestricted, and so does an empty list — a
+ * method that names countries names ALL of the ones it serves. The address element intersects the
+ * result with the integrator's own `allowedCountries` rather than replacing it.
+ */
+export declare function methodBillingCountries(entry: Pick<PaymentMethodTypeResource, 'currencies'> | undefined, currency: string): string[] | null;
+//# sourceMappingURL=detail.d.ts.map

package/lib/typescript/src/core/payments/detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detail.d.ts","sourceRoot":"","sources":["../../../../../src/core/payments/detail.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,MAAM,oBAAiB,CAAC;AAGlG,MAAM,MAAM,WAAW,GAAG,yBAAyB,GAAG;IACrD,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,aAAa,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD,CAAC;AAEF,YAAY,EAAE,+BAA+B,EAAE,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAsB/G,QAAA,MAAM,SAAS,4FAA6F,CAAC;AAC7G,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAKjE;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,+BAA+B,GAAG,SAAS,EAC1D,eAAe,CAAC,EAAE,OAAO,GACvB,OAAO,CAOT;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG7E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAGzE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,aAAa,GAAG,YAAY,GAAG,SAAS,EAC1D,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,EAClD,aAAa,EAAE,+BAA+B,GAAG,SAAS,EAC1D,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,MAAM,GACd,OAAO,CA6BT;AAmBD;sCACsC;AACtC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGxE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAS1F;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,oGAAoG;AACpG,wBAAgB,YAAY,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC3C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,GACX,OAAO,CAOT;AAUD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,IAAI,CAAC,yBAAyB,EAAE,YAAY,CAAC,GAAG,SAAS,EAChE,QAAQ,EAAE,MAAM,GACd,MAAM,EAAE,GAAG,IAAI,CAGjB"}