@leeguoo/yapi-mcp 0.3.26 → 0.4.0

package/dist/cli/types.d.ts

@@ -0,0 +1,161 @@
+import type { DiagramRenderMetric } from "../docs/markdown";
+export type Options = {
+    config?: string;
+    baseUrl?: string;
+    loginUrl?: string;
+    token?: string;
+    projectId?: string;
+    authMode?: string;
+    browser?: boolean;
+    email?: string;
+    password?: string;
+    cookie?: string;
+    tokenParam?: string;
+    method?: string;
+    path?: string;
+    url?: string;
+    query?: string[];
+    header?: string[];
+    data?: string;
+    dataFile?: string;
+    timeout?: number;
+    id?: string;
+    name?: string;
+    desc?: string;
+    catId?: string;
+    groupId?: string;
+    type?: string;
+    typeId?: string;
+    page?: number;
+    limit?: number | string;
+    noUpdate?: boolean;
+    q?: string;
+    noPretty?: boolean;
+    help?: boolean;
+    version?: boolean;
+};
+export type DocsSyncOptions = {
+    config?: string;
+    baseUrl?: string;
+    token?: string;
+    projectId?: string;
+    authMode?: string;
+    email?: string;
+    password?: string;
+    cookie?: string;
+    tokenParam?: string;
+    timeout?: number;
+    dirs: string[];
+    bindings: string[];
+    dryRun?: boolean;
+    noMermaid?: boolean;
+    mermaidLook?: "classic" | "handDrawn";
+    mermaidHandDrawnSeed?: number;
+    force?: boolean;
+    help?: boolean;
+};
+export type DocsSyncMapping = {
+    project_id?: number;
+    catid?: number;
+    template_id?: number;
+    source_files?: string[];
+    files?: Record<string, number>;
+    file_hashes?: Record<string, string>;
+    [key: string]: unknown;
+};
+export type DocsSyncFileInfo = {
+    docId: number;
+    apiPath: string;
+};
+export type DocsSyncPreviewAction = "create" | "update" | "skip" | "preview-only";
+export type DocsSyncPreviewItem = {
+    fileName: string;
+    action: DocsSyncPreviewAction;
+    markdownBytes: number;
+    htmlBytes: number;
+    payloadBytes: number;
+    apiPath: string;
+    docId?: number;
+    largestMermaid?: DiagramRenderMetric;
+};
+export type DocsSyncBinding = DocsSyncMapping & {
+    dir: string;
+};
+export type DocsSyncConfig = {
+    version: number;
+    bindings: Record<string, DocsSyncBinding>;
+};
+export type DocsSyncLinkEntry = {
+    doc_id: number;
+    api_path: string;
+    url: string;
+};
+export type DocsSyncLinksBinding = {
+    dir: string;
+    project_id?: number;
+    catid?: number;
+    files: Record<string, DocsSyncLinkEntry>;
+};
+export type DocsSyncLinksConfig = {
+    version: number;
+    bindings: Record<string, DocsSyncLinksBinding>;
+};
+export type DocsSyncProjectEnv = {
+    name: string;
+    domain: string;
+};
+export type DocsSyncProjectInfo = {
+    project_id: number;
+    name?: string;
+    basepath?: string;
+    envs?: DocsSyncProjectEnv[];
+    base_url?: string;
+};
+export type DocsSyncProjectsConfig = {
+    version: number;
+    projects: Record<string, DocsSyncProjectInfo>;
+};
+export type DocsSyncDeploymentEntry = {
+    api_path: string;
+    env_urls: Record<string, string>;
+};
+export type DocsSyncDeploymentBinding = {
+    dir: string;
+    project_id?: number;
+    files: Record<string, DocsSyncDeploymentEntry>;
+};
+export type DocsSyncDeploymentsConfig = {
+    version: number;
+    bindings: Record<string, DocsSyncDeploymentBinding>;
+};
+export type DocsSyncBindArgs = {
+    name?: string;
+    dir?: string;
+    projectId?: number;
+    catId?: number;
+    templateId?: number;
+    sourceFiles?: string[];
+    clearSourceFiles?: boolean;
+    help?: boolean;
+};
+export type ConfigInitOptions = Pick<Options, "baseUrl" | "email" | "password" | "token" | "projectId">;
+export type SimpleRequestResult = {
+    ok: boolean;
+    queryItems?: [string, string][];
+    method?: "GET" | "POST";
+    data?: unknown;
+};
+export type SimpleRequestQueryBuilder = (options: Options) => SimpleRequestResult;
+export type YapiRequest = (endpoint: string, method: "GET" | "POST", query?: Record<string, unknown>, data?: unknown) => Promise<any>;
+export type AgentBrowserCookie = {
+    name?: string;
+    value?: string;
+    expires?: number | string;
+    expiresAt?: number | string;
+};
+export type UpdateCache = {
+    lastChecked?: number;
+    latest?: string;
+    lastNotified?: string;
+    lastNotifiedAt?: number;
+};

package/dist/cli/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":""}

package/dist/cli/utils.d.ts

@@ -0,0 +1,53 @@
+import type { AgentBrowserCookie, ConfigInitOptions, DocsSyncOptions, DocsSyncProjectEnv, UpdateCache } from "./types";
+export declare function parseKeyValue(raw: string): [string, string];
+export declare function parseQueryArg(raw: string): [string, string][];
+export declare function parseHeader(raw: string): [string, string];
+export declare function parseJsonMaybe(text: string): unknown | null;
+export declare function formatBytes(bytes: number): string;
+export declare function parseByteSize(raw: string): number | null;
+export declare function parsePayloadLimit(text: string): number | null;
+export declare function findGitRoot(startDir: string): string | null;
+export declare function getPayloadMessage(payload: unknown): string;
+export declare function getPayloadErrcode(payload: unknown): number | null;
+export declare function looksLikeAuthError(status: number, payload: unknown): boolean;
+export declare function joinUrl(baseUrl: string, endpoint: string): string;
+export declare function globalConfigPath(): string;
+export declare function parseSimpleToml(text: string): Record<string, string>;
+export declare function resolveToken(tokenValue: string, projectId: string): string;
+export declare function resolveLocalBin(binName: string): string;
+export declare function parseJsonLoose(text: string): unknown | null;
+export declare function extractCookiesFromPayload(payload: unknown): AgentBrowserCookie[];
+export declare function normalizeCookieExpiresMs(raw: unknown): number | undefined;
+export declare function runAgentBrowser(args: string[], options?: {
+    captureOutput?: boolean;
+    ignoreError?: boolean;
+}): string;
+export declare function loginByBrowserAndReadCookie(baseUrl: string, loginUrlOption: string | undefined): Promise<{
+    yapiToken: string;
+    yapiUid?: string;
+    expiresAt?: number;
+}>;
+export declare function escapeTomlValue(value: string): string;
+export declare function formatToml(config: Record<string, string>): string;
+export declare function writeConfig(filePath: string, config: Record<string, string>): void;
+export declare function promptText(question: string): Promise<string>;
+export declare function promptHidden(question: string): Promise<string>;
+export declare function promptRequired(question: string, hidden: boolean): Promise<string>;
+export declare function initConfigIfMissing(options: ConfigInitOptions): Promise<{
+    configPath: string;
+    config: Record<string, string>;
+} | null>;
+export declare function readVersion(): string;
+export declare function resolveLimit(value: number | string | undefined, fallback: string): string;
+export declare function buildDocsSyncHash(markdown: string, options: DocsSyncOptions): string;
+export declare const UPDATE_CHECK_TTL_MS: number;
+export declare function updateCachePath(): string;
+export declare function readUpdateCache(): UpdateCache;
+export declare function writeUpdateCache(cache: UpdateCache): void;
+export declare function compareSemver(a: string, b: string): number;
+export declare function isNewerVersion(latest: string, current: string): boolean;
+export declare function normalizeUiBaseUrl(baseUrl: string): string;
+export declare function buildInterfaceWebUrl(baseUrl: string, projectId: number | string, apiId: number | string): string;
+export declare function normalizePathSegment(value: string): string;
+export declare function buildEnvUrl(domain: string, basepath: string, apiPath: string): string;
+export declare function normalizeProjectEnvs(raw: unknown): DocsSyncProjectEnv[];