simplycms 0.4.0

package/dist/i18n/translator.d.ts

@@ -0,0 +1,19 @@
+import type { Locale, MessageParams, Translator } from './types';
+/** `uk-UA` → `uk`, `EN` → `en`, невідома/порожня → `uk`. */
+export declare function normalizeLocale(input: string): Locale;
+/**
+ * Підстановка `{name}` значеннями з `params`; невідомий плейсхолдер лишається як є.
+ *
+ * 🔴 Експортована навмисно: `useThemeT` (`simplycms/themes`) підставляє
+ * параметри в каталог ТЕМИ за тією самою семантикою, і дублювати цю функцію
+ * там означало б два джерела правди для одного форматування.
+ */
+export declare function interpolate(template: string, params?: MessageParams): string;
+/**
+ * Створює транслятор під конкретну локаль.
+ *
+ * Транслятор — замикання без модульного mutable-стану: жодного `setLocale`.
+ * Тому SSR може тримати кілька трансляторів різних локалей одночасно
+ * (per-request), і вони не впливають один на одного.
+ */
+export declare function createTranslator(locale: Locale): Translator;

package/dist/i18n/types.d.ts

@@ -0,0 +1,14 @@
+import type { messages as ukMessages } from './catalogs/uk/index';
+/** Підтримувані локалі ядра. */
+export type Locale = 'uk' | 'en';
+/**
+ * Ключі повідомлень. Виводяться з українського каталогу — він повний, решта
+ * каталогів часткові, тож `keyof` саме uk дає замкнений і чесний union.
+ */
+export type MessageKey = keyof typeof ukMessages;
+/** Каталог перекладів: неповний за визначенням — решту добирає fallback на uk. */
+export type Catalog = Partial<Record<MessageKey, string>>;
+/** Параметри підстановки у плейсхолдери `{name}`. */
+export type MessageParams = Record<string, string | number>;
+/** Транслятор — чиста функція, створена під конкретну локаль. */
+export type Translator = (key: MessageKey, params?: MessageParams) => string;

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/plugin-sdk/definePlugin.d.ts

@@ -0,0 +1,9 @@
+import type { PluginDefinition, SdkPluginModule } from './types';
+/**
+ * Декларативний вхід автора плагіна (спека §7).
+ *
+ * Помилки контракту — виняток одразу, при імпорті модуля: автор бачить їх у
+ * dev-консолі першим же рендером, а в магазині `bootstrapPlugins` ловить
+ * throw у своєму try/catch і пропускає плагін, не валячи застосунок.
+ */
+export declare function definePlugin(definition: PluginDefinition): SdkPluginModule;

package/dist/plugin-sdk/index.d.ts

@@ -0,0 +1,6 @@
+export { definePlugin } from './definePlugin';
+export { validatePluginModule } from '../plugins/validatePluginModule';
+export { usePluginT } from './usePluginT';
+export { usePluginTable, type PluginTablePort } from './usePluginTable';
+export { usePluginConfig, type PluginConfigResult } from './usePluginConfig';
+export type { PluginDefinition, PluginMessages, SdkPluginModule, SlotComponent, } from './types';

package/dist/plugin-sdk/index.js

@@ -0,0 +1,266 @@
+import { createElement, useCallback, useMemo, useState, useEffect } from 'react';
+import { CORE_VERSION, satisfies } from 'simplycms/contracts/semver';
+import { useLocale, interpolate } from 'simplycms/i18n';
+import { pluginTableRemove, pluginTableUpdate, pluginTableInsert, pluginTableList, pluginConfigRead, pluginConfigWrite } from 'simplycms/plugin-sdk/server';
+
+// src/plugin-sdk/definePlugin.ts
+var NAME_RE = /^[a-z][a-z0-9-]*$/;
+function definePlugin(definition) {
+  const { name } = definition;
+  if (typeof name !== "string" || !NAME_RE.test(name)) {
+    throw new Error(
+      `[plugin-sdk] \u041D\u0435\u0432\u0430\u043B\u0456\u0434\u043D\u0435 \u0456\u043C\u02BC\u044F \u043F\u043B\u0430\u0433\u0456\u043D\u0430 "${name}": \u043E\u0447\u0456\u043A\u0443\u0454\u0442\u044C\u0441\u044F [a-z][a-z0-9-]* (\u0432\u043E\u043D\u043E \u0441\u0442\u0430\u0454 \u043A\u043B\u044E\u0447\u0435\u043C \u0443 \u0411\u0414, \u043F\u0440\u0435\u0444\u0456\u043A\u0441\u043E\u043C \u0442\u0430\u0431\u043B\u0438\u0446\u044C plg_* \u0456 \u043A\u043B\u044E\u0447\u0456\u0432 i18n)`
+    );
+  }
+  if (!definition.displayName || !definition.version) {
+    throw new Error(
+      `[plugin-sdk] "${name}": displayName \u0456 version \u043E\u0431\u043E\u0432\u02BC\u044F\u0437\u043A\u043E\u0432\u0456`
+    );
+  }
+  if (typeof definition.engines?.simplycms !== "string") {
+    throw new Error(
+      `[plugin-sdk] "${name}": engines.simplycms \u043E\u0431\u043E\u0432\u02BC\u044F\u0437\u043A\u043E\u0432\u0438\u0439 (\u0434\u0456\u0430\u043F\u0430\u0437\u043E\u043D \u0441\u0443\u043C\u0456\u0441\u043D\u043E\u0441\u0442\u0456 \u0437 \u044F\u0434\u0440\u043E\u043C, \u0441\u043F\u0435\u043A\u0430 \xA77)`
+    );
+  }
+  const slotNames = Object.keys(definition.slots ?? {});
+  const hookNames = Object.keys(definition.hooks ?? {});
+  const collision = slotNames.find((slot) => hookNames.includes(slot));
+  if (collision) {
+    throw new Error(
+      `[plugin-sdk] "${name}": "${collision}" \u043E\u0433\u043E\u043B\u043E\u0448\u0435\u043D\u043E \u0456 \u0432 slots, \u0456 \u0432 hooks`
+    );
+  }
+  const manifest = {
+    name,
+    displayName: definition.displayName,
+    version: definition.version,
+    description: definition.description,
+    author: definition.author,
+    engines: definition.engines,
+    hooks: [...slotNames, ...hookNames].map((hookName) => ({ name: hookName })),
+    migrations: definition.migrations,
+    edgeFunctions: definition.edgeFunctions,
+    buckets: definition.buckets
+  };
+  return {
+    manifest,
+    definition,
+    messages: definition.messages,
+    register(registry) {
+      for (const [slot, Component] of Object.entries(definition.slots ?? {})) {
+        registry.register(
+          slot,
+          name,
+          (context) => createElement(Component, { key: `${name}:${slot}`, context })
+        );
+      }
+      for (const [hook, handler] of Object.entries(definition.hooks ?? {})) {
+        registry.register(hook, name, handler);
+      }
+    },
+    unregister(registry) {
+      for (const hookName of [...slotNames, ...hookNames]) {
+        registry.unregister(hookName, name);
+      }
+    }
+  };
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function validatePluginModule(value, coreVersion = CORE_VERSION) {
+  if (!isRecord(value) || typeof value.register !== "function") {
+    throw new Error(
+      "[plugin] \u043C\u043E\u0434\u0443\u043B\u044C \u043D\u0435 \u043C\u0430\u0454 register(registry) \u2014 \u0446\u0435 \u043D\u0435 PluginModule"
+    );
+  }
+  const manifest = value.manifest;
+  if (manifest === void 0) {
+    console.warn(
+      "[plugin] \u043C\u043E\u0434\u0443\u043B\u044C \u0431\u0435\u0437 manifest \u2014 \u043C\u0435\u0442\u0430\u0434\u0430\u043D\u0456 \u0432 \u0411\u0414 \u043F\u0456\u0434\u0443\u0442\u044C \u0434\u0435\u0444\u043E\u043B\u0442\u0430\u043C\u0438 (0.0.0)"
+    );
+    return;
+  }
+  if (!isRecord(manifest)) {
+    throw new Error("[plugin] manifest \u043D\u0435 \u0454 \u043E\u0431\u02BC\u0454\u043A\u0442\u043E\u043C");
+  }
+  for (const field of ["name", "displayName", "version"]) {
+    if (typeof manifest[field] !== "string" || manifest[field] === "") {
+      throw new Error(`[plugin] manifest.${field} \u2014 \u043E\u0431\u043E\u0432\u02BC\u044F\u0437\u043A\u043E\u0432\u0438\u0439 \u0440\u044F\u0434\u043E\u043A`);
+    }
+  }
+  const name = manifest.name;
+  const engines = manifest.engines;
+  if (engines === void 0) {
+    console.warn(
+      `[plugin] "${name}": engines.simplycms \u0432\u0456\u0434\u0441\u0443\u0442\u043D\u0456\u0439 \u2014 \u0441\u0443\u043C\u0456\u0441\u043D\u0456\u0441\u0442\u044C \u0456\u0437 \u044F\u0434\u0440\u043E\u043C \u043D\u0435 \u0434\u0435\u043A\u043B\u0430\u0440\u043E\u0432\u0430\u043D\u0430`
+    );
+  } else if (!isRecord(engines) || typeof engines.simplycms !== "string") {
+    throw new Error(
+      `[plugin] "${name}": manifest.engines.simplycms \u043C\u0430\u0454 \u0431\u0443\u0442\u0438 \u0440\u044F\u0434\u043A\u043E\u043C-\u0434\u0456\u0430\u043F\u0430\u0437\u043E\u043D\u043E\u043C`
+    );
+  } else {
+    try {
+      if (!satisfies(coreVersion, engines.simplycms)) {
+        console.warn(
+          `[plugin] "${name}": engines.simplycms "${engines.simplycms}" \u043D\u0435 \u043F\u043E\u043A\u0440\u0438\u0432\u0430\u0454 \u044F\u0434\u0440\u043E ${coreVersion} \u2014 \u043F\u043B\u0430\u0433\u0456\u043D \u043C\u043E\u0436\u0435 \u0431\u0443\u0442\u0438 \u043D\u0435\u0441\u0443\u043C\u0456\u0441\u043D\u0438\u043C`
+        );
+      }
+    } catch (error) {
+      console.warn(
+        `[plugin] "${name}": engines.simplycms \u043D\u0435 \u0440\u043E\u0437\u043F\u0430\u0440\u0441\u0438\u0432\u0441\u044F: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  const messages = value.messages ?? value.definition?.messages;
+  if (messages !== void 0) {
+    if (!isRecord(messages)) {
+      throw new Error(
+        `[plugin] "${name}": messages \u043C\u0430\u0454 \u0431\u0443\u0442\u0438 Partial<Record<Locale, Record<string, string>>>`
+      );
+    }
+    const prefix = `plugin.${name}.`;
+    for (const [locale, catalog] of Object.entries(messages)) {
+      if (!isRecord(catalog)) {
+        throw new Error(
+          `[plugin] "${name}": messages.${locale} \u043C\u0430\u0454 \u0431\u0443\u0442\u0438 Record<string, string>`
+        );
+      }
+      for (const [key, text] of Object.entries(catalog)) {
+        if (typeof text !== "string") {
+          throw new Error(
+            `[plugin] "${name}": messages.${locale}.${key} \u043C\u0430\u0454 \u0431\u0443\u0442\u0438 \u0440\u044F\u0434\u043A\u043E\u043C`
+          );
+        }
+        if (!key.startsWith(prefix)) {
+          console.warn(
+            `[plugin] "${name}": \u043A\u043B\u044E\u0447 "${key}" \u0431\u0435\u0437 \u043F\u0440\u0435\u0444\u0456\u043A\u0441\u0430 "${prefix}" \u2014 \u0440\u0438\u0437\u0438\u043A \u043A\u043E\u043B\u0456\u0437\u0456\u0457 \u0437 MessageKey \u044F\u0434\u0440\u0430 \u0447\u0438 \u0456\u043D\u0448\u0438\u043C \u043F\u043B\u0430\u0433\u0456\u043D\u043E\u043C`
+          );
+        }
+      }
+    }
+  }
+  const settings = value.definition?.settings;
+  if (settings !== void 0 && (!isRecord(settings) || typeof settings.safeParse !== "function")) {
+    throw new Error(
+      `[plugin] "${name}": definition.settings \u043C\u0430\u0454 \u0431\u0443\u0442\u0438 Zod-\u0441\u0445\u0435\u043C\u043E\u044E (z.object)`
+    );
+  }
+}
+function usePluginT(messages) {
+  const locale = useLocale();
+  return useCallback(
+    (key, params) => {
+      const template = messages?.[locale]?.[key] ?? messages?.uk?.[key] ?? key;
+      return interpolate(template, params);
+    },
+    [messages, locale]
+  );
+}
+function toCells(row) {
+  return Object.fromEntries(
+    Object.entries(row).map(([column, value]) => [
+      column,
+      value ?? null
+    ])
+  );
+}
+function usePluginTable(pluginName, table) {
+  return useMemo(
+    () => ({
+      async list(options) {
+        const rows = await pluginTableList({
+          data: {
+            plugin: pluginName,
+            table,
+            eq: options?.eq ? toCells(options.eq) : void 0,
+            orderBy: options?.orderBy,
+            ascending: options?.ascending
+          }
+        });
+        return rows;
+      },
+      async insert(row) {
+        const created = await pluginTableInsert({
+          data: { plugin: pluginName, table, row: toCells(row) }
+        });
+        return created;
+      },
+      async update(id, patch) {
+        const updated = await pluginTableUpdate({
+          data: { plugin: pluginName, table, id, patch: toCells(patch) }
+        });
+        return updated;
+      },
+      async remove(id) {
+        await pluginTableRemove({ data: { plugin: pluginName, table, id } });
+      }
+    }),
+    [pluginName, table]
+  );
+}
+function usePluginConfig(pluginName, schema) {
+  const [raw, setRaw] = useState(void 0);
+  const [loading, setLoading] = useState(true);
+  useEffect(() => {
+    let cancelled = false;
+    (async () => {
+      try {
+        const result = await pluginConfigRead({ data: { plugin: pluginName } });
+        if (cancelled) return;
+        if (!result.found) {
+          console.warn(
+            `[plugin-sdk] usePluginConfig("${pluginName}"): \u0440\u044F\u0434\u043A\u0430 plugins \u0456\u0437 \u0442\u0430\u043A\u0438\u043C name \u043D\u0435\u043C\u0430\u0454 \u2014 \u0432\u0456\u0434\u0434\u0430\u044E \u0434\u0435\u0444\u043E\u043B\u0442\u0438 \u0441\u0445\u0435\u043C\u0438`
+          );
+        }
+        setRaw(result.config ?? {});
+      } catch (error) {
+        if (cancelled) return;
+        console.warn(`[plugin-sdk] usePluginConfig("${pluginName}"):`, error);
+        setRaw({});
+      } finally {
+        if (!cancelled) setLoading(false);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [pluginName]);
+  const config = useMemo(() => {
+    if (loading) return null;
+    const parsed = schema.safeParse(raw ?? {});
+    if (parsed.success) return parsed.data;
+    console.warn(
+      `[plugin-sdk] usePluginConfig("${pluginName}"): config \u043D\u0435 \u043F\u0440\u043E\u0439\u0448\u043E\u0432 \u0441\u0445\u0435\u043C\u0443 \u2014 \u0434\u0435\u0444\u043E\u043B\u0442\u0438`
+    );
+    const fallback = schema.safeParse({});
+    return fallback.success ? fallback.data : null;
+  }, [loading, raw, schema, pluginName]);
+  const save = useCallback(
+    async (next) => {
+      const parsed = schema.safeParse(next);
+      if (!parsed.success) {
+        console.warn(
+          `[plugin-sdk] usePluginConfig("${pluginName}"): save \u0432\u0456\u0434\u0445\u0438\u043B\u0435\u043D\u043E \u0441\u0445\u0435\u043C\u043E\u044E`
+        );
+        return false;
+      }
+      const written = await pluginConfigWrite({
+        data: {
+          plugin: pluginName,
+          // Значення вже пройшло схему плагіна — далі його форму описує
+          // тільки JSON, бо саме ним воно їде на сервер.
+          config: parsed.data
+        }
+      });
+      if (written) setRaw(parsed.data);
+      return written;
+    },
+    [pluginName, schema]
+  );
+  return { config, loading, save };
+}
+
+export { definePlugin, usePluginConfig, usePluginT, usePluginTable, validatePluginModule };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/plugin-sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/plugin-sdk/definePlugin.ts","../../src/plugins/validatePluginModule.ts","../../src/plugin-sdk/usePluginT.ts","../../src/plugin-sdk/usePluginTable.ts","../../src/plugin-sdk/usePluginConfig.ts"],"names":["useMemo","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["import { createElement } from 'react';\nimport type { PluginManifest } from 'simplycms/plugins/types';\nimport type { PluginDefinition, SdkPluginModule } from './types';\n\nconst NAME_RE = /^[a-z][a-z0-9-]*$/;\n\n/**\n * Декларативний вхід автора плагіна (спека §7).\n *\n * Помилки контракту — виняток одразу, при імпорті модуля: автор бачить їх у\n * dev-консолі першим же рендером, а в магазині `bootstrapPlugins` ловить\n * throw у своєму try/catch і пропускає плагін, не валячи застосунок.\n */\nexport function definePlugin(definition: PluginDefinition): SdkPluginModule {\n  const { name } = definition;\n  // Явна перевірка типу: RegExp.test коерсить undefined у рядок 'undefined',\n  // який... проходить [a-z][a-z0-9-]* (знахідка рев'ю Фази 3).\n  if (typeof name !== 'string' || !NAME_RE.test(name)) {\n    throw new Error(\n      `[plugin-sdk] Невалідне імʼя плагіна \"${name}\": очікується [a-z][a-z0-9-]* ` +\n        `(воно стає ключем у БД, префіксом таблиць plg_* і ключів i18n)`,\n    );\n  }\n  if (!definition.displayName || !definition.version) {\n    throw new Error(\n      `[plugin-sdk] \"${name}\": displayName і version обовʼязкові`,\n    );\n  }\n  if (typeof definition.engines?.simplycms !== 'string') {\n    throw new Error(\n      `[plugin-sdk] \"${name}\": engines.simplycms обовʼязковий ` +\n        `(діапазон сумісності з ядром, спека §7)`,\n    );\n  }\n\n  const slotNames = Object.keys(definition.slots ?? {});\n  const hookNames = Object.keys(definition.hooks ?? {});\n  const collision = slotNames.find((slot) => hookNames.includes(slot));\n  if (collision) {\n    // HookRegistry тримає один запис на пару (hook, plugin) — другий\n    // register мовчки замінив би перший, тому колізія — помилка контракту.\n    throw new Error(\n      `[plugin-sdk] \"${name}\": \"${collision}\" оголошено і в slots, і в hooks`,\n    );\n  }\n\n  const manifest: PluginManifest = {\n    name,\n    displayName: definition.displayName,\n    version: definition.version,\n    description: definition.description,\n    author: definition.author,\n    engines: definition.engines,\n    hooks: [...slotNames, ...hookNames].map((hookName) => ({ name: hookName })),\n    migrations: definition.migrations,\n    edgeFunctions: definition.edgeFunctions,\n    buckets: definition.buckets,\n  };\n\n  return {\n    manifest,\n    definition,\n    messages: definition.messages,\n    register(registry) {\n      for (const [slot, Component] of Object.entries(definition.slots ?? {})) {\n        registry.register(slot, name, (context: unknown) =>\n          createElement(Component, { key: `${name}:${slot}`, context }),\n        );\n      }\n      for (const [hook, handler] of Object.entries(definition.hooks ?? {})) {\n        registry.register(hook, name, handler);\n      }\n    },\n    unregister(registry) {\n      for (const hookName of [...slotNames, ...hookNames]) {\n        registry.unregister(hookName, name);\n      }\n    },\n  };\n}\n","import { CORE_VERSION, satisfies } from 'simplycms/contracts/semver';\nimport type { PluginModule } from './types';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\n/**\n * Pure-валідатор модуля плагіна — той самий ідіом, що `validateThemeModule`:\n * порушення контракту — `throw` (діагностика для АВТОРА плагіна),\n * підозри — `console.warn`. Живе тут, а не в plugin-sdk, бо його кличе\n * `bootstrapPlugins`; SDK лише реекспортує.\n *\n * Мʼяку політику спеки §8 («ніяких падінь») забезпечує ВИКЛИКАЧ: bootstrap\n * ловить throw і пропускає модуль, не валячи застосунок. Несумісний\n * `engines.simplycms` — НЕ помилка, а попередження (рішення Р5 плану Фази 3:\n * warn-режим на 0.x; строгий фейл — політика реліз-потяга v1.0).\n */\nexport function validatePluginModule(\n  value: unknown,\n  coreVersion: string = CORE_VERSION,\n): asserts value is PluginModule {\n  if (!isRecord(value) || typeof value.register !== 'function') {\n    throw new Error(\n      '[plugin] модуль не має register(registry) — це не PluginModule',\n    );\n  }\n\n  const manifest = value.manifest;\n  if (manifest === undefined) {\n    console.warn(\n      '[plugin] модуль без manifest — метадані в БД підуть дефолтами (0.0.0)',\n    );\n    return;\n  }\n\n  if (!isRecord(manifest)) {\n    throw new Error('[plugin] manifest не є обʼєктом');\n  }\n\n  for (const field of ['name', 'displayName', 'version'] as const) {\n    if (typeof manifest[field] !== 'string' || manifest[field] === '') {\n      throw new Error(`[plugin] manifest.${field} — обовʼязковий рядок`);\n    }\n  }\n  const name = manifest.name as string;\n\n  const engines = manifest.engines;\n  if (engines === undefined) {\n    console.warn(\n      `[plugin] \"${name}\": engines.simplycms відсутній — сумісність із ядром не декларована`,\n    );\n  } else if (!isRecord(engines) || typeof engines.simplycms !== 'string') {\n    throw new Error(\n      `[plugin] \"${name}\": manifest.engines.simplycms має бути рядком-діапазоном`,\n    );\n  } else {\n    try {\n      if (!satisfies(coreVersion, engines.simplycms)) {\n        console.warn(\n          `[plugin] \"${name}\": engines.simplycms \"${engines.simplycms}\" не покриває ядро ${coreVersion} — плагін може бути несумісним`,\n        );\n      }\n    } catch (error) {\n      console.warn(\n        `[plugin] \"${name}\": engines.simplycms не розпарсився: ${\n          error instanceof Error ? error.message : String(error)\n        }`,\n      );\n    }\n  }\n\n  const messages =\n    value.messages ??\n    (value.definition as { messages?: unknown } | undefined)?.messages;\n  if (messages !== undefined) {\n    if (!isRecord(messages)) {\n      throw new Error(\n        `[plugin] \"${name}\": messages має бути Partial<Record<Locale, Record<string, string>>>`,\n      );\n    }\n    const prefix = `plugin.${name}.`;\n    for (const [locale, catalog] of Object.entries(messages)) {\n      if (!isRecord(catalog)) {\n        throw new Error(\n          `[plugin] \"${name}\": messages.${locale} має бути Record<string, string>`,\n        );\n      }\n      for (const [key, text] of Object.entries(catalog)) {\n        if (typeof text !== 'string') {\n          throw new Error(\n            `[plugin] \"${name}\": messages.${locale}.${key} має бути рядком`,\n          );\n        }\n        if (!key.startsWith(prefix)) {\n          console.warn(\n            `[plugin] \"${name}\": ключ \"${key}\" без префікса \"${prefix}\" — ризик колізії з MessageKey ядра чи іншим плагіном`,\n          );\n        }\n      }\n    }\n  }\n\n  const settings = (value.definition as { settings?: unknown } | undefined)\n    ?.settings;\n  if (\n    settings !== undefined &&\n    (!isRecord(settings) || typeof settings.safeParse !== 'function')\n  ) {\n    throw new Error(\n      `[plugin] \"${name}\": definition.settings має бути Zod-схемою (z.object)`,\n    );\n  }\n}\n","import { useCallback } from 'react';\nimport { interpolate, useLocale, type MessageParams } from 'simplycms/i18n';\nimport type { PluginMessages } from './types';\n\n/**\n * Транслятор каталогу ПЛАГІНА (не ядра) — двійник `useThemeT`.\n *\n * Ланцюжок fallback — `messages[locale][key] → messages.uk[key] → сам key`;\n * підстановка `{param}` — та сама `interpolate` з `simplycms/i18n`.\n *\n * Каталог передається АРГУМЕНТОМ (компонент плагіна імпортує власний\n * `messages.ts`), а не читається з реєстру плагінів: реєстр наповнюється в\n * клієнтському `useEffect` (`bootstrapPlugins`), і читання з нього на SSR\n * віддало б сирі ключі — рівно гідраційна пастка, задокументована в\n * `useThemeT.ts`. Статичний імпорт каталогу SSR-стабільний за побудовою.\n *\n * Generic `K` — локальний union плагіна\n * (`export type FaqKey = keyof typeof messages.uk` у `messages.ts` плагіна),\n * НЕ `MessageKey` ядра: SDK про ключі конкретного плагіна нічого не знає.\n */\nexport function usePluginT<K extends string = string>(\n  messages: PluginMessages | undefined,\n): (key: K, params?: MessageParams) => string {\n  const locale = useLocale();\n\n  return useCallback(\n    (key: K, params?: MessageParams): string => {\n      const template = messages?.[locale]?.[key] ?? messages?.uk?.[key] ?? key;\n      return interpolate(template, params);\n    },\n    [messages, locale],\n  );\n}\n","import { useMemo } from 'react';\nimport {\n  pluginTableInsert,\n  pluginTableList,\n  pluginTableRemove,\n  pluginTableUpdate,\n} from 'simplycms/plugin-sdk/server';\n\n/**\n * Порт даних плагіна: вузький CRUD-фасад над ВЛАСНИМИ таблицями\n * (`plg_<name>_*`, спека §7/§9, рішення B9).\n *\n * Це і є межа довіри в дії: плагін не імпортує ні Supabase, ні `simplycms/db`\n * (dependency-lint це забороняє) — він називає таблицю й фільтри, а транспорт\n * лишається справою ядра. Форма порту НЕ дзеркалить жодного бекенда: у v1 під\n * ним був PostgREST, зараз — serverFn поверх Postgres, і жоден плагін від цієї\n * заміни не змінився.\n *\n * 🔴 Імʼя плагіна — ОБОВʼЯЗКОВИЙ перший аргумент, і не для зручності:\n * без нього сервер не може відрізнити «власну» таблицю від сусідньої. Гард\n * `plg_`-префікса в браузері нічого не вартий — рішення ухвалює хендлер\n * (`plugin-sdk/server/guard.ts`).\n *\n * Типи рядків — generic-параметр викликача: таблиці плагіна свідомо НЕ\n * входять у схему ядра, тож узгодженість типу з реальною схемою —\n * відповідальність автора плагіна.\n */\n\n/** Скаляр, який порт погоджується покласти в колонку. */\ntype Cell = string | number | boolean | null;\n\nexport interface PluginTablePort<Row extends Record<string, unknown>> {\n  list(options?: {\n    orderBy?: string;\n    ascending?: boolean;\n    eq?: Partial<Row>;\n  }): Promise<Row[]>;\n  insert(row: Partial<Row>): Promise<Row>;\n  update(id: string, patch: Partial<Row>): Promise<Row>;\n  remove(id: string): Promise<void>;\n}\n\n/** Звузити довільний обʼєкт рядка до скалярів, які приймає транспорт. */\nfunction toCells(row: Record<string, unknown>): Record<string, Cell> {\n  return Object.fromEntries(\n    Object.entries(row).map(([column, value]) => [\n      column,\n      (value ?? null) as Cell,\n    ]),\n  );\n}\n\n/** CRUD-порт до однієї таблиці плагіна. */\nexport function usePluginTable<Row extends Record<string, unknown>>(\n  pluginName: string,\n  table: string,\n): PluginTablePort<Row> {\n  return useMemo<PluginTablePort<Row>>(\n    () => ({\n      async list(options) {\n        const rows = await pluginTableList({\n          data: {\n            plugin: pluginName,\n            table,\n            eq: options?.eq ? toCells(options.eq) : undefined,\n            orderBy: options?.orderBy,\n            ascending: options?.ascending,\n          },\n        });\n        return rows as Row[];\n      },\n      async insert(row) {\n        const created = await pluginTableInsert({\n          data: { plugin: pluginName, table, row: toCells(row) },\n        });\n        return created as Row;\n      },\n      async update(id, patch) {\n        const updated = await pluginTableUpdate({\n          data: { plugin: pluginName, table, id, patch: toCells(patch) },\n        });\n        return updated as Row;\n      },\n      async remove(id) {\n        await pluginTableRemove({ data: { plugin: pluginName, table, id } });\n      },\n    }),\n    [pluginName, table],\n  );\n}\n","import { useCallback, useEffect, useMemo, useState } from 'react';\nimport type { z, ZodObject, ZodRawShape } from 'zod';\nimport type { JsonValue } from 'simplycms/storefront/loaders';\nimport {\n  pluginConfigRead,\n  pluginConfigWrite,\n} from 'simplycms/plugin-sdk/server';\n\n/**\n * Читання й запис ВЛАСНОГО конфіга плагіна (рядок `plugins.config`) —\n * замикає цикл налаштувань: автор декларує Zod-схему в `definePlugin`,\n * адмінка редагує форму, плагін читає значення цим хуком.\n *\n * Схема тут — і валідація, і джерело дефолтів: порожній/битий config\n * парситься через `schema.safeParse`, тож поля з `.default()` завжди\n * матеріалізовані. Битий config → дефолти + console.warn, не падіння.\n *\n * 🔴 Транспорт — serverFn (рішення B9): браузер до БД не звертається. Запис\n * дозволений лише адміну, і перевіряє це СЕРВЕР — `save` віддає `false`,\n * коли права немає.\n */\n\nexport interface PluginConfigResult<S extends ZodObject<ZodRawShape>> {\n  /** Розпарсений конфіг із матеріалізованими дефолтами; `null` — ще вантажиться. */\n  config: z.output<S> | null;\n  loading: boolean;\n  /** Зберегти конфіг (лише адмін). `false` — сервер відмовив у праві. */\n  save: (next: z.input<S>) => Promise<boolean>;\n}\n\nexport function usePluginConfig<S extends ZodObject<ZodRawShape>>(\n  pluginName: string,\n  schema: S,\n): PluginConfigResult<S> {\n  const [raw, setRaw] = useState<unknown>(undefined);\n  const [loading, setLoading] = useState(true);\n\n  useEffect(() => {\n    let cancelled = false;\n    (async () => {\n      try {\n        const result = await pluginConfigRead({ data: { plugin: pluginName } });\n        if (cancelled) return;\n        if (!result.found) {\n          // Рядка немає — типово розсинхрон ключа конфігу з manifest.name\n          // (хук читає за manifest-імʼям, а рядок створює bootstrap за\n          // ключем конфігу). Мовчати не можна: адмінка «успішно» зберігала б\n          // налаштування, які плагін ніколи не побачить.\n          console.warn(\n            `[plugin-sdk] usePluginConfig(\"${pluginName}\"): рядка plugins із таким name немає — віддаю дефолти схеми`,\n          );\n        }\n        setRaw(result.config ?? {});\n      } catch (error) {\n        if (cancelled) return;\n        console.warn(`[plugin-sdk] usePluginConfig(\"${pluginName}\"):`, error);\n        setRaw({});\n      } finally {\n        if (!cancelled) setLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n    };\n  }, [pluginName]);\n\n  const config = useMemo(() => {\n    if (loading) return null;\n    const parsed = schema.safeParse(raw ?? {});\n    if (parsed.success) return parsed.data;\n    console.warn(\n      `[plugin-sdk] usePluginConfig(\"${pluginName}\"): config не пройшов схему — дефолти`,\n    );\n    const fallback = schema.safeParse({});\n    return fallback.success ? fallback.data : null;\n  }, [loading, raw, schema, pluginName]);\n\n  const save = useCallback(\n    async (next: z.input<S>): Promise<boolean> => {\n      // Валідуємо ДО запиту: битий конфіг не має шансу лягти в БД навіть у\n      // адміна — саме схема плагіна тут єдиний опис форми значення.\n      const parsed = schema.safeParse(next);\n      if (!parsed.success) {\n        console.warn(\n          `[plugin-sdk] usePluginConfig(\"${pluginName}\"): save відхилено схемою`,\n        );\n        return false;\n      }\n\n      const written = await pluginConfigWrite({\n        data: {\n          plugin: pluginName,\n          // Значення вже пройшло схему плагіна — далі його форму описує\n          // тільки JSON, бо саме ним воно їде на сервер.\n          config: parsed.data as Record<string, JsonValue>,\n        },\n      });\n      if (written) setRaw(parsed.data);\n      return written;\n    },\n    [pluginName, schema],\n  );\n\n  return { config, loading, save };\n}\n"]}

package/dist/plugin-sdk/server/config-db.d.ts

@@ -0,0 +1,22 @@
+import { type JsonValue } from 'simplycms/storefront/loaders';
+/**
+ * Конфіг плагіна — рядок `plugins.config`. Читає будь-хто (грант SELECT на
+ * `plugins` має й анонім), пише лише адмін.
+ */
+/**
+ * Значення `config` або `null`, якщо рядка плагіна немає.
+ *
+ * 🔴 Розрізняти «рядка немає» і «config порожній» обовʼязково: перше — це
+ * типовий розсинхрон ключа конфігу з `manifest.name`, і мовчазні дефолти
+ * ховали б його (адмінка «успішно» зберігала б налаштування, яких плагін
+ * ніколи не побачить).
+ */
+export declare function selectPluginConfig(pluginName: string): Promise<{
+    found: boolean;
+    config: JsonValue;
+}>;
+/**
+ * Записати конфіг плагіна. `isAdmin` рахує СЕРВЕР — грант UPDATE на
+ * `plugins` має лише `app_admin`. Повертає `false`, якщо права немає.
+ */
+export declare function savePluginConfig(pluginName: string, config: Record<string, JsonValue>, isAdmin: boolean): Promise<boolean>;

package/dist/plugin-sdk/server/guard.d.ts

@@ -0,0 +1,17 @@
+/** Ключ плагіна в іменах таблиць: `hello-world` → `hello_world`. */
+export declare function tablePrefix(pluginName: string): string;
+/** Колонка у фільтрі/сортуванні. Кидає — інакше імʼя пішло б у SQL як є. */
+export declare function assertColumn(column: string): string;
+/**
+ * Перевірити, що `table` — ВЛАСНА таблиця плагіна `pluginName`.
+ *
+ * Два незалежні критерії, обидва обовʼязкові:
+ *   1) імʼя = `plg_<ключ плагіна>` або `plg_<ключ плагіна>_<…>` — префікса
+ *      `plg_` самого по собі мало: він пустив би плагін у таблицю СУСІДА;
+ *   2) плагін відомий магазину — рядок у `plugins` існує. Це і є «манифест»
+ *      на боці сервера: реєстр модулів у браузері, і вірити його імені
+ *      хендлер не може.
+ */
+export declare function assertOwnTable(pluginName: string, table: string): string;
+/** Чи знає магазин про такий плагін (рядок у `plugins`). */
+export declare function assertKnownPlugin(pluginName: string): Promise<void>;

package/dist/plugin-sdk/server/index.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import type { JsonValue } from 'simplycms/storefront/loaders';
+import { type PluginRow } from './table-db';
+/** Читання власної таблиці плагіна. Публічне: слоти вітрини бачить і гість. */
+export declare const pluginTableList: import("@tanstack/react-start").RequiredFetcher<undefined, z.ZodObject<{
+    plugin: z.ZodString;
+    table: z.ZodString;
+    eq: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    orderBy: z.ZodOptional<z.ZodString>;
+    ascending: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, Promise<PluginRow[]>>;
+/** Вставка рядка — лише адмін. */
+export declare const pluginTableInsert: import("@tanstack/react-start").RequiredFetcher<undefined, z.ZodObject<{
+    plugin: z.ZodString;
+    table: z.ZodString;
+    row: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+}, z.core.$strip>, Promise<PluginRow>>;
+/** Оновлення рядка за `id` — лише адмін. */
+export declare const pluginTableUpdate: import("@tanstack/react-start").RequiredFetcher<undefined, z.ZodObject<{
+    plugin: z.ZodString;
+    table: z.ZodString;
+    id: z.ZodString;
+    patch: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+}, z.core.$strip>, Promise<PluginRow>>;
+/** Видалення рядка за `id` — лише адмін. */
+export declare const pluginTableRemove: import("@tanstack/react-start").RequiredFetcher<undefined, z.ZodObject<{
+    plugin: z.ZodString;
+    table: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strip>, Promise<void>>;
+/** Конфіг плагіна: `found: false` — рядка з таким `name` у БД немає. */
+export declare const pluginConfigRead: import("@tanstack/react-start").RequiredFetcher<undefined, z.ZodObject<{
+    plugin: z.ZodString;
+}, z.core.$strip>, Promise<{
+    found: boolean;
+    config: JsonValue;
+}>>;
+/** Запис конфіга плагіна — лише адмін; `false` означає відмову доступу. */
+export declare const pluginConfigWrite: import("@tanstack/react-start").RequiredFetcher<undefined, z.ZodObject<{
+    plugin: z.ZodString;
+    config: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+}, z.core.$strip>, Promise<boolean>>;