offcourse 0.0.2 → 1.0.1

package/dist/shared/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/shared/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAKhE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,qEAAqE;IACrE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAcD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,GAAE,MAAM,EAA2B,GAC1C,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAE1B;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAPpB,MAAM,KAAK,OAOoE,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAZxB,MAAM,KAAK,OAmBlB,CAAC;AAOH;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAyBD;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAoDtF;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACzD,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC,CAwErD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGnE;AAED;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/shared/auth.js

@@ -0,0 +1,197 @@
+import { chromium } from "playwright";
+import { getSessionPath, SESSIONS_DIR } from "../config/paths.js";
+import { ensureDir, outputJson, pathExists, readJson, removeFile } from "./fs.js";
+/**
+ * Default login page detection patterns.
+ */
+const DEFAULT_LOGIN_PATTERNS = [
+    /\/login/,
+    /\/signin/,
+    /\/auth/,
+    /accounts\.google\.com/,
+    /firebaseapp\.com/,
+    /sso\./,
+];
+/**
+ * Creates a login page checker from patterns.
+ */
+export function createLoginChecker(patterns = DEFAULT_LOGIN_PATTERNS) {
+    return (url) => patterns.some((p) => p.test(url));
+}
+/**
+ * Skool-specific login page checker.
+ */
+export const isSkoolLoginPage = createLoginChecker([/\/login/, /accounts\.google\.com/]);
+/**
+ * HighLevel-specific login page checker.
+ */
+export const isHighLevelLoginPage = createLoginChecker([
+    /sso\.clientclub\.net/,
+    /\/login/,
+    /\/signin/,
+    /\/auth/,
+    /accounts\.google\.com/,
+    /firebaseapp\.com/,
+]);
+// ============================================
+// Browser automation - not unit testable
+// ============================================
+/* v8 ignore start */
+/**
+ * Checks if a valid session exists for the given domain.
+ */
+export async function hasValidSession(domain) {
+    const sessionPath = getSessionPath(domain);
+    return pathExists(sessionPath);
+}
+/**
+ * Loads an existing session from disk.
+ */
+async function loadSession(browser, domain) {
+    const sessionPath = getSessionPath(domain);
+    // Playwright's storageState type is complex, we load it as-is from JSON
+    const storageState = await readJson(sessionPath);
+    if (!storageState) {
+        throw new Error("Session file not found or invalid");
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-explicit-any
+    return browser.newContext({ storageState: storageState });
+}
+/**
+ * Saves the current session to disk.
+ */
+async function saveSession(context, domain) {
+    const sessionPath = getSessionPath(domain);
+    const storageState = await context.storageState();
+    await outputJson(sessionPath, storageState);
+}
+/**
+ * Performs interactive login by opening a browser window.
+ * The user logs in manually, and we capture the session.
+ */
+export async function performInteractiveLogin(config) {
+    await ensureDir(SESSIONS_DIR);
+    const browser = await chromium.launch({
+        headless: false, // Must be visible for user interaction
+    });
+    const context = await browser.newContext({
+        viewport: { width: 1280, height: 800 },
+    });
+    const page = await context.newPage();
+    await page.goto(config.loginUrl);
+    console.log("\n🔐 Browser opened. Please log in manually.");
+    console.log("   The window will close automatically after successful login.\n");
+    const timeout = config.loginTimeout ?? 300000; // 5 minutes default
+    const startTime = Date.now();
+    let loggedIn = false;
+    while (!loggedIn && Date.now() - startTime < timeout) {
+        await page.waitForTimeout(1000);
+        const currentUrl = page.url();
+        // Check if we're no longer on a login page
+        if (!config.isLoginPage(currentUrl)) {
+            // Optionally verify with custom function
+            if (config.verifySession) {
+                loggedIn = await config.verifySession(page);
+            }
+            else {
+                loggedIn = true;
+            }
+        }
+    }
+    if (!loggedIn) {
+        await browser.close();
+        throw new Error(`Login timed out after ${timeout / 1000} seconds`);
+    }
+    // Give the page a moment to fully load after login
+    await page.waitForLoadState("networkidle").catch(() => { });
+    await page.waitForTimeout(1000);
+    // Save the session
+    await saveSession(context, config.domain);
+    console.log("✅ Login successful! Session saved.\n");
+    return { context, page };
+}
+/**
+ * Gets an authenticated session, either from cache or via interactive login.
+ */
+export async function getAuthenticatedSession(config, options = {}) {
+    const useHeadless = options.headless !== false;
+    const browser = await chromium.launch({
+        headless: useHeadless,
+    });
+    // Try to use existing session
+    if (!options.forceLogin && (await hasValidSession(config.domain))) {
+        try {
+            const context = await loadSession(browser, config.domain);
+            const page = await context.newPage();
+            // Navigate to verify session
+            await page.goto(config.loginUrl);
+            await page.waitForLoadState("domcontentloaded");
+            await page.waitForTimeout(2000);
+            const currentUrl = page.url();
+            // Check if we got redirected to login
+            if (config.isLoginPage(currentUrl)) {
+                console.log("⚠️  Session expired, need to re-login...");
+                await context.close();
+                await browser.close();
+            }
+            else {
+                // Optionally verify session
+                if (config.verifySession) {
+                    const isValid = await config.verifySession(page);
+                    if (!isValid) {
+                        console.log("⚠️  Session invalid, need to re-login...");
+                        await context.close();
+                        await browser.close();
+                    }
+                    else {
+                        console.log("✅ Using cached session");
+                        return { browser, session: { context, page } };
+                    }
+                }
+                else {
+                    console.log("✅ Using cached session");
+                    return { browser, session: { context, page } };
+                }
+            }
+        }
+        catch (error) {
+            console.log("⚠️  Failed to load session, need to re-login...", error);
+            await browser.close();
+        }
+    }
+    else {
+        await browser.close();
+    }
+    // Need fresh login - always visible for interactive login
+    const session = await performInteractiveLogin(config);
+    // Get the browser from the session context
+    const sessionBrowser = session.context.browser();
+    if (!sessionBrowser) {
+        throw new Error("Failed to get browser from session");
+    }
+    // After login, reopen with headless browser if needed
+    if (useHeadless) {
+        const newBrowser = await chromium.launch({ headless: true });
+        const context = await loadSession(newBrowser, config.domain);
+        const page = await context.newPage();
+        // Close the interactive session
+        await sessionBrowser.close();
+        return { browser: newBrowser, session: { context, page } };
+    }
+    return { browser: sessionBrowser, session };
+}
+/**
+ * Clears the session for a domain.
+ */
+export async function clearSession(domain) {
+    const sessionPath = getSessionPath(domain);
+    return removeFile(sessionPath);
+}
+/**
+ * Checks if the page has a valid Firebase auth token.
+ * Used by HighLevel/GoHighLevel portals.
+ */
+// Re-export Firebase auth utilities (used by multiple platforms)
+export { hasValidFirebaseToken } from "./firebase.js";
+/* v8 ignore stop */
+//# sourceMappingURL=auth.js.map

package/dist/shared/auth.js.map

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

package/dist/shared/firebase.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Firebase Authentication utilities.
+ *
+ * Firebase Auth is used by many platforms (HighLevel, etc.) for user authentication.
+ * This module provides shared types, schemas, and utilities for Firebase Auth tokens
+ * stored in localStorage.
+ */
+import { z } from "zod";
+import type { Page } from "playwright";
+/**
+ * Zod schema for validated Firebase auth token from localStorage.
+ * Use this after parsing to ensure the token has all required fields.
+ */
+export declare const FirebaseAuthTokenSchema: z.ZodObject<{
+    stsTokenManager: z.ZodObject<{
+        accessToken: z.ZodString;
+        expirationTime: z.ZodOptional<z.ZodNumber>;
+        refreshToken: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type FirebaseAuthToken = z.infer<typeof FirebaseAuthTokenSchema>;
+/**
+ * Raw Firebase auth data structure from localStorage (before validation).
+ * Use this type when parsing JSON from localStorage.
+ */
+export interface FirebaseAuthRaw {
+    stsTokenManager?: {
+        accessToken?: string;
+        expirationTime?: number;
+        refreshToken?: string;
+    };
+}
+/**
+ * The localStorage key pattern for Firebase auth tokens.
+ * Firebase stores auth tokens with keys like "firebase:authUser:API_KEY:[DEFAULT]"
+ */
+export declare const FIREBASE_AUTH_KEY_PATTERN = "firebase:authUser";
+/**
+ * Finds the Firebase auth token key in localStorage.
+ * Returns null if no Firebase auth token is found.
+ */
+export declare function findFirebaseAuthKey(storage: Storage): string | null;
+/**
+ * Checks if a Firebase auth token is expired.
+ */
+export declare function isTokenExpired(token: FirebaseAuthRaw): boolean;
+/**
+ * Extracts the access token from Firebase auth data.
+ */
+export declare function getAccessToken(token: FirebaseAuthRaw): string | undefined;
+/**
+ * Checks if the page has a valid (non-expired) Firebase auth token in localStorage.
+ */
+export declare function hasValidFirebaseToken(page: Page): Promise<boolean>;
+/**
+ * Extracts the Firebase auth token from the page's localStorage.
+ * Returns the raw token data or null if not found.
+ */
+export declare function extractFirebaseAuthFromPage(page: Page): Promise<FirebaseAuthRaw | null>;
+//# sourceMappingURL=firebase.d.ts.map

package/dist/shared/firebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase.d.ts","sourceRoot":"","sources":["../../src/shared/firebase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;iBAMlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAMD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEnE;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAQ9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAEzE;AAQD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BxE;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAsB7F"}

package/dist/shared/firebase.js

@@ -0,0 +1,102 @@
+/**
+ * Firebase Authentication utilities.
+ *
+ * Firebase Auth is used by many platforms (HighLevel, etc.) for user authentication.
+ * This module provides shared types, schemas, and utilities for Firebase Auth tokens
+ * stored in localStorage.
+ */
+import { z } from "zod";
+// ============================================================================
+// Schemas & Types
+// ============================================================================
+/**
+ * Zod schema for validated Firebase auth token from localStorage.
+ * Use this after parsing to ensure the token has all required fields.
+ */
+export const FirebaseAuthTokenSchema = z.object({
+    stsTokenManager: z.object({
+        accessToken: z.string(),
+        expirationTime: z.number().optional(),
+        refreshToken: z.string().optional(),
+    }),
+});
+// ============================================================================
+// localStorage Key Detection
+// ============================================================================
+/**
+ * The localStorage key pattern for Firebase auth tokens.
+ * Firebase stores auth tokens with keys like "firebase:authUser:API_KEY:[DEFAULT]"
+ */
+export const FIREBASE_AUTH_KEY_PATTERN = "firebase:authUser";
+/**
+ * Finds the Firebase auth token key in localStorage.
+ * Returns null if no Firebase auth token is found.
+ */
+export function findFirebaseAuthKey(storage) {
+    return Object.keys(storage).find((k) => k.includes(FIREBASE_AUTH_KEY_PATTERN)) ?? null;
+}
+// ============================================================================
+// Token Utilities
+// ============================================================================
+/**
+ * Checks if a Firebase auth token is expired.
+ */
+export function isTokenExpired(token) {
+    const expirationTime = token.stsTokenManager?.expirationTime;
+    if (!expirationTime) {
+        // No expiration time means we can't determine if expired
+        // Assume valid if we have an access token
+        return !token.stsTokenManager?.accessToken;
+    }
+    return Date.now() >= expirationTime;
+}
+/**
+ * Extracts the access token from Firebase auth data.
+ */
+export function getAccessToken(token) {
+    return token.stsTokenManager?.accessToken;
+}
+// ============================================================================
+// Page Utilities (Playwright)
+// ============================================================================
+/* v8 ignore start */
+/**
+ * Checks if the page has a valid (non-expired) Firebase auth token in localStorage.
+ */
+export async function hasValidFirebaseToken(page) {
+    try {
+        return await page.evaluate(({ keyPattern }) => {
+            const tokenKey = Object.keys(localStorage).find((k) => k.includes(keyPattern));
+            if (!tokenKey)
+                return false;
+            const tokenData = JSON.parse(localStorage.getItem(tokenKey) ?? "{}");
+            const expirationTime = tokenData?.stsTokenManager?.expirationTime;
+            if (expirationTime) {
+                return Date.now() < expirationTime;
+            }
+            return !!tokenData?.stsTokenManager?.accessToken;
+        }, { keyPattern: FIREBASE_AUTH_KEY_PATTERN });
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Extracts the Firebase auth token from the page's localStorage.
+ * Returns the raw token data or null if not found.
+ */
+export async function extractFirebaseAuthFromPage(page) {
+    return page.evaluate(({ keyPattern }) => {
+        const tokenKey = Object.keys(localStorage).find((k) => k.includes(keyPattern));
+        if (!tokenKey)
+            return null;
+        try {
+            return JSON.parse(localStorage.getItem(tokenKey) ?? "{}");
+        }
+        catch {
+            return null;
+        }
+    }, { keyPattern: FIREBASE_AUTH_KEY_PATTERN });
+}
+/* v8 ignore stop */
+//# sourceMappingURL=firebase.js.map

package/dist/shared/firebase.js.map

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

package/dist/shared/fs.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Check if a file or directory exists.
+ */
+export declare function pathExists(path: string): Promise<boolean>;
+/**
+ * Ensure a directory exists, creating it recursively if needed.
+ */
+export declare function ensureDir(dir: string): Promise<void>;
+/**
+ * Write a file, creating parent directories if needed.
+ */
+export declare function outputFile(path: string, data: string): Promise<void>;
+/**
+ * Write JSON to a file, creating parent directories if needed.
+ */
+export declare function outputJson(path: string, data: unknown): Promise<void>;
+/**
+ * Read and parse a JSON file.
+ * Returns null if file doesn't exist or can't be parsed.
+ */
+export declare function readJson<T = unknown>(path: string): Promise<T | null>;
+/**
+ * Remove a file if it exists.
+ */
+export declare function removeFile(path: string): Promise<boolean>;
+/**
+ * Get file size in bytes, or null if file doesn't exist.
+ */
+export declare function getFileSize(path: string): Promise<number | null>;
+export { readFile, writeFile, mkdir, unlink, stat } from "node:fs/promises";
+//# sourceMappingURL=fs.d.ts.map

package/dist/shared/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/shared/fs.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAO3E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOtE;AAGD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/shared/fs.js

@@ -0,0 +1,77 @@
+/**
+ * Thin wrappers around fs/promises for common operations.
+ * Excluded from coverage - testing would just test Node.js itself.
+ */
+import { mkdir, readFile, writeFile, unlink, access, stat } from "node:fs/promises";
+import { dirname } from "node:path";
+/**
+ * Check if a file or directory exists.
+ */
+export async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Ensure a directory exists, creating it recursively if needed.
+ */
+export async function ensureDir(dir) {
+    await mkdir(dir, { recursive: true });
+}
+/**
+ * Write a file, creating parent directories if needed.
+ */
+export async function outputFile(path, data) {
+    await ensureDir(dirname(path));
+    await writeFile(path, data, "utf-8");
+}
+/**
+ * Write JSON to a file, creating parent directories if needed.
+ */
+export async function outputJson(path, data) {
+    await outputFile(path, JSON.stringify(data, null, 2));
+}
+/**
+ * Read and parse a JSON file.
+ * Returns null if file doesn't exist or can't be parsed.
+ */
+export async function readJson(path) {
+    try {
+        const content = await readFile(path, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Remove a file if it exists.
+ */
+export async function removeFile(path) {
+    try {
+        await unlink(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get file size in bytes, or null if file doesn't exist.
+ */
+export async function getFileSize(path) {
+    try {
+        const stats = await stat(path);
+        return stats.size;
+    }
+    catch {
+        return null;
+    }
+}
+// Re-export commonly used fs/promises functions
+export { readFile, writeFile, mkdir, unlink, stat } from "node:fs/promises";
+//# sourceMappingURL=fs.js.map

package/dist/shared/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/shared/fs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,IAAY;IACzD,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,IAAa;IAC1D,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAc,IAAY;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/shared/http.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default User-Agent for HTTP requests.
+ * Mimics a standard Chrome browser on macOS.
+ */
+export declare const USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+/**
+ * Pre-configured HTTP client with sensible defaults.
+ * Uses ky for automatic retries, better error handling, and cleaner API.
+ */
+export declare const http: import("ky").KyInstance;
+/**
+ * HTTP client configured for JSON APIs.
+ */
+export declare const httpJson: import("ky").KyInstance;
+//# sourceMappingURL=http.d.ts.map

package/dist/shared/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/shared/http.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,UAAU,0HACkG,CAAC;AAE1H;;;GAGG;AACH,eAAO,MAAM,IAAI,yBAWf,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ,yBAInB,CAAC"}

package/dist/shared/http.js

@@ -0,0 +1,31 @@
+import ky from "ky";
+/**
+ * Default User-Agent for HTTP requests.
+ * Mimics a standard Chrome browser on macOS.
+ */
+export const USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+/**
+ * Pre-configured HTTP client with sensible defaults.
+ * Uses ky for automatic retries, better error handling, and cleaner API.
+ */
+export const http = ky.create({
+    headers: {
+        "User-Agent": USER_AGENT,
+        Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
+        "Accept-Language": "en-US,en;q=0.5",
+    },
+    timeout: 30000,
+    retry: {
+        limit: 2,
+        statusCodes: [408, 413, 429, 500, 502, 503, 504],
+    },
+});
+/**
+ * HTTP client configured for JSON APIs.
+ */
+export const httpJson = http.extend({
+    headers: {
+        Accept: "application/json",
+    },
+});
+//# sourceMappingURL=http.js.map

package/dist/shared/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/shared/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GACrB,uHAAuH,CAAC;AAE1H;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC;IAC5B,OAAO,EAAE;QACP,YAAY,EAAE,UAAU;QACxB,MAAM,EAAE,4EAA4E;QACpF,iBAAiB,EAAE,gBAAgB;KACpC;IACD,OAAO,EAAE,KAAK;IACd,KAAK,EAAE;QACL,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;KACjD;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE;QACP,MAAM,EAAE,kBAAkB;KAC3B;CACF,CAAC,CAAC"}

package/dist/shared/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./auth.js";
+export * from "./firebase.js";
+export * from "./fs.js";
+export * from "./http.js";
+export * from "./slug.js";
+export * from "./url.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,7 @@
+export * from "./auth.js";
+export * from "./firebase.js";
+export * from "./fs.js";
+export * from "./http.js";
+export * from "./slug.js";
+export * from "./url.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/shared/slug.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Creates a filesystem-safe slug from a string.
+ * Handles Unicode characters, special symbols, and edge cases.
+ */
+export declare function slugify(name: string): string;
+/**
+ * Creates a folder name with zero-padded index prefix.
+ * Example: createFolderName(0, "Introduction") → "01-introduction"
+ */
+export declare function createFolderName(index: number, name: string): string;
+//# sourceMappingURL=slug.d.ts.map

package/dist/shared/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/shared/slug.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpE"}

package/dist/shared/slug.js

@@ -0,0 +1,25 @@
+/**
+ * Shared slugification utilities.
+ * Uses @sindresorhus/slugify for proper Unicode transliteration.
+ */
+import slugifyLib from "@sindresorhus/slugify";
+/**
+ * Creates a filesystem-safe slug from a string.
+ * Handles Unicode characters, special symbols, and edge cases.
+ */
+export function slugify(name) {
+    return slugifyLib(name, {
+        lowercase: true,
+        separator: "-",
+    }).substring(0, 100);
+}
+/**
+ * Creates a folder name with zero-padded index prefix.
+ * Example: createFolderName(0, "Introduction") → "01-introduction"
+ */
+export function createFolderName(index, name) {
+    const prefix = String(index + 1).padStart(2, "0");
+    const slug = slugify(name);
+    return `${prefix}-${slug}`;
+}
+//# sourceMappingURL=slug.js.map

package/dist/shared/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/shared/slug.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,UAAU,CAAC,IAAI,EAAE;QACtB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,GAAG;KACf,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,IAAY;IAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;AAC7B,CAAC"}