create-protobase 0.23.13 → 0.24.0

package/dist/templates/real-estate/seed/steps/maintenance.ts

@@ -0,0 +1,77 @@
+import type { Db } from '../../db/connection'
+import { ticketAt } from '../builders/ticket'
+import { tenanciesOf } from '../builders/allocation'
+import { DAY, windowEnd, windowStart } from '../calendar'
+import { copyRows } from '../copy'
+import { iso, isoDate, money, row } from '../format'
+import { int, pick, rngAt, weighted } from '../rng'
+import type { World } from '../world'
+import { unitsOf } from './portfolio'
+
+function* vendorRows(world: World) {
+  const createdAt = iso(windowStart - 2 * 365 * DAY)
+  for (const org of world.orgs) {
+    for (const vendor of org.vendors) {
+      const domain = `${vendor.name.toLowerCase().replace(/[^a-z]+/g, '')}.nl`
+      const rand = rngAt(org.seed + 16, vendor.id)
+      yield row(vendor.id, org.id, vendor.name, vendor.trade, `planning@${domain}`, `+31 ${int(rand, 10, 79)} ${int(rand, 1_000_000, 9_999_999)}`, money(vendor.rate * 100), true, createdAt, createdAt)
+    }
+  }
+}
+
+function* ticketRows(world: World) {
+  for (const org of world.orgs) {
+    for (let ordinal = 0; ordinal < org.ticketCount; ordinal++) {
+      const t = ticketAt(org, ordinal)
+      yield row(t.id, org.id, t.number, t.propertyId, t.unitId, t.reportedBy, t.assignedTo, t.category, t.priority, t.status, t.title, t.description, iso(t.reportedAt), t.closedAt === null ? null : iso(t.closedAt), iso(t.reportedAt), iso(t.updatedAt))
+    }
+  }
+}
+
+function* workOrderRows(world: World) {
+  let id = 1
+  for (const org of world.orgs) {
+    for (let ordinal = 0; ordinal < org.ticketCount; ordinal++) {
+      const ticket = ticketAt(org, ordinal)
+      for (const w of ticket.workOrders) {
+        const updatedAt = w.completedOn === null ? w.createdAt : Math.min(w.completedOn + 18 * 3_600_000, windowEnd)
+        yield row(id++, org.id, ticket.id, w.vendorId, isoDate(w.scheduledFor), w.completedOn === null ? null : isoDate(w.completedOn), w.hours?.toFixed(2) ?? null, w.costCents === null ? null : money(w.costCents), w.notes, iso(w.createdAt), iso(updatedAt))
+      }
+    }
+  }
+}
+
+const notes = { good: [null, 'Clean and complete.', 'Meter readings taken.'], fair: ['Wear on the floor in the living room.', 'Walls need painting.', 'Small damage to the kitchen worktop.'], poor: ['Holes in the walls, floor damaged.', 'Mould in the bathroom, needs treatment.', 'Garden neglected, rubbish left behind.'] } as const
+
+// A move-in inspection for every lease that starts in the window, a move-out for every one that ends in it, and now
+// and then a periodic one.
+function* inspectionRows(world: World) {
+  let id = 1
+  for (const org of world.orgs) {
+    for (const { property, unit, ordinal } of unitsOf(org)) {
+      const rand = rngAt(org.seed + 17, ordinal)
+      const inspection = (leaseId: number | null, kind: 'move_in' | 'move_out' | 'periodic', on: number, condition: 'good' | 'fair' | 'poor') => {
+        const recordedAt = Math.min(on + int(rand, 10, 17) * 3_600_000, windowEnd)
+        return row(id++, org.id, unit.id, leaseId, pick(rand, org.inspectors).id, kind, isoDate(on), condition, pick(rand, notes[condition]), iso(recordedAt), iso(recordedAt))
+      }
+      const tenancies = tenanciesOf(org.seed, ordinal, property.createdAt)
+      for (const [index, tenancy] of tenancies.entries()) {
+        const leaseId = org.leaseFirstId + org.leaseStarts[ordinal]! + index
+        const moveIn = tenancy.start - int(rand, 0, 2) * DAY
+        if (moveIn >= windowStart && moveIn <= windowEnd) yield inspection(leaseId, 'move_in', moveIn, weighted(rand, [['good', 80], ['fair', 18], ['poor', 2]] as const))
+        if (tenancy.end !== null && tenancy.end >= windowStart && tenancy.end <= windowEnd) yield inspection(leaseId, 'move_out', tenancy.end, weighted(rand, [['good', 45], ['fair', 40], ['poor', 15]] as const))
+      }
+      if (rand() < 0.3) {
+        const on = Math.floor((Math.max(windowStart, property.createdAt) + rand() * (windowEnd - Math.max(windowStart, property.createdAt))) / DAY) * DAY
+        yield inspection(null, 'periodic', on, weighted(rand, [['good', 70], ['fair', 25], ['poor', 5]] as const))
+      }
+    }
+  }
+}
+
+export const seedMaintenance = async (sql: Db, world: World) => {
+  await copyRows(sql, 'maintenance.vendors (id, organization_id, name, trade, email, phone, hourly_rate, active, created_at, updated_at)', vendorRows(world))
+  await copyRows(sql, 'maintenance.tickets (id, organization_id, number, property_id, unit_id, reported_by, assigned_to, category, priority, status, title, description, reported_at, closed_at, created_at, updated_at)', ticketRows(world))
+  await copyRows(sql, 'maintenance.work_orders (id, organization_id, ticket_id, vendor_id, scheduled_for, completed_on, hours, cost, notes, created_at, updated_at)', workOrderRows(world))
+  await copyRows(sql, 'maintenance.inspections (id, organization_id, unit_id, lease_id, inspector_id, kind, inspected_on, condition, notes, created_at, updated_at)', inspectionRows(world))
+}

package/dist/templates/real-estate/seed/steps/portfolio.ts

@@ -0,0 +1,97 @@
+import type { Db } from '../../db/connection'
+import { ownerAt, propertyAt, unitAt, type SeededProperty, type SeededUnit } from '../builders/property'
+import { tenanciesOf } from '../builders/allocation'
+import { unitStatus } from '../builders/tenancy'
+import { DAY, windowEnd } from '../calendar'
+import { copyRows } from '../copy'
+import type { AmenityCode } from '../data/reference'
+import { iso, isoDate, money, row } from '../format'
+import { int, rngAt } from '../rng'
+import type { Org, World } from '../world'
+
+function* ownerRows(world: World) {
+  for (const org of world.orgs) {
+    for (let ordinal = 0; ordinal < org.ownerCount; ordinal++) {
+      const owner = ownerAt(org, ordinal)
+      yield row(owner.id, org.id, owner.name, owner.kind, owner.email, owner.phone, owner.iban, owner.feePercent.toFixed(2), iso(owner.createdAt), iso(owner.createdAt))
+    }
+  }
+}
+
+function* propertyRows(world: World) {
+  for (const org of world.orgs) {
+    for (let ordinal = 0; ordinal < org.propertyCount; ordinal++) {
+      const p = propertyAt(org, ordinal)
+      yield row(p.id, org.id, p.ownerId, p.name, p.kind, p.street, p.houseNumber, p.postalCode, p.city, p.latitude, p.longitude, p.builtYear, iso(p.createdAt), iso(p.createdAt))
+    }
+  }
+}
+
+// Every unit with its property, in unit order.
+export function* unitsOf(org: Org): Generator<{ property: SeededProperty; unit: SeededUnit; ordinal: number }> {
+  for (let p = 0; p < org.propertyCount; p++) {
+    const property = propertyAt(org, p)
+    for (let ordinal = org.unitStarts[p]!; ordinal < org.unitStarts[p + 1]!; ordinal++) yield { property, unit: unitAt(org, property, ordinal), ordinal }
+  }
+}
+
+function* unitRows(world: World) {
+  for (const org of world.orgs) {
+    for (const { property, unit, ordinal } of unitsOf(org)) {
+      const status = unitStatus(tenanciesOf(org.seed, ordinal, property.createdAt))
+      yield row(unit.id, org.id, property.id, unit.label, unit.floor, unit.bedrooms, unit.area, unit.energyLabel, money(unit.baseRentCents), status, iso(unit.createdAt), iso(unit.createdAt))
+    }
+  }
+}
+
+// Amenities by kind of home, with how often a unit has each.
+const houseAmenities: Array<[AmenityCode, number]> = [['garden', 0.85], ['parking', 0.4], ['storage_room', 0.3], ['solar_panels', 0.35], ['heat_pump', 0.15], ['furnished', 0.03]]
+const flatAmenities: Array<[AmenityCode, number]> = [['balcony', 0.6], ['bike_storage', 0.5], ['storage_room', 0.35], ['parking', 0.2], ['solar_panels', 0.1], ['heat_pump', 0.08], ['furnished', 0.08]]
+
+function* unitAmenityRows(world: World) {
+  for (const org of world.orgs) {
+    for (const { property, unit, ordinal } of unitsOf(org)) {
+      const rand = rngAt(org.seed + 14, ordinal)
+      const codes = (property.kind === 'single_family' ? houseAmenities : flatAmenities).filter(([, chance]) => rand() < chance).map(([code]) => code)
+      if (property.kind !== 'single_family' && property.units > 12) codes.push('lift')
+      if (unit.topFloor && rand() < 0.25) codes.push('roof_terrace')
+      for (const code of codes) yield row(unit.id, code, org.id, iso(unit.createdAt))
+    }
+  }
+}
+
+// Market value per m2 from the rent per m2, and how prices moved year on year.
+const valueYears = [[2023, 0.93], [2024, 0.96], [2025, 1.0], [2026, 1.06]] as const
+
+function* valuationRows(world: World) {
+  let id = 1
+  for (const org of world.orgs) {
+    for (let ordinal = 0; ordinal < org.propertyCount; ordinal++) {
+      const property = propertyAt(org, ordinal)
+      let area = 0
+      for (let unit = org.unitStarts[ordinal]!; unit < org.unitStarts[ordinal + 1]!; unit++) area += unitAt(org, property, unit).area
+      const rand = rngAt(org.seed + 15, ordinal)
+      const perM2 = property.rentPerM2 * 210 * (0.85 + rand() * 0.3)
+      for (const [year, factor] of valueYears) {
+        const valuedOn = Date.UTC(year, 0, 1)
+        if (valuedOn < property.createdAt) continue
+        const value = Math.round((area * perM2 * factor) / 1000) * 1000
+        yield row(id++, org.id, property.id, isoDate(valuedOn), money(value * 100), 'woz', iso(valuedOn + 40 * DAY), iso(valuedOn + 40 * DAY))
+      }
+      if (rand() < 0.12) {
+        const valuedOn = Math.floor((property.createdAt + rand() * (windowEnd - property.createdAt)) / DAY) * DAY
+        const value = Math.round((area * perM2 * (1.05 + rand() * 0.2)) / 1000) * 1000
+        const recordedAt = Math.min(valuedOn + int(rand, 3, 20) * DAY, windowEnd)
+        yield row(id++, org.id, property.id, isoDate(valuedOn), money(value * 100), 'appraisal', iso(recordedAt), iso(recordedAt))
+      }
+    }
+  }
+}
+
+export const seedPortfolio = async (sql: Db, world: World) => {
+  await copyRows(sql, 'portfolio.owners (id, organization_id, name, kind, email, phone, iban, management_fee_percent, created_at, updated_at)', ownerRows(world))
+  await copyRows(sql, 'portfolio.properties (id, organization_id, owner_id, name, kind, street, house_number, postal_code, city, latitude, longitude, built_year, created_at, updated_at)', propertyRows(world))
+  await copyRows(sql, 'portfolio.units (id, organization_id, property_id, label, floor, bedrooms, area_m2, energy_label, base_rent, status, created_at, updated_at)', unitRows(world))
+  await copyRows(sql, 'portfolio.unit_amenities (unit_id, amenity_code, organization_id, added_at)', unitAmenityRows(world))
+  await copyRows(sql, 'portfolio.valuations (id, organization_id, property_id, valued_on, value, source, created_at, updated_at)', valuationRows(world))
+}

package/dist/templates/real-estate/seed/steps/reference.ts

@@ -0,0 +1,21 @@
+import type { Db } from '../../db/connection'
+import { DAY, windowStart } from '../calendar'
+import { copyRows } from '../copy'
+import { amenities } from '../data/reference'
+import { iso, row } from '../format'
+import type { World } from '../world'
+
+export const seedReference = async (sql: Db, world: World) => {
+  const createdAt = iso(windowStart - 10 * 365 * DAY)
+  await copyRows(sql, 'portfolio.amenities (code, name)', amenities.map((amenity) => row(...amenity)))
+  await copyRows(
+    sql,
+    'core.organizations (id, name, slug, city, kvk_number, created_at, updated_at)',
+    world.orgs.map((org) => row(org.id, org.name, org.slug, org.city, org.kvk, createdAt, createdAt)),
+  )
+  await copyRows(
+    sql,
+    'core.users (id, organization_id, email, name, role, active, created_at, updated_at)',
+    world.orgs.flatMap((org) => org.users.map((user) => row(user.id, org.id, user.email, user.name, user.role, true, createdAt, createdAt))),
+  )
+}

package/dist/templates/real-estate/seed/world.ts

@@ -0,0 +1,92 @@
+import { coSigned, propertyAcquiredAt, propertyShapeAt, tenanciesOf } from './builders/allocation'
+import { timestamps } from './calendar'
+import { orgSpecs } from './data/reference'
+import { scales, type ScaleName } from './scales'
+
+// Splits a scale total over the organizations by share; the last one takes the remainder.
+const splitTotal = (total: number) => {
+  const parts: number[] = []
+  for (const [index, spec] of orgSpecs.entries()) {
+    parts.push(index === orgSpecs.length - 1 ? total - parts.reduce((sum, part) => sum + part, 0) : Math.round(total * spec.share))
+  }
+  return parts
+}
+
+// Every table's ids are allocated here, so builders can compute foreign keys without lookups. Tables whose rows are
+// only ever referenced from inside one step (charges, payments, work orders, inspections, valuations) number their
+// rows as the step streams them.
+export const buildWorld = (name: ScaleName) => {
+  const scale = scales[name]
+  const properties = splitTotal(scale.properties)
+  const next = { user: 1, owner: 1, property: 1, unit: 1, lease: 1, tenant: 1, vendor: 1, ticket: 1 }
+
+  const orgs = orgSpecs.map((spec, index) => {
+    const propertyCount = properties[index]!
+    const unitStarts = new Uint32Array(propertyCount + 1)
+    for (let ordinal = 0; ordinal < propertyCount; ordinal++) unitStarts[ordinal + 1] = unitStarts[ordinal]! + propertyShapeAt(spec.seed, ordinal).units
+    const unitCount = unitStarts[propertyCount]!
+
+    // Per unit: its property, and where its leases start in the organization's lease numbering.
+    const unitProperty = new Uint32Array(unitCount)
+    const leaseStarts = new Uint32Array(unitCount + 1)
+    for (let property = 0; property < propertyCount; property++) {
+      const acquiredAt = propertyAcquiredAt(spec.seed, property)
+      for (let unit = unitStarts[property]!; unit < unitStarts[property + 1]!; unit++) {
+        unitProperty[unit] = property
+        leaseStarts[unit + 1] = leaseStarts[unit]! + tenanciesOf(spec.seed, unit, acquiredAt).length
+      }
+    }
+    const leaseCount = leaseStarts[unitCount]!
+
+    // Per lease: where its tenants start; a co-signed lease has two.
+    const tenantStarts = new Uint32Array(leaseCount + 1)
+    for (let lease = 0; lease < leaseCount; lease++) tenantStarts[lease + 1] = tenantStarts[lease]! + (coSigned(spec.seed, lease) ? 2 : 1)
+
+    const users = spec.users.map(([first, initial, role], position) => ({
+      id: next.user + position,
+      name: `${first} ${initial}`,
+      email: `${first.toLowerCase()}@${spec.slug}.example`,
+      role,
+    }))
+    const vendors = spec.vendors.map(([vendorName, trade, rate], position) => ({ id: next.vendor + position, name: vendorName, trade, rate }))
+    const ticketCount = Math.round(unitCount * scale.ticketsPerUnit)
+    const org = {
+      ...spec,
+      users,
+      managers: users.filter((user) => user.role === 'manager'),
+      maintenanceUsers: users.filter((user) => user.role === 'maintenance'),
+      inspectors: users.filter((user) => user.role === 'manager' || user.role === 'maintenance'),
+      vendors,
+      ownerCount: Math.max(3, Math.round(propertyCount / 6)),
+      ownerFirstId: next.owner,
+      propertyCount,
+      propertyFirstId: next.property,
+      unitStarts,
+      unitCount,
+      unitProperty,
+      unitFirstId: next.unit,
+      leaseStarts,
+      leaseCount,
+      leaseFirstId: next.lease,
+      tenantStarts,
+      tenantFirstId: next.tenant,
+      ticketCount,
+      ticketFirstId: next.ticket,
+      ticketTimes: timestamps(ticketCount, spec.seed + 10),
+    }
+    next.user += users.length
+    next.owner += org.ownerCount
+    next.property += propertyCount
+    next.unit += unitCount
+    next.lease += leaseCount
+    next.tenant += tenantStarts[leaseCount]!
+    next.vendor += vendors.length
+    next.ticket += ticketCount
+    return org
+  })
+
+  return { name, orgs }
+}
+
+export type World = ReturnType<typeof buildWorld>
+export type Org = World['orgs'][number]

package/dist/templates/real-estate/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "lib": ["ES2023", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "exclude": ["node_modules", "dist"]
+}

package/dist/templates/real-estate/vitest.config.ts

@@ -0,0 +1,4 @@
+import { defineConfig } from 'vitest/config'
+
+// The unit tests next to the config and the seed; none of them needs a database.
+export default defineConfig({ test: { include: ['config/**/*.test.ts', 'seed/**/*.test.ts'] } })

package/dist/templates/scratch/_.gitignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+.env

package/dist/templates/scratch/_bunfig.toml

@@ -0,0 +1,4 @@
+# `bun run` runs scripts and package bins on Bun even when Node is on PATH, whose `#!/usr/bin/env node` would otherwise
+# start Node.
+[run]
+bun = true

package/dist/templates/scratch/db/migrate.ts

@@ -0,0 +1,30 @@
+import { readdir, readFile } from 'node:fs/promises'
+import { fileURLToPath } from 'node:url'
+import { connect } from './connection'
+
+// Applies the migrations not applied yet, the app's and the auth schema's alike, in file name order and in one
+// transaction: when one fails, none is applied and the database stays as the running version expects it. Run it before
+// a new version serves, while nothing else writes. A statement Postgres runs only outside a transaction, such as
+// `create index concurrently`, does not belong in these files.
+
+const directory = fileURLToPath(new URL('./migrations/', import.meta.url))
+// Any constant shared by every run of this script: two runs at once take turns.
+const lockKey = 7_311_946_202
+
+const sql = connect({ max: 1 })
+const files = (await readdir(directory)).filter((file) => file.endsWith('.sql')).sort()
+
+const applied = await sql.begin(async (tx) => {
+  await tx`select pg_advisory_xact_lock(${lockKey})`
+  await tx`create table if not exists public.schema_migrations (name text primary key, applied_at timestamptz not null default now())`
+  const done = new Set((await tx`select name from public.schema_migrations`).map((row) => row.name))
+  const pending = files.filter((file) => !done.has(file))
+  for (const file of pending) {
+    await tx.unsafe(await readFile(directory + file, 'utf8'))
+    await tx`insert into public.schema_migrations (name) values (${file})`
+  }
+  return pending
+})
+for (const file of applied) console.log(`applied ${file}`)
+
+await sql.end()

package/dist/templates/scratch/db/migrations/001_auth.sql

@@ -0,0 +1,36 @@
+-- The auth schema changes this version of Protobase needs, written by `protobase auth migration`.
+-- Applied with the project's other migrations; edit or remove statements the project handles differently.
+
+create schema if not exists "auth";
+
+create table if not exists "auth"."user" ("id" text not null primary key, "name" text not null, "email" text not null unique, "email_verified" boolean not null, "image" text, "created_at" timestamptz default CURRENT_TIMESTAMP not null, "updated_at" timestamptz default CURRENT_TIMESTAMP not null, "role" text, "banned" boolean, "ban_reason" text, "ban_expires" timestamptz, "two_factor_enabled" boolean);
+
+create table if not exists "auth"."session" ("id" text not null primary key, "expires_at" timestamptz not null, "token" text not null unique, "created_at" timestamptz default CURRENT_TIMESTAMP not null, "updated_at" timestamptz not null, "ip_address" text, "user_agent" text, "user_id" text not null references "auth"."user" ("id") on delete cascade, "impersonated_by" text);
+
+create table if not exists "auth"."account" ("id" text not null primary key, "account_id" text not null, "provider_id" text not null, "user_id" text not null references "auth"."user" ("id") on delete cascade, "access_token" text, "refresh_token" text, "id_token" text, "access_token_expires_at" timestamptz, "refresh_token_expires_at" timestamptz, "scope" text, "password" text, "created_at" timestamptz default CURRENT_TIMESTAMP not null, "updated_at" timestamptz not null);
+
+create table if not exists "auth"."verification" ("id" text not null primary key, "identifier" text not null, "value" text not null, "expires_at" timestamptz not null, "created_at" timestamptz default CURRENT_TIMESTAMP not null, "updated_at" timestamptz default CURRENT_TIMESTAMP not null);
+
+create table if not exists "auth"."jwks" ("id" text not null primary key, "public_key" text not null, "private_key" text not null, "created_at" timestamptz not null, "expires_at" timestamptz, "alg" text, "crv" text);
+
+create table if not exists "auth"."two_factor" ("id" text not null primary key, "secret" text not null, "backup_codes" text not null, "user_id" text not null references "auth"."user" ("id") on delete cascade, "verified" boolean, "failed_verification_count" integer, "locked_until" timestamptz);
+
+create table if not exists "auth"."passkey" ("id" text not null primary key, "name" text, "public_key" text not null, "user_id" text not null references "auth"."user" ("id") on delete cascade, "credential_id" text not null, "counter" integer not null, "device_type" text not null, "backed_up" boolean not null, "transports" text, "created_at" timestamptz, "aaguid" text);
+
+create table if not exists "auth"."sign_in_policy" ("id" text not null primary key, "password" text not null, "email_code" text not null, "passkey" text not null, "two_factor" text not null, "staff_access" text not null, "platform_sign_in" text not null, "created_at" timestamptz not null, "created_by" text);
+
+create table if not exists "auth"."staff_sign_in" ("id" text not null primary key, "user_id" text not null, "user_email" text not null, "staff" text not null, "staff_name" text, "staff_subject" text not null, "issuer" text not null, "reason" text not null, "session_id" text not null, "started_at" timestamptz not null, "expires_at" timestamptz not null, "ended_at" timestamptz);
+
+create index if not exists "session_user_id_idx" on "auth"."session" ("user_id");
+
+create index if not exists "account_user_id_idx" on "auth"."account" ("user_id");
+
+create index if not exists "verification_identifier_idx" on "auth"."verification" ("identifier");
+
+create index if not exists "two_factor_secret_idx" on "auth"."two_factor" ("secret");
+
+create index if not exists "two_factor_user_id_idx" on "auth"."two_factor" ("user_id");
+
+create index if not exists "passkey_user_id_idx" on "auth"."passkey" ("user_id");
+
+create index if not exists "passkey_credential_id_idx" on "auth"."passkey" ("credential_id");

package/dist/templates/scratch/db/migrations/002_auth_snake_case.sql

@@ -0,0 +1,109 @@
+-- The auth schema changes this version of Protobase needs, written by `protobase auth migration`.
+-- Applied with the project's other migrations; edit or remove statements the project handles differently.
+
+-- Renames the auth store of Protobase 0.6 to snake_case. A store set up with the snake_case names has no "emailVerified"
+-- and is left as it is.
+do $$
+declare
+  constraint_row record;
+begin
+  if not exists (select from information_schema.columns where table_schema = 'auth' and table_name = 'user' and column_name = 'emailVerified') then
+    return;
+  end if;
+
+  alter table "auth"."twoFactor" rename to two_factor;
+  alter table "auth"."signInPolicy" rename to sign_in_policy;
+  alter table "auth"."staffSignIn" rename to staff_sign_in;
+
+  alter table "auth"."user" rename column "emailVerified" to email_verified;
+  alter table "auth"."user" rename column "createdAt" to created_at;
+  alter table "auth"."user" rename column "updatedAt" to updated_at;
+  alter table "auth"."user" rename column "banReason" to ban_reason;
+  alter table "auth"."user" rename column "banExpires" to ban_expires;
+  alter table "auth"."user" rename column "twoFactorEnabled" to two_factor_enabled;
+
+  alter table "auth".session rename column "expiresAt" to expires_at;
+  alter table "auth".session rename column "createdAt" to created_at;
+  alter table "auth".session rename column "updatedAt" to updated_at;
+  alter table "auth".session rename column "ipAddress" to ip_address;
+  alter table "auth".session rename column "userAgent" to user_agent;
+  alter table "auth".session rename column "userId" to user_id;
+  alter table "auth".session rename column "impersonatedBy" to impersonated_by;
+
+  alter table "auth".account rename column "accountId" to account_id;
+  alter table "auth".account rename column "providerId" to provider_id;
+  alter table "auth".account rename column "userId" to user_id;
+  alter table "auth".account rename column "accessToken" to access_token;
+  alter table "auth".account rename column "refreshToken" to refresh_token;
+  alter table "auth".account rename column "idToken" to id_token;
+  alter table "auth".account rename column "accessTokenExpiresAt" to access_token_expires_at;
+  alter table "auth".account rename column "refreshTokenExpiresAt" to refresh_token_expires_at;
+  alter table "auth".account rename column "createdAt" to created_at;
+  alter table "auth".account rename column "updatedAt" to updated_at;
+
+  alter table "auth".verification rename column "expiresAt" to expires_at;
+  alter table "auth".verification rename column "createdAt" to created_at;
+  alter table "auth".verification rename column "updatedAt" to updated_at;
+
+  alter table "auth".jwks rename column "publicKey" to public_key;
+  alter table "auth".jwks rename column "privateKey" to private_key;
+  alter table "auth".jwks rename column "createdAt" to created_at;
+  alter table "auth".jwks rename column "expiresAt" to expires_at;
+
+  alter table "auth".two_factor rename column "backupCodes" to backup_codes;
+  alter table "auth".two_factor rename column "userId" to user_id;
+  alter table "auth".two_factor rename column "failedVerificationCount" to failed_verification_count;
+  alter table "auth".two_factor rename column "lockedUntil" to locked_until;
+
+  alter table "auth".passkey rename column "publicKey" to public_key;
+  alter table "auth".passkey rename column "userId" to user_id;
+  alter table "auth".passkey rename column "credentialID" to credential_id;
+  alter table "auth".passkey rename column "deviceType" to device_type;
+  alter table "auth".passkey rename column "backedUp" to backed_up;
+  alter table "auth".passkey rename column "createdAt" to created_at;
+
+  alter table "auth".sign_in_policy rename column "emailCode" to email_code;
+  alter table "auth".sign_in_policy rename column "twoFactor" to two_factor;
+  alter table "auth".sign_in_policy rename column "staffAccess" to staff_access;
+  alter table "auth".sign_in_policy rename column "platformSignIn" to platform_sign_in;
+  alter table "auth".sign_in_policy rename column "createdAt" to created_at;
+  alter table "auth".sign_in_policy rename column "createdBy" to created_by;
+
+  alter table "auth".staff_sign_in rename column "userId" to user_id;
+  alter table "auth".staff_sign_in rename column "userEmail" to user_email;
+  alter table "auth".staff_sign_in rename column "staffName" to staff_name;
+  alter table "auth".staff_sign_in rename column "staffSubject" to staff_subject;
+  alter table "auth".staff_sign_in rename column "sessionId" to session_id;
+  alter table "auth".staff_sign_in rename column "startedAt" to started_at;
+  alter table "auth".staff_sign_in rename column "expiresAt" to expires_at;
+  alter table "auth".staff_sign_in rename column "endedAt" to ended_at;
+
+  -- A primary key's index takes the new name with it.
+  alter table "auth".two_factor rename constraint "twoFactor_pkey" to two_factor_pkey;
+  alter table "auth".sign_in_policy rename constraint "signInPolicy_pkey" to sign_in_policy_pkey;
+  alter table "auth".staff_sign_in rename constraint "staffSignIn_pkey" to staff_sign_in_pkey;
+  alter table "auth".session rename constraint "session_userId_fkey" to session_user_id_fkey;
+  alter table "auth".account rename constraint "account_userId_fkey" to account_user_id_fkey;
+  alter table "auth".two_factor rename constraint "twoFactor_userId_fkey" to two_factor_user_id_fkey;
+  alter table "auth".passkey rename constraint "passkey_userId_fkey" to passkey_user_id_fkey;
+
+  alter index "auth"."session_userId_idx" rename to session_user_id_idx;
+  alter index "auth"."account_userId_idx" rename to account_user_id_idx;
+  alter index "auth"."twoFactor_secret_idx" rename to two_factor_secret_idx;
+  alter index "auth"."twoFactor_userId_idx" rename to two_factor_user_id_idx;
+  alter index "auth"."passkey_userId_idx" rename to passkey_user_id_idx;
+  alter index "auth"."passkey_credentialID_idx" rename to passkey_credential_id_idx;
+
+  -- Postgres 18 names each not-null constraint after its table and column, as "user_emailVerified_not_null"; earlier
+  -- versions keep no such constraints, so there is nothing to rename there.
+  for constraint_row in
+    select c.conrelid::regclass as table_name, c.conname as old_name, t.relname || '_' || a.attname || '_not_null' as new_name
+    from pg_constraint c
+    join pg_class t on t.oid = c.conrelid
+    join pg_attribute a on a.attrelid = c.conrelid and a.attnum = c.conkey[1]
+    where c.contype = 'n' and t.relnamespace = (select oid from pg_namespace where nspname = 'auth') and c.conname ~ '[A-Z]'
+  loop
+    execute format('alter table %s rename constraint %I to %I', constraint_row.table_name, constraint_row.old_name, constraint_row.new_name);
+  end loop;
+end
+$$;

package/dist/templates/scratch/db/migrations/003_auth.sql

@@ -0,0 +1,6 @@
+-- The auth schema changes this version of Protobase needs, written by `protobase auth migration`.
+-- Applied with the project's other migrations; edit or remove statements the project handles differently.
+
+alter table "auth"."user" add column if not exists "last_role" text;
+
+alter table "auth"."session" add column if not exists "active_role" text;

package/dist/templates/scratch/db/migrations/004_auth.sql

@@ -0,0 +1,4 @@
+-- The auth schema changes this version of Protobase needs, written by `protobase migration`.
+-- Applied with the project's other migrations; edit or remove statements the project handles differently.
+
+alter table "auth"."passkey" add column if not exists "rp_id" text;

package/dist/templates/scratch/node-types.d.ts

@@ -0,0 +1 @@
+/// <reference types="node" />

package/dist/{template → templates/scratch}/package.json

@@ -13,11 +13,11 @@
     "dev": "protobase dev"
   },
   "dependencies": {
-    "@protobase/cli": ">=0.23.13 <1",
-    "@protobase/layout": ">=0.23.13 <1",
-    "@protobase/schema": ">=0.23.13 <1",
-    "@protobase/server": ">=0.23.13 <1",
-    "@protobase/ui": ">=0.23.13 <1",
+    "@protobase/cli": ">=0.24.0 <1",
+    "@protobase/layout": ">=0.24.0 <1",
+    "@protobase/schema": ">=0.24.0 <1",
+    "@protobase/server": ">=0.24.0 <1",
+    "@protobase/ui": ">=0.24.0 <1",
     "better-auth": "^1.7.7",
     "jose": "^6.2.12",
     "kysely": "^0.29.6",

package/dist/templates/scratch/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "lib": ["ES2023", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "exclude": ["node_modules", "dist"]
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-protobase",
-  "version": "0.23.13",
-  "description": "npm create protobase: starts a new Protobase project from scratch.",
+  "version": "0.24.0",
+  "description": "npm create protobase: starts a new Protobase project from one of its presets.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",