#646 feat: add seed data for dummy users

[usrrname]

Changes

• adds seeds/ folder and script for opting in to seed dummy users

• include env_file property on docker-compose to read from .env variable changes a user might make during development

Testing:

created [email protected], was able to log in with autogenerated password

#646

TODO:

• make use of seed opt-in

[evert]

Was this tested if you got an error?

[usrrname]

Was this tested if you got an error?

Yep... working through these... tons of null value in column "field" of relation "table-name" violates not-null constraint

[evert]

Last night I did get something going in, but it was still breaking

I noticed this was force-pushed after. Was this still an issue? Don't 100% understand how that could happen!

[usrrname]

The force-push was a result of me making changes, squashing a commit and pushing it up :p

[usrrname]

Rebased... and still err-ing:

of note: PostgreSQL Database directory appears to contain a database; Skipping initialization
Seems like if there was already some data on a mounted volume, the migrations wont run.

Full Trace

Attaching to a12n-server-1, db-1
db-1           | 
db-1           | PostgreSQL Database directory appears to contain a database; Skipping initialization
db-1           | 
db-1           | 2025-03-17 23:20:34.425 UTC [1] LOG:  starting PostgreSQL 17.2 (Debian 17.2-1.pgdg120+1) on aarch64-unknown-linux-gnu, compiled by gcc (Debian 12.2.0-14) 12.2.0, 64-bit
db-1           | 2025-03-17 23:20:34.425 UTC [1] LOG:  listening on IPv4 address "0.0.0.0", port 5432
db-1           | 2025-03-17 23:20:34.425 UTC [1] LOG:  listening on IPv6 address "::", port 5432
db-1           | 2025-03-17 23:20:34.426 UTC [1] LOG:  listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432"
db-1           | 2025-03-17 23:20:34.429 UTC [29] LOG:  database system was shut down at 2025-03-17 23:19:02 UTC
db-1           | 2025-03-17 23:20:34.434 UTC [1] LOG:  database system is ready to accept connections
a12n-server-1  | ⚾ @curveball/a12n-server 0.30.0
a12n-server-1  | PUBLIC_URI environment variable was not set, defaulting to http://localhost:8531/
a12n-server-1  | Running database migrations
a12n-server-1  | Running database seeds
db-1           | 2025-03-17 23:20:35.294 UTC [33] ERROR:  column "principal_id" of relation "user_info" does not exist at character 73
db-1           | 2025-03-17 23:20:35.294 UTC [33] STATEMENT:  insert into "user_info" ("family_name", "given_name", "locale", "name", "principal_id") values ($1, $2, $3, $4, $5)
a12n-server-1  | Migrations failed Error: Error while executing "/opt/app/dist/seeds/001_users.js" seed: insert into "user_info" ("family_name", "given_name", "locale", "name", "principal_id") values ($1, $2, $3, $4, $5) - column "principal_id" of relation "user_info" does not exist
a12n-server-1  |     at Seeder._waterfallBatch (/opt/app/node_modules/knex/lib/migrations/seed/Seeder.js:118:23)
a12n-server-1  | error: insert into "user_info" ("family_name", "given_name", "locale", "name", "principal_id") values ($1, $2, $3, $4, $5) - column "principal_id" of relation "user_info" does not exist
a12n-server-1  |     at Parser.parseErrorMessage (/opt/app/node_modules/pg-protocol/dist/parser.js:283:98)
a12n-server-1  |     at Parser.handlePacket (/opt/app/node_modules/pg-protocol/dist/parser.js:122:29)
a12n-server-1  |     at Parser.parse (/opt/app/node_modules/pg-protocol/dist/parser.js:35:38)
a12n-server-1  |     at Socket.<anonymous> (/opt/app/node_modules/pg-protocol/dist/index.js:11:42)
a12n-server-1  |     at Socket.emit (node:events:524:28)
a12n-server-1  |     at addChunk (node:internal/streams/readable:561:12)
a12n-server-1  |     at readableAddChunkPushByteMode (node:internal/streams/readable:512:3)
a12n-server-1  |     at Readable.push (node:internal/streams/readable:392:5)
a12n-server-1  |     at TCP.onStreamRead (node:internal/stream_base_commons:191:23) {
a12n-server-1  |   original: error: insert into "user_info" ("family_name", "given_name", "locale", "name", "principal_id") values ($1, $2, $3, $4, $5) - column "principal_id" of relation "user_info" does not exist
a12n-server-1  |       at Parser.parseErrorMessage (/opt/app/node_modules/pg-protocol/dist/parser.js:283:98)
a12n-server-1  |       at Parser.handlePacket (/opt/app/node_modules/pg-protocol/dist/parser.js:122:29)
a12n-server-1  |       at Parser.parse (/opt/app/node_modules/pg-protocol/dist/parser.js:35:38)
a12n-server-1  |       at Socket.<anonymous> (/opt/app/node_modules/pg-protocol/dist/index.js:11:42)
a12n-server-1  |       at Socket.emit (node:events:524:28)
a12n-server-1  |       at addChunk (node:internal/streams/readable:561:12)
a12n-server-1  |       at readableAddChunkPushByteMode (node:internal/streams/readable:512:3)
a12n-server-1  |       at Readable.push (node:internal/streams/readable:392:5)
a12n-server-1  |       at TCP.onStreamRead (node:internal/stream_base_commons:191:23) {
a12n-server-1  |     length: 134,
a12n-server-1  |     severity: 'ERROR',
a12n-server-1  |     code: '42703',
a12n-server-1  |     detail: undefined,
a12n-server-1  |     hint: undefined,
a12n-server-1  |     position: '73',
a12n-server-1  |     internalPosition: undefined,
a12n-server-1  |     internalQuery: undefined,
a12n-server-1  |     where: undefined,
a12n-server-1  |     schema: undefined,
a12n-server-1  |     table: undefined,
a12n-server-1  |     column: undefined,
a12n-server-1  |     dataType: undefined,
a12n-server-1  |     constraint: undefined,
a12n-server-1  |     file: 'parse_target.c',
a12n-server-1  |     line: '1065',
a12n-server-1  |     routine: 'checkInsertTargets'
a12n-server-1  |   }
a12n-server-1  | }
a12n-server-1 exited with code 1
Gracefully stopping... (press Ctrl+C again to force)

[usrrname]

Now.. it seems I can set seed.user / process.env.SEED_USER or cors.allowOrigin/process.env.CORS_ALLOW_ORIGIN in .env independently. However, if I set both, I'll get this error when I try to login with the admin user

[usrrname]

Not sure what's going on here

[evert]

I think it's because the .yml is invalid :')

[usrrname]

Ohhh yeah I remember why I added the extra strategy with node versions now!

[usrrname]

I think this one is still there because that is what's on the `test.yml` on `main`

[Copilot]

Pull Request Overview

This PR adds a seed script for dummy users and wires seed support into the database configuration, local development tools, and documentation.

• Introduces src/seeds/001_users.ts to populate initial user data
• Extends Knex config and CLI targets (Makefile, GitHub Actions) to run seeds
• Updates docs (docs/server-settings.md, .github/CONTRIBUTING.md) and docker-compose.yml to document and enable environment-driven settings

Reviewed Changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/server-settings.ts	Removed stray blank lines
src/seeds/001_users.ts	New seed script to insert dummy users
src/database.ts	Registers the seed directory and adds a seed() API
docs/server-settings.md	Expanded settings table with environment-variable column
docker-compose.yml	Added env_file reference for .env
Makefile	Added knex-seed target
.github/workflows/test.yml	Runs seeds after migrations in matrix CI jobs
.github/CONTRIBUTING.md	Documented seed usage

Comments suppressed due to low confidence (3)

src/server-settings.ts:309

• The %s placeholder is never supplied an argument here, so row.setting won’t appear in the log. Pass row.setting as a second parameter to console.warn.

console.warn('The setting %s may not be set from the database. We ignored it');

docs/server-settings.md:16

• The new table header includes an “Environment Variable” column, but this row (and some below) has only four columns. Add the appropriate env var or a placeholder (—) to keep the table aligned.

| `login.defaultRedirect`     | String  | `/`         | The url that the user will be redirected to after the log in to a12nserver, and no other redirect_uri is provided by the application. It's a good idea to set this to your application URL.|

src/seeds/001_users.ts:35

• The new seed functionality is not covered by any tests. Adding a simple integration test to verify that seed() inserts the expected records could prevent regressions.

export async function seed(knex: Knex): Promise<void> {

[evert]

Lets go!