@sixtyninecommerce/admin 0.9.0 → 0.11.0

package/dist/pos/returns.d.ts

@@ -0,0 +1,217 @@
+import type { Transport } from '@sixtyninecommerce/core';
+import type { Call } from '../types.js';
+/**
+ * Till returns and voids (POS engine sprint 20): goods of a completed till sale back, refunded to
+ * the sale's own payments, or the whole sale voided. A headless till (a machine principal with
+ * `x-location`) is a supported caller: its CREDENTIAL is the manager gate, so no staff or approval
+ * token is sent. Money is integer minor units of the order's currency.
+ *
+ * `quote` is a read: what the units would refund, to which payments, and why it cannot be done now
+ * (`blockedBy`, never thrown). `create` and `void` re-compute under the order's money turn and
+ * refuse a total other than `expectedTotal` (`POS_RETURN_AMOUNT_CHANGED`, another return was made
+ * meanwhile). Refusals that mean NOTHING moved: `POS_RETURN_INVALID` (`extensions.reason`),
+ * `POS_RETURN_AMOUNT_CHANGED`, `POS_RETURN_WINDOW_ENDED` (send `overrideWindow`),
+ * `POS_RETURN_REFUND_UNKNOWN`, `POS_RETURN_SPLIT_CARD`, `POS_RETURN_EXCEEDS_REFUNDABLE`,
+ * `POS_RETURN_SALE_NOT_COMPLETED`, `POS_VOID_NOT_ALLOWED` (`extensions.reason`),
+ * `POS_RETURNS_UNAVAILABLE`, `POS_SESSION_REQUIRED` (a cash refund needs an open drawer),
+ * `REFUND_REFUSED`, `REFUND_METHOD_UNAVAILABLE`, `LIVE_CONNECTION_REFUSED`.
+ * `IDEMPOTENCY_OUTCOME_UNKNOWN` is neither: a card refund reached the provider and the outcome is
+ * unknown; never retry under a new key. A card refund the provider did not confirm answers
+ * `complete: false` with that refund's `outcome: 'unknown'`; a repeat under the SAME key answers
+ * `complete: true` once it was reconciled as made.
+ *
+ * `payout: 'STORED_VALUE'` (engine C6b) pays a return out to the sale's OWN customer's store credit
+ * instead of refunding it: no refund, no provider, no drawer; `quote(...).storedValuePayout` says
+ * whether it can (`reason` `no_customer`, `no_method`, `not_entitled` when not), and `create`
+ * refuses `POS_RETURN_STORE_CREDIT_UNAVAILABLE` (`extensions.reason`) when it cannot, nothing moved.
+ * `quote` and `create` need an engine with C6b (an older one refuses their documents); `void`
+ * keeps its sprint-20 selection and reads on any engine.
+ */
+export type PosReturnKind = 'RETURN' | 'VOID';
+/** Where a return's value goes (C6b): REFUND (the default) or the customer's store credit. */
+export type PosReturnPayout = 'REFUND' | 'STORED_VALUE';
+export interface PosReturnQuoteInput {
+    orderId: string;
+    /** RETURN when omitted; VOID ignores lines. */
+    kind?: PosReturnKind;
+    lines?: Array<{
+        orderLineId: string;
+        quantity: number;
+    }>;
+    cashFirst?: boolean;
+    /** REFUND when omitted (C6b). */
+    payout?: PosReturnPayout;
+}
+/** Whether a sale's return can go to its customer's store credit (C6b). */
+export interface PosReturnStoredValuePayout {
+    available: boolean;
+    /** no_customer, no_method or not_entitled when it cannot. More may come. */
+    reason: string | null;
+}
+/** The store credit a return was paid out to (C6b). */
+export interface PosReturnStoredValueCredit {
+    accountId: string;
+    entryId: string;
+    amount: number;
+}
+export interface PosReturnQuoteLine {
+    orderLineId: string;
+    name: string;
+    sku: string | null;
+    customItem: boolean;
+    restockable: boolean;
+    soldQuantity: number;
+    returnedQuantity: number;
+    returnableQuantity: number;
+    quantity: number;
+    refundAmount: number;
+}
+export interface PosReturnLeg {
+    paymentId: string;
+    /** cash, card or other. More may come. */
+    kind: string;
+    method: string;
+    amount: number;
+}
+export interface PosReturnQuote {
+    orderId: string;
+    kind: PosReturnKind;
+    currencyCode: string;
+    receiptNumber: string | null;
+    lines: PosReturnQuoteLine[];
+    total: number;
+    legs: PosReturnLeg[];
+    cashPaidOut: number;
+    returnWindowEndsAt: string | null;
+    outsideWindow: boolean;
+    refundedOutsideReturns: number;
+    restockLocationName: string | null;
+    /** A POS_RETURN_* / POS_VOID_NOT_ALLOWED / REFUND_METHOD_UNAVAILABLE code, or null. More may come. */
+    blockedBy: string | null;
+    blockedReason: string | null;
+    /** Whether the return can go to the customer's store credit (C6b). */
+    storedValuePayout: PosReturnStoredValuePayout;
+}
+export interface PosReturnLineInput {
+    orderLineId: string;
+    quantity: number;
+    /** damaged, defective, wrong_item, not_as_described, arrived_late, no_longer_needed, order_error, other. */
+    reasonCode: string;
+    restock: boolean;
+}
+export interface PosReturnCreateInput {
+    orderId: string;
+    lines: PosReturnLineInput[];
+    /** `quote(...).total` as shown. */
+    expectedTotal: number;
+    overrideWindow?: boolean;
+    cashFirst?: boolean;
+    /** REFUND when omitted (C6b). STORED_VALUE: the whole return to the sale's customer's store credit. */
+    payout?: PosReturnPayout;
+}
+export interface PosVoidInput {
+    orderId: string;
+    /** `quote({ orderId, kind: 'VOID' }).total` as shown. */
+    expectedTotal: number;
+}
+export interface PosReturnRefund {
+    paymentId: string;
+    kind: string;
+    method: string;
+    amount: number;
+    refundId: string;
+    /** made, or unknown. More may come. */
+    outcome: string;
+}
+export interface PosReturnResult {
+    orderId: string;
+    returnId: string;
+    /** The return's RMA code. */
+    returnCode: string;
+    kind: PosReturnKind;
+    total: number;
+    refunds: PosReturnRefund[];
+    cashPaidOut: number;
+    complete: boolean;
+    /**
+     * What a STORED_VALUE payout credited (C6b); null for a refund. Absent on `void`, which never
+     * pays out to store credit and keeps the sprint-20 selection (it reads on an engine before C6b).
+     */
+    storedValueCredit?: PosReturnStoredValueCredit | null;
+}
+/** A webshop order by its code AND its customer's email (engine C3/34). */
+export interface PosOnlineOrderRef {
+    orderCode: string;
+    emailAddress: string;
+}
+/** What a till may know of a webshop order before a return (engine C3/34). */
+export interface PosOnlineOrder {
+    orderId: string;
+    orderCode: string;
+    placedAt: string | null;
+    state: string;
+    currencyCode: string;
+    totalWithTax: number;
+    customerName: string | null;
+    /** The payment a return goes back to (its method's name); null when none can. */
+    refundMethodName: string | null;
+    returnableUnits: number;
+    /** POS_ONLINE_RETURN_BACK_OFFICE / POS_ONLINE_RETURN_NOTHING_RETURNABLE, or null. More may come. */
+    blockedBy: string | null;
+    blockedReason: string | null;
+}
+/** An online return's quote: the till quote plus what it refunds of delivery (engine C3/34). */
+export interface PosOnlineReturnQuote extends PosReturnQuote {
+    /** Delivery refunded: only when the return brings the whole order back inside the window. */
+    shippingRefund: number;
+    /** `online`. More may come. */
+    source: string;
+}
+export interface PosOnlineReturnInput {
+    order: PosOnlineOrderRef;
+    lines: PosReturnLineInput[];
+    /** `onlineQuote(...).total` as shown, delivery included. */
+    expectedTotal: number;
+    overrideWindow?: boolean;
+}
+export interface PosReturnsModule {
+    /** What a return (or a void) would do now. Writes nothing. */
+    quote(input: PosReturnQuoteInput, options?: Call): Promise<PosReturnQuote>;
+    /** Return items: the key is REQUIRED (`options.idempotencyKey`). */
+    create(input: PosReturnCreateInput, options: Call & {
+        idempotencyKey: string;
+    }): Promise<PosReturnResult>;
+    /** Void a sale: the key is REQUIRED (`options.idempotencyKey`). */
+    void(input: PosVoidInput, options: Call & {
+        idempotencyKey: string;
+    }): Promise<PosReturnResult>;
+    /**
+     * A webshop order of this store by its code AND its customer's email (engine C3/34), re-verified
+     * on every call. An unknown code, a wrong email or another store's order is ONE refusal,
+     * `POS_ONLINE_ORDER_NOT_FOUND`; a till sale `POS_ONLINE_ORDER_IS_TILL_SALE`.
+     */
+    findOnlineOrder(ref: PosOnlineOrderRef, options?: Call): Promise<PosOnlineOrder>;
+    /** What returning these units of the webshop order would refund now (engine C3/34). */
+    onlineQuote(input: {
+        order: PosOnlineOrderRef;
+        lines?: Array<{
+            orderLineId: string;
+            quantity: number;
+        }>;
+    }, options?: Call): Promise<PosOnlineReturnQuote>;
+    /**
+     * Return a webshop order's items at the credential's location, refunded to ONE online payment
+     * (engine C3/34). The key is REQUIRED. A provider that answers later or never confirms answers
+     * `complete: false` with the refund's `outcome` `pending` / `unknown` (do not refund again).
+     */
+    onlineReturn(input: PosOnlineReturnInput, options: Call & {
+        idempotencyKey: string;
+    }): Promise<PosReturnResult>;
+}
+export declare const POS_RETURN_QUOTE_QUERY = "query PosReturnQuote($input: PosReturnQuoteInput!) { posReturnQuote(input: $input) { orderId kind currencyCode receiptNumber lines { orderLineId name sku customItem restockable soldQuantity returnedQuantity returnableQuantity quantity refundAmount } total legs { paymentId kind method amount } cashPaidOut returnWindowEndsAt outsideWindow refundedOutsideReturns restockLocationName blockedBy blockedReason storedValuePayout { available reason } } }";
+export declare const POS_RETURN_MUTATION = "mutation PosReturn($input: PosReturnInput!) { posReturn(input: $input) { orderId returnId returnCode kind total refunds { paymentId kind method amount refundId outcome } cashPaidOut complete storedValueCredit { accountId entryId amount } } }";
+export declare const POS_VOID_SALE_MUTATION = "mutation PosVoidSale($input: PosVoidSaleInput!) { posVoidSale(input: $input) { orderId returnId returnCode kind total refunds { paymentId kind method amount refundId outcome } cashPaidOut complete } }";
+export declare const POS_ONLINE_ORDER_QUERY = "query PosOnlineOrder($input: PosOnlineOrderRefInput!) { posOnlineOrder(input: $input) { orderId orderCode placedAt state currencyCode totalWithTax customerName refundMethodName returnableUnits blockedBy blockedReason } }";
+export declare const POS_ONLINE_RETURN_QUOTE_QUERY = "query PosOnlineReturnQuote($input: PosOnlineReturnQuoteInput!) { posOnlineReturnQuote(input: $input) { orderId kind currencyCode receiptNumber lines { orderLineId name sku customItem restockable soldQuantity returnedQuantity returnableQuantity quantity refundAmount } total legs { paymentId kind method amount } cashPaidOut returnWindowEndsAt outsideWindow refundedOutsideReturns restockLocationName blockedBy blockedReason storedValuePayout { available reason } shippingRefund source } }";
+export declare const POS_ONLINE_RETURN_MUTATION = "mutation PosOnlineReturn($input: PosOnlineReturnInput!) { posOnlineReturn(input: $input) { orderId returnId returnCode kind total refunds { paymentId kind method amount refundId outcome } cashPaidOut complete } }";
+export declare function createPosReturnsModule(transport: Transport): PosReturnsModule;

package/dist/pos/returns.js

@@ -0,0 +1,53 @@
+const QUOTE_FIELDS = 'orderId kind currencyCode receiptNumber lines { orderLineId name sku customItem restockable soldQuantity returnedQuantity returnableQuantity quantity refundAmount } total legs { paymentId kind method amount } cashPaidOut returnWindowEndsAt outsideWindow refundedOutsideReturns restockLocationName blockedBy blockedReason storedValuePayout { available reason }';
+/** The sprint-20 result: what a void answers (it never pays out to store credit). */
+const VOID_RESULT_FIELDS = 'orderId returnId returnCode kind total refunds { paymentId kind method amount refundId outcome } cashPaidOut complete';
+/** A return's result: the void's, and the store credit a STORED_VALUE payout made (C6b). */
+const RESULT_FIELDS = `${VOID_RESULT_FIELDS} storedValueCredit { accountId entryId amount }`;
+export const POS_RETURN_QUOTE_QUERY = `query PosReturnQuote($input: PosReturnQuoteInput!) { posReturnQuote(input: $input) { ${QUOTE_FIELDS} } }`;
+export const POS_RETURN_MUTATION = `mutation PosReturn($input: PosReturnInput!) { posReturn(input: $input) { ${RESULT_FIELDS} } }`;
+export const POS_VOID_SALE_MUTATION = `mutation PosVoidSale($input: PosVoidSaleInput!) { posVoidSale(input: $input) { ${VOID_RESULT_FIELDS} } }`;
+// Engine C3/34: their own documents, so a call to an older engine fails alone.
+const ONLINE_ORDER_FIELDS = 'orderId orderCode placedAt state currencyCode totalWithTax customerName refundMethodName returnableUnits blockedBy blockedReason';
+export const POS_ONLINE_ORDER_QUERY = `query PosOnlineOrder($input: PosOnlineOrderRefInput!) { posOnlineOrder(input: $input) { ${ONLINE_ORDER_FIELDS} } }`;
+export const POS_ONLINE_RETURN_QUOTE_QUERY = `query PosOnlineReturnQuote($input: PosOnlineReturnQuoteInput!) { posOnlineReturnQuote(input: $input) { ${QUOTE_FIELDS} shippingRefund source } }`;
+// A webshop order's return never pays out to store credit (C3 D22): the void's result fields.
+export const POS_ONLINE_RETURN_MUTATION = `mutation PosOnlineReturn($input: PosOnlineReturnInput!) { posOnlineReturn(input: $input) { ${VOID_RESULT_FIELDS} } }`;
+function keyOf(options, call) {
+    const key = options?.idempotencyKey;
+    if (typeof key !== 'string' || key.trim() === '') {
+        throw new TypeError(`pos.returns.${call} needs options.idempotencyKey (a fresh UUIDv7 per return; reuse it only to retry the same one).`);
+    }
+    return key;
+}
+export function createPosReturnsModule(transport) {
+    const gql = async (query, variables, options) => transport.graphql({ api: 'admin', query, variables }, options);
+    return {
+        async quote(input, options) {
+            const data = await gql(POS_RETURN_QUOTE_QUERY, { input }, options);
+            return data.posReturnQuote;
+        },
+        async create(input, options) {
+            const idempotencyKey = keyOf(options, 'create');
+            const data = await gql(POS_RETURN_MUTATION, { input: { ...input, idempotencyKey } }, options);
+            return data.posReturn;
+        },
+        async void(input, options) {
+            const idempotencyKey = keyOf(options, 'void');
+            const data = await gql(POS_VOID_SALE_MUTATION, { input: { ...input, idempotencyKey } }, options);
+            return data.posVoidSale;
+        },
+        async findOnlineOrder(ref, options) {
+            const data = await gql(POS_ONLINE_ORDER_QUERY, { input: ref }, options);
+            return data.posOnlineOrder;
+        },
+        async onlineQuote(input, options) {
+            const data = await gql(POS_ONLINE_RETURN_QUOTE_QUERY, { input }, options);
+            return data.posOnlineReturnQuote;
+        },
+        async onlineReturn(input, options) {
+            const idempotencyKey = keyOf(options, 'onlineReturn');
+            const data = await gql(POS_ONLINE_RETURN_MUTATION, { input: { ...input, idempotencyKey } }, options);
+            return data.posOnlineReturn;
+        },
+    };
+}

package/dist/pricing/bulk-coupons.d.ts

@@ -0,0 +1,139 @@
+import { type Page, type Transport } from '@sixtyninecommerce/core';
+import type { Call, ListOptions } from '../types.js';
+/**
+ * `admin.pricing.coupons.bulk`: unique codes generated in bulk for a promotion of the store
+ * (`vendure-plugin-bulk-coupons`). A code stands in for its promotion's own coupon code, so a
+ * promotion WITHOUT a coupon code takes none: its codes would never be accepted. Each code keeps
+ * its group's usage limits on top of the promotion's.
+ *
+ * Every id names a record of THIS store: another store's promotion, group or code is
+ * `ENTITY_NOT_FOUND` (`NotFoundError`, 404), the same answer as one that does not exist.
+ */
+export interface PricingBulkCouponsModule {
+    /**
+     * The promotion's code groups, newest first, each with how many of its codes are active and
+     * how many uses its codes have had (orders holding a code that are not cancelled). A voucher
+     * template (`kind: 'voucher'`, `pricing.vouchers`) is a group too.
+     *
+     * @effect read
+     * @permission ReadPromotion
+     */
+    groups(promotionId: string, options?: Call): Promise<BulkCouponGroup[]>;
+    /**
+     * One page of a group's codes, oldest first and then by id, an order every page agrees on, so
+     * a walk with `for await` sees each code once (`limit` 1 to 1,000, default 25), each with its
+     * own use count. Refused before sending: `INVALID_PAGE_SIZE` (`ValidationError`, 400).
+     *
+     * @effect read
+     * @permission ReadPromotion
+     */
+    codes(groupId: string, options?: ListOptions): Promise<Page<BulkCouponCode>>;
+    /**
+     * Generate a group of `quantity` new codes, `PREFIX-RANDOM`, for the promotion, and answer
+     * the group. The prefix is trimmed; the random part is `codeLength` characters (8 when
+     * omitted).
+     *
+     * Refusals (`ValidationError`, 400): `BULK_COUPON_PREFIX_INVALID` (1 to 50 capital letters,
+     * digits or "-", starting with a letter or digit), `BULK_COUPON_CODE_LENGTH_INVALID` (8 to
+     * 32), `BULK_COUPON_QUANTITY_INVALID` (1 to 100,000);
+     * `BULK_COUPON_CODE_SPACE_EXHAUSTED` (`BusinessRuleError`, 422) when the prefix and length
+     * have too few free codes left (choose a longer length or another prefix). Nothing is saved
+     * on a refusal. A repeat generates another group: no `idempotencyKey` is read.
+     *
+     * @effect write
+     * @permission CreatePromotion
+     */
+    generate(input: GenerateBulkCouponsInput, options?: Call): Promise<BulkCouponGroup>;
+    /**
+     * Accept a switched-off code again, and answer it.
+     *
+     * @effect write
+     * @permission UpdatePromotion
+     */
+    activate(codeId: string, options?: Call): Promise<BulkCouponCode>;
+    /**
+     * Stop accepting one code from now on, and answer it.
+     *
+     * @effect write
+     * @permission UpdatePromotion
+     */
+    deactivate(codeId: string, options?: Call): Promise<BulkCouponCode>;
+    /**
+     * Stop accepting every code of a group (each can be switched on again with
+     * {@link activate}).
+     *
+     * @effect write
+     * @permission UpdatePromotion
+     */
+    deactivateGroup(groupId: string, options?: Call): Promise<void>;
+    /**
+     * Delete a group and every code in it: none is accepted again, and none can be switched back
+     * on.
+     *
+     * @effect destructive
+     * @permission DeletePromotion
+     */
+    deleteGroup(groupId: string, options?: Call): Promise<void>;
+    /**
+     * Every code of a group as CSV text, in the order of {@link codes}: a `code,active,created_at`
+     * header, then one line per code (`active` is `true`/`false`, `created_at` an ISO-8601 instant).
+     *
+     * @effect read
+     * @permission ReadPromotion
+     */
+    export(groupId: string, options?: Call): Promise<string>;
+}
+export interface BulkCouponGroup {
+    id: string;
+    promotionId: string;
+    prefix: string;
+    codeLength: number;
+    /** Codes generated up front; 0 for a voucher template, whose codes are issued one by one. */
+    quantity: number;
+    /** Uses each code allows; null for no limit of its own. */
+    perCodeUsageLimit: number | null;
+    /** Uses each code allows one customer; null for no limit of its own. */
+    perCodeCustomerUsageLimit: number | null;
+    /** `batch` (generated up front) or `voucher` (personal codes issued one by one). */
+    kind: 'batch' | 'voucher' | (string & {});
+    /** A voucher template's validity in days when an issue names none. */
+    defaultValidityDays: number | null;
+    activeCount: number;
+    usedCount: number;
+    createdAt: string;
+}
+export interface BulkCouponCode {
+    id: string;
+    code: string;
+    isActive: boolean;
+    usageCount: number;
+    createdAt: string;
+    /** A voucher's customer; null for a batch code (or a voucher whose customer was erased). */
+    customerId: string | null;
+    /** A voucher's own expiry; its promotion's end still applies. */
+    expiresAt: string | null;
+    /** The system that issued a voucher, as it named itself. */
+    sourceSystem: string | null;
+    /** The issuing journey's own reference, opaque. */
+    sourceRef: string | null;
+}
+export interface GenerateBulkCouponsInput {
+    promotionId: string;
+    prefix: string;
+    /** The random part's length, 8 to 32; 8 when omitted. */
+    codeLength?: number;
+    /** 1 to 100,000. */
+    quantity: number;
+    perCodeUsageLimit?: number | null;
+    perCodeCustomerUsageLimit?: number | null;
+}
+export declare const BULK_COUPON_GROUPS_QUERY = "\n  query BulkCouponGroups($promotionId: ID!) {\n    bulkCouponGroups(promotionId: $promotionId) { \n  id\n  promotionId\n  prefix\n  codeLength\n  quantity\n  perCodeUsageLimit\n  perCodeCustomerUsageLimit\n  kind\n  defaultValidityDays\n  activeCount\n  usedCount\n  createdAt\n }\n  }\n";
+export declare const BULK_COUPON_CODES_QUERY = "\n  query BulkCouponCodes($groupId: ID!, $options: BulkCouponCodeListOptions) {\n    bulkCouponCodes(groupId: $groupId, options: $options) {\n      items { \n  id\n  code\n  isActive\n  usageCount\n  createdAt\n  customerId\n  expiresAt\n  sourceSystem\n  sourceRef\n }\n      totalItems\n    }\n  }\n";
+export declare const GENERATE_BULK_COUPONS_MUTATION = "\n  mutation GenerateBulkCoupons($input: GenerateBulkCouponsInput!) {\n    generateBulkCoupons(input: $input) { \n  id\n  promotionId\n  prefix\n  codeLength\n  quantity\n  perCodeUsageLimit\n  perCodeCustomerUsageLimit\n  kind\n  defaultValidityDays\n  activeCount\n  usedCount\n  createdAt\n }\n  }\n";
+export declare const ACTIVATE_BULK_COUPON_CODE_MUTATION = "\n  mutation ActivateBulkCouponCode($id: ID!) {\n    activateBulkCouponCode(id: $id) { \n  id\n  code\n  isActive\n  usageCount\n  createdAt\n  customerId\n  expiresAt\n  sourceSystem\n  sourceRef\n }\n  }\n";
+export declare const DEACTIVATE_BULK_COUPON_CODE_MUTATION = "\n  mutation DeactivateBulkCouponCode($id: ID!) {\n    deactivateBulkCouponCode(id: $id) { \n  id\n  code\n  isActive\n  usageCount\n  createdAt\n  customerId\n  expiresAt\n  sourceSystem\n  sourceRef\n }\n  }\n";
+export declare const DEACTIVATE_BULK_COUPON_GROUP_MUTATION = "\n  mutation DeactivateBulkCouponGroup($groupId: ID!) {\n    deactivateBulkCouponGroup(groupId: $groupId)\n  }\n";
+export declare const DELETE_BULK_COUPON_GROUP_MUTATION = "\n  mutation DeleteBulkCouponGroup($groupId: ID!) {\n    deleteBulkCouponGroup(groupId: $groupId)\n  }\n";
+/** A mutation, though it writes nothing: the plugin declares it so (`ReadPromotion`). */
+export declare const EXPORT_BULK_COUPON_CODES_MUTATION = "\n  mutation ExportBulkCouponCodes($groupId: ID!) {\n    exportBulkCouponCodes(groupId: $groupId)\n  }\n";
+export declare function createPricingBulkCouponsModule(transport: Transport): PricingBulkCouponsModule;

package/dist/pricing/bulk-coupons.js

@@ -0,0 +1,112 @@
+import { UpstreamError } from '@sixtyninecommerce/core';
+import { fieldOf, vendureListPage } from '../catalog/types.js';
+const GROUP_FIELDS = /* GraphQL */ `
+  id
+  promotionId
+  prefix
+  codeLength
+  quantity
+  perCodeUsageLimit
+  perCodeCustomerUsageLimit
+  kind
+  defaultValidityDays
+  activeCount
+  usedCount
+  createdAt
+`;
+const CODE_FIELDS = /* GraphQL */ `
+  id
+  code
+  isActive
+  usageCount
+  createdAt
+  customerId
+  expiresAt
+  sourceSystem
+  sourceRef
+`;
+export const BULK_COUPON_GROUPS_QUERY = /* GraphQL */ `
+  query BulkCouponGroups($promotionId: ID!) {
+    bulkCouponGroups(promotionId: $promotionId) { ${GROUP_FIELDS} }
+  }
+`;
+export const BULK_COUPON_CODES_QUERY = /* GraphQL */ `
+  query BulkCouponCodes($groupId: ID!, $options: BulkCouponCodeListOptions) {
+    bulkCouponCodes(groupId: $groupId, options: $options) {
+      items { ${CODE_FIELDS} }
+      totalItems
+    }
+  }
+`;
+export const GENERATE_BULK_COUPONS_MUTATION = /* GraphQL */ `
+  mutation GenerateBulkCoupons($input: GenerateBulkCouponsInput!) {
+    generateBulkCoupons(input: $input) { ${GROUP_FIELDS} }
+  }
+`;
+export const ACTIVATE_BULK_COUPON_CODE_MUTATION = /* GraphQL */ `
+  mutation ActivateBulkCouponCode($id: ID!) {
+    activateBulkCouponCode(id: $id) { ${CODE_FIELDS} }
+  }
+`;
+export const DEACTIVATE_BULK_COUPON_CODE_MUTATION = /* GraphQL */ `
+  mutation DeactivateBulkCouponCode($id: ID!) {
+    deactivateBulkCouponCode(id: $id) { ${CODE_FIELDS} }
+  }
+`;
+export const DEACTIVATE_BULK_COUPON_GROUP_MUTATION = /* GraphQL */ `
+  mutation DeactivateBulkCouponGroup($groupId: ID!) {
+    deactivateBulkCouponGroup(groupId: $groupId)
+  }
+`;
+export const DELETE_BULK_COUPON_GROUP_MUTATION = /* GraphQL */ `
+  mutation DeleteBulkCouponGroup($groupId: ID!) {
+    deleteBulkCouponGroup(groupId: $groupId)
+  }
+`;
+/** A mutation, though it writes nothing: the plugin declares it so (`ReadPromotion`). */
+export const EXPORT_BULK_COUPON_CODES_MUTATION = /* GraphQL */ `
+  mutation ExportBulkCouponCodes($groupId: ID!) {
+    exportBulkCouponCodes(groupId: $groupId)
+  }
+`;
+/** A `Boolean!` door's answer: anything but `true` is refused, never taken as done. */
+function assertDone(field, answer) {
+    if (answer === true)
+        return;
+    throw new UpstreamError({
+        code: 'UNEXPECTED_RESPONSE',
+        message: `The engine answered "${field}" with ${JSON.stringify(answer)}, not true.`,
+        status: 502,
+        service: 'vendure',
+    });
+}
+export function createPricingBulkCouponsModule(transport) {
+    return {
+        groups(promotionId, options) {
+            return fieldOf(transport, BULK_COUPON_GROUPS_QUERY, 'bulkCouponGroups', { promotionId }, options);
+        },
+        codes(groupId, options) {
+            return vendureListPage(transport, BULK_COUPON_CODES_QUERY, 'bulkCouponCodes', (skip, take) => ({ groupId, options: { skip, take } }), options);
+        },
+        generate(input, options) {
+            return fieldOf(transport, GENERATE_BULK_COUPONS_MUTATION, 'generateBulkCoupons', { input }, options);
+        },
+        activate(codeId, options) {
+            return fieldOf(transport, ACTIVATE_BULK_COUPON_CODE_MUTATION, 'activateBulkCouponCode', { id: codeId }, options);
+        },
+        deactivate(codeId, options) {
+            return fieldOf(transport, DEACTIVATE_BULK_COUPON_CODE_MUTATION, 'deactivateBulkCouponCode', { id: codeId }, options);
+        },
+        async deactivateGroup(groupId, options) {
+            const field = 'deactivateBulkCouponGroup';
+            assertDone(field, await fieldOf(transport, DEACTIVATE_BULK_COUPON_GROUP_MUTATION, field, { groupId }, options));
+        },
+        async deleteGroup(groupId, options) {
+            const field = 'deleteBulkCouponGroup';
+            assertDone(field, await fieldOf(transport, DELETE_BULK_COUPON_GROUP_MUTATION, field, { groupId }, options));
+        },
+        export(groupId, options) {
+            return fieldOf(transport, EXPORT_BULK_COUPON_CODES_MUTATION, 'exportBulkCouponCodes', { groupId }, options);
+        },
+    };
+}