@void/deploy-cloudflare 0.22.0 → 0.24.0

package/dist/index.d.mts

@@ -1,13 +1,121 @@
 import { AssetConfig, HeaderRule, RedirectRule } from "@void/deploy-core";
+//#region src/operations.d.ts
+/** Typed provider operations shared by app deployment and platform installation. */
+type ConfigTarget = {
+  configPath?: string;
+};
+type WorkerTarget = ConfigTarget & {
+  workerName?: string;
+};
+type CloudflareOperation = ({
+  type: "auth.whoami" | "auth.login" | "auth.logout" | "auth.token";
+} & ConfigTarget) | ({
+  type: "d1.list" | "kv.namespace.list" | "containers.list";
+} & ConfigTarget) | ({
+  type: "d1.info";
+  name: string;
+} & ConfigTarget) | {
+  type: "d1.create";
+  name: string;
+  binding: string;
+  configPath: string;
+} | {
+  type: "d1.execute";
+  database: string;
+  sql: string;
+  configPath: string;
+} | {
+  type: "d1.migrations.list" | "d1.migrations.apply";
+  database: string;
+  configPath: string;
+} | {
+  type: "kv.namespace.create";
+  name: string;
+  binding: string;
+  configPath: string;
+} | ({
+  type: "r2.bucket.info";
+  name: string;
+} & ConfigTarget) | {
+  type: "r2.bucket.create";
+  name: string;
+  binding: string;
+  configPath: string;
+} | {
+  type: "hyperdrive.create";
+  name: string;
+  binding: string;
+  configPath: string;
+} | ({
+  type: "queues.info" | "queues.create";
+  name: string;
+} & ConfigTarget) | ({
+  type: "queues.consumer.remove";
+  queueName: string;
+  workerName: string;
+} & ConfigTarget) | ({
+  type: "email.routing.settings" | "email.routing.enable" | "email.routing.rules.list" | "email.sending.settings" | "email.sending.enable";
+  domain: string;
+} & ConfigTarget) | ({
+  type: "secret.list" | "secret.bulk";
+} & WorkerTarget) | ({
+  type: "secret.put" | "secret.delete";
+  name: string;
+} & WorkerTarget) | ({
+  type: "deployments.status" | "deployments.list" | "versions.list";
+} & WorkerTarget) | ({
+  type: "versions.view";
+  versionId: string;
+  includeSource?: boolean;
+} & WorkerTarget) | ({
+  type: "versions.deploy";
+  versions: Array<{
+    versionId: string;
+    percentage: number;
+  }>;
+  message?: string;
+} & WorkerTarget) | ({
+  type: "versions.upload" | "worker.deploy";
+  message?: string;
+  secretsFilePath?: string;
+  assetsDirectory?: string;
+  previewAlias?: string;
+  noBundle?: boolean;
+} & WorkerTarget) | ({
+  type: "triggers.deploy";
+  assets?: boolean;
+} & WorkerTarget) | ({
+  type: "triggers.clear-crons" | "triggers.clear-domains";
+} & WorkerTarget) | ({
+  type: "tail";
+  search?: string;
+  versionId?: string;
+  status?: "error";
+} & WorkerTarget);
+type CloudflareUploadResult = {
+  versionId: string;
+  previewUrl?: string;
+  workersDevUrl?: string;
+};
+type CloudflareProviderError = {
+  code?: number;
+  message: string;
+};
+//#endregion
 //#region src/execute.d.ts
 type CloudflareCommandResult = {
+  /** Structured provider response. stdout is diagnostics only. */
+  data?: unknown;
+  errorCode?: number;
+  failure?: "not-found" | "durable-migration" | "containers-unavailable";
+  errors?: Array<CloudflareProviderError>;
   stdout: string;
   stderr: string;
   status: number;
   signal?: NodeJS.Signals | null;
   error?: string | null;
 };
-type CloudflareCommandRunner = (args: Array<string>, options: {
+type CloudflareCommandRunner = (operation: CloudflareOperation, options: {
   capture: boolean;
 }) => CloudflareCommandResult | Promise<CloudflareCommandResult>;
 type CloudflareDeployExecution = {
@@ -112,6 +220,7 @@ type CloudflareFrameworkDeployConfig = Readonly<{
   assetsIgnore?: ReadonlyArray<string>;
   crons?: ReadonlyArray<string>;
   requiredSecrets?: ReadonlyArray<string>;
+  versionMetadataBinding?: string;
   ai?: Readonly<{
     binding: string;
     gateway?: string;
@@ -142,6 +251,7 @@ export declare function renderCloudflareStaticEntry(options: {
   headerRules?: ReadonlyArray<HeaderRule>;
   redirectRules?: ReadonlyArray<RedirectRule>;
   fallbackRules?: ReadonlyArray<RedirectRule>;
+  versionMetadataBinding?: string;
 }): string;
 /**
  * Copy static assets into Void's deploy area without Cloudflare's reserved routing files.
@@ -314,9 +424,13 @@ type CloudflareVersionActivationOptions = {
   fetch?: typeof globalThis.fetch;
   sleep?: (milliseconds: number) => Promise<void>;
   readinessAttempts?: number;
+  /** Require readiness to report the uploaded Worker's actual version UUID. */
+  requireVersionMetadata?: boolean;
+  /** A binding-preserving handoff without metadata may use only a genuine version preview. */
+  requirePreviewForReadiness?: boolean;
   /** Verify that omitted remote secrets come from the active Worker Version before uploading. */
   verifyInheritedSecrets?: boolean;
-  /** Pin opaque secret bindings to the live version when an unpublished upload is newer. */
+  /** Pin inherited opaque secret bindings to the inspected live version before uploading. */
   pinActiveSecrets?: (activeVersionId: string, bindings: ReadonlyArray<{
     name: string;
     type: "secret_text" | "secret_key";
@@ -364,4 +478,7 @@ export declare function createCloudflareMetadataRunner(options: {
   env?: Readonly<Record<string, string | undefined>>;
 }): CloudflareCommandRunner;
 //#endregion
-export type { ApprovedCloudflareKvBinding, CloudflareCommandResult, CloudflareCommandRunner, CloudflareDeployExecution, CloudflareFrameworkDeployConfig, CloudflareStaticDeployConfig, CloudflareTrafficConfig, CloudflareTriggerConfig, CloudflareTriggerStabilization, CloudflareVersionActivation, CloudflareVersionActivationOptions, CloudflareVersionMetadata, CloudflareWorkerMigrationTagOptions, ExistingCloudflareWorker };
+//#region src/secret-draft.d.ts
+export declare const VOID_SECRET_DRAFT_SOURCE = "export default { fetch() { return new Response(\"\"); } };\n";
+//#endregion
+export type { ApprovedCloudflareKvBinding, CloudflareCommandResult, CloudflareCommandRunner, CloudflareDeployExecution, CloudflareFrameworkDeployConfig, CloudflareOperation, CloudflareProviderError, CloudflareStaticDeployConfig, CloudflareTrafficConfig, CloudflareTriggerConfig, CloudflareTriggerStabilization, CloudflareUploadResult, CloudflareVersionActivation, CloudflareVersionActivationOptions, CloudflareVersionMetadata, CloudflareWorkerMigrationTagOptions, ExistingCloudflareWorker };