@symbiosis-lab/moss-api 0.3.0 → 0.5.0

package/dist/index.d.mts

@@ -21,17 +21,20 @@ interface PluginManifest {
 type PluginCategory = "generator" | "deployer" | "syndicator" | "enhancer" | "processor";
 //#endregion
 //#region src/types/context.d.ts
+
 /**
  * Base context shared by all hooks
+ *
+ * Contains only business data - no paths.
+ * Use readFile(), writeFile() for project files.
+ * Use readPluginFile(), writePluginFile() for plugin storage.
  */
 interface BaseContext {
-  project_path: string;
-  moss_dir: string;
   project_info: ProjectInfo;
   config: Record<string, unknown>;
 }
 /**
- * Context for before_build hook
+ * Context for before_build hook (process capability)
  */
 interface BeforeBuildContext extends BaseContext {}
 /**
@@ -44,14 +47,12 @@ interface OnBuildContext extends BaseContext {
  * Context for on_deploy hook (deployer plugins)
  */
 interface OnDeployContext extends BaseContext {
-  output_dir: string;
   site_files: string[];
 }
 /**
  * Context for after_deploy hook (syndicator plugins)
  */
 interface AfterDeployContext extends BaseContext {
-  output_dir: string;
   site_files: string[];
   articles: ArticleInfo[];
   deployment?: DeploymentInfo;
@@ -218,70 +219,170 @@ declare function closeBrowser(): Promise<void>;
 /**
  * File system operations for Moss plugins
  *
- * These functions abstract away the underlying Tauri commands,
- * providing a clean API for plugins to read/write project files.
+ * These functions provide access to project files (user content).
+ * Project path is auto-detected from the runtime context.
+ *
+ * For plugin's private storage, use the plugin-storage API instead.
  */
 /**
  * Read a file from the project directory
  *
- * @param projectPath - Absolute path to the project directory
+ * Project path is auto-detected from the runtime context.
+ *
  * @param relativePath - Path relative to the project root
  * @returns File contents as a string
- * @throws Error if file cannot be read
+ * @throws Error if file cannot be read or called outside a hook
  *
  * @example
  * ```typescript
- * const content = await readFile("/path/to/project", "src/index.ts");
+ * // Read an article
+ * const content = await readFile("article/hello-world.md");
+ *
+ * // Read package.json
+ * const pkg = JSON.parse(await readFile("package.json"));
  * ```
  */
-declare function readFile(projectPath: string, relativePath: string): Promise<string>;
+declare function readFile(relativePath: string): Promise<string>;
 /**
  * Write content to a file in the project directory
  *
  * Creates parent directories if they don't exist.
+ * Project path is auto-detected from the runtime context.
  *
- * @param projectPath - Absolute path to the project directory
  * @param relativePath - Path relative to the project root
  * @param content - Content to write to the file
- * @throws Error if file cannot be written
+ * @throws Error if file cannot be written or called outside a hook
  *
  * @example
  * ```typescript
- * await writeFile("/path/to/project", "output/result.md", "# Hello World");
+ * // Write a generated article
+ * await writeFile("article/new-post.md", "# Hello World\n\nContent here.");
+ *
+ * // Write index page
+ * await writeFile("index.md", markdownContent);
  * ```
  */
-declare function writeFile(projectPath: string, relativePath: string, content: string): Promise<void>;
+declare function writeFile(relativePath: string, content: string): Promise<void>;
 /**
- * List all files in a project directory
+ * List all files in the project directory
  *
  * Returns file paths relative to the project root.
+ * Project path is auto-detected from the runtime context.
  *
- * @param projectPath - Absolute path to the project directory
  * @returns Array of relative file paths
- * @throws Error if directory cannot be listed
+ * @throws Error if directory cannot be listed or called outside a hook
  *
  * @example
  * ```typescript
- * const files = await listFiles("/path/to/project");
- * // ["src/index.ts", "package.json", "README.md"]
+ * const files = await listFiles();
+ * // ["index.md", "article/hello.md", "assets/logo.png"]
+ *
+ * const mdFiles = files.filter(f => f.endsWith(".md"));
  * ```
  */
-declare function listFiles(projectPath: string): Promise<string[]>;
+declare function listFiles(): Promise<string[]>;
 /**
  * Check if a file exists in the project directory
  *
- * @param projectPath - Absolute path to the project directory
+ * Project path is auto-detected from the runtime context.
+ *
  * @param relativePath - Path relative to the project root
  * @returns true if file exists, false otherwise
+ * @throws Error if called outside a hook
+ *
+ * @example
+ * ```typescript
+ * if (await fileExists("index.md")) {
+ *   const content = await readFile("index.md");
+ * }
+ * ```
+ */
+declare function fileExists(relativePath: string): Promise<boolean>;
+//#endregion
+//#region src/utils/plugin-storage.d.ts
+/**
+ * Plugin storage API for Moss plugins
+ *
+ * Provides access to a plugin's private storage directory at:
+ * .moss/plugins/{plugin-name}/
+ *
+ * Plugin identity is auto-detected from the runtime context -
+ * plugins never need to know their own name or path.
+ *
+ * Config is just a file: readPluginFile("config.json")
+ */
+/**
+ * Read a file from the plugin's private storage directory
+ *
+ * Storage path: .moss/plugins/{plugin-name}/{relativePath}
+ *
+ * @param relativePath - Path relative to the plugin's storage directory
+ * @returns File contents as a string
+ * @throws Error if file cannot be read or called outside a hook
+ *
+ * @example
+ * ```typescript
+ * // Read plugin config
+ * const configJson = await readPluginFile("config.json");
+ * const config = JSON.parse(configJson);
+ *
+ * // Read cached data
+ * const cached = await readPluginFile("cache/articles.json");
+ * ```
+ */
+declare function readPluginFile(relativePath: string): Promise<string>;
+/**
+ * Write a file to the plugin's private storage directory
+ *
+ * Creates parent directories if they don't exist.
+ * Storage path: .moss/plugins/{plugin-name}/{relativePath}
+ *
+ * @param relativePath - Path relative to the plugin's storage directory
+ * @param content - Content to write to the file
+ * @throws Error if file cannot be written or called outside a hook
+ *
+ * @example
+ * ```typescript
+ * // Save plugin config
+ * await writePluginFile("config.json", JSON.stringify(config, null, 2));
+ *
+ * // Cache data
+ * await writePluginFile("cache/articles.json", JSON.stringify(articles));
+ * ```
+ */
+declare function writePluginFile(relativePath: string, content: string): Promise<void>;
+/**
+ * List all files in the plugin's private storage directory
+ *
+ * Returns file paths relative to the plugin's storage directory.
+ *
+ * @returns Array of relative file paths
+ * @throws Error if directory cannot be listed or called outside a hook
+ *
+ * @example
+ * ```typescript
+ * const files = await listPluginFiles();
+ * // ["config.json", "cache/articles.json", "cache/images.json"]
+ * ```
+ */
+declare function listPluginFiles(): Promise<string[]>;
+/**
+ * Check if a file exists in the plugin's private storage directory
+ *
+ * @param relativePath - Path relative to the plugin's storage directory
+ * @returns true if file exists, false otherwise
+ * @throws Error if called outside a hook
  *
  * @example
  * ```typescript
- * if (await fileExists("/path/to/project", "config.json")) {
- *   // load config
+ * if (await pluginFileExists("config.json")) {
+ *   const config = JSON.parse(await readPluginFile("config.json"));
+ * } else {
+ *   // Use default config
  * }
  * ```
  */
-declare function fileExists(projectPath: string, relativePath: string): Promise<boolean>;
+declare function pluginFileExists(relativePath: string): Promise<boolean>;
 //#endregion
 //#region src/utils/http.d.ts
 /**
@@ -289,6 +390,8 @@ declare function fileExists(projectPath: string, relativePath: string): Promise<
  *
  * These functions provide HTTP capabilities that bypass browser CORS
  * restrictions by using Rust's HTTP client under the hood.
+ *
+ * Project path for downloads is auto-detected from the runtime context.
  */
 /**
  * Options for HTTP fetch requests
@@ -358,18 +461,18 @@ declare function fetchUrl(url: string, options?: FetchOptions): Promise<FetchRes
  * the binary data through JavaScript. The filename is derived from
  * the URL, and file extension is inferred from Content-Type if needed.
  *
+ * Project path is auto-detected from the runtime context.
+ *
  * @param url - URL to download
- * @param projectPath - Absolute path to the project directory
  * @param targetDir - Target directory within project (e.g., "assets")
  * @param options - Optional download configuration
  * @returns Download result with actual path where file was saved
- * @throws Error if download or write fails
+ * @throws Error if download or write fails, or called outside a hook
  *
  * @example
  * ```typescript
  * const result = await downloadAsset(
  *   "https://example.com/image",
- *   "/path/to/project",
  *   "assets"
  * );
  * if (result.ok) {
@@ -377,7 +480,7 @@ declare function fetchUrl(url: string, options?: FetchOptions): Promise<FetchRes
  * }
  * ```
  */
-declare function downloadAsset(url: string, projectPath: string, targetDir: string, options?: DownloadOptions): Promise<DownloadResult>;
+declare function downloadAsset(url: string, targetDir: string, options?: DownloadOptions): Promise<DownloadResult>;
 //#endregion
 //#region src/utils/binary.d.ts
 /**
@@ -385,6 +488,9 @@ declare function downloadAsset(url: string, projectPath: string, targetDir: stri
  *
  * Allows plugins to execute external binaries (git, npm, etc.)
  * in a controlled environment.
+ *
+ * Working directory is auto-detected from the runtime context
+ * (always the project root).
  */
 /**
  * Options for executing a binary
@@ -394,8 +500,6 @@ interface ExecuteOptions {
   binaryPath: string;
   /** Arguments to pass to the binary */
   args: string[];
-  /** Working directory for execution */
-  workingDir: string;
   /** Timeout in milliseconds (default: 60000) */
   timeoutMs?: number;
   /** Additional environment variables */
@@ -417,9 +521,12 @@ interface ExecuteResult {
 /**
  * Execute an external binary
  *
- * @param options - Execution options including binary path, args, and working directory
+ * Working directory is auto-detected from the runtime context
+ * (always the project root).
+ *
+ * @param options - Execution options including binary path and args
  * @returns Execution result with stdout, stderr, and exit code
- * @throws Error if binary cannot be executed
+ * @throws Error if binary cannot be executed or called outside a hook
  *
  * @example
  * ```typescript
@@ -427,7 +534,6 @@ interface ExecuteResult {
  * const result = await executeBinary({
  *   binaryPath: "git",
  *   args: ["status"],
- *   workingDir: "/path/to/repo",
  * });
  *
  * if (result.success) {
@@ -443,7 +549,6 @@ interface ExecuteResult {
  * const result = await executeBinary({
  *   binaryPath: "npm",
  *   args: ["install"],
- *   workingDir: "/path/to/project",
  *   timeoutMs: 120000,
  *   env: { NODE_ENV: "production" },
  * });
@@ -457,6 +562,9 @@ declare function executeBinary(options: ExecuteOptions): Promise<ExecuteResult>;
  *
  * Allows plugins to store and retrieve authentication cookies
  * for external services (e.g., Matters.town, GitHub).
+ *
+ * Cookies are automatically scoped to the plugin's registered domain
+ * (defined in manifest.json) - plugins cannot access other plugins' cookies.
  */
 /**
  * A cookie stored for plugin authentication
@@ -472,37 +580,46 @@ interface Cookie {
   path?: string;
 }
 /**
- * Get stored cookies for a plugin
+ * Get stored cookies for the current plugin.
+ *
+ * The plugin's identity is automatically detected from the runtime context.
+ * Cookies are filtered by the domain declared in the plugin's manifest.json.
  *
- * @param pluginName - Name of the plugin
- * @param projectPath - Absolute path to the project directory
- * @returns Array of stored cookies
+ * **Must be called from within a plugin hook** (process, generate, deploy, syndicate).
+ *
+ * @returns Array of cookies for the plugin's registered domain
+ * @throws Error if called outside of a plugin hook execution
  *
  * @example
  * ```typescript
- * const cookies = await getPluginCookie("matters-syndicator", "/path/to/project");
+ * // Inside a hook function:
+ * const cookies = await getPluginCookie();
  * const token = cookies.find(c => c.name === "__access_token");
  * if (token) {
  *   // Use token for authenticated requests
  * }
  * ```
  */
-declare function getPluginCookie(pluginName: string, projectPath: string): Promise<Cookie[]>;
+declare function getPluginCookie(): Promise<Cookie[]>;
 /**
- * Store cookies for a plugin
+ * Store cookies for the current plugin.
+ *
+ * The plugin's identity is automatically detected from the runtime context.
+ *
+ * **Must be called from within a plugin hook** (process, generate, deploy, syndicate).
  *
- * @param pluginName - Name of the plugin
- * @param projectPath - Absolute path to the project directory
  * @param cookies - Array of cookies to store
+ * @throws Error if called outside of a plugin hook execution
  *
  * @example
  * ```typescript
- * await setPluginCookie("my-plugin", "/path/to/project", [
+ * // Inside a hook function:
+ * await setPluginCookie([
  *   { name: "session", value: "abc123" }
  * ]);
  * ```
  */
-declare function setPluginCookie(pluginName: string, projectPath: string, cookies: Cookie[]): Promise<void>;
+declare function setPluginCookie(cookies: Cookie[]): Promise<void>;
 //#endregion
-export { AfterDeployContext, ArticleInfo, BaseContext, BeforeBuildContext, CompleteMessage, Cookie, DeploymentInfo, DownloadOptions, DownloadResult, ErrorMessage, ExecuteOptions, ExecuteResult, FetchOptions, FetchResult, HookResult, LogMessage, OnBuildContext, OnDeployContext, PluginCategory, PluginManifest, PluginMessage, ProgressMessage, ProjectInfo, SourceFiles, TauriCore, closeBrowser, downloadAsset, error, executeBinary, fetchUrl, fileExists, getMessageContext, getPluginCookie, getTauriCore, isTauriAvailable, listFiles, log, openBrowser, readFile, reportComplete, reportError, reportProgress, sendMessage, setMessageContext, setPluginCookie, warn, writeFile };
+export { AfterDeployContext, ArticleInfo, BaseContext, BeforeBuildContext, CompleteMessage, Cookie, DeploymentInfo, DownloadOptions, DownloadResult, ErrorMessage, ExecuteOptions, ExecuteResult, FetchOptions, FetchResult, HookResult, LogMessage, OnBuildContext, OnDeployContext, PluginCategory, PluginManifest, PluginMessage, ProgressMessage, ProjectInfo, SourceFiles, TauriCore, closeBrowser, downloadAsset, error, executeBinary, fetchUrl, fileExists, getMessageContext, getPluginCookie, getTauriCore, isTauriAvailable, listFiles, listPluginFiles, log, openBrowser, pluginFileExists, readFile, readPluginFile, reportComplete, reportError, reportProgress, sendMessage, setMessageContext, setPluginCookie, warn, writeFile, writePluginFile };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/plugin.ts","../src/types/context.ts","../src/types/hooks.ts","../src/types/messages.ts","../src/utils/tauri.ts","../src/utils/messaging.ts","../src/utils/logger.ts","../src/utils/browser.ts","../src/utils/filesystem.ts","../src/utils/http.ts","../src/utils/binary.ts","../src/utils/cookies.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/plugin.ts","../src/types/context.ts","../src/types/hooks.ts","../src/types/messages.ts","../src/utils/tauri.ts","../src/utils/messaging.ts","../src/utils/logger.ts","../src/utils/browser.ts","../src/utils/filesystem.ts","../src/utils/plugin-storage.ts","../src/utils/http.ts","../src/utils/binary.ts","../src/utils/cookies.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -145,30 +145,57 @@ async function closeBrowser() {
 	await getTauriCore().invoke("close_plugin_browser", {});
 }
 
+//#endregion
+//#region src/utils/context.ts
+/**
+* Get the internal plugin context
+*
+* This is used internally by moss-api utilities to resolve paths
+* and plugin identity. Plugins should not call this directly.
+*
+* @returns The current plugin execution context
+* @throws Error if called outside of a plugin hook execution
+*
+* @internal
+*/
+function getInternalContext() {
+	const context = window.__MOSS_INTERNAL_CONTEXT__;
+	if (!context) throw new Error("This function must be called from within a plugin hook. Ensure you're calling this from process(), generate(), deploy(), or syndicate().");
+	return context;
+}
+
 //#endregion
 //#region src/utils/filesystem.ts
 /**
 * File system operations for Moss plugins
 *
-* These functions abstract away the underlying Tauri commands,
-* providing a clean API for plugins to read/write project files.
+* These functions provide access to project files (user content).
+* Project path is auto-detected from the runtime context.
+*
+* For plugin's private storage, use the plugin-storage API instead.
 */
 /**
 * Read a file from the project directory
 *
-* @param projectPath - Absolute path to the project directory
+* Project path is auto-detected from the runtime context.
+*
 * @param relativePath - Path relative to the project root
 * @returns File contents as a string
-* @throws Error if file cannot be read
+* @throws Error if file cannot be read or called outside a hook
 *
 * @example
 * ```typescript
-* const content = await readFile("/path/to/project", "src/index.ts");
+* // Read an article
+* const content = await readFile("article/hello-world.md");
+*
+* // Read package.json
+* const pkg = JSON.parse(await readFile("package.json"));
 * ```
 */
-async function readFile(projectPath, relativePath) {
+async function readFile(relativePath) {
+	const ctx = getInternalContext();
 	return getTauriCore().invoke("read_project_file", {
-		projectPath,
+		projectPath: ctx.project_path,
 		relativePath
 	});
 }
@@ -176,65 +203,190 @@ async function readFile(projectPath, relativePath) {
 * Write content to a file in the project directory
 *
 * Creates parent directories if they don't exist.
+* Project path is auto-detected from the runtime context.
 *
-* @param projectPath - Absolute path to the project directory
 * @param relativePath - Path relative to the project root
 * @param content - Content to write to the file
-* @throws Error if file cannot be written
+* @throws Error if file cannot be written or called outside a hook
 *
 * @example
 * ```typescript
-* await writeFile("/path/to/project", "output/result.md", "# Hello World");
+* // Write a generated article
+* await writeFile("article/new-post.md", "# Hello World\n\nContent here.");
+*
+* // Write index page
+* await writeFile("index.md", markdownContent);
 * ```
 */
-async function writeFile(projectPath, relativePath, content) {
+async function writeFile(relativePath, content) {
+	const ctx = getInternalContext();
 	await getTauriCore().invoke("write_project_file", {
-		projectPath,
+		projectPath: ctx.project_path,
 		relativePath,
 		data: content
 	});
 }
 /**
-* List all files in a project directory
+* List all files in the project directory
 *
 * Returns file paths relative to the project root.
+* Project path is auto-detected from the runtime context.
 *
-* @param projectPath - Absolute path to the project directory
 * @returns Array of relative file paths
-* @throws Error if directory cannot be listed
+* @throws Error if directory cannot be listed or called outside a hook
 *
 * @example
 * ```typescript
-* const files = await listFiles("/path/to/project");
-* // ["src/index.ts", "package.json", "README.md"]
+* const files = await listFiles();
+* // ["index.md", "article/hello.md", "assets/logo.png"]
+*
+* const mdFiles = files.filter(f => f.endsWith(".md"));
 * ```
 */
-async function listFiles(projectPath) {
-	return getTauriCore().invoke("list_project_files", { projectPath });
+async function listFiles() {
+	const ctx = getInternalContext();
+	return getTauriCore().invoke("list_project_files", { projectPath: ctx.project_path });
 }
 /**
 * Check if a file exists in the project directory
 *
-* @param projectPath - Absolute path to the project directory
+* Project path is auto-detected from the runtime context.
+*
 * @param relativePath - Path relative to the project root
 * @returns true if file exists, false otherwise
+* @throws Error if called outside a hook
 *
 * @example
 * ```typescript
-* if (await fileExists("/path/to/project", "config.json")) {
-*   // load config
+* if (await fileExists("index.md")) {
+*   const content = await readFile("index.md");
 * }
 * ```
 */
-async function fileExists(projectPath, relativePath) {
+async function fileExists(relativePath) {
+	getInternalContext();
 	try {
-		await readFile(projectPath, relativePath);
+		await readFile(relativePath);
 		return true;
 	} catch {
 		return false;
 	}
 }
 
+//#endregion
+//#region src/utils/plugin-storage.ts
+/**
+* Plugin storage API for Moss plugins
+*
+* Provides access to a plugin's private storage directory at:
+* .moss/plugins/{plugin-name}/
+*
+* Plugin identity is auto-detected from the runtime context -
+* plugins never need to know their own name or path.
+*
+* Config is just a file: readPluginFile("config.json")
+*/
+/**
+* Read a file from the plugin's private storage directory
+*
+* Storage path: .moss/plugins/{plugin-name}/{relativePath}
+*
+* @param relativePath - Path relative to the plugin's storage directory
+* @returns File contents as a string
+* @throws Error if file cannot be read or called outside a hook
+*
+* @example
+* ```typescript
+* // Read plugin config
+* const configJson = await readPluginFile("config.json");
+* const config = JSON.parse(configJson);
+*
+* // Read cached data
+* const cached = await readPluginFile("cache/articles.json");
+* ```
+*/
+async function readPluginFile(relativePath) {
+	const ctx = getInternalContext();
+	return getTauriCore().invoke("read_plugin_file", {
+		pluginName: ctx.plugin_name,
+		projectPath: ctx.project_path,
+		relativePath
+	});
+}
+/**
+* Write a file to the plugin's private storage directory
+*
+* Creates parent directories if they don't exist.
+* Storage path: .moss/plugins/{plugin-name}/{relativePath}
+*
+* @param relativePath - Path relative to the plugin's storage directory
+* @param content - Content to write to the file
+* @throws Error if file cannot be written or called outside a hook
+*
+* @example
+* ```typescript
+* // Save plugin config
+* await writePluginFile("config.json", JSON.stringify(config, null, 2));
+*
+* // Cache data
+* await writePluginFile("cache/articles.json", JSON.stringify(articles));
+* ```
+*/
+async function writePluginFile(relativePath, content) {
+	const ctx = getInternalContext();
+	await getTauriCore().invoke("write_plugin_file", {
+		pluginName: ctx.plugin_name,
+		projectPath: ctx.project_path,
+		relativePath,
+		content
+	});
+}
+/**
+* List all files in the plugin's private storage directory
+*
+* Returns file paths relative to the plugin's storage directory.
+*
+* @returns Array of relative file paths
+* @throws Error if directory cannot be listed or called outside a hook
+*
+* @example
+* ```typescript
+* const files = await listPluginFiles();
+* // ["config.json", "cache/articles.json", "cache/images.json"]
+* ```
+*/
+async function listPluginFiles() {
+	const ctx = getInternalContext();
+	return getTauriCore().invoke("list_plugin_files", {
+		pluginName: ctx.plugin_name,
+		projectPath: ctx.project_path
+	});
+}
+/**
+* Check if a file exists in the plugin's private storage directory
+*
+* @param relativePath - Path relative to the plugin's storage directory
+* @returns true if file exists, false otherwise
+* @throws Error if called outside a hook
+*
+* @example
+* ```typescript
+* if (await pluginFileExists("config.json")) {
+*   const config = JSON.parse(await readPluginFile("config.json"));
+* } else {
+*   // Use default config
+* }
+* ```
+*/
+async function pluginFileExists(relativePath) {
+	const ctx = getInternalContext();
+	return getTauriCore().invoke("plugin_file_exists", {
+		pluginName: ctx.plugin_name,
+		projectPath: ctx.project_path,
+		relativePath
+	});
+}
+
 //#endregion
 //#region src/utils/http.ts
 /**
@@ -242,6 +394,8 @@ async function fileExists(projectPath, relativePath) {
 *
 * These functions provide HTTP capabilities that bypass browser CORS
 * restrictions by using Rust's HTTP client under the hood.
+*
+* Project path for downloads is auto-detected from the runtime context.
 */
 /**
 * Fetch a URL using Rust's HTTP client (bypasses CORS)
@@ -285,18 +439,18 @@ async function fetchUrl(url, options = {}) {
 * the binary data through JavaScript. The filename is derived from
 * the URL, and file extension is inferred from Content-Type if needed.
 *
+* Project path is auto-detected from the runtime context.
+*
 * @param url - URL to download
-* @param projectPath - Absolute path to the project directory
 * @param targetDir - Target directory within project (e.g., "assets")
 * @param options - Optional download configuration
 * @returns Download result with actual path where file was saved
-* @throws Error if download or write fails
+* @throws Error if download or write fails, or called outside a hook
 *
 * @example
 * ```typescript
 * const result = await downloadAsset(
 *   "https://example.com/image",
-*   "/path/to/project",
 *   "assets"
 * );
 * if (result.ok) {
@@ -304,11 +458,12 @@ async function fetchUrl(url, options = {}) {
 * }
 * ```
 */
-async function downloadAsset(url, projectPath, targetDir, options = {}) {
+async function downloadAsset(url, targetDir, options = {}) {
+	const ctx = getInternalContext();
 	const { timeoutMs = 3e4 } = options;
 	const result = await getTauriCore().invoke("download_asset", {
 		url,
-		projectPath,
+		projectPath: ctx.project_path,
 		targetDir,
 		timeoutMs
 	});
@@ -328,13 +483,19 @@ async function downloadAsset(url, projectPath, targetDir, options = {}) {
 *
 * Allows plugins to execute external binaries (git, npm, etc.)
 * in a controlled environment.
+*
+* Working directory is auto-detected from the runtime context
+* (always the project root).
 */
 /**
 * Execute an external binary
 *
-* @param options - Execution options including binary path, args, and working directory
+* Working directory is auto-detected from the runtime context
+* (always the project root).
+*
+* @param options - Execution options including binary path and args
 * @returns Execution result with stdout, stderr, and exit code
-* @throws Error if binary cannot be executed
+* @throws Error if binary cannot be executed or called outside a hook
 *
 * @example
 * ```typescript
@@ -342,7 +503,6 @@ async function downloadAsset(url, projectPath, targetDir, options = {}) {
 * const result = await executeBinary({
 *   binaryPath: "git",
 *   args: ["status"],
-*   workingDir: "/path/to/repo",
 * });
 *
 * if (result.success) {
@@ -358,18 +518,18 @@ async function downloadAsset(url, projectPath, targetDir, options = {}) {
 * const result = await executeBinary({
 *   binaryPath: "npm",
 *   args: ["install"],
-*   workingDir: "/path/to/project",
 *   timeoutMs: 120000,
 *   env: { NODE_ENV: "production" },
 * });
 * ```
 */
 async function executeBinary(options) {
-	const { binaryPath, args, workingDir, timeoutMs = 6e4, env } = options;
+	const ctx = getInternalContext();
+	const { binaryPath, args, timeoutMs = 6e4, env } = options;
 	const result = await getTauriCore().invoke("execute_binary", {
 		binaryPath,
 		args,
-		workingDir,
+		workingDir: ctx.project_path,
 		timeoutMs,
 		env
 	});
@@ -388,51 +548,65 @@ async function executeBinary(options) {
 *
 * Allows plugins to store and retrieve authentication cookies
 * for external services (e.g., Matters.town, GitHub).
+*
+* Cookies are automatically scoped to the plugin's registered domain
+* (defined in manifest.json) - plugins cannot access other plugins' cookies.
 */
 /**
-* Get stored cookies for a plugin
+* Get stored cookies for the current plugin.
+*
+* The plugin's identity is automatically detected from the runtime context.
+* Cookies are filtered by the domain declared in the plugin's manifest.json.
+*
+* **Must be called from within a plugin hook** (process, generate, deploy, syndicate).
 *
-* @param pluginName - Name of the plugin
-* @param projectPath - Absolute path to the project directory
-* @returns Array of stored cookies
+* @returns Array of cookies for the plugin's registered domain
+* @throws Error if called outside of a plugin hook execution
 *
 * @example
 * ```typescript
-* const cookies = await getPluginCookie("matters-syndicator", "/path/to/project");
+* // Inside a hook function:
+* const cookies = await getPluginCookie();
 * const token = cookies.find(c => c.name === "__access_token");
 * if (token) {
 *   // Use token for authenticated requests
 * }
 * ```
 */
-async function getPluginCookie(pluginName, projectPath) {
+async function getPluginCookie() {
+	const ctx = getInternalContext();
 	return getTauriCore().invoke("get_plugin_cookie", {
-		pluginName,
-		projectPath
+		pluginName: ctx.plugin_name,
+		projectPath: ctx.project_path
 	});
 }
 /**
-* Store cookies for a plugin
+* Store cookies for the current plugin.
+*
+* The plugin's identity is automatically detected from the runtime context.
+*
+* **Must be called from within a plugin hook** (process, generate, deploy, syndicate).
 *
-* @param pluginName - Name of the plugin
-* @param projectPath - Absolute path to the project directory
 * @param cookies - Array of cookies to store
+* @throws Error if called outside of a plugin hook execution
 *
 * @example
 * ```typescript
-* await setPluginCookie("my-plugin", "/path/to/project", [
+* // Inside a hook function:
+* await setPluginCookie([
 *   { name: "session", value: "abc123" }
 * ]);
 * ```
 */
-async function setPluginCookie(pluginName, projectPath, cookies) {
+async function setPluginCookie(cookies) {
+	const ctx = getInternalContext();
 	await getTauriCore().invoke("set_plugin_cookie", {
-		pluginName,
-		projectPath,
+		pluginName: ctx.plugin_name,
+		projectPath: ctx.project_path,
 		cookies
 	});
 }
 
 //#endregion
-export { closeBrowser, downloadAsset, error, executeBinary, fetchUrl, fileExists, getMessageContext, getPluginCookie, getTauriCore, isTauriAvailable, listFiles, log, openBrowser, readFile, reportComplete, reportError, reportProgress, sendMessage, setMessageContext, setPluginCookie, warn, writeFile };
+export { closeBrowser, downloadAsset, error, executeBinary, fetchUrl, fileExists, getMessageContext, getPluginCookie, getTauriCore, isTauriAvailable, listFiles, listPluginFiles, log, openBrowser, pluginFileExists, readFile, readPluginFile, reportComplete, reportError, reportProgress, sendMessage, setMessageContext, setPluginCookie, warn, writeFile, writePluginFile };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/utils/tauri.ts","../src/utils/messaging.ts","../src/utils/logger.ts","../src/utils/browser.ts","../src/utils/filesystem.ts","../src/utils/http.ts","../src/utils/binary.ts","../src/utils/cookies.ts"],"sourcesContent":["/**\n * Tauri core utilities for plugin communication\n */\n\nexport interface TauriCore {\n  invoke: <T>(cmd: string, args?: Record<string, unknown>) => Promise<T>;\n}\n\ninterface TauriWindow {\n  __TAURI__?: {\n    core: TauriCore;\n  };\n}\n\n/**\n * Get the Tauri core API\n *\n * @deprecated Use higher-level APIs instead:\n * - File operations: `readFile`, `writeFile`, `listFiles`, `fileExists`\n * - HTTP: `fetchUrl`, `downloadAsset`\n * - Binary execution: `executeBinary`\n * - Cookies: `getPluginCookie`, `setPluginCookie`\n *\n * @throws Error if Tauri is not available\n */\nexport function getTauriCore(): TauriCore {\n  const w = window as unknown as TauriWindow;\n  if (!w.__TAURI__?.core) {\n    throw new Error(\"Tauri core not available\");\n  }\n  return w.__TAURI__.core;\n}\n\n/**\n * Check if Tauri is available\n */\nexport function isTauriAvailable(): boolean {\n  const w = window as unknown as TauriWindow;\n  return !!w.__TAURI__?.core;\n}\n","/**\n * Plugin messaging utilities for communicating with Moss\n */\n\nimport type { PluginMessage } from \"../types/messages\";\nimport { getTauriCore, isTauriAvailable } from \"./tauri\";\n\nlet currentPluginName = \"\";\nlet currentHookName = \"\";\n\n/**\n * Set the message context for subsequent messages\n * This is typically called automatically by the plugin runtime\n */\nexport function setMessageContext(pluginName: string, hookName: string): void {\n  currentPluginName = pluginName;\n  currentHookName = hookName;\n}\n\n/**\n * Get the current message context\n */\nexport function getMessageContext(): { pluginName: string; hookName: string } {\n  return { pluginName: currentPluginName, hookName: currentHookName };\n}\n\n/**\n * Send a message to Moss\n * Silently fails if Tauri is unavailable (useful for testing)\n */\nexport async function sendMessage(message: PluginMessage): Promise<void> {\n  if (!isTauriAvailable()) {\n    return;\n  }\n\n  try {\n    await getTauriCore().invoke(\"plugin_message\", {\n      pluginName: currentPluginName,\n      hookName: currentHookName,\n      message,\n    });\n  } catch {\n    // Silently fail - logging would be recursive\n  }\n}\n\n/**\n * Report progress to Moss\n */\nexport async function reportProgress(\n  phase: string,\n  current: number,\n  total: number,\n  message?: string\n): Promise<void> {\n  await sendMessage({ type: \"progress\", phase, current, total, message });\n}\n\n/**\n * Report an error to Moss\n */\nexport async function reportError(\n  error: string,\n  context?: string,\n  fatal = false\n): Promise<void> {\n  await sendMessage({ type: \"error\", error, context, fatal });\n}\n\n/**\n * Report completion to Moss\n */\nexport async function reportComplete(result: unknown): Promise<void> {\n  await sendMessage({ type: \"complete\", result });\n}\n","/**\n * Logging utilities for plugins\n */\n\nimport { sendMessage } from \"./messaging\";\n\n/**\n * Log an informational message\n */\nexport async function log(message: string): Promise<void> {\n  await sendMessage({ type: \"log\", level: \"log\", message });\n}\n\n/**\n * Log a warning message\n */\nexport async function warn(message: string): Promise<void> {\n  await sendMessage({ type: \"log\", level: \"warn\", message });\n}\n\n/**\n * Log an error message\n */\nexport async function error(message: string): Promise<void> {\n  await sendMessage({ type: \"log\", level: \"error\", message });\n}\n","/**\n * Browser utilities for plugins\n * Abstracts Tauri browser commands to decouple plugins from internal APIs\n */\n\nimport { getTauriCore } from \"./tauri\";\n\n/**\n * Open a URL in the plugin browser window\n */\nexport async function openBrowser(url: string): Promise<void> {\n  await getTauriCore().invoke(\"open_plugin_browser\", { url });\n}\n\n/**\n * Close the plugin browser window\n */\nexport async function closeBrowser(): Promise<void> {\n  await getTauriCore().invoke(\"close_plugin_browser\", {});\n}\n","/**\n * File system operations for Moss plugins\n *\n * These functions abstract away the underlying Tauri commands,\n * providing a clean API for plugins to read/write project files.\n */\n\nimport { getTauriCore } from \"./tauri\";\n\n/**\n * Read a file from the project directory\n *\n * @param projectPath - Absolute path to the project directory\n * @param relativePath - Path relative to the project root\n * @returns File contents as a string\n * @throws Error if file cannot be read\n *\n * @example\n * ```typescript\n * const content = await readFile(\"/path/to/project\", \"src/index.ts\");\n * ```\n */\nexport async function readFile(\n  projectPath: string,\n  relativePath: string\n): Promise<string> {\n  return getTauriCore().invoke<string>(\"read_project_file\", {\n    projectPath,\n    relativePath,\n  });\n}\n\n/**\n * Write content to a file in the project directory\n *\n * Creates parent directories if they don't exist.\n *\n * @param projectPath - Absolute path to the project directory\n * @param relativePath - Path relative to the project root\n * @param content - Content to write to the file\n * @throws Error if file cannot be written\n *\n * @example\n * ```typescript\n * await writeFile(\"/path/to/project\", \"output/result.md\", \"# Hello World\");\n * ```\n */\nexport async function writeFile(\n  projectPath: string,\n  relativePath: string,\n  content: string\n): Promise<void> {\n  await getTauriCore().invoke(\"write_project_file\", {\n    projectPath,\n    relativePath,\n    data: content,\n  });\n}\n\n/**\n * List all files in a project directory\n *\n * Returns file paths relative to the project root.\n *\n * @param projectPath - Absolute path to the project directory\n * @returns Array of relative file paths\n * @throws Error if directory cannot be listed\n *\n * @example\n * ```typescript\n * const files = await listFiles(\"/path/to/project\");\n * // [\"src/index.ts\", \"package.json\", \"README.md\"]\n * ```\n */\nexport async function listFiles(projectPath: string): Promise<string[]> {\n  return getTauriCore().invoke<string[]>(\"list_project_files\", {\n    projectPath,\n  });\n}\n\n/**\n * Check if a file exists in the project directory\n *\n * @param projectPath - Absolute path to the project directory\n * @param relativePath - Path relative to the project root\n * @returns true if file exists, false otherwise\n *\n * @example\n * ```typescript\n * if (await fileExists(\"/path/to/project\", \"config.json\")) {\n *   // load config\n * }\n * ```\n */\nexport async function fileExists(\n  projectPath: string,\n  relativePath: string\n): Promise<boolean> {\n  try {\n    await readFile(projectPath, relativePath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n","/**\n * HTTP operations for Moss plugins\n *\n * These functions provide HTTP capabilities that bypass browser CORS\n * restrictions by using Rust's HTTP client under the hood.\n */\n\nimport { getTauriCore } from \"./tauri\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Options for HTTP fetch requests\n */\nexport interface FetchOptions {\n  /** Timeout in milliseconds (default: 30000) */\n  timeoutMs?: number;\n}\n\n/**\n * Result from an HTTP fetch operation\n */\nexport interface FetchResult {\n  /** HTTP status code */\n  status: number;\n  /** Whether the request was successful (2xx status) */\n  ok: boolean;\n  /** Content-Type header from response */\n  contentType: string | null;\n  /** Response body as Uint8Array */\n  body: Uint8Array;\n  /** Get response body as text */\n  text(): string;\n}\n\n/**\n * Options for asset download\n */\nexport interface DownloadOptions {\n  /** Timeout in milliseconds (default: 30000) */\n  timeoutMs?: number;\n}\n\n/**\n * Result from an asset download operation\n */\nexport interface DownloadResult {\n  /** HTTP status code */\n  status: number;\n  /** Whether the request was successful (2xx status) */\n  ok: boolean;\n  /** Content-Type header from response */\n  contentType: string | null;\n  /** Number of bytes written to disk */\n  bytesWritten: number;\n  /** Actual path where file was saved (relative to project) */\n  actualPath: string;\n}\n\n// ============================================================================\n// Internal Types (Tauri response shapes)\n// ============================================================================\n\ninterface TauriFetchResult {\n  status: number;\n  ok: boolean;\n  body_base64: string;\n  content_type: string | null;\n}\n\ninterface TauriDownloadResult {\n  status: number;\n  ok: boolean;\n  content_type: string | null;\n  bytes_written: number;\n  actual_path: string;\n}\n\n// ============================================================================\n// Functions\n// ============================================================================\n\n/**\n * Fetch a URL using Rust's HTTP client (bypasses CORS)\n *\n * @param url - URL to fetch\n * @param options - Optional fetch configuration\n * @returns Fetch result with status, body, and helpers\n * @throws Error if network request fails\n *\n * @example\n * ```typescript\n * const result = await fetchUrl(\"https://api.example.com/data\");\n * if (result.ok) {\n *   const data = JSON.parse(result.text());\n * }\n * ```\n */\nexport async function fetchUrl(\n  url: string,\n  options: FetchOptions = {}\n): Promise<FetchResult> {\n  const { timeoutMs = 30000 } = options;\n\n  const result = await getTauriCore().invoke<TauriFetchResult>(\"fetch_url\", {\n    url,\n    timeoutMs,\n  });\n\n  // Decode base64 body to Uint8Array\n  const binaryString = atob(result.body_base64);\n  const bytes = new Uint8Array(binaryString.length);\n  for (let i = 0; i < binaryString.length; i++) {\n    bytes[i] = binaryString.charCodeAt(i);\n  }\n\n  return {\n    status: result.status,\n    ok: result.ok,\n    contentType: result.content_type,\n    body: bytes,\n    text(): string {\n      return new TextDecoder().decode(bytes);\n    },\n  };\n}\n\n/**\n * Download a URL and save directly to disk\n *\n * Downloads the file and writes it directly to disk without passing\n * the binary data through JavaScript. The filename is derived from\n * the URL, and file extension is inferred from Content-Type if needed.\n *\n * @param url - URL to download\n * @param projectPath - Absolute path to the project directory\n * @param targetDir - Target directory within project (e.g., \"assets\")\n * @param options - Optional download configuration\n * @returns Download result with actual path where file was saved\n * @throws Error if download or write fails\n *\n * @example\n * ```typescript\n * const result = await downloadAsset(\n *   \"https://example.com/image\",\n *   \"/path/to/project\",\n *   \"assets\"\n * );\n * if (result.ok) {\n *   console.log(`Saved to ${result.actualPath}`); // e.g., \"assets/image.png\"\n * }\n * ```\n */\nexport async function downloadAsset(\n  url: string,\n  projectPath: string,\n  targetDir: string,\n  options: DownloadOptions = {}\n): Promise<DownloadResult> {\n  const { timeoutMs = 30000 } = options;\n\n  const result = await getTauriCore().invoke<TauriDownloadResult>(\n    \"download_asset\",\n    {\n      url,\n      projectPath,\n      targetDir,\n      timeoutMs,\n    }\n  );\n\n  return {\n    status: result.status,\n    ok: result.ok,\n    contentType: result.content_type,\n    bytesWritten: result.bytes_written,\n    actualPath: result.actual_path,\n  };\n}\n","/**\n * Binary execution for Moss plugins\n *\n * Allows plugins to execute external binaries (git, npm, etc.)\n * in a controlled environment.\n */\n\nimport { getTauriCore } from \"./tauri\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Options for executing a binary\n */\nexport interface ExecuteOptions {\n  /** Path to the binary (can be just the name if in PATH) */\n  binaryPath: string;\n  /** Arguments to pass to the binary */\n  args: string[];\n  /** Working directory for execution */\n  workingDir: string;\n  /** Timeout in milliseconds (default: 60000) */\n  timeoutMs?: number;\n  /** Additional environment variables */\n  env?: Record<string, string>;\n}\n\n/**\n * Result from binary execution\n */\nexport interface ExecuteResult {\n  /** Whether the command succeeded (exit code 0) */\n  success: boolean;\n  /** Exit code from the process */\n  exitCode: number;\n  /** Standard output from the process */\n  stdout: string;\n  /** Standard error output from the process */\n  stderr: string;\n}\n\n// ============================================================================\n// Internal Types (Tauri response shape)\n// ============================================================================\n\ninterface TauriBinaryResult {\n  success: boolean;\n  exit_code: number;\n  stdout: string;\n  stderr: string;\n}\n\n// ============================================================================\n// Functions\n// ============================================================================\n\n/**\n * Execute an external binary\n *\n * @param options - Execution options including binary path, args, and working directory\n * @returns Execution result with stdout, stderr, and exit code\n * @throws Error if binary cannot be executed\n *\n * @example\n * ```typescript\n * // Run git status\n * const result = await executeBinary({\n *   binaryPath: \"git\",\n *   args: [\"status\"],\n *   workingDir: \"/path/to/repo\",\n * });\n *\n * if (result.success) {\n *   console.log(result.stdout);\n * } else {\n *   console.error(result.stderr);\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Run npm install with timeout\n * const result = await executeBinary({\n *   binaryPath: \"npm\",\n *   args: [\"install\"],\n *   workingDir: \"/path/to/project\",\n *   timeoutMs: 120000,\n *   env: { NODE_ENV: \"production\" },\n * });\n * ```\n */\nexport async function executeBinary(\n  options: ExecuteOptions\n): Promise<ExecuteResult> {\n  const { binaryPath, args, workingDir, timeoutMs = 60000, env } = options;\n\n  const result = await getTauriCore().invoke<TauriBinaryResult>(\n    \"execute_binary\",\n    {\n      binaryPath,\n      args,\n      workingDir,\n      timeoutMs,\n      env,\n    }\n  );\n\n  return {\n    success: result.success,\n    exitCode: result.exit_code,\n    stdout: result.stdout,\n    stderr: result.stderr,\n  };\n}\n","/**\n * Cookie management for Moss plugins\n *\n * Allows plugins to store and retrieve authentication cookies\n * for external services (e.g., Matters.town, GitHub).\n */\n\nimport { getTauriCore } from \"./tauri\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * A cookie stored for plugin authentication\n */\nexport interface Cookie {\n  /** Cookie name */\n  name: string;\n  /** Cookie value */\n  value: string;\n  /** Optional domain for the cookie */\n  domain?: string;\n  /** Optional path for the cookie */\n  path?: string;\n}\n\n// ============================================================================\n// Functions\n// ============================================================================\n\n/**\n * Get stored cookies for a plugin\n *\n * @param pluginName - Name of the plugin\n * @param projectPath - Absolute path to the project directory\n * @returns Array of stored cookies\n *\n * @example\n * ```typescript\n * const cookies = await getPluginCookie(\"matters-syndicator\", \"/path/to/project\");\n * const token = cookies.find(c => c.name === \"__access_token\");\n * if (token) {\n *   // Use token for authenticated requests\n * }\n * ```\n */\nexport async function getPluginCookie(\n  pluginName: string,\n  projectPath: string\n): Promise<Cookie[]> {\n  return getTauriCore().invoke<Cookie[]>(\"get_plugin_cookie\", {\n    pluginName,\n    projectPath,\n  });\n}\n\n/**\n * Store cookies for a plugin\n *\n * @param pluginName - Name of the plugin\n * @param projectPath - Absolute path to the project directory\n * @param cookies - Array of cookies to store\n *\n * @example\n * ```typescript\n * await setPluginCookie(\"my-plugin\", \"/path/to/project\", [\n *   { name: \"session\", value: \"abc123\" }\n * ]);\n * ```\n */\nexport async function setPluginCookie(\n  pluginName: string,\n  projectPath: string,\n  cookies: Cookie[]\n): Promise<void> {\n  await getTauriCore().invoke(\"set_plugin_cookie\", {\n    pluginName,\n    projectPath,\n    cookies,\n  });\n}\n"],"mappings":";;;;;;;;;;;;AAyBA,SAAgB,eAA0B;CACxC,MAAM,IAAI;AACV,KAAI,CAAC,EAAE,WAAW,KAChB,OAAM,IAAI,MAAM,2BAA2B;AAE7C,QAAO,EAAE,UAAU;;;;;AAMrB,SAAgB,mBAA4B;AAE1C,QAAO,CAAC,CADE,OACC,WAAW;;;;;AC/BxB,IAAI,oBAAoB;AACxB,IAAI,kBAAkB;;;;;AAMtB,SAAgB,kBAAkB,YAAoB,UAAwB;AAC5E,qBAAoB;AACpB,mBAAkB;;;;;AAMpB,SAAgB,oBAA8D;AAC5E,QAAO;EAAE,YAAY;EAAmB,UAAU;EAAiB;;;;;;AAOrE,eAAsB,YAAY,SAAuC;AACvE,KAAI,CAAC,kBAAkB,CACrB;AAGF,KAAI;AACF,QAAM,cAAc,CAAC,OAAO,kBAAkB;GAC5C,YAAY;GACZ,UAAU;GACV;GACD,CAAC;SACI;;;;;AAQV,eAAsB,eACpB,OACA,SACA,OACA,SACe;AACf,OAAM,YAAY;EAAE,MAAM;EAAY;EAAO;EAAS;EAAO;EAAS,CAAC;;;;;AAMzE,eAAsB,YACpB,SACA,SACA,QAAQ,OACO;AACf,OAAM,YAAY;EAAE,MAAM;EAAS;EAAO;EAAS;EAAO,CAAC;;;;;AAM7D,eAAsB,eAAe,QAAgC;AACnE,OAAM,YAAY;EAAE,MAAM;EAAY;EAAQ,CAAC;;;;;;;;;;;AChEjD,eAAsB,IAAI,SAAgC;AACxD,OAAM,YAAY;EAAE,MAAM;EAAO,OAAO;EAAO;EAAS,CAAC;;;;;AAM3D,eAAsB,KAAK,SAAgC;AACzD,OAAM,YAAY;EAAE,MAAM;EAAO,OAAO;EAAQ;EAAS,CAAC;;;;;AAM5D,eAAsB,MAAM,SAAgC;AAC1D,OAAM,YAAY;EAAE,MAAM;EAAO,OAAO;EAAS;EAAS,CAAC;;;;;;;;;;;;ACd7D,eAAsB,YAAY,KAA4B;AAC5D,OAAM,cAAc,CAAC,OAAO,uBAAuB,EAAE,KAAK,CAAC;;;;;AAM7D,eAAsB,eAA8B;AAClD,OAAM,cAAc,CAAC,OAAO,wBAAwB,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;ACIzD,eAAsB,SACpB,aACA,cACiB;AACjB,QAAO,cAAc,CAAC,OAAe,qBAAqB;EACxD;EACA;EACD,CAAC;;;;;;;;;;;;;;;;;AAkBJ,eAAsB,UACpB,aACA,cACA,SACe;AACf,OAAM,cAAc,CAAC,OAAO,sBAAsB;EAChD;EACA;EACA,MAAM;EACP,CAAC;;;;;;;;;;;;;;;;;AAkBJ,eAAsB,UAAU,aAAwC;AACtE,QAAO,cAAc,CAAC,OAAiB,sBAAsB,EAC3D,aACD,CAAC;;;;;;;;;;;;;;;;AAiBJ,eAAsB,WACpB,aACA,cACkB;AAClB,KAAI;AACF,QAAM,SAAS,aAAa,aAAa;AACzC,SAAO;SACD;AACN,SAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACFX,eAAsB,SACpB,KACA,UAAwB,EAAE,EACJ;CACtB,MAAM,EAAE,YAAY,QAAU;CAE9B,MAAM,SAAS,MAAM,cAAc,CAAC,OAAyB,aAAa;EACxE;EACA;EACD,CAAC;CAGF,MAAM,eAAe,KAAK,OAAO,YAAY;CAC7C,MAAM,QAAQ,IAAI,WAAW,aAAa,OAAO;AACjD,MAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,IACvC,OAAM,KAAK,aAAa,WAAW,EAAE;AAGvC,QAAO;EACL,QAAQ,OAAO;EACf,IAAI,OAAO;EACX,aAAa,OAAO;EACpB,MAAM;EACN,OAAe;AACb,UAAO,IAAI,aAAa,CAAC,OAAO,MAAM;;EAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BH,eAAsB,cACpB,KACA,aACA,WACA,UAA2B,EAAE,EACJ;CACzB,MAAM,EAAE,YAAY,QAAU;CAE9B,MAAM,SAAS,MAAM,cAAc,CAAC,OAClC,kBACA;EACE;EACA;EACA;EACA;EACD,CACF;AAED,QAAO;EACL,QAAQ,OAAO;EACf,IAAI,OAAO;EACX,aAAa,OAAO;EACpB,cAAc,OAAO;EACrB,YAAY,OAAO;EACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACtFH,eAAsB,cACpB,SACwB;CACxB,MAAM,EAAE,YAAY,MAAM,YAAY,YAAY,KAAO,QAAQ;CAEjE,MAAM,SAAS,MAAM,cAAc,CAAC,OAClC,kBACA;EACE;EACA;EACA;EACA;EACA;EACD,CACF;AAED,QAAO;EACL,SAAS,OAAO;EAChB,UAAU,OAAO;EACjB,QAAQ,OAAO;EACf,QAAQ,OAAO;EAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;ACnEH,eAAsB,gBACpB,YACA,aACmB;AACnB,QAAO,cAAc,CAAC,OAAiB,qBAAqB;EAC1D;EACA;EACD,CAAC;;;;;;;;;;;;;;;;AAiBJ,eAAsB,gBACpB,YACA,aACA,SACe;AACf,OAAM,cAAc,CAAC,OAAO,qBAAqB;EAC/C;EACA;EACA;EACD,CAAC"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/utils/tauri.ts","../src/utils/messaging.ts","../src/utils/logger.ts","../src/utils/browser.ts","../src/utils/context.ts","../src/utils/filesystem.ts","../src/utils/plugin-storage.ts","../src/utils/http.ts","../src/utils/binary.ts","../src/utils/cookies.ts"],"sourcesContent":["/**\n * Tauri core utilities for plugin communication\n */\n\nexport interface TauriCore {\n  invoke: <T>(cmd: string, args?: Record<string, unknown>) => Promise<T>;\n}\n\ninterface TauriWindow {\n  __TAURI__?: {\n    core: TauriCore;\n  };\n}\n\n/**\n * Get the Tauri core API\n *\n * @deprecated Use higher-level APIs instead:\n * - File operations: `readFile`, `writeFile`, `listFiles`, `fileExists`\n * - HTTP: `fetchUrl`, `downloadAsset`\n * - Binary execution: `executeBinary`\n * - Cookies: `getPluginCookie`, `setPluginCookie`\n *\n * @throws Error if Tauri is not available\n */\nexport function getTauriCore(): TauriCore {\n  const w = window as unknown as TauriWindow;\n  if (!w.__TAURI__?.core) {\n    throw new Error(\"Tauri core not available\");\n  }\n  return w.__TAURI__.core;\n}\n\n/**\n * Check if Tauri is available\n */\nexport function isTauriAvailable(): boolean {\n  const w = window as unknown as TauriWindow;\n  return !!w.__TAURI__?.core;\n}\n","/**\n * Plugin messaging utilities for communicating with Moss\n */\n\nimport type { PluginMessage } from \"../types/messages\";\nimport { getTauriCore, isTauriAvailable } from \"./tauri\";\n\nlet currentPluginName = \"\";\nlet currentHookName = \"\";\n\n/**\n * Set the message context for subsequent messages\n * This is typically called automatically by the plugin runtime\n */\nexport function setMessageContext(pluginName: string, hookName: string): void {\n  currentPluginName = pluginName;\n  currentHookName = hookName;\n}\n\n/**\n * Get the current message context\n */\nexport function getMessageContext(): { pluginName: string; hookName: string } {\n  return { pluginName: currentPluginName, hookName: currentHookName };\n}\n\n/**\n * Send a message to Moss\n * Silently fails if Tauri is unavailable (useful for testing)\n */\nexport async function sendMessage(message: PluginMessage): Promise<void> {\n  if (!isTauriAvailable()) {\n    return;\n  }\n\n  try {\n    await getTauriCore().invoke(\"plugin_message\", {\n      pluginName: currentPluginName,\n      hookName: currentHookName,\n      message,\n    });\n  } catch {\n    // Silently fail - logging would be recursive\n  }\n}\n\n/**\n * Report progress to Moss\n */\nexport async function reportProgress(\n  phase: string,\n  current: number,\n  total: number,\n  message?: string\n): Promise<void> {\n  await sendMessage({ type: \"progress\", phase, current, total, message });\n}\n\n/**\n * Report an error to Moss\n */\nexport async function reportError(\n  error: string,\n  context?: string,\n  fatal = false\n): Promise<void> {\n  await sendMessage({ type: \"error\", error, context, fatal });\n}\n\n/**\n * Report completion to Moss\n */\nexport async function reportComplete(result: unknown): Promise<void> {\n  await sendMessage({ type: \"complete\", result });\n}\n","/**\n * Logging utilities for plugins\n */\n\nimport { sendMessage } from \"./messaging\";\n\n/**\n * Log an informational message\n */\nexport async function log(message: string): Promise<void> {\n  await sendMessage({ type: \"log\", level: \"log\", message });\n}\n\n/**\n * Log a warning message\n */\nexport async function warn(message: string): Promise<void> {\n  await sendMessage({ type: \"log\", level: \"warn\", message });\n}\n\n/**\n * Log an error message\n */\nexport async function error(message: string): Promise<void> {\n  await sendMessage({ type: \"log\", level: \"error\", message });\n}\n","/**\n * Browser utilities for plugins\n * Abstracts Tauri browser commands to decouple plugins from internal APIs\n */\n\nimport { getTauriCore } from \"./tauri\";\n\n/**\n * Open a URL in the plugin browser window\n */\nexport async function openBrowser(url: string): Promise<void> {\n  await getTauriCore().invoke(\"open_plugin_browser\", { url });\n}\n\n/**\n * Close the plugin browser window\n */\nexport async function closeBrowser(): Promise<void> {\n  await getTauriCore().invoke(\"close_plugin_browser\", {});\n}\n","/**\n * Internal context utilities for Moss plugins\n *\n * This module provides access to the plugin execution context that is\n * set by the plugin runtime before each hook execution.\n *\n * INTERNAL USE ONLY - not exported to plugins.\n * Plugins should use the higher-level APIs (readFile, writeFile, etc.)\n * which use this context internally.\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Internal plugin execution context\n *\n * Set by the plugin runtime (window.__MOSS_INTERNAL_CONTEXT__)\n * before each hook execution. Cleared after hook completes.\n */\nexport interface InternalPluginContext {\n  /** Plugin name from manifest */\n  plugin_name: string;\n  /** Absolute path to the project directory */\n  project_path: string;\n  /** Absolute path to the .moss directory */\n  moss_dir: string;\n}\n\n/**\n * Window interface with internal context\n */\ninterface ContextWindow {\n  __MOSS_INTERNAL_CONTEXT__?: InternalPluginContext;\n}\n\n// ============================================================================\n// Functions\n// ============================================================================\n\n/**\n * Get the internal plugin context\n *\n * This is used internally by moss-api utilities to resolve paths\n * and plugin identity. Plugins should not call this directly.\n *\n * @returns The current plugin execution context\n * @throws Error if called outside of a plugin hook execution\n *\n * @internal\n */\nexport function getInternalContext(): InternalPluginContext {\n  const context = (window as unknown as ContextWindow).__MOSS_INTERNAL_CONTEXT__;\n\n  if (!context) {\n    throw new Error(\n      \"This function must be called from within a plugin hook. \" +\n        \"Ensure you're calling this from process(), generate(), deploy(), or syndicate().\"\n    );\n  }\n\n  return context;\n}\n\n/**\n * Check if we're currently inside a plugin hook execution\n *\n * @returns true if inside a hook, false otherwise\n *\n * @internal\n */\nexport function hasContext(): boolean {\n  const context = (window as unknown as ContextWindow).__MOSS_INTERNAL_CONTEXT__;\n  return context !== undefined;\n}\n","/**\n * File system operations for Moss plugins\n *\n * These functions provide access to project files (user content).\n * Project path is auto-detected from the runtime context.\n *\n * For plugin's private storage, use the plugin-storage API instead.\n */\n\nimport { getTauriCore } from \"./tauri\";\nimport { getInternalContext } from \"./context\";\n\n// ============================================================================\n// Functions\n// ============================================================================\n\n/**\n * Read a file from the project directory\n *\n * Project path is auto-detected from the runtime context.\n *\n * @param relativePath - Path relative to the project root\n * @returns File contents as a string\n * @throws Error if file cannot be read or called outside a hook\n *\n * @example\n * ```typescript\n * // Read an article\n * const content = await readFile(\"article/hello-world.md\");\n *\n * // Read package.json\n * const pkg = JSON.parse(await readFile(\"package.json\"));\n * ```\n */\nexport async function readFile(relativePath: string): Promise<string> {\n  const ctx = getInternalContext();\n\n  return getTauriCore().invoke<string>(\"read_project_file\", {\n    projectPath: ctx.project_path,\n    relativePath,\n  });\n}\n\n/**\n * Write content to a file in the project directory\n *\n * Creates parent directories if they don't exist.\n * Project path is auto-detected from the runtime context.\n *\n * @param relativePath - Path relative to the project root\n * @param content - Content to write to the file\n * @throws Error if file cannot be written or called outside a hook\n *\n * @example\n * ```typescript\n * // Write a generated article\n * await writeFile(\"article/new-post.md\", \"# Hello World\\n\\nContent here.\");\n *\n * // Write index page\n * await writeFile(\"index.md\", markdownContent);\n * ```\n */\nexport async function writeFile(\n  relativePath: string,\n  content: string\n): Promise<void> {\n  const ctx = getInternalContext();\n\n  await getTauriCore().invoke(\"write_project_file\", {\n    projectPath: ctx.project_path,\n    relativePath,\n    data: content,\n  });\n}\n\n/**\n * List all files in the project directory\n *\n * Returns file paths relative to the project root.\n * Project path is auto-detected from the runtime context.\n *\n * @returns Array of relative file paths\n * @throws Error if directory cannot be listed or called outside a hook\n *\n * @example\n * ```typescript\n * const files = await listFiles();\n * // [\"index.md\", \"article/hello.md\", \"assets/logo.png\"]\n *\n * const mdFiles = files.filter(f => f.endsWith(\".md\"));\n * ```\n */\nexport async function listFiles(): Promise<string[]> {\n  const ctx = getInternalContext();\n\n  return getTauriCore().invoke<string[]>(\"list_project_files\", {\n    projectPath: ctx.project_path,\n  });\n}\n\n/**\n * Check if a file exists in the project directory\n *\n * Project path is auto-detected from the runtime context.\n *\n * @param relativePath - Path relative to the project root\n * @returns true if file exists, false otherwise\n * @throws Error if called outside a hook\n *\n * @example\n * ```typescript\n * if (await fileExists(\"index.md\")) {\n *   const content = await readFile(\"index.md\");\n * }\n * ```\n */\nexport async function fileExists(relativePath: string): Promise<boolean> {\n  // First, verify we have context (this will throw if not in a hook)\n  getInternalContext();\n\n  try {\n    await readFile(relativePath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n","/**\n * Plugin storage API for Moss plugins\n *\n * Provides access to a plugin's private storage directory at:\n * .moss/plugins/{plugin-name}/\n *\n * Plugin identity is auto-detected from the runtime context -\n * plugins never need to know their own name or path.\n *\n * Config is just a file: readPluginFile(\"config.json\")\n */\n\nimport { getTauriCore } from \"./tauri\";\nimport { getInternalContext } from \"./context\";\n\n// ============================================================================\n// Functions\n// ============================================================================\n\n/**\n * Read a file from the plugin's private storage directory\n *\n * Storage path: .moss/plugins/{plugin-name}/{relativePath}\n *\n * @param relativePath - Path relative to the plugin's storage directory\n * @returns File contents as a string\n * @throws Error if file cannot be read or called outside a hook\n *\n * @example\n * ```typescript\n * // Read plugin config\n * const configJson = await readPluginFile(\"config.json\");\n * const config = JSON.parse(configJson);\n *\n * // Read cached data\n * const cached = await readPluginFile(\"cache/articles.json\");\n * ```\n */\nexport async function readPluginFile(relativePath: string): Promise<string> {\n  const ctx = getInternalContext();\n\n  return getTauriCore().invoke<string>(\"read_plugin_file\", {\n    pluginName: ctx.plugin_name,\n    projectPath: ctx.project_path,\n    relativePath,\n  });\n}\n\n/**\n * Write a file to the plugin's private storage directory\n *\n * Creates parent directories if they don't exist.\n * Storage path: .moss/plugins/{plugin-name}/{relativePath}\n *\n * @param relativePath - Path relative to the plugin's storage directory\n * @param content - Content to write to the file\n * @throws Error if file cannot be written or called outside a hook\n *\n * @example\n * ```typescript\n * // Save plugin config\n * await writePluginFile(\"config.json\", JSON.stringify(config, null, 2));\n *\n * // Cache data\n * await writePluginFile(\"cache/articles.json\", JSON.stringify(articles));\n * ```\n */\nexport async function writePluginFile(\n  relativePath: string,\n  content: string\n): Promise<void> {\n  const ctx = getInternalContext();\n\n  await getTauriCore().invoke(\"write_plugin_file\", {\n    pluginName: ctx.plugin_name,\n    projectPath: ctx.project_path,\n    relativePath,\n    content,\n  });\n}\n\n/**\n * List all files in the plugin's private storage directory\n *\n * Returns file paths relative to the plugin's storage directory.\n *\n * @returns Array of relative file paths\n * @throws Error if directory cannot be listed or called outside a hook\n *\n * @example\n * ```typescript\n * const files = await listPluginFiles();\n * // [\"config.json\", \"cache/articles.json\", \"cache/images.json\"]\n * ```\n */\nexport async function listPluginFiles(): Promise<string[]> {\n  const ctx = getInternalContext();\n\n  return getTauriCore().invoke<string[]>(\"list_plugin_files\", {\n    pluginName: ctx.plugin_name,\n    projectPath: ctx.project_path,\n  });\n}\n\n/**\n * Check if a file exists in the plugin's private storage directory\n *\n * @param relativePath - Path relative to the plugin's storage directory\n * @returns true if file exists, false otherwise\n * @throws Error if called outside a hook\n *\n * @example\n * ```typescript\n * if (await pluginFileExists(\"config.json\")) {\n *   const config = JSON.parse(await readPluginFile(\"config.json\"));\n * } else {\n *   // Use default config\n * }\n * ```\n */\nexport async function pluginFileExists(relativePath: string): Promise<boolean> {\n  const ctx = getInternalContext();\n\n  return getTauriCore().invoke<boolean>(\"plugin_file_exists\", {\n    pluginName: ctx.plugin_name,\n    projectPath: ctx.project_path,\n    relativePath,\n  });\n}\n","/**\n * HTTP operations for Moss plugins\n *\n * These functions provide HTTP capabilities that bypass browser CORS\n * restrictions by using Rust's HTTP client under the hood.\n *\n * Project path for downloads is auto-detected from the runtime context.\n */\n\nimport { getTauriCore } from \"./tauri\";\nimport { getInternalContext } from \"./context\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Options for HTTP fetch requests\n */\nexport interface FetchOptions {\n  /** Timeout in milliseconds (default: 30000) */\n  timeoutMs?: number;\n}\n\n/**\n * Result from an HTTP fetch operation\n */\nexport interface FetchResult {\n  /** HTTP status code */\n  status: number;\n  /** Whether the request was successful (2xx status) */\n  ok: boolean;\n  /** Content-Type header from response */\n  contentType: string | null;\n  /** Response body as Uint8Array */\n  body: Uint8Array;\n  /** Get response body as text */\n  text(): string;\n}\n\n/**\n * Options for asset download\n */\nexport interface DownloadOptions {\n  /** Timeout in milliseconds (default: 30000) */\n  timeoutMs?: number;\n}\n\n/**\n * Result from an asset download operation\n */\nexport interface DownloadResult {\n  /** HTTP status code */\n  status: number;\n  /** Whether the request was successful (2xx status) */\n  ok: boolean;\n  /** Content-Type header from response */\n  contentType: string | null;\n  /** Number of bytes written to disk */\n  bytesWritten: number;\n  /** Actual path where file was saved (relative to project) */\n  actualPath: string;\n}\n\n// ============================================================================\n// Internal Types (Tauri response shapes)\n// ============================================================================\n\ninterface TauriFetchResult {\n  status: number;\n  ok: boolean;\n  body_base64: string;\n  content_type: string | null;\n}\n\ninterface TauriDownloadResult {\n  status: number;\n  ok: boolean;\n  content_type: string | null;\n  bytes_written: number;\n  actual_path: string;\n}\n\n// ============================================================================\n// Functions\n// ============================================================================\n\n/**\n * Fetch a URL using Rust's HTTP client (bypasses CORS)\n *\n * @param url - URL to fetch\n * @param options - Optional fetch configuration\n * @returns Fetch result with status, body, and helpers\n * @throws Error if network request fails\n *\n * @example\n * ```typescript\n * const result = await fetchUrl(\"https://api.example.com/data\");\n * if (result.ok) {\n *   const data = JSON.parse(result.text());\n * }\n * ```\n */\nexport async function fetchUrl(\n  url: string,\n  options: FetchOptions = {}\n): Promise<FetchResult> {\n  const { timeoutMs = 30000 } = options;\n\n  const result = await getTauriCore().invoke<TauriFetchResult>(\"fetch_url\", {\n    url,\n    timeoutMs,\n  });\n\n  // Decode base64 body to Uint8Array\n  const binaryString = atob(result.body_base64);\n  const bytes = new Uint8Array(binaryString.length);\n  for (let i = 0; i < binaryString.length; i++) {\n    bytes[i] = binaryString.charCodeAt(i);\n  }\n\n  return {\n    status: result.status,\n    ok: result.ok,\n    contentType: result.content_type,\n    body: bytes,\n    text(): string {\n      return new TextDecoder().decode(bytes);\n    },\n  };\n}\n\n/**\n * Download a URL and save directly to disk\n *\n * Downloads the file and writes it directly to disk without passing\n * the binary data through JavaScript. The filename is derived from\n * the URL, and file extension is inferred from Content-Type if needed.\n *\n * Project path is auto-detected from the runtime context.\n *\n * @param url - URL to download\n * @param targetDir - Target directory within project (e.g., \"assets\")\n * @param options - Optional download configuration\n * @returns Download result with actual path where file was saved\n * @throws Error if download or write fails, or called outside a hook\n *\n * @example\n * ```typescript\n * const result = await downloadAsset(\n *   \"https://example.com/image\",\n *   \"assets\"\n * );\n * if (result.ok) {\n *   console.log(`Saved to ${result.actualPath}`); // e.g., \"assets/image.png\"\n * }\n * ```\n */\nexport async function downloadAsset(\n  url: string,\n  targetDir: string,\n  options: DownloadOptions = {}\n): Promise<DownloadResult> {\n  const ctx = getInternalContext();\n  const { timeoutMs = 30000 } = options;\n\n  const result = await getTauriCore().invoke<TauriDownloadResult>(\n    \"download_asset\",\n    {\n      url,\n      projectPath: ctx.project_path,\n      targetDir,\n      timeoutMs,\n    }\n  );\n\n  return {\n    status: result.status,\n    ok: result.ok,\n    contentType: result.content_type,\n    bytesWritten: result.bytes_written,\n    actualPath: result.actual_path,\n  };\n}\n","/**\n * Binary execution for Moss plugins\n *\n * Allows plugins to execute external binaries (git, npm, etc.)\n * in a controlled environment.\n *\n * Working directory is auto-detected from the runtime context\n * (always the project root).\n */\n\nimport { getTauriCore } from \"./tauri\";\nimport { getInternalContext } from \"./context\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Options for executing a binary\n */\nexport interface ExecuteOptions {\n  /** Path to the binary (can be just the name if in PATH) */\n  binaryPath: string;\n  /** Arguments to pass to the binary */\n  args: string[];\n  /** Timeout in milliseconds (default: 60000) */\n  timeoutMs?: number;\n  /** Additional environment variables */\n  env?: Record<string, string>;\n}\n\n/**\n * Result from binary execution\n */\nexport interface ExecuteResult {\n  /** Whether the command succeeded (exit code 0) */\n  success: boolean;\n  /** Exit code from the process */\n  exitCode: number;\n  /** Standard output from the process */\n  stdout: string;\n  /** Standard error output from the process */\n  stderr: string;\n}\n\n// ============================================================================\n// Internal Types (Tauri response shape)\n// ============================================================================\n\ninterface TauriBinaryResult {\n  success: boolean;\n  exit_code: number;\n  stdout: string;\n  stderr: string;\n}\n\n// ============================================================================\n// Functions\n// ============================================================================\n\n/**\n * Execute an external binary\n *\n * Working directory is auto-detected from the runtime context\n * (always the project root).\n *\n * @param options - Execution options including binary path and args\n * @returns Execution result with stdout, stderr, and exit code\n * @throws Error if binary cannot be executed or called outside a hook\n *\n * @example\n * ```typescript\n * // Run git status\n * const result = await executeBinary({\n *   binaryPath: \"git\",\n *   args: [\"status\"],\n * });\n *\n * if (result.success) {\n *   console.log(result.stdout);\n * } else {\n *   console.error(result.stderr);\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Run npm install with timeout\n * const result = await executeBinary({\n *   binaryPath: \"npm\",\n *   args: [\"install\"],\n *   timeoutMs: 120000,\n *   env: { NODE_ENV: \"production\" },\n * });\n * ```\n */\nexport async function executeBinary(\n  options: ExecuteOptions\n): Promise<ExecuteResult> {\n  const ctx = getInternalContext();\n  const { binaryPath, args, timeoutMs = 60000, env } = options;\n\n  const result = await getTauriCore().invoke<TauriBinaryResult>(\n    \"execute_binary\",\n    {\n      binaryPath,\n      args,\n      workingDir: ctx.project_path,\n      timeoutMs,\n      env,\n    }\n  );\n\n  return {\n    success: result.success,\n    exitCode: result.exit_code,\n    stdout: result.stdout,\n    stderr: result.stderr,\n  };\n}\n","/**\n * Cookie management for Moss plugins\n *\n * Allows plugins to store and retrieve authentication cookies\n * for external services (e.g., Matters.town, GitHub).\n *\n * Cookies are automatically scoped to the plugin's registered domain\n * (defined in manifest.json) - plugins cannot access other plugins' cookies.\n */\n\nimport { getTauriCore } from \"./tauri\";\nimport { getInternalContext } from \"./context\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * A cookie stored for plugin authentication\n */\nexport interface Cookie {\n  /** Cookie name */\n  name: string;\n  /** Cookie value */\n  value: string;\n  /** Optional domain for the cookie */\n  domain?: string;\n  /** Optional path for the cookie */\n  path?: string;\n}\n\n// ============================================================================\n// Functions\n// ============================================================================\n\n/**\n * Get stored cookies for the current plugin.\n *\n * The plugin's identity is automatically detected from the runtime context.\n * Cookies are filtered by the domain declared in the plugin's manifest.json.\n *\n * **Must be called from within a plugin hook** (process, generate, deploy, syndicate).\n *\n * @returns Array of cookies for the plugin's registered domain\n * @throws Error if called outside of a plugin hook execution\n *\n * @example\n * ```typescript\n * // Inside a hook function:\n * const cookies = await getPluginCookie();\n * const token = cookies.find(c => c.name === \"__access_token\");\n * if (token) {\n *   // Use token for authenticated requests\n * }\n * ```\n */\nexport async function getPluginCookie(): Promise<Cookie[]> {\n  const ctx = getInternalContext();\n\n  return getTauriCore().invoke<Cookie[]>(\"get_plugin_cookie\", {\n    pluginName: ctx.plugin_name,\n    projectPath: ctx.project_path,\n  });\n}\n\n/**\n * Store cookies for the current plugin.\n *\n * The plugin's identity is automatically detected from the runtime context.\n *\n * **Must be called from within a plugin hook** (process, generate, deploy, syndicate).\n *\n * @param cookies - Array of cookies to store\n * @throws Error if called outside of a plugin hook execution\n *\n * @example\n * ```typescript\n * // Inside a hook function:\n * await setPluginCookie([\n *   { name: \"session\", value: \"abc123\" }\n * ]);\n * ```\n */\nexport async function setPluginCookie(cookies: Cookie[]): Promise<void> {\n  const ctx = getInternalContext();\n\n  await getTauriCore().invoke(\"set_plugin_cookie\", {\n    pluginName: ctx.plugin_name,\n    projectPath: ctx.project_path,\n    cookies,\n  });\n}\n"],"mappings":";;;;;;;;;;;;AAyBA,SAAgB,eAA0B;CACxC,MAAM,IAAI;AACV,KAAI,CAAC,EAAE,WAAW,KAChB,OAAM,IAAI,MAAM,2BAA2B;AAE7C,QAAO,EAAE,UAAU;;;;;AAMrB,SAAgB,mBAA4B;AAE1C,QAAO,CAAC,CADE,OACC,WAAW;;;;;AC/BxB,IAAI,oBAAoB;AACxB,IAAI,kBAAkB;;;;;AAMtB,SAAgB,kBAAkB,YAAoB,UAAwB;AAC5E,qBAAoB;AACpB,mBAAkB;;;;;AAMpB,SAAgB,oBAA8D;AAC5E,QAAO;EAAE,YAAY;EAAmB,UAAU;EAAiB;;;;;;AAOrE,eAAsB,YAAY,SAAuC;AACvE,KAAI,CAAC,kBAAkB,CACrB;AAGF,KAAI;AACF,QAAM,cAAc,CAAC,OAAO,kBAAkB;GAC5C,YAAY;GACZ,UAAU;GACV;GACD,CAAC;SACI;;;;;AAQV,eAAsB,eACpB,OACA,SACA,OACA,SACe;AACf,OAAM,YAAY;EAAE,MAAM;EAAY;EAAO;EAAS;EAAO;EAAS,CAAC;;;;;AAMzE,eAAsB,YACpB,SACA,SACA,QAAQ,OACO;AACf,OAAM,YAAY;EAAE,MAAM;EAAS;EAAO;EAAS;EAAO,CAAC;;;;;AAM7D,eAAsB,eAAe,QAAgC;AACnE,OAAM,YAAY;EAAE,MAAM;EAAY;EAAQ,CAAC;;;;;;;;;;;AChEjD,eAAsB,IAAI,SAAgC;AACxD,OAAM,YAAY;EAAE,MAAM;EAAO,OAAO;EAAO;EAAS,CAAC;;;;;AAM3D,eAAsB,KAAK,SAAgC;AACzD,OAAM,YAAY;EAAE,MAAM;EAAO,OAAO;EAAQ;EAAS,CAAC;;;;;AAM5D,eAAsB,MAAM,SAAgC;AAC1D,OAAM,YAAY;EAAE,MAAM;EAAO,OAAO;EAAS;EAAS,CAAC;;;;;;;;;;;;ACd7D,eAAsB,YAAY,KAA4B;AAC5D,OAAM,cAAc,CAAC,OAAO,uBAAuB,EAAE,KAAK,CAAC;;;;;AAM7D,eAAsB,eAA8B;AAClD,OAAM,cAAc,CAAC,OAAO,wBAAwB,EAAE,CAAC;;;;;;;;;;;;;;;;ACkCzD,SAAgB,qBAA4C;CAC1D,MAAM,UAAW,OAAoC;AAErD,KAAI,CAAC,QACH,OAAM,IAAI,MACR,2IAED;AAGH,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC5BT,eAAsB,SAAS,cAAuC;CACpE,MAAM,MAAM,oBAAoB;AAEhC,QAAO,cAAc,CAAC,OAAe,qBAAqB;EACxD,aAAa,IAAI;EACjB;EACD,CAAC;;;;;;;;;;;;;;;;;;;;;AAsBJ,eAAsB,UACpB,cACA,SACe;CACf,MAAM,MAAM,oBAAoB;AAEhC,OAAM,cAAc,CAAC,OAAO,sBAAsB;EAChD,aAAa,IAAI;EACjB;EACA,MAAM;EACP,CAAC;;;;;;;;;;;;;;;;;;;AAoBJ,eAAsB,YAA+B;CACnD,MAAM,MAAM,oBAAoB;AAEhC,QAAO,cAAc,CAAC,OAAiB,sBAAsB,EAC3D,aAAa,IAAI,cAClB,CAAC;;;;;;;;;;;;;;;;;;AAmBJ,eAAsB,WAAW,cAAwC;AAEvE,qBAAoB;AAEpB,KAAI;AACF,QAAM,SAAS,aAAa;AAC5B,SAAO;SACD;AACN,SAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACtFX,eAAsB,eAAe,cAAuC;CAC1E,MAAM,MAAM,oBAAoB;AAEhC,QAAO,cAAc,CAAC,OAAe,oBAAoB;EACvD,YAAY,IAAI;EAChB,aAAa,IAAI;EACjB;EACD,CAAC;;;;;;;;;;;;;;;;;;;;;AAsBJ,eAAsB,gBACpB,cACA,SACe;CACf,MAAM,MAAM,oBAAoB;AAEhC,OAAM,cAAc,CAAC,OAAO,qBAAqB;EAC/C,YAAY,IAAI;EAChB,aAAa,IAAI;EACjB;EACA;EACD,CAAC;;;;;;;;;;;;;;;;AAiBJ,eAAsB,kBAAqC;CACzD,MAAM,MAAM,oBAAoB;AAEhC,QAAO,cAAc,CAAC,OAAiB,qBAAqB;EAC1D,YAAY,IAAI;EAChB,aAAa,IAAI;EAClB,CAAC;;;;;;;;;;;;;;;;;;AAmBJ,eAAsB,iBAAiB,cAAwC;CAC7E,MAAM,MAAM,oBAAoB;AAEhC,QAAO,cAAc,CAAC,OAAgB,sBAAsB;EAC1D,YAAY,IAAI;EAChB,aAAa,IAAI;EACjB;EACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACxBJ,eAAsB,SACpB,KACA,UAAwB,EAAE,EACJ;CACtB,MAAM,EAAE,YAAY,QAAU;CAE9B,MAAM,SAAS,MAAM,cAAc,CAAC,OAAyB,aAAa;EACxE;EACA;EACD,CAAC;CAGF,MAAM,eAAe,KAAK,OAAO,YAAY;CAC7C,MAAM,QAAQ,IAAI,WAAW,aAAa,OAAO;AACjD,MAAK,IAAI,IAAI,GAAG,IAAI,aAAa,QAAQ,IACvC,OAAM,KAAK,aAAa,WAAW,EAAE;AAGvC,QAAO;EACL,QAAQ,OAAO;EACf,IAAI,OAAO;EACX,aAAa,OAAO;EACpB,MAAM;EACN,OAAe;AACb,UAAO,IAAI,aAAa,CAAC,OAAO,MAAM;;EAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BH,eAAsB,cACpB,KACA,WACA,UAA2B,EAAE,EACJ;CACzB,MAAM,MAAM,oBAAoB;CAChC,MAAM,EAAE,YAAY,QAAU;CAE9B,MAAM,SAAS,MAAM,cAAc,CAAC,OAClC,kBACA;EACE;EACA,aAAa,IAAI;EACjB;EACA;EACD,CACF;AAED,QAAO;EACL,QAAQ,OAAO;EACf,IAAI,OAAO;EACX,aAAa,OAAO;EACpB,cAAc,OAAO;EACrB,YAAY,OAAO;EACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACtFH,eAAsB,cACpB,SACwB;CACxB,MAAM,MAAM,oBAAoB;CAChC,MAAM,EAAE,YAAY,MAAM,YAAY,KAAO,QAAQ;CAErD,MAAM,SAAS,MAAM,cAAc,CAAC,OAClC,kBACA;EACE;EACA;EACA,YAAY,IAAI;EAChB;EACA;EACD,CACF;AAED,QAAO;EACL,SAAS,OAAO;EAChB,UAAU,OAAO;EACjB,QAAQ,OAAO;EACf,QAAQ,OAAO;EAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC9DH,eAAsB,kBAAqC;CACzD,MAAM,MAAM,oBAAoB;AAEhC,QAAO,cAAc,CAAC,OAAiB,qBAAqB;EAC1D,YAAY,IAAI;EAChB,aAAa,IAAI;EAClB,CAAC;;;;;;;;;;;;;;;;;;;;AAqBJ,eAAsB,gBAAgB,SAAkC;CACtE,MAAM,MAAM,oBAAoB;AAEhC,OAAM,cAAc,CAAC,OAAO,qBAAqB;EAC/C,YAAY,IAAI;EAChB,aAAa,IAAI;EACjB;EACD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiosis-lab/moss-api",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Official API for building Moss plugins - types and utilities for plugin development",
   "type": "module",
   "main": "./dist/index.mjs",