specbridge_typescript_provider_consumer_contract_quickstart.ts

1import { SpecBridge, Spec } from '@ipation/specbridge';
2
3// 1. Define the Specification (The Contract)
4interface MyServiceSpec extends Spec {
5  greet: {
6    params: { name: string };
7    returns: string;
8  };
9  add: {
10    params: { a: number; b: number };
11    returns: number;
12  };
13}
14
15// 2. Implement the Provider
16const provider = SpecBridge.createProvider<MyServiceSpec>({
17  greet: async ({ name }) => `Hello, ${name}!`,
18  add: async ({ a, b }) => a + b,
19});
20
21// 3. Create the Consumer (Client)
22// In a real scenario, the consumer would use a transport layer
23const consumer = SpecBridge.createConsumer<MyServiceSpec>(provider.handler);
24
25async function run() {
26  const greeting = await consumer.greet({ name: 'World' });
27  console.log(greeting); // Output: Hello, World!
28
29  const sum = await consumer.add({ a: 5, b: 10 });
30  console.log(sum); // Output: 15
31}
32
33run();