@dropthis/cli 0.9.3 → 0.11.0

package/node_modules/@dropthis/node/dist/{drops-BWA0D1IW.d.ts → drops-DEJcU6qw.d.ts}

@@ -153,6 +153,17 @@ type ApiKeyCreatedResponse = ApiKeyResponse & {
     accountId?: string | null;
     isNewAccount?: boolean;
 };
+/** Active plan tier limits — use these to size a publish before uploading. */
+type AccountLimits = {
+    /** Plan tier the limits apply to. */
+    name: string;
+    /** Maximum size of a single drop in bytes. */
+    maxSizeBytes: number;
+    /** Drop lifetime in seconds before expiry; null means drops are permanent. */
+    defaultTtlSeconds: number | null;
+    /** Total account storage cap in bytes; null means no account-level cap. */
+    maxStorageBytes: number | null;
+};
 type AccountResponse = {
     id: string;
     email: string;
@@ -160,6 +171,7 @@ type AccountResponse = {
     plan: string;
     status: string;
     createdAt: string;
+    limits: AccountLimits;
 };
 type ListDropsParams = {
     cursor?: string | null;
@@ -177,7 +189,8 @@ type CreateUploadSessionRequest = {
     entry?: string | null;
 };
 type UploadTarget = {
-    strategy: "single_put" | "multipart";
+    /** Always `single_put` — one signed PUT per file is the upload contract. */
+    strategy: "single_put";
     url: string;
     headers: Record<string, string>;
     expiresAt: string;
@@ -210,14 +223,6 @@ type CreateUploadSessionResponse = {
     files: CreateUploadSessionFileResponse[];
     nextAction?: Action | null;
 };
-type CompleteUploadSessionRequest = {
-    files?: Record<string, {
-        parts?: Array<{
-            partNumber: number;
-            etag: string;
-        }> | null;
-    }>;
-};
 type DropOptions = {
     /** Drop title. */
     title?: string;
@@ -233,6 +238,20 @@ type DropOptions = {
     entry?: string;
     /** Attach JSON key-value pairs, e.g. `{ source: "ci" }`. */
     metadata?: Record<string, unknown>;
+    /**
+     * Hostname of a custom domain connected to this account (must be live — see
+     * `client.domains`). Path-mode domains serve the drop at `https://{domain}/{slug}/`;
+     * dedicated domains serve it at the root and conflict (409) once occupied. Omit to
+     * use the account's default path domain if one exists, else the shared pool.
+     */
+    domain?: string | null;
+    /**
+     * Vanity slug — only valid when the target is a path-mode custom domain. 1–63
+     * lowercase letters/digits/hyphens (no leading/trailing/double hyphen). Taken slugs
+     * are auto-suffixed; omit for a random slug. Setting this on the shared pool returns
+     * 422.
+     */
+    slug?: string | null;
 };
 type PrepareOptions = {
     /** Glob patterns to ignore when publishing directories. */
@@ -281,6 +300,119 @@ type PublishInput = string | string[] | URL | Uint8Array | {
     files: PublishFileInput[];
     entry?: string;
 };
+/** Structured next-step hint returned by domain operations (and publish). */
+type NextHint = {
+    action: string;
+    message: string;
+};
+/** One DNS record instruction or diagnostic for a custom domain. */
+type DnsRecord = {
+    /** Purpose of the record, e.g. "routing". */
+    purpose: string;
+    /** DNS record type, e.g. "CNAME". */
+    type: string;
+    /** The DNS name to create the record for. */
+    name: string;
+    /** The value the record must point at. */
+    value: string;
+    /** Current DNS status: "missing" | "ok" | "mismatch". */
+    status: "missing" | "ok" | "mismatch";
+    /** What DoH currently resolves for this record (verify only). */
+    observed?: string | null;
+    /** Specific guidance for fixing this record. */
+    hint?: string | null;
+    /** Seconds to wait before retrying verify while DNS/cert propagates. */
+    retryAfter?: number | null;
+};
+/** Full domain resource representation. */
+type DomainResponse = {
+    object: "domain";
+    /** Stable domain identifier. */
+    id: string;
+    /** Canonical hostname registered with dropthis. */
+    hostname: string;
+    /** Mount mode: "path" (many drops at hostname/{slug}/) or "dedicated" (one drop at hostname/). */
+    mode: "path" | "dedicated";
+    /** Lifecycle status: "pending_dns" | "verifying" | "live" | "failed". */
+    status: "pending_dns" | "verifying" | "live" | "failed";
+    /** Reason for failure status. */
+    failureReason?: string | null;
+    /** Whether this is the account's default publish domain. */
+    default: boolean;
+    /** Mounted drop id (dedicated mode only). */
+    dropId?: string | null;
+    /** DNS records required for this domain. */
+    dns: DnsRecord[];
+    /** Creation timestamp. */
+    createdAt: string;
+    /** When the domain first reached "live" status. */
+    verifiedAt?: string | null;
+    /** Structured next-step hints for the agent. */
+    next: NextHint[];
+};
+/** List of domains for the account. */
+type DomainListResponse = {
+    object: "domain.list";
+    /** Domains connected to this account. */
+    domains: DomainResponse[];
+};
+/** Response body for a successful domain deletion. */
+type DomainDeletedResponse = {
+    object: "domain.deleted";
+    /** Id of the deleted domain. */
+    id: string;
+    /** Hostname of the deleted domain. */
+    hostname: string;
+    /** Dangling-CNAME risk warning (always present; instructs you to remove the DNS record). */
+    warning: string;
+};
+/** One readable file in a deployment's content manifest. */
+type DeploymentContentFile = {
+    /** File path within the deployment, relative to its root. */
+    path: string;
+    /** Stored MIME type the file is served with. */
+    contentType: string;
+    /** Stored file size in bytes. */
+    sizeBytes: number;
+};
+/**
+ * Manifest of one deployment's readable files (content read-back).
+ * Fetch a single file's bytes with `drops.getContent(dropId, { path })`.
+ */
+type DeploymentContentManifest = {
+    /** Parent drop identifier. */
+    dropId: string;
+    /** Deployment identifier. */
+    deploymentId: string;
+    /** Content revision of this deployment. */
+    revision: number;
+    /** Deployment lifecycle status. */
+    status: string;
+    /** Total deployment size in bytes. */
+    sizeBytes: number;
+    /** Entry path served at the drop root. */
+    entry?: string | null;
+    /** Readable files in this deployment; pass files[].path as `path` to download one. */
+    files: DeploymentContentFile[];
+};
+/** Options for `drops.getContent()`. */
+type GetContentOptions = {
+    /** Read a historical deployment instead of the current one. */
+    deploymentId?: string;
+    /** Download this single file's raw stored bytes instead of the JSON manifest. */
+    path?: string;
+};
+/** A single file downloaded via `drops.getContent(dropId, { path })`. */
+type DropContentFile = {
+    /** The requested file path. */
+    path: string;
+    /** Stored MIME type the file is served with (from the response Content-Type). */
+    contentType: string | null;
+    /** Exact stored bytes. */
+    bytes: Uint8Array;
+    /** Decode the bytes as UTF-8 text. */
+    text(): string;
+};
 
 declare class Transport {
     readonly apiKey: string | undefined;
@@ -292,6 +424,17 @@ declare class Transport {
     putSignedUrl(url: string, body: Uint8Array | Blob | ReadableStream, headers: Record<string, string>): Promise<DropthisResult<{
         etag: string | null;
     }>>;
+    /**
+     * Authenticated GET that returns the raw response bytes untouched (no JSON parsing,
+     * no case conversion). Error responses are still parsed as problem+json. Used for
+     * content read-back (`drops.getContent` with a file path).
+     */
+    requestBytes(path: string, options?: RequestOptions & {
+        params?: Record<string, string | number | boolean | null | undefined>;
+    }): Promise<DropthisResult<{
+        bytes: Uint8Array;
+        contentType: string | null;
+    }>>;
     request<T>(method: string, path: string, options?: RequestOptions & {
         body?: unknown;
         bodyCase?: "snake" | "raw";
@@ -372,9 +515,8 @@ declare class ApiKeysResource {
     create(input: {
         label: string;
     }): Promise<DropthisResult<ApiKeyCreatedResponse>>;
-    delete(keyId: string): Promise<DropthisResult<{
-        ok: true;
-    }>>;
+    /** Revoke an API key. 204 No Content — data is null on success. */
+    delete(keyId: string): Promise<DropthisResult<null>>;
 }
 
 declare class DeploymentsResource {
@@ -384,6 +526,45 @@ declare class DeploymentsResource {
     get(dropId: string, deploymentId: string): Promise<DropthisResult<DropDeploymentResponse>>;
 }
 
+declare class DomainsResource {
+    private readonly transport;
+    constructor(transport: Transport);
+    /**
+     * Connect a custom domain to the account. Returns the domain in `pending_dns` status with
+     * DNS instructions. Idempotent on (account, hostname) — re-connecting an already-connected
+     * domain returns the existing row. POST /domains.
+     */
+    connect(input: {
+        hostname: string;
+        mode: "path" | "dedicated";
+    }): Promise<DropthisResult<DomainResponse>>;
+    /** List all custom domains connected to this account. GET /domains. */
+    list(): Promise<DropthisResult<DomainListResponse>>;
+    /** Get a domain by its stable id or hostname. GET /domains/{id_or_hostname}. */
+    get(idOrHostname: string): Promise<DropthisResult<DomainResponse>>;
+    /**
+     * Trigger a DNS + Cloudflare verification check. Returns the domain with updated status and
+     * per-record diagnostics. If DNS is still propagating, `dns[].retryAfter` tells you when to
+     * re-call. POST /domains/{id_or_hostname}/verify.
+     */
+    verify(idOrHostname: string): Promise<DropthisResult<DomainResponse>>;
+    /**
+     * Update a domain's `dropId` (dedicated mode: repoint to a different drop) or `default`
+     * flag (path mode only: set/clear the account's default publish domain). Mode is immutable
+     * — delete and reconnect to change it. PATCH /domains/{id_or_hostname}.
+     */
+    update(idOrHostname: string, input: {
+        dropId?: string | null;
+        default?: boolean | null;
+    }): Promise<DropthisResult<DomainResponse>>;
+    /**
+     * Delete a custom domain and remove all its routes. The response includes a dangling-CNAME
+     * warning — remove the DNS record after deleting so another account cannot re-claim the
+     * hostname. DELETE /domains/{id_or_hostname}.
+     */
+    delete(idOrHostname: string): Promise<DropthisResult<DomainDeletedResponse>>;
+}
+
 declare class CursorPage<T> implements ListPage<T> {
     readonly object: "list";
     readonly data: T[];
@@ -410,8 +591,15 @@ declare class CursorPage<T> implements ListPage<T> {
  */
 declare class DropsResource<TInput = PublishInput> {
     private readonly transport;
-    private readonly resolve;
-    constructor(transport: Transport, resolve: PublishInputResolver<TInput>);
+    private readonly resolveInput;
+    private parentHosts?;
+    constructor(transport: Transport, resolveInput: PublishInputResolver<TInput>);
+    /**
+     * Hostnames the SDK can attribute to dropthis for slug parsing: the canonical
+     * viewer domain plus the configured baseUrl's host (covers staging/self-hosted
+     * setups where drops are served under the API's own domain).
+     */
+    private allowedParentHosts;
     /**
      * Publish content to a NEW permanent public URL; returns the created drop (with its `drop_…` id).
      * Use to publish / share / post / put online / make public a report, dashboard, site, or file.
@@ -432,14 +620,44 @@ declare class DropsResource<TInput = PublishInput> {
     list(params?: ListDropsParams): Promise<DropthisResult<CursorPage<DropResponse>>>;
     /** Fetch one drop by its `drop_…` id (not the slug/URL). GET /drops/{id}. */
     get(dropId: string): Promise<DropthisResult<DropResponse>>;
+    /**
+     * Resolve a drop URL (or bare slug) back to the drop — the way to recover a lost
+     * `drop_…` id. The slug is parsed client-side from the first hostname label of a
+     * dropthis-attributable hostname (`https://<slug>.dropthis.app/…`, or `<slug>.` +
+     * the configured baseUrl's host), then matched owner-scoped via GET /drops?slug=.
+     * Returns the drop, or `data: null` when no drop of yours has that slug.
+     * Custom-domain URLs are rejected client-side with `invalid_drop_url` — they are
+     * not resolvable yet.
+     */
+    resolve(urlOrSlug: string): Promise<DropthisResult<DropResponse | null>>;
+    /**
+     * Read back what a drop is serving (owner-only; works regardless of any viewer
+     * password). By default returns the JSON manifest of the CURRENT deployment's files;
+     * pass `deploymentId` to read a historical (even superseded) deployment — downloading
+     * an old version's files and republishing them via {@link updateContent} is the
+     * rollback path. Pass `path` (one of the manifest's `files[].path` values) to download
+     * that file's exact stored bytes instead. GET /drops/{id}/content.
+     */
+    getContent(dropId: string, options: GetContentOptions & {
+        path: string;
+    }): Promise<DropthisResult<DropContentFile>>;
+    getContent(dropId: string, options?: Omit<GetContentOptions, "path">): Promise<DropthisResult<DeploymentContentManifest>>;
     /**
      * Change an EXISTING drop's settings — title, visibility, password, noindex, expiry,
-     * metadata — by its `drop_…` id. Does not touch content; replace that with {@link updateContent}.
-     * Idempotent. PATCH /drops/{id}.
+     * metadata, domain, or slug — by its `drop_…` id. Does not touch content; replace that
+     * with {@link updateContent}. Idempotent. PATCH /drops/{id}.
+     *
+     * **`domain`** — move the drop to a different custom domain (must be live). Pass `null` to
+     * move the drop back to the shared pool (unmount from its current domain).
+     *
+     * **`slug`** — rename the vanity slug on a path-mode custom domain. Only valid when the drop
+     * lives on a path-mode domain. Unlike {@link publish} (which auto-suffixes taken slugs),
+     * `updateSettings` returns 409 on a slug conflict and never auto-suffixes — your code must
+     * catch 409 and retry with a different slug. Passing `slug` on the shared pool returns 422.
      */
     updateSettings(dropId: string, options?: DropOptions & RequestControls): Promise<DropthisResult<DropResponse>>;
     /** Permanently delete a drop and its public URL by its `drop_…` id. DELETE /drops/{id}. */
     delete(dropId: string): Promise<DropthisResult<null>>;
 }
 
-export { AccountResource as A, type UploadTarget as B, type CompleteUploadSessionRequest as C, DeploymentsResource as D, type EmailOtpResponse as E, type InMemoryPublishInput as I, type Limitations as L, type PrepareOptions as P, type RequestControls as R, type SessionResponse as S, type TierInfo as T, type UpdateContentOptions as U, type ActionResolve as a, ApiKeysResource as b, type CreateUploadSessionRequest as c, type CreateUploadSessionResponse as d, CursorPage as e, type DropAction as f, type DropDeploymentResponse as g, type DropOptions as h, type DropResponse as i, DropsResource as j, type DropthisClientOptions as k, type DropthisErrorResponse as l, type DropthisResult as m, type ListDeploymentsParams as n, type ListDeploymentsResponse as o, type ListPage as p, type PreparedPublishRequest as q, type PreparedUploadFile as r, type PublishFileInput as s, type PublishInput as t, type PublishOptions as u, type RequestOptions as v, Transport as w, type UploadManifestFile as x, type UploadSessionFileResponse as y, type UploadSessionResponse as z };
+export { type AccountLimits as A, type PreparedUploadFile as B, type CreateUploadSessionRequest as C, type DeploymentContentFile as D, type EmailOtpResponse as E, type PublishFileInput as F, type GetContentOptions as G, type PublishInput as H, type InMemoryPublishInput as I, type PublishOptions as J, type RequestOptions as K, type Limitations as L, Transport as M, type NextHint as N, type UploadManifestFile as O, type PrepareOptions as P, type UploadSessionFileResponse as Q, type RequestControls as R, type SessionResponse as S, type TierInfo as T, type UpdateContentOptions as U, type UploadSessionResponse as V, type UploadTarget as W, AccountResource as a, type AccountResponse as b, type ActionResolve as c, ApiKeysResource as d, type CreateUploadSessionResponse as e, CursorPage as f, type DeploymentContentManifest as g, DeploymentsResource as h, type DnsRecord as i, type DomainDeletedResponse as j, type DomainListResponse as k, type DomainResponse as l, DomainsResource as m, type DropAction as n, type DropContentFile as o, type DropDeploymentResponse as p, type DropOptions as q, type DropResponse as r, DropsResource as s, type DropthisClientOptions as t, type DropthisErrorResponse as u, type DropthisResult as v, type ListDeploymentsParams as w, type ListDeploymentsResponse as x, type ListPage as y, type PreparedPublishRequest as z };