uityu.shared 1.0.0 → 1.0.1

package/README.md

@@ -109,6 +109,18 @@ const limit = clampLimit(undefined, { defaultValue: 10, max: 50, min: 5 });
 // -> 10
 ```
 
+### Normalización de texto genérica
+
+```ts
+import { normalizeText } from 'uityu.shared/common/string';
+
+const emailKey = normalizeText('  USER@domain.COM  ');
+// -> 'user@domain.com'
+
+const keepCase = normalizeText('  Mixed Value  ', { lowercase: false });
+// -> 'Mixed Value'
+```
+
 ## Errores + HTTP (`uityu.shared/errors`, `uityu.shared/http`)
 
 ```ts

package/dist/common/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./math/index.js";
 export * from "./logging/index.js";
+export * from "./string/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/common/index.js

@@ -1,3 +1,4 @@
 export * from "./math/index.js";
 export * from "./logging/index.js";
+export * from "./string/index.js";
 //# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/common/string/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./normalize-text.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/common/string/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/common/string/index.js

@@ -0,0 +1,2 @@
+export * from "./normalize-text.js";
+//# sourceMappingURL=index.js.map

package/dist/common/string/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/common/string/normalize-text.d.ts

@@ -0,0 +1,12 @@
+export type NormalizeTextOptions = {
+    /** When false, keeps original casing */
+    lowercase?: boolean;
+    /** When false, preserves surrounding whitespace */
+    trim?: boolean;
+};
+/**
+ * Normalize arbitrary strings (emails, identifiers, etc.)
+ * by trimming and lowercasing by default.
+ */
+export declare function normalizeText(value: string | null | undefined, options?: NormalizeTextOptions): string;
+//# sourceMappingURL=normalize-text.d.ts.map

package/dist/common/string/normalize-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-text.d.ts","sourceRoot":"","sources":["../../../src/common/string/normalize-text.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IACjC,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAOF;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,GAAE,oBAAsC,GAC9C,MAAM,CAYR"}

package/dist/common/string/normalize-text.js

@@ -0,0 +1,19 @@
+const DEFAULT_OPTIONS = {
+    lowercase: true,
+    trim: true,
+};
+/**
+ * Normalize arbitrary strings (emails, identifiers, etc.)
+ * by trimming and lowercasing by default.
+ */
+export function normalizeText(value, options = DEFAULT_OPTIONS) {
+    if (typeof value !== "string") {
+        return "";
+    }
+    let result = options.trim === false ? value : value.trim();
+    if (options.lowercase !== false) {
+        result = result.toLowerCase();
+    }
+    return result;
+}
+//# sourceMappingURL=normalize-text.js.map

package/dist/common/string/normalize-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-text.js","sourceRoot":"","sources":["../../../src/common/string/normalize-text.ts"],"names":[],"mappings":"AAOA,MAAM,eAAe,GAAmC;IACtD,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,IAAI;CACX,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAgC,EAChC,UAAgC,eAAe;IAE/C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,MAAM,GAAG,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAE3D,IAAI,OAAO,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;QAChC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uityu.shared",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Shared infrastructure toolkit for UITYU microservices (Cloud Functions, SSR, APIs).",
   "type": "module",
   "main": "dist/index.js",
@@ -22,6 +22,10 @@
       "import": "./dist/common/logging/index.js",
       "types": "./dist/common/logging/index.d.ts"
     },
+    "./common/string": {
+      "import": "./dist/common/string/index.js",
+      "types": "./dist/common/string/index.d.ts"
+    },
     "./errors": {
       "import": "./dist/errors/index.js",
       "types": "./dist/errors/index.d.ts"