@papr/memory 1.20.0 → 2.0.0

package/src/client.ts

@@ -49,6 +49,7 @@ import {
   MemoryDeleteAllParams,
   MemoryDeleteParams,
   MemoryDeleteResponse,
+  MemoryGetParams,
   MemoryMetadata,
   MemorySearchParams,
   MemoryType,
@@ -58,6 +59,16 @@ import {
   SearchResponse,
 } from './resources/memory';
 import {
+  Omo,
+  OmoExportMemoriesAsJsonParams,
+  OmoExportMemoriesAsJsonResponse,
+  OmoExportMemoriesParams,
+  OmoExportMemoriesResponse,
+  OmoImportMemoriesParams,
+  OmoImportMemoriesResponse,
+} from './resources/omo';
+import {
+  PropertyDefinition,
   SchemaCreateParams,
   SchemaCreateResponse,
   SchemaDeleteResponse,
@@ -67,8 +78,16 @@ import {
   SchemaUpdateParams,
   SchemaUpdateResponse,
   Schemas,
+  SearchConfigOutput,
   UserGraphSchemaOutput,
 } from './resources/schemas';
+import {
+  Sync,
+  SyncGetDeltaParams,
+  SyncGetDeltaResponse,
+  SyncGetTiersParams,
+  SyncGetTiersResponse,
+} from './resources/sync';
 import {
   User,
   UserCreateBatchParams,
@@ -80,7 +99,9 @@ import {
   UserListResponse,
   UserResponse,
   UserType,
+  UserUpdateParams,
 } from './resources/user';
+import { MessageStoreParams, MessageStoreResponse, Messages } from './resources/messages/messages';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -597,9 +618,10 @@ export class Papr {
     controller: AbortController,
   ): Promise<Response> {
     const { signal, method, ...options } = init || {};
-    if (signal) signal.addEventListener('abort', () => controller.abort());
+    const abort = this._makeAbort(controller);
+    if (signal) signal.addEventListener('abort', abort, { once: true });
 
-    const timeout = setTimeout(() => controller.abort(), ms);
+    const timeout = setTimeout(abort, ms);
 
     const isReadableBody =
       ((globalThis as any).ReadableStream && options.body instanceof (globalThis as any).ReadableStream) ||
@@ -766,6 +788,12 @@ export class Papr {
     return headers.values;
   }
 
+  private _makeAbort(controller: AbortController) {
+    // note: we can't just inline this method inside `fetchWithTimeout()` because then the closure
+    //       would capture all request options, and cause a memory leak.
+    return () => controller.abort();
+  }
+
   private buildBody({ options: { body, headers: rawHeaders } }: { options: FinalRequestOptions }): {
     bodyHeaders: HeadersLike;
     body: BodyInit | undefined;
@@ -822,12 +850,25 @@ export class Papr {
 
   static toFile = Uploads.toFile;
 
+  static User: typeof User;
+  static Memory: typeof Memory;
+  static Feedback: typeof Feedback;
+  static Document: typeof Document;
+  static Schemas: typeof Schemas;
+  static Graphql: typeof Graphql;
+  static Messages: typeof Messages;
+  static Omo: typeof Omo;
+  static Sync: typeof Sync;
+
   user: API.User = new API.User(this);
   memory: API.Memory = new API.Memory(this);
   feedback: API.Feedback = new API.Feedback(this);
   document: API.Document = new API.Document(this);
   schemas: API.Schemas = new API.Schemas(this);
   graphql: API.Graphql = new API.Graphql(this);
+  messages: API.Messages = new API.Messages(this);
+  omo: API.Omo = new API.Omo(this);
+  sync: API.Sync = new API.Sync(this);
 }
 
 Papr.User = User;
@@ -836,25 +877,27 @@ Papr.Feedback = Feedback;
 Papr.Document = Document;
 Papr.Schemas = Schemas;
 Papr.Graphql = Graphql;
+Papr.Messages = Messages;
+Papr.Omo = Omo;
+Papr.Sync = Sync;
 
 export declare namespace Papr {
   export type RequestOptions = Opts.RequestOptions;
 
   export {
-    User as User,
     type UserResponse as UserResponse,
     type UserType as UserType,
     type UserListResponse as UserListResponse,
     type UserDeleteResponse as UserDeleteResponse,
     type UserCreateBatchResponse as UserCreateBatchResponse,
     type UserCreateParams as UserCreateParams,
+    type UserUpdateParams as UserUpdateParams,
     type UserListParams as UserListParams,
     type UserDeleteParams as UserDeleteParams,
     type UserCreateBatchParams as UserCreateBatchParams,
   };
 
   export {
-    Memory as Memory,
     type AddMemory as AddMemory,
     type AddMemoryResponse as AddMemoryResponse,
     type AutoGraphGeneration as AutoGraphGeneration,
@@ -874,11 +917,11 @@ export declare namespace Papr {
     type MemoryAddParams as MemoryAddParams,
     type MemoryAddBatchParams as MemoryAddBatchParams,
     type MemoryDeleteAllParams as MemoryDeleteAllParams,
+    type MemoryGetParams as MemoryGetParams,
     type MemorySearchParams as MemorySearchParams,
   };
 
   export {
-    Feedback as Feedback,
     type BatchRequest as BatchRequest,
     type BatchResponse as BatchResponse,
     type FeedbackRequest as FeedbackRequest,
@@ -889,7 +932,6 @@ export declare namespace Papr {
   };
 
   export {
-    Document as Document,
     type DocumentCancelProcessingResponse as DocumentCancelProcessingResponse,
     type DocumentGetStatusResponse as DocumentGetStatusResponse,
     type DocumentUploadResponse as DocumentUploadResponse,
@@ -897,7 +939,8 @@ export declare namespace Papr {
   };
 
   export {
-    Schemas as Schemas,
+    type PropertyDefinition as PropertyDefinition,
+    type SearchConfigOutput as SearchConfigOutput,
     type UserGraphSchemaOutput as UserGraphSchemaOutput,
     type SchemaCreateResponse as SchemaCreateResponse,
     type SchemaRetrieveResponse as SchemaRetrieveResponse,
@@ -910,10 +953,39 @@ export declare namespace Papr {
   };
 
   export {
-    Graphql as Graphql,
     type GraphqlPlaygroundResponse as GraphqlPlaygroundResponse,
     type GraphqlQueryResponse as GraphqlQueryResponse,
   };
 
+  export {
+    type MessageStoreResponse as MessageStoreResponse,
+    type MessageStoreParams as MessageStoreParams,
+  };
+
+  export {
+    type OmoExportMemoriesResponse as OmoExportMemoriesResponse,
+    type OmoExportMemoriesAsJsonResponse as OmoExportMemoriesAsJsonResponse,
+    type OmoImportMemoriesResponse as OmoImportMemoriesResponse,
+    type OmoExportMemoriesParams as OmoExportMemoriesParams,
+    type OmoExportMemoriesAsJsonParams as OmoExportMemoriesAsJsonParams,
+    type OmoImportMemoriesParams as OmoImportMemoriesParams,
+  };
+
+  export {
+    type SyncGetDeltaResponse as SyncGetDeltaResponse,
+    type SyncGetTiersResponse as SyncGetTiersResponse,
+    type SyncGetDeltaParams as SyncGetDeltaParams,
+    type SyncGetTiersParams as SyncGetTiersParams,
+  };
+
+  export type ACLConfig = API.ACLConfig;
   export type AddMemoryItem = API.AddMemoryItem;
+  export type EdgeConstraintInput = API.EdgeConstraintInput;
+  export type Memory = API.Memory;
+  export type MemoryPolicy = API.MemoryPolicy;
+  export type NodeConstraintInput = API.NodeConstraintInput;
+  export type NodeSpec = API.NodeSpec;
+  export type PropertyValue = API.PropertyValue;
+  export type RelationshipSpec = API.RelationshipSpec;
+  export type SearchConfigInput = API.SearchConfigInput;
 }

package/src/internal/parse.ts

@@ -29,6 +29,12 @@ export async function defaultParseResponse<T>(client: Papr, props: APIResponsePr
     const mediaType = contentType?.split(';')[0]?.trim();
     const isJSON = mediaType?.includes('application/json') || mediaType?.endsWith('+json');
     if (isJSON) {
+      const contentLength = response.headers.get('content-length');
+      if (contentLength === '0') {
+        // if there is no content we can't do anything
+        return undefined as T;
+      }
+
       const json = await response.json();
       return json as T;
     }

package/src/resources/document.ts

@@ -126,15 +126,26 @@ export namespace DocumentUploadResponse {
 export interface DocumentUploadParams {
   file: Uploadable;
 
-  end_user_id?: string | null;
+  /**
+   * Your application's user identifier. This is the primary way to identify users.
+   * Also accepts legacy 'end_user_id'.
+   */
+  external_user_id?: string | null;
 
   graph_override?: string | null;
 
   hierarchical_enabled?: boolean;
 
+  /**
+   * JSON-encoded memory policy. Includes mode ('auto'/'manual'), schema_id,
+   * node_constraints (applied in auto mode when present), and OMO fields (consent,
+   * risk, acl). This is the recommended way to configure memory processing.
+   */
+  memory_policy?: string | null;
+
   metadata?: string | null;
 
-  namespace?: string | null;
+  namespace_id?: string | null;
 
   /**
    * Preferred provider for document processing.
@@ -145,8 +156,10 @@ export interface DocumentUploadParams {
 
   schema_id?: string | null;
 
-  simple_schema_mode?: boolean;
-
+  /**
+   * DEPRECATED: Internal Papr Parse user ID. Most developers should use
+   * external_user_id.
+   */
   user_id?: string | null;
 
   webhook_secret?: string | null;

package/src/resources/index.ts

@@ -40,10 +40,23 @@ export {
   type MemoryAddParams,
   type MemoryAddBatchParams,
   type MemoryDeleteAllParams,
+  type MemoryGetParams,
   type MemorySearchParams,
 } from './memory';
+export { Messages, type MessageStoreResponse, type MessageStoreParams } from './messages/messages';
+export {
+  Omo,
+  type OmoExportMemoriesResponse,
+  type OmoExportMemoriesAsJsonResponse,
+  type OmoImportMemoriesResponse,
+  type OmoExportMemoriesParams,
+  type OmoExportMemoriesAsJsonParams,
+  type OmoImportMemoriesParams,
+} from './omo';
 export {
   Schemas,
+  type PropertyDefinition,
+  type SearchConfigOutput,
   type UserGraphSchemaOutput,
   type SchemaCreateResponse,
   type SchemaRetrieveResponse,
@@ -54,6 +67,13 @@ export {
   type SchemaUpdateParams,
   type SchemaListParams,
 } from './schemas';
+export {
+  Sync,
+  type SyncGetDeltaResponse,
+  type SyncGetTiersResponse,
+  type SyncGetDeltaParams,
+  type SyncGetTiersParams,
+} from './sync';
 export {
   User,
   type UserResponse,
@@ -62,6 +82,7 @@ export {
   type UserDeleteResponse,
   type UserCreateBatchResponse,
   type UserCreateParams,
+  type UserUpdateParams,
   type UserListParams,
   type UserDeleteParams,
   type UserCreateBatchParams,