@parity/product-sdk-host 0.4.0 → 0.6.0

package/src/theme.ts

@@ -0,0 +1,106 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Higher-level wrapper for the host's theme subscription.
+ *
+ * `hostApi.themeSubscribe` is reachable via {@link getTruApi}, but consumers
+ * have to wire the subscription envelope themselves. `getThemeProvider`
+ * returns the `@novasamatech/host-api-wrapper` theme provider object directly,
+ * giving callers a `subscribeTheme(cb)` method that resolves to a typed
+ * {@link ThemeMode} — a `{ name, variant }` struct where `variant` is
+ * `"Light" | "Dark"` — and yields a `Subscription<void>` handle.
+ *
+ * @remarks
+ * As of `host-api(-wrapper)` v0.8 the theme payload is a struct, not a flat
+ * `"light" | "dark"` string: read {@link ThemeMode.variant} for the
+ * light/dark value (now capitalized) and {@link ThemeMode.name} for the
+ * active theme name (`Default`, or `Custom` carrying a string id).
+ *
+ * @module
+ */
+
+import { createLogger } from "@parity/product-sdk-logger";
+
+import type {
+    createThemeProvider,
+    ThemeMode as NovasamaThemeMode,
+} from "@novasamatech/host-api-wrapper";
+
+const log = createLogger("host:theme");
+
+/**
+ * Host theme provider handle. Exposes `subscribeTheme(callback)` which
+ * receives a typed {@link ThemeMode} struct on every change and returns a
+ * `Subscription<void>` (`unsubscribe` + `onInterrupt`).
+ *
+ * Type identical to `createThemeProvider()` from
+ * `@novasamatech/host-api-wrapper`.
+ */
+export type ThemeProvider = ReturnType<typeof createThemeProvider>;
+
+/**
+ * Host theme value. Re-exported from `@novasamatech/host-api-wrapper`.
+ *
+ * A `{ name, variant }` struct as of v0.8 (previously a flat
+ * `"light" | "dark"` string).
+ */
+export type ThemeMode = NovasamaThemeMode;
+
+/** Light/dark variant of the active theme: `"Light" | "Dark"`. */
+export type ThemeVariant = ThemeMode["variant"];
+
+/**
+ * Active theme name: `{ tag: "Default" }`, or `{ tag: "Custom", value }`
+ * carrying the custom theme's string id.
+ */
+export type ThemeName = ThemeMode["name"];
+
+/**
+ * Get the host theme provider.
+ *
+ * Returns the theme-subscription handle exported by
+ * `@novasamatech/host-api-wrapper`, or `null` if the package is unavailable
+ * (running outside a host container or the optional peer dep isn't
+ * installed).
+ *
+ * Implementation note: upstream `@novasamatech/host-api-wrapper` exports only
+ * the `createThemeProvider` factory and no `themeProvider` singleton, so
+ * this getter constructs a fresh instance on each call (unlike
+ * {@link getPreimageManager} or {@link getHostLocalStorage}, which return
+ * upstream singletons). The constructed provider is cheap to allocate; it
+ * only opens a subscription when `subscribeTheme` is called.
+ *
+ * @returns The theme provider, or `null` if unavailable.
+ *
+ * @example
+ * ```ts
+ * import { getThemeProvider } from "@parity/product-sdk-host";
+ *
+ * const provider = await getThemeProvider();
+ * if (provider) {
+ *   const sub = provider.subscribeTheme((theme) => {
+ *     document.documentElement.dataset.theme = theme.variant.toLowerCase();
+ *     if (theme.name.tag === "Custom") loadCustomTheme(theme.name.value);
+ *   });
+ *   // sub.unsubscribe() to stop listening
+ * }
+ * ```
+ */
+export async function getThemeProvider(): Promise<ThemeProvider | null> {
+    try {
+        const sdk = await import("@novasamatech/host-api-wrapper");
+        return sdk.createThemeProvider();
+    } catch (err) {
+        log.debug("getThemeProvider unavailable", err);
+        return null;
+    }
+}
+
+if (import.meta.vitest) {
+    const { test, expect } = import.meta.vitest;
+
+    test("getThemeProvider returns provider when SDK is available", async () => {
+        const provider = await getThemeProvider();
+        expect(provider === null || typeof provider === "object").toBe(true);
+    });
+}

package/src/truapi.ts

@@ -1,7 +1,9 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
  * TruAPI - the protocol for communicating between apps and the Polkadot host container.
  *
- * This module centralizes access to @novasamatech/product-sdk and @novasamatech/host-api,
+ * This module centralizes access to @novasamatech/host-api-wrapper and @novasamatech/host-api,
  * allowing other @parity/product-sdk-* packages to import from here rather than depending
  * directly on novasama packages.
  *
@@ -16,29 +18,56 @@ import type {
     AllocationOutcome as AllocationOutcomeCodec,
     CodecType,
     RemotePermission as RemotePermissionCodec,
-    Statement as StatementCodec,
 } from "@novasamatech/host-api";
+import type { createAccountsProvider, preimageManager } from "@novasamatech/host-api-wrapper";
 
-import type { StatementProof } from "./types.js";
+import { isInsideContainer } from "./container.js";
+import type { Statement, StatementProof } from "./types.js";
 
 const log = createLogger("host");
 
 /**
- * Extract a human-readable message from an unknown error. `JSON.stringify`
- * on `Error` returns `"{}"` because `message` and `stack` are non-enumerable
- * — without this helper, wire failures surface as `"... failed: {}"` with
- * zero diagnostic context.
+ * Extract a human-readable message from a host-side error. Hosts wrap
+ * errors in versioned envelopes (`{ tag: "v1", value: CodecError }`); this
+ * helper unwraps the envelope and renders the inner error's `name`/`message`
+ * so callers see the host's actual diagnostic instead of `"[object Object]"`
+ * (from `String(err)`) or a JSON-stringified envelope.
+ *
+ * Exported for the higher-level wrappers (`requestPermission`,
+ * `deriveEntropy`, etc.) that build their `throw new Error(...)` messages.
  */
-function formatError(err: unknown): string {
-    if (err instanceof Error) return err.message;
-    if (typeof err === "string") return err;
+export function formatHostError(err: unknown): string {
+    // Single-level unwrap only; nested envelopes fall through to JSON.stringify.
+    const inner = isVersionedEnvelope(err) ? err.value : err;
+
+    if (inner instanceof Error) return inner.message;
+    if (typeof inner === "string") return inner;
+    if (
+        inner != null &&
+        typeof inner === "object" &&
+        "message" in inner &&
+        typeof (inner as { message: unknown }).message === "string"
+    ) {
+        const named = inner as { name?: unknown; message: string };
+        return typeof named.name === "string" ? `${named.name}: ${named.message}` : named.message;
+    }
     try {
-        return JSON.stringify(err);
+        return JSON.stringify(inner);
     } catch {
-        return String(err);
+        return String(inner);
     }
 }
 
+function isVersionedEnvelope(value: unknown): value is { tag: string; value: unknown } {
+    return (
+        value != null &&
+        typeof value === "object" &&
+        "tag" in value &&
+        "value" in value &&
+        typeof (value as { tag: unknown }).tag === "string"
+    );
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Helpers from @novasamatech/host-api (re-exported from @novasamatech/scale)
 // ─────────────────────────────────────────────────────────────────────────────
@@ -99,16 +128,19 @@ export type { HexString } from "@novasamatech/host-api";
  * The TruApi type - provides low-level methods for communicating with the host.
  *
  * Methods include:
- * - `navigateTo(url)` — Navigate to a URL within the host
- * - `permission(permissions)` — Request permissions from the host
- * - `localStorageRead/Write/Clear` — Host-backed storage
- * - `sign(payload)` — Request transaction signing
- * - `deriveEntropy(context)` — Derive deterministic entropy
- * - `themeSubscribe()` — Subscribe to host theme changes
+ * - `navigateTo(url)` - Navigate to a URL within the host
+ * - `permission(permissions)` - Request permissions from the host
+ * - `localStorageRead/Write/Clear` - Host-backed storage
+ * - `sign(payload)` - Request transaction signing
+ * - `deriveEntropy(context)` - Derive deterministic entropy
+ * - `themeSubscribe()` - Subscribe to host theme changes
  * - And many more...
+ *
+ * Type identical to `hostApi` from `@novasamatech/host-api-wrapper` so that
+ * `truApi.X(...)` calls keep their full inference (return types, method
+ * names, parameter shapes) instead of decaying to `any`.
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export type TruApi = any;
+export type TruApi = typeof import("@novasamatech/host-api-wrapper").hostApi;
 
 /** Cached TruApi instance */
 let cachedTruApi: TruApi | null = null;
@@ -116,7 +148,7 @@ let cachedTruApi: TruApi | null = null;
 /**
  * Get the TruAPI instance for direct low-level access.
  *
- * Returns the `hostApi` object from `@novasamatech/product-sdk` which provides
+ * Returns the `hostApi` object from `@novasamatech/host-api-wrapper` which provides
  * methods for communicating directly with the host container. Returns `null`
  * when running outside a container or when the SDK is unavailable.
  *
@@ -149,7 +181,7 @@ export async function getTruApi(): Promise<TruApi | null> {
     if (cachedTruApi) return cachedTruApi;
 
     try {
-        const sdk = await import("@novasamatech/product-sdk");
+        const sdk = await import("@novasamatech/host-api-wrapper");
         cachedTruApi = sdk.hostApi;
         log.debug("TruAPI loaded");
         return cachedTruApi;
@@ -185,34 +217,44 @@ export async function getTruApi(): Promise<TruApi | null> {
  */
 export async function getPreimageManager(): Promise<PreimageManager | null> {
     try {
-        const sdk = await import("@novasamatech/product-sdk");
+        const sdk = await import("@novasamatech/host-api-wrapper");
         return sdk.preimageManager;
-    } catch {
+    } catch (err) {
+        log.debug("getPreimageManager unavailable", err);
         return null;
     }
 }
 
 /**
- * Preimage manager interface for bulletin chain operations.
+ * Preimage manager handle for bulletin chain operations. `lookup` returns a
+ * `Subscription<void>` (`unsubscribe` + `onInterrupt`); `submit` returns a
+ * `0x`-prefixed hex preimage key.
+ *
+ * Type identical to `preimageManager` from `@novasamatech/host-api-wrapper`.
  */
-export interface PreimageManager {
-    /**
-     * Submit a preimage to the bulletin chain.
-     * @param data - The data to submit.
-     * @returns The preimage key (hex string).
-     */
-    submit(data: Uint8Array): Promise<string>;
+export type PreimageManager = typeof preimageManager;
 
-    /**
-     * Look up a preimage by key.
-     * @param key - The preimage key (hex string).
-     * @param callback - Called with the data when found, or null if not yet available.
-     * @returns Subscription handle with unsubscribe method.
-     */
-    lookup(
-        key: string,
-        callback: (preimage: Uint8Array | null) => void,
-    ): { unsubscribe: () => void; onInterrupt: (cb: () => void) => () => void };
+/**
+ * Construct a fresh `PreimageManager` instance with an optional custom
+ * transport. Use this when you need a non-default transport; otherwise
+ * prefer {@link getPreimageManager}, which returns the shared singleton.
+ *
+ * Mirrors `createPreimageManager` from `@novasamatech/host-api-wrapper`.
+ *
+ * @param transport - Optional transport; defaults to the sandbox transport.
+ * @returns A new `PreimageManager` instance, or `null` if unavailable.
+ */
+export async function createHostPreimageManager(
+    transport?: import("@novasamatech/host-api").Transport,
+): Promise<PreimageManager | null> {
+    if (!(await isInsideContainer())) return null;
+    try {
+        const sdk = await import("@novasamatech/host-api-wrapper");
+        return sdk.createPreimageManager(transport);
+    } catch (err) {
+        log.debug("createHostPreimageManager unavailable", err);
+        return null;
+    }
 }
 
 /**
@@ -222,9 +264,10 @@ export interface PreimageManager {
  */
 export async function getAccountsProvider(): Promise<AccountsProvider | null> {
     try {
-        const sdk = await import("@novasamatech/product-sdk");
-        return sdk.createAccountsProvider() as unknown as AccountsProvider;
-    } catch {
+        const sdk = await import("@novasamatech/host-api-wrapper");
+        return sdk.createAccountsProvider();
+    } catch (err) {
+        log.debug("getAccountsProvider unavailable", err);
         return null;
     }
 }
@@ -278,7 +321,7 @@ export type RemotePermissionTag = RemotePermission["tag"];
  * @example
  * ```ts
  * const outcomes = await requestResourceAllocation([
- *   { tag: "BulletInAllowance", value: undefined },
+ *   { tag: "BulletinAllowance", value: undefined },
  * ]);
  * if (outcomes[0].tag === "Allocated") { ... }
  * ```
@@ -296,7 +339,7 @@ export async function requestResourceAllocation(
     return await truApi.requestResourceAllocation(enumValue("v1", resources)).match(
         (envelope: { tag: "v1"; value: AllocationOutcome[] }) => envelope.value,
         (err: unknown) => {
-            throw new Error(`requestResourceAllocation failed: ${formatError(err)}`, {
+            throw new Error(`requestResourceAllocation failed: ${formatHostError(err)}`, {
                 cause: err,
             });
         },
@@ -307,22 +350,6 @@ export async function requestResourceAllocation(
 // Authorized Statement Store proof creation (RFC-10 §"Statement Store allowance")
 // ─────────────────────────────────────────────────────────────────────────────
 
-/**
- * A Statement payload destined for the Statement Store. Matches the
- * `pallet-statement` Statement structure.
- *
- * The optional `proof` field is the same {@link StatementProof} shape that
- * {@link createProofAuthorized} returns: pass `undefined` here, call
- * `createProofAuthorized` to obtain the proof, then attach it before
- * submitting via `HostStatementStore.submit`. The `OnChain` variant of
- * `StatementProof` is a chain-attestation reference; the `Sr25519` /
- * `Ed25519` / `Ecdsa` variants are signing proofs.
- *
- * Derived from the upstream codec so structural changes surface as compile
- * errors here, not runtime decode failures.
- */
-export type Statement = CodecType<typeof StatementCodec>;
-
 /**
  * Have the host sign a Statement using an allowance-bearing account it
  * picks internally — RFC-10 §"Statement Store allowance".
@@ -378,7 +405,9 @@ export async function createProofAuthorized(statement: Statement): Promise<State
     return await truApi.statementStoreCreateProofAuthorized(enumValue("v1", statement)).match(
         (envelope: { tag: "v1"; value: StatementProof }) => envelope.value,
         (err: unknown) => {
-            throw new Error(`createProofAuthorized failed: ${formatError(err)}`, { cause: err });
+            throw new Error(`createProofAuthorized failed: ${formatHostError(err)}`, {
+                cause: err,
+            });
         },
     );
 }
@@ -431,99 +460,16 @@ export interface ResultAsync<T, E> {
 }
 
 /**
- * Accounts provider interface from @novasamatech/product-sdk.
- *
- * Provides methods for accessing host wallet accounts, product accounts,
- * and Ring VRF operations.
+ * Accounts provider handle from `@novasamatech/host-api-wrapper`. Surfaces the
+ * full upstream API - host wallet accounts, app-scoped product accounts,
+ * Ring VRF, user identity (`getUserId`, `requestLogin`), and connection
+ * status subscription.
+ *
+ * Type identical to `createAccountsProvider()` from
+ * `@novasamatech/host-api-wrapper`; methods return neverthrow `ResultAsync`
+ * values with typed `CodecError` variants in the error channel.
  */
-export interface AccountsProvider {
-    /**
-     * Get legacy accounts (user's external wallets connected to the host).
-     *
-     * Renamed from `getNonProductAccounts` in @novasamatech/product-sdk 0.7.
-     *
-     * @returns ResultAsync resolving to array of accounts.
-     */
-    getLegacyAccounts: () => ResultAsync<HostAccount[], unknown>;
-
-    /**
-     * Get a signer for a legacy account.
-     *
-     * Renamed from `getNonProductAccountSigner` in @novasamatech/product-sdk 0.7.
-     *
-     * @param account - The product account (used for public key lookup).
-     * @returns A PolkadotSigner for signing transactions.
-     */
-    getLegacyAccountSigner: (account: ProductAccount) => import("polkadot-api").PolkadotSigner;
-
-    /**
-     * Get an app-scoped product account from the host.
-     *
-     * Product accounts are derived by the host wallet for each app, identified
-     * by `dotNsIdentifier` (e.g., "mark3t.dot"). The user controls these accounts
-     * but they are scoped to the requesting app.
-     *
-     * @param dotNsIdentifier - App identifier (e.g., "mark3t.dot").
-     * @param derivationIndex - Derivation index within the app scope. Default: 0
-     * @returns ResultAsync resolving to the account.
-     */
-    getProductAccount: (
-        dotNsIdentifier: string,
-        derivationIndex?: number,
-    ) => ResultAsync<HostAccount, unknown>;
-
-    /**
-     * Get a signer for a product account.
-     *
-     * @param account - The product account.
-     * @returns A PolkadotSigner for signing transactions.
-     */
-    getProductAccountSigner: (account: ProductAccount) => import("polkadot-api").PolkadotSigner;
-
-    /**
-     * Get a contextual alias for a product account via Ring VRF.
-     *
-     * Aliases prove account membership in a ring without revealing which
-     * account produced the alias.
-     *
-     * @param dotNsIdentifier - App identifier.
-     * @param derivationIndex - Derivation index. Default: 0
-     * @returns ResultAsync resolving to the contextual alias.
-     */
-    getProductAccountAlias: (
-        dotNsIdentifier: string,
-        derivationIndex?: number,
-    ) => ResultAsync<ContextualAlias, unknown>;
-
-    /**
-     * Create a Ring VRF proof for anonymous operations.
-     *
-     * Proves that the signer is a member of the ring at the given location
-     * without revealing which member.
-     *
-     * @param dotNsIdentifier - App identifier.
-     * @param derivationIndex - Derivation index.
-     * @param location - Ring location on-chain.
-     * @param message - Message to sign.
-     * @returns ResultAsync resolving to the proof bytes.
-     */
-    createRingVRFProof: (
-        dotNsIdentifier: string,
-        derivationIndex: number,
-        location: unknown,
-        message: Uint8Array,
-    ) => ResultAsync<Uint8Array, unknown>;
-
-    /**
-     * Subscribe to account connection status changes.
-     *
-     * @param callback - Called with status string ("connected" | "disconnected").
-     * @returns Unsubscribe handle.
-     */
-    subscribeAccountConnectionStatus: (
-        callback: (status: string) => void,
-    ) => { unsubscribe: () => void } | (() => void);
-}
+export type AccountsProvider = ReturnType<typeof createAccountsProvider>;
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Tests
@@ -546,6 +492,22 @@ if (import.meta.vitest) {
         expect(manager === null || typeof manager === "object").toBe(true);
     });
 
+    test("createHostPreimageManager returns null outside container", async () => {
+        expect(await createHostPreimageManager()).toBeNull();
+    });
+
+    test("formatHostError unwraps versioned envelopes and renders CodecError", () => {
+        expect(
+            formatHostError({
+                tag: "v1",
+                value: { name: "GenericError", message: "boom" },
+            }),
+        ).toBe("GenericError: boom");
+        expect(formatHostError(new Error("plain"))).toBe("plain");
+        expect(formatHostError("string err")).toBe("string err");
+        expect(formatHostError({ tag: "v1", value: { message: "no-name" } })).toBe("no-name");
+    });
+
     test("getAccountsProvider returns provider when SDK is available", async () => {
         // In dev/test mode, product-sdk is installed, so this returns a provider
         const provider = await getAccountsProvider();
@@ -563,7 +525,7 @@ if (import.meta.vitest) {
         const api = await getTruApi();
         if (api === null) {
             await expect(
-                requestResourceAllocation([{ tag: "BulletInAllowance", value: undefined }]),
+                requestResourceAllocation([{ tag: "BulletinAllowance", value: undefined }]),
             ).rejects.toThrow(/TruAPI unavailable/);
         } else {
             expect(typeof requestResourceAllocation).toBe("function");

package/src/types.ts

@@ -1,62 +1,85 @@
+// Copyright 2026 Parity Technologies (UK) Ltd.
+// SPDX-License-Identifier: Apache-2.0
 /**
- * Persistent string and JSON storage exposed by the host container. Most
- * apps reach it indirectly through the Storage package's `KvStore`; reach for
- * it directly via {@link getHostLocalStorage} when you need raw host storage
- * without the KV abstraction.
+ * Public types for the host wrappers.
+ *
+ * These are re-exported from `@novasamatech/host-api-wrapper` (the runtime
+ * objects the host getters cast to) rather than hand-mirrored, so the
+ * Parity surface stays in lockstep with the upstream codec types.
  */
-export interface HostLocalStorage {
-    readString(key: string): Promise<string | null>;
-    writeString(key: string, value: string): Promise<void>;
-    readJSON<T>(key: string): Promise<T | null>;
-    writeJSON<T>(key: string, value: T): Promise<void>;
-    /**
-     * Clear a specific key from storage.
-     * @param key - The key to clear
-     */
-    clear(key: string): Promise<void>;
-}
+
+import type {
+    hostLocalStorage,
+    createStatementStore,
+    ProductAccountId as NovasamaProductAccountId,
+    SignedStatement as NovasamaSignedStatement,
+    Statement as NovasamaStatement,
+    StatementTopicFilter as NovasamaStatementTopicFilter,
+    StatementsPage as NovasamaStatementsPage,
+    Topic as NovasamaTopic,
+} from "@novasamatech/host-api-wrapper";
+import type { Subscription } from "@novasamatech/host-api";
+
+/**
+ * Persistent storage exposed by the host container, including string, JSON
+ * and raw byte (`readBytes`/`writeBytes`) accessors. Most apps reach it
+ * indirectly through the Storage package's `KvStore`; reach for it directly
+ * via {@link getHostLocalStorage} when you need raw host storage without the
+ * KV abstraction.
+ *
+ * Type identical to `hostLocalStorage` from `@novasamatech/host-api-wrapper`.
+ */
+export type HostLocalStorage = typeof hostLocalStorage;
 
 /**
  * Cryptographic proof attached to a statement before submission, returned by
  * {@link HostStatementStore.createProof}. Variants cover the supported
- * signature schemes — `Sr25519`, `Ed25519`, `Ecdsa`, and `OnChain` (chain-
+ * signature schemes - `Sr25519`, `Ed25519`, `Ecdsa`, and `OnChain` (chain-
  * attestation-based proofs).
  *
- * Mirrors `@novasamatech/product-sdk@0.7`'s proof shape.
+ * Inferred from `createStatementStore().createProof`'s return type so codec
+ * changes surface here as compile errors, not runtime decode failures.
  */
-export type StatementProof =
-    | { tag: "Sr25519"; value: { signature: Uint8Array; signer: Uint8Array } }
-    | { tag: "Ed25519"; value: { signature: Uint8Array; signer: Uint8Array } }
-    | { tag: "Ecdsa"; value: { signature: Uint8Array; signer: Uint8Array } }
-    | {
-          tag: "OnChain";
-          value: { who: Uint8Array; blockHash: Uint8Array; event: bigint };
-      };
+export type StatementProof = Awaited<
+    ReturnType<ReturnType<typeof createStatementStore>["createProof"]>
+>;
 
 /**
- * Topic-based subscription filter. Mirrors `StatementTopicFilter` from
- * `@novasamatech/product-sdk` — the host delivers statements that match
+ * Topic-based subscription filter. The host delivers statements that match
  * either *all* of the listed topics (`matchAll`) or *any* of them
- * (`matchAny`).
+ * (`matchAny`). Re-exported from `@novasamatech/host-api-wrapper`.
  */
-export type StatementTopicFilter = { matchAll: Uint8Array[] } | { matchAny: Uint8Array[] };
+export type StatementTopicFilter = NovasamaStatementTopicFilter;
+
+/** A single topic value used inside a {@link StatementTopicFilter}. Re-exported from `@novasamatech/host-api-wrapper`. */
+export type Topic = NovasamaTopic;
+
+/** `[ss58Address, chainPrefix]` tuple identifying a product account at the codec layer. Re-exported from `@novasamatech/host-api-wrapper`. */
+export type ProductAccountId = NovasamaProductAccountId;
+
+/** Unsigned statement payload. Re-exported from `@novasamatech/host-api-wrapper`. */
+export type Statement = NovasamaStatement;
+
+/** Statement bundled with its {@link StatementProof}. Re-exported from `@novasamatech/host-api-wrapper`. */
+export type SignedStatement = NovasamaSignedStatement;
 
 /**
  * A page of signed statements delivered by {@link HostStatementStore.subscribe}.
  *
  * Pages arrive sequentially. `isComplete` is `true` on the final page of a
  * subscription's initial backfill; subsequent pages contain new statements
- * as they appear on chain.
+ * as they appear on chain. `statements` is `SignedStatement[]` (typed,
+ * not `unknown[]`).
  */
-export interface StatementsPage {
-    statements: unknown[];
-    isComplete: boolean;
-}
+export type StatementsPage = NovasamaStatementsPage;
 
-/** Subscription handle returned by the host. */
-export interface HostSubscription {
-    unsubscribe: () => void;
-}
+/**
+ * Subscription handle returned by the host - equivalent to
+ * `Subscription<void>` from `@novasamatech/host-api`. Exposes
+ * `unsubscribe()` plus an `onInterrupt` hook that fires if the host
+ * interrupts the subscription server-side.
+ */
+export type HostSubscription = Subscription<void>;
 
 /**
  * Statement Store handle exposed by the host container. Provides
@@ -64,37 +87,7 @@ export interface HostSubscription {
  * host's native binary protocol; the `statement-store` package layers a
  * higher-level client on top.
  *
- * Shape matches `@novasamatech/product-sdk@0.7`'s `createStatementStore()`.
+ * Type identical to `createStatementStore()` from
+ * `@novasamatech/host-api-wrapper`.
  */
-export interface HostStatementStore {
-    /**
-     * Subscribe to statements matching the given topic filter.
-     *
-     * The callback is invoked once per page of statements. After the initial
-     * backfill completes (signaled by `page.isComplete === true`), subsequent
-     * pages contain new statements as they're produced.
-     *
-     * @param filter   - Topic match filter (`matchAll` or `matchAny`).
-     * @param callback - Called with each `StatementsPage` from the host.
-     * @returns Subscription handle with `unsubscribe`.
-     */
-    subscribe(
-        filter: StatementTopicFilter,
-        callback: (page: StatementsPage) => void,
-    ): HostSubscription;
-
-    /**
-     * Create a proof for a statement using the given account.
-     *
-     * @param accountId - The account ID tuple `[ss58Address, chainPrefix]` from product-sdk.
-     * @param statement - The unsigned statement.
-     * @returns The proof (signature + signer info, or chain-attestation reference).
-     */
-    createProof(accountId: [string, number], statement: unknown): Promise<StatementProof>;
-
-    /**
-     * Submit a signed statement to the bulletin chain.
-     * @param signedStatement - Statement with attached proof.
-     */
-    submit(signedStatement: unknown): Promise<void>;
-}
+export type HostStatementStore = ReturnType<typeof createStatementStore>;