@this-npm-test-org/sql-driver-sdk 0.1.0

package/dist/src/parser-registry.js

@@ -0,0 +1,194 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Discovery and loading of SQL parsers published as npm packages.
+ *
+ * Parsers register independently of drivers so the MCP-SQL driver can
+ * pair with any installed parser for its dialect, and so multiple
+ * drivers can share one parser (native postgres + MCP-shaped postgres
+ * both use `@amodalai/postgres-parser`). The registry-implementation
+ * class also satisfies the `ParserRegistry` interface from
+ * `@amodalai/types`, which `SqlDriver.init(config, parsers)` receives.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { SqlRegistryError } from './errors.js';
+/**
+ * Scan candidate packages for `amodalParser` blocks. Packages missing
+ * the block are skipped silently; malformed blocks throw
+ * `SqlRegistryError`.
+ */
+export function discoverParsers(opts) {
+    const descriptors = [];
+    for (const packageName of opts.candidatePackages) {
+        const descriptor = readParserDescriptor(packageName, opts.repoPath);
+        if (descriptor) {
+            descriptors.push(descriptor);
+            opts.logger.info('sql_parser_discovered', {
+                package: descriptor.packageName,
+                dialects: descriptor.dialects,
+                sdk_version: descriptor.sdkVersion,
+            });
+        }
+    }
+    return descriptors;
+}
+function readParserDescriptor(packageName, repoPath) {
+    const packageDir = path.join(repoPath, 'node_modules', ...packageName.split('/'));
+    const pkgJsonPath = path.join(packageDir, 'package.json');
+    if (!existsSync(pkgJsonPath)) {
+        return undefined;
+    }
+    const pkgJson = parsePackageJson(pkgJsonPath, packageName);
+    const block = pkgJson['amodalParser'];
+    if (block === undefined) {
+        return undefined;
+    }
+    return validateParserDescriptor(block, packageName, packageDir);
+}
+function validateParserDescriptor(block, packageName, packageDir) {
+    if (typeof block !== 'object' || block === null || Array.isArray(block)) {
+        throw new SqlRegistryError('INVALID_DESCRIPTOR', `Package "${packageName}" has an amodalParser field that is not an object`, { kind: 'parser', packageName });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- narrowed by the typeof/null/array guards above.
+    const raw = block;
+    const dialects = raw['dialects'];
+    if (!Array.isArray(dialects) ||
+        dialects.length === 0 ||
+        !dialects.every((d) => typeof d === 'string')) {
+        throw new SqlRegistryError('INVALID_DESCRIPTOR', `Package "${packageName}" amodalParser.dialects must be a non-empty string array`, { kind: 'parser', packageName });
+    }
+    const moduleRel = raw['module'];
+    if (typeof moduleRel !== 'string' || moduleRel.length === 0) {
+        throw new SqlRegistryError('INVALID_DESCRIPTOR', `Package "${packageName}" amodalParser.module must be a relative path string`, { kind: 'parser', packageName });
+    }
+    const moduleEntry = path.resolve(packageDir, moduleRel);
+    if (!moduleEntry.startsWith(path.resolve(packageDir))) {
+        throw new SqlRegistryError('INVALID_DESCRIPTOR', `Package "${packageName}" amodalParser.module escapes the package directory`, { kind: 'parser', packageName, context: { moduleRel } });
+    }
+    const exportName = raw['exportName'];
+    if (typeof exportName !== 'string' || exportName.length === 0) {
+        throw new SqlRegistryError('INVALID_DESCRIPTOR', `Package "${packageName}" amodalParser.exportName must be a non-empty string`, { kind: 'parser', packageName });
+    }
+    const sdkVersion = raw['sdkVersion'];
+    if (typeof sdkVersion !== 'string' || sdkVersion.length === 0) {
+        throw new SqlRegistryError('INVALID_DESCRIPTOR', `Package "${packageName}" amodalParser.sdkVersion must be a semver range string`, { kind: 'parser', packageName });
+    }
+    return {
+        packageName,
+        dialects,
+        packageDir,
+        moduleEntry,
+        exportName,
+        sdkVersion,
+    };
+}
+function parsePackageJson(pkgJsonPath, packageName) {
+    const raw = readFileSync(pkgJsonPath, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (cause) {
+        throw new SqlRegistryError('INVALID_DESCRIPTOR', `Package "${packageName}" has unparseable package.json`, { kind: 'parser', packageName, cause });
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new SqlRegistryError('INVALID_DESCRIPTOR', `Package "${packageName}" package.json is not an object`, { kind: 'parser', packageName });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- narrowed by the typeof/null/array guards above.
+    return parsed;
+}
+/**
+ * Implementation of the `ParserRegistry` shape from `@amodalai/types`,
+ * which is what `SqlDriver.init(config, parsers)` receives. Parsers
+ * are cached after first load — they're stateless and safely shared
+ * across drivers.
+ */
+export class ParserRegistry {
+    byName;
+    cache = new Map();
+    logger;
+    constructor(descriptors, logger) {
+        this.byName = new Map(descriptors.map((d) => [d.packageName, d]));
+        this.logger = logger;
+    }
+    list() {
+        return Array.from(this.byName.values()).map((d) => ({
+            name: d.packageName,
+            dialects: d.dialects,
+        }));
+    }
+    has(packageName) {
+        return this.byName.has(packageName);
+    }
+    /**
+     * Synchronous interface required by `SqlDriver.init()` — drivers
+     * resolve parsers during the load handshake and shouldn't have to
+     * await. Parser instances must be preloaded via `prepare()` first.
+     */
+    getParser(packageName) {
+        const cached = this.cache.get(packageName);
+        if (cached)
+            return cached;
+        throw new SqlRegistryError('PACKAGE_NOT_FOUND', `Parser "${packageName}" was requested but not preloaded. The repo loader must call ParserRegistry.prepare() for every parser referenced by a connection before driver init.`, { kind: 'parser', packageName });
+    }
+    /**
+     * Preload a parser. Called by the repo loader for each parser name
+     * referenced by an SQL connection, before any `driver.init()` runs.
+     * Idempotent — calling twice returns the cached instance.
+     */
+    async prepare(packageName) {
+        const existing = this.cache.get(packageName);
+        if (existing)
+            return existing;
+        const descriptor = this.byName.get(packageName);
+        if (!descriptor) {
+            throw new SqlRegistryError('PACKAGE_NOT_FOUND', `Parser "${packageName}" was referenced but not discovered. Add it to the agent's packages list and run npm install.`, { kind: 'parser', packageName });
+        }
+        const moduleUrl = pathToFileURL(descriptor.moduleEntry).href;
+        let mod;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- dynamic import yields unknown module shape; narrowed below.
+            mod = (await import(moduleUrl));
+        }
+        catch (cause) {
+            throw new SqlRegistryError('FACTORY_FAILED', `Failed to import parser "${packageName}" from ${descriptor.moduleEntry}`, { kind: 'parser', packageName, cause });
+        }
+        const factory = mod[descriptor.exportName];
+        if (typeof factory !== 'function') {
+            throw new SqlRegistryError('FACTORY_MISSING', `Parser "${packageName}" does not export "${descriptor.exportName}" as a function`, { kind: 'parser', packageName, context: { exportName: descriptor.exportName } });
+        }
+        let instance;
+        try {
+            instance = factory();
+        }
+        catch (cause) {
+            throw new SqlRegistryError('FACTORY_FAILED', `Parser "${packageName}" factory "${descriptor.exportName}" threw`, { kind: 'parser', packageName, cause });
+        }
+        if (!isParser(instance)) {
+            throw new SqlRegistryError('INVALID_INSTANCE', `Parser "${packageName}" factory returned a value that is not a Parser`, { kind: 'parser', packageName });
+        }
+        this.cache.set(packageName, instance);
+        this.logger.info('sql_parser_loaded', {
+            package: packageName,
+            dialects: instance.dialects,
+        });
+        return instance;
+    }
+}
+function isParser(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- narrowed by the typeof/null guards above.
+    const obj = value;
+    if (typeof obj['parse'] !== 'function')
+        return false;
+    const dialects = obj['dialects'];
+    return (Array.isArray(dialects) &&
+        dialects.every((d) => typeof d === 'string'));
+}
+//# sourceMappingURL=parser-registry.js.map

package/dist/src/parser-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-registry.js","sourceRoot":"","sources":["../../src/parser-registry.ts"],"names":[],"mappings":"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"}

package/dist/src/sql-connection-parsers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { SqlConnectionConfig, SchemaJson } from './sql-connection-schemas.js';
+/**
+ * Parse the JSON contents of a connection's `spec.json` /
+ * `connection.json` file for a SQL connection. The caller has
+ * already verified `protocol === 'sql'`.
+ */
+export declare function parseSqlConnectionConfig(jsonString: string, filename: string): SqlConnectionConfig;
+/**
+ * Parse the JSON contents of a connection's `schema.json` file.
+ */
+export declare function parseSchemaJson(jsonString: string, filename: string): SchemaJson;

package/dist/src/sql-connection-parsers.js

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * JSON-parse + zod-validate helpers for SQL connection files. The
+ * repo loader calls these for connections whose protocol is `sql`;
+ * REST/MCP connections still use `parseSpecJson` / `parseAccessJson`
+ * in `repo/parsers.ts`.
+ */
+import { ZodError } from 'zod';
+import { RepoError } from '@amodalai/types';
+import { SqlConnectionConfigSchema, SchemaJsonSchema, } from './sql-connection-schemas.js';
+/**
+ * Parse the JSON contents of a connection's `spec.json` /
+ * `connection.json` file for a SQL connection. The caller has
+ * already verified `protocol === 'sql'`.
+ */
+export function parseSqlConnectionConfig(jsonString, filename) {
+    return parseAndValidate(jsonString, SqlConnectionConfigSchema, filename);
+}
+/**
+ * Parse the JSON contents of a connection's `schema.json` file.
+ */
+export function parseSchemaJson(jsonString, filename) {
+    return parseAndValidate(jsonString, SchemaJsonSchema, filename);
+}
+function parseAndValidate(jsonString, schema, filename) {
+    let raw;
+    try {
+        raw = JSON.parse(jsonString);
+    }
+    catch (cause) {
+        throw new RepoError('CONFIG_PARSE_FAILED', `Invalid JSON in ${filename}`, cause);
+    }
+    try {
+        return schema.parse(raw);
+    }
+    catch (err) {
+        if (err instanceof ZodError) {
+            const issues = err.issues
+                .map((i) => `${i.path.join('.') || '<root>'}: ${i.message}`)
+                .join('; ');
+            throw new RepoError('CONFIG_VALIDATION_FAILED', `${filename} validation failed: ${issues}`, err);
+        }
+        throw new RepoError('CONFIG_VALIDATION_FAILED', `${filename} validation failed`, err);
+    }
+}
+//# sourceMappingURL=sql-connection-parsers.js.map

package/dist/src/sql-connection-parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-connection-parsers.js","sourceRoot":"","sources":["../../src/sql-connection-parsers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AAEH,OAAO,EAAC,QAAQ,EAAC,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAG1C,OAAO,EACL,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,UAAkB,EAClB,QAAgB;IAEhB,OAAO,gBAAgB,CACrB,UAAU,EACV,yBAAyB,EACzB,QAAQ,CACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAkB,EAClB,QAAgB;IAEhB,OAAO,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,gBAAgB,CACvB,UAAkB,EAClB,MAAkC,EAClC,QAAgB;IAEhB,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CACjB,qBAAqB,EACrB,mBAAmB,QAAQ,EAAE,EAC7B,KAAK,CACN,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM;iBACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,SAAS,CACjB,0BAA0B,EAC1B,GAAG,QAAQ,uBAAuB,MAAM,EAAE,EAC1C,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,0BAA0B,EAC1B,GAAG,QAAQ,oBAAoB,EAC/B,GAAG,CACJ,CAAC;IACJ,CAAC;AACH,CAAC"}