pkg/wasm/lib/src/wasmer_api.dart

// Copyright (c) 2020, the Dart project authors.  Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

import 'dart:convert';
import 'dart:ffi';
import 'dart:typed_data';

// wasmer_result_t
const int WasmerResultOk = 1;
const int WasmerResultError = 2;

// wasmer_value_tag
const int WasmerValueTagI32 = 0;
const int WasmerValueTagI64 = 1;
const int WasmerValueTagF32 = 2;
const int WasmerValueTagF64 = 3;
// The void tag is not part of the C API. It's used to represent the return type
// of a void function.
const int WasmerValueTagVoid = -1;

// wasmer_import_export_kind
const int WasmerImpExpKindFunction = 0;
const int WasmerImpExpKindGlobal = 1;
const int WasmerImpExpKindMemory = 2;
const int WasmerImpExpKindTable = 3;

String wasmerImpExpKindName(int kind) {
  switch (kind) {
    case WasmerImpExpKindFunction:
      return "function";
    case WasmerImpExpKindGlobal:
      return "global";
    case WasmerImpExpKindMemory:
      return "memory";
    case WasmerImpExpKindTable:
      return "table";
    default:
      return "unknown";
  }
}

// wasmer_module_t
class WasmerModule extends Struct {}

// wasmer_instance_t
class WasmerInstance extends Struct {}

// wasmer_exports_t
class WasmerExports extends Struct {}

// wasmer_export_t
class WasmerExport extends Struct {}

// wasmer_export_descriptors_t
class WasmerExportDescriptors extends Struct {}

// wasmer_export_descriptor_t
class WasmerExportDescriptor extends Struct {}

// wasmer_export_func_t
class WasmerExportFunc extends Struct {}

// wasmer_import_descriptors_t
class WasmerImportDescriptors extends Struct {}

// wasmer_import_descriptor_t
class WasmerImportDescriptor extends Struct {}

// wasmer_memory_t
class WasmerMemory extends Struct {}

// wasmer_import_t
class WasmerImport extends Struct {
  external Pointer<Uint8> module_name;

  @Uint32()
  external int module_name_length;

  external Pointer<Uint8> import_name;

  @Uint32()
  external int import_name_length;

  // wasmer_import_export_kind
  @Uint32()
  external int tag;

  // wasmer_import_export_value, which is a union of wasmer_import_func_t*,
  // wasmer_table_t*, wasmer_memory_t*, and wasmer_global_t*. The tag determines
  // which type it is.
  external Pointer<Void> value;
}

// wasmer_byte_array
class WasmerByteArray extends Struct {
  external Pointer<Uint8> bytes;

  @Uint32()
  external int length;

  Uint8List get list => bytes.asTypedList(length);
  String get string => utf8.decode(list);
}

// wasmer_value_t
class WasmerValue extends Struct {
  // wasmer_value_tag
  @Uint32()
  external int tag;

  // wasmer_value, which is a union of int32_t, int64_t, float, and double. The
  // tag determines which type it is. It's declared as an int64_t because that's
  // large enough to hold all the types. We use ByteData to get the other types.
  @Int64()
  external int value;

  int get _off32 => Endian.host == Endian.little ? 0 : 4;
  int get i64 => value;
  ByteData get _getterBytes => ByteData(8)..setInt64(0, value, Endian.host);
  int get i32 => _getterBytes.getInt32(_off32, Endian.host);
  double get f32 => _getterBytes.getFloat32(_off32, Endian.host);
  double get f64 => _getterBytes.getFloat64(0, Endian.host);

  set i64(int val) => value = val;
  set _val(ByteData bytes) => value = bytes.getInt64(0, Endian.host);
  set i32(int val) => _val = ByteData(8)..setInt32(_off32, val, Endian.host);
  set f32(num val) =>
      _val = ByteData(8)..setFloat32(_off32, val as double, Endian.host);
  set f64(num val) =>
      _val = ByteData(8)..setFloat64(0, val as double, Endian.host);

  bool get isI32 => tag == WasmerValueTagI32;
  bool get isI64 => tag == WasmerValueTagI64;
  bool get isF32 => tag == WasmerValueTagF32;
  bool get isF64 => tag == WasmerValueTagF64;
}

// wasmer_limits_t
class WasmerLimits extends Struct {
  @Uint32()
  external int min;

  // bool
  @Uint8()
  external int has_max;

  @Uint32()
  external int max;
}

// wasmer_compile
typedef NativeWasmerCompileFn = Uint32 Function(
    Pointer<Pointer<WasmerModule>>, Pointer<Uint8>, Uint32);
typedef WasmerCompileFn = int Function(
    Pointer<Pointer<WasmerModule>>, Pointer<Uint8>, int);

// wasmer_module_instantiate
typedef NativeWasmerInstantiateFn = Uint32 Function(Pointer<WasmerModule>,
    Pointer<Pointer<WasmerInstance>>, Pointer<WasmerImport>, Int32);
typedef WasmerInstantiateFn = int Function(Pointer<WasmerModule>,
    Pointer<Pointer<WasmerInstance>>, Pointer<WasmerImport>, int);

// wasmer_instance_exports
typedef NativeWasmerInstanceExportsFn = Void Function(
    Pointer<WasmerInstance>, Pointer<Pointer<WasmerExports>>);
typedef WasmerInstanceExportsFn = void Function(
    Pointer<WasmerInstance>, Pointer<Pointer<WasmerExports>>);

// wasmer_exports_len
typedef NativeWasmerExportsLenFn = Int32 Function(Pointer<WasmerExports>);
typedef WasmerExportsLenFn = int Function(Pointer<WasmerExports>);

// wasmer_exports_get
typedef NativeWasmerExportsGetFn = Pointer<WasmerExport> Function(
    Pointer<WasmerExports>, Int32);
typedef WasmerExportsGetFn = Pointer<WasmerExport> Function(
    Pointer<WasmerExports>, int);

// wasmer_export_descriptors
typedef NativeWasmerExportDescriptorsFn = Void Function(
    Pointer<WasmerModule>, Pointer<Pointer<WasmerExportDescriptors>>);
typedef WasmerExportDescriptorsFn = void Function(
    Pointer<WasmerModule>, Pointer<Pointer<WasmerExportDescriptors>>);

// wasmer_export_descriptors_destroy
typedef NativeWasmerExportDescriptorsDestroyFn = Void Function(
    Pointer<WasmerExportDescriptors>);
typedef WasmerExportDescriptorsDestroyFn = void Function(
    Pointer<WasmerExportDescriptors>);

// wasmer_export_descriptors_len
typedef NativeWasmerExportDescriptorsLenFn = Int32 Function(
    Pointer<WasmerExportDescriptors>);
typedef WasmerExportDescriptorsLenFn = int Function(
    Pointer<WasmerExportDescriptors>);

// wasmer_export_descriptors_get
typedef NativeWasmerExportDescriptorsGetFn = Pointer<WasmerExportDescriptor>
    Function(Pointer<WasmerExportDescriptors>, Int32);
typedef WasmerExportDescriptorsGetFn = Pointer<WasmerExportDescriptor> Function(
    Pointer<WasmerExportDescriptors>, int);

// wasmer_export_descriptor_kind
typedef NativeWasmerExportDescriptorKindFn = Uint32 Function(
    Pointer<WasmerExportDescriptor>);
typedef WasmerExportDescriptorKindFn = int Function(
    Pointer<WasmerExportDescriptor>);

// wasmer_export_descriptor_name_ptr
typedef NativeWasmerExportDescriptorNamePtrFn = Void Function(
    Pointer<WasmerExportDescriptor>, Pointer<WasmerByteArray>);
typedef WasmerExportDescriptorNamePtrFn = void Function(
    Pointer<WasmerExportDescriptor>, Pointer<WasmerByteArray>);

// wasmer_import_descriptors
typedef NativeWasmerImportDescriptorsFn = Void Function(
    Pointer<WasmerModule>, Pointer<Pointer<WasmerImportDescriptors>>);
typedef WasmerImportDescriptorsFn = void Function(
    Pointer<WasmerModule>, Pointer<Pointer<WasmerImportDescriptors>>);

// wasmer_import_descriptors_destroy
typedef NativeWasmerImportDescriptorsDestroyFn = Void Function(
    Pointer<WasmerImportDescriptors>);
typedef WasmerImportDescriptorsDestroyFn = void Function(
    Pointer<WasmerImportDescriptors>);

// wasmer_import_descriptors_len
typedef NativeWasmerImportDescriptorsLenFn = Int32 Function(
    Pointer<WasmerImportDescriptors>);
typedef WasmerImportDescriptorsLenFn = int Function(
    Pointer<WasmerImportDescriptors>);

// wasmer_import_descriptors_get
typedef NativeWasmerImportDescriptorsGetFn = Pointer<WasmerImportDescriptor>
    Function(Pointer<WasmerImportDescriptors>, Int32);
typedef WasmerImportDescriptorsGetFn = Pointer<WasmerImportDescriptor> Function(
    Pointer<WasmerImportDescriptors>, int);

// wasmer_import_descriptor_kind
typedef NativeWasmerImportDescriptorKindFn = Uint32 Function(
    Pointer<WasmerImportDescriptor>);
typedef WasmerImportDescriptorKindFn = int Function(
    Pointer<WasmerImportDescriptor>);

// wasmer_import_descriptor_module_name_ptr
typedef NativeWasmerImportDescriptorModuleNamePtrFn = Void Function(
    Pointer<WasmerImportDescriptor>, Pointer<WasmerByteArray>);
typedef WasmerImportDescriptorModuleNamePtrFn = void Function(
    Pointer<WasmerImportDescriptor>, Pointer<WasmerByteArray>);

// wasmer_import_descriptor_name_ptr
typedef NativeWasmerImportDescriptorNamePtrFn = Void Function(
    Pointer<WasmerImportDescriptor>, Pointer<WasmerByteArray>);
typedef WasmerImportDescriptorNamePtrFn = void Function(
    Pointer<WasmerImportDescriptor>, Pointer<WasmerByteArray>);

// wasmer_export_name_ptr
typedef NativeWasmerExportNamePtrFn = Void Function(
    Pointer<WasmerExport>, Pointer<WasmerByteArray>);
typedef WasmerExportNamePtrFn = void Function(
    Pointer<WasmerExport>, Pointer<WasmerByteArray>);

// wasmer_export_kind
typedef NativeWasmerExportKindFn = Uint32 Function(Pointer<WasmerExport>);
typedef WasmerExportKindFn = int Function(Pointer<WasmerExport>);

// wasmer_export_to_func
typedef NativeWasmerExportToFuncFn = Pointer<WasmerExportFunc> Function(
    Pointer<WasmerExport>);
typedef WasmerExportToFuncFn = Pointer<WasmerExportFunc> Function(
    Pointer<WasmerExport>);

// wasmer_export_func_returns_arity
typedef NativeWasmerExportFuncReturnsArityFn = Uint32 Function(
    Pointer<WasmerExportFunc>, Pointer<Uint32>);
typedef WasmerExportFuncReturnsArityFn = int Function(
    Pointer<WasmerExportFunc>, Pointer<Uint32>);

// wasmer_export_func_returns
typedef NativeWasmerExportFuncReturnsFn = Uint32 Function(
    Pointer<WasmerExportFunc>, Pointer<Uint32>, Uint32);
typedef WasmerExportFuncReturnsFn = int Function(
    Pointer<WasmerExportFunc>, Pointer<Uint32>, int);

// wasmer_export_func_params_arity
typedef NativeWasmerExportFuncParamsArityFn = Uint32 Function(
    Pointer<WasmerExportFunc>, Pointer<Uint32>);
typedef WasmerExportFuncParamsArityFn = int Function(
    Pointer<WasmerExportFunc>, Pointer<Uint32>);

// wasmer_export_func_params
typedef NativeWasmerExportFuncParamsFn = Uint32 Function(
    Pointer<WasmerExportFunc>, Pointer<Uint32>, Uint32);
typedef WasmerExportFuncParamsFn = int Function(
    Pointer<WasmerExportFunc>, Pointer<Uint32>, int);

// wasmer_export_func_call
typedef NativeWasmerExportFuncCallFn = Uint32 Function(
    Pointer<WasmerExportFunc>,
    Pointer<WasmerValue>,
    Uint32,
    Pointer<WasmerValue>,
    Uint32);
typedef WasmerExportFuncCallFn = int Function(Pointer<WasmerExportFunc>,
    Pointer<WasmerValue>, int, Pointer<WasmerValue>, int);

// wasmer_export_to_memory
typedef NativeWasmerExportToMemoryFn = Uint32 Function(
    Pointer<WasmerExport>, Pointer<Pointer<WasmerMemory>>);
typedef WasmerExportToMemoryFn = int Function(
    Pointer<WasmerExport>, Pointer<Pointer<WasmerMemory>>);

// wasmer_memory_new_ptr
typedef NativeWasmerMemoryNewPtrFn = Uint32 Function(
    Pointer<Pointer<WasmerMemory>>, Pointer<WasmerLimits>);
typedef WasmerMemoryNewPtrFn = int Function(
    Pointer<Pointer<WasmerMemory>>, Pointer<WasmerLimits>);

// wasmer_memory_grow
typedef NativeWasmerMemoryGrowFn = Uint32 Function(
    Pointer<WasmerMemory>, Uint32);
typedef WasmerMemoryGrowFn = int Function(Pointer<WasmerMemory>, int);

// wasmer_memory_length
typedef NativeWasmerMemoryLengthFn = Uint32 Function(Pointer<WasmerMemory>);
typedef WasmerMemoryLengthFn = int Function(Pointer<WasmerMemory>);

// wasmer_memory_data
typedef NativeWasmerMemoryDataFn = Pointer<Uint8> Function(
    Pointer<WasmerMemory>);
typedef WasmerMemoryDataFn = Pointer<Uint8> Function(Pointer<WasmerMemory>);

// wasmer_memory_data_length
typedef NativeWasmerMemoryDataLengthFn = Uint32 Function(Pointer<WasmerMemory>);
typedef WasmerMemoryDataLengthFn = int Function(Pointer<WasmerMemory>);