@oxyhq/core 3.12.0 → 3.13.0

package/dist/types/utils/profileLinks.d.ts

@@ -3,11 +3,16 @@
  *
  * `id` is a stable key for list rendering (the source entry's id when present,
  * otherwise the source index as a string). `url` is always a non-empty string.
+ * `title`, `description`, and `image` are carried through from `linksMetadata`
+ * only when present; the legacy `links: string[]` path produces just
+ * `{ id, url }`.
  */
 export interface ProfileLink {
     id: string;
     title?: string;
     url: string;
+    description?: string;
+    image?: string;
 }
 /** Source shape of a single `User.linksMetadata` entry. */
 export interface ProfileLinkMetadata {
@@ -23,10 +28,13 @@ export interface ProfileLinkMetadata {
  * Pure, no side effects, no I/O.
  *
  * - Prefers `linksMetadata` when it is a non-empty array: maps each entry to
- *   `{ id, title, url }`, using `entry.id` when present and falling back to the
- *   entry index. Entries without a non-empty string `url` are dropped.
+ *   `{ id, title, url, description, image }`, using `entry.id` when present and
+ *   falling back to the entry index. `title`, `description`, and `image` are
+ *   carried through only when they are present strings. Entries without a
+ *   non-empty string `url` are dropped.
  * - Otherwise falls back to the legacy `links` string array: maps each string to
- *   `{ id: <index>, url }` (no title). Empty/non-string values are dropped.
+ *   `{ id: <index>, url }` (no title/description/image). Empty/non-string values
+ *   are dropped.
  * - Returns `[]` when both are absent or empty (including when `linksMetadata`
  *   is present but every entry is dropped — it does NOT fall back to `links`).
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/core",
-  "version": "3.12.0",
+  "version": "3.13.0",
   "description": "OxyHQ SDK Foundation — API client, authentication, cryptographic identity, and shared utilities",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -98,7 +98,7 @@
     }
   },
   "dependencies": {
-    "@oxyhq/contracts": "0.4.0",
+    "@oxyhq/contracts": "workspace:*",
     "bip39": "^3.1.0",
     "buffer": "^6.0.3",
     "elliptic": "^6.6.1",

package/src/utils/__tests__/profileLinks.test.ts

@@ -30,6 +30,53 @@ describe('normalizeProfileLinks', () => {
       expect(result[0]).not.toHaveProperty('title');
     });
 
+    it('carries through description and image when present', () => {
+      const result = normalizeProfileLinks([
+        {
+          url: 'https://oxy.so',
+          title: 'Oxy',
+          description: 'The Oxy ecosystem',
+          image: 'https://cdn.example/oxy.png',
+          id: 'abc',
+        },
+      ]);
+      expect(result).toEqual<ProfileLink[]>([
+        {
+          id: 'abc',
+          title: 'Oxy',
+          url: 'https://oxy.so',
+          description: 'The Oxy ecosystem',
+          image: 'https://cdn.example/oxy.png',
+        },
+      ]);
+    });
+
+    it('omits description and image when absent', () => {
+      const result = normalizeProfileLinks([
+        { url: 'https://min.example', title: 'Min' },
+      ]);
+      expect(result).toEqual<ProfileLink[]>([
+        { id: '0', title: 'Min', url: 'https://min.example' },
+      ]);
+      expect(result[0]).not.toHaveProperty('description');
+      expect(result[0]).not.toHaveProperty('image');
+    });
+
+    it('carries description and image independently of title', () => {
+      const result = normalizeProfileLinks([
+        { url: 'https://only-image.example', image: 'https://cdn.example/i.png' },
+        { url: 'https://only-desc.example', description: 'Just a description' },
+      ]);
+      expect(result).toEqual<ProfileLink[]>([
+        { id: '0', url: 'https://only-image.example', image: 'https://cdn.example/i.png' },
+        { id: '1', url: 'https://only-desc.example', description: 'Just a description' },
+      ]);
+      expect(result[0]).not.toHaveProperty('title');
+      expect(result[0]).not.toHaveProperty('description');
+      expect(result[1]).not.toHaveProperty('title');
+      expect(result[1]).not.toHaveProperty('image');
+    });
+
     it('drops entries with missing or empty url and keeps stable index ids', () => {
       const result = normalizeProfileLinks([
         { url: 'https://keep.example', title: 'Keep', id: 'keep' },
@@ -60,7 +107,7 @@ describe('normalizeProfileLinks', () => {
   });
 
   describe('legacy links path (no linksMetadata)', () => {
-    it('maps strings to { id, url } without titles', () => {
+    it('maps strings to { id, url } without title/description/image', () => {
       const result = normalizeProfileLinks(undefined, [
         'https://a.example',
         'https://b.example',
@@ -69,7 +116,14 @@ describe('normalizeProfileLinks', () => {
         { id: '0', url: 'https://a.example' },
         { id: '1', url: 'https://b.example' },
       ]);
-      expect(result.every((link) => !('title' in link))).toBe(true);
+      expect(
+        result.every(
+          (link) =>
+            !('title' in link) &&
+            !('description' in link) &&
+            !('image' in link),
+        ),
+      ).toBe(true);
     });
 
     it('drops empty and whitespace-only strings, preserving source index ids', () => {

package/src/utils/profileLinks.ts

@@ -3,11 +3,16 @@
  *
  * `id` is a stable key for list rendering (the source entry's id when present,
  * otherwise the source index as a string). `url` is always a non-empty string.
+ * `title`, `description`, and `image` are carried through from `linksMetadata`
+ * only when present; the legacy `links: string[]` path produces just
+ * `{ id, url }`.
  */
 export interface ProfileLink {
   id: string;
   title?: string;
   url: string;
+  description?: string;
+  image?: string;
 }
 
 /** Source shape of a single `User.linksMetadata` entry. */
@@ -31,10 +36,13 @@ function cleanUrl(value: unknown): string | null {
  * Pure, no side effects, no I/O.
  *
  * - Prefers `linksMetadata` when it is a non-empty array: maps each entry to
- *   `{ id, title, url }`, using `entry.id` when present and falling back to the
- *   entry index. Entries without a non-empty string `url` are dropped.
+ *   `{ id, title, url, description, image }`, using `entry.id` when present and
+ *   falling back to the entry index. `title`, `description`, and `image` are
+ *   carried through only when they are present strings. Entries without a
+ *   non-empty string `url` are dropped.
  * - Otherwise falls back to the legacy `links` string array: maps each string to
- *   `{ id: <index>, url }` (no title). Empty/non-string values are dropped.
+ *   `{ id: <index>, url }` (no title/description/image). Empty/non-string values
+ *   are dropped.
  * - Returns `[]` when both are absent or empty (including when `linksMetadata`
  *   is present but every entry is dropped — it does NOT fall back to `links`).
  *
@@ -55,7 +63,16 @@ export function normalizeProfileLinks(
           ? entry.id
           : String(index);
       const title = typeof entry?.title === 'string' ? entry.title : undefined;
-      result.push({ id, url, ...(title !== undefined ? { title } : {}) });
+      const description =
+        typeof entry?.description === 'string' ? entry.description : undefined;
+      const image = typeof entry?.image === 'string' ? entry.image : undefined;
+      result.push({
+        id,
+        url,
+        ...(title !== undefined ? { title } : {}),
+        ...(description !== undefined ? { description } : {}),
+        ...(image !== undefined ? { image } : {}),
+      });
     });
     return result;
   }