fimo 0.8.0 → 0.9.0-experimental.10

package/assets/skills/fimo-studio/SKILL.md

@@ -6,9 +6,9 @@ description: >-
   Triggers: "in Fimo Studio", "in the dashboard", "in the web app",
   "how do I X in the UI", or screenshots of the dashboard. Topics
   covered: dashboard content and CMS, publishing from the dashboard,
-  dashboard SEO/domain settings, visual editing, version history UI,
-  dashboard sharing/billing, and dashboard chat. Never describe UI
-  locations, buttons, or panels from memory — always read the relevant
+  dashboard SEO/domain settings, outbound webhooks, visual editing, version
+  history UI, dashboard sharing/billing, and dashboard chat. Never describe
+  UI locations, buttons, or panels from memory — always read the relevant
   reference file first.
 ---
 
@@ -37,6 +37,7 @@ Read the relevant reference file when the user's question matches a topic.
 | AI Chat                  | references/ai-chat.md                   | "What can the AI do?", "How do I give context?"       |
 | Code Editor              | references/code-editor.md               | "How do I edit code?", "Where are my files?"          |
 | SEO Settings             | references/seo-settings.md              | "How do I set up SEO?", "Favicon, title, share image" |
+| Webhooks                 | references/webhooks.md                  | "React to forms", "Send events to another service"    |
 | Preview & Responsive     | references/preview-and-responsive.md    | "How does it look on mobile?", "How do I test sizes?" |
 | Visual Editing           | references/visual-editing.md            | "Can I edit visually?", "How do I change colors?"     |
 | Version History          | references/version-history.md           | "How do I undo?", "How do I go back?"                 |
@@ -53,6 +54,7 @@ Read the relevant reference file when the user's question matches a topic.
 | Custom domains          | Publishing (must publish first), Billing (premium required)                    |
 | Adding images           | Media Library, AI Chat, Edit Mode                                              |
 | Content/CMS             | AI Chat, Media Library                                                         |
+| Webhooks                | Project secrets, Forms, Publishing, Agents                                     |
 | Visual changes          | Edit Mode (quick tweaks), AI Chat (bigger changes), Code Editor (full control) |
 | Something went wrong    | Version History, AI Chat                                                       |
 | Working with others     | Sharing, Collaboration                                                         |

package/assets/skills/fimo-studio/references/cms.md

@@ -42,7 +42,7 @@ When you open a Collection, the entry list provides several tools:
 2. Click the **+** (plus) icon button at the top of the Collection (labeled **New entry** on hover). If the Collection is empty, use the **Create entry** button in the center of the empty state instead.
 3. Fill in the form fields (text, images, dates, whatever the collection defines).
 
-Changes save automatically as you fill in each field (the save is debounced), so there is no Save button. The save status appears in the top bar (Saving / Saved). The entry is now part of your Collection. If the Collection is wired to a page on your site, the new content shows up automatically.
+Changes save automatically as you fill in each field (the save is debounced), so there is no Save button. The save status appears in the top bar (Saving / Saved). An incomplete new entry waits until its required fields are valid before it becomes part of the Collection. If the Collection is wired to a page on your site, new content shows up automatically.
 
 ## Editing an Entry
 
@@ -51,6 +51,14 @@ Changes save automatically as you fill in each field (the save is debounced), so
 
 Your edits save automatically as you change each field (the save is debounced), so there is no Save button. Watch the top bar for the save status (Saving / Saved). The entry editor's only header actions are delete (trash icon) and copy link.
 
+If a field is invalid, the editor keeps the change unsaved and pins a status bar below the header. Choose **Review issues** to jump to the first invalid field, then **Next issue** to move through the remaining fields. Collapsed blocks open automatically. Once every issue is fixed, the editor confirms that all fields are valid and resumes saving.
+
+## Editing Text
+
+- Short text such as titles, names, and slugs uses one compact line.
+- Plain multiline text such as summaries and descriptions starts taller and grows as you write.
+- Formatted content uses the rich-text editor for headings, links, lists, and media.
+
 ## Bulk Operations
 
 Need to update or remove several entries at once?

package/assets/skills/fimo-studio/references/visual-editing.md

@@ -12,7 +12,9 @@ For text elements, the side panel shows editable fields where you can change the
 
 ### Editing Styles
 
-The side panel organizes style controls into these categories:
+Style controls are only available on projects created before July 2026. Newer projects edit styles through the AI chat instead (for example: "make the hero title larger and dark blue"). If the user does not see the style controls described below, their project is a newer one -- point them to the chat.
+
+On projects that have them, the side panel organizes style controls into these categories:
 
 - **Typography** -- Font family, font size, font weight, line height, letter spacing, text alignment, and bold/italic/underline/strikethrough toggles.
 - **Color** -- Text and foreground colors.
@@ -31,5 +33,5 @@ Click the **Edit mode** toggle again or close the side panel. The side editor cl
 
 ## When to Use Edit Mode vs. Chat
 
-- **Edit mode** is best for quick visual tweaks -- changing a color, adjusting spacing, updating text, or trying a different font.
-- **Chat** is better for bigger changes -- adding new sections, restructuring a page layout, or building new functionality.
+- **Edit mode** is best for content changes -- updating text (including bold, italic, underline, and links), and replacing images. On older projects it also covers quick style tweaks like colors and spacing.
+- **Chat** is better for style and structural changes -- changing colors or spacing (on newer projects), adding new sections, restructuring a page layout, or building new functionality.

package/assets/skills/fimo-studio/references/webhooks.md

@@ -0,0 +1,42 @@
+# Webhooks
+
+> **Beta:** Test each destination and review its delivery history before depending on it in production.
+
+Webhooks send project activity to an external HTTPS endpoint. Use them for focused reactions such as adding a waitlist submission to an email tool, notifying Slack after a publish, or starting a GitHub workflow after an agent review.
+
+Only project members with Full Access can see Webhooks in Settings or manage its destinations and delivery history.
+
+## Create one
+
+1. Open the project and choose **Settings**.
+2. Select **Webhooks**.
+3. Choose **New webhook**.
+4. Name it, select one event, and enter the destination URL.
+5. Optionally narrow form, agent, media, or entry events with the filter shown for that event.
+6. Review the request and select **Save**.
+
+The event groups are Entries, Forms, Publish, Agents, Analytics, and Media. Webhooks belong to the project, with up to 20 configurations. They listen to main by default or can include every environment.
+
+Entry webhooks show **Combine rapid changes**. The default waits 5 seconds after direct editing stops and sends one delivery with the combined changes. Immediate, 30-second, and 1-minute windows are also available. Bulk edits and environment merges already produce batches and send immediately.
+
+## Configure the request
+
+The default payload is the complete Fimo event, including its type, project, environment, timestamp, and event-specific data. Keep this when the destination can accept it.
+
+Choose **Custom template** when a service expects a specific JSON shape. Use **Insert variable** to pick fields for the selected event. Variables use paths such as `{{ event.data.submission.data.email }}`. The preview catches invalid JSON and missing variables before save.
+
+When Studio recognizes a Resend, Slack, or GitHub URL, it offers a request setup for that service. The suggestion never changes the request automatically. Accept it to prefill relevant headers and JSON, then review every field.
+
+## Add authentication
+
+Under **Headers**, add a header name and choose its value type. Prefer a project secret for API keys and tokens; choose whether the destination needs the raw secret, a `Bearer ` prefix, or a `token ` prefix. Fixed values are suitable only for non-sensitive headers.
+
+Fimo signs requests by default. Save the signing secret shown after creation so a custom receiver can verify `X-Fimo-Signature`. Rotate it from the webhook configuration if it is exposed.
+
+## Test and monitor
+
+Use **Send test** before depending on a workflow. Tests use documented sample data and travel through the same delivery path as real events.
+
+Open **Deliveries** to see the event ID, masked destination, request metadata and payload excerpt, queue message ID, status, HTTP response, duration, and individual attempts. Fimo automatically retries temporary failures. After all automatic retries are exhausted, open the failed delivery and choose **Retry now**. A delivery accepts up to five manual retries.
+
+Destination credentials are masked in configuration and delivery details. A successful test means the destination returned a successful HTTP response; it does not necessarily mean the provider completed its downstream action, so check the provider when that distinction matters.

package/dist/build/vite/plugins/translations.d.ts

@@ -1,11 +1,5 @@
 import type { Plugin } from 'vite';
-interface LabelBundle {
-    dictionaries: Record<string, Record<string, string>>;
-    defaultLocale: string;
-    locales: string[];
-    updatedAt: string | null;
-}
+import { loadLabelBundle } from '../../../runtime/shared/labels-fetch.server.js';
 export default function translationsPlugin(): Plugin;
-export declare function loadLabelBundle(rootDir: string): Promise<LabelBundle>;
-export {};
+export { loadLabelBundle };
 //# sourceMappingURL=translations.d.ts.map

package/dist/build/vite/plugins/translations.js

@@ -1,10 +1,8 @@
 import { createHash } from 'node:crypto';
-import { Buffer } from 'node:buffer';
 import { readFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
-import { getFimoDefaultLocale, getFimoLocales } from '../../../runtime/i18n/locale.js';
-import { getConfigServer } from '../../../runtime/shared/fimo-config.server.js';
+import { emptyLabelBundle, labelSignature, loadLabelBundle, readProjectEnv, resolveTenantApiUrl, serializeBundle, } from '../../../runtime/shared/labels-fetch.server.js';
 const VIRTUAL_ID = 'virtual:translations';
 const RESOLVED_ID = '\0' + VIRTUAL_ID;
 export default function translationsPlugin() {
@@ -16,6 +14,12 @@ export default function translationsPlugin() {
     let reconnectTimer;
     let refreshTimer;
     let pollTimer;
+    // Set on closeBundle. Without it, closing a socket fires its own onclose,
+    // which schedules a reconnect AFTER the cleanup ran — resurrecting the
+    // event sockets forever and pinning the event loop. That is exactly how a
+    // prerender script using `createServer({ middlewareMode: true })` finished
+    // its work and then never exited.
+    let disposed = false;
     const refreshLabels = async () => {
         bundle = await loadLabelBundle(rootDir);
         return bundle;
@@ -51,6 +55,9 @@ export default function translationsPlugin() {
         });
     };
     const scheduleRefresh = () => {
+        if (disposed) {
+            return;
+        }
         if (refreshTimer) {
             clearTimeout(refreshTimer);
         }
@@ -58,6 +65,17 @@ export default function translationsPlugin() {
             void refreshLabelsAndInvalidateIfChanged().catch(() => undefined);
         }, 150);
     };
+    const adoptEventSockets = (sockets) => {
+        if (disposed) {
+            // The server closed while the async connect was in flight — sockets
+            // landing now must close immediately or they outlive the cleanup.
+            for (const socket of sockets) {
+                socket.close();
+            }
+            return;
+        }
+        eventSockets = sockets;
+    };
     return {
         name: 'fimo-virtual-translations',
         enforce: 'pre',
@@ -78,11 +96,7 @@ export default function translationsPlugin() {
             devServer = server;
             server.watcher.add([join(rootDir, 'fimo-config.json'), join(rootDir, '.env'), join(rootDir, '.env.local')]);
             void refreshLabelsAndInvalidateIfChanged().catch(() => undefined);
-            connectLabelEvents(rootDir, scheduleRefresh)
-                .then((sockets) => {
-                eventSockets = sockets;
-            })
-                .catch(() => undefined);
+            connectLabelEvents(rootDir, scheduleRefresh).then(adoptEventSockets).catch(() => undefined);
             pollTimer = setInterval(() => {
                 void refreshLabelsAndInvalidateIfChanged().catch(() => undefined);
             }, 2000);
@@ -128,6 +142,9 @@ export default function translationsPlugin() {
             return [];
         },
         closeBundle() {
+            // Order matters: dispose FIRST so the onclose handlers fired by the
+            // socket closes below (and any in-flight connect) cannot reschedule.
+            disposed = true;
             for (const socket of eventSockets) {
                 socket.close();
             }
@@ -145,7 +162,7 @@ export default function translationsPlugin() {
     };
     async function connectLabelEvents(root, onLabelsChanged) {
         const env = await readProjectEnv(root);
-        const apiUrl = env.VITE_API_URL;
+        const apiUrl = resolveTenantApiUrl(env);
         if (!apiUrl) {
             return [];
         }
@@ -194,12 +211,11 @@ export default function translationsPlugin() {
                 }
             };
             socket.onclose = () => {
+                if (disposed) {
+                    return;
+                }
                 reconnectTimer = setTimeout(() => {
-                    void connectLabelEvents(root, onLabelsChanged)
-                        .then((nextSockets) => {
-                        eventSockets = nextSockets;
-                    })
-                        .catch(() => undefined);
+                    void connectLabelEvents(root, onLabelsChanged).then(adoptEventSockets).catch(() => undefined);
                 }, 2000);
             };
             socket.onerror = () => undefined;
@@ -229,24 +245,6 @@ function parseContentChangePayload(payload) {
         updatedAt: typeof source.updatedAt === 'string' ? source.updatedAt : undefined,
     };
 }
-function serializeBundle(bundle) {
-    return JSON.stringify({
-        dictionaries: bundle.dictionaries,
-        defaultLocale: bundle.defaultLocale,
-        locales: bundle.locales,
-    });
-}
-function emptyLabelBundle(rootDir) {
-    const config = getConfigServer(rootDir);
-    const defaultLocale = getFimoDefaultLocale(config);
-    const locales = getFimoLocales(config);
-    return {
-        dictionaries: Object.fromEntries(locales.map((locale) => [locale, {}])),
-        defaultLocale,
-        locales,
-        updatedAt: null,
-    };
-}
 function findVirtualTranslationModules(server) {
     const direct = server.moduleGraph.getModuleById(RESOLVED_ID);
     const matches = new Set(direct ? [direct] : []);
@@ -257,73 +255,13 @@ function findVirtualTranslationModules(server) {
     }
     return [...matches];
 }
-function labelSignature(bundle) {
-    return Buffer.from(serializeBundle(bundle)).toString('base64');
-}
 function labelUpdatePayload(bundle) {
     return {
         ...bundle,
         signature: labelSignature(bundle),
     };
 }
-export async function loadLabelBundle(rootDir) {
-    const config = getConfigServer(rootDir);
-    const defaultLocale = getFimoDefaultLocale(config);
-    const locales = getFimoLocales(config);
-    const env = await readProjectEnv(rootDir);
-    const apiUrl = env.VITE_API_URL;
-    if (!apiUrl) {
-        return {
-            dictionaries: Object.fromEntries(locales.map((locale) => [locale, {}])),
-            defaultLocale,
-            locales,
-            updatedAt: null,
-        };
-    }
-    try {
-        const loaded = await Promise.all(locales.map((locale) => fetchLabelDictionary(apiUrl, locale).catch(() => ({ locale, labels: {}, updatedAt: null }))));
-        const updatedAt = loaded
-            .map((entry) => entry.updatedAt)
-            .filter((value) => typeof value === 'string')
-            .sort()
-            .at(-1);
-        return {
-            dictionaries: Object.fromEntries(loaded.map((entry) => [entry.locale, entry.labels])),
-            defaultLocale,
-            locales,
-            updatedAt: updatedAt ?? null,
-        };
-    }
-    catch {
-        return {
-            dictionaries: Object.fromEntries(locales.map((locale) => [locale, {}])),
-            defaultLocale,
-            locales,
-            updatedAt: null,
-        };
-    }
-}
-async function fetchLabelDictionary(apiUrl, locale) {
-    const url = new URL('/labels', apiUrl);
-    url.searchParams.set('locale', locale);
-    const response = await fetchWithTimeout(url, 4000);
-    if (!response.ok) {
-        return { locale, labels: {}, updatedAt: null };
-    }
-    const body = (await response.json());
-    if (Array.isArray(body.data)) {
-        return {
-            locale,
-            labels: Object.fromEntries(body.data.map((row) => [row.key, row.value ?? row.defaultValue ?? ''])),
-            updatedAt: null,
-        };
-    }
-    return {
-        locale,
-        labels: body.data?.labels ?? {},
-        updatedAt: body.data?.updatedAt ?? null,
-    };
-}
+export { loadLabelBundle };
 async function loadRuntimeConfig(apiUrl) {
     try {
         const response = await fetchWithTimeout(new URL('/runtime-config', apiUrl), 2000);
@@ -358,44 +296,6 @@ async function fetchWithTimeout(url, timeoutMs) {
         clearTimeout(timeout);
     }
 }
-async function readProjectEnv(rootDir) {
-    const values = {
-        ...(await readEnvFile(join(rootDir, '.env'))),
-        ...(await readEnvFile(join(rootDir, '.env.local'))),
-    };
-    for (const key of ['VITE_API_URL']) {
-        if (process.env[key]) {
-            values[key] = process.env[key];
-        }
-    }
-    return values;
-}
-async function readEnvFile(filePath) {
-    try {
-        const content = await readFile(filePath, 'utf8');
-        const values = {};
-        for (const line of content.split(/\r?\n/)) {
-            const trimmed = line.trim();
-            if (!trimmed || trimmed.startsWith('#')) {
-                continue;
-            }
-            const index = trimmed.indexOf('=');
-            if (index === -1) {
-                continue;
-            }
-            const key = trimmed.slice(0, index).trim();
-            const value = trimmed
-                .slice(index + 1)
-                .trim()
-                .replace(/^['"]|['"]$/g, '');
-            values[key] = value;
-        }
-        return values;
-    }
-    catch {
-        return {};
-    }
-}
 async function readProjectSettings(rootDir) {
     try {
         const raw = await readFile(join(rootDir, '.fimo.settings.json'), 'utf8');

package/dist/cli/bundle.json

@@ -1,7 +1,7 @@
 {
   "bundled": true,
   "bundler": "esbuild",
-  "bundledAt": "2026-07-23T08:29:03.159Z",
+  "bundledAt": "2026-07-29T15:37:14.073Z",
   "cliVersion": "0.8.0",
   "external": [
     "oxc-parser",