feat: support for raw "unsafe bindings"

packages/wrangler/src/api/form_data.ts

@@ -53,6 +53,7 @@ export interface WorkerMetadata {
         service: string;
         environment: string;
       }
+    | object
   )[];
 }
 
@@ -105,6 +106,10 @@ export function toFormData(worker: CfWorkerInit): FormData {
     });
   });
 
+  if (bindings.raw) {
+    metadataBindings.push(bindings.raw);
+  }
+
   const metadata: WorkerMetadata = {
     ...(main.type !== "commonjs"
       ? { main_module: main.name }

packages/wrangler/src/api/worker.ts

@@ -134,6 +134,7 @@ export interface CfWorkerInit {
     durable_objects?: { bindings: CfDurableObject[] };
     vars?: CfVars;
     services?: CfService[];
+    raw?: object[];
   };
   migrations: undefined | CfDurableObjectMigrations;
   compatibility_date: string | undefined;

packages/wrangler/src/config.ts

@@ -221,6 +221,23 @@ export type Config = {
     environment: string;
   }[];
 
+  /**
+   * "Unsafe" tables for features that aren't directly supported by wrangler.
+   * NB: these are not inherited, and HAVE to be duplicated across all environments.
+   *
+   * @default `[]`
+   * @optional
+   * @inherited false
+   */
+  unsafe?: {
+    /**
+     * A set of bindings that should be put into a Worker's upload metadata without changes. These
+     * can be used to implement bindings for features that haven't released and aren't supported
+     * directly by wrangler or miniflare.
+     */
+    bindings?: object[];
+  };
+
   /**
    * A list of migrations that should be uploaded with your Worker.
    * These define changes in your Durable Object declarations.

packages/wrangler/src/index.tsx

@@ -47,6 +47,13 @@ import type Yargs from "yargs";
 const resetColor = "\x1b[0m";
 const fgGreenColor = "\x1b[32m";
 
+// a set of binding types that are known to be supported by wrangler
+const knownBindings = [
+  "plain_text",
+  "kv_namespace",
+  "durable_object_namespace",
+];
+
 async function readConfig(configPath?: string): Promise<Config> {
   const config: Config = {};
   if (!configPath) {
@@ -71,6 +78,19 @@ async function readConfig(configPath?: string): Promise<Config> {
   // todo: validate, add defaults
   // let's just do some basics for now
 
+  for (const binding of config.unsafe?.bindings ?? []) {
+    if ("type" in binding && typeof binding["type"] == "string") {
+      const type = binding["type"];
+      if (knownBindings.includes(type)) {
+        console.warn(
+          `Raw '${type}' bindings are not directly supported by wrangler. Consider migrating to a ` +
+            `format for '${type}' bindings that is supported by wrangler for optimal support: ` +
+            "https://developers.cloudflare.com/workers/cli-wrangler/configuration"
+        );
+      }
+    }
+  }
+
   // @ts-expect-error we're being sneaky here for now
   config.__path__ = configPath;
 
@@ -681,6 +701,7 @@ export async function main(argv: string[]): Promise<void> {
             vars: envRootObj.vars,
             durable_objects: envRootObj.durable_objects,
             services: envRootObj.experimental_services,
+            raw: envRootObj.unsafe?.bindings,
           }}
         />
       );

packages/wrangler/src/publish.ts

@@ -242,6 +242,7 @@ export default async function publish(props: Props): Promise<void> {
     vars: envRootObj.vars,
     durable_objects: envRootObj.durable_objects,
     services: envRootObj.experimental_services,
+    raw: envRootObj.unsafe?.bindings,
   };
 
   const workerType = bundle.type === "esm" ? "esm" : "commonjs";