@homespunapps/core 1.6.89 → 1.6.90

package/dist/client.d.ts

@@ -287,6 +287,12 @@ export declare class HomespunClient {
      * PUT -> finalize flow, named to match the MCP `attachments` action.
      */
     finalizeBlob(attachmentId: string): Promise<AttachmentRef>;
+    /** POST /v1/deploy-documents — create a short-lived HTML document upload. */
+    createDocumentUpload(req: {
+        size: number;
+        sha256: string;
+        app_id?: string;
+    }): Promise<DocumentUploadSession>;
     /** POST /v1/apps — create (deploy) a new App + its first AppVersion. */
     deployApp(req: DeployAppRequest): Promise<DeployAppResponse>;
     /**
@@ -1017,9 +1023,20 @@ export interface AppAssetRef {
 }
 /** A multi-file-deploy asset: inline bytes OR a by-reference attachment id. */
 export type AppAsset = AppAssetInline | AppAssetRef;
+/** Short-lived capability for uploading an authored HTML document. */
+export interface DocumentUploadSession {
+    document_id: string;
+    upload_url: string;
+    /** Scoped only to PUT the declared document bytes to `upload_url`. */
+    upload_token: string;
+    expires_at: string;
+}
 /** Request body for `POST /v1/apps` — create (deploy) a new App. */
 export interface DeployAppRequest {
-    html: string;
+    /** Inline HTML, mutually exclusive with `document_id`. */
+    html?: string;
+    /** Reference to an uploaded HTML document, mutually exclusive with `html`. */
+    document_id?: string;
     manifest: unknown;
     /** Defaults to "private" server-side when omitted. */
     visibility?: "private" | "link" | "public";
@@ -1091,6 +1108,8 @@ export interface DeployAppResponse {
 export interface RedeployAppRequest {
     /** Omit to keep the live document (a manifest-only change needs no HTML). */
     html?: string;
+    /** Uploaded replacement document, mutually exclusive with `html`. */
+    document_id?: string;
     /** Omit to keep the live manifest (an HTML-only change needs no manifest). */
     manifest?: unknown;
     /** Bypass the compat gate; a removed collection is detached, not deleted. */
@@ -1178,6 +1197,8 @@ export interface DeployCheckRequest {
     app_id?: string;
     /** Required to check a create; omit on a redeploy check to inherit the live document. */
     html?: string;
+    /** Uploaded replacement document, mutually exclusive with `html`. */
+    document_id?: string;
     /** Required to check a create; omit on a redeploy check to inherit the live manifest. */
     manifest?: unknown;
     force?: boolean;

package/dist/client.js

@@ -531,10 +531,18 @@ export class HomespunClient {
     // App.id (cuid) — a slug is resolved to an id via `listApps({ slug })`
     // first (the CLI's `resolveAppId` helper does this transparently).
     // -------------------------------------------------------------------------
+    /** POST /v1/deploy-documents — create a short-lived HTML document upload. */
+    async createDocumentUpload(req) {
+        const r = await this.call("POST", "/v1/deploy-documents", req);
+        if (!r.ok)
+            this.fail(r);
+        return this.asObject(r);
+    }
     /** POST /v1/apps — create (deploy) a new App + its first AppVersion. */
     async deployApp(req) {
         const r = await this.call("POST", "/v1/apps", {
             html: req.html,
+            document_id: req.document_id,
             manifest: req.manifest,
             visibility: req.visibility,
             slug: req.slug,
@@ -554,6 +562,7 @@ export class HomespunClient {
     async redeployApp(appId, req) {
         const r = await this.call("POST", `/v1/apps/${encodeURIComponent(appId)}/versions`, {
             html: req.html,
+            document_id: req.document_id,
             manifest: req.manifest,
             force: req.force,
             assets: req.assets,
@@ -577,6 +586,7 @@ export class HomespunClient {
             : "/v1/apps";
         const body = {
             html: req.html,
+            document_id: req.document_id,
             manifest: req.manifest,
             dry_run: true,
         };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { HomespunClient, HomespunApiError, putPresigned } from "./client.js";
-export type { ClientOptions, RelayResponse, AttachmentRef, UploadBlobOptions, PresignBlobOptions, AttachmentTokenMintResponse, ListBlobsOptions, AttachmentTokenAuditEntry, AttachmentTokenListResponse, QueryResponse, AppAsset, DeployAppRequest, DeployAppResponse, RedeployAppRequest, RedeployAppResponse, DeployCheckRequest, DeployCheckResult, MissingConnection, KeyMintResult, AppSummary, AppDetail, AppsPage, AppDomain, AppDomainDnsRecord, AppMember, AddAppMemberResult, AppTransfer, AppRow, AppRowsPage, ListScalar, ListWhereCondition, ListSortSpec, BatchRowInput, BatchRowResult, BatchResult, BatchWriteOptions, AppFeedEntry, AppFeedPage, CommunitySetupStep, RetentionAxes, CollectionRetentionView, ServiceCredentialGrant, MintAppCredentialResult, AppCredentialSummary, RotateAppCredentialResult, ConnectionSummary, } from "./client.js";
+export type { ClientOptions, RelayResponse, AttachmentRef, UploadBlobOptions, PresignBlobOptions, AttachmentTokenMintResponse, ListBlobsOptions, AttachmentTokenAuditEntry, AttachmentTokenListResponse, QueryResponse, AppAsset, DeployAppRequest, DeployAppResponse, DocumentUploadSession, RedeployAppRequest, RedeployAppResponse, DeployCheckRequest, DeployCheckResult, MissingConnection, KeyMintResult, AppSummary, AppDetail, AppsPage, AppDomain, AppDomainDnsRecord, AppMember, AddAppMemberResult, AppTransfer, AppRow, AppRowsPage, ListScalar, ListWhereCondition, ListSortSpec, BatchRowInput, BatchRowResult, BatchResult, BatchWriteOptions, AppFeedEntry, AppFeedPage, CommunitySetupStep, RetentionAxes, CollectionRetentionView, ServiceCredentialGrant, MintAppCredentialResult, AppCredentialSummary, RotateAppCredentialResult, ConnectionSummary, } from "./client.js";
 export { openStream } from "./stream.js";
 export type { OpenStreamOptions, StreamHandlers, StreamHandle, } from "./stream.js";
 export { openAppStream, appWsUrlFromAppUrl } from "./app-stream.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homespunapps/core",
-  "version": "1.6.89",
+  "version": "1.6.90",
   "description": "Homespun relay client: typed HTTP + WebSocket operations against a Homespun relay. Framework-free.",
   "license": "MIT",
   "type": "module",