includio-cms 0.15.1 → 0.15.3

package/CHANGELOG.md

@@ -3,6 +3,58 @@
 All notable changes to includio-cms are documented here.
 Generated from `src/lib/updates/` — do not edit manually.
 
+## 0.15.3 — 2026-04-16
+
+Shop: InPost carrier adapter — Geowidget v5 picker + ShipX shipment + webhook auto-status.
+
+### Added
+- `inpostAdapter()` ships in `includio-cms/shop` — wires Geowidget v5 (paczkomat picker on the frontend), ShipX (admin "Utwórz przesyłkę InPost" button creates the shipment, auto-buys the offer, fetches the label PDF) and a webhook receiver (`POST /api/shop/carriers/inpost/webhook?secret=...`) that updates order status + tracking number when ShipX events arrive.
+- `<InpostPicker>` Svelte component (`includio-cms/shop/svelte`) — drop-in widget with `bind:value={carrierRef}`, lazy-loads the geowidget script + CSS, hides itself for `inpost_courier_*` services. Raw API alternative: `GET /api/shop/carriers/inpost`.
+- Per-shipping-method service config — `shop_shipping_methods.carrier_config` jsonb with `serviceType` (`inpost_locker_standard` / `inpost_locker_express` / `inpost_courier_standard` / `inpost_courier_express`) and `defaultSize` (A/B/C → small/medium/large). Admin shipping form ungates the InPost option and shows the new fields when selected.
+- Customer order endpoint exposes `trackingNumber` + `trackingUrl` (resolved via `adapter.trackingUrl()`); `<OrderStatus>` renders a "Śledzenie przesyłki" section automatically. Status emails for `preparing` / `sent` / `done` include a tracking block with a clickable carrier link.
+- Admin order detail page gains a "Przesyłka {carrierType}" panel: Utwórz przesyłkę / Pobierz etykietę PDF / Anuluj przesyłkę. PDF is streamed through an admin-auth proxy at `/api/shop/admin/orders/[id]/label`.
+- Checkout validates `carrierRef` against the carrier (Operating-only paczkomats via InPost Points API, in-memory cached 5 min). Invalid selections reject with HTTP 400 before the order is created.
+- CLI scaffold (`pnpm includio scaffold admin`) emits the new routes: `api/shop/carriers/[id]/+server.ts`, `api/shop/carriers/[id]/webhook/+server.ts`, `api/shop/admin/orders/[id]/label/+server.ts`.
+- CLI scaffolder auto-detects shop usage by scanning `src/lib/cms/cms.config.ts` for an active `shop:` property — projects without the shop module get a clean route tree by default, no flag required. Override with `--shop` / `--no-shop` (or pass `scaffoldAdmin({ shop: false })` programmatically). Combined with the existing config-driven schema generator + admin sidebar guard, shop is now fully opt-in with zero footprint when unused.
+
+### Migration
+
+```sql
+ALTER TABLE shop_shipping_methods ADD COLUMN carrier_config jsonb;
+ALTER TABLE shop_orders ADD COLUMN shipment_id text, ADD COLUMN tracking_number text, ADD COLUMN label_url text, ADD COLUMN shipment_created_at timestamptz;
+```
+
+### Notes
+
+Run the SQL once, then `pnpm db:push` to sync the rest of the schema. InPost requires two tokens: a public Geowidget v5 token (browser-side, from `manager.paczkomaty.pl`) and a private ShipX organization token (server-side). On sandbox, ShipX `POST /shipments/:id/buy` is asynchronous and often stalls in `offer_selected` because test accounts have no wallet to pay the offer — the webhook reconciles whatever ends up. See /docs/shop/inpost for full setup.
+
+## 0.15.2 — 2026-04-15
+
+Shop: cena przechowywana jako numeric(20,6) — eliminacja driftu brutto/netto po reload; toggle netto/brutto per wariant.
+
+### Added
+- Warianty produktu mają teraz toggle netto/brutto obok pola "Zmiana ceny" — spójne z toggle'em ceny bazowej. Delta zapisywana kanonicznie jako netto.
+
+### Fixed
+- Shop: po wpisaniu ceny brutto (np. 65,00 zł przy VAT 23%) i refreshu, cena nie "ucieka" o ±1 grosz. Wartości przechowywane są jako PLN z 6 miejscami po przecinku (wzorzec PrestaShop), zamiast jednostek groszy — brutto zawsze odtwarzane z netto bez utraty informacji.
+- Shipping: ta sama poprawka dla ceny metody wysyłki (stored jako netto PLN z 6dp).
+
+### Breaking
+- Kolumny `shop_products.base_price`, `shop_product_variants.price_delta`, `shop_shipping_methods.price` zmieniły typ z `integer` (grosze) na `numeric(20,6)` (PLN). Snapshot zamówienia (`shop_orders.*`, `shop_order_items.price_*_snapshot`) pozostaje w groszach (`integer`) — KSeF-compatible.
+- Publiczne typy `ShopDataWithVariants.basePrice`, `VariantRow.priceDelta`, `ShippingMethodRow.price` — wartość dalej `number`, ale wyrażona w PLN (nie groszach). Dla konsumentów SDK/populate: mnożenie × 100 jeśli potrzebujesz groszy.
+
+### Migration
+
+```sql
+ALTER TABLE shop_products ALTER COLUMN base_price TYPE numeric(20,6) USING (base_price::numeric / 100);
+ALTER TABLE shop_product_variants ALTER COLUMN price_delta TYPE numeric(20,6) USING (price_delta::numeric / 100);
+ALTER TABLE shop_shipping_methods ALTER COLUMN price TYPE numeric(20,6) USING (price::numeric / 100);
+```
+
+### Notes
+
+Migrację SQL trzeba uruchomić RAZ, PRZED `db:push` — dzieli istniejące wartości ÷100, bo stare dane były w groszach, a nowy typ przechowuje PLN. Po migracji `db:push` tylko zsynchronizuje schemat (bez zmiany danych).
+
 ## 0.15.1 — 2026-04-15
 
 Shop: PayU payment adapter + secure order access (token-gated view API, email link).

package/DOCS.md

@@ -1,4 +1,4 @@
-# Includio CMS Documentation (v0.15.1)
+# Includio CMS Documentation (v0.15.3)
 
 > This file is auto-generated from the docs site. For the latest version, update the package.
 
@@ -4311,6 +4311,7 @@ Headless e-commerce module. Optional — activate by adding `shop: defineShop({.
 - **Cart** — signed cookie, headless SDK (`createShopClient()`), `POST/PATCH/DELETE /api/shop/cart`.
 - **Checkout + orders** — `POST /api/shop/checkout` creates an order with consent validation, stock reservation (30-min TTL), and status emails.
 - **Payment adapters** — `manualAdapter()` (bank transfer / COD) and `payuAdapter()` ship built-in; plug your own by implementing `PaymentAdapter`.
+- **Carrier adapters** — `inpostAdapter()` ships built-in (Geowidget v5 picker + ShipX shipments + webhook). Plug other carriers by implementing `CarrierAdapter`.
 - **Webhook infrastructure** — `createPaymentWebhookHandler()` dispatches provider callbacks, verifies signatures, is idempotent.
 - **Secure order view** — per-order `accessToken` + cookie fallback + `GET /api/shop/orders/[number]` token-gated API.
 - **Shipping ↔ payment compatibility** — restrict payment methods per shipping (e.g. no COD for paczkomat).
@@ -4344,7 +4345,18 @@ export const cmsConfig = defineCMS({
 
 ## Routes
 
-Scaffold provisions these endpoints in your app:
+Shop is **opt-in**: projects without `shop: defineShop(...)` in their CMS config don't get shop tables in the DB schema (generator gates on `config.shop`), the admin sidebar hides the Shop section, and shop API handlers always return 404.
+
+The CLI scaffolder **auto-detects** shop usage by scanning your `src/lib/cms/cms.config.ts` for `shop: …`. Override with `--shop` or `--no-shop` if needed:
+
+```sh
+pnpm includio scaffold admin           # auto: detects shop in cms config
+pnpm includio scaffold admin --shop    # force include shop routes
+pnpm includio scaffold admin --no-shop # force exclude shop routes
+pnpm includio scaffold admin --cms-config path/to/config.ts   # custom location
+```
+
+Scaffold provisions these endpoints (when shop is enabled):
 
 | Path | Handler | Purpose |
 |------|---------|---------|
@@ -4355,11 +4367,15 @@ Scaffold provisions these endpoints in your app:
 | `POST /api/shop/orders/[number]/refresh-payment` | `createRefreshPaymentHandler()` | Pull status from provider |
 | `POST /api/shop/orders/[number]/retry-payment` | `createRetryPaymentHandler()` | New payment attempt |
 | `POST /api/shop/webhooks/[provider]` | `createPaymentWebhookHandler()` | Provider callbacks |
+| `GET /api/shop/carriers/[id]` | `createCarrierConfigHandler()` | Public carrier widget descriptor |
+| `POST /api/shop/carriers/[id]/webhook` | `createCarrierWebhookHandler()` | Carrier event receiver |
+| `GET /api/shop/admin/orders/[id]/label` | `createShipmentLabelHandler()` | Admin shipping-label PDF proxy |
 
 ## See also
 
 - [Order view](/docs/shop/order-view) — generic `<OrderStatus>` component + headless helper
 - [Retry payment](/docs/shop/retry-payment) — lifecycle + endpoint
+- [InPost carrier](/docs/shop/inpost) — Geowidget v5 + ShipX shipment + webhook
 
 
 ---
@@ -4527,6 +4543,125 @@ if (url) window.location.href = url;
 If the customer is completely stuck, the admin can manually move the order to `paid` / `cancelled` from the orders detail page — same as before, status-change emails trigger automatically.
 
 
+---
+
+# InPost carrier
+
+`inpostAdapter()` ships in 0.15.3. Wires three things together:
+
+1. **Geowidget v5** — customer picks a paczkomat on the checkout page (`<InpostPicker>` Svelte component or raw config endpoint).
+2. **ShipX shipment** — admin clicks "Utwórz przesyłkę InPost" on the order detail page → backend POSTs the shipment to ShipX, auto-confirms the offer, stores the carrier-side shipment id + tracking number.
+3. **Webhook** — ShipX events (`confirmed`/`taken_by_courier`/`delivered`) update the order status and tracking number automatically.
+
+> InPost requires two separate tokens: a **public Geowidget v5 token** (delivered to the browser) and a **private ShipX organization token** (server-side only). Both come from `manager.paczkomaty.pl` (production) or `sandbox-manager.paczkomaty.pl` (sandbox).
+
+## Config
+
+```ts
+import { defineShop, inpostAdapter } from 'includio-cms/shop';
+
+defineShop({
+  // …currency, payment, etc.
+  carriers: [
+    inpostAdapter({
+      geowidgetToken: process.env.INPOST_GEOWIDGET_TOKEN!,
+      shipxToken: process.env.INPOST_SHIPX_TOKEN!,
+      organizationId: process.env.INPOST_ORG_ID!,
+      environment: 'production', // or 'sandbox'
+      webhookSecret: process.env.INPOST_WEBHOOK_SECRET!,
+      senderAddress: {
+        name: 'Twoja firma',
+        company: 'AriaCMS',
+        street: 'Mokotowska',
+        buildingNumber: '1',
+        city: 'Warszawa',
+        postCode: '00-001',
+        email: 'shop@example.com',
+        phone: '+48500600700'
+      }
+    })
+  ]
+});
+```
+
+**Optional opts:**
+
+- `additionalServices: ['email', 'sms']` — InPost SMS/email notifications. Requires the service to be enabled on your account; sandbox usually doesn't have it.
+- `autoConfirm: false` — disable the post-create `POST /shipments/:id/buy` step. Default `true`.
+- `autoConfirmDelayMs` (default `1500`), `autoConfirmPollTimeoutMs` (default `8000`) — tune the offer-prep wait and post-buy polling.
+- `trackingUrlTemplate` — override `https://inpost.pl/sledzenie-przesylek?number={trackingNumber}`.
+- `labelFormat: 'Pdf' | 'ZebraLP'`, `labelSize: 'A4' | 'A6'` — default label format.
+- `debug: true` — verbose logging of the create→buy→poll flow (payload dump, every poll tick). Off by default; warnings + errors always log.
+
+## Routes scaffolded
+
+`pnpm includio scaffold admin` provisions:
+
+| Path | Handler | Purpose |
+|------|---------|---------|
+| `GET /api/shop/carriers/[id]` | `createCarrierConfigHandler()` | Public widget descriptor (script URL + token + preset) |
+| `POST /api/shop/carriers/[id]/webhook` | `createCarrierWebhookHandler()` | ShipX event receiver — secret-gated via `?secret=…` |
+| `GET /api/shop/admin/orders/[id]/label` | `createShipmentLabelHandler()` | Admin-only PDF proxy for the shipment label |
+
+In `manager.paczkomaty.pl` configure the webhook URL as
+`https://your-domain.pl/api/shop/carriers/inpost/webhook?secret=<INPOST_WEBHOOK_SECRET>`.
+
+## Per-shipping-method service
+
+Each shipping method with `carrierType=inpost` carries a `carrierConfig`:
+
+| Field | Values |
+|------|--------|
+| `serviceType` | `inpost_locker_standard` (paczkomat), `inpost_locker_express`, `inpost_courier_standard`, `inpost_courier_express` |
+| `defaultSize` | `A` (small, 8×38×64 cm) / `B` (medium, 19×38×64 cm) / `C` (large, 41×38×64 cm) |
+
+Set both in admin → Shop → Shipping methods. For `inpost_courier_*` services the picker hides itself and the receiver address from the order is used instead.
+
+## Frontend picker
+
+```svelte
+<InpostPicker
+  bind:value={carrierRef}
+  serviceType="inpost_locker_standard"
+  onSelect={(point) => console.log('picked', point.name, point.address)}
+/>
+```
+
+The component lazy-loads the Geowidget v5 script + CSS, mounts the `<inpost-geowidget>` custom element, and writes the chosen paczkomat code into `value`. For `inpost_courier_*` services it renders a short notice instead.
+
+**Custom UI** — skip the component and call `GET /api/shop/carriers/inpost` yourself; the response is `{ id, label, widget: { scriptUrl, stylesheetUrl, config: { token, language, config } } }`.
+
+## Admin actions
+
+On any order with an InPost shipping method, the order detail page shows:
+
+- **"Utwórz przesyłkę InPost"** when status is `paid`/`preparing` and no shipment exists yet — POSTs to ShipX, auto-buys the offer, polls until status leaves `offer_selected`, writes `shipmentId` + `trackingNumber` on the order, bumps status to `preparing`.
+- **"Pobierz etykietę PDF"** — opens the admin label proxy in a new tab.
+- **"Anuluj przesyłkę"** — `DELETE /v1/shipments/:id` on ShipX, clears local data. Only works after the shipment reaches `confirmed`.
+
+## Webhook → status mapping
+
+| ShipX event status | Order status |
+|---|---|
+| `created`, `offers_prepared`, `offer_selected`, `confirmed`, `dispatched_by_sender` | `preparing` |
+| `taken_by_courier`, `adopted_at_*`, `out_for_delivery`, `ready_to_pickup` | `sent` |
+| `delivered` | `done` |
+| `canceled`, `returned_to_sender`, `rejected` | `cancelled` |
+| anything else | (ignored) |
+
+Tracking number is updated whenever the webhook payload contains a non-null `tracking_number`. Status emails (built-in PL/EN templates) include a tracking block on `preparing`/`sent`/`done`.
+
+## Sandbox quirks
+
+- ShipX `POST /shipments/:id/buy` is **asynchronous**. Production confirms in ~1–3 s; sandbox often **stalls in `offer_selected`** because test accounts have no wallet to pay the offer. The adapter polls for ~8 s then gives up and lets the webhook reconcile.
+- Sandbox geowidget paczkomaty are **separate** from production codes. Use `KRA012` (Kraków, Os. Kombatantów 20) or any code from `GET https://sandbox-api-shipx-pl.easypack24.net/v1/points?per_page=10`.
+- Sandbox `additional_services: ['email', 'sms']` returns `unavailable` — drop the option for sandbox testing.
+
+## Customer tracking display
+
+`OrderStatus.svelte` (the built-in component) renders a "Śledzenie przesyłki" section automatically when the order has a `trackingNumber`. If you wrote a custom order view, read `order.trackingNumber` and `order.trackingUrl` from the order endpoint response and render them yourself.
+
+
 ---
 
 # Migration Guide

package/ROADMAP.md

@@ -304,10 +304,20 @@
 - [x] `[feature]` `[P0]` Random Crockford base32 order numbers (`XXXXX-XXXXX`), unguessable
 - [x] `[feature]` `[P0]` CLI scaffold provisions all shop routes (admin + public API) in consumer app
 - [x] `[feature]` `[P1]` PayU payment adapter + webhook — shipped in 0.15.1 (access-token-gated order view, idempotent webhooks, MD5 signature, shipping↔payment compat, poll fallback)
-- [ ] `[feature]` `[P1]` Stripe payment adapter + webhook — deferred to 0.15.2
-- [ ] `[feature]` `[P2]` InPost carrier adapter (headless geowidget config) — deferred to 0.15.3
+- [ ] `[feature]` `[P1]` Stripe payment adapter + webhook — deferred to 0.15.4
+- [x] `[feature]` `[P2]` InPost carrier adapter — shipped in 0.15.3 (Geowidget v5 picker + ShipX shipments + auto-confirm + webhook status updates)
+
+## 0.15.2 — Price precision fix
+
+- [x] `[fix]` `[P1]` Price drift on reload — storage jako `numeric(20,6)` (PLN z 6dp), brutto round-tripuje bez utraty ±1gr. Snapshot zamówienia dalej w groszach (KSeF). <!-- files: src/lib/db-postgres/schema/shop/product.ts, productVariant.ts, shippingMethod.ts, src/lib/shop/pricing.ts, src/lib/shop/server/cart-hydrate.ts, shipping.ts, shop-data.ts, src/lib/admin/components/fields/shop-field.svelte, src/lib/admin/client/shop/shipping-method-form.svelte -->
+- [x] `[feature]` `[P2]` Variant price toggle netto/brutto (spójne z toggle\'em ceny bazowej)
 - [x] `[feature]` `[P2]` `nodemailerAdapter` — typowanie `transportOptions` jako `SMTPTransport.Options` (OAuth2, pool, itd.)
 
+## 0.15.3 — InPost carrier
+
+- [x] `[feature]` `[P2]` `inpostAdapter()` — Geowidget v5 (`<InpostPicker>` Svelte + raw config endpoint), ShipX shipment create + auto-buy + label PDF + cancel, webhook → status + tracking, per-shipping-method service config, customer tracking display in `<OrderStatus>` + email templates
+- [x] `[chore]` `[P2]` Verbose logging on adapter auto-confirm flow (offer prep wait, buy POST, polling) for sandbox debugging
+
 ## 0.16.0 — SEO module
 
 - [ ] `[feature]` `[P1]` SERP preview + character limits for title/description <!-- files: src/lib/admin/components/fields/seo-field.svelte -->

package/dist/admin/client/shop/shipping-method-form.svelte

@@ -3,6 +3,16 @@
 	import { Switch } from '../../../components/ui/switch/index.js';
 
 	type CarrierType = 'none' | 'inpost';
+	type InpostServiceType =
+		| 'inpost_locker_standard'
+		| 'inpost_locker_express'
+		| 'inpost_courier_standard'
+		| 'inpost_courier_express';
+	type InpostParcelSize = 'A' | 'B' | 'C';
+	interface CarrierConfig {
+		serviceType?: InpostServiceType | string;
+		defaultSize?: InpostParcelSize | string;
+	}
 	export interface PaymentMethodOption {
 		id: string;
 		label: Record<string, string>;
@@ -10,10 +20,11 @@
 	export interface ShippingFormPayload {
 		name: Record<string, string>;
 		description: Record<string, string> | null;
-		price: number;
+		price: number; // PLN (number, netto)
 		vatRate: number;
 		carrierType: CarrierType;
-		conditions: { freeAbove?: number } | null;
+		carrierConfig: CarrierConfig | null;
+		conditions: { freeAbove?: number } | null; // freeAbove: grosze
 		allowedPaymentMethods: string[] | null;
 		isActive: boolean;
 		sortOrder: number | null;
@@ -21,9 +32,10 @@
 	export interface ShippingFormInitial {
 		name?: Record<string, string> | unknown;
 		description?: Record<string, string> | unknown | null;
-		price?: number;
+		price?: number | string;
 		vatRate?: number;
 		carrierType?: string;
+		carrierConfig?: CarrierConfig | null;
 		conditions?: { freeAbove?: number } | null;
 		allowedPaymentMethods?: string[] | null;
 		isActive?: boolean;
@@ -69,31 +81,40 @@
 		)
 	);
 	type InputMode = 'net' | 'gross';
-	let inputMode = $state<InputMode>(initial?.price != null ? 'net' : 'gross');
-	let inputPrice = $state(initial?.price != null ? (initial.price / 100).toFixed(2) : '0.00');
+	// initial.price — teraz PLN (number, netto) z API. Hydratujemy jako gross, żeby user widział dokładnie to co wpisał.
+	const initialNetPln = initial?.price != null ? Number(initial.price) : null;
+	const initialVat = Number(initial?.vatRate ?? vatRates[0] ?? 23);
+	let inputMode = $state<InputMode>(initialNetPln != null ? 'gross' : 'gross');
+	let inputPrice = $state(
+		initialNetPln != null
+			? (initialNetPln * (1 + initialVat / 100)).toFixed(2)
+			: '0.00'
+	);
 	let vatRate = $state<number | string>(initial?.vatRate ?? vatRates[0] ?? 23);
 
-	const inputPriceCents = $derived(Math.round(parseFloat(inputPrice || '0') * 100));
+	const inputPln = $derived(parseFloat(inputPrice || '0') || 0);
 	const vat = $derived(Number(vatRate) || 0);
-	const netCents = $derived(
-		inputMode === 'net' ? inputPriceCents : Math.round(inputPriceCents / (1 + vat / 100))
-	);
-	const grossCents = $derived(
-		inputMode === 'gross' ? inputPriceCents : Math.round(inputPriceCents * (1 + vat / 100))
-	);
-	const vatCents = $derived(grossCents - netCents);
+	const netPln = $derived(inputMode === 'net' ? inputPln : inputPln / (1 + vat / 100));
+	const grossPln = $derived(inputMode === 'gross' ? inputPln : inputPln * (1 + vat / 100));
+	const vatPln = $derived(grossPln - netPln);
 
-	function formatCents(cents: number) {
-		return (cents / 100).toFixed(2);
+	function formatPln(pln: number) {
+		return pln.toFixed(2);
 	}
 
 	function switchMode(newMode: InputMode) {
 		if (newMode === inputMode) return;
-		const preservedCents = newMode === 'net' ? netCents : grossCents;
+		const preserved = newMode === 'net' ? netPln : grossPln;
 		inputMode = newMode;
-		inputPrice = formatCents(preservedCents);
+		inputPrice = formatPln(preserved);
 	}
 	let carrierType = $state<CarrierType>((initial?.carrierType as CarrierType) ?? 'none');
+	let inpostServiceType = $state<InpostServiceType>(
+		(initial?.carrierConfig?.serviceType as InpostServiceType) ?? 'inpost_locker_standard'
+	);
+	let inpostDefaultSize = $state<InpostParcelSize>(
+		(initial?.carrierConfig?.defaultSize as InpostParcelSize) ?? 'A'
+	);
 	let isActive = $state(initial?.isActive ?? true);
 	// null/undefined = no restriction (all allowed); otherwise a whitelist.
 	let restrictPayments = $state(
@@ -126,9 +147,13 @@
 		await onsubmit({
 			name: names,
 			description: Object.values(descriptions).some((d) => d.length > 0) ? descriptions : null,
-			price: netCents,
+			price: netPln,
 			vatRate: Number(vatRate),
 			carrierType,
+			carrierConfig:
+				carrierType === 'inpost'
+					? { serviceType: inpostServiceType, defaultSize: inpostDefaultSize }
+					: null,
 			conditions: freeAboveEnabled
 				? { freeAbove: Math.round(parseFloat(freeAbove || '0') * 100) }
 				: null,
@@ -226,15 +251,15 @@
 		<div class="bg-muted/40 border-border grid grid-cols-3 gap-2 rounded-lg border p-2.5 text-center text-xs">
 			<div>
 				<div class="text-muted-foreground font-semibold uppercase tracking-wide">Netto</div>
-				<div class="text-sm font-bold tabular-nums">{formatCents(netCents)} zł</div>
+				<div class="text-sm font-bold tabular-nums">{formatPln(netPln)} zł</div>
 			</div>
 			<div class="border-border border-x">
 				<div class="text-muted-foreground font-semibold uppercase tracking-wide">VAT</div>
-				<div class="text-sm font-bold tabular-nums">{formatCents(vatCents)} zł</div>
+				<div class="text-sm font-bold tabular-nums">{formatPln(vatPln)} zł</div>
 			</div>
 			<div>
 				<div class="text-muted-foreground font-semibold uppercase tracking-wide">Brutto</div>
-				<div class="text-primary text-sm font-bold tabular-nums">{formatCents(grossCents)} zł</div>
+				<div class="text-primary text-sm font-bold tabular-nums">{formatPln(grossPln)} zł</div>
 			</div>
 		</div>
 		<label class="flex items-center gap-2">
@@ -297,9 +322,52 @@
 			<span class="mb-1 block text-sm font-semibold">Typ</span>
 			<select bind:value={carrierType} class="border-border w-full rounded-lg border px-3 py-2">
 				<option value="none">Bez integracji (adres)</option>
-				<option value="inpost" disabled>InPost paczkomat (wkrótce)</option>
+				<option value="inpost">InPost</option>
 			</select>
 		</label>
+
+		{#if carrierType === 'inpost'}
+			<div class="space-y-4 border-l-2 border-primary/30 pl-4">
+				<p class="text-muted-foreground text-sm">
+					Wymaga skonfigurowanego adaptera <code>inpostAdapter</code> w <code>cms.config.ts</code>.
+				</p>
+
+				<label class="block">
+					<span class="mb-1 block text-sm font-semibold">Usługa ShipX</span>
+					<select
+						bind:value={inpostServiceType}
+						class="border-border w-full rounded-lg border px-3 py-2"
+					>
+						<option value="inpost_locker_standard">Paczkomat — standard</option>
+						<option value="inpost_locker_express">Paczkomat — Express</option>
+						<option value="inpost_courier_standard">Kurier — standard</option>
+						<option value="inpost_courier_express">Kurier — Express</option>
+					</select>
+				</label>
+
+				<label class="block">
+					<span class="mb-1 block text-sm font-semibold">Domyślny rozmiar paczki</span>
+					<select
+						bind:value={inpostDefaultSize}
+						class="border-border w-full rounded-lg border px-3 py-2"
+					>
+						<option value="A">A — mała (8 × 38 × 64 cm)</option>
+						<option value="B">B — średnia (19 × 38 × 64 cm)</option>
+						<option value="C">C — duża (41 × 38 × 64 cm)</option>
+					</select>
+				</label>
+
+				{#if inpostServiceType.startsWith('inpost_courier_')}
+					<p class="text-muted-foreground text-xs">
+						Kurier dostarcza pod adres — klient nie wybiera paczkomatu.
+					</p>
+				{:else}
+					<p class="text-muted-foreground text-xs">
+						Klient wybiera paczkomat odbiorczy w geowidgetcie InPost.
+					</p>
+				{/if}
+			</div>
+		{/if}
 	</section>
 
 	<div class="flex gap-3">

package/dist/admin/client/shop/shipping-method-form.svelte.d.ts

@@ -1,4 +1,10 @@
 type CarrierType = 'none' | 'inpost';
+type InpostServiceType = 'inpost_locker_standard' | 'inpost_locker_express' | 'inpost_courier_standard' | 'inpost_courier_express';
+type InpostParcelSize = 'A' | 'B' | 'C';
+interface CarrierConfig {
+    serviceType?: InpostServiceType | string;
+    defaultSize?: InpostParcelSize | string;
+}
 export interface PaymentMethodOption {
     id: string;
     label: Record<string, string>;
@@ -9,6 +15,7 @@ export interface ShippingFormPayload {
     price: number;
     vatRate: number;
     carrierType: CarrierType;
+    carrierConfig: CarrierConfig | null;
     conditions: {
         freeAbove?: number;
     } | null;
@@ -19,9 +26,10 @@ export interface ShippingFormPayload {
 export interface ShippingFormInitial {
     name?: Record<string, string> | unknown;
     description?: Record<string, string> | unknown | null;
-    price?: number;
+    price?: number | string;
     vatRate?: number;
     carrierType?: string;
+    carrierConfig?: CarrierConfig | null;
     conditions?: {
         freeAbove?: number;
     } | null;

package/dist/admin/client/shop/shipping-methods-list-page.svelte

@@ -35,12 +35,15 @@
 		}
 	});
 
-	function formatPrice(smallest: number) {
+	function formatPricePln(pln: number) {
 		return new Intl.NumberFormat('pl-PL', {
 			style: 'currency',
 			currency: 'PLN',
 			minimumFractionDigits: 2
-		}).format(smallest / 100);
+		}).format(pln);
+	}
+	function formatPriceCents(cents: number) {
+		return formatPricePln(cents / 100);
 	}
 
 	async function doReorder(fromIndex: number, toIndex: number) {
@@ -143,11 +146,11 @@
 								{resolveI18n(m.name as Record<string, string>, interfaceLanguage.current, '')}
 							</a>
 						</div>
-						<div>{formatPrice(m.price)}</div>
+						<div>{formatPricePln(Number(m.price))}</div>
 						<div>{m.vatRate}%</div>
 						<div>
 							{#if cond?.freeAbove != null}
-								{formatPrice(cond.freeAbove)}
+								{formatPriceCents(cond.freeAbove)}
 							{:else}
 								<span class="text-muted-foreground text-xs">—</span>
 							{/if}

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

@@ -45,6 +45,7 @@
 	let note = $state('');
 	let saving = $state(false);
 	let resending = $state(false);
+	let shipping = $state(false);
 	let errorMessage = $state<string | null>(null);
 	let successMessage = $state<string | null>(null);
 
@@ -102,6 +103,49 @@
 			resending = false;
 		}
 	}
+
+	async function handleCreateShipment() {
+		shipping = true;
+		errorMessage = null;
+		successMessage = null;
+		try {
+			const result = await remotes.createShipmentForOrderCmd({ orderId });
+			if (!result.success) {
+				errorMessage = result.error;
+			} else {
+				successMessage = result.trackingNumber
+					? `Przesyłka utworzona — ${result.trackingNumber}`
+					: 'Przesyłka utworzona. Numer śledzenia pojawi się po potwierdzeniu w ShipX.';
+				await query.refresh();
+			}
+		} catch (err) {
+			errorMessage =
+				err instanceof Error ? err.message : 'Błąd przy tworzeniu przesyłki';
+		} finally {
+			shipping = false;
+		}
+	}
+
+	async function handleCancelShipment() {
+		if (!confirm('Anulować przesyłkę? Etykieta zostanie unieważniona w ShipX.')) return;
+		shipping = true;
+		errorMessage = null;
+		successMessage = null;
+		try {
+			const result = await remotes.cancelShipmentForOrderCmd({ orderId });
+			if (!result.success) {
+				errorMessage = result.error;
+			} else {
+				successMessage = 'Przesyłka anulowana.';
+				await query.refresh();
+			}
+		} catch (err) {
+			errorMessage =
+				err instanceof Error ? err.message : 'Błąd przy anulowaniu przesyłki';
+		} finally {
+			shipping = false;
+		}
+	}
 </script>
 
 {#if !query.ready}
@@ -268,6 +312,63 @@
 					</Button>
 				</section>
 
+				{#if order.carrierType && order.carrierType !== 'none'}
+					<section class="border-border bg-card space-y-3 rounded-xl border p-5 text-sm">
+						<h2 class="text-base font-bold">
+							Przesyłka <span class="text-muted-foreground font-mono text-xs">{order.carrierType}</span>
+						</h2>
+						{#if order.shipmentId}
+							<div class="space-y-1">
+								<div class="text-muted-foreground text-xs font-semibold">Shipment ID</div>
+								<div class="font-mono text-xs break-all">{order.shipmentId}</div>
+							</div>
+							{#if order.trackingNumber}
+								<div class="space-y-1">
+									<div class="text-muted-foreground text-xs font-semibold">Numer śledzenia</div>
+									<div class="font-mono text-xs break-all">{order.trackingNumber}</div>
+								</div>
+							{:else}
+								<p class="text-xs text-amber-700">
+									Numer śledzenia pojawi się gdy ShipX potwierdzi przesyłkę (zwykle w kilka minut).
+								</p>
+							{/if}
+							<div class="flex flex-wrap gap-2 pt-2">
+								<Button
+									href="/api/shop/admin/orders/{orderId}/label"
+									variant="outline"
+									size="sm"
+									target="_blank"
+								>
+									Pobierz etykietę PDF
+								</Button>
+								<Button
+									onclick={handleCancelShipment}
+									disabled={shipping}
+									variant="outline"
+									size="sm"
+								>
+									Anuluj przesyłkę
+								</Button>
+							</div>
+						{:else if order.status === 'paid' || order.status === 'preparing'}
+							<p class="text-muted-foreground text-xs">
+								Wygeneruj etykietę i nadaj paczkę przez ShipX.
+							</p>
+							<Button
+								onclick={handleCreateShipment}
+								disabled={shipping}
+								class="w-full"
+							>
+								{shipping ? 'Tworzenie…' : 'Utwórz przesyłkę InPost'}
+							</Button>
+						{:else}
+							<p class="text-muted-foreground text-xs">
+								Przesyłkę można utworzyć po opłaceniu zamówienia.
+							</p>
+						{/if}
+					</section>
+				{/if}
+
 				<section class="border-border bg-card space-y-2 rounded-xl border p-5 text-sm">
 					<h2 class="text-base font-bold">Klient</h2>
 					<div>

package/dist/admin/client/shop/shop-products-list-page.svelte

@@ -13,12 +13,12 @@
 	const entriesQuery = $derived(remotes.listShopProductEntries());
 	const collectionsQuery = $derived(remotes.listShopableCollections());
 
-	function formatPrice(smallest: number) {
+	function formatPrice(pln: number) {
 		return new Intl.NumberFormat('pl-PL', {
 			style: 'currency',
 			currency: 'PLN',
 			minimumFractionDigits: 2
-		}).format(smallest / 100);
+		}).format(pln);
 	}
 
 	function resolveTitle(data: Record<string, unknown> | null, fallback: string): string {