feat: make api key optional in sdk

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 115
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-4839625a63601d0e909ceeac53283a9b56d81464a10a95cd6c0cf5959ef3408b.yml
 openapi_spec_hash: 51fbc7ba45b9ff929e7d68b9dea32dba
-config_hash: d290a6d98369e3135a785ad352fb2996
+config_hash: 9add368b1f37ff4e27f59d9d065e3a36

src/client.ts

@@ -199,7 +199,7 @@ export interface ClientOptions {
   /**
    * Defaults to process.env['LETTA_API_KEY'].
    */
-  apiKey?: string | undefined;
+  apiKey?: string | null | undefined;
 
   projectID?: string | null | undefined;
 
@@ -290,7 +290,7 @@ export interface ClientOptions {
  * API Client for interfacing with the Letta API.
  */
 export class Letta {
-  apiKey: string;
+  apiKey: string | null;
   projectID: string | null;
   project: string | null;
 
@@ -309,7 +309,7 @@ export class Letta {
   /**
    * API Client for interfacing with the Letta API.
    *
-   * @param {string | undefined} [opts.apiKey=process.env['LETTA_API_KEY'] ?? undefined]
+   * @param {string | null | undefined} [opts.apiKey=process.env['LETTA_API_KEY'] ?? null]
    * @param {string | null | undefined} [opts.projectID]
    * @param {string | null | undefined} [opts.project]
    * @param {Environment} [opts.environment=cloud] - Specifies the environment URL to use for the API.
@@ -323,17 +323,11 @@ export class Letta {
    */
   constructor({
     baseURL = readEnv('LETTA_BASE_URL'),
-    apiKey = readEnv('LETTA_API_KEY'),
+    apiKey = readEnv('LETTA_API_KEY') ?? null,
     projectID = null,
     project = null,
     ...opts
   }: ClientOptions = {}) {
-    if (apiKey === undefined) {
-      throw new Errors.LettaError(
-        "The LETTA_API_KEY environment variable is missing or empty; either provide it, or instantiate the Letta client with an apiKey option, like new Letta({ apiKey: 'My API Key' }).",
-      );
-    }
-
     const options: ClientOptions = {
       apiKey,
       projectID,
@@ -412,10 +406,22 @@ export class Letta {
   }
 
   protected validateHeaders({ values, nulls }: NullableHeaders) {
-    return;
+    if (this.apiKey && values.get('authorization')) {
+      return;
+    }
+    if (nulls.has('authorization')) {
+      return;
+    }
+
+    throw new Error(
+      'Could not resolve authentication method. Expected the apiKey to be set. Or for the "Authorization" headers to be explicitly omitted',
+    );
   }
 
   protected async authHeaders(opts: FinalRequestOptions): Promise<NullableHeaders | undefined> {
+    if (this.apiKey == null) {
+      return undefined;
+    }
     return buildHeaders([{ Authorization: `Bearer ${this.apiKey}` }]);
   }