@dropthis/cli 0.3.5 → 0.4.0

package/node_modules/@dropthis/node/dist/index.d.ts

@@ -19,6 +19,8 @@ type DropthisErrorResponse = {
     param?: string | null;
     currentRevision?: number;
     requestId?: string | null;
+    suggestion?: string | null;
+    retryable?: boolean | null;
 };
 type DropthisResult<T> = {
     data: T;
@@ -29,6 +31,28 @@ type DropthisResult<T> = {
     error: DropthisErrorResponse;
     headers: Record<string, string>;
 };
+type ActionResolve = {
+    method: string;
+    url?: string | null;
+    endpoint?: string | null;
+};
+type DropAction = {
+    code: string;
+    kind: "api" | "human";
+    priority: "required" | "suggested";
+    message: string;
+    resolve?: ActionResolve | null;
+};
+type TierInfo = {
+    name: string;
+    maxSizeBytes: number;
+    ttlDays: number | null;
+    persistent: boolean;
+    badge: boolean;
+};
+type Limitations = {
+    actions: DropAction[];
+};
 type DropResponse = {
     id: string;
     slug: string;
@@ -47,6 +71,12 @@ type DropResponse = {
     warnings: Array<Record<string, unknown>>;
     createdAt: string;
     expiresAt: string | null;
+    object: string;
+    accessible: boolean;
+    persistent: boolean;
+    badgeApplied: boolean;
+    tier: TierInfo;
+    limitations: Limitations;
 };
 type DropDeploymentResponse = {
     id: string;
@@ -86,9 +116,17 @@ type ListPage<T> = {
     }): Promise<T[]>;
     [Symbol.asyncIterator](): AsyncIterableIterator<T>;
 };
+type Action = {
+    code: string;
+    kind: string;
+    method?: string | null;
+    endpoint?: string | null;
+    message: string;
+};
 type EmailOtpResponse = {
     ok: true;
     expiresIn: number;
+    nextAction?: Action | null;
 };
 type SessionResponse = {
     object: "session";
@@ -160,11 +198,13 @@ type UploadSessionResponse = {
     expiresAt: string;
     entry?: string | null;
     files: UploadSessionFileResponse[];
+    nextAction?: Action | null;
 };
 type CreateUploadSessionResponse = {
     uploadId: string;
     expiresAt: string;
     files: CreateUploadSessionFileResponse[];
+    nextAction?: Action | null;
 };
 type CreateUploadPartTargetsRequest = {
     fileId: string;
@@ -189,39 +229,41 @@ type CompleteUploadSessionRequest = {
         }> | null;
     }>;
 };
-declare class CursorPage<T> implements ListPage<T> {
-    readonly object: "list";
-    readonly data: T[];
-    readonly hasMore: boolean;
-    readonly nextCursor: string | null;
-    private readonly fetchNextPage;
-    constructor(input: {
-        data: T[];
-        hasMore: boolean;
-        nextCursor: string | null;
-        fetchNextPage?: (() => Promise<DropthisResult<CursorPage<T>>>) | undefined;
-    });
-    autoPagingToArray(options?: {
-        limit?: number;
-    }): Promise<T[]>;
-    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
-}
-type PublishOptions = {
+type DropOptions = {
+    /** Change the vanity slug (update only). */
     slug?: string;
+    /** Drop title. */
     title?: string;
+    /** public (default) or unlisted. */
     visibility?: "public" | "unlisted";
+    /** Require password to view. Pass `null` to remove password protection. */
     password?: string | null;
+    /** Prevent search-engine indexing. Pass `null` to allow indexing (default). */
     noindex?: boolean | null;
+    /** Auto-delete after this ISO 8601 date. Pass `null` to clear. */
     expiresAt?: string | Date | null;
+    /** Entry file for multi-file bundles (default: index.html). */
     entry?: string;
+    /** Attach JSON key-value pairs, e.g. `{ source: "ci" }`. */
     metadata?: Record<string, unknown>;
-    idempotencyKey?: string;
-    ifRevision?: number;
+};
+type PrepareOptions = {
+    /** Glob patterns to ignore when publishing directories. */
     ignore?: string[];
+    /** Disable default ignore patterns. */
     ignoreDefaults?: boolean;
+    /** Override MIME type (auto-detected from extension). */
     contentType?: string;
+    /** Set filename when publishing from stdin or bytes. */
     path?: string;
 };
+type RequestControls = {
+    /** Prevent duplicate publishes on retry (auto-generated by CLI). */
+    idempotencyKey?: string;
+    /** Fail if current revision doesn't match -- optimistic lock (update only). */
+    ifRevision?: number;
+};
+type PublishOptions = DropOptions & PrepareOptions & RequestControls;
 type ExplicitPublishInput = {
     content: string;
     contentType?: string;
@@ -277,6 +319,7 @@ declare class Transport {
     }>>;
     request<T>(method: string, path: string, options?: RequestOptions & {
         body?: unknown;
+        bodyCase?: "snake" | "raw";
         params?: Record<string, string | number | boolean | null | undefined>;
     }): Promise<DropthisResult<T>>;
 }
@@ -336,6 +379,24 @@ declare class DeploymentsResource {
     get(dropId: string, deploymentId: string): Promise<DropthisResult<DropDeploymentResponse>>;
 }
 
+declare class CursorPage<T> implements ListPage<T> {
+    readonly object: "list";
+    readonly data: T[];
+    readonly hasMore: boolean;
+    readonly nextCursor: string | null;
+    private readonly fetchNextPage;
+    constructor(input: {
+        data: T[];
+        hasMore: boolean;
+        nextCursor: string | null;
+        fetchNextPage?: (() => Promise<DropthisResult<CursorPage<T>>>) | undefined;
+    });
+    autoPagingToArray(options?: {
+        limit?: number;
+    }): Promise<T[]>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+}
+
 declare class DropsResource {
     private readonly transport;
     constructor(transport: Transport);
@@ -347,10 +408,7 @@ declare class DropsResource {
     }): Promise<DropthisResult<DropResponse>>;
     list(params?: ListDropsParams): Promise<DropthisResult<CursorPage<DropResponse>>>;
     get(dropId: string): Promise<DropthisResult<DropResponse>>;
-    update(dropId: string, body: PublishOptions | Record<string, unknown>, options?: {
-        idempotencyKey?: string;
-        ifRevision?: number;
-    }): Promise<DropthisResult<DropResponse>>;
+    update(dropId: string, options?: DropOptions & RequestControls): Promise<DropthisResult<DropResponse>>;
     delete(dropId: string): Promise<DropthisResult<null>>;
 }
 
@@ -385,7 +443,8 @@ declare class Dropthis {
     get uploads(): UploadsResource;
     prepare(input: PublishInput, options?: PublishOptions): Promise<PreparedPublishRequest>;
     publish(input: PublishInput, options?: PublishOptions): Promise<DropthisResult<DropResponse>>;
-    update(dropId: string, inputOrOptions?: PublishInput | PublishOptions, options?: PublishOptions): Promise<DropthisResult<DropResponse>>;
+    deploy(dropId: string, input: PublishInput, options?: PublishOptions): Promise<DropthisResult<DropResponse>>;
+    update(dropId: string, options?: DropOptions & RequestControls): Promise<DropthisResult<DropResponse>>;
     request<T>(method: string, path: string, options?: RequestOptions & {
         body?: unknown;
         params?: Record<string, string | number | boolean | null | undefined>;
@@ -403,6 +462,8 @@ declare function createErrorResult<T>(code: string, message: string, statusCode:
     currentRevision?: number;
     requestId?: string | null;
     headers?: Record<string, string>;
+    suggestion?: string | null;
+    retryable?: boolean | null;
 }): DropthisResult<T>;
 
-export { type CompleteUploadSessionRequest, type CreateUploadPartTargetsRequest, type CreateUploadPartTargetsResponse, type CreateUploadSessionRequest, type CreateUploadSessionResponse, DeploymentsResource, type DropDeploymentResponse, type DropResponse, Dropthis, type DropthisClientOptions, type DropthisErrorResponse, type DropthisResult, type ListDeploymentsParams, type ListDeploymentsResponse, type ListPage, type PreparedPublishRequest, type PreparedUploadFile, type RequestOptions, type UploadManifestFile, type UploadPartTarget, type UploadSessionFileResponse, type UploadSessionResponse, type UploadTarget, UploadsResource, createErrorResult, redactSecrets };
+export { type ActionResolve, type CompleteUploadSessionRequest, type CreateUploadPartTargetsRequest, type CreateUploadPartTargetsResponse, type CreateUploadSessionRequest, type CreateUploadSessionResponse, CursorPage, DeploymentsResource, type DropAction, type DropDeploymentResponse, type DropOptions, type DropResponse, Dropthis, type DropthisClientOptions, type DropthisErrorResponse, type DropthisResult, type Limitations, type ListDeploymentsParams, type ListDeploymentsResponse, type ListPage, type PrepareOptions, type PreparedPublishRequest, type PreparedUploadFile, type PublishOptions, type RequestControls, type RequestOptions, type TierInfo, type UploadManifestFile, type UploadPartTarget, type UploadSessionFileResponse, type UploadSessionResponse, type UploadTarget, UploadsResource, createErrorResult, redactSecrets };