@workos/oagen-emitters 0.12.0 → 0.12.1

package/dist/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;cA0Ba,oBAAA,EAAsB,IAAA,CAAK,WAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;cA0Ba,oBAAA,EAAsB,IAAI,CAAC,WAAA"}

package/dist/plugin.mjs

@@ -1,2 +1,2 @@
-import { t as workosEmittersPlugin } from "./plugin-C408Wh-o.mjs";
+import { t as workosEmittersPlugin } from "./plugin-CmfzawTp.mjs";
 export { workosEmittersPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workos/oagen-emitters",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "WorkOS' oagen emitters",
   "license": "MIT",
   "author": "WorkOS",
@@ -38,22 +38,22 @@
     "prepare": "husky"
   },
   "devDependencies": {
-    "@commitlint/cli": "^20.5.3",
-    "@commitlint/config-conventional": "^20.5.3",
-    "@types/node": "^25.6.0",
+    "@commitlint/cli": "^21.0.1",
+    "@commitlint/config-conventional": "^21.0.1",
+    "@types/node": "^25.7.0",
     "husky": "^9.1.7",
-    "oxfmt": "^0.48.0",
-    "oxlint": "^1.63.0",
+    "oxfmt": "^0.49.0",
+    "oxlint": "^1.64.0",
     "prettier": "^3.8.3",
-    "tsdown": "^0.21.10",
+    "tsdown": "^0.22.0",
     "tsx": "^4.21.0",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.6"
   },
   "engines": {
     "node": ">=24.10.0"
   },
   "dependencies": {
-    "@workos/oagen": "^0.18.1"
+    "@workos/oagen": "^0.18.2"
   }
 }

package/src/rust/fixtures.ts

@@ -41,7 +41,12 @@ export function generateModelFixture(
 
   for (const field of model.fields) {
     if (!field.required) continue;
-    result[field.name] = exampleFor(field.type, modelMap, enumMap, visiting, field.name);
+    // Prefer the spec `example` value when it is shape-compatible with the
+    // declared type. Falls back to the placeholder generator when no example
+    // is provided or when the example would not deserialize cleanly.
+    const fromExample = exampleFromSpec(field.example, field.type, enumMap);
+    result[field.name] =
+      fromExample !== undefined ? fromExample : exampleFor(field.type, modelMap, enumMap, visiting, field.name);
   }
 
   visiting.delete(model.name);
@@ -108,3 +113,84 @@ export function exampleFor(
     }
   }
 }
+
+/**
+ * Resolve a spec-provided `example` against a TypeRef and return the value to
+ * embed in the fixture, or `undefined` when the example cannot be used safely.
+ *
+ * "Safely" means the value would round-trip through serde to the generated
+ * Rust type. We deliberately only accept primitives, enum string/number
+ * values, and homogenous arrays of those; nested object examples (which the
+ * spec sometimes supplies as illustrative metadata blobs) are skipped because
+ * they rarely match the strict struct shape Rust expects.
+ */
+export function exampleFromSpec(example: unknown, type: TypeRef, enumMap: Map<string, Enum>): unknown {
+  if (example === undefined) return undefined;
+  // Spec authors sometimes use `null` as a sentinel; let placeholder gen
+  // handle nullable types so we don't emit `null` for required fields.
+  if (example === null) return undefined;
+  return matchExampleToType(example, type, enumMap);
+}
+
+function matchExampleToType(value: unknown, type: TypeRef, enumMap: Map<string, Enum>): unknown {
+  switch (type.kind) {
+    case 'primitive':
+      return matchPrimitive(value, type.type);
+    case 'literal':
+      return value === type.value ? value : undefined;
+    case 'enum': {
+      const e = enumMap.get(type.name);
+      if (!e) return undefined;
+      const ok = e.values.some((v) => v.value === value);
+      return ok ? value : undefined;
+    }
+    case 'array': {
+      if (!Array.isArray(value)) return undefined;
+      const out: unknown[] = [];
+      for (const item of value) {
+        const matched = matchExampleToType(item, type.items, enumMap);
+        if (matched === undefined) return undefined;
+        out.push(matched);
+      }
+      // Empty arrays are valid but unhelpful in fixtures — fall back so the
+      // placeholder generator can produce a one-element example.
+      if (out.length === 0) return undefined;
+      return out;
+    }
+    case 'nullable':
+      return matchExampleToType(value, type.inner, enumMap);
+    case 'map':
+      // Map examples are usually free-form metadata blobs that match
+      // `HashMap<String, _>`; only accept plain objects with string-keyed values.
+      if (typeof value !== 'object' || value === null || Array.isArray(value)) return undefined;
+      return value;
+    case 'union': {
+      for (const variant of type.variants) {
+        const matched = matchExampleToType(value, variant, enumMap);
+        if (matched !== undefined) return matched;
+      }
+      return undefined;
+    }
+    case 'model':
+      // Model-shaped examples are too risky to copy verbatim: they rarely
+      // supply every required field and may use wire names that don't align
+      // with the generated struct. Let the recursive generator handle them.
+      return undefined;
+  }
+}
+
+function matchPrimitive(value: unknown, primitive: 'string' | 'integer' | 'number' | 'boolean' | 'unknown'): unknown {
+  switch (primitive) {
+    case 'string':
+      return typeof value === 'string' ? value : undefined;
+    case 'integer':
+      return typeof value === 'number' && Number.isInteger(value) ? value : undefined;
+    case 'number':
+      return typeof value === 'number' ? value : undefined;
+    case 'boolean':
+      return typeof value === 'boolean' ? value : undefined;
+    case 'unknown':
+      // `unknown` deserialises to `serde_json::Value`, so any JSON value works.
+      return value;
+  }
+}

package/src/rust/models.ts

@@ -105,8 +105,13 @@ function resolveFieldNames(fields: Field[]): string[] {
 
 function renderField(field: Field, rustField: string, modelName: string, registry: UnionRegistry): string {
   const lines: string[] = [];
-  if (field.description) {
-    for (const c of docComment(field.description)) lines.push(`    ${c}`);
+  const hasDescription = !!field.description;
+  if (hasDescription) {
+    for (const c of docComment(field.description!)) lines.push(`    ${c}`);
+  }
+  if (field.default != null) {
+    if (hasDescription) lines.push('    ///');
+    lines.push(`    /// Defaults to \`${formatDefault(field.default)}\`.`);
   }
 
   const rename = rustField !== field.name ? field.name : null;
@@ -148,3 +153,13 @@ function docComment(text: string): string[] {
     .filter((l) => l.length > 0)
     .map((l) => `/// ${l}`);
 }
+
+/**
+ * Render a spec-level default value for inclusion in a doc comment. Strings
+ * render bare (e.g. `desc`) so they nest naturally inside the surrounding
+ * backticks; numbers/booleans use JSON encoding.
+ */
+function formatDefault(value: unknown): string {
+  if (typeof value === 'string') return value;
+  return JSON.stringify(value);
+}