@oxyhq/core 11.0.0 → 12.0.0

package/dist/cjs/index.js

@@ -11,7 +11,7 @@
  * ```ts
  * import { OxyServices, oxyClient } from '@oxyhq/core';
  *
- * const user = await oxyClient.signIn(publicKey);
+ * const user = await oxyClient.getCurrentUser();
  * ```
  *
  * Every export below is NOMINAL — no `export *`, no barrels, no compat shims.
@@ -20,8 +20,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isWeb = exports.setPlatformOS = exports.getPlatformOS = exports.getPrimaryLanguage = exports.getUserLanguages = exports.isRTLLocale = exports.getNativeLanguageName = exports.getLanguageName = exports.getLanguageMetadata = exports.isSupportedLocale = exports.normalizeLocale = exports.getBaseLanguage = exports.FALLBACK_LOCALE = 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.ORGANIZATION_CATEGORIES = 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.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.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 = exports.lightenColor = exports.darkenColor = exports.isWebBrowser = exports.isAndroid = exports.isIOS = exports.isNative = void 0;
-exports.buildIdpHubOrigin = exports.clearOAuthHandshake = exports.readOAuthHandshake = exports.persistOAuthHandshake = exports.normalizeOAuthRedirectUri = exports.OXY_CROSS_ORIGIN_RESTORE_ATTEMPTED_KEY = exports.OXY_SILENT_OAUTH_ATTEMPTED_KEY = exports.OXY_OAUTH_CODE_VERIFIER_STORAGE_KEY = exports.OXY_OAUTH_STATE_STORAGE_KEY = exports.OXY_AUTHORIZE_URL = exports.DEFAULT_OAUTH_SCOPE = exports.generatePkcePair = exports.generateOAuthState = exports.computeCodeChallenge = exports.buildOAuthAuthorizeUrl = exports.runColdBoot = exports.CENTRAL_IDP_APEX = exports.registrableApex = exports.getAccountColor = exports.formatPublicKeyHandle = exports.getAccountFallbackHandle = exports.getAccountDisplayName = exports.createQuickAccount = exports.buildAccountsArray = exports.updateAvatarVisibility = exports.isDev = exports.consoleSink = exports.resetLoggerConfig = exports.getLoggerConfig = exports.configureLogger = exports.createLogger = exports.logger = exports.normalizeMultilineText = exports.normalizeInlineText = 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 = exports.isValidPassword = void 0;
-exports.packageInfo = exports.runSessionColdBoot = exports.TOKEN_REFRESH_LEAD_MS = exports.startTokenRefreshScheduler = exports.installAuthRefreshHandler = exports.createAuthRefreshHandler = exports.refreshDeviceSecretArm = exports.refreshPersistedSession = 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.redeemHubTicketOnHub = exports.syncHubAfterSignIn = exports.parseHubSyncReturnUrl = exports.normalizeOfficialReturnOrigin = exports.isAllowedDeviceJoinOrigin = exports.isOfficialWebOrigin = exports.isIdpHubOrigin = exports.buildHubSyncUrl = void 0;
+exports.clearOAuthHandshake = exports.readOAuthHandshake = exports.persistOAuthHandshake = exports.normalizeOAuthRedirectUri = exports.OXY_CROSS_ORIGIN_RESTORE_ATTEMPTED_KEY = exports.OXY_SILENT_OAUTH_ATTEMPTED_KEY = exports.OXY_OAUTH_CODE_VERIFIER_STORAGE_KEY = exports.OXY_OAUTH_STATE_STORAGE_KEY = exports.OXY_AUTHORIZE_URL = exports.DEFAULT_OAUTH_SCOPE = exports.generatePkcePair = exports.generateOAuthState = exports.computeCodeChallenge = exports.buildOAuthAuthorizeUrl = exports.runColdBoot = exports.isOxyRpOrigin = exports.CENTRAL_IDP_APEX = exports.registrableApex = exports.getAccountColor = exports.formatPublicKeyHandle = exports.getAccountFallbackHandle = exports.getAccountDisplayName = exports.createQuickAccount = exports.buildAccountsArray = exports.updateAvatarVisibility = exports.isDev = exports.consoleSink = exports.resetLoggerConfig = exports.getLoggerConfig = exports.configureLogger = exports.createLogger = exports.logger = exports.normalizeMultilineText = exports.normalizeInlineText = 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 = exports.isValidPassword = void 0;
+exports.packageInfo = exports.runSessionColdBoot = exports.TOKEN_REFRESH_LEAD_MS = exports.startTokenRefreshScheduler = exports.installAuthRefreshHandler = exports.createAuthRefreshHandler = exports.refreshDeviceSecretArm = exports.refreshPersistedSession = 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.redeemHubTicketOnHub = exports.syncHubAfterSignIn = exports.parseHubSyncReturnUrl = exports.normalizeOfficialReturnOrigin = exports.isAllowedDeviceJoinOrigin = exports.isOfficialWebOrigin = exports.isLoopbackOrigin = exports.isIdpHubOrigin = exports.buildHubSyncUrl = exports.buildIdpHubOrigin = void 0;
 // Ensure crypto polyfills are loaded before anything else
 require("./crypto/polyfill");
 // ---------------------------------------------------------------------------
@@ -270,6 +270,11 @@ var registrableApex_1 = require("./utils/registrableApex");
 Object.defineProperty(exports, "registrableApex", { enumerable: true, get: function () { return registrableApex_1.registrableApex; } });
 var authWebUrl_1 = require("./utils/authWebUrl");
 Object.defineProperty(exports, "CENTRAL_IDP_APEX", { enumerable: true, get: function () { return authWebUrl_1.CENTRAL_IDP_APEX; } });
+// WebAuthn relying-party origin guard (client side). Mirrors the server's
+// `isOxyApexOrigin` so consumers can decide whether to offer passkey UI on the
+// current page (first-party Oxy origin / loopback only).
+var webauthnOrigin_1 = require("./utils/webauthnOrigin");
+Object.defineProperty(exports, "isOxyRpOrigin", { enumerable: true, get: function () { return webauthnOrigin_1.isOxyRpOrigin; } });
 var coldBoot_1 = require("./utils/coldBoot");
 Object.defineProperty(exports, "runColdBoot", { enumerable: true, get: function () { return coldBoot_1.runColdBoot; } });
 // ---------------------------------------------------------------------------
@@ -295,6 +300,7 @@ var officialOrigins_1 = require("./utils/officialOrigins");
 Object.defineProperty(exports, "buildIdpHubOrigin", { enumerable: true, get: function () { return officialOrigins_1.buildIdpHubOrigin; } });
 Object.defineProperty(exports, "buildHubSyncUrl", { enumerable: true, get: function () { return officialOrigins_1.buildHubSyncUrl; } });
 Object.defineProperty(exports, "isIdpHubOrigin", { enumerable: true, get: function () { return officialOrigins_1.isIdpHubOrigin; } });
+Object.defineProperty(exports, "isLoopbackOrigin", { enumerable: true, get: function () { return officialOrigins_1.isLoopbackOrigin; } });
 Object.defineProperty(exports, "isOfficialWebOrigin", { enumerable: true, get: function () { return officialOrigins_1.isOfficialWebOrigin; } });
 Object.defineProperty(exports, "isAllowedDeviceJoinOrigin", { enumerable: true, get: function () { return officialOrigins_1.isAllowedDeviceJoinOrigin; } });
 Object.defineProperty(exports, "normalizeOfficialReturnOrigin", { enumerable: true, get: function () { return officialOrigins_1.normalizeOfficialReturnOrigin; } });
@@ -330,9 +336,10 @@ Object.defineProperty(exports, "projectSwitchableAccounts", { enumerable: true,
 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.
+// — sign-in is passkey (WebAuthn) or the Commons QR / shared-keychain handoff;
+// password, social login, and 2FA were removed ecosystem-wide. 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; } });

package/dist/cjs/mixins/OxyServices.auth.js

@@ -742,106 +742,97 @@ function OxyServicesAuthMixin(Base) {
             }
         }
         /**
-         * Register a new user with email/username and password
+         * Begin a WebAuthn / passkey REGISTRATION ceremony. Requests the
+         * `PublicKeyCredentialCreationOptions` the browser's `navigator.credentials
+         * .create()` (or `@simplewebauthn/browser`'s `startRegistration`) needs.
+         *
+         * With a bearer token planted this links a passkey to the signed-in account
+         * (`username` ignored); without one it is a prospective signup and `username`
+         * is the desired handle. The returned options are OPAQUE — Oxy does not own
+         * their shape (the browser / `@simplewebauthn` does), so they pass through
+         * as `unknown` for the caller to hand straight to the ceremony.
          */
-        async signUp(username, email, password, deviceName, deviceFingerprint) {
+        async webauthnRegisterOptions(username) {
             try {
-                const session = await this.makeRequest('POST', '/auth/signup', {
-                    username,
-                    email,
-                    password,
-                    deviceName,
-                    deviceFingerprint,
-                }, { cache: false });
-                return {
-                    ...session,
-                    user: (0, userIdentity_1.normalizeUserIdentity)(session.user),
-                };
+                return await this.makeRequest('POST', '/auth/webauthn/register/options', { ...(username !== undefined ? { username } : {}) }, { cache: false });
             }
             catch (error) {
                 throw this.handleError(error);
             }
         }
         /**
-         * Sign in with email or username and password
-         */
-        async signIn(identifier, password, deviceName, deviceFingerprint) {
+         * Finish a WebAuthn / passkey REGISTRATION ceremony. Forwards the opaque
+         * browser `RegistrationResponseJSON` (`response`) alongside the Oxy envelope
+         * (desired `username` for signup + the device-session naming fields).
+         *
+         * Two server branches, disambiguated by the response shape:
+         *  - **Signup** (no bearer): the account is created and a session minted —
+         *    the response carries `sessionId`, is the SAME {@link LoginResult}
+         *    contract as `POST /auth/verify`, and its access token is planted here.
+         *  - **Link** (bearer present): the passkey is attached to the signed-in
+         *    account and the server returns `{ success, message }` with no session,
+         *    which is returned verbatim (no token planting).
+         */
+        async webauthnRegisterVerify(response, envelope = {}) {
             try {
-                const session = await this.makeRequest('POST', '/auth/login', {
-                    identifier,
-                    password,
-                    deviceName,
-                    deviceFingerprint,
-                }, { cache: false });
-                return {
-                    ...session,
-                    user: (0, userIdentity_1.normalizeUserIdentity)(session.user),
-                };
+                const res = await this.makeRequest('POST', '/auth/webauthn/register/verify', { response, ...envelope }, { cache: false });
+                if (res && typeof res === 'object') {
+                    const record = res;
+                    // Signup branch: mints a session (LoginSessionResult, carries
+                    // `sessionId`). Parse against the login contract and plant the token.
+                    if ('sessionId' in record) {
+                        const parsed = (0, contracts_1.safeParseContract)(contracts_1.loginResultSchema, record);
+                        if (!parsed) {
+                            throw new Error('auth/webauthn/register/verify returned an unexpected response shape');
+                        }
+                        if (parsed.accessToken) {
+                            this.setTokens(parsed.accessToken);
+                        }
+                        return parsed;
+                    }
+                    // Link branch: passkey attached to the signed-in account, no session.
+                    if (record.success === true && typeof record.message === 'string') {
+                        return { success: true, message: record.message };
+                    }
+                }
+                throw new Error('auth/webauthn/register/verify returned an unexpected response shape');
             }
             catch (error) {
                 throw this.handleError(error);
             }
         }
         /**
-         * Convenience helper for email sign-in
-         */
-        async signInWithEmail(email, password, deviceName, deviceFingerprint) {
-            return this.signIn(email, password, deviceName, deviceFingerprint);
-        }
-        /**
-         * Device-first password sign-in. Unlike the legacy {@link signIn} (which
-         * assumes a one-step session and is kept intact for existing callers until
-         * the F4 cutover), this returns the FULL `POST /auth/login` contract — the
-         * discriminated {@link LoginResult}: either a 2FA challenge
-         * (`{ twoFactorRequired, loginToken }`) to complete via
-         * {@link completeTwoFactorSignIn}, or a session arm.
+         * Begin a WebAuthn / passkey AUTHENTICATION ceremony. Requests the
+         * `PublicKeyCredentialRequestOptions` the browser's `navigator.credentials
+         * .get()` (or `@simplewebauthn/browser`'s `startAuthentication`) needs.
          *
-         * On the session arm, a returned access token is planted immediately
-         * (mirroring {@link verifyChallenge}), so the caller has an authenticated
-         * client without a second round-trip. The response's `deviceId` +
-         * `deviceSecret` are the zero-cookie restore credential the caller persists.
+         * When `username` is present the server scopes `allowCredentials` to that
+         * user's passkeys (username-first); when omitted it returns an empty
+         * allow-list for the usernameless / discoverable-credential flow. The
+         * returned options are OPAQUE and pass through as `unknown`.
          */
-        async passwordSignIn(identifier, password, options = {}) {
+        async webauthnLoginOptions(username) {
             try {
-                const res = await this.makeRequest('POST', '/auth/login', {
-                    identifier,
-                    password,
-                    deviceName: options.deviceName,
-                    deviceFingerprint: options.deviceFingerprint,
-                    ...(options.deviceId ? { deviceId: options.deviceId } : {}),
-                }, { cache: false });
-                const parsed = (0, contracts_1.safeParseContract)(contracts_1.loginResultSchema, res);
-                if (!parsed) {
-                    throw new Error('auth/login returned an unexpected response shape');
-                }
-                if (!('twoFactorRequired' in parsed) && parsed.accessToken) {
-                    this.setTokens(parsed.accessToken);
-                }
-                return parsed;
+                return await this.makeRequest('POST', '/auth/webauthn/login/options', { ...(username !== undefined ? { username } : {}) }, { cache: false });
             }
             catch (error) {
                 throw this.handleError(error);
             }
         }
         /**
-         * Complete a 2FA-gated sign-in started by {@link passwordSignIn}. Presents
-         * the short-lived `loginToken` with either a TOTP `token` or a `backupCode`
-         * to `POST /security/2fa/verify-login`, which must resolve to the session
-         * arm of {@link LoginResult} (a second 2FA challenge here is a protocol
-         * error). A returned access token is planted immediately.
+         * Finish a WebAuthn / passkey AUTHENTICATION ceremony. Forwards the opaque
+         * browser `AuthenticationResponseJSON` (`response`) alongside the
+         * device-session envelope. Resolves to the SAME {@link LoginResult} contract
+         * as `POST /auth/verify`; the access token is planted immediately, and the
+         * response's `deviceId` + `deviceSecret` are the zero-cookie restore
+         * credential.
          */
-        async completeTwoFactorSignIn(params) {
+        async webauthnLoginVerify(response, envelope = {}) {
             try {
-                const res = await this.makeRequest('POST', '/security/2fa/verify-login', {
-                    loginToken: params.loginToken,
-                    token: params.token,
-                    backupCode: params.backupCode,
-                    deviceName: params.deviceName,
-                    ...(params.deviceId ? { deviceId: params.deviceId } : {}),
-                }, { cache: false });
+                const res = await this.makeRequest('POST', '/auth/webauthn/login/verify', { response, ...envelope }, { cache: false });
                 const parsed = (0, contracts_1.safeParseContract)(contracts_1.loginResultSchema, res);
-                if (!parsed || 'twoFactorRequired' in parsed) {
-                    throw new Error('security/2fa/verify-login returned an unexpected response shape');
+                if (!parsed) {
+                    throw new Error('auth/webauthn/login/verify returned an unexpected response shape');
                 }
                 if (parsed.accessToken) {
                     this.setTokens(parsed.accessToken);
@@ -854,7 +845,7 @@ function OxyServicesAuthMixin(Base) {
         }
         /**
          * Exchange an OAuth authorization code (returned to the RP redirect URI
-         * after password sign-in at auth.oxy.so) for a device-first session.
+         * after sign-in at auth.oxy.so) for a device-first session.
          * Public first-party clients use PKCE (`codeVerifier`); the access token is
          * planted immediately on success.
          */

package/dist/cjs/mixins/OxyServices.identity.js

@@ -104,15 +104,15 @@ function OxyServicesIdentityMixin(Base) {
             }
         }
         /**
-         * Link password authentication to the current account. Adds a `password`
-         * auth method (does not remove existing methods).
+         * Unlink an authentication method from the current account. The server
+         * refuses to remove the last remaining method (the account would become
+         * inaccessible). Unlinking `identity` downgrades the account to custodial.
          *
-         * @param email - The email to associate with password auth.
-         * @param password - The new password (server enforces strength rules).
+         * @param type - The auth-method type to remove.
          */
-        async linkPassword(email, password) {
+        async unlinkAuthMethod(type) {
             try {
-                const result = await this.makeRequest('POST', '/auth/link', { type: 'password', email, password }, { cache: false });
+                const result = await this.makeRequest('DELETE', `/auth/link/${encodeURIComponent(type)}`, undefined, { cache: false });
                 this._invalidateIdentityCaches(this.getCurrentUserId());
                 return result;
             }
@@ -121,15 +121,19 @@ function OxyServicesIdentityMixin(Base) {
             }
         }
         /**
-         * Unlink an authentication method from the current account. The server
-         * refuses to remove the last remaining method (the account would become
-         * inaccessible). Unlinking `identity` downgrades the account to custodial.
+         * Remove ONE passkey (WebAuthn credential) from the current account.
          *
-         * @param type - The auth-method type to remove.
+         * Passkeys are per-credential, so unlike {@link unlinkAuthMethod} (which
+         * removes an auth method by type) this targets a specific credential id.
+         * The server refuses to remove the last remaining auth method (the account
+         * would become inaccessible) and deletes the stored `WebauthnCredential`.
+         *
+         * @param credentialId - The passkey's public credential id
+         *   (`AuthMethodEntry.credentialId`).
          */
-        async unlinkAuthMethod(type) {
+        async removePasskey(credentialId) {
             try {
-                const result = await this.makeRequest('DELETE', `/auth/link/${encodeURIComponent(type)}`, undefined, { cache: false });
+                const result = await this.makeRequest('DELETE', `/auth/link/webauthn/${encodeURIComponent(credentialId)}`, undefined, { cache: false });
                 this._invalidateIdentityCaches(this.getCurrentUserId());
                 return result;
             }

package/dist/cjs/session/accountDialogController.js

@@ -22,17 +22,14 @@
  *     `oxyServices.signInWithSharedIdentity`, else the cross-device QR handoff
  *     via `startCommonsSignIn` → poll → `claimSessionByToken`).
  *
- * It deliberately owns NO password/2FA logic — those live at the IdP
- * (auth.oxy.so). {@link AccountDialogController.openPasswordAtOxyAuth} only
- * builds the hand-off URL; device-first convergence syncs the session back.
+ * Sign-in is passkey (WebAuthn) or the Commons QR / shared-keychain handoff —
+ * password, social login, and 2FA were removed ecosystem-wide.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AccountDialogController = void 0;
 exports.createAccountDialogController = createAccountDialogController;
 const logger_1 = require("../logger");
 const errorUtils_1 = require("../utils/errorUtils");
-const authWebUrl_1 = require("../utils/authWebUrl");
-const oauthPkce_1 = require("../utils/oauthPkce");
 const accountProjection_1 = require("./accountProjection");
 /**
  * Slow FALLBACK poll cadence for the QR flow. The `/auth-session` socket delivers
@@ -99,8 +96,6 @@ class AccountDialogController {
         this.locale = options.locale;
         this.commitSession = options.commitSession;
         this.onSignedIn = options.onSignedIn;
-        this.idpApex = options.idpApex ?? authWebUrl_1.CENTRAL_IDP_APEX;
-        this.authRedirectUri = options.authRedirectUri ?? null;
         this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
         this.openUrl = options.openUrl;
         this.canOpenApp = options.canOpenApp;
@@ -489,46 +484,6 @@ class AccountDialogController {
             this.setSignIn(IDLE_SIGN_IN);
         }
     }
-    /**
-     * Build (and, when an `openUrl` handler was supplied, open) the auth.oxy.so
-     * password sign-in URL. Password + 2FA are NOT in the SDK — they live at the
-     * IdP; this only hands off. Device-first: after login at the IdP the device
-     * session converges and the caller is woken via the device socket /
-     * `BroadcastChannel`, so the URL only needs to point at the IdP sign-in with
-     * the right return.
-     *
-     * @param params.returnUrl - Where the IdP returns after login. Defaults to the
-     *   current document URL on web (`globalThis.location.href`); pass explicitly
-     *   on native (no `location`).
-     * @param params.state - Optional opaque state echoed back on return.
-     * @returns The absolute auth.oxy.so sign-in URL.
-     */
-    async openPasswordAtOxyAuth(params = {}) {
-        const base = `https://auth.${this.idpApex}`;
-        const url = new URL('/login', base);
-        const rawRedirect = params.redirectUri ??
-            this.authRedirectUri ??
-            params.returnUrl ??
-            currentLocationOrigin();
-        const redirectUri = rawRedirect ? (0, oauthPkce_1.normalizeOAuthRedirectUri)(rawRedirect) : '';
-        if (redirectUri) {
-            url.searchParams.set('redirect_uri', redirectUri);
-        }
-        if (this.clientId) {
-            url.searchParams.set('client_id', this.clientId);
-        }
-        const state = params.state ?? (await (0, oauthPkce_1.generateOAuthState)());
-        url.searchParams.set('state', state);
-        const { codeChallenge, codeVerifier } = await (0, oauthPkce_1.generatePkcePair)();
-        url.searchParams.set('code_challenge', codeChallenge);
-        url.searchParams.set('code_challenge_method', 'S256');
-        if (!(0, oauthPkce_1.persistOAuthHandshake)(state, codeVerifier)) {
-            throw new Error('Could not persist OAuth handshake for password sign-in');
-        }
-        const href = url.toString();
-        this.openUrl?.(href);
-        return href;
-    }
     // =========================================================================
     // Internal sign-in helpers
     // =========================================================================
@@ -777,11 +732,3 @@ exports.AccountDialogController = AccountDialogController;
 function createAccountDialogController(options) {
     return new AccountDialogController(options);
 }
-// ---------------------------------------------------------------------------
-// Local helpers
-// ---------------------------------------------------------------------------
-/** Current document origin on web; empty string where `location` is absent (native/SSR). */
-function currentLocationOrigin() {
-    const location = globalThis.location;
-    return typeof location?.origin === 'string' ? location.origin : '';
-}

package/dist/cjs/utils/officialOrigins.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isAllowedDeviceJoinOrigin = void 0;
 exports.buildIdpHubOrigin = buildIdpHubOrigin;
 exports.isIdpHubOrigin = isIdpHubOrigin;
+exports.isLoopbackOrigin = isLoopbackOrigin;
 exports.isOfficialWebOrigin = isOfficialWebOrigin;
 exports.normalizeOfficialReturnOrigin = normalizeOfficialReturnOrigin;
 exports.parseHubSyncReturnUrl = parseHubSyncReturnUrl;
@@ -46,6 +47,11 @@ function isIdpHubOrigin() {
         return false;
     }
 }
+/**
+ * Whether an origin is a loopback / local-dev origin (`localhost`, `127.0.0.1`,
+ * or `[::1]` on any port, http or https). Local dev must never be bounced to a
+ * hosted IdP for cross-origin session restore.
+ */
 function isLoopbackOrigin(origin) {
     try {
         const parsed = new URL(origin);

package/dist/cjs/utils/webauthnOrigin.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * WebAuthn relying-party origin guard (client side).
+ *
+ * The passkey ceremonies (`OxyServices.webauthn*`) are only meaningful when the
+ * page is served from a first-party Oxy web origin: a credential minted with
+ * `WEBAUTHN_RP_ID=oxy.so` can only be created/asserted from `oxy.so`, one of its
+ * subdomains, or a loopback dev server. This is the browser-side mirror of the
+ * server's `isOxyApexOrigin` (`packages/api/src/utils/origin.ts`), which forms
+ * the server's `expectedOrigin` allow-set — consumers use it to decide whether to
+ * even offer the passkey UI on the current page.
+ *
+ * It reads `globalThis.location` directly (no argument) because that is the only
+ * origin the browser will let a WebAuthn ceremony run against. On native / SSR /
+ * any environment without a DOM `location`, it returns `false` (there is no
+ * relying-party origin, so passkeys are not applicable).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isOxyRpOrigin = isOxyRpOrigin;
+/**
+ * True iff the current page's host is a first-party Oxy relying-party origin:
+ * `oxy.so`, any `*.oxy.so` subdomain, or a loopback dev host
+ * (`localhost` / `127.0.0.1` / `[::1]`).
+ *
+ * Fails closed: no `location` (native/SSR), a non-string/empty hostname, or a
+ * host that merely ends in the literal `oxy.so` without the dot boundary
+ * (`evil-oxy.so`, `oxy.so.evil.com`) all return `false`.
+ *
+ * @example
+ *   isOxyRpOrigin() // true  on https://accounts.oxy.so
+ *   isOxyRpOrigin() // true  on http://localhost:8081
+ *   isOxyRpOrigin() // false on https://evil.com
+ *   isOxyRpOrigin() // false in a React Native / SSR context (no location)
+ */
+function isOxyRpOrigin() {
+    // `globalThis.location` is typed `Location` by the DOM lib, but is genuinely
+    // `undefined` on native/SSR — widen to a nullable local so the guard is a real
+    // runtime check, not a type-level no-op.
+    const location = globalThis.location;
+    if (!location || typeof location.hostname !== 'string') {
+        return false;
+    }
+    const hostname = location.hostname.toLowerCase();
+    if (hostname.length === 0) {
+        return false;
+    }
+    if (hostname === 'oxy.so' || hostname.endsWith('.oxy.so')) {
+        return true;
+    }
+    return hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '[::1]';
+}