anchordb 0.2.0

package/dist/cjs/inspector/client.d.ts

@@ -0,0 +1,111 @@
+import { type AuthenticateResult, type BulkWriteSummary, type CollectionSummary, type ConflictRecord, type ConnectResult, type DocumentPage, type InspectorCapability, type InspectorError, type InspectorEventName, type InspectorMethod, type InspectorStats, type InspectorTransport } from "./protocol.js";
+/**
+ * The client half of the protocol — what Anchor Lens talks through.
+ *
+ * Lives in `anchordb` rather than in Lens so both ends are compiled from one definition of the
+ * protocol. A Lens built against a mismatched copy would fail in ways neither side could explain.
+ */
+export declare class InspectorClientError extends Error {
+    readonly code: InspectorError["code"];
+    readonly details: Record<string, unknown> | undefined;
+    constructor(error: InspectorError);
+}
+export interface InspectorClientOptions {
+    transport: InspectorTransport;
+    /** How long to wait for a response before failing the call. */
+    timeoutMs?: number;
+    clientName?: string;
+}
+export declare class InspectorClient {
+    private readonly transport;
+    private readonly timeoutMs;
+    private readonly clientName;
+    private readonly pending;
+    private readonly listeners;
+    private detach;
+    private sessionToken;
+    private capabilitiesValue;
+    private connectionValue;
+    constructor(options: InspectorClientOptions);
+    get connection(): ConnectResult | null;
+    get capabilities(): InspectorCapability[];
+    /** Lens greys out features the agent does not advertise rather than failing on use. */
+    can(capability: InspectorCapability): boolean;
+    call<T = unknown>(method: InspectorMethod, params?: Record<string, unknown>): Promise<T>;
+    connect(): Promise<ConnectResult>;
+    /**
+     * Complete pairing.
+     *
+     * The pairing code is never transmitted — only an HMAC proof over the agent's challenge — so a
+     * captured frame cannot be replayed to pair a second client.
+     */
+    authenticate(pairingCode: string, challenge: string): Promise<AuthenticateResult>;
+    on(event: InspectorEventName, listener: (payload: unknown) => void): () => void;
+    getDatabases(): Promise<{
+        name: string;
+        syncEnabled: boolean;
+    }[]>;
+    getCollections(): Promise<CollectionSummary[]>;
+    getStats(): Promise<InspectorStats>;
+    getIndexes(collection: string): Promise<unknown[]>;
+    getDocuments(params: {
+        collection: string;
+        filter?: Record<string, unknown>;
+        sort?: unknown;
+        skip?: number;
+        limit?: number;
+    }): Promise<DocumentPage>;
+    getDocument(collection: string, documentId: string): Promise<Record<string, unknown>>;
+    /** How many documents match — what a bulk dialog shows before you confirm it. */
+    countDocuments(collection: string, filter?: Record<string, unknown>): Promise<number>;
+    insertDocument(collection: string, document: Record<string, unknown>): Promise<Record<string, unknown>>;
+    updateDocument(collection: string, documentId: string, update: Record<string, unknown>): Promise<Record<string, unknown>>;
+    deleteDocument(collection: string, documentId: string): Promise<{
+        deletedCount: number;
+    }>;
+    /**
+     * Update every document matching `filter` (Compass's bulk "Update").
+     *
+     * `update` must use operators — `{ $set: { status: "active" } }`. Pass `all: true` only to
+     * confirm an intentionally empty filter, which means every document in the collection.
+     *
+     * Requires the `documents:bulk` capability; check `can("documents:bulk")` first, since an app
+     * running core &lt; 0.2.0 does not implement it.
+     */
+    updateMany(collection: string, filter: Record<string, unknown>, update: Record<string, unknown>, options?: {
+        all?: boolean;
+    }): Promise<BulkWriteSummary>;
+    /** Delete every document matching `filter` (Compass's bulk "Delete"). See {@link updateMany}. */
+    deleteMany(collection: string, filter: Record<string, unknown>, options?: {
+        all?: boolean;
+    }): Promise<BulkWriteSummary>;
+    aggregate(collection: string, pipeline: unknown[]): Promise<unknown[]>;
+    explain(collection: string, pipeline: unknown[]): Promise<unknown>;
+    getSyncStatus(): Promise<Record<string, unknown>>;
+    getMutations(): Promise<Record<string, unknown>[]>;
+    retryMutation(mutationId: string): Promise<{
+        retried: boolean;
+    }>;
+    triggerSync(): Promise<unknown>;
+    getConflicts(): Promise<ConflictRecord[]>;
+    resolveConflict(conflictId: string, document: Record<string, unknown>): Promise<unknown>;
+    exportCollection(collection: string, options?: Record<string, unknown>): Promise<{
+        data: string;
+        count: number;
+        format: string;
+    }>;
+    importCollection(collection: string, data: string, options?: Record<string, unknown>): Promise<{
+        collection: string;
+        inserted: number;
+        updated: number;
+        skipped: number;
+    }>;
+    subscribe(): Promise<{
+        subscribed: boolean;
+    }>;
+    unsubscribe(): Promise<{
+        subscribed: boolean;
+    }>;
+    close(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/cjs/inspector/client.d.ts.map

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

package/dist/cjs/inspector/client.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InspectorClient = exports.InspectorClientError = void 0;
+const uuid_ts_1 = require("../core/uuid.js");
+const auth_ts_1 = require("./auth.js");
+const protocol_ts_1 = require("./protocol.js");
+/**
+ * The client half of the protocol — what Anchor Lens talks through.
+ *
+ * Lives in `anchordb` rather than in Lens so both ends are compiled from one definition of the
+ * protocol. A Lens built against a mismatched copy would fail in ways neither side could explain.
+ */
+class InspectorClientError extends Error {
+    constructor(error) {
+        super(error.message);
+        this.name = "InspectorClientError";
+        this.code = error.code;
+        this.details = error.details;
+    }
+}
+exports.InspectorClientError = InspectorClientError;
+class InspectorClient {
+    constructor(options) {
+        this.pending = new Map();
+        this.listeners = new Map();
+        this.sessionToken = null;
+        this.capabilitiesValue = [];
+        this.connectionValue = null;
+        this.transport = options.transport;
+        this.timeoutMs = options.timeoutMs ?? 15_000;
+        this.clientName = options.clientName ?? "Anchor Lens";
+        this.detach = this.transport.onMessage((message) => {
+            if ((0, protocol_ts_1.isResponse)(message)) {
+                const entry = this.pending.get(message.id);
+                if (!entry)
+                    return;
+                clearTimeout(entry.timer);
+                this.pending.delete(message.id);
+                if (message.error)
+                    entry.reject(new InspectorClientError(message.error));
+                else
+                    entry.resolve(message.result);
+                return;
+            }
+            if ((0, protocol_ts_1.isEvent)(message)) {
+                for (const listener of this.listeners.get(message.event) ?? [])
+                    listener(message.payload);
+            }
+        });
+    }
+    get connection() {
+        return this.connectionValue;
+    }
+    get capabilities() {
+        return this.capabilitiesValue;
+    }
+    /** Lens greys out features the agent does not advertise rather than failing on use. */
+    can(capability) {
+        return this.capabilitiesValue.includes(capability);
+    }
+    async call(method, params = {}) {
+        const id = (0, uuid_ts_1.uuidv7)();
+        const withSession = this.sessionToken ? { ...params, sessionToken: this.sessionToken } : params;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`Inspector call "${method}" timed out after ${this.timeoutMs}ms`));
+            }, this.timeoutMs);
+            this.pending.set(id, { resolve: resolve, reject, timer });
+            void this.transport.send((0, protocol_ts_1.makeRequest)(id, method, withSession));
+        });
+    }
+    async connect() {
+        const result = await this.call("connect");
+        if (result.protocolVersion !== protocol_ts_1.INSPECTOR_PROTOCOL_VERSION) {
+            // Reported rather than thrown: an older agent is still usable for the methods it has, and
+            // refusing outright would make Lens useless against any app that had not upgraded.
+            // eslint-disable-next-line no-console
+            console.warn(`[anchor/lens] agent speaks protocol v${result.protocolVersion}, this client speaks ` +
+                `v${protocol_ts_1.INSPECTOR_PROTOCOL_VERSION}. Features outside the shared capability set are unavailable.`);
+        }
+        this.connectionValue = result;
+        this.capabilitiesValue = result.capabilities;
+        return result;
+    }
+    /**
+     * Complete pairing.
+     *
+     * The pairing code is never transmitted — only an HMAC proof over the agent's challenge — so a
+     * captured frame cannot be replayed to pair a second client.
+     */
+    async authenticate(pairingCode, challenge) {
+        const proof = auth_ts_1.InspectorAuth.proofFor(pairingCode, challenge);
+        const result = await this.call("authenticate", {
+            proof,
+            clientName: this.clientName,
+        });
+        this.sessionToken = result.sessionToken;
+        this.capabilitiesValue = result.capabilities;
+        return result;
+    }
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(listener);
+        return () => set.delete(listener);
+    }
+    // ---- typed convenience wrappers ------------------------------------------
+    getDatabases() {
+        return this.call("getDatabases");
+    }
+    getCollections() {
+        return this.call("getCollections");
+    }
+    getStats() {
+        return this.call("getStats");
+    }
+    getIndexes(collection) {
+        return this.call("getIndexes", { collection });
+    }
+    getDocuments(params) {
+        return this.call("getDocuments", params);
+    }
+    getDocument(collection, documentId) {
+        return this.call("getDocument", { collection, documentId });
+    }
+    /** How many documents match — what a bulk dialog shows before you confirm it. */
+    countDocuments(collection, filter = {}) {
+        return this.call("countDocuments", { collection, filter });
+    }
+    insertDocument(collection, document) {
+        return this.call("insertDocument", { collection, document });
+    }
+    updateDocument(collection, documentId, update) {
+        return this.call("updateDocument", { collection, documentId, update });
+    }
+    deleteDocument(collection, documentId) {
+        return this.call("deleteDocument", { collection, documentId });
+    }
+    /**
+     * Update every document matching `filter` (Compass's bulk "Update").
+     *
+     * `update` must use operators — `{ $set: { status: "active" } }`. Pass `all: true` only to
+     * confirm an intentionally empty filter, which means every document in the collection.
+     *
+     * Requires the `documents:bulk` capability; check `can("documents:bulk")` first, since an app
+     * running core < 0.2.0 does not implement it.
+     */
+    updateMany(collection, filter, update, options = {}) {
+        return this.call("updateMany", {
+            collection,
+            filter,
+            update,
+            all: options.all === true,
+        });
+    }
+    /** Delete every document matching `filter` (Compass's bulk "Delete"). See {@link updateMany}. */
+    deleteMany(collection, filter, options = {}) {
+        return this.call("deleteMany", {
+            collection,
+            filter,
+            all: options.all === true,
+        });
+    }
+    aggregate(collection, pipeline) {
+        return this.call("aggregate", { collection, pipeline });
+    }
+    explain(collection, pipeline) {
+        return this.call("explain", { collection, pipeline });
+    }
+    getSyncStatus() {
+        return this.call("getSyncStatus");
+    }
+    getMutations() {
+        return this.call("getMutations");
+    }
+    retryMutation(mutationId) {
+        return this.call("retryMutation", { mutationId });
+    }
+    triggerSync() {
+        return this.call("triggerSync");
+    }
+    getConflicts() {
+        return this.call("getConflicts");
+    }
+    resolveConflict(conflictId, document) {
+        return this.call("resolveConflict", { conflictId, document });
+    }
+    exportCollection(collection, options = {}) {
+        return this.call("exportCollection", {
+            collection,
+            options,
+        });
+    }
+    importCollection(collection, data, options = {}) {
+        return this.call("importCollection", { collection, data, options });
+    }
+    subscribe() {
+        return this.call("subscribeToChanges");
+    }
+    unsubscribe() {
+        return this.call("unsubscribeFromChanges");
+    }
+    close() {
+        for (const { timer, reject } of this.pending.values()) {
+            clearTimeout(timer);
+            reject(new Error("Inspector connection closed"));
+        }
+        this.pending.clear();
+        this.detach();
+        void this.transport.close();
+    }
+}
+exports.InspectorClient = InspectorClient;
+//# sourceMappingURL=client.js.map

package/dist/cjs/inspector/client.js.map

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

package/dist/cjs/inspector/protocol.d.ts

@@ -0,0 +1,160 @@
+/**
+ * The Anchor Inspector Protocol, version 1.
+ *
+ * A small request/response + server-push protocol between an AnchorDB instance (the *agent*) and
+ * Anchor Lens (the *client*).
+ *
+ * Two design rules shape it:
+ *
+ *  - **Versioned with capability negotiation.** `connect` returns the agent's protocol version and
+ *    a capability list. A newer agent can add methods without breaking an older Lens, and an older
+ *    agent tells a newer Lens what it cannot do instead of failing mysteriously mid-session.
+ *  - **Everything goes through AnchorDB's public API.** There is no method here that reaches into
+ *    storage directly. A Lens edit must be indistinguishable from an app edit — same validation,
+ *    same timestamps, same mutation queue — or the tool would lie about the database it inspects.
+ */
+export declare const INSPECTOR_PROTOCOL_VERSION = 1;
+export type InspectorMethod = "connect" | "authenticate" | "getDatabases" | "getCollections" | "getStats" | "getIndexes" | "getDocuments" | "getDocument" | "insertDocument" | "updateDocument" | "deleteDocument" | "countDocuments" | "updateMany" | "deleteMany" | "aggregate" | "explain" | "getSyncStatus" | "getMutations" | "retryMutation" | "triggerSync" | "getConflicts" | "resolveConflict" | "exportCollection" | "importCollection" | "subscribeToChanges" | "unsubscribeFromChanges";
+/** Capabilities an agent may advertise. Lens greys out what is absent rather than erroring. */
+export type InspectorCapability = "documents:read" | "documents:write"
+/**
+ * Bulk writes (`updateMany` / `deleteMany`).
+ *
+ * Separate from `documents:write` on purpose. An agent running an older core does not advertise
+ * it, so a newer Lens hides the Update and Delete buttons instead of offering them and failing
+ * with `unsupported_method` — which is the whole point of negotiating capabilities rather than
+ * assuming a version.
+ */
+ | "documents:bulk" | "indexes:read" | "indexes:write" | "sync:read" | "sync:write" | "conflicts:read" | "conflicts:write" | "aggregate" | "export" | "import" | "subscribe";
+export interface InspectorRequest {
+    v: number;
+    id: string;
+    type: "req";
+    method: InspectorMethod;
+    params?: Record<string, unknown>;
+}
+export interface InspectorResponse {
+    v: number;
+    id: string;
+    type: "res";
+    result?: unknown;
+    error?: InspectorError;
+}
+export interface InspectorEvent {
+    v: number;
+    type: "evt";
+    event: InspectorEventName;
+    payload: unknown;
+}
+export type InspectorMessage = InspectorRequest | InspectorResponse | InspectorEvent;
+export type InspectorEventName = "documentInserted" | "documentUpdated" | "documentDeleted" | "collectionChanged" | "syncStarted" | "syncCompleted" | "syncError" | "conflictDetected" | "queueChanged";
+export interface InspectorError {
+    code: InspectorErrorCode;
+    message: string;
+    /** Present for validation failures so Lens can highlight the offending field. */
+    details?: Record<string, unknown>;
+}
+export type InspectorErrorCode = "unauthenticated" | "unauthorized" | "bad_request" | "not_found" | "unsupported_method" | "protocol_version" | "validation_failed" | "duplicate_key" | "internal";
+export interface ConnectResult {
+    protocolVersion: number;
+    capabilities: InspectorCapability[];
+    /** Shown in Lens's environment banner (§46) so a dev database is never mistaken for production. */
+    environment: {
+        databaseName: string;
+        platform: string;
+        anchorVersion: string;
+        nodeEnv: string;
+        syncEnabled: boolean;
+        readOnly: boolean;
+    };
+    /** True when the agent still requires `authenticate` before serving anything else. */
+    requiresAuth: boolean;
+}
+export interface AuthenticateParams {
+    /** Short-lived pairing code shown as a QR / typed by the developer. */
+    pairingCode?: string;
+    /** HMAC of the server challenge, proving possession without sending the code as a bearer token. */
+    proof?: string;
+    clientName?: string;
+}
+export interface AuthenticateResult {
+    sessionToken: string;
+    expiresAt: string;
+    capabilities: InspectorCapability[];
+}
+export interface DocumentPage {
+    collection: string;
+    documents: Array<Record<string, unknown>>;
+    total: number;
+    skip: number;
+    limit: number;
+    /** Never unbounded — §34 requires paging. */
+    hasMore: boolean;
+}
+/**
+ * The outcome of a bulk write, in the shape Mongo reports it.
+ *
+ * `matchedCount` and `modifiedCount` differ when an update sets a field to the value it already
+ * holds. Showing both is what stops "0 modified" reading as a failure when it is really a no-op.
+ */
+export interface BulkWriteSummary {
+    collection: string;
+    matchedCount: number;
+    modifiedCount: number;
+    deletedCount: number;
+}
+export interface CollectionSummary {
+    name: string;
+    modelName?: string;
+    count: number;
+    indexes: number;
+    hasSchema: boolean;
+}
+export interface InspectorStats {
+    database: string;
+    collections: number;
+    documents: number;
+    indexes: number;
+    tombstones: number;
+    sizeBytes?: number;
+    pendingMutations: number;
+    failedMutations: number;
+    syncEnabled: boolean;
+    lastSyncAt?: string;
+}
+export interface ConflictRecord {
+    id: string;
+    collection: string;
+    documentId: string;
+    strategy: string;
+    winner: "local" | "remote" | "merged";
+    base?: Record<string, unknown>;
+    local: Record<string, unknown>;
+    remote: Record<string, unknown>;
+    resolved: Record<string, unknown>;
+    /** Per-field breakdown for the Lens conflict table (§40). */
+    fields: Array<{
+        path: string;
+        local: unknown;
+        remote: unknown;
+        result: unknown;
+        source: string;
+    }>;
+    at: string;
+}
+/** Both ends of a transport speak this. Implementations differ; the protocol does not. */
+export interface InspectorTransport {
+    readonly name: string;
+    send(message: InspectorMessage): void | Promise<void>;
+    onMessage(handler: (message: InspectorMessage) => void): () => void;
+    close(): void | Promise<void>;
+    readonly isOpen: boolean;
+}
+export declare function makeRequest(id: string, method: InspectorMethod, params?: Record<string, unknown>): InspectorRequest;
+export declare function makeResponse(id: string, result: unknown): InspectorResponse;
+export declare function makeError(id: string, code: InspectorErrorCode, message: string, details?: Record<string, unknown>): InspectorResponse;
+export declare function makeEvent(event: InspectorEventName, payload: unknown): InspectorEvent;
+export declare function isRequest(m: InspectorMessage): m is InspectorRequest;
+export declare function isResponse(m: InspectorMessage): m is InspectorResponse;
+export declare function isEvent(m: InspectorMessage): m is InspectorEvent;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/cjs/inspector/protocol.d.ts.map

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

package/dist/cjs/inspector/protocol.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * The Anchor Inspector Protocol, version 1.
+ *
+ * A small request/response + server-push protocol between an AnchorDB instance (the *agent*) and
+ * Anchor Lens (the *client*).
+ *
+ * Two design rules shape it:
+ *
+ *  - **Versioned with capability negotiation.** `connect` returns the agent's protocol version and
+ *    a capability list. A newer agent can add methods without breaking an older Lens, and an older
+ *    agent tells a newer Lens what it cannot do instead of failing mysteriously mid-session.
+ *  - **Everything goes through AnchorDB's public API.** There is no method here that reaches into
+ *    storage directly. A Lens edit must be indistinguishable from an app edit — same validation,
+ *    same timestamps, same mutation queue — or the tool would lie about the database it inspects.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INSPECTOR_PROTOCOL_VERSION = void 0;
+exports.makeRequest = makeRequest;
+exports.makeResponse = makeResponse;
+exports.makeError = makeError;
+exports.makeEvent = makeEvent;
+exports.isRequest = isRequest;
+exports.isResponse = isResponse;
+exports.isEvent = isEvent;
+exports.INSPECTOR_PROTOCOL_VERSION = 1;
+function makeRequest(id, method, params) {
+    return { v: exports.INSPECTOR_PROTOCOL_VERSION, id, type: "req", method, ...(params ? { params } : {}) };
+}
+function makeResponse(id, result) {
+    return { v: exports.INSPECTOR_PROTOCOL_VERSION, id, type: "res", result };
+}
+function makeError(id, code, message, details) {
+    return {
+        v: exports.INSPECTOR_PROTOCOL_VERSION,
+        id,
+        type: "res",
+        error: { code, message, ...(details ? { details } : {}) },
+    };
+}
+function makeEvent(event, payload) {
+    return { v: exports.INSPECTOR_PROTOCOL_VERSION, type: "evt", event, payload };
+}
+function isRequest(m) {
+    return m.type === "req";
+}
+function isResponse(m) {
+    return m.type === "res";
+}
+function isEvent(m) {
+    return m.type === "evt";
+}
+//# sourceMappingURL=protocol.js.map

package/dist/cjs/inspector/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/inspector/protocol.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAwNH,kCAEC;AAED,oCAEC;AAED,8BAOC;AAED,8BAEC;AAED,8BAEC;AACD,gCAEC;AACD,0BAEC;AAnPY,QAAA,0BAA0B,GAAG,CAAC,CAAC;AAsN5C,SAAgB,WAAW,CAAC,EAAU,EAAE,MAAuB,EAAE,MAAgC;IAC/F,OAAO,EAAE,CAAC,EAAE,kCAA0B,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACnG,CAAC;AAED,SAAgB,YAAY,CAAC,EAAU,EAAE,MAAe;IACtD,OAAO,EAAE,CAAC,EAAE,kCAA0B,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACpE,CAAC;AAED,SAAgB,SAAS,CAAC,EAAU,EAAE,IAAwB,EAAE,OAAe,EAAE,OAAiC;IAChH,OAAO;QACL,CAAC,EAAE,kCAA0B;QAC7B,EAAE;QACF,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;KAC1D,CAAC;AACJ,CAAC;AAED,SAAgB,SAAS,CAAC,KAAyB,EAAE,OAAgB;IACnE,OAAO,EAAE,CAAC,EAAE,kCAA0B,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACxE,CAAC;AAED,SAAgB,SAAS,CAAC,CAAmB;IAC3C,OAAO,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC;AAC1B,CAAC;AACD,SAAgB,UAAU,CAAC,CAAmB;IAC5C,OAAO,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC;AAC1B,CAAC;AACD,SAAgB,OAAO,CAAC,CAAmB;IACzC,OAAO,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC;AAC1B,CAAC"}

package/dist/cjs/inspector/transports/in-process.d.ts

@@ -0,0 +1,7 @@
+import type { InspectorTransport } from "../protocol.js";
+/** Returns the two ends of one connection: give `agent` to the agent, `client` to Lens. */
+export declare function createInProcessTransportPair(): {
+    agent: InspectorTransport;
+    client: InspectorTransport;
+};
+//# sourceMappingURL=in-process.d.ts.map

package/dist/cjs/inspector/transports/in-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process.d.ts","sourceRoot":"","sources":["../../../../src/inspector/transports/in-process.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAgD3E,2FAA2F;AAC3F,wBAAgB,4BAA4B,IAAI;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAMxG"}

package/dist/cjs/inspector/transports/in-process.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInProcessTransportPair = createInProcessTransportPair;
+/**
+ * A transport pair joined by direct function calls.
+ *
+ * This is what makes Lens work with **zero configuration and zero native modules** when it runs
+ * inside the app it is inspecting — the case that always works, in Expo Go included. It is also how
+ * the protocol is tested: identical message flow, no I/O.
+ *
+ * Messages are delivered on a microtask rather than synchronously, so the transport behaves like a
+ * real one (a handler cannot rely on send() having completed inline) and a bug that only appears
+ * with async delivery is caught here rather than on a device.
+ */
+class InProcessEnd {
+    constructor() {
+        this.name = "in-process";
+        this.handlers = new Set();
+        this.peer = null;
+        this.open = true;
+    }
+    get isOpen() {
+        return this.open;
+    }
+    _link(peer) {
+        this.peer = peer;
+    }
+    send(message) {
+        if (!this.open)
+            return;
+        const peer = this.peer;
+        if (!peer)
+            return;
+        queueMicrotask(() => {
+            if (!peer.open)
+                return;
+            for (const handler of [...peer.handlers])
+                handler(message);
+        });
+    }
+    onMessage(handler) {
+        this.handlers.add(handler);
+        return () => this.handlers.delete(handler);
+    }
+    close() {
+        this.open = false;
+        this.handlers.clear();
+    }
+}
+/** Returns the two ends of one connection: give `agent` to the agent, `client` to Lens. */
+function createInProcessTransportPair() {
+    const a = new InProcessEnd();
+    const b = new InProcessEnd();
+    a._link(b);
+    b._link(a);
+    return { agent: a, client: b };
+}
+//# sourceMappingURL=in-process.js.map

package/dist/cjs/inspector/transports/in-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process.js","sourceRoot":"","sources":["../../../../src/inspector/transports/in-process.ts"],"names":[],"mappings":";;AAiDA,oEAMC;AArDD;;;;;;;;;;GAUG;AACH,MAAM,YAAY;IAAlB;QACW,SAAI,GAAG,YAAY,CAAC;QACrB,aAAQ,GAAG,IAAI,GAAG,EAAiC,CAAC;QACpD,SAAI,GAAwB,IAAI,CAAC;QACjC,SAAI,GAAG,IAAI,CAAC;IA6BtB,CAAC;IA3BC,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,IAAkB;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,OAAyB;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,cAAc,CAAC,GAAG,EAAE;YAClB,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,OAAO;YACvB,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;gBAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,OAA4C;QACpD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAClB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF;AAED,2FAA2F;AAC3F,SAAgB,4BAA4B;IAC1C,MAAM,CAAC,GAAG,IAAI,YAAY,EAAE,CAAC;IAC7B,MAAM,CAAC,GAAG,IAAI,YAAY,EAAE,CAAC;IAC7B,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACX,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACX,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AACjC,CAAC"}