@ehrenkind/shopify-lib 0.0.2

package/dist/index.mjs

@@ -0,0 +1,719 @@
+// src/queries/orders/getOrderByName.ts
+import z3 from "zod";
+
+// src/utils/logger.ts
+var { env } = process;
+var gql = String.raw;
+var logLevels = {
+  silent: 0,
+  error: 1,
+  warn: 2,
+  info: 3,
+  debug: 4
+};
+function getLogLevel(nodeEnv, logLevelEnv) {
+  if (logLevelEnv && logLevelEnv in logLevels) {
+    return logLevelEnv;
+  }
+  if (nodeEnv === "test") {
+    return "silent";
+  }
+  if (nodeEnv === "production") {
+    return "info";
+  }
+  return "debug";
+}
+var activeLogLevelName = getLogLevel(env.NODE_ENV, env.LOG_LEVEL);
+var activeLogLevelValue = logLevels[activeLogLevelName];
+var logger = {
+  debug: (...args) => {
+    if (logLevels.debug <= activeLogLevelValue) {
+      console.debug(...args);
+    }
+  },
+  info: (...args) => {
+    if (logLevels.info <= activeLogLevelValue) {
+      console.info(...args);
+    }
+  },
+  warn: (...args) => {
+    if (logLevels.warn <= activeLogLevelValue) {
+      console.warn(...args);
+    }
+  },
+  error: (...args) => {
+    if (logLevels.error <= activeLogLevelValue) {
+      console.error(...args);
+    }
+  }
+};
+
+// src/utils/shopifyClient.ts
+import {
+  ApiVersion,
+  LogSeverity,
+  Session,
+  shopifyApi
+} from "@shopify/shopify-api";
+import "@shopify/shopify-api/adapters/node";
+import dotenv from "dotenv";
+import { z } from "zod";
+var SHOPIFY_API_VERSION = ApiVersion.April25;
+dotenv.config();
+var envSchema = z.object({
+  SHOPIFY_API_KEY: z.string({
+    error: () => ({ message: "SHOPIFY_API_KEY is required" })
+  }),
+  SHOPIFY_API_SECRET: z.string({
+    error: () => ({ message: "SHOPIFY_API_SECRET is required" })
+  }),
+  SHOPIFY_API_HOSTNAME: z.string({
+    error: () => ({ message: "SHOPIFY_API_HOSTNAME is required" })
+  }),
+  SHOPIFY_ACCESS_TOKEN: z.string({
+    error: () => ({ message: "SHOPIFY_ACCESS_TOKEN is required" })
+  }),
+  NODE_ENV: z.enum(["development", "production", "test"]).default("development")
+});
+var mapLogLevelToShopifySeverity = (level) => {
+  switch (level) {
+    case "silent":
+      return LogSeverity.Error;
+    case "debug":
+      return LogSeverity.Debug;
+    case "info":
+      return LogSeverity.Info;
+    case "warn":
+      return LogSeverity.Warning;
+    case "error":
+      return LogSeverity.Error;
+    default:
+      return LogSeverity.Info;
+  }
+};
+var shopifyGraphqlClient;
+try {
+  const env2 = envSchema.parse(process.env);
+  const shopify = shopifyApi({
+    apiKey: env2.SHOPIFY_API_KEY,
+    apiSecretKey: env2.SHOPIFY_API_SECRET,
+    hostName: env2.SHOPIFY_API_HOSTNAME,
+    apiVersion: SHOPIFY_API_VERSION,
+    isEmbeddedApp: false,
+    logger: { level: mapLogLevelToShopifySeverity(activeLogLevelName) },
+    future: {
+      customerAddressDefaultFix: true,
+      lineItemBilling: true,
+      unstable_managedPricingSupport: false
+    }
+  });
+  const shopifySession = new Session({
+    id: `custom-session-${env2.SHOPIFY_API_HOSTNAME}`,
+    shop: env2.SHOPIFY_API_HOSTNAME,
+    state: "authenticated",
+    isOnline: true,
+    accessToken: env2.SHOPIFY_ACCESS_TOKEN
+  });
+  shopifyGraphqlClient = new shopify.clients.Graphql({
+    session: shopifySession
+  });
+  logger.info("Shopify API client initialized successfully.");
+} catch (error) {
+  if (error instanceof z.ZodError) {
+    const msg = z.prettifyError(error);
+    logger.error(msg);
+  } else {
+    logger.error("Failed to initialize Shopify API client:", error);
+  }
+  throw error;
+}
+
+// src/utils/shopifyFetch.ts
+async function fetchShopifyGraphql(params) {
+  const {
+    query,
+    variables: initialVariables,
+    dataExtractor,
+    fetchAllPages = false
+  } = params;
+  const allNodes = [];
+  let currentVariables = { ...initialVariables };
+  let hasNextLoop = true;
+  do {
+    const response = await shopifyGraphqlClient.request(query, {
+      variables: currentVariables
+    });
+    if (response.errors) {
+      let errorMessages = "GraphQL query failed.";
+      const errors = response.errors;
+      if (Array.isArray(errors)) {
+        errorMessages = errors.map((e) => e.message || JSON.stringify(e)).join("\n");
+      } else if (typeof errors === "object" && errors !== null && "message" in errors) {
+        errorMessages = errors.message || JSON.stringify(errors);
+      } else if (typeof errors === "string") {
+        errorMessages = errors;
+      } else {
+        errorMessages = JSON.stringify(errors);
+      }
+      logger.error("GraphQL query failed:", errorMessages);
+      throw new Error(`GraphQL errors: ${errorMessages}`);
+    }
+    if (!response.data) {
+      throw new Error("No data in Shopify API response");
+    }
+    const { nodes, pageInfo, userErrors } = dataExtractor(response.data);
+    if (Array.isArray(userErrors) && userErrors.length > 0) {
+      const errorMessages = userErrors.map((e) => e.message || JSON.stringify(e)).join("\n");
+      logger.error("Shopify mutation userErrors:", errorMessages);
+      throw new Error(`Shopify mutation userErrors: ${errorMessages}`);
+    }
+    allNodes.push(...nodes);
+    hasNextLoop = fetchAllPages ? !!pageInfo?.hasNextPage : false;
+    if (hasNextLoop && pageInfo?.endCursor) {
+      currentVariables = {
+        ...currentVariables,
+        after: pageInfo.endCursor
+      };
+    }
+  } while (hasNextLoop);
+  return allNodes;
+}
+
+// src/utils/zod.ts
+import z2 from "zod";
+async function returnOutputParsed(data, Model) {
+  const parsed = await Model.safeParseAsync(data);
+  if (!parsed.success) {
+    if (parsed.error instanceof z2.ZodError) {
+      const msg = z2.prettifyError(parsed.error);
+      logger.error(msg);
+    } else {
+      logger.error("Failed to parse:", parsed.error);
+    }
+    throw new Error("Failed to parse product variants");
+  }
+  logger.info("Parsed data successfully");
+  return parsed.data;
+}
+
+// src/queries/orders/getOrderByName.queries.ts
+var 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
+      }
+    }
+  }
+`;
+var 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
+      }
+    }
+  }
+`;
+
+// src/queries/orders/getOrderByName.ts
+var GetLeanOrderByNameReturn = z3.object({
+  id: z3.string(),
+  name: z3.string(),
+  createdAt: z3.string(),
+  updatedAt: z3.string(),
+  totalPrice: z3.object({
+    amount: z3.string(),
+    currencyCode: z3.string()
+  }),
+  customer: z3.object({
+    id: z3.string(),
+    displayName: z3.string(),
+    emailAddress: z3.string().nullable()
+  }).nullable(),
+  financialStatus: z3.string().nullable(),
+  fulfillmentStatus: z3.string().nullable()
+}).nullable();
+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;
+}
+
+// src/queries/productVariants/getLeanProductVariants.ts
+import z4 from "zod";
+var GetLeanProductVariantsReturn = z4.array(
+  z4.object({
+    productId: z4.string(),
+    productTitle: z4.string(),
+    variantId: z4.string(),
+    variantTitle: z4.string(),
+    sku: z4.string()
+  })
+);
+async function getLeanProductVariants(skus) {
+  const queryGql = gql`#graphql
+    query leanProductVariants($first: Int!, $after: String, $queryFilter: String) {
+      productVariants(first: $first, after: $after, query: $queryFilter) {
+        edges {
+          node { 
+            id
+            title
+            sku
+            product {
+              id
+              title
+            }
+          }
+        }
+        pageInfo { 
+          hasNextPage
+          endCursor
+        }
+      }
+    }
+  `;
+  const initialVariables = { first: 250 };
+  if (skus && skus.length > 0) {
+    initialVariables.queryFilter = skus.map((sku) => `sku:${sku}`).join(" OR ");
+  }
+  const extractedNodes = await fetchShopifyGraphql({
+    query: queryGql,
+    variables: initialVariables,
+    dataExtractor: (pageData) => {
+      if (!pageData.productVariants) {
+        throw new Error(
+          "GraphQL response for product variants is missing the 'productVariants' field."
+        );
+      }
+      const nodes = pageData.productVariants.edges.map(
+        (edge) => edge.node
+      );
+      return {
+        nodes,
+        pageInfo: pageData.productVariants.pageInfo
+      };
+    },
+    fetchAllPages: true
+  });
+  const allVariants = extractedNodes.flatMap((v) => {
+    if (v.sku) {
+      return [
+        {
+          productId: v.product.id,
+          productTitle: v.product.title,
+          variantId: v.id,
+          variantTitle: v.title,
+          sku: v.sku
+        }
+      ];
+    }
+    logger.debug(
+      `Product ${v.product.title} (ID: ${v.product.id}) has a variant (ID: ${v.id}) with no SKU. Filtering out.`
+    );
+    return [];
+  });
+  return await returnOutputParsed(allVariants, GetLeanProductVariantsReturn);
+}
+export {
+  getLeanProductVariants,
+  getOrderByName
+};
+//# sourceMappingURL=index.mjs.map