@wendoo/bridge-app 0.2.2

package/dist/extension-report-presenter.d.ts

@@ -0,0 +1,40 @@
+import type { ExtensionInstallReport } from "./extension-install.js";
+/**
+ * The kind of transaction a report is presented for: `install` and `uninstall`
+ * act on one named library; `refresh` re-runs the current map (retry, update,
+ * or load-time move application) and names no single library.
+ */
+export type ExtensionTransactionFlavor = "install" | "uninstall" | "refresh";
+/**
+ * The toast surface an extension transaction reports through. Payloads carry
+ * concept-level data only -- a display name, a stable code -- and never
+ * diagnostics.
+ */
+export interface ExtensionTransactionToasts {
+    /** The transaction was refused; nothing changed. Carries the refusal's stable code when it has one. */
+    failed(refusal: {
+        code?: string;
+        message: string;
+    }): void;
+    /** The transaction committed; names the affected library by display name. */
+    confirmed(libraryName: string): void;
+}
+/**
+ * Present an extension transaction's report through a toast surface. A refusal
+ * surfaces as `failed`. A commit of an `install` or `uninstall` transaction
+ * confirms with the library's display name; a `refresh` commit presents
+ * nothing. A commit toasts nothing about its outcome in either direction:
+ * standing problems and their resolution live on the brain badges.
+ *
+ * @param options.report - The transaction's report; absent presents nothing.
+ * @param options.flavor - The transaction kind.
+ * @param options.libraryName - Display name of the affected library; required for install and uninstall.
+ * @param options.toasts - The toast surface to present through.
+ */
+export declare function presentExtensionTransaction(options: {
+    report: ExtensionInstallReport | undefined;
+    flavor: ExtensionTransactionFlavor;
+    libraryName?: string;
+    toasts: ExtensionTransactionToasts;
+}): void;
+//# sourceMappingURL=extension-report-presenter.d.ts.map

package/dist/extension-report-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-report-presenter.d.ts","sourceRoot":"","sources":["../src/extension-report-presenter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAE7E;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,uGAAuG;IACvG,MAAM,CAAC,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,6EAA6E;IAC7E,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,MAAM,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC3C,MAAM,EAAE,0BAA0B,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,0BAA0B,CAAC;CACpC,GAAG,IAAI,CAuBP"}

package/dist/extension-report-presenter.js

@@ -0,0 +1,36 @@
+/**
+ * Present an extension transaction's report through a toast surface. A refusal
+ * surfaces as `failed`. A commit of an `install` or `uninstall` transaction
+ * confirms with the library's display name; a `refresh` commit presents
+ * nothing. A commit toasts nothing about its outcome in either direction:
+ * standing problems and their resolution live on the brain badges.
+ *
+ * @param options.report - The transaction's report; absent presents nothing.
+ * @param options.flavor - The transaction kind.
+ * @param options.libraryName - Display name of the affected library; required for install and uninstall.
+ * @param options.toasts - The toast surface to present through.
+ */
+export function presentExtensionTransaction(options) {
+    const { report, flavor, toasts } = options;
+    if (!report) {
+        return;
+    }
+    if (!report.committed) {
+        const refusal = report.refusal;
+        switch (refusal.kind) {
+            case "fetch":
+                toasts.failed({ code: refusal.error.code, message: refusal.error.message });
+                break;
+            case "store":
+                toasts.failed({ code: refusal.code, message: refusal.message });
+                break;
+            case "cycle":
+                toasts.failed({ message: refusal.message });
+                break;
+        }
+        return;
+    }
+    if (flavor !== "refresh") {
+        toasts.confirmed(options.libraryName ?? "");
+    }
+}

package/dist/fetched-extension-snapshots.d.ts

@@ -0,0 +1,66 @@
+import type { FetchedExtensionSnapshot, FileContent } from "@wendoo/app-host";
+import type { FolderInstalledExtensionMetadata } from "@wendoo/bridge-protocol";
+import type { FetchedExtensionContentMap } from "./embedded-extensions.js";
+/** App-data key holding a project's installed fetched-extension snapshots. */
+export declare const INSTALLED_EXTENSIONS_APP_DATA_KEY = "installed-extensions";
+/**
+ * One installed fetched dependency's persisted snapshot: the content of the
+ * dependency together with the reference and resolved routing specifier it
+ * was fetched at. The project store carries these records so `.libraries/`
+ * regenerates on load without reaching the network.
+ */
+export interface InstalledExtensionSnapshot {
+    /** The manifest reference the snapshot was installed from, as written. */
+    readonly reference: string;
+    /**
+     * The immutable routing specifier the content was fetched at: the
+     * reference's `@` pin as written, or the commit SHA a `#branch` reference
+     * resolved to.
+     */
+    readonly specifier: string;
+    /** Extension-relative path (no leading slash) mapped to base64 content bytes. */
+    readonly files: Readonly<Record<string, string>>;
+}
+/** A project's installed fetched-extension snapshots, keyed by `<owner>/<repo>` coordinate. */
+export type InstalledExtensionSnapshots = Readonly<Record<string, InstalledExtensionSnapshot>>;
+/** Build the persisted snapshot record for a fetched extension snapshot. */
+export declare function installedSnapshotFromFetched(snapshot: FetchedExtensionSnapshot): InstalledExtensionSnapshot;
+/** Decode a stored snapshot's files into the origin-relative content map resolution consumes (leading-slash paths). */
+export declare function decodeInstalledSnapshotFiles(snapshot: InstalledExtensionSnapshot): Map<string, FileContent>;
+/**
+ * Build the fetched-content map resolution consumes from a project's stored
+ * snapshot records, keyed by each record's reference.
+ */
+export declare function fetchedContentFromSnapshots(snapshots: InstalledExtensionSnapshots): FetchedExtensionContentMap;
+/**
+ * Parse a project's stored snapshot records from their app-data text. Returns
+ * an empty record when the text is absent or malformed; individual malformed
+ * entries are dropped.
+ */
+export declare function parseInstalledExtensionSnapshots(raw: string | undefined): InstalledExtensionSnapshots;
+/** Serialize a project's snapshot records to their app-data text. */
+export declare function serializeInstalledExtensionSnapshots(snapshots: InstalledExtensionSnapshots): string;
+/**
+ * Extract each snapshot record's install provenance, keyed by `<owner>/<repo>`
+ * origin.
+ */
+export declare function installedExtensionMetadataFromSnapshots(snapshots: InstalledExtensionSnapshots): Record<string, FolderInstalledExtensionMetadata>;
+/**
+ * Parse an installed-extensions metadata record from its JSON text. Returns an
+ * empty record when the text is absent or malformed; individual malformed
+ * entries are dropped.
+ */
+export declare function parseInstalledExtensionMetadata(raw: string | undefined): Record<string, FolderInstalledExtensionMetadata>;
+/**
+ * Rebuild a project's installed snapshot records from a materialized
+ * installed-extensions tree and its recorded install provenance. For each
+ * origin in `metadata`, the tree's files under
+ * `.libraries/<owner>/<repo>/` become the record's content at the recorded
+ * reference and specifier; an origin with no files in the tree yields no
+ * record.
+ *
+ * @param metadata - Install provenance per origin, as recorded beside the tree.
+ * @param treeFiles - Project-relative path/content pairs of the tree's files.
+ */
+export declare function reconstructInstalledSnapshotsFromTree(metadata: Readonly<Record<string, FolderInstalledExtensionMetadata>>, treeFiles: ReadonlyArray<[string, FileContent]>): InstalledExtensionSnapshots;
+//# sourceMappingURL=fetched-extension-snapshots.d.ts.map

package/dist/fetched-extension-snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetched-extension-snapshots.d.ts","sourceRoot":"","sources":["../src/fetched-extension-snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAEhF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAE3E,8EAA8E;AAC9E,eAAO,MAAM,iCAAiC,yBAAyB,CAAC;AAExE;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAClD;AAED,+FAA+F;AAC/F,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAE/F,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,wBAAwB,GAAG,0BAA0B,CAM3G;AAED,uHAAuH;AACvH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,0BAA0B,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAM3G;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,2BAA2B,GAAG,0BAA0B,CAM9G;AAaD;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,2BAA2B,CAgBrG;AAED,qEAAqE;AACrE,wBAAgB,oCAAoC,CAAC,SAAS,EAAE,2BAA2B,GAAG,MAAM,CAEnG;AAED;;;GAGG;AACH,wBAAgB,uCAAuC,CACrD,SAAS,EAAE,2BAA2B,GACrC,MAAM,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAMlD;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,MAAM,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAgBlD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC,EACpE,SAAS,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,GAC9C,2BAA2B,CAe7B"}

package/dist/fetched-extension-snapshots.js

@@ -0,0 +1,137 @@
+import { base64ToBytes, bytesToBase64, fileContentFromBytes, fileContentToBytes } from "@wendoo/app-host";
+import { EXTENSIONS_TREE_PATH } from "@wendoo/bridge-protocol";
+/** App-data key holding a project's installed fetched-extension snapshots. */
+export const INSTALLED_EXTENSIONS_APP_DATA_KEY = "installed-extensions";
+/** Build the persisted snapshot record for a fetched extension snapshot. */
+export function installedSnapshotFromFetched(snapshot) {
+    const files = {};
+    for (const file of snapshot.files) {
+        files[file.path] = bytesToBase64(file.content);
+    }
+    return { reference: snapshot.reference, specifier: snapshot.specifier, files };
+}
+/** Decode a stored snapshot's files into the origin-relative content map resolution consumes (leading-slash paths). */
+export function decodeInstalledSnapshotFiles(snapshot) {
+    const files = new Map();
+    for (const [path, data] of Object.entries(snapshot.files)) {
+        files.set(path.startsWith("/") ? path : `/${path}`, fileContentFromBytes(base64ToBytes(data)));
+    }
+    return files;
+}
+/**
+ * Build the fetched-content map resolution consumes from a project's stored
+ * snapshot records, keyed by each record's reference.
+ */
+export function fetchedContentFromSnapshots(snapshots) {
+    const content = new Map();
+    for (const snapshot of Object.values(snapshots)) {
+        content.set(snapshot.reference, decodeInstalledSnapshotFiles(snapshot));
+    }
+    return content;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isInstalledExtensionSnapshot(value) {
+    if (!isRecord(value))
+        return false;
+    if (typeof value.reference !== "string" || typeof value.specifier !== "string")
+        return false;
+    if (!isRecord(value.files))
+        return false;
+    return Object.values(value.files).every((entry) => typeof entry === "string");
+}
+/**
+ * Parse a project's stored snapshot records from their app-data text. Returns
+ * an empty record when the text is absent or malformed; individual malformed
+ * entries are dropped.
+ */
+export function parseInstalledExtensionSnapshots(raw) {
+    if (raw === undefined)
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+    if (!isRecord(parsed))
+        return {};
+    const snapshots = {};
+    for (const [coordinate, entry] of Object.entries(parsed)) {
+        if (isInstalledExtensionSnapshot(entry)) {
+            snapshots[coordinate] = entry;
+        }
+    }
+    return snapshots;
+}
+/** Serialize a project's snapshot records to their app-data text. */
+export function serializeInstalledExtensionSnapshots(snapshots) {
+    return JSON.stringify(snapshots);
+}
+/**
+ * Extract each snapshot record's install provenance, keyed by `<owner>/<repo>`
+ * origin.
+ */
+export function installedExtensionMetadataFromSnapshots(snapshots) {
+    const metadata = {};
+    for (const [origin, snapshot] of Object.entries(snapshots)) {
+        metadata[origin] = { reference: snapshot.reference, specifier: snapshot.specifier };
+    }
+    return metadata;
+}
+/**
+ * Parse an installed-extensions metadata record from its JSON text. Returns an
+ * empty record when the text is absent or malformed; individual malformed
+ * entries are dropped.
+ */
+export function parseInstalledExtensionMetadata(raw) {
+    if (raw === undefined)
+        return {};
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+    if (!isRecord(parsed))
+        return {};
+    const metadata = {};
+    for (const [origin, entry] of Object.entries(parsed)) {
+        if (isRecord(entry) && typeof entry.reference === "string" && typeof entry.specifier === "string") {
+            metadata[origin] = { reference: entry.reference, specifier: entry.specifier };
+        }
+    }
+    return metadata;
+}
+/**
+ * Rebuild a project's installed snapshot records from a materialized
+ * installed-extensions tree and its recorded install provenance. For each
+ * origin in `metadata`, the tree's files under
+ * `.libraries/<owner>/<repo>/` become the record's content at the recorded
+ * reference and specifier; an origin with no files in the tree yields no
+ * record.
+ *
+ * @param metadata - Install provenance per origin, as recorded beside the tree.
+ * @param treeFiles - Project-relative path/content pairs of the tree's files.
+ */
+export function reconstructInstalledSnapshotsFromTree(metadata, treeFiles) {
+    const snapshots = {};
+    for (const [origin, provenance] of Object.entries(metadata)) {
+        const prefix = `${EXTENSIONS_TREE_PATH}/${origin}/`;
+        const files = {};
+        let hasFiles = false;
+        for (const [path, content] of treeFiles) {
+            if (!path.startsWith(prefix))
+                continue;
+            files[path.slice(prefix.length)] = bytesToBase64(fileContentToBytes(content));
+            hasFiles = true;
+        }
+        if (!hasFiles)
+            continue;
+        snapshots[origin] = { reference: provenance.reference, specifier: provenance.specifier, files };
+    }
+    return snapshots;
+}

package/dist/folder-host-session.d.ts

@@ -0,0 +1,85 @@
+import type { FileContent, ProjectFileChange, ProjectStore } from "@wendoo/app-host";
+import type { CompileDiagnosticEntry, CompileDiagnosticsPayload, FolderAppMessage, FolderHostMessage, FolderInstalledExtensionMetadata, FolderSessionErrorCode } from "@wendoo/bridge-protocol";
+import type { FolderAppDataCodec, WorkspaceFolderStoreErrorCode } from "./workspace-folder-project-store.js";
+export type { FolderAppDataCodec } from "./workspace-folder-project-store.js";
+/**
+ * Transport carrying folder-session messages between the app and its host.
+ * Message order is preserved in both directions.
+ */
+export interface FolderHostPort {
+    /** Send one message to the host. */
+    postMessage(message: FolderAppMessage): void;
+    /** Subscribe to messages from the host. Returns an unsubscribe function. */
+    onMessage(listener: (message: FolderHostMessage) => void): () => void;
+}
+/** Error raised by a folder session: a host-reported or client-detected fault. */
+export declare class FolderSessionError extends Error {
+    /** Stable machine-readable error code. */
+    readonly code: FolderSessionErrorCode | WorkspaceFolderStoreErrorCode;
+    constructor(code: FolderSessionErrorCode | WorkspaceFolderStoreErrorCode, message: string);
+}
+/** Options for {@link connectFolderHostSession}. */
+export interface FolderHostSessionOptions {
+    /** Transport to the folder-session host. */
+    port: FolderHostPort;
+    /** App name keying this app's chunk in the manifest's `app` map. */
+    appName: string;
+    /** Translator between app-data entries and this app's manifest chunk. */
+    appDataCodec?: FolderAppDataCodec;
+}
+/**
+ * A connected folder session: the host-backed project store, the project
+ * identity, and the app-side ends of the diagnostics and external-change
+ * channels.
+ */
+export interface FolderHostSession {
+    /** Store persisting the host-provided project to its workspace folder. */
+    readonly store: ProjectStore;
+    /** Stable opaque id of the host-provided project. */
+    readonly projectId: string;
+    /** Publish compile diagnostics for one file to the host. */
+    publishDiagnostics(payload: CompileDiagnosticsPayload): void;
+    /**
+     * Publish the app's full compiler-controlled file set and the install
+     * provenance of its fetched dependencies to the host.
+     */
+    publishCompilerControlledFiles(files: ReadonlyMap<string, FileContent>, installedExtensions: Readonly<Record<string, FolderInstalledExtensionMetadata>>): void;
+    /**
+     * Write a text file to the root of a removable volume mounted on the host
+     * machine, replacing any existing file with the same name. Resolves when
+     * the write completes; rejects with {@link FolderSessionError} carrying
+     * `REMOVABLE_VOLUME_NOT_FOUND` when no volume named `volumeName` is
+     * mounted, or `WRITE_FAILED` when the write fails.
+     */
+    writeRemovableVolumeFile(volumeName: string, filename: string, contents: string): Promise<void>;
+    /**
+     * Ask the host to open a self-contained HTML document in the user's default
+     * external application (the system browser). Resolves when the host has
+     * opened it; rejects with {@link FolderSessionError} when the host cannot
+     * write or open it.
+     */
+    openExternalDocument(html: string): Promise<void>;
+    /**
+     * Subscribe to project file changes observed on disk outside the app. Each
+     * change has already been absorbed by the session's store; apply it to the
+     * live project file system. Changes received before the first listener
+     * attaches are replayed to it. Returns an unsubscribe function.
+     */
+    onExternalChange(listener: (change: ProjectFileChange) => void): () => void;
+    /** Detach from the port. */
+    dispose(): void;
+}
+/**
+ * Open a folder session over `port`: performs the hello/welcome handshake,
+ * verifies the protocol version, and builds the workspace-folder project
+ * store from the delivered manifest. Rejects with {@link FolderSessionError}
+ * when the host refuses or speaks a different protocol version.
+ */
+export declare function connectFolderHostSession(options: FolderHostSessionOptions): Promise<FolderHostSession>;
+/**
+ * Build a compile-diagnostics publisher for a folder session: publishes each
+ * file's diagnostics with a per-file version, and publishes an empty list for
+ * a file whose previously reported diagnostics have cleared.
+ */
+export declare function createFolderCompileDiagnosticsPublisher(session: FolderHostSession): (files: ReadonlyMap<string, readonly CompileDiagnosticEntry[]>) => void;
+//# sourceMappingURL=folder-host-session.d.ts.map

package/dist/folder-host-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-host-session.d.ts","sourceRoot":"","sources":["../src/folder-host-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAuB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE1G,OAAO,KAAK,EACV,sBAAsB,EACtB,yBAAyB,EAGzB,gBAAgB,EAChB,iBAAiB,EACjB,gCAAgC,EAChC,sBAAsB,EAEvB,MAAM,yBAAyB,CAAC;AAUjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAG7G,YAAY,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC7C,4EAA4E;IAC5E,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACvE;AAED,kFAAkF;AAClF,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,GAAG,6BAA6B,CAAC;gBAE1D,IAAI,EAAE,sBAAsB,GAAG,6BAA6B,EAAE,OAAO,EAAE,MAAM;CAK1F;AAED,oDAAoD;AACpD,MAAM,WAAW,wBAAwB;IACvC,4CAA4C;IAC5C,IAAI,EAAE,cAAc,CAAC;IACrB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC7D;;;OAGG;IACH,8BAA8B,CAC5B,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,EACvC,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC,GAC9E,IAAI,CAAC;IACR;;;;;;OAMG;IACH,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChG;;;;;OAKG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5E,4BAA4B;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqG5G;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,iBAAiB,GACzB,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,KAAK,IAAI,CA8BzE"}

package/dist/folder-host-session.js

@@ -0,0 +1,210 @@
+import { fileContentFromWire, fileContentText, fileContentToWire } from "@wendoo/app-host";
+import { FOLDER_SESSION_PROTOCOL_VERSION, FolderSessionErrorCode as FolderSessionErrorCodes, INSTALLED_EXTENSIONS_METADATA_PATH, } from "@wendoo/bridge-protocol";
+import { parseInstalledExtensionMetadata, reconstructInstalledSnapshotsFromTree, } from "./fetched-extension-snapshots.js";
+import { WorkspaceFolderProjectStore } from "./workspace-folder-project-store.js";
+/** Error raised by a folder session: a host-reported or client-detected fault. */
+export class FolderSessionError extends Error {
+    /** Stable machine-readable error code. */
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "FolderSessionError";
+        this.code = code;
+    }
+}
+/**
+ * Open a folder session over `port`: performs the hello/welcome handshake,
+ * verifies the protocol version, and builds the workspace-folder project
+ * store from the delivered manifest. Rejects with {@link FolderSessionError}
+ * when the host refuses or speaks a different protocol version.
+ */
+export async function connectFolderHostSession(options) {
+    const rpc = new FolderPortRpc(options.port);
+    const welcome = await rpc.request({
+        type: "folder:hello",
+        payload: { protocolVersion: FOLDER_SESSION_PROTOCOL_VERSION },
+    });
+    if (welcome.type !== "folder:welcome") {
+        rpc.dispose();
+        throw new FolderSessionError(FolderSessionErrorCodes.INVALID_PAYLOAD, `Expected folder:welcome, received ${welcome.type}`);
+    }
+    const payload = welcome.payload;
+    if (payload.protocolVersion !== FOLDER_SESSION_PROTOCOL_VERSION) {
+        rpc.dispose();
+        throw new FolderSessionError(FolderSessionErrorCodes.PROTOCOL_VERSION_MISMATCH, `Host speaks folder-session protocol version ${payload.protocolVersion}; this app speaks ${FOLDER_SESSION_PROTOCOL_VERSION}`);
+    }
+    const store = new WorkspaceFolderProjectStore({
+        rpc: {
+            sendChange: async (change) => {
+                await rpc.request({ type: "folder:change", payload: change });
+            },
+            writeManifest: async (content) => {
+                await rpc.request({ type: "folder:manifestWrite", payload: { content } });
+            },
+            loadFiles: async () => {
+                const reply = await rpc.request({ type: "folder:loadFiles" });
+                const snapshot = new Map();
+                if (reply.type === "folder:files") {
+                    for (const [path, entry] of reply.payload.entries) {
+                        snapshot.set(path, entry);
+                    }
+                }
+                return snapshot;
+            },
+        },
+        projectId: payload.projectId,
+        manifestContent: payload.manifest.content,
+        appName: options.appName,
+        appDataCodec: options.appDataCodec,
+        installedExtensionSnapshots: reconstructSnapshotsFromWelcome(payload.extensionsCache),
+    });
+    const externalChangeListeners = new Set();
+    const bufferedExternalChanges = [];
+    rpc.onExternalChange((notification) => {
+        const change = store.absorbExternalChange(notification);
+        if (externalChangeListeners.size === 0) {
+            bufferedExternalChanges.push(change);
+            return;
+        }
+        for (const listener of externalChangeListeners) {
+            listener(change);
+        }
+    });
+    return {
+        store,
+        projectId: payload.projectId,
+        publishDiagnostics(payload) {
+            options.port.postMessage({ type: "folder:diagnostics", payload });
+        },
+        publishCompilerControlledFiles(files, installedExtensions) {
+            options.port.postMessage({
+                type: "folder:compilerFiles",
+                payload: {
+                    files: [...files].map(([path, content]) => [path, fileContentToWire(content)]),
+                    installedExtensions,
+                },
+            });
+        },
+        async writeRemovableVolumeFile(volumeName, filename, contents) {
+            await rpc.request({ type: "folder:volumeWrite", payload: { volumeName, filename, contents } });
+        },
+        async openExternalDocument(html) {
+            await rpc.request({ type: "folder:openExternalDocument", payload: { html } });
+        },
+        onExternalChange(listener) {
+            externalChangeListeners.add(listener);
+            if (bufferedExternalChanges.length > 0) {
+                const replay = bufferedExternalChanges.splice(0);
+                for (const change of replay) {
+                    listener(change);
+                }
+            }
+            return () => {
+                externalChangeListeners.delete(listener);
+            };
+        },
+        dispose() {
+            rpc.dispose();
+        },
+    };
+}
+/**
+ * Build a compile-diagnostics publisher for a folder session: publishes each
+ * file's diagnostics with a per-file version, and publishes an empty list for
+ * a file whose previously reported diagnostics have cleared.
+ */
+export function createFolderCompileDiagnosticsPublisher(session) {
+    const versions = new Map();
+    const previousDiagnosticFiles = new Set();
+    const publish = (file, diagnostics) => {
+        const version = (versions.get(file) ?? 0) + 1;
+        versions.set(file, version);
+        session.publishDiagnostics({ file, version, diagnostics: [...diagnostics] });
+    };
+    return (files) => {
+        const currentFiles = new Set();
+        for (const [file, diagnostics] of files) {
+            currentFiles.add(file);
+            if (diagnostics.length > 0 || previousDiagnosticFiles.has(file)) {
+                publish(file, diagnostics);
+            }
+        }
+        for (const file of previousDiagnosticFiles) {
+            if (!currentFiles.has(file)) {
+                publish(file, []);
+            }
+        }
+        previousDiagnosticFiles.clear();
+        for (const [file, diagnostics] of files) {
+            if (diagnostics.length > 0) {
+                previousDiagnosticFiles.add(file);
+            }
+        }
+    };
+}
+/**
+ * Rebuild the installed snapshot records from the welcome's on-disk
+ * installed-extensions tree offer. Returns `undefined` when the offer is
+ * absent or carries no metadata record.
+ */
+function reconstructSnapshotsFromWelcome(extensionsCache) {
+    if (!extensionsCache) {
+        return undefined;
+    }
+    const files = extensionsCache.map(([path, payload]) => [path, fileContentFromWire(payload)]);
+    const metadataEntry = files.find(([path]) => path === INSTALLED_EXTENSIONS_METADATA_PATH);
+    const metadata = parseInstalledExtensionMetadata(fileContentText(metadataEntry?.[1] ?? ""));
+    if (Object.keys(metadata).length === 0) {
+        return undefined;
+    }
+    return reconstructInstalledSnapshotsFromTree(metadata, files);
+}
+/** Request/reply and event demultiplexer over a {@link FolderHostPort}. */
+class FolderPortRpc {
+    port;
+    unsubscribe;
+    pending = new Map();
+    externalChangeListeners = new Set();
+    nextRequestId = 1;
+    constructor(port) {
+        this.port = port;
+        this.unsubscribe = port.onMessage((message) => {
+            this.handleMessage(message);
+        });
+    }
+    request(message) {
+        const id = `folder-request-${this.nextRequestId++}`;
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            this.port.postMessage({ ...message, id });
+        });
+    }
+    onExternalChange(listener) {
+        this.externalChangeListeners.add(listener);
+    }
+    dispose() {
+        this.unsubscribe();
+        this.pending.clear();
+    }
+    handleMessage(message) {
+        if (message.id !== undefined && this.pending.has(message.id)) {
+            const entry = this.pending.get(message.id);
+            this.pending.delete(message.id);
+            if (!entry) {
+                return;
+            }
+            if (message.type === "folder:error") {
+                entry.reject(new FolderSessionError(message.payload.code, message.payload.message));
+            }
+            else {
+                entry.resolve(message);
+            }
+            return;
+        }
+        if (message.type === "folder:externalChange") {
+            for (const listener of this.externalChangeListeners) {
+                listener(message.payload);
+            }
+        }
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+export type { InMemoryProjectFileSystemOptions } from "@wendoo/app-host";
+export { createInMemoryProjectFileSystem, WENDOO_JSON_PATH } from "@wendoo/app-host";
+export type { FolderAppMessage, FolderHostMessage, FolderInstalledExtensionMetadata, } from "@wendoo/bridge-protocol";
+export { FOLDER_HOST_MODE_FOLDER, FOLDER_HOST_MODE_GLOBAL, FOLDER_HOST_MODE_URL_PARAM, FolderSessionErrorCode, } from "@wendoo/bridge-protocol";
+export type { AppBridge, AppBridgeFeature, AppBridgeFeatureContext, AppBridgeFeatureStatus, AppBridgeOptions, AppBridgeSnapshot, AppBridgeState, DiagnosticEntry, ProjectFileChange, ProjectFileSnapshot, ProjectFileSystem, } from "./app-bridge.js";
+export { createAppBridge } from "./app-bridge.js";
+export type { AppEnvironmentHostOptions, CatalogMovesOutcome, WorkspaceCompileDiagnostic, } from "./app-environment-host.js";
+export { AppEnvironmentHost } from "./app-environment-host.js";
+export type { BrainDiagnosticEntry, TileCompileDiagnosticsLookup } from "./brain-diagnostics.js";
+export { collectBrainErrorDiagnostics, collectBrainTileCompileDiagnostics } from "./brain-diagnostics.js";
+export { CORE_LIB_COORDINATE, CORE_LIB_REFERENCE } from "./core-extension.js";
+export type { EmbeddedExtensionIdViolation } from "./embedded-extension-id-gate.js";
+export { findEmbeddedExtensionsMissingStableIds, formatEmbeddedExtensionIdViolations, } from "./embedded-extension-id-gate.js";
+export type { EmbeddedExtension, EmbeddedExtensionFile, ExtensionResolutionConflictWarning, ExtensionResolutionSources, ExtensionResolutionWarning, ExtensionResolutionWarningKind, FetchedExtensionContentMap, ResolvedExtensions, ResolvedOriginProvenance, } from "./embedded-extensions.js";
+export { CatalogMoveWarningCode, createCatalogMoveVersionLookup, ExtensionResolutionCycleError, resolveProjectExtensions, } from "./embedded-extensions.js";
+export type { ExtensionActionResult, ExtensionCatalogEntry, ExtensionCatalogOffer, ExtensionCatalogShelfEntry, ExtensionFetchFailures, PlatformStackLayer, } from "./extension-catalog.js";
+export { buildExtensionCatalog, buildExtensionCatalogOffers, buildExtensionCatalogShelf, deriveProjectPlatformStack, ExtensionActionResultCode, installEmbeddedExtension, installExtensionReference, isExtensionCompatible, satisfiesRange, uninstallExtension, } from "./extension-catalog.js";
+export type { ExtensionFetchClosureResult, ExtensionInstallOutcome, ExtensionInstallOutcomeKind, ExtensionInstallProblem, ExtensionInstallRefusal, ExtensionInstallReport, ProjectDiagnosticsState, } from "./extension-install.js";
+export { collectExtensionFetchClosure, diffProjectDiagnostics, floatingPinsFromSnapshots, movedClosureHasMissingContent, typecheckBrainProblems, } from "./extension-install.js";
+export type { ExtensionInstallLogEvent } from "./extension-install-log.js";
+export { appendExtensionInstallLog, EXTENSION_INSTALL_LOG_APP_DATA_KEY, parseExtensionInstallLog, } from "./extension-install-log.js";
+export type { ExtensionTransactionFlavor, ExtensionTransactionToasts } from "./extension-report-presenter.js";
+export { presentExtensionTransaction } from "./extension-report-presenter.js";
+export type { InstalledExtensionSnapshot, InstalledExtensionSnapshots, } from "./fetched-extension-snapshots.js";
+export { decodeInstalledSnapshotFiles, fetchedContentFromSnapshots, INSTALLED_EXTENSIONS_APP_DATA_KEY, installedExtensionMetadataFromSnapshots, installedSnapshotFromFetched, parseInstalledExtensionMetadata, parseInstalledExtensionSnapshots, reconstructInstalledSnapshotsFromTree, serializeInstalledExtensionSnapshots, } from "./fetched-extension-snapshots.js";
+export type { FolderHostPort, FolderHostSession, FolderHostSessionOptions } from "./folder-host-session.js";
+export { connectFolderHostSession, createFolderCompileDiagnosticsPublisher, FolderSessionError, } from "./folder-host-session.js";
+export type { LibraryInstallAttempt, LibraryOfferInstallSurface, LibraryOfferToasts } from "./library-offer.js";
+export { addOfferedLibrary } from "./library-offer.js";
+export type { LibraryUninstallGuardOutcome, LibraryUninstallImpact, UninstallGuardBrain, } from "./library-uninstall-guard.js";
+export { collectLibraryUninstallImpact, runGuardedLibraryUninstall } from "./library-uninstall-guard.js";
+export type { TileCompileDiagnostics, UserTileApplyResult, UserTileMetadata } from "./user-tile-registration.js";
+export { applyCompiledUserTiles, collectMetadataFromCompile } from "./user-tile-registration.js";
+export type { VfsAssetUrlProvider, VfsAssetUrlProviderOptions } from "./vfs-asset-url-provider.js";
+export { createVfsAssetUrlProvider } from "./vfs-asset-url-provider.js";
+export type { FolderAppDataCodec, WorkspaceFolderProjectStoreOptions, WorkspaceFolderRpc, } from "./workspace-folder-project-store.js";
+export { WORKSPACE_FOLDER_PROJECT_COLLECTION_ID, WorkspaceFolderProjectStore, WorkspaceFolderStoreError, WorkspaceFolderStoreErrorCode, } from "./workspace-folder-project-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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