oc-codex-multi-auth 6.0.0

package/dist/lib/refresh-queue.js

@@ -0,0 +1,297 @@
+/**
+ * Refresh Queue Module
+ *
+ * Prevents race conditions when multiple concurrent requests try to refresh
+ * the same account's token simultaneously. Instead of firing parallel refresh
+ * requests, subsequent callers await the existing in-flight refresh.
+ *
+ * Ported from antigravity-auth refresh-queue.ts pattern.
+ */
+import { refreshAccessToken } from "./auth/auth.js";
+import { createLogger } from "./logger.js";
+const log = createLogger("refresh-queue");
+function createInitialMetrics() {
+    return {
+        started: 0,
+        deduplicated: 0,
+        rotationReused: 0,
+        succeeded: 0,
+        failed: 0,
+        exceptions: 0,
+        rotated: 0,
+        staleEvictions: 0,
+        lastDurationMs: 0,
+        lastFailureReason: null,
+        pending: 0,
+    };
+}
+/**
+ * Manages queued token refresh operations to prevent race conditions.
+ *
+ * When multiple concurrent requests need to refresh the same account's token,
+ * only the first request triggers the actual refresh. Subsequent requests
+ * await the same promise, ensuring:
+ * - No duplicate refresh API calls for the same refresh token
+ * - Consistent token state across all waiting callers
+ * - Reduced load on OpenAI's token endpoint
+ *
+ * Token Rotation Handling:
+ * When OpenAI rotates the refresh token during a refresh operation, we maintain
+ * a mapping from old token → new token. This ensures that requests arriving with
+ * either the old or new token will find the in-flight refresh and not trigger
+ * duplicate refreshes.
+ *
+ * @example
+ * ```typescript
+ * const queue = new RefreshQueue();
+ *
+ * // These three concurrent calls will only trigger ONE actual refresh
+ * const [result1, result2, result3] = await Promise.all([
+ *   queue.refresh(refreshToken),
+ *   queue.refresh(refreshToken),
+ *   queue.refresh(refreshToken),
+ * ]);
+ *
+ * // All three get the same result
+ * console.log(result1 === result2); // true (same object reference)
+ * ```
+ */
+export class RefreshQueue {
+    pending = new Map();
+    metrics = createInitialMetrics();
+    /**
+     * Maps old refresh tokens to new tokens after rotation.
+     * This allows lookups with either old or new token to find the same entry.
+     * Format: oldToken → newToken
+     */
+    tokenRotationMap = new Map();
+    /**
+     * Maximum time to keep a refresh entry in the queue (prevents memory leaks
+     * from stuck requests). After this timeout, the entry is removed and new
+     * callers will trigger a fresh refresh.
+     */
+    maxEntryAgeMs;
+    /**
+     * Create a new RefreshQueue instance.
+     * @param maxEntryAgeMs - Maximum age for pending entries before cleanup (default: 30s)
+     */
+    constructor(maxEntryAgeMs = 30_000) {
+        this.maxEntryAgeMs = maxEntryAgeMs;
+    }
+    /**
+     * Refresh a token, deduplicating concurrent requests for the same refresh token.
+     *
+     * If a refresh is already in-flight for this token, returns the existing promise.
+     * Otherwise, initiates a new refresh and caches the promise for other callers.
+     *
+     * @param refreshToken - The refresh token to use
+     * @returns Token result (success with new tokens, or failure)
+     */
+    async refresh(refreshToken) {
+        this.cleanup();
+        // Check for existing in-flight refresh (direct match)
+        const existing = this.pending.get(refreshToken);
+        if (existing) {
+            this.metrics.deduplicated += 1;
+            this.metrics.pending = this.pending.size;
+            log.info("Reusing in-flight refresh for token", {
+                tokenSuffix: refreshToken.slice(-6),
+                waitingMs: Date.now() - existing.startedAt,
+            });
+            return existing.promise;
+        }
+        // Check if this token was rotated FROM another token that's still refreshing
+        // This handles: Request A starts with oldToken, gets newToken, Request B arrives with newToken
+        const rotatedFrom = this.findOriginalToken(refreshToken);
+        if (rotatedFrom) {
+            const originalEntry = this.pending.get(rotatedFrom);
+            if (originalEntry) {
+                this.metrics.rotationReused += 1;
+                this.metrics.pending = this.pending.size;
+                log.info("Reusing in-flight refresh via rotation mapping", {
+                    newTokenSuffix: refreshToken.slice(-6),
+                    originalTokenSuffix: rotatedFrom.slice(-6),
+                    waitingMs: Date.now() - originalEntry.startedAt,
+                });
+                return originalEntry.promise;
+            }
+        }
+        // Start a new refresh
+        const startedAt = Date.now();
+        this.metrics.started += 1;
+        const promise = this.executeRefreshWithRotationTracking(refreshToken);
+        this.pending.set(refreshToken, { promise, startedAt });
+        this.metrics.pending = this.pending.size;
+        try {
+            return await promise;
+        }
+        finally {
+            this.pending.delete(refreshToken);
+            this.cleanupRotationMapping(refreshToken);
+            this.metrics.pending = this.pending.size;
+        }
+    }
+    findOriginalToken(newToken) {
+        for (const [oldToken, mappedNewToken] of this.tokenRotationMap.entries()) {
+            if (mappedNewToken === newToken) {
+                return oldToken;
+            }
+        }
+        return undefined;
+    }
+    cleanupRotationMapping(token) {
+        this.tokenRotationMap.delete(token);
+        for (const [oldToken, newToken] of this.tokenRotationMap.entries()) {
+            if (newToken === token) {
+                this.tokenRotationMap.delete(oldToken);
+            }
+        }
+    }
+    async executeRefreshWithRotationTracking(refreshToken) {
+        const result = await this.executeRefresh(refreshToken);
+        if (result.type === "success" && result.refresh !== refreshToken) {
+            this.tokenRotationMap.set(refreshToken, result.refresh);
+            this.metrics.rotated += 1;
+            log.info("Token rotated during refresh", {
+                oldTokenSuffix: refreshToken.slice(-6),
+                newTokenSuffix: result.refresh.slice(-6),
+            });
+        }
+        return result;
+    }
+    /**
+     * Execute the actual refresh and log results.
+     */
+    async executeRefresh(refreshToken) {
+        const startTime = Date.now();
+        log.info("Starting token refresh", { tokenSuffix: refreshToken.slice(-6) });
+        try {
+            const result = await refreshAccessToken(refreshToken);
+            const duration = Date.now() - startTime;
+            this.metrics.lastDurationMs = duration;
+            if (result.type === "success") {
+                this.metrics.succeeded += 1;
+                this.metrics.lastFailureReason = null;
+                log.info("Token refresh succeeded", {
+                    tokenSuffix: refreshToken.slice(-6),
+                    durationMs: duration,
+                });
+            }
+            else {
+                this.metrics.failed += 1;
+                this.metrics.lastFailureReason = result.reason ?? "unknown";
+                log.warn("Token refresh failed", {
+                    tokenSuffix: refreshToken.slice(-6),
+                    reason: result.reason,
+                    durationMs: duration,
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.metrics.failed += 1;
+            this.metrics.exceptions += 1;
+            this.metrics.lastDurationMs = duration;
+            this.metrics.lastFailureReason =
+                error instanceof Error ? error.message : "unknown_exception";
+            log.error("Token refresh threw exception", {
+                tokenSuffix: refreshToken.slice(-6),
+                error: error?.message ?? String(error),
+                durationMs: duration,
+            });
+            return {
+                type: "failed",
+                reason: "network_error",
+                message: error?.message ?? "Unknown error during refresh",
+            };
+        }
+    }
+    /**
+     * Remove stale entries that have been pending too long.
+     * This prevents memory leaks from stuck or abandoned refresh operations.
+     */
+    cleanup() {
+        const now = Date.now();
+        const staleTokens = [];
+        for (const [token, entry] of this.pending.entries()) {
+            if (now - entry.startedAt > this.maxEntryAgeMs) {
+                staleTokens.push(token);
+            }
+        }
+        for (const token of staleTokens) {
+            // istanbul ignore next -- defensive: token always exists in pending at this point (not yet deleted)
+            const ageMs = now - (this.pending.get(token)?.startedAt ?? now);
+            this.metrics.staleEvictions += 1;
+            log.warn("Removing stale refresh entry", {
+                tokenSuffix: token.slice(-6),
+                ageMs,
+            });
+            this.pending.delete(token);
+        }
+        this.metrics.pending = this.pending.size;
+    }
+    /**
+     * Check if there's an in-flight refresh for a given token.
+     * @param refreshToken - The refresh token to check
+     * @returns True if refresh is in progress
+     */
+    isRefreshing(refreshToken) {
+        return this.pending.has(refreshToken);
+    }
+    /**
+     * Get the number of pending refresh operations.
+     * Useful for debugging and monitoring.
+     */
+    get pendingCount() {
+        return this.pending.size;
+    }
+    /**
+     * Clear all pending entries (primarily for testing).
+     */
+    clear() {
+        this.pending.clear();
+        this.tokenRotationMap.clear();
+        this.metrics = createInitialMetrics();
+    }
+    getMetricsSnapshot() {
+        return {
+            ...this.metrics,
+            pending: this.pending.size,
+        };
+    }
+}
+// ============================================================================
+// Singleton Instance
+// ============================================================================
+let refreshQueueInstance = null;
+/**
+ * Get the singleton RefreshQueue instance.
+ * @param maxEntryAgeMs - Maximum age for pending entries (only used on first call)
+ * @returns The global RefreshQueue instance
+ */
+export function getRefreshQueue(maxEntryAgeMs) {
+    if (!refreshQueueInstance) {
+        refreshQueueInstance = new RefreshQueue(maxEntryAgeMs);
+    }
+    return refreshQueueInstance;
+}
+/**
+ * Reset the singleton instance (primarily for testing).
+ */
+export function resetRefreshQueue() {
+    refreshQueueInstance?.clear();
+    refreshQueueInstance = null;
+}
+/**
+ * Convenience function to refresh a token using the singleton queue.
+ * @param refreshToken - The refresh token to use
+ * @returns Token result
+ */
+export async function queuedRefresh(refreshToken) {
+    return getRefreshQueue().refresh(refreshToken);
+}
+export function getRefreshQueueMetrics() {
+    return getRefreshQueue().getMetricsSnapshot();
+}
+//# sourceMappingURL=refresh-queue.js.map

package/dist/lib/refresh-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-queue.js","sourceRoot":"","sources":["../../lib/refresh-queue.ts"],"names":[],"mappings":"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"}

package/dist/lib/request/fetch-helpers.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Helper functions for the custom fetch implementation
+ * These functions break down the complex fetch logic into manageable, testable units
+ */
+import type { Auth, OpencodeClient } from "@opencode-ai/sdk";
+import type { UserConfig, RequestBody } from "../types.js";
+export interface RateLimitInfo {
+    retryAfterMs: number;
+    code?: string;
+}
+export interface EntitlementError {
+    isEntitlement: true;
+    code: string;
+    message: string;
+}
+export declare const DEFAULT_UNSUPPORTED_CODEX_FALLBACK_CHAIN: Record<string, string[]>;
+export interface UnsupportedCodexModelInfo {
+    isUnsupported: boolean;
+    code?: string;
+    message?: string;
+    unsupportedModel?: string;
+}
+export interface ResolveUnsupportedCodexFallbackOptions {
+    requestedModel: string | undefined;
+    errorBody: unknown;
+    attemptedModels?: Iterable<string>;
+    fallbackOnUnsupportedCodexModel: boolean;
+    fallbackToGpt52OnUnsupportedGpt53: boolean;
+    customChain?: Record<string, string[]>;
+}
+export declare function extractUnsupportedCodexModelFromText(bodyText: string): string | undefined;
+export declare function getUnsupportedCodexModelInfo(errorBody: unknown): UnsupportedCodexModelInfo;
+export declare function resolveUnsupportedCodexFallbackModel(options: ResolveUnsupportedCodexFallbackOptions): string | undefined;
+/**
+ * Returns true when the legacy `gpt-5.3-codex -> gpt-5.2-codex` edge is available.
+ */
+export declare function shouldFallbackToGpt52OnUnsupportedGpt53(requestedModel: string | undefined, errorBody: unknown): boolean;
+/**
+ * Checks if an error code indicates an entitlement/subscription issue
+ * These errors should NOT be treated as rate limits because:
+ * 1. They won't resolve by waiting
+ * 2. They won't resolve by switching accounts (all accounts likely have same issue)
+ * 3. User needs to upgrade their subscription
+ */
+export declare function isEntitlementError(code: string, bodyText: string): boolean;
+/**
+ * Creates a user-friendly entitlement error response
+ */
+export declare function createEntitlementErrorResponse(_bodyText: string): Response;
+export interface ErrorHandlingResult {
+    response: Response;
+    rateLimit?: RateLimitInfo;
+    errorBody?: unknown;
+}
+export interface ErrorHandlingOptions {
+    requestCorrelationId?: string;
+    threadId?: string;
+}
+export interface ErrorDiagnostics {
+    requestId?: string;
+    cfRay?: string;
+    correlationId?: string;
+    threadId?: string;
+    httpStatus?: number;
+}
+export declare function isDeactivatedWorkspaceError(errorBody: unknown, status?: number): boolean;
+/**
+ * Determines if the current auth token needs to be refreshed
+ * @param auth - Current authentication state
+ * @returns True if token is expired or invalid
+ */
+export declare function shouldRefreshToken(auth: Auth, skewMs?: number): boolean;
+/**
+ * Refreshes the OAuth token and updates stored credentials
+ * @param currentAuth - Current auth state
+ * @param client - Opencode client for updating stored credentials
+ * @returns Updated auth (throws on failure)
+ */
+export declare function refreshAndUpdateToken(currentAuth: Auth, client: OpencodeClient): Promise<Auth>;
+/**
+ * Extracts URL string from various request input types
+ * @param input - Request input (string, URL, or Request object)
+ * @returns URL string
+ */
+export declare function extractRequestUrl(input: Request | string | URL): string;
+/**
+ * Rewrites OpenAI API URLs to Codex backend URLs
+ * @param url - Original URL
+ * @returns Rewritten URL for Codex backend
+ */
+export declare function rewriteUrlForCodex(url: string): string;
+/**
+ * Transforms request body and logs the transformation
+ * Fetches model-specific Codex instructions based on the request model
+ *
+ * @param init - Request init options
+ * @param url - Request URL
+ * @param userConfig - User configuration
+ * @param codexMode - Enable CODEX_MODE (bridge prompt instead of tool remap)
+ * @param parsedBody - Pre-parsed body to avoid double JSON.parse (optional)
+ * @returns Transformed body and updated init, or undefined if no body
+ */
+export declare function transformRequestForCodex(init: RequestInit | undefined, url: string, userConfig: UserConfig, codexMode?: boolean, parsedBody?: Record<string, unknown>, options?: {
+    requestTransformMode?: "native" | "legacy";
+    fastSession?: boolean;
+    fastSessionStrategy?: "hybrid" | "always";
+    fastSessionMaxInputItems?: number;
+}): Promise<{
+    body: RequestBody;
+    updatedInit: RequestInit;
+} | undefined>;
+/**
+ * Creates headers for Codex API requests
+ * @param init - Request init options
+ * @param accountId - ChatGPT account ID
+ * @param accessToken - OAuth access token
+ * @param opts - Optional parameters including model, promptCacheKey, and organizationId
+ * @returns Headers object with all required Codex headers
+ */
+export declare function createCodexHeaders(init: RequestInit | undefined, accountId: string, accessToken: string, opts?: {
+    model?: string;
+    promptCacheKey?: string;
+    organizationId?: string;
+}): Headers;
+/**
+ * Handles error responses from the Codex API
+ * @param response - Error response from API
+ * @returns Original response or mapped retryable response
+ */
+export declare function handleErrorResponse(response: Response, options?: ErrorHandlingOptions): Promise<ErrorHandlingResult>;
+/**
+ * Handles successful responses from the Codex API
+ * Converts SSE to JSON for non-streaming requests (generateText)
+ * Passes through SSE for streaming requests (streamText)
+ * @param response - Success response from API
+ * @param isStreaming - Whether this is a streaming request (stream=true in body)
+ * @returns Processed response (SSE→JSON for non-streaming, stream for streaming)
+ */
+export declare function handleSuccessResponse(response: Response, isStreaming: boolean, options?: {
+    streamStallTimeoutMs?: number;
+}): Promise<Response>;
+//# sourceMappingURL=fetch-helpers.d.ts.map

package/dist/lib/request/fetch-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-helpers.d.ts","sourceRoot":"","sources":["../../../lib/request/fetch-helpers.ts"],"names":[],"mappings":"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"}