docs(examples): typescript / javascript (#102)

Co-authored-by: Stefan Majer <stefan.majer@f-i-ts.de>

Author: vknabel

examples/README.md

@@ -21,4 +21,7 @@ sh curl/ip-list.sh
 
 # Python:
 python python/ip-list.py
+
+# TypeScript / JavaScript:
+cd js && bun i && bun run ip-list.ts
 ```

examples/js/bun.lock

@@ -0,0 +1,55 @@
+import * as apiv2 from "@metal-stack/api/js/metalstack/api/v2/ip_pb";
+import { createClient } from "@connectrpc/connect";
+import { createConnectTransport } from "@connectrpc/connect-web";
+
+import { Code, ConnectError, Interceptor } from "@connectrpc/connect";
+
+class AuthInterceptor {
+  private authToken: string;
+
+  constructor(authToken: string) {
+    this.authToken = authToken;
+  }
+
+  interceptor: Interceptor = (next) => async (req) => {
+    if (!this.authToken) {
+      throw new ConnectError("Missing auth token", Code.Unauthenticated);
+    }
+
+    req.header.append("Authorization", `Bearer ${this.authToken}`);
+
+    try {
+      const res = await next(req);
+      return res;
+    } catch (e) {
+      if (e instanceof ConnectError && e.code === Code.Unauthenticated) {
+        // e.g. message: "token has expired"
+        console.error("unauthenticated", e);
+      }
+      throw e;
+    }
+  };
+}
+
+async function main() {
+  const token = process.env["API_TOKEN"];
+  const project = process.env["PROJECT_ID"];
+  const baseUrl = process.env["METAL_APISERVER_URL"];
+
+  const auth = new AuthInterceptor(token!);
+  const client = createClient(
+    apiv2.IPService,
+    createConnectTransport({
+      baseUrl: baseUrl!,
+      interceptors: [auth.interceptor],
+    }),
+  );
+
+  const listResp = await client.list({ project });
+
+  for (const ip of listResp.ips) {
+    console.log("ip", ip);
+  }
+}
+
+main();

examples/js/ip-list.ts

@@ -0,0 +1,22 @@
+{
+  "name": "metal-stack-api-example",
+  "version": "1.0.0",
+  "private": true,
+  "description": "@metal-stack/api example",
+  "main": "ip-list.ts",
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "ip-list": "npm run build && node ./ip-list.js"
+  },
+  "author": "metal-stack",
+  "license": "MIT",
+  "dependencies": {
+    "@connectrpc/connect": "^2.1.1",
+    "@connectrpc/connect-web": "^2.1.1",
+    "@metal-stack/api": "^0.0.47"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "typescript": "^5.9.3"
+  }
+}