@micar-tsp/skillhub 0.1.0

package/dist/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { CONTACT_EMAIL, DEFAULT_BASE_URL, FRONTEND_URL } from './lib/constants.js';
+import { printError } from './format/output.js';
+import { registerConfigCommands } from './commands/config.js';
+import { registerUserCommands } from './commands/user.js';
+import { registerSkillCommands } from './commands/skills.js';
+import { registerPublishCommand } from './commands/publish.js';
+async function main() {
+    const program = new Command();
+    program
+        .name('skillhub')
+        .description([
+        'Local SkillHub CLI for token-authenticated skill management.',
+        '',
+        `Default base URL: ${DEFAULT_BASE_URL}`,
+        `Frontend page: ${FRONTEND_URL}`,
+        `Contact: ${CONTACT_EMAIL}`
+    ].join('\n'))
+        .version('0.1.0')
+        .option('--base-url <url>', 'Override configured/default base URL')
+        .option('--token <token>', 'Override configured token for this command')
+        .option('--json', 'Output JSON')
+        .option('--verbose', 'Show detailed error information')
+        .showHelpAfterError();
+    registerConfigCommands(program);
+    registerUserCommands(program);
+    registerSkillCommands(program);
+    registerPublishCommand(program);
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (error) {
+        printError(error, Boolean(program.opts().verbose));
+        process.exitCode = 1;
+    }
+}
+void main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAE9D,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;IAC7B,OAAO;SACJ,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CAAC;QACX,8DAA8D;QAC9D,EAAE;QACF,qBAAqB,gBAAgB,EAAE;QACvC,kBAAkB,YAAY,EAAE;QAChC,YAAY,aAAa,EAAE;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACZ,OAAO,CAAC,OAAO,CAAC;SAChB,MAAM,CAAC,kBAAkB,EAAE,sCAAsC,CAAC;SAClE,MAAM,CAAC,iBAAiB,EAAE,4CAA4C,CAAC;SACvE,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC;SAC/B,MAAM,CAAC,WAAW,EAAE,iCAAiC,CAAC;SACtD,kBAAkB,EAAE,CAAA;IAEvB,sBAAsB,CAAC,OAAO,CAAC,CAAA;IAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAA;IAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAA;IAC9B,sBAAsB,CAAC,OAAO,CAAC,CAAA;IAE/B,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAyB,CAAC,OAAO,CAAC,CAAC,CAAA;QACzE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACtB,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAA"}

package/dist/lib/api.d.ts

@@ -0,0 +1,29 @@
+export interface RequestOptions {
+    baseUrl: string;
+    token?: string;
+    verbose?: boolean;
+}
+export interface ApiEnvelope<T> {
+    code: number;
+    message: string;
+    data: T;
+    timestamp?: string;
+    requestId?: string;
+}
+export declare class SkillHubApiClient {
+    private readonly options;
+    constructor(options: RequestOptions);
+    getJson<T>(path: string, params?: Record<string, string | number | string[] | undefined>): Promise<T>;
+    postJson<T>(path: string, body?: unknown): Promise<T>;
+    download(path: string, params?: Record<string, string | number | string[] | undefined>): Promise<{
+        bytes: Uint8Array;
+        fileName?: string;
+        contentType?: string;
+    }>;
+    uploadMultipart<T>(path: string, form: FormData): Promise<T>;
+    private requestJson;
+    private headers;
+    private buildUrl;
+    private throwHttpError;
+}
+export declare function requireToken(token: string | undefined): string;

package/dist/lib/api.js

@@ -0,0 +1,108 @@
+import { API_PREFIX } from './constants.js';
+import { CliError } from './errors.js';
+export class SkillHubApiClient {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async getJson(path, params) {
+        return this.requestJson('GET', path, undefined, params);
+    }
+    async postJson(path, body) {
+        return this.requestJson('POST', path, body);
+    }
+    async download(path, params) {
+        const request = this.buildUrl(path, params);
+        const response = await fetch(request, { headers: this.headers() });
+        if (!response.ok)
+            await this.throwHttpError(response, 'GET', request);
+        const arrayBuffer = await response.arrayBuffer();
+        return {
+            bytes: new Uint8Array(arrayBuffer),
+            fileName: parseContentDispositionFileName(response.headers.get('content-disposition')),
+            contentType: response.headers.get('content-type') ?? undefined
+        };
+    }
+    async uploadMultipart(path, form) {
+        return this.requestJson('POST', path, form);
+    }
+    async requestJson(method, path, body, params) {
+        const request = this.buildUrl(path, params);
+        const headers = this.headers(body instanceof FormData ? undefined : 'application/json');
+        const response = await fetch(request, {
+            method,
+            headers,
+            body: body === undefined ? undefined : body instanceof FormData ? body : JSON.stringify(body)
+        });
+        if (!response.ok)
+            await this.throwHttpError(response, method, request);
+        const envelope = (await response.json());
+        if (envelope.code !== 0) {
+            throw new CliError(envelope.message || 'SkillHub request failed.', {
+                request: `${method} ${request}`,
+                status: response.status,
+                requestId: envelope.requestId,
+                backendMessage: envelope.message
+            });
+        }
+        return envelope.data;
+    }
+    headers(contentType) {
+        const headers = { Accept: 'application/json' };
+        if (contentType)
+            headers['Content-Type'] = contentType;
+        if (this.options.token)
+            headers.Authorization = `Bearer ${this.options.token}`;
+        return headers;
+    }
+    buildUrl(path, params) {
+        const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+        const url = new URL(`${this.options.baseUrl}${API_PREFIX}${normalizedPath}`);
+        for (const [key, value] of Object.entries(params ?? {})) {
+            if (value === undefined)
+                continue;
+            if (Array.isArray(value)) {
+                for (const item of value)
+                    url.searchParams.append(key, item);
+            }
+            else {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        return url.toString();
+    }
+    async throwHttpError(response, method, request) {
+        let backendMessage;
+        let requestId;
+        try {
+            const body = (await response.json());
+            backendMessage = body.message;
+            requestId = body.requestId;
+        }
+        catch {
+            backendMessage = response.statusText;
+        }
+        const authMessage = response.status === 401 ? 'Authentication failed. Check your token or run "skillhub login" again.' : undefined;
+        throw new CliError(authMessage ?? backendMessage ?? `SkillHub request failed with status ${response.status}.`, {
+            request: `${method} ${request}`,
+            status: response.status,
+            requestId,
+            backendMessage
+        });
+    }
+}
+export function requireToken(token) {
+    if (!token)
+        throw new CliError('No SkillHub token configured. Run "skillhub login --token <token>" first.');
+    return token;
+}
+function parseContentDispositionFileName(value) {
+    if (!value)
+        return undefined;
+    const utf8Match = /filename\*=UTF-8''([^;]+)/i.exec(value);
+    if (utf8Match)
+        return decodeURIComponent(utf8Match[1]);
+    const match = /filename="?([^";]+)"?/i.exec(value);
+    return match?.[1];
+}
+//# sourceMappingURL=api.js.map

package/dist/lib/api.js.map

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

package/dist/lib/archive.d.ts

@@ -0,0 +1,8 @@
+export declare function installArchive(options: {
+    archivePath: string;
+    targetDir: string;
+    slug: string;
+    force: boolean;
+}): Promise<string>;
+export declare function listArchiveEntries(archivePath: string): Promise<string[]>;
+export declare function assertSafeEntries(entries: string[]): void;

package/dist/lib/archive.js

@@ -0,0 +1,85 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import AdmZip from 'adm-zip';
+import tar from 'tar';
+import { CliError } from './errors.js';
+export async function installArchive(options) {
+    const entries = await listArchiveEntries(options.archivePath);
+    assertSafeEntries(entries);
+    const topLevel = singleTopLevel(entries);
+    const destination = path.resolve(options.targetDir, topLevel ?? options.slug);
+    if (await exists(destination)) {
+        if (!options.force)
+            throw new CliError(`Skill directory already exists: ${destination}\nUse --force to overwrite it.`);
+        await fs.rm(destination, { recursive: true, force: true });
+    }
+    await fs.mkdir(options.targetDir, { recursive: true });
+    const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'skillhub-install-'));
+    try {
+        await extractArchive(options.archivePath, tempDir);
+        if (topLevel) {
+            await movePath(path.join(tempDir, topLevel), destination);
+        }
+        else {
+            await fs.mkdir(destination, { recursive: true });
+            const children = await fs.readdir(tempDir);
+            for (const child of children)
+                await movePath(path.join(tempDir, child), path.join(destination, child));
+        }
+        return destination;
+    }
+    finally {
+        await fs.rm(tempDir, { recursive: true, force: true });
+    }
+}
+export async function listArchiveEntries(archivePath) {
+    if (archivePath.endsWith('.zip')) {
+        const zip = new AdmZip(archivePath);
+        return zip.getEntries().map((entry) => entry.entryName);
+    }
+    const entries = [];
+    await tar.t({ file: archivePath, onentry: (entry) => entries.push(entry.path) });
+    return entries;
+}
+export function assertSafeEntries(entries) {
+    const unsafe = entries.some((entry) => {
+        const normalized = entry.replace(/\\/g, '/');
+        return normalized.startsWith('/') || normalized.includes('../') || normalized === '..' || /^[A-Za-z]:\//.test(normalized);
+    });
+    if (unsafe)
+        throw new CliError('Invalid archive. Package contains unsafe paths.');
+}
+function singleTopLevel(entries) {
+    const topLevels = new Set(entries.map((entry) => entry.replace(/\\/g, '/').split('/').filter(Boolean)[0]).filter(Boolean));
+    return topLevels.size === 1 ? [...topLevels][0] : undefined;
+}
+async function extractArchive(archivePath, destination) {
+    if (archivePath.endsWith('.zip')) {
+        const zip = new AdmZip(archivePath);
+        zip.extractAllTo(destination, true);
+        return;
+    }
+    await tar.x({ file: archivePath, cwd: destination });
+}
+async function movePath(source, destination) {
+    try {
+        await fs.rename(source, destination);
+    }
+    catch (error) {
+        if (error.code !== 'EXDEV')
+            throw error;
+        await fs.cp(source, destination, { recursive: true });
+        await fs.rm(source, { recursive: true, force: true });
+    }
+}
+async function exists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=archive.js.map

package/dist/lib/archive.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export declare const configSchema: z.ZodObject<{
+    baseUrl: z.ZodOptional<z.ZodType<string, z.ZodTypeDef, string>>;
+    token: z.ZodOptional<z.ZodType<string, z.ZodTypeDef, string>>;
+    defaultDownloadDir: z.ZodOptional<z.ZodType<string, z.ZodTypeDef, string>>;
+}, "strip", z.ZodTypeAny, {
+    baseUrl?: string | undefined;
+    token?: string | undefined;
+    defaultDownloadDir?: string | undefined;
+}, {
+    baseUrl?: string | undefined;
+    token?: string | undefined;
+    defaultDownloadDir?: string | undefined;
+}>;
+export type SkillHubConfig = z.infer<typeof configSchema>;
+export declare const CONFIG_KEYS: readonly ["baseUrl", "token", "defaultDownloadDir"];
+export type ConfigKey = typeof CONFIG_KEYS[number];
+export declare function getConfigPath(): string;
+export declare function readConfig(): Promise<SkillHubConfig>;
+export declare function writeConfig(config: SkillHubConfig): Promise<void>;
+export declare function updateConfig(updates: SkillHubConfig): Promise<SkillHubConfig>;
+export declare function validateConfigKey(key: string): ConfigKey;
+export declare function normalizeBaseUrl(baseUrl: string): string;
+export interface ResolvedOptions {
+    baseUrl: string;
+    token?: string;
+    defaultDownloadDir?: string;
+}
+export declare function resolveOptions(overrides?: {
+    baseUrl?: string;
+    token?: string;
+}): Promise<ResolvedOptions>;

package/dist/lib/config.js

@@ -0,0 +1,78 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { z } from 'zod';
+import { DEFAULT_BASE_URL } from './constants.js';
+import { CliError } from './errors.js';
+const optionalNonEmptyText = z.custom((value) => typeof value === 'string' && value.length > 0).optional();
+export const configSchema = z.object({
+    baseUrl: optionalNonEmptyText,
+    token: optionalNonEmptyText,
+    defaultDownloadDir: optionalNonEmptyText
+});
+export const CONFIG_KEYS = ['baseUrl', 'token', 'defaultDownloadDir'];
+export function getConfigPath() {
+    if (process.platform === 'win32') {
+        const appData = process.env.APPDATA ?? path.join(os.homedir(), 'AppData', 'Roaming');
+        return path.join(appData, 'skillhub', 'config.json');
+    }
+    const configHome = process.env.XDG_CONFIG_HOME ?? path.join(os.homedir(), '.config');
+    return path.join(configHome, 'skillhub', 'config.json');
+}
+export async function readConfig() {
+    const filePath = getConfigPath();
+    try {
+        const raw = await fs.readFile(filePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return configSchema.parse(parsed);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return {};
+        if (error instanceof z.ZodError)
+            throw new CliError(`Invalid config file: ${filePath}`);
+        if (error instanceof SyntaxError)
+            throw new CliError(`Invalid JSON in config file: ${filePath}`);
+        throw error;
+    }
+}
+export async function writeConfig(config) {
+    const filePath = getConfigPath();
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 });
+    if (process.platform !== 'win32')
+        await fs.chmod(filePath, 0o600);
+}
+export async function updateConfig(updates) {
+    const current = await readConfig();
+    const next = configSchema.parse({ ...current, ...updates });
+    await writeConfig(next);
+    return next;
+}
+export function validateConfigKey(key) {
+    if (CONFIG_KEYS.includes(key))
+        return key;
+    throw new CliError(`Unknown config key "${key}".\nAllowed keys: ${CONFIG_KEYS.join(', ')}.`);
+}
+export function normalizeBaseUrl(baseUrl) {
+    let url;
+    try {
+        url = new URL(baseUrl);
+    }
+    catch {
+        throw new CliError('Invalid base URL. Expected an HTTP or HTTPS URL.');
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new CliError('Invalid base URL. Expected an HTTP or HTTPS URL.');
+    }
+    return url.toString().replace(/\/$/, '');
+}
+export async function resolveOptions(overrides = {}) {
+    const config = await readConfig();
+    return {
+        baseUrl: normalizeBaseUrl(overrides.baseUrl ?? config.baseUrl ?? DEFAULT_BASE_URL),
+        token: overrides.token ?? config.token,
+        defaultDownloadDir: config.defaultDownloadDir
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_BASE_URL = "https://pre-ai-mcp.tsp.xiaomi.net/skillhub";
+export declare const API_PREFIX = "/api/v1/token";
+export declare const FRONTEND_URL = "https://pre-skillhub.tsp.mioffice.cn";
+export declare const CONTACT_EMAIL = "luozhilin@xiaomi.com";

package/dist/lib/constants.js

@@ -0,0 +1,5 @@
+export const DEFAULT_BASE_URL = 'https://pre-ai-mcp.tsp.xiaomi.net/skillhub';
+export const API_PREFIX = '/api/v1/token';
+export const FRONTEND_URL = 'https://pre-skillhub.tsp.mioffice.cn';
+export const CONTACT_EMAIL = 'luozhilin@xiaomi.com';
+//# sourceMappingURL=constants.js.map

package/dist/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/lib/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,4CAA4C,CAAA;AAC5E,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAA;AACzC,MAAM,CAAC,MAAM,YAAY,GAAG,sCAAsC,CAAA;AAClE,MAAM,CAAC,MAAM,aAAa,GAAG,sBAAsB,CAAA"}

package/dist/lib/context.d.ts

@@ -0,0 +1,15 @@
+import { SkillHubApiClient } from './api.js';
+export interface CommandContext {
+    baseUrl: string;
+    token?: string;
+    json: boolean;
+    verbose: boolean;
+    client: SkillHubApiClient;
+    defaultDownloadDir?: string;
+}
+export declare function createContext(options: {
+    baseUrl?: string;
+    token?: string;
+    json?: boolean;
+    verbose?: boolean;
+}, authRequired?: boolean): Promise<CommandContext>;

package/dist/lib/context.js

@@ -0,0 +1,15 @@
+import { SkillHubApiClient, requireToken } from './api.js';
+import { resolveOptions } from './config.js';
+export async function createContext(options, authRequired = true) {
+    const resolved = await resolveOptions(options);
+    const token = authRequired ? requireToken(resolved.token) : resolved.token;
+    return {
+        baseUrl: resolved.baseUrl,
+        token,
+        json: Boolean(options.json),
+        verbose: Boolean(options.verbose),
+        defaultDownloadDir: resolved.defaultDownloadDir,
+        client: new SkillHubApiClient({ baseUrl: resolved.baseUrl, token })
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/lib/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/lib/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAW5C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAgF,EAAE,YAAY,GAAG,IAAI;IACvI,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAA;IAC9C,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAA;IAC1E,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK;QACL,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QACjC,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;QAC/C,MAAM,EAAE,IAAI,iBAAiB,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;KACpE,CAAA;AACH,CAAC"}

package/dist/lib/download.d.ts

@@ -0,0 +1,8 @@
+export declare function writeDownload(options: {
+    bytes: Uint8Array;
+    output: string;
+    fileName: string;
+    force: boolean;
+}): Promise<string>;
+export declare function resolveOutputPath(output: string, fileName: string): string;
+export declare function fallbackArchiveName(skill: string): string;

package/dist/lib/download.js

@@ -0,0 +1,27 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { CliError } from './errors.js';
+export async function writeDownload(options) {
+    const outputPath = resolveOutputPath(options.output, options.fileName);
+    try {
+        await fs.mkdir(path.dirname(outputPath), { recursive: true });
+        await fs.writeFile(outputPath, options.bytes, { flag: options.force ? 'w' : 'wx' });
+        return outputPath;
+    }
+    catch (error) {
+        if (error.code === 'EEXIST') {
+            throw new CliError(`Output file already exists: ${outputPath}\nUse --force to overwrite it.`);
+        }
+        throw error;
+    }
+}
+export function resolveOutputPath(output, fileName) {
+    const hasExtension = path.extname(output) !== '';
+    if (hasExtension)
+        return path.resolve(output);
+    return path.resolve(output, fileName);
+}
+export function fallbackArchiveName(skill) {
+    return `${skill.replace(/[\\/]/g, '-')}.zip`;
+}
+//# sourceMappingURL=download.js.map

package/dist/lib/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../src/lib/download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAgF;IAClH,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtE,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7D,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QACnF,OAAO,UAAU,CAAA;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,QAAQ,CAAC,+BAA+B,UAAU,gCAAgC,CAAC,CAAA;QAC/F,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,QAAgB;IAChE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IAChD,IAAI,YAAY;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAA;AAC9C,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,12 @@
+export declare class CliError extends Error {
+    readonly details?: ErrorDetails | undefined;
+    constructor(message: string, details?: ErrorDetails | undefined);
+}
+export interface ErrorDetails {
+    request?: string;
+    status?: number;
+    requestId?: string;
+    backendMessage?: string;
+    code?: string;
+}
+export declare function isCliError(error: unknown): error is CliError;

package/dist/lib/errors.js

@@ -0,0 +1,12 @@
+export class CliError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = 'CliError';
+    }
+}
+export function isCliError(error) {
+    return error instanceof CliError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACK;IAAtC,YAAY,OAAe,EAAW,OAAsB;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAA;QADsB,YAAO,GAAP,OAAO,CAAe;QAE1D,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;IACxB,CAAC;CACF;AAUD,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,YAAY,QAAQ,CAAA;AAClC,CAAC"}

package/dist/lib/human.d.ts

@@ -0,0 +1,2 @@
+export declare function formatBytes(bytes: number): string;
+export declare function valueOrDash(value: unknown): string;

package/dist/lib/human.js

@@ -0,0 +1,20 @@
+export function formatBytes(bytes) {
+    if (!Number.isFinite(bytes) || bytes < 0)
+        return '0 B';
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ['KB', 'MB', 'GB'];
+    let value = bytes / 1024;
+    let unitIndex = 0;
+    while (value >= 1024 && unitIndex < units.length - 1) {
+        value /= 1024;
+        unitIndex += 1;
+    }
+    return `${value.toFixed(value >= 10 ? 1 : 1)} ${units[unitIndex]}`;
+}
+export function valueOrDash(value) {
+    if (value === null || value === undefined || value === '')
+        return '-';
+    return String(value);
+}
+//# sourceMappingURL=human.js.map

package/dist/lib/human.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"human.js","sourceRoot":"","sources":["../../src/lib/human.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IACtD,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAA;IACrC,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAChC,IAAI,KAAK,GAAG,KAAK,GAAG,IAAI,CAAA;IACxB,IAAI,SAAS,GAAG,CAAC,CAAA;IACjB,OAAO,KAAK,IAAI,IAAI,IAAI,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,KAAK,IAAI,IAAI,CAAA;QACb,SAAS,IAAI,CAAC,CAAA;IAChB,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAA;AACpE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,GAAG,CAAA;IACrE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC"}

package/dist/lib/page.d.ts

@@ -0,0 +1,7 @@
+import type { PageResponse } from './types.js';
+export declare function getPageItems<T>(page: PageResponse<T> | T[]): T[];
+export declare function getPageMeta<T>(page: PageResponse<T> | T[]): {
+    page: number;
+    size: number;
+    total: number;
+};

package/dist/lib/page.js

@@ -0,0 +1,15 @@
+export function getPageItems(page) {
+    if (Array.isArray(page))
+        return page;
+    return page.items ?? page.content ?? [];
+}
+export function getPageMeta(page) {
+    if (Array.isArray(page))
+        return { page: 0, size: page.length, total: page.length };
+    return {
+        page: page.page ?? page.number ?? 0,
+        size: page.size ?? getPageItems(page).length,
+        total: page.total ?? page.totalElements ?? getPageItems(page).length
+    };
+}
+//# sourceMappingURL=page.js.map

package/dist/lib/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/lib/page.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAI,IAA2B;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACpC,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,IAA2B;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAA;IAClF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;QACnC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM;QAC5C,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM;KACrE,CAAA;AACH,CAAC"}

package/dist/lib/target.d.ts

@@ -0,0 +1,8 @@
+export interface SkillTarget {
+    raw: string;
+    slug: string;
+    namespace?: string;
+}
+export declare function parseSkillTarget(value: string): SkillTarget;
+export declare function formatSkillTarget(target: SkillTarget): string;
+export declare function encodeTargetPath(target: SkillTarget): string;

package/dist/lib/target.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { CliError } from './errors.js';
+const segmentSchema = z.string().min(1).regex(/^[A-Za-z0-9._-]+$/);
+export function parseSkillTarget(value) {
+    const parts = value.split('/');
+    if (parts.length === 1) {
+        const slug = segmentSchema.safeParse(parts[0]);
+        if (!slug.success)
+            throw new CliError(`Invalid skill target: ${value}. Expected slug or namespace/slug.`);
+        return { raw: value, slug: slug.data };
+    }
+    if (parts.length === 2) {
+        const namespace = segmentSchema.safeParse(parts[0]);
+        const slug = segmentSchema.safeParse(parts[1]);
+        if (!namespace.success || !slug.success)
+            throw new CliError(`Invalid skill target: ${value}. Expected slug or namespace/slug.`);
+        return { raw: value, namespace: namespace.data, slug: slug.data };
+    }
+    throw new CliError(`Invalid skill target: ${value}. Expected slug or namespace/slug.`);
+}
+export function formatSkillTarget(target) {
+    return target.namespace ? `${target.namespace}/${target.slug}` : target.slug;
+}
+export function encodeTargetPath(target) {
+    const slug = encodeURIComponent(target.slug);
+    if (!target.namespace)
+        return `/skills/${slug}`;
+    return `/skills/${encodeURIComponent(target.namespace)}/${slug}`;
+}
+//# sourceMappingURL=target.js.map