@uniweb/api 0.2.12 → 0.2.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/api",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "description": "The client for a Uniweb site's own backend — session, records, entities — imported by a foundation the way it imports @uniweb/kit.",
   "type": "module",
   "exports": {

package/src/mock/index.js

@@ -38,11 +38,14 @@ import { DEFAULT_SEED } from './seed.js'
  *
  * @param {object} [options]
  * @param {object} [options.seed] - accounts, schemas and entities to start from
+ * @param {string} [options.signedInAs] - a seeded `username` to start signed in as, for a
+ *        demo whose subject is the signed-in view. Development-only by construction, since
+ *        this whole module is; throws if the username is not seeded.
  * @param {string} [options.prefix] - the path the API is mounted under (default `/api`)
  * @returns {{ fetch: (request: Request) => Promise<Response>, store: MockStore }}
  */
-export function createMockBackend({ seed = DEFAULT_SEED, prefix = '/api' } = {}) {
-  const store = new MockStore(seed)
+export function createMockBackend({ seed = DEFAULT_SEED, prefix = '/api', signedInAs = null } = {}) {
+  const store = new MockStore(seed, { signedInAs })
 
   const json = (status, body) =>
     new Response(body === undefined ? null : JSON.stringify(body), {

package/src/mock/store.js

@@ -33,8 +33,10 @@ export class MockStore {
    * @param {object[]} [seed.accounts] - `{ username, password, handle, roles?, units? }`
    * @param {object} [seed.schemas] - `{ '@/session': { creatable_by?, append_only? } }`
    * @param {object[]} [seed.entities] - `{ uuid?, model, data?, items? }`
+   * @param {object} [options]
+   * @param {string} [options.signedInAs] - start with this account already signed in.
    */
-  constructor(seed = {}) {
+  constructor(seed = {}, { signedInAs = null } = {}) {
     this.accounts = (seed.accounts || []).map((a) => ({
       uuid: a.uuid || nextId('acct'),
       username: a.username,
@@ -52,6 +54,26 @@ export class MockStore {
     /** The one session. A mock serves one developer, so one is the honest number. */
     this.session = null
     this.resets = new Map()
+
+    // ⭐ `signedInAs` — start already signed in, for a demo whose whole point is the
+    // signed-in view. Without it a visitor must type credentials before seeing
+    // anything, which for a lived-in demo is the experience itself.
+    //
+    // ⛔ THROWS on an unknown username rather than leaving the session null. A typo
+    // here produces "why am I not logged in?" — a question with no visible cause, in
+    // the one place where the answer is a string three lines away. The mock is
+    // development-only, so failing at construction costs nothing and a silent
+    // anonymous session costs an afternoon.
+    if (signedInAs) {
+      const account = this.accounts.find((a) => a.username === signedInAs)
+      if (!account) {
+        const known = this.accounts.map((a) => a.username).join(', ') || '(none)'
+        throw new Error(
+          `[uniweb/api mock] signedInAs: '${signedInAs}' is not a seeded account. Seeded: ${known}`
+        )
+      }
+      this.session = { account, at: now() }
+    }
   }
 
   seedEntity({ uuid, model, data = {}, items = [], owner = null }) {