feat(api): generate AIP TypeScript SDK

Author: tothandras

.github/workflows/ci.yaml

@@ -699,6 +699,20 @@ jobs:
         run: |
           nix develop --impure .#ci -c go test -v -count=1 ./quickstart/
 
+      - name: Run TypeScript SDK example
+        env:
+          OPENMETER_URL: http://localhost:48888/api/v3
+        working-directory: api/spec
+        run: |
+          # Build dist/ from src/, then run the quickstart example against it.
+          nix develop --impure ../../.#ci -c bash -c '
+            set -euo pipefail
+            corepack enable >/dev/null 2>&1 || true
+            pnpm install --frozen-lockfile 2>&1 | tail -5
+            pnpm --filter @openmeter/sdk run build
+            node --experimental-strip-types packages/aip-client-javascript/examples/quickstart/main.ts
+          '
+
       - name: Cleanup Docker Compose
         run: docker compose -f docker-compose.yaml -f docker-compose.override.yaml down -v
         working-directory: quickstart

AGENTS.md

@@ -90,6 +90,10 @@ All generated files have `// Code generated by X, DO NOT EDIT.` headers — neve
 2. Run `make gen-api` to regenerate OpenAPI spec and SDKs
 3. Run `make generate` to regenerate Go server/client code
 
+The TypeSpec JS client emitted from `api/spec/packages/aip` now lands in `api/spec/packages/aip-client-javascript/`. Treat `api/spec/packages/aip-client-javascript/src/` and its generated `package.json` as emitter output: keep hand-written Playwright config, tests, and helpers outside `src/`, and put test runner dependencies/scripts in the stable `api/spec/package.json` workspace root instead of the generated client package manifest.
+
+The emitted `api/spec/packages/aip-client-javascript/src/openMeterClient.ts` exposes aggregated sub-client getters on `OpenMeterClient` (e.g. `meters`, `customers`, `features`, `productCatalog`, `subscriptions`, `billing`, `entitlements`). Access operations through those getters, e.g. `sdk.meters.list()`, `sdk.customers.create(...)`, `sdk.productCatalog.createPlan(...)`. Note that resources are grouped by tag, so some operations live under a grouped client rather than a same-named top-level getter (for example plan operations are `sdk.productCatalog.createPlan`, not `sdk.plans.create`).
+
 When adding query decorators (for example `@query`) to a TypeSpec file that does not already use HTTP decorators, import `@typespec/http` and add `using TypeSpec.Http;` in that file; otherwise compilation fails with `Unknown decorator @query`.
 
 **Workflow for changing Go types/DI:**

api/spec/.gitignore

@@ -1,5 +1,7 @@
 # TypeSpec output (all packages)
 **/output/
+**/dist/
 
 # Dependency directories
 node_modules/
+tsconfig.tsbuildinfo

api/spec/.prettierignore

@@ -1,3 +1,5 @@
 .npmrc
 pnpm-lock.yaml
 packages/**/output/
+packages/**/dist/
+packages/typespec-typescript/src/static-helpers/lib-files-data.gen.ts

api/spec/AGENTS.md

@@ -3,14 +3,20 @@
   "version": "0.1.0",
   "type": "module",
   "scripts": {
-    "generate": "pnpm --filter @openmeter/api-spec-legacy run generate && pnpm --filter @openmeter/api-spec-aip run generate",
+    "build": "pnpm --filter @openmeter/typespec-typescript run build",
+    "generate": "pnpm run build && pnpm --filter @openmeter/api-spec-legacy run generate && pnpm --filter @openmeter/api-spec-aip run generate",
     "format": "prettier --list-different --find-config-path --write . && pnpm --filter @openmeter/api-spec-aip run format",
     "lint": "prettier --check . && pnpm --filter @openmeter/api-spec-legacy run lint && pnpm --filter @openmeter/api-spec-aip run lint",
-    "lint:fix": "prettier --write ."
+    "lint:fix": "prettier --write .",
+    "test:sdk": "vitest --run --root packages/aip-client-javascript",
+    "test:client:e2e": "playwright test --config packages/client/playwright.config.ts"
   },
   "devDependencies": {
-    "@typespec/prettier-plugin-typespec": "1.11.0",
-    "prettier": "3.8.3"
+    "@fetch-mock/vitest": "0.2.18",
+    "@playwright/test": "1.60.0",
+    "@typespec/prettier-plugin-typespec": "1.12.0",
+    "prettier": "3.8.3",
+    "vitest": "4.1.4"
   },
   "exports": {
     "./openapi.yaml": "./packages/legacy/output/openapi.OpenMeterCloud.yaml",
@@ -19,7 +25,7 @@
     "./v3/openapi.yaml": "./packages/aip/output/definitions/metering-and-billing/v3/openapi.MeteringAndBilling.yaml"
   },
   "private": true,
-  "packageManager": "pnpm@10.33.2+sha512.a90faf6feeab71ad6c6e57f94e0fe1a12f5dcc22cd754db40ae9593eb6a3e0b6b12e3540218bb37ae083404b1f2ce6db2a4121e979829b4aff94b99f49da1cf8",
+  "packageManager": "pnpm@10.34.1+sha512.b58fbde6dca66a929538021581f648b4570b6ca19b18e7cbd7f2c07a7b24454155388dacdf08f2af3678e88a6d1fe04f9d609df24bf51735a060ea041b374ab7",
   "pnpm": {
     "onlyBuiltDependencies": [
       "@typespec/http-client-python"
@@ -29,10 +35,22 @@
       "@typespec/compiler": "patches/@typespec__compiler.patch",
       "@typespec/openapi": "patches/@typespec__openapi.patch",
       "@typespec/openapi3": "patches/@typespec__openapi3.patch",
-      "@typespec/http-client-python": "patches/@typespec__http-client-python.patch"
+      "@typespec/http-client": "patches/@typespec__http-client.patch",
+      "@typespec/http-client-python": "patches/@typespec__http-client-python.patch",
+      "@typespec/emitter-framework@0.17.0": "patches/@typespec__emitter-framework@0.17.0.patch"
     },
     "overrides": {
-      "postcss@<8.5.10": ">=8.5.10"
+      "postcss@<8.5.10": ">=8.5.10",
+      "playwright@<1.55.1": ">=1.55.1",
+      "fast-xml-builder@<=1.1.6": ">=1.1.7",
+      "fast-xml-builder@=1.1.5": ">=1.1.6",
+      "fast-uri@<=3.1.0": ">=3.1.1",
+      "fast-uri@<=3.1.1": ">=3.1.2",
+      "@protobufjs/utf8@<=1.1.0": ">=1.1.1",
+      "protobufjs@<=7.5.5": ">=7.5.6",
+      "semver@<7.7.4": ">=7.7.4",
+      "@alloy-js/core": "0.23.1",
+      "@alloy-js/typescript": "0.23.0"
     }
   }
 }

api/spec/package.json

@@ -0,0 +1,9 @@
+# Build output
+dist/
+tsconfig.tsbuildinfo
+
+# Dependencies
+node_modules/
+
+# Generated conformance guards (compile-time only, re-emitted by the generator)
+*.assert.ts

api/spec/packages/aip-client-javascript/.gitignore

@@ -0,0 +1,17 @@
+# package.json "files": ["dist"] is the active publish allowlist and takes
+# precedence, so these patterns only take effect if that allowlist is removed.
+# They keep dev files and compile-time-only artifacts out of the published
+# package in that case.
+
+# Generated conformance guards — compile-time only, no runtime value.
+*.assert.*
+
+# Sources and dev tooling
+src/
+tests/
+tsconfig.json
+tsconfig.tsbuildinfo
+.gitignore
+
+# Source maps
+*.map