feat(oagen[2/2]): update existing SDK modules with generated types, docs, and serializers

Generated by running: npm run sdk:generate:node --target ../backend/workos-node

- JSDoc on all existing service methods (pulled from OpenAPI spec)
- Serialize functions and Response interfaces alongside existing deserialize functions
- Six new user-management sub-services (session tokens, CORS origins, JWT templates,
  redirect URIs, authorized applications, data providers) wired into workos.ts
- New dependency interfaces, serializers, and enum types required by the above
- Manual fix: removed `export * from './mfa/interfaces'` to avoid duplicate Factor export

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: gjtorikian

src/api-keys/api-keys.ts

@@ -1,3 +1,5 @@
+// This file is auto-generated by oagen. Do not edit.
+
 import { WorkOS } from '../workos';
 import {
   SerializedValidateApiKeyResponse,
@@ -9,6 +11,15 @@ import { deserializeValidateApiKeyResponse } from './serializers/validate-api-ke
 export class ApiKeys {
   constructor(private readonly workos: WorkOS) {}
 
+  /**
+   * Validate API key
+   *
+   * Validate an API key value and return the API key object if valid.
+   * @param payload - Object containing value.
+   * @returns {ApiKeyValidationResponse}
+   * @throws {UnauthorizedException} 401
+   * @throws {UnprocessableEntityException} 422
+   */
   async validateApiKey(
     payload: ValidateApiKeyOptions,
   ): Promise<ValidateApiKeyResponse> {
@@ -20,6 +31,15 @@ export class ApiKeys {
     return deserializeValidateApiKeyResponse(data);
   }
 
+  /**
+   * Delete an API key
+   *
+   * Permanently deletes an API key. This action cannot be undone. Once deleted, any requests using this API key will fail authentication.
+   * @param id - The unique ID of the API key.
+   * @example "api_key_01EHZNVPK3SFK441A1RGBFSHRT"
+   * @returns {void}
+   * @throws {NotFoundException} 404
+   */
   async deleteApiKey(id: string): Promise<void> {
     await this.workos.delete(`/api_keys/${id}`);
   }

src/api-keys/interfaces/api-key-owner.interface.ts

@@ -0,0 +1,9 @@
+// This file is auto-generated by oagen. Do not edit.
+
+import type {
+  ApiKeyWithValueOwner,
+  ApiKeyWithValueOwnerResponse,
+} from '../../organizations/interfaces/api-key-with-value-owner.interface';
+
+export type ApiKeyOwner = ApiKeyWithValueOwner;
+export type ApiKeyOwnerResponse = ApiKeyWithValueOwnerResponse;

src/api-keys/interfaces/api-key-validation-response.interface.ts

@@ -0,0 +1,11 @@
+// This file is auto-generated by oagen. Do not edit.
+
+import type { ApiKey, ApiKeyResponse } from './api-key.interface';
+
+export interface ApiKeyValidationResponse {
+  apiKey: ApiKey | null;
+}
+
+export interface ApiKeyValidationResponseWire {
+  api_key: ApiKeyResponse | null;
+}

src/api-keys/interfaces/api-key.interface.ts

@@ -1,15 +1,28 @@
+// This file is auto-generated by oagen. Do not edit.
+
+import type { ApiKeyOwnerResponse } from './api-key-owner.interface';
+/** The API Key object if the value is valid, or `null` if invalid. */
 export interface ApiKey {
+  /** Distinguishes the API Key object. */
   object: 'api_key';
+  /** Unique identifier of the API Key. */
   id: string;
+  /** The entity that owns the API Key. */
   owner: {
     type: 'organization';
     id: string;
   };
+  /** A descriptive name for the API Key. */
   name: string;
+  /** An obfuscated representation of the API Key value. */
   obfuscatedValue: string;
+  /** Timestamp of when the API Key was last used. */
   lastUsedAt: string | null;
+  /** The permission slugs assigned to the API Key. */
   permissions: string[];
+  /** An ISO 8601 timestamp. */
   createdAt: string;
+  /** An ISO 8601 timestamp. */
   updatedAt: string;
 }
 
@@ -27,3 +40,15 @@ export interface SerializedApiKey {
   created_at: string;
   updated_at: string;
 }
+
+export interface ApiKeyResponse {
+  object: 'api_key';
+  id: string;
+  owner: ApiKeyOwnerResponse;
+  name: string;
+  obfuscated_value: string;
+  last_used_at: string | null;
+  permissions: string[];
+  created_at: string;
+  updated_at: string;
+}

src/api-keys/interfaces/index.ts

@@ -1,5 +1,11 @@
+// This file is auto-generated by oagen. Do not edit.
+
 export * from './api-key.interface';
 export * from './create-organization-api-key-options.interface';
 export * from './created-api-key.interface';
 export * from './list-organization-api-keys-options.interface';
 export * from './validate-api-key.interface';
+
+export * from './api-key-owner.interface';
+
+export * from './api-key-validation-response.interface';

src/api-keys/interfaces/validate-api-key.interface.ts

@@ -1,3 +1,5 @@
+// This file is auto-generated by oagen. Do not edit.
+
 import { ApiKey, SerializedApiKey } from './api-key.interface';
 
 export interface ValidateApiKeyOptions {
@@ -6,8 +8,14 @@ export interface ValidateApiKeyOptions {
 
 export interface ValidateApiKeyResponse {
   apiKey: ApiKey | null;
+  value?: string;
 }
 
 export interface SerializedValidateApiKeyResponse {
   api_key: SerializedApiKey | null;
 }
+
+export interface ValidateApiKey {
+  /** The value for an API key. */
+  value?: string;
+}

src/api-keys/serializers/api-key-owner.serializer.ts

@@ -0,0 +1,6 @@
+// This file is auto-generated by oagen. Do not edit.
+
+export {
+  deserializeApiKeyWithValueOwner as deserializeApiKeyOwner,
+  serializeApiKeyWithValueOwner as serializeApiKeyOwner,
+} from '../../organizations/serializers/api-key-with-value-owner.serializer';

src/api-keys/serializers/api-key-validation-response.serializer.ts

@@ -0,0 +1,19 @@
+// This file is auto-generated by oagen. Do not edit.
+
+import type {
+  ApiKeyValidationResponse,
+  ApiKeyValidationResponseWire,
+} from '../interfaces/api-key-validation-response.interface';
+import { deserializeApiKey, serializeApiKey } from './api-key.serializer';
+
+export const deserializeApiKeyValidationResponse = (
+  response: ApiKeyValidationResponseWire,
+): ApiKeyValidationResponse => ({
+  apiKey: response.api_key != null ? deserializeApiKey(response.api_key) : null,
+});
+
+export const serializeApiKeyValidationResponse = (
+  model: ApiKeyValidationResponse,
+): ApiKeyValidationResponseWire => ({
+  api_key: model.apiKey != null ? serializeApiKey(model.apiKey) : null,
+});

src/api-keys/serializers/api-key.serializer.ts

@@ -1,4 +1,8 @@
+// This file is auto-generated by oagen. Do not edit.
+
 import { ApiKey, SerializedApiKey } from '../interfaces/api-key.interface';
+import type { ApiKeyResponse } from '../interfaces/api-key.interface';
+import { serializeApiKeyOwner } from './api-key-owner.serializer';
 
 export function deserializeApiKey(apiKey: SerializedApiKey): ApiKey {
   return {
@@ -13,3 +17,15 @@ export function deserializeApiKey(apiKey: SerializedApiKey): ApiKey {
     updatedAt: apiKey.updated_at,
   };
 }
+
+export const serializeApiKey = (model: ApiKey): ApiKeyResponse => ({
+  object: model.object,
+  id: model.id,
+  owner: serializeApiKeyOwner(model.owner),
+  name: model.name,
+  obfuscated_value: model.obfuscatedValue,
+  last_used_at: model.lastUsedAt,
+  permissions: model.permissions,
+  created_at: model.createdAt,
+  updated_at: model.updatedAt,
+});

src/api-keys/serializers/validate-api-key.serializer.ts

@@ -1,8 +1,11 @@
+// This file is auto-generated by oagen. Do not edit.
+
 import {
   SerializedValidateApiKeyResponse,
   ValidateApiKeyResponse,
 } from '../interfaces/validate-api-key.interface';
 import { deserializeApiKey } from './api-key.serializer';
+import type { ValidateApiKey } from '../interfaces/validate-api-key.interface';
 
 export function deserializeValidateApiKeyResponse(
   response: SerializedValidateApiKeyResponse,
@@ -11,3 +14,9 @@ export function deserializeValidateApiKeyResponse(
     apiKey: response.api_key ? deserializeApiKey(response.api_key) : null,
   };
 }
+
+export const deserializeValidateApiKey = (
+  response: ValidateApiKeyResponse,
+): ValidateApiKey => ({
+  value: response.value,
+});