@ibiliaze/stringman 3.5.1 → 3.7.0

package/dist/index.d.ts

@@ -78,7 +78,7 @@ export declare const getCloudinaryPublicId: (url: string) => string;
  *   query({ limit: 10, skip: 20, sortBy: 'createdAt:desc', empty: '' });
  *   // → "?limit=10&skip=20&sortBy=createdAt%3Adesc"
  */
-export declare const query: (q: Record<string, any>) => string;
+export declare const query: (q: Record<string, any>, filter?: (string | null | undefined)[]) => string;
 /**
  * Build a comma-separated string from a list of object keys.
  *
@@ -138,9 +138,25 @@ export declare const isVideoUrl: (url: string) => boolean;
  * @throws Error if no endpoint returns a valid IP.
  */
 export declare const getPublicIP: () => Promise<string>;
-export declare const getTicketId: ({ fixtureId, sectionName, seatName, }: {
-    fixtureId: string;
-    sectionName: string;
-    seatName: string;
-}) => string;
 export declare const invalidPw: (password: string, passwordLength?: number) => string | void;
+export declare const b36: (n: number) => string;
+export declare const luhn36: (s: string) => string;
+export declare const ticket: {
+    getTicketId: ({ fixtureId, sectionName, seatName, }: {
+        fixtureId: string;
+        sectionName: string;
+        seatName: string;
+    }) => string;
+    buildTicketCode: (args: {
+        venueCode: string;
+        fixtureLocalIso: string;
+        sectionId: string;
+        row: number;
+        col: number;
+        rndLen?: number;
+    }) => string;
+    validateTicketCode: (code: string) => boolean;
+    rndBlock: (len?: number) => string;
+    fixtureBlock: (fixtureLocalIso: string) => string;
+    seatBlock: (sectionId: string, row: number, col: number, len?: number) => string;
+};

package/dist/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.invalidPw = exports.getTicketId = exports.getPublicIP = exports.isVideoUrl = exports.getRandomString = exports.extractImageSrcs = exports.select = exports.query = exports.getCloudinaryPublicId = exports.dp = exports.megaTrim = exports.superTrim = void 0;
+exports.ticket = exports.luhn36 = exports.b36 = exports.invalidPw = exports.getPublicIP = exports.isVideoUrl = exports.getRandomString = exports.extractImageSrcs = exports.select = exports.query = exports.getCloudinaryPublicId = exports.dp = exports.megaTrim = exports.superTrim = void 0;
+const ticket_1 = require("./ticket");
 /**
  * Clean up extra whitespace in a string.
  *
@@ -97,10 +98,8 @@ exports.getCloudinaryPublicId = getCloudinaryPublicId;
  *   query({ limit: 10, skip: 20, sortBy: 'createdAt:desc', empty: '' });
  *   // → "?limit=10&skip=20&sortBy=createdAt%3Adesc"
  */
-const query = (q) => {
+const query = (q, filter = ['', null, undefined, 'null', 'undefined']) => {
     try {
-        // Values considered "invalid" and should be filtered out
-        const filter = ['', null, undefined, 'null', 'undefined'];
         // Convert object to entries, filter out invalid keys/values
         const filtered = Object.entries(q).filter(([key, value]) => !filter.includes(key) && !filter.includes(value));
         // Build query string using URLSearchParams
@@ -228,8 +227,6 @@ const getPublicIP = async () => {
     throw new Error('Public IP unavailable');
 };
 exports.getPublicIP = getPublicIP;
-const getTicketId = ({ fixtureId, sectionName, seatName, }) => `${sectionName}-${seatName}-${fixtureId}`;
-exports.getTicketId = getTicketId;
 const invalidPw = (password, passwordLength = 8) => {
     try {
         if (password.length < passwordLength)
@@ -248,3 +245,52 @@ const invalidPw = (password, passwordLength = 8) => {
     }
 };
 exports.invalidPw = invalidPw;
+const BASE36 = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+const b36 = (n) => {
+    try {
+        if (n === 0)
+            return '0';
+        let s = '';
+        let x = Math.floor(Math.abs(n));
+        while (x > 0) {
+            s = BASE36[x % 36] + s;
+            x = Math.floor(x / 36);
+        }
+        return s;
+    }
+    catch (e) {
+        return '';
+    }
+};
+exports.b36 = b36;
+const luhn36 = (s) => {
+    try {
+        let sum = 0;
+        let alt = false;
+        for (let i = s.length - 1; i >= 0; i--) {
+            let v = BASE36.indexOf(s[i].toUpperCase());
+            if (v < 0)
+                continue;
+            if (alt) {
+                v *= 2;
+                v = Math.floor(v / 36) + (v % 36);
+            }
+            sum += v;
+            alt = !alt;
+        }
+        const check = (36 - (sum % 36)) % 36;
+        return BASE36[check];
+    }
+    catch (e) {
+        return '';
+    }
+};
+exports.luhn36 = luhn36;
+exports.ticket = {
+    getTicketId: ticket_1.getTicketId,
+    buildTicketCode: ticket_1.buildTicketCode,
+    validateTicketCode: ticket_1.validateTicketCode,
+    rndBlock: ticket_1.rndBlock,
+    fixtureBlock: ticket_1.fixtureBlock,
+    seatBlock: ticket_1.seatBlock,
+};

package/dist/ticket.d.ts

@@ -0,0 +1,17 @@
+export declare const seatBlock: (sectionId: string, row: number, col: number, len?: number) => string;
+export declare const fixtureBlock: (fixtureLocalIso: string) => string;
+export declare const rndBlock: (len?: number) => string;
+export declare const buildTicketCode: (args: {
+    venueCode: string;
+    fixtureLocalIso: string;
+    sectionId: string;
+    row: number;
+    col: number;
+    rndLen?: number;
+}) => string;
+export declare const validateTicketCode: (code: string) => boolean;
+export declare const getTicketId: ({ fixtureId, sectionName, seatName, }: {
+    fixtureId: string;
+    sectionName: string;
+    seatName: string;
+}) => string;

package/dist/ticket.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTicketId = exports.validateTicketCode = exports.buildTicketCode = exports.rndBlock = exports.fixtureBlock = exports.seatBlock = void 0;
+const node_crypto_1 = require("node:crypto");
+const _1 = require(".");
+const seatBlock = (sectionId, row, col, len = 3) => {
+    try {
+        const h = (0, node_crypto_1.createHash)('sha1').update(`${sectionId}:${row}:${col}`).digest(); // 20 bytes
+        // take first 2 bytes -> 0..65535
+        const n = (h[0] << 8) | h[1];
+        const code = (0, _1.b36)(n).padStart(3, '0'); // 3 chars base36
+        return code.slice(-len);
+    }
+    catch (e) {
+        return '';
+    }
+};
+exports.seatBlock = seatBlock;
+// Fixture datetime block (local TZ string -> YYMMDDhhmm -> base36)
+const fixtureBlock = (fixtureLocalIso) => {
+    try {
+        // fixtureLocalIso like "2025-10-31T20:00" in venue TZ (no Z)
+        const m = fixtureLocalIso.match(/^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})/);
+        if (!m)
+            throw new Error('Bad fixtureLocalIso');
+        const [_, y, M, d, h, mnt] = m;
+        const compact = `${y.slice(2)}${M}${d}${h}${mnt}`; // YYMMDDhhmm as number
+        return (0, _1.b36)(Number(compact)).padStart(5, '0'); // ~5-6 chars
+    }
+    catch (e) {
+        return '';
+    }
+};
+exports.fixtureBlock = fixtureBlock;
+// Random block
+const rndBlock = (len = 3) => {
+    try {
+        // 16-bit random -> base36 3-4 chars
+        const n = (0, node_crypto_1.randomBytes)(2).readUInt16BE(0);
+        return (0, _1.b36)(n).padStart(3, '0').slice(-len);
+    }
+    catch (e) {
+        return '';
+    }
+};
+exports.rndBlock = rndBlock;
+const buildTicketCode = (args) => {
+    try {
+        const VV = args.venueCode.toUpperCase().slice(0, 2);
+        const E = (0, exports.fixtureBlock)(args.fixtureLocalIso); // 5-6 chars
+        const S = (0, exports.seatBlock)(args.sectionId, args.row, args.col, 3); // 3 chars
+        const R = (0, exports.rndBlock)(args.rndLen ?? 3); // 3 chars
+        const body = `${VV}${E}${S}${R}`;
+        const C = (0, _1.luhn36)(body);
+        // Format with dashes for readability (optional)
+        return `${VV}-${E}-${S}-${R}-${C}`;
+    }
+    catch (e) {
+        return '';
+    }
+};
+exports.buildTicketCode = buildTicketCode;
+const validateTicketCode = (code) => {
+    try {
+        const clean = code.replace(/-/g, '').toUpperCase();
+        if (!/^[0-9A-Z]{12,14}$/.test(clean))
+            return false;
+        const body = clean.slice(0, -1);
+        const check = clean.slice(-1);
+        return (0, _1.luhn36)(body) === check;
+    }
+    catch (e) {
+        return false;
+    }
+};
+exports.validateTicketCode = validateTicketCode;
+const getTicketId = ({ fixtureId, sectionName, seatName, }) => `${sectionName}-${seatName}-${fixtureId}`;
+exports.getTicketId = getTicketId;

package/package.json

@@ -1,18 +1,22 @@
 {
   "name": "@ibiliaze/stringman",
-  "version": "3.5.1",
+  "version": "3.7.0",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
     "pub": "npm publish --access public",
-    "git": "git add .; git commit -m 'changes'; git tag -a v3.5.1 -m 'v3.5.1'; git push origin v3.5.1; git push",
+    "git": "git add .; git commit -m 'changes'; git tag -a v3.7.0 -m 'v3.7.0'; git push origin v3.7.0; git push",
     "push": "npm run build; npm run git; npm run pub"
   },
   "author": "Ibi Hasanli",
   "license": "ISC",
+  "dependencies": {
+    "crypto": "^1.0.1"
+  },
   "devDependencies": {
+    "@types/node": "^24.7.2",
     "typescript": "^5.0.0"
   }
 }

package/src/index.ts

@@ -1,3 +1,5 @@
+import { buildTicketCode, fixtureBlock, getTicketId, rndBlock, seatBlock, validateTicketCode } from './ticket';
+
 /**
  * Clean up extra whitespace in a string.
  *
@@ -95,11 +97,8 @@ export const getCloudinaryPublicId = (url: string): string => {
  *   query({ limit: 10, skip: 20, sortBy: 'createdAt:desc', empty: '' });
  *   // → "?limit=10&skip=20&sortBy=createdAt%3Adesc"
  */
-export const query = (q: Record<string, any>): string => {
+export const query = (q: Record<string, any>, filter = ['', null, undefined, 'null', 'undefined']): string => {
   try {
-    // Values considered "invalid" and should be filtered out
-    const filter = ['', null, undefined, 'null', 'undefined'];
-
     // Convert object to entries, filter out invalid keys/values
     const filtered = Object.entries(q).filter(([key, value]) => !filter.includes(key) && !filter.includes(value));
 
@@ -228,16 +227,6 @@ export const getPublicIP = async (): Promise<string> => {
   throw new Error('Public IP unavailable');
 };
 
-export const getTicketId = ({
-  fixtureId,
-  sectionName,
-  seatName,
-}: {
-  fixtureId: string;
-  sectionName: string;
-  seatName: string;
-}) => `${sectionName}-${seatName}-${fixtureId}`;
-
 export const invalidPw = (password: string, passwordLength: number = 8): string | void => {
   try {
     if (password.length < passwordLength) return `Password must be at least ${passwordLength} characters`;
@@ -249,3 +238,49 @@ export const invalidPw = (password: string, passwordLength: number = 8): string
     return 'Failed to validate password';
   }
 };
+
+const BASE36 = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ' as const;
+export const b36 = (n: number) => {
+  try {
+    if (n === 0) return '0';
+    let s = '';
+    let x = Math.floor(Math.abs(n));
+    while (x > 0) {
+      s = BASE36[x % 36] + s;
+      x = Math.floor(x / 36);
+    }
+    return s;
+  } catch (e) {
+    return '';
+  }
+};
+
+export const luhn36 = (s: string): string => {
+  try {
+    let sum = 0;
+    let alt = false;
+    for (let i = s.length - 1; i >= 0; i--) {
+      let v = BASE36.indexOf(s[i].toUpperCase());
+      if (v < 0) continue;
+      if (alt) {
+        v *= 2;
+        v = Math.floor(v / 36) + (v % 36);
+      }
+      sum += v;
+      alt = !alt;
+    }
+    const check = (36 - (sum % 36)) % 36;
+    return BASE36[check];
+  } catch (e) {
+    return '';
+  }
+};
+
+export const ticket = {
+  getTicketId,
+  buildTicketCode,
+  validateTicketCode,
+  rndBlock,
+  fixtureBlock,
+  seatBlock,
+};

package/src/ticket.ts

@@ -0,0 +1,83 @@
+import { createHash, randomBytes } from 'node:crypto';
+import { b36, luhn36 } from '.';
+
+export const seatBlock = (sectionId: string, row: number, col: number, len = 3) => {
+  try {
+    const h = createHash('sha1').update(`${sectionId}:${row}:${col}`).digest(); // 20 bytes
+    // take first 2 bytes -> 0..65535
+    const n = (h[0] << 8) | h[1];
+    const code = b36(n).padStart(3, '0'); // 3 chars base36
+    return code.slice(-len);
+  } catch (e) {
+    return '';
+  }
+};
+
+// Fixture datetime block (local TZ string -> YYMMDDhhmm -> base36)
+export const fixtureBlock = (fixtureLocalIso: string) => {
+  try {
+    // fixtureLocalIso like "2025-10-31T20:00" in venue TZ (no Z)
+    const m = fixtureLocalIso.match(/^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})/);
+    if (!m) throw new Error('Bad fixtureLocalIso');
+    const [_, y, M, d, h, mnt] = m;
+    const compact = `${y.slice(2)}${M}${d}${h}${mnt}`; // YYMMDDhhmm as number
+    return b36(Number(compact)).padStart(5, '0'); // ~5-6 chars
+  } catch (e) {
+    return '';
+  }
+};
+
+// Random block
+export const rndBlock = (len = 3) => {
+  try {
+    // 16-bit random -> base36 3-4 chars
+    const n = randomBytes(2).readUInt16BE(0);
+    return b36(n).padStart(3, '0').slice(-len);
+  } catch (e) {
+    return '';
+  }
+};
+
+export const buildTicketCode = (args: {
+  venueCode: string; // "SB"
+  fixtureLocalIso: string; // "2025-10-31T20:00" in venue TZ
+  sectionId: string;
+  row: number;
+  col: number;
+  rndLen?: number; // 3 or 4
+}) => {
+  try {
+    const VV = args.venueCode.toUpperCase().slice(0, 2);
+    const E = fixtureBlock(args.fixtureLocalIso); // 5-6 chars
+    const S = seatBlock(args.sectionId, args.row, args.col, 3); // 3 chars
+    const R = rndBlock(args.rndLen ?? 3); // 3 chars
+    const body = `${VV}${E}${S}${R}`;
+    const C = luhn36(body);
+    // Format with dashes for readability (optional)
+    return `${VV}-${E}-${S}-${R}-${C}`;
+  } catch (e) {
+    return '';
+  }
+};
+
+export const validateTicketCode = (code: string) => {
+  try {
+    const clean = code.replace(/-/g, '').toUpperCase();
+    if (!/^[0-9A-Z]{12,14}$/.test(clean)) return false;
+    const body = clean.slice(0, -1);
+    const check = clean.slice(-1);
+    return luhn36(body) === check;
+  } catch (e) {
+    return false;
+  }
+};
+
+export const getTicketId = ({
+  fixtureId,
+  sectionName,
+  seatName,
+}: {
+  fixtureId: string;
+  sectionName: string;
+  seatName: string;
+}) => `${sectionName}-${seatName}-${fixtureId}`;