@glpkg/config 0.2.1

package/.cli-docs.json

@@ -0,0 +1,12 @@
+{
+  "version": "1.0.0",
+  "outputDir": "./docs/cli",
+  "clis": {
+    "gitlab-config": {
+      "command": "gitlab-config",
+      "outputFile": "gitlab-config-cli.md",
+      "lastUpdated": "2025-10-04T13:52:41.838Z",
+      "includeSubcommands": true
+    }
+  }
+}

package/README.md

@@ -0,0 +1,71 @@
+# @microature/gitlab-config
+
+GitLab configuration management - save and load tokens from user config directory (`~/.config/gitlab-config`).
+
+## Installation
+
+```bash
+npm install -g @microature/gitlab-config
+```
+
+## Usage
+
+### CLI
+
+```bash
+# Save a token
+gitlab-config save glpat-your-token-here
+
+# Get saved token
+gitlab-config get
+
+# Check if token exists
+gitlab-config check
+
+# Remove token
+gitlab-config remove
+```
+
+See [CLI Documentation](./docs/cli/gitlab-config-cli.md) for detailed command reference.
+
+### Programmatic API
+
+```typescript
+import { saveToken, getToken, hasToken, removeToken } from '@microature/gitlab-config';
+
+// Save a token
+saveToken('glpat-your-token-here');
+
+// Get the token
+const token = getToken(); // Returns token or null if not found
+
+// Check if token exists
+if (hasToken()) {
+  console.log('Token is configured');
+}
+
+// Remove the token
+removeToken();
+```
+
+## API
+
+See the [API documentation](./docs/markdown/gitlab-config.md) for detailed information.
+
+### Functions
+
+- **`saveToken(token: string): void`** - Save GitLab token to `~/.config/gitlab-config/token`
+- **`getToken(): string | null`** - Get GitLab token or null if not found
+- **`hasToken(): boolean`** - Check if token exists
+- **`removeToken(): void`** - Remove saved token
+
+## How It Works
+
+- Tokens are stored in `~/.config/gitlab-config/token`
+- The config directory is automatically created if it doesn't exist
+- Token file is created with `0600` permissions (read/write for owner only)
+- Returns `null` if token file doesn't exist or is empty
+
+## License
+
+ISC

package/api-extractor.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+
+  "mainEntryPointFilePath": "<projectFolder>/dist/index.d.ts",
+
+  "compiler": {
+    "tsconfigFilePath": "<projectFolder>/tsconfig.json"
+  },
+
+  "apiReport": {
+    "enabled": true,
+    "reportFolder": "<projectFolder>/docs",
+    "reportFileName": "gitlab-config.api.md"
+  },
+
+  "docModel": {
+    "enabled": true,
+    "apiJsonFilePath": "<projectFolder>/docs/<unscopedPackageName>.api.json"
+  },
+
+  "dtsRollup": {
+    "enabled": false
+  },
+
+  "tsdocMetadata": {
+    "enabled": false
+  },
+
+  "messages": {
+    "extractorMessageReporting": {
+      "default": {
+        "logLevel": "warning"
+      }
+    }
+  }
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const index_1 = require("./index");
+const packageJson = require('../package.json');
+const program = new commander_1.Command();
+program
+    .name('gitlab-config')
+    .description('Manage GitLab configuration and tokens')
+    .version(packageJson.version);
+// Save token command
+program
+    .command('save <token>')
+    .description('Save GitLab token to ~/.config/gitlab-config/token')
+    .action((token) => {
+    try {
+        (0, index_1.saveToken)(token);
+        console.log('✓ Token saved successfully');
+    }
+    catch (error) {
+        console.error('✗ Failed to save token:', error.message);
+        process.exit(1);
+    }
+});
+// Get token command
+program
+    .command('get')
+    .description('Get saved GitLab token')
+    .action(() => {
+    try {
+        const token = (0, index_1.getToken)();
+        if (token) {
+            console.log(token);
+        }
+        else {
+            console.error('✗ No token found');
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('✗ Failed to get token:', error.message);
+        process.exit(1);
+    }
+});
+// Check token command
+program
+    .command('check')
+    .description('Check if token exists')
+    .action(() => {
+    if ((0, index_1.hasToken)()) {
+        console.log('✓ Token is configured');
+        process.exit(0);
+    }
+    else {
+        console.log('✗ No token found');
+        process.exit(1);
+    }
+});
+// Remove token command
+program
+    .command('remove')
+    .description('Remove saved token')
+    .action(() => {
+    try {
+        (0, index_1.removeToken)();
+        console.log('✓ Token removed successfully');
+    }
+    catch (error) {
+        console.error('✗ Failed to remove token:', error.message);
+        process.exit(1);
+    }
+});
+// Package management commands
+const packageCmd = program
+    .command('package')
+    .description('Manage package registry metadata');
+// Get package info
+packageCmd
+    .command('get <package-name>')
+    .description('Get package registry information')
+    .action((packageName) => {
+    const info = (0, index_1.getPackageInfo)(packageName);
+    if (info) {
+        console.log(JSON.stringify(info, null, 2));
+    }
+    else {
+        console.error('✗ Package not found:', packageName);
+        process.exit(1);
+    }
+});
+// List all packages
+packageCmd
+    .command('list')
+    .description('List all registered packages')
+    .option('-g, --group <group>', 'Filter by group name')
+    .action((options) => {
+    if (options.group) {
+        const packages = (0, index_1.searchPackagesByGroup)(options.group);
+        console.log(JSON.stringify(packages, null, 2));
+    }
+    else {
+        const metadata = (0, index_1.getAllPackages)();
+        console.log(JSON.stringify(metadata, null, 2));
+    }
+});
+// Remove package info
+packageCmd
+    .command('remove <package-name>')
+    .description('Remove package registry information')
+    .action((packageName) => {
+    const removed = (0, index_1.removePackageInfo)(packageName);
+    if (removed) {
+        console.log('✓ Package removed:', packageName);
+    }
+    else {
+        console.error('✗ Package not found:', packageName);
+        process.exit(1);
+    }
+});
+// Clear all packages
+packageCmd
+    .command('clear')
+    .description('Clear all package registry metadata')
+    .action(() => {
+    try {
+        (0, index_1.clearAllPackages)();
+        console.log('✓ All package metadata cleared');
+    }
+    catch (error) {
+        console.error('✗ Failed to clear packages:', error.message);
+        process.exit(1);
+    }
+});
+program.parse();
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Package registry type - where the package is stored
+ */
+export type RegistryType = 'group' | 'project';
+/**
+ * Source of package information
+ */
+export type PackageInfoSource = 'published' | 'manual' | 'detected';
+/**
+ * Package registry information
+ */
+export interface PackageInfo {
+    /** Package name (e.g., "@another/lib-name" or "my-lib") */
+    packageName: string;
+    /** GitLab group/namespace (e.g., "my-company") */
+    group: string;
+    /** GitLab group ID (optional) */
+    groupId?: number;
+    /** GitLab project ID (optional) */
+    projectId?: number;
+    /** Registry type */
+    registryType: RegistryType;
+    /** Full registry URL */
+    registryUrl: string;
+    /** GitLab host (e.g., "gitlab.com") */
+    gitlabHost: string;
+    /** Last updated timestamp (ISO format) */
+    lastUpdated: string;
+    /** Source of this information */
+    source: PackageInfoSource;
+}
+/**
+ * Package registry metadata structure
+ */
+export interface PackageRegistryMetadata {
+    packages: Record<string, PackageInfo>;
+}
+/**
+ * Save GitLab token to user config directory
+ * @param token - GitLab personal access token
+ */
+export declare function saveToken(token: string): void;
+/**
+ * Get GitLab token from user config directory
+ * @returns GitLab token or null if not found
+ */
+export declare function getToken(): string | null;
+/**
+ * Check if token exists
+ * @returns true if token exists
+ */
+export declare function hasToken(): boolean;
+/**
+ * Remove saved token
+ */
+export declare function removeToken(): void;
+/**
+ * Get package information by package name
+ * @param packageName - Package name (e.g., "@another/lib-name")
+ * @returns Package info or null if not found
+ */
+export declare function getPackageInfo(packageName: string): PackageInfo | null;
+/**
+ * Get all package information
+ * @returns All package registry metadata
+ */
+export declare function getAllPackages(): PackageRegistryMetadata;
+/**
+ * Search packages by group name
+ * @param group - GitLab group name
+ * @returns Array of package info for the group
+ */
+export declare function searchPackagesByGroup(group: string): PackageInfo[];
+/**
+ * Save package information
+ * @param info - Package information to save
+ */
+export declare function savePackageInfo(info: PackageInfo): void;
+/**
+ * Remove package information
+ * @param packageName - Package name to remove
+ * @returns true if removed, false if not found
+ */
+export declare function removePackageInfo(packageName: string): boolean;
+/**
+ * Check if package information exists
+ * @param packageName - Package name to check
+ * @returns true if package info exists
+ */
+export declare function hasPackageInfo(packageName: string): boolean;
+/**
+ * Clear all package registry metadata
+ */
+export declare function clearAllPackages(): void;

package/dist/index.js

@@ -0,0 +1,195 @@
+"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.saveToken = saveToken;
+exports.getToken = getToken;
+exports.hasToken = hasToken;
+exports.removeToken = removeToken;
+exports.getPackageInfo = getPackageInfo;
+exports.getAllPackages = getAllPackages;
+exports.searchPackagesByGroup = searchPackagesByGroup;
+exports.savePackageInfo = savePackageInfo;
+exports.removePackageInfo = removePackageInfo;
+exports.hasPackageInfo = hasPackageInfo;
+exports.clearAllPackages = clearAllPackages;
+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');
+/**
+ * Ensure the config directory exists
+ */
+function ensureConfigDir() {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+}
+/**
+ * Save GitLab token to user config directory
+ * @param token - GitLab personal access token
+ */
+function saveToken(token) {
+    if (!token || token.trim().length === 0) {
+        throw new Error('Token cannot be empty');
+    }
+    ensureConfigDir();
+    fs.writeFileSync(TOKEN_FILE, token.trim(), { mode: 0o600 });
+}
+/**
+ * Get GitLab token from user config directory
+ * @returns GitLab token or null if not found
+ */
+function getToken() {
+    if (!fs.existsSync(TOKEN_FILE)) {
+        return null;
+    }
+    try {
+        const token = fs.readFileSync(TOKEN_FILE, 'utf-8').trim();
+        return token.length > 0 ? token : null;
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Check if token exists
+ * @returns true if token exists
+ */
+function hasToken() {
+    return getToken() !== null;
+}
+/**
+ * Remove saved token
+ */
+function removeToken() {
+    if (fs.existsSync(TOKEN_FILE)) {
+        fs.unlinkSync(TOKEN_FILE);
+    }
+}
+// ============================================================================
+// Package Registry Metadata Management
+// ============================================================================
+/**
+ * Load package registry metadata from file
+ */
+function loadPackageRegistry() {
+    if (!fs.existsSync(PACKAGE_REGISTRY_FILE)) {
+        return { packages: {} };
+    }
+    try {
+        const content = fs.readFileSync(PACKAGE_REGISTRY_FILE, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        // If file is corrupted, return empty metadata
+        return { packages: {} };
+    }
+}
+/**
+ * Save package registry metadata to file
+ */
+function savePackageRegistry(metadata) {
+    ensureConfigDir();
+    fs.writeFileSync(PACKAGE_REGISTRY_FILE, JSON.stringify(metadata, null, 2), { mode: 0o644 });
+}
+/**
+ * Get package information by package name
+ * @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;
+}
+/**
+ * Get all package information
+ * @returns All package registry metadata
+ */
+function getAllPackages() {
+    return loadPackageRegistry();
+}
+/**
+ * Search packages by group name
+ * @param group - GitLab group name
+ * @returns Array of package info for the group
+ */
+function searchPackagesByGroup(group) {
+    const metadata = loadPackageRegistry();
+    return Object.values(metadata.packages).filter((pkg) => pkg.group === group);
+}
+/**
+ * Save package information
+ * @param info - Package information to save
+ */
+function savePackageInfo(info) {
+    const metadata = loadPackageRegistry();
+    // Update lastUpdated timestamp
+    info.lastUpdated = new Date().toISOString();
+    // Save package info
+    metadata.packages[info.packageName] = info;
+    savePackageRegistry(metadata);
+}
+/**
+ * Remove package information
+ * @param packageName - Package name to remove
+ * @returns true if removed, false if not found
+ */
+function removePackageInfo(packageName) {
+    const metadata = loadPackageRegistry();
+    if (metadata.packages[packageName]) {
+        delete metadata.packages[packageName];
+        savePackageRegistry(metadata);
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if package information exists
+ * @param packageName - Package name to check
+ * @returns true if package info exists
+ */
+function hasPackageInfo(packageName) {
+    return getPackageInfo(packageName) !== null;
+}
+/**
+ * Clear all package registry metadata
+ */
+function clearAllPackages() {
+    if (fs.existsSync(PACKAGE_REGISTRY_FILE)) {
+        fs.unlinkSync(PACKAGE_REGISTRY_FILE);
+    }
+}

package/docs/cli/gitlab-config-cli.md

@@ -0,0 +1,72 @@
+# gitlab-config CLI Reference
+
+_Last updated: 2025-10-04T13:52:42.021Z_
+
+## Main Command
+
+```
+Usage: gitlab-config [options] [command]
+
+Manage GitLab configuration and tokens
+
+Options:
+  -V, --version   output the version number
+  -h, --help      display help for command
+
+Commands:
+  save <token>    Save GitLab token to ~/.config/gitlab-config/token
+  get             Get saved GitLab token
+  check           Check if token exists
+  remove          Remove saved token
+  help [command]  display help for command
+```
+
+## Subcommands
+
+### save
+
+```
+Usage: gitlab-config save [options] <token>
+
+Save GitLab token to ~/.config/gitlab-config/token
+
+Options:
+  -h, --help  display help for command
+```
+
+### get
+
+```
+Usage: gitlab-config get [options]
+
+Get saved GitLab token
+
+Options:
+  -h, --help  display help for command
+```
+
+### check
+
+```
+Usage: gitlab-config check [options]
+
+Check if token exists
+
+Options:
+  -h, --help  display help for command
+```
+
+### remove
+
+```
+Usage: gitlab-config remove [options]
+
+Remove saved token
+
+Options:
+  -h, --help  display help for command
+```
+
+---
+
+_Generated by [cli-docs](https://gitlab.com/microature/cli-docs)_

package/docs/cli/index.md

@@ -0,0 +1,11 @@
+# CLI Documentation
+
+_Last updated: 2025-10-04T13:52:42.021Z_
+
+## Available CLIs
+
+- [gitlab-config](./gitlab-config-cli.md)
+
+---
+
+_Generated by [cli-docs](https://gitlab.com/microature/cli-docs)_

package/docs/typedoc-md/README.md

@@ -0,0 +1,55 @@
+**@microature/gitlab-config**
+
+***
+
+# @microature/gitlab-config
+
+GitLab configuration management - save and load tokens from user config directory (`~/.config/gitlab-config`).
+
+## Installation
+
+```bash
+npm install @microature/gitlab-config
+```
+
+## Usage
+
+```typescript
+import { saveToken, getToken, hasToken, removeToken } from '@microature/gitlab-config';
+
+// Save a token
+saveToken('glpat-your-token-here');
+
+// Get the token
+const token = getToken(); // Returns token or null if not found
+
+// Check if token exists
+if (hasToken()) {
+  console.log('Token is configured');
+}
+
+// Remove the token
+removeToken();
+```
+
+## API
+
+See the [API documentation](_media/gitlab-config.md) for detailed information.
+
+### Functions
+
+- **`saveToken(token: string): void`** - Save GitLab token to `~/.config/gitlab-config/token`
+- **`getToken(): string | null`** - Get GitLab token or null if not found
+- **`hasToken(): boolean`** - Check if token exists
+- **`removeToken(): void`** - Remove saved token
+
+## How It Works
+
+- Tokens are stored in `~/.config/gitlab-config/token`
+- The config directory is automatically created if it doesn't exist
+- Token file is created with `0600` permissions (read/write for owner only)
+- Returns `null` if token file doesn't exist or is empty
+
+## License
+
+ISC

package/docs/typedoc-md/_media/gitlab-config.md

@@ -0,0 +1,65 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@microature/gitlab-config](./gitlab-config.md)
+
+## gitlab-config package
+
+## Functions
+
+<table><thead><tr><th>
+
+Function
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[getToken()](./gitlab-config.gettoken.md)
+
+
+</td><td>
+
+Get GitLab token from user config directory
+
+
+</td></tr>
+<tr><td>
+
+[hasToken()](./gitlab-config.hastoken.md)
+
+
+</td><td>
+
+Check if token exists
+
+
+</td></tr>
+<tr><td>
+
+[removeToken()](./gitlab-config.removetoken.md)
+
+
+</td><td>
+
+Remove saved token
+
+
+</td></tr>
+<tr><td>
+
+[saveToken(token)](./gitlab-config.savetoken.md)
+
+
+</td><td>
+
+Save GitLab token to user config directory
+
+
+</td></tr>
+</tbody></table>
+

package/docs/typedoc-md/functions/getToken.md

@@ -0,0 +1,19 @@
+[**@microature/gitlab-config**](../README.md)
+
+***
+
+[@microature/gitlab-config](../globals.md) / getToken
+
+# Function: getToken()
+
+> **getToken**(): `null` \| `string`
+
+Defined in: index.ts:34
+
+Get GitLab token from user config directory
+
+## Returns
+
+`null` \| `string`
+
+GitLab token or null if not found

package/docs/typedoc-md/functions/hasToken.md

@@ -0,0 +1,19 @@
+[**@microature/gitlab-config**](../README.md)
+
+***
+
+[@microature/gitlab-config](../globals.md) / hasToken
+
+# Function: hasToken()
+
+> **hasToken**(): `boolean`
+
+Defined in: index.ts:51
+
+Check if token exists
+
+## Returns
+
+`boolean`
+
+true if token exists

package/docs/typedoc-md/functions/removeToken.md

@@ -0,0 +1,17 @@
+[**@microature/gitlab-config**](../README.md)
+
+***
+
+[@microature/gitlab-config](../globals.md) / removeToken
+
+# Function: removeToken()
+
+> **removeToken**(): `void`
+
+Defined in: index.ts:58
+
+Remove saved token
+
+## Returns
+
+`void`

package/docs/typedoc-md/functions/saveToken.md

@@ -0,0 +1,25 @@
+[**@microature/gitlab-config**](../README.md)
+
+***
+
+[@microature/gitlab-config](../globals.md) / saveToken
+
+# Function: saveToken()
+
+> **saveToken**(`token`): `void`
+
+Defined in: index.ts:21
+
+Save GitLab token to user config directory
+
+## Parameters
+
+### token
+
+`string`
+
+GitLab personal access token
+
+## Returns
+
+`void`

package/docs/typedoc-md/globals.md

@@ -0,0 +1,12 @@
+[**@microature/gitlab-config**](README.md)
+
+***
+
+# @microature/gitlab-config
+
+## Functions
+
+- [getToken](functions/getToken.md)
+- [hasToken](functions/hasToken.md)
+- [removeToken](functions/removeToken.md)
+- [saveToken](functions/saveToken.md)

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@glpkg/config",
+  "version": "0.2.1",
+  "description": "GitLab configuration management - save and load tokens from user config directory",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "gitlab-config": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "prepublishOnly": "npm run build",
+    "docs": "npm run docs:api && npm run docs:cli",
+    "docs:api": "typedoc --out docs/typedoc-md --plugin typedoc-plugin-markdown src/index.ts",
+    "docs:cli": "cli-docs update",
+    "publish:dev": "gitlab-publish dev",
+    "publish:minor": "gitlab-publish --bump minor",
+    "publish:patch": "gitlab-publish --bump patch"
+  },
+  "keywords": [
+    "gitlab",
+    "config",
+    "token"
+  ],
+  "author": "",
+  "license": "ISC",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@microsoft/api-documenter": "^7.27.0",
+    "@microsoft/api-extractor": "^7.53.0",
+    "@types/node": "^24.5.2",
+    "typedoc": "^0.28.13",
+    "typedoc-plugin-markdown": "^4.9.0",
+    "typescript": "^5.9.2",
+    "vitest": "^2.1.9"
+  },
+  "dependencies": {
+    "commander": "^14.0.1"
+  }
+}