cloudflare 4.4.1 → 5.0.0

package/src/resources/workers/workers.ts

@@ -44,6 +44,8 @@ import {
 } from './subdomains';
 import * as AssetsAPI from './assets/assets';
 import { Assets } from './assets/assets';
+import * as BetaAPI from './beta/beta';
+import { Beta } from './beta/beta';
 import * as ObservabilityAPI from './observability/observability';
 import { Observability } from './observability/observability';
 import * as ScriptsAPI from './scripts/scripts';
@@ -62,6 +64,7 @@ import {
 } from './scripts/scripts';
 
 export class Workers extends APIResource {
+  beta: BetaAPI.Beta = new BetaAPI.Beta(this._client);
   routes: RoutesAPI.Routes = new RoutesAPI.Routes(this._client);
   assets: AssetsAPI.Assets = new AssetsAPI.Assets(this._client);
   scripts: ScriptsAPI.Scripts = new ScriptsAPI.Scripts(this._client);
@@ -71,49 +74,7 @@ export class Workers extends APIResource {
   observability: ObservabilityAPI.Observability = new ObservabilityAPI.Observability(this._client);
 }
 
-export interface MigrationStep {
-  /**
-   * A list of classes to delete Durable Object namespaces from.
-   */
-  deleted_classes?: Array<string>;
-
-  /**
-   * A list of classes to create Durable Object namespaces from.
-   */
-  new_classes?: Array<string>;
-
-  /**
-   * A list of classes to create Durable Object namespaces with SQLite from.
-   */
-  new_sqlite_classes?: Array<string>;
-
-  /**
-   * A list of classes with Durable Object namespaces that were renamed.
-   */
-  renamed_classes?: Array<MigrationStep.RenamedClass>;
-
-  /**
-   * A list of transfers for Durable Object namespaces from a different Worker and
-   * class to a class defined in this Worker.
-   */
-  transferred_classes?: Array<MigrationStep.TransferredClass>;
-}
-
-export namespace MigrationStep {
-  export interface RenamedClass {
-    from?: string;
-
-    to?: string;
-  }
-
-  export interface TransferredClass {
-    from?: string;
-
-    from_script?: string;
-
-    to?: string;
-  }
-}
+export interface MigrationStep {}
 
 export interface MigrationStepParam {
   /**
@@ -162,60 +123,7 @@ export namespace MigrationStepParam {
 /**
  * A single set of migrations to apply.
  */
-export interface SingleStepMigration {
-  /**
-   * A list of classes to delete Durable Object namespaces from.
-   */
-  deleted_classes?: Array<string>;
-
-  /**
-   * A list of classes to create Durable Object namespaces from.
-   */
-  new_classes?: Array<string>;
-
-  /**
-   * A list of classes to create Durable Object namespaces with SQLite from.
-   */
-  new_sqlite_classes?: Array<string>;
-
-  /**
-   * Tag to set as the latest migration tag.
-   */
-  new_tag?: string;
-
-  /**
-   * Tag used to verify against the latest migration tag for this Worker. If they
-   * don't match, the upload is rejected.
-   */
-  old_tag?: string;
-
-  /**
-   * A list of classes with Durable Object namespaces that were renamed.
-   */
-  renamed_classes?: Array<SingleStepMigration.RenamedClass>;
-
-  /**
-   * A list of transfers for Durable Object namespaces from a different Worker and
-   * class to a class defined in this Worker.
-   */
-  transferred_classes?: Array<SingleStepMigration.TransferredClass>;
-}
-
-export namespace SingleStepMigration {
-  export interface RenamedClass {
-    from?: string;
-
-    to?: string;
-  }
-
-  export interface TransferredClass {
-    from?: string;
-
-    from_script?: string;
-
-    to?: string;
-  }
-}
+export interface SingleStepMigration {}
 
 /**
  * A single set of migrations to apply.
@@ -276,7 +184,7 @@ export namespace SingleStepMigrationParam {
 }
 
 /**
- * JSON encoded metadata about the uploaded parts and Worker configuration.
+ * JSON-encoded metadata about the uploaded parts and Worker configuration.
  */
 export interface WorkerMetadata {
   /**
@@ -294,7 +202,7 @@ export interface WorkerMetadata {
 }
 
 /**
- * JSON encoded metadata about the uploaded parts and Worker configuration.
+ * JSON-encoded metadata about the uploaded parts and Worker configuration.
  */
 export interface WorkerMetadataParam {
   /**
@@ -311,6 +219,7 @@ export interface WorkerMetadataParam {
   main_module?: string;
 }
 
+Workers.Beta = Beta;
 Workers.Routes = Routes;
 Workers.RouteListResponsesSinglePage = RouteListResponsesSinglePage;
 Workers.Assets = Assets;
@@ -329,6 +238,8 @@ export declare namespace Workers {
     type WorkerMetadata as WorkerMetadata,
   };
 
+  export { Beta as Beta };
+
   export {
     Routes as Routes,
     type RouteCreateResponse as RouteCreateResponse,

package/src/resources/workers-for-platforms/dispatch/namespaces/namespaces.ts

@@ -156,6 +156,15 @@ export interface NamespaceCreateResponse {
    * The current number of scripts in this Dispatch Namespace.
    */
   script_count?: number;
+
+  /**
+   * Whether the Workers in the namespace are executed in a "trusted" manner. When a
+   * Worker is trusted, it has access to the shared caches for the zone in the Cache
+   * API, and has access to the `request.cf` object on incoming Requests. When a
+   * Worker is untrusted, caches are not shared across the zone, and `request.cf` is
+   * undefined. By default, Workers in a namespace are "untrusted".
+   */
+  trusted_workers?: boolean;
 }
 
 export interface NamespaceListResponse {
@@ -193,6 +202,15 @@ export interface NamespaceListResponse {
    * The current number of scripts in this Dispatch Namespace.
    */
   script_count?: number;
+
+  /**
+   * Whether the Workers in the namespace are executed in a "trusted" manner. When a
+   * Worker is trusted, it has access to the shared caches for the zone in the Cache
+   * API, and has access to the `request.cf` object on incoming Requests. When a
+   * Worker is untrusted, caches are not shared across the zone, and `request.cf` is
+   * undefined. By default, Workers in a namespace are "untrusted".
+   */
+  trusted_workers?: boolean;
 }
 
 export type NamespaceDeleteResponse = unknown;
@@ -232,6 +250,15 @@ export interface NamespaceGetResponse {
    * The current number of scripts in this Dispatch Namespace.
    */
   script_count?: number;
+
+  /**
+   * Whether the Workers in the namespace are executed in a "trusted" manner. When a
+   * Worker is trusted, it has access to the shared caches for the zone in the Cache
+   * API, and has access to the `request.cf` object on incoming Requests. When a
+   * Worker is untrusted, caches are not shared across the zone, and `request.cf` is
+   * undefined. By default, Workers in a namespace are "untrusted".
+   */
+  trusted_workers?: boolean;
 }
 
 export interface NamespaceCreateParams {

package/src/resources/workers-for-platforms/dispatch/namespaces/scripts/asset-upload.ts

@@ -60,7 +60,7 @@ export interface AssetUploadCreateParams {
    * Body param: A manifest ([path]: {hash, size}) map of files to upload. As an
    * example, `/blog/hello-world.html` would be a valid path key.
    */
-  manifest: Record<string, AssetUploadCreateParams.Manifest>;
+  manifest: { [key: string]: AssetUploadCreateParams.Manifest };
 }
 
 export namespace AssetUploadCreateParams {

package/src/resources/workers-for-platforms/dispatch/namespaces/scripts/content.ts

@@ -91,11 +91,22 @@ export interface ContentUpdateParams {
   account_id: string;
 
   /**
-   * Body param: JSON encoded metadata about the uploaded parts and Worker
+   * Body param: JSON-encoded metadata about the uploaded parts and Worker
    * configuration.
    */
   metadata: WorkersAPI.WorkerMetadataParam;
 
+  /**
+   * Body param: An array of modules (often JavaScript files) comprising a Worker
+   * script. At least one module must be present and referenced in the metadata as
+   * `main_module` or `body_part` by filename.<br/>Possible Content-Type(s) are:
+   * `application/javascript+module`, `text/javascript+module`,
+   * `application/javascript`, `text/javascript`, `text/x-python`,
+   * `text/x-python-requirement`, `application/wasm`, `text/plain`,
+   * `application/octet-stream`, `application/source-map`.
+   */
+  files?: Array<Core.Uploadable>;
+
   /**
    * Header param: The multipart name of a script upload part containing script
    * content in service worker format. Alternative to including in a metadata part.
@@ -107,8 +118,6 @@ export interface ContentUpdateParams {
    * content in es module format. Alternative to including in a metadata part.
    */
   'CF-WORKER-MAIN-MODULE-PART'?: string;
-
-  [k: string]: Array<Core.Uploadable> | string | WorkersAPI.WorkerMetadataParam | undefined;
 }
 
 export interface ContentGetParams {

package/src/resources/workers-for-platforms/dispatch/namespaces/scripts/scripts.ts

@@ -77,12 +77,12 @@ export class Scripts extends APIResource {
     params: ScriptUpdateParams,
     options?: Core.RequestOptions,
   ): Core.APIPromise<ScriptUpdateResponse> {
-    const { account_id, files, ...body } = params;
+    const { account_id, ...body } = params;
     return (
       this._client.put(
         `/accounts/${account_id}/workers/dispatch/namespaces/${dispatchNamespace}/scripts/${scriptName}`,
         Core.maybeMultipartFormRequestOptions({
-          body: { ...body, ...files },
+          body,
           ...options,
           __multipartSyntax: 'json',
           headers: { 'Content-Type': 'application/javascript', ...options?.headers },
@@ -179,6 +179,19 @@ export interface ScriptUpdateResponse {
    */
   id?: string;
 
+  /**
+   * Date indicating targeted support in the Workers runtime. Backwards incompatible
+   * fixes to the runtime following this date will not affect this Worker.
+   */
+  compatibility_date?: string;
+
+  /**
+   * Flags that enable or disable certain features in the Workers runtime. Used to
+   * enable upcoming features or opt in or out of specific changes not included in a
+   * `compatibility_date`.
+   */
+  compatibility_flags?: Array<string>;
+
   /**
    * When the script was created.
    */
@@ -189,6 +202,11 @@ export interface ScriptUpdateResponse {
    */
   etag?: string;
 
+  /**
+   * The names of handlers exported as part of the default export.
+   */
+  handlers?: Array<string>;
+
   /**
    * Whether a Worker contains assets.
    */
@@ -199,16 +217,33 @@ export interface ScriptUpdateResponse {
    */
   has_modules?: boolean;
 
+  /**
+   * The client most recently used to deploy this Worker.
+   */
+  last_deployed_from?: string;
+
   /**
    * Whether Logpush is turned on for the Worker.
    */
   logpush?: boolean;
 
+  /**
+   * The tag of the Durable Object migration that was most recently applied for this
+   * Worker.
+   */
+  migration_tag?: string;
+
   /**
    * When the script was last modified.
    */
   modified_on?: string;
 
+  /**
+   * Named exports, such as Durable Object class implementations and named
+   * entrypoints.
+   */
+  named_handlers?: Array<ScriptUpdateResponse.NamedHandler>;
+
   /**
    * Configuration for
    * [Smart Placement](https://developers.cloudflare.com/workers/configuration/smart-placement).
@@ -233,10 +268,22 @@ export interface ScriptUpdateResponse {
   /**
    * Usage model for the Worker invocations.
    */
-  usage_model?: 'standard';
+  usage_model?: 'standard' | 'bundled' | 'unbound';
 }
 
 export namespace ScriptUpdateResponse {
+  export interface NamedHandler {
+    /**
+     * The names of handlers exported as part of the named export.
+     */
+    handlers?: Array<string>;
+
+    /**
+     * The name of the export.
+     */
+    name?: string;
+  }
+
   /**
    * Configuration for
    * [Smart Placement](https://developers.cloudflare.com/workers/configuration/smart-placement).
@@ -271,17 +318,26 @@ export interface ScriptUpdateParams {
   account_id: string;
 
   /**
-   * Body param: JSON encoded metadata about the uploaded parts and Worker
+   * Body param: JSON-encoded metadata about the uploaded parts and Worker
    * configuration.
    */
   metadata: ScriptUpdateParams.Metadata;
 
-  files?: Record<string, Core.Uploadable>;
+  /**
+   * Body param: An array of modules (often JavaScript files) comprising a Worker
+   * script. At least one module must be present and referenced in the metadata as
+   * `main_module` or `body_part` by filename.<br/>Possible Content-Type(s) are:
+   * `application/javascript+module`, `text/javascript+module`,
+   * `application/javascript`, `text/javascript`, `text/x-python`,
+   * `text/x-python-requirement`, `application/wasm`, `text/plain`,
+   * `application/octet-stream`, `application/source-map`.
+   */
+  files?: Array<Core.Uploadable>;
 }
 
 export namespace ScriptUpdateParams {
   /**
-   * JSON encoded metadata about the uploaded parts and Worker configuration.
+   * JSON-encoded metadata about the uploaded parts and Worker configuration.
    */
   export interface Metadata {
     /**
@@ -351,6 +407,11 @@ export namespace ScriptUpdateParams {
      */
     keep_bindings?: Array<string>;
 
+    /**
+     * Limits to apply for this Worker.
+     */
+    limits?: Metadata.Limits;
+
     /**
      * Whether Logpush is turned on for the Worker.
      */
@@ -391,7 +452,7 @@ export namespace ScriptUpdateParams {
     /**
      * Usage model for the Worker invocations.
      */
-    usage_model?: 'standard';
+    usage_model?: 'standard' | 'bundled' | 'unbound';
   }
 
   export namespace Metadata {
@@ -444,7 +505,14 @@ export namespace ScriptUpdateParams {
          * or '!/'. At least one non-negative rule must be provided, and negative rules
          * have higher precedence than non-negative rules.
          */
-        run_worker_first?: Array<string>;
+        run_worker_first?: Array<string> | boolean;
+
+        /**
+         * @deprecated When true and the incoming request matches an asset, that will be
+         * served instead of invoking the Worker script. When false, requests will always
+         * invoke the Worker script.
+         */
+        serve_directly?: boolean;
       }
     }
 
@@ -924,6 +992,16 @@ export namespace ScriptUpdateParams {
       script_name?: string;
     }
 
+    /**
+     * Limits to apply for this Worker.
+     */
+    export interface Limits {
+      /**
+       * The amount of CPU time this Worker can use in milliseconds.
+       */
+      cpu_ms?: number;
+    }
+
     export interface WorkersMultipleStepMigrations {
       /**
        * Tag to set as the latest migration tag.

package/src/resources/workers-for-platforms/dispatch/namespaces/scripts/settings.ts

@@ -118,11 +118,6 @@ export interface SettingEditResponse {
    */
   logpush?: boolean;
 
-  /**
-   * Migrations to apply for Durable Objects associated with this Worker.
-   */
-  migrations?: WorkersAPI.SingleStepMigration | SettingEditResponse.WorkersMultipleStepMigrations;
-
   /**
    * Observability settings for the Worker.
    */
@@ -147,7 +142,7 @@ export interface SettingEditResponse {
   /**
    * Usage model for the Worker invocations.
    */
-  usage_model?: 'standard';
+  usage_model?: 'standard' | 'bundled' | 'unbound';
 }
 
 export namespace SettingEditResponse {
@@ -620,24 +615,6 @@ export namespace SettingEditResponse {
     cpu_ms?: number;
   }
 
-  export interface WorkersMultipleStepMigrations {
-    /**
-     * Tag to set as the latest migration tag.
-     */
-    new_tag?: string;
-
-    /**
-     * Tag used to verify against the latest migration tag for this Worker. If they
-     * don't match, the upload is rejected.
-     */
-    old_tag?: string;
-
-    /**
-     * Migrations to apply in order.
-     */
-    steps?: Array<WorkersAPI.MigrationStep>;
-  }
-
   /**
    * Observability settings for the Worker.
    */
@@ -751,11 +728,6 @@ export interface SettingGetResponse {
    */
   logpush?: boolean;
 
-  /**
-   * Migrations to apply for Durable Objects associated with this Worker.
-   */
-  migrations?: WorkersAPI.SingleStepMigration | SettingGetResponse.WorkersMultipleStepMigrations;
-
   /**
    * Observability settings for the Worker.
    */
@@ -780,7 +752,7 @@ export interface SettingGetResponse {
   /**
    * Usage model for the Worker invocations.
    */
-  usage_model?: 'standard';
+  usage_model?: 'standard' | 'bundled' | 'unbound';
 }
 
 export namespace SettingGetResponse {
@@ -1253,24 +1225,6 @@ export namespace SettingGetResponse {
     cpu_ms?: number;
   }
 
-  export interface WorkersMultipleStepMigrations {
-    /**
-     * Tag to set as the latest migration tag.
-     */
-    new_tag?: string;
-
-    /**
-     * Tag used to verify against the latest migration tag for this Worker. If they
-     * don't match, the upload is rejected.
-     */
-    old_tag?: string;
-
-    /**
-     * Migrations to apply in order.
-     */
-    steps?: Array<WorkersAPI.MigrationStep>;
-  }
-
   /**
    * Observability settings for the Worker.
    */
@@ -1426,7 +1380,7 @@ export namespace SettingEditParams {
     /**
      * Usage model for the Worker invocations.
      */
-    usage_model?: 'standard';
+    usage_model?: 'standard' | 'bundled' | 'unbound';
   }
 
   export namespace Settings {

package/src/resources/workflows/instances/instances.ts

@@ -318,6 +318,11 @@ export interface InstanceCreateParams {
    */
   instance_id?: string;
 
+  /**
+   * Body param:
+   */
+  instance_retention?: unknown;
+
   /**
    * Body param:
    */
@@ -330,6 +335,11 @@ export interface InstanceListParams extends V4PagePaginationArrayParams {
    */
   account_id: string;
 
+  /**
+   * Query param: `page` and `cursor` are mutually exclusive, use one or the other.
+   */
+  cursor?: string;
+
   /**
    * Query param: Accepts ISO 8601 with no timezone offsets and in UTC.
    */
@@ -370,6 +380,8 @@ export namespace InstanceBulkParams {
   export interface Body {
     instance_id?: string;
 
+    instance_retention?: unknown;
+
     params?: unknown;
   }
 }