@hakobu/hakobu 1.0.0

package/lib-es5/app-bundle.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * macOS Application Bundle Generator
+ *
+ * Wraps a packaged Mach-O executable into a standard .app bundle:
+ *
+ *   MyApp.app/
+ *   └── Contents/
+ *       ├── Info.plist
+ *       ├── MacOS/
+ *       │   └── <binary>
+ *       └── Resources/   (icons added in Task 24.3)
+ *
+ * The .app bundle is the standard macOS application format. It allows
+ * the executable to appear as a native application in Finder, Dock,
+ * and Launchpad, and is required for full Info.plist metadata and
+ * .icns icon support.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAppBundle = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const log_1 = require("./log");
+// ─────────────────────────────────────────────────────────────────────
+// Info.plist generation
+// ─────────────────────────────────────────────────────────────────────
+function esc(s) {
+    return s
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+function plistEntry(key, value) {
+    return `  <key>${esc(key)}</key>\n  <string>${esc(value)}</string>`;
+}
+/**
+ * Derive a reverse-DNS bundle identifier from an app name.
+ * Strips @scope/ prefixes and replaces non-alphanumeric chars with hyphens.
+ */
+function deriveBundleId(appName) {
+    const clean = appName
+        .replace(/^@[^/]+\//, '') // strip npm scope
+        .replace(/[^a-zA-Z0-9.-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+    return `com.hakobu.${clean || 'app'}`;
+}
+function generatePlist(executableName, appName, meta, iconFileName) {
+    const entries = [];
+    // Required keys
+    entries.push(plistEntry('CFBundleExecutable', executableName));
+    entries.push(plistEntry('CFBundleName', appName));
+    entries.push(plistEntry('CFBundlePackageType', 'APPL'));
+    entries.push(plistEntry('CFBundleInfoDictionaryVersion', '6.0'));
+    // Metadata keys (with defaults)
+    const bundleId = meta?.bundleId || deriveBundleId(appName);
+    entries.push(plistEntry('CFBundleIdentifier', bundleId));
+    const bundleVersion = meta?.bundleVersion || '1.0.0';
+    entries.push(plistEntry('CFBundleVersion', bundleVersion));
+    const shortVersion = meta?.shortVersion || bundleVersion;
+    entries.push(plistEntry('CFBundleShortVersionString', shortVersion));
+    if (meta?.displayName) {
+        entries.push(plistEntry('CFBundleDisplayName', meta.displayName));
+    }
+    if (meta?.copyright) {
+        entries.push(plistEntry('NSHumanReadableCopyright', meta.copyright));
+    }
+    if (iconFileName) {
+        entries.push(plistEntry('CFBundleIconFile', iconFileName));
+    }
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+${entries.join('\n')}
+</dict>
+</plist>
+`;
+}
+/**
+ * Wrap a packaged Mach-O executable into a macOS .app bundle.
+ *
+ * The executable is moved (not copied) into the bundle to avoid
+ * doubling disk usage.
+ *
+ * @returns The absolute path to the generated .app bundle.
+ */
+function createAppBundle(opts) {
+    const { executablePath } = opts;
+    // Determine .app path
+    let appPath = opts.outputPath;
+    if (!appPath.endsWith('.app')) {
+        appPath += '.app';
+    }
+    appPath = path_1.default.resolve(appPath);
+    // Derive names
+    const execName = path_1.default.basename(executablePath);
+    const appName = opts.appName || execName;
+    // Create bundle directory structure
+    const contentsDir = path_1.default.join(appPath, 'Contents');
+    const macosDir = path_1.default.join(contentsDir, 'MacOS');
+    const resourcesDir = path_1.default.join(contentsDir, 'Resources');
+    fs_1.default.mkdirSync(macosDir, { recursive: true });
+    fs_1.default.mkdirSync(resourcesDir, { recursive: true });
+    // Move executable into bundle
+    const bundledExec = path_1.default.join(macosDir, execName);
+    fs_1.default.renameSync(executablePath, bundledExec);
+    // Copy .icns icon if configured
+    let iconFileName;
+    const iconPath = opts.macos?.icon;
+    if (iconPath) {
+        if (!fs_1.default.existsSync(iconPath)) {
+            throw new Error(`macOS icon file not found: ${iconPath}`);
+        }
+        if (!iconPath.endsWith('.icns')) {
+            throw new Error(`macOS icon must be a .icns file (got ${path_1.default.extname(iconPath) || 'no extension'}).\n` +
+                'Convert your icon to .icns using: iconutil -c icns <iconset>');
+        }
+        iconFileName = path_1.default.basename(iconPath);
+        fs_1.default.copyFileSync(iconPath, path_1.default.join(resourcesDir, iconFileName));
+        log_1.log.info(`  icon: ${iconFileName}`);
+    }
+    // Write Info.plist
+    const plist = generatePlist(execName, appName, opts.macos, iconFileName);
+    fs_1.default.writeFileSync(path_1.default.join(contentsDir, 'Info.plist'), plist, 'utf8');
+    log_1.log.info(`Created macOS app bundle: ${appPath}`);
+    return appPath;
+}
+exports.createAppBundle = createAppBundle;
+//# sourceMappingURL=app-bundle.js.map

package/lib-es5/appdir.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * Linux AppDir Generator
+ *
+ * Wraps a packaged ELF executable into an AppDir-style directory:
+ *
+ *   MyApp.AppDir/
+ *   ├── AppRun                              (launcher script)
+ *   └── usr/
+ *       ├── bin/
+ *       │   └── <binary>
+ *       ├── share/
+ *       │   ├── applications/               (for .desktop in Task 25.2)
+ *       │   └── icons/
+ *       │       └── hicolor/                (for icons in Task 25.3)
+ *       └── share/
+ *           └── metainfo/                   (for AppStream in Task 25.4)
+ *
+ * AppDir is the standard input format for AppImage tools and a common
+ * Linux application directory layout. It can be distributed as-is or
+ * packaged into an AppImage (Task 25.5).
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLinuxPlatform = exports.createAppImage = exports.createAppDir = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const log_1 = require("./log");
+// ─────────────────────────────────────────────────────────────────────
+// .desktop file generation
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Generate a .desktop file conforming to the Desktop Entry Specification.
+ * https://specifications.freedesktop.org/desktop-entry-spec/latest/
+ */
+function generateDesktopFile(executableName, appName, meta) {
+    const name = meta?.name || appName;
+    const icon = meta?.icon || appName;
+    const categories = meta?.categories || 'Utility;';
+    // Ensure categories ends with semicolon (spec requirement)
+    const cats = categories.endsWith(';') ? categories : categories + ';';
+    const terminal = meta?.terminal !== undefined ? meta.terminal : true;
+    const lines = [
+        '[Desktop Entry]',
+        'Type=Application',
+        `Name=${name}`,
+        `Exec=${executableName}`,
+        `Icon=${icon}`,
+        `Categories=${cats}`,
+        `Terminal=${terminal ? 'true' : 'false'}`,
+    ];
+    if (meta?.comment) {
+        lines.splice(3, 0, `Comment=${meta.comment}`);
+    }
+    return lines.join('\n') + '\n';
+}
+// ─────────────────────────────────────────────────────────────────────
+// AppStream metainfo generation
+// ─────────────────────────────────────────────────────────────────────
+function xmlEsc(s) {
+    return s
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+/**
+ * Derive a reverse-DNS component ID from an app name.
+ */
+function deriveComponentId(appName) {
+    const clean = appName
+        .replace(/^@[^/]+\//, '')
+        .replace(/[^a-zA-Z0-9.-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+    return `com.hakobu.${clean || 'app'}`;
+}
+/**
+ * Generate an AppStream metainfo XML file.
+ * https://www.freedesktop.org/software/appstream/docs/
+ *
+ * Produces a minimal valid <component type="desktop-application">
+ * with the fields available from config/package.json.
+ */
+function generateMetainfo(appName, meta) {
+    const id = deriveComponentId(appName);
+    const name = meta?.name || appName;
+    const summary = meta?.summary || meta?.comment || `${name} application`;
+    const metadataLicense = 'FSFAP'; // Free for all purposes — standard for metainfo files
+    const projectLicense = meta?.license || 'LicenseRef-Proprietary';
+    const desktopId = `${appName}.desktop`;
+    const lines = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<component type="desktop-application">',
+        `  <id>${xmlEsc(id)}</id>`,
+        `  <name>${xmlEsc(name)}</name>`,
+        `  <summary>${xmlEsc(summary)}</summary>`,
+        `  <metadata_license>${xmlEsc(metadataLicense)}</metadata_license>`,
+        `  <project_license>${xmlEsc(projectLicense)}</project_license>`,
+        `  <launchable type="desktop-id">${xmlEsc(desktopId)}</launchable>`,
+    ];
+    if (meta?.description) {
+        lines.push('  <description>');
+        lines.push(`    <p>${xmlEsc(meta.description)}</p>`);
+        lines.push('  </description>');
+    }
+    if (meta?.url) {
+        lines.push(`  <url type="homepage">${xmlEsc(meta.url)}</url>`);
+    }
+    if (meta?.version) {
+        lines.push('  <releases>');
+        lines.push(`    <release version="${xmlEsc(meta.version)}" />`);
+        lines.push('  </releases>');
+    }
+    lines.push('</component>');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Generate the AppRun launcher script.
+ *
+ * AppRun is the entry point when an AppDir (or AppImage) is executed.
+ * It sets up the environment and launches the actual binary.
+ */
+function generateAppRun(executableName) {
+    return `#!/bin/sh
+# AppRun — launcher for AppDir/AppImage
+# Generated by Hakobu
+
+SELF="$(readlink -f "$0")"
+HERE="$(dirname "$SELF")"
+
+exec "$HERE/usr/bin/${executableName}" "$@"
+`;
+}
+/**
+ * Wrap a packaged ELF executable into a Linux AppDir.
+ *
+ * The executable is moved (not copied) into the AppDir to avoid
+ * doubling disk usage.
+ *
+ * @returns The absolute path to the generated AppDir.
+ */
+function createAppDir(opts) {
+    const { executablePath } = opts;
+    // Determine AppDir path
+    let appDirPath = opts.outputPath;
+    if (!appDirPath.endsWith('.AppDir')) {
+        appDirPath += '.AppDir';
+    }
+    appDirPath = path_1.default.resolve(appDirPath);
+    // Derive names
+    const execName = path_1.default.basename(executablePath);
+    const appName = opts.appName || execName;
+    // Create directory structure
+    const binDir = path_1.default.join(appDirPath, 'usr', 'bin');
+    const applicationsDir = path_1.default.join(appDirPath, 'usr', 'share', 'applications');
+    const iconsDir = path_1.default.join(appDirPath, 'usr', 'share', 'icons', 'hicolor');
+    const metainfoDir = path_1.default.join(appDirPath, 'usr', 'share', 'metainfo');
+    fs_1.default.mkdirSync(binDir, { recursive: true });
+    fs_1.default.mkdirSync(applicationsDir, { recursive: true });
+    fs_1.default.mkdirSync(iconsDir, { recursive: true });
+    fs_1.default.mkdirSync(metainfoDir, { recursive: true });
+    // Move executable into AppDir
+    const destExec = path_1.default.join(binDir, execName);
+    fs_1.default.renameSync(executablePath, destExec);
+    // Write AppRun launcher
+    const appRunPath = path_1.default.join(appDirPath, 'AppRun');
+    fs_1.default.writeFileSync(appRunPath, generateAppRun(execName), { mode: 0o755 });
+    // Write .desktop file
+    const desktopContent = generateDesktopFile(execName, appName, opts.linux);
+    const desktopFileName = `${appName}.desktop`;
+    fs_1.default.writeFileSync(path_1.default.join(applicationsDir, desktopFileName), desktopContent);
+    // Place icon if configured
+    const iconPath = opts.linux?.iconPath;
+    if (iconPath) {
+        if (!fs_1.default.existsSync(iconPath)) {
+            throw new Error(`Linux icon file not found: ${iconPath}`);
+        }
+        if (!iconPath.endsWith('.png')) {
+            throw new Error(`Linux icon must be a .png file (got ${path_1.default.extname(iconPath) || 'no extension'}).`);
+        }
+        const iconName = (opts.linux?.icon || appName) + '.png';
+        // Place in hicolor/256x256/apps/ (standard freedesktop location)
+        const hicolor256 = path_1.default.join(iconsDir, '256x256', 'apps');
+        fs_1.default.mkdirSync(hicolor256, { recursive: true });
+        fs_1.default.copyFileSync(iconPath, path_1.default.join(hicolor256, iconName));
+        // Place at AppDir root (AppImage convention)
+        fs_1.default.copyFileSync(iconPath, path_1.default.join(appDirPath, iconName));
+        log_1.log.info(`  icon: ${iconName}`);
+    }
+    // Write AppStream metainfo
+    const metainfoContent = generateMetainfo(appName, opts.linux);
+    fs_1.default.writeFileSync(path_1.default.join(metainfoDir, `${appName}.metainfo.xml`), metainfoContent);
+    log_1.log.info(`Created Linux AppDir: ${appDirPath}`);
+    return appDirPath;
+}
+exports.createAppDir = createAppDir;
+/**
+ * Map Node.js arch names to AppImage arch names.
+ */
+function nodeArchToAppImage(arch) {
+    switch (arch) {
+        case 'x64': return 'x86_64';
+        case 'arm64': return 'aarch64';
+        case 'arm': return 'armhf';
+        default: return arch;
+    }
+}
+/**
+ * Build an AppImage from an AppDir using appimagetool.
+ *
+ * appimagetool is an external tool that must be in PATH.
+ * Download from: https://github.com/AppImage/appimagetool/releases
+ *
+ * @throws If appimagetool is not found or fails.
+ * @returns The absolute path to the generated .AppImage file.
+ */
+function createAppImage(opts) {
+    const { appDirPath } = opts;
+    let outputPath = opts.outputPath;
+    if (!outputPath.endsWith('.AppImage')) {
+        outputPath += '.AppImage';
+    }
+    outputPath = path_1.default.resolve(outputPath);
+    // Ensure output directory exists
+    fs_1.default.mkdirSync(path_1.default.dirname(outputPath), { recursive: true });
+    const arch = opts.arch || nodeArchToAppImage(process.arch);
+    // Check if appimagetool is available
+    const { execFileSync } = require('child_process');
+    try {
+        execFileSync('appimagetool', ['--version'], {
+            stdio: 'pipe',
+            timeout: 10000,
+        });
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new Error('appimagetool is not installed or not in PATH.\n' +
+                'Download from: https://github.com/AppImage/appimagetool/releases\n' +
+                'On Ubuntu/Debian: download the AppImage, chmod +x, and move to /usr/local/bin/\n' +
+                'Or install via package manager if available.');
+        }
+        throw err;
+    }
+    log_1.log.info(`Building AppImage from ${path_1.default.basename(appDirPath)}...`);
+    execFileSync('appimagetool', [appDirPath, outputPath], {
+        stdio: 'inherit',
+        timeout: 300000,
+        env: { ...process.env, ARCH: arch },
+    });
+    log_1.log.info(`Created AppImage: ${outputPath}`);
+    return outputPath;
+}
+exports.createAppImage = createAppImage;
+/**
+ * Check if a platform string represents a Linux target.
+ */
+function isLinuxPlatform(platform) {
+    return platform === 'linux' || platform === 'alpine' || platform === 'linuxstatic';
+}
+exports.isLinuxPlatform = isLinuxPlatform;
+//# sourceMappingURL=appdir.js.map