@superblocksteam/workspace-sync 0.0.0-stage → 2.0.178-next.0

package/dist/sync-credential-provider.d.ts

@@ -0,0 +1,27 @@
+/** The credential the sync engine's transport authenticates DBFS calls with. */
+export interface SyncCredential {
+    token: string;
+    /** Epoch milliseconds after which the token is no longer accepted. */
+    expiresAt?: number;
+}
+/**
+ * Supplies the current sync credential. The interim implementation is a narrow
+ * server token the edge pushes before expiry; AR-1074 hardens or replaces it.
+ */
+export interface SyncCredentialProvider {
+    /** The latest credential, or undefined before the first one arrives. */
+    current(): SyncCredential | undefined;
+    /** Calls `listener` with each new credential; returns an unsubscribe. */
+    onRefresh(listener: (credential: SyncCredential) => void): () => void;
+}
+/** A provider the host feeds, e.g. from the edge's state snapshots. */
+export declare class PushedSyncCredentialProvider implements SyncCredentialProvider {
+    private credential;
+    private readonly listeners;
+    constructor(initial?: SyncCredential);
+    current(): SyncCredential | undefined;
+    onRefresh(listener: (credential: SyncCredential) => void): () => void;
+    /** Replaces the credential and notifies subscribers. */
+    push(credential: SyncCredential): void;
+}
+//# sourceMappingURL=sync-credential-provider.d.ts.map

package/dist/sync-credential-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-credential-provider.d.ts","sourceRoot":"","sources":["../src/sync-credential-provider.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,OAAO,IAAI,cAAc,GAAG,SAAS,CAAC;IACtC,yEAAyE;IACzE,SAAS,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACvE;AAED,uEAAuE;AACvE,qBAAa,4BAA6B,YAAW,sBAAsB;IACzE,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmD;IAE7E,YAAY,OAAO,CAAC,EAAE,cAAc,EAEnC;IAED,OAAO,IAAI,cAAc,GAAG,SAAS,CAEpC;IAED,SAAS,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAGpE;IAED,wDAAwD;IACxD,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAGrC;CACF"}

package/dist/sync-credential-provider.js

@@ -0,0 +1,22 @@
+/** A provider the host feeds, e.g. from the edge's state snapshots. */
+export class PushedSyncCredentialProvider {
+    credential;
+    listeners = new Set();
+    constructor(initial) {
+        this.credential = initial;
+    }
+    current() {
+        return this.credential;
+    }
+    onRefresh(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /** Replaces the credential and notifies subscribers. */
+    push(credential) {
+        this.credential = credential;
+        for (const listener of this.listeners)
+            listener(credential);
+    }
+}
+//# sourceMappingURL=sync-credential-provider.js.map

package/dist/sync-credential-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-credential-provider.js","sourceRoot":"","sources":["../src/sync-credential-provider.ts"],"names":[],"mappings":"AAkBA,uEAAuE;AACvE,MAAM,OAAO,4BAA4B;IAC/B,UAAU,CAA6B;IAC9B,SAAS,GAAG,IAAI,GAAG,EAAwC,CAAC;IAE7E,YAAY,OAAwB;QAClC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,SAAS,CAAC,QAA8C;QACtD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,wDAAwD;IACxD,IAAI,CAAC,UAA0B;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/sync-engine.d.ts

@@ -0,0 +1,119 @@
+import type { Meter, Tracer } from "@opentelemetry/api";
+import type { ApplicationHashChangeSource } from "@superblocksteam/shared";
+import { type BranchWriteGuard } from "./branch-write-guard.js";
+import type { DbfsTransport } from "./dbfs-transport.js";
+import { HashCache } from "./hash-cache.js";
+import type { NativeDraftJournal } from "./native-draft-session.js";
+import { type DownloadStats } from "./server-tree.js";
+import type { WorkspaceStateStore } from "./workspace-state-store.js";
+/**
+ * Where a test can stop the engine to simulate the VM dying. A hook that
+ * throws aborts the operation at that point, leaving disk, DBFS and the state
+ * store exactly as a kill would.
+ */
+export type FaultPoint = 
+/** A write landed in the tree; nothing has been flushed or committed. */
+"after-write-before-flush"
+/** Blobs are in DBFS; the branch hash has not moved. */
+ | "after-put-before-set"
+/** The branch hash moved; the state store still holds the old hash. */
+ | "after-set-before-state";
+export type FaultPoints = Partial<Record<FaultPoint, () => void | Promise<void>>>;
+export interface WorkspaceSyncEngineOptions {
+    /** The application tree. */
+    root: string;
+    transport: DbfsTransport;
+    state: WorkspaceStateStore;
+    /** The native draft journal, when the host runs native sessions. */
+    journal?: NativeDraftJournal;
+    guard: BranchWriteGuard;
+    tracer?: Tracer;
+    meter?: Meter;
+    faults?: FaultPoints;
+    /** Seeded on rehydrate; a host may share one with other uploaders. */
+    hashCache?: HashCache;
+    /** Whether the tree holds unaccepted drafts. Defaults to its swap files. */
+    hasDraft?: () => Promise<boolean>;
+}
+export interface CommitOptions {
+    /**
+     * Finalize the draft journal before the snapshot (the turn ended). Pass
+     * false for a read-your-writes commit while a native session is still
+     * running; the journal then stays open. Defaults to true.
+     */
+    finalizeJournal?: boolean;
+}
+export interface CommitResult {
+    dbfsHash: string;
+    commitId?: string;
+    /** False when the tree already matched the stored hash. */
+    moved: boolean;
+    /** Paths the journal reconcile found changed, when a journal is active. */
+    journalChangedPaths?: string[];
+}
+export interface FlushResult {
+    /** Hash of the tree whose blobs were uploaded. */
+    hash: string;
+    /** putMany items sent; zero when DBFS already had everything. */
+    uploadedItems: number;
+}
+export type RehydrateKind = "fresh" | "resumed" | "replayed" | "reloaded";
+export interface RehydrateOutcome {
+    outcome: RehydrateKind;
+    /** The hash the state store holds afterwards. */
+    dbfsHash: string;
+    /** True when the local tree was replaced from DBFS. */
+    filesChanged: boolean;
+    /** `reloaded`: where the local diff that lost to the server was kept. */
+    orphanedPath?: string;
+    /**
+     * `replayed`: false when the guard refused the replay commit (typically the
+     * lock is not held yet at boot). The workspace stays unsynced and the next
+     * `commit` replays it.
+     */
+    replayCommitted?: boolean;
+    /** Set when a running journal (a killed native session) was reconciled. */
+    interruptedJournal?: {
+        changedPaths: string[];
+    };
+    /** The files written from DBFS and their bytes; zero when none were. */
+    downloaded: DownloadStats;
+}
+export interface RehydrateOptions {
+    /** Hash-change source for the replay commit. */
+    replaySource?: ApplicationHashChangeSource;
+}
+export interface WorkspaceSyncEvents {
+    committed: {
+        dbfsHash: string;
+        commitId?: string;
+    };
+    "unsynced-changed": {
+        unsynced: boolean;
+    };
+}
+export interface WorkspaceSyncEngine {
+    /** Reconciles the local tree, the stored hash and the server on boot. */
+    rehydrate(options?: RehydrateOptions): Promise<RehydrateOutcome>;
+    /** Uploads blobs for the current tree. Never moves the branch hash. */
+    interimFlush(): Promise<FlushResult>;
+    /** The turn-end commit. */
+    commit(source: ApplicationHashChangeSource, options?: CommitOptions): Promise<CommitResult>;
+    /** True while the tree has changes the branch hash does not include. */
+    readonly unsynced: boolean;
+    /** The hash last committed or loaded, once known. */
+    readonly dbfsHash: string | undefined;
+    /** Cheap write notification for file watchers; no hashing. */
+    markDirty(): void;
+    readonly hashCache: HashCache;
+    on<E extends keyof WorkspaceSyncEvents>(event: E, listener: (payload: WorkspaceSyncEvents[E]) => void): () => void;
+}
+/**
+ * Creates the sync engine for one workspace. DBFS is the commit point: the
+ * engine moves the branch hash only in {@link WorkspaceSyncEngine.commit} (and
+ * the rehydrate replay), and the state store is a cache of the last hash it
+ * committed or loaded. Every operation is serialized, and each step is
+ * ordered so a kill at any point is recovered by `rehydrate`.
+ */
+export declare function createWorkspaceSyncEngine(options: WorkspaceSyncEngineOptions): WorkspaceSyncEngine;
+//# sourceMappingURL=sync-engine.d.ts.map

package/dist/sync-engine.d.ts.map

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

package/dist/sync-engine.js

@@ -0,0 +1,358 @@
+import * as fsp from "node:fs/promises";
+import { BranchWriteRejectedError, } from "./branch-write-guard.js";
+import { hasSwapFiles } from "./draft-helpers.js";
+import { HashCache } from "./hash-cache.js";
+import { hashLocalDirectory } from "./hash-dir-tree.js";
+import { downloadServerTree, flattenTree, readServerTree, } from "./server-tree.js";
+import { snapshotLocalDirectory, snapshotLocalDirectoryWithDrafts, } from "./snapshot/take-snapshot.js";
+import { collectSnapshotUploadItems, uploadSnapshotItems, } from "./snapshot/upload-snapshot.js";
+import { createSyncTelemetry, inSpan, } from "./sync-telemetry.js";
+const BLOB_BATCH = 64;
+const NOTHING_DOWNLOADED = { files: 0, bytes: 0 };
+/**
+ * Creates the sync engine for one workspace. DBFS is the commit point: the
+ * engine moves the branch hash only in {@link WorkspaceSyncEngine.commit} (and
+ * the rehydrate replay), and the state store is a cache of the last hash it
+ * committed or loaded. Every operation is serialized, and each step is
+ * ordered so a kill at any point is recovered by `rehydrate`.
+ */
+export function createWorkspaceSyncEngine(options) {
+    return new SyncEngine(options);
+}
+class SyncEngine {
+    options;
+    hashCache;
+    telemetry;
+    listeners = new Map();
+    queue = Promise.resolve();
+    committedHash;
+    localHash;
+    writes = 0;
+    committedWrites = 0;
+    lastUnsynced = false;
+    reportedDraft;
+    constructor(options) {
+        this.options = options;
+        this.hashCache = options.hashCache ?? new HashCache();
+        this.telemetry = createSyncTelemetry(options.tracer, options.meter);
+        this.telemetry.unsynced.record(0);
+    }
+    get unsynced() {
+        return (this.writes !== this.committedWrites ||
+            (this.localHash !== undefined && this.localHash !== this.committedHash));
+    }
+    get dbfsHash() {
+        return this.committedHash;
+    }
+    markDirty() {
+        this.writes++;
+        this.updateUnsynced();
+    }
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (!set)
+            this.listeners.set(event, (set = new Set()));
+        set.add(listener);
+        return () => set.delete(listener);
+    }
+    interimFlush() {
+        return this.serialize(() => inSpan(this.telemetry.tracer, "workspace.flush", async (span) => {
+            await this.fault("after-write-before-flush");
+            const snapshot = await snapshotLocalDirectoryWithDrafts(this.options.root);
+            const uploadedItems = await this.upload(snapshot);
+            this.localHash = snapshot.hash;
+            this.updateUnsynced();
+            span.setAttribute("workspace.sync.uploaded_items", uploadedItems);
+            return { hash: snapshot.hash, uploadedItems };
+        }));
+    }
+    commit(source, options = {}) {
+        return this.serialize(() => this.commitNow(source, options.finalizeJournal === false ? "keep" : "finalize"));
+    }
+    rehydrate(options = {}) {
+        return this.serialize(() => inSpan(this.telemetry.tracer, "workspace.rehydrate", async (span) => {
+            const outcome = await this.rehydrateNow(options);
+            span.setAttribute("workspace.sync.outcome", outcome.outcome);
+            span.setAttribute("workspace.sync.files_downloaded", outcome.downloaded.files);
+            span.setAttribute("workspace.sync.bytes_downloaded", outcome.downloaded.bytes);
+            this.telemetry.rehydrateOutcome.add(1, { outcome: outcome.outcome });
+            return outcome;
+        }));
+    }
+    async rehydrateNow({ replaySource = "ai:generate:post", }) {
+        const { root, transport, state, journal } = this.options;
+        const serverHash = await transport.getServerHash();
+        const storedHash = (await state.read())?.dbfsHash;
+        const local = await this.hashLocalTree();
+        const writesAtStart = this.writes;
+        let result;
+        if (local === undefined) {
+            const tree = await readServerTree(transport, serverHash);
+            const downloaded = await downloadServerTree({
+                transport,
+                tree,
+                local: undefined,
+                root,
+            });
+            await this.storeLoaded(serverHash, tree);
+            result = {
+                outcome: "fresh",
+                dbfsHash: serverHash,
+                filesChanged: true,
+                downloaded,
+            };
+        }
+        else if (local.hash === serverHash) {
+            this.hashCache.add_directory_recursive(await readServerTree(transport, serverHash));
+            if (storedHash !== serverHash)
+                await state.write({ dbfsHash: serverHash });
+            this.committedHash = serverHash;
+            this.localHash = serverHash;
+            result = {
+                outcome: "resumed",
+                dbfsHash: serverHash,
+                filesChanged: false,
+                downloaded: NOTHING_DOWNLOADED,
+            };
+        }
+        else if (storedHash === serverHash) {
+            // The kill landed after a write and before the commit finished: the
+            // server never moved past this workspace, so the local tree wins.
+            this.hashCache.add_directory_recursive(await readServerTree(transport, serverHash));
+            this.committedHash = serverHash;
+            this.localHash = local.hash;
+            let replayCommitted = true;
+            try {
+                await this.commitNow(replaySource, "skip");
+            }
+            catch (error) {
+                if (!(error instanceof BranchWriteRejectedError) ||
+                    error.reason !== "lock_not_held")
+                    throw error;
+                replayCommitted = false;
+            }
+            result = {
+                outcome: "replayed",
+                dbfsHash: this.committedHash ?? serverHash,
+                filesChanged: false,
+                replayCommitted,
+                downloaded: NOTHING_DOWNLOADED,
+            };
+        }
+        else {
+            // The server moved (or this workspace never recorded a hash): keep the
+            // local difference where an operator or agent can find it, then load
+            // the server tree.
+            const tree = await readServerTree(transport, serverHash);
+            const orphanedPath = await this.keepOrphan(serverHash, storedHash, tree);
+            const downloaded = await downloadServerTree({
+                transport,
+                tree,
+                local,
+                root,
+            });
+            await this.storeLoaded(serverHash, tree);
+            result = {
+                outcome: "reloaded",
+                dbfsHash: serverHash,
+                filesChanged: true,
+                orphanedPath,
+                downloaded,
+            };
+        }
+        if (journal && (await journal.phase()) === "running") {
+            const reconciled = await journal.reconcile(false);
+            if (reconciled) {
+                result.interruptedJournal = { changedPaths: reconciled.changedPaths };
+                if (reconciled.changedPaths.length > 0)
+                    await this.reportDraftState();
+            }
+        }
+        if (result.outcome !== "replayed" || result.replayCommitted)
+            this.committedWrites = writesAtStart;
+        this.updateUnsynced();
+        return result;
+    }
+    async commitNow(source, journalMode) {
+        const { root, transport, state, journal, guard } = this.options;
+        const started = performance.now();
+        let outcome = "error";
+        try {
+            return await inSpan(this.telemetry.tracer, "workspace.commit", async (span) => {
+                span.setAttribute("workspace.sync.source", source);
+                const writesAtStart = this.writes;
+                let journalChangedPaths;
+                if (journal && journalMode !== "skip") {
+                    const reconciled = await journal.reconcile(journalMode === "finalize");
+                    journalChangedPaths = reconciled?.changedPaths;
+                }
+                await this.fault("after-write-before-flush");
+                const snapshot = await snapshotLocalDirectoryWithDrafts(root);
+                const hash = snapshot.hash;
+                this.localHash = hash;
+                const baseHash = (await state.read())?.dbfsHash;
+                if (hash === baseHash) {
+                    this.committedHash = baseHash;
+                    await journal?.retireUploaded(hash);
+                    await this.reportDraftState();
+                    this.committedWrites = writesAtStart;
+                    this.updateUnsynced();
+                    outcome = "unchanged";
+                    span.setAttribute("workspace.sync.outcome", outcome);
+                    return {
+                        dbfsHash: hash,
+                        moved: false,
+                        ...(journalChangedPaths && { journalChangedPaths }),
+                    };
+                }
+                const uploadedItems = await this.upload(snapshot);
+                span.setAttribute("workspace.sync.uploaded_items", uploadedItems);
+                await this.fault("after-put-before-set");
+                try {
+                    await guard.assertCanCommit(baseHash);
+                }
+                catch (error) {
+                    if (error instanceof BranchWriteRejectedError) {
+                        outcome = "rejected";
+                        span.setAttribute("workspace.sync.rejection", error.reason);
+                    }
+                    throw error;
+                }
+                const result = await transport.setHash({ hash, baseHash, source });
+                await this.fault("after-set-before-state");
+                await state.write({ dbfsHash: hash });
+                this.committedHash = hash;
+                await journal?.retireUploaded(hash);
+                await this.reportDraftState();
+                this.committedWrites = writesAtStart;
+                this.updateUnsynced();
+                outcome = "committed";
+                span.setAttribute("workspace.sync.outcome", outcome);
+                this.emit("committed", {
+                    dbfsHash: hash,
+                    ...(result.commitId && { commitId: result.commitId }),
+                });
+                return {
+                    dbfsHash: hash,
+                    moved: true,
+                    ...(result.commitId && { commitId: result.commitId }),
+                    ...(journalChangedPaths && { journalChangedPaths }),
+                };
+            });
+        }
+        finally {
+            this.telemetry.commitDuration.record((performance.now() - started) / 1000, { outcome });
+        }
+    }
+    /** Puts what DBFS lacks for `snapshot`; returns the items sent. */
+    async upload(snapshot) {
+        const { transport } = this.options;
+        const sent = await uploadSnapshotItems({
+            validateMany: (items) => transport.validateMany(items),
+            putMany: async (items) => {
+                await transport.putMany(items);
+            },
+        }, collectSnapshotUploadItems(snapshot, this.hashCache));
+        this.hashCache.add_directory_recursive(snapshot);
+        return sent;
+    }
+    /** The local tree's hashed state, or undefined when it has no synced entries. */
+    async hashLocalTree() {
+        try {
+            await fsp.access(this.options.root);
+        }
+        catch {
+            return undefined;
+        }
+        const local = await hashLocalDirectory(this.options.root);
+        return local.contents.length === 0 ? undefined : local;
+    }
+    async storeLoaded(hash, tree) {
+        await this.options.state.write({ dbfsHash: hash });
+        this.hashCache.add_directory_recursive(tree);
+        this.committedHash = hash;
+        this.localHash = hash;
+    }
+    async keepOrphan(serverHash, storedHash, tree) {
+        const snapshot = await snapshotLocalDirectory(this.options.root);
+        const serverFiles = flattenTree(tree);
+        const localFiles = flattenTree(snapshot);
+        const contents = new Map();
+        const collect = (entries, prefix = "") => {
+            for (const entry of entries) {
+                if (entry.type === "d")
+                    collect(entry.contents, `${prefix}${entry.name}/`);
+                else if (entry.type === "-")
+                    contents.set(entry.hash, entry.contents);
+            }
+        };
+        collect(snapshot.contents);
+        const changed = [];
+        for (const [entryPath, entry] of localFiles) {
+            const server = serverFiles.get(entryPath);
+            const same = server !== undefined &&
+                (entry.type === "l"
+                    ? server.type === "l" && server.target === entry.target
+                    : server.type === "-" &&
+                        server.hash === entry.hash &&
+                        server.executable === entry.executable);
+            if (!same)
+                changed.push({ path: entryPath, ...entry });
+        }
+        const deleted = [...serverFiles.keys()].filter((entryPath) => !localFiles.has(entryPath));
+        const blobs = [];
+        const seen = new Set();
+        for (const entry of changed) {
+            if (entry.type !== "-" || seen.has(entry.hash))
+                continue;
+            seen.add(entry.hash);
+            if (this.hashCache.check_file_content(entry.hash))
+                continue;
+            blobs.push({
+                type: "fileContents",
+                contents: contents.get(entry.hash).toString("base64"),
+            });
+        }
+        for (let idx = 0; idx < blobs.length; idx += BLOB_BATCH)
+            await this.options.transport.putMany(blobs.slice(idx, idx + BLOB_BATCH));
+        for (const hash of seen)
+            this.hashCache.add_file_content(hash);
+        return this.options.state.writeOrphan({
+            createdAt: new Date().toISOString(),
+            serverHash,
+            storedHash,
+            localHash: snapshot.hash,
+            changed,
+            deleted,
+        });
+    }
+    async reportDraftState() {
+        const hasDraft = await (this.options.hasDraft?.() ??
+            hasSwapFiles(this.options.root));
+        if (hasDraft === this.reportedDraft)
+            return;
+        await this.options.transport.setDraftState(hasDraft);
+        this.reportedDraft = hasDraft;
+    }
+    async fault(point) {
+        await this.options.faults?.[point]?.();
+    }
+    updateUnsynced() {
+        const unsynced = this.unsynced;
+        if (unsynced === this.lastUnsynced)
+            return;
+        this.lastUnsynced = unsynced;
+        this.telemetry.unsynced.record(unsynced ? 1 : 0);
+        this.emit("unsynced-changed", { unsynced });
+    }
+    emit(event, payload) {
+        for (const listener of this.listeners.get(event) ?? [])
+            listener(payload);
+    }
+    serialize(run) {
+        const result = this.queue.then(run, run);
+        this.queue = result.catch(() => undefined);
+        return result;
+    }
+}
+//# sourceMappingURL=sync-engine.js.map

package/dist/sync-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.js","sourceRoot":"","sources":["../src/sync-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AAMxC,OAAO,EACL,wBAAwB,GAEzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EACL,kBAAkB,EAElB,WAAW,EACX,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,sBAAsB,EACtB,gCAAgC,GACjC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,0BAA0B,EAE1B,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,mBAAmB,EACnB,MAAM,GACP,MAAM,qBAAqB,CAAC;AAM7B,MAAM,UAAU,GAAG,EAAE,CAAC;AA+DtB,MAAM,kBAAkB,GAAkB,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAuDjE;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAmC;IAEnC,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAID,MAAM,UAAU;IAYe,OAAO;IAX3B,SAAS,CAAY;IACb,SAAS,CAAC;IACV,SAAS,GAAG,IAAI,GAAG,EAAyC,CAAC;IACtE,KAAK,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5C,aAAa,CAAqB;IAClC,SAAS,CAAqB;IAC9B,MAAM,GAAG,CAAC,CAAC;IACX,eAAe,GAAG,CAAC,CAAC;IACpB,YAAY,GAAG,KAAK,CAAC;IACrB,aAAa,CAAsB;IAE3C,YAA6B,OAAmC;uBAAnC,OAAO;QAClC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,SAAS,EAAE,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACpE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,CACL,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,eAAe;YACpC,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,aAAa,CAAC,CACxE,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,SAAS;QACP,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED,EAAE,CACA,KAAQ,EACR,QAAmD;QAEnD,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;QACvD,GAAG,CAAC,GAAG,CAAC,QAAoC,CAAC,CAAC;QAC9C,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,QAAoC,CAAC,CAAC;IAChE,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CACzB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC9D,MAAM,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC7C,MAAM,QAAQ,GAAG,MAAM,gCAAgC,CACrD,IAAI,CAAC,OAAO,CAAC,IAAI,CAClB,CAAC;YACF,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAClD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC;YAC/B,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC,+BAA+B,EAAE,aAAa,CAAC,CAAC;YAClE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC;QAChD,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,CACJ,MAAmC,EACnC,OAAO,GAAkB,EAAE;QAE3B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CACzB,IAAI,CAAC,SAAS,CACZ,MAAM,EACN,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CACxD,CACF,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,OAAO,GAAqB,EAAE;QACtC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CACzB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAClE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACjD,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7D,IAAI,CAAC,YAAY,CACf,iCAAiC,EACjC,OAAO,CAAC,UAAU,CAAC,KAAK,CACzB,CAAC;YACF,IAAI,CAAC,YAAY,CACf,iCAAiC,EACjC,OAAO,CAAC,UAAU,CAAC,KAAK,CACzB,CAAC;YACF,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YACrE,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,EACzB,YAAY,GAAG,kBAAkB,GAChB;QACjB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACzD,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,aAAa,EAAE,CAAC;QACnD,MAAM,UAAU,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;QAClC,IAAI,MAAwB,CAAC;QAE7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACzD,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC;gBAC1C,SAAS;gBACT,IAAI;gBACJ,KAAK,EAAE,SAAS;gBAChB,IAAI;aACL,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACzC,MAAM,GAAG;gBACP,OAAO,EAAE,OAAO;gBAChB,QAAQ,EAAE,UAAU;gBACpB,YAAY,EAAE,IAAI;gBAClB,UAAU;aACX,CAAC;QACJ,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACrC,IAAI,CAAC,SAAS,CAAC,uBAAuB,CACpC,MAAM,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,CAC5C,CAAC;YACF,IAAI,UAAU,KAAK,UAAU;gBAC3B,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC;YAChC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC;YAC5B,MAAM,GAAG;gBACP,OAAO,EAAE,SAAS;gBAClB,QAAQ,EAAE,UAAU;gBACpB,YAAY,EAAE,KAAK;gBACnB,UAAU,EAAE,kBAAkB;aAC/B,CAAC;QACJ,CAAC;aAAM,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YACrC,oEAAoE;YACpE,kEAAkE;YAClE,IAAI,CAAC,SAAS,CAAC,uBAAuB,CACpC,MAAM,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,CAC5C,CAAC;YACF,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC;YAChC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;YAC5B,IAAI,eAAe,GAAG,IAAI,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IACE,CAAC,CAAC,KAAK,YAAY,wBAAwB,CAAC;oBAC5C,KAAK,CAAC,MAAM,KAAK,eAAe;oBAEhC,MAAM,KAAK,CAAC;gBACd,eAAe,GAAG,KAAK,CAAC;YAC1B,CAAC;YACD,MAAM,GAAG;gBACP,OAAO,EAAE,UAAU;gBACnB,QAAQ,EAAE,IAAI,CAAC,aAAa,IAAI,UAAU;gBAC1C,YAAY,EAAE,KAAK;gBACnB,eAAe;gBACf,UAAU,EAAE,kBAAkB;aAC/B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,uEAAuE;YACvE,qEAAqE;YACrE,mBAAmB;YACnB,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACzD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;YACzE,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC;gBAC1C,SAAS;gBACT,IAAI;gBACJ,KAAK;gBACL,IAAI;aACL,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACzC,MAAM,GAAG;gBACP,OAAO,EAAE,UAAU;gBACnB,QAAQ,EAAE,UAAU;gBACpB,YAAY,EAAE,IAAI;gBAClB,YAAY;gBACZ,UAAU;aACX,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,IAAI,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;YACrD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAClD,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,CAAC,kBAAkB,GAAG,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,EAAE,CAAC;gBACtE,IAAI,UAAU,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;oBAAE,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxE,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,KAAK,UAAU,IAAI,MAAM,CAAC,eAAe;YACzD,IAAI,CAAC,eAAe,GAAG,aAAa,CAAC;QACvC,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,MAAmC,EACnC,WAAwB;QAExB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAChE,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,IAAI,OAAO,GAAkB,OAAO,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,CACjB,IAAI,CAAC,SAAS,CAAC,MAAM,EACrB,kBAAkB,EAClB,KAAK,EAAE,IAAI,EAAE,EAAE;gBACb,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;gBACnD,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;gBAClC,IAAI,mBAAyC,CAAC;gBAC9C,IAAI,OAAO,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;oBACtC,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,SAAS,CACxC,WAAW,KAAK,UAAU,CAC3B,CAAC;oBACF,mBAAmB,GAAG,UAAU,EAAE,YAAY,CAAC;gBACjD,CAAC;gBACD,MAAM,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;gBAC7C,MAAM,QAAQ,GAAG,MAAM,gCAAgC,CAAC,IAAI,CAAC,CAAC;gBAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;gBAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,MAAM,QAAQ,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC;gBAEhD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACtB,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;oBAC9B,MAAM,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;oBACpC,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBAC9B,IAAI,CAAC,eAAe,GAAG,aAAa,CAAC;oBACrC,IAAI,CAAC,cAAc,EAAE,CAAC;oBACtB,OAAO,GAAG,WAAW,CAAC;oBACtB,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;oBACrD,OAAO;wBACL,QAAQ,EAAE,IAAI;wBACd,KAAK,EAAE,KAAK;wBACZ,GAAG,CAAC,mBAAmB,IAAI,EAAE,mBAAmB,EAAE,CAAC;qBACpD,CAAC;gBACJ,CAAC;gBAED,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAClD,IAAI,CAAC,YAAY,CAAC,+BAA+B,EAAE,aAAa,CAAC,CAAC;gBAClE,MAAM,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;gBACzC,IAAI,CAAC;oBACH,MAAM,KAAK,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;gBACxC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,KAAK,YAAY,wBAAwB,EAAE,CAAC;wBAC9C,OAAO,GAAG,UAAU,CAAC;wBACrB,IAAI,CAAC,YAAY,CAAC,0BAA0B,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;oBAC9D,CAAC;oBACD,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;gBACnE,MAAM,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;gBAC3C,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;gBAC1B,MAAM,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;gBACpC,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC9B,IAAI,CAAC,eAAe,GAAG,aAAa,CAAC;gBACrC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,OAAO,GAAG,WAAW,CAAC;gBACtB,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;gBACrD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;oBACrB,QAAQ,EAAE,IAAI;oBACd,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;iBACtD,CAAC,CAAC;gBACH,OAAO;oBACL,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE,IAAI;oBACX,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACrD,GAAG,CAAC,mBAAmB,IAAI,EAAE,mBAAmB,EAAE,CAAC;iBACpD,CAAC;YACJ,CAAC,CACF,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAClC,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,EACpC,EAAE,OAAO,EAAE,CACZ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,mEAAmE;IAC3D,KAAK,CAAC,MAAM,CAAC,QAA2B;QAC9C,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,mBAAmB,CACpC;YACE,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC;YACtD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvB,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;SACF,EACD,0BAA0B,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CACrD,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iFAAiF;IACzE,KAAK,CAAC,aAAa;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1D,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IACzD,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,IAAoB;QAC1D,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,UAAkB,EAClB,UAA8B,EAC9B,IAAoB;QAEpB,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC3C,MAAM,OAAO,GAAG,CAAC,OAAsC,EAAE,MAAM,GAAG,EAAE,EAAE,EAAE;YACtE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG;oBACpB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,MAAM,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;qBAChD,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG;oBAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACxE,CAAC;QACH,CAAC,CAAC;QACF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE3B,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,IAAI,GACR,MAAM,KAAK,SAAS;gBACpB,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG;oBACjB,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;oBACvD,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG;wBACnB,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;wBAC1B,MAAM,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,CAAC,CAAC;YAC9C,IAAI,CAAC,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAC5C,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAC1C,CAAC;QAEF,MAAM,KAAK,GAAiB,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YACzD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrB,IAAI,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC5D,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;aACvD,CAAC,CAAC;QACL,CAAC;QACD,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,UAAU;YACrD,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC;QAC3E,KAAK,MAAM,IAAI,IAAI,IAAI;YAAE,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAE/D,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;YACpC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,UAAU;YACV,UAAU;YACV,SAAS,EAAE,QAAQ,CAAC,IAAI;YACxB,OAAO;YACP,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,gBAAgB;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE;YAC/C,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,IAAI,QAAQ,KAAK,IAAI,CAAC,aAAa;YAAE,OAAO;QAC5C,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;IAChC,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,KAAiB;QACnC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IACzC,CAAC;IAEO,cAAc;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,QAAQ,KAAK,IAAI,CAAC,YAAY;YAAE,OAAO;QAC3C,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC7B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9C,CAAC;IAEO,IAAI,CACV,KAAQ,EACR,OAA+B;QAE/B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;YACnD,QAAsD,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;IAEO,SAAS,CAAI,GAAqB;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/sync-paths.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Path rules that decide what the DBFS sync uploads. Moved here from
+ * `vite-plugin-file-sync/src/file-system-helpers.ts`, which re-exports them.
+ */
+/**
+ * App-root names that hold private configuration (credentials, registry
+ * tokens, package-manager hooks). The native sandbox denies the agent access
+ * to them. Matched case-insensitively.
+ */
+export declare const PRIVATE_CONFIG_NAMES: readonly string[];
+export declare const PRIVATE_CONFIG_PREFIXES: readonly string[];
+export declare function isPrivateConfigName(name: string): boolean;
+/**
+ * Names no upload snapshot includes. `pnpm-workspace.yaml` is read-only to
+ * native tools but still persisted, because it holds the app's pnpm overrides.
+ */
+export declare function isSnapshotExcludedName(name: string): boolean;
+/** Native system skills are generated per pod and never synced. */
+export declare const NATIVE_SYSTEM_SKILLS_ROOT = "skills/system";
+export declare const CHECKLIST_PERSISTED_RELATIVE_PATH = ".superblocks/ai/checklist.json";
+/**
+ * Sentinel written at the end of the CLI-side brownfield migration that
+ * strips public-host `resolved` URLs from `package-lock.json` and repopulates
+ * them via `npm install` against the active private registry. Lives under
+ * `.superblocks/` (otherwise excluded from sync) but is explicitly persisted
+ * so the migration survives across pod cycles. Path is stable because both
+ * the CLI (writer) and the sync allowlist (reader) need to agree.
+ */
+export declare const PRIVATE_REGISTRY_MIGRATION_SENTINEL_RELATIVE_PATH = ".superblocks/private-registry-migrated";
+/**
+ * What the CLI's npm-to-pnpm app migration keeps so it can turn a converted
+ * app back into an npm app once pnpm is off for its org: the npm lockfile it
+ * replaced and what it changed. Persisted like the sentinel above, because the
+ * rollback happens on a later pod.
+ */
+export declare const NPM_TO_PNPM_STATE_RELATIVE_PATH = ".superblocks/npm-to-pnpm.json";
+/** The template ranges whose upgrade failed, so later pods don't retry them. */
+export declare const TEMPLATE_DEPENDENCIES_STATE_RELATIVE_PATH = ".superblocks/template-dependencies.json";
+export declare const codeModeExcludedFiles: string[];
+/**
+ * Suffix of the incremental build-info cache files TypeScript writes in build
+ * mode (`tsc -b`). The prefix varies per project (e.g. `tsconfig.tsbuildinfo`,
+ * `tsconfig.client.tsbuildinfo`), so exclusion must be suffix-based rather than
+ * exact-name based.
+ */
+export declare const TSBUILDINFO_FILE_SUFFIX = ".tsbuildinfo";
+/**
+ * Whether a file (by basename) should be excluded from the dbfs sync. Covers
+ * the enumerated `codeModeExcludedFiles` plus any `*.tsbuildinfo` build cache
+ * emitted by `tsc -b`.
+ */
+export declare function isCodeModeExcludedFile(name: string): boolean;
+/**
+ * Allowlist for files that live under `.superblocks/` but must still round-
+ * trip through DBFS sync. The directory is otherwise excluded from upload
+ * (see `listLocalDirectory`); anything that needs to persist across pod
+ * cycles has to be enumerated here.
+ */
+export declare function isPersistedSuperblocksFile(relativePath: string): boolean;
+export declare function isPersistedChecklistPathOrAncestor(relativePath: string): boolean;
+//# sourceMappingURL=sync-paths.d.ts.map

package/dist/sync-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-paths.d.ts","sourceRoot":"","sources":["../src/sync-paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAkBjD,CAAC;AACF,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAAyB,CAAC;AAE/E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMzD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,mEAAmE;AACnE,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAEzD,eAAO,MAAM,iCAAiC,mCACZ,CAAC;AAGnC;;;;;;;GAOG;AACH,eAAO,MAAM,iDAAiD,2CACpB,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,kCAAkC,CAAC;AAE/E,gFAAgF;AAChF,eAAO,MAAM,yCAAyC,4CACX,CAAC;AAE5C,eAAO,MAAM,qBAAqB,UAAqB,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK5D;AAUD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAOxE;AASD,wBAAgB,kCAAkC,CAChD,YAAY,EAAE,MAAM,GACnB,OAAO,CAKT"}