@uql/core 1.0.12 → 3.1.0

package/dist/util/sql.util.js

@@ -0,0 +1,78 @@
+import { getKeys, hasKeys } from './object.util.js';
+export function flatObject(obj, pre) {
+    return getKeys(obj).reduce((acc, key) => flatObjectEntry(acc, key, obj[key], typeof obj[key] === 'object' ? '' : pre), {});
+}
+function flatObjectEntry(map, key, val, pre) {
+    const prefix = pre ? `${pre}.${key}` : key;
+    return typeof val === 'object'
+        ? getKeys(val).reduce((acc, prop) => flatObjectEntry(acc, prop, val[prop], prefix), map)
+        : { ...map, [prefix]: val };
+}
+export function unflatObjects(objects) {
+    if (!Array.isArray(objects) || !objects.length) {
+        return objects;
+    }
+    const attrsPaths = obtainAttrsPaths(objects[0]);
+    if (!hasKeys(attrsPaths)) {
+        return objects;
+    }
+    return objects.map((row) => {
+        const dto = {};
+        for (const col in row) {
+            if (row[col] === null) {
+                continue;
+            }
+            const attrPath = attrsPaths[col];
+            if (attrPath) {
+                const target = attrPath.slice(0, -1).reduce((acc, key) => {
+                    if (typeof acc[key] !== 'object') {
+                        acc[key] = {};
+                    }
+                    return acc[key];
+                }, dto);
+                target[attrPath[attrPath.length - 1]] = row[col];
+            }
+            else {
+                dto[col] = row[col];
+            }
+        }
+        return dto;
+    });
+}
+export function obtainAttrsPaths(row) {
+    return getKeys(row).reduce((acc, col) => {
+        // Support both dot notation (legacy) and underscore notation (new)
+        if (col.includes('.')) {
+            acc[col] = col.split('.');
+        }
+        else if (col.includes('_') && col !== col.toUpperCase()) {
+            // Convert underscore to dot notation for nested paths
+            // Skip all-uppercase (like UPPER_CASE constants)
+            acc[col] = col.split('_');
+        }
+        return acc;
+    }, {});
+}
+/**
+ * Escape a SQL identifier (table name, column name, etc.)
+ * @param val the identifier to escape
+ * @param escapeIdChar the escape character to use (e.g. ` or ")
+ * @param forbidQualified whether to forbid qualified identifiers (containing dots)
+ * @param addDot whether to add a dot suffix
+ */
+export function escapeSqlId(val, escapeIdChar = '`', forbidQualified, addDot) {
+    if (!val) {
+        return '';
+    }
+    if (!forbidQualified && val.includes('.')) {
+        const result = val
+            .split('.')
+            .map((it) => escapeSqlId(it, escapeIdChar, true))
+            .join('.');
+        return addDot ? result + '.' : result;
+    }
+    const escaped = escapeIdChar + val.replace(new RegExp(escapeIdChar, 'g'), escapeIdChar + escapeIdChar) + escapeIdChar;
+    const suffix = addDot ? '.' : '';
+    return escaped + suffix;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3FsLnV0aWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbC9zcWwudXRpbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRXBELE1BQU0sVUFBVSxVQUFVLENBQUksR0FBTSxFQUFFLEdBQVk7SUFDaEQsT0FBTyxPQUFPLENBQUMsR0FBRyxDQUFDLENBQUMsTUFBTSxDQUN4QixDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsRUFBRSxDQUFDLGVBQWUsQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsQ0FBQyxHQUFhLENBQUMsRUFBRSxPQUFPLEdBQUcsQ0FBQyxHQUFhLENBQUMsS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLEVBQzlHLEVBQU8sQ0FDUixDQUFDO0FBQ0osQ0FBQztBQUVELFNBQVMsZUFBZSxDQUFJLEdBQU0sRUFBRSxHQUFXLEVBQUUsR0FBUSxFQUFFLEdBQVk7SUFDckUsTUFBTSxNQUFNLEdBQUcsR0FBRyxDQUFDLENBQUMsQ0FBQyxHQUFHLEdBQUcsSUFBSSxHQUFHLEVBQUUsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDO0lBQzNDLE9BQU8sT0FBTyxHQUFHLEtBQUssUUFBUTtRQUM1QixDQUFDLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLEdBQUcsRUFBRSxJQUFJLEVBQUUsRUFBRSxDQUFDLGVBQWUsQ0FBQyxHQUFHLEVBQUUsSUFBSSxFQUFFLEdBQUcsQ0FBQyxJQUFJLENBQUMsRUFBRSxNQUFNLENBQUMsRUFBRSxHQUFHLENBQUM7UUFDeEYsQ0FBQyxDQUFDLEVBQUUsR0FBRyxHQUFHLEVBQUUsQ0FBQyxNQUFNLENBQUMsRUFBRSxHQUFHLEVBQUUsQ0FBQztBQUNoQyxDQUFDO0FBRUQsTUFBTSxVQUFVLGFBQWEsQ0FBSSxPQUFZO0lBQzNDLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLE1BQU0sRUFBRSxDQUFDO1FBQy9DLE9BQU8sT0FBTyxDQUFDO0lBQ2pCLENBQUM7SUFFRCxNQUFNLFVBQVUsR0FBRyxnQkFBZ0IsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUVoRCxJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxFQUFFLENBQUM7UUFDekIsT0FBTyxPQUFPLENBQUM7SUFDakIsQ0FBQztJQUVELE9BQU8sT0FBTyxDQUFDLEdBQUcsQ0FBQyxDQUFDLEdBQUcsRUFBRSxFQUFFO1FBQ3pCLE1BQU0sR0FBRyxHQUFHLEVBQU8sQ0FBQztRQUVwQixLQUFLLE1BQU0sR0FBRyxJQUFJLEdBQUcsRUFBRSxDQUFDO1lBQ3RCLElBQUksR0FBRyxDQUFDLEdBQUcsQ0FBQyxLQUFLLElBQUksRUFBRSxDQUFDO2dCQUN0QixTQUFTO1lBQ1gsQ0FBQztZQUNELE1BQU0sUUFBUSxHQUFHLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQztZQUNqQyxJQUFJLFFBQVEsRUFBRSxDQUFDO2dCQUNiLE1BQU0sTUFBTSxHQUFHLFFBQVEsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUN6QyxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsRUFBRTtvQkFDWCxJQUFJLE9BQU8sR0FBRyxDQUFDLEdBQWEsQ0FBQyxLQUFLLFFBQVEsRUFBRSxDQUFDO3dCQUMzQyxHQUFHLENBQUMsR0FBYSxDQUFDLEdBQUcsRUFBbUIsQ0FBQztvQkFDM0MsQ0FBQztvQkFDRCxPQUFPLEdBQUcsQ0FBQyxHQUFhLENBQUMsQ0FBQztnQkFDNUIsQ0FBQyxFQUNELEdBQTBCLENBQzNCLENBQUM7Z0JBQ0YsTUFBTSxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsTUFBTSxHQUFHLENBQUMsQ0FBQyxDQUFDLEdBQUcsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1lBQ25ELENBQUM7aUJBQU0sQ0FBQztnQkFDTixHQUFHLENBQUMsR0FBRyxDQUFDLEdBQUcsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1lBQ3RCLENBQUM7UUFDSCxDQUFDO1FBRUQsT0FBTyxHQUFHLENBQUM7SUFDYixDQUFDLENBQUMsQ0FBQztBQUNMLENBQUM7QUFFRCxNQUFNLFVBQVUsZ0JBQWdCLENBQUksR0FBTTtJQUN4QyxPQUFPLE9BQU8sQ0FBQyxHQUFHLENBQUMsQ0FBQyxNQUFNLENBQ3hCLENBQUMsR0FBRyxFQUFFLEdBQUcsRUFBRSxFQUFFO1FBQ1gsbUVBQW1FO1FBQ25FLElBQUksR0FBRyxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO1lBQ3RCLEdBQUcsQ0FBQyxHQUFHLENBQUMsR0FBRyxHQUFHLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQzVCLENBQUM7YUFBTSxJQUFJLEdBQUcsQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFDLElBQUksR0FBRyxLQUFLLEdBQUcsQ0FBQyxXQUFXLEVBQUUsRUFBRSxDQUFDO1lBQzFELHNEQUFzRDtZQUN0RCxpREFBaUQ7WUFDakQsR0FBRyxDQUFDLEdBQUcsQ0FBQyxHQUFHLEdBQUcsQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDNUIsQ0FBQztRQUNELE9BQU8sR0FBRyxDQUFDO0lBQ2IsQ0FBQyxFQUNELEVBQStCLENBQ2hDLENBQUM7QUFDSixDQUFDO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsTUFBTSxVQUFVLFdBQVcsQ0FDekIsR0FBVyxFQUNYLGVBQTBCLEdBQUcsRUFDN0IsZUFBeUIsRUFDekIsTUFBZ0I7SUFFaEIsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO1FBQ1QsT0FBTyxFQUFFLENBQUM7SUFDWixDQUFDO0lBRUQsSUFBSSxDQUFDLGVBQWUsSUFBSSxHQUFHLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDMUMsTUFBTSxNQUFNLEdBQUcsR0FBRzthQUNmLEtBQUssQ0FBQyxHQUFHLENBQUM7YUFDVixHQUFHLENBQUMsQ0FBQyxFQUFFLEVBQUUsRUFBRSxDQUFDLFdBQVcsQ0FBQyxFQUFFLEVBQUUsWUFBWSxFQUFFLElBQUksQ0FBQyxDQUFDO2FBQ2hELElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUNiLE9BQU8sTUFBTSxDQUFDLENBQUMsQ0FBQyxNQUFNLEdBQUcsR0FBRyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUM7SUFDeEMsQ0FBQztJQUVELE1BQU0sT0FBTyxHQUFHLFlBQVksR0FBRyxHQUFHLENBQUMsT0FBTyxDQUFDLElBQUksTUFBTSxDQUFDLFlBQVksRUFBRSxHQUFHLENBQUMsRUFBRSxZQUFZLEdBQUcsWUFBWSxDQUFDLEdBQUcsWUFBWSxDQUFDO0lBRXRILE1BQU0sTUFBTSxHQUFHLE1BQU0sQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7SUFFakMsT0FBTyxPQUFPLEdBQUcsTUFBTSxDQUFDO0FBQzFCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgdHlwZSB7IEZpZWxkVmFsdWUsIEtleSB9IGZyb20gJy4uL3R5cGUvaW5kZXguanMnO1xuaW1wb3J0IHsgZ2V0S2V5cywgaGFzS2V5cyB9IGZyb20gJy4vb2JqZWN0LnV0aWwuanMnO1xuXG5leHBvcnQgZnVuY3Rpb24gZmxhdE9iamVjdDxFPihvYmo6IEUsIHByZT86IHN0cmluZyk6IEUge1xuICByZXR1cm4gZ2V0S2V5cyhvYmopLnJlZHVjZShcbiAgICAoYWNjLCBrZXkpID0+IGZsYXRPYmplY3RFbnRyeShhY2MsIGtleSwgb2JqW2tleSBhcyBLZXk8RT5dLCB0eXBlb2Ygb2JqW2tleSBhcyBLZXk8RT5dID09PSAnb2JqZWN0JyA/ICcnIDogcHJlKSxcbiAgICB7fSBhcyBFLFxuICApO1xufVxuXG5mdW5jdGlvbiBmbGF0T2JqZWN0RW50cnk8RT4obWFwOiBFLCBrZXk6IHN0cmluZywgdmFsOiBhbnksIHByZT86IHN0cmluZyk6IEUge1xuICBjb25zdCBwcmVmaXggPSBwcmUgPyBgJHtwcmV9LiR7a2V5fWAgOiBrZXk7XG4gIHJldHVybiB0eXBlb2YgdmFsID09PSAnb2JqZWN0J1xuICAgID8gZ2V0S2V5cyh2YWwpLnJlZHVjZSgoYWNjLCBwcm9wKSA9PiBmbGF0T2JqZWN0RW50cnkoYWNjLCBwcm9wLCB2YWxbcHJvcF0sIHByZWZpeCksIG1hcClcbiAgICA6IHsgLi4ubWFwLCBbcHJlZml4XTogdmFsIH07XG59XG5cbmV4cG9ydCBmdW5jdGlvbiB1bmZsYXRPYmplY3RzPFQ+KG9iamVjdHM6IFRbXSk6IFRbXSB7XG4gIGlmICghQXJyYXkuaXNBcnJheShvYmplY3RzKSB8fCAhb2JqZWN0cy5sZW5ndGgpIHtcbiAgICByZXR1cm4gb2JqZWN0cztcbiAgfVxuXG4gIGNvbnN0IGF0dHJzUGF0aHMgPSBvYnRhaW5BdHRyc1BhdGhzKG9iamVjdHNbMF0pO1xuXG4gIGlmICghaGFzS2V5cyhhdHRyc1BhdGhzKSkge1xuICAgIHJldHVybiBvYmplY3RzO1xuICB9XG5cbiAgcmV0dXJuIG9iamVjdHMubWFwKChyb3cpID0+IHtcbiAgICBjb25zdCBkdG8gPSB7fSBhcyBUO1xuXG4gICAgZm9yIChjb25zdCBjb2wgaW4gcm93KSB7XG4gICAgICBpZiAocm93W2NvbF0gPT09IG51bGwpIHtcbiAgICAgICAgY29udGludWU7XG4gICAgICB9XG4gICAgICBjb25zdCBhdHRyUGF0aCA9IGF0dHJzUGF0aHNbY29sXTtcbiAgICAgIGlmIChhdHRyUGF0aCkge1xuICAgICAgICBjb25zdCB0YXJnZXQgPSBhdHRyUGF0aC5zbGljZSgwLCAtMSkucmVkdWNlKFxuICAgICAgICAgIChhY2MsIGtleSkgPT4ge1xuICAgICAgICAgICAgaWYgKHR5cGVvZiBhY2Nba2V5IGFzIEtleTxUPl0gIT09ICdvYmplY3QnKSB7XG4gICAgICAgICAgICAgIGFjY1trZXkgYXMgS2V5PFQ+XSA9IHt9IGFzIEZpZWxkVmFsdWU8VD47XG4gICAgICAgICAgICB9XG4gICAgICAgICAgICByZXR1cm4gYWNjW2tleSBhcyBLZXk8VD5dO1xuICAgICAgICAgIH0sXG4gICAgICAgICAgZHRvIGFzIFJlY29yZDxzdHJpbmcsIGFueT4sXG4gICAgICAgICk7XG4gICAgICAgIHRhcmdldFthdHRyUGF0aFthdHRyUGF0aC5sZW5ndGggLSAxXV0gPSByb3dbY29sXTtcbiAgICAgIH0gZWxzZSB7XG4gICAgICAgIGR0b1tjb2xdID0gcm93W2NvbF07XG4gICAgICB9XG4gICAgfVxuXG4gICAgcmV0dXJuIGR0bztcbiAgfSk7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBvYnRhaW5BdHRyc1BhdGhzPFQ+KHJvdzogVCkge1xuICByZXR1cm4gZ2V0S2V5cyhyb3cpLnJlZHVjZShcbiAgICAoYWNjLCBjb2wpID0+IHtcbiAgICAgIC8vIFN1cHBvcnQgYm90aCBkb3Qgbm90YXRpb24gKGxlZ2FjeSkgYW5kIHVuZGVyc2NvcmUgbm90YXRpb24gKG5ldylcbiAgICAgIGlmIChjb2wuaW5jbHVkZXMoJy4nKSkge1xuICAgICAgICBhY2NbY29sXSA9IGNvbC5zcGxpdCgnLicpO1xuICAgICAgfSBlbHNlIGlmIChjb2wuaW5jbHVkZXMoJ18nKSAmJiBjb2wgIT09IGNvbC50b1VwcGVyQ2FzZSgpKSB7XG4gICAgICAgIC8vIENvbnZlcnQgdW5kZXJzY29yZSB0byBkb3Qgbm90YXRpb24gZm9yIG5lc3RlZCBwYXRoc1xuICAgICAgICAvLyBTa2lwIGFsbC11cHBlcmNhc2UgKGxpa2UgVVBQRVJfQ0FTRSBjb25zdGFudHMpXG4gICAgICAgIGFjY1tjb2xdID0gY29sLnNwbGl0KCdfJyk7XG4gICAgICB9XG4gICAgICByZXR1cm4gYWNjO1xuICAgIH0sXG4gICAge30gYXMgeyBbazogc3RyaW5nXTogc3RyaW5nW10gfSxcbiAgKTtcbn1cblxuLyoqXG4gKiBFc2NhcGUgYSBTUUwgaWRlbnRpZmllciAodGFibGUgbmFtZSwgY29sdW1uIG5hbWUsIGV0Yy4pXG4gKiBAcGFyYW0gdmFsIHRoZSBpZGVudGlmaWVyIHRvIGVzY2FwZVxuICogQHBhcmFtIGVzY2FwZUlkQ2hhciB0aGUgZXNjYXBlIGNoYXJhY3RlciB0byB1c2UgKGUuZy4gYCBvciBcIilcbiAqIEBwYXJhbSBmb3JiaWRRdWFsaWZpZWQgd2hldGhlciB0byBmb3JiaWQgcXVhbGlmaWVkIGlkZW50aWZpZXJzIChjb250YWluaW5nIGRvdHMpXG4gKiBAcGFyYW0gYWRkRG90IHdoZXRoZXIgdG8gYWRkIGEgZG90IHN1ZmZpeFxuICovXG5leHBvcnQgZnVuY3Rpb24gZXNjYXBlU3FsSWQoXG4gIHZhbDogc3RyaW5nLFxuICBlc2NhcGVJZENoYXI6ICdgJyB8ICdcIicgPSAnYCcsXG4gIGZvcmJpZFF1YWxpZmllZD86IGJvb2xlYW4sXG4gIGFkZERvdD86IGJvb2xlYW4sXG4pOiBzdHJpbmcge1xuICBpZiAoIXZhbCkge1xuICAgIHJldHVybiAnJztcbiAgfVxuXG4gIGlmICghZm9yYmlkUXVhbGlmaWVkICYmIHZhbC5pbmNsdWRlcygnLicpKSB7XG4gICAgY29uc3QgcmVzdWx0ID0gdmFsXG4gICAgICAuc3BsaXQoJy4nKVxuICAgICAgLm1hcCgoaXQpID0+IGVzY2FwZVNxbElkKGl0LCBlc2NhcGVJZENoYXIsIHRydWUpKVxuICAgICAgLmpvaW4oJy4nKTtcbiAgICByZXR1cm4gYWRkRG90ID8gcmVzdWx0ICsgJy4nIDogcmVzdWx0O1xuICB9XG5cbiAgY29uc3QgZXNjYXBlZCA9IGVzY2FwZUlkQ2hhciArIHZhbC5yZXBsYWNlKG5ldyBSZWdFeHAoZXNjYXBlSWRDaGFyLCAnZycpLCBlc2NhcGVJZENoYXIgKyBlc2NhcGVJZENoYXIpICsgZXNjYXBlSWRDaGFyO1xuXG4gIGNvbnN0IHN1ZmZpeCA9IGFkZERvdCA/ICcuJyA6ICcnO1xuXG4gIHJldHVybiBlc2NhcGVkICsgc3VmZml4O1xufVxuIl19

package/{util → dist/util}/string.util.d.ts

@@ -1,3 +1,4 @@
 export declare function kebabCase(val: string): string;
 export declare function upperFirst(text: string): string;
 export declare function lowerFirst(text: string): string;
+export declare function snakeCase(val: string): string;

package/dist/util/string.util.js

@@ -0,0 +1,34 @@
+export function kebabCase(val) {
+    let resp = val.charAt(0).toLowerCase();
+    for (let i = 1; i < val.length; ++i) {
+        resp += val[i] === val[i].toUpperCase() ? '-' + val[i].toLowerCase() : val[i];
+    }
+    return resp;
+}
+export function upperFirst(text) {
+    return text[0].toUpperCase() + text.slice(1);
+}
+export function lowerFirst(text) {
+    return text[0].toLowerCase() + text.slice(1);
+}
+export function snakeCase(val) {
+    if (val === undefined || val === null) {
+        return val;
+    }
+    if (!val) {
+        return '';
+    }
+    let resp = val.charAt(0).toLowerCase();
+    for (let i = 1; i < val.length; ++i) {
+        const char = val[i];
+        const charLower = char.toLowerCase();
+        if (char !== charLower && char === char.toUpperCase()) {
+            resp += '_' + charLower;
+        }
+        else {
+            resp += char;
+        }
+    }
+    return resp;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RyaW5nLnV0aWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbC9zdHJpbmcudXRpbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxNQUFNLFVBQVUsU0FBUyxDQUFDLEdBQVc7SUFDbkMsSUFBSSxJQUFJLEdBQUcsR0FBRyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBQyxXQUFXLEVBQUUsQ0FBQztJQUN2QyxLQUFLLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLEdBQUcsR0FBRyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsRUFBRSxDQUFDO1FBQ3BDLElBQUksSUFBSSxHQUFHLENBQUMsQ0FBQyxDQUFDLEtBQUssR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLFdBQVcsRUFBRSxDQUFDLENBQUMsQ0FBQyxHQUFHLEdBQUcsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLFdBQVcsRUFBRSxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDaEYsQ0FBQztJQUNELE9BQU8sSUFBSSxDQUFDO0FBQ2QsQ0FBQztBQUVELE1BQU0sVUFBVSxVQUFVLENBQUMsSUFBWTtJQUNyQyxPQUFPLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQyxXQUFXLEVBQUUsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDO0FBQy9DLENBQUM7QUFFRCxNQUFNLFVBQVUsVUFBVSxDQUFDLElBQVk7SUFDckMsT0FBTyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsV0FBVyxFQUFFLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQztBQUMvQyxDQUFDO0FBRUQsTUFBTSxVQUFVLFNBQVMsQ0FBQyxHQUFXO0lBQ25DLElBQUksR0FBRyxLQUFLLFNBQVMsSUFBSSxHQUFHLEtBQUssSUFBSSxFQUFFLENBQUM7UUFDdEMsT0FBTyxHQUFHLENBQUM7SUFDYixDQUFDO0lBQ0QsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO1FBQ1QsT0FBTyxFQUFFLENBQUM7SUFDWixDQUFDO0lBQ0QsSUFBSSxJQUFJLEdBQUcsR0FBRyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBQyxXQUFXLEVBQUUsQ0FBQztJQUN2QyxLQUFLLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLEdBQUcsR0FBRyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsRUFBRSxDQUFDO1FBQ3BDLE1BQU0sSUFBSSxHQUFHLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUNwQixNQUFNLFNBQVMsR0FBRyxJQUFJLENBQUMsV0FBVyxFQUFFLENBQUM7UUFDckMsSUFBSSxJQUFJLEtBQUssU0FBUyxJQUFJLElBQUksS0FBSyxJQUFJLENBQUMsV0FBVyxFQUFFLEVBQUUsQ0FBQztZQUN0RCxJQUFJLElBQUksR0FBRyxHQUFHLFNBQVMsQ0FBQztRQUMxQixDQUFDO2FBQU0sQ0FBQztZQUNOLElBQUksSUFBSSxJQUFJLENBQUM7UUFDZixDQUFDO0lBQ0gsQ0FBQztJQUNELE9BQU8sSUFBSSxDQUFDO0FBQ2QsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCBmdW5jdGlvbiBrZWJhYkNhc2UodmFsOiBzdHJpbmcpOiBzdHJpbmcge1xuICBsZXQgcmVzcCA9IHZhbC5jaGFyQXQoMCkudG9Mb3dlckNhc2UoKTtcbiAgZm9yIChsZXQgaSA9IDE7IGkgPCB2YWwubGVuZ3RoOyArK2kpIHtcbiAgICByZXNwICs9IHZhbFtpXSA9PT0gdmFsW2ldLnRvVXBwZXJDYXNlKCkgPyAnLScgKyB2YWxbaV0udG9Mb3dlckNhc2UoKSA6IHZhbFtpXTtcbiAgfVxuICByZXR1cm4gcmVzcDtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHVwcGVyRmlyc3QodGV4dDogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIHRleHRbMF0udG9VcHBlckNhc2UoKSArIHRleHQuc2xpY2UoMSk7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBsb3dlckZpcnN0KHRleHQ6IHN0cmluZyk6IHN0cmluZyB7XG4gIHJldHVybiB0ZXh0WzBdLnRvTG93ZXJDYXNlKCkgKyB0ZXh0LnNsaWNlKDEpO1xufVxuXG5leHBvcnQgZnVuY3Rpb24gc25ha2VDYXNlKHZhbDogc3RyaW5nKTogc3RyaW5nIHtcbiAgaWYgKHZhbCA9PT0gdW5kZWZpbmVkIHx8IHZhbCA9PT0gbnVsbCkge1xuICAgIHJldHVybiB2YWw7XG4gIH1cbiAgaWYgKCF2YWwpIHtcbiAgICByZXR1cm4gJyc7XG4gIH1cbiAgbGV0IHJlc3AgPSB2YWwuY2hhckF0KDApLnRvTG93ZXJDYXNlKCk7XG4gIGZvciAobGV0IGkgPSAxOyBpIDwgdmFsLmxlbmd0aDsgKytpKSB7XG4gICAgY29uc3QgY2hhciA9IHZhbFtpXTtcbiAgICBjb25zdCBjaGFyTG93ZXIgPSBjaGFyLnRvTG93ZXJDYXNlKCk7XG4gICAgaWYgKGNoYXIgIT09IGNoYXJMb3dlciAmJiBjaGFyID09PSBjaGFyLnRvVXBwZXJDYXNlKCkpIHtcbiAgICAgIHJlc3AgKz0gJ18nICsgY2hhckxvd2VyO1xuICAgIH0gZWxzZSB7XG4gICAgICByZXNwICs9IGNoYXI7XG4gICAgfVxuICB9XG4gIHJldHVybiByZXNwO1xufVxuIl19

package/package.json

@@ -1,30 +1,97 @@
 {
   "name": "@uql/core",
-  "homepage": "https://nukak.org",
-  "description": "flexible and efficient ORM, with declarative JSON syntax and smart type-safety",
+  "homepage": "https://uql.app",
+  "description": "One Language. Frontend to Backend.",
   "license": "MIT",
-  "version": "1.0.12",
-  "main": "index.js",
+  "version": "3.1.0",
+  "type": "module",
+  "main": "./index.js",
   "types": "./index.d.ts",
+  "bin": {
+    "uql-migrate": "./migrate/cli.js"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./dialect": "./dialect/index.js",
+    "./entity": "./entity/index.js",
+    "./querier": "./querier/index.js",
+    "./repository": "./repository/index.js",
+    "./type": "./type/index.js",
+    "./util": "./util/index.js",
+    "./namingStrategy": "./namingStrategy/index.js",
+    "./migrate": "./migrate/index.js",
+    "./options": "./options.js",
+    "./test": "./test/index.js",
+    "./mysql": "./mysql/index.js",
+    "./postgres": "./postgres/index.js",
+    "./maria": "./maria/index.js",
+    "./sqlite": "./sqlite/index.js",
+    "./mongo": "./mongo/index.js",
+    "./express": "./express/index.js",
+    "./browser": {
+      "types": "./browser/index.d.ts",
+      "import": "./browser/index.js",
+      "default": "./browser/uql-browser.min.js"
+    }
+  },
+  "sideEffects": false,
   "scripts": {
-    "copyfiles": "copyfiles -f package.json ../../README.md ../../CHANGELOG.md dist",
-    "build": "yarn clean && tsc -b tsconfig.build.json && yarn copyfiles",
+    "copyfiles": "copyfiles -f package.json ../README.md ../CHANGELOG.md dist",
+    "compile.browser": "bunchee --clean false --no-dts ./src/browser/index.ts --sourcemap -o ./dist/browser/uql-browser.min.js",
+    "build": "bun run clean && tsc -b tsconfig.build.json && bun run compile.browser && bun run copyfiles",
     "start": "tsc --watch",
     "clean": "rimraf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "reflect-metadata": "^0.1.13",
+    "reflect-metadata": "^0.2.2",
     "sqlstring": "^2.3.3",
-    "tslib": "^2.4.0"
+    "sqlstring-sqlite": "^0.1.1",
+    "tslib": "^2.8.1"
+  },
+  "peerDependencies": {
+    "better-sqlite3": ">=9.0.0",
+    "express": ">=5.0.0",
+    "mariadb": ">=3.0.0",
+    "mongodb": ">=6.0.0",
+    "mysql2": ">=3.0.0",
+    "pg": ">=8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "mariadb": {
+      "optional": true
+    },
+    "mongodb": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@types/node": "^18.0.6",
-    "@types/sqlstring": "^2.3.0",
-    "@types/uuid": "^8.3.4",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.0.3",
+    "@types/pg": "^8.16.0",
+    "@types/sqlstring": "^2.3.2",
+    "better-sqlite3": "^12.5.0",
+    "bunchee": "^6.9.1",
     "copyfiles": "^2.4.1",
-    "rimraf": "^3.0.2",
-    "typescript": "^4.7.4",
-    "uuid": "^8.3.2"
+    "express": "^5.2.1",
+    "mariadb": "^3.4.5",
+    "mongodb": "^7.0.0",
+    "mysql2": "^3.16.0",
+    "pg": "^8.16.3",
+    "rimraf": "^6.1.2",
+    "typescript": "~5.4.5"
   },
   "author": "Roger Padilla",
   "repository": {
@@ -54,10 +121,11 @@
     "dao",
     "transaction",
     "repository",
-    "service"
+    "service",
+    "migrations"
   ],
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "3ced0c218364ddcd9e234096155ff205a7583b13"
-}
+  "gitHead": "47f2055cf30ab5655ac57ba4278e8c7b4541db0b"
+}

package/src/@types/index.d.ts

@@ -0,0 +1 @@
+import './jest';

package/src/@types/jest.d.ts

@@ -0,0 +1,6 @@
+/** biome-ignore-all lint/style/noNamespace: compat */
+declare namespace jest {
+  export interface Expect {
+    toMatch: (received: RegExp) => any;
+  }
+}

package/src/browser/http/bus.spec.ts

@@ -0,0 +1,22 @@
+import { expect, it } from 'bun:test';
+import type { RequestNotification } from '../type/index.js';
+import { notify, on } from './bus.js';
+
+it('bus', () => {
+  const off = on((msg) => {
+    const expected: RequestNotification = {
+      phase: 'start',
+      opts: {
+        silent: true,
+      },
+    };
+    expect(msg).toEqual(expected);
+    off();
+  });
+  notify({
+    phase: 'start',
+    opts: {
+      silent: true,
+    },
+  });
+});

package/src/browser/http/bus.ts

@@ -0,0 +1,17 @@
+import type { RequestCallback, RequestNotification } from '../type/index.js';
+
+const subscriptors: RequestCallback[] = [];
+
+export function notify(notification: RequestNotification): void {
+  for (const subscriptor of subscriptors) {
+    subscriptor(notification);
+  }
+}
+
+export function on(cb: RequestCallback): () => void {
+  subscriptors.push(cb);
+  const index = subscriptors.length - 1;
+  return (): void => {
+    subscriptors.splice(index, 1);
+  };
+}

package/src/browser/http/http.spec.ts

@@ -0,0 +1,70 @@
+import { afterEach, beforeEach, describe, expect, it, jest } from 'bun:test';
+import { get, patch, post, put, remove } from './http.js';
+
+describe('http', () => {
+  beforeEach(() => {
+    globalThis.fetch = jest.fn() as any;
+    (globalThis.fetch as unknown as jest.Mock).mockImplementation(setupFetchStub({}));
+  });
+
+  afterEach(() => {
+    delete globalThis.fetch;
+  });
+
+  it('post', async () => {
+    const body = {};
+    await post('/', body);
+    expect(globalThis.fetch).toHaveBeenCalledWith(
+      '/',
+      expect.objectContaining({ body: JSON.stringify(body), method: 'post' }),
+    );
+  });
+
+  it('patch', async () => {
+    const body = {};
+    await patch('/', body);
+    expect(globalThis.fetch).toHaveBeenCalledWith(
+      '/',
+      expect.objectContaining({ body: JSON.stringify(body), method: 'patch' }),
+    );
+  });
+
+  it('put', async () => {
+    const body = {};
+    await put('/', body);
+    expect(globalThis.fetch).toHaveBeenCalledWith(
+      '/',
+      expect.objectContaining({ body: JSON.stringify(body), method: 'put' }),
+    );
+  });
+
+  it('get', async () => {
+    await get('/?a=1');
+    expect(globalThis.fetch).toHaveBeenCalledWith('/?a=1', expect.objectContaining({ method: 'get' }));
+  });
+
+  it('remove', async () => {
+    await remove('/?a=1');
+    expect(globalThis.fetch).toHaveBeenCalledWith('/?a=1', expect.objectContaining({ method: 'delete' }));
+  });
+
+  it('error', async () => {
+    globalThis.fetch = jest.fn() as any;
+    (globalThis.fetch as unknown as jest.Mock).mockImplementation(setupFetchStubError(new Error('some error')));
+    await expect(remove('/?a=1')).rejects.toThrow('some error');
+  });
+});
+
+function setupFetchStub(data: object) {
+  return async (_url: any) => ({
+    status: 200,
+    json: async () => ({ data }),
+  });
+}
+
+function setupFetchStubError(error: Error) {
+  return async (_url: any) => ({
+    status: 500,
+    json: async () => ({ error }),
+  });
+}

package/src/browser/http/http.ts

@@ -0,0 +1,55 @@
+import type { RequestErrorResponse, RequestOptions, RequestSuccessResponse } from '../type/index.js';
+import { notify } from './bus.js';
+
+export function get<T>(url: string, opts?: RequestOptions) {
+  return request<T>(url, { method: 'get' }, opts);
+}
+
+export function post<T>(url: string, payload: unknown, opts?: RequestOptions) {
+  const body = JSON.stringify(payload);
+  return request<T>(url, { method: 'post', body }, opts);
+}
+
+export function patch<T>(url: string, payload: unknown, opts?: RequestOptions) {
+  const body = JSON.stringify(payload);
+  return request<T>(url, { method: 'patch', body }, opts);
+}
+
+export function put<T>(url: string, payload: unknown, opts?: RequestOptions) {
+  const body = JSON.stringify(payload);
+  return request<T>(url, { method: 'put', body }, opts);
+}
+
+export function remove<T>(url: string, opts?: RequestOptions) {
+  return request<T>(url, { method: 'delete' }, opts);
+}
+
+function request<T>(url: string, init: RequestInit, opts?: RequestOptions) {
+  notify({ phase: 'start', opts });
+
+  init.headers = {
+    accept: 'application/json',
+    'content-type': 'application/json',
+  };
+
+  return fetch(url, init)
+    .then((rawResp) =>
+      rawResp.json().then((resp: unknown) => {
+        const isSuccess = rawResp.status >= 200 && rawResp.status < 300;
+        if (isSuccess) {
+          notify({ phase: 'success', opts });
+          return resp as RequestSuccessResponse<T>;
+        }
+        const errorResp = resp as RequestErrorResponse;
+        notify({
+          phase: 'error',
+          error: errorResp.error,
+          opts,
+        });
+        throw Error(errorResp.error.message);
+      }),
+    )
+    .finally(() => {
+      notify({ phase: 'complete', opts });
+    });
+}

package/src/browser/http/index.ts

@@ -0,0 +1,2 @@
+export * from './bus.js';
+export * from './http.js';

package/src/browser/index.ts

@@ -0,0 +1,4 @@
+export * from './http/index.js';
+export * from './options.js';
+export * from './querier/index.js';
+export * from './type/index.js';

package/src/browser/options.spec.ts

@@ -0,0 +1,37 @@
+import { describe, expect, it } from 'bun:test';
+import { User } from '../test/index.js';
+import { getQuerier, getQuerierPool, setQuerierPool } from './options.js';
+import { GenericClientRepository, HttpQuerier } from './querier/index.js';
+import type { ClientQuerierPool } from './type/clientQuerierPool.js';
+
+describe('options', () => {
+  it('default getQuerier', () => {
+    const querier = getQuerier();
+    expect(querier).toBeInstanceOf(HttpQuerier);
+  });
+
+  it('default querierPool', () => {
+    expect(getQuerierPool()).toBeDefined();
+  });
+
+  it('custom querierPool', () => {
+    const querierMock = new HttpQuerier('/');
+
+    const querierPool: ClientQuerierPool = {
+      getQuerier: () => querierMock,
+    };
+
+    setQuerierPool(querierPool);
+
+    const querier1 = getQuerierPool().getQuerier();
+    expect(querier1).toBe(querierMock);
+
+    const querier2 = getQuerier();
+    expect(querier2).toBe(querierMock);
+
+    const repository1 = querier2.getRepository(User);
+    expect(repository1).toBeInstanceOf(GenericClientRepository);
+
+    expect(getQuerierPool()).toBe(getQuerierPool());
+  });
+});

package/src/browser/options.ts

@@ -0,0 +1,18 @@
+import { HttpQuerier } from './querier/httpQuerier.js';
+import type { ClientQuerier, ClientQuerierPool } from './type/index.js';
+
+let defaultPool: ClientQuerierPool = {
+  getQuerier: () => new HttpQuerier('/api'),
+};
+
+export function setQuerierPool<T extends ClientQuerierPool>(pool: T) {
+  defaultPool = pool;
+}
+
+export function getQuerierPool(): ClientQuerierPool {
+  return defaultPool;
+}
+
+export function getQuerier(): ClientQuerier {
+  return getQuerierPool().getQuerier();
+}

package/src/browser/querier/genericClientRepository.spec.ts

@@ -0,0 +1,105 @@
+import { afterEach, beforeEach, describe, expect, it, jest } from 'bun:test';
+import { User } from '../../test/index.js';
+import { GenericClientRepository } from './genericClientRepository.js';
+import { HttpQuerier } from './httpQuerier.js';
+
+describe('repository', () => {
+  let repository: GenericClientRepository<User>;
+  const querier = new HttpQuerier('');
+
+  beforeEach(() => {
+    globalThis.fetch = jest.fn() as any;
+    (globalThis.fetch as unknown as jest.Mock).mockImplementation(setupFetchStub({}));
+    repository = new GenericClientRepository(User, querier);
+  });
+
+  afterEach(() => {
+    delete globalThis.fetch;
+  });
+
+  it('count', async () => {
+    await repository.count({});
+    expect(globalThis.fetch).toHaveBeenCalledWith('/user/count', expect.objectContaining({ method: 'get' }));
+  });
+
+  it('findOneById', async () => {
+    await repository.findOneById(1);
+    expect(globalThis.fetch).toHaveBeenCalledWith('/user/1', expect.objectContaining({ method: 'get' }));
+  });
+
+  it('findOne', async () => {
+    await repository.findOne({});
+    expect(globalThis.fetch).toHaveBeenCalledWith('/user/one', expect.objectContaining({ method: 'get' }));
+  });
+
+  it('findMany', async () => {
+    await repository.findMany({});
+    expect(globalThis.fetch).toHaveBeenCalledWith('/user', expect.objectContaining({ method: 'get' }));
+  });
+
+  it('findManyAndCount', async () => {
+    await repository.findManyAndCount({});
+    expect(globalThis.fetch).toHaveBeenCalledWith('/user?count=true', expect.objectContaining({ method: 'get' }));
+  });
+
+  it('insertOne', async () => {
+    await repository.insertOne({});
+    expect(globalThis.fetch).toHaveBeenCalledWith('/user', expect.objectContaining({ method: 'post' }));
+  });
+
+  it('updateOneById', async () => {
+    await repository.updateOneById(1, {});
+    expect(globalThis.fetch).toHaveBeenCalledWith('/user/1', expect.objectContaining({ method: 'patch' }));
+  });
+
+  it('saveOne', async () => {
+    await repository.saveOne({});
+    expect(globalThis.fetch).toHaveBeenCalledWith('/user', expect.objectContaining({ method: 'post' }));
+  });
+
+  it('saveOne id', async () => {
+    await repository.saveOne({ id: 2 });
+    expect(globalThis.fetch).toHaveBeenCalledWith('/user/2', expect.objectContaining({ method: 'patch' }));
+  });
+
+  it('deleteOneById', async () => {
+    await repository.deleteOneById(1);
+    expect(globalThis.fetch).toHaveBeenCalledWith('/user/1', expect.objectContaining({ method: 'delete' }));
+  });
+
+  it('deleteOneById soft', async () => {
+    await repository.deleteOneById(1, { softDelete: true });
+    expect(globalThis.fetch).toHaveBeenCalledWith(
+      '/user/1?softDelete=true',
+      expect.objectContaining({ method: 'delete' }),
+    );
+  });
+
+  it('deleteMany', async () => {
+    await repository.deleteMany({});
+    expect(globalThis.fetch).toHaveBeenCalledWith('/user', expect.objectContaining({ method: 'delete' }));
+  });
+
+  it('deleteMany soft', async () => {
+    await repository.deleteMany({}, { softDelete: true });
+    expect(globalThis.fetch).toHaveBeenCalledWith(
+      '/user?softDelete=true',
+      expect.objectContaining({ method: 'delete' }),
+    );
+  });
+
+  it('entity property', () => {
+    expect(repository.entity).toBe(User);
+  });
+
+  it('repository property', () => {
+    expect(repository.querier).toBe(querier);
+  });
+});
+
+function setupFetchStub(data: object) {
+  return async (_url: any) => ({
+    status: 200,
+    json: async () => ({ data }),
+  });
+}

package/src/browser/querier/genericClientRepository.ts

@@ -0,0 +1,49 @@
+import type { IdValue, Query, QueryOne, QueryOptions, QuerySearch, Type } from '../../type/index.js';
+import type { ClientQuerier, ClientRepository, RequestOptions } from '../type/index.js';
+
+export class GenericClientRepository<E> implements ClientRepository<E> {
+  constructor(
+    readonly entity: Type<E>,
+    readonly querier: ClientQuerier,
+  ) {}
+
+  findOneById(id: IdValue<E>, q?: QueryOne<E>, opts?: RequestOptions) {
+    return this.querier.findOneById(this.entity, id, q, opts);
+  }
+
+  findOne(q: QueryOne<E>, opts?: RequestOptions) {
+    return this.querier.findOne(this.entity, q, opts);
+  }
+
+  findMany(q: Query<E>, opts?: RequestOptions) {
+    return this.querier.findMany(this.entity, q, opts);
+  }
+
+  findManyAndCount(q: Query<E>, opts?: RequestOptions) {
+    return this.querier.findManyAndCount(this.entity, q, opts);
+  }
+
+  count(qm?: QuerySearch<E>, opts?: RequestOptions) {
+    return this.querier.count(this.entity, qm, opts);
+  }
+
+  insertOne(payload: E, opts?: RequestOptions) {
+    return this.querier.insertOne(this.entity, payload, opts);
+  }
+
+  updateOneById(id: IdValue<E>, payload: E, opts?: RequestOptions) {
+    return this.querier.updateOneById(this.entity, id, payload, opts);
+  }
+
+  saveOne(payload: E, opts?: RequestOptions) {
+    return this.querier.saveOne(this.entity, payload, opts);
+  }
+
+  deleteOneById(id: IdValue<E>, opts?: QueryOptions) {
+    return this.querier.deleteOneById(this.entity, id, opts);
+  }
+
+  deleteMany(qm: QuerySearch<E>, opts?: QueryOptions) {
+    return this.querier.deleteMany(this.entity, qm, opts);
+  }
+}