admindb 2.1.0 → 2.2.1

package/dist/data/datasets.d.ts

@@ -1,17 +1 @@
-/**
- * Curated static datasets and wordlists used by the data generator.
- */
-export declare const FIRST_NAMES: string[];
-export declare const LAST_NAMES: string[];
-export declare const CITIES: string[];
-export declare const COUNTRIES: string[];
-export declare const DOMAINS: string[];
-export declare const LOREM_WORDS: string[];
-export declare const COMPANIES: string[];
-export declare const JOB_TITLES: string[];
-export declare const US_STATES: string[];
-export declare const CURRENCIES: string[];
-export declare const COUNTRY_CODES: string[];
-export declare const STATUSES: string[];
-export declare const HEX_COLORS: string[];
-export declare const NAMED_COLORS: string[];
+export declare const FIRST_NAMES:string[];export declare const LAST_NAMES:string[];export declare const CITIES:string[];export declare const COUNTRIES:string[];export declare const DOMAINS:string[];export declare const LOREM_WORDS:string[];export declare const COMPANIES:string[];export declare const JOB_TITLES:string[];export declare const US_STATES:string[];export declare const CURRENCIES:string[];export declare const COUNTRY_CODES:string[];export declare const STATUSES:string[];export declare const HEX_COLORS:string[];export declare const NAMED_COLORS:string[];

package/dist/data/datasets.js

@@ -1,7 +1,4 @@
 "use strict";
-/**
- * Curated static datasets and wordlists used by the data generator.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NAMED_COLORS = exports.HEX_COLORS = exports.STATUSES = exports.COUNTRY_CODES = exports.CURRENCIES = exports.US_STATES = exports.JOB_TITLES = exports.COMPANIES = exports.LOREM_WORDS = exports.DOMAINS = exports.COUNTRIES = exports.CITIES = exports.LAST_NAMES = exports.FIRST_NAMES = void 0;
 exports.FIRST_NAMES = [
@@ -130,4 +127,3 @@ exports.NAMED_COLORS = [
     "Sky", "Slate", "Teal", "Fuchsia", "Crimson", "Navy",
     "Coral", "Bronze", "Charcoal", "Mint", "Lavender", "Ruby", "Cobalt"
 ];
-//# sourceMappingURL=datasets.js.map

package/dist/data/detector.d.ts

@@ -1,30 +1 @@
-import type { ColumnInfo, ForeignKeyInfo, TableInfoData } from '../db/index';
-import { type ColumnGeneratorConfig, type ColumnPlan } from './types';
-export interface OrderingConstraint {
-    after?: {
-        column: string;
-        orEqual: boolean;
-    };
-    before?: {
-        column: string;
-        orEqual: boolean;
-    };
-}
-export interface NumericConstraint {
-    min?: number;
-    max?: number;
-}
-export interface CheckInfo {
-    columnAllowed: Map<string, string[]>;
-    columnRange: Map<string, NumericConstraint>;
-    jsonAllowed: Map<string, Map<string, string[]>>;
-    ordering: Map<string, OrderingConstraint>;
-}
-export declare const normName: (s: string) => string;
-export declare function isTimestampName(name: string): boolean;
-export declare function findInMap<T>(map: Map<string, T>, colName: string): T | undefined;
-export declare function extractCheckExprs(sql: string): string[];
-export declare function parseChecks(sql: string | null): CheckInfo;
-export declare function detectPlan(col: ColumnInfo, fk: ForeignKeyInfo | null): ColumnPlan;
-export declare function buildColumnConfigs(info: TableInfoData): ColumnGeneratorConfig[];
-export declare function sanitizeColumnPlan(raw: unknown): ColumnPlan | null;
+import type {ColumnInfo,ForeignKeyInfo,TableInfoData} from '../db/index';import{type ColumnGeneratorConfig,type ColumnPlan} from './types';export interface OrderingConstraint{after?:{column:string;orEqual:boolean;};before?:{column:string;orEqual:boolean;};}export interface NumericConstraint{min?:number;max?:number;}export interface LengthConstraint{min?:number;max?:number;exact?:number;}export interface CheckInfo{columnAllowed:Map<string,string[]>;columnRange:Map<string,NumericConstraint>;columnLength:Map<string,LengthConstraint>;jsonAllowed:Map<string,Map<string,string[]>>;ordering:Map<string,OrderingConstraint>;}export declare const normName:(s:string)=>string;export declare function isTimestampName(name:string):boolean;export declare function findInMap<T>(map:Map<string,T>,colName:string):T|undefined;export declare function extractCheckExprs(sql:string):string[];export declare function parseChecks(sql:string|null):CheckInfo;export declare function detectPlan(col:ColumnInfo,fk:ForeignKeyInfo|null):ColumnPlan;export declare function buildColumnConfigs(info:TableInfoData):ColumnGeneratorConfig[];export declare function sanitizeColumnPlan(raw:unknown):ColumnPlan|null;

package/dist/data/detector.js

@@ -80,6 +80,7 @@ function parseChecks(sql) {
     const info = {
         columnAllowed: new Map(),
         columnRange: new Map(),
+        columnLength: new Map(),
         jsonAllowed: new Map(),
         ordering: new Map(),
     };
@@ -104,9 +105,8 @@ function parseChecks(sql) {
         }
     };
     for (const expr of extractCheckExprs(sql)) {
-        // 1. JSON whitelists
-        const jw1 = /(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))\s*(?:->>|->)\s*'([^']+)'\s*\)*\s*IN\s*\(([^)]*)\)/gi;
-        const jw2 = /json_extract\s*\(\s*(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))\s*,\s*'(?:\$\??|\.)?\.?([^']+)'\s*\)\s*\)*\s*IN\s*\(([^)]*)\)/gi;
+        const jw1 = /(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))\s*(?:->>|->)\s*'([^']+)'\s*(?:\)\s*)*IN\s*\(([^)]*)\)/gi;
+        const jw2 = /json_extract\s*\(\s*(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))\s*,\s*'(?:\$\??|\.)?\.?([^']+)'\s*\)\s*(?:\)\s*)*IN\s*\(([^)]*)\)/gi;
         for (const re of [jw1, jw2]) {
             let m;
             while ((m = re.exec(expr))) {
@@ -122,8 +122,7 @@ function parseChecks(sql) {
                 }
             }
         }
-        // 2. Direct column IN lists
-        const colIn = /(?:^|[^(->>\w])(?:\(\s*)?(?:(?:lower|upper|trim|coalesce)\s*\(\s*)?(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))(?:\s*,\s*[^)]+)?\s*\)?\s*\)?\s*IN\s*\(([^)]*)\)/gi;
+        const colIn = /(?:^|[^\w"'\`\[])(?:\s*\(\s*)*(?:(?:lower|upper|trim|coalesce)\s*\(\s*)?(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))(?:\s*,\s*[^)]+)?(?:\s*\)\s*)*\s*IN\s*\(([^)]*)\)/gi;
         let mColIn;
         while ((mColIn = colIn.exec(expr))) {
             const col = mColIn[1] || mColIn[2] || mColIn[3] || mColIn[4];
@@ -138,8 +137,7 @@ function parseChecks(sql) {
             if (values.length)
                 setColumnAllowed(col, values);
         }
-        // 3. Direct column equality
-        const eqOr = /(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))\s*=\s*'((?:[^']|'')*)'/gi;
+        const eqOr = /(?:^|[^\w"'\`\[])(?:\s*\(\s*)*(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))(?:\s*\)\s*)*\s*=\s*'((?:[^']|'')*)'/gi;
         let mEq;
         const eqByCol = new Map();
         while ((mEq = eqOr.exec(expr))) {
@@ -154,8 +152,7 @@ function parseChecks(sql) {
         }
         for (const [col, vals] of eqByCol.entries())
             setColumnAllowed(col, vals);
-        // 4. Numeric range constraints
-        const numCmp1 = /(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))\s*(>=|>|<=|<)\s*(-?\d+(?:\.\d+)?)/g;
+        const numCmp1 = /(?:^|[^\w"'\`\[])(?:\s*\(\s*)*(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))(?:\s*\)\s*)*\s*(>=|>|<=|<)\s*(-?\d+(?:\.\d+)?)/g;
         let mNum1;
         while ((mNum1 = numCmp1.exec(expr))) {
             const col = mNum1[1] || mNum1[2] || mNum1[3] || mNum1[4];
@@ -170,7 +167,28 @@ function parseChecks(sql) {
                 info.columnRange.set(col, cur);
             }
         }
-        // 5. Column ordering
+        const lenRe1 = /length\s*\(\s*(?:\s*\(\s*)*(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))(?:\s*\)\s*)*\s*\)\s*(=|==|>=|>|<=|<)\s*(\d+)/gi;
+        let mLen1;
+        while ((mLen1 = lenRe1.exec(expr))) {
+            const col = mLen1[1] || mLen1[2] || mLen1[3] || mLen1[4];
+            const op = mLen1[5];
+            const val = Number(mLen1[6]);
+            if (col && Number.isFinite(val)) {
+                const cur = findInMap(info.columnLength, col) ?? {};
+                if (op === '=' || op === '==') {
+                    cur.exact = val;
+                    cur.min = val;
+                    cur.max = val;
+                }
+                else if (op === '>=' || op === '>') {
+                    cur.min = op === '>' ? val + 1 : val;
+                }
+                else if (op === '<=' || op === '<') {
+                    cur.max = op === '<' ? val - 1 : val;
+                }
+                info.columnLength.set(col, cur);
+            }
+        }
         const ord = /(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))\s*(>=|<=|>|<)\s*(?:"([^"]+)"|`([^`]+)`|\[([^\]]+)\]|([A-Za-z_][A-Za-z0-9_]*))/g;
         let m2;
         while ((m2 = ord.exec(expr))) {
@@ -232,7 +250,6 @@ function extractJsonColumns(sql) {
         push(m[1] || m[2], m[3]);
     return out;
 }
-/** Name heuristics pattern table for text-ish columns. */
 const TEXT_PATTERNS = [
     [/avatar|picture|photo|image|img|thumbnail|icon|logo/, () => ({ strategy: 'avatar' })],
     [/company|organization|org|firm|corp|employer|agency/, () => ({ strategy: 'company' })],
@@ -269,7 +286,9 @@ function detectPlan(col, fk) {
     if (col.pk) {
         if (type.startsWith('INT') || type === 'SERIAL' || type === 'BIGSERIAL')
             return { strategy: 'skip' };
-        if (type === 'TEXT' || type === 'BLOB' || type === 'UUID')
+        if (type.includes('TEXT') || type.includes('CHAR') || type.includes('VARCHAR') || type.includes('STRING') || type === 'BLOB' || type === 'UUID')
+            return { strategy: 'uuid' };
+        if (col.notnull && col.dflt_value == null)
             return { strategy: 'uuid' };
         return { strategy: 'skip' };
     }
@@ -323,7 +342,6 @@ function detectPlan(col, fk) {
     }
     if (type === 'BLOB')
         return { strategy: 'bytes', minLen: 8, maxLen: 32 };
-    // Explicit text heuristics checked in exact order
     if (/currency|curr|currencycode/.test(name))
         return { strategy: 'currency' };
     if (/countrycode|countryiso|isocountry|cca2/.test(name))
@@ -375,6 +393,16 @@ function buildColumnConfigs(info) {
             }
         }
     }
+    if (info.sql) {
+        const uqRe = /UNIQUE\s*\(\s*([^)]+)\s*\)/gi;
+        let uqM;
+        while ((uqM = uqRe.exec(info.sql))) {
+            const rawCols = uqM[1].split(',').map((s) => s.trim().replace(/[`"\[\]]/g, ''));
+            if (rawCols.length === 1 && rawCols[0]) {
+                uniqueCols.add(rawCols[0]);
+            }
+        }
+    }
     const checkInfo = parseChecks(info.sql ?? null);
     return info.columns.map((col) => {
         const fk = fkByColumn.get(col.name) ?? null;
@@ -410,6 +438,18 @@ function buildColumnConfigs(info) {
             if (colRange.max != null)
                 defaultPlan.max = colRange.max;
         }
+        const colLen = findInMap(checkInfo.columnLength, col.name);
+        if (colLen && defaultPlan.strategy !== 'fk' && !col.pk) {
+            if (colLen.exact != null) {
+                defaultPlan = { strategy: 'token', minLen: colLen.exact, maxLen: colLen.exact };
+            }
+            else {
+                if (colLen.min != null)
+                    defaultPlan.minLen = colLen.min;
+                if (colLen.max != null)
+                    defaultPlan.maxLen = colLen.max;
+            }
+        }
         if (!strategies.some((s) => s.id === defaultPlan.strategy) || (!col.pk && col.notnull && col.dflt_value == null && (defaultPlan.strategy === 'skip' || defaultPlan.strategy === 'null'))) {
             defaultPlan = (0, strategies_1.fallbackPlanFor)(col);
         }
@@ -469,4 +509,3 @@ function sanitizeColumnPlan(raw) {
     }
     return out;
 }
-//# sourceMappingURL=detector.js.map

package/dist/data/engine.d.ts

@@ -1,10 +1 @@
-import type { IDatabase, TableInfoData, WhereClause } from '../db/index';
-import { type ColumnGeneratorConfig, type ColumnPlan, type GenerateResult } from './types';
-/**
- * Generate `count` rows for a table with structured previews.
- */
-export declare function generateRows(db: IDatabase, info: TableInfoData, configs: ColumnGeneratorConfig[], count: number, plan?: Record<string, ColumnPlan>): Promise<GenerateResult>;
-/**
- * Render generated rows as a sequence of INSERT statements for preview.
- */
-export declare function buildSeedInsertSql(table: string, rows: WhereClause[][]): string;
+import type {IDatabase,TableInfoData,WhereClause} from '../db/index';import{type ColumnGeneratorConfig,type ColumnPlan,type GenerateResult} from './types';export declare function generateRows(db:IDatabase,info:TableInfoData,configs:ColumnGeneratorConfig[],count:number,plan?:Record<string,ColumnPlan>,truncate?:boolean):Promise<GenerateResult>;export declare function buildSeedInsertSql(table:string,rows:WhereClause[][]):string;

package/dist/data/engine.js

@@ -6,7 +6,6 @@ const generator_1 = require("../sql/generator");
 const types_1 = require("./types");
 const detector_1 = require("./detector");
 const strategies_1 = require("./strategies");
-/** Distinct non-null values of a foreign key's referenced column. */
 async function sampleFkValues(db, fk) {
     if (!fk)
         return [];
@@ -29,21 +28,6 @@ function stringifyKey(v) {
         return `buf:${Buffer.from(v).toString('hex')}`;
     return `${typeof v}:${String(v)}`;
 }
-function uniqueSuffix(base, seen) {
-    if (typeof base === 'number' && Number.isFinite(base)) {
-        let n = Number(base);
-        while (seen.has(stringifyKey(n)))
-            n += 1;
-        return n;
-    }
-    let i = 1;
-    let cand = `${String(base)}-${i}`;
-    while (seen.has(stringifyKey(cand))) {
-        i += 1;
-        cand = `${String(base)}-${i}`;
-    }
-    return cand;
-}
 function orderedValue(value, base, dir, orEqual) {
     const v = value;
     const b = base;
@@ -80,6 +64,30 @@ function orderedValue(value, base, dir, orEqual) {
     }
     return v;
 }
+function fitStringLength(val, len) {
+    if (!len || typeof val !== 'string')
+        return val;
+    let v = val;
+    if (len.exact != null) {
+        if (v.length > len.exact)
+            v = v.slice(0, len.exact);
+        const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+        while (v.length < len.exact) {
+            v += chars[Math.floor(Math.random() * chars.length)];
+        }
+        return v;
+    }
+    if (len.max != null && v.length > len.max) {
+        v = v.slice(0, len.max);
+    }
+    if (len.min != null && v.length < len.min) {
+        const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+        while (v.length < len.min) {
+            v += chars[Math.floor(Math.random() * chars.length)];
+        }
+    }
+    return v;
+}
 function applyOrdering(fields, ordering) {
     if (!ordering.size)
         return;
@@ -100,10 +108,7 @@ function applyOrdering(fields, ordering) {
         }
     }
 }
-/**
- * Generate `count` rows for a table with structured previews.
- */
-async function generateRows(db, info, configs, count, plan = {}) {
+async function generateRows(db, info, configs, count, plan = {}, truncate = false) {
     const fkByColumn = new Map();
     for (const fk of info.foreignKeys)
         fkByColumn.set(fk.from, fk);
@@ -154,37 +159,70 @@ async function generateRows(db, info, configs, count, plan = {}) {
     const rows = [];
     const previewRows = [];
     const uniqueSeen = new Map();
+    if (!truncate) {
+        for (const col of uniqueCols) {
+            try {
+                const existing = await db.all(`SELECT ${(0, generator_1.quoteIdentifier)(col)} AS v FROM ${(0, generator_1.quoteIdentifier)(info.table)} WHERE ${(0, generator_1.quoteIdentifier)(col)} IS NOT NULL LIMIT 10000`);
+                const seen = new Set();
+                for (const r of (existing.data ?? [])) {
+                    if (r.v != null)
+                        seen.add(stringifyKey(r.v));
+                }
+                uniqueSeen.set(col, seen);
+            }
+            catch { }
+        }
+    }
     for (let i = 0; i < count; i++) {
         const fields = [];
         const previewRow = {};
-        for (const { col, plan: p } of prepared) {
-            if (p.strategy === 'fk' && fkOmit.has(col.name)) {
-                previewRow[col.name] = null;
-                continue;
-            }
-            let v = (0, strategies_1.generateOne)(col, p, fkPools.get(col.name), i);
-            if (v === types_1.SKIP) {
-                previewRow[col.name] = '(default)';
-                continue;
-            }
-            if (uniqueCols.has(col.name)) {
-                const seen = uniqueSeen.get(col.name) ?? new Set();
-                let attempts = 0;
-                while (seen.has(stringifyKey(v)) && attempts < 20) {
-                    v = (0, strategies_1.generateOne)(col, p, fkPools.get(col.name), i);
-                    attempts += 1;
+        let rowValid = true;
+        let attempt = 0;
+        while (attempt < 100 && rowValid) {
+            fields.length = 0;
+            let allColsValid = true;
+            for (const { col, plan: p } of prepared) {
+                if (p.strategy === 'fk' && fkOmit.has(col.name)) {
+                    previewRow[col.name] = null;
+                    continue;
+                }
+                let v = (0, strategies_1.generateOne)(col, p, fkPools.get(col.name), i + attempt * count);
+                if (v === types_1.SKIP) {
+                    previewRow[col.name] = '(default)';
+                    continue;
                 }
-                if (seen.has(stringifyKey(v))) {
-                    warnings.push(`Column "${col.name}" is UNIQUE but the generator kept colliding — appended a suffix to keep rows insertable.`);
-                    v = uniqueSuffix(v, seen);
+                if (uniqueCols.has(col.name)) {
+                    const seen = uniqueSeen.get(col.name) ?? new Set();
+                    let singleAtt = 0;
+                    while (seen.has(stringifyKey(v)) && singleAtt < 100) {
+                        v = (0, strategies_1.generateOne)(col, p, fkPools.get(col.name), i + attempt * count + singleAtt * 100);
+                        singleAtt += 1;
+                    }
+                    if (seen.has(stringifyKey(v))) {
+                        allColsValid = false;
+                        break;
+                    }
                 }
-                seen.add(stringifyKey(v));
-                uniqueSeen.set(col.name, seen);
+                v = fitStringLength(v, (0, detector_1.findInMap)(checkInfo.columnLength, col.name));
+                fields.push({ column: col.name, value: v });
+                previewRow[col.name] = v;
+            }
+            if (allColsValid) {
+                break;
+            }
+            attempt += 1;
+        }
+        if (attempt >= 100) {
+            warnings.push(`Stopped generating rows early at row ${i} because unique generator exhausted possible values without collision.`);
+            break;
+        }
+        for (const f of fields) {
+            if (uniqueCols.has(f.column)) {
+                const seen = uniqueSeen.get(f.column) ?? new Set();
+                seen.add(stringifyKey(f.value));
+                uniqueSeen.set(f.column, seen);
             }
-            fields.push({ column: col.name, value: v });
-            previewRow[col.name] = v;
         }
-        // Honor CHECK ordering constraints
         applyOrdering(fields, checkInfo.ordering);
         for (const f of fields) {
             previewRow[f.column] = f.value;
@@ -196,9 +234,6 @@ async function generateRows(db, info, configs, count, plan = {}) {
     }
     return { rows, previewRows, warnings };
 }
-/**
- * Render generated rows as a sequence of INSERT statements for preview.
- */
 function buildSeedInsertSql(table, rows) {
     return rows
         .map((fields) => {
@@ -208,4 +243,3 @@ function buildSeedInsertSql(table, rows) {
     })
         .join('\n');
 }
-//# sourceMappingURL=engine.js.map

package/dist/data/index.d.ts

@@ -1,5 +1 @@
-export * from './types';
-export * from './datasets';
-export * from './strategies';
-export * from './detector';
-export * from './engine';
+export * from './types';export * from './datasets';export * from './strategies';export * from './detector';export * from './engine';export * from './chain';

package/dist/data/index.js

@@ -19,4 +19,4 @@ __exportStar(require("./datasets"), exports);
 __exportStar(require("./strategies"), exports);
 __exportStar(require("./detector"), exports);
 __exportStar(require("./engine"), exports);
-//# sourceMappingURL=index.js.map
+__exportStar(require("./chain"), exports);

package/dist/data/strategies.d.ts

@@ -1,30 +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{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;

package/dist/data/strategies.js

@@ -19,7 +19,6 @@ const node_crypto_1 = require("node:crypto");
 const common_1 = require("../utils/common");
 const datasets_1 = require("./datasets");
 const types_1 = require("./types");
-// ---- Random helpers -------------------------------------------------------
 const randInt = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
 exports.randInt = randInt;
 const randFloat = (min, max) => Math.random() * (max - min) + min;
@@ -28,9 +27,9 @@ const pick = (arr) => arr[(0, exports.randInt)(0, arr.length - 1)];
 exports.pick = pick;
 const makeSlug = () => `${(0, exports.pick)(datasets_1.LOREM_WORDS)}-${(0, exports.pick)(datasets_1.LOREM_WORDS)}-${(0, exports.randInt)(100, 999)}`;
 exports.makeSlug = makeSlug;
-const 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)}`;
+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)}`;
 exports.makeEmail = makeEmail;
-const makeUsername = () => `${(0, exports.pick)(datasets_1.FIRST_NAMES).toLowerCase()}${(0, exports.pick)(datasets_1.LAST_NAMES).toLowerCase()}${(0, exports.randInt)(1, 9999)}`;
+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)}`;
 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')}`;
 exports.makePhone = makePhone;
@@ -156,7 +155,6 @@ function isTextishType(type) {
     const t = (type || '').toUpperCase();
     return t === 'TEXT' || t === '' || t.includes('JSON') || t.includes('CHAR') || t.includes('CLOB') || t.includes('VARCHAR');
 }
-/** Registry of strategy descriptors and their supported type categories. */
 const STRATEGY_METADATA = [
     ['skip', 'Skip (DB default or NULL applies)', 'custom_control', 'all'],
     ['null', 'Set NULL explicitly', 'custom_control', 'all'],
@@ -246,13 +244,12 @@ function fallbackPlanFor(col) {
         return { strategy: 'ip' };
     return { strategy: 'words', minLen: 1, maxLen: 4 };
 }
-/** Dispatch table for simple strategy generators. */
 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)(),
+    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),
@@ -340,4 +337,3 @@ function generateSampleValue(col, plan, fkPool) {
         return `0x${Buffer.from(v).toString('hex').slice(0, 16)}...`;
     return v;
 }
-//# sourceMappingURL=strategies.js.map

package/dist/data/types.d.ts

@@ -1,73 +1 @@
-import type { ForeignKeyInfo, WhereClause } from '../db/database';
-/** Hard cap on how many rows a single seed run may generate. */
-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';
-/** Per-column generator settings. Which options are meaningful depends on `strategy`. */
-export interface ColumnPlan {
-    strategy: GeneratorStrategyId;
-    /** `fixed` / `list` and the string-ish options. */
-    value?: string;
-    /** `list` — random value picked from this set. */
-    values?: string[];
-    /** `int` / `decimal` / `latitude` / `longitude` range. */
-    min?: number;
-    max?: number;
-    /** `decimal` — digits after the decimal point. */
-    precision?: number;
-    /** `date` / `datetime` / `timestampUnix` bounds (ISO strings). */
-    from?: string;
-    to?: string;
-    /** `words` / `bytes` / `hash` / `token` / `sentence` — length bounds. */
-    minLen?: number;
-    maxLen?: number;
-    /** `json` — object keys to include (comma-separated in the UI). */
-    jsonKeys?: string[];
-    /** `json` — per-key allowed values, derived from CHECK constraints. */
-    jsonValues?: Record<string, string[]>;
-    /** Percentage chance (0 to 100) to generate NULL for nullable columns. */
-    nullPct?: number;
-    /** Optional string prefix to prepend to generated string/text values. */
-    prefix?: string;
-    /** Optional string suffix to append to generated string/text values. */
-    suffix?: string;
-    /** Sequence start (for `sequence` strategy). */
-    start?: number;
-    /** Sequence step increment (for `sequence` strategy). */
-    step?: number;
-    /** Custom pattern template with tokens (for `pattern` strategy). */
-    pattern?: string;
-    /** Format variation (e.g. 'hex' | 'name' for color, 'sec' | 'ms' for unix timestamp). */
-    format?: string;
-}
-/** A strategy choice offered to the UI for a column. */
-export interface StrategyDescriptor {
-    id: GeneratorStrategyId;
-    label: string;
-    category: StrategyCategory;
-    description?: string;
-}
-/** Everything the "Seed data" page needs to render one column's controls. */
-export interface ColumnGeneratorConfig {
-    name: string;
-    type: string;
-    pk: boolean;
-    notnull: boolean;
-    hasDefault: boolean;
-    /** True when a single-column UNIQUE index enforces uniqueness on this column. */
-    unique: boolean;
-    /** The foreign key this column participates in (as the child), if any. */
-    fk: ForeignKeyInfo | null;
-    strategies: StrategyDescriptor[];
-    defaultPlan: ColumnPlan;
-}
-export interface GenerateResult {
-    /** One entry per generated row: the columns/values to bind (skipped columns are absent). */
-    rows: WhereClause[][];
-    /** Structured row records for interactive UI table preview. */
-    previewRows: Record<string, unknown>[];
-    /** Non-fatal notes surfaced to the user (e.g. a NOT NULL column being skipped). */
-    warnings: string[];
-}
-/** Sentinel returned by value generation when the column should be omitted from the row. */
-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'|'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 type ErChainScope='chain'|'ancestors'|'descendants'|'all'|'single';export interface ErChainTableNode{name:string;order:number;depth:number;parents:{table:string; from :string;to:string;}[];children:{table:string; from :string;to:string;}[];columns:ColumnGeneratorConfig[];suggestedCount:number;rowCount:number;isRoot:boolean;hasSelfRef:boolean;}export interface ErChainConfig{rootTable:string;scope:ErChainScope;tables:ErChainTableNode[];cycleDetected:boolean;cycleTables?:string[];maxTotalRows:number;}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[];}export declare const SKIP:unique symbol;

package/dist/data/types.js

@@ -1,8 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SKIP = exports.MAX_SEED_ROWS = void 0;
-/** Hard cap on how many rows a single seed run may generate. */
 exports.MAX_SEED_ROWS = 5000;
-/** Sentinel returned by value generation when the column should be omitted from the row. */
 exports.SKIP = Symbol('skip');
-//# sourceMappingURL=types.js.map