@o3co/create-auth-provider 0.17.0 → 0.18.0-rc.1

package/templates/standalone/src/__tests__/adapters.test.mts

@@ -1,425 +0,0 @@
-/*
- * Copyright 2026 1o1 Co. Ltd.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-/**
- * The composition root's own section, `adapters`: which adapter fills each
- * slot. Phase one reads it alone, with the template's own strict schema, over
- * the template's own layers and its `reference.conf`, before it chooses its
- * modules; boot is not handed it. A path a selection moved from, or a
- * variable renamed with it, refuses before any module is chosen, naming the
- * new path and variable; an old variable beside its new name at the same
- * value is accepted.
- */
-
-import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { BootError, defineModule } from "@o3co/auth-provider-core";
-import { afterAll, describe, expect, it } from "vitest";
-import { z } from "zod";
-import { buildModules } from "#/buildModules.mjs";
-import { readOwnLayers, readSwitches, resolveConfigPaths, resolveForBoot } from "#/configPath.mjs";
-
-const configDir = fileURLToPath(new URL("../../config", import.meta.url));
-
-/** The directories the operator layers are written to, removed after the suite. */
-const operatorDirs: string[] = [];
-afterAll(() => {
-	for (const dir of operatorDirs) rmSync(dir, { recursive: true, force: true });
-});
-
-/** The template's own files for the production environment, under an operator's layer when given. */
-function ownFiles(hocon?: string): string[] {
-	const { applicationConfPath, envConfPath } = resolveConfigPaths(configDir, "production");
-	if (hocon === undefined) return [envConfPath, applicationConfPath];
-	const dir = mkdtempSync(join(tmpdir(), "adapters-"));
-	operatorDirs.push(dir);
-	const file = join(dir, "operator.conf");
-	writeFileSync(file, hocon);
-	return [file, envConfPath, applicationConfPath];
-}
-
-/** MFA, on by default, switched off where modules are built: these are about the other adapters. */
-const MFA_OFF: Readonly<Record<string, string>> = { MFA_MODE: "off" };
-
-/** Phase one's reading of `adapters`, under `env` and an operator's `hocon`. */
-const adaptersFrom = (env: Record<string, string> = {}, hocon?: string) =>
-	readSwitches(readOwnLayers(ownFiles(hocon), { env })).adapters;
-
-/** What phase one refuses under `env` and an operator's `hocon`: a `BootError`. */
-function refusal(env: Record<string, string> = {}, hocon?: string): BootError {
-	try {
-		adaptersFrom(env, hocon);
-	} catch (err) {
-		expect(err).toBeInstanceOf(BootError);
-		return err as BootError;
-	}
-	throw new Error("phase one read the adapters");
-}
-
-/** Each selection: its key, the variable that sets it, the path and variable it moved from, a value it takes. */
-const SELECTIONS = [
-	["rateLimiter", "RATE_LIMITER", "rateLimiter.adapter", "RATE_LIMITER_ADAPTER", "redis"],
-	[
-		"userSessionStores",
-		"USER_SESSION_STORES",
-		"userSessionStores.adapter",
-		"USER_SESSION_STORES_ADAPTER",
-		"redis",
-	],
-	[
-		"accessTokenDenylist",
-		"ACCESS_TOKEN_DENYLIST",
-		"accessTokenDenylist.adapter",
-		"ACCESS_TOKEN_DENYLIST_ADAPTER",
-		"memory",
-	],
-	[
-		"replaySeenSet",
-		"REPLAY_SEEN_SET",
-		"replaySeenSet.adapter",
-		"REPLAY_SEEN_SET_ADAPTER",
-		"memory",
-	],
-	["consentStore", "CONSENT_STORE", "consentStore.adapter", "CONSENT_STORE_ADAPTER", "memory"],
-	[
-		"federationTokenStore",
-		"FEDERATION_TOKEN_STORE",
-		"federationTokenStore.type",
-		"FEDERATION_TOKEN_STORE_TYPE",
-		"redis",
-	],
-	[
-		"federationGrantStore",
-		"FEDERATION_GRANT_STORE",
-		"federationGrantStore.adapter",
-		"FEDERATION_GRANT_STORE_ADAPTER",
-		"memory",
-	],
-	[
-		"federationGrantIntentStore",
-		"FEDERATION_GRANT_INTENT_STORE",
-		"federationGrantIntentStore.adapter",
-		"FEDERATION_GRANT_INTENT_STORE_ADAPTER",
-		"memory",
-	],
-	[
-		"mfaFactorStore",
-		"MFA_FACTOR_STORE",
-		"mfaFactorStore.adapter",
-		"MFA_FACTOR_STORE_ADAPTER",
-		"store",
-	],
-	[
-		"mfaTransactionStore",
-		"MFA_TRANSACTION_STORE",
-		"mfaTransactionStore.adapter",
-		"MFA_TRANSACTION_STORE_ADAPTER",
-		"redis",
-	],
-	["codeRepository", "CODE_REPOSITORY", "oauth.code.adapter", "OAUTH_CODE_ADAPTER", "memory"],
-	["codeRepository", "CODE_REPOSITORY", "repositories.code.type", "CLIENT_CODE_TYPE", "memory"],
-	["clientRepository", "CLIENT_REPOSITORY", "repositories.client.type", "CLIENT_TYPE", "yaml"],
-	["userRepository", "USER_REPOSITORY", "repositories.user.type", "CLIENT_USER_TYPE", "yaml"],
-	["auditSink", "AUDIT_SINK", "audit.sink.type", "AUDIT_SINK_TYPE", "console"],
-] as const;
-
-describe("the shipped selections", () => {
-	it("reads every selection from the template's reference.conf, at the values the template ships", () => {
-		expect(adaptersFrom()).toEqual({
-			rateLimiter: "memory",
-			attemptCounter: "memory",
-			userSessionStores: "memory",
-			accessTokenDenylist: "redis",
-			replaySeenSet: "redis",
-			consentStore: "none",
-			federationTokenStore: "memory",
-			federationGrantStore: "none",
-			federationGrantIntentStore: "none",
-			mfaFactorStore: "memory",
-			mfaTransactionStore: "memory",
-			codeRepository: "redis",
-			clientRepository: "yaml",
-			userRepository: "http",
-			auditSink: "logger",
-		});
-	});
-
-	it.each(SELECTIONS)(
-		"reads adapters.%s from ADAPTERS_%s",
-		(key, name, _oldPath, _oldName, value) => {
-			expect(adaptersFrom({ [`ADAPTERS_${name}`]: value })[key]).toBe(value);
-		},
-	);
-
-	it("reads adapters.attemptCounter from ADAPTERS_ATTEMPT_COUNTER", () => {
-		expect(adaptersFrom({ ADAPTERS_ATTEMPT_COUNTER: "redis" }).attemptCounter).toBe("redis");
-		expect(refusal({ ADAPTERS_ATTEMPT_COUNTER: "memcached" }).message).toMatch(
-			/adapters\.attemptCounter/,
-		);
-	});
-
-	it("reads a selection an operator writes in HOCON", () => {
-		expect(adaptersFrom({}, 'adapters.rateLimiter = "redis"\n').rateLimiter).toBe("redis");
-	});
-
-	it("refuses a value its schema does not know, naming the key", () => {
-		const err = refusal({ ADAPTERS_RATE_LIMITER: "memcached" });
-		expect(err.message).toMatch(/adapters\.rateLimiter/);
-		expect(err.reason).toBe("config-validation-failed");
-		expect(err.details).toMatchObject({
-			issues: [{ path: ["adapters", "rateLimiter"] }],
-			modules: [{ module: "adapters", schemaPath: "adapters" }],
-		});
-	});
-
-	it("refuses the Store for the MFA transaction store, which holds verification state, and accepts it for the factor store", () => {
-		expect(refusal({ ADAPTERS_MFA_TRANSACTION_STORE: "store" }).message).toMatch(
-			/adapters\.mfaTransactionStore/,
-		);
-		expect(adaptersFrom({ ADAPTERS_MFA_FACTOR_STORE: "store" }).mfaFactorStore).toBe("store");
-	});
-
-	it.each([
-		["ADAPTERS_CLIENT_REPOSITORY", "clientRepository"],
-		["ADAPTERS_USER_REPOSITORY", "userRepository"],
-	] as const)("reads static, core's alias of yaml, from %s", (variable, key) => {
-		expect(adaptersFrom({ [variable]: "static" })[key]).toBe("static");
-	});
-
-	it("refuses a key the section does not declare, naming it", () => {
-		expect(refusal({}, 'adapters.sessionStore = "redis"\n').message).toMatch(/sessionStore/);
-	});
-});
-
-describe("a path a selection moved from, written in the operator's own layer", () => {
-	it.each(SELECTIONS)(
-		"adapters.%s: refused where it was, %s's old path, naming the new path and ADAPTERS_%s",
-		(key, name, oldPath, _oldName, value) => {
-			const err = refusal({}, `${oldPath} = "${value}"\n`);
-			expect(err.message).toContain(
-				`${oldPath} has moved to adapters.${key}; see the upgrade guide (docs/upgrading-from-v0.16.0.md).`,
-			);
-			expect(err.message).toContain(`ADAPTERS_${name}`);
-			expect(err.reason).toBe("config-path-relocated");
-			expect(err.details).toEqual({
-				reason: "config-path-relocated",
-				relocated: [
-					{
-						module: "adapters",
-						from: oldPath,
-						to: `adapters.${key}`,
-						environmentVariable: `ADAPTERS_${name}`,
-					},
-				],
-			});
-		},
-	);
-
-	it("names every old path it finds, in one refusal", () => {
-		const err = refusal(
-			{},
-			'rateLimiter.adapter = "redis"\nconsentStore.adapter = "memory"\naudit.sink.type = "console"\n',
-		);
-		for (const path of ["rateLimiter.adapter", "consentStore.adapter", "audit.sink.type"]) {
-			expect(err.message).toContain(path);
-		}
-		expect(err.details).toMatchObject({
-			relocated: [
-				{ from: "rateLimiter.adapter" },
-				{ from: "consentStore.adapter" },
-				{ from: "audit.sink.type" },
-			],
-		});
-	});
-});
-
-describe("a variable renamed with a selection", () => {
-	it.each(SELECTIONS)(
-		"adapters.%s: %s's old variable set alone is refused, naming ADAPTERS_%s",
-		(key, name, _oldPath, oldName, value) => {
-			const err = refusal({ [oldName]: value });
-			expect(err.message).toContain(
-				`${oldName} was renamed ADAPTERS_${name}, the variable adapters.${key} is bound to; see the upgrade guide (docs/upgrading-from-v0.16.0.md).`,
-			);
-			expect(err.reason).toBe("environment-variable-renamed");
-			expect(err.details).toEqual({
-				reason: "environment-variable-renamed",
-				renamed: [
-					{
-						module: "adapters",
-						from: oldName,
-						to: `ADAPTERS_${name}`,
-						path: `adapters.${key}`,
-						state: "unset",
-					},
-				],
-			});
-		},
-	);
-
-	it.each(SELECTIONS)(
-		"adapters.%s: the old variable beside ADAPTERS_%s at a different value is refused, quoting neither",
-		(_key, name, _oldPath, oldName) => {
-			const err = refusal({ [oldName]: "old-value-5e2d", [`ADAPTERS_${name}`]: "new-value-c81a" });
-			expect(err.message).toContain(oldName);
-			expect(err.message).not.toContain("old-value-5e2d");
-			expect(err.message).not.toContain("new-value-c81a");
-			expect(err.details).toMatchObject({ renamed: [{ from: oldName, state: "different" }] });
-			expect(JSON.stringify(err.details)).not.toMatch(/old-value-5e2d|new-value-c81a/);
-		},
-	);
-
-	it.each(SELECTIONS)(
-		"adapters.%s: the old variable beside ADAPTERS_%s at the same value is refused all the same",
-		(_key, name, _oldPath, oldName, value) => {
-			const err = refusal({ [oldName]: value, [`ADAPTERS_${name}`]: value });
-			expect(err.reason).toBe("environment-variable-renamed");
-			expect(err.message).toContain(`unset ${oldName}`);
-			expect(err.details).toMatchObject({ renamed: [{ from: oldName, state: "different" }] });
-		},
-	);
-});
-
-describe("the modules phase one chooses by the selections", () => {
-	const names = (env: Record<string, string>) =>
-		buildModules(readSwitches(readOwnLayers(ownFiles(), { env: { ...MFA_OFF, ...env } })), {
-			environment: "production",
-		}).map((module) => module.name);
-
-	it.each([
-		["ADAPTERS_RATE_LIMITER", "redis", "redis-rate-limiter", "core-rate-limiter-memory"],
-		["ADAPTERS_RATE_LIMITER", "memory", "core-rate-limiter-memory", "redis-rate-limiter"],
-		[
-			"ADAPTERS_CODE_REPOSITORY",
-			"memory",
-			"standalone-in-memory-code-repository",
-			"redis-code-repository",
-		],
-		[
-			"ADAPTERS_CODE_REPOSITORY",
-			"redis",
-			"redis-code-repository",
-			"standalone-in-memory-code-repository",
-		],
-		[
-			"ADAPTERS_USER_SESSION_STORES",
-			"redis",
-			"redis-session-stores",
-			"standalone-in-memory-session-stores",
-		],
-		["ADAPTERS_CONSENT_STORE", "memory", "core-consent-store-memory", "redis-consent-store"],
-	])("%s=%s installs %s, not %s", (variable, value, installed, absent) => {
-		const modules = names({ [variable]: value });
-		expect(modules).toContain(installed);
-		expect(modules).not.toContain(absent);
-	});
-
-	it("ADAPTERS_ATTEMPT_COUNTER=redis installs redis-attempt-counter over the shared Redis socket; memory installs no counter", () => {
-		const onRedis = names({ ADAPTERS_ATTEMPT_COUNTER: "redis" });
-		expect(onRedis).toContain("redis-attempt-counter");
-		expect(onRedis).toContain("redis-clients");
-		expect(names({ ADAPTERS_ATTEMPT_COUNTER: "memory" })).not.toContain("redis-attempt-counter");
-	});
-});
-
-describe("the federation-grant stores", () => {
-	const namesWith = (env: Record<string, string>) =>
-		buildModules(
-			readSwitches(
-				readOwnLayers(ownFiles(), {
-					env: { ...MFA_OFF, FEDERATION_GRANTS_ENABLED: "true", ...env },
-				}),
-			),
-			{ environment: "production" },
-		).map((module) => module.name);
-	const STORES = [
-		"core-federation-grant-store-memory",
-		"redis-federation-grant-store",
-		"core-federation-grant-intent-store-memory",
-		"redis-federation-grant-intent-store",
-	];
-
-	it("default to none: with the feature on, neither store is installed until one is selected", () => {
-		expect(namesWith({}).filter((name) => STORES.includes(name))).toEqual([]);
-	});
-
-	it("read none from ADAPTERS_FEDERATION_GRANT_STORE and ADAPTERS_FEDERATION_GRANT_INTENT_STORE", () => {
-		expect(
-			adaptersFrom({
-				ADAPTERS_FEDERATION_GRANT_STORE: "none",
-				ADAPTERS_FEDERATION_GRANT_INTENT_STORE: "none",
-			}),
-		).toMatchObject({ federationGrantStore: "none", federationGrantIntentStore: "none" });
-	});
-
-	it.each([
-		["memory", "core-federation-grant-store-memory", "core-federation-grant-intent-store-memory"],
-		["redis", "redis-federation-grant-store", "redis-federation-grant-intent-store"],
-	])("install the %s stores once selected", (value, grants, intents) => {
-		const names = namesWith({
-			ADAPTERS_FEDERATION_GRANT_STORE: value,
-			ADAPTERS_FEDERATION_GRANT_INTENT_STORE: value,
-		});
-		expect(names).toContain(grants);
-		expect(names).toContain(intents);
-	});
-});
-
-describe("boot and the section", () => {
-	it("hands boot no adapters section: the composition root consumed it", () => {
-		const own = readOwnLayers(ownFiles(), { env: MFA_OFF });
-		const switches = readSwitches(own);
-		const resolved = resolveForBoot(
-			own,
-			buildModules(switches, { environment: "production" }),
-			switches,
-		);
-		expect(resolved).not.toHaveProperty("adapters");
-	});
-
-	it.each([
-		["named adapters", "adapters"],
-		["named mfaMode", "mfaMode"],
-	] as const)("refuses a module %s: its section would never reach boot", (_label, name) => {
-		const own = readOwnLayers(ownFiles(), { env: MFA_OFF });
-		const switches = readSwitches(own);
-		const mine = defineModule({
-			name,
-			section: { schema: z.object({}).passthrough().optional() },
-		});
-		const run = () =>
-			resolveForBoot(
-				own,
-				[...buildModules(switches, { environment: "production" }), mine],
-				switches,
-			);
-		expect(run).toThrow(new RegExp(`"${name}".*composition root's own section`));
-		const err = (() => {
-			try {
-				run();
-			} catch (thrown) {
-				return thrown;
-			}
-		})();
-		expect(err).toBeInstanceOf(BootError);
-		expect(err).toMatchObject({
-			reason: "module-section-path-invalid",
-			details: { module: name, at: name },
-		});
-	});
-});

package/templates/standalone/src/__tests__/admission-lifecycle.test.mts

@@ -1,87 +0,0 @@
-/*
- * Copyright 2026 1o1 Co. Ltd.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-/**
- * The oauth package's consumers of session admission read the session
- * lifecycle's record the template's session stores provide: a session whose
- * record is closing is refused at `/authorize`, the code exchange and the
- * refresh grant, while its user session is still there.
- */
-
-import type { SessionLifecycleStore, UserSessionStore } from "@o3co/auth-provider-core";
-import request from "supertest";
-import { describe, expect, it } from "vitest";
-import {
-	authorize,
-	basic,
-	codeFrom,
-	compose,
-	login,
-	redeem,
-	WEB,
-} from "./all-modules-composition.fixture.mjs";
-
-/** A JWT's claims, unverified. */
-const claimsOf = (token: string): Record<string, unknown> =>
-	JSON.parse(Buffer.from(token.split(".")[1] ?? "", "base64url").toString("utf8"));
-
-describe("a session whose lifecycle record is closing", () => {
-	it("is refused at /authorize, the code exchange and the refresh grant", async () => {
-		const { app, handle } = await compose();
-		try {
-			const components = handle.components as Record<string, unknown>;
-			const store = components.sessionLifecycleStore as SessionLifecycleStore;
-			const sessions = components.userSessionStore as UserSessionStore;
-			const { cookies } = await login(app);
-			const tokens = (await redeem(app, codeFrom(await authorize(app, cookies)))).body as Record<
-				string,
-				string
-			>;
-			const sid = String(claimsOf(tokens.id_token ?? "").sid);
-			const pendingCode = codeFrom(await authorize(app, cookies));
-
-			// The session's close commits, its work pending: the user session stays.
-			const session = await sessions.get(sid);
-			if (session === null) throw new Error("the login wrote no session");
-			expect((await store.open(sid, session.sub, session.expiresAt)).outcome).toBe("opened");
-			const closing = await store.beginClose(sid, {
-				cause: "rp_logout",
-				steps: ["held_open"],
-				perParticipant: [],
-				retainMs: 0,
-			});
-			expect(closing.outcome).toBe("closing");
-			expect(await sessions.get(sid)).not.toBeNull();
-
-			const again = await authorize(app, cookies);
-			// Sent to log in again, with no code.
-			expect(again.status).toBe(302);
-			expect(String(again.headers.location)).not.toMatch(/[?&]code=/);
-
-			expect((await redeem(app, pendingCode)).body).toMatchObject({ error: "invalid_grant" });
-
-			const refreshed = await request(app)
-				.post("/oauth/token")
-				.set("Authorization", basic(WEB))
-				.type("form")
-				.send({ grant_type: "refresh_token", refresh_token: tokens.refresh_token });
-			expect(refreshed.status).toBe(400);
-			expect(refreshed.body).toMatchObject({ error: "invalid_grant" });
-		} finally {
-			await handle.dispose();
-		}
-	});
-});