allyhub 0.6.0 → 0.7.1

package/dist/node_modules/@allyhub-next/protocol/dist/sites.d.ts

@@ -0,0 +1,293 @@
+import { z } from "zod";
+/** The manifest's format; a reader that does not know it serves nothing. */
+export declare const SITE_MANIFEST_FORMAT = 1;
+/** What one deployment may hold, each checked by the server. */
+export declare const SITE_LIMITS: {
+    readonly files: 20000;
+    readonly bytes: number;
+    /** Rules of a site's `_redirects`. */
+    readonly redirects: 2000;
+    /** Rules of a site's `_headers`. */
+    readonly headers: 100;
+};
+/** How long an address is. */
+export declare const SLUG_LENGTH: {
+    readonly min: 3;
+    readonly max: 40;
+};
+/**
+ * Addresses no site may have: the platform's own, and names mail, browsers
+ * and other clients ask for by themselves.
+ */
+export declare const RESERVED_SLUGS: ReadonlySet<string>;
+/** Why a slug cannot be one; undefined when it can. */
+export declare function slugProblem(slug: string): string | undefined;
+export declare const SiteSlugSchema: z.ZodString;
+/** The statuses a `_redirects` rule answers with: a redirect, a rewrite, or a page shown as missing or gone. */
+export declare const REDIRECT_STATUSES: readonly [200, 301, 302, 303, 307, 308, 404, 410];
+export declare const RedirectRuleSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    status: z.ZodUnion<z.ZodLiteral<200 | 301 | 302 | 303 | 307 | 308 | 404 | 410>[]>;
+    force: z.ZodBoolean;
+}, z.core.$strict>;
+export type RedirectRule = z.infer<typeof RedirectRuleSchema>;
+/** Headers a site cannot set: a site's bytes and transport are the platform's, and it sets no cookies on a shared domain. */
+export declare const PLATFORM_HEADERS: ReadonlySet<string>;
+export declare const HeaderRuleSchema: z.ZodObject<{
+    for: z.ZodString;
+    set: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export type HeaderRule = z.infer<typeof HeaderRuleSchema>;
+/**
+ * What a site is: its files by path from its root, each a blob and the
+ * type it is served as, and its `_redirects` and `_headers`, read. Nothing
+ * in it names a project or a person.
+ */
+export declare const SiteManifestSchema: z.ZodObject<{
+    format: z.ZodLiteral<1>;
+    files: z.ZodRecord<z.ZodString, z.ZodObject<{
+        sha256: z.ZodString;
+        size: z.ZodInt;
+        type: z.ZodString;
+    }, z.core.$strip>>;
+    redirects: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        status: z.ZodUnion<z.ZodLiteral<200 | 301 | 302 | 303 | 307 | 308 | 404 | 410>[]>;
+        force: z.ZodBoolean;
+    }, z.core.$strict>>;
+    headers: z.ZodArray<z.ZodObject<{
+        for: z.ZodString;
+        set: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SiteManifest = z.infer<typeof SiteManifestSchema>;
+/** How a deployment was made: its files uploaded, or from a project's git. */
+export declare const SITE_SOURCE_KINDS: readonly ["upload", "git"];
+/** Where a deployment came from. `commit` once a project is in git; `digest`, the website's folder when it was built. */
+export declare const SiteSourceSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        upload: "upload";
+        git: "git";
+    }>;
+    commit: z.ZodOptional<z.ZodString>;
+    digest: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SiteSource = z.infer<typeof SiteSourceSchema>;
+export declare const DeploymentSchema: z.ZodObject<{
+    id: z.ZodString;
+    siteId: z.ZodString;
+    source: z.ZodObject<{
+        kind: z.ZodUnion<readonly [z.ZodEnum<{
+            upload: "upload";
+            git: "git";
+        }>, z.core.$ZodBranded<z.ZodString, "Unknown", "out">]>;
+        commit: z.ZodOptional<z.ZodString>;
+        digest: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    note: z.ZodNullable<z.ZodString>;
+    files: z.ZodNumber;
+    bytes: z.ZodNumber;
+    createdBy: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    live: z.ZodBoolean;
+}, z.core.$strip>;
+export type Deployment = z.infer<typeof DeploymentSchema>;
+export declare const SiteSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    url: z.ZodURL;
+    liveDeployment: z.ZodNullable<z.ZodString>;
+    approved: z.ZodBoolean;
+    autoPublish: z.ZodBoolean;
+    indexing: z.ZodBoolean;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type Site = z.infer<typeof SiteSchema>;
+/** `GET`: the organization's sites. `POST { slug, name }`: a site made. */
+export declare const SITES_PATH = "/api/sites";
+export declare const SiteCreateSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strict>;
+export type SiteCreate = z.infer<typeof SiteCreateSchema>;
+export declare const SitesResponseSchema: z.ZodObject<{
+    sites: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodString;
+        url: z.ZodURL;
+        liveDeployment: z.ZodNullable<z.ZodString>;
+        approved: z.ZodBoolean;
+        autoPublish: z.ZodBoolean;
+        indexing: z.ZodBoolean;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    domain: z.ZodString;
+    hosting: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * `GET`: a site and its versions, newest first. `DELETE ?person=1`: the site
+ * offline for good; its address is never given to anyone else. A site its
+ * organization removed answers 410, so a folder that still names it can make
+ * another; one that was never the organization's answers 404.
+ */
+export declare const sitePath: (id: string) => string;
+export declare const SiteDetailSchema: z.ZodObject<{
+    site: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodString;
+        url: z.ZodURL;
+        liveDeployment: z.ZodNullable<z.ZodString>;
+        approved: z.ZodBoolean;
+        autoPublish: z.ZodBoolean;
+        indexing: z.ZodBoolean;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+    deployments: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        siteId: z.ZodString;
+        source: z.ZodObject<{
+            kind: z.ZodUnion<readonly [z.ZodEnum<{
+                upload: "upload";
+                git: "git";
+            }>, z.core.$ZodBranded<z.ZodString, "Unknown", "out">]>;
+            commit: z.ZodOptional<z.ZodString>;
+            digest: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        note: z.ZodNullable<z.ZodString>;
+        files: z.ZodNumber;
+        bytes: z.ZodNumber;
+        createdBy: z.ZodString;
+        createdAt: z.ZodISODateTime;
+        live: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SiteDetail = z.infer<typeof SiteDetailSchema>;
+/** `POST { blobs }` (`BlobsRequestSchema`): which of these the site's organization lacks, each with where to put it. */
+export declare const siteBlobsPath: (site: string) => string;
+/**
+ * `POST { manifest, source, note }`: a version made from its manifest, a
+ * blob put already. Refused as a conflict, with the blobs storage does not
+ * hold, and nothing is recorded: a version is whole or it is not there.
+ */
+export declare const siteDeploymentsPath: (site: string) => string;
+export declare const DeploymentCreateSchema: z.ZodObject<{
+    manifest: z.ZodString;
+    source: z.ZodObject<{
+        kind: z.ZodEnum<{
+            upload: "upload";
+            git: "git";
+        }>;
+        commit: z.ZodOptional<z.ZodString>;
+        digest: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DeploymentCreate = z.infer<typeof DeploymentCreateSchema>;
+export declare const DeploymentMadeSchema: z.ZodObject<{
+    site: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodString;
+        url: z.ZodURL;
+        liveDeployment: z.ZodNullable<z.ZodString>;
+        approved: z.ZodBoolean;
+        autoPublish: z.ZodBoolean;
+        indexing: z.ZodBoolean;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+    deployment: z.ZodObject<{
+        id: z.ZodString;
+        siteId: z.ZodString;
+        source: z.ZodObject<{
+            kind: z.ZodUnion<readonly [z.ZodEnum<{
+                upload: "upload";
+                git: "git";
+            }>, z.core.$ZodBranded<z.ZodString, "Unknown", "out">]>;
+            commit: z.ZodOptional<z.ZodString>;
+            digest: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        note: z.ZodNullable<z.ZodString>;
+        files: z.ZodNumber;
+        bytes: z.ZodNumber;
+        createdBy: z.ZodString;
+        createdAt: z.ZodISODateTime;
+        live: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type DeploymentMade = z.infer<typeof DeploymentMadeSchema>;
+/**
+ * `PUT { deployment }`: the site serves this version, a publish and a
+ * rollback alike. `DELETE ?person=1`: it serves nothing, and keeps its
+ * address.
+ *
+ * Going public is a person's to say, and who asks is one of three:
+ *
+ * - the browser: a session on the account site's own origin, on the page
+ *   `confirm` names. The first time a site goes public takes this. An agent
+ *   has no session of its own, so this stops it from taking a site public by
+ *   the CLI or the API. It is not proof against everything on the computer:
+ *   the sign-in there can ask for a link that signs a browser in, which is
+ *   how Studio opens that page, and something that drives a browser could
+ *   press the button.
+ * - the person: `?person=1`, sent by Studio's window and never by the CLI.
+ *   It moves a site already approved, and is all that changes a site's
+ *   settings. An agent shares a computer's sign-in, so this keeps an agent
+ *   that uses the CLI out, not one that forges a request.
+ * - the agent: anything else. It moves a site whose person let it
+ *   (`autoPublish`), and does nothing else.
+ */
+export declare const siteLivePath: (site: string) => string;
+export declare const SiteLiveSchema: z.ZodObject<{
+    deployment: z.ZodString;
+}, z.core.$strict>;
+export type SiteLive = z.infer<typeof SiteLiveSchema>;
+export declare const SiteLiveAnswerSchema: z.ZodObject<{
+    site: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodString;
+        url: z.ZodURL;
+        liveDeployment: z.ZodNullable<z.ZodString>;
+        approved: z.ZodBoolean;
+        autoPublish: z.ZodBoolean;
+        indexing: z.ZodBoolean;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+    live: z.ZodBoolean;
+    confirm: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;
+export type SiteLiveAnswer = z.infer<typeof SiteLiveAnswerSchema>;
+/** The query that says a person asked, from Studio's window. */
+export declare const SITE_PERSON_QUERY = "person=1";
+/** The account site's page where a person says yes to a site going public. */
+export declare const SITE_CONFIRM_PAGE = "/publish";
+/** That page, for a version of a site. */
+export declare const siteConfirmPath: (o: {
+    site: string;
+    version: string;
+    organization: string;
+}) => string;
+/** `PUT ?person=1`: what the person changes of a site. */
+export declare const siteSettingsPath: (site: string) => string;
+export declare const SiteSettingsSchema: z.ZodObject<{
+    autoPublish: z.ZodOptional<z.ZodBoolean>;
+    indexing: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type SiteSettings = z.infer<typeof SiteSettingsSchema>;
+/** What the edge reads for a hostname. */
+export declare const SitePointerSchema: z.ZodObject<{
+    site: z.ZodString;
+    organization: z.ZodString;
+    deployment: z.ZodString;
+    manifest: z.ZodString;
+    indexing: z.ZodBoolean;
+}, z.core.$strip>;
+export type SitePointer = z.infer<typeof SitePointerSchema>;
+/** Where the edge's store keeps a hostname's pointer. */
+export declare const sitePointerKey: (hostname: string) => string;
+//# sourceMappingURL=sites.d.ts.map

package/dist/node_modules/@allyhub-next/protocol/dist/sites.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{z as e}from"zod";import{Sha256Schema as o,TreeFileSchema as i,TreePathSchema as a}from"./blobs.js";import{openEnum as c}from"./open.js";export const SITE_MANIFEST_FORMAT=1,SITE_LIMITS={files:2e4,bytes:5*1024*1024*1024,redirects:2e3,headers:100},SLUG_LENGTH={min:3,max:40},RESERVED_SLUGS=new Set(["abuse","account","accounts","admin","administrator","allyhub","api","app","assets","auth","autoconfig","autodiscover","billing","blog","cdn","dashboard","dev","dns","docs","download","downloads","ftp","help","hostmaster","imap","login","mail","mta-sts","ns1","ns2","ops","pop","postmaster","preview","root","security","signin","smtp","staging","static","status","studio","support","test","webmaster","wpad","www"]);export function slugProblem(t){if(t.length<SLUG_LENGTH.min||t.length>SLUG_LENGTH.max)return`An address is ${String(SLUG_LENGTH.min)} to ${String(SLUG_LENGTH.max)} characters.`;if(!/^[a-z0-9-]+$/u.test(t))return"An address is lowercase letters, digits and hyphens.";if(t.startsWith("-")||t.endsWith("-"))return"An address neither starts nor ends with a hyphen.";if(t.includes("--"))return"An address does not have two hyphens in a row.";if(RESERVED_SLUGS.has(t))return"That address is reserved."}export const SiteSlugSchema=e.string().superRefine((t,r)=>{const n=slugProblem(t);n!==void 0&&r.addIssue({code:"custom",message:n})}),REDIRECT_STATUSES=[200,301,302,303,307,308,404,410];const s=e.string().min(1).max(1024).regex(/^\/[^\s]*$/u,"A rule's path starts with /.");export const RedirectRuleSchema=e.strictObject({from:s,to:e.string().min(1).max(2048).regex(/^(\/[^\s]*|https?:\/\/[^\s]+)$/u,"A rule goes to a path or an http(s) address."),status:e.union(REDIRECT_STATUSES.map(t=>e.literal(t))),force:e.boolean()}),PLATFORM_HEADERS=new Set(["accept-ranges","connection","content-encoding","content-length","content-range","date","keep-alive","set-cookie","strict-transport-security","trailer","transfer-encoding","upgrade","x-content-type-options"]);const p=e.string().regex(/^[A-Za-z0-9-]+$/u).max(128).refine(t=>!PLATFORM_HEADERS.has(t.toLowerCase()),"That header is the platform's.");export const HeaderRuleSchema=e.strictObject({for:s,set:e.record(p,e.string().max(2048))}),SiteManifestSchema=e.strictObject({format:e.literal(SITE_MANIFEST_FORMAT),files:e.record(a,i),redirects:e.array(RedirectRuleSchema).max(SITE_LIMITS.redirects),headers:e.array(HeaderRuleSchema).max(SITE_LIMITS.headers)}),SITE_SOURCE_KINDS=["upload","git"],SiteSourceSchema=e.strictObject({kind:e.enum(SITE_SOURCE_KINDS),commit:e.string().min(1).max(64).optional(),digest:o.optional()}),DeploymentSchema=e.object({id:e.string(),siteId:e.string(),source:e.object({...SiteSourceSchema.shape,kind:c(SITE_SOURCE_KINDS)}),note:e.string().nullable(),files:e.number(),bytes:e.number(),createdBy:e.string(),createdAt:e.iso.datetime(),live:e.boolean()}),SiteSchema=e.object({id:e.string(),slug:e.string(),name:e.string(),url:e.url(),liveDeployment:e.string().nullable(),approved:e.boolean(),autoPublish:e.boolean(),indexing:e.boolean(),createdAt:e.iso.datetime()}),SITES_PATH="/api/sites",SiteCreateSchema=e.strictObject({slug:SiteSlugSchema,name:e.string().min(1).max(255)}),SitesResponseSchema=e.object({sites:e.array(SiteSchema),domain:e.string(),hosting:e.boolean()}),sitePath=t=>`${SITES_PATH}/${encodeURIComponent(t)}`,SiteDetailSchema=e.object({site:SiteSchema,deployments:e.array(DeploymentSchema)}),siteBlobsPath=t=>`${sitePath(t)}/blobs`,siteDeploymentsPath=t=>`${sitePath(t)}/deployments`,DeploymentCreateSchema=e.strictObject({manifest:o,source:SiteSourceSchema,note:e.string().max(500).optional()}),DeploymentMadeSchema=e.object({site:SiteSchema,deployment:DeploymentSchema}),siteLivePath=t=>`${sitePath(t)}/live`,SiteLiveSchema=e.strictObject({deployment:e.string().min(1)}),SiteLiveAnswerSchema=e.object({site:SiteSchema,live:e.boolean(),confirm:e.url().optional()}),SITE_PERSON_QUERY="person=1",SITE_CONFIRM_PAGE="/publish",siteConfirmPath=t=>`${SITE_CONFIRM_PAGE}?site=${encodeURIComponent(t.site)}&version=${encodeURIComponent(t.version)}&org=${encodeURIComponent(t.organization)}`,siteSettingsPath=t=>`${sitePath(t)}/settings`,SiteSettingsSchema=e.strictObject({autoPublish:e.boolean().optional(),indexing:e.boolean().optional()}),SitePointerSchema=e.object({site:e.string(),organization:e.string(),deployment:e.string(),manifest:o,indexing:e.boolean()}),sitePointerKey=t=>`host:${t}`;