sdk v2 with no async init

Author: anttiviljami

docs/auth/authentication.md

@@ -53,7 +53,7 @@ epilot.authorize('my-static-api-token')                       // static string
 import { authorize } from '@epilot/sdk'
 import { getClient } from '@epilot/sdk/entity'
 
-const entityClient = await getClient()
+const entityClient = getClient()
 authorize(entityClient, () => '<my-token>')
 ```
 
@@ -74,8 +74,8 @@ Pass the caller's headers to downstream APIs for permission checks:
 import { getClient } from '@epilot/sdk/entity'
 import { getLambdaRunner } from 'openapi-lambda-adapter'
 
-const getEntityClient = async (passedHeaders: Headers) => {
-  const client = await getClient()
+const getEntityClient = (passedHeaders: Headers) => {
+  const client = getClient()
   client.api.registerRunner(getLambdaRunner(process.env.ENTITY_LAMBDA_NAME))
   client.defaults.headers.common = {
     authorization: passedHeaders['authorization'],

docs/auth/token-types.md

@@ -57,7 +57,7 @@ Create tokens in the epilot portal under **Settings > Access Tokens**, or progra
 ```typescript title="create-access-token.ts"
 import { authorize, getClient } from '@epilot/sdk/access-token';
 
-const accessTokenClient = await getClient();
+const accessTokenClient = getClient();
 authorize(accessTokenClient, cognitoIdToken);
 
 const { data } = await accessTokenClient.createAccessToken(null, {

docs/sdk/client-usage.md

@@ -39,17 +39,17 @@ const { data } = await entityClient.get('/v2/entity/schemas/contact/123')
 Use `getClient()` when you need direct access to the underlying axios instance, for example to set custom headers or add interceptors.
 
 ```ts
-const entityClient = await epilot.entity.getClient()
+const entityClient = epilot.entity.getClient()
 const { data } = await entityClient.getEntity({ slug: 'contact', id: '123' })
 ```
 
-`getClient()` returns a cached singleton. Calling it multiple times returns the same instance (until config changes).
+`getClient()` is synchronous and returns a cached singleton. Calling it multiple times returns the same instance (until config changes).
 
 :::warning Stale references
 If you hold a client reference and then change config, your reference still points to the old client:
 
 ```ts
-const entityClient = await epilot.entity.getClient()
+const entityClient = epilot.entity.getClient()
 
 epilot.authorize(() => 'new-token') // invalidates cached clients
 
@@ -67,7 +67,7 @@ Use `createClient()` when you need a completely independent client that is not s
 ```ts
 import { createClient, authorize } from '@epilot/sdk/entity'
 
-const entityClient = await createClient()
+const entityClient = createClient()
 authorize(entityClient, () => '<my-token>')
 entityClient.defaults.headers.common['x-epilot-org-id'] = 'org-123'
 ```
@@ -79,7 +79,7 @@ Import only the APIs you use. Other APIs never touch your bundle.
 ```ts
 import { getClient, authorize } from '@epilot/sdk/entity'
 
-const entityClient = await getClient()
+const entityClient = getClient()
 authorize(entityClient, () => '<my-token>')
 
 const { data } = await entityClient.getEntity({ slug: 'contact', id: '123' })
@@ -141,5 +141,19 @@ When you call `authorize()`, `headers()`, `retry()`, `largeResponse()`, or `inte
 | Pattern | Always up to date? | Notes |
 | --- | --- | --- |
 | `epilot.entity.getEntity(...)` | Yes | Re-resolves the client on every call |
-| `await epilot.entity.getClient()` | At time of call | Can go stale after config changes |
-| `await createClient()` | Independent | Not affected by SDK config changes |
+| `epilot.entity.getClient()` | At time of call | Can go stale after config changes |
+| `createClient()` | Independent | Not affected by SDK config changes |
+
+## Migration from `@epilot/*-client`
+
+Drop-in replacement — just change the import path:
+
+```ts
+// Before
+import { getClient, createClient, authorize } from '@epilot/entity-client'
+import type { Client, Entity } from '@epilot/entity-client'
+
+// After
+import { getClient, createClient, authorize } from '@epilot/sdk/entity'
+import type { Client, Entity } from '@epilot/sdk/entity'
+```

docs/sdk/clients/access-token.md

@@ -21,7 +21,7 @@ const { data } = await epilot.accessToken.createAccessToken(...)
 ```ts
 import { getClient, authorize } from '@epilot/sdk/access-token'
 
-const accessTokenClient = await getClient()
+const accessTokenClient = getClient()
 authorize(accessTokenClient, () => '<token>')
 const { data } = await accessTokenClient.createAccessToken(...)
 ```

docs/sdk/clients/address-suggestions.md

@@ -21,7 +21,7 @@ const { data } = await epilot.addressSuggestions.getAddresses(...)
 ```ts
 import { getClient, authorize } from '@epilot/sdk/address-suggestions'
 
-const addressSuggestionsClient = await getClient()
+const addressSuggestionsClient = getClient()
 authorize(addressSuggestionsClient, () => '<token>')
 const { data } = await addressSuggestionsClient.getAddresses(...)
 ```

docs/sdk/clients/address.md

@@ -21,7 +21,7 @@ const { data } = await epilot.address.getAddressSuggestions(...)
 ```ts
 import { getClient, authorize } from '@epilot/sdk/address'
 
-const addressClient = await getClient()
+const addressClient = getClient()
 authorize(addressClient, () => '<token>')
 const { data } = await addressClient.getAddressSuggestions(...)
 ```

docs/sdk/clients/ai-agents.md

@@ -21,7 +21,7 @@ const { data } = await epilot.aiAgents.createAgent(...)
 ```ts
 import { getClient, authorize } from '@epilot/sdk/ai-agents'
 
-const aiAgentsClient = await getClient()
+const aiAgentsClient = getClient()
 authorize(aiAgentsClient, () => '<token>')
 const { data } = await aiAgentsClient.createAgent(...)
 ```

docs/sdk/clients/app.md

@@ -21,7 +21,7 @@ const { data } = await epilot.app.getPublicFacingComponent(...)
 ```ts
 import { getClient, authorize } from '@epilot/sdk/app'
 
-const appClient = await getClient()
+const appClient = getClient()
 authorize(appClient, () => '<token>')
 const { data } = await appClient.getPublicFacingComponent(...)
 ```

docs/sdk/clients/audit-logs.md

@@ -21,7 +21,7 @@ const { data } = await epilot.auditLogs.getLogs(...)
 ```ts
 import { getClient, authorize } from '@epilot/sdk/audit-logs'
 
-const auditLogsClient = await getClient()
+const auditLogsClient = getClient()
 authorize(auditLogsClient, () => '<token>')
 const { data } = await auditLogsClient.getLogs(...)
 ```

docs/sdk/clients/automation.md

@@ -21,7 +21,7 @@ const { data } = await epilot.automation.searchFlows(...)
 ```ts
 import { getClient, authorize } from '@epilot/sdk/automation'
 
-const automationClient = await getClient()
+const automationClient = getClient()
 authorize(automationClient, () => '<token>')
 const { data } = await automationClient.searchFlows(...)
 ```