@spacefast/common 0.0.2

package/dist/contracts/push-new.d.ts

@@ -0,0 +1,156 @@
+import { z } from "zod";
+export declare const pushNewSessionStatusSchema: z.ZodEnum<{
+    live: "live";
+    failed: "failed";
+    expired: "expired";
+    building: "building";
+    waiting_for_push: "waiting_for_push";
+    waiting_for_upload: "waiting_for_upload";
+    publishing: "publishing";
+}>;
+export declare const pushNewSourceKindSchema: z.ZodEnum<{
+    direct_upload: "direct_upload";
+    git: "git";
+}>;
+export declare const pushNewUploadModeSchema: z.ZodEnum<{
+    static_publish: "static_publish";
+    source_archive_build: "source_archive_build";
+}>;
+export declare const PushNewSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        live: "live";
+        failed: "failed";
+        expired: "expired";
+        building: "building";
+        waiting_for_push: "waiting_for_push";
+        waiting_for_upload: "waiting_for_upload";
+        publishing: "publishing";
+    }>;
+    sourceKind: z.ZodEnum<{
+        direct_upload: "direct_upload";
+        git: "git";
+    }>;
+    uploadMode: z.ZodNullable<z.ZodEnum<{
+        static_publish: "static_publish";
+        source_archive_build: "source_archive_build";
+    }>>;
+    slug: z.ZodString;
+    spaceSlug: z.ZodString;
+    spaceId: z.ZodString;
+    repositoryConnectionId: z.ZodNullable<z.ZodString>;
+    repositoryId: z.ZodNullable<z.ZodString>;
+    repositoryFullName: z.ZodNullable<z.ZodString>;
+    branch: z.ZodString;
+    ref: z.ZodNullable<z.ZodString>;
+    commitSha: z.ZodNullable<z.ZodString>;
+    buildId: z.ZodNullable<z.ZodString>;
+    publishOperationId: z.ZodNullable<z.ZodString>;
+    versionId: z.ZodNullable<z.ZodString>;
+    reusedVersionId: z.ZodNullable<z.ZodString>;
+    webhookDeliveryId: z.ZodNullable<z.ZodString>;
+    liveUrl: z.ZodString;
+    sessionUrl: z.ZodString;
+    logsUrl: z.ZodNullable<z.ZodString>;
+    claimUrl: z.ZodString;
+    remoteUrl: z.ZodNullable<z.ZodString>;
+    remoteExpiresAt: z.ZodNullable<z.ZodString>;
+    errorCode: z.ZodNullable<z.ZodString>;
+    errorMessage: z.ZodNullable<z.ZodString>;
+    expiresAt: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const PushNewCreateSessionResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        live: "live";
+        failed: "failed";
+        expired: "expired";
+        building: "building";
+        waiting_for_push: "waiting_for_push";
+        waiting_for_upload: "waiting_for_upload";
+        publishing: "publishing";
+    }>;
+    sourceKind: z.ZodEnum<{
+        direct_upload: "direct_upload";
+        git: "git";
+    }>;
+    uploadMode: z.ZodNullable<z.ZodEnum<{
+        static_publish: "static_publish";
+        source_archive_build: "source_archive_build";
+    }>>;
+    slug: z.ZodString;
+    spaceSlug: z.ZodString;
+    spaceId: z.ZodString;
+    repositoryConnectionId: z.ZodNullable<z.ZodString>;
+    repositoryId: z.ZodNullable<z.ZodString>;
+    repositoryFullName: z.ZodNullable<z.ZodString>;
+    branch: z.ZodString;
+    ref: z.ZodNullable<z.ZodString>;
+    commitSha: z.ZodNullable<z.ZodString>;
+    buildId: z.ZodNullable<z.ZodString>;
+    publishOperationId: z.ZodNullable<z.ZodString>;
+    versionId: z.ZodNullable<z.ZodString>;
+    reusedVersionId: z.ZodNullable<z.ZodString>;
+    webhookDeliveryId: z.ZodNullable<z.ZodString>;
+    liveUrl: z.ZodString;
+    sessionUrl: z.ZodString;
+    logsUrl: z.ZodNullable<z.ZodString>;
+    claimUrl: z.ZodString;
+    remoteUrl: z.ZodNullable<z.ZodString>;
+    remoteExpiresAt: z.ZodNullable<z.ZodString>;
+    errorCode: z.ZodNullable<z.ZodString>;
+    errorMessage: z.ZodNullable<z.ZodString>;
+    expiresAt: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const PushNewStatusResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        live: "live";
+        failed: "failed";
+        expired: "expired";
+        building: "building";
+        waiting_for_push: "waiting_for_push";
+        waiting_for_upload: "waiting_for_upload";
+        publishing: "publishing";
+    }>;
+    expiresAt: z.ZodString;
+    createdAt: z.ZodString;
+    spaceId: z.ZodString;
+    updatedAt: z.ZodString;
+    ref: z.ZodNullable<z.ZodString>;
+    versionId: z.ZodNullable<z.ZodString>;
+    spaceSlug: z.ZodString;
+    branch: z.ZodString;
+    commitSha: z.ZodNullable<z.ZodString>;
+    repositoryFullName: z.ZodNullable<z.ZodString>;
+    slug: z.ZodString;
+    liveUrl: z.ZodString;
+    buildId: z.ZodNullable<z.ZodString>;
+    claimUrl: z.ZodString;
+    repositoryConnectionId: z.ZodNullable<z.ZodString>;
+    repositoryId: z.ZodNullable<z.ZodString>;
+    reusedVersionId: z.ZodNullable<z.ZodString>;
+    errorCode: z.ZodNullable<z.ZodString>;
+    sourceKind: z.ZodEnum<{
+        direct_upload: "direct_upload";
+        git: "git";
+    }>;
+    remoteExpiresAt: z.ZodNullable<z.ZodString>;
+    uploadMode: z.ZodNullable<z.ZodEnum<{
+        static_publish: "static_publish";
+        source_archive_build: "source_archive_build";
+    }>>;
+    publishOperationId: z.ZodNullable<z.ZodString>;
+    webhookDeliveryId: z.ZodNullable<z.ZodString>;
+    sessionUrl: z.ZodString;
+    logsUrl: z.ZodNullable<z.ZodString>;
+    errorMessage: z.ZodNullable<z.ZodString>;
+    remoteUrl: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type PushNewSessionStatus = z.infer<typeof pushNewSessionStatusSchema>;
+export type PushNewSourceKind = z.infer<typeof pushNewSourceKindSchema>;
+export type PushNewSession = z.infer<typeof PushNewSessionSchema>;

package/dist/contracts/push-new.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+export const pushNewSessionStatusSchema = z.enum([
+    "waiting_for_push",
+    "waiting_for_upload",
+    "publishing",
+    "building",
+    "live",
+    "failed",
+    "expired",
+]);
+export const pushNewSourceKindSchema = z.enum(["git", "direct_upload"]);
+export const pushNewUploadModeSchema = z.enum(["static_publish", "source_archive_build"]);
+const nullableDateTime = z.string().datetime().nullable();
+export const PushNewSessionSchema = z.object({
+    id: z.string().describe("push.new session id (`psh_...`)."),
+    status: pushNewSessionStatusSchema,
+    sourceKind: pushNewSourceKindSchema,
+    uploadMode: pushNewUploadModeSchema.nullable(),
+    slug: z.string().describe("Bearer session slug."),
+    spaceSlug: z.string(),
+    spaceId: z.string(),
+    repositoryConnectionId: z.string().nullable(),
+    repositoryId: z.string().nullable(),
+    repositoryFullName: z.string().nullable(),
+    branch: z.string(),
+    ref: z.string().nullable(),
+    commitSha: z.string().nullable(),
+    buildId: z.string().nullable(),
+    publishOperationId: z.string().nullable(),
+    versionId: z.string().nullable(),
+    reusedVersionId: z.string().nullable(),
+    webhookDeliveryId: z.string().nullable(),
+    liveUrl: z.string().url(),
+    sessionUrl: z.string().url(),
+    logsUrl: z.string().url().nullable(),
+    claimUrl: z.string().url(),
+    remoteUrl: z.string().url().nullable(),
+    remoteExpiresAt: nullableDateTime,
+    errorCode: z.string().nullable(),
+    errorMessage: z.string().nullable(),
+    expiresAt: z.string().datetime(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+});
+export const PushNewCreateSessionResponseSchema = PushNewSessionSchema;
+export const PushNewStatusResponseSchema = PushNewSessionSchema.omit({ remoteUrl: true }).extend({
+    remoteUrl: z
+        .string()
+        .url()
+        .nullable()
+        .describe("Returned only while the write remote is usable."),
+});

package/dist/contracts/quotas.d.ts

@@ -0,0 +1,16 @@
+export declare const WORST_CASE_QUOTAS: {
+    readonly maxArtifactBytes: number;
+    readonly maxInlinePublishBodyBytes: number;
+    readonly maxVersionsPerFreeSpace: 200;
+    readonly maxEgressBytesPerSpacePerDay: number;
+    readonly maxPublishesPerIpPerHour: 20;
+    readonly maxClaimedFreeSpacesPerAccount: 50;
+    readonly maxWebhookDeliveriesPerTenantPerHour: 10000;
+};
+export type WorstCaseQuotaName = keyof typeof WORST_CASE_QUOTAS;
+export declare const ANONYMOUS_PUBLISH_CAPS: {
+    readonly maxFileBytes: number;
+    readonly maxInlineBodyBytes: number;
+    readonly maxFilesPerVersion: 1000;
+    readonly maxPublishesPerIpPerHour: 20;
+};

package/dist/contracts/quotas.js

@@ -0,0 +1,36 @@
+// Crude worst-case quotas (internal-docs/platform.md "Abuse Posture"): hard,
+// launch-day abuse controls that exist independently of plan limits. One named
+// raise-only table — raising a limit later is a tweet, lowering one is a
+// betrayal. Enforcement points live in the control plane and reference these
+// names; every trip emits activity/ops events so thresholds are tuned from data.
+export const WORST_CASE_QUOTAS = {
+    // Per-version artifact ceiling (sum of file bytes; enforced at manifest intake).
+    maxArtifactBytes: 2 * 1024 * 1024 * 1024,
+    // Inline one-shot publish body cap (compressed archive bytes).
+    maxInlinePublishBodyBytes: 128 * 1024 * 1024,
+    // Versions a free/anonymous space may accumulate before old ones must go.
+    maxVersionsPerFreeSpace: 200,
+    // Daily egress per space before the per-space kill switch engages.
+    maxEgressBytesPerSpacePerDay: 100 * 1024 * 1024 * 1024,
+    // Anonymous publish/space-create attempts per IP per hour.
+    maxPublishesPerIpPerHour: 20,
+    // Spaces an account may claim out of the anonymous flow.
+    maxClaimedFreeSpacesPerAccount: 50,
+    // Webhook deliveries a tenant's endpoints may receive per hour; deliveries
+    // over budget are recorded failed (never silently dropped) and never queued.
+    maxWebhookDeliveriesPerTenantPerHour: 10_000,
+};
+// Anonymous-tier safety caps (internal-docs/platform.md "Abuse Posture"):
+// LIVE launch values, anonymous <= Free on every axis. These protect the
+// platform and are not soft plan seams; plan policy can only raise them.
+export const ANONYMOUS_PUBLISH_CAPS = {
+    // Per-file ceiling (= Free plan maxFileBytes).
+    maxFileBytes: 50 * 1024 * 1024,
+    // Inline one-shot publish body cap; tighter than the absolute
+    // maxInlinePublishBodyBytes ceiling above.
+    maxInlineBodyBytes: 100 * 1024 * 1024,
+    // Files per version for anonymous publishes.
+    maxFilesPerVersion: 1000,
+    // Anonymous publish/space-create attempts per IP per hour.
+    maxPublishesPerIpPerHour: WORST_CASE_QUOTAS.maxPublishesPerIpPerHour,
+};

package/dist/contracts/repository-connections.d.ts

@@ -0,0 +1,231 @@
+import { z } from "zod";
+export declare const repositoryConnectionTypeSchema: z.ZodEnum<{
+    hosted: "hosted";
+    connected: "connected";
+}>;
+export declare const repositoryConnectionSyncStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    ready: "ready";
+    idle: "idle";
+    syncing: "syncing";
+}>;
+export declare const RepositoryConnectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    spaceId: z.ZodString;
+    provider: z.ZodEnum<{
+        github: "github";
+        gitlab: "gitlab";
+        bitbucket: "bitbucket";
+        generic: "generic";
+    }>;
+    connectionType: z.ZodEnum<{
+        hosted: "hosted";
+        connected: "connected";
+    }>;
+    repositoryId: z.ZodNullable<z.ZodString>;
+    repositoryName: z.ZodString;
+    repositoryFullName: z.ZodString;
+    defaultBranch: z.ZodString;
+    productionBranch: z.ZodString;
+    credentialConfigured: z.ZodBoolean;
+    autoDeployProduction: z.ZodBoolean;
+    autoDeployPreviews: z.ZodBoolean;
+    buildSettings: z.ZodObject<{
+        rootDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        installDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        installCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        buildCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        outputDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        ignoredBuildCommand: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        frameworkPreset: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        platformPreset: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        allowUnsupportedPlatformFeatures: z.ZodDefault<z.ZodBoolean>;
+        timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    syncStatus: z.ZodEnum<{
+        failed: "failed";
+        ready: "ready";
+        idle: "idle";
+        syncing: "syncing";
+    }>;
+    lastSyncedAt: z.ZodNullable<z.ZodString>;
+    lastSyncError: z.ZodNullable<z.ZodString>;
+    syncRunId: z.ZodNullable<z.ZodString>;
+    connectedUserId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const repositoryConnectionCreateSchema: z.ZodObject<{
+    provider: z.ZodDefault<z.ZodEnum<{
+        github: "github";
+        gitlab: "gitlab";
+        bitbucket: "bitbucket";
+        generic: "generic";
+    }>>;
+    connectionType: z.ZodDefault<z.ZodEnum<{
+        hosted: "hosted";
+        connected: "connected";
+    }>>;
+    repositoryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    repositoryName: z.ZodOptional<z.ZodString>;
+    repositoryFullName: z.ZodString;
+    defaultBranch: z.ZodDefault<z.ZodString>;
+    productionBranch: z.ZodOptional<z.ZodString>;
+    cloneUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    upstreamUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    installationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    credential: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    autoDeployProduction: z.ZodDefault<z.ZodBoolean>;
+    autoDeployPreviews: z.ZodDefault<z.ZodBoolean>;
+    buildSettings: z.ZodOptional<z.ZodObject<{
+        rootDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        installDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        installCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        buildCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        outputDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        ignoredBuildCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        frameworkPreset: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        platformPreset: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        allowUnsupportedPlatformFeatures: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        timeoutSeconds: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const repositoryConnectionPatchSchema: z.ZodObject<{
+    connectionType: z.ZodOptional<z.ZodEnum<{
+        hosted: "hosted";
+        connected: "connected";
+    }>>;
+    productionBranch: z.ZodOptional<z.ZodString>;
+    cloneUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    upstreamUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    credential: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    autoDeployProduction: z.ZodOptional<z.ZodBoolean>;
+    autoDeployPreviews: z.ZodOptional<z.ZodBoolean>;
+    buildSettings: z.ZodOptional<z.ZodObject<{
+        rootDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        installDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        installCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        buildCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        outputDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        ignoredBuildCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        frameworkPreset: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        platformPreset: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        allowUnsupportedPlatformFeatures: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        timeoutSeconds: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const repositoryImportRemoteSchema: z.ZodObject<{
+    provider: z.ZodDefault<z.ZodEnum<{
+        github: "github";
+        gitlab: "gitlab";
+        bitbucket: "bitbucket";
+        generic: "generic";
+    }>>;
+    repositoryFullName: z.ZodString;
+    repositoryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    repositoryName: z.ZodOptional<z.ZodString>;
+    defaultBranch: z.ZodDefault<z.ZodString>;
+    productionBranch: z.ZodOptional<z.ZodString>;
+    cloneUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    buildSettings: z.ZodOptional<z.ZodObject<{
+        rootDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        installDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        installCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        buildCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        outputDirectory: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        ignoredBuildCommand: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        frameworkPreset: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        platformPreset: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+        allowUnsupportedPlatformFeatures: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        timeoutSeconds: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    }, z.core.$strip>>;
+    autoDeployProduction: z.ZodDefault<z.ZodBoolean>;
+    autoDeployPreviews: z.ZodDefault<z.ZodBoolean>;
+    credential: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    installationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    upstreamUrl: z.ZodString;
+}, z.core.$strip>;
+export declare const repositoryWebhookDeliveryStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    ignored: "ignored";
+    received: "received";
+    processing: "processing";
+    processed: "processed";
+}>;
+export declare const RepositoryWebhookDeliverySchema: z.ZodObject<{
+    id: z.ZodString;
+    receiver: z.ZodString;
+    deliveryId: z.ZodString;
+    repositoryConnectionId: z.ZodNullable<z.ZodString>;
+    matchedConnectionIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    repositoryId: z.ZodNullable<z.ZodString>;
+    eventName: z.ZodString;
+    ref: z.ZodNullable<z.ZodString>;
+    commit: z.ZodNullable<z.ZodString>;
+    syncRunId: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        failed: "failed";
+        ignored: "ignored";
+        received: "received";
+        processing: "processing";
+        processed: "processed";
+    }>;
+    statusMessage: z.ZodNullable<z.ZodString>;
+    queuedBuildIds: z.ZodArray<z.ZodString>;
+    retiredVersionIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    rawBodySha256: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const repositoryWebhookDeliveryListQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    connectionType: z.ZodOptional<z.ZodEnum<{
+        hosted: "hosted";
+        connected: "connected";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        failed: "failed";
+        ignored: "ignored";
+        received: "received";
+        processing: "processing";
+        processed: "processed";
+    }>>;
+}, z.core.$strip>;
+export declare const repositoryWebhookDeliveryListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        receiver: z.ZodString;
+        deliveryId: z.ZodString;
+        repositoryConnectionId: z.ZodNullable<z.ZodString>;
+        matchedConnectionIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        repositoryId: z.ZodNullable<z.ZodString>;
+        eventName: z.ZodString;
+        ref: z.ZodNullable<z.ZodString>;
+        commit: z.ZodNullable<z.ZodString>;
+        syncRunId: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            failed: "failed";
+            ignored: "ignored";
+            received: "received";
+            processing: "processing";
+            processed: "processed";
+        }>;
+        statusMessage: z.ZodNullable<z.ZodString>;
+        queuedBuildIds: z.ZodArray<z.ZodString>;
+        retiredVersionIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        rawBodySha256: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        nextCursor: z.ZodNullable<z.ZodString>;
+        hasMore: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type RepositoryConnection = z.infer<typeof RepositoryConnectionSchema>;
+export type RepositoryConnectionCreate = z.infer<typeof repositoryConnectionCreateSchema>;
+export type RepositoryConnectionPatch = z.infer<typeof repositoryConnectionPatchSchema>;
+export type RepositoryImportRemote = z.infer<typeof repositoryImportRemoteSchema>;
+export type RepositoryConnectionType = z.infer<typeof repositoryConnectionTypeSchema>;
+export type RepositoryWebhookDelivery = z.infer<typeof RepositoryWebhookDeliverySchema>;

package/dist/contracts/repository-connections.js

@@ -0,0 +1,106 @@
+import { z } from "zod";
+import { BuildSettingsSchema } from "./builds.js";
+import { CursorPaginationSchema, cursorListQuerySchema } from "./common.js";
+import { gitProvider } from "./enums.js";
+// Two connection types only:
+// - `connected`: external git host + webhook (formerly `remote`).
+// - `hosted`: Stattic-hosted signed remote (formerly `push`).
+// Importing an existing remote is an action (see `repositoryImportRemoteSchema`),
+// not a connection type, so `import` is intentionally absent from this union.
+export const repositoryConnectionTypeSchema = z.enum(["connected", "hosted"]);
+export const repositoryConnectionSyncStatusSchema = z.enum(["idle", "syncing", "ready", "failed"]);
+export const RepositoryConnectionSchema = z.object({
+    id: z.string().describe("Repository connection id (`rpc_`)."),
+    spaceId: z.string(),
+    provider: gitProvider.describe("Git host family for the repository connection."),
+    connectionType: repositoryConnectionTypeSchema,
+    repositoryId: z.string().nullable(),
+    repositoryName: z.string(),
+    repositoryFullName: z.string(),
+    defaultBranch: z.string(),
+    productionBranch: z.string(),
+    credentialConfigured: z.boolean(),
+    autoDeployProduction: z.boolean(),
+    autoDeployPreviews: z.boolean(),
+    buildSettings: BuildSettingsSchema,
+    syncStatus: repositoryConnectionSyncStatusSchema,
+    lastSyncedAt: z.string().datetime().nullable(),
+    lastSyncError: z.string().nullable(),
+    syncRunId: z.string().nullable(),
+    connectedUserId: z.string().nullable(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+});
+export const repositoryConnectionCreateSchema = z.object({
+    provider: gitProvider.default("github"),
+    connectionType: repositoryConnectionTypeSchema.default("connected"),
+    repositoryId: z.string().trim().min(1).nullable().optional(),
+    repositoryName: z.string().trim().min(1).optional(),
+    repositoryFullName: z.string().trim().min(1),
+    defaultBranch: z.string().trim().min(1).default("main"),
+    productionBranch: z.string().trim().min(1).optional(),
+    cloneUrl: z.string().trim().min(1).nullable().optional(),
+    upstreamUrl: z.string().trim().min(1).nullable().optional(),
+    installationId: z
+        .string()
+        .trim()
+        .min(1)
+        .nullable()
+        .optional()
+        .describe("Repository app installation id."),
+    credential: z.string().trim().min(1).nullable().optional(),
+    autoDeployProduction: z.boolean().default(true),
+    autoDeployPreviews: z.boolean().default(true),
+    buildSettings: BuildSettingsSchema.partial().optional(),
+});
+export const repositoryConnectionPatchSchema = z.object({
+    connectionType: repositoryConnectionTypeSchema.optional(),
+    productionBranch: z.string().trim().min(1).optional(),
+    cloneUrl: z.string().trim().min(1).nullable().optional(),
+    upstreamUrl: z.string().trim().min(1).nullable().optional(),
+    credential: z.string().trim().min(1).nullable().optional(),
+    autoDeployProduction: z.boolean().optional(),
+    autoDeployPreviews: z.boolean().optional(),
+    buildSettings: BuildSettingsSchema.partial().optional(),
+});
+// Importing an existing external remote is an action/flag, not a connection
+// type. It produces a `connected` connection seeded from an upstream remote.
+export const repositoryImportRemoteSchema = repositoryConnectionCreateSchema
+    .extend({
+    upstreamUrl: z.string().trim().min(1),
+})
+    .omit({ connectionType: true });
+export const repositoryWebhookDeliveryStatusSchema = z.enum([
+    "received",
+    "processing",
+    "processed",
+    "ignored",
+    "failed",
+]);
+export const RepositoryWebhookDeliverySchema = z.object({
+    id: z.string(),
+    receiver: z.string().describe("Webhook receiver that accepted the repository event."),
+    deliveryId: z.string().describe("Stable delivery id from the repository event source."),
+    repositoryConnectionId: z.string().nullable(),
+    matchedConnectionIds: z.array(z.string()).default([]),
+    repositoryId: z.string().nullable(),
+    eventName: z.string(),
+    ref: z.string().nullable(),
+    commit: z.string().nullable(),
+    syncRunId: z.string().nullable(),
+    status: repositoryWebhookDeliveryStatusSchema,
+    statusMessage: z.string().nullable(),
+    queuedBuildIds: z.array(z.string()),
+    retiredVersionIds: z.array(z.string()).default([]),
+    rawBodySha256: z.string().nullable(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+});
+export const repositoryWebhookDeliveryListQuerySchema = cursorListQuerySchema.extend({
+    connectionType: repositoryConnectionTypeSchema.optional(),
+    status: repositoryWebhookDeliveryStatusSchema.optional(),
+});
+export const repositoryWebhookDeliveryListResponseSchema = z.object({
+    data: z.array(RepositoryWebhookDeliverySchema),
+    pagination: CursorPaginationSchema,
+});