@honest-pitches/pitch-sdk 0.5.1 → 0.5.3

package/dist/index.mjs

@@ -16823,10 +16823,37 @@ var PitchesApi = class {
       intendedAudience: input.intendedAudience ?? "",
       visibility: input.visibility ?? "private"
     };
+    if (input.honestyDisclosure != null && input.honestyDisclosure !== "") {
+      payload.honestyDisclosure = String(input.honestyDisclosure).slice(0, 2e3);
+    }
     if (input.categorySlug != null) payload.categorySlug = input.categorySlug;
     if (input.priceNote != null && input.priceNote !== "") {
       payload.priceNote = String(input.priceNote).slice(0, 64);
     }
+    if (input.videoSource != null && input.videoSource !== "") {
+      payload.videoSource = input.videoSource;
+    }
+    if (input.videoExternalId != null && input.videoExternalId !== "") {
+      payload.videoExternalId = String(input.videoExternalId);
+    }
+    if (input.videoExternalUrl != null && input.videoExternalUrl !== "") {
+      payload.videoExternalUrl = String(input.videoExternalUrl);
+    }
+    if (input.bunnyVideoId != null && input.bunnyVideoId !== "") {
+      payload.bunnyVideoId = String(input.bunnyVideoId);
+    }
+    if (input.primaryVideo != null && input.primaryVideo !== "") {
+      payload.primaryVideo = String(input.primaryVideo);
+    }
+    if (input.primaryVideoId != null && input.primaryVideoId !== "") {
+      payload.primaryVideoId = String(input.primaryVideoId);
+    }
+    if (input.honestyDisclosure != null && input.honestyDisclosure !== "") {
+      payload.honestyDisclosure = String(input.honestyDisclosure).slice(0, 2e3);
+    }
+    if (input.dryRun === true) {
+      payload.dryRun = true;
+    }
     const doc = await fetchPitches(this.config, {
       method: "POST",
       path: "/pitches",
@@ -16844,7 +16871,9 @@ var PitchesApi = class {
   async find(opts = {}) {
     const params = new URLSearchParams();
     if (opts.status) params.set("status", opts.status);
+    if (opts.creatorId) params.set("creatorId", opts.creatorId);
     if (typeof opts.limit === "number") params.set("limit", String(opts.limit));
+    if (opts.cursor) params.set("cursor", opts.cursor);
     const qs = params.toString();
     const docs = await fetchPitches(this.config, {
       method: "GET",
@@ -16852,6 +16881,20 @@ var PitchesApi = class {
     });
     return docs.map((d) => rowToPitch(d));
   }
+  /**
+   * Public alias for {@link PitchesApi.find}. Stable on the public
+   * npm registry since `@honest-pitches/pitch-sdk@0.5.2` (2026-07-28).
+   * If you see "client.pitches.list is not a function" you are on
+   * an older SDK — bump to `>=0.5.2`. (The 0.5.1 tarball on npmjs
+   * never shipped this alias even though the source landed under
+   * that version number locally; 0.5.2 is the first published cut.)
+   *
+   * (Added 2026-07-27; published 2026-07-28 after the agent bug
+   * report against CLI 0.5.1 / hosted MCP `list_pitches`.)
+   */
+  async list(opts = {}) {
+    return this.find(opts);
+  }
   async update(id, input) {
     const doc = await fetchPitches(this.config, {
       method: "PATCH",
@@ -16860,6 +16903,43 @@ var PitchesApi = class {
     });
     return rowToPitch(doc);
   }
+  /**
+   * Move a pitch through its lifecycle. The returned row carries BOTH
+   * `status` (row-level persisted) and `lifecycle` (computed from
+   * `status + previewToken` server-side).
+   *
+   * Status vs lifecycle (2026-07-28 FlexTape retest doc bundle):
+   *   `lifecycle` is the canonical, computed view of where the row sits
+   *   (`draft | preview | live | expired | archived`). It is derived
+   *   from `status + previewToken` server-side in
+   *   `honest-pitches-studio-api/legacy/pitch-write/src/handler.ts`.
+   *   Branch on `lifecycle` for terminal-state checks.
+   *
+   *   The mapping is:
+   *     - `lifecycle: "draft"`    ⟷ `status: "draft"`   (no previewToken)
+   *     - `lifecycle: "preview"`  ⟷ `status: "draft"`   (previewToken set)
+   *     - `lifecycle: "live"`     ⟷ `status: "live"`
+   *     - `lifecycle: "expired"`  ⟷ `status: "expired"`
+   *     - `lifecycle: "archived"` ⟷ `status: "removed"` (intentional vocab split)
+   *
+   * Token gate (Finding #17, FlexTape retest):
+   *   `to: "preview"` requires a `previewToken` that matches the row's
+   *   stored token. The server returns
+   *   `400 previewToken is required to transition to preview`
+   *   when the token is missing or wrong.
+   *
+   *   `to: "draft"` from an `archived` row ALSO requires the same
+   *   `previewToken` (the token is the only proof the caller owns the
+   *   unarchive). There is NO `archived → preview` single-step path —
+   *   the supported path is `archived → draft` (token required) and
+   *   then `draft → preview` (which may issue a NEW token).
+   *
+   * Visibility on archive (Finding #17, FlexTape retest):
+   *   `to: "archived"` does NOT touch `visibility` — the row keeps
+   *   whatever visibility it had at the time of the archive (usually
+   *   `"public"`, but `"unlisted"` is preserved too). Only `to: "live"`
+   *   assigns `visibility: "public"`.
+   */
   async transition(id, input) {
     const doc = await fetchPitches(this.config, {
       method: "POST",
@@ -16887,11 +16967,56 @@ var PitchesApi = class {
     });
     return doc;
   }
+  /**
+   * List every media asset for a pitch, joining two server-side sources:
+   *
+   *  - `pitch_assets` rows with `pitchId === id` (the explicit
+   *    uploads via `POST /pitcher/pitches/:id/media`).
+   *  - The auto-generated `thumbnailFileId` and `ogImageFileId` fields
+   *    on the pitch row itself (synthesised by `pitch-write`'s
+   *    `to=live` path; they live on the row, NOT in `pitch_assets`).
+   *
+   * Each result carries a `source: "pitch_assets" | "pitch_row"`
+   * discriminator so consumers can tell the two apart. The server
+   * may synthesise `pitch_row` rows with `sizeBytes: 0` (the auto
+   * images don't carry an upload byte count — the `cdnUrl` is the
+   * canonical handle).
+   *
+   * Added 2026-07-28 to address Bug #12 of the FlexTape retest brief
+   * (`testing-feedback/2026-07-27-flextape-rerun-3surface-retest.md`).
+   * Prior to this, `hp pitches media list <id>` returned `[]` for
+   * every pitch whose only assets were auto-generated.
+   */
+  async listMedia(id) {
+    return fetchPitches(this.config, {
+      method: "GET",
+      path: `/pitches/${encodeURIComponent(id)}/media`
+    });
+  }
   /**
    * Restore an archived pitch to `draft`. Same as `transition(id, {
    * to: "draft", previewToken })` but with a placeholder previewToken
    * if the caller didn't pass one. The server's "to=draft" path
    * mirrors the existing "to=preview" pre-condition.
+   *
+   * Status vs lifecycle (2026-07-28 FlexTape retest doc bundle):
+   *   `pitches.lifecycle` is the canonical, computed view of where
+   *   the row sits (`draft, preview, live, expired, archived`). It is
+   *   derived from `status + previewToken` server-side
+   *   (`honest-pitches-studio-api/legacy/pitch-write/src/handler.ts`).
+   *   Branch on `lifecycle` for terminal-state checks.
+   *
+   *   The mapping is:
+   *     - `lifecycle: "preview"` ⟷ `status: "draft"` (previewToken set)
+   *     - `lifecycle: "live"`    ⟷ `status: "live"`
+   *     - `lifecycle: "archived"` ⟷ `status: "removed"` (intentional vocab split)
+   *
+   *   There is NO direct `archived → preview` path — the server only
+   *   exposes `archived → draft`. To resume preview after a draft,
+   *   transition twice (`archived → draft` then `draft → preview` with
+   *   a new preview token), or use `transition(id, { to: "preview",
+   *   previewToken })` directly if your `lifecycle` is `draft` (NOT
+   *   `archived`).
    */
   async unarchive(id, opts = {}) {
     return this.transition(id, {