feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 18
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-2e25417520c33948724b7835b9b98cdb13e719c64bb30310d63e6cfbb8f8c02a.yml
-openapi_spec_hash: e1117a859f74f4c7d41a8aee21c433e8
+configured_endpoints: 12
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-new-13d3700bbf9ff52715f14809e3a297c6f76e956a19b86d51ddf27059d846d276.yml
+openapi_spec_hash: c4f9fe259a4f8f58114611fc6f87f4f2
 config_hash: 9b9291a6c872b063900a46386729ba3c

README.md

@@ -43,43 +43,12 @@ const client = new Supermemory({
   apiKey: process.env['SUPERMEMORY_API_KEY'], // This is the default and can be omitted
 });
 
-const params: Supermemory.MemoryAddParams = {
-  content: 'This is a detailed article about machine learning concepts...',
-};
-const response: Supermemory.MemoryAddResponse = await client.memories.add(params);
+const params: Supermemory.SearchDocumentsParams = { q: 'machine learning concepts' };
+const response: Supermemory.SearchDocumentsResponse = await client.search.documents(params);
 ```
 
 Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
 
-## File uploads
-
-Request parameters that correspond to file uploads can be passed in many different forms:
-
-- `File` (or an object with the same structure)
-- a `fetch` `Response` (or an object with the same structure)
-- an `fs.ReadStream`
-- the return value of our `toFile` helper
-
-```ts
-import fs from 'fs';
-import Supermemory, { toFile } from 'supermemory';
-
-const client = new Supermemory();
-
-// If you have access to Node `fs` we recommend using `fs.createReadStream()`:
-await client.memories.uploadFile({ file: fs.createReadStream('/path/to/file') });
-
-// Or if you have the web `File` API you can pass a `File` instance:
-await client.memories.uploadFile({ file: new File(['my bytes'], 'file') });
-
-// You can also pass a `fetch` `Response`:
-await client.memories.uploadFile({ file: await fetch('https://somesite/file') });
-
-// Finally, if none of the above are convenient, you can use our `toFile` helper:
-await client.memories.uploadFile({ file: await toFile(Buffer.from('my bytes'), 'file') });
-await client.memories.uploadFile({ file: await toFile(new Uint8Array([0, 1, 2]), 'file') });
-```
-
 ## Handling errors
 
 When the library is unable to connect to the API,
@@ -88,17 +57,15 @@ a subclass of `APIError` will be thrown:
 
 <!-- prettier-ignore -->
 ```ts
-const response = await client.memories
-  .add({ content: 'This is a detailed article about machine learning concepts...' })
-  .catch(async (err) => {
-    if (err instanceof Supermemory.APIError) {
-      console.log(err.status); // 400
-      console.log(err.name); // BadRequestError
-      console.log(err.headers); // {server: 'nginx', ...}
-    } else {
-      throw err;
-    }
-  });
+const response = await client.search.documents({ q: 'machine learning concepts' }).catch(async (err) => {
+  if (err instanceof Supermemory.APIError) {
+    console.log(err.status); // 400
+    console.log(err.name); // BadRequestError
+    console.log(err.headers); // {server: 'nginx', ...}
+  } else {
+    throw err;
+  }
+});
 ```
 
 Error codes are as follows:
@@ -130,7 +97,7 @@ const client = new Supermemory({
 });
 
 // Or, configure per-request:
-await client.memories.add({ content: 'This is a detailed article about machine learning concepts...' }, {
+await client.search.documents({ q: 'machine learning concepts' }, {
   maxRetries: 5,
 });
 ```
@@ -147,7 +114,7 @@ const client = new Supermemory({
 });
 
 // Override per-request:
-await client.memories.add({ content: 'This is a detailed article about machine learning concepts...' }, {
+await client.search.documents({ q: 'machine learning concepts' }, {
   timeout: 5 * 1000,
 });
 ```
@@ -170,17 +137,15 @@ Unlike `.asResponse()` this method consumes the body, returning once it is parse
 ```ts
 const client = new Supermemory();
 
-const response = await client.memories
-  .add({ content: 'This is a detailed article about machine learning concepts...' })
-  .asResponse();
+const response = await client.search.documents({ q: 'machine learning concepts' }).asResponse();
 console.log(response.headers.get('X-My-Header'));
 console.log(response.statusText); // access the underlying Response object
 
-const { data: response, response: raw } = await client.memories
-  .add({ content: 'This is a detailed article about machine learning concepts...' })
+const { data: response, response: raw } = await client.search
+  .documents({ q: 'machine learning concepts' })
   .withResponse();
 console.log(raw.headers.get('X-My-Header'));
-console.log(response.id);
+console.log(response.results);
 ```
 
 ### Logging

api.md

@@ -1,22 +1,5 @@
 # Memories
 
-Types:
-
-- <code><a href="./src/resources/memories.ts">MemoryUpdateResponse</a></code>
-- <code><a href="./src/resources/memories.ts">MemoryListResponse</a></code>
-- <code><a href="./src/resources/memories.ts">MemoryAddResponse</a></code>
-- <code><a href="./src/resources/memories.ts">MemoryGetResponse</a></code>
-- <code><a href="./src/resources/memories.ts">MemoryUploadFileResponse</a></code>
-
-Methods:
-
-- <code title="patch /v3/memories/{id}">client.memories.<a href="./src/resources/memories.ts">update</a>(id, { ...params }) -> MemoryUpdateResponse</code>
-- <code title="post /v3/memories/list">client.memories.<a href="./src/resources/memories.ts">list</a>({ ...params }) -> MemoryListResponse</code>
-- <code title="delete /v3/memories/{id}">client.memories.<a href="./src/resources/memories.ts">delete</a>(id) -> void</code>
-- <code title="post /v3/memories">client.memories.<a href="./src/resources/memories.ts">add</a>({ ...params }) -> MemoryAddResponse</code>
-- <code title="get /v3/memories/{id}">client.memories.<a href="./src/resources/memories.ts">get</a>(id) -> MemoryGetResponse</code>
-- <code title="post /v3/memories/file">client.memories.<a href="./src/resources/memories.ts">uploadFile</a>({ ...params }) -> MemoryUploadFileResponse</code>
-
 # Search
 
 Types:

src/client.ts

@@ -33,18 +33,7 @@ import {
   ConnectionListResponse,
   Connections,
 } from './resources/connections';
-import {
-  Memories,
-  MemoryAddParams,
-  MemoryAddResponse,
-  MemoryGetResponse,
-  MemoryListParams,
-  MemoryListResponse,
-  MemoryUpdateParams,
-  MemoryUpdateResponse,
-  MemoryUploadFileParams,
-  MemoryUploadFileResponse,
-} from './resources/memories';
+import { Memories } from './resources/memories';
 import {
   Search,
   SearchDocumentsParams,
@@ -771,18 +760,7 @@ Supermemory.Connections = Connections;
 export declare namespace Supermemory {
   export type RequestOptions = Opts.RequestOptions;
 
-  export {
-    Memories as Memories,
-    type MemoryUpdateResponse as MemoryUpdateResponse,
-    type MemoryListResponse as MemoryListResponse,
-    type MemoryAddResponse as MemoryAddResponse,
-    type MemoryGetResponse as MemoryGetResponse,
-    type MemoryUploadFileResponse as MemoryUploadFileResponse,
-    type MemoryUpdateParams as MemoryUpdateParams,
-    type MemoryListParams as MemoryListParams,
-    type MemoryAddParams as MemoryAddParams,
-    type MemoryUploadFileParams as MemoryUploadFileParams,
-  };
+  export { Memories as Memories };
 
   export {
     Search as Search,

src/resources/index.ts

@@ -17,18 +17,7 @@ export {
   type ConnectionImportParams,
   type ConnectionListDocumentsParams,
 } from './connections';
-export {
-  Memories,
-  type MemoryUpdateResponse,
-  type MemoryListResponse,
-  type MemoryAddResponse,
-  type MemoryGetResponse,
-  type MemoryUploadFileResponse,
-  type MemoryUpdateParams,
-  type MemoryListParams,
-  type MemoryAddParams,
-  type MemoryUploadFileParams,
-} from './memories';
+export { Memories } from './memories';
 export {
   Search,
   type SearchDocumentsResponse,