alepha 0.21.2 → 0.22.0

package/dist/api/parameters/index.d.ts

@@ -1,16 +1,23 @@
-import * as _$alepha from "alepha";
 import { Alepha, AlephaError, KIND, Primitive, SchemaValidator, Static, TNull, TObject, TOptional, TSchema, TUnion } from "alepha";
 import { UserAccount } from "alepha/security";
-import * as _$alepha_server0 from "alepha/server";
-import * as _$alepha_orm0 from "alepha/orm";
+import { RepositoryProvider } from "alepha/orm";
 import { CryptoProvider } from "alepha/crypto";
 import { DateTimeProvider } from "alepha/datetime";
 import { LockProvider } from "alepha/lock";
-import * as _$alepha_logger0 from "alepha/logger";
-import * as _$alepha_topic0 from "alepha/topic";
-import * as _$typebox from "typebox";
 import { BuildExtraConfigColumns, SQL } from "drizzle-orm";
 import { PgColumnBuilderBase, PgSequenceOptions, PgTableExtraConfigValue, UpdateDeleteAction } from "drizzle-orm/pg-core";
+//#region ../../src/api/parameters/audits/ParameterAudits.d.ts
+/**
+ * Runtime parameter (config) audit events.
+ *
+ * Holds the `parameter` audit type. Using `$audit` pulls in the audits module
+ * automatically — the parameters module does not need to import it. Register
+ * as a variant and log via `parameterAudits.parameter.log("rollback", …)`.
+ */
+declare class ParameterAudits {
+  readonly parameter: import("alepha/api/audits").AuditPrimitive;
+}
+//#endregion
 //#region ../../src/orm/core/schemas/insertSchema.d.ts
 /**
  * Transforms a TObject schema for insert operations.
@@ -302,8 +309,8 @@ type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & { [K in TAttr]:
  * - `d1://BINDING_NAME` — Cloudflare D1
  * - `hyperdrive://BINDING_NAME` — Cloudflare Hyperdrive
  */
-declare const databaseEnvSchema: _$typebox.TObject<{
-  DATABASE_URL: _$typebox.TOptional<_$typebox.TString>;
+declare const databaseEnvSchema: import("typebox").TObject<{
+  DATABASE_URL: import("typebox").TOptional<import("typebox").TString>;
   /**
    * Enable or disable push-based schema synchronization (drizzle-kit push).
    *
@@ -311,7 +318,7 @@ declare const databaseEnvSchema: _$typebox.TObject<{
    * Set to `false` in development to skip automatic schema sync
    * (e.g. when managing migrations manually).
    */
-  DATABASE_SYNC: _$typebox.TOptional<_$typebox.TBoolean>;
+  DATABASE_SYNC: import("typebox").TOptional<import("typebox").TBoolean>;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof databaseEnvSchema>> {}
@@ -327,58 +334,58 @@ declare module "alepha" {
  * - Activation scheduling
  * - Audit trail (creator info)
  */
-declare const parameters: _$alepha_orm0.EntityPrimitive<_$typebox.TObject<{
-  id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$typebox.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
-  createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$typebox.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
-  updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$typebox.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+declare const parameters: import("alepha/orm").EntityPrimitive<import("typebox").TObject<{
+  id: import("alepha/orm").PgAttr<import("alepha/orm").PgAttr<import("typebox").TString, typeof import("alepha/orm").PG_PRIMARY_KEY>, typeof import("alepha/orm").PG_DEFAULT>;
+  createdAt: import("alepha/orm").PgAttr<import("alepha/orm").PgAttr<import("typebox").TString, typeof import("alepha/orm").PG_CREATED_AT>, typeof import("alepha/orm").PG_DEFAULT>;
+  updatedAt: import("alepha/orm").PgAttr<import("alepha/orm").PgAttr<import("typebox").TString, typeof import("alepha/orm").PG_UPDATED_AT>, typeof import("alepha/orm").PG_DEFAULT>;
   /**
    * Configuration name using dot notation for tree hierarchy.
    * Examples: "app.features", "app.pricing.tiers", "system.limits"
    */
-  name: _$typebox.TString;
+  name: import("typebox").TString;
   /**
    * The configuration content as JSON.
    */
-  content: _$typebox.TRecord<string, _$typebox.TAny>;
+  content: import("typebox").TRecord<string, import("typebox").TAny>;
   /**
    * Schema version hash for detecting schema changes.
    * Used for auto-migration when schema evolves.
    */
-  schemaHash: _$typebox.TString;
+  schemaHash: import("typebox").TString;
   /**
    * When this version should become active.
    * Default is immediate (now).
    */
-  activationDate: _$typebox.TString;
+  activationDate: import("typebox").TString;
   /**
    * Version number for this configuration.
    * Auto-incremented per config name.
    */
-  version: _$typebox.TInteger;
+  version: import("typebox").TInteger;
   /**
    * Optional description of changes in this version.
    */
-  changeDescription: _$typebox.TOptional<_$typebox.TString>;
+  changeDescription: import("typebox").TOptional<import("typebox").TString>;
   /**
    * Optional tags for filtering/categorization.
    */
-  tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
+  tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
   /**
    * Creator user ID (if available).
    */
-  creatorId: _$typebox.TOptional<_$typebox.TString>;
+  creatorId: import("typebox").TOptional<import("typebox").TString>;
   /**
    * Creator display name for audit trail.
    */
-  creatorName: _$typebox.TOptional<_$typebox.TString>;
+  creatorName: import("typebox").TOptional<import("typebox").TString>;
   /**
    * Previous content before this change (for rollback reference).
    */
-  previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
+  previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
   /**
    * Migration log if schema changed.
    */
-  migrationLog: _$typebox.TOptional<_$typebox.TString>;
+  migrationLog: import("typebox").TOptional<import("typebox").TString>;
 }>>;
 type Parameter = Static<typeof parameters.schema>;
 //#endregion
@@ -572,18 +579,18 @@ interface SetParameterOptions {
 /**
  * Parameter status enum schema.
  */
-declare const parameterStatusSchema: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+declare const parameterStatusSchema: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
 type ParameterStatus = Static<typeof parameterStatusSchema>;
 //#endregion
 //#region ../../src/api/parameters/schemas/parameterTreeNodeSchema.d.ts
 /**
  * Tree node schema for parameter tree navigation.
  */
-declare const parameterTreeNodeSchema: _$typebox.TObject<{
-  name: _$typebox.TString;
-  path: _$typebox.TString;
-  isLeaf: _$typebox.TBoolean;
-  children: _$typebox.TArray<_$typebox.TAny>;
+declare const parameterTreeNodeSchema: import("typebox").TObject<{
+  name: import("typebox").TString;
+  path: import("typebox").TString;
+  isLeaf: import("typebox").TBoolean;
+  children: import("typebox").TArray<import("typebox").TAny>;
 }>;
 type ParameterTreeNode = Static<typeof parameterTreeNodeSchema>;
 //#endregion
@@ -613,27 +620,28 @@ type ParameterWithStatus = Parameter & {
  * - Manages per-parameter caching, loading, and subscriber notification
  */
 declare class ParameterProvider {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly alepha: Alepha;
   protected readonly dateTimeProvider: DateTimeProvider;
   protected readonly crypto: CryptoProvider;
   protected readonly lockProvider: LockProvider;
   protected readonly schemaValidator: SchemaValidator;
-  protected readonly repo: _$alepha_orm0.Repository<TObject<{
-    id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$typebox.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
-    createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$typebox.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
-    updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$typebox.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
-    name: _$typebox.TString;
-    content: _$typebox.TRecord<string, _$typebox.TAny>;
-    schemaHash: _$typebox.TString;
-    activationDate: _$typebox.TString;
-    version: _$typebox.TInteger;
-    changeDescription: _$typebox.TOptional<_$typebox.TString>;
-    tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-    creatorId: _$typebox.TOptional<_$typebox.TString>;
-    creatorName: _$typebox.TOptional<_$typebox.TString>;
-    previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-    migrationLog: _$typebox.TOptional<_$typebox.TString>;
+  protected readonly repositoryProvider: RepositoryProvider;
+  protected readonly repo: import("alepha/orm").Repository<TObject<{
+    id: import("alepha/orm").PgAttr<import("alepha/orm").PgAttr<import("typebox").TString, typeof import("alepha/orm").PG_PRIMARY_KEY>, typeof import("alepha/orm").PG_DEFAULT>;
+    createdAt: import("alepha/orm").PgAttr<import("alepha/orm").PgAttr<import("typebox").TString, typeof import("alepha/orm").PG_CREATED_AT>, typeof import("alepha/orm").PG_DEFAULT>;
+    updatedAt: import("alepha/orm").PgAttr<import("alepha/orm").PgAttr<import("typebox").TString, typeof import("alepha/orm").PG_UPDATED_AT>, typeof import("alepha/orm").PG_DEFAULT>;
+    name: import("typebox").TString;
+    content: import("typebox").TRecord<string, import("typebox").TAny>;
+    schemaHash: import("typebox").TString;
+    activationDate: import("typebox").TString;
+    version: import("typebox").TInteger;
+    changeDescription: import("typebox").TOptional<import("typebox").TString>;
+    tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+    creatorId: import("typebox").TOptional<import("typebox").TString>;
+    creatorName: import("typebox").TOptional<import("typebox").TString>;
+    previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+    migrationLog: import("typebox").TOptional<import("typebox").TString>;
   }>>;
   /**
    * Unique identifier for this instance (to avoid self-updates).
@@ -683,15 +691,15 @@ declare class ParameterProvider {
   /**
    * Pre-load all registered parameters on ready (non-serverless only).
    */
-  protected readonly onReady: _$alepha.HookPrimitive<"ready">;
+  protected readonly onReady: import("alepha").HookPrimitive<"ready">;
   /**
    * Topic for cross-instance change notification.
    * Payload is minimal — receivers call load() to fetch fresh data.
    */
-  readonly syncTopic: _$alepha_topic0.TopicPrimitive<{
+  readonly syncTopic: import("alepha/topic").TopicPrimitive<{
     payload: TObject<{
-      name: _$typebox.TString;
-      instanceId: _$typebox.TString;
+      name: import("typebox").TString;
+      instanceId: import("typebox").TString;
     }>;
   }>;
   /**
@@ -746,7 +754,9 @@ declare class ParameterProvider {
    * - Other future versions are "future"
    * - Other past versions are "expired"
    */
-  calculateStatuses(versions: Parameter[], now?: Date): ParameterWithStatus[];
+  calculateStatuses<T extends Parameter>(versions: T[], now?: Date): Array<T & {
+    status: ParameterStatus;
+  }>;
   /**
    * Save a new parameter version.
    *
@@ -757,7 +767,27 @@ declare class ParameterProvider {
    */
   save<T extends TObject>(name: string, content: Static<T>, schemaHash: string, options?: SaveParameterOptions): Promise<ParameterWithStatus>;
   /**
-   * Get all versions of a parameter.
+   * Best-effort left join embedding the creating user on each version, so the
+   * admin UI can render a human-readable identifier (live, not snapshotted)
+   * instead of the bare `creatorId`. Joins `parameters.creatorId` → `users.id`.
+   *
+   * The `users` entity is resolved from the repository registry at runtime
+   * rather than imported: that keeps the parameters module free of any
+   * dependency on the users module (no import, no circular-import risk). When
+   * the users module is not registered the join is skipped and `creator` comes
+   * back undefined.
+   */
+  protected resolveCreatorJoin(): {
+    creator: {
+      join: import("alepha/orm").EntityPrimitive<TObject<import("typebox").TProperties>>;
+      on: ["creatorId", {
+        name: string;
+      }];
+    };
+  } | undefined;
+  /**
+   * Get all versions of a parameter, each with the creating user embedded
+   * (best-effort, see {@link resolveCreatorJoin}).
    */
   getHistory(name: string, options?: {
     limit?: number;
@@ -789,6 +819,12 @@ declare class ParameterProvider {
   } | null;
   /**
    * Get parameter info including current value with default fallback.
+   *
+   * When no version exists in the DB yet but a primitive is registered, this
+   * lazily materializes v1 from the primitive's `default`. After this call,
+   * the parameter has a concrete current row admins can edit / roll back /
+   * compare against, instead of running on phantom defaults-from-code state.
+   * Idempotent: subsequent calls return the same row without re-creating.
    */
   getCurrentWithDefault(name: string): Promise<{
     current: ParameterWithStatus | null;
@@ -896,55 +932,63 @@ declare class AdminParameterController {
   protected readonly url = "/parameters";
   protected readonly group = "admin:parameters";
   protected readonly provider: ParameterProvider;
+  protected readonly alepha: Alepha;
   /**
    * Get tree structure of all parameter names.
    * Useful for admin UI navigation.
    */
-  getParameterTree: _$alepha_server0.ActionPrimitiveFn<{
-    response: _$typebox.TArray<_$typebox.TObject<{
-      name: _$typebox.TString;
-      path: _$typebox.TString;
-      isLeaf: _$typebox.TBoolean;
-      children: _$typebox.TArray<_$typebox.TAny>;
+  getParameterTree: import("alepha/server").ActionPrimitiveFn<{
+    response: import("typebox").TArray<import("typebox").TObject<{
+      name: import("typebox").TString;
+      path: import("typebox").TString;
+      isLeaf: import("typebox").TBoolean;
+      children: import("typebox").TArray<import("typebox").TAny>;
     }>>;
   }>;
   /**
    * List all unique parameter names.
    */
-  listParameterNames: _$alepha_server0.ActionPrimitiveFn<{
-    response: _$typebox.TObject<{
-      names: _$typebox.TArray<_$typebox.TString>;
+  listParameterNames: import("alepha/server").ActionPrimitiveFn<{
+    response: import("typebox").TObject<{
+      names: import("typebox").TArray<import("typebox").TString>;
     }>;
   }>;
   /**
    * Get version history for a specific parameter.
    * Returns all versions with calculated status.
    */
-  getHistory: _$alepha_server0.ActionPrimitiveFn<{
-    params: _$typebox.TObject<{
-      name: _$typebox.TString;
+  getHistory: import("alepha/server").ActionPrimitiveFn<{
+    params: import("typebox").TObject<{
+      name: import("typebox").TString;
     }>;
-    query: _$typebox.TObject<{
-      limit: _$typebox.TOptional<_$typebox.TInteger>;
-      offset: _$typebox.TOptional<_$typebox.TInteger>;
+    query: import("typebox").TObject<{
+      limit: import("typebox").TOptional<import("typebox").TInteger>;
+      offset: import("typebox").TOptional<import("typebox").TInteger>;
     }>;
-    response: _$typebox.TObject<{
-      versions: _$typebox.TArray<_$typebox.TObject<{
-        id: PgAttr<PgAttr<_$typebox.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-        createdAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-        updatedAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-        name: _$typebox.TString;
-        content: _$typebox.TRecord<string, _$typebox.TAny>;
-        schemaHash: _$typebox.TString;
-        activationDate: _$typebox.TString;
-        version: _$typebox.TInteger;
-        changeDescription: _$typebox.TOptional<_$typebox.TString>;
-        tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-        creatorId: _$typebox.TOptional<_$typebox.TString>;
-        creatorName: _$typebox.TOptional<_$typebox.TString>;
-        previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-        migrationLog: _$typebox.TOptional<_$typebox.TString>;
-        status: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+    response: import("typebox").TObject<{
+      versions: import("typebox").TArray<import("typebox").TObject<{
+        id: PgAttr<PgAttr<import("typebox").TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+        createdAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+        updatedAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+        name: import("typebox").TString;
+        content: import("typebox").TRecord<string, import("typebox").TAny>;
+        schemaHash: import("typebox").TString;
+        activationDate: import("typebox").TString;
+        version: import("typebox").TInteger;
+        changeDescription: import("typebox").TOptional<import("typebox").TString>;
+        tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+        creatorId: import("typebox").TOptional<import("typebox").TString>;
+        creatorName: import("typebox").TOptional<import("typebox").TString>;
+        previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+        migrationLog: import("typebox").TOptional<import("typebox").TString>;
+        status: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
+        creator: import("typebox").TOptional<import("typebox").TObject<{
+          id: import("typebox").TString;
+          email: import("typebox").TOptional<import("typebox").TString>;
+          username: import("typebox").TOptional<import("typebox").TString>;
+          firstName: import("typebox").TOptional<import("typebox").TString>;
+          lastName: import("typebox").TOptional<import("typebox").TString>;
+        }>>;
       }>>;
     }>;
   }>;
@@ -953,209 +997,270 @@ declare class AdminParameterController {
    * Includes defaultValue and currentValue from the registered primitive
    * even if no versions exist in the database yet.
    */
-  getCurrent: _$alepha_server0.ActionPrimitiveFn<{
-    params: _$typebox.TObject<{
-      name: _$typebox.TString;
+  getCurrent: import("alepha/server").ActionPrimitiveFn<{
+    params: import("typebox").TObject<{
+      name: import("typebox").TString;
     }>;
-    response: _$typebox.TObject<{
-      current: _$typebox.TOptional<_$typebox.TObject<{
-        id: PgAttr<PgAttr<_$typebox.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-        createdAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-        updatedAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-        name: _$typebox.TString;
-        content: _$typebox.TRecord<string, _$typebox.TAny>;
-        schemaHash: _$typebox.TString;
-        activationDate: _$typebox.TString;
-        version: _$typebox.TInteger;
-        changeDescription: _$typebox.TOptional<_$typebox.TString>;
-        tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-        creatorId: _$typebox.TOptional<_$typebox.TString>;
-        creatorName: _$typebox.TOptional<_$typebox.TString>;
-        previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-        migrationLog: _$typebox.TOptional<_$typebox.TString>;
-        status: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+    response: import("typebox").TObject<{
+      current: import("typebox").TOptional<import("typebox").TObject<{
+        id: PgAttr<PgAttr<import("typebox").TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+        createdAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+        updatedAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+        name: import("typebox").TString;
+        content: import("typebox").TRecord<string, import("typebox").TAny>;
+        schemaHash: import("typebox").TString;
+        activationDate: import("typebox").TString;
+        version: import("typebox").TInteger;
+        changeDescription: import("typebox").TOptional<import("typebox").TString>;
+        tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+        creatorId: import("typebox").TOptional<import("typebox").TString>;
+        creatorName: import("typebox").TOptional<import("typebox").TString>;
+        previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+        migrationLog: import("typebox").TOptional<import("typebox").TString>;
+        status: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
+        creator: import("typebox").TOptional<import("typebox").TObject<{
+          id: import("typebox").TString;
+          email: import("typebox").TOptional<import("typebox").TString>;
+          username: import("typebox").TOptional<import("typebox").TString>;
+          firstName: import("typebox").TOptional<import("typebox").TString>;
+          lastName: import("typebox").TOptional<import("typebox").TString>;
+        }>>;
       }>>;
-      next: _$typebox.TOptional<_$typebox.TObject<{
-        id: PgAttr<PgAttr<_$typebox.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-        createdAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-        updatedAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-        name: _$typebox.TString;
-        content: _$typebox.TRecord<string, _$typebox.TAny>;
-        schemaHash: _$typebox.TString;
-        activationDate: _$typebox.TString;
-        version: _$typebox.TInteger;
-        changeDescription: _$typebox.TOptional<_$typebox.TString>;
-        tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-        creatorId: _$typebox.TOptional<_$typebox.TString>;
-        creatorName: _$typebox.TOptional<_$typebox.TString>;
-        previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-        migrationLog: _$typebox.TOptional<_$typebox.TString>;
-        status: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+      next: import("typebox").TOptional<import("typebox").TObject<{
+        id: PgAttr<PgAttr<import("typebox").TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+        createdAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+        updatedAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+        name: import("typebox").TString;
+        content: import("typebox").TRecord<string, import("typebox").TAny>;
+        schemaHash: import("typebox").TString;
+        activationDate: import("typebox").TString;
+        version: import("typebox").TInteger;
+        changeDescription: import("typebox").TOptional<import("typebox").TString>;
+        tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+        creatorId: import("typebox").TOptional<import("typebox").TString>;
+        creatorName: import("typebox").TOptional<import("typebox").TString>;
+        previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+        migrationLog: import("typebox").TOptional<import("typebox").TString>;
+        status: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
+        creator: import("typebox").TOptional<import("typebox").TObject<{
+          id: import("typebox").TString;
+          email: import("typebox").TOptional<import("typebox").TString>;
+          username: import("typebox").TOptional<import("typebox").TString>;
+          firstName: import("typebox").TOptional<import("typebox").TString>;
+          lastName: import("typebox").TOptional<import("typebox").TString>;
+        }>>;
       }>>;
-      defaultValue: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-      currentValue: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-      schema: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
+      defaultValue: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+      currentValue: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+      schema: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
     }>;
   }>;
   /**
    * Get a specific version of a parameter.
    */
-  getVersion: _$alepha_server0.ActionPrimitiveFn<{
-    params: _$typebox.TObject<{
-      name: _$typebox.TString;
-      version: _$typebox.TInteger;
+  getVersion: import("alepha/server").ActionPrimitiveFn<{
+    params: import("typebox").TObject<{
+      name: import("typebox").TString;
+      version: import("typebox").TInteger;
     }>;
-    response: _$typebox.TObject<{
-      parameter: _$typebox.TOptional<_$typebox.TObject<{
-        id: PgAttr<PgAttr<_$typebox.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-        createdAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-        updatedAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-        name: _$typebox.TString;
-        content: _$typebox.TRecord<string, _$typebox.TAny>;
-        schemaHash: _$typebox.TString;
-        activationDate: _$typebox.TString;
-        version: _$typebox.TInteger;
-        changeDescription: _$typebox.TOptional<_$typebox.TString>;
-        tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-        creatorId: _$typebox.TOptional<_$typebox.TString>;
-        creatorName: _$typebox.TOptional<_$typebox.TString>;
-        previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-        migrationLog: _$typebox.TOptional<_$typebox.TString>;
-        status: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+    response: import("typebox").TObject<{
+      parameter: import("typebox").TOptional<import("typebox").TObject<{
+        id: PgAttr<PgAttr<import("typebox").TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+        createdAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+        updatedAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+        name: import("typebox").TString;
+        content: import("typebox").TRecord<string, import("typebox").TAny>;
+        schemaHash: import("typebox").TString;
+        activationDate: import("typebox").TString;
+        version: import("typebox").TInteger;
+        changeDescription: import("typebox").TOptional<import("typebox").TString>;
+        tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+        creatorId: import("typebox").TOptional<import("typebox").TString>;
+        creatorName: import("typebox").TOptional<import("typebox").TString>;
+        previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+        migrationLog: import("typebox").TOptional<import("typebox").TString>;
+        status: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
+        creator: import("typebox").TOptional<import("typebox").TObject<{
+          id: import("typebox").TString;
+          email: import("typebox").TOptional<import("typebox").TString>;
+          username: import("typebox").TOptional<import("typebox").TString>;
+          firstName: import("typebox").TOptional<import("typebox").TString>;
+          lastName: import("typebox").TOptional<import("typebox").TString>;
+        }>>;
       }>>;
     }>;
   }>;
   /**
    * Create a new parameter version.
    */
-  createVersion: _$alepha_server0.ActionPrimitiveFn<{
-    params: _$typebox.TObject<{
-      name: _$typebox.TString;
+  createVersion: import("alepha/server").ActionPrimitiveFn<{
+    params: import("typebox").TObject<{
+      name: import("typebox").TString;
     }>;
-    body: _$typebox.TObject<{
-      content: _$typebox.TRecord<string, _$typebox.TAny>;
-      schemaHash: _$typebox.TString;
-      changeDescription: _$typebox.TOptional<_$typebox.TString>;
-      tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-      creatorId: _$typebox.TOptional<_$typebox.TString>;
-      creatorName: _$typebox.TOptional<_$typebox.TString>;
-      activationDate: _$typebox.TOptional<_$typebox.TString>;
+    body: import("typebox").TObject<{
+      content: import("typebox").TRecord<string, import("typebox").TAny>;
+      schemaHash: import("typebox").TString;
+      changeDescription: import("typebox").TOptional<import("typebox").TString>;
+      tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+      activationDate: import("typebox").TOptional<import("typebox").TString>;
     }>;
-    response: _$typebox.TObject<{
-      id: PgAttr<PgAttr<_$typebox.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-      createdAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-      updatedAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-      name: _$typebox.TString;
-      content: _$typebox.TRecord<string, _$typebox.TAny>;
-      schemaHash: _$typebox.TString;
-      activationDate: _$typebox.TString;
-      version: _$typebox.TInteger;
-      changeDescription: _$typebox.TOptional<_$typebox.TString>;
-      tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-      creatorId: _$typebox.TOptional<_$typebox.TString>;
-      creatorName: _$typebox.TOptional<_$typebox.TString>;
-      previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-      migrationLog: _$typebox.TOptional<_$typebox.TString>;
-      status: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+    response: import("typebox").TObject<{
+      id: PgAttr<PgAttr<import("typebox").TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      name: import("typebox").TString;
+      content: import("typebox").TRecord<string, import("typebox").TAny>;
+      schemaHash: import("typebox").TString;
+      activationDate: import("typebox").TString;
+      version: import("typebox").TInteger;
+      changeDescription: import("typebox").TOptional<import("typebox").TString>;
+      tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+      creatorId: import("typebox").TOptional<import("typebox").TString>;
+      creatorName: import("typebox").TOptional<import("typebox").TString>;
+      previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+      migrationLog: import("typebox").TOptional<import("typebox").TString>;
+      status: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
+      creator: import("typebox").TOptional<import("typebox").TObject<{
+        id: import("typebox").TString;
+        email: import("typebox").TOptional<import("typebox").TString>;
+        username: import("typebox").TOptional<import("typebox").TString>;
+        firstName: import("typebox").TOptional<import("typebox").TString>;
+        lastName: import("typebox").TOptional<import("typebox").TString>;
+      }>>;
     }>;
   }>;
   /**
    * Rollback to a previous version.
    */
-  rollback: _$alepha_server0.ActionPrimitiveFn<{
-    params: _$typebox.TObject<{
-      name: _$typebox.TString;
+  rollback: import("alepha/server").ActionPrimitiveFn<{
+    params: import("typebox").TObject<{
+      name: import("typebox").TString;
     }>;
-    body: _$typebox.TObject<{
-      changeDescription: _$typebox.TOptional<_$typebox.TString>;
-      creatorId: _$typebox.TOptional<_$typebox.TString>;
-      creatorName: _$typebox.TOptional<_$typebox.TString>;
-      targetVersion: _$typebox.TInteger;
+    body: import("typebox").TObject<{
+      changeDescription: import("typebox").TOptional<import("typebox").TString>;
+      targetVersion: import("typebox").TInteger;
     }>;
-    response: _$typebox.TObject<{
-      id: PgAttr<PgAttr<_$typebox.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-      createdAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-      updatedAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-      name: _$typebox.TString;
-      content: _$typebox.TRecord<string, _$typebox.TAny>;
-      schemaHash: _$typebox.TString;
-      activationDate: _$typebox.TString;
-      version: _$typebox.TInteger;
-      changeDescription: _$typebox.TOptional<_$typebox.TString>;
-      tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-      creatorId: _$typebox.TOptional<_$typebox.TString>;
-      creatorName: _$typebox.TOptional<_$typebox.TString>;
-      previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-      migrationLog: _$typebox.TOptional<_$typebox.TString>;
-      status: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+    response: import("typebox").TObject<{
+      id: PgAttr<PgAttr<import("typebox").TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      name: import("typebox").TString;
+      content: import("typebox").TRecord<string, import("typebox").TAny>;
+      schemaHash: import("typebox").TString;
+      activationDate: import("typebox").TString;
+      version: import("typebox").TInteger;
+      changeDescription: import("typebox").TOptional<import("typebox").TString>;
+      tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+      creatorId: import("typebox").TOptional<import("typebox").TString>;
+      creatorName: import("typebox").TOptional<import("typebox").TString>;
+      previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+      migrationLog: import("typebox").TOptional<import("typebox").TString>;
+      status: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
+      creator: import("typebox").TOptional<import("typebox").TObject<{
+        id: import("typebox").TString;
+        email: import("typebox").TOptional<import("typebox").TString>;
+        username: import("typebox").TOptional<import("typebox").TString>;
+        firstName: import("typebox").TOptional<import("typebox").TString>;
+        lastName: import("typebox").TOptional<import("typebox").TString>;
+      }>>;
     }>;
   }>;
   /**
    * Activate a scheduled version immediately.
    * Creates a new version with the same content but immediate activation.
    */
-  activateNow: _$alepha_server0.ActionPrimitiveFn<{
-    params: _$typebox.TObject<{
-      name: _$typebox.TString;
+  activateNow: import("alepha/server").ActionPrimitiveFn<{
+    params: import("typebox").TObject<{
+      name: import("typebox").TString;
     }>;
-    body: _$typebox.TObject<{
-      version: _$typebox.TInteger;
-      creatorId: _$typebox.TOptional<_$typebox.TString>;
-      creatorName: _$typebox.TOptional<_$typebox.TString>;
+    body: import("typebox").TObject<{
+      version: import("typebox").TInteger;
     }>;
-    response: _$typebox.TObject<{
-      id: PgAttr<PgAttr<_$typebox.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-      createdAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-      updatedAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-      name: _$typebox.TString;
-      content: _$typebox.TRecord<string, _$typebox.TAny>;
-      schemaHash: _$typebox.TString;
-      activationDate: _$typebox.TString;
-      version: _$typebox.TInteger;
-      changeDescription: _$typebox.TOptional<_$typebox.TString>;
-      tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-      creatorId: _$typebox.TOptional<_$typebox.TString>;
-      creatorName: _$typebox.TOptional<_$typebox.TString>;
-      previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-      migrationLog: _$typebox.TOptional<_$typebox.TString>;
-      status: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+    response: import("typebox").TObject<{
+      id: PgAttr<PgAttr<import("typebox").TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      name: import("typebox").TString;
+      content: import("typebox").TRecord<string, import("typebox").TAny>;
+      schemaHash: import("typebox").TString;
+      activationDate: import("typebox").TString;
+      version: import("typebox").TInteger;
+      changeDescription: import("typebox").TOptional<import("typebox").TString>;
+      tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+      creatorId: import("typebox").TOptional<import("typebox").TString>;
+      creatorName: import("typebox").TOptional<import("typebox").TString>;
+      previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+      migrationLog: import("typebox").TOptional<import("typebox").TString>;
+      status: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
+      creator: import("typebox").TOptional<import("typebox").TObject<{
+        id: import("typebox").TString;
+        email: import("typebox").TOptional<import("typebox").TString>;
+        username: import("typebox").TOptional<import("typebox").TString>;
+        firstName: import("typebox").TOptional<import("typebox").TString>;
+        lastName: import("typebox").TOptional<import("typebox").TString>;
+      }>>;
     }>;
   }>;
   /**
    * Delete all versions of a parameter.
    */
-  deleteParameter: _$alepha_server0.ActionPrimitiveFn<{
-    params: _$typebox.TObject<{
-      name: _$typebox.TString;
+  deleteParameter: import("alepha/server").ActionPrimitiveFn<{
+    params: import("typebox").TObject<{
+      name: import("typebox").TString;
     }>;
-    response: _$typebox.TObject<{
-      ok: _$typebox.TBoolean;
-      id: _$typebox.TOptional<_$typebox.TUnion<[_$typebox.TString, _$typebox.TInteger]>>;
-      count: _$typebox.TOptional<_$typebox.TNumber>;
+    response: import("typebox").TObject<{
+      ok: import("typebox").TBoolean;
+      id: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TString, import("typebox").TInteger]>>;
+      count: import("typebox").TOptional<import("typebox").TNumber>;
     }>;
   }>;
   /**
    * Delete many parameters (all versions of each) in one request.
    */
-  deleteParameters: _$alepha_server0.ActionPrimitiveFn<{
-    body: _$typebox.TObject<{
-      names: _$typebox.TArray<_$typebox.TString>;
+  deleteParameters: import("alepha/server").ActionPrimitiveFn<{
+    body: import("typebox").TObject<{
+      names: import("typebox").TArray<import("typebox").TString>;
     }>;
-    response: _$typebox.TObject<{
-      deleted: _$typebox.TArray<_$typebox.TString>;
+    response: import("typebox").TObject<{
+      deleted: import("typebox").TArray<import("typebox").TString>;
     }>;
   }>;
+  /**
+   * Derive a human-readable creator name from the authenticated session token.
+   *
+   * The name is snapshotted onto the version at write time rather than joined
+   * from the users table on read: this keeps the parameters module free of any
+   * dependency on the users module (no import, no circular-import risk). The
+   * trade-off is that the stored name does not follow later user renames.
+   *
+   * Precedence: `username` → `email`. The token's `name` is intentionally
+   * skipped: the security layer fills it with a placeholder ("Anonymous User")
+   * when the issuer supplies no name, which would otherwise be snapshotted.
+   */
+  protected creatorNameOf(user?: {
+    username?: string;
+    email?: string;
+  }): string | undefined;
+  /**
+   * Record a parameter mutation via the `ParameterAudits` holder — best-effort.
+   *
+   * `ParameterAudits` is resolved lazily from the container; when it is not
+   * registered, auditing is silently skipped. Actor (userId / email / realm),
+   * IP, and request id are auto-filled by `AuditService` from the request
+   * context. Failures never break the underlying operation.
+   */
+  protected audit(action: "create" | "rollback" | "activate" | "delete", name: string, metadata?: Record<string, unknown>): Promise<void>;
 }
 //#endregion
 //#region ../../src/api/parameters/schemas/activateParameterBodySchema.d.ts
 /**
  * Activate parameter body schema.
- * Uses t.pick for version and creator fields.
+ *
+ * Creator fields are omitted; the controller captures the authenticated user
+ * server-side.
  */
-declare const activateParameterBodySchema: _$typebox.TObject<{
-  version: _$typebox.TInteger;
-  creatorId: _$typebox.TOptional<_$typebox.TString>;
-  creatorName: _$typebox.TOptional<_$typebox.TString>;
+declare const activateParameterBodySchema: import("typebox").TObject<{
+  version: import("typebox").TInteger;
 }>;
 type ActivateParameterBody = Static<typeof activateParameterBodySchema>;
 //#endregion
@@ -1163,15 +1268,16 @@ type ActivateParameterBody = Static<typeof activateParameterBodySchema>;
 /**
  * Create parameter version body schema.
  * Uses t.pick to derive from entity, with required fields made non-optional.
+ *
+ * Creator fields are intentionally omitted: the controller captures the
+ * authenticated user server-side, so they cannot be spoofed by the client.
  */
-declare const createParameterVersionBodySchema: _$typebox.TObject<{
-  content: _$typebox.TRecord<string, _$typebox.TAny>;
-  schemaHash: _$typebox.TString;
-  changeDescription: _$typebox.TOptional<_$typebox.TString>;
-  tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-  creatorId: _$typebox.TOptional<_$typebox.TString>;
-  creatorName: _$typebox.TOptional<_$typebox.TString>;
-  activationDate: _$typebox.TOptional<_$typebox.TString>;
+declare const createParameterVersionBodySchema: import("typebox").TObject<{
+  content: import("typebox").TRecord<string, import("typebox").TAny>;
+  schemaHash: import("typebox").TString;
+  changeDescription: import("typebox").TOptional<import("typebox").TString>;
+  tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+  activationDate: import("typebox").TOptional<import("typebox").TString>;
 }>;
 type CreateParameterVersionBody = Static<typeof createParameterVersionBodySchema>;
 //#endregion
@@ -1180,44 +1286,58 @@ type CreateParameterVersionBody = Static<typeof createParameterVersionBodySchema
  * Current parameter response schema.
  * Includes current version, next scheduled version, and defaults.
  */
-declare const parameterCurrentResponseSchema: _$typebox.TObject<{
-  current: _$typebox.TOptional<_$typebox.TObject<{
-    id: PgAttr<PgAttr<_$typebox.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-    createdAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-    updatedAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-    name: _$typebox.TString;
-    content: _$typebox.TRecord<string, _$typebox.TAny>;
-    schemaHash: _$typebox.TString;
-    activationDate: _$typebox.TString;
-    version: _$typebox.TInteger;
-    changeDescription: _$typebox.TOptional<_$typebox.TString>;
-    tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-    creatorId: _$typebox.TOptional<_$typebox.TString>;
-    creatorName: _$typebox.TOptional<_$typebox.TString>;
-    previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-    migrationLog: _$typebox.TOptional<_$typebox.TString>;
-    status: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+declare const parameterCurrentResponseSchema: import("typebox").TObject<{
+  current: import("typebox").TOptional<import("typebox").TObject<{
+    id: PgAttr<PgAttr<import("typebox").TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+    createdAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+    updatedAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+    name: import("typebox").TString;
+    content: import("typebox").TRecord<string, import("typebox").TAny>;
+    schemaHash: import("typebox").TString;
+    activationDate: import("typebox").TString;
+    version: import("typebox").TInteger;
+    changeDescription: import("typebox").TOptional<import("typebox").TString>;
+    tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+    creatorId: import("typebox").TOptional<import("typebox").TString>;
+    creatorName: import("typebox").TOptional<import("typebox").TString>;
+    previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+    migrationLog: import("typebox").TOptional<import("typebox").TString>;
+    status: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
+    creator: import("typebox").TOptional<import("typebox").TObject<{
+      id: import("typebox").TString;
+      email: import("typebox").TOptional<import("typebox").TString>;
+      username: import("typebox").TOptional<import("typebox").TString>;
+      firstName: import("typebox").TOptional<import("typebox").TString>;
+      lastName: import("typebox").TOptional<import("typebox").TString>;
+    }>>;
   }>>;
-  next: _$typebox.TOptional<_$typebox.TObject<{
-    id: PgAttr<PgAttr<_$typebox.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-    createdAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-    updatedAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-    name: _$typebox.TString;
-    content: _$typebox.TRecord<string, _$typebox.TAny>;
-    schemaHash: _$typebox.TString;
-    activationDate: _$typebox.TString;
-    version: _$typebox.TInteger;
-    changeDescription: _$typebox.TOptional<_$typebox.TString>;
-    tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-    creatorId: _$typebox.TOptional<_$typebox.TString>;
-    creatorName: _$typebox.TOptional<_$typebox.TString>;
-    previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-    migrationLog: _$typebox.TOptional<_$typebox.TString>;
-    status: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+  next: import("typebox").TOptional<import("typebox").TObject<{
+    id: PgAttr<PgAttr<import("typebox").TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+    createdAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+    updatedAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+    name: import("typebox").TString;
+    content: import("typebox").TRecord<string, import("typebox").TAny>;
+    schemaHash: import("typebox").TString;
+    activationDate: import("typebox").TString;
+    version: import("typebox").TInteger;
+    changeDescription: import("typebox").TOptional<import("typebox").TString>;
+    tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+    creatorId: import("typebox").TOptional<import("typebox").TString>;
+    creatorName: import("typebox").TOptional<import("typebox").TString>;
+    previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+    migrationLog: import("typebox").TOptional<import("typebox").TString>;
+    status: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
+    creator: import("typebox").TOptional<import("typebox").TObject<{
+      id: import("typebox").TString;
+      email: import("typebox").TOptional<import("typebox").TString>;
+      username: import("typebox").TOptional<import("typebox").TString>;
+      firstName: import("typebox").TOptional<import("typebox").TString>;
+      lastName: import("typebox").TOptional<import("typebox").TString>;
+    }>>;
   }>>;
-  defaultValue: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-  currentValue: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-  schema: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
+  defaultValue: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+  currentValue: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+  schema: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
 }>;
 type ParameterCurrentResponse = Static<typeof parameterCurrentResponseSchema>;
 //#endregion
@@ -1225,23 +1345,30 @@ type ParameterCurrentResponse = Static<typeof parameterCurrentResponseSchema>;
 /**
  * Parameter history response schema.
  */
-declare const parameterHistoryResponseSchema: _$typebox.TObject<{
-  versions: _$typebox.TArray<_$typebox.TObject<{
-    id: PgAttr<PgAttr<_$typebox.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-    createdAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-    updatedAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-    name: _$typebox.TString;
-    content: _$typebox.TRecord<string, _$typebox.TAny>;
-    schemaHash: _$typebox.TString;
-    activationDate: _$typebox.TString;
-    version: _$typebox.TInteger;
-    changeDescription: _$typebox.TOptional<_$typebox.TString>;
-    tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-    creatorId: _$typebox.TOptional<_$typebox.TString>;
-    creatorName: _$typebox.TOptional<_$typebox.TString>;
-    previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-    migrationLog: _$typebox.TOptional<_$typebox.TString>;
-    status: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+declare const parameterHistoryResponseSchema: import("typebox").TObject<{
+  versions: import("typebox").TArray<import("typebox").TObject<{
+    id: PgAttr<PgAttr<import("typebox").TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+    createdAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+    updatedAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+    name: import("typebox").TString;
+    content: import("typebox").TRecord<string, import("typebox").TAny>;
+    schemaHash: import("typebox").TString;
+    activationDate: import("typebox").TString;
+    version: import("typebox").TInteger;
+    changeDescription: import("typebox").TOptional<import("typebox").TString>;
+    tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+    creatorId: import("typebox").TOptional<import("typebox").TString>;
+    creatorName: import("typebox").TOptional<import("typebox").TString>;
+    previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+    migrationLog: import("typebox").TOptional<import("typebox").TString>;
+    status: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
+    creator: import("typebox").TOptional<import("typebox").TObject<{
+      id: import("typebox").TString;
+      email: import("typebox").TOptional<import("typebox").TString>;
+      username: import("typebox").TOptional<import("typebox").TString>;
+      firstName: import("typebox").TOptional<import("typebox").TString>;
+      lastName: import("typebox").TOptional<import("typebox").TString>;
+    }>>;
   }>>;
 }>;
 type ParameterHistoryResponse = Static<typeof parameterHistoryResponseSchema>;
@@ -1251,16 +1378,16 @@ type ParameterHistoryResponse = Static<typeof parameterHistoryResponseSchema>;
  * Parameter name param schema.
  * Uses t.pick from entity for consistency.
  */
-declare const parameterNameParamSchema: _$typebox.TObject<{
-  name: _$typebox.TString;
+declare const parameterNameParamSchema: import("typebox").TObject<{
+  name: import("typebox").TString;
 }>;
 //#endregion
 //#region ../../src/api/parameters/schemas/parameterNamesResponseSchema.d.ts
 /**
  * Parameter names list response schema.
  */
-declare const parameterNamesResponseSchema: _$typebox.TObject<{
-  names: _$typebox.TArray<_$typebox.TString>;
+declare const parameterNamesResponseSchema: import("typebox").TObject<{
+  names: import("typebox").TArray<import("typebox").TString>;
 }>;
 type ParameterNamesResponse = Static<typeof parameterNamesResponseSchema>;
 //#endregion
@@ -1269,23 +1396,33 @@ type ParameterNamesResponse = Static<typeof parameterNamesResponseSchema>;
  * Parameter response schema for API responses.
  * Extends the entity schema with a calculated status field.
  * Status is derived from activationDate at query time, not stored.
+ *
+ * `creator` is embedded on read via a best-effort left join on `creatorId`
+ * (see `parameterCreatorSummarySchema`); it is not a stored column.
  */
-declare const parameterResponseSchema: _$typebox.TObject<{
-  id: PgAttr<PgAttr<_$typebox.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-  createdAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-  updatedAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-  name: _$typebox.TString;
-  content: _$typebox.TRecord<string, _$typebox.TAny>;
-  schemaHash: _$typebox.TString;
-  activationDate: _$typebox.TString;
-  version: _$typebox.TInteger;
-  changeDescription: _$typebox.TOptional<_$typebox.TString>;
-  tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-  creatorId: _$typebox.TOptional<_$typebox.TString>;
-  creatorName: _$typebox.TOptional<_$typebox.TString>;
-  previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-  migrationLog: _$typebox.TOptional<_$typebox.TString>;
-  status: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+declare const parameterResponseSchema: import("typebox").TObject<{
+  id: PgAttr<PgAttr<import("typebox").TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+  createdAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+  updatedAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+  name: import("typebox").TString;
+  content: import("typebox").TRecord<string, import("typebox").TAny>;
+  schemaHash: import("typebox").TString;
+  activationDate: import("typebox").TString;
+  version: import("typebox").TInteger;
+  changeDescription: import("typebox").TOptional<import("typebox").TString>;
+  tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+  creatorId: import("typebox").TOptional<import("typebox").TString>;
+  creatorName: import("typebox").TOptional<import("typebox").TString>;
+  previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+  migrationLog: import("typebox").TOptional<import("typebox").TString>;
+  status: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
+  creator: import("typebox").TOptional<import("typebox").TObject<{
+    id: import("typebox").TString;
+    email: import("typebox").TOptional<import("typebox").TString>;
+    username: import("typebox").TOptional<import("typebox").TString>;
+    firstName: import("typebox").TOptional<import("typebox").TString>;
+    lastName: import("typebox").TOptional<import("typebox").TString>;
+  }>>;
 }>;
 type ParameterResponse = Static<typeof parameterResponseSchema>;
 //#endregion
@@ -1294,32 +1431,39 @@ type ParameterResponse = Static<typeof parameterResponseSchema>;
  * Parameter name and version param schema.
  * Uses t.pick from entity for consistency.
  */
-declare const parameterVersionParamSchema: _$typebox.TObject<{
-  name: _$typebox.TString;
-  version: _$typebox.TInteger;
+declare const parameterVersionParamSchema: import("typebox").TObject<{
+  name: import("typebox").TString;
+  version: import("typebox").TInteger;
 }>;
 //#endregion
 //#region ../../src/api/parameters/schemas/parameterVersionResponseSchema.d.ts
 /**
  * Parameter version response schema.
  */
-declare const parameterVersionResponseSchema: _$typebox.TObject<{
-  parameter: _$typebox.TOptional<_$typebox.TObject<{
-    id: PgAttr<PgAttr<_$typebox.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
-    createdAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
-    updatedAt: PgAttr<PgAttr<_$typebox.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
-    name: _$typebox.TString;
-    content: _$typebox.TRecord<string, _$typebox.TAny>;
-    schemaHash: _$typebox.TString;
-    activationDate: _$typebox.TString;
-    version: _$typebox.TInteger;
-    changeDescription: _$typebox.TOptional<_$typebox.TString>;
-    tags: _$typebox.TOptional<_$typebox.TArray<_$typebox.TString>>;
-    creatorId: _$typebox.TOptional<_$typebox.TString>;
-    creatorName: _$typebox.TOptional<_$typebox.TString>;
-    previousContent: _$typebox.TOptional<_$typebox.TRecord<string, _$typebox.TAny>>;
-    migrationLog: _$typebox.TOptional<_$typebox.TString>;
-    status: _$typebox.TUnsafe<"expired" | "current" | "next" | "future">;
+declare const parameterVersionResponseSchema: import("typebox").TObject<{
+  parameter: import("typebox").TOptional<import("typebox").TObject<{
+    id: PgAttr<PgAttr<import("typebox").TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+    createdAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+    updatedAt: PgAttr<PgAttr<import("typebox").TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+    name: import("typebox").TString;
+    content: import("typebox").TRecord<string, import("typebox").TAny>;
+    schemaHash: import("typebox").TString;
+    activationDate: import("typebox").TString;
+    version: import("typebox").TInteger;
+    changeDescription: import("typebox").TOptional<import("typebox").TString>;
+    tags: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+    creatorId: import("typebox").TOptional<import("typebox").TString>;
+    creatorName: import("typebox").TOptional<import("typebox").TString>;
+    previousContent: import("typebox").TOptional<import("typebox").TRecord<string, import("typebox").TAny>>;
+    migrationLog: import("typebox").TOptional<import("typebox").TString>;
+    status: import("typebox").TUnsafe<"expired" | "current" | "next" | "future">;
+    creator: import("typebox").TOptional<import("typebox").TObject<{
+      id: import("typebox").TString;
+      email: import("typebox").TOptional<import("typebox").TString>;
+      username: import("typebox").TOptional<import("typebox").TString>;
+      firstName: import("typebox").TOptional<import("typebox").TString>;
+      lastName: import("typebox").TOptional<import("typebox").TString>;
+    }>>;
   }>>;
 }>;
 type ParameterVersionResponse = Static<typeof parameterVersionResponseSchema>;
@@ -1327,13 +1471,13 @@ type ParameterVersionResponse = Static<typeof parameterVersionResponseSchema>;
 //#region ../../src/api/parameters/schemas/rollbackParameterBodySchema.d.ts
 /**
  * Rollback parameter body schema.
- * Uses t.pick for creator fields, adds targetVersion.
+ *
+ * Creator fields are omitted; the controller captures the authenticated user
+ * server-side.
  */
-declare const rollbackParameterBodySchema: _$typebox.TObject<{
-  changeDescription: _$typebox.TOptional<_$typebox.TString>;
-  creatorId: _$typebox.TOptional<_$typebox.TString>;
-  creatorName: _$typebox.TOptional<_$typebox.TString>;
-  targetVersion: _$typebox.TInteger;
+declare const rollbackParameterBodySchema: import("typebox").TObject<{
+  changeDescription: import("typebox").TOptional<import("typebox").TString>;
+  targetVersion: import("typebox").TInteger;
 }>;
 type RollbackParameterBody = Static<typeof rollbackParameterBodySchema>;
 //#endregion
@@ -1350,7 +1494,7 @@ type RollbackParameterBody = Static<typeof rollbackParameterBodySchema>;
  *
  * @module alepha.api.parameters
  */
-declare const AlephaApiParameters: _$alepha.Service<_$alepha.Module>;
+declare const AlephaApiParameters: import("alepha").Service<import("alepha").Module>;
 //#endregion
-export { $parameter, ActivateParameterBody, AdminParameterController, AlephaApiParameters, CreateParameterVersionBody, Parameter, ParameterChangePayload, ParameterCurrentResponse, ParameterHistoryResponse, ParameterNamesResponse, ParameterPrimitive, ParameterPrimitiveOptions, ParameterProvider, ParameterResponse, ParameterStatus, ParameterTreeNode, ParameterVersionResponse, ParameterWithStatus, RollbackParameterBody, SaveParameterOptions, SetParameterOptions, activateParameterBodySchema, createParameterVersionBodySchema, parameterCurrentResponseSchema, parameterHistoryResponseSchema, parameterNameParamSchema, parameterNamesResponseSchema, parameterResponseSchema, parameterStatusSchema, parameterTreeNodeSchema, parameterVersionParamSchema, parameterVersionResponseSchema, parameters, rollbackParameterBodySchema };
+export { $parameter, ActivateParameterBody, AdminParameterController, AlephaApiParameters, CreateParameterVersionBody, Parameter, ParameterAudits, ParameterChangePayload, ParameterCurrentResponse, ParameterHistoryResponse, ParameterNamesResponse, ParameterPrimitive, ParameterPrimitiveOptions, ParameterProvider, ParameterResponse, ParameterStatus, ParameterTreeNode, ParameterVersionResponse, ParameterWithStatus, RollbackParameterBody, SaveParameterOptions, SetParameterOptions, activateParameterBodySchema, createParameterVersionBodySchema, parameterCurrentResponseSchema, parameterHistoryResponseSchema, parameterNameParamSchema, parameterNamesResponseSchema, parameterResponseSchema, parameterStatusSchema, parameterTreeNodeSchema, parameterVersionParamSchema, parameterVersionResponseSchema, parameters, rollbackParameterBodySchema };
 //# sourceMappingURL=index.d.ts.map