@miragon/pulse-widget-shell 0.24.1 → 0.25.0

package/dist/profile-store-env.d.ts

@@ -1,34 +0,0 @@
-import { type ProfileStore } from "./profile-store.js";
-/**
- * The non-database profile store selection every composition root shares:
- * filesystem-backed when `MCP_PROFILE_DIR` is set (survives restarts),
- * in-memory otherwise. Roots with a database extend the precedence themselves
- * (`DATABASE_URL` → `createPostgresProfileStore` beats this — see the stock
- * app's `initRuntime`); the factories stay pure and injectable.
- */
-export declare function profileStoreFromEnv(env?: NodeJS.ProcessEnv): ProfileStore;
-/** Where a composition root keeps a store. */
-export type PersistenceBackend = "postgres" | "filesystem" | "memory";
-/** The backend each store selected at boot. */
-export interface PersistenceSelection {
-    profiles: PersistenceBackend;
-    /** Omitted when the server registers no dashboard builder (`frameworkWritesAllowed`). */
-    dashboards?: PersistenceBackend;
-}
-/** The non-database selection {@link profileStoreFromEnv} and the dashboard knob make. */
-export declare function persistenceFromEnv(env?: NodeJS.ProcessEnv): Required<PersistenceSelection>;
-/**
- * Announce the selected persistence on EVERY boot path — nobody should have
- * to infer from silence that settings are volatile — and warn loudly when a
- * production process (`NODE_ENV=production`, set by the Docker images) keeps a
- * store in memory: every restart, redeploy or scale-to-zero stop then
- * silently drops saved settings or dashboards. A warning, not a boot failure:
- * failing would break every deployment that accepts volatile settings today.
- * `remedy` names the knobs THIS composition root offers.
- */
-export declare function announcePersistence(selection: PersistenceSelection, options?: {
-    env?: NodeJS.ProcessEnv;
-    label?: string;
-    remedy?: string;
-}): void;
-//# sourceMappingURL=profile-store-env.d.ts.map

package/dist/profile-store-env.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"profile-store-env.d.ts","sourceRoot":"","sources":["../src/profile-store-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAA;AAE3B;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAItF;AAED,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,CAAA;AAErE,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,yFAAyF;IACzF,UAAU,CAAC,EAAE,kBAAkB,CAAA;CAChC;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAChC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,QAAQ,CAAC,oBAAoB,CAAC,CAKhC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,oBAAoB,EAC/B,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACzE,IAAI,CAiBN"}

package/dist/profile-store-env.js

@@ -1,44 +0,0 @@
-import { createFileSystemProfileStore, createInMemoryProfileStore, } from "./profile-store.js";
-/**
- * The non-database profile store selection every composition root shares:
- * filesystem-backed when `MCP_PROFILE_DIR` is set (survives restarts),
- * in-memory otherwise. Roots with a database extend the precedence themselves
- * (`DATABASE_URL` → `createPostgresProfileStore` beats this — see the stock
- * app's `initRuntime`); the factories stay pure and injectable.
- */
-export function profileStoreFromEnv(env = process.env) {
-    return env.MCP_PROFILE_DIR
-        ? createFileSystemProfileStore({ dir: env.MCP_PROFILE_DIR })
-        : createInMemoryProfileStore();
-}
-/** The non-database selection {@link profileStoreFromEnv} and the dashboard knob make. */
-export function persistenceFromEnv(env = process.env) {
-    return {
-        profiles: env.MCP_PROFILE_DIR ? "filesystem" : "memory",
-        dashboards: env.MCP_DASHBOARD_DIR ? "filesystem" : "memory",
-    };
-}
-/**
- * Announce the selected persistence on EVERY boot path — nobody should have
- * to infer from silence that settings are volatile — and warn loudly when a
- * production process (`NODE_ENV=production`, set by the Docker images) keeps a
- * store in memory: every restart, redeploy or scale-to-zero stop then
- * silently drops saved settings or dashboards. A warning, not a boot failure:
- * failing would break every deployment that accepts volatile settings today.
- * `remedy` names the knobs THIS composition root offers.
- */
-export function announcePersistence(selection, options = {}) {
-    const { env = process.env, label = "persistence", remedy = "Set MCP_PROFILE_DIR / MCP_DASHBOARD_DIR to directories on a persistent volume.", } = options;
-    const dashboards = selection.dashboards ? `, dashboards=${selection.dashboards}` : "";
-    console.log(`[${label}] persistence: profiles=${selection.profiles}${dashboards}`);
-    if (env.NODE_ENV !== "production")
-        return;
-    const volatile = [
-        ...(selection.profiles === "memory" ? ["user profiles"] : []),
-        ...(selection.dashboards === "memory" ? ["saved dashboards"] : []),
-    ];
-    if (volatile.length === 0)
-        return;
-    console.warn(`[${label}] WARNING: ${volatile.join(" and ")} are kept IN MEMORY in a production process — every restart, redeploy or scale-to-zero stop silently drops them. ${remedy}`);
-}
-//# sourceMappingURL=profile-store-env.js.map

package/dist/profile-store-env.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"profile-store-env.js","sourceRoot":"","sources":["../src/profile-store-env.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,GAE3B,MAAM,oBAAoB,CAAA;AAE3B;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACtE,OAAO,GAAG,CAAC,eAAe;QACxB,CAAC,CAAC,4BAA4B,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC;QAC5D,CAAC,CAAC,0BAA0B,EAAE,CAAA;AAClC,CAAC;AAYD,0FAA0F;AAC1F,MAAM,UAAU,kBAAkB,CAChC,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ;QACvD,UAAU,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ;KAC5D,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAA+B,EAC/B,UAAwE,EAAE;IAE1E,MAAM,EACJ,GAAG,GAAG,OAAO,CAAC,GAAG,EACjB,KAAK,GAAG,aAAa,EACrB,MAAM,GAAG,gFAAgF,GAC1F,GAAG,OAAO,CAAA;IACX,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,gBAAgB,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACrF,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,2BAA2B,SAAS,CAAC,QAAQ,GAAG,UAAU,EAAE,CAAC,CAAA;IAClF,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY;QAAE,OAAM;IACzC,MAAM,QAAQ,GAAG;QACf,GAAG,CAAC,SAAS,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,SAAS,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAA;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IACjC,OAAO,CAAC,IAAI,CACV,IAAI,KAAK,cAAc,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,oHAAoH,MAAM,EAAE,CAC1K,CAAA;AACH,CAAC"}

package/dist/profile-store-env.test.d.ts

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

package/dist/profile-store-env.test.d.ts.map

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

package/dist/profile-store-env.test.js

@@ -1,69 +0,0 @@
-import { mkdtemp } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import path from "node:path";
-import { describe, expect, it, vi } from "vitest";
-import { announcePersistence, persistenceFromEnv, profileStoreFromEnv, } from "./profile-store-env.js";
-describe("persistenceFromEnv", () => {
-    it("reports the non-database selection per store", () => {
-        expect(persistenceFromEnv({})).toEqual({ profiles: "memory", dashboards: "memory" });
-        expect(persistenceFromEnv({ MCP_PROFILE_DIR: "/p", MCP_DASHBOARD_DIR: "/d" })).toEqual({
-            profiles: "filesystem",
-            dashboards: "filesystem",
-        });
-    });
-});
-describe("announcePersistence", () => {
-    const capture = () => ({
-        log: vi.spyOn(console, "log").mockImplementation(() => { }),
-        warn: vi.spyOn(console, "warn").mockImplementation(() => { }),
-    });
-    it("logs the selected backends on every path", () => {
-        const { log, warn } = capture();
-        announcePersistence({ profiles: "postgres", dashboards: "postgres" }, { env: { NODE_ENV: "production" }, label: "root" });
-        expect(log).toHaveBeenCalledWith("[root] persistence: profiles=postgres, dashboards=postgres");
-        expect(warn).not.toHaveBeenCalled();
-        vi.restoreAllMocks();
-    });
-    it("warns LOUDLY when a production process keeps a store in memory — naming each", () => {
-        const { warn } = capture();
-        announcePersistence({ profiles: "memory", dashboards: "memory" }, { env: { NODE_ENV: "production" }, label: "root", remedy: "Set DATABASE_URL." });
-        expect(warn).toHaveBeenCalledOnce();
-        expect(warn.mock.calls[0][0]).toBe("[root] WARNING: user profiles and saved dashboards are kept IN MEMORY in a production process — every restart, redeploy or scale-to-zero stop silently drops them. Set DATABASE_URL.");
-        announcePersistence({ profiles: "filesystem", dashboards: "memory" }, { env: { NODE_ENV: "production" } });
-        expect(warn.mock.calls[1][0]).toMatch(/^\[persistence\] WARNING: saved dashboards are kept/);
-        expect(warn.mock.calls[1][0]).toContain("MCP_PROFILE_DIR / MCP_DASHBOARD_DIR");
-        vi.restoreAllMocks();
-    });
-    it("leaves dashboards out entirely when the server keeps none", () => {
-        const { log, warn } = capture();
-        announcePersistence({ profiles: "memory" }, { env: { NODE_ENV: "production" } });
-        expect(log).toHaveBeenCalledWith("[persistence] persistence: profiles=memory");
-        expect(warn.mock.calls[0][0]).toMatch(/WARNING: user profiles are kept IN MEMORY/);
-        announcePersistence({ profiles: "filesystem" }, { env: { NODE_ENV: "production" } });
-        expect(warn).toHaveBeenCalledOnce();
-        vi.restoreAllMocks();
-    });
-    it("stays quiet outside production (dev, tests)", () => {
-        const { warn } = capture();
-        announcePersistence({ profiles: "memory", dashboards: "memory" }, { env: {} });
-        announcePersistence({ profiles: "memory", dashboards: "memory" }, { env: { NODE_ENV: "development" } });
-        expect(warn).not.toHaveBeenCalled();
-        vi.restoreAllMocks();
-    });
-});
-describe("profileStoreFromEnv", () => {
-    it("selects the filesystem store when MCP_PROFILE_DIR is set (records persist)", async () => {
-        const dir = await mkdtemp(path.join(tmpdir(), "profile-env-"));
-        const store = profileStoreFromEnv({ MCP_PROFILE_DIR: dir });
-        await store.save("user-1", { language: "de" });
-        // A SECOND store over the same dir sees the record — proof it hit disk.
-        expect((await profileStoreFromEnv({ MCP_PROFILE_DIR: dir }).get("user-1"))?.language).toBe("de");
-    });
-    it("falls back to the in-memory store without the env knob", async () => {
-        const store = profileStoreFromEnv({});
-        await store.save("user-1", { language: "de" });
-        // A second instance shares nothing — proof it stayed in-process.
-        expect(await profileStoreFromEnv({}).get("user-1")).toBeUndefined();
-    });
-});
-//# sourceMappingURL=profile-store-env.test.js.map

package/dist/profile-store-env.test.js.map

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

package/dist/profile-store-postgres.d.ts

@@ -1,33 +0,0 @@
-import type postgres from "postgres";
-import { type ProfileStore } from "./profile-store.js";
-/**
- * DDL owned by this store, executed by the composition root's migration runner
- * (which tracks applied names in its `schema_migrations` table). The full
- * profile record lives in one JSONB column — it is tiny (<1 KB) and its shape
- * is governed by `profileRecordSchema`/`schemaVersion`, not by table columns.
- * `user_id` mirrors the record's owner (the OAuth caller; NULL for the
- * declared `anonymous` record).
- */
-export declare const PROFILE_STORE_MIGRATIONS: ReadonlyArray<{
-    name: string;
-    statements: readonly string[];
-}>;
-/**
- * Profiles stored one row per key in the `user_profiles` table. Selected when
- * `DATABASE_URL` is set (see the composition root's persistence wiring); the
- * caller owns the `sql` client's lifecycle, so this package carries no runtime
- * dependency on the driver.
- *
- * Reads share the filesystem store's per-field fail-soft gate
- * (`parseStoredProfile`): a value this build cannot validate degrades only its
- * own field, and a newer build's row reads best-effort. Saves run the shared
- * `mergeStoredProfile` over the RAW JSONB inside a per-key locked
- * transaction, so concurrent partial updates of the same key serialize
- * instead of losing fields, and nothing a newer replica wrote is dropped —
- * safe for multiple server instances (and mixed versions) sharing one
- * database.
- */
-export declare function createPostgresProfileStore(options: {
-    sql: postgres.Sql;
-}): ProfileStore;
-//# sourceMappingURL=profile-store-postgres.d.ts.map

package/dist/profile-store-postgres.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"profile-store-postgres.d.ts","sourceRoot":"","sources":["../src/profile-store-postgres.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAA;AAEpC,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAE1E;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9B,CAYA,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAA;CAAE,GAAG,YAAY,CAsDvF"}

package/dist/profile-store-postgres.js

@@ -1,87 +0,0 @@
-import { parseStoredProfile } from "./profile-migrations.js";
-import { mergeStoredProfile } from "./profile-store.js";
-/**
- * DDL owned by this store, executed by the composition root's migration runner
- * (which tracks applied names in its `schema_migrations` table). The full
- * profile record lives in one JSONB column — it is tiny (<1 KB) and its shape
- * is governed by `profileRecordSchema`/`schemaVersion`, not by table columns.
- * `user_id` mirrors the record's owner (the OAuth caller; NULL for the
- * declared `anonymous` record).
- */
-export const PROFILE_STORE_MIGRATIONS = [
-    {
-        name: "001_user_profiles",
-        statements: [
-            `CREATE TABLE IF NOT EXISTS user_profiles (
-        key TEXT PRIMARY KEY,
-        user_id TEXT,
-        profile JSONB NOT NULL,
-        updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
-      )`,
-        ],
-    },
-];
-/**
- * Profiles stored one row per key in the `user_profiles` table. Selected when
- * `DATABASE_URL` is set (see the composition root's persistence wiring); the
- * caller owns the `sql` client's lifecycle, so this package carries no runtime
- * dependency on the driver.
- *
- * Reads share the filesystem store's per-field fail-soft gate
- * (`parseStoredProfile`): a value this build cannot validate degrades only its
- * own field, and a newer build's row reads best-effort. Saves run the shared
- * `mergeStoredProfile` over the RAW JSONB inside a per-key locked
- * transaction, so concurrent partial updates of the same key serialize
- * instead of losing fields, and nothing a newer replica wrote is dropped —
- * safe for multiple server instances (and mixed versions) sharing one
- * database.
- */
-export function createPostgresProfileStore(options) {
-    const { sql } = options;
-    return {
-        async get(key) {
-            const rows = await sql `
-        SELECT profile FROM user_profiles WHERE key = ${key}
-      `;
-            return parseStoredProfile(rows[0]?.profile, key);
-        },
-        async save(key, input, opts) {
-            return await sql.begin(async (tx) => {
-                // Advisory lock, not just SELECT…FOR UPDATE: a row that doesn't exist
-                // yet cannot be row-locked, so two concurrent FIRST saves of the same
-                // key would otherwise both merge over defaults and the second upsert
-                // would silently drop the first one's fields. The per-key transaction
-                // lock serializes creates and updates alike (same primitive as the
-                // app's migration runner).
-                await tx `SELECT pg_advisory_xact_lock(hashtextextended('user_profiles:' || ${key}, 0))`;
-                const rows = await tx `
-          SELECT profile FROM user_profiles WHERE key = ${key} FOR UPDATE
-        `;
-                const { document, record } = mergeStoredProfile(key, rows[0]?.profile, input, new Date().toISOString(), opts);
-                // sql.json, not JSON.stringify: postgres.js serializes parameters by
-                // the server-described type, and the jsonb serializer stringifies
-                // itself — a pre-stringified value gets double-encoded into a jsonb
-                // string scalar.
-                await tx `
-          INSERT INTO user_profiles (key, user_id, profile, updated_at)
-          VALUES (
-            ${key},
-            ${record.userId ?? null},
-            ${tx.json(document)},
-            ${record.updatedAt}
-          )
-          ON CONFLICT (key) DO UPDATE SET
-            user_id = EXCLUDED.user_id,
-            profile = EXCLUDED.profile,
-            updated_at = EXCLUDED.updated_at
-        `;
-                return record;
-            });
-        },
-        async delete(key) {
-            const result = await sql `DELETE FROM user_profiles WHERE key = ${key}`;
-            return result.count > 0;
-        },
-    };
-}
-//# sourceMappingURL=profile-store-postgres.js.map

package/dist/profile-store-postgres.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"profile-store-postgres.js","sourceRoot":"","sources":["../src/profile-store-postgres.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,kBAAkB,EAAqB,MAAM,oBAAoB,CAAA;AAE1E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAGhC;IACH;QACE,IAAI,EAAE,mBAAmB;QACzB,UAAU,EAAE;YACV;;;;;QAKE;SACH;KACF;CACF,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAA8B;IACvE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAA;IAEvB,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,GAAG;YACX,MAAM,IAAI,GAAG,MAAM,GAAG,CAAwB;wDACI,GAAG;OACpD,CAAA;YACD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;QAClD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI;YACzB,OAAO,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;gBAClC,sEAAsE;gBACtE,sEAAsE;gBACtE,qEAAqE;gBACrE,sEAAsE;gBACtE,mEAAmE;gBACnE,2BAA2B;gBAC3B,MAAM,EAAE,CAAA,qEAAqE,GAAG,OAAO,CAAA;gBACvF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAwB;0DACK,GAAG;SACpD,CAAA;gBACD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAC7C,GAAG,EACH,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAChB,KAAK,EACL,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EACxB,IAAI,CACL,CAAA;gBACD,qEAAqE;gBACrE,kEAAkE;gBAClE,oEAAoE;gBACpE,iBAAiB;gBACjB,MAAM,EAAE,CAAA;;;cAGF,GAAG;cACH,MAAM,CAAC,MAAM,IAAI,IAAI;cACrB,EAAE,CAAC,IAAI,CAAC,QAA8B,CAAC;cACvC,MAAM,CAAC,SAAS;;;;;;SAMrB,CAAA;gBACD,OAAO,MAAM,CAAA;YACf,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,MAAM,MAAM,GAAG,MAAM,GAAG,CAAA,yCAAyC,GAAG,EAAE,CAAA;YACtE,OAAO,MAAM,CAAC,KAAK,GAAG,CAAC,CAAA;QACzB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/profile-store-raw.test.d.ts

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

package/dist/profile-store-raw.test.d.ts.map

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

package/dist/profile-store-raw.test.js

@@ -1,185 +0,0 @@
-import { mkdtemp, readFile, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import path from "node:path";
-import postgres from "postgres";
-import { afterAll, beforeAll, beforeEach, describe, expect, it } from "vitest";
-import { createFileSystemProfileStore, mergeStoredProfile, } from "./profile-store.js";
-import { createPostgresProfileStore, PROFILE_STORE_MIGRATIONS } from "./profile-store-postgres.js";
-import { saveModuleSlice } from "./profile-slice.js";
-/**
- * Saves merge over the RAW stored document, never over its parsed view — the
- * guard against one unknown value (or one newer build's record) wiping every
- * module's settings on the next save. The store-agnostic behavior contract
- * lives in `profile-store.test.ts`.
- */
-describe("mergeStoredProfile", () => {
-    const NOW = "2026-10-09T12:00:00.000Z";
-    it("returns the document to persist (raw keys kept) and its typed view", () => {
-        const { document, record } = mergeStoredProfile("k", {
-            id: "k",
-            language: "fr",
-            theme: "dark",
-            extra: 1,
-            schemaVersion: 3,
-            createdAt: "c",
-            updatedAt: "u",
-        }, { modules: { notes: { sortOrder: "asc" } } }, NOW);
-        // The retired theme preference is just another raw key: kept, never read.
-        expect(document).toEqual({
-            id: "k",
-            language: "fr",
-            theme: "dark",
-            extra: 1,
-            modules: { notes: { sortOrder: "asc" } },
-            userId: undefined,
-            createdAt: "c",
-            updatedAt: NOW,
-            schemaVersion: 3,
-        });
-        expect(record).toEqual({
-            id: "k",
-            language: "system",
-            modules: { notes: { sortOrder: "asc" } },
-            createdAt: "c",
-            updatedAt: NOW,
-            schemaVersion: 3,
-        });
-    });
-    it("stamps createdAt on a document that carries none, and adopts a pre-baseline one", () => {
-        const { document, record } = mergeStoredProfile("k", { analyticsDefaultPeriod: "30d", schemaVersion: 1 }, {}, NOW);
-        // Adopted at the baseline: the unknown flat key stays raw, out of the view.
-        expect(document).toMatchObject({
-            createdAt: NOW,
-            schemaVersion: 3,
-            modules: {},
-            analyticsDefaultPeriod: "30d",
-        });
-        expect(record.modules).toEqual({});
-    });
-    it("starts a never-saved key from the defaults", () => {
-        const { record } = mergeStoredProfile("k", undefined, { language: "de" }, NOW, {
-            userId: "u-1",
-        });
-        expect(record).toMatchObject({ id: "k", language: "de", modules: {}, userId: "u-1" });
-    });
-});
-function rawDocumentContract(makeHarness) {
-    const STORED = {
-        id: "user-1",
-        userId: "user-1",
-        language: "fr", // a locale this build does not ship
-        theme: "dark", // the retired theme preference an earlier build saved
-        futureTopLevel: { nested: true },
-        modules: {
-            camunda7: { defaultEngineId: "prod-a", futureSliceField: 7 },
-            analytics: { defaultPeriod: "30d" },
-            notes: { sortOrder: "asc" },
-        },
-        createdAt: "2026-01-01T00:00:00.000Z",
-        updatedAt: "2026-01-02T00:00:00.000Z",
-        schemaVersion: 3,
-    };
-    it("reads a document with one unknown value field by field — only that field degrades", async () => {
-        const { store, seedRaw } = await makeHarness();
-        await seedRaw("user-1", STORED);
-        expect(await store.get("user-1")).toEqual({
-            id: "user-1",
-            userId: "user-1",
-            language: "system",
-            modules: STORED.modules,
-            createdAt: STORED.createdAt,
-            updatedAt: STORED.updatedAt,
-            schemaVersion: 3,
-        });
-    });
-    it("round-trips unknown top-level keys and values through a save from ANY module", async () => {
-        const { store, seedRaw, readRaw } = await makeHarness();
-        await seedRaw("user-1", STORED);
-        // The analytics settings save path, end to end.
-        const slice = await saveModuleSlice(store, "user-1", "analytics", { minBucketSize: 25 }, { userId: "user-1" });
-        const modules = { ...STORED.modules, analytics: { defaultPeriod: "30d", minBucketSize: 25 } };
-        expect(slice).toEqual(modules.analytics);
-        const saved = await store.get("user-1");
-        expect(saved?.modules).toEqual(modules);
-        expect(saved?.createdAt).toBe(STORED.createdAt);
-        expect(await readRaw("user-1")).toEqual({ ...STORED, modules, updatedAt: saved?.updatedAt });
-    });
-    it("never mangles a document from a NEWER build (rolling-deploy skew)", async () => {
-        const { store, seedRaw, readRaw } = await makeHarness();
-        const newer = {
-            ...STORED,
-            language: "de",
-            schemaVersion: 99,
-            newCoreField: ["written", "by", "v99"],
-        };
-        await seedRaw("user-1", newer);
-        // Read best-effort: every field this build still understands survives.
-        expect(await store.get("user-1")).toMatchObject({
-            language: "de",
-            modules: STORED.modules,
-        });
-        const saved = await store.save("user-1", { language: "en" });
-        expect(saved).toMatchObject({ language: "en", modules: STORED.modules });
-        // Never stamped down to this build's version: the newer build reads its
-        // own document back without re-running migrations over it.
-        expect(await readRaw("user-1")).toEqual({
-            ...newer,
-            language: "en",
-            updatedAt: saved.updatedAt,
-        });
-    });
-}
-describe("createFileSystemProfileStore (raw documents)", () => {
-    rawDocumentContract(async () => {
-        const dir = await mkdtemp(path.join(tmpdir(), "profile-store-raw-"));
-        const file = (key) => path.join(dir, `${encodeURIComponent(key)}.json`);
-        return {
-            store: createFileSystemProfileStore({ dir }),
-            seedRaw: (key, doc) => writeFile(file(key), JSON.stringify(doc), "utf-8"),
-            readRaw: async (key) => JSON.parse(await readFile(file(key), "utf-8")),
-        };
-    });
-});
-// Opt-in integration slice: only with TEST_DATABASE_URL (`pnpm test:pg`). An
-// own schema isolates it from the other suites sharing that database.
-const TEST_DATABASE_URL = process.env.TEST_DATABASE_URL;
-const TEST_SCHEMA = "widget_shell_profile_store_raw_test";
-describe.skipIf(!TEST_DATABASE_URL)("createPostgresProfileStore (raw documents)", () => {
-    let sql;
-    beforeAll(async () => {
-        sql = postgres(TEST_DATABASE_URL, {
-            max: 2,
-            onnotice: () => { },
-            connection: { search_path: TEST_SCHEMA },
-        });
-        await sql.unsafe(`DROP SCHEMA IF EXISTS ${TEST_SCHEMA} CASCADE`);
-        await sql.unsafe(`CREATE SCHEMA ${TEST_SCHEMA}`);
-        for (const migration of PROFILE_STORE_MIGRATIONS) {
-            for (const statement of migration.statements) {
-                await sql.unsafe(statement);
-            }
-        }
-    });
-    beforeEach(async () => {
-        await sql `DELETE FROM user_profiles`;
-    });
-    afterAll(async () => {
-        await sql.end({ timeout: 5 });
-    });
-    rawDocumentContract(() => Promise.resolve({
-        store: createPostgresProfileStore({ sql }),
-        seedRaw: async (key, doc) => {
-            await sql `
-          INSERT INTO user_profiles (key, profile)
-          VALUES (${key}, ${sql.json(doc)})
-        `;
-        },
-        readRaw: async (key) => {
-            const rows = await sql `
-          SELECT profile FROM user_profiles WHERE key = ${key}
-        `;
-            return rows[0]?.profile;
-        },
-    }));
-});
-//# sourceMappingURL=profile-store-raw.test.js.map

package/dist/profile-store-raw.test.js.map

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

package/dist/profile-store.d.ts

@@ -1,85 +0,0 @@
-import { type ProfileRecord, type ProfileRecordSaveInput } from "./profile-record.js";
-/**
- * Persistence for user profiles, keyed by the profile key (the OAuth caller's
- * id, or `anonymous` for an explicitly declared local caller — see
- * `resolveProfileKey` in `profile.ts`). Deliberately mirrors the
- * toolkit's `DashboardStore` shape: an in-memory default plus a
- * one-file-per-record filesystem store selected by an env var (and a postgres
- * implementation in `profile-store-postgres.ts` selected by `DATABASE_URL` in
- * the composition root). There is no cross-key ownership model — each key owns
- * exactly its own record; the auth layer keeps unrelated callers on different
- * keys.
- *
- * The full store interface is for COMPOSITION ROOTS (apps wiring
- * `SharedResources`); modules consume the narrow {@link ProfileSource} port
- * instead — which this interface satisfies structurally.
- */
-export interface ProfileStore {
-    /**
-     * The typed view of the stored record (`parseStoredProfile`): per-field
-     * fail-soft, so an unknown value degrades only its own field and a newer
-     * build's record reads best-effort; `undefined` when nothing is stored.
-     */
-    get(key: string): Promise<ProfileRecord | undefined>;
-    /**
-     * Merge `input` over the RAW stored record (or defaults) — atomically per
-     * key, so concurrent saves of disjoint fields or module slices all survive
-     * ({@link mergeStoredProfile}); stamps `updatedAt`. `opts.userId` (the
-     * authenticated caller, when known) is stamped as the record's owner.
-     */
-    save(key: string, input: ProfileRecordSaveInput, opts?: ProfileSaveOptions): Promise<ProfileRecord>;
-    delete(key: string): Promise<boolean>;
-}
-export interface ProfileSaveOptions {
-    /** The authenticated caller, stamped as the record's owner (absent for `anonymous`). */
-    userId?: string;
-}
-/** The outcome of {@link mergeStoredProfile}: what to persist, and what to return. */
-export interface MergedProfile {
-    /**
-     * The complete document to persist: the RAW stored JSON — keys this build
-     * does not know and values it cannot validate included — with the save
-     * applied on top.
-     */
-    document: Record<string, unknown>;
-    /** The typed view of `document` — what a store's `save` returns. */
-    record: ProfileRecord;
-}
-/**
- * Merge a partial save over the RAW stored document (or a fresh default),
- * preserving `id`/`userId`/`createdAt` and re-stamping `updatedAt`. Omitted
- * input fields keep their previous value so single-field updates don't wipe
- * the rest — and because the base is the stored JSON, not its parsed view,
- * nothing this build cannot read is dropped either: a locale a newer build
- * added, a top-level key it introduced, a whole newer-version document during
- * a rolling deploy (whose `schemaVersion` is never stamped down). Shared by
- * every store implementation (in-memory, filesystem, and the postgres sibling
- * in `profile-store-postgres.ts`), each calling it INSIDE its per-key
- * serialization, so the merge semantics stay single-sourced. Record-agnostic
- * on purpose — module-specific normalization (e.g. camunda7's "empty string
- * clears the field") happens at the owning module's save-tool boundary.
- */
-export declare function mergeStoredProfile(key: string, stored: unknown, input: ProfileRecordSaveInput, now: string, opts?: ProfileSaveOptions): MergedProfile;
-/**
- * Process-local store. The default when `MCP_PROFILE_DIR` is unset — fine for
- * dev and single-instance deployments; everything is lost on restart, and
- * behind a load balancer each replica sees its own records. Each save runs
- * synchronously inside one microtask, so saves of the same key never
- * interleave.
- */
-export declare function createInMemoryProfileStore(): ProfileStore;
-/**
- * Profiles stored as one JSON file per key under `dir` (`<encodeURIComponent
- * (key)>.json`). Selected when `MCP_PROFILE_DIR` is set so preferences survive
- * restarts. Every operation on a key runs under a per-key lock, so concurrent
- * saves of the same key (two settings sections, two modules' save tools in one
- * model turn) merge one after the other instead of last-write-wins; writes are
- * atomic (temp file + rename in the same directory), so a crash mid-write
- * can't truncate a record. The lock is process-local: the store is
- * SINGLE-WRITER — point one server process at a directory (the postgres store
- * is the multi-instance answer).
- */
-export declare function createFileSystemProfileStore(options: {
-    dir: string;
-}): ProfileStore;
-//# sourceMappingURL=profile-store.d.ts.map

package/dist/profile-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"profile-store.d.ts","sourceRoot":"","sources":["../src/profile-store.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAA;AAE5B;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAA;IACpD;;;;;OAKG;IACH,IAAI,CACF,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,sBAAsB,EAC7B,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,aAAa,CAAC,CAAA;IACzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAgCD,sFAAsF;AACtF,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,oEAAoE;IACpE,MAAM,EAAE,aAAa,CAAA;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,sBAAsB,EAC7B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,kBAAkB,GACxB,aAAa,CAwBf;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,YAAY,CAkBzD;AA8BD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAkDnF"}