@vitrine-kit/core 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vitrine Kit (Max Davydov)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @vitrine-kit/core
+
+Критическая логика Vitrine: runtime слотов и адаптера, order pipeline, обработчик Stripe-вебхука.
+
+Здесь — то, где «баг = инцидент у всех клиентов сразу» (§4 спеки). Поэтому это **версионируемый пакет**, а не copy-in: критфикс прилетает всем бампом версии.
+
+Скелет (M0). Наполняется в M2 (runtime) и M8 (коммерция).

package/dist/chunk-BQVNYHVU.js

@@ -0,0 +1,36 @@
+// src/slots/registry.ts
+function createSlotRegistry() {
+  const items = /* @__PURE__ */ new Map();
+  let seq = 0;
+  function register(mount) {
+    const list = items.get(mount.slot) ?? [];
+    list.push({ mount, seq: seq++ });
+    items.set(mount.slot, list);
+  }
+  function registerMany(mounts) {
+    for (const m of mounts) register(m);
+  }
+  function get(slot) {
+    const list = items.get(slot) ?? [];
+    return [...list].sort((a, b) => (a.mount.order ?? 0) - (b.mount.order ?? 0) || a.seq - b.seq).map((x) => x.mount);
+  }
+  function clear() {
+    items.clear();
+    seq = 0;
+  }
+  return { register, registerMany, get, clear };
+}
+var slotRegistry = createSlotRegistry();
+function registerSlot(mount) {
+  slotRegistry.register(mount);
+}
+function getSlotMounts(slot) {
+  return slotRegistry.get(slot);
+}
+
+export {
+  createSlotRegistry,
+  slotRegistry,
+  registerSlot,
+  getSlotMounts
+};

package/dist/index.d.ts

@@ -0,0 +1,146 @@
+export { S as SlotRegistry, c as createSlotRegistry, g as getSlotMounts, r as registerSlot, s as slotRegistry } from './registry-B4Ak1hIR.js';
+import { Backend, SiteConfig, CatalogSource, CommerceBackend, Cart, Order, Money, CurrencyCode, OrderStatus } from '@vitrine-kit/contracts';
+
+interface AdapterFactory {
+    backend: Backend;
+    createCatalog(config: SiteConfig): CatalogSource;
+    /** Отсутствует для чисто-каталожных бэкендов. */
+    createCommerce?(config: SiteConfig): CommerceBackend;
+}
+interface AdapterRegistry {
+    register(factory: AdapterFactory): void;
+    resolveCatalog(config: SiteConfig): CatalogSource;
+    resolveCommerce(config: SiteConfig): CommerceBackend;
+    clear(): void;
+}
+declare function createAdapterRegistry(): AdapterRegistry;
+/** Глобальный реестр адаптеров по умолчанию. */
+declare const adapters: AdapterRegistry;
+
+interface OrderPipelineContext {
+    cart: Cart;
+    /** Заполняется шагами пайплайна (создание заказа). */
+    order?: Order;
+    /** Произвольные данные шагов (платёж, резерв склада, доставка). */
+    meta: Record<string, unknown>;
+}
+type OrderStage<T = OrderPipelineContext> = (ctx: T) => T | Promise<T>;
+/**
+ * Последовательно прогоняет контекст через шаги. Любая ошибка шага прерывает
+ * пайплайн (откат/идемпотентность — ответственность конкретных шагов в M8).
+ */
+declare function runPipeline<T>(ctx: T, stages: ReadonlyArray<OrderStage<T>>): Promise<T>;
+
+interface OrderCreationGuard {
+    /** Статус корзины (карты Payload `carts`): 'converted' = уже оплачена. */
+    cartStatus?: string | null;
+    /** Референс платежа текущего события (session/transaction/payment id). */
+    providerRef?: string;
+    /** paymentRef уже существующих заказов (обычно результат точечного поиска). */
+    existingOrderRefs?: ReadonlyArray<string | undefined>;
+}
+/**
+ * Создавать ли заказ для этого события. false, если корзина уже converted ИЛИ
+ * для этого референса платежа заказ уже есть (повторная доставка/ретрай webhook).
+ */
+declare function shouldCreateOrder(guard: OrderCreationGuard): boolean;
+
+/** Совпадает с integrations.payments в site.config (контракт 4). */
+type PaymentProviderName = 'stripe' | 'paddle' | 'yookassa';
+interface CreateCheckoutArgs {
+    cart: Cart;
+    /** Базовый URL витрины; success/cancel строятся относительно него. */
+    baseUrl: string;
+    /** По умолчанию '/order/success'. */
+    successPath?: string;
+    /** По умолчанию '/cart'. */
+    cancelPath?: string;
+}
+interface PaymentWebhookRequest {
+    rawBody: string;
+    headers: Record<string, string | null>;
+}
+/** Нормализованное событие провайдера — общий язык для роутов вебхуков. */
+interface NormalizedPaymentEvent {
+    kind: 'checkout_completed' | 'payment_failed' | 'unknown';
+    /** Из metadata/custom_data/label провайдера. */
+    cartId?: string;
+    /** Уникальный референс платежа провайдера — ключ идемпотентности. */
+    providerRef?: string;
+    email?: string;
+    /** Исходный объект провайдера (на случай, если роуту нужны доп. поля). */
+    raw: unknown;
+}
+interface PaymentProvider {
+    name: PaymentProviderName;
+    /** Создаёт hosted-checkout у провайдера → URL для редиректа. */
+    createCheckout(args: CreateCheckoutArgs): Promise<{
+        redirectUrl: string;
+    }>;
+    /** Верифицирует подпись/подлинность и нормализует событие. Бросает при невалидном. */
+    verifyWebhook(req: PaymentWebhookRequest): Promise<NormalizedPaymentEvent>;
+}
+
+interface PaymentRegistry {
+    register(provider: PaymentProvider): void;
+    /** Активный провайдер по site.config.integrations.payments. */
+    resolve(config: SiteConfig): PaymentProvider;
+    get(name: PaymentProviderName): PaymentProvider | undefined;
+    clear(): void;
+}
+declare function createPaymentRegistry(): PaymentRegistry;
+/** Глобальный реестр провайдеров по умолчанию. */
+declare const payments: PaymentRegistry;
+
+interface PaymentWebhookHandlers {
+    onCheckoutCompleted?(event: NormalizedPaymentEvent): void | Promise<void>;
+    onPaymentFailed?(event: NormalizedPaymentEvent): void | Promise<void>;
+}
+interface PaymentWebhookResult {
+    received: true;
+    kind: NormalizedPaymentEvent['kind'];
+    /** Был ли зарегистрирован обработчик для этого вида события. */
+    handled: boolean;
+}
+declare function handlePaymentWebhook(args: {
+    provider: PaymentProvider;
+    req: PaymentWebhookRequest;
+    handlers?: PaymentWebhookHandlers;
+}): Promise<PaymentWebhookResult>;
+
+declare function computeLineTotal(unitPrice: Money, quantity: number): Money;
+/** Пустая корзина. */
+declare function emptyCart(id: string, currency: CurrencyCode): Cart;
+/** Пересчитывает lineTotal каждой строки и итоги (subtotal/total с учётом скидки). */
+declare function recalcCart(cart: Cart): Cart;
+interface NewLineInput {
+    id: string;
+    variantId: string;
+    productId: string;
+    title: string;
+    unitPrice: Money;
+    quantity: number;
+    image?: string;
+}
+/** Добавляет строку; если вариант уже в корзине — увеличивает количество. */
+declare function addCartLine(cart: Cart, input: NewLineInput): Cart;
+/** Меняет количество строки; quantity ≤ 0 удаляет строку. */
+declare function setCartLineQty(cart: Cart, lineId: string, quantity: number): Cart;
+declare function removeCartLine(cart: Cart, lineId: string): Cart;
+/** Суммарное число единиц в корзине (для индикатора в шапке). */
+declare function cartItemCount(cart: Cart): number;
+
+interface BuildOrderOptions {
+    id: string;
+    status?: OrderStatus;
+    email?: string;
+    number?: string;
+    /** ISO-8601; по умолчанию — сейчас. */
+    createdAt?: string;
+}
+/** Снимок корзины в заказ (после оплаты). Итоги берём из корзины — не пересчитываем. */
+declare function buildOrderFromCart(cart: Cart, opts: BuildOrderOptions): Order;
+
+declare const CORE_VERSION: "0.1.0";
+
+export { type AdapterFactory, type AdapterRegistry, type BuildOrderOptions, CORE_VERSION, type CreateCheckoutArgs, type NewLineInput, type NormalizedPaymentEvent, type OrderCreationGuard, type OrderPipelineContext, type OrderStage, type PaymentProvider, type PaymentProviderName, type PaymentRegistry, type PaymentWebhookHandlers, type PaymentWebhookRequest, type PaymentWebhookResult, adapters, addCartLine, buildOrderFromCart, cartItemCount, computeLineTotal, createAdapterRegistry, createPaymentRegistry, emptyCart, handlePaymentWebhook, payments, recalcCart, removeCartLine, runPipeline, setCartLineQty, shouldCreateOrder };

package/dist/index.js

@@ -0,0 +1,210 @@
+import {
+  createSlotRegistry,
+  getSlotMounts,
+  registerSlot,
+  slotRegistry
+} from "./chunk-BQVNYHVU.js";
+
+// src/adapter/resolver.ts
+function createAdapterRegistry() {
+  const factories = /* @__PURE__ */ new Map();
+  function register(factory) {
+    factories.set(factory.backend, factory);
+  }
+  function factoryFor(config) {
+    const f = factories.get(config.backend);
+    if (!f) {
+      throw new Error(`[vitrine] \u043D\u0435 \u0437\u0430\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u043E\u0432\u0430\u043D \u0430\u0434\u0430\u043F\u0442\u0435\u0440 \u0434\u043B\u044F backend "${config.backend}"`);
+    }
+    return f;
+  }
+  function resolveCatalog(config) {
+    return factoryFor(config).createCatalog(config);
+  }
+  function resolveCommerce(config) {
+    if (config.tier === "catalog") {
+      throw new Error('[vitrine] CommerceBackend \u043D\u0435\u0434\u043E\u0441\u0442\u0443\u043F\u0435\u043D \u043D\u0430 \u0443\u0440\u043E\u0432\u043D\u0435 tier "catalog"');
+    }
+    const f = factoryFor(config);
+    if (!f.createCommerce) {
+      throw new Error(`[vitrine] backend "${config.backend}" \u043D\u0435 \u0440\u0435\u0430\u043B\u0438\u0437\u0443\u0435\u0442 CommerceBackend`);
+    }
+    return f.createCommerce(config);
+  }
+  function clear() {
+    factories.clear();
+  }
+  return { register, resolveCatalog, resolveCommerce, clear };
+}
+var adapters = createAdapterRegistry();
+
+// src/order/pipeline.ts
+async function runPipeline(ctx, stages) {
+  let current = ctx;
+  for (const stage of stages) {
+    current = await stage(current);
+  }
+  return current;
+}
+
+// src/order/idempotency.ts
+function shouldCreateOrder(guard) {
+  if (guard.cartStatus === "converted") return false;
+  if (guard.providerRef && (guard.existingOrderRefs ?? []).includes(guard.providerRef)) {
+    return false;
+  }
+  return true;
+}
+
+// src/payment/registry.ts
+function createPaymentRegistry() {
+  const providers = /* @__PURE__ */ new Map();
+  function register(provider) {
+    providers.set(provider.name, provider);
+  }
+  function resolve(config) {
+    const name = config.integrations.payments;
+    if (!name) {
+      throw new Error(
+        "[vitrine] integrations.payments \u043D\u0435 \u0437\u0430\u0434\u0430\u043D \u0432 site.config \u2014 \u0443\u0441\u0442\u0430\u043D\u043E\u0432\u0438\u0442\u0435 \u0444\u0438\u0447\u0443 checkout-<provider>"
+      );
+    }
+    const provider = providers.get(name);
+    if (!provider) {
+      throw new Error(`[vitrine] \u043F\u043B\u0430\u0442\u0451\u0436\u043D\u044B\u0439 \u043F\u0440\u043E\u0432\u0430\u0439\u0434\u0435\u0440 "${name}" \u043D\u0435 \u0437\u0430\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u043E\u0432\u0430\u043D`);
+    }
+    return provider;
+  }
+  function get(name) {
+    return providers.get(name);
+  }
+  function clear() {
+    providers.clear();
+  }
+  return { register, resolve, get, clear };
+}
+var payments = createPaymentRegistry();
+
+// src/payment/webhook.ts
+async function handlePaymentWebhook(args) {
+  const event = await args.provider.verifyWebhook(args.req);
+  const handlers = args.handlers ?? {};
+  let handled = false;
+  switch (event.kind) {
+    case "checkout_completed":
+      if (handlers.onCheckoutCompleted) {
+        await handlers.onCheckoutCompleted(event);
+        handled = true;
+      }
+      break;
+    case "payment_failed":
+      if (handlers.onPaymentFailed) {
+        await handlers.onPaymentFailed(event);
+        handled = true;
+      }
+      break;
+  }
+  return { received: true, kind: event.kind, handled };
+}
+
+// src/commerce/cart.ts
+function computeLineTotal(unitPrice, quantity) {
+  return unitPrice * quantity;
+}
+function emptyCart(id, currency) {
+  return { id, lines: [], currency, subtotal: 0, total: 0 };
+}
+function recalcCart(cart) {
+  const lines = cart.lines.map((l) => ({ ...l, lineTotal: computeLineTotal(l.unitPrice, l.quantity) }));
+  const subtotal = lines.reduce((sum, l) => sum + l.lineTotal, 0);
+  const discountTotal = cart.discountTotal ?? 0;
+  const total = Math.max(0, subtotal - discountTotal);
+  return { ...cart, lines, subtotal, total };
+}
+function addCartLine(cart, input) {
+  if (!Number.isInteger(input.quantity) || input.quantity <= 0) {
+    throw new Error(`[vitrine] \u043D\u0435\u0434\u043E\u043F\u0443\u0441\u0442\u0438\u043C\u043E\u0435 \u043A\u043E\u043B\u0438\u0447\u0435\u0441\u0442\u0432\u043E \u0441\u0442\u0440\u043E\u043A\u0438: ${input.quantity} (\u043D\u0443\u0436\u043D\u043E \u0446\u0435\u043B\u043E\u0435 > 0)`);
+  }
+  const exists = cart.lines.some((l) => l.variantId === input.variantId);
+  const lines = exists ? cart.lines.map(
+    (l) => l.variantId === input.variantId ? { ...l, quantity: l.quantity + input.quantity } : l
+  ) : [
+    ...cart.lines,
+    {
+      id: input.id,
+      variantId: input.variantId,
+      productId: input.productId,
+      title: input.title,
+      quantity: input.quantity,
+      unitPrice: input.unitPrice,
+      lineTotal: computeLineTotal(input.unitPrice, input.quantity),
+      image: input.image
+    }
+  ];
+  return recalcCart({ ...cart, lines });
+}
+function setCartLineQty(cart, lineId, quantity) {
+  if (!Number.isInteger(quantity)) {
+    throw new Error(`[vitrine] \u043D\u0435\u0434\u043E\u043F\u0443\u0441\u0442\u0438\u043C\u043E\u0435 \u043A\u043E\u043B\u0438\u0447\u0435\u0441\u0442\u0432\u043E: ${quantity} (\u043D\u0443\u0436\u043D\u043E \u0446\u0435\u043B\u043E\u0435)`);
+  }
+  if (quantity <= 0) return removeCartLine(cart, lineId);
+  return recalcCart({
+    ...cart,
+    lines: cart.lines.map((l) => l.id === lineId ? { ...l, quantity } : l)
+  });
+}
+function removeCartLine(cart, lineId) {
+  return recalcCart({ ...cart, lines: cart.lines.filter((l) => l.id !== lineId) });
+}
+function cartItemCount(cart) {
+  return cart.lines.reduce((n, l) => n + l.quantity, 0);
+}
+
+// src/commerce/order.ts
+function buildOrderFromCart(cart, opts) {
+  const lines = cart.lines.map((l) => ({
+    variantId: l.variantId,
+    productId: l.productId,
+    title: l.title,
+    quantity: l.quantity,
+    unitPrice: l.unitPrice,
+    lineTotal: l.lineTotal
+  }));
+  return {
+    id: opts.id,
+    number: opts.number,
+    status: opts.status ?? "paid",
+    lines,
+    currency: cart.currency,
+    subtotal: cart.subtotal,
+    discountTotal: cart.discountTotal,
+    total: cart.total,
+    email: opts.email,
+    createdAt: opts.createdAt ?? (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+
+// src/index.ts
+var CORE_VERSION = "0.1.0";
+export {
+  CORE_VERSION,
+  adapters,
+  addCartLine,
+  buildOrderFromCart,
+  cartItemCount,
+  computeLineTotal,
+  createAdapterRegistry,
+  createPaymentRegistry,
+  createSlotRegistry,
+  emptyCart,
+  getSlotMounts,
+  handlePaymentWebhook,
+  payments,
+  recalcCart,
+  registerSlot,
+  removeCartLine,
+  runPipeline,
+  setCartLineQty,
+  shouldCreateOrder,
+  slotRegistry
+};

package/dist/react.d.ts

@@ -0,0 +1,17 @@
+import { ComponentType, ReactNode } from 'react';
+import { SlotId } from '@vitrine-kit/contracts';
+import { S as SlotRegistry } from './registry-B4Ak1hIR.js';
+
+type SlotComponentRegistry = SlotRegistry<ComponentType<Record<string, unknown>>>;
+interface SlotProps {
+    name: SlotId;
+    /** Реестр (по умолчанию — глобальный). Для тестов/изоляции можно передать свой. */
+    registry?: SlotComponentRegistry;
+    /** Что рендерить, если слот пуст. */
+    fallback?: ReactNode;
+    /** Остальные пропсы прокидываются в каждый смонтированный компонент. */
+    [prop: string]: unknown;
+}
+declare function Slot(props: SlotProps): ReactNode;
+
+export { Slot, type SlotProps };

package/dist/react.js

@@ -0,0 +1,23 @@
+import {
+  slotRegistry
+} from "./chunk-BQVNYHVU.js";
+
+// src/react.ts
+import {
+  createElement,
+  Fragment
+} from "react";
+function Slot(props) {
+  const { name, registry, fallback = null, ...rest } = props;
+  const reg = registry ?? slotRegistry;
+  const mounts = reg.get(name);
+  if (mounts.length === 0) return fallback;
+  return createElement(
+    Fragment,
+    null,
+    ...mounts.map((m, i) => createElement(m.component, { key: i, ...rest }))
+  );
+}
+export {
+  Slot
+};

package/dist/registry-B4Ak1hIR.d.ts

@@ -0,0 +1,16 @@
+import { SlotMount, SlotId } from '@vitrine-kit/contracts';
+
+interface SlotRegistry<C = unknown> {
+    register(mount: SlotMount<C>): void;
+    registerMany(mounts: ReadonlyArray<SlotMount<C>>): void;
+    /** Привязки слота, отсортированные по order (стабильно по порядку регистрации). */
+    get(slot: SlotId): SlotMount<C>[];
+    clear(): void;
+}
+declare function createSlotRegistry<C = unknown>(): SlotRegistry<C>;
+/** Глобальный реестр по умолчанию (клиент регистрирует слоты в lib/slots.ts). */
+declare const slotRegistry: SlotRegistry;
+declare function registerSlot<C = unknown>(mount: SlotMount<C>): void;
+declare function getSlotMounts<C = unknown>(slot: SlotId): SlotMount<C>[];
+
+export { type SlotRegistry as S, createSlotRegistry as c, getSlotMounts as g, registerSlot as r, slotRegistry as s };

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@vitrine-kit/core",
+  "version": "0.2.0",
+  "description": "Vitrine core — runtime слотов/адаптера, order pipeline, Stripe webhook. Критическая логика (баг = инцидент у всех).",
+  "license": "MIT",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vitrine-kit/vitrine.git",
+    "directory": "packages/core"
+  },
+  "dependencies": {
+    "@vitrine-kit/contracts": "1.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.12",
+    "react": "^18.3.1"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/react.ts --format esm --dts --clean",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}