@porulle/adapter-shopify 0.73.2 → 0.74.0

package/dist/graphql.d.ts

@@ -28,4 +28,4 @@ export interface ShopifyGraphqlTarget {
  */
 export declare function shopifyGraphql<T>(target: ShopifyGraphqlTarget, query: string, variables: Record<string, unknown>, schema: z.ZodType<T>): Promise<Result<T, ChannelConnectorError>>;
 /** `gid://shopify/<Type>/<id>` for a numeric id; the adapter keys everything by the numeric id. */
-export declare function shopifyGid(type: "Product" | "ProductVariant", id: string): string;
+export declare function shopifyGid(type: "Product" | "ProductVariant" | "InventoryItem" | "Order", id: string): string;

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import type { ChannelConnector } from "@porulle/core";
 export { SHOPIFY_API_VERSION } from "./graphql.js";
 export { CATALOG_ITEMS_QUERY, CATALOG_PAGE_QUERY, VARIANTS_PAGE_QUERY } from "./catalog.js";
+export { INVENTORY_ITEM_VARIANT_QUERY } from "./webhooks.js";
 export { REQUIRED_SCOPES, normalizeShopDomain, parseShopifyCredentials } from "./oauth.js";
 export type { ShopifyCredentials } from "./oauth.js";
 export interface ShopifyConnectorOptions {

package/dist/index.js

@@ -2,10 +2,12 @@ import { createHmac, timingSafeEqual } from "node:crypto";
 import { CHANNEL_CANCEL_REFUSED, CHANNEL_OUT_OF_STOCK, defineChannelConnector, Err, Ok } from "@porulle/core";
 import { z } from "zod";
 import { readCatalogItems, readCatalogPage } from "./catalog.js";
+import { decodeShopifyWebhook } from "./webhooks.js";
 import { shopifyGid, shopifyGraphql } from "./graphql.js";
 import { REQUIRED_SCOPES, buildAuthorizeUrl, exchangeCallback, normalizeShopDomain, parseShopifyCredentials, refreshIfExpiring, validShopDomain, } from "./oauth.js";
 export { SHOPIFY_API_VERSION } from "./graphql.js";
 export { CATALOG_ITEMS_QUERY, CATALOG_PAGE_QUERY, VARIANTS_PAGE_QUERY } from "./catalog.js";
+export { INVENTORY_ITEM_VARIANT_QUERY } from "./webhooks.js";
 export { REQUIRED_SCOPES, normalizeShopDomain, parseShopifyCredentials } from "./oauth.js";
 export const INVENTORY_QUERY = `query PorulleInventoryPage($after: String) {
   productVariants(first: 250, after: $after, sortKey: ID) { pageInfo { hasNextPage endCursor } nodes { legacyResourceId inventoryQuantity } }
@@ -288,7 +290,9 @@ export function shopifyConnector(options) {
             if (!created.ok)
                 return created;
             const { order, userErrors } = created.value.orderCreate;
-            if (userErrors.some((error) => error.code === "INVENTORY_CLAIM_FAILED")) {
+            // Live Shopify (2026-10, measured) refuses stock as `INVALID` on `["order","lineItems"]` with "Line items
+            // Unable to reserve inventory", not the documented `INVENTORY_CLAIM_FAILED`; both are read as out of stock.
+            if (userErrors.some((error) => error.code === "INVENTORY_CLAIM_FAILED" || /unable to reserve inventory/i.test(error.message))) {
                 return Err({ code: CHANNEL_OUT_OF_STOCK, message: `The store does not have the stock: ${userErrors.map((error) => error.message).join("; ")}.`, retriable: false });
             }
             if (userErrors.length > 0 || !order) {
@@ -393,6 +397,9 @@ export function shopifyConnector(options) {
             }
             return Ok({ id, topic, shopDomain, data });
         },
+        async decodeWebhook(store, event) {
+            return decodeShopifyWebhook(target(store), event);
+        },
         async refundExecute() {
             return Err({ code: "NOT_IMPLEMENTED", message: "Refunds are issued by the platform, not executed in the Shopify store." });
         },