@desktalk/core 0.1.0-alpha.1

package/dist/services/backend-host.js

@@ -0,0 +1,117 @@
+/**
+ * Child-process entry point for an isolated MiniApp backend.
+ *
+ * Spawned by BackendProcessManager via `child_process.fork()`.
+ * Receives an "activate" message over IPC, imports the backend module,
+ * wires up a local MessagingHook that bridges commands/events through IPC,
+ * then signals "ready" back to the main process.
+ */
+import { dirname } from 'node:path';
+import { createStorageHook } from './storage.js';
+import { createFileSystemHook } from './filesystem.js';
+import { createChildLogger } from './logger.js';
+import { createPackageLocalizer } from './i18n.js';
+// ─── Per-process state ──────────────────────────────────────────────────────
+const commandHandlers = new Map();
+let deactivateFn = null;
+let subscriptions = [];
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function sendToMain(msg) {
+    if (process.send) {
+        process.send(msg);
+    }
+}
+/**
+ * Creates a MessagingHook that lives entirely inside this child process.
+ * - onCommand: registers a handler in the local map.
+ * - emit: forwards the event to the main process via IPC.
+ */
+function createChildMessagingHook(miniAppId) {
+    return {
+        onCommand(command, handler) {
+            commandHandlers.set(command, handler);
+            return {
+                dispose() {
+                    commandHandlers.delete(command);
+                },
+            };
+        },
+        emit(event, data) {
+            sendToMain({ type: 'event', miniAppId, event, data });
+        },
+    };
+}
+function resolveUserHomeDir(miniAppDataDir) {
+    return dirname(dirname(miniAppDataDir));
+}
+// ─── Message handlers ───────────────────────────────────────────────────────
+async function handleActivate(msg) {
+    const mod = await import(msg.backendPath);
+    const context = {
+        paths: msg.paths,
+        launchArgs: Array.isArray(msg.launchArgs) ? msg.launchArgs : [],
+        storage: createStorageHook(msg.paths.storage),
+        fs: createFileSystemHook(resolveUserHomeDir(msg.paths.data)),
+        messaging: createChildMessagingHook(msg.miniAppId),
+        subscriptions: [],
+        logger: createChildLogger(msg.loggerConfig, msg.miniAppId),
+        i18n: createPackageLocalizer({
+            packageRoot: msg.packageRoot,
+            defaultScope: msg.miniAppId,
+            locale: msg.locale,
+        }),
+    };
+    subscriptions = context.subscriptions;
+    deactivateFn = () => mod.deactivate();
+    mod.activate(context);
+    sendToMain({ type: 'ready', miniAppId: msg.miniAppId });
+}
+async function handleCommandInvoke(requestId, command, data) {
+    const handler = commandHandlers.get(command);
+    if (!handler) {
+        sendToMain({
+            type: 'command:response',
+            requestId,
+            error: `No handler registered for command: ${command}`,
+        });
+        return;
+    }
+    try {
+        const result = await handler(data);
+        sendToMain({ type: 'command:response', requestId, data: result });
+    }
+    catch (err) {
+        sendToMain({
+            type: 'command:response',
+            requestId,
+            error: err.message,
+        });
+    }
+}
+function handleDeactivate() {
+    for (const sub of subscriptions) {
+        sub.dispose();
+    }
+    deactivateFn?.();
+    process.exit(0);
+}
+// ─── IPC listener ───────────────────────────────────────────────────────────
+process.on('message', async (msg) => {
+    try {
+        switch (msg.type) {
+            case 'activate':
+                await handleActivate(msg);
+                break;
+            case 'command:invoke':
+                await handleCommandInvoke(msg.requestId, msg.command, msg.data);
+                break;
+            case 'deactivate':
+                handleDeactivate();
+                break;
+        }
+    }
+    catch (err) {
+        sendToMain({ type: 'error', message: err.message });
+    }
+});
+//# sourceMappingURL=backend-host.js.map

package/dist/services/backend-host.js.map

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

package/dist/services/backend-ipc.d.ts

@@ -0,0 +1,60 @@
+import type { MiniAppPaths } from '@desktalk/sdk';
+import type { LoggerConfig } from './logger.js';
+export interface LaunchWindowArgs {
+    [key: string]: unknown;
+}
+/** Tell the child process to import and activate a MiniApp backend. */
+export interface ActivateMessage {
+    type: 'activate';
+    miniAppId: string;
+    /** Resolved file-URL or bare specifier the child can `import()`. */
+    backendPath: string;
+    /** Absolute path to the MiniApp package root (for i18n). */
+    packageRoot: string;
+    /** Pre-resolved MiniApp paths (data, storage, log, cache). */
+    paths: MiniAppPaths;
+    /** Launch args for the active or restored windows of this MiniApp. */
+    launchArgs: LaunchWindowArgs[];
+    /** Locale string (e.g. "en", "zh-CN"). */
+    locale: string;
+    /** Logger configuration so the child can recreate an equivalent pino instance. */
+    loggerConfig: LoggerConfig;
+}
+/** Forward a command:invoke from the renderer to the child. */
+export interface CommandInvokeMessage {
+    type: 'command:invoke';
+    requestId: string;
+    command: string;
+    data: unknown;
+}
+/** Tell the child process to deactivate and exit. */
+export interface DeactivateMessage {
+    type: 'deactivate';
+}
+export type MainToChildMessage = ActivateMessage | CommandInvokeMessage | DeactivateMessage;
+/** The child has finished activation and is ready to accept commands. */
+export interface ReadyMessage {
+    type: 'ready';
+    miniAppId: string;
+}
+/** Result (or error) for a previously forwarded command. */
+export interface CommandResponseMessage {
+    type: 'command:response';
+    requestId: string;
+    data?: unknown;
+    error?: string;
+}
+/** The MiniApp backend emitted an event that should be broadcast to renderers. */
+export interface EventBroadcastMessage {
+    type: 'event';
+    miniAppId: string;
+    event: string;
+    data: unknown;
+}
+/** Unrecoverable error in the child process. */
+export interface ChildErrorMessage {
+    type: 'error';
+    message: string;
+}
+export type ChildToMainMessage = ReadyMessage | CommandResponseMessage | EventBroadcastMessage | ChildErrorMessage;
+//# sourceMappingURL=backend-ipc.d.ts.map

package/dist/services/backend-ipc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-ipc.d.ts","sourceRoot":"","sources":["../../src/services/backend-ipc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,KAAK,EAAE,YAAY,CAAC;IACpB,sEAAsE;IACtE,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,oBAAoB,GAAG,iBAAiB,CAAC;AAI5F,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kFAAkF;AAClF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,sBAAsB,GACtB,qBAAqB,GACrB,iBAAiB,CAAC"}

package/dist/services/backend-ipc.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backend-ipc.js.map

package/dist/services/backend-ipc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-ipc.js","sourceRoot":"","sources":["../../src/services/backend-ipc.ts"],"names":[],"mappings":""}

package/dist/services/backend-process-manager.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Manages one child process per MiniApp backend.
+ *
+ * Each process is spawned via `child_process.fork()` and runs
+ * `backend-host.js`, which imports the actual MiniApp backend module,
+ * creates its context, and handles commands/events via Node IPC.
+ *
+ * The main process routes incoming WebSocket commands to the correct
+ * child and relays events from children back to connected clients.
+ */
+import type { MiniAppPaths } from '@desktalk/sdk';
+import type pino from 'pino';
+import type { LoggerConfig } from './logger.js';
+/**
+ * Singleton manager that owns every backend child process.
+ */
+declare class BackendProcessManager {
+    private processes;
+    private pendingRequests;
+    /** Absolute path to the compiled backend-host entry file. */
+    private readonly hostPath;
+    private logger;
+    private loggerConfig;
+    constructor();
+    /**
+     * Inject the logger and its serializable config.
+     * Must be called once before any spawn().
+     */
+    init(logger: pino.Logger, loggerConfig: LoggerConfig): void;
+    /**
+     * Spawn an isolated child process and wait until it reports "ready"
+     * (i.e. the backend's activate() has returned).
+     *
+     * @param processKey Unique key for this process instance (e.g. "note:admin").
+     * @param backendPath Import specifier for the MiniApp backend module.
+     * @param packageRoot Absolute path to the MiniApp package root.
+     * @param paths Pre-resolved MiniApp paths scoped to the current user.
+     * @param locale Locale string (e.g. "en", "zh-CN").
+     * @param miniAppId Original MiniApp ID (e.g. "note"). If omitted, uses processKey.
+     */
+    spawn(processKey: string, backendPath: string, packageRoot: string, paths: MiniAppPaths, locale: string, miniAppId?: string, launchArgs?: Array<Record<string, unknown>>): Promise<void>;
+    /**
+     * Send a command to the child process identified by `processKey` and
+     * return the result (or throw on error / timeout).
+     */
+    sendCommand(processKey: string, command: string, data: unknown): Promise<unknown>;
+    /**
+     * Gracefully deactivate and stop the child process identified by `processKey`.
+     */
+    kill(processKey: string): Promise<void>;
+    /** Check whether a child process is running for `processKey`. */
+    isRunning(processKey: string): boolean;
+    /** Gracefully shut down every child process. */
+    killAll(): Promise<void>;
+    private handleChildMessage;
+}
+/** Singleton process manager instance. */
+export declare const processManager: BackendProcessManager;
+export {};
+//# sourceMappingURL=backend-process-manager.d.ts.map

package/dist/services/backend-process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-process-manager.d.ts","sourceRoot":"","sources":["../../src/services/backend-process-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA2B7C;;GAEG;AACH,cAAM,qBAAqB;IACzB,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,eAAe,CAAqC;IAC5D,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAA6B;;IAMjD;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,IAAI;IAO3D;;;;;;;;;;OAUG;IACG,KAAK,CACT,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,GAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,GAC9C,OAAO,CAAC,IAAI,CAAC;IAyEhB;;;OAGG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAgCvF;;OAEG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7C,iEAAiE;IACjE,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAItC,gDAAgD;IAC1C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,OAAO,CAAC,kBAAkB;CA0B3B;AAED,0CAA0C;AAC1C,eAAO,MAAM,cAAc,uBAA8B,CAAC"}

package/dist/services/backend-process-manager.js

@@ -0,0 +1,203 @@
+/**
+ * Manages one child process per MiniApp backend.
+ *
+ * Each process is spawned via `child_process.fork()` and runs
+ * `backend-host.js`, which imports the actual MiniApp backend module,
+ * creates its context, and handles commands/events via Node IPC.
+ *
+ * The main process routes incoming WebSocket commands to the correct
+ * child and relays events from children back to connected clients.
+ */
+import { fork } from 'node:child_process';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { randomUUID } from 'node:crypto';
+import { broadcastEvent } from './messaging.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const COMMAND_TIMEOUT_MS = 30_000;
+const DEACTIVATE_TIMEOUT_MS = 5_000;
+/**
+ * Singleton manager that owns every backend child process.
+ */
+class BackendProcessManager {
+    processes = new Map();
+    pendingRequests = new Map();
+    /** Absolute path to the compiled backend-host entry file. */
+    hostPath;
+    logger = null;
+    loggerConfig = null;
+    constructor() {
+        this.hostPath = join(__dirname, 'backend-host.js');
+    }
+    /**
+     * Inject the logger and its serializable config.
+     * Must be called once before any spawn().
+     */
+    init(logger, loggerConfig) {
+        this.logger = logger;
+        this.loggerConfig = loggerConfig;
+    }
+    // ─── Lifecycle ──────────────────────────────────────────────────────────
+    /**
+     * Spawn an isolated child process and wait until it reports "ready"
+     * (i.e. the backend's activate() has returned).
+     *
+     * @param processKey Unique key for this process instance (e.g. "note:admin").
+     * @param backendPath Import specifier for the MiniApp backend module.
+     * @param packageRoot Absolute path to the MiniApp package root.
+     * @param paths Pre-resolved MiniApp paths scoped to the current user.
+     * @param locale Locale string (e.g. "en", "zh-CN").
+     * @param miniAppId Original MiniApp ID (e.g. "note"). If omitted, uses processKey.
+     */
+    async spawn(processKey, backendPath, packageRoot, paths, locale, miniAppId, launchArgs = []) {
+        if (this.processes.has(processKey)) {
+            return; // already running
+        }
+        const actualMiniAppId = miniAppId ?? processKey;
+        const child = fork(this.hostPath, [], {
+            stdio: ['pipe', 'pipe', 'pipe', 'ipc'],
+        });
+        let resolveReady;
+        let rejectReady;
+        const readyPromise = new Promise((resolve, reject) => {
+            resolveReady = resolve;
+            rejectReady = reject;
+        });
+        const managed = {
+            child,
+            processKey,
+            miniAppId: actualMiniAppId,
+            ready: false,
+            readyPromise,
+        };
+        this.processes.set(processKey, managed);
+        // Relay messages from child
+        child.on('message', (msg) => {
+            this.handleChildMessage(processKey, msg);
+            if (msg.type === 'ready') {
+                managed.ready = true;
+                resolveReady();
+            }
+        });
+        child.on('exit', (code, signal) => {
+            this.logger?.info({ processKey, code, signal }, 'child process exited');
+            this.processes.delete(processKey);
+        });
+        child.on('error', (err) => {
+            this.logger?.error({ processKey, err: err.message }, 'child process error');
+            rejectReady(err);
+        });
+        // Forward child stdout / stderr so operator can see backend logs
+        child.stdout?.on('data', (data) => {
+            process.stdout.write(`[${processKey}] ${data.toString()}`);
+        });
+        child.stderr?.on('data', (data) => {
+            process.stderr.write(`[${processKey}] ${data.toString()}`);
+        });
+        // Ask the child to activate — use the original miniAppId, not the process key
+        const activateMsg = {
+            type: 'activate',
+            miniAppId: actualMiniAppId,
+            backendPath,
+            packageRoot,
+            paths,
+            launchArgs,
+            locale,
+            loggerConfig: this.loggerConfig,
+        };
+        child.send(activateMsg);
+        await readyPromise;
+    }
+    // ─── Command routing ────────────────────────────────────────────────────
+    /**
+     * Send a command to the child process identified by `processKey` and
+     * return the result (or throw on error / timeout).
+     */
+    async sendCommand(processKey, command, data) {
+        const managed = this.processes.get(processKey);
+        if (!managed) {
+            throw new Error(`No running process for key: ${processKey}`);
+        }
+        if (!managed.ready) {
+            await managed.readyPromise;
+        }
+        const requestId = `cmd-${randomUUID()}`;
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(requestId);
+                reject(new Error(`Command timed out: ${command} (process: ${processKey})`));
+            }, COMMAND_TIMEOUT_MS);
+            this.pendingRequests.set(requestId, { resolve, reject, timeout });
+            const msg = {
+                type: 'command:invoke',
+                requestId,
+                command,
+                data,
+            };
+            managed.child.send(msg);
+        });
+    }
+    // ─── Teardown ───────────────────────────────────────────────────────────
+    /**
+     * Gracefully deactivate and stop the child process identified by `processKey`.
+     */
+    async kill(processKey) {
+        const managed = this.processes.get(processKey);
+        if (!managed) {
+            return;
+        }
+        managed.child.send({ type: 'deactivate' });
+        await new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                managed.child.kill();
+                resolve();
+            }, DEACTIVATE_TIMEOUT_MS);
+            managed.child.on('exit', () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+        });
+        this.processes.delete(processKey);
+    }
+    /** Check whether a child process is running for `processKey`. */
+    isRunning(processKey) {
+        return this.processes.has(processKey);
+    }
+    /** Gracefully shut down every child process. */
+    async killAll() {
+        const ids = Array.from(this.processes.keys());
+        await Promise.all(ids.map((id) => this.kill(id)));
+    }
+    // ─── Internal ───────────────────────────────────────────────────────────
+    handleChildMessage(processKey, msg) {
+        switch (msg.type) {
+            case 'command:response': {
+                const pending = this.pendingRequests.get(msg.requestId);
+                if (pending) {
+                    clearTimeout(pending.timeout);
+                    this.pendingRequests.delete(msg.requestId);
+                    if (msg.error) {
+                        pending.reject(new Error(msg.error));
+                    }
+                    else {
+                        pending.resolve(msg.data);
+                    }
+                }
+                break;
+            }
+            case 'event':
+                broadcastEvent(msg.miniAppId, msg.event, msg.data);
+                break;
+            case 'error':
+                this.logger?.error({ processKey, err: msg.message }, 'child process reported error');
+                break;
+            case 'ready':
+                // Handled inline in spawn()
+                break;
+        }
+    }
+}
+/** Singleton process manager instance. */
+export const processManager = new BackendProcessManager();
+//# sourceMappingURL=backend-process-manager.js.map

package/dist/services/backend-process-manager.js.map

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

package/dist/services/filesystem.d.ts

@@ -0,0 +1,8 @@
+import type { FileSystemHook } from '@desktalk/sdk';
+/**
+ * Creates a scoped filesystem hook for a MiniApp.
+ * All paths are resolved relative to the authenticated user's home directory.
+ * Path traversal outside the root is prevented.
+ */
+export declare function createFileSystemHook(rootDir: string): FileSystemHook;
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/services/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/services/filesystem.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,eAAe,CAAC;AAEzE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAgGpE"}

package/dist/services/filesystem.js

@@ -0,0 +1,94 @@
+import { readFileSync, writeFileSync, unlinkSync, renameSync, rmSync, readdirSync, mkdirSync, statSync, existsSync, } from 'node:fs';
+import { join, resolve, relative } from 'node:path';
+/**
+ * Creates a scoped filesystem hook for a MiniApp.
+ * All paths are resolved relative to the authenticated user's home directory.
+ * Path traversal outside the root is prevented.
+ */
+export function createFileSystemHook(rootDir) {
+    /**
+     * Resolve a relative path to an absolute path within the root.
+     * Throws if the resolved path escapes the root directory.
+     */
+    function safePath(relPath) {
+        const resolved = resolve(rootDir, relPath);
+        const rel = relative(rootDir, resolved);
+        if (rel.startsWith('..') || resolve(rootDir, rel) !== resolved) {
+            throw new Error(`Path traversal not allowed: ${relPath}`);
+        }
+        return resolved;
+    }
+    return {
+        async readFile(path) {
+            const abs = safePath(path);
+            return readFileSync(abs, 'utf-8');
+        },
+        async readFileBase64(path) {
+            const abs = safePath(path);
+            return readFileSync(abs).toString('base64');
+        },
+        async writeFile(path, content) {
+            const abs = safePath(path);
+            // Ensure parent directory exists
+            const parent = resolve(abs, '..');
+            if (!existsSync(parent)) {
+                mkdirSync(parent, { recursive: true });
+            }
+            writeFileSync(abs, content, 'utf-8');
+        },
+        async writeFileBase64(path, contentBase64) {
+            const abs = safePath(path);
+            const parent = resolve(abs, '..');
+            if (!existsSync(parent)) {
+                mkdirSync(parent, { recursive: true });
+            }
+            writeFileSync(abs, Buffer.from(contentBase64, 'base64'));
+        },
+        async deleteFile(path) {
+            const abs = safePath(path);
+            const stat = statSync(abs);
+            if (stat.isDirectory()) {
+                rmSync(abs, { recursive: true, force: true });
+                return;
+            }
+            unlinkSync(abs);
+        },
+        async rename(oldPath, newPath) {
+            const oldAbs = safePath(oldPath);
+            const newAbs = safePath(newPath);
+            const parent = resolve(newAbs, '..');
+            if (!existsSync(parent)) {
+                mkdirSync(parent, { recursive: true });
+            }
+            renameSync(oldAbs, newAbs);
+        },
+        async readDir(path) {
+            const abs = safePath(path);
+            const entries = readdirSync(abs, { withFileTypes: true });
+            return entries.map((entry) => ({
+                name: entry.name,
+                path: join(path, entry.name),
+                type: entry.isDirectory() ? 'directory' : 'file',
+            }));
+        },
+        async mkdir(path) {
+            const abs = safePath(path);
+            mkdirSync(abs, { recursive: true });
+        },
+        async stat(path) {
+            const abs = safePath(path);
+            const s = statSync(abs);
+            return {
+                size: s.size,
+                type: s.isDirectory() ? 'directory' : 'file',
+                createdAt: s.birthtime.toISOString(),
+                modifiedAt: s.mtime.toISOString(),
+            };
+        },
+        async exists(path) {
+            const abs = safePath(path);
+            return existsSync(abs);
+        },
+    };
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/services/filesystem.js.map

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

package/dist/services/i18n.d.ts

@@ -0,0 +1,28 @@
+export type LocaleMessages = Record<string, Record<string, string>>;
+export interface Localizer {
+    t(key: string, defaultText: string, params?: Record<string, string | number | boolean | null | undefined>): string;
+    locale(): string;
+}
+export interface PackageI18nManifest {
+    packageName: string;
+    packageScope: string;
+    locales: string[];
+    messages: Array<{
+        key: string;
+        defaultText: string;
+        placeholders: string[];
+    }>;
+}
+export interface PackageI18nSource {
+    packageRoot: string;
+    packageScope: string;
+}
+export declare function readPackageI18nManifest(packageRoot: string): PackageI18nManifest | null;
+export declare function loadPackageLocaleMessages(packageRoot: string, packageScope: string, locale: string): LocaleMessages;
+export declare function loadMergedLocaleMessages(packages: PackageI18nSource[], locale: string): LocaleMessages;
+export declare function createPackageLocalizer(options: {
+    packageRoot: string;
+    defaultScope: string;
+    locale: string;
+}): Localizer;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/services/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/services/i18n.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AACpE,MAAM,WAAW,SAAS;IACxB,CAAC,CACC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GACpE,MAAM,CAAC;IACV,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAwBD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAOvF;AA0BD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,cAAc,CAQhB;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,MAAM,EAAE,MAAM,GACb,cAAc,CAchB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,SAAS,CAgBZ"}