@supacloud/lite 0.25.0 → 0.26.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.26.0](https://github.com/vibeunion/supacloud/compare/supacloud-lite-v0.25.1...supacloud-lite-v0.26.0) (2026-10-12)
+
+
+### Features
+
+* **lite:** bundle PostgreSQL extension parity set ([#1849](https://github.com/vibeunion/supacloud/issues/1849)) ([233fb1b](https://github.com/vibeunion/supacloud/commit/233fb1bb9d52673a7f38d77d47e8c1e6c0b7c5e4))
+
+## [0.25.1](https://github.com/vibeunion/supacloud/compare/supacloud-lite-v0.25.0...supacloud-lite-v0.25.1) (2026-10-11)
+
+
+### Miscellaneous Chores
+
+* upgrade dependencies and caddy ([#1821](https://github.com/vibeunion/supacloud/issues/1821)) ([91c9a4b](https://github.com/vibeunion/supacloud/commit/91c9a4bd0a14f757670822a1aa953643a00a83c9))
+
 ## [0.25.0](https://github.com/vibeunion/supacloud/compare/supacloud-lite-v0.24.0...supacloud-lite-v0.25.0) (2026-10-10)
 
 

package/README.md

@@ -334,7 +334,7 @@ S3 模式的快照只包含数据库中的 Storage 元数据和密钥，不复
 | Commands / Artifacts | 支持 | 与完整 SupaCloud 使用相同 SQL contract；PGlite/native 均通过 `@supacloud/js` 端到端测试 |
 | Logical Replication / PowerSync source | 有条件支持 | PGlite 不支持；native 仅在显式 `powersync` profile 下支持，默认关闭 |
 | PostgREST 完整线协议 | 部分支持 | 目标是常用 `supabase-js` 行为，不承诺所有 PostgREST 边角行为 |
-| PostgreSQL 扩展 | 部分支持 | 仅支持 PGlite 内置或 Lite 模拟的扩展能力 |
+| PostgreSQL 扩展 | 默认扩展集 + Native 可扩展 | PGlite 默认包含 `pgvector`、实验性 PostGIS、`pg_textsearch`、官方 `pgmq` 及 Lite 原有扩展；Native 模式支持挂载与 PostgreSQL 主版本、操作系统和 ABI 匹配的 operator-managed 扩展安装 |
 | Supabase Studio | 不支持 | V1 不提供管理 UI |
 | 多项目控制面 | 不支持 | V1 每个进程只运行一个项目，可通过多个进程部署多个项目 |
 
@@ -348,6 +348,37 @@ RLS 表的 Realtime DELETE 无法在行删除后安全重放 SELECT policy，因
 supacloud-lite doctor --json
 ```
 
+### PostgreSQL 扩展生态
+
+Lite 默认把一组常用扩展打进 PGlite：`uuid-ossp`、`pgcrypto`、`citext`、
+`pg_trgm`、`ltree`、`hstore`、`fuzzystrmatch`、`pgvector`、
+`pg_textsearch`、PostGIS 和官方 `pgmq`。其中 PostGIS 是上游实验性包，
+应按实际空间数据 workload 验证。需要 `pg_graphql`、`pg_cron` 或其他未
+打包的 native 扩展时，应使用 `--engine native`，并提供一套与 Lite 使用的
+PostgreSQL 主版本、操作系统、CPU 架构和 ABI 匹配的 PostgreSQL 安装：
+
+```bash
+supacloud-lite migrate \
+  --engine native \
+  --postgres-dir /opt/postgresql/17
+
+supacloud-lite doctor \
+  --engine native \
+  --postgres-dir /opt/postgresql/17 \
+  --json
+```
+
+`doctor --json` 的 `postgres_extensions.available` 来自 PostgreSQL 的
+`pg_available_extensions`，`installed` 来自当前数据库的 `pg_extension`；
+它只报告数据库实际可见的扩展，不会把“存在 control 文件”误报成已经可用。
+扩展迁移仍由项目自己的 `CREATE EXTENSION` migration 管理。
+
+“完整 PostgreSQL 扩展生态”因此表示：Lite 不再人为限制 native 扩展，
+而是使用 operator-managed PostgreSQL 的真实扩展目录；它不表示每个平台、
+每个 PostgreSQL 主版本和每个扩展都能被同一个 Release 二进制打包。需要
+扩展的动态库、control/SQL 文件和系统依赖由 PostgreSQL 安装提供，并且
+升级 PostgreSQL 主版本时必须重新验证扩展 ABI 和数据目录兼容性。
+
 默认 PGlite 输出会明确包含：
 
 ```json
@@ -419,8 +450,13 @@ const { data: messages } = await queues.rpc('read', {
 })
 ```
 
-Lite 的 `pgmq` 模拟层还提供 `set_vt`，支持直接 SQL 调整可见性超时。消息按 PGMQ 语义至少投递一次；`pop` 会立即删除消息，`archive` 是确认路径。`sleep_seconds` 和 visibility timeout 只控制消息何时可再次领取，不是消息 TTL；Lite/PGMQ 不提供逐消息到期删除语义。队列创建、指标、purge、设置和管理 API 不属于 Lite 的公开 RPC façade，仍需由项目 SQL 或完整 SupaCloud 控制面处理。
-队列名遵循标准版的 1-128 位小写字母、数字、下划线和短横线规则，并且必须以字母或数字开头；Lite 会安全映射超出 PostgreSQL 63-byte 标识符上限的名称，避免截断后串队。默认 Data API 暴露 `public` 和 `pgmq_public`；如果显式设置 `dbSchemas`，Lite 会严格使用该列表，需要队列 RPC 时应把 `pgmq_public` 明确加入。
+Lite 的 PGMQ 层还提供 `set_vt`，支持直接 SQL 调整可见性超时。消息按
+PGMQ 语义至少投递一次；`pop` 会立即删除消息，`archive` 是确认路径。
+`sleep_seconds` 和 visibility timeout 只控制消息何时可再次领取，不是消息 TTL。
+队列名遵循官方 PGMQ 的 1-47 位小写字母、数字、下划线和短横线规则，并且
+必须以字母或数字开头。默认 Data API 暴露 `public` 和 `pgmq_public`；如果
+显式设置 `dbSchemas`，Lite 会严格使用该列表，需要队列 RPC 时应把
+`pgmq_public` 明确加入。
 Durable workflow 的 run、step、event 和内部队列也保存在同一项目数据库中，可跨进程重启恢复；内部 workflow 队列不会通过 `pgmq_public` 暴露给 Data API 角色。Workflow 提供重试、取消和 dead-letter 失败原语，但不会自动执行 Saga 补偿；补偿步骤及其幂等性仍由应用工作流显式定义。
 
 Edge Function 内可使用 `globalThis.SupaCloud.pgredis`：
@@ -769,7 +805,7 @@ source package for a synthetic baseline, not a production performance claim.
 | Commands / Artifacts | Supported | Uses the same SQL contract as full SupaCloud; PGlite/native are both exercised end-to-end through `@supacloud/js` |
 | Logical Replication / PowerSync source | Conditional | PGlite is unsupported; native requires the explicit `powersync` profile and remains disabled by default |
 | Full PostgREST wire protocol | Partial | Targets common `supabase-js` behavior; does not promise all PostgREST edge-case behavior |
-| PostgreSQL extensions | Partial | Only supports extensions built into PGlite or emulated by Lite |
+| PostgreSQL extensions | Bundled parity set plus native-extensible | PGlite bundles the default Lite extension set, including `pgvector`, experimental PostGIS, `pg_textsearch`, and `pgmq`; native mode can use an operator-managed PostgreSQL installation whose extensions match the PostgreSQL major version, OS, CPU architecture, and ABI |
 | Supabase Studio | Not supported | V1 does not provide an admin UI |
 | Multi-project control plane | Not supported | V1 runs only one project per process; multiple projects can be deployed via multiple processes |
 
@@ -779,6 +815,44 @@ Realtime DELETE on RLS tables cannot safely replay SELECT policies after a row i
 
 `supacloud-lite doctor --json` reports a stable Lite capability contract without copying the full Management API. PGlite explicitly reports Logical Replication and PowerSync source support as `unsupported`; it never emulates WAL, publications, or slots. Multi-device offline deployments should use central SupaCloud + PowerSync, while a single field workstation can use Lite as a local project server or upload through an application-owned outbox.
 
+### PostgreSQL extension ecosystem
+
+Lite ships a PostgreSQL-shaped default extension set in PGlite. New databases
+install `uuid-ossp`, `pgcrypto`, `citext`, `pg_trgm`, `ltree`, `hstore`,
+`fuzzystrmatch`, `pgvector`, `pg_textsearch`, PostGIS, and the official PGMQ
+extension automatically when the corresponding bundled WASM package is
+available. PostGIS is experimental upstream and should be validated against
+the application's geometry workload.
+
+PGlite can load only WASM/bundled extensions. For `pg_graphql`, `pg_cron`, or
+other extensions that are not in this bundled set, use `--engine native` with
+a PostgreSQL installation whose major version, OS, CPU architecture, and ABI
+match the Lite process:
+
+```bash
+supacloud-lite migrate \
+  --engine native \
+  --postgres-dir /opt/postgresql/17
+
+supacloud-lite doctor \
+  --engine native \
+  --postgres-dir /opt/postgresql/17 \
+  --json
+```
+
+In `doctor --json`, `postgres_extensions.available` comes from
+`pg_available_extensions` and `installed` comes from `pg_extension`. The report
+describes what the live database can see; it does not mistake a control file
+for an extension that has been successfully loaded. Extension migrations remain
+application-owned `CREATE EXTENSION` migrations.
+
+“Full PostgreSQL extension ecosystem” therefore means that native Lite does not
+artificially restrict the extensions supplied by the operator-managed
+PostgreSQL installation. It does not mean that every platform, PostgreSQL major
+version, extension shared library, control/SQL file, and system dependency can
+be shipped inside the same Release binary. PostgreSQL major upgrades require
+separate extension ABI and data-directory validation.
+
 Native Lite keeps `wal_level=minimal`, WAL senders, and database TCP disabled by default. The explicit profile enables bounded Logical Replication:
 
 ```bash
@@ -804,7 +878,10 @@ Lite uses Bun's native bcrypt and is compatible with validating common GoTrue bc
 
 ### Queues and Edge Cache
 
-Lite provides a public RPC façade for Supabase Queues in the project database (PGlite or native PostgreSQL). Applications can directly use the official client's
+Lite uses the official `pgmq` extension on PGlite by default and retains a
+SQL fallback for native PostgreSQL installations where `pgmq` is unavailable.
+The Lite-owned `pgmq_public` façade adds the Supabase-compatible RPC surface
+and idempotent send support. Applications can directly use the official client's
 `supabase.schema('pgmq_public').rpc(...)` without an additional queue process:
 
 ```sql
@@ -826,8 +903,15 @@ const { data: messages } = await queues.rpc('read', {
 })
 ```
 
-Lite's `pgmq` emulation layer also provides `set_vt`, allowing direct SQL adjustment of visibility timeouts. Messages are delivered at least once according to PGMQ semantics; `pop` deletes the message immediately, and `archive` is the acknowledgment path. `sleep_seconds` and visibility timeouts only control when a message can be claimed again; they are not message TTLs, and Lite/PGMQ does not provide per-message expiry deletion semantics. Queue creation, metrics, purge, settings, and management APIs are not part of Lite's public RPC façade and must still be handled by project SQL or the full SupaCloud control plane.
-Queue names follow the standard 1-128 character lowercase letter, digit, underscore, and hyphen rule, and must start with a letter or digit; Lite safely maps names that exceed PostgreSQL's 63-byte identifier limit to avoid cross-queue collisions after truncation. The default Data API exposes `public` and `pgmq_public`; if `dbSchemas` is set explicitly, Lite uses that list strictly, and `pgmq_public` should be explicitly included when queue RPCs are needed.
+Lite's `pgmq` layer also provides `set_vt`, allowing direct SQL adjustment of
+visibility timeouts. Messages are delivered at least once according to PGMQ
+semantics; `pop` deletes the message immediately, and `archive` is the
+acknowledgment path. `sleep_seconds` and visibility timeouts only control when
+a message can be claimed again; they are not message TTLs. Queue names follow
+the official PGMQ 1-47 character lowercase letter, digit, underscore, and
+hyphen rule, and must start with a letter or digit. Queue creation, metrics,
+purge, settings, and management APIs remain available through direct SQL but
+are not part of Lite's public RPC façade.
 Durable workflow runs, steps, events, and the internal queue are stored in the same project database and survive process restarts. Data API roles cannot access the internal workflow queue through `pgmq_public`. Workflow retry, cancellation, and dead-letter operations are failure primitives, not automatic Saga compensation; applications must define compensation steps and their idempotency explicitly.
 
 Within an Edge Function, you can use `globalThis.SupaCloud.pgredis`:

package/THIRD_PARTY_NOTICES.md

@@ -18,6 +18,16 @@ SupaCloud Lite 使用 ElectricSQL PGlite 作为嵌入式 PostgreSQL 引擎。
 - Upstream: `https://github.com/electric-sql/pglite`
 - Local license copy: `LICENSES/PGLITE-APACHE-2.0.txt`
 
+Lite also bundles the official PGlite extension packages:
+
+- `@electric-sql/pglite-pgvector` 0.0.9
+- `@electric-sql/pglite-postgis` 0.2.8
+- `@electric-sql/pglite-pg_textsearch` 0.0.10
+- `@electric-sql/pglite-pgmq` 0.0.6
+
+These packages are published by ElectricSQL under Apache-2.0 and their
+extension archives are embedded in the standalone binary.
+
 ## Native PostgreSQL binaries
 
 Linux/macOS 上的可选 native 引擎会按需下载 Theseus 发布的 PostgreSQL 17.7.0 预编译包；该二进制不会内嵌到 npm 包或 Lite 单文件发布物中。

package/dist/cli.js

@@ -8,7 +8,7 @@ import { dirname as dirname8, join as join10, resolve as resolve6 } from "path";
 // package.json
 var package_default = {
   name: "@supacloud/lite",
-  version: "0.25.0",
+  version: "0.26.0",
   description: "Bun-native, single-project Supabase-compatible backend powered by PGlite or native PostgreSQL",
   type: "module",
   license: "Apache-2.0",
@@ -35,7 +35,7 @@ var package_default = {
   ],
   scripts: {
     build: "bun run build:js && bun run build:types",
-    "build:js": "bun run clean && bun build src/index.ts --target=bun --format=esm --outdir=dist --external @electric-sql/pglite --external tar && bun build src/cli.ts --target=bun --format=esm --outdir=dist --external @electric-sql/pglite --external tar && bun run scripts/build-launcher.ts",
+    "build:js": "bun run clean && bun build src/index.ts --target=bun --format=esm --outdir=dist --external @electric-sql/pglite --external @electric-sql/pglite-pgvector --external @electric-sql/pglite-postgis --external @electric-sql/pglite-pg_textsearch --external @electric-sql/pglite-pgmq --external tar && bun build src/cli.ts --target=bun --format=esm --outdir=dist --external @electric-sql/pglite --external @electric-sql/pglite-pgvector --external @electric-sql/pglite-postgis --external @electric-sql/pglite-pg_textsearch --external @electric-sql/pglite-pgmq --external tar && bun run scripts/build-launcher.ts",
     "build:standalone:host": "bun run scripts/build-standalone.ts host",
     "build:standalone:linux-x64": "bun run scripts/build-standalone.ts linux-x64",
     "build:standalone:linux": "bun run scripts/build-standalone.ts linux-x64 linux-arm64",
@@ -63,10 +63,14 @@ var package_default = {
   },
   dependencies: {
     "@electric-sql/pglite": "0.5.8",
+    "@electric-sql/pglite-pg_textsearch": "0.0.10",
+    "@electric-sql/pglite-pgmq": "0.0.6",
+    "@electric-sql/pglite-pgvector": "0.0.9",
+    "@electric-sql/pglite-postgis": "0.2.8",
     "@supacloud/db": "^0.6.0",
     "exact-mirror": "1.2.6",
     tar: "^7.5.22",
-    typebox: "1.3.34"
+    typebox: "1.3.36"
   },
   devDependencies: {
     "@supacloud/app": "file:../app",
@@ -76,7 +80,7 @@ var package_default = {
     "@types/bun": "^1.4.2",
     effect: "4.0.2",
     elysia: "2.0.0-beta.21",
-    jose: "^6.2.11",
+    jose: "^6.2.12",
     typescript: "^7.0.2"
   },
   overrides: {
@@ -3252,7 +3256,10 @@ create schema if not exists extensions;
 do $$
 declare ext text;
 begin
-  foreach ext in array array['uuid-ossp','pgcrypto','citext','pg_trgm','ltree','hstore','fuzzystrmatch'] loop
+  foreach ext in array array[
+    'uuid-ossp','pgcrypto','citext','pg_trgm','ltree','hstore','fuzzystrmatch',
+    'vector','postgis','pg_textsearch'
+  ] loop
     begin
       execute format('create extension if not exists %I with schema extensions', ext);
     exception when others then
@@ -3261,6 +3268,19 @@ begin
   end loop;
 end $$;
 
+-- The official pgmq extension owns its required pgmq schema. PGlite and
+-- native PostgreSQL builds that do not provide it simply continue to Lite's
+-- SQL fallback during database initialization.
+create schema if not exists pgmq;
+do $$
+begin
+  begin
+    create extension if not exists pgmq with schema pgmq;
+  exception when others then
+    null;
+  end;
+end $$;
+
 -- uuid-ossp isn't in every Postgres build (it needs an external UUID lib at
 -- build time - e.g. the theseus Linux binaries omit it). uuid_generate_v4() is
 -- the single most-used function from it, so shim it onto core gen_random_uuid()
@@ -3763,7 +3783,7 @@ grant execute on function realtime.send(jsonb, text, text, boolean) to anon, aut
 `;
 
 // src/runtime/db/emulated.ts
-var PGMQ_SQL = `
+var PGMQ_CORE_SQL = `
 create schema if not exists pgmq;
 revoke all on schema pgmq from public, anon, authenticated;
 grant usage on schema pgmq to service_role;
@@ -3948,6 +3968,8 @@ $pgmq$;
 revoke all on all functions in schema pgmq from public, anon, authenticated;
 grant execute on all functions in schema pgmq to service_role;
 
+`;
+var PGMQ_PUBLIC_SQL = `
 -- supacloud:sql-module:pgmq-public:start
 DO $pgmq_extension$
 BEGIN
@@ -4254,6 +4276,8 @@ GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA pgmq_public TO anon, authenticated, ser
 NOTIFY pgrst, 'reload schema';
 -- supacloud:sql-module:pgmq-public:end
 `;
+var PGMQ_SQL = `${PGMQ_CORE_SQL}
+${PGMQ_PUBLIC_SQL}`;
 var WORKFLOWS_SQL = `
 -- supacloud:sql-module:workflows-public:start
 DO $pgmq_extension$
@@ -6342,16 +6366,44 @@ async function createPgliteEngine(dataDir, options = {}) {
   let cleanupStandaloneBundles = async () => {};
   try {
     ({ PGlite } = await import("@electric-sql/pglite"));
-    const [uuid_ossp, pgcrypto, citext, pg_trgm, ltree, hstore, fuzzystrmatch] = await Promise.all([
+    const [
+      uuid_ossp,
+      pgcrypto,
+      citext,
+      pg_trgm,
+      ltree,
+      hstore,
+      fuzzystrmatch,
+      vector,
+      postgis,
+      pg_textsearch,
+      pgmq
+    ] = await Promise.all([
       import("@electric-sql/pglite/contrib/uuid_ossp").then((m) => m.uuid_ossp),
       import("@electric-sql/pglite/contrib/pgcrypto").then((m) => m.pgcrypto),
       import("@electric-sql/pglite/contrib/citext").then((m) => m.citext),
       import("@electric-sql/pglite/contrib/pg_trgm").then((m) => m.pg_trgm),
       import("@electric-sql/pglite/contrib/ltree").then((m) => m.ltree),
       import("@electric-sql/pglite/contrib/hstore").then((m) => m.hstore),
-      import("@electric-sql/pglite/contrib/fuzzystrmatch").then((m) => m.fuzzystrmatch)
+      import("@electric-sql/pglite/contrib/fuzzystrmatch").then((m) => m.fuzzystrmatch),
+      import("@electric-sql/pglite-pgvector").then((m) => m.vector),
+      import("@electric-sql/pglite-postgis").then((m) => m.postgis),
+      import("@electric-sql/pglite-pg_textsearch").then((m) => m.pg_textsearch),
+      import("@electric-sql/pglite-pgmq").then((m) => m.pgmq)
     ]);
-    extensions = { uuid_ossp, pgcrypto, citext, pg_trgm, ltree, hstore, fuzzystrmatch };
+    extensions = {
+      uuid_ossp,
+      pgcrypto,
+      citext,
+      pg_trgm,
+      ltree,
+      hstore,
+      fuzzystrmatch,
+      vector,
+      postgis,
+      pg_textsearch,
+      pgmq
+    };
   } catch (error) {
     await releaseLock();
     if (error instanceof Error && /wasm/.test(error.message))
@@ -6369,7 +6421,11 @@ async function createPgliteEngine(dataDir, options = {}) {
         pg_trgm: withEmbeddedBundle(extensions.pg_trgm, standaloneBundles.bundles.pg_trgm),
         ltree: withEmbeddedBundle(extensions.ltree, standaloneBundles.bundles.ltree),
         hstore: withEmbeddedBundle(extensions.hstore, standaloneBundles.bundles.hstore),
-        fuzzystrmatch: withEmbeddedBundle(extensions.fuzzystrmatch, standaloneBundles.bundles.fuzzystrmatch)
+        fuzzystrmatch: withEmbeddedBundle(extensions.fuzzystrmatch, standaloneBundles.bundles.fuzzystrmatch),
+        vector: withEmbeddedBundle(extensions.vector, standaloneBundles.bundles.vector),
+        postgis: withEmbeddedBundle(extensions.postgis, standaloneBundles.bundles.postgis),
+        pg_textsearch: withEmbeddedBundle(extensions.pg_textsearch, standaloneBundles.bundles.pg_textsearch),
+        pgmq: withEmbeddedBundle(extensions.pgmq, standaloneBundles.bundles.pgmq)
       };
     } catch (error) {
       await removePreparedBundles(cleanupStandaloneBundles);
@@ -6515,7 +6571,8 @@ class Database {
         await engine.exec(MINIMAL_BOOTSTRAP_SQL);
       } else {
         await engine.exec(BOOTSTRAP_SQL);
-        await engine.exec(PGMQ_SQL);
+        const pgmqExtension = await engine.query(`select extname from pg_extension where extname = 'pgmq' limit 1`);
+        await engine.exec(pgmqExtension.rows.length > 0 ? PGMQ_PUBLIC_SQL : PGMQ_SQL);
         await engine.exec(WORKFLOWS_SQL);
         await engine.exec(CRON_SQL);
         await engine.exec(NET_SQL);
@@ -13633,14 +13690,55 @@ function formatDatabaseModuleCheck(result) {
 `;
 }
 
+// src/runtime/node/native/extensions.ts
+async function inspectPostgresExtensions(engine, source) {
+  try {
+    const [available, installed] = await Promise.all([
+      engine.query(`
+        SELECT name, default_version, installed_version, comment
+        FROM pg_available_extensions
+        ORDER BY name
+      `),
+      engine.query(`
+        SELECT extname AS name, extversion AS version
+        FROM pg_extension
+        ORDER BY extname
+      `)
+    ]);
+    return {
+      source,
+      status: "inspected",
+      available: available.rows,
+      installed: installed.rows
+    };
+  } catch (error) {
+    return {
+      source,
+      status: "unavailable",
+      available: [],
+      installed: [],
+      reason: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+
 // src/runtime/node/native/readiness.ts
 function liteCapabilities(engine, replicationProfile) {
+  const extensionSource = engine === "native" ? "native-postgresql" : "pglite-bundled";
   const common = {
     graphql: { status: "unverified", extension: "pg_graphql", reason: "DATABASE_NOT_INSPECTED" },
     runtime_mode: "development",
     identity: { mode: "local", verification: "built-in" },
     migrations: { formats: ["flat-sql", "timestamp-folder"], content_check: "supported", target_bindings: "supported" },
-    project_release_manifests: "unsupported"
+    project_release_manifests: "unsupported",
+    postgres_extensions: {
+      engine,
+      source: extensionSource,
+      status: "unavailable",
+      available: [],
+      installed: [],
+      reason: "DATABASE_NOT_INSPECTED"
+    }
   };
   if (engine === "pglite") {
     return {
@@ -15897,6 +15995,10 @@ ${privilegedKey}
       const engine = paths.databaseEngine === "native" ? await createNativeEngine({ dataDir: paths.dataDir, installDir: options.postgresDir, log: quietLog, replication }) : await createPgliteEngine(paths.dataDir);
       try {
         report.graphql = await inspectGraphql(engine);
+        report.postgres_extensions = {
+          engine: paths.databaseEngine,
+          ...await inspectPostgresExtensions(engine, paths.databaseEngine === "native" ? "native-postgresql" : "pglite-bundled")
+        };
         if (replication)
           report.powersync_readiness = await inspectPowerSyncReadiness(engine, replication);
       } finally {
@@ -16185,6 +16287,7 @@ async function printInspection(rows) {
 async function printDoctor(report) {
   const output = Object.entries(report).filter(([, value]) => typeof value !== "object").map(([name, value]) => `${name}: ${value}`);
   output.push(`graphql: ${report.graphql.status} (${report.graphql.version ?? report.graphql.reason ?? "pg_graphql"})`);
+  output.push(`postgres_extensions: ${report.postgres_extensions.status} ` + `(${report.postgres_extensions.source}, ${report.postgres_extensions.available.length} available, ` + `${report.postgres_extensions.installed.length} installed)`);
   output.push(`identity: ${report.identity.mode} (${report.identity.verification})`);
   output.push(`migration_formats: ${report.migrations.formats.join(", ")}`);
   if (report.powersync_readiness) {

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export type { RunningServer, ServerHandle, ServeOptions } from './runtime/node/b
 export { createNativeEngine, ensurePostgres, isNativeEngineSupported, type NativeEngineOptions, } from './runtime/node/native/engine.js';
 export { POWERSYNC_PUBLICATION, POWERSYNC_REPLICATION_ROLE, buildPowerSyncPostgresArgs, ensurePowerSyncReplicationCatalog, validatePowerSyncReplicationOptions, writePowerSyncHba, type NativeReplicationOptions, type NativeReplicationTlsOptions, type PowerSyncReplicationOptions, } from './runtime/node/native/replication.js';
 export { inspectPowerSyncReadiness, liteCapabilities, type LiteCapabilityStatus, type LiteDoctorReport, type PowerSyncReadiness, } from './runtime/node/native/readiness.js';
+export { inspectPostgresExtensions, type ExtensionInventorySource, type ExtensionInventoryStatus, type PostgresExtension, type PostgresExtensionInventory, } from './runtime/node/native/extensions.js';
 export { createProjectBackend, ensureProjectSecrets, mintProjectKeys, resolveDatabaseEngine, resolveNativeReplicationOptions, resolveStorageBackend, resolveProjectPaths, startProjectServer, } from './project-runtime.js';
 export { createSnapshot, restoreSnapshot, type CreateSnapshotOptions, type RestoreSnapshotOptions, type RestoreSnapshotResult, type SnapshotManifest, } from './snapshot.js';
 export type { ConfiguredStorageBackend, DatabaseEngine, ProjectBackend, ProjectPaths, ProjectRuntimeOptions, ProjectSecrets, ReplicationProfile, RunningProjectServer, StorageBackend, } from './project-runtime.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,IAAI,iBAAiB,EAClC,kBAAkB,EAClB,SAAS,EACT,aAAa,EACb,SAAS,EACT,OAAO,EACP,SAAS,GACV,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,aAAa,IAAI,mBAAmB,EACpC,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,UAAU,EACV,MAAM,EACN,WAAW,EACX,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EACL,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,gCAAgC,CAAA;AACvC,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AACnF,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACzE,OAAO,EAAE,yBAAyB,EAAE,KAAK,wBAAwB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC7H,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAClG,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AACvD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC7F,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,KAAK,mBAAmB,GACzB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,0BAA0B,EAC1B,iCAAiC,EACjC,mCAAmC,EACnC,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,GACjC,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,cAAc,EACd,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GACf,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,IAAI,iBAAiB,EAClC,kBAAkB,EAClB,SAAS,EACT,aAAa,EACb,SAAS,EACT,OAAO,EACP,SAAS,GACV,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,aAAa,IAAI,mBAAmB,EACpC,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,UAAU,EACV,MAAM,EACN,WAAW,EACX,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EACL,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,gCAAgC,CAAA;AACvC,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AACnF,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACzE,OAAO,EAAE,yBAAyB,EAAE,KAAK,wBAAwB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC7H,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAClG,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AACvD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC7F,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,KAAK,mBAAmB,GACzB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,0BAA0B,EAC1B,iCAAiC,EACjC,mCAAmC,EACnC,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,GACjC,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EACL,yBAAyB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,GAChC,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,cAAc,EACd,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,GACf,MAAM,sBAAsB,CAAA"}