@ibiliaze/stringman 3.7.0 → 3.9.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './seat';
 /**
  * Clean up extra whitespace in a string.
  *
@@ -142,11 +143,7 @@ export declare const invalidPw: (password: string, passwordLength?: number) => s
 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;
+    getTicketId: any;
     buildTicketCode: (args: {
         venueCode: string;
         fixtureLocalIso: string;
@@ -154,9 +151,10 @@ export declare const ticket: {
         row: number;
         col: number;
         rndLen?: number;
+        dashed?: boolean;
     }) => string;
     validateTicketCode: (code: string) => boolean;
-    rndBlock: (len?: number) => string;
-    fixtureBlock: (fixtureLocalIso: string) => string;
-    seatBlock: (sectionId: string, row: number, col: number, len?: number) => string;
+    rndBlock: any;
+    fixtureBlock: any;
+    seatBlock: any;
 };

package/dist/index.js

@@ -1,6 +1,21 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 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;
+__exportStar(require("./seat"), exports);
 const ticket_1 = require("./ticket");
 /**
  * Clean up extra whitespace in a string.

package/dist/seat.d.ts

@@ -0,0 +1,9 @@
+export declare const getSeatRowFromName: (seatName: string) => string;
+export declare const getSeatColFromName: (seatName: string) => string;
+export declare const seatMapKey: (row: number, col: number) => string;
+export declare const getItemId: (fixtureId: string, sectionId: string, seatId: string) => string;
+export declare const getFromItemId: (itemId: string) => {
+    fixtureId: string;
+    sectionId: string;
+    seatId: string;
+};

package/dist/seat.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFromItemId = exports.getItemId = exports.seatMapKey = exports.getSeatColFromName = exports.getSeatRowFromName = void 0;
+const getSeatRowFromName = (seatName) => seatName?.split(':')?.[0];
+exports.getSeatRowFromName = getSeatRowFromName;
+const getSeatColFromName = (seatName) => seatName?.split(':')?.[1];
+exports.getSeatColFromName = getSeatColFromName;
+const seatMapKey = (row, col) => `${row}:${col}`;
+exports.seatMapKey = seatMapKey;
+const getItemId = (fixtureId, sectionId, seatId) => JSON.stringify({ fixtureId, sectionId, seatId });
+exports.getItemId = getItemId;
+const getFromItemId = (itemId) => JSON.parse(itemId);
+exports.getFromItemId = getFromItemId;

package/dist/ticket.d.ts

@@ -1,6 +1,18 @@
-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 luhn10: (digits: string) => string;
+export declare const venueBlockNum: (venueCode: string, len?: number) => string;
+export declare const seatBlockNum: (sectionId: string, row: number, col: number, len?: number) => string;
+export declare const fixtureBlockNum: (fixtureLocalIso: string, len?: number) => string;
+export declare const rndBlockNum: (len?: number) => string;
+export declare const buildTicketCodeNumeric: (args: {
+    venueCode: string;
+    fixtureLocalIso: string;
+    sectionId: string;
+    row: number;
+    col: number;
+    rndLen?: number;
+    dashed?: boolean;
+}) => string;
+export declare const validateTicketCodeNumeric: (code: string) => boolean;
 export declare const buildTicketCode: (args: {
     venueCode: string;
     fixtureLocalIso: string;
@@ -8,10 +20,6 @@ export declare const buildTicketCode: (args: {
     row: number;
     col: number;
     rndLen?: number;
+    dashed?: boolean;
 }) => 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

@@ -1,78 +1,115 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTicketId = exports.validateTicketCode = exports.buildTicketCode = exports.rndBlock = exports.fixtureBlock = exports.seatBlock = void 0;
+exports.validateTicketCode = exports.buildTicketCode = exports.validateTicketCodeNumeric = exports.buildTicketCodeNumeric = exports.rndBlockNum = exports.fixtureBlockNum = exports.seatBlockNum = exports.venueBlockNum = exports.luhn10 = void 0;
 const node_crypto_1 = require("node:crypto");
-const _1 = require(".");
-const seatBlock = (sectionId, row, col, len = 3) => {
+// ---------- helpers ----------
+const pad = (n, len) => n.toString().padStart(len, '0');
+// Luhn mod-10 for digits
+const luhn10 = (digits) => {
+    let sum = 0;
+    let dbl = false;
+    for (let i = digits.length - 1; i >= 0; i--) {
+        let d = digits.charCodeAt(i) - 48; // '0' -> 48
+        if (dbl) {
+            d *= 2;
+            if (d > 9)
+                d -= 9;
+        }
+        sum += d;
+        dbl = !dbl;
+    }
+    const check = (10 - (sum % 10)) % 10;
+    return String(check);
+};
+exports.luhn10 = luhn10;
+// ---------- numeric blocks ----------
+const venueBlockNum = (venueCode, len = 2) => {
     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);
+        // Small, stable hash of the code -> 0..(10^len - 1)
+        const h = (0, node_crypto_1.createHash)('sha1').update(venueCode.toUpperCase()).digest(); // 20 bytes
+        const n = ((h[0] << 8) | h[1]) % 10 ** len;
+        return pad(n, len);
     }
-    catch (e) {
-        return '';
+    catch {
+        return ''.padStart(len, '0');
     }
 };
-exports.seatBlock = seatBlock;
-// Fixture datetime block (local TZ string -> YYMMDDhhmm -> base36)
-const fixtureBlock = (fixtureLocalIso) => {
+exports.venueBlockNum = venueBlockNum;
+const seatBlockNum = (sectionId, row, col, len = 3) => {
     try {
-        // fixtureLocalIso like "2025-10-31T20:00" in venue TZ (no Z)
+        // Hash -> 16-bit -> modulo 10^len
+        const h = (0, node_crypto_1.createHash)('sha1').update(`${sectionId}:${row}:${col}`).digest();
+        const n16 = (h[0] << 8) | h[1];
+        const n = n16 % 10 ** len;
+        return pad(n, len);
+    }
+    catch {
+        return ''.padStart(len, '0');
+    }
+};
+exports.seatBlockNum = seatBlockNum;
+const fixtureBlockNum = (fixtureLocalIso, len = 6) => {
+    try {
+        // Expect "YYYY-MM-DDThh:mm" (local, 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
+        // YYMMDDhhmm is 10 digits; compress to len digits via mod 10^len.
+        const compact = Number(`${y.slice(2)}${M}${d}${h}${mnt}`); // e.g. 2510312000
+        const n = compact % 10 ** len;
+        return pad(n, len);
     }
-    catch (e) {
-        return '';
+    catch {
+        return ''.padStart(len, '0');
     }
 };
-exports.fixtureBlock = fixtureBlock;
-// Random block
-const rndBlock = (len = 3) => {
+exports.fixtureBlockNum = fixtureBlockNum;
+const rndBlockNum = (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);
+        // Uniform cryptographic integer in [0, 10^len)
+        const max = 10 ** len;
+        return pad((0, node_crypto_1.randomInt)(0, max), len);
     }
-    catch (e) {
-        return '';
+    catch {
+        return ''.padStart(len, '0');
     }
 };
-exports.rndBlock = rndBlock;
-const buildTicketCode = (args) => {
+exports.rndBlockNum = rndBlockNum;
+// ---------- builder & validator (numeric-only) ----------
+const buildTicketCodeNumeric = (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)
+        const VV = (0, exports.venueBlockNum)(args.venueCode, 2); // 2 digits
+        const E = (0, exports.fixtureBlockNum)(args.fixtureLocalIso, 6); // 6 digits
+        const S = (0, exports.seatBlockNum)(args.sectionId, args.row, args.col); // 3 digits
+        const R = (0, exports.rndBlockNum)(args.rndLen ?? 3); // 3 digits
+        const body = `${VV}${E}${S}${R}`; // 14 digits
+        const C = (0, exports.luhn10)(body); // 1 digit
+        const numeric = `${body}${C}`; // 15 digits total
+        if (args.dashed === false)
+            return numeric;
+        // Grouping 2-6-3-3-1 for readability
         return `${VV}-${E}-${S}-${R}-${C}`;
     }
-    catch (e) {
+    catch {
         return '';
     }
 };
-exports.buildTicketCode = buildTicketCode;
-const validateTicketCode = (code) => {
+exports.buildTicketCodeNumeric = buildTicketCodeNumeric;
+const validateTicketCodeNumeric = (code) => {
     try {
-        const clean = code.replace(/-/g, '').toUpperCase();
-        if (!/^[0-9A-Z]{12,14}$/.test(clean))
-            return false;
+        const clean = code.replace(/-/g, '');
+        if (!/^\d{15}$/.test(clean))
+            return false; // 2+6+3+3+1
         const body = clean.slice(0, -1);
         const check = clean.slice(-1);
-        return (0, _1.luhn36)(body) === check;
+        return (0, exports.luhn10)(body) === check;
     }
-    catch (e) {
+    catch {
         return false;
     }
 };
-exports.validateTicketCode = validateTicketCode;
-const getTicketId = ({ fixtureId, sectionName, seatName, }) => `${sectionName}-${seatName}-${fixtureId}`;
-exports.getTicketId = getTicketId;
+exports.validateTicketCodeNumeric = validateTicketCodeNumeric;
+// ---------- compatibility shim (if you want same names as before) ----------
+exports.buildTicketCode = exports.buildTicketCodeNumeric;
+exports.validateTicketCode = exports.validateTicketCodeNumeric;

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@ibiliaze/stringman",
-  "version": "3.7.0",
+  "version": "3.9.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.7.0 -m 'v3.7.0'; git push origin v3.7.0; git push",
+    "git": "git add .; git commit -m 'changes'; git tag -a v3.9.0 -m 'v3.9.0'; git push origin v3.9.0; git push",
     "push": "npm run build; npm run git; npm run pub"
   },
   "author": "Ibi Hasanli",

package/src/index.ts

@@ -1,3 +1,4 @@
+export * from './seat';
 import { buildTicketCode, fixtureBlock, getTicketId, rndBlock, seatBlock, validateTicketCode } from './ticket';
 
 /**

package/src/seat.ts

@@ -0,0 +1,10 @@
+export const getSeatRowFromName = (seatName: string) => seatName?.split(':')?.[0];
+export const getSeatColFromName = (seatName: string) => seatName?.split(':')?.[1];
+
+export const seatMapKey = (row: number, col: number) => `${row}:${col}`;
+
+export const getItemId = (fixtureId: string, sectionId: string, seatId: string) =>
+  JSON.stringify({ fixtureId, sectionId, seatId });
+
+export const getFromItemId = (itemId: string): { fixtureId: string; sectionId: string; seatId: string } =>
+  JSON.parse(itemId);

package/src/ticket.ts

@@ -1,83 +1,114 @@
-import { createHash, randomBytes } from 'node:crypto';
-import { b36, luhn36 } from '.';
+import { createHash, randomInt } from 'node:crypto';
 
-export const seatBlock = (sectionId: string, row: number, col: number, len = 3) => {
+// ---------- helpers ----------
+const pad = (n: number, len: number) => n.toString().padStart(len, '0');
+
+// Luhn mod-10 for digits
+export const luhn10 = (digits: string): string => {
+  let sum = 0;
+  let dbl = false;
+  for (let i = digits.length - 1; i >= 0; i--) {
+    let d = digits.charCodeAt(i) - 48; // '0' -> 48
+    if (dbl) {
+      d *= 2;
+      if (d > 9) d -= 9;
+    }
+    sum += d;
+    dbl = !dbl;
+  }
+  const check = (10 - (sum % 10)) % 10;
+  return String(check);
+};
+
+// ---------- numeric blocks ----------
+export const venueBlockNum = (venueCode: string, len = 2) => {
   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 '';
+    // Small, stable hash of the code -> 0..(10^len - 1)
+    const h = createHash('sha1').update(venueCode.toUpperCase()).digest(); // 20 bytes
+    const n = ((h[0] << 8) | h[1]) % 10 ** len;
+    return pad(n, len);
+  } catch {
+    return ''.padStart(len, '0');
   }
 };
 
-// Fixture datetime block (local TZ string -> YYMMDDhhmm -> base36)
-export const fixtureBlock = (fixtureLocalIso: string) => {
+export const seatBlockNum = (sectionId: string, row: number, col: number, len = 3) => {
   try {
-    // fixtureLocalIso like "2025-10-31T20:00" in venue TZ (no Z)
+    // Hash -> 16-bit -> modulo 10^len
+    const h = createHash('sha1').update(`${sectionId}:${row}:${col}`).digest();
+    const n16 = (h[0] << 8) | h[1];
+    const n = n16 % 10 ** len;
+    return pad(n, len);
+  } catch {
+    return ''.padStart(len, '0');
+  }
+};
+
+export const fixtureBlockNum = (fixtureLocalIso: string, len = 6) => {
+  try {
+    // Expect "YYYY-MM-DDThh:mm" (local, 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 '';
+    // YYMMDDhhmm is 10 digits; compress to len digits via mod 10^len.
+    const compact = Number(`${y.slice(2)}${M}${d}${h}${mnt}`); // e.g. 2510312000
+    const n = compact % 10 ** len;
+    return pad(n, len);
+  } catch {
+    return ''.padStart(len, '0');
   }
 };
 
-// Random block
-export const rndBlock = (len = 3) => {
+export const rndBlockNum = (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 '';
+    // Uniform cryptographic integer in [0, 10^len)
+    const max = 10 ** len;
+    return pad(randomInt(0, max), len);
+  } catch {
+    return ''.padStart(len, '0');
   }
 };
 
-export const buildTicketCode = (args: {
-  venueCode: string; // "SB"
+// ---------- builder & validator (numeric-only) ----------
+export const buildTicketCodeNumeric = (args: {
+  venueCode: string; // e.g. "SB"
   fixtureLocalIso: string; // "2025-10-31T20:00" in venue TZ
   sectionId: string;
   row: number;
   col: number;
-  rndLen?: number; // 3 or 4
+  rndLen?: number; // default 3 (use 4 if you want more entropy)
+  dashed?: boolean; // default true (format with dashes)
 }) => {
   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)
+    const VV = venueBlockNum(args.venueCode, 2); // 2 digits
+    const E = fixtureBlockNum(args.fixtureLocalIso, 6); // 6 digits
+    const S = seatBlockNum(args.sectionId, args.row, args.col); // 3 digits
+    const R = rndBlockNum(args.rndLen ?? 3); // 3 digits
+
+    const body = `${VV}${E}${S}${R}`; // 14 digits
+    const C = luhn10(body); // 1 digit
+    const numeric = `${body}${C}`; // 15 digits total
+
+    if (args.dashed === false) return numeric;
+    // Grouping 2-6-3-3-1 for readability
     return `${VV}-${E}-${S}-${R}-${C}`;
-  } catch (e) {
+  } catch {
     return '';
   }
 };
 
-export const validateTicketCode = (code: string) => {
+export const validateTicketCodeNumeric = (code: string) => {
   try {
-    const clean = code.replace(/-/g, '').toUpperCase();
-    if (!/^[0-9A-Z]{12,14}$/.test(clean)) return false;
+    const clean = code.replace(/-/g, '');
+    if (!/^\d{15}$/.test(clean)) return false; // 2+6+3+3+1
     const body = clean.slice(0, -1);
     const check = clean.slice(-1);
-    return luhn36(body) === check;
-  } catch (e) {
+    return luhn10(body) === check;
+  } catch {
     return false;
   }
 };
 
-export const getTicketId = ({
-  fixtureId,
-  sectionName,
-  seatName,
-}: {
-  fixtureId: string;
-  sectionName: string;
-  seatName: string;
-}) => `${sectionName}-${seatName}-${fixtureId}`;
+// ---------- compatibility shim (if you want same names as before) ----------
+export const buildTicketCode = buildTicketCodeNumeric;
+export const validateTicketCode = validateTicketCodeNumeric;