@adminiumjs/adminium 0.1.0-rc.1

package/dist/routes/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/routes/notifications/index.ts"],"names":[],"mappings":"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"}

package/dist/routes/notifications/schema.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Zod schemas for the notification-centre resource (M7 reports/notifications
+ * track; 07-meta-store.md §3.20/§3.21, 09-generated-app.md §5.4):
+ * `/me/notifications` (keyset list + read transitions) and
+ * `/me/notification-prefs` (event × channel matrix).
+ */
+import { z } from 'zod';
+export declare const notificationView: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodString;
+    actorLabel: z.ZodString;
+    title: z.ZodString;
+    body: z.ZodNullable<z.ZodString>;
+    entity: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    actionUrl: z.ZodNullable<z.ZodString>;
+    readAt: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodNumber;
+}, z.core.$strip>;
+export type NotificationView = z.infer<typeof notificationView>;
+/** Opaque keyset cursor: `<createdAt>:<id>` of the previous page's last row. */
+export declare const notificationCursorRe: RegExp;
+export declare const notificationsListQuery: z.ZodObject<{
+    unread: z.ZodDefault<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    before: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const notificationsListReply: z.ZodObject<{
+    data: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            actorLabel: z.ZodString;
+            title: z.ZodString;
+            body: z.ZodNullable<z.ZodString>;
+            entity: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            actionUrl: z.ZodNullable<z.ZodString>;
+            readAt: z.ZodNullable<z.ZodNumber>;
+            createdAt: z.ZodNumber;
+        }, z.core.$strip>>;
+        unreadCount: z.ZodNumber;
+        nextCursor: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const notificationIdParams: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export declare const notificationReadReply: z.ZodObject<{
+    data: z.ZodObject<{
+        updated: z.ZodBoolean;
+        unreadCount: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const notificationsReadAllReply: z.ZodObject<{
+    data: z.ZodObject<{
+        updated: z.ZodNumber;
+        unreadCount: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** §3.21 event keys: dotted kebab/lower segments, same grammar as `kind`. */
+export declare const eventKeySchema: z.ZodString;
+/**
+ * One delivery channel's availability. `available: false` ALWAYS carries a
+ * `reason` — the §8.2 never-hide-always-explain rule: the client renders the
+ * toggle (intent is stored) plus the explanation, never a silent gap.
+ */
+export declare const channelAvailabilityView: z.ZodObject<{
+    id: z.ZodEnum<{
+        push: "push";
+        email: "email";
+        inApp: "inApp";
+    }>;
+    available: z.ZodBoolean;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ChannelAvailabilityView = z.infer<typeof channelAvailabilityView>;
+export declare const notificationPrefView: z.ZodObject<{
+    key: z.ZodString;
+    channels: z.ZodObject<{
+        inApp: z.ZodBoolean;
+        email: z.ZodBoolean;
+        push: z.ZodBoolean;
+    }, z.core.$strip>;
+    custom: z.ZodBoolean;
+}, z.core.$strip>;
+export type NotificationPrefView = z.infer<typeof notificationPrefView>;
+export declare const notificationPrefsReply: z.ZodObject<{
+    data: z.ZodObject<{
+        channels: z.ZodArray<z.ZodObject<{
+            id: z.ZodEnum<{
+                push: "push";
+                email: "email";
+                inApp: "inApp";
+            }>;
+            available: z.ZodBoolean;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        events: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            channels: z.ZodObject<{
+                inApp: z.ZodBoolean;
+                email: z.ZodBoolean;
+                push: z.ZodBoolean;
+            }, z.core.$strip>;
+            custom: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const notificationPrefsPutBody: z.ZodObject<{
+    events: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        channels: z.ZodObject<{
+            inApp: z.ZodBoolean;
+            email: z.ZodBoolean;
+            push: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type NotificationPrefsPutBody = z.infer<typeof notificationPrefsPutBody>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/routes/notifications/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/routes/notifications/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,gBAAgB;;;;;;;;;;iBAY3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,QAAiB,CAAC;AAEnD,eAAO,MAAM,sBAAsB;;;;;;;iBAKjC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;iBAQjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;iBAAsC,CAAC;AAExE,eAAO,MAAM,qBAAqB;;;;;iBAMhC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;iBAEpC,CAAC;AAIH,6EAA6E;AAC7E,eAAO,MAAM,cAAc,aAIc,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;iBAIlC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,oBAAoB;;;;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;iBAKjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;iBAEnC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/routes/notifications/schema.js

@@ -0,0 +1,83 @@
+/**
+ * Zod schemas for the notification-centre resource (M7 reports/notifications
+ * track; 07-meta-store.md §3.20/§3.21, 09-generated-app.md §5.4):
+ * `/me/notifications` (keyset list + read transitions) and
+ * `/me/notification-prefs` (event × channel matrix).
+ */
+import { z } from 'zod';
+import { notificationChannelsSchema } from '@adminium/meta';
+// --- notifications ---------------------------------------------------------------
+export const notificationView = z.object({
+    id: z.string(),
+    /** Stable localization key (`report.ready`, `desktop.backup.completed`). */
+    kind: z.string(),
+    actorLabel: z.string(),
+    title: z.string(),
+    body: z.string().nullable(),
+    /** Kind-specific substitutions the client localizes at render time. */
+    entity: z.record(z.string(), z.unknown()).nullable(),
+    actionUrl: z.string().nullable(),
+    readAt: z.number().nullable(),
+    createdAt: z.number(),
+});
+/** Opaque keyset cursor: `<createdAt>:<id>` of the previous page's last row. */
+export const notificationCursorRe = /^(\d+):(.+)$/;
+export const notificationsListQuery = z.object({
+    /** `true` narrows to unread rows (the bell's Unread tab). */
+    unread: z.enum(['true', 'false']).default('false'),
+    limit: z.coerce.number().int().min(1).max(100).default(20),
+    before: z.string().regex(notificationCursorRe).optional(),
+});
+export const notificationsListReply = z.object({
+    data: z.object({
+        items: z.array(notificationView),
+        /** The nav-badge number (09 §5.4 `unread-count`) — always the full count. */
+        unreadCount: z.number(),
+        /** Pass back as `?before=` for the next page; null = no more rows. */
+        nextCursor: z.string().nullable(),
+    }),
+});
+export const notificationIdParams = z.object({ id: z.string().min(1) });
+export const notificationReadReply = z.object({
+    data: z.object({
+        /** False when the row was already read or is not yours (no leak). */
+        updated: z.boolean(),
+        unreadCount: z.number(),
+    }),
+});
+export const notificationsReadAllReply = z.object({
+    data: z.object({ updated: z.number(), unreadCount: z.number() }),
+});
+// --- notification prefs -----------------------------------------------------------
+/** §3.21 event keys: dotted kebab/lower segments, same grammar as `kind`. */
+export const eventKeySchema = z
+    .string()
+    .min(1)
+    .max(80)
+    .regex(/^[a-z0-9]+(?:[.-][a-z0-9]+)*$/);
+/**
+ * One delivery channel's availability. `available: false` ALWAYS carries a
+ * `reason` — the §8.2 never-hide-always-explain rule: the client renders the
+ * toggle (intent is stored) plus the explanation, never a silent gap.
+ */
+export const channelAvailabilityView = z.object({
+    id: z.enum(['inApp', 'email', 'push']),
+    available: z.boolean(),
+    reason: z.string().optional(),
+});
+export const notificationPrefView = z.object({
+    key: eventKeySchema,
+    channels: notificationChannelsSchema,
+    /** True when a stored row deviates from the defaults (vs. implicit default). */
+    custom: z.boolean(),
+});
+export const notificationPrefsReply = z.object({
+    data: z.object({
+        channels: z.array(channelAvailabilityView),
+        events: z.array(notificationPrefView),
+    }),
+});
+export const notificationPrefsPutBody = z.object({
+    events: z.array(z.object({ key: eventKeySchema, channels: notificationChannelsSchema })).min(1),
+});
+//# sourceMappingURL=schema.js.map

package/dist/routes/notifications/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/routes/notifications/schema.ts"],"names":[],"mappings":"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"}

package/dist/routes/onboarding/derive.d.ts

@@ -0,0 +1,41 @@
+/**
+ * First-run onboarding checklist derivation (M5-T06, 09-generated-app.md).
+ *
+ * The checklist is REACTIVE: each step's `done` is computed from real
+ * workspace state at request time, never from a boolean stored when the user
+ * clicked something. This pure function takes the gathered facts and produces
+ * the step list + progress — kept separate from the route so it is unit-tested
+ * in isolation.
+ */
+export declare const ONBOARDING_STEP_KEYS: readonly ["connect-database", "choose-tables", "invite-teammates", "workspace-defaults"];
+export type OnboardingStepKey = (typeof ONBOARDING_STEP_KEYS)[number];
+/** Real state the derivation reads (all gathered from existing repos). */
+export interface OnboardingFacts {
+    /** Rows in adminium_connections. */
+    connectionCount: number;
+    /** Any connection has a persisted `settings.includedTables` selection. */
+    hasIncludedTables: boolean;
+    /** Rows in adminium_users (> 1 ⇒ at least one teammate invited). */
+    userCount: number;
+    /** A workspace-default appearance/locale override was ever saved. */
+    hasWorkspaceDefaults: boolean;
+    /**
+     * Whether the requester may manage workspace defaults (`system:settings:manage`,
+     * i.e. super admin). The "workspace-defaults" step links to `/settings/defaults`,
+     * which is super-admin-only, so it is omitted for plain admins — otherwise its
+     * CTA is a forbidden dead-end and a step they can never complete.
+     */
+    canManageWorkspaceDefaults: boolean;
+}
+export interface OnboardingStep {
+    key: OnboardingStepKey;
+    done: boolean;
+}
+export interface OnboardingChecklist {
+    steps: OnboardingStep[];
+    doneCount: number;
+    totalCount: number;
+    complete: boolean;
+}
+export declare function deriveChecklist(facts: OnboardingFacts): OnboardingChecklist;
+//# sourceMappingURL=derive.d.ts.map

package/dist/routes/onboarding/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../../src/routes/onboarding/derive.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,oBAAoB,0FAKvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,oBAAoB,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,0BAA0B,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,iBAAiB,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,mBAAmB,CAa3E"}

package/dist/routes/onboarding/derive.js

@@ -0,0 +1,30 @@
+/**
+ * First-run onboarding checklist derivation (M5-T06, 09-generated-app.md).
+ *
+ * The checklist is REACTIVE: each step's `done` is computed from real
+ * workspace state at request time, never from a boolean stored when the user
+ * clicked something. This pure function takes the gathered facts and produces
+ * the step list + progress — kept separate from the route so it is unit-tested
+ * in isolation.
+ */
+export const ONBOARDING_STEP_KEYS = [
+    'connect-database',
+    'choose-tables',
+    'invite-teammates',
+    'workspace-defaults',
+];
+export function deriveChecklist(facts) {
+    const steps = [
+        { key: 'connect-database', done: facts.connectionCount > 0 },
+        { key: 'choose-tables', done: facts.hasIncludedTables },
+        { key: 'invite-teammates', done: facts.userCount > 1 },
+    ];
+    // Only super admins can reach /settings/defaults, so the step (and its count)
+    // is scoped to them — a plain admin's checklist neither shows nor waits on it.
+    if (facts.canManageWorkspaceDefaults) {
+        steps.push({ key: 'workspace-defaults', done: facts.hasWorkspaceDefaults });
+    }
+    const doneCount = steps.reduce((n, step) => (step.done ? n + 1 : n), 0);
+    return { steps, doneCount, totalCount: steps.length, complete: doneCount === steps.length };
+}
+//# sourceMappingURL=derive.js.map

package/dist/routes/onboarding/derive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.js","sourceRoot":"","sources":["../../../src/routes/onboarding/derive.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,kBAAkB;IAClB,eAAe;IACf,kBAAkB;IAClB,oBAAoB;CACZ,CAAC;AAmCX,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,MAAM,KAAK,GAAqB;QAC9B,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,KAAK,CAAC,eAAe,GAAG,CAAC,EAAE;QAC5D,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,CAAC,iBAAiB,EAAE;QACvD,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE;KACvD,CAAC;IACF,8EAA8E;IAC9E,+EAA+E;IAC/E,IAAI,KAAK,CAAC,0BAA0B,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,KAAK,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;AAC9F,CAAC"}

package/dist/routes/onboarding/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Onboarding-state routes (M5-T06, 09-generated-app.md):
+ *
+ *   GET  /api/v1/onboarding          → { data: { checklist, dismissed } }
+ *   POST /api/v1/onboarding/dismiss  → persist the per-user dismissal, then
+ *                                       return the fresh state.
+ *
+ * The checklist is derived from live workspace state on every request
+ * (see ./derive.ts) — never from click-time booleans. Guarded by
+ * `system:connections:manage` (the admin built-in role has it; viewers/editors
+ * do not), so the surface is admin-only. Dismissal is a per-user UI preference
+ * stored in `adminium_user_prefs.uiState` — the same per-user pref store the
+ * theme axes use (07-meta-store.md §3.4) — so it is not audit-logged, matching
+ * the sibling `me/prefs` writes.
+ */
+import type { FastifyPluginAsyncZod } from 'fastify-type-provider-zod';
+import { type MetaDb } from '@adminium/meta';
+/** Admin built-in role grant (super-admin has every system action). */
+export declare const ONBOARDING_VIEW = "system:connections:manage";
+/** uiState key holding the per-user dismissal flag. */
+export declare const ONBOARDING_DISMISSED_KEY = "onboardingDismissed";
+export interface OnboardingRoutesDeps {
+    meta: MetaDb;
+}
+export declare function onboardingRoutes(deps: OnboardingRoutesDeps): FastifyPluginAsyncZod;
+//# sourceMappingURL=index.d.ts.map

package/dist/routes/onboarding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/routes/onboarding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,EAKL,KAAK,MAAM,EAEZ,MAAM,gBAAgB,CAAC;AAMxB,uEAAuE;AACvE,eAAO,MAAM,eAAe,8BAA8B,CAAC;AAE3D,uDAAuD;AACvD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAU9D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,CAsElF"}

package/dist/routes/onboarding/index.js

@@ -0,0 +1,95 @@
+/**
+ * Onboarding-state routes (M5-T06, 09-generated-app.md):
+ *
+ *   GET  /api/v1/onboarding          → { data: { checklist, dismissed } }
+ *   POST /api/v1/onboarding/dismiss  → persist the per-user dismissal, then
+ *                                       return the fresh state.
+ *
+ * The checklist is derived from live workspace state on every request
+ * (see ./derive.ts) — never from click-time booleans. Guarded by
+ * `system:connections:manage` (the admin built-in role has it; viewers/editors
+ * do not), so the surface is admin-only. Dismissal is a per-user UI preference
+ * stored in `adminium_user_prefs.uiState` — the same per-user pref store the
+ * theme axes use (07-meta-store.md §3.4) — so it is not audit-logged, matching
+ * the sibling `me/prefs` writes.
+ */
+import { readJsonOrNull, settingsRepo, userPrefsRepo, usersRepo, } from '@adminium/meta';
+import { PERMISSIONS } from '../../rbac/permissions.js';
+import { deriveChecklist } from './derive.js';
+import { onboardingDismissBody, onboardingReply } from './schema.js';
+/** Admin built-in role grant (super-admin has every system action). */
+export const ONBOARDING_VIEW = 'system:connections:manage';
+/** uiState key holding the per-user dismissal flag. */
+export const ONBOARDING_DISMISSED_KEY = 'onboardingDismissed';
+/** Workspace-default axes an admin explicitly saved (07-meta-store.md §7.1). */
+const WORKSPACE_DEFAULT_KEYS = [
+    'appearance.theme',
+    'appearance.accent',
+    'appearance.density',
+    'locale.default',
+];
+function currentUserId(request) {
+    if (request.apiKeyPrincipal !== null)
+        return null;
+    return request.user?.id ?? null;
+}
+export function onboardingRoutes(deps) {
+    const { meta } = deps;
+    const users = usersRepo(meta);
+    const settings = settingsRepo(meta);
+    const prefs = userPrefsRepo(meta);
+    async function gatherFacts(canManageWorkspaceDefaults) {
+        const [connectionRows, userCount, overrides] = await Promise.all([
+            // Only id + settings — no DSN material, so no crypto/adapter dependency.
+            meta.db.selectFrom('adminium_connections').select(['id', 'settings']).execute(),
+            users.count(),
+            settings.overrides(),
+        ]);
+        const hasIncludedTables = connectionRows.some((row) => {
+            const parsed = readJsonOrNull(row.settings);
+            return (parsed?.includedTables?.length ?? 0) > 0;
+        });
+        const hasWorkspaceDefaults = WORKSPACE_DEFAULT_KEYS.some((key) => overrides[key] !== undefined);
+        return {
+            connectionCount: connectionRows.length,
+            hasIncludedTables,
+            userCount,
+            hasWorkspaceDefaults,
+            canManageWorkspaceDefaults,
+        };
+    }
+    async function readDismissed(userId) {
+        if (userId === null)
+            return false;
+        const row = await prefs.get(userId);
+        return row?.uiState?.[ONBOARDING_DISMISSED_KEY] === true;
+    }
+    async function buildReply(request) {
+        const [canManageWorkspaceDefaults, dismissed] = await Promise.all([
+            request.can(PERMISSIONS.settingsManage),
+            readDismissed(currentUserId(request)),
+        ]);
+        const facts = await gatherFacts(canManageWorkspaceDefaults);
+        const checklist = deriveChecklist(facts);
+        return { data: { checklist, dismissed } };
+    }
+    return async (app) => {
+        app.get('/onboarding', {
+            preHandler: app.rbac.require(ONBOARDING_VIEW),
+            schema: { response: { 200: onboardingReply } },
+        }, async (request) => buildReply(request));
+        app.post('/onboarding/dismiss', {
+            preHandler: app.rbac.require(ONBOARDING_VIEW),
+            schema: { body: onboardingDismissBody, response: { 200: onboardingReply } },
+        }, async (request) => {
+            const userId = currentUserId(request);
+            if (userId !== null) {
+                const existing = await prefs.get(userId);
+                const uiState = { ...(existing?.uiState ?? {}), [ONBOARDING_DISMISSED_KEY]: request.body.dismissed };
+                await prefs.set(userId, { uiState });
+            }
+            return buildReply(request);
+        });
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/routes/onboarding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/routes/onboarding/index.ts"],"names":[],"mappings":"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"}

package/dist/routes/onboarding/schema.d.ts

@@ -0,0 +1,22 @@
+/** Zod schemas for the onboarding-state resource (M5-T06). */
+import { z } from 'zod';
+export declare const onboardingReply: z.ZodObject<{
+    data: z.ZodObject<{
+        checklist: z.ZodObject<{
+            steps: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                done: z.ZodBoolean;
+            }, z.core.$strip>>;
+            doneCount: z.ZodNumber;
+            totalCount: z.ZodNumber;
+            complete: z.ZodBoolean;
+        }, z.core.$strip>;
+        dismissed: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type OnboardingReply = z.infer<typeof onboardingReply>;
+export declare const onboardingDismissBody: z.ZodObject<{
+    dismissed: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type OnboardingDismissBody = z.infer<typeof onboardingDismissBody>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/routes/onboarding/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/routes/onboarding/schema.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;iBAW1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/routes/onboarding/schema.js

@@ -0,0 +1,22 @@
+/** Zod schemas for the onboarding-state resource (M5-T06). */
+import { z } from 'zod';
+const onboardingStepView = z.object({
+    key: z.string(),
+    done: z.boolean(),
+});
+export const onboardingReply = z.object({
+    data: z.object({
+        checklist: z.object({
+            steps: z.array(onboardingStepView),
+            doneCount: z.number().int().min(0),
+            totalCount: z.number().int().min(0),
+            complete: z.boolean(),
+        }),
+        /** Per-user dismissal of the proactive surface (persisted in user prefs). */
+        dismissed: z.boolean(),
+    }),
+});
+export const onboardingDismissBody = z.object({
+    dismissed: z.boolean().default(true),
+});
+//# sourceMappingURL=schema.js.map

package/dist/routes/onboarding/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/routes/onboarding/schema.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;YAClB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;YAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACnC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;SACtB,CAAC;QACF,6EAA6E;QAC7E,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;KACvB,CAAC;CACH,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACrC,CAAC,CAAC"}

package/dist/routes/pages/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Page-document routes (08-server-api.md §2.6, 04-widget-registry.md §6.3):
+ *
+ *   GET   /api/v1/pages/:pageId         → { data: <page envelope> }
+ *   PATCH /api/v1/pages/:pageId/layout  → write the SHARED default layout
+ *
+ * The dashboard's PageRenderer fetches the stored envelope by the id it got
+ * from the bootstrap nav tree and runs client-side config migrations
+ * (09-generated-app.md §2.3/§3). On read the server resolves `config.layout`:
+ * a per-user override (an `adminium_views` row, `kind: 'layout'`) wins over the
+ * shared `adminium_pages` default; otherwise the envelope is returned verbatim.
+ *
+ * The GET is gated on page-VIEW permission (`page:<pageId>:view`, the same
+ * grant the bootstrap nav filter applies). The PATCH writes the shared default
+ * (the layout every viewer sees) and is gated on page-EDIT permission
+ * (`page:<pageId>:edit`; super-admins bypass both) and audited. Per-user
+ * overrides live on the sibling `me/views` route — any user with page-view
+ * access may save their own without the edit grant.
+ */
+import type { FastifyPluginAsyncZod } from 'fastify-type-provider-zod';
+import { type MetaDb } from '@adminium/meta';
+export interface PagesRoutesDeps {
+    meta: MetaDb;
+}
+export declare function pagesRoutes(deps: PagesRoutesDeps): FastifyPluginAsyncZod;
+//# sourceMappingURL=index.d.ts.map

package/dist/routes/pages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/routes/pages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,OAAO,EAAwB,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAMnE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAQD,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,qBAAqB,CAmHxE"}