API/TS: Add regression tests and on-the-fly examples for #137

.github/workflows/ci.yml

@@ -16,19 +16,17 @@ jobs:
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
 
-      - name: Run linting
-        run: bun run lint
+      - name: Lint
+        run: make lint
 
-      - name: Run tests
-        run: bun run test:ci
+      - name: Test
+        run: make test
 
-      - name: Build project
+      - name: Build
         run: bun run build
 
   security:
@@ -39,8 +37,6 @@ jobs:
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
@@ -56,8 +52,6 @@ jobs:
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
 
       - name: Build and pack
         run: |
@@ -89,8 +83,6 @@ jobs:
       - name: Setup Bun
         if: matrix.package-manager == 'bun'
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
 
       - name: Setup Node.js
         if: matrix.package-manager != 'bun'

.github/workflows/release.yml

@@ -25,17 +25,12 @@ jobs:
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
 
       - name: Install dependencies
-        run: bun install
-
-      - name: Run tests
-        run: bun test
+        run: bun install --frozen-lockfile
 
-      - name: Run typecheck
-        run: bun run typecheck
+      - name: Test
+        run: make test
 
       - name: Build
         run: bun run build
@@ -81,17 +76,12 @@ jobs:
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
 
       - name: Install dependencies
-        run: bun install
-
-      - name: Run tests
-        run: bun test
+        run: bun install --frozen-lockfile
 
-      - name: Run typecheck
-        run: bun run typecheck
+      - name: Test
+        run: make test
 
       - name: Build
         run: bun run build

.github/workflows/sdk-tests.yml

@@ -10,23 +10,16 @@ jobs:
   test-csharp-sdk:
     runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        bun-version: [latest]
-        dotnet-version: [8.0.x]
-
     steps:
       - uses: actions/checkout@v5
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: ${{ matrix.bun-version }}
 
-      - name: Setup .NET ${{ matrix.dotnet-version }}
+      - name: Setup .NET
         uses: actions/setup-dotnet@v5
         with:
-          dotnet-version: ${{ matrix.dotnet-version }}
+          dotnet-version: 8.0.x
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
@@ -52,20 +45,11 @@ jobs:
   test-typescript-sdk-r4:
     runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        bun-version: [latest]
-
     steps:
       - uses: actions/checkout@v5
 
-      - name: Checkout code
-        uses: actions/checkout@v5
-
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: ${{ matrix.bun-version }}
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
@@ -89,17 +73,11 @@ jobs:
   test-typescript-us-core-example:
     runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        bun-version: [latest]
-
     steps:
       - uses: actions/checkout@v5
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: ${{ matrix.bun-version }}
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
@@ -124,46 +102,30 @@ jobs:
   test-typescript-ccda-example:
     runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        bun-version: [latest]
-
     steps:
       - uses: actions/checkout@v5
 
-      - name: Checkout code
-        uses: actions/checkout@v5
-
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: ${{ matrix.bun-version }}
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
 
       - name: Run tests
         run: make test-typescript-ccda-example
 
-  test-python-sdk-test:
+  test-python-sdk:
     runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        bun-version: [ latest ]
-        python-version: [ "3.13" ]
-
     steps:
       - uses: actions/checkout@v5
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: ${{ matrix.bun-version }}
 
       - uses: actions/setup-python@v6
         with:
-          python-version: ${{ matrix.python-version }}
+          python-version: "3.13"
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
@@ -186,25 +148,18 @@ jobs:
             exit 1
           fi
 
-  test-python-fhirpy-sdk-test:
+  test-python-fhirpy-sdk:
     runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        bun-version: [ latest ]
-        python-version: [ "3.13" ]
-
     steps:
       - uses: actions/checkout@v5
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: ${{ matrix.bun-version }}
 
       - uses: actions/setup-python@v6
         with:
-          python-version: ${{ matrix.python-version }}
+          python-version: "3.13"
 
       - name: Install dependencies
         run: bun install --frozen-lockfile
@@ -227,21 +182,48 @@ jobs:
             exit 1
           fi
 
+  test-local-package-folder-example:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Run tests
+        run: make test-local-package-folder-example
+
+  test-on-the-fly-example:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Run tests
+        run: make test-on-the-fly-example
+
   test-mustache-java-r4-example:
     runs-on: ubuntu-latest
 
     strategy:
       matrix:
-        bun-version: [latest]
         java-version: [21, 25]
 
     steps:
       - uses: actions/checkout@v5
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: ${{ matrix.bun-version }}
 
       - name: Setup Java
         uses: actions/setup-java@v5

.gitignore

@@ -42,4 +42,3 @@ test-output
 /generated
 .typeschema-cache
 *.cpuprofile
-examples/tmp/

.zed/tasks.json

@@ -1,15 +1,7 @@
 [
   {
-    "label": "test-typeschema",
-    "command": "make test-typeschema"
-  },
-  {
-    "label": "test-register",
-    "command": "make test-register"
-  },
-  {
-    "label": "test-codegen",
-    "command": "make test-codegen"
+    "label": "test",
+    "command": "make test"
   },
   {
     "label": "test-ts-r4-example",

CLAUDE.md

@@ -15,11 +15,11 @@ bun run lint                  # Lint and format code with Biome
 
 # Building
 bun run build                 # Build the project (creates dist/)
-bun run cli                   # Run CLI in development mode
+bun run src/cli/index.ts                   # Run CLI in development mode
 
 # CLI Usage
-bun run cli typeschema generate hl7.fhir.r4.core@4.0.1 -o schemas.ndjson
-bun run cli generate typescript -i schemas.ndjson -o ./types
+bun run src/cli/index.ts typeschema generate hl7.fhir.r4.core@4.0.1 -o schemas.ndjson
+bun run src/cli/index.ts generate typescript -i schemas.ndjson -o ./types
 ```
 
 ## Verification
@@ -361,7 +361,7 @@ Detection uses `mkIsFamilyType(tsIndex)` which checks `schema.typeFamily.resourc
 2. Enable caching in APIBuilder
 3. Process large packages in batches
 4. Use `build()` instead of `generate()` for testing
-5. Run `bun run quality` before committing (combines typecheck, lint, test:unit)
+5. Run `make test` before committing (typecheck + tests)
 
 ## Useful External Resources