create-absolutejs 0.17.3 → 0.19.0

package/dist/scaffold.js

@@ -4,14 +4,31 @@ import { fileURLToPath } from 'url';
 import { formatProject } from './commands/formatProject';
 import { initializeGit } from './commands/initializeGit';
 import { installDependencies } from './commands/installDependencies';
+import { migrateDatabase } from './commands/migrateDatabase';
 import { createPackageJson } from './generators/configurations/generatePackageJson';
 import { initalizeRoot } from './generators/configurations/initializeRoot';
 import { scaffoldConfigurationFiles } from './generators/configurations/scaffoldConfigurationFiles';
 import { scaffoldDatabase } from './generators/db/scaffoldDatabase';
+import { scaffoldAgentic } from './generators/project/scaffoldAgentic';
 import { scaffoldBackend } from './generators/project/scaffoldBackend';
 import { scaffoldFrontends } from './generators/project/scaffoldFrontends';
-import { scaffoldAgentic } from './generators/project/scaffoldAgentic';
-export const scaffold = async ({ response: { agentic, projectName, codeQualityTool, initializeGitNow, githubLink, githubRepoUrl, githubVisibility, databaseEngine, databaseHost, useHTMLScripts, useTailwind, databaseDirectory, absProviders, includeExamples, orm, frontends, plugins, authOption, buildDirectory, assetsDirectory, tailwind, installDependenciesNow, frontendDirectories }, latest, envVariables, packageManager }) => {
+import { validateDatabaseSelection } from './utils/validateDatabaseSelection';
+export const scaffold = async ({ response: { agentic, projectName, codeQualityTool, initializeGitNow, githubLink, githubRepoUrl, githubVisibility, databaseEngine, databaseHost, useHTMLScripts, useTailwind, databaseDirectory, absProviders, includeExamples, orm, frontends, plugins, authOption, buildDirectory, assetsDirectory, tailwind, installDependenciesNow, frontendDirectories }, latest, verifyLocalDatabase = true, envVariables, packageManager }) => {
+    const { errors: databaseErrors } = validateDatabaseSelection({
+        databaseEngine,
+        databaseHost,
+        orm
+    });
+    if (databaseErrors.length > 0)
+        throw new Error(databaseErrors.join('\n'));
+    if (orm === 'prisma')
+        throw new Error('Prisma scaffolding is not implemented. Choose Drizzle or no ORM.');
+    if (authOption === 'abs' && (!databaseEngine || databaseEngine === 'none'))
+        throw new Error('Authentication requires a database for persistent users. Select a database or omit --auth.');
+    if (authOption === 'abs' &&
+        (!absProviders?.length ||
+            absProviders.some((provider) => provider !== 'google')))
+        throw new Error('Automatic auth scaffolding currently supports --abs-provider google. Configure other providers with the auth package after creation.');
     const __dirname = dirname(fileURLToPath(import.meta.url));
     const templatesDirectory = join(__dirname, '/templates');
     const { frontendDirectory, backendDirectory, projectAssetsDirectory, typesDirectory } = initalizeRoot(projectName, templatesDirectory);
@@ -70,7 +87,8 @@ export const scaffold = async ({ response: { agentic, projectName, codeQualityTo
             databaseHost,
             orm,
             projectName,
-            typesDirectory
+            typesDirectory,
+            verifyLocalDatabase
         });
         ({ dockerFreshInstall } = result);
     }
@@ -103,6 +121,14 @@ export const server = treaty<Api>(serverUrl)
     if (installDependenciesNow) {
         await installDependencies(packageManager, projectName);
     }
+    const databaseMigrated = orm === 'drizzle' &&
+        installDependenciesNow &&
+        (await migrateDatabase({
+            databaseEngine,
+            databaseHost,
+            projectName,
+            verifyLocalDatabase
+        }));
     await formatProject({
         installDependenciesNow,
         packageManager,
@@ -116,5 +142,8 @@ export const server = treaty<Api>(serverUrl)
             projectName
         });
     }
-    return { dockerFreshInstall };
+    return {
+        databaseMigrationPending: orm === 'drizzle' && !databaseMigrated,
+        dockerFreshInstall
+    };
 };

package/dist/templates/configurations/eslint.config.example.mjs

@@ -1,47 +1,87 @@
-
 import { defineConfig } from 'eslint/config';
-import tseslint from 'typescript-eslint';
 import absolute from 'eslint-plugin-absolute';
 import reactHooks from 'eslint-plugin-react-hooks';
+import tseslint from 'typescript-eslint';
 
 export default defineConfig([
-  { ignores: ['node_modules/**', 'build/**', 'dist/**', '.absolutejs/**', '.data/**', '**/.absolutejs-hmr-*', 'drizzle/**'] },
-  { linterOptions: { noInlineConfig: true, reportUnusedDisableDirectives: 'error' } },
-  ...tseslint.configs.recommended,
-  {
-    files: ['**/*.{ts,tsx,js,jsx,mjs}'],
-    plugins: { absolute },
-    rules: {
-      '@typescript-eslint/ban-ts-comment': ['error', { 'ts-check': true, 'ts-expect-error': true, 'ts-ignore': true, 'ts-nocheck': true }],
-      'absolute/no-chained-type-assertions': 'error',
-      'absolute/no-unsafe-schema-types': 'error',
-      'absolute/prefer-drizzle-query-builders': 'error',
-      'absolute/elysia-composition-boundaries': 'error',
-      'absolute/no-nondeterministic-render': 'error',
-      'absolute/button-icon-is-hidden': 'error',
-      'absolute/icon-button-has-accessible-name': 'error',
-      'absolute/loading-indicator-has-aria-busy': 'error',
-      'absolute/progressbar-has-state': 'error',
-    },
-  },
-  {
-    files: ['src/backend/**/*.{ts,tsx}'],
-    rules: { 'absolute/elysia-no-response-return': 'error' },
-  },
-  {
-    files: ['src/frontend/**/*.{ts,tsx,js,jsx}'],
-    rules: {
-      'no-restricted-syntax': ['error',
-        { selector: "CallExpression[callee.name='fetch']", message: 'Use a directly typed Eden subapp client.' },
-        { selector: "CallExpression[callee.property.name='fetch']", message: 'Use a directly typed Eden subapp client.' },
-      ],
-      'absolute/eden-requires-react-query': 'error',
-    },
-  },
-  { files: ['**/*.{html,vue,svelte,gjs,gts}'], plugins: { absolute }, processor: 'absolute/template-source' },
-  {
-    files: ['src/frontend/**/*.{ts,tsx,js,jsx}'],
-    plugins: { 'react-hooks': reactHooks },
-    rules: { 'react-hooks/rules-of-hooks': 'error', 'react-hooks/exhaustive-deps': 'error' },
-  },
+	{
+		ignores: [
+			'node_modules/**',
+			'build/**',
+			'dist/**',
+			'.absolutejs/**',
+			'.data/**',
+			'**/.absolutejs-hmr-*',
+			'drizzle/**'
+		]
+	},
+	{
+		linterOptions: {
+			noInlineConfig: true,
+			reportUnusedDisableDirectives: 'error'
+		}
+	},
+	...tseslint.configs.recommended,
+	{
+		files: ['**/*.{ts,tsx,js,jsx,mjs}'],
+		plugins: { absolute },
+		rules: {
+			'@typescript-eslint/ban-ts-comment': [
+				'error',
+				{
+					'ts-check': true,
+					'ts-expect-error': true,
+					'ts-ignore': true,
+					'ts-nocheck': true
+				}
+			],
+			'absolute/button-icon-is-hidden': 'error',
+			'absolute/elysia-composition-boundaries': 'error',
+			'absolute/icon-button-has-accessible-name': 'error',
+			'absolute/loading-indicator-has-aria-busy': 'error',
+			'absolute/no-chained-type-assertions': 'error',
+			'absolute/no-nondeterministic-render': 'error',
+			'absolute/no-unsafe-schema-types': 'error',
+			'absolute/prefer-drizzle-query-builders': 'error',
+			'absolute/progressbar-has-state': 'error'
+		}
+	},
+	{
+		files: ['src/backend/**/*.{ts,tsx}'],
+		rules: { 'absolute/elysia-no-response-return': 'error' }
+	},
+	{
+		files: ['src/frontend/**/*.{ts,tsx,js,jsx}'],
+		rules: {
+			'absolute/eden-requires-react-query': 'error',
+			'no-restricted-syntax': [
+				'error',
+				{
+					message: 'Use a directly typed Eden subapp client.',
+					selector: "CallExpression[callee.name='fetch']"
+				},
+				{
+					message: 'Use a directly typed Eden subapp client.',
+					selector: "CallExpression[callee.property.name='fetch']"
+				}
+			]
+		}
+	},
+	{
+		files: ['**/*.{html,vue,svelte,gjs,gts}'],
+		plugins: { absolute },
+		processor: 'absolute/template-source'
+	},
+	{
+		// 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/exhaustive-deps': 'error',
+			'react-hooks/rules-of-hooks': 'error'
+		}
+	}
 ]);

package/dist/templates/db/migrations/cockroach-count-history/20260926210314_init/migration.sql

@@ -0,0 +1,5 @@
+CREATE TABLE "count_history" (
+	"uid" int4 PRIMARY KEY GENERATED ALWAYS AS IDENTITY (INCREMENT BY 1 MINVALUE 1 MAXVALUE 2147483647 START WITH 1 CACHE 1),
+	"count" int4 NOT NULL,
+	"created_at" timestamp DEFAULT now() NOT NULL
+);

package/dist/templates/db/migrations/cockroach-count-history/20260926210314_init/snapshot.json

@@ -0,0 +1,69 @@
+{
+	"version": "1",
+	"dialect": "cockroach",
+	"id": "25a4568e-927c-4251-8f0c-145bd20ef6cf",
+	"prevIds": ["00000000-0000-0000-0000-000000000000"],
+	"ddl": [
+		{
+			"isRlsEnabled": false,
+			"name": "count_history",
+			"entityType": "tables",
+			"schema": "public"
+		},
+		{
+			"type": "int4",
+			"typeSchema": null,
+			"notNull": true,
+			"dimensions": 0,
+			"default": null,
+			"generated": null,
+			"identity": {
+				"type": "always",
+				"increment": "1",
+				"startWith": "1",
+				"minValue": "1",
+				"maxValue": "2147483647",
+				"cache": 1
+			},
+			"name": "uid",
+			"entityType": "columns",
+			"schema": "public",
+			"table": "count_history"
+		},
+		{
+			"type": "int4",
+			"typeSchema": null,
+			"notNull": true,
+			"dimensions": 0,
+			"default": null,
+			"generated": null,
+			"identity": null,
+			"name": "count",
+			"entityType": "columns",
+			"schema": "public",
+			"table": "count_history"
+		},
+		{
+			"type": "timestamp",
+			"typeSchema": null,
+			"notNull": true,
+			"dimensions": 0,
+			"default": "now()",
+			"generated": null,
+			"identity": null,
+			"name": "created_at",
+			"entityType": "columns",
+			"schema": "public",
+			"table": "count_history"
+		},
+		{
+			"columns": ["uid"],
+			"nameExplicit": false,
+			"name": "count_history_pkey",
+			"schema": "public",
+			"table": "count_history",
+			"entityType": "pks"
+		}
+	],
+	"renames": []
+}

package/dist/templates/db/migrations/cockroach-users/20260926210315_init/migration.sql

@@ -0,0 +1,5 @@
+CREATE TABLE "users" (
+	"auth_sub" varchar(255) PRIMARY KEY,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	"metadata" jsonb DEFAULT '{}'
+);

package/dist/templates/db/migrations/cockroach-users/20260926210315_init/snapshot.json

@@ -0,0 +1,62 @@
+{
+	"version": "1",
+	"dialect": "cockroach",
+	"id": "b7fed725-7fff-4c26-8562-5dbb3a0e1a7a",
+	"prevIds": ["00000000-0000-0000-0000-000000000000"],
+	"ddl": [
+		{
+			"isRlsEnabled": false,
+			"name": "users",
+			"entityType": "tables",
+			"schema": "public"
+		},
+		{
+			"type": "varchar(255)",
+			"typeSchema": null,
+			"notNull": true,
+			"dimensions": 0,
+			"default": null,
+			"generated": null,
+			"identity": null,
+			"name": "auth_sub",
+			"entityType": "columns",
+			"schema": "public",
+			"table": "users"
+		},
+		{
+			"type": "timestamp",
+			"typeSchema": null,
+			"notNull": true,
+			"dimensions": 0,
+			"default": "now()",
+			"generated": null,
+			"identity": null,
+			"name": "created_at",
+			"entityType": "columns",
+			"schema": "public",
+			"table": "users"
+		},
+		{
+			"type": "jsonb",
+			"typeSchema": null,
+			"notNull": false,
+			"dimensions": 0,
+			"default": "'{}'",
+			"generated": null,
+			"identity": null,
+			"name": "metadata",
+			"entityType": "columns",
+			"schema": "public",
+			"table": "users"
+		},
+		{
+			"columns": ["auth_sub"],
+			"nameExplicit": false,
+			"name": "users_pkey",
+			"schema": "public",
+			"table": "users",
+			"entityType": "pks"
+		}
+	],
+	"renames": []
+}

package/dist/templates/db/migrations/mssql-count-history/20260926210316_init/migration.sql

@@ -0,0 +1,6 @@
+CREATE TABLE [count_history] (
+	[uid] int IDENTITY(1, 1),
+	[count] int NOT NULL,
+	[created_at] datetime2 NOT NULL CONSTRAINT [count_history_created_at_default] DEFAULT (sysdatetime()),
+	CONSTRAINT [count_history_pkey] PRIMARY KEY([uid])
+);

package/dist/templates/db/migrations/mssql-count-history/20260926210316_init/snapshot.json

@@ -0,0 +1,64 @@
+{
+	"version": "2",
+	"dialect": "mssql",
+	"id": "425df2f4-c774-4d68-870e-936662d9c250",
+	"prevIds": ["00000000-0000-0000-0000-000000000000"],
+	"ddl": [
+		{
+			"name": "count_history",
+			"entityType": "tables",
+			"schema": "dbo"
+		},
+		{
+			"type": "int",
+			"notNull": true,
+			"generated": null,
+			"identity": {
+				"seed": 1,
+				"increment": 1
+			},
+			"name": "uid",
+			"schema": "dbo",
+			"entityType": "columns",
+			"table": "count_history"
+		},
+		{
+			"type": "int",
+			"notNull": true,
+			"generated": null,
+			"identity": null,
+			"name": "count",
+			"schema": "dbo",
+			"entityType": "columns",
+			"table": "count_history"
+		},
+		{
+			"type": "datetime2",
+			"notNull": true,
+			"generated": null,
+			"identity": null,
+			"name": "created_at",
+			"schema": "dbo",
+			"entityType": "columns",
+			"table": "count_history"
+		},
+		{
+			"nameExplicit": false,
+			"columns": ["uid"],
+			"name": "count_history_pkey",
+			"table": "count_history",
+			"schema": "dbo",
+			"entityType": "pks"
+		},
+		{
+			"column": "created_at",
+			"nameExplicit": false,
+			"default": "(sysdatetime())",
+			"name": "count_history_created_at_default",
+			"entityType": "defaults",
+			"schema": "dbo",
+			"table": "count_history"
+		}
+	],
+	"renames": []
+}

package/dist/templates/db/migrations/mssql-users/20260926210317_init/migration.sql

@@ -0,0 +1,6 @@
+CREATE TABLE [users] (
+	[auth_sub] nvarchar(255),
+	[created_at] datetime2 NOT NULL CONSTRAINT [users_created_at_default] DEFAULT (sysdatetime()),
+	[metadata] nvarchar(max) CONSTRAINT [users_metadata_default] DEFAULT ('{}'),
+	CONSTRAINT [users_pkey] PRIMARY KEY([auth_sub])
+);

package/dist/templates/db/migrations/mssql-users/20260926210317_init/snapshot.json

@@ -0,0 +1,70 @@
+{
+	"version": "2",
+	"dialect": "mssql",
+	"id": "c491f825-d719-4383-8371-1d24485e8ddb",
+	"prevIds": ["00000000-0000-0000-0000-000000000000"],
+	"ddl": [
+		{
+			"name": "users",
+			"entityType": "tables",
+			"schema": "dbo"
+		},
+		{
+			"type": "nvarchar(255)",
+			"notNull": true,
+			"generated": null,
+			"identity": null,
+			"name": "auth_sub",
+			"schema": "dbo",
+			"entityType": "columns",
+			"table": "users"
+		},
+		{
+			"type": "datetime2",
+			"notNull": true,
+			"generated": null,
+			"identity": null,
+			"name": "created_at",
+			"schema": "dbo",
+			"entityType": "columns",
+			"table": "users"
+		},
+		{
+			"type": "nvarchar(max)",
+			"notNull": false,
+			"generated": null,
+			"identity": null,
+			"name": "metadata",
+			"schema": "dbo",
+			"entityType": "columns",
+			"table": "users"
+		},
+		{
+			"nameExplicit": false,
+			"columns": ["auth_sub"],
+			"name": "users_pkey",
+			"table": "users",
+			"schema": "dbo",
+			"entityType": "pks"
+		},
+		{
+			"column": "created_at",
+			"nameExplicit": false,
+			"default": "(sysdatetime())",
+			"name": "users_created_at_default",
+			"entityType": "defaults",
+			"schema": "dbo",
+			"table": "users"
+		},
+		{
+			"column": "metadata",
+			"nameExplicit": false,
+			"default": "('{}')",
+			"name": "users_metadata_default",
+			"entityType": "defaults",
+			"schema": "dbo",
+			"table": "users"
+		}
+	],
+	"renames": []
+}

package/dist/templates/db/migrations/mysql-count-history/20260926210318_init/migration.sql

@@ -0,0 +1,5 @@
+CREATE TABLE `count_history` (
+	`uid` int AUTO_INCREMENT PRIMARY KEY,
+	`count` int NOT NULL,
+	`created_at` timestamp NOT NULL DEFAULT (now())
+);

package/dist/templates/db/migrations/mysql-count-history/20260926210318_init/snapshot.json

@@ -0,0 +1,61 @@
+{
+	"version": "6",
+	"dialect": "mysql",
+	"id": "658c0ebf-8885-4a5b-80a8-198504da6d23",
+	"prevIds": ["00000000-0000-0000-0000-000000000000"],
+	"ddl": [
+		{
+			"name": "count_history",
+			"entityType": "tables"
+		},
+		{
+			"type": "int",
+			"notNull": true,
+			"autoIncrement": true,
+			"default": null,
+			"onUpdateNow": false,
+			"onUpdateNowFsp": null,
+			"charSet": null,
+			"collation": null,
+			"generated": null,
+			"name": "uid",
+			"entityType": "columns",
+			"table": "count_history"
+		},
+		{
+			"type": "int",
+			"notNull": true,
+			"autoIncrement": false,
+			"default": null,
+			"onUpdateNow": false,
+			"onUpdateNowFsp": null,
+			"charSet": null,
+			"collation": null,
+			"generated": null,
+			"name": "count",
+			"entityType": "columns",
+			"table": "count_history"
+		},
+		{
+			"type": "timestamp",
+			"notNull": true,
+			"autoIncrement": false,
+			"default": "(now())",
+			"onUpdateNow": false,
+			"onUpdateNowFsp": null,
+			"charSet": null,
+			"collation": null,
+			"generated": null,
+			"name": "created_at",
+			"entityType": "columns",
+			"table": "count_history"
+		},
+		{
+			"columns": ["uid"],
+			"name": "PRIMARY",
+			"table": "count_history",
+			"entityType": "pks"
+		}
+	],
+	"renames": []
+}

package/dist/templates/db/migrations/mysql-users/20260926210319_init/migration.sql

@@ -0,0 +1,5 @@
+CREATE TABLE `users` (
+	`auth_sub` varchar(255) PRIMARY KEY,
+	`created_at` timestamp NOT NULL DEFAULT (now()),
+	`metadata` json DEFAULT ('{}')
+);

package/dist/templates/db/migrations/mysql-users/20260926210319_init/snapshot.json

@@ -0,0 +1,61 @@
+{
+	"version": "6",
+	"dialect": "mysql",
+	"id": "74e2d582-26d7-4879-aff9-8f2c140b5eab",
+	"prevIds": ["00000000-0000-0000-0000-000000000000"],
+	"ddl": [
+		{
+			"name": "users",
+			"entityType": "tables"
+		},
+		{
+			"type": "varchar(255)",
+			"notNull": true,
+			"autoIncrement": false,
+			"default": null,
+			"onUpdateNow": false,
+			"onUpdateNowFsp": null,
+			"charSet": null,
+			"collation": null,
+			"generated": null,
+			"name": "auth_sub",
+			"entityType": "columns",
+			"table": "users"
+		},
+		{
+			"type": "timestamp",
+			"notNull": true,
+			"autoIncrement": false,
+			"default": "(now())",
+			"onUpdateNow": false,
+			"onUpdateNowFsp": null,
+			"charSet": null,
+			"collation": null,
+			"generated": null,
+			"name": "created_at",
+			"entityType": "columns",
+			"table": "users"
+		},
+		{
+			"type": "json",
+			"notNull": false,
+			"autoIncrement": false,
+			"default": "('{}')",
+			"onUpdateNow": false,
+			"onUpdateNowFsp": null,
+			"charSet": null,
+			"collation": null,
+			"generated": null,
+			"name": "metadata",
+			"entityType": "columns",
+			"table": "users"
+		},
+		{
+			"columns": ["auth_sub"],
+			"name": "PRIMARY",
+			"table": "users",
+			"entityType": "pks"
+		}
+	],
+	"renames": []
+}

package/dist/templates/db/migrations/postgresql-count-history/20260926210320_init/migration.sql

@@ -0,0 +1,5 @@
+CREATE TABLE "count_history" (
+	"uid" integer PRIMARY KEY GENERATED ALWAYS AS IDENTITY (sequence name "count_history_uid_seq" INCREMENT BY 1 MINVALUE 1 MAXVALUE 2147483647 START WITH 1 CACHE 1),
+	"count" integer NOT NULL,
+	"created_at" timestamp DEFAULT now() NOT NULL
+);