@inlang/sdk 0.34.1 → 0.34.3

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D,qBAAa,0BAA2B,SAAQ,KAAK;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;CAI1D;AAED,qBAAa,2BAA4B,SAAQ,KAAK;gBACzC,OAAO,EAAE;QAAE,MAAM,EAAE,UAAU,EAAE,CAAA;KAAE;CAU7C;AAED,qBAAa,kCAAmC,SAAQ,KAAK;gBAChD,OAAO,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CAOnE;AAED,qBAAa,gCAAiC,SAAQ,KAAK;gBAC9C,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CAIpE;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACrC,OAAO,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;KAAE;CAIrD;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACrC,OAAO,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;KAAE;CAIrD;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC9B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;KAAE;CAOtF;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC9B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;KAAE;CAOtF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D,qBAAa,0BAA2B,SAAQ,KAAK;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;CAI1D;AAED,qBAAa,2BAA4B,SAAQ,KAAK;gBACzC,OAAO,EAAE;QAAE,MAAM,EAAE,UAAU,EAAE,CAAA;KAAE;CAW7C;AAYD,qBAAa,kCAAmC,SAAQ,KAAK;gBAChD,OAAO,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CAOnE;AAED,qBAAa,gCAAiC,SAAQ,KAAK;gBAC9C,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CAIpE;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACrC,OAAO,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;KAAE;CAIrD;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACrC,OAAO,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;KAAE;CAIrD;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC9B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;KAAE;CAOtF;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC9B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;KAAE;CAOtF"}

package/dist/errors.js

@@ -7,13 +7,23 @@ export class LoadProjectInvalidArgument extends Error {
 export class ProjectSettingsInvalidError extends Error {
     constructor(options) {
         // TODO: beatufiy ValueErrors
-        super(`The project settings are invalid:\n\n${options.errors
+        super(`The project settings are invalid:
+${options.errors
             .filter((error) => error.path)
-            .map((error) => `"${error.path}":\n\n${error.message}`)
+            .map(FormatProjectSettingsError)
             .join("\n")}`);
         this.name = "ProjectSettingsInvalidError";
     }
 }
+function FormatProjectSettingsError(error) {
+    let msg = `${error.message} at ${error.path}`;
+    if (error.path.startsWith("/modules/")) {
+        msg += `
+value = "${error.value}"
+- ${error.schema.allOf.map((o) => `${o.description ?? ""}`).join("\n- ")}`;
+    }
+    return msg;
+}
 export class ProjectSettingsFileJSONSyntaxError extends Error {
     constructor(options) {
         super(`The settings file at "${options.path}" is not a valid JSON file:\n\n${options.cause}`, options);

package/dist/loadProject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadProject.d.ts","sourceRoot":"","sources":["../src/loadProject.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,aAAa,EAGb,YAAY,EACZ,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,4BAA4B,CAAA;AAwBhF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAiChD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,cAAc,CAAA;CACxB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2XzB;AAsHD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAQtE"}
+{"version":3,"file":"loadProject.d.ts","sourceRoot":"","sources":["../src/loadProject.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,aAAa,EAGb,YAAY,EACZ,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,4BAA4B,CAAA;AAwBhF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAmChD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,cAAc,CAAA;CACxB,GAAG,OAAO,CAAC,aAAa,CAAC,CAuXzB;AAsHD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAQtE"}

package/dist/loadProject.js

@@ -45,6 +45,7 @@ export async function loadProject(args) {
     // won't even be loaded. do not throw anywhere else. otherwise, apps
     // can't handle errors gracefully.
     assertValidProjectPath(projectPath);
+    debug(projectPath);
     const nodeishFs = createNodeishFsWithAbsolutePaths({
         projectPath,
         nodeishFs: args.repo.nodeishFs,
@@ -79,6 +80,11 @@ export async function loadProject(args) {
         const setSettings = (settings) => {
             try {
                 const validatedSettings = parseSettings(settings);
+                if (validatedSettings.experimental?.persistence) {
+                    settings["plugin.sdk.persistence"] = {
+                        pathPattern: projectPath + "/messages.json",
+                    };
+                }
                 _setSettings(validatedSettings);
                 writeSettingsToDisk(validatedSettings);
                 return { data: undefined };
@@ -118,15 +124,14 @@ export async function loadProject(args) {
             const _resolvedModules = resolvedModules();
             if (!_resolvedModules)
                 return;
-            if (!_resolvedModules.resolvedPluginApi.loadMessages) {
+            const resolvedPluginApi = _resolvedModules.resolvedPluginApi;
+            if (!resolvedPluginApi.loadMessages) {
                 markInitAsFailed(undefined);
                 return;
             }
             const _settings = settings();
             if (!_settings)
                 return;
-            // get plugin finding the plugin that provides loadMessages function
-            const loadMessagePlugin = _resolvedModules.plugins.find((plugin) => plugin.loadMessages !== undefined);
             // TODO #1844 this watcher needs to get pruned when we have a change in the configs which will trigger this again
             const fsWithWatcher = createNodeishFsWithWatcher({
                 nodeishFs: nodeishFs,
@@ -136,7 +141,7 @@ export async function loadProject(args) {
                     // preserving console.logs as comments pending #
                     debug("load messages because of a change in the message.json files");
                     loadMessagesViaPlugin(fsWithWatcher, messageLockDirPath, messageStates, messagesQuery, settings(), // NOTE we bang here - we don't expect the settings to become null during the livetime of a project
-                    loadMessagePlugin)
+                    resolvedPluginApi)
                         .catch((e) => setLoadMessagesViaPluginError(new PluginLoadMessagesError({ cause: e })))
                         .then(() => {
                         if (loadMessagesViaPluginError() !== undefined) {
@@ -145,7 +150,7 @@ export async function loadProject(args) {
                     });
                 },
             });
-            loadMessagesViaPlugin(fsWithWatcher, messageLockDirPath, messageStates, messagesQuery, _settings, loadMessagePlugin)
+            loadMessagesViaPlugin(fsWithWatcher, messageLockDirPath, messageStates, messagesQuery, _settings, resolvedPluginApi)
                 .then(() => {
                 markInitAsComplete();
             })
@@ -193,10 +198,9 @@ export async function loadProject(args) {
             const _resolvedModules = resolvedModules();
             if (!_resolvedModules)
                 return;
+            const resolvedPluginApi = _resolvedModules.resolvedPluginApi;
             const currentMessageIds = new Set(messagesQuery.includedMessageIds());
             const deletedTrackedMessages = [...trackedMessages].filter((tracked) => !currentMessageIds.has(tracked[0]));
-            const saveMessagesPlugin = _resolvedModules.plugins.find((plugin) => plugin.saveMessages !== undefined);
-            const loadMessagesPlugin = _resolvedModules.plugins.find((plugin) => plugin.loadMessages !== undefined);
             for (const messageId of currentMessageIds) {
                 if (!trackedMessages.has(messageId)) {
                     // we create a new root to be able to cleanup an effect for a message that got deleted
@@ -213,8 +217,9 @@ export async function loadProject(args) {
                             }
                             // don't trigger saves or set dirty flags during initial setup
                             if (!initialSetup) {
+                                debug("message changed", messageId);
                                 messageStates.messageDirtyFlags[message.id] = true;
-                                saveMessagesViaPlugin(nodeishFs, messageLockDirPath, messageStates, messagesQuery, settings(), saveMessagesPlugin, loadMessagesPlugin)
+                                saveMessagesViaPlugin(nodeishFs, messageLockDirPath, messageStates, messagesQuery, settings(), resolvedPluginApi)
                                     .catch((e) => setSaveMessagesViaPluginError(new PluginSaveMessagesError({ cause: e })))
                                     .then(() => {
                                     if (saveMessagesViaPluginError() !== undefined) {
@@ -239,7 +244,7 @@ export async function loadProject(args) {
             }
             if (deletedTrackedMessages.length > 0) {
                 // we keep track of the latest save within the loadProject call to await it at the end - this is not used in subsequetial upserts
-                saveMessagesViaPlugin(nodeishFs, messageLockDirPath, messageStates, messagesQuery, settings(), saveMessagesPlugin, loadMessagesPlugin)
+                saveMessagesViaPlugin(nodeishFs, messageLockDirPath, messageStates, messagesQuery, settings(), resolvedPluginApi)
                     .catch((e) => setSaveMessagesViaPluginError(new PluginSaveMessagesError({ cause: e })))
                     .then(() => {
                     if (saveMessagesViaPluginError() !== undefined) {
@@ -408,7 +413,7 @@ export function createSubscribable(signal) {
  * @param loadPlugin
  * @returns void - updates the files and messages in of the project in place
  */
-async function loadMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuery, settingsValue, loadPlugin) {
+async function loadMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuery, settingsValue, resolvedPluginApi) {
     const experimentalAliases = !!settingsValue.experimental?.aliases;
     // loading is an asynchronous process - check if another load is in progress - queue this call if so
     if (messageState.isLoading) {
@@ -423,7 +428,7 @@ async function loadMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuer
     let lockTime = undefined;
     try {
         lockTime = await acquireFileLock(fs, lockDirPath, "loadMessage");
-        const loadedMessages = await makeTrulyAsync(loadPlugin.loadMessages({
+        const loadedMessages = await makeTrulyAsync(resolvedPluginApi.loadMessages({
             settings: settingsValue,
             nodeishFs: fs,
         }));
@@ -506,7 +511,7 @@ async function loadMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuer
         // reset sheduling to except scheduling again
         messageState.sheduledLoadMessagesViaPlugin = undefined;
         // recall load unawaited to allow stack to pop
-        loadMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuery, settingsValue, loadPlugin)
+        loadMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuery, settingsValue, resolvedPluginApi)
             .then(() => {
             // resolve the scheduled load message promise
             executingScheduledMessages[1]();
@@ -517,7 +522,7 @@ async function loadMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuer
         });
     }
 }
-async function saveMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuery, settingsValue, savePlugin, loadPlugin) {
+async function saveMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuery, settingsValue, resolvedPluginApi) {
     // queue next save if we have a save ongoing
     if (messageState.isSaving) {
         if (!messageState.sheduledSaveMessages) {
@@ -566,7 +571,7 @@ async function saveMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuer
             messageDirtyFlagsBeforeSave = { ...messageState.messageDirtyFlags };
             messageState.messageDirtyFlags = {};
             // NOTE: this assumes that the plugin will handle message ordering
-            await savePlugin.saveMessages({
+            await resolvedPluginApi.saveMessages({
                 settings: settingsValue,
                 messages: messagesToExport,
                 nodeishFs: fs,
@@ -581,7 +586,7 @@ async function saveMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuer
             // if there is a queued load, allow it to take the lock before we run additional saves.
             if (messageState.sheduledLoadMessagesViaPlugin) {
                 debug("saveMessagesViaPlugin calling queued loadMessagesViaPlugin to share lock");
-                await loadMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuery, settingsValue, loadPlugin);
+                await loadMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuery, settingsValue, resolvedPluginApi);
             }
             messageState.isSaving = false;
         }
@@ -614,7 +619,7 @@ async function saveMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuer
     if (messageState.sheduledSaveMessages) {
         const executingSheduledSaveMessages = messageState.sheduledSaveMessages;
         messageState.sheduledSaveMessages = undefined;
-        saveMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuery, settingsValue, savePlugin, loadPlugin)
+        saveMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuery, settingsValue, resolvedPluginApi)
             .then(() => {
             executingSheduledSaveMessages[1]();
         })

package/dist/persistence/plugin.d.ts

@@ -0,0 +1,31 @@
+import type { ProjectSettings, Message } from "@inlang/sdk";
+import { type NodeishFilesystem } from "@lix-js/fs";
+export declare const pluginId = "plugin.sdk.persistence";
+export declare function loadMessages(args: {
+    settings: ProjectSettings;
+    nodeishFs: NodeishFilesystem;
+}): Promise<{
+    id: string;
+    alias: Record<string, string>;
+    selectors: {
+        type: "VariableReference";
+        name: string;
+    }[];
+    variants: {
+        languageTag: string;
+        match: string[];
+        pattern: ({
+            type: "Text";
+            value: string;
+        } | {
+            type: "VariableReference";
+            name: string;
+        })[];
+    }[];
+}[]>;
+export declare function saveMessages(args: {
+    settings: ProjectSettings;
+    nodeishFs: NodeishFilesystem;
+    messages: Message[];
+}): Promise<void>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/persistence/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/persistence/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAM/D,eAAO,MAAM,QAAQ,2BAA2B,CAAA;AAEhD,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACxC,QAAQ,EAAE,eAAe,CAAA;IACzB,SAAS,EAAE,iBAAiB,CAAA;CAC5B;;;;;;;;;;;;;;;;;;KAeA;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACxC,QAAQ,EAAE,eAAe,CAAA;IACzB,SAAS,EAAE,iBAAiB,CAAA;IAC5B,QAAQ,EAAE,OAAO,EAAE,CAAA;CACnB,iBAcA"}

package/dist/persistence/plugin.js

@@ -0,0 +1,42 @@
+import { getDirname } from "@lix-js/fs";
+import { normalizeMessage } from "../storage/helper.js";
+import _debug from "debug";
+const debug = _debug("sdk:persistence");
+export const pluginId = "plugin.sdk.persistence";
+export async function loadMessages(args) {
+    let result = [];
+    const pathPattern = args.settings[pluginId]?.pathPattern;
+    debug("loadMessages", pathPattern);
+    try {
+        const file = await args.nodeishFs.readFile(pathPattern, { encoding: "utf-8" });
+        result = JSON.parse(file);
+    }
+    catch (error) {
+        if (error?.code !== "ENOENT") {
+            debug("loadMessages", error);
+            throw error;
+        }
+    }
+    return result;
+}
+export async function saveMessages(args) {
+    const pathPattern = args.settings[pluginId]?.pathPattern;
+    debug("saveMessages", pathPattern);
+    try {
+        await createDirectoryIfNotExits(getDirname(pathPattern), args.nodeishFs);
+        await args.nodeishFs.writeFile(pathPattern, 
+        // 2 spaces indentation
+        JSON.stringify(args.messages.map(normalizeMessage), undefined, 2));
+    }
+    catch (error) {
+        debug("saveMessages", error);
+    }
+}
+async function createDirectoryIfNotExits(path, nodeishFs) {
+    try {
+        await nodeishFs.mkdir(path, { recursive: true });
+    }
+    catch {
+        // assume that the directory already exists
+    }
+}

package/dist/persistence/plugin.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.test.d.ts.map

package/dist/persistence/plugin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.test.d.ts","sourceRoot":"","sources":["../../src/persistence/plugin.test.ts"],"names":[],"mappings":""}

package/dist/persistence/plugin.test.js

@@ -0,0 +1,49 @@
+import { test, expect } from "vitest";
+import { createMessage, createNodeishMemoryFs } from "../test-utilities/index.js";
+import { normalizeMessage } from "../storage/helper.js";
+import { pluginId } from "./plugin.js";
+const mockMessages = [
+    createMessage("first_message", {
+        en: "If this fails I will be sad",
+    }),
+    createMessage("second_message", {
+        en: "Let's see if this works",
+        de: "Mal sehen ob das funktioniert",
+    }),
+];
+// the test ensures:
+//   - messages can be loaded
+//   - messages can be saved
+//   - after loading and saving messages, the state is the same as before (roundtrip)
+test("roundtrip (saving/loading messages)", async () => {
+    const { loadMessages, saveMessages } = await import("./plugin.js");
+    const fs = createNodeishMemoryFs();
+    const projectDir = "/test/project.inlang";
+    const pathPattern = projectDir + "/messages.json";
+    const persistedMessages = JSON.stringify(mockMessages.map(normalizeMessage), undefined, 2);
+    const settings = {
+        sourceLanguageTag: "en",
+        languageTags: ["en", "de"],
+        modules: [],
+        [pluginId]: { pathPattern },
+    };
+    await fs.mkdir(projectDir, { recursive: true });
+    await fs.writeFile(pathPattern, persistedMessages);
+    const firstMessageLoad = await loadMessages({
+        settings,
+        nodeishFs: fs,
+    });
+    expect(firstMessageLoad).toStrictEqual(mockMessages);
+    await saveMessages({
+        settings,
+        nodeishFs: fs,
+        messages: firstMessageLoad,
+    });
+    const afterRoundtrip = await fs.readFile(pathPattern, { encoding: "utf-8" });
+    expect(afterRoundtrip).toStrictEqual(persistedMessages);
+    const messagesAfterRoundtrip = await loadMessages({
+        settings,
+        nodeishFs: fs,
+    });
+    expect(messagesAfterRoundtrip).toStrictEqual(firstMessageLoad);
+});

package/dist/resolve-modules/plugins/resolvePlugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolvePlugins.d.ts","sourceRoot":"","sources":["../../../src/resolve-modules/plugins/resolvePlugins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAiBxD,eAAO,MAAM,cAAc,EAAE,sBA4G5B,CAAA"}
+{"version":3,"file":"resolvePlugins.d.ts","sourceRoot":"","sources":["../../../src/resolve-modules/plugins/resolvePlugins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAwBxD,eAAO,MAAM,cAAc,EAAE,sBAgH5B,CAAA"}

package/dist/resolve-modules/plugins/resolvePlugins.js

@@ -1,8 +1,11 @@
 import { Plugin } from "@inlang/plugin";
+import { loadMessages as sdkLoadMessages, saveMessages as sdkSaveMessages, } from "../../persistence/plugin.js";
 import { PluginReturnedInvalidCustomApiError, PluginLoadMessagesFunctionAlreadyDefinedError, PluginSaveMessagesFunctionAlreadyDefinedError, PluginsDoNotProvideLoadOrSaveMessagesError, PluginHasInvalidIdError, PluginHasInvalidSchemaError, } from "./errors.js";
 import { deepmerge } from "deepmerge-ts";
 import { TypeCompiler } from "@sinclair/typebox/compiler";
 import { tryCatch } from "@inlang/result";
+import _debug from "debug";
+const debug = _debug("sdk:resolvePlugins");
 // @ts-ignore - type mismatch error
 const PluginCompiler = TypeCompiler.Compile(Plugin);
 export const resolvePlugins = async (args) => {
@@ -14,6 +17,10 @@ export const resolvePlugins = async (args) => {
         },
         errors: [],
     };
+    const experimentalPersistence = !!args.settings.experimental?.persistence;
+    if (experimentalPersistence) {
+        debug("Using experimental persistence");
+    }
     for (const plugin of args.plugins) {
         const errors = [...PluginCompiler.Errors(plugin)];
         /**
@@ -62,16 +69,10 @@ export const resolvePlugins = async (args) => {
          * -------------- BEGIN ADDING TO RESULT --------------
          */
         if (typeof plugin.loadMessages === "function") {
-            result.data.loadMessages = (_args) => plugin.loadMessages({
-                ..._args,
-                // renoved nodeishFs from args because we need to pass custom wrapped fs that establishes a watcher
-            });
+            result.data.loadMessages = plugin.loadMessages;
         }
         if (typeof plugin.saveMessages === "function") {
-            result.data.saveMessages = (_args) => plugin.saveMessages({
-                ..._args,
-                nodeishFs: args.nodeishFs,
-            });
+            result.data.saveMessages = plugin.saveMessages;
         }
         if (typeof plugin.addCustomApi === "function") {
             const { data: customApi } = tryCatch(() => plugin.addCustomApi({
@@ -83,7 +84,14 @@ export const resolvePlugins = async (args) => {
         }
     }
     // --- LOADMESSAGE / SAVEMESSAGE NOT DEFINED ---
-    if (typeof result.data.loadMessages !== "function" ||
+    if (experimentalPersistence) {
+        debug("Override load/save for experimental persistence");
+        // @ts-ignore - type mismatch error
+        result.data.loadMessages = sdkLoadMessages;
+        // @ts-ignore - type mismatch error
+        result.data.saveMessages = sdkSaveMessages;
+    }
+    else if (typeof result.data.loadMessages !== "function" ||
         typeof result.data.saveMessages !== "function") {
         result.errors.push(new PluginsDoNotProvideLoadOrSaveMessagesError());
     }

package/dist/resolve-modules/plugins/resolvePlugins.test.js

@@ -49,7 +49,7 @@ it("should expose the project settings including the plugin settings", async ()
         nodeishFs: {},
     });
     await resolved.data.loadMessages({ settings, nodeishFs: {} });
-    await resolved.data.saveMessages({ settings, messages: [] });
+    await resolved.data.saveMessages({ settings, messages: [], nodeishFs: {} });
 });
 describe("loadMessages", () => {
     it("should load messages from a local source", async () => {

package/dist/resolve-modules/plugins/types.d.ts

@@ -31,6 +31,7 @@ export type ResolvedPluginApi = {
     saveMessages: (args: {
         settings: ProjectSettings;
         messages: Message[];
+        nodeishFs: NodeishFilesystemSubset;
     }) => Promise<void> | void;
     /**
      * App specific APIs.

package/dist/resolve-modules/plugins/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/resolve-modules/plugins/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,KAAK,EACX,mCAAmC,EACnC,6CAA6C,EAC7C,6CAA6C,EAC7C,uBAAuB,EACvB,2BAA2B,EAC3B,0CAA0C,EAC1C,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACzC,iBAAiB,EACjB,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CACxD,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACtB,QAAQ,EAAE,eAAe,CAAA;IACzB,SAAS,EAAE,uBAAuB,CAAA;CAClC,KAAK,OAAO,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAA;IACvB,MAAM,EAAE,KAAK,CACV,mCAAmC,GACnC,6CAA6C,GAC7C,6CAA6C,GAC7C,uBAAuB,GACvB,2BAA2B,GAC3B,0CAA0C,CAC5C,CAAA;CACD,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,YAAY,EAAE,CAAC,IAAI,EAAE;QACpB,QAAQ,EAAE,eAAe,CAAA;QACzB,SAAS,EAAE,uBAAuB,CAAA;KAClC,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAA;IACpC,YAAY,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,eAAe,CAAC;QAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAChG;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,EAAE,MAAM,CAAC,OAAO,MAAM,IAAI,MAAM,EAAE,GAAG,WAAW,MAAM,IAAI,MAAM,EAAE,EAAE,OAAO,CAAC,GAAG;QACvF,yBAAyB,CAAC,EAAE,2BAA2B,CAAA;KACvD,CAAA;CACD,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/resolve-modules/plugins/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,KAAK,EACX,mCAAmC,EACnC,6CAA6C,EAC7C,6CAA6C,EAC7C,uBAAuB,EACvB,2BAA2B,EAC3B,0CAA0C,EAC1C,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACzC,iBAAiB,EACjB,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CACxD,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACtB,QAAQ,EAAE,eAAe,CAAA;IACzB,SAAS,EAAE,uBAAuB,CAAA;CAClC,KAAK,OAAO,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAA;IACvB,MAAM,EAAE,KAAK,CACV,mCAAmC,GACnC,6CAA6C,GAC7C,6CAA6C,GAC7C,uBAAuB,GACvB,2BAA2B,GAC3B,0CAA0C,CAC5C,CAAA;CACD,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,YAAY,EAAE,CAAC,IAAI,EAAE;QACpB,QAAQ,EAAE,eAAe,CAAA;QACzB,SAAS,EAAE,uBAAuB,CAAA;KAClC,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAA;IACpC,YAAY,EAAE,CAAC,IAAI,EAAE;QACpB,QAAQ,EAAE,eAAe,CAAA;QACzB,QAAQ,EAAE,OAAO,EAAE,CAAA;QACnB,SAAS,EAAE,uBAAuB,CAAA;KAClC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC1B;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,EAAE,MAAM,CAAC,OAAO,MAAM,IAAI,MAAM,EAAE,GAAG,WAAW,MAAM,IAAI,MAAM,EAAE,EAAE,OAAO,CAAC,GAAG;QACvF,yBAAyB,CAAC,EAAE,2BAA2B,CAAA;KACvD,CAAA;CACD,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@inlang/sdk",
   "type": "module",
-  "version": "0.34.1",
+  "version": "0.34.3",
   "license": "Apache-2.0",
   "publishConfig": {
     "access": "public"
@@ -34,14 +34,14 @@
     "throttle-debounce": "^5.0.0",
     "@inlang/json-types": "1.1.0",
     "@inlang/language-tag": "1.5.1",
-    "@inlang/message-lint-rule": "1.4.6",
-    "@inlang/module": "1.2.10",
     "@inlang/message": "2.1.0",
-    "@inlang/plugin": "2.4.10",
-    "@inlang/project-settings": "2.4.1",
+    "@inlang/message-lint-rule": "1.4.7",
+    "@inlang/module": "1.2.11",
+    "@inlang/project-settings": "2.4.2",
     "@inlang/result": "1.1.0",
-    "@lix-js/client": "1.4.0",
+    "@inlang/plugin": "2.4.11",
     "@inlang/translatable": "1.3.1",
+    "@lix-js/client": "1.4.0",
     "@lix-js/fs": "1.0.0"
   },
   "devDependencies": {

package/src/errors.ts

@@ -1,3 +1,4 @@
+import type { SchemaOptions } from "@sinclair/typebox"
 import type { ValueError } from "@sinclair/typebox/errors"
 
 export class LoadProjectInvalidArgument extends Error {
@@ -11,15 +12,26 @@ export class ProjectSettingsInvalidError extends Error {
 	constructor(options: { errors: ValueError[] }) {
 		// TODO: beatufiy ValueErrors
 		super(
-			`The project settings are invalid:\n\n${options.errors
-				.filter((error) => error.path)
-				.map((error) => `"${error.path}":\n\n${error.message}`)
-				.join("\n")}`
+			`The project settings are invalid:
+${options.errors
+	.filter((error) => error.path)
+	.map(FormatProjectSettingsError)
+	.join("\n")}`
 		)
 		this.name = "ProjectSettingsInvalidError"
 	}
 }
 
+function FormatProjectSettingsError(error: ValueError) {
+	let msg = `${error.message} at ${error.path}`
+	if (error.path.startsWith("/modules/")) {
+		msg += `
+value = "${error.value}"
+- ${error.schema.allOf.map((o: SchemaOptions) => `${o.description ?? ""}`).join("\n- ")}`
+	}
+	return msg
+}
+
 export class ProjectSettingsFileJSONSyntaxError extends Error {
 	constructor(options: { cause: ErrorOptions["cause"]; path: string }) {
 		super(

package/src/loadProject.ts

@@ -38,6 +38,8 @@ import { capture } from "./telemetry/capture.js"
 import { identifyProject } from "./telemetry/groupIdentify.js"
 import type { NodeishStats } from "@lix-js/fs"
 
+import type { ResolvedPluginApi } from "./resolve-modules/plugins/types.js"
+
 import _debug from "debug"
 const debug = _debug("sdk:loadProject")
 const debugLock = _debug("sdk:lockfile")
@@ -94,6 +96,7 @@ export async function loadProject(args: {
 	// can't handle errors gracefully.
 
 	assertValidProjectPath(projectPath)
+	debug(projectPath)
 
 	const nodeishFs = createNodeishFsWithAbsolutePaths({
 		projectPath,
@@ -142,6 +145,11 @@ export async function loadProject(args: {
 		const setSettings = (settings: ProjectSettings): Result<void, ProjectSettingsInvalidError> => {
 			try {
 				const validatedSettings = parseSettings(settings)
+				if (validatedSettings.experimental?.persistence) {
+					settings["plugin.sdk.persistence"] = {
+						pathPattern: projectPath + "/messages.json",
+					}
+				}
 				_setSettings(validatedSettings)
 
 				writeSettingsToDisk(validatedSettings)
@@ -200,7 +208,9 @@ export async function loadProject(args: {
 			const _resolvedModules = resolvedModules()
 			if (!_resolvedModules) return
 
-			if (!_resolvedModules.resolvedPluginApi.loadMessages) {
+			const resolvedPluginApi = _resolvedModules.resolvedPluginApi
+
+			if (!resolvedPluginApi.loadMessages) {
 				markInitAsFailed(undefined)
 				return
 			}
@@ -208,11 +218,6 @@ export async function loadProject(args: {
 			const _settings = settings()
 			if (!_settings) return
 
-			// get plugin finding the plugin that provides loadMessages function
-			const loadMessagePlugin = _resolvedModules.plugins.find(
-				(plugin) => plugin.loadMessages !== undefined
-			)
-
 			// TODO #1844 this watcher needs to get pruned when we have a change in the configs which will trigger this again
 			const fsWithWatcher = createNodeishFsWithWatcher({
 				nodeishFs: nodeishFs,
@@ -227,7 +232,7 @@ export async function loadProject(args: {
 						messageStates,
 						messagesQuery,
 						settings()!, // NOTE we bang here - we don't expect the settings to become null during the livetime of a project
-						loadMessagePlugin
+						resolvedPluginApi
 					)
 						.catch((e) => setLoadMessagesViaPluginError(new PluginLoadMessagesError({ cause: e })))
 						.then(() => {
@@ -244,7 +249,7 @@ export async function loadProject(args: {
 				messageStates,
 				messagesQuery,
 				_settings,
-				loadMessagePlugin
+				resolvedPluginApi
 			)
 				.then(() => {
 					markInitAsComplete()
@@ -303,19 +308,13 @@ export async function loadProject(args: {
 
 			const _resolvedModules = resolvedModules()
 			if (!_resolvedModules) return
+			const resolvedPluginApi = _resolvedModules.resolvedPluginApi
 
 			const currentMessageIds = new Set(messagesQuery.includedMessageIds())
 			const deletedTrackedMessages = [...trackedMessages].filter(
 				(tracked) => !currentMessageIds.has(tracked[0])
 			)
 
-			const saveMessagesPlugin = _resolvedModules.plugins.find(
-				(plugin) => plugin.saveMessages !== undefined
-			)
-			const loadMessagesPlugin = _resolvedModules.plugins.find(
-				(plugin) => plugin.loadMessages !== undefined
-			)
-
 			for (const messageId of currentMessageIds) {
 				if (!trackedMessages!.has(messageId!)) {
 					// we create a new root to be able to cleanup an effect for a message that got deleted
@@ -334,6 +333,7 @@ export async function loadProject(args: {
 
 							// don't trigger saves or set dirty flags during initial setup
 							if (!initialSetup) {
+								debug("message changed", messageId)
 								messageStates.messageDirtyFlags[message.id] = true
 								saveMessagesViaPlugin(
 									nodeishFs,
@@ -341,8 +341,7 @@ export async function loadProject(args: {
 									messageStates,
 									messagesQuery,
 									settings()!,
-									saveMessagesPlugin,
-									loadMessagesPlugin
+									resolvedPluginApi
 								)
 									.catch((e) =>
 										setSaveMessagesViaPluginError(new PluginSaveMessagesError({ cause: e }))
@@ -379,8 +378,7 @@ export async function loadProject(args: {
 					messageStates,
 					messagesQuery,
 					settings()!,
-					saveMessagesPlugin,
-					loadMessagesPlugin
+					resolvedPluginApi
 				)
 					.catch((e) => setSaveMessagesViaPluginError(new PluginSaveMessagesError({ cause: e })))
 					.then(() => {
@@ -608,7 +606,7 @@ async function loadMessagesViaPlugin(
 	messageState: MessageState,
 	messagesQuery: InlangProject["query"]["messages"],
 	settingsValue: ProjectSettings,
-	loadPlugin: any
+	resolvedPluginApi: ResolvedPluginApi
 ) {
 	const experimentalAliases = !!settingsValue.experimental?.aliases
 
@@ -628,7 +626,7 @@ async function loadMessagesViaPlugin(
 	try {
 		lockTime = await acquireFileLock(fs as NodeishFilesystem, lockDirPath, "loadMessage")
 		const loadedMessages = await makeTrulyAsync(
-			loadPlugin.loadMessages({
+			resolvedPluginApi.loadMessages({
 				settings: settingsValue,
 				nodeishFs: fs,
 			})
@@ -728,7 +726,14 @@ async function loadMessagesViaPlugin(
 		messageState.sheduledLoadMessagesViaPlugin = undefined
 
 		// recall load unawaited to allow stack to pop
-		loadMessagesViaPlugin(fs, lockDirPath, messageState, messagesQuery, settingsValue, loadPlugin)
+		loadMessagesViaPlugin(
+			fs,
+			lockDirPath,
+			messageState,
+			messagesQuery,
+			settingsValue,
+			resolvedPluginApi
+		)
 			.then(() => {
 				// resolve the scheduled load message promise
 				executingScheduledMessages[1]()
@@ -746,8 +751,7 @@ async function saveMessagesViaPlugin(
 	messageState: MessageState,
 	messagesQuery: InlangProject["query"]["messages"],
 	settingsValue: ProjectSettings,
-	savePlugin: any,
-	loadPlugin: any
+	resolvedPluginApi: ResolvedPluginApi
 ): Promise<void> {
 	// queue next save if we have a save ongoing
 	if (messageState.isSaving) {
@@ -809,7 +813,7 @@ async function saveMessagesViaPlugin(
 			messageState.messageDirtyFlags = {}
 
 			// NOTE: this assumes that the plugin will handle message ordering
-			await savePlugin.saveMessages({
+			await resolvedPluginApi.saveMessages({
 				settings: settingsValue,
 				messages: messagesToExport,
 				nodeishFs: fs,
@@ -833,7 +837,7 @@ async function saveMessagesViaPlugin(
 					messageState,
 					messagesQuery,
 					settingsValue,
-					loadPlugin
+					resolvedPluginApi
 				)
 			}
 
@@ -877,8 +881,7 @@ async function saveMessagesViaPlugin(
 			messageState,
 			messagesQuery,
 			settingsValue,
-			savePlugin,
-			loadPlugin
+			resolvedPluginApi
 		)
 			.then(() => {
 				executingSheduledSaveMessages[1]()

package/src/persistence/plugin.test.ts

@@ -0,0 +1,60 @@
+import { test, expect } from "vitest"
+import { createMessage, createNodeishMemoryFs } from "../test-utilities/index.js"
+import { normalizeMessage } from "../storage/helper.js"
+import { pluginId } from "./plugin.js"
+
+const mockMessages = [
+	createMessage("first_message", {
+		en: "If this fails I will be sad",
+	}),
+	createMessage("second_message", {
+		en: "Let's see if this works",
+		de: "Mal sehen ob das funktioniert",
+	}),
+]
+
+// the test ensures:
+//   - messages can be loaded
+//   - messages can be saved
+//   - after loading and saving messages, the state is the same as before (roundtrip)
+test("roundtrip (saving/loading messages)", async () => {
+	const { loadMessages, saveMessages } = await import("./plugin.js")
+	const fs = createNodeishMemoryFs()
+	const projectDir = "/test/project.inlang"
+	const pathPattern = projectDir + "/messages.json"
+	const persistedMessages = JSON.stringify(mockMessages.map(normalizeMessage), undefined, 2)
+
+	const settings = {
+		sourceLanguageTag: "en",
+		languageTags: ["en", "de"],
+		modules: [],
+		[pluginId]: { pathPattern },
+	}
+
+	await fs.mkdir(projectDir, { recursive: true })
+	await fs.writeFile(pathPattern, persistedMessages)
+
+	const firstMessageLoad = await loadMessages({
+		settings,
+		nodeishFs: fs,
+	})
+
+	expect(firstMessageLoad).toStrictEqual(mockMessages)
+
+	await saveMessages({
+		settings,
+		nodeishFs: fs,
+		messages: firstMessageLoad,
+	})
+
+	const afterRoundtrip = await fs.readFile(pathPattern, { encoding: "utf-8" })
+
+	expect(afterRoundtrip).toStrictEqual(persistedMessages)
+
+	const messagesAfterRoundtrip = await loadMessages({
+		settings,
+		nodeishFs: fs,
+	})
+
+	expect(messagesAfterRoundtrip).toStrictEqual(firstMessageLoad)
+})

package/src/persistence/plugin.ts

@@ -0,0 +1,56 @@
+import type { ProjectSettings, Message } from "@inlang/sdk"
+import { getDirname, type NodeishFilesystem } from "@lix-js/fs"
+import { normalizeMessage } from "../storage/helper.js"
+
+import _debug from "debug"
+const debug = _debug("sdk:persistence")
+
+export const pluginId = "plugin.sdk.persistence"
+
+export async function loadMessages(args: {
+	settings: ProjectSettings
+	nodeishFs: NodeishFilesystem
+}) {
+	let result: Message[] = []
+	const pathPattern = args.settings[pluginId]?.pathPattern as string
+
+	debug("loadMessages", pathPattern)
+	try {
+		const file = await args.nodeishFs.readFile(pathPattern, { encoding: "utf-8" })
+		result = JSON.parse(file)
+	} catch (error) {
+		if ((error as any)?.code !== "ENOENT") {
+			debug("loadMessages", error)
+			throw error
+		}
+	}
+	return result
+}
+
+export async function saveMessages(args: {
+	settings: ProjectSettings
+	nodeishFs: NodeishFilesystem
+	messages: Message[]
+}) {
+	const pathPattern = args.settings[pluginId]?.pathPattern as string
+
+	debug("saveMessages", pathPattern)
+	try {
+		await createDirectoryIfNotExits(getDirname(pathPattern), args.nodeishFs)
+		await args.nodeishFs.writeFile(
+			pathPattern,
+			// 2 spaces indentation
+			JSON.stringify(args.messages.map(normalizeMessage), undefined, 2)
+		)
+	} catch (error) {
+		debug("saveMessages", error)
+	}
+}
+
+async function createDirectoryIfNotExits(path: string, nodeishFs: NodeishFilesystem) {
+	try {
+		await nodeishFs.mkdir(path, { recursive: true })
+	} catch {
+		// assume that the directory already exists
+	}
+}

package/src/resolve-modules/plugins/resolvePlugins.test.ts

@@ -61,7 +61,7 @@ it("should expose the project settings including the plugin settings", async ()
 		nodeishFs: {} as any,
 	})
 	await resolved.data.loadMessages!({ settings, nodeishFs: {} as any })
-	await resolved.data.saveMessages!({ settings, messages: [] })
+	await resolved.data.saveMessages!({ settings, messages: [], nodeishFs: {} as any })
 })
 
 describe("loadMessages", () => {

package/src/resolve-modules/plugins/resolvePlugins.ts

@@ -1,6 +1,10 @@
 /* eslint-disable @typescript-eslint/no-non-null-assertion */
 import type { ResolvePluginsFunction } from "./types.js"
 import { Plugin } from "@inlang/plugin"
+import {
+	loadMessages as sdkLoadMessages,
+	saveMessages as sdkSaveMessages,
+} from "../../persistence/plugin.js"
 import {
 	PluginReturnedInvalidCustomApiError,
 	PluginLoadMessagesFunctionAlreadyDefinedError,
@@ -13,6 +17,9 @@ import { deepmerge } from "deepmerge-ts"
 import { TypeCompiler } from "@sinclair/typebox/compiler"
 import { tryCatch } from "@inlang/result"
 
+import _debug from "debug"
+const debug = _debug("sdk:resolvePlugins")
+
 // @ts-ignore - type mismatch error
 const PluginCompiler = TypeCompiler.Compile(Plugin)
 
@@ -26,6 +33,11 @@ export const resolvePlugins: ResolvePluginsFunction = async (args) => {
 		errors: [],
 	}
 
+	const experimentalPersistence = !!args.settings.experimental?.persistence
+	if (experimentalPersistence) {
+		debug("Using experimental persistence")
+	}
+
 	for (const plugin of args.plugins) {
 		const errors = [...PluginCompiler.Errors(plugin)]
 
@@ -88,19 +100,11 @@ export const resolvePlugins: ResolvePluginsFunction = async (args) => {
 		 */
 
 		if (typeof plugin.loadMessages === "function") {
-			result.data.loadMessages = (_args) =>
-				plugin.loadMessages!({
-					..._args,
-					// renoved nodeishFs from args because we need to pass custom wrapped fs that establishes a watcher
-				})
+			result.data.loadMessages = plugin.loadMessages
 		}
 
 		if (typeof plugin.saveMessages === "function") {
-			result.data.saveMessages = (_args) =>
-				plugin.saveMessages!({
-					..._args,
-					nodeishFs: args.nodeishFs,
-				})
+			result.data.saveMessages = plugin.saveMessages
 		}
 
 		if (typeof plugin.addCustomApi === "function") {
@@ -116,7 +120,14 @@ export const resolvePlugins: ResolvePluginsFunction = async (args) => {
 	}
 
 	// --- LOADMESSAGE / SAVEMESSAGE NOT DEFINED ---
-	if (
+
+	if (experimentalPersistence) {
+		debug("Override load/save for experimental persistence")
+		// @ts-ignore - type mismatch error
+		result.data.loadMessages = sdkLoadMessages
+		// @ts-ignore - type mismatch error
+		result.data.saveMessages = sdkSaveMessages
+	} else if (
 		typeof result.data.loadMessages !== "function" ||
 		typeof result.data.saveMessages !== "function"
 	) {

package/src/resolve-modules/plugins/types.ts

@@ -48,7 +48,11 @@ export type ResolvedPluginApi = {
 		settings: ProjectSettings
 		nodeishFs: NodeishFilesystemSubset
 	}) => Promise<Message[]> | Message[]
-	saveMessages: (args: { settings: ProjectSettings; messages: Message[] }) => Promise<void> | void
+	saveMessages: (args: {
+		settings: ProjectSettings
+		messages: Message[]
+		nodeishFs: NodeishFilesystemSubset
+	}) => Promise<void> | void
 	/**
 	 * App specific APIs.
 	 *