@void/deploy-core 1.1.0 → 1.1.12

package/dist/index.d.mts

@@ -49,13 +49,14 @@ export declare function createDeployResourcePlan(manifest: DeployManifest): Depl
 /** A concrete destination that can execute a Void deployment. */
 type DeployTarget = "cloudflare" | "void";
 type DeployAppType = "void" | "spa" | "static" | "framework";
+/**
+ * @deprecated Void does not read deploy target capabilities. Removed in the
+ * next major version.
+ */
 type DeployCapabilitySupport = "supported" | "partial" | "unsupported";
 /**
- * Cross-target capabilities used by CLI planning and user-facing diagnostics.
- *
- * A target reports what it can execute today. Capability declarations must not
- * be aspirational: feature gates are removed only when the corresponding
- * adapter and end-to-end coverage exist.
+ * @deprecated Void does not read deploy target capabilities. They do not gate
+ * deploys or appear in diagnostics. Removed in the next major version.
  */
 type DeployTargetCapabilities = {
   managedProjects: boolean;
@@ -86,6 +87,7 @@ type DeployTargetCapabilities = {
  */
 type DeployTargetAdapter<TOptions, TContext> = {
   readonly target: DeployTarget;
+  /** @deprecated Void ignores this field. Removed in the next major version. */
   readonly capabilities: DeployTargetCapabilities;
   deploy(root: string, options: TOptions, context: TContext): Promise<void>;
 };
@@ -144,11 +146,42 @@ type DeploySourceMetadata = {
   commitUrl: string | null;
   gitRef: string | null;
 };
-/** JSON payload accepted by the managed deployment API. */
+/** One Worker module uploaded to R2 before the deployment is finalized. */
+type DeployWorkerModule = {
+  /** Module path relative to the Worker output, the same key `workerFiles` uses. */
+  name: string;
+  /** Byte length of the module. */
+  size: number;
+  /** SHA-256 of the module bytes as 64 lowercase hex characters. */
+  sha256: string;
+};
+/** Request body of `POST /projects/:id/deploy/worker-upload-urls`. */
+type DeployWorkerUploadRequest = {
+  modules: Array<DeployWorkerModule>;
+};
+/** Upload URLs for each requested module, in request order. */
+type DeployWorkerUploadResponse = {
+  id: string;
+  urls: Array<{
+    url: string;
+    headers: Record<string, string>;
+  }>;
+};
+/** Worker modules already uploaded through `worker-upload-urls`, named by its upload `id`. */
+type DeployWorkerInput = {
+  id: string;
+  modules: Array<DeployWorkerModule>;
+};
+/**
+ * JSON payload accepted by the managed deployment API. Worker modules travel
+ * either inline as `workerFiles` or uploaded beforehand as `workerInput`,
+ * never both.
+ */
 type DeployUploadPayload = {
   manifest: DeployManifest;
   assetManifest: Record<string, DeployAssetManifestEntry>;
   workerFiles?: Record<string, string>;
+  workerInput?: DeployWorkerInput;
 } & DeploySourceMetadata & {
   preflight: "true" | null;
 };
@@ -165,10 +198,14 @@ export declare function createDeployArtifact(input: {
   assetManifest: Record<string, DeployAssetManifestEntry>;
   workerFiles?: Record<string, string>;
 }): DeployArtifact;
-/** Convert the canonical artifact into the stable hosted-platform wire shape. */
+/**
+ * Convert the canonical artifact into the stable hosted-platform wire shape.
+ * Pass `workerInput` when the Worker modules were uploaded beforehand; the
+ * artifact must then carry no inline `workerFiles`.
+ */
 export declare function createDeployUploadPayload(artifact: DeployArtifact, metadata: DeploySourceMetadata & {
   preflight: "true" | null;
-}): DeployUploadPayload;
+}, workerInput?: DeployWorkerInput): DeployUploadPayload;
 //#endregion
 //#region src/canonical-json.d.ts
 export declare function canonicalJson(value: unknown): string;
@@ -525,4 +562,4 @@ export type DeployEvent = {
   step: string;
 };
 //#endregion
-export type { DeployAppType, DeployArtifact, DeployAssetManifestEntry, DeployAssetUploadRequest, DeployCapabilitySupport, DeployIntent, DeployResource, DeployResourcePlan, DeployRuntimeFeatures, DeploySourceMetadata, DeployTarget, DeployTargetAdapter, DeployTargetCapabilities, DeployUploadPayload, MigrationPlanHashInput, SqlMigrationClassification, SqlSegment };
+export type { DeployAppType, DeployArtifact, DeployAssetManifestEntry, DeployAssetUploadRequest, DeployCapabilitySupport, DeployIntent, DeployResource, DeployResourcePlan, DeployRuntimeFeatures, DeploySourceMetadata, DeployTarget, DeployTargetAdapter, DeployTargetCapabilities, DeployUploadPayload, DeployWorkerInput, DeployWorkerModule, DeployWorkerUploadRequest, DeployWorkerUploadResponse, MigrationPlanHashInput, SqlMigrationClassification, SqlSegment };

package/dist/index.mjs

@@ -382,8 +382,13 @@ function createDeployArtifact(input) {
 		...input.workerFiles && Object.keys(input.workerFiles).length > 0 ? { workerFiles: input.workerFiles } : {}
 	};
 }
-/** Convert the canonical artifact into the stable hosted-platform wire shape. */
-function createDeployUploadPayload(artifact, metadata) {
+/**
+* Convert the canonical artifact into the stable hosted-platform wire shape.
+* Pass `workerInput` when the Worker modules were uploaded beforehand; the
+* artifact must then carry no inline `workerFiles`.
+*/
+function createDeployUploadPayload(artifact, metadata, workerInput) {
+	if (workerInput && artifact.workerFiles) throw new Error("A deployment sends its Worker modules inline or as uploads, not both.");
 	return {
 		manifest: {
 			...artifact.manifest,
@@ -391,6 +396,10 @@ function createDeployUploadPayload(artifact, metadata) {
 		},
 		assetManifest: { ...artifact.assetManifest },
 		...artifact.workerFiles ? { workerFiles: { ...artifact.workerFiles } } : {},
+		...workerInput ? { workerInput: {
+			id: workerInput.id,
+			modules: workerInput.modules.map((module) => ({ ...module }))
+		} } : {},
 		...metadata
 	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@void/deploy-core",
-  "version": "1.1.0",
+  "version": "1.1.12",
   "description": "Shared deployment contracts, manifests, and resource plans for Void.",
   "homepage": "https://void.cloud",
   "bugs": {