@fentaris/cli 0.1.0 → 0.1.2

package/dist/domain/project/project.d.ts

@@ -0,0 +1,8 @@
+import type { ExecProbe, PackageManager, ProcessRunner, ProjectDiscovery, Prompt } from "../../shared/types.js";
+export declare function resolveProjectName(provided: string | undefined, prompt: Prompt): Promise<string>;
+export declare function ensureEmptyTargetDirectory(targetDir: string): Promise<void>;
+export declare function selectPackageManager(probe: ExecProbe, prompt: Prompt): Promise<PackageManager>;
+export declare function discoverProject(fromDir: string): Promise<ProjectDiscovery>;
+export declare function runPackageInstall(packageManager: PackageManager, cwd: string, runner: ProcessRunner): Promise<void>;
+export declare function runPackageScript(packageManager: PackageManager, cwd: string, script: string, runner: ProcessRunner): Promise<void>;
+//# sourceMappingURL=project.d.ts.map

package/dist/domain/project/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/domain/project/project.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAiB,gBAAgB,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAG/H,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWtG;AAED,wBAAsB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAajF;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAWpG;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqBhF;AAED,wBAAsB,iBAAiB,CAAC,cAAc,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzH;AAED,wBAAsB,gBAAgB,CAAC,cAAc,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxI"}

package/dist/domain/project/project.js

@@ -0,0 +1,92 @@
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+import { supportedPackageManagers } from "../../shared/constants.js";
+import { exists, isNodeError, readJson } from "../../shared/utils.js";
+export async function resolveProjectName(provided, prompt) {
+    const value = provided?.trim() || (await prompt.text("Project name"));
+    if (!value.trim()) {
+        throw new Error("Project name is required.");
+    }
+    if (!/^[a-zA-Z0-9._-]+$/.test(value)) {
+        throw new Error("Project name may only contain letters, numbers, dots, underscores, and hyphens.");
+    }
+    return value;
+}
+export async function ensureEmptyTargetDirectory(targetDir) {
+    try {
+        const current = await readdir(targetDir);
+        if (current.length > 0) {
+            throw new Error(`Fentaris can only initialize into a new or empty directory: ${targetDir}`);
+        }
+    }
+    catch (error) {
+        if (isNodeError(error, "ENOENT")) {
+            return;
+        }
+        throw error;
+    }
+}
+export async function selectPackageManager(probe, prompt) {
+    const available = supportedPackageManagers.filter((manager) => probe(manager, ["--version"]));
+    if (available.length === 0) {
+        throw new Error("No supported package manager found. Install pnpm, npm, or bun.");
+    }
+    if (available.length === 1) {
+        return available[0];
+    }
+    return prompt.select("Package manager", available);
+}
+export async function discoverProject(fromDir) {
+    let current = path.resolve(fromDir);
+    while (true) {
+        const configPath = path.join(current, "fentaris.json");
+        if (await exists(configPath)) {
+            const config = validateProjectConfig(await readJson(configPath), configPath);
+            return { root: current, configPath, config };
+        }
+        const legacyConfigPath = path.join(current, "fentaris.config.json");
+        if (await exists(legacyConfigPath)) {
+            const config = validateProjectConfig(await readJson(legacyConfigPath), legacyConfigPath);
+            return { root: current, configPath: legacyConfigPath, config };
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            throw new Error("No Fentaris project found. Run this command inside a generated Fentaris project.");
+        }
+        current = parent;
+    }
+}
+export async function runPackageInstall(packageManager, cwd, runner) {
+    const result = await runner(packageManager, ["install"], { cwd, stdio: "inherit" });
+    if (result.code !== 0) {
+        throw new Error(`${packageManager} install failed.`);
+    }
+}
+export async function runPackageScript(packageManager, cwd, script, runner) {
+    const args = packageManager === "npm" ? ["run", script] : script === "dev" ? ["dev"] : ["run", script];
+    const result = await runner(packageManager, args, { cwd, stdio: "inherit" });
+    if (result.code !== 0) {
+        throw new Error(`${packageManager} ${script} failed.`);
+    }
+}
+function validateProjectConfig(value, configPath) {
+    if (!value || typeof value !== "object") {
+        throw new Error(`Invalid Fentaris config at ${configPath}`);
+    }
+    const config = value;
+    if (!config.name || !config.packageManager || !config.entrypoint || !config.port || !config.path || !config.authDir) {
+        throw new Error(`Invalid Fentaris config at ${configPath}`);
+    }
+    if (!supportedPackageManagers.includes(config.packageManager)) {
+        throw new Error(`Unsupported package manager in ${configPath}`);
+    }
+    return {
+        name: config.name,
+        packageManager: config.packageManager,
+        entrypoint: config.entrypoint,
+        port: config.port,
+        path: config.path,
+        authDir: config.authDir,
+    };
+}
+//# sourceMappingURL=project.js.map

package/dist/domain/project/project.js.map

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

package/dist/domain/template/template.d.ts

@@ -0,0 +1,11 @@
+import type { TemplateInput } from "../../shared/types.js";
+export declare function renderTemplate(input: TemplateInput): {
+    files: Record<string, string>;
+    authKey: string;
+    guestApiKey: string;
+    adminApiKey: string;
+};
+export declare function renderEntrypoint(input: TemplateInput): string;
+export declare function writeTemplate(targetDir: string, files: Record<string, string>): Promise<void>;
+export declare function initTemplateAuth(dir: string, key: string, guestApiKey: string, adminApiKey: string): Promise<void>;
+//# sourceMappingURL=template.d.ts.map

package/dist/domain/template/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/domain/template/template.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAkFjJ;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAkF7D;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnG;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUxH"}

package/dist/domain/template/template.js

@@ -0,0 +1,215 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { FentarisAuth } from "@fentaris/core";
+import { authDir, remoteMcpUrl } from "../../shared/constants.js";
+import { writeCredentials } from "../auth/local-store.js";
+export function renderTemplate(input) {
+    return {
+        authKey: input.authKey,
+        guestApiKey: input.guestApiKey,
+        adminApiKey: input.adminApiKey,
+        files: {
+            "README.md": renderReadme(input),
+            "package.json": JSON.stringify({
+                name: input.projectName,
+                version: "0.1.0",
+                private: true,
+                type: "module",
+                scripts: {
+                    dev: "tsx src/index.ts",
+                    build: "tsc -p tsconfig.json",
+                    start: "node dist/index.js",
+                },
+                dependencies: {
+                    "@modelcontextprotocol/server-filesystem": "latest",
+                    "@fentaris/core": "latest",
+                    tsx: "latest",
+                },
+                devDependencies: {
+                    typescript: "latest",
+                },
+            }, null, 2),
+            "tsconfig.json": JSON.stringify({
+                compilerOptions: {
+                    target: "ES2022",
+                    module: "NodeNext",
+                    moduleResolution: "NodeNext",
+                    strict: true,
+                    esModuleInterop: true,
+                    skipLibCheck: true,
+                    outDir: "dist",
+                    rootDir: "src",
+                },
+                include: ["src"],
+            }, null, 2),
+            "fentaris.json": JSON.stringify({
+                name: input.projectName,
+                packageManager: input.packageManager,
+                entrypoint: "src/index.ts",
+                port: input.port,
+                path: input.proxyPath,
+                authDir,
+            }, null, 2),
+            ".env.example": [
+                `FENTARIS_AUTH_KEY=${input.authKey}`,
+                `FENTARIS_GUEST_API_KEY=${input.guestApiKey}`,
+                `FENTARIS_ADMIN_API_KEY=${input.adminApiKey}`,
+                `FENTARIS_PORT=${input.port}`,
+                `FENTARIS_PATH=${input.proxyPath}`,
+                "",
+            ].join("\n"),
+            ".gitignore": [
+                "node_modules/",
+                "dist/",
+                ".env",
+                ".env.*",
+                "!.env.example",
+                ".fentaris/",
+                ".fentaris/build/",
+                "*.log",
+                "",
+            ].join("\n"),
+            "src/index.ts": renderEntrypoint(input),
+            "demo-files/README.md": "# Fentaris demo files\n\nThis directory is intentionally scoped for the demo filesystem MCP server.\n",
+        },
+    };
+}
+export function renderEntrypoint(input) {
+    return `import {
+  MemoryRateLimitStore,
+  SlidingWindowRateLimiter,
+  credentialJson,
+  fentaris,
+  group,
+  mcp,
+  policy,
+  rateLimitMiddleware,
+  stdio,
+  streamableHttp,
+  user,
+} from "@fentaris/core";
+
+const port = Number(process.env.FENTARIS_PORT ?? ${input.port});
+const proxyPath = process.env.FENTARIS_PATH ?? "${input.proxyPath}";
+
+const guest = user("guest", {
+  displayName: "Guest Demo User",
+  apiKeys: [credentialJson("users.guest.apiKeys.0")],
+});
+const admin = user("admin", {
+  displayName: "Admin Demo User",
+  apiKeys: [credentialJson("users.admin.apiKeys.0")],
+});
+
+const limitedPolicy = policy("limited-demo")
+  .server("demo-files")
+  .allow("list_allowed_directories")
+  .server("demo-files")
+  .allow("list_directory")
+  .server("specification")
+  .allow("*");
+
+const adminPolicy = policy("admin-full-access").server("*").allow("*");
+
+const limiter = new SlidingWindowRateLimiter({
+  store: new MemoryRateLimitStore(),
+  maxPerWindow: 30,
+  windowMs: 60_000,
+});
+
+const app = fentaris({
+  port,
+  path: proxyPath,
+  groups: [
+    group({ id: "limited", users: [guest], policy: limitedPolicy }),
+    group({ id: "admins", users: [admin], policy: adminPolicy }),
+  ],
+  servers: [
+    mcp("demo-files", {
+      transport: stdio({
+        command: "npx",
+        args: ["-y", "@modelcontextprotocol/server-filesystem", "./demo-files"],
+      }),
+    }),
+    mcp("specification", {
+      transport: streamableHttp({
+        url: "${remoteMcpUrl}",
+      }),
+    }),
+  ],
+});
+
+// Global middleware runs before requests are forwarded to upstream MCP servers.
+app.use(rateLimitMiddleware({ limiter }));
+
+app.server("demo-files").use((ctx, next) => {
+  console.log(\`demo-files -> \${ctx.operation}\`);
+  return next();
+});
+
+app.server("specification").on("tool:success", ({ ctx }) => {
+  console.log(\`specification -> \${ctx.tool?.name ?? ctx.operation}\`);
+});
+
+await app.start(() => {
+  console.log(\`Fentaris proxy listening at http://localhost:\${port}\${proxyPath}\`);
+  console.log("Use x-fentaris-api-key with the generated guest or admin key.");
+});
+`;
+}
+export async function writeTemplate(targetDir, files) {
+    for (const [relativePath, contents] of Object.entries(files)) {
+        const filePath = path.join(targetDir, relativePath);
+        await mkdir(path.dirname(filePath), { recursive: true });
+        await writeFile(filePath, contents);
+    }
+}
+export async function initTemplateAuth(dir, key, guestApiKey, adminApiKey) {
+    await mkdir(dir, { recursive: true });
+    await writeCredentials(dir, key, {
+        users: {
+            guest: { apiKeys: [FentarisAuth.hashApiKey(guestApiKey)], credentials: {} },
+            admin: { apiKeys: [FentarisAuth.hashApiKey(adminApiKey)], credentials: {} },
+        },
+        groups: { limited: {} },
+        defaults: {},
+    });
+}
+function renderReadme(input) {
+    return `# ${input.projectName}
+
+This project was generated by the Fentaris CLI. It starts a local MCP proxy with:
+
+- API-key authentication backed by encrypted credentials in \`.fentaris/credentials.enc.json\`
+- A limited \`guest\` user and an unrestricted \`admin\` user
+- A local filesystem demo server mounted as \`demo-files\`
+- A remote HTTP MCP server mounted as \`specification\`
+- A sliding-window rate limiter installed as global middleware
+
+## Quick start
+
+\`\`\`sh
+${input.packageManager} install
+cp .env.example .env
+${input.packageManager} dev
+\`\`\`
+
+The proxy listens on \`http://localhost:${input.port}${input.proxyPath}\` by default. Send requests with the \`x-fentaris-api-key\` header using one of the keys printed by \`fentaris init\`.
+
+## Project files
+
+- \`src/index.ts\` configures the proxy, users, policies, middleware, and upstream MCP servers.
+- \`fentaris.json\` is used by \`fentaris check\`, \`fentaris dev\`, and \`fentaris build\`.
+- \`.fentaris/credentials.enc.json\` stores encrypted local credentials and is intentionally ignored by git.
+- \`demo-files\` is the sandboxed directory exposed by the demo filesystem server.
+
+## Useful commands
+
+\`\`\`sh
+fentaris check --offline
+fentaris secrets set github.token --user admin
+fentaris build
+\`\`\`
+`;
+}
+//# sourceMappingURL=template.js.map

package/dist/domain/template/template.js.map

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

package/dist/index.d.ts

@@ -1,74 +1,9 @@
 #!/usr/bin/env node
-import { type SpawnOptions } from "node:child_process";
-type CliOptions = Record<string, string | boolean>;
-type CliCommand = {
-    name: string;
-    args: string[];
-    options: CliOptions;
-};
-type PackageManager = "pnpm" | "npm" | "bun";
-type CommandResult = {
-    code: number;
-};
-type ProcessRunner = (command: string, args: string[], options?: SpawnOptions) => Promise<CommandResult>;
-type ExecProbe = (command: string, args?: string[]) => boolean;
-export type Prompt = {
-    text(question: string, options?: {
-        secret?: boolean;
-        defaultValue?: string;
-    }): Promise<string>;
-    select<T extends string>(question: string, choices: T[]): Promise<T>;
-    confirm(question: string): Promise<boolean>;
-    close(): void;
-};
-export type Runtime = {
-    cwd: string;
-    env: NodeJS.ProcessEnv;
-    out: Pick<typeof console, "log" | "error">;
-    runner: ProcessRunner;
-    probe: ExecProbe;
-    prompt: Prompt;
-};
-type TemplateInput = {
-    projectName: string;
-    packageManager: PackageManager;
-    port: number;
-    proxyPath: string;
-    authKey: string;
-    guestApiKey: string;
-    adminApiKey: string;
-};
-type ProjectConfig = {
-    name: string;
-    packageManager: PackageManager;
-    entrypoint: string;
-    port: number;
-    path: string;
-    authDir: string;
-    upstreams?: Array<{
-        name: string;
-        type: "stdio" | "http";
-        url?: string;
-        command?: string;
-        args?: string[];
-    }>;
-};
-type ProjectDiscovery = {
-    root: string;
-    configPath: string;
-    config: ProjectConfig;
-};
+import { discoverProject, ensureEmptyTargetDirectory, resolveProjectName, selectPackageManager } from "./domain/project/project.js";
+import { renderEntrypoint, renderTemplate } from "./domain/template/template.js";
+import { parseCommand } from "./shared/parse.js";
+import type { Runtime } from "./shared/types.js";
+export { discoverProject, ensureEmptyTargetDirectory, parseCommand, renderEntrypoint, renderTemplate, resolveProjectName, selectPackageManager };
+export type { Prompt, Runtime } from "./shared/types.js";
 export declare function main(argv: string[], runtime?: Runtime): Promise<number>;
-export declare function parseCommand(argv: string[]): CliCommand;
-export declare function resolveProjectName(provided: string | undefined, prompt: Prompt): Promise<string>;
-export declare function ensureEmptyTargetDirectory(targetDir: string): Promise<void>;
-export declare function selectPackageManager(probe: ExecProbe, prompt: Prompt): Promise<PackageManager>;
-export declare function renderTemplate(input: TemplateInput): {
-    files: Record<string, string>;
-    authKey: string;
-    guestApiKey: string;
-    adminApiKey: string;
-};
-export declare function discoverProject(fromDir: string): Promise<ProjectDiscovery>;
-export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAgBzE,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;AACnD,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,UAAU,CAAC;CACrB,CAAC;AACF,KAAK,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAC7C,KAAK,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACtC,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AACzG,KAAK,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;AAC/D,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/F,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AACF,MAAM,MAAM,OAAO,GAAG;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,EAAE,IAAI,CAAC,OAAO,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;IAC3C,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,cAAc,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AASF,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC9G,CAAC;AACF,KAAK,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAQpF,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,UAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAYtF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAsBvD;AA8FD,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWtG;AAED,wBAAsB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAajF;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAWpG;AA2QD,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA8FjJ;AAmGD,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAehF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACpI,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,CAAC;AACjJ,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEzD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,OAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAEzF"}