@dg-superapp/bridge-adapter-example

EDUCATIONAL STUB — NOT FOR PRODUCTION USE.

This package is a minimal, in-memory reference implementation of the BridgeAdapter contract. It exists solely to show public consumers the shape of a working adapter. Every response is a hardcoded value from an in-memory state object. There is no real backend, no HTTP, no persistence, no retry, no observability, no telemetry.

What it does

Implements BridgeAdapter from @dg-superapp/bridge-core with two handler responses wired into callHandler():

• userProfile — returns a static "Jane Example" profile
• initializeMiniApp — returns { os: "example" }
• everything else — returns a structured UNSUPPORTED failure

initialize() and dispose() are no-ops.

What it is for

• Reading as a template for your own adapter
• Running in unit tests where you need a valid BridgeAdapter with predictable responses
• Demonstrating handler dispatch without pulling in WebView, flutter_inappwebview, or any other platform-specific plumbing

What it is NOT for

• Production traffic
• Real user data
• Anything that needs network I/O, persistence, encryption, or retry

If you are looking for a real adapter to model after, see packages/adapter-dg for a full production implementation with WebView plumbing, error handling, timeout semantics, and response normalization.

Usage

import { createExampleAdapter } from "@dg-superapp/bridge-adapter-example";

const adapter = createExampleAdapter();
await adapter.initialize();

const result = await adapter.callHandler("userProfile", []);
console.log(result);
// { success: true, data: { userId: "USER_0001", ... }, message: "OK" }

How to turn this into a real adapter

1. Copy src/ExampleAdapter.ts into your own package.
2. Replace the SUPPORTED_HANDLERS set and the switch in callHandler() with calls into your real platform (native bridge, HTTP client, WebView message channel, etc).
3. Change platformId and platformName to match your platform.
4. Register your adapter's factory via registerAdapterImport() in a module side-effect so the SDK can lazy-load it when your platform is detected.

License

MIT — same as the parent monorepo.