opencode-multidevice-sync 0.1.0

package/dist/core/fsx.js

@@ -0,0 +1,353 @@
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Filesystem helpers used by staging.
+ *
+ * Two properties matter throughout this module:
+ *
+ * 1. **Symlinks are refused, never followed.** A sync repo that follows a
+ *    symlink can be tricked into copying arbitrary files off the machine, and
+ *    on Windows a directory junction silently turns a delete into a delete of
+ *    something else entirely.
+ * 2. **Replacements are atomic.** Destinations are built beside the target and
+ *    renamed into place, so a crash mid-copy can never leave a half-written
+ *    config that stops OpenCode from starting.
+ */
+export function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+export function exists(target) {
+    return fs.existsSync(target);
+}
+export function removeRecursive(target) {
+    fs.rmSync(target, { recursive: true, force: true });
+}
+export class SymlinkRefusedError extends Error {
+    constructor(role, target) {
+        super(`Refusing to sync ${role} symlink/junction: ${target}`);
+        this.name = "SymlinkRefusedError";
+    }
+}
+export function rejectLink(target, role) {
+    try {
+        if (fs.lstatSync(target).isSymbolicLink())
+            throw new SymlinkRefusedError(role, target);
+    }
+    catch (err) {
+        if (err instanceof SymlinkRefusedError)
+            throw err;
+        if (err?.code !== "ENOENT")
+            throw err;
+    }
+}
+/** Write only when the content actually differs. Returns true if written. */
+export function writeIfDiffers(filePath, content) {
+    if (fs.existsSync(filePath) && fs.readFileSync(filePath, "utf8") === content)
+        return false;
+    ensureDir(path.dirname(filePath));
+    fs.writeFileSync(filePath, content);
+    return true;
+}
+/** Create the file only when missing. Returns true if created. */
+export function ensureFile(filePath, content) {
+    if (fs.existsSync(filePath))
+        return false;
+    ensureDir(path.dirname(filePath));
+    fs.writeFileSync(filePath, content);
+    return true;
+}
+export function copyFileIfExists(src, dst) {
+    if (!fs.existsSync(src))
+        return false;
+    rejectLink(src, "source");
+    rejectLink(dst, "target");
+    ensureDir(path.dirname(dst));
+    fs.copyFileSync(src, dst);
+    return true;
+}
+/** Copy `src` onto `dst`, deleting `dst` when `src` does not exist. */
+export function mirrorFile(src, dst) {
+    rejectLink(src, "source");
+    rejectLink(dst, "target");
+    if (!fs.existsSync(src)) {
+        fs.rmSync(dst, { recursive: true, force: true });
+        return 0;
+    }
+    return copyFileIfExists(src, dst) ? 1 : 0;
+}
+export function copyDirRecursive(src, dst, options = {}) {
+    const { excludeFiles = new Set(), excludeDirs = new Set() } = options;
+    if (!fs.existsSync(src))
+        return 0;
+    rejectLink(src, "source");
+    rejectLink(dst, "target");
+    ensureDir(dst);
+    let count = 0;
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = path.join(src, entry.name);
+        if (entry.isSymbolicLink())
+            throw new SymlinkRefusedError("source", srcPath);
+        const dstPath = path.join(dst, entry.name);
+        if (entry.isDirectory()) {
+            if (excludeDirs.has(entry.name))
+                continue;
+            rejectLink(dstPath, "target");
+            count += copyDirRecursive(srcPath, dstPath, options);
+        }
+        else {
+            if (excludeFiles.has(entry.name))
+                continue;
+            rejectLink(dstPath, "target");
+            fs.copyFileSync(srcPath, dstPath);
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Mirror `srcDir` into `dstDir`, copying only what changed.
+ *
+ * Change detection compares size and modification time at **one-second
+ * granularity**, then falls back to a content compare. Whole seconds are
+ * exactly representable on every filesystem we support; sub-second precision
+ * drifts between NTFS and APFS and would make every run re-copy the entire
+ * tree, which defeats the point.
+ */
+export function syncDirIncremental(srcDir, dstDir, options = {}) {
+    const { excludeFiles = new Set(), excludeDirs = new Set(), deleteExtraneous = true, } = options;
+    rejectLink(srcDir, "source");
+    rejectLink(dstDir, "target");
+    if (!fs.existsSync(srcDir)) {
+        // Source gone means the user deleted it; mirror that so the repo stays
+        // an accurate reflection of the machine rather than growing forever.
+        if (fs.existsSync(dstDir))
+            fs.rmSync(dstDir, { recursive: true, force: true });
+        return { copied: 0, deleted: 0 };
+    }
+    ensureDir(dstDir);
+    let copied = 0;
+    let deleted = 0;
+    const walkSource = (rel) => {
+        const srcAbs = rel ? path.join(srcDir, rel) : srcDir;
+        const dstAbs = rel ? path.join(dstDir, rel) : dstDir;
+        let entries;
+        try {
+            entries = fs.readdirSync(srcAbs, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const srcPath = path.join(srcAbs, entry.name);
+            if (entry.isSymbolicLink())
+                throw new SymlinkRefusedError("source", srcPath);
+            if (entry.isDirectory()) {
+                if (excludeDirs.has(entry.name))
+                    continue;
+                const childRel = rel ? path.join(rel, entry.name) : entry.name;
+                const dstChild = path.join(dstDir, childRel);
+                rejectLink(dstChild, "target");
+                ensureDir(dstChild);
+                walkSource(childRel);
+                continue;
+            }
+            if (excludeFiles.has(entry.name))
+                continue;
+            const dstFile = path.join(dstAbs, entry.name);
+            rejectLink(dstFile, "target");
+            const srcStat = fs.statSync(srcPath);
+            const srcSeconds = Math.floor(srcStat.mtimeMs / 1000);
+            let needCopy = true;
+            try {
+                const dstStat = fs.statSync(dstFile);
+                if (dstStat.size === srcStat.size && Math.floor(dstStat.mtimeMs / 1000) === srcSeconds) {
+                    needCopy = !fs.readFileSync(srcPath).equals(fs.readFileSync(dstFile));
+                }
+            }
+            catch {
+                // Missing destination — copy.
+            }
+            if (needCopy) {
+                fs.copyFileSync(srcPath, dstFile);
+                try {
+                    const stamp = new Date(srcSeconds * 1000);
+                    fs.utimesSync(dstFile, stamp, stamp);
+                }
+                catch {
+                    // Best effort; a failed utimes only costs one redundant copy later.
+                }
+                copied++;
+            }
+        }
+    };
+    const walkDestination = (rel) => {
+        const srcAbs = rel ? path.join(srcDir, rel) : srcDir;
+        const dstAbs = rel ? path.join(dstDir, rel) : dstDir;
+        let entries;
+        try {
+            entries = fs.readdirSync(dstAbs, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const childRel = rel ? path.join(rel, entry.name) : entry.name;
+            const srcChild = path.join(srcAbs, entry.name);
+            const dstChild = path.join(dstDir, childRel);
+            if (entry.isSymbolicLink())
+                throw new SymlinkRefusedError("target", dstChild);
+            if (entry.isDirectory()) {
+                if (excludeDirs.has(entry.name))
+                    continue;
+                if (!fs.existsSync(srcChild)) {
+                    fs.rmSync(dstChild, { recursive: true, force: true });
+                    deleted++;
+                }
+                else {
+                    walkDestination(childRel);
+                }
+                continue;
+            }
+            if (excludeFiles.has(entry.name))
+                continue;
+            if (!fs.existsSync(srcChild)) {
+                fs.unlinkSync(dstChild);
+                deleted++;
+            }
+        }
+    };
+    walkSource("");
+    if (deleteExtraneous)
+        walkDestination("");
+    return { copied, deleted };
+}
+/** Replace a single file atomically. */
+export function replaceFileAtomically(src, dst, options = {}) {
+    rejectLink(src, "source");
+    rejectLink(dst, "target");
+    if (!fs.existsSync(src)) {
+        if (!options.preserveMissing)
+            fs.rmSync(dst, { recursive: true, force: true });
+        return 0;
+    }
+    ensureDir(path.dirname(dst));
+    const temp = `${dst}.sync-${process.pid}-${Date.now()}`;
+    const backup = `${temp}.old`;
+    try {
+        fs.copyFileSync(src, temp);
+        fs.rmSync(backup, { recursive: true, force: true });
+        if (fs.existsSync(dst))
+            fs.renameSync(dst, backup);
+        fs.renameSync(temp, dst);
+        fs.rmSync(backup, { recursive: true, force: true });
+        return 1;
+    }
+    catch (err) {
+        fs.rmSync(temp, { recursive: true, force: true });
+        if (!fs.existsSync(dst) && fs.existsSync(backup))
+            fs.renameSync(backup, dst);
+        throw err;
+    }
+}
+/** Replace a whole directory atomically. */
+export function replaceDirAtomically(src, dst, options = {}) {
+    rejectLink(src, "source");
+    rejectLink(dst, "target");
+    if (!fs.existsSync(src)) {
+        removeRecursive(dst);
+        return 0;
+    }
+    const parent = path.dirname(dst);
+    ensureDir(parent);
+    const temp = path.join(parent, `.${path.basename(dst)}.sync-${process.pid}-${Date.now()}`);
+    const backup = `${temp}.old`;
+    removeRecursive(temp);
+    try {
+        const count = copyDirRecursive(src, temp, options);
+        for (const file of options.preserveRootFiles ?? []) {
+            copyFileIfExists(path.join(dst, file), path.join(temp, file));
+        }
+        if (fs.existsSync(dst))
+            fs.renameSync(dst, backup);
+        fs.renameSync(temp, dst);
+        removeRecursive(backup);
+        return count;
+    }
+    catch (err) {
+        removeRecursive(temp);
+        if (!fs.existsSync(dst) && fs.existsSync(backup))
+            fs.renameSync(backup, dst);
+        throw err;
+    }
+}
+/**
+ * Copy a path that may be either a file or a directory.
+ *
+ * OpenCode's `storage/migration` is a one-byte file while `storage/project` is
+ * a directory, and which is which has changed between releases — so the type is
+ * decided by looking at the source, not by assumption.
+ */
+export function copyPath(src, dst) {
+    rejectLink(src, "source");
+    rejectLink(dst, "target");
+    let stat;
+    try {
+        stat = fs.statSync(src);
+    }
+    catch {
+        fs.rmSync(dst, { recursive: true, force: true });
+        return 0;
+    }
+    return stat.isDirectory() ? replaceDirAtomically(src, dst) : replaceFileAtomically(src, dst);
+}
+/**
+ * Strip nested `.git` directories from a staging copy.
+ *
+ * The `skills` CLI installs by cloning, which leaves a `.git` inside the skill
+ * directory. Git records a nested repository as a gitlink instead of tracking
+ * the files, so the skill's contents become invisible to every other machine.
+ * Only staging copies are touched; the real source directories are never
+ * modified.
+ */
+export function removeNestedGitDirs(...dirs) {
+    let removed = 0;
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const child = path.join(dir, entry.name);
+            if (entry.name === ".git") {
+                fs.rmSync(child, { recursive: true, force: true });
+                removed++;
+                continue;
+            }
+            if (entry.isDirectory())
+                walk(child);
+        }
+    };
+    for (const dir of dirs) {
+        if (!fs.existsSync(dir))
+            continue;
+        // Walk the children rather than `dir` itself so the sync repo's own
+        // top-level `.git` is never deleted.
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory() || entry.name === ".git")
+                continue;
+            walk(path.join(dir, entry.name));
+        }
+    }
+    return removed;
+}
+//# sourceMappingURL=fsx.js.map

package/dist/core/fsx.js.map

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

package/dist/core/git.d.ts

@@ -0,0 +1,62 @@
+export interface GitResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+    code: number | null;
+}
+export interface GitOptions {
+    cwd: string;
+    /** Allow git to prompt on the terminal. Off by default so we never hang. */
+    interactive?: boolean;
+    timeoutMs?: number;
+}
+/**
+ * Run git and never throw.
+ *
+ * Every caller wants to inspect the failure rather than unwind, so the exit
+ * status is returned as data. Terminal prompting is disabled by default: a sync
+ * that silently blocks on a hidden credential prompt is far worse than one that
+ * fails fast with an actionable message.
+ */
+export declare function git(args: string[], options: GitOptions): GitResult;
+export declare function gitAsync(args: string[], options: GitOptions): Promise<GitResult>;
+export declare function isGitRepo(dir: string): boolean;
+export declare function firstLine(text: string): string;
+/** True when a git failure is really "your GitHub credentials are not working". */
+export declare function isAuthFailure(result: GitResult): boolean;
+export declare class GitAuthError extends Error {
+    readonly result: GitResult;
+    constructor(operation: string, result: GitResult);
+}
+export declare class GitError extends Error {
+    readonly result: GitResult;
+    constructor(operation: string, result: GitResult);
+}
+/** Convert a failed `GitResult` into the most specific error we can. */
+export declare function toGitError(operation: string, result: GitResult): Error;
+/**
+ * Extract the file paths from `git status --porcelain` output.
+ *
+ * The format is fixed-width — two status columns, a space, then the path — but
+ * this deliberately does not slice at a fixed offset. Output here is trimmed
+ * before parsing, which eats the leading space of an unstaged entry (` M file`)
+ * and shifts every subsequent column. Matching the status field by pattern
+ * instead survives that, as well as the quoting git applies to paths with
+ * unusual characters.
+ *
+ * Renames appear as `old -> new`; the destination is reported, since that is
+ * what exists afterwards.
+ */
+export declare function parsePorcelainPaths(output: string): string[];
+export interface NameStatusEntry {
+    kind: "added" | "modified" | "deleted" | "renamed";
+    path: string;
+}
+/**
+ * Parse `git diff --name-status` output.
+ *
+ * Rename entries carry three tab-separated fields (`R100  old  new`); we report
+ * the destination path because that is what exists after the operation.
+ */
+export declare function parseNameStatus(output: string): NameStatusEntry[];
+//# sourceMappingURL=git.d.ts.map

package/dist/core/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/core/git.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,GAAG,SAAS,CAkBlE;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAiBtF;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO9C;AAgBD,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAExD;AAED,qBAAa,YAAa,SAAQ,KAAK;IAGnC,QAAQ,CAAC,MAAM,EAAE,SAAS;gBAD1B,SAAS,EAAE,MAAM,EACR,MAAM,EAAE,SAAS;CAQ7B;AAED,qBAAa,QAAS,SAAQ,KAAK;IAG/B,QAAQ,CAAC,MAAM,EAAE,SAAS;gBAD1B,SAAS,EAAE,MAAM,EACR,MAAM,EAAE,SAAS;CAO7B;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,KAAK,CAItE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAY5D;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IACnD,IAAI,EAAE,MAAM,CAAC;CACd;AAWD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAajE"}

package/dist/core/git.js

@@ -0,0 +1,162 @@
+import { execFile, execFileSync } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const NO_PROMPT_ENV = {
+    GIT_TERMINAL_PROMPT: "0",
+    GIT_ASKPASS: "",
+    GCM_INTERACTIVE: "never",
+};
+/**
+ * Run git and never throw.
+ *
+ * Every caller wants to inspect the failure rather than unwind, so the exit
+ * status is returned as data. Terminal prompting is disabled by default: a sync
+ * that silently blocks on a hidden credential prompt is far worse than one that
+ * fails fast with an actionable message.
+ */
+export function git(args, options) {
+    try {
+        const stdout = execFileSync("git", args, {
+            cwd: options.cwd,
+            encoding: "utf8",
+            stdio: "pipe",
+            timeout: options.timeoutMs ?? 0,
+            env: options.interactive ? process.env : { ...process.env, ...NO_PROMPT_ENV },
+        });
+        return { ok: true, stdout: stdout.trim(), stderr: "", code: 0 };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            stdout: String(e.stdout ?? "").trim(),
+            stderr: String(e.stderr ?? e.message ?? "").trim(),
+            code: typeof e.status === "number" ? e.status : null,
+        };
+    }
+}
+export async function gitAsync(args, options) {
+    try {
+        const { stdout, stderr } = await execFileAsync("git", args, {
+            cwd: options.cwd,
+            encoding: "utf8",
+            maxBuffer: 64 * 1024 * 1024,
+            env: options.interactive ? process.env : { ...process.env, ...NO_PROMPT_ENV },
+        });
+        return { ok: true, stdout: stdout.trim(), stderr: stderr.trim(), code: 0 };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            stdout: String(e.stdout ?? "").trim(),
+            stderr: String(e.stderr ?? e.message ?? "").trim(),
+            code: typeof e.code === "number" ? e.code : null,
+        };
+    }
+}
+export function isGitRepo(dir) {
+    return git(["rev-parse", "--is-inside-work-tree"], { cwd: dir }).stdout === "true";
+}
+export function firstLine(text) {
+    return (String(text ?? "")
+        .split("\n")
+        .find((line) => line.trim().length > 0)
+        ?.trim() ?? "");
+}
+const AUTH_FAILURE = new RegExp([
+    "Authentication failed",
+    "could not read Username",
+    "terminal prompts disabled",
+    "Repository not found",
+    "Permission denied",
+    "access denied",
+    "\\b401\\b",
+    "\\b403\\b",
+].join("|"), "i");
+/** True when a git failure is really "your GitHub credentials are not working". */
+export function isAuthFailure(result) {
+    return AUTH_FAILURE.test(`${result.stderr}\n${result.stdout}`);
+}
+export class GitAuthError extends Error {
+    result;
+    constructor(operation, result) {
+        super(`${operation} failed: GitHub credentials are missing or lack access.\n` +
+            `Run: gh auth login -h github.com  (the token needs the "repo" scope for private repositories)`);
+        this.result = result;
+        this.name = "GitAuthError";
+    }
+}
+export class GitError extends Error {
+    result;
+    constructor(operation, result) {
+        super(`${operation} failed: ${firstLine(result.stderr || result.stdout) || "unknown git error"}`);
+        this.result = result;
+        this.name = "GitError";
+    }
+}
+/** Convert a failed `GitResult` into the most specific error we can. */
+export function toGitError(operation, result) {
+    return isAuthFailure(result)
+        ? new GitAuthError(operation, result)
+        : new GitError(operation, result);
+}
+/**
+ * Extract the file paths from `git status --porcelain` output.
+ *
+ * The format is fixed-width — two status columns, a space, then the path — but
+ * this deliberately does not slice at a fixed offset. Output here is trimmed
+ * before parsing, which eats the leading space of an unstaged entry (` M file`)
+ * and shifts every subsequent column. Matching the status field by pattern
+ * instead survives that, as well as the quoting git applies to paths with
+ * unusual characters.
+ *
+ * Renames appear as `old -> new`; the destination is reported, since that is
+ * what exists afterwards.
+ */
+export function parsePorcelainPaths(output) {
+    const paths = [];
+    for (const line of String(output ?? "").split("\n")) {
+        if (!line.trim())
+            continue;
+        const withoutStatus = line.replace(/^\s*[MADRCU?!]{1,2}\s+/, "");
+        if (withoutStatus === line.trim() && !/^\s*[MADRCU?!]/.test(line))
+            continue;
+        const arrow = withoutStatus.lastIndexOf(" -> ");
+        const raw = arrow === -1 ? withoutStatus : withoutStatus.slice(arrow + 4);
+        const unquoted = raw.trim().replace(/^"(.*)"$/, "$1");
+        if (unquoted)
+            paths.push(unquoted);
+    }
+    return paths;
+}
+const STATUS_MAP = {
+    A: "added",
+    M: "modified",
+    D: "deleted",
+    R: "renamed",
+    C: "added",
+    T: "modified",
+};
+/**
+ * Parse `git diff --name-status` output.
+ *
+ * Rename entries carry three tab-separated fields (`R100  old  new`); we report
+ * the destination path because that is what exists after the operation.
+ */
+export function parseNameStatus(output) {
+    const entries = [];
+    for (const line of String(output ?? "").split("\n")) {
+        if (!line.trim())
+            continue;
+        const parts = line.split("\t");
+        const statusChar = (parts[0] ?? "").charAt(0).toUpperCase();
+        const kind = STATUS_MAP[statusChar];
+        if (!kind)
+            continue;
+        const filePath = parts.length > 2 ? parts.slice(2).join("\t").trim() : (parts[1] ?? "").trim();
+        if (!filePath)
+            continue;
+        entries.push({ kind, path: filePath });
+    }
+    return entries;
+}
+//# sourceMappingURL=git.js.map

package/dist/core/git.js.map

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

package/dist/core/guard.d.ts

@@ -0,0 +1,5 @@
+import type { Settings } from "./settings.js";
+export declare function assertPrivateRemote(remote: string, settings: Settings): void;
+export declare function assertSafeTrackedFiles(root: string, settings: Settings): void;
+export declare function createConfigBackup(config: string, data: string): void;
+//# sourceMappingURL=guard.d.ts.map

package/dist/core/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/core/guard.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAmB5E;AACD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAkC7E;AACD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA4CrE"}