@mymehq/sdk 4.8.0 → 4.10.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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 } from '@mymehq/shared';
-export { ApiKey, ConflictSnapshot, CreateItemInput, CreateKeyInput, Item, ItemState, MergePolicy, MergeStrategy, Metadata, PaginatedResult, SearchResult, TypeSchema, UpdateKeyInput, Version } 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';
 
 /**
  * Conflict resolution strategy for item updates.
@@ -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
@@ -631,6 +646,35 @@ declare class MymeClient {
             }) => Promise<TenantQuota>;
         };
     };
+    /**
+     * The calling user's profile. `system.profile` is a virtual type —
+     * served by a dedicated endpoint over the `users` table joined to
+     * `auth_user` for the canonical email. Username changes go through
+     * the same handle validators as `PUT /auth/me/handle`.
+     *
+     * Apps that need a third-party-OAuth-style read should use the
+     * standard OIDC `profile` / `email` scopes via `/auth/userinfo`
+     * instead — this surface is for first-party callers (CLI, MCP, the
+     * user themselves) holding a tenant-scoped bearer.
+     */
+    readonly profile: {
+        /** Read the calling user's profile. */
+        get: () => Promise<Profile>;
+        /**
+         * Update the calling user's profile. Every field optional; `null`
+         * clears (where applicable). `username` runs through the
+         * reserved-handle / collision validators server-side.
+         */
+        update: (input: UpdateProfileInput) => Promise<Profile>;
+        /**
+         * Upload an avatar. Accepts a Blob/File or a Uint8Array. The server
+         * stores the bytes in the existing R2-backed blob layer and stamps
+         * the content-addressed hash onto the user row.
+         */
+        setAvatar: (data: Blob | Uint8Array, mimeType?: string) => Promise<Profile>;
+        /** Clear the avatar; reverts to the deterministic placeholder. */
+        clearAvatar: () => Promise<Profile>;
+    };
     private throwRawError;
 }
 

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) ----
@@ -991,6 +1012,60 @@ var MymeClient = class {
       }
     }
   };
+  // ---- Profile (T-074) ----
+  /**
+   * The calling user's profile. `system.profile` is a virtual type —
+   * served by a dedicated endpoint over the `users` table joined to
+   * `auth_user` for the canonical email. Username changes go through
+   * the same handle validators as `PUT /auth/me/handle`.
+   *
+   * Apps that need a third-party-OAuth-style read should use the
+   * standard OIDC `profile` / `email` scopes via `/auth/userinfo`
+   * instead — this surface is for first-party callers (CLI, MCP, the
+   * user themselves) holding a tenant-scoped bearer.
+   */
+  profile = {
+    /** Read the calling user's profile. */
+    get: async () => {
+      return this.transport.request("GET", "/profile/me");
+    },
+    /**
+     * Update the calling user's profile. Every field optional; `null`
+     * clears (where applicable). `username` runs through the
+     * reserved-handle / collision validators server-side.
+     */
+    update: async (input) => {
+      return this.transport.request("PATCH", "/profile/me", {
+        body: input
+      });
+    },
+    /**
+     * Upload an avatar. Accepts a Blob/File or a Uint8Array. The server
+     * stores the bytes in the existing R2-backed blob layer and stamps
+     * the content-addressed hash onto the user row.
+     */
+    setAvatar: async (data, mimeType) => {
+      const form = new FormData();
+      const blob = data instanceof Blob ? data : new Blob([new Uint8Array(data)], {
+        type: mimeType ?? "application/octet-stream"
+      });
+      form.append("file", blob, "avatar");
+      const response = await this.transport.rawRequest(
+        "POST",
+        "/profile/me/avatar",
+        { rawBody: form }
+      );
+      const result = await response.json();
+      if (!response.ok) {
+        this.throwRawError(response.status, result);
+      }
+      return result;
+    },
+    /** Clear the avatar; reverts to the deterministic placeholder. */
+    clearAvatar: async () => {
+      return this.transport.request("DELETE", "/profile/me/avatar");
+    }
+  };
   // ---- Internal ----
   throwRawError(status, body) {
     const parsed = body;

package/package.json

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