Using Cloudflare Workers

.gitignore

@@ -0,0 +1,168 @@
+# Logs
+
+logs
+_.log
+npm-debug.log_
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+.pnpm-store
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# Runtime data
+
+pids
+_.pid
+_.seed
+\*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+
+lib-cov
+
+# Coverage directory used by tools like istanbul
+
+coverage
+\*.lcov
+
+# nyc test coverage
+
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+
+bower_components
+
+# node-waf configuration
+
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+
+build/Release
+
+# Dependency directories
+
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+
+web_modules/
+
+# TypeScript cache
+
+\*.tsbuildinfo
+
+# Optional npm cache directory
+
+.npm
+
+# Optional eslint cache
+
+.eslintcache
+
+# Optional stylelint cache
+
+.stylelintcache
+
+# Microbundle cache
+
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+
+.node_repl_history
+
+# Output of 'npm pack'
+
+\*.tgz
+
+# Yarn Integrity file
+
+.yarn-integrity
+
+# parcel-bundler cache (https://parceljs.org/)
+
+.cache
+.parcel-cache
+
+# Next.js build output
+
+.next
+out
+
+# Nuxt.js build / generate output
+
+.nuxt
+dist
+
+# Gatsby files
+
+.cache/
+
+# Comment in the public line in if your project uses Gatsby and not Next.js
+
+# https://nextjs.org/blog/next-9-1#public-directory-support
+
+# public
+
+# vuepress build output
+
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+
+.temp
+.cache
+
+# Docusaurus cache and generated files
+
+.docusaurus
+
+# Serverless directories
+
+.serverless/
+
+# FuseBox cache
+
+.fusebox/
+
+# DynamoDB Local files
+
+.dynamodb/
+
+# TernJS port file
+
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+
+.vscode-test
+
+# yarn v2
+
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.\*
+
+# wrangler project
+
+.dev.vars*
+!.dev.vars.example
+.env*
+!.env.example
+.wrangler/

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "files.associations": {
+        "wrangler.json": "jsonc"
+    }
+}

biome.json

@@ -0,0 +1,46 @@
+{
+    "$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+    "vcs": {
+        "enabled": true,
+        "clientKind": "git",
+        "useIgnoreFile": true
+    },
+    "files": {
+        "ignoreUnknown": true,
+        "includes": ["**", "!node_modules", "!.next", "!dist", "!build", "!src/app/globals.css"]
+    },
+    "formatter": {
+        "lineWidth": 320,
+        "enabled": true,
+        "indentStyle": "space",
+        "indentWidth": 4
+    },
+    "linter": {
+        "enabled": true,
+        "rules": {
+            "recommended": true,
+            "performance": {
+                "noImgElement": "off"
+            },
+            "suspicious": {
+                "noUnknownAtRules": "off"
+            }
+        },
+        "domains": {
+            "next": "recommended",
+            "react": "recommended"
+        }
+    },
+    "assist": {
+        "actions": {
+            "source": {
+                "organizeImports": {
+                    "level": "on",
+                    "options": {
+                        "groups": [["next", "next/**"], ["react*", "react/**"], ":BLANK_LINE:", ":PACKAGE:", ":BLANK_LINE:", ":ALIAS:", ":PATH:", ":BLANK_LINE:"]
+                    }
+                }
+            }
+        }
+    }
+}

package.json

@@ -0,0 +1,21 @@
+{
+    "name": "google-drive-s3",
+    "version": "0.0.0",
+    "private": true,
+    "scripts": {
+        "deploy": "wrangler deploy",
+        "dev": "wrangler dev",
+        "start": "wrangler dev",
+        "test": "vitest",
+        "cf-typegen": "wrangler types",
+        "lint": "biome check",
+        "format": "biome format --write"
+    },
+    "devDependencies": {
+        "@biomejs/biome": "^2.3.11",
+        "@cloudflare/vitest-pool-workers": "^0.8.19",
+        "typescript": "^5.5.2",
+        "vitest": "~3.2.0",
+        "wrangler": "^4.57.0"
+    }
+}

src/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Welcome to Cloudflare Workers! This is your first worker.
+ *
+ * - Run `npm run dev` in your terminal to start a development server
+ * - Open a browser tab at http://localhost:8787/ to see your worker in action
+ * - Run `npm run deploy` to publish your worker
+ *
+ * Bind resources to your worker in `wrangler.jsonc`. After adding bindings, a type definition for the
+ * `Env` object can be regenerated with `npm run cf-typegen`.
+ *
+ * Learn more at https://developers.cloudflare.com/workers/
+ */
+
+export default {
+    async fetch(request, env, ctx): Promise<Response> {
+        return new Response("Hello World!");
+    },
+} satisfies ExportedHandler<Env>;

test/env.d.ts

@@ -0,0 +1,3 @@
+declare module "cloudflare:test" {
+    interface ProvidedEnv extends Env {}
+}

test/index.spec.ts

@@ -0,0 +1,24 @@
+import { env, createExecutionContext, waitOnExecutionContext, SELF } from "cloudflare:test";
+import { describe, it, expect } from "vitest";
+import worker from "../src/index";
+
+// For now, you'll need to do something like this to get a correctly-typed
+// `Request` to pass to `worker.fetch()`.
+const IncomingRequest = Request<unknown, IncomingRequestCfProperties>;
+
+describe("Hello World worker", () => {
+    it("responds with Hello World! (unit style)", async () => {
+        const request = new IncomingRequest("http://example.com");
+        // Create an empty context to pass to `worker.fetch()`.
+        const ctx = createExecutionContext();
+        const response = await worker.fetch(request, env, ctx);
+        // Wait for all `Promise`s passed to `ctx.waitUntil()` to settle before running test assertions
+        await waitOnExecutionContext(ctx);
+        expect(await response.text()).toMatchInlineSnapshot(`"Hello World!"`);
+    });
+
+    it("responds with Hello World! (integration style)", async () => {
+        const response = await SELF.fetch("https://example.com");
+        expect(await response.text()).toMatchInlineSnapshot(`"Hello World!"`);
+    });
+});

test/tsconfig.json

@@ -0,0 +1,8 @@
+{
+    "extends": "../tsconfig.json",
+    "compilerOptions": {
+        "types": ["@cloudflare/vitest-pool-workers"]
+    },
+    "include": ["./**/*.ts", "../worker-configuration.d.ts"],
+    "exclude": []
+}

tsconfig.json

@@ -0,0 +1,43 @@
+{
+    "compilerOptions": {
+        /* Visit https://aka.ms/tsconfig.json to read more about this file */
+
+        /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
+        "target": "es2024",
+        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
+        "lib": ["es2024"],
+        /* Specify what JSX code is generated. */
+        "jsx": "react-jsx",
+
+        /* Specify what module code is generated. */
+        "module": "es2022",
+        /* Specify how TypeScript looks up a file from a given module specifier. */
+        "moduleResolution": "Bundler",
+        /* Enable importing .json files */
+        "resolveJsonModule": true,
+
+        /* Allow JavaScript files to be a part of your program. Use the `checkJS` option to get errors from these files. */
+        "allowJs": true,
+        /* Enable error reporting in type-checked JavaScript files. */
+        "checkJs": false,
+
+        /* Disable emitting files from a compilation. */
+        "noEmit": true,
+
+        /* Ensure that each file can be safely transpiled without relying on other imports. */
+        "isolatedModules": true,
+        /* Allow 'import x from y' when a module doesn't have a default export. */
+        "allowSyntheticDefaultImports": true,
+        /* Ensure that casing is correct in imports. */
+        "forceConsistentCasingInFileNames": true,
+
+        /* Enable all strict type-checking options. */
+        "strict": true,
+
+        /* Skip type checking all .d.ts files. */
+        "skipLibCheck": true,
+        "types": ["./worker-configuration.d.ts"]
+    },
+    "exclude": ["test"],
+    "include": ["worker-configuration.d.ts", "src/**/*.ts"]
+}

vitest.config.mts

@@ -0,0 +1,11 @@
+import { defineWorkersConfig } from "@cloudflare/vitest-pool-workers/config";
+
+export default defineWorkersConfig({
+    test: {
+        poolOptions: {
+            workers: {
+                wrangler: { configPath: "./wrangler.jsonc" },
+            },
+        },
+    },
+});

wrangler.jsonc

@@ -0,0 +1,41 @@
+/**
+ * For more details on how to configure Wrangler, refer to:
+ * https://developers.cloudflare.com/workers/wrangler/configuration/
+ */
+{
+    "$schema": "node_modules/wrangler/config-schema.json",
+    "name": "google-drive-s3",
+    "main": "src/index.ts",
+    "compatibility_date": "2025-09-27",
+    "observability": {
+        "enabled": true
+    }
+    /**
+     * Smart Placement
+     * https://developers.cloudflare.com/workers/configuration/smart-placement/#smart-placement
+     */
+    // "placement": {  "mode": "smart" }
+    /**
+     * Bindings
+     * Bindings allow your Worker to interact with resources on the Cloudflare Developer Platform, including
+     * databases, object storage, AI inference, real-time communication and more.
+     * https://developers.cloudflare.com/workers/runtime-apis/bindings/
+     */
+    /**
+     * Environment Variables
+     * https://developers.cloudflare.com/workers/wrangler/configuration/#environment-variables
+     * Note: Use secrets to store sensitive data.
+     * https://developers.cloudflare.com/workers/configuration/secrets/
+     */
+    // "vars": {  "MY_VARIABLE": "production_value" }
+    /**
+     * Static Assets
+     * https://developers.cloudflare.com/workers/static-assets/binding/
+     */
+    // "assets": {  "directory": "./public/",  "binding": "ASSETS" }
+    /**
+     * Service Bindings (communicate between multiple Workers)
+     * https://developers.cloudflare.com/workers/wrangler/configuration/#service-bindings
+     */
+    // "services": [  {   "binding": "MY_SERVICE",   "service": "my-service"  } ]
+}