@git.zone/cli 2.19.4 → 2.19.6

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@git.zone/cli',
-  version: '2.19.4',
+  version: '2.19.6',
   description: 'A comprehensive CLI tool for enhancing and managing local development workflows with gitzone utilities, focusing on project setup, version control, code formatting, and template management.'
 }

package/ts/classes.gitzoneconfig.ts

@@ -35,7 +35,7 @@ export class GitzoneConfig {
     return gitzoneConfig;
   }
 
-  public data: IGitzoneConfigData;
+  public data!: IGitzoneConfigData;
 
   public async readConfigFromCwd() {
     const smartconfigInstance = new plugins.smartconfig.Smartconfig(paths.cwd);

package/ts/gitzone.cli.ts

@@ -105,7 +105,7 @@ export let run = async () => {
   const rawCliMode = await getRawCliMode();
 
   // get packageInfo
-  const projectInfo = new plugins.projectinfo.ProjectInfo(paths.packageDir);
+  const projectInfo = await plugins.projectinfo.ProjectInfo.create(paths.packageDir);
   const projectInfoVersion = (projectInfo.npm as any)?.version;
   const packageVersion =
     typeof projectInfoVersion === "string" && projectInfoVersion.length > 0

package/ts/helpers.changelog.ts

@@ -19,6 +19,12 @@ export interface IPendingChangelog {
   isEmpty: boolean;
 }
 
+interface IChangelogSection {
+  start: number;
+  bodyStart: number;
+  end: number;
+}
+
 const bucketForCommitType = (commitType: string): TChangelogBucket => {
   switch (commitType) {
     case "BREAKING CHANGE":
@@ -48,7 +54,7 @@ const writeChangelog = async (filePath: string, content: string): Promise<void>
 const findPendingSection = (
   content: string,
   sectionName: string,
-): { start: number; bodyStart: number; end: number } | null => {
+): IChangelogSection | null => {
   const headingRegex = new RegExp(`^##\\s+${sectionName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*$`, "m");
   const match = headingRegex.exec(content);
   if (!match || match.index === undefined) {
@@ -123,9 +129,11 @@ export const readPendingChangelog = async (
   filePath: string,
   sectionName = "Pending",
 ): Promise<IPendingChangelog> => {
-  const content = await ensurePendingSection(filePath, sectionName);
-  const pendingSection = findPendingSection(content, sectionName)!;
-  const block = content.slice(pendingSection.bodyStart, pendingSection.end).trim();
+  const content = await readChangelog(filePath);
+  const pendingSection = findPendingSection(content, sectionName);
+  const block = pendingSection
+    ? content.slice(pendingSection.bodyStart, pendingSection.end).trim()
+    : "";
   return {
     block,
     isEmpty: block.length === 0,
@@ -149,8 +157,11 @@ export const movePendingToVersion = async (
   version: string,
   dateString: string,
 ): Promise<void> => {
-  let content = await ensurePendingSection(filePath, sectionName);
-  const pendingSection = findPendingSection(content, sectionName)!;
+  let content = await readChangelog(filePath);
+  const pendingSection = findPendingSection(content, sectionName);
+  if (!pendingSection) {
+    throw new Error("No pending changelog entries. Nothing to release.");
+  }
   const pendingBlock = content.slice(pendingSection.bodyStart, pendingSection.end).trim();
   if (!pendingBlock) {
     throw new Error("No pending changelog entries. Nothing to release.");
@@ -159,7 +170,10 @@ export const movePendingToVersion = async (
   const renderedHeading = versionHeading
     .replaceAll("{{version}}", version)
     .replaceAll("{{date}}", dateString);
-  const nextContent = content.slice(pendingSection.end).replace(/^\n+/, "");
-  content = `${content.slice(0, pendingSection.bodyStart)}\n\n${renderedHeading}\n\n${pendingBlock}\n\n${nextContent}`;
+  const beforePending = content.slice(0, pendingSection.start).trimEnd();
+  const afterPending = content.slice(pendingSection.end).replace(/^\n+/, "").trimEnd();
+  content = [beforePending, renderedHeading, pendingBlock, afterPending]
+    .filter((block) => block.length > 0)
+    .join("\n\n");
   await writeChangelog(filePath, content);
 };

package/ts/mod_commit/mod.helpers.ts

@@ -27,7 +27,8 @@ export async function detectCurrentBranch(): Promise<string> {
     logger.log('info', `Detected current branch: ${branchName}`);
     return branchName;
   } catch (error) {
-    logger.log('warn', `Failed to detect branch: ${error.message}, falling back to "master"`);
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    logger.log('warn', `Failed to detect branch: ${errorMessage}, falling back to "master"`);
     return 'master';
   }
 }
@@ -225,6 +226,7 @@ export async function bumpProjectVersion(
 
     return newVersion;
   } catch (error) {
-    throw new Error(`Failed to bump project version: ${error.message}`);
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to bump project version: ${errorMessage}`);
   }
 }

package/ts/mod_format/classes.diffreporter.ts

@@ -42,9 +42,10 @@ export class DiffReporter {
         change.content,
       );
     } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
       logger.log(
         'error',
-        `Failed to generate diff for ${change.path}: ${error.message}`,
+        `Failed to generate diff for ${change.path}: ${errorMessage}`,
       );
       return null;
     }

package/ts/mod_format/formatters/copy.formatter.ts

@@ -93,7 +93,8 @@ export class CopyFormatter extends BaseFormatter {
           }
         }
       } catch (error) {
-        logVerbose(`Failed to process pattern ${pattern.from}: ${error.message}`);
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logVerbose(`Failed to process pattern ${pattern.from}: ${errorMessage}`);
       }
     }
 

package/ts/mod_format/formatters/packagejson.formatter.ts

@@ -94,7 +94,8 @@ export class PackageJsonFormatter extends BaseFormatter {
       packageJson.pnpm = packageJson.pnpm || {};
       packageJson.pnpm.overrides = overrides;
     } catch (error) {
-      logVerbose(`Could not read overrides.json: ${error.message}`);
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      logVerbose(`Could not read overrides.json: ${errorMessage}`);
     }
 
     const newContent = JSON.stringify(packageJson, null, 2);

package/ts/mod_format/formatters/templates.formatter.ts

@@ -117,7 +117,8 @@ export class TemplatesFormatter extends BaseFormatter {
     try {
       renderedFiles = await this.renderTemplate(templateName);
     } catch (error) {
-      logVerbose(`Failed to render template ${templateName}: ${error.message}`);
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      logVerbose(`Failed to render template ${templateName}: ${errorMessage}`);
       return changes;
     }
 

package/ts/mod_format/formatters/tsconfig.formatter.ts

@@ -46,7 +46,8 @@ export class TsconfigFormatter extends BaseFormatter {
         ];
       }
     } catch (error) {
-      logVerbose(`Could not get tspublish modules: ${error.message}`);
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      logVerbose(`Could not get tspublish modules: ${errorMessage}`);
     }
 
     tsconfigObject.compilerOptions.paths = { ...existingPaths, ...tspublishPaths };

package/ts/mod_meta/meta.classes.meta.ts

@@ -26,7 +26,7 @@ export class Meta {
   /**
    * the meta repo data
    */
-  public metaRepoData: interfaces.IMetaRepoData;
+  public metaRepoData!: interfaces.IMetaRepoData;
   public smartshellInstance = new plugins.smartshell.Smartshell({
     executor: 'bash',
   });

package/ts/mod_open/index.ts

@@ -1,8 +1,8 @@
 import * as plugins from './mod.plugins.js';
 import * as paths from '../paths.js';
 
-export let run = (argvArg) => {
-  let projectInfo = new plugins.projectinfo.ProjectInfo(paths.cwd);
+export let run = async (argvArg) => {
+  let projectInfo = await plugins.projectinfo.ProjectInfo.create(paths.cwd);
   if (argvArg._[1] === 'ci') {
     plugins.smartopen.openUrl(
       `https://gitlab.com/${projectInfo.git.gituser}/${projectInfo.git.gitrepo}/settings/ci_cd`,

package/ts/mod_services/classes.dockercontainer.ts

@@ -148,7 +148,8 @@ export class DockerContainer {
       const result = await this.smartshell.exec(command);
       return result.exitCode === 0;
     } catch (error) {
-      logger.log('error', `Failed to run container: ${error.message}`);
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      logger.log('error', `Failed to run container: ${errorMessage}`);
       return false;
     }
   }
@@ -177,7 +178,8 @@ export class DockerContainer {
       const result = await this.smartshell.exec(`docker logs ${tailFlag} ${containerName}`);
       return result.stdout;
     } catch (error) {
-      return `Error getting logs: ${error.message}`;
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      return `Error getting logs: ${errorMessage}`;
     }
   }
   
@@ -258,4 +260,4 @@ export class DockerContainer {
       return null;
     }
   }
-}
+}

package/ts/mod_services/classes.serviceconfiguration.ts

@@ -28,7 +28,7 @@ export interface IServiceConfig {
 
 export class ServiceConfiguration {
   private configPath: string;
-  private config: IServiceConfig;
+  private config!: IServiceConfig;
   private docker: DockerContainer;
   
   constructor() {
@@ -515,4 +515,4 @@ export class ServiceConfiguration {
     logger.log('info', `  📍 S3 Console: ${s3ConsolePort}`);
     logger.log('info', `  📍 Elasticsearch: ${esPort}`);
   }
-}
+}

package/ts/mod_services/classes.servicemanager.ts

@@ -61,13 +61,15 @@ export class ServiceManager {
         default: ['mongodb', 'minio', 'elasticsearch']
       });
 
-      this.enabledServices = response.value || ['mongodb', 'minio', 'elasticsearch'];
+      const enabledServices = response.value || ['mongodb', 'minio', 'elasticsearch'];
+      this.enabledServices = enabledServices;
 
       // Save to .smartconfig.json
-      await this.saveServiceConfiguration(this.enabledServices);
+      await this.saveServiceConfiguration(enabledServices);
     } else {
-      this.enabledServices = gitzoneConfig.services;
-      logger.log('info', `🔧 Enabled services: ${this.enabledServices.join(', ')}`);
+      const enabledServices = gitzoneConfig.services as string[];
+      this.enabledServices = enabledServices;
+      logger.log('info', `🔧 Enabled services: ${enabledServices.join(', ')}`);
     }
   }
 
@@ -902,10 +904,11 @@ export class ServiceManager {
       default: currentServices
     });
 
-    this.enabledServices = response.value || ['mongodb', 'minio', 'elasticsearch'];
+    const enabledServices = response.value || ['mongodb', 'minio', 'elasticsearch'];
+    this.enabledServices = enabledServices;
 
     // Save to .smartconfig.json
-    await this.saveServiceConfiguration(this.enabledServices);
+    await this.saveServiceConfiguration(enabledServices);
 
     logger.log('ok', '✅ Service configuration updated');
   }

package/ts/mod_template/index.ts

@@ -15,7 +15,7 @@ export const isTemplate = async (templateNameArg: string) => {
 };
 
 export const getTemplate = async (templateNameArg: string) => {
-  if (isTemplate(templateNameArg)) {
+  if (await isTemplate(templateNameArg)) {
     const localScafTemplate = new plugins.smartscaf.ScafTemplate(
       getTemplatePath(templateNameArg),
     );
@@ -50,6 +50,10 @@ export const run = async (argvArg: any) => {
   }
 
   const localScafTemplate = await getTemplate(chosenTemplate);
+  if (!localScafTemplate) {
+    logger.log('error', `Template ${chosenTemplate} not available`);
+    return;
+  }
   await localScafTemplate.askCliForMissingVariables();
   await localScafTemplate.writeToDisk(paths.cwd);
 };

package/ts/mod_tools/classes.packagemanager.ts

@@ -70,7 +70,7 @@ export class PackageManagerUtil {
     }
 
     const currentVersion = await this.getCurrentPnpmVersion();
-    const latestVersion = await this.getLatestVersion("pnpm", [
+    const latestVersion = await this.getLatestMatureVersion("pnpm", [
       "https://registry.npmjs.org",
     ]);
 
@@ -371,6 +371,51 @@ export class PackageManagerUtil {
     return null;
   }
 
+  public async getLatestMatureVersion(
+    packageName: string,
+    registries = [
+      "https://verdaccio.lossless.digital",
+      "https://registry.npmjs.org",
+    ],
+  ): Promise<string | null> {
+    const minimumReleaseAgeMinutes = await this.getMinimumReleaseAgeMinutes();
+
+    for (const registry of registries) {
+      const metadata = await this.getPackageMetadataFromRegistry(
+        registry,
+        packageName,
+      );
+      if (!metadata) {
+        continue;
+      }
+
+      const latest = getLatestVersionFromMetadata(metadata);
+      if (!latest && !minimumReleaseAgeMinutes) {
+        continue;
+      }
+      if (!minimumReleaseAgeMinutes) {
+        return latest;
+      }
+
+      const minimumReleaseAgeExcluded = latest
+        ? await this.isMinimumReleaseAgeExcluded(packageName, latest)
+        : false;
+      if (latest && minimumReleaseAgeExcluded) {
+        return latest;
+      }
+
+      const matureLatest = getLatestMatureVersionFromMetadata(
+        metadata,
+        minimumReleaseAgeMinutes,
+      );
+      if (matureLatest) {
+        return matureLatest;
+      }
+    }
+
+    return null;
+  }
+
   public async installLatest(
     packageName: string,
     version = "latest",
@@ -484,6 +529,42 @@ export class PackageManagerUtil {
     return this.shell.execSilent(`${pnpmCommand} ${commandArgs}`);
   }
 
+  private async getMinimumReleaseAgeMinutes(): Promise<number> {
+    try {
+      const result = await this.execPnpmSilent(
+        "config get minimum-release-age 2>/dev/null",
+      );
+      const rawValue = result?.stdout.trim() || "";
+      const value = Number.parseInt(rawValue, 10);
+      if (Number.isFinite(value) && value >= 0) {
+        return value;
+      }
+
+      const currentVersion = await this.getCurrentPnpmVersion();
+      return getDefaultMinimumReleaseAgeMinutes(currentVersion);
+    } catch {
+      const currentVersion = await this.getCurrentPnpmVersion();
+      return getDefaultMinimumReleaseAgeMinutes(currentVersion);
+    }
+  }
+
+  private async isMinimumReleaseAgeExcluded(
+    packageName: string,
+    version: string,
+  ): Promise<boolean> {
+    try {
+      const result = await this.execPnpmSilent(
+        "config get minimum-release-age-exclude 2>/dev/null",
+      );
+      const rawPatterns = parsePnpmConfigStringList(result?.stdout || "");
+      return rawPatterns.some((pattern) =>
+        packageSelectorMatches(packageName, version, pattern),
+      );
+    } catch {
+      return false;
+    }
+  }
+
   private async getPnpmListProjects(): Promise<IPnpmListProject[]> {
     try {
       const result = await this.execPnpmSilent(
@@ -710,6 +791,17 @@ export class PackageManagerUtil {
     registry: string,
     packageName: string,
   ): Promise<string | null> {
+    const data = await this.getPackageMetadataFromRegistry(
+      registry,
+      packageName,
+    );
+    return data ? getLatestVersionFromMetadata(data) : null;
+  }
+
+  private async getPackageMetadataFromRegistry(
+    registry: string,
+    packageName: string,
+  ): Promise<any | null> {
     const encodedName = packageName.replace("/", "%2f");
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), 8000);
@@ -724,9 +816,7 @@ export class PackageManagerUtil {
       if (!response.ok) {
         return null;
       }
-      const data = await response.json();
-      const latest = (data as any)["dist-tags"]?.latest;
-      return typeof latest === "string" && latest.length > 0 ? latest : null;
+      return await response.json();
     } catch {
       return null;
     } finally {
@@ -767,6 +857,163 @@ function getDependencyPackagePath(info: any): string | undefined {
     : undefined;
 }
 
+function getLatestVersionFromMetadata(metadata: any): string | null {
+  const latest = metadata?.["dist-tags"]?.latest;
+  return typeof latest === "string" && latest.length > 0 ? latest : null;
+}
+
+function getDefaultMinimumReleaseAgeMinutes(currentPnpmVersion: string): number {
+  const majorVersion = normalizeSemver(currentPnpmVersion)[0] || 0;
+  return majorVersion >= 11 ? 1440 : 0;
+}
+
+function getLatestMatureVersionFromMetadata(
+  metadata: any,
+  minimumReleaseAgeMinutes: number,
+): string | null {
+  const versions = metadata?.versions;
+  const versionTimes = metadata?.time;
+  if (
+    !versions ||
+    typeof versions !== "object" ||
+    !versionTimes ||
+    typeof versionTimes !== "object"
+  ) {
+    return null;
+  }
+
+  const cutoffTimestamp = Date.now() - minimumReleaseAgeMinutes * 60 * 1000;
+  return Object.keys(versions)
+    .filter((version) => /^\d+\.\d+\.\d+$/.test(version))
+    .filter((version) => {
+      const publishedAt = Date.parse(versionTimes[version]);
+      return Number.isFinite(publishedAt) && publishedAt <= cutoffTimestamp;
+    })
+    .sort(compareSemverDescending)[0] || null;
+}
+
+function compareSemverDescending(versionA: string, versionB: string): number {
+  const versionAParts = normalizeSemver(versionA);
+  const versionBParts = normalizeSemver(versionB);
+
+  for (
+    let i = 0;
+    i < Math.max(versionAParts.length, versionBParts.length);
+    i++
+  ) {
+    const versionAPart = versionAParts[i] || 0;
+    const versionBPart = versionBParts[i] || 0;
+    if (versionAPart !== versionBPart) {
+      return versionBPart - versionAPart;
+    }
+  }
+
+  return 0;
+}
+
+function parsePnpmConfigStringList(rawValue: string): string[] {
+  const trimmedValue = rawValue.trim();
+  if (
+    !trimmedValue ||
+    trimmedValue === "undefined" ||
+    trimmedValue === "null"
+  ) {
+    return [];
+  }
+
+  try {
+    const parsedValue = JSON.parse(trimmedValue);
+    if (Array.isArray(parsedValue)) {
+      return parsedValue
+        .filter((item) => typeof item === "string")
+        .map((item) => normalizePnpmConfigListItem(item))
+        .filter((item) => item.length > 0);
+    }
+    if (typeof parsedValue === "string") {
+      return [normalizePnpmConfigListItem(parsedValue)].filter(
+        (item) => item.length > 0,
+      );
+    }
+  } catch {
+    // pnpm commonly prints string arrays as comma-delimited text.
+  }
+
+  return trimmedValue
+    .split(/[\n,]/)
+    .map((item) => normalizePnpmConfigListItem(item))
+    .filter((item) => item.length > 0);
+}
+
+function normalizePnpmConfigListItem(rawItem: string): string {
+  return rawItem
+    .trim()
+    .replace(/^-\s*/, "")
+    .replace(/^\[/, "")
+    .replace(/\]$/, "")
+    .trim()
+    .replace(/^['"]/, "")
+    .replace(/['"]$/, "")
+    .trim();
+}
+
+function packageSelectorMatches(
+  packageName: string,
+  version: string,
+  pattern: string,
+): boolean {
+  const selectorParts = splitPackageSelector(pattern);
+  if (!globPatternMatches(packageName, selectorParts.packagePattern)) {
+    return false;
+  }
+  if (!selectorParts.versionSelector) {
+    return true;
+  }
+  return selectorParts.versionSelector
+    .split("||")
+    .map((versionSelector) => versionSelector.trim())
+    .some((versionSelector) => {
+      const packageVersionPrefix = `${packageName}@`;
+      const normalizedVersionSelector = versionSelector.startsWith(
+        packageVersionPrefix,
+      )
+        ? versionSelector.slice(packageVersionPrefix.length)
+        : versionSelector;
+      return normalizedVersionSelector === version;
+    });
+}
+
+function splitPackageSelector(pattern: string): {
+  packagePattern: string;
+  versionSelector: string | null;
+} {
+  const versionSeparatorIndex = pattern.startsWith("@")
+    ? pattern.indexOf("@", 1)
+    : pattern.indexOf("@");
+  if (versionSeparatorIndex <= 0) {
+    return {
+      packagePattern: pattern,
+      versionSelector: null,
+    };
+  }
+
+  return {
+    packagePattern: pattern.slice(0, versionSeparatorIndex),
+    versionSelector: pattern.slice(versionSeparatorIndex + 1).trim() || null,
+  };
+}
+
+function globPatternMatches(value: string, pattern: string): boolean {
+  const escapedPattern = pattern
+    .split("*")
+    .map((patternPart) => escapeRegExp(patternPart))
+    .join(".*");
+  return new RegExp(`^${escapedPattern}$`).test(value);
+}
+
+function escapeRegExp(value: string): string {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
 function getPackagePath(globalDir: string, packageName: string): string {
   return plugins.path.join(
     globalDir,