@geekmidas/testkit 10.0.0-alpha.14 → 10.0.0-alpha.141

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 (72) hide show
  1. package/README.md +85 -0
  2. package/dist/KyselyFactory.d.cts.map +1 -1
  3. package/dist/KyselyFactory.d.mts.map +1 -1
  4. package/dist/ObjectionFactory.d.cts.map +1 -1
  5. package/dist/ObjectionFactory.d.mts.map +1 -1
  6. package/dist/PostgresKyselyMigrator.d.cts +1 -1
  7. package/dist/PostgresKyselyMigrator.d.cts.map +1 -1
  8. package/dist/PostgresKyselyMigrator.d.mts +1 -1
  9. package/dist/PostgresKyselyMigrator.d.mts.map +1 -1
  10. package/dist/{PostgresMigrator-CoHQ95cT.d.cts → PostgresMigrator-CDPnnwMJ.d.cts} +10 -3
  11. package/dist/PostgresMigrator-CDPnnwMJ.d.cts.map +1 -0
  12. package/dist/{PostgresMigrator-CoHQ95cT.d.mts → PostgresMigrator-CDPnnwMJ.d.mts} +10 -3
  13. package/dist/PostgresMigrator-CDPnnwMJ.d.mts.map +1 -0
  14. package/dist/PostgresMigrator.cjs +14 -5
  15. package/dist/PostgresMigrator.cjs.map +1 -1
  16. package/dist/PostgresMigrator.d.cts +1 -1
  17. package/dist/PostgresMigrator.d.mts +1 -1
  18. package/dist/PostgresMigrator.mjs +14 -5
  19. package/dist/PostgresMigrator.mjs.map +1 -1
  20. package/dist/PostgresObjectionMigrator.d.cts +1 -1
  21. package/dist/PostgresObjectionMigrator.d.cts.map +1 -1
  22. package/dist/PostgresObjectionMigrator.d.mts +1 -1
  23. package/dist/PostgresObjectionMigrator.d.mts.map +1 -1
  24. package/dist/VitestTransactionIsolator.d.cts.map +1 -1
  25. package/dist/VitestTransactionIsolator.d.mts.map +1 -1
  26. package/dist/better-auth.d.cts.map +1 -1
  27. package/dist/better-auth.d.mts.map +1 -1
  28. package/dist/browser.cjs +211 -0
  29. package/dist/browser.cjs.map +1 -0
  30. package/dist/browser.d.cts +113 -0
  31. package/dist/browser.d.cts.map +1 -0
  32. package/dist/browser.d.mts +113 -0
  33. package/dist/browser.d.mts.map +1 -0
  34. package/dist/browser.mjs +207 -0
  35. package/dist/browser.mjs.map +1 -0
  36. package/dist/context.cjs +80 -0
  37. package/dist/context.cjs.map +1 -0
  38. package/dist/context.d.cts +55 -0
  39. package/dist/context.d.cts.map +1 -0
  40. package/dist/context.d.mts +55 -0
  41. package/dist/context.d.mts.map +1 -0
  42. package/dist/context.mjs +73 -0
  43. package/dist/context.mjs.map +1 -0
  44. package/dist/faker.cjs +51 -0
  45. package/dist/faker.cjs.map +1 -1
  46. package/dist/faker.d.cts +26 -19
  47. package/dist/faker.d.cts.map +1 -1
  48. package/dist/faker.d.mts +26 -19
  49. package/dist/faker.d.mts.map +1 -1
  50. package/dist/faker.mjs +51 -1
  51. package/dist/faker.mjs.map +1 -1
  52. package/dist/mailbox.cjs +93 -0
  53. package/dist/mailbox.cjs.map +1 -0
  54. package/dist/mailbox.d.cts +52 -0
  55. package/dist/mailbox.d.cts.map +1 -0
  56. package/dist/mailbox.d.mts +52 -0
  57. package/dist/mailbox.d.mts.map +1 -0
  58. package/dist/mailbox.mjs +90 -0
  59. package/dist/mailbox.mjs.map +1 -0
  60. package/dist/requestContext.d.cts.map +1 -1
  61. package/dist/requestContext.d.mts.map +1 -1
  62. package/dist/transactions.cjs +239 -0
  63. package/dist/transactions.cjs.map +1 -0
  64. package/dist/transactions.d.cts +44 -0
  65. package/dist/transactions.d.cts.map +1 -0
  66. package/dist/transactions.d.mts +44 -0
  67. package/dist/transactions.d.mts.map +1 -0
  68. package/dist/transactions.mjs +234 -0
  69. package/dist/transactions.mjs.map +1 -0
  70. package/package.json +57 -8
  71. package/dist/PostgresMigrator-CoHQ95cT.d.cts.map +0 -1
  72. package/dist/PostgresMigrator-CoHQ95cT.d.mts.map +0 -1
@@ -0,0 +1,211 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ const require_context = require("./context.cjs");
3
+ let node_crypto = require("node:crypto");
4
+ let tough_cookie = require("tough-cookie");
5
+ //#region src/browser.ts
6
+ /**
7
+ * A browser, for tests: a `fetch` that keeps cookies the way a browser does.
8
+ *
9
+ * An app's real clients — its typed API client, better-auth's client — run on
10
+ * whatever `fetch` they are given. Give them this one and a test signs in the
11
+ * way a person does: the auth server's `Set-Cookie` lands in the jar, and every
12
+ * later request to a URL the cookie belongs to carries it. The jar follows the
13
+ * browser's rules (RFC 6265 — Domain, Path, Secure, Expires), so a cookie set
14
+ * for the wrong domain is not sent, exactly as a browser would not send it.
15
+ *
16
+ * Extend it once per app with that app's clients:
17
+ *
18
+ * ```ts
19
+ * export class Browser extends TestBrowser {
20
+ * readonly api = createApi({ baseURL: process.env.API_URL, fetch: this.fetch });
21
+ * }
22
+ * ```
23
+ */
24
+ /** How many redirects `fetch` follows before giving up, as browsers do. */
25
+ const MAX_REDIRECTS = 20;
26
+ var Browser = class {
27
+ /** The cookies this browser holds. */
28
+ jar;
29
+ /**
30
+ * The page this browser is on, sent as `Origin` — what a surface's CORS
31
+ * and an auth server's trusted origins check, and what a multi-tenant app
32
+ * reads its tenant from. None until {@link Browser.on} gives it one.
33
+ */
34
+ origin;
35
+ /**
36
+ * The address this browser connects from, sent as `x-forwarded-for` the way
37
+ * a proxy in front of the app adds it. Each browser is a different person on
38
+ * a different connection, so what an app keys by client — an auth server's
39
+ * rate limit — counts each on its own. Without it every browser was the same
40
+ * client, and concurrent tests queued on the same rate-limit row of each
41
+ * other's open transactions. A request that sets the header itself — a test
42
+ * that is several machines — keeps its own.
43
+ */
44
+ address;
45
+ /**
46
+ * This browser's `fetch`: cookies from the jar on the way out, `Set-Cookie`
47
+ * into the jar on the way back, redirects followed hop by hop so each hop's
48
+ * cookies are kept.
49
+ *
50
+ * On the server side of a test — a handler serving a request — it is the
51
+ * plain `fetch`: a server forwards what it was handed and never reaches into
52
+ * a browser's jar.
53
+ */
54
+ fetch;
55
+ send;
56
+ site;
57
+ constructor(options = {}) {
58
+ this.send = options.fetch ?? globalThis.fetch;
59
+ this.address = options.address ?? privateAddress();
60
+ this.jar = options.jar ?? new tough_cookie.CookieJar();
61
+ if (options.site) this.site = options.site;
62
+ if (options.origin) this.origin = options.origin;
63
+ this.fetch = (input, init) => {
64
+ if (require_context.currentTestContext()?.side === "server") return this.send(input, init);
65
+ return this.start(new Request(input, init), init?.redirect);
66
+ };
67
+ }
68
+ /**
69
+ * Open a URL the way clicking a link does: a GET, redirects followed. A
70
+ * path is opened on the page this browser is on.
71
+ */
72
+ visit(url) {
73
+ return this.fetch(this.origin ? new URL(url, this.origin).toString() : String(url));
74
+ }
75
+ /**
76
+ * The same person on a tenant's host: this browser — its cookies, its
77
+ * address, its clients — on `https://<slug>.<domain>`, the app's site on
78
+ * every subdomain. Each request it makes says so in `Origin`, as a page on
79
+ * that host would, so a test signs in once and calls the app as two
80
+ * tenants:
81
+ *
82
+ * ```ts
83
+ * await browser.signIn();
84
+ * await browser.on('acme').api.post('/orders', { body });
85
+ * expect(await browser.on('globex').api.get('/orders')).toEqual([]);
86
+ * ```
87
+ */
88
+ on(slug) {
89
+ if (!this.site) throw new NoWildcardSite(slug);
90
+ if (!SLUG.test(slug)) throw new NotATenantSlug(slug);
91
+ const origin = new URL(this.site.replace("*", slug)).origin;
92
+ const Same = this.constructor;
93
+ return new Same({
94
+ fetch: this.send,
95
+ address: this.address,
96
+ jar: this.jar,
97
+ site: this.site,
98
+ origin
99
+ });
100
+ }
101
+ /** The cookies this browser would send to `url`, as a header value. */
102
+ cookieHeader(url) {
103
+ return this.jar.getCookieString(String(url));
104
+ }
105
+ /**
106
+ * Make this browser the global `fetch`, for code that uses the global one —
107
+ * an app's module-level clients. Returns what puts the previous one back.
108
+ */
109
+ install() {
110
+ const previous = globalThis.fetch;
111
+ globalThis.fetch = this.fetch;
112
+ return () => {
113
+ globalThis.fetch = previous;
114
+ };
115
+ }
116
+ /** Read the body once, so a redirect that keeps the method can send it again. */
117
+ async start(request, redirect) {
118
+ const body = request.method === "GET" || request.method === "HEAD" ? void 0 : await request.arrayBuffer();
119
+ const headers = new Headers(request.headers);
120
+ if (!headers.has("x-forwarded-for")) headers.set("x-forwarded-for", this.address);
121
+ if (this.origin && !headers.has("origin")) headers.set("origin", this.origin);
122
+ return this.request({
123
+ url: request.url,
124
+ method: request.method,
125
+ headers,
126
+ body
127
+ }, redirect);
128
+ }
129
+ async request(request, redirect, hops = 0) {
130
+ const headers = new Headers(request.headers);
131
+ const cookie = await this.jar.getCookieString(request.url);
132
+ if (cookie) {
133
+ const existing = headers.get("cookie");
134
+ headers.set("cookie", existing ? `${existing}; ${cookie}` : cookie);
135
+ }
136
+ const response = await this.send(request.url, {
137
+ method: request.method,
138
+ headers,
139
+ body: request.body,
140
+ redirect: "manual"
141
+ });
142
+ for (const set of response.headers.getSetCookie()) await this.jar.setCookie(set, request.url, { ignoreError: true });
143
+ const location = response.headers.get("location");
144
+ if (redirect === "manual" || !location || response.status < 300 || response.status >= 400) return response;
145
+ if (hops >= MAX_REDIRECTS) throw new TooManyRedirects(request.url, MAX_REDIRECTS);
146
+ const keepsMethod = response.status === 307 || response.status === 308 || request.method === "GET" || request.method === "HEAD";
147
+ const url = new URL(location, request.url).toString();
148
+ const next = keepsMethod ? {
149
+ ...request,
150
+ url
151
+ } : {
152
+ url,
153
+ method: "GET",
154
+ headers: withoutBody(request.headers)
155
+ };
156
+ return this.request(next, redirect, hops + 1);
157
+ }
158
+ };
159
+ /** Headers for a request that no longer carries the body they described. */
160
+ function withoutBody(headers) {
161
+ const next = new Headers(headers);
162
+ next.delete("content-type");
163
+ next.delete("content-length");
164
+ return next;
165
+ }
166
+ /** A redirect chain longer than any browser follows. */
167
+ var TooManyRedirects = class extends Error {
168
+ url;
169
+ limit;
170
+ constructor(url, limit) {
171
+ super(`${url} redirected more than ${limit} times. A browser gives up here too — look for a redirect loop.`);
172
+ this.url = url;
173
+ this.limit = limit;
174
+ this.name = "TooManyRedirects";
175
+ }
176
+ };
177
+ /** One DNS label, as a tenant's slug is. */
178
+ const SLUG = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
179
+ /** `browser.on(slug)` in an app with no site on every subdomain. */
180
+ var NoWildcardSite = class extends Error {
181
+ slug;
182
+ constructor(slug) {
183
+ super(`browser.on('${slug}') puts a tenant's slug into the app's site on every subdomain, and this browser knows of none. Declare a StaticSite with subdomain: '*', or pass its address as \`site\`.`);
184
+ this.slug = slug;
185
+ this.name = "NoWildcardSite";
186
+ }
187
+ };
188
+ /** `browser.on(slug)` with something no host can start with. */
189
+ var NotATenantSlug = class extends Error {
190
+ slug;
191
+ constructor(slug) {
192
+ super(`'${slug}' is not a tenant's slug: one DNS label of lowercase letters, digits and inner hyphens, such as 'acme'.`);
193
+ this.slug = slug;
194
+ this.name = "NotATenantSlug";
195
+ }
196
+ };
197
+ /**
198
+ * An address from 10.0.0.0/8, which nothing routes to. Random rather than
199
+ * counted: test files run in separate workers that share no counter.
200
+ */
201
+ function privateAddress() {
202
+ const n = (0, node_crypto.randomInt)(1, 2 ** 24 - 1);
203
+ return `10.${n >> 16 & 255}.${n >> 8 & 255}.${n & 255}`;
204
+ }
205
+ //#endregion
206
+ exports.Browser = Browser;
207
+ exports.NoWildcardSite = NoWildcardSite;
208
+ exports.NotATenantSlug = NotATenantSlug;
209
+ exports.TooManyRedirects = TooManyRedirects;
210
+
211
+ //# sourceMappingURL=browser.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.cjs","names":["CookieJar","currentTestContext","randomInt"],"sources":["../src/browser.ts"],"sourcesContent":["/**\n * A browser, for tests: a `fetch` that keeps cookies the way a browser does.\n *\n * An app's real clients — its typed API client, better-auth's client — run on\n * whatever `fetch` they are given. Give them this one and a test signs in the\n * way a person does: the auth server's `Set-Cookie` lands in the jar, and every\n * later request to a URL the cookie belongs to carries it. The jar follows the\n * browser's rules (RFC 6265 — Domain, Path, Secure, Expires), so a cookie set\n * for the wrong domain is not sent, exactly as a browser would not send it.\n *\n * Extend it once per app with that app's clients:\n *\n * ```ts\n * export class Browser extends TestBrowser {\n * readonly api = createApi({ baseURL: process.env.API_URL, fetch: this.fetch });\n * }\n * ```\n */\n\nimport { randomInt } from 'node:crypto';\nimport { CookieJar } from 'tough-cookie';\nimport { currentTestContext } from './context';\n\n/** How many redirects `fetch` follows before giving up, as browsers do. */\nconst MAX_REDIRECTS = 20;\n\nexport interface BrowserOptions {\n\t/**\n\t * The `fetch` requests go out on. Defaults to the global one at the time\n\t * the browser is created — so a browser made inside a test goes through\n\t * whatever the test installed (MSW, the context stamp) and never through\n\t * itself once installed.\n\t */\n\tfetch?: typeof fetch;\n\t/**\n\t * The address this browser connects from. A fresh one by default, from a\n\t * private range nothing routes to — see {@link Browser.address}.\n\t */\n\taddress?: string;\n\t/**\n\t * The cookies it starts with — another browser's jar, to be the same\n\t * person on another tab. A fresh jar by default.\n\t */\n\tjar?: CookieJar;\n\t/**\n\t * The address of the app's site on every subdomain,\n\t * `https://*.test.shop.localhost:8443`, which {@link Browser.on} puts a\n\t * tenant's slug into. A feature test passes it when the app declares one.\n\t */\n\tsite?: string;\n\t/**\n\t * The page this browser is on: sent as `Origin` on every request that does\n\t * not set its own, and what a relative {@link Browser.visit} resolves\n\t * against. See {@link Browser.on}.\n\t */\n\torigin?: string;\n}\n\nexport class Browser {\n\t/** The cookies this browser holds. */\n\treadonly jar: CookieJar;\n\n\t/**\n\t * The page this browser is on, sent as `Origin` — what a surface's CORS\n\t * and an auth server's trusted origins check, and what a multi-tenant app\n\t * reads its tenant from. None until {@link Browser.on} gives it one.\n\t */\n\treadonly origin?: string;\n\n\t/**\n\t * The address this browser connects from, sent as `x-forwarded-for` the way\n\t * a proxy in front of the app adds it. Each browser is a different person on\n\t * a different connection, so what an app keys by client — an auth server's\n\t * rate limit — counts each on its own. Without it every browser was the same\n\t * client, and concurrent tests queued on the same rate-limit row of each\n\t * other's open transactions. A request that sets the header itself — a test\n\t * that is several machines — keeps its own.\n\t */\n\treadonly address: string;\n\n\t/**\n\t * This browser's `fetch`: cookies from the jar on the way out, `Set-Cookie`\n\t * into the jar on the way back, redirects followed hop by hop so each hop's\n\t * cookies are kept.\n\t *\n\t * On the server side of a test — a handler serving a request — it is the\n\t * plain `fetch`: a server forwards what it was handed and never reaches into\n\t * a browser's jar.\n\t */\n\treadonly fetch: typeof fetch;\n\n\tprivate readonly send: typeof fetch;\n\tprivate readonly site?: string;\n\n\tconstructor(options: BrowserOptions = {}) {\n\t\tthis.send = options.fetch ?? globalThis.fetch;\n\t\tthis.address = options.address ?? privateAddress();\n\t\tthis.jar = options.jar ?? new CookieJar();\n\t\tif (options.site) this.site = options.site;\n\t\tif (options.origin) this.origin = options.origin;\n\t\tthis.fetch = (input, init) => {\n\t\t\tif (currentTestContext()?.side === 'server') {\n\t\t\t\treturn this.send(input, init);\n\t\t\t}\n\t\t\treturn this.start(new Request(input, init), init?.redirect);\n\t\t};\n\t}\n\n\t/**\n\t * Open a URL the way clicking a link does: a GET, redirects followed. A\n\t * path is opened on the page this browser is on.\n\t */\n\tvisit(url: string | URL): Promise<Response> {\n\t\treturn this.fetch(\n\t\t\tthis.origin ? new URL(url, this.origin).toString() : String(url),\n\t\t);\n\t}\n\n\t/**\n\t * The same person on a tenant's host: this browser — its cookies, its\n\t * address, its clients — on `https://<slug>.<domain>`, the app's site on\n\t * every subdomain. Each request it makes says so in `Origin`, as a page on\n\t * that host would, so a test signs in once and calls the app as two\n\t * tenants:\n\t *\n\t * ```ts\n\t * await browser.signIn();\n\t * await browser.on('acme').api.post('/orders', { body });\n\t * expect(await browser.on('globex').api.get('/orders')).toEqual([]);\n\t * ```\n\t */\n\ton(slug: string): this {\n\t\tif (!this.site) throw new NoWildcardSite(slug);\n\t\tif (!SLUG.test(slug)) throw new NotATenantSlug(slug);\n\n\t\tconst origin = new URL(this.site.replace('*', slug)).origin;\n\t\tconst Same = this.constructor as new (options: BrowserOptions) => this;\n\t\treturn new Same({\n\t\t\tfetch: this.send,\n\t\t\taddress: this.address,\n\t\t\tjar: this.jar,\n\t\t\tsite: this.site,\n\t\t\torigin,\n\t\t});\n\t}\n\n\t/** The cookies this browser would send to `url`, as a header value. */\n\tcookieHeader(url: string | URL): Promise<string> {\n\t\treturn this.jar.getCookieString(String(url));\n\t}\n\n\t/**\n\t * Make this browser the global `fetch`, for code that uses the global one —\n\t * an app's module-level clients. Returns what puts the previous one back.\n\t */\n\tinstall(): () => void {\n\t\tconst previous = globalThis.fetch;\n\t\tglobalThis.fetch = this.fetch;\n\t\treturn () => {\n\t\t\tglobalThis.fetch = previous;\n\t\t};\n\t}\n\n\t/** Read the body once, so a redirect that keeps the method can send it again. */\n\tprivate async start(\n\t\trequest: Request,\n\t\tredirect: RequestInit['redirect'],\n\t): Promise<Response> {\n\t\tconst body =\n\t\t\trequest.method === 'GET' || request.method === 'HEAD'\n\t\t\t\t? undefined\n\t\t\t\t: await request.arrayBuffer();\n\t\tconst headers = new Headers(request.headers);\n\t\tif (!headers.has('x-forwarded-for')) {\n\t\t\theaders.set('x-forwarded-for', this.address);\n\t\t}\n\t\tif (this.origin && !headers.has('origin')) {\n\t\t\theaders.set('origin', this.origin);\n\t\t}\n\t\treturn this.request(\n\t\t\t{ url: request.url, method: request.method, headers, body },\n\t\t\tredirect,\n\t\t);\n\t}\n\n\tprivate async request(\n\t\trequest: Hop,\n\t\tredirect: RequestInit['redirect'],\n\t\thops = 0,\n\t): Promise<Response> {\n\t\tconst headers = new Headers(request.headers);\n\t\tconst cookie = await this.jar.getCookieString(request.url);\n\t\tif (cookie) {\n\t\t\tconst existing = headers.get('cookie');\n\t\t\theaders.set('cookie', existing ? `${existing}; ${cookie}` : cookie);\n\t\t}\n\n\t\tconst response = await this.send(request.url, {\n\t\t\tmethod: request.method,\n\t\t\theaders,\n\t\t\tbody: request.body,\n\t\t\tredirect: 'manual',\n\t\t});\n\n\t\tfor (const set of response.headers.getSetCookie()) {\n\t\t\t// A cookie a browser would refuse — the wrong domain, Secure over\n\t\t\t// plain HTTP — is dropped silently, as a browser drops it.\n\t\t\tawait this.jar.setCookie(set, request.url, { ignoreError: true });\n\t\t}\n\n\t\tconst location = response.headers.get('location');\n\t\tif (\n\t\t\tredirect === 'manual' ||\n\t\t\t!location ||\n\t\t\tresponse.status < 300 ||\n\t\t\tresponse.status >= 400\n\t\t) {\n\t\t\treturn response;\n\t\t}\n\n\t\tif (hops >= MAX_REDIRECTS) {\n\t\t\tthrow new TooManyRedirects(request.url, MAX_REDIRECTS);\n\t\t}\n\n\t\t// 303, and 301/302 after a POST, continue as a GET without a body — what\n\t\t// every browser does, whatever the spec once said about 302.\n\t\tconst keepsMethod =\n\t\t\tresponse.status === 307 ||\n\t\t\tresponse.status === 308 ||\n\t\t\trequest.method === 'GET' ||\n\t\t\trequest.method === 'HEAD';\n\n\t\tconst url = new URL(location, request.url).toString();\n\t\tconst next: Hop = keepsMethod\n\t\t\t? { ...request, url }\n\t\t\t: { url, method: 'GET', headers: withoutBody(request.headers) };\n\n\t\treturn this.request(next, redirect, hops + 1);\n\t}\n}\n\n/** One request in a redirect chain, with its body already read. */\ninterface Hop {\n\turl: string;\n\tmethod: string;\n\theaders: Headers;\n\tbody?: ArrayBuffer;\n}\n\n/** Headers for a request that no longer carries the body they described. */\nfunction withoutBody(headers: Headers): Headers {\n\tconst next = new Headers(headers);\n\tnext.delete('content-type');\n\tnext.delete('content-length');\n\treturn next;\n}\n\n/** A redirect chain longer than any browser follows. */\nexport class TooManyRedirects extends Error {\n\tconstructor(\n\t\treadonly url: string,\n\t\treadonly limit: number,\n\t) {\n\t\tsuper(\n\t\t\t`${url} redirected more than ${limit} times. A browser gives up here ` +\n\t\t\t\t`too — look for a redirect loop.`,\n\t\t);\n\t\tthis.name = 'TooManyRedirects';\n\t}\n}\n\n/** One DNS label, as a tenant's slug is. */\nconst SLUG = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;\n\n/** `browser.on(slug)` in an app with no site on every subdomain. */\nexport class NoWildcardSite extends Error {\n\tconstructor(readonly slug: string) {\n\t\tsuper(\n\t\t\t`browser.on('${slug}') puts a tenant's slug into the app's site on ` +\n\t\t\t\t`every subdomain, and this browser knows of none. Declare a ` +\n\t\t\t\t`StaticSite with subdomain: '*', or pass its address as \\`site\\`.`,\n\t\t);\n\t\tthis.name = 'NoWildcardSite';\n\t}\n}\n\n/** `browser.on(slug)` with something no host can start with. */\nexport class NotATenantSlug extends Error {\n\tconstructor(readonly slug: string) {\n\t\tsuper(\n\t\t\t`'${slug}' is not a tenant's slug: one DNS label of lowercase ` +\n\t\t\t\t`letters, digits and inner hyphens, such as 'acme'.`,\n\t\t);\n\t\tthis.name = 'NotATenantSlug';\n\t}\n}\n\n/**\n * An address from 10.0.0.0/8, which nothing routes to. Random rather than\n * counted: test files run in separate workers that share no counter.\n */\nfunction privateAddress(): string {\n\tconst n = randomInt(1, 2 ** 24 - 1);\n\treturn `10.${(n >> 16) & 255}.${(n >> 8) & 255}.${n & 255}`;\n}\n"],"mappings":"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"}
@@ -0,0 +1,113 @@
1
+ import { CookieJar } from "tough-cookie";
2
+ //#region src/browser.d.ts
3
+ export interface BrowserOptions {
4
+ /**
5
+ * The `fetch` requests go out on. Defaults to the global one at the time
6
+ * the browser is created — so a browser made inside a test goes through
7
+ * whatever the test installed (MSW, the context stamp) and never through
8
+ * itself once installed.
9
+ */
10
+ fetch?: typeof fetch;
11
+ /**
12
+ * The address this browser connects from. A fresh one by default, from a
13
+ * private range nothing routes to — see {@link Browser.address}.
14
+ */
15
+ address?: string;
16
+ /**
17
+ * The cookies it starts with — another browser's jar, to be the same
18
+ * person on another tab. A fresh jar by default.
19
+ */
20
+ jar?: CookieJar;
21
+ /**
22
+ * The address of the app's site on every subdomain,
23
+ * `https://*.test.shop.localhost:8443`, which {@link Browser.on} puts a
24
+ * tenant's slug into. A feature test passes it when the app declares one.
25
+ */
26
+ site?: string;
27
+ /**
28
+ * The page this browser is on: sent as `Origin` on every request that does
29
+ * not set its own, and what a relative {@link Browser.visit} resolves
30
+ * against. See {@link Browser.on}.
31
+ */
32
+ origin?: string;
33
+ }
34
+ export declare class Browser {
35
+ /** The cookies this browser holds. */
36
+ readonly jar: CookieJar;
37
+ /**
38
+ * The page this browser is on, sent as `Origin` — what a surface's CORS
39
+ * and an auth server's trusted origins check, and what a multi-tenant app
40
+ * reads its tenant from. None until {@link Browser.on} gives it one.
41
+ */
42
+ readonly origin?: string;
43
+ /**
44
+ * The address this browser connects from, sent as `x-forwarded-for` the way
45
+ * a proxy in front of the app adds it. Each browser is a different person on
46
+ * a different connection, so what an app keys by client — an auth server's
47
+ * rate limit — counts each on its own. Without it every browser was the same
48
+ * client, and concurrent tests queued on the same rate-limit row of each
49
+ * other's open transactions. A request that sets the header itself — a test
50
+ * that is several machines — keeps its own.
51
+ */
52
+ readonly address: string;
53
+ /**
54
+ * This browser's `fetch`: cookies from the jar on the way out, `Set-Cookie`
55
+ * into the jar on the way back, redirects followed hop by hop so each hop's
56
+ * cookies are kept.
57
+ *
58
+ * On the server side of a test — a handler serving a request — it is the
59
+ * plain `fetch`: a server forwards what it was handed and never reaches into
60
+ * a browser's jar.
61
+ */
62
+ readonly fetch: typeof fetch;
63
+ private readonly send;
64
+ private readonly site?;
65
+ constructor(options?: BrowserOptions);
66
+ /**
67
+ * Open a URL the way clicking a link does: a GET, redirects followed. A
68
+ * path is opened on the page this browser is on.
69
+ */
70
+ visit(url: string | URL): Promise<Response>;
71
+ /**
72
+ * The same person on a tenant's host: this browser — its cookies, its
73
+ * address, its clients — on `https://<slug>.<domain>`, the app's site on
74
+ * every subdomain. Each request it makes says so in `Origin`, as a page on
75
+ * that host would, so a test signs in once and calls the app as two
76
+ * tenants:
77
+ *
78
+ * ```ts
79
+ * await browser.signIn();
80
+ * await browser.on('acme').api.post('/orders', { body });
81
+ * expect(await browser.on('globex').api.get('/orders')).toEqual([]);
82
+ * ```
83
+ */
84
+ on(slug: string): this;
85
+ /** The cookies this browser would send to `url`, as a header value. */
86
+ cookieHeader(url: string | URL): Promise<string>;
87
+ /**
88
+ * Make this browser the global `fetch`, for code that uses the global one —
89
+ * an app's module-level clients. Returns what puts the previous one back.
90
+ */
91
+ install(): () => void;
92
+ /** Read the body once, so a redirect that keeps the method can send it again. */
93
+ private start;
94
+ private request;
95
+ }
96
+ /** A redirect chain longer than any browser follows. */
97
+ export declare class TooManyRedirects extends Error {
98
+ readonly url: string;
99
+ readonly limit: number;
100
+ constructor(url: string, limit: number);
101
+ }
102
+ /** `browser.on(slug)` in an app with no site on every subdomain. */
103
+ export declare class NoWildcardSite extends Error {
104
+ readonly slug: string;
105
+ constructor(slug: string);
106
+ }
107
+ /** `browser.on(slug)` with something no host can start with. */
108
+ export declare class NotATenantSlug extends Error {
109
+ readonly slug: string;
110
+ constructor(slug: string);
111
+ }
112
+ //#endregion
113
+ //# sourceMappingURL=browser.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.d.cts","names":[],"sources":["../src/browser.ts"],"mappings":";;iBA0BiB;;;;;;;EAOhB,eAAe;;;;;EAKf;;;;;EAKA,MAAM;;;;;;EAMN;;;;;;EAMA;;qBAGY;;WAEH,KAAK;;;;;;WAOL;;;;;;;;;;WAWA;;;;;;;;;;WAWA,cAAc;mBAEN;mBACA;EAEjB,YAAY,UAAS;;;;;EAkBrB,MAAM,cAAc,MAAM,QAAQ;;;;;;;;;;;;;;EAmBlC,GAAG;;EAgBH,aAAa,cAAc,MAAM;;;;;EAQjC;;UASc;UAqBA;;;qBAyEF,yBAAyB;WAE3B;WACA;EAFV,YACU,aACA;;;qBAcE,uBAAuB;WACd;EAArB,YAAqB;;;qBAWT,uBAAuB;WACd;EAArB,YAAqB"}
@@ -0,0 +1,113 @@
1
+ import { CookieJar } from "tough-cookie";
2
+ //#region src/browser.d.ts
3
+ export interface BrowserOptions {
4
+ /**
5
+ * The `fetch` requests go out on. Defaults to the global one at the time
6
+ * the browser is created — so a browser made inside a test goes through
7
+ * whatever the test installed (MSW, the context stamp) and never through
8
+ * itself once installed.
9
+ */
10
+ fetch?: typeof fetch;
11
+ /**
12
+ * The address this browser connects from. A fresh one by default, from a
13
+ * private range nothing routes to — see {@link Browser.address}.
14
+ */
15
+ address?: string;
16
+ /**
17
+ * The cookies it starts with — another browser's jar, to be the same
18
+ * person on another tab. A fresh jar by default.
19
+ */
20
+ jar?: CookieJar;
21
+ /**
22
+ * The address of the app's site on every subdomain,
23
+ * `https://*.test.shop.localhost:8443`, which {@link Browser.on} puts a
24
+ * tenant's slug into. A feature test passes it when the app declares one.
25
+ */
26
+ site?: string;
27
+ /**
28
+ * The page this browser is on: sent as `Origin` on every request that does
29
+ * not set its own, and what a relative {@link Browser.visit} resolves
30
+ * against. See {@link Browser.on}.
31
+ */
32
+ origin?: string;
33
+ }
34
+ export declare class Browser {
35
+ /** The cookies this browser holds. */
36
+ readonly jar: CookieJar;
37
+ /**
38
+ * The page this browser is on, sent as `Origin` — what a surface's CORS
39
+ * and an auth server's trusted origins check, and what a multi-tenant app
40
+ * reads its tenant from. None until {@link Browser.on} gives it one.
41
+ */
42
+ readonly origin?: string;
43
+ /**
44
+ * The address this browser connects from, sent as `x-forwarded-for` the way
45
+ * a proxy in front of the app adds it. Each browser is a different person on
46
+ * a different connection, so what an app keys by client — an auth server's
47
+ * rate limit — counts each on its own. Without it every browser was the same
48
+ * client, and concurrent tests queued on the same rate-limit row of each
49
+ * other's open transactions. A request that sets the header itself — a test
50
+ * that is several machines — keeps its own.
51
+ */
52
+ readonly address: string;
53
+ /**
54
+ * This browser's `fetch`: cookies from the jar on the way out, `Set-Cookie`
55
+ * into the jar on the way back, redirects followed hop by hop so each hop's
56
+ * cookies are kept.
57
+ *
58
+ * On the server side of a test — a handler serving a request — it is the
59
+ * plain `fetch`: a server forwards what it was handed and never reaches into
60
+ * a browser's jar.
61
+ */
62
+ readonly fetch: typeof fetch;
63
+ private readonly send;
64
+ private readonly site?;
65
+ constructor(options?: BrowserOptions);
66
+ /**
67
+ * Open a URL the way clicking a link does: a GET, redirects followed. A
68
+ * path is opened on the page this browser is on.
69
+ */
70
+ visit(url: string | URL): Promise<Response>;
71
+ /**
72
+ * The same person on a tenant's host: this browser — its cookies, its
73
+ * address, its clients — on `https://<slug>.<domain>`, the app's site on
74
+ * every subdomain. Each request it makes says so in `Origin`, as a page on
75
+ * that host would, so a test signs in once and calls the app as two
76
+ * tenants:
77
+ *
78
+ * ```ts
79
+ * await browser.signIn();
80
+ * await browser.on('acme').api.post('/orders', { body });
81
+ * expect(await browser.on('globex').api.get('/orders')).toEqual([]);
82
+ * ```
83
+ */
84
+ on(slug: string): this;
85
+ /** The cookies this browser would send to `url`, as a header value. */
86
+ cookieHeader(url: string | URL): Promise<string>;
87
+ /**
88
+ * Make this browser the global `fetch`, for code that uses the global one —
89
+ * an app's module-level clients. Returns what puts the previous one back.
90
+ */
91
+ install(): () => void;
92
+ /** Read the body once, so a redirect that keeps the method can send it again. */
93
+ private start;
94
+ private request;
95
+ }
96
+ /** A redirect chain longer than any browser follows. */
97
+ export declare class TooManyRedirects extends Error {
98
+ readonly url: string;
99
+ readonly limit: number;
100
+ constructor(url: string, limit: number);
101
+ }
102
+ /** `browser.on(slug)` in an app with no site on every subdomain. */
103
+ export declare class NoWildcardSite extends Error {
104
+ readonly slug: string;
105
+ constructor(slug: string);
106
+ }
107
+ /** `browser.on(slug)` with something no host can start with. */
108
+ export declare class NotATenantSlug extends Error {
109
+ readonly slug: string;
110
+ constructor(slug: string);
111
+ }
112
+ //#endregion
113
+ //# sourceMappingURL=browser.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.d.mts","names":[],"sources":["../src/browser.ts"],"mappings":";;iBA0BiB;;;;;;;EAOhB,eAAe;;;;;EAKf;;;;;EAKA,MAAM;;;;;;EAMN;;;;;;EAMA;;qBAGY;;WAEH,KAAK;;;;;;WAOL;;;;;;;;;;WAWA;;;;;;;;;;WAWA,cAAc;mBAEN;mBACA;EAEjB,YAAY,UAAS;;;;;EAkBrB,MAAM,cAAc,MAAM,QAAQ;;;;;;;;;;;;;;EAmBlC,GAAG;;EAgBH,aAAa,cAAc,MAAM;;;;;EAQjC;;UASc;UAqBA;;;qBAyEF,yBAAyB;WAE3B;WACA;EAFV,YACU,aACA;;;qBAcE,uBAAuB;WACd;EAArB,YAAqB;;;qBAWT,uBAAuB;WACd;EAArB,YAAqB"}
@@ -0,0 +1,207 @@
1
+ import { currentTestContext } from "./context.mjs";
2
+ import { randomInt } from "node:crypto";
3
+ import { CookieJar } from "tough-cookie";
4
+ //#region src/browser.ts
5
+ /**
6
+ * A browser, for tests: a `fetch` that keeps cookies the way a browser does.
7
+ *
8
+ * An app's real clients — its typed API client, better-auth's client — run on
9
+ * whatever `fetch` they are given. Give them this one and a test signs in the
10
+ * way a person does: the auth server's `Set-Cookie` lands in the jar, and every
11
+ * later request to a URL the cookie belongs to carries it. The jar follows the
12
+ * browser's rules (RFC 6265 — Domain, Path, Secure, Expires), so a cookie set
13
+ * for the wrong domain is not sent, exactly as a browser would not send it.
14
+ *
15
+ * Extend it once per app with that app's clients:
16
+ *
17
+ * ```ts
18
+ * export class Browser extends TestBrowser {
19
+ * readonly api = createApi({ baseURL: process.env.API_URL, fetch: this.fetch });
20
+ * }
21
+ * ```
22
+ */
23
+ /** How many redirects `fetch` follows before giving up, as browsers do. */
24
+ const MAX_REDIRECTS = 20;
25
+ var Browser = class {
26
+ /** The cookies this browser holds. */
27
+ jar;
28
+ /**
29
+ * The page this browser is on, sent as `Origin` — what a surface's CORS
30
+ * and an auth server's trusted origins check, and what a multi-tenant app
31
+ * reads its tenant from. None until {@link Browser.on} gives it one.
32
+ */
33
+ origin;
34
+ /**
35
+ * The address this browser connects from, sent as `x-forwarded-for` the way
36
+ * a proxy in front of the app adds it. Each browser is a different person on
37
+ * a different connection, so what an app keys by client — an auth server's
38
+ * rate limit — counts each on its own. Without it every browser was the same
39
+ * client, and concurrent tests queued on the same rate-limit row of each
40
+ * other's open transactions. A request that sets the header itself — a test
41
+ * that is several machines — keeps its own.
42
+ */
43
+ address;
44
+ /**
45
+ * This browser's `fetch`: cookies from the jar on the way out, `Set-Cookie`
46
+ * into the jar on the way back, redirects followed hop by hop so each hop's
47
+ * cookies are kept.
48
+ *
49
+ * On the server side of a test — a handler serving a request — it is the
50
+ * plain `fetch`: a server forwards what it was handed and never reaches into
51
+ * a browser's jar.
52
+ */
53
+ fetch;
54
+ send;
55
+ site;
56
+ constructor(options = {}) {
57
+ this.send = options.fetch ?? globalThis.fetch;
58
+ this.address = options.address ?? privateAddress();
59
+ this.jar = options.jar ?? new CookieJar();
60
+ if (options.site) this.site = options.site;
61
+ if (options.origin) this.origin = options.origin;
62
+ this.fetch = (input, init) => {
63
+ if (currentTestContext()?.side === "server") return this.send(input, init);
64
+ return this.start(new Request(input, init), init?.redirect);
65
+ };
66
+ }
67
+ /**
68
+ * Open a URL the way clicking a link does: a GET, redirects followed. A
69
+ * path is opened on the page this browser is on.
70
+ */
71
+ visit(url) {
72
+ return this.fetch(this.origin ? new URL(url, this.origin).toString() : String(url));
73
+ }
74
+ /**
75
+ * The same person on a tenant's host: this browser — its cookies, its
76
+ * address, its clients — on `https://<slug>.<domain>`, the app's site on
77
+ * every subdomain. Each request it makes says so in `Origin`, as a page on
78
+ * that host would, so a test signs in once and calls the app as two
79
+ * tenants:
80
+ *
81
+ * ```ts
82
+ * await browser.signIn();
83
+ * await browser.on('acme').api.post('/orders', { body });
84
+ * expect(await browser.on('globex').api.get('/orders')).toEqual([]);
85
+ * ```
86
+ */
87
+ on(slug) {
88
+ if (!this.site) throw new NoWildcardSite(slug);
89
+ if (!SLUG.test(slug)) throw new NotATenantSlug(slug);
90
+ const origin = new URL(this.site.replace("*", slug)).origin;
91
+ const Same = this.constructor;
92
+ return new Same({
93
+ fetch: this.send,
94
+ address: this.address,
95
+ jar: this.jar,
96
+ site: this.site,
97
+ origin
98
+ });
99
+ }
100
+ /** The cookies this browser would send to `url`, as a header value. */
101
+ cookieHeader(url) {
102
+ return this.jar.getCookieString(String(url));
103
+ }
104
+ /**
105
+ * Make this browser the global `fetch`, for code that uses the global one —
106
+ * an app's module-level clients. Returns what puts the previous one back.
107
+ */
108
+ install() {
109
+ const previous = globalThis.fetch;
110
+ globalThis.fetch = this.fetch;
111
+ return () => {
112
+ globalThis.fetch = previous;
113
+ };
114
+ }
115
+ /** Read the body once, so a redirect that keeps the method can send it again. */
116
+ async start(request, redirect) {
117
+ const body = request.method === "GET" || request.method === "HEAD" ? void 0 : await request.arrayBuffer();
118
+ const headers = new Headers(request.headers);
119
+ if (!headers.has("x-forwarded-for")) headers.set("x-forwarded-for", this.address);
120
+ if (this.origin && !headers.has("origin")) headers.set("origin", this.origin);
121
+ return this.request({
122
+ url: request.url,
123
+ method: request.method,
124
+ headers,
125
+ body
126
+ }, redirect);
127
+ }
128
+ async request(request, redirect, hops = 0) {
129
+ const headers = new Headers(request.headers);
130
+ const cookie = await this.jar.getCookieString(request.url);
131
+ if (cookie) {
132
+ const existing = headers.get("cookie");
133
+ headers.set("cookie", existing ? `${existing}; ${cookie}` : cookie);
134
+ }
135
+ const response = await this.send(request.url, {
136
+ method: request.method,
137
+ headers,
138
+ body: request.body,
139
+ redirect: "manual"
140
+ });
141
+ for (const set of response.headers.getSetCookie()) await this.jar.setCookie(set, request.url, { ignoreError: true });
142
+ const location = response.headers.get("location");
143
+ if (redirect === "manual" || !location || response.status < 300 || response.status >= 400) return response;
144
+ if (hops >= MAX_REDIRECTS) throw new TooManyRedirects(request.url, MAX_REDIRECTS);
145
+ const keepsMethod = response.status === 307 || response.status === 308 || request.method === "GET" || request.method === "HEAD";
146
+ const url = new URL(location, request.url).toString();
147
+ const next = keepsMethod ? {
148
+ ...request,
149
+ url
150
+ } : {
151
+ url,
152
+ method: "GET",
153
+ headers: withoutBody(request.headers)
154
+ };
155
+ return this.request(next, redirect, hops + 1);
156
+ }
157
+ };
158
+ /** Headers for a request that no longer carries the body they described. */
159
+ function withoutBody(headers) {
160
+ const next = new Headers(headers);
161
+ next.delete("content-type");
162
+ next.delete("content-length");
163
+ return next;
164
+ }
165
+ /** A redirect chain longer than any browser follows. */
166
+ var TooManyRedirects = class extends Error {
167
+ url;
168
+ limit;
169
+ constructor(url, limit) {
170
+ super(`${url} redirected more than ${limit} times. A browser gives up here too — look for a redirect loop.`);
171
+ this.url = url;
172
+ this.limit = limit;
173
+ this.name = "TooManyRedirects";
174
+ }
175
+ };
176
+ /** One DNS label, as a tenant's slug is. */
177
+ const SLUG = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
178
+ /** `browser.on(slug)` in an app with no site on every subdomain. */
179
+ var NoWildcardSite = class extends Error {
180
+ slug;
181
+ constructor(slug) {
182
+ super(`browser.on('${slug}') puts a tenant's slug into the app's site on every subdomain, and this browser knows of none. Declare a StaticSite with subdomain: '*', or pass its address as \`site\`.`);
183
+ this.slug = slug;
184
+ this.name = "NoWildcardSite";
185
+ }
186
+ };
187
+ /** `browser.on(slug)` with something no host can start with. */
188
+ var NotATenantSlug = class extends Error {
189
+ slug;
190
+ constructor(slug) {
191
+ super(`'${slug}' is not a tenant's slug: one DNS label of lowercase letters, digits and inner hyphens, such as 'acme'.`);
192
+ this.slug = slug;
193
+ this.name = "NotATenantSlug";
194
+ }
195
+ };
196
+ /**
197
+ * An address from 10.0.0.0/8, which nothing routes to. Random rather than
198
+ * counted: test files run in separate workers that share no counter.
199
+ */
200
+ function privateAddress() {
201
+ const n = randomInt(1, 2 ** 24 - 1);
202
+ return `10.${n >> 16 & 255}.${n >> 8 & 255}.${n & 255}`;
203
+ }
204
+ //#endregion
205
+ export { Browser, NoWildcardSite, NotATenantSlug, TooManyRedirects };
206
+
207
+ //# sourceMappingURL=browser.mjs.map