@oxyhq/core 7.0.0 → 7.1.0

package/dist/cjs/index.js

@@ -20,8 +20,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.lightenColor = exports.darkenColor = exports.isWebBrowser = exports.isAndroid = exports.isIOS = exports.isNative = exports.isWeb = exports.setPlatformOS = exports.getPlatformOS = exports.isRTLLocale = exports.normalizeLanguageCode = exports.getNativeLanguageName = exports.getLanguageName = exports.getLanguageMetadata = exports.SUPPORTED_LANGUAGES = exports.TopicSource = exports.TopicType = exports.SECURITY_EVENT_SEVERITY_MAP = exports.DeviceManager = exports.RecoveryPhraseService = exports.SignatureService = exports.IdentityPersistError = exports.IdentityAlreadyExistsError = exports.KeyManager = exports.sessionsArraysEqual = exports.normalizeAndSortSessions = exports.mergeSessions = exports.authenticatedApiCall = exports.withAuthErrorHandling = exports.isAuthenticationError = exports.ensureValidToken = exports.AuthenticationFailedError = exports.SessionSyncRequiredError = exports.verifyPublicCardAttestation = exports.parseAttestPayload = exports.parseIdPayload = exports.buildUserDid = exports.normalizeProfileLinks = exports.getNormalizedUserHandle = exports.getCanonicalUserHandle = exports.normalizeUserIdentityOrNull = exports.normalizeUserIdentity = exports.getNormalizedUserId = exports.OxyAppDataIdentifierError = exports.ServiceCredentialMismatchError = exports.oxyClient = exports.OXY_CLOUD_URL = exports.OxyAuthenticationTimeoutError = exports.OxyAuthenticationError = exports.OxyServices = void 0;
 exports.isValidPassword = exports.isValidUsername = exports.isValidEmail = exports.PASSWORD_REGEX = exports.USERNAME_REGEX = exports.EMAIL_REGEX = exports.retryAsync = exports.validateRequiredFields = exports.handleHttpError = exports.createApiError = exports.ErrorCodes = exports.safeJsonParse = exports.buildPaginationParams = exports.buildUrl = exports.buildSearchParams = exports.translate = exports.createDebugLogger = exports.debugError = exports.debugWarn = exports.debugLog = exports.isDev = exports.withRetry = exports.delay = exports.shouldAllowRequest = exports.recordSuccess = exports.recordFailure = exports.calculateBackoffInterval = exports.createCircuitBreakerState = exports.DEFAULT_CIRCUIT_BREAKER_CONFIG = exports.isRetryableError = exports.isNetworkError = exports.isServerError = exports.isRateLimitError = exports.isNotFoundError = exports.isForbiddenError = exports.isUnauthorizedError = exports.isAlreadyRegisteredError = exports.getErrorMessage = exports.getErrorStatus = exports.HttpStatus = exports.getSystemColorScheme = exports.systemPrefersDarkMode = exports.getOppositeTheme = exports.normalizeColorScheme = exports.normalizeTheme = exports.getContrastTextColor = exports.isLightColor = exports.withOpacity = exports.rgbToHex = exports.hexToRgb = void 0;
-exports.installAuthRefreshHandler = exports.createAuthRefreshHandler = exports.refreshPersistedSession = exports.DEVICE_TOKEN_STORAGE_KEY = exports.AUTH_STATE_STORAGE_KEY = exports.createMemoryAuthStateStore = exports.createNativeAuthStateStore = exports.createWebAuthStateStore = exports.accountIdsOf = exports.activeUserOf = exports.activeSessionIdOf = exports.deviceStateToClientSessions = exports.createSessionClient = exports.createSessionClientHost = exports.SessionClient = exports.runColdBoot = exports.SSO_CALLBACK_PATH = exports.CENTRAL_IDP_APEX = exports.registrableApex = exports.getAccountColor = exports.formatPublicKeyHandle = exports.getAccountFallbackHandle = exports.getAccountDisplayName = exports.createQuickAccount = exports.buildAccountsArray = exports.updateAvatarVisibility = exports.logPerformance = exports.logPayment = exports.logDevice = exports.logUser = exports.logSession = exports.logApi = exports.logAuth = exports.LogLevel = exports.logger = exports.validateAndSanitizeUserInput = exports.isValidObjectId = exports.sanitizeHTML = exports.sanitizeString = exports.isValidFileType = exports.isValidFileSize = exports.isValidDate = exports.isValidURL = exports.isValidUUID = exports.isValidObject = exports.isValidArray = exports.isRequiredBoolean = exports.isRequiredNumber = exports.isRequiredString = exports.isValidDisplayName = void 0;
-exports.packageInfo = exports.BOOT_STATE_SESSION_KEY = exports.BOOT_FRAGMENT_PARAM = exports.hashHasBootFragment = exports.parseDeviceBootFragment = exports.consumeDeviceBootReturn = exports.BOOT_ATTEMPTED_KEY = exports.isSameApex = exports.createBrowserColdBootDom = exports.runSessionColdBoot = exports.TOKEN_REFRESH_LEAD_MS = exports.startTokenRefreshScheduler = void 0;
+exports.AUTH_STATE_STORAGE_KEY = exports.createMemoryAuthStateStore = exports.createNativeAuthStateStore = exports.createWebAuthStateStore = exports.createAccountDialogController = exports.AccountDialogController = exports.switchableAccountIds = exports.projectSwitchableAccounts = exports.accountIdsOf = exports.activeUserOf = exports.activeSessionIdOf = exports.deviceStateToClientSessions = exports.createSessionClient = exports.createSessionClientHost = exports.SessionClient = exports.runColdBoot = exports.SSO_CALLBACK_PATH = exports.CENTRAL_IDP_APEX = exports.registrableApex = exports.getAccountColor = exports.formatPublicKeyHandle = exports.getAccountFallbackHandle = exports.getAccountDisplayName = exports.createQuickAccount = exports.buildAccountsArray = exports.updateAvatarVisibility = exports.logPerformance = exports.logPayment = exports.logDevice = exports.logUser = exports.logSession = exports.logApi = exports.logAuth = exports.LogLevel = exports.logger = exports.validateAndSanitizeUserInput = exports.isValidObjectId = exports.sanitizeHTML = exports.sanitizeString = exports.isValidFileType = exports.isValidFileSize = exports.isValidDate = exports.isValidURL = exports.isValidUUID = exports.isValidObject = exports.isValidArray = exports.isRequiredBoolean = exports.isRequiredNumber = exports.isRequiredString = exports.isValidDisplayName = void 0;
+exports.packageInfo = exports.BOOT_STATE_SESSION_KEY = exports.BOOT_FRAGMENT_PARAM = exports.hashHasBootFragment = exports.parseDeviceBootFragment = exports.consumeDeviceBootReturn = exports.BOOT_ATTEMPTED_KEY = exports.isSameApex = exports.createBrowserColdBootDom = exports.runSessionColdBoot = exports.TOKEN_REFRESH_LEAD_MS = exports.startTokenRefreshScheduler = exports.installAuthRefreshHandler = exports.createAuthRefreshHandler = exports.refreshPersistedSession = exports.DEVICE_TOKEN_STORAGE_KEY = void 0;
 // Ensure crypto polyfills are loaded before anything else
 require("./crypto/polyfill");
 // ---------------------------------------------------------------------------
@@ -294,6 +294,21 @@ Object.defineProperty(exports, "deviceStateToClientSessions", { enumerable: true
 Object.defineProperty(exports, "activeSessionIdOf", { enumerable: true, get: function () { return projectSessionState_1.activeSessionIdOf; } });
 Object.defineProperty(exports, "activeUserOf", { enumerable: true, get: function () { return projectSessionState_1.activeUserOf; } });
 Object.defineProperty(exports, "accountIdsOf", { enumerable: true, get: function () { return projectSessionState_1.accountIdsOf; } });
+// Unified account-list projection (THE single source of truth for the account
+// chooser: device sign-ins ∪ account graph, deduped by accountId). Pure +
+// I/O-free — the caller hydrates profiles via `getUsersByIds`. Shared by
+// `@oxyhq/services`, `@oxyhq/auth`, and auth.oxy.so so the list can't diverge.
+var accountProjection_1 = require("./session/accountProjection");
+Object.defineProperty(exports, "projectSwitchableAccounts", { enumerable: true, get: function () { return accountProjection_1.projectSwitchableAccounts; } });
+Object.defineProperty(exports, "switchableAccountIds", { enumerable: true, get: function () { return accountProjection_1.switchableAccountIds; } });
+// Headless controller for the unified account dialog. Framework-agnostic
+// state machine + subscribe/getSnapshot store (bind via `useSyncExternalStore`)
+// — no password/2FA logic (that lives at the IdP; `openPasswordAtOxyAuth` only
+// hands off). Reuses `SessionClient.switchAccount` / `oxyServices.switchToAccount`
+// for the uniform switch and the existing device-flow methods for sign-in.
+var accountDialogController_1 = require("./session/accountDialogController");
+Object.defineProperty(exports, "AccountDialogController", { enumerable: true, get: function () { return accountDialogController_1.AccountDialogController; } });
+Object.defineProperty(exports, "createAccountDialogController", { enumerable: true, get: function () { return accountDialogController_1.createAccountDialogController; } });
 // ---------------------------------------------------------------------------
 // Device-first session machinery (auth centralization, wave 1) — additive.
 // Persisted auth-state store, the unified refresh handler + scheduler, the

package/dist/cjs/session/SessionClient.js

@@ -4,6 +4,14 @@ exports.SessionClient = void 0;
 const contracts_1 = require("@oxyhq/contracts");
 const loggerUtils_1 = require("../utils/loggerUtils");
 const socketLoader_1 = require("./socketLoader");
+/**
+ * Same-origin `BroadcastChannel` name for instant, network-free session wake
+ * across tabs of the SAME origin (e.g. two `accounts.oxy.so` tabs). Complements
+ * the cookie-authed device socket, which covers same-apex cross-origin
+ * (`accounts` ↔ `console` ↔ `inbox`, all `*.oxy.so`). Cross-APEX (mention.earth)
+ * is covered by neither and relies on a reload — the documented limitation.
+ */
+const SESSION_BROADCAST_CHANNEL = 'oxy.session';
 class SessionClient {
     constructor(host, options = {}) {
         this.host = host;
@@ -13,6 +21,12 @@ class SessionClient {
         this.socket = null;
         this.tokenUnsub = null;
         this.started = false;
+        /** In-flight guard so a burst of pushes triggers at most ONE acquisition. */
+        this.acquiring = false;
+        /** True while the live socket is an anonymous (signed-out) device connection. */
+        this.socketAnonymous = false;
+        /** Same-origin cross-tab wake channel; null on platforms without BroadcastChannel. */
+        this.channel = null;
     }
     getState() {
         return this.state;
@@ -105,14 +119,17 @@ class SessionClient {
     async switchAccount(accountId) {
         const res = await this.host.makeRequest('POST', '/session/device/switch', { accountId }, { cache: false });
         this.applySync(res);
+        this.postCommitPing();
     }
     async signOut(target) {
         const res = await this.host.makeRequest('POST', '/session/device/signout', target, { cache: false });
         this.applySync(res);
+        this.postCommitPing();
     }
     async addCurrentAccount() {
         const res = await this.host.makeRequest('POST', '/session/device/add', undefined, { cache: false });
         this.applySync(res);
+        this.postCommitPing();
     }
     /**
      * Register the just-signed-in account into the device set AND make it the
@@ -140,19 +157,58 @@ class SessionClient {
             return;
         this.started = true;
         this.tokenUnsub = this.host.onTokensChanged((token) => {
-            if (token && this.socket && !this.socket.connected) {
+            if (!token)
+                return;
+            // A bearer just landed: an in-flight acquisition (if any) succeeded — clear
+            // the guard so a later sign-out can re-acquire.
+            this.acquiring = false;
+            if (!this.socket)
+                return;
+            if (this.socketAnonymous) {
+                // The live socket was an anonymous (device-room-only) connection. Force a
+                // reconnect so the handshake re-runs authenticated and also joins the
+                // `user:<id>` notification room.
+                this.socketAnonymous = false;
+                this.socket.disconnect();
+                this.socket.connect();
+            }
+            else if (!this.socket.connected) {
                 this.socket.connect();
             }
         });
-        await this.bootstrap();
+        this.openBroadcastChannel();
+        // `bootstrap` (`GET /session/device/state`) is bearer-authenticated: skip it
+        // when signed out (the signed-out socket below still joins the device room to
+        // receive pushes). A bootstrap failure is non-fatal — the socket must still
+        // connect so realtime sync survives a transient state-fetch error.
+        if (this.host.getAccessToken()) {
+            try {
+                await this.bootstrap();
+            }
+            catch (error) {
+                loggerUtils_1.logger.warn('[SessionClient] bootstrap during start failed (non-fatal)', { component: 'SessionClient' }, error);
+            }
+        }
         await this.connectSocket();
     }
     stop() {
         this.started = false;
+        this.acquiring = false;
+        this.socketAnonymous = false;
         if (this.tokenUnsub) {
             this.tokenUnsub();
             this.tokenUnsub = null;
         }
+        if (this.channel) {
+            this.channel.onmessage = null;
+            try {
+                this.channel.close();
+            }
+            catch (error) {
+                loggerUtils_1.logger.debug('[SessionClient] BroadcastChannel close failed', { component: 'SessionClient' }, error);
+            }
+            this.channel = null;
+        }
         if (this.socket) {
             this.socket.disconnect();
             this.socket = null;
@@ -170,25 +226,140 @@ class SessionClient {
         if (!this.started)
             return; // stopped while the dynamic import was in flight
         const hasToken = Boolean(this.host.getAccessToken());
+        // Signed-out connect gate: when there is no bearer, only open the socket if
+        // the consumer supplies a device anchor (web cookie → `true`; native token →
+        // string). This lets an idle tab receive its device's `session_state` pushes
+        // and self-acquire when a sibling signs in.
+        let signedOutAuth = false;
+        if (!hasToken && this.options.signedOutSocketAuth) {
+            try {
+                signedOutAuth = await this.options.signedOutSocketAuth();
+            }
+            catch (error) {
+                loggerUtils_1.logger.warn('[SessionClient] signedOutSocketAuth failed', { component: 'SessionClient' }, error);
+                signedOutAuth = false;
+            }
+            if (!this.started)
+                return; // stopped while the async gate was in flight
+        }
+        const signedOutConnect = signedOutAuth !== false && signedOutAuth != null;
+        const signedOutDeviceToken = typeof signedOutAuth === 'string' ? signedOutAuth : undefined;
+        this.socketAnonymous = !hasToken && signedOutConnect;
         const socket = io(this.host.getBaseURL(), {
             transports: ['websocket'],
-            autoConnect: hasToken,
+            // Send the first-party `oxy_device` cookie on the same-site handshake so a
+            // signed-out browser tab can be resolved to its device room server-side.
+            withCredentials: true,
+            autoConnect: hasToken || signedOutConnect,
             auth: (cb) => {
-                cb({ token: this.host.getAccessToken() ?? '' });
+                const token = this.host.getAccessToken() ?? '';
+                // Present the native device token only while signed out (no bearer). Once
+                // a token is held the bearer path wins and the deviceToken is redundant.
+                cb(token || !signedOutDeviceToken ? { token } : { token, deviceToken: signedOutDeviceToken });
             },
         });
         socket.on('session_state', (payload) => {
             const applied = this.applyState(payload);
-            if (applied) {
-                const active = this.state?.activeAccountId ?? null;
-                if (active && active !== this.host.getCurrentAccountId()) {
-                    void this.bootstrap().catch((error) => {
-                        loggerUtils_1.logger.warn('[SessionClient] post-push token fetch failed', { component: 'SessionClient' }, error);
-                    });
+            if (!applied)
+                return;
+            // Signed-out tab: a session appeared on this device (a sibling signed in).
+            // Acquire it so this tab flips to signed-in; the planted token then
+            // reconnects the socket on the authenticated path.
+            if (!this.host.getAccessToken()) {
+                if ((this.state?.accounts.length ?? 0) > 0) {
+                    this.requestAcquisition();
                 }
+                return;
+            }
+            const active = this.state?.activeAccountId ?? null;
+            if (active && active !== this.host.getCurrentAccountId()) {
+                void this.bootstrap().catch((error) => {
+                    loggerUtils_1.logger.warn('[SessionClient] post-push token fetch failed', { component: 'SessionClient' }, error);
+                });
             }
         });
         this.socket = socket;
     }
+    /**
+     * Run the consumer's session acquisition at most once at a time. A returned
+     * promise gates the next attempt (reset on settle), so a failed acquisition
+     * can retry on the NEXT push while a burst of identical pushes cannot pile up.
+     */
+    requestAcquisition() {
+        if (this.acquiring || !this.options.onSessionAppeared)
+            return;
+        this.acquiring = true;
+        let result;
+        try {
+            result = this.options.onSessionAppeared();
+        }
+        catch (error) {
+            this.acquiring = false;
+            loggerUtils_1.logger.error('[SessionClient] onSessionAppeared threw', error);
+            return;
+        }
+        void Promise.resolve(result).catch((error) => {
+            loggerUtils_1.logger.warn('[SessionClient] onSessionAppeared rejected', { component: 'SessionClient' }, error);
+        }).finally(() => {
+            this.acquiring = false;
+        });
+    }
+    /**
+     * Open the same-origin `BroadcastChannel` (web only). A sibling tab that
+     * commits a session posts a wake ping; on receipt a signed-in tab re-syncs its
+     * device state and a signed-out tab self-acquires — instant + network-free for
+     * the common "two tabs of the same origin" case, with no state (and no tokens)
+     * ever crossing the channel. No-op on native (no BroadcastChannel).
+     */
+    openBroadcastChannel() {
+        if (this.channel)
+            return;
+        const Ctor = globalThis.BroadcastChannel;
+        if (typeof Ctor !== 'function')
+            return; // native RN / SSR — feature absent
+        let channel;
+        try {
+            channel = new Ctor(SESSION_BROADCAST_CHANNEL);
+        }
+        catch (error) {
+            loggerUtils_1.logger.debug('[SessionClient] BroadcastChannel unavailable', { component: 'SessionClient' }, error);
+            return;
+        }
+        channel.onmessage = (event) => {
+            if (!event || typeof event.data !== 'object' || event.data === null)
+                return;
+            if (event.data.type !== 'commit')
+                return;
+            // BroadcastChannel never echoes to the posting context, so this is a
+            // sibling's commit. Re-sync (signed-in) or acquire (signed-out). Neither
+            // path re-posts, so there is no cross-tab ping loop.
+            if (this.host.getAccessToken()) {
+                void this.bootstrap().catch((error) => {
+                    loggerUtils_1.logger.warn('[SessionClient] broadcast re-sync failed', { component: 'SessionClient' }, error);
+                });
+            }
+            else {
+                this.requestAcquisition();
+            }
+        };
+        this.channel = channel;
+    }
+    /**
+     * Wake same-origin sibling tabs after a locally-initiated session mutation.
+     * Opens the channel lazily: a sign-in registers the account (`addCurrentAccount`
+     * / `switchAccount`) BEFORE `start()` runs, so the ping must not depend on
+     * `start()` having opened the channel first.
+     */
+    postCommitPing() {
+        this.openBroadcastChannel();
+        if (!this.channel)
+            return;
+        try {
+            this.channel.postMessage({ type: 'commit', at: Date.now() });
+        }
+        catch (error) {
+            loggerUtils_1.logger.debug('[SessionClient] BroadcastChannel post failed', { component: 'SessionClient' }, error);
+        }
+    }
 }
 exports.SessionClient = SessionClient;