@agiflowai/aicode-utils 1.0.5 → 1.0.7

package/dist/index.cjs

@@ -748,6 +748,36 @@ var ScaffoldProcessingService = class {
 	}
 };
 
+//#endregion
+//#region src/utils/generateStableId.ts
+/**
+* Generate a stable, random ID string
+*
+* @param length - Length of the ID to generate (default: 8)
+* @returns A random alphanumeric ID string (lowercase)
+*
+* @remarks
+* Negative or non-integer lengths are normalized (floored and clamped to 0).
+* Returns empty string for length <= 0.
+*
+* @example
+* ```typescript
+* const id = generateStableId(6); // Returns something like "a3f9k2"
+* ```
+*/
+function generateStableId(length = 8) {
+	const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+	let result = "";
+	const normalizedLength = Math.max(0, Math.floor(length));
+	if (normalizedLength === 0) return "";
+	if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+		const values = new Uint8Array(normalizedLength);
+		crypto.getRandomValues(values);
+		for (let i = 0; i < normalizedLength; i++) result += chars[values[i] % 36];
+	} else for (let i = 0; i < normalizedLength; i++) result += chars[Math.floor(Math.random() * 36)];
+	return result;
+}
+
 //#endregion
 //#region src/utils/print.ts
 /**
@@ -995,6 +1025,7 @@ Object.defineProperty(exports, 'fs', {
     return node_fs_promises;
   }
 });
+exports.generateStableId = generateStableId;
 exports.icons = icons;
 exports.isMonolith = isMonolith;
 exports.isMonorepo = isMonorepo;

package/dist/index.d.cts

@@ -403,6 +403,24 @@ declare const rename: typeof fs.rename;
 declare const rm: typeof fs.rm;
 declare const cp: typeof fs.cp;
 //#endregion
+//#region src/utils/generateStableId.d.ts
+/**
+ * Generate a stable, random ID string
+ *
+ * @param length - Length of the ID to generate (default: 8)
+ * @returns A random alphanumeric ID string (lowercase)
+ *
+ * @remarks
+ * Negative or non-integer lengths are normalized (floored and clamped to 0).
+ * Returns empty string for length <= 0.
+ *
+ * @example
+ * ```typescript
+ * const id = generateStableId(6); // Returns something like "a3f9k2"
+ * ```
+ */
+declare function generateStableId(length?: number): string;
+//#endregion
 //#region src/utils/logger.d.ts
 declare const logger: pino.Logger<never, boolean>;
 declare const log: {
@@ -580,4 +598,4 @@ declare function isMonorepo(workspaceRoot: string): Promise<boolean>;
  */
 declare function isMonolith(workspaceRoot: string): Promise<boolean>;
 //#endregion
-export { ConfigSource, GeneratorContext, GeneratorFunction, IFileSystemService, IVariableReplacementService, NxProjectJson, ParsedInclude, ProjectConfig, ProjectConfigResolver, ProjectConfigResult, ProjectFinderService, ProjectType, ProjectTypeDetectionResult, ScaffoldProcessingService, ScaffoldResult, TemplatesManagerService, ToolkitConfig, accessSync, copy, cp, detectProjectType, ensureDir, ensureDirSync, fs, icons, isMonolith, isMonorepo, log, logger, messages, mkdir, mkdirSync, move, outputFile, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, rename, rm, sections, stat, statSync, unlink, writeFile, writeFileSync, writeJson, writeJsonSync };
+export { ConfigSource, GeneratorContext, GeneratorFunction, IFileSystemService, IVariableReplacementService, NxProjectJson, ParsedInclude, ProjectConfig, ProjectConfigResolver, ProjectConfigResult, ProjectFinderService, ProjectType, ProjectTypeDetectionResult, ScaffoldProcessingService, ScaffoldResult, TemplatesManagerService, ToolkitConfig, accessSync, copy, cp, detectProjectType, ensureDir, ensureDirSync, fs, generateStableId, icons, isMonolith, isMonorepo, log, logger, messages, mkdir, mkdirSync, move, outputFile, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, rename, rm, sections, stat, statSync, unlink, writeFile, writeFileSync, writeJson, writeJsonSync };

package/dist/index.d.mts

@@ -403,6 +403,24 @@ declare const rename: typeof fs.rename;
 declare const rm: typeof fs.rm;
 declare const cp: typeof fs.cp;
 //#endregion
+//#region src/utils/generateStableId.d.ts
+/**
+ * Generate a stable, random ID string
+ *
+ * @param length - Length of the ID to generate (default: 8)
+ * @returns A random alphanumeric ID string (lowercase)
+ *
+ * @remarks
+ * Negative or non-integer lengths are normalized (floored and clamped to 0).
+ * Returns empty string for length <= 0.
+ *
+ * @example
+ * ```typescript
+ * const id = generateStableId(6); // Returns something like "a3f9k2"
+ * ```
+ */
+declare function generateStableId(length?: number): string;
+//#endregion
 //#region src/utils/logger.d.ts
 declare const logger: pino.Logger<never, boolean>;
 declare const log: {
@@ -580,4 +598,4 @@ declare function isMonorepo(workspaceRoot: string): Promise<boolean>;
  */
 declare function isMonolith(workspaceRoot: string): Promise<boolean>;
 //#endregion
-export { ConfigSource, GeneratorContext, GeneratorFunction, IFileSystemService, IVariableReplacementService, NxProjectJson, ParsedInclude, ProjectConfig, ProjectConfigResolver, ProjectConfigResult, ProjectFinderService, ProjectType, ProjectTypeDetectionResult, ScaffoldProcessingService, ScaffoldResult, TemplatesManagerService, ToolkitConfig, accessSync, copy, cp, detectProjectType, ensureDir, ensureDirSync, fs, icons, isMonolith, isMonorepo, log, logger, messages, mkdir, mkdirSync, move, outputFile, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, rename, rm, sections, stat, statSync, unlink, writeFile, writeFileSync, writeJson, writeJsonSync };
+export { ConfigSource, GeneratorContext, GeneratorFunction, IFileSystemService, IVariableReplacementService, NxProjectJson, ParsedInclude, ProjectConfig, ProjectConfigResolver, ProjectConfigResult, ProjectFinderService, ProjectType, ProjectTypeDetectionResult, ScaffoldProcessingService, ScaffoldResult, TemplatesManagerService, ToolkitConfig, accessSync, copy, cp, detectProjectType, ensureDir, ensureDirSync, fs, generateStableId, icons, isMonolith, isMonorepo, log, logger, messages, mkdir, mkdirSync, move, outputFile, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, rename, rm, sections, stat, statSync, unlink, writeFile, writeFileSync, writeJson, writeJsonSync };

package/dist/index.mjs

@@ -725,6 +725,36 @@ var ScaffoldProcessingService = class {
 	}
 };
 
+//#endregion
+//#region src/utils/generateStableId.ts
+/**
+* Generate a stable, random ID string
+*
+* @param length - Length of the ID to generate (default: 8)
+* @returns A random alphanumeric ID string (lowercase)
+*
+* @remarks
+* Negative or non-integer lengths are normalized (floored and clamped to 0).
+* Returns empty string for length <= 0.
+*
+* @example
+* ```typescript
+* const id = generateStableId(6); // Returns something like "a3f9k2"
+* ```
+*/
+function generateStableId(length = 8) {
+	const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+	let result = "";
+	const normalizedLength = Math.max(0, Math.floor(length));
+	if (normalizedLength === 0) return "";
+	if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+		const values = new Uint8Array(normalizedLength);
+		crypto.getRandomValues(values);
+		for (let i = 0; i < normalizedLength; i++) result += chars[values[i] % 36];
+	} else for (let i = 0; i < normalizedLength; i++) result += chars[Math.floor(Math.random() * 36)];
+	return result;
+}
+
 //#endregion
 //#region src/utils/print.ts
 /**
@@ -954,4 +984,4 @@ async function isMonolith(workspaceRoot) {
 }
 
 //#endregion
-export { ConfigSource, ProjectConfigResolver, ProjectFinderService, ProjectType, ScaffoldProcessingService, TemplatesManagerService, accessSync, copy, cp, detectProjectType, ensureDir, ensureDirSync, fs, icons, isMonolith, isMonorepo, log, logger, messages, mkdir, mkdirSync, move, outputFile, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, rename, rm, sections, stat, statSync, unlink, writeFile, writeFileSync, writeJson, writeJsonSync };
+export { ConfigSource, ProjectConfigResolver, ProjectFinderService, ProjectType, ScaffoldProcessingService, TemplatesManagerService, accessSync, copy, cp, detectProjectType, ensureDir, ensureDirSync, fs, generateStableId, icons, isMonolith, isMonorepo, log, logger, messages, mkdir, mkdirSync, move, outputFile, pathExists, pathExistsSync, print, readFile, readFileSync, readJson, readJsonSync, readdir, remove, rename, rm, sections, stat, statSync, unlink, writeFile, writeFileSync, writeJson, writeJsonSync };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agiflowai/aicode-utils",
   "description": "Shared utilities and types for AI-powered code generation, scaffolding, and analysis",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "license": "AGPL-3.0",
   "author": "AgiflowIO",
   "repository": {
@@ -40,6 +40,7 @@
     "@types/node": "^22.0.0",
     "@types/ora": "^3.2.0",
     "@vitest/coverage-v8": "^3.0.0",
+    "chance": "^1.1.13",
     "tsdown": "^0.16.4",
     "typescript": "5.9.3",
     "vitest": "^3.0.0"