@mymehq/sdk 3.6.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?: {
@@ -489,17 +545,26 @@ declare class MymeError extends Error {
     readonly details?: Record<string, unknown>;
     constructor(code: string, message: string, status: number, details?: Record<string, unknown>, cause?: unknown);
 }
+/**
+ * Status-coded subclasses preserve the server-supplied `code` so callers
+ * can branch on specific codes (`bulk_cap_exceeded`, `edge_not_found`,
+ * `reset_disabled`, …) while still matching `instanceof NotFoundError`
+ * etc. for generic handling. The status family (4xx bucket) is
+ * communicated by the class; the specific code is communicated by the
+ * `code` field. When the server omits a code, the canonical value for
+ * the status family is used as a fallback.
+ */
 declare class NotFoundError extends MymeError {
-    constructor(message: string, details?: Record<string, unknown>);
+    constructor(message: string, details?: Record<string, unknown>, code?: string);
 }
 declare class ValidationError extends MymeError {
-    constructor(message: string, details?: Record<string, unknown>);
+    constructor(message: string, details?: Record<string, unknown>, code?: string);
 }
 declare class UnauthorizedError extends MymeError {
-    constructor(message: string, details?: Record<string, unknown>);
+    constructor(message: string, details?: Record<string, unknown>, code?: string);
 }
 declare class ForbiddenError extends MymeError {
-    constructor(message: string, details?: Record<string, unknown>);
+    constructor(message: string, details?: Record<string, unknown>, code?: string);
 }
 declare class ConflictError extends MymeError {
     readonly current: ConflictSnapshot;
@@ -561,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

@@ -12,26 +12,26 @@ var MymeError = class extends Error {
   }
 };
 var NotFoundError = class extends MymeError {
-  constructor(message, details) {
-    super("not_found", message, 404, details);
+  constructor(message, details, code) {
+    super(code ?? "not_found", message, 404, details);
     this.name = "NotFoundError";
   }
 };
 var ValidationError = class extends MymeError {
-  constructor(message, details) {
-    super("validation_error", message, 400, details);
+  constructor(message, details, code) {
+    super(code ?? "validation_error", message, 400, details);
     this.name = "ValidationError";
   }
 };
 var UnauthorizedError = class extends MymeError {
-  constructor(message, details) {
-    super("unauthorized", message, 401, details);
+  constructor(message, details, code) {
+    super(code ?? "unauthorized", message, 401, details);
     this.name = "UnauthorizedError";
   }
 };
 var ForbiddenError = class extends MymeError {
-  constructor(message, details) {
-    super("forbidden", message, 403, details);
+  constructor(message, details, code) {
+    super(code ?? "forbidden", message, 403, details);
     this.name = "ForbiddenError";
   }
 };
@@ -167,18 +167,18 @@ var HttpTransport = class {
     const errObj = parsed?.error;
     const message = errObj?.message ?? `HTTP ${String(status)}`;
     const details = errObj?.details;
-    const code = errObj?.code ?? "unknown";
+    const serverCode = errObj?.code;
     switch (status) {
       case 400:
-        throw new ValidationError(message, details);
+        throw new ValidationError(message, details, serverCode);
       case 401:
-        throw new UnauthorizedError(message, details);
+        throw new UnauthorizedError(message, details, serverCode);
       case 403:
-        throw new ForbiddenError(message, details);
+        throw new ForbiddenError(message, details, serverCode);
       case 404:
-        throw new NotFoundError(message, details);
+        throw new NotFoundError(message, details, serverCode);
       default:
-        throw new MymeError(code, message, status, details);
+        throw new MymeError(serverCode ?? "unknown", message, status, details);
     }
   }
 };
@@ -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.6.0",
+  "version": "3.8.0",
   "type": "module",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",