@endora-commerce/mod-carts 0.100.0

package/dist/backend/services/cart-read-port.js

@@ -0,0 +1,144 @@
+import { Cart } from '../entities/cart.entity.js';
+import { CartItem } from '../entities/cart-item.entity.js';
+/**
+ * The row-level read model `carts` publishes, and the seed operation that goes
+ * with it (feature 075, Phase P).
+ *
+ * Six inbound sites are the same pair of queries — the customer's active cart,
+ * then its items — written out in `orders`' checkout, `orders`' reorder and
+ * `quote_requests`' quote-to-cart conversion. Two of those three then
+ * `em.create(Cart, …)` when the lookup misses and hand-build `CartItem` rows,
+ * which is two modules writing this module's two tables.
+ *
+ * `replaceItemsForCustomer` is what they call instead. The clear-then-seed
+ * rule it implements is the single-active-cart model admin order-create,
+ * reorder and RFQ conversion all already assume; it was spelled out twice, in
+ * two modules, and `lastActivityAt` was maintained in neither.
+ */
+export class CartReadService {
+    emFactory;
+    constructor(emFactory) {
+        this.emFactory = emFactory;
+    }
+    async findActiveForCustomer(ctx) {
+        const em = this.emFactory();
+        const cart = await em.findOne(Cart, {
+            customerAccountId: ctx.customerAccountId,
+            // The organisation is always present for a signed-in customer since
+            // D-178, so the empty arm is unreachable rather than a supported mode.
+            // It stays because the context type still admits a null.
+            ...(ctx.organizationId === null ? {} : { organizationId: ctx.organizationId }),
+            status: 'active',
+        });
+        if (!cart)
+            return null;
+        return { cart: toCartRecord(cart), items: await this.#items(em, cart.id) };
+    }
+    async findById(cartId) {
+        const em = this.emFactory();
+        const cart = await em.findOne(Cart, { id: cartId });
+        if (!cart)
+            return null;
+        return { cart: toCartRecord(cart), items: await this.#items(em, cart.id) };
+    }
+    async #items(em, cartId) {
+        const items = await em.find(CartItem, { cartId }, { orderBy: { createdAt: 'asc', id: 'asc' } });
+        return items.map(toCartItemRecord);
+    }
+}
+/**
+ * The write port, adapting `CartService` and adding the seed operation.
+ *
+ * The service arrives as a getter so the adapter resolves it from the
+ * container per call rather than capturing it — it is this module's own gated
+ * port, and a singleton may not hold a gate.
+ */
+export function createCartWritePort(emFactory, getService) {
+    const read = new CartReadService(emFactory);
+    return {
+        async getOrCreateForCustomer(ctx) {
+            return toCartRecord(await getService().getOrCreateForCustomer(ctx));
+        },
+        async addItem(actor, input) {
+            const result = await getService().addItem(actor, input);
+            return { cart: toCartRecord(result.cart), items: result.items.map(toCartItemRecord) };
+        },
+        clearForCustomer: (ctx) => getService().clearForCustomer(ctx),
+        async replaceItemsForCustomer(ctx, lines) {
+            // command-coverage-ignore: seeds the customer's own active cart from an
+            // already-audited source (a reorder, an accepted quote). The cart is not
+            // an auditable domain object — the order or quote that produced these
+            // lines is, and its own Command has already recorded the decision.
+            const em = emFactory();
+            const cart = await getService().getOrCreateForCustomer(ctx);
+            const existing = await em.find(CartItem, { cartId: cart.id });
+            if (existing.length > 0)
+                em.remove(existing);
+            for (const line of lines) {
+                em.create(CartItem, {
+                    cartId: cart.id,
+                    productId: line.productId,
+                    ...(line.variantId ? { variantId: line.variantId } : {}),
+                    quantity: line.quantity,
+                    unitPrice: line.unitPrice,
+                    currency: line.currency,
+                });
+            }
+            cart.lastActivityAt = new Date();
+            await em.flush();
+            const seeded = await read.findById(cart.id);
+            // The cart was created or loaded one statement ago in this same
+            // `EntityManager`, so a miss here is not a race — it is impossible, and
+            // an empty answer would be worse than a throw because the caller is
+            // about to place an order from it.
+            if (!seeded) {
+                throw new Error(`[carts] cart ${cart.id} vanished between seeding and reading it back.`);
+            }
+            return seeded;
+        },
+    };
+}
+export function toCartRecord(cart) {
+    return {
+        id: cart.id,
+        customerAccountId: cart.customerAccountId ?? null,
+        organizationId: cart.organizationId ?? null,
+        anonymousCartToken: cart.anonymousCartToken ?? null,
+        salesChannelId: cart.salesChannelId ?? null,
+        status: cart.status,
+        approvalStatus: cart.approvalStatus,
+        submittedForApprovalAt: cart.submittedForApprovalAt ?? null,
+        approvedAt: cart.approvedAt ?? null,
+        approvedByCustomerAccountId: cart.approvedByCustomerAccountId ?? null,
+        rejectedAt: cart.rejectedAt ?? null,
+        rejectedByActor: cart.rejectedByActor ?? null,
+        rejectedReason: cart.rejectedReason ?? null,
+        appliedPromotionCode: cart.appliedPromotionCode ?? null,
+        convertedToQuoteRequestId: cart.convertedToQuoteRequestId ?? null,
+        abandonmentNotifiedAt: cart.abandonmentNotifiedAt ?? null,
+        lastActivityAt: cart.lastActivityAt,
+        version: cart.version,
+        createdAt: cart.createdAt,
+        updatedAt: cart.updatedAt,
+    };
+}
+export function toCartItemRecord(item) {
+    return {
+        id: item.id,
+        cartId: item.cartId,
+        productId: item.productId,
+        variantId: item.variantId ?? null,
+        quantity: item.quantity,
+        unitPrice: item.unitPrice,
+        currency: item.currency,
+        recomputedUnitPrice: item.recomputedUnitPrice ?? null,
+        recomputedAt: item.recomputedAt ?? null,
+        recomputedCurrency: item.recomputedCurrency ?? null,
+        packagingUnitId: item.packagingUnitId ?? null,
+        packagingUnitName: item.packagingUnitName ?? null,
+        packagingUnitBaseQuantity: item.packagingUnitBaseQuantity ?? null,
+        createdAt: item.createdAt,
+        updatedAt: item.updatedAt,
+    };
+}
+//# sourceMappingURL=cart-read-port.js.map

package/dist/backend/services/cart-read-port.js.map

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

package/dist/backend/services/cart-recompute-cache.d.ts

@@ -0,0 +1,49 @@
+import type { Redis } from 'ioredis';
+/**
+ * Redis-backed per-cart pricing-recompute cache (feature 027 §R5).
+ *
+ * Stores the most recently re-resolved line prices keyed by `cartId` so
+ * the mini-cart → full-cart → checkout-entry walk does not re-run the
+ * `PricingService.resolveLinePrice` resolver three times within seconds.
+ *
+ * Cache TTL is short (30 s by default) so a price-list edit propagates to
+ * the buyer's next page-open with predictable latency. Every cart-side
+ * write must call `invalidate(cartId)` so the next read sees fresh
+ * resolver output.
+ *
+ * The cache is **optional** — when Redis is unavailable the cache may be
+ * disabled (set `enabled: false` in the options) and the recompute helper
+ * still works (just resolves on every read).
+ */
+export declare const CART_RECOMPUTE_CACHE_KEY_PREFIX = "b2b:cart:recompute:";
+export declare const CART_RECOMPUTE_CACHE_DEFAULT_TTL_SECONDS = 30;
+export interface CartRecomputeCacheOptions {
+    ttlSeconds?: number;
+    enabled?: boolean;
+}
+export interface CachedCartLinePrice {
+    cartItemId: string;
+    /** `amount: null` = resolver failed; the caller should fall back to the snapshot. */
+    unitPrice: {
+        amount: number | null;
+        currency: string;
+    };
+    resolvedAt: string;
+}
+export interface CachedCartRecompute {
+    cartId: string;
+    lines: CachedCartLinePrice[];
+    /** Wall-clock when the resolver was last asked. ISO-8601. */
+    resolvedAt: string;
+}
+export declare class CartRecomputeCache {
+    private readonly redis;
+    private readonly ttlSeconds;
+    private readonly enabled;
+    constructor(redis: Redis, options?: CartRecomputeCacheOptions);
+    static keyFor(cartId: string): string;
+    get(cartId: string): Promise<CachedCartRecompute | null>;
+    put(cartId: string, payload: CachedCartRecompute): Promise<void>;
+    invalidate(cartId: string): Promise<void>;
+}
+//# sourceMappingURL=cart-recompute-cache.d.ts.map

package/dist/backend/services/cart-recompute-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-recompute-cache.d.ts","sourceRoot":"","sources":["../../../src/backend/services/cart-recompute-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,+BAA+B,wBAAwB,CAAC;AACrE,eAAO,MAAM,wCAAwC,KAAK,CAAC;AAE3D,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,kBAAkB;IAIjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEL,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,yBAA8B;IAKlF,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI/B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAYxD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIhD"}

package/dist/backend/services/cart-recompute-cache.js

@@ -0,0 +1,56 @@
+/**
+ * Redis-backed per-cart pricing-recompute cache (feature 027 §R5).
+ *
+ * Stores the most recently re-resolved line prices keyed by `cartId` so
+ * the mini-cart → full-cart → checkout-entry walk does not re-run the
+ * `PricingService.resolveLinePrice` resolver three times within seconds.
+ *
+ * Cache TTL is short (30 s by default) so a price-list edit propagates to
+ * the buyer's next page-open with predictable latency. Every cart-side
+ * write must call `invalidate(cartId)` so the next read sees fresh
+ * resolver output.
+ *
+ * The cache is **optional** — when Redis is unavailable the cache may be
+ * disabled (set `enabled: false` in the options) and the recompute helper
+ * still works (just resolves on every read).
+ */
+export const CART_RECOMPUTE_CACHE_KEY_PREFIX = 'b2b:cart:recompute:';
+export const CART_RECOMPUTE_CACHE_DEFAULT_TTL_SECONDS = 30;
+export class CartRecomputeCache {
+    redis;
+    ttlSeconds;
+    enabled;
+    constructor(redis, options = {}) {
+        this.redis = redis;
+        this.ttlSeconds = options.ttlSeconds ?? CART_RECOMPUTE_CACHE_DEFAULT_TTL_SECONDS;
+        this.enabled = (options.enabled ?? true) && this.ttlSeconds > 0;
+    }
+    static keyFor(cartId) {
+        return `${CART_RECOMPUTE_CACHE_KEY_PREFIX}${cartId}`;
+    }
+    async get(cartId) {
+        if (!this.enabled)
+            return null;
+        const raw = await this.redis.get(CartRecomputeCache.keyFor(cartId));
+        if (raw === null)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            await this.redis.del(CartRecomputeCache.keyFor(cartId));
+            return null;
+        }
+    }
+    async put(cartId, payload) {
+        if (!this.enabled)
+            return;
+        await this.redis.set(CartRecomputeCache.keyFor(cartId), JSON.stringify(payload), 'EX', this.ttlSeconds);
+    }
+    async invalidate(cartId) {
+        if (!this.enabled)
+            return;
+        await this.redis.del(CartRecomputeCache.keyFor(cartId));
+    }
+}
+//# sourceMappingURL=cart-recompute-cache.js.map

package/dist/backend/services/cart-recompute-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-recompute-cache.js","sourceRoot":"","sources":["../../../src/backend/services/cart-recompute-cache.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,qBAAqB,CAAC;AACrE,MAAM,CAAC,MAAM,wCAAwC,GAAG,EAAE,CAAC;AAqB3D,MAAM,OAAO,kBAAkB;IAIA;IAHZ,UAAU,CAAS;IACnB,OAAO,CAAU;IAElC,YAA6B,KAAY,EAAE,UAAqC,EAAE;QAArD,UAAK,GAAL,KAAK,CAAO;QACvC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,wCAAwC,CAAC;QACjF,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,MAAc;QAC1B,OAAO,GAAG,+BAA+B,GAAG,MAAM,EAAE,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACpE,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,OAA4B;QACpD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAClB,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EACjC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EACvB,IAAI,EACJ,IAAI,CAAC,UAAU,CAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF"}

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

@@ -0,0 +1,165 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type CartMergeOutcome } from '@endora-commerce/contracts';
+import { Cart } from '../entities/cart.entity.js';
+import { CartItem } from '../entities/cart-item.entity.js';
+import type { CatalogProductReadPort, LinePricePort, OrganizationDetailsPort } from '@endora-commerce/contracts';
+import type { SalesChannelMembershipPort } from '@endora-commerce/platform/kernel';
+import type { CartApprovalService } from './cart-approval-service.js';
+import type { CartAuditService } from './cart-audit-service.js';
+import type { CartRecomputeCache } from './cart-recompute-cache.js';
+/**
+ * CartService (T125).
+ *
+ * Two cart shapes:
+ *   - Anonymous: identified by a caller-held cookie token. No customer or
+ *     organization attached.
+ *   - Authenticated: the customer's single active cart.
+ *
+ * At login, the existing anonymous cart (if any) is merged into the
+ * authenticated cart — duplicate lines have their quantities summed.
+ */
+export interface AnonymousContext {
+    anonymousCartToken: string;
+}
+export interface CustomerContext {
+    customerAccountId: string;
+    /**
+     * Feature 026 US2 — null for guest-style Customer accounts that have no
+     * Organization. Carts already persist `organization_id` nullable, so the
+     * service handles either case (no-org carts fall back to platform-default
+     * prices via PricingService).
+     */
+    organizationId: string | null;
+}
+/**
+ * Cart-line hard cap (feature 027 FR-001 / spec edge case "Cart contents
+ * cap"). The 201st distinct line is refused with HTTP 422.
+ */
+export declare const CART_MAX_LINES = 200;
+export declare class CartService {
+    #private;
+    private readonly emFactory;
+    /** `price_lists`' line-resolution slice (feature 075, Phase C). */
+    private readonly pricingService;
+    /** `catalog`'s product read model — products, variants, packaging units. */
+    private readonly catalogProducts;
+    /** `organizations`' read model — the buying org the price resolves against. */
+    private readonly organizations;
+    /**
+     * The sanctioned bridge accessor (Constitution XII), for the assortment
+     * gate `addItem` owes (issue #259). Required, like `catalogProducts`: an
+     * optional one would make "this rig did not wire it" and "this channel
+     * publishes the product" the same answer, which is the fail-open shape the
+     * whole issue is about.
+     */
+    private readonly channelMembership;
+    private readonly approvalService?;
+    private readonly auditService?;
+    private readonly recomputeCache?;
+    /**
+     * `pricingService` is **required** since issue #124. It used to be optional
+     * "for test rigs", and the cart then read the legacy
+     * `attributeValues['defaultPrice']` whenever it was missing — so a rig, a
+     * wiring slip and `price_lists` switched off all produced the same thing: a
+     * cart line priced from a catalogue attribute that no price list supports.
+     * Absence is now a `lazyPort` gate that throws `MODULE_DISABLED` at the call,
+     * which nothing downstream can mistake for a price.
+     *
+     * Cart entities don't currently track which sales channel they were
+     * created on (multi-channel cart attribution is a separate
+     * follow-up), so the resolver runs against the system-default
+     * channel — matching the behaviour the foundation cart already had.
+     * Lists with a `salesChannel` criterion targeting other channels
+     * therefore won't apply on the cart line until cart-side channel
+     * tracking lands.
+     */
+    /**
+     * `approvalService` and `auditService` are optional — when wired
+     * (production composition), any buyer-driven mutation on an
+     * `approved` cart re-arms approval to `pending` and a typed audit
+     * row is landed (line_added / line_qty_changed / line_removed).
+     * Foundation tests and legacy test rigs that don't wire either still
+     * construct the service without them; both hooks no-op when absent.
+     */
+    constructor(emFactory: () => EntityManager, 
+    /** `price_lists`' line-resolution slice (feature 075, Phase C). */
+    pricingService: LinePricePort, 
+    /** `catalog`'s product read model — products, variants, packaging units. */
+    catalogProducts: CatalogProductReadPort, 
+    /** `organizations`' read model — the buying org the price resolves against. */
+    organizations: OrganizationDetailsPort, 
+    /**
+     * The sanctioned bridge accessor (Constitution XII), for the assortment
+     * gate `addItem` owes (issue #259). Required, like `catalogProducts`: an
+     * optional one would make "this rig did not wire it" and "this channel
+     * publishes the product" the same answer, which is the fail-open shape the
+     * whole issue is about.
+     */
+    channelMembership: SalesChannelMembershipPort, approvalService?: CartApprovalService | undefined, auditService?: CartAuditService | undefined, recomputeCache?: CartRecomputeCache | undefined);
+    getOrCreateForCustomer(ctx: CustomerContext): Promise<Cart>;
+    getOrCreateForAnon(em: EntityManager, token: string): Promise<Cart>;
+    getItems(cartId: string): Promise<CartItem[]>;
+    addItem(actor: {
+        customer?: CustomerContext;
+        anonymousToken?: string;
+    }, input: {
+        productId: string;
+        variantId?: string;
+        quantity: number;
+        packagingUnitId?: string;
+    }): Promise<{
+        cart: Cart;
+        items: CartItem[];
+    }>;
+    updateItem(actor: {
+        customer?: CustomerContext;
+        anonymousToken?: string;
+    }, itemId: string, quantity: number): Promise<{
+        cart: Cart;
+        items: CartItem[];
+    }>;
+    removeItem(actor: {
+        customer?: CustomerContext;
+        anonymousToken?: string;
+    }, itemId: string): Promise<{
+        cart: Cart;
+        items: CartItem[];
+    }>;
+    /**
+     * Explicit "this buyer just opened the cart page" ping (feature 027 §R4 /
+     * FR-032). Bumps `last_activity_at` and, if the cart had transitioned to
+     * `abandoned`, brings it back to `active` and clears
+     * `abandonment_notified_at` so the next abandonment cycle can notify
+     * again. No-op on a missing cart.
+     */
+    touch(actor: {
+        customer?: CustomerContext;
+        anonymousToken?: string;
+    }): Promise<Cart | null>;
+    /**
+     * Merge an anonymous cart's items into the customer's cart at login
+     * time (feature 037-cart-merge-on-login).
+     *
+     * Returns a `CartMergeOutcome` diagnostic the caller (the login route
+     * via the `onLogin` hook) uses to surface the result to the storefront
+     * and to decide whether to clear the stale `b2b_cart_anon` cookie.
+     * See specs/037-cart-merge-on-login/contracts/cart-merge.md § 3.
+     *
+     * State matrix:
+     *   - `adopted`        — the customer had no active cart; the anon
+     *     cart's lines were placed onto a freshly-created destination.
+     *   - `merged`         — the customer already had an active cart and
+     *     ≥ 1 anon line was moved or summed into it.
+     *   - `noop_empty`     — the anon cart was found but carried no items;
+     *     the source row is still flipped to `completed` + detokenised
+     *     (cleanup), no audit row is written.
+     *   - `noop_no_anon`   — no cart for the supplied token; no DB change.
+     *
+     * Coupons on the source cart are NOT carried to the destination
+     * (R-05 / FR-010 — the destination's existing `appliedPromotionCode`
+     * is preserved verbatim).
+     */
+    mergeAnonymousIntoCustomer(anonymousToken: string, ctx: CustomerContext): Promise<CartMergeOutcome>;
+    clearForCustomer(ctx: CustomerContext): Promise<void>;
+}
+//# sourceMappingURL=cart-service.d.ts.map

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

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