crewly 1.0.0

package/dist/backend/backend/src/services/session/session-backend.factory.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Session Backend Factory Module
+ *
+ * Provides factory functions for creating and accessing session backend instances.
+ * Uses a singleton pattern to ensure only one backend instance is active at a time.
+ *
+ * @module session-backend.factory
+ */
+import { ISessionBackend, SessionBackendType } from './session-backend.interface.js';
+/**
+ * Create a new session backend instance.
+ *
+ * This function creates a new backend instance based on the specified type.
+ * If a backend already exists and is of a different type, the existing
+ * backend will be destroyed before creating the new one.
+ *
+ * @param type - Type of backend to create. Defaults to 'pty'.
+ * @returns The created session backend instance
+ * @throws Error if the backend type is not supported or creation fails
+ *
+ * @example
+ * ```typescript
+ * // Create a PTY backend (default)
+ * const backend = await createSessionBackend();
+ *
+ * // Create a specific backend type
+ * const ptyBackend = await createSessionBackend('pty');
+ * ```
+ */
+export declare function createSessionBackend(type?: SessionBackendType): Promise<ISessionBackend>;
+/**
+ * Get the singleton session backend instance.
+ *
+ * Returns the currently active session backend instance, or creates a new
+ * PTY backend if none exists.
+ *
+ * @returns The session backend instance
+ * @throws Error if no backend exists and creation fails
+ *
+ * @example
+ * ```typescript
+ * const backend = await getSessionBackend();
+ * const session = await backend.createSession('my-session', options);
+ * ```
+ */
+export declare function getSessionBackend(): Promise<ISessionBackend>;
+/**
+ * Get the singleton session backend instance synchronously.
+ *
+ * Returns the currently active session backend instance, or null if none exists.
+ * This is useful for checking if a backend has been initialized without
+ * triggering creation.
+ *
+ * @returns The session backend instance if it exists, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const backend = getSessionBackendSync();
+ * if (backend) {
+ *   console.log('Backend is initialized');
+ * } else {
+ *   console.log('No backend initialized yet');
+ * }
+ * ```
+ */
+export declare function getSessionBackendSync(): ISessionBackend | null;
+/**
+ * Get the type of the currently active backend.
+ *
+ * @returns The backend type if one is active, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const type = getSessionBackendType();
+ * console.log('Current backend type:', type ?? 'none');
+ * ```
+ */
+export declare function getSessionBackendType(): SessionBackendType | null;
+/**
+ * Destroy the current session backend and release resources.
+ *
+ * This function destroys the singleton backend instance, killing all
+ * active sessions and releasing any held resources.
+ *
+ * @returns Promise that resolves when destruction is complete
+ *
+ * @example
+ * ```typescript
+ * await destroySessionBackend();
+ * console.log('Backend destroyed');
+ * ```
+ */
+export declare function destroySessionBackend(): Promise<void>;
+/**
+ * Check if a session backend is currently initialized.
+ *
+ * @returns true if a backend exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (isSessionBackendInitialized()) {
+ *   console.log('Backend is ready');
+ * }
+ * ```
+ */
+export declare function isSessionBackendInitialized(): boolean;
+/**
+ * Reset the factory state (for testing purposes).
+ *
+ * This function resets the internal factory state without destroying
+ * the backend. Use with caution - this is primarily for testing.
+ *
+ * @internal
+ */
+export declare function resetSessionBackendFactory(): void;
+/**
+ * Set the session backend instance (for testing purposes).
+ *
+ * This function allows injecting a mock backend for testing.
+ * Use with caution - this is primarily for testing.
+ *
+ * @param backend - The backend instance to set
+ * @param type - The type of the backend
+ * @internal
+ */
+export declare function setSessionBackendForTesting(backend: ISessionBackend | null, type: SessionBackendType | null): void;
+//# sourceMappingURL=session-backend.factory.d.ts.map

package/dist/backend/backend/src/services/session/session-backend.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-backend.factory.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/session/session-backend.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACN,eAAe,EACf,kBAAkB,EAClB,MAAM,gCAAgC,CAAC;AA2BxC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,oBAAoB,CACzC,IAAI,GAAE,kBAA0B,GAC9B,OAAO,CAAC,eAAe,CAAC,CAwD1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,eAAe,CAAC,CAKlE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,GAAG,IAAI,CAE9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAEjE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAY3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAErD;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,eAAe,GAAG,IAAI,EAC/B,IAAI,EAAE,kBAAkB,GAAG,IAAI,GAC7B,IAAI,CAGN"}

package/dist/backend/backend/src/services/session/session-backend.factory.js

@@ -0,0 +1,226 @@
+/**
+ * Session Backend Factory Module
+ *
+ * Provides factory functions for creating and accessing session backend instances.
+ * Uses a singleton pattern to ensure only one backend instance is active at a time.
+ *
+ * @module session-backend.factory
+ */
+import { LoggerService } from '../core/logger.service.js';
+import { PtySessionBackend } from './pty/index.js';
+/**
+ * Singleton instance of the session backend
+ */
+let sessionBackendInstance = null;
+/**
+ * Type of the currently active backend
+ */
+let currentBackendType = null;
+/**
+ * Promise-based mutex to prevent race conditions during async initialization.
+ * If a creation is in progress, subsequent calls wait for it to complete.
+ */
+let creationPromise = null;
+/**
+ * Logger for factory operations
+ */
+const getLogger = () => {
+    return LoggerService.getInstance().createComponentLogger('SessionBackendFactory');
+};
+/**
+ * Create a new session backend instance.
+ *
+ * This function creates a new backend instance based on the specified type.
+ * If a backend already exists and is of a different type, the existing
+ * backend will be destroyed before creating the new one.
+ *
+ * @param type - Type of backend to create. Defaults to 'pty'.
+ * @returns The created session backend instance
+ * @throws Error if the backend type is not supported or creation fails
+ *
+ * @example
+ * ```typescript
+ * // Create a PTY backend (default)
+ * const backend = await createSessionBackend();
+ *
+ * // Create a specific backend type
+ * const ptyBackend = await createSessionBackend('pty');
+ * ```
+ */
+export async function createSessionBackend(type = 'pty') {
+    const logger = getLogger();
+    // Return existing instance if it matches the requested type
+    if (sessionBackendInstance && currentBackendType === type) {
+        logger.debug('Returning existing session backend instance', { type });
+        return sessionBackendInstance;
+    }
+    // If a creation is already in progress, wait for it
+    if (creationPromise) {
+        logger.debug('Waiting for in-progress backend creation', { type });
+        return creationPromise;
+    }
+    // Create the backend with mutex protection
+    creationPromise = (async () => {
+        try {
+            // Double-check after acquiring the "lock"
+            if (sessionBackendInstance && currentBackendType === type) {
+                return sessionBackendInstance;
+            }
+            // If we have an existing instance of a different type, destroy it first
+            if (sessionBackendInstance && currentBackendType !== type) {
+                logger.info('Destroying existing backend to switch types', {
+                    oldType: currentBackendType,
+                    newType: type,
+                });
+                await sessionBackendInstance.destroy();
+                sessionBackendInstance = null;
+                currentBackendType = null;
+            }
+            logger.info('Creating new session backend', { type });
+            switch (type) {
+                case 'pty': {
+                    sessionBackendInstance = new PtySessionBackend();
+                    currentBackendType = 'pty';
+                    logger.info('PTY session backend created');
+                    return sessionBackendInstance;
+                }
+                default: {
+                    const exhaustiveCheck = type;
+                    throw new Error(`Unsupported session backend type: ${exhaustiveCheck}`);
+                }
+            }
+        }
+        finally {
+            // Clear the promise after completion (success or failure)
+            creationPromise = null;
+        }
+    })();
+    return creationPromise;
+}
+/**
+ * Get the singleton session backend instance.
+ *
+ * Returns the currently active session backend instance, or creates a new
+ * PTY backend if none exists.
+ *
+ * @returns The session backend instance
+ * @throws Error if no backend exists and creation fails
+ *
+ * @example
+ * ```typescript
+ * const backend = await getSessionBackend();
+ * const session = await backend.createSession('my-session', options);
+ * ```
+ */
+export async function getSessionBackend() {
+    if (!sessionBackendInstance) {
+        return await createSessionBackend('pty');
+    }
+    return sessionBackendInstance;
+}
+/**
+ * Get the singleton session backend instance synchronously.
+ *
+ * Returns the currently active session backend instance, or null if none exists.
+ * This is useful for checking if a backend has been initialized without
+ * triggering creation.
+ *
+ * @returns The session backend instance if it exists, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const backend = getSessionBackendSync();
+ * if (backend) {
+ *   console.log('Backend is initialized');
+ * } else {
+ *   console.log('No backend initialized yet');
+ * }
+ * ```
+ */
+export function getSessionBackendSync() {
+    return sessionBackendInstance;
+}
+/**
+ * Get the type of the currently active backend.
+ *
+ * @returns The backend type if one is active, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const type = getSessionBackendType();
+ * console.log('Current backend type:', type ?? 'none');
+ * ```
+ */
+export function getSessionBackendType() {
+    return currentBackendType;
+}
+/**
+ * Destroy the current session backend and release resources.
+ *
+ * This function destroys the singleton backend instance, killing all
+ * active sessions and releasing any held resources.
+ *
+ * @returns Promise that resolves when destruction is complete
+ *
+ * @example
+ * ```typescript
+ * await destroySessionBackend();
+ * console.log('Backend destroyed');
+ * ```
+ */
+export async function destroySessionBackend() {
+    const logger = getLogger();
+    if (sessionBackendInstance) {
+        logger.info('Destroying session backend', { type: currentBackendType });
+        await sessionBackendInstance.destroy();
+        sessionBackendInstance = null;
+        currentBackendType = null;
+        logger.info('Session backend destroyed');
+    }
+    else {
+        logger.debug('No session backend to destroy');
+    }
+}
+/**
+ * Check if a session backend is currently initialized.
+ *
+ * @returns true if a backend exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (isSessionBackendInitialized()) {
+ *   console.log('Backend is ready');
+ * }
+ * ```
+ */
+export function isSessionBackendInitialized() {
+    return sessionBackendInstance !== null;
+}
+/**
+ * Reset the factory state (for testing purposes).
+ *
+ * This function resets the internal factory state without destroying
+ * the backend. Use with caution - this is primarily for testing.
+ *
+ * @internal
+ */
+export function resetSessionBackendFactory() {
+    sessionBackendInstance = null;
+    currentBackendType = null;
+    creationPromise = null;
+}
+/**
+ * Set the session backend instance (for testing purposes).
+ *
+ * This function allows injecting a mock backend for testing.
+ * Use with caution - this is primarily for testing.
+ *
+ * @param backend - The backend instance to set
+ * @param type - The type of the backend
+ * @internal
+ */
+export function setSessionBackendForTesting(backend, type) {
+    sessionBackendInstance = backend;
+    currentBackendType = type;
+}
+//# sourceMappingURL=session-backend.factory.js.map

package/dist/backend/backend/src/services/session/session-backend.factory.js.map

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