@glpkg/config 0.2.1 → 0.3.0

package/dist/cli.js

@@ -75,6 +75,24 @@ program
 const packageCmd = program
     .command('package')
     .description('Manage package registry metadata');
+// Add package manually
+packageCmd
+    .command('add <package-name>')
+    .description('Add package with GitLab group lookup')
+    .requiredOption('-g, --group <group>', 'GitLab group name')
+    .option('--host <host>', 'GitLab host', 'gitlab.com')
+    .action(async (packageName, options) => {
+    try {
+        console.log(`Looking up group "${options.group}" on ${options.host}...`);
+        const info = await (0, index_1.addPackageManually)(packageName, options.group, options.host);
+        console.log('✓ Package added successfully');
+        console.log(JSON.stringify(info, null, 2));
+    }
+    catch (error) {
+        console.error('✗ Failed to add package:', error.message);
+        process.exit(1);
+    }
+});
 // Get package info
 packageCmd
     .command('get <package-name>')
@@ -132,6 +150,83 @@ packageCmd
         process.exit(1);
     }
 });
+// Scope management commands
+const scopeCmd = program
+    .command('scope')
+    .description('Manage scope to GitLab group mappings');
+// Set scope mapping
+scopeCmd
+    .command('set <scope> <group>')
+    .description('Map a scope to a GitLab group (e.g., scope set @ist microature)')
+    .option('--host <host>', 'GitLab host', 'gitlab.com')
+    .action(async (scope, group, options) => {
+    try {
+        console.log(`Looking up group "${group}" on ${options.host}...`);
+        const mapping = await (0, index_1.setScopeMapping)(scope, group, options.host);
+        console.log('✓ Scope mapping saved');
+        console.log(JSON.stringify(mapping, null, 2));
+    }
+    catch (error) {
+        console.error('✗ Failed to set scope mapping:', error.message);
+        process.exit(1);
+    }
+});
+// Get scope mapping
+scopeCmd
+    .command('get <scope>')
+    .description('Get scope mapping information')
+    .action((scope) => {
+    const mapping = (0, index_1.getScopeMapping)(scope);
+    if (mapping) {
+        console.log(JSON.stringify(mapping, null, 2));
+    }
+    else {
+        console.error('✗ Scope not found:', scope);
+        process.exit(1);
+    }
+});
+// List all scope mappings
+scopeCmd
+    .command('list')
+    .description('List all scope mappings')
+    .action(() => {
+    const metadata = (0, index_1.getAllScopes)();
+    const scopes = Object.values(metadata.scopes);
+    if (scopes.length === 0) {
+        console.log('No scope mappings found');
+    }
+    else {
+        console.log(JSON.stringify(metadata, null, 2));
+    }
+});
+// Remove scope mapping
+scopeCmd
+    .command('remove <scope>')
+    .description('Remove scope mapping')
+    .action((scope) => {
+    const removed = (0, index_1.removeScopeMapping)(scope);
+    if (removed) {
+        console.log('✓ Scope mapping removed:', scope);
+    }
+    else {
+        console.error('✗ Scope not found:', scope);
+        process.exit(1);
+    }
+});
+// Clear all scope mappings
+scopeCmd
+    .command('clear')
+    .description('Clear all scope mappings')
+    .action(() => {
+    try {
+        (0, index_1.clearAllScopes)();
+        console.log('✓ All scope mappings cleared');
+    }
+    catch (error) {
+        console.error('✗ Failed to clear scope mappings:', error.message);
+        process.exit(1);
+    }
+});
 program.parse();
 // Show help if no command provided
 if (!process.argv.slice(2).length) {

package/dist/index.d.ts

@@ -35,6 +35,39 @@ export interface PackageInfo {
 export interface PackageRegistryMetadata {
     packages: Record<string, PackageInfo>;
 }
+/**
+ * Scope mapping information
+ */
+export interface ScopeMapping {
+    /** Scope name without @ (e.g., "ist") */
+    scope: string;
+    /** GitLab group name */
+    group: string;
+    /** GitLab group ID */
+    groupId: number;
+    /** GitLab host */
+    gitlabHost: string;
+    /** Registry URL for this scope */
+    registryUrl: string;
+    /** Created timestamp */
+    createdAt: string;
+}
+/**
+ * Scope registry metadata structure
+ */
+export interface ScopeRegistryMetadata {
+    scopes: Record<string, ScopeMapping>;
+}
+/**
+ * GitLab group API response
+ */
+interface GitLabGroupResponse {
+    id: number;
+    name: string;
+    path: string;
+    full_path: string;
+    web_url: string;
+}
 /**
  * Save GitLab token to user config directory
  * @param token - GitLab personal access token
@@ -56,6 +89,7 @@ export declare function hasToken(): boolean;
 export declare function removeToken(): void;
 /**
  * Get package information by package name
+ * Falls back to scope mapping if package is not directly registered
  * @param packageName - Package name (e.g., "@another/lib-name")
  * @returns Package info or null if not found
  */
@@ -92,3 +126,49 @@ export declare function hasPackageInfo(packageName: string): boolean;
  * Clear all package registry metadata
  */
 export declare function clearAllPackages(): void;
+/**
+ * Get scope mapping by scope name
+ * @param scope - Scope name (with or without @)
+ */
+export declare function getScopeMapping(scope: string): ScopeMapping | null;
+/**
+ * Get all scope mappings
+ */
+export declare function getAllScopes(): ScopeRegistryMetadata;
+/**
+ * Save scope mapping
+ * @param mapping - Scope mapping to save
+ */
+export declare function saveScopeMapping(mapping: ScopeMapping): void;
+/**
+ * Remove scope mapping
+ * @param scope - Scope name to remove
+ * @returns true if removed, false if not found
+ */
+export declare function removeScopeMapping(scope: string): boolean;
+/**
+ * Clear all scope mappings
+ */
+export declare function clearAllScopes(): void;
+/**
+ * Fetch GitLab group information by group name
+ * @param groupName - GitLab group/namespace name
+ * @param gitlabHost - GitLab host (default: gitlab.com)
+ * @returns Group information or throws error
+ */
+export declare function fetchGitLabGroup(groupName: string, gitlabHost?: string): Promise<GitLabGroupResponse>;
+/**
+ * Add package manually with GitLab group lookup
+ * @param packageName - Package name (e.g., "@ist/monitor-server")
+ * @param groupName - GitLab group name
+ * @param gitlabHost - GitLab host (default: gitlab.com)
+ */
+export declare function addPackageManually(packageName: string, groupName: string, gitlabHost?: string): Promise<PackageInfo>;
+/**
+ * Set scope mapping with GitLab group lookup
+ * @param scope - Scope name (e.g., "@ist" or "ist")
+ * @param groupName - GitLab group name
+ * @param gitlabHost - GitLab host (default: gitlab.com)
+ */
+export declare function setScopeMapping(scope: string, groupName: string, gitlabHost?: string): Promise<ScopeMapping>;
+export {};

package/dist/index.js

@@ -44,12 +44,21 @@ exports.savePackageInfo = savePackageInfo;
 exports.removePackageInfo = removePackageInfo;
 exports.hasPackageInfo = hasPackageInfo;
 exports.clearAllPackages = clearAllPackages;
+exports.getScopeMapping = getScopeMapping;
+exports.getAllScopes = getAllScopes;
+exports.saveScopeMapping = saveScopeMapping;
+exports.removeScopeMapping = removeScopeMapping;
+exports.clearAllScopes = clearAllScopes;
+exports.fetchGitLabGroup = fetchGitLabGroup;
+exports.addPackageManually = addPackageManually;
+exports.setScopeMapping = setScopeMapping;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const CONFIG_DIR = path.join(os.homedir(), '.config', 'gitlab-config');
 const TOKEN_FILE = path.join(CONFIG_DIR, 'token');
 const PACKAGE_REGISTRY_FILE = path.join(CONFIG_DIR, 'package-registry.json');
+const SCOPE_REGISTRY_FILE = path.join(CONFIG_DIR, 'scope-registry.json');
 /**
  * Ensure the config directory exists
  */
@@ -126,14 +135,51 @@ function savePackageRegistry(metadata) {
     ensureConfigDir();
     fs.writeFileSync(PACKAGE_REGISTRY_FILE, JSON.stringify(metadata, null, 2), { mode: 0o644 });
 }
+/**
+ * Extract scope from package name
+ * @param packageName - Package name (e.g., "@ist/monitor-server")
+ * @returns Scope without @ or null if no scope
+ */
+function extractScope(packageName) {
+    if (packageName.startsWith('@')) {
+        const slashIndex = packageName.indexOf('/');
+        if (slashIndex > 1) {
+            return packageName.slice(1, slashIndex);
+        }
+    }
+    return null;
+}
 /**
  * Get package information by package name
+ * Falls back to scope mapping if package is not directly registered
  * @param packageName - Package name (e.g., "@another/lib-name")
  * @returns Package info or null if not found
  */
 function getPackageInfo(packageName) {
     const metadata = loadPackageRegistry();
-    return metadata.packages[packageName] || null;
+    // First, check direct package registration
+    if (metadata.packages[packageName]) {
+        return metadata.packages[packageName];
+    }
+    // Fallback: check scope mapping
+    const scope = extractScope(packageName);
+    if (scope) {
+        const scopeMapping = getScopeMapping(scope);
+        if (scopeMapping) {
+            // Create virtual PackageInfo from scope mapping
+            return {
+                packageName,
+                group: scopeMapping.group,
+                groupId: scopeMapping.groupId,
+                registryType: 'group',
+                registryUrl: scopeMapping.registryUrl,
+                gitlabHost: scopeMapping.gitlabHost,
+                lastUpdated: scopeMapping.createdAt,
+                source: 'detected', // Detected via scope mapping
+            };
+        }
+    }
+    return null;
 }
 /**
  * Get all package information
@@ -193,3 +239,160 @@ function clearAllPackages() {
         fs.unlinkSync(PACKAGE_REGISTRY_FILE);
     }
 }
+// ============================================================================
+// Scope Registry Management
+// ============================================================================
+/**
+ * Load scope registry metadata from file
+ */
+function loadScopeRegistry() {
+    if (!fs.existsSync(SCOPE_REGISTRY_FILE)) {
+        return { scopes: {} };
+    }
+    try {
+        const content = fs.readFileSync(SCOPE_REGISTRY_FILE, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        return { scopes: {} };
+    }
+}
+/**
+ * Save scope registry metadata to file
+ */
+function saveScopeRegistry(metadata) {
+    ensureConfigDir();
+    fs.writeFileSync(SCOPE_REGISTRY_FILE, JSON.stringify(metadata, null, 2), { mode: 0o644 });
+}
+/**
+ * Normalize scope name (remove @ prefix if present)
+ */
+function normalizeScope(scope) {
+    return scope.startsWith('@') ? scope.slice(1) : scope;
+}
+/**
+ * Get scope mapping by scope name
+ * @param scope - Scope name (with or without @)
+ */
+function getScopeMapping(scope) {
+    const normalizedScope = normalizeScope(scope);
+    const metadata = loadScopeRegistry();
+    return metadata.scopes[normalizedScope] || null;
+}
+/**
+ * Get all scope mappings
+ */
+function getAllScopes() {
+    return loadScopeRegistry();
+}
+/**
+ * Save scope mapping
+ * @param mapping - Scope mapping to save
+ */
+function saveScopeMapping(mapping) {
+    const metadata = loadScopeRegistry();
+    mapping.scope = normalizeScope(mapping.scope);
+    mapping.createdAt = new Date().toISOString();
+    metadata.scopes[mapping.scope] = mapping;
+    saveScopeRegistry(metadata);
+}
+/**
+ * Remove scope mapping
+ * @param scope - Scope name to remove
+ * @returns true if removed, false if not found
+ */
+function removeScopeMapping(scope) {
+    const normalizedScope = normalizeScope(scope);
+    const metadata = loadScopeRegistry();
+    if (metadata.scopes[normalizedScope]) {
+        delete metadata.scopes[normalizedScope];
+        saveScopeRegistry(metadata);
+        return true;
+    }
+    return false;
+}
+/**
+ * Clear all scope mappings
+ */
+function clearAllScopes() {
+    if (fs.existsSync(SCOPE_REGISTRY_FILE)) {
+        fs.unlinkSync(SCOPE_REGISTRY_FILE);
+    }
+}
+// ============================================================================
+// GitLab API Integration
+// ============================================================================
+/**
+ * Fetch GitLab group information by group name
+ * @param groupName - GitLab group/namespace name
+ * @param gitlabHost - GitLab host (default: gitlab.com)
+ * @returns Group information or throws error
+ */
+async function fetchGitLabGroup(groupName, gitlabHost = 'gitlab.com') {
+    const token = getToken();
+    if (!token) {
+        throw new Error('GitLab token not configured. Run: gitlab-config save <token>');
+    }
+    const encodedGroup = encodeURIComponent(groupName);
+    const url = `https://${gitlabHost}/api/v4/groups/${encodedGroup}`;
+    const response = await fetch(url, {
+        headers: {
+            'PRIVATE-TOKEN': token,
+        },
+    });
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new Error(`Group not found: ${groupName}`);
+        }
+        if (response.status === 401) {
+            throw new Error('Invalid or expired GitLab token');
+        }
+        throw new Error(`GitLab API error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+}
+/**
+ * Add package manually with GitLab group lookup
+ * @param packageName - Package name (e.g., "@ist/monitor-server")
+ * @param groupName - GitLab group name
+ * @param gitlabHost - GitLab host (default: gitlab.com)
+ */
+async function addPackageManually(packageName, groupName, gitlabHost = 'gitlab.com') {
+    // Fetch group info from GitLab API
+    const groupInfo = await fetchGitLabGroup(groupName, gitlabHost);
+    const registryUrl = `https://${gitlabHost}/api/v4/groups/${groupInfo.id}/-/packages/npm/`;
+    const packageInfo = {
+        packageName,
+        group: groupName,
+        groupId: groupInfo.id,
+        registryType: 'group',
+        registryUrl,
+        gitlabHost,
+        lastUpdated: new Date().toISOString(),
+        source: 'manual',
+    };
+    savePackageInfo(packageInfo);
+    return packageInfo;
+}
+/**
+ * Set scope mapping with GitLab group lookup
+ * @param scope - Scope name (e.g., "@ist" or "ist")
+ * @param groupName - GitLab group name
+ * @param gitlabHost - GitLab host (default: gitlab.com)
+ */
+async function setScopeMapping(scope, groupName, gitlabHost = 'gitlab.com') {
+    // Fetch group info from GitLab API
+    const groupInfo = await fetchGitLabGroup(groupName, gitlabHost);
+    const normalizedScope = normalizeScope(scope);
+    const registryUrl = `https://${gitlabHost}/api/v4/groups/${groupInfo.id}/-/packages/npm/`;
+    const mapping = {
+        scope: normalizedScope,
+        group: groupName,
+        groupId: groupInfo.id,
+        gitlabHost,
+        registryUrl,
+        createdAt: new Date().toISOString(),
+    };
+    saveScopeMapping(mapping);
+    return mapping;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glpkg/config",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "GitLab configuration management - save and load tokens from user config directory",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",