@adminiumjs/adminium 0.1.0-rc.1

package/dist/generate/materialize-llm.js

@@ -0,0 +1,167 @@
+/**
+ * LLM page-row materialization (06-llm-assist.md §8.3 step 3).
+ *
+ * The apply executor seeds `origin: 'llm'` page rows with a minimal config —
+ * `{source, llmRunId}` for template pages, `{domain, tables, layout, source,
+ * llmRunId}` for dashboards — and defers the full §6.1 envelope to "the
+ * regeneration hook". This module IS that expansion. `runGeneration` calls it
+ * after every persist, so the post-apply hook AND any manual regeneration
+ * repair seed rows into envelopes the client can parse; `upsertGenerated`
+ * itself never touches non-generated origins (user delta wins, 04 §6.3), so
+ * without this pass a seed row would stay an invalid-config card forever.
+ *
+ * Failure is per-row and non-fatal: a table that is excluded from the run, a
+ * template whose required slot cannot fill, or an envelope the frozen contract
+ * rejects leaves the seed's config untouched, records a warning on the run,
+ * and DISABLES the row — a parked page beats the invalid-config card the
+ * client would otherwise render forever. Every later run retries; success
+ * re-enables.
+ *
+ * A successful expansion also syncs the ROW's nav projection (title, nav
+ * group, icon back-fill) from the validated envelope: the bootstrap tree and
+ * the client's `/p/$slug` resolver read the row columns, not the document, so
+ * without the sync a materialized llm page would stay invisible and
+ * unreachable. An §8.3 nav-group re-placement still wins — the envelope
+ * follows the row's group when one was stamped.
+ */
+import { composeRequestedArchetype, hashEnvelope } from '@adminium/engine';
+import { pageEnvelopeSchema, widgetConfigSchema } from '@adminium/engine/config';
+import { pagesRepo } from '@adminium/meta';
+/** A stored config counts as materialized once it carries the envelope `v`. */
+function isEnvelope(config) {
+    return typeof config === 'object' && config !== null && 'v' in config;
+}
+function seedOf(page) {
+    return typeof page.config === 'object' && page.config !== null
+        ? page.config
+        : {};
+}
+/** The seed's bound table (`config.source.table`), or null. */
+function seedTable(seed) {
+    const source = seed['source'];
+    if (typeof source !== 'object' || source === null)
+        return null;
+    const table = source['table'];
+    return typeof table === 'string' ? table : null;
+}
+/** Compose the §14 archetype envelope a template-page seed asked for. */
+function templateEnvelope(page, seed, model, connectionId) {
+    const table = seedTable(seed);
+    if (table === null)
+        return { envelope: null, reason: 'seed carries no source.table' };
+    const built = composeRequestedArchetype(model, table, page.type, {
+        connectionId,
+        slug: page.slug,
+        id: page.id,
+        navOrder: page.navOrder,
+    });
+    if (built.envelope === null) {
+        const detail = built.warnings.map((w) => w.message).join('; ');
+        return {
+            envelope: null,
+            reason: detail || `table ${table} is not part of this run (excluded/system/join)`,
+        };
+    }
+    // The row's nav column is authoritative for the tree; a §8.3 nav-group write
+    // may have re-placed the row after seeding, so the envelope follows the row.
+    const nav = built.envelope['nav'];
+    if (page.navGroup !== null)
+        nav['group'] = page.navGroup;
+    return { envelope: built.envelope, reason: '' };
+}
+/** Wrap a dashboard seed's bound layout (§8.3 `dashboard`+`widget`) per §6.1. */
+function dashboardEnvelope(page, seed, connectionId) {
+    const layout = seed['layout'];
+    if (typeof layout !== 'object' || layout === null) {
+        return { envelope: null, reason: 'seed carries no config.layout' };
+    }
+    return {
+        reason: '',
+        envelope: {
+            v: 1,
+            kind: 'dashboard',
+            id: page.id,
+            template: 'page-dashboard',
+            title: { key: `nav.${page.slug}`, fallback: page.title },
+            source: { connectionId, table: null },
+            nav: {
+                group: page.navGroup ?? 'workspace',
+                icon: page.icon ?? 'layout-dashboard',
+                order: page.navOrder,
+                slug: page.slug,
+            },
+            access: { minRole: 'viewer', permissions: [] },
+            config: {
+                domain: seed['domain'] ?? null,
+                tables: seed['tables'] ?? [],
+                layout,
+            },
+        },
+    };
+}
+/**
+ * Expand every still-seed `origin: 'llm'` page row of a connection into a
+ * validated §6.1 envelope. Idempotent — materialized rows (config carries `v`)
+ * are never re-touched, so a user's later layout edits survive regeneration.
+ */
+export async function materializeLlmPages(opts) {
+    const repo = pagesRepo(opts.meta);
+    const result = { materialized: [], warnings: [] };
+    /** Park a seed that cannot compose: warn + hide it from nav/GET until a run succeeds. */
+    const park = async (page, reason) => {
+        result.warnings.push(`llm page ${page.id} (${page.slug}) not materialized — ${reason}; page disabled until a regeneration can compose it`);
+        if (page.isEnabled) {
+            await repo.setEnabled(page.id, false, opts.at ?? Date.now());
+        }
+    };
+    for (const page of await repo.listForConnection(opts.connectionId)) {
+        if (page.origin !== 'llm' || isEnvelope(page.config))
+            continue;
+        const seed = seedOf(page);
+        const { envelope, reason } = page.type === 'page-dashboard'
+            ? dashboardEnvelope(page, seed, opts.connectionId)
+            : templateEnvelope(page, seed, opts.model, opts.connectionId);
+        if (envelope === null) {
+            await park(page, reason);
+            continue;
+        }
+        // Provenance survives the expansion; the hash goes on last (it excludes
+        // only itself), then the frozen contract gets the final word.
+        const config = envelope['config'];
+        config['llmRunId'] = seed['llmRunId'] ?? null;
+        config['generatedHash'] = hashEnvelope(envelope);
+        const parsed = pageEnvelopeSchema.safeParse(envelope);
+        if (!parsed.success) {
+            const first = parsed.error.issues[0];
+            await park(page, `envelope invalid: ${first?.message ?? 'unknown'}`);
+            continue;
+        }
+        if (parsed.data.kind === 'dashboard') {
+            const layout = parsed.data.config['layout'];
+            const bad = layout.items.find((item) => !widgetConfigSchema.safeParse(item).success);
+            if (bad !== undefined) {
+                await park(page, 'a layout item fails the widget contract');
+                continue;
+            }
+        }
+        // Sync the row's nav projection (title/group/icon) from the envelope: the
+        // bootstrap tree and the `/p/$slug` resolver read the ROW columns, so a
+        // seed left with its apply-time `nav_group` (null, or an §8.3 llm group
+        // slug) would materialize into an unreachable page. The envelope already
+        // encodes the §8.3 precedence — a nav-group write on the row wins,
+        // otherwise the archetype's fixed group — so the row simply follows it.
+        const icon = envelope['nav']['icon'];
+        await repo.replaceConfig(page.id, parsed.data, {
+            icon: typeof icon === 'string' ? icon : null,
+            title: parsed.data.title.fallback,
+            navGroup: parsed.data.nav.group,
+            ...(opts.at === undefined ? {} : { at: opts.at }),
+        });
+        if (!page.isEnabled) {
+            await repo.setEnabled(page.id, true, opts.at ?? Date.now());
+        }
+        result.materialized.push(page.id);
+    }
+    return result;
+}
+//# sourceMappingURL=materialize-llm.js.map

package/dist/generate/materialize-llm.js.map

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

package/dist/generate/run.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Generation pipeline glue (M4-T08): latest classified snapshot (introspect
+ * first when none) → `generatePages()` (@adminium/engine) → validate every
+ * envelope against the frozen config contract (the server is the single
+ * write-time validator, 01-architecture.md §6.1) → persist idempotently via
+ * `pagesRepo.upsertGenerated`.
+ *
+ * Pure orchestration — no Fastify types here so the demo script and tests
+ * can drive it directly.
+ */
+import { type DatabaseModel, type GenerateIntent } from '@adminium/engine';
+import { type PageEnvelope } from '@adminium/engine/config';
+import { type GeneratedPageInput, type MetaDb, type UpsertGeneratedResult } from '@adminium/meta';
+import type { ConnectionManager } from '../connections/manager.js';
+export interface RunGenerationOptions {
+    manager: ConnectionManager;
+    meta: MetaDb;
+    connectionId: string;
+    createdBy?: string | null | undefined;
+    /** Overrides the connection's stored intent for this run (09 §8.4). */
+    intent?: GenerateIntent | undefined;
+}
+export interface GenerationRunResult {
+    snapshotId: string;
+    /** True when a fresh introspection ran because no snapshot existed. */
+    introspected: boolean;
+    intent: GenerateIntent;
+    pages: PageEnvelope[];
+    navGroups: string[];
+    warnings: string[];
+    persistence: UpsertGeneratedResult;
+    /** `origin: 'llm'` seed rows expanded into envelopes this run (06 §8.3). */
+    llmPagesMaterialized: number;
+    durationMs: number;
+}
+/**
+ * M5-T02 table inclusion: when the wizard persisted
+ * `settings.includedTables` (PATCH /connections/:id), restrict the model to
+ * that set before generation. Join/system tables stay in the graph (they
+ * power M2M detection and are never paged anyway); relations and FK mirrors
+ * that point at excluded tables are dropped so envelopes cannot reference
+ * pages that will not exist.
+ */
+export declare function filterModelToIncludedTables(model: DatabaseModel, includedTables: readonly string[] | undefined): DatabaseModel;
+/** Envelope → the opaque row shape `pagesRepo` persists. */
+export declare function toGeneratedPageInput(envelope: PageEnvelope): GeneratedPageInput;
+export declare function runGeneration(opts: RunGenerationOptions): Promise<GenerationRunResult>;
+//# sourceMappingURL=run.d.ts.map

package/dist/generate/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/generate/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,MAAM,EACX,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAIxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,uEAAuE;IACvE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,qBAAqB,CAAC;IACnC,4EAA4E;IAC5E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,aAAa,EACpB,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAC5C,aAAa,CAwBf;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,kBAAkB,CAW/E;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgF5F"}

package/dist/generate/run.js

@@ -0,0 +1,123 @@
+/**
+ * Generation pipeline glue (M4-T08): latest classified snapshot (introspect
+ * first when none) → `generatePages()` (@adminium/engine) → validate every
+ * envelope against the frozen config contract (the server is the single
+ * write-time validator, 01-architecture.md §6.1) → persist idempotently via
+ * `pagesRepo.upsertGenerated`.
+ *
+ * Pure orchestration — no Fastify types here so the demo script and tests
+ * can drive it directly.
+ */
+import { generatePages, hashEnvelope, parseDatabaseModel, } from '@adminium/engine';
+import { pageEnvelopeSchema } from '@adminium/engine/config';
+import { overridesRepo, pagesRepo, snapshotsRepo, } from '@adminium/meta';
+import { activeTableLabels } from '../connections/effective-schema.js';
+import { runIntrospection } from '../connections/introspect.js';
+import { materializeLlmPages } from './materialize-llm.js';
+/**
+ * M5-T02 table inclusion: when the wizard persisted
+ * `settings.includedTables` (PATCH /connections/:id), restrict the model to
+ * that set before generation. Join/system tables stay in the graph (they
+ * power M2M detection and are never paged anyway); relations and FK mirrors
+ * that point at excluded tables are dropped so envelopes cannot reference
+ * pages that will not exist.
+ */
+export function filterModelToIncludedTables(model, includedTables) {
+    if (includedTables === undefined || includedTables.length === 0)
+        return model;
+    const keep = new Set(includedTables);
+    const tables = model.tables.filter((table) => keep.has(table.id) || table.system || table.semantics?.role === 'join-table');
+    const ids = new Set(tables.map((table) => table.id));
+    return {
+        ...model,
+        tables: tables.map((table) => ({
+            ...table,
+            columns: table.columns.map((column) => column.references !== null && !ids.has(column.references.tableId)
+                ? { ...column, references: null }
+                : column),
+        })),
+        relations: model.relations.filter((relation) => ids.has(relation.from.tableId) &&
+            ids.has(relation.to.tableId) &&
+            (relation.through === null || ids.has(relation.through.tableId))),
+    };
+}
+/** Envelope → the opaque row shape `pagesRepo` persists. */
+export function toGeneratedPageInput(envelope) {
+    return {
+        id: envelope.id,
+        slug: envelope.nav.slug ?? envelope.id.replace(/^page_/, ''),
+        type: envelope.template,
+        title: envelope.title.fallback,
+        icon: envelope.nav.icon,
+        navGroup: envelope.nav.group,
+        navOrder: envelope.nav.order,
+        config: envelope,
+    };
+}
+export async function runGeneration(opts) {
+    const { manager, meta, connectionId } = opts;
+    const startedAt = Date.now();
+    const snapshots = snapshotsRepo(meta);
+    const connection = await manager.mustFind(connectionId);
+    const intent = opts.intent ?? connection.settings.intent ?? 'full-admin';
+    let snapshot = await snapshots.latest(connectionId);
+    let introspected = false;
+    if (snapshot === null) {
+        const result = await runIntrospection({
+            manager,
+            meta,
+            connectionId,
+            createdBy: opts.createdBy ?? null,
+        });
+        snapshot = result.snapshot;
+        introspected = true;
+    }
+    // Snapshots store the classified model (connections/introspect.ts).
+    const model = filterModelToIncludedTables(parseDatabaseModel(snapshot.schema), connection.settings.includedTables);
+    // Overlay effective table labels (user `table.label` > accepted `llm.label`,
+    // provenance 06 §8.3) onto the parsed model BEFORE generation, so every
+    // renamed table's page titles — and through `adminium_pages`, the sidebar
+    // nav — carry the rename. The stored snapshot stays label-free; this is a
+    // per-run, in-memory attachment. L10n bundles resolve to the connection's
+    // default locale (en_US in v1).
+    const overrides = await overridesRepo(meta).listForConnection(connectionId, { status: 'active' });
+    const labels = activeTableLabels(overrides);
+    if (labels.size > 0) {
+        for (const table of model.tables) {
+            const label = labels.get(table.id);
+            if (label !== undefined)
+                table.label = label;
+        }
+    }
+    const { pages, warnings } = generatePages(model, { connectionId, intent });
+    // Belt and braces: the engine validated on emit; the server re-validates
+    // at the write boundary because it is the single write-time authority.
+    const validated = pages.map((page) => pageEnvelopeSchema.parse(page));
+    const persistence = await pagesRepo(meta).upsertGenerated(connectionId, validated.map(toGeneratedPageInput), 
+    // `hashEnvelope` arms the H5 edited-page guard (04 §6.3 "user delta wins"):
+    // stored documents whose embedded generatedHash went stale were edited by a
+    // human and are skipped, not overwritten.
+    { snapshotId: snapshot.id, createdBy: opts.createdBy ?? null, hashEnvelope });
+    for (const id of persistence.skippedEdited) {
+        warnings.push(`page ${id} was edited after generation — kept as-is (user delta wins, 04 §6.3)`);
+    }
+    for (const id of persistence.keptEdited) {
+        warnings.push(`page ${id} is no longer generated but was edited by hand — kept instead of pruned (user delta wins, 04 §6.3)`);
+    }
+    // §8.3 step 3 tail: expand `origin: 'llm'` seed rows into real envelopes.
+    const llm = await materializeLlmPages({ meta, model, connectionId });
+    warnings.push(...llm.warnings);
+    const navGroups = [...new Set(validated.map((page) => page.nav.group))];
+    return {
+        snapshotId: snapshot.id,
+        introspected,
+        intent,
+        pages: validated,
+        navGroups,
+        warnings,
+        persistence,
+        llmPagesMaterialized: llm.materialized.length,
+        durationMs: Date.now() - startedAt,
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/generate/run.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,89 @@
+export { buildLogger, buildServer, REDACT_PATHS, type AdminiumServer, type BuildLoggerOptions, type BuildServerOptions, } from './app.js';
+export { start, type StartOptions } from './start.js';
+export { AppError, ConflictError, errorEnvelope, ForbiddenError, NotFoundError, RateLimitedError, UnauthorizedError, ValidationFailedError, type ErrorCode, type ErrorEnvelope, } from './errors.js';
+export { API_PREFIX, registerRoutes } from './routes/index.js';
+export { corePlugin, type CorePluginOptions } from './plugins/core.js';
+export { staticPlugin, type StaticPluginOptions } from './plugins/static.js';
+export { metaDialect, systemHealthzReply, systemInfoReply, type SystemHealthzReply, type SystemInfoReply, } from './routes/system/schema.js';
+export { APP_VERSION } from './version.js';
+export { EnvValidationError, LOG_LEVELS, envSchema, formatEnvErrorTable, loadEnv, type Env, type EnvWriter, } from './config/env.js';
+export { ENC_TOKEN_PREFIX, SecretFormatError, SecretIntegrityError, decryptSecret, deriveKey, encryptSecret, isEncryptedSecret, } from './config/secrets.js';
+export { BOOTSTRAP_FILENAME, BootstrapFileError, bootstrapPath, bootstrapSchema, readBootstrap, writeBootstrap, type Bootstrap, } from './config/bootstrap.js';
+/**
+ * THE COMPOSITION ROOT (see `compose.ts`) — the complete server, not the
+ * skeleton.
+ *
+ * `buildServer` above is exported and `composeServer` was not, which made the
+ * public API of this package a trap: the only documented way in built the six
+ * `/api/v1` namespaces that need no injected services and silently omitted the
+ * other eleven the dashboard calls. That is precisely the M10 bug — a hollow API
+ * whose connect wizard 404s — and 11-electron.md §3 walks the next wrapper
+ * straight into it by describing the Electron entry as importing "the exported
+ * `buildServer()` factory". Exporting the real root is what lets that wrapper be
+ * correct: 01 §4's "only the wrapper differs" requires the thing that does not
+ * differ to be reachable from outside.
+ */
+export { composeServer, TELEMETRY_CRON, TELEMETRY_JITTER_MS, TELEMETRY_SCHEDULE_NAME, type ComposedServer, type ComposeServerOptions, } from './compose.js';
+/**
+ * The idempotent boot bootstrap (07-meta-store.md §6) — re-exported, not
+ * re-implemented.
+ *
+ * `cli/commands/start.ts` imports `firstRun` straight from `@adminium/meta`
+ * because it lives INSIDE this package. A wrapper outside it cannot: the
+ * 01-architecture.md §2.3 matrix gives `@adminium/desktop` exactly two inputs,
+ * "`@adminium/server` (spawned)" and "dashboard build output", so the Electron
+ * utilityProcess entry has no legal path to `@adminium/meta`. Without this line
+ * its only options are to grow a banned dependency edge or to call
+ * `applyMigrations` instead — and the second one is the M10 bug: migrations
+ * create `adminium_roles` but nothing in the ledger SEEDS it, so a
+ * migrate-only boot serves a first-run wizard whose `POST /setup/super-admin`
+ * dies in `createFirstSuperAdmin` ("built-in roles missing") permanently, the
+ * claim row rolling back with every retry. On desktop that wizard is the app's
+ * front door (11-electron.md §6), so the very first launch would dead-end.
+ *
+ * `firstRun` is the documented "safe to run at every boot" entry point: migrate,
+ * seed the built-in roles, seed `system.*`. Exporting it makes the correct call
+ * the reachable one for every wrapper, which is the whole point of 01 §4's "only
+ * the wrapper differs".
+ */
+export { firstRun, type FirstRunResult } from '@adminium/meta';
+/**
+ * The newest migration this build ships (11-electron.md §9, 11-T12).
+ *
+ * Re-exported for the same reason `firstRun` above is: the Electron
+ * utilityProcess entry has no legal path to `@adminium/meta` (01 §2.3 gives
+ * `@adminium/desktop` exactly two inputs), and it needs this string to tell the
+ * main process how new the app is — which is what lets main refuse a backup
+ * whose `metaMigrationVersion` is newer than itself BEFORE it moves any data
+ * aside. Computed here rather than restated, so it cannot fall behind the
+ * ledger it names.
+ */
+export declare const LATEST_META_MIGRATION: string;
+export { BACKUP_CONFIG_PATH, BACKUP_DATABASES_DIR, BACKUP_FILE_PATTERN, BACKUP_FORMAT_VERSION, BACKUP_MANIFEST_PATH, BACKUP_META_PATH, BACKUP_SLUG_PATTERN, PRE_RESTORE_PREFIX, backupDatabasePath, backupFileName, backupManifestSchema, compareMetaMigrationVersion, deriveDatabaseSlug, preRestoreDirName, sha256Hex, uniqueSlug, type BackupDatabaseEntry, type BackupExternalDatabase, type BackupLocalDatabase, type BackupManifest, type BackupMetaEntry, type BackupVersionOrder, } from './backup/format.js';
+export { BACKUPS_DIR, BACKUP_STAGING_DIR, BackupRedactionError, DEFAULT_AUTO_BACKUP_KEEP, createBackup, rotateBackups, rotateBackupsOnDisk, type CreateBackupOptions, type CreateBackupResult, type RotateBackupsResult, } from './backup/backup-service.js';
+export { BACKUP_NOTIFICATION_KIND } from './backup/notify.js';
+/**
+ * The session cookie's name (08-server-api.md §2.1).
+ *
+ * Exported because the Electron main process has to send it: §9's backup route
+ * is session-guarded and main calls it carrying the WINDOW'S cookie, read out of
+ * Electron's own cookie jar (`main/index.ts`'s `electronBackupTransport`). Main
+ * cannot import this at runtime — that would load Fastify into the main process
+ * to read a string — so it restates the name and pins it here with a test.
+ */
+export { SESSION_COOKIE } from './auth/sessions.js';
+export { desktopRoutes, type DesktopRoutesDeps } from './routes/desktop/index.js';
+export { desktopBackupBody, desktopBackupReply, type DesktopBackupBody, type DesktopBackupReply, } from './routes/desktop/schema.js';
+export { desktopCapabilityRoutes, type DesktopCapabilityRoutesDeps, } from './routes/desktop-capabilities/index.js';
+export { capabilityIdSchema, isKnownCapabilityId, KNOWN_CAPABILITY_IDS, type KnownCapabilityId, } from './capabilities/catalog.js';
+export type { CapabilityGrant } from '@adminium/meta';
+export { META_URL_KEY_SALT, MetaDriverMissingError, MetaUrlError, connectMetaStore, embeddedMetaWarning, metaEngineFromUrl, metaUrlCryptoFromSecret, openMetaStore, resolveMetaUrl, sqlitePathFromUrl, type ConnectMetaStoreOptions, type MetaEngine, type MetaStoreHandle, type MetaUrlCrypto, type MetaUrlSource, type ResolveMetaUrlOptions, type ResolvedMetaUrl, } from './meta/store.js';
+export { COMMANDS, findCommand, runCli, type RunCliOptions } from './cli/run.js';
+export { defaultCliDeps, displayUrl, loadCliEnv, openRuntime, startServer, type CliDeps, type CliRuntime, type EnvOverrides, type OpenRuntimeOptions, type StartedServer, } from './cli/runtime.js';
+export { BUNDLED_DASHBOARD_DIR, resolveStaticRoot, staticRootCandidates } from './cli/static-root.js';
+export { CliError, CliUsageError, EXIT_ERROR, EXIT_NOTHING_ACCEPTED, EXIT_OK, EXIT_VALIDATION_FAILED, type ExitCode, } from './cli/exit.js';
+export { EXPORT_ZIP_MANIFEST_VERSION, exportZip, type ExportZip, type ExportZipOptions, type ExportZipResult, } from './export/zip-service.js';
+export { ImportZipError, importZip, type ImportZip, type ImportZipOptions, type ImportZipResult, } from './export/import-service.js';
+export { PlaintextSecretError } from './export/redaction.js';
+export type { BundleManifest, ConfigBundle } from './export/bundle.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,116 @@
+/**
+ * @adminium/server — Fastify 5 application (08-server-api.md §1) plus the M0
+ * config layer (env, secrets, bootstrap file). `buildServer()` assembles the
+ * app; `start()` runs the boot sequence and listens (01-architecture.md §8.1 —
+ * meta connect/migration gates join in a later wave).
+ */
+import { ALL_MIGRATIONS } from '@adminium/meta';
+export { buildLogger, buildServer, REDACT_PATHS, } from './app.js';
+export { start } from './start.js';
+export { AppError, ConflictError, errorEnvelope, ForbiddenError, NotFoundError, RateLimitedError, UnauthorizedError, ValidationFailedError, } from './errors.js';
+export { API_PREFIX, registerRoutes } from './routes/index.js';
+export { corePlugin } from './plugins/core.js';
+export { staticPlugin } from './plugins/static.js';
+export { metaDialect, systemHealthzReply, systemInfoReply, } from './routes/system/schema.js';
+export { APP_VERSION } from './version.js';
+export { EnvValidationError, LOG_LEVELS, envSchema, formatEnvErrorTable, loadEnv, } from './config/env.js';
+export { ENC_TOKEN_PREFIX, SecretFormatError, SecretIntegrityError, decryptSecret, deriveKey, encryptSecret, isEncryptedSecret, } from './config/secrets.js';
+export { BOOTSTRAP_FILENAME, BootstrapFileError, bootstrapPath, bootstrapSchema, readBootstrap, writeBootstrap, } from './config/bootstrap.js';
+/**
+ * THE COMPOSITION ROOT (see `compose.ts`) — the complete server, not the
+ * skeleton.
+ *
+ * `buildServer` above is exported and `composeServer` was not, which made the
+ * public API of this package a trap: the only documented way in built the six
+ * `/api/v1` namespaces that need no injected services and silently omitted the
+ * other eleven the dashboard calls. That is precisely the M10 bug — a hollow API
+ * whose connect wizard 404s — and 11-electron.md §3 walks the next wrapper
+ * straight into it by describing the Electron entry as importing "the exported
+ * `buildServer()` factory". Exporting the real root is what lets that wrapper be
+ * correct: 01 §4's "only the wrapper differs" requires the thing that does not
+ * differ to be reachable from outside.
+ */
+export { composeServer, TELEMETRY_CRON, TELEMETRY_JITTER_MS, TELEMETRY_SCHEDULE_NAME, } from './compose.js';
+/**
+ * The idempotent boot bootstrap (07-meta-store.md §6) — re-exported, not
+ * re-implemented.
+ *
+ * `cli/commands/start.ts` imports `firstRun` straight from `@adminium/meta`
+ * because it lives INSIDE this package. A wrapper outside it cannot: the
+ * 01-architecture.md §2.3 matrix gives `@adminium/desktop` exactly two inputs,
+ * "`@adminium/server` (spawned)" and "dashboard build output", so the Electron
+ * utilityProcess entry has no legal path to `@adminium/meta`. Without this line
+ * its only options are to grow a banned dependency edge or to call
+ * `applyMigrations` instead — and the second one is the M10 bug: migrations
+ * create `adminium_roles` but nothing in the ledger SEEDS it, so a
+ * migrate-only boot serves a first-run wizard whose `POST /setup/super-admin`
+ * dies in `createFirstSuperAdmin` ("built-in roles missing") permanently, the
+ * claim row rolling back with every retry. On desktop that wizard is the app's
+ * front door (11-electron.md §6), so the very first launch would dead-end.
+ *
+ * `firstRun` is the documented "safe to run at every boot" entry point: migrate,
+ * seed the built-in roles, seed `system.*`. Exporting it makes the correct call
+ * the reachable one for every wrapper, which is the whole point of 01 §4's "only
+ * the wrapper differs".
+ */
+export { firstRun } from '@adminium/meta';
+/**
+ * The newest migration this build ships (11-electron.md §9, 11-T12).
+ *
+ * Re-exported for the same reason `firstRun` above is: the Electron
+ * utilityProcess entry has no legal path to `@adminium/meta` (01 §2.3 gives
+ * `@adminium/desktop` exactly two inputs), and it needs this string to tell the
+ * main process how new the app is — which is what lets main refuse a backup
+ * whose `metaMigrationVersion` is newer than itself BEFORE it moves any data
+ * aside. Computed here rather than restated, so it cannot fall behind the
+ * ledger it names.
+ */
+export const LATEST_META_MIGRATION = (() => {
+    const latest = ALL_MIGRATIONS[ALL_MIGRATIONS.length - 1]?.name;
+    if (latest === undefined) {
+        throw new Error('@adminium/meta shipped an empty migration ledger — this build is broken.');
+    }
+    return latest;
+})();
+// The §9 desktop backup format, frozen at formatVersion 1. Exported because it
+// is a CONTRACT, not an implementation: the Electron main process validates an
+// archive against these types before a restore (`import type` only — see
+// `apps/desktop/src/main/backup-archive.ts`), and the M10 CLI's import reads the
+// same manifest out of the same zip.
+export { BACKUP_CONFIG_PATH, BACKUP_DATABASES_DIR, BACKUP_FILE_PATTERN, BACKUP_FORMAT_VERSION, BACKUP_MANIFEST_PATH, BACKUP_META_PATH, BACKUP_SLUG_PATTERN, PRE_RESTORE_PREFIX, backupDatabasePath, backupFileName, backupManifestSchema, compareMetaMigrationVersion, deriveDatabaseSlug, preRestoreDirName, sha256Hex, uniqueSlug, } from './backup/format.js';
+export { BACKUPS_DIR, BACKUP_STAGING_DIR, BackupRedactionError, DEFAULT_AUTO_BACKUP_KEEP, createBackup, rotateBackups, rotateBackupsOnDisk, } from './backup/backup-service.js';
+export { BACKUP_NOTIFICATION_KIND } from './backup/notify.js';
+/**
+ * The session cookie's name (08-server-api.md §2.1).
+ *
+ * Exported because the Electron main process has to send it: §9's backup route
+ * is session-guarded and main calls it carrying the WINDOW'S cookie, read out of
+ * Electron's own cookie jar (`main/index.ts`'s `electronBackupTransport`). Main
+ * cannot import this at runtime — that would load Fastify into the main process
+ * to read a string — so it restates the name and pins it here with a test.
+ */
+export { SESSION_COOKIE } from './auth/sessions.js';
+export { desktopRoutes } from './routes/desktop/index.js';
+export { desktopBackupBody, desktopBackupReply, } from './routes/desktop/schema.js';
+// §12 capability plumbing. The main process reaches the grant table over the
+// loopback REST API (`main/capabilities/host.ts`'s grant reader), so it imports
+// the grant SHAPE and the closed id vocabulary from here — the same "restate the
+// name and pin it with a test" arrangement `SESSION_COOKIE` and the backup format
+// use, and for the same reason: main must not load Fastify to read a string.
+export { desktopCapabilityRoutes, } from './routes/desktop-capabilities/index.js';
+export { capabilityIdSchema, isKnownCapabilityId, KNOWN_CAPABILITY_IDS, } from './capabilities/catalog.js';
+// Meta-store resolution + connection (01 §3.1/§7.2). The wrappers — CLI today,
+// Docker/Electron next — all answer "where does the meta store live?" here.
+export { META_URL_KEY_SALT, MetaDriverMissingError, MetaUrlError, connectMetaStore, embeddedMetaWarning, metaEngineFromUrl, metaUrlCryptoFromSecret, openMetaStore, resolveMetaUrl, sqlitePathFromUrl, } from './meta/store.js';
+// The `adminium` CLI (01 §4.1). `runCli` returns an exit code and never touches
+// `process` — `src/cli/index.ts` is the only module that exits.
+export { COMMANDS, findCommand, runCli } from './cli/run.js';
+export { defaultCliDeps, displayUrl, loadCliEnv, openRuntime, startServer, } from './cli/runtime.js';
+export { BUNDLED_DASHBOARD_DIR, resolveStaticRoot, staticRootCandidates } from './cli/static-root.js';
+export { CliError, CliUsageError, EXIT_ERROR, EXIT_NOTHING_ACCEPTED, EXIT_OK, EXIT_VALIDATION_FAILED, } from './cli/exit.js';
+// M10-T03 — the config bundle: `export-zip` / `import-zip` and, later, the
+// Studio download/upload routes are front doors onto these two services.
+export { EXPORT_ZIP_MANIFEST_VERSION, exportZip, } from './export/zip-service.js';
+export { ImportZipError, importZip, } from './export/import-service.js';
+export { PlaintextSecretError } from './export/redaction.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/jobs/export-run.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `export-run` job handler (M7-T07, 09-generated-app.md §11.2): drains one
+ * adminium_exports request through the crud list pipeline and lands the
+ * artifact in file storage.
+ *
+ * Grants are captured AT REQUEST TIME: the exports route verifies
+ * `table:<conn>:<table>:export` and resolves the caller's PII capability
+ * (crud/mask.ts) before enqueueing; the payload carries `unmasked` and the
+ * job replays it through `runList`, so masked columns serialize as empty/null
+ * exactly as the caller would see them in the grid. Secret columns never
+ * appear (mask.ts rule 1).
+ *
+ * Streaming: pages come out of `runList` keyset-style (offset loop for
+ * PK-less tables) and go straight into an incremental `FileWriter` — the
+ * whole table is never in memory. CSV per data-io/csv.ts (RFC 4180 + BOM);
+ * `json` is JSON-lines (one object per line). `xlsx` is rejected at the
+ * route; a row that reaches here anyway fails cleanly.
+ */
+import { type MetaDb } from '@adminium/meta';
+import { z } from 'zod';
+import type { ConnectionManager } from '../connections/manager.js';
+import type { FileStorage } from '../files/storage.js';
+import { type JobRegistry } from './registry.js';
+export declare const EXPORT_RUN_KIND = "export-run";
+export declare const exportRunPayloadSchema: z.ZodObject<{
+    exportId: z.ZodString;
+    userId: z.ZodOptional<z.ZodString>;
+    unmasked: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ExportRunPayload = z.infer<typeof exportRunPayloadSchema>;
+export interface ExportRunDeps {
+    meta: MetaDb;
+    manager: ConnectionManager;
+    storage: FileStorage;
+    now?: () => number;
+}
+export declare function registerExportRunHandler(registry: JobRegistry, deps: ExportRunDeps): void;
+//# sourceMappingURL=export-run.d.ts.map

package/dist/jobs/export-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-run.d.ts","sourceRoot":"","sources":["../../src/jobs/export-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAQL,KAAK,MAAM,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAInE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAA6C,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5F,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C,eAAO,MAAM,sBAAsB;;;;iBAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAOD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAMzF"}