feat(polar): add Polar distilled SDK

.github/workflows/nuke.yml

@@ -46,6 +46,10 @@ on:
         description: "PlanetScale"
         type: boolean
         default: false
+      polar:
+        description: "Polar"
+        type: boolean
+        default: false
       prisma-postgres:
         description: "Prisma Postgres"
         type: boolean
@@ -94,6 +98,7 @@ jobs:
              && "${{ inputs.mongodb-atlas }}" != "true" \
              && "${{ inputs.neon }}" != "true" \
              && "${{ inputs.planetscale }}" != "true" \
+             && "${{ inputs.polar }}" != "true" \
              && "${{ inputs.prisma-postgres }}" != "true" \
              && "${{ inputs.stripe }}" != "true" \
              && "${{ inputs.supabase }}" != "true" \
@@ -230,6 +235,26 @@ jobs:
         env:
           PRISMA_POSTGRES_API_TOKEN: ${{ secrets.PRISMA_POSTGRES_API_TOKEN }}
 
+  # ── Polar ──
+  nuke-polar:
+    needs: gate
+    if: needs.gate.outputs.run == 'true' && (github.event_name == 'merge_group' || inputs.all || inputs.polar)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+      - run: bun install --frozen-lockfile
+      - run: bun run build
+        working-directory: packages/core
+      - name: Run nuke script
+        run: bun scripts/nuke.ts
+        working-directory: packages/polar
+        env:
+          POLAR_ACCESS_TOKEN: ${{ secrets.POLAR_ACCESS_TOKEN }}
+          POLAR_SERVER: sandbox
+
   # ── Stripe ──
   nuke-stripe:
     needs: gate

.github/workflows/pr-package.yml

@@ -36,7 +36,7 @@ jobs:
         if: contains(github.event.pull_request.labels.*.name, 'force-ci')
         run: |
           set -euo pipefail
-          all='["core","aws","cloudflare","gcp","neon","planetscale","prisma-postgres","stripe","supabase","posthog","axiom","azure","kubernetes","coinbase","mongodb-atlas","fly-io","turso","typesense","workos","expo-eas"]'
+          all='["core","aws","cloudflare","gcp","neon","planetscale","prisma-postgres","stripe","supabase","posthog","axiom","azure","kubernetes","coinbase","mongodb-atlas","fly-io","turso","typesense","workos","expo-eas","polar"]'
           echo "packages=${all}" >> "$GITHUB_OUTPUT"
       - uses: actions/checkout@v6
       - uses: dorny/paths-filter@v4
@@ -102,6 +102,9 @@ jobs:
             expo-eas:
               - 'packages/expo-eas/**'
               - 'packages/core/**'
+            polar:
+              - 'packages/polar/**'
+              - 'packages/core/**'
 
   # ── Compute tags once so every matrix job + the comment use the same set. ─
   tags:

.github/workflows/release.yml

@@ -46,6 +46,7 @@ env:
     packages/typesense/package.json
     packages/workos/package.json
     packages/expo-eas/package.json
+    packages/polar/package.json
     bun.lock
     CHANGELOG.md
 
@@ -273,6 +274,7 @@ jobs:
           - typesense
           - workos
           - expo-eas
+          - polar
         include:
           - package: aws
             runner: ubuntu-22-large

.github/workflows/test.yml

@@ -42,6 +42,7 @@ jobs:
       typesense: ${{ steps.force.outputs.all || steps.changes.outputs.typesense }}
       workos: ${{ steps.force.outputs.all || steps.changes.outputs.workos }}
       expo-eas: ${{ steps.force.outputs.all || steps.changes.outputs.expo-eas }}
+      polar: ${{ steps.force.outputs.all || steps.changes.outputs.polar }}
     steps:
       - id: force
         if: contains(github.event.pull_request.labels.*.name, 'force-ci')
@@ -110,6 +111,9 @@ jobs:
             expo-eas:
               - 'packages/expo-eas/**'
               - 'packages/core/**'
+            polar:
+              - 'packages/polar/**'
+              - 'packages/core/**'
 
   ci-core:
     needs: detect-changes
@@ -494,3 +498,24 @@ jobs:
         working-directory: packages/expo-eas
         env:
           EXPO_TOKEN: ${{ secrets.EXPO_TOKEN }}
+
+  ci-polar:
+    needs: detect-changes
+    if: needs.detect-changes.outputs.polar == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+      - run: bun install
+      - run: bun run build
+        working-directory: packages/core
+      - run: bun run check
+        working-directory: packages/polar
+      - run: bun run test
+        working-directory: packages/polar
+        env:
+          POLAR_ACCESS_TOKEN: ${{ secrets.POLAR_ACCESS_TOKEN }}
+          POLAR_ORGANIZATION_ID: ${{ secrets.POLAR_ORGANIZATION_ID }}
+          POLAR_SERVER: sandbox

AGENTS.md

@@ -16,6 +16,7 @@ distilled/
 │   ├── mongodb-atlas/    # @distilled.cloud/mongodb-atlas — MongoDB Atlas SDK from OpenAPI spec
 │   ├── neon/             # @distilled.cloud/neon — Neon SDK from OpenAPI spec
 │   ├── planetscale/      # @distilled.cloud/planetscale — PlanetScale SDK from OpenAPI spec
+│   ├── polar/            # @distilled.cloud/polar — Polar SDK from OpenAPI spec
 │   ├── prisma-postgres/  # @distilled.cloud/prisma-postgres — Prisma Postgres SDK from OpenAPI spec
 │   ├── stripe/           # @distilled.cloud/stripe — Stripe SDK from OpenAPI spec
 │   ├── supabase/         # @distilled.cloud/supabase — Supabase SDK from OpenAPI spec
@@ -127,6 +128,7 @@ Each SDK package has vendor API specifications stored as git submodules under `s
 | `mongodb-atlas` | `specs/distilled-spec-mongodb-atlas` | MongoDB Atlas OpenAPI spec |
 | `neon` | `specs/distilled-spec-neon` | Neon OpenAPI spec |
 | `planetscale` | `specs/distilled-spec-planetscale` | PlanetScale OpenAPI spec |
+| `polar` | `specs/distilled-spec-polar` | Polar OpenAPI spec |
 | `prisma-postgres` | `specs/distilled-spec-prisma-postgres` | Prisma Postgres OpenAPI spec |
 | `stripe` | `specs/stripe-openapi` | Stripe OpenAPI spec |
 | `supabase` | `specs/distilled-spec-supabase` | Supabase OpenAPI spec |

README.md

@@ -34,6 +34,7 @@ const functions = yield* Lambda.listFunctions
 | [`@distilled.cloud/mongodb-atlas`](./packages/mongodb-atlas) | MongoDB Atlas SDK from OpenAPI spec |
 | [`@distilled.cloud/neon`](./packages/neon) | Neon serverless Postgres SDK from OpenAPI spec |
 | [`@distilled.cloud/planetscale`](./packages/planetscale) | PlanetScale MySQL SDK from OpenAPI spec |
+| [`@distilled.cloud/polar`](./packages/polar) | Polar billing SDK from OpenAPI spec |
 | [`@distilled.cloud/prisma-postgres`](./packages/prisma-postgres) | Prisma Postgres SDK from OpenAPI spec |
 | [`@distilled.cloud/stripe`](./packages/stripe) | Stripe SDK from OpenAPI spec |
 | [`@distilled.cloud/supabase`](./packages/supabase) | Supabase Management API SDK from OpenAPI spec |
@@ -125,6 +126,7 @@ bun run specs:update   # run inside a package directory
 | `mongodb-atlas` | `distilled-spec-mongodb-atlas` |
 | `neon` | `distilled-spec-neon` |
 | `planetscale` | `distilled-spec-planetscale` |
+| `polar` | `distilled-spec-polar` |
 | `prisma-postgres` | `distilled-spec-prisma-postgres` |
 | `stripe` | `stripe-openapi` |
 | `supabase` | `distilled-spec-supabase` |