@memberjunction/sqlglot-ts 0.0.1 → 5.5.0

package/README.md

@@ -1,45 +1,89 @@
 # @memberjunction/sqlglot-ts
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+A TypeScript wrapper for Python's [sqlglot](https://github.com/tobymao/sqlglot) SQL transpiler. Provides deterministic, verifiable SQL dialect conversion via a managed local Python FastAPI microservice.
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+## Features
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+- **31 SQL dialects** supported (T-SQL, PostgreSQL, MySQL, Snowflake, BigQuery, etc.)
+- **Deterministic conversion** — no LLM randomness, reproducible results
+- **Zero MemberJunction dependencies** — standalone community package
+- **Ephemeral port binding** — microservice runs on `127.0.0.1` with auto-assigned port
+- **Managed lifecycle** — automatic startup/shutdown of the Python process
+- **Statement-by-statement mode** — individual statement tracking, one failure doesn't block others
 
-## Purpose
+## Prerequisites
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@memberjunction/sqlglot-ts`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+- **Python 3.9+** with `sqlglot`, `fastapi`, and `uvicorn` installed:
 
-## What is OIDC Trusted Publishing?
+```bash
+pip install sqlglot fastapi uvicorn
+```
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+## Usage
 
-## Setup Instructions
+```typescript
+import { SqlGlotClient } from '@memberjunction/sqlglot-ts';
 
-To properly configure OIDC trusted publishing for this package:
+const client = new SqlGlotClient();
+await client.start();
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+// Transpile T-SQL to PostgreSQL
+const result = await client.transpile(
+  "SELECT ISNULL(col, 0) FROM [dbo].[MyTable]",
+  { fromDialect: 'tsql', toDialect: 'postgres' }
+);
+console.log(result.sql);
+// Output: SELECT COALESCE(col, 0) FROM "dbo"."MyTable";
 
-## DO NOT USE THIS PACKAGE
+// Statement-by-statement mode
+const stmtResult = await client.transpileStatements(
+  "SELECT TOP 10 * FROM Users; SELECT GETDATE();",
+  { fromDialect: 'tsql', toDialect: 'postgres' }
+);
+console.log(stmtResult.statements);
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+// Parse SQL to AST
+const ast = await client.parse(
+  "SELECT 1",
+  { dialect: 'postgres' }
+);
 
-## More Information
+// List supported dialects
+const dialects = await client.getDialects();
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+// Health check
+const health = await client.health();
 
----
+await client.stop();
+```
 
-**Maintained for OIDC setup purposes only**
+## API
+
+### `SqlGlotClient`
+
+#### Constructor Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `pythonPath` | `string` | `'python3'` | Path to Python executable |
+| `serverPath` | `string` | auto-detected | Path to `server.py` |
+| `startupTimeoutMs` | `number` | `30000` | Max ms to wait for server startup |
+| `requestTimeoutMs` | `number` | `60000` | Max ms per HTTP request |
+
+#### Methods
+
+- `start()` — Start the Python microservice
+- `stop()` — Stop the Python microservice
+- `transpile(sql, options)` — Transpile SQL between dialects (batch)
+- `transpileStatements(sql, options)` — Transpile statement-by-statement
+- `parse(sql, options)` — Parse SQL to AST (JSON)
+- `getDialects()` — List all supported dialects
+- `health()` — Server health check
+
+## Attribution
+
+This package wraps the excellent [sqlglot](https://github.com/tobymao/sqlglot) Python library by Toby Mao and contributors. sqlglot provides a comprehensive SQL parser, transpiler, and optimizer supporting 31 SQL dialects with 8,900+ stars and 7,000+ commits.
+
+## License
+
+ISC

package/dist/SqlGlotClient.d.ts

@@ -0,0 +1,80 @@
+import type { SqlGlotClientOptions, TranspileOptions, TranspileResult, ParseOptions, ParseResult, HealthStatus } from './types.js';
+/**
+ * TypeScript client for the sqlglot Python microservice.
+ *
+ * Spawns a Python FastAPI process on 127.0.0.1 with an ephemeral port,
+ * then communicates via HTTP. The lifecycle methods `start()` and `stop()`
+ * manage the child process. Cleanup handlers are registered for SIGINT/SIGTERM.
+ *
+ * @example
+ * ```ts
+ * const client = new SqlGlotClient();
+ * await client.start();
+ *
+ * const result = await client.transpile({
+ *   sql: "SELECT ISNULL(col, 0) FROM [dbo].[MyTable]",
+ *   fromDialect: 'tsql',
+ *   toDialect: 'postgres',
+ * });
+ * console.log(result.sql);
+ *
+ * await client.stop();
+ * ```
+ */
+export declare class SqlGlotClient {
+    private process;
+    private port;
+    private readonly pythonPath;
+    private readonly serverPath;
+    private readonly startupTimeoutMs;
+    private readonly requestTimeoutMs;
+    private stopping;
+    private cleanupRegistered;
+    constructor(options?: SqlGlotClientOptions);
+    /** Whether the Python microservice is currently running */
+    get IsRunning(): boolean;
+    /** The port the Python microservice is listening on, or null if not running */
+    get Port(): number | null;
+    /**
+     * Start the Python microservice. Resolves once the server is ready.
+     * If already running, this is a no-op.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the Python microservice. Resolves once the process has exited.
+     * If not running, this is a no-op.
+     */
+    stop(): Promise<void>;
+    /**
+     * Transpile SQL from one dialect to another.
+     * All statements are transpiled together as a batch.
+     */
+    transpile(sql: string, options: TranspileOptions): Promise<TranspileResult>;
+    /**
+     * Transpile SQL statement-by-statement.
+     * Each statement is transpiled individually, so one failure doesn't block others.
+     */
+    transpileStatements(sql: string, options: TranspileOptions): Promise<TranspileResult>;
+    /**
+     * Parse SQL and return the AST as JSON.
+     */
+    parse(sql: string, options: ParseOptions): Promise<ParseResult>;
+    /**
+     * List all supported SQL dialects.
+     */
+    getDialects(): Promise<string[]>;
+    /**
+     * Check server health and return status information.
+     */
+    health(): Promise<HealthStatus>;
+    private assertRunning;
+    /**
+     * Poll the health endpoint until the server is accepting requests.
+     * Uses short intervals with an overall timeout from startupTimeoutMs.
+     */
+    private waitForReady;
+    private registerCleanup;
+    private httpPost;
+    private httpGet;
+}
+//# sourceMappingURL=SqlGlotClient.d.ts.map

package/dist/SqlGlotClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlGlotClient.d.ts","sourceRoot":"","sources":["../src/SqlGlotClient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AAyBpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,OAAO,CAAC,EAAE,oBAAoB;IAO1C,2DAA2D;IAC3D,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,+EAA+E;IAC/E,IAAI,IAAI,IAAI,MAAM,GAAG,IAAI,CAExB;IAED;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyE5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B;;;OAGG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAWjF;;;OAGG;IACG,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAW3F;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAQrE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMtC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAerC,OAAO,CAAC,aAAa;IAQrB;;;OAGG;YACW,YAAY;IAc1B,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,QAAQ;IA6ChB,OAAO,CAAC,OAAO;CAsChB"}

package/dist/SqlGlotClient.js

@@ -0,0 +1,332 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import http from 'node:http';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Resolve the Python server script path.
+ * When running from dist/ the path is ../src/python/server.py
+ * When running from src/ (e.g. vitest) the path is ./python/server.py
+ */
+function resolveServerPath() {
+    const candidates = [
+        path.resolve(__dirname, '..', 'src', 'python', 'server.py'), // from dist/
+        path.resolve(__dirname, 'python', 'server.py'), // from src/ (vitest)
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return candidates[0]; // fallback; will fail at spawn time with a clear error
+}
+const DEFAULT_SERVER_PATH = resolveServerPath();
+/**
+ * TypeScript client for the sqlglot Python microservice.
+ *
+ * Spawns a Python FastAPI process on 127.0.0.1 with an ephemeral port,
+ * then communicates via HTTP. The lifecycle methods `start()` and `stop()`
+ * manage the child process. Cleanup handlers are registered for SIGINT/SIGTERM.
+ *
+ * @example
+ * ```ts
+ * const client = new SqlGlotClient();
+ * await client.start();
+ *
+ * const result = await client.transpile({
+ *   sql: "SELECT ISNULL(col, 0) FROM [dbo].[MyTable]",
+ *   fromDialect: 'tsql',
+ *   toDialect: 'postgres',
+ * });
+ * console.log(result.sql);
+ *
+ * await client.stop();
+ * ```
+ */
+export class SqlGlotClient {
+    constructor(options) {
+        this.process = null;
+        this.port = null;
+        this.stopping = false;
+        this.cleanupRegistered = false;
+        this.pythonPath = options?.pythonPath ?? 'python3';
+        this.serverPath = options?.serverPath ?? DEFAULT_SERVER_PATH;
+        this.startupTimeoutMs = options?.startupTimeoutMs ?? 30000;
+        this.requestTimeoutMs = options?.requestTimeoutMs ?? 60000;
+    }
+    /** Whether the Python microservice is currently running */
+    get IsRunning() {
+        return this.process !== null && this.port !== null && !this.stopping;
+    }
+    /** The port the Python microservice is listening on, or null if not running */
+    get Port() {
+        return this.port;
+    }
+    /**
+     * Start the Python microservice. Resolves once the server is ready.
+     * If already running, this is a no-op.
+     */
+    async start() {
+        if (this.IsRunning) {
+            return;
+        }
+        this.stopping = false;
+        await new Promise((resolve, reject) => {
+            const proc = spawn(this.pythonPath, [this.serverPath, '0'], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                env: { ...process.env },
+            });
+            let stdoutBuffer = '';
+            let stderrBuffer = '';
+            let resolved = false;
+            const timeout = setTimeout(() => {
+                if (!resolved) {
+                    resolved = true;
+                    proc.kill('SIGKILL');
+                    reject(new Error(`sqlglot-ts server failed to start within ${this.startupTimeoutMs}ms. ` +
+                        `stderr: ${stderrBuffer.slice(0, 500)}`));
+                }
+            }, this.startupTimeoutMs);
+            proc.stdout.on('data', (chunk) => {
+                stdoutBuffer += chunk.toString();
+                const match = stdoutBuffer.match(/SQLGLOT_PORT=(\d+)/);
+                if (match && !resolved) {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    this.port = parseInt(match[1], 10);
+                    this.process = proc;
+                    this.registerCleanup();
+                    // Wait for the server to be ready before resolving
+                    this.waitForReady()
+                        .then(() => resolve())
+                        .catch((err) => reject(err));
+                }
+            });
+            proc.stderr.on('data', (chunk) => {
+                stderrBuffer += chunk.toString();
+            });
+            proc.on('error', (err) => {
+                if (!resolved) {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    reject(new Error(`Failed to spawn Python process: ${err.message}`));
+                }
+            });
+            proc.on('exit', (code) => {
+                if (!resolved) {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    reject(new Error(`Python process exited with code ${code} before becoming ready. ` +
+                        `stderr: ${stderrBuffer.slice(0, 500)}`));
+                }
+                // If we were running and the process dies unexpectedly, clean up
+                if (this.process === proc) {
+                    this.process = null;
+                    this.port = null;
+                }
+            });
+        });
+    }
+    /**
+     * Stop the Python microservice. Resolves once the process has exited.
+     * If not running, this is a no-op.
+     */
+    async stop() {
+        if (!this.process) {
+            return;
+        }
+        this.stopping = true;
+        const proc = this.process;
+        this.process = null;
+        this.port = null;
+        return new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                proc.kill('SIGKILL');
+                resolve();
+            }, 5000);
+            proc.on('exit', () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+            proc.kill('SIGTERM');
+        });
+    }
+    /**
+     * Transpile SQL from one dialect to another.
+     * All statements are transpiled together as a batch.
+     */
+    async transpile(sql, options) {
+        this.assertRunning();
+        return this.httpPost('/transpile', {
+            sql,
+            from_dialect: options.fromDialect,
+            to_dialect: options.toDialect,
+            pretty: options.pretty ?? true,
+            error_level: options.errorLevel ?? 'WARN',
+        });
+    }
+    /**
+     * Transpile SQL statement-by-statement.
+     * Each statement is transpiled individually, so one failure doesn't block others.
+     */
+    async transpileStatements(sql, options) {
+        this.assertRunning();
+        return this.httpPost('/transpile-statements', {
+            sql,
+            from_dialect: options.fromDialect,
+            to_dialect: options.toDialect,
+            pretty: options.pretty ?? true,
+            error_level: options.errorLevel ?? 'WARN',
+        });
+    }
+    /**
+     * Parse SQL and return the AST as JSON.
+     */
+    async parse(sql, options) {
+        this.assertRunning();
+        return this.httpPost('/parse', {
+            sql,
+            dialect: options.dialect,
+        });
+    }
+    /**
+     * List all supported SQL dialects.
+     */
+    async getDialects() {
+        this.assertRunning();
+        const result = await this.httpGet('/dialects');
+        return result.dialects;
+    }
+    /**
+     * Check server health and return status information.
+     */
+    async health() {
+        this.assertRunning();
+        const result = await this.httpGet('/health');
+        return {
+            status: result.status,
+            sqlglotVersion: result.sqlglot_version,
+            service: result.service,
+            port: this.port,
+        };
+    }
+    assertRunning() {
+        if (!this.IsRunning) {
+            throw new Error('SqlGlotClient is not running. Call start() first.');
+        }
+    }
+    /**
+     * Poll the health endpoint until the server is accepting requests.
+     * Uses short intervals with an overall timeout from startupTimeoutMs.
+     */
+    async waitForReady() {
+        const deadline = Date.now() + this.startupTimeoutMs;
+        const interval = 50;
+        while (Date.now() < deadline) {
+            try {
+                await this.httpGet('/health');
+                return; // Server is ready
+            }
+            catch {
+                await new Promise((r) => setTimeout(r, interval));
+            }
+        }
+        throw new Error(`sqlglot-ts server did not become ready within ${this.startupTimeoutMs}ms`);
+    }
+    registerCleanup() {
+        if (this.cleanupRegistered)
+            return;
+        this.cleanupRegistered = true;
+        const cleanup = () => {
+            if (this.process) {
+                this.process.kill('SIGTERM');
+                this.process = null;
+                this.port = null;
+            }
+        };
+        process.on('exit', cleanup);
+        process.on('SIGINT', () => {
+            cleanup();
+            process.exit(0);
+        });
+        process.on('SIGTERM', () => {
+            cleanup();
+            process.exit(0);
+        });
+    }
+    httpPost(path, body) {
+        return new Promise((resolve, reject) => {
+            const data = JSON.stringify(body);
+            const req = http.request({
+                hostname: '127.0.0.1',
+                port: this.port,
+                path,
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Content-Length': Buffer.byteLength(data),
+                },
+                timeout: this.requestTimeoutMs,
+            }, (res) => {
+                let responseBody = '';
+                res.on('data', (chunk) => {
+                    responseBody += chunk.toString();
+                });
+                res.on('end', () => {
+                    try {
+                        const parsed = JSON.parse(responseBody);
+                        resolve(parsed);
+                    }
+                    catch {
+                        reject(new Error(`Failed to parse response: ${responseBody.slice(0, 200)}`));
+                    }
+                });
+            });
+            req.on('error', (err) => {
+                reject(new Error(`HTTP request to sqlglot server failed: ${err.message}`));
+            });
+            req.on('timeout', () => {
+                req.destroy();
+                reject(new Error(`Request to ${path} timed out after ${this.requestTimeoutMs}ms`));
+            });
+            req.write(data);
+            req.end();
+        });
+    }
+    httpGet(path) {
+        return new Promise((resolve, reject) => {
+            const req = http.request({
+                hostname: '127.0.0.1',
+                port: this.port,
+                path,
+                method: 'GET',
+                timeout: this.requestTimeoutMs,
+            }, (res) => {
+                let responseBody = '';
+                res.on('data', (chunk) => {
+                    responseBody += chunk.toString();
+                });
+                res.on('end', () => {
+                    try {
+                        const parsed = JSON.parse(responseBody);
+                        resolve(parsed);
+                    }
+                    catch {
+                        reject(new Error(`Failed to parse response: ${responseBody.slice(0, 200)}`));
+                    }
+                });
+            });
+            req.on('error', (err) => {
+                reject(new Error(`HTTP request to sqlglot server failed: ${err.message}`));
+            });
+            req.on('timeout', () => {
+                req.destroy();
+                reject(new Error(`Request to ${path} timed out after ${this.requestTimeoutMs}ms`));
+            });
+            req.end();
+        });
+    }
+}
+//# sourceMappingURL=SqlGlotClient.js.map

package/dist/SqlGlotClient.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { SqlGlotClient } from './SqlGlotClient.js';
+export type { SQLDialect, ErrorLevel, TranspileOptions, TranspileResult, ParseOptions, ParseResult, SqlGlotClientOptions, HealthStatus, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { SqlGlotClient } from './SqlGlotClient.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+/** Supported SQL dialects (subset of sqlglot's 31 dialects) */
+export type SQLDialect = 'tsql' | 'postgres' | 'mysql' | 'sqlite' | 'bigquery' | 'snowflake' | 'redshift' | 'spark' | 'duckdb' | 'oracle' | 'hive' | 'trino' | 'clickhouse' | 'databricks' | string;
+export type ErrorLevel = 'IGNORE' | 'WARN' | 'RAISE' | 'IMMEDIATE';
+export interface TranspileOptions {
+    /** Source SQL dialect */
+    fromDialect: SQLDialect;
+    /** Target SQL dialect */
+    toDialect: SQLDialect;
+    /** Pretty-print output (default: true) */
+    pretty?: boolean;
+    /** Error handling level (default: 'WARN') */
+    errorLevel?: ErrorLevel;
+}
+export interface TranspileResult {
+    /** Whether transpilation succeeded without errors */
+    success: boolean;
+    /** Combined SQL output (all statements joined with ;\n) */
+    sql: string;
+    /** Individual transpiled statements */
+    statements: string[];
+    /** Error messages */
+    errors: string[];
+    /** Warning messages */
+    warnings: string[];
+}
+export interface ParseOptions {
+    /** SQL dialect to parse as */
+    dialect: SQLDialect;
+}
+export interface ParseResult {
+    /** Whether parsing succeeded */
+    success: boolean;
+    /** AST as JSON string */
+    ast: string;
+    /** Error messages */
+    errors: string[];
+}
+export interface SqlGlotClientOptions {
+    /** Path to Python executable (default: 'python3') */
+    pythonPath?: string;
+    /** Path to the server.py file (default: auto-detected from package) */
+    serverPath?: string;
+    /** Startup timeout in ms (default: 30000) */
+    startupTimeoutMs?: number;
+    /** Request timeout in ms (default: 60000) */
+    requestTimeoutMs?: number;
+}
+export interface HealthStatus {
+    status: string;
+    sqlglotVersion: string;
+    service: string;
+    port: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,UAAU,GACV,OAAO,GACP,QAAQ,GACR,UAAU,GACV,WAAW,GACX,UAAU,GACV,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,OAAO,GACP,YAAY,GACZ,YAAY,GACZ,MAAM,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,WAAW,EAAE,UAAU,CAAC;IACxB,yBAAyB;IACzB,SAAS,EAAE,UAAU,CAAC;IACtB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,qBAAqB;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,10 +1,37 @@
 {
   "name": "@memberjunction/sqlglot-ts",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/sqlglot-ts",
+  "version": "5.5.0",
+  "description": "TypeScript wrapper for Python's sqlglot SQL transpiler. Manages a local Python FastAPI microservice to provide deterministic SQL dialect conversion.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist",
+    "/src/python"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+    "sql",
+    "transpiler",
+    "sqlglot",
+    "tsql",
+    "postgresql",
+    "mysql",
+    "dialect",
+    "conversion"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  },
+  "license": "ISC",
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
 }

package/src/python/server.py

@@ -0,0 +1,188 @@
+"""
+sqlglot-ts Python microservice.
+Thin FastAPI wrapper around Python's sqlglot library (https://github.com/tobymao/sqlglot).
+Runs on 127.0.0.1 with an ephemeral port for security.
+"""
+from fastapi import FastAPI
+from pydantic import BaseModel
+import sqlglot
+import sqlglot.errors
+import uvicorn
+import sys
+import json
+
+app = FastAPI(title="sqlglot-ts", version="1.0.0")
+
+
+class TranspileRequest(BaseModel):
+    sql: str
+    from_dialect: str
+    to_dialect: str
+    pretty: bool = True
+    error_level: str = "WARN"  # IGNORE, WARN, RAISE, IMMEDIATE
+
+
+class TranspileResponse(BaseModel):
+    success: bool
+    sql: str = ""
+    statements: list[str] = []
+    errors: list[str] = []
+    warnings: list[str] = []
+
+
+class ParseRequest(BaseModel):
+    sql: str
+    dialect: str
+
+
+class ParseResponse(BaseModel):
+    success: bool
+    ast: str = ""
+    errors: list[str] = []
+
+
+class DialectsResponse(BaseModel):
+    dialects: list[str]
+
+
+@app.post("/transpile", response_model=TranspileResponse)
+def transpile(req: TranspileRequest):
+    """Transpile SQL from one dialect to another."""
+    try:
+        error_level = getattr(
+            sqlglot.errors.ErrorLevel,
+            req.error_level,
+            sqlglot.errors.ErrorLevel.WARN,
+        )
+        results = sqlglot.transpile(
+            req.sql,
+            read=req.from_dialect,
+            write=req.to_dialect,
+            pretty=req.pretty,
+            error_level=error_level,
+        )
+        return TranspileResponse(
+            success=True,
+            sql=";\n".join(results) + (";" if results else ""),
+            statements=results,
+            errors=[],
+            warnings=[],
+        )
+    except sqlglot.errors.SqlglotError as e:
+        return TranspileResponse(
+            success=False,
+            sql="",
+            statements=[],
+            errors=[str(e)],
+            warnings=[],
+        )
+    except Exception as e:
+        return TranspileResponse(
+            success=False,
+            sql="",
+            statements=[],
+            errors=[f"Unexpected error: {str(e)}"],
+            warnings=[],
+        )
+
+
+@app.post("/transpile-statements", response_model=TranspileResponse)
+def transpile_statements(req: TranspileRequest):
+    """
+    Transpile SQL statement-by-statement.
+    Returns individual results for each statement, useful for
+    identifying which specific statements fail conversion.
+    """
+    try:
+        error_level = getattr(
+            sqlglot.errors.ErrorLevel,
+            req.error_level,
+            sqlglot.errors.ErrorLevel.WARN,
+        )
+        # Parse into individual statements first
+        parsed = sqlglot.parse(
+            req.sql, read=req.from_dialect, error_level=error_level
+        )
+
+        results: list[str] = []
+        errors: list[str] = []
+        warnings: list[str] = []
+
+        for i, stmt in enumerate(parsed):
+            if stmt is None:
+                continue
+            try:
+                transpiled = stmt.sql(dialect=req.to_dialect, pretty=req.pretty)
+                results.append(transpiled)
+            except Exception as e:
+                original = stmt.sql(dialect=req.from_dialect)
+                errors.append(
+                    f"Statement {i+1} failed: {str(e)} | Original: {original[:200]}"
+                )
+                results.append(f"-- FAILED: {original}")
+
+        return TranspileResponse(
+            success=len(errors) == 0,
+            sql=";\n".join(results) + (";" if results else ""),
+            statements=results,
+            errors=errors,
+            warnings=warnings,
+        )
+    except Exception as e:
+        return TranspileResponse(
+            success=False,
+            sql="",
+            statements=[],
+            errors=[str(e)],
+            warnings=[],
+        )
+
+
+@app.post("/parse", response_model=ParseResponse)
+def parse(req: ParseRequest):
+    """Parse SQL and return the AST as JSON."""
+    try:
+        parsed = sqlglot.parse(req.sql, read=req.dialect)
+        ast_json = [stmt.dump() if stmt else None for stmt in parsed]
+        return ParseResponse(success=True, ast=json.dumps(ast_json, indent=2))
+    except Exception as e:
+        return ParseResponse(success=False, errors=[str(e)])
+
+
+@app.get("/dialects", response_model=DialectsResponse)
+def dialects():
+    """List all supported SQL dialects."""
+    actual = sorted(sqlglot.Dialect.classes.keys())
+    return DialectsResponse(dialects=actual)
+
+
+@app.get("/health")
+def health():
+    """Health check endpoint."""
+    return {
+        "status": "ok",
+        "sqlglot_version": sqlglot.__version__,
+        "service": "sqlglot-ts",
+    }
+
+
+if __name__ == "__main__":
+    import socket
+
+    requested_port = int(sys.argv[1]) if len(sys.argv) > 1 else 0
+
+    # Bind a socket to discover the ephemeral port, then close it and
+    # pass that port to uvicorn. There is a tiny race window but it is
+    # acceptable for a local-only dev tool.
+    if requested_port == 0:
+        sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        sock.bind(("127.0.0.1", 0))
+        actual_port = sock.getsockname()[1]
+        sock.close()
+    else:
+        actual_port = requested_port
+
+    # Print the port BEFORE uvicorn starts so the TS client can read it.
+    print(f"SQLGLOT_PORT={actual_port}", flush=True)
+
+    uvicorn.run(app, host="127.0.0.1", port=actual_port, log_level="warning")