@dropthis/cli 0.8.0 → 0.9.0

package/node_modules/@dropthis/node/README.md

@@ -14,7 +14,7 @@ npm install @dropthis/node
 import { Dropthis } from "@dropthis/node";
 
 const dropthis = new Dropthis({ apiKey: "sk_..." });
-const { data, error } = await dropthis.publish("<h1>Hello</h1>");
+const { data, error } = await dropthis.drops.publish("<h1>Hello</h1>");
 
 console.log(data.url); // https://abc123.dropthis.app
 ```
@@ -24,25 +24,25 @@ console.log(data.url); // https://abc123.dropthis.app
 ### Publish an HTML string
 
 ```typescript
-const { data } = await dropthis.publish("<h1>Launch page</h1>");
+const { data } = await dropthis.drops.publish("<h1>Launch page</h1>");
 ```
 
 ### Publish a file
 
 ```typescript
-const { data } = await dropthis.publish("./report.html");
+const { data } = await dropthis.drops.publish("./report.html");
 ```
 
 ### Publish a directory
 
 ```typescript
-const { data } = await dropthis.publish("./dist");
+const { data } = await dropthis.drops.publish("./dist");
 ```
 
 ### Publish with options
 
 ```typescript
-const { data } = await dropthis.publish("./dist", {
+const { data } = await dropthis.drops.publish("./dist", {
   title: "Q4 Report",
   visibility: "unlisted",
   password: "s3cret",
@@ -50,25 +50,25 @@ const { data } = await dropthis.publish("./dist", {
 });
 ```
 
-### Deploy new content to an existing drop
+### Update the content of an existing drop
 
 ```typescript
-const created = await dropthis.publish("./dist", { title: "v1" });
+const created = await dropthis.drops.publish("./dist", { title: "v1" });
 
-const updated = await dropthis.deploy(created.data.id, "./dist-v2", {
+const updated = await dropthis.drops.updateContent(created.data.id, "./dist-v2", {
   ifRevision: created.data.revision,
 });
 ```
 
-### Update metadata only
+### Update settings only
 
 ```typescript
-await dropthis.update("drop_abc123", { title: "New title" });
+await dropthis.drops.updateSettings("drop_abc123", { title: "New title" });
 ```
 
 ## Supported inputs
 
-The `publish()` and `deploy()` methods accept:
+The `drops.publish()` and `drops.updateContent()` methods accept:
 
 - **HTML/text string** -- `"<h1>Hello</h1>"` (auto-detected as inline content)
 - **File path** -- `"./report.html"` (local file)
@@ -88,20 +88,20 @@ All inputs are uploaded through staged presigned URLs. The SDK handles this tran
 
 ```typescript
 // Inline content with explicit MIME type
-await dropthis.publish({
+await dropthis.drops.publish({
   kind: "content",
   content: "<h1>Hello</h1>",
   contentType: "text/html",
 });
 
 // Fetch and re-publish a remote URL
-await dropthis.publish({
+await dropthis.drops.publish({
   kind: "source_url",
   sourceUrl: "https://example.com/report",
 });
 
 // Multi-file bundle with explicit entry point
-await dropthis.publish(
+await dropthis.drops.publish(
   {
     kind: "files",
     files: [
@@ -174,7 +174,7 @@ const dropthis = new Dropthis("sk_...");
 ```typescript
 await dropthis.drops.list({ limit: 20 });
 await dropthis.drops.get("drop_abc123");
-await dropthis.drops.update("drop_abc123", { title: "Updated" });
+await dropthis.drops.updateSettings("drop_abc123", { title: "Updated" });
 await dropthis.drops.delete("drop_abc123");
 ```
 
@@ -190,7 +190,7 @@ for await (const drop of page.data) {
 }
 ```
 
-> To change a drop's content, use `client.deploy(dropId, newInput)`. `drops.update()` is for settings only (title, visibility, password, noindex, expiresAt, slug, metadata).
+> To change a drop's content, use `client.drops.updateContent(dropId, newInput)`. `drops.updateSettings()` is for settings only (title, visibility, password, noindex, expiresAt, slug, metadata).
 
 ### deployments
 
@@ -245,12 +245,12 @@ Use the fs-free entry point for Cloudflare Workers and other edge runtimes. It d
 import { DropthisEdge } from "@dropthis/node/edge";
 
 const dropthis = new DropthisEdge({ apiKey: env.DROPTHIS_API_KEY });
-const { data, error } = await dropthis.publish("<h1>Hello from the edge</h1>");
+const { data, error } = await dropthis.drops.publish("<h1>Hello from the edge</h1>");
 ```
 
 `DropthisEdge` accepts the in-memory subset of `PublishInput`: inline strings, `Uint8Array`, `URL`, and the explicit `{ kind: "content" }`, `{ kind: "source_url" }`, and `{ kind: "files" }` forms. Local file paths and `string[]` path arrays are not supported (no filesystem on the edge).
 
-`DropthisEdge` exposes the same `publish(input, options?)` and `deploy(dropId, input, options?)` methods, plus the `drops`, `deployments`, `account`, and `apiKeys` resource accessors.
+`DropthisEdge` exposes the drop lifecycle through `drops.publish(input, options?)`, `drops.updateContent(dropId, input, options?)`, `drops.updateSettings`, `drops.get`, `drops.list`, and `drops.delete`, plus the `deployments`, `account`, and `apiKeys` resource accessors — the same surface as the Node client.
 
 ## Types
 

package/node_modules/@dropthis/node/dist/{drops-CWGyF-x1.d.cts → drops-C8-OQkbF.d.cts}

@@ -254,11 +254,12 @@ type RequestControls = {
 };
 type PublishOptions = DropOptions & PrepareOptions & RequestControls;
 /**
- * Options for `deploy()` — content-only. A deployment ships a new content version and never
- * changes drop settings (title, visibility, password, noindex, expiry, metadata); those belong
- * on `update()`. Carries only content-prep + request controls + the bundle `entry`.
+ * Options for `drops.updateContent()` — content-only. A content update ships a new content version
+ * and never changes drop settings (title, visibility, password, noindex, expiry, metadata); those
+ * belong on `drops.updateSettings()`. Carries only content-prep + request controls + the bundle
+ * `entry`.
  */
-type DeployOptions = PrepareOptions & RequestControls & {
+type UpdateContentOptions = PrepareOptions & RequestControls & {
     /** Entry file for multi-file bundles (default: index.html). */
     entry?: string;
 };
@@ -313,6 +314,15 @@ type PreparedUploadFile = {
     checksumSha256?: string;
     getBody(): Promise<Uint8Array | Blob | ReadableStream>;
 };
+/**
+ * Resolves a publish input into a {@link PreparedPublishRequest}. Two implementations exist:
+ * the fs-free {@link resolveInMemory} (Workers-safe) and the fs-capable `resolveInput` in
+ * `publish/node.ts`. `DropsResource` takes one by injection so it can power both the Node client
+ * and the edge client WITHOUT statically importing the Node-only pipeline (which would poison the
+ * Workers bundle with `node:fs`/`fast-glob`). `TInput` is the input type the chosen resolver
+ * accepts ({@link InMemoryPublishInput} on the edge, the full `PublishInput` on Node).
+ */
+type PublishInputResolver<TInput> = (input: TInput, options: PublishOptions) => Promise<PreparedPublishRequest>;
 type PreparedPublishRequest = {
     kind: "staged";
     manifest: CreateUploadSessionRequest;
@@ -394,13 +404,29 @@ declare class CursorPage<T> implements ListPage<T> {
     [Symbol.asyncIterator](): AsyncIterableIterator<T>;
 }
 
-declare class DropsResource {
+/**
+ * The drop lifecycle resource. `TInput` is the publish-input type the injected resolver accepts:
+ * the full `PublishInput` on the Node client, the fs-free `InMemoryPublishInput` on the edge. The
+ * resolver is injected (not statically imported) so this module never pulls in the Node-only
+ * publish pipeline and stays Workers-safe.
+ */
+declare class DropsResource<TInput = PublishInput> {
     private readonly transport;
-    constructor(transport: Transport);
+    private readonly resolve;
+    constructor(transport: Transport, resolve: PublishInputResolver<TInput>);
+    /** Publish a NEW drop. Returns the created drop. Hits POST /drops. */
+    publish(input: TInput, options?: PublishOptions): Promise<DropthisResult<DropResponse>>;
+    /**
+     * Publish a NEW content version to an existing drop, keeping its URL.
+     * Content-only: drop settings/metadata are stripped BEFORE prepare so they are never
+     * validated, sent, or applied. Settings are owned by updateSettings(). Hits
+     * POST /drops/{id}/deployments.
+     */
+    updateContent(dropId: string, input: TInput, options?: UpdateContentOptions): Promise<DropthisResult<DropResponse>>;
     list(params?: ListDropsParams): Promise<DropthisResult<CursorPage<DropResponse>>>;
     get(dropId: string): Promise<DropthisResult<DropResponse>>;
-    update(dropId: string, options?: DropOptions & RequestControls): Promise<DropthisResult<DropResponse>>;
+    updateSettings(dropId: string, options?: DropOptions & RequestControls): Promise<DropthisResult<DropResponse>>;
     delete(dropId: string): Promise<DropthisResult<null>>;
 }
 
-export { AccountResource as A, type UploadTarget as B, type CompleteUploadSessionRequest as C, type DeployOptions 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 UploadManifestFile as U, type ActionResolve as a, ApiKeysResource as b, type CreateUploadSessionRequest as c, type CreateUploadSessionResponse as d, CursorPage as e, DeploymentsResource as f, type DropAction as g, type DropDeploymentResponse as h, type DropOptions as i, type DropResponse as j, DropsResource as k, type DropthisClientOptions as l, type DropthisErrorResponse as m, type DropthisResult as n, type ListDeploymentsParams as o, type ListDeploymentsResponse as p, type ListPage as q, type PreparedPublishRequest as r, type PreparedUploadFile as s, type PublishFileInput as t, type PublishInput as u, type PublishOptions as v, type RequestOptions as w, Transport as x, type UploadSessionFileResponse as y, type UploadSessionResponse as z };
+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 };

package/node_modules/@dropthis/node/dist/{drops-CWGyF-x1.d.ts → drops-C8-OQkbF.d.ts}

@@ -254,11 +254,12 @@ type RequestControls = {
 };
 type PublishOptions = DropOptions & PrepareOptions & RequestControls;
 /**
- * Options for `deploy()` — content-only. A deployment ships a new content version and never
- * changes drop settings (title, visibility, password, noindex, expiry, metadata); those belong
- * on `update()`. Carries only content-prep + request controls + the bundle `entry`.
+ * Options for `drops.updateContent()` — content-only. A content update ships a new content version
+ * and never changes drop settings (title, visibility, password, noindex, expiry, metadata); those
+ * belong on `drops.updateSettings()`. Carries only content-prep + request controls + the bundle
+ * `entry`.
  */
-type DeployOptions = PrepareOptions & RequestControls & {
+type UpdateContentOptions = PrepareOptions & RequestControls & {
     /** Entry file for multi-file bundles (default: index.html). */
     entry?: string;
 };
@@ -313,6 +314,15 @@ type PreparedUploadFile = {
     checksumSha256?: string;
     getBody(): Promise<Uint8Array | Blob | ReadableStream>;
 };
+/**
+ * Resolves a publish input into a {@link PreparedPublishRequest}. Two implementations exist:
+ * the fs-free {@link resolveInMemory} (Workers-safe) and the fs-capable `resolveInput` in
+ * `publish/node.ts`. `DropsResource` takes one by injection so it can power both the Node client
+ * and the edge client WITHOUT statically importing the Node-only pipeline (which would poison the
+ * Workers bundle with `node:fs`/`fast-glob`). `TInput` is the input type the chosen resolver
+ * accepts ({@link InMemoryPublishInput} on the edge, the full `PublishInput` on Node).
+ */
+type PublishInputResolver<TInput> = (input: TInput, options: PublishOptions) => Promise<PreparedPublishRequest>;
 type PreparedPublishRequest = {
     kind: "staged";
     manifest: CreateUploadSessionRequest;
@@ -394,13 +404,29 @@ declare class CursorPage<T> implements ListPage<T> {
     [Symbol.asyncIterator](): AsyncIterableIterator<T>;
 }
 
-declare class DropsResource {
+/**
+ * The drop lifecycle resource. `TInput` is the publish-input type the injected resolver accepts:
+ * the full `PublishInput` on the Node client, the fs-free `InMemoryPublishInput` on the edge. The
+ * resolver is injected (not statically imported) so this module never pulls in the Node-only
+ * publish pipeline and stays Workers-safe.
+ */
+declare class DropsResource<TInput = PublishInput> {
     private readonly transport;
-    constructor(transport: Transport);
+    private readonly resolve;
+    constructor(transport: Transport, resolve: PublishInputResolver<TInput>);
+    /** Publish a NEW drop. Returns the created drop. Hits POST /drops. */
+    publish(input: TInput, options?: PublishOptions): Promise<DropthisResult<DropResponse>>;
+    /**
+     * Publish a NEW content version to an existing drop, keeping its URL.
+     * Content-only: drop settings/metadata are stripped BEFORE prepare so they are never
+     * validated, sent, or applied. Settings are owned by updateSettings(). Hits
+     * POST /drops/{id}/deployments.
+     */
+    updateContent(dropId: string, input: TInput, options?: UpdateContentOptions): Promise<DropthisResult<DropResponse>>;
     list(params?: ListDropsParams): Promise<DropthisResult<CursorPage<DropResponse>>>;
     get(dropId: string): Promise<DropthisResult<DropResponse>>;
-    update(dropId: string, options?: DropOptions & RequestControls): Promise<DropthisResult<DropResponse>>;
+    updateSettings(dropId: string, options?: DropOptions & RequestControls): Promise<DropthisResult<DropResponse>>;
     delete(dropId: string): Promise<DropthisResult<null>>;
 }
 
-export { AccountResource as A, type UploadTarget as B, type CompleteUploadSessionRequest as C, type DeployOptions 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 UploadManifestFile as U, type ActionResolve as a, ApiKeysResource as b, type CreateUploadSessionRequest as c, type CreateUploadSessionResponse as d, CursorPage as e, DeploymentsResource as f, type DropAction as g, type DropDeploymentResponse as h, type DropOptions as i, type DropResponse as j, DropsResource as k, type DropthisClientOptions as l, type DropthisErrorResponse as m, type DropthisResult as n, type ListDeploymentsParams as o, type ListDeploymentsResponse as p, type ListPage as q, type PreparedPublishRequest as r, type PreparedUploadFile as s, type PublishFileInput as t, type PublishInput as u, type PublishOptions as v, type RequestOptions as w, Transport as x, type UploadSessionFileResponse as y, type UploadSessionResponse as z };
+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 };

package/node_modules/@dropthis/node/dist/edge.cjs

@@ -207,7 +207,7 @@ function optionsBody(options) {
   }
   return body;
 }
-function deployOptions(options) {
+function updateContentOptions(options) {
   const out = {};
   if (options.entry !== void 0) out.entry = options.entry;
   if (options.contentType !== void 0) out.contentType = options.contentType;
@@ -498,10 +498,39 @@ var CursorPage = class {
 
 // src/resources/drops.ts
 var DropsResource = class {
-  constructor(transport) {
+  constructor(transport, resolve) {
     this.transport = transport;
+    this.resolve = resolve;
   }
   transport;
+  resolve;
+  /** Publish a NEW drop. Returns the created drop. Hits POST /drops. */
+  async publish(input, options = {}) {
+    let prepared;
+    try {
+      prepared = await this.resolve(input, options);
+    } catch (e) {
+      return toErrorResult(e);
+    }
+    return prepared.kind === "source" ? publishSource(this.transport, prepared, "/drops", options) : publishStaged(this.transport, prepared, "/drops", options);
+  }
+  /**
+   * Publish a NEW content version to an existing drop, keeping its URL.
+   * Content-only: drop settings/metadata are stripped BEFORE prepare so they are never
+   * validated, sent, or applied. Settings are owned by updateSettings(). Hits
+   * POST /drops/{id}/deployments.
+   */
+  async updateContent(dropId, input, options = {}) {
+    const opts = updateContentOptions(options);
+    let prepared;
+    try {
+      prepared = await this.resolve(input, opts);
+    } catch (e) {
+      return toErrorResult(e);
+    }
+    const path = `/drops/${encodeURIComponent(dropId)}/deployments`;
+    return prepared.kind === "source" ? publishSource(this.transport, prepared, path, opts) : publishStaged(this.transport, prepared, path, opts);
+  }
   async list(params = {}) {
     const result = await this.transport.request("GET", "/drops", {
       params
@@ -521,7 +550,7 @@ var DropsResource = class {
       `/drops/${encodeURIComponent(dropId)}`
     );
   }
-  update(dropId, options = {}) {
+  updateSettings(dropId, options = {}) {
     const requestOptions = {
       body: updateBody(options)
     };
@@ -778,7 +807,7 @@ var DropthisEdge = class {
   }
   get drops() {
     if (!this.dropsResource)
-      this.dropsResource = new DropsResource(this.transport);
+      this.dropsResource = new DropsResource(this.transport, resolveInMemory);
     return this.dropsResource;
   }
   get account() {
@@ -796,28 +825,6 @@ var DropthisEdge = class {
       this.deploymentsResource = new DeploymentsResource(this.transport);
     return this.deploymentsResource;
   }
-  /** Publish a NEW drop from in-memory content. */
-  async publish(input, options = {}) {
-    let prepared;
-    try {
-      prepared = await resolveInMemory(input, options);
-    } catch (e) {
-      return toErrorResult(e);
-    }
-    return prepared.kind === "source" ? publishSource(this.transport, prepared, "/drops", options) : publishStaged(this.transport, prepared, "/drops", options);
-  }
-  /** Publish a NEW content version to an existing drop, keeping its URL. */
-  async deploy(dropId, input, options = {}) {
-    const opts = deployOptions(options);
-    let prepared;
-    try {
-      prepared = await resolveInMemory(input, opts);
-    } catch (e) {
-      return toErrorResult(e);
-    }
-    const path = `/drops/${encodeURIComponent(dropId)}/deployments`;
-    return prepared.kind === "source" ? publishSource(this.transport, prepared, path, opts) : publishStaged(this.transport, prepared, path, opts);
-  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {