@mymehq/sdk 4.8.0 → 4.9.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, 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.
@@ -631,6 +631,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

@@ -991,6 +991,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.9.0",
   "type": "module",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
@@ -20,7 +20,7 @@
     "dist"
   ],
   "dependencies": {
-    "@mymehq/shared": "4.8.0"
+    "@mymehq/shared": "4.9.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",