feat: ffi support

Author: manyuanrong

Cargo.lock

@@ -6,6 +6,7 @@ members = [
   "core",
   "runtime",
   "test_plugin",
+  "test_ffi",
   "test_util",
   "op_crates/fetch",
   "op_crates/web",

Cargo.toml

@@ -1255,6 +1255,57 @@ declare namespace Deno {
    * ```
    */
   export function sleepSync(millis: number): Promise<void>;
+
+  export type DyLibraryDataType =
+    | "i8"
+    | "i16"
+    | "i32"
+    | "i64"
+    | "u8"
+    | "u16"
+    | "u32"
+    | "u64"
+    | "f32"
+    | "f64";
+
+  export interface CallDylibraryOptions {
+    params?: {
+      typeName: DyLibraryDataType;
+      value: any;
+    }[];
+    returnType?: DyLibraryDataType;
+  }
+
+  export class DyLibrary {
+    /** Call dynamic library function
+     *
+     * ```ts
+     * const lib = await Deno.loadLibrary("./libtest.dylib");
+     * const rval = lib.call("some_func", {
+     *   params: [{ typeName: "i32", value: 10 }]
+     *   returnType: "i32"
+     * });
+     * console.log(rval);
+     * ```
+     */
+    call<T = any>(name: string, options?: CallDylibraryOptions): T;
+
+    /** Unload dynamic library */
+    close(): void;
+  }
+
+  /** **UNSTABLE**: new API, yet to be vetted.
+   *
+   * Load a dynamic library from the given file name,
+   *
+   * ```ts
+   * const lib = await Deno.loadLibrary("./libtest.dylib");
+   * lib.call("some_func");
+   * ```
+   *
+   * Requires `allow-all` permission.
+   */
+  export function loadLibrary(filename: string): DyLibrary;
 }
 
 declare function fetch(

cli/dts/lib.deno.unstable.d.ts

@@ -47,6 +47,7 @@ lazy_static = "1.4.0"
 libc = "0.2.82"
 log = "0.4.13"
 notify = "5.0.0-pre.4"
+libffi = "1.0.0"
 percent-encoding = "2.1.0"
 regex = "1.4.3"
 ring = "0.16.19"

runtime/Cargo.toml

@@ -0,0 +1,35 @@
+// Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
+
+((window) => {
+  const core = window.Deno.core;
+
+  class DyLibaray {
+    #rid = 0;
+    constructor(rid) {
+      this.#rid = rid;
+    }
+
+    call(name, options) {
+      const { params = [], returnType = "" } = options ?? {};
+      return core.jsonOpSync("op_call_libaray_ffi", {
+        rid: this.#rid,
+        name,
+        params,
+        returnType,
+      });
+    }
+
+    close() {
+      core.close(this.#rid);
+    }
+  }
+
+  function loadLibrary(filename) {
+    const rid = core.jsonOpSync("op_load_libaray", { filename });
+    return new DyLibaray(rid);
+  }
+
+  window.__bootstrap.ffi = {
+    loadLibrary,
+  };
+})(this);

runtime/js/40_ffi.js

@@ -130,5 +130,6 @@
     symlinkSync: __bootstrap.fs.symlinkSync,
     HttpClient: __bootstrap.fetch.HttpClient,
     createHttpClient: __bootstrap.fetch.createHttpClient,
+    loadLibrary: __bootstrap.ffi.loadLibrary,
   };
 })(this);