@cyberskill/shared 2.28.0 → 3.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.util.js","sources":["../../../src/node/mongo/mongo.util.ts"],"sourcesContent":["import type mongooseRaw from 'mongoose';\n\nimport type migrate from 'migrate-mongo';\nimport aggregatePaginate from 'mongoose-aggregate-paginate-v2';\nimport mongoosePaginate from 'mongoose-paginate-v2';\nimport { randomUUID } from 'node:crypto';\n\nimport { deepClone, getNestedValue, regexSearchMapper, setNestedValue } from '#util/index.js';\nimport { validate } from '#util/validate/index.js';\n\nimport type { MongoController } from './mongo.controller.js';\nimport type { C_Document, I_CreateModelOptions, I_CreateSchemaOptions, I_DynamicVirtualConfig, I_DynamicVirtualOptions, I_ExtendedModel, I_GenericDocument, I_MongooseModelMiddleware, T_MongoosePlugin, T_MongooseShema, T_QueryFilter, T_VirtualOptions, T_WithId } from './mongo.type.js';\n\nimport { addGitIgnoreEntry, writeFileSync } from '../fs/index.js';\nimport { MIGRATE_MONGO_CONFIG, PATH } from '../path/index.js';\n\n/**\n * Converts enum values to proper model names.\n * Handles common naming conventions like converting 'USER' to 'User'.\n *\n * @param enumValue - The enum value to convert\n * @returns The converted model name\n */\nexport function convertEnumToModelName(enumValue: string): string {\n    if (enumValue === enumValue.toUpperCase()) {\n        return enumValue.charAt(0).toUpperCase() + enumValue.slice(1).toLowerCase();\n    }\n\n    return enumValue;\n}\n\n/**\n * Interface for the MongoDB utility object to enable explicit type annotation.\n * Required to avoid TS7056 (inferred type exceeds maximum serialization length).\n */\ninterface I_MongoUtils {\n    createGenericFields(): I_GenericDocument;\n    applyPlugins<T>(schema: T_MongooseShema<T>, plugins: Array<T_MongoosePlugin | false>): void;\n    applyMiddlewares<T extends Partial<C_Document>>(schema: T_MongooseShema<T>, middlewares: I_MongooseModelMiddleware<T>[]): void;\n    createGenericSchema(mongoose: typeof mongooseRaw): T_MongooseShema<I_GenericDocument>;\n    createSchema<T, R extends string>(options: I_CreateSchemaOptions<T, R>): T_MongooseShema<T>;\n    createModel<T extends Partial<C_Document>, R extends string>(options: I_CreateModelOptions<T, R>): I_ExtendedModel<T>;\n    validator: {\n        isRequired<T>(): (this: T, value: unknown) => Promise<boolean>;\n        isUnique<T extends { constructor: { exists: (query: { [key: string]: unknown }) => Promise<unknown> } }>(fields: string[]): (this: T, value: unknown) => Promise<boolean>;\n        matchesRegex(regexArray: RegExp[]): (value: string) => Promise<boolean>;\n    };\n    migrate: {\n        getModule(): Promise<typeof migrate>;\n        setConfig: (options: Partial<migrate.config.Config> & { moduleSystem?: 'commonjs' | 'esm' }) => void;\n    };\n    regexify<T>(filter?: T_QueryFilter<T>, fields?: (keyof T | string)[]): T_QueryFilter<T>;\n    isDynamicVirtual<T, R extends string>(options?: T_VirtualOptions<T, R>): options is I_DynamicVirtualOptions<T, R>;\n    getNewRecords<T extends I_GenericDocument>(controller: MongoController<T>, recordsToCheck: T[], filterFn: (existingRecord: T_WithId<T>, newRecord: T) => boolean): Promise<T[]>;\n    getExistingRecords<T extends I_GenericDocument>(controller: MongoController<T>, recordsToCheck: T[], filterFn: (existingRecord: T_WithId<T>, newRecord: T) => boolean): Promise<T_WithId<T>[]>;\n}\n\n/**\n * MongoDB utility object providing comprehensive database operations and utilities.\n * This object contains methods for creating generic fields, applying plugins and middlewares,\n * creating schemas and models, validation functions, migration utilities, and regex filtering.\n */\nexport const mongo: I_MongoUtils = {\n    /**\n     * Creates generic fields that are commonly used across MongoDB documents.\n     * This function generates standard fields including a UUID, deletion flag, and timestamps\n     * that can be applied to any document schema.\n     *\n     * @returns An object containing generic document fields (id, isDel, createdAt, updatedAt).\n     */\n    createGenericFields(): I_GenericDocument {\n        return {\n            id: randomUUID(),\n            isDel: false,\n            createdAt: new Date(),\n            updatedAt: new Date(),\n        };\n    },\n    /**\n     * Applies plugins to a Mongoose schema.\n     * This function filters out falsy plugins and applies the remaining valid plugins\n     * to the provided schema.\n     *\n     * @param schema - The Mongoose schema to apply plugins to.\n     * @param plugins - An array of plugin functions or false values to filter and apply.\n     */\n    applyPlugins<T>(schema: T_MongooseShema<T>, plugins: Array<T_MongoosePlugin | false>) {\n        plugins\n            .filter((plugin): plugin is T_MongoosePlugin => typeof plugin === 'function')\n            .forEach(plugin => schema.plugin(plugin));\n    },\n    /**\n     * Applies middleware functions to a Mongoose schema.\n     * This function configures pre and post middleware for specified methods on the schema.\n     *\n     * @param schema - The Mongoose schema to apply middleware to.\n     * @param middlewares - An array of middleware configurations with method, pre, and post functions.\n     */\n    applyMiddlewares<T extends Partial<C_Document>>(\n        schema: T_MongooseShema<T>,\n        middlewares: I_MongooseModelMiddleware<T>[],\n    ) {\n        middlewares.forEach(({ method, pre, post }) => {\n            if (method && pre) {\n                schema.pre(method as RegExp, pre);\n            }\n\n            if (method && post) {\n                schema.post(method as RegExp, post);\n            }\n        });\n    },\n    /**\n     * Creates a generic Mongoose schema with common fields.\n     * This function creates a base schema with UUID field and deletion flag,\n     * configured with automatic timestamps.\n     *\n     * @param mongoose - The Mongoose instance to create the schema with.\n     * @returns A Mongoose schema with generic document fields.\n     */\n    createGenericSchema(mongoose: typeof mongooseRaw) {\n        return new mongoose.Schema<I_GenericDocument>(\n            {\n                id: { type: String, default: () => randomUUID(), unique: true },\n                isDel: { type: Boolean, default: false },\n            },\n            { timestamps: true },\n        );\n    },\n    /**\n     * Creates a Mongoose schema with optional virtual fields and generic fields.\n     * This function creates a new Mongoose schema from the provided schema definition,\n     * optionally adds virtual fields, and includes generic fields (unless standalone is true).\n     *\n     * @param options - Configuration options including mongoose instance, schema definition, virtuals, and standalone flag.\n     * @param options.mongoose - The Mongoose instance to use for schema creation.\n     * @param options.schema - The schema definition object.\n     * @param options.virtuals - Optional array of virtual field configurations.\n     * @param options.standalone - Whether to exclude generic fields (default: false).\n     * @returns A configured Mongoose schema.\n     */\n    createSchema<T, R extends string = string>({\n        mongoose,\n        schema,\n        virtuals = [],\n        standalone = false,\n    }: I_CreateSchemaOptions<T, R>): T_MongooseShema<T> {\n        const createdSchema = new mongoose.Schema<T>(schema, {\n            toJSON: { virtuals: true }, // So `res.json()` and other `JSON.stringify()` functions include virtuals\n            toObject: { virtuals: true }, // So `console.log()` and other functions that use `toObject()` include virtuals\n        });\n\n        virtuals.forEach(({ name, options, get }) => {\n            if (mongo.isDynamicVirtual<T, R>(options)) {\n                const schemaStatics = createdSchema.statics as Record<string, unknown>;\n\n                if (!schemaStatics['_dynamicVirtuals']) {\n                    schemaStatics['_dynamicVirtuals'] = [];\n                }\n\n                (schemaStatics['_dynamicVirtuals'] as I_DynamicVirtualConfig<T>[]).push({\n                    name: name as string,\n                    options,\n                });\n\n                const virtualInstance = createdSchema.virtual(name as string);\n\n                if (get) {\n                    virtualInstance.get(get);\n                }\n                else {\n                    virtualInstance.get(function (this: T & { _populated?: { [key: string]: unknown } }) {\n                        return this._populated?.[name as string] || (options?.count ? 0 : (options?.justOne ? null : []));\n                    });\n                }\n            }\n            else {\n                const virtualInstance = createdSchema.virtual(name as string, options);\n\n                if (get) {\n                    virtualInstance.get(get);\n                }\n            }\n        });\n\n        if (!standalone) {\n            createdSchema.add(mongo.createGenericSchema(mongoose));\n        }\n\n        return createdSchema;\n    },\n    /**\n     * Creates a Mongoose model with plugins, middleware, and pagination support.\n     * This function creates a model from a schema with optional pagination and aggregation plugins,\n     * and applies any specified middleware. If a model with the same name already exists, it returns the existing model.\n     *\n     * @param options - Configuration options including mongoose instance, model name, schema, and feature flags.\n     * @param options.mongoose - The Mongoose instance to use for model creation.\n     * @param options.name - The name of the model to create.\n     * @param options.schema - The schema definition for the model.\n     * @param options.pagination - Whether to enable pagination plugin (default: false).\n     * @param options.aggregate - Whether to enable aggregation pagination plugin (default: false).\n     * @param options.virtuals - Optional array of virtual field configurations.\n     * @param options.middlewares - Optional array of middleware configurations.\n     * @returns A configured Mongoose model with extended functionality.\n     * @throws {Error} When the model name is not provided.\n     */\n    createModel<T extends Partial<C_Document>, R extends string = string>({\n        mongoose: currentMongooseInstance,\n        name,\n        schema,\n        virtuals = [],\n        pagination = true,\n        aggregate = true,\n        middlewares = [],\n    }: I_CreateModelOptions<T, R>): I_ExtendedModel<T> {\n        if (!name) {\n            throw new Error('Model name is required.');\n        }\n\n        if (currentMongooseInstance.models[name]) {\n            return currentMongooseInstance.models[name] as I_ExtendedModel<T>;\n        }\n\n        const createdSchema = mongo.createSchema({ mongoose: currentMongooseInstance, schema, virtuals });\n\n        if (pagination || aggregate) {\n            mongo.applyPlugins<T>(createdSchema, [\n                pagination && mongoosePaginate,\n                aggregate && aggregatePaginate,\n            ]);\n        }\n\n        mongo.applyMiddlewares<T>(createdSchema, middlewares);\n\n        const model = currentMongooseInstance.model<T>(name, createdSchema) as I_ExtendedModel<T>;\n\n        if (virtuals.length > 0) {\n            (model as any)._virtualConfigs = virtuals;\n        }\n\n        return model;\n    },\n    /**\n     * Validation utilities for Mongoose schemas.\n     * This object provides common validation functions that can be used in Mongoose schema definitions.\n     */\n    validator: {\n        /**\n         * Creates a required field validator.\n         * This function returns a validator that checks if a field value is not empty\n         * using the validate.isEmpty utility.\n         *\n         * @returns A validation function that returns true if the field is not empty.\n         */\n        isRequired<T>(): (this: T, value: unknown) => Promise<boolean> {\n            return async function (this: T, value: unknown): Promise<boolean> {\n                return !validate.isEmpty(value);\n            };\n        },\n        /**\n         * Creates a unique field validator.\n         * This function returns a validator that checks if a field value is unique\n         * across the specified fields in the collection.\n         *\n         * @param fields - An array of field names to check for uniqueness.\n         * @returns A validation function that returns true if the value is unique across the specified fields.\n         * @throws {Error} When fields is not a non-empty array of strings.\n         */\n        isUnique<T extends { constructor: { exists: (query: { [key: string]: unknown }) => Promise<unknown> } }>(fields: string[]) {\n            return async function (this: T, value: unknown): Promise<boolean> {\n                if (!Array.isArray(fields) || fields.length === 0) {\n                    throw new Error('Fields must be a non-empty array of strings.');\n                }\n\n                const query = { $or: fields.map(field => ({ [field]: value })) };\n                const existingDocument = await this.constructor.exists(query);\n\n                return !existingDocument;\n            };\n        },\n        /**\n         * Creates a regex pattern validator.\n         * This function returns a validator that checks if a string value matches\n         * all provided regular expressions.\n         *\n         * @param regexArray - An array of regular expressions to test against the value.\n         * @returns A validation function that returns true if the value matches all regex patterns.\n         * @throws {Error} When regexArray is not an array of valid RegExp objects.\n         */\n        matchesRegex(regexArray: RegExp[]): (value: string) => Promise<boolean> {\n            return async (value: string): Promise<boolean> => {\n                if (!Array.isArray(regexArray) || regexArray.some(r => !(r instanceof RegExp))) {\n                    throw new Error('regexArray must be an array of valid RegExp objects.');\n                }\n\n                return regexArray.every(regex => regex.test(value));\n            };\n        },\n    },\n    /**\n     * Migration utilities for MongoDB.\n     * This object extends the migrate-mongo library with additional configuration utilities.\n     */\n    migrate: {\n        /**\n         * Lazily loads the migrate-mongo module to avoid eager import overhead.\n         * Use this to access migrate-mongo methods (up, down, status, create) programmatically.\n         *\n         * @returns A promise resolving to the migrate-mongo module.\n         */\n        async getModule(): Promise<typeof migrate> {\n            return (await import('migrate-mongo')).default;\n        },\n        /**\n         * Sets the migration configuration and updates .gitignore.\n         * This function creates a migration configuration file and ensures it's properly\n         * excluded from version control.\n         *\n         * @param options - Migration configuration options to write to the config file.\n         */\n        setConfig: (options: Partial<migrate.config.Config> & { moduleSystem?: 'commonjs' | 'esm' }) => {\n            const optionsJS = `// This file is automatically generated by the Cyberskill CLI.\\nmodule.exports = ${JSON.stringify(options, null, 4)}`;\n\n            writeFileSync(PATH.MIGRATE_MONGO_CONFIG, optionsJS);\n\n            addGitIgnoreEntry(PATH.GIT_IGNORE, MIGRATE_MONGO_CONFIG);\n        },\n    },\n    /**\n     * Converts string values in a filter to regex patterns for case-insensitive search.\n     * This function recursively processes a filter object and converts string values in specified fields\n     * to MongoDB regex patterns that support accented character matching.\n     *\n     * @param filter - The filter object to process.\n     * @param fields - An array of field names to convert to regex patterns.\n     * @returns A new filter object with string values converted to regex patterns.\n     */\n    regexify<T>(filter?: T_QueryFilter<T>, fields?: (keyof T | string)[]): T_QueryFilter<T> {\n        if (!filter) {\n            return {} as T_QueryFilter<T>;\n        }\n\n        let newFilter = deepClone(filter);\n\n        if (!fields || fields.length === 0) {\n            return newFilter;\n        }\n\n        for (const field of fields) {\n            const path = field.toString().split('.');\n            const value = getNestedValue(newFilter, path);\n\n            if (typeof value === 'string' && value.length > 0) {\n                const regexValue = {\n                    $regex: `.*${regexSearchMapper(value)}.*`,\n                    $options: 'i',\n                };\n\n                newFilter = setNestedValue(newFilter, path, regexValue);\n            }\n        }\n\n        return newFilter;\n    },\n    /**\n     * Checks if a virtual options object has a dynamic ref function.\n     *\n     * @param options - The virtual options to check.\n     * @returns True if the options contain a dynamic ref function.\n     */\n    isDynamicVirtual<T, R extends string = string>(options?: T_VirtualOptions<T, R>): options is I_DynamicVirtualOptions<T, R> {\n        return Boolean(options && typeof options.ref === 'function');\n    },\n\n    /**\n     * Generic utility function to get new records from the database\n     * @param controller - MongoController instance\n     * @param recordsToCheck - Array of records to check\n     * @param filterFn - Function to determine if a record already exists\n     * @returns Array of records that don't exist in the database\n     */\n    async getNewRecords<T extends I_GenericDocument>(\n        controller: MongoController<T>,\n        recordsToCheck: T[],\n        filterFn: (existingRecord: T_WithId<T>, newRecord: T) => boolean,\n    ): Promise<T[]> {\n        const existingRecords = await controller.findAll({});\n\n        if (!existingRecords.success) {\n            return recordsToCheck;\n        }\n\n        const filteredRecords = recordsToCheck.filter(newRecord =>\n            !existingRecords.result.some((existingRecord: T_WithId<T>) =>\n                filterFn(existingRecord, newRecord),\n            ),\n        );\n\n        return filteredRecords;\n    },\n\n    /**\n     * Generic utility function to get existing records that match the filter criteria\n     * @param controller - MongoController instance\n     * @param recordsToCheck - Array of records to check\n     * @param filterFn - Function to determine if a record exists\n     * @returns Array of existing records that match the filter criteria\n     */\n    async getExistingRecords<T extends I_GenericDocument>(\n        controller: MongoController<T>,\n        recordsToCheck: T[],\n        filterFn: (existingRecord: T_WithId<T>, newRecord: T) => boolean,\n    ): Promise<T_WithId<T>[]> {\n        const existingRecords = await controller.findAll({});\n\n        if (!existingRecords.success) {\n            return [];\n        }\n\n        const foundRecords = existingRecords.result.filter((existingRecord: T_WithId<T>) =>\n            recordsToCheck.some((newRecord: T) =>\n                filterFn(existingRecord, newRecord),\n            ),\n        );\n\n        return foundRecords;\n    },\n};\n\nexport { applyNestedPopulate } from './mongo.populate.js';\n\n"],"names":["convertEnumToModelName","enumValue","mongo","randomUUID","schema","plugins","plugin","middlewares","method","pre","post","mongoose","virtuals","standalone","createdSchema","name","options","get","schemaStatics","virtualInstance","currentMongooseInstance","pagination","aggregate","mongoosePaginate","aggregatePaginate","model","value","validate","fields","query","field","regexArray","r","regex","optionsJS","writeFileSync","PATH","addGitIgnoreEntry","MIGRATE_MONGO_CONFIG","filter","newFilter","deepClone","path","getNestedValue","regexValue","regexSearchMapper","setNestedValue","controller","recordsToCheck","filterFn","existingRecords","newRecord","existingRecord"],"mappings":"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"}

package/dist/node/package/index.js

@@ -8,3 +8,4 @@ export {
   k as setupPackages,
   o as updatePackage
 };
+//# sourceMappingURL=index.js.map

package/dist/node/package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/node/package/package.test.unit.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/node/package/package.type.js

@@ -2,3 +2,4 @@ var D = /* @__PURE__ */ ((e) => (e.DEPENDENCY = "dependencies", e.DEV_DEPENDENCY
 export {
   D as E_PackageType
 };
+//# sourceMappingURL=package.type.js.map

package/dist/node/package/package.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.type.js","sources":["../../../src/node/package/package.type.ts"],"sourcesContent":["export interface I_PackageJson {\n    name?: string;\n    version?: string;\n    dependencies?: Record<string, string>;\n    devDependencies?: Record<string, string>;\n    [key: string]: unknown;\n}\n\nexport interface I_PackageInfo {\n    name: string;\n    currentVersion: string;\n    latestVersion: string;\n    isCurrentProject: boolean;\n    isInstalled: boolean;\n    isUpToDate: boolean;\n    isDependency: boolean;\n    isDevDependency: boolean;\n    installedPath: string;\n    file: I_PackageJson;\n}\n\nexport enum E_PackageType {\n    DEPENDENCY = 'dependencies',\n    DEV_DEPENDENCY = 'devDependencies',\n    PEER_DEPENDENCY = 'peerDependencies',\n    BUNDLE_DEPENDENCY = 'bundleDependencies',\n    OPTIONAL_DEPENDENCY = 'optionalDependencies',\n}\n\nexport interface I_PackageInput {\n    name: string;\n    type?: E_PackageType;\n}\n"],"names":["E_PackageType"],"mappings":"AAqBO,IAAKA,sBAAAA,OACRA,EAAA,aAAa,gBACbA,EAAA,iBAAiB,mBACjBA,EAAA,kBAAkB,oBAClBA,EAAA,oBAAoB,sBACpBA,EAAA,sBAAsB,wBALdA,IAAAA,KAAA,CAAA,CAAA;"}

package/dist/node/package/package.util.js

@@ -1,259 +1,230 @@
-import T from "node-fetch";
-import { E_PackageType as m } from "./package.type.js";
-import { pathExistsSync as h, readJsonSync as E, writeFileSync as j } from "../fs/fs.util.js";
-import { PATH as o, command as v, PACKAGE_JSON as O, NODE_MODULES as U } from "../path/path.constant.js";
-import { join as G } from "../path/path.util.js";
-import { catchError as u, log as J } from "../log/log.util.js";
-import { runCommand as P } from "../command/command.util.js";
-import { getEnv as K } from "../../config/env/env.util.js";
-var y = (e, t, n) => new Promise((r, i) => {
-  var a = (s) => {
-    try {
-      l(n.next(s));
-    } catch (c) {
-      i(c);
-    }
-  }, d = (s) => {
-    try {
-      l(n.throw(s));
-    } catch (c) {
-      i(c);
-    }
-  }, l = (s) => s.done ? r(s.value) : Promise.resolve(s.value).then(a, d);
-  l((n = n.apply(e, t)).next());
-});
-const w = K();
-function I(e) {
-  return y(this, null, function* () {
-    try {
-      const t = yield T(`https://registry.npmjs.org/${e}/latest`);
-      if (!t.ok)
-        throw new Error(`Failed to fetch latest version: ${t.status} ${t.statusText}`);
-      const { version: n } = yield t.json();
-      return {
-        success: !0,
-        result: n
-      };
-    } catch (t) {
-      return u(t);
-    }
-  });
+import { E_PackageType as c } from "./package.type.js";
+import { pathExistsSync as D, readJsonSync as p, writeFileSync as v } from "../fs/fs.util.js";
+import { PATH as a, command as y, PACKAGE_JSON as J, NODE_MODULES as S } from "../path/path.constant.js";
+import { join as T } from "../path/path.util.js";
+import { catchError as i, log as A } from "../log/log.util.js";
+import { runCommand as E } from "../command/command.util.js";
+import { getEnv as _ } from "../../config/env/env.util.js";
+const j = _();
+async function O(e) {
+  try {
+    const s = await fetch(`https://registry.npmjs.org/${e}/latest`);
+    if (!s.ok)
+      throw new Error(`Failed to fetch latest version: ${s.status} ${s.statusText}`);
+    const { version: r } = await s.json();
+    return {
+      success: !0,
+      result: r
+    };
+  } catch (s) {
+    return i(s);
+  }
 }
-function $(e) {
-  return y(this, null, function* () {
-    var t, n;
-    try {
-      if (!e) {
-        if (h(o.PACKAGE_JSON)) {
-          const N = E(o.PACKAGE_JSON), { name: S = "", version: A = "" } = N;
-          return {
-            success: !0,
-            result: {
-              name: S,
-              currentVersion: A,
-              latestVersion: A,
-              isCurrentProject: !0,
-              isInstalled: !0,
-              isUpToDate: !0,
-              isDependency: !1,
-              isDevDependency: !1,
-              installedPath: o.PACKAGE_JSON,
-              file: N
-            }
-          };
-        }
+async function U(e) {
+  try {
+    if (!e) {
+      if (D(a.PACKAGE_JSON)) {
+        const P = p(a.PACKAGE_JSON), { name: w = "", version: V = "" } = P;
         return {
           success: !0,
           result: {
-            name: "",
-            currentVersion: "",
-            latestVersion: "",
-            isCurrentProject: !1,
-            isInstalled: !1,
-            isUpToDate: !1,
-            isDependency: !1,
-            isDevDependency: !1,
-            installedPath: "",
-            file: {}
-          }
-        };
-      }
-      if (!h(o.PACKAGE_JSON))
-        return {
-          success: !0,
-          result: {
-            name: e.name,
-            currentVersion: "",
-            latestVersion: "",
-            isCurrentProject: !1,
-            isInstalled: !1,
-            isUpToDate: !1,
-            isDependency: e.type === m.DEPENDENCY,
-            isDevDependency: e.type === m.DEV_DEPENDENCY,
-            installedPath: "",
-            file: {}
-          }
-        };
-      const r = E(o.PACKAGE_JSON), { name: i, version: a = "", dependencies: d = {}, devDependencies: l = {} } = r;
-      if (e.name === i)
-        return {
-          success: !0,
-          result: {
-            name: i,
-            currentVersion: a,
-            latestVersion: a,
+            name: w,
+            currentVersion: V,
+            latestVersion: V,
             isCurrentProject: !0,
             isInstalled: !0,
             isUpToDate: !0,
-            isDependency: e.type === m.DEPENDENCY,
-            isDevDependency: e.type === m.DEV_DEPENDENCY,
-            installedPath: o.PACKAGE_JSON,
-            file: r
-          }
-        };
-      const s = e.name in d, c = e.name in l, f = yield I(e.name);
-      if (!f.success)
-        return {
-          success: !0,
-          result: {
-            name: e.name,
-            currentVersion: "",
-            latestVersion: "",
-            isCurrentProject: !1,
-            isInstalled: !1,
-            isUpToDate: !1,
-            isDependency: s,
-            isDevDependency: c,
-            installedPath: "",
-            file: {}
-          }
-        };
-      if (!s && !c)
-        return {
-          success: !0,
-          result: {
-            name: e.name,
-            currentVersion: "",
-            latestVersion: f.result,
-            isCurrentProject: !1,
-            isInstalled: !1,
-            isUpToDate: !1,
-            isDependency: e.type === m.DEPENDENCY,
-            isDevDependency: e.type === m.DEV_DEPENDENCY,
-            installedPath: "",
-            file: {}
-          }
-        };
-      const D = (n = (t = d[e.name]) != null ? t : l[e.name]) != null ? n : "", p = G(w.CWD, U, e.name, O);
-      if (!h(p))
-        return {
-          success: !0,
-          result: {
-            name: e.name,
-            currentVersion: "",
-            latestVersion: f.result,
-            isCurrentProject: !1,
-            isInstalled: !1,
-            isUpToDate: !1,
-            isDependency: s,
-            isDevDependency: c,
-            installedPath: "",
-            file: {}
+            isDependency: !1,
+            isDevDependency: !1,
+            installedPath: a.PACKAGE_JSON,
+            file: P
           }
         };
-      const C = E(p), { version: V = "" } = C;
-      return D !== V ? {
+      }
+      return {
+        success: !0,
+        result: {
+          name: "",
+          currentVersion: "",
+          latestVersion: "",
+          isCurrentProject: !1,
+          isInstalled: !1,
+          isUpToDate: !1,
+          isDependency: !1,
+          isDevDependency: !1,
+          installedPath: "",
+          file: {}
+        }
+      };
+    }
+    if (!D(a.PACKAGE_JSON))
+      return {
         success: !0,
         result: {
           name: e.name,
-          currentVersion: V || D,
-          latestVersion: f.result,
+          currentVersion: "",
+          latestVersion: "",
           isCurrentProject: !1,
+          isInstalled: !1,
+          isUpToDate: !1,
+          isDependency: e.type === c.DEPENDENCY,
+          isDevDependency: e.type === c.DEV_DEPENDENCY,
+          installedPath: "",
+          file: {}
+        }
+      };
+    const s = p(a.PACKAGE_JSON), { name: r, version: l = "", dependencies: u = {}, devDependencies: d = {} } = s;
+    if (e.name === r)
+      return {
+        success: !0,
+        result: {
+          name: r,
+          currentVersion: l,
+          latestVersion: l,
+          isCurrentProject: !0,
           isInstalled: !0,
+          isUpToDate: !0,
+          isDependency: e.type === c.DEPENDENCY,
+          isDevDependency: e.type === c.DEV_DEPENDENCY,
+          installedPath: a.PACKAGE_JSON,
+          file: s
+        }
+      };
+    const n = e.name in u, t = e.name in d, o = await O(e.name);
+    if (!o.success)
+      return {
+        success: !0,
+        result: {
+          name: e.name,
+          currentVersion: "",
+          latestVersion: "",
+          isCurrentProject: !1,
+          isInstalled: !1,
           isUpToDate: !1,
-          isDependency: s,
-          isDevDependency: c,
-          installedPath: p,
-          file: C
+          isDependency: n,
+          isDevDependency: t,
+          installedPath: "",
+          file: {}
         }
-      } : {
+      };
+    if (!n && !t)
+      return {
         success: !0,
         result: {
           name: e.name,
-          currentVersion: D,
-          latestVersion: f.result,
+          currentVersion: "",
+          latestVersion: o.result,
           isCurrentProject: !1,
-          isInstalled: !0,
-          isUpToDate: D === f.result,
-          isDependency: s,
-          isDevDependency: c,
-          installedPath: p,
-          file: C
+          isInstalled: !1,
+          isUpToDate: !1,
+          isDependency: e.type === c.DEPENDENCY,
+          isDevDependency: e.type === c.DEV_DEPENDENCY,
+          installedPath: "",
+          file: {}
         }
       };
-    } catch (r) {
-      return u(r);
-    }
-  });
+    const f = u[e.name] ?? d[e.name] ?? "", m = T(j.CWD, S, e.name, J);
+    if (!D(m))
+      return {
+        success: !0,
+        result: {
+          name: e.name,
+          currentVersion: "",
+          latestVersion: o.result,
+          isCurrentProject: !1,
+          isInstalled: !1,
+          isUpToDate: !1,
+          isDependency: n,
+          isDevDependency: t,
+          installedPath: "",
+          file: {}
+        }
+      };
+    const h = p(m), { version: C = "" } = h;
+    return f !== C ? {
+      success: !0,
+      result: {
+        name: e.name,
+        currentVersion: C || f,
+        latestVersion: o.result,
+        isCurrentProject: !1,
+        isInstalled: !0,
+        isUpToDate: !1,
+        isDependency: n,
+        isDevDependency: t,
+        installedPath: m,
+        file: h
+      }
+    } : {
+      success: !0,
+      result: {
+        name: e.name,
+        currentVersion: f,
+        latestVersion: o.result,
+        isCurrentProject: !1,
+        isInstalled: !0,
+        isUpToDate: f === o.result,
+        isDependency: n,
+        isDevDependency: t,
+        installedPath: m,
+        file: h
+      }
+    };
+  } catch (s) {
+    return i(s);
+  }
 }
-function _(e) {
-  return y(this, null, function* () {
-    var t, n;
+async function N(e) {
+  try {
+    const s = p(a.PACKAGE_JSON), r = s.dependencies ?? {}, l = s.devDependencies ?? {};
+    e.isDependency ? r[e.name] = e.latestVersion : e.isDevDependency && (l[e.name] = e.latestVersion), v(a.PACKAGE_JSON, JSON.stringify(s, null, 4)), A.info(`Updated "${e.name}" to version ${e.latestVersion}`);
+  } catch (s) {
+    i(s);
+  }
+}
+async function G() {
+  try {
     try {
-      const r = E(o.PACKAGE_JSON), i = (t = r.dependencies) != null ? t : {}, a = (n = r.devDependencies) != null ? n : {};
-      e.isDependency ? i[e.name] = e.latestVersion : e.isDevDependency && (a[e.name] = e.latestVersion), j(o.PACKAGE_JSON, JSON.stringify(r, null, 4)), J.info(`Updated "${e.name}" to version ${e.latestVersion}`);
-    } catch (r) {
-      u(r);
+      const e = await y.pnpmInstallStandard();
+      await E(`Installing dependencies (standard) using: ${e}`, e);
+      return;
+    } catch (e) {
+      i(e);
     }
-  });
-}
-function g() {
-  return y(this, null, function* () {
     try {
-      try {
-        const e = yield v.pnpmInstallStandard();
-        yield P(`Installing dependencies (standard) using: ${e}`, e);
-        return;
-      } catch (e) {
-        u(e);
-      }
-      try {
-        const e = yield v.pnpmInstallLegacy();
-        yield P(`Retrying with legacy peer dependencies using: ${e}`, e);
-        return;
-      } catch (e) {
-        u(e);
-      }
-      try {
-        const e = yield v.pnpmInstallForce();
-        yield P(`Retrying with force install using: ${e}`, e);
-      } catch (e) {
-        u(e);
-      }
+      const e = await y.pnpmInstallLegacy();
+      await E(`Retrying with legacy peer dependencies using: ${e}`, e);
+      return;
     } catch (e) {
-      u(e);
+      i(e);
     }
-  });
-}
-function M(e, t) {
-  return y(this, null, function* () {
-    var n;
     try {
-      if (!h(o.PACKAGE_JSON)) {
-        J.error("package.json not found. Aborting setup.");
-        return;
-      }
-      const i = (yield Promise.all(e.map($))).filter((s) => s.success && !!s.result && !s.result.isCurrentProject).map((s) => s.result), a = i.filter((s) => !s.isInstalled), d = i.filter((s) => !s.isUpToDate), l = [];
-      t != null && t.install && a.length > 0 && l.push(...a.map(_)), t != null && t.update && d.length > 0 && l.push(...d.map(_)), l.length > 0 && (yield Promise.all(l), yield g(), yield P("Running ESLint with auto-fix", yield v.eslintFix())), yield (n = t == null ? void 0 : t.callback) == null ? void 0 : n.call(t);
-    } catch (r) {
-      u(r);
+      const e = await y.pnpmInstallForce();
+      await E(`Retrying with force install using: ${e}`, e);
+    } catch (e) {
+      i(e);
+    }
+  } catch (e) {
+    i(e);
+  }
+}
+async function L(e, s) {
+  try {
+    if (!D(a.PACKAGE_JSON)) {
+      A.error("package.json not found. Aborting setup.");
+      return;
     }
-  });
+    const l = (await Promise.all(e.map(U))).filter((t) => t.success && !!t.result && !t.result.isCurrentProject).map((t) => t.result), u = l.filter((t) => !t.isInstalled), d = l.filter((t) => !t.isUpToDate), n = [];
+    s?.install && u.length > 0 && n.push(...u.map(N)), s?.update && d.length > 0 && n.push(...d.map(N)), n.length > 0 && (await Promise.all(n), await G(), await E("Running ESLint with auto-fix", await y.eslintFix())), await s?.callback?.();
+  } catch (r) {
+    i(r);
+  }
 }
 export {
-  I as getLatestPackageVersion,
-  $ as getPackage,
-  g as installDependencies,
-  M as setupPackages,
-  _ as updatePackage
+  O as getLatestPackageVersion,
+  U as getPackage,
+  G as installDependencies,
+  L as setupPackages,
+  N as updatePackage
 };
+//# sourceMappingURL=package.util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package.util.js","sources":["../../../src/node/package/package.util.ts"],"sourcesContent":["import type { I_Return } from '#typescript/index.js';\n\nimport { getEnv } from '#config/env/index.js';\n\nimport type { I_PackageInfo, I_PackageInput, I_PackageJson } from './package.type.js';\n\nimport { runCommand } from '../command/index.js';\nimport { pathExistsSync, readJsonSync, writeFileSync } from '../fs/index.js';\nimport { catchError, log } from '../log/index.js';\nimport { command, join, NODE_MODULES, PACKAGE_JSON, PATH } from '../path/index.js';\nimport { E_PackageType } from './package.type.js';\n\nconst env = getEnv();\n\n/**\n * Fetches the latest version of a package from the npm registry.\n * This function makes an HTTP request to the npm registry to get the latest version\n * information for a specified package.\n *\n * @param packageName - The name of the package to fetch the latest version for.\n * @returns A promise that resolves to a standardized response with the latest version string.\n */\nexport async function getLatestPackageVersion(packageName: string): Promise<I_Return<string>> {\n    try {\n        const res = await fetch(`https://registry.npmjs.org/${packageName}/latest`);\n\n        if (!res.ok) {\n            throw new Error(`Failed to fetch latest version: ${res.status} ${res.statusText}`);\n        }\n\n        const { version } = await res.json() as { version: string };\n\n        return {\n            success: true,\n            result: version,\n        };\n    }\n    catch (error) {\n        return catchError<string>(error);\n    }\n}\n\n/**\n * Retrieves comprehensive information about a package.\n * This function analyzes package information including:\n * - Current and latest versions\n * - Installation status and location\n * - Dependency type (regular, dev, peer, etc.)\n * - Whether it's the current project or an external dependency\n *\n * @param inputPackage - Optional package input configuration. If not provided, returns current project info.\n * @returns A promise that resolves to a standardized response with detailed package information.\n */\nexport async function getPackage(inputPackage?: I_PackageInput): Promise<I_Return<I_PackageInfo>> {\n    try {\n        if (!inputPackage) {\n            if (pathExistsSync(PATH.PACKAGE_JSON)) {\n                const packageJson = readJsonSync(PATH.PACKAGE_JSON) as I_PackageJson;\n                const { name = '', version = '' } = packageJson;\n\n                return {\n                    success: true,\n                    result: {\n                        name,\n                        currentVersion: version,\n                        latestVersion: version,\n                        isCurrentProject: true,\n                        isInstalled: true,\n                        isUpToDate: true,\n                        isDependency: false,\n                        isDevDependency: false,\n                        installedPath: PATH.PACKAGE_JSON,\n                        file: packageJson,\n                    },\n                };\n            }\n            return {\n                success: true,\n                result: {\n                    name: '',\n                    currentVersion: '',\n                    latestVersion: '',\n                    isCurrentProject: false,\n                    isInstalled: false,\n                    isUpToDate: false,\n                    isDependency: false,\n                    isDevDependency: false,\n                    installedPath: '',\n                    file: {},\n                },\n            };\n        }\n\n        // if package.json does not exist\n        if (!pathExistsSync(PATH.PACKAGE_JSON)) {\n            return {\n                success: true,\n                result: {\n                    name: inputPackage.name,\n                    currentVersion: '',\n                    latestVersion: '',\n                    isCurrentProject: false,\n                    isInstalled: false,\n                    isUpToDate: false,\n                    isDependency: inputPackage.type === E_PackageType.DEPENDENCY,\n                    isDevDependency: inputPackage.type === E_PackageType.DEV_DEPENDENCY,\n                    installedPath: '',\n                    file: {},\n                },\n            };\n        }\n\n        const packageJson = readJsonSync(PATH.PACKAGE_JSON) as I_PackageJson;\n\n        const { name, version = '', dependencies = {}, devDependencies = {} } = packageJson;\n\n        // if it's the current project\n        if (inputPackage.name === name) {\n            return {\n                success: true,\n                result: {\n                    name,\n                    currentVersion: version,\n                    latestVersion: version,\n                    isCurrentProject: true,\n                    isInstalled: true,\n                    isUpToDate: true,\n                    isDependency: inputPackage.type === E_PackageType.DEPENDENCY,\n                    isDevDependency: inputPackage.type === E_PackageType.DEV_DEPENDENCY,\n                    installedPath: PATH.PACKAGE_JSON,\n                    file: packageJson,\n                },\n            };\n        }\n\n        const isDependency = inputPackage.name in dependencies;\n\n        const isDevDependency = inputPackage.name in devDependencies;\n\n        const latestVersionFound = await getLatestPackageVersion(inputPackage.name);\n\n        if (!latestVersionFound.success) {\n            return {\n                success: true,\n                result: {\n                    name: inputPackage.name,\n                    currentVersion: '',\n                    latestVersion: '',\n                    isCurrentProject: false,\n                    isInstalled: false,\n                    isUpToDate: false,\n                    isDependency,\n                    isDevDependency,\n                    installedPath: '',\n                    file: {},\n                },\n            };\n        }\n\n        // if it's not a dependency or devDependency\n        if (!isDependency && !isDevDependency) {\n            return {\n                success: true,\n                result: {\n                    name: inputPackage.name,\n                    currentVersion: '',\n                    latestVersion: latestVersionFound.result,\n                    isCurrentProject: false,\n                    isInstalled: false,\n                    isUpToDate: false,\n                    isDependency: inputPackage.type === E_PackageType.DEPENDENCY,\n                    isDevDependency: inputPackage.type === E_PackageType.DEV_DEPENDENCY,\n                    installedPath: '',\n                    file: {},\n                },\n            };\n        }\n\n        const packageJsonVersion = dependencies[inputPackage.name] ?? devDependencies[inputPackage.name] ?? '';\n        const dependencyPackageJsonPath = join(env.CWD, NODE_MODULES, inputPackage.name, PACKAGE_JSON);\n\n        // if package does not exist in node_modules\n        if (!pathExistsSync(dependencyPackageJsonPath)) {\n            return {\n                success: true,\n                result: {\n                    name: inputPackage.name,\n                    currentVersion: '',\n                    latestVersion: latestVersionFound.result,\n                    isCurrentProject: false,\n                    isInstalled: false,\n                    isUpToDate: false,\n                    isDependency,\n                    isDevDependency,\n                    installedPath: '',\n                    file: {},\n                },\n            };\n        }\n\n        const dependencyPackageJson = readJsonSync(dependencyPackageJsonPath) as I_PackageJson;\n\n        const { version: dependencyVersion = '' } = dependencyPackageJson;\n\n        // if version in package.json is different from version in node_modules\n        if (packageJsonVersion !== dependencyVersion) {\n            return {\n                success: true,\n                result: {\n                    name: inputPackage.name,\n                    currentVersion: dependencyVersion || packageJsonVersion,\n                    latestVersion: latestVersionFound.result,\n                    isCurrentProject: false,\n                    isInstalled: true,\n                    isUpToDate: false,\n                    isDependency,\n                    isDevDependency,\n                    installedPath: dependencyPackageJsonPath,\n                    file: dependencyPackageJson,\n                },\n            };\n        }\n\n        // if version in package.json is the same as version in node_modules\n        return {\n            success: true,\n            result: {\n                name: inputPackage.name,\n                currentVersion: packageJsonVersion,\n                latestVersion: latestVersionFound.result,\n                isCurrentProject: false,\n                isInstalled: true,\n                isUpToDate: packageJsonVersion === latestVersionFound.result,\n                isDependency,\n                isDevDependency,\n                installedPath: dependencyPackageJsonPath,\n                file: dependencyPackageJson,\n            },\n        };\n    }\n    catch (error) {\n        return catchError<I_PackageInfo>(error);\n    }\n}\n\n/**\n * Updates a package to its latest version in package.json.\n * This function modifies the package.json file to update the specified package\n * to its latest version and logs the update action.\n *\n * @param packageInfo - The package information containing the latest version to update to.\n * @returns A promise that resolves when the update is complete.\n */\nexport async function updatePackage(packageInfo: I_PackageInfo): Promise<void> {\n    try {\n        const packageJson = readJsonSync(PATH.PACKAGE_JSON) as I_PackageJson;\n\n        const dependencies = packageJson.dependencies ?? {};\n        const devDependencies = packageJson.devDependencies ?? {};\n\n        if (packageInfo.isDependency) {\n            dependencies[packageInfo.name] = packageInfo.latestVersion;\n        }\n        else if (packageInfo.isDevDependency) {\n            devDependencies[packageInfo.name] = packageInfo.latestVersion;\n        }\n\n        writeFileSync(PATH.PACKAGE_JSON, JSON.stringify(packageJson, null, 4));\n\n        log.info(`Updated \"${packageInfo.name}\" to version ${packageInfo.latestVersion}`);\n    }\n    catch (error) {\n        catchError(error);\n    }\n}\n\n/**\n * Installs project dependencies using pnpm with fallback strategies.\n * This function attempts to install dependencies using different pnpm strategies:\n * 1. Standard installation\n * 2. Legacy peer dependencies mode\n * 3. Force installation mode\n *\n * @returns A promise that resolves when the installation is complete.\n */\nexport async function installDependencies(): Promise<void> {\n    try {\n        try {\n            const cmd = await command.pnpmInstallStandard();\n            await runCommand(`Installing dependencies (standard) using: ${cmd}`, cmd);\n            return;\n        }\n        catch (error) {\n            catchError(error);\n        }\n\n        try {\n            const cmd = await command.pnpmInstallLegacy();\n            await runCommand(`Retrying with legacy peer dependencies using: ${cmd}`, cmd);\n            return;\n        }\n        catch (error) {\n            catchError(error);\n        }\n\n        try {\n            const cmd = await command.pnpmInstallForce();\n            await runCommand(`Retrying with force install using: ${cmd}`, cmd);\n        }\n        catch (error) {\n            catchError(error);\n        }\n    }\n    catch (error) {\n        catchError(error);\n    }\n}\n\n/**\n * Sets up multiple packages with optional installation and update operations.\n * This function provides a comprehensive package management workflow that can:\n * - Install missing packages\n * - Update outdated packages\n * - Execute custom callbacks after package operations\n * - Run ESLint fixes after package changes\n *\n * @param packages - An array of package inputs to set up.\n * @param options - Optional configuration for installation, updates, and callbacks.\n * @param options.install - Whether to install missing packages (default: false).\n * @param options.update - Whether to update outdated packages (default: false).\n * @param options.callback - Optional callback function to execute after package operations.\n * @returns A promise that resolves when all package operations are complete.\n */\nexport async function setupPackages(\n    packages: I_PackageInput[],\n    options?: {\n        install?: boolean;\n        update?: boolean;\n        callback?: () => Promise<void>;\n    },\n): Promise<void> {\n    try {\n        if (!pathExistsSync(PATH.PACKAGE_JSON)) {\n            log.error('package.json not found. Aborting setup.');\n            return;\n        }\n\n        const packagesData = await Promise.all(packages.map(getPackage));\n\n        const validPackages = packagesData\n            .filter((pkg): pkg is { success: true; result: I_PackageInfo } => pkg.success && Boolean(pkg.result) && !pkg.result.isCurrentProject)\n            .map(pkg => pkg.result);\n\n        const packagesToInstall = validPackages.filter(pkg => !pkg.isInstalled);\n        const packagesToUpdate = validPackages.filter(pkg => !pkg.isUpToDate);\n\n        const tasks: Promise<void>[] = [];\n\n        if (options?.install && packagesToInstall.length > 0) {\n            tasks.push(...packagesToInstall.map(updatePackage));\n        }\n\n        if (options?.update && packagesToUpdate.length > 0) {\n            tasks.push(...packagesToUpdate.map(updatePackage));\n        }\n\n        if (tasks.length > 0) {\n            await Promise.all(tasks);\n            await installDependencies();\n            await runCommand('Running ESLint with auto-fix', await command.eslintFix());\n        }\n\n        await options?.callback?.();\n    }\n    catch (error) {\n        catchError(error);\n    }\n}\n"],"names":["env","getEnv","getLatestPackageVersion","packageName","res","version","error","catchError","getPackage","inputPackage","pathExistsSync","PATH","packageJson","readJsonSync","name","E_PackageType","dependencies","devDependencies","isDependency","isDevDependency","latestVersionFound","packageJsonVersion","dependencyPackageJsonPath","join","NODE_MODULES","PACKAGE_JSON","dependencyPackageJson","dependencyVersion","updatePackage","packageInfo","writeFileSync","log","installDependencies","cmd","command","runCommand","setupPackages","packages","options","validPackages","pkg","packagesToInstall","packagesToUpdate","tasks"],"mappings":"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"}