@heymantle/core-api-client 0.1.15 → 0.1.17

package/dist/index.js

@@ -1912,6 +1912,32 @@ var DocsResource = class extends BaseResource {
   async getTree() {
     return this.get("/docs/tree");
   }
+  // ========== Repositories ==========
+  /**
+   * List all doc repositories
+   */
+  async listRepositories(params) {
+    const response = await this.get(
+      "/docs/repositories",
+      params
+    );
+    return {
+      repositories: response.repositories || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Retrieve a single doc repository
+   */
+  async retrieveRepository(repositoryId, params) {
+    return this.get(
+      `/docs/repositories/${repositoryId}`,
+      params
+    );
+  }
 };
 
 // src/resources/entities.ts
@@ -1923,7 +1949,11 @@ var EntitiesResource = class extends BaseResource {
   async search(params) {
     const response = await this.get("/entities", params);
     return {
-      entities: response.entities || []
+      entities: response.entities || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
     };
   }
 };
@@ -2097,6 +2127,237 @@ var ListsResource = class extends BaseResource {
   }
 };
 
+// src/resources/journal-entries.ts
+var JournalEntriesResource = class extends BaseResource {
+  /**
+   * List journal entries with optional filters and pagination
+   */
+  async list(params) {
+    const response = await this.get(
+      "/journal_entries",
+      params
+    );
+    return {
+      journalEntries: response.journalEntries || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Retrieve a single journal entry by ID
+   */
+  async retrieve(entryId) {
+    return this.get(
+      `/journal_entries/${entryId}`
+    );
+  }
+  /**
+   * Create a new journal entry
+   */
+  async create(data) {
+    return this.post("/journal_entries", data);
+  }
+  /**
+   * Update an existing journal entry
+   */
+  async update(entryId, data) {
+    return this.put(
+      `/journal_entries/${entryId}`,
+      data
+    );
+  }
+  /**
+   * Delete a journal entry
+   */
+  async del(entryId) {
+    return this._delete(`/journal_entries/${entryId}`);
+  }
+};
+
+// src/resources/email-unsubscribe-groups.ts
+var EmailUnsubscribeGroupsResource = class extends BaseResource {
+  /**
+   * List all email unsubscribe groups
+   */
+  async list(params) {
+    const response = await this.get(
+      "/email/unsubscribe_groups",
+      params
+    );
+    return {
+      unsubscribeGroups: response.unsubscribeGroups || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Retrieve a single unsubscribe group
+   */
+  async retrieve(groupId) {
+    return this.get(
+      `/email/unsubscribe_groups/${groupId}`
+    );
+  }
+  // ========== Members ==========
+  /**
+   * List members of an unsubscribe group
+   */
+  async listMembers(groupId, params) {
+    const response = await this.get(
+      `/email/unsubscribe_groups/${groupId}/members`,
+      params
+    );
+    return {
+      members: response.members || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Add members to an unsubscribe group by email addresses
+   */
+  async addMembers(groupId, data) {
+    return this.post(
+      `/email/unsubscribe_groups/${groupId}/members`,
+      data
+    );
+  }
+  /**
+   * Remove members from an unsubscribe group by email addresses
+   */
+  async removeMembers(groupId, data) {
+    return this._delete(
+      `/email/unsubscribe_groups/${groupId}/members?emails=${encodeURIComponent(data.emails.join(","))}`
+    );
+  }
+  /**
+   * Remove a single member from an unsubscribe group by member ID
+   */
+  async removeMember(groupId, memberId) {
+    return this._delete(
+      `/email/unsubscribe_groups/${groupId}/members/${memberId}`
+    );
+  }
+};
+
+// src/resources/flow-extensions.ts
+var FlowExtensionsResource = class extends BaseResource {
+  // ========== Actions ==========
+  /**
+   * List flow extension actions
+   */
+  async listActions(params) {
+    const response = await this.get(
+      "/flow/extensions/actions",
+      params
+    );
+    return {
+      actions: response.actions || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Retrieve a single flow extension action
+   */
+  async retrieveAction(actionId) {
+    return this.get(
+      `/flow/extensions/actions/${actionId}`
+    );
+  }
+  /**
+   * Create a new flow extension action
+   */
+  async createAction(data) {
+    return this.post(
+      "/flow/extensions/actions",
+      data
+    );
+  }
+  /**
+   * Update an existing flow extension action
+   */
+  async updateAction(actionId, data) {
+    return this.put(
+      `/flow/extensions/actions/${actionId}`,
+      data
+    );
+  }
+  /**
+   * Delete a flow extension action
+   */
+  async deleteAction(actionId) {
+    return this._delete(
+      `/flow/extensions/actions/${actionId}`
+    );
+  }
+  // ========== Action Runs ==========
+  /**
+   * Update a flow action run status
+   * Used to report completion or failure of async action execution
+   */
+  async updateActionRun(runId, data) {
+    return this.put(`/flow/actions/runs/${runId}`, data);
+  }
+};
+
+// src/resources/ai-agent-runs.ts
+var AIAgentRunsResource = class extends BaseResource {
+  /**
+   * Create a new AI agent run
+   * Returns 202 Accepted as the run executes asynchronously
+   * Poll the retrieve endpoint to check for completion
+   */
+  async create(agentId, data) {
+    return this.post(
+      `/ai/agents/${agentId}/runs`,
+      data || {}
+    );
+  }
+  /**
+   * Retrieve the status and results of an AI agent run
+   * Use this to poll for completion after creating a run
+   */
+  async retrieve(agentId, runId) {
+    return this.get(
+      `/ai/agents/${agentId}/runs/${runId}`
+    );
+  }
+  /**
+   * Create a run and poll until completion
+   * Convenience method that handles the async polling pattern
+   *
+   * @param agentId - The ID of the AI agent
+   * @param data - Optional parameters for the run
+   * @param options - Polling options
+   * @returns The completed agent run
+   */
+  async createAndWait(agentId, data, options) {
+    const timeout = options?.timeout ?? 6e4;
+    const pollInterval = options?.pollInterval ?? 1e3;
+    const startTime = Date.now();
+    const { run } = await this.create(agentId, data);
+    while (Date.now() - startTime < timeout) {
+      const { run: currentRun } = await this.retrieve(agentId, run.id);
+      if (currentRun.status === "completed" || currentRun.status === "error") {
+        return currentRun;
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollInterval));
+    }
+    throw new Error(
+      `Agent run ${run.id} did not complete within ${timeout}ms timeout`
+    );
+  }
+};
+
 // src/client.ts
 var MantleCoreClient = class {
   constructor(config) {
@@ -2151,6 +2412,10 @@ var MantleCoreClient = class {
     this.customData = new CustomDataResource(this);
     this.timelineComments = new TimelineCommentsResource(this);
     this.lists = new ListsResource(this);
+    this.journalEntries = new JournalEntriesResource(this);
+    this.emailUnsubscribeGroups = new EmailUnsubscribeGroupsResource(this);
+    this.flowExtensions = new FlowExtensionsResource(this);
+    this.aiAgentRuns = new AIAgentRunsResource(this);
   }
   /**
    * Register a middleware function

package/dist/index.mjs

@@ -1846,6 +1846,32 @@ var DocsResource = class extends BaseResource {
   async getTree() {
     return this.get("/docs/tree");
   }
+  // ========== Repositories ==========
+  /**
+   * List all doc repositories
+   */
+  async listRepositories(params) {
+    const response = await this.get(
+      "/docs/repositories",
+      params
+    );
+    return {
+      repositories: response.repositories || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Retrieve a single doc repository
+   */
+  async retrieveRepository(repositoryId, params) {
+    return this.get(
+      `/docs/repositories/${repositoryId}`,
+      params
+    );
+  }
 };
 
 // src/resources/entities.ts
@@ -1857,7 +1883,11 @@ var EntitiesResource = class extends BaseResource {
   async search(params) {
     const response = await this.get("/entities", params);
     return {
-      entities: response.entities || []
+      entities: response.entities || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
     };
   }
 };
@@ -2031,6 +2061,237 @@ var ListsResource = class extends BaseResource {
   }
 };
 
+// src/resources/journal-entries.ts
+var JournalEntriesResource = class extends BaseResource {
+  /**
+   * List journal entries with optional filters and pagination
+   */
+  async list(params) {
+    const response = await this.get(
+      "/journal_entries",
+      params
+    );
+    return {
+      journalEntries: response.journalEntries || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Retrieve a single journal entry by ID
+   */
+  async retrieve(entryId) {
+    return this.get(
+      `/journal_entries/${entryId}`
+    );
+  }
+  /**
+   * Create a new journal entry
+   */
+  async create(data) {
+    return this.post("/journal_entries", data);
+  }
+  /**
+   * Update an existing journal entry
+   */
+  async update(entryId, data) {
+    return this.put(
+      `/journal_entries/${entryId}`,
+      data
+    );
+  }
+  /**
+   * Delete a journal entry
+   */
+  async del(entryId) {
+    return this._delete(`/journal_entries/${entryId}`);
+  }
+};
+
+// src/resources/email-unsubscribe-groups.ts
+var EmailUnsubscribeGroupsResource = class extends BaseResource {
+  /**
+   * List all email unsubscribe groups
+   */
+  async list(params) {
+    const response = await this.get(
+      "/email/unsubscribe_groups",
+      params
+    );
+    return {
+      unsubscribeGroups: response.unsubscribeGroups || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Retrieve a single unsubscribe group
+   */
+  async retrieve(groupId) {
+    return this.get(
+      `/email/unsubscribe_groups/${groupId}`
+    );
+  }
+  // ========== Members ==========
+  /**
+   * List members of an unsubscribe group
+   */
+  async listMembers(groupId, params) {
+    const response = await this.get(
+      `/email/unsubscribe_groups/${groupId}/members`,
+      params
+    );
+    return {
+      members: response.members || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Add members to an unsubscribe group by email addresses
+   */
+  async addMembers(groupId, data) {
+    return this.post(
+      `/email/unsubscribe_groups/${groupId}/members`,
+      data
+    );
+  }
+  /**
+   * Remove members from an unsubscribe group by email addresses
+   */
+  async removeMembers(groupId, data) {
+    return this._delete(
+      `/email/unsubscribe_groups/${groupId}/members?emails=${encodeURIComponent(data.emails.join(","))}`
+    );
+  }
+  /**
+   * Remove a single member from an unsubscribe group by member ID
+   */
+  async removeMember(groupId, memberId) {
+    return this._delete(
+      `/email/unsubscribe_groups/${groupId}/members/${memberId}`
+    );
+  }
+};
+
+// src/resources/flow-extensions.ts
+var FlowExtensionsResource = class extends BaseResource {
+  // ========== Actions ==========
+  /**
+   * List flow extension actions
+   */
+  async listActions(params) {
+    const response = await this.get(
+      "/flow/extensions/actions",
+      params
+    );
+    return {
+      actions: response.actions || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Retrieve a single flow extension action
+   */
+  async retrieveAction(actionId) {
+    return this.get(
+      `/flow/extensions/actions/${actionId}`
+    );
+  }
+  /**
+   * Create a new flow extension action
+   */
+  async createAction(data) {
+    return this.post(
+      "/flow/extensions/actions",
+      data
+    );
+  }
+  /**
+   * Update an existing flow extension action
+   */
+  async updateAction(actionId, data) {
+    return this.put(
+      `/flow/extensions/actions/${actionId}`,
+      data
+    );
+  }
+  /**
+   * Delete a flow extension action
+   */
+  async deleteAction(actionId) {
+    return this._delete(
+      `/flow/extensions/actions/${actionId}`
+    );
+  }
+  // ========== Action Runs ==========
+  /**
+   * Update a flow action run status
+   * Used to report completion or failure of async action execution
+   */
+  async updateActionRun(runId, data) {
+    return this.put(`/flow/actions/runs/${runId}`, data);
+  }
+};
+
+// src/resources/ai-agent-runs.ts
+var AIAgentRunsResource = class extends BaseResource {
+  /**
+   * Create a new AI agent run
+   * Returns 202 Accepted as the run executes asynchronously
+   * Poll the retrieve endpoint to check for completion
+   */
+  async create(agentId, data) {
+    return this.post(
+      `/ai/agents/${agentId}/runs`,
+      data || {}
+    );
+  }
+  /**
+   * Retrieve the status and results of an AI agent run
+   * Use this to poll for completion after creating a run
+   */
+  async retrieve(agentId, runId) {
+    return this.get(
+      `/ai/agents/${agentId}/runs/${runId}`
+    );
+  }
+  /**
+   * Create a run and poll until completion
+   * Convenience method that handles the async polling pattern
+   *
+   * @param agentId - The ID of the AI agent
+   * @param data - Optional parameters for the run
+   * @param options - Polling options
+   * @returns The completed agent run
+   */
+  async createAndWait(agentId, data, options) {
+    const timeout = options?.timeout ?? 6e4;
+    const pollInterval = options?.pollInterval ?? 1e3;
+    const startTime = Date.now();
+    const { run } = await this.create(agentId, data);
+    while (Date.now() - startTime < timeout) {
+      const { run: currentRun } = await this.retrieve(agentId, run.id);
+      if (currentRun.status === "completed" || currentRun.status === "error") {
+        return currentRun;
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollInterval));
+    }
+    throw new Error(
+      `Agent run ${run.id} did not complete within ${timeout}ms timeout`
+    );
+  }
+};
+
 // src/client.ts
 var MantleCoreClient = class {
   constructor(config) {
@@ -2085,6 +2346,10 @@ var MantleCoreClient = class {
     this.customData = new CustomDataResource(this);
     this.timelineComments = new TimelineCommentsResource(this);
     this.lists = new ListsResource(this);
+    this.journalEntries = new JournalEntriesResource(this);
+    this.emailUnsubscribeGroups = new EmailUnsubscribeGroupsResource(this);
+    this.flowExtensions = new FlowExtensionsResource(this);
+    this.aiAgentRuns = new AIAgentRunsResource(this);
   }
   /**
    * Register a middleware function

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heymantle/core-api-client",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "TypeScript SDK for the Mantle Core API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",