@incodetech/core 0.0.0-dev-20260313-486e658 → 0.0.0-dev-20260313-bc2dab4

package/dist/phoneManager-BsamACjL.d.ts

@@ -0,0 +1,370 @@
+import { t as Manager } from "./Manager-CXnC-tN_.js";
+import { t as ActorRefFrom } from "./Actor-BAf9LRYf.js";
+
+//#region src/modules/phone/types.d.ts
+
+/**
+ * Configuration options for phone verification.
+ *
+ * @example Standard OTP verification
+ * ```typescript
+ * const config: PhoneConfig = {
+ *   otpVerification: true,
+ *   otpExpirationInMinutes: 5,
+ *   prefill: false,
+ * };
+ * ```
+ *
+ * @example With all options
+ * ```typescript
+ * const config: PhoneConfig = {
+ *   otpVerification: true,
+ *   otpExpirationInMinutes: 10,
+ *   prefill: true,
+ *   isInstantVerify: false,
+ *   optinEnabled: true,
+ *   maxOtpAttempts: 3,
+ * };
+ * ```
+ */
+type PhoneConfig = {
+  /**
+   * Whether to require OTP (SMS code) verification.
+   * If false, phone is verified immediately after submission.
+   */
+  otpVerification: boolean;
+  /**
+   * How long the OTP code remains valid, in minutes.
+   * After expiration, user must request a new code.
+   */
+  otpExpirationInMinutes: number;
+  /**
+   * Whether to pre-populate with user's previously stored phone number.
+   * Useful for returning users.
+   */
+  prefill: boolean;
+  /**
+   * Use carrier-based instant verification instead of OTP.
+   * Not available in all regions.
+   * @default false
+   */
+  isInstantVerify?: boolean;
+  /**
+   * Show a marketing opt-in checkbox in the UI.
+   * User's preference is sent with the phone submission.
+   * @default false
+   */
+  optinEnabled?: boolean;
+  /**
+   * Maximum number of OTP verification attempts before lockout.
+   * After exhausting attempts, user sees an error state.
+   * @default 3
+   */
+  maxOtpAttempts?: number;
+};
+//#endregion
+//#region src/modules/phone/phoneStateMachine.d.ts
+
+declare const phoneMachine: any;
+type PhoneMachine = typeof phoneMachine;
+//#endregion
+//#region src/modules/phone/phoneActor.d.ts
+type CreatePhoneActorOptions = {
+  config: PhoneConfig;
+};
+type PhoneActor = ActorRefFrom<PhoneMachine>;
+//#endregion
+//#region src/modules/phone/phoneManager.d.ts
+/** Phone manager is in initial state, waiting for `load()` to be called */
+type PhoneIdleState = {
+  status: 'idle';
+};
+/** Loading prefilled phone number from backend (if prefill is enabled) */
+type PhoneLoadingPrefillState = {
+  status: 'loadingPrefill';
+};
+/**
+ * Ready for phone input - use `setPhoneNumber()` and `submit()`
+ * @property countryCode - ISO country code (e.g., 'US', 'MX')
+ * @property phonePrefix - International dialing prefix (e.g., '+1', '+52')
+ * @property prefilledPhone - Pre-populated phone number (if prefill enabled)
+ * @property phoneError - Validation error message if phone was rejected
+ */
+type PhoneInputtingState = {
+  status: 'inputting';
+  countryCode: string;
+  phonePrefix: string;
+  prefilledPhone?: string;
+  phoneError?: string;
+};
+/** Phone number is being submitted to the backend */
+type PhoneSubmittingState = {
+  status: 'submitting';
+};
+/** OTP is being sent to the phone number */
+type PhoneSendingOtpState = {
+  status: 'sendingOtp';
+};
+/**
+ * Waiting for OTP code - use `submitOtp()`, `resendOtp()`, or `back()`
+ * @property resendTimer - Seconds remaining before resend is allowed
+ * @property canResend - Whether the resend button should be enabled
+ * @property attemptsRemaining - Number of OTP verification attempts left
+ */
+type PhoneAwaitingOtpState = {
+  status: 'awaitingOtp';
+  resendTimer: number;
+  canResend: boolean;
+  attemptsRemaining: number;
+};
+/** OTP code is being verified against the backend */
+type PhoneVerifyingOtpState = {
+  status: 'verifyingOtp';
+};
+/**
+ * OTP verification failed - user can retry with `submitOtp()`
+ * @property error - Error message describing why verification failed
+ * @property attemptsRemaining - Number of remaining attempts before lockout
+ */
+type PhoneOtpErrorState = {
+  status: 'otpError';
+  error: string;
+  attemptsRemaining: number;
+};
+/** Phone verification completed successfully */
+type PhoneFinishedState = {
+  status: 'finished';
+};
+/**
+ * Fatal error occurred - call `reset()` to start over
+ * @property error - Error message describing what went wrong
+ */
+type PhoneErrorState = {
+  status: 'error';
+  error: string;
+};
+/**
+ * Union of all possible phone manager states.
+ * Use discriminated union pattern to narrow the type:
+ *
+ * @example
+ * ```typescript
+ * const state = phoneManager.getState();
+ * if (state.status === 'inputting') {
+ *   // TypeScript knows state has countryCode, phonePrefix, etc.
+ *   console.log(state.countryCode);
+ * }
+ * ```
+ */
+type PhoneState = PhoneIdleState | PhoneLoadingPrefillState | PhoneInputtingState | PhoneSubmittingState | PhoneSendingOtpState | PhoneAwaitingOtpState | PhoneVerifyingOtpState | PhoneOtpErrorState | PhoneFinishedState | PhoneErrorState;
+/**
+ * Creates a phone verification manager for headless or UI-driven usage.
+ *
+ * The manager provides a state machine-based API for phone number verification
+ * with optional OTP (one-time password) verification.
+ *
+ * @param options - Configuration options
+ * @param options.config - Phone verification configuration
+ * @param options.config.otpVerification - Whether to require OTP verification
+ * @param options.config.otpExpirationInMinutes - How long the OTP is valid
+ * @param options.config.prefill - Whether to fetch a pre-filled phone number
+ * @param options.config.isInstantVerify - Use instant verification API
+ * @param options.config.optinEnabled - Show marketing opt-in checkbox
+ * @param options.config.maxOtpAttempts - Maximum OTP verification attempts (default: 3)
+ *
+ * @returns Phone manager with state, API methods, and subscription
+ *
+ * @example Headless usage
+ * ```typescript
+ * const manager = createPhoneManager({
+ *   config: { otpVerification: true, otpExpirationInMinutes: 5, prefill: false },
+ * });
+ *
+ * manager.subscribe((state) => console.log(state.status));
+ * manager.load();
+ * manager.setPhoneNumber('+14155551234', true);
+ * manager.submit();
+ * // ... wait for 'awaitingOtp' state ...
+ * manager.submitOtp('ABC123');
+ * manager.stop();
+ * ```
+ *
+ * @example With React/Preact UI hook
+ * ```tsx
+ * const [state, manager] = useManager(() => createPhoneManager({ config }));
+ *
+ * if (state.status === 'inputting') {
+ *   return <input onChange={(e) => manager.setPhoneNumber(e.target.value, true)} />;
+ * }
+ * ```
+ */
+declare function createPhoneManager(options: CreatePhoneActorOptions): Manager<PhoneState> & {
+  /**
+   * Initializes the phone verification flow.
+   * Transitions from 'idle' to 'loadingPrefill' or 'inputting'.
+   * Must be called before any other method.
+   */
+  load(): void;
+  /**
+   * Sets the phone number for verification.
+   * Should be called when state is 'inputting'.
+   *
+   * @param phone - Full phone number with country code (e.g., '+14155551234')
+   * @param isValid - Whether the phone number passes validation
+   *
+   * @example
+   * ```typescript
+   * // Using libphonenumber-js for validation
+   * import { isValidPhoneNumber } from 'libphonenumber-js';
+   * const phone = '+14155551234';
+   * phoneManager.setPhoneNumber(phone, isValidPhoneNumber(phone));
+   * ```
+   */
+  setPhoneNumber(phone: string, isValid: boolean): void;
+  /**
+   * Sets the marketing opt-in preference.
+   * Only relevant if `config.optinEnabled` is true.
+   *
+   * @param granted - Whether the user consented to receive marketing messages
+   */
+  setOptInGranted(granted: boolean): void;
+  /**
+   * Submits the phone number for verification.
+   * Requires a valid phone number to be set via `setPhoneNumber()`.
+   * Transitions to 'submitting', then to 'sendingOtp' or 'success' (if no OTP).
+   */
+  submit(): void;
+  /**
+   * Sets the OTP code without submitting.
+   * Use this for controlled input components.
+   *
+   * @param code - The OTP code entered by the user
+   */
+  setOtpCode(code: string): void;
+  /**
+   * Sets and submits the OTP code in one call.
+   * Should be called when state is 'awaitingOtp' or 'otpError'.
+   *
+   * @param code - The complete OTP code (typically 6 alphanumeric characters)
+   *
+   * @example
+   * ```typescript
+   * // Submit OTP when user completes entry
+   * phoneManager.submitOtp('HH36LP');
+   * ```
+   */
+  submitOtp(code: string): void;
+  /**
+   * Requests a new OTP code to be sent.
+   * Only works when state is 'awaitingOtp' and `canResend` is true.
+   * Resets the resend timer.
+   */
+  resendOtp(): void;
+  /**
+   * Returns to the phone input screen from OTP entry.
+   * Allows the user to change their phone number.
+   * Transitions from 'awaitingOtp' or 'otpError' back to 'inputting'.
+   */
+  back(): void;
+  /**
+   * Resets the manager to initial state.
+   * Can be called from 'success' or 'error' states to start over.
+   * Clears all stored data including phone number and OTP.
+   */
+  reset(): void;
+};
+declare function createPhoneManagerFromActor(actor: PhoneActor): Manager<PhoneState> & {
+  /**
+   * Initializes the phone verification flow.
+   * Transitions from 'idle' to 'loadingPrefill' or 'inputting'.
+   * Must be called before any other method.
+   */
+  load(): void;
+  /**
+   * Sets the phone number for verification.
+   * Should be called when state is 'inputting'.
+   *
+   * @param phone - Full phone number with country code (e.g., '+14155551234')
+   * @param isValid - Whether the phone number passes validation
+   *
+   * @example
+   * ```typescript
+   * // Using libphonenumber-js for validation
+   * import { isValidPhoneNumber } from 'libphonenumber-js';
+   * const phone = '+14155551234';
+   * phoneManager.setPhoneNumber(phone, isValidPhoneNumber(phone));
+   * ```
+   */
+  setPhoneNumber(phone: string, isValid: boolean): void;
+  /**
+   * Sets the marketing opt-in preference.
+   * Only relevant if `config.optinEnabled` is true.
+   *
+   * @param granted - Whether the user consented to receive marketing messages
+   */
+  setOptInGranted(granted: boolean): void;
+  /**
+   * Submits the phone number for verification.
+   * Requires a valid phone number to be set via `setPhoneNumber()`.
+   * Transitions to 'submitting', then to 'sendingOtp' or 'success' (if no OTP).
+   */
+  submit(): void;
+  /**
+   * Sets the OTP code without submitting.
+   * Use this for controlled input components.
+   *
+   * @param code - The OTP code entered by the user
+   */
+  setOtpCode(code: string): void;
+  /**
+   * Sets and submits the OTP code in one call.
+   * Should be called when state is 'awaitingOtp' or 'otpError'.
+   *
+   * @param code - The complete OTP code (typically 6 alphanumeric characters)
+   *
+   * @example
+   * ```typescript
+   * // Submit OTP when user completes entry
+   * phoneManager.submitOtp('HH36LP');
+   * ```
+   */
+  submitOtp(code: string): void;
+  /**
+   * Requests a new OTP code to be sent.
+   * Only works when state is 'awaitingOtp' and `canResend` is true.
+   * Resets the resend timer.
+   */
+  resendOtp(): void;
+  /**
+   * Returns to the phone input screen from OTP entry.
+   * Allows the user to change their phone number.
+   * Transitions from 'awaitingOtp' or 'otpError' back to 'inputting'.
+   */
+  back(): void;
+  /**
+   * Resets the manager to initial state.
+   * Can be called from 'success' or 'error' states to start over.
+   * Clears all stored data including phone number and OTP.
+   */
+  reset(): void;
+};
+/**
+ * Type representing a phone manager instance.
+ * Includes state access, API methods, and lifecycle management.
+ *
+ * @property getState - Returns the current PhoneState
+ * @property subscribe - Subscribes to state changes, returns unsubscribe function
+ * @property stop - Stops the manager and cleans up resources
+ * @property load - Initializes the verification flow
+ * @property setPhoneNumber - Sets the phone number
+ * @property setOptInGranted - Sets marketing opt-in preference
+ * @property submit - Submits the phone number
+ * @property setOtpCode - Sets OTP code without submitting
+ * @property submitOtp - Sets and submits OTP code
+ * @property resendOtp - Requests new OTP code
+ * @property back - Returns to phone input from OTP screen
+ * @property reset - Resets to initial state
+ */
+type PhoneManager = ReturnType<typeof createPhoneManager>;
+//#endregion
+export { phoneMachine as a, createPhoneManagerFromActor as i, PhoneState as n, PhoneConfig as o, createPhoneManager as r, PhoneManager as t };

package/dist/redirect-to-mobile.d.ts

@@ -1,4 +1,4 @@
-import { t as Manager } from "./Manager-CG5CQ1kY.js";
+import { t as Manager } from "./Manager-CXnC-tN_.js";
 
 //#region src/modules/redirect-to-mobile/types.d.ts
 type RedirectToMobileConfig = {

package/dist/redirect-to-mobile.esm.js

@@ -1,7 +1,7 @@
-import { A as createManager, g as BrowserTimerProvider } from "./src-D3v6I2la.esm.js";
-import { a as createActor, i as fromPromise, n as assign, r as fromCallback, t as setup } from "./xstate.esm-07M59Cte.esm.js";
-import { t as api } from "./api-3fZO5bmj.esm.js";
-import { t as endpoints } from "./endpoints-5sPFFmaB.esm.js";
+import { A as createManager, g as BrowserTimerProvider } from "./src-BmVrWkLJ.esm.js";
+import { a as createActor, i as fromPromise, n as assign, r as fromCallback, t as setup } from "./xstate.esm-CcoTezCZ.esm.js";
+import { t as api } from "./api-C2uzxrpN.esm.js";
+import { t as endpoints } from "./endpoints-IAlXA1zN.esm.js";
 
 //#region ../infra/src/url/urlUtils.ts
 function getUrlSearchParam(url, param) {