@whop/elements-react-native 0.1.0

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

@@ -0,0 +1,62 @@
+export type ChargeConfigErrorCode = 'PLAN_INLINE_CONFLICT' | 'CHARGE_CONFIG_MISSING' | 'PLAN_ACCOUNT_MISMATCH' | 'PLAN_RESOLUTION_FAILED';
+/** The plan/inline charge-config refusals — CODED like the framework's lifecycle refusals
+ *  (switch on `code`, never string-match). The message carries the code prefix too because a
+ *  wire boot failure (`controller-failed`) delivers the MESSAGE alone to the handle's onError. */
+export declare class ChargeConfigError extends Error {
+    readonly code: ChargeConfigErrorCode;
+    constructor(code: ChargeConfigErrorCode, message: string);
+}
+export type BrandingRequiredErrorCode = 'BRANDING_NOT_MOUNTED' | 'BRANDING_HIDDEN';
+/** The merchant-of-record refusal. `BRANDING_NOT_MOUNTED` remains in the error-code contract for
+ *  clients compiled against 1.0.0-beta.1; the compatibility runtime only emits `BRANDING_HIDDEN`
+ *  when a mounted notice has been CSS-hidden or shrunk. */
+export declare class BrandingRequiredError extends Error {
+    readonly code: BrandingRequiredErrorCode;
+    constructor(code: BrandingRequiredErrorCode, message: string);
+}
+export type SelectErrorCode = 'METHOD_NOT_OFFERED';
+/** The `select` action's refusals — the same coded shape as ChargeConfigError (switch on `code`;
+ *  the message carries the code prefix because the wire rpc rail delivers the message alone). */
+export declare class SelectError extends Error {
+    readonly code: SelectErrorCode;
+    constructor(code: SelectErrorCode, message: string);
+}
+export type SecureFieldErrorCode = 'SECURE_FIELD_TOKENIZER_UNAVAILABLE' | 'SECURE_FIELD_TOKENIZE_FAILED';
+/** The secure declared-field refusals (a secure value could not be tokenized, so the confirm
+ *  never ran) — the same coded shape as the other refusal families. */
+export declare class SecureFieldError extends Error {
+    readonly code: SecureFieldErrorCode;
+    constructor(code: SecureFieldErrorCode, message: string);
+}
+export type PaymentTokenizationFailureStage = 'card_fields' | 'card_tokenizer_session' | 'card_number' | 'card_session_authorization' | 'card_expiry' | 'card_cvc' | 'confirmation_token_create';
+export type PaymentTokenizationErrorCode = 'card_fields_not_ready' | 'card_tokenizer_session_failed' | 'card_number_validation_failed' | 'card_number_tokenization_failed' | 'card_session_authorization_failed' | 'card_expiry_validation_failed' | 'card_expiry_tokenization_failed' | 'card_cvc_validation_failed' | 'card_cvc_tokenization_failed' | 'confirmation_token_create_failed';
+interface PaymentTokenizationFailure {
+    code: PaymentTokenizationErrorCode;
+    failureStage: PaymentTokenizationFailureStage;
+    message: string;
+}
+export declare class PaymentTokenizationError extends Error {
+    readonly code: PaymentTokenizationErrorCode;
+    readonly failureStage: PaymentTokenizationFailureStage;
+    readonly buyerMessage: string;
+    constructor(code: PaymentTokenizationErrorCode, message: string);
+}
+export declare function paymentTokenizationFailureOf(error: unknown): PaymentTokenizationFailure | undefined;
+export declare function paymentTokenizationBuyerMessage(error: unknown, fallback: string): string;
+export type NextActionErrorCode = 'FULL_PAGE_STEP_IN_FRAME';
+/** handleNextAction's posture refusal (a full_page-only step reached a document that cannot
+ *  navigate the whole tab, so nothing ran) — the same coded shape as the other refusal
+ *  families. */
+export declare class NextActionError extends Error {
+    readonly code: NextActionErrorCode;
+    constructor(code: NextActionErrorCode, message: string);
+}
+/** Whether a caught error is this family's refusal for `code`, wherever it was caught: the
+ *  structured `code` survives an in-process throw, and the `[CODE]` message prefix is the
+ *  family's own WIRE encoding — the rpc rail re-mints a rejection from `.message` alone, which
+ *  is the whole reason these constructors bake the code into the message. Decoding the prefix
+ *  here is reading that contract, not string-matching prose. */
+export declare function isNextActionRefusal(error: unknown, code: NextActionErrorCode): boolean;
+export declare function apiErrorMessage(err: unknown, fallback: string): string;
+export {};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/core/payments/errors.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,qBAAqB,GAC7B,sBAAsB,GACtB,uBAAuB,GACvB,uBAAuB,GACvB,wBAAwB,CAAC;AAE7B;;kGAEkG;AAClG,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;gBAEzB,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM;CAKzD;AAED,MAAM,MAAM,yBAAyB,GAAG,sBAAsB,GAAG,iBAAiB,CAAC;AAEnF;;2DAE2D;AAC3D,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;gBAE7B,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM;CAK7D;AAED,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEnD;iGACiG;AACjG,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;gBAEnB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAKnD;AAED,MAAM,MAAM,oBAAoB,GAAG,oCAAoC,GAAG,8BAA8B,CAAC;AAEzG;uEACuE;AACvE,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;gBAExB,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM;CAKxD;AAED,MAAM,MAAM,+BAA+B,GACvC,aAAa,GACb,wBAAwB,GACxB,aAAa,GACb,4BAA4B,GAC5B,aAAa,GACb,UAAU,GACV,2BAA2B,CAAC;AAEhC,MAAM,MAAM,4BAA4B,GACpC,uBAAuB,GACvB,+BAA+B,GAC/B,+BAA+B,GAC/B,iCAAiC,GACjC,mCAAmC,GACnC,+BAA+B,GAC/B,iCAAiC,GACjC,4BAA4B,GAC5B,8BAA8B,GAC9B,kCAAkC,CAAC;AAEvC,UAAU,0BAA0B;IAClC,IAAI,EAAE,4BAA4B,CAAC;IACnC,YAAY,EAAE,+BAA+B,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAeD,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,+BAA+B,CAAC;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,IAAI,EAAE,4BAA4B,EAAE,OAAO,EAAE,MAAM;CAOhE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,GAAG,SAAS,CAUnG;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIxF;AAED,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAE5D;;gBAEgB;AAChB,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;gBAEvB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM;CAKvD;AAED;;;;gEAIgE;AAChE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAItF;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE"}

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

@@ -0,0 +1,74 @@
+import type { WhopClient } from '../../api/client.js';
+export interface MintBillingDetails {
+    email: string;
+    name?: string;
+    phone?: string;
+    address?: {
+        country?: string;
+        line1?: string;
+        city?: string;
+        postal_code?: string;
+    };
+}
+export interface MintContext {
+    accountId: string | undefined;
+    returnUrl: string | undefined;
+    setupFutureUsage: 'off_session' | 'on_session' | undefined;
+}
+/** The collected bag a surface's `collect` verb returns — everything the CONTROLLER needs to
+ *  mint: the assembled payment_method slice, the surface-validated billing block, and any
+ *  declared inputs that belong on billing_details. Serializable — it crosses the surface's
+ *  frame into the controller frame. */
+export interface CollectedPayment {
+    paymentMethod: {
+        type: string;
+        category: string;
+    } & Record<string, unknown>;
+    billingDetails: MintBillingDetails;
+    billingExtra?: Record<string, string>;
+}
+/** The ONE confirmation-token mint — run by the CONTROLLER's internal action only, in the
+ *  controller frame, with the controller's sdk + accountId/returnUrl/setupFutureUsage context.
+ *  (Exception: WhopPaymentRequest tokenizes + mints host-side — it must run without a mounted
+ *  controller.) */
+export declare function mintConfirmationToken(sdk: WhopClient, context: MintContext, paymentMethod: {
+    type: string;
+    category: string;
+} & Record<string, unknown>, billingDetails: MintBillingDetails, billingExtra?: Record<string, string>): Promise<{
+    confirmationToken: string;
+    type: string;
+}>;
+export declare function validateBillingEmail(billing: {
+    email?: string;
+} | undefined): MintBillingDetails;
+export declare function assertCardBilling(billing: MintBillingDetails): void;
+interface CollectionSurface {
+    /** advisory CLAIM-axis liveness (`ctx.children.<key>.created`) — "may I address it". */
+    created: boolean;
+    collect: (input: unknown) => Promise<unknown>;
+}
+export interface CollectionSurfaces {
+    /** the payment element's collect (a.controllerOnly — it orchestrates its own selection). */
+    payment: CollectionSurface;
+    /** the fused card element's collect (a.controllerOnly). */
+    card: CollectionSurface;
+    /** the exploded card-fields sub's collect (a.controller — the only parent-reachable action
+     *  kind on a sub: `ctx.children.<sub>` routes through `runtime.dispatch`, which refuses
+     *  internal). */
+    cardFields: CollectionSurface;
+}
+/** The framework's CODED lifecycle refusals (`childRefusal`, controller-core): switch on
+ *  `code`, never string-match — the message is the human channel. */
+export declare function isChildRefusal(err: unknown): boolean;
+/**
+ * The delegation cascade: COLLECTION belongs to the active surface, tried in precedence order —
+ * payment element, fused card element, exploded card-fields unit; each validates its own
+ * requirements and returns the serializable collected bag, and the CONTROLLER mints from it.
+ * Occupancy is DECIDED, not caught: `.created` (the advisory claim-axis probe) picks the live
+ * face; a coded lifecycle refusal (the check→invoke race — a face destroyed in between) falls
+ * through to the next; a live surface's own error re-throws untouched — its refusal is the
+ * answer.
+ */
+export declare function collectThroughLiveSurface(surfaces: CollectionSurfaces, input: unknown): Promise<CollectedPayment>;
+export {};
+//# sourceMappingURL=mint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mint.d.ts","sourceRoot":"","sources":["../../../../../src/core/payments/mint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAkB,CAAC;AAKnD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrF;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gBAAgB,EAAE,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;CAC5D;AAED;;;uCAGuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5E,cAAc,EAAE,kBAAkB,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;;mBAGmB;AACnB,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3E,cAAc,EAAE,kBAAkB,EAClC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCtD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,kBAAkB,CAGhG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAEnE;AAED,UAAU,iBAAiB;IACzB,wFAAwF;IACxF,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,4FAA4F;IAC5F,OAAO,EAAE,iBAAiB,CAAC;IAC3B,2DAA2D;IAC3D,IAAI,EAAE,iBAAiB,CAAC;IACxB;;qBAEiB;IACjB,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED;qEACqE;AACrE,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGpD;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,gBAAgB,CAAC,CAU3B"}

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

@@ -0,0 +1,69 @@
+import type { PaymentMethodConfigurationShape, PlanResource } from '../../api/types.js';
+import type { WhopClient } from '../../api/client.js';
+/** The widened props bag both runtimes hand to the charge resolution — the controller seed's
+ *  `ctx.props` and the host sources' live props view are each one branch of the plan-vs-inline
+ *  union, so every key is optional here and `chargeInputOf` decides which branch is in force. */
+export interface ChargeProps {
+    accountId?: string;
+    plan?: string;
+    currency?: string;
+    amount?: number;
+    setupFutureUsage?: 'off_session' | 'on_session';
+    paymentMethodConfiguration?: PaymentMethodConfigurationShape;
+}
+/** `config = resolve(plan)`: the ONE normalized charge config every downstream path consumes —
+ *  the inline props ARE the degenerate case (`plan` undefined, fields verbatim), and a plan is
+ *  a preset that resolves to this same shape. */
+export interface ResolvedCharge {
+    configured: true;
+    plan: string | undefined;
+    currency: string;
+    amount: number;
+    setupFutureUsage: 'off_session' | 'on_session' | undefined;
+    paymentMethodConfiguration: PaymentMethodConfigurationShape | undefined;
+}
+/** The optionless statics-rail boot (`WhopElements.payments.handleNextAction` — the namespace
+ *  handle mounts with an EMPTY options bag): no charge input exists and none is needed, the
+ *  static flow never collects. Collection-face projections refuse on it, loudly. */
+export interface UnconfiguredCharge {
+    configured: false;
+    plan: undefined;
+    currency: undefined;
+    amount: undefined;
+    setupFutureUsage: undefined;
+    paymentMethodConfiguration: undefined;
+}
+export type ChargeState = ResolvedCharge | UnconfiguredCharge;
+export declare const UNCONFIGURED_CHARGE: UnconfiguredCharge;
+/** ZERO charge inputs mounted — the only shape that resolves to UNCONFIGURED_CHARGE; any
+ *  PARTIAL config still throws the loud ChargeConfigError (a half-config is a consumer bug). */
+export declare function chargeless(props: ChargeProps): boolean;
+interface ChargeInput {
+    accountId: string | undefined;
+    plan: string | undefined;
+    currency: string | undefined;
+    amount: number | undefined;
+    setupFutureUsage: 'off_session' | 'on_session' | undefined;
+    paymentMethodConfiguration: PaymentMethodConfigurationShape | undefined;
+}
+/** The plan-XOR-inline gate: `plan` alongside any inline charge key is a conflict, and neither
+ *  is a missing config — both refuse LOUDLY with a coded `ChargeConfigError`. */
+export declare function chargeInputOf(props: ChargeProps): ChargeInput;
+export declare function inlineCharge(input: ChargeInput): ResolvedCharge;
+/** The slice of the SDK's own plan the charge resolution reads — the schema is the author,
+ *  nothing hand-typed to drift. `effective_payment_method_configuration` is the GOVERNING
+ *  configuration resolved server-side through every layer; `null` means platform defaults, and
+ *  there is no fallback to the plan's own editable override — the backend publishing the field
+ *  deploys BENEATH this code by PR stacking. */
+export type RetrievedPlan = Pick<PlanResource, 'id' | 'currency' | 'initial_price' | 'plan_type' | 'account' | 'effective_payment_method_configuration'>;
+/**
+ * Normalize a retrieved plan into the inline shape. The plan's `account_id` must MATCH the
+ * mounted `accountId` — the handle's account stays the mount key, and a foreign plan is a coded
+ * refusal, never a silent re-key. A renewing plan attests `off_session` save-consent unless the
+ * consumer set the attestation explicitly (the charge vaults the method for renewals).
+ */
+export declare function chargeFromPlan(resource: RetrievedPlan, input: ChargeInput): ResolvedCharge;
+/** The one charge resolution. Inline props resolve with no network; a plan costs one GET. */
+export declare function resolveCharge(client: WhopClient, props: ChargeProps): Promise<ChargeState>;
+export {};
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../../src/core/payments/plan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,+BAA+B,EAAE,YAAY,EAAE,MAAM,oBAAiB,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAkB,CAAC;AAKnD;;iGAEiG;AACjG,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IAChD,0BAA0B,CAAC,EAAE,+BAA+B,CAAC;CAC9D;AAED;;iDAEiD;AACjD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;IAC3D,0BAA0B,EAAE,+BAA+B,GAAG,SAAS,CAAC;CACzE;AAED;;oFAEoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,KAAK,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,gBAAgB,EAAE,SAAS,CAAC;IAC5B,0BAA0B,EAAE,SAAS,CAAC;CACvC;AAED,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,kBAAkB,CAAC;AAE9D,eAAO,MAAM,mBAAmB,EAAE,kBAOhC,CAAC;AAEH;gGACgG;AAChG,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAQtD;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,gBAAgB,EAAE,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;IAC3D,0BAA0B,EAAE,+BAA+B,GAAG,SAAS,CAAC;CACzE;AAED;iFACiF;AACjF,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CA4B7D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAS/D;AAED;;;;gDAIgD;AAChD,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,YAAY,EACZ,IAAI,GAAG,UAAU,GAAG,eAAe,GAAG,WAAW,GAAG,SAAS,GAAG,wCAAwC,CACzG,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,GAAG,cAAc,CA+B1F;AAaD,6FAA6F;AAC7F,wBAAsB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAiBhG"}

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

@@ -0,0 +1,12 @@
+/**
+ * Refusals that exist only on React Native, kept out of the ported `errors.ts` so that file stays a
+ * clean mirror of the web element's.
+ *
+ * Every one is coded, so a caller switches on `code` and never string-matches a message.
+ */
+export type PaymentsRefusalCode = 'CONFIRMATION_IN_FLIGHT' | 'NEXT_ACTION_IN_FLIGHT' | 'NEXT_ACTION_PRESENTATION_FAILED' | 'CHARGE_CONFIG_MISSING' | 'NO_COLLECTION_SURFACE' | 'NATIVE_MODULE_MISSING' | 'WALLET_UNAVAILABLE';
+export declare class PaymentsRefusalError extends Error {
+    readonly code: PaymentsRefusalCode;
+    constructor(code: PaymentsRefusalCode, message: string);
+}
+//# sourceMappingURL=refusals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refusals.d.ts","sourceRoot":"","sources":["../../../../../src/core/payments/refusals.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC5B,wBAAwB,GACxB,uBAAuB,GACvB,iCAAiC,GACjC,uBAAuB,GACvB,uBAAuB,GACvB,uBAAuB,GACvB,oBAAoB,CAAC;AAExB,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;gBAEvB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM;CAKtD"}

package/lib/typescript/src/core/payments/secure-fields.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The secure declared-field rail (payment-api.md §4): a matrix field marked `secure: true`
+ * renders as a Basis Theory hosted text element wearing the suite's input chrome, so the raw
+ * value NEVER exists in our JavaScript — at collect time the selected method's element
+ * INSTANCES are tokenized into ONE Basis Theory token intent, keyed by field name
+ * (`{ type: 'token', data: { bank_account: <element> } }`; BT interpolates each element's value
+ * server-side, producing exactly the legacy checkout's additional-data shape, so the
+ * checkout.com mandate interpolation `$.data.<name>` consumes it unchanged), and the category
+ * payload carries `{ token }`. The create rides the web-elements SDK's element path under the
+ * method's config-block publishable key (`tokenizer` + `public_key`, the card block's source).
+ * Intents expire on BT's default clock (24h) — the confirm consumes one long before that.
+ */
+import type { BasisTheoryElements } from './bt.js';
+/** A hosted text element instance. Opaque by construction — it carries an id and a formatter, never
+ *  the value the buyer typed. */
+type ITextElement = unknown;
+/** Applied by BT inside the hosted element at tokenization (String.replace semantics):
+ *  whitespace stripped — buyers type the spaced IBAN print format, the electronic format rides. */
+export declare const secureValueTransform: RegExp;
+export declare function secureFieldValidation(field: {
+    formats?: Record<string, string> | null;
+    input_formats?: Record<string, string> | null;
+}): RegExp | undefined;
+/** Raw-data token intents ride BT's REST surface with the publishable key — the wallet sheets'
+ *  leg alone (Google's tokenizationData.token is a raw string, no hosted element exists to
+ *  reference). */
+export declare function createRawTokenIntent(publicKey: string, data: unknown): Promise<string>;
+export declare function tokenizeSecureFields(bt: BasisTheoryElements | undefined, elements: Record<string, ITextElement>, 
+/** The method's OWN config-block key. Passed per call because Basis Theory's client is a
+ *  module-level singleton — the first key constructed wins for the whole process. */
+apiKey: string): Promise<string>;
+export {};
+//# sourceMappingURL=secure-fields.d.ts.map

package/lib/typescript/src/core/payments/secure-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-fields.d.ts","sourceRoot":"","sources":["../../../../../src/core/payments/secure-fields.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAM,CAAC;AAIhD;iCACiC;AACjC,KAAK,YAAY,GAAG,OAAO,CAAC;AAI5B;mGACmG;AACnG,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAQ3C,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAC/C,GAAG,MAAM,GAAG,SAAS,CASrB;AAED;;kBAEkB;AAClB,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAU5F;AAED,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,mBAAmB,GAAG,SAAS,EACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;AACtC;qFACqF;AACrF,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAejB"}