simplycms 0.4.0

package/dist/db/actor.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Актор транзакції та ЧИСТА побудова її преамбули (Task 6, В2-К1а).
+ *
+ * Винесено з `./with-actor` навмисно: форма SQL і валідація аргументів — це
+ * рівно те, що можна довести юнітом БЕЗ Postgres, тож вони не мають ховатися
+ * всередині обгортки, яка без БД не запускається.
+ */
+/**
+ * Ролі БД, під якими виконується запит (B5″). Обидві — nologin, обидві
+ * видаються рантайм-ролі через `SET LOCAL ROLE`. `app_runtime` у переліку
+ * НЕМАЄ свідомо: вона не має прямих грантів, і працювати під нею — це і є
+ * той fail-closed, який дизайн вимагає лишити недосяжним.
+ */
+export type ActorRole = 'app_user' | 'app_admin';
+/** Хто саме виконує транзакцію. */
+export interface Actor {
+    /** Роль БД; вмикається `SET LOCAL ROLE` після типізованої перевірки в TS. */
+    readonly role: ActorRole;
+    /** UUID користувача або `null`/відсутнє для аноніма й гостя. */
+    readonly userId?: string | null;
+    /** Токен гостьового замовлення (GUC `app.order_token`). */
+    readonly orderToken?: string | null;
+}
+/** Один стейтмент преамбули: текст + параметри. */
+export interface PreludeStatement {
+    readonly text: string;
+    readonly values: readonly string[];
+}
+/**
+ * Перевіряє роль ДО походу в БД.
+ *
+ * 🔴 Причина не в типах: `SET LOCAL ROLE` не параметризується (це команда
+ * сесії, а не вираз), тож імʼя ролі неминуче потрапляє в SQL інтерполяцією.
+ * TS-тип на межі процесу нічого не гарантує — значення могло приїхати з JSON
+ * запиту. Замкнений перелік тут і є те, що робить інтерполяцію безпечною.
+ */
+export declare function assertActorRole(role: string): asserts role is ActorRole;
+/**
+ * Стейтменти преамбули актора у ФІКСОВАНОМУ порядку:
+ * claims → `SET LOCAL ROLE`.
+ *
+ * 🔴 Порядок не косметичний: після перемикання ролі права звужуються, і
+ * преамбула мусить завершитись раніше, ніж почнеться робота під ними.
+ *
+ * 🔴 Обидва GUC виставляються ЗАВЖДИ, навіть у порожнє значення. По-перше,
+ * `app.current_user_id()` і предикат гостьового замовлення читають їх через
+ * `nullif(…, '')`, тож порожній рядок — це коректний «нікого немає».
+ * По-друге, зʼєднання приходить із ПУЛУ: якби хтось раніше виставив той
+ * самий GUC сесійно, пропущений `set_config` лишив би чужу ідентичність, а
+ * безумовний — перекриває її на цю транзакцію.
+ *
+ * 🔴 Третій аргумент `set_config` — завжди `true` (local), і параметром він
+ * не робиться НІКОЛИ: з `false` значення живе до кінця зʼєднання, а не
+ * транзакції, тобто наступний клієнт пулу дістав би чужі claims. Це не
+ * теорія — витік виміряно негативним контролем гейта RLS (Task 5).
+ */
+export declare function buildActorPrelude(actor: Actor): PreludeStatement[];

package/dist/db/client.d.ts

@@ -0,0 +1,46 @@
+import pg from 'pg';
+/**
+ * Пул зʼєднань до Postgres — server-only фабрика db-рантайму (Task 6, В2-К1а).
+ *
+ * 🔴 Модуль НЕ призначений для прямого вжитку: єдиний легальний споживач —
+ * `./with-actor`. Голе зʼєднання відкриває обидва тихі режими відмови, які
+ * весь дизайн B5″ і виключає: запит без `SET LOCAL ROLE` (fail-closed зникає,
+ * якщо конектитись власником) і claims, виставлені поза транзакцією (течуть
+ * на наступного клієнта пулу). Тому імпорт `simplycms/db/client` поза текою
+ * `src/db/` — помилка лінту (зона в `eslint.config.mjs`, негативний контроль —
+ * `tests/db-client-boundary.test.ts`), а в `exports`-мапі пакета цього
+ * субшляху немає взагалі: магазин фізично не має до нього шляху.
+ */
+/** Джерело змінних оточення (той самий контракт, що в `supabase/keys`). */
+export interface DbEnv {
+    readonly DATABASE_URL?: string;
+}
+/**
+ * Резолвить рядок підключення до Postgres.
+ *
+ * 🔴 Виділено окремою чистою функцією навмисно: так контракт env перевіряється
+ * юнітом без БД, а фабрика нижче лишається тонкою.
+ *
+ * @throws Error якщо `DATABASE_URL` відсутній або порожній.
+ */
+export declare function resolveDatabaseUrl(env: DbEnv): string;
+/**
+ * Пул процесу (лінива синглтон-фабрика).
+ *
+ * Контракт серверного env (спека CLI v1, §7): `DATABASE_URL` читається ЛИШЕ з
+ * `process.env` і ЛИШЕ тут, у рантаймі — не на модуль-рівні. Наслідок той
+ * самий, що й у Supabase-фабрик: зміна рядка підключення = перезапуск
+ * процесу, без перезбірки. Другий виклик віддає ВЖЕ створений пул, тож
+ * підміна `DATABASE_URL` посеред життя процесу нічого не змінить — це не
+ * недогляд, а та сама семантика «рестарт замість гарячої ротації».
+ *
+ * @throws Error у браузері (див. server-only гард нижче).
+ */
+export declare function getDbPool(): pg.Pool;
+/**
+ * Гасить пул процесу (graceful shutdown, teardown тестів).
+ *
+ * Ідемпотентна: другий виклик — no-op. Після неї наступний `getDbPool()`
+ * створює пул наново — саме тому тести можуть перемикати `DATABASE_URL`.
+ */
+export declare function closeDbPool(): Promise<void>;

package/dist/db/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `simplycms/db` — db-рантайм серверного контуру v2 (Task 6, В2-К1а).
+ *
+ * Публічна поверхня навмисно вузька: транзакційна обгортка актора і гасіння
+ * пулу. `getDbPool` тут НЕ реекспортується — інакше заборона на
+ * `simplycms/db/client` обходилася б через барель одним символом, і обидва
+ * тихі режими відмови (запит без `SET LOCAL ROLE`, claims поза транзакцією)
+ * повернулися б.
+ */
+export { withActor, type ActorDb } from './with-actor';
+export type { Actor, ActorRole } from './actor';
+export { closeDbPool } from './client';

package/dist/db/index.js

@@ -0,0 +1,88 @@
+import { drizzle } from 'drizzle-orm/node-postgres';
+import pg from 'pg';
+
+// src/db/with-actor.ts
+
+// src/db/actor.ts
+var ACTOR_ROLES = ["app_user", "app_admin"];
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function assertActorRole(role) {
+  if (!ACTOR_ROLES.includes(role)) {
+    throw new Error(
+      `[simplycms/db] \u041D\u0435\u0432\u0456\u0434\u043E\u043C\u0430 \u0440\u043E\u043B\u044C \u0430\u043A\u0442\u043E\u0440\u0430: ${JSON.stringify(role)}. \u0414\u043E\u0437\u0432\u043E\u043B\u0435\u043D\u0456 \u2014 ${ACTOR_ROLES.join(", ")}.`
+    );
+  }
+}
+function buildActorPrelude(actor) {
+  assertActorRole(actor.role);
+  const userId = actor.userId ?? "";
+  if (userId !== "" && !UUID_RE.test(userId)) {
+    throw new Error(
+      `[simplycms/db] userId \u043C\u0430\u0454 \u0431\u0443\u0442\u0438 UUID, \u043E\u0442\u0440\u0438\u043C\u0430\u043D\u043E ${JSON.stringify(userId)}.`
+    );
+  }
+  return [
+    { text: `select set_config('app.user_id', $1, true)`, values: [userId] },
+    {
+      text: `select set_config('app.order_token', $1, true)`,
+      values: [actor.orderToken ?? ""]
+    },
+    // Інтерполяція безпечна рівно завдяки `assertActorRole` вище.
+    { text: `set local role ${actor.role}`, values: [] }
+  ];
+}
+function resolveDatabaseUrl(env) {
+  const url = env.DATABASE_URL || void 0;
+  if (!url) {
+    throw new Error(
+      "[simplycms/db] \u0412\u0456\u0434\u0441\u0443\u0442\u043D\u044F \u0437\u043C\u0456\u043D\u043D\u0430 \u043E\u0442\u043E\u0447\u0435\u043D\u043D\u044F DATABASE_URL \u2014 \u0441\u0435\u0440\u0432\u0435\u0440\u043D\u0438\u0439 \u043A\u043E\u043D\u0442\u0443\u0440 \u043D\u0435 \u043C\u0430\u0454 \u043A\u0443\u0434\u0438 \u043F\u0456\u0434\u043A\u043B\u044E\u0447\u0430\u0442\u0438\u0441\u044F. \u041A\u043E\u043D\u0442\u0440\u0430\u043A\u0442 \u0441\u0435\u0440\u0432\u0435\u0440\u043D\u043E\u0433\u043E env \u2014 \u0441\u043F\u0435\u043A\u0430 CLI v1 \xA77 (\u043B\u0438\u0448\u0435 process.env, \u043B\u0438\u0448\u0435 \u0432 \u0440\u0430\u043D\u0442\u0430\u0439\u043C\u0456)."
+    );
+  }
+  return url;
+}
+var pool;
+function getDbPool() {
+  if (typeof window !== "undefined") {
+    throw new Error(
+      "[simplycms/db] \u041F\u0443\u043B Postgres \u2014 server-only: \u0443 \u0441\u0435\u0440\u0432\u0435\u0440-first (B1) \u0431\u0440\u0430\u0443\u0437\u0435\u0440 \u0434\u043E \u0411\u0414 \u043D\u0435 \u0445\u043E\u0434\u0438\u0442\u044C \u0443\u0437\u0430\u0433\u0430\u043B\u0456. \u041C\u043E\u0434\u0443\u043B\u044C \u043F\u043E\u0442\u0440\u0430\u043F\u0438\u0432 \u0443 \u043A\u043B\u0456\u0454\u043D\u0442\u0441\u044C\u043A\u0438\u0439 \u0431\u0430\u043D\u0434\u043B \u2014 \u0448\u0443\u043A\u0430\u0439 \u0456\u043C\u043F\u043E\u0440\u0442 \u0437 \u043A\u043B\u0456\u0454\u043D\u0442\u0441\u044C\u043A\u043E\u0433\u043E \u043A\u043E\u043D\u0442\u0443\u0440\u0443."
+    );
+  }
+  pool ??= new pg.Pool({ connectionString: resolveDatabaseUrl(process.env) });
+  return pool;
+}
+async function closeDbPool() {
+  const current = pool;
+  pool = void 0;
+  await current?.end();
+}
+
+// src/db/with-actor.ts
+async function withActor(actor, fn) {
+  const prelude = buildActorPrelude(actor);
+  const client = await getDbPool().connect();
+  try {
+    await client.query("begin");
+    try {
+      for (const statement of prelude)
+        await client.query(statement.text, [...statement.values]);
+      const result = await fn(drizzle(client), client);
+      await client.query("commit");
+      return result;
+    } catch (error) {
+      await rollbackQuietly(client);
+      throw error;
+    }
+  } finally {
+    client.release();
+  }
+}
+async function rollbackQuietly(client) {
+  try {
+    await client.query("rollback");
+  } catch {
+  }
+}
+
+export { closeDbPool, withActor };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/db/actor.ts","../../src/db/client.ts","../../src/db/with-actor.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Актор транзакції та ЧИСТА побудова її преамбули (Task 6, В2-К1а).\n *\n * Винесено з `./with-actor` навмисно: форма SQL і валідація аргументів — це\n * рівно те, що можна довести юнітом БЕЗ Postgres, тож вони не мають ховатися\n * всередині обгортки, яка без БД не запускається.\n */\n\n/**\n * Ролі БД, під якими виконується запит (B5″). Обидві — nologin, обидві\n * видаються рантайм-ролі через `SET LOCAL ROLE`. `app_runtime` у переліку\n * НЕМАЄ свідомо: вона не має прямих грантів, і працювати під нею — це і є\n * той fail-closed, який дизайн вимагає лишити недосяжним.\n */\nexport type ActorRole = 'app_user' | 'app_admin';\n\nconst ACTOR_ROLES: readonly ActorRole[] = ['app_user', 'app_admin'];\n\n/** Хто саме виконує транзакцію. */\nexport interface Actor {\n  /** Роль БД; вмикається `SET LOCAL ROLE` після типізованої перевірки в TS. */\n  readonly role: ActorRole;\n  /** UUID користувача або `null`/відсутнє для аноніма й гостя. */\n  readonly userId?: string | null;\n  /** Токен гостьового замовлення (GUC `app.order_token`). */\n  readonly orderToken?: string | null;\n}\n\n/** Один стейтмент преамбули: текст + параметри. */\nexport interface PreludeStatement {\n  readonly text: string;\n  readonly values: readonly string[];\n}\n\nconst UUID_RE =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\n/**\n * Перевіряє роль ДО походу в БД.\n *\n * 🔴 Причина не в типах: `SET LOCAL ROLE` не параметризується (це команда\n * сесії, а не вираз), тож імʼя ролі неминуче потрапляє в SQL інтерполяцією.\n * TS-тип на межі процесу нічого не гарантує — значення могло приїхати з JSON\n * запиту. Замкнений перелік тут і є те, що робить інтерполяцію безпечною.\n */\nexport function assertActorRole(role: string): asserts role is ActorRole {\n  if (!ACTOR_ROLES.includes(role as ActorRole)) {\n    throw new Error(\n      `[simplycms/db] Невідома роль актора: ${JSON.stringify(role)}. ` +\n        `Дозволені — ${ACTOR_ROLES.join(', ')}.`,\n    );\n  }\n}\n\n/**\n * Стейтменти преамбули актора у ФІКСОВАНОМУ порядку:\n * claims → `SET LOCAL ROLE`.\n *\n * 🔴 Порядок не косметичний: після перемикання ролі права звужуються, і\n * преамбула мусить завершитись раніше, ніж почнеться робота під ними.\n *\n * 🔴 Обидва GUC виставляються ЗАВЖДИ, навіть у порожнє значення. По-перше,\n * `app.current_user_id()` і предикат гостьового замовлення читають їх через\n * `nullif(…, '')`, тож порожній рядок — це коректний «нікого немає».\n * По-друге, зʼєднання приходить із ПУЛУ: якби хтось раніше виставив той\n * самий GUC сесійно, пропущений `set_config` лишив би чужу ідентичність, а\n * безумовний — перекриває її на цю транзакцію.\n *\n * 🔴 Третій аргумент `set_config` — завжди `true` (local), і параметром він\n * не робиться НІКОЛИ: з `false` значення живе до кінця зʼєднання, а не\n * транзакції, тобто наступний клієнт пулу дістав би чужі claims. Це не\n * теорія — витік виміряно негативним контролем гейта RLS (Task 5).\n */\nexport function buildActorPrelude(actor: Actor): PreludeStatement[] {\n  assertActorRole(actor.role);\n\n  const userId = actor.userId ?? '';\n  if (userId !== '' && !UUID_RE.test(userId)) {\n    // Без цієї перевірки помилка вилізла б аж у `::uuid` всередині\n    // `app.current_user_id()` — тобто на першому ж читанні таблиці, і\n    // діагноз виглядав би як проблема політики, а не аргументу.\n    throw new Error(\n      `[simplycms/db] userId має бути UUID, отримано ${JSON.stringify(userId)}.`,\n    );\n  }\n\n  return [\n    { text: `select set_config('app.user_id', $1, true)`, values: [userId] },\n    {\n      text: `select set_config('app.order_token', $1, true)`,\n      values: [actor.orderToken ?? ''],\n    },\n    // Інтерполяція безпечна рівно завдяки `assertActorRole` вище.\n    { text: `set local role ${actor.role}`, values: [] },\n  ];\n}\n","import pg from 'pg';\n\n/**\n * Пул зʼєднань до Postgres — server-only фабрика db-рантайму (Task 6, В2-К1а).\n *\n * 🔴 Модуль НЕ призначений для прямого вжитку: єдиний легальний споживач —\n * `./with-actor`. Голе зʼєднання відкриває обидва тихі режими відмови, які\n * весь дизайн B5″ і виключає: запит без `SET LOCAL ROLE` (fail-closed зникає,\n * якщо конектитись власником) і claims, виставлені поза транзакцією (течуть\n * на наступного клієнта пулу). Тому імпорт `simplycms/db/client` поза текою\n * `src/db/` — помилка лінту (зона в `eslint.config.mjs`, негативний контроль —\n * `tests/db-client-boundary.test.ts`), а в `exports`-мапі пакета цього\n * субшляху немає взагалі: магазин фізично не має до нього шляху.\n */\n\n/** Джерело змінних оточення (той самий контракт, що в `supabase/keys`). */\nexport interface DbEnv {\n  readonly DATABASE_URL?: string;\n}\n\n/**\n * Резолвить рядок підключення до Postgres.\n *\n * 🔴 Виділено окремою чистою функцією навмисно: так контракт env перевіряється\n * юнітом без БД, а фабрика нижче лишається тонкою.\n *\n * @throws Error якщо `DATABASE_URL` відсутній або порожній.\n */\nexport function resolveDatabaseUrl(env: DbEnv): string {\n  // `||`, а не `??`: оголошена-але-порожня змінна в `.env` — це відсутній\n  // ключ, інакше `DATABASE_URL=` мовчки дав би конект у нікуди.\n  const url = env.DATABASE_URL || undefined;\n\n  if (!url) {\n    throw new Error(\n      '[simplycms/db] Відсутня змінна оточення DATABASE_URL — серверний ' +\n        'контур не має куди підключатися. Контракт серверного env — спека ' +\n        'CLI v1 §7 (лише process.env, лише в рантаймі).',\n    );\n  }\n\n  return url;\n}\n\nlet pool: pg.Pool | undefined;\n\n/**\n * Пул процесу (лінива синглтон-фабрика).\n *\n * Контракт серверного env (спека CLI v1, §7): `DATABASE_URL` читається ЛИШЕ з\n * `process.env` і ЛИШЕ тут, у рантаймі — не на модуль-рівні. Наслідок той\n * самий, що й у Supabase-фабрик: зміна рядка підключення = перезапуск\n * процесу, без перезбірки. Другий виклик віддає ВЖЕ створений пул, тож\n * підміна `DATABASE_URL` посеред життя процесу нічого не змінить — це не\n * недогляд, а та сама семантика «рестарт замість гарячої ротації».\n *\n * @throws Error у браузері (див. server-only гард нижче).\n */\nexport function getDbPool(): pg.Pool {\n  // Server-only гард. `supabase/anon-client` покладався на те, що голий\n  // `process.env` у браузері впаде сам; тут падіння було б глибоко в `pg`\n  // і без діагнозу, тож причина називається явно.\n  if (typeof window !== 'undefined') {\n    throw new Error(\n      '[simplycms/db] Пул Postgres — server-only: у сервер-first (B1) ' +\n        'браузер до БД не ходить узагалі. Модуль потрапив у клієнтський ' +\n        'бандл — шукай імпорт з клієнтського контуру.',\n    );\n  }\n\n  pool ??= new pg.Pool({ connectionString: resolveDatabaseUrl(process.env) });\n  return pool;\n}\n\n/**\n * Гасить пул процесу (graceful shutdown, teardown тестів).\n *\n * Ідемпотентна: другий виклик — no-op. Після неї наступний `getDbPool()`\n * створює пул наново — саме тому тести можуть перемикати `DATABASE_URL`.\n */\nexport async function closeDbPool(): Promise<void> {\n  const current = pool;\n  pool = undefined;\n  await current?.end();\n}\n","import { drizzle, type NodePgDatabase } from 'drizzle-orm/node-postgres';\nimport type pg from 'pg';\nimport { buildActorPrelude, type Actor } from './actor';\nimport { getDbPool } from './client';\n\n/**\n * Транзакційна обгортка актора — ЄДИНИЙ канал до Postgres (Task 6, В2-К1а).\n *\n * Форма транзакції зафіксована контрактом B5″ і повторює ту, яку незалежно\n * міряє поведінковий гейт RLS (`test-harness/pg/actors.mjs`):\n *\n *   BEGIN;\n *   select set_config('app.user_id', <uuid|''>, true);\n *   select set_config('app.order_token', <token|''>, true);\n *   SET LOCAL ROLE app_user|app_admin;\n *   …робота…\n *   COMMIT;                      -- або ROLLBACK на будь-якому винятку\n *\n * 🔴 `SET LOCAL ROLE` — обовʼязковий, а не опційний. Застосунок логіниться як\n * `app_runtime`, у якої прямих грантів немає: без перемикання ролі будь-який\n * запит дає `permission denied`. Це не дефект обгортки, а весь сенс\n * fail-closed — забутий крок мусить бути гучним, а не тихо працювати з\n * правами власника таблиць.\n */\n\n/** Drizzle-інстанс, прибіндований до зʼєднання ЦІЄЇ транзакції. */\nexport type ActorDb = NodePgDatabase<Record<string, never>>;\n\n/**\n * Виконує `fn` в одній транзакції від імені `actor`.\n *\n * `fn` отримує drizzle над зʼєднанням саме цієї транзакції — не над пулом:\n * інстанс над пулом брав би для кожного запиту ДОВІЛЬНЕ зʼєднання, тобто\n * поза транзакцією, без claims і без ролі. Тому «взяти db глобально» тут\n * неможливо за побудовою.\n *\n * Значення, повернуте `fn`, віддається назовні після COMMIT. Будь-який\n * виняток (у т.ч. `permission denied` чи порушення WITH CHECK) відкочує\n * транзакцію й прокидується далі — саме на ньому й тримається контракт.\n */\nexport async function withActor<T>(\n  actor: Actor,\n  fn: (db: ActorDb, client: pg.PoolClient) => Promise<T>,\n): Promise<T> {\n  // Преамбула будується ДО `connect()`: невалідна роль чи userId не мають\n  // навіть займати зʼєднання пулу.\n  const prelude = buildActorPrelude(actor);\n  const client = await getDbPool().connect();\n\n  try {\n    await client.query('begin');\n    try {\n      for (const statement of prelude)\n        await client.query(statement.text, [...statement.values]);\n\n      const result = await fn(drizzle(client), client);\n      await client.query('commit');\n      return result;\n    } catch (error) {\n      await rollbackQuietly(client);\n      throw error;\n    }\n  } finally {\n    // 🔴 Повернення зʼєднання в пул — у `finally` і без умов. Витік тут не\n    // падає, а мовчки виїдає пул до повного зависання застосунку на\n    // `connect()`, тобто дає найгірший клас дефекту: симптом далеко від\n    // причини. Інтеграційний гейт доводить факт повернення тим, що наступна\n    // транзакція йде тим САМИМ backend pid.\n    client.release();\n  }\n}\n\n/**\n * ROLLBACK, який не підміняє собою первинну помилку.\n *\n * Якщо зʼєднання вже мертве (обрив, таймаут), сам `rollback` теж кине — і\n * назовні поїхала б помилка відкату замість справжньої причини. Тут вона\n * гаситься: транзакція мертвого зʼєднання й так не закоммітиться, а причину\n * викликач має побачити ту, що сталася першою.\n */\nasync function rollbackQuietly(client: pg.PoolClient): Promise<void> {\n  try {\n    await client.query('rollback');\n  } catch {\n    // Свідомо тихо — див. докблок вище.\n  }\n}\n"]}

package/dist/db/with-actor.d.ts

@@ -0,0 +1,37 @@
+import { type NodePgDatabase } from 'drizzle-orm/node-postgres';
+import type pg from 'pg';
+import { type Actor } from './actor';
+/**
+ * Транзакційна обгортка актора — ЄДИНИЙ канал до Postgres (Task 6, В2-К1а).
+ *
+ * Форма транзакції зафіксована контрактом B5″ і повторює ту, яку незалежно
+ * міряє поведінковий гейт RLS (`test-harness/pg/actors.mjs`):
+ *
+ *   BEGIN;
+ *   select set_config('app.user_id', <uuid|''>, true);
+ *   select set_config('app.order_token', <token|''>, true);
+ *   SET LOCAL ROLE app_user|app_admin;
+ *   …робота…
+ *   COMMIT;                      -- або ROLLBACK на будь-якому винятку
+ *
+ * 🔴 `SET LOCAL ROLE` — обовʼязковий, а не опційний. Застосунок логіниться як
+ * `app_runtime`, у якої прямих грантів немає: без перемикання ролі будь-який
+ * запит дає `permission denied`. Це не дефект обгортки, а весь сенс
+ * fail-closed — забутий крок мусить бути гучним, а не тихо працювати з
+ * правами власника таблиць.
+ */
+/** Drizzle-інстанс, прибіндований до зʼєднання ЦІЄЇ транзакції. */
+export type ActorDb = NodePgDatabase<Record<string, never>>;
+/**
+ * Виконує `fn` в одній транзакції від імені `actor`.
+ *
+ * `fn` отримує drizzle над зʼєднанням саме цієї транзакції — не над пулом:
+ * інстанс над пулом брав би для кожного запиту ДОВІЛЬНЕ зʼєднання, тобто
+ * поза транзакцією, без claims і без ролі. Тому «взяти db глобально» тут
+ * неможливо за побудовою.
+ *
+ * Значення, повернуте `fn`, віддається назовні після COMMIT. Будь-який
+ * виняток (у т.ч. `permission denied` чи порушення WITH CHECK) відкочує
+ * транзакцію й прокидується далі — саме на ньому й тримається контракт.
+ */
+export declare function withActor<T>(actor: Actor, fn: (db: ActorDb, client: pg.PoolClient) => Promise<T>): Promise<T>;

package/dist/domain/discounts.d.ts

@@ -0,0 +1,3 @@
+import type { DiscountGroup, DiscountContext, DiscountResult } from 'simplycms/contracts';
+export type { DiscountType, GroupOperator, TargetType, DiscountTarget, DiscountCondition, Discount, DiscountGroup, DiscountContext, AppliedDiscount, RejectedDiscount, DiscountResult, } from 'simplycms/contracts';
+export declare function resolveDiscount(basePrice: number, groups: DiscountGroup[], context: DiscountContext): DiscountResult;

package/dist/domain/discounts.js

@@ -0,0 +1,4 @@
+export { resolveDiscount } from '../chunk-MBDMH57M.js';
+import '../chunk-PZ5AY32C.js';
+//# sourceMappingURL=discounts.js.map
+//# sourceMappingURL=discounts.js.map

package/dist/domain/discounts.js.map

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

package/dist/domain/index.d.ts

@@ -0,0 +1,6 @@
+export * from './pricing';
+export * from './discounts';
+export * from './inventory';
+export * from './shipping';
+export * from './money';
+export * from './user-categories';

package/dist/domain/index.js

@@ -0,0 +1,9 @@
+export { resolvePrice } from '../chunk-IODBINZ4.js';
+export { calculateShipping, calculateShippingCost, findShippingZoneIn, formatShippingCost, resolveShippingRate } from '../chunk-2ZFFIRA7.js';
+export { evaluateCategoryRules } from '../chunk-D3G6XGKV.js';
+export { resolveDiscount } from '../chunk-MBDMH57M.js';
+export { calculateProductAvailability, enrichProductsWithAvailability } from '../chunk-V2Q67K4F.js';
+export { formatPrice } from '../chunk-E6TWPPJC.js';
+import '../chunk-PZ5AY32C.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

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

package/dist/domain/inventory.d.ts

@@ -0,0 +1,13 @@
+import type { StockData, ProductAvailabilityInput } from 'simplycms/contracts';
+export type { StockData, ProductAvailabilityInput } from 'simplycms/contracts';
+/**
+ * Обчислює доступність товару тією ж логікою, що й RPC get_stock_info:
+ * is_available = total_quantity > 0 OR stock_status = 'on_order'
+ */
+export declare function calculateProductAvailability(product: ProductAvailabilityInput, stockData: StockData): boolean;
+/**
+ * Збагачує товари полем isAvailable на основі даних про склад.
+ */
+export declare function enrichProductsWithAvailability<T extends ProductAvailabilityInput>(products: T[], modStockData: Record<string, number>): (T & {
+    isAvailable: boolean;
+})[];

package/dist/domain/inventory.js

@@ -0,0 +1,4 @@
+export { calculateProductAvailability, enrichProductsWithAvailability } from '../chunk-V2Q67K4F.js';
+import '../chunk-PZ5AY32C.js';
+//# sourceMappingURL=inventory.js.map
+//# sourceMappingURL=inventory.js.map

package/dist/domain/inventory.js.map

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

package/dist/domain/money.d.ts

@@ -0,0 +1,30 @@
+import type { ConfigProvider } from 'simplycms/contracts';
+/**
+ * Кількість знаків після коми.
+ *
+ * 🔴 Дефолт саме **0/2**, і це не смак. Тринадцять із чотирнадцяти кол-сайтів,
+ * які цей модуль заміщає, передавали рівно `minimumFractionDigits: 0` — і
+ * НІЧОГО більше. Для `style: 'currency'` невказаний `maximumFractionDigits`
+ * дорівнює розрядності валюти, тобто 2. Тому:
+ *   0/2 → "4 200 ₴" і "4 200,5 ₴"   (побайтово те саме, що було);
+ *   2/2 → "4 200,00 ₴"               (зайві нулі там, де їх не було);
+ *   0/0 → "4 201 ₴"                  (🔴 копійки ОКРУГЛЮЮТЬСЯ ГЕТЬ — це вже
+ *                                     неправильна сума, а не косметика).
+ * Перевірено прогоном на 4200 / 4200.5 / 4200.55 / 4200.555 / 0 / 99.9.
+ * Єдиний кол-сайт, що покладався на валютний дефолт 2/2
+ * (`admin/components/ProductModifications.tsx`), передає `2` явно.
+ */
+export interface FormatPriceOptions {
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+}
+/**
+ * Форматує ціну як "<число><NBSP><символ>" — саме такий порядок і роздільник
+ * (U+00A0, не звичайний пробіл) віддає `Intl.NumberFormat('uk-UA', { style:
+ * 'currency', ... })` для гривні, і його явно збережено, бо валютний хвіст
+ * тепер формуємо самі, а не Intl. 🔴 Порядок "число-символ" зафіксований під
+ * поточну вітрину (лише uk-UA в експлуатації, `simplycms.config.ts`) —
+ * per-locale розташування символу (напр. "$100" в en-US) поза межами цього
+ * фікса: воно б знову зажадало `style: 'currency'` з тими самими CLDR-ризиками.
+ */
+export declare function formatPrice(value: number, config: Pick<ConfigProvider, 'locale' | 'currency'>, options?: FormatPriceOptions): string;

package/dist/domain/money.js

@@ -0,0 +1,4 @@
+export { formatPrice } from '../chunk-E6TWPPJC.js';
+import '../chunk-PZ5AY32C.js';
+//# sourceMappingURL=money.js.map
+//# sourceMappingURL=money.js.map

package/dist/domain/money.js.map

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

package/dist/domain/pricing.d.ts

@@ -0,0 +1,7 @@
+import type { PriceEntry, ResolvedPrice } from 'simplycms/contracts';
+export type { PriceEntry, ResolvedPrice } from 'simplycms/contracts';
+/**
+ * Обирає ціну для товару/модифікації за типом ціни користувача,
+ * з відкатом до типу ціни за замовчуванням.
+ */
+export declare function resolvePrice(prices: PriceEntry[], priceTypeId: string | null, defaultPriceTypeId: string | null, modificationId?: string | null): ResolvedPrice;

package/dist/domain/pricing.js

@@ -0,0 +1,4 @@
+export { resolvePrice } from '../chunk-IODBINZ4.js';
+import '../chunk-PZ5AY32C.js';
+//# sourceMappingURL=pricing.js.map
+//# sourceMappingURL=pricing.js.map

package/dist/domain/pricing.js.map

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

package/dist/domain/shipping.d.ts

@@ -0,0 +1,68 @@
+import type { ConfigProvider, ShippingRate, ShippingCalculationContext, ShippingCalculationResult } from 'simplycms/contracts';
+export type { ShippingMethod, ShippingMethodType, ShippingCalculationType, ShippingZone, ShippingRate, PickupPoint, WorkingHours, Coordinates, ShippingCalculationContext, ShippingCalculationResult, ShippingFormData, } from 'simplycms/contracts';
+/**
+ * Розраховує вартість доставки за конфігурацією тарифу.
+ * Повертає -1, якщо тариф недоступний для цього замовлення.
+ */
+export declare function calculateShippingCost(rate: ShippingRate, context: ShippingCalculationContext): number;
+/**
+ * Розраховує доставку для методу з урахуванням зони й тарифів.
+ *
+ * Тонка обгортка над `resolveShippingRate` — лишена async заради наявних
+ * викликів; уся логіка живе в синхронній функції нижче.
+ */
+export declare function calculateShipping(context: ShippingCalculationContext, rates: ShippingRate[]): Promise<ShippingCalculationResult | null>;
+/**
+ * Той самий вибір тарифу, але СИНХРОННО.
+ *
+ * 🔴 Потрібен формі чекауту: вона малює вартість кожного способу доставки
+ * прямо в рендері, і `await` там неможливий. До В2-К1а форма мала ВЛАСНУ
+ * копію правила («перший тариф методу, `free_from` — нуль понад поріг») —
+ * тобто прайс у списку й прайс у підсумку рахувалися різним кодом. Тепер
+ * правило одне, і живе воно тут.
+ */
+export declare function resolveShippingRate(context: ShippingCalculationContext, rates: ShippingRate[]): ShippingCalculationResult | null;
+/**
+ * Підписи для двох НЕ-числових станів вартості доставки.
+ *
+ * 🔴 Передаються параметром, а не беруться з i18n усередині: `simplycms/domain`
+ * це тір T1 (pure-логіка, нуль залежностей крім `objects`), а `simplycms/i18n`
+ * — T2. Імпорт транслятора сюди був би ребром ВГОРУ по тірах. Тому домен
+ * володіє ЛОГІКОЮ (нуль → безкоштовно, `null`/відʼємне → за тарифами), а
+ * текстом володіє кол-сайт: `t('common.shipping.free')` тощо.
+ */
+export interface ShippingCostLabels {
+    /** Вартість невідома наперед — рахується за тарифами перевізника. */
+    byTariff: string;
+    /** Доставка безкоштовна. */
+    free: string;
+}
+/**
+ * Форматує вартість доставки для відображення.
+ *
+ * 🔴 `config` — обов'язковий (без дефолту), як і в `formatPrice`: це чиста
+ * T1-функція без доступу до `useEngine()`, тож локаль/валюту зобов'язаний
+ * передати кол-сайт (React-компонент бере їх з `useEngine().config`).
+ * Дефолт на кшталт `{ locale: 'uk-UA', currency: 'UAH' }` тут був би тим самим
+ * хардкодом, який цей модуль лагодить: магазин з іншою конфігурацією
+ * (`simplycms.config.ts`) мовчки отримав би не свою валюту.
+ * Раніше форматування йшло через `new Intl.NumberFormat('uk-UA', { style:
+ * 'currency', currency: 'UAH', minimumFractionDigits: 0 })` — дефолти
+ * `formatPrice` (0/2) відтворюють цей виклик побайтово (перевірено тестами).
+ *
+ * 🔴 `labels` теж обов'язкові: до 2026-08-09 функція повертала «За тарифами» і
+ * «Безкоштовно» рядковими літералами, і саме через це англомовний магазин
+ * показував українську вартість доставки в підсумку замовлення. Дефолт
+ * повернув би той самий дефект мовчки.
+ */
+export declare function formatShippingCost(cost: number | null, config: Pick<ConfigProvider, 'locale' | 'currency'>, labels: ShippingCostLabels): string;
+/**
+ * Знаходить найбільш специфічну зону доставки для міста клієнта
+ * серед уже завантажених зон (pure-частина findShippingZone).
+ * IO (запит зон) виконує CatalogRepository.getShippingZones.
+ */
+export declare function findShippingZoneIn<Z extends {
+    cities?: string[];
+    regions?: string[];
+    is_default: boolean;
+}>(zones: Z[], customerCity: string): Z | null;

package/dist/domain/shipping.js

@@ -0,0 +1,5 @@
+export { calculateShipping, calculateShippingCost, findShippingZoneIn, formatShippingCost, resolveShippingRate } from '../chunk-2ZFFIRA7.js';
+import '../chunk-E6TWPPJC.js';
+import '../chunk-PZ5AY32C.js';
+//# sourceMappingURL=shipping.js.map
+//# sourceMappingURL=shipping.js.map

package/dist/domain/shipping.js.map

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

package/dist/domain/user-categories/conditions.d.ts

@@ -0,0 +1,14 @@
+import type { CategoryRuleConditions, UserCategoryStats } from './types';
+/** Усі умови правила → true/false.
+ *
+ * 🔴 Оригінал ЗАВЖДИ рахує AND по всіх умовах, незалежно від `conditions.type`:
+ * `type = 'all'` лише вмикає дострокове переривання циклу на першій хибній
+ * умові (`EXIT` в plpgsql), `type = 'any'`/будь-що інше просто не перериває
+ * цикл раніше — але семантика AND лишається тією самою (нема жодного OR-гілки
+ * в коді). Це фактично мертва/непрацююча "any"-гілка оригіналу; порт
+ * відтворює її буквально, а не додає OR, якого в SQL не було.
+ *
+ * Порожній список умов (`conditions.rules = []`, дефолт стовпця в БД) —
+ * цикл по нулю елементів не змінює початкове `true`, тож правило вважається
+ * УМОВНО ВИКОНАНИМ («вакуумна істина»). Це навмисно, не хиба порту. */
+export declare function conditionsMatch(conditions: CategoryRuleConditions, stats: UserCategoryStats): boolean;

package/dist/domain/user-categories/engine.d.ts

@@ -0,0 +1,13 @@
+import type { CategoryRule, CategoryTransitionResult, UserCategoryStats } from './types';
+/**
+ * Чиста функція обчислення переходу категорії — заміна
+ * `check_category_rules(p_user_id)`. Нуль IO: усі дані (правила, поточна
+ * категорія, статистика) передаються на вхід, запис у БД — відповідальність
+ * виклику (serverFn К3).
+ *
+ * @param rules            Рядки `category_rules` (фільтр/сортування — робота
+ *                          цієї функції, як робив і оригінальний SQL-курсор).
+ * @param currentCategoryId Поточна `profiles.category_id` користувача.
+ * @param stats            Результат, еквівалентний `get_user_stats`.
+ */
+export declare function evaluateCategoryRules(rules: readonly CategoryRule[], currentCategoryId: string | null, stats: UserCategoryStats): CategoryTransitionResult;

package/dist/domain/user-categories/index.d.ts

@@ -0,0 +1,2 @@
+export { evaluateCategoryRules } from './engine';
+export type { CategoryRule, CategoryRuleCondition, CategoryRuleConditions, CategoryTransitionResult, UserCategoryStats, } from './types';

package/dist/domain/user-categories/index.js

@@ -0,0 +1,4 @@
+export { evaluateCategoryRules } from '../../chunk-D3G6XGKV.js';
+import '../../chunk-PZ5AY32C.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/domain/user-categories/index.js.map

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

package/dist/domain/user-categories/types.d.ts

@@ -0,0 +1,50 @@
+/** Одна умова з `conditions->'rules'[]`. Значення завжди текстові — так їх
+ *  віддає `jsonb ->> 'value'` в оригіналі; парсинг у число/дату — на совісті
+ *  конкретного поля (`engine.ts`). */
+export interface CategoryRuleCondition {
+    readonly field: string;
+    readonly operator: string;
+    readonly value: string;
+}
+/** `category_rules.conditions` — jsonb-стовпець. `type` в оригіналі впливав
+ *  ЛИШЕ на дострокове переривання циклу умов, не на семантику AND/OR (борг
+ *  оригіналу — див. коментар в `engine.ts`, повторюємо як є). */
+export interface CategoryRuleConditions {
+    readonly type?: string;
+    readonly rules: readonly CategoryRuleCondition[];
+}
+/** Рядок `category_rules`, звужений до полів, потрібних рушію переходу. */
+export interface CategoryRule {
+    readonly id: string;
+    readonly name: string;
+    readonly fromCategoryId: string | null;
+    readonly toCategoryId: string;
+    readonly conditions: CategoryRuleConditions;
+    readonly isActive: boolean;
+    readonly priority: number;
+}
+/** Статистика користувача — те, що повертав `get_user_stats(p_user_id)`.
+ *  Обчислення (JOIN по orders/order_statuses, EXTRACT з profiles.created_at)
+ *  лишається serverFn-шару К3 — тут лише готові значення. */
+export interface UserCategoryStats {
+    readonly totalPurchases: number;
+    readonly ordersCount: number;
+    readonly registrationDays: number;
+    readonly emailDomain: string | null;
+    readonly authProvider: string | null;
+    readonly utmSource: string | null;
+    readonly utmCampaign: string | null;
+}
+/** Рішення рушія. Коли `changed: true` — достатньо даних, щоб виклик (К3)
+ *  зробив `UPDATE profiles.category_id` + `INSERT user_category_history`
+ *  без повторного звернення до правил. */
+export type CategoryTransitionResult = {
+    readonly changed: false;
+} | {
+    readonly changed: true;
+    readonly ruleId: string;
+    readonly fromCategoryId: string | null;
+    readonly toCategoryId: string;
+    /** Той самий текст, що писав оригінал у `user_category_history.reason`. */
+    readonly reason: string;
+};

package/dist/i18n/I18nProvider.d.ts

@@ -0,0 +1,23 @@
+import { type ReactNode } from 'react';
+import type { Locale, Translator } from './types';
+/**
+ * Провайдер локалі. Ставиться в host-`__root.tsx` і обгортає ВСІ групи роутів.
+ *
+ * Транслятор мемоїзується по локалі й живе рівно стільки, скільки дерево
+ * рендера — жодного глобального стану, тож SSR кількох запитів безпечний.
+ * Локаль лежить у тому самому значенні контексту (не окремий провайдер) —
+ * `useThemeT` (`simplycms/themes`) потребує саме її для ланцюжка fallback
+ * каталогу теми, а заводити другий контекст заради одного рядка зайве.
+ */
+export declare function I18nProvider({ locale, children, }: {
+    locale: Locale;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** Транслятор поточного рендера. Кидає, якщо `I18nProvider` не змонтовано. */
+export declare function useT(): Translator;
+/**
+ * Активна локаль поточного рендера. Кидає, якщо `I18nProvider` не змонтовано —
+ * так само, як `useT()`, і з тієї самої причини (SSR-запит без локалі — це
+ * помилка збірки магазину).
+ */
+export declare function useLocale(): Locale;

package/dist/i18n/catalogs/en/admin/banners.d.ts

@@ -0,0 +1,3 @@
+import type { Catalog } from '../../../types';
+/** Банери — дзеркало `uk/admin/banners.ts`. */
+export declare const messages: Catalog;

package/dist/i18n/catalogs/en/admin/common.d.ts

@@ -0,0 +1,3 @@
+import type { Catalog } from '../../../types';
+/** Каркас адмінки — дзеркало `uk/admin/common.ts`. */
+export declare const messages: Catalog;