wrangler 0.0.0-e2f9bb2 → 0.0.0-e305903a

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 (258) hide show
  1. package/Cloudflare_CA.pem +18 -0
  2. package/README.md +30 -4
  3. package/bin/wrangler.js +154 -34
  4. package/kv-asset-handler.js +1 -0
  5. package/miniflare-dist/index.mjs +1437 -21
  6. package/package.json +185 -148
  7. package/src/__tests__/api-dev.test.ts +209 -0
  8. package/src/__tests__/api-devregistry.test.js +56 -0
  9. package/src/__tests__/api.test.ts +80 -0
  10. package/src/__tests__/config-cache-without-cache-dir.test.ts +38 -0
  11. package/src/__tests__/config-cache.test.ts +30 -24
  12. package/src/__tests__/configuration.test.ts +4121 -3114
  13. package/src/__tests__/dev.test.tsx +1331 -738
  14. package/src/__tests__/dialogs.test.tsx +40 -0
  15. package/src/__tests__/generate.test.ts +91 -0
  16. package/src/__tests__/guess-worker-format.test.ts +68 -68
  17. package/src/__tests__/helpers/cmd-shim.d.ts +6 -6
  18. package/src/__tests__/helpers/mock-account-id.ts +24 -24
  19. package/src/__tests__/helpers/mock-bin.ts +20 -20
  20. package/src/__tests__/helpers/mock-cfetch.ts +199 -94
  21. package/src/__tests__/helpers/mock-console.ts +58 -39
  22. package/src/__tests__/helpers/mock-dialogs.ts +115 -51
  23. package/src/__tests__/helpers/mock-get-zone-from-host.ts +8 -0
  24. package/src/__tests__/helpers/mock-http-server.ts +30 -30
  25. package/src/__tests__/helpers/mock-istty.ts +65 -18
  26. package/src/__tests__/helpers/mock-known-routes.ts +7 -0
  27. package/src/__tests__/helpers/mock-kv.ts +26 -26
  28. package/src/__tests__/helpers/mock-oauth-flow.ts +225 -228
  29. package/src/__tests__/helpers/mock-process.ts +39 -0
  30. package/src/__tests__/helpers/mock-stdin.ts +82 -77
  31. package/src/__tests__/helpers/mock-web-socket.ts +21 -21
  32. package/src/__tests__/helpers/msw/handlers/index.ts +13 -0
  33. package/src/__tests__/helpers/msw/handlers/namespaces.ts +104 -0
  34. package/src/__tests__/helpers/msw/handlers/oauth.ts +36 -0
  35. package/src/__tests__/helpers/msw/handlers/r2.ts +80 -0
  36. package/src/__tests__/helpers/msw/handlers/user.ts +63 -0
  37. package/src/__tests__/helpers/msw/index.ts +4 -0
  38. package/src/__tests__/helpers/run-in-tmp.ts +27 -28
  39. package/src/__tests__/helpers/run-wrangler.ts +8 -8
  40. package/src/__tests__/helpers/worker-scripts/child-wrangler.toml +1 -0
  41. package/src/__tests__/helpers/worker-scripts/hello-world-worker.js +5 -0
  42. package/src/__tests__/helpers/worker-scripts/hello-world-wrangler.toml +1 -0
  43. package/src/__tests__/helpers/worker-scripts/parent-worker.js +8 -0
  44. package/src/__tests__/helpers/worker-scripts/parent-wrangler.toml +5 -0
  45. package/src/__tests__/helpers/write-worker-source.ts +16 -16
  46. package/src/__tests__/helpers/write-wrangler-toml.ts +9 -9
  47. package/src/__tests__/https-options.test.ts +142 -109
  48. package/src/__tests__/index.test.ts +231 -231
  49. package/src/__tests__/init.test.ts +2689 -1014
  50. package/src/__tests__/jest.setup.ts +147 -30
  51. package/src/__tests__/kv.test.ts +1311 -1094
  52. package/src/__tests__/logger.test.ts +100 -74
  53. package/src/__tests__/metrics.test.ts +450 -0
  54. package/src/__tests__/middleware.scheduled.test.ts +135 -0
  55. package/src/__tests__/middleware.test.ts +726 -0
  56. package/src/__tests__/package-manager.test.ts +312 -165
  57. package/src/__tests__/pages.test.ts +1988 -322
  58. package/src/__tests__/parse.test.ts +253 -245
  59. package/src/__tests__/paths.test.ts +39 -0
  60. package/src/__tests__/publish.test.ts +6955 -4743
  61. package/src/__tests__/pubsub.test.ts +367 -0
  62. package/src/__tests__/r2.test.ts +363 -206
  63. package/src/__tests__/route.test.ts +18 -18
  64. package/src/__tests__/secret.test.ts +624 -426
  65. package/src/__tests__/tail.test.ts +650 -565
  66. package/src/__tests__/test-old-node-version.js +31 -0
  67. package/src/__tests__/user.test.ts +140 -116
  68. package/src/__tests__/validate-dev-props.test.ts +56 -0
  69. package/src/__tests__/version.test.ts +35 -0
  70. package/src/__tests__/whoami.test.tsx +259 -91
  71. package/src/__tests__/worker-namespace.test.ts +319 -0
  72. package/src/abort.d.ts +3 -0
  73. package/src/api/dev.ts +206 -0
  74. package/src/api/index.ts +2 -0
  75. package/src/bundle-reporter.tsx +29 -0
  76. package/src/bundle.ts +721 -134
  77. package/src/cfetch/index.ts +83 -66
  78. package/src/cfetch/internal.ts +267 -90
  79. package/src/cli.ts +23 -7
  80. package/src/config/config.ts +236 -195
  81. package/src/config/diagnostics.ts +61 -61
  82. package/src/config/environment.ts +450 -339
  83. package/src/config/index.ts +258 -38
  84. package/src/config/validation-helpers.ts +379 -357
  85. package/src/config/validation.ts +1769 -1263
  86. package/src/config-cache.ts +81 -41
  87. package/src/create-worker-preview.ts +232 -132
  88. package/src/create-worker-upload-form.ts +285 -224
  89. package/src/d1/backups.tsx +212 -0
  90. package/src/d1/create.tsx +54 -0
  91. package/src/d1/delete.tsx +56 -0
  92. package/src/d1/execute.tsx +294 -0
  93. package/src/d1/formatTimeAgo.ts +14 -0
  94. package/src/d1/index.ts +75 -0
  95. package/src/d1/list.tsx +48 -0
  96. package/src/d1/options.ts +12 -0
  97. package/src/d1/types.tsx +14 -0
  98. package/src/d1/utils.ts +39 -0
  99. package/src/dev/dev-vars.ts +13 -13
  100. package/src/dev/dev.tsx +500 -353
  101. package/src/dev/get-local-persistence-path.tsx +31 -0
  102. package/src/dev/local.tsx +628 -290
  103. package/src/dev/remote.tsx +397 -197
  104. package/src/dev/start-server.ts +443 -0
  105. package/src/dev/use-esbuild.ts +173 -94
  106. package/src/dev/validate-dev-props.ts +31 -0
  107. package/src/dev-registry.tsx +190 -0
  108. package/src/dev.tsx +869 -0
  109. package/src/dialogs.tsx +134 -63
  110. package/src/dispatch-namespace.ts +206 -0
  111. package/src/durable.ts +102 -0
  112. package/src/entry.ts +248 -186
  113. package/src/environment-variables.ts +38 -23
  114. package/src/errors.ts +6 -6
  115. package/src/faye-websocket.d.ts +6 -0
  116. package/src/generate.ts +131 -0
  117. package/src/git-client.ts +42 -0
  118. package/src/global-wrangler-config-path.ts +26 -0
  119. package/src/https-options.ts +84 -80
  120. package/src/index.tsx +2288 -2534
  121. package/src/init.ts +967 -0
  122. package/src/inspect.ts +686 -562
  123. package/src/intl-polyfill.d.ts +123 -123
  124. package/src/is-ci.ts +14 -0
  125. package/src/is-interactive.ts +12 -0
  126. package/src/kv.ts +353 -242
  127. package/src/logger.ts +53 -39
  128. package/src/metrics/index.ts +5 -0
  129. package/src/metrics/metrics-config.ts +239 -0
  130. package/src/metrics/metrics-dispatcher.ts +96 -0
  131. package/src/metrics/metrics-usage-headers.ts +24 -0
  132. package/src/metrics/send-event.ts +93 -0
  133. package/src/miniflare-cli/assets.ts +215 -0
  134. package/src/miniflare-cli/index.ts +200 -33
  135. package/src/miniflare-cli/request-context.ts +18 -18
  136. package/src/module-collection.ts +212 -212
  137. package/src/open-in-browser.ts +5 -14
  138. package/src/package-manager.ts +182 -90
  139. package/src/pages/build.tsx +238 -0
  140. package/src/pages/constants.ts +16 -0
  141. package/src/pages/deployments.tsx +106 -0
  142. package/src/pages/dev.tsx +684 -0
  143. package/src/pages/errors.ts +66 -0
  144. package/src/pages/functions/buildPlugin.ts +110 -0
  145. package/src/pages/functions/buildWorker.ts +156 -0
  146. package/{pages → src/pages}/functions/filepath-routing.test.ts +113 -113
  147. package/src/pages/functions/filepath-routing.ts +189 -0
  148. package/src/pages/functions/identifiers.ts +78 -0
  149. package/src/pages/functions/routes-consolidation.test.ts +250 -0
  150. package/src/pages/functions/routes-consolidation.ts +73 -0
  151. package/src/pages/functions/routes-transformation.test.ts +282 -0
  152. package/src/pages/functions/routes-transformation.ts +115 -0
  153. package/src/pages/functions/routes-validation.test.ts +403 -0
  154. package/src/pages/functions/routes-validation.ts +202 -0
  155. package/src/pages/functions/routes.ts +151 -0
  156. package/src/pages/functions.tsx +82 -0
  157. package/src/pages/hash.tsx +13 -0
  158. package/src/pages/index.tsx +94 -0
  159. package/src/pages/projects.tsx +169 -0
  160. package/src/pages/publish.tsx +419 -0
  161. package/src/pages/types.ts +49 -0
  162. package/src/pages/upload.tsx +398 -0
  163. package/src/pages/utils.ts +12 -0
  164. package/src/parse.ts +223 -120
  165. package/src/paths.ts +53 -8
  166. package/src/preview.ts +31 -0
  167. package/src/proxy.ts +435 -383
  168. package/src/publish.ts +837 -441
  169. package/src/pubsub/index.ts +286 -0
  170. package/src/pubsub/pubsub-commands.tsx +623 -0
  171. package/src/r2.ts +100 -19
  172. package/src/selfsigned.d.ts +23 -23
  173. package/src/sites.tsx +279 -200
  174. package/src/tail/filters.ts +108 -110
  175. package/src/tail/index.ts +234 -218
  176. package/src/tail/printing.ts +86 -46
  177. package/src/update-check.ts +11 -11
  178. package/src/user/choose-account.tsx +69 -0
  179. package/src/user/env-vars.ts +46 -0
  180. package/src/user/generate-auth-url.ts +33 -0
  181. package/src/user/generate-random-state.ts +16 -0
  182. package/src/user/index.ts +3 -0
  183. package/src/user/user.tsx +1192 -0
  184. package/src/whoami.tsx +141 -42
  185. package/src/worker.ts +163 -101
  186. package/src/zones.ts +167 -0
  187. package/templates/checked-fetch.js +17 -0
  188. package/templates/d1-beta-facade.js +174 -0
  189. package/templates/experimental-local-cache-stubs.js +27 -0
  190. package/templates/first-party-worker-module-facade.ts +18 -0
  191. package/templates/format-dev-errors.ts +32 -0
  192. package/templates/init-tests/test-jest-new-worker.js +25 -0
  193. package/templates/init-tests/test-vitest-new-worker.js +26 -0
  194. package/templates/middleware/common.ts +62 -0
  195. package/templates/middleware/loader-modules.ts +84 -0
  196. package/templates/middleware/loader-sw.ts +213 -0
  197. package/templates/middleware/middleware-pretty-error.ts +40 -0
  198. package/templates/middleware/middleware-scheduled.ts +15 -0
  199. package/templates/new-worker-scheduled.js +17 -0
  200. package/templates/new-worker-scheduled.ts +32 -0
  201. package/templates/new-worker.js +3 -3
  202. package/templates/new-worker.ts +18 -3
  203. package/templates/no-op-worker.js +10 -0
  204. package/templates/pages-dev-pipeline.ts +35 -0
  205. package/templates/pages-shim.ts +9 -0
  206. package/templates/pages-template-plugin.ts +167 -0
  207. package/templates/pages-template-worker.ts +172 -0
  208. package/templates/serve-static-assets.ts +63 -0
  209. package/templates/service-bindings-module-facade.js +54 -0
  210. package/templates/service-bindings-sw-facade.js +42 -0
  211. package/templates/tsconfig.json +95 -95
  212. package/wrangler-dist/cli.d.ts +841 -0
  213. package/wrangler-dist/cli.js +120834 -70331
  214. package/pages/functions/buildPlugin.ts +0 -92
  215. package/pages/functions/buildWorker.ts +0 -138
  216. package/pages/functions/filepath-routing.ts +0 -189
  217. package/pages/functions/identifiers.ts +0 -78
  218. package/pages/functions/routes.ts +0 -156
  219. package/pages/functions/template-plugin.ts +0 -146
  220. package/pages/functions/template-worker.ts +0 -143
  221. package/src/__tests__/helpers/faye-websocket.d.ts +0 -6
  222. package/src/miniflare-cli/enum-keys.ts +0 -17
  223. package/src/pages.tsx +0 -1866
  224. package/src/user.tsx +0 -1193
  225. package/templates/static-asset-facade.js +0 -47
  226. package/vendor/@cloudflare/kv-asset-handler/CHANGELOG.md +0 -332
  227. package/vendor/@cloudflare/kv-asset-handler/LICENSE_APACHE +0 -176
  228. package/vendor/@cloudflare/kv-asset-handler/LICENSE_MIT +0 -25
  229. package/vendor/@cloudflare/kv-asset-handler/README.md +0 -245
  230. package/vendor/@cloudflare/kv-asset-handler/dist/index.d.ts +0 -32
  231. package/vendor/@cloudflare/kv-asset-handler/dist/index.js +0 -354
  232. package/vendor/@cloudflare/kv-asset-handler/dist/mocks.d.ts +0 -13
  233. package/vendor/@cloudflare/kv-asset-handler/dist/mocks.js +0 -148
  234. package/vendor/@cloudflare/kv-asset-handler/dist/test/getAssetFromKV.d.ts +0 -1
  235. package/vendor/@cloudflare/kv-asset-handler/dist/test/getAssetFromKV.js +0 -436
  236. package/vendor/@cloudflare/kv-asset-handler/dist/test/mapRequestToAsset.d.ts +0 -1
  237. package/vendor/@cloudflare/kv-asset-handler/dist/test/mapRequestToAsset.js +0 -40
  238. package/vendor/@cloudflare/kv-asset-handler/dist/test/serveSinglePageApp.d.ts +0 -1
  239. package/vendor/@cloudflare/kv-asset-handler/dist/test/serveSinglePageApp.js +0 -42
  240. package/vendor/@cloudflare/kv-asset-handler/dist/types.d.ts +0 -26
  241. package/vendor/@cloudflare/kv-asset-handler/dist/types.js +0 -31
  242. package/vendor/@cloudflare/kv-asset-handler/package.json +0 -52
  243. package/vendor/@cloudflare/kv-asset-handler/src/index.ts +0 -296
  244. package/vendor/@cloudflare/kv-asset-handler/src/mocks.ts +0 -136
  245. package/vendor/@cloudflare/kv-asset-handler/src/test/getAssetFromKV.ts +0 -464
  246. package/vendor/@cloudflare/kv-asset-handler/src/test/mapRequestToAsset.ts +0 -33
  247. package/vendor/@cloudflare/kv-asset-handler/src/test/serveSinglePageApp.ts +0 -42
  248. package/vendor/@cloudflare/kv-asset-handler/src/types.ts +0 -39
  249. package/vendor/wrangler-mime/CHANGELOG.md +0 -289
  250. package/vendor/wrangler-mime/LICENSE +0 -21
  251. package/vendor/wrangler-mime/Mime.js +0 -97
  252. package/vendor/wrangler-mime/README.md +0 -187
  253. package/vendor/wrangler-mime/cli.js +0 -46
  254. package/vendor/wrangler-mime/index.js +0 -4
  255. package/vendor/wrangler-mime/lite.js +0 -4
  256. package/vendor/wrangler-mime/package.json +0 -52
  257. package/vendor/wrangler-mime/types/other.js +0 -1
  258. package/vendor/wrangler-mime/types/standard.js +0 -1
package/src/whoami.tsx CHANGED
@@ -1,70 +1,169 @@
1
1
  import { Text, render } from "ink";
2
2
  import Table from "ink-table";
3
- import React from "react";
3
+ import React, { Fragment } from "react";
4
4
  import { fetchListResult, fetchResult } from "./cfetch";
5
5
  import { logger } from "./logger";
6
- import { getAPIToken } from "./user";
6
+ import { getAPIToken, getAuthFromEnv, getScopes } from "./user";
7
7
 
8
8
  export async function whoami() {
9
- logger.log("Getting User settings...");
10
- const user = await getUserInfo();
11
- render(<WhoAmI user={user}></WhoAmI>);
9
+ logger.log("Getting User settings...");
10
+ const user = await getUserInfo();
11
+ const { unmount } = render(<WhoAmI user={user}></WhoAmI>);
12
+ unmount();
12
13
  }
13
14
 
14
15
  export function WhoAmI({ user }: { user: UserInfo | undefined }) {
15
- return user ? (
16
- <>
17
- <Email tokenType={user.authType} email={user.email}></Email>
18
- <Accounts accounts={user.accounts}></Accounts>
19
- </>
20
- ) : (
21
- <Text>You are not authenticated. Please run `wrangler login`.</Text>
22
- );
16
+ return user ? (
17
+ <>
18
+ <Email tokenType={user.authType} email={user.email}></Email>
19
+ <Accounts accounts={user.accounts}></Accounts>
20
+ <Permissions
21
+ tokenType={user.authType}
22
+ tokenPermissions={user.tokenPermissions}
23
+ />
24
+ </>
25
+ ) : (
26
+ <Text>You are not authenticated. Please run `wrangler login`.</Text>
27
+ );
23
28
  }
24
29
 
25
- function Email(props: { tokenType: string; email: string }) {
26
- return (
27
- <Text>
28
- 👋 You are logged in with an {props.tokenType} Token, associated with the
29
- email &apos;{props.email}&apos;!
30
- </Text>
31
- );
30
+ function Email(props: { tokenType: string; email: string | undefined }) {
31
+ return props.email === undefined ? (
32
+ <Text>
33
+ 👋 You are logged in with an {props.tokenType}. Unable to retrieve email
34
+ for this user. Are you missing the `User-&gt;User Details-&gt;Read`
35
+ permission?
36
+ </Text>
37
+ ) : (
38
+ <Text>
39
+ 👋 You are logged in with an {props.tokenType}, associated with the email
40
+ &apos;{props.email}&apos;!
41
+ </Text>
42
+ );
32
43
  }
33
44
 
34
45
  function Accounts(props: { accounts: AccountInfo[] }) {
35
- const accounts = props.accounts.map((account) => ({
36
- "Account Name": account.name,
37
- "Account ID": account.id,
38
- }));
39
- return <Table data={accounts}></Table>;
46
+ const accounts = props.accounts.map((account) => ({
47
+ "Account Name": account.name,
48
+ "Account ID": account.id,
49
+ }));
50
+ return <Table data={accounts}></Table>;
51
+ }
52
+
53
+ function Permissions(props: {
54
+ tokenPermissions: string[] | undefined;
55
+ tokenType: string;
56
+ }) {
57
+ const permissions =
58
+ props.tokenPermissions?.map((scope) => scope.split(":")) || [];
59
+ return props.tokenType === "OAuth Token" ? (
60
+ props.tokenPermissions ? (
61
+ <>
62
+ <Text>
63
+ 🔓 Token Permissions: If scopes are missing, you may need to logout
64
+ and re-login.
65
+ </Text>
66
+ <Text>Scope (Access)</Text>
67
+ {permissions.map(([scope, access], index) => (
68
+ <Fragment key={`${scope}${index}`}>
69
+ <Text>
70
+ - {scope} {access && `(${access})`}
71
+ </Text>
72
+ </Fragment>
73
+ ))}
74
+ </>
75
+ ) : null
76
+ ) : (
77
+ <Text>
78
+ 🔓 To see token permissions visit
79
+ https://dash.cloudflare.com/profile/api-tokens
80
+ </Text>
81
+ );
40
82
  }
41
83
 
42
84
  export interface UserInfo {
43
- apiToken: string;
44
- authType: string;
45
- email: string;
46
- accounts: AccountInfo[];
85
+ apiToken: string;
86
+ authType: string;
87
+ email: string | undefined;
88
+ accounts: AccountInfo[];
89
+ tokenPermissions: string[] | undefined;
47
90
  }
48
91
 
49
92
  export async function getUserInfo(): Promise<UserInfo | undefined> {
50
- const apiToken = getAPIToken();
51
- return apiToken
52
- ? {
53
- apiToken,
54
- authType: "OAuth",
55
- email: await getEmail(),
56
- accounts: await getAccounts(),
57
- }
58
- : undefined;
93
+ const apiToken = getAPIToken();
94
+ if (!apiToken) return;
95
+
96
+ const tokenPermissions = await getTokenPermissions();
97
+
98
+ const usingEnvAuth = !!getAuthFromEnv();
99
+ const usingGlobalAuthKey = "authKey" in apiToken;
100
+ return {
101
+ apiToken: usingGlobalAuthKey ? apiToken.authKey : apiToken.apiToken,
102
+ authType: usingGlobalAuthKey
103
+ ? "Global API Key"
104
+ : usingEnvAuth
105
+ ? "API Token"
106
+ : "OAuth Token",
107
+ email: "authEmail" in apiToken ? apiToken.authEmail : await getEmail(),
108
+ accounts: await getAccounts(),
109
+ tokenPermissions,
110
+ };
59
111
  }
60
112
 
61
- async function getEmail(): Promise<string> {
62
- const { email } = await fetchResult<{ email: string }>("/user");
63
- return email;
113
+ async function getEmail(): Promise<string | undefined> {
114
+ try {
115
+ const { email } = await fetchResult<{ email: string }>("/user");
116
+ return email;
117
+ } catch (e) {
118
+ if ((e as { code?: number }).code === 9109) {
119
+ return undefined;
120
+ } else {
121
+ throw e;
122
+ }
123
+ }
64
124
  }
65
125
 
66
126
  type AccountInfo = { name: string; id: string };
67
127
 
68
128
  async function getAccounts(): Promise<AccountInfo[]> {
69
- return await fetchListResult<AccountInfo>("/accounts");
129
+ return await fetchListResult<AccountInfo>("/accounts");
130
+ }
131
+
132
+ async function getTokenPermissions(): Promise<string[] | undefined> {
133
+ // Tokens can either be API tokens or Oauth tokens.
134
+ // Here we only extract permissions from OAuth tokens.
135
+
136
+ return getScopes() as string[];
137
+
138
+ // In future we may be able to get the token permissions on an API token,
139
+ // but currently we cannot as that permission is not able to be added to
140
+ // an API token.
141
+
142
+ // try {
143
+ // // First we get the token identifier (only returned on API tokens)
144
+ // const { id } = await fetchResult<{ id: string }>("/user/tokens/verify");
145
+
146
+ // // Get the token permissions for the current token
147
+ // const { policies } = await fetchResult<{
148
+ // policies: { id: string; name: string }[];
149
+ // }>(`/user/tokens/${id}`);
150
+
151
+ // return policies.map((p) => p.name);
152
+ // } catch (e) {
153
+ // if ((e as { code?: number }).code === 1000) {
154
+ // // Invalid token - Oauth token
155
+
156
+ // // Get scopes
157
+ // const scopes = getScopes() as string[];
158
+ // // We may not get scopes back if they are not currently cached,
159
+ // // however next time an access token is requested,
160
+ // // the scopes will be added to the cache.
161
+ // return scopes;
162
+ // } else if ((e as { code?: number }).code === 9109) {
163
+ // // Token cannot view its permissions
164
+ // return undefined;
165
+ // } else {
166
+ // throw e;
167
+ // }
168
+ // }
70
169
  }
package/src/worker.ts CHANGED
@@ -1,17 +1,22 @@
1
+ import type { Environment } from "./config";
2
+ import type { Route } from "./config/environment";
3
+ import type { ApiCredentials } from "./user";
4
+
1
5
  /**
2
6
  * A Cloudflare account.
3
7
  */
8
+
4
9
  export interface CfAccount {
5
- /**
6
- * An API token.
7
- *
8
- * @link https://api.cloudflare.com/#user-api-tokens-properties
9
- */
10
- apiToken: string;
11
- /**
12
- * An account ID.
13
- */
14
- accountId: string;
10
+ /**
11
+ * An API token.
12
+ *
13
+ * @link https://api.cloudflare.com/#user-api-tokens-properties
14
+ */
15
+ apiToken: ApiCredentials;
16
+ /**
17
+ * An account ID.
18
+ */
19
+ accountId: string;
15
20
  }
16
21
 
17
22
  /**
@@ -23,150 +28,207 @@ export type CfScriptFormat = "modules" | "service-worker";
23
28
  * A module type.
24
29
  */
25
30
  export type CfModuleType =
26
- | "esm"
27
- | "commonjs"
28
- | "compiled-wasm"
29
- | "text"
30
- | "buffer";
31
+ | "esm"
32
+ | "commonjs"
33
+ | "compiled-wasm"
34
+ | "text"
35
+ | "buffer";
31
36
 
32
37
  /**
33
38
  * An imported module.
34
39
  */
35
40
  export interface CfModule {
36
- /**
37
- * The module name.
38
- *
39
- * @example
40
- * './src/index.js'
41
- */
42
- name: string;
43
- /**
44
- * The module content, usually JavaScript or WASM code.
45
- *
46
- * @example
47
- * export default {
48
- * async fetch(request) {
49
- * return new Response('Ok')
50
- * }
51
- * }
52
- */
53
- content: string | Buffer;
54
- /**
55
- * The module type.
56
- *
57
- * If absent, will default to the main module's type.
58
- */
59
- type?: CfModuleType;
41
+ /**
42
+ * The module name.
43
+ *
44
+ * @example
45
+ * './src/index.js'
46
+ */
47
+ name: string;
48
+ /**
49
+ * The module content, usually JavaScript or WASM code.
50
+ *
51
+ * @example
52
+ * export default {
53
+ * async fetch(request) {
54
+ * return new Response('Ok')
55
+ * }
56
+ * }
57
+ */
58
+ content: string | Buffer;
59
+ /**
60
+ * The module type.
61
+ *
62
+ * If absent, will default to the main module's type.
63
+ */
64
+ type?: CfModuleType;
60
65
  }
61
66
 
62
67
  /**
63
68
  * A map of variable names to values.
64
69
  */
65
- interface CfVars {
66
- [key: string]: unknown;
70
+ export interface CfVars {
71
+ [key: string]: unknown;
67
72
  }
68
73
 
69
74
  /**
70
75
  * A KV namespace.
71
76
  */
72
- interface CfKvNamespace {
73
- binding: string;
74
- id: string;
77
+ export interface CfKvNamespace {
78
+ binding: string;
79
+ id: string;
75
80
  }
76
81
 
77
82
  /**
78
83
  * A binding to a wasm module (in service-worker format)
79
84
  */
80
85
 
81
- interface CfWasmModuleBindings {
82
- [key: string]: string;
86
+ export interface CfWasmModuleBindings {
87
+ [key: string]: string;
83
88
  }
84
89
 
85
90
  /**
86
91
  * A binding to a text blob (in service-worker format)
87
92
  */
88
93
 
89
- interface CfTextBlobBindings {
90
- [key: string]: string;
94
+ export interface CfTextBlobBindings {
95
+ [key: string]: string;
91
96
  }
92
97
 
93
98
  /**
94
99
  * A binding to a data blob (in service-worker format)
95
100
  */
96
101
 
97
- interface CfDataBlobBindings {
98
- [key: string]: string;
102
+ export interface CfDataBlobBindings {
103
+ [key: string]: string;
99
104
  }
100
105
 
101
106
  /**
102
107
  * A Durable Object.
103
108
  */
104
- interface CfDurableObject {
105
- name: string;
106
- class_name: string;
107
- script_name?: string;
109
+ export interface CfDurableObject {
110
+ name: string;
111
+ class_name: string;
112
+ script_name?: string;
113
+ environment?: string;
114
+ }
115
+
116
+ export interface CfR2Bucket {
117
+ binding: string;
118
+ bucket_name: string;
119
+ }
120
+
121
+ export const D1_BETA_PREFIX = `__D1_BETA__` as const;
122
+ export type D1PrefixedBinding = `${typeof D1_BETA_PREFIX}${string}`;
123
+
124
+ export interface CfD1Database {
125
+ // For now, all D1 bindings are beta
126
+ binding: D1PrefixedBinding;
127
+ database_id: string;
128
+ database_name?: string;
129
+ preview_database_id?: string;
130
+ }
131
+
132
+ interface CfService {
133
+ binding: string;
134
+ service: string;
135
+ environment?: string;
108
136
  }
109
137
 
110
- interface CfR2Bucket {
111
- binding: string;
112
- bucket_name: string;
138
+ interface CfDispatchNamespace {
139
+ binding: string;
140
+ namespace: string;
141
+ }
142
+
143
+ interface CfLogfwdr {
144
+ schema: string | undefined;
145
+ bindings: CfLogfwdrBinding[];
146
+ }
147
+
148
+ interface CfLogfwdrBinding {
149
+ name: string;
150
+ destination: string;
113
151
  }
114
152
 
115
153
  interface CfUnsafeBinding {
116
- name: string;
117
- type: string;
154
+ name: string;
155
+ type: string;
118
156
  }
119
157
 
120
158
  export interface CfDurableObjectMigrations {
121
- old_tag?: string;
122
- new_tag: string;
123
- steps: {
124
- new_classes?: string[];
125
- renamed_classes?: {
126
- from: string;
127
- to: string;
128
- }[];
129
- deleted_classes?: string[];
130
- }[];
159
+ old_tag?: string;
160
+ new_tag: string;
161
+ steps: {
162
+ new_classes?: string[];
163
+ renamed_classes?: {
164
+ from: string;
165
+ to: string;
166
+ }[];
167
+ deleted_classes?: string[];
168
+ }[];
131
169
  }
132
170
 
133
171
  /**
134
172
  * Options for creating a `CfWorker`.
135
173
  */
136
174
  export interface CfWorkerInit {
137
- /**
138
- * The name of the worker.
139
- */
140
- name: string | undefined;
141
- /**
142
- * The entrypoint module.
143
- */
144
- main: CfModule;
145
- /**
146
- * The list of additional modules.
147
- */
148
- modules: CfModule[] | undefined;
149
- /**
150
- * All the bindings
151
- */
152
- bindings: {
153
- vars: CfVars | undefined;
154
- kv_namespaces: CfKvNamespace[] | undefined;
155
- wasm_modules: CfWasmModuleBindings | undefined;
156
- text_blobs: CfTextBlobBindings | undefined;
157
- data_blobs: CfDataBlobBindings | undefined;
158
- durable_objects: { bindings: CfDurableObject[] } | undefined;
159
- r2_buckets: CfR2Bucket[] | undefined;
160
- unsafe: CfUnsafeBinding[] | undefined;
161
- };
162
- migrations: CfDurableObjectMigrations | undefined;
163
- compatibility_date: string | undefined;
164
- compatibility_flags: string[] | undefined;
165
- usage_model: "bundled" | "unbound" | undefined;
175
+ /**
176
+ * The name of the worker.
177
+ */
178
+ name: string | undefined;
179
+ /**
180
+ * The entrypoint module.
181
+ */
182
+ main: CfModule;
183
+ /**
184
+ * The list of additional modules.
185
+ */
186
+ modules: CfModule[] | undefined;
187
+ /**
188
+ * All the bindings
189
+ */
190
+ bindings: {
191
+ vars: CfVars | undefined;
192
+ kv_namespaces: CfKvNamespace[] | undefined;
193
+ wasm_modules: CfWasmModuleBindings | undefined;
194
+ text_blobs: CfTextBlobBindings | undefined;
195
+ data_blobs: CfDataBlobBindings | undefined;
196
+ durable_objects: { bindings: CfDurableObject[] } | undefined;
197
+ r2_buckets: CfR2Bucket[] | undefined;
198
+ d1_databases: CfD1Database[] | undefined;
199
+ services: CfService[] | undefined;
200
+ dispatch_namespaces: CfDispatchNamespace[] | undefined;
201
+ logfwdr: CfLogfwdr | undefined;
202
+ unsafe: CfUnsafeBinding[] | undefined;
203
+ };
204
+ migrations: CfDurableObjectMigrations | undefined;
205
+ compatibility_date: string | undefined;
206
+ compatibility_flags: string[] | undefined;
207
+ usage_model: "bundled" | "unbound" | undefined;
208
+ keepVars: boolean | undefined;
166
209
  }
167
210
 
168
211
  export interface CfWorkerContext {
169
- env: string | undefined;
170
- legacyEnv: boolean | undefined;
171
- zone: { id: string; host: string } | undefined;
212
+ env: string | undefined;
213
+ legacyEnv: boolean | undefined;
214
+ zone: string | undefined;
215
+ host: string | undefined;
216
+ routes: Route[] | undefined;
217
+ sendMetrics: boolean | undefined;
218
+ }
219
+
220
+ // Prefix binding with identifier which will then get picked up by the D1 shim.
221
+ // Once the D1 Api is out of beta, this function can be removed.
222
+ export function identifyD1BindingsAsBeta(
223
+ dbs: Environment["d1_databases"]
224
+ ): CfD1Database[] | undefined {
225
+ return dbs?.map((db) => ({
226
+ ...db,
227
+ binding: `${D1_BETA_PREFIX}${db.binding}`,
228
+ }));
229
+ }
230
+
231
+ // Remove beta prefix
232
+ export function removeD1BetaPrefix(binding: D1PrefixedBinding): string {
233
+ return binding.slice(D1_BETA_PREFIX.length);
172
234
  }