@mymehq/sdk 3.7.0 → 3.8.0

package/dist/index.d.ts

@@ -217,6 +217,47 @@ interface BulkResult {
     /** Present only on archive-restore paths. */
     blobs_imported?: number;
 }
+/** One edge to create or upsert in a `POST /edges/bulk` call. */
+interface BulkEdgeInputItem {
+    /** Optional server-id override. Server-generated UUIDv7 otherwise. */
+    id?: string;
+    source_id: string;
+    target_id: string;
+    edge_type: string;
+    properties?: Record<string, unknown>;
+}
+interface BulkEdgeInput {
+    edges: BulkEdgeInputItem[];
+    /** Default: `"upsert"`. On duplicate `(source_id, target_id, edge_type)`:
+     *  `"upsert"` replaces properties in place; `"create_only"` skips with
+     *  reason `"duplicate_edge"`. */
+    mode?: BulkMode;
+    /** Default: `true`. When false, errors are collected per edge and the
+     *  batch continues past failures. */
+    atomic?: boolean;
+    /** Default: `false`. Per-edge `edge.created` / `edge.deleted` webhook
+     *  events are suppressed on bulk writes unless the caller opts in. */
+    emit_events?: boolean;
+}
+interface BulkEdgeResultEntry {
+    index: number;
+    outcome: BulkOutcome;
+    id?: string;
+    reason?: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+interface BulkEdgeResult {
+    counts: {
+        created: number;
+        updated: number;
+        skipped: number;
+        errored: number;
+    };
+    results: BulkEdgeResultEntry[];
+}
 /** Filter shape for `POST /items/bulk_action`. Mirrors the `GET /items`
  *  query grammar — every field is AND-composed, `filter` accepts the
  *  full filter-SQL DSL. */
@@ -388,6 +429,21 @@ declare class MymeClient {
          *  are immutable; server rejects with 400. */
         update: (id: string, properties: Record<string, unknown>) => Promise<Edge>;
         delete: (id: string) => Promise<void>;
+        /**
+         * Create or upsert many edges in one call (admin-only). Up to 5000
+         * edges per call.
+         *
+         * Modes: `"upsert"` (default) replaces properties on existing
+         * `(source_id, target_id, edge_type)` triples; `"create_only"` surfaces
+         * duplicates as `skipped` with reason `"duplicate_edge"`. `atomic: true`
+         * (default) rolls back the whole batch on any failure — per-edge errors
+         * for non-atomic mode land in each result entry.
+         *
+         * Sibling to `items.bulk` for the edges half of mode-transition
+         * migrations (where cross-item edges can't reliably ride along as
+         * inline-edge payloads on the item writes).
+         */
+        bulk: (input: BulkEdgeInput) => Promise<BulkEdgeResult>;
         /** Outbound edges — items where this id is source. Filter by edge type
          *  (comma-separated string or array of type ids). */
         listFromSource: (sourceId: string, filters?: {
@@ -570,4 +626,4 @@ interface VerifyWebhookSignatureInput {
  */
 declare function verifyWebhookSignature(input: VerifyWebhookSignatureInput): WebhookVerifyResult;
 
-export { type BulkActionErrorEntry, type BulkActionFilter, type BulkActionInput, type BulkActionResult, type BulkInput, type BulkItemInput, type BulkMode, type BulkOutcome, type BulkResult, type BulkResultEntry, type ClientConfig, type ConflictAutoMergeListener, type ConflictAutoMergedEvent, type ConflictData, ConflictError, type ConflictResolver, type ConflictStrategy, ForbiddenError, type ItemWithExtensions, type ListFilters, type MetadataInput, MymeClient, MymeError, NotFoundError, type SearchFilters, UnauthorizedError, type UpdateOptions, ValidationError, type VerifyWebhookSignatureInput, type WebhookVerifyReason, type WebhookVerifyResult, verifyWebhookSignature };
+export { type BulkActionErrorEntry, type BulkActionFilter, type BulkActionInput, type BulkActionResult, type BulkEdgeInput, type BulkEdgeInputItem, type BulkEdgeResult, type BulkEdgeResultEntry, type BulkInput, type BulkItemInput, type BulkMode, type BulkOutcome, type BulkResult, type BulkResultEntry, type ClientConfig, type ConflictAutoMergeListener, type ConflictAutoMergedEvent, type ConflictData, ConflictError, type ConflictResolver, type ConflictStrategy, ForbiddenError, type ItemWithExtensions, type ListFilters, type MetadataInput, MymeClient, MymeError, NotFoundError, type SearchFilters, UnauthorizedError, type UpdateOptions, ValidationError, type VerifyWebhookSignatureInput, type WebhookVerifyReason, type WebhookVerifyResult, verifyWebhookSignature };

package/dist/index.js

@@ -613,6 +613,25 @@ var MymeClient = class {
     delete: async (id) => {
       await this.transport.request("DELETE", `/edges/${id}`);
     },
+    /**
+     * Create or upsert many edges in one call (admin-only). Up to 5000
+     * edges per call.
+     *
+     * Modes: `"upsert"` (default) replaces properties on existing
+     * `(source_id, target_id, edge_type)` triples; `"create_only"` surfaces
+     * duplicates as `skipped` with reason `"duplicate_edge"`. `atomic: true`
+     * (default) rolls back the whole batch on any failure — per-edge errors
+     * for non-atomic mode land in each result entry.
+     *
+     * Sibling to `items.bulk` for the edges half of mode-transition
+     * migrations (where cross-item edges can't reliably ride along as
+     * inline-edge payloads on the item writes).
+     */
+    bulk: async (input) => {
+      return this.transport.request("POST", "/edges/bulk", {
+        body: input
+      });
+    },
     /** Outbound edges — items where this id is source. Filter by edge type
      *  (comma-separated string or array of type ids). */
     listFromSource: async (sourceId, filters) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mymehq/sdk",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "type": "module",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",