@buildinternet/releases-api-types 0.59.0 → 0.60.0

package/dist/schemas/releases.d.ts

@@ -0,0 +1,623 @@
+import { z } from "zod";
+/**
+ * Per-row shape returned by `GET /v1/releases/latest`. Distinct from the
+ * shared `ReleaseItemSchema` because the latest-feed handler joins the
+ * source row in and exposes it as a nested `source` object instead of
+ * leaving the caller to do a second lookup.
+ *
+ * `type` is required here — the latest handler reads it directly from
+ * `releases.type` (NOT NULL with DB-default `'feature'`), so mid-deploy
+ * degrade-gracefully nullability doesn't apply on this path.
+ */
+export declare const ReleaseLatestSourceSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        agent: "agent";
+        appstore: "appstore";
+        feed: "feed";
+        github: "github";
+        scrape: "scrape";
+        video: "video";
+    }>;
+    orgSlug: z.ZodNullable<z.ZodString>;
+    orgName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    orgAvatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    orgGithubHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        desktop: "desktop";
+        docs: "docs";
+        integration: "integration";
+        mobile: "mobile";
+        platform: "platform";
+        sdk: "sdk";
+        tool: "tool";
+    }>>>;
+}, z.core.$strip>;
+export declare const ReleaseLatestProductSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        desktop: "desktop";
+        docs: "docs";
+        integration: "integration";
+        mobile: "mobile";
+        platform: "platform";
+        sdk: "sdk";
+        tool: "tool";
+    }>>>;
+}, z.core.$strip>;
+export declare const ReleaseLatestItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+    type: z.ZodEnum<{
+        feature: "feature";
+        rollup: "rollup";
+    }>;
+    title: z.ZodString;
+    summary: z.ZodNullable<z.ZodString>;
+    titleGenerated: z.ZodNullable<z.ZodString>;
+    titleShort: z.ZodNullable<z.ZodString>;
+    breaking: z.ZodOptional<z.ZodEnum<{
+        major: "major";
+        minor: "minor";
+        none: "none";
+        unknown: "unknown";
+    }>>;
+    importance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    publishedAt: z.ZodNullable<z.ZodString>;
+    url: z.ZodNullable<z.ZodString>;
+    webUrl: z.ZodOptional<z.ZodString>;
+    media: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            gif: "gif";
+            image: "image";
+            video: "video";
+        }>;
+        url: z.ZodString;
+        alt: z.ZodOptional<z.ZodString>;
+        r2Key: z.ZodOptional<z.ZodString>;
+        r2Url: z.ZodOptional<z.ZodString>;
+        linkUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    source: z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            agent: "agent";
+            appstore: "appstore";
+            feed: "feed";
+            github: "github";
+            scrape: "scrape";
+            video: "video";
+        }>;
+        orgSlug: z.ZodNullable<z.ZodString>;
+        orgName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        orgAvatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        orgGithubHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            desktop: "desktop";
+            docs: "docs";
+            integration: "integration";
+            mobile: "mobile";
+            platform: "platform";
+            sdk: "sdk";
+            tool: "tool";
+        }>>>;
+    }, z.core.$strip>;
+    product: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            desktop: "desktop";
+            docs: "docs";
+            integration: "integration";
+            mobile: "mobile";
+            platform: "platform";
+            sdk: "sdk";
+            tool: "tool";
+        }>>>;
+    }, z.core.$strip>>>;
+    groupSlug: z.ZodOptional<z.ZodString>;
+    groupName: z.ZodOptional<z.ZodString>;
+    coverageCount: z.ZodOptional<z.ZodNumber>;
+    contentChars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    contentTokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    composition: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        bugs: z.ZodNumber;
+        features: z.ZodNumber;
+        enhancements: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const ReleaseLatestResponseSchema: z.ZodObject<{
+    releases: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNullable<z.ZodString>;
+        type: z.ZodEnum<{
+            feature: "feature";
+            rollup: "rollup";
+        }>;
+        title: z.ZodString;
+        summary: z.ZodNullable<z.ZodString>;
+        titleGenerated: z.ZodNullable<z.ZodString>;
+        titleShort: z.ZodNullable<z.ZodString>;
+        breaking: z.ZodOptional<z.ZodEnum<{
+            major: "major";
+            minor: "minor";
+            none: "none";
+            unknown: "unknown";
+        }>>;
+        importance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        publishedAt: z.ZodNullable<z.ZodString>;
+        url: z.ZodNullable<z.ZodString>;
+        webUrl: z.ZodOptional<z.ZodString>;
+        media: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                gif: "gif";
+                image: "image";
+                video: "video";
+            }>;
+            url: z.ZodString;
+            alt: z.ZodOptional<z.ZodString>;
+            r2Key: z.ZodOptional<z.ZodString>;
+            r2Url: z.ZodOptional<z.ZodString>;
+            linkUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        source: z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                agent: "agent";
+                appstore: "appstore";
+                feed: "feed";
+                github: "github";
+                scrape: "scrape";
+                video: "video";
+            }>;
+            orgSlug: z.ZodNullable<z.ZodString>;
+            orgName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            orgAvatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            orgGithubHandle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                desktop: "desktop";
+                docs: "docs";
+                integration: "integration";
+                mobile: "mobile";
+                platform: "platform";
+                sdk: "sdk";
+                tool: "tool";
+            }>>>;
+        }, z.core.$strip>;
+        product: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+            kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                desktop: "desktop";
+                docs: "docs";
+                integration: "integration";
+                mobile: "mobile";
+                platform: "platform";
+                sdk: "sdk";
+                tool: "tool";
+            }>>>;
+        }, z.core.$strip>>>;
+        groupSlug: z.ZodOptional<z.ZodString>;
+        groupName: z.ZodOptional<z.ZodString>;
+        coverageCount: z.ZodOptional<z.ZodNumber>;
+        contentChars: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        contentTokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        composition: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            bugs: z.ZodNumber;
+            features: z.ZodNumber;
+            enhancements: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Display fields for the counterpart release a coverage row points at —
+ * the canonical for a `coverage`-role response, or each rolled-up coverage
+ * release for a `canonical`-role response. Lets `GET /releases/:id/coverage`
+ * render a cluster without a follow-up `GET /releases/:id` per sibling.
+ * `null` when the counterpart is suppressed or its source was removed.
+ *
+ * Coverage-side rows are surfaced here on purpose, even though the
+ * `releases_visible` view (and thus `GET /releases/:id`) hides them — a
+ * cluster view's whole job is to show its members.
+ */
+export declare const ReleaseCoverageSiblingSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+    title: z.ZodString;
+    sourceName: z.ZodString;
+    publishedAt: z.ZodNullable<z.ZodString>;
+    org: z.ZodNullable<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    thumbnail: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        url: z.ZodString;
+        alt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Single row of the `release_coverage` join table. Drives the
+ * GET /releases/:id/coverage response. `sibling` carries the counterpart
+ * release's display fields (see {@link ReleaseCoverageSiblingSchema}); it is
+ * optional so an older server that doesn't populate it still validates.
+ */
+export declare const ReleaseCoverageRowSchema: z.ZodObject<{
+    coverageId: z.ZodString;
+    canonicalId: z.ZodString;
+    reason: z.ZodNullable<z.ZodString>;
+    decidedBy: z.ZodString;
+    decidedAt: z.ZodString;
+    sibling: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        sourceName: z.ZodString;
+        publishedAt: z.ZodNullable<z.ZodString>;
+        org: z.ZodNullable<z.ZodObject<{
+            slug: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        thumbnail: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            url: z.ZodString;
+            alt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Discriminated by `role`:
+ * - `standalone` — release is neither canonical nor coverage of anything.
+ * - `coverage` — release is coverage rolling up to `canonical`.
+ * - `canonical` — release is the canonical row; `covers` enumerates rollups.
+ */
+export declare const ReleaseCoverageResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    role: z.ZodLiteral<"standalone">;
+    canonical: z.ZodNull;
+    covers: z.ZodArray<z.ZodNever>;
+}, z.core.$strip>, z.ZodObject<{
+    role: z.ZodLiteral<"coverage">;
+    canonical: z.ZodObject<{
+        coverageId: z.ZodString;
+        canonicalId: z.ZodString;
+        reason: z.ZodNullable<z.ZodString>;
+        decidedBy: z.ZodString;
+        decidedAt: z.ZodString;
+        sibling: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodNullable<z.ZodString>;
+            title: z.ZodString;
+            sourceName: z.ZodString;
+            publishedAt: z.ZodNullable<z.ZodString>;
+            org: z.ZodNullable<z.ZodObject<{
+                slug: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strip>>;
+            thumbnail: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                url: z.ZodString;
+                alt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    covers: z.ZodArray<z.ZodNever>;
+}, z.core.$strip>, z.ZodObject<{
+    role: z.ZodLiteral<"canonical">;
+    canonical: z.ZodNull;
+    covers: z.ZodArray<z.ZodObject<{
+        coverageId: z.ZodString;
+        canonicalId: z.ZodString;
+        reason: z.ZodNullable<z.ZodString>;
+        decidedBy: z.ZodString;
+        decidedAt: z.ZodString;
+        sibling: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodNullable<z.ZodString>;
+            title: z.ZodString;
+            sourceName: z.ZodString;
+            publishedAt: z.ZodNullable<z.ZodString>;
+            org: z.ZodNullable<z.ZodObject<{
+                slug: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strip>>;
+            thumbnail: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                url: z.ZodString;
+                alt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "role">;
+/**
+ * Body accepted by `POST /v1/releases/:id/coverage`. `decidedBy` MUST be
+ * prefixed with `human:` or `agent:` so the audit trail records who linked
+ * the rows; the handler enforces this with a regex.
+ */
+export declare const LinkReleaseCoverageBodySchema: z.ZodObject<{
+    coverageIds: z.ZodArray<z.ZodString>;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    decidedBy: z.ZodString;
+}, z.core.$strip>;
+export declare const LinkReleaseCoverageResponseSchema: z.ZodObject<{
+    canonicalId: z.ZodString;
+    coverageIds: z.ZodArray<z.ZodString>;
+    linked: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Response for `DELETE /v1/releases/:id/coverage`. Idempotent — the handler
+ * returns `{ unlinked: false }` when the release isn't in a cluster, so the
+ * remote client can skip a brittle error-message sniff.
+ */
+export declare const UnlinkReleaseCoverageResponseSchema: z.ZodObject<{
+    unlinked: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Row returned by `GET /v1/releases?hasMedia=true`. Internal/admin escape
+ * hatch consumed by the `media backfill` CLI command.
+ */
+export declare const ReleaseWithMediaRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    sourceId: z.ZodString;
+    media: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const ReleasesWithMediaResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    sourceId: z.ZodString;
+    media: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Nested org context joined into the `GET /v1/releases/:id` response.
+ * Both fields are nullable — releases whose source has no org attached
+ * return `null` for this object entirely.
+ */
+export declare const ReleaseDetailOrgSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    discovery: z.ZodOptional<z.ZodEnum<{
+        agent: "agent";
+        curated: "curated";
+        on_demand: "on_demand";
+    }>>;
+    isHidden: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Full release detail returned by `GET /v1/releases/:id`. Joins source
+ * name/slug/type and a nullable org object; media is parsed from the raw
+ * JSON stored in D1 and typed URLs are rewritten to the CDN origin. The
+ * route only surfaces non-suppressed, non-coverage rows (filtered via the
+ * `releases_visible` view).
+ */
+export declare const ReleaseDetailResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    sourceId: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+    type: z.ZodEnum<{
+        feature: "feature";
+        rollup: "rollup";
+    }>;
+    title: z.ZodString;
+    content: z.ZodString;
+    summary: z.ZodNullable<z.ZodString>;
+    titleGenerated: z.ZodNullable<z.ZodString>;
+    titleShort: z.ZodNullable<z.ZodString>;
+    breaking: z.ZodOptional<z.ZodEnum<{
+        major: "major";
+        minor: "minor";
+        none: "none";
+        unknown: "unknown";
+    }>>;
+    importance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    migrationNotes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodNullable<z.ZodString>;
+    webUrl: z.ZodOptional<z.ZodString>;
+    contentHash: z.ZodNullable<z.ZodString>;
+    media: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            gif: "gif";
+            image: "image";
+            video: "video";
+        }>;
+        url: z.ZodString;
+        alt: z.ZodOptional<z.ZodString>;
+        r2Key: z.ZodOptional<z.ZodString>;
+        r2Url: z.ZodOptional<z.ZodString>;
+        linkUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    publishedAt: z.ZodNullable<z.ZodString>;
+    suppressed: z.ZodNullable<z.ZodBoolean>;
+    suppressedReason: z.ZodNullable<z.ZodString>;
+    prerelease: z.ZodNullable<z.ZodBoolean>;
+    fetchedAt: z.ZodNullable<z.ZodString>;
+    sourceName: z.ZodNullable<z.ZodString>;
+    sourceSlug: z.ZodNullable<z.ZodString>;
+    sourceType: z.ZodNullable<z.ZodEnum<{
+        agent: "agent";
+        appstore: "appstore";
+        feed: "feed";
+        github: "github";
+        scrape: "scrape";
+        video: "video";
+    }>>;
+    org: z.ZodNullable<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        discovery: z.ZodOptional<z.ZodEnum<{
+            agent: "agent";
+            curated: "curated";
+            on_demand: "on_demand";
+        }>>;
+        isHidden: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    product: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            desktop: "desktop";
+            docs: "docs";
+            integration: "integration";
+            mobile: "mobile";
+            platform: "platform";
+            sdk: "sdk";
+            tool: "tool";
+        }>>>;
+    }, z.core.$strip>>>;
+    composition: z.ZodNullable<z.ZodObject<{
+        bugs: z.ZodNumber;
+        features: z.ZodNumber;
+        enhancements: z.ZodNumber;
+    }, z.core.$strip>>;
+    appStore: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        platform: z.ZodEnum<{
+            ios: "ios";
+            macos: "macos";
+        }>;
+        iconUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+    video: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        provider: z.ZodEnum<{
+            vimeo: "vimeo";
+            wistia: "wistia";
+            youtube: "youtube";
+        }>;
+    }, z.core.$strip>>>;
+    sourceIsHidden: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * `error.details` on a 409 from `PATCH /v1/releases/:id` when the new `url`
+ * collides with `UNIQUE(source_id, url)`. Additive: older servers omit `details`.
+ */
+export declare const ReleaseUrlConflictDetailsSchema: z.ZodObject<{
+    releaseId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Body accepted by `PATCH /v1/releases/:id`. All fields are optional;
+ * omitted fields are not updated. The nullable string columns (`version`,
+ * `url`, `publishedAt`, `contentHash`) accept a string or `null`. AI-generated
+ * fields (`summary`, `titleGenerated`, `titleShort`) accept `null` to
+ * explicitly clear the stored value. Non-whitelisted fields are rejected
+ * via `.strict()` — the handler also re-runs the field-set check after
+ * sanitization so an empty update payload still 400s.
+ */
+export declare const UpdateReleaseBodySchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    publishedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    contentHash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    titleGenerated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    titleShort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    composition: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        bugs: z.ZodNumber;
+        features: z.ZodNumber;
+        enhancements: z.ZodNumber;
+    }, z.core.$strip>>>;
+    media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            gif: "gif";
+            image: "image";
+            video: "video";
+        }>;
+        url: z.ZodString;
+        alt: z.ZodOptional<z.ZodString>;
+        r2Key: z.ZodOptional<z.ZodString>;
+        r2Url: z.ZodOptional<z.ZodString>;
+        linkUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strict>;
+/**
+ * Response returned by `PATCH /v1/releases/:id`. The handler returns the raw
+ * Drizzle row from the `releases` table — distinct from the augmented
+ * `ReleaseDetailResponseSchema` shape served by `GET /v1/releases/:id`, which
+ * adds joined source/org metadata and parses `media` from raw JSON. Clients
+ * that need the augmented shape after an edit should re-fetch via GET.
+ */
+export declare const ReleasePatchResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    sourceId: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+    type: z.ZodEnum<{
+        feature: "feature";
+        rollup: "rollup";
+    }>;
+    title: z.ZodString;
+    content: z.ZodString;
+    summary: z.ZodNullable<z.ZodString>;
+    titleGenerated: z.ZodNullable<z.ZodString>;
+    titleShort: z.ZodNullable<z.ZodString>;
+    url: z.ZodNullable<z.ZodString>;
+    contentHash: z.ZodNullable<z.ZodString>;
+    metadata: z.ZodNullable<z.ZodString>;
+    media: z.ZodNullable<z.ZodString>;
+    publishedAt: z.ZodNullable<z.ZodString>;
+    prerelease: z.ZodNullable<z.ZodBoolean>;
+    suppressed: z.ZodNullable<z.ZodBoolean>;
+    suppressedReason: z.ZodNullable<z.ZodString>;
+    fetchedAt: z.ZodNullable<z.ZodString>;
+    embeddedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** Response returned by `DELETE /v1/releases/:id`. */
+export declare const ReleaseDeleteResponseSchema: z.ZodObject<{
+    deleted: z.ZodLiteral<true>;
+}, z.core.$strip>;
+/** Body accepted by `DELETE /v1/releases/batch`. */
+export declare const ReleaseBatchDeleteBodySchema: z.ZodObject<{
+    releaseIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/** Response returned by `DELETE /v1/releases/batch`. */
+export declare const ReleaseBatchDeleteResponseSchema: z.ZodObject<{
+    deleted: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Body accepted by `POST /v1/releases/batch-suppress`. When `suppressed` is
+ * true the optional `reason` is stored in `suppressed_reason`; when false the
+ * reason is cleared.
+ */
+export declare const ReleaseBatchSuppressBodySchema: z.ZodObject<{
+    releaseIds: z.ZodArray<z.ZodString>;
+    suppressed: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Response returned by `POST /v1/releases/batch-suppress`. */
+export declare const ReleaseBatchSuppressResponseSchema: z.ZodObject<{
+    updated: z.ZodNumber;
+}, z.core.$strip>;
+/** Response returned by `POST /v1/releases/:id/suppress`. */
+export declare const ReleaseSuppressResponseSchema: z.ZodObject<{
+    suppressed: z.ZodLiteral<true>;
+}, z.core.$strip>;
+/** Response returned by `POST /v1/releases/:id/unsuppress`. */
+export declare const ReleaseUnsuppressResponseSchema: z.ZodObject<{
+    unsuppressed: z.ZodLiteral<true>;
+}, z.core.$strip>;
+/**
+ * Body accepted by `POST /v1/releases/:id/suppress`. The `reason` field
+ * is optional; when omitted the stored `suppressed_reason` is set to null.
+ */
+export declare const ReleaseSuppressBodySchema: z.ZodObject<{
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * WebSocket message schema for the `GET /v1/releases/stream` endpoint.
+ * Each message is a JSON object with one of the following shapes:
+ * - `{ type: "ready", seq: number }` — sent on connect to give the caller
+ *   the current head sequence number for later resume.
+ * - `{ type: "release.created", seq: number, release: object }` — a new
+ *   release was indexed; `release` carries the full release row.
+ * - `{ type: "snapshot_gap" }` — the requested `since` sequence fell
+ *   behind the oldest buffered event; the client must REST-backfill.
+ */
+export declare const ReleaseStreamMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"ready">;
+    seq: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"release.created">;
+    seq: z.ZodNumber;
+    release: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"snapshot_gap">;
+}, z.core.$strip>], "type">;
+//# sourceMappingURL=releases.d.ts.map

package/dist/schemas/releases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../../src/schemas/releases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;iBAqBpC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;iBAMrC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiDlC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEtC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;iBAUvC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;iBAOnC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAgBxC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,6BAA6B;;;;iBAIxC,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;iBAI5C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,mCAAmC;;iBAE9C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;iBAIpC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;kBAAqC,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;iBAqBjC,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0DtC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,+BAA+B;;iBAMuB,CAAC;AAEpE;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAoBzB,CAAC;AAEZ;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;iBAqBrC,CAAC;AAEH,sDAAsD;AACtD,eAAO,MAAM,2BAA2B;;iBAEtC,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,4BAA4B;;iBAEvC,CAAC;AAEH,wDAAwD;AACxD,eAAO,MAAM,gCAAgC;;iBAE3C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;iBAIzC,CAAC;AAEH,+DAA+D;AAC/D,eAAO,MAAM,kCAAkC;;iBAE7C,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,6BAA6B;;iBAExC,CAAC;AAEH,+DAA+D;AAC/D,eAAO,MAAM,+BAA+B;;iBAE1C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;iBAEpC,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;2BAQrC,CAAC"}