@amodalai/core 0.1.0

package/dist/src/packages/npm-context.js

@@ -0,0 +1,235 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { execFile } from 'node:child_process';
+import { mkdir, readlink, stat, symlink, unlink, writeFile } from 'node:fs/promises';
+import * as path from 'node:path';
+import { promisify } from 'node:util';
+import { PackageError } from './package-error.js';
+import { makePackageRef, parsePackageKey, toSymlinkName, } from './package-types.js';
+const execFileAsync = promisify(execFile);
+const DEFAULT_REGISTRY_URL = 'https://registry.amodalai.com';
+const DEFAULT_TIMEOUT = 30_000;
+/**
+ * Get the standard paths for the hidden npm context.
+ */
+export function getNpmContextPaths(repoPath) {
+    const root = path.join(repoPath, 'amodal_packages');
+    const npmDir = path.join(root, '.npm');
+    return {
+        root,
+        npmDir,
+        npmrc: path.join(npmDir, '.npmrc'),
+        packageJson: path.join(npmDir, 'package.json'),
+        nodeModules: path.join(npmDir, 'node_modules'),
+    };
+}
+/**
+ * Ensure the hidden npm context exists. Idempotent.
+ */
+export async function ensureNpmContext(repoPath, registryUrl) {
+    const paths = getNpmContextPaths(repoPath);
+    await mkdir(paths.npmDir, { recursive: true });
+    // Write .npmrc
+    const registry = registryUrl ?? process.env['AMODAL_REGISTRY'] ?? DEFAULT_REGISTRY_URL;
+    await writeFile(paths.npmrc, `registry=${registry}\n`, 'utf-8');
+    // Write minimal package.json if it doesn't exist
+    try {
+        await stat(paths.packageJson);
+    }
+    catch {
+        await writeFile(paths.packageJson, JSON.stringify({ name: 'amodal-packages', private: true, dependencies: {} }, null, 2) + '\n', 'utf-8');
+    }
+    return paths;
+}
+/**
+ * Run `npm install` for a specific package.
+ */
+export async function npmInstall(paths, npmName, version, timeout) {
+    const pkg = version ? `${npmName}@${version}` : npmName;
+    try {
+        const { stdout } = await execFileAsync('npm', ['install', '--save', '--json', '--fetch-timeout=10000', pkg], {
+            cwd: paths.npmDir,
+            timeout: timeout ?? DEFAULT_TIMEOUT,
+        });
+        // Parse npm output to get resolved version and integrity
+        let parsed;
+        try {
+            parsed = JSON.parse(stdout);
+        }
+        catch {
+            // Fallback: read from package-lock.json or package.json
+            return await readInstalledVersion(paths, npmName);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        const result = parsed;
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        const added = result['added'];
+        if (added && added.length > 0) {
+            const entry = added[0];
+            return {
+                version: String(entry['version'] ?? ''),
+                integrity: String(entry['integrity'] ?? ''),
+            };
+        }
+        return await readInstalledVersion(paths, npmName);
+    }
+    catch (err) {
+        throw new PackageError('NPM_INSTALL_FAILED', `Failed to install ${pkg}`, err);
+    }
+}
+/**
+ * Run `npm install` to restore all packages from package.json.
+ */
+export async function npmInstallAll(paths, timeout) {
+    try {
+        await execFileAsync('npm', ['install'], {
+            cwd: paths.npmDir,
+            timeout: timeout ?? DEFAULT_TIMEOUT,
+        });
+    }
+    catch (err) {
+        throw new PackageError('NPM_INSTALL_FAILED', 'Failed to install packages', err);
+    }
+}
+/**
+ * Run `npm uninstall` for a specific package.
+ */
+export async function npmUninstall(paths, npmName, timeout) {
+    try {
+        await execFileAsync('npm', ['uninstall', npmName], {
+            cwd: paths.npmDir,
+            timeout: timeout ?? DEFAULT_TIMEOUT,
+        });
+    }
+    catch (err) {
+        throw new PackageError('NPM_INSTALL_FAILED', `Failed to uninstall ${npmName}`, err);
+    }
+}
+/**
+ * Generate package.json dependencies from a lock file.
+ */
+export function generatePackageJson(lockFile) {
+    const dependencies = {};
+    for (const [, entry] of Object.entries(lockFile.packages)) {
+        dependencies[entry.npm] = entry.version;
+    }
+    return {
+        name: 'amodal-packages',
+        private: true,
+        dependencies,
+    };
+}
+/**
+ * Create or repair a symlink from the clean path to the npm node_modules path.
+ */
+export async function ensureSymlink(paths, ref) {
+    const symlinkDir = path.join(paths.root, toSymlinkName(ref.type, ref.name));
+    const target = path.join(paths.nodeModules, ref.npmName);
+    // Verify target exists
+    try {
+        await stat(target);
+    }
+    catch {
+        throw new PackageError('SYMLINK_FAILED', `Package not installed: ${ref.npmName}`);
+    }
+    // Remove existing symlink if broken or wrong target
+    try {
+        const existingTarget = await readlink(symlinkDir);
+        if (existingTarget === target)
+            return symlinkDir;
+        await unlink(symlinkDir);
+    }
+    catch (err) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        if (err.code !== 'ENOENT') {
+            // Try to remove it anyway
+            try {
+                await unlink(symlinkDir);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+    }
+    try {
+        await symlink(target, symlinkDir, 'dir');
+    }
+    catch (err) {
+        throw new PackageError('SYMLINK_FAILED', `Failed to create symlink: ${symlinkDir}`, err);
+    }
+    return symlinkDir;
+}
+/**
+ * Create symlinks for all packages in a lock file.
+ */
+export async function ensureAllSymlinks(paths, lockFile) {
+    const tasks = Object.keys(lockFile.packages).map((key) => {
+        const parsed = parsePackageKey(key);
+        const ref = makePackageRef(parsed.type, parsed.name);
+        return ensureSymlink(paths, ref);
+    });
+    await Promise.all(tasks);
+}
+/**
+ * Get the resolved package directory for an installed package.
+ * Returns null if the package is not installed or the symlink is broken.
+ */
+export async function getPackageDir(repoPath, ref) {
+    const paths = getNpmContextPaths(repoPath);
+    const symlinkDir = path.join(paths.root, toSymlinkName(ref.type, ref.name));
+    try {
+        const targetStat = await stat(symlinkDir);
+        if (targetStat.isDirectory())
+            return symlinkDir;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read version info from an installed package's package.json.
+ * Falls back to package-lock.json for integrity if _integrity is missing
+ * (common with local registries like Verdaccio).
+ */
+async function readInstalledVersion(paths, npmName) {
+    const { readFile: rf } = await import('node:fs/promises');
+    const pkgJsonPath = path.join(paths.nodeModules, npmName, 'package.json');
+    let version = '';
+    let integrity = '';
+    try {
+        const raw = await rf(pkgJsonPath, 'utf-8');
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        const pkg = JSON.parse(raw);
+        version = String(pkg['version'] ?? '');
+        integrity = String(pkg['_integrity'] ?? '');
+    }
+    catch {
+        // Package not readable
+    }
+    // If _integrity is missing, try package-lock.json
+    if (!integrity) {
+        try {
+            const lockPath = path.join(paths.npmDir, 'package-lock.json');
+            const lockRaw = await rf(lockPath, 'utf-8');
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+            const lock = JSON.parse(lockRaw);
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+            const packages = (lock['packages'] ?? {});
+            const entry = packages[`node_modules/${npmName}`];
+            if (entry) {
+                integrity = String(entry['integrity'] ?? '');
+                if (!version)
+                    version = String(entry['version'] ?? '');
+            }
+        }
+        catch {
+            // No lock file or parse failure — use what we have
+        }
+    }
+    return { version, integrity };
+}
+//# sourceMappingURL=npm-context.js.map

package/dist/src/packages/npm-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-context.js","sourceRoot":"","sources":["../../../src/packages/npm-context.ts"],"names":[],"mappings":"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"}

package/dist/src/packages/npm-registry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { NpmContextPaths } from './npm-context.js';
+/**
+ * Result from `npm view`.
+ */
+export interface NpmViewResult {
+    name: string;
+    version: string;
+    versions: string[];
+    description?: string;
+}
+/**
+ * Result from `npm search`.
+ */
+export interface NpmSearchResult {
+    name: string;
+    version: string;
+    description: string;
+}
+/**
+ * Run `npm view <pkg> --json` and parse the result.
+ */
+export declare function npmView(paths: NpmContextPaths, npmName: string, timeout?: number): Promise<NpmViewResult>;
+/**
+ * Run `npm search <query> --json` and parse the result.
+ */
+export declare function npmSearch(paths: NpmContextPaths, query: string, timeout?: number): Promise<NpmSearchResult[]>;
+/**
+ * Run `npm view <pkg> versions --json` to get all available versions.
+ */
+export declare function npmViewVersions(paths: NpmContextPaths, npmName: string, timeout?: number): Promise<string[]>;

package/dist/src/packages/npm-registry.js

@@ -0,0 +1,107 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { PackageError } from './package-error.js';
+const execFileAsync = promisify(execFile);
+const DEFAULT_TIMEOUT = 120_000;
+/**
+ * Run `npm view <pkg> --json` and parse the result.
+ */
+export async function npmView(paths, npmName, timeout) {
+    try {
+        const { stdout } = await execFileAsync('npm', ['view', npmName, '--json'], {
+            cwd: paths.npmDir,
+            timeout: timeout ?? DEFAULT_TIMEOUT,
+        });
+        let parsed;
+        try {
+            parsed = JSON.parse(stdout);
+        }
+        catch {
+            throw new PackageError('NPM_INSTALL_FAILED', `Failed to parse npm view output for ${npmName}`);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        const result = parsed;
+        return {
+            name: String(result['name'] ?? npmName),
+            version: String(result['version'] ?? ''),
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+            versions: Array.isArray(result['versions']) ? result['versions'] : [],
+            description: result['description'] ? String(result['description']) : undefined,
+        };
+    }
+    catch (err) {
+        if (err instanceof PackageError)
+            throw err;
+        throw new PackageError('NPM_INSTALL_FAILED', `Failed to view ${npmName}`, err);
+    }
+}
+/**
+ * Run `npm search <query> --json` and parse the result.
+ */
+export async function npmSearch(paths, query, timeout) {
+    try {
+        const { stdout } = await execFileAsync('npm', ['search', query, '--json'], {
+            cwd: paths.npmDir,
+            timeout: timeout ?? DEFAULT_TIMEOUT,
+        });
+        let parsed;
+        try {
+            parsed = JSON.parse(stdout);
+        }
+        catch {
+            throw new PackageError('NPM_INSTALL_FAILED', `Failed to parse npm search output for "${query}"`);
+        }
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.map((item) => {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+            const entry = item;
+            return {
+                name: String(entry['name'] ?? ''),
+                version: String(entry['version'] ?? ''),
+                description: String(entry['description'] ?? ''),
+            };
+        });
+    }
+    catch (err) {
+        if (err instanceof PackageError)
+            throw err;
+        throw new PackageError('NPM_INSTALL_FAILED', `Failed to search for "${query}"`, err);
+    }
+}
+/**
+ * Run `npm view <pkg> versions --json` to get all available versions.
+ */
+export async function npmViewVersions(paths, npmName, timeout) {
+    try {
+        const { stdout } = await execFileAsync('npm', ['view', npmName, 'versions', '--json'], {
+            cwd: paths.npmDir,
+            timeout: timeout ?? DEFAULT_TIMEOUT,
+        });
+        let parsed;
+        try {
+            parsed = JSON.parse(stdout);
+        }
+        catch {
+            throw new PackageError('NPM_INSTALL_FAILED', `Failed to parse npm view versions output for ${npmName}`);
+        }
+        if (Array.isArray(parsed)) {
+            return parsed.map((v) => String(v));
+        }
+        // Single version returns a string, not an array
+        if (typeof parsed === 'string')
+            return [parsed];
+        return [];
+    }
+    catch (err) {
+        if (err instanceof PackageError)
+            throw err;
+        throw new PackageError('NPM_INSTALL_FAILED', `Failed to view versions for ${npmName}`, err);
+    }
+}
+//# sourceMappingURL=npm-registry.js.map

package/dist/src/packages/npm-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-registry.js","sourceRoot":"","sources":["../../../src/packages/npm-registry.ts"],"names":[],"mappings":"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"}

package/dist/src/packages/package-error.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Error codes for package management failures.
+ */
+export type PackageErrorCode = 'NOT_FOUND' | 'PARSE_FAILED' | 'VALIDATION_FAILED' | 'LOCK_READ_FAILED' | 'LOCK_WRITE_FAILED' | 'NPM_INSTALL_FAILED' | 'SYMLINK_FAILED' | 'IMPORT_NOT_INSTALLED' | 'INVALID_FRONTMATTER' | 'CONFLICTING_FILTER' | 'ENV_WRITE_FAILED' | 'ENV_READ_FAILED';
+/**
+ * Error thrown during package management operations.
+ */
+export declare class PackageError extends Error {
+    readonly code: PackageErrorCode;
+    constructor(code: PackageErrorCode, message: string, cause?: unknown);
+}

package/dist/src/packages/package-error.js

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Error thrown during package management operations.
+ */
+export class PackageError extends Error {
+    code;
+    constructor(code, message, cause) {
+        super(message, { cause });
+        this.name = 'PackageError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=package-error.js.map

package/dist/src/packages/package-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-error.js","sourceRoot":"","sources":["../../../src/packages/package-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IAEhC,YAAY,IAAsB,EAAE,OAAe,EAAE,KAAe;QAClE,KAAK,CAAC,OAAO,EAAE,EAAC,KAAK,EAAC,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}