alepha 0.15.0 → 0.15.1

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

@@ -36,61 +36,61 @@ declare const parameters: alepha_orm0.EntityPrimitive<alepha624.TObject<{
   createdAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha624.TString, typeof alepha_orm0.PG_CREATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
   updatedAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha624.TString, typeof alepha_orm0.PG_UPDATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
   /**
-       * Configuration name using dot notation for tree hierarchy.
-       * Examples: "app.features", "app.pricing.tiers", "system.limits"
-       */
+   * Configuration name using dot notation for tree hierarchy.
+   * Examples: "app.features", "app.pricing.tiers", "system.limits"
+   */
   name: alepha624.TString;
   /**
-       * The configuration content as JSON.
-       */
+   * The configuration content as JSON.
+   */
   content: alepha624.TRecord<string, alepha624.TAny>;
   /**
-       * Schema version hash for detecting schema changes.
-       * Used for auto-migration when schema evolves.
-       */
+   * Schema version hash for detecting schema changes.
+   * Used for auto-migration when schema evolves.
+   */
   schemaHash: alepha624.TString;
   /**
-       * Current status of this parameter version.
-       */
+   * Current status of this parameter version.
+   */
   status: alepha_orm0.PgAttr<alepha624.TUnsafe<"expired" | "current" | "next" | "future">, typeof alepha_orm0.PG_DEFAULT>;
   /**
-       * When this version should become active.
-       * Default is immediate (now).
-       */
+   * When this version should become active.
+   * Default is immediate (now).
+   */
   activationDate: alepha624.TString;
   /**
-       * When this version was deactivated (became expired).
-       * Null if still active or scheduled.
-       */
+   * When this version was deactivated (became expired).
+   * Null if still active or scheduled.
+   */
   expiredAt: alepha624.TOptional<alepha624.TString>;
   /**
-       * Version number for this configuration.
-       * Auto-incremented per config name.
-       */
+   * Version number for this configuration.
+   * Auto-incremented per config name.
+   */
   version: alepha624.TInteger;
   /**
-       * Optional description of changes in this version.
-       */
+   * Optional description of changes in this version.
+   */
   changeDescription: alepha624.TOptional<alepha624.TString>;
   /**
-       * Optional tags for filtering/categorization.
-       */
+   * Optional tags for filtering/categorization.
+   */
   tags: alepha624.TOptional<alepha624.TArray<alepha624.TString>>;
   /**
-       * Creator user ID (if available).
-       */
+   * Creator user ID (if available).
+   */
   creatorId: alepha624.TOptional<alepha624.TString>;
   /**
-       * Creator display name for audit trail.
-       */
+   * Creator display name for audit trail.
+   */
   creatorName: alepha624.TOptional<alepha624.TString>;
   /**
-       * Previous content before this change (for rollback reference).
-       */
+   * Previous content before this change (for rollback reference).
+   */
   previousContent: alepha624.TOptional<alepha624.TRecord<string, alepha624.TAny>>;
   /**
-       * Migration log if schema changed.
-       */
+   * Migration log if schema changed.
+   */
   migrationLog: alepha624.TOptional<alepha624.TString>;
 }>>;
 type Parameter = Static<typeof parameters.schema>;
@@ -126,114 +126,114 @@ type TObjectUpdate<T extends TObject> = TObject<{ [K in keyof T["properties"]]:
 //#region ../../src/orm/primitives/$entity.d.ts
 interface EntityPrimitiveOptions<T extends TObject, Keys = keyof Static<T>> {
   /**
-       * The database table name that will be created for this entity.
-       * If not provided, name will be inferred from the $repository variable name.
-       */
+   * The database table name that will be created for this entity.
+   * If not provided, name will be inferred from the $repository variable name.
+   */
   name: string;
   /**
-       * TypeBox schema defining the table structure and column types.
-       */
+   * TypeBox schema defining the table structure and column types.
+   */
   schema: T;
   /**
-       * Database indexes to create for query optimization.
-       */
+   * Database indexes to create for query optimization.
+   */
   indexes?: (Keys | {
     /**
-             * Single column to index.
-             */
+     * Single column to index.
+     */
     column: Keys;
     /**
-             * Whether this should be a unique index (enforces uniqueness constraint).
-             */
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
     unique?: boolean;
     /**
-             * Custom name for the index. If not provided, generates name automatically.
-             */
+     * Custom name for the index. If not provided, generates name automatically.
+     */
     name?: string;
   } | {
     /**
-             * Multiple columns for composite index (order matters for query optimization).
-             */
+     * Multiple columns for composite index (order matters for query optimization).
+     */
     columns: Keys[];
     /**
-             * Whether this should be a unique index (enforces uniqueness constraint).
-             */
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
     unique?: boolean;
     /**
-             * Custom name for the index. If not provided, generates name automatically.
-             */
+     * Custom name for the index. If not provided, generates name automatically.
+     */
     name?: string;
   })[];
   /**
-       * Foreign key constraints to maintain referential integrity.
-       */
+   * Foreign key constraints to maintain referential integrity.
+   */
   foreignKeys?: Array<{
     /**
-             * Optional name for the foreign key constraint.
-             */
+     * Optional name for the foreign key constraint.
+     */
     name?: string;
     /**
-             * Local columns that reference the foreign table.
-             */
+     * Local columns that reference the foreign table.
+     */
     columns: Array<keyof Static<T>>;
     /**
-             * Referenced columns in the foreign table.
-             * Must be EntityColumn references from other entities.
-             */
+     * Referenced columns in the foreign table.
+     * Must be EntityColumn references from other entities.
+     */
     foreignColumns: Array<() => EntityColumn<any>>;
   }>;
   /**
-       * Additional table constraints for data validation.
-       *
-       * Constraints enforce business rules at the database level, providing
-       * an additional layer of data integrity beyond application validation.
-       *
-       * **Constraint Types**:
-       * - **Unique constraints**: Prevent duplicate values across columns
-       * - **Check constraints**: Enforce custom validation rules with SQL expressions
-       *
-       * @example
-       * ```ts
-       * constraints: [
-       *   {
-       *     name: "unique_user_email",
-       *     columns: ["email"],
-       *     unique: true
-       *   },
-       *   {
-       *     name: "valid_age_range",
-       *     columns: ["age"],
-       *     check: sql`age >= 0 AND age <= 150`
-       *   },
-       *   {
-       *     name: "unique_user_username_per_tenant",
-       *     columns: ["tenantId", "username"],
-       *     unique: true
-       *   }
-       * ]
-       * ```
-       */
+   * Additional table constraints for data validation.
+   *
+   * Constraints enforce business rules at the database level, providing
+   * an additional layer of data integrity beyond application validation.
+   *
+   * **Constraint Types**:
+   * - **Unique constraints**: Prevent duplicate values across columns
+   * - **Check constraints**: Enforce custom validation rules with SQL expressions
+   *
+   * @example
+   * ```ts
+   * constraints: [
+   *   {
+   *     name: "unique_user_email",
+   *     columns: ["email"],
+   *     unique: true
+   *   },
+   *   {
+   *     name: "valid_age_range",
+   *     columns: ["age"],
+   *     check: sql`age >= 0 AND age <= 150`
+   *   },
+   *   {
+   *     name: "unique_user_username_per_tenant",
+   *     columns: ["tenantId", "username"],
+   *     unique: true
+   *   }
+   * ]
+   * ```
+   */
   constraints?: Array<{
     /**
-             * Columns involved in this constraint.
-             */
+     * Columns involved in this constraint.
+     */
     columns: Array<keyof Static<T>>;
     /**
-             * Optional name for the constraint.
-             */
+     * Optional name for the constraint.
+     */
     name?: string;
     /**
-             * Whether this is a unique constraint.
-             */
+     * Whether this is a unique constraint.
+     */
     unique?: boolean | {};
     /**
-             * SQL expression for check constraint validation.
-             */
+     * SQL expression for check constraint validation.
+     */
     check?: SQL;
   }>;
   /**
-       * Advanced Drizzle ORM configuration for complex table setups.
-       */
+   * Advanced Drizzle ORM configuration for complex table setups.
+   */
   config?: (self: BuildExtraConfigColumns<string, FromSchema<T>, "pg">) => PgTableExtraConfigValue[];
 }
 declare class EntityPrimitive<T extends TObject = TObject> {
@@ -281,8 +281,8 @@ type PgSymbols = {
   [PG_REF]: PgRefOptions;
   [PG_ENUM]: PgEnumOptions;
   /**
-       * @deprecated Use `PG_IDENTITY` instead.
-       */
+   * @deprecated Use `PG_IDENTITY` instead.
+   */
   [PG_SERIAL]: {};
 };
 type PgSymbolKeys = keyof PgSymbols;
@@ -359,21 +359,21 @@ type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & { [K in TAttr]:
  */
 interface ConfigPrimitiveOptions<T extends TObject> {
   /**
-       * Configuration name using dot notation for tree hierarchy.
-       * Examples: "app.features", "app.pricing.tiers", "system.limits"
-       */
+   * Configuration name using dot notation for tree hierarchy.
+   * Examples: "app.features", "app.pricing.tiers", "system.limits"
+   */
   name?: string;
   /**
-       * Human-readable description of the configuration.
-       */
+   * Human-readable description of the configuration.
+   */
   description?: string;
   /**
-       * TypeBox schema defining the configuration structure.
-       */
+   * TypeBox schema defining the configuration structure.
+   */
   schema: T;
   /**
-       * Default value used when no configuration exists in database.
-       */
+   * Default value used when no configuration exists in database.
+   */
   default: Static<T>;
 }
 declare class ConfigPrimitive<T extends TObject> extends Primitive<ConfigPrimitiveOptions<T>> {
@@ -388,45 +388,45 @@ declare class ConfigPrimitive<T extends TObject> extends Primitive<ConfigPrimiti
   /** Whether initial load has completed */
   protected loaded: boolean;
   /**
-       * Configuration name (uses property key if not specified).
-       */
+   * Configuration name (uses property key if not specified).
+   */
   get name(): string;
   /**
-       * The TypeBox schema for this configuration.
-       */
+   * The TypeBox schema for this configuration.
+   */
   get schema(): T;
   /**
-       * Get the current configuration value.
-       */
+   * Get the current configuration value.
+   */
   get current(): Static<T>;
   /**
-       * Get a specific field from the current configuration.
-       */
+   * Get a specific field from the current configuration.
+   */
   get<Key extends keyof Static<T>>(key: Key): Static<T>[Key];
   /**
-       * Set a new configuration value.
-       *
-       * @param value - The new configuration value
-       * @param options - Optional settings (activation date, creator info, etc.)
-       */
+   * Set a new configuration value.
+   *
+   * @param value - The new configuration value
+   * @param options - Optional settings (activation date, creator info, etc.)
+   */
   set(value: Static<T>, options?: SetConfigOptions): Promise<void>;
   /**
-       * Subscribe to configuration changes.
-       */
+   * Subscribe to configuration changes.
+   */
   sub(fn: (curr: Static<T>) => void): () => void;
   /**
-       * Reload configuration from database.
-       * Called when scheduled config activates or sync message received.
-       */
+   * Reload configuration from database.
+   * Called when scheduled config activates or sync message received.
+   */
   reload(): Promise<void>;
   /**
-       * Update from sync message (called by ConfigStore).
-       * Uses skipEvents to avoid infinite loops.
-       */
+   * Update from sync message (called by ConfigStore).
+   * Uses skipEvents to avoid infinite loops.
+   */
   updateFromSync(content: unknown): Promise<void>;
   /**
-       * Get version history for this configuration.
-       */
+   * Get version history for this configuration.
+   */
   getHistory(): Promise<{
     expiredAt?: string | undefined;
     changeDescription?: string | undefined;
@@ -480,24 +480,24 @@ declare class ConfigPrimitive<T extends TObject> extends Primitive<ConfigPrimiti
     version: number;
   }[]>;
   /**
-       * Rollback to a specific version.
-       */
+   * Rollback to a specific version.
+   */
   rollback(version: number, options?: SetConfigOptions): Promise<void>;
   /**
-       * Hook to load initial value from database on start.
-       */
+   * Hook to load initial value from database on start.
+   */
   protected readonly onStart: alepha624.HookPrimitive<"start">;
   /**
-       * Called after primitive creation to initialize.
-       */
+   * Called after primitive creation to initialize.
+   */
   protected onInit(): void;
   /**
-       * Load initial value from database.
-       */
+   * Load initial value from database.
+   */
   protected loadInitial(): Promise<void>;
   /**
-       * Calculate a hash of the schema for migration detection.
-       */
+   * Calculate a hash of the schema for migration detection.
+   */
   protected calculateSchemaHash(): string;
 }
 declare const $config: {
@@ -506,21 +506,21 @@ declare const $config: {
 };
 interface SetConfigOptions {
   /**
-       * User making the change (for audit trail).
-       */
+   * User making the change (for audit trail).
+   */
   user?: Pick<UserAccount, "id" | "email" | "name">;
   /**
-       * When this configuration should become active.
-       * Default is immediate (now).
-       */
+   * When this configuration should become active.
+   * Default is immediate (now).
+   */
   activationDate?: Date;
   /**
-       * Description of the change.
-       */
+   * Description of the change.
+   */
   changeDescription?: string;
   /**
-       * Tags for filtering/categorization.
-       */
+   * Tags for filtering/categorization.
+   */
   tags?: string[];
 }
 //#endregion
@@ -581,50 +581,50 @@ declare class ConfigStore {
     }>;
   }>;
   /**
-       * Register a config primitive with the store.
-       */
+   * Register a config primitive with the store.
+   */
   register(config: ConfigPrimitive<any>): void;
   /**
-       * Load the current config value from database.
-       * Returns the current or next version if no current exists.
-       */
+   * Load the current config value from database.
+   * Returns the current or next version if no current exists.
+   */
   load<T extends TObject>(name: string): Promise<Static<T> | null>;
   /**
-       * Save a new config version.
-       *
-       * @param name - Config name (e.g., "app.features.flags")
-       * @param content - New config content
-       * @param schemaHash - Hash of the schema for migration detection
-       * @param options - Additional options (activation date, creator info, etc.)
-       */
+   * Save a new config version.
+   *
+   * @param name - Config name (e.g., "app.features.flags")
+   * @param content - New config content
+   * @param schemaHash - Hash of the schema for migration detection
+   * @param options - Additional options (activation date, creator info, etc.)
+   */
   save<T extends TObject>(name: string, content: Static<T>, schemaHash: string, options?: SaveConfigOptions): Promise<Parameter>;
   /**
-       * Get all versions of a config.
-       */
+   * Get all versions of a config.
+   */
   getHistory(name: string): Promise<Parameter[]>;
   /**
-       * Get a specific version of a config.
-       */
+   * Get a specific version of a config.
+   */
   getVersion(name: string, version: number): Promise<Parameter | null>;
   /**
-       * Rollback to a previous version by creating a new version with old content.
-       */
+   * Rollback to a previous version by creating a new version with old content.
+   */
   rollback(name: string, targetVersion: number, options?: SaveConfigOptions): Promise<Parameter>;
   /**
-       * Get all configs by status.
-       */
+   * Get all configs by status.
+   */
   getByStatus(status: ParameterStatus): Promise<Parameter[]>;
   /**
-       * Get current config value with fallback to default from registered primitive.
-       * Returns the in-memory current value which may be the default if never saved.
-       */
+   * Get current config value with fallback to default from registered primitive.
+   * Returns the in-memory current value which may be the default if never saved.
+   */
   getCurrentValue(name: string): {
     content: unknown;
     isDefault: boolean;
   } | null;
   /**
-       * Get config info including current value with default fallback.
-       */
+   * Get config info including current value with default fallback.
+   */
   getCurrentWithDefault(name: string): Promise<{
     current: Parameter | null;
     next: Parameter | null;
@@ -633,38 +633,38 @@ declare class ConfigStore {
     schema: TObject | null;
   }>;
   /**
-       * Get all unique config names (for tree view).
-       */
+   * Get all unique config names (for tree view).
+   */
   getConfigNames(): Promise<string[]>;
   /**
-       * Build a tree structure from config names for UI.
-       * Includes both database configs and registered (but not yet saved) configs.
-       */
+   * Build a tree structure from config names for UI.
+   * Includes both database configs and registered (but not yet saved) configs.
+   */
   getConfigTree(): Promise<ConfigTreeNode[]>;
   /**
-       * Check and activate scheduled configs that are due.
-       * Should be called periodically (e.g., via scheduler).
-       */
+   * Check and activate scheduled configs that are due.
+   * Should be called periodically (e.g., via scheduler).
+   */
   activateScheduledConfigs(): Promise<void>;
   /**
-       * Transition config statuses when a new current is activated.
-       */
+   * Transition config statuses when a new current is activated.
+   */
   protected transitionStatuses(name: string, now: Date): Promise<void>;
   /**
-       * Recalculate statuses based on activation dates.
-       */
+   * Recalculate statuses based on activation dates.
+   */
   protected recalculateStatuses(name: string): Promise<void>;
   /**
-       * Publish sync event to other instances.
-       */
+   * Publish sync event to other instances.
+   */
   protected publishSync(name: string, version: number, content: unknown, status: ParameterStatus): Promise<void>;
   /**
-       * Handle incoming sync message from other instances.
-       */
+   * Handle incoming sync message from other instances.
+   */
   protected handleSyncMessage(payload: ConfigSyncPayload): Promise<void>;
   /**
-       * Build tree structure from dot-notation names.
-       */
+   * Build tree structure from dot-notation names.
+   */
   protected buildTree(names: string[]): ConfigTreeNode[];
 }
 interface SaveConfigOptions {
@@ -698,9 +698,9 @@ declare class AdminConfigController {
   protected readonly group = "admin:configs";
   protected readonly store: ConfigStore;
   /**
-       * Get tree structure of all configuration names.
-       * Useful for admin UI navigation.
-       */
+   * Get tree structure of all configuration names.
+   * Useful for admin UI navigation.
+   */
   getConfigTree: alepha_server0.ActionPrimitiveFn<{
     response: alepha624.TArray<alepha624.TObject<{
       name: alepha624.TString;
@@ -710,16 +710,16 @@ declare class AdminConfigController {
     }>>;
   }>;
   /**
-       * List all unique configuration names.
-       */
+   * List all unique configuration names.
+   */
   listConfigNames: alepha_server0.ActionPrimitiveFn<{
     response: alepha624.TObject<{
       names: alepha624.TArray<alepha624.TString>;
     }>;
   }>;
   /**
-       * Get configurations by status.
-       */
+   * Get configurations by status.
+   */
   getByStatus: alepha_server0.ActionPrimitiveFn<{
     params: alepha624.TObject<{
       status: alepha624.TUnsafe<"expired" | "current" | "next" | "future">;
@@ -746,8 +746,8 @@ declare class AdminConfigController {
     }>;
   }>;
   /**
-       * Get version history for a specific configuration.
-       */
+   * Get version history for a specific configuration.
+   */
   getHistory: alepha_server0.ActionPrimitiveFn<{
     params: alepha624.TObject<{
       name: alepha624.TString;
@@ -774,10 +774,10 @@ declare class AdminConfigController {
     }>;
   }>;
   /**
-       * Get current and next values for a configuration.
-       * Includes defaultValue and currentValue from the registered primitive
-       * even if no versions exist in the database yet.
-       */
+   * Get current and next values for a configuration.
+   * Includes defaultValue and currentValue from the registered primitive
+   * even if no versions exist in the database yet.
+   */
   getCurrent: alepha_server0.ActionPrimitiveFn<{
     params: alepha624.TObject<{
       name: alepha624.TString;
@@ -825,8 +825,8 @@ declare class AdminConfigController {
     }>;
   }>;
   /**
-       * Get a specific version of a configuration.
-       */
+   * Get a specific version of a configuration.
+   */
   getVersion: alepha_server0.ActionPrimitiveFn<{
     params: alepha624.TObject<{
       name: alepha624.TString;
@@ -854,8 +854,8 @@ declare class AdminConfigController {
     }>;
   }>;
   /**
-       * Create a new configuration version.
-       */
+   * Create a new configuration version.
+   */
   createVersion: alepha_server0.ActionPrimitiveFn<{
     params: alepha624.TObject<{
       name: alepha624.TString;
@@ -889,8 +889,8 @@ declare class AdminConfigController {
     }>;
   }>;
   /**
-       * Rollback to a previous version.
-       */
+   * Rollback to a previous version.
+   */
   rollback: alepha_server0.ActionPrimitiveFn<{
     params: alepha624.TObject<{
       name: alepha624.TString;
@@ -921,8 +921,8 @@ declare class AdminConfigController {
     }>;
   }>;
   /**
-       * Activate a scheduled version immediately.
-       */
+   * Activate a scheduled version immediately.
+   */
   activateNow: alepha_server0.ActionPrimitiveFn<{
     params: alepha624.TObject<{
       name: alepha624.TString;
@@ -952,9 +952,9 @@ declare class AdminConfigController {
     }>;
   }>;
   /**
-       * Trigger activation check for all scheduled configs.
-       * Normally called by a scheduler, but exposed for manual triggering.
-       */
+   * Trigger activation check for all scheduled configs.
+   * Normally called by a scheduler, but exposed for manual triggering.
+   */
   checkScheduled: alepha_server0.ActionPrimitiveFn<{
     response: alepha624.TObject<{
       message: alepha624.TString;
@@ -974,8 +974,8 @@ declare class ConfigActivationScheduler {
   protected readonly log: alepha_logger0.Logger;
   protected readonly store: ConfigStore;
   /**
-       * Check for scheduled configurations every minute.
-       */
+   * Check for scheduled configurations every minute.
+   */
   checkActivations: alepha_scheduler0.SchedulerPrimitive;
 }
 //#endregion