create-absolutejs 0.17.3 → 0.19.0

package/dist/generators/project/generateAbsoluteAuthConfig.js

@@ -12,15 +12,6 @@ const defaultProviderConfigurations = {
         searchParams: [['access_type', 'offline']]
     }
 };
-/* Mirrors the `User` shape the raw-SQL path writes into types/databaseTypes, so
-   an auth scaffold without a database resolves the same type from the same
-   module the example page already imports. */
-export const generateSessionUserType = () => `export type User = {
-	auth_sub: string;
-	created_at: Date;
-	metadata: Record<string, unknown>;
-};
-`;
 export const generateAbsoluteAuthConfig = (absProviders, hasDatabase) => {
     const providerConfigs = (absProviders ?? [])
         .map((provider) => {
@@ -81,6 +72,7 @@ import {
 } from '@absolutejs/auth';
 import { DatabaseType, User } from '../../types/databaseTypes';
 import { createUser, getUser } from '../handlers/userHandlers';
+import { parseUserIdentity } from '../../types/userIdentity';
 
 export const absoluteAuthConfig = (db: DatabaseType) =>
 	defineAuthConfig<User>({
@@ -144,7 +136,7 @@ ${providerConfigs}
 				try {
 					const newUser = await createUser(db, {
 						auth_sub: authSub,
-						metadata: userIdentity
+						metadata: parseUserIdentity(userIdentity)
 					});
 					return newUser;
 				} catch (error) {
@@ -159,3 +151,12 @@ ${providerConfigs}
 });
 `;
 };
+/* Mirrors the `User` shape the raw-SQL path writes into types/databaseTypes, so
+   an auth scaffold without a database resolves the same type from the same
+   module the example page already imports. */
+export const generateSessionUserType = () => `export type User = {
+	auth_sub: string;
+	created_at: Date;
+	metadata: Record<string, unknown>;
+};
+`;

package/dist/generators/project/generateDBBlock.js

@@ -1,4 +1,7 @@
 import { availableDrizzleDialects } from '../../data';
+/* A Turso database needs its auth token; a local libSQL `file:` URL has none,
+   so the token stays optional. */
+const tursoClient = 'createClient({ authToken: env.DATABASE_AUTH_TOKEN, url: getEnv("DATABASE_URL") })';
 const connectionMap = {
     cockroachdb: {
         none: { expr: 'new SQL(getEnv("DATABASE_URL"))' }
@@ -10,7 +13,7 @@ const connectionMap = {
         none: { expr: 'new SQL(getEnv("DATABASE_URL"))' }
     },
     mongodb: {
-        none: { expr: 'new MongoClient(getEnv("DATABASE_URL"))' }
+        none: { expr: 'new MongoClient(getEnv("DATABASE_URL")).db()' }
     },
     mssql: {
         none: { expr: 'await connect(getEnv("DATABASE_URL"))' }
@@ -36,13 +39,13 @@ const connectionMap = {
     },
     sqlite: {
         none: { expr: 'new Database("db/database.sqlite")' },
-        turso: { expr: 'createClient({ url: getEnv("DATABASE_URL") })' }
+        turso: { expr: tursoClient }
     }
 };
 const remoteDrizzleInit = {
     neon: 'neon(getEnv("DATABASE_URL"));',
     planetscale: 'new Client({ url: getEnv("DATABASE_URL") })',
-    turso: 'createClient({ url: getEnv("DATABASE_URL") })'
+    turso: tursoClient
 };
 const drizzleDialectSet = new Set([...availableDrizzleDialects]);
 export const generateDBBlock = ({ databaseEngine, orm, databaseHost }) => {
@@ -66,23 +69,29 @@ export const generateDBBlock = ({ databaseEngine, orm, databaseHost }) => {
         databaseHost !== 'planetscale') {
         return `
 const pool = createPool(getEnv("DATABASE_URL"))
-const db = drizzle(pool, { schema, mode: 'default' })
+const db = drizzle({ client: pool })
+`;
+    }
+    if (databaseEngine === 'cockroachdb') {
+        return `
+const pool = new Pool({ connectionString: getEnv("DATABASE_URL") })
+const db = drizzle({ client: pool })
 `;
     }
     if (databaseEngine === 'mssql' && hostKey === 'none') {
         return `
 const pool = await connect(getEnv("DATABASE_URL"))
-const db = drizzle({ client: pool }, { schema })
+const db = drizzle({ client: pool })
 `;
     }
     if (databaseEngine === 'postgresql' && databaseHost === 'neon') {
         return `
 		const sql = neon(getEnv('DATABASE_URL'));
-const db = drizzle(sql, { schema });
+const db = drizzle({ client: sql });
 `;
     }
     return `
 const pool = ${expr}
-const db = drizzle(pool, { schema })
+const db = drizzle({ client: pool })
 `;
 };

package/dist/generators/project/generateIdentity.d.ts

@@ -0,0 +1 @@
+export declare const generateIdentity: () => string;

package/dist/generators/project/generateIdentity.js

@@ -0,0 +1,15 @@
+export const generateIdentity = () => `
+export type JsonValue = string | number | boolean | null | JsonValue[] | { [key: string]: JsonValue };
+export type UserIdentity = Record<string, JsonValue>;
+const isJsonValue = (value: unknown): value is JsonValue => {
+ if (value === null || typeof value === 'string' || typeof value === 'boolean') return true;
+ if (typeof value === 'number') return Number.isFinite(value);
+ if (Array.isArray(value)) return value.every(isJsonValue);
+ return typeof value === 'object' && Object.getPrototypeOf(value) === Object.prototype && Object.values(value).every(isJsonValue);
+};
+const isIdentity = (value: Record<string, unknown>): value is UserIdentity => Object.values(value).every(isJsonValue);
+export const parseUserIdentity = (value: Record<string, unknown>): UserIdentity => {
+ if (!isIdentity(value)) throw new Error('Provider identity must contain JSON values');
+ return value;
+};
+`;

package/dist/generators/project/generateImportsBlock.js

@@ -10,10 +10,10 @@ export const generateImportsBlock = ({ deps, flags, orm, authOption, databaseEng
     pushHandler(flags.requiresVue, 'handleVuePageRequest', '@absolutejs/absolute/vue');
     pushHandler(flags.requiresVue, 'generateHeadElement');
     pushHandler(flags.requiresHtmx, 'handleHTMXPageRequest');
-    for (const dependency of deps) {
+    deps.forEach((dependency) => {
         const importsList = dependency.imports ?? [];
         if (importsList.length === 0)
-            continue;
+            return;
         const bySource = new Map();
         for (const imported of importsList) {
             const source = imported.importFrom ?? dependency.value;
@@ -25,7 +25,7 @@ export const generateImportsBlock = ({ deps, flags, orm, authOption, databaseEng
         for (const [source, names] of bySource) {
             rawImports.push(`import { ${names.sort().join(', ')} } from '${source}'`);
         }
-    }
+    });
     const buildExamplePath = (dir, file) => `../frontend${dir ? `/${dir}` : ''}/pages/${file}`;
     const reactDir = frontendDirectories.react;
     const svelteDir = frontendDirectories.svelte;
@@ -42,7 +42,10 @@ export const generateImportsBlock = ({ deps, flags, orm, authOption, databaseEng
     const connectorImports = {
         neon: [`import { neon } from '@neondatabase/serverless'`],
         planetscale: [`import { Client } from '@planetscale/database'`],
-        turso: [`import { createClient } from '@libsql/client'`]
+        turso: [
+            `import { createClient } from '@libsql/client'`,
+            `import { env } from 'bun'`
+        ]
     };
     const dialectImports = {
         neon: [`import { drizzle } from 'drizzle-orm/neon-http'`],
@@ -59,10 +62,7 @@ export const generateImportsBlock = ({ deps, flags, orm, authOption, databaseEng
             `import { Elysia } from 'elysia'`,
             ...(databaseEngine === 'sqlite' && !isRemoteHost
                 ? []
-                : [`import { getEnv } from '@absolutejs/absolute'`]),
-            ...(authOption === 'abs'
-                ? [`import { schema } from '../../db/schema'`]
-                : [`import { schema } from '../../db/schema'`])
+                : [`import { getEnv } from '@absolutejs/absolute'`])
         ]
     };
     const getPostgresqlOrmDatabaseImports = () => {
@@ -80,13 +80,15 @@ export const generateImportsBlock = ({ deps, flags, orm, authOption, databaseEng
     };
     const ormDatabaseImports = {
         drizzle: {
-            gel: [
-                `import { createClient } from 'gel'`,
-                `import { drizzle } from 'drizzle-orm/gel'`
+            cockroachdb: [
+                `import { drizzle } from 'drizzle-orm/cockroach'`,
+                `import { Pool } from 'pg'`
             ],
+            /* drizzle-orm/mysql2 1.0 sets options on the pool's `config`, which
+               only mysql2's callback pool has; it wraps it in .promise() itself. */
             mariadb: [
                 `import { drizzle } from 'drizzle-orm/mysql2'`,
-                `import { createPool } from 'mysql2/promise'`
+                `import { createPool } from 'mysql2'`
             ],
             mssql: [
                 `import { connect } from 'mssql'`,
@@ -95,7 +97,7 @@ export const generateImportsBlock = ({ deps, flags, orm, authOption, databaseEng
             mysql: !isRemoteHost
                 ? [
                     `import { drizzle } from 'drizzle-orm/mysql2'`,
-                    `import { createPool } from 'mysql2/promise'`
+                    `import { createPool } from 'mysql2'`
                 ]
                 : [],
             postgresql: getPostgresqlOrmDatabaseImports(),
@@ -188,8 +190,6 @@ export const generateImportsBlock = ({ deps, flags, orm, authOption, databaseEng
     }
     if (authOption === 'abs')
         rawImports.push(`import { absoluteAuthConfig } from './utils/absoluteAuthConfig'`, `import { t } from 'elysia'`, `import { authClientOption, authIntentOption, getStatus, providers, ProviderOption, userSessionIdTypebox } from '@absolutejs/auth'`);
-    if (hasDatabase && (authOption === undefined || authOption === 'none'))
-        rawImports.push(`import { getCountHistory, createCountHistory } from './handlers/countHistoryHandlers'`, `import { t } from 'elysia'`);
     const importMap = new Map();
     for (const stmt of rawImports) {
         const match = stmt.match(/^import\s+(.+)\s+from\s+['"](.+)['"];?/);

package/dist/generators/project/generateRoutesBlock.d.ts

@@ -3,6 +3,7 @@ type GenerateRoutesBlockProps = {
     databaseEngine: CreateConfiguration['databaseEngine'];
     frontendDirectories: FrontendDirectories;
     authOption: AuthOption;
+    includeDatabaseRoutes?: boolean;
 };
-export declare const generateRoutesBlock: ({ databaseEngine, frontendDirectories, authOption }: GenerateRoutesBlockProps) => string;
+export declare const generateRoutesBlock: ({ databaseEngine, frontendDirectories, authOption, includeDatabaseRoutes }: GenerateRoutesBlockProps) => string;
 export {};

package/dist/generators/project/generateRoutesBlock.js

@@ -1,5 +1,5 @@
 import { isFrontend } from '../../typeGuards';
-export const generateRoutesBlock = ({ databaseEngine, frontendDirectories, authOption }) => {
+export const generateRoutesBlock = ({ databaseEngine, frontendDirectories, authOption, includeDatabaseRoutes = true }) => {
     const hasDatabase = databaseEngine !== undefined && databaseEngine !== 'none';
     const routes = [];
     const wrap = (handlerCall, isAsync = false) => authOption === 'abs'
@@ -19,14 +19,14 @@ export const generateRoutesBlock = ({ databaseEngine, frontendDirectories, authO
         : `${isAsync ? 'async ' : ''}() => ${handlerCall}`;
     const createHandlerCall = (frontend) => {
         if (frontend === 'angular')
-            return `handleAngularPageRequest<typeof AngularExamplePage>({
+            return `handleAngularPageRequest<AngularExamplePage.Context>({
     headTag: generateHeadElement({
       cssPath: asset(manifest, 'AngularExampleCSS'),
       title: 'AbsoluteJS + Angular'
     }),
     indexPath: asset(manifest, 'AngularExampleIndex'),
     pagePath: asset(manifest, 'AngularExample'),
-    props: { initialCount: 0 }
+    requestContext: { initialCount: 0 }
   })`;
         if (frontend === 'html')
             return `handleHTMLPageRequest(asset(manifest, 'HTMLExample'))`;
@@ -51,10 +51,7 @@ export const generateRoutesBlock = ({ databaseEngine, frontendDirectories, authO
         if (frontend === 'vue')
             return `handleVuePageRequest<typeof VueExample>({
     headTag: generateHeadElement({
-      cssPath: [
-        asset(manifest, 'VueExampleCSS'),
-        asset(manifest, 'VueExampleCompiledCSS')
-      ],
+      cssPath: asset(manifest, 'VueExampleCSS'),
       title: 'AbsoluteJS + Vue'
     }),
     indexPath: asset(manifest, 'VueExampleIndex'),
@@ -82,12 +79,10 @@ export const generateRoutesBlock = ({ databaseEngine, frontendDirectories, authO
             routes.push(`.get('/${frontend}', ${handler})`);
         }
     });
-    if (hasDatabase && (authOption === undefined || authOption === 'none')) {
-        routes.push(`.get('/count/:uid', ({ params: { uid } }) => getCountHistory(db, uid), {
-    params: t.Object({ uid: t.Number() })
-  })`, `.post('/count', ({ body: { count } }) => createCountHistory(db, count), {
-    body: t.Object({ count: t.Number() })
-  })`);
+    if (includeDatabaseRoutes &&
+        hasDatabase &&
+        (authOption === undefined || authOption === 'none')) {
+        routes.push(`.get('/count/:uid', { params: t.Object({ uid: t.Number() }) }, ({ params: { uid } }) => getCountHistory(db, uid))`, `.post('/count', { body: t.Object({ count: t.Number() }) }, ({ body: { count } }) => createCountHistory(db, count))`);
     }
     return routes.join('\n  ');
 };

package/dist/generators/project/generateServer.js

@@ -34,20 +34,21 @@ export const generateServerFile = ({ tailwind, authOption, plugins, buildDirecto
     const useBlock = deps
         .flatMap((dependency) => dependency.imports ?? [])
         .filter((pluginImport) => pluginImport.isPlugin &&
-        pluginImport.packageName !== 'networking')
+        pluginImport.packageName !== 'networking' &&
+        pluginImport.packageName !== 'openapi')
         .map((pluginImport) => {
         if (pluginImport.packageName === 'auth') {
-            return `.use(authPlugin)`;
+            return 'authPlugin';
         }
         if (pluginImport.config === undefined) {
-            return `.use(${pluginImport.packageName})`;
+            return pluginImport.packageName;
         }
         if (pluginImport.config === null) {
-            return `.use(${pluginImport.packageName}())`;
+            return `${pluginImport.packageName}()`;
         }
-        return `.use(${pluginImport.packageName}(${JSON.stringify(pluginImport.config)}))`;
+        return `${pluginImport.packageName}(${JSON.stringify(pluginImport.config)})`;
     })
-        .join('\n');
+        .join(', ');
     const guardBlock = `.guard({
 			cookie: t.Cookie({
 				auth_client: authClientOption,
@@ -58,29 +59,38 @@ export const generateServerFile = ({ tailwind, authOption, plugins, buildDirecto
     const routesBlock = generateRoutesBlock({
         authOption,
         databaseEngine,
-        frontendDirectories
+        frontendDirectories,
+        includeDatabaseRoutes: false
     });
     const hasDatabase = databaseEngine !== undefined && databaseEngine !== 'none';
-    /* `auth()` is async, so it is hoisted out of the `.use()` chain rather than
-       inlined — Elysia accepts the promise as a plugin. */
+    /* Resolve async auth before composing the shallow plugin array. */
     const authBlock = authOption === 'abs'
-        ? `const authPlugin = auth(absoluteAuthConfig(${hasDatabase ? 'db' : ''}))\n`
+        ? `const authPlugin = await auth(absoluteAuthConfig(${hasDatabase ? 'db' : ''}))\n`
         : '';
     const content = `${importsBlock}
-import { api } from './api'
+import { ${hasDatabase && authOption !== 'abs' ? 'createApi' : 'api'} } from './api'
 
 ${manifestBlock}
-${dbBlock ? `${dbBlock}\n` : ''}${authBlock}
+${dbBlock ? `${dbBlock}\n` : ''}${hasDatabase && authOption !== 'abs' ? 'const api = createApi(db)\n' : ''}${authBlock}
 export const server = new Elysia()
-.use([absolutejs, api])
-${useBlock}${authOption === 'abs' ? `\n${guardBlock}` : ''}
+.use([absolutejs, api${useBlock ? `, ${useBlock}` : ''}])
+${authOption === 'abs' ? `\n${guardBlock}` : ''}
   ${routesBlock}
-  .use(networking)
+  ${plugins.includes('@elysia/openapi') ? '.use(openapi())' : ''}
   .error(({ request, error }) => {
     console.error(\`Server error on \${request.method} \${request.url}\`, error)
   })
+  .use(networking)
 
 `;
-    writeFileSync(join(backendDirectory, 'api.ts'), "import { Elysia } from 'elysia'\n\n// Add typed JSON subapps here; keep page rendering and lifecycle in server.ts.\nexport const api = new Elysia({ name: 'application-api' })\nexport type Api = typeof api\n");
+    writeFileSync(join(backendDirectory, 'api.ts'), hasDatabase && authOption !== 'abs'
+        ? `import { Elysia, t } from 'elysia'
+import type { DatabaseType } from '../types/databaseTypes'
+import { getCountHistory, createCountHistory } from './handlers/countHistoryHandlers'
+export const createApi = (db: DatabaseType) => new Elysia({name:'application-api'})
+${generateRoutesBlock({ authOption: 'none', databaseEngine, frontendDirectories: {} })}
+export type Api = ReturnType<typeof createApi>
+`
+        : "import { Elysia } from 'elysia'\n\n// Add typed JSON subapps here; keep page rendering and lifecycle in server.ts.\nexport const api = new Elysia({ name: 'application-api' })\nexport type Api = typeof api\n");
     writeFileSync(serverFilePath, content);
 };

package/dist/generators/project/scaffoldAgentic.d.ts

@@ -1,5 +1,5 @@
-export declare const agentRuntimeSource = "import {\n\tcreateAgency,\n\tcreateAgentControlPlane,\n\tcreateMemoryAgencyStore,\n\tcreateMemoryAgentControlStore,\n\tdenyAllPolicy\n} from '@absolutejs/agency'\nimport {\n\tcreateAgentRuntime,\n\tcreateMemoryAgentRuntimeStore\n} from '@absolutejs/agent-runtime'\n\n// Memory stores are development defaults. Replace them with durable stores\n// before running more than one process or accepting production actions.\nexport const agentControl = createAgentControlPlane({\n\tsources: [],\n\tstore: createMemoryAgentControlStore()\n})\n\n// Intentionally deny-by-default. Replace denyAllPolicy() with your policy\n// decision point only after declaring each action's effects and scopes.\nexport const agency = createAgency({\n\tcontrol: agentControl,\n\tpolicy: denyAllPolicy(),\n\tstore: createMemoryAgencyStore()\n})\n\n// Durable run semantics are available from the first commit. The placeholder\n// driver fails closed until the application supplies its model/tool loop.\nexport const agentRuntime = createAgentRuntime({\n\tstore: createMemoryAgentRuntimeStore(),\n\tdriver: {\n\t\tnext: async () => ({\n\t\t\ttype: 'fail',\n\t\t\tcode: 'agent_not_configured',\n\t\t\tmessage: 'Configure the agent driver before accepting runs'\n\t\t})\n\t},\n\teffects: {\n\t\texecute: async () => {\n\t\t\tthrow new Error('Agent effects are not configured')\n\t\t}\n\t}\n})\n";
 export declare const agentDiscoverySource = "import {\n\tABSOLUTE_AGENT_SCHEMA,\n\tcreateAgentDiscoveryHandler,\n\tsignAgentDocument,\n\ttype AgentDiscoveryDocument,\n\ttype DiscoverySigner\n} from '@absolutejs/agent-discovery'\n\n// Keep this document specific and keyword-rich: registries rank declared\n// capabilities, effects, scopes, interfaces, examples, and publisher trust.\nexport const createAgentDocument = ({\n\torigin,\n\tpublishedAt,\n\tversion\n}: {\n\torigin: string\n\tpublishedAt: string\n\tversion: string\n}): AgentDiscoveryDocument => ({\n\t$schema: ABSOLUTE_AGENT_SCHEMA,\n\tid: `${origin}/agents/main`,\n\tname: 'Replace with your agent name',\n\tdescription: 'Replace with a precise description of the outcomes this agent delivers.',\n\tversion,\n\turl: origin,\n\tpublisher: {\n\t\tid: origin,\n\t\tname: 'Replace with your organization',\n\t\tjwksUri: `${origin}/.well-known/jwks.json`\n\t},\n\tcapabilities: [{\n\t\tid: 'status.read',\n\t\ttitle: 'Read service status',\n\t\tdescription: 'Returns the public health and readiness status of this agent.',\n\t\ttags: ['status', 'health', 'readiness'],\n\t\teffects: ['read'],\n\t\tapproval: 'never'\n\t}],\n\tinterfaces: [{\n\t\ttype: 'http',\n\t\turl: `${origin}/api/agents/main`,\n\t\tcontentTypes: ['application/json']\n\t}],\n\tcategories: ['replace-with-domain-category'],\n\ttags: ['replace-with-user-intent', 'replace-with-outcome'],\n\tlanguages: ['en'],\n\tdocumentationUrl: `${origin}/docs/agents/main`,\n\texamples: [{\n\t\ttitle: 'Check whether the agent is ready',\n\t\tprompt: 'Check the agent service status.',\n\t\tcapabilityId: 'status.read'\n\t}],\n\tcreatedAt: publishedAt,\n\tupdatedAt: publishedAt\n})\n\n// Use a KMS/HSM-backed signer in production. Mount the returned fetch handler\n// at the origin root so all well-known, A2A, JSON-LD, agents.txt, and sitemap\n// discovery surfaces are served from one signed descriptor.\nexport const createAgentDiscovery = async ({\n\tsigner,\n\torigin,\n\tpublishedAt,\n\tversion\n}: {\n\tsigner: DiscoverySigner\n\torigin: string\n\tpublishedAt: string\n\tversion: string\n}) =>\n\tcreateAgentDiscoveryHandler({\n\t\tdocuments: [await signAgentDocument(\n\t\t\tcreateAgentDocument({ origin, publishedAt, version }),\n\t\t\tsigner\n\t\t)]\n\t})\n";
+export declare const agentRuntimeSource = "import {\n\tcreateAgency,\n\tcreateAgentControlPlane,\n\tcreateMemoryAgencyStore,\n\tcreateMemoryAgentControlStore,\n\tdenyAllPolicy\n} from '@absolutejs/agency'\nimport {\n\tcreateAgentRuntime,\n\tcreateMemoryAgentRuntimeStore\n} from '@absolutejs/agent-runtime'\n\n// Memory stores are development defaults. Replace them with durable stores\n// before running more than one process or accepting production actions.\nexport const agentControl = createAgentControlPlane({\n\tsources: [],\n\tstore: createMemoryAgentControlStore()\n})\n\n// Intentionally deny-by-default. Replace denyAllPolicy() with your policy\n// decision point only after declaring each action's effects and scopes.\nexport const agency = createAgency({\n\tcontrol: agentControl,\n\tpolicy: denyAllPolicy(),\n\tstore: createMemoryAgencyStore()\n})\n\n// Durable run semantics are available from the first commit. The placeholder\n// driver fails closed until the application supplies its model/tool loop.\nexport const agentRuntime = createAgentRuntime({\n\tstore: createMemoryAgentRuntimeStore(),\n\tdriver: {\n\t\tnext: async () => ({\n\t\t\ttype: 'fail',\n\t\t\tcode: 'agent_not_configured',\n\t\t\tmessage: 'Configure the agent driver before accepting runs'\n\t\t})\n\t},\n\teffects: {\n\t\texecute: async () => {\n\t\t\tthrow new Error('Agent effects are not configured')\n\t\t}\n\t}\n})\n";
 export declare const agentsGuide = "# Agent execution contract\n\nThis project uses the AbsoluteJS provider-neutral agent stack.\n\n- Authenticate agents and bind every delegation to a user with\n  `@absolutejs/auth`. Never treat model-provided identity as authenticated.\n- Route every effectful tool through `agency` in `src/backend/agent.ts`.\n  Approval is exact-input-bound; execution requires a fresh single-use lease.\n- Declare tool effects, scopes, approval policy, idempotency keys,\n  reversibility, destinations, and spend fields in manifest contract 2.\n- Keep raw credentials host-side with `@absolutejs/secrets` credential\n  operations. Agents receive operation results, never secret values.\n- Give agents bounded wallet allowances and signed mandates. The host resolves\n  ledger destinations; an agent never supplies the recipient account id.\n- Bind MCP task handles to the authenticated actor on get, update, and cancel.\n- Use `@absolutejs/execution` for idempotent effects and its transactional\n  PostgreSQL outbox before handing work to a durable queue.\n- Publish and consume remote agents with `@absolutejs/a2a` using A2A 1.0;\n  preserve the authenticated tenant and actor binding at every task boundary.\n- Route outbound HTTP through `@absolutejs/egress`. Authorize host, method,\n  resolved public IP, redirects, byte limits, and injected credentials host-side.\n- Store immutable, digest-addressed policy revisions with `@absolutejs/policy`\n  and atomically activate only reviewed versions.\n- Publish the signed descriptor in `src/backend/agent-discovery.ts` through\n  `@absolutejs/agent-discovery`. Keep capabilities, examples, tags, effects,\n  scopes, A2A/MCP interfaces, JSON-LD, agents.txt, and sitemap surfaces current.\n- Run long-lived work through `@absolutejs/agent-runtime`; use its leases,\n  checkpoints, timers, budgets, cancellation, and crash-safe effect recovery.\n- Authorize all HTTP/filesystem/process access with expiring\n  `@absolutejs/agent-sandbox` grants. There is no ambient agent authority.\n- Preserve instruction/data separation and provenance taints with\n  `@absolutejs/agent-trust`; external content never becomes an instruction.\n- Store scoped, expiring, provenance-bearing data with\n  `@absolutejs/agent-memory`, and validate writes against memory poisoning.\n- Receive only verified events through `@absolutejs/agent-inbox`; durable\n  leases, retries, dead letters, and schedules do not require Redis.\n- Use OpenID AuthZEN AARP for requestable approvals and COAZ mappings for\n  parameter-level MCP authorization. Approval always triggers re-evaluation.\n- Protect operator actions with `@absolutejs/agent-control` scopes, a\n  kill-switch-first check, and leased idempotency records.\n- Use `@absolutejs/sync-bus-pg` for durable framework channels. Redis is an\n  optional at-most-once fanout adapter, not a source of truth or work queue.\n- Run `@absolutejs/agent-conformance` suites for every new action, capability,\n  credential, wallet, egress, execution, control, and task adapter.\n- Use the control plane kill switch for incident response. It blocks new\n  requests, lease issuance, and execution before downstream revocation fans out.\n\nMemory stores are for local development only. Production stores must be\ndurable and enforce lease/capability consumption atomically. Apply each\npackage's exported PostgreSQL schema in a migration before enabling traffic.\n";
 export declare const scaffoldAgentic: ({ backendDirectory, projectName }: {
     backendDirectory: string;

package/dist/generators/project/scaffoldAgentic.js

@@ -1,50 +1,5 @@
 import { mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
-export const agentRuntimeSource = `import {
-	createAgency,
-	createAgentControlPlane,
-	createMemoryAgencyStore,
-	createMemoryAgentControlStore,
-	denyAllPolicy
-} from '@absolutejs/agency'
-import {
-	createAgentRuntime,
-	createMemoryAgentRuntimeStore
-} from '@absolutejs/agent-runtime'
-
-// Memory stores are development defaults. Replace them with durable stores
-// before running more than one process or accepting production actions.
-export const agentControl = createAgentControlPlane({
-	sources: [],
-	store: createMemoryAgentControlStore()
-})
-
-// Intentionally deny-by-default. Replace denyAllPolicy() with your policy
-// decision point only after declaring each action's effects and scopes.
-export const agency = createAgency({
-	control: agentControl,
-	policy: denyAllPolicy(),
-	store: createMemoryAgencyStore()
-})
-
-// Durable run semantics are available from the first commit. The placeholder
-// driver fails closed until the application supplies its model/tool loop.
-export const agentRuntime = createAgentRuntime({
-	store: createMemoryAgentRuntimeStore(),
-	driver: {
-		next: async () => ({
-			type: 'fail',
-			code: 'agent_not_configured',
-			message: 'Configure the agent driver before accepting runs'
-		})
-	},
-	effects: {
-		execute: async () => {
-			throw new Error('Agent effects are not configured')
-		}
-	}
-})
-`;
 export const agentDiscoverySource = `import {
 	ABSOLUTE_AGENT_SCHEMA,
 	createAgentDiscoveryHandler,
@@ -122,6 +77,51 @@ export const createAgentDiscovery = async ({
 		)]
 	})
 `;
+export const agentRuntimeSource = `import {
+	createAgency,
+	createAgentControlPlane,
+	createMemoryAgencyStore,
+	createMemoryAgentControlStore,
+	denyAllPolicy
+} from '@absolutejs/agency'
+import {
+	createAgentRuntime,
+	createMemoryAgentRuntimeStore
+} from '@absolutejs/agent-runtime'
+
+// Memory stores are development defaults. Replace them with durable stores
+// before running more than one process or accepting production actions.
+export const agentControl = createAgentControlPlane({
+	sources: [],
+	store: createMemoryAgentControlStore()
+})
+
+// Intentionally deny-by-default. Replace denyAllPolicy() with your policy
+// decision point only after declaring each action's effects and scopes.
+export const agency = createAgency({
+	control: agentControl,
+	policy: denyAllPolicy(),
+	store: createMemoryAgencyStore()
+})
+
+// Durable run semantics are available from the first commit. The placeholder
+// driver fails closed until the application supplies its model/tool loop.
+export const agentRuntime = createAgentRuntime({
+	store: createMemoryAgentRuntimeStore(),
+	driver: {
+		next: async () => ({
+			type: 'fail',
+			code: 'agent_not_configured',
+			message: 'Configure the agent driver before accepting runs'
+		})
+	},
+	effects: {
+		execute: async () => {
+			throw new Error('Agent effects are not configured')
+		}
+	}
+})
+`;
 export const agentsGuide = `# Agent execution contract
 
 This project uses the AbsoluteJS provider-neutral agent stack.

package/dist/generators/project/scaffoldBackend.js

@@ -1,6 +1,7 @@
 import { mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
-import { generateAbsoluteAuthConfig, generateSessionUserType } from './generateAbsoluteAuthConfig';
+import { generateAbsoluteAuthConfig } from './generateAbsoluteAuthConfig';
+import { generateIdentity } from './generateIdentity';
 import { generateServerFile } from './generateServer';
 export const scaffoldBackend = ({ assetsDirectory, authOption, absProviders, backendDirectory, buildDirectory, databaseEngine, databaseHost, frontendDirectories, orm, plugins, publicDirectory, tailwind, typesDirectory }) => {
     generateServerFile({
@@ -17,17 +18,11 @@ export const scaffoldBackend = ({ assetsDirectory, authOption, absProviders, bac
         tailwind
     });
     if (authOption === 'abs') {
+        mkdirSync(typesDirectory, { recursive: true });
+        writeFileSync(join(typesDirectory, 'userIdentity.ts'), generateIdentity());
         mkdirSync(join(backendDirectory, 'utils'), { recursive: true });
         const hasDatabase = databaseEngine !== undefined && databaseEngine !== 'none';
         const absoluteAuthConfig = generateAbsoluteAuthConfig(absProviders, hasDatabase);
         writeFileSync(join(backendDirectory, 'utils', 'absoluteAuthConfig.ts'), absoluteAuthConfig, 'utf-8');
-        /* The auth config and the example page both import `User` from
-           types/databaseTypes, which scaffoldDatabase only writes when there is
-           a database. Without one, emit the session user shape on its own so the
-           auth scaffold still type-checks. */
-        if (!hasDatabase) {
-            mkdirSync(typesDirectory, { recursive: true });
-            writeFileSync(join(typesDirectory, 'databaseTypes.ts'), generateSessionUserType(), 'utf-8');
-        }
     }
 };

package/dist/generators/react/scaffoldReact.js

@@ -19,8 +19,8 @@ export const scaffoldReact = ({ authOption, directory, editBasePath, includeExam
        dependency of `@absolutejs/auth`. Without Absolute Auth the import cannot
        resolve, so the component is left out entirely. */
     cpSync(join(templatesDirectory, 'react'), targetDirectory, {
-        filter: (source) => authOption === 'abs' || basename(source) !== 'OAuthLink.tsx',
-        recursive: true
+        recursive: true,
+        filter: (source) => authOption === 'abs' || basename(source) !== 'OAuthLink.tsx'
     });
     const appComponent = generateAppComponent(frontends, editBasePath);
     writeFileSync(join(targetDirectory, 'components', 'App.tsx'), appComponent, 'utf-8');

package/dist/index.js

@@ -14,7 +14,7 @@ if (help === true) {
     exit(0);
 }
 const response = await prompt(argumentConfiguration);
-const { dockerFreshInstall } = await scaffold({
+const { databaseMigrationPending, dockerFreshInstall } = await scaffold({
     envVariables,
     latest,
     packageManager,
@@ -27,6 +27,7 @@ const debugMessage = debug !== false
     })
     : '';
 const outroMessage = getOutroMessage({
+    databaseMigrationPending,
     installDependenciesNow: response.installDependenciesNow,
     packageManager,
     projectName: response.projectName

package/dist/messages.d.ts

@@ -4,8 +4,9 @@ type OutroMessageProps = {
     projectName: string;
     packageManager: string;
     installDependenciesNow: boolean;
+    databaseMigrationPending: boolean;
 };
-export declare const getOutroMessage: ({ projectName, packageManager, installDependenciesNow }: OutroMessageProps) => string;
+export declare const getOutroMessage: ({ databaseMigrationPending, projectName, packageManager, installDependenciesNow }: OutroMessageProps) => string;
 type DebugMessageProps = {
     response: CreateConfiguration;
     packageManager: string;

package/dist/messages.js

@@ -46,9 +46,10 @@ Options:
   ${cyan('--vue')}                           Include a Vue frontend
   ${cyan('--vue-dir')} ${dim(cyan('<directory>'))}           Specify the directory for and use the Vue frontend
 `;
-export const getOutroMessage = ({ projectName, packageManager, installDependenciesNow }) => `${green('Created successfully')}, you can now run:\n\n` +
+export const getOutroMessage = ({ databaseMigrationPending, projectName, packageManager, installDependenciesNow }) => `${green('Created successfully')}, you can now run:\n\n` +
     `${cyan('cd')} ${projectName}\n` +
     `${installDependenciesNow ? '' : `${cyan(`${packageManager} install`)}\n`}` +
+    `${databaseMigrationPending ? `${cyan(`${packageManager} run db:migrate`)}\n` : ''}` +
     `${cyan(`${packageManager} dev`)}`; // TODO: Some package managers need run
 export const getDebugMessage = ({ response: { agentic, projectName, codeQualityTool, directoryConfig, useTailwind, tailwind, frontends, includeExamples, useHTMLScripts, frontendDirectories, buildDirectory, assetsDirectory, databaseEngine, databaseHost, databaseDirectory, orm, authOption, plugins, initializeGitNow, installDependenciesNow }, packageManager }) => {
     const htmlScriptingValue = useHTMLScripts

package/dist/prompt.js

@@ -1,5 +1,5 @@
-import { getAuthOption } from './questions/authOption';
 import { getAgentic } from './questions/agentic';
+import { getAuthOption } from './questions/authOption';
 import { getCodeQualityTool } from './questions/codeQualityTool';
 import { getConfigurationType } from './questions/configurationType';
 import { getDatabaseEngine } from './questions/databaseEngine';
@@ -97,8 +97,9 @@ export const prompt = async (argumentConfiguration) => {
     const installDependenciesNow = argumentConfiguration.installDependenciesNow ??
         (await orPrompt('--install/--no-install', getInstallDependencies));
     const values = {
+        // Google is the provider with a complete generated configuration.
+        absProviders: argumentConfiguration.absProviders?.filter((provider) => provider !== undefined) ?? (authOption === 'abs' ? ['google'] : undefined),
         agentic,
-        absProviders: argumentConfiguration.absProviders?.filter((provider) => provider !== undefined),
         assetsDirectory,
         authOption,
         buildDirectory,

package/dist/questions/authOption.js

@@ -6,7 +6,10 @@ export const getAuthOption = async () => {
         message: 'Auth provider:',
         options: [
             { label: 'None', value: 'none' },
-            { label: cyan('Absolute Auth'), value: 'abs' }
+            {
+                label: cyan('Absolute Auth (Google; requires a database)'),
+                value: 'abs'
+            }
         ]
     });
     if (isCancel(authOption))

package/dist/questions/databaseEngine.d.ts

@@ -1 +1 @@
-export declare const getDatabaseEngine: () => Promise<"gel" | "mariadb" | "mssql" | "mysql" | "postgresql" | "singlestore" | "sqlite" | "mongodb" | "cockroachdb" | undefined>;
+export declare const getDatabaseEngine: () => Promise<"cockroachdb" | "mariadb" | "mssql" | "mysql" | "postgresql" | "singlestore" | "sqlite" | "mongodb" | "gel" | undefined>;

package/dist/questions/orm.js

@@ -1,6 +1,6 @@
 import { select, isCancel } from '@clack/prompts';
-import { cyan, magenta } from 'picocolors';
-import { isDrizzleDialect, isPrismaDialect } from '../typeGuards';
+import { cyan } from 'picocolors';
+import { isDrizzleDialect } from '../typeGuards';
 import { abort } from '../utils/abort';
 export const getORM = async (databaseEngine) => {
     const options = [
@@ -9,9 +9,6 @@ export const getORM = async (databaseEngine) => {
     if (isDrizzleDialect(databaseEngine)) {
         options.push({ label: cyan('Drizzle'), value: 'drizzle' });
     }
-    if (isPrismaDialect(databaseEngine)) {
-        options.push({ label: magenta('Prisma'), value: 'prisma' });
-    }
     const orm = await select({
         message: 'Choose an ORM for your database:',
         options

package/dist/scaffold.d.ts

@@ -4,8 +4,10 @@ type ScaffoldProps = {
     packageManager: PackageManager;
     latest: boolean;
     envVariables: string[] | undefined;
+    verifyLocalDatabase?: boolean;
 };
-export declare const scaffold: ({ 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 }: ScaffoldProps) => Promise<{
+export declare const scaffold: ({ 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, envVariables, packageManager }: ScaffoldProps) => Promise<{
+    databaseMigrationPending: boolean;
     dockerFreshInstall: boolean;
 }>;
 export {};