wrangler 0.0.0-e043479 → 0.0.0-e09abbc

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (208) hide show
  1. package/Cloudflare_CA.pem +18 -0
  2. package/README.md +33 -14
  3. package/bin/wrangler.js +160 -28
  4. package/kv-asset-handler.js +1 -0
  5. package/miniflare-dist/index.mjs +5354 -0
  6. package/package.json +166 -136
  7. package/src/__tests__/config-cache-without-cache-dir.test.ts +38 -0
  8. package/src/__tests__/config-cache.test.ts +42 -0
  9. package/src/__tests__/configuration.test.ts +3942 -2178
  10. package/src/__tests__/dev.test.tsx +1191 -235
  11. package/src/__tests__/guess-worker-format.test.ts +76 -57
  12. package/src/__tests__/helpers/cmd-shim.d.ts +6 -6
  13. package/src/__tests__/helpers/mock-account-id.ts +26 -22
  14. package/src/__tests__/helpers/mock-bin.ts +20 -20
  15. package/src/__tests__/helpers/mock-cfetch.ts +96 -92
  16. package/src/__tests__/helpers/mock-console.ts +59 -32
  17. package/src/__tests__/helpers/mock-dialogs.ts +121 -33
  18. package/src/__tests__/helpers/mock-http-server.ts +46 -0
  19. package/src/__tests__/helpers/mock-istty.ts +74 -0
  20. package/src/__tests__/helpers/mock-kv.ts +28 -35
  21. package/src/__tests__/helpers/mock-oauth-flow.ts +250 -0
  22. package/src/__tests__/helpers/mock-process.ts +39 -0
  23. package/src/__tests__/helpers/mock-stdin.ts +82 -77
  24. package/src/__tests__/helpers/mock-web-socket.ts +21 -21
  25. package/src/__tests__/helpers/run-in-tmp.ts +29 -20
  26. package/src/__tests__/helpers/run-wrangler.ts +8 -8
  27. package/src/__tests__/helpers/write-worker-source.ts +31 -0
  28. package/src/__tests__/helpers/write-wrangler-toml.ts +9 -9
  29. package/src/__tests__/https-options.test.ts +163 -0
  30. package/src/__tests__/index.test.ts +246 -850
  31. package/src/__tests__/init.test.ts +1992 -0
  32. package/src/__tests__/jest.setup.ts +85 -34
  33. package/src/__tests__/kv.test.ts +1402 -1139
  34. package/src/__tests__/logger.test.ts +141 -0
  35. package/src/__tests__/metrics.test.ts +445 -0
  36. package/src/__tests__/package-manager.test.ts +312 -165
  37. package/src/__tests__/pages.test.ts +1261 -0
  38. package/src/__tests__/parse.test.ts +253 -245
  39. package/src/__tests__/publish.test.ts +6611 -2079
  40. package/src/__tests__/pubsub.test.ts +367 -0
  41. package/src/__tests__/r2.test.ts +184 -149
  42. package/src/__tests__/route.test.ts +45 -0
  43. package/src/__tests__/secret.test.ts +474 -407
  44. package/src/__tests__/tail.test.ts +565 -431
  45. package/src/__tests__/test-old-node-version.js +31 -0
  46. package/src/__tests__/user.test.ts +143 -0
  47. package/src/__tests__/whoami.test.tsx +219 -75
  48. package/src/__tests__/worker-namespace.test.ts +327 -0
  49. package/src/abort.d.ts +3 -0
  50. package/src/api/dev.ts +86 -0
  51. package/src/api/index.ts +1 -0
  52. package/src/bundle-reporter.tsx +29 -0
  53. package/src/bundle.ts +196 -93
  54. package/src/cfetch/index.ts +83 -66
  55. package/src/cfetch/internal.ts +100 -84
  56. package/src/cli.ts +22 -14
  57. package/src/config/README.md +7 -7
  58. package/src/config/config.ts +223 -242
  59. package/src/config/diagnostics.ts +61 -61
  60. package/src/config/environment.ts +404 -256
  61. package/src/config/index.ts +218 -32
  62. package/src/config/validation-helpers.ts +436 -222
  63. package/src/config/validation.ts +1642 -907
  64. package/src/config-cache.ts +84 -0
  65. package/src/create-worker-preview.ts +255 -0
  66. package/src/create-worker-upload-form.ts +263 -0
  67. package/src/dev/dev-vars.ts +36 -0
  68. package/src/dev/dev.tsx +452 -0
  69. package/src/dev/local.tsx +373 -0
  70. package/src/dev/remote.tsx +386 -0
  71. package/src/dev/use-esbuild.ts +150 -0
  72. package/src/dev.tsx +576 -943
  73. package/src/dialogs.tsx +115 -57
  74. package/src/durable.ts +102 -0
  75. package/src/entry.ts +308 -37
  76. package/src/environment-variables.ts +25 -23
  77. package/src/errors.ts +11 -0
  78. package/src/faye-websocket.d.ts +6 -0
  79. package/src/generate.ts +33 -0
  80. package/src/git-client.ts +42 -0
  81. package/src/global-wrangler-config-path.ts +26 -0
  82. package/src/https-options.ts +127 -0
  83. package/src/index.tsx +1910 -2241
  84. package/src/init.ts +549 -0
  85. package/src/inspect.ts +603 -550
  86. package/src/intl-polyfill.d.ts +139 -0
  87. package/src/is-interactive.ts +12 -0
  88. package/src/kv.ts +430 -0
  89. package/src/logger.ts +73 -0
  90. package/src/metrics/index.ts +4 -0
  91. package/src/metrics/is-ci.ts +14 -0
  92. package/src/metrics/metrics-config.ts +239 -0
  93. package/src/metrics/metrics-dispatcher.ts +95 -0
  94. package/src/metrics/send-event.ts +92 -0
  95. package/src/miniflare-cli/README.md +30 -0
  96. package/src/miniflare-cli/assets.ts +543 -0
  97. package/src/miniflare-cli/enum-keys.ts +17 -0
  98. package/src/miniflare-cli/index.ts +85 -0
  99. package/src/miniflare-cli/request-context.ts +40 -0
  100. package/src/module-collection.ts +234 -146
  101. package/src/open-in-browser.ts +10 -6
  102. package/src/package-manager.ts +183 -90
  103. package/src/pages/build.tsx +204 -0
  104. package/src/pages/constants.ts +7 -0
  105. package/src/pages/deployments.tsx +106 -0
  106. package/src/pages/dev.tsx +401 -0
  107. package/src/pages/functions/buildPlugin.ts +105 -0
  108. package/src/pages/functions/buildWorker.ts +151 -0
  109. package/src/pages/functions/filepath-routing.test.ts +234 -0
  110. package/src/pages/functions/filepath-routing.ts +189 -0
  111. package/src/pages/functions/identifiers.ts +78 -0
  112. package/src/pages/functions/routes.ts +151 -0
  113. package/src/pages/index.tsx +84 -0
  114. package/src/pages/projects.tsx +163 -0
  115. package/src/pages/publish.tsx +338 -0
  116. package/src/pages/types.ts +40 -0
  117. package/src/pages/upload.tsx +396 -0
  118. package/src/pages/utils.ts +12 -0
  119. package/src/parse.ts +224 -121
  120. package/src/paths.ts +6 -6
  121. package/src/preview.ts +31 -0
  122. package/src/proxy.ts +413 -313
  123. package/src/publish.ts +773 -343
  124. package/src/pubsub/index.ts +286 -0
  125. package/src/pubsub/pubsub-commands.tsx +623 -0
  126. package/src/r2.ts +19 -19
  127. package/src/selfsigned.d.ts +29 -0
  128. package/src/sites.tsx +285 -151
  129. package/src/tail/filters.ts +108 -108
  130. package/src/tail/index.ts +217 -217
  131. package/src/tail/printing.ts +51 -46
  132. package/src/update-check.ts +19 -0
  133. package/src/user/choose-account.tsx +69 -0
  134. package/src/user/env-vars.ts +46 -0
  135. package/src/user/generate-auth-url.ts +33 -0
  136. package/src/user/generate-random-state.ts +16 -0
  137. package/src/user/index.ts +3 -0
  138. package/src/user/user.tsx +1171 -0
  139. package/src/whoami.tsx +63 -41
  140. package/src/worker-namespace.ts +206 -0
  141. package/src/worker.ts +191 -0
  142. package/src/zones.ts +76 -0
  143. package/templates/checked-fetch.js +17 -0
  144. package/templates/gitignore +171 -0
  145. package/templates/new-worker-scheduled.js +17 -0
  146. package/templates/new-worker-scheduled.ts +32 -0
  147. package/templates/new-worker.js +3 -3
  148. package/templates/new-worker.ts +18 -3
  149. package/templates/no-op-worker.js +10 -0
  150. package/templates/pages-shim.ts +9 -0
  151. package/templates/pages-template-plugin.ts +155 -0
  152. package/templates/pages-template-worker.ts +161 -0
  153. package/templates/static-asset-facade.js +38 -36
  154. package/templates/tsconfig.json +95 -95
  155. package/wrangler-dist/cli.d.ts +327 -0
  156. package/wrangler-dist/cli.js +94947 -111199
  157. package/pages/functions/buildWorker.ts +0 -62
  158. package/pages/functions/filepath-routing.test.ts +0 -123
  159. package/pages/functions/filepath-routing.ts +0 -178
  160. package/pages/functions/identifiers.ts +0 -78
  161. package/pages/functions/routes.ts +0 -151
  162. package/pages/functions/template-worker.ts +0 -130
  163. package/src/__tests__/helpers/faye-websocket.d.ts +0 -6
  164. package/src/__tests__/helpers/mock-user.ts +0 -27
  165. package/src/__tests__/logout.test.ts +0 -50
  166. package/src/__tests__/sentry.test.ts +0 -146
  167. package/src/api/form_data.ts +0 -217
  168. package/src/api/preview.ts +0 -147
  169. package/src/api/worker.ts +0 -186
  170. package/src/guess-worker-format.ts +0 -68
  171. package/src/kv.tsx +0 -339
  172. package/src/pages.tsx +0 -1045
  173. package/src/reporting.ts +0 -115
  174. package/src/user.tsx +0 -1063
  175. package/vendor/@cloudflare/kv-asset-handler/CHANGELOG.md +0 -332
  176. package/vendor/@cloudflare/kv-asset-handler/LICENSE_APACHE +0 -176
  177. package/vendor/@cloudflare/kv-asset-handler/LICENSE_MIT +0 -25
  178. package/vendor/@cloudflare/kv-asset-handler/README.md +0 -245
  179. package/vendor/@cloudflare/kv-asset-handler/dist/index.d.ts +0 -32
  180. package/vendor/@cloudflare/kv-asset-handler/dist/index.js +0 -354
  181. package/vendor/@cloudflare/kv-asset-handler/dist/mocks.d.ts +0 -13
  182. package/vendor/@cloudflare/kv-asset-handler/dist/mocks.js +0 -148
  183. package/vendor/@cloudflare/kv-asset-handler/dist/test/getAssetFromKV.d.ts +0 -1
  184. package/vendor/@cloudflare/kv-asset-handler/dist/test/getAssetFromKV.js +0 -436
  185. package/vendor/@cloudflare/kv-asset-handler/dist/test/mapRequestToAsset.d.ts +0 -1
  186. package/vendor/@cloudflare/kv-asset-handler/dist/test/mapRequestToAsset.js +0 -40
  187. package/vendor/@cloudflare/kv-asset-handler/dist/test/serveSinglePageApp.d.ts +0 -1
  188. package/vendor/@cloudflare/kv-asset-handler/dist/test/serveSinglePageApp.js +0 -42
  189. package/vendor/@cloudflare/kv-asset-handler/dist/types.d.ts +0 -26
  190. package/vendor/@cloudflare/kv-asset-handler/dist/types.js +0 -31
  191. package/vendor/@cloudflare/kv-asset-handler/package.json +0 -52
  192. package/vendor/@cloudflare/kv-asset-handler/src/index.ts +0 -296
  193. package/vendor/@cloudflare/kv-asset-handler/src/mocks.ts +0 -136
  194. package/vendor/@cloudflare/kv-asset-handler/src/test/getAssetFromKV.ts +0 -464
  195. package/vendor/@cloudflare/kv-asset-handler/src/test/mapRequestToAsset.ts +0 -33
  196. package/vendor/@cloudflare/kv-asset-handler/src/test/serveSinglePageApp.ts +0 -42
  197. package/vendor/@cloudflare/kv-asset-handler/src/types.ts +0 -39
  198. package/vendor/wrangler-mime/CHANGELOG.md +0 -289
  199. package/vendor/wrangler-mime/LICENSE +0 -21
  200. package/vendor/wrangler-mime/Mime.js +0 -97
  201. package/vendor/wrangler-mime/README.md +0 -187
  202. package/vendor/wrangler-mime/cli.js +0 -46
  203. package/vendor/wrangler-mime/index.js +0 -4
  204. package/vendor/wrangler-mime/lite.js +0 -4
  205. package/vendor/wrangler-mime/package.json +0 -52
  206. package/vendor/wrangler-mime/types/other.js +0 -1
  207. package/vendor/wrangler-mime/types/standard.js +0 -1
  208. package/wrangler-dist/cli.js.map +0 -7
@@ -1,66 +1,85 @@
1
1
  import { writeFile } from "fs/promises";
2
2
  import path from "path";
3
- import guessWorkerFormat from "../guess-worker-format";
3
+ import guessWorkerFormat from "../entry";
4
+ import { mockConsoleMethods } from "./helpers/mock-console";
4
5
  import { runInTempDir } from "./helpers/run-in-tmp";
5
6
 
6
7
  describe("guess worker format", () => {
7
- runInTempDir();
8
- it('should detect a "modules" worker', async () => {
9
- await writeFile("./index.ts", "export default {};");
10
- // Note that this isn't actually a valid worker, because it's missing
11
- // a fetch handler. Regardless, our heuristic is simply to check for exports.
12
- const guess = await guessWorkerFormat(
13
- {
14
- file: path.join(process.cwd(), "./index.ts"),
15
- directory: process.cwd(),
16
- },
17
- undefined
18
- );
19
- expect(guess).toBe("modules");
20
- });
8
+ runInTempDir();
9
+ const std = mockConsoleMethods();
10
+ it('should detect a "modules" worker', async () => {
11
+ await writeFile("./index.ts", "export default {};");
12
+ // Note that this isn't actually a valid worker, because it's missing
13
+ // a fetch handler. Regardless, our heuristic is simply to check for exports.
14
+ const guess = await guessWorkerFormat(
15
+ path.join(process.cwd(), "./index.ts"),
16
+ process.cwd(),
17
+ undefined
18
+ );
19
+ expect(guess).toBe("modules");
20
+ });
21
21
 
22
- it('should detect a "service-worker" worker', async () => {
23
- await writeFile("./index.ts", "");
24
- // Note that this isn't actually a valid worker, because it's missing
25
- // a fetch listener. Regardless, our heuristic is simply to check for
26
- // the lack of exports.
27
- const guess = await guessWorkerFormat(
28
- {
29
- file: path.join(process.cwd(), "./index.ts"),
30
- directory: process.cwd(),
31
- },
32
- undefined
33
- );
34
- expect(guess).toBe("service-worker");
35
- });
22
+ it('should detect a "service-worker" worker', async () => {
23
+ await writeFile("./index.ts", "");
24
+ // Note that this isn't actually a valid worker, because it's missing
25
+ // a fetch listener. Regardless, our heuristic is simply to check for
26
+ // the lack of exports.
27
+ const guess = await guessWorkerFormat(
28
+ path.join(process.cwd(), "./index.ts"),
29
+ process.cwd(),
30
+ undefined
31
+ );
32
+ expect(guess).toBe("service-worker");
33
+ });
36
34
 
37
- it("should throw an error when the hint doesn't match the guess (modules - service-worker)", async () => {
38
- await writeFile("./index.ts", "export default {};");
39
- await expect(
40
- guessWorkerFormat(
41
- {
42
- file: path.join(process.cwd(), "./index.ts"),
43
- directory: process.cwd(),
44
- },
45
- "service-worker"
46
- )
47
- ).rejects.toThrow(
48
- "You configured this worker to be a 'service-worker', but the file you are trying to build appears to have ES module exports. Please pass `--format modules`, or simply remove the configuration."
49
- );
50
- });
35
+ it("should throw an error when the hint doesn't match the guess (modules - service-worker)", async () => {
36
+ await writeFile("./index.ts", "export default {};");
37
+ await expect(
38
+ guessWorkerFormat(
39
+ path.join(process.cwd(), "./index.ts"),
40
+ process.cwd(),
41
+ "service-worker"
42
+ )
43
+ ).rejects.toThrow(
44
+ "You configured this worker to be a 'service-worker', but the file you are trying to build appears to have a `default` export like a module worker. Please pass `--format modules`, or simply remove the configuration."
45
+ );
46
+ });
51
47
 
52
- it("should throw an error when the hint doesn't match the guess (service-worker - modules)", async () => {
53
- await writeFile("./index.ts", "");
54
- await expect(
55
- guessWorkerFormat(
56
- {
57
- file: path.join(process.cwd(), "./index.ts"),
58
- directory: process.cwd(),
59
- },
60
- "modules"
61
- )
62
- ).rejects.toThrow(
63
- "You configured this worker to be 'modules', but the file you are trying to build doesn't export a handler. Please pass `--format service-worker`, or simply remove the configuration."
64
- );
65
- });
48
+ it("should throw an error when the hint doesn't match the guess (service-worker - modules)", async () => {
49
+ await writeFile("./index.ts", "");
50
+ await expect(
51
+ guessWorkerFormat(
52
+ path.join(process.cwd(), "./index.ts"),
53
+ process.cwd(),
54
+ "modules"
55
+ )
56
+ ).rejects.toThrow(
57
+ "You configured this worker to be 'modules', but the file you are trying to build doesn't export a handler. Please pass `--format service-worker`, or simply remove the configuration."
58
+ );
59
+ });
60
+
61
+ it("should not error if a .js entry point has jsx", async () => {
62
+ await writeFile("./index.js", "console.log(<div/>)");
63
+ const guess = await guessWorkerFormat(
64
+ path.join(process.cwd(), "./index.js"),
65
+ process.cwd(),
66
+ undefined
67
+ );
68
+ expect(guess).toBe("service-worker");
69
+ });
70
+
71
+ it("logs a warning when a worker has exports, but not a default one", async () => {
72
+ await writeFile("./index.ts", "export const foo = 1;");
73
+ const guess = await guessWorkerFormat(
74
+ path.join(process.cwd(), "./index.ts"),
75
+ process.cwd(),
76
+ undefined
77
+ );
78
+ expect(guess).toBe("service-worker");
79
+ expect(std.warn).toMatchInlineSnapshot(`
80
+ "▲ [WARNING] The entrypoint index.ts has exports like an ES Module, but hasn't defined a default export like a module worker normally would. Building the worker using \\"service-worker\\" format...
81
+
82
+ "
83
+ `);
84
+ });
66
85
  });
@@ -2,10 +2,10 @@
2
2
  * The typings file available at `@types/cmd-shim` are out of date.
3
3
  */
4
4
  module "cmd-shim" {
5
- /**
6
- *
7
- * Create a cmd shim at `to` for the command line program at `from`.
8
- *
9
- */
10
- export default function cmdShim(from: string, to: string): Promise<void>;
5
+ /**
6
+ *
7
+ * Create a cmd shim at `to` for the command line program at `from`.
8
+ *
9
+ */
10
+ export default function cmdShim(from: string, to: string): Promise<void>;
11
11
  }
@@ -1,3 +1,5 @@
1
+ import { reinitialiseAuthTokens } from "../../user";
2
+
1
3
  const ORIGINAL_CLOUDFLARE_API_TOKEN = process.env.CLOUDFLARE_API_TOKEN;
2
4
  const ORIGINAL_CLOUDFLARE_ACCOUNT_ID = process.env.CLOUDFLARE_ACCOUNT_ID;
3
5
 
@@ -8,18 +10,20 @@ const ORIGINAL_CLOUDFLARE_ACCOUNT_ID = process.env.CLOUDFLARE_ACCOUNT_ID;
8
10
  * This is useful if a higher `describe()` block has already called `mockApiToken()`.
9
11
  */
10
12
  export function mockApiToken({
11
- apiToken = "some-api-token",
13
+ apiToken = "some-api-token",
12
14
  }: { apiToken?: string | null } = {}) {
13
- beforeEach(() => {
14
- if (apiToken === null) {
15
- delete process.env.CLOUDFLARE_API_TOKEN;
16
- } else {
17
- process.env.CLOUDFLARE_API_TOKEN = apiToken;
18
- }
19
- });
20
- afterEach(() => {
21
- process.env.CLOUDFLARE_API_TOKEN = ORIGINAL_CLOUDFLARE_API_TOKEN;
22
- });
15
+ beforeEach(() => {
16
+ if (apiToken === null) {
17
+ delete process.env.CLOUDFLARE_API_TOKEN;
18
+ } else {
19
+ process.env.CLOUDFLARE_API_TOKEN = apiToken;
20
+ }
21
+ // Now we have updated the environment, we must reinitialize the user auth state.
22
+ reinitialiseAuthTokens();
23
+ });
24
+ afterEach(() => {
25
+ process.env.CLOUDFLARE_API_TOKEN = ORIGINAL_CLOUDFLARE_API_TOKEN;
26
+ });
23
27
  }
24
28
 
25
29
  /**
@@ -29,16 +33,16 @@ export function mockApiToken({
29
33
  * This is useful if a higher `describe()` block has already called `mockAccountId()`.
30
34
  */
31
35
  export function mockAccountId({
32
- accountId = "some-account-id",
36
+ accountId = "some-account-id",
33
37
  }: { accountId?: string | null } = {}) {
34
- beforeEach(() => {
35
- if (accountId === null) {
36
- delete process.env.CLOUDFLARE_ACCOUNT_ID;
37
- } else {
38
- process.env.CLOUDFLARE_ACCOUNT_ID = accountId;
39
- }
40
- });
41
- afterEach(() => {
42
- process.env.CLOUDFLARE_ACCOUNT_ID = ORIGINAL_CLOUDFLARE_ACCOUNT_ID;
43
- });
38
+ beforeEach(() => {
39
+ if (accountId === null) {
40
+ delete process.env.CLOUDFLARE_ACCOUNT_ID;
41
+ } else {
42
+ process.env.CLOUDFLARE_ACCOUNT_ID = accountId;
43
+ }
44
+ });
45
+ afterEach(() => {
46
+ process.env.CLOUDFLARE_ACCOUNT_ID = ORIGINAL_CLOUDFLARE_ACCOUNT_ID;
47
+ });
44
48
  }
@@ -8,29 +8,29 @@ const nodeShebang = "#!/usr/bin/env node";
8
8
  * Create a binary file in a temp directory and make it available on the PATH.
9
9
  */
10
10
  export async function mockBinary(
11
- binaryName: string,
12
- code: string
11
+ binaryName: string,
12
+ code: string
13
13
  ): Promise<() => void> {
14
- // Ensure there is a directory to put the mock binary in.
15
- const tmpDir = resolve(mkdtempSync(".mock-binary-"));
14
+ // Ensure there is a directory to put the mock binary in.
15
+ const tmpDir = resolve(mkdtempSync(".mock-binary-"));
16
16
 
17
- // Use a fake extension on Windows because we will create a cmd-shim to run the binary.
18
- const extension = process.platform === "win32" ? ".x-mock-bin" : "";
19
- const filePath = resolve(tmpDir, `${binaryName}${extension}`);
20
- writeFileSync(filePath, nodeShebang + "\n" + code);
21
- chmodSync(filePath, 0o777);
17
+ // Use a fake extension on Windows because we will create a cmd-shim to run the binary.
18
+ const extension = process.platform === "win32" ? ".x-mock-bin" : "";
19
+ const filePath = resolve(tmpDir, `${binaryName}${extension}`);
20
+ writeFileSync(filePath, nodeShebang + "\n" + code);
21
+ chmodSync(filePath, 0o777);
22
22
 
23
- if (process.platform === "win32") {
24
- await cmdShim(filePath, basename(filePath, ".x-mock-bin"));
25
- }
23
+ if (process.platform === "win32") {
24
+ await cmdShim(filePath, basename(filePath, ".x-mock-bin"));
25
+ }
26
26
 
27
- // Update PATH using the appropriate separator for the platform.
28
- const oldPath = process.env.PATH;
29
- const sep = process.platform === "win32" ? ";" : ":";
30
- process.env.PATH = tmpDir + sep + oldPath;
27
+ // Update PATH using the appropriate separator for the platform.
28
+ const oldPath = process.env.PATH;
29
+ const sep = process.platform === "win32" ? ";" : ":";
30
+ process.env.PATH = tmpDir + sep + oldPath;
31
31
 
32
- return function unMock() {
33
- rmSync(tmpDir, { recursive: true });
34
- process.env.PATH = process.env.PATH?.replace(tmpDir + sep, "");
35
- };
32
+ return function unMock() {
33
+ rmSync(tmpDir, { recursive: true });
34
+ process.env.PATH = process.env.PATH?.replace(tmpDir + sep, "");
35
+ };
36
36
  }
@@ -1,24 +1,24 @@
1
1
  import { URL, URLSearchParams } from "node:url";
2
2
  import { pathToRegexp } from "path-to-regexp";
3
3
  import { getCloudflareApiBaseUrl } from "../../cfetch";
4
- import type { FetchResult } from "../../cfetch";
4
+ import type { FetchResult, FetchError } from "../../cfetch";
5
5
  import type { RequestInit } from "undici";
6
6
 
7
7
  /**
8
8
  * The signature of the function that will handle a mock request.
9
9
  */
10
10
  export type MockHandler<ResponseType> = (
11
- uri: RegExpExecArray,
12
- init: RequestInit,
13
- queryParams: URLSearchParams
11
+ uri: RegExpExecArray,
12
+ init: RequestInit,
13
+ queryParams: URLSearchParams
14
14
  ) => ResponseType | Promise<ResponseType>;
15
15
 
16
16
  type RemoveMockFn = () => void;
17
17
 
18
18
  interface MockFetch<ResponseType> {
19
- regexp: RegExp;
20
- method: string | undefined;
21
- handler: MockHandler<ResponseType>;
19
+ regexp: RegExp;
20
+ method: string | undefined;
21
+ handler: MockHandler<ResponseType>;
22
22
  }
23
23
  const mocks: MockFetch<unknown>[] = [];
24
24
 
@@ -30,23 +30,23 @@ const mocks: MockFetch<unknown>[] = [];
30
30
  * Once found the handler will be used to generate a mock response.
31
31
  */
32
32
  export async function mockFetchInternal(
33
- resource: string,
34
- init: RequestInit = {},
35
- queryParams: URLSearchParams = new URLSearchParams()
33
+ resource: string,
34
+ init: RequestInit = {},
35
+ queryParams: URLSearchParams = new URLSearchParams()
36
36
  ) {
37
- for (const { regexp, method, handler } of mocks) {
38
- const resourcePath = new URL(resource, getCloudflareApiBaseUrl()).pathname;
39
- const uri = regexp.exec(resourcePath);
40
- // Do the resource path and (if specified) the HTTP method match?
41
- if (uri !== null && (!method || method === (init.method ?? "GET"))) {
42
- // The `resource` regular expression will extract the labelled groups from the URL.
43
- // These are passed through to the `handler` call, to allow it to do additional checks or behaviour.
44
- return await handler(uri, init, queryParams); // TODO: should we have some kind of fallthrough system? we'll see.
45
- }
46
- }
47
- throw new Error(
48
- `no mocks found for ${init.method ?? "any HTTP"} request to ${resource}`
49
- );
37
+ for (const { regexp, method, handler } of mocks) {
38
+ const resourcePath = new URL(resource, getCloudflareApiBaseUrl()).pathname;
39
+ const uri = regexp.exec(resourcePath);
40
+ // Do the resource path and (if specified) the HTTP method match?
41
+ if (uri !== null && (!method || method === (init.method ?? "GET"))) {
42
+ // The `resource` regular expression will extract the labelled groups from the URL.
43
+ // These are passed through to the `handler` call, to allow it to do additional checks or behaviour.
44
+ return await handler(uri, init, queryParams); // TODO: should we have some kind of fallthrough system? we'll see.
45
+ }
46
+ }
47
+ throw new Error(
48
+ `no mocks found for ${init.method ?? "any HTTP"} request to ${resource}`
49
+ );
50
50
  }
51
51
 
52
52
  /**
@@ -57,8 +57,8 @@ export async function mockFetchInternal(
57
57
  * @param handler The function that will generate the mock response for this request.
58
58
  */
59
59
  export function setMockRawResponse<ResponseType>(
60
- resource: string,
61
- handler: MockHandler<ResponseType>
60
+ resource: string,
61
+ handler: MockHandler<ResponseType>
62
62
  ): RemoveMockFn;
63
63
  /**
64
64
  * Specify an expected resource path that is to be handled, resulting in a raw JSON response.
@@ -69,32 +69,32 @@ export function setMockRawResponse<ResponseType>(
69
69
  * @param handler The function that will generate the mock response for this request.
70
70
  */
71
71
  export function setMockRawResponse<ResponseType>(
72
- resource: string,
73
- method: string,
74
- handler: MockHandler<ResponseType>
72
+ resource: string,
73
+ method: string,
74
+ handler: MockHandler<ResponseType>
75
75
  ): RemoveMockFn;
76
76
  /**
77
77
  * Specify an expected resource path that is to be handled, resulting in a raw JSON response.
78
78
  */
79
79
  export function setMockRawResponse<ResponseType>(
80
- resource: string,
81
- ...args: [string, MockHandler<ResponseType>] | [MockHandler<ResponseType>]
80
+ resource: string,
81
+ ...args: [string, MockHandler<ResponseType>] | [MockHandler<ResponseType>]
82
82
  ): RemoveMockFn {
83
- const handler = args.pop() as MockHandler<ResponseType>;
84
- const method = args.pop() as string;
85
- const mock = {
86
- resource,
87
- method,
88
- handler,
89
- regexp: pathToRegexp(resource),
90
- };
91
- mocks.push(mock);
92
- return () => {
93
- const mockIndex = mocks.indexOf(mock);
94
- if (mockIndex !== -1) {
95
- mocks.splice(mockIndex, 1);
96
- }
97
- };
83
+ const handler = args.pop() as MockHandler<ResponseType>;
84
+ const method = args.pop() as string;
85
+ const mock = {
86
+ resource,
87
+ method,
88
+ handler,
89
+ regexp: pathToRegexp(resource),
90
+ };
91
+ mocks.push(mock);
92
+ return () => {
93
+ const mockIndex = mocks.indexOf(mock);
94
+ if (mockIndex !== -1) {
95
+ mocks.splice(mockIndex, 1);
96
+ }
97
+ };
98
98
  }
99
99
 
100
100
  /**
@@ -107,8 +107,8 @@ export function setMockRawResponse<ResponseType>(
107
107
  * @param handler The function that will generate the mock response for this request.
108
108
  */
109
109
  export function setMockResponse<ResponseType>(
110
- resource: string,
111
- handler: MockHandler<ResponseType>
110
+ resource: string,
111
+ handler: MockHandler<ResponseType>
112
112
  ): RemoveMockFn;
113
113
  /**
114
114
  * Specify an expected resource path that is to be handled, resulting in a FetchRequest..
@@ -119,48 +119,48 @@ export function setMockResponse<ResponseType>(
119
119
  * @param handler The function that will generate the mock response for this request.
120
120
  */
121
121
  export function setMockResponse<ResponseType>(
122
- resource: string,
123
- method: string,
124
- handler: MockHandler<ResponseType>
122
+ resource: string,
123
+ method: string,
124
+ handler: MockHandler<ResponseType>
125
125
  ): RemoveMockFn;
126
126
  /**
127
127
  * Specify an expected resource path that is to be handled, resulting in a FetchRequest.
128
128
  */
129
129
  export function setMockResponse<ResponseType>(
130
- resource: string,
131
- ...args: [string, MockHandler<ResponseType>] | [MockHandler<ResponseType>]
130
+ resource: string,
131
+ ...args: [string, MockHandler<ResponseType>] | [MockHandler<ResponseType>]
132
132
  ): RemoveMockFn {
133
- const handler = args.pop() as MockHandler<ResponseType>;
134
- const method = args.pop() as string;
135
- return setMockRawResponse(resource, method, (...handlerArgs) =>
136
- createFetchResult(handler(...handlerArgs))
137
- );
133
+ const handler = args.pop() as MockHandler<ResponseType>;
134
+ const method = args.pop() as string;
135
+ return setMockRawResponse(resource, method, (...handlerArgs) =>
136
+ createFetchResult(handler(...handlerArgs))
137
+ );
138
138
  }
139
139
 
140
140
  /**
141
141
  * A helper to make it easier to create `FetchResult` objects in tests.
142
142
  */
143
143
  export async function createFetchResult<ResponseType>(
144
- result: ResponseType | Promise<ResponseType>,
145
- success = true,
146
- errors = [],
147
- messages = [],
148
- result_info?: unknown
144
+ result: ResponseType | Promise<ResponseType>,
145
+ success = true,
146
+ errors: FetchError[] = [],
147
+ messages: string[] = [],
148
+ result_info?: unknown
149
149
  ): Promise<FetchResult<ResponseType>> {
150
- return result_info
151
- ? {
152
- result: await result,
153
- success,
154
- errors,
155
- messages,
156
- result_info,
157
- }
158
- : {
159
- result: await result,
160
- success,
161
- errors,
162
- messages,
163
- };
150
+ return result_info
151
+ ? {
152
+ result: await result,
153
+ success,
154
+ errors,
155
+ messages,
156
+ result_info,
157
+ }
158
+ : {
159
+ result: await result,
160
+ success,
161
+ errors,
162
+ messages,
163
+ };
164
164
  }
165
165
 
166
166
  /**
@@ -169,7 +169,7 @@ export async function createFetchResult<ResponseType>(
169
169
  * This should be called in an `afterEach()` block to ensure that mock handlers do not leak between tests.
170
170
  */
171
171
  export function unsetAllMocks() {
172
- mocks.length = 0;
172
+ mocks.length = 0;
173
173
  }
174
174
 
175
175
  /**
@@ -179,29 +179,33 @@ export function unsetAllMocks() {
179
179
  * special-case mocking it here.
180
180
  */
181
181
 
182
- const kvGetMocks = new Map<string, string>();
182
+ const kvGetMocks = new Map<string, string | Buffer>();
183
183
 
184
+ /**
185
+ * @mocked typeof fetchKVGetValue
186
+ */
184
187
  export function mockFetchKVGetValue(
185
- accountId: string,
186
- namespaceId: string,
187
- key: string
188
+ accountId: string,
189
+ namespaceId: string,
190
+ key: string
188
191
  ) {
189
- const mapKey = `${accountId}/${namespaceId}/${key}`;
190
- if (kvGetMocks.has(mapKey)) {
191
- return kvGetMocks.get(mapKey);
192
- }
193
- throw new Error(`no mock value found for \`kv:key get\` - ${mapKey}`);
192
+ const mapKey = `${accountId}/${namespaceId}/${key}`;
193
+ if (kvGetMocks.has(mapKey)) {
194
+ const value = kvGetMocks.get(mapKey);
195
+ if (value !== undefined) return Promise.resolve(value);
196
+ }
197
+ throw new Error(`no mock value found for \`kv:key get\` - ${mapKey}`);
194
198
  }
195
199
 
196
200
  export function setMockFetchKVGetValue(
197
- accountId: string,
198
- namespaceId: string,
199
- key: string,
200
- value: string
201
+ accountId: string,
202
+ namespaceId: string,
203
+ key: string,
204
+ value: string | Buffer
201
205
  ) {
202
- kvGetMocks.set(`${accountId}/${namespaceId}/${key}`, value);
206
+ kvGetMocks.set(`${accountId}/${namespaceId}/${key}`, value);
203
207
  }
204
208
 
205
209
  export function unsetMockFetchKVGetValues() {
206
- kvGetMocks.clear();
210
+ kvGetMocks.clear();
207
211
  }