ztechno_core 0.0.111 → 0.0.113

package/lib/scripts/docker-build.js

@@ -1,91 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-var __importDefault =
-  (this && this.__importDefault) ||
-  function (mod) {
-    return mod && mod.__esModule ? mod : { default: mod };
-  };
-Object.defineProperty(exports, '__esModule', { value: true });
-exports.dockerBuild = void 0;
-const child_process_1 = require('child_process');
-const path_1 = __importDefault(require('path'));
-const fs_1 = __importDefault(require('fs'));
-// ANSI color helpers
-const red = (msg) => `\x1b[31m${msg}\x1b[0m`;
-const green = (msg) => `\x1b[32m${msg}\x1b[0m`;
-const cyan = (msg) => `\x1b[36m${msg}\x1b[0m`;
-function loadPackageJson() {
-  const pkgPath = path_1.default.join(process.cwd(), 'package.json');
-  if (!fs_1.default.existsSync(pkgPath)) {
-    throw new Error(`No package.json found in ${process.cwd()}`);
-  }
-  return JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf-8'));
-}
-/**
- * Build a Docker image tagged as <awsAccountId>/<packagename>:latest
- * @param opt.packagename - Override the image name (defaults to package.json name)
- * @param opt.awsAccountId - Override the AWS Account ID (defaults to package.json config.awsAccountId)
- * @param opt.tag - Override the tag (defaults to "latest")
- * @param opt.context - Docker build context path (defaults to ".")
- */
-function dockerBuild(opt) {
-  const pkg = loadPackageJson();
-  const packagename = opt?.packagename || pkg.name;
-  const awsAccountId = opt?.awsAccountId || pkg.config?.awsAccountId || process.env.AWS_ACCOUNT_ID;
-  const tag = opt?.tag || 'latest';
-  const context = opt?.context || '.';
-  if (!packagename) {
-    throw new Error('Missing package name. Set "name" in package.json or pass --name.');
-  }
-  if (!awsAccountId) {
-    throw new Error('Missing AWS Account ID. Set "config.awsAccountId" in package.json or AWS_ACCOUNT_ID env var.');
-  }
-  const image = `${awsAccountId}/${packagename}:${tag}`;
-  const cmd = `docker build -t ${image} ${context}`;
-  console.log(green(`[Docker Build]`));
-  console.log(cyan(`> ${cmd}`));
-  (0, child_process_1.execSync)(cmd, { stdio: 'inherit' });
-  console.log(green(`✓ Built ${image}`));
-}
-exports.dockerBuild = dockerBuild;
-const USAGE = `
-Usage:
-  ztechno-docker-build [options]
-
-Options:
-  --name <name>       Override image name (default: package.json "name")
-  --account <id>      Override AWS Account ID (default: package.json "config.awsAccountId")
-  --tag <tag>         Override tag (default: "latest")
-  --context <path>    Docker build context (default: ".")
-  -h, --help          Show this help
-
-package.json format:
-  {
-    "name": "my-image",
-    "config": {
-      "awsAccountId": "00028463827"
-    }
-  }
-`.trim();
-if (require.main === module) {
-  try {
-    const args = process.argv.slice(2);
-    if (args.includes('--help') || args.includes('-h')) {
-      console.log(USAGE);
-      process.exit(0);
-    }
-    const getArg = (flag) => {
-      const idx = args.indexOf(flag);
-      return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
-    };
-    dockerBuild({
-      packagename: getArg('--name'),
-      awsAccountId: getArg('--account'),
-      tag: getArg('--tag'),
-      context: getArg('--context'),
-    });
-  } catch (err) {
-    console.error(red(`✗ Error: ${err.message}`));
-    process.exit(1);
-  }
-}

package/lib/scripts/docker-publish.d.ts

@@ -1,19 +0,0 @@
-#!/usr/bin/env node
-/**
- * Run the full Docker publish pipeline: build → push → update
- * All options are auto-detected from package.json and .env
- * @param opt.packagename - Override the image name
- * @param opt.awsAccountId - Override the AWS Account ID
- * @param opt.tag - Override the tag (defaults to "latest")
- * @param opt.context - Docker build context path (defaults to ".")
- * @param opt.port - Override the port for remote update
- * @param opt.volumes - Override volumes for remote update
- */
-export declare function dockerPublish(opt?: {
-  packagename?: string;
-  awsAccountId?: string;
-  tag?: string;
-  context?: string;
-  port?: string | number;
-  volumes?: string[];
-}): Promise<void>;

package/lib/scripts/docker-publish.js

@@ -1,114 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-var __importDefault =
-  (this && this.__importDefault) ||
-  function (mod) {
-    return mod && mod.__esModule ? mod : { default: mod };
-  };
-Object.defineProperty(exports, '__esModule', { value: true });
-exports.dockerPublish = void 0;
-const path_1 = __importDefault(require('path'));
-const fs_1 = __importDefault(require('fs'));
-const dotenv_1 = require('dotenv');
-const docker_build_1 = require('./docker-build');
-const docker_push_1 = require('./docker-push');
-const docker_update_1 = require('./docker-update');
-// ANSI color helpers
-const red = (msg) => `\x1b[31m${msg}\x1b[0m`;
-const green = (msg) => `\x1b[32m${msg}\x1b[0m`;
-const cyan = (msg) => `\x1b[36m${msg}\x1b[0m`;
-function loadPackageJson() {
-  const pkgPath = path_1.default.join(process.cwd(), 'package.json');
-  if (!fs_1.default.existsSync(pkgPath)) {
-    throw new Error(`No package.json found in ${process.cwd()}`);
-  }
-  return JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf-8'));
-}
-/**
- * Run the full Docker publish pipeline: build → push → update
- * All options are auto-detected from package.json and .env
- * @param opt.packagename - Override the image name
- * @param opt.awsAccountId - Override the AWS Account ID
- * @param opt.tag - Override the tag (defaults to "latest")
- * @param opt.context - Docker build context path (defaults to ".")
- * @param opt.port - Override the port for remote update
- * @param opt.volumes - Override volumes for remote update
- */
-async function dockerPublish(opt) {
-  // Load .env so ZTECHNO_API_SECRET (and other vars) are available
-  (0, dotenv_1.config)({ path: path_1.default.join(process.cwd(), '.env') });
-  const pkg = loadPackageJson();
-  const packagename = opt?.packagename || pkg.name;
-  const awsAccountId = opt?.awsAccountId || pkg.config?.awsAccountId || process.env.AWS_ACCOUNT_ID;
-  const tag = opt?.tag || 'latest';
-  console.log(cyan(`\n[Docker Publish Pipeline]`));
-  console.log(cyan(`  Image: ${awsAccountId}/${packagename}:${tag}\n`));
-  // Step 1: Build
-  console.log(cyan(`── Step 1/3: Build ──`));
-  (0, docker_build_1.dockerBuild)({ packagename, awsAccountId, tag, context: opt?.context });
-  // Step 2: Push
-  console.log(cyan(`\n── Step 2/3: Push ──`));
-  (0, docker_push_1.dockerPush)({ packagename, awsAccountId, tag });
-  // Step 3: Update remote
-  console.log(cyan(`\n── Step 3/3: Update Remote ──`));
-  const port = opt?.port || pkg.config?.port;
-  let volumes = opt?.volumes;
-  if (!volumes && pkg.config?.volumes) {
-    volumes = Array.isArray(pkg.config.volumes) ? pkg.config.volumes : pkg.config.volumes.split(',').filter(Boolean);
-  }
-  if (!port) {
-    console.log(green(`✓ Build & push complete. Skipping remote update (no port configured).`));
-    return;
-  }
-  await (0, docker_update_1.updateDocker)({
-    packagename: packagename,
-    port,
-    volumes,
-    c: console,
-  });
-  console.log(green(`\n✓ Publish pipeline complete!`));
-}
-exports.dockerPublish = dockerPublish;
-const USAGE = `
-Usage:
-  ztechno-docker-publish [options]
-
-Runs: docker build → docker push → remote update
-
-Options:
-  --name <name>       Override image name (default: package.json "name")
-  --account <id>      Override AWS Account ID (default: package.json "config.awsAccountId")
-  --tag <tag>         Override tag (default: "latest")
-  --context <path>    Docker build context (default: ".")
-  -h, --help          Show this help
-
-package.json format:
-  {
-    "name": "my-image",
-    "config": {
-      "awsAccountId": "00028463827",
-      "port": 3000,
-      "volumes": ["/data:/app/data"]
-    }
-  }
-`.trim();
-if (require.main === module) {
-  const args = process.argv.slice(2);
-  if (args.includes('--help') || args.includes('-h')) {
-    console.log(USAGE);
-    process.exit(0);
-  }
-  const getArg = (flag) => {
-    const idx = args.indexOf(flag);
-    return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
-  };
-  dockerPublish({
-    packagename: getArg('--name'),
-    awsAccountId: getArg('--account'),
-    tag: getArg('--tag'),
-    context: getArg('--context'),
-  }).catch((err) => {
-    console.error(red(`✗ Error: ${err.message}`));
-    process.exit(1);
-  });
-}

package/lib/scripts/docker-push.d.ts

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-/**
- * Push a Docker image tagged as <awsAccountId>/<packagename>:latest
- * @param opt.packagename - Override the image name (defaults to package.json name)
- * @param opt.awsAccountId - Override the AWS Account ID (defaults to package.json config.awsAccountId)
- * @param opt.tag - Override the tag (defaults to "latest")
- */
-export declare function dockerPush(opt?: { packagename?: string; awsAccountId?: string; tag?: string }): void;

package/lib/scripts/docker-push.js

@@ -1,87 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-var __importDefault =
-  (this && this.__importDefault) ||
-  function (mod) {
-    return mod && mod.__esModule ? mod : { default: mod };
-  };
-Object.defineProperty(exports, '__esModule', { value: true });
-exports.dockerPush = void 0;
-const child_process_1 = require('child_process');
-const path_1 = __importDefault(require('path'));
-const fs_1 = __importDefault(require('fs'));
-// ANSI color helpers
-const red = (msg) => `\x1b[31m${msg}\x1b[0m`;
-const green = (msg) => `\x1b[32m${msg}\x1b[0m`;
-const cyan = (msg) => `\x1b[36m${msg}\x1b[0m`;
-function loadPackageJson() {
-  const pkgPath = path_1.default.join(process.cwd(), 'package.json');
-  if (!fs_1.default.existsSync(pkgPath)) {
-    throw new Error(`No package.json found in ${process.cwd()}`);
-  }
-  return JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf-8'));
-}
-/**
- * Push a Docker image tagged as <awsAccountId>/<packagename>:latest
- * @param opt.packagename - Override the image name (defaults to package.json name)
- * @param opt.awsAccountId - Override the AWS Account ID (defaults to package.json config.awsAccountId)
- * @param opt.tag - Override the tag (defaults to "latest")
- */
-function dockerPush(opt) {
-  const pkg = loadPackageJson();
-  const packagename = opt?.packagename || pkg.name;
-  const awsAccountId = opt?.awsAccountId || pkg.config?.awsAccountId || process.env.AWS_ACCOUNT_ID;
-  const tag = opt?.tag || 'latest';
-  if (!packagename) {
-    throw new Error('Missing package name. Set "name" in package.json or pass --name.');
-  }
-  if (!awsAccountId) {
-    throw new Error('Missing AWS Account ID. Set "config.awsAccountId" in package.json or AWS_ACCOUNT_ID env var.');
-  }
-  const image = `${awsAccountId}/${packagename}:${tag}`;
-  const cmd = `docker push ${image}`;
-  console.log(green(`[Docker Push]`));
-  console.log(cyan(`> ${cmd}`));
-  (0, child_process_1.execSync)(cmd, { stdio: 'inherit' });
-  console.log(green(`✓ Pushed ${image}`));
-}
-exports.dockerPush = dockerPush;
-const USAGE = `
-Usage:
-  ztechno-docker-push [options]
-
-Options:
-  --name <name>       Override image name (default: package.json "name")
-  --account <id>      Override AWS Account ID (default: package.json "config.awsAccountId")
-  --tag <tag>         Override tag (default: "latest")
-  -h, --help          Show this help
-
-package.json format:
-  {
-    "name": "my-image",
-    "config": {
-      "awsAccountId": "00028463827"
-    }
-  }
-`.trim();
-if (require.main === module) {
-  try {
-    const args = process.argv.slice(2);
-    if (args.includes('--help') || args.includes('-h')) {
-      console.log(USAGE);
-      process.exit(0);
-    }
-    const getArg = (flag) => {
-      const idx = args.indexOf(flag);
-      return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
-    };
-    dockerPush({
-      packagename: getArg('--name'),
-      awsAccountId: getArg('--account'),
-      tag: getArg('--tag'),
-    });
-  } catch (err) {
-    console.error(red(`✗ Error: ${err.message}`));
-    process.exit(1);
-  }
-}

package/lib/scripts/docker-update.d.ts

@@ -1,27 +0,0 @@
-#!/usr/bin/env node
-export interface DockerUpdateOptions {
-  /** The package/image name */
-  packagename: string;
-  /** The port number */
-  port: string | number;
-  /** Optional array of volume mappings */
-  volumes?: string[];
-  /** Optional logger (defaults to silent) */
-  c?: {
-    log: (...args: any[]) => void;
-    error: (...args: any[]) => void;
-  };
-  /** Request timeout in ms (default: 30000) */
-  timeout?: number;
-}
-export interface DockerUpdateResult {
-  success: boolean;
-  message?: string;
-  err?: string;
-}
-/**
- * Update a remote Docker container via the V2 Secure API
- * @param opt - Update options
- * @returns Promise resolving to success status and message
- */
-export declare function updateDocker(opt: DockerUpdateOptions): Promise<DockerUpdateResult>;

package/lib/scripts/docker-update.js

@@ -1,207 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-var __importDefault =
-  (this && this.__importDefault) ||
-  function (mod) {
-    return mod && mod.__esModule ? mod : { default: mod };
-  };
-Object.defineProperty(exports, '__esModule', { value: true });
-exports.updateDocker = void 0;
-const http_1 = __importDefault(require('http'));
-const crypto_1 = __importDefault(require('crypto'));
-const path_1 = __importDefault(require('path'));
-const fs_1 = __importDefault(require('fs'));
-const dotenv_1 = require('dotenv');
-const crypto_service_1 = require('../crypto_service');
-// ANSI color helpers
-const red = (msg) => `\x1b[31m${msg}\x1b[0m`;
-const green = (msg) => `\x1b[32m${msg}\x1b[0m`;
-const cyan = (msg) => `\x1b[36m${msg}\x1b[0m`;
-const blue = (msg) => `\x1b[34m${msg}\x1b[0m`;
-/** Default request timeout in milliseconds (30 seconds) */
-const REQUEST_TIMEOUT_MS = 30000;
-/**
- * Update a remote Docker container via the V2 Secure API
- * @param opt - Update options
- * @returns Promise resolving to success status and message
- */
-function updateDocker(opt) {
-  return new Promise((resolve, reject) => {
-    const { packagename, port, volumes, c, timeout = REQUEST_TIMEOUT_MS } = opt;
-    const secretKey = process.env.ZTECHNO_API_SECRET;
-    if (!secretKey) {
-      c?.log(red('✗ Error: ZTECHNO_API_SECRET environment variable not set'));
-      return reject(new Error('ZTECHNO_API_SECRET environment variable not set'));
-    }
-    // Generate timestamp and HMAC signature
-    const timestamp = Date.now().toString();
-    const volumesString = volumes && volumes.length > 0 ? volumes.join(',') : '';
-    const payload = timestamp + packagename + port + volumesString;
-    const signature = crypto_1.default.createHmac('sha256', secretKey).update(payload).digest('hex');
-    c?.log(green(`[Updating Remote Docker via V2 Secure API]`));
-    // Build query parameters with proper encoding
-    const query = new URLSearchParams({ port: String(port) });
-    if (volumesString) {
-      query.set('volumes', volumesString);
-    }
-    const options = {
-      hostname: crypto_service_1.ZCryptoService.decrypt({
-        iv: '00d1df14932d0e6b5d064cceb037f586',
-        encryptedData: '05b9d826539fe2cbdf7d7ecccfe57635',
-      }),
-      port: 7998,
-      path: `/v2/images/${encodeURIComponent(packagename)}/update?${query}`,
-      method: 'GET',
-      timeout,
-      headers: {
-        'x-timestamp': timestamp,
-        'x-signature': signature,
-      },
-    };
-    const req = http_1.default.request(options, (res) => {
-      let data = '';
-      res.on('data', (chunk) => {
-        data += chunk;
-      });
-      res.on('end', () => {
-        try {
-          const response = JSON.parse(data);
-          c?.log(cyan(`Status Code: ${res.statusCode}`));
-          c?.log(blue(`Response: ${JSON.stringify(response, null, 2)}`));
-          if (response.success) {
-            c?.log(green(`✓ ${response.message}`));
-          } else {
-            c?.log(red(`✗ Error: ${response.err}`));
-          }
-          resolve(response);
-        } catch (err) {
-          c?.log(red(`Failed to parse response: ${data}`));
-          c?.error(err);
-          reject(err);
-        }
-      });
-    });
-    req.on('timeout', () => {
-      req.destroy();
-      const err = new Error(`Request timed out after ${timeout}ms`);
-      c?.log(red(`✗ ${err.message}`));
-      reject(err);
-    });
-    req.on('error', (err) => {
-      c?.log(red(`✗ Request failed: ${err.message}`));
-      reject(err);
-    });
-    req.end();
-  });
-}
-exports.updateDocker = updateDocker;
-/**
- * Read the consumer's package.json from the current working directory.
- * Returns null if not found or unreadable.
- */
-function loadPackageJson() {
-  try {
-    const pkgPath = path_1.default.join(process.cwd(), 'package.json');
-    if (!fs_1.default.existsSync(pkgPath)) return null;
-    return JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf-8'));
-  } catch {
-    return null;
-  }
-}
-/**
- * Auto-detect options from .env and/or package.json in the current working directory.
- *
- * Resolution order for each field:
- *   1. .env / environment variable
- *   2. package.json (name → packagename, config.port → port, config.volumes → volumes)
- *
- * Required: packagename, port, ZTECHNO_API_SECRET (env only)
- * Optional: volumes (comma-separated)
- */
-function loadOptionsFromEnv() {
-  // Load .env file
-  const envPath = path_1.default.join(process.cwd(), '.env');
-  const cfg = (0, dotenv_1.config)({ path: envPath });
-  if (cfg.error && cfg.error.message && !cfg.error.message.includes('ENOENT')) {
-    throw cfg.error;
-  }
-  // Load package.json as fallback
-  const pkg = loadPackageJson();
-  const packagename = cfg.parsed?.packagename || process.env.packagename || pkg?.name;
-  const port =
-    cfg.parsed?.port || process.env.port || (pkg?.config?.port != null ? String(pkg.config.port) : undefined);
-  const volumesRaw = cfg.parsed?.volumes || process.env.volumes || pkg?.config?.volumes;
-  if (pkg) {
-    console.log(`Detected package.json: ${pkg.name || '(unnamed)'}`);
-  }
-  if (!packagename) {
-    throw new Error('Missing packagename. Set it in .env, environment, or package.json "name".');
-  }
-  if (!port) {
-    throw new Error('Missing port. Set it in .env, environment, or package.json "config.port".');
-  }
-  // Normalize volumes: accept string[] from package.json or comma-separated string from .env
-  let volumes;
-  if (Array.isArray(volumesRaw)) {
-    volumes = volumesRaw.filter(Boolean);
-  } else if (typeof volumesRaw === 'string') {
-    volumes = volumesRaw.split(',').filter(Boolean);
-  }
-  return { packagename, port, volumes };
-}
-const USAGE = `
-Usage:
-  ztechno-docker-update <packagename>:<port>
-  ztechno-docker-update                         (auto-detect from .env / package.json)
-
-Auto-detection priority:
-  1. .env file      → packagename, port, volumes, ZTECHNO_API_SECRET
-  2. package.json   → "name" as packagename, "config.port", "config.volumes"
-
-.env file format:
-  ZTECHNO_API_SECRET=your_secret
-  packagename=my-image
-  port=3000
-  volumes=/host/path:/container/path   (optional, comma-separated)
-
-package.json format:
-  {
-    "name": "my-image",
-    "config": {
-      "port": 3000,
-      "volumes": ["/host/path:/container/path", "/logs:/app/logs"]
-    }
-  }
-`.trim();
-// Run if executed directly (node docker-update.js or npx ztechno-docker-update)
-if (require.main === module) {
-  const main = async () => {
-    const arg = process.argv[2];
-    if (arg === '--help' || arg === '-h') {
-      console.log(USAGE);
-      return;
-    }
-    // No argument: load from .env
-    if (arg === undefined) {
-      const { packagename, port, volumes } = loadOptionsFromEnv();
-      await updateDocker({ packagename, port, volumes, c: console });
-      return;
-    }
-    // Argument with colon: packagename:port
-    if (arg.includes(':')) {
-      const [packagename, port] = arg.split(':');
-      if (!packagename || !port) {
-        throw new Error(`Invalid argument "${arg}". Expected format: <packagename>:<port>`);
-      }
-      await updateDocker({ packagename, port, c: console });
-      return;
-    }
-    console.error(red(`✗ Invalid argument: "${arg}"`));
-    console.log(USAGE);
-    process.exit(1);
-  };
-  main().catch((err) => {
-    console.error(red(`✗ Error: ${err.message}`));
-    process.exit(1);
-  });
-}

package/lib/scripts/encrypt.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/scripts/encrypt.js

@@ -1,4 +0,0 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', { value: true });
-const crypto_service_1 = require('../crypto_service');
-console.log(crypto_service_1.ZCryptoService.encrypt('...'));

package/lib/sql_service.d.ts

@@ -1,123 +0,0 @@
-import * as mysql from 'mysql';
-type ZOnErrorCallback = (err: mysql.MysqlError) => any;
-type ZOnLogCallback = (log: string) => any;
-export type ZSQLOptions = mysql.PoolConfig & {
-  dateStringTimezone?: string;
-  parseBooleans?: boolean;
-};
-export declare class ZSQLService {
-  private options;
-  private pool;
-  private defaultPoolconfig;
-  private listeners;
-  private databaseName;
-  get database(): string;
-  /**
-   * Creates a new ZSQLService instance with a MySQL connection pool.
-   * @param options - MySQL pool configuration options including custom dateStringTimezone and parseBooleans settings
-   */
-  constructor(options: ZSQLOptions);
-  /**
-   * Registers an event listener for database errors or logs.
-   * @param eventName - The event type to listen for ('err' or 'log')
-   * @param listener - The callback function to execute when the event occurs
-   * @throws Error if the event name is not supported
-   */
-  on(eventName: 'err', listener: ZOnErrorCallback): void;
-  on(eventName: 'log', listener: ZOnLogCallback): void;
-  private triggerEvent;
-  private getPoolConnection;
-  /**
-   * Executes a SQL query with automatic type conversion for dates and booleans.
-   * Converts TINYINT(1) columns to booleans if parseBooleans option is enabled.
-   * Converts date strings to Date objects if dateStringTimezone option is set.
-   * @template T - The expected result type
-   * @param opt - Query options containing the SQL query string and optional parameters
-   * @param opt.query - The SQL query string to execute
-   * @param opt.params - Optional query parameters (array for positional, object for named parameters)
-   * @returns Promise resolving to query results with type conversions applied
-   */
-  exec(opt: {
-    query: string;
-    params?:
-      | any[]
-      | {
-          [key: string]: any;
-        };
-  }): Promise<{
-    insertId: number;
-    affectedRows: number;
-  }>;
-  exec<T = any>(opt: {
-    query: string;
-    params?:
-      | any[]
-      | {
-          [key: string]: any;
-        };
-  }): Promise<T[]>;
-  /**
-   * Legacy method to execute a SQL query. Uses uppercase property names for backwards compatibility.
-   * Applies date and boolean conversions if configured. Consider using exec() directly for new code.
-   * @template T - The expected result type
-   * @param opt - Query options
-   * @param opt.Query - The SQL query string to execute
-   * @param opt.Params - Named parameters for the query
-   * @returns Promise resolving to query results
-   */
-  fetch<T = any>(opt: {
-    Query: string;
-    Params:
-      | {
-          [key: string]: any;
-        }
-      | any[];
-  }): Promise<T[]>;
-  fetch<T = any>(
-    query: string,
-    params:
-      | {
-          [key: string]: any;
-        }
-      | any[],
-  ): Promise<T[]>;
-  /**
-   * Executes a SQL query without type conversions.
-   * Supports both positional (array) and named (object) parameters.
-   * @template T - The expected result type
-   * @param sql - The SQL query string to execute
-   * @param params - Optional query parameters (array for positional with ?, object for named with :key)
-   * @returns Promise resolving to query results or insert/update metadata
-   */
-  query(
-    sql: string,
-    params?:
-      | any[]
-      | {
-          [key: string]: any;
-        },
-  ): Promise<{
-    insertId: number;
-    affectedRows: number;
-  }>;
-  query<T = any>(
-    sql: string,
-    params?:
-      | any[]
-      | {
-          [key: string]: any;
-        },
-  ): Promise<T[]>;
-  private queryWithFields;
-  private formatQueryParams;
-  private isSqlDate;
-  /**
-   * Changes the active database by closing the current connection pool and creating a new one.
-   * All active connections will be gracefully closed before switching.
-   * @param newDatabase - The name of the database to switch to
-   * @returns Promise that resolves when the database has been changed successfully
-   * @throws Error if the pool cannot be closed or new pool cannot be created
-   */
-  changeDatabase(newDatabase: string): Promise<void>;
-}
-export {};