@geekmidas/cli 10.0.0-alpha.32 → 10.0.0-alpha.33

package/dist/index.cjs

@@ -2,13 +2,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
 const require_discover = require("./discover-CroTIm0K.cjs");
-const require_config = require("./config-URVD4bTj.cjs");
-const require_workspace = require("./workspace-Bav3TVrP.cjs");
+const require_config = require("./config-DMpzmsQL.cjs");
+const require_workspace = require("./workspace-CAJk6UmC.cjs");
 const require_storage = require("./storage-C2JC31V9.cjs");
-const require_workspace$1 = require("./workspace-BhiMkRuA.cjs");
+const require_workspace$1 = require("./workspace-C8TbIWxO.cjs");
 const require_OpenApiTsGenerator = require("./OpenApiTsGenerator-D1nhN98m.cjs");
 const require_openapi = require("./openapi.cjs");
-const require_ready = require("./ready-DXtNfk7v.cjs");
+const require_ready = require("./ready-CXhoutix.cjs");
 const require_emit = require("./emit-BdoPFjZf.cjs");
 const require_reconcile = require("./reconcile-BxZTV2vl.cjs");
 let commander = require("commander");
@@ -42,7 +42,7 @@ let _geekmidas_constructs_subscribers = require("@geekmidas/constructs/subscribe
 let _geekmidas_constructs_topic = require("@geekmidas/constructs/topic");
 let node_dns_promises = require("node:dns/promises");
 //#region package.json
-var version = "10.0.0-alpha.32";
+var version = "10.0.0-alpha.33";
 //#endregion
 //#region src/auth/credentials.ts
 /**
@@ -1092,9 +1092,9 @@ async function workspaceDevCommand(workspace, options) {
 		...reconciled.env
 	};
 	if (options.migrate || options.seed) {
-		const { prepareDevDatabases } = await Promise.resolve().then(() => require("./migrate-BiasgAIN.cjs"));
+		const { prepareDevDatabases } = await Promise.resolve().then(() => require("./migrate-BkytlJlU.cjs"));
 		await prepareDevDatabases(workspace, reconciled.env, { seed: !!options.seed });
-	} else await Promise.resolve().then(() => require("./migrate-BiasgAIN.cjs")).then(({ reportPendingMigrations }) => reportPendingMigrations(workspace, reconciled.env)).catch((error) => {
+	} else await Promise.resolve().then(() => require("./migrate-BkytlJlU.cjs")).then(({ reportPendingMigrations }) => reportPendingMigrations(workspace, reconciled.env)).catch((error) => {
 		logger$10.log(`⚠️  Could not check for pending migrations: ${error instanceof Error ? error.message : String(error)}`);
 	});
 	const appUrls = {};
@@ -8646,7 +8646,27 @@ functions it called on the way.
 ${database ? "gkm test       # starts services, injects secrets, then runs vitest" : "gkm test"}
 \`\`\`
 
-Run tests through \`gkm test\`, not \`vitest\` directly${database ? " — it is what starts the database and injects the secrets the suite needs" : ""}.`;
+Run tests through \`gkm test\`, not \`vitest\` directly${database ? " — it is what starts the database and injects the secrets the suite needs" : ""}.${database ? `
+
+**Factories, one per database.** \`test/factories/<construct>.ts\` at the
+project root — \`database.ts\` for \`Database\` — exports
+\`createFactory(db)\`. A feature test gets each by service name, on that
+test's transaction — the one \`db.get\` returns and its endpoints use — so
+ask for it rather than importing and building one. Sign in the way a person
+does, through \`browser.signIn\`:
+
+\`\`\`typescript
+it('reads a user', async ({ browser, db, factories }) => {
+  const factory = await factories.get('database');
+  const ada = await factory.insert('users', { email: 'ada@example.com' });
+
+  await browser.signIn(ada.email);
+  // … act through browser.api …
+
+  const app = await db.get('database');
+  // … assert on what was written …
+});
+\`\`\`` : ""}`;
 }
 //#endregion
 //#region src/init/dependencies.ts
@@ -8774,26 +8794,26 @@ function loadPackageJson() {
 * Run: pnpm --filter @geekmidas/cli sync-versions
 */
 const GEEKMIDAS_VERSIONS = {
-	"@geekmidas/audit": "~10.0.0-alpha.32",
-	"@geekmidas/auth": "~10.0.0-alpha.32",
-	"@geekmidas/cache": "~10.0.0-alpha.32",
-	"@geekmidas/client": "~10.0.0-alpha.32",
-	"@geekmidas/cloud": "~10.0.0-alpha.32",
-	"@geekmidas/constructs": "~10.0.0-alpha.32",
-	"@geekmidas/db": "~10.0.0-alpha.32",
-	"@geekmidas/emailkit": "~10.0.0-alpha.32",
-	"@geekmidas/envkit": "~10.0.0-alpha.32",
-	"@geekmidas/errors": "~10.0.0-alpha.32",
-	"@geekmidas/events": "~10.0.0-alpha.32",
-	"@geekmidas/logger": "~10.0.0-alpha.32",
-	"@geekmidas/manifest": "~10.0.0-alpha.32",
-	"@geekmidas/rate-limit": "~10.0.0-alpha.32",
-	"@geekmidas/schema": "~10.0.0-alpha.32",
-	"@geekmidas/services": "~10.0.0-alpha.32",
-	"@geekmidas/storage": "~10.0.0-alpha.32",
-	"@geekmidas/studio": "~10.0.0-alpha.32",
-	"@geekmidas/telescope": "~10.0.0-alpha.32",
-	"@geekmidas/testkit": "~10.0.0-alpha.32",
+	"@geekmidas/audit": "~10.0.0-alpha.33",
+	"@geekmidas/auth": "~10.0.0-alpha.33",
+	"@geekmidas/cache": "~10.0.0-alpha.33",
+	"@geekmidas/client": "~10.0.0-alpha.33",
+	"@geekmidas/cloud": "~10.0.0-alpha.33",
+	"@geekmidas/constructs": "~10.0.0-alpha.33",
+	"@geekmidas/db": "~10.0.0-alpha.33",
+	"@geekmidas/emailkit": "~10.0.0-alpha.33",
+	"@geekmidas/envkit": "~10.0.0-alpha.33",
+	"@geekmidas/errors": "~10.0.0-alpha.33",
+	"@geekmidas/events": "~10.0.0-alpha.33",
+	"@geekmidas/logger": "~10.0.0-alpha.33",
+	"@geekmidas/manifest": "~10.0.0-alpha.33",
+	"@geekmidas/rate-limit": "~10.0.0-alpha.33",
+	"@geekmidas/schema": "~10.0.0-alpha.33",
+	"@geekmidas/services": "~10.0.0-alpha.33",
+	"@geekmidas/storage": "~10.0.0-alpha.33",
+	"@geekmidas/studio": "~10.0.0-alpha.33",
+	"@geekmidas/telescope": "~10.0.0-alpha.33",
+	"@geekmidas/testkit": "~10.0.0-alpha.33",
 	"@geekmidas/cli": `~${loadPackageJson().version}`
 };
 //#endregion
@@ -11987,9 +12007,9 @@ function generateSourceFiles(options, template) {
 //#endregion
 //#region src/init/generators/test.ts
 /**
-* Generate test infrastructure files when database is enabled.
-* Includes transaction-isolated test config,
-* factory system with builders/seeds, and an example spec.
+* Generate test infrastructure files when database is enabled: the
+* transaction-isolated test config and an example spec, in the app. The
+* factory is the project's — see {@link generateTestFactoryFiles}.
 */
 function generateTestFiles(options, _template) {
 	if (!options.constructs.database) return [];
@@ -11997,10 +12017,9 @@ function generateTestFiles(options, _template) {
 	const schema = !options.monorepo ? "../src/constructs/database.ts" : `@${options.name}/constructs/database.ts`;
 	db.urlKey;
 	db.ownerUrlKey;
-	return [
-		{
-			path: "test/config.ts",
-			content: `import { it as itVitest } from 'vitest';
+	return [{
+		path: "test/config.ts",
+		content: `import { it as itVitest } from 'vitest';
 import { wrapVitestKyselyTransaction } from '@geekmidas/testkit/kysely';
 import { type Database, database } from '${schema}';
 
@@ -12010,17 +12029,56 @@ export const it = wrapVitestKyselyTransaction<Database>(itVitest, {
   connection: database,
 });
 `
-		},
-		{
-			path: "test/factory/index.ts",
-			content: `import type { Kysely } from 'kysely';
+	}, {
+		path: "test/example.spec.ts",
+		content: `import { describe, expect } from 'vitest';
+import { it } from './config.ts';
+
+describe('example', () => {
+  it('should have a working test setup', async ({ trx }) => {
+    // trx is a Kysely transaction; everything in it is rolled back after the
+    // test
+    expect(trx).toBeDefined();
+  });
+});
+`
+	}];
+}
+/**
+* The database's test factory, at the project root:
+* `test/factories/<construct>.ts`.
+*
+* A factory belongs to a database, not to an app, so there is one per database
+* for the whole project. `gkm test` finds it by that name and hands every
+* feature test \`factories.get('database')\`, built on the test's transaction.
+*/
+function generateTestFactoryFiles(options) {
+	if (!options.constructs.database) return [];
+	const db = databaseFor();
+	const schema = options.monorepo ? `@${options.name}/constructs/database.ts` : "../../src/constructs/database.ts";
+	return [{
+		path: `test/factories/${(0, _geekmidas_manifest.kebabCase)(db.id)}.ts`,
+		content: `import type { Kysely } from 'kysely';
 import { KyselyFactory } from '@geekmidas/testkit/kysely';
 import type { Database } from '${schema}';
-import { usersBuilder } from './users.ts';
+
+const usersBuilder = KyselyFactory.createBuilder<Database, 'users'>(
+  'users',
+  ({ faker }) => ({
+    id: faker.string.uuid(),
+    name: faker.person.fullName(),
+    email: faker.internet.email(),
+    createdAt: new Date(),
+  }),
+);
 
 const builders = { users: usersBuilder };
 const seeds = {};
 
+/**
+ * This database's factory. \`gkm test\` builds it on each feature test's
+ * transaction and hands it over as \`factories.get('${(0, _geekmidas_manifest.serviceKey)(db.id)}')\`.
+ */
 export function createFactory(db: Kysely<Database>) {
   return new KyselyFactory<Database, typeof builders, typeof seeds>(
     builders,
@@ -12031,38 +12089,7 @@ export function createFactory(db: Kysely<Database>) {
 
 export type Factory = ReturnType<typeof createFactory>;
 `
-		},
-		{
-			path: "test/factory/users.ts",
-			content: `import { KyselyFactory } from '@geekmidas/testkit/kysely';
-import type { Database } from '${schema}';
-
-export const usersBuilder = KyselyFactory.createBuilder<Database, 'users'>(
-  'users',
-  ({ faker }) => ({
-    id: faker.string.uuid(),
-    name: faker.person.fullName(),
-    email: faker.internet.email(),
-    createdAt: new Date(),
-  }),
-);
-`
-		},
-		{
-			path: "test/example.spec.ts",
-			content: `import { describe, expect } from 'vitest';
-import { it } from './config.ts';
-
-describe('example', () => {
-  it('should have a working test setup', async ({ trx }) => {
-    // trx is a Kysely transaction; everything in it is rolled back after the
-    // test
-    expect(trx).toBeDefined();
-  });
-});
-`
-		}
-	];
+	}];
 }
 //#endregion
 //#region src/init/generators/ui.ts
@@ -14532,7 +14559,8 @@ async function initCommand(projectName, options = {}) {
 		...generateGithubFiles(templateOptions),
 		...generateMonorepoFiles(templateOptions, baseTemplate),
 		...generateRootConstructs(templateOptions),
-		...generateModelsPackage(templateOptions)
+		...generateModelsPackage(templateOptions),
+		...generateTestFactoryFiles(templateOptions)
 	] : [];
 	const webAppFiles = isFullstack ? frontendFramework === "tanstack-start" ? generateTanStackWebFiles(templateOptions) : frontendFramework === "expo" ? generateExpoAppFiles(templateOptions) : generateWebAppFiles(templateOptions) : [];
 	const authAppFiles = isFullstack ? generateAuthAppFiles(templateOptions) : [];
@@ -14995,7 +15023,7 @@ var NoStoredSecrets = class extends Error {
 	}
 };
 async function reconcile(secrets, workspace, stage) {
-	const { derivedContainers } = await Promise.resolve().then(() => require("./workspace-BhiMkRuA.cjs")).then((n) => n.workspace_exports);
+	const { derivedContainers } = await Promise.resolve().then(() => require("./workspace-C8TbIWxO.cjs")).then((n) => n.workspace_exports);
 	const result = require_reconcile.reconcileMissingSecrets(secrets, workspace, await derivedContainers(workspace, stage));
 	return result ? {
 		secrets: result.secrets,
@@ -15339,7 +15367,8 @@ async function testCommand(options = {}) {
 		patterns: require_workspace$1.constructGlobs(workspace),
 		cacheBackend: require_workspace$1.backendsOf(workspace).cache,
 		stage: require_workspace.TEST_STAGE,
-		env: finalCredentials
+		env: finalCredentials,
+		factories: (0, node_path.join)(workspace.root, workspace.test.factories ?? "test/factories")
 	}) : void 0;
 	if (options.prepare) {
 		console.log(manifestPath ? `  🧪 Test harness written beside ${manifestPath}` : "  🧪 Nothing to prepare: this project declares no constructs");
@@ -15393,7 +15422,7 @@ async function testCommand(options = {}) {
 * starts without the reference data the app needs.
 */
 async function migrateTestStage(workspace, env) {
-	const { migrateAndSeed } = await Promise.resolve().then(() => require("./migrate-BiasgAIN.cjs"));
+	const { migrateAndSeed } = await Promise.resolve().then(() => require("./migrate-BkytlJlU.cjs"));
 	const { discover } = await Promise.resolve().then(() => require("./discover-CroTIm0K.cjs")).then((n) => n.discover_exports);
 	const sources = {};
 	const manifest = await discover({
@@ -15838,7 +15867,7 @@ program.command("migrate").description("Apply each database construct's migratio
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { migrateCommand } = await Promise.resolve().then(() => require("./migrate-BiasgAIN.cjs"));
+		const { migrateCommand } = await Promise.resolve().then(() => require("./migrate-BkytlJlU.cjs"));
 		await migrateCommand({
 			...options,
 			...construct ? { construct } : {}
@@ -15852,7 +15881,7 @@ program.command("seed").description("Migrate, then run each database construct's
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { seedCommand } = await Promise.resolve().then(() => require("./migrate-BiasgAIN.cjs"));
+		const { seedCommand } = await Promise.resolve().then(() => require("./migrate-BkytlJlU.cjs"));
 		await seedCommand({
 			...options,
 			...construct ? { construct } : {}
@@ -15866,7 +15895,7 @@ program.command("migration").description("Write a construct's next migration: an
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { migrationCommand } = await Promise.resolve().then(() => require("./migrate-BiasgAIN.cjs"));
+		const { migrationCommand } = await Promise.resolve().then(() => require("./migrate-BkytlJlU.cjs"));
 		await migrationCommand({
 			construct,
 			...name ? { name } : {}
@@ -16034,7 +16063,7 @@ program.command("secrets:reconcile").description("Backfill missing custom secret
 			console.error(`No secrets found for stage "${stage}". Run "gkm secrets:init --stage ${stage}" first.`);
 			process.exit(1);
 		}
-		const { derivedContainers } = await Promise.resolve().then(() => require("./workspace-BhiMkRuA.cjs")).then((n) => n.workspace_exports);
+		const { derivedContainers } = await Promise.resolve().then(() => require("./workspace-C8TbIWxO.cjs")).then((n) => n.workspace_exports);
 		const result = reconcileMissingSecrets(secrets, workspace, await derivedContainers(workspace, stage));
 		if (!result) {
 			console.log(`\n✓ Secrets for stage "${stage}" are up-to-date`);
@@ -16093,7 +16122,7 @@ program.command("deploy:github").description("Let GitHub Actions deploy a stage:
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { deployGithubCommand } = await Promise.resolve().then(() => require("./github-B2fis34P.cjs"));
+		const { deployGithubCommand } = await Promise.resolve().then(() => require("./github-JhvrmjQp.cjs"));
 		await deployGithubCommand(options);
 	} catch (error) {
 		console.error(formatError(error));