@ehrenkind/shopify-lib 0.0.2

package/dist/index.cjs

@@ -0,0 +1,752 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  getLeanProductVariants: () => getLeanProductVariants,
+  getOrderByName: () => getOrderByName
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/queries/orders/getOrderByName.ts
+var import_zod3 = __toESM(require("zod"), 1);
+
+// 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
+var import_shopify_api = require("@shopify/shopify-api");
+var import_node = require("@shopify/shopify-api/adapters/node");
+var import_dotenv = __toESM(require("dotenv"), 1);
+var import_zod = require("zod");
+var SHOPIFY_API_VERSION = import_shopify_api.ApiVersion.April25;
+import_dotenv.default.config();
+var envSchema = import_zod.z.object({
+  SHOPIFY_API_KEY: import_zod.z.string({
+    error: () => ({ message: "SHOPIFY_API_KEY is required" })
+  }),
+  SHOPIFY_API_SECRET: import_zod.z.string({
+    error: () => ({ message: "SHOPIFY_API_SECRET is required" })
+  }),
+  SHOPIFY_API_HOSTNAME: import_zod.z.string({
+    error: () => ({ message: "SHOPIFY_API_HOSTNAME is required" })
+  }),
+  SHOPIFY_ACCESS_TOKEN: import_zod.z.string({
+    error: () => ({ message: "SHOPIFY_ACCESS_TOKEN is required" })
+  }),
+  NODE_ENV: import_zod.z.enum(["development", "production", "test"]).default("development")
+});
+var mapLogLevelToShopifySeverity = (level) => {
+  switch (level) {
+    case "silent":
+      return import_shopify_api.LogSeverity.Error;
+    case "debug":
+      return import_shopify_api.LogSeverity.Debug;
+    case "info":
+      return import_shopify_api.LogSeverity.Info;
+    case "warn":
+      return import_shopify_api.LogSeverity.Warning;
+    case "error":
+      return import_shopify_api.LogSeverity.Error;
+    default:
+      return import_shopify_api.LogSeverity.Info;
+  }
+};
+var shopifyGraphqlClient;
+try {
+  const env2 = envSchema.parse(process.env);
+  const shopify = (0, import_shopify_api.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 import_shopify_api.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 import_zod.z.ZodError) {
+    const msg = import_zod.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
+var import_zod2 = __toESM(require("zod"), 1);
+async function returnOutputParsed(data, Model) {
+  const parsed = await Model.safeParseAsync(data);
+  if (!parsed.success) {
+    if (parsed.error instanceof import_zod2.default.ZodError) {
+      const msg = import_zod2.default.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 = import_zod3.default.object({
+  id: import_zod3.default.string(),
+  name: import_zod3.default.string(),
+  createdAt: import_zod3.default.string(),
+  updatedAt: import_zod3.default.string(),
+  totalPrice: import_zod3.default.object({
+    amount: import_zod3.default.string(),
+    currencyCode: import_zod3.default.string()
+  }),
+  customer: import_zod3.default.object({
+    id: import_zod3.default.string(),
+    displayName: import_zod3.default.string(),
+    emailAddress: import_zod3.default.string().nullable()
+  }).nullable(),
+  financialStatus: import_zod3.default.string().nullable(),
+  fulfillmentStatus: import_zod3.default.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
+var import_zod5 = __toESM(require("zod"), 1);
+var GetLeanProductVariantsReturn = import_zod5.default.array(
+  import_zod5.default.object({
+    productId: import_zod5.default.string(),
+    productTitle: import_zod5.default.string(),
+    variantId: import_zod5.default.string(),
+    variantTitle: import_zod5.default.string(),
+    sku: import_zod5.default.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);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getLeanProductVariants,
+  getOrderByName
+});
+//# sourceMappingURL=index.cjs.map