@koda-sl/baker-cli 0.387.0 → 0.389.0-dev.8065ad8f0

package/dist/chunk-RY7TYEIX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/shopify/wire.ts"],"sourcesContent":["/**\n * Contract for `GET /api/shopify/{store,products,product,collections,stock}` —\n * the agent's read of the connected Shopify store (`baker shopify`).\n *\n * Every answer comes from Baker's own copy of the store's catalog, never from\n * Shopify at request time, and carries `store`: whether that copy is complete,\n * whether Baker can still reach the store, and when it last heard from it.\n * Compact by default; `full` adds the fields marked below. No token, storefront\n * token or Shopify GID ever appears.\n *\n * This package must not depend on `convex`: ids are plain strings.\n */\nimport { z } from \"zod\";\n\n// ---------------------------------------------------------------------------\n// Refusals — the backend's own sentences, matched by the CLI with `includes`\n// ---------------------------------------------------------------------------\n\n/** No store is connected, and this Baker can connect one: the agent asks the user to. */\nexport const SHOPIFY_NOT_CONNECTED_MESSAGE = \"No Shopify store is connected for this company.\";\n/**\n * The store is connected but Baker has not finished bringing in its orders (a\n * store connected minutes ago): buyer, segment and audience reads wait for it.\n * The backend starts the import when none is running.\n */\nexport const SHOPIFY_ORDERS_IMPORTING_MESSAGE =\n  \"The Shopify store is connected, and Baker is still bringing in its orders. Try again in a few minutes.\";\n/** This Baker cannot connect a Shopify store at all yet: the agent carries on without it. */\nexport const SHOPIFY_NOT_OFFERED_MESSAGE = \"Baker can't read Shopify stores yet.\";\n/** The start of \"No product matches <ref>.\" */\nexport const SHOPIFY_PRODUCT_NOT_FOUND_PREFIX = \"No product matches\";\n\n// ---------------------------------------------------------------------------\n// Mirrored enums — the backend holds the same literals (`lib/validators.ts`),\n// and a backend test asserts they stay equal.\n// ---------------------------------------------------------------------------\n\nexport const shopifyStockStateSchema = z.enum([\"in_stock\", \"partly_out\", \"out_of_stock\"]);\nexport type ShopifyStockState = z.infer<typeof shopifyStockStateSchema>;\n\n/** One option (variant). `selling_when_out` and `not_tracked` can still be bought. */\nexport const shopifyOptionStockSchema = z.enum([\"in_stock\", \"out_of_stock\", \"not_tracked\", \"selling_when_out\"]);\nexport type ShopifyOptionStock = z.infer<typeof shopifyOptionStockSchema>;\n\nexport const shopifyVisibilitySchema = z.enum([\"listed\", \"link_only\", \"not_on_store\", \"no_store\"]);\nexport type ShopifyVisibility = z.infer<typeof shopifyVisibilitySchema>;\n\nexport const shopifyProductStatusSchema = z.enum([\"ACTIVE\", \"ARCHIVED\", \"DRAFT\", \"UNLISTED\"]);\nexport type ShopifyProductStatus = z.infer<typeof shopifyProductStatusSchema>;\n\n// ---------------------------------------------------------------------------\n// Agent-view enums — derived for the agent (`shopify/catalog/agentView.ts`),\n// with no backend twin.\n// ---------------------------------------------------------------------------\n\nexport const shopifyStoreConnectionSchema = z.enum([\"connected\", \"needs_reconnect\", \"disconnected\"]);\nexport type ShopifyStoreConnection = z.infer<typeof shopifyStoreConnectionSchema>;\n\n/** `starting`: connected, and Baker has not begun its copy yet. */\nexport const shopifyCatalogStateSchema = z.enum([\"starting\", \"importing\", \"ready\", \"failed\"]);\nexport type ShopifyCatalogState = z.infer<typeof shopifyCatalogStateSchema>;\n\n/** `own`: the store has no Shopify online store and sells through its own storefront. */\nexport const shopifyStorefrontSchema = z.enum([\"online_store\", \"own\"]);\nexport type ShopifyStorefront = z.infer<typeof shopifyStorefrontSchema>;\n\n/** Absent: buyable on the store. `link_only`: buyable through its link only. */\nexport const shopifyAvailabilitySchema = z.enum([\"link_only\", \"not_for_sale\"]);\nexport type ShopifyAvailability = z.infer<typeof shopifyAvailabilitySchema>;\n\n/** Where a shopper goes from a buy link (S3b): Shopify's checkout, the store's cart, or the product page. */\nexport const shopifyBuyDestinationSchema = z.enum([\"checkout\", \"store_cart\", \"product_page\"]);\nexport type ShopifyBuyDestination = z.infer<typeof shopifyBuyDestinationSchema>;\n\n/** What a buy link cannot do, said rather than hidden. */\nexport const shopifyBuyNoteSchema = z.enum([\n  \"subscription_only\",\n  \"subscription_optional\",\n  \"password_protected\",\n  \"own_storefront\",\n  \"details_pending\",\n]);\nexport type ShopifyBuyNote = z.infer<typeof shopifyBuyNoteSchema>;\n\n/** A part of the store's content the store owner has not let Baker read yet. */\nexport const shopifyUnreadablePartSchema = z.enum([\"metaobjects\", \"definitions\", \"languages\", \"policies\"]);\n\n// ---------------------------------------------------------------------------\n// The store block\n// ---------------------------------------------------------------------------\n\nexport const shopifyStoreStateSchema = z.object({\n  name: z.string(),\n  connection: shopifyStoreConnectionSchema,\n  catalog: shopifyCatalogStateSchema,\n  importProgress: z.object({ done: z.number(), total: z.number().optional() }).optional(),\n  /** Products Baker could not read (it keeps retrying); present only when > 0 and not importing. */\n  unreadable: z.number().optional(),\n  unreadableCapped: z.literal(true).optional(),\n  /** Baker could not check the store for changes lately. */\n  checksFailing: z.literal(true).optional(),\n  storefront: shopifyStorefrontSchema.optional(),\n  /** When Baker last heard from or checked the store — not a promise the copy is current. */\n  lastActivity: z.string().optional(),\n});\nexport type ShopifyStoreState = z.infer<typeof shopifyStoreStateSchema>;\n\n// ---------------------------------------------------------------------------\n// Requests — all GET query strings\n// ---------------------------------------------------------------------------\n\nconst flag = z.enum([\"true\", \"false\"]).transform((value) => value === \"true\");\n\nexport const shopifyStoreRequestSchema = z.object({ full: flag.optional() });\nexport type ShopifyStoreRequest = z.infer<typeof shopifyStoreRequestSchema>;\n\nexport const shopifyProductsRequestSchema = z.object({\n  search: z.string().max(200).optional(),\n  collection: z.string().min(1).max(500).optional(),\n  stock: shopifyStockStateSchema.optional(),\n  limit: z.coerce.number().int().min(1).max(100).optional(),\n  cursor: z.string().optional(),\n  full: flag.optional(),\n});\nexport type ShopifyProductsRequest = z.infer<typeof shopifyProductsRequestSchema>;\n\nexport const SHOPIFY_MAX_BUY_QUANTITY = 99;\n\nexport const shopifyProductRequestSchema = z.object({\n  ref: z.string().min(1).max(500),\n  variantsCursor: z.string().optional(),\n  outOfStock: flag.optional(),\n  full: flag.optional(),\n  /** The product's whole details: formatted description, custom fields, subscriptions, translations. */\n  content: flag.optional(),\n  /** One custom field whole, by its name or `namespace.key`. */\n  field: z.string().min(1).max(200).optional(),\n  /** With `field`: the option (its `variantId`) whose field to return, when options share one. */\n  variant: z\n    .string()\n    .regex(/^\\d{1,30}$/, \"an option's variantId\")\n    .optional(),\n  /** How many of the option each buy link puts in the cart (1-99, default 1). */\n  quantity: z.coerce.number().int().min(1).max(SHOPIFY_MAX_BUY_QUANTITY).optional(),\n});\nexport type ShopifyProductRequest = z.infer<typeof shopifyProductRequestSchema>;\n\nexport const shopifyCollectionsRequestSchema = z.object({\n  search: z.string().max(200).optional(),\n  /** Each collection's description, image and SEO. */\n  full: flag.optional(),\n});\nexport type ShopifyCollectionsRequest = z.infer<typeof shopifyCollectionsRequestSchema>;\n\nexport const shopifyStockRequestSchema = z.object({\n  collection: z.string().min(1).max(500).optional(),\n  limit: z.coerce.number().int().min(1).max(200).optional(),\n  full: flag.optional(),\n});\nexport type ShopifyStockRequest = z.infer<typeof shopifyStockRequestSchema>;\n\n// ---------------------------------------------------------------------------\n// Responses\n// ---------------------------------------------------------------------------\n\n/**\n * Every price is one string that carries its currency beside every amount —\n * \"USD 600.00\", or a range \"USD 9.95 – USD 49.95\" — never a bare number with\n * the currency elsewhere, so an agent can't quote it in the wrong currency.\n */\nconst AMOUNT = String.raw`[A-Z]{3} \\d+(?:\\.\\d+)?`;\nexport const shopifyPriceSchema = z.string().regex(new RegExp(`^${AMOUNT}$`), \"a price is '<CURRENCY> <amount>'\");\nexport const shopifyPriceRangeSchema = z\n  .string()\n  .regex(new RegExp(`^${AMOUNT}(?: – ${AMOUNT})?$`), \"a price range is '<CURRENCY> <min> – <CURRENCY> <max>'\");\n\n/** Where `store`'s counts stop: a count at its ceiling means that many or more (`capped`). */\nexport const SHOPIFY_STOCK_COUNT_CAP = 100;\nexport const SHOPIFY_COLLECTION_COUNT_CAP = 500;\n\nexport const shopifyStoreSummarySchema = z.object({\n  name: z.string(),\n  domain: z.string(),\n  storefrontUrl: z.string().optional(),\n  currency: z.string().optional(),\n  homeCountry: z.string().optional(),\n  products: z.number(),\n  collections: z.number(),\n  outOfStock: z.number(),\n  partlyOut: z.number(),\n  /** A count stopped at its cap: `SHOPIFY_STOCK_COUNT_CAP` for stock counts, `SHOPIFY_COLLECTION_COUNT_CAP` for collections. */\n  capped: z.literal(true).optional(),\n  pricePoints: z\n    .array(\n      z.object({\n        name: z.string(),\n        currency: z.string(),\n        countries: z.array(z.string()),\n        moreCountries: z.number().optional(),\n      }),\n    )\n    .optional(),\n  productsUrl: z.string(),\n  /** Where the buy links send a shopper (S3b): the store's own setting, checkout unless changed. */\n  buyDestination: shopifyBuyDestinationSchema,\n  /** The store asks for a password before anyone can see it: a buy link meets it first. */\n  passwordProtected: z.literal(true).optional(),\n  /** The store's published languages, primary first. */\n  languages: z.array(z.object({ locale: z.string(), name: z.string(), primary: z.boolean() })).optional(),\n  policies: z\n    .array(\n      z.object({\n        type: z.string(),\n        title: z.string(),\n        url: z.string().optional(),\n        // --full\n        text: z.string().optional(),\n      }),\n    )\n    .optional(),\n  /** Store content Baker can't read until the store owner accepts Baker's new permissions. */\n  unreadable: z.array(shopifyUnreadablePartSchema).optional(),\n  // --full\n  adminUrl: z.string().optional(),\n  brand: z\n    .object({\n      slogan: z.string().optional(),\n      shortDescription: z.string().optional(),\n      logoUrl: z.string().optional(),\n      squareLogoUrl: z.string().optional(),\n      coverImageUrl: z.string().optional(),\n      colors: z.array(\n        z.object({ role: z.string(), background: z.string().optional(), foreground: z.string().optional() }),\n      ),\n    })\n    .optional(),\n});\nexport type ShopifyStoreSummary = z.infer<typeof shopifyStoreSummarySchema>;\n\nexport const shopifyStoreResponseSchema = z.object({\n  store: shopifyStoreStateSchema,\n  summary: shopifyStoreSummarySchema,\n  /**\n   * Which store changes Baker may make (S9), by what the store allowed: false\n   * means `baker shopify change …` will ask the user to allow it first.\n   */\n  canChange: z\n    .object({\n      products: z.boolean(),\n      publishing: z.boolean(),\n      discounts: z.boolean(),\n      redirects: z.boolean(),\n      marketing: z.boolean(),\n    })\n    .optional(),\n});\nexport type ShopifyStoreResponse = z.infer<typeof shopifyStoreResponseSchema>;\n\nexport const shopifyProductRowSchema = z.object({\n  productId: z.string(),\n  title: z.string(),\n  price: shopifyPriceRangeSchema,\n  compareAt: shopifyPriceRangeSchema.optional(),\n  stock: shopifyStockStateSchema,\n  /** \"<out>/<all>\" options out of stock, when partly out. */\n  optionsOut: z.string().optional(),\n  availability: shopifyAvailabilitySchema.optional(),\n  status: shopifyProductStatusSchema.optional(),\n  photo: z.enum([\"stored\", \"adding\", \"none\"]),\n  // --full\n  vendor: z.string().optional(),\n  productType: z.string().optional(),\n  variantCount: z.number().optional(),\n  imageUrl: z.string().optional(),\n  visibility: shopifyVisibilitySchema.optional(),\n});\nexport type ShopifyProductRow = z.infer<typeof shopifyProductRowSchema>;\n\nexport const shopifyProductsResponseSchema = z.object({\n  store: shopifyStoreStateSchema,\n  products: z.array(shopifyProductRowSchema),\n  nextCursor: z.string().nullable(),\n});\nexport type ShopifyProductsResponse = z.infer<typeof shopifyProductsResponseSchema>;\n\nconst outOptionSchema = z.object({ variantId: z.string(), title: z.string(), sku: z.string().optional() });\nexport type ShopifyOutOption = z.infer<typeof outOptionSchema>;\n\nconst countryPriceSchema = z.object({\n  name: z.string(),\n  price: shopifyPriceSchema,\n  compareAtPrice: shopifyPriceSchema.optional(),\n});\n\nexport const shopifyVariantSchema = z.object({\n  variantId: z.string(),\n  title: z.string(),\n  price: shopifyPriceSchema,\n  compareAtPrice: shopifyPriceSchema.optional(),\n  stock: shopifyOptionStockSchema,\n  quantity: z.number().optional(),\n  /** The option's buy link for ads, emails and messages (a landing places `<ShopifyProduct>` instead): never build a Shopify link by hand. Absent when the option can't be bought. */\n  buyUrl: z.string().optional(),\n  buyUrlKind: shopifyBuyDestinationSchema.optional(),\n  /** Why there is no buy link. */\n  unavailable: z.enum([\"not_for_sale\", \"out_of_stock\"]).optional(),\n  notes: z.array(shopifyBuyNoteSchema).optional(),\n  // --full\n  checkout: z.string().optional(),\n  storeCart: z.string().optional(),\n  productPage: z.string().optional(),\n  weight: z.string().optional(),\n  unitPrice: z.string().optional(),\n  requiresShipping: z.boolean().optional(),\n  taxable: z.boolean().optional(),\n  sku: z.string().optional(),\n  barcode: z.string().optional(),\n  selectedOptions: z.array(z.object({ name: z.string(), value: z.string() })).optional(),\n  feedId: z.string().optional(),\n  inventoryPolicy: z.enum([\"DENY\", \"CONTINUE\"]).optional(),\n  prices: z.array(countryPriceSchema).optional(),\n});\nexport type ShopifyVariant = z.infer<typeof shopifyVariantSchema>;\n\nexport const shopifyProductVideoSchema = z.object({\n  videoId: z.string(),\n  playbackId: z.string(),\n  alt: z.string().optional(),\n  /** Seconds. */\n  duration: z.number().optional(),\n});\nexport type ShopifyProductVideo = z.infer<typeof shopifyProductVideoSchema>;\n\nconst shopifyFieldRefSchema = z.object({\n  kind: z.enum([\"image\", \"file\", \"video\", \"product\", \"variant\", \"collection\", \"metaobject\", \"other\"]),\n  id: z.string(),\n  url: z.string().optional(),\n  mimeType: z.string().optional(),\n  alt: z.string().optional(),\n  /** A video's preview image; its `url` is the video file itself. */\n  previewUrl: z.string().optional(),\n  /** A product's or a collection's title, from Baker's copy. */\n  title: z.string().optional(),\n  /** An image brought into the library: its imageId, to place like the product's photos. */\n  imageId: z.string().optional(),\n  /** A custom content entry (a size chart, a care guide): its name and fields. */\n  entry: z\n    .object({\n      name: z.string(),\n      fields: z.array(z.object({ name: z.string(), text: z.string(), truncated: z.literal(true).optional() })),\n    })\n    .optional(),\n});\n\n/** One custom field of the product or of an option, named by its definition. */\nexport const shopifyProductFieldSchema = z.object({\n  name: z.string(),\n  /** `namespace.key`: what `--field` takes when two fields share a name. */\n  key: z.string(),\n  type: z.string(),\n  owner: z.enum([\"product\", \"option\"]),\n  variantId: z.string().optional(),\n  text: z.string(),\n  html: z.string().optional(),\n  refs: z.array(shopifyFieldRefSchema).optional(),\n  refsMore: z.number().optional(),\n  /** The text or the list is longer than shown: `--field <key>` returns it whole. */\n  truncated: z.literal(true).optional(),\n  /** The store owner hasn't let Baker read what this field points at yet. */\n  unreadable: z.literal(true).optional(),\n});\nexport type ShopifyProductField = z.infer<typeof shopifyProductFieldSchema>;\n\nexport const shopifyProductContentSchema = z.object({\n  descriptionHtml: z.string(),\n  descriptionTruncated: z.literal(true).optional(),\n  category: z.string().optional(),\n  giftCard: z.literal(true).optional(),\n  fields: z.array(shopifyProductFieldSchema),\n  rating: z.object({ value: z.number(), scaleMax: z.number(), count: z.number().optional() }).optional(),\n  /** Subscriptions the product can be bought with; `subscriptionOnly` when only by subscription. */\n  subscriptions: z\n    .array(\n      z.object({ name: z.string(), plans: z.array(z.object({ name: z.string(), category: z.string().optional() })) }),\n    )\n    .optional(),\n  subscriptionOnly: z.literal(true).optional(),\n  /** YouTube or Vimeo videos and 3D models: links with their preview image. */\n  mediaLinks: z.array(\n    z.object({\n      kind: z.enum([\"external_video\", \"model_3d\"]),\n      url: z.string(),\n      embedUrl: z.string().optional(),\n      previewUrl: z.string().optional(),\n      alt: z.string().optional(),\n    }),\n  ),\n  bundle: z.array(z.object({ productId: z.string(), title: z.string().optional(), quantity: z.number() })).optional(),\n  combinedListing: z\n    .object({ role: z.string(), parentProductId: z.string().optional(), childProductIds: z.array(z.string()) })\n    .optional(),\n  translations: z.array(\n    z.object({\n      locale: z.string(),\n      title: z.string().optional(),\n      description: z.string().optional(),\n      seoTitle: z.string().optional(),\n      seoDescription: z.string().optional(),\n      options: z.array(\n        z.object({\n          name: z.string(),\n          translatedName: z.string().optional(),\n          values: z.array(z.object({ value: z.string(), translated: z.string().optional() })),\n        }),\n      ),\n      truncated: z.literal(true).optional(),\n    }),\n  ),\n  /** Content the store owner hasn't let Baker read yet. */\n  unreadable: z.array(shopifyUnreadablePartSchema).optional(),\n  /** Baker hasn't read this product's details yet, or Shopify didn't send some of them. */\n  pending: z.literal(true).optional(),\n  failure: z.string().optional(),\n});\nexport type ShopifyProductContent = z.infer<typeof shopifyProductContentSchema>;\n\nexport const shopifyProductDetailSchema = z.object({\n  productId: z.string(),\n  title: z.string(),\n  handle: z.string(),\n  /** The product's page in Baker — the link to share with the user. */\n  url: z.string(),\n  /** The product's page on the online store: to look at, never a buy button's link (that is each option's `buyUrl`, or `<ShopifyProduct>` on a landing). */\n  storeUrl: z.string().optional(),\n  availability: shopifyAvailabilitySchema.optional(),\n  status: shopifyProductStatusSchema.optional(),\n  vendor: z.string(),\n  productType: z.string(),\n  price: shopifyPriceRangeSchema,\n  compareAt: shopifyPriceRangeSchema.optional(),\n  stock: z.object({ state: shopifyStockStateSchema, optionsOut: z.number(), options: z.number() }),\n  outOptions: z.array(outOptionSchema),\n  outOptionsMore: z.number().optional(),\n  options: z.array(z.object({ name: z.string(), values: z.array(z.string()) })),\n  variants: z.array(shopifyVariantSchema),\n  variantTotal: z.number(),\n  variantsNextCursor: z.string().optional(),\n  photos: z.array(z.object({ imageId: z.string(), url: z.string(), alt: z.string().optional() })),\n  photosAdding: z.number(),\n  photosNotBrought: z.number(),\n  collections: z.array(z.object({ collectionId: z.string(), title: z.string() })),\n  description: z.string(),\n  descriptionTruncated: z.literal(true).optional(),\n  tags: z.array(z.string()),\n  pricesByCountry: z\n    .array(\n      z.object({\n        name: z.string(),\n        price: shopifyPriceRangeSchema,\n        countries: z.array(z.string()),\n        moreCountries: z.number().optional(),\n      }),\n    )\n    .optional(),\n  /** When Baker last read this product from the store. */\n  observedAt: z.string(),\n  /** What else Baker keeps about it, in a line: \"formatted description, 2 videos, Size chart, 4.7★ from 120 reviews\". */\n  contentSummary: z.string().optional(),\n  /** Its Shopify videos in the video library: place one with `<Video playbackId=…/>`. */\n  videos: z.array(shopifyProductVideoSchema),\n  videosAdding: z.number(),\n  videosNotBrought: z.number(),\n  /** Where the buy links send a shopper, and how many each puts in the cart. */\n  buyDestination: shopifyBuyDestinationSchema,\n  quantity: z.number(),\n  /** --content (or --full): the whole of it. */\n  content: shopifyProductContentSchema.optional(),\n  /** --field: one custom field, whole. */\n  field: shopifyProductFieldSchema.optional(),\n  // --full\n  visibility: shopifyVisibilitySchema.optional(),\n  seo: z.object({ title: z.string().optional(), description: z.string().optional() }).optional(),\n  category: z.string().optional(),\n  adminUrl: z.string().optional(),\n});\nexport type ShopifyProductDetail = z.infer<typeof shopifyProductDetailSchema>;\n\nexport const shopifyProductResponseSchema = z.object({\n  store: shopifyStoreStateSchema,\n  product: shopifyProductDetailSchema,\n});\nexport type ShopifyProductResponse = z.infer<typeof shopifyProductResponseSchema>;\n\nexport const shopifyCollectionRowSchema = z.object({\n  collectionId: z.string(),\n  title: z.string(),\n  handle: z.string(),\n  /** Shopify's count at Baker's last read. */\n  products: z.number(),\n  onStore: z.boolean().optional(),\n  /** The collection's page on the store; absent when it has none (unpublished, or no store address known). */\n  storeUrl: z.string().optional(),\n  // --full\n  description: z.string().optional(),\n  imageUrl: z.string().optional(),\n  seo: z.object({ title: z.string().optional(), description: z.string().optional() }).optional(),\n});\nexport type ShopifyCollectionRow = z.infer<typeof shopifyCollectionRowSchema>;\n\nexport const shopifyCollectionsResponseSchema = z.object({\n  store: shopifyStoreStateSchema,\n  collections: z.array(shopifyCollectionRowSchema),\n});\nexport type ShopifyCollectionsResponse = z.infer<typeof shopifyCollectionsResponseSchema>;\n\nexport const shopifyOutOfStockRowSchema = z.object({\n  productId: z.string(),\n  title: z.string(),\n  options: z.number(),\n  // --full\n  url: z.string().optional(),\n});\nexport type ShopifyOutOfStockRow = z.infer<typeof shopifyOutOfStockRowSchema>;\n\nexport const shopifyPartlyOutRowSchema = z.object({\n  productId: z.string(),\n  title: z.string(),\n  optionsOut: z.number(),\n  options: z.number(),\n  outOptions: z.array(outOptionSchema),\n  outOptionsMore: z.number().optional(),\n  // --full\n  url: z.string().optional(),\n});\nexport type ShopifyPartlyOutRow = z.infer<typeof shopifyPartlyOutRowSchema>;\n\nexport const shopifyStockResponseSchema = z.object({\n  store: shopifyStoreStateSchema,\n  outOfStock: z.array(shopifyOutOfStockRowSchema),\n  partlyOut: z.array(shopifyPartlyOutRowSchema),\n  /** More products in that group than `limit`. */\n  more: z.object({ outOfStock: z.boolean(), partlyOut: z.boolean() }),\n});\nexport type ShopifyStockResponse = z.infer<typeof shopifyStockResponseSchema>;\n\n// ---------------------------------------------------------------------------\n// Sales (S6) — `GET /api/shopify/sales`, `baker shopify sales`\n// ---------------------------------------------------------------------------\n\n/**\n * How a store's sales are broken down: by day or product (when they happened),\n * by campaign or landing (who brought the buyer) — or, from the store's whole\n * order history (S7), by when buyers order: weekday, hour, month or month of\n * the year, in the store's time, by when each order was placed.\n */\nexport const shopifySalesBySchema = z.enum([\n  \"day\",\n  \"product\",\n  \"campaign\",\n  \"landing\",\n  \"weekday\",\n  \"hour\",\n  \"month\",\n  \"month_of_year\",\n]);\nexport type ShopifySalesBy = z.infer<typeof shopifySalesBySchema>;\n\n/** The breakdowns read from the store's whole order history rather than the events store. */\nexport const SHOPIFY_SALES_TIMING_BY: readonly ShopifySalesBy[] = [\"weekday\", \"hour\", \"month\", \"month_of_year\"];\n\n/** How far back day, product, campaign and landing sales can be read: the events store keeps 400 days. */\nexport const SHOPIFY_SALES_MAX_DAYS = 395;\n/** How far back the timing breakdowns can be read: the store's whole history. */\nexport const SHOPIFY_SALES_TIMING_MAX_DAYS = 3650;\n\nexport const shopifySalesRequestSchema = z\n  .object({\n    days: z.coerce.number().int().min(1).max(SHOPIFY_SALES_TIMING_MAX_DAYS).optional(),\n    /** Every order the store has (timing breakdowns only). */\n    all: flag.optional(),\n    by: shopifySalesBySchema.optional(),\n    limit: z.coerce.number().int().min(1).max(100).optional(),\n    full: flag.optional(),\n  })\n  .superRefine((request, ctx) => {\n    if (SHOPIFY_SALES_TIMING_BY.includes(request.by ?? \"day\")) return;\n    if (request.all) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"all\"],\n        message: \"all is only for --by weekday, hour, month or month_of_year\",\n      });\n    }\n    if ((request.days ?? 0) > SHOPIFY_SALES_MAX_DAYS) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"days\"],\n        message: `by day, product, campaign or landing reads up to ${SHOPIFY_SALES_MAX_DAYS} days`,\n      });\n    }\n  });\nexport type ShopifySalesRequest = z.infer<typeof shopifySalesRequestSchema>;\n\n/**\n * Who brought a row's sales:\n * - `campaign` — the last campaign visit of the buyer before they ordered;\n * - `order` — the order's own campaign (its cart, or Shopify's record of the visit);\n * - `landing` — a Baker landing the buyer viewed before ordering;\n * - `before_baker` — paid before Baker measured the store: counted, credited to nothing;\n * - `unattributed` — nothing says where the buyer came from;\n * - `other` — the rest, folded together past the limit.\n */\nexport const shopifySalesCreditSchema = z.enum([\n  \"campaign\",\n  \"order\",\n  \"landing\",\n  \"before_baker\",\n  \"unattributed\",\n  \"other\",\n]);\nexport type ShopifySalesCredit = z.infer<typeof shopifySalesCreditSchema>;\n\n/** Money in the store's currency (`currency` at the top of the answer); a plain number, never mixed across currencies. */\nexport const shopifySalesRowSchema = z.object({\n  /** A campaign, a landing's name, a day (YYYY-MM-DD) or a product's title. */\n  label: z.string(),\n  credit: shopifySalesCreditSchema.optional(),\n  orders: z.number(),\n  sales: z.number(),\n  refunded: z.number(),\n  net: z.number(),\n  /** By day: money received after the sale (an edit paid for). */\n  added: z.number().optional(),\n  /** By product: units sold and given back. */\n  units: z.number().optional(),\n  refundedUnits: z.number().optional(),\n  /** By weekday, hour or month: the buyers who ordered. */\n  buyers: z.number().optional(),\n  // --full\n  source: z.string().optional(),\n  medium: z.string().optional(),\n  campaign: z.string().optional(),\n  /** The ad platform of the click that brought the buyer: google, meta, linkedin, … */\n  clickPlatform: z.string().optional(),\n  landingId: z.string().optional(),\n  productId: z.string().optional(),\n});\nexport type ShopifySalesRow = z.infer<typeof shopifySalesRowSchema>;\n\nexport const shopifySalesTotalsSchema = z.object({\n  orders: z.number(),\n  /** What the orders came to, with money added after the sale. */\n  sales: z.number(),\n  added: z.number(),\n  refunded: z.number(),\n  net: z.number(),\n});\n\n/** Who reports the store's sales to an ad platform: Shopify's own channel, Baker, or nobody chose yet (Baker only reports). */\nexport const shopifySalesReportingSchema = z.enum([\"shopify_channel\", \"baker\", \"undecided\"]);\n\nexport const shopifySalesResponseSchema = z.object({\n  store: shopifyStoreStateSchema,\n  /** `days` is \"all\" with `all`; `timezone` names the store's time a timing breakdown was read in. */\n  window: z.object({\n    days: z.union([z.number(), z.literal(\"all\")]),\n    from: z.string(),\n    to: z.string(),\n    timezone: z.string().optional(),\n  }),\n  by: shopifySalesBySchema,\n  /** The store's currency; null when nothing sold in the window. */\n  currency: z.string().nullable(),\n  totals: shopifySalesTotalsSchema,\n  rows: z.array(shopifySalesRowSchema),\n  /** Sales in another currency, which are never added to these. */\n  otherCurrencies: z.array(z.object({ currency: z.string(), net: z.number() })).optional(),\n  salesReporting: z.object({ meta: shopifySalesReportingSchema, google: shopifySalesReportingSchema }),\n  /** The order history Baker imports when a store connects: still coming in, done, or failed. */\n  history: z.enum([\"importing\", \"done\", \"failed\", \"none\"]),\n  /** Baker could not read this store's orders (the store must be reconnected). */\n  ordersUnreadable: z.literal(true).optional(),\n});\nexport type ShopifySalesResponse = z.infer<typeof shopifySalesResponseSchema>;\n"],"mappings":"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","names":[]}

package/dist/chunk-S4LZ7KTG.js

@@ -0,0 +1,160 @@
+import {
+  IDEA_VIDEO_FORMATS,
+  figuresIn,
+  unsourcedClaims
+} from "./chunk-YULENNA7.js";
+import {
+  AD_SPEC_SCHEMA
+} from "./chunk-U6VRBDNQ.js";
+
+// src/commands/creatives/make-model.ts
+import { parse, parseDocument, Scalar, visit } from "yaml";
+var REFERENCE_CANDIDATES = 6;
+function isVideoIdea(idea) {
+  return IDEA_VIDEO_FORMATS.includes(idea.format);
+}
+var BY_TEMPERATURE = {
+  cold: { audienceTemperature: "0_cold", excludeBrandReliant: true },
+  warm: { audienceTemperature: "1_warm_engaged,2_hot_visited", excludeBrandReliant: true },
+  hot: { audienceTemperature: "3_customer" }
+};
+function referenceSearchFor(idea, temperature, excludeAdvertiser) {
+  return {
+    query: idea.message,
+    scope: "followed-first",
+    platform: "meta",
+    format: "static",
+    formatPattern: idea.format,
+    awareness: idea.awareness,
+    ...BY_TEMPERATURE[temperature],
+    ...excludeAdvertiser ? { excludeAdvertiser } : {},
+    maxPerAdvertiser: 1,
+    limit: REFERENCE_CANDIDATES,
+    diverse: true
+  };
+}
+function referenceSearchesFor(idea, temperature, excludeAdvertiser) {
+  const strict = referenceSearchFor(idea, temperature, excludeAdvertiser);
+  const { awareness: _awareness, ...anyStage } = strict;
+  const { audienceTemperature: _temperature, excludeBrandReliant: _reliant, ...anyViewer } = anyStage;
+  const { query: _query, ...winners } = anyStage;
+  const { query: _anyQuery, ...anyWinners } = anyViewer;
+  return [
+    strict,
+    anyStage,
+    { ...anyViewer, scope: "all" },
+    { ...winners, sort: "winner" },
+    { ...anyWinners, scope: "all", sort: "winner" }
+  ];
+}
+function pooledCandidates(searches, limit) {
+  const seen = /* @__PURE__ */ new Set();
+  const pooled = [];
+  for (const candidate of searches.flat()) {
+    if (!candidate.ad_id || seen.has(candidate.ad_id)) continue;
+    seen.add(candidate.ad_id);
+    pooled.push(candidate);
+  }
+  return pooled.slice(0, limit);
+}
+function fitsIdea(fit) {
+  return fit.verdict !== "reject" && missingElements(fit).length === 0;
+}
+function missingElements(fit) {
+  return fit.load_bearing.filter((l) => l.have === "missing" && !l.ours?.trim()).map((l) => l.element);
+}
+function definitionFieldsOf(idea, evidence) {
+  return {
+    idea: idea.id,
+    message: idea.message,
+    ...evidence !== "explore" ? { evidence } : {},
+    angle: idea.angle,
+    persona: idea.who,
+    awareness: idea.awareness,
+    hypothesis: idea.why
+  };
+}
+var FRONTMATTER = /^---\r?\n([\s\S]*?\r?\n)?---/;
+function readsAsText11(text) {
+  try {
+    return parse(text, { version: "1.1" }) === text;
+  } catch {
+    return false;
+  }
+}
+function setDefinitionFields(raw, fields) {
+  const match = raw.match(FRONTMATTER);
+  if (!match) return raw;
+  const doc = parseDocument(match[1] ?? "");
+  if (doc.errors.length > 0) return raw;
+  for (const [key, value] of Object.entries(fields)) {
+    if (value === void 0) continue;
+    const node = doc.createNode(value);
+    visit(node, {
+      Scalar(_, scalar) {
+        if (typeof scalar.value === "string" && !readsAsText11(scalar.value)) {
+          scalar.type = Scalar.QUOTE_DOUBLE;
+        }
+      }
+    });
+    doc.set(key, node);
+  }
+  return `---
+${doc.toString()}---${raw.slice(match[0].length)}`;
+}
+function setSpecMessage(specJson, message) {
+  const spec = JSON.parse(specJson);
+  return `${JSON.stringify({ ...spec, message }, null, 2)}
+`;
+}
+function withFitConcept(specJson, seeded) {
+  const spec = JSON.parse(specJson);
+  const held = spec.concept;
+  if (held?.reference_ad_id) return specJson;
+  return `${JSON.stringify({ ...spec, ...seeded }, null, 2)}
+`;
+}
+function unsourcedCopyLines(specJson, corpus) {
+  const spec = JSON.parse(specJson);
+  const figures = figuresIn(corpus);
+  const lines = Array.isArray(spec.copy) ? spec.copy : [];
+  return lines.flatMap((line) => {
+    const text = typeof line === "object" && line !== null ? line.text : void 0;
+    return typeof text === "string" && unsourcedClaims(text, figures).length > 0 ? [text] : [];
+  });
+}
+var PHOTO_FORMATS = /photo|lifestyle|before_after|ugc|product|selfie|street/;
+function ideaSpec(idea, who) {
+  const container = idea.format.replace(/_/g, " ");
+  return {
+    schema: AD_SPEC_SCHEMA,
+    viewer: { who },
+    message: idea.message,
+    copy: [{ text: "[TODO: the headline, in the customer's words]", lettering: "designed", role: "headline" }],
+    scene: {
+      description: `[TODO: what the viewer sees, as a ${container}, that shows: ${idea.message}]`,
+      look: PHOTO_FORMATS.test(idea.format) ? "photo" : "designed"
+    },
+    colors: [],
+    references: [],
+    logo: false,
+    third_party_brands: [],
+    scene_text: [],
+    mechanism: []
+  };
+}
+
+export {
+  isVideoIdea,
+  referenceSearchesFor,
+  pooledCandidates,
+  fitsIdea,
+  missingElements,
+  definitionFieldsOf,
+  setDefinitionFields,
+  setSpecMessage,
+  withFitConcept,
+  unsourcedCopyLines,
+  ideaSpec
+};
+//# sourceMappingURL=chunk-S4LZ7KTG.js.map

package/dist/chunk-S4LZ7KTG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/make-model.ts"],"sourcesContent":["/**\n * The rules `baker creatives make` applies to turn an idea into a creative: which reference to\n * look for, which one fits, and what the creative records about the idea it carries. Pure.\n */\nimport { parse, parseDocument, Scalar, visit } from \"yaml\";\nimport { AD_SPEC_SCHEMA, type AdSpec } from \"../../engine/scaffold/static-ad-spec.ts\";\nimport type { ViewerTemperature } from \"../../viewer-profile.ts\";\nimport type { FitAnswer } from \"../winning-ads/fit.ts\";\nimport type { WinningAdsSearchArgs } from \"../winning-ads/search.ts\";\nimport { type EvidenceLevel, figuresIn, IDEA_VIDEO_FORMATS, type Idea, unsourcedClaims } from \"./ideas-model.ts\";\n\nexport const REFERENCE_CANDIDATES = 6;\n\n/** Whether the idea is a video, built from beats, rather than a static from a reference. */\nexport function isVideoIdea(idea: Pick<Idea, \"format\">): boolean {\n  return (IDEA_VIDEO_FORMATS as readonly string[]).includes(idea.format);\n}\n\n/** Who a reference was made for, by our viewer: a stranger's ad never leans on its own brand. */\nconst BY_TEMPERATURE: Record<ViewerTemperature, { audienceTemperature: string; excludeBrandReliant?: true }> = {\n  cold: { audienceTemperature: \"0_cold\", excludeBrandReliant: true },\n  warm: { audienceTemperature: \"1_warm_engaged,2_hot_visited\", excludeBrandReliant: true },\n  hot: { audienceTemperature: \"3_customer\" },\n};\n\n/** The library search for a static idea's reference: its container, made for our viewer. */\nexport function referenceSearchFor(\n  idea: Idea,\n  temperature: ViewerTemperature,\n  excludeAdvertiser?: string,\n): WinningAdsSearchArgs {\n  return {\n    query: idea.message,\n    scope: \"followed-first\",\n    platform: \"meta\",\n    format: \"static\",\n    formatPattern: idea.format,\n    awareness: idea.awareness,\n    ...BY_TEMPERATURE[temperature],\n    ...(excludeAdvertiser ? { excludeAdvertiser } : {}),\n    maxPerAdvertiser: 1,\n    limit: REFERENCE_CANDIDATES,\n    diverse: true,\n  };\n}\n\n/**\n * The searches whose candidates are tried, best first: the idea's format always holds, since the\n * format is part of the idea. First the idea's message (awareness, then who the ad was made for,\n * then the company's own market loosened in turn), then the container's proven winners with no\n * query, for our viewer and then for anyone. Prod, Oct 2026: the library's judge scores an ad\n * against the query, so a customer's sentence about one product matched no ad of another category\n * and 13 of 15 ideas found nothing, while every container held proven winners whose move transfers.\n */\nexport function referenceSearchesFor(\n  idea: Idea,\n  temperature: ViewerTemperature,\n  excludeAdvertiser?: string,\n): WinningAdsSearchArgs[] {\n  const strict = referenceSearchFor(idea, temperature, excludeAdvertiser);\n  const { awareness: _awareness, ...anyStage } = strict;\n  const { audienceTemperature: _temperature, excludeBrandReliant: _reliant, ...anyViewer } = anyStage;\n  const { query: _query, ...winners } = anyStage;\n  const { query: _anyQuery, ...anyWinners } = anyViewer;\n  return [\n    strict,\n    anyStage,\n    { ...anyViewer, scope: \"all\" },\n    { ...winners, sort: \"winner\" },\n    { ...anyWinners, scope: \"all\", sort: \"winner\" },\n  ];\n}\n\n/** Every search's candidates in one list, the better search's first, each ad once, at most `limit`. Pure. */\nexport function pooledCandidates<T extends { ad_id?: string | null }>(searches: readonly T[][], limit: number): T[] {\n  const seen = new Set<string>();\n  const pooled: T[] = [];\n  for (const candidate of searches.flat()) {\n    if (!candidate.ad_id || seen.has(candidate.ad_id)) continue;\n    seen.add(candidate.ad_id);\n    pooled.push(candidate);\n  }\n  return pooled.slice(0, limit);\n}\n\n/** A reference fits when what it wins on is something we can supply. */\nexport function fitsIdea(fit: Pick<FitAnswer, \"verdict\" | \"load_bearing\">): boolean {\n  return fit.verdict !== \"reject\" && missingElements(fit).length === 0;\n}\n\n/** The load-bearing elements a reference wins on that we have nothing for. Pure. */\nexport function missingElements(fit: Pick<FitAnswer, \"load_bearing\">): string[] {\n  return fit.load_bearing.filter((l) => l.have === \"missing\" && !l.ours?.trim()).map((l) => l.element);\n}\n\nexport type DefinitionStrategyFields = {\n  idea: string;\n  message: string;\n  evidence?: EvidenceLevel;\n  angle: string;\n  persona: string;\n  awareness: string;\n  hypothesis: string;\n};\n\n/** What a creative records about the idea it executes. */\nexport function definitionFieldsOf(idea: Idea, evidence: EvidenceLevel | \"explore\"): DefinitionStrategyFields {\n  return {\n    idea: idea.id,\n    message: idea.message,\n    ...(evidence !== \"explore\" ? { evidence } : {}),\n    angle: idea.angle,\n    persona: idea.who,\n    awareness: idea.awareness,\n    hypothesis: idea.why,\n  };\n}\n\nconst FRONTMATTER = /^---\\r?\\n([\\s\\S]*?\\r?\\n)?---/;\n\n/** Whether a bare string reads back as the same text under YAML 1.1. */\nfunction readsAsText11(text: string): boolean {\n  try {\n    return parse(text, { version: \"1.1\" }) === text;\n  } catch {\n    return false;\n  }\n}\n\n/** Set fields in a markdown file's frontmatter, keeping every other field and the body. */\nexport function setDefinitionFields(raw: string, fields: Record<string, unknown>): string {\n  const match = raw.match(FRONTMATTER);\n  if (!match) return raw;\n  const doc = parseDocument(match[1] ?? \"\");\n  if (doc.errors.length > 0) return raw;\n  for (const [key, value] of Object.entries(fields)) {\n    if (value === undefined) continue;\n    const node = doc.createNode(value);\n    // The site reads frontmatter as YAML 1.1, where a bare 2026-10-04 is a date, not text.\n    visit(node, {\n      Scalar(_, scalar) {\n        if (typeof scalar.value === \"string\" && !readsAsText11(scalar.value)) {\n          scalar.type = Scalar.QUOTE_DOUBLE;\n        }\n      },\n    });\n    doc.set(key, node);\n  }\n  return `---\\n${doc.toString()}---${raw.slice(match[0].length)}`;\n}\n\n/** The ad spec with the idea's message as the one thing it tells the viewer. */\nexport function setSpecMessage(specJson: string, message: string): string {\n  const spec = JSON.parse(specJson) as Record<string, unknown>;\n  return `${JSON.stringify({ ...spec, message }, null, 2)}\\n`;\n}\n\n/**\n * The ad spec with the concept the reference's fit read (`conceptFromFit`): a build started before\n * the fit answered has none, or only the one the scaffold drafted from its describe, which names no\n * reference and nothing of what we have; without the fit's, the render never sees the reference at\n * the level that won. A concept a fit already seeded (it names its reference) stays. Pure.\n */\nexport function withFitConcept(specJson: string, seeded: Record<string, unknown>): string {\n  const spec = JSON.parse(specJson) as Record<string, unknown>;\n  const held = spec.concept as { reference_ad_id?: unknown } | undefined;\n  if (held?.reference_ad_id) return specJson;\n  return `${JSON.stringify({ ...spec, ...seeded }, null, 2)}\\n`;\n}\n\n/**\n * The copy lines the scaffold drafted that claim a figure the company never wrote: a draft written\n * beside a competitor's ad can carry the competitor's promise. `corpus` is what the company wrote.\n */\nexport function unsourcedCopyLines(specJson: string, corpus: string): string[] {\n  const spec = JSON.parse(specJson) as { copy?: unknown };\n  const figures = figuresIn(corpus);\n  const lines = Array.isArray(spec.copy) ? spec.copy : [];\n  return lines.flatMap((line) => {\n    const text = typeof line === \"object\" && line !== null ? (line as { text?: unknown }).text : undefined;\n    return typeof text === \"string\" && unsourcedClaims(text, figures).length > 0 ? [text] : [];\n  });\n}\n\n/** Containers shown as a photograph; every other container is a designed graphic or a screen. */\nconst PHOTO_FORMATS = /photo|lifestyle|before_after|ugc|product|selfie|street/;\n\n/**\n * The ad spec an idea starts from when no proven ad fits it: the message and who it is for are\n * the idea's; the scene and the copy are placeholders the agent writes before anything renders\n * (`canvas run` refuses a placeholder). Pure.\n */\nexport function ideaSpec(idea: Idea, who: string): AdSpec {\n  const container = idea.format.replace(/_/g, \" \");\n  return {\n    schema: AD_SPEC_SCHEMA,\n    viewer: { who },\n    message: idea.message,\n    copy: [{ text: \"[TODO: the headline, in the customer's words]\", lettering: \"designed\", role: \"headline\" }],\n    scene: {\n      description: `[TODO: what the viewer sees, as a ${container}, that shows: ${idea.message}]`,\n      look: PHOTO_FORMATS.test(idea.format) ? \"photo\" : \"designed\",\n    },\n    colors: [],\n    references: [],\n    logo: false,\n    third_party_brands: [],\n    scene_text: [],\n    mechanism: [],\n  };\n}\n"],"mappings":"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","names":[]}