@robosystems/client 0.2.41 → 0.2.43

package/extensions/DocumentClient.d.ts

@@ -1,4 +1,4 @@
-import type { BulkDocumentUploadResponse, DocumentListResponse, DocumentSection, DocumentUploadResponse, SearchResponse } from '../types.gen';
+import type { BulkDocumentUploadResponse, DocumentDetailResponse, DocumentListResponse, DocumentSection, DocumentUploadResponse, SearchResponse } from '../types.gen';
 export interface DocumentSearchOptions {
     /** Filter by source type (xbrl_textblock, narrative_section, ixbrl_disclosure, uploaded_doc, memory) */
     sourceType?: string;
@@ -29,6 +29,16 @@ export interface DocumentUploadOptions {
     /** 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 declare class DocumentClient {
     private config;
     constructor(config: {
@@ -44,6 +54,21 @@ export declare class DocumentClient {
      * into OpenSearch for full-text and semantic search.
      */
     upload(graphId: string, title: string, content: string, options?: DocumentUploadOptions): Promise<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.
+     */
+    get(graphId: string, documentId: string): Promise<DocumentDetailResponse | null>;
+    /**
+     * Update a document's content and/or metadata.
+     *
+     * Only provided fields are updated. Content is re-sectioned,
+     * re-embedded, and re-indexed in OpenSearch.
+     */
+    update(graphId: string, documentId: string, options: DocumentUpdateOptions): Promise<DocumentUploadResponse>;
     /**
      * Upload multiple markdown documents (max 50 per request).
      */

package/extensions/DocumentClient.js

@@ -36,6 +36,46 @@ class DocumentClient {
         }
         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).
      */

package/extensions/DocumentClient.ts

@@ -10,14 +10,17 @@
 
 import {
   deleteDocument,
+  getDocument,
   getDocumentSection,
   listDocuments,
   searchDocuments,
+  updateDocument,
   uploadDocument,
   uploadDocumentsBulk,
 } from '../sdk.gen'
 import type {
   BulkDocumentUploadResponse,
+  DocumentDetailResponse,
   DocumentListResponse,
   DocumentSection,
   DocumentUploadResponse,
@@ -56,6 +59,17 @@ export interface DocumentUploadOptions {
   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
@@ -103,6 +117,57 @@ export class DocumentClient {
     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).
    */

package/extensions/ReportClient.d.ts

@@ -12,6 +12,8 @@ export interface Report {
     createdAt: string;
     lastGenerated: string | null;
     structures: Structure[];
+    /** Entity name (source company for shared reports, own entity for native) */
+    entityName: string | null;
     /** Non-null when this report was shared from another graph */
     sourceGraphId: string | null;
     sourceReportId: string | null;
@@ -56,6 +58,26 @@ export interface ShareResult {
         factCount: number;
     }>;
 }
+export interface PublishList {
+    id: string;
+    name: string;
+    description: string | null;
+    memberCount: number;
+    createdBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PublishListDetail extends PublishList {
+    members: PublishListMember[];
+}
+export interface PublishListMember {
+    id: string;
+    targetGraphId: string;
+    targetGraphName: string | null;
+    targetOrgName: string | null;
+    addedBy: string;
+    addedAt: string;
+}
 export interface CreateReportOptions {
     name: string;
     mappingId: string;
@@ -100,10 +122,22 @@ export declare class ReportClient {
      */
     delete(graphId: string, reportId: string): Promise<void>;
     /**
-     * Share a published report to other graphs (snapshot copy).
+     * Share a published report to all members of a publish list (snapshot copy).
      */
-    share(graphId: string, reportId: string, targetGraphIds: string[]): Promise<ShareResult>;
+    share(graphId: string, reportId: string, publishListId: string): Promise<ShareResult>;
     /** Check if a report was received via sharing (vs locally created). */
     isSharedReport(report: Report): boolean;
+    listPublishLists(graphId: string): Promise<PublishList[]>;
+    createPublishList(graphId: string, name: string, description?: string): Promise<PublishList>;
+    getPublishList(graphId: string, listId: string): Promise<PublishListDetail>;
+    updatePublishList(graphId: string, listId: string, updates: {
+        name?: string;
+        description?: string;
+    }): Promise<PublishList>;
+    deletePublishList(graphId: string, listId: string): Promise<void>;
+    addMembers(graphId: string, listId: string, targetGraphIds: string[]): Promise<PublishListMember[]>;
+    removeMember(graphId: string, listId: string, memberId: string): Promise<void>;
+    private _toPublishList;
+    private _toMember;
     private _toReport;
 }

package/extensions/ReportClient.js

@@ -129,12 +129,12 @@ class ReportClient {
         }
     }
     /**
-     * Share a published report to other graphs (snapshot copy).
+     * Share a published report to all members of a publish list (snapshot copy).
      */
-    async share(graphId, reportId, targetGraphIds) {
+    async share(graphId, reportId, publishListId) {
         const response = await (0, sdk_gen_1.shareReport)({
             path: { graph_id: graphId, report_id: reportId },
-            body: { target_graph_ids: targetGraphIds },
+            body: { publish_list_id: publishListId },
         });
         if (response.error) {
             throw new Error(`Share report failed: ${JSON.stringify(response.error)}`);
@@ -154,6 +154,97 @@ class ReportClient {
     isSharedReport(report) {
         return report.sourceGraphId !== null;
     }
+    // ── Publish Lists ────────────────────────────────────────────────────
+    async listPublishLists(graphId) {
+        const response = await (0, sdk_gen_1.listPublishLists)({
+            path: { graph_id: graphId },
+        });
+        if (response.error) {
+            throw new Error(`List publish lists failed: ${JSON.stringify(response.error)}`);
+        }
+        const data = response.data;
+        return (data.publish_lists ?? []).map((pl) => this._toPublishList(pl));
+    }
+    async createPublishList(graphId, name, description) {
+        const response = await (0, sdk_gen_1.createPublishList)({
+            path: { graph_id: graphId },
+            body: { name, description: description ?? null },
+        });
+        if (response.error) {
+            throw new Error(`Create publish list failed: ${JSON.stringify(response.error)}`);
+        }
+        return this._toPublishList(response.data);
+    }
+    async getPublishList(graphId, listId) {
+        const response = await (0, sdk_gen_1.getPublishList)({
+            path: { graph_id: graphId, list_id: listId },
+        });
+        if (response.error) {
+            throw new Error(`Get publish list failed: ${JSON.stringify(response.error)}`);
+        }
+        const data = response.data;
+        return {
+            ...this._toPublishList(data),
+            members: (data.members ?? []).map((m) => this._toMember(m)),
+        };
+    }
+    async updatePublishList(graphId, listId, updates) {
+        const response = await (0, sdk_gen_1.updatePublishList)({
+            path: { graph_id: graphId, list_id: listId },
+            body: updates,
+        });
+        if (response.error) {
+            throw new Error(`Update publish list failed: ${JSON.stringify(response.error)}`);
+        }
+        return this._toPublishList(response.data);
+    }
+    async deletePublishList(graphId, listId) {
+        const response = await (0, sdk_gen_1.deletePublishList)({
+            path: { graph_id: graphId, list_id: listId },
+        });
+        if (response.error) {
+            throw new Error(`Delete publish list failed: ${JSON.stringify(response.error)}`);
+        }
+    }
+    async addMembers(graphId, listId, targetGraphIds) {
+        const response = await (0, sdk_gen_1.addPublishListMembers)({
+            path: { graph_id: graphId, list_id: listId },
+            body: { target_graph_ids: targetGraphIds },
+        });
+        if (response.error) {
+            throw new Error(`Add members failed: ${JSON.stringify(response.error)}`);
+        }
+        return (response.data ?? []).map((m) => this._toMember(m));
+    }
+    async removeMember(graphId, listId, memberId) {
+        const response = await (0, sdk_gen_1.removePublishListMember)({
+            path: { graph_id: graphId, list_id: listId, member_id: memberId },
+        });
+        if (response.error) {
+            throw new Error(`Remove member failed: ${JSON.stringify(response.error)}`);
+        }
+    }
+    _toPublishList(pl) {
+        return {
+            id: pl.id,
+            name: pl.name,
+            description: pl.description ?? null,
+            memberCount: pl.member_count ?? 0,
+            createdBy: pl.created_by,
+            createdAt: pl.created_at,
+            updatedAt: pl.updated_at,
+        };
+    }
+    _toMember(m) {
+        return {
+            id: m.id,
+            targetGraphId: m.target_graph_id,
+            targetGraphName: m.target_graph_name ?? null,
+            targetOrgName: m.target_org_name ?? null,
+            addedBy: m.added_by,
+            addedAt: m.added_at,
+        };
+    }
     _toReport(r) {
         return {
             id: r.id,
@@ -173,6 +264,7 @@ class ReportClient {
                 name: s.name,
                 structureType: s.structure_type,
             })),
+            entityName: r.entity_name ?? null,
             sourceGraphId: r.source_graph_id ?? null,
             sourceReportId: r.source_report_id ?? null,
             sharedAt: r.shared_at ?? null,

package/extensions/ReportClient.ts

@@ -9,17 +9,28 @@
  */
 
 import {
+  addPublishListMembers,
+  createPublishList,
   createReport,
+  deletePublishList,
   deleteReport,
+  getPublishList,
   getReport,
   getStatement,
+  listPublishLists,
   listReports,
   regenerateReport,
+  removePublishListMember,
   shareReport,
+  updatePublishList,
 } from '../sdk.gen'
 import type {
   CreateReportRequest,
   FactRowResponse,
+  PublishListDetailResponse,
+  PublishListListResponse,
+  PublishListMemberResponse,
+  PublishListResponse,
   RegenerateReportRequest,
   ReportListResponse,
   ReportResponse,
@@ -45,6 +56,8 @@ export interface Report {
   createdAt: string
   lastGenerated: string | null
   structures: Structure[]
+  /** Entity name (source company for shared reports, own entity for native) */
+  entityName: string | null
   /** Non-null when this report was shared from another graph */
   sourceGraphId: string | null
   sourceReportId: string | null
@@ -95,6 +108,29 @@ export interface ShareResult {
   }>
 }
 
+export interface PublishList {
+  id: string
+  name: string
+  description: string | null
+  memberCount: number
+  createdBy: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface PublishListDetail extends PublishList {
+  members: PublishListMember[]
+}
+
+export interface PublishListMember {
+  id: string
+  targetGraphId: string
+  targetGraphName: string | null
+  targetOrgName: string | null
+  addedBy: string
+  addedAt: string
+}
+
 export interface CreateReportOptions {
   name: string
   mappingId: string
@@ -264,12 +300,12 @@ export class ReportClient {
   }
 
   /**
-   * Share a published report to other graphs (snapshot copy).
+   * Share a published report to all members of a publish list (snapshot copy).
    */
-  async share(graphId: string, reportId: string, targetGraphIds: string[]): Promise<ShareResult> {
+  async share(graphId: string, reportId: string, publishListId: string): Promise<ShareResult> {
     const response = await shareReport({
       path: { graph_id: graphId, report_id: reportId },
-      body: { target_graph_ids: targetGraphIds },
+      body: { publish_list_id: publishListId },
     })
 
     if (response.error) {
@@ -293,6 +329,119 @@ export class ReportClient {
     return report.sourceGraphId !== null
   }
 
+  // ── Publish Lists ────────────────────────────────────────────────────
+
+  async listPublishLists(graphId: string): Promise<PublishList[]> {
+    const response = await listPublishLists({
+      path: { graph_id: graphId },
+    })
+    if (response.error) {
+      throw new Error(`List publish lists failed: ${JSON.stringify(response.error)}`)
+    }
+    const data = response.data as PublishListListResponse
+    return (data.publish_lists ?? []).map((pl) => this._toPublishList(pl))
+  }
+
+  async createPublishList(
+    graphId: string,
+    name: string,
+    description?: string
+  ): Promise<PublishList> {
+    const response = await createPublishList({
+      path: { graph_id: graphId },
+      body: { name, description: description ?? null },
+    })
+    if (response.error) {
+      throw new Error(`Create publish list failed: ${JSON.stringify(response.error)}`)
+    }
+    return this._toPublishList(response.data as PublishListResponse)
+  }
+
+  async getPublishList(graphId: string, listId: string): Promise<PublishListDetail> {
+    const response = await getPublishList({
+      path: { graph_id: graphId, list_id: listId },
+    })
+    if (response.error) {
+      throw new Error(`Get publish list failed: ${JSON.stringify(response.error)}`)
+    }
+    const data = response.data as PublishListDetailResponse
+    return {
+      ...this._toPublishList(data),
+      members: (data.members ?? []).map((m) => this._toMember(m)),
+    }
+  }
+
+  async updatePublishList(
+    graphId: string,
+    listId: string,
+    updates: { name?: string; description?: string }
+  ): Promise<PublishList> {
+    const response = await updatePublishList({
+      path: { graph_id: graphId, list_id: listId },
+      body: updates,
+    })
+    if (response.error) {
+      throw new Error(`Update publish list failed: ${JSON.stringify(response.error)}`)
+    }
+    return this._toPublishList(response.data as PublishListResponse)
+  }
+
+  async deletePublishList(graphId: string, listId: string): Promise<void> {
+    const response = await deletePublishList({
+      path: { graph_id: graphId, list_id: listId },
+    })
+    if (response.error) {
+      throw new Error(`Delete publish list failed: ${JSON.stringify(response.error)}`)
+    }
+  }
+
+  async addMembers(
+    graphId: string,
+    listId: string,
+    targetGraphIds: string[]
+  ): Promise<PublishListMember[]> {
+    const response = await addPublishListMembers({
+      path: { graph_id: graphId, list_id: listId },
+      body: { target_graph_ids: targetGraphIds },
+    })
+    if (response.error) {
+      throw new Error(`Add members failed: ${JSON.stringify(response.error)}`)
+    }
+    return ((response.data as PublishListMemberResponse[]) ?? []).map((m) => this._toMember(m))
+  }
+
+  async removeMember(graphId: string, listId: string, memberId: string): Promise<void> {
+    const response = await removePublishListMember({
+      path: { graph_id: graphId, list_id: listId, member_id: memberId },
+    })
+    if (response.error) {
+      throw new Error(`Remove member failed: ${JSON.stringify(response.error)}`)
+    }
+  }
+
+  private _toPublishList(pl: PublishListResponse): PublishList {
+    return {
+      id: pl.id,
+      name: pl.name,
+      description: pl.description ?? null,
+      memberCount: pl.member_count ?? 0,
+      createdBy: pl.created_by,
+      createdAt: pl.created_at,
+      updatedAt: pl.updated_at,
+    }
+  }
+
+  private _toMember(m: PublishListMemberResponse): PublishListMember {
+    return {
+      id: m.id,
+      targetGraphId: m.target_graph_id,
+      targetGraphName: m.target_graph_name ?? null,
+      targetOrgName: m.target_org_name ?? null,
+      addedBy: m.added_by,
+      addedAt: m.added_at,
+    }
+  }
+
   private _toReport(r: ReportResponse): Report {
     return {
       id: r.id,
@@ -312,6 +461,7 @@ export class ReportClient {
         name: s.name,
         structureType: s.structure_type,
       })),
+      entityName: r.entity_name ?? null,
       sourceGraphId: r.source_graph_id ?? null,
       sourceReportId: r.source_report_id ?? null,
       sharedAt: r.shared_at ?? null,