@symbiosis-lab/moss-api 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -137,6 +137,13 @@ interface TauriCore {
 }
 /**
  * Get the Tauri core API
+ *
+ * @deprecated Use higher-level APIs instead:
+ * - File operations: `readFile`, `writeFile`, `listFiles`, `fileExists`
+ * - HTTP: `fetchUrl`, `downloadAsset`
+ * - Binary execution: `executeBinary`
+ * - Cookies: `getPluginCookie`, `setPluginCookie`
+ *
  * @throws Error if Tauri is not available
  */
 declare function getTauriCore(): TauriCore;
@@ -207,5 +214,295 @@ declare function openBrowser(url: string): Promise<void>;
  */
 declare function closeBrowser(): Promise<void>;
 //#endregion
-export { AfterDeployContext, ArticleInfo, BaseContext, BeforeBuildContext, CompleteMessage, DeploymentInfo, ErrorMessage, HookResult, LogMessage, OnBuildContext, OnDeployContext, PluginCategory, PluginManifest, PluginMessage, ProgressMessage, ProjectInfo, SourceFiles, TauriCore, closeBrowser, error, getMessageContext, getTauriCore, isTauriAvailable, log, openBrowser, reportComplete, reportError, reportProgress, sendMessage, setMessageContext, warn };
+//#region src/utils/filesystem.d.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.
+ */
+/**
+ * Read a file from the project directory
+ *
+ * @param projectPath - Absolute path to the project directory
+ * @param relativePath - Path relative to the project root
+ * @returns File contents as a string
+ * @throws Error if file cannot be read
+ *
+ * @example
+ * ```typescript
+ * const content = await readFile("/path/to/project", "src/index.ts");
+ * ```
+ */
+declare function readFile(projectPath: string, relativePath: string): Promise<string>;
+/**
+ * Write content to a file in the project directory
+ *
+ * Creates parent directories if they don't exist.
+ *
+ * @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
+ *
+ * @example
+ * ```typescript
+ * await writeFile("/path/to/project", "output/result.md", "# Hello World");
+ * ```
+ */
+declare function writeFile(projectPath: string, relativePath: string, content: string): Promise<void>;
+/**
+ * List all files in a project directory
+ *
+ * Returns file paths relative to the project root.
+ *
+ * @param projectPath - Absolute path to the project directory
+ * @returns Array of relative file paths
+ * @throws Error if directory cannot be listed
+ *
+ * @example
+ * ```typescript
+ * const files = await listFiles("/path/to/project");
+ * // ["src/index.ts", "package.json", "README.md"]
+ * ```
+ */
+declare function listFiles(projectPath: string): Promise<string[]>;
+/**
+ * Check if a file exists in the project directory
+ *
+ * @param projectPath - Absolute path to the project directory
+ * @param relativePath - Path relative to the project root
+ * @returns true if file exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (await fileExists("/path/to/project", "config.json")) {
+ *   // load config
+ * }
+ * ```
+ */
+declare function fileExists(projectPath: string, relativePath: string): Promise<boolean>;
+//#endregion
+//#region src/utils/http.d.ts
+/**
+ * HTTP operations for Moss plugins
+ *
+ * These functions provide HTTP capabilities that bypass browser CORS
+ * restrictions by using Rust's HTTP client under the hood.
+ */
+/**
+ * Options for HTTP fetch requests
+ */
+interface FetchOptions {
+  /** Timeout in milliseconds (default: 30000) */
+  timeoutMs?: number;
+}
+/**
+ * Result from an HTTP fetch operation
+ */
+interface FetchResult {
+  /** HTTP status code */
+  status: number;
+  /** Whether the request was successful (2xx status) */
+  ok: boolean;
+  /** Content-Type header from response */
+  contentType: string | null;
+  /** Response body as Uint8Array */
+  body: Uint8Array;
+  /** Get response body as text */
+  text(): string;
+}
+/**
+ * Options for asset download
+ */
+interface DownloadOptions {
+  /** Timeout in milliseconds (default: 30000) */
+  timeoutMs?: number;
+}
+/**
+ * Result from an asset download operation
+ */
+interface DownloadResult {
+  /** HTTP status code */
+  status: number;
+  /** Whether the request was successful (2xx status) */
+  ok: boolean;
+  /** Content-Type header from response */
+  contentType: string | null;
+  /** Number of bytes written to disk */
+  bytesWritten: number;
+  /** Actual path where file was saved (relative to project) */
+  actualPath: string;
+}
+/**
+ * Fetch a URL using Rust's HTTP client (bypasses CORS)
+ *
+ * @param url - URL to fetch
+ * @param options - Optional fetch configuration
+ * @returns Fetch result with status, body, and helpers
+ * @throws Error if network request fails
+ *
+ * @example
+ * ```typescript
+ * const result = await fetchUrl("https://api.example.com/data");
+ * if (result.ok) {
+ *   const data = JSON.parse(result.text());
+ * }
+ * ```
+ */
+declare function fetchUrl(url: string, options?: FetchOptions): Promise<FetchResult>;
+/**
+ * Download a URL and save directly to disk
+ *
+ * Downloads the file and writes it directly to disk without passing
+ * the binary data through JavaScript. The filename is derived from
+ * the URL, and file extension is inferred from Content-Type if needed.
+ *
+ * @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
+ *
+ * @example
+ * ```typescript
+ * const result = await downloadAsset(
+ *   "https://example.com/image",
+ *   "/path/to/project",
+ *   "assets"
+ * );
+ * if (result.ok) {
+ *   console.log(`Saved to ${result.actualPath}`); // e.g., "assets/image.png"
+ * }
+ * ```
+ */
+declare function downloadAsset(url: string, projectPath: string, targetDir: string, options?: DownloadOptions): Promise<DownloadResult>;
+//#endregion
+//#region src/utils/binary.d.ts
+/**
+ * Binary execution for Moss plugins
+ *
+ * Allows plugins to execute external binaries (git, npm, etc.)
+ * in a controlled environment.
+ */
+/**
+ * Options for executing a binary
+ */
+interface ExecuteOptions {
+  /** Path to the binary (can be just the name if in PATH) */
+  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 */
+  env?: Record<string, string>;
+}
+/**
+ * Result from binary execution
+ */
+interface ExecuteResult {
+  /** Whether the command succeeded (exit code 0) */
+  success: boolean;
+  /** Exit code from the process */
+  exitCode: number;
+  /** Standard output from the process */
+  stdout: string;
+  /** Standard error output from the process */
+  stderr: string;
+}
+/**
+ * Execute an external binary
+ *
+ * @param options - Execution options including binary path, args, and working directory
+ * @returns Execution result with stdout, stderr, and exit code
+ * @throws Error if binary cannot be executed
+ *
+ * @example
+ * ```typescript
+ * // Run git status
+ * const result = await executeBinary({
+ *   binaryPath: "git",
+ *   args: ["status"],
+ *   workingDir: "/path/to/repo",
+ * });
+ *
+ * if (result.success) {
+ *   console.log(result.stdout);
+ * } else {
+ *   console.error(result.stderr);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Run npm install with timeout
+ * const result = await executeBinary({
+ *   binaryPath: "npm",
+ *   args: ["install"],
+ *   workingDir: "/path/to/project",
+ *   timeoutMs: 120000,
+ *   env: { NODE_ENV: "production" },
+ * });
+ * ```
+ */
+declare function executeBinary(options: ExecuteOptions): Promise<ExecuteResult>;
+//#endregion
+//#region src/utils/cookies.d.ts
+/**
+ * Cookie management for Moss plugins
+ *
+ * Allows plugins to store and retrieve authentication cookies
+ * for external services (e.g., Matters.town, GitHub).
+ */
+/**
+ * A cookie stored for plugin authentication
+ */
+interface Cookie {
+  /** Cookie name */
+  name: string;
+  /** Cookie value */
+  value: string;
+  /** Optional domain for the cookie */
+  domain?: string;
+  /** Optional path for the cookie */
+  path?: string;
+}
+/**
+ * Get stored cookies for a plugin
+ *
+ * @param pluginName - Name of the plugin
+ * @param projectPath - Absolute path to the project directory
+ * @returns Array of stored cookies
+ *
+ * @example
+ * ```typescript
+ * const cookies = await getPluginCookie("matters-syndicator", "/path/to/project");
+ * 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[]>;
+/**
+ * Store cookies for a plugin
+ *
+ * @param pluginName - Name of the plugin
+ * @param projectPath - Absolute path to the project directory
+ * @param cookies - Array of cookies to store
+ *
+ * @example
+ * ```typescript
+ * await setPluginCookie("my-plugin", "/path/to/project", [
+ *   { name: "session", value: "abc123" }
+ * ]);
+ * ```
+ */
+declare function setPluginCookie(pluginName: string, projectPath: string, 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 };
 //# 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"],"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/http.ts","../src/utils/binary.ts","../src/utils/cookies.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -1,6 +1,13 @@
 //#region src/utils/tauri.ts
 /**
 * Get the Tauri core API
+*
+* @deprecated Use higher-level APIs instead:
+* - File operations: `readFile`, `writeFile`, `listFiles`, `fileExists`
+* - HTTP: `fetchUrl`, `downloadAsset`
+* - Binary execution: `executeBinary`
+* - Cookies: `getPluginCookie`, `setPluginCookie`
+*
 * @throws Error if Tauri is not available
 */
 function getTauriCore() {
@@ -139,5 +146,293 @@ async function closeBrowser() {
 }
 
 //#endregion
-export { closeBrowser, error, getMessageContext, getTauriCore, isTauriAvailable, log, openBrowser, reportComplete, reportError, reportProgress, sendMessage, setMessageContext, warn };
+//#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.
+*/
+/**
+* Read a file from the project directory
+*
+* @param projectPath - Absolute path to the project directory
+* @param relativePath - Path relative to the project root
+* @returns File contents as a string
+* @throws Error if file cannot be read
+*
+* @example
+* ```typescript
+* const content = await readFile("/path/to/project", "src/index.ts");
+* ```
+*/
+async function readFile(projectPath, relativePath) {
+	return getTauriCore().invoke("read_project_file", {
+		projectPath,
+		relativePath
+	});
+}
+/**
+* Write content to a file in the project directory
+*
+* Creates parent directories if they don't exist.
+*
+* @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
+*
+* @example
+* ```typescript
+* await writeFile("/path/to/project", "output/result.md", "# Hello World");
+* ```
+*/
+async function writeFile(projectPath, relativePath, content) {
+	await getTauriCore().invoke("write_project_file", {
+		projectPath,
+		relativePath,
+		data: content
+	});
+}
+/**
+* List all files in a project directory
+*
+* Returns file paths relative to the project root.
+*
+* @param projectPath - Absolute path to the project directory
+* @returns Array of relative file paths
+* @throws Error if directory cannot be listed
+*
+* @example
+* ```typescript
+* const files = await listFiles("/path/to/project");
+* // ["src/index.ts", "package.json", "README.md"]
+* ```
+*/
+async function listFiles(projectPath) {
+	return getTauriCore().invoke("list_project_files", { projectPath });
+}
+/**
+* Check if a file exists in the project directory
+*
+* @param projectPath - Absolute path to the project directory
+* @param relativePath - Path relative to the project root
+* @returns true if file exists, false otherwise
+*
+* @example
+* ```typescript
+* if (await fileExists("/path/to/project", "config.json")) {
+*   // load config
+* }
+* ```
+*/
+async function fileExists(projectPath, relativePath) {
+	try {
+		await readFile(projectPath, relativePath);
+		return true;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+//#region src/utils/http.ts
+/**
+* HTTP operations for Moss plugins
+*
+* These functions provide HTTP capabilities that bypass browser CORS
+* restrictions by using Rust's HTTP client under the hood.
+*/
+/**
+* Fetch a URL using Rust's HTTP client (bypasses CORS)
+*
+* @param url - URL to fetch
+* @param options - Optional fetch configuration
+* @returns Fetch result with status, body, and helpers
+* @throws Error if network request fails
+*
+* @example
+* ```typescript
+* const result = await fetchUrl("https://api.example.com/data");
+* if (result.ok) {
+*   const data = JSON.parse(result.text());
+* }
+* ```
+*/
+async function fetchUrl(url, options = {}) {
+	const { timeoutMs = 3e4 } = options;
+	const result = await getTauriCore().invoke("fetch_url", {
+		url,
+		timeoutMs
+	});
+	const binaryString = atob(result.body_base64);
+	const bytes = new Uint8Array(binaryString.length);
+	for (let i = 0; i < binaryString.length; i++) bytes[i] = binaryString.charCodeAt(i);
+	return {
+		status: result.status,
+		ok: result.ok,
+		contentType: result.content_type,
+		body: bytes,
+		text() {
+			return new TextDecoder().decode(bytes);
+		}
+	};
+}
+/**
+* Download a URL and save directly to disk
+*
+* Downloads the file and writes it directly to disk without passing
+* the binary data through JavaScript. The filename is derived from
+* the URL, and file extension is inferred from Content-Type if needed.
+*
+* @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
+*
+* @example
+* ```typescript
+* const result = await downloadAsset(
+*   "https://example.com/image",
+*   "/path/to/project",
+*   "assets"
+* );
+* if (result.ok) {
+*   console.log(`Saved to ${result.actualPath}`); // e.g., "assets/image.png"
+* }
+* ```
+*/
+async function downloadAsset(url, projectPath, targetDir, options = {}) {
+	const { timeoutMs = 3e4 } = options;
+	const result = await getTauriCore().invoke("download_asset", {
+		url,
+		projectPath,
+		targetDir,
+		timeoutMs
+	});
+	return {
+		status: result.status,
+		ok: result.ok,
+		contentType: result.content_type,
+		bytesWritten: result.bytes_written,
+		actualPath: result.actual_path
+	};
+}
+
+//#endregion
+//#region src/utils/binary.ts
+/**
+* Binary execution for Moss plugins
+*
+* Allows plugins to execute external binaries (git, npm, etc.)
+* in a controlled environment.
+*/
+/**
+* Execute an external binary
+*
+* @param options - Execution options including binary path, args, and working directory
+* @returns Execution result with stdout, stderr, and exit code
+* @throws Error if binary cannot be executed
+*
+* @example
+* ```typescript
+* // Run git status
+* const result = await executeBinary({
+*   binaryPath: "git",
+*   args: ["status"],
+*   workingDir: "/path/to/repo",
+* });
+*
+* if (result.success) {
+*   console.log(result.stdout);
+* } else {
+*   console.error(result.stderr);
+* }
+* ```
+*
+* @example
+* ```typescript
+* // Run npm install with timeout
+* 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 result = await getTauriCore().invoke("execute_binary", {
+		binaryPath,
+		args,
+		workingDir,
+		timeoutMs,
+		env
+	});
+	return {
+		success: result.success,
+		exitCode: result.exit_code,
+		stdout: result.stdout,
+		stderr: result.stderr
+	};
+}
+
+//#endregion
+//#region src/utils/cookies.ts
+/**
+* Cookie management for Moss plugins
+*
+* Allows plugins to store and retrieve authentication cookies
+* for external services (e.g., Matters.town, GitHub).
+*/
+/**
+* Get stored cookies for a plugin
+*
+* @param pluginName - Name of the plugin
+* @param projectPath - Absolute path to the project directory
+* @returns Array of stored cookies
+*
+* @example
+* ```typescript
+* const cookies = await getPluginCookie("matters-syndicator", "/path/to/project");
+* const token = cookies.find(c => c.name === "__access_token");
+* if (token) {
+*   // Use token for authenticated requests
+* }
+* ```
+*/
+async function getPluginCookie(pluginName, projectPath) {
+	return getTauriCore().invoke("get_plugin_cookie", {
+		pluginName,
+		projectPath
+	});
+}
+/**
+* Store cookies for a plugin
+*
+* @param pluginName - Name of the plugin
+* @param projectPath - Absolute path to the project directory
+* @param cookies - Array of cookies to store
+*
+* @example
+* ```typescript
+* await setPluginCookie("my-plugin", "/path/to/project", [
+*   { name: "session", value: "abc123" }
+* ]);
+* ```
+*/
+async function setPluginCookie(pluginName, projectPath, cookies) {
+	await getTauriCore().invoke("set_plugin_cookie", {
+		pluginName,
+		projectPath,
+		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 };
 //# 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"],"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 * @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"],"mappings":";;;;;AAkBA,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;;;;;ACxBxB,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"}
+{"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":"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"}

package/package.json

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