added utility to normalize asset id

frontend/lib/utils/normalizeAssetId.test.ts

@@ -0,0 +1,33 @@
+import { normalizeAssetId } from "./normalizeAssetId";
+
+describe("normalizeAssetId utility", () => {
+  it("should handle numeric string IDs", () => {
+    expect(normalizeAssetId("123")).toBe("123");
+  });
+
+  it("should strip 'asset-' prefix", () => {
+    expect(normalizeAssetId("asset-456")).toBe("456");
+  });
+
+  it("should convert numeric input to string", () => {
+    expect(normalizeAssetId(789)).toBe("789");
+  });
+
+  it("should strip custom prefixes like 'id-'", () => {
+    expect(normalizeAssetId("id-999")).toBe("999");
+  });
+
+  it("should trim spaces and normalize properly", () => {
+    expect(normalizeAssetId("  asset-321  ")).toBe("321");
+  });
+
+  it("should throw error for null or undefined", () => {
+    expect(() => normalizeAssetId(null as any)).toThrow();
+    expect(() => normalizeAssetId(undefined as any)).toThrow();
+  });
+
+  it("should keep UUIDs intact", () => {
+    const uuid = "550e8400-e29b-41d4-a716-446655440000";
+    expect(normalizeAssetId(uuid)).toBe(uuid);
+  });
+});

frontend/lib/utils/normalizeAssetId.ts

@@ -0,0 +1,28 @@
+/**
+ * Utility to normalize asset IDs into a consistent string format.
+ * Supports numeric, UUID, and prefixed IDs (e.g., "asset-123").
+ *
+ * @param id - The input ID (string or number)
+ * @returns A standardized string ID
+ *
+ * Examples:
+ * normalizeAssetId("123") → "123"
+ * normalizeAssetId("asset-456") → "456"
+ * normalizeAssetId(789) → "789"
+ */
+
+export function normalizeAssetId(id: string | number): string {
+  if (id === null || id === undefined) {
+    throw new Error("Invalid ID: value cannot be null or undefined");
+  }
+
+  // Convert to string
+  let idStr = String(id).trim();
+
+  // Remove any "asset-" or similar prefixes (case insensitive)
+  idStr = idStr.replace(/^(asset-|id-|a-)/i, "");
+
+  // Optionally handle UUIDs or mixed IDs (leave them untouched)
+  // Only clean simple prefixed or numeric IDs
+  return idStr;
+}