@endora-commerce/mod-inventory 0.100.0

package/dist/manifest.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Settings manifest for the Inventory module — feature 010.
+ *
+ * Seven settings (FR-019 / FR-029 / FR-031). Setting codes follow
+ * the foundation regex `^[a-z][a-z0-9_][a-z0-9_.]*[a-z0-9]$`.
+ */
+export declare const INVENTORY_SETTING_CODES: {
+    readonly DISPLAY_MODE: "inventory.display_mode";
+    readonly FULFILMENT_STRATEGY: "inventory.fulfilment_strategy";
+    readonly FULFILMENT_STRATEGY_WAREHOUSE_ORDER: "inventory.fulfilment_strategy_warehouse_order";
+    readonly GLOBAL_THRESHOLD_HIGH: "inventory.global_threshold_high";
+    readonly GLOBAL_THRESHOLD_MEDIUM: "inventory.global_threshold_medium";
+    readonly GLOBAL_THRESHOLD_LOW: "inventory.global_threshold_low";
+    readonly LOW_STOCK_ALERT_RECIPIENT_EMAIL: "inventory.low_stock_alert_recipient_email";
+    readonly ALLOW_NEGATIVE_STOCK: "inventory.allow_negative_stock";
+};
+/** Module-lifecycle manifest (feature 018). */
+export declare const manifest: {
+    id: string;
+    name: string;
+    version: string;
+    dependencies: string[];
+    description?: string | undefined;
+    acknowledgedDependencies?: {
+        moduleId: string;
+        port: string;
+        reason: string;
+    }[] | undefined;
+    nonBindingDependencies?: {
+        moduleId: string;
+        name: string;
+        kind: "contributes-to" | "degrades-without" | "refuses-without";
+        reason: string;
+        whenAbsent?: string | undefined;
+    }[] | undefined;
+    activation?: {
+        settingCode: string;
+        default: boolean;
+    } | {
+        nonDeactivatable: true;
+        reason: string;
+    } | undefined;
+    settings?: {
+        moduleCode: string;
+        groups: {
+            code: string;
+            name: string;
+            salesChannelCodes?: string[] | undefined;
+            isSystemProtected?: boolean | undefined;
+        }[];
+        settings: {
+            code: string;
+            name: string;
+            valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+            defaultValue: unknown;
+            description?: string | undefined;
+            groupCode?: string | undefined;
+            previousDefaultValues?: unknown[] | undefined;
+            salesChannelCodes?: string[] | undefined;
+            enumOptions?: string[] | undefined;
+            configurationType?: string | undefined;
+            hidden?: boolean | undefined;
+        }[];
+    } | undefined;
+    i18n?: {
+        bundlesDir: string;
+    } | undefined;
+    docs?: false | {
+        dir: string;
+    } | undefined;
+    demo?: false | {
+        summary: string;
+        seed: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoSeedResult>;
+        reset: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoResetResult>;
+        after?: readonly string[] | undefined;
+        package?: string | undefined;
+    } | undefined;
+    actions?: {
+        id: string;
+        labelKey: string;
+        icon: "Warehouse" | "Plus" | "Sparkles" | "Settings" | "Search" | "Boxes" | "Layers" | "Menu" | "PlusCircle" | "PlusSquare" | "FilePlus" | "FolderPlus" | "Upload" | "FileUp" | "CloudUpload" | "Download" | "FileDown" | "FileText" | "BookOpen" | "Rss" | "Package" | "Tag" | "ShoppingCart" | "Receipt" | "CreditCard" | "Users" | "UserPlus" | "Inbox" | "ListChecks" | "ClipboardList" | "Image" | "Video" | "LayoutDashboard" | "PanelLeft" | "KeyRound" | "ShieldCheck" | "Edit" | "Archive" | "Box" | "Truck" | "CircleDollarSign" | "Activity" | "LineChart" | "Smartphone" | "Webhook" | "Scale" | "PlugZap" | "PercentDiamond" | "Newspaper" | "Languages" | "Eraser" | "TrendingDown" | "Bell" | "PackageOpen" | "Building2" | "Store" | "ClipboardCheck";
+        targetRoute: string;
+        keywords: string[];
+        weight: number;
+        descriptionKey?: string | undefined;
+        requiredPermission?: string | undefined;
+    }[] | undefined;
+    permissions?: {
+        code: string;
+        label: string;
+        module?: string | undefined;
+        description?: string | undefined;
+        requires?: string[] | undefined;
+    }[] | undefined;
+    transactionalEmails?: {
+        code: string;
+        name: string;
+        variables: {
+            key: string;
+            label: string;
+            sampleValue?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    capabilities?: string[] | undefined;
+    exclusiveCapabilities?: {
+        key: string;
+        errorCode: string;
+    }[] | undefined;
+    errorCodes?: {
+        code: string;
+        tokens?: string[] | undefined;
+    }[] | undefined;
+    blocks?: {
+        name: string;
+        labelKey: string;
+        category: string;
+        contexts: ("email" | "invoice" | "cms" | "newsletter")[];
+        fields: Record<string, {
+            type: "number" | "object" | "array" | "uuid" | "text" | "textarea" | "select" | "radio" | "external" | "richtext";
+            label?: string | undefined;
+            required?: boolean | undefined;
+            options?: {
+                label: string;
+                value: string | number;
+            }[] | undefined;
+            refKind?: string | undefined;
+        }>;
+        descriptionKey?: string | undefined;
+        defaultProps?: Record<string, unknown> | undefined;
+        responsiveFields?: string[] | undefined;
+        previewIcon?: string | undefined;
+        weight?: number | undefined;
+    }[] | undefined;
+    blockCategories?: {
+        key: string;
+        titleKey: string;
+        contexts: ("email" | "invoice" | "cms" | "newsletter")[];
+        weight?: number | undefined;
+        visible?: boolean | undefined;
+    }[] | undefined;
+    env?: {
+        name: string;
+        describes: {
+            en: string;
+            pl: string;
+        };
+        requirement: {
+            kind: "required";
+        } | {
+            kind: "requiredWhen";
+            input: string;
+            equals: string;
+        } | {
+            kind: "optional";
+            without: {
+                en: string;
+                pl: string;
+            };
+        };
+        secret: boolean;
+        generable: boolean;
+        owner: {
+            kind: "platform";
+        } | {
+            kind: "application";
+            application: "admin" | "backend" | "storefront";
+        } | {
+            kind: "module";
+            moduleId: string;
+        };
+        consumers: ("admin" | "backend" | "storefront")[];
+        addressOf: "admin" | "backend" | "storefront" | null;
+    }[] | undefined;
+};
+/** Legacy export retained for backward compatibility. */
+export declare const inventoryManifest: {
+    moduleCode: string;
+    groups: {
+        code: string;
+        name: string;
+        salesChannelCodes?: string[] | undefined;
+        isSystemProtected?: boolean | undefined;
+    }[];
+    settings: {
+        code: string;
+        name: string;
+        valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+        defaultValue: unknown;
+        description?: string | undefined;
+        groupCode?: string | undefined;
+        previousDefaultValues?: unknown[] | undefined;
+        salesChannelCodes?: string[] | undefined;
+        enumOptions?: string[] | undefined;
+        configurationType?: string | undefined;
+        hidden?: boolean | undefined;
+    }[];
+};
+/**
+ * What this module offers the admin home dashboard's Recent Activity card —
+ * feature 080, T042j / D-163.1.
+ *
+ * The **declaration** axis: eligibility, never a decision. Whether these rows
+ * appear is the operator's, held in `inventory.recent_activity_visible` and
+ * defaulting to visible, flipped on `/platform/modules` beside this module's
+ * activation control. The two are different questions about the same module —
+ * "does this client want stock management" and "does this client want stock
+ * movements on their home screen" — which is why there are two switches.
+ */
+export declare const recentActivity: {
+    entries: {
+        action: string;
+        icon: "Warehouse" | "Plus" | "Sparkles" | "Settings" | "Search" | "Boxes" | "Layers" | "Menu" | "PlusCircle" | "PlusSquare" | "FilePlus" | "FolderPlus" | "Upload" | "FileUp" | "CloudUpload" | "Download" | "FileDown" | "FileText" | "BookOpen" | "Rss" | "Package" | "Tag" | "ShoppingCart" | "Receipt" | "CreditCard" | "Users" | "UserPlus" | "Inbox" | "ListChecks" | "ClipboardList" | "Image" | "Video" | "LayoutDashboard" | "PanelLeft" | "KeyRound" | "ShieldCheck" | "Edit" | "Archive" | "Box" | "Truck" | "CircleDollarSign" | "Activity" | "LineChart" | "Smartphone" | "Webhook" | "Scale" | "PlugZap" | "PercentDiamond" | "Newspaper" | "Languages" | "Eraser" | "TrendingDown" | "Bell" | "PackageOpen" | "Building2" | "Store" | "ClipboardCheck";
+        labelKey: string;
+    }[];
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAgCA;;;;;GAKG;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;CAS1B,CAAC;AAuFX,+CAA+C;AAC/C,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+MnB,CAAC;AAEH,yDAAyD;AACzD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;CAAW,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc;;;;;;CAoCzB,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,377 @@
+import { defineModuleManifest, defineModuleRecentActivity, defineModuleSettingsManifest, } from '@endora-commerce/contracts';
+/**
+ * The demo data this module owns (feature 113, T223 — contract §1.3).
+ *
+ * A typed `const` rather than an inline object literal: declared inline the
+ * parameter infers from the schema and is `never`, so the author loses
+ * `context.ctx: ModuleContext`.
+ *
+ * Both bodies are reached by a **relative `await import()`** (§1.4), in
+ * `cliCommands.run`'s shape and for `cliCommands`' reason: a manifest is loaded
+ * by every process that composes the platform and by the check scripts that
+ * import the generated index, so a demo body imported at the top of this file
+ * would be a service graph pulled into all of them. It needs no `exports`
+ * subpath and no `files` entry (§1.5).
+ *
+ * The stock spread across the two warehouses is **not** here: quantities per
+ * product are `catalog`'s rows and this module's in one statement, so they are
+ * a composition step (§5.1) and belong to whoever owns the instance.
+ */
+const demo = {
+    summary: 'A second warehouse, assigned to every sales channel.',
+    seed: async (context) => (await import('./backend/demo/seed.js')).seedDemo(context),
+    reset: async (context) => (await import('./backend/demo/reset.js')).resetDemo(context),
+};
+/**
+ * Settings manifest for the Inventory module — feature 010.
+ *
+ * Seven settings (FR-019 / FR-029 / FR-031). Setting codes follow
+ * the foundation regex `^[a-z][a-z0-9_][a-z0-9_.]*[a-z0-9]$`.
+ */
+export const INVENTORY_SETTING_CODES = {
+    DISPLAY_MODE: 'inventory.display_mode',
+    FULFILMENT_STRATEGY: 'inventory.fulfilment_strategy',
+    FULFILMENT_STRATEGY_WAREHOUSE_ORDER: 'inventory.fulfilment_strategy_warehouse_order',
+    GLOBAL_THRESHOLD_HIGH: 'inventory.global_threshold_high',
+    GLOBAL_THRESHOLD_MEDIUM: 'inventory.global_threshold_medium',
+    GLOBAL_THRESHOLD_LOW: 'inventory.global_threshold_low',
+    LOW_STOCK_ALERT_RECIPIENT_EMAIL: 'inventory.low_stock_alert_recipient_email',
+    ALLOW_NEGATIVE_STOCK: 'inventory.allow_negative_stock',
+};
+const settings = defineModuleSettingsManifest({
+    moduleCode: 'inventory',
+    groups: [{ code: 'inventory', name: 'Inventory' }],
+    settings: [
+        {
+            // Feature 073 — the operator's activation control. Platform-wide.
+            code: 'inventory.enabled',
+            name: 'Inventory enabled',
+            description: 'Switches stock management on or off: warehouses, stock levels and their adjustments, low-stock alerts, the back-in-stock notification flow and the storefront stock figure. Nothing is dropped — every warehouse, stock row and pending notification stays in the database and resumes where it was.',
+            groupCode: 'inventory',
+            valueType: 'boolean',
+            defaultValue: true,
+        },
+        {
+            code: INVENTORY_SETTING_CODES.DISPLAY_MODE,
+            name: 'Storefront stock display mode',
+            description: 'How storefront product cards and PDP render stock: exact / band / available_or_not.',
+            groupCode: 'inventory',
+            valueType: 'string',
+            defaultValue: 'band',
+        },
+        {
+            code: INVENTORY_SETTING_CODES.FULFILMENT_STRATEGY,
+            name: 'Order fulfilment strategy',
+            description: 'Picks warehouses to fulfil order lines. any | default_first | lowest_stock_first | highest_stock_first | defined_order.',
+            groupCode: 'inventory',
+            valueType: 'string',
+            defaultValue: 'default_first',
+        },
+        {
+            code: INVENTORY_SETTING_CODES.FULFILMENT_STRATEGY_WAREHOUSE_ORDER,
+            name: 'Warehouse order (for "defined_order" strategy)',
+            description: 'Ordered list of warehouse IDs walked by the defined-order strategy.',
+            groupCode: 'inventory',
+            valueType: 'json',
+            defaultValue: [],
+        },
+        {
+            code: INVENTORY_SETTING_CODES.GLOBAL_THRESHOLD_HIGH,
+            name: 'Global high-stock threshold',
+            description: 'Quantity at or above which a product is considered high-stock.',
+            groupCode: 'inventory',
+            valueType: 'number',
+            defaultValue: 100,
+        },
+        {
+            code: INVENTORY_SETTING_CODES.GLOBAL_THRESHOLD_MEDIUM,
+            name: 'Global medium-stock threshold',
+            description: 'Quantity at or above which a product is considered medium-stock.',
+            groupCode: 'inventory',
+            valueType: 'number',
+            defaultValue: 20,
+        },
+        {
+            code: INVENTORY_SETTING_CODES.GLOBAL_THRESHOLD_LOW,
+            name: 'Global low-stock threshold',
+            description: 'Quantity at or above which a product is considered low-stock. Below this it is out of stock.',
+            groupCode: 'inventory',
+            valueType: 'number',
+            defaultValue: 1,
+        },
+        {
+            code: INVENTORY_SETTING_CODES.LOW_STOCK_ALERT_RECIPIENT_EMAIL,
+            name: 'Low-stock alert recipient email',
+            description: 'Email to receive low-stock alerts. Empty falls back to the platform admin.',
+            groupCode: 'inventory',
+            valueType: 'string',
+            defaultValue: '',
+        },
+        {
+            code: INVENTORY_SETTING_CODES.ALLOW_NEGATIVE_STOCK,
+            name: 'Allow ordering below stock (negative stock)',
+            description: 'Global gate for per-product backorder. When false, no product accepts orders below available stock regardless of its per-product backorder flag. When true, products whose backorder flag is set may be ordered into negative stock.',
+            groupCode: 'inventory',
+            valueType: 'boolean',
+            defaultValue: false,
+        },
+    ],
+});
+/** Module-lifecycle manifest (feature 018). */
+export const manifest = defineModuleManifest({
+    id: 'inventory',
+    name: 'Inventory',
+    description: 'Multi-warehouse stock levels, fulfilment strategy, and storefront display modes.',
+    version: '1.0.0',
+    /**
+     * What this module needs from the environment (`specs/117-instance-bring-up/`
+     * FR-002). Only what it **owns**: its reads of platform-owned names are
+     * satisfied by `packages/platform/src/env/index.ts`.
+     *
+     * Why each of these is not a Setting is its entry in
+     * `backend/scripts/ledgers/module-environment-inputs/inventory.ts`.
+     */
+    env: [
+        {
+            name: 'INVENTORY_LOW_STOCK_RECIPIENT',
+            describes: {
+                en: 'Who is e-mailed when a product falls below its low-stock threshold, where the Setting of the same name has not been filled in.',
+                pl: 'Kto dostaje wiadomość, gdy produkt spadnie poniżej progu niskiego stanu, o ile ustawienie o tej samej nazwie nie zostało wypełnione.',
+            },
+            requirement: {
+                kind: 'optional',
+                without: {
+                    en: 'A product crossing its low-stock threshold alerts nobody, unless the Setting carries an address.',
+                    pl: 'Produkt przekraczający próg niskiego stanu nikogo nie powiadomi, o ile adres nie znajdzie się w ustawieniu.',
+                },
+            },
+            secret: false,
+            generable: false,
+            owner: { kind: 'module', moduleId: 'inventory' },
+            consumers: ['backend'],
+            addressOf: null,
+        },
+    ],
+    // Feature 075, Phase C adds `customer_accounts` and `email`. Both were
+    // reached by importing a file rather than resolving a port, so neither
+    // appeared here: the availability queue turns a subscription into an e-mail
+    // address by reading `CustomerAccount`, and every message this module sends
+    // leaves through `email`'s transport. `customer_accounts` belongs in
+    // `dependencies` rather than `nonBindingDependencies` for the reason
+    // `quick_order` gives — a back-in-stock notice addressed to an account the
+    // platform will not identify is worse than a refused subscription.
+    //
+    // D-94.1 adds `orders`, for the foreign key
+    // `stock_allocations_order_item_fk` (`stock_allocations.order_item_id` ->
+    // `order_items.id`, `on delete restrict`). AGENTS.md § Migrations item 4: a
+    // cross-module foreign key is declared here or the build fails. It is the
+    // one edge of the four-site family that closes no cycle — `orders` resolves
+    // no port this module owns in `dependencies`, only the two
+    // `degrades-without` reads placement makes.
+    // `audit_logs` owns `auditReferenceRegistry`, the registry this module pushes
+    // its own "what is this audit row called, and where does the admin app show
+    // it?" resolver into (feature 075, D-87). The registry is ungated and its
+    // owner is non-deactivatable, so the declaration buys install and migration
+    // order rather than a flip-time refusal.
+    dependencies: [
+        'audit_logs',
+        'auth',
+        'catalog',
+        'customer_accounts',
+        'dictionaries',
+        'email',
+        'orders',
+        'organizations',
+        'sales_channels',
+        'settings',
+        'transactional_emails',
+    ],
+    // D-44 — real to the container, binding on no operator.
+    nonBindingDependencies: [
+        {
+            moduleId: 'prompt_actions',
+            name: 'promptActionToolRegistry',
+            kind: 'contributes-to',
+            reason: 'A push, from this module’s boot hook, of the warehouse resolver and the ' +
+                '`set_stock_level` mutation built over its own services. Nothing is read back: ' +
+                'the registry is a plain registration that drops every tool whose owner is not ' +
+                'effectively present, so an absent contributor costs the host nothing and an ' +
+                'absent host holds a table nobody walks. Declaring the edge would make an ' +
+                'optional assistant undeactivatable for as long as stock is tracked.',
+        },
+    ],
+    /**
+     * The module's own authority (2026-08-29).
+     *
+     * All 21 admin gates enforced a code somebody else owns — nine reads on
+     * `orders:read`, twelve writes on `catalog:write`. So whoever could edit a
+     * product description could create, rename and **delete a warehouse**,
+     * rewrite a stock count, run a CSV import over every product's stock and bind
+     * or unbind a warehouse from a sales channel, which decides what that channel
+     * can sell. And whoever could read orders could enumerate every warehouse and
+     * its address. Neither code names the data touched, which is the
+     * discriminator `payments-permission-ownership.md` §7.2 sets; the sweep
+     * applied it per module and `specs/080-f4-real-scope/first-deployment-window.md` §2 re-applies
+     * it per route, which is where authority is actually exercised.
+     *
+     * Nothing could see it. Both codes are real, declared and enforced, so the
+     * permission inventory's two directions were clean; D-173's `foreign-gate`
+     * sweep passes both sites deliberately, because `catalog` and `orders` are
+     * `nonDeactivatable` and the availability coupling that sweep asks about can
+     * never bite. `check:action-route-permissions` is the one check that *did*
+     * look here — this module declares the `open-inventory` action below — and it
+     * agreed, because the action correctly named the code the route enforced.
+     * That is the check working: it compares an action to its route and has no
+     * opinion about whether the route's code is the right authority.
+     *
+     * A pair and no third code, spelled `<module id>:<read|write>` like
+     * `payment_methods`, `delivery_methods`, `taxes`, `returns` and `invoices`.
+     *
+     * No data migration: see
+     * `test/contract/inventory/permission-authority.test.ts`.
+     */
+    permissions: [
+        { code: 'inventory:read', label: 'View stock and warehouses' },
+        { code: 'inventory:write', label: 'Manage stock and warehouses' },
+    ],
+    /**
+     * The thirteen error codes this module owns — feature 090 Phase 3
+     * (`specs/090-module-owned-error-codes/contracts/error-code-declaration.md`
+     * §1.1). This is where the sentence for each is looked up from: `errors.<CODE>`
+     * in this module's own `i18n/{en,pl}.json`, which already holds all thirteen in
+     * both languages.
+     *
+     * The list is answer-preserving, not a judgement (§6.2 and §6.5): it is exactly
+     * what the prefix chain in `@endora-commerce/mod-i18n` routes here today,
+     * copied from the frozen capture at
+     * `backend/test/fixtures/error-code-routing/chain-answers.ts` rather than
+     * re-derived. Re-routing a code to a better owner is
+     * `specs/082-error-code-ownership/rulings.md` §9's remaining work and is
+     * deliberately not done here.
+     *
+     * **Two codes that look like they belong here and do not**, because the chain
+     * is ordered and `catalog`'s rule runs before this module's:
+     * `PRODUCT_UNMANAGED_STOCK` and `PRODUCT_IN_STOCK` are named in the chain's own
+     * `INVENTORY_MISC_ERROR_CODES` set and route to `catalog` regardless, so two of
+     * that set's three members are unreachable. An author who wrote this list from
+     * the chain's source rather than from its answer would have taken two of
+     * `catalog`'s codes.
+     *
+     * No `tokens`: no code here carries a refusal discriminator, which is derivable
+     * from this module's bundles holding no `errors.<CODE>.<token>` key.
+     */
+    errorCodes: [
+        { code: 'AVAILABILITY_NOTIFICATION_NOT_FOUND' },
+        { code: 'CHANNEL_NO_WAREHOUSES' },
+        { code: 'CHANNEL_WAREHOUSE_NOT_FOUND' },
+        { code: 'STOCK_IMPORT_INVALID_FILE' },
+        { code: 'STOCK_LEVEL_NOT_FOUND' },
+        { code: 'STOCK_UNAVAILABLE' },
+        { code: 'THRESHOLDS_INVALID' },
+        { code: 'WAREHOUSE_CANNOT_DELETE_DEFAULT' },
+        { code: 'WAREHOUSE_CODE_TAKEN' },
+        { code: 'WAREHOUSE_HAS_STOCK' },
+        { code: 'WAREHOUSE_INVALID_CODE' },
+        { code: 'WAREHOUSE_IS_DEFAULT_FOR_CHANNELS' },
+        { code: 'WAREHOUSE_NOT_FOUND' },
+    ],
+    settings,
+    // Feature 073 (Constitution XVII) — the operator's activation control.
+    demo,
+    activation: { settingCode: 'inventory.enabled', default: true },
+    i18n: { bundlesDir: 'i18n' },
+    docs: { dir: 'docs' },
+    // Feature 047 — admin-editable transactional emails owned by this module.
+    transactionalEmails: [
+        {
+            code: 'low_stock_alert',
+            name: 'Low stock alert',
+            group: 'inventory',
+            variables: [
+                { key: 'product.name', label: 'Product name', sampleValue: 'Widget' },
+                { key: 'product.sku', label: 'Product SKU', sampleValue: 'WID-001' },
+                { key: 'cumulativeOnHand', label: 'Cumulative on-hand', sampleValue: '3' },
+                { key: 'threshold', label: 'Threshold', sampleValue: '5' },
+            ],
+        },
+        {
+            code: 'availability_back_in_stock',
+            name: 'Back in stock notification',
+            group: 'inventory',
+            variables: [{ key: 'product.name', label: 'Product name', sampleValue: 'Widget' }],
+        },
+    ],
+    actions: [
+        {
+            id: 'open-inventory',
+            labelKey: 'actions.openInventory.label',
+            descriptionKey: 'actions.openInventory.description',
+            icon: 'Boxes',
+            targetRoute: '/inventory',
+            // `inventory:read`, the code `GET /api/v1/admin/inventory` now enforces
+            // (`routes.admin.ts`). This has been corrected twice for two different
+            // reasons and both are worth keeping. Issue #232 replaced a `catalog:write`
+            // that was wrong in both directions at once — it hid the screen from
+            // operators who can open it and offered it to some who cannot — with
+            // `orders:read`, the code the route then enforced. That was right, and it
+            // is why `check:action-route-permissions` had nothing to say when the
+            // gates themselves were the defect: the check compares an action to its
+            // route, which is a derivation, and never asks whether the route's code is
+            // the right authority, which is a judgement.
+            requiredPermission: 'inventory:read',
+            keywords: ['stock', 'inventory', 'warehouse', 'magazyn', 'zapasy'],
+            weight: 230,
+        },
+    ],
+});
+/** Legacy export retained for backward compatibility. */
+export const inventoryManifest = settings;
+/**
+ * What this module offers the admin home dashboard's Recent Activity card —
+ * feature 080, T042j / D-163.1.
+ *
+ * The **declaration** axis: eligibility, never a decision. Whether these rows
+ * appear is the operator's, held in `inventory.recent_activity_visible` and
+ * defaulting to visible, flipped on `/platform/modules` beside this module's
+ * activation control. The two are different questions about the same module —
+ * "does this client want stock management" and "does this client want stock
+ * movements on their home screen" — which is why there are two switches.
+ */
+export const recentActivity = defineModuleRecentActivity({
+    entries: [
+        { action: 'warehouse.create', icon: 'Truck', labelKey: 'activity.verb.warehouse.create' },
+        { action: 'warehouse.update', icon: 'Edit', labelKey: 'activity.verb.warehouse.update' },
+        {
+            action: 'warehouse.deactivate',
+            icon: 'Archive',
+            labelKey: 'activity.verb.warehouse.deactivate',
+        },
+        {
+            action: 'warehouse.reactivate',
+            icon: 'Truck',
+            labelKey: 'activity.verb.warehouse.reactivate',
+        },
+        { action: 'stock_level.adjust', icon: 'Box', labelKey: 'activity.verb.stock_level.adjust' },
+        {
+            action: 'stock_level.bulk_import',
+            icon: 'Upload',
+            labelKey: 'activity.verb.stock_level.bulk_import',
+        },
+        {
+            action: 'low_stock_threshold.create',
+            icon: 'Tag',
+            labelKey: 'activity.verb.low_stock_threshold.create',
+        },
+        {
+            action: 'low_stock_threshold.update',
+            icon: 'Edit',
+            labelKey: 'activity.verb.low_stock_threshold.update',
+        },
+        {
+            action: 'low_stock_threshold.delete',
+            icon: 'Archive',
+            labelKey: 'activity.verb.low_stock_threshold.delete',
+        },
+    ],
+});
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,GAE7B,MAAM,4BAA4B,CAAC;AAGpC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,IAAI,GAAsC;IAC9C,OAAO,EAAE,sDAAsD;IAC/D,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;IACnF,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;CACvF,CAAC;AAEF;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,YAAY,EAAE,wBAAwB;IACtC,mBAAmB,EAAE,+BAA+B;IACpD,mCAAmC,EAAE,+CAA+C;IACpF,qBAAqB,EAAE,iCAAiC;IACxD,uBAAuB,EAAE,mCAAmC;IAC5D,oBAAoB,EAAE,gCAAgC;IACtD,+BAA+B,EAAE,2CAA2C;IAC5E,oBAAoB,EAAE,gCAAgC;CAC9C,CAAC;AAEX,MAAM,QAAQ,GAAG,4BAA4B,CAAC;IAC5C,UAAU,EAAE,WAAW;IACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAClD,QAAQ,EAAE;QACR;YACE,kEAAkE;YAClE,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,mBAAmB;YACzB,WAAW,EACT,sSAAsS;YACxS,SAAS,EAAE,WAAW;YACtB,SAAS,EAAE,SAAS;YACpB,YAAY,EAAE,IAAI;SACnB;QACD;YACE,IAAI,EAAE,uBAAuB,CAAC,YAAY;YAC1C,IAAI,EAAE,+BAA+B;YACrC,WAAW,EACT,qFAAqF;YACvF,SAAS,EAAE,WAAW;YACtB,SAAS,EAAE,QAAQ;YACnB,YAAY,EAAE,MAAM;SACrB;QACD;YACE,IAAI,EAAE,uBAAuB,CAAC,mBAAmB;YACjD,IAAI,EAAE,2BAA2B;YACjC,WAAW,EACT,yHAAyH;YAC3H,SAAS,EAAE,WAAW;YACtB,SAAS,EAAE,QAAQ;YACnB,YAAY,EAAE,eAAe;SAC9B;QACD;YACE,IAAI,EAAE,uBAAuB,CAAC,mCAAmC;YACjE,IAAI,EAAE,gDAAgD;YACtD,WAAW,EAAE,qEAAqE;YAClF,SAAS,EAAE,WAAW;YACtB,SAAS,EAAE,MAAM;YACjB,YAAY,EAAE,EAAE;SACjB;QACD;YACE,IAAI,EAAE,uBAAuB,CAAC,qBAAqB;YACnD,IAAI,EAAE,6BAA6B;YACnC,WAAW,EAAE,gEAAgE;YAC7E,SAAS,EAAE,WAAW;YACtB,SAAS,EAAE,QAAQ;YACnB,YAAY,EAAE,GAAG;SAClB;QACD;YACE,IAAI,EAAE,uBAAuB,CAAC,uBAAuB;YACrD,IAAI,EAAE,+BAA+B;YACrC,WAAW,EAAE,kEAAkE;YAC/E,SAAS,EAAE,WAAW;YACtB,SAAS,EAAE,QAAQ;YACnB,YAAY,EAAE,EAAE;SACjB;QACD;YACE,IAAI,EAAE,uBAAuB,CAAC,oBAAoB;YAClD,IAAI,EAAE,4BAA4B;YAClC,WAAW,EACT,8FAA8F;YAChG,SAAS,EAAE,WAAW;YACtB,SAAS,EAAE,QAAQ;YACnB,YAAY,EAAE,CAAC;SAChB;QACD;YACE,IAAI,EAAE,uBAAuB,CAAC,+BAA+B;YAC7D,IAAI,EAAE,iCAAiC;YACvC,WAAW,EAAE,4EAA4E;YACzF,SAAS,EAAE,WAAW;YACtB,SAAS,EAAE,QAAQ;YACnB,YAAY,EAAE,EAAE;SACjB;QACD;YACE,IAAI,EAAE,uBAAuB,CAAC,oBAAoB;YAClD,IAAI,EAAE,6CAA6C;YACnD,WAAW,EACT,sOAAsO;YACxO,SAAS,EAAE,WAAW;YACtB,SAAS,EAAE,SAAS;YACpB,YAAY,EAAE,KAAK;SACpB;KACF;CACF,CAAC,CAAC;AAEH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,QAAQ,GAAG,oBAAoB,CAAC;IAC3C,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,kFAAkF;IACpF,OAAO,EAAE,OAAO;IAChB;;;;;;;OAOG;IACH,GAAG,EAAE;QACH;YACE,IAAI,EAAE,+BAA+B;YACrC,SAAS,EAAE;gBACT,EAAE,EAAE,gIAAgI;gBACpI,EAAE,EAAE,sIAAsI;aAC3I;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE;oBACP,EAAE,EAAE,kGAAkG;oBACtG,EAAE,EAAE,6GAA6G;iBAClH;aACF;YACD,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE;YAChD,SAAS,EAAE,CAAC,SAAS,CAAC;YACtB,SAAS,EAAE,IAAI;SAChB;KACF;IACD,uEAAuE;IACvE,uEAAuE;IACvE,4EAA4E;IAC5E,4EAA4E;IAC5E,qEAAqE;IACrE,qEAAqE;IACrE,2EAA2E;IAC3E,mEAAmE;IACnE,EAAE;IACF,4CAA4C;IAC5C,0EAA0E;IAC1E,4EAA4E;IAC5E,0EAA0E;IAC1E,4EAA4E;IAC5E,2DAA2D;IAC3D,4CAA4C;IAC5C,8EAA8E;IAC9E,4EAA4E;IAC5E,0EAA0E;IAC1E,4EAA4E;IAC5E,yCAAyC;IACzC,YAAY,EAAE;QACZ,YAAY;QACZ,MAAM;QACN,SAAS;QACT,mBAAmB;QACnB,cAAc;QACd,OAAO;QACP,QAAQ;QACR,eAAe;QACf,gBAAgB;QAChB,UAAU;QACV,sBAAsB;KACvB;IACD,wDAAwD;IACxD,sBAAsB,EAAE;QACtB;YACE,QAAQ,EAAE,gBAAgB;YAC1B,IAAI,EAAE,0BAA0B;YAChC,IAAI,EAAE,gBAAgB;YACtB,MAAM,EACJ,0EAA0E;gBAC1E,gFAAgF;gBAChF,gFAAgF;gBAChF,8EAA8E;gBAC9E,2EAA2E;gBAC3E,qEAAqE;SACxE;KACF;IACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,WAAW,EAAE;QACX,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,2BAA2B,EAAE;QAC9D,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,6BAA6B,EAAE;KAClE;IACD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,qCAAqC,EAAE;QAC/C,EAAE,IAAI,EAAE,uBAAuB,EAAE;QACjC,EAAE,IAAI,EAAE,6BAA6B,EAAE;QACvC,EAAE,IAAI,EAAE,2BAA2B,EAAE;QACrC,EAAE,IAAI,EAAE,uBAAuB,EAAE;QACjC,EAAE,IAAI,EAAE,mBAAmB,EAAE;QAC7B,EAAE,IAAI,EAAE,oBAAoB,EAAE;QAC9B,EAAE,IAAI,EAAE,iCAAiC,EAAE;QAC3C,EAAE,IAAI,EAAE,sBAAsB,EAAE;QAChC,EAAE,IAAI,EAAE,qBAAqB,EAAE;QAC/B,EAAE,IAAI,EAAE,wBAAwB,EAAE;QAClC,EAAE,IAAI,EAAE,mCAAmC,EAAE;QAC7C,EAAE,IAAI,EAAE,qBAAqB,EAAE;KAChC;IACD,QAAQ;IACR,uEAAuE;IACvE,IAAI;IACJ,UAAU,EAAE,EAAE,WAAW,EAAE,mBAAmB,EAAE,OAAO,EAAE,IAAI,EAAE;IAC/D,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;IAC5B,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;IACrB,0EAA0E;IAC1E,mBAAmB,EAAE;QACnB;YACE,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,WAAW;YAClB,SAAS,EAAE;gBACT,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE;gBACrE,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE;gBACpE,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,GAAG,EAAE;gBAC1E,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE;aAC3D;SACF;QACD;YACE,IAAI,EAAE,4BAA4B;YAClC,IAAI,EAAE,4BAA4B;YAClC,KAAK,EAAE,WAAW;YAClB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;SACnF;KACF;IACD,OAAO,EAAE;QACP;YACE,EAAE,EAAE,gBAAgB;YACpB,QAAQ,EAAE,6BAA6B;YACvC,cAAc,EAAE,mCAAmC;YACnD,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,YAAY;YACzB,wEAAwE;YACxE,uEAAuE;YACvE,4EAA4E;YAC5E,qEAAqE;YACrE,qEAAqE;YACrE,0EAA0E;YAC1E,sEAAsE;YACtE,wEAAwE;YACxE,2EAA2E;YAC3E,6CAA6C;YAC7C,kBAAkB,EAAE,gBAAgB;YACpC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC;YAClE,MAAM,EAAE,GAAG;SACZ;KACF;CACF,CAAC,CAAC;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,0BAA0B,CAAC;IACvD,OAAO,EAAE;QACP,EAAE,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,gCAAgC,EAAE;QACzF,EAAE,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gCAAgC,EAAE;QACxF;YACE,MAAM,EAAE,sBAAsB;YAC9B,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,oCAAoC;SAC/C;QACD;YACE,MAAM,EAAE,sBAAsB;YAC9B,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,oCAAoC;SAC/C;QACD,EAAE,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,kCAAkC,EAAE;QAC3F;YACE,MAAM,EAAE,yBAAyB;YACjC,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,uCAAuC;SAClD;QACD;YACE,MAAM,EAAE,4BAA4B;YACpC,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,0CAA0C;SACrD;QACD;YACE,MAAM,EAAE,4BAA4B;YACpC,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,0CAA0C;SACrD;QACD;YACE,MAAM,EAAE,4BAA4B;YACpC,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,0CAA0C;SACrD;KACF;CACF,CAAC,CAAC"}

package/dist/migrations/20260503T182812_inventory_workflow.d.ts

@@ -0,0 +1,39 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Inventory module — multi-warehouse rewrite (feature 010).
+ *
+ * What this migration does, in order (data-model.md §10):
+ *   1. Create `warehouses` table; seed the `Default` warehouse with
+ *      deterministic UUID `00000000-0000-4000-8000-00000000d017`.
+ *   2. Add `warehouse_id` to `stock_levels`, backfill every existing
+ *      row to the Default UUID, swap the unique index to include
+ *      warehouse_id.
+ *   3. Create `warehouse_channel_assignments`; for every existing
+ *      sales channel insert a `(default_warehouse, channel, isDefault=true)`
+ *      seed row.
+ *   4. Extend `availability_notifications` with `email` + `status`
+ *      columns, relax `customer_account_id` to nullable, add the
+ *      "at least one recipient" CHECK constraint.
+ *   5. (moved) The stock-management columns on `products` and their
+ *      `products_fulfilment_strategy_check` constraint, and
+ *   6. (moved) the three threshold columns on `categories`, are `catalog`'s:
+ *      its entities map them, and since feature 134
+ *      (`specs/134-paid-module-extraction/research.md` D15) they are created
+ *      by `catalog`'s `Migration20260925T125527CatalogInventoryColumns`. This
+ *      migration keeps its class name and position, and lost only those
+ *      statements in `up()` and `down()` — with them, a database whose
+ *      `catalog` migration already ran failed when `inventory` was installed
+ *      later, and this module's hard uninstall dropped columns it does not own.
+ *   7. Create `inventory_thresholds`; insert the global row at
+ *      foundation defaults (high=100, medium=20, low=1).
+ *   8. Create `stock_allocations`.
+ *
+ * The deterministic seed UUID lets retried migrations stay
+ * idempotent and lets other modules' tests reference the Default
+ * warehouse by id.
+ */
+export declare class Migration20260503T182812InventoryWorkflow extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260503T182812_inventory_workflow.d.ts.map

package/dist/migrations/20260503T182812_inventory_workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260503T182812_inventory_workflow.d.ts","sourceRoot":"","sources":["../../src/migrations/20260503T182812_inventory_workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,yCAA0C,SAAQ,SAAS;IACvD,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IA2JnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAuBrC"}