Files
Jake Teton-LandisandGitHub 3a70ae6605 Clean up functions when disposed (#227)
* Actually clean up functions after disposed

* update vscode settings

* new HostRef system for handling functions & generic host references

* tests

* HostRef

* document why returning raw JS_EXCEPTION is valid here

* fix ref

* bugfixes

* dont leak HostRef instance

* fix double-free

* doc

* prettier

* FIX MEasdfasdf

* update docs
2026-02-16 04:39:16 +00:00

444 lines
13 KiB
TypeScript

// This file generated by "generate.ts ffi" in the root of the repo.
import {
QuickJSEmscriptenModule,
JSRuntimePointer,
JSContextPointer,
JSContextPointerPointer,
JSModuleDefPointer,
JSValuePointer,
JSValueConstPointer,
JSValuePointerPointer,
JSValuePointerPointerPointer,
JSValueConstPointerPointer,
QTS_C_To_HostCallbackFuncPointer,
QTS_C_To_HostInterruptFuncPointer,
QTS_C_To_HostLoadModuleFuncPointer,
BorrowedHeapCharPointer,
OwnedHeapCharPointer,
JSBorrowedCharPointer,
JSVoidPointer,
UInt32Pointer,
EvalFlags,
IntrinsicsFlags,
EvalDetectModule,
GetOwnPropertyNamesFlags,
IsEqualOp,
HostRefId,
JSPromiseStateEnum,
} from "@jitl/quickjs-ffi-types"
/**
* Low-level FFI bindings to QuickJS's Emscripten module.
* See instead {@link QuickJSContext}, the public Javascript interface exposed by this
* library.
*
* @unstable The FFI interface is considered private and may change.
*/
export class QuickJSFFI {
constructor(private module: QuickJSEmscriptenModule) {}
/** Set at compile time. */
readonly DEBUG = false
QTS_Throw: (
ctx: JSContextPointer,
error: JSValuePointer | JSValueConstPointer,
) => JSValuePointer = this.module.cwrap("QTS_Throw", "number", ["number", "number"])
QTS_NewError: (ctx: JSContextPointer) => JSValuePointer = this.module.cwrap(
"QTS_NewError",
"number",
["number"],
)
QTS_RuntimeSetMemoryLimit: (rt: JSRuntimePointer, limit: number) => void = this.module.cwrap(
"QTS_RuntimeSetMemoryLimit",
null,
["number", "number"],
)
QTS_RuntimeComputeMemoryUsage: (rt: JSRuntimePointer, ctx: JSContextPointer) => JSValuePointer =
this.module.cwrap("QTS_RuntimeComputeMemoryUsage", "number", ["number", "number"])
QTS_RuntimeDumpMemoryUsage: (rt: JSRuntimePointer) => OwnedHeapCharPointer = this.module.cwrap(
"QTS_RuntimeDumpMemoryUsage",
"number",
["number"],
)
QTS_RecoverableLeakCheck: () => number = this.module.cwrap(
"QTS_RecoverableLeakCheck",
"number",
[],
)
QTS_BuildIsSanitizeLeak: () => number = this.module.cwrap("QTS_BuildIsSanitizeLeak", "number", [])
QTS_RuntimeSetMaxStackSize: (rt: JSRuntimePointer, stack_size: number) => void =
this.module.cwrap("QTS_RuntimeSetMaxStackSize", null, ["number", "number"])
QTS_GetUndefined: () => JSValueConstPointer = this.module.cwrap("QTS_GetUndefined", "number", [])
QTS_GetNull: () => JSValueConstPointer = this.module.cwrap("QTS_GetNull", "number", [])
QTS_GetFalse: () => JSValueConstPointer = this.module.cwrap("QTS_GetFalse", "number", [])
QTS_GetTrue: () => JSValueConstPointer = this.module.cwrap("QTS_GetTrue", "number", [])
QTS_NewHostRef: (ctx: JSContextPointer, id: HostRefId) => JSValuePointer = this.module.cwrap(
"QTS_NewHostRef",
"number",
["number", "number"],
)
QTS_GetHostRefId: (value: JSValuePointer | JSValueConstPointer) => HostRefId = this.module.cwrap(
"QTS_GetHostRefId",
"number",
["number"],
)
QTS_NewRuntime: () => JSRuntimePointer = this.module.cwrap("QTS_NewRuntime", "number", [])
QTS_FreeRuntime: (rt: JSRuntimePointer) => void = this.module.cwrap("QTS_FreeRuntime", null, [
"number",
])
QTS_NewContext: (rt: JSRuntimePointer, intrinsics: IntrinsicsFlags) => JSContextPointer =
this.module.cwrap("QTS_NewContext", "number", ["number", "number"])
QTS_FreeContext: (ctx: JSContextPointer) => void = this.module.cwrap("QTS_FreeContext", null, [
"number",
])
QTS_FreeValuePointer: (ctx: JSContextPointer, value: JSValuePointer) => void = this.module.cwrap(
"QTS_FreeValuePointer",
null,
["number", "number"],
)
QTS_FreeValuePointerRuntime: (rt: JSRuntimePointer, value: JSValuePointer) => void =
this.module.cwrap("QTS_FreeValuePointerRuntime", null, ["number", "number"])
QTS_FreeVoidPointer: (ctx: JSContextPointer, ptr: JSVoidPointer) => void = this.module.cwrap(
"QTS_FreeVoidPointer",
null,
["number", "number"],
)
QTS_FreeCString: (ctx: JSContextPointer, str: JSBorrowedCharPointer) => void = this.module.cwrap(
"QTS_FreeCString",
null,
["number", "number"],
)
QTS_DupValuePointer: (
ctx: JSContextPointer,
val: JSValuePointer | JSValueConstPointer,
) => JSValuePointer = this.module.cwrap("QTS_DupValuePointer", "number", ["number", "number"])
QTS_NewObject: (ctx: JSContextPointer) => JSValuePointer = this.module.cwrap(
"QTS_NewObject",
"number",
["number"],
)
QTS_NewObjectProto: (
ctx: JSContextPointer,
proto: JSValuePointer | JSValueConstPointer,
) => JSValuePointer = this.module.cwrap("QTS_NewObjectProto", "number", ["number", "number"])
QTS_NewArray: (ctx: JSContextPointer) => JSValuePointer = this.module.cwrap(
"QTS_NewArray",
"number",
["number"],
)
QTS_NewArrayBuffer: (
ctx: JSContextPointer,
buffer: JSVoidPointer,
length: number,
) => JSValuePointer = this.module.cwrap("QTS_NewArrayBuffer", "number", [
"number",
"number",
"number",
])
QTS_NewFloat64: (ctx: JSContextPointer, num: number) => JSValuePointer = this.module.cwrap(
"QTS_NewFloat64",
"number",
["number", "number"],
)
QTS_GetFloat64: (ctx: JSContextPointer, value: JSValuePointer | JSValueConstPointer) => number =
this.module.cwrap("QTS_GetFloat64", "number", ["number", "number"])
QTS_NewString: (ctx: JSContextPointer, string: BorrowedHeapCharPointer) => JSValuePointer =
this.module.cwrap("QTS_NewString", "number", ["number", "number"])
QTS_GetString: (
ctx: JSContextPointer,
value: JSValuePointer | JSValueConstPointer,
) => JSBorrowedCharPointer = this.module.cwrap("QTS_GetString", "number", ["number", "number"])
QTS_GetArrayBuffer: (
ctx: JSContextPointer,
data: JSValuePointer | JSValueConstPointer,
) => JSVoidPointer = this.module.cwrap("QTS_GetArrayBuffer", "number", ["number", "number"])
QTS_GetArrayBufferLength: (
ctx: JSContextPointer,
data: JSValuePointer | JSValueConstPointer,
) => number = this.module.cwrap("QTS_GetArrayBufferLength", "number", ["number", "number"])
QTS_NewSymbol: (
ctx: JSContextPointer,
description: BorrowedHeapCharPointer,
isGlobal: number,
) => JSValuePointer = this.module.cwrap("QTS_NewSymbol", "number", ["number", "number", "number"])
QTS_GetSymbolDescriptionOrKey: (
ctx: JSContextPointer,
value: JSValuePointer | JSValueConstPointer,
) => JSBorrowedCharPointer = this.module.cwrap("QTS_GetSymbolDescriptionOrKey", "number", [
"number",
"number",
])
QTS_IsGlobalSymbol: (
ctx: JSContextPointer,
value: JSValuePointer | JSValueConstPointer,
) => number = this.module.cwrap("QTS_IsGlobalSymbol", "number", ["number", "number"])
QTS_IsJobPending: (rt: JSRuntimePointer) => number = this.module.cwrap(
"QTS_IsJobPending",
"number",
["number"],
)
QTS_ExecutePendingJob: (
rt: JSRuntimePointer,
maxJobsToExecute: number,
lastJobContext: JSContextPointerPointer,
) => JSValuePointer = this.module.cwrap("QTS_ExecutePendingJob", "number", [
"number",
"number",
"number",
])
QTS_GetProp: (
ctx: JSContextPointer,
this_val: JSValuePointer | JSValueConstPointer,
prop_name: JSValuePointer | JSValueConstPointer,
) => JSValuePointer = this.module.cwrap("QTS_GetProp", "number", ["number", "number", "number"])
QTS_GetPropNumber: (
ctx: JSContextPointer,
this_val: JSValuePointer | JSValueConstPointer,
prop_name: number,
) => JSValuePointer = this.module.cwrap("QTS_GetPropNumber", "number", [
"number",
"number",
"number",
])
QTS_SetProp: (
ctx: JSContextPointer,
this_val: JSValuePointer | JSValueConstPointer,
prop_name: JSValuePointer | JSValueConstPointer,
prop_value: JSValuePointer | JSValueConstPointer,
) => void = this.module.cwrap("QTS_SetProp", null, ["number", "number", "number", "number"])
QTS_DefineProp: (
ctx: JSContextPointer,
this_val: JSValuePointer | JSValueConstPointer,
prop_name: JSValuePointer | JSValueConstPointer,
prop_value: JSValuePointer | JSValueConstPointer,
get: JSValuePointer | JSValueConstPointer,
set: JSValuePointer | JSValueConstPointer,
configurable: boolean,
enumerable: boolean,
has_value: boolean,
) => void = this.module.cwrap("QTS_DefineProp", null, [
"number",
"number",
"number",
"number",
"number",
"number",
"boolean",
"boolean",
"boolean",
])
QTS_GetOwnPropertyNames: (
ctx: JSContextPointer,
out_ptrs: JSValuePointerPointerPointer,
out_len: UInt32Pointer,
obj: JSValuePointer | JSValueConstPointer,
flags: number,
) => JSValuePointer = this.module.cwrap("QTS_GetOwnPropertyNames", "number", [
"number",
"number",
"number",
"number",
"number",
])
QTS_Call: (
ctx: JSContextPointer,
func_obj: JSValuePointer | JSValueConstPointer,
this_obj: JSValuePointer | JSValueConstPointer,
argc: number,
argv_ptrs: JSValueConstPointerPointer,
) => JSValuePointer = this.module.cwrap("QTS_Call", "number", [
"number",
"number",
"number",
"number",
"number",
])
QTS_ResolveException: (ctx: JSContextPointer, maybe_exception: JSValuePointer) => JSValuePointer =
this.module.cwrap("QTS_ResolveException", "number", ["number", "number"])
QTS_Dump: (
ctx: JSContextPointer,
obj: JSValuePointer | JSValueConstPointer,
) => JSBorrowedCharPointer = this.module.cwrap("QTS_Dump", "number", ["number", "number"])
QTS_Eval: (
ctx: JSContextPointer,
js_code: BorrowedHeapCharPointer,
js_code_length: number,
filename: string,
detectModule: EvalDetectModule,
evalFlags: EvalFlags,
) => JSValuePointer = this.module.cwrap("QTS_Eval", "number", [
"number",
"number",
"number",
"string",
"number",
"number",
])
QTS_GetModuleNamespace: (
ctx: JSContextPointer,
module_func_obj: JSValuePointer | JSValueConstPointer,
) => JSValuePointer = this.module.cwrap("QTS_GetModuleNamespace", "number", ["number", "number"])
QTS_Typeof: (
ctx: JSContextPointer,
value: JSValuePointer | JSValueConstPointer,
) => OwnedHeapCharPointer = this.module.cwrap("QTS_Typeof", "number", ["number", "number"])
QTS_GetLength: (
ctx: JSContextPointer,
out_len: UInt32Pointer,
value: JSValuePointer | JSValueConstPointer,
) => number = this.module.cwrap("QTS_GetLength", "number", ["number", "number", "number"])
QTS_IsEqual: (
ctx: JSContextPointer,
a: JSValuePointer | JSValueConstPointer,
b: JSValuePointer | JSValueConstPointer,
op: IsEqualOp,
) => number = this.module.cwrap("QTS_IsEqual", "number", ["number", "number", "number", "number"])
QTS_GetGlobalObject: (ctx: JSContextPointer) => JSValuePointer = this.module.cwrap(
"QTS_GetGlobalObject",
"number",
["number"],
)
QTS_NewPromiseCapability: (
ctx: JSContextPointer,
resolve_funcs_out: JSValuePointerPointer,
) => JSValuePointer = this.module.cwrap("QTS_NewPromiseCapability", "number", [
"number",
"number",
])
QTS_PromiseState: (
ctx: JSContextPointer,
promise: JSValuePointer | JSValueConstPointer,
) => JSPromiseStateEnum = this.module.cwrap("QTS_PromiseState", "number", ["number", "number"])
QTS_PromiseResult: (
ctx: JSContextPointer,
promise: JSValuePointer | JSValueConstPointer,
) => JSValuePointer = this.module.cwrap("QTS_PromiseResult", "number", ["number", "number"])
QTS_TestStringArg: (string: string) => void = this.module.cwrap("QTS_TestStringArg", null, [
"string",
])
QTS_GetDebugLogEnabled: (rt: JSRuntimePointer) => number = this.module.cwrap(
"QTS_GetDebugLogEnabled",
"number",
["number"],
)
QTS_SetDebugLogEnabled: (rt: JSRuntimePointer, is_enabled: number) => void = this.module.cwrap(
"QTS_SetDebugLogEnabled",
null,
["number", "number"],
)
QTS_BuildIsDebug: () => number = this.module.cwrap("QTS_BuildIsDebug", "number", [])
QTS_BuildIsAsyncify: () => number = this.module.cwrap("QTS_BuildIsAsyncify", "number", [])
QTS_NewFunction: (
ctx: JSContextPointer,
name: string,
arg_length: number,
is_constructor: boolean,
host_ref_id: HostRefId,
) => JSValuePointer = this.module.cwrap("QTS_NewFunction", "number", [
"number",
"string",
"number",
"boolean",
"number",
])
QTS_ArgvGetJSValueConstPointer: (
argv: JSValuePointer | JSValueConstPointer,
index: number,
) => JSValueConstPointer = this.module.cwrap("QTS_ArgvGetJSValueConstPointer", "number", [
"number",
"number",
])
QTS_RuntimeEnableInterruptHandler: (rt: JSRuntimePointer) => void = this.module.cwrap(
"QTS_RuntimeEnableInterruptHandler",
null,
["number"],
)
QTS_RuntimeDisableInterruptHandler: (rt: JSRuntimePointer) => void = this.module.cwrap(
"QTS_RuntimeDisableInterruptHandler",
null,
["number"],
)
QTS_RuntimeEnableModuleLoader: (rt: JSRuntimePointer, use_custom_normalize: number) => void =
this.module.cwrap("QTS_RuntimeEnableModuleLoader", null, ["number", "number"])
QTS_RuntimeDisableModuleLoader: (rt: JSRuntimePointer) => void = this.module.cwrap(
"QTS_RuntimeDisableModuleLoader",
null,
["number"],
)
QTS_bjson_encode: (
ctx: JSContextPointer,
val: JSValuePointer | JSValueConstPointer,
) => JSValuePointer = this.module.cwrap("QTS_bjson_encode", "number", ["number", "number"])
QTS_bjson_decode: (
ctx: JSContextPointer,
data: JSValuePointer | JSValueConstPointer,
) => JSValuePointer = this.module.cwrap("QTS_bjson_decode", "number", ["number", "number"])
}