@mymehq/sdk 4.9.0 → 4.10.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { MergeStrategy, ConflictSnapshot, MergePolicy, ItemState, Tier, Item, CreateItemInput, PaginatedResult, ItemWithMetadata, Version, Edge, Metadata, SearchResult, CreateEdgeInput, EdgeTypeSchema, TypeSchema, CreateKeyInput, ApiKey, UpdateKeyInput, CreateWebhookInput, Webhook, UpdateWebhookInput, WebhookDelivery, ConnectionInstallResult, ConnectionUninstallResult, TenantConfig, TenantQuota, Profile, UpdateProfileInput } from '@mymehq/shared';
+import { MergeStrategy, ConflictSnapshot, MergePolicy, ItemState, Tier, Item, CreateItemInput, PaginatedResult, ItemWithMetadata, Version, Edge, Metadata, SearchResult, CreateEdgeInput, EdgeTypeSchema, TypeSchema, CreateKeyInput, ApiKey, UpdateKeyInput, CreateWebhookInput, Webhook, UpdateWebhookInput, WebhookDelivery, ConnectionInstallResult, ConnectionUninstallResult, PreviewEventRequest, PreviewEventResult, TenantConfig, TenantQuota, Profile, UpdateProfileInput } from '@mymehq/shared';
 export { ApiKey, ConflictSnapshot, CreateItemInput, CreateKeyInput, Item, ItemState, MergePolicy, MergeStrategy, Metadata, PaginatedResult, Profile, SearchResult, TypeSchema, UpdateKeyInput, UpdateProfileInput, Version } from '@mymehq/shared';
 
 /**
@@ -592,6 +592,21 @@ declare class MymeClient {
          * can uninstall connections in their own tenant scope.
          */
         uninstall: (id: string) => Promise<ConnectionUninstallResult>;
+        /**
+         * Preview the wire envelopes the reactive-run bridge would emit for
+         * a synthetic item-event, without dispatching anything. Operator
+         * debugging surface (T-083): given an existing item id and an event
+         * type, the route returns one row per subscribing connection — either
+         * `would_dispatch: true` with the synthesised envelope, or
+         * `would_dispatch: false` with a `dispatch_reason` (`self_event`,
+         * `cross_tenant`, `hop_budget_exceeded`, `subscription_inactive`).
+         *
+         * Defaults to all subscribers in the caller's tenant; pass
+         * `connection_id` to filter to one. The optional `cycle` override
+         * lets you reproduce reactive scenarios ("what if hop_count was N?").
+         * Workspace-admin only.
+         */
+        previewEvent: (input: PreviewEventRequest) => Promise<PreviewEventResult>;
     };
     /** Tenant-scoped configuration. Controls feed-tier retention per type
      * and the three optional schema-enforcement levers (TSC42 §5). All

package/dist/index.js

@@ -932,6 +932,27 @@ var MymeClient = class {
         "POST",
         `/connections/${id}/uninstall`
       );
+    },
+    /**
+     * Preview the wire envelopes the reactive-run bridge would emit for
+     * a synthetic item-event, without dispatching anything. Operator
+     * debugging surface (T-083): given an existing item id and an event
+     * type, the route returns one row per subscribing connection — either
+     * `would_dispatch: true` with the synthesised envelope, or
+     * `would_dispatch: false` with a `dispatch_reason` (`self_event`,
+     * `cross_tenant`, `hop_budget_exceeded`, `subscription_inactive`).
+     *
+     * Defaults to all subscribers in the caller's tenant; pass
+     * `connection_id` to filter to one. The optional `cycle` override
+     * lets you reproduce reactive scenarios ("what if hop_count was N?").
+     * Workspace-admin only.
+     */
+    previewEvent: async (input) => {
+      return this.transport.request(
+        "POST",
+        "/connections/preview-event",
+        { body: input }
+      );
     }
   };
   // ---- Tenants (admin) ----

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mymehq/sdk",
-  "version": "4.9.0",
+  "version": "4.10.0",
   "type": "module",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -20,7 +20,7 @@
     "dist"
   ],
   "dependencies": {
-    "@mymehq/shared": "4.9.0"
+    "@mymehq/shared": "4.10.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",