interface.mjs

/** @enum {string} @readonly */
const T = Object.freeze({
  VOID: "void",
  JBYTE: "jbyte",
  JSHORT: "jshort",
  JINT: "jint",
  JLONG: "jlong",
  JFLOAT: "jfloat",
  JDOUBLE: "jdouble",
  JBOOLEAN: "jboolean",
  JCHAR: "jchar",
  STRING: "const char*",
  INSTANCE: "JvmInstanceHandle",
});

/**
 * @typedef {Object} KIFunctionArgument
 * @property {string} name
 * @property {T} type
 */

/**
 * @typedef {Object} KIFuncDef
 * @property {string} name
 * @property {T} returnType
 * @property {KIFunctionArgument[]} args
 * @property {boolean?} isEmscriptenOnly
 */

/**
 * @readonly
 * @satisfies {Object.<string, function(string): KIFunctionArgument>}
 */
const Arg = Object.freeze({
  void(name) {
    return { name, type: T.VOID };
  },
  jbyte(name) {
    return { name, type: T.JBYTE };
  },
  jshort(name) {
    return { name, type: T.JSHORT };
  },
  jint(name) {
    return { name, type: T.JINT };
  },
  jlong(name) {
    return { name, type: T.JLONG };
  },
  jfloat(name) {
    return { name, type: T.JFLOAT };
  },
  jdouble(name) {
    return { name, type: T.JDOUBLE };
  },
  jboolean(name) {
    return { name, type: T.JBOOLEAN };
  },
  jchar(name) {
    return { name, type: T.JCHAR };
  },
  string(name) {
    return { name, type: T.STRING };
  },
  instance(name) {
    return { name, type: T.INSTANCE };
  },
});

/**
 * @param {string} name
 * @param {T} returnType
 * @param {KIFunctionArgument[]} args
 * @returns {KIFuncDef}
 */
function hostImport(name, returnType, args) {
  return { name, returnType, args };
}

/**
 * @param {string} name
 * @param {T} returnType
 * @param {KIFunctionArgument[]} args
 * @returns {KIFuncDef}
 */
function hostImportEmscriptenOnly(name, returnType, args) {
  return { name, returnType, args, isEmscriptenOnly: true };
}

export const hostImports = [
  hostImport("koe_cryptor_create", T.INSTANCE, [
    Arg.jbyte("keyData"),
    Arg.jint("keyDataLength"),
  ]),
  hostImport("koe_cryptor_destroy", T.VOID, [Arg.instance("handle")]),

  // Emscripten/WASM-specific imports
  hostImportEmscriptenOnly("koe_dave_on_error", T.VOID, [
    Arg.instance("session"),
    Arg.string("source"),
    Arg.string("reason"),
  ]),
];