@oxyhq/services 30.0.0 → 30.1.0

package/lib/typescript/module/ui/utils/iconNames.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Type-safe icon name utilities
+ *
+ * Provides centralized, typed icon name mappings to eliminate `as any` casts
+ * when using dynamic icon names with @expo/vector-icons.
+ */
+/**
+ * Profile field icons (MaterialCommunityIcons)
+ */
+export declare const PROFILE_FIELD_ICONS: {
+    readonly displayName: "account-outline";
+    readonly username: "at";
+    readonly email: "email-outline";
+    readonly bio: "text-box-outline";
+    readonly location: "map-marker-outline";
+    readonly links: "link-variant";
+    readonly website: "web";
+    readonly phone: "phone-outline";
+    readonly birthday: "cake-variant-outline";
+};
+export type ProfileFieldIconKey = keyof typeof PROFILE_FIELD_ICONS;
+/**
+ * Get icon name for a profile field
+ */
+export declare function getProfileFieldIcon(field: string): string;
+/**
+ * Settings section icons (MaterialCommunityIcons)
+ */
+export declare const SETTINGS_ICONS: {
+    readonly account: "account-cog-outline";
+    readonly privacy: "shield-account-outline";
+    readonly security: "lock-outline";
+    readonly notifications: "bell-outline";
+    readonly language: "translate";
+    readonly appearance: "palette-outline";
+    readonly storage: "folder-outline";
+    readonly help: "help-circle-outline";
+    readonly about: "information-outline";
+    readonly logout: "logout";
+};
+export type SettingsIconKey = keyof typeof SETTINGS_ICONS;
+/**
+ * Get icon name for a settings section
+ */
+export declare function getSettingsIcon(section: string): string;
+/**
+ * File type icons (MaterialCommunityIcons)
+ */
+export declare const FILE_TYPE_ICONS: {
+    readonly image: "image-outline";
+    readonly video: "video-outline";
+    readonly audio: "music-note-outline";
+    readonly document: "file-document-outline";
+    readonly pdf: "file-pdf-box";
+    readonly archive: "folder-zip-outline";
+    readonly code: "code-tags";
+    readonly spreadsheet: "file-excel-outline";
+    readonly presentation: "file-presentation-outline";
+    readonly text: "file-document-edit-outline";
+    readonly unknown: "file-outline";
+};
+export type FileTypeIconKey = keyof typeof FILE_TYPE_ICONS;
+/**
+ * Get icon name for a file type
+ */
+export declare function getFileTypeIcon(type: string): string;
+/**
+ * Action icons (Ionicons)
+ */
+export declare const ACTION_ICONS: {
+    readonly close: "close";
+    readonly back: "chevron-back";
+    readonly forward: "chevron-forward";
+    readonly add: "add";
+    readonly remove: "remove";
+    readonly delete: "trash-outline";
+    readonly edit: "pencil-outline";
+    readonly save: "checkmark";
+    readonly cancel: "close";
+    readonly search: "search-outline";
+    readonly filter: "filter-outline";
+    readonly sort: "swap-vertical-outline";
+    readonly refresh: "refresh-outline";
+    readonly share: "share-outline";
+    readonly copy: "copy-outline";
+    readonly download: "download-outline";
+    readonly upload: "cloud-upload-outline";
+};
+export type ActionIconKey = keyof typeof ACTION_ICONS;
+/**
+ * Get icon name for an action
+ */
+export declare function getActionIcon(action: string): string;
+/**
+ * Status icons (Ionicons)
+ */
+export declare const STATUS_ICONS: {
+    readonly success: "checkmark-circle";
+    readonly error: "alert-circle";
+    readonly warning: "warning";
+    readonly info: "information-circle";
+    readonly loading: "hourglass-outline";
+    readonly pending: "time-outline";
+    readonly online: "ellipse";
+    readonly offline: "ellipse-outline";
+};
+export type StatusIconKey = keyof typeof STATUS_ICONS;
+/**
+ * Get icon name for a status
+ */
+export declare function getStatusIcon(status: string): string;
+//# sourceMappingURL=iconNames.d.ts.map

package/lib/typescript/module/ui/utils/iconNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconNames.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/iconNames.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;CAUtB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAEnE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;CAWjB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,cAAc,CAAC;AAE1D;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;CAYlB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,eAAe,CAAC;AAE3D;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;CAkBf,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,YAAY,CAAC;AAEtD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,YAAY,CAAC;AAEtD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/lib/typescript/module/ui/utils/isWebBrowser.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Web-browser detection for `@oxyhq/services`.
+ *
+ * The predicate now lives ONCE in `@oxyhq/core` (`isWebBrowser`) so services and
+ * auth-sdk share the exact same DOM probe. This module re-exposes it under the
+ * existing internal import path so consumers stay unchanged.
+ */
+export { isWebBrowser } from '@oxyhq/core';
+//# sourceMappingURL=isWebBrowser.d.ts.map

package/lib/typescript/module/ui/utils/isWebBrowser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isWebBrowser.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/isWebBrowser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/lib/typescript/module/ui/utils/netConnectivity.d.ts

@@ -0,0 +1,17 @@
+export interface NetInfoLikeState {
+    isConnected: boolean | null;
+    isInternetReachable?: boolean | null;
+}
+/**
+ * Mirrors Bloom `ConnectionStatusToasts` reachability semantics: a link that
+ * reports connected but explicitly unreachable (captive portal, no route) counts
+ * as offline.
+ */
+export declare function isNetConnectivityOnline(state: NetInfoLikeState): boolean;
+/**
+ * Conservative offline verdict for boot-path probes. Unknown / probing states
+ * (`null`, timed-out fetch) resolve to "not offline" so a flaky probe never
+ * skips a real sign-in.
+ */
+export declare function isNetConnectivityExplicitlyOffline(state: NetInfoLikeState | null | undefined): boolean;
+//# sourceMappingURL=netConnectivity.d.ts.map

package/lib/typescript/module/ui/utils/netConnectivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"netConnectivity.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/netConnectivity.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAExE;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GACzC,OAAO,CAKT"}

package/lib/typescript/module/ui/utils/oauthReturn.d.ts

@@ -0,0 +1,48 @@
+import type { OxyServices } from '@oxyhq/core';
+import type { OAuthSessionCommitInput } from '../oauth/types.js';
+/**
+ * When the RP lands with `?code=` after signing in at auth.oxy.so, exchange the
+ * code for a device-first session before cold boot runs.
+ *
+ * This is the REDIRECT transport's return leg. The SDK never starts a full-page
+ * authorize navigation on its own any more (#691 phase 7b), but this lane is
+ * still load-bearing: a browser-BLOCKED sign-in popup falls back to a full-page
+ * redirect (`startWebOAuthSignIn`), and that redirect comes back here.
+ *
+ * It owns only what is specific to a full-page round trip — reading the code off
+ * the URL, recovering the handshake `sessionStorage` carried across the
+ * navigation, and cleaning both up afterwards — and delegates state validation,
+ * the PKCE exchange, and the session commit to `completeOAuthCode`, the same
+ * function the popup transport runs.
+ *
+ * It is also the SINGLE cleanup path for an OAuth `error` landing on the URL:
+ * any `?error=…` (including an `error=login_required` left over from the
+ * now-deleted silent restore) is stripped along with `state` /
+ * `error_description`, and the stale PKCE handshake is cleared.
+ */
+export declare function tryCompleteOAuthReturn(opts: {
+    oxyServices: OxyServices;
+    clientId?: string | null;
+    authRedirectUri?: string;
+    commitSession: (input: OAuthSessionCommitInput) => Promise<void>;
+}): Promise<boolean>;
+/**
+ * Rewrite the address bar after an authorize round trip, and tell the router.
+ *
+ * Prefers the page the visit started on (see `persistOAuthReturnPath`) over the
+ * bare origin the IdP redirected to, falling back to `fallbackUrl` when nothing
+ * was recorded.
+ *
+ * The `popstate` dispatch is the load-bearing part. `history.replaceState`
+ * fires no event, and cold boot runs *inside* the mounted app — by the time
+ * this executes, a history-based router (React Router, Vue Router, …) has
+ * already read `location` and rendered the route for `/`. Without a
+ * notification the address bar would show the restored deep link while the page
+ * still displayed the home page. `popstate` is the event the History API
+ * defines for exactly this, and it is what those routers subscribe to.
+ *
+ * Only dispatched when the URL actually changed, so the common no-op case does
+ * not push a spurious event at every listener on the page.
+ */
+export declare function replaceUrlAfterOAuthReturn(fallbackUrl: string): void;
+//# sourceMappingURL=oauthReturn.d.ts.map

package/lib/typescript/module/ui/utils/oauthReturn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthReturn.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/oauthReturn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS/C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAgB,CAAC;AAG9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE,GAAG,OAAO,CAAC,OAAO,CAAC,CA6CnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAuBpE"}

package/lib/typescript/module/ui/utils/sessionHelpers.d.ts

@@ -0,0 +1,48 @@
+import type { ClientSession } from '@oxyhq/core';
+interface DeviceSession {
+    sessionId: string;
+    deviceId?: string;
+    deviceName?: string;
+    expiresAt?: string;
+    lastActive?: string;
+    user?: {
+        id?: string;
+        _id?: {
+            toString(): string;
+        };
+    };
+    userId?: string;
+    isCurrent?: boolean;
+}
+/**
+ * Service type for session helpers.
+ * Uses 'unknown' to work around TypeScript mixin composition type inference issues.
+ * The OxyServices class has these methods but TypeScript can't see them due to the mixin pattern.
+ * Methods are accessed dynamically, so callers must pass a properly typed instance.
+ */
+type OxyServicesAny = any;
+export interface FetchSessionsWithFallbackOptions {
+    fallbackDeviceId?: string;
+    fallbackUserId?: string;
+    logger?: (message: string, error?: unknown) => void;
+}
+/**
+ * Normalize backend session payloads into `ClientSession` objects.
+ *
+ * @param sessions - Raw session array returned from the API
+ * @param fallbackDeviceId - Device identifier to use when missing from payload
+ * @param fallbackUserId - User identifier to use when missing from payload
+ */
+export declare const mapSessionsToClient: (sessions: DeviceSession[], fallbackDeviceId?: string, fallbackUserId?: string) => ClientSession[];
+/**
+ * Fetch device sessions, falling back to the per-user session endpoint
+ * if the device endpoint is unavailable (older API versions or disabled
+ * device-grouping feature flag).
+ *
+ * @param oxyServices - Oxy service instance
+ * @param sessionId - Session identifier to fetch
+ * @param options - Optional fallback options
+ */
+export declare const fetchSessionsWithFallback: (oxyServices: OxyServicesAny, sessionId: string, { fallbackDeviceId, fallbackUserId, logger, }?: FetchSessionsWithFallbackOptions) => Promise<ClientSession[]>;
+export {};
+//# sourceMappingURL=sessionHelpers.d.ts.map

package/lib/typescript/module/ui/utils/sessionHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionHelpers.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/sessionHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,UAAU,aAAa;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE;YAAE,QAAQ,IAAI,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AAEH,KAAK,cAAc,GAAG,GAAG,CAAC;AAE1B,MAAM,WAAW,gCAAgC;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,aAAa,EAAE,EACzB,mBAAmB,MAAM,EACzB,iBAAiB,MAAM,KACtB,aAAa,EAgBf,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GACpC,aAAa,cAAc,EAC3B,WAAW,MAAM,EACjB,gDAIG,gCAAqC,KACvC,OAAO,CAAC,aAAa,EAAE,CAYzB,CAAC"}

package/lib/typescript/module/ui/utils/storageHelpers.d.ts

@@ -0,0 +1,28 @@
+export interface StorageInterface {
+    getItem: (key: string) => Promise<string | null>;
+    setItem: (key: string, value: string) => Promise<void>;
+    removeItem: (key: string) => Promise<void>;
+    clear: () => Promise<void>;
+}
+export interface SessionStorageKeys {
+    activeSessionId: string;
+    sessionIds: string;
+    language: string;
+}
+/**
+ * Detect whether the current runtime is React Native.
+ */
+export declare const isReactNative: () => boolean;
+/**
+ * Create a platform-appropriate storage implementation.
+ * Defaults to in-memory storage when no platform storage is available.
+ */
+export declare const createPlatformStorage: () => Promise<StorageInterface>;
+export declare const STORAGE_KEY_PREFIX = "oxy_session";
+/**
+ * Produce strongly typed storage key names for the supplied prefix.
+ *
+ * @param prefix - Storage key prefix
+ */
+export declare const getStorageKeys: (prefix?: string) => SessionStorageKeys;
+//# sourceMappingURL=storageHelpers.d.ts.map

package/lib/typescript/module/ui/utils/storageHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageHelpers.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/storageHelpers.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuFD;;GAEG;AACH,eAAO,MAAM,aAAa,QAAO,OACwC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAa,OAAO,CAAC,gBAAgB,CAMtE,CAAC;AAEF,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,SAAQ,MAA2B,KAAG,kBAInE,CAAC"}

package/lib/typescript/module/ui/utils/userUtils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * User display name and date formatting utilities.
+ *
+ * Display-name helpers follow the API contract: prefer `name.displayName` when
+ * present, otherwise fall back to the normalized handle via
+ * `getNormalizedUserHandle`.
+ */
+import { type DisplayNameUserShape } from '@oxyhq/core';
+/**
+ * Formats a date string to a readable format (e.g., "Feb 21, 2025")
+ */
+export declare const formatDate: (dateString: string | undefined | null | Date) => string;
+/**
+ * Gets a display name from user data.
+ *
+ * Prefers API `name.displayName`, then the normalized handle.
+ */
+export declare const getDisplayName: (user: DisplayNameUserShape | null | undefined) => string;
+/**
+ * Gets a short display name (first token) for compact UI.
+ */
+export declare const getShortDisplayName: (user: DisplayNameUserShape | null | undefined) => string;
+//# sourceMappingURL=userUtils.d.ts.map

package/lib/typescript/module/ui/utils/userUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userUtils.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/userUtils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,YAAY,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,KAAG,MAezE,CAAC;AAQF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,oBAAoB,GAAG,IAAI,GAAG,SAAS,KAC5C,MAIF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,MAAM,oBAAoB,GAAG,IAAI,GAAG,SAAS,KAC5C,MAcF,CAAC"}

package/lib/typescript/module/utils/hookUtils.d.ts

@@ -0,0 +1,102 @@
+/**
+ * React hook utilities for common patterns and state management
+ */
+/**
+ * Hook for managing async operations with loading, error, and data states
+ */
+export declare function useAsync<T>(asyncFn: () => Promise<T>, deps?: React.DependencyList): {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+    execute: () => Promise<T>;
+};
+/**
+ * Hook for managing async operations that execute on mount
+ */
+export declare function useAsyncEffect<T>(asyncFn: () => Promise<T>, deps?: React.DependencyList): {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook for debounced values
+ */
+export declare function useDebounce<T>(value: T, delay: number): T;
+/**
+ * Hook for throttled values
+ */
+export declare function useThrottle<T>(value: T, delay: number): T;
+/**
+ * Hook for previous value
+ */
+export declare function usePrevious<T>(value: T): T | undefined;
+/**
+ * Hook for boolean state with toggle
+ */
+export declare function useToggle(initialValue?: boolean): {
+    value: boolean;
+    toggle: () => void;
+    setTrue: () => void;
+    setFalse: () => void;
+    setValue: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+};
+/**
+ * Hook for counter state
+ */
+export declare function useCounter(initialValue?: number): {
+    count: number;
+    increment: () => void;
+    decrement: () => void;
+    reset: () => void;
+    setValue: (value: number) => void;
+};
+/**
+ * Hook for local storage (platform-safe)
+ */
+export declare function useLocalStorage<T>(key: string, initialValue: T): readonly [T, (value: T | ((val: T) => T)) => void];
+/**
+ * Hook for session storage (platform-safe)
+ */
+export declare function useSessionStorage<T>(key: string, initialValue: T): readonly [T, (value: T | ((val: T) => T)) => void];
+/**
+ * Hook for window size (platform-safe)
+ */
+export declare function useWindowSize(): {
+    width: number;
+    height: number;
+};
+/**
+ * Hook for scroll position (platform-safe)
+ */
+export declare function useScrollPosition(): number;
+/**
+ * Hook for online/offline status (platform-safe)
+ */
+export declare function useOnlineStatus(): boolean;
+/**
+ * Hook for media queries (platform-safe)
+ */
+export declare function useMediaQuery(query: string): boolean;
+/**
+ * Hook for keyboard events (platform-safe)
+ */
+export declare function useKeyPress(targetKey: string): boolean;
+/**
+ * Hook for click outside detection (platform-safe)
+ */
+export declare function useClickOutside(ref: React.RefObject<HTMLElement>, handler: () => void): void;
+/**
+ * Hook for form validation
+ */
+export declare function useFormValidation<T extends Record<string, unknown>>(initialValues: T, validationSchema: (values: T) => Partial<Record<keyof T, string>>): {
+    values: T;
+    errors: Partial<Record<keyof T, string>>;
+    touched: Partial<Record<keyof T, boolean>>;
+    isValid: boolean;
+    setValue: (field: keyof T, value: T[keyof T]) => void;
+    setTouchedField: (field: keyof T) => void;
+    setValues: import("react").Dispatch<import("react").SetStateAction<T>>;
+    setErrors: import("react").Dispatch<import("react").SetStateAction<Partial<Record<keyof T, string>>>>;
+    setTouched: import("react").Dispatch<import("react").SetStateAction<Partial<Record<keyof T, boolean>>>>;
+};
+//# sourceMappingURL=hookUtils.d.ts.map

package/lib/typescript/module/utils/hookUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookUtils.d.ts","sourceRoot":"","sources":["../../../../src/utils/hookUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,IAAI,GAAE,KAAK,CAAC,cAAmB;;;;;EAyBhC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,IAAI,GAAE,KAAK,CAAC,cAAmB;;;;EAkChC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAczD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAkBzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAQtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,YAAY,UAAQ;;;;;;EAQ7C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,YAAY,SAAI;;;;;sBAMJ,MAAM;EAG5C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,wBAYxB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,WAazD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,wBAY1B,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,WAazD;AAED;;GAEG;AACH,wBAAgB,aAAa;;;EAqB5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,WAehC;AAED;;GAEG;AACH,wBAAgB,eAAe,YAmB9B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAkBpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CA4BtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,IAAI,QAmBrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,aAAa,EAAE,CAAC,EAChB,gBAAgB,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;;;;;sBAU5B,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;6BAQnB,MAAM,CAAC;;;;EAsBpD"}

package/lib/typescript/module/webauthn/passkeyClient.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Passkey / WebAuthn ceremony client — clean default (non-web) implementation.
+ *
+ * This is the base module TypeScript resolves for TYPES and any bundler that
+ * does not pick a platform variant. It intentionally imports NOTHING browser-
+ * specific (no `@simplewebauthn/browser`) so it stays safe for Metro, native
+ * builds, and SSR. The real ceremony lives in `passkeyClient.web.ts`; native
+ * passkeys are Commons' job, so there is no WebAuthn ceremony here.
+ *
+ * `isPasskeySupported()` returns `false` (no relying-party origin / no browser
+ * WebAuthn API), and the ceremony helpers throw a clear error so a caller that
+ * skipped the support gate fails loudly instead of silently.
+ */
+/** Always `false` off the web — there is no relying-party origin or WebAuthn API. */
+export declare function isPasskeySupported(): boolean;
+/** Not available off the web — throws. Guard with {@link isPasskeySupported} first. */
+export declare function runRegistrationCeremony(_optionsJSON: unknown): Promise<unknown>;
+/** Not available off the web — throws. Guard with {@link isPasskeySupported} first. */
+export declare function runAuthenticationCeremony(_optionsJSON: unknown): Promise<unknown>;
+//# sourceMappingURL=passkeyClient.d.ts.map

package/lib/typescript/module/webauthn/passkeyClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passkeyClient.d.ts","sourceRoot":"","sources":["../../../../src/webauthn/passkeyClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,qFAAqF;AACrF,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,uFAAuF;AACvF,wBAAsB,uBAAuB,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAErF;AAED,uFAAuF;AACvF,wBAAsB,yBAAyB,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAEvF"}

package/lib/typescript/module/webauthn/passkeyClient.native.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Passkey / WebAuthn ceremony client — NATIVE implementation.
+ *
+ * React Native has no browser WebAuthn API, and Oxy's native passkey story is
+ * Commons (shared-keychain / QR handoff), NOT `navigator.credentials`. So this
+ * variant imports NOTHING browser-specific and mirrors the clean default:
+ * unsupported, and the ceremony helpers throw if a caller skipped the gate.
+ */
+/** Always `false` on native — there is no browser WebAuthn API. */
+export declare function isPasskeySupported(): boolean;
+/** Not available on native — throws. Guard with {@link isPasskeySupported} first. */
+export declare function runRegistrationCeremony(_optionsJSON: unknown): Promise<unknown>;
+/** Not available on native — throws. Guard with {@link isPasskeySupported} first. */
+export declare function runAuthenticationCeremony(_optionsJSON: unknown): Promise<unknown>;
+//# sourceMappingURL=passkeyClient.native.d.ts.map

package/lib/typescript/module/webauthn/passkeyClient.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passkeyClient.native.d.ts","sourceRoot":"","sources":["../../../../src/webauthn/passkeyClient.native.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,mEAAmE;AACnE,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,qFAAqF;AACrF,wBAAsB,uBAAuB,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAErF;AAED,qFAAqF;AACrF,wBAAsB,yBAAyB,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAEvF"}

package/lib/typescript/module/webauthn/passkeyClient.web.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Passkey / WebAuthn ceremony client — WEB implementation.
+ *
+ * The browser half of the passkey flow: it drives `navigator.credentials`
+ * through `@simplewebauthn/browser`, turning the OPAQUE options the server
+ * emitted (`OxyServices.webauthn{Register,Login}Options`) into the opaque
+ * response the matching `verify` endpoint consumes. Oxy never owns those wire
+ * shapes — `@simplewebauthn/browser` does — so options flow in as `unknown` and
+ * the single cast at this boundary hands them to the library's own types.
+ *
+ * This file is selected ONLY on web (react-native-web / Vite RNW): the sibling
+ * `passkeyClient.native.ts` + the clean default `passkeyClient.ts` deliberately
+ * do NOT import `@simplewebauthn/browser` (a browser-only dependency), per the
+ * platform-split rule. Native passkeys are Commons' job — there is no WebAuthn
+ * ceremony off the web.
+ */
+import { type RegistrationResponseJSON, type AuthenticationResponseJSON } from '@simplewebauthn/browser';
+/**
+ * True iff this browser can run a WebAuthn ceremony (exposes the
+ * `PublicKeyCredential` global). Gate all passkey UI/entrypoints on this so an
+ * unsupported browser fails loudly rather than throwing mid-ceremony.
+ */
+export declare function isPasskeySupported(): boolean;
+/**
+ * Run the WebAuthn REGISTRATION ceremony (`navigator.credentials.create`) from
+ * the server's opaque creation options, returning the opaque attestation
+ * response for `OxyServices.webauthnRegisterVerify`.
+ */
+export declare function runRegistrationCeremony(optionsJSON: unknown): Promise<RegistrationResponseJSON>;
+/**
+ * Run the WebAuthn AUTHENTICATION ceremony (`navigator.credentials.get`) from
+ * the server's opaque request options, returning the opaque assertion response
+ * for `OxyServices.webauthnLoginVerify`.
+ */
+export declare function runAuthenticationCeremony(optionsJSON: unknown): Promise<AuthenticationResponseJSON>;
+//# sourceMappingURL=passkeyClient.web.d.ts.map

package/lib/typescript/module/webauthn/passkeyClient.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passkeyClient.web.d.ts","sourceRoot":"","sources":["../../../../src/webauthn/passkeyClient.web.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAKL,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAChC,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAEnC;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,0BAA0B,CAAC,CAErC"}

package/lib/typescript/nativewind-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="nativewind/types" />

package/lib/typescript/types/expo-crypto.d.ts

@@ -0,0 +1,29 @@
+declare module 'expo-crypto' {
+  export enum CryptoDigestAlgorithm {
+    SHA1 = 'SHA1',
+    SHA256 = 'SHA256',
+    SHA384 = 'SHA384',
+    SHA512 = 'SHA512',
+    MD5 = 'MD5',
+    MD2 = 'MD2',
+    MD4 = 'MD4',
+  }
+
+  export function digestStringAsync(
+    algorithm: CryptoDigestAlgorithm | 'MD5' | 'SHA1' | 'SHA256' | 'SHA384' | 'SHA512',
+    data: string,
+    options?: { encoding?: 'base64' | 'hex' }
+  ): Promise<string>;
+
+  export function digestString(
+    algorithm: CryptoDigestAlgorithm | 'MD5' | 'SHA1' | 'SHA256' | 'SHA384' | 'SHA512',
+    data: string,
+    options?: { encoding?: 'base64' | 'hex' }
+  ): string;
+
+  export function getRandomBytes(byteCount: number): Uint8Array;
+  export function getRandomBytesAsync(byteCount: number): Promise<Uint8Array>;
+  export function randomUUID(): string;
+}
+
+

package/lib/typescript/types/expo-document-picker.d.ts

@@ -0,0 +1,36 @@
+declare module 'expo-document-picker' {
+    type DocumentPickerInputType = string | string[];
+
+    export interface DocumentPickerOptions {
+        type?: DocumentPickerInputType;
+        multiple?: boolean;
+        copyToCacheDirectory?: boolean;
+    }
+
+    export interface DocumentPickerAsset {
+        name?: string | null;
+        size?: number | null;
+        mimeType?: string | null;
+        uri?: string;
+        file?: File | Blob;
+        lastModified?: number | null;
+    }
+
+    export interface DocumentPickerSuccessResult {
+        canceled: false;
+        assets: DocumentPickerAsset[];
+        type?: 'success';
+    }
+
+    export interface DocumentPickerCanceledResult {
+        canceled: true;
+        assets: [];
+        type?: 'cancel';
+    }
+
+    export type DocumentPickerResult = DocumentPickerSuccessResult | DocumentPickerCanceledResult;
+
+    export function getDocumentAsync(options?: DocumentPickerOptions): Promise<DocumentPickerResult>;
+    export function isAvailableAsync(): Promise<boolean>;
+}
+

package/lib/typescript/types/expo-haptics.d.ts

@@ -0,0 +1,42 @@
+declare module 'expo-haptics' {
+  export enum ImpactFeedbackStyle {
+    Light = 'light',
+    Medium = 'medium',
+    Heavy = 'heavy',
+    Rigid = 'rigid',
+    Soft = 'soft',
+  }
+
+  export enum NotificationFeedbackType {
+    Success = 'success',
+    Warning = 'warning',
+    Error = 'error',
+  }
+
+  export enum AndroidHaptics {
+    Confirm = 'confirm',
+    Reject = 'reject',
+    Toggle_On = 'toggle_on',
+    Toggle_Off = 'toggle_off',
+    Selection = 'selection',
+    Context_Click = 'context_click',
+    Keyboard_Tap = 'keyboard_tap',
+    Keyboard_Press = 'keyboard_press',
+    Keyboard_Release = 'keyboard_release',
+    Virtual_Key = 'virtual_key',
+    Virtual_Key_Release = 'virtual_key_release',
+    Long_Press = 'long_press',
+    Gesture_Start = 'gesture_start',
+    Gesture_End = 'gesture_end',
+    Clock_Tick = 'clock_tick',
+    Segment_Tick = 'segment_tick',
+    Segment_Frequent_Tick = 'segment_frequent_tick',
+    Text_Handle_Move = 'text_handle_move',
+    Drag_Start = 'drag_start',
+  }
+
+  export function impactAsync(style?: ImpactFeedbackStyle): Promise<void>;
+  export function notificationAsync(type?: NotificationFeedbackType): Promise<void>;
+  export function selectionAsync(): Promise<void>;
+  export function performAndroidHapticsAsync(type: AndroidHaptics): Promise<void>;
+}