@ehrenkind/shopify-lib 0.0.6 → 0.1.0

package/dist/queries/orders/getOrderByName.d.ts

@@ -0,0 +1,72 @@
+import z from 'zod';
+import type { OrdersByNameFullQuery } from '../../generated-api-types/2025-04/admin.generated.js';
+declare const GetLeanOrderByNameReturn: z.ZodNullable<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    totalPrice: z.ZodObject<{
+        amount: z.ZodString;
+        currencyCode: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        currencyCode: string;
+        amount: string;
+    }, {
+        currencyCode: string;
+        amount: string;
+    }>;
+    customer: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        emailAddress: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        displayName: string;
+        emailAddress: string | null;
+    }, {
+        id: string;
+        displayName: string;
+        emailAddress: string | null;
+    }>>;
+    financialStatus: z.ZodNullable<z.ZodString>;
+    fulfillmentStatus: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    name: string;
+    customer: {
+        id: string;
+        displayName: string;
+        emailAddress: string | null;
+    } | null;
+    totalPrice: {
+        currencyCode: string;
+        amount: string;
+    };
+    fulfillmentStatus: string | null;
+    financialStatus: string | null;
+}, {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    name: string;
+    customer: {
+        id: string;
+        displayName: string;
+        emailAddress: string | null;
+    } | null;
+    totalPrice: {
+        currencyCode: string;
+        amount: string;
+    };
+    fulfillmentStatus: string | null;
+    financialStatus: string | null;
+}>>;
+type GetLeanOrderByNameReturnType = z.infer<typeof GetLeanOrderByNameReturn>;
+type GetFullOrderByNameReturnType = NonNullable<NonNullable<OrdersByNameFullQuery['orders']>['edges'][number]['node']> | null;
+export declare function getOrderByName(orderName: string, detailLevel: 'lean'): Promise<GetLeanOrderByNameReturnType>;
+export declare function getOrderByName(orderName: string, detailLevel: 'full'): Promise<GetFullOrderByNameReturnType>;
+export declare function getOrderByName(orderName: string): Promise<GetLeanOrderByNameReturnType>;
+export {};
+//# sourceMappingURL=getOrderByName.d.ts.map

package/dist/queries/orders/getOrderByName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrderByName.d.ts","sourceRoot":"","sources":["../../../src/queries/orders/getOrderByName.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAA;AACnB,OAAO,KAAK,EACV,qBAAqB,EAGtB,MAAM,sDAAsD,CAAA;AAS7D,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoBjB,CAAA;AAEb,KAAK,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE5E,KAAK,4BAA4B,GAAG,WAAW,CAC7C,WAAW,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CACtE,GAAG,IAAI,CAAA;AAKR,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,4BAA4B,CAAC,CAAA;AACxC,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,4BAA4B,CAAC,CAAA;AACxC,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,4BAA4B,CAAC,CAAA"}

package/dist/queries/orders/getOrderByName.js

@@ -0,0 +1,117 @@
+import z from 'zod';
+import { logger } from '../../utils/logger.js';
+import { fetchShopifyGraphql } from '../../utils/shopifyFetch.js';
+import { returnOutputParsed } from '../../utils/zod.js';
+import { queryOrdersByName, queryOrdersByNameFull, } from './getOrderByName.queries.js';
+const GetLeanOrderByNameReturn = z
+    .object({
+    id: z.string(),
+    name: z.string(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    totalPrice: z.object({
+        amount: z.string(),
+        currencyCode: z.string(),
+    }),
+    customer: z
+        .object({
+        id: z.string(),
+        displayName: z.string(),
+        emailAddress: z.string().nullable(),
+    })
+        .nullable(),
+    financialStatus: z.string().nullable(),
+    fulfillmentStatus: z.string().nullable(),
+})
+    .nullable();
+/**
+ * Retrieves a single order from Shopify by its order name (e.g., "B12345").
+ * Returns null if no order is found with the specified name.
+ *
+ * @param {string} orderName - The order name to search for (e.g., "B12345").
+ * @param {OrderDetailLevel} detailLevel - The level of detail to return ('lean' or 'full'). Defaults to 'lean'.
+ * @returns {Promise<GetLeanOrderByNameReturnType | GetFullOrderByNameReturnType>} A promise that resolves to the order data or null if not found.
+ * @throws {Error} If the GraphQL query fails or if the response structure is invalid.
+ */
+export async function getOrderByName(orderName, detailLevel = 'lean') {
+    if (detailLevel === 'lean') {
+        return getLeanOrderByName(orderName);
+    }
+    return getFullOrderByName(orderName);
+}
+async function getLeanOrderByName(orderName) {
+    const variables = {
+        first: 1,
+        queryFilter: `name:${orderName}`,
+    };
+    const extractedNodes = await fetchShopifyGraphql({
+        query: queryOrdersByName,
+        variables,
+        dataExtractor: (pageData) => {
+            if (!pageData.orders) {
+                throw new Error("GraphQL response for orders is missing the 'orders' field.");
+            }
+            const nodes = pageData.orders.edges.map((edge) => edge.node);
+            return {
+                nodes,
+            };
+        },
+        fetchAllPages: false,
+    });
+    const order = extractedNodes[0];
+    if (!order) {
+        logger.debug(`No order found with name: ${orderName}`);
+        return null;
+    }
+    const leanOrder = {
+        id: order.id,
+        name: order.name,
+        createdAt: order.createdAt,
+        updatedAt: order.updatedAt,
+        totalPrice: {
+            amount: order.totalPriceSet?.shopMoney?.amount ?? '',
+            currencyCode: order.totalPriceSet?.shopMoney?.currencyCode ?? '',
+        },
+        customer: order.customer
+            ? {
+                id: order.customer.id,
+                displayName: order.customer.displayName,
+                emailAddress: order.customer.defaultEmailAddress?.emailAddress ?? null,
+            }
+            : null,
+        financialStatus: order.displayFinancialStatus ?? null,
+        fulfillmentStatus: order.displayFulfillmentStatus ?? null,
+    };
+    return await returnOutputParsed(leanOrder, GetLeanOrderByNameReturn);
+}
+async function getFullOrderByName(orderName) {
+    const variables = {
+        first: 1,
+        queryFilter: `name:${orderName}`,
+    };
+    const extractedNodes = await fetchShopifyGraphql({
+        query: queryOrdersByNameFull,
+        variables,
+        dataExtractor: (pageData) => {
+            if (!pageData.orders) {
+                throw new Error("GraphQL response for orders is missing the 'orders' field.");
+            }
+            const nodes = pageData.orders.edges.map((edge) => edge.node);
+            return {
+                nodes,
+            };
+        },
+        fetchAllPages: false,
+    });
+    if (extractedNodes.length === 0) {
+        logger.debug(`No order found with name: ${orderName}`);
+        return null;
+    }
+    const order = extractedNodes[0];
+    if (!order) {
+        logger.debug(`No order found with name: ${orderName}`);
+        return null;
+    }
+    return order;
+}
+//# sourceMappingURL=getOrderByName.js.map

package/dist/queries/orders/getOrderByName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrderByName.js","sourceRoot":"","sources":["../../../src/queries/orders/getOrderByName.ts"],"names":[],"mappings":"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"}

package/dist/queries/orders/getOrderByName.mock.d.ts

@@ -0,0 +1,21 @@
+import type { OrdersByNameQuery } from '../../generated-api-types/2025-04/admin.generated';
+import { CurrencyCode, OrderDisplayFulfillmentStatus } from '../../generated-api-types/2025-04/admin.types';
+export declare const ordersByNameMock: OrdersByNameQuery;
+export declare const expectedLeanOrder: {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+    totalPrice: {
+        amount: string;
+        currencyCode: CurrencyCode;
+    };
+    customer: {
+        id: string;
+        displayName: string;
+        emailAddress: string;
+    };
+    financialStatus: null;
+    fulfillmentStatus: OrderDisplayFulfillmentStatus;
+};
+//# sourceMappingURL=getOrderByName.mock.d.ts.map

package/dist/queries/orders/getOrderByName.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrderByName.mock.d.ts","sourceRoot":"","sources":["../../../src/queries/orders/getOrderByName.mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAA;AAC1F,OAAO,EACL,YAAY,EACZ,6BAA6B,EAC9B,MAAM,+CAA+C,CAAA;AA0BtD,eAAO,MAAM,gBAAgB,EAAE,iBAY9B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;CAgB7B,CAAA"}

package/dist/queries/orders/getOrderByName.mock.js

@@ -0,0 +1,55 @@
+import { CurrencyCode, OrderDisplayFulfillmentStatus, } from '../../generated-api-types/2025-04/admin.types';
+const order = {
+    id: 'gid://shopify/Order/12345',
+    name: 'B12345',
+    createdAt: '2024-01-15T10:30:00Z',
+    updatedAt: '2024-01-15T14:45:00Z',
+    totalPriceSet: {
+        shopMoney: {
+            amount: '99.99',
+            currencyCode: CurrencyCode.Usd,
+        },
+    },
+    customer: {
+        id: 'gid://shopify/Customer/67890',
+        displayName: 'John Doe',
+        firstName: 'John',
+        lastName: 'Doe',
+        defaultEmailAddress: {
+            emailAddress: 'john.doe@example.com',
+        },
+    },
+    displayFulfillmentStatus: OrderDisplayFulfillmentStatus.Fulfilled,
+    displayFinancialStatus: null,
+};
+export const ordersByNameMock = {
+    orders: {
+        edges: [
+            {
+                node: order,
+            },
+        ],
+        pageInfo: {
+            hasNextPage: false,
+            endCursor: 'eyJsYXN0X2lkIjoxMjM0NX0=',
+        },
+    },
+};
+export const expectedLeanOrder = {
+    id: order.id,
+    name: order.name,
+    createdAt: order.createdAt,
+    updatedAt: order.updatedAt,
+    totalPrice: {
+        amount: order.totalPriceSet.shopMoney.amount,
+        currencyCode: order.totalPriceSet.shopMoney.currencyCode,
+    },
+    customer: {
+        id: order.customer.id,
+        displayName: order.customer.displayName,
+        emailAddress: order.customer.defaultEmailAddress.emailAddress,
+    },
+    financialStatus: order.displayFinancialStatus,
+    fulfillmentStatus: order.displayFulfillmentStatus,
+};
+//# sourceMappingURL=getOrderByName.mock.js.map

package/dist/queries/orders/getOrderByName.mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrderByName.mock.js","sourceRoot":"","sources":["../../../src/queries/orders/getOrderByName.mock.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,6BAA6B,GAC9B,MAAM,+CAA+C,CAAA;AAEtD,MAAM,KAAK,GAAG;IACZ,EAAE,EAAE,2BAA2B;IAC/B,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,sBAAsB;IACjC,SAAS,EAAE,sBAAsB;IACjC,aAAa,EAAE;QACb,SAAS,EAAE;YACT,MAAM,EAAE,OAAO;YACf,YAAY,EAAE,YAAY,CAAC,GAAG;SAC/B;KACF;IACD,QAAQ,EAAE;QACR,EAAE,EAAE,8BAA8B;QAClC,WAAW,EAAE,UAAU;QACvB,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,KAAK;QACf,mBAAmB,EAAE;YACnB,YAAY,EAAE,sBAAsB;SACrC;KACF;IACD,wBAAwB,EAAE,6BAA6B,CAAC,SAAS;IACjE,sBAAsB,EAAE,IAAI;CAC7B,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,MAAM,EAAE;QACN,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,KAAK;aACZ;SACF;QACD,QAAQ,EAAE;YACR,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,0BAA0B;SACtC;KACF;CACF,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,EAAE,EAAE,KAAK,CAAC,EAAE;IACZ,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,SAAS,EAAE,KAAK,CAAC,SAAS;IAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;IAC1B,UAAU,EAAE;QACV,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM;QAC5C,YAAY,EAAE,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,YAAY;KACzD;IACD,QAAQ,EAAE;QACR,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE;QACrB,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;QACvC,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC,YAAY;KAC9D;IACD,eAAe,EAAE,KAAK,CAAC,sBAAsB;IAC7C,iBAAiB,EAAE,KAAK,CAAC,wBAAwB;CAClD,CAAA"}

package/dist/queries/orders/getOrderByName.queries.d.ts

@@ -0,0 +1,3 @@
+export declare const queryOrdersByName: string;
+export declare const queryOrdersByNameFull: string;
+//# sourceMappingURL=getOrderByName.queries.d.ts.map

package/dist/queries/orders/getOrderByName.queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrderByName.queries.d.ts","sourceRoot":"","sources":["../../../src/queries/orders/getOrderByName.queries.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,QAkC7B,CAAA;AAED,eAAO,MAAM,qBAAqB,QAySjC,CAAA"}

package/dist/queries/orders/getOrderByName.queries.js

@@ -0,0 +1,335 @@
+import { gql } from '../../utils/logger';
+export const queryOrdersByName = gql `#graphql
+  query ordersByName($first: Int!, $queryFilter: String!) {
+    orders(first: $first, query: $queryFilter) {
+      edges {
+        node {
+          id
+          name
+          createdAt
+          updatedAt
+          totalPriceSet {
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          customer {
+            id
+            lastName
+            defaultEmailAddress {
+              emailAddress
+            }
+            displayName
+            firstName
+          }
+          displayFinancialStatus
+          displayFulfillmentStatus
+        }
+      }
+      pageInfo {
+        hasNextPage
+        endCursor
+      }
+    }
+  }
+`;
+export const queryOrdersByNameFull = gql `#graphql
+  query ordersByNameFull($first: Int!, $queryFilter: String!) {
+    orders(first: $first, query: $queryFilter) {
+      edges {
+        node {
+          billingAddress {
+            address1
+            address2
+            city
+            company
+            country
+            countryCodeV2
+            firstName
+            formattedArea
+            id
+            lastName
+            name
+            phone
+            province
+            provinceCode
+            timeZone
+            zip
+          }
+          billingAddressMatchesShippingAddress
+          cancelReason
+          cancellation {
+            staffNote
+          }
+          cancelledAt
+          capturable
+          clientIp
+          closed
+          closedAt
+          confirmed
+          createdAt
+          currencyCode
+          currentCartDiscountAmountSet {
+            presentmentMoney {
+              amount
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          currentShippingPriceSet {
+            presentmentMoney {
+              amount
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          currentSubtotalLineItemsQuantity
+          currentSubtotalPriceSet {
+            presentmentMoney {
+              amount
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          currentTaxLines {
+            channelLiable
+            rate
+            ratePercentage
+            source
+            title
+            priceSet {
+              presentmentMoney {
+                amount
+                currencyCode
+              }
+              shopMoney {
+                amount
+                currencyCode
+              }
+            }
+          }
+          currentTotalAdditionalFeesSet {
+            presentmentMoney {
+              amount
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          currentTotalDiscountsSet {
+            presentmentMoney {
+              amount
+              currencyCode
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          currentTotalDutiesSet {
+            presentmentMoney {
+              amount
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          currentTotalPriceSet {
+            presentmentMoney {
+              amount
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          currentTotalTaxSet {
+            presentmentMoney {
+              amount
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          currentTotalWeight
+          customer {
+            id
+            lastName
+            defaultEmailAddress {
+              emailAddress
+            }
+            displayName
+            firstName
+          }
+          customerAcceptsMarketing
+          discountCodes
+          discountCode
+          displayAddress {
+            address1
+            address2
+            city
+            company
+            country
+            countryCodeV2
+            firstName
+            formattedArea
+            id
+            lastName
+            name
+            phone
+            province
+            provinceCode
+            timeZone
+            zip
+          }
+          displayFinancialStatus
+          displayFulfillmentStatus
+          dutiesIncluded
+          edited
+          email
+          estimatedTaxes
+          fulfillable
+          fulfillments(first: 20) {
+            createdAt
+            deliveredAt
+            displayStatus
+            estimatedDeliveryAt
+            updatedAt
+            trackingInfo(first: 10) {
+              company
+              url
+            }
+            totalQuantity
+            status
+            name
+            id
+          }
+          fullyPaid
+          id
+          lineItems(first: 50) {
+            edges {
+              node {
+                id
+                name
+                originalUnitPriceSet {
+                  presentmentMoney {
+                    amount
+                    currencyCode
+                  }
+                  shopMoney {
+                    amount
+                    currencyCode
+                  }
+                }
+                quantity
+                requiresShipping
+                sku
+                title
+                variantTitle
+              }
+            }
+          }
+          name
+          note
+          processedAt
+          shippingAddress {
+            address1
+            address2
+            city
+            company
+            country
+            countryCodeV2
+            firstName
+            formattedArea
+            id
+            lastName
+            name
+            phone
+            province
+            provinceCode
+            timeZone
+            zip
+          }
+          statusPageUrl
+          tags
+          totalPriceSet {
+            presentmentMoney {
+              amount
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          totalReceivedSet {
+            presentmentMoney {
+              amount
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          totalRefundedSet {
+            presentmentMoney {
+              amount
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          totalShippingPriceSet {
+            presentmentMoney {
+              amount
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          totalTaxSet {
+            presentmentMoney {
+              amount
+              currencyCode
+            }
+            shopMoney {
+              amount
+              currencyCode
+            }
+          }
+          totalWeight
+          unpaid
+          updatedAt
+        }
+      }
+      pageInfo {
+        hasNextPage
+        endCursor
+      }
+    }
+  }
+`;
+//# sourceMappingURL=getOrderByName.queries.js.map

package/dist/queries/orders/getOrderByName.queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrderByName.queries.js","sourceRoot":"","sources":["../../../src/queries/orders/getOrderByName.queries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAExC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCnC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAySvC,CAAA"}

package/dist/queries/orders/getOrderByName.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getOrderByName.test.d.ts.map

package/dist/queries/orders/getOrderByName.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrderByName.test.d.ts","sourceRoot":"","sources":["../../../src/queries/orders/getOrderByName.test.ts"],"names":[],"mappings":""}

package/dist/queries/orders/getOrderByName.test.js

@@ -0,0 +1,28 @@
+import { graphql, passthrough } from 'msw';
+import { describe, expect, it } from 'vitest';
+import { server } from '../../utils/mswHandlers';
+import { getOrderByName } from './getOrderByName';
+import { expectedLeanOrder } from './getOrderByName.mock';
+describe('getOrderByName - Using Mock Infrastructure', () => {
+    it('should return lean order when found', async () => {
+        const result = await getOrderByName('B12345');
+        expect(result).toEqual(expectedLeanOrder);
+    });
+    it('should return lean order when explicitly requesting lean detail', async () => {
+        const result = await getOrderByName('B12345', 'lean');
+        expect(result).toEqual(expectedLeanOrder);
+    });
+    it('should return full order when requesting full detail', async () => {
+        const result = await getOrderByName('B12345', 'full');
+        expect(result).not.toBeNull();
+        expect(result?.name).toBe('B12345');
+        expect(result?.id).toBe('gid://shopify/Order/12345');
+        expect(result?.customer?.displayName).toBe('John Doe');
+    });
+    it('should return null when order not found', async () => {
+        server.use(graphql.query('ordersByName', () => passthrough()));
+        const result = await getOrderByName('NONEXISTENT');
+        expect(result).toBeNull();
+    });
+});
+//# sourceMappingURL=getOrderByName.test.js.map

package/dist/queries/orders/getOrderByName.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrderByName.test.js","sourceRoot":"","sources":["../../../src/queries/orders/getOrderByName.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,KAAK,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEzD,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAA;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAErD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC7B,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACnC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;QACpD,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;QAC9D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,aAAa,CAAC,CAAA;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAA;IAC3B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}