ncloud-mcp-server 1.0.0

package/dist/client/s3-compatible-client.js

@@ -0,0 +1,210 @@
+import crypto from "node:crypto";
+/** Object Storage endpoint map (storageType: "object") */
+const REGION_ENDPOINT_MAP = {
+    KR: "https://kr.object.ncloudstorage.com",
+    USWN: "https://us.object.ncloudstorage.com",
+    SGN: "https://sg.object.ncloudstorage.com",
+    JPN: "https://jp.object.ncpstorage.com",
+    DEN: "https://de.object.ncloudstorage.com",
+};
+/** Object Storage host map (storageType: "object") */
+const REGION_HOST_MAP = {
+    KR: "kr.object.ncloudstorage.com",
+    USWN: "us.object.ncloudstorage.com",
+    SGN: "sg.object.ncloudstorage.com",
+    JPN: "jp.object.ncpstorage.com",
+    DEN: "de.object.ncloudstorage.com",
+};
+/** Ncloud Storage endpoint map (storageType: "ncloud") */
+const NCLOUD_STORAGE_ENDPOINT_MAP = {
+    KR: "https://kr.ncloudstorage.com",
+    USWN: "https://us.ncloudstorage.com",
+    SGN: "https://sg.ncloudstorage.com",
+    JPN: "https://jp.ncloudstorage.com",
+    DEN: "https://de.ncloudstorage.com",
+};
+/** Ncloud Storage host map (storageType: "ncloud") */
+const NCLOUD_STORAGE_HOST_MAP = {
+    KR: "kr.ncloudstorage.com",
+    USWN: "us.ncloudstorage.com",
+    SGN: "sg.ncloudstorage.com",
+    JPN: "jp.ncloudstorage.com",
+    DEN: "de.ncloudstorage.com",
+};
+/**
+ * Signing region used in AWS Signature V4 credential scope.
+ * Ncloud Object Storage uses region names like "kr-standard" for signing.
+ */
+const SIGNING_REGION_MAP = {
+    KR: "kr-standard",
+    USWN: "us-standard",
+    SGN: "sg-standard",
+    JPN: "jp-standard",
+    DEN: "de-standard",
+};
+/**
+ * Signing region for Ncloud Storage (non-Object Storage).
+ * Ncloud Storage uses short region codes like "kr" for signing.
+ * Currently only KR is available, but structured for future expansion.
+ */
+const NCLOUD_STORAGE_SIGNING_REGION_MAP = {
+    KR: "kr",
+    USWN: "us",
+    SGN: "sg",
+    JPN: "jp",
+    DEN: "de",
+};
+/**
+ * S3-compatible client for Ncloud Object Storage.
+ * Implements AWS Signature V4 authentication using Ncloud Access Key / Secret Key.
+ * Endpoints per region:
+ *   KR:   https://kr.object.ncloudstorage.com
+ *   USWN: https://us.object.ncloudstorage.com
+ *   SGN:  https://sg.object.ncloudstorage.com
+ *   JPN:  https://jp.object.ncpstorage.com
+ *   DEN:  https://de.object.ncloudstorage.com
+ */
+export class S3CompatibleClient {
+    accessKey;
+    secretKey;
+    regionCode;
+    storageType;
+    constructor(config) {
+        this.accessKey = config.accessKey;
+        this.secretKey = config.secretKey;
+        this.regionCode = config.regionCode;
+        this.storageType = config.storageType ?? "object";
+    }
+    setRegionCode(regionCode) {
+        this.regionCode = regionCode;
+    }
+    getRegionCode() {
+        return this.regionCode;
+    }
+    getEndpoint() {
+        if (this.storageType === "ncloud") {
+            return NCLOUD_STORAGE_ENDPOINT_MAP[this.regionCode] ?? NCLOUD_STORAGE_ENDPOINT_MAP["KR"];
+        }
+        return REGION_ENDPOINT_MAP[this.regionCode] ?? REGION_ENDPOINT_MAP["KR"];
+    }
+    getHost() {
+        if (this.storageType === "ncloud") {
+            return NCLOUD_STORAGE_HOST_MAP[this.regionCode] ?? NCLOUD_STORAGE_HOST_MAP["KR"];
+        }
+        return REGION_HOST_MAP[this.regionCode] ?? REGION_HOST_MAP["KR"];
+    }
+    sha256(data) {
+        return crypto.createHash("sha256").update(data).digest("hex");
+    }
+    hmacSha256(key, data) {
+        return crypto.createHmac("sha256", key).update(data).digest();
+    }
+    getSigningRegion() {
+        if (this.storageType === "ncloud") {
+            return NCLOUD_STORAGE_SIGNING_REGION_MAP[this.regionCode] ?? NCLOUD_STORAGE_SIGNING_REGION_MAP["KR"];
+        }
+        return SIGNING_REGION_MAP[this.regionCode] ?? SIGNING_REGION_MAP["KR"];
+    }
+    getSigningKey(dateStamp) {
+        const signingRegion = this.getSigningRegion();
+        const kDate = this.hmacSha256(`AWS4${this.secretKey}`, dateStamp);
+        const kRegion = this.hmacSha256(kDate, signingRegion);
+        const kService = this.hmacSha256(kRegion, "s3");
+        const kSigning = this.hmacSha256(kService, "aws4_request");
+        return kSigning;
+    }
+    buildCanonicalUri(bucket, key) {
+        if (!bucket)
+            return "/";
+        if (!key)
+            return `/${bucket}`;
+        const encodedKey = key
+            .split("/")
+            .map((part) => encodeURIComponent(part))
+            .join("/");
+        return `/${bucket}/${encodedKey}`;
+    }
+    buildCanonicalQueryString(queryParams) {
+        if (!queryParams || Object.keys(queryParams).length === 0)
+            return "";
+        const sorted = Object.entries(queryParams).sort(([a], [b]) => a.localeCompare(b));
+        return sorted
+            .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
+            .join("&");
+    }
+    async request(options) {
+        const { method, bucket, key, queryParams, headers: extraHeaders, body } = options;
+        const now = new Date();
+        const amzDate = now.toISOString().replace(/[-:]/g, "").replace(/\.\d{3}/, "");
+        const dateStamp = amzDate.substring(0, 8);
+        const host = this.getHost();
+        const canonicalUri = this.buildCanonicalUri(bucket, key);
+        const canonicalQueryString = this.buildCanonicalQueryString(queryParams);
+        const payloadHash = this.sha256(body ?? "");
+        const requestHeaders = {
+            host,
+            "x-amz-date": amzDate,
+            "x-amz-content-sha256": payloadHash,
+            ...extraHeaders,
+        };
+        // Build canonical headers (sorted, lowercase)
+        const signedHeaderKeys = Object.keys(requestHeaders)
+            .map((k) => k.toLowerCase())
+            .sort();
+        const canonicalHeaders = signedHeaderKeys
+            .map((k) => `${k}:${requestHeaders[Object.keys(requestHeaders).find((h) => h.toLowerCase() === k)].trim()}`)
+            .join("\n") + "\n";
+        const signedHeaders = signedHeaderKeys.join(";");
+        const canonicalRequest = [
+            method,
+            canonicalUri,
+            canonicalQueryString,
+            canonicalHeaders,
+            signedHeaders,
+            payloadHash,
+        ].join("\n");
+        const credentialScope = `${dateStamp}/${this.getSigningRegion()}/s3/aws4_request`;
+        const stringToSign = [
+            "AWS4-HMAC-SHA256",
+            amzDate,
+            credentialScope,
+            this.sha256(canonicalRequest),
+        ].join("\n");
+        const signingKey = this.getSigningKey(dateStamp);
+        const signature = crypto
+            .createHmac("sha256", signingKey)
+            .update(stringToSign)
+            .digest("hex");
+        const authorization = `AWS4-HMAC-SHA256 Credential=${this.accessKey}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
+        const fetchHeaders = {
+            ...requestHeaders,
+            Authorization: authorization,
+        };
+        // Remove 'host' from fetch headers (fetch sets it automatically)
+        delete fetchHeaders["host"];
+        const url = canonicalQueryString
+            ? `${this.getEndpoint()}${canonicalUri}?${canonicalQueryString}`
+            : `${this.getEndpoint()}${canonicalUri}`;
+        const response = await fetch(url, {
+            method,
+            headers: fetchHeaders,
+            body: body ?? undefined,
+        });
+        const responseBody = await response.text();
+        if (!response.ok) {
+            this.handleErrorResponse(response.status, responseBody);
+        }
+        return { status: response.status, headers: response.headers, body: responseBody };
+    }
+    handleErrorResponse(status, body) {
+        const serviceName = this.storageType === "ncloud" ? "Ncloud Storage" : "Object Storage";
+        // Try to parse XML error response from S3
+        const codeMatch = body.match(/<Code>(.*?)<\/Code>/);
+        const messageMatch = body.match(/<Message>(.*?)<\/Message>/);
+        if (codeMatch && messageMatch) {
+            throw new Error(`${serviceName} 호출 실패\n\n에러 코드: ${codeMatch[1]}\n메시지: ${messageMatch[1]}`);
+        }
+        throw new Error(`${serviceName} 호출 실패: HTTP ${status}\n\n응답: ${body}`);
+    }
+}
+//# sourceMappingURL=s3-compatible-client.js.map

package/dist/client/s3-compatible-client.js.map

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

package/dist/client/swift-compatible-client.d.ts

@@ -0,0 +1,68 @@
+/**
+ * OpenStack Swift-compatible client for Ncloud Archive Storage.
+ * Uses Keystone v3 token-based authentication.
+ *
+ * Authentication:
+ *   - Endpoint: https://kr.archive.ncloudstorage.com:5000/v3/auth/tokens
+ *   - Access Key → username, Secret Key → password
+ *   - Requires project_id and domain_id from Archive Storage console
+ *
+ * API:
+ *   - Endpoint: https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}
+ *   - Header: X-Auth-Token
+ */
+export interface SwiftCompatibleClientConfig {
+    accessKey: string;
+    secretKey: string;
+    projectId: string;
+    domainId: string;
+    regionCode?: string;
+}
+interface SwiftRequestOptions {
+    method: string;
+    container?: string;
+    object?: string;
+    queryParams?: Record<string, string>;
+    headers?: Record<string, string>;
+    body?: string;
+}
+interface SwiftResponse {
+    status: number;
+    headers: Headers;
+    body: string;
+}
+/**
+ * Swift-compatible client for Ncloud Archive Storage.
+ * Implements OpenStack Keystone v3 token authentication.
+ */
+export declare class SwiftCompatibleClient {
+    private readonly accessKey;
+    private readonly secretKey;
+    private readonly projectId;
+    private readonly domainId;
+    private regionCode;
+    private token;
+    private tokenExpiresAt;
+    constructor(config: SwiftCompatibleClientConfig);
+    setRegionCode(regionCode: string): void;
+    getRegionCode(): string;
+    getProjectId(): string;
+    private getAuthEndpoint;
+    private getApiEndpoint;
+    /**
+     * Authenticate with Keystone v3 and obtain a token.
+     * Token is cached and reused until expiration.
+     */
+    private authenticate;
+    /**
+     * Build the storage URL for API requests.
+     * Format: {apiEndpoint}/v1/AUTH_{projectId}[/{container}[/{object}]]
+     */
+    private buildUrl;
+    /**
+     * Execute a Swift API request with automatic token management.
+     */
+    request(options: SwiftRequestOptions): Promise<SwiftResponse>;
+    private handleErrorResponse;
+}
+export {};

package/dist/client/swift-compatible-client.js

@@ -0,0 +1,173 @@
+/**
+ * OpenStack Swift-compatible client for Ncloud Archive Storage.
+ * Uses Keystone v3 token-based authentication.
+ *
+ * Authentication:
+ *   - Endpoint: https://kr.archive.ncloudstorage.com:5000/v3/auth/tokens
+ *   - Access Key → username, Secret Key → password
+ *   - Requires project_id and domain_id from Archive Storage console
+ *
+ * API:
+ *   - Endpoint: https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}
+ *   - Header: X-Auth-Token
+ */
+const AUTH_ENDPOINT_MAP = {
+    KR: "https://kr.archive.ncloudstorage.com:5000",
+};
+const API_ENDPOINT_MAP = {
+    KR: "https://kr.archive.ncloudstorage.com",
+};
+/**
+ * Swift-compatible client for Ncloud Archive Storage.
+ * Implements OpenStack Keystone v3 token authentication.
+ */
+export class SwiftCompatibleClient {
+    accessKey;
+    secretKey;
+    projectId;
+    domainId;
+    regionCode;
+    token = null;
+    tokenExpiresAt = 0;
+    constructor(config) {
+        this.accessKey = config.accessKey;
+        this.secretKey = config.secretKey;
+        this.projectId = config.projectId;
+        this.domainId = config.domainId;
+        this.regionCode = config.regionCode ?? "KR";
+    }
+    setRegionCode(regionCode) {
+        this.regionCode = regionCode;
+        // Invalidate token when region changes
+        this.token = null;
+        this.tokenExpiresAt = 0;
+    }
+    getRegionCode() {
+        return this.regionCode;
+    }
+    getProjectId() {
+        return this.projectId;
+    }
+    getAuthEndpoint() {
+        return AUTH_ENDPOINT_MAP[this.regionCode] ?? AUTH_ENDPOINT_MAP["KR"];
+    }
+    getApiEndpoint() {
+        return API_ENDPOINT_MAP[this.regionCode] ?? API_ENDPOINT_MAP["KR"];
+    }
+    /**
+     * Authenticate with Keystone v3 and obtain a token.
+     * Token is cached and reused until expiration.
+     */
+    async authenticate() {
+        // Return cached token if still valid (with 5 min buffer)
+        if (this.token && Date.now() < this.tokenExpiresAt - 5 * 60 * 1000) {
+            return this.token;
+        }
+        const authUrl = `${this.getAuthEndpoint()}/v3/auth/tokens`;
+        const authBody = {
+            auth: {
+                identity: {
+                    methods: ["password"],
+                    password: {
+                        user: {
+                            name: this.accessKey,
+                            password: this.secretKey,
+                            domain: {
+                                id: this.domainId,
+                            },
+                        },
+                    },
+                },
+                scope: {
+                    project: {
+                        id: this.projectId,
+                    },
+                },
+            },
+        };
+        const response = await fetch(authUrl, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(authBody),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new Error(`Archive Storage 인증 실패: HTTP ${response.status}\n\n응답: ${errorBody}`);
+        }
+        const token = response.headers.get("x-subject-token");
+        if (!token) {
+            throw new Error("Archive Storage 인증 실패: 응답에 X-Subject-Token 헤더가 없습니다.");
+        }
+        // Parse expiration from response body
+        const body = await response.json();
+        if (body.token?.expires_at) {
+            this.tokenExpiresAt = new Date(body.token.expires_at).getTime();
+        }
+        else {
+            // Default: 1 hour from now
+            this.tokenExpiresAt = Date.now() + 60 * 60 * 1000;
+        }
+        this.token = token;
+        return token;
+    }
+    /**
+     * Build the storage URL for API requests.
+     * Format: {apiEndpoint}/v1/AUTH_{projectId}[/{container}[/{object}]]
+     */
+    buildUrl(container, object, queryParams) {
+        let path = `${this.getApiEndpoint()}/v1/AUTH_${this.projectId}`;
+        if (container) {
+            path += `/${encodeURIComponent(container)}`;
+        }
+        if (object) {
+            // Encode each path segment separately to preserve slashes
+            const encodedObject = object
+                .split("/")
+                .map((part) => encodeURIComponent(part))
+                .join("/");
+            path += `/${encodedObject}`;
+        }
+        if (queryParams && Object.keys(queryParams).length > 0) {
+            const qs = Object.entries(queryParams)
+                .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
+                .join("&");
+            path += `?${qs}`;
+        }
+        return path;
+    }
+    /**
+     * Execute a Swift API request with automatic token management.
+     */
+    async request(options) {
+        const { method, container, object, queryParams, headers: extraHeaders, body } = options;
+        const token = await this.authenticate();
+        const url = this.buildUrl(container, object, queryParams);
+        const requestHeaders = {
+            "X-Auth-Token": token,
+            ...extraHeaders,
+        };
+        const response = await fetch(url, {
+            method,
+            headers: requestHeaders,
+            body: body ?? undefined,
+        });
+        const responseBody = await response.text();
+        if (!response.ok) {
+            this.handleErrorResponse(response.status, responseBody, response.headers);
+        }
+        return { status: response.status, headers: response.headers, body: responseBody };
+    }
+    handleErrorResponse(status, body, headers) {
+        // If 401, invalidate token for next retry
+        if (status === 401) {
+            this.token = null;
+            this.tokenExpiresAt = 0;
+        }
+        const transId = headers.get("x-trans-id") ?? "";
+        const detail = body.trim() || `HTTP ${status}`;
+        throw new Error(`Archive Storage 호출 실패: ${detail}${transId ? `\nTransaction-ID: ${transId}` : ""}`);
+    }
+}
+//# sourceMappingURL=swift-compatible-client.js.map

package/dist/client/swift-compatible-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swift-compatible-client.js","sourceRoot":"","sources":["../../src/client/swift-compatible-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAyBH,MAAM,iBAAiB,GAA2B;IAChD,EAAE,EAAE,2CAA2C;CAChD,CAAC;AAEF,MAAM,gBAAgB,GAA2B;IAC/C,EAAE,EAAE,sCAAsC;CAC3C,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACf,SAAS,CAAS;IAClB,SAAS,CAAS;IAClB,SAAS,CAAS;IAClB,QAAQ,CAAS;IAC1B,UAAU,CAAS;IAEnB,KAAK,GAAkB,IAAI,CAAC;IAC5B,cAAc,GAAW,CAAC,CAAC;IAEnC,YAAY,MAAmC;QAC7C,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;IAC9C,CAAC;IAED,aAAa,CAAC,UAAkB;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,uCAAuC;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEO,eAAe;QACrB,OAAO,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IAEO,cAAc;QACpB,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,YAAY;QACxB,yDAAyD;QACzD,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YACnE,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,eAAe,EAAE,iBAAiB,CAAC;QAE3D,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE;gBACJ,QAAQ,EAAE;oBACR,OAAO,EAAE,CAAC,UAAU,CAAC;oBACrB,QAAQ,EAAE;wBACR,IAAI,EAAE;4BACJ,IAAI,EAAE,IAAI,CAAC,SAAS;4BACpB,QAAQ,EAAE,IAAI,CAAC,SAAS;4BACxB,MAAM,EAAE;gCACN,EAAE,EAAE,IAAI,CAAC,QAAQ;6BAClB;yBACF;qBACF;iBACF;gBACD,KAAK,EAAE;oBACL,OAAO,EAAE;wBACP,EAAE,EAAE,IAAI,CAAC,SAAS;qBACnB;iBACF;aACF;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;SAC/B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,+BAA+B,QAAQ,CAAC,MAAM,WAAW,SAAS,EAAE,CACrE,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,sCAAsC;QACtC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAyC,CAAC;QAC1E,IAAI,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC;YAC3B,IAAI,CAAC,cAAc,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,2BAA2B;YAC3B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACK,QAAQ,CAAC,SAAkB,EAAE,MAAe,EAAE,WAAoC;QACxF,IAAI,IAAI,GAAG,GAAG,IAAI,CAAC,cAAc,EAAE,YAAY,IAAI,CAAC,SAAS,EAAE,CAAC;QAEhE,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,IAAI,IAAI,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9C,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,0DAA0D;YAC1D,MAAM,aAAa,GAAG,MAAM;iBACzB,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;iBACvC,IAAI,CAAC,GAAG,CAAC,CAAC;YACb,IAAI,IAAI,IAAI,aAAa,EAAE,CAAC;QAC9B,CAAC;QAED,IAAI,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;iBACnC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;iBACpE,IAAI,CAAC,GAAG,CAAC,CAAC;YACb,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAA4B;QACxC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QAExF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAE1D,MAAM,cAAc,GAA2B;YAC7C,cAAc,EAAE,KAAK;YACrB,GAAG,YAAY;SAChB,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM;YACN,OAAO,EAAE,cAAc;YACvB,IAAI,EAAE,IAAI,IAAI,SAAS;SACxB,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE3C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IACpF,CAAC;IAEO,mBAAmB,CAAC,MAAc,EAAE,IAAY,EAAE,OAAgB;QACxE,0CAA0C;QAC1C,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QAC1B,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,QAAQ,MAAM,EAAE,CAAC;QAE/C,MAAM,IAAI,KAAK,CACb,0BAA0B,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACnF,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

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