@blastlauncher/cli 1.0.5 → 3.0.0-alpha.1

package/dist/headless.d.ts

@@ -0,0 +1,26 @@
+import { type BrowserTab } from "./browser.js";
+import type { CapabilityHandler } from "@blastlauncher/engine";
+/** `Application` from the `@raycast/api` declarations, as it crosses the wire. */
+export type Application = {
+    name: string;
+    path: string;
+    localizedName?: string;
+    bundleId?: string;
+    windowsAppId?: string;
+};
+export type HeadlessCapabilities = {
+    aiAnswer?: string | undefined;
+    browserTabs?: BrowserTab[] | undefined;
+    oauthCode?: string | undefined;
+    /** Answers `applications.list`; an empty list when omitted. */
+    applications?: Application[] | undefined;
+    selectedText?: string | undefined;
+    selectedFiles?: string[] | undefined;
+    /** Bundle identifier; resolves against applications or a synthetic application. */
+    frontmost?: string | undefined;
+    /** Answers `clipboard.read` at offset 0; an empty text when omitted. */
+    clipboard?: string | undefined;
+};
+/** Parse an `--applications` file: a JSON array of `{ name, path, … }`. */
+export declare function parseApplications(text: string): Application[];
+export declare function createHeadlessHandlers(capabilities?: HeadlessCapabilities): Record<string, CapabilityHandler>;

package/dist/headless.js

@@ -0,0 +1,162 @@
+// The capabilities a headless Blast run answers without a desktop client. They
+// read host state or record UI requests: `getApplications` reports the applications the caller supplied
+// (an empty list otherwise), `Clipboard.read` reports the text the caller
+// supplied (empty otherwise, with no history behind it), and opening a
+// preference window or updating command metadata is only recorded. Selection
+// comes from the supplied text and paths; the frontmost app is supplied or neutral.
+// Window management reads are neutral too: one desktop, no windows, and no
+// default application for a path. Everything that would change the machine
+// (`open.*`, `clipboard.paste`, `clipboard.clear`, `window.setBounds`,
+// `mcp.install`) stays denied unless granted.
+import { createBrowserHandlers } from "./browser.js";
+/** Fields other than the required `name` and `path`. */
+const OPTIONAL_FIELDS = ["localizedName", "bundleId", "windowsAppId"];
+/** The offsets the `Clipboard.read` declarations allow into clipboard history. */
+const MAX_OFFSET = 5;
+function readParams(params, api) {
+    if (typeof params !== "object" || params === null || Array.isArray(params)) {
+        throw new Error(`${api}: params must be an object`);
+    }
+    return params;
+}
+function toApplication(value, at) {
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value) ||
+        typeof value.name !== "string" ||
+        typeof value.path !== "string") {
+        throw new Error(`${at} must be an object with string "name" and "path"`);
+    }
+    const application = { name: value.name, path: value.path };
+    for (const field of OPTIONAL_FIELDS) {
+        const fieldValue = value[field];
+        if (typeof fieldValue === "string")
+            application[field] = fieldValue;
+    }
+    return application;
+}
+/** The wire form of one application: absent fields stay absent, never undefined. */
+function applicationWire(application) {
+    const wire = { name: application.name, path: application.path };
+    for (const field of OPTIONAL_FIELDS) {
+        const value = application[field];
+        if (typeof value === "string")
+            wire[field] = value;
+    }
+    return wire;
+}
+/** Parse an `--applications` file: a JSON array of `{ name, path, … }`. */
+export function parseApplications(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`not JSON (${error instanceof Error ? error.message : String(error)})`, {
+            cause: error,
+        });
+    }
+    if (!Array.isArray(parsed))
+        throw new Error("must be a JSON array of applications");
+    return parsed.map((value, index) => toApplication(value, `application ${index + 1}`));
+}
+export function createHeadlessHandlers(capabilities = {}) {
+    const applications = capabilities.applications ?? [];
+    const clipboard = capabilities.clipboard ?? "";
+    const frontmost = capabilities.frontmost;
+    return {
+        ...(capabilities.aiAnswer === undefined ? {} : { "ai.ask": () => capabilities.aiAnswer }),
+        ...(capabilities.browserTabs === undefined
+            ? {}
+            : createBrowserHandlers(capabilities.browserTabs)),
+        ...(capabilities.oauthCode === undefined
+            ? {}
+            : { "oauth.authorize": () => ({ authorizationCode: capabilities.oauthCode }) }),
+        "selection.text": (params) => {
+            readParams(params, "selection.text");
+            if (!capabilities.selectedText)
+                throw new Error("No text selected");
+            return capabilities.selectedText;
+        },
+        "selection.files": (params) => {
+            readParams(params, "selection.files");
+            return (capabilities.selectedFiles ?? []).map((path) => ({ path }));
+        },
+        "applications.frontmost": (params) => {
+            readParams(params, "applications.frontmost");
+            const application = applications.find((app) => frontmost !== undefined && app.bundleId === frontmost);
+            return applicationWire(application ?? {
+                name: frontmost ?? "Headless",
+                path: "",
+                ...(frontmost === undefined ? {} : { bundleId: frontmost }),
+            });
+        },
+        "applications.list": (params) => {
+            // The supplied list is the whole answer: a headless run cannot narrow it
+            // to the applications that can open one path.
+            const { path } = readParams(params, "applications.list");
+            if (path !== undefined && typeof path !== "string") {
+                throw new Error('applications.list: "path" must be a string');
+            }
+            return applications.map(applicationWire);
+        },
+        "applications.default": (params) => {
+            const { path } = readParams(params, "applications.default");
+            if (typeof path !== "string" || path === "") {
+                throw new Error('applications.default: "path" must be a non-empty string');
+            }
+            // No application database exists, so no path has a default application;
+            // Raycast rejects in exactly that case.
+            throw new Error(`No default application for ${path}`);
+        },
+        // Window management is client state. Without a client there is one empty
+        // desktop, no windows and no active window, so the read-only calls answer
+        // neutrally and `window.setBounds` stays denied.
+        "window.desktops": (params) => {
+            readParams(params, "window.desktops");
+            return [
+                {
+                    id: "headless-desktop",
+                    screenId: "headless-screen",
+                    active: true,
+                    type: "User",
+                    size: { width: 0, height: 0 },
+                },
+            ];
+        },
+        "window.list": (params) => {
+            readParams(params, "window.list");
+            return [];
+        },
+        "window.active": (params) => {
+            readParams(params, "window.active");
+            throw new Error("No active window");
+        },
+        "clipboard.read": (params) => {
+            const { offset } = readParams(params, "clipboard.read");
+            if (offset !== undefined) {
+                if (typeof offset !== "number" ||
+                    !Number.isInteger(offset) ||
+                    offset < 0 ||
+                    offset > MAX_OFFSET) {
+                    throw new Error(`clipboard.read: "offset" must be an integer between 0 and ${MAX_OFFSET}`);
+                }
+                // There is no history to read from, so only the current entry has content.
+                return { text: offset === 0 ? clipboard : "" };
+            }
+            return { text: clipboard };
+        },
+        "command.metadata": (params) => {
+            const { subtitle } = readParams(params, "command.metadata");
+            if (subtitle !== undefined && subtitle !== null && typeof subtitle !== "string") {
+                throw new Error('command.metadata: "subtitle" must be a string or null');
+            }
+        },
+        "preferences.open": (params) => {
+            const { scope } = readParams(params, "preferences.open");
+            if (scope !== "extension" && scope !== "command") {
+                throw new Error('preferences.open: "scope" must be "extension" or "command"');
+            }
+        },
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./headless.js";
+export * from "./browser.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./headless.js";
+export * from "./browser.js";

package/package.json

@@ -1,31 +1,36 @@
 {
   "name": "@blastlauncher/cli",
-  "version": "1.0.5",
-  "description": "Blast CLI Tools",
-  "main": "dist/index.cjs",
-  "bin": {
-    "blast": "dist/index.cjs"
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
   },
   "dependencies": {
-    "commander": "^10.0.0",
-    "esbuild": "^0.17.5",
-    "esbuild-node-externals": "^1.6.0",
-    "fast-glob": "^3.2.12",
-    "fs-extra": "^11.1.0",
-    "semver": "^7.3.8",
-    "tempy": "^3.0.0"
+    "@blastlauncher/engine": "3.0.0-alpha.1",
+    "@blastlauncher/protocol": "3.0.0-alpha.1",
+    "@blastlauncher/shared-deps": "3.0.0-alpha.1"
   },
-  "repository": "https://github.com/BlastLauncher/blast.git",
-  "devDependencies": {
-    "@types/fs-extra": "^9.0.13",
-    "pkg": "^5.8.0"
+  "version": "3.0.0-alpha.1",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BlastLauncher/blast.git",
+    "directory": "packages/cli"
   },
-  "pkg": {
-    "outputPath": "dist",
-    "outputName": "blast"
+  "homepage": "https://github.com/BlastLauncher/blast#readme",
+  "engines": {
+    "node": ">=24.20.0"
   },
-  "scripts": {
-    "build": "node build.js",
-    "package": "pkg ."
+  "files": [
+    "dist",
+    "schema",
+    "LICENSE",
+    "README.md"
+  ],
+  "bin": {
+    "blast": "./dist/cli.js"
   }
-}
+}

package/CHANGELOG.md

@@ -1,31 +0,0 @@
-# @blastlauncher/cli
-
-## 1.0.5
-
-### Patch Changes
-
-- Update README and fixing `prepublishOnly` script
-
-## 1.0.4
-
-### Patch Changes
-
-- Replace raycast extension publish command
-
-## 1.0.3
-
-### Patch Changes
-
-- Fix package should run build before publish
-
-## 1.0.2
-
-### Patch Changes
-
-- Run build in publish command
-
-## 1.0.1
-
-### Patch Changes
-
-- Initial npm publish

package/build.js

@@ -1,15 +0,0 @@
-/* eslint-disable @typescript-eslint/no-var-requires */
-const esbuild = require("esbuild");
-const { nodeExternalsPlugin } = require("esbuild-node-externals");
-
-esbuild.build({
-  entryPoints: ["index.js"],
-  bundle: true,
-  platform: "node",
-  outfile: "dist/index.cjs",
-  plugins: [
-    nodeExternalsPlugin({
-      allowList: ["tempy"],
-    }),
-  ],
-});

package/dist/cli-linux

@@ -1,4 +0,0 @@
-[diffend] Oversized file quarantined before diffing.
-name: package/dist/cli-linux
-size: 46896639 bytes
-sha256: 5e0e21e6d8327f98b9c332526c169d484e216edeeb2072daf5cd427173379214

package/dist/cli-macos

@@ -1,4 +0,0 @@
-[diffend] Oversized file quarantined before diffing.
-name: package/dist/cli-macos
-size: 48710384 bytes
-sha256: 8fdf72b70b24171dbcd165450112e59836cc8022f5152cc530b3207e96fb0423