@qodalis/cli-core 0.0.11 → 0.0.13

package/lib/interfaces/index.d.ts

@@ -1,7 +1,7 @@
-import { Observable } from 'rxjs';
-import { CliBackgroundColor, CliForegroundColor, CliLogLevel, CliProcessCommand, CliProvider, ICliUser, ICliUserSession } from '../models';
+import { Observable, Subscription } from 'rxjs';
+import { CliBackgroundColor, CliForegroundColor, CliLogLevel, CliProcessCommand, CliProvider, CliState } from '../models';
 import { ICliExecutionContext } from './execution-context';
-import { ICliCommandProcessor } from './command-processor';
+import { ICliCommandChildProcessor, ICliCommandProcessor } from './command-processor';
 export interface ICliTerminalWriter {
     /**
      * Write text to the terminal
@@ -125,12 +125,29 @@ export interface ICliCommandExecutorService {
  * Represents a registry for command processors
  */
 export interface ICliCommandProcessorRegistry {
+    /**
+     * The processors registered with the registry
+     */
+    readonly processors: ICliCommandProcessor[];
     /**
      * Find a processor for a command
      * @param mainCommand
      * @param chainCommands
      */
     findProcessor(mainCommand: string, chainCommands: string[]): ICliCommandProcessor | undefined;
+    /**
+     * Recursively searches for a processor matching the given command.
+     * @param mainCommand The main command name.
+     * @param chainCommands The remaining chain commands (if any).
+     * @param processors The list of available processors.
+     * @returns The matching processor or undefined if not found.
+     */
+    findProcessorInCollection(mainCommand: string, chainCommands: string[], processors: ICliCommandProcessor[]): ICliCommandProcessor | undefined;
+    /**
+     * Get the root processor for a child processor
+     * @param child The child processor
+     */
+    getRootProcessor(child: ICliCommandChildProcessor): ICliCommandProcessor;
     /**
      * Register a processor
      * @param processor
@@ -185,66 +202,71 @@ export interface ICliExecutionProcess {
     output(data: any): void;
 }
 /**
- * Represents a data store for storing data associated with commands
+ * Represents a key-value store for the CLI
  */
-export interface ICliCommandDataStore {
+export interface ICliKeyValueStore {
     /**
-     * The data store
+     * Retrieves a value by key.
+     * @param key - The key to retrieve the value for.
+     * @returns A promise resolving to the value or undefined if not found.
      */
-    data: Record<string, Record<string, any>>;
+    get<T = any>(key: string): Promise<T | undefined>;
     /**
-     * Append data to the data store
-     * @param command
-     * @param key
-     * @param data
+     * Sets a key-value pair in the store.
+     * @param key - The key to set.
+     * @param value - The value to store.
+     * @returns A promise resolving when the value is stored.
      */
-    appendData(command: string, key: string, data: any): void;
+    set(key: string, value: any): Promise<void>;
     /**
-     * Get data from the data store
-     * @param command
-     * @param key
+     * Removes a key-value pair by key.
+     * @param key - The key to remove.
+     * @returns A promise resolving when the key is removed.
      */
-    getData<T = any>(command: string, key: string): T;
+    remove(key: string): Promise<void>;
+    /**
+     * Clears all key-value pairs from the store.
+     * @returns A promise resolving when the store is cleared.
+     */
+    clear(): Promise<void>;
 }
 /**
- * Represents a service that manages user sessions in the CLI
+ * Represents a store for storing data associated with commands
  */
-export interface ICliUserSessionService {
+export interface ICliStateStore {
     /**
-     * Gets the current user session
-     * @returns An observable that emits the current user session
+     * Get the current state as an object.
      */
-    getUserSession(): Observable<ICliUserSession | undefined>;
+    getState<T extends CliState = CliState>(): T;
     /**
-     * Sets the current user session
-     * @param session The session to set
+     * Update the state with new values. Supports partial updates.
+     * @param newState Partial state to merge with the current state.
      */
-    setUserSession(session: ICliUserSession): Promise<void>;
-}
-/**
- * Represents a service that manages users in the CLI
- */
-export interface ICliUsersStoreService {
+    updateState(newState: Partial<CliState>): void;
+    /**
+     * Select a specific property or computed value from the state.
+     * @param selector A function to project a slice of the state.
+     * @returns Observable of the selected value.
+     */
+    select<K>(selector: (state: CliState) => K): Observable<K>;
+    /**
+     * Subscribe to state changes.
+     * @param callback Callback function to handle state changes.
+     * @returns Subscription object to manage the subscription.
+     */
+    subscribe(callback: (state: CliState) => void): Subscription;
     /**
-     * Gets the current users
-     * @returns An observable that emits the current users
+     * Reset the state to its initial value.
      */
-    getUsers(options?: {
-        query?: string;
-        skip?: number;
-        take?: number;
-    }): Observable<ICliUser[]>;
+    reset(): void;
     /**
-     * Creates a user
-     * @param user The user to create
+     * Persist the state to storage.
      */
-    createUser(user: Omit<ICliUser, 'id'>): Promise<ICliUser>;
+    persist(): Promise<void>;
     /**
-     * Gets a user by id
-     * @param id The id of the user to get
-     * @returns An observable that emits the user with the specified id
+     * Initialize the state from storage.
      */
-    getUser(id: string): Observable<ICliUser | undefined>;
+    initialize(): Promise<void>;
 }
 /**
  * Represents a service that pings the server
@@ -306,9 +328,9 @@ export interface ICliLogger {
     debug(...args: any[]): void;
 }
 /**
- * Represents a services for the CLI context
+ * Represents a service provider for the CLI
  */
-export interface ICliContextServices {
+export interface ICliServiceProvider {
     /**
      * Get a service
      * @param service The service to get
@@ -323,3 +345,5 @@ export interface ICliContextServices {
 export * from './execution-context';
 export * from './command-processor';
 export * from './progress-bars';
+export * from './command-hooks';
+export * from './users';

package/lib/interfaces/progress-bars.d.ts

@@ -6,7 +6,7 @@ export interface ICliProgressBar {
     /**
      * Show the progress bar
      */
-    show: () => void;
+    show: (text?: string) => void;
     /**
      * Hide the progress bar
      */
@@ -50,3 +50,23 @@ export interface ICliPercentageProgressBar extends ICliProgressBar {
      */
     setText: (text: string) => void;
 }
+export type CliTextAnimatorOptions = {
+    /**
+     * The speed of the animation
+     * @default 100
+     */
+    speed?: number;
+    /**
+     * The text will be removed after typing
+     */
+    removeAfterTyping?: boolean;
+};
+export interface ICliTextAnimator extends ICliProgressBar {
+    /**
+     * Show animated text in a typing and erasing effect.
+     * @param text
+     * @param options
+     * @returns
+     */
+    showText: (text: string, options?: CliTextAnimatorOptions) => void;
+}

package/lib/interfaces/users.d.ts

@@ -0,0 +1,42 @@
+import { ICliUserSession, ICliUser, CliAddUser } from '../models';
+import { Observable } from 'rxjs';
+/**
+ * Represents a service that manages user sessions in the CLI
+ */
+export interface ICliUserSessionService {
+    /**
+     * Gets the current user session
+     * @returns An observable that emits the current user session
+     */
+    getUserSession(): Observable<ICliUserSession | undefined>;
+    /**
+     * Sets the current user session
+     * @param session The session to set
+     */
+    setUserSession(session: ICliUserSession): Promise<void>;
+}
+/**
+ * Represents a service that manages users in the CLI
+ */
+export interface ICliUsersStoreService {
+    /**
+     * Gets the current users
+     * @returns An observable that emits the current users
+     */
+    getUsers(options?: {
+        query?: string;
+        skip?: number;
+        take?: number;
+    }): Observable<ICliUser[]>;
+    /**
+     * Creates a user
+     * @param user The user to create
+     */
+    createUser(user: CliAddUser): Promise<ICliUser>;
+    /**
+     * Gets a user by id
+     * @param id The id of the user to get
+     * @returns An observable that emits the user with the specified id
+     */
+    getUser(id: string): Observable<ICliUser | undefined>;
+}

package/lib/models/index.d.ts

@@ -162,35 +162,6 @@ export declare enum CliIcon {
     Balloon = "\uD83C\uDF88",
     Gift = "\uD83C\uDF81"
 }
-export type ICliUser = {
-    /**
-     * The id of the user
-     */
-    id: string;
-    /**
-     * The name of the user
-     */
-    name: string;
-    /**
-     * The email of the user
-     */
-    email: string;
-    /**
-     * The groups the user belongs to
-     * @default []
-     */
-    groups?: string[];
-};
-export interface ICliUserSession {
-    /**
-     * The user associated with the session
-     */
-    user: ICliUser;
-    /**
-     * The data associated with the user session
-     */
-    data?: Record<string, any>;
-}
 /**
  * Options for the CLI
  */
@@ -286,6 +257,20 @@ export type CliProcessorMetadata = Record<string, any> & {
      */
     icon?: CliIcon | string;
 };
+/**
+ * Represents a state configuration for the CLI processor
+ */
+export type CliStateConfiguration = {
+    /**
+     * The initial state for the processor
+     */
+    initialState: Record<string, any>;
+    /**
+     * The store identifier for the processor, if any
+     * @remarks If the store identifier is not set, the processor command name is used
+     */
+    storeName?: string;
+};
 /**
  * Represents a log level for the CLI
  */
@@ -297,6 +282,7 @@ export declare enum CliLogLevel {
     WARN = 4,
     ERROR = 5
 }
+export type CliState = Record<string, any>;
 export declare const enums: {
     CliForegroundColor: typeof CliForegroundColor;
     CliBackgroundColor: typeof CliBackgroundColor;
@@ -304,3 +290,4 @@ export declare const enums: {
     CliLogLevel: typeof CliLogLevel;
 };
 export * from './services';
+export * from './users';

package/lib/models/users.d.ts

@@ -0,0 +1,30 @@
+export type ICliUser = {
+    /**
+     * The id of the user
+     */
+    id: string;
+    /**
+     * The name of the user
+     */
+    name: string;
+    /**
+     * The email of the user
+     */
+    email: string;
+    /**
+     * The groups the user belongs to
+     * @default []
+     */
+    groups?: string[];
+};
+export interface ICliUserSession {
+    /**
+     * The user associated with the session
+     */
+    user: ICliUser;
+    /**
+     * The data associated with the user session
+     */
+    data?: Record<string, any>;
+}
+export type CliAddUser = Omit<ICliUser, 'id'>;

package/lib/themes/index.d.ts

@@ -0,0 +1,16 @@
+import { ITheme } from '@xterm/xterm';
+export type CliTheme = ITheme;
+export declare const DefaultThemes: {
+    default: CliTheme;
+    dracula: CliTheme;
+    monokai: CliTheme;
+    solarizedDark: CliTheme;
+    solarizedLight: CliTheme;
+    gruvboxDark: CliTheme;
+    gruvboxLight: CliTheme;
+    nord: CliTheme;
+    oneDark: CliTheme;
+    material: CliTheme;
+    yellow: CliTheme;
+    [key: string]: CliTheme;
+};

package/lib/types/CancellablePromise.d.ts

@@ -3,6 +3,6 @@ export declare class CancellablePromise<T> {
     private hasCancelled;
     private abortController;
     constructor(executor: (resolve: (value: T) => void, reject: (reason?: any) => void) => void);
-    promise: Promise<T>;
+    execute(): Promise<T>;
     cancel(): void;
 }

package/lib/version.d.ts

@@ -0,0 +1 @@
+export declare const LIBRARY_VERSION = "0.0.13";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qodalis/cli-core",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "Core Angular CLI for @qodalis extensions.",
   "author": "Nicolae Lupei, Qodalis Solutions",
   "license": "MIT",

package/public-api.d.ts

@@ -4,3 +4,5 @@ export * from './lib/modules';
 export * from './lib/utils';
 export * from './lib/constants';
 export * from './lib/types';
+export * from './lib/themes';
+export * from './lib/version';