admindb 2.1.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:()=>string;export declare const makeUsername:()=>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 +1,100 @@
-Object.defineProperty(exports,"__esModule",{value:!0}),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.strategiesFor=function(col,fk){const type=(col.type||"").toUpperCase(),isText=isTextishType(type),isNum=type.startsWith("INTEGER")||"REAL"===type||type.includes("DECIMAL")||type.includes("NUMERIC")||isText,isBlob="BLOB"===type||isText,out=[];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)("all"===target||"text"===target&&isText||"numeric"===target&&isNum||"blob"===target&&isBlob)&&out.push({id:id,label:label,category:category});return out},exports.fallbackPlanFor=function(col){const type=(col.type||"").toUpperCase();return"BOOLEAN"===type||"BOOL"===type?{strategy:"bool"}:"UUID"===type?{strategy:"uuid"}:"JSON"===type||"JSONB"===type?{strategy:"json"}:type.startsWith("INT")||"BIGINT"===type||"SMALLINT"===type||"SERIAL"===type||"BIGSERIAL"===type?{strategy:"int",min:1,max:1e3}:"REAL"===type||type.includes("DECIMAL")||"NUMERIC"===type||type.includes("FLOAT")||type.includes("DOUBLE")?{strategy:"decimal",min:1,max:1e3,precision:2}:"DATE"===type?{strategy:"date",from:"2020-01-01",to:"2026-12-31"}:type.includes("TIMESTAMP")||"DATETIME"===type?{strategy:"datetime",from:"2024-01-01T00:00:00",to:"2026-12-31T23:59:59"}:"TIME"===type?{strategy:"time"}:"BLOB"===type||"BYTEA"===type?{strategy:"bytes",minLen:8,maxLen:32}:"INET"===type?{strategy:"ip"}:{strategy:"words",minLen:1,maxLen:4}},exports.generateOne=generateOne,exports.generateSampleValue=function(col,plan,fkPool){const v=generateOne(col,plan,fkPool||["[FK sample]"],0);return v===types_1.SKIP?"(omitted / default)":null===v?"NULL":v instanceof Uint8Array||Buffer.isBuffer(v)?`0x${Buffer.from(v).toString("hex").slice(0,16)}...`:v};const node_crypto_1=require("node:crypto"),common_1=require("../utils/common"),datasets_1=require("./datasets"),types_1=require("./types");exports.randInt=(min,max)=>Math.floor(Math.random()*(max-min+1))+min;exports.randFloat=(min,max)=>Math.random()*(max-min)+min;exports.pick=arr=>arr[(0,exports.randInt)(0,arr.length-1)];exports.makeSlug=()=>`${(0,exports.pick)(datasets_1.LOREM_WORDS)}-${(0,exports.pick)(datasets_1.LOREM_WORDS)}-${(0,exports.randInt)(100,999)}`;exports.makeEmail=()=>`${(0,exports.pick)(datasets_1.FIRST_NAMES).toLowerCase()}.${(0,exports.pick)(datasets_1.LAST_NAMES).toLowerCase()}${(0,exports.randInt)(1,99)}@${(0,exports.pick)(datasets_1.DOMAINS)}`;exports.makeUsername=()=>`${(0,exports.pick)(datasets_1.FIRST_NAMES).toLowerCase()}${(0,exports.pick)(datasets_1.LAST_NAMES).toLowerCase()}${(0,exports.randInt)(1,9999)}`;exports.makePhone=()=>`+1 (${(0,exports.randInt)(200,999)}) ${(0,exports.randInt)(200,999)}-${String((0,exports.randInt)(0,9999)).padStart(4,"0")}`;exports.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)}`;function makeMacAddress(){const b=()=>(0,exports.randInt)(0,255).toString(16).padStart(2,"0").toUpperCase();return`${b()}:${b()}:${b()}:${b()}:${b()}:${b()}`}exports.makeIp=()=>`${(0,exports.randInt)(1,223)}.${(0,exports.randInt)(0,255)}.${(0,exports.randInt)(0,255)}.${(0,exports.randInt)(1,254)}`;exports.makeCreditCard=()=>`4532-${(0,exports.randInt)(1e3,9999)}-${(0,exports.randInt)(1e3,9999)}-${(0,exports.randInt)(1e3,9999)}`;exports.makeAvatar=seedVal=>`https://api.dicebear.com/7.x/avataaars/svg?seed=${encodeURIComponent(seedVal||(0,exports.makeUsername)())}`;function makeUuid(){const h=n=>(0,exports.randInt)(0,4294967295).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),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),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(" ")}exports.makeColor=(format="hex")=>"name"===format?(0,exports.pick)(datasets_1.NAMED_COLORS):(0,exports.pick)(datasets_1.HEX_COLORS);function formatPattern(pattern){if(!pattern)return"";const now=new Date,year=String(now.getFullYear()),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"));let res="";for(let i=0;i<s.length;i++){const ch=s[i];res+="#"===ch?(0,exports.randInt)(0,9):"A"===ch||"?"===ch?"ABCDEFGHIJKLMNOPQRSTUVWXYZ"[(0,exports.randInt)(0,25)]:"a"===ch?"abcdefghijklmnopqrstuvwxyz"[(0,exports.randInt)(0,25)]:ch}return res}function randomDate(from,to,kind="date"){const now=Date.now(),lo=from?Date.parse(from):now-63072e6,hi=to?Date.parse(to):now,d=new Date((0,exports.randInt)(Number.isFinite(lo)?lo:now-63072e6,Number.isFinite(hi)?hi:now));if("datetime"===kind)return d.toISOString();const p=n=>String(n).padStart(2,"0");return`${d.getFullYear()}-${p(d.getMonth()+1)}-${p(d.getDate())}`}exports.makeParagraph=()=>makeSentences(3,5);function randomUnixTimestamp(format="sec",from,to){const now=Date.now(),lo=from?Date.parse(from):now-63072e6,hi=to?Date.parse(to):now,t=(0,exports.randInt)(Number.isFinite(lo)?lo:now-63072e6,Number.isFinite(hi)?hi:now);return"ms"===format?t:Math.floor(t/1e3)}exports.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 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"],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();return roll<.45?(0,exports.pick)(["alpha","beta","stable","draft","on","off","default","custom"]):roll<.6?(0,exports.randInt)(0,1e3):roll<.75?Math.random()<.5:roll<.9?null:makeUuid()}function makeJsonObject(keys,jsonValues){const k=(keys&&keys.length?keys:["scope","enabled","flags"]).slice(0,16),obj={};for(const key of k){const allowed=jsonValues?jsonValues[key]:void 0;obj[key]=allowed&&allowed.length?(0,exports.pick)(allowed):jsonValueForKey(key)}return JSON.stringify(obj)}function isTextishType(type){const t=(type||"").toUpperCase();return"TEXT"===t||""===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 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:()=>(0,exports.makeEmail)(),username:()=>(0,exports.makeUsername)(),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)(1e4,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??1e3)),decimal:p=>(0,exports.randFloat)(p.min??1,Math.max(p.min??1,p.max??1e3)).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&&100*Math.random()<p.nullPct)return null;if("skip"===p.strategy)return types_1.SKIP;if("null"===p.strategy)return null;if("list"===p.strategy){const vals=(p.values??[]).filter(v=>""!==String(v).trim());return vals.length?(0,common_1.coerceFormValue)(String((0,exports.pick)(vals)),type||"TEXT"):types_1.SKIP}if("fk"===p.strategy)return fkPool&&fkPool.length?fkPool[(0,exports.randInt)(0,fkPool.length-1)]:null;if("bytes"===p.strategy){const len=(0,exports.randInt)(Math.max(0,p.minLen??8),Math.max(1,p.maxLen??32)),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);return null!=rawVal&&(p.prefix||p.suffix)&&"string"==typeof rawVal&&(rawVal=`${p.prefix||""}${rawVal}${p.suffix||""}`),(0,common_1.coerceFormValue)(String(rawVal),type||"TEXT")}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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 prng_1 = require("./prng");
+const registry_1 = require("./registry");
+const types_1 = require("./types");
+const defaultPrng = (0, prng_1.createPrng)();
+const randInt = (min, max) => defaultPrng.int(min, max);
+exports.randInt = randInt;
+const randFloat = (min, max) => defaultPrng.float(min, max);
+exports.randFloat = randFloat;
+const pick = (arr) => defaultPrng.pick(arr);
+exports.pick = pick;
+const makeSlug = () => (0, registry_1.makeSlug)(defaultPrng);
+exports.makeSlug = makeSlug;
+const makeEmail = (idx) => (0, registry_1.makeEmail)(defaultPrng, idx);
+exports.makeEmail = makeEmail;
+const makeUsername = (idx) => (0, registry_1.makeUsername)(defaultPrng, idx);
+exports.makeUsername = makeUsername;
+const makePhone = () => (0, registry_1.makePhone)(defaultPrng);
+exports.makePhone = makePhone;
+const makeAddress = () => (0, registry_1.makeAddress)(defaultPrng);
+exports.makeAddress = makeAddress;
+const makeIp = () => (0, registry_1.makeIp)(defaultPrng);
+exports.makeIp = makeIp;
+const makeMacAddress = () => (0, registry_1.makeMacAddress)(defaultPrng);
+exports.makeMacAddress = makeMacAddress;
+const makeCreditCard = () => (0, registry_1.makeCreditCard)(defaultPrng);
+exports.makeCreditCard = makeCreditCard;
+const makeAvatar = (seedVal) => (0, registry_1.makeAvatar)(defaultPrng, seedVal);
+exports.makeAvatar = makeAvatar;
+const makeColor = (format = 'hex') => (0, registry_1.makeColor)(defaultPrng, format);
+exports.makeColor = makeColor;
+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;
+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;
+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) {
+    return registry_1.GeneratorRegistry.getDescriptorsFor(col, fk);
+}
+function fallbackPlanFor(col) {
+    const type = (col.type || '').toUpperCase();
+    if (type === 'BOOLEAN' || type === 'BOOL')
+        return { strategy: 'bool' };
+    if (type === 'UUID')
+        return { strategy: 'uuid' };
+    if (type === 'JSON' || type === 'JSONB')
+        return { strategy: 'json' };
+    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')) {
+        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')
+        return { strategy: 'datetime', from: '2024-01-01T00:00:00', to: '2026-12-31T23:59:59' };
+    if (type === 'TIME')
+        return { strategy: 'time' };
+    if (type === 'BLOB' || type === 'BYTEA')
+        return { strategy: 'bytes', minLen: 8, maxLen: 32 };
+    if (type === 'INET')
+        return { strategy: 'ip' };
+    return { strategy: 'words', minLen: 1, maxLen: 4 };
+}
+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);
+    if (v === types_1.SKIP)
+        return '(omitted / default)';
+    if (v === null)
+        return 'NULL';
+    if (v instanceof Uint8Array || Buffer.isBuffer(v))
+        return `0x${Buffer.from(v).toString('hex').slice(0, 16)}...`;
+    return v;
+}

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[];};

package/dist/data/templates.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTemplateDependencies = extractTemplateDependencies;
+exports.evaluateTemplate = evaluateTemplate;
+exports.orderColumnDependencies = orderColumnDependencies;
+const registry_1 = require("./registry");
+function extractTemplateDependencies(template) {
+    if (!template)
+        return [];
+    const deps = [];
+    const re = /\{\{\s*([a-zA-Z0-9_]+)(?:\s*:[^}]+)?\s*\}\}/g;
+    let m;
+    while ((m = re.exec(template))) {
+        const name = m[1].trim();
+        if (!['sequence', 'random', 'year', 'uuid', 'slug', 'now', 'date'].includes(name.toLowerCase())) {
+            if (!deps.includes(name))
+                deps.push(name);
+        }
+    }
+    return deps;
+}
+function evaluateTemplate(template, rowValues, prng, rowIndex = 0) {
+    if (!template)
+        return '';
+    return template.replace(/\{\{\s*([a-zA-Z0-9_]+)(?::([^}]+))?\s*\}\}/g, (_, token, argsStr) => {
+        const t = token.trim();
+        const args = argsStr ? argsStr.split(/[:,]/).map((s) => s.trim()).filter(Boolean) : [];
+        switch (t.toLowerCase()) {
+            case 'year':
+                return String(new Date().getFullYear());
+            case 'uuid':
+                return (0, registry_1.makeUuid)(prng);
+            case 'slug':
+                return (0, registry_1.makeSlug)(prng);
+            case 'now':
+                return new Date().toISOString();
+            case 'date':
+                return new Date().toISOString().slice(0, 10);
+            case 'sequence': {
+                const start = args[0] ? Number.parseInt(args[0], 10) : 1;
+                const step = args[1] ? Number.parseInt(args[1], 10) : 1;
+                const s = Number.isFinite(start) ? start : 1;
+                const st = Number.isFinite(step) ? step : 1;
+                return String(s + rowIndex * st);
+            }
+            case 'random': {
+                const min = args[0] ? Number.parseInt(args[0], 10) : 1;
+                const max = args[1] ? Number.parseInt(args[1], 10) : 100;
+                const lo = Number.isFinite(min) ? min : 1;
+                const hi = Number.isFinite(max) ? max : 100;
+                return String(prng.int(lo, hi));
+            }
+        }
+        let rawVal = rowValues[t];
+        if (rawVal === undefined) {
+            const lower = t.toLowerCase();
+            for (const [k, v] of Object.entries(rowValues)) {
+                if (k.toLowerCase() === lower) {
+                    rawVal = v;
+                    break;
+                }
+            }
+        }
+        if (rawVal != null) {
+            let str = String(rawVal);
+            if (template.includes('@') && template.indexOf(`{{${token}`) < template.indexOf('@')) {
+                str = str
+                    .toLowerCase()
+                    .trim()
+                    .normalize('NFD')
+                    .replace(/[\u0300-\u036f]/g, '')
+                    .replace(/[^a-z0-9]+/g, '.')
+                    .replace(/^\.+|\.+$/g, '');
+            }
+            return str;
+        }
+        return '';
+    });
+}
+function orderColumnDependencies(columnNames, plans) {
+    const colSet = new Set(columnNames);
+    const inDegree = new Map();
+    const graph = new Map();
+    for (const col of columnNames) {
+        inDegree.set(col, 0);
+        graph.set(col, new Set());
+    }
+    const nameColumns = columnNames.filter((c) => ['first_name', 'last_name', 'full_name', 'fullname', 'name', 'customer_name'].includes(c.toLowerCase()));
+    for (const col of columnNames) {
+        const plan = plans[col];
+        if (plan?.strategy === 'template' && plan.template) {
+            const deps = extractTemplateDependencies(plan.template).filter((d) => colSet.has(d) && d !== col);
+            for (const dep of deps) {
+                graph.get(dep)?.add(col);
+                inDegree.set(col, (inDegree.get(col) ?? 0) + 1);
+            }
+        }
+        else if (plan?.strategy === 'email' || plan?.strategy === 'username') {
+            for (const nameCol of nameColumns) {
+                if (nameCol !== col && !graph.get(nameCol)?.has(col)) {
+                    graph.get(nameCol)?.add(col);
+                    inDegree.set(col, (inDegree.get(col) ?? 0) + 1);
+                }
+            }
+        }
+    }
+    const queue = [];
+    for (const [col, deg] of inDegree.entries()) {
+        if (deg === 0)
+            queue.push(col);
+    }
+    const orderedColumns = [];
+    while (queue.length > 0) {
+        const curr = queue.shift();
+        orderedColumns.push(curr);
+        for (const dependent of graph.get(curr) ?? []) {
+            const newDeg = (inDegree.get(dependent) ?? 1) - 1;
+            inDegree.set(dependent, newDeg);
+            if (newDeg === 0)
+                queue.push(dependent);
+        }
+    }
+    const hasCycle = orderedColumns.length < columnNames.length;
+    const cycleColumns = [];
+    if (hasCycle) {
+        for (const col of columnNames) {
+            if (!orderedColumns.includes(col))
+                cycleColumns.push(col);
+        }
+        for (const col of cycleColumns)
+            orderedColumns.push(col);
+    }
+    return { orderedColumns, hasCycle, cycleColumns };
+}

package/dist/data/types.d.ts

@@ -1 +1 @@
-import type {ForeignKeyInfo,WhereClause} from '../db/database';export declare const MAX_SEED_ROWS=5000;export type StrategyCategory='identity'|'contact_web'|'commerce'|'location'|'numeric'|'datetime'|'system_crypto'|'custom_control'|'relational';export type GeneratorStrategyId='skip'|'null'|'fixed'|'list'|'pattern'|'first'|'last'|'fullname'|'username'|'job'|'email'|'phone'|'url'|'domain'|'ip'|'avatar'|'company'|'currency'|'status'|'creditCard'|'city'|'country'|'state'|'postal'|'address'|'countryCode'|'latitude'|'longitude'|'words'|'sentence'|'paragraph'|'slug'|'int'|'decimal'|'sequence'|'date'|'datetime'|'time'|'timestampUnix'|'bool'|'bytes'|'json'|'hash'|'token'|'uuid'|'color'|'mac'|'fk';export interface ColumnPlan{strategy:GeneratorStrategyId;value?:string;values?:string[];min?:number;max?:number;precision?:number; from ?:string;to?:string;minLen?:number;maxLen?:number;jsonKeys?:string[];jsonValues?:Record<string,string[]>;nullPct?:number;prefix?:string;suffix?:string;start?:number;step?:number;pattern?:string;format?:string;}export interface StrategyDescriptor{id:GeneratorStrategyId;label:string;category:StrategyCategory;description?:string;}export interface ColumnGeneratorConfig{name:string;type:string;pk:boolean;notnull:boolean;hasDefault:boolean;unique:boolean;fk:ForeignKeyInfo|null;strategies:StrategyDescriptor[];defaultPlan:ColumnPlan;}export interface GenerateResult{rows:WhereClause[][];previewRows:Record<string,unknown>[];warnings:string[];}export declare const SKIP:unique symbol;
+import type {ForeignKeyInfo,WhereClause} from '../db/database';export declare const MAX_SEED_ROWS=5000;export type StrategyCategory='identity'|'contact_web'|'commerce'|'location'|'numeric'|'datetime'|'system_crypto'|'custom_control'|'database_aware'|'relational';export type GeneratorStrategyId='skip'|'null'|'fixed'|'list'|'pattern'|'template'|'first'|'last'|'fullname'|'username'|'job'|'email'|'phone'|'url'|'domain'|'ip'|'avatar'|'company'|'currency'|'status'|'orderStatus'|'product'|'productCategory'|'department'|'paymentMethod'|'transactionType'|'techSkill'|'creditCard'|'city'|'country'|'state'|'postal'|'address'|'countryCode'|'latitude'|'longitude'|'words'|'sentence'|'paragraph'|'slug'|'int'|'decimal'|'sequence'|'percentage'|'date'|'datetime'|'time'|'timestampUnix'|'relativeDate'|'bool'|'bytes'|'json'|'hash'|'token'|'uuid'|'color'|'mac'|'fk'|'sampleExisting'|'sequentialFk';export interface ColumnPlan{strategy:GeneratorStrategyId;value?:string;values?:string[];template?:string;min?:number;max?:number;precision?:number; from ?:string;to?:string;minLen?:number;maxLen?:number;jsonKeys?:string[];jsonValues?:Record<string,string[]>;nullPct?:number;prefix?:string;suffix?:string;start?:number;step?:number;pattern?:string;format?:string;unique?:boolean;refTable?:string;refColumn?:string;}export interface StrategyDescriptor{id:GeneratorStrategyId;label:string;category:StrategyCategory;description?:string;}export interface ColumnGeneratorConfig{name:string;type:string;pk:boolean;notnull:boolean;hasDefault:boolean;unique:boolean;fk:ForeignKeyInfo|null;strategies:StrategyDescriptor[];defaultPlan:ColumnPlan;}export type TableGenerationMode='generate'|'use_existing'|'generate_if_empty'|'skip';export type CardinalityDistribution='uniform'|'fixed'|'normal'|'weighted';export interface RelationshipConfig{parentTable:string;parentColumn:string;childTable:string;childColumn:string;minPerParent?:number;maxPerParent?:number;distribution?:CardinalityDistribution;uniquePairs?:boolean;nullable?:boolean;nullChance?:number;}export interface TableGenerationSpec{mode:TableGenerationMode;rows?:number;columns:Record<string,ColumnPlan>;truncate?:boolean;}export interface GenerationOptions{seed?:number|null;transaction?:boolean;rollbackOnError?:boolean;truncateAll?:boolean;batchSize?:number;previewLimit?:number;}export interface GenerationPlan{name?:string;description?:string;version?:number;rootTable?:string;scope?:ErChainScope;tables:Record<string,TableGenerationSpec>;relationships?:RelationshipConfig[];options?:GenerationOptions;}export interface ValidationIssue{type:'error'|'warning'|'info';table?:string;column?:string;message:string;code?:string;}export interface ValidationReport{valid:boolean;canExecute:boolean;issues:ValidationIssue[];summary:{totalTables:number;tablesToGenerate:number;tablesToUseExisting:number;tablesToSkip:number;estimatedTotalRows:number;cyclesDetected:boolean;cycleTables:string[];executionOrder:string[];};}export interface GenerateResult{rows:WhereClause[][];previewRows:Record<string,unknown>[];warnings:string[];}export type ErChainScope='chain'|'ancestors'|'descendants'|'all'|'single';export interface ErChainTableNode{name:string;order:number;depth:number;parents:{table:string; from :string;to:string;notnull?:boolean;}[];children:{table:string; from :string;to:string;notnull?:boolean;}[];columns:ColumnGeneratorConfig[];suggestedCount:number;rowCount:number;isRoot:boolean;hasSelfRef:boolean;isJunction?:boolean;mode?:TableGenerationMode;}export interface ErChainConfig{rootTable:string;scope:ErChainScope;tables:ErChainTableNode[];cycleDetected:boolean;cycleTables?:string[];maxTotalRows:number;relationships?:RelationshipConfig[];}export interface ErChainResult{rootTable?:string;scope?:ErChainScope;executionOrder:string[];tableResults:Record<string,{count:number;rows:WhereClause[][];previewRows:Record<string,unknown>[];warnings:string[];}>;totalRows:number;sql:string;warnings:string[];validation?:ValidationReport;}export interface SeedProfile{id:string;name:string;description?:string;createdAt:string;updatedAt:string;plan:GenerationPlan;}export declare const SKIP:unique symbol;

package/dist/data/types.js

@@ -1 +1,5 @@
-Object.defineProperty(exports,"__esModule",{value:!0}),exports.SKIP=exports.MAX_SEED_ROWS=void 0,exports.MAX_SEED_ROWS=5e3,exports.SKIP=Symbol("skip");
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKIP = exports.MAX_SEED_ROWS = void 0;
+exports.MAX_SEED_ROWS = 5000;
+exports.SKIP = Symbol('skip');

package/dist/data/validator.d.ts

@@ -0,0 +1 @@
+import type {IDatabase,TableInfoData} from '../db/index';import type {GenerationPlan,ValidationReport} from './types';export declare function validateGenerationPlan(db:IDatabase,plan:GenerationPlan,tableInfos?:Map<string,TableInfoData>):Promise<ValidationReport>;