opticedge-cloud-utils 1.1.4 → 1.1.6

package/dist/index.d.ts

@@ -5,6 +5,8 @@ export * from './tw/utils';
 export * from './tw/wallet';
 export * from './auth';
 export * from './env';
+export * from './parser';
 export * from './regex';
 export * from './secrets';
 export * from './task';
+export * from './validator';

package/dist/index.js

@@ -21,6 +21,8 @@ __exportStar(require("./tw/utils"), exports);
 __exportStar(require("./tw/wallet"), exports);
 __exportStar(require("./auth"), exports);
 __exportStar(require("./env"), exports);
+__exportStar(require("./parser"), exports);
 __exportStar(require("./regex"), exports);
 __exportStar(require("./secrets"), exports);
 __exportStar(require("./task"), exports);
+__exportStar(require("./validator"), exports);

package/dist/parser.d.ts

@@ -0,0 +1,2 @@
+declare const toNumber: (v: any) => number | null;
+export { toNumber };

package/dist/parser.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toNumber = void 0;
+// Helper: accept number or numeric-string, return number or null
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const toNumber = (v) => {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    if (typeof v === 'string' && /^\d+$/.test(v))
+        return Number(v);
+    return null;
+};
+exports.toNumber = toNumber;

package/dist/validator.d.ts

@@ -0,0 +1,3 @@
+/** Basic email validation — good enough for most production use cases */
+declare const isValidEmail: (email: string) => boolean;
+export { isValidEmail };

package/dist/validator.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidEmail = void 0;
+/** Basic email validation — good enough for most production use cases */
+const isValidEmail = (email) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email.trim());
+exports.isValidEmail = isValidEmail;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opticedge-cloud-utils",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "Common utilities for cloud functions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/index.ts

@@ -5,6 +5,8 @@ export * from './tw/utils'
 export * from './tw/wallet'
 export * from './auth'
 export * from './env'
+export * from './parser'
 export * from './regex'
 export * from './secrets'
 export * from './task'
+export * from './validator'

package/src/parser.ts

@@ -0,0 +1,9 @@
+// Helper: accept number or numeric-string, return number or null
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const toNumber = (v: any): number | null => {
+  if (typeof v === 'number' && Number.isFinite(v)) return v
+  if (typeof v === 'string' && /^\d+$/.test(v)) return Number(v)
+  return null
+}
+
+export { toNumber }

package/src/validator.ts

@@ -0,0 +1,4 @@
+/** Basic email validation — good enough for most production use cases */
+const isValidEmail = (email: string) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email.trim())
+
+export { isValidEmail }

package/tests/parser.test.ts

@@ -0,0 +1,26 @@
+import { toNumber } from '../src'
+
+describe('toNumber', () => {
+  it('returns the same number when input is a finite number', () => {
+    expect(toNumber(123)).toBe(123)
+    expect(toNumber(0)).toBe(0)
+  })
+
+  it('returns number when input is a numeric string', () => {
+    expect(toNumber('456')).toBe(456)
+  })
+
+  it('returns null for non-numeric strings', () => {
+    expect(toNumber('abc')).toBeNull()
+    expect(toNumber('123abc')).toBeNull()
+    expect(toNumber('')).toBeNull()
+  })
+
+  it('returns null for non-numbers', () => {
+    expect(toNumber(NaN)).toBeNull()
+    expect(toNumber(Infinity)).toBeNull()
+    expect(toNumber(undefined)).toBeNull()
+    expect(toNumber(null)).toBeNull()
+    expect(toNumber({})).toBeNull()
+  })
+})

package/tests/validator.ts

@@ -0,0 +1,37 @@
+// isValidEmail.test.ts
+import { describe, it, expect } from '@jest/globals'
+import { isValidEmail } from '../src'
+
+describe('isValidEmail', () => {
+  it('returns true for simple valid emails', () => {
+    expect(isValidEmail('test@example.com')).toBe(true)
+    expect(isValidEmail('user.name@domain.co')).toBe(true)
+    expect(isValidEmail('user_name+tag@sub.domain.org')).toBe(true)
+  })
+
+  it('returns false for missing parts', () => {
+    expect(isValidEmail('')).toBe(false)
+    expect(isValidEmail('plainaddress')).toBe(false)
+    expect(isValidEmail('@no-local-part.com')).toBe(false)
+    expect(isValidEmail('username@')).toBe(false)
+    expect(isValidEmail('user@domain')).toBe(false)
+    expect(isValidEmail('username@.com')).toBe(false)
+  })
+
+  it('handles whitespace correctly', () => {
+    expect(isValidEmail('   test@example.com   ')).toBe(true) // trims input
+    expect(isValidEmail('\nuser@domain.com\t')).toBe(true)
+  })
+
+  it('rejects invalid characters or formats', () => {
+    expect(isValidEmail('user@@domain.com')).toBe(false)
+    expect(isValidEmail('user@domain,com')).toBe(false)
+    expect(isValidEmail('user@domain..com')).toBe(false)
+    expect(isValidEmail('user@.domain.com')).toBe(false)
+    expect(isValidEmail('user@domain com')).toBe(false)
+  })
+
+  it('accepts minimal valid domain structures', () => {
+    expect(isValidEmail('x@y.z')).toBe(true) // still valid
+  })
+})