litepg 0.1.0

package/README.md

@@ -0,0 +1,25 @@
+# litepg
+
+A PostgreSQL-compatible database in one binary, backed by an embedded
+SQLite-format engine. Speaks the PostgreSQL wire protocol, so `psql`,
+`node-postgres`, `asyncpg`, Prisma, Drizzle and friends connect as they
+would to PostgreSQL. With `--supabase` it also serves PostgREST-compatible
+REST and GoTrue-compatible Auth APIs over the same database, so a
+supabase-js client can point at it.
+
+```sh
+pnpm dlx litepg mydb.db --server          # PostgreSQL on 127.0.0.1, first free port from 5432 up
+pnpm dlx litepg mydb.db --supabase        # the same, plus REST and Auth on the first free port from 54321 up
+pnpm dlx litepg mydb.db                   # an interactive SQL shell
+pnpm dlx litepg :memory: "SELECT 1 + 1"   # one statement, in memory
+```
+
+`--server=0.0.0.0:5432` (or `--server=5433`, a port on the loopback) binds
+exactly that address. `--supabase` prints the JWT secret and the `anon` and
+`service_role` keys for the run; pass `--jwt-secret` or set
+`AUTH_JWT_SECRET` to keep them stable across runs.
+
+This package is a shim that runs the prebuilt binary for your platform
+(Apple Silicon macOS, and Linux on x64 and arm64; there is no Intel macOS
+build). Source, compatibility notes and issues:
+<https://github.com/olirice/litepg>.

package/bin/litepg.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+// The `litepg` npm shim: find the platform package that carries the binary
+// for this machine and exec it with the user's arguments. See npm/README.md
+// for the package layout and why there is no postinstall step.
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+
+const PLATFORMS = {
+  "darwin-arm64": "litepg-darwin-arm64",
+  "linux-arm64": "litepg-linux-arm64",
+  "linux-x64": "litepg-linux-x64",
+};
+
+const key = `${process.platform}-${process.arch}`;
+const pkg = PLATFORMS[key];
+if (!pkg) {
+  console.error(
+    `litepg: no prebuilt binary for ${key}. Prebuilt platforms: ${Object.keys(PLATFORMS).join(", ")}.\n` +
+      "Build from source instead: https://github.com/olirice/litepg (cargo build --release -p litepg).",
+  );
+  process.exit(1);
+}
+
+let binary;
+try {
+  // Resolving the platform package's package.json (a JS-resolvable file)
+  // and stepping to bin/ beside it works whether npm hoisted the package
+  // or pnpm kept it in its own store directory.
+  binary = path.join(path.dirname(require.resolve(`${pkg}/package.json`)), "bin", "litepg");
+} catch {
+  console.error(
+    `litepg: the platform package ${pkg} is not installed. It is an optional dependency of litepg; ` +
+      "reinstall without --no-optional, or check that your package manager allows optional dependencies.",
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+if (result.error) {
+  console.error(`litepg: could not start ${binary}: ${result.error.message}`);
+  process.exit(1);
+}
+if (result.signal) {
+  // Mirror the signal the binary died from, the way a shell would report it.
+  process.kill(process.pid, result.signal);
+}
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "litepg",
+  "version": "0.1.0",
+  "description": "PostgreSQL-compatible embedded database with optional Supabase REST and Auth APIs, as a single binary",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/olirice/litepg.git"
+  },
+  "homepage": "https://github.com/olirice/litepg",
+  "keywords": [
+    "postgres",
+    "postgresql",
+    "sqlite",
+    "embedded",
+    "database",
+    "supabase",
+    "postgrest"
+  ],
+  "bin": {
+    "litepg": "bin/litepg.js"
+  },
+  "files": [
+    "bin/litepg.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "litepg-darwin-arm64": "0.1.0",
+    "litepg-linux-arm64": "0.1.0",
+    "litepg-linux-x64": "0.1.0"
+  }
+}