@hobenakicoffee/libraries 1.0.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hobenakicoffee/libraries",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "type": "module",
   "types": "src/index.ts",
   "exports": {

package/src/constants/services.test.ts

@@ -4,13 +4,14 @@ import type { ServiceType } from "./services";
 
 describe("ServiceTypes", () => {
   test("should contain all expected service type keys", () => {
-    const expectedKeys = ["GIFT", "EXCLUSIVE_CONTENT"];
+    const expectedKeys = ["GIFT", "EXCLUSIVE_CONTENT", "WITHDRAWAL"];
     expect(Object.keys(ServiceTypes)).toEqual(expectedKeys);
   });
 
   test("should have correct values for each service type", () => {
     expect(ServiceTypes.GIFT).toBe("gift");
     expect(ServiceTypes.EXCLUSIVE_CONTENT).toBe("exclusive_content");
+    expect(ServiceTypes.WITHDRAWAL).toBe("withdrawal");
   });
 
   test("should be read-only at compile time", () => {
@@ -26,7 +27,7 @@ describe("ServiceTypes", () => {
   });
 
   test("should have 2 service types", () => {
-    expect(Object.keys(ServiceTypes).length).toBe(2);
+    expect(Object.keys(ServiceTypes).length).toBe(3);
   });
 
   test("all values should be lowercase or snake_case strings", () => {

package/src/constants/services.ts

@@ -1,6 +1,7 @@
 export const ServiceTypes = {
   GIFT: "gift",
   EXCLUSIVE_CONTENT: "exclusive_content",
+  WITHDRAWAL: "withdrawal",
 } as const;
 
 export type ServiceType = (typeof ServiceTypes)[keyof typeof ServiceTypes];

package/src/utils/index.ts

@@ -10,3 +10,4 @@ export * from "./post-to-linkedin";
 export * from "./post-to-x";
 export * from "./qr-svg-utils";
 export * from "./validate-phone-number";
+export * from "./to-human-readable";

package/src/utils/to-human-readable.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, test } from "bun:test";
+import { toHumanReadable } from "./to-human-readable";
+
+describe("toHumanReadable", () => {
+  test("returns empty string for blank input", () => {
+    expect(toHumanReadable("   ")).toBe("");
+  });
+
+  test("normalizes separators and trims", () => {
+    expect(toHumanReadable("  hello-world__again  ")).toBe("Hello World Again");
+  });
+
+  test("splits camelCase and title cases words", () => {
+    expect(toHumanReadable("supporterName")).toBe("Supporter Name");
+  });
+
+  test("preserves uppercase acronyms and numbers", () => {
+    expect(toHumanReadable("APIResponseV2")).toBe("API Response V2");
+    expect(toHumanReadable("USER_ID_2")).toBe("USER ID 2");
+  });
+
+  test("handles mixed separators and spacing", () => {
+    expect(toHumanReadable("foo__BAR-baz   QUX")).toBe("Foo BAR Baz QUX");
+  });
+});

package/src/utils/to-human-readable.ts

@@ -0,0 +1,22 @@
+const UPPERCASE_OR_NUMBER = /^[A-Z0-9]+$/;
+
+export function toHumanReadable(input: string): string {
+  const normalized = input
+    .trim()
+    .replace(/[-_]+/g, " ")
+    .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+    .replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2")
+    .replace(/\s+/g, " ")
+    .trim();
+
+  if (!normalized) return "";
+
+  return normalized
+    .split(" ")
+    .map((word) => {
+      if (UPPERCASE_OR_NUMBER.test(word)) return word;
+
+      return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+    })
+    .join(" ");
+}