@blastlauncher/cli 1.0.5 → 3.0.0-alpha.0

package/README.md

@@ -1,48 +1,5 @@
-# `@blastlauncher/cli`
-
-`@blastlauncher/cli` is a command line tool that used to build and publish Blast Launcher extensions.
-
-I somehow discover that Raycast's extension build output are similar to esbuild's output, so I also use esbuild to bundle the extension and pkg to package the cli executable. Ray's CLI is way smaller, I guess their CLI is written in Go. 🤣
-
-The publish command will upload the extension to npm registry(which is released under `@blast-extensions` for now).
-
-## Development
-
-```bash
-# Output single cjs file with esbuild
-pnpm build
-
-# Run the cli
-node ./dist/index.cjs --help
-
-# Package to cli executable with pkg
-pnpm package
-
-# Run the cli executable
-./dist/cli-macos --help
-```
-
-## Installation
-
-### npm
-
-```bash
-npm install -g @blastlauncher/cli
-```
-
-## Help
-
-```bash
-Usage: blast [options] [command]
-
-CLI for Blast Launcher
-
-Options:
-  -h, --help                               display help for command
-
-Commands:
-  publish [options] <path> <organization>  Publish extensions
-  build [options] <path>                   Build extensions
-  help [command]                           display help for command
-```
+# @blastlauncher/cli
 
+Blast's cli package.
+Emitted ESM and TypeScript declarations for Node.js 24.20+.
+See https://github.com/BlastLauncher/blast for documentation.

package/dist/browser.d.ts

@@ -0,0 +1,11 @@
+import type { CapabilityHandler } from "@blastlauncher/engine";
+export type BrowserTab = {
+    id: number;
+    url: string;
+    active: boolean;
+    title?: string;
+    favicon?: string;
+    content?: string;
+};
+export declare function parseBrowserTabs(text: string): BrowserTab[];
+export declare function createBrowserHandlers(tabs: BrowserTab[]): Record<string, CapabilityHandler>;

package/dist/browser.js

@@ -0,0 +1,49 @@
+export function parseBrowserTabs(text) {
+    const tabs = JSON.parse(text);
+    if (!Array.isArray(tabs))
+        throw new Error("must be a JSON array of tabs");
+    const ids = new Set();
+    return tabs.map((tab, index) => {
+        if (!tab ||
+            typeof tab !== "object" ||
+            !Number.isInteger(tab.id) ||
+            typeof tab.url !== "string" ||
+            typeof tab.active !== "boolean")
+            throw new Error(`tab ${index + 1} requires integer id, string url and boolean active`);
+        if (ids.has(tab.id))
+            throw new Error(`duplicate tab id ${tab.id}`);
+        ids.add(tab.id);
+        const result = { id: tab.id, url: tab.url, active: tab.active };
+        for (const field of ["title", "favicon", "content"]) {
+            if (tab[field] !== undefined) {
+                if (typeof tab[field] !== "string")
+                    throw new Error(`tab ${index + 1}: ${field} must be a string`);
+                result[field] = tab[field];
+            }
+        }
+        return result;
+    });
+}
+export function createBrowserHandlers(tabs) {
+    return {
+        "browser.tabs": () => tabs.map(({ content: _content, ...tab }) => tab),
+        "browser.content": (params) => {
+            if (!params || typeof params !== "object" || Array.isArray(params))
+                throw new Error("browser.content: expected options");
+            if (params.tabId !== undefined &&
+                (typeof params.tabId !== "number" || !Number.isInteger(params.tabId)))
+                throw new Error("browser.content: invalid tabId");
+            if (params.format !== undefined &&
+                !["html", "text", "markdown"].includes(String(params.format)))
+                throw new Error("browser.content: invalid format");
+            if (params.cssSelector !== undefined)
+                throw new Error("browser.content: headless content does not support CSS selectors");
+            const tab = params.tabId === undefined
+                ? tabs.find((candidate) => candidate.active)
+                : tabs.find((candidate) => candidate.id === params.tabId);
+            if (tab?.content === undefined)
+                throw new Error("browser.content: no content supplied for tab");
+            return tab.content;
+        },
+    };
+}

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {};