@buildinternet/releases-api-types 0.58.3 → 0.60.0

package/dist/schemas/webhooks.js

@@ -0,0 +1,191 @@
+import { z } from "zod";
+import { WEBHOOK_FORMATS, WEBHOOK_SCOPES } from "@buildinternet/releases-core/schema";
+import { ReleaseTypeSchema } from "./shared.js";
+/**
+ * Self-serve webhook subscriptions: user-owned (`/v1/me/webhooks`) and
+ * workspace-owned (`/v1/workspaces/:workspaceId/webhooks`). Signing secrets
+ * never appear on read paths — only once on create / rotate.
+ */
+/**
+ * High-level delivery posture derived from summary columns (no AE query).
+ * Mirrors `WebhookDeliveryHealth` in `@releases/core-internal/webhook-resilience`.
+ */
+export const WebhookDeliveryHealthSchema = z.enum([
+    "never_delivered",
+    "healthy",
+    "degraded",
+    "failing",
+    "paused",
+    "auto_paused",
+]);
+/** Self-serve webhook filter scope. */
+export const UserWebhookScopeSchema = z.enum(WEBHOOK_SCOPES);
+/** Optional per-event filter on release taxonomy type. */
+export const UserWebhookReleaseTypeFilterSchema = ReleaseTypeSchema;
+/** Webhook delivery output format. */
+export const UserWebhookFormatSchema = z.enum(WEBHOOK_FORMATS);
+/** A user-owned webhook subscription row (no signing secret). */
+export const UserWebhookSubscriptionSchema = z.object({
+    id: z.string(),
+    userId: z.string(),
+    scope: UserWebhookScopeSchema,
+    orgId: z.string().nullable(),
+    url: z.string(),
+    sourceId: z.string().nullable(),
+    productId: z.string().nullable(),
+    releaseType: UserWebhookReleaseTypeFilterSchema.nullable(),
+    format: UserWebhookFormatSchema,
+    enabled: z.boolean(),
+    description: z.string().nullable(),
+    secretVersion: z.number().int(),
+    createdAt: z.string(),
+    lastSuccessAt: z.string().nullable(),
+    lastErrorAt: z.string().nullable(),
+    lastErrorMsg: z.string().nullable(),
+    consecutiveFailures: z.number().int(),
+    disabledReason: z.string().nullable(),
+    failureStreakStartedAt: z.string().nullable(),
+});
+/** Delivery health fields returned on user webhook read paths. */
+export const UserWebhookDeliveryHealthSchema = z.object({
+    deliveryHealth: WebhookDeliveryHealthSchema,
+    deliveryHealthSummary: z.string(),
+});
+/** GET/PATCH /v1/me/webhooks/:id response: the row plus its delivery health. */
+export const UserWebhookSchema = UserWebhookSubscriptionSchema.extend(UserWebhookDeliveryHealthSchema.shape);
+/** List item returned by GET /v1/me/webhooks — includes org/source display fields. */
+export const UserWebhookListItemSchema = UserWebhookSubscriptionSchema.omit({ userId: true })
+    .extend(UserWebhookDeliveryHealthSchema.shape)
+    .extend({
+    orgSlug: z.string().nullable(),
+    orgName: z.string().nullable(),
+    sourceSlug: z.string().nullable(),
+    sourceName: z.string().nullable(),
+    productSlug: z.string().nullable(),
+    productName: z.string().nullable(),
+});
+/** GET /v1/me/webhooks response. */
+export const UserWebhookListResponseSchema = z.object({
+    subscriptions: z.array(UserWebhookListItemSchema),
+});
+/** Fields a create response adds to the stored row (user and workspace). */
+const CreatedWebhookFields = {
+    ...UserWebhookDeliveryHealthSchema.shape,
+    orgSlug: z.string().nullable(),
+    orgName: z.string().nullable(),
+    /** Shown once at creation; omitted for slack/discord. */
+    signingKey: z.string().optional(),
+};
+/** POST /v1/me/webhooks response. */
+export const CreateUserWebhookResponseSchema = UserWebhookSubscriptionSchema.extend(CreatedWebhookFields);
+/** POST …/webhooks/:id/rotate-secret response (user and workspace). */
+export const RotateUserWebhookSecretResponseSchema = z.object({
+    secretVersion: z.number().int(),
+    signingKey: z.string(),
+});
+/** POST …/webhooks/:id/test response (user and workspace). */
+export const TestUserWebhookResponseSchema = z.object({
+    enqueued: z.literal(true),
+    eventId: z.string(),
+});
+/** Workspace member role (Better Auth `member.role`, not `user.role`). */
+export const WorkspaceMemberRoleSchema = z.enum(["owner", "admin", "member"]);
+/** Workspace webhooks are org-scoped only; there is no workspace follows scope. */
+const WorkspaceOwnerFields = { workspaceId: z.string(), scope: z.literal("org") };
+/** A workspace-owned webhook subscription row (no signing secret). */
+export const WorkspaceWebhookSubscriptionSchema = UserWebhookSubscriptionSchema.omit({
+    userId: true,
+}).extend(WorkspaceOwnerFields);
+/** GET/PATCH /v1/workspaces/:workspaceId/webhooks/:id response. */
+export const WorkspaceWebhookSchema = WorkspaceWebhookSubscriptionSchema.extend(UserWebhookDeliveryHealthSchema.shape);
+/** List item returned by GET /v1/workspaces/:workspaceId/webhooks. */
+export const WorkspaceWebhookListItemSchema = UserWebhookListItemSchema.extend(WorkspaceOwnerFields);
+/** GET /v1/workspaces/:workspaceId/webhooks response. */
+export const WorkspaceWebhookListResponseSchema = z.object({
+    subscriptions: z.array(WorkspaceWebhookListItemSchema),
+    /** The caller's role in the workspace. */
+    role: WorkspaceMemberRoleSchema,
+    /** True for owners and admins: create, edit, rotate, and delete. Members can view and test. */
+    canManage: z.boolean(),
+});
+/** POST /v1/workspaces/:workspaceId/webhooks response. */
+export const CreateWorkspaceWebhookResponseSchema = WorkspaceWebhookSubscriptionSchema.extend(CreatedWebhookFields);
+/**
+ * Fields shared by user and workspace webhook create bodies. Documentation
+ * shape: the handler validates (SSRF-checks `url`, matches `format` to the
+ * URL host) and resolves the org/source/product references.
+ */
+const WebhookCreateCommonFields = {
+    url: z.string().max(2048).describe("Public https URL that receives deliveries."),
+    format: UserWebhookFormatSchema.optional().describe("Delivery format. Defaults to `json`."),
+    description: z.string().max(1000).optional(),
+    releaseType: UserWebhookReleaseTypeFilterSchema.optional(),
+};
+/** Org/source/product targeting for an org-scoped webhook (`orgId` or `orgSlug` required). */
+const WebhookOrgTargetFields = {
+    orgId: z.string().optional(),
+    orgSlug: z.string().optional(),
+    sourceId: z.string().optional(),
+    sourceSlug: z.string().optional(),
+    productId: z.string().optional(),
+    productSlug: z.string().optional(),
+};
+/**
+ * POST /v1/me/webhooks body. `scope: "follows"` delivers releases from
+ * everything the caller follows and must not name an org/source/product;
+ * the default `"org"` scope requires `orgId` or `orgSlug`.
+ */
+export const CreateUserWebhookBodySchema = z.object({
+    scope: UserWebhookScopeSchema.optional(),
+    ...WebhookCreateCommonFields,
+    ...WebhookOrgTargetFields,
+});
+/** POST /v1/workspaces/:workspaceId/webhooks body — org-scoped only. */
+export const CreateWorkspaceWebhookBodySchema = z.object({
+    scope: z.literal("org").optional(),
+    ...WebhookCreateCommonFields,
+    ...WebhookOrgTargetFields,
+});
+/**
+ * PATCH …/webhooks/:id body (user and workspace). Every field is optional,
+ * but at least one must be present. `null` on `sourceId` / `productId` /
+ * `releaseType` / `description` clears that filter; follows-scoped webhooks
+ * reject the source/product fields. Re-enabling resets the failure streak.
+ */
+export const UpdateWebhookBodySchema = z.object({
+    url: z.string().max(2048).optional(),
+    format: UserWebhookFormatSchema.optional(),
+    description: z.string().max(1000).nullable().optional(),
+    enabled: z.boolean().optional(),
+    disabledReason: z.string().nullable().optional(),
+    releaseType: UserWebhookReleaseTypeFilterSchema.nullable().optional(),
+    sourceId: z.string().nullable().optional(),
+    sourceSlug: z.string().optional(),
+    productId: z.string().nullable().optional(),
+    productSlug: z.string().optional(),
+});
+/** One Analytics Engine delivery-attempt row from GET …/webhooks/:id/deliveries. */
+export const WebhookDeliveryRowSchema = z.object({
+    timestamp: z.string().optional(),
+    event_id: z.string().optional(),
+    error_message: z.string().nullable().optional(),
+    error_code: z.string().nullable().optional(),
+    outcome: z.string().optional(),
+    /** "json" (signed raw event) or a chat card (`slack` / `discord`). Empty on pre-format rows. */
+    format: z.union([UserWebhookFormatSchema, z.literal("")]).optional(),
+    http_status: z.number().optional(),
+    latency_ms: z.number().optional(),
+    attempt: z.number().optional(),
+});
+/**
+ * GET …/webhooks/:id/deliveries response: the Analytics Engine SQL result,
+ * newest first. `?failed=true` keeps only failed attempts; `?limit=` is 1-100
+ * (default 20).
+ */
+export const WebhookDeliveriesResponseSchema = z
+    .object({
+    data: z.array(WebhookDeliveryRowSchema),
+    rows: z.number().int().optional(),
+    meta: z.array(z.object({ name: z.string(), type: z.string() })).optional(),
+})
+    .passthrough();

package/dist/schemas/well-known.d.ts

@@ -0,0 +1,302 @@
+import { z } from "zod";
+/** A domain manifest can name a concrete GitHub repository, but never `self`. */
+export declare const ReleasesJsonDomainReleaseSchema: z.ZodObject<{
+    url: z.ZodOptional<z.ZodURL>;
+    feed: z.ZodOptional<z.ZodURL>;
+    appstore: z.ZodOptional<z.ZodURL>;
+    file: z.ZodOptional<z.ZodURL>;
+    title: z.ZodOptional<z.ZodString>;
+    canonical: z.ZodOptional<z.ZodBoolean>;
+    publish: z.ZodOptional<z.ZodLiteral<"push">>;
+    path: z.ZodOptional<z.ZodString>;
+    github: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** A repo manifest additionally accepts `github: "self"`. */
+export declare const ReleasesJsonRepoReleaseSchema: z.ZodObject<{
+    url: z.ZodOptional<z.ZodURL>;
+    feed: z.ZodOptional<z.ZodURL>;
+    appstore: z.ZodOptional<z.ZodURL>;
+    file: z.ZodOptional<z.ZodURL>;
+    title: z.ZodOptional<z.ZodString>;
+    canonical: z.ZodOptional<z.ZodBoolean>;
+    publish: z.ZodOptional<z.ZodLiteral<"push">>;
+    path: z.ZodOptional<z.ZodString>;
+    github: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"self">, z.ZodString]>>;
+}, z.core.$strict>;
+/**
+ * Product declaration in a domain manifest. Taxonomy strings are deliberately
+ * lenient here; the reconciler resolves known values and ignores the rest.
+ */
+export declare const ReleasesJsonProductSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    website: z.ZodOptional<z.ZodURL>;
+    docs: z.ZodOptional<z.ZodURL>;
+    support: z.ZodOptional<z.ZodURL>;
+    social: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+    releases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodOptional<z.ZodURL>;
+        feed: z.ZodOptional<z.ZodURL>;
+        appstore: z.ZodOptional<z.ZodURL>;
+        file: z.ZodOptional<z.ZodURL>;
+        title: z.ZodOptional<z.ZodString>;
+        canonical: z.ZodOptional<z.ZodBoolean>;
+        publish: z.ZodOptional<z.ZodLiteral<"push">>;
+        path: z.ZodOptional<z.ZodString>;
+        github: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+/** Repo-scope product binding. Slug is only a creation suggestion. */
+export declare const ReleasesJsonRepoProductSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** Registry-specific extensions are forward-compatible by design. */
+export declare const ReleasesJsonRegistriesSchema: z.ZodObject<{
+    "releases.sh": z.ZodOptional<z.ZodObject<{
+        org: z.ZodOptional<z.ZodString>;
+        product: z.ZodOptional<z.ZodString>;
+        verification: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+}, z.core.$catchall<z.ZodUnknown>>;
+/** Domain-hosted variant: flat org identity plus product and release declarations. */
+export declare const ReleasesJsonDomainSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodURL>;
+    version: z.ZodLiteral<2>;
+    registries: z.ZodOptional<z.ZodObject<{
+        "releases.sh": z.ZodOptional<z.ZodObject<{
+            org: z.ZodOptional<z.ZodString>;
+            product: z.ZodOptional<z.ZodString>;
+            verification: z.ZodOptional<z.ZodString>;
+        }, z.core.$catchall<z.ZodUnknown>>>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+    releases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodOptional<z.ZodURL>;
+        feed: z.ZodOptional<z.ZodURL>;
+        appstore: z.ZodOptional<z.ZodURL>;
+        file: z.ZodOptional<z.ZodURL>;
+        title: z.ZodOptional<z.ZodString>;
+        canonical: z.ZodOptional<z.ZodBoolean>;
+        publish: z.ZodOptional<z.ZodLiteral<"push">>;
+        path: z.ZodOptional<z.ZodString>;
+        github: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    avatar: z.ZodOptional<z.ZodURL>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    social: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    products: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        website: z.ZodOptional<z.ZodURL>;
+        docs: z.ZodOptional<z.ZodURL>;
+        support: z.ZodOptional<z.ZodURL>;
+        social: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        archived: z.ZodOptional<z.ZodBoolean>;
+        releases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodOptional<z.ZodURL>;
+            feed: z.ZodOptional<z.ZodURL>;
+            appstore: z.ZodOptional<z.ZodURL>;
+            file: z.ZodOptional<z.ZodURL>;
+            title: z.ZodOptional<z.ZodString>;
+            canonical: z.ZodOptional<z.ZodBoolean>;
+            publish: z.ZodOptional<z.ZodLiteral<"push">>;
+            path: z.ZodOptional<z.ZodString>;
+            github: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+/** Repo-root variant: product binding plus repo-scoped release declarations. */
+export declare const ReleasesJsonRepoSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodURL>;
+    version: z.ZodLiteral<2>;
+    registries: z.ZodOptional<z.ZodObject<{
+        "releases.sh": z.ZodOptional<z.ZodObject<{
+            org: z.ZodOptional<z.ZodString>;
+            product: z.ZodOptional<z.ZodString>;
+            verification: z.ZodOptional<z.ZodString>;
+        }, z.core.$catchall<z.ZodUnknown>>>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+    product: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    releases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodOptional<z.ZodURL>;
+        feed: z.ZodOptional<z.ZodURL>;
+        appstore: z.ZodOptional<z.ZodURL>;
+        file: z.ZodOptional<z.ZodURL>;
+        title: z.ZodOptional<z.ZodString>;
+        canonical: z.ZodOptional<z.ZodBoolean>;
+        publish: z.ZodOptional<z.ZodLiteral<"push">>;
+        path: z.ZodOptional<z.ZodString>;
+        github: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"self">, z.ZodString]>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+/** Public schema accepts either hosting scope; reconcilers use the scoped schema. */
+export declare const ReleasesJsonConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodURL>;
+    version: z.ZodLiteral<2>;
+    registries: z.ZodOptional<z.ZodObject<{
+        "releases.sh": z.ZodOptional<z.ZodObject<{
+            org: z.ZodOptional<z.ZodString>;
+            product: z.ZodOptional<z.ZodString>;
+            verification: z.ZodOptional<z.ZodString>;
+        }, z.core.$catchall<z.ZodUnknown>>>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+    releases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodOptional<z.ZodURL>;
+        feed: z.ZodOptional<z.ZodURL>;
+        appstore: z.ZodOptional<z.ZodURL>;
+        file: z.ZodOptional<z.ZodURL>;
+        title: z.ZodOptional<z.ZodString>;
+        canonical: z.ZodOptional<z.ZodBoolean>;
+        publish: z.ZodOptional<z.ZodLiteral<"push">>;
+        path: z.ZodOptional<z.ZodString>;
+        github: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    avatar: z.ZodOptional<z.ZodURL>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    social: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    products: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        website: z.ZodOptional<z.ZodURL>;
+        docs: z.ZodOptional<z.ZodURL>;
+        support: z.ZodOptional<z.ZodURL>;
+        social: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        archived: z.ZodOptional<z.ZodBoolean>;
+        releases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodOptional<z.ZodURL>;
+            feed: z.ZodOptional<z.ZodURL>;
+            appstore: z.ZodOptional<z.ZodURL>;
+            file: z.ZodOptional<z.ZodURL>;
+            title: z.ZodOptional<z.ZodString>;
+            canonical: z.ZodOptional<z.ZodBoolean>;
+            publish: z.ZodOptional<z.ZodLiteral<"push">>;
+            path: z.ZodOptional<z.ZodString>;
+            github: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>, z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodURL>;
+    version: z.ZodLiteral<2>;
+    registries: z.ZodOptional<z.ZodObject<{
+        "releases.sh": z.ZodOptional<z.ZodObject<{
+            org: z.ZodOptional<z.ZodString>;
+            product: z.ZodOptional<z.ZodString>;
+            verification: z.ZodOptional<z.ZodString>;
+        }, z.core.$catchall<z.ZodUnknown>>>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+    product: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    releases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodOptional<z.ZodURL>;
+        feed: z.ZodOptional<z.ZodURL>;
+        appstore: z.ZodOptional<z.ZodURL>;
+        file: z.ZodOptional<z.ZodURL>;
+        title: z.ZodOptional<z.ZodString>;
+        canonical: z.ZodOptional<z.ZodBoolean>;
+        publish: z.ZodOptional<z.ZodLiteral<"push">>;
+        path: z.ZodOptional<z.ZodString>;
+        github: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"self">, z.ZodString]>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>]>;
+export type ReleasesJsonConfig = z.infer<typeof ReleasesJsonConfigSchema>;
+export type ReleasesJsonDomain = z.infer<typeof ReleasesJsonDomainSchema>;
+export type ReleasesJsonRepo = z.infer<typeof ReleasesJsonRepoSchema>;
+export type ReleasesJsonProduct = z.infer<typeof ReleasesJsonProductSchema>;
+export type ReleasesJsonDomainRelease = z.infer<typeof ReleasesJsonDomainReleaseSchema>;
+export type ReleasesJsonRepoRelease = z.infer<typeof ReleasesJsonRepoReleaseSchema>;
+/**
+ * Body for `POST /v1/orgs/stub` — curator-authored stub org (#1947). Mirrors
+ * the domain-manifest identity + product + locator shape (so a curator can hand
+ * the same declaration a manifest would carry), minus manifest-transport fields
+ * (`version`/`$schema`/`registries`) and plus the registry-identity fields a
+ * stub org needs to be resolvable (`slug`/`domain`). Locators are optional — an
+ * identity-only stub (locations TBD) is valid. `category`/taxonomy strings stay
+ * lenient; the route resolves them and ignores the rest, same as the reconciler.
+ */
+export declare const CreateStubOrgBodySchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    avatar: z.ZodOptional<z.ZodURL>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    social: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    products: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        slug: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        website: z.ZodOptional<z.ZodURL>;
+        docs: z.ZodOptional<z.ZodURL>;
+        support: z.ZodOptional<z.ZodURL>;
+        social: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        archived: z.ZodOptional<z.ZodBoolean>;
+        releases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodOptional<z.ZodURL>;
+            feed: z.ZodOptional<z.ZodURL>;
+            appstore: z.ZodOptional<z.ZodURL>;
+            file: z.ZodOptional<z.ZodURL>;
+            title: z.ZodOptional<z.ZodString>;
+            canonical: z.ZodOptional<z.ZodBoolean>;
+            publish: z.ZodOptional<z.ZodLiteral<"push">>;
+            path: z.ZodOptional<z.ZodString>;
+            github: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    releases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodOptional<z.ZodURL>;
+        feed: z.ZodOptional<z.ZodURL>;
+        appstore: z.ZodOptional<z.ZodURL>;
+        file: z.ZodOptional<z.ZodURL>;
+        title: z.ZodOptional<z.ZodString>;
+        canonical: z.ZodOptional<z.ZodBoolean>;
+        publish: z.ZodOptional<z.ZodLiteral<"push">>;
+        path: z.ZodOptional<z.ZodString>;
+        github: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type CreateStubOrgBody = z.infer<typeof CreateStubOrgBodySchema>;
+/**
+ * Body for `POST /v1/orgs/stub-from-domain` (#1947) — the unlisted-domain path.
+ * The worker fetches https://{domain}/.well-known/releases.json and, if valid
+ * and the domain has no org yet, creates a stub org + declared locators.
+ */
+export declare const StubFromDomainBodySchema: z.ZodObject<{
+    domain: z.ZodString;
+}, z.core.$strict>;
+export type StubFromDomainBody = z.infer<typeof StubFromDomainBodySchema>;
+/** Response shape of POST /v1/orgs/:slug/sync-well-known. */
+export declare const SyncWellKnownResponseSchema: z.ZodObject<{
+    fetched: z.ZodBoolean;
+    applied: z.ZodBoolean;
+    skippedReason: z.ZodOptional<z.ZodString>;
+    plan: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+//# sourceMappingURL=well-known.d.ts.map

package/dist/schemas/well-known.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known.d.ts","sourceRoot":"","sources":["../../src/schemas/well-known.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgExB,iFAAiF;AACjF,eAAO,MAAM,+BAA+B;;;;;;;;;;kBAYzC,CAAC;AAEJ,6DAA6D;AAC7D,eAAO,MAAM,6BAA6B;;;;;;;;;;kBAcvC,CAAC;AAoBJ;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;kBAapC,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,6BAA6B;;;kBAGxC,CAAC;AAgBH,qEAAqE;AACrE,eAAO,MAAM,4BAA4B;;;;;;kCAIjB,CAAC;AAczB,sFAAsF;AACtF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkBlC,CAAC;AAEJ,gFAAgF;AAChF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;kBAIjC,CAAC;AAEH,qFAAqF;AACrF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAA8D,CAAC;AAEpG,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAWlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;kBAEnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,6DAA6D;AAC7D,eAAO,MAAM,2BAA2B;;;;;iBAKtC,CAAC"}