✨ Feature Request: Enhance Session Configuration Defaults

[joepegler]

Feature or Improvement Description

Improve the session configuration defaulting mechanism by: 1. Making the full usage object optional with smart defaults 2. Making usage.used optional with appropriate default value 3. Creating a more comprehensive defaulting system for session parameters 4. Implementing type-safe default application

Benefits & Outcomes

• Better Developer Experience: Reduce boilerplate when creating sessions
• Safer Defaults: Provide sensible default values for optional parameters
• Type Safety: Ensure type safety when applying defaults
• Flexibility: Allow partial configuration while maintaining functionality
• Consistency: Standardize how defaults are applied across the SDK

Implementation Ideas

1. Update Types

   • Make usage object fully optional
   • Make individual usage fields optional
   • Add default type configurations
   • Update related type definitions

2. Default Values

   • Default usage object: { used: 0, limit?: number }
   • Default usage.used: 0
   • Consider other fields that could benefit from defaults
   • Document default values

3. Implementation Requirements

   • Create new defaulting utility function
   • Handle nested optional fields
   • Preserve existing values when present
   • Maintain type safety
   • Add validation for default values

4. Integration Points

   • Update applyDefaults function
   • Modify CreateSessionDataParams interface
   • Update session creation flow
   • Adjust validation logic

5. Testing Requirements

   • Test full object defaulting
   • Test partial object defaulting
   • Test nested field defaulting
   • Verify type safety
   • Test edge cases

Fields to Default

• Full usage object when undefined
• usage.used when parent object exists
• Consider other optional fields for future expansion

Integration Points

• grantPermission.ts
• Types.ts
• Helpers.ts

References

• Current Implementation
• Session Types
• Helper Functions
• TypeScript Handbook - Optional Types

Any References?

No response

Code of Conduct

• I agree to follow this project's Code of Conduct.