lambda-pool 0.1.0

package/dist/presentation/bin.d.ts.map

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

package/dist/presentation/bin.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+// Executable shim: wires real process I/O into the testable runCli().
+import { runCli } from "./cli.js";
+const code = await runCli({
+    argv: process.argv.slice(2),
+    env: process.env,
+    out: (s) => console.log(s),
+    err: (s) => console.error(s),
+});
+process.exit(code);
+//# sourceMappingURL=bin.js.map

package/dist/presentation/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/presentation/bin.ts"],"names":[],"mappings":";AACA,sEAAsE;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3B,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;CAC7B,CAAC,CAAC;AACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/presentation/cli.d.ts

@@ -0,0 +1,10 @@
+interface CliIo {
+    argv: string[];
+    env: NodeJS.ProcessEnv;
+    out: (s: string) => void;
+    err: (s: string) => void;
+}
+/** Run the CLI and return a process exit code. Pure-ish: I/O is injected. */
+export declare function runCli(io: CliIo): Promise<number>;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/presentation/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/presentation/cli.ts"],"names":[],"mappings":"AA+BA,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1B;AAED,6EAA6E;AAC7E,wBAAsB,MAAM,CAAC,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAiGvD"}

package/dist/presentation/cli.js

@@ -0,0 +1,124 @@
+// CLI entry — `npx lambda-pool <command>`.
+//
+// Thin presentation layer over the pure core; it parses argv, reads env, calls
+// the library, prints text, and sets an exit code. No business logic lives here.
+import { recommendPoolLimit } from "../core/budget.js";
+import { formatReport } from "../application/diagnostics.js";
+import { inspectEnv } from "../application/inspect.js";
+import { preflight } from "../application/preflight.js";
+import { recommendForUrl } from "../application/recommend.js";
+import { listProviders } from "../core/providers.js";
+const HELP = `lambda-pool — serverless-safe DB pool helper
+
+Usage:
+  lambda-pool inspect          Lint the connection in your env for serverless safety
+  lambda-pool doctor           Full preflight check of the connection in your env
+  lambda-pool recommend <url> [instances]
+                               Recommend a pool size for a connection URL
+  lambda-pool budget <max> <instances> [reserved] [other]
+                               Recommend a per-instance pool size
+  lambda-pool providers        List recognized managed providers
+  lambda-pool help             Show this help
+
+Env (for "inspect"):
+  DATABASE_URL | MYSQL_URL | POSTGRES_URL | PG_URL   connection string (required)
+  DATABASE_POOL_LIMIT                                intended pool size (default 1)
+  DATABASE_SSL_CA_BASE64                             base64 CA cert
+  EXPECTED_INSTANCES                                 peak warm instances (default 20)
+`;
+/** Run the CLI and return a process exit code. Pure-ish: I/O is injected. */
+export async function runCli(io) {
+    const [cmd, ...rest] = io.argv;
+    switch (cmd) {
+        case undefined:
+        case "help":
+        case "-h":
+        case "--help":
+            io.out(HELP);
+            return 0;
+        case "inspect": {
+            try {
+                const report = inspectEnv(io.env);
+                io.out(formatReport(report));
+                // Non-zero on any warning/error so `inspect` is usable as a CI gate.
+                const clean = report.diagnostics.every((d) => d.severity === "info");
+                return clean ? 0 : 1;
+            }
+            catch (e) {
+                io.err(e.message);
+                return 2;
+            }
+        }
+        case "doctor": {
+            try {
+                const result = await preflight(io.env);
+                io.out(formatReport(result.report));
+                // doctor is a strict gate: any non-info diagnostic is a failure.
+                const clean = result.diagnostics.every((d) => d.severity === "info");
+                io.out(clean ? "\n✓ preflight passed" : "\n✖ preflight found issues");
+                return clean ? 0 : 1;
+            }
+            catch (e) {
+                io.err(e.message);
+                return 2;
+            }
+        }
+        case "budget": {
+            const [max, instances, reserved, other] = rest.map(Number);
+            if (!Number.isFinite(max) || !Number.isFinite(instances)) {
+                io.err("usage: lambda-pool budget <maxConnections> <instances> [reserved] [other]");
+                return 2;
+            }
+            try {
+                const r = recommendPoolLimit({
+                    maxConnections: max,
+                    expectedInstances: instances,
+                    ...(Number.isFinite(reserved) ? { reserved: reserved } : {}),
+                    ...(Number.isFinite(other) ? { otherClients: other } : {}),
+                });
+                io.out(`recommended pool limit: ${r.recommendedPoolLimit}`);
+                io.out(r.rationale);
+                return r.exceedsBudget ? 1 : 0;
+            }
+            catch (e) {
+                io.err(e.message);
+                return 2;
+            }
+        }
+        case "recommend": {
+            const [url, instances] = rest;
+            if (!url) {
+                io.err("usage: lambda-pool recommend <url> [instances]");
+                return 2;
+            }
+            try {
+                const r = recommendForUrl({
+                    url,
+                    ...(instances && Number.isFinite(Number(instances))
+                        ? { expectedInstances: Number(instances) }
+                        : {}),
+                });
+                io.out(`provider: ${r.provider}`);
+                io.out(`recommended pool limit: ${r.recommendedPoolLimit}`);
+                io.out(r.rationale);
+                if (r.poolerAdvised)
+                    io.out("→ a connection pooler is advised.");
+                return r.exceedsBudget ? 1 : 0;
+            }
+            catch (e) {
+                io.err(e.message);
+                return 2;
+            }
+        }
+        case "providers": {
+            for (const p of listProviders()) {
+                io.out(`${p.id.padEnd(16)} max~${p.typicalMaxConnections}  pooler:${p.hasPooledEndpoint ? "yes" : "no"}  ${p.label}`);
+            }
+            return 0;
+        }
+        default:
+            io.err(`unknown command: ${cmd}\n\n${HELP}`);
+            return 2;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/presentation/cli.js.map

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

package/package.json

@@ -0,0 +1,133 @@
+{
+  "name": "lambda-pool",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Serverless-safe connection-pool options for MySQL (mysql2) and Postgres (pg) on Vercel/Lambda with small max_connections (Aiven, Neon, RDS micro). Zero runtime dependencies.",
+  "author": "owlCoder",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/owlCoder/lambda-pool.git"
+  },
+  "homepage": "https://github.com/owlCoder/lambda-pool#readme",
+  "bugs": {
+    "url": "https://github.com/owlCoder/lambda-pool/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "lambda-pool": "dist/presentation/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./mysql": {
+      "types": "./dist/adapters/mysql.d.ts",
+      "import": "./dist/adapters/mysql.js"
+    },
+    "./pg": {
+      "types": "./dist/adapters/pg.d.ts",
+      "import": "./dist/adapters/pg.js"
+    },
+    "./health": {
+      "types": "./dist/adapters/health.d.ts",
+      "import": "./dist/adapters/health.js"
+    },
+    "./diagnostics": {
+      "types": "./dist/application/diagnostics.d.ts",
+      "import": "./dist/application/diagnostics.js"
+    },
+    "./inspect": {
+      "types": "./dist/application/inspect.d.ts",
+      "import": "./dist/application/inspect.js"
+    },
+    "./recommend": {
+      "types": "./dist/application/recommend.d.ts",
+      "import": "./dist/application/recommend.js"
+    },
+    "./preflight": {
+      "types": "./dist/application/preflight.d.ts",
+      "import": "./dist/application/preflight.js"
+    },
+    "./config": {
+      "types": "./dist/core/config.d.ts",
+      "import": "./dist/core/config.js"
+    },
+    "./redact": {
+      "types": "./dist/core/redact.d.ts",
+      "import": "./dist/core/redact.js"
+    },
+    "./dsn": {
+      "types": "./dist/core/dsn.d.ts",
+      "import": "./dist/core/dsn.js"
+    },
+    "./providers": {
+      "types": "./dist/core/providers.d.ts",
+      "import": "./dist/core/providers.js"
+    },
+    "./budget": {
+      "types": "./dist/core/budget.d.ts",
+      "import": "./dist/core/budget.js"
+    },
+    "./url": {
+      "types": "./dist/core/url.d.ts",
+      "import": "./dist/core/url.js"
+    },
+    "./retry": {
+      "types": "./dist/core/retry.d.ts",
+      "import": "./dist/core/retry.js"
+    },
+    "./result": {
+      "types": "./dist/core/result.d.ts",
+      "import": "./dist/core/result.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node scripts/clean.mjs && tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "test": "node --test --experimental-strip-types test/*.test.ts",
+    "test:integration": "node --test --experimental-strip-types test/integration/*.test.ts",
+    "check": "npm run lint && npm run typecheck && npm test",
+    "prepublishOnly": "npm run check",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^22.0.0",
+    "@types/pg": "^8.11.0",
+    "eslint": "^9.0.0",
+    "mysql2": "^3.11.0",
+    "pg": "^8.13.0",
+    "typescript": "5.9.3",
+    "typescript-eslint": "^8.0.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "serverless",
+    "vercel",
+    "lambda",
+    "mysql",
+    "mysql2",
+    "postgres",
+    "pg",
+    "connection-pool",
+    "aiven",
+    "neon",
+    "max_connections"
+  ]
+}