Files
tubestation/toolkit/components/uniffi-js/UniFFIRust.h
Ben Dean-Kawamura f25b21537e Bug 1918512 - Support for async Rust calls, r=nika,markh
Added the UniffiAsyncCallHandler class.  It follows the same basic
pattern as UniffiSyncCallHandler, but for async calls.
UniffiCallHandlerBase contains shared code between the two.

Replaced `use_async_wrapper` with `call_style`, which returns 1 of three
options rather than a boolean.  This required a slight change to the
async config for constructors.  User now need to specify `Object.new`
instead of `Object`.  One upside is that it also allows configuring
non-primary constructors.

Added a test fixture for this.  I used this fixture as an opportunity to
sketch out how I think this would work with the application-services
code and why this is an improvement over the current system for
auto-generating async wrappers.

Pass the buildconfig ENV when building the uniffi component libraries.
We need this if we want to depend on crates like `moz_task`.

Differential Revision: https://phabricator.services.mozilla.com/D227553
2024-11-25 17:51:01 +00:00

72 lines
2.2 KiB
C++

/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
* You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef mozilla_UniFFIRust_h
#define mozilla_UniFFIRust_h
#include <stdint.h>
namespace mozilla::uniffi {
// Low-level Rust structs for UniFFI
// RustCallStatus.code values
constexpr int8_t RUST_CALL_SUCCESS = 0;
constexpr int8_t RUST_CALL_ERROR = 1;
constexpr int8_t RUST_CALL_INTERNAL_ERROR = 2;
// Future continutation code values
constexpr int8_t UNIFFI_FUTURE_READY = 0;
constexpr int8_t UNIFFI_FUTURE_MAYBE_READY = 1;
// Return values for callback interfaces (See
// https://github.com/mozilla/uniffi-rs/blob/main/uniffi_core/src/ffi/foreigncallbacks.rs
// for details)
constexpr int8_t CALLBACK_INTERFACE_SUCCESS = 0;
constexpr int8_t CALLBACK_INTERFACE_ERROR = 1;
constexpr int8_t CALLBACK_INTERFACE_UNEXPECTED_ERROR = 2;
// structs/functions from UniFFI
extern "C" {
struct RustBuffer {
uint64_t capacity;
uint64_t len;
uint8_t* data;
};
struct ForeignBytes {
int32_t len;
uint8_t* data;
};
struct RustCallStatus {
int8_t code;
RustBuffer error_buf;
};
typedef int (*ForeignCallback)(uint64_t handle, uint32_t method,
const uint8_t* argsData, int32_t argsLen,
RustBuffer* buf_ptr);
typedef void (*FutureCallback)(uint64_t futureHandle, int8_t code);
// Poll a future.
//
// If the future is ready, then `futureCallback` will be called with
// `UNIFFI_FUTURE_READY` If the future is pending, then `futureCallback` will be
// called with `UNIFFI_FUTURE_MAYBE_READY` when the Rust waker is invoked.
typedef void (*PollFutureFn)(uint64_t futureHandle, FutureCallback callback,
uint64_t callback_data);
// Free a future
typedef void (*FreeFutureFn)(uint64_t futureHandle);
RustBuffer uniffi_rustbuffer_alloc(uint64_t size, RustCallStatus* call_status);
void uniffi_rustbuffer_free(RustBuffer buf, RustCallStatus* call_status);
}
} // namespace mozilla::uniffi
#endif /* mozilla_UniFFIRust_h */