@useairfoil/producer-shopify 0.2.0 → 0.2.1

package/src/resources/orders/webhook.ts

@@ -0,0 +1,248 @@
+import * as Schema from "effect/Schema";
+
+import {
+  RestAddressSchema,
+  RestAttributeSchema,
+  RestDiscountAllocationSchema,
+  RestMoneyBagSchema,
+  RestTaxLineSchema,
+  emptyText,
+  fromRest,
+  gid,
+  normalizeAmount,
+  splitTags,
+  upper,
+} from "../shared";
+import {
+  DiscountAllocationMethodSchema,
+  type DiscountApplication,
+  DiscountApplicationTypeSchema,
+  DiscountTargetSelectionSchema,
+  DiscountTargetTypeSchema,
+  DiscountValueTypeSchema,
+  OrderCancelReasonSchema,
+  OrderFinancialStatusSchema,
+  type Order,
+} from "./row";
+
+const nullableMoney = Schema.NullOr(RestMoneyBagSchema);
+
+const RestShippingLineSchema = Schema.Struct({
+  id: Schema.NullOr(Schema.Number),
+  title: Schema.String,
+  code: Schema.NullOr(Schema.String),
+  source: Schema.NullOr(Schema.String),
+  carrier_identifier: Schema.NullOr(Schema.String),
+  phone: Schema.NullOr(Schema.String),
+  is_removed: Schema.Boolean,
+  price_set: RestMoneyBagSchema,
+  discounted_price_set: RestMoneyBagSchema,
+  current_discounted_price_set: RestMoneyBagSchema,
+  tax_lines: Schema.Array(RestTaxLineSchema),
+  discount_allocations: Schema.Array(RestDiscountAllocationSchema),
+});
+
+const RestLineItemSchema = Schema.Struct({
+  admin_graphql_api_id: Schema.String,
+  name: Schema.String,
+  title: Schema.String,
+  variant_title: Schema.NullOr(Schema.String),
+  sku: Schema.NullOr(Schema.String),
+  vendor: Schema.NullOr(Schema.String),
+  product_id: Schema.NullOr(Schema.Number),
+  variant_id: Schema.NullOr(Schema.Number),
+  quantity: Schema.Int,
+  current_quantity: Schema.Int,
+  taxable: Schema.Boolean,
+  requires_shipping: Schema.Boolean,
+  gift_card: Schema.Boolean,
+  price_set: RestMoneyBagSchema,
+  total_discount_set: RestMoneyBagSchema,
+  tax_lines: Schema.Array(RestTaxLineSchema),
+  discount_allocations: Schema.Array(RestDiscountAllocationSchema),
+  properties: Schema.Array(RestAttributeSchema),
+});
+
+const RestDiscountApplicationSchema = Schema.Struct({
+  type: upper(DiscountApplicationTypeSchema),
+  code: Schema.optional(Schema.NullOr(Schema.String)),
+  title: Schema.optional(Schema.NullOr(Schema.String)),
+  description: Schema.optional(Schema.NullOr(Schema.String)),
+  allocation_method: upper(DiscountAllocationMethodSchema),
+  target_selection: upper(DiscountTargetSelectionSchema),
+  target_type: upper(DiscountTargetTypeSchema),
+  value_type: upper(DiscountValueTypeSchema),
+  value: Schema.String,
+});
+
+export const OrderWebhookPayloadSchema = Schema.Struct({
+  id: Schema.Number,
+  admin_graphql_api_id: Schema.String,
+  name: Schema.String,
+  email: Schema.NullOr(Schema.String),
+  phone: Schema.NullOr(Schema.String),
+  customer: Schema.NullOr(Schema.Struct({ admin_graphql_api_id: Schema.String })),
+  customer_locale: Schema.NullOr(Schema.String),
+  buyer_accepts_marketing: Schema.Boolean,
+  billing_address: Schema.NullOr(RestAddressSchema),
+  shipping_address: Schema.NullOr(RestAddressSchema),
+  note: Schema.NullOr(Schema.String),
+  note_attributes: Schema.Array(RestAttributeSchema),
+  tags: Schema.String,
+  confirmation_number: Schema.NullOr(Schema.String),
+  po_number: Schema.NullOr(Schema.String),
+  source_name: Schema.NullOr(Schema.String),
+  source_identifier: Schema.NullOr(Schema.String),
+  app_id: Schema.NullOr(Schema.Number),
+  payment_gateway_names: Schema.Array(Schema.String),
+  test: Schema.Boolean,
+  taxes_included: Schema.Boolean,
+  tax_exempt: Schema.Boolean,
+  duties_included: Schema.Boolean,
+  estimated_taxes: Schema.Boolean,
+  total_weight: Schema.NullOr(Schema.Int),
+  financial_status: Schema.NullOr(upper(OrderFinancialStatusSchema)),
+  cancel_reason: Schema.NullOr(upper(OrderCancelReasonSchema)),
+  cancelled_at: Schema.NullOr(Schema.DateFromString),
+  closed_at: Schema.NullOr(Schema.DateFromString),
+  processed_at: Schema.DateFromString,
+  created_at: Schema.DateFromString,
+  updated_at: Schema.DateFromString,
+  currency: Schema.String,
+  presentment_currency: Schema.String,
+  discount_codes: Schema.Array(Schema.Struct({ code: Schema.String })),
+  discount_applications: Schema.Array(RestDiscountApplicationSchema),
+  subtotal_price_set: nullableMoney,
+  current_subtotal_price_set: RestMoneyBagSchema,
+  total_discounts_set: nullableMoney,
+  current_total_discounts_set: RestMoneyBagSchema,
+  total_shipping_price_set: RestMoneyBagSchema,
+  current_shipping_price_set: RestMoneyBagSchema,
+  total_tax_set: nullableMoney,
+  current_total_tax_set: RestMoneyBagSchema,
+  original_total_duties_set: nullableMoney,
+  current_total_duties_set: nullableMoney,
+  total_price_set: RestMoneyBagSchema,
+  current_total_price_set: RestMoneyBagSchema,
+  tax_lines: Schema.Array(RestTaxLineSchema),
+  shipping_lines: Schema.Array(RestShippingLineSchema),
+  line_items: Schema.Array(RestLineItemSchema),
+});
+
+export const OrderDeleteWebhookPayloadSchema = Schema.Struct({ id: Schema.Number });
+
+export const OrderEventSchema = Schema.Union([
+  Schema.Struct({
+    _tag: Schema.Literal("upsert"),
+    payload: Schema.toType(OrderWebhookPayloadSchema),
+  }),
+  Schema.Struct({
+    _tag: Schema.Literal("delete"),
+    id: Schema.String,
+    version: Schema.Date,
+  }),
+]);
+
+export type OrderWebhookPayload = Schema.Schema.Type<typeof OrderWebhookPayloadSchema>;
+
+const orMoney = (bag: Schema.Schema.Type<typeof RestMoneyBagSchema> | null) =>
+  bag === null ? null : fromRest.money(bag);
+
+export const fromOrderWebhook = (payload: OrderWebhookPayload): Order => ({
+  id: payload.admin_graphql_api_id,
+  legacyResourceId: String(payload.id),
+  name: payload.name,
+  email: emptyText(payload.email),
+  phone: emptyText(payload.phone),
+  customerId: payload.customer?.admin_graphql_api_id ?? "",
+  customerLocale: emptyText(payload.customer_locale),
+  customerAcceptsMarketing: payload.buyer_accepts_marketing,
+  billingAddress: payload.billing_address ? fromRest.address(payload.billing_address) : null,
+  shippingAddress: payload.shipping_address ? fromRest.address(payload.shipping_address) : null,
+  note: emptyText(payload.note),
+  customAttributes: payload.note_attributes.map(fromRest.attribute),
+  tags: splitTags(payload.tags),
+  confirmationNumber: emptyText(payload.confirmation_number),
+  poNumber: emptyText(payload.po_number),
+  sourceName: emptyText(payload.source_name),
+  sourceIdentifier: emptyText(payload.source_identifier),
+  appId: payload.app_id === null ? "" : gid("App", payload.app_id),
+  paymentGatewayNames: payload.payment_gateway_names,
+  test: payload.test,
+  taxesIncluded: payload.taxes_included,
+  taxExempt: payload.tax_exempt,
+  dutiesIncluded: payload.duties_included,
+  estimatedTaxes: payload.estimated_taxes,
+  totalWeight: payload.total_weight,
+  displayFinancialStatus: payload.financial_status,
+  cancelReason: payload.cancel_reason,
+  cancelledAt: payload.cancelled_at,
+  closedAt: payload.closed_at,
+  processedAt: payload.processed_at,
+  createdAt: payload.created_at,
+  updatedAt: payload.updated_at,
+  currencyCode: payload.currency,
+  presentmentCurrencyCode: payload.presentment_currency,
+  discountCodes: payload.discount_codes.map((discount) => discount.code),
+  discountApplications: payload.discount_applications.map(
+    (application, index): DiscountApplication => ({
+      index,
+      type: application.type,
+      code: application.type === "DISCOUNT_CODE" ? (application.code ?? null) : null,
+      title: application.type === "DISCOUNT_CODE" ? null : (application.title ?? null),
+      description: application.type === "MANUAL" ? (application.description ?? null) : null,
+      allocationMethod: application.allocation_method,
+      targetSelection: application.target_selection,
+      targetType: application.target_type,
+      valueType: application.value_type,
+      value: normalizeAmount(application.value),
+    }),
+  ),
+  subtotalPriceSet: orMoney(payload.subtotal_price_set),
+  currentSubtotalPriceSet: fromRest.money(payload.current_subtotal_price_set),
+  totalDiscountsSet: orMoney(payload.total_discounts_set),
+  currentTotalDiscountsSet: fromRest.money(payload.current_total_discounts_set),
+  totalShippingPriceSet: fromRest.money(payload.total_shipping_price_set),
+  currentShippingPriceSet: fromRest.money(payload.current_shipping_price_set),
+  totalTaxSet: orMoney(payload.total_tax_set),
+  currentTotalTaxSet: fromRest.money(payload.current_total_tax_set),
+  originalTotalDutiesSet: orMoney(payload.original_total_duties_set),
+  currentTotalDutiesSet: orMoney(payload.current_total_duties_set),
+  totalPriceSet: fromRest.money(payload.total_price_set),
+  currentTotalPriceSet: fromRest.money(payload.current_total_price_set),
+  taxLines: payload.tax_lines.map(fromRest.taxLine),
+  shippingLines: payload.shipping_lines.map((line) => ({
+    id: line.id === null ? null : gid("ShippingLine", line.id),
+    title: line.title,
+    code: line.code,
+    source: line.source,
+    carrierIdentifier: line.carrier_identifier,
+    phone: line.phone,
+    isRemoved: line.is_removed,
+    originalPriceSet: fromRest.money(line.price_set),
+    discountedPriceSet: fromRest.money(line.discounted_price_set),
+    currentDiscountedPriceSet: fromRest.money(line.current_discounted_price_set),
+    taxLines: line.tax_lines.map(fromRest.taxLine),
+    discountAllocations: line.discount_allocations.map(fromRest.discountAllocation),
+  })),
+  lineItems: payload.line_items.map((item) => ({
+    id: item.admin_graphql_api_id,
+    name: item.name,
+    title: item.title,
+    variantTitle: item.variant_title,
+    sku: item.sku,
+    vendor: item.vendor,
+    productId: item.product_id === null ? null : gid("Product", item.product_id),
+    variantId: item.variant_id === null ? null : gid("ProductVariant", item.variant_id),
+    quantity: item.quantity,
+    currentQuantity: item.current_quantity,
+    taxable: item.taxable,
+    requiresShipping: item.requires_shipping,
+    isGiftCard: item.gift_card,
+    originalUnitPriceSet: fromRest.money(item.price_set),
+    totalDiscountSet: fromRest.money(item.total_discount_set),
+    taxLines: item.tax_lines.map(fromRest.taxLine),
+    discountAllocations: item.discount_allocations.map(fromRest.discountAllocation),
+    customAttributes: item.properties.map(fromRest.attribute),
+  })),
+});

package/src/resources/products/graphql.ts

@@ -0,0 +1,142 @@
+import * as Schema from "effect/Schema";
+
+import { connection, pageQuery } from "../shared";
+import {
+  type Product,
+  ProductOptionSchema,
+  ProductStatusSchema,
+  ProductVariantInventoryPolicySchema,
+} from "./row";
+
+const ProductVariantFields = `
+  id
+  legacyResourceId
+  title
+  sku
+  barcode
+  price
+  compareAtPrice
+  inventoryPolicy
+  taxable
+  createdAt
+  updatedAt
+`;
+
+const ProductFields = `
+  id
+  legacyResourceId
+  title
+  handle
+  descriptionHtml
+  productType
+  vendor
+  status
+  tags
+  createdAt
+  updatedAt
+  publishedAt
+  templateSuffix
+  featuredMedia { ... on MediaImage { image { url altText } } }
+  options(first: 100) { id name position values }
+  variants(first: 25) { nodes { ${ProductVariantFields} } pageInfo { hasNextPage endCursor } }
+`;
+
+export const ProductByIdQuery = `#graphql
+query AirfoilProductById($id: ID!) {
+  product(id: $id) { ${ProductFields} }
+}
+`;
+
+export const ProductVariantsQuery = `#graphql
+query AirfoilProductVariants($id: ID!, $first: Int!, $after: String) {
+  node: product(id: $id) {
+    connection: variants(first: $first, after: $after) {
+      nodes { ${ProductVariantFields} }
+      pageInfo { hasNextPage endCursor }
+    }
+  }
+}
+`;
+
+export const ProductsQuery = pageQuery("AirfoilProducts", "products", ProductFields);
+
+export const GraphQLProductVariantNodeSchema = Schema.Struct({
+  id: Schema.String,
+  legacyResourceId: Schema.String,
+  title: Schema.String,
+  sku: Schema.NullOr(Schema.String),
+  barcode: Schema.NullOr(Schema.String),
+  price: Schema.String,
+  compareAtPrice: Schema.NullOr(Schema.String),
+  inventoryPolicy: ProductVariantInventoryPolicySchema,
+  taxable: Schema.Boolean,
+  createdAt: Schema.DateFromString,
+  updatedAt: Schema.DateFromString,
+});
+
+const GraphQLFeaturedMediaSchema = Schema.Struct({
+  image: Schema.optional(
+    Schema.NullOr(
+      Schema.Struct({
+        url: Schema.String,
+        altText: Schema.NullOr(Schema.String),
+      }),
+    ),
+  ),
+});
+
+const GraphQLProductNodeSchema = Schema.Struct({
+  id: Schema.String,
+  legacyResourceId: Schema.String,
+  title: Schema.String,
+  handle: Schema.String,
+  descriptionHtml: Schema.String,
+  productType: Schema.String,
+  vendor: Schema.String,
+  status: ProductStatusSchema,
+  tags: Schema.Array(Schema.String),
+  createdAt: Schema.DateFromString,
+  updatedAt: Schema.DateFromString,
+  publishedAt: Schema.NullOr(Schema.DateFromString),
+  templateSuffix: Schema.NullOr(Schema.String),
+  featuredMedia: Schema.NullOr(GraphQLFeaturedMediaSchema),
+  options: Schema.Array(ProductOptionSchema),
+  variants: connection(GraphQLProductVariantNodeSchema),
+});
+
+export const GraphQLProductsDataSchema = Schema.Struct({
+  products: connection(GraphQLProductNodeSchema),
+});
+
+export const GraphQLProductByIdDataSchema = Schema.Struct({
+  product: Schema.NullOr(GraphQLProductNodeSchema),
+});
+
+export type GraphQLProductNode = Schema.Schema.Type<typeof GraphQLProductNodeSchema>;
+
+type GraphQLProductVariantNode = Schema.Schema.Type<typeof GraphQLProductVariantNodeSchema>;
+
+export const normalizeProductNode = (
+  node: GraphQLProductNode,
+  variants: ReadonlyArray<GraphQLProductVariantNode>,
+): Product => ({
+  id: node.id,
+  legacyResourceId: node.legacyResourceId,
+  title: node.title,
+  handle: node.handle,
+  descriptionHtml: node.descriptionHtml,
+  productType: node.productType,
+  vendor: node.vendor,
+  status: node.status,
+  tags: node.tags,
+  createdAt: node.createdAt,
+  updatedAt: node.updatedAt,
+  publishedAt: node.publishedAt,
+  templateSuffix: node.templateSuffix ?? "",
+  featuredMedia:
+    node.featuredMedia === null || node.featuredMedia.image === undefined
+      ? null
+      : { image: node.featuredMedia.image },
+  options: node.options,
+  variants,
+});

package/src/resources/products/row.ts

@@ -0,0 +1,92 @@
+import { Iceberg } from "@useairfoil/connector-kit";
+import * as Schema from "effect/Schema";
+
+import { field } from "../shared";
+
+export const ProductStatusSchema = Schema.Literals(["ACTIVE", "ARCHIVED", "DRAFT", "UNLISTED"]);
+
+export const ProductVariantInventoryPolicySchema = Schema.Literals(["CONTINUE", "DENY"]);
+
+const ProductImageSchema = Schema.Struct({
+  url: Schema.String.pipe(field(202, "URL of the image.")),
+  altText: Schema.NullOr(Schema.String).pipe(field(203, "Alternative text for the image.")),
+});
+
+export const ProductFeaturedMediaSchema = Schema.Struct({
+  image: Schema.NullOr(ProductImageSchema).pipe(field(201, "Image for the featured media.")),
+});
+
+export const ProductOptionSchema = Schema.Struct({
+  id: Schema.String.pipe(field(302, "Unique product option identifier.")),
+  name: Schema.String.pipe(field(303, "Name of the product option.")),
+  position: Schema.Int.pipe(field(304, "Position of the option on the product.")),
+  values: Schema.Array(Schema.String.annotate({ fieldId: 306 })).pipe(
+    field(305, "Values available for the option."),
+  ),
+});
+
+export const ProductVariantSchema = Schema.Struct({
+  id: Schema.String.pipe(field(402, "Unique product variant identifier.")),
+  legacyResourceId: Schema.String.pipe(field(403, "Numeric variant identifier stored as text.")),
+  title: Schema.String.pipe(field(404, "Display title of the variant.")),
+  sku: Schema.NullOr(Schema.String).pipe(field(405, "Stock keeping unit for the variant.")),
+  barcode: Schema.NullOr(Schema.String).pipe(field(406, "Barcode for the variant.")),
+  price: Schema.String.pipe(field(407, "Price of the variant.")),
+  compareAtPrice: Schema.NullOr(Schema.String).pipe(
+    field(408, "Original price used for comparison."),
+  ),
+  inventoryPolicy: ProductVariantInventoryPolicySchema.pipe(
+    field(409, "Behavior when the variant is out of stock."),
+  ),
+  taxable: Schema.Boolean.pipe(field(410, "Whether the variant is taxable.")),
+  createdAt: Schema.Date.pipe(field(411, "Time when the variant was created.")),
+  updatedAt: Schema.Date.pipe(field(412, "Time when the variant was last changed.")),
+});
+
+export const ProductSchema = Schema.Struct({
+  id: Schema.String.pipe(field(1, "Unique product identifier.")),
+  legacyResourceId: Schema.String.pipe(field(2, "Numeric product identifier stored as text.")),
+  title: Schema.String.pipe(field(3, "Title of the product.")),
+  handle: Schema.String.pipe(field(4, "URL handle for the product.")),
+  descriptionHtml: Schema.String.pipe(field(5, "Product description as HTML.")),
+  productType: Schema.String.pipe(field(6, "Merchant-defined product type.")),
+  vendor: Schema.String.pipe(field(7, "Vendor of the product.")),
+  status: ProductStatusSchema.pipe(field(8, "Current product status.")),
+  tags: Schema.Array(Schema.String.annotate({ fieldId: 101 })).pipe(
+    field(9, "Tags added to the product."),
+  ),
+  createdAt: Schema.Date.pipe(field(10, "Time when the product was created.")),
+  updatedAt: Schema.Date.pipe(field(11, "Time when the product was last changed.")),
+  publishedAt: Schema.NullOr(Schema.Date).pipe(field(12, "Time when the product was published.")),
+  templateSuffix: Schema.NullOr(Schema.String).pipe(
+    field(13, "Theme template suffix used by the product."),
+  ),
+  featuredMedia: Schema.NullOr(ProductFeaturedMediaSchema).pipe(
+    field(14, "Featured media for the product."),
+  ),
+  options: Schema.Array(ProductOptionSchema.annotate({ fieldId: 301 })).pipe(
+    field(15, "Options for the product."),
+  ),
+  variants: Schema.Array(ProductVariantSchema.annotate({ fieldId: 401 })).pipe(
+    field(16, "Variants of the product."),
+  ),
+  _deleted: Schema.optional(Schema.Boolean).pipe(field(17, "Whether the product was deleted.")),
+})
+  .annotate({
+    description: "Products in a Shopify store.",
+  })
+  .pipe(Iceberg.identifier("id"));
+
+export type ProductStatus = Schema.Schema.Type<typeof ProductStatusSchema>;
+
+export type ProductVariantInventoryPolicy = Schema.Schema.Type<
+  typeof ProductVariantInventoryPolicySchema
+>;
+
+export type ProductFeaturedMedia = Schema.Schema.Type<typeof ProductFeaturedMediaSchema>;
+
+export type ProductOption = Schema.Schema.Type<typeof ProductOptionSchema>;
+
+export type ProductVariant = Schema.Schema.Type<typeof ProductVariantSchema>;
+
+export type Product = Schema.Schema.Type<typeof ProductSchema>;

package/src/resources/products/webhook.ts

@@ -0,0 +1,130 @@
+import * as Schema from "effect/Schema";
+
+import { gid, splitTags, upper } from "../shared";
+import {
+  type Product,
+  type ProductFeaturedMedia,
+  type ProductOption,
+  ProductStatusSchema,
+  type ProductVariant,
+  ProductVariantInventoryPolicySchema,
+} from "./row";
+
+export const ProductWebhookImageSchema = Schema.Struct({
+  src: Schema.String,
+  alt: Schema.NullOr(Schema.String),
+});
+
+export const ProductWebhookOptionSchema = Schema.Struct({
+  id: Schema.Number,
+  name: Schema.String,
+  position: Schema.Int,
+  values: Schema.Array(Schema.String),
+});
+
+export const ProductWebhookVariantSchema = Schema.Struct({
+  admin_graphql_api_id: Schema.String,
+  id: Schema.Number,
+  title: Schema.String,
+  price: Schema.String,
+  inventory_policy: upper(ProductVariantInventoryPolicySchema),
+  compare_at_price: Schema.NullOr(Schema.String),
+  created_at: Schema.DateFromString,
+  updated_at: Schema.DateFromString,
+  taxable: Schema.Boolean,
+  barcode: Schema.NullOr(Schema.String),
+  sku: Schema.NullOr(Schema.String),
+});
+
+export const ProductWebhookVariantGidSchema = Schema.Struct({
+  admin_graphql_api_id: Schema.String,
+  updated_at: Schema.DateFromString,
+});
+
+export const ProductWebhookPayloadSchema = Schema.Struct({
+  id: Schema.Number,
+  admin_graphql_api_id: Schema.String,
+  body_html: Schema.NullOr(Schema.String),
+  created_at: Schema.DateFromString,
+  handle: Schema.String,
+  image: Schema.optional(Schema.NullOr(ProductWebhookImageSchema)),
+  options: Schema.Array(ProductWebhookOptionSchema),
+  product_type: Schema.String,
+  published_at: Schema.NullOr(Schema.DateFromString),
+  status: upper(ProductStatusSchema),
+  tags: Schema.String,
+  template_suffix: Schema.NullOr(Schema.String),
+  title: Schema.String,
+  updated_at: Schema.DateFromString,
+  variants: Schema.Array(ProductWebhookVariantSchema),
+  variant_gids: Schema.Array(ProductWebhookVariantGidSchema),
+  vendor: Schema.String,
+});
+
+export const ProductDeleteWebhookPayloadSchema = Schema.Struct({ id: Schema.Number });
+
+export const ProductEventSchema = Schema.Union([
+  Schema.Struct({
+    _tag: Schema.Literal("upsert"),
+    payload: Schema.toType(ProductWebhookPayloadSchema),
+    triggeredAt: Schema.Date,
+  }),
+  Schema.Struct({
+    _tag: Schema.Literal("delete"),
+    id: Schema.String,
+    version: Schema.Date,
+  }),
+]);
+
+export type ProductWebhookImage = Schema.Schema.Type<typeof ProductWebhookImageSchema>;
+
+export type ProductWebhookOption = Schema.Schema.Type<typeof ProductWebhookOptionSchema>;
+
+export type ProductWebhookVariant = Schema.Schema.Type<typeof ProductWebhookVariantSchema>;
+
+export type ProductWebhookPayload = Schema.Schema.Type<typeof ProductWebhookPayloadSchema>;
+
+const normalizeProductOption = (option: ProductWebhookOption): ProductOption => ({
+  id: gid("ProductOption", option.id),
+  name: option.name,
+  position: option.position,
+  values: option.values,
+});
+
+const normalizeProductVariant = (variant: ProductWebhookVariant): ProductVariant => ({
+  id: variant.admin_graphql_api_id,
+  legacyResourceId: String(variant.id),
+  title: variant.title,
+  sku: variant.sku,
+  barcode: variant.barcode,
+  price: variant.price,
+  compareAtPrice: variant.compare_at_price,
+  inventoryPolicy: variant.inventory_policy,
+  taxable: variant.taxable,
+  createdAt: variant.created_at,
+  updatedAt: variant.updated_at,
+});
+
+const normalizeProductFeaturedMedia = (
+  image: ProductWebhookImage | null | undefined,
+): ProductFeaturedMedia | null =>
+  image === null || image === undefined ? null : { image: { url: image.src, altText: image.alt } };
+
+export const fromProductWebhook = (payload: ProductWebhookPayload): Product => ({
+  id: payload.admin_graphql_api_id,
+  legacyResourceId: String(payload.id),
+  title: payload.title,
+  handle: payload.handle,
+  descriptionHtml: payload.body_html ?? "",
+  productType: payload.product_type,
+  vendor: payload.vendor,
+  status: payload.status,
+  tags: splitTags(payload.tags),
+  createdAt: payload.created_at,
+  updatedAt: payload.updated_at,
+  publishedAt: payload.published_at,
+  templateSuffix: payload.template_suffix ?? "",
+  featuredMedia: normalizeProductFeaturedMedia(payload.image),
+  options: payload.options.map(normalizeProductOption),
+  variants: payload.variants.map(normalizeProductVariant),
+});