@endora-commerce/mod-shopping-lists 0.100.0

package/dist/manifest.d.ts

@@ -0,0 +1,191 @@
+export declare const shoppingListsSettingsManifest: {
+    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;
+    }[];
+};
+/**
+ * Shopping Lists module — manifest backfill (Module Lifecycle, feature 018).
+ *
+ * Predates the lifecycle system; this manifest is the static record
+ * required so the module participates in the registry. No install /
+ * uninstall hook today — the module's schema is owned by earlier
+ * platform-wide migrations.
+ */
+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: "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" | "Warehouse" | "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" | "text" | "textarea" | "select" | "radio" | "external" | "uuid" | "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;
+};
+//# 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":"AAEA,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;CAcxC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFnB,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,105 @@
+import { defineModuleManifest, defineModuleSettingsManifest } from '@endora-commerce/contracts';
+export const shoppingListsSettingsManifest = defineModuleSettingsManifest({
+    moduleCode: 'shopping_lists',
+    groups: [{ code: 'shopping_lists', name: 'Shopping lists' }],
+    settings: [
+        {
+            code: 'shopping_lists.enabled',
+            name: 'Shopping lists enabled',
+            description: 'Switches customer shopping lists on or off: creating and sharing lists, saving a cart line to one, and converting a list into a quote request. Nothing is dropped — every list, its items and its sharing state stay in the database.',
+            groupCode: 'shopping_lists',
+            valueType: 'boolean',
+            defaultValue: true,
+        },
+    ],
+});
+/**
+ * Shopping Lists module — manifest backfill (Module Lifecycle, feature 018).
+ *
+ * Predates the lifecycle system; this manifest is the static record
+ * required so the module participates in the registry. No install /
+ * uninstall hook today — the module's schema is owned by earlier
+ * platform-wide migrations.
+ */
+export const manifest = defineModuleManifest({
+    id: 'shopping_lists',
+    name: 'Shopping Lists',
+    description: 'Customer-owned saved shopping lists.',
+    version: '1.0.0',
+    // Feature 072 (T133) — the edges were always there; the conversion is what
+    // made them declarations.
+    //
+    // `carts` joins them in feature 075 Phase C. It was absent on the grounds
+    // that "the service handed back through `shoppingListServiceSink` points
+    // outward, and declaring the consumer would invert the direction" — true of
+    // the sink, and not of the other edge: `convertToCart` resolves `carts`'
+    // `cartWritePort` and calls it, which points inward. The check accepted it
+    // only through the transitive path `orders` -> `carts`, so the declaration
+    // was a property of a neighbour's manifest. No cycle: nothing in the tree
+    // depends on `shopping_lists`.
+    dependencies: [
+        'auth',
+        'carts',
+        'catalog',
+        'orders',
+        'organizations',
+        'quote_requests',
+        'settings',
+    ],
+    settings: shoppingListsSettingsManifest,
+    // Feature 073 (Constitution XVII) — the operator's activation control. It
+    // covered the quick-order surfaces too while this module hosted them; T139
+    // separated the two, so this now switches shopping lists and nothing else.
+    activation: { settingCode: 'shopping_lists.enabled', default: true },
+    /**
+     * This module's first i18n bundle — D-129's remaining sweep, MR 3.
+     *
+     * It ships two keys and nothing else, and it exists because a **declaring**
+     * module that contributes no bundle file is `check:error-translations` exit
+     * 2 for the whole tree rather than a finding
+     * (`specs/090-module-owned-error-codes/contracts/error-translation-population.md`
+     * §2.1, §2.3; `d129-sweep.md` §3.4). The bundle lives at the **package
+     * root**, not under `dist`: `manifest-locations.ts` resolves a packaged
+     * module's `manifestPath` to its `package.json`, so `dirname` is the package
+     * directory. The files are a **flat** `{"a.b.c": "text"}` map, because a
+     * nested object fails `TranslationBundleEntriesSchema` and the boot
+     * reconciler logs and skips it — silently.
+     */
+    i18n: { bundlesDir: 'i18n' },
+    docs: { dir: 'docs' },
+    /**
+     * The `SHOPPING_LIST_*` codes — D-129's remaining sweep, Tier A
+     * (`specs/090-module-owned-error-codes/d129-sweep.md` §5.2, Appendix A;
+     * MR 3).
+     *
+     * Both were declared by `_i18n` until this merge request, not because
+     * anybody judged them the platform's but because the deleted prefix chain
+     * had no rule for them and its last line was `return 'core'`. **D-121 T1
+     * puts them here**: the noun in both is a shopping list, which is this
+     * module's own entity, and both refusals are invariants of it — the default
+     * list is the customer's permanent anchor and cannot be deleted, and an
+     * account always keeps at least one list. This module is also the only one
+     * that raises them, from `services/shopping-list-service.ts`.
+     *
+     * **Unlike the rest of Tier A, these two arrive with a sentence.** They had
+     * none in either language anywhere in the tree and were on
+     * `UNTRANSLATED_ERROR_CODES` under `_i18n`; §5.4's default for a receiver
+     * with nothing to put in its new bundle is an empty `{}` plus a ledger entry
+     * under the receiver's group, and it says in terms that writing the prose
+     * instead is always available and is not a re-opening of D-186 §2 — that
+     * ruling refuses *carrying* a placeholder, not *writing* a sentence. Two
+     * codes is four strings, both refusals are read by a **buyer** on the
+     * storefront rather than by an operator, and each sentence written deletes a
+     * ledger entry instead of adding one. So they are written, and this module's
+     * bundle is not an empty one.
+     *
+     * **`tokens` is derived from the raise sites, not from the bundle**
+     * (runbook §5), and there are none: both raises are a bare
+     * `HttpError(409, code, message)` with no `details`.
+     */
+    errorCodes: [
+        { code: 'SHOPPING_LIST_CANNOT_DELETE_DEFAULT' },
+        { code: 'SHOPPING_LIST_CANNOT_DELETE_LAST' },
+    ],
+});
+//# 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,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAEhG,MAAM,CAAC,MAAM,6BAA6B,GAAG,4BAA4B,CAAC;IACxE,UAAU,EAAE,gBAAgB;IAC5B,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IAC5D,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,wBAAwB;YAC9B,IAAI,EAAE,wBAAwB;YAC9B,WAAW,EACT,uOAAuO;YACzO,SAAS,EAAE,gBAAgB;YAC3B,SAAS,EAAE,SAAS;YACpB,YAAY,EAAE,IAAI;SACnB;KACF;CACF,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,oBAAoB,CAAC;IAC3C,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,sCAAsC;IACxC,OAAO,EAAE,OAAO;IAChB,2EAA2E;IAC3E,0BAA0B;IAC1B,EAAE;IACF,0EAA0E;IAC1E,yEAAyE;IACzE,4EAA4E;IAC5E,yEAAyE;IACzE,2EAA2E;IAC3E,2EAA2E;IAC3E,0EAA0E;IAC1E,+BAA+B;IAC/B,YAAY,EAAE;QACZ,MAAM;QACN,OAAO;QACP,SAAS;QACT,QAAQ;QACR,eAAe;QACf,gBAAgB;QAChB,UAAU;KACX;IACD,QAAQ,EAAE,6BAA6B;IACvC,0EAA0E;IAC1E,2EAA2E;IAC3E,2EAA2E;IAC3E,UAAU,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,OAAO,EAAE,IAAI,EAAE;IACpE;;;;;;;;;;;;;OAaG;IACH,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;IAC5B,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;IACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,qCAAqC,EAAE;QAC/C,EAAE,IAAI,EAAE,kCAAkC,EAAE;KAC7C;CACF,CAAC,CAAC"}

package/dist/migrations/20260426T135443_shopping_lists_init.d.ts

@@ -0,0 +1,18 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * shopping_lists module — Phase 5 (T200).
+ *
+ * Schema:
+ *   - shopping_lists: scoped by (organization_id, customer_account_id) for
+ *     owner queries. No FK constraint on customer_account_id /
+ *     organization_id since those tables already exist; we keep the same
+ *     "plain uuid columns" pattern the rest of the codebase uses.
+ *   - shopping_list_items: cascade delete on the parent list, plain uuid
+ *     FK to products so product archival doesn't drop list rows (the
+ *     conversion service surfaces archived rows in a skip report).
+ */
+export declare class Migration20260426T135443ShoppingListsInit extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260426T135443_shopping_lists_init.d.ts.map

package/dist/migrations/20260426T135443_shopping_lists_init.d.ts.map

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

package/dist/migrations/20260426T135443_shopping_lists_init.js

@@ -0,0 +1,52 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * shopping_lists module — Phase 5 (T200).
+ *
+ * Schema:
+ *   - shopping_lists: scoped by (organization_id, customer_account_id) for
+ *     owner queries. No FK constraint on customer_account_id /
+ *     organization_id since those tables already exist; we keep the same
+ *     "plain uuid columns" pattern the rest of the codebase uses.
+ *   - shopping_list_items: cascade delete on the parent list, plain uuid
+ *     FK to products so product archival doesn't drop list rows (the
+ *     conversion service surfaces archived rows in a skip report).
+ */
+export class Migration20260426T135443ShoppingListsInit extends Migration {
+    async up() {
+        this.addSql(`
+      create table "shopping_lists" (
+        "id" uuid not null,
+        "organization_id" uuid not null,
+        "customer_account_id" uuid not null,
+        "name" varchar(160) not null,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        constraint "shopping_lists_pkey" primary key ("id")
+      );
+    `);
+        this.addSql('create index "shopping_lists_organization_id_index" on "shopping_lists" ("organization_id");');
+        this.addSql('create index "shopping_lists_customer_account_id_index" on "shopping_lists" ("customer_account_id");');
+        this.addSql(`
+      create table "shopping_list_items" (
+        "id" uuid not null,
+        "shopping_list_id" uuid not null,
+        "product_id" uuid not null,
+        "variant_id" uuid null,
+        "quantity" int not null,
+        "note" text null,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        constraint "shopping_list_items_pkey" primary key ("id")
+      );
+    `);
+        this.addSql('create index "shopping_list_items_shopping_list_id_index" on "shopping_list_items" ("shopping_list_id");');
+        this.addSql('create index "shopping_list_items_product_id_index" on "shopping_list_items" ("product_id");');
+        this.addSql(`alter table "shopping_list_items" add constraint "shopping_list_items_list_fk"
+        foreign key ("shopping_list_id") references "shopping_lists" ("id") on delete cascade;`);
+    }
+    async down() {
+        this.addSql('drop table if exists "shopping_list_items" cascade;');
+        this.addSql('drop table if exists "shopping_lists" cascade;');
+    }
+}
+//# sourceMappingURL=20260426T135443_shopping_lists_init.js.map

package/dist/migrations/20260426T135443_shopping_lists_init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260426T135443_shopping_lists_init.js","sourceRoot":"","sources":["../../src/migrations/20260426T135443_shopping_lists_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,yCAA0C,SAAQ,SAAS;IAC7D,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;KAUX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CACT,8FAA8F,CAC/F,CAAC;QACF,IAAI,CAAC,MAAM,CACT,sGAAsG,CACvG,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;KAYX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CACT,0GAA0G,CAC3G,CAAC;QACF,IAAI,CAAC,MAAM,CACT,8FAA8F,CAC/F,CAAC;QACF,IAAI,CAAC,MAAM,CACT;+FACyF,CAC1F,CAAC;IACJ,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,qDAAqD,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,CAAC,gDAAgD,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/migrations/20260611T140418_shopping_lists_default.d.ts

@@ -0,0 +1,16 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Default shopping list.
+ *
+ * Adds `shopping_lists.is_default`: at most one list per (organization,
+ * customer) is the customer's default — the target of the storefront
+ * "add to shopping list" affordances. Existing customers with at least one
+ * list have their earliest-created list promoted to default by the backfill;
+ * customers with no list get a "Default" list lazily on first access
+ * (ShoppingListService.ensureDefault).
+ */
+export declare class Migration20260611T140418ShoppingListsDefault extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260611T140418_shopping_lists_default.d.ts.map

package/dist/migrations/20260611T140418_shopping_lists_default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260611T140418_shopping_lists_default.d.ts","sourceRoot":"","sources":["../../src/migrations/20260611T140418_shopping_lists_default.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;GASG;AACH,qBAAa,4CAA6C,SAAQ,SAAS;IAC1D,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}

package/dist/migrations/20260611T140418_shopping_lists_default.js

@@ -0,0 +1,31 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Default shopping list.
+ *
+ * Adds `shopping_lists.is_default`: at most one list per (organization,
+ * customer) is the customer's default — the target of the storefront
+ * "add to shopping list" affordances. Existing customers with at least one
+ * list have their earliest-created list promoted to default by the backfill;
+ * customers with no list get a "Default" list lazily on first access
+ * (ShoppingListService.ensureDefault).
+ */
+export class Migration20260611T140418ShoppingListsDefault extends Migration {
+    async up() {
+        this.addSql(`alter table "shopping_lists" add column "is_default" boolean not null default false;`);
+        // Promote the earliest-created list per (organization, customer) to default.
+        this.addSql(`
+      update "shopping_lists" s set "is_default" = true
+      where s."id" = (
+        select s2."id" from "shopping_lists" s2
+        where s2."organization_id" = s."organization_id"
+          and s2."customer_account_id" = s."customer_account_id"
+        order by s2."created_at" asc, s2."id" asc
+        limit 1
+      );
+    `);
+    }
+    async down() {
+        this.addSql(`alter table "shopping_lists" drop column "is_default";`);
+    }
+}
+//# sourceMappingURL=20260611T140418_shopping_lists_default.js.map

package/dist/migrations/20260611T140418_shopping_lists_default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260611T140418_shopping_lists_default.js","sourceRoot":"","sources":["../../src/migrations/20260611T140418_shopping_lists_default.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,OAAO,4CAA6C,SAAQ,SAAS;IAChE,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CACT,sFAAsF,CACvF,CAAC;QACF,6EAA6E;QAC7E,IAAI,CAAC,MAAM,CAAC;;;;;;;;;KASX,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,wDAAwD,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which is the order of this module's own
+ * migrations and of nothing else (feature 081): a manifest `dependencies` array
+ * is the only thing ordering this block against another module's.
+ *
+ * The **named** exports stay beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports each class by name
+ * from this specifier, and a migration class name is contract in a way an entity
+ * class name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created.
+ */
+import { Migration20260426T135443ShoppingListsInit } from './20260426T135443_shopping_lists_init.js';
+import { Migration20260611T140418ShoppingListsDefault } from './20260611T140418_shopping_lists_default.js';
+export declare const migrations: (typeof Migration20260426T135443ShoppingListsInit)[];
+export { Migration20260426T135443ShoppingListsInit, Migration20260611T140418ShoppingListsDefault, };
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,yCAAyC,EAAE,MAAM,0CAA0C,CAAC;AACrG,OAAO,EAAE,4CAA4C,EAAE,MAAM,6CAA6C,CAAC;AAE3G,eAAO,MAAM,UAAU,sDAGtB,CAAC;AAEF,OAAO,EACL,yCAAyC,EACzC,4CAA4C,GAC7C,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,31 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which is the order of this module's own
+ * migrations and of nothing else (feature 081): a manifest `dependencies` array
+ * is the only thing ordering this block against another module's.
+ *
+ * The **named** exports stay beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports each class by name
+ * from this specifier, and a migration class name is contract in a way an entity
+ * class name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created.
+ */
+import { Migration20260426T135443ShoppingListsInit } from './20260426T135443_shopping_lists_init.js';
+import { Migration20260611T140418ShoppingListsDefault } from './20260611T140418_shopping_lists_default.js';
+export const migrations = [
+    Migration20260426T135443ShoppingListsInit,
+    Migration20260611T140418ShoppingListsDefault,
+];
+export { Migration20260426T135443ShoppingListsInit, Migration20260611T140418ShoppingListsDefault, };
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,yCAAyC,EAAE,MAAM,0CAA0C,CAAC;AACrG,OAAO,EAAE,4CAA4C,EAAE,MAAM,6CAA6C,CAAC;AAE3G,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,yCAAyC;IACzC,4CAA4C;CAC7C,CAAC;AAEF,OAAO,EACL,yCAAyC,EACzC,4CAA4C,GAC7C,CAAC"}

package/docs/shopping_lists.md

@@ -0,0 +1,70 @@
+---
+title: shopping_lists
+description: Per-customer named bundles convertible to Cart or RFQ
+---
+
+# `shopping_lists`
+
+Per-customer named bundles of (product, variant?, quantity, note?) rows.
+Buyers save recurring orders, then convert all or a selected subset of
+items into a Cart or a draft Quote Request in a single click. Conversions
+skip archived products and report them rather than failing the whole batch.
+
+## Public surface
+
+All endpoints require an authenticated customer session and are scoped to
+the `(customer, organization)` pair on the session.
+
+| Verb + Path | Purpose |
+| --- | --- |
+| `GET /api/v1/shopping-lists` | List the buyer's lists with their items |
+| `POST /api/v1/shopping-lists` | Create a new list |
+| `GET /api/v1/shopping-lists/:id` | One list with its items |
+| `PATCH /api/v1/shopping-lists/:id` | Rename |
+| `DELETE /api/v1/shopping-lists/:id` | Delete (cascades to items) |
+| `POST /api/v1/shopping-lists/:id/items` | Add an item |
+| `PATCH /api/v1/shopping-lists/:id/items/:itemId` | Update quantity / note |
+| `DELETE /api/v1/shopping-lists/:id/items/:itemId` | Remove |
+| `POST /api/v1/shopping-lists/:id/convert-to-cart` | Add items to the active cart; archived rows are skipped + reported |
+| `POST /api/v1/shopping-lists/:id/convert-to-rfq` | Add items to the draft RFQ; returns the `rfqId` for deep-linking |
+
+The two converters accept an optional `itemIds: string[]` body. Empty or
+missing array means "convert every item on the list".
+
+## Conversion semantics
+
+`ShoppingListService` partitions the requested items by their referencing
+product's status:
+
+- `active` products go into the cart / RFQ via the existing
+  `CartService.addItem` / `RfqService.addItem` so cart aggregation and
+  RFQ draft version bumps stay in one place.
+- `archived` products (or rows whose product no longer exists) are
+  reported in `skipped[]` with one of:
+  - `product_archived`
+  - `product_not_found`
+  - `variant_unavailable`
+
+The HTTP response is always `200 OK` with `{ added, skipped }` so the UI
+can show a friendly message rather than treating the partial result as
+an error.
+
+## Entities
+
+`ShoppingList` — `(organizationId, customerAccountId, name)`.
+
+`ShoppingListItem` — cascade-deletes with its parent list. The FK to
+`products` is intentionally a plain uuid column without a CASCADE so a
+product archive doesn't drop historical rows; the conversion service
+surfaces them in the skip report instead.
+
+## Extension points
+
+- **Sharing within an organization** — the entity has no `isShared`
+  column today; adding org-wide sharing means a column flip plus a
+  one-line tweak to `#owned()` in `shopping-list-service.ts`.
+- **Per-list deadlines** — extend `ShoppingList` with `expiresAt` for
+  procurement workflows that auto-archive stale lists.
+- **Convert-to-quote-only-mode** — the converter already returns an RFQ
+  id; the storefront can deep-link the buyer into the draft to add a
+  requester note before submission.

package/i18n/en.json

@@ -0,0 +1,4 @@
+{
+  "errors.SHOPPING_LIST_CANNOT_DELETE_DEFAULT": "Your default shopping list is the one new items are saved to, so it cannot be deleted. Empty it if you no longer need what is on it, or make another list the default first — then this one can go.",
+  "errors.SHOPPING_LIST_CANNOT_DELETE_LAST": "This is your only shopping list, and an account always keeps at least one. Create another list first, and then this one can be deleted."
+}

package/i18n/pl.json

@@ -0,0 +1,4 @@
+{
+  "errors.SHOPPING_LIST_CANNOT_DELETE_DEFAULT": "Domyślna lista zakupowa to ta, na której zapisują się nowe produkty, dlatego nie można jej usunąć. Opróżnij ją, jeśli nie potrzebujesz już jej zawartości, albo najpierw ustaw jako domyślną inną listę — wtedy tę będzie można usunąć.",
+  "errors.SHOPPING_LIST_CANNOT_DELETE_LAST": "To Twoja jedyna lista zakupowa, a na koncie zawsze musi pozostać co najmniej jedna. Najpierw utwórz kolejną listę, a potem tę będzie można usunąć."
+}