@codeyam/codeyam-cli 0.1.0-staging.483fdc2 → 0.1.0-staging.50df560

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

@@ -0,0 +1,137 @@
+/**
+ * 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 first application-type scenario (full page view), falls back
+ * to the first scenario of any type.
+ */
+export function getDefaultScenario(scenarios) {
+    if (scenarios.length === 0)
+        return undefined;
+    return 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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"}

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

@@ -0,0 +1,134 @@
+/**
+ * Shared scenario switching logic.
+ *
+ * Both `/api/dev-mode-preview` (Express, server.ts) and
+ * `/api/editor-switch-scenario` (React Router action) need to switch
+ * the active scenario. This module consolidates that logic so both
+ * code paths handle seed-based scenarios correctly.
+ */
+import fs from 'fs';
+import path from 'path';
+import { runSeedAdapter, detectSeedAdapter, } from "./editorSeedAdapter.js";
+/**
+ * Track in-flight seed operations to deduplicate concurrent requests
+ * for the same scenario.
+ */
+let activeSeedOperation = null;
+/**
+ * Switch the active editor scenario.
+ *
+ * 1. Resolves the scenario type from the data file if not provided
+ * 2. Writes `active-scenario.json` (including `type`)
+ * 3. Runs the seed adapter for application/user scenarios
+ * 4. Returns the result (caller is responsible for cache invalidation and refresh)
+ */
+export async function switchActiveScenario(params) {
+    const { scenarioId, projectRoot } = params;
+    const codeyamDir = path.join(projectRoot, '.codeyam');
+    const scenariosDir = path.join(codeyamDir, 'editor-scenarios');
+    // Resolve slug from data file if not provided
+    let effectiveSlug = params.scenarioSlug || null;
+    if (!effectiveSlug) {
+        try {
+            const dataFile = path.join(scenariosDir, `${scenarioId}.json`);
+            if (fs.existsSync(dataFile)) {
+                const data = JSON.parse(fs.readFileSync(dataFile, 'utf-8'));
+                effectiveSlug = data.name || scenarioId;
+            }
+            else {
+                effectiveSlug = scenarioId;
+            }
+        }
+        catch {
+            effectiveSlug = scenarioId;
+        }
+    }
+    // Resolve type: prefer explicit param, fall back to data file
+    let effectiveType = params.scenarioType || null;
+    if (!effectiveType) {
+        try {
+            const dataFile = path.join(scenariosDir, `${scenarioId}.json`);
+            if (fs.existsSync(dataFile)) {
+                const data = JSON.parse(fs.readFileSync(dataFile, 'utf-8'));
+                effectiveType = data.type || null;
+            }
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    // Write active-scenario.json — MUST include type so proxy is type-aware
+    const activeScenarioPath = path.join(codeyamDir, 'active-scenario.json');
+    fs.mkdirSync(codeyamDir, { recursive: true });
+    fs.writeFileSync(activeScenarioPath, JSON.stringify({
+        scenarioSlug: effectiveSlug,
+        scenarioName: params.scenarioName || effectiveSlug,
+        scenarioId,
+        type: effectiveType,
+        dataFile: `.codeyam/editor-scenarios/${scenarioId}.json`,
+        switchedAt: new Date().toISOString(),
+    }, null, 2));
+    // Run seed adapter for application/user scenarios
+    let seedResult = null;
+    let sessionCookies;
+    const isSeedScenario = effectiveType === 'application' || effectiveType === 'user';
+    if (isSeedScenario) {
+        // Deduplicate concurrent seed requests for the same scenario
+        if (activeSeedOperation && activeSeedOperation.scenarioId === scenarioId) {
+            seedResult = await activeSeedOperation.promise;
+        }
+        else {
+            const adapterPath = detectSeedAdapter(projectRoot);
+            const seedDataPath = path.join(scenariosDir, `${scenarioId}.seed.json`);
+            if (adapterPath && fs.existsSync(seedDataPath)) {
+                const seedPromise = runSeedAdapter(adapterPath, seedDataPath).then((result) => ({
+                    success: result.success,
+                    error: result.error,
+                    sessionCookies: result.sessionCookies,
+                }));
+                activeSeedOperation = { scenarioId, promise: seedPromise };
+                try {
+                    const fullResult = await seedPromise;
+                    seedResult = {
+                        success: fullResult.success,
+                        error: fullResult.error,
+                    };
+                    sessionCookies = fullResult.sessionCookies;
+                }
+                finally {
+                    if (activeSeedOperation &&
+                        activeSeedOperation.scenarioId === scenarioId) {
+                        activeSeedOperation = null;
+                    }
+                }
+                // Persist session cookies to the scenario data file
+                if (seedResult?.success &&
+                    sessionCookies &&
+                    sessionCookies.length > 0) {
+                    try {
+                        const dataFile = path.join(scenariosDir, `${scenarioId}.json`);
+                        const existing = JSON.parse(fs.readFileSync(dataFile, 'utf-8'));
+                        existing.sessionCookies = sessionCookies;
+                        fs.writeFileSync(dataFile, JSON.stringify(existing, null, 2));
+                    }
+                    catch {
+                        // Non-fatal — cookies just won't be persisted
+                    }
+                }
+            }
+            else if (!adapterPath) {
+                seedResult = { success: false, error: 'No seed adapter found' };
+            }
+        }
+    }
+    return {
+        success: true,
+        scenarioSlug: effectiveSlug,
+        scenarioId,
+        type: effectiveType,
+        seeded: isSeedScenario,
+        ...(seedResult ? { seedResult } : {}),
+        ...(sessionCookies && sessionCookies.length > 0 ? { sessionCookies } : {}),
+    };
+}
+//# sourceMappingURL=editorScenarioSwitch.js.map

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

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