create-gen-app 0.2.1 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-gen-app",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "author": "Dan Lynch <pyramation@gmail.com>",
   "description": "Clone and customize template repositories with variable replacement",
   "main": "index.js",
@@ -28,13 +28,13 @@
     "test:watch": "jest --watch"
   },
   "dependencies": {
-    "appstash": "0.2.3",
-    "inquirerer": "2.1.8"
+    "appstash": "0.2.4",
+    "inquirerer": "2.1.9"
   },
   "devDependencies": {
     "copyfiles": "^2.4.1",
-    "makage": "0.1.6"
+    "makage": "0.1.8"
   },
   "keywords": [],
-  "gitHead": "d0068bfc4eb3bd041e3ce97d9e4da2fba7c5f84a"
+  "gitHead": "872fb2ae9f7e3d541e94271c26099bd85d5237d2"
 }

package/{extract.d.ts → template/extract.d.ts}

@@ -1,4 +1,4 @@
-import { ExtractedVariables } from "./types";
+import { ExtractedVariables } from "../types";
 /**
  * Extract all variables from a template directory
  * @param templateDir - Path to the template directory

package/{prompt.d.ts → template/prompt.d.ts}

@@ -1,5 +1,5 @@
 import { Question } from "inquirerer";
-import { ExtractedVariables } from "./types";
+import { ExtractedVariables } from "../types";
 /**
  * Generate questions from extracted variables
  * @param extractedVariables - Variables extracted from the template

package/{replace.d.ts → template/replace.d.ts}

@@ -1,4 +1,4 @@
-import { ExtractedVariables } from './types';
+import { ExtractedVariables } from '../types';
 /**
  * Replace variables in all files in the template directory
  * @param templateDir - Path to the template directory

package/{replace.js → template/replace.js}

@@ -38,7 +38,7 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const stream_1 = require("stream");
 const promises_1 = require("stream/promises");
-const licenses_1 = require("./licenses");
+const licenses_1 = require("../licenses");
 /**
  * Replace variables in all files in the template directory
  * @param templateDir - Path to the template directory
@@ -143,7 +143,7 @@ async function replaceInFile(sourcePath, destPath, extractedVariables, answers)
         fs.mkdirSync(destDir, { recursive: true });
     }
     const replaceTransform = new stream_1.Transform({
-        transform(chunk, encoding, callback) {
+        transform(chunk, _encoding, callback) {
             let content = chunk.toString();
             for (const replacer of extractedVariables.contentReplacers) {
                 if (answers[replacer.variable] !== undefined) {

package/template/templatizer.d.ts

@@ -0,0 +1,29 @@
+import { ExtractedVariables } from '../types';
+import { ProcessOptions, TemplatizerResult } from './types';
+export declare class Templatizer {
+    constructor();
+    /**
+     * Process a local template directory (extract + prompt + replace)
+     * @param templateDir - Local directory path (MUST be local, NOT git URL)
+     * @param outputDir - Output directory for generated project
+     * @param options - Processing options (argv overrides, noTty)
+     * @returns Processing result
+     */
+    process(templateDir: string, outputDir: string, options?: ProcessOptions): Promise<TemplatizerResult>;
+    /**
+     * Extract variables from template directory
+     */
+    extract(templateDir: string): Promise<ExtractedVariables>;
+    /**
+     * Prompt user for variables
+     */
+    prompt(extracted: ExtractedVariables, argv?: Record<string, any>, noTty?: boolean): Promise<Record<string, any>>;
+    /**
+     * Replace variables in template
+     */
+    replace(templateDir: string, outputDir: string, extracted: ExtractedVariables, answers: Record<string, any>): Promise<void>;
+    /**
+     * Validate template directory exists and has content
+     */
+    validateTemplateDir(templateDir: string): void;
+}

package/template/templatizer.js

@@ -0,0 +1,106 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Templatizer = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const extract_1 = require("./extract");
+const prompt_1 = require("./prompt");
+const replace_1 = require("./replace");
+class Templatizer {
+    constructor() {
+        // Pure template processor - no configuration needed
+    }
+    /**
+     * Process a local template directory (extract + prompt + replace)
+     * @param templateDir - Local directory path (MUST be local, NOT git URL)
+     * @param outputDir - Output directory for generated project
+     * @param options - Processing options (argv overrides, noTty)
+     * @returns Processing result
+     */
+    async process(templateDir, outputDir, options) {
+        this.validateTemplateDir(templateDir);
+        // Handle subdirectory within template
+        const actualTemplateDir = options?.fromPath
+            ? path.join(templateDir, options.fromPath)
+            : templateDir;
+        this.validateTemplateDir(actualTemplateDir);
+        // Extract variables
+        const variables = await this.extract(actualTemplateDir);
+        // Prompt for values
+        const answers = await this.prompt(variables, options?.argv, options?.noTty);
+        // Replace variables
+        await this.replace(actualTemplateDir, outputDir, variables, answers);
+        return {
+            outputDir,
+            variables,
+            answers,
+        };
+    }
+    /**
+     * Extract variables from template directory
+     */
+    async extract(templateDir) {
+        return (0, extract_1.extractVariables)(templateDir);
+    }
+    /**
+     * Prompt user for variables
+     */
+    async prompt(extracted, argv, noTty) {
+        return (0, prompt_1.promptUser)(extracted, argv ?? {}, noTty ?? false);
+    }
+    /**
+     * Replace variables in template
+     */
+    async replace(templateDir, outputDir, extracted, answers) {
+        return (0, replace_1.replaceVariables)(templateDir, outputDir, extracted, answers);
+    }
+    /**
+     * Validate template directory exists and has content
+     */
+    validateTemplateDir(templateDir) {
+        if (!fs.existsSync(templateDir)) {
+            throw new Error(`Template directory does not exist: ${templateDir}`);
+        }
+        if (!fs.statSync(templateDir).isDirectory()) {
+            throw new Error(`Template path is not a directory: ${templateDir}`);
+        }
+        const entries = fs.readdirSync(templateDir);
+        if (entries.length === 0) {
+            throw new Error(`Template directory is empty: ${templateDir}`);
+        }
+    }
+}
+exports.Templatizer = Templatizer;

package/template/types.d.ts

@@ -0,0 +1,11 @@
+import { ExtractedVariables } from '../types';
+export interface ProcessOptions {
+    argv?: Record<string, any>;
+    noTty?: boolean;
+    fromPath?: string;
+}
+export interface TemplatizerResult {
+    outputDir: string;
+    variables: ExtractedVariables;
+    answers: Record<string, any>;
+}

package/template/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/utils/npm-version-check.d.ts

@@ -0,0 +1,17 @@
+import { VersionCheckResult } from './types';
+/**
+ * Check if current package version is outdated compared to npm registry
+ * @param packageName - Package name to check
+ * @param currentVersion - Current version string
+ * @returns Version comparison result
+ */
+export declare function checkNpmVersion(packageName: string, currentVersion: string): Promise<VersionCheckResult>;
+/**
+ * Compare two semver version strings
+ * Returns: -1 if v1 < v2, 0 if equal, 1 if v1 > v2
+ */
+export declare function compareVersions(v1: string, v2: string): number;
+/**
+ * Print version warning to console if outdated
+ */
+export declare function warnIfOutdated(packageName: string, result: VersionCheckResult): void;

package/utils/npm-version-check.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkNpmVersion = checkNpmVersion;
+exports.compareVersions = compareVersions;
+exports.warnIfOutdated = warnIfOutdated;
+const child_process_1 = require("child_process");
+/**
+ * Check if current package version is outdated compared to npm registry
+ * @param packageName - Package name to check
+ * @param currentVersion - Current version string
+ * @returns Version comparison result
+ */
+async function checkNpmVersion(packageName, currentVersion) {
+    try {
+        const latestVersion = (0, child_process_1.execSync)(`npm view ${packageName} version`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] }).trim();
+        const isOutdated = compareVersions(currentVersion, latestVersion) < 0;
+        return {
+            currentVersion,
+            latestVersion,
+            isOutdated,
+        };
+    }
+    catch (error) {
+        return {
+            currentVersion,
+            latestVersion: null,
+            isOutdated: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Compare two semver version strings
+ * Returns: -1 if v1 < v2, 0 if equal, 1 if v1 > v2
+ */
+function compareVersions(v1, v2) {
+    const parts1 = v1.split('.').map(Number);
+    const parts2 = v2.split('.').map(Number);
+    for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+        const p1 = parts1[i] || 0;
+        const p2 = parts2[i] || 0;
+        if (p1 < p2)
+            return -1;
+        if (p1 > p2)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Print version warning to console if outdated
+ */
+function warnIfOutdated(packageName, result) {
+    if (result.isOutdated && result.latestVersion) {
+        console.warn(`\n⚠️  New version available: ${result.currentVersion} → ${result.latestVersion}`);
+        console.warn(`   Run: npm install -g ${packageName}@latest\n`);
+    }
+}

package/utils/types.d.ts

@@ -0,0 +1,6 @@
+export interface VersionCheckResult {
+    currentVersion: string;
+    latestVersion: string | null;
+    isOutdated: boolean;
+    error?: string;
+}

package/utils/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cache.d.ts

@@ -1,13 +0,0 @@
-import { CacheOptions } from "./types";
-export interface TemplateSource {
-    templateDir: string;
-    cacheUsed: boolean;
-    cleanup: () => void;
-}
-interface PrepareTemplateArgs {
-    templateUrl: string;
-    branch?: string;
-    cache: CacheOptions | false;
-}
-export declare function prepareTemplateDirectory(args: PrepareTemplateArgs): Promise<TemplateSource>;
-export { TemplateCache } from "./template-cache";

package/cache.js

@@ -1,76 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TemplateCache = void 0;
-exports.prepareTemplateDirectory = prepareTemplateDirectory;
-const fs = __importStar(require("fs"));
-const clone_1 = require("./clone");
-const template_cache_1 = require("./template-cache");
-async function prepareTemplateDirectory(args) {
-    const { templateUrl, branch, cache } = args;
-    const templateCache = new template_cache_1.TemplateCache(cache);
-    if (!templateCache.isEnabled()) {
-        const tempDir = await (0, clone_1.cloneRepo)(templateUrl, { branch });
-        return {
-            templateDir: tempDir,
-            cacheUsed: false,
-            cleanup: () => cleanupDir(tempDir),
-        };
-    }
-    // Try to get from cache
-    const cachedPath = templateCache.get(templateUrl, branch);
-    if (cachedPath) {
-        return {
-            templateDir: cachedPath,
-            cacheUsed: true,
-            cleanup: () => { },
-        };
-    }
-    // Cache miss or expired - clone and cache
-    const cachePath = templateCache.set(templateUrl, branch);
-    return {
-        templateDir: cachePath,
-        cacheUsed: false,
-        cleanup: () => { },
-    };
-}
-function cleanupDir(dir) {
-    if (fs.existsSync(dir)) {
-        fs.rmSync(dir, { recursive: true, force: true });
-    }
-}
-// Re-export TemplateCache for external use
-var template_cache_2 = require("./template-cache");
-Object.defineProperty(exports, "TemplateCache", { enumerable: true, get: function () { return template_cache_2.TemplateCache; } });

package/clone.d.ts

@@ -1,15 +0,0 @@
-export interface CloneOptions {
-    branch?: string;
-}
-/**
- * Clone a repository to a temporary directory
- * @param url - Repository URL (GitHub or any git URL)
- * @returns Path to the cloned repository
- */
-export declare function cloneRepo(url: string, options?: CloneOptions): Promise<string>;
-/**
- * Normalize a URL to a git-cloneable format
- * @param url - Input URL
- * @returns Normalized git URL
- */
-export declare function normalizeGitUrl(url: string): string;

package/clone.js

@@ -1,86 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.cloneRepo = cloneRepo;
-exports.normalizeGitUrl = normalizeGitUrl;
-const child_process_1 = require("child_process");
-const fs = __importStar(require("fs"));
-const os = __importStar(require("os"));
-const path = __importStar(require("path"));
-/**
- * Clone a repository to a temporary directory
- * @param url - Repository URL (GitHub or any git URL)
- * @returns Path to the cloned repository
- */
-async function cloneRepo(url, options = {}) {
-    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "create-gen-"));
-    const { branch } = options;
-    try {
-        const gitUrl = normalizeGitUrl(url);
-        const branchArgs = branch ? ` --branch ${branch} --single-branch` : "";
-        const depthArgs = " --depth 1"; // use shallow clone for speed; remove if future features need full history
-        (0, child_process_1.execSync)(`git clone${branchArgs}${depthArgs} ${gitUrl} ${tempDir}`, {
-            stdio: "inherit",
-        });
-        const gitDir = path.join(tempDir, ".git");
-        if (fs.existsSync(gitDir)) {
-            fs.rmSync(gitDir, { recursive: true, force: true });
-        }
-        return tempDir;
-    }
-    catch (error) {
-        if (fs.existsSync(tempDir)) {
-            fs.rmSync(tempDir, { recursive: true, force: true });
-        }
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        throw new Error(`Failed to clone repository: ${errorMessage}`);
-    }
-}
-/**
- * Normalize a URL to a git-cloneable format
- * @param url - Input URL
- * @returns Normalized git URL
- */
-function normalizeGitUrl(url) {
-    if (url.startsWith("git@") ||
-        url.startsWith("https://") ||
-        url.startsWith("http://")) {
-        return url;
-    }
-    if (/^[\w-]+\/[\w-]+$/.test(url)) {
-        return `https://github.com/${url}.git`;
-    }
-    return url;
-}

package/esm/cache.js

@@ -1,38 +0,0 @@
-import * as fs from "fs";
-import { cloneRepo } from "./clone";
-import { TemplateCache } from "./template-cache";
-export async function prepareTemplateDirectory(args) {
-    const { templateUrl, branch, cache } = args;
-    const templateCache = new TemplateCache(cache);
-    if (!templateCache.isEnabled()) {
-        const tempDir = await cloneRepo(templateUrl, { branch });
-        return {
-            templateDir: tempDir,
-            cacheUsed: false,
-            cleanup: () => cleanupDir(tempDir),
-        };
-    }
-    // Try to get from cache
-    const cachedPath = templateCache.get(templateUrl, branch);
-    if (cachedPath) {
-        return {
-            templateDir: cachedPath,
-            cacheUsed: true,
-            cleanup: () => { },
-        };
-    }
-    // Cache miss or expired - clone and cache
-    const cachePath = templateCache.set(templateUrl, branch);
-    return {
-        templateDir: cachePath,
-        cacheUsed: false,
-        cleanup: () => { },
-    };
-}
-function cleanupDir(dir) {
-    if (fs.existsSync(dir)) {
-        fs.rmSync(dir, { recursive: true, force: true });
-    }
-}
-// Re-export TemplateCache for external use
-export { TemplateCache } from "./template-cache";

package/esm/clone.js

@@ -1,49 +0,0 @@
-import { execSync } from "child_process";
-import * as fs from "fs";
-import * as os from "os";
-import * as path from "path";
-/**
- * Clone a repository to a temporary directory
- * @param url - Repository URL (GitHub or any git URL)
- * @returns Path to the cloned repository
- */
-export async function cloneRepo(url, options = {}) {
-    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "create-gen-"));
-    const { branch } = options;
-    try {
-        const gitUrl = normalizeGitUrl(url);
-        const branchArgs = branch ? ` --branch ${branch} --single-branch` : "";
-        const depthArgs = " --depth 1"; // use shallow clone for speed; remove if future features need full history
-        execSync(`git clone${branchArgs}${depthArgs} ${gitUrl} ${tempDir}`, {
-            stdio: "inherit",
-        });
-        const gitDir = path.join(tempDir, ".git");
-        if (fs.existsSync(gitDir)) {
-            fs.rmSync(gitDir, { recursive: true, force: true });
-        }
-        return tempDir;
-    }
-    catch (error) {
-        if (fs.existsSync(tempDir)) {
-            fs.rmSync(tempDir, { recursive: true, force: true });
-        }
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        throw new Error(`Failed to clone repository: ${errorMessage}`);
-    }
-}
-/**
- * Normalize a URL to a git-cloneable format
- * @param url - Input URL
- * @returns Normalized git URL
- */
-export function normalizeGitUrl(url) {
-    if (url.startsWith("git@") ||
-        url.startsWith("https://") ||
-        url.startsWith("http://")) {
-        return url;
-    }
-    if (/^[\w-]+\/[\w-]+$/.test(url)) {
-        return `https://github.com/${url}.git`;
-    }
-    return url;
-}