memorysync-sdk 1.3.0 → 1.5.0

package/dist/index.js

@@ -90,6 +90,9 @@ var V1 = "/api/v1/integrations";
 function seg(value) {
   return encodeURIComponent(String(value));
 }
+function asItem(value, key) {
+  return typeof value === "string" ? { [key]: value } : value;
+}
 var Namespace = class {
   constructor(request) {
     this.req = request;
@@ -109,10 +112,22 @@ var SlackNamespace = class extends Namespace {
   channels(connectionId) {
     return this.req("GET", `${V2}/connections/${seg(connectionId)}/slack/channels`);
   }
-  /** Select channels for syncing. */
-  addChannels(connectionId, channelIds) {
+  /**
+   * Select channels for syncing.
+   *
+   * Accepts bare channel ids, which is the common case, or objects carrying the
+   * name and type across so the server does not have to look them up again:
+   *
+   * ```ts
+   * await client.connections.slack.addChannels("c1", ["C0123", "C0456"]);
+   * await client.connections.slack.addChannels("c1", [
+   *   { id: "C0123", name: "support", is_private: false },
+   * ]);
+   * ```
+   */
+  addChannels(connectionId, channels) {
     return this.req("POST", `${V2}/connections/${seg(connectionId)}/slack/channels`, {
-      body: { channel_ids: channelIds }
+      body: { channels: channels.map((c) => asItem(c, "id")) }
     });
   }
   /** Stop syncing one channel. */
@@ -179,22 +194,42 @@ var S3Namespace = class extends Namespace {
   prefixes(connectionId) {
     return this.req("GET", `${V2}/connections/${seg(connectionId)}/s3/prefixes`);
   }
-  /** Select prefixes for syncing. */
+  /**
+   * Select prefixes for syncing.
+   *
+   * Accepts bare prefixes, or objects carrying `bucket` and `label`:
+   *
+   * ```ts
+   * await client.connections.s3.addPrefixes("c1", ["handbook/", "policies/"]);
+   * await client.connections.s3.addPrefixes("c1", [
+   *   { prefix: "handbook/", label: "Handbook" },
+   * ]);
+   * ```
+   *
+   * An empty string means the bucket root. The bucket defaults to the one the
+   * connection's credentials were validated against, and the API rejects any
+   * other bucket rather than indexing one nobody proved access to.
+   */
   addPrefixes(connectionId, prefixes) {
     return this.req("POST", `${V2}/connections/${seg(connectionId)}/s3/prefixes`, {
-      body: { prefixes }
+      body: { prefixes: prefixes.map((p) => asItem(p, "prefix")) }
     });
   }
   /**
-   * Stop syncing the given prefixes.
+   * Revoke one prefix approval, optionally purging what it produced.
+   *
+   * The prefix travels as a query parameter, not in the body and not as a path
+   * segment: prefixes contain slashes, which a path segment cannot carry
+   * unambiguously, and this endpoint reads no body at all.
    *
-   * The prefixes travel in the body rather than the path because they contain
-   * slashes, which is why this DELETE carries one.
+   * Pass `purge: true` to also delete the memories already derived from the
+   * prefix. The default leaves them in place, so revoking an approval does not
+   * silently destroy knowledge.
    */
-  removePrefixes(connectionId, prefixes) {
-    return this.req("DELETE", `${V2}/connections/${seg(connectionId)}/s3/prefixes`, {
-      body: { prefixes }
-    });
+  removePrefix(connectionId, prefix = "", options = {}) {
+    const query = { prefix, purge: options.purge ?? false };
+    if (options.bucket !== void 0) query.bucket = options.bucket;
+    return this.req("DELETE", `${V2}/connections/${seg(connectionId)}/s3/prefixes`, { query });
   }
   /** Keys and patterns this connection will never sync. */
   exclusionPolicy(connectionId) {
@@ -249,9 +284,18 @@ var GranolaNamespace = class extends Namespace {
   linkIdentity(connectionId, body) {
     return this.req("POST", `${V2}/connections/${seg(connectionId)}/granola/identities/link`, { body });
   }
-  /** Move an existing mapping to a different end user. */
-  relinkIdentity(connectionId, body) {
-    return this.req("POST", `${V2}/connections/${seg(connectionId)}/granola/identities/relink`, { body });
+  /**
+   * Re-run identity matching for this connection.
+   *
+   * Takes no arguments: the route reads no body and re-matches the whole roster.
+   * `body` is kept optional only so a forward-compatible field can be passed
+   * once the route grows one.
+   */
+  relinkIdentity(connectionId, body = {}) {
+    const hasFields = Object.keys(body).length > 0;
+    return this.req("POST", `${V2}/connections/${seg(connectionId)}/granola/identities/relink`, {
+      body: hasFields ? body : void 0
+    });
   }
   /** Effective Granola settings for this connection. */
   settings(connectionId) {
@@ -272,7 +316,9 @@ var ConnectionOAuthNamespace = class extends Namespace {
    * back — not your backend. Poll {@link status} to find out how it went.
    */
   initiate(provider, body = {}) {
-    return this.req("POST", `${V2}/oauth/initiate`, { body: { provider, ...body } });
+    return this.req("POST", `${V2}/oauth/initiate`, {
+      body: { provider_id: provider, ...body }
+    });
   }
   /** Where an in-flight OAuth connection got to. */
   status(query) {
@@ -297,15 +343,21 @@ var ConnectionsNamespace = class extends Namespace {
     return this.req("GET", `${V2}/connections/${seg(connectionId)}`);
   }
   /** Connect a provider that authenticates with an API key or bot token. */
+  /**
+   * Connect a provider that authenticates with an API key or bot token.
+   *
+   * The wire field is `provider_id`; the argument is named `provider` because
+   * that is what the rest of this namespace calls it.
+   */
   createWithApiKey(provider, apiKey, body = {}) {
     return this.req("POST", `${V2}/connections/api-key`, {
-      body: { provider, api_key: apiKey, ...body }
+      body: { provider_id: provider, api_key: apiKey, ...body }
     });
   }
   /** Connect a provider that needs a credential bundle, such as S3 keys. */
   createWithCredentials(provider, credentials, body = {}) {
     return this.req("POST", `${V2}/connections/credentials`, {
-      body: { provider, credentials, ...body }
+      body: { provider_id: provider, credentials, ...body }
     });
   }
   /** Change a connection's name, schedule or settings. */
@@ -524,7 +576,7 @@ var IntegrationsNamespace = class extends Namespace {
 };
 
 // src/control-plane.ts
-var SDK_VERSION = "1.1.1";
+var SDK_VERSION = "1.5.0";
 function safeJson(text) {
   try {
     return JSON.parse(text);
@@ -601,17 +653,51 @@ function boundedInteger(value, name, minimum, maximum) {
     throw new ValidationError(`${name} must be an integer between ${minimum} and ${maximum}`);
   }
 }
-function nonNegativeInteger(value, name) {
-  if (!Number.isInteger(value) || value < 0) {
-    throw new ValidationError(`${name} must be a non-negative integer`);
-  }
-}
 function nonEmptyStrings(values, name) {
   if (!Array.isArray(values) || values.length === 0 || values.some((value) => typeof value !== "string" || !value.trim())) {
     throw new ValidationError(`${name} must contain at least one non-empty string`);
   }
 }
+function projectName(value) {
+  nonEmpty(value, "name");
+  if (value.length > 200) throw new ValidationError("name may contain at most 200 characters");
+}
+function pathId(value, name, minimum = 1, maximum) {
+  nonEmpty(value, name);
+  const trimmed = value.trim();
+  if (trimmed.length < minimum || maximum !== void 0 && trimmed.length > maximum) {
+    const range = maximum === void 0 ? `at least ${minimum}` : `between ${minimum} and ${maximum}`;
+    throw new ValidationError(`${name} must contain ${range} characters`);
+  }
+  return encodeURIComponent(trimmed);
+}
+function validateWebhookRetryConfig(config) {
+  if (config.maxRetries !== void 0) boundedInteger(config.maxRetries, "maxRetries", 1, 10);
+  if (config.initialDelaySeconds !== void 0) boundedInteger(config.initialDelaySeconds, "initialDelaySeconds", 1, 60);
+  if (config.maxDelaySeconds !== void 0) boundedInteger(config.maxDelaySeconds, "maxDelaySeconds", 60, 86400);
+  if (config.backoffMultiplier !== void 0 && (!Number.isFinite(config.backoffMultiplier) || config.backoffMultiplier < 1 || config.backoffMultiplier > 5)) {
+    throw new ValidationError("backoffMultiplier must be between 1 and 5");
+  }
+  if (config.retryStatusCodes !== void 0 && (!Array.isArray(config.retryStatusCodes) || config.retryStatusCodes.length === 0 || config.retryStatusCodes.some((value) => typeof value !== "string" || value.trim().length === 0))) {
+    throw new ValidationError("retryStatusCodes must contain at least one non-empty string");
+  }
+}
+function validateWebhookSignatureConfig(config) {
+  if (config.algorithm !== void 0 && config.algorithm !== "hmac-sha256" && config.algorithm !== "hmac-sha512") {
+    throw new ValidationError("algorithm must be 'hmac-sha256' or 'hmac-sha512'");
+  }
+  for (const [name, value] of [["headerName", config.headerName], ["timestampHeader", config.timestampHeader]]) {
+    if (value !== void 0 && value.trim().length === 0) {
+      throw new ValidationError(`${name} must be a non-empty string`);
+    }
+    if (value !== void 0 && value.length > 64) {
+      throw new ValidationError(`${name} may contain at most 64 characters`);
+    }
+  }
+  if (config.toleranceSeconds !== void 0) boundedInteger(config.toleranceSeconds, "toleranceSeconds", 60, 3600);
+}
 function webhookRetryConfig(config) {
+  validateWebhookRetryConfig(config);
   const wire = {};
   if (config.enabled !== void 0) wire.enabled = config.enabled;
   if (config.maxRetries !== void 0) wire.max_retries = config.maxRetries;
@@ -622,6 +708,7 @@ function webhookRetryConfig(config) {
   return wire;
 }
 function webhookSignatureConfig(config) {
+  validateWebhookSignatureConfig(config);
   const wire = {};
   if (config.algorithm !== void 0) wire.algorithm = config.algorithm;
   if (config.headerName !== void 0) wire.header_name = config.headerName;
@@ -629,6 +716,19 @@ function webhookSignatureConfig(config) {
   if (config.toleranceSeconds !== void 0) wire.tolerance_seconds = config.toleranceSeconds;
   return wire;
 }
+function exportFilters(filters) {
+  const wire = {};
+  if (filters.q !== void 0) wire.q = filters.q;
+  if (filters.userId !== void 0) wire.user_id = filters.userId;
+  if (filters.isSummary !== void 0) wire.is_summary = filters.isSummary;
+  if (filters.tier !== void 0) wire.tier = filters.tier;
+  if (filters.source !== void 0) wire.source = filters.source;
+  if (filters.timeRange !== void 0) wire.time_range = filters.timeRange;
+  if (filters.dateFrom !== void 0) wire.date_from = filters.dateFrom;
+  if (filters.dateTo !== void 0) wire.date_to = filters.dateTo;
+  if (filters.includeSoftDeleted !== void 0) wire.include_soft_deleted = filters.includeSoftDeleted;
+  return wire;
+}
 function validateWebhook(name, url, events) {
   nonEmpty(name, "name");
   if (name.length > 128) throw new ValidationError("name may contain at most 128 characters");
@@ -768,20 +868,6 @@ var ControlPlaneClient = class {
   async getCurrentPlan(options = {}) {
     return this.request("GET", "/org/billing/current-plan", options);
   }
-  async listTeamMembers(options = {}) {
-    return this.request("GET", "/admin/team/members", options);
-  }
-  async suspendTeamMember(memberId, options = {}) {
-    positiveId(memberId, "memberId");
-    return this.request("PATCH", `/admin/team/members/${memberId}`, {
-      ...options,
-      body: { status: "suspended" }
-    });
-  }
-  async removeTeamMember(memberId, options = {}) {
-    positiveId(memberId, "memberId");
-    return this.request("DELETE", `/admin/team/members/${memberId}`, options);
-  }
   async listSessions(options = {}) {
     return this.request("GET", "/auth/sessions", options);
   }
@@ -789,43 +875,6 @@ var ControlPlaneClient = class {
     positiveId(sessionId, "sessionId");
     return this.request("POST", `/auth/sessions/${sessionId}/revoke`, options);
   }
-  async listAuditEvents(query = {}, options = {}) {
-    if (query.limit !== void 0) boundedInteger(query.limit, "limit", 1, 200);
-    if (query.cursor !== void 0) nonNegativeInteger(query.cursor, "cursor");
-    if (query.skip !== void 0) nonNegativeInteger(query.skip, "skip");
-    if (query.sortDirection !== void 0 && query.sortDirection !== "asc" && query.sortDirection !== "desc") {
-      throw new ValidationError("sortDirection must be 'asc' or 'desc'");
-    }
-    const path = "/admin/audit-logs" + queryString({
-      limit: query.limit,
-      cursor: query.cursor,
-      skip: query.skip,
-      sort: query.sortDirection,
-      tenant_id: query.tenantId,
-      actor: query.actor,
-      actor_email: query.actorEmail,
-      ip: query.ip,
-      action: query.action,
-      resource_type: query.resourceType,
-      resource_id: query.resourceId,
-      severity: query.severity,
-      category: query.category,
-      start: query.start,
-      end: query.end,
-      success: query.success,
-      source: query.source,
-      ingest_method: query.ingestMethod,
-      search: query.search,
-      include_stats: query.includeStats
-    });
-    const raw = await this.request("GET", path, options);
-    return {
-      events: raw.logs ?? [],
-      nextCursor: raw.nextCursor ?? null,
-      stats: raw.stats ?? null,
-      sort: raw.sort ?? query.sortDirection ?? "desc"
-    };
-  }
   async listIntegrations(query = {}, options = {}) {
     if (query.category !== void 0) nonEmpty(query.category, "category");
     const path = "/api/v1/integrations/catalog" + queryString({ category: query.category });
@@ -841,23 +890,36 @@ var ControlPlaneClient = class {
   async listOrganizations(options = {}) {
     return this.request("GET", "/organizations", options);
   }
-  async listOrganizationMembers(options = {}) {
-    return this.listTeamMembers(options);
-  }
-  async getOrganizationSettings(query = {}, options = {}) {
-    if (query.tenantId !== void 0) nonEmpty(query.tenantId, "tenantId");
-    const path = "/admin/tenant-settings" + queryString({ tenant_id: query.tenantId });
-    return this.request("GET", path, options);
-  }
   async listProjects(options = {}) {
     return this.request("GET", "/org/projects", options);
   }
+  async createProject(request, options = {}) {
+    projectName(request.name);
+    return this.request("POST", "/org/projects", { ...options, body: { name: request.name } });
+  }
+  async renameProject(projectId, request, options = {}) {
+    const encodedId = pathId(projectId, "projectId");
+    projectName(request.name);
+    return this.request("PATCH", `/org/projects/${encodedId}`, { ...options, body: { name: request.name } });
+  }
+  async archiveProject(projectId, options = {}) {
+    return this.request("POST", `/org/projects/${pathId(projectId, "projectId")}/archive`, options);
+  }
+  async unarchiveProject(projectId, options = {}) {
+    return this.request("POST", `/org/projects/${pathId(projectId, "projectId")}/unarchive`, options);
+  }
+  async deleteProject(projectId, options = {}) {
+    return this.request("DELETE", `/org/projects/${pathId(projectId, "projectId")}`, options);
+  }
   async createWebhook(request, options = {}) {
     validateWebhook(request.name, request.url, request.events);
     if (request.description !== void 0 && request.description.length > 500) {
       throw new ValidationError("description may contain at most 500 characters");
     }
-    if (request.projectId !== void 0) nonEmpty(request.projectId, "projectId");
+    if (request.projectId !== void 0) {
+      nonEmpty(request.projectId, "projectId");
+      if (request.projectId.length > 64) throw new ValidationError("projectId may contain at most 64 characters");
+    }
     if (options.projectId !== void 0) nonEmpty(options.projectId, "projectId override");
     if (request.projectId && options.projectId && request.projectId.trim() !== options.projectId.trim()) {
       throw new ValidationError("request projectId and options projectId must match");
@@ -876,6 +938,28 @@ var ControlPlaneClient = class {
   async listWebhooks(options = {}) {
     return this.request("GET", "/org/webhooks", options);
   }
+  async getWebhook(endpointId, options = {}) {
+    positiveId(endpointId, "endpointId");
+    return this.request("GET", `/org/webhooks/${endpointId}`, options);
+  }
+  async getWebhookEventTypes(options = {}) {
+    return this.request("GET", "/org/webhooks/event-types", options);
+  }
+  async getWebhookHealth(options = {}) {
+    return this.request("GET", "/org/webhooks/health", options);
+  }
+  async pauseWebhook(endpointId, options = {}) {
+    positiveId(endpointId, "endpointId");
+    return this.request("POST", `/org/webhooks/${endpointId}/pause`, options);
+  }
+  async resumeWebhook(endpointId, options = {}) {
+    positiveId(endpointId, "endpointId");
+    return this.request("POST", `/org/webhooks/${endpointId}/resume`, options);
+  }
+  async rotateWebhookSecret(endpointId, options = {}) {
+    positiveId(endpointId, "endpointId");
+    return this.request("POST", `/org/webhooks/${endpointId}/rotate-secret`, options);
+  }
   async updateWebhook(endpointId, request, options = {}) {
     positiveId(endpointId, "endpointId");
     const body = {};
@@ -936,9 +1020,7 @@ var ControlPlaneClient = class {
   async listWebhookDeliveries(endpointId, query = {}, options = {}) {
     positiveId(endpointId, "endpointId");
     if (query.page !== void 0) positiveId(query.page, "page");
-    if (query.pageSize !== void 0 && (!Number.isInteger(query.pageSize) || query.pageSize < 1 || query.pageSize > 100)) {
-      throw new ValidationError("pageSize must be an integer between 1 and 100");
-    }
+    if (query.pageSize !== void 0) boundedInteger(query.pageSize, "pageSize", 1, 100);
     if (query.status !== void 0) nonEmpty(query.status, "status");
     const path = `/org/webhooks/${endpointId}/deliveries` + queryString({
       page: query.page,
@@ -947,10 +1029,62 @@ var ControlPlaneClient = class {
     });
     return this.request("GET", path, options);
   }
+  async getLatestWebhookDelivery(endpointId, options = {}) {
+    positiveId(endpointId, "endpointId");
+    return this.request("GET", `/org/webhooks/${endpointId}/deliveries/latest`, options);
+  }
+  async listRecentWebhookDeliveries(query = {}, options = {}) {
+    if (query.page !== void 0) positiveId(query.page, "page");
+    if (query.pageSize !== void 0) boundedInteger(query.pageSize, "pageSize", 1, 100);
+    if (query.endpointId !== void 0) positiveId(query.endpointId, "endpointId");
+    if (query.status !== void 0) nonEmpty(query.status, "status");
+    const path = "/org/webhooks/deliveries/recent" + queryString({
+      page: query.page,
+      page_size: query.pageSize,
+      endpoint_id: query.endpointId,
+      status_filter: query.status
+    });
+    return this.request("GET", path, options);
+  }
+  async getWebhookDelivery(deliveryId, options = {}) {
+    positiveId(deliveryId, "deliveryId");
+    return this.request("GET", `/org/webhooks/deliveries/${deliveryId}`, options);
+  }
+  async retryWebhookDelivery(deliveryId, options = {}) {
+    positiveId(deliveryId, "deliveryId");
+    return this.request("POST", `/org/webhooks/deliveries/${deliveryId}/retry`, options);
+  }
+  async createExport(request, options = {}) {
+    const format = request.format ?? "csv";
+    const scope = request.scope ?? "filtered";
+    if (format !== "csv" && format !== "jsonl") throw new ValidationError("format must be 'csv' or 'jsonl'");
+    if (scope !== "filtered" && scope !== "all" && scope !== "date_range") {
+      throw new ValidationError("scope must be 'filtered', 'all', or 'date_range'");
+    }
+    const body = { format, scope };
+    if (request.filters !== void 0) body.filters = request.filters === null ? null : exportFilters(request.filters);
+    return this.request("POST", "/exports", { ...options, body });
+  }
+  async listExports(query = {}, options = {}) {
+    if (query.limit !== void 0) boundedInteger(query.limit, "limit", 1, 100);
+    return this.request("GET", "/exports" + queryString({ limit: query.limit }), options);
+  }
+  async getExport(jobId, options = {}) {
+    return this.request("GET", `/exports/${pathId(jobId, "jobId", 8, 64)}`, options);
+  }
+  async cancelExport(jobId, options = {}) {
+    return this.request("POST", `/exports/${pathId(jobId, "jobId", 8, 64)}/cancel`, options);
+  }
+  async retryExport(jobId, options = {}) {
+    return this.request("POST", `/exports/${pathId(jobId, "jobId", 8, 64)}/retry`, options);
+  }
+  async getExportDownloadUrl(jobId, options = {}) {
+    return this.request("GET", `/exports/${pathId(jobId, "jobId", 8, 64)}/download-url`, options);
+  }
 };
 
 // src/index.ts
-var SDK_VERSION2 = "1.3.0";
+var SDK_VERSION2 = "1.5.0";
 function camelToSnakeKey(key) {
   return key.replace(/([A-Z])/g, "_$1").toLowerCase();
 }