@nodaro/shared 1.4.1

package/src/__tests__/scraper-actors.test.ts

@@ -0,0 +1,67 @@
+import { describe, it, expect } from "vitest"
+import {
+  SCRAPER_ACTOR_IDS,
+  SCRAPER_ACTOR_LABELS,
+  SCRAPER_CREDIT_COSTS,
+  buildScraperCreditId,
+  isScraperActor,
+  resolveScraperCreditId,
+} from "../scraper-actors.js"
+
+describe("scraper-actors", () => {
+  it("exposes 5 curated actor ids", () => {
+    expect(SCRAPER_ACTOR_IDS).toEqual(["content-crawler", "google-search", "instagram", "tiktok", "rss"])
+  })
+
+  it("returns flat credit id for google-search", () => {
+    expect(buildScraperCreditId({ actor: "google-search" })).toBe("web-scrape:google-search")
+  })
+
+  it("splits content-crawler by mode", () => {
+    expect(buildScraperCreditId({ actor: "content-crawler", mode: "page" })).toBe("web-scrape:content-crawler")
+    expect(buildScraperCreditId({ actor: "content-crawler", mode: "site" })).toBe("web-scrape:content-crawler:site")
+  })
+
+  it("defaults content-crawler to page mode when mode missing", () => {
+    expect(buildScraperCreditId({ actor: "content-crawler" })).toBe("web-scrape:content-crawler")
+  })
+
+  it("isScraperActor validates values", () => {
+    expect(isScraperActor("instagram")).toBe(true)
+    expect(isScraperActor("bogus")).toBe(false)
+  })
+
+  describe("resolveScraperCreditId", () => {
+    it("reads actor + mode from raw body", () => {
+      expect(resolveScraperCreditId({ actor: "content-crawler", mode: "site" })).toBe("web-scrape:content-crawler:site")
+      expect(resolveScraperCreditId({ actor: "instagram" })).toBe("web-scrape:instagram")
+    })
+
+    it("falls back to cheapest SKU for missing or invalid actor", () => {
+      expect(resolveScraperCreditId({})).toBe("web-scrape:google-search")
+      expect(resolveScraperCreditId({ actor: "bogus" })).toBe("web-scrape:google-search")
+      expect(resolveScraperCreditId(undefined)).toBe("web-scrape:google-search")
+      expect(resolveScraperCreditId(null)).toBe("web-scrape:google-search")
+    })
+
+    it("treats non-site mode values as page for content-crawler", () => {
+      expect(resolveScraperCreditId({ actor: "content-crawler", mode: "weird" })).toBe("web-scrape:content-crawler")
+      expect(resolveScraperCreditId({ actor: "content-crawler" })).toBe("web-scrape:content-crawler")
+    })
+  })
+
+  it("labels cover every actor id", () => {
+    for (const id of SCRAPER_ACTOR_IDS) {
+      expect(SCRAPER_ACTOR_LABELS[id]).toBeTruthy()
+    }
+  })
+
+  it("credit costs include bare fallback + every composite SKU", () => {
+    expect(SCRAPER_CREDIT_COSTS["web-scrape"]).toBe(2)
+    expect(SCRAPER_CREDIT_COSTS["web-scrape:google-search"]).toBe(3)
+    expect(SCRAPER_CREDIT_COSTS["web-scrape:content-crawler"]).toBe(1)
+    expect(SCRAPER_CREDIT_COSTS["web-scrape:content-crawler:site"]).toBe(5)
+    expect(SCRAPER_CREDIT_COSTS["web-scrape:instagram"]).toBe(1)
+    expect(SCRAPER_CREDIT_COSTS["web-scrape:tiktok"]).toBe(1)
+  })
+})

package/src/__tests__/seedance-2-catalog.test.ts

@@ -0,0 +1,18 @@
+import { describe, it, expect } from "vitest"
+import { MODEL_CATALOG } from "../model-catalog.js"
+
+describe("seedance-2 catalog", () => {
+  it("full seedance-2 exposes 4k", () => {
+    expect(MODEL_CATALOG["seedance-2"].resolutions).toContain("4k")
+  })
+  it("seedance-2 offers the adaptive aspect ratio", () => {
+    expect(MODEL_CATALOG["seedance-2"].aspectRatios).toContain("adaptive")
+  })
+  it("fast and mini do NOT get 4k (separate KIE models, 480p/720p only)", () => {
+    expect(MODEL_CATALOG["seedance-2-fast"].resolutions).not.toContain("4k")
+    expect(MODEL_CATALOG["seedance-2-mini"].resolutions).not.toContain("4k")
+  })
+  it("fast is 480p/720p ONLY — no phantom 1080p (KIE has no SKU for it)", () => {
+    expect(MODEL_CATALOG["seedance-2-fast"].resolutions).toEqual(["480p", "720p"])
+  })
+})

package/src/__tests__/seedance-2-credit-id.test.ts

@@ -0,0 +1,23 @@
+import { describe, it, expect } from "vitest"
+import { buildVideoCreditModelIdentifier } from "../credit-identifiers.js"
+
+describe("seedance-2 4k credit identifier", () => {
+  it("4k no-ref → seedance-2:8s:4k (NOT clamped to 480p)", () => {
+    expect(buildVideoCreditModelIdentifier("seedance-2", 8, false, "image-to-video", undefined, "4k", false))
+      .toBe("seedance-2:8s:4k")
+  })
+  it("4k with video ref → seedance-2:8s:4k-ref", () => {
+    expect(buildVideoCreditModelIdentifier("seedance-2", 8, false, "image-to-video", undefined, "4k", true))
+      .toBe("seedance-2:8s:4k-ref")
+  })
+  it("4k on fast clamps to its top tier 720p (no fast 4k/1080p SKU)", () => {
+    expect(buildVideoCreditModelIdentifier("seedance-2-fast", 8, false, "image-to-video", undefined, "4k", false))
+      .toBe("seedance-2-fast:8s:720p")
+  })
+  it("1080p on fast clamps to 720p (no fast 1080p SKU)", () => {
+    expect(buildVideoCreditModelIdentifier("seedance-2-fast", 8, false, "image-to-video", undefined, "1080p", false))
+      .toBe("seedance-2-fast:8s:720p")
+    expect(buildVideoCreditModelIdentifier("seedance-2-fast", 8, false, "image-to-video", undefined, "1080p", true))
+      .toBe("seedance-2-fast:8s:720p-ref")
+  })
+})

package/src/__tests__/seedance-aspects.test.ts

@@ -0,0 +1,52 @@
+import { describe, it, expect } from "vitest"
+import { MODEL_CATALOG, validateModelInput, defaultVideoAspectRatio } from "../index.js"
+
+/**
+ * Seedance 2.x exposes the full KIE-supported fixed-ratio set
+ * (https://docs.kie.ai/market/bytedance/seedance-2: 1:1, 4:3, 3:4, 16:9,
+ * 9:16, 21:9). Validation is catalog-driven (validateModelInput reads
+ * MODEL_CATALOG aspectRatios), so these tests pin both the catalog data
+ * AND that the wider set does not leak to other models sharing the old
+ * VIDEO_RATIOS_HVS const.
+ */
+describe("seedance-2 aspect ratios", () => {
+  const NEW_RATIOS = ["21:9", "4:3", "3:4"] as const
+
+  it.each(["seedance-2", "seedance-2-fast"])("%s accepts the full six-ratio set", (id) => {
+    for (const ar of ["16:9", "9:16", "1:1", ...NEW_RATIOS]) {
+      expect(MODEL_CATALOG[id]!.aspectRatios).toContain(ar)
+      expect(validateModelInput(id, { aspectRatio: ar })).toBeNull()
+    }
+  })
+
+  it("the wider set does NOT leak to other HVS models", () => {
+    for (const ar of NEW_RATIOS) {
+      expect(validateModelInput("kling", { aspectRatio: ar })).not.toBeNull()
+      expect(validateModelInput("wan-turbo", { aspectRatio: ar })).not.toBeNull()
+    }
+  })
+})
+
+/**
+ * `defaultVideoAspectRatio` is the single source of truth for the no-explicit-
+ * aspectRatio run/display default. Seedance 2.x → "adaptive" (output matches
+ * the wired input); every other provider keeps the historical "16:9". Pinning
+ * this here keeps the run-defaults (execute-node, payload-builder) and the
+ * config-panel display fallbacks in lock-step (preview = run).
+ */
+describe("defaultVideoAspectRatio", () => {
+  it.each(["seedance-2", "seedance-2-fast", "seedance-2-mini"])(
+    "%s defaults to adaptive",
+    (id) => {
+      expect(defaultVideoAspectRatio(id)).toBe("adaptive")
+      // adaptive must be a value the model actually validates against.
+      expect(validateModelInput(id, { aspectRatio: "adaptive" })).toBeNull()
+    },
+  )
+
+  it("non-Seedance providers default to 16:9", () => {
+    expect(defaultVideoAspectRatio("minimax")).toBe("16:9")
+    expect(defaultVideoAspectRatio("kling")).toBe("16:9")
+    expect(defaultVideoAspectRatio(undefined)).toBe("16:9")
+  })
+})