kinde-testkit 0.3.0 → 0.4.0

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.
@@ -23,6 +23,39 @@ interface ActiveFailure {
23
23
  hits: number;
24
24
  }
25
25
 
26
+ type WebhookInvalidKind = "bad-signature" | "unknown-key" | "unsigned" | "stale";
27
+ type WebhookSource = "admin" | "api" | "user";
28
+ interface SendWebhookOptions {
29
+ type: string;
30
+ data?: Record<string, unknown>;
31
+ user?: string;
32
+ organization?: string;
33
+ role?: string;
34
+ permission?: string;
35
+ source?: WebhookSource;
36
+ ipAddress?: string;
37
+ to?: string;
38
+ duplicate?: number;
39
+ delayMs?: number;
40
+ invalid?: WebhookInvalidKind;
41
+ }
42
+ interface WebhookAttempt {
43
+ attempt: number;
44
+ status: number | null;
45
+ error: string | null;
46
+ durationMs: number;
47
+ }
48
+ interface WebhookDelivery {
49
+ webhookId: string;
50
+ eventId: string;
51
+ type: string;
52
+ url: string;
53
+ copy: number;
54
+ delivered: boolean;
55
+ attempts: WebhookAttempt[];
56
+ payload: Record<string, unknown>;
57
+ }
58
+
26
59
  interface KindeFixtureOptions {
27
60
  issuer: string;
28
61
  loginPath: string;
@@ -39,6 +72,7 @@ interface KindeFixture {
39
72
  signOut(): Promise<void>;
40
73
  injectFailure(rule: FailureRule): Promise<ActiveFailure>;
41
74
  clearFailures(): Promise<void>;
75
+ sendWebhook(options: SendWebhookOptions): Promise<WebhookDelivery[]>;
42
76
  }
43
77
  interface ManagedKindeFixture extends KindeFixture {
44
78
  dispose(): Promise<void>;
@@ -66,6 +66,10 @@ function createKindeFixture(page, options) {
66
66
  await Promise.all([...injected].map((id) => control(`/testkit/failures/${id}`, { method: "DELETE" })));
67
67
  injected.clear();
68
68
  },
69
+ async sendWebhook(webhook) {
70
+ const response = await control("/testkit/webhooks", { method: "POST", body: JSON.stringify(webhook) });
71
+ return await response.json();
72
+ },
69
73
  async dispose() {
70
74
  if (injected.size > 0) await this.clearFailures();
71
75
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/playwright.ts"],"sourcesContent":["import { test as base, expect, type Page } from \"@playwright/test\";\nimport type { ActiveFailure, FailureRule } from \"./failures.js\";\n\nexport interface KindeFixtureOptions {\n issuer: string;\n loginPath: string;\n logoutPath: string;\n}\n\nexport interface SignInOptions {\n org?: string;\n}\n\nexport interface KindeFixture {\n readonly issuer: string;\n readonly currentUser: string | null;\n signInAs(user: string, options?: SignInOptions): Promise<void>;\n switchOrganization(org: string): Promise<void>;\n signOut(): Promise<void>;\n injectFailure(rule: FailureRule): Promise<ActiveFailure>;\n clearFailures(): Promise<void>;\n}\n\ninterface ManagedKindeFixture extends KindeFixture {\n dispose(): Promise<void>;\n}\n\nexport interface KindeTestOptions {\n kindeIssuer: string;\n kindeLoginPath: string;\n kindeLogoutPath: string;\n}\n\nexport function createKindeFixture(page: Page, options: KindeFixtureOptions): ManagedKindeFixture {\n const issuer = new URL(options.issuer);\n const onIssuer = (url: URL) => url.origin === issuer.origin;\n let currentUser: string | null = null;\n const injected = new Set<string>();\n\n async function control(path: string, init: RequestInit = {}): Promise<Response> {\n const response = await fetch(`${issuer.origin}${path}`, {\n ...init,\n headers: { \"content-type\": \"application/json\", ...(init.headers ?? {}) },\n });\n if (!response.ok && response.status !== 404) {\n const body = (await response.json().catch(() => ({}))) as { error_description?: string };\n throw new Error(body.error_description ?? `kinde-testkit answered ${response.status} for ${path}.`);\n }\n return response;\n }\n\n async function signInAs(user: string, signIn: SignInOptions = {}): Promise<void> {\n const params = new URLSearchParams({ login_hint: user });\n if (signIn.org) params.set(\"org_code\", signIn.org);\n await page.goto(`${options.loginPath}?${params}`);\n\n if (!(onIssuer(new URL(page.url())) && new URL(page.url()).pathname === \"/oauth2/auth\")) {\n throw new Error(\n `Expected ${options.loginPath} to redirect to the kinde-testkit sign-in page at ${issuer.origin}, but the browser is at ${page.url()}. Check that the app's KINDE_ISSUER_URL is ${issuer.origin}.`,\n );\n }\n\n await page.getByLabel(\"Email\").fill(user);\n await page.getByRole(\"button\", { name: \"Continue\", exact: true }).click();\n await page.waitForURL((url) => !(onIssuer(url) && url.pathname === \"/oauth2/auth\"));\n\n const landed = new URL(page.url());\n if (onIssuer(landed)) {\n const alert = page.getByRole(\"alert\");\n if (await alert.count()) {\n throw new Error(`kinde-testkit refused the sign-in: ${(await alert.innerText()).trim()}`);\n }\n if (await page.getByRole(\"heading\", { name: \"Choose an organization\" }).count()) {\n throw new Error(`${user} belongs to more than one organization. Pass one with signInAs(\"${user}\", { org: \"org_...\" }).`);\n }\n throw new Error(`Sign-in stopped on ${page.url()}.`);\n }\n\n await page.waitForURL((url) => !onIssuer(url) && !url.pathname.endsWith(\"/kinde_callback\"));\n currentUser = user;\n }\n\n return {\n issuer: issuer.origin,\n get currentUser() {\n return currentUser;\n },\n signInAs,\n async switchOrganization(org: string) {\n if (!currentUser) throw new Error(\"Call signInAs() before switchOrganization().\");\n await signInAs(currentUser, { org });\n },\n async signOut() {\n await page.goto(options.logoutPath);\n currentUser = null;\n },\n async injectFailure(rule: FailureRule) {\n const response = await control(\"/testkit/failures\", { method: \"POST\", body: JSON.stringify(rule) });\n const failure = (await response.json()) as ActiveFailure;\n injected.add(failure.id);\n return failure;\n },\n async clearFailures() {\n await Promise.all([...injected].map((id) => control(`/testkit/failures/${id}`, { method: \"DELETE\" })));\n injected.clear();\n },\n async dispose() {\n if (injected.size > 0) await this.clearFailures();\n },\n };\n}\n\nexport const test = base.extend<KindeTestOptions & { kinde: KindeFixture }>({\n kindeIssuer: [process.env.KINDE_ISSUER_URL ?? \"http://localhost:4400\", { option: true }],\n kindeLoginPath: [\"/api/auth/login\", { option: true }],\n kindeLogoutPath: [\"/api/auth/logout\", { option: true }],\n kinde: async ({ page, kindeIssuer, kindeLoginPath, kindeLogoutPath }, use) => {\n const fixture = createKindeFixture(page, {\n issuer: kindeIssuer,\n loginPath: kindeLoginPath,\n logoutPath: kindeLogoutPath,\n });\n await use(fixture);\n await fixture.dispose();\n },\n});\n\nexport { expect };\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/playwright.ts"],"sourcesContent":["import { test as base, expect, type Page } from \"@playwright/test\";\nimport type { ActiveFailure, FailureRule } from \"./failures.js\";\nimport type { SendWebhookOptions, WebhookDelivery } from \"./webhooks.js\";\n\nexport interface KindeFixtureOptions {\n issuer: string;\n loginPath: string;\n logoutPath: string;\n}\n\nexport interface SignInOptions {\n org?: string;\n}\n\nexport interface KindeFixture {\n readonly issuer: string;\n readonly currentUser: string | null;\n signInAs(user: string, options?: SignInOptions): Promise<void>;\n switchOrganization(org: string): Promise<void>;\n signOut(): Promise<void>;\n injectFailure(rule: FailureRule): Promise<ActiveFailure>;\n clearFailures(): Promise<void>;\n sendWebhook(options: SendWebhookOptions): Promise<WebhookDelivery[]>;\n}\n\ninterface ManagedKindeFixture extends KindeFixture {\n dispose(): Promise<void>;\n}\n\nexport interface KindeTestOptions {\n kindeIssuer: string;\n kindeLoginPath: string;\n kindeLogoutPath: string;\n}\n\nexport function createKindeFixture(page: Page, options: KindeFixtureOptions): ManagedKindeFixture {\n const issuer = new URL(options.issuer);\n const onIssuer = (url: URL) => url.origin === issuer.origin;\n let currentUser: string | null = null;\n const injected = new Set<string>();\n\n async function control(path: string, init: RequestInit = {}): Promise<Response> {\n const response = await fetch(`${issuer.origin}${path}`, {\n ...init,\n headers: { \"content-type\": \"application/json\", ...(init.headers ?? {}) },\n });\n if (!response.ok && response.status !== 404) {\n const body = (await response.json().catch(() => ({}))) as { error_description?: string };\n throw new Error(body.error_description ?? `kinde-testkit answered ${response.status} for ${path}.`);\n }\n return response;\n }\n\n async function signInAs(user: string, signIn: SignInOptions = {}): Promise<void> {\n const params = new URLSearchParams({ login_hint: user });\n if (signIn.org) params.set(\"org_code\", signIn.org);\n await page.goto(`${options.loginPath}?${params}`);\n\n if (!(onIssuer(new URL(page.url())) && new URL(page.url()).pathname === \"/oauth2/auth\")) {\n throw new Error(\n `Expected ${options.loginPath} to redirect to the kinde-testkit sign-in page at ${issuer.origin}, but the browser is at ${page.url()}. Check that the app's KINDE_ISSUER_URL is ${issuer.origin}.`,\n );\n }\n\n await page.getByLabel(\"Email\").fill(user);\n await page.getByRole(\"button\", { name: \"Continue\", exact: true }).click();\n await page.waitForURL((url) => !(onIssuer(url) && url.pathname === \"/oauth2/auth\"));\n\n const landed = new URL(page.url());\n if (onIssuer(landed)) {\n const alert = page.getByRole(\"alert\");\n if (await alert.count()) {\n throw new Error(`kinde-testkit refused the sign-in: ${(await alert.innerText()).trim()}`);\n }\n if (await page.getByRole(\"heading\", { name: \"Choose an organization\" }).count()) {\n throw new Error(`${user} belongs to more than one organization. Pass one with signInAs(\"${user}\", { org: \"org_...\" }).`);\n }\n throw new Error(`Sign-in stopped on ${page.url()}.`);\n }\n\n await page.waitForURL((url) => !onIssuer(url) && !url.pathname.endsWith(\"/kinde_callback\"));\n currentUser = user;\n }\n\n return {\n issuer: issuer.origin,\n get currentUser() {\n return currentUser;\n },\n signInAs,\n async switchOrganization(org: string) {\n if (!currentUser) throw new Error(\"Call signInAs() before switchOrganization().\");\n await signInAs(currentUser, { org });\n },\n async signOut() {\n await page.goto(options.logoutPath);\n currentUser = null;\n },\n async injectFailure(rule: FailureRule) {\n const response = await control(\"/testkit/failures\", { method: \"POST\", body: JSON.stringify(rule) });\n const failure = (await response.json()) as ActiveFailure;\n injected.add(failure.id);\n return failure;\n },\n async clearFailures() {\n await Promise.all([...injected].map((id) => control(`/testkit/failures/${id}`, { method: \"DELETE\" })));\n injected.clear();\n },\n async sendWebhook(webhook: SendWebhookOptions) {\n const response = await control(\"/testkit/webhooks\", { method: \"POST\", body: JSON.stringify(webhook) });\n return (await response.json()) as WebhookDelivery[];\n },\n async dispose() {\n if (injected.size > 0) await this.clearFailures();\n },\n };\n}\n\nexport const test = base.extend<KindeTestOptions & { kinde: KindeFixture }>({\n kindeIssuer: [process.env.KINDE_ISSUER_URL ?? \"http://localhost:4400\", { option: true }],\n kindeLoginPath: [\"/api/auth/login\", { option: true }],\n kindeLogoutPath: [\"/api/auth/logout\", { option: true }],\n kinde: async ({ page, kindeIssuer, kindeLoginPath, kindeLogoutPath }, use) => {\n const fixture = createKindeFixture(page, {\n issuer: kindeIssuer,\n loginPath: kindeLoginPath,\n logoutPath: kindeLogoutPath,\n });\n await use(fixture);\n await fixture.dispose();\n },\n});\n\nexport { expect };\n"],"mappings":"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","names":[]}
package/dist/vitest.d.ts CHANGED
@@ -19,6 +19,21 @@ interface KindeRole {
19
19
  key: string;
20
20
  name: string;
21
21
  }
22
+ interface KindeApplication {
23
+ clientId: string;
24
+ clientSecret: string | null;
25
+ name: string;
26
+ organizationCode: string | null;
27
+ scopes: string[] | null;
28
+ permissions: string[] | null;
29
+ audience: string[] | null;
30
+ }
31
+ interface KindeMembership {
32
+ userId: string;
33
+ organizationCode: string;
34
+ roles: string[];
35
+ permissions: string[];
36
+ }
22
37
  interface AuthenticatedScenario {
23
38
  kind: "authenticated";
24
39
  user: KindeUser;
@@ -114,6 +129,7 @@ declare class KindeTestkit {
114
129
  idTokenFor(scenario: Scenario, options?: IdTokenOptions): Promise<string | null>;
115
130
  headersFor(scenario: Scenario, overrides?: ScenarioTokenOverrides): Promise<Record<string, string>>;
116
131
  principalFor(scenario: Scenario): KindePrincipal | null;
132
+ signPayload(payload: Record<string, unknown>, invalid?: "bad-signature" | "unknown-key" | "unsigned"): Promise<string>;
117
133
  private sign;
118
134
  private stranger;
119
135
  }
@@ -142,6 +158,10 @@ interface TestkitSeed {
142
158
  roles?: string[];
143
159
  permissions?: string[];
144
160
  }>;
161
+ webhooks?: Array<{
162
+ url: string;
163
+ events?: string[];
164
+ }>;
145
165
  applications?: Array<{
146
166
  clientId: string;
147
167
  clientSecret?: string;
@@ -152,6 +172,16 @@ interface TestkitSeed {
152
172
  audience?: string | string[];
153
173
  }>;
154
174
  }
175
+ interface ResolvedSeed {
176
+ users: KindeUser[];
177
+ organizations: KindeOrganization[];
178
+ memberships: KindeMembership[];
179
+ applications: KindeApplication[];
180
+ webhooks: Array<{
181
+ url: string;
182
+ events?: string[];
183
+ }>;
184
+ }
155
185
 
156
186
  interface FailureRule {
157
187
  path: string;
@@ -183,6 +213,78 @@ declare class FailureInjector {
183
213
  take(method: string, path: string): ActiveFailure | null;
184
214
  }
185
215
 
216
+ type WebhookInvalidKind = "bad-signature" | "unknown-key" | "unsigned" | "stale";
217
+ type WebhookSource = "admin" | "api" | "user";
218
+ interface WebhookEndpointInput {
219
+ url: string;
220
+ events?: string[];
221
+ }
222
+ interface WebhookEndpoint {
223
+ id: string;
224
+ url: string;
225
+ events: string[] | null;
226
+ }
227
+ interface SendWebhookOptions {
228
+ type: string;
229
+ data?: Record<string, unknown>;
230
+ user?: string;
231
+ organization?: string;
232
+ role?: string;
233
+ permission?: string;
234
+ source?: WebhookSource;
235
+ ipAddress?: string;
236
+ to?: string;
237
+ duplicate?: number;
238
+ delayMs?: number;
239
+ invalid?: WebhookInvalidKind;
240
+ }
241
+ interface WebhookAttempt {
242
+ attempt: number;
243
+ status: number | null;
244
+ error: string | null;
245
+ durationMs: number;
246
+ }
247
+ interface WebhookDelivery {
248
+ webhookId: string;
249
+ eventId: string;
250
+ type: string;
251
+ url: string;
252
+ copy: number;
253
+ delivered: boolean;
254
+ attempts: WebhookAttempt[];
255
+ payload: Record<string, unknown>;
256
+ }
257
+ interface WebhookOptions {
258
+ retryDelaysMs?: number[];
259
+ timeoutMs?: number;
260
+ }
261
+ declare class WebhookDispatcher {
262
+ private readonly testkit;
263
+ private readonly seed;
264
+ private endpoints;
265
+ private seededEndpoints;
266
+ private log;
267
+ private nextEndpoint;
268
+ private readonly retryDelaysMs;
269
+ private readonly timeoutMs;
270
+ constructor(testkit: KindeTestkit, seed: ResolvedSeed, endpoints?: WebhookEndpointInput[], options?: WebhookOptions);
271
+ addEndpoint(input: WebhookEndpointInput): WebhookEndpoint;
272
+ removeEndpoint(id: string): boolean;
273
+ listEndpoints(): WebhookEndpoint[];
274
+ deliveries(): WebhookDelivery[];
275
+ reset(): void;
276
+ buildEvent(options: SendWebhookOptions): Record<string, unknown>;
277
+ send(options: SendWebhookOptions): Promise<WebhookDelivery[]>;
278
+ private deliver;
279
+ private buildData;
280
+ emitForUser(type: "user.created" | "user.authenticated", user: KindeUser): void;
281
+ private userData;
282
+ private userPayload;
283
+ private organizationData;
284
+ private namedData;
285
+ private requireUser;
286
+ }
287
+
186
288
  interface StartKindeTestkitOptions {
187
289
  port?: number;
188
290
  host?: string;
@@ -191,6 +293,7 @@ interface StartKindeTestkitOptions {
191
293
  clientId?: string;
192
294
  seed?: TestkitSeed;
193
295
  allowPublic?: boolean;
296
+ webhooks?: WebhookOptions;
194
297
  }
195
298
 
196
299
  interface KindeTestAuth {
@@ -212,6 +315,7 @@ interface KindeTestkitHandle {
212
315
  readonly jwksUri: string;
213
316
  readonly testkit: KindeTestkit;
214
317
  readonly failures: FailureInjector;
318
+ readonly webhooks: WebhookDispatcher;
215
319
  auth(scenario: Scenario, token?: ScenarioTokenOverrides): Promise<KindeTestAuth>;
216
320
  reset(): void;
217
321
  }
package/dist/vitest.js CHANGED
@@ -264,6 +264,9 @@ var KindeTestkit = class _KindeTestkit {
264
264
  if (scenario.kind === "unauthenticated") return null;
265
265
  return scenarioPrincipal(scenario, this.issuer);
266
266
  }
267
+ async signPayload(payload, invalid2) {
268
+ return this.sign(payload, invalid2);
269
+ }
267
270
  async sign(payload, invalid2) {
268
271
  if (invalid2 === "unsigned") {
269
272
  const header = base64url.encode(JSON.stringify({ alg: "none", typ: "JWT" }));
@@ -369,6 +372,19 @@ function resolveSeed(input) {
369
372
  const rawOrganizations = listOf(input.organizations, "organizations", problems);
370
373
  const rawMemberships = listOf(input.memberships, "memberships", problems);
371
374
  const rawApplications = listOf(input.applications, "applications", problems);
375
+ const rawWebhooks = listOf(input.webhooks, "webhooks", problems);
376
+ const webhooks = [];
377
+ rawWebhooks.forEach((raw, index) => {
378
+ if (!isRecord(raw) || typeof raw.url !== "string" || !/^https?:\/\//.test(raw.url)) {
379
+ problems.push(`webhooks[${index}] needs an http or https "url".`);
380
+ return;
381
+ }
382
+ if (raw.events !== void 0 && (!Array.isArray(raw.events) || raw.events.some((e) => typeof e !== "string"))) {
383
+ problems.push(`webhooks[${index}].events must be a list of event type names.`);
384
+ return;
385
+ }
386
+ webhooks.push({ url: raw.url, events: raw.events });
387
+ });
372
388
  const users = [];
373
389
  rawUsers.forEach((raw, index) => {
374
390
  if (!isRecord(raw) || typeof raw.id !== "string" || raw.id.length === 0) {
@@ -460,7 +476,7 @@ function resolveSeed(input) {
460
476
  if (problems.length > 0) {
461
477
  throw new TestkitError("SEED_INVALID", "The seed has problems. Fix them and start again.", problems);
462
478
  }
463
- return { users, organizations, memberships, applications };
479
+ return { users, organizations, memberships, applications, webhooks };
464
480
  }
465
481
  function findUser(users, ref) {
466
482
  const needle = ref.toLowerCase();
@@ -597,12 +613,14 @@ var OAuthError = class extends Error {
597
613
  error;
598
614
  };
599
615
  var AuthorizationServer = class {
600
- constructor(testkit, seed) {
616
+ constructor(testkit, seed, emit = () => void 0) {
601
617
  this.testkit = testkit;
602
618
  this.seed = seed;
619
+ this.emit = emit;
603
620
  }
604
621
  testkit;
605
622
  seed;
623
+ emit;
606
624
  codes = /* @__PURE__ */ new Map();
607
625
  refreshTokens = /* @__PURE__ */ new Map();
608
626
  signedUpUsers = /* @__PURE__ */ new Map();
@@ -720,6 +738,7 @@ var AuthorizationServer = class {
720
738
  codeChallengeMethod: request.codeChallengeMethod,
721
739
  expiresAt: Date.now() + CODE_LIFETIME_MS
722
740
  });
741
+ this.emit("user.authenticated", user);
723
742
  const target = new URL(request.redirectUri);
724
743
  target.searchParams.set("code", code);
725
744
  if (request.state !== null) target.searchParams.set("state", request.state);
@@ -885,8 +904,11 @@ var AuthorizationServer = class {
885
904
  if (seeded) return seeded;
886
905
  if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(ref)) return null;
887
906
  const user = createKindeUser({ email: ref.toLowerCase() });
888
- this.signedUpUsers.set(user.id, user);
889
- return user;
907
+ if (!this.signedUpUsers.has(user.id)) {
908
+ this.signedUpUsers.set(user.id, user);
909
+ this.emit("user.created", user);
910
+ }
911
+ return this.signedUpUsers.get(user.id);
890
912
  }
891
913
  organization(code) {
892
914
  return this.seed.organizations.find((org) => org.code === code) ?? null;
@@ -1075,6 +1097,271 @@ function validate(rule) {
1075
1097
  return problems;
1076
1098
  }
1077
1099
 
1100
+ // src/webhooks.ts
1101
+ import { randomBytes as randomBytes2 } from "crypto";
1102
+ var WEBHOOK_EVENT_TYPES = [
1103
+ "user.created",
1104
+ "user.updated",
1105
+ "user.deleted",
1106
+ "user.authenticated",
1107
+ "user.authentication_failed",
1108
+ "organization.created",
1109
+ "organization.updated",
1110
+ "organization.deleted",
1111
+ "role.created",
1112
+ "role.updated",
1113
+ "role.deleted",
1114
+ "permission.created",
1115
+ "permission.updated",
1116
+ "permission.deleted",
1117
+ "subscriber.created",
1118
+ "access_request.created"
1119
+ ];
1120
+ var BILLING_EVENT_TYPES = [
1121
+ "customer.agreement_cancelled",
1122
+ "customer.agreement_created",
1123
+ "customer.invoice_overdue",
1124
+ "customer.meter_usage_updated",
1125
+ "customer.payment_failed",
1126
+ "customer.payment_succeeded",
1127
+ "customer.plan_assigned",
1128
+ "customer.plan_changed"
1129
+ ];
1130
+ var DEFAULT_RETRY_DELAYS_MS = [0, 100, 500];
1131
+ var DEFAULT_TIMEOUT_MS = 5e3;
1132
+ var MAX_DUPLICATES = 10;
1133
+ var WebhookDispatcher = class {
1134
+ constructor(testkit, seed, endpoints = [], options = {}) {
1135
+ this.testkit = testkit;
1136
+ this.seed = seed;
1137
+ this.retryDelaysMs = options.retryDelaysMs ?? DEFAULT_RETRY_DELAYS_MS;
1138
+ this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
1139
+ for (const endpoint of endpoints) this.addEndpoint(endpoint);
1140
+ this.seededEndpoints = [...this.endpoints];
1141
+ }
1142
+ testkit;
1143
+ seed;
1144
+ endpoints = [];
1145
+ seededEndpoints = [];
1146
+ log = [];
1147
+ nextEndpoint = 1;
1148
+ retryDelaysMs;
1149
+ timeoutMs;
1150
+ addEndpoint(input) {
1151
+ if (!isHttpUrl2(input.url)) {
1152
+ throw new TestkitError("INVALID_REQUEST", `Webhook URL "${String(input.url)}" must be an http or https URL.`);
1153
+ }
1154
+ if (input.events !== void 0 && (!Array.isArray(input.events) || input.events.some((e) => typeof e !== "string"))) {
1155
+ throw new TestkitError("INVALID_REQUEST", "Webhook events must be a list of event type names.");
1156
+ }
1157
+ const endpoint = { id: `endpoint_${this.nextEndpoint++}`, url: input.url, events: input.events ?? null };
1158
+ this.endpoints.push(endpoint);
1159
+ return { ...endpoint };
1160
+ }
1161
+ removeEndpoint(id) {
1162
+ const before = this.endpoints.length;
1163
+ this.endpoints = this.endpoints.filter((e) => e.id !== id);
1164
+ return this.endpoints.length < before;
1165
+ }
1166
+ listEndpoints() {
1167
+ return this.endpoints.map((e) => ({ ...e }));
1168
+ }
1169
+ deliveries() {
1170
+ return this.log.map((d) => ({ ...d, attempts: [...d.attempts] }));
1171
+ }
1172
+ reset() {
1173
+ this.log = [];
1174
+ this.endpoints = [...this.seededEndpoints];
1175
+ }
1176
+ buildEvent(options) {
1177
+ if (typeof options.type !== "string" || !/^[a-z_]+\.[a-z_]+$/.test(options.type)) {
1178
+ throw new TestkitError("INVALID_REQUEST", `"${String(options.type)}" is not a webhook event type, such as user.created.`);
1179
+ }
1180
+ const now = /* @__PURE__ */ new Date();
1181
+ const timestamp = (options.invalid === "stale" ? new Date(now.getTime() - 36e5) : now).toISOString();
1182
+ const event = {
1183
+ data: options.data ?? this.buildData(options),
1184
+ event_id: `event_${randomBytes2(16).toString("hex")}`,
1185
+ event_timestamp: timestamp,
1186
+ source: options.source ?? "admin",
1187
+ timestamp,
1188
+ type: options.type
1189
+ };
1190
+ if (options.type === "user.authenticated" || options.type === "user.authentication_failed") {
1191
+ event.ip_address = options.ipAddress ?? "127.0.0.1";
1192
+ }
1193
+ return event;
1194
+ }
1195
+ async send(options) {
1196
+ const event = this.buildEvent(options);
1197
+ const copies = options.duplicate ?? 1;
1198
+ if (!Number.isInteger(copies) || copies < 1 || copies > MAX_DUPLICATES) {
1199
+ throw new TestkitError("INVALID_REQUEST", `"duplicate" must be a whole number from 1 to ${MAX_DUPLICATES}.`);
1200
+ }
1201
+ const targets = options.to ? [{ id: "direct", url: options.to, events: null }] : this.endpoints.filter((e) => e.events === null || e.events.includes(options.type));
1202
+ if (options.to && !isHttpUrl2(options.to)) {
1203
+ throw new TestkitError("INVALID_REQUEST", `"to" must be an http or https URL.`);
1204
+ }
1205
+ if (targets.length === 0) {
1206
+ throw new TestkitError(
1207
+ "INVALID_REQUEST",
1208
+ `No webhook endpoint listens for ${options.type}. Add one in the seed's "webhooks", with addEndpoint(), or pass "to".`
1209
+ );
1210
+ }
1211
+ if (options.delayMs) await sleep(Math.min(options.delayMs, 6e4));
1212
+ const signed = await this.testkit.signPayload(
1213
+ event,
1214
+ options.invalid === "stale" ? void 0 : options.invalid
1215
+ );
1216
+ const jobs = targets.flatMap((target) => {
1217
+ const webhookId = `wh_${randomBytes2(12).toString("hex")}`;
1218
+ return Array.from({ length: copies }, (_, index) => this.deliver(target.url, webhookId, signed, event, index + 1));
1219
+ });
1220
+ return Promise.all(jobs);
1221
+ }
1222
+ async deliver(url, webhookId, body, event, copy) {
1223
+ const delivery = {
1224
+ webhookId,
1225
+ eventId: String(event.event_id),
1226
+ type: String(event.type),
1227
+ url,
1228
+ copy,
1229
+ delivered: false,
1230
+ attempts: [],
1231
+ payload: event
1232
+ };
1233
+ this.log.push(delivery);
1234
+ for (const [index, delay] of this.retryDelaysMs.entries()) {
1235
+ if (delay > 0) await sleep(delay);
1236
+ const started = Date.now();
1237
+ try {
1238
+ const response = await fetch(url, {
1239
+ method: "POST",
1240
+ headers: { "content-type": "application/jwt", "webhook-id": webhookId },
1241
+ body,
1242
+ signal: AbortSignal.timeout(this.timeoutMs)
1243
+ });
1244
+ await response.arrayBuffer().catch(() => void 0);
1245
+ delivery.attempts.push({ attempt: index + 1, status: response.status, error: null, durationMs: Date.now() - started });
1246
+ if (response.status === 200) {
1247
+ delivery.delivered = true;
1248
+ break;
1249
+ }
1250
+ } catch (error) {
1251
+ const name = error.name;
1252
+ delivery.attempts.push({
1253
+ attempt: index + 1,
1254
+ status: null,
1255
+ error: name === "TimeoutError" ? `No answer within ${this.timeoutMs}ms` : error.message,
1256
+ durationMs: Date.now() - started
1257
+ });
1258
+ }
1259
+ }
1260
+ return { ...delivery, attempts: [...delivery.attempts] };
1261
+ }
1262
+ buildData(options) {
1263
+ const [subject] = options.type.split(".");
1264
+ switch (subject) {
1265
+ case "user":
1266
+ return { user: this.userData(options) };
1267
+ case "organization":
1268
+ return { organization: this.organizationData(options) };
1269
+ case "role":
1270
+ return { role: this.namedData(options, "role") };
1271
+ case "permission":
1272
+ return { permission: this.namedData(options, "permission") };
1273
+ case "subscriber": {
1274
+ const user = this.requireUser(options);
1275
+ return {
1276
+ subscriber: {
1277
+ email: user.email,
1278
+ first_name: user.givenName,
1279
+ id: stableId("sub", user.id),
1280
+ last_name: user.familyName,
1281
+ user_id: user.id
1282
+ }
1283
+ };
1284
+ }
1285
+ case "access_request": {
1286
+ const user = this.requireUser(options);
1287
+ return {
1288
+ access_request: { email: user.email, first_name: user.givenName, last_name: user.familyName, user_id: user.id }
1289
+ };
1290
+ }
1291
+ default:
1292
+ throw new TestkitError(
1293
+ "INVALID_REQUEST",
1294
+ `kinde-testkit has no built-in payload for ${options.type}. Pass "data" with the event's data object.`
1295
+ );
1296
+ }
1297
+ }
1298
+ emitForUser(type, user) {
1299
+ if (!this.endpoints.some((e) => e.events === null || e.events.includes(type))) return;
1300
+ const data = type === "user.created" ? { user: this.userPayload(user) } : { user: { id: user.id } };
1301
+ void this.send({ type, data, source: "user" }).catch(() => void 0);
1302
+ }
1303
+ userData(options) {
1304
+ const user = this.requireUser(options);
1305
+ if (options.type !== "user.created" && options.type !== "user.updated") return { id: user.id };
1306
+ return this.userPayload(user);
1307
+ }
1308
+ userPayload(user) {
1309
+ return {
1310
+ email: user.email,
1311
+ first_name: user.givenName,
1312
+ id: user.id,
1313
+ is_password_reset_requested: false,
1314
+ is_suspended: false,
1315
+ last_name: user.familyName,
1316
+ organizations: this.seed.memberships.filter((m) => m.userId === user.id).map((m) => ({
1317
+ code: m.organizationCode,
1318
+ permissions: m.permissions.length > 0 ? m.permissions.map((key) => ({ id: stableId("perm", key), key })) : null,
1319
+ roles: m.roles.length > 0 ? m.roles.map((key) => ({ id: stableId("role", key), key })) : null
1320
+ })),
1321
+ phone: null,
1322
+ username: typeof user.claims.username === "string" ? user.claims.username : null
1323
+ };
1324
+ }
1325
+ organizationData(options) {
1326
+ if (!options.organization) {
1327
+ throw new TestkitError("INVALID_REQUEST", `${options.type} needs "organization", the organization code.`);
1328
+ }
1329
+ const org = this.seed.organizations.find((o) => o.code === options.organization);
1330
+ if (options.type === "organization.deleted") return { code: options.organization };
1331
+ const name = org?.name ?? titleCase(options.organization);
1332
+ const data = { code: options.organization, external_id: null, handle: slug(name), name };
1333
+ if (options.type === "organization.updated") data.is_allow_registrations = false;
1334
+ return data;
1335
+ }
1336
+ namedData(options, kind) {
1337
+ const key = kind === "role" ? options.role : options.permission;
1338
+ if (!key) throw new TestkitError("INVALID_REQUEST", `${options.type} needs "${kind}", the ${kind} key.`);
1339
+ const id = stableId(kind === "role" ? "role" : "perm", key);
1340
+ if (options.type.endsWith(".deleted")) return { id };
1341
+ const data = { description: "", id, key, name: titleCase(key) };
1342
+ if (kind === "role") data.is_default_role = false;
1343
+ return data;
1344
+ }
1345
+ requireUser(options) {
1346
+ if (!options.user) throw new TestkitError("INVALID_REQUEST", `${options.type} needs "user", a seeded user's id or email.`);
1347
+ const user = findUser(this.seed.users, options.user);
1348
+ if (!user) throw new TestkitError("SEED_UNKNOWN_USER", `No seeded user matches "${options.user}".`);
1349
+ return user;
1350
+ }
1351
+ };
1352
+ function isHttpUrl2(value) {
1353
+ if (typeof value !== "string") return false;
1354
+ try {
1355
+ const { protocol } = new URL(value);
1356
+ return protocol === "http:" || protocol === "https:";
1357
+ } catch {
1358
+ return false;
1359
+ }
1360
+ }
1361
+ function sleep(ms) {
1362
+ return new Promise((resolve) => setTimeout(resolve, ms));
1363
+ }
1364
+
1078
1365
  // src/server.ts
1079
1366
  var LOOPBACK_HOSTS = /* @__PURE__ */ new Set(["127.0.0.1", "localhost", "::1"]);
1080
1367
  var MAX_BODY_BYTES = 64 * 1024;
@@ -1106,12 +1393,14 @@ async function startKindeTestkit(options = {}) {
1106
1393
  audience: options.audience ?? options.seed?.audience,
1107
1394
  clientId: options.clientId ?? options.seed?.clientId
1108
1395
  });
1109
- const auth = new AuthorizationServer(testkit, seed);
1396
+ const webhooks = new WebhookDispatcher(testkit, seed, seed.webhooks, options.webhooks);
1397
+ const auth = new AuthorizationServer(testkit, seed, (type, user) => webhooks.emitForUser(type, user));
1110
1398
  const reset = () => {
1111
1399
  auth.reset();
1112
1400
  failures.clear();
1401
+ webhooks.reset();
1113
1402
  };
1114
- ready({ testkit, auth, seed, failures, reset });
1403
+ ready({ testkit, auth, seed, failures, webhooks, reset });
1115
1404
  return {
1116
1405
  url,
1117
1406
  issuer: testkit.issuer,
@@ -1120,6 +1409,7 @@ async function startKindeTestkit(options = {}) {
1120
1409
  testkit,
1121
1410
  seed,
1122
1411
  failures,
1412
+ webhooks,
1123
1413
  reset,
1124
1414
  close: () => new Promise((resolve, reject) => {
1125
1415
  server.closeAllConnections();
@@ -1128,7 +1418,7 @@ async function startKindeTestkit(options = {}) {
1128
1418
  };
1129
1419
  }
1130
1420
  async function handle(req, res, context) {
1131
- const { testkit, auth, seed, failures } = context;
1421
+ const { testkit, auth, seed, failures, webhooks } = context;
1132
1422
  const url = new URL(req.url ?? "/", "http://localhost");
1133
1423
  const { pathname } = url;
1134
1424
  const method = req.method ?? "GET";
@@ -1173,6 +1463,21 @@ async function handle(req, res, context) {
1173
1463
  const removed = failures.remove(decodeURIComponent(pathname.slice("/testkit/failures/".length)));
1174
1464
  return sendJson2(res, removed ? 200 : 404, { ok: removed });
1175
1465
  }
1466
+ if (method === "POST" && pathname === "/testkit/webhooks") {
1467
+ return sendJson2(res, 200, await webhooks.send(await readJson(req)));
1468
+ }
1469
+ if (method === "GET" && pathname === "/testkit/webhooks/types") {
1470
+ return sendJson2(res, 200, { built_in: WEBHOOK_EVENT_TYPES, billing: BILLING_EVENT_TYPES });
1471
+ }
1472
+ if (method === "GET" && pathname === "/testkit/webhooks/deliveries") return sendJson2(res, 200, webhooks.deliveries());
1473
+ if (method === "GET" && pathname === "/testkit/webhooks/endpoints") return sendJson2(res, 200, webhooks.listEndpoints());
1474
+ if (method === "POST" && pathname === "/testkit/webhooks/endpoints") {
1475
+ return sendJson2(res, 201, webhooks.addEndpoint(await readJson(req)));
1476
+ }
1477
+ if (method === "DELETE" && pathname.startsWith("/testkit/webhooks/endpoints/")) {
1478
+ const removed = webhooks.removeEndpoint(decodeURIComponent(pathname.slice("/testkit/webhooks/endpoints/".length)));
1479
+ return sendJson2(res, removed ? 200 : 404, { ok: removed });
1480
+ }
1176
1481
  if (method === "POST" && pathname === "/testkit/reset") {
1177
1482
  context.reset();
1178
1483
  return sendJson2(res, 200, { ok: true });
@@ -1370,6 +1675,9 @@ function useKindeTestkit(options = {}) {
1370
1675
  get failures() {
1371
1676
  return current().failures;
1372
1677
  },
1678
+ get webhooks() {
1679
+ return current().webhooks;
1680
+ },
1373
1681
  auth: (scenario, token) => kindeTest({ scenario, testkit: current().testkit, token }),
1374
1682
  reset: () => current().reset()
1375
1683
  };