agor-live 0.22.0 → 0.23.2

package/dist/core/seed/demo-fixtures.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Demo Fixtures
+ *
+ * Lightweight, opt-in seeder that populates the database with a rich set of
+ * hardcoded FAKE data — users, card types, repos, a board with zones, branches,
+ * sessions with conversation transcripts, tasks, cards, and an artifact — so a
+ * fresh dev/test Agor environment is immediately usable for end-to-end testing.
+ *
+ * Unlike {@link seedDevFixtures} (`SEED=true`), this seeder performs PURE DB
+ * inserts: no git clones, no network, no executor. It is gated by the
+ * `LOAD_FIXTURES=true` switch and is orthogonal/composable with `SEED`.
+ *
+ * Everything is prefixed `demo-` / `demo.` so it never collides with the real
+ * `agor` repo (or its `test-branch`) created by {@link seedDevFixtures}.
+ *
+ * Idempotency / crash-safety: the entire load runs inside a SINGLE database
+ * transaction, so it is strictly all-or-nothing. A mid-run failure (or kill)
+ * rolls back every insert, leaving the DB exactly as it was. Because of that
+ * atomicity, the demo admin user (`demo.alice@agor.live`) is a valid TERMINAL
+ * sentinel: if it exists, the whole load committed, so re-running is a no-op.
+ *
+ * Demo users are loginable — passwords are bcrypt-hashed via the same path as
+ * real users (see {@link DEMO_USER_CREDENTIALS}); the cleartext is printed in
+ * the seed log so operators can sign in during E2E testing.
+ *
+ * Usage:
+ *   import { loadDemoFixtures } from '@agor/core/seed/demo-fixtures';
+ *   await loadDemoFixtures({ skipIfExists: true });
+ */
+import type { User, UUID } from '@agor/core/types';
+import type { Database } from '../db/client';
+/**
+ * Options for {@link loadDemoFixtures}.
+ *
+ * Mirrors {@link import('./dev-fixtures').SeedOptions} but `userId` is optional:
+ * demo fixtures create and own their own demo users, so no pre-existing admin
+ * is required. When `userId` IS provided (e.g. the bootstrapped admin passed by
+ * the docker entrypoint) that user is added as an owner of the demo board and
+ * branches so they show up immediately for the real operator too.
+ */
+export interface DemoFixturesOptions {
+    /**
+     * Optional real user to also grant ownership of the demo board/branches.
+     * Demo entities are still attributed to the demo users regardless.
+     */
+    userId?: UUID;
+    /**
+     * Skip if demo data already exists (idempotent). Re-running is a no-op.
+     */
+    skipIfExists?: boolean;
+    /**
+     * Inject a database instance (used by tests). When omitted, the database is
+     * resolved from `DATABASE_URL` / `AGOR_DB_DIALECT` like {@link seedDevFixtures}.
+     */
+    db?: Database;
+}
+export interface DemoFixturesResult {
+    skipped: boolean;
+    counts: {
+        users: number;
+        card_types: number;
+        repos: number;
+        boards: number;
+        branches: number;
+        sessions: number;
+        tasks: number;
+        messages: number;
+        cards: number;
+        artifacts: number;
+    };
+}
+/**
+ * Known cleartext credentials for the demo users (dev-only, LOAD_FIXTURES-gated).
+ * Stored hashed with bcrypt so the users are loginable for E2E testing.
+ */
+export declare const DEMO_USER_CREDENTIALS: ReadonlyArray<{
+    email: string;
+    password: string;
+    name: string;
+    emoji: string;
+    role: User['role'];
+}>;
+/**
+ * Load hardcoded demo fixtures into the database.
+ */
+export declare function loadDemoFixtures(options?: DemoFixturesOptions): Promise<DemoFixturesResult>;
+//# sourceMappingURL=demo-fixtures.d.ts.map

package/dist/core/seed/demo-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-fixtures.d.ts","sourceRoot":"","sources":["../../src/seed/demo-fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,KAAK,EASV,IAAI,EACJ,IAAI,EACL,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAiB7C;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IAEd;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;CACpB,CA6BA,CAAC;AA4BF;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAwlB7B"}

package/dist/core/seed/dev-fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-fixtures.d.ts","sourceRoot":"","sources":["../../src/seed/dev-fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAU,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAY/D,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,MAAM,EAAE,IAAI,CAAC;IAEb;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,QAAQ,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA6M/E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9E"}
+{"version":3,"file":"dev-fixtures.d.ts","sourceRoot":"","sources":["../../src/seed/dev-fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAU,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAa/D,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,MAAM,EAAE,IAAI,CAAC;IAEb;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,QAAQ,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA+N/E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9E"}