create-cloudflare 0.0.0-e33bb44a → 0.0.0-e3990bbf

package/package.json

@@ -1,74 +1,82 @@
 {
-	"name": "create-cloudflare",
-	"version": "0.0.0-e33bb44a",
-	"description": "A CLI for creating and deploying new applications to Cloudflare.",
-	"keywords": [
-		"cloudflare",
-		"workers",
-		"cloudflare workers",
-		"serverless",
-		"serverless application"
-	],
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/cloudflare/workers-sdk.git",
-		"directory": "packages/create-cloudflare"
-	},
-	"license": "MIT OR Apache-2.0",
-	"author": "wrangler@cloudflare.com",
-	"exports": {
-		".": "./dist/cli.js"
-	},
-	"main": "./dist/cli.js",
-	"bin": "./dist/cli.js",
-	"files": [
-		"dist",
-		"templates"
-	],
-	"scripts": {
-		"build": "node scripts/build.js",
-		"check:lint": "eslint .",
-		"check:type": "tsc",
-		"lint": "eslint",
-		"prepublishOnly": "npm run build",
-		"test:e2e": "npm run build && vitest run --config ./vitest-e2e.config.ts",
-		"test:unit": "vitest run --config ./vitest.config.ts",
-		"watch": "node scripts/build.js --watch"
-	},
-	"devDependencies": {
-		"@babel/parser": "^7.21.3",
-		"@babel/types": "^7.21.4",
-		"@clack/prompts": "^0.6.3",
-		"@cloudflare/eslint-config-worker": "*",
-		"@cloudflare/workers-tsconfig": "*",
-		"@cloudflare/workers-types": "^4.20230419.0",
-		"@types/command-exists": "^1.2.0",
-		"@types/cross-spawn": "^6.0.2",
-		"@types/esprima": "^4.0.3",
-		"@types/node": "^18.15.3",
-		"@types/which-pm-runs": "^1.0.0",
-		"@types/yargs": "^17.0.22",
-		"@typescript-eslint/eslint-plugin": "^5.55.0",
-		"@typescript-eslint/parser": "^5.55.0",
-		"chalk": "^5.2.0",
-		"command-exists": "^1.2.9",
-		"cross-spawn": "^7.0.3",
-		"esbuild": "^0.17.12",
-		"execa": "^7.1.1",
-		"haikunator": "^2.1.2",
-		"log-update": "^5.0.1",
-		"open": "^8.4.0",
-		"recast": "^0.22.0",
-		"semver": "^7.5.1",
-		"typescript": "^5.0.2",
-		"undici": "5.20.0",
-		"vite-tsconfig-paths": "^4.0.8",
-		"vitest": "^0.30.0",
-		"which-pm-runs": "^1.1.0",
-		"wrangler": "*",
-		"yargs": "^17.7.1"
-	},
-	"engines": {
-		"node": ">=16.13.0"
-	}
-}
+  "name": "create-cloudflare",
+  "version": "0.0.0-e3990bbf",
+  "description": "A CLI for creating and deploying new applications to Cloudflare.",
+  "keywords": [
+    "cloudflare",
+    "workers",
+    "cloudflare workers",
+    "serverless",
+    "serverless application"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cloudflare/workers-sdk.git",
+    "directory": "packages/create-cloudflare"
+  },
+  "license": "MIT OR Apache-2.0",
+  "author": "wrangler@cloudflare.com",
+  "exports": {
+    ".": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "bin": "./dist/cli.js",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "devDependencies": {
+    "@babel/parser": "^7.21.3",
+    "@babel/types": "^7.21.4",
+    "@clack/prompts": "^0.6.3",
+    "@cloudflare/eslint-config-worker": "*",
+    "@cloudflare/workers-types": "^4.20230419.0",
+    "@types/command-exists": "^1.2.0",
+    "@types/cross-spawn": "^6.0.2",
+    "@types/dns2": "^2.0.3",
+    "@types/esprima": "^4.0.3",
+    "@types/node": "^18.15.3",
+    "@types/which-pm-runs": "^1.0.0",
+    "@types/yargs": "^17.0.22",
+    "@typescript-eslint/eslint-plugin": "^5.55.0",
+    "@typescript-eslint/parser": "^5.55.0",
+    "chalk": "^5.2.0",
+    "command-exists": "^1.2.9",
+    "cross-spawn": "^7.0.3",
+    "dns2": "^2.1.0",
+    "esbuild": "^0.17.12",
+    "execa": "^7.1.1",
+    "haikunator": "^2.1.2",
+    "log-update": "^5.0.1",
+    "open": "^8.4.0",
+    "pnpm": "^8.6.11",
+    "recast": "^0.22.0",
+    "semver": "^7.5.1",
+    "typescript": "^5.0.2",
+    "undici": "5.20.0",
+    "vite-tsconfig-paths": "^4.0.8",
+    "vitest": "^0.30.0",
+    "which-pm-runs": "^1.1.0",
+    "yargs": "^17.7.1",
+    "yarn": "^1.22.19",
+    "@clack/core": "^0.3.2",
+    "@types/semver": "^7.5.1",
+    "@cloudflare/workers-tsconfig": "0.0.0",
+    "wrangler": "3.8.0"
+  },
+  "engines": {
+    "node": ">=16.13.0"
+  },
+  "scripts": {
+    "build": "node -r esbuild-register scripts/build.ts",
+    "check:lint": "eslint .",
+    "check:type": "tsc",
+    "lint": "eslint",
+    "test:e2e:cleanup": "node -r esbuild-register scripts/e2eCleanup.ts",
+    "test:e2e:npm": "pnpm run build && TEST_PM=npm vitest run --config ./vitest-e2e.config.ts",
+    "test:e2e:pnpm": "pnpm run build && TEST_PM=pnpm vitest run --config ./vitest-e2e.config.ts",
+    "test:unit": "vitest run --config ./vitest.config.ts",
+    "test:unit:watch": "vitest --config ./vitest.config.ts",
+    "watch": "node -r esbuild-register scripts/build.ts --watch"
+  }
+}

package/templates/chatgptPlugin/ts/README.md

@@ -17,8 +17,8 @@ The sample plugin allows ChatGPT users to search for repositories using GitHub's
 ## Usage
 
 1. You can configure the `.well-known/ai-plugin.json` route in `index.ts`.
-2. Update the OpenAPI schema in `openapi.ts`.
-3. You can set up any new routes and the associated OpenAPI schema by defining new routes. See `search.ts` for an example.
+2. You can set up any new routes and the associated OpenAPI schema by defining new routes. See `search.ts` for an example.
+3. For more information read the [itty-router-openapi official documentation](https://cloudflare.github.io/itty-router-openapi/).
 
 ## Deploying to OpenAI's API
 

package/templates/chatgptPlugin/ts/package.json

@@ -7,7 +7,7 @@
 		"start": "wrangler dev"
 	},
 	"dependencies": {
-		"@cloudflare/itty-router-openapi": "^0.1.2"
+		"@cloudflare/itty-router-openapi": "^1.0.1"
 	},
 	"devDependencies": {
 		"@cloudflare/workers-types": "^4.20230404.0",

package/templates/chatgptPlugin/ts/src/search.ts

@@ -1,9 +1,4 @@
-import {
-	ApiException,
-	OpenAPIRoute,
-	Query,
-	ValidationError,
-} from "@cloudflare/itty-router-openapi";
+import { OpenAPIRoute, Query } from "@cloudflare/itty-router-openapi";
 
 export class GetSearch extends OpenAPIRoute {
 	static schema = {
@@ -17,6 +12,7 @@ export class GetSearch extends OpenAPIRoute {
 		},
 		responses: {
 			"200": {
+				description: "Successfully response",
 				schema: {
 					repos: [
 						{
@@ -33,7 +29,7 @@ export class GetSearch extends OpenAPIRoute {
 	};
 
 	async handle(request: Request, env, ctx, data: Record<string, any>) {
-		const url = `https://api.github.com/search/repositories?q=${data.q}`;
+		const url = `https://api.github.com/search/repositories?q=${data.query.q}`;
 
 		const resp = await fetch(url, {
 			headers: {

package/templates/common/js/package.json

@@ -7,7 +7,6 @@
 		"start": "wrangler dev"
 	},
 	"devDependencies": {
-		"@cloudflare/workers-types": "^4.20230419.0",
 		"itty-router": "^3.0.12",
 		"wrangler": "^3.0.0"
 	}

package/templates/common/js/wrangler.toml

@@ -1,5 +1,5 @@
 name = "<TBD>"
-main = "src/worker.js"
+main = "src/index.js"
 compatibility_date = "<TBD>"
 
 # Variable bindings. These are arbitrary, plaintext strings (similar to environment variables)

package/templates/common/ts/wrangler.toml

@@ -1,5 +1,5 @@
 name = "<TBD>"
-main = "src/worker.ts"
+main = "src/index.ts"
 compatibility_date = "<TBD>"
 
 # Variable bindings. These are arbitrary, plaintext strings (similar to environment variables)

package/templates/hello-world/js/package.json

@@ -7,8 +7,6 @@
 		"start": "wrangler dev"
 	},
 	"devDependencies": {
-		"@cloudflare/workers-types": "^4.20230419.0",
-		"typescript": "^5.0.4",
 		"wrangler": "^3.0.0"
 	}
 }

package/templates/hello-world/js/wrangler.toml

@@ -1,5 +1,5 @@
 name = "<TBD>"
-main = "src/worker.js"
+main = "src/index.js"
 compatibility_date = "<TBD>"
 
 # Variable bindings. These are arbitrary, plaintext strings (similar to environment variables)

package/templates/hello-world/ts/wrangler.toml

@@ -1,5 +1,5 @@
 name = "<TBD>"
-main = "src/worker.ts"
+main = "src/index.ts"
 compatibility_date = "<TBD>"
 
 # Variable bindings. These are arbitrary, plaintext strings (similar to environment variables)

package/templates/openapi/ts/README.md

@@ -0,0 +1,25 @@
+# Cloudflare Workers OpenAPI 3.1
+
+This is a Cloudflare Worker with OpenAPI 3.1 using [itty-router-openapi](https://github.com/cloudflare/itty-router-openapi).
+
+This is an example project made to be used as a quick start into building OpenAPI compliant Workers that generates the
+`openapi.json` schema automatically from code and validates the incoming request to the defined parameters or request body.
+
+## Get started
+
+1. Sign up for [Cloudflare Workers](https://workers.dev). The free tier is more than enough for most use cases.
+2. Clone this project and install dependencies with `npm install`
+3. Run `wrangler login` to login to your Cloudflare account in wrangler
+4. Run `wrangler deploy` to publish the API to Cloudflare Workers
+
+## Project structure
+
+1. Your main router is defined in `src/index.ts`.
+2. Each endpoint has its own file in `src/endpoints/`.
+3. For more information read the [itty-router-openapi official documentation](https://cloudflare.github.io/itty-router-openapi/).
+
+## Development
+
+1. Run `wrangler dev` to start a local instance of the API.
+2. Open `http://localhost:9000/` in your browser to see the Swagger interface where you can try the endpoints.
+3. Changes made in the `src/` folder will automatically trigger the server to reload, you only need to refresh the Swagger interface.

package/templates/openapi/ts/package.json

@@ -0,0 +1,18 @@
+{
+	"name": "cloudflare-workers-openapi",
+	"version": "0.0.1",
+	"private": true,
+	"scripts": {
+		"deploy": "wrangler deploy",
+		"start": "wrangler dev"
+	},
+	"dependencies": {
+		"@cloudflare/itty-router-openapi": "^1.0.1"
+	},
+	"devDependencies": {
+		"@cloudflare/workers-types": "^4.20230821.0",
+		"@types/node": "^20.5.7",
+		"@types/service-worker-mock": "^2.0.1",
+		"wrangler": "^3.0.0"
+	}
+}

package/templates/openapi/ts/src/endpoints/taskCreate.ts

@@ -0,0 +1,48 @@
+import {
+	OpenAPIRoute,
+	OpenAPIRouteSchema,
+} from "@cloudflare/itty-router-openapi";
+import { Task } from "../types";
+
+export class TaskCreate extends OpenAPIRoute {
+	static schema: OpenAPIRouteSchema = {
+		tags: ["Tasks"],
+		summary: "Create a new Task",
+		requestBody: Task,
+		responses: {
+			"200": {
+				description: "Returns the created task",
+				schema: {
+					success: Boolean,
+					result: {
+						task: Task,
+					},
+				},
+			},
+		},
+	};
+
+	async handle(
+		request: Request,
+		env: any,
+		context: any,
+		data: Record<string, any>
+	) {
+		// Retrieve the validated request body
+		const taskToCreate = data.body;
+
+		// Implement your own object insertion here
+
+		// return the new task
+		return {
+			success: true,
+			task: {
+				name: taskToCreate.name,
+				slug: taskToCreate.slug,
+				description: taskToCreate.description,
+				completed: taskToCreate.completed,
+				due_date: taskToCreate.due_date,
+			},
+		};
+	}
+}

package/templates/openapi/ts/src/endpoints/taskDelete.ts

@@ -0,0 +1,55 @@
+import {
+	OpenAPIRoute,
+	OpenAPIRouteSchema,
+	Path,
+} from "@cloudflare/itty-router-openapi";
+import { Task } from "../types";
+
+export class TaskDelete extends OpenAPIRoute {
+	static schema: OpenAPIRouteSchema = {
+		tags: ["Tasks"],
+		summary: "Delete a Task",
+		parameters: {
+			taskSlug: Path(String, {
+				description: "Task slug",
+			}),
+		},
+		responses: {
+			"200": {
+				description: "Returns if the task was deleted successfully",
+				schema: {
+					success: Boolean,
+					result: {
+						task: Task,
+					},
+				},
+			},
+		},
+	};
+
+	async handle(
+		request: Request,
+		env: any,
+		context: any,
+		data: Record<string, any>
+	) {
+		// Retrieve the validated slug
+		const { taskSlug } = data.params;
+
+		// Implement your own object deletion here
+
+		// Return the deleted task for confirmation
+		return {
+			result: {
+				task: {
+					name: "Build something awesome with Cloudflare Workers",
+					slug: taskSlug,
+					description: "Lorem Ipsum",
+					completed: true,
+					due_date: "2022-12-24",
+				},
+			},
+			success: true,
+		};
+	}
+}

package/templates/openapi/ts/src/endpoints/taskFetch.ts

@@ -0,0 +1,74 @@
+import {
+	OpenAPIRoute,
+	OpenAPIRouteSchema,
+	Path,
+} from "@cloudflare/itty-router-openapi";
+import { Task } from "../types";
+
+export class TaskFetch extends OpenAPIRoute {
+	static schema: OpenAPIRouteSchema = {
+		tags: ["Tasks"],
+		summary: "Get a single Task by slug",
+		parameters: {
+			taskSlug: Path(String, {
+				description: "Task slug",
+			}),
+		},
+		responses: {
+			"200": {
+				description: "Returns a single task if found",
+				schema: {
+					success: Boolean,
+					result: {
+						task: Task,
+					},
+				},
+			},
+			"404": {
+				description: "Task not found",
+				schema: {
+					success: Boolean,
+					error: String,
+				},
+			},
+		},
+	};
+
+	async handle(
+		request: Request,
+		env: any,
+		context: any,
+		data: Record<string, any>
+	) {
+		// Retrieve the validated slug
+		const { taskSlug } = data.params;
+
+		// Implement your own object fetch here
+
+		const exists = true;
+
+		// @ts-ignore: check if the object exists
+		if (exists === false) {
+			return Response.json(
+				{
+					success: false,
+					error: "Object not found",
+				},
+				{
+					status: 404,
+				}
+			);
+		}
+
+		return {
+			success: true,
+			task: {
+				name: "my task",
+				slug: taskSlug,
+				description: "this needs to be done",
+				completed: false,
+				due_date: new Date().toISOString().slice(0, 10),
+			},
+		};
+	}
+}

package/templates/openapi/ts/src/endpoints/taskList.ts

@@ -0,0 +1,66 @@
+import { Task } from "../types";
+import {
+	OpenAPIRoute,
+	OpenAPIRouteSchema,
+	Query,
+} from "@cloudflare/itty-router-openapi";
+
+export class TaskList extends OpenAPIRoute {
+	static schema: OpenAPIRouteSchema = {
+		tags: ["Tasks"],
+		summary: "List Tasks",
+		parameters: {
+			page: Query(Number, {
+				description: "Page number",
+				default: 0,
+			}),
+			isCompleted: Query(Boolean, {
+				description: "Filter by completed flag",
+				required: false,
+			}),
+		},
+		responses: {
+			"200": {
+				description: "Returns a list of tasks",
+				schema: {
+					success: Boolean,
+					result: {
+						tasks: [Task],
+					},
+				},
+			},
+		},
+	};
+
+	async handle(
+		request: Request,
+		env: any,
+		context: any,
+		data: Record<string, any>
+	) {
+		// Retrieve the validated parameters
+		const { page, isCompleted } = data.query;
+
+		// Implement your own object list here
+
+		return {
+			success: true,
+			tasks: [
+				{
+					name: "Clean my room",
+					slug: "clean-room",
+					description: null,
+					completed: false,
+					due_date: "2025-01-05",
+				},
+				{
+					name: "Build something awesome with Cloudflare Workers",
+					slug: "cloudflare-workers",
+					description: "Lorem Ipsum",
+					completed: true,
+					due_date: "2022-12-24",
+				},
+			],
+		};
+	}
+}

package/templates/openapi/ts/src/index.ts

@@ -0,0 +1,29 @@
+import { OpenAPIRouter } from "@cloudflare/itty-router-openapi";
+import { TaskList } from "./endpoints/taskList";
+import { TaskCreate } from "./endpoints/taskCreate";
+import { TaskFetch } from "./endpoints/taskFetch";
+import { TaskDelete } from "./endpoints/taskDelete";
+
+export const router = OpenAPIRouter({
+	docs_url: "/",
+});
+
+router.get("/api/tasks/", TaskList);
+router.post("/api/tasks/", TaskCreate);
+router.get("/api/tasks/:taskSlug/", TaskFetch);
+router.delete("/api/tasks/:taskSlug/", TaskDelete);
+
+// 404 for everything else
+router.all("*", () =>
+	Response.json(
+		{
+			success: false,
+			error: "Route not found",
+		},
+		{ status: 404 }
+	)
+);
+
+export default {
+	fetch: router.handle,
+};

package/templates/openapi/ts/src/types.ts

@@ -0,0 +1,9 @@
+import { DateTime, Str } from "@cloudflare/itty-router-openapi";
+
+export const Task = {
+	name: new Str({ example: "lorem" }),
+	slug: String,
+	description: new Str({ required: false }),
+	completed: Boolean,
+	due_date: new DateTime(),
+};

package/templates/openapi/ts/tsconfig.json

@@ -0,0 +1,32 @@
+{
+	"compilerOptions": {
+		"allowJs": true,
+		"allowSyntheticDefaultImports": true,
+		"baseUrl": "src",
+		"declaration": true,
+		"sourceMap": true,
+		"esModuleInterop": true,
+		"inlineSourceMap": false,
+		"lib": ["esnext"],
+		"listEmittedFiles": false,
+		"listFiles": false,
+		"moduleResolution": "node",
+		"noFallthroughCasesInSwitch": true,
+		"pretty": true,
+		"resolveJsonModule": true,
+		"rootDir": ".",
+		"skipLibCheck": true,
+		"strict": false,
+		"traceResolution": false,
+		"outDir": "",
+		"target": "esnext",
+		"module": "esnext",
+		"types": [
+			"@types/node",
+			"@types/service-worker-mock",
+			"@cloudflare/workers-types"
+		]
+	},
+	"exclude": ["node_modules", "dist", "tests"],
+	"include": ["src", "scripts"]
+}

package/templates/openapi/ts/wrangler.toml

@@ -0,0 +1,3 @@
+name = "<TBD>"
+main = "src/index.ts"
+compatibility_date = "<TBD>"

package/templates/queues/js/package.json

@@ -7,8 +7,6 @@
 		"start": "wrangler dev"
 	},
 	"devDependencies": {
-		"@cloudflare/workers-types": "^4.20230419.0",
-		"typescript": "^5.0.4",
 		"wrangler": "^3.0.0"
 	}
 }

package/templates/queues/js/wrangler.toml

@@ -1,16 +1,16 @@
 name = "<TBD>"
-main = "src/worker.js"
+main = "src/index.js"
 compatibility_date = "<TBD>"
 
 # Bind a Queue producer. Use this binding to schedule an arbitrary task that may be processed later by a Queue consumer.
 # Docs: https://developers.cloudflare.com/queues/get-started
-# [[queues.producers]]
+[[queues.producers]]
 binding = "MY_QUEUE"
 queue = "my-queue"
 
 # Bind a Queue consumer. Queue Consumers can retrieve tasks scheduled by Producers to act on them.
 # Docs: https://developers.cloudflare.com/queues/get-started
-# [[queues.consumers]]
+[[queues.consumers]]
 queue = "my-queue"
 # Optional: Configure batching and retries: https://developers.cloudflare.com/queues/learning/batching-retries/
 # max_batch_size = 10