@pageindex/sdk 0.3.0

package/dist/index.d.cts

@@ -0,0 +1,347 @@
+//#region src/api/types.d.ts
+interface SubmitDocumentOptions {
+  mode?: string;
+  folderId?: string;
+}
+interface SubmitDocumentResponse {
+  doc_id: string;
+}
+interface GetDocumentMetadataResponse {
+  id: string;
+  name: string;
+  description: string | null;
+  status: string;
+  createdAt: string;
+  pageNum?: number;
+  folderId?: string | null;
+}
+interface GetTreeOptions {
+  summary?: boolean;
+}
+interface TreeNodeContent {
+  title: string;
+  node_id: string;
+  page_index: number;
+  text?: string;
+  nodes?: TreeNodeContent[];
+}
+interface GetTreeResponse {
+  doc_id: string;
+  status: string;
+  retrieval_ready: boolean;
+  result: TreeNodeContent[];
+}
+interface GetOcrOptions {
+  format?: "page" | "node" | "raw";
+}
+interface OcrPageContent {
+  images: string[];
+  markdown: string;
+  page_index: number;
+  extended_node_candidates?: unknown[];
+}
+interface GetOcrResponse {
+  doc_id: string;
+  status: string;
+  retrieval_ready: boolean;
+  result: OcrPageContent[];
+}
+interface ListDocumentsOptions {
+  limit?: number;
+  offset?: number;
+  folderId?: string;
+}
+interface DocumentItem {
+  id: string;
+  name: string;
+  description: string | null;
+  status: string;
+  createdAt: string;
+  pageNum?: number;
+  folderId?: string | null;
+}
+interface ListDocumentsResponse {
+  documents: DocumentItem[];
+  total: number;
+  limit: number;
+  offset: number;
+}
+interface DeleteDocumentResponse {
+  message: string;
+}
+interface ChatCompletionsParams {
+  messages: Array<{
+    role: "system" | "user" | "assistant";
+    content: string;
+  }>;
+  doc_id?: string;
+  doc_ids?: string[];
+  model?: string;
+  stream?: boolean;
+  temperature?: number;
+  enable_citations?: boolean;
+  stream_metadata?: boolean;
+}
+interface ChatCompletionsResponse {
+  id: string;
+  choices: Array<{
+    index: number;
+    message: {
+      role: string;
+      content: string;
+    };
+    finish_reason: string;
+  }>;
+  usage?: {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+  };
+}
+//#endregion
+//#region src/api/client.d.ts
+interface PageIndexApiConfig {
+  apiUrl: string;
+  apiKey: string;
+  folderScope?: string;
+}
+declare class PageIndexApi {
+  private readonly baseUrl;
+  private readonly apiKey;
+  private readonly folderScope?;
+  constructor(config: PageIndexApiConfig);
+  submitDocument(file: Blob | Buffer | ArrayBuffer, fileName: string, options?: SubmitDocumentOptions): Promise<SubmitDocumentResponse>;
+  getDocument(docId: string): Promise<GetDocumentMetadataResponse>;
+  getTree(docId: string, options?: GetTreeOptions): Promise<GetTreeResponse>;
+  getOcr(docId: string, options?: GetOcrOptions): Promise<GetOcrResponse>;
+  listDocuments(options?: ListDocumentsOptions): Promise<ListDocumentsResponse>;
+  deleteDocument(docId: string): Promise<DeleteDocumentResponse>;
+  chatCompletions(params: ChatCompletionsParams): Promise<ChatCompletionsResponse>;
+  private request;
+  private requestMultipart;
+  private handleResponse;
+  private mapStatusToErrorCode;
+}
+//#endregion
+//#region src/transport.d.ts
+declare class McpTransport {
+  private config;
+  private client;
+  private transport;
+  private connected;
+  private folderScope;
+  private idleTimeout;
+  private idleTimer;
+  constructor(config: {
+    apiUrl: string;
+    apiKey: string;
+    folderScope?: string;
+    idleTimeout?: number;
+  });
+  private resetIdleTimer;
+  private clearIdleTimer;
+  setFolderScope(scope: string | undefined): Promise<void>;
+  isConnected: () => boolean;
+  connect(): Promise<void>;
+  callTool<T = unknown>(name: string, args: Record<string, unknown>): Promise<T>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/tools/types.d.ts
+interface NextSteps {
+  summary: string;
+  options: string[];
+  auto_retry?: string;
+}
+//#endregion
+//#region src/tools/create-folder.d.ts
+interface CreateFolderParams {
+  name: string;
+  description?: string;
+  parentFolderId?: string;
+}
+interface FolderItem {
+  id: string;
+  name: string;
+  description: string | null;
+  parent_folder_id: string | null;
+  created_at: string;
+  file_count: number;
+  children_count: number;
+}
+interface CreateFolderResult {
+  folder: FolderItem;
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/find-relevant-documents.d.ts
+interface FindRelevantDocumentsParams {
+  nameOrDescriptionFilter?: string;
+  cursor?: string;
+  limit?: number;
+}
+interface SearchDocumentItem {
+  id: string;
+  name: string;
+  description: string;
+  status: string;
+  pageNum: number;
+  createdAt: string;
+  folderId: string | null;
+}
+interface FindRelevantDocumentsResult {
+  docs: SearchDocumentItem[];
+  cursor?: string;
+  has_more: boolean;
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/get-document-structure.d.ts
+interface GetDocumentStructureParams {
+  docName: string;
+  part?: number;
+  waitForCompletion?: boolean;
+}
+interface GetDocumentStructureResult {
+  doc_name: string;
+  structure: unknown;
+  total_parts?: number;
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/get-document.d.ts
+interface GetDocumentParams {
+  docName: string;
+  waitForCompletion?: boolean;
+}
+interface GetDocumentResult {
+  id: string;
+  name: string;
+  description: string;
+  status: string;
+  createdAt: string;
+  pageNum?: number;
+  wait_info?: {
+    waited: boolean;
+    elapsed_seconds?: number;
+    final_status?: string;
+  };
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/get-page-content.d.ts
+interface GetPageContentParams {
+  docName: string;
+  pages: string;
+  waitForCompletion?: boolean;
+}
+interface PageContentItem {
+  page: number;
+  text: string;
+  block_id?: string;
+  image_count?: number;
+  image_annotations?: string[];
+}
+interface GetPageContentResult {
+  doc_name: string;
+  total_pages: number;
+  requested_pages: string;
+  returned_pages: string;
+  content: PageContentItem[];
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/list-folders.d.ts
+interface ListFoldersParams {
+  /**
+       * Use "root" for root-level folders only, a folder ID for subfolders, or omit for all folders
+       */
+  parentFolderId?: string;
+}
+interface ListFoldersResult {
+  folders: FolderItem[];
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/recent-documents.d.ts
+interface RecentDocumentItem {
+  id: string;
+  name: string;
+  description: string;
+  status: string;
+  createdAt: string;
+  pageNum?: number;
+}
+interface RecentDocumentsResult {
+  docs: RecentDocumentItem[];
+  total_shown: number;
+  processing_count: number;
+  ready_count: number;
+  failed_count: number;
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/remove-document.d.ts
+interface RemoveDocumentParams {
+  docNames: string[];
+}
+interface RemoveDocumentResult {
+  results: {
+    successful: number;
+    failed: number;
+    details: Array<{
+      doc_name: string;
+      success: boolean;
+      error?: string;
+    }>;
+  };
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/index.d.ts
+declare class PageIndexTools {
+  private transport;
+  constructor(transport: McpTransport);
+  recentDocuments: () => Promise<RecentDocumentsResult>;
+  findRelevantDocuments: (params?: FindRelevantDocumentsParams) => Promise<FindRelevantDocumentsResult>;
+  createFolder: (params: CreateFolderParams) => Promise<CreateFolderResult>;
+  listFolders: (params?: ListFoldersParams) => Promise<ListFoldersResult>;
+  getDocument: (params: GetDocumentParams) => Promise<GetDocumentResult>;
+  getDocumentStructure: (params: GetDocumentStructureParams) => Promise<GetDocumentStructureResult>;
+  getPageContent: (params: GetPageContentParams) => Promise<GetPageContentResult>;
+  removeDocument: (params: RemoveDocumentParams) => Promise<RemoveDocumentResult>;
+}
+//#endregion
+//#region src/client.d.ts
+interface PageIndexClientConfig {
+  apiKey: string;
+  apiUrl?: string;
+  folderScope?: string;
+  /** MCP connection idle timeout in ms. Set 0 to disable. Default: 60000 (60s) */
+  idleTimeout?: number;
+}
+declare class PageIndexClient {
+  private transport;
+  private _api;
+  private _tools;
+  constructor(config: PageIndexClientConfig);
+  get api(): PageIndexApi;
+  get tools(): PageIndexTools;
+  setFolderScope(scope: string | undefined): Promise<void>;
+  connect: () => Promise<void>;
+  isConnected: () => boolean;
+  close: () => Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
+}
+//#endregion
+//#region src/errors.d.ts
+type PageIndexErrorCode = "USAGE_LIMIT_REACHED" | "INVALID_INPUT" | "NOT_FOUND" | "UNAUTHORIZED" | "RATE_LIMITED" | "SERVICE_UNAVAILABLE" | "INTERNAL_ERROR";
+declare class PageIndexError extends Error {
+  readonly code?: PageIndexErrorCode | undefined;
+  readonly details?: Record<string, unknown> | undefined;
+  readonly statusCode?: number | undefined;
+  constructor(message: string, code?: PageIndexErrorCode | undefined, details?: Record<string, unknown> | undefined, statusCode?: number | undefined);
+}
+//#endregion
+export { ChatCompletionsParams, ChatCompletionsResponse, type CreateFolderParams, type CreateFolderResult, DeleteDocumentResponse, DocumentItem, type FindRelevantDocumentsParams, type FindRelevantDocumentsResult, type FolderItem, GetDocumentMetadataResponse, type GetDocumentParams, type GetDocumentResult, type GetDocumentStructureParams, type GetDocumentStructureResult, GetOcrOptions, GetOcrResponse, type GetPageContentParams, type GetPageContentResult, GetTreeOptions, GetTreeResponse, ListDocumentsOptions, ListDocumentsResponse, type ListFoldersParams, type ListFoldersResult, type NextSteps, OcrPageContent, type PageContentItem, PageIndexApi, type PageIndexApiConfig, PageIndexClient, type PageIndexClientConfig, PageIndexError, type PageIndexErrorCode, PageIndexTools, type RecentDocumentItem, type RecentDocumentsResult, type RemoveDocumentParams, type RemoveDocumentResult, type SearchDocumentItem, SubmitDocumentOptions, SubmitDocumentResponse, TreeNodeContent };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/api/types.ts","../src/api/client.ts","../src/transport.ts","../src/tools/types.ts","../src/tools/create-folder.ts","../src/tools/find-relevant-documents.ts","../src/tools/get-document-structure.ts","../src/tools/get-document.ts","../src/tools/get-page-content.ts","../src/tools/list-folders.ts","../src/tools/recent-documents.ts","../src/tools/remove-document.ts","../src/tools/index.ts","../src/client.ts","../src/errors.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,347 @@
+//#region src/api/types.d.ts
+interface SubmitDocumentOptions {
+  mode?: string;
+  folderId?: string;
+}
+interface SubmitDocumentResponse {
+  doc_id: string;
+}
+interface GetDocumentMetadataResponse {
+  id: string;
+  name: string;
+  description: string | null;
+  status: string;
+  createdAt: string;
+  pageNum?: number;
+  folderId?: string | null;
+}
+interface GetTreeOptions {
+  summary?: boolean;
+}
+interface TreeNodeContent {
+  title: string;
+  node_id: string;
+  page_index: number;
+  text?: string;
+  nodes?: TreeNodeContent[];
+}
+interface GetTreeResponse {
+  doc_id: string;
+  status: string;
+  retrieval_ready: boolean;
+  result: TreeNodeContent[];
+}
+interface GetOcrOptions {
+  format?: "page" | "node" | "raw";
+}
+interface OcrPageContent {
+  images: string[];
+  markdown: string;
+  page_index: number;
+  extended_node_candidates?: unknown[];
+}
+interface GetOcrResponse {
+  doc_id: string;
+  status: string;
+  retrieval_ready: boolean;
+  result: OcrPageContent[];
+}
+interface ListDocumentsOptions {
+  limit?: number;
+  offset?: number;
+  folderId?: string;
+}
+interface DocumentItem {
+  id: string;
+  name: string;
+  description: string | null;
+  status: string;
+  createdAt: string;
+  pageNum?: number;
+  folderId?: string | null;
+}
+interface ListDocumentsResponse {
+  documents: DocumentItem[];
+  total: number;
+  limit: number;
+  offset: number;
+}
+interface DeleteDocumentResponse {
+  message: string;
+}
+interface ChatCompletionsParams {
+  messages: Array<{
+    role: "system" | "user" | "assistant";
+    content: string;
+  }>;
+  doc_id?: string;
+  doc_ids?: string[];
+  model?: string;
+  stream?: boolean;
+  temperature?: number;
+  enable_citations?: boolean;
+  stream_metadata?: boolean;
+}
+interface ChatCompletionsResponse {
+  id: string;
+  choices: Array<{
+    index: number;
+    message: {
+      role: string;
+      content: string;
+    };
+    finish_reason: string;
+  }>;
+  usage?: {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+  };
+}
+//#endregion
+//#region src/api/client.d.ts
+interface PageIndexApiConfig {
+  apiUrl: string;
+  apiKey: string;
+  folderScope?: string;
+}
+declare class PageIndexApi {
+  private readonly baseUrl;
+  private readonly apiKey;
+  private readonly folderScope?;
+  constructor(config: PageIndexApiConfig);
+  submitDocument(file: Blob | Buffer | ArrayBuffer, fileName: string, options?: SubmitDocumentOptions): Promise<SubmitDocumentResponse>;
+  getDocument(docId: string): Promise<GetDocumentMetadataResponse>;
+  getTree(docId: string, options?: GetTreeOptions): Promise<GetTreeResponse>;
+  getOcr(docId: string, options?: GetOcrOptions): Promise<GetOcrResponse>;
+  listDocuments(options?: ListDocumentsOptions): Promise<ListDocumentsResponse>;
+  deleteDocument(docId: string): Promise<DeleteDocumentResponse>;
+  chatCompletions(params: ChatCompletionsParams): Promise<ChatCompletionsResponse>;
+  private request;
+  private requestMultipart;
+  private handleResponse;
+  private mapStatusToErrorCode;
+}
+//#endregion
+//#region src/transport.d.ts
+declare class McpTransport {
+  private config;
+  private client;
+  private transport;
+  private connected;
+  private folderScope;
+  private idleTimeout;
+  private idleTimer;
+  constructor(config: {
+    apiUrl: string;
+    apiKey: string;
+    folderScope?: string;
+    idleTimeout?: number;
+  });
+  private resetIdleTimer;
+  private clearIdleTimer;
+  setFolderScope(scope: string | undefined): Promise<void>;
+  isConnected: () => boolean;
+  connect(): Promise<void>;
+  callTool<T = unknown>(name: string, args: Record<string, unknown>): Promise<T>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/tools/types.d.ts
+interface NextSteps {
+  summary: string;
+  options: string[];
+  auto_retry?: string;
+}
+//#endregion
+//#region src/tools/create-folder.d.ts
+interface CreateFolderParams {
+  name: string;
+  description?: string;
+  parentFolderId?: string;
+}
+interface FolderItem {
+  id: string;
+  name: string;
+  description: string | null;
+  parent_folder_id: string | null;
+  created_at: string;
+  file_count: number;
+  children_count: number;
+}
+interface CreateFolderResult {
+  folder: FolderItem;
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/find-relevant-documents.d.ts
+interface FindRelevantDocumentsParams {
+  nameOrDescriptionFilter?: string;
+  cursor?: string;
+  limit?: number;
+}
+interface SearchDocumentItem {
+  id: string;
+  name: string;
+  description: string;
+  status: string;
+  pageNum: number;
+  createdAt: string;
+  folderId: string | null;
+}
+interface FindRelevantDocumentsResult {
+  docs: SearchDocumentItem[];
+  cursor?: string;
+  has_more: boolean;
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/get-document-structure.d.ts
+interface GetDocumentStructureParams {
+  docName: string;
+  part?: number;
+  waitForCompletion?: boolean;
+}
+interface GetDocumentStructureResult {
+  doc_name: string;
+  structure: unknown;
+  total_parts?: number;
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/get-document.d.ts
+interface GetDocumentParams {
+  docName: string;
+  waitForCompletion?: boolean;
+}
+interface GetDocumentResult {
+  id: string;
+  name: string;
+  description: string;
+  status: string;
+  createdAt: string;
+  pageNum?: number;
+  wait_info?: {
+    waited: boolean;
+    elapsed_seconds?: number;
+    final_status?: string;
+  };
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/get-page-content.d.ts
+interface GetPageContentParams {
+  docName: string;
+  pages: string;
+  waitForCompletion?: boolean;
+}
+interface PageContentItem {
+  page: number;
+  text: string;
+  block_id?: string;
+  image_count?: number;
+  image_annotations?: string[];
+}
+interface GetPageContentResult {
+  doc_name: string;
+  total_pages: number;
+  requested_pages: string;
+  returned_pages: string;
+  content: PageContentItem[];
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/list-folders.d.ts
+interface ListFoldersParams {
+  /**
+       * Use "root" for root-level folders only, a folder ID for subfolders, or omit for all folders
+       */
+  parentFolderId?: string;
+}
+interface ListFoldersResult {
+  folders: FolderItem[];
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/recent-documents.d.ts
+interface RecentDocumentItem {
+  id: string;
+  name: string;
+  description: string;
+  status: string;
+  createdAt: string;
+  pageNum?: number;
+}
+interface RecentDocumentsResult {
+  docs: RecentDocumentItem[];
+  total_shown: number;
+  processing_count: number;
+  ready_count: number;
+  failed_count: number;
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/remove-document.d.ts
+interface RemoveDocumentParams {
+  docNames: string[];
+}
+interface RemoveDocumentResult {
+  results: {
+    successful: number;
+    failed: number;
+    details: Array<{
+      doc_name: string;
+      success: boolean;
+      error?: string;
+    }>;
+  };
+  next_steps: NextSteps;
+}
+//#endregion
+//#region src/tools/index.d.ts
+declare class PageIndexTools {
+  private transport;
+  constructor(transport: McpTransport);
+  recentDocuments: () => Promise<RecentDocumentsResult>;
+  findRelevantDocuments: (params?: FindRelevantDocumentsParams) => Promise<FindRelevantDocumentsResult>;
+  createFolder: (params: CreateFolderParams) => Promise<CreateFolderResult>;
+  listFolders: (params?: ListFoldersParams) => Promise<ListFoldersResult>;
+  getDocument: (params: GetDocumentParams) => Promise<GetDocumentResult>;
+  getDocumentStructure: (params: GetDocumentStructureParams) => Promise<GetDocumentStructureResult>;
+  getPageContent: (params: GetPageContentParams) => Promise<GetPageContentResult>;
+  removeDocument: (params: RemoveDocumentParams) => Promise<RemoveDocumentResult>;
+}
+//#endregion
+//#region src/client.d.ts
+interface PageIndexClientConfig {
+  apiKey: string;
+  apiUrl?: string;
+  folderScope?: string;
+  /** MCP connection idle timeout in ms. Set 0 to disable. Default: 60000 (60s) */
+  idleTimeout?: number;
+}
+declare class PageIndexClient {
+  private transport;
+  private _api;
+  private _tools;
+  constructor(config: PageIndexClientConfig);
+  get api(): PageIndexApi;
+  get tools(): PageIndexTools;
+  setFolderScope(scope: string | undefined): Promise<void>;
+  connect: () => Promise<void>;
+  isConnected: () => boolean;
+  close: () => Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
+}
+//#endregion
+//#region src/errors.d.ts
+type PageIndexErrorCode = "USAGE_LIMIT_REACHED" | "INVALID_INPUT" | "NOT_FOUND" | "UNAUTHORIZED" | "RATE_LIMITED" | "SERVICE_UNAVAILABLE" | "INTERNAL_ERROR";
+declare class PageIndexError extends Error {
+  readonly code?: PageIndexErrorCode | undefined;
+  readonly details?: Record<string, unknown> | undefined;
+  readonly statusCode?: number | undefined;
+  constructor(message: string, code?: PageIndexErrorCode | undefined, details?: Record<string, unknown> | undefined, statusCode?: number | undefined);
+}
+//#endregion
+export { ChatCompletionsParams, ChatCompletionsResponse, type CreateFolderParams, type CreateFolderResult, DeleteDocumentResponse, DocumentItem, type FindRelevantDocumentsParams, type FindRelevantDocumentsResult, type FolderItem, GetDocumentMetadataResponse, type GetDocumentParams, type GetDocumentResult, type GetDocumentStructureParams, type GetDocumentStructureResult, GetOcrOptions, GetOcrResponse, type GetPageContentParams, type GetPageContentResult, GetTreeOptions, GetTreeResponse, ListDocumentsOptions, ListDocumentsResponse, type ListFoldersParams, type ListFoldersResult, type NextSteps, OcrPageContent, type PageContentItem, PageIndexApi, type PageIndexApiConfig, PageIndexClient, type PageIndexClientConfig, PageIndexError, type PageIndexErrorCode, PageIndexTools, type RecentDocumentItem, type RecentDocumentsResult, type RemoveDocumentParams, type RemoveDocumentResult, type SearchDocumentItem, SubmitDocumentOptions, SubmitDocumentResponse, TreeNodeContent };
+//# sourceMappingURL=index.d.mts.map