simplycms 0.4.0

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

@@ -0,0 +1,191 @@
+import { createServerFn } from '@tanstack/react-start';
+import { getRequest } from '@tanstack/react-start/server';
+import { z } from 'zod';
+import { isAdminRequest } from 'simplycms/auth';
+import { sql, eq } from 'drizzle-orm';
+import { plugins } from 'simplycms/schema';
+import { withStorefrontDb, withStoreOperatorDb } from 'simplycms/storefront/loaders';
+
+// src/plugin-sdk/server/index.ts
+async function selectPluginConfig(pluginName) {
+  const [row] = await withStorefrontDb(
+    (db) => db.select({ config: plugins.config }).from(plugins).where(eq(plugins.name, pluginName)).limit(1)
+  );
+  return row ? { found: true, config: row.config ?? {} } : { found: false, config: {} };
+}
+async function savePluginConfig(pluginName, config, isAdmin) {
+  if (!isAdmin) return false;
+  await withStoreOperatorDb(
+    (db) => db.update(plugins).set({ config, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }).where(eq(plugins.name, pluginName))
+  );
+  return true;
+}
+var IDENTIFIER = /^[a-z_][a-z0-9_]*$/;
+function tablePrefix(pluginName) {
+  return `plg_${pluginName.toLowerCase().replace(/-/g, "_")}`;
+}
+function assertColumn(column) {
+  if (!IDENTIFIER.test(column)) {
+    throw new Error(
+      `[plugin-sdk] \u041D\u0435\u0434\u043E\u043F\u0443\u0441\u0442\u0438\u043C\u0435 \u0456\u043C\u02BC\u044F \u043A\u043E\u043B\u043E\u043D\u043A\u0438: ${JSON.stringify(column)}`
+    );
+  }
+  return column;
+}
+function assertOwnTable(pluginName, table) {
+  if (!IDENTIFIER.test(table)) {
+    throw new Error(
+      `[plugin-sdk] \u041D\u0435\u0434\u043E\u043F\u0443\u0441\u0442\u0438\u043C\u0435 \u0456\u043C\u02BC\u044F \u0442\u0430\u0431\u043B\u0438\u0446\u0456: ${JSON.stringify(table)}`
+    );
+  }
+  const prefix = tablePrefix(pluginName);
+  if (table !== prefix && !table.startsWith(`${prefix}_`)) {
+    throw new Error(
+      `[plugin-sdk] \u041F\u043B\u0430\u0433\u0456\u043D "${pluginName}" \u043D\u0435 \u0432\u043E\u043B\u043E\u0434\u0456\u0454 \u0442\u0430\u0431\u043B\u0438\u0446\u0435\u044E "${table}": \u043F\u043E\u0440\u0442 \u043F\u0440\u0430\u0446\u044E\u0454 \u043B\u0438\u0448\u0435 \u0437 "${prefix}" \u0456 "${prefix}_*" (\u0441\u043F\u0435\u043A\u0430 \xA77).`
+    );
+  }
+  return table;
+}
+async function assertKnownPlugin(pluginName) {
+  const [row] = await withStorefrontDb(
+    (db) => db.select({ name: plugins.name }).from(plugins).where(eq(plugins.name, pluginName)).limit(1)
+  );
+  if (!row) {
+    throw new Error(
+      `[plugin-sdk] \u041F\u043B\u0430\u0433\u0456\u043D "${pluginName}" \u043D\u0435 \u0437\u0430\u0440\u0435\u0454\u0441\u0442\u0440\u043E\u0432\u0430\u043D\u0438\u0439 \u0443 \u043C\u0430\u0433\u0430\u0437\u0438\u043D\u0456 \u2014 \u043F\u043E\u0440\u0442 \u0434\u0430\u043D\u0438\u0445 \u043D\u0435\u0434\u043E\u0441\u0442\u0443\u043F\u043D\u0438\u0439.`
+    );
+  }
+}
+
+// src/plugin-sdk/server/table-db.ts
+async function selectPluginRows(pluginName, table, query = {}) {
+  const name = await guardedTable(pluginName, table);
+  const parts = [sql`select * from ${sql.identifier(name)}`];
+  const conditions = Object.entries(query.eq ?? {}).map(
+    ([column, value]) => sql`${sql.identifier(assertColumn(column))} = ${value}`
+  );
+  if (conditions.length > 0) {
+    parts.push(sql` where ${sql.join(conditions, sql` and `)}`);
+  }
+  if (query.orderBy) {
+    const direction = query.ascending === false ? sql`desc` : sql`asc`;
+    parts.push(
+      sql` order by ${sql.identifier(assertColumn(query.orderBy))} ${direction}`
+    );
+  }
+  return withStorefrontDb((db) => run(db, sql.join(parts, sql``)));
+}
+async function insertPluginRow(pluginName, table, row) {
+  const name = await guardedTable(pluginName, table);
+  const columns = Object.keys(row).map(assertColumn);
+  if (columns.length === 0) {
+    throw new Error("[plugin-sdk] insert \u0431\u0435\u0437 \u0436\u043E\u0434\u043D\u043E\u0457 \u043A\u043E\u043B\u043E\u043D\u043A\u0438");
+  }
+  const query = sql`insert into ${sql.identifier(name)} (${sql.join(
+    columns.map((column) => sql.identifier(column)),
+    sql`, `
+  )}) values (${sql.join(
+    columns.map((column) => sql`${row[column]}`),
+    sql`, `
+  )}) returning *`;
+  return one(await withStoreOperatorDb((db) => run(db, query)), "insert");
+}
+async function updatePluginRow(pluginName, table, id, patch) {
+  const name = await guardedTable(pluginName, table);
+  const columns = Object.keys(patch).map(assertColumn);
+  if (columns.length === 0) {
+    throw new Error("[plugin-sdk] update \u0431\u0435\u0437 \u0436\u043E\u0434\u043D\u043E\u0457 \u043A\u043E\u043B\u043E\u043D\u043A\u0438");
+  }
+  const query = sql`update ${sql.identifier(name)} set ${sql.join(
+    columns.map((column) => sql`${sql.identifier(column)} = ${patch[column]}`),
+    sql`, `
+  )} where ${sql.identifier("id")} = ${id} returning *`;
+  return one(await withStoreOperatorDb((db) => run(db, query)), "update");
+}
+async function deletePluginRow(pluginName, table, id) {
+  const name = await guardedTable(pluginName, table);
+  await withStoreOperatorDb(
+    (db) => run(
+      db,
+      sql`delete from ${sql.identifier(name)} where ${sql.identifier("id")} = ${id}`
+    )
+  );
+}
+async function guardedTable(pluginName, table) {
+  const name = assertOwnTable(pluginName, table);
+  await assertKnownPlugin(pluginName);
+  return name;
+}
+async function run(db, query) {
+  const result = await db.execute(query);
+  return result.rows;
+}
+function one(rows, operation) {
+  const [row] = rows;
+  if (!row) {
+    throw new Error(`[plugin-sdk] ${operation}: \u043F\u043E\u0440\u043E\u0436\u043D\u044F \u0432\u0456\u0434\u043F\u043E\u0432\u0456\u0434\u044C`);
+  }
+  return row;
+}
+
+// src/plugin-sdk/server/index.ts
+var cell = z.union([z.string(), z.number(), z.boolean(), z.null()]);
+var target = z.object({
+  plugin: z.string().min(1).max(100),
+  table: z.string().min(1).max(63)
+});
+var pluginTableList = createServerFn({ method: "GET" }).inputValidator(
+  target.extend({
+    eq: z.record(z.string(), cell).optional(),
+    orderBy: z.string().max(63).optional(),
+    ascending: z.boolean().optional()
+  })
+).handler(async ({ data }) => {
+  const input = data;
+  return selectPluginRows(input.plugin, input.table, input);
+});
+var pluginTableInsert = createServerFn({ method: "POST" }).inputValidator(target.extend({ row: z.record(z.string(), cell) })).handler(async ({ data }) => {
+  const input = data;
+  await requireAdmin();
+  return insertPluginRow(input.plugin, input.table, input.row);
+});
+var pluginTableUpdate = createServerFn({ method: "POST" }).inputValidator(
+  target.extend({
+    id: z.string().min(1).max(64),
+    patch: z.record(z.string(), cell)
+  })
+).handler(async ({ data }) => {
+  const input = data;
+  await requireAdmin();
+  return updatePluginRow(input.plugin, input.table, input.id, input.patch);
+});
+var pluginTableRemove = createServerFn({ method: "POST" }).inputValidator(target.extend({ id: z.string().min(1).max(64) })).handler(async ({ data }) => {
+  const input = data;
+  await requireAdmin();
+  await deletePluginRow(input.plugin, input.table, input.id);
+});
+var pluginConfigRead = createServerFn({ method: "GET" }).inputValidator(z.object({ plugin: z.string().min(1).max(100) })).handler(
+  async ({ data }) => selectPluginConfig(data.plugin)
+);
+var pluginConfigWrite = createServerFn({ method: "POST" }).inputValidator(
+  z.object({
+    plugin: z.string().min(1).max(100),
+    config: z.record(z.string(), z.json())
+  })
+).handler(async ({ data }) => {
+  const input = data;
+  return savePluginConfig(
+    input.plugin,
+    input.config,
+    await isAdminRequest(getRequest().headers)
+  );
+});
+async function requireAdmin() {
+  if (!await isAdminRequest(getRequest().headers)) {
+    throw new Error("[plugin-sdk] \u0417\u0430\u043F\u0438\u0441 \u0443 \u0442\u0430\u0431\u043B\u0438\u0446\u044E \u043F\u043B\u0430\u0433\u0456\u043D\u0430 \u0434\u043E\u0441\u0442\u0443\u043F\u043D\u0438\u0439 \u0430\u0434\u043C\u0456\u043D\u0443.");
+  }
+}
+
+export { pluginConfigRead, pluginConfigWrite, pluginTableInsert, pluginTableList, pluginTableRemove, pluginTableUpdate };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/plugin-sdk/server/config-db.ts","../../../src/plugin-sdk/server/guard.ts","../../../src/plugin-sdk/server/table-db.ts","../../../src/plugin-sdk/server/index.ts"],"names":["withStorefrontDb","plugins","eq","withStoreOperatorDb"],"mappings":"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","file":"index.js","sourcesContent":["import { eq } from 'drizzle-orm';\nimport { plugins } from 'simplycms/schema';\nimport {\n  withStorefrontDb,\n  withStoreOperatorDb,\n  type JsonValue,\n} from 'simplycms/storefront/loaders';\n\n/**\n * Конфіг плагіна — рядок `plugins.config`. Читає будь-хто (грант SELECT на\n * `plugins` має й анонім), пише лише адмін.\n */\n\n/**\n * Значення `config` або `null`, якщо рядка плагіна немає.\n *\n * 🔴 Розрізняти «рядка немає» і «config порожній» обовʼязково: перше — це\n * типовий розсинхрон ключа конфігу з `manifest.name`, і мовчазні дефолти\n * ховали б його (адмінка «успішно» зберігала б налаштування, яких плагін\n * ніколи не побачить).\n */\nexport async function selectPluginConfig(\n  pluginName: string,\n): Promise<{ found: boolean; config: JsonValue }> {\n  const [row] = await withStorefrontDb((db) =>\n    db\n      .select({ config: plugins.config })\n      .from(plugins)\n      .where(eq(plugins.name, pluginName))\n      .limit(1),\n  );\n\n  return row\n    ? { found: true, config: (row.config ?? {}) as JsonValue }\n    : { found: false, config: {} };\n}\n\n/**\n * Записати конфіг плагіна. `isAdmin` рахує СЕРВЕР — грант UPDATE на\n * `plugins` має лише `app_admin`. Повертає `false`, якщо права немає.\n */\nexport async function savePluginConfig(\n  pluginName: string,\n  config: Record<string, JsonValue>,\n  isAdmin: boolean,\n): Promise<boolean> {\n  if (!isAdmin) return false;\n\n  await withStoreOperatorDb((db) =>\n    db\n      .update(plugins)\n      .set({ config, updatedAt: new Date().toISOString() })\n      .where(eq(plugins.name, pluginName)),\n  );\n\n  return true;\n}\n","import { eq } from 'drizzle-orm';\nimport { plugins } from 'simplycms/schema';\nimport { withStorefrontDb } from 'simplycms/storefront/loaders';\n\n/**\n * Межа даних плагіна (спека §7, рішення B9) — ЧИСТА частина.\n *\n * 🔴 Гард обовʼязково серверний. Раніше префікс `plg_` перевіряв хук у\n * браузері, а доступ обмежувала RLS: імʼя таблиці все одно їхало в PostgREST,\n * і межу тримала база. У контурі v2 бази на тому кінці немає — запит виконує\n * НАШ хендлер під роллю магазину. Тобто якби імʼя таблиці не перевірялося\n * тут, плагін прочитав би `orders` чи `users` рівно тим самим викликом.\n */\n\n/** Ідентифікатор SQL, який гард узагалі згоден підставити в запит. */\nconst IDENTIFIER = /^[a-z_][a-z0-9_]*$/;\n\n/** Ключ плагіна в іменах таблиць: `hello-world` → `hello_world`. */\nexport function tablePrefix(pluginName: string): string {\n  return `plg_${pluginName.toLowerCase().replace(/-/g, '_')}`;\n}\n\n/** Колонка у фільтрі/сортуванні. Кидає — інакше імʼя пішло б у SQL як є. */\nexport function assertColumn(column: string): string {\n  if (!IDENTIFIER.test(column)) {\n    throw new Error(\n      `[plugin-sdk] Недопустиме імʼя колонки: ${JSON.stringify(column)}`,\n    );\n  }\n  return column;\n}\n\n/**\n * Перевірити, що `table` — ВЛАСНА таблиця плагіна `pluginName`.\n *\n * Два незалежні критерії, обидва обовʼязкові:\n *   1) імʼя = `plg_<ключ плагіна>` або `plg_<ключ плагіна>_<…>` — префікса\n *      `plg_` самого по собі мало: він пустив би плагін у таблицю СУСІДА;\n *   2) плагін відомий магазину — рядок у `plugins` існує. Це і є «манифест»\n *      на боці сервера: реєстр модулів у браузері, і вірити його імені\n *      хендлер не може.\n */\nexport function assertOwnTable(pluginName: string, table: string): string {\n  if (!IDENTIFIER.test(table)) {\n    throw new Error(\n      `[plugin-sdk] Недопустиме імʼя таблиці: ${JSON.stringify(table)}`,\n    );\n  }\n\n  const prefix = tablePrefix(pluginName);\n  if (table !== prefix && !table.startsWith(`${prefix}_`)) {\n    throw new Error(\n      `[plugin-sdk] Плагін \"${pluginName}\" не володіє таблицею \"${table}\": ` +\n        `порт працює лише з \"${prefix}\" і \"${prefix}_*\" (спека §7).`,\n    );\n  }\n\n  return table;\n}\n\n/** Чи знає магазин про такий плагін (рядок у `plugins`). */\nexport async function assertKnownPlugin(pluginName: string): Promise<void> {\n  const [row] = await withStorefrontDb((db) =>\n    db\n      .select({ name: plugins.name })\n      .from(plugins)\n      .where(eq(plugins.name, pluginName))\n      .limit(1),\n  );\n\n  if (!row) {\n    throw new Error(\n      `[plugin-sdk] Плагін \"${pluginName}\" не зареєстрований у магазині — ` +\n        `порт даних недоступний.`,\n    );\n  }\n}\n","import { sql, type SQL } from 'drizzle-orm';\nimport {\n  withStorefrontDb,\n  withStoreOperatorDb,\n  type ActorDb,\n  type JsonValue,\n} from 'simplycms/storefront/loaders';\nimport { assertColumn, assertKnownPlugin, assertOwnTable } from './guard';\n\n/**\n * Виконання запитів до ВЛАСНОЇ таблиці плагіна (рішення B9).\n *\n * 🔴 SQL тут будується рядком, а не Drizzle-схемою, і це неминуче: таблиці\n * `plg_*` живуть у міграціях плагіна, ядро їхніх колонок не знає за\n * визначенням. Тому кожен ідентифікатор проходить `assertOwnTable`/\n * `assertColumn`, а кожне ЗНАЧЕННЯ їде параметром — інтерполяції значень у\n * цьому модулі немає жодної.\n */\n\n/** Скаляр, який порт погоджується покласти в колонку плагіна. */\nexport type PluginCell = string | number | boolean | null;\n\n/**\n * Рядок таблиці плагіна, як його бачить ядро: плоский і нетипізований.\n *\n * 🔴 Значення саме `JsonValue`, а не `unknown`: результат serverFn їде на\n * клієнт серіалізацією, і `unknown` там — не «поки не знаю тип», а «може не\n * пережити дорогу». TanStack Start це перевіряє типом і не дає зібратись.\n */\nexport type PluginRow = Record<string, JsonValue>;\n\nexport interface PluginListQuery {\n  eq?: Record<string, PluginCell>;\n  orderBy?: string;\n  ascending?: boolean;\n}\n\n/** `select * from <таблиця плагіна>` із простими фільтрами. */\nexport async function selectPluginRows(\n  pluginName: string,\n  table: string,\n  query: PluginListQuery = {},\n): Promise<PluginRow[]> {\n  const name = await guardedTable(pluginName, table);\n\n  const parts: SQL[] = [sql`select * from ${sql.identifier(name)}`];\n\n  const conditions = Object.entries(query.eq ?? {}).map(\n    ([column, value]) =>\n      sql`${sql.identifier(assertColumn(column))} = ${value}`,\n  );\n  if (conditions.length > 0) {\n    parts.push(sql` where ${sql.join(conditions, sql` and `)}`);\n  }\n\n  if (query.orderBy) {\n    const direction = query.ascending === false ? sql`desc` : sql`asc`;\n    parts.push(\n      sql` order by ${sql.identifier(assertColumn(query.orderBy))} ${direction}`,\n    );\n  }\n\n  return withStorefrontDb((db) => run(db, sql.join(parts, sql``)));\n}\n\n/**\n * Вставка рядка. Пише роль `app_admin`, і лише після серверної перевірки\n * ролі викликача — див. `./index`.\n */\nexport async function insertPluginRow(\n  pluginName: string,\n  table: string,\n  row: Record<string, PluginCell>,\n): Promise<PluginRow> {\n  const name = await guardedTable(pluginName, table);\n  const columns = Object.keys(row).map(assertColumn);\n  if (columns.length === 0) {\n    throw new Error('[plugin-sdk] insert без жодної колонки');\n  }\n\n  const query = sql`insert into ${sql.identifier(name)} (${sql.join(\n    columns.map((column) => sql.identifier(column)),\n    sql`, `,\n  )}) values (${sql.join(\n    columns.map((column) => sql`${row[column]}`),\n    sql`, `,\n  )}) returning *`;\n\n  return one(await withStoreOperatorDb((db) => run(db, query)), 'insert');\n}\n\n/** Оновлення рядка за `id`. */\nexport async function updatePluginRow(\n  pluginName: string,\n  table: string,\n  id: string,\n  patch: Record<string, PluginCell>,\n): Promise<PluginRow> {\n  const name = await guardedTable(pluginName, table);\n  const columns = Object.keys(patch).map(assertColumn);\n  if (columns.length === 0) {\n    throw new Error('[plugin-sdk] update без жодної колонки');\n  }\n\n  const query = sql`update ${sql.identifier(name)} set ${sql.join(\n    columns.map((column) => sql`${sql.identifier(column)} = ${patch[column]}`),\n    sql`, `,\n  )} where ${sql.identifier('id')} = ${id} returning *`;\n\n  return one(await withStoreOperatorDb((db) => run(db, query)), 'update');\n}\n\n/** Видалення рядка за `id`. */\nexport async function deletePluginRow(\n  pluginName: string,\n  table: string,\n  id: string,\n): Promise<void> {\n  const name = await guardedTable(pluginName, table);\n  await withStoreOperatorDb((db) =>\n    run(\n      db,\n      sql`delete from ${sql.identifier(name)} where ${sql.identifier('id')} = ${id}`,\n    ),\n  );\n}\n\n/** Обидва рубежі межі даних плагіна разом — щоб їх не можна було забути. */\nasync function guardedTable(\n  pluginName: string,\n  table: string,\n): Promise<string> {\n  const name = assertOwnTable(pluginName, table);\n  await assertKnownPlugin(pluginName);\n  return name;\n}\n\nasync function run(db: ActorDb, query: SQL): Promise<PluginRow[]> {\n  const result = await db.execute(query);\n  return result.rows as PluginRow[];\n}\n\nfunction one(rows: PluginRow[], operation: string): PluginRow {\n  const [row] = rows;\n  if (!row) {\n    throw new Error(`[plugin-sdk] ${operation}: порожня відповідь`);\n  }\n  return row;\n}\n","import { createServerFn } from '@tanstack/react-start';\nimport { getRequest } from '@tanstack/react-start/server';\nimport { z } from 'zod';\nimport { isAdminRequest } from 'simplycms/auth';\nimport type { JsonValue } from 'simplycms/storefront/loaders';\nimport { selectPluginConfig, savePluginConfig } from './config-db';\nimport {\n  deletePluginRow,\n  insertPluginRow,\n  selectPluginRows,\n  updatePluginRow,\n  type PluginRow,\n} from './table-db';\n\n/**\n * Транспорт портів плагіна (рішення B9 спеки v2). Лише `createServerFn` —\n * жодного звичайного експорту (див. докблок у `themes/server/index.ts`).\n *\n * 🔴 Контракт назовні бекенд-нейтральний: плагін називає таблицю й фільтри,\n * а ЧИМ це виконано (Postgres, `withActor`, роль транзакції) з SDK не видно\n * взагалі — саме тому порт пережив зміну бекенда без правок у плагінах.\n */\n\nconst cell = z.union([z.string(), z.number(), z.boolean(), z.null()]);\nconst target = z.object({\n  plugin: z.string().min(1).max(100),\n  table: z.string().min(1).max(63),\n});\n\n/** Читання власної таблиці плагіна. Публічне: слоти вітрини бачить і гість. */\nexport const pluginTableList = createServerFn({ method: 'GET' })\n  .inputValidator(\n    target.extend({\n      eq: z.record(z.string(), cell).optional(),\n      orderBy: z.string().max(63).optional(),\n      ascending: z.boolean().optional(),\n    }),\n  )\n  .handler(async ({ data }): Promise<PluginRow[]> => {\n    const input = data as z.output<typeof target> & {\n      eq?: Record<string, z.output<typeof cell>>;\n      orderBy?: string;\n      ascending?: boolean;\n    };\n    return selectPluginRows(input.plugin, input.table, input);\n  });\n\n/** Вставка рядка — лише адмін. */\nexport const pluginTableInsert = createServerFn({ method: 'POST' })\n  .inputValidator(target.extend({ row: z.record(z.string(), cell) }))\n  .handler(async ({ data }): Promise<PluginRow> => {\n    const input = data as z.output<typeof target> & {\n      row: Record<string, z.output<typeof cell>>;\n    };\n    await requireAdmin();\n    return insertPluginRow(input.plugin, input.table, input.row);\n  });\n\n/** Оновлення рядка за `id` — лише адмін. */\nexport const pluginTableUpdate = createServerFn({ method: 'POST' })\n  .inputValidator(\n    target.extend({\n      id: z.string().min(1).max(64),\n      patch: z.record(z.string(), cell),\n    }),\n  )\n  .handler(async ({ data }): Promise<PluginRow> => {\n    const input = data as z.output<typeof target> & {\n      id: string;\n      patch: Record<string, z.output<typeof cell>>;\n    };\n    await requireAdmin();\n    return updatePluginRow(input.plugin, input.table, input.id, input.patch);\n  });\n\n/** Видалення рядка за `id` — лише адмін. */\nexport const pluginTableRemove = createServerFn({ method: 'POST' })\n  .inputValidator(target.extend({ id: z.string().min(1).max(64) }))\n  .handler(async ({ data }): Promise<void> => {\n    const input = data as z.output<typeof target> & { id: string };\n    await requireAdmin();\n    await deletePluginRow(input.plugin, input.table, input.id);\n  });\n\n/** Конфіг плагіна: `found: false` — рядка з таким `name` у БД немає. */\nexport const pluginConfigRead = createServerFn({ method: 'GET' })\n  .inputValidator(z.object({ plugin: z.string().min(1).max(100) }))\n  .handler(async ({ data }): Promise<{ found: boolean; config: JsonValue }> =>\n    selectPluginConfig((data as { plugin: string }).plugin),\n  );\n\n/** Запис конфіга плагіна — лише адмін; `false` означає відмову доступу. */\nexport const pluginConfigWrite = createServerFn({ method: 'POST' })\n  .inputValidator(\n    z.object({\n      plugin: z.string().min(1).max(100),\n      config: z.record(z.string(), z.json()),\n    }),\n  )\n  .handler(async ({ data }): Promise<boolean> => {\n    const input = data as { plugin: string; config: Record<string, JsonValue> };\n    return savePluginConfig(\n      input.plugin,\n      input.config,\n      await isAdminRequest(getRequest().headers),\n    );\n  });\n\n/**\n * 🔴 Мутації падають ДО походу в БД, а не покладаються на грант. Роль\n * `app_admin` вмикається типізованою перевіркою в TS (перший рубіж B5″), тож\n * хендлер, який пустив би чужий запит під нею, зняв би цей рубіж власноруч.\n */\nasync function requireAdmin(): Promise<void> {\n  if (!(await isAdminRequest(getRequest().headers))) {\n    throw new Error('[plugin-sdk] Запис у таблицю плагіна доступний адміну.');\n  }\n}\n"]}

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

@@ -0,0 +1,36 @@
+import { type JsonValue } from 'simplycms/storefront/loaders';
+/**
+ * Виконання запитів до ВЛАСНОЇ таблиці плагіна (рішення B9).
+ *
+ * 🔴 SQL тут будується рядком, а не Drizzle-схемою, і це неминуче: таблиці
+ * `plg_*` живуть у міграціях плагіна, ядро їхніх колонок не знає за
+ * визначенням. Тому кожен ідентифікатор проходить `assertOwnTable`/
+ * `assertColumn`, а кожне ЗНАЧЕННЯ їде параметром — інтерполяції значень у
+ * цьому модулі немає жодної.
+ */
+/** Скаляр, який порт погоджується покласти в колонку плагіна. */
+export type PluginCell = string | number | boolean | null;
+/**
+ * Рядок таблиці плагіна, як його бачить ядро: плоский і нетипізований.
+ *
+ * 🔴 Значення саме `JsonValue`, а не `unknown`: результат serverFn їде на
+ * клієнт серіалізацією, і `unknown` там — не «поки не знаю тип», а «може не
+ * пережити дорогу». TanStack Start це перевіряє типом і не дає зібратись.
+ */
+export type PluginRow = Record<string, JsonValue>;
+export interface PluginListQuery {
+    eq?: Record<string, PluginCell>;
+    orderBy?: string;
+    ascending?: boolean;
+}
+/** `select * from <таблиця плагіна>` із простими фільтрами. */
+export declare function selectPluginRows(pluginName: string, table: string, query?: PluginListQuery): Promise<PluginRow[]>;
+/**
+ * Вставка рядка. Пише роль `app_admin`, і лише після серверної перевірки
+ * ролі викликача — див. `./index`.
+ */
+export declare function insertPluginRow(pluginName: string, table: string, row: Record<string, PluginCell>): Promise<PluginRow>;
+/** Оновлення рядка за `id`. */
+export declare function updatePluginRow(pluginName: string, table: string, id: string, patch: Record<string, PluginCell>): Promise<PluginRow>;
+/** Видалення рядка за `id`. */
+export declare function deletePluginRow(pluginName: string, table: string, id: string): Promise<void>;

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

@@ -0,0 +1,66 @@
+import type { ComponentType } from 'react';
+import type { ZodObject, ZodRawShape } from 'zod';
+import type { Locale } from 'simplycms/i18n';
+import type { HookHandler, PluginManifest, PluginModule } from 'simplycms/plugins/types';
+/**
+ * Компонент слота. `context` — те, що передав `<PluginSlot context={…}>`
+ * у точці розширення (наприклад, товар у `product.detail.after`); форма
+ * контексту — контракт конкретного слота, SDK її не типізує.
+ */
+export type SlotComponent = ComponentType<{
+    context?: unknown;
+}>;
+/**
+ * Каталог повідомлень плагіна — дзеркало `ThemeModule.messages` (контракт
+ * тем v2.1). Ключі зобовʼязані мати префікс `plugin.<name>.` — колізії з
+ * замкненим `MessageKey` ядра і між плагінами виключаються неймспейсом.
+ */
+export type PluginMessages = Partial<Record<Locale, Record<string, string>>>;
+/**
+ * Декларативний контракт плагіна (спека §7, обсяг v1 — план Фази 3).
+ *
+ * Межі v1, зафіксовані планом: `hooks` реєструються в той самий
+ * `HookRegistry`, що й слоти, але ядро НЕ емить бізнес-подій
+ * (`order.created` тощо) — робочі точки розширення сьогодні лише слоти;
+ * `adminRoutes`/`migrations`/`edgeFunctions`/`buckets` — декларації для
+ * CLI й людини, рантайм їх не інтерпретує.
+ */
+export interface PluginDefinition {
+    /** Машинне імʼя: `[a-z][a-z0-9-]*`. Ключ у БД, префікс таблиць і ключів i18n. */
+    name: string;
+    displayName: string;
+    version: string;
+    /** Діапазон сумісності з ядром; перевіряється `satisfies` (warn-режим на 0.x). */
+    engines: {
+        simplycms: string;
+    };
+    /** Метадані реєстру/маркетплейсу — англійською (показуються з БД-рядка, не з каталогу). */
+    description?: string;
+    author?: string;
+    /** Zod-схема налаштувань; форму рендерить адмінка (`z.toJSONSchema`). */
+    settings?: ZodObject<ZodRawShape>;
+    /** Слот → компонент. Реєструється як хендлер, що рендерить компонент. */
+    slots?: Record<string, SlotComponent>;
+    /** Хук → обробник. Виконується там, де ядро кличе `execute` (зараз — лише PluginSlot). */
+    hooks?: Record<string, HookHandler>;
+    messages?: PluginMessages;
+    /** Тека роутів адмінки відносно кореня пакета (конвенція: './routes'). */
+    adminRoutes?: string;
+    /** Імена SQL-файлів у `migrations/` пакета (конвенція: `<ts>_plg_<name>_<slug>.sql`). */
+    migrations?: string[];
+    /** Декларація Edge Functions — без автоматизації у v1 (спека §9). */
+    edgeFunctions?: string[];
+    /** Декларація storage-бакетів — без автоматизації у v1 (спека §9). */
+    buckets?: string[];
+}
+/**
+ * Результат `definePlugin`: структурно задовольняє чинний `PluginModule`
+ * (`register`/`unregister` згенеровані з декларацій), тож
+ * `bootstrapPlugins`/`PluginLoader` працюють без змін контракту.
+ */
+export interface SdkPluginModule extends PluginModule {
+    manifest: PluginManifest;
+    definition: PluginDefinition;
+    /** Дублює `definition.messages` на верхньому рівні — симетрія з `ThemeModule.messages`. */
+    messages?: PluginMessages;
+}

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

@@ -0,0 +1,22 @@
+import type { z, ZodObject, ZodRawShape } from 'zod';
+/**
+ * Читання й запис ВЛАСНОГО конфіга плагіна (рядок `plugins.config`) —
+ * замикає цикл налаштувань: автор декларує Zod-схему в `definePlugin`,
+ * адмінка редагує форму, плагін читає значення цим хуком.
+ *
+ * Схема тут — і валідація, і джерело дефолтів: порожній/битий config
+ * парситься через `schema.safeParse`, тож поля з `.default()` завжди
+ * матеріалізовані. Битий config → дефолти + console.warn, не падіння.
+ *
+ * 🔴 Транспорт — serverFn (рішення B9): браузер до БД не звертається. Запис
+ * дозволений лише адміну, і перевіряє це СЕРВЕР — `save` віддає `false`,
+ * коли права немає.
+ */
+export interface PluginConfigResult<S extends ZodObject<ZodRawShape>> {
+    /** Розпарсений конфіг із матеріалізованими дефолтами; `null` — ще вантажиться. */
+    config: z.output<S> | null;
+    loading: boolean;
+    /** Зберегти конфіг (лише адмін). `false` — сервер відмовив у праві. */
+    save: (next: z.input<S>) => Promise<boolean>;
+}
+export declare function usePluginConfig<S extends ZodObject<ZodRawShape>>(pluginName: string, schema: S): PluginConfigResult<S>;

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

@@ -0,0 +1,19 @@
+import { type MessageParams } from 'simplycms/i18n';
+import type { PluginMessages } from './types';
+/**
+ * Транслятор каталогу ПЛАГІНА (не ядра) — двійник `useThemeT`.
+ *
+ * Ланцюжок fallback — `messages[locale][key] → messages.uk[key] → сам key`;
+ * підстановка `{param}` — та сама `interpolate` з `simplycms/i18n`.
+ *
+ * Каталог передається АРГУМЕНТОМ (компонент плагіна імпортує власний
+ * `messages.ts`), а не читається з реєстру плагінів: реєстр наповнюється в
+ * клієнтському `useEffect` (`bootstrapPlugins`), і читання з нього на SSR
+ * віддало б сирі ключі — рівно гідраційна пастка, задокументована в
+ * `useThemeT.ts`. Статичний імпорт каталогу SSR-стабільний за побудовою.
+ *
+ * Generic `K` — локальний union плагіна
+ * (`export type FaqKey = keyof typeof messages.uk` у `messages.ts` плагіна),
+ * НЕ `MessageKey` ядра: SDK про ключі конкретного плагіна нічого не знає.
+ */
+export declare function usePluginT<K extends string = string>(messages: PluginMessages | undefined): (key: K, params?: MessageParams) => string;

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

@@ -0,0 +1,12 @@
+export interface PluginTablePort<Row extends Record<string, unknown>> {
+    list(options?: {
+        orderBy?: string;
+        ascending?: boolean;
+        eq?: Partial<Row>;
+    }): Promise<Row[]>;
+    insert(row: Partial<Row>): Promise<Row>;
+    update(id: string, patch: Partial<Row>): Promise<Row>;
+    remove(id: string): Promise<void>;
+}
+/** CRUD-порт до однієї таблиці плагіна. */
+export declare function usePluginTable<Row extends Record<string, unknown>>(pluginName: string, table: string): PluginTablePort<Row>;

package/dist/plugins/HookRegistry.d.ts

@@ -0,0 +1,29 @@
+import type { HookHandler, HookRegistryInterface, RegisteredHook } from './types';
+declare class HookRegistry implements HookRegistryInterface {
+    private hooks;
+    private listeners;
+    private version;
+    /**
+     * Підписка на зміни реєстру (джерело для `useSyncExternalStore`).
+     * Стрілкові властивості, а не методи класу: React вимагає СТАБІЛЬНІ
+     * референції `subscribe`/`getSnapshot` між рендерами.
+     */
+    subscribe: (listener: () => void) => (() => void);
+    /**
+     * Синхронний снапшот — монотонна версія реєстру (число, стабільне за
+     * значенням). Повертати сам вміст хуків не можна: `getHandlers` віддає новий
+     * масив на кожен виклик, і React зациклив би рендери.
+     */
+    getVersion: () => number;
+    /** Нотифікація підписників: версія росте на будь-якій мутації реєстру. */
+    private notify;
+    register<TContext = unknown, TResult = unknown>(hookName: string, pluginName: string, handler: HookHandler<TContext, TResult>, priority?: number): void;
+    unregister(hookName: string, pluginName: string): void;
+    execute<TContext = unknown, TResult = unknown>(hookName: string, context: TContext): Promise<TResult[]>;
+    getHandlers<TContext = unknown, TResult = unknown>(hookName: string): RegisteredHook<TContext, TResult>[];
+    getRegisteredHooks(): string[];
+    getPluginsForHook(hookName: string): string[];
+    clear(): void;
+}
+export declare const hookRegistry: HookRegistry;
+export default HookRegistry;

package/dist/plugins/PluginLoader.d.ts

@@ -0,0 +1,19 @@
+import type { Plugin, PluginModule } from './types';
+export declare function registerPluginModule(name: string, module: PluginModule): void;
+export declare function getRegisteredPluginModules(): Map<string, PluginModule>;
+/**
+ * Зняти всі хуки плагіна з реєстру. `getRegisteredHooks()` віддає снапшот імен,
+ * тому мутація реєстру під час обходу безпечна.
+ */
+export declare function removePluginHooks(pluginName: string): void;
+/**
+ * Увімкнути в реєстрі хуки плагінів, позначених активними в БД.
+ *
+ * 🔴 Список приходить serverFn-ом (`simplycms/plugins/server`), а не запитом
+ * із браузера: у контурі v2 браузер до БД не звертається взагалі. Тут же й
+ * причина, чому модуль більше не приймає Supabase-клієнта.
+ *
+ * Активний у БД, але невідомий модуль (магазин видалив пакет, рядок лишився)
+ * не валить застосунок — помилка логується, плагін пропускається (спека §8).
+ */
+export declare function loadPlugins(): Promise<Plugin[]>;

package/dist/plugins/PluginSlot.d.ts

@@ -0,0 +1,21 @@
+import { ReactNode } from 'react';
+interface PluginSlotProps<TContext = unknown> {
+    name: string;
+    context?: TContext;
+    fallback?: ReactNode;
+    wrapper?: (children: ReactNode[]) => ReactNode;
+}
+/**
+ * Слот розширення. Реактивний до `HookRegistry`: `activatePlugin`/
+ * `deactivatePlugin` викликають `register`/`unregister`, реєстр нотифікує
+ * підписників — і віджет зʼявляється/зникає живцем, без перезавантаження
+ * сторінки.
+ */
+export declare function PluginSlot<TContext = unknown>({ name, context, fallback, wrapper, }: PluginSlotProps<TContext>): import("react").JSX.Element | null;
+/** Ті самі результати поза JSX-слотом (той самий реактивний контур). */
+export declare function usePluginSlot<TContext = unknown, TResult = unknown>(name: string, context?: TContext): {
+    results: TResult[];
+    loading: boolean;
+};
+export declare function getPluginSlotCount(name: string): number;
+export {};

package/dist/plugins/PluginSlot.js

@@ -0,0 +1,5 @@
+export { PluginSlot, getPluginSlotCount, usePluginSlot } from '../chunk-4N7CLW6Y.js';
+import '../chunk-HDKJLZP5.js';
+import '../chunk-PZ5AY32C.js';
+//# sourceMappingURL=PluginSlot.js.map
+//# sourceMappingURL=PluginSlot.js.map

package/dist/plugins/PluginSlot.js.map

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

package/dist/plugins/adminLifecycle.d.ts

@@ -0,0 +1,27 @@
+import type { SupabaseClient } from '@supabase/supabase-js';
+/**
+ * Lifecycle плагіна з АДМІНКИ: вмикання, вимикання, видалення рядка.
+ *
+ * 🔴 Живе окремо від `PluginLoader` навмисно. Адмінка — єдиний контур, який
+ * усе ще ходить у БД через supabase-js (контур v2 її ще не перевів), і поки
+ * ці функції стояли поруч із `loadPlugins`, барель `simplycms/plugins` тягнув
+ * PostgREST у КОЖЕН чанк вітрини: bootstrap кореня імпортує саме його. Розділ
+ * файлів робить межу видимою бандлеру, а не лише читачеві.
+ *
+ * 🔴 Наслідок: разом із адмінкою ці функції сьогодні НЕ працюють проти
+ * контуру v2 (роль `app_runtime` PostgREST не має). Це прийнятий борг —
+ * переведення адмінки на serverFn йде окремим треком.
+ */
+/**
+ * Активація плагіна. 🔴 Порядок атомарний: спершу БД, і ТІЛЬКИ після
+ * підтвердженого запису — мутація HookRegistry. Зворотний порядок лишав би
+ * «привидні» хуки в памʼяті, якби БД відмовила.
+ */
+export declare function activatePlugin(supabase: SupabaseClient, pluginName: string): Promise<boolean>;
+/**
+ * Деактивація плагіна. Той самий атомарний порядок: БД → `unregister` модуля →
+ * зняття решти хуків. Відмова БД лишає реєстр незміненим.
+ */
+export declare function deactivatePlugin(supabase: SupabaseClient, pluginName: string): Promise<boolean>;
+/** Видалення плагіна: спершу деактивація (знімає хуки), потім рядок. */
+export declare function uninstallPlugin(supabase: SupabaseClient, pluginName: string): Promise<boolean>;

package/dist/plugins/bootstrap.d.ts

@@ -0,0 +1,16 @@
+import type { PluginModule } from './types';
+/** Опис плагіна в конфізі магазину: імʼя + ліниве завантаження модуля. */
+export interface PluginRegistration {
+    name: string;
+    module: () => Promise<{
+        default: PluginModule;
+    }>;
+}
+/**
+ * Підключає плагіни магазину: реєструє модулі з конфіга, синхронізує їх
+ * із таблицею `plugins` і вмикає ті, що позначені активними в БД.
+ *
+ * Активний у БД, але невідомий модуль (магазин видалив пакет, рядок лишився)
+ * не валить застосунок — `loadPlugins` логує помилку й пропускає його.
+ */
+export declare function bootstrapPlugins(regs: PluginRegistration[], canWrite: boolean): Promise<void>;

package/dist/plugins/bootstrap.js

@@ -0,0 +1,5 @@
+export { bootstrapPlugins } from '../chunk-ZNKTJGLV.js';
+import '../chunk-HDKJLZP5.js';
+import '../chunk-PZ5AY32C.js';
+//# sourceMappingURL=bootstrap.js.map
+//# sourceMappingURL=bootstrap.js.map

package/dist/plugins/bootstrap.js.map

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

package/dist/plugins/hooks.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Available Hook Points for the SimplyCMS Plugin System
+ *
+ * Based on BRD Section 8.2 — All available hook points that plugins can register handlers for.
+ */
+/** Inject additional items into the admin sidebar navigation. */
+export declare const HOOK_ADMIN_SIDEBAR_ITEMS: "admin.sidebar.items";
+/** Inject additional stat cards on the admin dashboard. */
+export declare const HOOK_ADMIN_DASHBOARD_STATS: "admin.dashboard.stats";
+/** Inject additional widgets on the admin dashboard. */
+export declare const HOOK_ADMIN_DASHBOARD_WIDGETS: "admin.dashboard.widgets";
+/** Render content before the admin product form fields. */
+export declare const HOOK_ADMIN_PRODUCT_FORM_BEFORE: "admin.product.form.before";
+/** Inject additional fields into the admin product form. */
+export declare const HOOK_ADMIN_PRODUCT_FORM_FIELDS: "admin.product.form.fields";
+/** Render content after the admin product form fields. */
+export declare const HOOK_ADMIN_PRODUCT_FORM_AFTER: "admin.product.form.after";
+/** Inject content into the admin product form sidebar. */
+export declare const HOOK_ADMIN_PRODUCT_FORM_SIDEBAR: "admin.product.form.sidebar";
+/** Inject settings UI for shipping methods in admin. */
+export declare const HOOK_ADMIN_SHIPPING_METHOD_SETTINGS: "admin.shipping.method.settings";
+/** Inject additional fields into the admin discount form. */
+export declare const HOOK_ADMIN_DISCOUNT_FORM_FIELDS: "admin.discount.form.fields";
+/** Render content before the product detail view on the storefront. */
+export declare const HOOK_PRODUCT_DETAIL_BEFORE: "product.detail.before";
+/** Render content after the product detail view on the storefront. */
+export declare const HOOK_PRODUCT_DETAIL_AFTER: "product.detail.after";
+/** Inject badges onto product cards in catalog/listings. */
+export declare const HOOK_PRODUCT_CARD_BADGES: "product.card.badges";
+/** Modify or add checkout steps. */
+export declare const HOOK_CHECKOUT_STEPS: "checkout.steps";
+/** Render content before the shipping selection step. */
+export declare const HOOK_CHECKOUT_SHIPPING_BEFORE: "checkout.shipping.before";
+/** Register additional shipping methods at checkout. */
+export declare const HOOK_CHECKOUT_SHIPPING_METHODS: "checkout.shipping.methods";
+/** Provide custom shipping rate calculations. */
+export declare const HOOK_CHECKOUT_SHIPPING_RATES: "checkout.shipping.rates";
+/** Inject additional form fields into the shipping step. */
+export declare const HOOK_CHECKOUT_SHIPPING_FORM: "checkout.shipping.form";
+/** Run custom validation on shipping data before proceeding. */
+export declare const HOOK_CHECKOUT_SHIPPING_VALIDATE: "checkout.shipping.validate";
+/** Render content after the shipping selection step. */
+export declare const HOOK_CHECKOUT_SHIPPING_AFTER: "checkout.shipping.after";
+/** Evaluate custom discount conditions. */
+export declare const HOOK_DISCOUNT_CONDITIONS_EVALUATE: "discount.conditions.evaluate";
+/** Run logic before a discount is applied. */
+export declare const HOOK_DISCOUNT_BEFORE_APPLY: "discount.before_apply";
+/** Run logic after a discount is applied. */
+export declare const HOOK_DISCOUNT_AFTER_APPLY: "discount.after_apply";
+/** Register custom discount types. */
+export declare const HOOK_DISCOUNT_TYPES: "discount.types";
+/** Inject additional actions into the order detail view. */
+export declare const HOOK_ORDER_ACTIONS: "order.actions";
+/** Triggered when a new order is created. */
+export declare const HOOK_ORDER_CREATED: "order.created";
+/** Triggered when an order status changes. */
+export declare const HOOK_ORDER_STATUS_CHANGED: "order.status_changed";
+/** Process shipping for an order (e.g., create label, notify carrier). */
+export declare const HOOK_ORDER_SHIPPING_PROCESS: "order.shipping.process";
+/** Run logic before a product is saved (create or update). */
+export declare const HOOK_PRODUCT_BEFORE_SAVE: "product.before_save";
+/** Triggered when a new user registers. */
+export declare const HOOK_USER_REGISTERED: "user.registered";
+/**
+ * Complete list of all hook point names for convenient enumeration.
+ */
+export declare const ALL_HOOKS: readonly ["admin.sidebar.items", "admin.dashboard.stats", "admin.dashboard.widgets", "admin.product.form.before", "admin.product.form.fields", "admin.product.form.after", "admin.product.form.sidebar", "admin.shipping.method.settings", "admin.discount.form.fields", "product.detail.before", "product.detail.after", "product.card.badges", "checkout.steps", "checkout.shipping.before", "checkout.shipping.methods", "checkout.shipping.rates", "checkout.shipping.form", "checkout.shipping.validate", "checkout.shipping.after", "discount.conditions.evaluate", "discount.before_apply", "discount.after_apply", "discount.types", "order.actions", "order.created", "order.status_changed", "order.shipping.process", "product.before_save", "user.registered"];

package/dist/plugins/index.d.ts

@@ -0,0 +1,12 @@
+export { hookRegistry } from './HookRegistry';
+export { default as HookRegistry } from './HookRegistry';
+export { loadPlugins, registerPluginModule, getRegisteredPluginModules, } from './PluginLoader';
+export { activatePlugin, deactivatePlugin, uninstallPlugin, } from './adminLifecycle';
+export { getAllPlugins, updatePluginConfig, installPlugin, } from './pluginRepository';
+export { bootstrapPlugins } from './bootstrap';
+export type { PluginRegistration } from './bootstrap';
+export { validatePluginModule } from './validatePluginModule';
+export { PluginSlot, usePluginSlot, getPluginSlotCount } from './PluginSlot';
+export { HOOK_ADMIN_SIDEBAR_ITEMS, HOOK_ADMIN_DASHBOARD_STATS, HOOK_ADMIN_DASHBOARD_WIDGETS, HOOK_ADMIN_PRODUCT_FORM_BEFORE, HOOK_ADMIN_PRODUCT_FORM_FIELDS, HOOK_ADMIN_PRODUCT_FORM_AFTER, HOOK_ADMIN_PRODUCT_FORM_SIDEBAR, HOOK_ADMIN_SHIPPING_METHOD_SETTINGS, HOOK_ADMIN_DISCOUNT_FORM_FIELDS, HOOK_PRODUCT_DETAIL_BEFORE, HOOK_PRODUCT_DETAIL_AFTER, HOOK_PRODUCT_CARD_BADGES, HOOK_CHECKOUT_STEPS, HOOK_CHECKOUT_SHIPPING_BEFORE, HOOK_CHECKOUT_SHIPPING_METHODS, HOOK_CHECKOUT_SHIPPING_RATES, HOOK_CHECKOUT_SHIPPING_FORM, HOOK_CHECKOUT_SHIPPING_VALIDATE, HOOK_CHECKOUT_SHIPPING_AFTER, HOOK_DISCOUNT_CONDITIONS_EVALUATE, HOOK_DISCOUNT_BEFORE_APPLY, HOOK_DISCOUNT_AFTER_APPLY, HOOK_DISCOUNT_TYPES, HOOK_ORDER_ACTIONS, HOOK_ORDER_CREATED, HOOK_ORDER_STATUS_CHANGED, HOOK_ORDER_SHIPPING_PROCESS, HOOK_PRODUCT_BEFORE_SAVE, HOOK_USER_REGISTERED, ALL_HOOKS, } from './hooks';
+export type { Plugin, ParsedPlugin, PluginManifest, PluginModule, PluginHookDefinition, HookHandler, HookRegistryInterface, RegisteredHook, HookName, SidebarItemHookResult, DashboardWidgetHookResult, FormFieldsHookResult, AdminSidebarContext, ProductFormContext, ProductDetailContext, OrderActionsContext, } from './types';
+export { parsePlugin } from './types';