admindb 2.1.0 → 2.1.1

package/dist/data/strategies.js

@@ -1,343 +1 @@
-"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.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 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;
-exports.randFloat = randFloat;
-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)}`;
-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)}`;
-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;
-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)}`;
-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)}`;
-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)}`;
-exports.makeCreditCard = makeCreditCard;
-const makeAvatar = (seedVal) => `https://api.dicebear.com/7.x/avataaars/svg?seed=${encodeURIComponent(seedVal || (0, exports.makeUsername)())}`;
-exports.makeAvatar = makeAvatar;
-const makeColor = (format = 'hex') => (format === 'name' ? (0, exports.pick)(datasets_1.NAMED_COLORS) : (0, exports.pick)(datasets_1.HEX_COLORS));
-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);
-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')}`;
-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');
-}
-/** 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'],
-    ['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'],
-];
-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;
-}
-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 };
-}
-/** 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)(),
-    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 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;
-}
-//# sourceMappingURL=strategies.js.map
+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")}

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 declare const SKIP:unique symbol;

package/dist/data/types.js

@@ -1,8 +1 @@
-"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
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.SKIP=exports.MAX_SEED_ROWS=void 0,exports.MAX_SEED_ROWS=5e3,exports.SKIP=Symbol("skip");

package/dist/db/database.d.ts

@@ -1,119 +1 @@
-import type { Logger } from '../utils/logger';
-import { type ColumnDef, type IndexDef } from '../sql/generator';
-import type { DatabaseDialect, DbOpenOptions, IDatabase, ReferencingTableInfo, Result, RowFilters, SavedQuery, SchemaInfo, SQLInputValue, TableInfoData, TableListItem, WhereClause } from './types';
-export * from './types';
-export * from './filters';
-/**
- * Promise-style wrapper around the better-sqlite3 driver.
- * Every call returns a consistent `{ success, data?, error? }` shape and
- * performs one-time, idempotent schema initialization.
- */
-export declare class SqliteDatabase implements IDatabase {
-    private db;
-    private logger;
-    readonly path: string;
-    readonly isReadOnly: boolean;
-    readonly dialect: DatabaseDialect;
-    constructor(dbPath: string, logger: Logger, options?: DbOpenOptions);
-    private readonlyBlocked;
-    close(): void;
-    private initSchema;
-    private tryRun;
-    /** Run an atomic transaction. Reverts on any error and enforces read-only mode. */
-    private transaction;
-    private toBind;
-    all(sql: string, params?: SQLInputValue[]): Promise<Result<unknown[]>>;
-    run(sql: string, params?: SQLInputValue[]): Promise<Result<{
-        changes: number;
-        lastInsertRowid: number | null;
-    }>>;
-    execResult(sql: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    hasMultipleStatements(sql: string): boolean;
-    runWrite(sql: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    listTables(): Promise<Result<TableListItem[]>>;
-    getTableInfo(table: string): Promise<Result<TableInfoData>>;
-    getRowCount(table: string, filters?: RowFilters): Promise<Result<number>>;
-    getRows(table: string, opts?: {
-        page?: number;
-        limit?: number;
-        orderBy?: string;
-        orderDir?: 'asc' | 'desc';
-        filters?: RowFilters;
-    }): Promise<Result<Record<string, unknown>[]>>;
-    getAllRows(table: string): Promise<Result<Record<string, unknown>[]>>;
-    getRow(table: string, where: WhereClause[]): Promise<Result<Record<string, unknown> | null>>;
-    insertRow(table: string, fields: WhereClause[]): Promise<Result<{
-        changes: number;
-        lastInsertRowid: number | null;
-    }>>;
-    /** Insert many rows inside a single atomic transaction. */
-    insertRows(table: string, rows: WhereClause[][]): Promise<Result<{
-        inserted: number;
-        skipped: number;
-    }>>;
-    updateRow(table: string, fields: WhereClause[], where: WhereClause[]): Promise<Result<{
-        changes: number;
-        lastInsertRowid: number | null;
-    }>>;
-    /** Apply many row updates inside a single atomic transaction. */
-    updateRows(table: string, rows: {
-        fields: WhereClause[];
-        where: WhereClause[];
-    }[]): Promise<Result<{
-        updated: number;
-    }>>;
-    deleteRow(table: string, where: WhereClause[]): Promise<Result<{
-        changes: number;
-        lastInsertRowid: number | null;
-    }>>;
-    /** Delete many rows inside a single atomic transaction. */
-    deleteRows(table: string, rows: WhereClause[][]): Promise<Result<{
-        deleted: number;
-    }>>;
-    getRowsByPks(table: string, pks: WhereClause[][]): Promise<Result<Record<string, unknown>[]>>;
-    getCreateStatement(table: string): Promise<Result<string | null>>;
-    listSavedQueries(): Promise<Result<SavedQuery[]>>;
-    saveQuery(name: string, sql: string): Promise<Result<{
-        changes: number;
-        lastInsertRowid: number | null;
-    }>>;
-    deleteSavedQuery(id: string | number): Promise<Result<{
-        changes: number;
-        lastInsertRowid: number | null;
-    }>>;
-    getSchema(table: string): Promise<Result<SchemaInfo>>;
-    getReferencingTables(table: string): Promise<Result<ReferencingTableInfo[]>>;
-    getRowsByFk(table: string, column: string, value: unknown, limit?: number): Promise<Result<{
-        rows: Record<string, unknown>[];
-        total: number;
-    }>>;
-    renameTable(oldName: string, newName: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    addColumn(table: string, col: ColumnDef): Promise<Result<{
-        changes?: number;
-    }>>;
-    modifyColumn(table: string, oldColName: string, newColDef: ColumnDef): Promise<Result<{
-        changes?: number;
-    }>>;
-    renameColumn(table: string, oldName: string, newName: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    dropColumn(table: string, column: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    dropTable(table: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    createIndex(table: string, index: IndexDef): Promise<Result<{
-        changes?: number;
-    }>>;
-    dropIndex(indexName: string): Promise<Result<{
-        changes?: number;
-    }>>;
-    private getTableInfoSync;
-}
+import type {Logger} from '../utils/logger';import{type ColumnDef,type IndexDef} from '../sql/generator';import type {DatabaseDialect,DbOpenOptions,IDatabase,ReferencingTableInfo,Result,RowFilters,SavedQuery,SchemaInfo,SQLInputValue,TableInfoData,TableListItem,WhereClause} from './types';export * from './types';export * from './filters';export declare class SqliteDatabase implements IDatabase{private db;private logger;readonly path:string;readonly isReadOnly:boolean;readonly dialect:DatabaseDialect;constructor(dbPath:string,logger:Logger,options?:DbOpenOptions);private readonlyBlocked;close():void;private initSchema;private tryRun;private transaction;private toBind;all(sql:string,params?:SQLInputValue[]):Promise<Result<unknown[]>>;run(sql:string,params?:SQLInputValue[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;execResult(sql:string):Promise<Result<{changes?:number;}>>;hasMultipleStatements(sql:string):boolean;runWrite(sql:string):Promise<Result<{changes?:number;}>>;listTables():Promise<Result<TableListItem[]>>;getTableInfo(table:string):Promise<Result<TableInfoData>>;getRowCount(table:string,filters?:RowFilters):Promise<Result<number>>;getRows(table:string,opts?:{page?:number;limit?:number;orderBy?:string;orderDir?:'asc'|'desc';filters?:RowFilters;}):Promise<Result<Record<string,unknown>[]>>;getAllRows(table:string):Promise<Result<Record<string,unknown>[]>>;getRow(table:string,where:WhereClause[]):Promise<Result<Record<string,unknown>|null>>;insertRow(table:string,fields:WhereClause[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;insertRows(table:string,rows:WhereClause[][]):Promise<Result<{inserted:number;skipped:number;}>>;updateRow(table:string,fields:WhereClause[],where:WhereClause[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;updateRows(table:string,rows:{fields:WhereClause[];where:WhereClause[];}[]):Promise<Result<{updated:number;}>>;deleteRow(table:string,where:WhereClause[]):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;deleteRows(table:string,rows:WhereClause[][]):Promise<Result<{deleted:number;}>>;getRowsByPks(table:string,pks:WhereClause[][]):Promise<Result<Record<string,unknown>[]>>;getCreateStatement(table:string):Promise<Result<string|null>>;listSavedQueries():Promise<Result<SavedQuery[]>>;saveQuery(name:string,sql:string):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;deleteSavedQuery(id:string|number):Promise<Result<{changes:number;lastInsertRowid:number|null;}>>;getSchema(table:string):Promise<Result<SchemaInfo>>;getReferencingTables(table:string):Promise<Result<ReferencingTableInfo[]>>;getRowsByFk(table:string,column:string,value:unknown,limit?:number):Promise<Result<{rows:Record<string,unknown>[];total:number;}>>;renameTable(oldName:string,newName:string):Promise<Result<{changes?:number;}>>;addColumn(table:string,col:ColumnDef):Promise<Result<{changes?:number;}>>;modifyColumn(table:string,oldColName:string,newColDef:ColumnDef):Promise<Result<{changes?:number;}>>;renameColumn(table:string,oldName:string,newName:string):Promise<Result<{changes?:number;}>>;dropColumn(table:string,column:string):Promise<Result<{changes?:number;}>>;dropTable(table:string):Promise<Result<{changes?:number;}>>;createIndex(table:string,index:IndexDef):Promise<Result<{changes?:number;}>>;dropIndex(indexName:string):Promise<Result<{changes?:number;}>>;private getTableInfoSync;}