@actnet/app-core - v0.1.0

High-level TypeScript wrapper over the app-core napi-rs bindings.

What this layer adds on top of the raw native module:

• Millisecond number timestamps become Temporal.Instant.
• deliveryStatus: number becomes DeliveryStatus ("sending" | "sent" | "delivered" | "read").
• Group role: number becomes GroupRole ("member" | "admin").
• Buffer becomes Uint8Array on every byte field (zero-copy — Buffer is a Uint8Array subclass).
• ConnectionState and IncomingEvent are typed as discriminated unions.

Runtime requirements

Node ≥ 26 with a native Temporal global. Standard nodejs.org Node 26 binaries include it; some distro builds (notably node:26-alpine without the Rust toolchain at build time) ship without it. If globalThis.Temporal is undefined, any method that hands in or returns an Instant will throw.

Getting started

import { initLogging, AppCore } from "@actnet/app-core";

initLogging("info");

const core = await AppCore.createAccount(
  "https://homeserver.example",
  "/var/lib/mybot/store.db",
  "", // SQLCipher passphrase
  new Uint8Array(0),     // no recovery key
  "MyBot",
);

console.log("registered as", core.did());

// Background receive loop.
(async () => {
  for await (const e of core.events()) {
    if (e.kind === "message") console.log("got:", e.message.body);
  }
})();

await core.sendDm("did:plc:abc...", "hi");
Copy