@endora-commerce/mod-carts 0.100.0

package/dist/backend/services/cart-state-machine.js

@@ -0,0 +1,74 @@
+/**
+ * Returns the post-event approval state for a cart whose current
+ * approval state is `from`. Pre-flight checks (policy on, cart not
+ * empty, buyer-not-org-admin, etc.) live in the service layer; this
+ * function captures only the FSM legality of (state, event) pairs.
+ */
+export function nextApprovalState(from, event) {
+    if (from === 'rejected_by_org_admin') {
+        // Terminal on the approval axis. No event re-opens it; a new cart
+        // must be created.
+        return { ok: false, reason: 'already_terminal' };
+    }
+    switch (event) {
+        case 'submit':
+            if (from === 'not_required')
+                return { ok: true, next: 'pending' };
+            return { ok: false, reason: 'already_initiated' };
+        case 'approve':
+            if (from === 'pending')
+                return { ok: true, next: 'approved' };
+            return { ok: false, reason: 'not_pending' };
+        case 'reject':
+            if (from === 'pending')
+                return { ok: true, next: 'rejected_by_org_admin' };
+            return { ok: false, reason: 'not_pending' };
+        case 'buyer_mutation':
+            // Re-arm rule: any buyer-driven mutation on an `approved` cart
+            // silently drops it back to `pending`. Any other state is a no-op
+            // (the service short-circuits before calling).
+            if (from === 'approved')
+                return { ok: true, next: 'pending' };
+            return { ok: false, reason: 'not_applicable' };
+        case 'policy_off':
+            // Turning the org-wide policy off resets every pending/approved
+            // cart back to not_required. not_required carts stay put.
+            if (from === 'pending' || from === 'approved') {
+                return { ok: true, next: 'not_required' };
+            }
+            return { ok: false, reason: 'not_applicable' };
+        case 'policy_on':
+            // Turning the policy on does NOT auto-flip existing not_required
+            // carts to pending — the buyer must explicitly submit. The hook
+            // exists so audit-row builders can decide whether to record a
+            // pure policy-change event.
+            return { ok: false, reason: 'not_applicable' };
+    }
+}
+export function derivePrimaryCta(input) {
+    if (input.status === 'rejected' || input.status === 'completed') {
+        return 'blocked_by_organization';
+    }
+    if (input.approvalStatus === 'pending')
+        return 'awaiting_approval';
+    if (input.approvalStatus === 'rejected_by_org_admin') {
+        return 'blocked_by_organization';
+    }
+    // `not_required` and `approved` both → checkout. The
+    // `submit_for_approval` CTA is only emitted when the Org policy is on
+    // and the buyer has not yet submitted.
+    if (input.approvalStatus === 'not_required' && input.requiresApproval === true) {
+        return 'submit_for_approval';
+    }
+    return 'checkout';
+}
+/**
+ * `true` when an `approved` cart should be silently re-armed to
+ * `pending` because the buyer just mutated it. Lives here so the
+ * various write paths (add / update / remove / coupon apply / coupon
+ * clear) all agree on the same rule.
+ */
+export function shouldReArmOnBuyerMutation(approvalStatus) {
+    return approvalStatus === 'approved';
+}
+//# sourceMappingURL=cart-state-machine.js.map

package/dist/backend/services/cart-state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-state-machine.js","sourceRoot":"","sources":["../../../src/backend/services/cart-state-machine.ts"],"names":[],"mappings":"AAoCA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAwB,EACxB,KAAoB;IAEpB,IAAI,IAAI,KAAK,uBAAuB,EAAE,CAAC;QACrC,kEAAkE;QAClE,mBAAmB;QACnB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACnD,CAAC;IAED,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,QAAQ;YACX,IAAI,IAAI,KAAK,cAAc;gBAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAClE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAEpD,KAAK,SAAS;YACZ,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YAC9D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAE9C,KAAK,QAAQ;YACX,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;YAC3E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAE9C,KAAK,gBAAgB;YACnB,+DAA+D;YAC/D,kEAAkE;YAClE,+CAA+C;YAC/C,IAAI,IAAI,KAAK,UAAU;gBAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC9D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QAEjD,KAAK,YAAY;YACf,gEAAgE;YAChE,0DAA0D;YAC1D,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC9C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;YAC5C,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QAEjD,KAAK,WAAW;YACd,iEAAiE;YACjE,gEAAgE;YAChE,8DAA8D;YAC9D,4BAA4B;YAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACnD,CAAC;AACH,CAAC;AAaD,MAAM,UAAU,gBAAgB,CAAC,KAIhC;IACC,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAChE,OAAO,yBAAyB,CAAC;IACnC,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS;QAAE,OAAO,mBAAmB,CAAC;IACnE,IAAI,KAAK,CAAC,cAAc,KAAK,uBAAuB,EAAE,CAAC;QACrD,OAAO,yBAAyB,CAAC;IACnC,CAAC;IACD,qDAAqD;IACrD,sEAAsE;IACtE,uCAAuC;IACvC,IAAI,KAAK,CAAC,cAAc,KAAK,cAAc,IAAI,KAAK,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC/E,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,cAAkC;IAElC,OAAO,cAAc,KAAK,UAAU,CAAC;AACvC,CAAC"}

package/dist/backend/services/cart-upsell-service.d.ts

@@ -0,0 +1,57 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type CatalogProductReadPort, type ProductAudience } from '@endora-commerce/contracts';
+/**
+ * Cart up-sell aggregator (feature 027 §R9 / FR-039).
+ *
+ * Walks `product_links` (kind = `up_sell`) for every product currently in
+ * the cart, aggregates by target product, drops candidates that are
+ * already in the cart, and ranks by match-count (most-linked-from first),
+ * tie-breaking by older `created_at`.
+ *
+ * The catalog module's `ProductLink.kind = 'up_sell'` is the source the
+ * spec calls "Up-sell" (the same relation surfaced on PDP). The strip's
+ * placement is the cart UI; the relation type is the same.
+ */
+export interface CartUpsellCandidate {
+    productId: string;
+    productName: string;
+    productSlug: string;
+    productThumbnailUrl: string | null;
+    matchCount: number;
+}
+export declare class CartUpsellService {
+    private readonly emFactory;
+    /**
+     * `catalog`'s product read model (feature 075, Phase C). Both reads this
+     * replaced — the `up_sell` links and the target rows — were `em.find`
+     * against `catalog`'s tables, so a switched-off `catalog` still filled the
+     * cart's up-sell strip with products the platform had stopped serving.
+     */
+    private readonly catalogProducts;
+    constructor(emFactory: () => EntityManager, 
+    /**
+     * `catalog`'s product read model (feature 075, Phase C). Both reads this
+     * replaced — the `up_sell` links and the target rows — were `em.find`
+     * against `catalog`'s tables, so a switched-off `catalog` still filled the
+     * cart's up-sell strip with products the platform had stopped serving.
+     */
+    catalogProducts: CatalogProductReadPort);
+    forCart(cartId: string, limit: number, 
+    /**
+     * Who is looking at the strip (issue #227). Required: this method returns
+     * a product's name, slug and thumbnail for rows the buyer never asked for
+     * by id, which makes it a listing rather than a lookup, and a listing that
+     * defaulted its audience would silently show the wrong one.
+     */
+    audience: ProductAudience): Promise<CartUpsellCandidate[]>;
+    private thumbnailFor;
+    /**
+     * Picks the most useful locale from the multilingual `name` JSONB. The
+     * cart UI hands the buyer's session locale to the API; the resolver in
+     * front of this service is expected to use that. For now we fall
+     * through to the first available locale, matching the foundation's
+     * "best-effort" rendering pattern.
+     */
+    private localizedName;
+}
+//# sourceMappingURL=cart-upsell-service.d.ts.map

package/dist/backend/services/cart-upsell-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-upsell-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/cart-upsell-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEL,KAAK,sBAAsB,EAE3B,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAGpC;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAPf,SAAS,EAAE,MAAM,aAAa;IAC/C;;;;;OAKG;IACc,eAAe,EAAE,sBAAsB;IAGpD,OAAO,CACX,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM;IACb;;;;;OAKG;IACH,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA4DjC,OAAO,CAAC,YAAY;IAUpB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAOtB"}

package/dist/backend/services/cart-upsell-service.js

@@ -0,0 +1,100 @@
+import { isProductVisibleTo, } from '@endora-commerce/contracts';
+import { CartItem } from '../entities/cart-item.entity.js';
+export class CartUpsellService {
+    emFactory;
+    catalogProducts;
+    constructor(emFactory, 
+    /**
+     * `catalog`'s product read model (feature 075, Phase C). Both reads this
+     * replaced — the `up_sell` links and the target rows — were `em.find`
+     * against `catalog`'s tables, so a switched-off `catalog` still filled the
+     * cart's up-sell strip with products the platform had stopped serving.
+     */
+    catalogProducts) {
+        this.emFactory = emFactory;
+        this.catalogProducts = catalogProducts;
+    }
+    async forCart(cartId, limit, 
+    /**
+     * Who is looking at the strip (issue #227). Required: this method returns
+     * a product's name, slug and thumbnail for rows the buyer never asked for
+     * by id, which makes it a listing rather than a lookup, and a listing that
+     * defaulted its audience would silently show the wrong one.
+     */
+    audience) {
+        if (limit <= 0)
+            return [];
+        const em = this.emFactory();
+        const items = await em.find(CartItem, { cartId });
+        if (items.length === 0)
+            return [];
+        const sourceProductIds = Array.from(new Set(items.map((it) => it.productId)));
+        // One query: every up_sell link emanating from any of the source
+        // products. The target set is deduplicated in app code so we can
+        // attach match-counts cheaply.
+        const links = await this.catalogProducts.listLinksBySourceIds(sourceProductIds, 'up_sell');
+        if (links.length === 0)
+            return [];
+        const matchCountByTarget = new Map();
+        for (const link of links) {
+            // Exclude products already in the cart.
+            if (sourceProductIds.includes(link.targetProductId))
+                continue;
+            matchCountByTarget.set(link.targetProductId, (matchCountByTarget.get(link.targetProductId) ?? 0) + 1);
+        }
+        if (matchCountByTarget.size === 0)
+            return [];
+        const targetIds = Array.from(matchCountByTarget.keys());
+        // Issue #227 — an up-sell target is a product the buyer never named, so
+        // the strip is a listing. A link from a product they may see to one they
+        // may not does not make the second one theirs to see.
+        const products = (await this.catalogProducts.findByIds(targetIds)).filter((p) => isProductVisibleTo(p, audience));
+        const byId = new Map(products.map((p) => [p.id, p]));
+        const candidates = targetIds
+            .map((id) => byId.get(id))
+            .filter((p) => Boolean(p))
+            .map((p) => ({
+            productId: p.id,
+            productName: this.localizedName(p),
+            productSlug: p.slug,
+            productThumbnailUrl: this.thumbnailFor(p),
+            matchCount: matchCountByTarget.get(p.id) ?? 0,
+        }));
+        candidates.sort((a, b) => {
+            if (b.matchCount !== a.matchCount)
+                return b.matchCount - a.matchCount;
+            // Tie-break by older `created_at` (the existing product wins over
+            // a newly-added one). Sorted post-mapping for clarity.
+            const aProduct = byId.get(a.productId);
+            const bProduct = byId.get(b.productId);
+            const aTime = aProduct?.createdAt?.getTime() ?? 0;
+            const bTime = bProduct?.createdAt?.getTime() ?? 0;
+            return aTime - bTime;
+        });
+        return candidates.slice(0, limit);
+    }
+    thumbnailFor(product) {
+        // The product record carries the `attributeValues` JSONB blob that
+        // foundation code reads for `primaryAssetUrl`. We mirror that read
+        // path; if missing, the caller's UI hides the thumbnail.
+        const url = product.attributeValues?.['primaryAssetUrl'];
+        return typeof url === 'string' && url.length > 0 ? url : null;
+    }
+    /**
+     * Picks the most useful locale from the multilingual `name` JSONB. The
+     * cart UI hands the buyer's session locale to the API; the resolver in
+     * front of this service is expected to use that. For now we fall
+     * through to the first available locale, matching the foundation's
+     * "best-effort" rendering pattern.
+     */
+    localizedName(product) {
+        if (!product.name || typeof product.name !== 'object')
+            return product.id;
+        const en = product.name['en-US'] ?? product.name['en'];
+        if (typeof en === 'string' && en.length > 0)
+            return en;
+        const first = Object.values(product.name).find((v) => typeof v === 'string' && v.length > 0);
+        return first ?? product.id;
+    }
+}
+//# sourceMappingURL=cart-upsell-service.js.map

package/dist/backend/services/cart-upsell-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-upsell-service.js","sourceRoot":"","sources":["../../../src/backend/services/cart-upsell-service.ts"],"names":[],"mappings":"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"}

package/dist/backend/services/customer-group-resolver.d.ts

@@ -0,0 +1,27 @@
+import type { CustomerAccountReadPort, OrganizationDetailsPort } from '@endora-commerce/contracts';
+/**
+ * The effective customer group of a cart's owner (issue #177).
+ *
+ * The chain is the platform's one answer to "which group is this buyer in":
+ * the account's own group, else the Organization's, else none. The pricing
+ * engine spells it as `context.customerGroupId ?? organization.customerGroupId`
+ * and `pwa`'s push audience builder as `account.customerGroupId ?? orgGroup`;
+ * this is the same rule for the promotion engine, which had been receiving a
+ * hard-coded `null` on every cart path since the field was introduced.
+ *
+ * Both rows arrive over their owners' published ports, so a switched-off
+ * `customer_accounts` or `organizations` refuses here rather than answering
+ * "no group" — which reads as a legitimate answer and is not one: it silently
+ * withdraws every group-targeted discount from every buyer.
+ *
+ * An anonymous cart has neither an account nor an Organization and resolves to
+ * `null`, which is the correct answer rather than a degraded one.
+ */
+export declare function resolveCartCustomerGroupId(ports: {
+    customerAccounts: CustomerAccountReadPort;
+    organizations: OrganizationDetailsPort;
+}, owner: {
+    customerAccountId: string | null;
+    organizationId: string | null;
+}): Promise<string | null>;
+//# sourceMappingURL=customer-group-resolver.d.ts.map

package/dist/backend/services/customer-group-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer-group-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/customer-group-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAEnG;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE;IACL,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,aAAa,EAAE,uBAAuB,CAAC;CACxC,EACD,KAAK,EAAE;IAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACzE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB"}

package/dist/backend/services/customer-group-resolver.js

@@ -0,0 +1,32 @@
+/**
+ * The effective customer group of a cart's owner (issue #177).
+ *
+ * The chain is the platform's one answer to "which group is this buyer in":
+ * the account's own group, else the Organization's, else none. The pricing
+ * engine spells it as `context.customerGroupId ?? organization.customerGroupId`
+ * and `pwa`'s push audience builder as `account.customerGroupId ?? orgGroup`;
+ * this is the same rule for the promotion engine, which had been receiving a
+ * hard-coded `null` on every cart path since the field was introduced.
+ *
+ * Both rows arrive over their owners' published ports, so a switched-off
+ * `customer_accounts` or `organizations` refuses here rather than answering
+ * "no group" — which reads as a legitimate answer and is not one: it silently
+ * withdraws every group-targeted discount from every buyer.
+ *
+ * An anonymous cart has neither an account nor an Organization and resolves to
+ * `null`, which is the correct answer rather than a degraded one.
+ */
+export async function resolveCartCustomerGroupId(ports, owner) {
+    if (owner.customerAccountId) {
+        const account = await ports.customerAccounts.findById(owner.customerAccountId);
+        if (account?.customerGroupId)
+            return account.customerGroupId;
+    }
+    if (owner.organizationId) {
+        const organization = await ports.organizations.findById(owner.organizationId);
+        if (organization?.customerGroupId)
+            return organization.customerGroupId;
+    }
+    return null;
+}
+//# sourceMappingURL=customer-group-resolver.js.map

package/dist/backend/services/customer-group-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer-group-resolver.js","sourceRoot":"","sources":["../../../src/backend/services/customer-group-resolver.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAGC,EACD,KAA0E;IAE1E,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC/E,IAAI,OAAO,EAAE,eAAe;YAAE,OAAO,OAAO,CAAC,eAAe,CAAC;IAC/D,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC9E,IAAI,YAAY,EAAE,eAAe;YAAE,OAAO,YAAY,CAAC,eAAe,CAAC;IACzE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,221 @@
+import { type ModuleCliCommand } from '@endora-commerce/contracts';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+/**
+ * Carts module — feature 027 consolidation pass.
+ *
+ * Settings (`carts.abandonment.*`) declared here are seeded by the module-
+ * lifecycle ManifestReconciler on backend boot. No raw INSERT in the
+ * migration; the reconciler is the single seed path (matches the
+ * `inventory.*` and `organizations.*` patterns).
+ */
+export declare const CARTS_SETTING_CODES: {
+    readonly ABANDONMENT_INACTIVITY_MINUTES: "carts.abandonment.inactivity_minutes";
+    readonly ABANDONMENT_NOTIFICATION_RECIPIENT: "carts.abandonment.notification_recipient";
+};
+/**
+ * The manifest defaults, exported so a read that has to degrade degrades to
+ * *this* binding rather than to a literal invented at the call site (feature
+ * 072, D-43).
+ *
+ * The two used to diverge: the manifest said 10080 while both readers' `catch`
+ * answered `0`, and `CartAbandonmentWorker` treats `<= 0` as "sweep nothing".
+ * The divergence did not merely lose the configured value — it inverted the
+ * feature, and it would still have been off after the channel was fixed. A
+ * compiled-in fallback is a second source of truth consulted only when the
+ * first is unreachable, i.e. exactly when nobody is watching.
+ */
+export declare const DEFAULT_ABANDONMENT_INACTIVITY_MINUTES = 10080;
+export declare const DEFAULT_ABANDONMENT_NOTIFICATION_RECIPIENT = "";
+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" | "uuid" | "text" | "select" | "textarea" | "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 cartsManifest: {
+    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;
+    }[];
+};
+/**
+ * The operator command this module declares — feature 080, T042b / D-160.9.
+ *
+ * It was `scripts/abandonment-sweep.ts`, the tree's one call site of
+ * `requireModuleEnabled` and the worked example D-157 was written around. The
+ * host asks that question now, at the declaration seam, for every command; see
+ * `cli/abandonment-sweep.ts` for what the move changed and what it did not.
+ */
+export declare const cliCommands: ReadonlyArray<ModuleCliCommand<ModuleContext>>;
+//# 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":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE;;;;;;;GAOG;AAEH,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sCAAsC,QAAQ,CAAC;AAC5D,eAAO,MAAM,0CAA0C,KAAK,CAAC;AA2B7D,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+JnB,CAAC;AAEH,yDAAyD;AACzD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;CAAW,CAAC;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAOtE,CAAC"}