create-absolutejs 0.17.3 → 0.19.0

package/CHANGELOG.md

@@ -6,6 +6,22 @@ This file is generated by `absolute-changelog` from the entries in
 `changelog/`. Edit an entry, not this file — and add new ones under
 `changelog/unreleased/`.
 
+## 0.19.0 — 2026-09-26
+
+### Added
+
+- **Scaffold Drizzle for every Drizzle 1.0 dialect (PostgreSQL, MySQL, MariaDB, SQLite, Turso/libSQL, SingleStore, SQL Server, CockroachDB) with a committed initial migration and db:generate / db:migrate scripts**
+
+### Fixed
+
+- **Accept --orm none as the help text documents, and refuse unsupported database, host and ORM combinations before writing any files**
+
+## 0.18.0 — 2026-09-23
+
+### Fixed
+
+- **Update registry dependency pins and generate compatible Elysia 2, Drizzle 1, Angular and HTMX starters with persistent auth, typed JSON subapps, and executable starter checks**
+
 ## 0.17.3 — 2026-09-22
 
 ### Fixed

package/README.md

@@ -74,13 +74,13 @@ Usage: create-absolute [project-name] [options]
   Output directory for build artifacts.
 
 - `--db <engine|none>`  
-  Database engine (`postgresql` | `mysql` | `sqlite` | `mongodb` | `redis` | `singlestore` | `cockroachdb` | `mssql`) or `none`.
+  Database engine (`postgresql` | `mysql` | `mariadb` | `sqlite` | `mongodb` | `gel` | `singlestore` | `cockroachdb` | `mssql`) or `none`.
 
 - `--db-dir <directory>`  
   Directory name for your database files.
 
 - `--db-host <provider|none>`  
-  Database host provider (`neon` | `planetscale` | `supabase` | `turso` | `vercel` | `upstash` | `atlas`) or `none`.
+  Database host provider (`neon` | `planetscale` | `turso`) or `none`.
 
 - `--directory <default|custom>`  
   Directory-naming strategy: `default` or `custom`.
@@ -112,8 +112,8 @@ Usage: create-absolute [project-name] [options]
 - `--lts`  
   Use LTS versions of required packages.
 
-- `--orm <drizzle|prisma|none>`  
-  ORM to configure: `drizzle` | `prisma` | `none`.
+- `--orm <drizzle|none>`
+  ORM to configure: `drizzle` | `none`. Prisma scaffolding is not implemented and is rejected before files are written. Drizzle 1 no longer includes the Gel dialect; choose no ORM for Gel.
 
 - `--plugin <plugin>`  
   Elysia plugin(s) to include (repeatable); `none` skips plugin setup. Select
@@ -191,3 +191,36 @@ Contributions are welcome! Feel free to open issues or submit pull requests to i
 ## License
 
 **Business Source License 1.1 (BSL-1.1)** – see [`LICENSE`](./LICENSE) for details.
+
+## Scaffold compatibility and verification
+
+The CLI pins published registry versions; it does not install local package links.
+The compatibility policy in `src/utils/registryChannel.ts` also applies when
+resolving versions at creation time, so npm's older `latest` tag cannot silently
+switch a generated server back to Elysia 1.
+
+- AbsoluteJS uses its current 0.20 beta channel.
+- Elysia remains at 2.0.0-beta.6 and OpenAPI at 2.0.0-beta.2: the published
+  authentication/plugin contracts still rely on `ElysiaStatus.code`, which later
+  Elysia betas changed. Upgrading these requires a coordinated SDK migration.
+- TypeScript 5.9.3 and Angular's current 21 LTS patches match the framework's
+  compiler peer dependencies. Newer incompatible compiler majors are not selected.
+- Drizzle ORM and Kit use the coordinated 1.0 release-candidate channel.
+- All other pins are checked against their latest published release channel.
+
+Automatic authentication setup currently supplies a complete Google configuration
+and requires a persistent database. Configure other login providers explicitly
+using `@absolutejs/auth` after creation; the CLI rejects unsupported automatic
+provider configurations instead of silently omitting them. Auth sessions are
+in-memory by default; configure a shared session store for multi-instance hosting.
+
+`bun run check-versions` checks every scaffold pin against that policy.
+`bun run check:package` runs typechecking, unit tests, compilation and release
+metadata validation. `bun run test:starters` scaffolds representative frontend,
+plugin, database and agentic combinations into a temporary directory, installs
+real registry dependencies, and checks TypeScript and ESLint. SQLite cases also
+exercise generated HTTP validation and persistence using an isolated database.
+The matrix creates Docker configuration files but does not start containers or
+connect to paid providers. Use `SCAFFOLD_CHECK_CASES=sqlite-auth,all-frontends` to
+select cases. Hosted database credentials and real OAuth acceptance are separate
+integration checks, not implied by this matrix.

package/changelog.json

@@ -2,6 +2,30 @@
 	"contract": 1,
 	"name": "create-absolutejs",
 	"releases": [
+		{
+			"changes": [
+				{
+					"kind": "fixed",
+					"summary": "Accept --orm none as the help text documents, and refuse unsupported database, host and ORM combinations before writing any files"
+				},
+				{
+					"kind": "added",
+					"summary": "Scaffold Drizzle for every Drizzle 1.0 dialect (PostgreSQL, MySQL, MariaDB, SQLite, Turso/libSQL, SingleStore, SQL Server, CockroachDB) with a committed initial migration and db:generate / db:migrate scripts"
+				}
+			],
+			"date": "2026-09-26",
+			"version": "0.19.0"
+		},
+		{
+			"changes": [
+				{
+					"kind": "fixed",
+					"summary": "Update registry dependency pins and generate compatible Elysia 2, Drizzle 1, Angular and HTMX starters with persistent auth, typed JSON subapps, and executable starter checks"
+				}
+			],
+			"date": "2026-09-23",
+			"version": "0.18.0"
+		},
 		{
 			"changes": [
 				{

package/dist/commands/migrateDatabase.d.ts

@@ -0,0 +1,6 @@
+import type { CreateConfiguration } from '../types';
+type MigrateDatabaseProps = Pick<CreateConfiguration, 'databaseEngine' | 'databaseHost' | 'projectName'> & {
+    verifyLocalDatabase: boolean;
+};
+export declare const migrateDatabase: ({ databaseEngine, databaseHost, projectName, verifyLocalDatabase }: MigrateDatabaseProps) => Promise<boolean>;
+export {};

package/dist/commands/migrateDatabase.js

@@ -0,0 +1,53 @@
+import { spinner } from '@clack/prompts';
+import { $ } from 'bun';
+import { green, yellow } from 'picocolors';
+import { isDockerDaemonRunning, resolveDockerExe } from '../utils/checkDockerInstalled';
+const applyMigrations = async (projectName) => (await $ `bun run db:migrate`.cwd(projectName).quiet().nothrow())
+    .exitCode === 0;
+const migrateDockerDatabase = async (projectName, databaseEngine) => {
+    if (!(await isDockerDaemonRunning()))
+        return false;
+    const docker = resolveDockerExe();
+    const compose = [
+        'compose',
+        '-p',
+        databaseEngine,
+        '-f',
+        'db/docker-compose.db.yml'
+    ];
+    const started = await $ `${docker} ${compose} up -d --wait db`
+        .cwd(projectName)
+        .quiet()
+        .nothrow();
+    if (started.exitCode !== 0)
+        return false;
+    const migrated = await applyMigrations(projectName);
+    await $ `${docker} ${compose} down`.cwd(projectName).quiet().nothrow();
+    return migrated;
+};
+/* Applies the project's committed initial migration once dependencies are
+   installed, so a fresh Drizzle project's example tables exist on first run.
+   Local SQLite and the default local libSQL file for Turso migrate directly;
+   a Docker database is migrated only when the daemon is already up and the
+   scaffold verified it. Hosted databases are left to `db:migrate`, which needs
+   the real DATABASE_URL. Returns whether the migration ran. */
+export const migrateDatabase = async ({ databaseEngine, databaseHost, projectName, verifyLocalDatabase }) => {
+    const isLocal = databaseHost === undefined || databaseHost === 'none';
+    const isFileDatabase = databaseEngine === 'sqlite' && (isLocal || databaseHost === 'turso');
+    const isDockerDatabase = isLocal &&
+        verifyLocalDatabase &&
+        databaseEngine !== undefined &&
+        databaseEngine !== 'none' &&
+        databaseEngine !== 'sqlite';
+    if (!isFileDatabase && !isDockerDatabase)
+        return false;
+    const spin = spinner();
+    spin.start('Applying database migrations');
+    const migrated = isFileDatabase
+        ? await applyMigrations(projectName)
+        : await migrateDockerDatabase(projectName, databaseEngine ?? 'db');
+    spin.stop(migrated
+        ? green('Database migrated')
+        : yellow('Database not migrated — run db:migrate once it is up'));
+    return migrated;
+};

package/dist/data.d.ts

@@ -5,7 +5,7 @@ export declare const availableCodeQualityTools: readonly ["eslint+prettier", "bi
 export declare const availableDatabaseEngines: readonly ["postgresql", "mysql", "sqlite", "mongodb", "mariadb", "gel", "singlestore", "cockroachdb", "mssql", "none"];
 export declare const availableDatabaseHosts: readonly ["neon", "planetscale", "turso", "none"];
 export declare const availableDirectoryConfigurations: readonly ["default", "custom"];
-export declare const availableDrizzleDialects: readonly ["gel", "mariadb", "mssql", "mysql", "postgresql", "singlestore", "sqlite"];
+export declare const availableDrizzleDialects: readonly ["cockroachdb", "mariadb", "mssql", "mysql", "postgresql", "singlestore", "sqlite"];
 export declare const availableFrontends: readonly ["react", "html", "svelte", "vue", "htmx", "angular"];
 export declare const availableORMs: readonly ["drizzle", "prisma", "none"];
 export declare const availablePlugins: AvailableDependency[];

package/dist/data.js

@@ -35,7 +35,7 @@ export const availableDatabaseHosts = [
 ];
 export const availableDirectoryConfigurations = ['default', 'custom'];
 export const availableDrizzleDialects = [
-    'gel',
+    'cockroachdb',
     'mariadb',
     'mssql',
     'mysql',

package/dist/generators/angular/generateAngularPage.d.ts

@@ -1,11 +1,10 @@
 import { Frontend } from '../../types';
-export declare const generateAngularPage: (_frontends: Frontend[], includeExamples: boolean) => "import { Component } from '@angular/core';\nimport { CommonModule } from '@angular/common';\nimport { defineAngularPage } from '@absolutejs/absolute/angular';\n\ntype AngularPageProps = {\n\tinitialCount: number;\n};\n\n@Component({\n\timports: [CommonModule],\n\tselector: 'angular-page',\n\tstandalone: true,\n\ttemplateUrl: '../templates/angular-example.html'\n})\nexport class AngularExampleComponent {}\n\nexport const page = defineAngularPage<AngularPageProps>({\n\tcomponent: AngularExampleComponent\n});\n" | "import { Component, inject, InjectionToken } from '@angular/core';\nimport { CommonModule } from '@angular/common';\nimport { defineAngularPage } from '@absolutejs/absolute/angular';\nimport { DropdownComponent } from '../components/dropdown.component';\nimport { AppComponent } from '../components/app.component';\n\nexport const INITIAL_COUNT = new InjectionToken<number>('INITIAL_COUNT');\n\ntype AngularPageProps = {\n\tinitialCount: number;\n};\n\n@Component({\n\timports: [CommonModule, DropdownComponent, AppComponent],\n\tselector: 'angular-page',\n\tstandalone: true,\n\ttemplateUrl: '../templates/angular-example.html'\n})\nexport class AngularExampleComponent {\n\tinitialCount: number = 0;\n\n\tconstructor() {\n\t\tconst initialCountToken = inject(INITIAL_COUNT, { optional: true });\n\t\tthis.initialCount = initialCountToken ?? 0;\n\t}\n}\n\nexport const page = defineAngularPage<AngularPageProps>({\n\tcomponent: AngularExampleComponent\n});\n";
+export declare const generateAngularPage: (includeExamples: boolean) => "import { Component } from '@angular/core';\nimport { CommonModule } from '@angular/common';\n\nexport type Context = {\n\tinitialCount: number;\n};\n\n@Component({\n\timports: [CommonModule],\n\tselector: 'angular-page',\n\tstandalone: true,\n\ttemplateUrl: '../templates/angular-example.html'\n})\nexport class AngularExampleComponent {}\n\nexport const factory = () => AngularExampleComponent;\n" | "import { Component } from '@angular/core';\nimport { CommonModule } from '@angular/common';\nimport { usePageContext } from '@absolutejs/absolute/angular';\nimport { DropdownComponent } from '../components/dropdown.component';\nimport { AppComponent } from '../components/app.component';\n\n\nexport type Context = {\n\tinitialCount: number;\n};\n\n@Component({\n\timports: [CommonModule, DropdownComponent, AppComponent],\n\tselector: 'angular-page',\n\tstandalone: true,\n\ttemplateUrl: '../templates/angular-example.html'\n})\nexport class AngularExampleComponent {\n\tinitialCount = usePageContext<Context>().initialCount;\n}\n\nexport const factory = () => AngularExampleComponent;\n";
 export declare const generateAngularPageHtml: (includeExamples: boolean) => "<main></main>\n" | "<header>\n\t<a href=\"/\">AbsoluteJS</a>\n\t<app-dropdown></app-dropdown>\n</header>\n<app-root [initialCount]=\"initialCount\"></app-root>\n";
-export declare const generateAppComponent: (isSingleFrontend: boolean) => string;
-export declare const generateAppComponentCss: () => string;
+export declare const generateAppComponent: () => string;
 export declare const generateAppComponentHtml: (frontends: Frontend[], editBasePath: string) => string;
-export declare const generateCounterComponent: (isSingleFrontend: boolean) => string;
-export declare const generateCounterComponentHtml: () => string;
+export declare const generateCounterComponent: (stylesRelativeDirectory: string) => string;
 export declare const generateCounterComponentCss: () => string;
-export declare const generateDropdownComponent: (_frontends: Frontend[]) => string;
+export declare const generateCounterComponentHtml: () => string;
+export declare const generateDropdownComponent: () => string;
 export declare const generateDropdownComponentHtml: (frontends: Frontend[]) => string;

package/dist/generators/angular/generateAngularPage.js

@@ -1,12 +1,10 @@
 import { formatNavLink } from '../../utils/formatNavLink';
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-export const generateAngularPage = (_frontends, includeExamples) => {
+export const generateAngularPage = (includeExamples) => {
     if (!includeExamples)
         return `import { Component } from '@angular/core';
 import { CommonModule } from '@angular/common';
-import { defineAngularPage } from '@absolutejs/absolute/angular';
 
-type AngularPageProps = {
+export type Context = {
 	initialCount: number;
 };
 
@@ -18,19 +16,16 @@ type AngularPageProps = {
 })
 export class AngularExampleComponent {}
 
-export const page = defineAngularPage<AngularPageProps>({
-	component: AngularExampleComponent
-});
+export const factory = () => AngularExampleComponent;
 `;
-    return `import { Component, inject, InjectionToken } from '@angular/core';
+    return `import { Component } from '@angular/core';
 import { CommonModule } from '@angular/common';
-import { defineAngularPage } from '@absolutejs/absolute/angular';
+import { usePageContext } from '@absolutejs/absolute/angular';
 import { DropdownComponent } from '../components/dropdown.component';
 import { AppComponent } from '../components/app.component';
 
-export const INITIAL_COUNT = new InjectionToken<number>('INITIAL_COUNT');
 
-type AngularPageProps = {
+export type Context = {
 	initialCount: number;
 };
 
@@ -41,17 +36,10 @@ type AngularPageProps = {
 	templateUrl: '../templates/angular-example.html'
 })
 export class AngularExampleComponent {
-	initialCount: number = 0;
-
-	constructor() {
-		const initialCountToken = inject(INITIAL_COUNT, { optional: true });
-		this.initialCount = initialCountToken ?? 0;
-	}
+	initialCount = usePageContext<Context>().initialCount;
 }
 
-export const page = defineAngularPage<AngularPageProps>({
-	component: AngularExampleComponent
-});
+export const factory = () => AngularExampleComponent;
 `;
 };
 export const generateAngularPageHtml = (includeExamples) => {
@@ -64,7 +52,7 @@ export const generateAngularPageHtml = (includeExamples) => {
 <app-root [initialCount]="initialCount"></app-root>
 `;
 };
-export const generateAppComponent = (isSingleFrontend) => `import { Component, Input, ViewEncapsulation } from '@angular/core';
+export const generateAppComponent = () => `import { Component, Input, ViewEncapsulation } from '@angular/core';
 import { CommonModule } from '@angular/common';
 import { CounterComponent } from './counter.component';
 
@@ -73,14 +61,12 @@ import { CounterComponent } from './counter.component';
 	standalone: true,
 	imports: [CommonModule, CounterComponent],
 	templateUrl: '../templates/app.component.html',
-	styleUrl: '${isSingleFrontend ? '../' : '../../'}styles/app.component.css',
 	encapsulation: ViewEncapsulation.None
 })
 export class AppComponent {
 	@Input() initialCount: number = 0;
 }
 `;
-export const generateAppComponentCss = () => ``;
 export const generateAppComponentHtml = (frontends, editBasePath) => {
     const exploreBlock = frontends.length > 1
         ? `\n\t<p style="margin-top: 2rem">\n\t\tExplore the other pages to see multiple frameworks running\n\t\ttogether.\n\t</p>`
@@ -114,7 +100,7 @@ export const generateAppComponentHtml = (frontends, editBasePath) => {
 </main>
 `;
 };
-export const generateCounterComponent = (isSingleFrontend) => `import { Component, Input } from '@angular/core';
+export const generateCounterComponent = (stylesRelativeDirectory) => `import { Component, Input } from '@angular/core';
 import { CommonModule } from '@angular/common';
 
 @Component({
@@ -122,7 +108,7 @@ import { CommonModule } from '@angular/common';
 	standalone: true,
 	imports: [CommonModule],
 	templateUrl: '../templates/counter.component.html',
-	styleUrl: '${isSingleFrontend ? '../' : '../../'}styles/counter.component.css'
+	styleUrl: '${stylesRelativeDirectory}/counter.component.css'
 })
 export class CounterComponent {
 	@Input() initialCount: number = 0;
@@ -137,10 +123,6 @@ export class CounterComponent {
 	}
 }
 `;
-export const generateCounterComponentHtml = () => `<button (click)="increment()">
-	count is <span class="counter-value">{{ count }}</span>
-</button>
-`;
 export const generateCounterComponentCss = () => `button {
 	background-color: #1a1a1a;
 	border: 1px solid transparent;
@@ -168,9 +150,11 @@ button:focus-visible {
 	}
 }
 `;
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-export const generateDropdownComponent = (_frontends) => {
-    return `import { Component } from '@angular/core';
+export const generateCounterComponentHtml = () => `<button (click)="increment()">
+	count is <span class="counter-value">{{ count }}</span>
+</button>
+`;
+export const generateDropdownComponent = () => `import { Component } from '@angular/core';
 import { CommonModule } from '@angular/common';
 
 @Component({
@@ -183,7 +167,6 @@ export class DropdownComponent {
 	isOpen = false;
 }
 `;
-};
 export const generateDropdownComponentHtml = (frontends) => {
     const navLinks = frontends.map(formatNavLink).join('\n\t\t');
     return `<details

package/dist/generators/angular/scaffoldAngular.d.ts

@@ -1,2 +1,2 @@
 import { ScaffoldFrontendProps } from '../../types';
-export declare const scaffoldAngular: ({ editBasePath, includeExamples, isSingleFrontend, targetDirectory, frontends, templatesDirectory, projectAssetsDirectory, stylesDirectory, stylesIndexesDirectory }: ScaffoldFrontendProps) => void;
+export declare const scaffoldAngular: ({ editBasePath, includeExamples, targetDirectory, frontends, templatesDirectory, projectAssetsDirectory, stylesDirectory, stylesIndexesDirectory }: ScaffoldFrontendProps) => void;

package/dist/generators/angular/scaffoldAngular.js

@@ -1,14 +1,14 @@
 import { copyFileSync, mkdirSync, writeFileSync } from 'fs';
-import { join } from 'path';
+import { join, relative } from 'path';
 import { generateMarkupCSS } from '../project/generateMarkupCSS';
-import { generateAngularPage, generateAngularPageHtml, generateAppComponent, generateAppComponentCss, generateAppComponentHtml, generateCounterComponent, generateCounterComponentCss, generateCounterComponentHtml, generateDropdownComponent, generateDropdownComponentHtml } from './generateAngularPage';
-export const scaffoldAngular = ({ editBasePath, includeExamples, isSingleFrontend, targetDirectory, frontends, templatesDirectory, projectAssetsDirectory, stylesDirectory, stylesIndexesDirectory }) => {
+import { generateAngularPage, generateAngularPageHtml, generateAppComponent, generateAppComponentHtml, generateCounterComponent, generateCounterComponentCss, generateCounterComponentHtml, generateDropdownComponent, generateDropdownComponentHtml } from './generateAngularPage';
+export const scaffoldAngular = ({ editBasePath, includeExamples, targetDirectory, frontends, templatesDirectory, projectAssetsDirectory, stylesDirectory, stylesIndexesDirectory }) => {
     const pagesDirectory = join(targetDirectory, 'pages');
     const templatesDir = join(targetDirectory, 'templates');
     if (!includeExamples) {
         mkdirSync(pagesDirectory, { recursive: true });
         mkdirSync(templatesDir, { recursive: true });
-        writeFileSync(join(pagesDirectory, 'angular-example.ts'), generateAngularPage(frontends, false), 'utf-8');
+        writeFileSync(join(pagesDirectory, 'angular-example.ts'), generateAngularPage(false), 'utf-8');
         writeFileSync(join(templatesDir, 'angular-example.html'), generateAngularPageHtml(false), 'utf-8');
         writeFileSync(join(stylesIndexesDirectory, 'angular-example.css'), `@import url('../reset.css');\n\nangular-page {\n\tdisplay: flex;\n\tflex: 1;\n\tflex-direction: column;\n}\n`, 'utf-8');
         return;
@@ -18,14 +18,13 @@ export const scaffoldAngular = ({ editBasePath, includeExamples, isSingleFronten
     mkdirSync(componentsDirectory, { recursive: true });
     mkdirSync(pagesDirectory, { recursive: true });
     mkdirSync(templatesDir, { recursive: true });
-    writeFileSync(join(pagesDirectory, 'angular-example.ts'), generateAngularPage(frontends, true), 'utf-8');
+    writeFileSync(join(pagesDirectory, 'angular-example.ts'), generateAngularPage(true), 'utf-8');
     writeFileSync(join(templatesDir, 'angular-example.html'), generateAngularPageHtml(true), 'utf-8');
-    writeFileSync(join(componentsDirectory, 'dropdown.component.ts'), generateDropdownComponent(frontends), 'utf-8');
+    writeFileSync(join(componentsDirectory, 'dropdown.component.ts'), generateDropdownComponent(), 'utf-8');
     writeFileSync(join(templatesDir, 'dropdown.component.html'), generateDropdownComponentHtml(frontends), 'utf-8');
-    writeFileSync(join(componentsDirectory, 'app.component.ts'), generateAppComponent(isSingleFrontend), 'utf-8');
+    writeFileSync(join(componentsDirectory, 'app.component.ts'), generateAppComponent(), 'utf-8');
     writeFileSync(join(templatesDir, 'app.component.html'), generateAppComponentHtml(frontends, editBasePath), 'utf-8');
-    writeFileSync(join(stylesDirectory, 'app.component.css'), generateAppComponentCss(), 'utf-8');
-    writeFileSync(join(componentsDirectory, 'counter.component.ts'), generateCounterComponent(isSingleFrontend), 'utf-8');
+    writeFileSync(join(componentsDirectory, 'counter.component.ts'), generateCounterComponent(relative(componentsDirectory, stylesDirectory).replaceAll('\\', '/')), 'utf-8');
     writeFileSync(join(templatesDir, 'counter.component.html'), generateCounterComponentHtml(), 'utf-8');
     writeFileSync(join(stylesDirectory, 'counter.component.css'), generateCounterComponentCss(), 'utf-8');
     const angularCSS = generateMarkupCSS('angular', '#dd0031');

package/dist/generators/configurations/generateDrizzleConfig.d.ts

@@ -1,8 +1,10 @@
-import type { DatabaseEngine } from '../../types';
+import type { AvailableDrizzleDialect, DatabaseHost } from '../../types';
 type CreateDrizzleConfigProps = {
     projectName: string;
-    databaseEngine: DatabaseEngine;
+    databaseEngine: AvailableDrizzleDialect;
+    databaseHost: DatabaseHost;
     databaseDirectory: string;
 };
-export declare const createDrizzleConfig: ({ projectName, databaseDirectory, databaseEngine }: CreateDrizzleConfigProps) => void;
+export declare const createDrizzleConfig: ({ projectName, ...options }: CreateDrizzleConfigProps) => void;
+export declare const generateDrizzleConfig: ({ databaseDirectory, databaseEngine, databaseHost }: Omit<CreateDrizzleConfigProps, "projectName">) => string;
 export {};

package/dist/generators/configurations/generateDrizzleConfig.js

@@ -1,21 +1,47 @@
 import { writeFileSync } from 'fs';
 import { join } from 'path';
-export const createDrizzleConfig = ({ projectName, databaseDirectory, databaseEngine }) => {
-    const drizzleConfig = `import { defineConfig } from "drizzle-kit";
-	import { env } from 'process';
-
-    if (!env.DATABASE_URL) {
+import { getDrizzleKitDialect } from '../db/drizzleTargets';
+const requireDatabaseUrl = `if (!env.DATABASE_URL) {
 	throw new Error('DATABASE_URL must be set in the environment variables');
 }
+`;
+export const createDrizzleConfig = ({ projectName, ...options }) => {
+    writeFileSync(join(projectName, 'drizzle.config.ts'), generateDrizzleConfig(options));
+};
+export const generateDrizzleConfig = ({ databaseDirectory, databaseEngine, databaseHost }) => {
+    const dialect = getDrizzleKitDialect(databaseEngine, databaseHost);
+    const paths = `out: '${databaseDirectory}/migrations',
+	schema: '${databaseDirectory}/schema.ts'`;
+    /* Local SQLite lives in a file beside the schema — the same path the server
+       opens — so migrations need no environment at all. */
+    if (dialect === 'sqlite') {
+        return `import { defineConfig } from 'drizzle-kit';
+
+export default defineConfig({
+	dbCredentials: {
+		url: '${databaseDirectory}/database.sqlite'
+	},
+	dialect: 'sqlite',
+	${paths}
+});
+`;
+    }
+    /* Turso speaks libSQL: a \`libsql://\` URL plus an auth token in the cloud,
+       or a \`file:\` URL with no token for a local libSQL database. */
+    const credentials = dialect === 'turso'
+        ? `authToken: env.DATABASE_AUTH_TOKEN,
+		url: env.DATABASE_URL`
+        : 'url: env.DATABASE_URL';
+    return `import { env } from 'process';
+import { defineConfig } from 'drizzle-kit';
 
-	export default defineConfig({
-		dbCredentials: {
-			url: env.DATABASE_URL
-		},
-		dialect: '${databaseEngine}',
-		out: '${databaseDirectory}/migrations',
-		schema: '${databaseDirectory}/schema.ts'
-	});
+${requireDatabaseUrl}
+export default defineConfig({
+	dbCredentials: {
+		${credentials}
+	},
+	dialect: '${dialect}',
+	${paths}
+});
 `;
-    writeFileSync(join(projectName, 'drizzle.config.ts'), drizzleConfig);
 };

package/dist/generators/configurations/generateEnv.js

@@ -18,6 +18,12 @@ export const generateEnv = ({ databaseEngine, databaseHost, envVariables = [], p
         (databaseHost === 'none' || databaseHost === undefined)) {
         vars.push(`DATABASE_URL=${databaseURLS[databaseEngine]}`);
     }
+    /* A Turso project starts on a local libSQL file so it runs (and migrates)
+       before a cloud database exists; pointing it at Turso is two variables. */
+    const setsDatabaseUrl = vars.some((entry) => entry.startsWith('DATABASE_URL='));
+    if (databaseHost === 'turso' && !setsDatabaseUrl) {
+        vars.push('# Local libSQL file. For Turso use DATABASE_URL=libsql://<database>.turso.io and set DATABASE_AUTH_TOKEN.', 'DATABASE_URL=file:db/database.db');
+    }
     if (vars.length === 0)
         return;
     const envPath = join(projectName, '.env');

package/dist/generators/configurations/generateEslintConfig.js

@@ -6,7 +6,8 @@ import absolute from 'eslint-plugin-absolute';
 ${frontends.includes('react') ? "import reactHooks from 'eslint-plugin-react-hooks';" : ''}
 
 export default defineConfig([
-  { ignores: ['node_modules/**', 'build/**', 'dist/**', '.absolutejs/**', '.data/**', '**/.absolutejs-hmr-*', 'drizzle/**'] },
+  // The copied HTMX distribution is third-party minified runtime code.
+  { ignores: ['src/frontend/**/htmx.min.js', 'node_modules/**', 'build/**', 'dist/**', '.absolutejs/**', '.data/**', '**/.absolutejs-hmr-*', 'drizzle/**'] },
   { linterOptions: { noInlineConfig: true, reportUnusedDisableDirectives: 'error' } },
   ...tseslint.configs.recommended,
   {
@@ -42,7 +43,8 @@ export default defineConfig([
   { files: ['**/*.{html,vue,svelte,gjs,gts}'], plugins: { absolute }, processor: 'absolute/template-source' },
   ${frontends.includes('react')
     ? `{
-    files: ['src/frontend/**/*.{ts,tsx,js,jsx}'],
+    // React Hooks rules do not apply to Angular's unrelated usePageContext API.
+    files: ['src/frontend/**/*.{tsx,jsx}', 'src/frontend/**/hooks/**/*.{ts,js}'],
     plugins: { 'react-hooks': reactHooks },
     rules: { 'react-hooks/rules-of-hooks': 'error', 'react-hooks/exhaustive-deps': 'error' },
   },`

package/dist/generators/configurations/generatePackageJson.js

@@ -118,6 +118,19 @@ export const createPackageJson = async ({ agentic, projectName, authOption, plug
         packageNames.add('mssql');
         packageNames.add('@types/mssql');
     }
+    /* drizzle-orm/cockroach (and drizzle-kit's cockroach dialect) drive
+       CockroachDB through node-postgres. */
+    const usesCockroachDrizzle = isLocal && databaseEngine === 'cockroachdb' && orm === 'drizzle';
+    if (usesCockroachDrizzle) {
+        packageNames.add('pg');
+        packageNames.add('@types/pg');
+    }
+    /* drizzle-kit migrates through the first Postgres driver it can import,
+       trying pg before Neon's serverless driver (which @absolutejs/auth brings
+       in transitively and which cannot reach a local database). */
+    const needsKitPostgresDriver = isLocal && databaseEngine === 'postgresql' && orm === 'drizzle';
+    if (needsKitPostgresDriver)
+        packageNames.add('pg');
     if (isLocal && databaseEngine === 'gel')
         packageNames.add('gel');
     if (databaseEngine === 'mongodb')
@@ -147,7 +160,7 @@ export const createPackageJson = async ({ agentic, projectName, authOption, plug
         dependencies[absoluteAuthPlugin.value] = resolveVersion(absoluteAuthPlugin.value, absoluteAuthPlugin.latestVersion);
     }
     if (agentic) {
-        for (const name of [
+        [
             '@absolutejs/a2a',
             '@absolutejs/agency',
             '@absolutejs/agent-discovery',
@@ -166,9 +179,9 @@ export const createPackageJson = async ({ agentic, projectName, authOption, plug
             '@absolutejs/secrets',
             '@absolutejs/sync-bus-pg',
             '@absolutejs/wallet'
-        ]) {
+        ].forEach((name) => {
             dependencies[name] = resolveVersion(name, versions[name]);
-        }
+        });
         devDependencies['@absolutejs/agent-conformance'] = resolveVersion('@absolutejs/agent-conformance', versions['@absolutejs/agent-conformance']);
     }
     for (const pluginValue of plugins) {
@@ -279,6 +292,13 @@ export const createPackageJson = async ({ agentic, projectName, authOption, plug
         dependencies['mssql'] = resolveVersion('mssql', versions['mssql']);
         devDependencies['@types/mssql'] = resolveVersion('@types/mssql', versions['@types/mssql']);
     }
+    if (needsKitPostgresDriver) {
+        devDependencies['pg'] = resolveVersion('pg', versions['pg']);
+    }
+    if (usesCockroachDrizzle) {
+        dependencies['pg'] = resolveVersion('pg', versions['pg']);
+        devDependencies['@types/pg'] = resolveVersion('@types/pg', versions['@types/pg']);
+    }
     if (isLocalDb && databaseEngine === 'gel') {
         dependencies['gel'] = resolveVersion('gel', versions['gel']);
     }
@@ -287,11 +307,18 @@ export const createPackageJson = async ({ agentic, projectName, authOption, plug
     }
     if (isLocalDb && databaseEngine === 'sqlite') {
         scripts['db:sqlite'] = 'sqlite3 db/database.sqlite';
-        scripts['db:init'] = 'sqlite3 db/database.sqlite < db/init.sql';
+    }
+    if (isLocalDb && databaseEngine === 'sqlite' && orm !== 'drizzle') {
+        scripts['db:init'] = 'sqlite3 db/database.sqlite < db/schema.sql';
     }
     if (orm === 'drizzle') {
-        scripts['db:studio'] = 'drizzle-kit studio';
-        scripts['db:push'] = 'drizzle-kit push';
+        /* Migrations are the schema's source of truth: `db:generate` diffs
+           db/schema.ts into a new committed migration and `db:migrate` applies
+           pending ones. drizzle-kit runs on Bun so it can use Bun's own SQL and
+           SQLite drivers, exactly as the server does. */
+        scripts['db:generate'] = 'bun --bun drizzle-kit generate';
+        scripts['db:migrate'] = 'bun --bun drizzle-kit migrate';
+        scripts['db:studio'] = 'bun --bun drizzle-kit studio';
         /* `drizzle.config.ts` imports it and the scripts above shell out to it. */
         devDependencies['drizzle-kit'] = resolveVersion('drizzle-kit', versions['drizzle-kit']);
     }

package/dist/generators/db/drizzleTargets.d.ts

@@ -0,0 +1,5 @@
+import type { AvailableDrizzleDialect, DatabaseHost } from '../../types';
+export declare const drizzleKitDialects: readonly ["cockroach", "mssql", "mysql", "postgresql", "singlestore", "sqlite", "turso"];
+export type DrizzleKitDialect = (typeof drizzleKitDialects)[number];
+export declare const getDrizzleKitDialect: (databaseEngine: AvailableDrizzleDialect, databaseHost: DatabaseHost) => "mssql" | "mysql" | "postgresql" | "singlestore" | "sqlite" | "turso" | "cockroach";
+export declare const getMigrationTemplateName: (kitDialect: DrizzleKitDialect, usesAuth: boolean) => string;

package/dist/generators/db/drizzleTargets.js

@@ -0,0 +1,27 @@
+/* The `dialect` values drizzle-kit 1.0 accepts in drizzle.config.ts. Turso is
+   its own kit dialect (libSQL over HTTP/WebSocket with an auth token), even
+   though its tables are written with sqlite-core. */
+export const drizzleKitDialects = [
+    'cockroach',
+    'mssql',
+    'mysql',
+    'postgresql',
+    'singlestore',
+    'sqlite',
+    'turso'
+];
+const engineKitDialects = {
+    cockroachdb: 'cockroach',
+    mariadb: 'mysql',
+    mssql: 'mssql',
+    mysql: 'mysql',
+    postgresql: 'postgresql',
+    singlestore: 'singlestore',
+    sqlite: 'sqlite'
+};
+export const getDrizzleKitDialect = (databaseEngine, databaseHost) => databaseEngine === 'sqlite' && databaseHost === 'turso'
+    ? 'turso'
+    : engineKitDialects[databaseEngine];
+/* The directory holding the committed initial migration for a kit dialect and
+   example table (users when auth is on, count_history otherwise). */
+export const getMigrationTemplateName = (kitDialect, usesAuth) => `${kitDialect}-${usesAuth ? 'users' : 'count-history'}`;