@robosystems/client 0.2.43 → 0.2.44

package/sdk-extensions/DocumentClient.js

@@ -1,176 +0,0 @@
-'use client';
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocumentClient = void 0;
-/**
- * Document Client for RoboSystems API
- *
- * Upload, search, list, and delete text documents indexed in OpenSearch.
- * Documents are sectioned on markdown headings, embedded for semantic search,
- * and searchable alongside structured graph data.
- */
-const sdk_gen_1 = require("../sdk/sdk.gen");
-class DocumentClient {
-    constructor(config) {
-        this.config = config;
-    }
-    /**
-     * Upload a markdown document for text indexing.
-     *
-     * The document is sectioned on headings, embedded, and indexed
-     * into OpenSearch for full-text and semantic search.
-     */
-    async upload(graphId, title, content, options = {}) {
-        const response = await (0, sdk_gen_1.uploadDocument)({
-            path: { graph_id: graphId },
-            body: {
-                title,
-                content,
-                tags: options.tags ?? null,
-                folder: options.folder ?? null,
-                external_id: options.externalId ?? null,
-            },
-        });
-        if (response.error) {
-            throw new Error(`Document upload failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * Get a document with full content by ID.
-     *
-     * Returns the raw markdown content and metadata from PostgreSQL.
-     *
-     * @returns DocumentDetailResponse or null if not found.
-     */
-    async get(graphId, documentId) {
-        const response = await (0, sdk_gen_1.getDocument)({
-            path: { graph_id: graphId, document_id: documentId },
-        });
-        if (response.response.status === 404) {
-            return null;
-        }
-        if (response.error) {
-            throw new Error(`Get document failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * Update a document's content and/or metadata.
-     *
-     * Only provided fields are updated. Content is re-sectioned,
-     * re-embedded, and re-indexed in OpenSearch.
-     */
-    async update(graphId, documentId, options) {
-        const response = await (0, sdk_gen_1.updateDocument)({
-            path: { graph_id: graphId, document_id: documentId },
-            body: {
-                title: options.title ?? undefined,
-                content: options.content ?? undefined,
-                tags: options.tags !== undefined ? options.tags : undefined,
-                folder: options.folder !== undefined ? options.folder : undefined,
-            },
-        });
-        if (response.error) {
-            throw new Error(`Update document failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * Upload multiple markdown documents (max 50 per request).
-     */
-    async uploadBulk(graphId, documents) {
-        const response = await (0, sdk_gen_1.uploadDocumentsBulk)({
-            path: { graph_id: graphId },
-            body: {
-                documents: documents.map((doc) => ({
-                    title: doc.title,
-                    content: doc.content,
-                    tags: doc.tags ?? null,
-                    folder: doc.folder ?? null,
-                    external_id: doc.externalId ?? null,
-                })),
-            },
-        });
-        if (response.error) {
-            throw new Error(`Bulk upload failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * Search documents with hybrid (BM25 + kNN) search.
-     */
-    async search(graphId, query, options = {}) {
-        const response = await (0, sdk_gen_1.searchDocuments)({
-            path: { graph_id: graphId },
-            body: {
-                query,
-                source_type: options.sourceType ?? null,
-                entity: options.entity ?? null,
-                form_type: options.formType ?? null,
-                section: options.section ?? null,
-                element: options.element ?? null,
-                fiscal_year: options.fiscalYear ?? null,
-                date_from: options.dateFrom ?? null,
-                date_to: options.dateTo ?? null,
-                size: options.size,
-                offset: options.offset,
-            },
-        });
-        if (response.error) {
-            throw new Error(`Document search failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * Retrieve the full text of a document section by ID.
-     *
-     * @returns DocumentSection or null if not found.
-     */
-    async getSection(graphId, documentId) {
-        const response = await (0, sdk_gen_1.getDocumentSection)({
-            path: { graph_id: graphId, document_id: documentId },
-        });
-        if (response.response.status === 404) {
-            return null;
-        }
-        if (response.error) {
-            throw new Error(`Get section failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * List indexed documents for a graph.
-     */
-    async list(graphId, sourceType) {
-        const response = await (0, sdk_gen_1.listDocuments)({
-            path: { graph_id: graphId },
-            query: sourceType ? { source_type: sourceType } : undefined,
-        });
-        if (response.error) {
-            throw new Error(`List documents failed: ${JSON.stringify(response.error)}`);
-        }
-        return response.data;
-    }
-    /**
-     * Delete a document and all its sections.
-     *
-     * @returns true if deleted, false if not found.
-     */
-    async delete(graphId, documentId) {
-        const response = await (0, sdk_gen_1.deleteDocument)({
-            path: { graph_id: graphId, document_id: documentId },
-        });
-        if (response.response.status === 204) {
-            return true;
-        }
-        if (response.response.status === 404) {
-            return false;
-        }
-        if (response.error) {
-            throw new Error(`Delete document failed: ${JSON.stringify(response.error)}`);
-        }
-        return true;
-    }
-}
-exports.DocumentClient = DocumentClient;

package/sdk-extensions/DocumentClient.ts

@@ -1,297 +0,0 @@
-'use client'
-
-/**
- * Document Client for RoboSystems API
- *
- * Upload, search, list, and delete text documents indexed in OpenSearch.
- * Documents are sectioned on markdown headings, embedded for semantic search,
- * and searchable alongside structured graph data.
- */
-
-import {
-  deleteDocument,
-  getDocument,
-  getDocumentSection,
-  listDocuments,
-  searchDocuments,
-  updateDocument,
-  uploadDocument,
-  uploadDocumentsBulk,
-} from '../sdk/sdk.gen'
-import type {
-  BulkDocumentUploadResponse,
-  DocumentDetailResponse,
-  DocumentListResponse,
-  DocumentSection,
-  DocumentUploadResponse,
-  SearchResponse,
-} from '../sdk/types.gen'
-
-export interface DocumentSearchOptions {
-  /** Filter by source type (xbrl_textblock, narrative_section, ixbrl_disclosure, uploaded_doc, memory) */
-  sourceType?: string
-  /** Filter by ticker, CIK, or entity name */
-  entity?: string
-  /** Filter by SEC form type (10-K, 10-Q) */
-  formType?: string
-  /** Filter by section ID (item_1, item_1a, item_7, etc.) */
-  section?: string
-  /** Filter by XBRL element qname (e.g., us-gaap:Goodwill) */
-  element?: string
-  /** Filter by fiscal year */
-  fiscalYear?: number
-  /** Filter filings on or after date (YYYY-MM-DD) */
-  dateFrom?: string
-  /** Filter filings on or before date (YYYY-MM-DD) */
-  dateTo?: string
-  /** Max results to return (default: 10) */
-  size?: number
-  /** Pagination offset */
-  offset?: number
-}
-
-export interface DocumentUploadOptions {
-  /** Optional tags for filtering */
-  tags?: string[]
-  /** Optional folder/category */
-  folder?: string
-  /** Optional external ID for upsert behavior */
-  externalId?: string
-}
-
-export interface DocumentUpdateOptions {
-  /** Updated title */
-  title?: string
-  /** Updated markdown content */
-  content?: string
-  /** Updated tags (null to clear) */
-  tags?: string[] | null
-  /** Updated folder (null to clear) */
-  folder?: string | null
-}
-
-export class DocumentClient {
-  private config: {
-    baseUrl: string
-    credentials?: 'include' | 'same-origin' | 'omit'
-    headers?: Record<string, string>
-    token?: string
-  }
-
-  constructor(config: {
-    baseUrl: string
-    credentials?: 'include' | 'same-origin' | 'omit'
-    headers?: Record<string, string>
-    token?: string
-  }) {
-    this.config = config
-  }
-
-  /**
-   * Upload a markdown document for text indexing.
-   *
-   * The document is sectioned on headings, embedded, and indexed
-   * into OpenSearch for full-text and semantic search.
-   */
-  async upload(
-    graphId: string,
-    title: string,
-    content: string,
-    options: DocumentUploadOptions = {}
-  ): Promise<DocumentUploadResponse> {
-    const response = await uploadDocument({
-      path: { graph_id: graphId },
-      body: {
-        title,
-        content,
-        tags: options.tags ?? null,
-        folder: options.folder ?? null,
-        external_id: options.externalId ?? null,
-      },
-    })
-
-    if (response.error) {
-      throw new Error(`Document upload failed: ${JSON.stringify(response.error)}`)
-    }
-
-    return response.data as DocumentUploadResponse
-  }
-
-  /**
-   * Get a document with full content by ID.
-   *
-   * Returns the raw markdown content and metadata from PostgreSQL.
-   *
-   * @returns DocumentDetailResponse or null if not found.
-   */
-  async get(graphId: string, documentId: string): Promise<DocumentDetailResponse | null> {
-    const response = await getDocument({
-      path: { graph_id: graphId, document_id: documentId },
-    })
-
-    if (response.response.status === 404) {
-      return null
-    }
-
-    if (response.error) {
-      throw new Error(`Get document failed: ${JSON.stringify(response.error)}`)
-    }
-
-    return response.data as DocumentDetailResponse
-  }
-
-  /**
-   * Update a document's content and/or metadata.
-   *
-   * Only provided fields are updated. Content is re-sectioned,
-   * re-embedded, and re-indexed in OpenSearch.
-   */
-  async update(
-    graphId: string,
-    documentId: string,
-    options: DocumentUpdateOptions
-  ): Promise<DocumentUploadResponse> {
-    const response = await updateDocument({
-      path: { graph_id: graphId, document_id: documentId },
-      body: {
-        title: options.title ?? undefined,
-        content: options.content ?? undefined,
-        tags: options.tags !== undefined ? options.tags : undefined,
-        folder: options.folder !== undefined ? options.folder : undefined,
-      },
-    })
-
-    if (response.error) {
-      throw new Error(`Update document failed: ${JSON.stringify(response.error)}`)
-    }
-
-    return response.data as DocumentUploadResponse
-  }
-
-  /**
-   * Upload multiple markdown documents (max 50 per request).
-   */
-  async uploadBulk(
-    graphId: string,
-    documents: Array<{
-      title: string
-      content: string
-      tags?: string[]
-      folder?: string
-      externalId?: string
-    }>
-  ): Promise<BulkDocumentUploadResponse> {
-    const response = await uploadDocumentsBulk({
-      path: { graph_id: graphId },
-      body: {
-        documents: documents.map((doc) => ({
-          title: doc.title,
-          content: doc.content,
-          tags: doc.tags ?? null,
-          folder: doc.folder ?? null,
-          external_id: doc.externalId ?? null,
-        })),
-      },
-    })
-
-    if (response.error) {
-      throw new Error(`Bulk upload failed: ${JSON.stringify(response.error)}`)
-    }
-
-    return response.data as BulkDocumentUploadResponse
-  }
-
-  /**
-   * Search documents with hybrid (BM25 + kNN) search.
-   */
-  async search(
-    graphId: string,
-    query: string,
-    options: DocumentSearchOptions = {}
-  ): Promise<SearchResponse> {
-    const response = await searchDocuments({
-      path: { graph_id: graphId },
-      body: {
-        query,
-        source_type: options.sourceType ?? null,
-        entity: options.entity ?? null,
-        form_type: options.formType ?? null,
-        section: options.section ?? null,
-        element: options.element ?? null,
-        fiscal_year: options.fiscalYear ?? null,
-        date_from: options.dateFrom ?? null,
-        date_to: options.dateTo ?? null,
-        size: options.size,
-        offset: options.offset,
-      },
-    })
-
-    if (response.error) {
-      throw new Error(`Document search failed: ${JSON.stringify(response.error)}`)
-    }
-
-    return response.data as SearchResponse
-  }
-
-  /**
-   * Retrieve the full text of a document section by ID.
-   *
-   * @returns DocumentSection or null if not found.
-   */
-  async getSection(graphId: string, documentId: string): Promise<DocumentSection | null> {
-    const response = await getDocumentSection({
-      path: { graph_id: graphId, document_id: documentId },
-    })
-
-    if (response.response.status === 404) {
-      return null
-    }
-
-    if (response.error) {
-      throw new Error(`Get section failed: ${JSON.stringify(response.error)}`)
-    }
-
-    return response.data as DocumentSection
-  }
-
-  /**
-   * List indexed documents for a graph.
-   */
-  async list(graphId: string, sourceType?: string): Promise<DocumentListResponse> {
-    const response = await listDocuments({
-      path: { graph_id: graphId },
-      query: sourceType ? { source_type: sourceType } : undefined,
-    })
-
-    if (response.error) {
-      throw new Error(`List documents failed: ${JSON.stringify(response.error)}`)
-    }
-
-    return response.data as DocumentListResponse
-  }
-
-  /**
-   * Delete a document and all its sections.
-   *
-   * @returns true if deleted, false if not found.
-   */
-  async delete(graphId: string, documentId: string): Promise<boolean> {
-    const response = await deleteDocument({
-      path: { graph_id: graphId, document_id: documentId },
-    })
-
-    if (response.response.status === 204) {
-      return true
-    }
-
-    if (response.response.status === 404) {
-      return false
-    }
-
-    if (response.error) {
-      throw new Error(`Delete document failed: ${JSON.stringify(response.error)}`)
-    }
-
-    return true
-  }
-}

package/sdk-extensions/FileClient.d.ts

@@ -1,57 +0,0 @@
-export interface FileUploadOptions {
-    onProgress?: (message: string) => void;
-    fileName?: string;
-    ingestToGraph?: boolean;
-}
-export interface FileUploadResult {
-    fileId: string;
-    fileSize: number;
-    rowCount: number;
-    tableName: string;
-    fileName: string;
-    success: boolean;
-    error?: string;
-}
-export interface FileInfo {
-    fileId: string;
-    fileName: string;
-    tableName: string;
-    status: string;
-    fileSize: number;
-    rowCount: number;
-    createdAt: string;
-}
-export type FileInput = File | Blob | Buffer | ReadableStream<Uint8Array>;
-export declare class FileClient {
-    private config;
-    constructor(config: {
-        baseUrl: string;
-        credentials?: 'include' | 'same-origin' | 'omit';
-        headers?: Record<string, string>;
-        token?: string;
-        s3EndpointUrl?: string;
-    });
-    /**
-     * Upload a Parquet file to staging
-     *
-     * Handles the complete 3-step upload process:
-     * 1. Get presigned upload URL
-     * 2. Upload file to S3
-     * 3. Mark file as 'uploaded' (backend validates, calculates size/row count)
-     */
-    upload(graphId: string, tableName: string, fileOrBuffer: FileInput, options?: FileUploadOptions): Promise<FileUploadResult>;
-    /**
-     * List files in a graph
-     */
-    list(graphId: string, tableName?: string, status?: string): Promise<FileInfo[]>;
-    /**
-     * Get file information
-     */
-    get(graphId: string, fileId: string): Promise<FileInfo | null>;
-    /**
-     * Delete a file
-     */
-    delete(graphId: string, fileId: string, cascade?: boolean): Promise<boolean>;
-    private getFileName;
-    private getFileContent;
-}