feat: add Stainless SDK config and misc cleanups

[pengying]

Grid API SDK Configuration

• Add .stainless/stainless.yml and workspace.json for SDK generation
• Add AllErrors schema to properly handle error types
• Replace Error schema references with GridError
• Fix phone number format in UltimateBeneficialOwner to include '+' prefix
• Update .redocly.lint-ignore.yaml with additional rule exceptions
• Fix internal_accounts schema reference path

[pengying]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• feat: add Stainless SDK config and misc cleanups #132 👈 (View in Graphite)
• feat: rename Error to GridError and add additionalProperties to error schemas #131
• feat: add Customer API discriminators and consolidate customer changes #130
• feat: add Quote/Transaction discriminators and remove inline examples #129
• feat: add isPlatformAccount to PaymentInstructions and remove PaymentAccountOrWalletInfo refs #128
• feat: rename accounts to data in list external accounts response #127
• feat: convert single-value enums to const for base types #126
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[greptile-apps]

Greptile Overview

Greptile Summary

This PR adds Stainless SDK generation configuration to enable automatic TypeScript and Kotlin SDK generation from the OpenAPI specification.

Key changes:

• Added .stainless/stainless.yml with comprehensive SDK configuration including resource definitions, authentication setup, pagination, and error handling
• Added .stainless/workspace.json pointing to mintlify/openapi.yaml as the source spec
• Created AllErrors union schema combining all HTTP error variants (Error400-Error501) to enable Stainless's error transformation feature
• Renamed Error schema to GridError and updated references to avoid naming conflicts
• Fixed phoneNumber example in UltimateBeneficialOwner to include '+' prefix, properly matching the E.164 format pattern
• Corrected InternalAccount schema reference from users/ to customers/ directory
• Updated .redocly.lint-ignore.yaml to suppress warnings for AllErrors (intentionally unused in the spec itself, only used by Stainless) and QuoteSource/Quote required properties

Architecture notes:
The Stainless configuration uses the splitSchemasByEnumProperty transformation to convert the AllErrors union into distinct error types based on the code enum property. This enables strongly-typed error handling in generated SDKs where each error code becomes a separate catchable type.

Confidence Score: 5/5

• This PR is safe to merge with no blocking issues
• All changes are configuration and schema cleanup with no breaking API changes. The Error→GridError rename maintains backward compatibility through proper schema references, schema paths are corrected, and the phone number format fix aligns the example with existing validation patterns
• No files require special attention

Important Files Changed

Filename	Overview
.stainless/stainless.yml	Added Stainless SDK configuration for TypeScript and Kotlin SDK generation with comprehensive resource definitions, authentication settings, and error handling
.stainless/workspace.json	Added workspace configuration pointing to mintlify/openapi.yaml for SDK generation with TypeScript target output path
openapi/components/schemas/customers/UltimateBeneficialOwner.yaml	Fixed phoneNumber example to include '+' prefix matching E.164 format requirements
openapi/openapi.yaml	Added AllErrors union schema containing all HTTP error code variants (400-501) for SDK error handling
openapi/paths/internal-accounts/internal_accounts.yaml	Fixed InternalAccount schema reference path from users/ to customers/ directory

Sequence Diagram

sequenceDiagram
    participant Dev as Developer
    participant Stainless as Stainless SDK Generator
    participant OpenAPI as OpenAPI Spec
    participant SDK as Generated SDK
    
    Dev->>OpenAPI: Add AllErrors union schema
    Dev->>OpenAPI: Rename Error → GridError
    Dev->>OpenAPI: Fix schema references
    Dev->>OpenAPI: Fix phone number format
    
    Dev->>Stainless: Configure stainless.yml
    Note over Stainless: Define resources, auth,<br/>error handling config
    
    Dev->>Stainless: Configure workspace.json
    Note over Stainless: Point to mintlify/openapi.yaml<br/>Set output paths
    
    Stainless->>OpenAPI: Read mintlify/openapi.yaml
    Stainless->>Stainless: Transform AllErrors by enum property
    Note over Stainless: splitSchemasByEnumProperty<br/>creates typed error classes
    
    Stainless->>SDK: Generate TypeScript SDK
    Stainless->>SDK: Generate Kotlin SDK
    
    SDK->>SDK: Include typed error handling
    Note over SDK: Each error code becomes<br/>a distinct type

Loading