@ehrenkind/shopify-lib 0.0.7 → 0.2.0

package/dist/queries/orders/getOrderById.js

@@ -0,0 +1,125 @@
+import z from 'zod';
+import { logger } from '../../utils/logger.js';
+import { convertIdIntoGid, fetchShopifyGraphql, } from '../../utils/shopifyFetch.js';
+import { returnOutputParsed } from '../../utils/zod.js';
+import { queryOrderById, queryOrderByIdFull } from './getOrderById.queries.js';
+// Address schema (shared between lean and full)
+const AddressSchema = z
+    .object({
+    firstName: z.string().nullable(),
+    lastName: z.string().nullable(),
+    address1: z.string().nullable(),
+    address2: z.string().nullable(),
+    city: z.string().nullable(),
+    province: z.string().nullable(),
+    country: z.string().nullable(),
+    zip: z.string().nullable(),
+})
+    .nullable();
+// Lean order schema
+const GetLeanOrderByIdReturn = z
+    .object({
+    id: z.string(),
+    name: z.string(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    cancelledAt: z.string().nullable(),
+    cancelReason: z.string().nullable(),
+    totalPrice: z.object({
+        amount: z.string(),
+        currencyCode: z.string(),
+    }),
+    customer: z
+        .object({
+        id: z.string(),
+        displayName: z.string(),
+        firstName: z.string().nullable(),
+        lastName: z.string().nullable(),
+        emailAddress: z.string().nullable(),
+    })
+        .nullable(),
+    financialStatus: z.string().nullable(),
+    fulfillmentStatus: z.string().nullable(),
+    shippingAddress: AddressSchema,
+})
+    .nullable();
+/**
+ * Retrieves a single order from Shopify by its numeric ID.
+ * Returns null if no order is found with the specified ID.
+ *
+ * @param {bigint} id - The numerical Shopify order ID (e.g., 12345678n).
+ * @param {OrderDetailLevel} detailLevel - The level of detail to return ('lean' or 'full'). Defaults to 'lean'.
+ * @returns {Promise<LeanOrder | FullOrder>} 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 getOrderById(id, detailLevel = 'lean') {
+    if (detailLevel === 'lean') {
+        return getLeanOrderById(id);
+    }
+    return getFullOrderById(id);
+}
+async function getLeanOrderById(id) {
+    const variables = {
+        id: convertIdIntoGid(id, 'Order'),
+    };
+    const response = await fetchShopifyGraphql({
+        query: queryOrderById,
+        variables,
+    });
+    if (!response.order) {
+        logger.debug(`No order found with ID: ${id}`);
+        return null;
+    }
+    const order = response.order;
+    const leanOrder = {
+        id: order.id,
+        name: order.name,
+        createdAt: order.createdAt,
+        updatedAt: order.updatedAt,
+        cancelledAt: order.cancelledAt ?? null,
+        cancelReason: order.cancelReason ?? null,
+        totalPrice: {
+            amount: order.totalPriceSet?.shopMoney?.amount ?? '',
+            currencyCode: order.totalPriceSet?.shopMoney?.currencyCode ?? '',
+        },
+        customer: order.customer
+            ? {
+                id: order.customer.id,
+                displayName: order.customer.displayName,
+                firstName: order.customer.firstName ?? null,
+                lastName: order.customer.lastName ?? null,
+                emailAddress: order.customer.defaultEmailAddress?.emailAddress ?? null,
+            }
+            : null,
+        financialStatus: order.displayFinancialStatus ?? null,
+        fulfillmentStatus: order.displayFulfillmentStatus ?? null,
+        shippingAddress: order.shippingAddress
+            ? {
+                firstName: order.shippingAddress.firstName ?? null,
+                lastName: order.shippingAddress.lastName ?? null,
+                address1: order.shippingAddress.address1 ?? null,
+                address2: order.shippingAddress.address2 ?? null,
+                city: order.shippingAddress.city ?? null,
+                province: order.shippingAddress.province ?? null,
+                country: order.shippingAddress.country ?? null,
+                zip: order.shippingAddress.zip ?? null,
+            }
+            : null,
+    };
+    return await returnOutputParsed(leanOrder, GetLeanOrderByIdReturn);
+}
+async function getFullOrderById(id) {
+    const variables = {
+        id: convertIdIntoGid(id, 'Order'),
+    };
+    const response = await fetchShopifyGraphql({
+        query: queryOrderByIdFull,
+        variables,
+    });
+    if (!response.order) {
+        logger.debug(`No order found with ID: ${id}`);
+        return null;
+    }
+    return response.order;
+}
+//# sourceMappingURL=getOrderById.js.map

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

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

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

@@ -0,0 +1,82 @@
+import type { OrderByIdFullQuery, OrderByIdQuery } from '../../generated-api-types/2025-04/admin.generated';
+export declare const orderByIdMock: OrderByIdQuery;
+export declare const expectedLeanOrderById: {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+    cancelledAt: null;
+    cancelReason: null;
+    totalPrice: {
+        amount: string;
+        currencyCode: string;
+    };
+    customer: {
+        id: string;
+        displayName: string;
+        firstName: string;
+        lastName: string;
+        emailAddress: string;
+    };
+    financialStatus: string;
+    fulfillmentStatus: string;
+    shippingAddress: {
+        firstName: string;
+        lastName: string;
+        address1: string;
+        address2: string;
+        city: string;
+        province: string;
+        country: string;
+        zip: string;
+    };
+};
+export declare const orderByIdFullMock: OrderByIdFullQuery;
+export declare const expectedFullOrderById: import("../../generated-api-types/2025-04/admin.types").Maybe<Pick<import("../../generated-api-types/2025-04/admin.types").Order, "id" | "createdAt" | "updatedAt" | "name" | "cancelledAt" | "cancelReason" | "displayFinancialStatus" | "displayFulfillmentStatus" | "closedAt" | "discountCodes" | "processedAt"> & {
+    totalPriceSet: {
+        shopMoney: Pick<import("../../generated-api-types/2025-04/admin.types").MoneyV2, "amount" | "currencyCode">;
+    };
+    customer?: import("../../generated-api-types/2025-04/admin.types").Maybe<Pick<import("../../generated-api-types/2025-04/admin.types").Customer, "id" | "firstName" | "lastName" | "email" | "phone">>;
+    shippingAddress?: import("../../generated-api-types/2025-04/admin.types").Maybe<Pick<import("../../generated-api-types/2025-04/admin.types").MailingAddress, "firstName" | "lastName" | "address1" | "address2" | "city" | "province" | "country" | "zip">>;
+    billingAddress?: import("../../generated-api-types/2025-04/admin.types").Maybe<Pick<import("../../generated-api-types/2025-04/admin.types").MailingAddress, "firstName" | "lastName" | "address1" | "address2" | "city" | "province" | "country" | "zip">>;
+    lineItems: {
+        edges: Array<{
+            node: (Pick<import("../../generated-api-types/2025-04/admin.types").LineItem, "id" | "sku" | "title" | "variantTitle" | "quantity" | "vendor"> & {
+                customAttributes: Array<Pick<import("../../generated-api-types/2025-04/admin.types").Attribute, "key" | "value">>;
+                originalUnitPriceSet: {
+                    shopMoney: Pick<import("../../generated-api-types/2025-04/admin.types").MoneyV2, "amount" | "currencyCode">;
+                };
+                image?: import("../../generated-api-types/2025-04/admin.types").Maybe<Pick<import("../../generated-api-types/2025-04/admin.types").Image, "url" | "width" | "height" | "altText">>;
+            });
+        }>;
+    };
+    fulfillments: Array<(Pick<import("../../generated-api-types/2025-04/admin.types").Fulfillment, "id" | "name" | "totalQuantity" | "status" | "createdAt" | "estimatedDeliveryAt" | "deliveredAt"> & {
+        trackingInfo: Array<Pick<import("../../generated-api-types/2025-04/admin.types").FulfillmentTrackingInfo, "company" | "number" | "url">>;
+        fulfillmentLineItems: {
+            edges: Array<{
+                node: (Pick<import("../../generated-api-types/2025-04/admin.types").FulfillmentLineItem, "id" | "quantity"> & {
+                    lineItem: Pick<import("../../generated-api-types/2025-04/admin.types").LineItem, "id">;
+                });
+            }>;
+        };
+    })>;
+    shippingLine?: import("../../generated-api-types/2025-04/admin.types").Maybe<{
+        originalPriceSet: {
+            shopMoney: Pick<import("../../generated-api-types/2025-04/admin.types").MoneyV2, "amount" | "currencyCode">;
+        };
+    }>;
+    taxLines: Array<{
+        priceSet: {
+            shopMoney: Pick<import("../../generated-api-types/2025-04/admin.types").MoneyV2, "amount" | "currencyCode">;
+        };
+    }>;
+    totalDiscountsSet?: import("../../generated-api-types/2025-04/admin.types").Maybe<{
+        shopMoney: Pick<import("../../generated-api-types/2025-04/admin.types").MoneyV2, "amount" | "currencyCode">;
+    }>;
+    refunds: Array<{
+        totalRefundedSet: {
+            shopMoney: Pick<import("../../generated-api-types/2025-04/admin.types").MoneyV2, "amount" | "currencyCode">;
+        };
+    }>;
+}> | undefined;
+//# sourceMappingURL=getOrderById.mock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getOrderById.mock.d.ts","sourceRoot":"","sources":["../../../src/queries/orders/getOrderById.mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACf,MAAM,mDAAmD,CAAA;AAS1D,eAAO,MAAM,aAAa,EAAE,cAoC3B,CAAA;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BjC,CAAA;AAGD,eAAO,MAAM,iBAAiB,EAAE,kBAkI/B,CAAA;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;qBA9F5B,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8FsD,CAAA"}

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

@@ -0,0 +1,204 @@
+import { CurrencyCode, FulfillmentStatus, OrderDisplayFinancialStatus, OrderDisplayFulfillmentStatus, } from '../../generated-api-types/2025-04/admin.types';
+// Lean order mock
+export const orderByIdMock = {
+    order: {
+        id: 'gid://shopify/Order/12345678901234',
+        name: 'B12345',
+        createdAt: '2023-09-19T16:15:23Z',
+        updatedAt: '2023-09-20T02:13:52Z',
+        cancelledAt: null,
+        cancelReason: null,
+        displayFinancialStatus: OrderDisplayFinancialStatus.Paid,
+        displayFulfillmentStatus: OrderDisplayFulfillmentStatus.Fulfilled,
+        totalPriceSet: {
+            shopMoney: {
+                amount: '139.0',
+                currencyCode: CurrencyCode.Eur,
+            },
+        },
+        customer: {
+            id: 'gid://shopify/Customer/98765432101234',
+            lastName: 'Doe',
+            displayName: 'John Doe',
+            firstName: 'John',
+            defaultEmailAddress: {
+                emailAddress: 'john.doe@example.com',
+            },
+        },
+        shippingAddress: {
+            firstName: 'John',
+            lastName: 'Doe',
+            address1: '123 Main Street',
+            address2: 'Apt 4B',
+            city: 'Berlin',
+            province: 'Berlin',
+            country: 'Germany',
+            zip: '10115',
+        },
+    },
+};
+export const expectedLeanOrderById = {
+    id: 'gid://shopify/Order/12345678901234',
+    name: 'B12345',
+    createdAt: '2023-09-19T16:15:23Z',
+    updatedAt: '2023-09-20T02:13:52Z',
+    cancelledAt: null,
+    cancelReason: null,
+    totalPrice: {
+        amount: '139.0',
+        currencyCode: 'EUR',
+    },
+    customer: {
+        id: 'gid://shopify/Customer/98765432101234',
+        displayName: 'John Doe',
+        firstName: 'John',
+        lastName: 'Doe',
+        emailAddress: 'john.doe@example.com',
+    },
+    financialStatus: 'PAID',
+    fulfillmentStatus: 'FULFILLED',
+    shippingAddress: {
+        firstName: 'John',
+        lastName: 'Doe',
+        address1: '123 Main Street',
+        address2: 'Apt 4B',
+        city: 'Berlin',
+        province: 'Berlin',
+        country: 'Germany',
+        zip: '10115',
+    },
+};
+// Full order mock
+export const orderByIdFullMock = {
+    order: {
+        id: 'gid://shopify/Order/12345678901234',
+        name: 'B12345',
+        createdAt: '2023-09-19T16:15:23Z',
+        updatedAt: '2023-09-20T02:13:52Z',
+        processedAt: '2023-09-19T16:15:23Z',
+        closedAt: '2023-09-21T10:00:00Z',
+        cancelledAt: null,
+        cancelReason: null,
+        displayFinancialStatus: OrderDisplayFinancialStatus.Paid,
+        displayFulfillmentStatus: OrderDisplayFulfillmentStatus.Fulfilled,
+        discountCodes: [],
+        totalPriceSet: {
+            shopMoney: {
+                amount: '139.0',
+                currencyCode: CurrencyCode.Eur,
+            },
+        },
+        customer: {
+            id: 'gid://shopify/Customer/98765432101234',
+            firstName: 'John',
+            lastName: 'Doe',
+            email: 'john.doe@example.com',
+            phone: '+49123456789',
+        },
+        shippingAddress: {
+            firstName: 'John',
+            lastName: 'Doe',
+            address1: '123 Main Street',
+            address2: 'Apt 4B',
+            city: 'Berlin',
+            province: 'Berlin',
+            country: 'Germany',
+            zip: '10115',
+        },
+        billingAddress: {
+            firstName: 'John',
+            lastName: 'Doe',
+            address1: '123 Main Street',
+            address2: 'Apt 4B',
+            city: 'Berlin',
+            province: 'Berlin',
+            country: 'Germany',
+            zip: '10115',
+        },
+        lineItems: {
+            edges: [
+                {
+                    node: {
+                        id: 'gid://shopify/LineItem/111111111111',
+                        sku: 'MATTRESS-001',
+                        title: 'Premium Mattress',
+                        variantTitle: 'Queen Size',
+                        quantity: 1,
+                        customAttributes: [{ key: 'color', value: 'white' }],
+                        originalUnitPriceSet: {
+                            shopMoney: {
+                                amount: '129.0',
+                                currencyCode: CurrencyCode.Eur,
+                            },
+                        },
+                        vendor: 'Ehrenkind',
+                        image: {
+                            url: 'https://cdn.shopify.com/mattress.jpg',
+                            width: 800,
+                            height: 600,
+                            altText: 'Premium Mattress',
+                        },
+                    },
+                },
+            ],
+        },
+        fulfillments: [
+            {
+                id: 'gid://shopify/Fulfillment/222222222222',
+                name: '#B12345.1',
+                totalQuantity: 1,
+                status: FulfillmentStatus.Success,
+                createdAt: '2023-09-20T08:00:00Z',
+                estimatedDeliveryAt: '2023-09-22T12:00:00Z',
+                deliveredAt: '2023-09-21T10:00:00Z',
+                trackingInfo: [
+                    {
+                        company: 'DHL',
+                        number: '123456789012',
+                        url: 'https://tracking.dhl.com/123456789012',
+                    },
+                ],
+                fulfillmentLineItems: {
+                    edges: [
+                        {
+                            node: {
+                                id: 'gid://shopify/FulfillmentLineItem/333333333333',
+                                quantity: 1,
+                                lineItem: {
+                                    id: 'gid://shopify/LineItem/111111111111',
+                                },
+                            },
+                        },
+                    ],
+                },
+            },
+        ],
+        shippingLine: {
+            originalPriceSet: {
+                shopMoney: {
+                    amount: '10.0',
+                    currencyCode: CurrencyCode.Eur,
+                },
+            },
+        },
+        taxLines: [
+            {
+                priceSet: {
+                    shopMoney: {
+                        amount: '22.19',
+                        currencyCode: CurrencyCode.Eur,
+                    },
+                },
+            },
+        ],
+        totalDiscountsSet: {
+            shopMoney: {
+                amount: '0.0',
+                currencyCode: CurrencyCode.Eur,
+            },
+        },
+        refunds: [],
+    },
+};
+export const expectedFullOrderById = orderByIdFullMock.order;
+//# sourceMappingURL=getOrderById.mock.js.map

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

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

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

@@ -0,0 +1,3 @@
+export declare const queryOrderById: string;
+export declare const queryOrderByIdFull: string;
+//# sourceMappingURL=getOrderById.queries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getOrderById.queries.d.ts","sourceRoot":"","sources":["../../../src/queries/orders/getOrderById.queries.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,QAsC1B,CAAA;AAED,eAAO,MAAM,kBAAkB,QAoI9B,CAAA"}

package/dist/queries/orders/getOrderById.queries.js

@@ -0,0 +1,174 @@
+import { gql } from '../../utils/logger';
+export const queryOrderById = gql `#graphql
+  query orderById($id: ID!) {
+    order(id: $id) {
+      id
+      name
+      createdAt
+      updatedAt
+      cancelledAt
+      cancelReason
+      totalPriceSet {
+        shopMoney {
+          amount
+          currencyCode
+        }
+      }
+      customer {
+        id
+        lastName
+        defaultEmailAddress {
+          emailAddress
+        }
+        displayName
+        firstName
+      }
+      displayFinancialStatus
+      displayFulfillmentStatus
+      shippingAddress {
+        firstName
+        lastName
+        address1
+        address2
+        city
+        province
+        country
+        zip
+      }
+    }
+  }
+`;
+export const queryOrderByIdFull = gql `#graphql
+  query orderByIdFull($id: ID!) {
+    order(id: $id) {
+      id
+      name
+      createdAt
+      updatedAt
+      processedAt
+      closedAt
+      cancelledAt
+      cancelReason
+      totalPriceSet {
+        shopMoney {
+          amount
+          currencyCode
+        }
+      }
+      customer {
+        id
+        firstName
+        lastName
+        email
+        phone
+      }
+      displayFinancialStatus
+      displayFulfillmentStatus
+      shippingAddress {
+        firstName
+        lastName
+        address1
+        address2
+        city
+        province
+        country
+        zip
+      }
+      billingAddress {
+        firstName
+        lastName
+        address1
+        address2
+        city
+        province
+        country
+        zip
+      }
+      lineItems(first: 100) {
+        edges {
+          node {
+            id
+            sku
+            title
+            variantTitle
+            quantity
+            customAttributes {
+              key
+              value
+            }
+            originalUnitPriceSet {
+              shopMoney {
+                amount
+                currencyCode
+              }
+            }
+            vendor
+            image {
+              url
+              width
+              height
+              altText
+            }
+          }
+        }
+      }
+      fulfillments {
+        id
+        name
+        totalQuantity
+        status
+        createdAt
+        estimatedDeliveryAt
+        deliveredAt
+        trackingInfo {
+          company
+          number
+          url
+        }
+        fulfillmentLineItems(first: 100) {
+          edges {
+            node {
+              id
+              quantity
+              lineItem {
+                id
+              }
+            }
+          }
+        }
+      }
+      shippingLine {
+        originalPriceSet {
+          shopMoney {
+            amount
+            currencyCode
+          }
+        }
+      }
+      taxLines {
+        priceSet {
+          shopMoney {
+            amount
+            currencyCode
+          }
+        }
+      }
+      totalDiscountsSet {
+        shopMoney {
+          amount
+          currencyCode
+        }
+      }
+      discountCodes
+      refunds {
+        totalRefundedSet {
+          shopMoney {
+            amount
+            currencyCode
+          }
+        }
+      }
+    }
+  }
+`;
+//# sourceMappingURL=getOrderById.queries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getOrderById.queries.js","sourceRoot":"","sources":["../../../src/queries/orders/getOrderById.queries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAExC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsChC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoIpC,CAAA"}

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

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

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

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

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

@@ -0,0 +1,46 @@
+import { graphql, passthrough } from 'msw';
+import { describe, expect, it } from 'vitest';
+import { server } from '../../utils/mswHandlers';
+import { getOrderById } from './getOrderById';
+import { expectedFullOrderById, expectedLeanOrderById, } from './getOrderById.mock';
+describe('getOrderById', () => {
+    describe('lean (default)', () => {
+        it('should return lean order when found', async () => {
+            const result = await getOrderById(12345678901234n);
+            expect(result).toEqual(expectedLeanOrderById);
+        });
+        it('should return lean order when explicitly requested', async () => {
+            const result = await getOrderById(12345678901234n, 'lean');
+            expect(result).toEqual(expectedLeanOrderById);
+        });
+    });
+    describe('full', () => {
+        it('should return full order when requested', async () => {
+            const result = await getOrderById(12345678901234n, 'full');
+            expect(result).toEqual(expectedFullOrderById);
+        });
+        it('should include lineItems in full order', async () => {
+            const result = await getOrderById(12345678901234n, 'full');
+            expect(result?.lineItems.edges).toHaveLength(1);
+            expect(result?.lineItems.edges[0]?.node.sku).toBe('MATTRESS-001');
+        });
+        it('should include fulfillments in full order', async () => {
+            const result = await getOrderById(12345678901234n, 'full');
+            expect(result?.fulfillments).toHaveLength(1);
+            expect(result?.fulfillments?.[0]?.trackingInfo[0]?.company).toBe('DHL');
+        });
+    });
+    describe('Live', () => {
+        it('should return null when order not found (lean)', async () => {
+            server.use(graphql.query('orderById', () => passthrough()));
+            const result = await getOrderById(99999999999n);
+            expect(result).toBeNull();
+        });
+        it('should return null when order not found (full)', async () => {
+            server.use(graphql.query('orderByIdFull', () => passthrough()));
+            const result = await getOrderById(99999999999n, 'full');
+            expect(result).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=getOrderById.test.js.map