craft-native 0.0.499 → 0.0.502

package/dist/api/process.d.ts

@@ -60,7 +60,6 @@ export declare function exec(command: string, options?: ExecOptions): Promise<Ex
  */
 export interface SpawnOptions {
     cwd?: string;
-    env?: Record<string, string>;
     /**
      * Run `command` as a command line through a shell (cmd.exe on Windows,
      * /bin/sh elsewhere) instead of executing it directly.
@@ -74,45 +73,41 @@ export interface SpawnOptions {
      */
     shell?: boolean;
 }
+/**
+ * A process started through the native bridge.
+ *
+ * What native `shell.spawn` does, and so all this class offers: start a
+ * program, and kill it. The child inherits Craft's own standard output and
+ * error. Nothing it writes is delivered to the page, and its exit is not
+ * reported.
+ *
+ * `onStdout`, `onStderr`, `onExit` and `write` used to be declared here. No
+ * native bridge ever emitted the events behind them or accepted input, so a
+ * handler registered with them was never called. They are removed rather than
+ * left as methods that accept a callback and stay silent. To read a child's
+ * output, run it in your app's backend process and send the result to the
+ * page; `exec()` covers a command that finishes and returns its output whole.
+ *
+ * Windows and Linux desktop builds do not serve the `shell` namespace at all:
+ * there `start()` rejects.
+ */
 export declare class ChildProcess {
     private command;
     private args;
     private options;
     private processId;
-    private onStdoutHandlers;
-    private onStderrHandlers;
-    private onExitHandlers;
-    private domListeners;
-    private exited;
     constructor(command: string, args?: string[], options?: SpawnOptions);
-    private addDomListener;
-    private removeDomListeners;
-    /** Pid assigned by the native bridge, or null before start(). */
+    /** Identifier this process is registered under, or null before start(). */
     get pid(): string | null;
     /**
-     * Start the process
+     * Start the process. Resolves once native has started it.
      */
     start(): Promise<void>;
     /**
-     * Write to stdin
-     */
-    write(data: string): Promise<void>;
-    /**
-     * Kill the process
-     */
-    kill(signal?: string): Promise<void>;
-    /**
-     * Listen for stdout data
-     */
-    onStdout(handler: (data: string) => void): () => void;
-    /**
-     * Listen for stderr data
-     */
-    onStderr(handler: (data: string) => void): () => void;
-    /**
-     * Listen for exit
+     * Kill the process. Native sends the platform's default termination; there
+     * is no signal to choose.
      */
-    onExit(handler: (code: number) => void): () => void;
+    kill(): Promise<void>;
 }
 /**
  * Spawn a child process

package/dist/bridge/core.d.ts

@@ -46,6 +46,12 @@ export declare const BridgeErrorCodes: {
     readonly PROTOCOL_MISMATCH: -8;
     /** Bridge transitioned from connected to disconnected with requests in flight */
     readonly DISCONNECTED: -9;
+    /**
+     * The native side received the request and refused or failed it. Not
+     * retried: asking again gets the same answer. `data.nativeCode` carries
+     * the bridge's own string code when it sent one.
+     */
+    readonly NATIVE_ERROR: -10;
 };
 export type BridgeErrorCode = typeof BridgeErrorCodes[keyof typeof BridgeErrorCodes];
 /**
@@ -136,12 +142,12 @@ export declare class NativeBridge extends EventEmitter {
      * BridgeError(PROTOCOL_MISMATCH) if the native side reports a version we
      * don't speak.
      *
-     * This is **opt-in** — you must call it explicitly. It assumes the host
-     * registers a `_handshake` handler; the Zig core's
-     * `Bridge.registerDefaults()` does this for you. If you're embedding Craft
-     * inside a host that hasn't wired `_handshake`, do not call this method
-     * (the timeout path will reject with TIMEOUT, which is louder than a
-     * silent mismatch but still a failure).
+     * This is **opt-in** — you must call it explicitly, and only against a
+     * host of your own that answers a `_handshake` request. Craft's own
+     * webview hosts do not: inside one, requests go through
+     * `window.craft.invoke`, which takes `namespace.action` names, and this
+     * call is rejected immediately instead of negotiating anything. Use
+     * `window.craft.capabilities` to ask a Craft host what it serves.
      */
     handshake(): Promise<{
         nativeVersion: number;
@@ -203,6 +209,24 @@ export declare class NativeBridge extends EventEmitter {
      * use that to fail fast instead of waiting for the request timeout.
      */
     private send;
+    /**
+     * Hand a request to `window.craft.invoke`, the dispatcher that
+     * `craft-bridge.js` injects into every Craft webview, and settle the
+     * pending entry with what native answers.
+     *
+     * This is the only path by which `request()` reaches native code. The
+     * `{id, type: 'request', method, params}` envelope this class builds is not
+     * something any Craft host parses: posted raw to the `craft` message
+     * handler it was dropped, and every `request()` waited out its timeout and
+     * its retries. The method name is used as written, `namespace.action`, so
+     * it has to be one the native bridge serves (`fs.readFile`,
+     * `shell.openUrl`, `dialog.openFile`); one it does not serve is rejected
+     * with `NATIVE_ERROR` straight away.
+     *
+     * Returns false when the injected bridge is not present, so the older
+     * transports below still get their turn in a host that provides one.
+     */
+    private sendThroughInjectedBridge;
     /**
      * Reject the pending entry corresponding to `message.id` with `error`,
      * if any. Used by `send()` when serialization or transport throws so

package/dist/cli.js

@@ -1395,6 +1395,33 @@ Description: ${description || opts.name}
     }
   });
 }
+function rpmSpec(options) {
+  return [
+    "%global debug_package %{nil}",
+    "%global _build_id_links none",
+    "%global __strip /bin/true",
+    "%global __os_install_post %{nil}",
+    `Name: ${options.name}`,
+    `Version: ${options.version}`,
+    "Release: 1",
+    `Summary: ${options.summary}`,
+    "License: MIT",
+    `Source0: ${options.name}`,
+    ...options.requires ? [`Requires: ${options.requires}`] : [],
+    "",
+    "%description",
+    options.description,
+    "",
+    "%install",
+    "mkdir -p %{buildroot}/usr/bin",
+    `install -m 755 %{SOURCE0} %{buildroot}/usr/bin/${options.name}`,
+    "",
+    "%files",
+    `/usr/bin/${options.name}`,
+    ""
+  ].join(`
+`);
+}
 async function createRPM(opts) {
   return new Promise((resolve) => {
     try {
@@ -1427,26 +1454,17 @@ async function createRPM(opts) {
         return r;
       }).join(", ");
       copyFileSync(opts.binaryPath, join3(sourcesDir, sanitizedName));
-      const specContent = `Name: ${sanitizedName}
-Version: ${opts.version}
-Release: 1%{?dist}
-Summary: ${summary}
-License: MIT
-Requires: ${requires}
-
-%description
-${description}
-
-%install
-mkdir -p %{buildroot}/usr/bin
-install -m 755 %{SOURCE0} %{buildroot}/usr/bin/${sanitizedName}
-
-%files
-/usr/bin/${sanitizedName}
-`;
+      const specContent = rpmSpec({ name: sanitizedName, version: opts.version, summary, description, requires });
       const specPath = join3(specDir, `${opts.name.toLowerCase()}.spec`);
       writeFileSync4(specPath, specContent);
       const proc = spawn("rpmbuild", ["-bb", specPath]);
+      let said = "";
+      proc.stdout?.on("data", (chunk) => {
+        said += chunk.toString();
+      });
+      proc.stderr?.on("data", (chunk) => {
+        said += chunk.toString();
+      });
       proc.on("close", (code) => {
         if (code === 0) {
           const rpmName = `${opts.name.toLowerCase()}-${opts.version}-1.x86_64.rpm`;
@@ -1458,7 +1476,9 @@ install -m 755 %{SOURCE0} %{buildroot}/usr/bin/${sanitizedName}
             resolve({ success: false, error: "Failed to copy built RPM" });
           }
         } else {
-          resolve({ success: false, error: `rpmbuild exited with code ${code}` });
+          resolve({ success: false, error: `rpmbuild exited with code ${code}: ${said.trim().split(`
+`).slice(-12).join(`
+`)}` });
         }
       });
       proc.on("error", (err) => {
@@ -3246,7 +3266,7 @@ function pinCraftNativeDependency(packagePath, craftVersion) {
 `);
 }
 // package.json
-var version = "0.0.499";
+var version = "0.0.502";
 
 // bin/cli.ts
 var spawnedFrom = process6.env[CRAFT_CLI_SPAWN_MARKER];

package/dist/components/index.d.ts

@@ -801,7 +801,7 @@ export interface TextInputProps extends BaseProps {
     autoCapitalize?: 'none' | 'sentences' | 'words' | 'characters';
     /** Auto correct */
     autoCorrect?: boolean;
-    /** Auto focus */
+    /** Focus the input when it mounts, or when this turns on; not on each render. */
     autoFocus?: boolean;
     /** Secure text entry (password) */
     secureTextEntry?: boolean;

package/dist/index.cjs

@@ -376,7 +376,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.499";
+var version = "0.0.502";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;
@@ -1764,6 +1764,33 @@ Description: ${description || opts.name}
     }
   });
 }
+function rpmSpec(options) {
+  return [
+    "%global debug_package %{nil}",
+    "%global _build_id_links none",
+    "%global __strip /bin/true",
+    "%global __os_install_post %{nil}",
+    `Name: ${options.name}`,
+    `Version: ${options.version}`,
+    "Release: 1",
+    `Summary: ${options.summary}`,
+    "License: MIT",
+    `Source0: ${options.name}`,
+    ...options.requires ? [`Requires: ${options.requires}`] : [],
+    "",
+    "%description",
+    options.description,
+    "",
+    "%install",
+    "mkdir -p %{buildroot}/usr/bin",
+    `install -m 755 %{SOURCE0} %{buildroot}/usr/bin/${options.name}`,
+    "",
+    "%files",
+    `/usr/bin/${options.name}`,
+    ""
+  ].join(`
+`);
+}
 async function createRPM(opts) {
   return new Promise((resolve) => {
     try {
@@ -1796,26 +1823,17 @@ async function createRPM(opts) {
         return r;
       }).join(", ");
       import_fs.copyFileSync(opts.binaryPath, import_path.join(sourcesDir, sanitizedName));
-      const specContent = `Name: ${sanitizedName}
-Version: ${opts.version}
-Release: 1%{?dist}
-Summary: ${summary}
-License: MIT
-Requires: ${requires}
-
-%description
-${description}
-
-%install
-mkdir -p %{buildroot}/usr/bin
-install -m 755 %{SOURCE0} %{buildroot}/usr/bin/${sanitizedName}
-
-%files
-/usr/bin/${sanitizedName}
-`;
+      const specContent = rpmSpec({ name: sanitizedName, version: opts.version, summary, description, requires });
       const specPath = import_path.join(specDir, `${opts.name.toLowerCase()}.spec`);
       import_fs.writeFileSync(specPath, specContent);
       const proc = import_child_process.spawn("rpmbuild", ["-bb", specPath]);
+      let said = "";
+      proc.stdout?.on("data", (chunk) => {
+        said += chunk.toString();
+      });
+      proc.stderr?.on("data", (chunk) => {
+        said += chunk.toString();
+      });
       proc.on("close", (code) => {
         if (code === 0) {
           const rpmName = `${opts.name.toLowerCase()}-${opts.version}-1.x86_64.rpm`;
@@ -1827,7 +1845,9 @@ install -m 755 %{SOURCE0} %{buildroot}/usr/bin/${sanitizedName}
             resolve({ success: false, error: "Failed to copy built RPM" });
           }
         } else {
-          resolve({ success: false, error: `rpmbuild exited with code ${code}` });
+          resolve({ success: false, error: `rpmbuild exited with code ${code}: ${said.trim().split(`
+`).slice(-12).join(`
+`)}` });
         }
       });
       proc.on("error", (err) => {
@@ -2364,7 +2384,8 @@ var BridgeErrorCodes = {
   BRIDGE_DESTROYED: -6,
   BUSY: -7,
   PROTOCOL_MISMATCH: -8,
-  DISCONNECTED: -9
+  DISCONNECTED: -9,
+  NATIVE_ERROR: -10
 };
 var BRIDGE_PROTOCOL_VERSION = 1;
 function buildMessageId(prefix, counter) {
@@ -2772,6 +2793,9 @@ class NativeBridge extends import_events.EventEmitter {
     }
     try {
       if (typeof window !== "undefined") {
+        if (message.type === "request" && this.sendThroughInjectedBridge(message)) {
+          return true;
+        }
         if (window.webkit?.messageHandlers?.craft) {
           window.webkit.messageHandlers.craft.postMessage(message);
           return true;
@@ -2799,6 +2823,31 @@ class NativeBridge extends import_events.EventEmitter {
       return false;
     }
   }
+  sendThroughInjectedBridge(message) {
+    const injected = window.craft;
+    if (!injected || typeof injected.invoke !== "function" || typeof message.method !== "string")
+      return false;
+    let call;
+    try {
+      call = Promise.resolve(injected.invoke(message.method, message.params));
+    } catch (e) {
+      call = Promise.reject(e);
+    }
+    call.then((result) => this.handleResponse({ id: message.id, type: "response", result }), (error) => {
+      const detail = error ?? {};
+      const text = typeof detail.message === "string" && detail.message.length > 0 ? detail.message : `Native bridge refused ${message.method}`;
+      this.handleResponse({
+        id: message.id,
+        type: "response",
+        error: {
+          code: BridgeErrorCodes.NATIVE_ERROR,
+          message: text,
+          data: { nativeCode: typeof detail.code === "string" ? detail.code : undefined, method: message.method }
+        }
+      });
+    });
+    return true;
+  }
   failPendingForMessage(message, error) {
     const pending = this.pendingRequests.get(message.id);
     if (!pending)
@@ -5109,7 +5158,7 @@ async function getSystemInfo() {
 }
 async function exec(command, options) {
   if (typeof window !== "undefined" && window.craft) {
-    return callBridge3("process.exec", { command, ...options });
+    return callBridge3("shell.exec", { command, cwd: options?.cwd });
   }
   const { exec: nodeExec } = await import("node:child_process");
   const { promisify } = await import("node:util");
@@ -5130,107 +5179,46 @@ async function exec(command, options) {
     };
   }
 }
+var nextProcessId = 0;
+function shellFacade() {
+  return window.craft?.shell;
+}
 
 class ChildProcess {
   command;
   args;
   options;
   processId = null;
-  onStdoutHandlers = [];
-  onStderrHandlers = [];
-  onExitHandlers = [];
-  domListeners = [];
-  exited = false;
   constructor(command, args = [], options = {}) {
     this.command = command;
     this.args = args;
     this.options = options;
   }
-  addDomListener(type, handler) {
-    if (typeof window === "undefined")
-      return;
-    window.addEventListener(type, handler);
-    this.domListeners.push({ type, handler });
-  }
-  removeDomListeners() {
-    if (typeof window === "undefined")
-      return;
-    for (const { type, handler } of this.domListeners) {
-      window.removeEventListener(type, handler);
-    }
-    this.domListeners = [];
-  }
   get pid() {
     return this.processId;
   }
   async start() {
     if (typeof window !== "undefined" && window.craft) {
-      const result = await callBridge3("process.spawn", {
+      nextProcessId += 1;
+      const id = `sdk-${Date.now().toString(36)}-${nextProcessId}`;
+      await callBridge3("shell.spawn", {
+        id,
         command: this.command,
         args: this.args,
-        ...this.options
+        cwd: this.options.cwd,
+        shell: this.options.shell
       });
-      this.processId = result.pid;
-      const stdoutHandler = (event) => {
-        if (event.detail.pid === this.processId) {
-          this.onStdoutHandlers.forEach((h) => h(event.detail.data));
-        }
-      };
-      const stderrHandler = (event) => {
-        if (event.detail.pid === this.processId) {
-          this.onStderrHandlers.forEach((h) => h(event.detail.data));
-        }
-      };
-      const exitHandler = (event) => {
-        if (event.detail.pid === this.processId) {
-          this.exited = true;
-          this.onExitHandlers.forEach((h) => h(event.detail.code));
-          this.removeDomListeners();
-        }
-      };
-      this.addDomListener("craft:process:stdout", stdoutHandler);
-      this.addDomListener("craft:process:stderr", stderrHandler);
-      this.addDomListener("craft:process:exit", exitHandler);
+      this.processId = id;
       return;
     }
     throw new Error("spawn() requires Craft environment");
   }
-  async write(data) {
+  async kill() {
     if (typeof window !== "undefined" && window.craft && this.processId) {
-      await callBridge3("process.stdin", { pid: this.processId, data });
+      await shellFacade()?.kill?.(this.processId);
+      this.processId = null;
     }
   }
-  async kill(signal = "SIGTERM") {
-    if (typeof window !== "undefined" && window.craft && this.processId) {
-      await callBridge3("process.kill", { pid: this.processId, signal });
-      if (this.exited)
-        this.removeDomListeners();
-    }
-  }
-  onStdout(handler) {
-    this.onStdoutHandlers.push(handler);
-    return () => {
-      const idx = this.onStdoutHandlers.indexOf(handler);
-      if (idx >= 0)
-        this.onStdoutHandlers.splice(idx, 1);
-    };
-  }
-  onStderr(handler) {
-    this.onStderrHandlers.push(handler);
-    return () => {
-      const idx = this.onStderrHandlers.indexOf(handler);
-      if (idx >= 0)
-        this.onStderrHandlers.splice(idx, 1);
-    };
-  }
-  onExit(handler) {
-    this.onExitHandlers.push(handler);
-    return () => {
-      const idx = this.onExitHandlers.indexOf(handler);
-      if (idx >= 0)
-        this.onExitHandlers.splice(idx, 1);
-    };
-  }
 }
 function spawn2(command, args, options) {
   return new ChildProcess(command, args, options);
@@ -5243,7 +5231,7 @@ function cwd() {
 }
 async function homeDir() {
   if (typeof window !== "undefined" && window.craft) {
-    return callBridge3("process.homeDir");
+    return (await callBridge3("fs.getHomeDir"))?.path || "/";
   }
   if (typeof process !== "undefined") {
     const os = await import("node:os");
@@ -5253,7 +5241,7 @@ async function homeDir() {
 }
 async function tempDir() {
   if (typeof window !== "undefined" && window.craft) {
-    return callBridge3("process.tempDir");
+    return (await callBridge3("fs.getTempDir"))?.path || "/tmp";
   }
   if (typeof process !== "undefined") {
     const os = await import("node:os");
@@ -5281,7 +5269,10 @@ function argv() {
 }
 async function open(target) {
   if (typeof window !== "undefined" && window.craft) {
-    await callBridge3("process.open", { target });
+    if (/^[a-z][a-z0-9+.-]*:/i.test(target) && !/^[a-z]:[\\/]/i.test(target))
+      await callBridge3("shell.openUrl", { url: target });
+    else
+      await shellFacade()?.openPath?.(target);
     return;
   }
   const platform = getPlatform();