@symbiosis-lab/moss-api 0.1.0 → 0.3.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