@plyaz/types 1.27.10 → 1.27.12

package/dist/auth/types.d.ts

@@ -1050,3 +1050,118 @@ export interface PermissionCheckerConfig {
     /** Enable audit logging */
     enableAuditLog: boolean;
 }
+/**
+ * @fileoverview Session store interface for @plyaz/auth
+ * @module @plyaz/auth/session/session-store
+ *
+ * @description
+ * Defines the interface for session storage implementations.
+ * Provides abstraction over different storage backends (cookie, memory, Redis)
+ * enabling flexible session management strategies. All session stores must
+ * implement this interface for consistent behavior across the auth system.
+ *
+ * @example
+ * ```typescript
+ * import { SessionStore, CookieStore } from '@plyaz/auth';
+ *
+ * const store: SessionStore = new CookieStore();
+ * await store.set('session_123', sessionData, 3600);
+ * const session = await store.get('session_123');
+ * ```
+ */
+/**
+ * Session data interface for storage
+ * Contains session information and metadata
+ */
+export interface SessionData {
+    /** Session ID */
+    id: string;
+    /** User ID */
+    userId: string;
+    /** Session expiration timestamp */
+    expiresAt: Date;
+    /** Session creation timestamp */
+    createdAt: Date;
+    /** Last activity timestamp */
+    lastActivityAt: Date;
+    /** IP address */
+    ipAddress?: string;
+    /** User agent string */
+    userAgent?: string;
+    /** Additional session metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Session store interface
+ * Defines contract for session storage implementations
+ */
+export interface SessionStore {
+    /**
+     * Store session data
+     * @param sessionId - Unique session identifier
+     * @param data - Session data to store
+     * @param ttlSeconds - Time to live in seconds
+     * @returns Promise that resolves when session is stored
+     */
+    set(sessionId: string, data: SessionData, ttlSeconds: number): Promise<void>;
+    /**
+     * Retrieve session data
+     * @param sessionId - Session identifier
+     * @returns Promise that resolves to session data or null if not found
+     */
+    get(sessionId: string): Promise<SessionData | null>;
+    /**
+     * Delete session data
+     * @param sessionId - Session identifier
+     * @returns Promise that resolves when session is deleted
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * Delete all sessions for a user
+     * @param userId - User identifier
+     * @returns Promise that resolves to number of deleted sessions
+     */
+    deleteByUserId(userId: string): Promise<number>;
+    /**
+     * Update session activity timestamp
+     * @param sessionId - Session identifier
+     * @returns Promise that resolves when activity is updated
+     */
+    updateActivity(sessionId: string): Promise<void>;
+    /**
+     * Check if session exists
+     * @param sessionId - Session identifier
+     * @returns Promise that resolves to true if session exists
+     */
+    exists(sessionId: string): Promise<boolean>;
+    /**
+     * Get all active sessions for a user
+     * @param userId - User identifier
+     * @returns Promise that resolves to array of session data
+     */
+    getByUserId(userId: string): Promise<SessionData[]>;
+    /**
+     * Clean up expired sessions
+     * @returns Promise that resolves to number of cleaned sessions
+     */
+    cleanup(): Promise<number>;
+    /**
+     * Get session count for a user
+     * @param userId - User identifier
+     * @returns Promise that resolves to session count
+     */
+    getSessionCount(userId: string): Promise<number>;
+}
+/**
+ * Session store configuration interface
+ */
+export interface SessionStoreConfig {
+    /** Default TTL in seconds */
+    defaultTTL: number;
+    /** Maximum sessions per user */
+    maxSessionsPerUser: number;
+    /** Cleanup interval in seconds */
+    cleanupInterval: number;
+    /** Key prefix for storage */
+    keyPrefix: string;
+}

package/dist/core/services/types.d.ts

@@ -512,3 +512,60 @@ export interface CoreDbServiceConfig {
      */
     encryption?: DBEncryptionConfig;
 }
+/**
+ * Core's DbService instance interface
+ * Returned by Core.db and DbService.getInstance()
+ */
+export interface CoreDbServiceInstance {
+    /** Get the underlying database instance */
+    getDatabase(): CoreDatabaseInstance | undefined;
+    /** Execute a raw SQL query */
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
+    /** Begin a transaction */
+    transaction<T>(fn: (tx: unknown) => Promise<T>): Promise<T>;
+}
+/** Core's database instance interface (from @plyaz/db) */
+export interface CoreDatabaseInstance {
+    /** Close the database connection */
+    close?(): Promise<unknown>;
+}
+/**
+ * Core's CacheService instance interface
+ * Returned by Core.cache and CacheService.getInstance()
+ */
+export interface CoreCacheServiceInstance {
+    /** Get the cache manager instance */
+    getCacheManager(): CoreCacheManagerInstance;
+}
+/**
+ * Core's CacheManager instance interface
+ * The actual cache operations interface
+ */
+export interface CoreCacheManagerInstance {
+    /** Get a value from cache */
+    get<T>(key: string): Promise<T | null>;
+    /** Set a value in cache with optional TTL */
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    /** Delete a value from cache */
+    delete(key: string): Promise<void>;
+    /** Clear all cached values */
+    clear(): Promise<void>;
+    /** Check if key exists in cache */
+    has(key: string): Promise<boolean>;
+}
+/**
+ * Core's StorageService instance interface
+ * Returned by Core.storage and StorageService.getInstance()
+ */
+export interface CoreStorageServiceInstance {
+    /** Close/cleanup the storage service */
+    close(): Promise<void>;
+}
+/**
+ * Core's NotificationService instance interface
+ * Returned by Core.notifications - wraps the actual @plyaz/notifications service
+ */
+export interface CoreNotificationServiceInstance {
+    /** Close/cleanup the notification service */
+    close(): Promise<void>;
+}