Function parseConnectionString

src/utils/connectionStringParser.ts:144–230

(
  connectionString: string,
  drivers?: ReadonlyArray<ConnectionStringDriver>,
)

 * Supported protocols are inferred from the provided drivers/capabilities.
 */
export function parseConnectionString(
  connectionString: string,
  drivers?: ReadonlyArray<ConnectionStringDriver>,
): ConnectionStringResult {
  if (!connectionString || !connectionString.trim()) {
    return { success: false, error: "Connection string is empty" };
  }

  const trimmed = connectionString.trim();

  let url: URL;
  try {
    url = new URL(trimmed);
  } catch {
    return { success: false, error: "Invalid connection string format" };
  }

  const protocol = normalizeProtocol(url.protocol);
  const registry = buildProtocolRegistry(drivers);
  const resolved = registry.get(protocol);

  if (!resolved) {
    const supported = getSupportedConnectionStringProtocols(drivers);
    const suffix =
      supported.length > 0 ? `. Supported: ${supported.join(", ")}` : "";
    return {
      success: false,
      error: `Unsupported database driver: ${protocol}${suffix}`,
    };
  }

  if (resolved.local) {
    const rawPath = url.pathname;
    if (!rawPath) {
      return {
        success: false,
        error: "Connection string must include a database path",
      };
    }

    const database = decodeURIComponent(rawPath.replace(/^\//, ""));
    if (!database) {
      return {
        success: false,
        error: "Connection string must include a database path",
      };
    }

    return {
      success: true,
      params: {
        driver: resolved.id,
        database,
      },
    };
  }

  const host = url.hostname || undefined;