@kido/gemini-cookie-syncCopy Anchor Link

Architecture Paradigm: Chrome Extension Manifest V3 Bridge + Zero-Restart Hot-Reload process.env Sync + Zero-Dependency CRC32 ZIP Builder + HTTP 401 Auto-Recovery Interceptor.

💥 The Real-World Bottleneck (Why It Exists)Copy Anchor Link

Developers and autonomous AI automation pipelines running on Google Gemini face frustrating session expiration hurdles:

1. The Midnight Session Death Crash:
   • Google session cookies (__Secure-1PSIDTS, __Secure-1PSID) expire automatically within 12 to 24 hours.
   • Long-running autonomous AI agent pipelines, scheduled night jobs, and dev servers suddenly crash with HTTP 401 Unauthorized errors in the middle of execution.
2. Container Restart Downtime & Secrets Leakage:
   • The conventional fix requires developers to open Chrome DevTools, copy raw cookie values, paste them into a .env file, and restart the Docker container or server process.
   • This causes downtime, interrupts active client requests, and risks committing sensitive personal auth cookies into git repositories.
3. Complex Extension Distribution Friction:
   • Distributing internal browser extensions usually requires bundling external archive libraries (archiver, jszip), adding supply-chain dependencies.

🏛️ 3-Tier Production Evolution LadderCopy Anchor Link

📐 Architecture & Data FlowCopy Anchor Link

📦 Architecture & Core API ExportsCopy Anchor Link

All capabilities are strictly isolated in packages/gemini-cookie-sync:

1. src/server.tsCopy Anchor Link

• createHonoCookieSyncMiddleware(options): HTTP middleware catching synchronization requests from the Chrome Extension and auto-updating target environments.
• extractCookiesFromHeader(headerValue): Parses and extracts __Secure-1PSID, __Secure-1PSIDTS, and other Google tokens from incoming requests.
• syncCookiesToEnvironment(cookies, targetEnv): Safely mutates runtime environment variables in-memory without process interruption.
• createExtensionZipBuffer(): Generates a complete, installable Chrome Extension .zip file using a zero-dependency pure TypeScript CRC32 ZIP generator.

2. src/client.tsCopy Anchor Link

• setupFetchInterceptor(options): Wraps global window.fetch to catch 401 errors and trigger transparent session re-synchronization.
• isAuthOrCookieExpiredError(error): Classifies whether an HTTP error is due to an expired Google session.
• requestCookieSyncFromExtension(): Dispatches a message to the installed Chrome extension to extract fresh credentials.

3. src/constants.tsCopy Anchor Link

• Canonical cookie names, header keys, and default configuration constants.

💻 Production Implementation & Code SnippetCopy Anchor Link

1. Backend Server Setup with Hono (src/server.ts)Copy Anchor Link

import { Hono } from 'hono';
import {
  createHonoCookieSyncMiddleware,
  createExtensionZipBuffer,
} from '@kido/gemini-cookie-sync';

const app = new Hono();

// 1. Install Cookie Sync Middleware to hot-reload environment variables
app.use(
  '/api/internal/cookie-sync',
  createHonoCookieSyncMiddleware({
    secretKey: process.env.COOKIE_SYNC_SECRET || 'sync-salt-secret',
    targetEnv: process.env,
    onSyncSuccess: (updatedKeys) => {
      console.log(`[CookieSync] Successfully refreshed ${updatedKeys.length} session tokens in memory:`, updatedKeys);
    },
  })
);

// 2. Serve downloadable Chrome Extension ZIP directly to developer/operator
app.get('/api/tools/download-gemini-extension', (c) => {
  const zipBuffer = createExtensionZipBuffer();
  
  return c.body(zipBuffer, 200, {
    'Content-Type': 'application/zip',
    'Content-Disposition': 'attachment; filename="gemini-cookie-sync-extension.zip"',
  });
});

// 3. Autonomous AI Agent Route using fresh session cookies
app.post('/api/ai/execute-pipeline', async (c) => {
  const psid = process.env.__Secure_1PSID;
  const psidts = process.env.__Secure_1PSIDTS;

  if (!psid || !psidts) {
    return c.json({ error: 'Gemini auth cookies not configured. Please sync via extension.' }, 503);
  }

  // Execute Gemini internal agent call with fresh cookies
  return c.json({ status: 'success', activeSession: psid.slice(0, 8) + '...' });
});

export default app;

2. Frontend Auto-Recovery Fetch Interceptor (src/lib/api-client.ts)Copy Anchor Link

import {
  setupFetchInterceptor,
  requestCookieSyncFromExtension,
} from '@kido/gemini-cookie-sync';

// Install fetch interceptor to automatically heal expired sessions
export const removeInterceptor = setupFetchInterceptor({
  onAuthExpired: async () => {
    console.warn('[Session] Gemini session expired. Requesting fresh tokens from Chrome Extension...');
    const refreshed = await requestCookieSyncFromExtension();
    if (refreshed) {
      console.log('[Session] Fresh cookies synchronized. Resuming failed requests...');
      return true; // Tells interceptor to retry original request
    }
    return false;
  },
});

⚡ Benchmark & Verified PerformanceCopy Anchor Link

Tested during 24-hour continuous AI agent execution:

🚀 Surgical Extraction & CLI InstallationCopy Anchor Link

npx @kido/cli add gemini-cookie-sync