ninepm 0.69.0 → 0.78.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { Agent } from "undici";
+import { type DomainNext, type DomainReason, type DomainRecordStatus, type DomainState, type DomainStateDnsCheck, type DomainStateDnsInstruction, type DomainStateInput } from "./domain-state.js";
 import type { AccessGrant, AccessGrantType, AccessProviderKey, AppAccessSettings, AppAccessServiceToken, AppAccessToken, AppDatabase, AppRuntime, AppUserFilesUsage, ContainerImageUploadInstruction, ContainerRegion, Deployment, ManagedFileObject, ManagedFileShare, ManagedFileUsage, Project } from "./cli-types.js";
 export interface DeployOptions {
     directory: string;
@@ -18,6 +19,7 @@ export interface DeployOptions {
     runtime?: AppRuntime;
     entry?: string;
     publicAssets?: string;
+    missingPages?: "spa" | "404";
     port?: number;
     healthPath?: string;
     region?: ContainerRegion;
@@ -105,6 +107,7 @@ export interface DeletedSiteResult {
     slug: string;
     workers: number;
     customDomains: number;
+    customDomainNames?: string[];
     containerApplications?: number;
     containerImages?: number;
     accessApps: number;
@@ -124,7 +127,7 @@ export interface CreatedServiceToken {
     clientSecret: string;
 }
 export type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
-export declare const CLI_VERSION = "0.69.0";
+export declare const CLI_VERSION = "0.78.0";
 type CredentialBackend = "macos-keychain" | "windows-dpapi" | "linux-secret-service" | "file-plaintext" | "none";
 export interface StoredCredentialEntry {
     token: string;
@@ -225,7 +228,8 @@ export declare class DeployError extends Error {
  * prevent (#1061).
  */
 export declare class DeliberateRefusalError extends Error {
-    constructor(message: string);
+    readonly code: string | undefined;
+    constructor(message: string, code?: string);
 }
 export declare function isDeliberateRefusal(error: unknown): boolean;
 export declare function deployDirectory(initialOptions: DeployOptions): Promise<DeployResult>;
@@ -271,12 +275,16 @@ export type LogoutSummary = {
 };
 export declare function summarizeRevocations(attempts: RevocationAttempt[]): LogoutSummary;
 export declare function getSiteAccess(options: SiteAccessOptions): Promise<AccessState>;
-export declare function setSiteAccessPublic(options: SiteAccessOptions): Promise<AccessState["access"]>;
-export declare function setSiteAccessOtp(options: SiteAccessOptions): Promise<AccessState["access"]>;
-export declare function setSiteAccessIdp(options: SiteAccessOptions & {
+export declare const ACCESS_MODE_CHANGE_UNCONFIRMED = "access_mode_change_unconfirmed";
+export interface AccessModeChangeOptions extends SiteAccessOptions {
+    switchMode?: boolean;
+}
+export declare function setSiteAccessPublic(options: AccessModeChangeOptions): Promise<AccessState["access"]>;
+export declare function setSiteAccessOtp(options: AccessModeChangeOptions): Promise<AccessState["access"]>;
+export declare function setSiteAccessIdp(options: AccessModeChangeOptions & {
     providers?: AccessProviderKey[];
 }): Promise<AccessState["access"]>;
-export declare function createAccessServiceToken(options: SiteAccessOptions & {
+export declare function createAccessServiceToken(options: AccessModeChangeOptions & {
     name?: string;
     duration?: string;
 }): Promise<CreatedServiceToken>;
@@ -485,6 +493,7 @@ export declare function dashboardUrlForApiUrl(apiUrl: string): string;
 type CliCommand = {
     kind: "deploy";
     options: DeployOptions;
+    apiUrlFrom: ApiUrlSource;
 } | {
     kind: "version";
 } | {
@@ -612,6 +621,37 @@ type CliCommand = {
     };
     apiUrl: string;
     token: string;
+} | {
+    kind: "domains";
+    owner?: string;
+    apiUrlFrom: ApiUrlSource;
+    action: {
+        kind: "list";
+        site?: string;
+        json: boolean;
+    } | {
+        kind: "add" | "status" | "check";
+        site: string;
+        hostname: string;
+        json: boolean;
+    } | {
+        kind: "wait";
+        site: string;
+        hostname: string;
+        json: boolean;
+        timeoutSeconds: number;
+        intervalSeconds: number;
+    } | {
+        kind: "restart";
+        site: string;
+        hostname: string;
+    } | {
+        kind: "remove";
+        site: string;
+        hostname: string;
+    };
+    apiUrl: string;
+    token: string;
 } | {
     kind: "deployments";
     action: {
@@ -632,13 +672,16 @@ type CliCommand = {
     } | {
         kind: "public";
         site: string;
+        switchMode?: true;
     } | {
         kind: "otp";
         site: string;
+        switchMode?: true;
     } | {
         kind: "idp";
         site: string;
         providers?: AccessProviderKey[];
+        switchMode?: true;
     } | {
         kind: "allow";
         site: string;
@@ -654,6 +697,7 @@ type CliCommand = {
         site: string;
         name?: string;
         duration?: string;
+        switchMode?: true;
     } | {
         kind: "service-revoke";
         site: string;
@@ -669,6 +713,7 @@ type CliCommand = {
         tokenId: string;
     };
     apiUrl: string;
+    apiUrlFrom: ApiUrlSource;
     token: string;
 };
 export declare function parseArgs(argv: string[]): CliCommand;
@@ -688,7 +733,129 @@ export declare function deploymentsListJson<T extends ListedDeployment>(deployme
         serving: boolean;
     }>;
 };
+export { CUSTOM_DOMAIN_EXPIRED_TEXT, deriveDomainState, deriveDomainStatus, domainRecordStatuses, type DomainRecordCheck, type DomainRecordStatus, type DomainState, } from "./domain-state.js";
+export type CliDnsInstruction = DomainStateDnsInstruction;
+export type CliDomainDnsCheck = DomainStateDnsCheck & {
+    advisories?: Array<{
+        code: string;
+        message: string;
+    }>;
+};
+export interface CliDomain extends DomainStateInput {
+    dnsCheck?: CliDomainDnsCheck;
+    expireAfter?: string | null;
+    expiresAt?: string | null;
+    app?: {
+        id: string;
+        slug: string;
+        name: string;
+    };
+    state?: string;
+    reason?: DomainReason | null;
+    next?: DomainNext;
+}
+export interface DomainRecordStatusJson extends DomainRecordStatus {
+    typeAtProvider: string | null;
+    nameAtProvider: string;
+    valueAtProvider: string;
+}
+export interface DomainStatusJson {
+    hostname: string;
+    app: string;
+    state: DomainState | (string & {});
+    routing: string;
+    tls: string;
+    provider: string | null;
+    providerId: string | null;
+    nameservers: string[];
+    zone: string | null;
+    records: DomainRecordStatusJson[];
+    advisories: Array<{
+        code: string;
+        message: string;
+    }>;
+    error: string | null;
+    expiresAt: string | null;
+    checkedAt: string;
+    reason: DomainReason | null;
+    next: DomainNext;
+}
+export declare const DOMAIN_WAIT_EXIT: {
+    readonly live: 0;
+    readonly ownerAction: 10;
+    readonly platform: 11;
+    readonly failed: 20;
+};
+export declare function domainStatusJson(domain: CliDomain, app: string, checkedAt: string): DomainStatusJson;
+export declare function domainStateLabel(state: string): string;
+export declare function domainWaitExitCode(status: Pick<DomainStatusJson, "state" | "next">): number;
+export interface DomainFormatOptions {
+    owner?: string;
+    target?: AccessApiTarget;
+}
+export declare const DNS_PROVIDER_NOTES: Record<string, string>;
+export declare function formatDomainStatus(status: DomainStatusJson, options?: DomainFormatOptions): string[];
+export declare function domainWaitTimeoutMessage(status: DomainStatusJson): string;
+export declare function formatDomainsList(statuses: DomainStatusJson[]): string[];
+export declare class DomainsApiError extends Error {
+    readonly status: number;
+    readonly code: string | null;
+    constructor(message: string, status: number, code: string | null);
+}
+export declare function domainsApiError(status: number, text: string): DomainsApiError;
+export interface DomainCommandOptions extends ApiOptions {
+    site: string;
+    owner?: string;
+}
+export declare function normalizeDomainArg(value: string): string;
+export declare function listDomainStatuses(options: ApiOptions & {
+    site?: string;
+    owner?: string;
+    now?: () => Date;
+}): Promise<DomainStatusJson[]>;
+export declare function getDomainStatus(options: DomainCommandOptions & {
+    hostname: string;
+    now?: () => Date;
+}): Promise<DomainStatusJson>;
+export declare function addDomain(options: DomainCommandOptions & {
+    hostname: string;
+}): Promise<CliDomain | null>;
+export declare function recheckDomain(options: DomainCommandOptions & {
+    hostname: string;
+}): Promise<void>;
+export declare function restartDomain(options: DomainCommandOptions & {
+    hostname: string;
+}): Promise<{
+    domain: CliDomain;
+    replacedInstructions: CliDnsInstruction[];
+}>;
+export declare function removeDomain(options: DomainCommandOptions & {
+    hostname: string;
+}): Promise<CliDomain | null>;
+export declare const DEPLOY_DOMAINS_TIMEOUT_MS = 4500;
+export declare function deployCustomDomainStatuses(options: ApiOptions & {
+    projectId: string;
+    slug: string;
+    timeoutMs?: number;
+    now?: () => Date;
+}): Promise<DomainStatusJson[] | null>;
+export declare function deployCustomDomainLines(statuses: DomainStatusJson[] | null, slug: string, owner?: string, target?: AccessApiTarget): string[];
+export interface DomainWaitResult {
+    status: DomainStatusJson;
+    exitCode: number;
+    timedOut: boolean;
+}
+export declare function waitForDomain(options: DomainCommandOptions & {
+    hostname: string;
+    timeoutMs: number;
+    intervalMs: number;
+    nowMs?: () => number;
+    sleepFn?: (ms: number) => Promise<void>;
+    onStatus?: (status: DomainStatusJson) => void;
+    onRetry?: (error: unknown) => void;
+}): Promise<DomainWaitResult>;
 export declare function healthWithReason(status: string | null | undefined, reason: string | null | undefined): string;
+export type ApiUrlSource = "flag" | "env" | "default";
 export declare function workerPublicFiles(paths: readonly string[], serverEntry: string, selection: string | null): Array<{
     path: string;
     url: string;
@@ -723,4 +890,15 @@ export declare function hasNoGraphicalDisplay(platform: string, env: Record<stri
 export declare function formatAppUserFilesUsageLine(slug: string, usage: AppUserFilesUsage): string;
 export declare class UsageError extends Error {
 }
-export {};
+export declare function missingPagesLine(deployment: Deployment): string | null;
+type AccessModeChangeAction = Extract<Extract<CliCommand, {
+    kind: "access";
+}>["action"], {
+    kind: "public" | "otp" | "idp" | "service-create";
+}>;
+export interface AccessApiTarget {
+    apiUrl: string;
+    apiUrlFrom: ApiUrlSource;
+}
+export declare function apiUrlFlagFor(target?: AccessApiTarget): string;
+export declare function accessSwitchModeCommand(action: AccessModeChangeAction, target?: AccessApiTarget): string;