@punica/editor 1.6.19 → 1.6.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punica/editor",
-  "version": "1.6.19",
+  "version": "1.6.20",
   "description": "Punica Editor",
   "private": false,
   "type": "module",

package/types/punica.module.runtime.host.d.ts

@@ -159,6 +159,44 @@ declare module 'punica' {
         status: number;
         /** Parsed JSON body (or null when the body was empty/non-JSON). */
         json: unknown;
+        /** Lower-cased response headers (e.g. `retry-after`). */
+        headers?: Record<string, string>;
+        /** Raw body text — the only way to see a non-JSON error page. */
+        text?: string;
+      }
+
+      /** A streamed file download executed in the host (main) process. */
+      export interface HostHttpDownloadRequest {
+        /** Absolute source URL. */
+        url: string;
+        /** Absolute destination path; parent directories are created. */
+        dest: string;
+        /** Extra request headers (e.g. an Authorization bearer). */
+        headers?: Record<string, string>;
+        /** Correlation id echoed back on progress events. */
+        id?: string;
+        /** Idle timeout in ms (default host-defined). */
+        timeoutMs?: number;
+      }
+
+      /** Result of a `download` call. Non-2xx leaves no file on disk. */
+      export interface HostHttpDownloadResult {
+        /** Final HTTP status code (after redirects). */
+        status: number;
+        /** Destination path, when the download completed. */
+        filePath?: string;
+        /** Bytes written. */
+        bytes: number;
+        /** Error body text captured for a non-2xx response. */
+        error?: string;
+      }
+
+      /** Progress tick for an in-flight `download`. */
+      export interface HostHttpDownloadProgress {
+        id: string;
+        received: number;
+        /** Total bytes from `Content-Length`, or 0 when the server omits it. */
+        total: number;
       }
 
       /**
@@ -173,6 +211,22 @@ declare module 'punica' {
        */
       export interface HostHttpApi {
         requestJson(req: HostHttpJsonRequest): Promise<HostHttpJsonResponse>;
+        /**
+         * Stream a URL to a file in the host process. Optional: a host without
+         * filesystem-backed downloads omits it, and callers must feature-detect.
+         * Unlike a `curl` shell-out this reports the real HTTP status (so a
+         * gated 403 is distinguishable from a rate-limited 429) and keeps
+         * credentials out of any process argument list. Redirects are followed;
+         * an `Authorization` header is dropped when the redirect target changes
+         * origin, since the redirect URL is typically already pre-signed.
+         */
+        download?(
+          req: HostHttpDownloadRequest
+        ): Promise<HostHttpDownloadResult>;
+        /** Subscribe to progress ticks for `download`. Returns an unsubscribe. */
+        onDownloadProgress?(
+          listener: (progress: HostHttpDownloadProgress) => void
+        ): () => void;
       }
 
       /** Options for starting the inbound MCP server listener. */