Function builtinWasmPdkLoader

runtime/src/native.js:72–99

(module, ctx)

/* Built-in Path A fallback: instantiate guest, walk exports, annotate each fn with its guest's `__edge_alloc` + `__edge_memory`. */
async function builtinWasmPdkLoader(module, ctx) {
    const envFactory = makeGuestEnv(ctx.compilerExports);
    // Forward reference: the getter captures `instance` lazily. It's only read when env functions fire during VM execution, by which point `instance` is bound.
    const env = envFactory({ get memory() { return instance.exports.memory; } });
    // WebAssembly.instantiate(Module, ...) returns the Instance directly, not {module, instance}.
    const instance = await WebAssembly.instantiate(module, { env });

    if (typeof instance.exports.__edge_alloc !== 'function') {
        throw new Error(
            `native module missing '__edge_alloc(size: u32) -> *mut u8';` +
            ` see /reference/wasm-abi for the contract`
        );
    }

    const names = [];
    const fns = [];
    for (const [k, v] of Object.entries(instance.exports)) {
        if (k === 'memory' || typeof v !== 'function') continue;
        // Keep convention exports (__fn_/__class_/__const_), drop ABI internals like __edge_alloc.
        if (k.startsWith('__') && !k.startsWith('__class_') && !k.startsWith('__const_') && !k.startsWith('__fn_')) continue;
        names.push(k);
        v.__edge_alloc = instance.exports.__edge_alloc;
        v.__edge_memory = instance.exports.memory;
        v.__edge_kind = 'wasmpdk';
        fns.push(v);
    }
    return { kind: 'wasmpdk', names, fns };
}

/* Try custom loaders first; built-in Path A is the implicit fallback. */
export async function loadNativeModule(_spec, bytes, ctx) {