@cyberskill/shared 3.12.0 → 3.13.0

package/dist/config/graphql-codegen/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './graphql-codegen.type.js';
+export * from './graphql-codegen.util.js';

package/dist/config/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './config.type.js';
+export * from './config.util.js';

package/dist/config/lint-staged/index.d.ts

@@ -1 +1,5 @@
-export {}
+declare const _default: {
+    '*.ts': () => string;
+    '*': string[];
+};
+export default _default;

package/dist/config/storybook/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './storybook.main.js';
+export * from './storybook.preview.js';

package/dist/config/vitest/index.d.ts

@@ -1 +1,3 @@
-export {}
+export * from './vitest.e2e.js';
+export * from './vitest.unit.js';
+export * from './vitest.unit.setup.js';

package/dist/config/vitest/vitest.e2e.d.ts

@@ -1 +1,20 @@
-export {}
+import { UserConfig } from 'vite';
+/**
+ * Creates a Vitest configuration for end-to-end testing with browser automation.
+ * This function generates a Vitest configuration specifically designed for E2E testing
+ * using Playwright with multiple browser instances. It includes React support and
+ * browser automation capabilities for comprehensive end-to-end testing.
+ *
+ * The configuration includes:
+ * - React SWC plugin for fast React compilation
+ * - Browser automation with Playwright provider
+ * - Multiple browser instances (Chromium, Firefox, WebKit)
+ * - E2E test file pattern matching
+ * - Configurable options merging
+ *
+ * @param options - Additional Vite configuration options to merge with the E2E config.
+ * @returns A Vitest configuration object optimized for end-to-end testing with browser automation.
+ */
+export declare function vitestE2E(options: UserConfig): UserConfig;
+declare const _default: UserConfig;
+export default _default;

package/dist/config/vitest/vitest.unit.d.ts

@@ -1 +1,22 @@
-export {}
+import { UserConfig } from 'vite';
+/**
+ * Creates a Vitest configuration for unit testing with React support.
+ * This function generates a Vitest configuration specifically designed for unit testing
+ * React components and JavaScript/TypeScript modules. It includes JSDOM environment
+ * for DOM simulation and comprehensive testing setup.
+ *
+ * The configuration includes:
+ * - React SWC plugin for fast React compilation
+ * - JSDOM environment for DOM simulation
+ * - Global test functions availability
+ * - VM threads pool for parallel test execution
+ * - Unit test file pattern matching
+ * - Setup files for testing library configuration
+ * - Configurable options merging
+ *
+ * @param options - Additional Vite configuration options to merge with the unit test config.
+ * @returns A Vitest configuration object optimized for unit testing with React and DOM support.
+ */
+export declare function vitestUnit(options: UserConfig): UserConfig;
+declare const _default: UserConfig;
+export default _default;

package/dist/constant/index.d.ts

@@ -1 +1,5 @@
-export {}
+/**
+ * Re-exports all common constants for shared usage across the codebase.
+ */
+export * from './common.js';
+export * from './response-status.js';

package/dist/node/apollo-server/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './apollo-server.type.js';
+export * from './apollo-server.util.js';

package/dist/node/cli/index.d.ts

@@ -1 +1,2 @@
-export {}
+#!/usr/bin/env node
+export {};

package/dist/node/command/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './command.type.js';
+export * from './command.util.js';

package/dist/node/express/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './express.type.js';
+export * from './express.util.js';

package/dist/node/fs/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './fs.type.js';
+export * from './fs.util.js';

package/dist/node/log/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './log.type.js';
+export * from './log.util.js';

package/dist/{src/node → node}/log/log.type.d.ts

@@ -1,5 +1,5 @@
-import { I_Log as I_LogCommon } from '../../../typescript/index.js';
-export type { I_CatchErrorOptions } from '../../../util/log/index.js';
+import { I_Log as I_LogCommon } from '../../typescript/index.js';
+export type { I_CatchErrorOptions } from '../../util/log/index.js';
 /**
  * Enum representing the type of issues for logging and error handling.
  * - Error: Represents an error issue.

package/dist/{src/node → node}/log/log.util.d.ts

@@ -1,4 +1,4 @@
-import { I_Return } from '../../../typescript/index.js';
+import { I_Return } from '../../typescript/index.js';
 import { I_CatchErrorOptions, I_Log, I_ThrowError } from './log.type.js';
 /**
  * Throws a standardized error with optional status information and type specification.

package/dist/node/mongo/index.d.ts

@@ -1 +1,6 @@
-export {}
+export * from './mongo.constant.js';
+export * from './mongo.controller.js';
+export * from './mongo.dynamic-populate.js';
+export * from './mongo.populate.js';
+export * from './mongo.type.js';
+export * from './mongo.util.js';

package/dist/{src/node → node}/mongo/mongo.controller.helpers.d.ts

@@ -1,4 +1,4 @@
-import { I_Return } from '../../../typescript/index.js';
+import { I_Return } from '../../typescript/index.js';
 /**
  * Shared helper functions for MongoDB controllers.
  *

package/dist/{src/node → node}/mongo/mongo.controller.mongoose.d.ts

@@ -1,4 +1,4 @@
-import { I_Return } from '../../../typescript/index.js';
+import { I_Return } from '../../typescript/index.js';
 import { C_Document, I_DeleteOptionsExtended, I_ExtendedModel, I_Input_CheckSlug, I_Input_CreateSlug, I_Input_GenerateSlug, I_PaginateOptionsWithPopulate, I_UpdateOptionsExtended, T_AggregatePaginateResult, T_DeleteResult, T_Input_Populate, T_InsertManyOptions, T_PaginateResult, T_PipelineStage, T_ProjectionType, T_QueryFilter, T_QueryOptions, T_UpdateQuery, T_UpdateResult } from './mongo.type.js';
 /**
  * Mongoose controller for database operations with advanced features.

package/dist/{src/node → node}/mongo/mongo.controller.native.d.ts

@@ -1,4 +1,4 @@
-import { I_Return } from '../../../typescript/index.js';
+import { I_Return } from '../../typescript/index.js';
 import { C_Db, C_Document, T_DeleteResult, T_Filter, T_UpdateResult, T_WithId } from './mongo.type.js';
 /**
  * MongoDB native driver controller for direct database operations.

package/dist/{src/node → node}/mongo/mongo.controller.type.d.ts

@@ -1,4 +1,4 @@
-import { I_Return } from '../../../typescript/index.js';
+import { I_Return } from '../../typescript/index.js';
 import { T_DeleteResult, T_UpdateResult, T_WithId } from './mongo.type.js';
 /**
  * Shared controller interface for MongoDB operations.

package/dist/node/package/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './package.type.js';
+export * from './package.util.js';

package/dist/{src/node → node}/package/package.util.d.ts

@@ -1,4 +1,4 @@
-import { I_Return } from '../../../typescript/index.js';
+import { I_Return } from '../../typescript/index.js';
 import { I_PackageInfo, I_PackageInput } from './package.type.js';
 /**
  * Fetches the latest version of a package from the npm registry.

package/dist/node/path/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './path.constant.js';
+export * from './path.util.js';

package/dist/node/storage/index.d.ts

@@ -1 +1,3 @@
-export {}
+export * from './storage.constant.js';
+export * from './storage.type.js';
+export * from './storage.util.js';

package/dist/node/upload/index.d.ts

@@ -1 +1,3 @@
-export {}
+export * from './upload.constant.js';
+export * from './upload.type.js';
+export * from './upload.util.js';

package/dist/{src/node → node}/upload/upload.util.d.ts

@@ -1,5 +1,5 @@
 import { ReadableStream } from 'node:stream/web';
-import { I_Return } from '../../../typescript/index.js';
+import { I_Return } from '../../typescript/index.js';
 import { I_UploadConfig, I_UploadFile, I_UploadFileData, I_UploadOptions, I_UploadValidationConfig, E_UploadType } from './upload.type.js';
 /**
  * Calculates the size of a file from a readable stream.

package/dist/node/upload/upload.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload.util.js","names":[],"sources":["../../../src/node/upload/upload.util.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\nimport nodePath from 'node:path';\nimport { Transform } from 'node:stream';\nimport { ReadableStream } from 'node:stream/web';\n\nimport type { I_Return } from '#typescript/index.js';\n\nimport { RESPONSE_STATUS } from '#constant/index.js';\n\nimport type { I_UploadConfig, I_UploadFile, I_UploadFileData, I_UploadOptions, I_UploadTypeConfig, I_UploadValidationConfig } from './upload.type.js';\n\nimport { createWriteStream, mkdirSync, pathExistsSync } from '../fs/index.js';\nimport { dirname } from '../path/index.js';\nimport { BYTES_PER_MB, DEFAULT_UPLOAD_CONFIG } from './upload.constant.js';\nimport { E_UploadType } from './upload.type.js';\n\n/**\n * Calculates the size of a file from a readable stream.\n * This function reads through the entire stream to determine the total byte size\n * by accumulating the length of each data chunk.\n *\n * @param stream - The readable stream to calculate the size for.\n * @returns A promise that resolves to the total size of the stream in bytes.\n */\nexport async function getFileSizeFromStream(stream: NodeJS.ReadableStream): Promise<number> {\n    return new Promise((resolve, reject) => {\n        let size = 0;\n        stream.on('data', (chunk) => {\n            size += chunk.length;\n        });\n        stream.on('end', () => resolve(size));\n        stream.on('error', reject);\n    });\n}\n\n/**\n * Extracts and validates file data from an upload file.\n * This function processes upload files by:\n * - Extracting file metadata and creating a readable stream\n * - Calculating the file size from the stream\n * - Validating file size and extension against upload configuration\n * - Returning a standardized response with success status and error codes\n * - Providing validated file data for further processing\n *\n * @param type - The type of upload being processed (IMAGE, VIDEO, DOCUMENT, OTHER).\n * @param file - The upload file object containing file metadata and stream creation method.\n * @param config - Optional upload configuration. If not provided, uses default configuration.\n * @returns A promise that resolves to a standardized response containing validated file data or error information.\n */\nexport async function getAndValidateFile(type: E_UploadType, file: I_UploadFile, config?: I_UploadConfig): Promise<I_Return<I_UploadFileData>> {\n    const fileData = await (await file).file;\n    const stream = fileData.createReadStream();\n    // Stream is consumed here for validation; callers use createReadStream() again for the actual write.\n    // This is intentional — createReadStream() is a factory that yields a new stream per call.\n    const fileSize = await getFileSizeFromStream(stream);\n    const uploadConfig = config ?? createUploadConfig();\n\n    const validationResult = validateUpload(\n        { filename: fileData.filename, fileSize },\n        uploadConfig,\n        type,\n    );\n\n    if (!validationResult.isValid) {\n        return {\n            success: false,\n            message: validationResult.error || 'File validation failed',\n            code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n        };\n    }\n\n    return {\n        success: true,\n        result: fileData,\n        message: 'File validated successfully',\n    };\n}\n\n/**\n * Creates a validated web-readable stream from an upload file with size validation.\n * This function processes file uploads for web environments by:\n * - Validating file data using getAndValidateFile function\n * - Creating a size validation transform stream to monitor upload progress\n * - Returning a web-compatible ReadableStream with real-time validation\n * - Providing standardized error responses for validation failures\n * - Wrapping the stream in a standardized response format\n *\n * @param type - The type of upload being processed (IMAGE, VIDEO, DOCUMENT, OTHER).\n * @param file - The upload file object containing file metadata and stream creation method.\n * @param config - Optional upload configuration. If not provided, uses default configuration.\n * @returns A promise that resolves to a standardized response containing either a web ReadableStream or error information.\n */\nexport async function getFileWebStream(type: E_UploadType, file: I_UploadFile, config?: I_UploadConfig): Promise<I_Return<ReadableStream<Uint8Array>>> {\n    const uploadConfig = config ?? createUploadConfig();\n    const typeConfig = uploadConfig[type];\n\n    const fileData = await getAndValidateFile(type, file, config);\n\n    if (!fileData.success) {\n        return fileData;\n    }\n\n    const { createReadStream } = fileData.result;\n\n    let remainingBytes = typeConfig.sizeLimit;\n\n    const sizeValidationStream = new Transform({\n        transform(chunk: Buffer, _enc: BufferEncoding, cb) {\n            remainingBytes -= chunk.length;\n\n            if (remainingBytes < 0) {\n                cb(new Error(`File size exceeds limit of ${typeConfig.sizeLimit / BYTES_PER_MB}MB`));\n            }\n            else {\n                cb(null, chunk);\n            }\n        },\n    });\n    const originalStream = createReadStream();\n    const validatedStream = originalStream.pipe(sizeValidationStream);\n\n    return {\n        success: true,\n        result: new ReadableStream<Uint8Array>({\n            start(controller) {\n                validatedStream.on('data', (chunk: Buffer | string) => {\n                    controller.enqueue(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);\n                });\n                validatedStream.on('end', () => controller.close());\n                validatedStream.on('error', (err: unknown) => controller.error(err));\n            },\n        }),\n    };\n}\n\n/**\n * Validates if a file has an allowed extension.\n * This function extracts the file extension from the filename and checks if it's\n * included in the list of allowed extensions (case-insensitive comparison).\n *\n * @param filename - The filename to check for valid extension.\n * @param allowedExtensions - An array of allowed file extensions (without dots).\n * @returns True if the file extension is allowed, false otherwise.\n */\nexport function validateFileExtension(filename: string, allowedExtensions: string[]): boolean {\n    const lastDotIndex = filename.lastIndexOf('.');\n\n    if (lastDotIndex === -1) {\n        return false;\n    }\n\n    const extension = filename.substring(lastDotIndex + 1).toLowerCase();\n\n    return allowedExtensions.includes(extension);\n}\n\n/**\n * Validates an upload against the specified configuration.\n * This function performs comprehensive validation including:\n * - File extension validation against allowed extensions\n * - File size validation against size limits\n * - Returns detailed error messages for validation failures\n *\n * @param config - The validation configuration including filename and optional file size.\n * @param uploadConfig - The upload configuration containing allowed extensions and size limits.\n * @param uploadType - The type of upload being validated.\n * @returns An object indicating validation success and optional error message.\n */\nexport function validateUpload(\n    config: I_UploadValidationConfig,\n    uploadConfig: I_UploadConfig,\n    uploadType: E_UploadType,\n): { isValid: boolean; error?: string } {\n    const { filename, fileSize } = config;\n    const typeConfig: I_UploadTypeConfig = uploadConfig[uploadType];\n\n    const { allowedExtensions, sizeLimit } = typeConfig;\n\n    if (!validateFileExtension(filename, allowedExtensions)) {\n        return {\n            isValid: false,\n            error: `File extension not allowed for ${uploadType.toLowerCase()} files. Allowed extensions: ${allowedExtensions.join(', ')}`,\n        };\n    }\n\n    if (fileSize !== undefined && fileSize > sizeLimit) {\n        const maxSizeMB = Math.round(sizeLimit / (1024 * 1024));\n\n        return {\n            isValid: false,\n            error: `File size exceeds limit for ${uploadType.toLowerCase()} files. Maximum size: ${maxSizeMB}MB`,\n        };\n    }\n\n    return { isValid: true };\n}\n\n/**\n * Creates a default upload configuration with predefined settings for different file types.\n * This function provides sensible defaults for image, video, document, and other file types,\n * including allowed extensions and size limits. The configuration can be customized with overrides.\n *\n * @param overrides - Optional configuration overrides to merge with the default configuration.\n * @returns A complete upload configuration object with defaults and any provided overrides.\n */\nexport function createUploadConfig(overrides?: Partial<I_UploadConfig>): I_UploadConfig {\n    return { ...DEFAULT_UPLOAD_CONFIG, ...overrides };\n}\n\n/**\n * Uploads a file with comprehensive validation and error handling.\n * This function processes file uploads with the following features:\n * - Input validation for path and file parameters\n * - Configuration validation for all upload types\n * - File validation using getAndValidateFile function\n * - Automatic directory creation\n * - Stream-based file writing\n * - Comprehensive error handling with standardized response codes\n *\n * @param options - Upload configuration including file, path, type, and optional validation config.\n * @returns A promise that resolves to a standardized response with success status, message, file path, and response codes.\n */\nexport async function upload(options: I_UploadOptions): Promise<I_Return<string>> {\n    const { path, file, config, type, baseDir } = options;\n\n    if (!path || typeof path !== 'string') {\n        return {\n            success: false,\n            message: 'Invalid path provided',\n            code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n        };\n    }\n\n    // Security: Validate path is within allowed base directory to prevent path traversal.\n    // When baseDir is provided, the resolved path must start with it.\n    // When baseDir is not provided, reject any path containing \"..\" segments.\n    const resolvedPath = nodePath.resolve(path);\n\n    if (baseDir) {\n        const resolvedBase = nodePath.resolve(baseDir) + nodePath.sep;\n        if (!resolvedPath.startsWith(resolvedBase) && resolvedPath !== nodePath.resolve(baseDir)) {\n            return {\n                success: false,\n                message: 'Path traversal detected: path resolves outside the allowed base directory',\n                code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n            };\n        }\n    }\n    else if (path.includes('..')) {\n        return {\n            success: false,\n            message: 'Path traversal detected: \"..\" segments are not allowed',\n            code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n        };\n    }\n\n    if (!file || typeof file !== 'object') {\n        return {\n            success: false,\n            message: 'Invalid file provided',\n            code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n        };\n    }\n\n    if (config) {\n        const requiredTypes = [E_UploadType.IMAGE, E_UploadType.VIDEO, E_UploadType.DOCUMENT, E_UploadType.OTHER];\n\n        for (const requiredType of requiredTypes) {\n            if (!config[requiredType] || !Array.isArray(config[requiredType].allowedExtensions) || config[requiredType].allowedExtensions.length === 0) {\n                return {\n                    success: false,\n                    message: `Invalid config for ${requiredType.toLowerCase()} files`,\n                    code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n                };\n            }\n            if (typeof config[requiredType].sizeLimit !== 'number' || config[requiredType].sizeLimit <= 0) {\n                return {\n                    success: false,\n                    message: `Invalid size limit for ${requiredType.toLowerCase()} files`,\n                    code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n                };\n            }\n        }\n    }\n\n    try {\n        const fileData = await getAndValidateFile(type, await file, config);\n\n        if (!fileData.success) {\n            return fileData;\n        }\n\n        const { createReadStream } = fileData.result;\n\n        const dir = dirname(path);\n\n        if (!pathExistsSync(dir)) {\n            mkdirSync(dir, { recursive: true });\n        }\n\n        const writeStream = createReadStream();\n        const out = createWriteStream(path);\n        writeStream.pipe(out);\n\n        await new Promise<void>((resolve, reject) => {\n            out.on('finish', () => resolve());\n            out.on('error', reject);\n            writeStream.on('error', reject);\n        });\n\n        return {\n            success: true,\n            result: path,\n            message: 'File uploaded successfully',\n            code: RESPONSE_STATUS.OK.CODE,\n        };\n    }\n    catch (error) {\n        return {\n            success: false,\n            message: error instanceof Error ? error.message : 'File upload failed',\n            code: RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE,\n        };\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"upload.util.js","names":[],"sources":["../../../src/node/upload/upload.util.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\nimport nodePath from 'node:path';\nimport { Transform } from 'node:stream';\nimport { ReadableStream } from 'node:stream/web';\n\nimport type { I_Return } from '#typescript/index.js';\n\nimport { RESPONSE_STATUS } from '#constant/index.js';\n\nimport type { I_UploadConfig, I_UploadFile, I_UploadFileData, I_UploadOptions, I_UploadTypeConfig, I_UploadValidationConfig } from './upload.type.js';\n\nimport { createWriteStream, mkdirSync, pathExistsSync } from '../fs/index.js';\nimport { dirname } from '../path/index.js';\nimport { BYTES_PER_MB, DEFAULT_UPLOAD_CONFIG } from './upload.constant.js';\nimport { E_UploadType } from './upload.type.js';\n\n/**\n * Calculates the size of a file from a readable stream.\n * This function reads through the entire stream to determine the total byte size\n * by accumulating the length of each data chunk.\n *\n * @param stream - The readable stream to calculate the size for.\n * @returns A promise that resolves to the total size of the stream in bytes.\n */\nexport async function getFileSizeFromStream(stream: NodeJS.ReadableStream): Promise<number> {\n    return new Promise((resolve, reject) => {\n        let size = 0;\n        stream.on('data', (chunk) => {\n            size += chunk.length;\n        });\n        stream.on('end', () => resolve(size));\n        stream.on('error', reject);\n    });\n}\n\n/**\n * Extracts and validates file data from an upload file.\n * This function processes upload files by:\n * - Extracting file metadata and creating a readable stream\n * - Calculating the file size from the stream\n * - Validating file size and extension against upload configuration\n * - Returning a standardized response with success status and error codes\n * - Providing validated file data for further processing\n *\n * @param type - The type of upload being processed (IMAGE, VIDEO, DOCUMENT, OTHER).\n * @param file - The upload file object containing file metadata and stream creation method.\n * @param config - Optional upload configuration. If not provided, uses default configuration.\n * @returns A promise that resolves to a standardized response containing validated file data or error information.\n */\nexport async function getAndValidateFile(type: E_UploadType, file: I_UploadFile, config?: I_UploadConfig): Promise<I_Return<I_UploadFileData>> {\n    const fileData = await (await file).file;\n    const stream = fileData.createReadStream();\n    // Stream is consumed here for validation; callers use createReadStream() again for the actual write.\n    // This is intentional — createReadStream() is a factory that yields a new stream per call.\n    const fileSize = await getFileSizeFromStream(stream);\n    const uploadConfig = config ?? createUploadConfig();\n\n    const validationResult = validateUpload(\n        { filename: fileData.filename, fileSize },\n        uploadConfig,\n        type,\n    );\n\n    if (!validationResult.isValid) {\n        return {\n            success: false,\n            message: validationResult.error || 'File validation failed',\n            code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n        };\n    }\n\n    return {\n        success: true,\n        result: fileData,\n        message: 'File validated successfully',\n    };\n}\n\n/**\n * Creates a validated web-readable stream from an upload file with size validation.\n * This function processes file uploads for web environments by:\n * - Validating file data using getAndValidateFile function\n * - Creating a size validation transform stream to monitor upload progress\n * - Returning a web-compatible ReadableStream with real-time validation\n * - Providing standardized error responses for validation failures\n * - Wrapping the stream in a standardized response format\n *\n * @param type - The type of upload being processed (IMAGE, VIDEO, DOCUMENT, OTHER).\n * @param file - The upload file object containing file metadata and stream creation method.\n * @param config - Optional upload configuration. If not provided, uses default configuration.\n * @returns A promise that resolves to a standardized response containing either a web ReadableStream or error information.\n */\nexport async function getFileWebStream(type: E_UploadType, file: I_UploadFile, config?: I_UploadConfig): Promise<I_Return<ReadableStream<Uint8Array>>> {\n    const uploadConfig = config ?? createUploadConfig();\n    const typeConfig = uploadConfig[type];\n\n    const fileData = await getAndValidateFile(type, file, config);\n\n    if (!fileData.success) {\n        return fileData;\n    }\n\n    const { createReadStream } = fileData.result;\n\n    let remainingBytes = typeConfig.sizeLimit;\n\n    const sizeValidationStream = new Transform({\n        transform(chunk: Buffer, _enc: BufferEncoding, cb) {\n            remainingBytes -= chunk.length;\n\n            if (remainingBytes < 0) {\n                cb(new Error(`File size exceeds limit of ${typeConfig.sizeLimit / BYTES_PER_MB}MB`));\n            }\n            else {\n                cb(null, chunk);\n            }\n        },\n    });\n    const originalStream = createReadStream();\n    const validatedStream = originalStream.pipe(sizeValidationStream);\n\n    return {\n        success: true,\n        result: new ReadableStream<Uint8Array>({\n            start(controller) {\n                validatedStream.on('data', (chunk: Buffer | string) => {\n                    controller.enqueue(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);\n                });\n                validatedStream.on('end', () => controller.close());\n                validatedStream.on('error', (err: unknown) => controller.error(err));\n            },\n        }),\n    };\n}\n\n/**\n * Validates if a file has an allowed extension.\n * This function extracts the file extension from the filename and checks if it's\n * included in the list of allowed extensions (case-insensitive comparison).\n *\n * @param filename - The filename to check for valid extension.\n * @param allowedExtensions - An array of allowed file extensions (without dots).\n * @returns True if the file extension is allowed, false otherwise.\n */\nexport function validateFileExtension(filename: string, allowedExtensions: string[]): boolean {\n    const lastDotIndex = filename.lastIndexOf('.');\n\n    if (lastDotIndex === -1) {\n        return false;\n    }\n\n    const extension = filename.substring(lastDotIndex + 1).toLowerCase();\n\n    return allowedExtensions.includes(extension);\n}\n\n/**\n * Validates an upload against the specified configuration.\n * This function performs comprehensive validation including:\n * - File extension validation against allowed extensions\n * - File size validation against size limits\n * - Returns detailed error messages for validation failures\n *\n * @param config - The validation configuration including filename and optional file size.\n * @param uploadConfig - The upload configuration containing allowed extensions and size limits.\n * @param uploadType - The type of upload being validated.\n * @returns An object indicating validation success and optional error message.\n */\nexport function validateUpload(\n    config: I_UploadValidationConfig,\n    uploadConfig: I_UploadConfig,\n    uploadType: E_UploadType,\n): { isValid: boolean; error?: string } {\n    const { filename, fileSize } = config;\n    const typeConfig: I_UploadTypeConfig = uploadConfig[uploadType];\n\n    const { allowedExtensions, sizeLimit } = typeConfig;\n\n    if (!validateFileExtension(filename, allowedExtensions)) {\n        return {\n            isValid: false,\n            error: `File extension not allowed for ${uploadType.toLowerCase()} files. Allowed extensions: ${allowedExtensions.join(', ')}`,\n        };\n    }\n\n    if (fileSize !== undefined && fileSize > sizeLimit) {\n        const maxSizeMB = Math.round(sizeLimit / (1024 * 1024));\n\n        return {\n            isValid: false,\n            error: `File size exceeds limit for ${uploadType.toLowerCase()} files. Maximum size: ${maxSizeMB}MB`,\n        };\n    }\n\n    return { isValid: true };\n}\n\n/**\n * Creates a default upload configuration with predefined settings for different file types.\n * This function provides sensible defaults for image, video, document, and other file types,\n * including allowed extensions and size limits. The configuration can be customized with overrides.\n *\n * @param overrides - Optional configuration overrides to merge with the default configuration.\n * @returns A complete upload configuration object with defaults and any provided overrides.\n */\nexport function createUploadConfig(overrides?: Partial<I_UploadConfig>): I_UploadConfig {\n    return { ...DEFAULT_UPLOAD_CONFIG, ...overrides };\n}\n\n/**\n * Uploads a file with comprehensive validation and error handling.\n * This function processes file uploads with the following features:\n * - Input validation for path and file parameters\n * - Configuration validation for all upload types\n * - File validation using getAndValidateFile function\n * - Automatic directory creation\n * - Stream-based file writing\n * - Comprehensive error handling with standardized response codes\n *\n * @param options - Upload configuration including file, path, type, and optional validation config.\n * @returns A promise that resolves to a standardized response with success status, message, file path, and response codes.\n */\nexport async function upload(options: I_UploadOptions): Promise<I_Return<string>> {\n    const { path, file, config, type, baseDir } = options;\n\n    if (!path || typeof path !== 'string') {\n        return {\n            success: false,\n            message: 'Invalid path provided',\n            code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n        };\n    }\n\n    // Security: Validate path is within allowed base directory to prevent path traversal.\n    // When baseDir is provided, the resolved path must start with it.\n    // When baseDir is not provided, reject any path containing \"..\" segments.\n    const resolvedPath = nodePath.resolve(path);\n\n    if (baseDir) {\n        const resolvedBase = nodePath.resolve(baseDir) + nodePath.sep;\n        if (!resolvedPath.startsWith(resolvedBase) && resolvedPath !== nodePath.resolve(baseDir)) {\n            return {\n                success: false,\n                message: 'Path traversal detected: path resolves outside the allowed base directory',\n                code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n            };\n        }\n    }\n    else if (path.includes('..')) {\n        return {\n            success: false,\n            message: 'Path traversal detected: \"..\" segments are not allowed',\n            code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n        };\n    }\n\n    if (!file || typeof file !== 'object') {\n        return {\n            success: false,\n            message: 'Invalid file provided',\n            code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n        };\n    }\n\n    if (config) {\n        const requiredTypes = [E_UploadType.IMAGE, E_UploadType.VIDEO, E_UploadType.DOCUMENT, E_UploadType.OTHER];\n\n        for (const requiredType of requiredTypes) {\n            if (!config[requiredType] || !Array.isArray(config[requiredType].allowedExtensions) || config[requiredType].allowedExtensions.length === 0) {\n                return {\n                    success: false,\n                    message: `Invalid config for ${requiredType.toLowerCase()} files`,\n                    code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n                };\n            }\n            if (typeof config[requiredType].sizeLimit !== 'number' || config[requiredType].sizeLimit <= 0) {\n                return {\n                    success: false,\n                    message: `Invalid size limit for ${requiredType.toLowerCase()} files`,\n                    code: RESPONSE_STATUS.BAD_REQUEST.CODE,\n                };\n            }\n        }\n    }\n\n    try {\n        const fileData = await getAndValidateFile(type, await file, config);\n\n        if (!fileData.success) {\n            return fileData;\n        }\n\n        const { createReadStream } = fileData.result;\n\n        const dir = dirname(path);\n\n        if (!pathExistsSync(dir)) {\n            mkdirSync(dir, { recursive: true });\n        }\n\n        const writeStream = createReadStream();\n        const out = createWriteStream(path);\n        writeStream.pipe(out);\n\n        await new Promise<void>((resolve, reject) => {\n            out.on('finish', () => resolve());\n            out.on('error', reject);\n            writeStream.on('error', reject);\n        });\n\n        return {\n            success: true,\n            result: path,\n            message: 'File uploaded successfully',\n            code: RESPONSE_STATUS.OK.CODE,\n        };\n    }\n    catch (error) {\n        return {\n            success: false,\n            message: error instanceof Error ? error.message : 'File upload failed',\n            code: RESPONSE_STATUS.INTERNAL_SERVER_ERROR.CODE,\n        };\n    }\n}\n"],"mappings":"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"}

package/dist/node/ws/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './ws.type.js';
+export * from './ws.util.js';

package/dist/{src/react → react}/apollo-client/apollo-client.type.d.ts

@@ -1,7 +1,7 @@
 import { ApolloClient } from '@apollo/client';
 import { ApolloLink } from '@apollo/client/link';
 import { GraphQLError } from 'graphql';
-import { I_Children } from '../../../typescript/index.js';
+import { I_Children } from '../../typescript/index.js';
 export interface I_ApolloOptions extends Omit<ApolloClient.Options, 'link' | 'cache'> {
     uri?: string;
     wsUrl?: string;

package/dist/react/apollo-client/index.d.ts

@@ -1 +1,9 @@
-export {}
+export * from './apollo-client.component.js';
+export * from './apollo-client.constant.js';
+export * from './apollo-client.context.js';
+export * from './apollo-client.hook.js';
+export * from './apollo-client.type.js';
+export * from './apollo-client.util.js';
+export * from './links/index.js';
+export { makeVar } from '@apollo/client/cache';
+export { useApolloClient, useBackgroundQuery, useFragment, useLazyQuery, useLoadableQuery, useMutation, useQuery, useQueryRefHandlers, useReactiveVar, useReadQuery, useSubscription, useSuspenseFragment, useSuspenseQuery } from '@apollo/client/react';

package/dist/react/apollo-client/links/index.d.ts

@@ -1 +1 @@
-export {}
+export * from './upload.js';

package/dist/react/apollo-client-nextjs/apollo-client-nextjs.rsc.d.ts

@@ -1 +1,16 @@
-export {}
+import { I_ApolloOptions } from '../apollo-client/index.js';
+/**
+ * Creates a registered Apollo Client factory for Next.js server components.
+ * This function creates a client factory that is registered with Next.js for
+ * proper server-side rendering support. The factory function ensures that
+ * each request gets its own Apollo Client instance, which is essential for
+ * SSR compatibility and preventing client state leakage between requests.
+ *
+ * @param options - Configuration options for the Apollo Client including URI, WebSocket URL, and custom links.
+ * @returns A registered Apollo Client factory function that can be used with Next.js server components.
+ */
+export declare const makeClient: (options?: I_ApolloOptions) => {
+    getClient: () => import('@apollo/client-integration-nextjs').ApolloClient;
+    query: <TData = unknown, TVariables extends import('@apollo/client').OperationVariables = import('@apollo/client').OperationVariables>(options: import("@apollo/client").ApolloClient.QueryOptions<TData, TVariables>) => Promise<import("@apollo/client").ApolloClient.QueryResult<import('@apollo/client').MaybeMasked<TData>>>;
+    PreloadQuery: import('@apollo/client-integration-nextjs').PreloadQueryComponent;
+};

package/dist/react/apollo-client-nextjs/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './apollo-client-nextjs.component.js';
+export * from './apollo-client-nextjs.util.js';

package/dist/react/apollo-error/index.d.ts

@@ -1 +1,6 @@
-export {}
+export * from './apollo-error.component.js';
+export * from './apollo-error.context.js';
+export * from './apollo-error.hook.js';
+export * from './apollo-error.provider.js';
+export * from './apollo-error.type.js';
+export * from './apollo-error.util.js';

package/dist/react/i18next/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './i18next.hook.js';
+export * from './i18next.util.js';

package/dist/react/loading/index.d.ts

@@ -1 +1,5 @@
-export {}
+export * from './loading.component.js';
+export * from './loading.context.js';
+export * from './loading.hook.js';
+export * from './loading.provider.js';
+export * from './loading.type.js';

package/dist/{src/react → react}/loading/loading.provider.d.ts

@@ -1,4 +1,4 @@
-import { I_Children } from '../../../typescript/index.js';
+import { I_Children } from '../../typescript/index.js';
 import * as React from 'react';
 /**
  * Provider component that manages loading state and provides loading context.

package/dist/react/log/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './log.type.js';
+export * from './log.util.js';

package/dist/react/log/log.type.d.ts

@@ -0,0 +1 @@
+export type { I_CatchErrorOptions } from '../../util/log/index.js';

package/dist/{src/react → react}/log/log.util.d.ts

@@ -1,4 +1,4 @@
-import { I_Log, I_Return } from '../../../typescript/index.js';
+import { I_Log, I_Return } from '../../typescript/index.js';
 import { I_CatchErrorOptions } from './log.type.js';
 /**
  * Browser-compatible logging interface using consola.

package/dist/react/next-intl/index.d.ts

@@ -1 +1,6 @@
-export {}
+export * from './next-intl.constant.js';
+export * from './next-intl.context.js';
+export * from './next-intl.hoc.js';
+export * from './next-intl.hook.js';
+export * from './next-intl.provider.js';
+export * from './next-intl.type.js';

package/dist/{src/react → react}/next-intl/next-intl.hoc.d.ts

@@ -1,5 +1,5 @@
 import { ComponentType } from 'react';
-import { I_Children } from '../../../typescript/index.js';
+import { I_Children } from '../../typescript/index.js';
 import { I_NextIntlLanguage, T_NextIntlMessageList } from './next-intl.type.js';
 import * as React from 'react';
 /**

package/dist/{src/react → react}/next-intl/next-intl.type.d.ts

@@ -1,6 +1,6 @@
 import { Locale } from 'date-fns';
 import { AbstractIntlMessages, Timezone } from 'next-intl';
-import { I_Children } from '../../../typescript/index.js';
+import { I_Children } from '../../typescript/index.js';
 export interface I_NextIntlLanguage {
     label: string;
     value: string;

package/dist/react/storage/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './storage.hook.js';
+export * from './storage.util.js';

package/dist/{src/react → react}/storage/storage.hook.d.ts

@@ -1,4 +1,4 @@
-import { I_Serializer } from '../../../util/serializer/index.js';
+import { I_Serializer } from '../../util/serializer/index.js';
 /**
  * React hook that provides persistent storage functionality with automatic serialization.
  * This hook manages state that persists across browser sessions using localStorage,

package/dist/react/toast/index.d.ts

@@ -1 +1 @@
-export {}
+export { toast, Toaster } from 'react-hot-toast';

package/dist/react/userback/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './userback.component.js';
+export * from './userback.type.js';

package/dist/typescript/index.d.ts

@@ -1 +1,5 @@
-export {}
+/**
+ * Re-exports all common TypeScript types for shared usage across the codebase.
+ */
+export * from './common.type.js';
+export * from './react.type.js';

package/dist/util/common/index.d.ts

@@ -1 +1,5 @@
-export {}
+/**
+ * Re-exports all common utility types for shared usage across the codebase.
+ */
+export * from './common.type.js';
+export * from './common.util.js';

package/dist/util/index.d.ts

@@ -1 +1,9 @@
-export {}
+/**
+ * Re-exports all utility modules for shared usage across the codebase.
+ */
+export * from './common/index.js';
+export * from './log/index.js';
+export * from './object/index.js';
+export * from './serializer/index.js';
+export * from './string/index.js';
+export * from './validate/index.js';

package/dist/util/log/index.d.ts

@@ -1 +1,2 @@
-export {}
+export type { I_CatchErrorOptions } from './log.type.js';
+export { baseCatchError } from './log.util.js';

package/dist/{src/util → util}/log/log.util.d.ts

@@ -1,4 +1,4 @@
-import { I_Return } from '../../../typescript/index.js';
+import { I_Return } from '../../typescript/index.js';
 import { I_CatchErrorOptions } from './log.type.js';
 /**
  * Core error-catching implementation shared between Node and React environments.

package/dist/util/object/index.d.ts

@@ -1 +1,4 @@
-export {}
+/**
+ * Re-exports all object manipulation utilities.
+ */
+export * from './object.util.js';

package/dist/util/serializer/index.d.ts

@@ -1 +1,2 @@
-export {}
+export * from './serializer.type.js';
+export * from './serializer.util.js';

package/dist/util/string/index.d.ts

@@ -1 +1,5 @@
-export {}
+/**
+ * Re-exports all string manipulation utilities and types.
+ */
+export * from './string.type.js';
+export * from './string.util.js';

package/dist/util/validate/index.d.ts

@@ -1 +1,4 @@
-export {}
+/**
+ * Re-exports all validation utilities.
+ */
+export * from './validate.util.js';

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@cyberskill/shared",
     "type": "module",
-    "version": "3.12.0",
+    "version": "3.13.0",
     "description": "CyberSkill Shared",
     "author": "Stephen Cheng",
     "license": "MIT",

package/dist/src/config/commitlint/index.d.ts

@@ -1,5 +0,0 @@
-declare const _default: {
-    extends: string[];
-    ignores: ((message: string) => boolean)[];
-};
-export default _default;

package/dist/src/config/env/index.d.ts

@@ -1,3 +0,0 @@
-export * from './env.constant.js';
-export * from './env.type.js';
-export * from './env.util.js';