@xansql/bridge 1.0.0

package/base.js

@@ -0,0 +1,127 @@
+'use strict';
+
+var securequ = require('securequ');
+var core = require('@xansql/core');
+
+let secretCache = null;
+const makeSecret = async (xansql) => {
+    if (secretCache)
+        return secretCache;
+    const models = xansql.models;
+    let uid = [];
+    for (let model of models.values()) {
+        uid.push(model.table);
+        for (let column in model.schema) {
+            const field = model.schema[column];
+            if (!core.Foreign.isArray(model.schema[column])) {
+                uid.push(column);
+                const meta = field.meta || {};
+                const keys = Object.keys(meta);
+                if (keys.length) {
+                    keys.sort();
+                    uid.push(...keys);
+                }
+            }
+        }
+    }
+    uid = Array.from(new Set(uid)); // unique
+    uid = uid.sort();
+    secretCache = await securequ.crypto.hash(uid.join(""));
+    return secretCache;
+};
+const makePath = async (path, xansql) => {
+    const secret = await makeSecret(xansql);
+    const gen = `/${await securequ.crypto.hash(path + secret)}`;
+    return gen;
+};
+const sqlparser = (sql) => {
+    const normalized = sql.trim().replace(/\s+/g, " ");
+    // Detect the primary verb (first SQL keyword)
+    const verbMatch = normalized.match(/^(SELECT|INSERT|UPDATE|DELETE|DROP|ALTER|CREATE|TRUNCATE|REPLACE|DESCRIBE|DESC|SHOW|USE)\b/i);
+    let verb = "UNKNOWN";
+    if (verbMatch) {
+        const v = verbMatch[1].toUpperCase();
+        verb = v === "DESC" ? "DESCRIBE" : v;
+    }
+    // Matches identifiers: table, `table`, "table", [table]
+    const IDENT = `([\\\`"\\[]?)([A-Za-z0-9_.-]+)\\1`;
+    const extractTable = () => {
+        switch (verb) {
+            case "SELECT": {
+                // 1. Normal SELECT ... FROM table
+                const normal = normalized.match(/\bFROM\s+([`"\[]?)([A-Za-z0-9_.-]+)\1/i);
+                if (normal && normal[2] !== "(") {
+                    return normal[2]; // real table
+                }
+                // 2. Extract real tables inside a subquery: SELECT ... FROM ( SELECT ... FROM table )
+                const inner = normalized.match(/\(\s*SELECT[\s\S]+?\bFROM\s+([`"\[]?)([A-Za-z0-9_.-]+)\1/i);
+                if (inner)
+                    return inner[2];
+                return null;
+            }
+            case "INSERT": {
+                const match = new RegExp(`\\bINTO\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            case "UPDATE": {
+                const match = new RegExp(`^UPDATE\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            case "DELETE": {
+                const match = new RegExp(`\\bFROM\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // CREATE TABLE tableName
+            case "CREATE": {
+                const match = new RegExp(`\\bCREATE\\s+TABLE\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // DROP TABLE tableName
+            case "DROP": {
+                const match = new RegExp(`\\bDROP\\s+TABLE\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // ALTER TABLE tableName
+            case "ALTER": {
+                const match = new RegExp(`\\bALTER\\s+TABLE\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // TRUNCATE TABLE tableName
+            case "TRUNCATE": {
+                const match = new RegExp(`\\bTRUNCATE\\s+TABLE\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // REPLACE INTO tableName
+            case "REPLACE": {
+                const match = new RegExp(`\\bREPLACE\\s+INTO\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // DESCRIBE tableName
+            case "DESCRIBE": {
+                const match = new RegExp(`\\b(DESCRIBE|DESC)\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // SHOW TABLES / SHOW DATABASES => no table
+            case "SHOW": {
+                const match = new RegExp(`\\bSHOW\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null; // e.g. SHOW TABLES
+            }
+            // USE databaseName
+            case "USE": {
+                const match = new RegExp(`\\bUSE\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            default:
+                return null;
+        }
+    };
+    return {
+        action: verb,
+        table: extractTable(),
+    };
+};
+
+exports.makePath = makePath;
+exports.makeSecret = makeSecret;
+exports.sqlparser = sqlparser;
+//# sourceMappingURL=base.js.map

package/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sources":["../src/base.ts"],"sourcesContent":["import { crypto } from \"securequ\";\nimport { Xansql, Foreign } from \"@xansql/core\";\n\nlet secretCache: string | null = null;\nexport const makeSecret = async (xansql: Xansql) => {\n   if (secretCache) return secretCache;\n   const models = xansql.models\n   let uid = []\n   for (let model of models.values()) {\n      uid.push(model.table)\n      for (let column in model.schema) {\n         const field = model.schema[column]\n         if (!Foreign.isArray(model.schema[column])) {\n            uid.push(column)\n            const meta = field.meta || {}\n            const keys = Object.keys(meta)\n            if (keys.length) {\n               keys.sort()\n               uid.push(...keys)\n            }\n         }\n      }\n   }\n   uid = Array.from(new Set(uid)) // unique\n   uid = uid.sort()\n\n   secretCache = await crypto.hash(uid.join(\"\"))\n   return secretCache;\n}\n\nexport const makePath = async (path: string, xansql: Xansql) => {\n   const secret = await makeSecret(xansql)\n   const gen = `/${await crypto.hash(path + secret)}`\n   return gen;\n}\n\n\nexport type XansqlBridgeAction =\n   | \"SELECT\"\n   | \"INSERT\"\n   | \"UPDATE\"\n   | \"DELETE\"\n   | \"DROP\"\n   | \"ALTER\"\n   | \"CREATE\"\n   | \"TRUNCATE\"\n   | \"REPLACE\"\n   | \"DESCRIBE\"\n   | \"SHOW\"\n   | \"USE\"\n   | \"UNKNOWN\";\n\nexport interface SqlParserResult {\n   action: XansqlBridgeAction;\n   table: string | null;\n}\n\nexport const sqlparser = (sql: string): SqlParserResult => {\n   const normalized = sql.trim().replace(/\\s+/g, \" \");\n\n   // Detect the primary verb (first SQL keyword)\n   const verbMatch = normalized.match(\n      /^(SELECT|INSERT|UPDATE|DELETE|DROP|ALTER|CREATE|TRUNCATE|REPLACE|DESCRIBE|DESC|SHOW|USE)\\b/i\n   );\n\n   let verb: XansqlBridgeAction = \"UNKNOWN\";\n\n   if (verbMatch) {\n      const v = verbMatch[1].toUpperCase();\n      verb = v === \"DESC\" ? \"DESCRIBE\" : (v as XansqlBridgeAction);\n   }\n\n   // Matches identifiers: table, `table`, \"table\", [table]\n   const IDENT = `([\\\\\\`\"\\\\[]?)([A-Za-z0-9_.-]+)\\\\1`;\n\n   const extractTable = (): string | null => {\n      switch (verb) {\n         case \"SELECT\": {\n            // 1. Normal SELECT ... FROM table\n            const normal = normalized.match(/\\bFROM\\s+([`\"\\[]?)([A-Za-z0-9_.-]+)\\1/i);\n            if (normal && normal[2] !== \"(\") {\n               return normal[2]; // real table\n            }\n\n            // 2. Extract real tables inside a subquery: SELECT ... FROM ( SELECT ... FROM table )\n            const inner = normalized.match(\n               /\\(\\s*SELECT[\\s\\S]+?\\bFROM\\s+([`\"\\[]?)([A-Za-z0-9_.-]+)\\1/i\n            );\n            if (inner) return inner[2];\n\n            return null;\n         }\n         case \"INSERT\": {\n            const match = new RegExp(`\\\\bINTO\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n         case \"UPDATE\": {\n            const match = new RegExp(`^UPDATE\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n         case \"DELETE\": {\n            const match = new RegExp(`\\\\bFROM\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // CREATE TABLE tableName\n         case \"CREATE\": {\n            const match = new RegExp(`\\\\bCREATE\\\\s+TABLE\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // DROP TABLE tableName\n         case \"DROP\": {\n            const match = new RegExp(`\\\\bDROP\\\\s+TABLE\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // ALTER TABLE tableName\n         case \"ALTER\": {\n            const match = new RegExp(`\\\\bALTER\\\\s+TABLE\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // TRUNCATE TABLE tableName\n         case \"TRUNCATE\": {\n            const match = new RegExp(`\\\\bTRUNCATE\\\\s+TABLE\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // REPLACE INTO tableName\n         case \"REPLACE\": {\n            const match = new RegExp(`\\\\bREPLACE\\\\s+INTO\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // DESCRIBE tableName\n         case \"DESCRIBE\": {\n            const match = new RegExp(`\\\\b(DESCRIBE|DESC)\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // SHOW TABLES / SHOW DATABASES => no table\n         case \"SHOW\": {\n            const match = new RegExp(`\\\\bSHOW\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null; // e.g. SHOW TABLES\n         }\n\n         // USE databaseName\n         case \"USE\": {\n            const match = new RegExp(`\\\\bUSE\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         default:\n            return null;\n      }\n   };\n\n   return {\n      action: verb,\n      table: extractTable(),\n   };\n};\n"],"names":["Foreign","crypto"],"mappings":"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"}

package/base.mjs

@@ -0,0 +1,123 @@
+import { crypto } from 'securequ';
+import { Foreign } from '@xansql/core';
+
+let secretCache = null;
+const makeSecret = async (xansql) => {
+    if (secretCache)
+        return secretCache;
+    const models = xansql.models;
+    let uid = [];
+    for (let model of models.values()) {
+        uid.push(model.table);
+        for (let column in model.schema) {
+            const field = model.schema[column];
+            if (!Foreign.isArray(model.schema[column])) {
+                uid.push(column);
+                const meta = field.meta || {};
+                const keys = Object.keys(meta);
+                if (keys.length) {
+                    keys.sort();
+                    uid.push(...keys);
+                }
+            }
+        }
+    }
+    uid = Array.from(new Set(uid)); // unique
+    uid = uid.sort();
+    secretCache = await crypto.hash(uid.join(""));
+    return secretCache;
+};
+const makePath = async (path, xansql) => {
+    const secret = await makeSecret(xansql);
+    const gen = `/${await crypto.hash(path + secret)}`;
+    return gen;
+};
+const sqlparser = (sql) => {
+    const normalized = sql.trim().replace(/\s+/g, " ");
+    // Detect the primary verb (first SQL keyword)
+    const verbMatch = normalized.match(/^(SELECT|INSERT|UPDATE|DELETE|DROP|ALTER|CREATE|TRUNCATE|REPLACE|DESCRIBE|DESC|SHOW|USE)\b/i);
+    let verb = "UNKNOWN";
+    if (verbMatch) {
+        const v = verbMatch[1].toUpperCase();
+        verb = v === "DESC" ? "DESCRIBE" : v;
+    }
+    // Matches identifiers: table, `table`, "table", [table]
+    const IDENT = `([\\\`"\\[]?)([A-Za-z0-9_.-]+)\\1`;
+    const extractTable = () => {
+        switch (verb) {
+            case "SELECT": {
+                // 1. Normal SELECT ... FROM table
+                const normal = normalized.match(/\bFROM\s+([`"\[]?)([A-Za-z0-9_.-]+)\1/i);
+                if (normal && normal[2] !== "(") {
+                    return normal[2]; // real table
+                }
+                // 2. Extract real tables inside a subquery: SELECT ... FROM ( SELECT ... FROM table )
+                const inner = normalized.match(/\(\s*SELECT[\s\S]+?\bFROM\s+([`"\[]?)([A-Za-z0-9_.-]+)\1/i);
+                if (inner)
+                    return inner[2];
+                return null;
+            }
+            case "INSERT": {
+                const match = new RegExp(`\\bINTO\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            case "UPDATE": {
+                const match = new RegExp(`^UPDATE\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            case "DELETE": {
+                const match = new RegExp(`\\bFROM\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // CREATE TABLE tableName
+            case "CREATE": {
+                const match = new RegExp(`\\bCREATE\\s+TABLE\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // DROP TABLE tableName
+            case "DROP": {
+                const match = new RegExp(`\\bDROP\\s+TABLE\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // ALTER TABLE tableName
+            case "ALTER": {
+                const match = new RegExp(`\\bALTER\\s+TABLE\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // TRUNCATE TABLE tableName
+            case "TRUNCATE": {
+                const match = new RegExp(`\\bTRUNCATE\\s+TABLE\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // REPLACE INTO tableName
+            case "REPLACE": {
+                const match = new RegExp(`\\bREPLACE\\s+INTO\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // DESCRIBE tableName
+            case "DESCRIBE": {
+                const match = new RegExp(`\\b(DESCRIBE|DESC)\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            // SHOW TABLES / SHOW DATABASES => no table
+            case "SHOW": {
+                const match = new RegExp(`\\bSHOW\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null; // e.g. SHOW TABLES
+            }
+            // USE databaseName
+            case "USE": {
+                const match = new RegExp(`\\bUSE\\s+${IDENT}`, "i").exec(normalized);
+                return match ? match[2] : null;
+            }
+            default:
+                return null;
+        }
+    };
+    return {
+        action: verb,
+        table: extractTable(),
+    };
+};
+
+export { makePath, makeSecret, sqlparser };
+//# sourceMappingURL=base.mjs.map

package/base.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.mjs","sources":["../src/base.ts"],"sourcesContent":["import { crypto } from \"securequ\";\nimport { Xansql, Foreign } from \"@xansql/core\";\n\nlet secretCache: string | null = null;\nexport const makeSecret = async (xansql: Xansql) => {\n   if (secretCache) return secretCache;\n   const models = xansql.models\n   let uid = []\n   for (let model of models.values()) {\n      uid.push(model.table)\n      for (let column in model.schema) {\n         const field = model.schema[column]\n         if (!Foreign.isArray(model.schema[column])) {\n            uid.push(column)\n            const meta = field.meta || {}\n            const keys = Object.keys(meta)\n            if (keys.length) {\n               keys.sort()\n               uid.push(...keys)\n            }\n         }\n      }\n   }\n   uid = Array.from(new Set(uid)) // unique\n   uid = uid.sort()\n\n   secretCache = await crypto.hash(uid.join(\"\"))\n   return secretCache;\n}\n\nexport const makePath = async (path: string, xansql: Xansql) => {\n   const secret = await makeSecret(xansql)\n   const gen = `/${await crypto.hash(path + secret)}`\n   return gen;\n}\n\n\nexport type XansqlBridgeAction =\n   | \"SELECT\"\n   | \"INSERT\"\n   | \"UPDATE\"\n   | \"DELETE\"\n   | \"DROP\"\n   | \"ALTER\"\n   | \"CREATE\"\n   | \"TRUNCATE\"\n   | \"REPLACE\"\n   | \"DESCRIBE\"\n   | \"SHOW\"\n   | \"USE\"\n   | \"UNKNOWN\";\n\nexport interface SqlParserResult {\n   action: XansqlBridgeAction;\n   table: string | null;\n}\n\nexport const sqlparser = (sql: string): SqlParserResult => {\n   const normalized = sql.trim().replace(/\\s+/g, \" \");\n\n   // Detect the primary verb (first SQL keyword)\n   const verbMatch = normalized.match(\n      /^(SELECT|INSERT|UPDATE|DELETE|DROP|ALTER|CREATE|TRUNCATE|REPLACE|DESCRIBE|DESC|SHOW|USE)\\b/i\n   );\n\n   let verb: XansqlBridgeAction = \"UNKNOWN\";\n\n   if (verbMatch) {\n      const v = verbMatch[1].toUpperCase();\n      verb = v === \"DESC\" ? \"DESCRIBE\" : (v as XansqlBridgeAction);\n   }\n\n   // Matches identifiers: table, `table`, \"table\", [table]\n   const IDENT = `([\\\\\\`\"\\\\[]?)([A-Za-z0-9_.-]+)\\\\1`;\n\n   const extractTable = (): string | null => {\n      switch (verb) {\n         case \"SELECT\": {\n            // 1. Normal SELECT ... FROM table\n            const normal = normalized.match(/\\bFROM\\s+([`\"\\[]?)([A-Za-z0-9_.-]+)\\1/i);\n            if (normal && normal[2] !== \"(\") {\n               return normal[2]; // real table\n            }\n\n            // 2. Extract real tables inside a subquery: SELECT ... FROM ( SELECT ... FROM table )\n            const inner = normalized.match(\n               /\\(\\s*SELECT[\\s\\S]+?\\bFROM\\s+([`\"\\[]?)([A-Za-z0-9_.-]+)\\1/i\n            );\n            if (inner) return inner[2];\n\n            return null;\n         }\n         case \"INSERT\": {\n            const match = new RegExp(`\\\\bINTO\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n         case \"UPDATE\": {\n            const match = new RegExp(`^UPDATE\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n         case \"DELETE\": {\n            const match = new RegExp(`\\\\bFROM\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // CREATE TABLE tableName\n         case \"CREATE\": {\n            const match = new RegExp(`\\\\bCREATE\\\\s+TABLE\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // DROP TABLE tableName\n         case \"DROP\": {\n            const match = new RegExp(`\\\\bDROP\\\\s+TABLE\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // ALTER TABLE tableName\n         case \"ALTER\": {\n            const match = new RegExp(`\\\\bALTER\\\\s+TABLE\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // TRUNCATE TABLE tableName\n         case \"TRUNCATE\": {\n            const match = new RegExp(`\\\\bTRUNCATE\\\\s+TABLE\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // REPLACE INTO tableName\n         case \"REPLACE\": {\n            const match = new RegExp(`\\\\bREPLACE\\\\s+INTO\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // DESCRIBE tableName\n         case \"DESCRIBE\": {\n            const match = new RegExp(`\\\\b(DESCRIBE|DESC)\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         // SHOW TABLES / SHOW DATABASES => no table\n         case \"SHOW\": {\n            const match = new RegExp(`\\\\bSHOW\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null; // e.g. SHOW TABLES\n         }\n\n         // USE databaseName\n         case \"USE\": {\n            const match = new RegExp(`\\\\bUSE\\\\s+${IDENT}`, \"i\").exec(normalized);\n            return match ? match[2] : null;\n         }\n\n         default:\n            return null;\n      }\n   };\n\n   return {\n      action: verb,\n      table: extractTable(),\n   };\n};\n"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,13 @@
+import { XansqlDialectEngine, Xansql, ExecuterResult, XansqlFileMeta } from '@xansql/core';
+
+declare const XansqlBridge: (url: string, engine?: XansqlDialectEngine) => {
+    engine: XansqlDialectEngine;
+    execute: (sql: string, xansql: Xansql) => Promise<ExecuterResult>;
+    getSchema: (xansql: Xansql) => Promise<any>;
+    file: {
+        upload: (file: File, xansql: Xansql) => Promise<XansqlFileMeta>;
+        delete: (fileId: string, xansql: Xansql) => Promise<void>;
+    };
+};
+
+export { XansqlBridge as default };

package/index.js

@@ -0,0 +1,99 @@
+'use strict';
+
+var securequ = require('securequ');
+var core = require('@xansql/core');
+var base = require('./base.js');
+
+const XansqlBridge = (url, engine) => {
+    let clientInstance = null;
+    const getClient = async (xansql) => {
+        if (!clientInstance) {
+            const secret = await base.makeSecret(xansql);
+            clientInstance = new securequ.SecurequClient({
+                secret,
+                url
+            });
+        }
+        return clientInstance;
+    };
+    const execute = async (sql, xansql) => {
+        if (typeof window === 'undefined') {
+            throw new core.XansqlError({
+                message: "XansqlBridge dialect can only be used in browser environment.",
+            });
+        }
+        const client = await getClient(xansql);
+        const meta = base.sqlparser(sql);
+        const data = {
+            sql,
+            table: meta.table,
+            action: meta.action,
+        };
+        if (meta.action === "SELECT") {
+            let res = await client.get(await base.makePath('find', xansql), { params: data });
+            if (!res.success) {
+                throw new core.XansqlError(res.message);
+            }
+            return res.data || null;
+        }
+        else if (meta.action === "INSERT") {
+            let res = await client.post(await base.makePath('insert', xansql), { body: data });
+            if (!res.success) {
+                throw new core.XansqlError(res.message);
+            }
+            return res.data || null;
+        }
+        else if (meta.action === "UPDATE") {
+            let res = await client.put(await base.makePath('update', xansql), { body: data });
+            if (!res.success) {
+                throw new core.XansqlError(res.message);
+            }
+            return res.data || null;
+        }
+        else if (meta.action === "DELETE") {
+            let res = await client.delete(await base.makePath('delete', xansql), { params: data });
+            if (!res.success) {
+                throw new core.XansqlError(res.message);
+            }
+            return res.data || null;
+        }
+        else {
+            let res = await client.post(await base.makePath('executer', xansql), { body: data });
+            if (!res.success) {
+                throw new core.XansqlError(res.message);
+            }
+            return res.data || null;
+        }
+    };
+    const getSchema = async (xansql) => {
+        const client = await getClient(xansql);
+        const res = await client.get(await base.makePath('raw_schema', xansql));
+        if (!res.success) {
+            throw new core.XansqlError({
+                message: `Failed to fetch schema: ${res.message || 'Unknown error'}`
+            });
+        }
+        return res.data;
+    };
+    const uploadFile = async (file, xansql) => {
+        const client = await getClient(xansql);
+        const res = await client.uploadFile(file);
+        return res.data;
+    };
+    const deleteFile = async (fileId, xansql) => {
+        const client = await getClient(xansql);
+        await client.deleteFile(fileId);
+    };
+    return {
+        engine: engine || 'mysql',
+        execute,
+        getSchema,
+        file: {
+            upload: uploadFile,
+            delete: deleteFile
+        }
+    };
+};
+
+module.exports = XansqlBridge;
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["import { SecurequClient } from \"securequ\";\nimport { Xansql, XansqlError, ExecuterResult, XansqlDialectEngine, XansqlFileMeta } from \"@xansql/core\";\nimport { makePath, makeSecret, sqlparser } from \"./base\";\n\nconst XansqlBridge = (url: string, engine?: XansqlDialectEngine) => {\n\n   let clientInstance: SecurequClient | null = null;\n   const getClient = async (xansql: Xansql) => {\n      if (!clientInstance) {\n         const secret = await makeSecret(xansql)\n         clientInstance = new SecurequClient({\n            secret,\n            url\n         });\n      }\n      return clientInstance;\n   }\n\n   const execute = async (sql: string, xansql: Xansql): Promise<ExecuterResult> => {\n      if (typeof window === 'undefined') {\n         throw new XansqlError({\n            message: \"XansqlBridge dialect can only be used in browser environment.\",\n         })\n      }\n      const client = await getClient(xansql)\n      const meta = sqlparser(sql);\n      const data = {\n         sql,\n         table: meta.table,\n         action: meta.action,\n      };\n\n      if (meta.action === \"SELECT\") {\n         let res = await client.get(await makePath('find', xansql), { params: data })\n         if (!res.success) {\n            throw new XansqlError(res.message);\n         }\n         return res.data || null\n      } else if (meta.action === \"INSERT\") {\n         let res = await client.post(await makePath('insert', xansql), { body: data })\n         if (!res.success) {\n            throw new XansqlError(res.message);\n         }\n         return res.data || null\n      } else if (meta.action === \"UPDATE\") {\n         let res = await client.put(await makePath('update', xansql), { body: data })\n         if (!res.success) {\n            throw new XansqlError(res.message);\n         }\n         return res.data || null\n      } else if (meta.action === \"DELETE\") {\n         let res = await client.delete(await makePath('delete', xansql), { params: data })\n         if (!res.success) {\n            throw new XansqlError(res.message);\n         }\n         return res.data || null\n      } else {\n         let res = await client.post(await makePath('executer', xansql), { body: data })\n         if (!res.success) {\n            throw new XansqlError(res.message);\n         }\n         return res.data || null\n      }\n   };\n\n   const getSchema = async (xansql: Xansql) => {\n      const client = await getClient(xansql)\n      const res = await client.get(await makePath('raw_schema', xansql))\n      if (!res.success) {\n         throw new XansqlError({\n            message: `Failed to fetch schema: ${res.message || 'Unknown error'}`\n         })\n      }\n      return res.data\n   };\n\n   const uploadFile = async (file: File, xansql: Xansql): Promise<XansqlFileMeta> => {\n      const client = await getClient(xansql);\n      const res = await client.uploadFile(file);\n      return res.data\n   }\n\n   const deleteFile = async (fileId: string, xansql: Xansql) => {\n      const client = await getClient(xansql);\n      await client.deleteFile(fileId);\n   }\n\n   return {\n      engine: engine || 'mysql',\n      execute,\n      getSchema,\n      file: {\n         upload: uploadFile,\n         delete: deleteFile\n      }\n   };\n};\n\nexport default XansqlBridge;\n"],"names":["makeSecret","SecurequClient","XansqlError","sqlparser","makePath"],"mappings":"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"}

package/index.mjs

@@ -0,0 +1,97 @@
+import { SecurequClient } from 'securequ';
+import { XansqlError } from '@xansql/core';
+import { makePath, sqlparser, makeSecret } from './base.mjs';
+
+const XansqlBridge = (url, engine) => {
+    let clientInstance = null;
+    const getClient = async (xansql) => {
+        if (!clientInstance) {
+            const secret = await makeSecret(xansql);
+            clientInstance = new SecurequClient({
+                secret,
+                url
+            });
+        }
+        return clientInstance;
+    };
+    const execute = async (sql, xansql) => {
+        if (typeof window === 'undefined') {
+            throw new XansqlError({
+                message: "XansqlBridge dialect can only be used in browser environment.",
+            });
+        }
+        const client = await getClient(xansql);
+        const meta = sqlparser(sql);
+        const data = {
+            sql,
+            table: meta.table,
+            action: meta.action,
+        };
+        if (meta.action === "SELECT") {
+            let res = await client.get(await makePath('find', xansql), { params: data });
+            if (!res.success) {
+                throw new XansqlError(res.message);
+            }
+            return res.data || null;
+        }
+        else if (meta.action === "INSERT") {
+            let res = await client.post(await makePath('insert', xansql), { body: data });
+            if (!res.success) {
+                throw new XansqlError(res.message);
+            }
+            return res.data || null;
+        }
+        else if (meta.action === "UPDATE") {
+            let res = await client.put(await makePath('update', xansql), { body: data });
+            if (!res.success) {
+                throw new XansqlError(res.message);
+            }
+            return res.data || null;
+        }
+        else if (meta.action === "DELETE") {
+            let res = await client.delete(await makePath('delete', xansql), { params: data });
+            if (!res.success) {
+                throw new XansqlError(res.message);
+            }
+            return res.data || null;
+        }
+        else {
+            let res = await client.post(await makePath('executer', xansql), { body: data });
+            if (!res.success) {
+                throw new XansqlError(res.message);
+            }
+            return res.data || null;
+        }
+    };
+    const getSchema = async (xansql) => {
+        const client = await getClient(xansql);
+        const res = await client.get(await makePath('raw_schema', xansql));
+        if (!res.success) {
+            throw new XansqlError({
+                message: `Failed to fetch schema: ${res.message || 'Unknown error'}`
+            });
+        }
+        return res.data;
+    };
+    const uploadFile = async (file, xansql) => {
+        const client = await getClient(xansql);
+        const res = await client.uploadFile(file);
+        return res.data;
+    };
+    const deleteFile = async (fileId, xansql) => {
+        const client = await getClient(xansql);
+        await client.deleteFile(fileId);
+    };
+    return {
+        engine: engine || 'mysql',
+        execute,
+        getSchema,
+        file: {
+            upload: uploadFile,
+            delete: deleteFile
+        }
+    };
+};
+
+export { XansqlBridge as default };
+//# sourceMappingURL=index.mjs.map

package/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":["import { SecurequClient } from \"securequ\";\nimport { Xansql, XansqlError, ExecuterResult, XansqlDialectEngine, XansqlFileMeta } from \"@xansql/core\";\nimport { makePath, makeSecret, sqlparser } from \"./base\";\n\nconst XansqlBridge = (url: string, engine?: XansqlDialectEngine) => {\n\n   let clientInstance: SecurequClient | null = null;\n   const getClient = async (xansql: Xansql) => {\n      if (!clientInstance) {\n         const secret = await makeSecret(xansql)\n         clientInstance = new SecurequClient({\n            secret,\n            url\n         });\n      }\n      return clientInstance;\n   }\n\n   const execute = async (sql: string, xansql: Xansql): Promise<ExecuterResult> => {\n      if (typeof window === 'undefined') {\n         throw new XansqlError({\n            message: \"XansqlBridge dialect can only be used in browser environment.\",\n         })\n      }\n      const client = await getClient(xansql)\n      const meta = sqlparser(sql);\n      const data = {\n         sql,\n         table: meta.table,\n         action: meta.action,\n      };\n\n      if (meta.action === \"SELECT\") {\n         let res = await client.get(await makePath('find', xansql), { params: data })\n         if (!res.success) {\n            throw new XansqlError(res.message);\n         }\n         return res.data || null\n      } else if (meta.action === \"INSERT\") {\n         let res = await client.post(await makePath('insert', xansql), { body: data })\n         if (!res.success) {\n            throw new XansqlError(res.message);\n         }\n         return res.data || null\n      } else if (meta.action === \"UPDATE\") {\n         let res = await client.put(await makePath('update', xansql), { body: data })\n         if (!res.success) {\n            throw new XansqlError(res.message);\n         }\n         return res.data || null\n      } else if (meta.action === \"DELETE\") {\n         let res = await client.delete(await makePath('delete', xansql), { params: data })\n         if (!res.success) {\n            throw new XansqlError(res.message);\n         }\n         return res.data || null\n      } else {\n         let res = await client.post(await makePath('executer', xansql), { body: data })\n         if (!res.success) {\n            throw new XansqlError(res.message);\n         }\n         return res.data || null\n      }\n   };\n\n   const getSchema = async (xansql: Xansql) => {\n      const client = await getClient(xansql)\n      const res = await client.get(await makePath('raw_schema', xansql))\n      if (!res.success) {\n         throw new XansqlError({\n            message: `Failed to fetch schema: ${res.message || 'Unknown error'}`\n         })\n      }\n      return res.data\n   };\n\n   const uploadFile = async (file: File, xansql: Xansql): Promise<XansqlFileMeta> => {\n      const client = await getClient(xansql);\n      const res = await client.uploadFile(file);\n      return res.data\n   }\n\n   const deleteFile = async (fileId: string, xansql: Xansql) => {\n      const client = await getClient(xansql);\n      await client.deleteFile(fileId);\n   }\n\n   return {\n      engine: engine || 'mysql',\n      execute,\n      getSchema,\n      file: {\n         upload: uploadFile,\n         delete: deleteFile\n      }\n   };\n};\n\nexport default XansqlBridge;\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@xansql/bridge",
+  "version": "1.0.0",
+  "main": "./index.js",
+  "module": "./index.mjs",
+  "types": "./index.d.ts",
+  "description": "Xansql bridge",
+  "author": "Devnax",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [],
+  "sideEffects": [],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xansql/bridge.git"
+  },
+  "dependencies": {
+    "securequ": "^1.1.12"
+  },
+  "exports": {
+    ".": {
+      "import": "./index.mjs",
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    },
+    "./server": {
+      "import": "./src/server.mjs",
+      "require": "./src/server.js",
+      "types": "./src/server.d.ts"
+    },
+    "./package.json": "./package.json"
+  }
+}

package/readme.md

@@ -0,0 +1,359 @@
+# xansql
+
+<p align="center">
+  <strong>Type-safe, event-driven SQL ORM with automatic schema synchronization, composable relations, granular hooks, and optional client execution bridge.</strong>
+</p>
+
+<p align="center">
+<!-- Badges (replace placeholders when public) -->
+<a href="#"><img alt="license" src="https://img.shields.io/badge/license-MIT-blue"/></a>
+<a href="#"><img alt="status" src="https://img.shields.io/badge/status-beta-orange"/></a>
+<a href="#"><img alt="dialects" src="https://img.shields.io/badge/dialects-mysql%20%7C%20postgresql%20%7C%20sqlite-6A5ACD"/></a>
+</p>
+
+---
+
+## Executive Summary
+xansql is a minimalist but powerful ORM focusing on:
+- Deterministic schema definition (single source of truth) with non-destructive migration.
+- Relation traversal via declarative `select` trees (preventing circular graphs).
+- Rich predicate language in `where` supporting deep `EXISTS` on nested relations.
+- Event system & lifecycle hooks (global + per-model) for observability & cross-cutting concerns.
+- Pluggable caching, file storage, fetch bridge (browser safe), and socket integration.
+- Lightweight execution pipeline: thin SQL generation, no heavy runtime proxies.
+
+---
+## Contents
+1. Features
+2. Architecture Overview
+3. Installation
+4. Quick Start
+5. Configuration Reference
+6. Defining Models & Fields
+7. Relations
+8. Querying & Predicates
+9. Aggregation & Helpers
+10. Pagination & Convenience APIs
+11. Transactions
+12. Migrations
+13. Events & Hooks
+14. File Handling
+15. Client Fetch Bridge
+16. Caching Interface
+17. Dialects & Custom Implementation
+18. Error Handling & Validation
+19. Security Considerations
+20. Performance Guidance
+21. FAQ
+22. Roadmap
+23. License
+
+---
+## 1. Features
+- Multi-dialect: MySQL, PostgreSQL, SQLite (custom adapter friendly)
+- Auto aliasing + integrity checks
+- Declarative relations (`xt.schema` / array reverse mapping)
+- Non-destructive migrate (add/modify/remove columns) + force rebuild
+- Granular lifecycle hooks & event emission
+- Rich `where` condition operators (logical AND/OR composition)
+- Nested relational filtering through `EXISTS` semantics
+- Aggregation inline or via helper methods
+- Optional caching module contract
+- Integrated file meta handling & streaming upload abstraction
+- Client-side safe execution (no raw SQL leakage) via signed execution meta
+
+---
+## 2. Architecture Overview
+Layered components:
+- Core: `Xansql` orchestrates config, model registry, transactions, migration, fetch bridge and events.
+- Model: Provides CRUD + query generation + relation resolution.
+- Executers: Specialized operation builders (Find / Create / Update / Delete / Aggregate).
+- Migration: Computes delta from declared schema vs dialect metadata and issues SQL.
+- Types System: Field factories (`xt.*`) with metadata (length, unique, index, validators, transforms).
+- Foreign Resolver: Normalizes forward & reverse relation mapping for join/exists generation.
+- Fetch Bridge: Validates request meta for client-originated operations (server controlled).
+
+---
+## 3. Installation
+```bash
+npm install xansql mysql2 pg better-sqlite3
+# Or only the drivers you need
+```
+SQLite usage recommends `better-sqlite3` for synchronous performance.
+
+---
+## 4. Quick Start
+```ts
+import { Xansql, Model, xt } from 'xansql';
+import MysqlDialect from 'xansql/dist/libs/MysqlDialect';
+
+const db = new Xansql({
+  dialect: MysqlDialect({ host: '127.0.0.1', user: 'root', password: '', database: 'app' })
+});
+
+const User = db.model('users', {
+  id: xt.id(),
+  username: xt.username(),
+  email: xt.email().unique(),
+  password: xt.password().strong(),
+  role: xt.role(['admin', 'member']),
+  createdAt: xt.createdAt(),
+  updatedAt: xt.updatedAt()
+});
+
+await db.migrate();
+await User.create({ data: [{ username: 'alice', email: 'a@b.com', password: 'Pwd@1234', role: 'member' }] });
+const result = await User.find({ where: { username: { equals: 'alice' } } });
+```
+
+---
+## 5. Configuration Reference
+```ts
+new Xansql({
+  dialect: MysqlDialect({...}),            // REQUIRED
+  fetch: { url: '/xansql', mode: 'production' }, // optional (client bridge)
+  socket: { open, message, close },        // optional WebSocket handlers
+  cache: { cache, clear, onFind, onCreate, onUpdate, onDelete }, // optional
+  file: { maxFilesize, chunkSize, upload, delete }, // optional file storage
+  maxLimit: { find, create, update, delete },       // safety caps (default 100)
+  hooks: { beforeFind, afterFind, transform, ... }  // global async hooks
+});
+```
+Required dialect interface:
+```ts
+interface XansqlDialect {
+  engine: 'mysql' | 'postgresql' | 'sqlite';
+  execute(sql: string): Promise<{ results: any[]; affectedRows: number; insertId: number | null }>;
+  getSchema(): Promise<{ [table: string]: { name: string; type: string; notnull: boolean; default_value: any; pk: boolean; index: boolean; unique: boolean }[] }>
+}
+```
+
+---
+## 6. Defining Models & Fields
+```ts
+const Post = db.model('posts', {
+  id: xt.id(),
+  title: xt.title().index(),
+  slug: xt.slug().unique(),
+  author: xt.schema('users', 'id'),         // FK forward
+  tags: xt.array(xt.string(30)),            // array (not in where predicate)
+  images: xt.array(xt.file()),              // file metadata entries
+  createdAt: xt.createdAt(),
+  updatedAt: xt.updatedAt()
+});
+```
+Per-model hooks:
+```ts
+Post.options.hooks = {
+  beforeCreate: async (args) => args,
+  transform: async (row) => { delete row.password; return row; }
+};
+```
+Field factory highlights: `id, string, number, boolean, date, enum, array, object, record, tuple, union, file, schema` + semantic shortcuts (`username`, `email`, `password`, `slug`, `role`, `title`, `amount`, etc.). Most fields accept chainable validators (`min`, `max`, `unique`, `index`, `transform`).
+
+Foreign key patterns:
+- Forward: `xt.schema('users','id')`
+- Reverse (one-to-many): `xt.array(xt.schema('posts','id'))`
+
+---
+## 7. Relations
+Select nested relations:
+```ts
+await User.find({
+  select: {
+    id: true,
+    username: true,
+    posts: {
+      select: { id: true, title: true },
+      where: { title: { contains: 'SQL' } },
+      limit: { take: 5 }
+    }
+  }
+});
+```
+Circular graphs are rejected early.
+
+---
+## 8. Querying & Predicates
+Operators: `equals, not, lt, lte, gt, gte, in, notIn, between, notBetween, contains, notContains, startsWith, endsWith, isNull, isNotNull, isEmpty, isNotEmpty, isTrue, isFalse`.
+- Object => AND
+- Array of objects => OR
+- Nested relation in `where` => EXISTS subquery
+Example:
+```ts
+await Post.find({
+  where: {
+    author: { username: { startsWith: 'a' } },
+    slug: { notContains: 'draft' },
+    title: [{ contains: 'Guide' }, { contains: 'Intro' }]
+  }
+});
+```
+
+---
+## 9. Aggregation & Helpers
+Inline:
+```ts
+await User.find({ aggregate: { id: { count: true } } });
+```
+Helpers: `count(where)`, `min(col, where)`, `max`, `sum`, `avg`, `exists(where)`.
+
+---
+## 10. Pagination & Convenience
+```ts
+const page = await User.paginate(2, { perpage: 20, where: { role: { equals: 'member' } } });
+// { page, perpage, pagecount, rowcount, results }
+```
+Also: `findOne(args)`, `findById(id, args)`.
+
+---
+## 11. Transactions
+Automatic for create/update/delete unless within chained relation execution.
+Manual wrapper:
+```ts
+await db.transaction(async () => {
+  await User.create({ data: [{ username: 'temp' }] });
+  await User.update({ data: { role: 'admin' }, where: { username: 'temp' } });
+});
+```
+Rollback on error.
+
+---
+## 12. Migrations
+```ts
+await db.migrate();        // sync non-destructively
+await db.migrate(true);    // drop + recreate (files cleaned)
+const preview = await db.generateMigration(); // array of SQL statements
+```
+Rules:
+- Skips ID column alterations.
+- Adds new columns; drops removed ones; issues ALTER for changed definition.
+- Force rebuild executes reverse-order drops then creates.
+
+---
+## 13. Events & Hooks
+Events emitted: `BEFORE_CREATE, CREATE, BEFORE_UPDATE, UPDATE, BEFORE_DELETE, DELETE, BEFORE_FIND, FIND, BEFORE_AGGREGATE, AGGREGATE, BEFORE_FETCH, FETCH`.
+Usage:
+```ts
+db.on('CREATE', ({ model, results }) => { /* audit */ });
+```
+Hooks (global & model-level) allow mutation of args/results or row transform.
+
+---
+## 14. File Handling
+Define file fields: `xt.file(size?)` / arrays.
+Configure storage:
+```ts
+file: {
+  maxFilesize: 2048,        // KB
+  chunkSize: 256,           // KB (streaming)
+  upload: async (chunk, meta) => {},
+  delete: async (filename) => {}
+}
+```
+Client helpers: `uploadFile(file, executeId)`, `deleteFile(name, executeId)`.
+
+---
+## 15. Client Fetch Bridge
+Provide `fetch: string | { url, mode }`.
+Client side raw SQL blocked; operations require internally generated `executeId` (granted per model action via metadata).
+Server integrates:
+```ts
+const response = await db.onFetch(req.url, {
+  body: req.body,
+  headers: req.headers,
+  cookies: parseCookies(req),
+  isAuthorized: async (meta) => {/* check meta.action, meta.model */ return true; }
+});
+```
+
+---
+## 16. Caching Interface
+Implement partial or full row caching:
+```ts
+cache: {
+  cache: async (sql, model) => /* rows or undefined */,
+  clear: async (model) => {},
+  onFind: async (sql, model, row) => {},
+  onCreate: async (model, insertId) => {},
+  onUpdate: async (model, rows) => {},
+  onDelete: async (model, rows) => {},
+}
+```
+You decide strategy (memory, redis, browser IndexedDB via example adapters).
+
+---
+## 17. Dialects & Custom Implementation
+Built-ins: `MysqlDialect`, `PostgresDialect`, `SqliteDialect`.
+Custom:
+```ts
+const CustomDialect = () => ({
+  engine: 'mysql',
+  execute: async (sql) => {/* run */ return { results: [], affectedRows: 0, insertId: 0 };},
+  getSchema: async () => ({ /* table: columns[] */ })
+});
+```
+`getSchema` must supply column index/unique flags for migration diffing.
+
+---
+## 18. Error Handling & Validation
+Common thrown errors:
+- Missing dialect or execute function
+- Unsupported engine
+- Model without ID field
+- Duplicate model name / alias collision
+- Invalid where operator or disallowed field type in predicate (array/object/record/tuple)
+- Circular relation selection / where nesting
+- Client usage without fetch configuration
+- Raw query attempt from client without `executeId`
+- Invalid foreign key definition
+
+---
+## 19. Security Considerations
+- All value interpolation passes through escaping utilities.
+- Client cannot send arbitrary SQL (requires signed meta created server-side).
+- Hooks & events can enforce auditing, RBAC, masking.
+- Password field helper automatically hashes via SHA-256 transform.
+- Recommend additional app-layer input validation before invoking ORM.
+
+---
+## 20. Performance Guidance
+- Prefer selective `select` trees over full-table scans.
+- Use indexes via field `.index()` / `.unique()` early (migration will create).
+- Enable caching for heavy read patterns.
+- Use pagination helpers (`paginate`) to avoid large offset scans.
+- Keep relation depth shallow to limit EXISTS nesting.
+- Batch `create` with array `data` for reduced round trips.
+
+---
+## 21. FAQ
+Q: Does xansql generate JOINs?  
+A: Relation filters use `EXISTS` subqueries; selection fetches related sets separately.
+
+Q: How are reverse (one-to-many) relations defined?  
+A: `xt.array(xt.schema('childTable','id'))` inside the parent references children.
+
+Q: Can I rename columns automatically?  
+A: Rename support is planned (see roadmap). Current diff treats rename as drop + add.
+
+Q: Can I use raw SQL?  
+A: Server side `db.execute(sql)` is allowed; client side raw is blocked.
+
+---
+## 22. Roadmap
+- Column / index rename migration operations
+- CLI code generation & schema inspector
+- Enhanced diff reporting (explain changes)
+- Advanced relation eager constraints (depth limiting strategies)
+- Pluggable authorization middleware bundle
+
+---
+## 23. License
+MIT
+
+---
+## Attributions
+Internal field validation leverages concepts from `xanv`. File handling meta uses `securequ` upload structures.
+
+---
+> Need adjustments (badges, examples, tutorials)? Open an issue or contribute.

package/server.d.ts

@@ -0,0 +1,19 @@
+import { SecurequServer } from 'securequ';
+import { Xansql } from '@xansql/core';
+import { XansqlBridgeServerConfig, XansqlBridgeAuthorizedInfo, ListenOptions } from './types.js';
+
+declare class XansqlBridgeServer {
+    readonly XANFETCH_CONTENT_TYPE = "application/octet-stream";
+    xansql: Xansql;
+    config: XansqlBridgeServerConfig;
+    private server;
+    constructor(xansql: Xansql, config: XansqlBridgeServerConfig);
+    authorized(info: XansqlBridgeAuthorizedInfo): Promise<void>;
+    initial(): Promise<SecurequServer>;
+    listen(url: string, options: ListenOptions): Promise<{
+        status: number;
+        value: string | Uint8Array<ArrayBufferLike>;
+    }>;
+}
+
+export { XansqlBridgeServer as default };

package/server.js

@@ -0,0 +1,111 @@
+'use strict';
+
+var securequ = require('securequ');
+var core = require('@xansql/core');
+var base = require('./base.js');
+
+class XansqlBridgeServer {
+    constructor(xansql, config) {
+        this.XANFETCH_CONTENT_TYPE = 'application/octet-stream';
+        this.server = null;
+        this.xansql = xansql;
+        this.config = config;
+    }
+    async authorized(info) {
+        const config = this.config;
+        if (config.isAuthorized) {
+            const isPermit = await config.isAuthorized(info);
+            if (!isPermit)
+                throw new core.XansqlError({
+                    message: "isAuthorized denied for server initialization.",
+                    model: info.model ? info.model.table : undefined,
+                });
+        }
+    }
+    async initial() {
+        if (this.server)
+            return this.server;
+        const config = this.config;
+        const xansql = this.xansql;
+        const secret = await base.makeSecret(this.xansql);
+        const server = new securequ.SecurequServer(Object.assign(Object.assign({}, (config || {})), { clients: [
+                {
+                    origin: `*`,
+                    secret
+                }
+            ] }));
+        server.get(await base.makePath('find', xansql), async (req) => {
+            const params = req.searchParams;
+            await this.authorized({
+                method: "GET",
+                model: xansql.models.get(params.table),
+                action: params.action,
+            });
+            throw await xansql.execute(params.sql);
+        });
+        server.post(await base.makePath('insert', xansql), async (req) => {
+            const params = req.body;
+            await this.authorized({
+                method: "POST",
+                model: xansql.models.get(params.table),
+                action: params.action,
+            });
+            throw await xansql.execute(params.sql);
+        });
+        server.put(await base.makePath('update', xansql), async (req) => {
+            const params = req.body;
+            await this.authorized({
+                method: "PUT",
+                model: xansql.models.get(params.table),
+                action: params.action,
+            });
+            throw await xansql.execute(params.sql);
+        });
+        server.delete(await base.makePath('delete', xansql), async (req) => {
+            const params = req.searchParams;
+            await this.authorized({
+                method: "DELETE",
+                model: xansql.models.get(params.table),
+                action: params.action,
+            });
+            throw await xansql.execute(params.sql);
+        });
+        server.post(await base.makePath('executer', xansql), async (req) => {
+            const params = req.body;
+            await this.authorized({
+                method: "POST",
+                model: xansql.models.get(params.table),
+                action: params.action,
+            });
+            throw await xansql.execute(params.sql);
+        });
+        server.get(await base.makePath('raw_schema', xansql), async (req) => {
+            throw await xansql.dialect.getSchema(xansql);
+        });
+        this.server = server;
+        return this.server;
+    }
+    async listen(url, options) {
+        const server = await this.initial();
+        try {
+            const res = await server.listen(url, options);
+            return {
+                status: res.status,
+                value: res.value,
+            };
+        }
+        catch (error) {
+            const secret = await base.makeSecret(this.xansql);
+            return {
+                status: 500,
+                value: await securequ.crypto.encryptBuffer({
+                    success: false,
+                    message: error.message || 'Internal Server Error'
+                }, secret)
+            };
+        }
+    }
+}
+
+module.exports = XansqlBridgeServer;
+//# sourceMappingURL=server.js.map

package/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sources":["../src/server.ts"],"sourcesContent":["import { crypto, SecurequServer } from \"securequ\";\nimport { Xansql, XansqlError, Model } from \"@xansql/core\";\nimport { makePath, makeSecret } from \"./base\";\nimport { ListenOptions, XansqlBridgeAuthorizedInfo, XansqlBridgeServerConfig } from \"./types\";\n\nclass XansqlBridgeServer {\n   readonly XANFETCH_CONTENT_TYPE = 'application/octet-stream';\n   xansql: Xansql;\n   config: XansqlBridgeServerConfig;\n   private server: SecurequServer | null = null;\n\n   constructor(xansql: Xansql, config: XansqlBridgeServerConfig) {\n      this.xansql = xansql;\n      this.config = config;\n   }\n\n   async authorized(info: XansqlBridgeAuthorizedInfo) {\n      const config = this.config;\n      if (config.isAuthorized) {\n         const isPermit = await config.isAuthorized(info)\n         if (!isPermit) throw new XansqlError({\n            message: \"isAuthorized denied for server initialization.\",\n            model: info.model ? info.model.table : undefined,\n         })\n      }\n   }\n\n   async initial() {\n      if (this.server) return this.server;\n\n      const config = this.config;\n      const xansql = this.xansql\n      const secret = await makeSecret(this.xansql);\n\n      const server = new SecurequServer({\n         ...(config || {}),\n         clients: [\n            {\n               origin: `*`,\n               secret\n            }\n         ]\n      });\n\n      server.get(await makePath('find', xansql), async (req: any) => {\n\n         const params: any = req.searchParams\n         await this.authorized({\n            method: \"GET\",\n            model: xansql.models.get(params.table) as Model,\n            action: params.action,\n         })\n         throw await xansql.execute(params.sql);\n      })\n\n\n      server.post(await makePath('insert', xansql), async (req: any) => {\n         const params: any = req.body\n         await this.authorized({\n            method: \"POST\",\n            model: xansql.models.get(params.table) as Model,\n            action: params.action,\n         })\n         throw await xansql.execute(params.sql);\n      })\n\n      server.put(await makePath('update', xansql), async (req: any) => {\n         const params: any = req.body\n         await this.authorized({\n            method: \"PUT\",\n            model: xansql.models.get(params.table) as Model,\n            action: params.action,\n         })\n         throw await xansql.execute(params.sql);\n      })\n\n      server.delete(await makePath('delete', xansql), async (req: any) => {\n         const params: any = req.searchParams\n         await this.authorized({\n            method: \"DELETE\",\n            model: xansql.models.get(params.table) as Model,\n            action: params.action,\n         })\n         throw await xansql.execute(params.sql);\n      })\n\n\n      server.post(await makePath('executer', xansql), async (req: any) => {\n         const params: any = req.body\n         await this.authorized({\n            method: \"POST\",\n            model: xansql.models.get(params.table) as Model,\n            action: params.action,\n         })\n         throw await xansql.execute(params.sql);\n      })\n\n      server.get(await makePath('raw_schema', xansql), async (req: any) => {\n         throw await xansql.dialect.getSchema(xansql);\n      })\n\n      this.server = server;\n      return this.server;\n   }\n\n   async listen(url: string, options: ListenOptions) {\n\n      const server = await this.initial()\n      try {\n         const res = await server.listen(url, options)\n         return {\n            status: res.status,\n            value: res.value,\n         }\n      } catch (error: any) {\n\n         const secret = await makeSecret(this.xansql)\n         return {\n            status: 500,\n            value: await crypto.encryptBuffer({\n               success: false,\n               message: error.message || 'Internal Server Error'\n            }, secret)\n         }\n      }\n   }\n}\n\nexport default XansqlBridgeServer"],"names":["XansqlError","makeSecret","SecurequServer","makePath","crypto"],"mappings":"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"}

package/server.mjs

@@ -0,0 +1,109 @@
+import { SecurequServer, crypto } from 'securequ';
+import { XansqlError } from '@xansql/core';
+import { makeSecret, makePath } from './base.mjs';
+
+class XansqlBridgeServer {
+    constructor(xansql, config) {
+        this.XANFETCH_CONTENT_TYPE = 'application/octet-stream';
+        this.server = null;
+        this.xansql = xansql;
+        this.config = config;
+    }
+    async authorized(info) {
+        const config = this.config;
+        if (config.isAuthorized) {
+            const isPermit = await config.isAuthorized(info);
+            if (!isPermit)
+                throw new XansqlError({
+                    message: "isAuthorized denied for server initialization.",
+                    model: info.model ? info.model.table : undefined,
+                });
+        }
+    }
+    async initial() {
+        if (this.server)
+            return this.server;
+        const config = this.config;
+        const xansql = this.xansql;
+        const secret = await makeSecret(this.xansql);
+        const server = new SecurequServer(Object.assign(Object.assign({}, (config || {})), { clients: [
+                {
+                    origin: `*`,
+                    secret
+                }
+            ] }));
+        server.get(await makePath('find', xansql), async (req) => {
+            const params = req.searchParams;
+            await this.authorized({
+                method: "GET",
+                model: xansql.models.get(params.table),
+                action: params.action,
+            });
+            throw await xansql.execute(params.sql);
+        });
+        server.post(await makePath('insert', xansql), async (req) => {
+            const params = req.body;
+            await this.authorized({
+                method: "POST",
+                model: xansql.models.get(params.table),
+                action: params.action,
+            });
+            throw await xansql.execute(params.sql);
+        });
+        server.put(await makePath('update', xansql), async (req) => {
+            const params = req.body;
+            await this.authorized({
+                method: "PUT",
+                model: xansql.models.get(params.table),
+                action: params.action,
+            });
+            throw await xansql.execute(params.sql);
+        });
+        server.delete(await makePath('delete', xansql), async (req) => {
+            const params = req.searchParams;
+            await this.authorized({
+                method: "DELETE",
+                model: xansql.models.get(params.table),
+                action: params.action,
+            });
+            throw await xansql.execute(params.sql);
+        });
+        server.post(await makePath('executer', xansql), async (req) => {
+            const params = req.body;
+            await this.authorized({
+                method: "POST",
+                model: xansql.models.get(params.table),
+                action: params.action,
+            });
+            throw await xansql.execute(params.sql);
+        });
+        server.get(await makePath('raw_schema', xansql), async (req) => {
+            throw await xansql.dialect.getSchema(xansql);
+        });
+        this.server = server;
+        return this.server;
+    }
+    async listen(url, options) {
+        const server = await this.initial();
+        try {
+            const res = await server.listen(url, options);
+            return {
+                status: res.status,
+                value: res.value,
+            };
+        }
+        catch (error) {
+            const secret = await makeSecret(this.xansql);
+            return {
+                status: 500,
+                value: await crypto.encryptBuffer({
+                    success: false,
+                    message: error.message || 'Internal Server Error'
+                }, secret)
+            };
+        }
+    }
+}
+
+export { XansqlBridgeServer as default };
+//# sourceMappingURL=server.mjs.map

package/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","sources":["../src/server.ts"],"sourcesContent":["import { crypto, SecurequServer } from \"securequ\";\nimport { Xansql, XansqlError, Model } from \"@xansql/core\";\nimport { makePath, makeSecret } from \"./base\";\nimport { ListenOptions, XansqlBridgeAuthorizedInfo, XansqlBridgeServerConfig } from \"./types\";\n\nclass XansqlBridgeServer {\n   readonly XANFETCH_CONTENT_TYPE = 'application/octet-stream';\n   xansql: Xansql;\n   config: XansqlBridgeServerConfig;\n   private server: SecurequServer | null = null;\n\n   constructor(xansql: Xansql, config: XansqlBridgeServerConfig) {\n      this.xansql = xansql;\n      this.config = config;\n   }\n\n   async authorized(info: XansqlBridgeAuthorizedInfo) {\n      const config = this.config;\n      if (config.isAuthorized) {\n         const isPermit = await config.isAuthorized(info)\n         if (!isPermit) throw new XansqlError({\n            message: \"isAuthorized denied for server initialization.\",\n            model: info.model ? info.model.table : undefined,\n         })\n      }\n   }\n\n   async initial() {\n      if (this.server) return this.server;\n\n      const config = this.config;\n      const xansql = this.xansql\n      const secret = await makeSecret(this.xansql);\n\n      const server = new SecurequServer({\n         ...(config || {}),\n         clients: [\n            {\n               origin: `*`,\n               secret\n            }\n         ]\n      });\n\n      server.get(await makePath('find', xansql), async (req: any) => {\n\n         const params: any = req.searchParams\n         await this.authorized({\n            method: \"GET\",\n            model: xansql.models.get(params.table) as Model,\n            action: params.action,\n         })\n         throw await xansql.execute(params.sql);\n      })\n\n\n      server.post(await makePath('insert', xansql), async (req: any) => {\n         const params: any = req.body\n         await this.authorized({\n            method: \"POST\",\n            model: xansql.models.get(params.table) as Model,\n            action: params.action,\n         })\n         throw await xansql.execute(params.sql);\n      })\n\n      server.put(await makePath('update', xansql), async (req: any) => {\n         const params: any = req.body\n         await this.authorized({\n            method: \"PUT\",\n            model: xansql.models.get(params.table) as Model,\n            action: params.action,\n         })\n         throw await xansql.execute(params.sql);\n      })\n\n      server.delete(await makePath('delete', xansql), async (req: any) => {\n         const params: any = req.searchParams\n         await this.authorized({\n            method: \"DELETE\",\n            model: xansql.models.get(params.table) as Model,\n            action: params.action,\n         })\n         throw await xansql.execute(params.sql);\n      })\n\n\n      server.post(await makePath('executer', xansql), async (req: any) => {\n         const params: any = req.body\n         await this.authorized({\n            method: \"POST\",\n            model: xansql.models.get(params.table) as Model,\n            action: params.action,\n         })\n         throw await xansql.execute(params.sql);\n      })\n\n      server.get(await makePath('raw_schema', xansql), async (req: any) => {\n         throw await xansql.dialect.getSchema(xansql);\n      })\n\n      this.server = server;\n      return this.server;\n   }\n\n   async listen(url: string, options: ListenOptions) {\n\n      const server = await this.initial()\n      try {\n         const res = await server.listen(url, options)\n         return {\n            status: res.status,\n            value: res.value,\n         }\n      } catch (error: any) {\n\n         const secret = await makeSecret(this.xansql)\n         return {\n            status: 500,\n            value: await crypto.encryptBuffer({\n               success: false,\n               message: error.message || 'Internal Server Error'\n            }, secret)\n         }\n      }\n   }\n}\n\nexport default XansqlBridgeServer"],"names":[],"mappings":";;;;AAKA,MAAM,kBAAkB,CAAA;IAMrB,WAAA,CAAY,MAAc,EAAE,MAAgC,EAAA;QALnD,IAAA,CAAA,qBAAqB,GAAG,0BAA0B;QAGnD,IAAA,CAAA,MAAM,GAA0B,IAAI;AAGzC,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM;AACpB,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM;IACvB;IAEA,MAAM,UAAU,CAAC,IAAgC,EAAA;AAC9C,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM;AAC1B,QAAA,IAAI,MAAM,CAAC,YAAY,EAAE;YACtB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;AAChD,YAAA,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,WAAW,CAAC;AAClC,oBAAA,OAAO,EAAE,gDAAgD;AACzD,oBAAA,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS;AAClD,iBAAA,CAAC;QACL;IACH;AAEA,IAAA,MAAM,OAAO,GAAA;QACV,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM;AAEnC,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM;AAC1B,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM;QAC1B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;AAE5C,QAAA,MAAM,MAAM,GAAG,IAAI,cAAc,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,EAAA,GAC1B,MAAM,IAAI,EAAE,EAAC,EAAA,EACjB,OAAO,EAAE;AACN,gBAAA;AACG,oBAAA,MAAM,EAAE,CAAA,CAAA,CAAG;oBACX;AACF;AACH,aAAA,EAAA,CAAA,CACF;AAEF,QAAA,MAAM,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAQ,KAAI;AAE3D,YAAA,MAAM,MAAM,GAAQ,GAAG,CAAC,YAAY;YACpC,MAAM,IAAI,CAAC,UAAU,CAAC;AACnB,gBAAA,MAAM,EAAE,KAAK;gBACb,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAU;gBAC/C,MAAM,EAAE,MAAM,CAAC,MAAM;AACvB,aAAA,CAAC;YACF,MAAM,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;AACzC,QAAA,CAAC,CAAC;AAGF,QAAA,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,OAAO,GAAQ,KAAI;AAC9D,YAAA,MAAM,MAAM,GAAQ,GAAG,CAAC,IAAI;YAC5B,MAAM,IAAI,CAAC,UAAU,CAAC;AACnB,gBAAA,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAU;gBAC/C,MAAM,EAAE,MAAM,CAAC,MAAM;AACvB,aAAA,CAAC;YACF,MAAM,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;AACzC,QAAA,CAAC,CAAC;AAEF,QAAA,MAAM,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,OAAO,GAAQ,KAAI;AAC7D,YAAA,MAAM,MAAM,GAAQ,GAAG,CAAC,IAAI;YAC5B,MAAM,IAAI,CAAC,UAAU,CAAC;AACnB,gBAAA,MAAM,EAAE,KAAK;gBACb,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAU;gBAC/C,MAAM,EAAE,MAAM,CAAC,MAAM;AACvB,aAAA,CAAC;YACF,MAAM,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;AACzC,QAAA,CAAC,CAAC;AAEF,QAAA,MAAM,CAAC,MAAM,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,OAAO,GAAQ,KAAI;AAChE,YAAA,MAAM,MAAM,GAAQ,GAAG,CAAC,YAAY;YACpC,MAAM,IAAI,CAAC,UAAU,CAAC;AACnB,gBAAA,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAU;gBAC/C,MAAM,EAAE,MAAM,CAAC,MAAM;AACvB,aAAA,CAAC;YACF,MAAM,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;AACzC,QAAA,CAAC,CAAC;AAGF,QAAA,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,GAAQ,KAAI;AAChE,YAAA,MAAM,MAAM,GAAQ,GAAG,CAAC,IAAI;YAC5B,MAAM,IAAI,CAAC,UAAU,CAAC;AACnB,gBAAA,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAU;gBAC/C,MAAM,EAAE,MAAM,CAAC,MAAM;AACvB,aAAA,CAAC;YACF,MAAM,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;AACzC,QAAA,CAAC,CAAC;AAEF,QAAA,MAAM,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,OAAO,GAAQ,KAAI;YACjE,MAAM,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC;AAC/C,QAAA,CAAC,CAAC;AAEF,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM;QACpB,OAAO,IAAI,CAAC,MAAM;IACrB;AAEA,IAAA,MAAM,MAAM,CAAC,GAAW,EAAE,OAAsB,EAAA;AAE7C,QAAA,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE;AACnC,QAAA,IAAI;YACD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC;YAC7C,OAAO;gBACJ,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;aAClB;QACJ;QAAE,OAAO,KAAU,EAAE;YAElB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5C,OAAO;AACJ,gBAAA,MAAM,EAAE,GAAG;AACX,gBAAA,KAAK,EAAE,MAAM,MAAM,CAAC,aAAa,CAAC;AAC/B,oBAAA,OAAO,EAAE,KAAK;AACd,oBAAA,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI;AAC5B,iBAAA,EAAE,MAAM;aACX;QACJ;IACH;AACF;;;;"}

package/types.d.ts

@@ -0,0 +1,17 @@
+import { SecurequServerConfig, ListenerInfo } from 'securequ';
+import { Model } from '@xansql/core';
+
+type XansqlBridgeAuthorizedInfo = {
+    method: "GET" | "POST" | "PUT" | "DELETE";
+    model: Model | null;
+    action: string;
+};
+type XansqlBridgeServerConfig = {
+    basepath: string;
+    mode?: "production" | "development";
+    isAuthorized?: (info: XansqlBridgeAuthorizedInfo) => Promise<boolean>;
+    file?: SecurequServerConfig["file"];
+};
+type ListenOptions = ListenerInfo;
+
+export type { ListenOptions, XansqlBridgeAuthorizedInfo, XansqlBridgeServerConfig };