@practicalkit/plugin-sdk 0.0.2

package/dist/src/namespaces/FsNamespace.js

@@ -0,0 +1,52 @@
+import { safeParse } from "valibot";
+import { FsSubscribe, FsUnsubscribe, FsFileChangedSchema, } from "../messages/index.js";
+/**
+ * File system namespace for file watching operations.
+ * This class is not part of the public SDK API.
+ */
+export class FsNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Subscribe to file system change events.
+     * Requires the "fs.watch" permission in the plugin manifest.
+     */
+    async subscribe() {
+        const response = await this.client.sendAndWait("fs.subscribe", {}, FsSubscribe.Request, FsSubscribe.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+    }
+    /**
+     * Unsubscribe from file system change events.
+     */
+    async unsubscribe() {
+        const response = await this.client.sendAndWait("fs.unsubscribe", {}, FsUnsubscribe.Request, FsUnsubscribe.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+    }
+    /**
+     * Listen for file change events.
+     * Must call fs.subscribe() first.
+     * @param callback Function called when a file changes
+     * @returns Unsubscribe function
+     */
+    onFileChanged(callback) {
+        return this.client.subscribe((evt) => {
+            const { type } = evt.data || {};
+            if (type !== "fs.fileChanged") {
+                return;
+            }
+            const result = safeParse(FsFileChangedSchema, evt.data);
+            if (!result.success) {
+                console.error("[SDK] Invalid fs.fileChanged payload:", result.issues);
+                return;
+            }
+            callback(result.output);
+        });
+    }
+}
+//# sourceMappingURL=FsNamespace.js.map

package/dist/src/namespaces/FsNamespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsNamespace.js","sourceRoot":"","sources":["../../../src/namespaces/FsNamespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,EACL,WAAW,EACX,aAAa,EACb,mBAAmB,GAEpB,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,MAAM,OAAO,WAAW;IACL,MAAM,CAAe;IAEtC,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAC5C,cAAc,EACd,EAAE,EACF,WAAW,CAAC,OAAO,EACnB,WAAW,CAAC,QAAQ,CACrB,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAC5C,gBAAgB,EAChB,EAAE,EACF,aAAa,CAAC,OAAO,EACrB,aAAa,CAAC,QAAQ,CACvB,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,QAAwC;QACpD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;YACnC,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAChC,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBAC9B,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,SAAS,CAAC,mBAAmB,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAExD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBACtE,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/src/namespaces/NativeNamespace.d.ts

@@ -0,0 +1,11 @@
+import type { IFrameClient } from "../messages/IFrameClient.js";
+/**
+ * Native namespace for calling native plugin modules.
+ * This class is not part of the public SDK API.
+ */
+export declare class NativeNamespace {
+    private readonly client;
+    constructor(client: IFrameClient);
+    call(pluginId: string, moduleId: string, command: string, args: unknown): Promise<unknown>;
+}
+//# sourceMappingURL=NativeNamespace.d.ts.map

package/dist/src/namespaces/NativeNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeNamespace.d.ts","sourceRoot":"","sources":["../../../src/namespaces/NativeNamespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAI1B,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC;CAcpB"}

package/dist/src/namespaces/NativeNamespace.js

@@ -0,0 +1,19 @@
+import { NativeCall } from "../messages/index.js";
+/**
+ * Native namespace for calling native plugin modules.
+ * This class is not part of the public SDK API.
+ */
+export class NativeNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async call(pluginId, moduleId, command, args) {
+        const response = await this.client.sendAndWait("native.call", { pluginId, moduleId, command, args }, NativeCall.Request, NativeCall.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+        return response.data;
+    }
+}
+//# sourceMappingURL=NativeNamespace.js.map

package/dist/src/namespaces/NativeNamespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeNamespace.js","sourceRoot":"","sources":["../../../src/namespaces/NativeNamespace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;GAGG;AACH,MAAM,OAAO,eAAe;IACT,MAAM,CAAe;IAEtC,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI,CACR,QAAgB,EAChB,QAAgB,EAChB,OAAe,EACf,IAAa;QAEb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAC5C,aAAa,EACb,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,EACrC,UAAU,CAAC,OAAO,EAClB,UAAU,CAAC,QAAQ,CACpB,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/src/namespaces/PluginNamespace.d.ts

@@ -0,0 +1,56 @@
+import type { IFrameClient } from "../messages/IFrameClient.js";
+import { PluginMessage } from "../messages/index.js";
+/**
+ * Intra-plugin messaging namespace.
+ * This class is not part of the public SDK API.
+ *
+ * Allows modules within the same plugin to communicate with each other.
+ * Messages are routed through the host - modules cannot communicate directly.
+ *
+ * Use cases:
+ * - A panel module sending commands to a backgroundService module
+ * - A backgroundService module notifying UI modules of state changes
+ * - Coordinating work between multiple UI modules
+ */
+export declare class PluginNamespace {
+    private readonly client;
+    constructor(client: IFrameClient);
+    /**
+     * Send a message to a specific sibling module within the same plugin.
+     * Returns a promise that resolves with the response from the target module.
+     *
+     * @param targetModuleId - The module ID to send the message to
+     * @param message - The message payload (any serializable value)
+     * @returns Promise resolving to the response data from the target module
+     * @throws Error if the target module doesn't exist or fails to respond
+     */
+    sendMessage<T = unknown>(targetModuleId: string, message: unknown): Promise<T>;
+    /**
+     * Listen for incoming messages from sibling modules.
+     * The handler should return a response that will be sent back to the sender.
+     * Supports both sync and async handlers.
+     *
+     * @param handler - Function that handles incoming messages and returns a response (sync or async)
+     * @returns Unsubscribe function
+     */
+    onMessage(handler: (payload: PluginMessage.HandlerPayload) => unknown | Promise<unknown>): () => void;
+    /**
+     * Broadcast a message to all sibling modules within the same plugin.
+     * This is fire-and-forget - no response is expected.
+     *
+     * @param message - The message payload (any serializable value)
+     */
+    sendBroadcast(message: unknown): Promise<void>;
+    /**
+     * Listen for broadcast messages from sibling modules.
+     * Broadcasts are fire-and-forget - no response is expected.
+     *
+     * @param handler - Function that handles incoming broadcasts
+     * @returns Unsubscribe function
+     */
+    onBroadcast(handler: (payload: {
+        fromModuleId: string;
+        message: unknown;
+    }) => void): () => void;
+}
+//# sourceMappingURL=PluginNamespace.d.ts.map

package/dist/src/namespaces/PluginNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginNamespace.d.ts","sourceRoot":"","sources":["../../../src/namespaces/PluginNamespace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAEL,aAAa,EAGd,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAIhC;;;;;;;;OAQG;IACG,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,CAAC,CAAC;IAeb;;;;;;;OAOG;IACH,SAAS,CACP,OAAO,EAAE,CACP,OAAO,EAAE,aAAa,CAAC,cAAc,KAClC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC9B,MAAM,IAAI;IA2Cb;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAapD;;;;;;OAMG;IACH,WAAW,CACT,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GACrE,MAAM,IAAI;CAiBd"}

package/dist/src/namespaces/PluginNamespace.js

@@ -0,0 +1,116 @@
+import { safeParse } from "valibot";
+import { PluginSendMessage, PluginMessage, PluginSendBroadcast, PluginBroadcast, } from "../messages/index.js";
+/**
+ * Intra-plugin messaging namespace.
+ * This class is not part of the public SDK API.
+ *
+ * Allows modules within the same plugin to communicate with each other.
+ * Messages are routed through the host - modules cannot communicate directly.
+ *
+ * Use cases:
+ * - A panel module sending commands to a backgroundService module
+ * - A backgroundService module notifying UI modules of state changes
+ * - Coordinating work between multiple UI modules
+ */
+export class PluginNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Send a message to a specific sibling module within the same plugin.
+     * Returns a promise that resolves with the response from the target module.
+     *
+     * @param targetModuleId - The module ID to send the message to
+     * @param message - The message payload (any serializable value)
+     * @returns Promise resolving to the response data from the target module
+     * @throws Error if the target module doesn't exist or fails to respond
+     */
+    async sendMessage(targetModuleId, message) {
+        const response = await this.client.sendAndWait("plugin.sendMessage", { targetModuleId, message }, PluginSendMessage.Request, PluginSendMessage.Response);
+        if (!response.success) {
+            throw new Error(response.error || "Failed to send message");
+        }
+        return response.data;
+    }
+    /**
+     * Listen for incoming messages from sibling modules.
+     * The handler should return a response that will be sent back to the sender.
+     * Supports both sync and async handlers.
+     *
+     * @param handler - Function that handles incoming messages and returns a response (sync or async)
+     * @returns Unsubscribe function
+     */
+    onMessage(handler) {
+        return this.client.subscribe((evt) => {
+            const { type } = evt.data || {};
+            if (type !== "plugin.message") {
+                return;
+            }
+            const result = safeParse(PluginMessage.Request, evt.data);
+            if (!result.success) {
+                console.error("[SDK] Invalid plugin.message payload:", result.issues);
+                return;
+            }
+            const requestId = result.output.payload.requestId;
+            // Wrap in Promise.resolve to handle both sync and async handlers
+            Promise.resolve()
+                .then(() => handler(result.output.payload))
+                .then((responseData) => {
+                this.client.send({
+                    type: "plugin.message.response",
+                    payload: {
+                        requestId,
+                        success: true,
+                        data: responseData,
+                    },
+                });
+            })
+                .catch((error) => {
+                console.error("[SDK] Error in plugin.onMessage handler:", error);
+                this.client.send({
+                    type: "plugin.message.response",
+                    payload: {
+                        requestId,
+                        success: false,
+                        error: error instanceof Error ? error.message : String(error),
+                    },
+                });
+            });
+        });
+    }
+    /**
+     * Broadcast a message to all sibling modules within the same plugin.
+     * This is fire-and-forget - no response is expected.
+     *
+     * @param message - The message payload (any serializable value)
+     */
+    async sendBroadcast(message) {
+        const response = await this.client.sendAndWait("plugin.sendBroadcast", { message }, PluginSendBroadcast.Request, PluginSendBroadcast.Response);
+        if (!response.success) {
+            throw new Error(response.error || "Failed to send broadcast");
+        }
+    }
+    /**
+     * Listen for broadcast messages from sibling modules.
+     * Broadcasts are fire-and-forget - no response is expected.
+     *
+     * @param handler - Function that handles incoming broadcasts
+     * @returns Unsubscribe function
+     */
+    onBroadcast(handler) {
+        return this.client.subscribe((evt) => {
+            const { type } = evt.data || {};
+            if (type !== "plugin.broadcast") {
+                return;
+            }
+            const result = safeParse(PluginBroadcast.Event, evt.data);
+            if (!result.success) {
+                console.error("[SDK] Invalid plugin.broadcast payload:", result.issues);
+                return;
+            }
+            handler(result.output.payload);
+        });
+    }
+}
+//# sourceMappingURL=PluginNamespace.js.map

package/dist/src/namespaces/PluginNamespace.js.map

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

package/dist/src/namespaces/StorageNamespace.d.ts

@@ -0,0 +1,56 @@
+import type { IFrameClient } from "../messages/IFrameClient.js";
+/**
+ * Storage namespace for plugin data and secrets.
+ *
+ * Provides two storage types:
+ * - `get`/`set`/`delete`: Non-secret storage for any binary data
+ * - `getSecret`/`setSecret`/`deleteSecret`: Encrypted storage for sensitive data
+ *
+ * Both use Uint8Array for values to support any binary data.
+ * Data is isolated per plugin (plugins cannot access each other's storage).
+ */
+export declare class StorageNamespace {
+    private readonly client;
+    constructor(client: IFrameClient);
+    /**
+     * Get a value from storage.
+     *
+     * @param key - The storage key
+     * @returns The value as Uint8Array, or null if not found
+     */
+    get(key: string): Promise<Uint8Array | null>;
+    /**
+     * Set a value in storage.
+     *
+     * @param key - The storage key
+     * @param value - The value to store as Uint8Array
+     */
+    set(key: string, value: Uint8Array): Promise<void>;
+    /**
+     * Delete a value from storage.
+     *
+     * @param key - The storage key to delete
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Get a secret value for this plugin.
+     *
+     * @param key - The secret key (e.g., "apiKey", "token")
+     * @returns The secret value as Uint8Array, or null if not found
+     */
+    getSecret(key: string): Promise<Uint8Array | null>;
+    /**
+     * Set a secret value for this plugin.
+     *
+     * @param key - The secret key (e.g., "apiKey", "token")
+     * @param value - The secret value to store as Uint8Array
+     */
+    setSecret(key: string, value: Uint8Array): Promise<void>;
+    /**
+     * Delete a secret value for this plugin.
+     *
+     * @param key - The secret key to delete
+     */
+    deleteSecret(key: string): Promise<void>;
+}
+//# sourceMappingURL=StorageNamespace.d.ts.map

package/dist/src/namespaces/StorageNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageNamespace.d.ts","sourceRoot":"","sources":["../../../src/namespaces/StorageNamespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAmChE;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAQhC;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAmBlD;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxD;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxC;;;;;OAKG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAmBxD;;;;;OAKG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D;;;;OAIG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAY/C"}

package/dist/src/namespaces/StorageNamespace.js

@@ -0,0 +1,127 @@
+import { StorageGet, StorageSet, StorageDelete, StorageGetSecret, StorageSetSecret, StorageDeleteSecret, } from "../messages/index.js";
+/**
+ * Encode Uint8Array to base64 string.
+ */
+function encodeBase64(bytes) {
+    let binary = "";
+    const len = bytes.length;
+    for (let i = 0; i < len; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+/**
+ * Decode base64 string to Uint8Array.
+ */
+function decodeBase64(base64) {
+    const binary = atob(base64);
+    const len = binary.length;
+    const bytes = new Uint8Array(len);
+    for (let i = 0; i < len; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+/**
+ * Storage namespace for plugin data and secrets.
+ *
+ * Provides two storage types:
+ * - `get`/`set`/`delete`: Non-secret storage for any binary data
+ * - `getSecret`/`setSecret`/`deleteSecret`: Encrypted storage for sensitive data
+ *
+ * Both use Uint8Array for values to support any binary data.
+ * Data is isolated per plugin (plugins cannot access each other's storage).
+ */
+export class StorageNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    // ===========================================================================
+    // Non-secret storage (raw bytes, unencrypted)
+    // ===========================================================================
+    /**
+     * Get a value from storage.
+     *
+     * @param key - The storage key
+     * @returns The value as Uint8Array, or null if not found
+     */
+    async get(key) {
+        const response = await this.client.sendAndWait("storage.get", { key }, StorageGet.Request, StorageGet.Response);
+        if (!response.success) {
+            throw new Error(response.error || "Failed to get value");
+        }
+        if (response.value === null) {
+            return null;
+        }
+        return decodeBase64(response.value);
+    }
+    /**
+     * Set a value in storage.
+     *
+     * @param key - The storage key
+     * @param value - The value to store as Uint8Array
+     */
+    async set(key, value) {
+        const base64 = encodeBase64(value);
+        const response = await this.client.sendAndWait("storage.set", { key, value: base64 }, StorageSet.Request, StorageSet.Response);
+        if (!response.success) {
+            throw new Error(response.error || "Failed to set value");
+        }
+    }
+    /**
+     * Delete a value from storage.
+     *
+     * @param key - The storage key to delete
+     */
+    async delete(key) {
+        const response = await this.client.sendAndWait("storage.delete", { key }, StorageDelete.Request, StorageDelete.Response);
+        if (!response.success) {
+            throw new Error(response.error || "Failed to delete value");
+        }
+    }
+    // ===========================================================================
+    // Secret storage (encrypted at rest)
+    // ===========================================================================
+    /**
+     * Get a secret value for this plugin.
+     *
+     * @param key - The secret key (e.g., "apiKey", "token")
+     * @returns The secret value as Uint8Array, or null if not found
+     */
+    async getSecret(key) {
+        const response = await this.client.sendAndWait("storage.getSecret", { key }, StorageGetSecret.Request, StorageGetSecret.Response);
+        if (!response.success) {
+            throw new Error(response.error || "Failed to get secret");
+        }
+        if (response.value === null) {
+            return null;
+        }
+        return decodeBase64(response.value);
+    }
+    /**
+     * Set a secret value for this plugin.
+     *
+     * @param key - The secret key (e.g., "apiKey", "token")
+     * @param value - The secret value to store as Uint8Array
+     */
+    async setSecret(key, value) {
+        const base64 = encodeBase64(value);
+        const response = await this.client.sendAndWait("storage.setSecret", { key, value: base64 }, StorageSetSecret.Request, StorageSetSecret.Response);
+        if (!response.success) {
+            throw new Error(response.error || "Failed to set secret");
+        }
+    }
+    /**
+     * Delete a secret value for this plugin.
+     *
+     * @param key - The secret key to delete
+     */
+    async deleteSecret(key) {
+        const response = await this.client.sendAndWait("storage.deleteSecret", { key }, StorageDeleteSecret.Request, StorageDeleteSecret.Response);
+        if (!response.success) {
+            throw new Error(response.error || "Failed to delete secret");
+        }
+    }
+}
+//# sourceMappingURL=StorageNamespace.js.map

package/dist/src/namespaces/StorageNamespace.js.map

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

package/dist/src/namespaces/VfsNamespace.d.ts

@@ -0,0 +1,25 @@
+import type { IFrameClient } from "../messages/IFrameClient.js";
+/**
+ * Virtual file system namespace for file operations.
+ * This class is not part of the public SDK API.
+ */
+export declare class VfsNamespace {
+    private readonly client;
+    constructor(client: IFrameClient);
+    exists(path: string): Promise<{
+        exists: boolean;
+        entryType: string | null;
+    }>;
+    readDir(path: string): Promise<{
+        name: string;
+        type: "file" | "directory";
+        size: number;
+    }[]>;
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    getAbsolutePath(path: string): Promise<string>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    delete(path: string): Promise<void>;
+    createDir(path: string): Promise<void>;
+}
+//# sourceMappingURL=VfsNamespace.d.ts.map

package/dist/src/namespaces/VfsNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VfsNamespace.d.ts","sourceRoot":"","sources":["../../../src/namespaces/VfsNamespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAYhE;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAI1B,MAAM,CAAC,IAAI,EAAE,MAAM;;;;IAenB,OAAO,CAAC,IAAI,EAAE,MAAM;;;;;IAepB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAevC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAavD,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe9C,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAavD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAanC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAY7C"}

package/dist/src/namespaces/VfsNamespace.js

@@ -0,0 +1,64 @@
+import { VfsCreateDir, VfsDelete, VfsExists, VfsGetAbsolutePath, VfsReadDir, VfsReadFile, VfsRename, VfsWriteFile, } from "../messages/index.js";
+/**
+ * Virtual file system namespace for file operations.
+ * This class is not part of the public SDK API.
+ */
+export class VfsNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async exists(path) {
+        const response = await this.client.sendAndWait("vfs.exists", { path }, VfsExists.Request, VfsExists.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+        return response.data;
+    }
+    async readDir(path) {
+        const response = await this.client.sendAndWait("vfs.readDir", { path }, VfsReadDir.Request, VfsReadDir.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+        return response.data;
+    }
+    async readFile(path) {
+        const response = await this.client.sendAndWait("vfs.readFile", { path }, VfsReadFile.Request, VfsReadFile.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+        return response.data;
+    }
+    async writeFile(path, content) {
+        const response = await this.client.sendAndWait("vfs.writeFile", { path, content }, VfsWriteFile.Request, VfsWriteFile.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+    }
+    async getAbsolutePath(path) {
+        const response = await this.client.sendAndWait("vfs.getAbsolutePath", { path }, VfsGetAbsolutePath.Request, VfsGetAbsolutePath.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+        return response.data.absolutePath;
+    }
+    async rename(oldPath, newPath) {
+        const response = await this.client.sendAndWait("vfs.rename", { oldPath, newPath }, VfsRename.Request, VfsRename.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+    }
+    async delete(path) {
+        const response = await this.client.sendAndWait("vfs.delete", { path }, VfsDelete.Request, VfsDelete.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+    }
+    async createDir(path) {
+        const response = await this.client.sendAndWait("vfs.createDir", { path }, VfsCreateDir.Request, VfsCreateDir.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+    }
+}
+//# sourceMappingURL=VfsNamespace.js.map

package/dist/src/namespaces/VfsNamespace.js.map

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

package/dist/src/namespaces/WorkspaceNamespace.d.ts

@@ -0,0 +1,18 @@
+import type { IFrameClient } from "../messages/IFrameClient.js";
+import { type WorkspaceChanged, type WorkspaceDetails } from "../messages/index.js";
+/**
+ * Workspace namespace for workspace operations.
+ * This class is not part of the public SDK API.
+ */
+export declare class WorkspaceNamespace {
+    private readonly client;
+    constructor(client: IFrameClient);
+    getDetails(): Promise<WorkspaceDetails>;
+    onChanged(callback: (payload: WorkspaceChanged) => void): () => void;
+    /**
+     * Open a folder picker dialog to select a workspace.
+     * @returns The selected workspace path, or null if cancelled
+     */
+    open(): Promise<string | null>;
+}
+//# sourceMappingURL=WorkspaceNamespace.d.ts.map

package/dist/src/namespaces/WorkspaceNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceNamespace.d.ts","sourceRoot":"","sources":["../../../src/namespaces/WorkspaceNamespace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAI1B,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAe7C,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;IAyBpE;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAcrC"}

package/dist/src/namespaces/WorkspaceNamespace.js

@@ -0,0 +1,48 @@
+import { safeParse } from "valibot";
+import { WorkspaceGetDetails, WorkspaceOpen, WorkspaceChangedSchema, } from "../messages/index.js";
+/**
+ * Workspace namespace for workspace operations.
+ * This class is not part of the public SDK API.
+ */
+export class WorkspaceNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async getDetails() {
+        const response = await this.client.sendAndWait("workspace.getDetails", {}, WorkspaceGetDetails.Request, WorkspaceGetDetails.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+        return response.data;
+    }
+    onChanged(callback) {
+        return this.client.subscribe((evt) => {
+            const { type, payload } = evt.data || {};
+            if (type !== "workspace.changed") {
+                return;
+            }
+            const result = safeParse(WorkspaceChangedSchema, {
+                type,
+                ...payload,
+            });
+            if (!result.success) {
+                console.error("[SDK] Invalid workspace.changed payload:", result.issues);
+                return;
+            }
+            callback(result.output);
+        });
+    }
+    /**
+     * Open a folder picker dialog to select a workspace.
+     * @returns The selected workspace path, or null if cancelled
+     */
+    async open() {
+        const response = await this.client.sendAndWait("workspace.open", {}, WorkspaceOpen.Request, WorkspaceOpen.Response);
+        if (!response.success) {
+            throw new Error(response.error);
+        }
+        return response.path;
+    }
+}
+//# sourceMappingURL=WorkspaceNamespace.js.map