@codeyam/codeyam-cli 0.1.0-staging.a890816 → 0.1.0-staging.aa28063

package/codeyam-cli/src/utils/editorPreloadHelpers.js

@@ -0,0 +1,135 @@
+/**
+ * Pure redirect and mock-matching functions for the Node.js preload module.
+ *
+ * Extracted so they can be unit-tested without loading the actual preload
+ * (which patches global fetch and http).
+ */
+/**
+ * If `url` points to the dev server, return a redirected URL going through the proxy.
+ * Otherwise return the original URL unchanged.
+ */
+export function redirectUrl(url, devServerUrl, proxyUrl) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        // Relative URL or invalid — pass through
+        return url;
+    }
+    const dev = new URL(devServerUrl);
+    const proxy = new URL(proxyUrl);
+    if (parsed.hostname === dev.hostname && parsed.port === dev.port) {
+        parsed.hostname = proxy.hostname;
+        parsed.port = proxy.port;
+        parsed.protocol = proxy.protocol;
+        return parsed.toString();
+    }
+    return url;
+}
+/**
+ * If http.request options target the dev server, patch them to go through the proxy.
+ * Returns the original options object if no redirect is needed.
+ */
+export function redirectOptions(options, devServerUrl, proxyUrl) {
+    const dev = new URL(devServerUrl);
+    const proxy = new URL(proxyUrl);
+    const devPort = parseInt(dev.port, 10);
+    const proxyPort = parseInt(proxy.port, 10);
+    // Match on hostname + port
+    if (options.hostname &&
+        parseInt(String(options.port), 10) === devPort &&
+        options.hostname === dev.hostname) {
+        return {
+            ...options,
+            hostname: proxy.hostname,
+            port: proxyPort,
+            headers: options.headers
+                ? { ...options.headers, host: `${proxy.hostname}:${proxyPort}` }
+                : options.headers,
+        };
+    }
+    // Match on host field (hostname:port combined)
+    if (options.host) {
+        const expectedHost = `${dev.hostname}:${devPort}`;
+        if (options.host === expectedHost) {
+            return {
+                ...options,
+                host: `${proxy.hostname}:${proxyPort}`,
+            };
+        }
+    }
+    return options;
+}
+/**
+ * Match a request URL against scenario mock data routes.
+ *
+ * Supports:
+ * - Path-only routes:    "/api/drinks" matches fetch("http://localhost:3000/api/drinks")
+ * - Full URL routes:     "https://api.stripe.com/v1/charges" matches external API calls
+ * - Method-prefixed:     "POST /api/drinks" matches POST requests only
+ *
+ * Returns the mock response if matched, or null if no match.
+ */
+export function matchScenarioRoute(requestUrl, method, scenarioData) {
+    const routes = scenarioData.routes;
+    if (!routes || typeof routes !== 'object')
+        return null;
+    // Extract pathname from the request URL
+    let pathname;
+    try {
+        const parsed = new URL(requestUrl);
+        pathname = parsed.pathname;
+    }
+    catch {
+        // Relative URL — use as-is
+        pathname = requestUrl.split('?')[0];
+    }
+    const upperMethod = method.toUpperCase();
+    for (const [routeKey, routeValue] of Object.entries(routes)) {
+        if (!routeValue || typeof routeValue !== 'object')
+            continue;
+        const entry = routeValue;
+        // Check for method-prefixed route: "POST /api/drinks"
+        const spaceIdx = routeKey.indexOf(' ');
+        if (spaceIdx !== -1) {
+            const routeMethod = routeKey.slice(0, spaceIdx).toUpperCase();
+            const routePath = routeKey.slice(spaceIdx + 1);
+            if (routeMethod === upperMethod && routePath === pathname) {
+                return {
+                    body: entry.body ?? routeValue,
+                    status: typeof entry.status === 'number' ? entry.status : 200,
+                };
+            }
+            continue;
+        }
+        // Full URL route: "https://api.stripe.com/v1/charges"
+        if (routeKey.startsWith('http://') || routeKey.startsWith('https://')) {
+            try {
+                const routeParsed = new URL(routeKey);
+                const reqParsed = new URL(requestUrl);
+                if (routeParsed.hostname === reqParsed.hostname &&
+                    routeParsed.port === reqParsed.port &&
+                    routeParsed.pathname === reqParsed.pathname) {
+                    return {
+                        body: entry.body ?? routeValue,
+                        status: typeof entry.status === 'number' ? entry.status : 200,
+                    };
+                }
+            }
+            catch {
+                // Invalid URL in route key — skip
+            }
+            continue;
+        }
+        // Path-only route: "/api/drinks"
+        if (routeKey === pathname) {
+            return {
+                body: entry.body ?? routeValue,
+                status: typeof entry.status === 'number' ? entry.status : 200,
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=editorPreloadHelpers.js.map

package/codeyam-cli/src/utils/editorPreloadHelpers.js.map

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

package/codeyam-cli/src/utils/editorPreview.js

@@ -0,0 +1,139 @@
+/**
+ * Preview URL construction and viewport scaling for the editor.
+ *
+ * Extracted from inline logic in editor.tsx (previewUrl useMemo and previewScale useMemo).
+ */
+import { generateScenarioSlug } from "./editorScenarios.js";
+/**
+ * Resolve the preview URL based on current editor state.
+ *
+ * Priority:
+ * 1. Analyzed scenario with interactive server URL
+ * 2. Active scenario with path-based URL → combine with proxy/dev server
+ * 3. Active scenario with full URL → use directly
+ * 4. Zoom component with scenario → __codeyam__ isolation URL
+ * 5. Base proxy/dev server URL
+ */
+export function buildPreviewUrl(params) {
+    const { activeAnalyzedScenario, analyzedPreviewUrl, activeScenarioId, scenarios, proxyUrl, devServerUrl, zoomComponent, } = params;
+    // When viewing an analyzed scenario, use the interactive server URL
+    if (activeAnalyzedScenario && analyzedPreviewUrl) {
+        return analyzedPreviewUrl;
+    }
+    // If analyzed scenario is active but no URL, fall through to check other sources
+    // but if nothing else matches either, return null
+    if (activeAnalyzedScenario && !analyzedPreviewUrl) {
+        return null;
+    }
+    // Component isolation scenarios store a path (e.g. /isolated-components/DrinkCard?s=Default)
+    if (activeScenarioId) {
+        const scenario = scenarios.find((s) => s.id === activeScenarioId);
+        if (scenario?.url) {
+            const base = proxyUrl || devServerUrl;
+            if (!base)
+                return null;
+            if (scenario.url.startsWith('/')) {
+                return `${base}${scenario.url}`;
+            }
+            return scenario.url;
+        }
+    }
+    const baseUrl = proxyUrl || devServerUrl;
+    if (!baseUrl)
+        return null;
+    if (zoomComponent && activeScenarioId) {
+        const scenario = scenarios.find((s) => s.id === activeScenarioId);
+        const scenarioSlug = scenario
+            ? generateScenarioSlug(scenario.name)
+            : 'Default';
+        return `${baseUrl}/__codeyam__/${zoomComponent}/${scenarioSlug}`;
+    }
+    return baseUrl;
+}
+/**
+ * Apply a navigation path override to a preview URL.
+ *
+ * Correctly handles paths with query strings (e.g. `/isolated-components/DrinkCard?s=Default`)
+ * by parsing the path into pathname + search components instead of naively assigning
+ * to `URL.pathname` (which would URL-encode the `?`).
+ */
+export function applyNavigatePath(previewUrl, navigatePath) {
+    if (!previewUrl)
+        return previewUrl;
+    if (!navigatePath)
+        return previewUrl;
+    try {
+        const base = new URL(previewUrl);
+        // Parse navigatePath to separate pathname from query string
+        const qIndex = navigatePath.indexOf('?');
+        if (qIndex >= 0) {
+            base.pathname = navigatePath.slice(0, qIndex);
+            base.search = navigatePath.slice(qIndex);
+        }
+        else {
+            base.pathname = navigatePath;
+            base.search = '';
+        }
+        return base.href;
+    }
+    catch {
+        return previewUrl;
+    }
+}
+/**
+ * Compute CSS scale factor to fit a viewport in a container.
+ * Returns 1 if the target fits, otherwise the smallest scale that fits both dimensions.
+ */
+/**
+ * Determines whether the proxy needs to be synced to the active scenario.
+ * Returns true only when activeScenarioId actually changes — NOT when
+ * allScenarios gets a new array reference from SSE revalidation.
+ */
+export function shouldSyncScenarioToProxy(activeScenarioId, lastSyncedId) {
+    if (!activeScenarioId)
+        return false;
+    return activeScenarioId !== lastSyncedId;
+}
+/**
+ * Resolve which scenario to display when no scenario is explicitly selected.
+ * Prefers the home page scenario (url "/") since the App tab sorts "Home"
+ * first, then falls back to the first application-type scenario, then any.
+ */
+export function getDefaultScenario(scenarios) {
+    if (scenarios.length === 0)
+        return undefined;
+    return (scenarios.find((s) => s.url === '/') ||
+        scenarios.find((s) => s.type === 'application') ||
+        scenarios[0]);
+}
+/**
+ * Resolve the viewport size for a scenario. If the scenario has custom
+ * dimensions, returns a ScreenSize (matching a preset name if possible,
+ * otherwise "Custom"). Returns null when the scenario has no custom viewport
+ * and no defaultSize fallback is provided.
+ *
+ * @param defaultSize - Optional fallback size when scenario has no viewport.
+ *   Pass the project default so null-viewport scenarios still resolve.
+ */
+export function resolveScenarioViewport(scenario, presets, defaultSize) {
+    if (!scenario.viewportWidth || !scenario.viewportHeight) {
+        return defaultSize ?? null;
+    }
+    const match = presets.find((p) => p.width === scenario.viewportWidth &&
+        p.height === scenario.viewportHeight);
+    return {
+        name: match?.name || 'Custom',
+        width: scenario.viewportWidth,
+        height: scenario.viewportHeight,
+    };
+}
+export function calculatePreviewScale(containerSize, targetSize) {
+    const targetW = targetSize.width;
+    const targetH = targetSize.height ?? 900;
+    const availW = containerSize.width;
+    const availH = containerSize.height;
+    if (targetW <= availW && targetH <= availH)
+        return 1;
+    return Math.min(availW / targetW, availH / targetH);
+}
+//# sourceMappingURL=editorPreview.js.map

package/codeyam-cli/src/utils/editorPreview.js.map

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

package/codeyam-cli/src/utils/editorRecapture.js

@@ -0,0 +1,109 @@
+/**
+ * Shared capture loop for recapturing scenarios.
+ *
+ * Extracted from api.editor-register-scenario.ts so both the inline
+ * recapture (after registration) and the batch `recapture-stale` endpoint
+ * can share the same logic.
+ */
+import * as path from 'path';
+import { switchActiveScenario } from "./editorScenarioSwitch.js";
+import { generateScenarioSlug, determineCaptureUrl, resolveViewportWithProjectDefault, } from "./editorScenarios.js";
+import { invalidateScenarioCache } from "../webserver/editorProxy.js";
+import { resolveWebserverDir, resolveCaptureScript, runCaptureScript, } from "./editorCapture.js";
+/**
+ * Recapture a list of scenarios by switching to each one and running
+ * the Playwright capture script.
+ *
+ * @param scenarios  - Scenario rows to recapture (need id, name, url, dimensions, viewport)
+ * @param codeyamRoot - Project root containing .codeyam/
+ * @param proxyUrl   - Proxy server URL (for intercepting API calls)
+ * @param devUrl     - Dev server URL (direct, for route checking)
+ * @param db         - Database instance for updating screenshot_path
+ * @param importMetaUrl - import.meta.url from the calling route (for resolving webserver dir)
+ * @param onProgress - Optional callback for streaming progress
+ */
+export async function recaptureScenarios(params) {
+    const { scenarios, codeyamRoot, proxyUrl, devUrl, db, importMetaUrl, onProgress, } = params;
+    const result = { recaptured: [], failed: [] };
+    if (scenarios.length === 0)
+        return result;
+    const webserverDir = resolveWebserverDir(importMetaUrl);
+    const scriptPath = await resolveCaptureScript(webserverDir, codeyamRoot);
+    const screenshotsDir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios', 'screenshots');
+    for (const row of scenarios) {
+        try {
+            const scenarioSlug = generateScenarioSlug(row.name);
+            await switchActiveScenario({
+                scenarioId: row.id,
+                scenarioSlug,
+                projectRoot: codeyamRoot,
+            });
+            invalidateScenarioCache();
+            await new Promise((resolve) => setTimeout(resolve, 300));
+            const captureUrl = determineCaptureUrl(row.url || null, proxyUrl, devUrl);
+            if (!captureUrl) {
+                result.failed.push({
+                    name: row.name,
+                    error: 'No capture URL available',
+                });
+                continue;
+            }
+            const outputPath = path.join(screenshotsDir, `${row.id}.png`);
+            // Resolve viewport from dimension or explicit values
+            let recaptureDimension;
+            try {
+                const dims = row.dimensions ? JSON.parse(row.dimensions) : null;
+                if (Array.isArray(dims) && dims.length > 0)
+                    recaptureDimension = dims[0];
+            }
+            catch {
+                /* ignore */
+            }
+            const viewport = resolveViewportWithProjectDefault({
+                bodyWidth: row.viewport_width || undefined,
+                bodyHeight: row.viewport_height || undefined,
+                dimension: recaptureDimension,
+                codeyamRoot,
+            });
+            const captureArgs = JSON.stringify({
+                url: captureUrl,
+                outputPath,
+                viewportWidth: viewport.width,
+                viewportHeight: viewport.height,
+                ...(row.component_name ? { selector: '#codeyam-capture' } : {}),
+            });
+            onProgress?.(`Capturing "${row.name}"...`);
+            console.log(`[recapture] Capturing "${row.name}" at ${viewport.width}x${viewport.height}`);
+            const captureResult = await runCaptureScript(scriptPath, captureArgs, codeyamRoot);
+            if (captureResult.success) {
+                await db
+                    .updateTable('editor_scenarios')
+                    .set({
+                    screenshot_path: `screenshots/${row.id}.png`,
+                    updated_at: new Date()
+                        .toISOString()
+                        .replace('T', ' ')
+                        .replace(/\.\d{3}Z$/, ''),
+                })
+                    .where('id', '=', row.id)
+                    .execute();
+                result.recaptured.push(row.name);
+                onProgress?.(`Recaptured "${row.name}"`);
+                console.log(`[recapture] Succeeded: "${row.name}"`);
+            }
+            else {
+                const error = captureResult.error || 'Unknown capture error';
+                result.failed.push({ name: row.name, error });
+                onProgress?.(`Failed: "${row.name}" — ${error}`);
+                console.warn(`[recapture] Failed: "${row.name}": ${error}`);
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            result.failed.push({ name: row.name, error });
+            console.warn(`[recapture] Error for "${row.name}": ${error}`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=editorRecapture.js.map

package/codeyam-cli/src/utils/editorRecapture.js.map

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