@spacefast/common 0.0.2

package/dist/contracts/enums.d.ts

@@ -0,0 +1,196 @@
+import { z } from "zod";
+export declare const spaceStatusValues: readonly ["provisioning", "active", "updating", "moving", "deleting", "failed"];
+export declare const spaceStatus: z.ZodEnum<{
+    active: "active";
+    provisioning: "provisioning";
+    updating: "updating";
+    moving: "moving";
+    deleting: "deleting";
+    failed: "failed";
+}>;
+export declare const spaceDisabledReasonCodeValues: readonly ["anonymous_expired", "abuse_takedown", "tenant_suspended", "site_suspended"];
+export declare const spaceDisabledReasonCode: z.ZodEnum<{
+    anonymous_expired: "anonymous_expired";
+    abuse_takedown: "abuse_takedown";
+    tenant_suspended: "tenant_suspended";
+    site_suspended: "site_suspended";
+}>;
+export declare const spaceTransferStatusValues: readonly ["pending_confirmation", "confirming_domains", "moving", "completed", "canceled", "expired"];
+export declare const spaceTransferStatus: z.ZodEnum<{
+    moving: "moving";
+    pending_confirmation: "pending_confirmation";
+    confirming_domains: "confirming_domains";
+    completed: "completed";
+    canceled: "canceled";
+    expired: "expired";
+}>;
+export declare const siteIsolationValues: readonly ["site", "space"];
+export declare const siteIsolation: z.ZodEnum<{
+    site: "site";
+    space: "space";
+}>;
+export declare const tenantKindValues: readonly ["main", "platform", "partner", "internal"];
+export declare const tenantKind: z.ZodEnum<{
+    internal: "internal";
+    main: "main";
+    platform: "platform";
+    partner: "partner";
+}>;
+export declare const tenantStatusValues: readonly ["active", "past_due", "suspended", "deleted"];
+export declare const tenantStatus: z.ZodEnum<{
+    active: "active";
+    past_due: "past_due";
+    suspended: "suspended";
+    deleted: "deleted";
+}>;
+export declare const providerClientStatusValues: readonly ["active", "disabled"];
+export declare const providerClientStatus: z.ZodEnum<{
+    active: "active";
+    disabled: "disabled";
+}>;
+export declare const siteKindValues: readonly ["static_runtime"];
+export declare const siteKind: z.ZodEnum<{
+    static_runtime: "static_runtime";
+}>;
+export declare const siteStatusValues: readonly ["ready_pool", "active", "provisioning", "degraded", "suspended", "deleted"];
+export declare const siteStatus: z.ZodEnum<{
+    active: "active";
+    provisioning: "provisioning";
+    suspended: "suspended";
+    deleted: "deleted";
+    ready_pool: "ready_pool";
+    degraded: "degraded";
+}>;
+export declare const siteClassValues: readonly ["anonymous_pool", "shared_org", "dedicated_space"];
+export declare const siteClass: z.ZodEnum<{
+    anonymous_pool: "anonymous_pool";
+    shared_org: "shared_org";
+    dedicated_space: "dedicated_space";
+}>;
+export declare const publishSourceKindValues: readonly ["direct_upload", "cli", "dashboard", "api", "git", "import", "agent", "build", "variable_update", "config_update"];
+export declare const publishSourceKind: z.ZodEnum<{
+    build: "build";
+    agent: "agent";
+    api: "api";
+    direct_upload: "direct_upload";
+    cli: "cli";
+    dashboard: "dashboard";
+    git: "git";
+    import: "import";
+    variable_update: "variable_update";
+    config_update: "config_update";
+}>;
+export declare const versionStatusValues: readonly ["building", "prepared", "created", "uploading", "uploaded", "finalizing", "ready", "failed", "expired", "canceled"];
+export declare const versionStatus: z.ZodEnum<{
+    failed: "failed";
+    canceled: "canceled";
+    expired: "expired";
+    building: "building";
+    prepared: "prepared";
+    created: "created";
+    uploading: "uploading";
+    uploaded: "uploaded";
+    finalizing: "finalizing";
+    ready: "ready";
+}>;
+export declare const gitProviderValues: readonly ["github", "gitlab", "bitbucket", "generic"];
+export declare const gitProvider: z.ZodEnum<{
+    github: "github";
+    gitlab: "gitlab";
+    bitbucket: "bitbucket";
+    generic: "generic";
+}>;
+export declare const VERSION_IN_FLIGHT_STATUSES: readonly ["created", "uploading", "uploaded", "finalizing"];
+export declare const buildStatusValues: readonly ["waiting_for_source", "uploading_source", "queued", "running", "succeeded", "failed", "canceled", "skipped"];
+export declare const buildStatus: z.ZodEnum<{
+    failed: "failed";
+    canceled: "canceled";
+    waiting_for_source: "waiting_for_source";
+    uploading_source: "uploading_source";
+    queued: "queued";
+    running: "running";
+    succeeded: "succeeded";
+    skipped: "skipped";
+}>;
+export declare const diagnosticSeverity: z.ZodEnum<{
+    info: "info";
+    warning: "warning";
+    error: "error";
+}>;
+export declare const diagnosticProvider: z.ZodEnum<{
+    registrar: "registrar";
+    wpcloud: "wpcloud";
+    dns: "dns";
+    runtime: "runtime";
+}>;
+export declare const domainOwnershipTypeValues: readonly ["external", "registered", "transferred", "system"];
+export declare const domainDnsModeValues: readonly ["external", "stattic_nameservers", "registrar_dns"];
+export declare const domainRegistrarProviderValues: readonly ["none", "dsapi", "manual"];
+export declare const domainDnsProviderValues: readonly ["none", "stattic", "route53", "cloudflare", "vercel", "wpcom", "pressable", "dsapi", "manual"];
+export declare const domainLifecycleStatusValues: readonly ["active", "pending_registration", "pending_transfer", "expired", "suspended", "redemption", "failed"];
+export declare const safetyCategoryValues: readonly ["csam", "malware", "phishing", "spam", "copyright", "fraud", "hateful_content", "extremism", "illegal_content", "privacy_violation", "compromised_account", "other_violation"];
+export declare const safetyCategory: z.ZodEnum<{
+    csam: "csam";
+    malware: "malware";
+    phishing: "phishing";
+    spam: "spam";
+    copyright: "copyright";
+    fraud: "fraud";
+    hateful_content: "hateful_content";
+    extremism: "extremism";
+    illegal_content: "illegal_content";
+    privacy_violation: "privacy_violation";
+    compromised_account: "compromised_account";
+    other_violation: "other_violation";
+}>;
+export declare const SAFETY_SEVERITY: {
+    readonly suspicious: 1;
+    readonly low: 2;
+    readonly medium: 3;
+    readonly high: 4;
+    readonly critical: 5;
+};
+export declare const safetySeverity: z.ZodNumber;
+export declare const enforcementTierValues: readonly ["record", "space_takedown", "account_suspend"];
+export declare const enforcementTier: z.ZodEnum<{
+    record: "record";
+    space_takedown: "space_takedown";
+    account_suspend: "account_suspend";
+}>;
+export declare const cachePurgeAction: z.ZodEnum<{
+    invalidate: "invalidate";
+}>;
+export declare const cachePurgeTarget: z.ZodEnum<{
+    space: "space";
+    domain: "domain";
+    path: "path";
+}>;
+export declare const bullJobStatus: z.ZodEnum<{
+    active: "active";
+    failed: "failed";
+    completed: "completed";
+    delayed: "delayed";
+    prioritized: "prioritized";
+    waiting: "waiting";
+    "waiting-children": "waiting-children";
+}>;
+export declare const operationStatus: z.ZodEnum<{
+    failed: "failed";
+    canceled: "canceled";
+    queued: "queued";
+    running: "running";
+    succeeded: "succeeded";
+}>;
+export type VersionStatus = z.infer<typeof versionStatus>;
+export type GitProvider = z.infer<typeof gitProvider>;
+export type PublishSourceKind = z.infer<typeof publishSourceKind>;
+export type SiteIsolation = z.infer<typeof siteIsolation>;
+export type TenantKind = z.infer<typeof tenantKind>;
+export type TenantStatus = z.infer<typeof tenantStatus>;
+export type ProviderClientStatus = z.infer<typeof providerClientStatus>;
+export type SiteKind = z.infer<typeof siteKind>;
+export type SiteStatus = z.infer<typeof siteStatus>;
+export type SiteClass = z.infer<typeof siteClass>;
+export type OperationStatus = z.infer<typeof operationStatus>;
+export type SafetyCategory = z.infer<typeof safetyCategory>;
+export type EnforcementTier = z.infer<typeof enforcementTier>;

package/dist/contracts/enums.js

@@ -0,0 +1,211 @@
+import { z } from "zod";
+// Space operation-lifecycle axis (internal-docs/platform.md "Space"): exactly
+// these six. Serving (disabled) and deletion (deletedAt) are separate axes —
+// a disabled space can still be updating or moving.
+export const spaceStatusValues = [
+    "provisioning",
+    "active",
+    "updating",
+    "moving",
+    "deleting",
+    "failed",
+];
+export const spaceStatus = z.enum(spaceStatusValues);
+// Serving-axis disable reasons (internal-docs/platform.md "Space"): exactly
+// these four. Malware takedowns are `abuse_takedown` with
+// `details.source = "malware_scan"`.
+export const spaceDisabledReasonCodeValues = [
+    "anonymous_expired",
+    "abuse_takedown",
+    "tenant_suspended",
+    "site_suspended",
+];
+export const spaceDisabledReasonCode = z.enum(spaceDisabledReasonCodeValues);
+// SpaceTransfer status machine (internal-docs/platform.md "Transfer
+// semantics"), stored directly — there is no separate DB vocabulary. No
+// `failed` state: a failed move reverts to `pending_confirmation` with a
+// diagnostic. `confirming_domains` gates the move on re-confirmation of the
+// space's bound domains; withdraw (from-side) and decline (to-side) both land
+// on `canceled`.
+export const spaceTransferStatusValues = [
+    "pending_confirmation",
+    "confirming_domains",
+    "moving",
+    "completed",
+    "canceled",
+    "expired",
+];
+export const spaceTransferStatus = z.enum(spaceTransferStatusValues);
+// Site axes per internal-docs/platform.md. `isolation` controls
+// whether settings/access default to the site or to each space.
+export const siteIsolationValues = ["site", "space"];
+export const siteIsolation = z.enum(siteIsolationValues);
+// A tenant is the platform-account boundary that owns every resource (internal-docs/platform.md
+// "Tenant -> Site -> Space"), Stripe-style. `main` is the single well-known
+// Stattic account (`ten_main`) all self-serve teams/users live under;
+// `platform` and `partner` are host integrations with their own user
+// directories and/or external customers; `internal` is for Stattic-operated
+// infrastructure tenants.
+export const tenantKindValues = ["main", "platform", "partner", "internal"];
+export const tenantKind = z.enum(tenantKindValues);
+// `past_due` is the billing-grace state: mutations are rejected immediately
+// (`tenant_past_due`) but serving continues until `servingGraceUntil`, after
+// which the tenant transitions to `suspended` and goes dark.
+export const tenantStatusValues = ["active", "past_due", "suspended", "deleted"];
+export const tenantStatus = z.enum(tenantStatusValues);
+// ProviderClient is the WP.Cloud account identity sites are provisioned under
+// (operator-only resource, `pvc_` prefix).
+export const providerClientStatusValues = ["active", "disabled"];
+export const providerClientStatus = z.enum(providerClientStatusValues);
+// Site (internal-docs/platform.md "Site", `site_`): THE placement unit. One
+// row per WP.Cloud site; spaces point at it via `space.siteId`.
+export const siteKindValues = ["static_runtime"];
+export const siteKind = z.enum(siteKindValues);
+// `ready_pool` is a pre-provisioned warm site waiting to be claimed for an
+// anonymous space (claim = CAS on status, wave A1).
+export const siteStatusValues = [
+    "ready_pool",
+    "active",
+    "provisioning",
+    "degraded",
+    "suspended",
+    "deleted",
+];
+export const siteStatus = z.enum(siteStatusValues);
+// Placement class for shared-pool sites: anonymous pool partition, one shared
+// site per team, or a site dedicated to a single space / tenant-created site.
+export const siteClassValues = ["anonymous_pool", "shared_org", "dedicated_space"];
+export const siteClass = z.enum(siteClassValues);
+// PublishSource.kind (internal-docs/platform.md "PublishSource"): the single
+// provenance axis for how a version came to exist. `variable_update` and
+// `config_update` versions are minted by cascades/config regeneration.
+export const publishSourceKindValues = [
+    "direct_upload",
+    "cli",
+    "dashboard",
+    "api",
+    "git",
+    "import",
+    "agent",
+    "build",
+    "variable_update",
+    "config_update",
+];
+export const publishSourceKind = z.enum(publishSourceKindValues);
+export const versionStatusValues = [
+    // Spec state machine (internal-docs/platform.md "Upload Contract"):
+    // created -> uploading -> uploaded -> finalizing -> ready, with terminal
+    // failed/canceled/expired. Build runs are tracked on the Build resource;
+    // a building version stays `created` until upload starts.
+    "building",
+    "prepared",
+    "created",
+    "uploading",
+    "uploaded",
+    "finalizing",
+    "ready",
+    "failed",
+    // Terminal: draft TTL elapsed before finalize, or retention window ended.
+    // Bytes purge through the runtime version-delete path; metadata and
+    // provenance stay for audit.
+    "expired",
+    "canceled",
+];
+export const versionStatus = z.enum(versionStatusValues);
+export const gitProviderValues = ["github", "gitlab", "bitbucket", "generic"];
+export const gitProvider = z.enum(gitProviderValues);
+// Pre-ready, non-terminal statuses: a version in one of these is in flight.
+export const VERSION_IN_FLIGHT_STATUSES = [
+    "created",
+    "uploading",
+    "uploaded",
+    "finalizing",
+];
+// Build resource statuses (internal-docs/platform.md "Build", `bld_`).
+export const buildStatusValues = [
+    "waiting_for_source",
+    "uploading_source",
+    "queued",
+    "running",
+    "succeeded",
+    "failed",
+    "canceled",
+    "skipped",
+];
+export const buildStatus = z.enum(buildStatusValues);
+export const diagnosticSeverity = z.enum(["info", "warning", "error"]);
+// Upstream system a Diagnostic originated from (internal-docs/platform.md L1621). Absent when
+// the diagnostic is Stattic's own (validation, routing compile, upload policy, ...).
+export const diagnosticProvider = z.enum(["wpcloud", "dns", "registrar", "runtime"]);
+// Internal domain DB-column vocabularies (consumed by the control-plane schema;
+// never part of the public Domain contract, which lives in contracts/domains.ts).
+export const domainOwnershipTypeValues = [
+    "external",
+    "registered",
+    "transferred",
+    "system",
+];
+export const domainDnsModeValues = ["external", "stattic_nameservers", "registrar_dns"];
+export const domainRegistrarProviderValues = ["none", "dsapi", "manual"];
+export const domainDnsProviderValues = [
+    "none",
+    "stattic",
+    "route53",
+    "cloudflare",
+    "vercel",
+    "wpcom",
+    "pressable",
+    "dsapi",
+    "manual",
+];
+export const domainLifecycleStatusValues = [
+    "active",
+    "pending_registration",
+    "pending_transfer",
+    "expired",
+    "suspended",
+    "redemption",
+    "failed",
+];
+// Abuse & safety taxonomy (WP.Cloud subset). The single category axis shared by
+// scan results, IP blocks, enforcement policies, and review items. Severity is
+// an ordinal 1-5 (suspicious..critical); enforcement tier is the action class a
+// (category, severity) pair maps to.
+export const safetyCategoryValues = [
+    "csam",
+    "malware",
+    "phishing",
+    "spam",
+    "copyright",
+    "fraud",
+    "hateful_content",
+    "extremism",
+    "illegal_content",
+    "privacy_violation",
+    "compromised_account",
+    "other_violation",
+];
+export const safetyCategory = z.enum(safetyCategoryValues);
+// 1 = suspicious, 2 = low, 3 = medium, 4 = high, 5 = critical.
+export const SAFETY_SEVERITY = {
+    suspicious: 1,
+    low: 2,
+    medium: 3,
+    high: 4,
+    critical: 5,
+};
+export const safetySeverity = z.number().int().min(1).max(5);
+export const enforcementTierValues = ["record", "space_takedown", "account_suspend"];
+export const enforcementTier = z.enum(enforcementTierValues);
+export const cachePurgeAction = z.enum(["invalidate"]);
+export const cachePurgeTarget = z.enum(["space", "domain", "path"]);
+export const bullJobStatus = z.enum([
+    "active",
+    "completed",
+    "delayed",
+    "failed",
+    "prioritized",
+    "waiting",
+    "waiting-children",
+]);
+export const operationStatus = z.enum(["queued", "running", "succeeded", "failed", "canceled"]);