@farazirfan/costar-server-executor 1.0.0

package/dist/updates/checker.js

@@ -0,0 +1,237 @@
+/**
+ * CoStar Server Executor - Update Checker
+ * Adapted from OpenClaw's infra/update-check.ts and infra/update-startup.ts
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+// Check for updates every 24 hours (OpenClaw pattern)
+const UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const NPM_PACKAGE_NAME = "costar-server-executor";
+/**
+ * Get state directory
+ */
+function getStateDir() {
+    return path.join(os.homedir(), ".costar", "state");
+}
+/**
+ * Get update check state file path
+ */
+function getUpdateCheckStatePath() {
+    return path.join(getStateDir(), "update-check.json");
+}
+/**
+ * Read update check state from disk
+ * (Adapted from OpenClaw's readState pattern)
+ */
+async function readState() {
+    try {
+        const statePath = getUpdateCheckStatePath();
+        const raw = await fs.readFile(statePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Write update check state to disk
+ * (Adapted from OpenClaw's writeState pattern)
+ */
+async function writeState(state) {
+    const statePath = getUpdateCheckStatePath();
+    await fs.mkdir(path.dirname(statePath), { recursive: true });
+    await fs.writeFile(statePath, JSON.stringify(state, null, 2), "utf-8");
+}
+/**
+ * Fetch version from npm registry with timeout
+ * (Adapted from OpenClaw's fetchNpmTagVersion pattern)
+ */
+async function fetchNpmVersion(params) {
+    const timeoutMs = params.timeoutMs ?? 3500;
+    const npmTag = channelToNpmTag(params.channel);
+    try {
+        const ctrl = new AbortController();
+        const timeout = setTimeout(() => ctrl.abort(), timeoutMs);
+        try {
+            const url = `https://registry.npmjs.org/${NPM_PACKAGE_NAME}/${encodeURIComponent(npmTag)}`;
+            const res = await fetch(url, { signal: ctrl.signal });
+            if (!res.ok) {
+                return { version: null, error: `HTTP ${res.status}` };
+            }
+            const json = (await res.json());
+            const version = typeof json?.version === "string" ? json.version : null;
+            return { version };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    catch (err) {
+        return { version: null, error: String(err) };
+    }
+}
+/**
+ * Convert update channel to npm dist-tag
+ * (OpenClaw pattern)
+ */
+function channelToNpmTag(channel) {
+    switch (channel) {
+        case "beta":
+            return "beta";
+        case "dev":
+            return "dev";
+        case "latest":
+        default:
+            return "latest";
+    }
+}
+/**
+ * Parse semver version string
+ * (Simplified from OpenClaw's parseSemver)
+ */
+function parseSemver(version) {
+    if (!version)
+        return null;
+    const cleaned = version.replace(/^v/, "").split("-")[0]; // Remove 'v' prefix and prerelease
+    const parts = cleaned?.split(".");
+    if (!parts || parts.length < 3)
+        return null;
+    const major = parseInt(parts[0] ?? "0", 10);
+    const minor = parseInt(parts[1] ?? "0", 10);
+    const patch = parseInt(parts[2] ?? "0", 10);
+    if (!Number.isFinite(major) || !Number.isFinite(minor) || !Number.isFinite(patch)) {
+        return null;
+    }
+    return { major, minor, patch };
+}
+/**
+ * Compare two semver strings
+ * (Adapted from OpenClaw's compareSemverStrings)
+ * Returns: -1 if a < b, 0 if a === b, 1 if a > b, null if invalid
+ */
+export function compareSemverStrings(a, b) {
+    const pa = parseSemver(a);
+    const pb = parseSemver(b);
+    if (!pa || !pb)
+        return null;
+    if (pa.major !== pb.major)
+        return pa.major < pb.major ? -1 : 1;
+    if (pa.minor !== pb.minor)
+        return pa.minor < pb.minor ? -1 : 1;
+    if (pa.patch !== pb.patch)
+        return pa.patch < pb.patch ? -1 : 1;
+    return 0;
+}
+/**
+ * Get current version from package.json
+ */
+async function getCurrentVersion() {
+    try {
+        // Try to read from package.json in the module root
+        const packageJsonPath = path.join(process.cwd(), "package.json");
+        const raw = await fs.readFile(packageJsonPath, "utf-8");
+        const pkg = JSON.parse(raw);
+        return pkg.version || "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+/**
+ * Check if update check should run
+ * (Adapted from OpenClaw's shouldSkipCheck and interval logic)
+ */
+async function shouldCheckForUpdates(params) {
+    // Skip if disabled
+    if (!params.enabled)
+        return false;
+    // Skip in test mode
+    if (params.skipInTest && (process.env.VITEST || process.env.NODE_ENV === "test")) {
+        return false;
+    }
+    // Check if enough time has passed since last check
+    const state = await readState();
+    const now = Date.now();
+    const lastCheckedAt = state.lastCheckedAt ? Date.parse(state.lastCheckedAt) : null;
+    if (lastCheckedAt && Number.isFinite(lastCheckedAt)) {
+        const elapsed = now - lastCheckedAt;
+        if (elapsed < UPDATE_CHECK_INTERVAL_MS) {
+            return false; // Checked recently
+        }
+    }
+    return true;
+}
+/**
+ * Check for updates
+ * (Adapted from OpenClaw's runGatewayUpdateCheck pattern)
+ */
+export async function checkForUpdates(params) {
+    const enabled = params.enabled ?? true;
+    const channel = params.channel || "latest";
+    const timeoutMs = params.timeoutMs ?? 2500;
+    // Check if we should run
+    if (!(await shouldCheckForUpdates({ enabled, skipInTest: params.skipInTest }))) {
+        return null;
+    }
+    const now = Date.now();
+    const state = await readState();
+    const currentVersion = await getCurrentVersion();
+    // Fetch latest version from npm
+    const versionInfo = await fetchNpmVersion({ channel, timeoutMs });
+    // Update state with check timestamp
+    const nextState = {
+        ...state,
+        lastCheckedAt: new Date(now).toISOString(),
+    };
+    if (!versionInfo.version) {
+        // Failed to fetch version
+        await writeState(nextState);
+        return null;
+    }
+    // Compare versions
+    const cmp = compareSemverStrings(currentVersion, versionInfo.version);
+    const updateAvailable = cmp !== null && cmp < 0;
+    // Check if we should notify (only notify once per version)
+    const shouldNotify = updateAvailable &&
+        (state.lastNotifiedVersion !== versionInfo.version ||
+            state.lastNotifiedChannel !== channel);
+    if (shouldNotify) {
+        nextState.lastNotifiedVersion = versionInfo.version;
+        nextState.lastNotifiedChannel = channel;
+    }
+    await writeState(nextState);
+    return {
+        updateAvailable,
+        currentVersion,
+        latestVersion: versionInfo.version,
+        channel,
+        shouldNotify,
+    };
+}
+/**
+ * Schedule background update check (non-blocking)
+ * (Adapted from OpenClaw's scheduleGatewayUpdateCheck)
+ */
+export function scheduleUpdateCheck(params) {
+    const channel = params.channel || "latest";
+    const enabled = params.enabled ?? true;
+    // Run in background, don't block
+    void checkForUpdates({ channel, enabled, skipInTest: true })
+        .then((result) => {
+        if (result && result.shouldNotify && params.onUpdateAvailable) {
+            params.onUpdateAvailable(result);
+        }
+    })
+        .catch(() => {
+        // Silently fail - update checks shouldn't crash the app
+    });
+}
+/**
+ * Get update command for user
+ */
+export function getUpdateCommand() {
+    return "npm install -g costar-server-executor@latest";
+}
+//# sourceMappingURL=checker.js.map

package/dist/updates/checker.js.map

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

package/dist/updates/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CoStar Server Executor - Updates Module
+ */
+export { checkForUpdates, scheduleUpdateCheck, compareSemverStrings, getUpdateCommand, type UpdateChannel, type UpdateCheckState, type VersionInfo, type UpdateCheckResult, } from "./checker.js";
+export { sendUpdateNotification, createUpdateNotificationHandler, } from "./notifier.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/updates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/updates/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,eAAe,CAAC"}

package/dist/updates/index.js

@@ -0,0 +1,6 @@
+/**
+ * CoStar Server Executor - Updates Module
+ */
+export { checkForUpdates, scheduleUpdateCheck, compareSemverStrings, getUpdateCommand, } from "./checker.js";
+export { sendUpdateNotification, createUpdateNotificationHandler, } from "./notifier.js";
+//# sourceMappingURL=index.js.map

package/dist/updates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/updates/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GAKjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,eAAe,CAAC"}

package/dist/updates/notifier.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CoStar Server Executor - Update Notifier
+ * Sends update notifications via Supabase
+ */
+import type { UpdateCheckResult } from "./checker.js";
+/**
+ * Send update notification to user
+ */
+export declare function sendUpdateNotification(params: {
+    userId: string;
+    result: UpdateCheckResult;
+}): Promise<void>;
+/**
+ * Create update check callback that sends notifications
+ */
+export declare function createUpdateNotificationHandler(userId: string): (result: UpdateCheckResult) => void;
+//# sourceMappingURL=notifier.d.ts.map

package/dist/updates/notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../src/updates/notifier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,iBAAiB,CAAC;CAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhB;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,GACb,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAMrC"}

package/dist/updates/notifier.js

@@ -0,0 +1,44 @@
+/**
+ * CoStar Server Executor - Update Notifier
+ * Sends update notifications via Supabase
+ */
+import { sendNotification } from "../supabase/notifications.js";
+/**
+ * Send update notification to user
+ */
+export async function sendUpdateNotification(params) {
+    const { result, userId } = params;
+    if (!result.updateAvailable || !result.shouldNotify) {
+        return;
+    }
+    const message = [
+        `Update available: v${result.latestVersion} (current: v${result.currentVersion})`,
+        `Channel: ${result.channel}`,
+        "",
+        "To update, run:",
+        "npm install -g costar-server-executor@latest",
+    ].join("\n");
+    await sendNotification({
+        user_id: userId,
+        type: "system",
+        title: "CoStar Update Available",
+        message,
+        priority: "low",
+        metadata: {
+            updateVersion: result.latestVersion,
+            currentVersion: result.currentVersion,
+            channel: result.channel,
+        },
+    });
+}
+/**
+ * Create update check callback that sends notifications
+ */
+export function createUpdateNotificationHandler(userId) {
+    return (result) => {
+        void sendUpdateNotification({ userId, result }).catch((err) => {
+            console.error("[UPDATE] Failed to send notification:", err);
+        });
+    };
+}
+//# sourceMappingURL=notifier.js.map

package/dist/updates/notifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.js","sourceRoot":"","sources":["../../src/updates/notifier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAG5C;IACC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAElC,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACpD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG;QACd,sBAAsB,MAAM,CAAC,aAAa,eAAe,MAAM,CAAC,cAAc,GAAG;QACjF,YAAY,MAAM,CAAC,OAAO,EAAE;QAC5B,EAAE;QACF,iBAAiB;QACjB,8CAA8C;KAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,gBAAgB,CAAC;QACrB,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,yBAAyB;QAChC,OAAO;QACP,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE;YACR,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,MAAc;IAEd,OAAO,CAAC,MAAyB,EAAE,EAAE;QACnC,KAAK,sBAAsB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YAC5D,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/google-oauth.d.ts

@@ -0,0 +1,58 @@
+/**
+ * CoStar Server Executor - Google OAuth Utility
+ *
+ * Shared utility for Google API authentication using user OAuth tokens.
+ * Used by email and calendar tools to access Google APIs on behalf of users.
+ *
+ * Flow:
+ * 1. User logs in with Google in Flutter app
+ * 2. Flutter app saves tokens to backend (Asterizk API)
+ * 3. Backend tools use this utility to fetch tokens and create authenticated clients
+ */
+import { google, gmail_v1, calendar_v3 } from "googleapis";
+/**
+ * User's Google OAuth token data
+ */
+export interface GoogleTokens {
+    access_token: string;
+    refresh_token: string | null;
+    token_expires_at: string | null;
+}
+/**
+ * Get user's Google OAuth tokens from Asterizk API
+ * These tokens come from Flutter app when user logs in with Google
+ */
+export declare function getUserGoogleTokens(userId: string): Promise<GoogleTokens>;
+/**
+ * Check if a token is expired
+ */
+export declare function isTokenExpired(expiresAt: string | null): boolean;
+/**
+ * Refresh expired access token using refresh token
+ * (Tokens are managed by backend API, we just get fresh ones)
+ */
+export declare function refreshAccessToken(userId: string, refreshToken: string): Promise<string>;
+/**
+ * Get a valid access token for a user (refreshing if needed)
+ */
+export declare function getValidAccessToken(userId: string): Promise<string>;
+/**
+ * Create an authenticated OAuth2 client for a user
+ */
+export declare function createOAuth2Client(userId: string): Promise<InstanceType<typeof google.auth.OAuth2>>;
+/**
+ * Get Gmail client for a specific user
+ */
+export declare function getGmailClientForUser(userId: string): Promise<gmail_v1.Gmail>;
+/**
+ * Get Calendar client for a specific user
+ */
+export declare function getCalendarClientForUser(userId: string): Promise<calendar_v3.Calendar>;
+/**
+ * Handle Google API errors with helpful messages
+ */
+export declare function handleGoogleApiError(error: unknown, operation: string): {
+    error: string;
+    message: string;
+};
+//# sourceMappingURL=google-oauth.d.ts.map

package/dist/utils/google-oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-oauth.d.ts","sourceRoot":"","sources":["../../src/utils/google-oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAmC/E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAGhE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB9F;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUzE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAwBzG;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAGnF;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAG5F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA6B1G"}

package/dist/utils/google-oauth.js

@@ -0,0 +1,161 @@
+/**
+ * CoStar Server Executor - Google OAuth Utility
+ *
+ * Shared utility for Google API authentication using user OAuth tokens.
+ * Used by email and calendar tools to access Google APIs on behalf of users.
+ *
+ * Flow:
+ * 1. User logs in with Google in Flutter app
+ * 2. Flutter app saves tokens to backend (Asterizk API)
+ * 3. Backend tools use this utility to fetch tokens and create authenticated clients
+ */
+import { google } from "googleapis";
+/**
+ * Get user's Google OAuth tokens from Asterizk API
+ * These tokens come from Flutter app when user logs in with Google
+ */
+export async function getUserGoogleTokens(userId) {
+    const apiUrl = process.env.ASTERIZK_API_URL || "https://api-dev.asterizk.ai";
+    if (!userId) {
+        throw new Error("USER_ID is required to fetch Google tokens");
+    }
+    try {
+        const response = await fetch(`${apiUrl}/email/auth/tokens/${userId}`, {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 404) {
+                throw new Error(`No Google tokens found for user ${userId}. Please login with Google in the app.`);
+            }
+            throw new Error(`Failed to fetch tokens: ${response.statusText}`);
+        }
+        const data = await response.json();
+        return {
+            access_token: data.access_token || data.google_access_token,
+            refresh_token: data.refresh_token || data.google_refresh_token || null,
+            token_expires_at: data.token_expires_at || data.expiry_date || null,
+        };
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw error;
+        }
+        throw new Error(`Failed to fetch Google tokens for user ${userId}: ${String(error)}`);
+    }
+}
+/**
+ * Check if a token is expired
+ */
+export function isTokenExpired(expiresAt) {
+    if (!expiresAt)
+        return false;
+    return new Date(expiresAt) < new Date();
+}
+/**
+ * Refresh expired access token using refresh token
+ * (Tokens are managed by backend API, we just get fresh ones)
+ */
+export async function refreshAccessToken(userId, refreshToken) {
+    const clientId = process.env.GOOGLE_CLIENT_ID;
+    const clientSecret = process.env.GOOGLE_CLIENT_SECRET;
+    if (!clientId || !clientSecret) {
+        throw new Error("GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET are required for token refresh");
+    }
+    try {
+        const oauth2Client = new google.auth.OAuth2(clientId, clientSecret);
+        oauth2Client.setCredentials({ refresh_token: refreshToken });
+        const { credentials } = await oauth2Client.refreshAccessToken();
+        const newAccessToken = credentials.access_token;
+        if (!newAccessToken) {
+            throw new Error("Failed to refresh access token");
+        }
+        console.log(`[GOOGLE_OAUTH] Refreshed access token for user ${userId}`);
+        return newAccessToken;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to refresh token: ${message}`);
+    }
+}
+/**
+ * Get a valid access token for a user (refreshing if needed)
+ */
+export async function getValidAccessToken(userId) {
+    const tokens = await getUserGoogleTokens(userId);
+    // Check if token is expired
+    if (isTokenExpired(tokens.token_expires_at) && tokens.refresh_token) {
+        console.log(`[GOOGLE_OAUTH] Token expired for user ${userId}, refreshing...`);
+        return await refreshAccessToken(userId, tokens.refresh_token);
+    }
+    return tokens.access_token;
+}
+/**
+ * Create an authenticated OAuth2 client for a user
+ */
+export async function createOAuth2Client(userId) {
+    const clientId = process.env.GOOGLE_CLIENT_ID;
+    const clientSecret = process.env.GOOGLE_CLIENT_SECRET;
+    if (!clientId || !clientSecret) {
+        throw new Error("GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET are required");
+    }
+    const tokens = await getUserGoogleTokens(userId);
+    // Check if token is expired and refresh if needed
+    let accessToken = tokens.access_token;
+    if (isTokenExpired(tokens.token_expires_at) && tokens.refresh_token) {
+        console.log(`[GOOGLE_OAUTH] Token expired for user ${userId}, refreshing...`);
+        accessToken = await refreshAccessToken(userId, tokens.refresh_token);
+    }
+    const oauth2Client = new google.auth.OAuth2(clientId, clientSecret);
+    oauth2Client.setCredentials({
+        access_token: accessToken,
+        refresh_token: tokens.refresh_token || undefined,
+    });
+    return oauth2Client;
+}
+/**
+ * Get Gmail client for a specific user
+ */
+export async function getGmailClientForUser(userId) {
+    const auth = await createOAuth2Client(userId);
+    return google.gmail({ version: "v1", auth });
+}
+/**
+ * Get Calendar client for a specific user
+ */
+export async function getCalendarClientForUser(userId) {
+    const auth = await createOAuth2Client(userId);
+    return google.calendar({ version: "v3", auth });
+}
+/**
+ * Handle Google API errors with helpful messages
+ */
+export function handleGoogleApiError(error, operation) {
+    const message = error instanceof Error ? error.message : String(error);
+    // Check for common error types
+    if (message.includes("invalid_grant")) {
+        return {
+            error: "token_expired",
+            message: "Google token expired or revoked. Please login again in the app.",
+        };
+    }
+    if (message.includes("No Google tokens found")) {
+        return {
+            error: "not_authenticated",
+            message: "Please login with Google in the app first.",
+        };
+    }
+    if (message.includes("insufficient")) {
+        return {
+            error: "insufficient_permissions",
+            message: "Missing required Google permissions. Please re-login and grant all requested permissions.",
+        };
+    }
+    return {
+        error: `${operation}_failed`,
+        message,
+    };
+}
+//# sourceMappingURL=google-oauth.js.map

package/dist/utils/google-oauth.js.map

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

package/dist/utils/log-buffer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * CoStar Server Executor - In-Memory Log Buffer
+ * Captures console output into a ring buffer for the web dashboard
+ */
+export type LogEntry = {
+    id: number;
+    timestamp: string;
+    level: "info" | "warn" | "error" | "debug";
+    component: string;
+    message: string;
+};
+/** Add a log entry to the buffer */
+export declare function addLog(level: LogEntry["level"], component: string, message: string): void;
+/** Get recent log entries with optional filtering */
+export declare function getLogs(options?: {
+    limit?: number;
+    offset?: number;
+    component?: string;
+    level?: string;
+}): {
+    entries: LogEntry[];
+    total: number;
+};
+/** Register an SSE client */
+export declare function addSSEClient(res: any): number;
+/** Remove an SSE client */
+export declare function removeSSEClient(id: number): void;
+/** Get available component names */
+export declare function getLogComponents(): string[];
+/**
+ * Intercept console methods to capture logs into the buffer.
+ * Call this once at server startup.
+ */
+export declare function interceptConsoleLogs(): void;
+//# sourceMappingURL=log-buffer.d.ts.map

package/dist/utils/log-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-buffer.d.ts","sourceRoot":"","sources":["../../src/utils/log-buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAaF,oCAAoC;AACpC,wBAAgB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAwBzF;AAED,qDAAqD;AACrD,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG;IAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAkBzC;AAED,6BAA6B;AAC7B,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAI7C;AAED,2BAA2B;AAC3B,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,oCAAoC;AACpC,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAG3C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAkC3C"}