@revenexx/cover 0.1.0

package/i18n/locales/en/search.json

@@ -0,0 +1,54 @@
+{
+  "search": {
+    "input": {
+      "placeholder": "Search products, SKUs...",
+      "scan": "Scan code",
+      "scanTitle": "Scan barcode / QR code",
+      "scanHint": "Point the camera at a barcode or QR code — the result becomes your search query."
+    },
+    "results": {
+      "title": "Search results for \"{query}\"",
+      "count": "{count} result | {count} results",
+      "error": "Search failed",
+      "emptyTitle": "No matches",
+      "emptyDescription": "Adjust your search term or filters — or browse the catalog.",
+      "initialTitle": "Search the catalog",
+      "initialDescription": "Enter a product name, article number or keyword above."
+    },
+    "sort": {
+      "label": "Sort",
+      "relevance": "Relevance",
+      "priceAsc": "Price: Low to High",
+      "priceDesc": "Price: High to Low",
+      "nameAsc": "Name A–Z",
+      "nameDesc": "Name Z–A"
+    },
+    "filters": {
+      "title": "Filters",
+      "clearAll": "Clear all",
+      "noFilters": "No filters available.",
+      "openDrawer": "Filter",
+      "facets": {
+        "category": "Category",
+        "subcategory": "Subcategory",
+        "available": "Availability",
+        "manufacturer": "Manufacturer"
+      },
+      "values": {
+        "inStock": "In Stock",
+        "outOfStock": "Out of Stock"
+      },
+      "price": {
+        "label": "Price (€)",
+        "min": "Min",
+        "max": "Max"
+      },
+      "removeFilter": "Remove filter {value}",
+      "showResults": "Show {count} result | Show {count} results"
+    },
+    "category": {
+      "searchPlaceholder": "Search within this category…",
+      "allProducts": "All products"
+    }
+  }
+}

package/i18n/locales/en/validation.json

@@ -0,0 +1,12 @@
+{
+  "required": "This field is required",
+  "maxLength": "Value must be at most {max} characters",
+  "minLength": "Value must be at least {min} characters",
+  "pattern": "Value does not match the required format",
+  "postalCodeFormat": "Invalid postal code format",
+  "ibanFormat": "Invalid IBAN format",
+  "termsRequired": "Please accept the Terms & Conditions",
+  "invalidPhoneNumber": "Phone number contains invalid characters",
+  "invalidCompanyName": "Company name contains invalid characters",
+  "invalidZipCode": "Invalid zip code (digits only, 3–5 characters)"
+}

package/nuxt.config.ts

@@ -0,0 +1,109 @@
+import { readdirSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { defineNuxtConfig } from "nuxt/config";
+
+const currentDir = dirname(fileURLToPath(import.meta.url));
+const require_ = createRequire(import.meta.url);
+
+/**
+ * Auto-discovers the layer's locale files under i18n/locales/{code}/.
+ * Paths are layer-relative; @nuxtjs/i18n resolves them against this layer.
+ */
+function layerLocaleFiles(code: string): string[] {
+	return readdirSync(resolve(currentDir, "i18n/locales", code))
+		.filter(f => f.endsWith(".json"))
+		.sort()
+		.map(f => `${code}/${f}`);
+}
+
+/**
+ * Cover design system — Nuxt layer.
+ *
+ * Consumers add this layer via `extends: ["@revenexx/cover"]`.
+ * The layer contributes:
+ * - the storefront component library (app/components/**: ui, layout, product,
+ *   cart, category, checkout, search, account) — auto-imported with the same
+ *   names as before the extraction
+ * - storefront composables and Pinia stores (app/composables/**, including
+ *   useAuthStore/useCartStore/useThemeStore — store files
+ *   live in composables/ so core Nuxt auto-imports them from the layer)
+ * - the BFF API contract used by the composables (app/api/** path helpers);
+ *   consuming apps implement these endpoints (the demo shop serves them from
+ *   mock services, a production storefront from live platform data)
+ * - theming (app/config/themes.ts, palette.ts), shared config, validations,
+ *   interfaces (importable via `@revenexx/cover/interfaces/*`)
+ * - the default shop layout (app/layouts/default.vue)
+ * - its i18n messages (i18n/locales/{de,en}/*.json), merged into the
+ *   consuming app's locales by @nuxtjs/i18n layer support
+ *
+ * The consuming app is expected to provide the modules this layer relies on:
+ * @nuxt/ui, @pinia/nuxt, @nuxtjs/i18n and @nuxt/image.
+ */
+export default defineNuxtConfig({
+	$meta: {
+		name: "@revenexx/cover",
+	},
+
+	// Forms: FormKit renders the BFF-served form schemas (SSR-safe). The
+	// module and config ship with the layer so every consumer gets them.
+	modules: ["@formkit/nuxt"],
+
+	formkit: {
+		// autoImport's build-time transform produces conflicting sourcemaps in
+		// production builds (rollup "Multiple conflicting contents") — use the
+		// classic global plugin registration instead.
+		autoImport: false,
+		configFile: resolve(currentDir, "app/formkit.config.ts"),
+	},
+
+	// Defaults for the BFF's live backends — consuming apps override these
+	// via NUXT_* environment variables (web SDK identity, Typesense search).
+	runtimeConfig: {
+		webSdkApiUrl: "",
+		webSdkProject: "",
+		webSdkDevKey: "",
+		// Public revenexx API (gateway) — the live "api" service registry
+		// implementations. Stand-in for the generated web SDKs; the key is a
+		// tenant API key and stays server-side only.
+		revenexxApiUrl: "https://api.revenexx.com",
+		revenexxTenant: "",
+		revenexxApiKey: "",
+		typesenseHost: "localhost",
+		typesensePort: 8108,
+		typesenseProtocol: "http",
+		typesenseApiKey: "xyz",
+	},
+
+	css: [
+		resolve(currentDir, "app/assets/css/cover.css"),
+		// Camera overlay styles for the FormKit barcode input, resolved through
+		// the package's exports ("./genesis" IS the CSS asset) — works in any
+		// node_modules layout (pnpm workspace, npm-hoisted vendored split).
+		require_.resolve("@formkit/barcode/genesis"),
+	],
+
+	nitro: {
+		// Demo data, config and locale files ship as server assets so the BFF
+		// mock implementations work in every consuming app, in dev and build.
+		serverAssets: [
+			{ baseName: "cover-data", dir: resolve(currentDir, "server/data") },
+			{ baseName: "cover-config", dir: resolve(currentDir, "server/config") },
+			{ baseName: "cover-locales", dir: resolve(currentDir, "i18n/locales") },
+		],
+		// Static files the layer serves at the web root (e.g. the direct
+		// order templates) — layer public/ dirs are not merged automatically.
+		publicAssets: [
+			{ dir: resolve(currentDir, "public") },
+		],
+	},
+
+	i18n: {
+		locales: [
+			{ code: "de", language: "de-DE", files: layerLocaleFiles("de") },
+			{ code: "en", language: "en-US", files: layerLocaleFiles("en") },
+		],
+	},
+});

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@revenexx/cover",
+  "version": "0.1.0",
+  "description": "Cover \u2014 revenexx design system for Nuxt. Distributed as a Nuxt layer: generic UI components, theming tokens and stores shared by the demo shop, custom storefronts and the Blokkli theme.",
+  "type": "module",
+  "main": "./nuxt.config.ts",
+  "license": "MIT",
+  "author": "Revenexx",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/revenexx/cover.git",
+    "directory": "packages/cover"
+  },
+  "keywords": [
+    "nuxt",
+    "nuxt-layer",
+    "vue",
+    "design-system",
+    "revenexx",
+    "cover"
+  ],
+  "exports": {
+    ".": "./nuxt.config.ts",
+    "./api/*": "./app/api/*.ts",
+    "./components/*": "./app/components/*",
+    "./composables/*": "./app/composables/*.ts",
+    "./config/*": "./app/config/*.ts",
+    "./interfaces/*": "./app/interfaces/*.ts",
+    "./shared/*": "./app/shared/*.ts",
+    "./validations/*": "./app/validations/*.ts"
+  },
+  "dependencies": {
+    "@formkit/barcode": "^1.0.5",
+    "@formkit/core": "^1.6.0",
+    "@formkit/i18n": "^1.6.0",
+    "@formkit/nuxt": "^1.6.0",
+    "@formkit/themes": "^1.6.0",
+    "@formkit/vue": "^1.6.0",
+    "@iconify-json/lucide": "^1.2.111",
+    "@internationalized/date": "^3.12.0",
+    "@revenexx/sdk": "^0.0.2",
+    "@vueuse/core": "^14.3.0",
+    "typesense": "^3.0.5"
+  },
+  "peerDependencies": {
+    "@nuxt/ui": "^4.5.1",
+    "pinia": "^3.0.4",
+    "vue": "^3.5.0",
+    "vue-i18n": "^11.0.0 || ^10.0.0"
+  },
+  "devDependencies": {
+    "nuxt": "^4.4.2"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "app",
+    "i18n",
+    "server",
+    "public",
+    "nuxt.config.ts"
+  ]
+}

package/public/img/product-placeholder.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 400" role="img" aria-label="No product image">
+	<rect width="400" height="400" fill="#f3f4f6"/>
+	<g fill="none" stroke="#9ca3af" stroke-width="10" stroke-linejoin="round" stroke-linecap="round">
+		<path d="M200 110 L300 160 L300 260 L200 310 L100 260 L100 160 Z"/>
+		<path d="M100 160 L200 210 L300 160"/>
+		<path d="M200 210 L200 310"/>
+	</g>
+</svg>

package/public/templates/direct-order-template.csv

@@ -0,0 +1,3 @@
+Artikelnummer,Kundenartikelnummer,Menge
+NK-G42-001-6919,,5
+IP-16-001-6360,MAT-100234,2

package/server/api/account/address/[id].delete.ts

@@ -0,0 +1,51 @@
+import type { AccountAddress, AccountAddressListResponse } from "../../../../app/interfaces/account/address-list";
+
+interface AddressListRaw {
+	userId: string;
+	addresses: AccountAddress[];
+}
+
+export default defineEventHandler(async (event): Promise<AccountAddressListResponse> => {
+	const id = getRouterParam(event, "id");
+	if (!id) {
+		throw createError({ statusCode: 400, statusMessage: "Missing address id" });
+	}
+
+	let data: AddressListRaw;
+	try {
+		data = await readCoverMutableJson<AddressListRaw>("account/address-list.json");
+	}
+	catch {
+		throw createError({ statusCode: 500, statusMessage: "Address store unavailable" });
+	}
+
+	const address = data.addresses.find(a => a.id === id);
+	if (!address) {
+		throw createError({ statusCode: 404, statusMessage: "Address not found" });
+	}
+
+	const billingCount = data.addresses.filter(a => a.type === "billing").length;
+	if (address.type === "billing" && billingCount <= 1) {
+		throw createError({ statusCode: 400, statusMessage: "Cannot delete the last billing address" });
+	}
+
+	let remaining = data.addresses.filter(a => a.id !== id);
+
+	// If deletion leaves no billing address, promote first shipping to billing + isDefault
+	const hasBilling = remaining.some(a => a.type === "billing");
+	if (!hasBilling && remaining.length > 0) {
+		const firstShippingIdx = remaining.findIndex(a => a.type === "shipping");
+		if (firstShippingIdx !== -1) {
+			remaining = remaining.map((a, i) => {
+				if (i === firstShippingIdx) {
+					return { ...a, type: "billing" as const, isDefault: true };
+				}
+				return a;
+			});
+		}
+	}
+
+	await writeCoverMutableJson("account/address-list.json", { ...data, addresses: remaining });
+
+	return { addresses: remaining };
+});

package/server/api/account/address/[id].put.ts

@@ -0,0 +1,83 @@
+import type { AccountAddress, AccountAddressType } from "../../../../app/interfaces/account/address-list";
+
+interface AddressListRaw {
+	userId: string;
+	addresses: AccountAddress[];
+}
+
+interface AddressUpdateBody {
+	readonly company?: unknown;
+	readonly label?: unknown;
+	readonly firstName?: unknown;
+	readonly lastName?: unknown;
+	readonly street?: unknown;
+	readonly streetNumber?: unknown;
+	readonly city?: unknown;
+	readonly zip?: unknown;
+	readonly country?: unknown;
+	readonly type?: unknown;
+	readonly isDefault?: unknown;
+}
+
+function requireString(value: unknown, field: string): string {
+	if (typeof value !== "string" || value.trim() === "") {
+		throw createError({ statusCode: 422, statusMessage: `${field} is required` });
+	}
+	return value.trim();
+}
+
+export default defineEventHandler(async (event): Promise<AccountAddress> => {
+	const id = getRouterParam(event, "id");
+	if (!id) {
+		throw createError({ statusCode: 400, statusMessage: "Missing address id" });
+	}
+
+	const body = await readBody<AddressUpdateBody>(event);
+
+	const company = typeof body.company === "string" ? body.company.trim() : "";
+	const label = requireString(body.label, "label");
+	const firstName = requireString(body.firstName, "firstName");
+	const lastName = requireString(body.lastName, "lastName");
+	const street = requireString(body.street, "street");
+	const streetNumber = requireString(body.streetNumber, "streetNumber");
+	const city = requireString(body.city, "city");
+	const zip = requireString(body.zip, "zip");
+	const country = requireString(body.country, "country");
+
+	if (body.type !== "billing" && body.type !== "shipping") {
+		throw createError({ statusCode: 422, statusMessage: "Invalid address type" });
+	}
+	const type = body.type as AccountAddressType;
+	const isDefault = body.isDefault === true;
+
+	let data: AddressListRaw;
+	try {
+		data = await readCoverMutableJson<AddressListRaw>("account/address-list.json");
+	}
+	catch {
+		throw createError({ statusCode: 500, statusMessage: "Address store unavailable" });
+	}
+
+	const index = data.addresses.findIndex(a => a.id === id);
+	if (index === -1) {
+		throw createError({ statusCode: 404, statusMessage: "Address not found" });
+	}
+
+	// When setting isDefault, clear it from other addresses of the same type
+	const updatedAddresses: AccountAddress[] = data.addresses.map((a, i) => {
+		if (i === index) {
+			return {
+				...a, company, label, firstName, lastName,
+				street, streetNumber, city, zip, country, type, isDefault,
+			};
+		}
+		if (isDefault && a.type === type) {
+			return { ...a, isDefault: false };
+		}
+		return a;
+	});
+
+	await writeCoverMutableJson("account/address-list.json", { ...data, addresses: updatedAddresses });
+
+	return updatedAddresses[index]!;
+});

package/server/api/account/address/index.post.ts

@@ -0,0 +1,60 @@
+import type {
+	AccountAddress,
+	AccountAddressFormState,
+} from "../../../../app/interfaces/account/address-list";
+
+interface AddressListRaw {
+	userId: string;
+	addresses: AccountAddress[];
+}
+
+export default defineEventHandler(async (event): Promise<AccountAddress> => {
+	const body = await readBody<AccountAddressFormState>(event);
+
+	const required = [
+		"label", "firstName", "lastName", "street", "streetNumber", "city", "zip", "country", "type",
+	] as const;
+	for (const field of required) {
+		if (!body[field] || String(body[field]).trim().length === 0) {
+			throw createError({ statusCode: 400, statusMessage: `Missing required field: ${field}` });
+		}
+	}
+
+	let data: AddressListRaw;
+	try {
+		data = await readCoverMutableJson<AddressListRaw>("account/address-list.json");
+	}
+	catch {
+		throw createError({ statusCode: 500, statusMessage: "Address store unavailable" });
+	}
+
+	const sameType = data.addresses.filter(a => a.type === body.type);
+	const isDefault = body.isDefault || sameType.length === 0;
+
+	const newAddress: AccountAddress = {
+		id: crypto.randomUUID(),
+		company: body.company ?? "",
+		label: body.label.trim(),
+		firstName: body.firstName.trim(),
+		lastName: body.lastName.trim(),
+		street: body.street.trim(),
+		streetNumber: body.streetNumber.trim(),
+		city: body.city.trim(),
+		zip: body.zip.trim(),
+		country: body.country,
+		type: body.type,
+		isDefault,
+	};
+
+	let addresses = [...data.addresses];
+	if (isDefault) {
+		addresses = addresses.map(a =>
+			a.type === newAddress.type ? { ...a, isDefault: false } : a,
+		);
+	}
+	addresses.push(newAddress);
+
+	await writeCoverMutableJson("account/address-list.json", { ...data, addresses });
+
+	return newAddress;
+});

package/server/api/account/addresses.get.ts

@@ -0,0 +1,25 @@
+
+interface AccountAddress {
+	readonly id: string;
+	readonly company: string;
+	readonly label: string;
+	readonly firstName: string;
+	readonly lastName: string;
+	readonly street: string;
+	readonly streetNumber: string;
+	readonly city: string;
+	readonly zip: string;
+	readonly country: string;
+	readonly isDefault: boolean;
+	readonly type: "billing" | "shipping";
+}
+
+interface AccountAddressListResponse {
+	readonly addresses: AccountAddress[];
+}
+
+export default defineEventHandler((): AccountAddressListResponse => {
+
+
+	return readCoverMutableJson<AccountAddressListResponse>("account/address-list.json");
+});

package/server/api/account/context.get.ts

@@ -0,0 +1,16 @@
+/**
+ * Per-user B2B context: organization settings, assigned cost centers,
+ * spending limits and workflow memberships. Guests receive the
+ * organization defaults with empty assignments.
+ */
+export default defineEventHandler(async (event) => {
+	const user = await getAuthService(event).me(event);
+
+	try {
+		return await getB2BContextService(event).getContext(user?.$id ?? null);
+	}
+	catch (err) {
+		getLogService().error("Service error: account/context", toErrorContext(err));
+		throw createError({ statusCode: 500, message: "Internal server error" });
+	}
+});

package/server/api/account/governance/[domain]/[id].put.ts

@@ -0,0 +1,57 @@
+type Domain = "cost-centers" | "workflows";
+
+/**
+ * Updates a governance record: created records are edited in place,
+ * bundled base records receive an overlay patch by id.
+ */
+export default defineEventHandler(async (event) => {
+	const user = await getAuthService(event).me(event);
+	if (!user) {
+		throw createError({ statusCode: 401, message: "Unauthorized" });
+	}
+	if (user.role === "requester") {
+		throw createError({ statusCode: 403, message: "Requesters cannot manage governance" });
+	}
+
+	const domain = getRouterParam(event, "domain") as Domain;
+	const id = getRouterParam(event, "id") ?? "";
+	if (!["cost-centers", "workflows"].includes(domain) || !id) {
+		throw createError({ statusCode: 404, message: "Unknown governance record" });
+	}
+
+	const patch = await readBody<Record<string, unknown>>(event);
+	const overrides = await readGovernanceOverrides();
+
+	if (domain === "cost-centers") {
+		const own = overrides.costCenters.find(cc => cc.id === id);
+		if (own) {
+			Object.assign(own, { label: patch.label ?? own.label, code: patch.code ?? own.code });
+		}
+		else {
+			overrides.costCenterPatches[id] = {
+				...overrides.costCenterPatches[id],
+				...(patch.label ? { label: String(patch.label) } : {}),
+				...(patch.code ? { code: String(patch.code) } : {}),
+			};
+		}
+	}
+	else {
+		const own = overrides.workflows.find(wf => wf.id === id);
+		if (own) {
+			Object.assign(own, {
+				name: patch.name ?? own.name,
+				steps: patch.steps ?? own.steps,
+			});
+		}
+		else {
+			overrides.workflowPatches[id] = {
+				...overrides.workflowPatches[id],
+				...(patch.name ? { name: String(patch.name) } : {}),
+				...(patch.steps ? { steps: patch.steps as never } : {}),
+			};
+		}
+	}
+
+	await writeGovernanceOverrides(overrides);
+	return { ok: true };
+});

package/server/api/account/governance/[domain].post.ts

@@ -0,0 +1,111 @@
+import type { ApprovalLimit, ApprovalWorkflow, CostCenter } from "../../../../app/interfaces/b2b";
+
+type Domain = "cost-centers" | "approval-limits" | "workflows";
+
+const DOMAINS: Domain[] = ["cost-centers", "approval-limits", "workflows"];
+
+const uid = (prefix: string) => `${prefix}-${Date.now().toString(36)}${Math.random().toString(36).slice(2, 5)}`;
+
+/**
+ * Creates a governance record from the account area (demo persistence in
+ * the mutable overrides store). Admins and approvers manage governance;
+ * buyers may create cost centers.
+ */
+export default defineEventHandler(async (event) => {
+	const user = await getAuthService(event).me(event);
+	if (!user) {
+		throw createError({ statusCode: 401, message: "Unauthorized" });
+	}
+	if (user.role === "requester") {
+		throw createError({ statusCode: 403, message: "Requesters cannot manage governance" });
+	}
+
+	const domain = getRouterParam(event, "domain") as Domain;
+	if (!DOMAINS.includes(domain)) {
+		throw createError({ statusCode: 404, message: "Unknown governance domain" });
+	}
+
+	const body = await readBody<Record<string, unknown>>(event);
+	const overrides = await readGovernanceOverrides();
+
+	try {
+		if (domain === "cost-centers") {
+			const record: CostCenter = {
+				id: uid("cc"),
+				code: String(body.code ?? "").trim(),
+				label: String(body.label ?? "").trim(),
+			};
+			if (!record.code || !record.label) {
+				throw createError({ statusCode: 400, message: "code and label required" });
+			}
+			if (typeof body.totalBudget === "number" && body.totalBudget > 0) {
+				record.limit = {
+					id: uid("lim"),
+					type: "budget",
+					subject: { type: "cost-center", costCenterId: record.id },
+					label: String(body.limitLabel ?? `${record.label} Budget`),
+					totalBudget: body.totalBudget,
+					availableBudget: typeof body.availableBudget === "number"
+						? body.availableBudget
+						: body.totalBudget,
+					currency: "EUR",
+					active: true,
+					approval: (body.approval ?? { required: false }) as ApprovalLimit["approval"],
+				};
+			}
+			overrides.costCenters.push(record);
+			await writeGovernanceOverrides(overrides);
+			return record;
+		}
+
+		if (domain === "approval-limits") {
+			const type = String(body.type ?? "");
+			if (!["budget", "order-value", "unit-price", "non-catalog"].includes(type)) {
+				throw createError({ statusCode: 400, message: "invalid limit type" });
+			}
+			const record: ApprovalLimit = {
+				id: uid("lim"),
+				type: type as ApprovalLimit["type"],
+				subject: { type: "user", userId: String(body.userId ?? user.$id) },
+				label: String(body.label ?? "").trim(),
+				...(typeof body.maxAmount === "number" ? { maxAmount: body.maxAmount } : {}),
+				...(typeof body.totalBudget === "number"
+					? { totalBudget: body.totalBudget, availableBudget: body.totalBudget }
+					: {}),
+				currency: "EUR",
+				active: true,
+				approval: (body.approval ?? { required: false }) as ApprovalLimit["approval"],
+			};
+			if (!record.label) {
+				throw createError({ statusCode: 400, message: "label required" });
+			}
+			overrides.approvalLimits.push(record);
+			await writeGovernanceOverrides(overrides);
+			return record;
+		}
+
+		// workflows
+		const steps = (body.steps as ApprovalWorkflow["steps"]) ?? [];
+		const record: ApprovalWorkflow = {
+			id: uid("wf"),
+			name: String(body.name ?? "").trim(),
+			steps,
+		};
+		if (!record.name || steps.length < 2 || steps[steps.length - 1]?.type !== "order") {
+			throw createError({
+				statusCode: 400,
+				message: "name and at least one request step ending in an order step required",
+			});
+		}
+		overrides.workflows.push(record);
+		await writeGovernanceOverrides(overrides);
+		return record;
+	}
+	catch (err) {
+		if (err !== null && typeof err === "object" && "statusCode" in err) {
+			throw err;
+		}
+		getLogService().error("Service error: governance/create", toErrorContext(err));
+		throw createError({ statusCode: 500, message: "Internal server error" });
+	}
+});