@x-code-cli/core 0.2.9 → 0.3.0

package/dist/plugins/installer.js

@@ -0,0 +1,416 @@
+// @x-code-cli/core — Plugin installer
+//
+// Three supported source kinds:
+//
+//   - 'local'   filesystem directory → copied recursively into cache
+//                (skipping .git / node_modules / OS junk)
+//   - 'git'     arbitrary git URL    → shallow-cloned (depth 1, optional ref)
+//   - 'github'  github:owner/repo    → shallow-cloned via resolveCloneUrl
+//                Monorepo `subdir` supported: whole repo is shallow-cloned,
+//                the named subdir is copied into a fresh temp dir, the rest
+//                discarded.
+//
+// Install flow:
+//   1. Fetch source into a temp dir
+//   2. Discover + parse manifest (reject Gemini-only sources here)
+//   3. Compute final cache path: cache/<marketplace>/<plugin>/<version>/
+//   4. Wipe any existing install at that path (re-install / same-version upgrade)
+//   5. Move temp → final (rename when possible, copy+rm fallback for EXDEV)
+//   6. Append/update installed_plugins.json
+//
+// AbortSignal threads through git clone (via execa's `signal`) and the
+// recursive copy (cooperative check between entries) so Esc during a long
+// install cleanly cancels in-flight work.
+//
+// Cache layout is deliberately per-version so `/plugin update` can install
+// a new version side-by-side and atomically switch (a later improvement);
+// today we just overwrite same-version installs.
+import { execa } from 'execa';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { debugLog } from '../utils.js';
+import { buildConsentPreview, probePluginRoot } from './consent.js';
+import { ManifestParseError, discoverManifest, parseManifest } from './manifest.js';
+import { RESERVED_MARKETPLACE_NAMES, readKnownMarketplaces, resolveCloneUrl } from './marketplace.js';
+import { installedPluginsPath, pluginCacheDir, pluginCacheParent } from './paths.js';
+import { setPluginUserConfig } from './user-config.js';
+export class InstallError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InstallError';
+    }
+}
+export async function installPlugin(req) {
+    // ── Pre-flight policy checks (cheap, fail-fast) ──
+    // `strictKnownMarketplaces` and `blockedPlugins` come from
+    // ~/.x-code/plugins/known_marketplaces.json. When the admin
+    // (typically enterprise) has opted into strict mode, every install
+    // must come from a subscribed marketplace — direct git / github /
+    // local installs are denied. `blockedPlugins` is checked after the
+    // manifest is parsed (we need the canonical id).
+    const km = await readKnownMarketplaces();
+    if (km.strictKnownMarketplaces) {
+        const subscribed = km.marketplaces.some((m) => m.name === req.marketplace);
+        if (!subscribed) {
+            throw new InstallError(`strict marketplace mode is enabled (known_marketplaces.json:strictKnownMarketplaces=true) — ` +
+                `plugins can only be installed from a subscribed marketplace, but "${req.marketplace}" is not one. ` +
+                `Either subscribe it first (\`xc plugin marketplace add\`) or turn strict mode off.`);
+        }
+    }
+    const tempDir = await fetchToTemp(req.source, req.signal);
+    try {
+        const discovery = await discoverManifest(tempDir);
+        if (!discovery) {
+            throw new InstallError('no plugin manifest found in source (looked for .x-code-plugin/plugin.json, .claude-plugin/plugin.json, plugin.json)');
+        }
+        if (discovery.format === 'gemini') {
+            throw new InstallError('this is a Gemini extension (gemini-extension.json) — x-code-cli does not support Gemini extensions; see docs/plugins.md');
+        }
+        let manifest;
+        try {
+            manifest = await parseManifest(discovery.manifestPath);
+        }
+        catch (err) {
+            if (err instanceof ManifestParseError)
+                throw new InstallError(err.message);
+            throw err;
+        }
+        if (req.expectedName && manifest.name !== req.expectedName) {
+            throw new InstallError(`manifest name "${manifest.name}" does not match expected "${req.expectedName}"`);
+        }
+        // Now that we know the canonical plugin id, run the second
+        // policy check: blockedPlugins from known_marketplaces.json. This
+        // is an admin-style force-disable list — an install attempt for
+        // a blocked id is rejected regardless of marketplace / consent.
+        // Two match forms are accepted:
+        //   - Fully-qualified id `name@marketplace` — precise (admin can
+        //     block one marketplace's variant without affecting forks)
+        //   - Bare name `name` — broad (admin can block every marketplace's
+        //     plugin with that name in one shot; matches the npm `--ignore`
+        //     style some admins expect)
+        const earlyId = `${manifest.name}@${req.marketplace}`;
+        const blocked = km.blockedPlugins?.find((b) => b === earlyId || b === manifest.name);
+        if (blocked) {
+            throw new InstallError(`plugin "${earlyId}" is on the blockedPlugins list in known_marketplaces.json ` +
+                `(matched entry: "${blocked}") — remove it from that list (or use a different plugin) to install.`);
+        }
+        // ── Consent gate ──
+        // Built from the parsed manifest so the caller can render a
+        // preview of what the plugin will contribute (hooks, mcp, scopes)
+        // and ask the user explicitly. Skipping the prompt (callback
+        // absent) is intentional for non-interactive paths — the CLI
+        // implements `--yes` by simply not passing `consent`.
+        if (req.consent) {
+            const rootProbe = await probePluginRoot(tempDir);
+            const preview = buildConsentPreview({
+                pluginId: `${manifest.name}@${req.marketplace}`,
+                manifest,
+                source: req.source,
+                marketplace: req.marketplace,
+                verified: req.verified,
+                fromReservedMarketplace: req.marketplace in RESERVED_MARKETPLACE_NAMES,
+                rootProbe,
+            });
+            const accepted = await req.consent(preview);
+            if (!accepted) {
+                throw new InstallError('install cancelled by user (consent declined)');
+            }
+        }
+        // ── userConfig prompt (post-consent, pre-commit) ──
+        // Only fires when the manifest declares userConfig fields AND the
+        // caller wired a prompt callback. Non-interactive paths (--yes, CI)
+        // skip the prompt — fields stay unset and the plugin sees empty env
+        // vars at hook / mcp launch time, same as before this feature.
+        // Returning null from the prompt aborts the install (treated like
+        // consent denial); a non-null object is persisted via setPluginUserConfig.
+        if (manifest.userConfig && manifest.userConfig.length > 0 && req.userConfigPrompt) {
+            const collected = await req.userConfigPrompt(manifest.userConfig);
+            if (collected === null) {
+                throw new InstallError('install cancelled by user (userConfig prompt aborted)');
+            }
+            // Persist BEFORE moving the temp dir to cache so a crash between
+            // the two phases leaves the user with no broken plugin and no
+            // orphaned secret. The settings file is keyed by plugin id and
+            // overwrites cleanly on reinstall.
+            const pluginIdForConfig = `${manifest.name}@${req.marketplace}`;
+            await setPluginUserConfig(pluginIdForConfig, collected);
+        }
+        const finalDir = pluginCacheDir(req.marketplace, manifest.name, manifest.version);
+        // Same-version reinstall: wipe existing install first. Skipping this
+        // would leave stale files mixed with new ones if the new version drops
+        // a file the old version had.
+        await fs.rm(finalDir, { recursive: true, force: true });
+        await fs.mkdir(path.dirname(finalDir), { recursive: true });
+        await moveOrCopy(tempDir, finalDir, req.signal);
+        const pluginId = `${manifest.name}@${req.marketplace}`;
+        const record = {
+            id: pluginId,
+            name: manifest.name,
+            marketplace: req.marketplace,
+            version: manifest.version,
+            source: req.source,
+            installedAt: new Date().toISOString(),
+            installScope: req.scope ?? 'user',
+        };
+        await recordInstallation(record);
+        return { pluginId, rootDir: finalDir, manifest, manifestFormat: discovery.format, record };
+    }
+    catch (err) {
+        // Best-effort cleanup of the temp dir on any failure mid-install. The
+        // moveOrCopy success path renames the temp away, so this only fires
+        // when something went wrong before the move.
+        await fs.rm(tempDir, { recursive: true, force: true }).catch(() => {
+            /* nothing useful to do */
+        });
+        if (err instanceof InstallError || err instanceof ManifestParseError)
+            throw err;
+        throw new InstallError(err instanceof Error ? err.message : String(err));
+    }
+}
+// ── Source → temp dir ───────────────────────────────────────────────────
+async function fetchToTemp(source, signal) {
+    const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'xc-plugin-install-'));
+    if (source.kind === 'local') {
+        const resolved = path.resolve(source.path);
+        const stat = await fs.stat(resolved).catch(() => null);
+        if (!stat || !stat.isDirectory()) {
+            await fs.rm(tempDir, { recursive: true, force: true }).catch(() => { });
+            // Surface cwd in the error: relative paths get resolved against
+            // process.cwd(), and when xc is launched via `pnpm dev` the cwd
+            // is `packages/cli/`, not the repo root — that mismatch confuses
+            // users typing `./foo` in the slash command. Showing both the
+            // resolved absolute path and the cwd makes the cause obvious.
+            const isRelative = !path.isAbsolute(source.path);
+            const cwdHint = isRelative ? ` (resolved relative to cwd: ${process.cwd()})` : '';
+            throw new InstallError(`local source is not a directory: ${resolved}${cwdHint}`);
+        }
+        await copyDirFiltered(resolved, tempDir, signal);
+        return tempDir;
+    }
+    if (source.kind === 'git' || source.kind === 'github') {
+        const cloneUrl = source.kind === 'git' ? source.url : resolveCloneUrl(`github:${source.owner}/${source.repo}`);
+        const args = ['clone', '--depth', '1'];
+        if (source.ref)
+            args.push('--branch', source.ref);
+        // For subdir installs we still shallow-clone the whole repo. Real
+        // sparse-checkout would be faster on huge monorepos but the
+        // `--depth 1 --filter=blob:none --sparse` sequence is fragile across
+        // git versions; a depth-1 clone of even a large monorepo is usually
+        // <100 MB. Revisit if it becomes a pain point.
+        args.push(cloneUrl, tempDir);
+        try {
+            await execa('git', args, { signal, stdio: 'pipe' });
+        }
+        catch (err) {
+            await fs.rm(tempDir, { recursive: true, force: true }).catch(() => { });
+            throw new InstallError(`git clone failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Integrity check: when the marketplace.json pinned a `sha`, verify
+        // that the commit we actually cloned matches it. Defends against the
+        // upstream ref being force-pushed or the repo being compromised
+        // between marketplace review and end-user install. Must run BEFORE
+        // we drop `.git` below (rev-parse needs the repo metadata).
+        //
+        // Prefix-match semantics: declared sha can be a short sha (≥7 hex)
+        // and still validate against the full 40-char HEAD — same tolerance
+        // as `git checkout <short-sha>` and what real marketplaces produce
+        // (anthropics/claude-plugins-official sometimes ships 7-char shas).
+        //
+        // Why hard fail and not warn: a sha mismatch is by definition either
+        // a misconfigured marketplace.json (author bug) or a real
+        // supply-chain anomaly. Either way the user shouldn't end up with
+        // unreviewed code on disk. Better to surface a loud error pointing
+        // at the marketplace author than to silently install whatever HEAD
+        // happens to be.
+        if (source.expectedSha) {
+            try {
+                const result = await execa('git', ['rev-parse', 'HEAD'], { cwd: tempDir, stdio: 'pipe', signal });
+                const actualSha = result.stdout.trim().toLowerCase();
+                const expected = source.expectedSha.toLowerCase();
+                if (!actualSha.startsWith(expected)) {
+                    await fs.rm(tempDir, { recursive: true, force: true }).catch(() => { });
+                    throw new InstallError(`sha integrity check failed for ${cloneUrl}${source.ref ? `@${source.ref}` : ''}: ` +
+                        `marketplace.json declared sha=${expected}, actual HEAD=${actualSha}. ` +
+                        `The upstream ref may have been force-pushed or the repo compromised. ` +
+                        `Contact the marketplace author or pin to a different version.`);
+                }
+            }
+            catch (err) {
+                if (err instanceof InstallError)
+                    throw err;
+                // rev-parse failed (shouldn't happen on a fresh clone) — treat
+                // as integrity failure so we don't silently install unchecked.
+                await fs.rm(tempDir, { recursive: true, force: true }).catch(() => { });
+                throw new InstallError(`failed to verify sha for ${cloneUrl}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // Drop the .git dir — we never need it after install and it would
+        // bloat the cache significantly for large-history repos.
+        await fs.rm(path.join(tempDir, '.git'), { recursive: true, force: true }).catch(() => { });
+        // Subdir handling: the plugin actually lives at <tempDir>/<subdir>.
+        // Re-stage so the rest of the install flow (manifest discovery +
+        // moveOrCopy to cache) operates on just that subdir. Simplest
+        // approach: copy the subdir into a fresh temp dir, discard the
+        // original clone.
+        const subdir = source.subdir;
+        if (subdir) {
+            const subdirPath = path.join(tempDir, subdir);
+            const stat = await fs.stat(subdirPath).catch(() => null);
+            if (!stat || !stat.isDirectory()) {
+                await fs.rm(tempDir, { recursive: true, force: true }).catch(() => { });
+                throw new InstallError(`subdir "${subdir}" not found in cloned repo ${cloneUrl}`);
+            }
+            const subdirTemp = await fs.mkdtemp(path.join(os.tmpdir(), 'xc-plugin-subdir-'));
+            try {
+                await copyDirFiltered(subdirPath, subdirTemp, signal);
+            }
+            catch (err) {
+                await fs.rm(subdirTemp, { recursive: true, force: true }).catch(() => { });
+                await fs.rm(tempDir, { recursive: true, force: true }).catch(() => { });
+                throw new InstallError(`failed to extract subdir: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            await fs.rm(tempDir, { recursive: true, force: true }).catch(() => { });
+            return subdirTemp;
+        }
+        return tempDir;
+    }
+    await fs.rm(tempDir, { recursive: true, force: true }).catch(() => { });
+    throw new InstallError(`unknown source kind: ${source.kind}`);
+}
+/** Names we never copy through. `node_modules` is excluded because a
+ *  bundled-deps plugin should reinstall on the user's machine; if a
+ *  plugin genuinely needs node_modules we'll revisit. */
+const COPY_SKIP = new Set(['.git', 'node_modules', '.DS_Store', 'Thumbs.db']);
+async function copyDirFiltered(src, dst, signal, root) {
+    // `root` is captured on the first (non-recursive) call so the symlink
+    // escape check below validates against the original plugin source, not
+    // the current recursion's `src` (which moves with each subdir).
+    const rootDir = root ?? src;
+    await fs.mkdir(dst, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        signal?.throwIfAborted();
+        if (COPY_SKIP.has(entry.name))
+            continue;
+        const s = path.join(src, entry.name);
+        const d = path.join(dst, entry.name);
+        if (entry.isDirectory()) {
+            await copyDirFiltered(s, d, signal, rootDir);
+        }
+        else if (entry.isFile()) {
+            await fs.copyFile(s, d);
+        }
+        else if (entry.isSymbolicLink()) {
+            // Resolve the symlink target relative to its containing directory.
+            // If the resolved target escapes the plugin source root, drop the
+            // symlink rather than preserve it: on POSIX a `evil -> /etc/passwd`
+            // in the plugin tree would put a host-file pointer in the cache for
+            // loader / hooks to deref at runtime; on Windows the fallback below
+            // would copy `/etc/passwd`-equivalents straight into the cache.
+            // We don't follow the symlink to validate that the target exists —
+            // a broken-but-in-bounds symlink is still safe to preserve.
+            const target = await fs.readlink(s);
+            const resolved = path.resolve(path.dirname(s), target);
+            const rel = path.relative(rootDir, resolved);
+            if (rel === '' || rel.startsWith('..') || path.isAbsolute(rel)) {
+                debugLog('plugins.copy-symlink-escape', `${s} -> ${target} (resolved ${resolved}, outside ${rootDir})`);
+                continue;
+            }
+            try {
+                await fs.symlink(target, d);
+            }
+            catch {
+                // Windows without symlink privilege: fall back to copying the
+                // resolved file. Best effort — broken symlinks just get dropped.
+                await fs.copyFile(s, d).catch(() => { });
+            }
+        }
+    }
+}
+/** Move from temp → final dir. Rename is atomic + cheap when src and dst
+ *  are on the same filesystem; otherwise (EXDEV on Windows mostly) we
+ *  fall back to copy + rm. */
+async function moveOrCopy(src, dst, signal) {
+    try {
+        await fs.rename(src, dst);
+        return;
+    }
+    catch (err) {
+        const code = err.code;
+        if (code !== 'EXDEV' && code !== 'EPERM' && code !== 'ENOTEMPTY') {
+            // Surfacing the original error here would block install for transient
+            // weirdness; the copy fallback below succeeds in all the cases we've
+            // seen in the wild. Still log for postmortem.
+            debugLog('plugins.install-rename-fallback', String(err));
+        }
+    }
+    await copyDirFiltered(src, dst, signal);
+    await fs.rm(src, { recursive: true, force: true }).catch(() => { });
+}
+// ── installed_plugins.json bookkeeping ──────────────────────────────────
+async function readInstalledPlugins() {
+    const file = installedPluginsPath();
+    try {
+        const raw = await fs.readFile(file, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || !Array.isArray(parsed.plugins)) {
+            return { schemaVersion: '1', plugins: [] };
+        }
+        return { schemaVersion: parsed.schemaVersion ?? '1', plugins: parsed.plugins };
+    }
+    catch {
+        return { schemaVersion: '1', plugins: [] };
+    }
+}
+async function writeInstalledPlugins(data) {
+    const file = installedPluginsPath();
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    await fs.writeFile(file, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+async function recordInstallation(record) {
+    const data = await readInstalledPlugins();
+    const idx = data.plugins.findIndex((p) => p.id === record.id);
+    if (idx >= 0)
+        data.plugins[idx] = record;
+    else
+        data.plugins.push(record);
+    await writeInstalledPlugins(data);
+}
+export async function listInstalledPlugins() {
+    const data = await readInstalledPlugins();
+    return data.plugins;
+}
+export async function findInstalledPlugin(id) {
+    const data = await readInstalledPlugins();
+    return data.plugins.find((p) => p.id === id);
+}
+/** Remove all cached versions of a plugin + drop its
+ *  installed_plugins.json record. Leaves the data dir
+ *  (`~/.x-code/plugins/data/<id>/`) intact so the user doesn't lose
+ *  state if they reinstall later. */
+export async function uninstallPlugin(id) {
+    const record = await findInstalledPlugin(id);
+    const result = { removedVersions: [], removedRecord: false };
+    if (record) {
+        const parent = pluginCacheParent(record.marketplace, record.name);
+        try {
+            const versions = await fs.readdir(parent);
+            result.removedVersions = versions;
+            await fs.rm(parent, { recursive: true, force: true });
+        }
+        catch {
+            // No cache entries — the record might be stale. Removing the record
+            // below still happens.
+        }
+    }
+    const data = await readInstalledPlugins();
+    const before = data.plugins.length;
+    data.plugins = data.plugins.filter((p) => p.id !== id);
+    if (data.plugins.length !== before) {
+        await writeInstalledPlugins(data);
+        result.removedRecord = true;
+    }
+    return result;
+}
+//# sourceMappingURL=installer.js.map

package/dist/plugins/installer.js.map

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

package/dist/plugins/integration.d.ts

@@ -0,0 +1,91 @@
+import { HookBus } from '../hooks/bus.js';
+import { HookRegistry } from '../hooks/registry.js';
+import type { McpServerConfig } from '../mcp/types.js';
+import { loadAllPlugins } from './loader.js';
+import type { LoadResult } from './loader.js';
+export interface PluginIntegrationOutput {
+    /** Extra skill directories the skill loader should scan, with the
+     *  owning plugin id stamped on each. Only enabled plugins included. */
+    skillsDirs: Array<{
+        dir: string;
+        pluginId: string;
+    }>;
+    /** Same as above for sub-agent .md files. */
+    agentsDirs: Array<{
+        dir: string;
+        pluginId: string;
+    }>;
+    /** Same as above for slash command `*.md` files. Each entry carries
+     *  the owning plugin's rootDir so the command body can substitute
+     *  `${CLAUDE_PLUGIN_ROOT}` at activation time. */
+    commandsDirs: Array<{
+        dir: string;
+        pluginId: string;
+        pluginRoot: string;
+    }>;
+    /** Merged `mcpServers` block from every enabled plugin. Name
+     *  collisions resolved first-wins; the losers are recorded in
+     *  `mcpCollisions`. */
+    mcpServers: Record<string, McpServerConfig>;
+    /** Hook registry built from every enabled plugin's `hooks` config.
+     *  Empty when no plugin declared any hooks. Hand this to
+     *  `new HookBus(...)` to wire the agent loop's emit-sites. */
+    hookRegistry: HookRegistry;
+    /** Ready-to-use bus over `hookRegistry`. Convenience for the CLI
+     *  startup wiring — `AgentOptions.hookBus = integration.hookBus`. */
+    hookBus: HookBus;
+    /** Per-plugin summary of which event names had hooks — used by
+     *  `/plugin doctor` and `/plugin info` UI. */
+    pluginHooks: Array<{
+        pluginId: string;
+        events: string[];
+    }>;
+    /** mcpServers entries dropped due to name collision with an earlier
+     *  plugin. `{ name, droppedFrom, keptFrom }`. */
+    mcpCollisions: Array<{
+        name: string;
+        droppedFrom: string;
+        keptFrom: string;
+    }>;
+    /** mcpServers parse / read errors per plugin — these don't block
+     *  startup, they surface in `/plugin doctor`. */
+    mcpErrors: Array<{
+        pluginId: string;
+        message: string;
+    }>;
+    /** Hooks parse / read errors per plugin. */
+    hookErrors: Array<{
+        pluginId: string;
+        message: string;
+    }>;
+}
+export declare function buildPluginIntegration(load: LoadResult): Promise<PluginIntegrationOutput>;
+/** Extract the `name → cfg` block from the contents of a `.mcp.json`
+ *  file. Two shapes are accepted:
+ *
+ *    - Wrapped:  `{ "mcpServers": { "name": cfg, ... } }`
+ *    - Flat:     `{ "name": cfg, ... }`  (no wrapper key)
+ *
+ *  Claude Code's official plugins (e.g. linear@anthropic-marketplace)
+ *  ship the flat form; the wrapped form matches our own config.json
+ *  layout. The detection rule is: if the parsed object has a
+ *  `mcpServers` key at all, treat it as wrapped (and pass through the
+ *  value as-is so the schema parser produces a clean error on
+ *  misshape). Otherwise treat the whole object as the flat block. */
+export declare function extractMcpServersBlock(parsed: unknown): unknown;
+/** Convenience: log non-fatal integration diagnostics to debug.log so
+ *  `/plugin doctor` and ad-hoc support can find them. CLI startup calls
+ *  this after `buildPluginIntegration` returns. */
+export declare function debugLogIntegrationDiagnostics(integration: PluginIntegrationOutput): void;
+/** Re-scan plugins from disk and return just the merged plugin-contributed
+ *  mcpServers block. Used by `/mcp refresh` to include plugin servers in
+ *  the merged map (so they aren't silently dropped on standalone MCP
+ *  refresh) and by `/plugin refresh` indirectly via buildPluginIntegration.
+ *
+ *  Returns `{}` (not undefined) so callers can spread it unconditionally.
+ *  Scan failures degrade to `{}` + debug log — callers shouldn't have an
+ *  MCP-only refresh fail because of a plugin-system hiccup. */
+export declare function getPluginMcpServersFromDisk(cwd: string): Promise<Record<string, McpServerConfig>>;
+export type { LoadResult, ResolvedContributions } from './loader.js';
+export { loadAllPlugins };
+//# sourceMappingURL=integration.d.ts.map

package/dist/plugins/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../src/plugins/integration.ts"],"names":[],"mappings":"AAoCA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAEzC,OAAO,EAAE,YAAY,EAAqB,MAAM,sBAAsB,CAAA;AAItE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,aAAa,CAAA;AAIpE,MAAM,WAAW,uBAAuB;IACtC;2EACuE;IACvE,UAAU,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACpD,6CAA6C;IAC7C,UAAU,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACpD;;sDAEkD;IAClD,YAAY,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC1E;;2BAEuB;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC3C;;kEAE8D;IAC9D,YAAY,EAAE,YAAY,CAAA;IAC1B;yEACqE;IACrE,OAAO,EAAE,OAAO,CAAA;IAChB;kDAC8C;IAC9C,WAAW,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IAC1D;qDACiD;IACjD,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC7E;qDACiD;IACjD,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACvD,4CAA4C;IAC5C,UAAU,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACzD;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAuD/F;AAiCD;;;;;;;;;;;qEAWqE;AACrE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAK/D;AAsDD;;mDAEmD;AACnD,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,uBAAuB,GAAG,IAAI,CAgBzF;AAED;;;;;;;+DAO+D;AAC/D,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CASvG;AAID,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,CAAA"}