ceph-link 1.0.0 → 1.1.0

package/dist/utils/mime-helper.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MimeHelper = void 0;
+const path_helper_1 = require("./path-helper");
+class MimeHelper {
+    static getMimeType(filename) {
+        const extension = path_helper_1.PathHelper.getFileExtension(filename);
+        return this.mimeTypes[extension] || 'application/octet-stream';
+    }
+    static isImage(filename) {
+        const mimeType = this.getMimeType(filename);
+        return mimeType.startsWith('image/');
+    }
+    static isVideo(filename) {
+        const mimeType = this.getMimeType(filename);
+        return mimeType.startsWith('video/');
+    }
+    static isAudio(filename) {
+        const mimeType = this.getMimeType(filename);
+        return mimeType.startsWith('audio/');
+    }
+    static isDocument(filename) {
+        const mimeType = this.getMimeType(filename);
+        return mimeType.includes('document') ||
+            mimeType === 'application/pdf' ||
+            mimeType.includes('text/');
+    }
+    static getFileCategory(filename) {
+        if (this.isImage(filename))
+            return 'image';
+        if (this.isVideo(filename))
+            return 'video';
+        if (this.isAudio(filename))
+            return 'audio';
+        if (this.isDocument(filename))
+            return 'document';
+        return 'other';
+    }
+}
+exports.MimeHelper = MimeHelper;
+MimeHelper.mimeTypes = {
+    // Text files
+    'txt': 'text/plain',
+    'md': 'text/markdown',
+    'html': 'text/html',
+    'htm': 'text/html',
+    'css': 'text/css',
+    'js': 'application/javascript',
+    'json': 'application/json',
+    'xml': 'application/xml',
+    'csv': 'text/csv',
+    // Images
+    'jpg': 'image/jpeg',
+    'jpeg': 'image/jpeg',
+    'png': 'image/png',
+    'gif': 'image/gif',
+    'svg': 'image/svg+xml',
+    'webp': 'image/webp',
+    'ico': 'image/x-icon',
+    'bmp': 'image/bmp',
+    // Documents
+    'pdf': 'application/pdf',
+    'doc': 'application/msword',
+    'docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    'xls': 'application/vnd.ms-excel',
+    'xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    'ppt': 'application/vnd.ms-powerpoint',
+    'pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    // Archives
+    'zip': 'application/zip',
+    'rar': 'application/x-rar-compressed',
+    '7z': 'application/x-7z-compressed',
+    'tar': 'application/x-tar',
+    'gz': 'application/gzip',
+    // Audio
+    'mp3': 'audio/mpeg',
+    'wav': 'audio/wav',
+    'ogg': 'audio/ogg',
+    'flac': 'audio/flac',
+    // Video
+    'mp4': 'video/mp4',
+    'avi': 'video/x-msvideo',
+    'mov': 'video/quicktime',
+    'wmv': 'video/x-ms-wmv',
+    'webm': 'video/webm',
+};
+//# sourceMappingURL=mime-helper.js.map

package/dist/utils/mime-helper.js.map

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

package/dist/utils/path-helper.d.ts

@@ -0,0 +1,12 @@
+export declare class PathHelper {
+    static normalizePath(path: string): string;
+    static ensureTrailingSlash(path: string): string;
+    static removeTrailingSlash(path: string): string;
+    static getFileName(path: string): string;
+    static getFileExtension(filename: string): string;
+    static getFolderPath(filePath: string): string;
+    static joinPaths(...paths: string[]): string;
+    static isValidPath(path: string): boolean;
+    static sanitizePath(path: string): string;
+}
+//# sourceMappingURL=path-helper.d.ts.map

package/dist/utils/path-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-helper.d.ts","sourceRoot":"","sources":["../../src/utils/path-helper.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IACrB,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI1C,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhD,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhD,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKxC,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAKjD,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAM9C,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAO5C,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMzC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAM1C"}

package/dist/utils/path-helper.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathHelper = void 0;
+class PathHelper {
+    static normalizePath(path) {
+        return path.replace(/\/+/g, '/').replace(/^\//, '').replace(/\/$/, '');
+    }
+    static ensureTrailingSlash(path) {
+        return path.endsWith('/') ? path : `${path}/`;
+    }
+    static removeTrailingSlash(path) {
+        return path.endsWith('/') ? path.slice(0, -1) : path;
+    }
+    static getFileName(path) {
+        const parts = path.split('/');
+        return parts[parts.length - 1] || '';
+    }
+    static getFileExtension(filename) {
+        const lastDot = filename.lastIndexOf('.');
+        return lastDot > 0 ? filename.slice(lastDot + 1).toLowerCase() : '';
+    }
+    static getFolderPath(filePath) {
+        const parts = filePath.split('/');
+        parts.pop(); // Remove filename
+        return parts.join('/');
+    }
+    static joinPaths(...paths) {
+        return paths
+            .map(path => this.normalizePath(path))
+            .filter(path => path.length > 0)
+            .join('/');
+    }
+    static isValidPath(path) {
+        // Check for invalid characters
+        const invalidChars = /[<>:"|?*\x00-\x1f]/;
+        return !invalidChars.test(path) && path.length > 0 && path.length <= 1024;
+    }
+    static sanitizePath(path) {
+        return path
+            .replace(/[<>:"|?*\x00-\x1f]/g, '_')
+            .replace(/\/+/g, '/')
+            .substring(0, 1024);
+    }
+}
+exports.PathHelper = PathHelper;
+//# sourceMappingURL=path-helper.js.map

package/dist/utils/path-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-helper.js","sourceRoot":"","sources":["../../src/utils/path-helper.ts"],"names":[],"mappings":";;;AAAA,MAAa,UAAU;IACrB,MAAM,CAAC,aAAa,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,IAAY;QACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,IAAY;QACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,QAAgB;QACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,OAAO,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,QAAgB;QACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,kBAAkB;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,GAAG,KAAe;QACjC,OAAO,KAAK;aACT,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;aACrC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;aAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,+BAA+B;QAC/B,MAAM,YAAY,GAAG,oBAAoB,CAAC;QAC1C,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,IAAY;QAC9B,OAAO,IAAI;aACR,OAAO,CAAC,qBAAqB,EAAE,GAAG,CAAC;aACnC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;aACpB,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;CACF;AAhDD,gCAgDC"}

package/dist/utils/validators.d.ts

@@ -0,0 +1,37 @@
+export declare class Validators {
+    static isValidBucketName(bucketName: string): boolean;
+    static validateBucketName(bucketName: string): {
+        valid: boolean;
+        errors: string[];
+    };
+    static isValidFilePath(filePath: string): boolean;
+    static validateFilePath(filePath: string): {
+        valid: boolean;
+        errors: string[];
+    };
+    static validateFileSize(size: number, maxSizeMB?: number): {
+        valid: boolean;
+        error?: string;
+    };
+    static validateContentType(contentType: string, allowedTypes?: string[]): {
+        valid: boolean;
+        error?: string;
+    };
+    static validateMetadata(metadata: Record<string, string>): {
+        valid: boolean;
+        errors: string[];
+    };
+    static validateUploadOptions(options: any): {
+        valid: boolean;
+        errors: string[];
+    };
+    static validateConfig(config: any): {
+        valid: boolean;
+        errors: string[];
+    };
+    static validateSearchOptions(options: any): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+//# sourceMappingURL=validators.d.ts.map

package/dist/utils/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAGA,qBAAa,UAAU;IAErB,MAAM,CAAC,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAkCrD,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA4CnF,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjD,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA8B/E,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAanG,MAAM,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAyB5G,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAuB/F,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,GAAG,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA4BhF,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAiCxE,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,GAAG,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CA6BjF"}

package/dist/utils/validators.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Validators = void 0;
+const path_helper_1 = require("./path-helper");
+class Validators {
+    // Bucket name validation
+    static isValidBucketName(bucketName) {
+        // AWS S3 bucket naming rules
+        if (!bucketName || bucketName.length < 3 || bucketName.length > 63) {
+            return false;
+        }
+        // Must start and end with lowercase letter or number
+        if (!/^[a-z0-9].*[a-z0-9]$/.test(bucketName)) {
+            return false;
+        }
+        // Cannot contain uppercase letters
+        if (/[A-Z]/.test(bucketName)) {
+            return false;
+        }
+        // Cannot be formatted as IP address
+        if (/^\d+\.\d+\.\d+\.\d+$/.test(bucketName)) {
+            return false;
+        }
+        // Cannot contain consecutive periods
+        if (/\.\./.test(bucketName)) {
+            return false;
+        }
+        // Can only contain lowercase letters, numbers, periods, and hyphens
+        if (!/^[a-z0-9.-]+$/.test(bucketName)) {
+            return false;
+        }
+        return true;
+    }
+    static validateBucketName(bucketName) {
+        const errors = [];
+        if (!bucketName) {
+            errors.push('Bucket name is required');
+            return { valid: false, errors };
+        }
+        if (bucketName.length < 3) {
+            errors.push('Bucket name must be at least 3 characters long');
+        }
+        if (bucketName.length > 63) {
+            errors.push('Bucket name must be no more than 63 characters long');
+        }
+        if (!/^[a-z0-9]/.test(bucketName)) {
+            errors.push('Bucket name must start with a lowercase letter or number');
+        }
+        if (!/[a-z0-9]$/.test(bucketName)) {
+            errors.push('Bucket name must end with a lowercase letter or number');
+        }
+        if (/[A-Z]/.test(bucketName)) {
+            errors.push('Bucket name cannot contain uppercase letters');
+        }
+        if (/^\d+\.\d+\.\d+\.\d+$/.test(bucketName)) {
+            errors.push('Bucket name cannot be formatted as an IP address');
+        }
+        if (/\.\./.test(bucketName)) {
+            errors.push('Bucket name cannot contain consecutive periods');
+        }
+        if (!/^[a-z0-9.-]+$/.test(bucketName)) {
+            errors.push('Bucket name can only contain lowercase letters, numbers, periods, and hyphens');
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    // File path validation
+    static isValidFilePath(filePath) {
+        return path_helper_1.PathHelper.isValidPath(filePath);
+    }
+    static validateFilePath(filePath) {
+        const errors = [];
+        if (!filePath) {
+            errors.push('File path is required');
+            return { valid: false, errors };
+        }
+        if (filePath.length > 1024) {
+            errors.push('File path must be no more than 1024 characters long');
+        }
+        // Check for invalid characters
+        const invalidChars = /[<>:"|?*\x00-\x1f]/;
+        if (invalidChars.test(filePath)) {
+            errors.push('File path contains invalid characters');
+        }
+        // Check for reserved names (Windows)
+        const reservedNames = ['CON', 'PRN', 'AUX', 'NUL', 'COM1', 'COM2', 'COM3', 'COM4', 'COM5', 'COM6', 'COM7', 'COM8', 'COM9', 'LPT1', 'LPT2', 'LPT3', 'LPT4', 'LPT5', 'LPT6', 'LPT7', 'LPT8', 'LPT9'];
+        const fileName = path_helper_1.PathHelper.getFileName(filePath);
+        const baseName = fileName.split('.')[0].toUpperCase();
+        if (reservedNames.includes(baseName)) {
+            errors.push('File name cannot be a reserved system name');
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    // File content validation
+    static validateFileSize(size, maxSizeMB = 5000) {
+        const maxSizeBytes = maxSizeMB * 1024 * 1024;
+        if (size > maxSizeBytes) {
+            return {
+                valid: false,
+                error: `File size (${Math.round(size / 1024 / 1024)}MB) exceeds maximum allowed size (${maxSizeMB}MB)`
+            };
+        }
+        return { valid: true };
+    }
+    static validateContentType(contentType, allowedTypes) {
+        if (!contentType) {
+            return { valid: false, error: 'Content type is required' };
+        }
+        if (allowedTypes && allowedTypes.length > 0) {
+            const isAllowed = allowedTypes.some(type => {
+                if (type.endsWith('/*')) {
+                    return contentType.startsWith(type.slice(0, -1));
+                }
+                return contentType === type;
+            });
+            if (!isAllowed) {
+                return {
+                    valid: false,
+                    error: `Content type '${contentType}' is not allowed. Allowed types: ${allowedTypes.join(', ')}`
+                };
+            }
+        }
+        return { valid: true };
+    }
+    // Metadata validation
+    static validateMetadata(metadata) {
+        const errors = [];
+        Object.entries(metadata).forEach(([key, value]) => {
+            // AWS S3 metadata key constraints
+            if (key.length > 8192) {
+                errors.push(`Metadata key '${key}' is too long (max 8192 characters)`);
+            }
+            if (value.length > 8192) {
+                errors.push(`Metadata value for '${key}' is too long (max 8192 characters)`);
+            }
+            // Check for invalid characters in key
+            if (!/^[a-zA-Z0-9._-]+$/.test(key)) {
+                errors.push(`Metadata key '${key}' contains invalid characters`);
+            }
+        });
+        return { valid: errors.length === 0, errors };
+    }
+    // Upload options validation
+    static validateUploadOptions(options) {
+        const errors = [];
+        if (options.contentType) {
+            const contentTypeValidation = this.validateContentType(options.contentType);
+            if (!contentTypeValidation.valid) {
+                errors.push(contentTypeValidation.error);
+            }
+        }
+        if (options.metadata) {
+            const metadataValidation = this.validateMetadata(options.metadata);
+            if (!metadataValidation.valid) {
+                errors.push(...metadataValidation.errors);
+            }
+        }
+        if (options.acl) {
+            const validAcls = ['private', 'public-read', 'public-read-write', 'authenticated-read'];
+            if (!validAcls.includes(options.acl)) {
+                errors.push(`Invalid ACL '${options.acl}'. Valid ACLs: ${validAcls.join(', ')}`);
+            }
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    // Configuration validation
+    static validateConfig(config) {
+        const errors = [];
+        if (!config.endpoint) {
+            errors.push('Endpoint is required');
+        }
+        else {
+            try {
+                new URL(config.endpoint);
+            }
+            catch (error) {
+                errors.push('Endpoint must be a valid URL');
+            }
+        }
+        if (!config.accessKeyId) {
+            errors.push('Access Key ID is required');
+        }
+        if (!config.secretAccessKey) {
+            errors.push('Secret Access Key is required');
+        }
+        if (config.timeout && (typeof config.timeout !== 'number' || config.timeout < 0)) {
+            errors.push('Timeout must be a positive number');
+        }
+        if (config.retries && (typeof config.retries !== 'number' || config.retries < 0)) {
+            errors.push('Retries must be a positive number');
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    // Search options validation
+    static validateSearchOptions(options) {
+        const errors = [];
+        if (options.minSize && (typeof options.minSize !== 'number' || options.minSize < 0)) {
+            errors.push('minSize must be a positive number');
+        }
+        if (options.maxSize && (typeof options.maxSize !== 'number' || options.maxSize < 0)) {
+            errors.push('maxSize must be a positive number');
+        }
+        if (options.minSize && options.maxSize && options.minSize > options.maxSize) {
+            errors.push('minSize cannot be greater than maxSize');
+        }
+        if (options.modifiedAfter && !(options.modifiedAfter instanceof Date)) {
+            errors.push('modifiedAfter must be a Date object');
+        }
+        if (options.modifiedBefore && !(options.modifiedBefore instanceof Date)) {
+            errors.push('modifiedBefore must be a Date object');
+        }
+        if (options.modifiedAfter && options.modifiedBefore && options.modifiedAfter > options.modifiedBefore) {
+            errors.push('modifiedAfter cannot be after modifiedBefore');
+        }
+        return { valid: errors.length === 0, errors };
+    }
+}
+exports.Validators = Validators;
+//# sourceMappingURL=validators.js.map

package/dist/utils/validators.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ceph-link",
   "private": false,
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Enterprise-grade NestJS SDK for Ceph S3",
   "author": {
     "name": "Mrabti Adil",
@@ -46,12 +46,10 @@
     "test:manual": "ts-node test/manual/manual-test.ts",
     "validate:connection": "ts-node test/validate-connection.ts",
     "test:all": "npm run validate:connection && npm run test && npm run test:integration",
-    "prepublishOnly": "npm run build",
-    "prepare": "npm run build",
-    "release": "npm run build && npm publish",
     "docs:generate": "typedoc --out docs src",
     "example:standalone": "ts-node examples/standalone-example.ts",
-    "example:nestjs": "ts-node examples/nestjs-example.ts"
+    "example:nestjs": "ts-node examples/nestjs-example.ts",
+    "pub": "npm publish"
   },
   "dependencies": {
     "@nestjs/common": "^11.1.5",