admindb 2.2.1 → 2.3.0

package/dist/data/schema-graph.d.ts

@@ -0,0 +1 @@
+import type {TableInfoData} from '../db/index';import type {ColumnGeneratorConfig,ErChainScope,RelationshipConfig} from './types';export interface SchemaNode{name:string;info:TableInfoData;columns:ColumnGeneratorConfig[];parents:{table:string; from :string;to:string;notnull:boolean;}[];children:{table:string; from :string;to:string;notnull:boolean;}[];hasSelfRef:boolean;isJunction:boolean;depth:number;}export interface SchemaGraph{nodes:Map<string,SchemaNode>;relationships:RelationshipConfig[];}export declare function isJunctionTable(info:TableInfoData):boolean;export declare function buildSchemaGraph(tables:TableInfoData[]):SchemaGraph;export declare function resolveScopeTables(graph:SchemaGraph,rootTable:string,scope?:ErChainScope):SchemaNode[];export declare function sortTopologically(nodes:SchemaNode[]):{sorted:SchemaNode[];cycleDetected:boolean;cycleTables:string[];};

package/dist/data/schema-graph.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isJunctionTable = isJunctionTable;
+exports.buildSchemaGraph = buildSchemaGraph;
+exports.resolveScopeTables = resolveScopeTables;
+exports.sortTopologically = sortTopologically;
+const detector_1 = require("./detector");
+function isJunctionTable(info) {
+    if (info.foreignKeys.length < 2)
+        return false;
+    const fkColumns = new Set(info.foreignKeys.map((fk) => fk.from.toLowerCase()));
+    if (fkColumns.size < 2)
+        return false;
+    const pk = info.primaryKey.map((k) => k.toLowerCase());
+    if (pk.length >= 2 && pk.every((k) => fkColumns.has(k)))
+        return true;
+    for (const ix of info.indexes ?? []) {
+        if (ix.unique && ix.columns.length >= 2) {
+            if (ix.columns.map((c) => c.toLowerCase()).every((c) => fkColumns.has(c))) {
+                return true;
+            }
+        }
+    }
+    if (info.columns.length <= 5 && info.foreignKeys.length >= 2) {
+        const nonFkCols = info.columns.filter((c) => !fkColumns.has(c.name.toLowerCase()) &&
+            !c.pk &&
+            !['created_at', 'updated_at', 'createdat', 'updatedat'].includes(c.name.toLowerCase()));
+        if (nonFkCols.length <= 1)
+            return true;
+    }
+    return false;
+}
+function buildSchemaGraph(tables) {
+    const nodes = new Map();
+    const relationships = [];
+    for (const info of tables) {
+        const columns = (0, detector_1.buildColumnConfigs)(info);
+        const colMap = new Map(info.columns.map((c) => [c.name, c]));
+        const parents = [];
+        let hasSelfRef = false;
+        for (const fk of info.foreignKeys) {
+            const toCol = fk.to || (tables.find((t) => t.table === fk.table)?.primaryKey[0] ?? 'id');
+            if (fk.table === info.table)
+                hasSelfRef = true;
+            const c = colMap.get(fk.from);
+            const notnull = Boolean(c?.notnull || (c?.pk ?? 0) > 0);
+            parents.push({ table: fk.table, from: fk.from, to: toCol, notnull });
+            relationships.push({
+                parentTable: fk.table,
+                parentColumn: toCol,
+                childTable: info.table,
+                childColumn: fk.from,
+                minPerParent: notnull ? 1 : 0,
+                maxPerParent: 5,
+                distribution: 'uniform',
+                nullable: !notnull,
+            });
+        }
+        nodes.set(info.table, {
+            name: info.table,
+            info,
+            columns,
+            parents,
+            children: [],
+            hasSelfRef,
+            isJunction: isJunctionTable(info),
+            depth: 0,
+        });
+    }
+    for (const node of nodes.values()) {
+        for (const p of node.parents) {
+            if (p.table !== node.name && nodes.has(p.table)) {
+                nodes.get(p.table).children.push({
+                    table: node.name,
+                    from: p.from,
+                    to: p.to,
+                    notnull: p.notnull,
+                });
+            }
+        }
+    }
+    return { nodes, relationships };
+}
+function resolveScopeTables(graph, rootTable, scope = 'chain') {
+    if (scope === 'all')
+        return Array.from(graph.nodes.values());
+    const root = graph.nodes.get(rootTable);
+    if (!root)
+        return [];
+    if (scope === 'single')
+        return [root];
+    const selected = new Set([rootTable]);
+    const queue = [rootTable];
+    while (queue.length > 0) {
+        const curr = queue.shift();
+        const node = graph.nodes.get(curr);
+        if (!node)
+            continue;
+        if (scope === 'ancestors' || scope === 'chain') {
+            for (const p of node.parents) {
+                if (p.table !== curr && graph.nodes.has(p.table) && !selected.has(p.table)) {
+                    selected.add(p.table);
+                    queue.push(p.table);
+                }
+            }
+        }
+        if (scope === 'descendants' || scope === 'chain') {
+            for (const c of node.children) {
+                if (c.table !== curr && graph.nodes.has(c.table) && !selected.has(c.table)) {
+                    selected.add(c.table);
+                    queue.push(c.table);
+                }
+            }
+        }
+    }
+    return Array.from(selected).map((name) => graph.nodes.get(name));
+}
+function sortTopologically(nodes) {
+    const activeNames = new Set(nodes.map((n) => n.name));
+    const nodeMap = new Map(nodes.map((n) => [n.name, n]));
+    const totalInDegree = new Map();
+    const hardInDegree = new Map();
+    const allForwardEdges = new Map();
+    const hardForwardEdges = new Map();
+    for (const n of nodes) {
+        totalInDegree.set(n.name, 0);
+        hardInDegree.set(n.name, 0);
+        allForwardEdges.set(n.name, new Set());
+        hardForwardEdges.set(n.name, new Set());
+    }
+    for (const n of nodes) {
+        for (const p of n.parents) {
+            if (p.table !== n.name && activeNames.has(p.table)) {
+                if (!allForwardEdges.get(p.table).has(n.name)) {
+                    allForwardEdges.get(p.table).add(n.name);
+                    totalInDegree.set(n.name, (totalInDegree.get(n.name) ?? 0) + 1);
+                }
+                if (p.notnull && !hardForwardEdges.get(p.table).has(n.name)) {
+                    hardForwardEdges.get(p.table).add(n.name);
+                    hardInDegree.set(n.name, (hardInDegree.get(n.name) ?? 0) + 1);
+                }
+            }
+        }
+    }
+    const queue = [];
+    const visited = new Set();
+    for (const [name, deg] of totalInDegree.entries()) {
+        if (deg === 0) {
+            queue.push(name);
+            visited.add(name);
+        }
+    }
+    const sortedNames = [];
+    const depths = new Map();
+    for (const name of queue)
+        depths.set(name, 0);
+    let cycleDetected = false;
+    const cycleTables = [];
+    while (sortedNames.length < nodes.length) {
+        while (queue.length > 0) {
+            const curr = queue.shift();
+            sortedNames.push(curr);
+            const currDepth = depths.get(curr) ?? 0;
+            for (const child of allForwardEdges.get(curr) ?? []) {
+                const newTotalDeg = (totalInDegree.get(child) ?? 1) - 1;
+                totalInDegree.set(child, newTotalDeg);
+                if (hardForwardEdges.get(curr)?.has(child)) {
+                    hardInDegree.set(child, (hardInDegree.get(child) ?? 1) - 1);
+                }
+                depths.set(child, Math.max(depths.get(child) ?? 0, currDepth + 1));
+                if (newTotalDeg === 0 && !visited.has(child)) {
+                    visited.add(child);
+                    queue.push(child);
+                }
+            }
+        }
+        if (sortedNames.length < nodes.length) {
+            cycleDetected = true;
+            let bestCandidate = '';
+            let lowestHardDeg = Infinity;
+            let lowestTotalDeg = Infinity;
+            for (const n of nodes) {
+                if (!visited.has(n.name)) {
+                    const hDeg = hardInDegree.get(n.name) ?? 0;
+                    const tDeg = totalInDegree.get(n.name) ?? 0;
+                    if (hDeg < lowestHardDeg || (hDeg === lowestHardDeg && tDeg < lowestTotalDeg)) {
+                        lowestHardDeg = hDeg;
+                        lowestTotalDeg = tDeg;
+                        bestCandidate = n.name;
+                    }
+                }
+            }
+            if (bestCandidate) {
+                cycleTables.push(bestCandidate);
+                visited.add(bestCandidate);
+                depths.set(bestCandidate, (depths.get(bestCandidate) ?? 1) + 1);
+                queue.push(bestCandidate);
+            }
+            else {
+                break;
+            }
+        }
+    }
+    const sorted = sortedNames.map((name) => {
+        const node = { ...nodeMap.get(name) };
+        node.depth = depths.get(name) ?? 0;
+        return node;
+    });
+    return { sorted, cycleDetected, cycleTables };
+}

package/dist/data/strategies.d.ts

@@ -1 +1 @@
-import type {ColumnInfo,ForeignKeyInfo} from '../db/index';import{type ColumnPlan,type StrategyDescriptor} from './types';export declare const randInt:(min:number,max:number)=>number;export declare const randFloat:(min:number,max:number)=>number;export declare const pick:<T>(arr:T[])=>T;export declare const makeSlug:()=>string;export declare const makeEmail:(idx?:number)=>string;export declare const makeUsername:(idx?:number)=>string;export declare const makePhone:()=>string;export declare const makeAddress:()=>string;export declare const makeIp:()=>string;export declare function makeMacAddress():string;export declare const makeCreditCard:()=>string;export declare const makeAvatar:(seedVal?:string)=>string;export declare const makeColor:(format?:string)=>string;export declare function makeUuid():string;export declare function makeWords(minLen:number,maxLen:number):string;export declare function makeSentences(minLen:number,maxLen:number):string;export declare const makeParagraph:()=>string;export declare function formatPattern(pattern:string):string;export declare function randomDate( from ?:string,to?:string,kind?:'date'|'datetime'):string;export declare const randomTime:()=>string;export declare function randomUnixTimestamp(format?:string, from ?:string,to?:string):number;export declare function randomAlnum(minLen:number,maxLen:number):string;export declare function makeJsonObject(keys?:string[],jsonValues?:Record<string,string[]>):string;export declare function isTextishType(type:string):boolean;export declare function strategiesFor(col:ColumnInfo,fk:ForeignKeyInfo|null):StrategyDescriptor[];export declare function fallbackPlanFor(col:ColumnInfo):ColumnPlan;export declare function generateOne(col:ColumnInfo,p:ColumnPlan,fkPool?:unknown[],rowIndex?:number):unknown;export declare function generateSampleValue(col:ColumnInfo,plan:ColumnPlan,fkPool?:unknown[]):unknown;
+import type {ColumnInfo,ForeignKeyInfo} from '../db/index';import{isTextishType as regIsTextishType} from './registry';import{type ColumnPlan,type StrategyDescriptor} from './types';export declare const randInt:(min:number,max:number)=>number;export declare const randFloat:(min:number,max:number)=>number;export declare const pick:<T>(arr:readonly T[])=>T;export declare const makeSlug:()=>string;export declare const makeEmail:(idx?:number)=>string;export declare const makeUsername:(idx?:number)=>string;export declare const makePhone:()=>string;export declare const makeAddress:()=>string;export declare const makeIp:()=>string;export declare const makeMacAddress:()=>string;export declare const makeCreditCard:()=>string;export declare const makeAvatar:(seedVal?:string)=>string;export declare const makeColor:(format?:string)=>string;export declare const makeUuid:()=>string;export declare const makeWords:(minLen:number,maxLen:number)=>string;export declare const makeSentences:(minLen:number,maxLen:number)=>string;export declare const makeParagraph:()=>string;export declare const formatPattern:(pattern:string)=>string;export declare const randomDate:( from ?:string,to?:string,kind?:"date"|"datetime")=>string;export declare const randomTime:()=>string;export declare const randomUnixTimestamp:(format?:string, from ?:string,to?:string)=>number;export declare const randomAlnum:(minLen:number,maxLen:number)=>string;export declare const makeJsonObject:(keys?:string[],jsonValues?:Record<string,string[]>)=>string;export declare const isTextishType: typeof regIsTextishType;export declare function strategiesFor(col:ColumnInfo,fk:ForeignKeyInfo|null):StrategyDescriptor[];export declare function fallbackPlanFor(col:ColumnInfo):ColumnPlan;export declare function generateOne(col:ColumnInfo,plan:ColumnPlan,fkPool?:unknown[],rowIndex?:number):unknown;export declare function generateSampleValue(col:ColumnInfo,plan:ColumnPlan,fkPool?:unknown[]):unknown;

package/dist/data/strategies.js

@@ -1,224 +1,63 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomTime = exports.makeParagraph = exports.makeColor = exports.makeAvatar = exports.makeCreditCard = exports.makeIp = exports.makeAddress = exports.makePhone = exports.makeUsername = exports.makeEmail = exports.makeSlug = exports.pick = exports.randFloat = exports.randInt = void 0;
-exports.makeMacAddress = makeMacAddress;
-exports.makeUuid = makeUuid;
-exports.makeWords = makeWords;
-exports.makeSentences = makeSentences;
-exports.formatPattern = formatPattern;
-exports.randomDate = randomDate;
-exports.randomUnixTimestamp = randomUnixTimestamp;
-exports.randomAlnum = randomAlnum;
-exports.makeJsonObject = makeJsonObject;
-exports.isTextishType = isTextishType;
+exports.isTextishType = exports.makeJsonObject = exports.randomAlnum = exports.randomUnixTimestamp = exports.randomTime = exports.randomDate = exports.formatPattern = exports.makeParagraph = exports.makeSentences = exports.makeWords = exports.makeUuid = exports.makeColor = exports.makeAvatar = exports.makeCreditCard = exports.makeMacAddress = exports.makeIp = exports.makeAddress = exports.makePhone = exports.makeUsername = exports.makeEmail = exports.makeSlug = exports.pick = exports.randFloat = exports.randInt = void 0;
 exports.strategiesFor = strategiesFor;
 exports.fallbackPlanFor = fallbackPlanFor;
 exports.generateOne = generateOne;
 exports.generateSampleValue = generateSampleValue;
-const node_crypto_1 = require("node:crypto");
-const common_1 = require("../utils/common");
-const datasets_1 = require("./datasets");
+const prng_1 = require("./prng");
+const registry_1 = require("./registry");
 const types_1 = require("./types");
-const randInt = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
+const defaultPrng = (0, prng_1.createPrng)();
+const randInt = (min, max) => defaultPrng.int(min, max);
 exports.randInt = randInt;
-const randFloat = (min, max) => Math.random() * (max - min) + min;
+const randFloat = (min, max) => defaultPrng.float(min, max);
 exports.randFloat = randFloat;
-const pick = (arr) => arr[(0, exports.randInt)(0, arr.length - 1)];
+const pick = (arr) => defaultPrng.pick(arr);
 exports.pick = pick;
-const makeSlug = () => `${(0, exports.pick)(datasets_1.LOREM_WORDS)}-${(0, exports.pick)(datasets_1.LOREM_WORDS)}-${(0, exports.randInt)(100, 999)}`;
+const makeSlug = () => (0, registry_1.makeSlug)(defaultPrng);
 exports.makeSlug = makeSlug;
-const makeEmail = (idx) => `${(0, exports.pick)(datasets_1.FIRST_NAMES).toLowerCase()}.${(0, exports.pick)(datasets_1.LAST_NAMES).toLowerCase()}${idx != null ? idx + 1 : ''}${(0, exports.randInt)(10, 9999)}@${(0, exports.pick)(datasets_1.DOMAINS)}`;
+const makeEmail = (idx) => (0, registry_1.makeEmail)(defaultPrng, idx);
 exports.makeEmail = makeEmail;
-const makeUsername = (idx) => `${(0, exports.pick)(datasets_1.FIRST_NAMES).toLowerCase()}${(0, exports.pick)(datasets_1.LAST_NAMES).toLowerCase()}${idx != null ? idx + 1 : ''}${(0, exports.randInt)(10, 9999)}`;
+const makeUsername = (idx) => (0, registry_1.makeUsername)(defaultPrng, idx);
 exports.makeUsername = makeUsername;
-const makePhone = () => `+1 (${(0, exports.randInt)(200, 999)}) ${(0, exports.randInt)(200, 999)}-${String((0, exports.randInt)(0, 9999)).padStart(4, '0')}`;
+const makePhone = () => (0, registry_1.makePhone)(defaultPrng);
 exports.makePhone = makePhone;
-const makeAddress = () => `${(0, exports.randInt)(10, 9999)} ${(0, exports.pick)(datasets_1.LOREM_WORDS)} ${(0, exports.pick)(['St', 'Ave', 'Rd', 'Blvd', 'Ln', 'Dr'])}, ${(0, exports.pick)(datasets_1.CITIES)}`;
+const makeAddress = () => (0, registry_1.makeAddress)(defaultPrng);
 exports.makeAddress = makeAddress;
-const makeIp = () => `${(0, exports.randInt)(1, 223)}.${(0, exports.randInt)(0, 255)}.${(0, exports.randInt)(0, 255)}.${(0, exports.randInt)(1, 254)}`;
+const makeIp = () => (0, registry_1.makeIp)(defaultPrng);
 exports.makeIp = makeIp;
-function makeMacAddress() {
-    const b = () => (0, exports.randInt)(0, 255).toString(16).padStart(2, '0').toUpperCase();
-    return `${b()}:${b()}:${b()}:${b()}:${b()}:${b()}`;
-}
-const makeCreditCard = () => `4532-${(0, exports.randInt)(1000, 9999)}-${(0, exports.randInt)(1000, 9999)}-${(0, exports.randInt)(1000, 9999)}`;
+const makeMacAddress = () => (0, registry_1.makeMacAddress)(defaultPrng);
+exports.makeMacAddress = makeMacAddress;
+const makeCreditCard = () => (0, registry_1.makeCreditCard)(defaultPrng);
 exports.makeCreditCard = makeCreditCard;
-const makeAvatar = (seedVal) => `https://api.dicebear.com/7.x/avataaars/svg?seed=${encodeURIComponent(seedVal || (0, exports.makeUsername)())}`;
+const makeAvatar = (seedVal) => (0, registry_1.makeAvatar)(defaultPrng, seedVal);
 exports.makeAvatar = makeAvatar;
-const makeColor = (format = 'hex') => (format === 'name' ? (0, exports.pick)(datasets_1.NAMED_COLORS) : (0, exports.pick)(datasets_1.HEX_COLORS));
+const makeColor = (format = 'hex') => (0, registry_1.makeColor)(defaultPrng, format);
 exports.makeColor = makeColor;
-function makeUuid() {
-    const h = (n) => (0, exports.randInt)(0, 0xffffffff).toString(16).padStart(n, '0');
-    return `${h(8)}-${h(4).slice(0, 4)}-4${h(3).slice(0, 3)}-${['8', '9', 'a', 'b'][(0, exports.randInt)(0, 3)]}${h(3).slice(0, 3)}-${h(12).slice(0, 12)}`;
-}
-function makeWords(minLen, maxLen) {
-    const n = (0, exports.randInt)(minLen, maxLen);
-    const parts = [];
-    for (let i = 0; i < n; i++)
-        parts.push((0, exports.pick)(datasets_1.LOREM_WORDS));
-    return parts.join(' ');
-}
-function makeSentences(minLen, maxLen) {
-    const n = (0, exports.randInt)(minLen, maxLen);
-    const sentences = [];
-    for (let i = 0; i < n; i++) {
-        const words = makeWords(6, 14).split(' ');
-        words[0] = words[0].charAt(0).toUpperCase() + words[0].slice(1);
-        sentences.push(words.join(' ') + '.');
-    }
-    return sentences.join(' ');
-}
-const makeParagraph = () => makeSentences(3, 5);
+const makeUuid = () => (0, registry_1.makeUuid)(defaultPrng);
+exports.makeUuid = makeUuid;
+const makeWords = (minLen, maxLen) => (0, registry_1.makeWords)(defaultPrng, minLen, maxLen);
+exports.makeWords = makeWords;
+const makeSentences = (minLen, maxLen) => (0, registry_1.makeSentences)(defaultPrng, minLen, maxLen);
+exports.makeSentences = makeSentences;
+const makeParagraph = () => (0, registry_1.makeParagraph)(defaultPrng);
 exports.makeParagraph = makeParagraph;
-function formatPattern(pattern) {
-    if (!pattern)
-        return '';
-    const now = new Date();
-    const year = String(now.getFullYear());
-    const s = pattern
-        .replace(/\{YYYY\}/g, year)
-        .replace(/\{YY\}/g, year.slice(-2))
-        .replace(/\{MM\}/g, String((0, exports.randInt)(1, 12)).padStart(2, '0'))
-        .replace(/\{DD\}/g, String((0, exports.randInt)(1, 28)).padStart(2, '0'));
-    const upper = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
-    const lower = 'abcdefghijklmnopqrstuvwxyz';
-    let res = '';
-    for (let i = 0; i < s.length; i++) {
-        const ch = s[i];
-        if (ch === '#')
-            res += (0, exports.randInt)(0, 9);
-        else if (ch === 'A' || ch === '?')
-            res += upper[(0, exports.randInt)(0, 25)];
-        else if (ch === 'a')
-            res += lower[(0, exports.randInt)(0, 25)];
-        else
-            res += ch;
-    }
-    return res;
-}
-function randomDate(from, to, kind = 'date') {
-    const now = Date.now();
-    const lo = from ? Date.parse(from) : now - 730 * 86400_000;
-    const hi = to ? Date.parse(to) : now;
-    const d = new Date((0, exports.randInt)(Number.isFinite(lo) ? lo : now - 730 * 86400_000, Number.isFinite(hi) ? hi : now));
-    if (kind === 'datetime')
-        return d.toISOString();
-    const p = (n) => String(n).padStart(2, '0');
-    return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
-}
-const randomTime = () => `${String((0, exports.randInt)(0, 23)).padStart(2, '0')}:${String((0, exports.randInt)(0, 59)).padStart(2, '0')}:${String((0, exports.randInt)(0, 59)).padStart(2, '0')}`;
+const formatPattern = (pattern) => (0, registry_1.formatPattern)(pattern, defaultPrng);
+exports.formatPattern = formatPattern;
+const randomDate = (from, to, kind = 'date') => (0, registry_1.randomDate)(defaultPrng, from, to, kind);
+exports.randomDate = randomDate;
+const randomTime = () => (0, registry_1.randomTime)(defaultPrng);
 exports.randomTime = randomTime;
-function randomUnixTimestamp(format = 'sec', from, to) {
-    const now = Date.now();
-    const lo = from ? Date.parse(from) : now - 730 * 86400_000;
-    const hi = to ? Date.parse(to) : now;
-    const t = (0, exports.randInt)(Number.isFinite(lo) ? lo : now - 730 * 86400_000, Number.isFinite(hi) ? hi : now);
-    return format === 'ms' ? t : Math.floor(t / 1000);
-}
-const ALNUM = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
-function randomAlnum(minLen, maxLen) {
-    const len = (0, exports.randInt)(minLen, maxLen);
-    let s = '';
-    for (let i = 0; i < len; i++)
-        s += ALNUM[(0, exports.randInt)(0, ALNUM.length - 1)];
-    return s;
-}
-const JSON_ROLES = ['admin', 'editor', 'viewer', 'billing', 'member', 'owner', 'guest'];
-const JSON_APPS = ['dashboard', 'api', 'mobile', 'cli', 'webhook', 'cron', 'importer'];
-function jsonValueForKey(key) {
-    const lk = key.toLowerCase();
-    if (lk.includes('role'))
-        return (0, exports.pick)(JSON_ROLES);
-    if (lk.includes('app'))
-        return [(0, exports.pick)(JSON_APPS)];
-    const roll = Math.random();
-    if (roll < 0.45)
-        return (0, exports.pick)(['alpha', 'beta', 'stable', 'draft', 'on', 'off', 'default', 'custom']);
-    if (roll < 0.6)
-        return (0, exports.randInt)(0, 1000);
-    if (roll < 0.75)
-        return Math.random() < 0.5;
-    if (roll < 0.9)
-        return null;
-    return makeUuid();
-}
-function makeJsonObject(keys, jsonValues) {
-    const k = (keys && keys.length ? keys : ['scope', 'enabled', 'flags']).slice(0, 16);
-    const obj = {};
-    for (const key of k) {
-        const allowed = jsonValues ? jsonValues[key] : undefined;
-        obj[key] = allowed && allowed.length ? (0, exports.pick)(allowed) : jsonValueForKey(key);
-    }
-    return JSON.stringify(obj);
-}
-function isTextishType(type) {
-    const t = (type || '').toUpperCase();
-    return t === 'TEXT' || t === '' || t.includes('JSON') || t.includes('CHAR') || t.includes('CLOB') || t.includes('VARCHAR');
-}
-const STRATEGY_METADATA = [
-    ['skip', 'Skip (DB default or NULL applies)', 'custom_control', 'all'],
-    ['null', 'Set NULL explicitly', 'custom_control', 'all'],
-    ['fixed', 'Fixed constant value', 'custom_control', 'all'],
-    ['list', 'Random item from custom list', 'custom_control', 'all'],
-    ['pattern', 'Custom pattern template (e.g. INV-####)', 'custom_control', 'all'],
-    ['fullname', 'Full name (e.g. John Smith)', 'identity', 'text'],
-    ['first', 'First name', 'identity', 'text'],
-    ['last', 'Last name / Surname', 'identity', 'text'],
-    ['username', 'Username handle', 'identity', 'text'],
-    ['job', 'Job title / Profession', 'identity', 'text'],
-    ['email', 'Email address', 'contact_web', 'text'],
-    ['phone', 'Phone number', 'contact_web', 'text'],
-    ['url', 'Website URL', 'contact_web', 'text'],
-    ['domain', 'Domain name', 'contact_web', 'text'],
-    ['ip', 'IPv4 address', 'contact_web', 'text'],
-    ['avatar', 'Avatar image URL', 'contact_web', 'text'],
-    ['company', 'Company / Organization name', 'commerce', 'text'],
-    ['currency', 'Currency code (USD, EUR...)', 'commerce', 'text'],
-    ['status', 'Status badge (active, pending...)', 'commerce', 'text'],
-    ['creditCard', 'Masked test credit card', 'commerce', 'text'],
-    ['address', 'Street address', 'location', 'text'],
-    ['city', 'City name', 'location', 'text'],
-    ['state', 'State / Province', 'location', 'text'],
-    ['country', 'Country name', 'location', 'text'],
-    ['countryCode', 'Country code (ISO-2 e.g. US)', 'location', 'text'],
-    ['postal', 'Postal / Zip code', 'location', 'text'],
-    ['latitude', 'Latitude (-90 to 90)', 'location', 'all'],
-    ['longitude', 'Longitude (-180 to 180)', 'location', 'all'],
-    ['int', 'Random integer in range', 'numeric', 'numeric'],
-    ['decimal', 'Random decimal / price', 'numeric', 'numeric'],
-    ['sequence', 'Sequential numbering (1, 2, 3...)', 'numeric', 'numeric'],
-    ['date', 'Random date (YYYY-MM-DD)', 'datetime', 'all'],
-    ['datetime', 'Random datetime (ISO-8601)', 'datetime', 'all'],
-    ['time', 'Random time (HH:MM:SS)', 'datetime', 'all'],
-    ['timestampUnix', 'Unix timestamp (epoch)', 'datetime', 'all'],
-    ['words', 'Short words / Tags', 'system_crypto', 'text'],
-    ['sentence', 'Sentences', 'system_crypto', 'text'],
-    ['paragraph', 'Paragraph (multi-sentence text)', 'system_crypto', 'text'],
-    ['slug', 'URL slug (e.g. tech-news-402)', 'system_crypto', 'text'],
-    ['bool', 'Boolean flag (1/0 or true/false)', 'system_crypto', 'all'],
-    ['bytes', 'Random hex bytes (BLOB)', 'system_crypto', 'blob'],
-    ['uuid', 'UUID v4', 'system_crypto', 'text'],
-    ['token', 'Short alphanumeric token', 'system_crypto', 'text'],
-    ['hash', 'Hexadecimal hash (MD5/SHA)', 'system_crypto', 'text'],
-    ['json', 'Valid JSON object', 'system_crypto', 'text'],
-    ['color', 'Color (Hex code or name)', 'system_crypto', 'text'],
-    ['mac', 'MAC network address', 'system_crypto', 'text'],
-];
+const randomUnixTimestamp = (format = 'sec', from, to) => (0, registry_1.randomUnixTimestamp)(defaultPrng, format, from, to);
+exports.randomUnixTimestamp = randomUnixTimestamp;
+const randomAlnum = (minLen, maxLen) => (0, registry_1.randomAlnum)(defaultPrng, minLen, maxLen);
+exports.randomAlnum = randomAlnum;
+const makeJsonObject = (keys, jsonValues) => (0, registry_1.makeJsonObject)(defaultPrng, keys, jsonValues);
+exports.makeJsonObject = makeJsonObject;
+exports.isTextishType = registry_1.isTextishType;
 function strategiesFor(col, fk) {
-    const type = (col.type || '').toUpperCase();
-    const isText = isTextishType(type);
-    const isNum = type.startsWith('INTEGER') || type === 'REAL' || type.includes('DECIMAL') || type.includes('NUMERIC') || isText;
-    const isBlob = type === 'BLOB' || isText;
-    const out = [];
-    if (fk) {
-        out.push({ id: 'fk', label: `Foreign Key: Sample from ${fk.table}${fk.to ? `.${fk.to}` : ''}`, category: 'relational' });
-    }
-    for (const [id, label, category, target] of STRATEGY_METADATA) {
-        if (target === 'all' || (target === 'text' && isText) || (target === 'numeric' && isNum) || (target === 'blob' && isBlob)) {
-            out.push({ id, label, category });
-        }
-    }
-    return out;
+    return registry_1.GeneratorRegistry.getDescriptorsFor(col, fk);
 }
 function fallbackPlanFor(col) {
     const type = (col.type || '').toUpperCase();
@@ -228,10 +67,12 @@ function fallbackPlanFor(col) {
         return { strategy: 'uuid' };
     if (type === 'JSON' || type === 'JSONB')
         return { strategy: 'json' };
-    if (type.startsWith('INT') || type === 'BIGINT' || type === 'SMALLINT' || type === 'SERIAL' || type === 'BIGSERIAL')
+    if (type.startsWith('INT') || type === 'BIGINT' || type === 'SMALLINT' || type === 'SERIAL' || type === 'BIGSERIAL') {
         return { strategy: 'int', min: 1, max: 1000 };
-    if (type === 'REAL' || type.includes('DECIMAL') || type === 'NUMERIC' || type.includes('FLOAT') || type.includes('DOUBLE'))
+    }
+    if (type === 'REAL' || type.includes('DECIMAL') || type === 'NUMERIC' || type.includes('FLOAT') || type.includes('DOUBLE')) {
         return { strategy: 'decimal', min: 1, max: 1000, precision: 2 };
+    }
     if (type === 'DATE')
         return { strategy: 'date', from: '2020-01-01', to: '2026-12-31' };
     if (type.includes('TIMESTAMP') || type === 'DATETIME')
@@ -244,88 +85,8 @@ function fallbackPlanFor(col) {
         return { strategy: 'ip' };
     return { strategy: 'words', minLen: 1, maxLen: 4 };
 }
-const BASIC_STRATEGIES = {
-    first: () => (0, exports.pick)(datasets_1.FIRST_NAMES),
-    last: () => (0, exports.pick)(datasets_1.LAST_NAMES),
-    fullname: () => `${(0, exports.pick)(datasets_1.FIRST_NAMES)} ${(0, exports.pick)(datasets_1.LAST_NAMES)}`,
-    email: (_, idx) => (0, exports.makeEmail)(idx),
-    username: (_, idx) => (0, exports.makeUsername)(idx),
-    job: () => (0, exports.pick)(datasets_1.JOB_TITLES),
-    company: () => (0, exports.pick)(datasets_1.COMPANIES),
-    currency: () => (0, exports.pick)(datasets_1.CURRENCIES),
-    status: () => (0, exports.pick)(datasets_1.STATUSES),
-    creditCard: () => (0, exports.makeCreditCard)(),
-    avatar: () => (0, exports.makeAvatar)(),
-    color: (p) => (0, exports.makeColor)(p.format),
-    phone: () => (0, exports.makePhone)(),
-    city: () => (0, exports.pick)(datasets_1.CITIES),
-    state: () => (0, exports.pick)(datasets_1.US_STATES),
-    country: () => (0, exports.pick)(datasets_1.COUNTRIES),
-    countryCode: () => (0, exports.pick)(datasets_1.COUNTRY_CODES),
-    postal: () => String((0, exports.randInt)(10000, 99999)),
-    address: () => (0, exports.makeAddress)(),
-    url: () => `https://www.${(0, exports.pick)(datasets_1.DOMAINS)}/${(0, exports.makeSlug)()}`,
-    domain: () => (0, exports.pick)(datasets_1.DOMAINS),
-    ip: () => (0, exports.makeIp)(),
-    mac: () => makeMacAddress(),
-    uuid: () => makeUuid(),
-    slug: () => (0, exports.makeSlug)(),
-    paragraph: () => (0, exports.makeParagraph)(),
-    time: () => (0, exports.randomTime)(),
-    bool: () => (0, exports.pick)(['1', '0']),
-    json: (p) => makeJsonObject(p.jsonKeys, p.jsonValues),
-    words: (p) => makeWords(p.minLen ?? 1, p.maxLen ?? 4),
-    sentence: (p) => makeSentences(p.minLen ?? 1, p.maxLen ?? 2),
-    date: (p) => randomDate(p.from, p.to, 'date'),
-    datetime: (p) => randomDate(p.from, p.to, 'datetime'),
-    timestampUnix: (p) => randomUnixTimestamp(p.format, p.from, p.to),
-    latitude: (p) => Number((0, exports.randFloat)(p.min ?? -90, p.max ?? 90).toFixed(6)),
-    longitude: (p) => Number((0, exports.randFloat)(p.min ?? -180, p.max ?? 180).toFixed(6)),
-    sequence: (p, idx) => (p.start ?? 1) + idx * (p.step ?? 1),
-    int: (p) => (0, exports.randInt)(p.min ?? 1, Math.max(p.min ?? 1, p.max ?? 1000)),
-    decimal: (p) => (0, exports.randFloat)(p.min ?? 1, Math.max(p.min ?? 1, p.max ?? 1000)).toFixed(Math.max(0, Math.min(10, p.precision ?? 2))),
-    pattern: (p) => formatPattern(p.pattern || 'INV-2026-####'),
-    fixed: (p) => p.value ?? '',
-    token: (p) => randomAlnum(Math.max(2, p.minLen ?? 6), Math.max(2, p.maxLen ?? 12)),
-    hash: (p) => {
-        const len = (0, exports.randInt)(Math.max(8, p.minLen ?? 32), Math.max(8, p.maxLen ?? 64));
-        return (0, node_crypto_1.randomBytes)(Math.ceil(len / 2)).toString('hex').slice(0, len);
-    },
-};
-function generateOne(col, p, fkPool, rowIndex = 0) {
-    const type = (col.type || '').toUpperCase();
-    if (!col.pk && !col.notnull && p.nullPct && p.nullPct > 0) {
-        if (Math.random() * 100 < p.nullPct)
-            return null;
-    }
-    if (p.strategy === 'skip')
-        return types_1.SKIP;
-    if (p.strategy === 'null')
-        return null;
-    if (p.strategy === 'list') {
-        const vals = (p.values ?? []).filter((v) => String(v).trim() !== '');
-        if (!vals.length)
-            return types_1.SKIP;
-        return (0, common_1.coerceFormValue)(String((0, exports.pick)(vals)), type || 'TEXT');
-    }
-    if (p.strategy === 'fk') {
-        return fkPool && fkPool.length ? fkPool[(0, exports.randInt)(0, fkPool.length - 1)] : null;
-    }
-    if (p.strategy === 'bytes') {
-        const len = (0, exports.randInt)(Math.max(0, p.minLen ?? 8), Math.max(1, p.maxLen ?? 32));
-        const buf = Buffer.alloc(len);
-        for (let i = 0; i < len; i++)
-            buf[i] = (0, exports.randInt)(0, 255);
-        return (0, common_1.coerceFormValue)(`0x${buf.toString('hex')}`, type || 'BLOB');
-    }
-    const gen = BASIC_STRATEGIES[p.strategy];
-    if (!gen)
-        return types_1.SKIP;
-    let rawVal = gen(p, rowIndex);
-    if (rawVal != null && (p.prefix || p.suffix) && typeof rawVal === 'string') {
-        rawVal = `${p.prefix || ''}${rawVal}${p.suffix || ''}`;
-    }
-    return (0, common_1.coerceFormValue)(String(rawVal), type || 'TEXT');
+function generateOne(col, plan, fkPool, rowIndex = 0) {
+    return (0, registry_1.generateColumnValue)(col, plan, defaultPrng, rowIndex, {}, fkPool);
 }
 function generateSampleValue(col, plan, fkPool) {
     const v = generateOne(col, plan, fkPool || ['[FK sample]'], 0);

package/dist/data/templates.d.ts

@@ -0,0 +1 @@
+import type {RandomSource} from './prng';import type {ColumnPlan} from './types';export declare function extractTemplateDependencies(template:string):string[];export declare function evaluateTemplate(template:string,rowValues:Record<string,unknown>,prng:RandomSource,rowIndex?:number):string;export declare function orderColumnDependencies(columnNames:string[],plans:Record<string,ColumnPlan>):{orderedColumns:string[];hasCycle:boolean;cycleColumns:string[];};