includio-cms 0.27.0 → 0.28.0

package/API.md

@@ -1,8 +1,8 @@
-# includio-cms — Public API v0.27.0
+# includio-cms — Public API v0.28.0
 
 > Auto-generated by `scripts/generate-api-md.ts`. Do not edit by hand.
 
-Entry points: **18** · Stable: **448** · Experimental: **4**
+Entry points: **18** · Stable: **464** · Experimental: **4**
 
 Tags:
 - `@public` — frozen for v1.0; semver-protected.
@@ -223,6 +223,7 @@ Tags:
 - `const getMediaTags: <inferred>`
 - `const getMediaTagsWithCounts: <inferred>`
 - `const getOrderForAdmin: <inferred>`
+- `const getOrderInvoiceAdmin: <inferred>`
 - `const getOrderRefundsAdmin: <inferred>`
 - `const getRawEntries: <inferred>`
 - `const getRawEntry: <inferred>`
@@ -236,6 +237,7 @@ Tags:
 - `const getSingles: <inferred>`
 - `const getSubmissionsOverview: <inferred>`
 - `const isAIAvailable: <inferred>`
+- `const issueInvoiceCmd: <inferred>`
 - `const listCouponsAdmin: <inferred>`
 - `const listOrdersAdmin: <inferred>`
 - `const listShippingMethodsAdmin: <inferred>`
@@ -337,6 +339,8 @@ Tags:
 - `const shopCouponRedemptionsTable: <inferred>`
 - `const shopCouponsTable: <inferred>`
 - `type ShopCouponType = 'percent' | 'fixed'`
+- `const shopInvoicesTable: <inferred>`
+- `type ShopInvoiceStatus = 'pending' | 'issued' | 'sent' | 'failed'`
 - `const shopOrderItemsTable: <inferred>`
 - `const shopOrdersTable: <inferred>`
 - `const shopOrderStatusHistoryTable: <inferred>`
@@ -377,6 +381,8 @@ Tags:
 - `const shopCouponRedemptionsTable: <inferred>`
 - `const shopCouponsTable: <inferred>`
 - `type ShopCouponType = 'percent' | 'fixed'`
+- `const shopInvoicesTable: <inferred>`
+- `type ShopInvoiceStatus = 'pending' | 'issued' | 'sent' | 'failed'`
 - `const shopOrderItemsTable: <inferred>`
 - `const shopOrdersTable: <inferred>`
 - `const shopOrderStatusHistoryTable: <inferred>`
@@ -411,7 +417,9 @@ Tags:
 - `interface CouponRef`
 - `type Currency = 'PLN'`
 - `defineShop(config: ShopConfig): ResolvedShopConfig`
-- `type DepositAmount = | { type: 'percent'; value: number } | { type: 'amount'; value: number }` — Deposit amount specifier. `percent` charges `floor(base * value / 100)` of
+- `type DepositAmount = { type: 'percent'; value: number } | { type: 'amount'; value: number }` — Deposit amount specifier. `percent` charges `floor(base * value / 100)` of
+- `fakturowniaAdapter(opts: FakturowniaAdapterOptions): InvoicingAdapter` — Invoicing adapter backed by Fakturownia (fakturownia.pl). Issues a paid VAT
+- `interface FakturowniaAdapterOptions`
 - `filterUpcoming(variants: T[], config: VariantExpiryConfig | null, now?: Date): T[]` — Return the subset of `variants` that have not yet expired. Order is
 - `type GeowidgetConfigPreset = 'parcelcollect' | 'parcelsend' | 'parcelcollect247' | string`
 - `type I18nText = { [lang: string]: string; }`
@@ -421,6 +429,14 @@ Tags:
 - `interface InpostSenderAddress`
 - `interpolateTemplate(template: string, vars: Record<string, unknown>, locale: string): string` — String interpolation engine used by `defineShop({ variantLabel.template })`
 - `class InvalidVariantAttributesError`
+- `interface InvoiceBuyer`
+- `interface InvoiceContext`
+- `interface InvoiceCreateResult`
+- `type InvoiceIssuePolicy = 'b2bAndOnRequest' | 'always'` — When an invoice should be issued automatically after an order is fully paid.
+- `interface InvoiceLineItem`
+- `interface InvoicePayload`
+- `interface InvoicingAdapter` — Adapter that issues invoices with an external provider (e.g. Fakturownia).
+- `isValidNip(nip: string): boolean` — Validate a Polish NIP (tax id) — 10 digits with a weighted checksum.
 - `isVariantExpired(variant: VariantLike, config: VariantExpiryConfig | null, now: Date = new Date(Date.now())): boolean` — Check whether a variant has expired under the given config. Fail-open by
 - `manualAdapter(opts: ManualPaymentAdapterOptions = {}): PaymentAdapter` — Manual payment adapter — order goes to awaitingPayment, admin marks as paid later
 - `interface OrderRef`

package/CHANGELOG.md

@@ -3,6 +3,46 @@
 All notable changes to includio-cms are documented here.
 Generated from `src/lib/updates/` — do not edit manually.
 
+## 0.28.0 — 2026-06-01
+
+Fakturowanie — integracja sklepu z Fakturownią: automatyczne wystawianie i wysyłka faktury po opłaceniu zamówienia. Nowy generyczny `InvoicingAdapter` (spójny z payment/carrier) + `fakturowniaAdapter()` jako pierwsza implementacja. Faktura wystawiana fire-and-forget gdy zamówienie jest w pełni opłacone (`!balanceOwed` — zaliczki czekają na dopłatę balansu), wysyłana przez Fakturownię (`send_by_email`). Trigger konfigurowalny per-adapter (`issueWhen`: `b2bAndOnRequest` domyślnie / `always`). Checkout zbiera dane B2B (NIP z twardą walidacją sumy kontrolnej, nazwa firmy, adres do faktury, opt-in „chcę fakturę"). Idempotencja przez `shop_invoices` (unikat per zamówienie); ręczny retry w adminie. Additive only — żadnych breaking zmian.
+
+### Added
+- `defineShop({ invoicing })` (`includio-cms/shop`) — nowy opcjonalny slot adaptera fakturowania, analogiczny do `payment` / `carriers`. `InvoicingAdapter { id, issueWhen?, createInvoice(payload, ctx), send?(externalId, ctx) }` + typy payloadu (`InvoicePayload`, `InvoiceBuyer`, `InvoiceLineItem`, `InvoiceCreateResult`, `InvoiceContext`, `InvoiceIssuePolicy`) wyeksportowane jako `@public` z `includio-cms/shop`.
+- `fakturowniaAdapter({ domain, apiToken, kind?, issueWhen?, sendEmail? })` (`includio-cms/shop`, `@public`) — adapter dla Fakturowni (fakturownia.pl). `createInvoice` mapuje zamówienie na fakturę VAT oznaczoną jako opłacona (`paid_date` = data potwierdzenia płatności), `send` woła `send_by_email` (domyślnie włączone). Numeracja i dane sprzedawcy zarządzane po stronie konta Fakturowni. Sekret `apiToken` przekazywany przez konsumenta z `$env/dynamic/private` (jak `STRIPE_SECRET_KEY`).
+- Auto-faktura po opłaceniu — `maybeIssueInvoiceForOrder(orderId)` (`$lib/shop/server/invoices.ts`) wołane fire-and-forget z `updateOrderStatus` (przy `paid`) oraz z `markBalancePaid` (po dopłacie balansu). Fail-open: błąd providera nie blokuje webhooka płatności. Guard wystawia fakturę tylko gdy zamówienie w pełni opłacone (`status ∈ {paid, preparing, sent, done}` && `!balanceOwed`) — deposit czeka na dopłatę.
+- Konfigurowalny trigger `issueWhen`: `b2bAndOnRequest` (domyślny — faktura gdy podano NIP lub zaznaczono „chcę fakturę") albo `always` (każde opłacone zamówienie, np. dla klienta wymagającego faktur również dla osób fizycznych).
+- `shop_invoices` (nowa tabela) — jedna faktura per zamówienie (`order_id` UNIQUE → idempotencja). Pola `status` (`pending`/`issued`/`sent`/`failed`), `external_id`, `number`, `pdf_url`, `attempts`, `next_retry_at`, `last_error`, `raw`. Kolumny `attempts`/`next_retry_at` zarezerwowane pod przyszły automatyczny retry (obecnie tylko ręczny).
+- Checkout B2B — `shop_orders` dostaje kolumny `customer_nip`, `customer_company_name`, `billing_address` (jsonb), `invoice_requested` (boolean). `createOrderFromCart` / `checkout-handler` przyjmują i zapisują te pola; `CheckoutInput` (`includio-cms/shop/client`) rozszerzony. Storefront form (pola NIP/firma/checkbox/adres) = warstwa konsumenta.
+- `isValidNip(nip)` (`includio-cms/shop`, `@public`) — twarda walidacja polskiego NIP (10 cyfr + suma kontrolna, wagi `[6,5,7,2,3,4,5,6,7]`). Checkout odrzuca nieprawidłowy NIP (400) zanim trafi do bazy — Fakturownia odrzuciłaby błędny NIP, a faktura idzie dalej do KSeF, więc walidujemy u źródła.
+- `getOrderInvoiceAdmin` (query) + `issueInvoiceCmd` (command) — admin remote functions (`includio-cms/admin/remote`). `shop-order-detail-page.svelte` zyskuje sekcję „Faktura": numer, link do PDF, status, przycisk „Wystaw fakturę" / „Wystaw ponownie" (ręczny retry, `force`). Auth-protected (`requireAuth`).
+
+### Migration
+
+```sql
+CREATE TABLE IF NOT EXISTS shop_invoices (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  order_id uuid NOT NULL UNIQUE REFERENCES shop_orders(id) ON DELETE CASCADE,
+  provider text NOT NULL,
+  external_id text,
+  number text,
+  pdf_url text,
+  kind text NOT NULL DEFAULT 'vat',
+  status text NOT NULL DEFAULT 'pending',
+  attempts integer NOT NULL DEFAULT 0,
+  next_retry_at timestamptz,
+  last_error text,
+  raw jsonb,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+ALTER TABLE shop_orders ADD COLUMN IF NOT EXISTS customer_nip text;
+ALTER TABLE shop_orders ADD COLUMN IF NOT EXISTS customer_company_name text;
+ALTER TABLE shop_orders ADD COLUMN IF NOT EXISTS billing_address jsonb;
+ALTER TABLE shop_orders ADD COLUMN IF NOT EXISTS invoice_requested boolean NOT NULL DEFAULT false;
+```
+
 ## 0.27.0 — 2026-05-29
 
 Shop platformowy — Fazy 1 + 2 + 3 + 4 + 5: schema-driven `variantAttributes` (typed `defineShop` schema, Zod walidacja, GIN index helper, ts-gen typed `variant.attributes`) + admin renderer per attribute type + `variantLabel.template` interpolacja z admin auto-prefill nazwy wariantu + `variantExpiry` opt-in (storefront filter, cart/checkout guard, admin "Zakończony" badge) + `paymentPolicy` A-lite (deposit + balance + signed token + refund per kind + admin balance link + per-kind refund dialog). Faza 6 envet pilot (consumer-side end-to-end QA: szkolenia variants + deposit flow + balance link — nie wymaga zmian w core). Post-Faza-5 hot-fixy uwzględnione w tym wydaniu (single release, nie patch): datetime walidator z offsetem, auto-detect deposit kind przy admin manual mark-paid, admin paymentPolicy UI + preserve-on-undefined w upsert. Additive only — żadnych breaking zmian. Plan: `/Users/patryk/.claude/plans/implementacja-ariacms-0-27-partitioned-kahn.md`.

package/DOCS.md

@@ -1,4 +1,4 @@
-# Includio CMS Documentation (v0.27.0)
+# Includio CMS Documentation (v0.28.0)
 
 > This file is auto-generated from the docs site. For the latest version, update the package.
 

package/dist/admin/client/shop/shop-order-detail-page.svelte

@@ -36,6 +36,37 @@
 	const refundsQuery = $derived(remotes.getOrderRefundsAdmin(orderId));
 	let refundDialogOpen = $state(false);
 
+	const invoiceQuery = $derived(remotes.getOrderInvoiceAdmin(orderId));
+	let issuingInvoice = $state(false);
+	let invoiceError = $state<string | null>(null);
+
+	async function issueInvoice(force: boolean) {
+		issuingInvoice = true;
+		invoiceError = null;
+		try {
+			const result = await remotes.issueInvoiceCmd({ orderId, force });
+			if (!result.success) invoiceError = result.error;
+			await invoiceQuery.refresh();
+		} finally {
+			issuingInvoice = false;
+		}
+	}
+
+	function invoiceStatusLabel(status: string): string {
+		switch (status) {
+			case 'pending':
+				return 'W trakcie';
+			case 'issued':
+				return 'Wystawiona';
+			case 'sent':
+				return 'Wysłana';
+			case 'failed':
+				return 'Błąd';
+			default:
+				return status;
+		}
+	}
+
 	type OrderStatus =
 		| 'new'
 		| 'awaitingPayment'
@@ -501,6 +532,60 @@
 					</section>
 				{/if}
 
+				{#if invoiceQuery.ready && invoiceQuery.current?.invoicingEnabled}
+					{@const inv = invoiceQuery.current.invoice}
+					{@const orderPaid =
+						order.status === 'paid' ||
+						order.status === 'preparing' ||
+						order.status === 'sent' ||
+						order.status === 'done'}
+					<section class="border-border bg-card space-y-3 rounded-xl border p-3 text-sm sm:p-5">
+						<h2 class="text-base font-bold">Faktura</h2>
+						{#if inv}
+							<div class="space-y-1">
+								<div class="flex items-center justify-between gap-2">
+									<span class="font-medium">{inv.number ?? '—'}</span>
+									<span class="text-muted-foreground text-xs">{invoiceStatusLabel(inv.status)}</span>
+								</div>
+								{#if inv.pdfUrl}
+									<a
+										href={inv.pdfUrl}
+										target="_blank"
+										rel="noopener noreferrer"
+										class="text-primary text-xs underline"
+									>
+										Otwórz fakturę
+									</a>
+								{/if}
+								{#if inv.status === 'failed' && inv.lastError}
+									<p class="text-destructive text-xs">{inv.lastError}</p>
+								{/if}
+							</div>
+						{:else}
+							<p class="text-muted-foreground text-xs">Brak faktury dla tego zamówienia.</p>
+						{/if}
+						{#if invoiceError}
+							<p class="text-destructive text-xs">{invoiceError}</p>
+						{/if}
+						{#if orderPaid}
+							<Button
+								onclick={() => issueInvoice(true)}
+								variant="outline"
+								class="w-full"
+								disabled={issuingInvoice}
+							>
+								{inv && (inv.status === 'issued' || inv.status === 'sent')
+									? 'Wystaw ponownie'
+									: 'Wystaw fakturę'}
+							</Button>
+						{:else}
+							<p class="text-muted-foreground text-xs">
+								Fakturę można wystawić po opłaceniu zamówienia.
+							</p>
+						{/if}
+					</section>
+				{/if}
+
 				{#if order.carrierType && order.carrierType !== 'none'}
 					<section class="border-border bg-card space-y-3 rounded-xl border p-3 text-sm sm:p-5">
 						<h2 class="text-base font-bold">

package/dist/admin/remote/shop.remote.d.ts

@@ -114,7 +114,11 @@ export declare const listOrdersAdmin: import("@sveltejs/kit").RemoteQueryFunctio
         customerEmail: string;
         customerName: string | null;
         customerPhone: string | null;
+        customerNip: string | null;
+        customerCompanyName: string | null;
         shippingAddress: Record<string, string> | null;
+        billingAddress: Record<string, string> | null;
+        invoiceRequested: boolean;
         totalNet: number;
         totalGross: number;
         vatAmount: number;
@@ -155,7 +159,11 @@ export declare const getOrderForAdmin: import("@sveltejs/kit").RemoteQueryFuncti
         customerEmail: string;
         customerName: string | null;
         customerPhone: string | null;
+        customerNip: string | null;
+        customerCompanyName: string | null;
         shippingAddress: Record<string, string> | null;
+        billingAddress: Record<string, string> | null;
+        invoiceRequested: boolean;
         totalNet: number;
         totalGross: number;
         vatAmount: number;
@@ -216,7 +224,11 @@ export declare const updateOrderStatusCmd: import("@sveltejs/kit").RemoteCommand
     customerEmail: string;
     customerName: string | null;
     customerPhone: string | null;
+    customerNip: string | null;
+    customerCompanyName: string | null;
     shippingAddress: Record<string, string> | null;
+    billingAddress: Record<string, string> | null;
+    invoiceRequested: boolean;
     totalNet: number;
     totalGross: number;
     vatAmount: number;
@@ -312,6 +324,52 @@ export declare const refundOrderCmd: import("@sveltejs/kit").RemoteCommand<{
     code: "order_not_found" | "order_not_paid" | "no_provider_ref" | "unknown_provider" | "refund_unsupported" | "invalid_amount" | "amount_exceeds_remaining" | "provider_error" | "no_payment_kind";
     error: string;
 }>>;
+export declare const getOrderInvoiceAdmin: import("@sveltejs/kit").RemoteQueryFunction<string, {
+    invoice: {
+        number: string | null;
+        raw: unknown;
+        id: string;
+        status: import("../../db-postgres/schema/shop/index.js").ShopInvoiceStatus;
+        createdAt: Date;
+        updatedAt: Date;
+        orderId: string;
+        provider: string;
+        kind: string;
+        externalId: string | null;
+        pdfUrl: string | null;
+        attempts: number;
+        nextRetryAt: Date | null;
+        lastError: string | null;
+    } | null;
+    invoicingEnabled: boolean;
+}>;
+export declare const issueInvoiceCmd: import("@sveltejs/kit").RemoteCommand<{
+    orderId: string;
+    force?: boolean | undefined;
+}, Promise<{
+    success: true;
+    invoice: {
+        number: string | null;
+        raw: unknown;
+        id: string;
+        status: import("../../db-postgres/schema/shop/index.js").ShopInvoiceStatus;
+        createdAt: Date;
+        updatedAt: Date;
+        orderId: string;
+        provider: string;
+        kind: string;
+        externalId: string | null;
+        pdfUrl: string | null;
+        attempts: number;
+        nextRetryAt: Date | null;
+        lastError: string | null;
+    } | null;
+    error?: undefined;
+} | {
+    success: false;
+    error: string;
+    invoice?: undefined;
+}>>;
 export declare const generateBalanceLinkForOrder: import("@sveltejs/kit").RemoteCommand<string, Promise<{
     success: false;
     error: string;

package/dist/admin/remote/shop.remote.js

@@ -6,6 +6,7 @@ import { createShippingMethod, deleteShippingMethod, getShippingMethod, listShip
 import { countOrders, getOrderById, getOrderItems, getOrderStatusHistory, listOrders, updateOrderStatus } from '../../shop/server/orders.js';
 import { cancelShipmentForOrder, createShipmentForOrder } from '../../shop/server/shipments.js';
 import { sendOrderStatusEmail } from '../../shop/server/email.js';
+import { getInvoiceByOrderId, issueInvoiceForOrder } from '../../shop/server/invoices.js';
 import { getRefundedAmount, listRefunds, refundOrder, RefundError } from '../../shop/server/refund.js';
 import { getShopDb } from '../../shop/server/db.js';
 import { shopCouponsTable } from '../../db-postgres/schema/shop/index.js';
@@ -261,6 +262,23 @@ export const refundOrderCmd = command(z.object({
         return { success: false, code: 'provider_error', error: message };
     }
 });
+export const getOrderInvoiceAdmin = query(z.string(), async (orderId) => {
+    requireAuth();
+    const invoice = await getInvoiceByOrderId(orderId);
+    const invoicingEnabled = !!getCMS().shopConfig?.invoicing;
+    return { invoice, invoicingEnabled };
+});
+export const issueInvoiceCmd = command(z.object({ orderId: z.string(), force: z.boolean().optional() }), async ({ orderId, force }) => {
+    requireAuth();
+    try {
+        const invoice = await issueInvoiceForOrder(orderId, { force });
+        return { success: true, invoice };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Invoice issuance failed';
+        return { success: false, error: message };
+    }
+});
 export const generateBalanceLinkForOrder = command(z.string(), async (orderId) => {
     requireAuth();
     const { generateBalanceToken, requireBalanceTokenSecret } = await import('../../shop/server/balance-payment.js');

package/dist/db-postgres/schema/shop/index.d.ts

@@ -7,6 +7,7 @@ export * from './orderStatusHistory.js';
 export * from './payment.js';
 export * from './stockReservation.js';
 export * from './refunds.js';
+export * from './invoice.js';
 export * from './webhookEvents.js';
 export * from './coupons.js';
 export * from './couponRedemptions.js';

package/dist/db-postgres/schema/shop/index.js

@@ -7,6 +7,7 @@ export * from './orderStatusHistory.js';
 export * from './payment.js';
 export * from './stockReservation.js';
 export * from './refunds.js';
+export * from './invoice.js';
 export * from './webhookEvents.js';
 export * from './coupons.js';
 export * from './couponRedemptions.js';

package/dist/db-postgres/schema/shop/invoice.d.ts

@@ -0,0 +1,254 @@
+export type ShopInvoiceStatus = 'pending' | 'issued' | 'sent' | 'failed';
+/**
+ * One invoice per order (`order_id` is unique → idempotency guard). `external_id`
+ * / `number` / `pdf_url` come from the invoicing provider once issued. The
+ * `attempts` / `next_retry_at` columns are reserved for a future automatic-retry
+ * mechanism; the current flow only retries manually from the admin.
+ */
+export declare const shopInvoicesTable: import("drizzle-orm/pg-core/table", { with: { "resolution-mode": "require" } }).PgTableWithColumns<{
+    name: "shop_invoices";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "id";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        orderId: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "order_id";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        provider: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "provider";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        externalId: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "external_id";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        number: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "number";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        pdfUrl: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "pdf_url";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        kind: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "kind";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "status";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: ShopInvoiceStatus;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: ShopInvoiceStatus;
+        }>;
+        attempts: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "attempts";
+            tableName: "shop_invoices";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        nextRetryAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "next_retry_at";
+            tableName: "shop_invoices";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lastError: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "last_error";
+            tableName: "shop_invoices";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        raw: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "raw";
+            tableName: "shop_invoices";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "created_at";
+            tableName: "shop_invoices";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "updated_at";
+            tableName: "shop_invoices";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;

package/dist/db-postgres/schema/shop/invoice.js

@@ -0,0 +1,27 @@
+import { integer, jsonb, pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core';
+import { shopOrdersTable } from './order.js';
+/**
+ * One invoice per order (`order_id` is unique → idempotency guard). `external_id`
+ * / `number` / `pdf_url` come from the invoicing provider once issued. The
+ * `attempts` / `next_retry_at` columns are reserved for a future automatic-retry
+ * mechanism; the current flow only retries manually from the admin.
+ */
+export const shopInvoicesTable = pgTable('shop_invoices', {
+    id: uuid('id').primaryKey().defaultRandom(),
+    orderId: uuid('order_id')
+        .notNull()
+        .unique()
+        .references(() => shopOrdersTable.id, { onDelete: 'cascade' }),
+    provider: text('provider').notNull(),
+    externalId: text('external_id'),
+    number: text('number'),
+    pdfUrl: text('pdf_url'),
+    kind: text('kind').notNull().default('vat'),
+    status: text('status').$type().notNull().default('pending'),
+    attempts: integer('attempts').notNull().default(0),
+    nextRetryAt: timestamp('next_retry_at', { withTimezone: true }),
+    lastError: text('last_error'),
+    raw: jsonb('raw'),
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull()
+});