@koda-sl/baker-cli 0.457.0 → 0.458.0

package/dist/chunk-VAOMHPEX.js

@@ -0,0 +1,936 @@
+// ../api/src/ad-library/wire.ts
+import { z } from "zod";
+var adLibraryPlatformSchema = z.enum(["meta", "linkedin", "tiktok", "google"]);
+var adLifecycleStageSchema = z.enum([
+  "new",
+  "testing",
+  "proven",
+  "evergreen",
+  "killed_early",
+  "retired",
+  "unverified"
+]);
+var winnersHardFiltersSchema = z.object({
+  platform: z.array(z.string()).optional(),
+  format: z.array(z.string()).optional(),
+  winner_category: z.array(z.string()).optional(),
+  awareness_stage: z.array(z.string()).optional(),
+  country: z.array(z.string()).optional(),
+  language: z.array(z.string()).optional(),
+  advertiser_ids: z.array(z.string()).optional(),
+  exclude_advertiser_ids: z.array(z.string()).optional(),
+  industry_cluster_ids: z.array(z.string()).optional(),
+  business_model_cluster_ids: z.array(z.string()).optional(),
+  // Proven HOOK seeds (from the `/api/ad-library/seed-catalog` rollup) — narrows
+  // a find-similar search to ads on a chosen winning hook pattern, no cluster
+  // lookup. Forwarded verbatim to ad-dna's `hard_filters.hook_archetype_seeds`;
+  // must live in this schema or the strict boundary parse would drop it.
+  hook_archetype_seeds: z.array(z.string()).optional(),
+  // A static's container (comparison_table, before_after_split, …), the values
+  // `/api/ad-library/seed-catalog` ranks as formats: the best proven example of
+  // a container whatever category it sells.
+  static_format_patterns: z.array(z.string()).optional(),
+  // Who the ad was made for, as the library judged it from the creative: pick
+  // references whose audience matches ours (a cold brief, cold references).
+  audience_temperature: z.array(z.string()).optional(),
+  funnel_stage: z.array(z.string()).optional(),
+  advertiser_size: z.array(z.string()).optional(),
+  // `false` drops the ads known to work only on viewers who already know the
+  // brand (an ad not judged yet is kept); `true` keeps only those.
+  presumes_brand_knowledge: z.boolean().optional(),
+  first_seen_after: z.string().optional(),
+  first_seen_before: z.string().optional(),
+  // Where the ad is in its life (any of these stages), read by ad-dna from its
+  // dates at search time; and `true` for only the version a brand kept after
+  // testing it against others (`false` drops those).
+  lifecycle_stage: z.array(z.string()).optional(),
+  survived_test: z.boolean().optional(),
+  // `true` keeps only ads a creative can be built on (pictures and videos a
+  // brand designed): drops Google search text, Shopping and app ads. A format
+  // list that names `text` lifts it.
+  design_reference: z.boolean().optional()
+});
+var firstSeenBoundSchema = z.union([z.iso.date(), z.iso.datetime({ offset: true })], {
+  error: "first_seen_after/first_seen_before must be an ISO date (2026-01-01) or datetime (2026-01-01T00:00:00Z)"
+}).transform((value) => new Date(value.length === 10 ? `${value}T00:00:00Z` : value).toISOString());
+var adFormatSchema = z.enum(["video", "static", "carousel", "text"]);
+var winnerCategorySchema = z.enum([
+  "winner",
+  "grand_slam_winner",
+  "scaled_winner",
+  "low_profile_winner",
+  "rising",
+  "evergreen",
+  "low_traction_dud",
+  "thrash_iteration",
+  "thrash_family",
+  "false_winner",
+  "untested",
+  "dud"
+]);
+var awarenessStageSchema = z.enum([
+  "unaware",
+  "problem_aware",
+  "solution_aware",
+  "product_aware",
+  "most_aware"
+]);
+var audienceTemperatureSchema = z.enum(["0_cold", "1_warm_engaged", "2_hot_visited", "3_customer"]);
+var funnelStageSchema = z.enum(["TOF", "MOF", "BOF"]);
+var advertiserSizeSchema = z.enum(["solo", "smb", "mid", "enterprise"]);
+var staticFormatPatternSchema = z.enum([
+  "clean_product",
+  "lifestyle_photo",
+  "headline_card",
+  "infographic",
+  "chat_screenshot",
+  "tweet_screenshot",
+  "review_screenshot",
+  "before_after_split",
+  "comparison_table",
+  "list_card",
+  "meme_template",
+  "native_post_lookalike",
+  "stock_photo_overlay",
+  "founder_portrait",
+  "testimonial_quote",
+  "packshot_minimalist",
+  "four_panel_lifestyle_grid",
+  "two_panel_split",
+  "notes_app_screenshot",
+  "founder_letter_textonly",
+  "us_vs_them_grid",
+  "benefit_callout_grid",
+  "create_your_own_adventure_meme",
+  "quad_split",
+  "stories_style_casual_static"
+]);
+var validatedHardFiltersSchema = winnersHardFiltersSchema.extend({
+  platform: z.array(adLibraryPlatformSchema).optional(),
+  format: z.array(adFormatSchema).optional(),
+  winner_category: z.array(winnerCategorySchema).optional(),
+  awareness_stage: z.array(awarenessStageSchema).optional(),
+  static_format_patterns: z.array(staticFormatPatternSchema).optional(),
+  audience_temperature: z.array(audienceTemperatureSchema).optional(),
+  funnel_stage: z.array(funnelStageSchema).optional(),
+  advertiser_size: z.array(advertiserSizeSchema).optional(),
+  first_seen_after: firstSeenBoundSchema.optional(),
+  first_seen_before: firstSeenBoundSchema.optional(),
+  lifecycle_stage: z.array(adLifecycleStageSchema).optional()
+});
+var winnersSortSchema = z.enum(["winner", "longest_running", "newest"]);
+var winnersSearchFields = z.object({
+  free_text_query: z.string().max(500).optional(),
+  ref_ad_id: z.string().optional(),
+  limit: z.number().int().min(1).max(100).optional(),
+  // Pagination offset for infinite scroll. The browse view (no query) scrolls
+  // the whole library; a text/similar search scrolls its bounded ranked pool.
+  offset: z.number().int().min(0).optional(),
+  // Per-advertiser cap: past it a brand's ads are dropped. `0` = no cap (the
+  // library browse view sends it so a facet-filtered slice shows every winner
+  // and matches the facet-rail count); omit it to spread the brands instead,
+  // three each at the top and none dropped.
+  max_per_advertiser: z.number().int().min(0).max(50).optional(),
+  // ad-dna reads one advertiser in `advertiser_ids` as browsing that brand, and
+  // keeps its measured failures. `false` keeps it a reference search: what
+  // Baker sends when it narrowed to the company's followed brands itself.
+  brand_browse: z.boolean().optional(),
+  min_relevance: z.number().min(0).max(1).optional(),
+  // One page picked for variety (different brands, containers and hooks)
+  // instead of rank order: a reference set for N concepts. Ignores offset.
+  diverse: z.boolean().optional(),
+  // The order of a browse (no query): by winner score (default), by how long
+  // the ad has run, or by when it was first seen. A query ranks by relevance
+  // blended with winner score, so `sort` only means something without one.
+  sort: winnersSortSchema.optional(),
+  hard_filters: winnersHardFiltersSchema.optional(),
+  // `score_breakdown` surfaces the "why it ranked" panel; facets drive the
+  // filter rail. thumbnails/full_dna_url are opt-in extras.
+  include: z.array(z.enum(["score_breakdown", "facets", "full_dna_url", "thumbnails"])).optional()
+});
+var hasSearchInput = (b) => b.free_text_query !== void 0 || b.ref_ad_id !== void 0 || b.hard_filters !== void 0;
+var SEARCH_INPUT_MESSAGE = "Provide free_text_query, ref_ad_id, or hard_filters";
+var winnerSearchScopeSchema = z.enum(["all", "followed", "followed-first"]);
+var scopedWinnersSearchRequestSchema = winnersSearchFields.extend({
+  scope: winnerSearchScopeSchema.default("followed-first"),
+  hard_filters: validatedHardFiltersSchema.optional()
+}).refine(hasSearchInput, { message: SEARCH_INPUT_MESSAGE }).refine((b) => b.scope !== "followed-first" || !b.offset, {
+  message: "offset is not supported with scope followed-first; raise limit instead"
+});
+var winningAdDnaSchema = z.object({
+  creative_concept: z.string().nullable(),
+  angle: z.string().nullable(),
+  awareness_stage: z.string().nullable(),
+  // How many claims the ad's market has already heard (s1 first to say it … s5 tired of claims).
+  // Optional while an older ad-dna does not send it.
+  sophistication_stage: z.string().nullable().optional(),
+  audience_temperature: z.string().nullable(),
+  // Who else the ad was made for, and whether its copy only works on viewers who
+  // already know the brand (null: not judged yet). Optional while an older
+  // ad-dna does not send them.
+  funnel_stage: z.string().nullable().optional(),
+  advertiser_size: z.string().nullable().optional(),
+  presumes_brand_knowledge: z.boolean().nullable().optional(),
+  brand_knowledge_reason: z.string().nullable().optional(),
+  target_persona: z.string().nullable(),
+  hook_archetype: z.string().nullable(),
+  // The proven hook pattern (`winning-ads hooks` seed) the free-text
+  // `hook_archetype` matches: the value two ads can share. Optional while an
+  // older ad-dna does not send it.
+  hook_seed: z.string().nullable().optional(),
+  creator_type: z.string().nullable(),
+  industry: z.string().nullable(),
+  business_model: z.string().nullable(),
+  // What the viewer sees, the static's container (comparison_table, …) and why
+  // it works: pick a reference on its move, not on its angle label.
+  visual: z.string().nullable(),
+  container: z.string().nullable(),
+  mechanism: z.string().nullable()
+});
+var winningAdScoreBreakdownSchema = z.object({
+  relevance: z.number().nullable(),
+  judge_reason: z.string().nullable(),
+  winner_score: z.number().nullable(),
+  final_score: z.number().nullable()
+});
+var winningAdSchema = z.object({
+  ad_id: z.string().nullable(),
+  advertiser_id: z.string().nullable(),
+  advertiser: z.string().nullable(),
+  platform: z.string().nullable(),
+  format: z.string().nullable(),
+  media_url: z.string().nullable(),
+  media_kind: z.string().nullable(),
+  thumbnail_url: z.string().nullable(),
+  // Query match ∈ [0,1]; null on pure winner browse (no query).
+  relevance: z.number().nullable(),
+  // How proven in-market (global creative strength).
+  winner_score: z.number().nullable(),
+  winner_category: z.string().nullable(),
+  // The score ad-dna ranked the result by (relevance blended with winner
+  // score, or the winner score on a browse). Search results only.
+  final_score: z.number().nullable().optional(),
+  days_active: z.number().nullable(),
+  reach: z.number().nullable(),
+  // Null when the brand hasn't been checked recently enough to say.
+  active: z.boolean().nullable(),
+  // When the brand's ads were last checked: the date `active` was observed.
+  active_checked_at: z.string().nullable(),
+  // Creative family grouping (search dedups launches into one card).
+  creative_id: z.string().nullable(),
+  family_id: z.string().nullable(),
+  member_count: z.number().nullable(),
+  sibling_ad_ids: z.array(z.string()),
+  // Where the ad is in its life, and whether it is the version its brand kept
+  // after testing: what competitors kept is a stronger reference than what
+  // merely runs. Search results only; absent on an older ad-dna.
+  stage: adLifecycleStageSchema.nullable().optional(),
+  survived_test: z.boolean().nullable().optional(),
+  dna: winningAdDnaSchema,
+  score_breakdown: winningAdScoreBreakdownSchema.nullable()
+});
+var facetCountSchema = z.object({ value: z.string(), label: z.string().optional(), count: z.number() });
+var winnersFacetsSchema = z.object({
+  industry: z.array(facetCountSchema),
+  creator_type: z.array(facetCountSchema),
+  winner_category: z.array(facetCountSchema),
+  format: z.array(facetCountSchema),
+  business_model: z.array(facetCountSchema)
+});
+var winnersSearchResponseSchema = z.object({
+  results: z.array(winningAdSchema),
+  facets: winnersFacetsSchema.nullable(),
+  pool_size: z.number().nullable(),
+  // Bucketed confidence of the top match; null on pure browse.
+  match_confidence: z.enum(["high", "medium", "low"]).nullable(),
+  below_floor_count: z.number().nullable(),
+  query_id: z.string().nullable(),
+  // Pagination window for infinite scroll. `offset` echoes the request; `total`
+  // is how many winners this query+filters can scroll through; `has_more` is
+  // true when more pages exist. Null on an older ad-dna that predates paging —
+  // the dashboard then falls back to a single non-paged page.
+  offset: z.number().nullable(),
+  total: z.number().nullable(),
+  has_more: z.boolean().nullable(),
+  // Ads the corpus holds for each requested `country`; null when the search did
+  // not filter by country. Tells "no winners matched" apart from "unsupported"
+  // (an unknown code is refused outright).
+  country_coverage: z.array(z.object({ code: z.string(), ads: z.number() })).nullable()
+});
+var winnerSourceSchema = z.enum(["followed", "library"]);
+var referenceUsesSchema = z.object({
+  companies: z.number(),
+  ours: z.boolean(),
+  approved: z.number(),
+  rejected: z.number()
+});
+var scopedWinningAdSchema = winningAdSchema.extend({
+  source: winnerSourceSchema,
+  baker_uses: referenceUsesSchema.optional()
+});
+var scopedWinnersSearchResponseSchema = winnersSearchResponseSchema.extend({
+  results: z.array(scopedWinningAdSchema),
+  scope: winnerSearchScopeSchema,
+  // How many brands the company follows; 0 means `followed` answers empty and
+  // `followed-first` is the whole library.
+  following_count: z.number()
+});
+var advertiserPlatformSchema = z.object({
+  platform: z.string(),
+  external_id: z.string().nullable(),
+  region: z.string().nullable()
+});
+var corpusAdvertiserSchema = z.object({
+  advertiser_id: z.string(),
+  label: z.string().nullable(),
+  scraped_name: z.string().nullable(),
+  image_url: z.string().nullable(),
+  platforms: z.array(advertiserPlatformSchema),
+  platform_count: z.number().nullable(),
+  family_count: z.number().nullable(),
+  active_ad_count: z.number().nullable(),
+  total_ad_count: z.number().nullable(),
+  total_reach: z.number().nullable(),
+  last_synced_at: z.string().nullable()
+});
+var advertiserSearchRequestSchema = z.object({
+  q: z.string().optional(),
+  platform: adLibraryPlatformSchema.optional(),
+  limit: z.number().int().min(1).max(100).optional(),
+  offset: z.number().int().min(0).optional()
+});
+var advertiserSearchResponseSchema = z.object({
+  advertisers: z.array(corpusAdvertiserSchema),
+  total: z.number().nullable()
+});
+var advertiserConvergenceSchema = z.object({
+  convergence_state: z.string().nullable(),
+  dimension_summary: z.unknown().nullable(),
+  iteration_velocity_30d: z.number().nullable(),
+  last_refresh_completed_at: z.string().nullable()
+});
+var profileFormatSchema = z.enum(["image", "video", "carousel", "text"]);
+var profileAdRefSchema = z.object({
+  ad_id: z.string(),
+  platform: z.string(),
+  format: profileFormatSchema,
+  headline: z.string().nullable(),
+  media_url: z.string().nullable(),
+  media_kind: z.enum(["image", "video"]).nullable(),
+  is_active: z.boolean()
+});
+var formatMixSchema = z.record(profileFormatSchema, z.number());
+var spendFigureSchema = z.object({ min: z.number(), low: z.number(), high: z.number() });
+var advertiserSpendSchema = spendFigureSchema.extend({
+  currency: z.literal("USD"),
+  method: z.string(),
+  last_30_days: spendFigureSchema,
+  by_platform: z.array(spendFigureSchema.extend({ platform: z.string(), ads: z.number(), measured_ads: z.number() })),
+  measured_ads: z.number(),
+  extrapolated_ads: z.number(),
+  unpriced_ads: z.number()
+});
+var creativeTestSchema = z.object({
+  family_id: z.string(),
+  concept: z.string().nullable(),
+  launched_at: z.string(),
+  versions: z.number(),
+  still_running: z.number(),
+  cut_early: z.number(),
+  status: z.enum(["running", "decided"]),
+  // When it was decided: the first version cut, or its third week with none cut. Null while running.
+  decided_at: z.string().nullable().optional(),
+  winner_ad_id: z.string().nullable(),
+  ad_ids: z.array(z.string()),
+  what_differed: z.array(z.object({ dimension: z.string(), winner: z.string(), others: z.array(z.string()) }))
+});
+var advertiserProfileSchema = z.object({
+  spend: advertiserSpendSchema.nullable(),
+  tests: z.array(creativeTestSchema),
+  launch_weeks: z.array(
+    z.object({ week_start: z.string(), launched: z.number(), still_running: z.number(), stopped_early: z.number() })
+  ),
+  similar: z.array(
+    z.object({
+      advertiser_id: z.string(),
+      label: z.string().nullable(),
+      shared_ads: z.number(),
+      platforms: z.array(z.string())
+    })
+  ),
+  launch_calendar: z.array(
+    z.object({ date: z.string(), launched: z.number(), still_running: z.number(), ads: z.array(profileAdRefSchema) })
+  ),
+  recent_launches: z.array(
+    profileAdRefSchema.extend({ first_seen_at: z.string().nullable(), stage: adLifecycleStageSchema })
+  ),
+  landing_pages: z.array(
+    z.object({
+      page: z.string(),
+      url: z.string(),
+      ads: z.number(),
+      active_ads: z.number(),
+      last_seen_at: z.string().nullable()
+    })
+  ),
+  audiences: z.object({
+    inferred: z.array(z.object({ audience: z.string(), ads: z.number() })),
+    measured: z.object({
+      ages: z.array(z.object({ age_range: z.string(), male: z.number(), female: z.number(), unknown: z.number() })),
+      countries: z.array(z.object({ country: z.string(), reach: z.number() }))
+    }).nullable(),
+    /**
+     * Google: who the ads were declared to target (by how many ads name each
+     * value) and the countries Google showed them in, by impressions. Google
+     * publishes both only for ads shown in the EU. Null when no ad carries any.
+     */
+    targeting: z.object({
+      ages: z.array(z.object({ value: z.string(), ads: z.number() })),
+      genders: z.array(z.object({ value: z.string(), ads: z.number() })),
+      locations: z.array(z.object({ value: z.string(), excluded: z.boolean(), ads: z.number() })),
+      countries: z.array(z.object({ country: z.string(), impressions: z.number() }))
+    }).nullable().optional()
+  }),
+  freshness: z.object({
+    last_checked_at: z.string().nullable(),
+    next_scan_at: z.string().nullable(),
+    platforms: z.array(z.object({ platform: z.string(), last_checked_at: z.string().nullable() }))
+  }),
+  media_mix: z.object({ total: formatMixSchema, active: formatMixSchema }),
+  platform_split: z.object({ total: z.record(z.string(), z.number()), active: z.record(z.string(), z.number()) }),
+  counts: z.object({
+    total_ads: z.number(),
+    active_ads: z.number(),
+    unique_creatives: z.number(),
+    unique_copies: z.number(),
+    unique_headlines: z.number(),
+    unique_landing_pages: z.number(),
+    new_ads_per_week: z.number()
+  })
+});
+var advertiserLaunchesSchema = z.object({
+  since_days: z.number(),
+  advertisers: z.array(
+    z.object({
+      advertiser_id: z.string(),
+      label: z.string().nullable(),
+      launched: z.number(),
+      still_running: z.number(),
+      launches: z.array(
+        profileAdRefSchema.extend({ first_seen_at: z.string().nullable(), stage: adLifecycleStageSchema })
+      ),
+      // The tests the brand decided in the window: the version kept and what
+      // differed. Absent on an older ad-dna.
+      tests_decided: z.array(creativeTestSchema).optional()
+    })
+  )
+});
+var advertiserLandingPageSchema = z.object({
+  /** `https://host/path`, no www., query or fragment: the page's identity and the address it is analysed at. */
+  canonical_url: z.string(),
+  /** The link of the page's most recently seen ad. */
+  url: z.string(),
+  domain: z.string(),
+  path: z.string(),
+  ads: z.number(),
+  active_ads: z.number(),
+  platforms: z.array(z.string()),
+  first_seen_at: z.string().nullable(),
+  last_seen_at: z.string().nullable(),
+  ads_sample: z.array(profileAdRefSchema)
+});
+var advertiserLandingPagesSchema = z.object({
+  advertiser_id: z.string(),
+  total_pages: z.number(),
+  pages: z.array(advertiserLandingPageSchema)
+});
+var landingAnalysisStatusSchema = z.enum(["not_analysed", "analysing", "ready", "failed"]);
+var landingPitchSchema = z.object({
+  headline: z.string().nullable(),
+  subheadline: z.string().nullable(),
+  value_propositions: z.array(z.string()),
+  offer: z.string().nullable(),
+  pricing: z.array(z.string()),
+  ctas: z.array(z.string()),
+  proof: z.array(z.object({ kind: z.string(), detail: z.string() })),
+  audience: z.string().nullable(),
+  summary: z.string(),
+  /** The page's sections top to bottom (site chrome left out). */
+  sections: z.array(z.object({ type: z.string(), headline: z.string().nullable() }))
+});
+var landingAnalysisSchema = z.object({
+  status: landingAnalysisStatusSchema,
+  title: z.string().nullable(),
+  /** The whole page, top to bottom; read the top for a thumbnail. */
+  screenshot_url: z.string().nullable(),
+  studied_at: z.string().nullable(),
+  /** Why the page could not be read, in product words; null unless `failed`. */
+  error: z.string().nullable(),
+  /** Null until the page's pitch has been read. */
+  pitch: landingPitchSchema.nullable()
+});
+var brandLandingPagesSchema = z.object({
+  advertiser_id: z.string(),
+  total_pages: z.number(),
+  pages: z.array(advertiserLandingPageSchema.extend({ analysis: landingAnalysisSchema }))
+});
+var LANDING_ANALYSE_BATCH = 5;
+var analyseLandingPagesRequestSchema = z.object({
+  urls: z.array(z.string().min(1)).min(1).max(LANDING_ANALYSE_BATCH)
+});
+var analyseLandingPagesResponseSchema = z.object({
+  pages: z.array(z.object({ url: z.string(), status: landingAnalysisStatusSchema, error: z.string().nullable() }))
+});
+var resolvePreviewSchema = z.object({
+  platform: adLibraryPlatformSchema,
+  external_id: z.string(),
+  name: z.string(),
+  image_url: z.string().nullable(),
+  category: z.string().nullable(),
+  industry: z.string().nullable(),
+  website: z.string().nullable(),
+  followers: z.number().nullable()
+});
+var followedStatusSchema = z.enum(["discovering", "ingesting", "ready"]);
+var followedAdvertiserSchema = z.object({
+  // Baker subscription row id (used to unfollow).
+  followed_id: z.string(),
+  advertiser_id: z.string(),
+  label: z.string(),
+  image_url: z.string().nullable(),
+  platforms: z.array(z.object({ platform: adLibraryPlatformSchema, external_id: z.string() })),
+  status: followedStatusSchema,
+  active_ad_count: z.number().nullable(),
+  total_ad_count: z.number().nullable(),
+  family_count: z.number().nullable(),
+  // Progress while status is "discovering" or "ingesting". `adding_ingested`
+  // and `adding_enqueued` are both counts for the CURRENT run, so they read as
+  // a fraction; `total_ad_count` is the brand's whole corpus and is not.
+  adding_discovered: z.number().nullable(),
+  adding_enqueued: z.number().nullable(),
+  adding_ingested: z.number().nullable(),
+  // A discovery job ended in failure, so this brand's ads are under-counted.
+  // Distinguishes "we couldn't finish looking" from "this brand runs no ads".
+  discovery_failed: z.boolean().nullable()
+});
+var followingListResponseSchema = z.object({
+  following: z.array(followedAdvertiserSchema)
+});
+var followRequestSchema = z.object({
+  input: z.string().min(1),
+  platform: adLibraryPlatformSchema,
+  // Optional override for the display label; defaults to the resolved name.
+  label: z.string().optional()
+});
+var followResponseSchema = z.object({
+  // "following" = subscribed to an advertiser already in the corpus (no
+  // ingestion). "added" = a new advertiser was enqueued for discovery.
+  // "ambiguous" = the identity mapped to multiple corpus advertisers; the
+  // caller must pick one of `candidates`.
+  status: z.enum(["following", "added", "ambiguous"]),
+  advertiser: followedAdvertiserSchema.nullable(),
+  preview: resolvePreviewSchema.nullable(),
+  candidates: z.array(corpusAdvertiserSchema).nullable()
+});
+var FOLLOW_BATCH_MAX = 50;
+var followBatchRequestSchema = z.object({
+  // One entry per brand — a domain (best; resolves both Meta + LinkedIn), a
+  // profile / ad-library URL, or a brand name.
+  inputs: z.array(z.string().min(1)).min(1).max(FOLLOW_BATCH_MAX),
+  // How to read every input (not a tracking limit — a domain still resolves
+  // every platform we can). Defaults to reading inputs as Meta identities.
+  platform: adLibraryPlatformSchema.default("meta")
+});
+var followBatchResultSchema = z.object({
+  // Echoes the input so the caller can line results up with what it sent.
+  input: z.string(),
+  // "following"/"added" mirror the single-follow statuses; "ambiguous" needs a
+  // manual pick; "failed" = we couldn't resolve or add it (see `error`).
+  status: z.enum(["following", "added", "ambiguous", "failed"]),
+  advertiser: followedAdvertiserSchema.nullable(),
+  // Present only when status is "failed" — a plain-language reason.
+  error: z.string().nullable()
+});
+var followBatchResponseSchema = z.object({
+  results: z.array(followBatchResultSchema),
+  // Rollup counts across the batch for a one-glance summary.
+  followed_count: z.number(),
+  added_count: z.number(),
+  ambiguous_count: z.number(),
+  failed_count: z.number()
+});
+var unfollowRequestSchema = z.object({
+  // Accept either the Baker subscription id or the corpus advertiser id.
+  followed_id: z.string().optional(),
+  advertiser_id: z.string().optional()
+});
+var unfollowResponseSchema = z.object({ removed: z.boolean() });
+var platformWinnersSchema = z.object({
+  platform: adLibraryPlatformSchema,
+  winners: z.array(winningAdSchema)
+});
+var advertiserWinnersResponseSchema = z.object({
+  advertiser_id: z.string(),
+  winners: z.array(winningAdSchema),
+  // `per_platform`: each platform's own top winners. Scores are not comparable
+  // across platforms, so the all-platform list can be one platform's ads only.
+  by_platform: z.array(platformWinnersSchema).optional()
+});
+var advertiserAdsRunningSchema = z.enum(["all", "running", "stopped"]);
+var ADVERTISER_ADS_MAX_LIMIT = 100;
+var advertiserAdsRequestSchema = z.object({
+  id: z.string().min(1),
+  platform: adLibraryPlatformSchema.optional(),
+  running: advertiserAdsRunningSchema.default("all"),
+  // Comma list ("text,video"): only those formats; every format when absent.
+  format: z.string().transform(
+    (s) => s.split(",").map((f) => f.trim()).filter(Boolean)
+  ).pipe(z.array(adFormatSchema).min(1)).optional(),
+  limit: z.coerce.number().int().min(1).max(ADVERTISER_ADS_MAX_LIMIT).default(24),
+  offset: z.coerce.number().int().min(0).default(0)
+});
+var advertiserAdsResponseSchema = z.object({
+  advertiser_id: z.string(),
+  ads: z.array(winningAdSchema),
+  // Every ad the filters match; null from an older library, where a short page means the end.
+  total: z.number().nullable()
+});
+var searchHeadlineHookSchema = z.enum([
+  "category",
+  "brand",
+  "free",
+  "price_discount",
+  "outcome",
+  "proof",
+  "new_timely",
+  "comparison",
+  "audience",
+  "location",
+  "feature",
+  "call_to_action",
+  "question"
+]);
+var searchCopyRequestSchema = z.object({
+  id: z.string().min(1),
+  limit: z.coerce.number().int().min(1).max(100).default(15)
+});
+var searchCopyPartSchema = z.object({
+  text: z.string(),
+  // "dropped": every ad that carried it has stopped.
+  status: z.enum(["running", "dropped"]),
+  ads: z.number(),
+  running_ads: z.number(),
+  first_seen: z.string().nullable(),
+  last_seen: z.string().nullable(),
+  longest_days: z.number().nullable(),
+  landing_pages: z.array(z.string()),
+  example_ad_id: z.string()
+});
+var searchCopySchema = z.object({
+  // `read`: ads whose parts have been read; the rest were extracted before.
+  totals: z.object({ ads: z.number(), running: z.number(), read: z.number(), with_sitelinks: z.number() }),
+  headlines: z.array(
+    searchCopyPartSchema.extend({ hook: searchHeadlineHookSchema.nullable(), names_rival: z.boolean() })
+  ),
+  descriptions: z.array(searchCopyPartSchema),
+  sitelinks: z.array(searchCopyPartSchema),
+  callouts: z.array(searchCopyPartSchema),
+  hooks: z.array(z.object({ hook: searchHeadlineHookSchema, running: z.number(), dropped: z.number() })),
+  rival_headlines: z.array(z.string())
+});
+var searchCopyResponseSchema = searchCopySchema.extend({ advertiser_id: z.string() });
+var feedRequestSchema = z.object({
+  // Optional subset of your followed advertiser ids to narrow to ("trim down
+  // per advertiser"). Ids you don't follow are ignored and echoed back in
+  // `unknown_requested`. Omit to browse winners across every brand you follow.
+  advertiser_ids: z.array(z.string()).optional(),
+  platform: adLibraryPlatformSchema.optional(),
+  winner_category: z.array(z.string()).optional(),
+  format: z.array(z.string()).optional(),
+  // The feed shows designed pictures and videos by default; `true` adds Google
+  // search text, Shopping and app ads.
+  all_kinds: z.boolean().optional(),
+  // Winners kept per advertiser so no single brand floods the feed. `0` = no
+  // cap. Default applied by the route.
+  per_advertiser: z.number().int().min(0).max(50).optional(),
+  // Total winners returned across all followed advertisers.
+  limit: z.number().int().min(1).max(200).optional()
+});
+var feedResponseSchema = z.object({
+  // The feed only ever reads followed brands, so every winner is `followed`:
+  // the same `source` a scoped search carries, so the surfaces agree.
+  winners: z.array(winningAdSchema.extend({ source: winnerSourceSchema })),
+  // How many brands the company follows (regardless of the trim).
+  following_count: z.number(),
+  // The advertiser ids actually queried (follows ∩ requested subset).
+  advertiser_ids: z.array(z.string()),
+  // Requested ids that aren't followed — a hint the caller mistyped or hasn't
+  // followed them yet.
+  unknown_requested: z.array(z.string())
+});
+var seedCatalogFieldSchema = z.enum(["hook_archetype", "mechanism_type", "static_format_pattern"]);
+var seedCatalogRequestSchema = z.object({
+  field: seedCatalogFieldSchema,
+  platform: z.string().optional(),
+  awareness_stage: z.string().optional(),
+  industry: z.string().optional(),
+  limit: z.number().int().min(1).max(100).optional()
+});
+var patternSeedSchema = z.object({
+  key: z.string(),
+  count: z.number(),
+  sum_winner_score: z.number(),
+  mean_winner_score: z.number(),
+  winner_share: z.number(),
+  // How the seed did inside the brands that used it, the order of the catalog:
+  // the mean, over brands, of how much more often their creatives with the seed
+  // ran 60 days than their others (0 until five brands have a verdict), and
+  // how many brands it won and lost inside.
+  lift: z.number(),
+  brands_for: z.number(),
+  brands_against: z.number(),
+  // Per-segment counts (platform/awareness_stage/industry → value → n); present
+  // only on `--full`, so the response can stay lean by default.
+  breakdown_by: z.record(z.string(), z.unknown()).nullable()
+});
+var seedCatalogSegmentSchema = z.object({
+  platform: z.string().nullable(),
+  awareness_stage: z.string().nullable(),
+  industry: z.string().nullable()
+});
+var seedCatalogResponseSchema = z.object({
+  field: z.string(),
+  segment: seedCatalogSegmentSchema.nullable(),
+  patterns: z.array(patternSeedSchema)
+});
+var adContentRequestSchema = z.object({
+  ad_id: z.string().min(1),
+  platform: adLibraryPlatformSchema.optional()
+});
+var referenceReadRequestSchema = z.object({
+  ad_id: z.string().min(1),
+  platform: adLibraryPlatformSchema.default("meta")
+});
+var referenceReadResponseSchema = z.object({
+  blueprint: z.record(z.string(), z.unknown()),
+  elements: z.array(z.unknown()),
+  credits_charged: z.number(),
+  reused: z.boolean()
+});
+var adContentOverlaySchema = z.object({
+  text: z.string(),
+  appears_at_s: z.number().nullable(),
+  position: z.string().nullable(),
+  role: z.string().nullable(),
+  card: z.number().nullable()
+});
+var adContentSpeechSchema = z.object({
+  speech_pct_of_runtime: z.number().nullable(),
+  speaker_count: z.number().nullable(),
+  voiceover_vs_sync: z.string().nullable(),
+  is_direct_address: z.boolean().nullable(),
+  speech_emotion_dominant: z.string().nullable()
+});
+var adContentPacingSchema = z.object({
+  scene_count: z.number().nullable(),
+  avg_shot_length_s: z.number().nullable(),
+  pacing_shape: z.string().nullable(),
+  hook_ends_at_s: z.number().nullable(),
+  cta_first_shown_at_s: z.number().nullable(),
+  product_first_appears_at_s: z.number().nullable()
+});
+var adContentMusicSchema = z.object({
+  track_title: z.string().nullable(),
+  track_artist: z.string().nullable()
+});
+var adContentLayoutSchema = z.object({
+  format_pattern: z.string().nullable(),
+  composition: z.string().nullable(),
+  focal_subject: z.string().nullable(),
+  aspect_ratio: z.string().nullable(),
+  background: z.string().nullable(),
+  palette_mood: z.string().nullable(),
+  colors: z.array(z.string()),
+  production: z.string().nullable(),
+  aesthetic: z.array(z.string()),
+  cta_in_image: z.string().nullable(),
+  markers: z.array(z.string()),
+  card_roles: z.array(z.string())
+});
+var adContentMessageSchema = z.object({
+  awareness_stage: z.string().nullable(),
+  sophistication: z.string().nullable(),
+  mechanism: z.string().nullable(),
+  pain_points: z.array(z.string()),
+  desires: z.array(z.string()),
+  value_props: z.array(z.string()),
+  objections_handled: z.array(z.string()),
+  proof: z.array(z.string()),
+  risk_reversal: z.array(z.string())
+});
+var adContentOfferSchema = z.object({
+  offer_type: z.string().nullable(),
+  pricing_model: z.string().nullable(),
+  entry_price: z.string().nullable(),
+  no_credit_card: z.boolean().nullable(),
+  guarantee: z.array(z.string()),
+  guarantee_days: z.number().nullable(),
+  urgency: z.string().nullable(),
+  bonus: z.string().nullable()
+});
+var adLifecycleSchema = z.object({
+  stage: adLifecycleStageSchema,
+  survived_test: z.boolean(),
+  test: creativeTestSchema.nullable()
+});
+var GOOGLE_AD_TYPES = ["search", "display", "shopping", "youtube", "app"];
+var googleAdTypeSchema = z.enum(GOOGLE_AD_TYPES);
+var adContentSchema = z.object({
+  ad_id: z.string().nullable(),
+  advertiser: z.string().nullable(),
+  advertiser_id: z.string().nullable(),
+  platform: z.string().nullable(),
+  format: z.string().nullable(),
+  media_kind: z.string().nullable(),
+  media_url: z.string().nullable(),
+  winner_score: z.number().nullable(),
+  winner_category: z.string().nullable(),
+  summary: z.string().nullable(),
+  angle: z.string().nullable(),
+  hook_archetype: z.string().nullable(),
+  // Spoken words (video only; null when the ad has no speech track).
+  transcript: z.string().nullable(),
+  has_speech: z.boolean().nullable(),
+  speech: adContentSpeechSchema,
+  // On-screen text / captions.
+  has_captions: z.boolean().nullable(),
+  caption_style: z.string().nullable(),
+  on_screen_text: z.array(adContentOverlaySchema),
+  // Copy the viewer reads outside the media.
+  primary_text: z.string().nullable(),
+  headline: z.string().nullable(),
+  // Where the ad sends people; optional while an older backend does not send it.
+  landing_url: z.string().nullable().optional(),
+  cta: z.string().nullable(),
+  // Structure + soundtrack.
+  pacing: adContentPacingSchema,
+  music: adContentMusicSchema,
+  layout: adContentLayoutSchema,
+  message: adContentMessageSchema,
+  offer: adContentOfferSchema,
+  // Where the ad is in its life, whether it is the version its brand kept
+  // after testing, and the test when it is one version of a tested concept.
+  // Absent on an older ad-dna.
+  lifecycle: adLifecycleSchema.nullable().optional(),
+  // Which kind of Google ad it is; null off Google or when the library does
+  // not say. Absent on an older ad-dna.
+  google_ad_type: googleAdTypeSchema.nullable().optional()
+});
+var adContentResponseSchema = z.object({ ad: adContentSchema });
+var adDnaColorSchema = z.object({
+  hex: z.string(),
+  share: z.number().nullable()
+});
+var adDnaSceneSchema = z.object({
+  start_s: z.number(),
+  end_s: z.number(),
+  role: z.string().nullable(),
+  visual: z.string(),
+  speech: z.string().nullable(),
+  on_screen_text: z.string().nullable(),
+  sound: z.string().nullable()
+});
+var adDnaMomentSchema = z.object({
+  kind: z.enum(["hook_ends", "product", "price", "cta", "logo"]),
+  at_s: z.number()
+});
+var adDnaStorySchema = z.object({
+  duration_s: z.number().nullable(),
+  summary: z.string().nullable(),
+  hook: z.string().nullable(),
+  scenes: z.array(adDnaSceneSchema),
+  moments: z.array(adDnaMomentSchema)
+});
+var adDnaCardSchema = z.object({
+  index: z.number(),
+  role: z.string().nullable(),
+  layout: z.string().nullable(),
+  colors: z.array(adDnaColorSchema),
+  open_loop: z.string().nullable(),
+  transition: z.string().nullable()
+});
+var adDnaAgeReachSchema = z.object({
+  age_range: z.string(),
+  female: z.number(),
+  male: z.number(),
+  unknown: z.number()
+});
+var adDnaReachSchema = z.object({
+  total: z.number().nullable(),
+  eu_total: z.number().nullable(),
+  ages: z.object({ min: z.number(), max: z.number() }).nullable(),
+  gender: z.string().nullable(),
+  locations: z.array(z.string()),
+  excluded_locations: z.array(z.string()),
+  channels: z.array(z.string()),
+  by_age: z.array(adDnaAgeReachSchema)
+});
+var adDnaTraitSchema = z.object({
+  key: z.string(),
+  value: z.union([z.string(), z.number(), z.boolean(), z.array(z.string())])
+});
+var adDnaTraitGroupKeySchema = z.enum([
+  "audience",
+  "business",
+  "message",
+  "copy",
+  "look",
+  "cast",
+  "pacing",
+  "sound",
+  "on_screen_text",
+  "branding",
+  "subject",
+  "cta_visual",
+  "markers",
+  "carousel",
+  "offer",
+  "delivery"
+]);
+var adDnaTraitGroupSchema = z.object({
+  key: adDnaTraitGroupKeySchema,
+  traits: z.array(adDnaTraitSchema)
+});
+var adDnaDetailSchema = z.object({
+  palette: z.array(adDnaColorSchema),
+  background_hex: z.string().nullable(),
+  button_hex: z.string().nullable(),
+  story: adDnaStorySchema.nullable(),
+  cards: z.array(adDnaCardSchema),
+  reach: adDnaReachSchema.nullable(),
+  groups: z.array(adDnaTraitGroupSchema),
+  extracted_at: z.string().nullable()
+});
+var adCardMediaSchema = z.object({
+  index: z.number(),
+  url: z.string(),
+  kind: z.enum(["image", "video"]).nullable()
+});
+var adDetailSchema = z.object({
+  content: adContentSchema,
+  dna: adDnaDetailSchema,
+  card_media: z.array(adCardMediaSchema)
+});
+
+export {
+  adLibraryPlatformSchema,
+  staticFormatPatternSchema,
+  winnersSortSchema,
+  winnerSearchScopeSchema,
+  scopedWinnersSearchRequestSchema,
+  LANDING_ANALYSE_BATCH,
+  FOLLOW_BATCH_MAX,
+  advertiserAdsRequestSchema,
+  referenceReadResponseSchema
+};
+//# sourceMappingURL=chunk-VAOMHPEX.js.map