@vitrine-kit/payload-blueprint 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/payload-blueprint
+
+Базовые Payload-коллекции Vitrine и API `extend()` для **аддитивного** расширения их полей фичами (контракт 5, §5 спеки).
+
+Фича добавляет поля (`extend('product', { addFields })`), не ломая существующие. Версионируется как пакет.
+
+Скелет (M0). Наполняется в M2.

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import { BlueprintFieldDef, Extend } from '@vitrine-kit/contracts';
+
+interface BlueprintCollectionConfig {
+    slug: string;
+    fields: BlueprintFieldDef[];
+    /** Прочие опции коллекции Payload (admin, access, hooks, upload, auth, …). */
+    [option: string]: unknown;
+}
+declare const categoriesCollection: BlueprintCollectionConfig;
+declare const mediaCollection: BlueprintCollectionConfig;
+declare const usersCollection: BlueprintCollectionConfig;
+declare const variantsCollection: BlueprintCollectionConfig;
+declare const productsCollection: BlueprintCollectionConfig;
+declare const ordersCollection: BlueprintCollectionConfig;
+declare const cartsCollection: BlueprintCollectionConfig;
+/** Базовые коллекции в стабильном порядке. */
+declare const baseCollections: BlueprintCollectionConfig[];
+
+interface Blueprint {
+    extend: Extend;
+    /** Собирает базовые коллекции + аддитивные расширения. */
+    build(): BlueprintCollectionConfig[];
+}
+declare function createBlueprint(): Blueprint;
+
+declare const PAYLOAD_BLUEPRINT_VERSION: "0.1.0";
+
+export { type Blueprint, type BlueprintCollectionConfig, PAYLOAD_BLUEPRINT_VERSION, baseCollections, cartsCollection, categoriesCollection, createBlueprint, mediaCollection, ordersCollection, productsCollection, usersCollection, variantsCollection };

package/dist/index.js

@@ -0,0 +1,150 @@
+// src/collections.ts
+var f = (name, type, extra = {}) => ({ name, type, ...extra });
+var authenticated = ({ req }) => Boolean(req?.user);
+var adminOnly = { read: authenticated, create: authenticated, update: authenticated, delete: authenticated };
+var categoriesCollection = {
+  slug: "categories",
+  admin: { useAsTitle: "title" },
+  fields: [
+    f("title", "text", { required: true }),
+    f("slug", "text", { required: true, unique: true, index: true }),
+    f("description", "textarea"),
+    f("parent", "relationship", { relationTo: "categories" })
+  ]
+};
+var mediaCollection = {
+  slug: "media",
+  upload: true,
+  fields: [f("alt", "text")]
+};
+var usersCollection = {
+  slug: "users",
+  auth: true,
+  fields: [f("email", "text", { required: true })]
+};
+var variantsCollection = {
+  slug: "variants",
+  admin: { useAsTitle: "sku" },
+  fields: [
+    f("sku", "text", { required: true, unique: true, index: true }),
+    f("product", "relationship", { relationTo: "products", required: true }),
+    f("price", "number", { required: true }),
+    // минимальные единицы (копейки)
+    f("stock", "number"),
+    f("options", "json")
+    // { size: 'M', color: 'red' }
+  ]
+};
+var productsCollection = {
+  slug: "products",
+  admin: { useAsTitle: "title" },
+  fields: [
+    f("title", "text", { required: true }),
+    f("slug", "text", { required: true, unique: true, index: true }),
+    f("description", "richText"),
+    f("categories", "relationship", { relationTo: "categories", hasMany: true }),
+    f("images", "relationship", { relationTo: "media", hasMany: true }),
+    f("seo", "group", {
+      fields: [f("title", "text"), f("description", "textarea"), f("image", "relationship", { relationTo: "media" })]
+    })
+  ]
+};
+var ordersCollection = {
+  slug: "orders",
+  admin: { useAsTitle: "id" },
+  access: adminOnly,
+  fields: [
+    f("status", "select", {
+      options: ["pending", "paid", "fulfilled", "cancelled", "refunded"],
+      defaultValue: "pending"
+    }),
+    f("email", "text"),
+    f("currency", "text"),
+    f("subtotal", "number"),
+    f("total", "number"),
+    f("lines", "json"),
+    f("paymentProvider", "text"),
+    // 'stripe' | 'paddle' | 'yookassa'
+    f("paymentRef", "text", { index: true }),
+    // идемпотентность webhook (дедуп по референсу платежа)
+    f("createdAt", "date")
+  ]
+};
+var cartsCollection = {
+  slug: "carts",
+  admin: { useAsTitle: "id" },
+  access: adminOnly,
+  fields: [
+    f("lines", "json"),
+    // CartLine[] (контракт); арифметика — в @vitrine-kit/core
+    f("currency", "text"),
+    f("subtotal", "number"),
+    f("discountTotal", "number"),
+    f("total", "number"),
+    f("status", "select", {
+      options: ["active", "converted", "abandoned"],
+      defaultValue: "active"
+    }),
+    f("paymentRef", "text", { index: true })
+  ]
+};
+var baseCollections = [
+  categoriesCollection,
+  mediaCollection,
+  usersCollection,
+  productsCollection,
+  variantsCollection,
+  ordersCollection,
+  cartsCollection
+];
+
+// src/blueprint.ts
+var SLUG_BY_COLLECTION = {
+  product: "products",
+  variant: "variants",
+  category: "categories",
+  media: "media",
+  order: "orders",
+  user: "users"
+};
+function createBlueprint() {
+  const additions = /* @__PURE__ */ new Map();
+  const extend = (collection, patch) => {
+    const slug = SLUG_BY_COLLECTION[collection];
+    const list = additions.get(slug) ?? [];
+    list.push(...patch.addFields);
+    additions.set(slug, list);
+  };
+  function build() {
+    return baseCollections.map((base) => {
+      const adds = additions.get(base.slug) ?? [];
+      if (adds.length === 0) return base;
+      const existing = new Set(base.fields.map((field) => field.name));
+      for (const field of adds) {
+        if (existing.has(field.name)) {
+          throw new Error(
+            `[vitrine] blueprint: \u043F\u043E\u043B\u0435 "${field.name}" \u0443\u0436\u0435 \u0435\u0441\u0442\u044C \u0432 "${base.slug}" \u2014 extend() \u0442\u043E\u043B\u044C\u043A\u043E \u0430\u0434\u0434\u0438\u0442\u0438\u0432\u0435\u043D`
+          );
+        }
+        existing.add(field.name);
+      }
+      return { ...base, fields: [...base.fields, ...adds] };
+    });
+  }
+  return { extend, build };
+}
+
+// src/index.ts
+var PAYLOAD_BLUEPRINT_VERSION = "0.1.0";
+export {
+  PAYLOAD_BLUEPRINT_VERSION,
+  baseCollections,
+  cartsCollection,
+  categoriesCollection,
+  createBlueprint,
+  mediaCollection,
+  ordersCollection,
+  productsCollection,
+  usersCollection,
+  variantsCollection
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@vitrine-kit/payload-blueprint",
+  "version": "0.2.0",
+  "description": "Vitrine — базовые Payload-коллекции + аддитивный extend().",
+  "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"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vitrine-kit/vitrine.git",
+    "directory": "packages/payload-blueprint"
+  },
+  "dependencies": {
+    "@vitrine-kit/contracts": "1.1.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}