@workos/oagen-emitters 0.0.1

package/.github/workflows/ci.yml

@@ -0,0 +1,20 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version-file: .node-version
+
+      - run: npm install
+      - run: npm run typecheck
+      - run: npm test

package/.github/workflows/lint-pr-title.yml

@@ -0,0 +1,16 @@
+name: Lint PR Title
+
+on:
+  pull_request_target:
+    types: [opened, edited, synchronize]
+
+permissions:
+  pull-requests: read
+
+jobs:
+  lint_pr_title:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: amannn/action-semantic-pull-request@e32d7e603df1aa1ba07e981f2a23455dee596825 # v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/lint.yml

@@ -0,0 +1,21 @@
+name: Lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version-file: .node-version
+
+      - run: npm install
+      - run: npm run lint
+      - run: npm run format
+      - run: npx prettier --check '**/*.md'

package/.github/workflows/release-please.yml

@@ -0,0 +1,28 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - uses: googleapis/release-please-action@16a9c90856f42705d54a6fda1823352bdc62cf38 # v4.4.0
+        id: release
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+  publish:
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release_created == 'true' }}
+    uses: ./.github/workflows/release.yml

package/.github/workflows/release.yml

@@ -0,0 +1,32 @@
+name: Release
+
+on:
+  workflow_dispatch:
+  workflow_call:
+
+jobs:
+  publish:
+    name: Publish to npm
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+        with:
+          node-version-file: .node-version
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install Dependencies
+        run: npm install
+
+      - name: Build Project
+        run: npm run build
+
+      - name: Run Tests
+        run: npm run test
+
+      - name: Publish
+        run: npm publish --tag latest --access public --provenance

package/.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit "$1"

package/.husky/pre-commit

@@ -0,0 +1 @@
+npm run lint

package/.husky/pre-push

@@ -0,0 +1 @@
+npm test

package/.node-version

@@ -0,0 +1 @@
+24.13.0

package/.oxfmtrc.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "trailingComma": "all",
+  "tabWidth": 2,
+  "semi": true,
+  "singleQuote": true,
+  "printWidth": 120,
+  "sortPackageJson": false,
+  "ignorePatterns": ["dist/", "node_modules/", "pnpm-lock.yaml", "**/*.json", "**/*.md", "**/*.yaml"]
+}

package/.oxlintrc.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": null,
+  "categories": {},
+  "rules": {
+    "no-unused-expressions": "off",
+    "no-control-regex": "off"
+  },
+  "settings": {
+    "jsdoc": {
+      "ignorePrivate": false,
+      "ignoreInternal": false,
+      "ignoreReplacesDocs": true,
+      "overrideReplacesDocs": true,
+      "augmentsExtendsReplacesDocs": false,
+      "implementsReplacesDocs": false,
+      "exemptDestructuredRootsFromChecks": false,
+      "tagNamePreference": {}
+    },
+    "vitest": {
+      "typecheck": false
+    }
+  },
+  "env": {
+    "builtin": true
+  },
+  "globals": {},
+  "ignorePatterns": ["test/fixtures/**"]
+}

package/.vscode/settings.json

@@ -0,0 +1,11 @@
+{
+  "[json]": {
+    "editor.defaultFormatter": "vscode.json-language-features"
+  },
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "vscode.typescript-language-features"
+  }
+}

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WorkOS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# oagen-plugins
+
+Language plugins for [oagen](../oagen); generates SDK code from OpenAPI specs.
+
+## Supported languages
+
+| Language        | Emitter       | Extractor       | Smoke Test          |
+| --------------- | ------------- | --------------- | ------------------- |
+| Node/TypeScript | `nodeEmitter` | `nodeExtractor` | `smoke/sdk-node.ts` |
+
+## Quickstart
+
+```bash
+npm install
+npm test          # run emitter unit tests
+npm run typecheck # verify types
+```
+
+## Workflows
+
+### Setting up a new language
+
+```bash
+# 1. Extract the live SDK's public API surface
+npm run sdk:extract:node
+
+# 2. Generate and integrate
+npm run sdk:generate:node
+
+# 3. Verify
+npm run sdk:verify:node
+```
+
+### Ongoing spec updates
+
+```bash
+# 1. Incremental generation from spec changes
+npm run sdk:diff:node
+
+# 2. Verify
+npm run sdk:verify:node
+```
+
+### After manually editing the live SDK
+
+If you rename methods, add exports, or change the live SDK's public API by hand:
+
+```bash
+# 1. Re-extract the baseline so the overlay stays in sync
+npm run sdk:extract:node
+
+# 2. Regenerate (the overlay will use the updated baseline)
+npm run sdk:generate:node
+```
+
+## Commands
+
+All SDK commands are in `package.json` under `scripts`. Replace `node` with the target language for other SDKs.
+
+### `npm run sdk:extract:node`
+
+```bash
+oagen extract --lang node --sdk-path ../backend/workos-node --output ./sdk-node-surface.json
+```
+
+Extracts the live SDK's public API surface (classes, interfaces, type aliases, enums, exports) into `sdk-node-surface.json`. This is **per-language** — each language has its own extractor that understands the language's public surface conventions (TypeScript exports, Ruby public methods, Python `__all__`, etc.).
+
+**When to run:** Before the first generation, and whenever the live SDK's public API changes (hand-written additions, renamed methods, new exports).
+
+### `npm run sdk:generate:node`
+
+```bash
+oagen generate --lang node --output ./sdk --namespace workos \
+  --spec ../openapi-spec/spec/open-api-spec.yaml \
+  --api-surface ./sdk-node-surface.json \
+  --target ../backend/workos-node
+```
+
+Full generation from the OpenAPI spec. Produces a standalone SDK at `./sdk/` and integrates new interface, serializer, enum, and fixture files into the live SDK at `--target`.
+
+**What gets integrated:** New type definitions (interfaces, serializers, enums, fixtures) that don't already exist in the live SDK. Existing files are never modified.
+
+**What stays standalone:** Resource classes, tests, client, barrel exports, error classes, and common utilities remain in `./sdk/` only. The developer wires up resource classes and client accessors manually.
+
+**When to run:** First-time setup, or when you want a full regeneration (e.g., after a major spec overhaul).
+
+### `npm run sdk:diff:node`
+
+```bash
+oagen diff --old ./sdk/spec-snapshot.yaml --new ../openapi-spec/spec/open-api-spec.yaml \
+  --lang node --output ./sdk \
+  --target ../backend/workos-node \
+  --api-surface ./sdk-node-surface.json
+```
+
+Incremental generation — compares the previous spec snapshot against the current spec and only regenerates files affected by the changes.
+
+**Requires** a prior `sdk:generate:node` run which creates `./sdk/spec-snapshot.yaml`.
+
+**When to run:** After the OpenAPI spec is updated (new endpoints, changed models, etc.).
+
+### `npm run sdk:verify:node`
+
+```bash
+oagen verify --lang node --output ./sdk \
+  --spec ../openapi-spec/spec/open-api-spec.yaml \
+  --api-surface ./sdk-node-surface.json
+```
+
+Runs compat verification (checks that generated types preserve the live SDK's public API surface) and smoke tests (checks wire-level HTTP behavior).
+
+**When to run:** After any generation to verify correctness, or in CI.
+
+## Adding a new language
+
+Use the oagen skills:
+
+```bash
+claude --plugin-dir ../oagen
+/oagen:generate-sdk <language>
+```
+
+This orchestrates: emitter scaffolding → extractor → compat verification → smoke tests → integration.

package/commitlint.config.ts

@@ -0,0 +1 @@
+export default { extends: ['@commitlint/config-conventional'] };

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { Emitter } from '@workos/oagen';
+
+declare const nodeEmitter: Emitter;
+
+export { nodeEmitter };