@oxyhq/core 3.11.0 → 3.13.0

package/dist/cjs/utils/profileLinks.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeProfileLinks = normalizeProfileLinks;
+function cleanUrl(value) {
+    if (typeof value !== 'string')
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+/**
+ * Normalizes a user's profile links into a clean display shape.
+ *
+ * Pure, no side effects, no I/O.
+ *
+ * - Prefers `linksMetadata` when it is a non-empty array: maps each entry to
+ *   `{ 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/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`).
+ *
+ * URLs are trimmed and blanks are filtered out. This does NOT add a scheme such
+ * as `https://`; prefixing is a display concern left to the caller.
+ */
+function normalizeProfileLinks(linksMetadata, links) {
+    if (Array.isArray(linksMetadata) && linksMetadata.length > 0) {
+        const result = [];
+        linksMetadata.forEach((entry, index) => {
+            const url = cleanUrl(entry?.url);
+            if (!url)
+                return;
+            const id = typeof entry?.id === 'string' && entry.id.trim().length > 0
+                ? entry.id
+                : String(index);
+            const title = typeof entry?.title === 'string' ? entry.title : undefined;
+            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;
+    }
+    if (Array.isArray(links) && links.length > 0) {
+        const result = [];
+        links.forEach((value, index) => {
+            const url = cleanUrl(value);
+            if (!url)
+                return;
+            result.push({ id: String(index), url });
+        });
+        return result;
+    }
+    return [];
+}