@storyshelf/db-postgres 0.0.0-stage → 0.5.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Siddhant Gupta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+# @storyshelf/db-postgres
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Postgres database adapter for StoryShelf (postgres.js + Drizzle). Connects to AWS RDS, GCP Cloud SQL, Supabase, Neon, Azure Database, or self-hosted Postgres. See [Deployment](../../apps/website/src/content/docs/guides/deployment.md) for provider recipes.
+
+## Install
+
+```sh
+nub add @storyshelf/db-postgres
+```
+
+## Quick start (self-hosted)
+
+```ts
+import { createPostgresDatabase } from "@storyshelf/db-postgres";
+
+const db = createPostgresDatabase({ url: "postgres://user:pass@localhost:5432/shelf" });
+```
+
+For managed providers, pass `ssl`, `prepare`, and pool options via `options` or inject a preconfigured `client` (see `PostgresDatabaseOptions`).

package/dist/ddl.d.mts

@@ -0,0 +1,8 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/ddl.d.ts
+/** Canonical Postgres DDL for all StoryShelf tables and indexes. */
+declare const DDL = "\nCREATE TABLE IF NOT EXISTS projects (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  slug TEXT NOT NULL UNIQUE,\n  git_repository TEXT,\n  git_default_branch TEXT NOT NULL DEFAULT 'main',\n  pixel_threshold DOUBLE PRECISION NOT NULL DEFAULT 0.1,\n  max_diff_ratio DOUBLE PRECISION NOT NULL DEFAULT 0.01,\n  public_branch_regex TEXT,\n  storybook_meta TEXT,\n  execute_play BOOLEAN NOT NULL DEFAULT false,\n  play_timeout_ms INTEGER NOT NULL DEFAULT 10000,\n  run_a11y BOOLEAN NOT NULL DEFAULT false,\n  browser TEXT NOT NULL DEFAULT 'chromium',\n  viewports TEXT,\n  automigrate BOOLEAN NOT NULL DEFAULT false,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS project_status_configs (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  provider TEXT NOT NULL,\n  config TEXT NOT NULL,\n  token_encrypted TEXT NOT NULL,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS builds (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  git_sha TEXT NOT NULL,\n  git_branch TEXT NOT NULL,\n  is_default BOOLEAN NOT NULL DEFAULT false,\n  author_email TEXT,\n  author_name TEXT,\n  message TEXT,\n  public BOOLEAN NOT NULL DEFAULT false,\n  status TEXT NOT NULL DEFAULT 'pending',\n  snapshot_count INTEGER NOT NULL DEFAULT 0,\n  changed_count INTEGER NOT NULL DEFAULT 0,\n  approved_count INTEGER NOT NULL DEFAULT 0,\n  rejected_count INTEGER NOT NULL DEFAULT 0,\n  affected_only BOOLEAN NOT NULL DEFAULT true,\n  baseline_sha TEXT,\n  changed_files TEXT,\n  affected_import_paths TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS builds_project_gitsha_idx ON builds (project_id, git_sha);\nCREATE INDEX IF NOT EXISTS builds_git_branch_idx ON builds (git_branch);\nCREATE TABLE IF NOT EXISTS capture_attempts (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  attempt_no INTEGER NOT NULL,\n  status TEXT NOT NULL DEFAULT 'queued',\n  error TEXT,\n  req_id TEXT,\n  story_count INTEGER NOT NULL DEFAULT 0,\n  failed_count INTEGER NOT NULL DEFAULT 0,\n  queued_at TIMESTAMPTZ NOT NULL,\n  started_at TIMESTAMPTZ,\n  finished_at TIMESTAMPTZ,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS capture_attempts_build_no_idx ON capture_attempts (build_id, attempt_no);\nCREATE INDEX IF NOT EXISTS capture_attempts_build_id_idx ON capture_attempts (build_id);\nCREATE TABLE IF NOT EXISTS capture_logs (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  attempt_id TEXT NOT NULL REFERENCES capture_attempts(id) ON DELETE CASCADE,\n  seq INTEGER NOT NULL,\n  level TEXT NOT NULL DEFAULT 'info',\n  message TEXT NOT NULL,\n  fields TEXT,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS capture_logs_attempt_seq_idx ON capture_logs (attempt_id, seq);\nCREATE TABLE IF NOT EXISTS snapshots (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  story_id TEXT NOT NULL,\n  story_name TEXT NOT NULL,\n  story_title TEXT NOT NULL,\n  story_import_path TEXT,\n  viewport_name TEXT NOT NULL DEFAULT 'desktop',\n  viewport_width INTEGER NOT NULL DEFAULT 1280,\n  viewport_height INTEGER NOT NULL DEFAULT 720,\n  screenshot_path TEXT NOT NULL,\n  diff_path TEXT,\n  diff_pixels INTEGER,\n  diff_ratio DOUBLE PRECISION,\n  diff_passed BOOLEAN,\n  status TEXT NOT NULL DEFAULT 'pending',\n  reviewed_by TEXT,\n  reviewed_at TIMESTAMPTZ,\n  infra_hash TEXT,\n  inherited BOOLEAN NOT NULL DEFAULT false,\n  baseline_id TEXT,\n  baseline_version TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS snapshots_build_story_viewport_idx ON snapshots (build_id, story_id, viewport_name);\nCREATE INDEX IF NOT EXISTS snapshots_build_id_idx ON snapshots (build_id);\nCREATE TABLE IF NOT EXISTS baselines (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  story_id TEXT NOT NULL,\n  viewport_name TEXT NOT NULL DEFAULT 'desktop',\n  branch TEXT NOT NULL,\n  snapshot_id TEXT,\n  screenshot_path TEXT NOT NULL,\n  infra_hash TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS baselines_project_story_viewport_branch_idx ON baselines (project_id, story_id, viewport_name, branch);\nCREATE INDEX IF NOT EXISTS baselines_project_story_idx ON baselines (project_id, story_id);\nCREATE TABLE IF NOT EXISTS users (\n  id TEXT PRIMARY KEY,\n  email TEXT NOT NULL UNIQUE,\n  name TEXT NOT NULL,\n  avatar_url TEXT,\n  role TEXT NOT NULL DEFAULT 'member',\n  last_login_at TIMESTAMPTZ,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS comments (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  snapshot_id TEXT REFERENCES snapshots(id) ON DELETE CASCADE,\n  user_id TEXT REFERENCES users(id) ON DELETE CASCADE,\n  body TEXT NOT NULL,\n  parent_id TEXT,\n  resolved BOOLEAN NOT NULL DEFAULT false,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS comments_build_id_idx ON comments (build_id);\nCREATE TABLE IF NOT EXISTS label_types (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  key TEXT NOT NULL,\n  name TEXT NOT NULL,\n  link_template TEXT,\n  color TEXT,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS label_types_project_key_idx ON label_types (project_id, key);\nCREATE TABLE IF NOT EXISTS build_labels (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  type_key TEXT NOT NULL,\n  value TEXT NOT NULL,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS build_labels_build_type_value_idx ON build_labels (build_id, type_key, value);\nCREATE TABLE IF NOT EXISTS tokens (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  name TEXT NOT NULL,\n  hash TEXT NOT NULL UNIQUE,\n  user_id TEXT REFERENCES users(id) ON DELETE CASCADE,\n  last_used_at TIMESTAMPTZ,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS webhooks (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  url TEXT NOT NULL,\n  secret_encrypted TEXT NOT NULL,\n  events TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS notification_channels (\n  id TEXT PRIMARY KEY,\n  project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,\n  provider TEXT NOT NULL,\n  config TEXT NOT NULL,\n  secret_encrypted TEXT,\n  events TEXT,\n  enabled BOOLEAN NOT NULL DEFAULT TRUE,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS notification_channels_project_id_idx ON notification_channels (project_id);\nCREATE TABLE IF NOT EXISTS notification_subscriptions (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  events TEXT,\n  via TEXT,\n  enabled BOOLEAN NOT NULL DEFAULT TRUE,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS notification_subscriptions_project_user_idx ON notification_subscriptions (project_id, user_id);\nCREATE TABLE IF NOT EXISTS user_invite_tokens (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  token_hash TEXT NOT NULL UNIQUE,\n  expires_at TIMESTAMPTZ NOT NULL,\n  used_at TIMESTAMPTZ,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS project_members (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  role TEXT NOT NULL DEFAULT 'viewer',\n  source TEXT NOT NULL DEFAULT 'manual',\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS project_members_project_user_idx ON project_members (project_id, user_id);\nCREATE TABLE IF NOT EXISTS project_group_mappings (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  group_name TEXT NOT NULL,\n  role TEXT NOT NULL DEFAULT 'viewer',\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS project_group_mappings_project_group_idx ON project_group_mappings (project_id, group_name);\nCREATE TABLE IF NOT EXISTS content_refs (\n  hash TEXT PRIMARY KEY,\n  ref_count INTEGER NOT NULL DEFAULT 1,\n  last_seen_at TIMESTAMPTZ NOT NULL,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS \"user\" (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  email TEXT NOT NULL UNIQUE,\n  email_verified BOOLEAN NOT NULL DEFAULT false,\n  image TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS session (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL REFERENCES \"user\"(id) ON DELETE CASCADE,\n  token TEXT NOT NULL UNIQUE,\n  expires_at TIMESTAMPTZ NOT NULL,\n  ip_address TEXT,\n  user_agent TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS session_token_idx ON session (token);\nCREATE INDEX IF NOT EXISTS session_user_id_idx ON session (user_id);\nCREATE TABLE IF NOT EXISTS account (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL REFERENCES \"user\"(id) ON DELETE CASCADE,\n  account_id TEXT NOT NULL,\n  provider_id TEXT NOT NULL,\n  access_token TEXT,\n  refresh_token TEXT,\n  id_token TEXT,\n  access_token_expires_at TIMESTAMPTZ,\n  refresh_token_expires_at TIMESTAMPTZ,\n  scope TEXT,\n  expires_at TIMESTAMPTZ,\n  password TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS account_user_id_idx ON account (user_id);\nCREATE TABLE IF NOT EXISTS verification (\n  id TEXT PRIMARY KEY,\n  identifier TEXT NOT NULL,\n  value TEXT NOT NULL,\n  expires_at TIMESTAMPTZ NOT NULL,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS verification_identifier_idx ON verification (identifier);\nCREATE TABLE IF NOT EXISTS passkey (\n  id TEXT PRIMARY KEY,\n  name TEXT,\n  public_key TEXT NOT NULL,\n  user_id TEXT NOT NULL REFERENCES \"user\"(id) ON DELETE CASCADE,\n  credential_id TEXT NOT NULL,\n  counter INTEGER NOT NULL,\n  device_type TEXT NOT NULL,\n  backed_up BOOLEAN NOT NULL DEFAULT false,\n  transports TEXT,\n  aaguid TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ\n);\nCREATE INDEX IF NOT EXISTS passkey_user_id_idx ON passkey (user_id);\nCREATE INDEX IF NOT EXISTS passkey_credential_id_idx ON passkey (credential_id);\nCREATE TABLE IF NOT EXISTS \"ssoProvider\" (\n  id TEXT PRIMARY KEY,\n  issuer TEXT NOT NULL,\n  oidc_config TEXT,\n  saml_config TEXT,\n  user_id TEXT NOT NULL REFERENCES \"user\"(id) ON DELETE CASCADE,\n  provider_id TEXT NOT NULL UNIQUE,\n  organization_id TEXT,\n  domain TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS ssoprovider_domain_idx ON \"ssoProvider\" (domain);\n";
+//#endregion
+export { DDL };
+//# sourceMappingURL=ddl.d.mts.map

package/dist/ddl.mjs

@@ -0,0 +1,321 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/ddl.ts
+/** Canonical Postgres DDL for all StoryShelf tables and indexes. */
+const DDL = `
+CREATE TABLE IF NOT EXISTS projects (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  slug TEXT NOT NULL UNIQUE,
+  git_repository TEXT,
+  git_default_branch TEXT NOT NULL DEFAULT 'main',
+  pixel_threshold DOUBLE PRECISION NOT NULL DEFAULT 0.1,
+  max_diff_ratio DOUBLE PRECISION NOT NULL DEFAULT 0.01,
+  public_branch_regex TEXT,
+  storybook_meta TEXT,
+  execute_play BOOLEAN NOT NULL DEFAULT false,
+  play_timeout_ms INTEGER NOT NULL DEFAULT 10000,
+  run_a11y BOOLEAN NOT NULL DEFAULT false,
+  browser TEXT NOT NULL DEFAULT 'chromium',
+  viewports TEXT,
+  automigrate BOOLEAN NOT NULL DEFAULT false,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE TABLE IF NOT EXISTS project_status_configs (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  provider TEXT NOT NULL,
+  config TEXT NOT NULL,
+  token_encrypted TEXT NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE TABLE IF NOT EXISTS builds (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  git_sha TEXT NOT NULL,
+  git_branch TEXT NOT NULL,
+  is_default BOOLEAN NOT NULL DEFAULT false,
+  author_email TEXT,
+  author_name TEXT,
+  message TEXT,
+  public BOOLEAN NOT NULL DEFAULT false,
+  status TEXT NOT NULL DEFAULT 'pending',
+  snapshot_count INTEGER NOT NULL DEFAULT 0,
+  changed_count INTEGER NOT NULL DEFAULT 0,
+  approved_count INTEGER NOT NULL DEFAULT 0,
+  rejected_count INTEGER NOT NULL DEFAULT 0,
+  affected_only BOOLEAN NOT NULL DEFAULT true,
+  baseline_sha TEXT,
+  changed_files TEXT,
+  affected_import_paths TEXT,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE INDEX IF NOT EXISTS builds_project_gitsha_idx ON builds (project_id, git_sha);
+CREATE INDEX IF NOT EXISTS builds_git_branch_idx ON builds (git_branch);
+CREATE TABLE IF NOT EXISTS capture_attempts (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,
+  attempt_no INTEGER NOT NULL,
+  status TEXT NOT NULL DEFAULT 'queued',
+  error TEXT,
+  req_id TEXT,
+  story_count INTEGER NOT NULL DEFAULT 0,
+  failed_count INTEGER NOT NULL DEFAULT 0,
+  queued_at TIMESTAMPTZ NOT NULL,
+  started_at TIMESTAMPTZ,
+  finished_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE UNIQUE INDEX IF NOT EXISTS capture_attempts_build_no_idx ON capture_attempts (build_id, attempt_no);
+CREATE INDEX IF NOT EXISTS capture_attempts_build_id_idx ON capture_attempts (build_id);
+CREATE TABLE IF NOT EXISTS capture_logs (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,
+  attempt_id TEXT NOT NULL REFERENCES capture_attempts(id) ON DELETE CASCADE,
+  seq INTEGER NOT NULL,
+  level TEXT NOT NULL DEFAULT 'info',
+  message TEXT NOT NULL,
+  fields TEXT,
+  created_at TIMESTAMPTZ NOT NULL
+);
+CREATE INDEX IF NOT EXISTS capture_logs_attempt_seq_idx ON capture_logs (attempt_id, seq);
+CREATE TABLE IF NOT EXISTS snapshots (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,
+  story_id TEXT NOT NULL,
+  story_name TEXT NOT NULL,
+  story_title TEXT NOT NULL,
+  story_import_path TEXT,
+  viewport_name TEXT NOT NULL DEFAULT 'desktop',
+  viewport_width INTEGER NOT NULL DEFAULT 1280,
+  viewport_height INTEGER NOT NULL DEFAULT 720,
+  screenshot_path TEXT NOT NULL,
+  diff_path TEXT,
+  diff_pixels INTEGER,
+  diff_ratio DOUBLE PRECISION,
+  diff_passed BOOLEAN,
+  status TEXT NOT NULL DEFAULT 'pending',
+  reviewed_by TEXT,
+  reviewed_at TIMESTAMPTZ,
+  infra_hash TEXT,
+  inherited BOOLEAN NOT NULL DEFAULT false,
+  baseline_id TEXT,
+  baseline_version TEXT,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE UNIQUE INDEX IF NOT EXISTS snapshots_build_story_viewport_idx ON snapshots (build_id, story_id, viewport_name);
+CREATE INDEX IF NOT EXISTS snapshots_build_id_idx ON snapshots (build_id);
+CREATE TABLE IF NOT EXISTS baselines (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  story_id TEXT NOT NULL,
+  viewport_name TEXT NOT NULL DEFAULT 'desktop',
+  branch TEXT NOT NULL,
+  snapshot_id TEXT,
+  screenshot_path TEXT NOT NULL,
+  infra_hash TEXT,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE UNIQUE INDEX IF NOT EXISTS baselines_project_story_viewport_branch_idx ON baselines (project_id, story_id, viewport_name, branch);
+CREATE INDEX IF NOT EXISTS baselines_project_story_idx ON baselines (project_id, story_id);
+CREATE TABLE IF NOT EXISTS users (
+  id TEXT PRIMARY KEY,
+  email TEXT NOT NULL UNIQUE,
+  name TEXT NOT NULL,
+  avatar_url TEXT,
+  role TEXT NOT NULL DEFAULT 'member',
+  last_login_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL
+);
+CREATE TABLE IF NOT EXISTS comments (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,
+  snapshot_id TEXT REFERENCES snapshots(id) ON DELETE CASCADE,
+  user_id TEXT REFERENCES users(id) ON DELETE CASCADE,
+  body TEXT NOT NULL,
+  parent_id TEXT,
+  resolved BOOLEAN NOT NULL DEFAULT false,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE INDEX IF NOT EXISTS comments_build_id_idx ON comments (build_id);
+CREATE TABLE IF NOT EXISTS label_types (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  key TEXT NOT NULL,
+  name TEXT NOT NULL,
+  link_template TEXT,
+  color TEXT,
+  created_at TIMESTAMPTZ NOT NULL
+);
+CREATE UNIQUE INDEX IF NOT EXISTS label_types_project_key_idx ON label_types (project_id, key);
+CREATE TABLE IF NOT EXISTS build_labels (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,
+  type_key TEXT NOT NULL,
+  value TEXT NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL
+);
+CREATE UNIQUE INDEX IF NOT EXISTS build_labels_build_type_value_idx ON build_labels (build_id, type_key, value);
+CREATE TABLE IF NOT EXISTS tokens (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  name TEXT NOT NULL,
+  hash TEXT NOT NULL UNIQUE,
+  user_id TEXT REFERENCES users(id) ON DELETE CASCADE,
+  last_used_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL
+);
+CREATE TABLE IF NOT EXISTS webhooks (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  url TEXT NOT NULL,
+  secret_encrypted TEXT NOT NULL,
+  events TEXT,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE TABLE IF NOT EXISTS notification_channels (
+  id TEXT PRIMARY KEY,
+  project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
+  provider TEXT NOT NULL,
+  config TEXT NOT NULL,
+  secret_encrypted TEXT,
+  events TEXT,
+  enabled BOOLEAN NOT NULL DEFAULT TRUE,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE INDEX IF NOT EXISTS notification_channels_project_id_idx ON notification_channels (project_id);
+CREATE TABLE IF NOT EXISTS notification_subscriptions (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  events TEXT,
+  via TEXT,
+  enabled BOOLEAN NOT NULL DEFAULT TRUE,
+  created_at TIMESTAMPTZ NOT NULL
+);
+CREATE UNIQUE INDEX IF NOT EXISTS notification_subscriptions_project_user_idx ON notification_subscriptions (project_id, user_id);
+CREATE TABLE IF NOT EXISTS user_invite_tokens (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  token_hash TEXT NOT NULL UNIQUE,
+  expires_at TIMESTAMPTZ NOT NULL,
+  used_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL
+);
+CREATE TABLE IF NOT EXISTS project_members (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  role TEXT NOT NULL DEFAULT 'viewer',
+  source TEXT NOT NULL DEFAULT 'manual',
+  created_at TIMESTAMPTZ NOT NULL
+);
+CREATE UNIQUE INDEX IF NOT EXISTS project_members_project_user_idx ON project_members (project_id, user_id);
+CREATE TABLE IF NOT EXISTS project_group_mappings (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+  group_name TEXT NOT NULL,
+  role TEXT NOT NULL DEFAULT 'viewer',
+  created_at TIMESTAMPTZ NOT NULL
+);
+CREATE UNIQUE INDEX IF NOT EXISTS project_group_mappings_project_group_idx ON project_group_mappings (project_id, group_name);
+CREATE TABLE IF NOT EXISTS content_refs (
+  hash TEXT PRIMARY KEY,
+  ref_count INTEGER NOT NULL DEFAULT 1,
+  last_seen_at TIMESTAMPTZ NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL
+);
+CREATE TABLE IF NOT EXISTS "user" (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  email TEXT NOT NULL UNIQUE,
+  email_verified BOOLEAN NOT NULL DEFAULT false,
+  image TEXT,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE TABLE IF NOT EXISTS session (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES "user"(id) ON DELETE CASCADE,
+  token TEXT NOT NULL UNIQUE,
+  expires_at TIMESTAMPTZ NOT NULL,
+  ip_address TEXT,
+  user_agent TEXT,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE INDEX IF NOT EXISTS session_token_idx ON session (token);
+CREATE INDEX IF NOT EXISTS session_user_id_idx ON session (user_id);
+CREATE TABLE IF NOT EXISTS account (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES "user"(id) ON DELETE CASCADE,
+  account_id TEXT NOT NULL,
+  provider_id TEXT NOT NULL,
+  access_token TEXT,
+  refresh_token TEXT,
+  id_token TEXT,
+  access_token_expires_at TIMESTAMPTZ,
+  refresh_token_expires_at TIMESTAMPTZ,
+  scope TEXT,
+  expires_at TIMESTAMPTZ,
+  password TEXT,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE INDEX IF NOT EXISTS account_user_id_idx ON account (user_id);
+CREATE TABLE IF NOT EXISTS verification (
+  id TEXT PRIMARY KEY,
+  identifier TEXT NOT NULL,
+  value TEXT NOT NULL,
+  expires_at TIMESTAMPTZ NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ NOT NULL
+);
+CREATE INDEX IF NOT EXISTS verification_identifier_idx ON verification (identifier);
+CREATE TABLE IF NOT EXISTS passkey (
+  id TEXT PRIMARY KEY,
+  name TEXT,
+  public_key TEXT NOT NULL,
+  user_id TEXT NOT NULL REFERENCES "user"(id) ON DELETE CASCADE,
+  credential_id TEXT NOT NULL,
+  counter INTEGER NOT NULL,
+  device_type TEXT NOT NULL,
+  backed_up BOOLEAN NOT NULL DEFAULT false,
+  transports TEXT,
+  aaguid TEXT,
+  created_at TIMESTAMPTZ NOT NULL,
+  updated_at TIMESTAMPTZ
+);
+CREATE INDEX IF NOT EXISTS passkey_user_id_idx ON passkey (user_id);
+CREATE INDEX IF NOT EXISTS passkey_credential_id_idx ON passkey (credential_id);
+CREATE TABLE IF NOT EXISTS "ssoProvider" (
+  id TEXT PRIMARY KEY,
+  issuer TEXT NOT NULL,
+  oidc_config TEXT,
+  saml_config TEXT,
+  user_id TEXT NOT NULL REFERENCES "user"(id) ON DELETE CASCADE,
+  provider_id TEXT NOT NULL UNIQUE,
+  organization_id TEXT,
+  domain TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS ssoprovider_domain_idx ON "ssoProvider" (domain);
+`;
+//#endregion
+export { DDL };
+
+//# sourceMappingURL=ddl.mjs.map

package/dist/ddl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl.mjs","names":[],"sources":["../src/ddl.ts"],"sourcesContent":["/** Canonical Postgres DDL for all StoryShelf tables and indexes. */\nexport const DDL = `\nCREATE TABLE IF NOT EXISTS projects (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  slug TEXT NOT NULL UNIQUE,\n  git_repository TEXT,\n  git_default_branch TEXT NOT NULL DEFAULT 'main',\n  pixel_threshold DOUBLE PRECISION NOT NULL DEFAULT 0.1,\n  max_diff_ratio DOUBLE PRECISION NOT NULL DEFAULT 0.01,\n  public_branch_regex TEXT,\n  storybook_meta TEXT,\n  execute_play BOOLEAN NOT NULL DEFAULT false,\n  play_timeout_ms INTEGER NOT NULL DEFAULT 10000,\n  run_a11y BOOLEAN NOT NULL DEFAULT false,\n  browser TEXT NOT NULL DEFAULT 'chromium',\n  viewports TEXT,\n  automigrate BOOLEAN NOT NULL DEFAULT false,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS project_status_configs (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  provider TEXT NOT NULL,\n  config TEXT NOT NULL,\n  token_encrypted TEXT NOT NULL,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS builds (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  git_sha TEXT NOT NULL,\n  git_branch TEXT NOT NULL,\n  is_default BOOLEAN NOT NULL DEFAULT false,\n  author_email TEXT,\n  author_name TEXT,\n  message TEXT,\n  public BOOLEAN NOT NULL DEFAULT false,\n  status TEXT NOT NULL DEFAULT 'pending',\n  snapshot_count INTEGER NOT NULL DEFAULT 0,\n  changed_count INTEGER NOT NULL DEFAULT 0,\n  approved_count INTEGER NOT NULL DEFAULT 0,\n  rejected_count INTEGER NOT NULL DEFAULT 0,\n  affected_only BOOLEAN NOT NULL DEFAULT true,\n  baseline_sha TEXT,\n  changed_files TEXT,\n  affected_import_paths TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS builds_project_gitsha_idx ON builds (project_id, git_sha);\nCREATE INDEX IF NOT EXISTS builds_git_branch_idx ON builds (git_branch);\nCREATE TABLE IF NOT EXISTS capture_attempts (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  attempt_no INTEGER NOT NULL,\n  status TEXT NOT NULL DEFAULT 'queued',\n  error TEXT,\n  req_id TEXT,\n  story_count INTEGER NOT NULL DEFAULT 0,\n  failed_count INTEGER NOT NULL DEFAULT 0,\n  queued_at TIMESTAMPTZ NOT NULL,\n  started_at TIMESTAMPTZ,\n  finished_at TIMESTAMPTZ,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS capture_attempts_build_no_idx ON capture_attempts (build_id, attempt_no);\nCREATE INDEX IF NOT EXISTS capture_attempts_build_id_idx ON capture_attempts (build_id);\nCREATE TABLE IF NOT EXISTS capture_logs (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  attempt_id TEXT NOT NULL REFERENCES capture_attempts(id) ON DELETE CASCADE,\n  seq INTEGER NOT NULL,\n  level TEXT NOT NULL DEFAULT 'info',\n  message TEXT NOT NULL,\n  fields TEXT,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS capture_logs_attempt_seq_idx ON capture_logs (attempt_id, seq);\nCREATE TABLE IF NOT EXISTS snapshots (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  story_id TEXT NOT NULL,\n  story_name TEXT NOT NULL,\n  story_title TEXT NOT NULL,\n  story_import_path TEXT,\n  viewport_name TEXT NOT NULL DEFAULT 'desktop',\n  viewport_width INTEGER NOT NULL DEFAULT 1280,\n  viewport_height INTEGER NOT NULL DEFAULT 720,\n  screenshot_path TEXT NOT NULL,\n  diff_path TEXT,\n  diff_pixels INTEGER,\n  diff_ratio DOUBLE PRECISION,\n  diff_passed BOOLEAN,\n  status TEXT NOT NULL DEFAULT 'pending',\n  reviewed_by TEXT,\n  reviewed_at TIMESTAMPTZ,\n  infra_hash TEXT,\n  inherited BOOLEAN NOT NULL DEFAULT false,\n  baseline_id TEXT,\n  baseline_version TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS snapshots_build_story_viewport_idx ON snapshots (build_id, story_id, viewport_name);\nCREATE INDEX IF NOT EXISTS snapshots_build_id_idx ON snapshots (build_id);\nCREATE TABLE IF NOT EXISTS baselines (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  story_id TEXT NOT NULL,\n  viewport_name TEXT NOT NULL DEFAULT 'desktop',\n  branch TEXT NOT NULL,\n  snapshot_id TEXT,\n  screenshot_path TEXT NOT NULL,\n  infra_hash TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS baselines_project_story_viewport_branch_idx ON baselines (project_id, story_id, viewport_name, branch);\nCREATE INDEX IF NOT EXISTS baselines_project_story_idx ON baselines (project_id, story_id);\nCREATE TABLE IF NOT EXISTS users (\n  id TEXT PRIMARY KEY,\n  email TEXT NOT NULL UNIQUE,\n  name TEXT NOT NULL,\n  avatar_url TEXT,\n  role TEXT NOT NULL DEFAULT 'member',\n  last_login_at TIMESTAMPTZ,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS comments (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  snapshot_id TEXT REFERENCES snapshots(id) ON DELETE CASCADE,\n  user_id TEXT REFERENCES users(id) ON DELETE CASCADE,\n  body TEXT NOT NULL,\n  parent_id TEXT,\n  resolved BOOLEAN NOT NULL DEFAULT false,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS comments_build_id_idx ON comments (build_id);\nCREATE TABLE IF NOT EXISTS label_types (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  key TEXT NOT NULL,\n  name TEXT NOT NULL,\n  link_template TEXT,\n  color TEXT,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS label_types_project_key_idx ON label_types (project_id, key);\nCREATE TABLE IF NOT EXISTS build_labels (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  build_id TEXT NOT NULL REFERENCES builds(id) ON DELETE CASCADE,\n  type_key TEXT NOT NULL,\n  value TEXT NOT NULL,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS build_labels_build_type_value_idx ON build_labels (build_id, type_key, value);\nCREATE TABLE IF NOT EXISTS tokens (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  name TEXT NOT NULL,\n  hash TEXT NOT NULL UNIQUE,\n  user_id TEXT REFERENCES users(id) ON DELETE CASCADE,\n  last_used_at TIMESTAMPTZ,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS webhooks (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  url TEXT NOT NULL,\n  secret_encrypted TEXT NOT NULL,\n  events TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS notification_channels (\n  id TEXT PRIMARY KEY,\n  project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,\n  provider TEXT NOT NULL,\n  config TEXT NOT NULL,\n  secret_encrypted TEXT,\n  events TEXT,\n  enabled BOOLEAN NOT NULL DEFAULT TRUE,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS notification_channels_project_id_idx ON notification_channels (project_id);\nCREATE TABLE IF NOT EXISTS notification_subscriptions (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  events TEXT,\n  via TEXT,\n  enabled BOOLEAN NOT NULL DEFAULT TRUE,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS notification_subscriptions_project_user_idx ON notification_subscriptions (project_id, user_id);\nCREATE TABLE IF NOT EXISTS user_invite_tokens (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  token_hash TEXT NOT NULL UNIQUE,\n  expires_at TIMESTAMPTZ NOT NULL,\n  used_at TIMESTAMPTZ,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS project_members (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,\n  role TEXT NOT NULL DEFAULT 'viewer',\n  source TEXT NOT NULL DEFAULT 'manual',\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS project_members_project_user_idx ON project_members (project_id, user_id);\nCREATE TABLE IF NOT EXISTS project_group_mappings (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  group_name TEXT NOT NULL,\n  role TEXT NOT NULL DEFAULT 'viewer',\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE UNIQUE INDEX IF NOT EXISTS project_group_mappings_project_group_idx ON project_group_mappings (project_id, group_name);\nCREATE TABLE IF NOT EXISTS content_refs (\n  hash TEXT PRIMARY KEY,\n  ref_count INTEGER NOT NULL DEFAULT 1,\n  last_seen_at TIMESTAMPTZ NOT NULL,\n  created_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS \"user\" (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  email TEXT NOT NULL UNIQUE,\n  email_verified BOOLEAN NOT NULL DEFAULT false,\n  image TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE TABLE IF NOT EXISTS session (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL REFERENCES \"user\"(id) ON DELETE CASCADE,\n  token TEXT NOT NULL UNIQUE,\n  expires_at TIMESTAMPTZ NOT NULL,\n  ip_address TEXT,\n  user_agent TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS session_token_idx ON session (token);\nCREATE INDEX IF NOT EXISTS session_user_id_idx ON session (user_id);\nCREATE TABLE IF NOT EXISTS account (\n  id TEXT PRIMARY KEY,\n  user_id TEXT NOT NULL REFERENCES \"user\"(id) ON DELETE CASCADE,\n  account_id TEXT NOT NULL,\n  provider_id TEXT NOT NULL,\n  access_token TEXT,\n  refresh_token TEXT,\n  id_token TEXT,\n  access_token_expires_at TIMESTAMPTZ,\n  refresh_token_expires_at TIMESTAMPTZ,\n  scope TEXT,\n  expires_at TIMESTAMPTZ,\n  password TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS account_user_id_idx ON account (user_id);\nCREATE TABLE IF NOT EXISTS verification (\n  id TEXT PRIMARY KEY,\n  identifier TEXT NOT NULL,\n  value TEXT NOT NULL,\n  expires_at TIMESTAMPTZ NOT NULL,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ NOT NULL\n);\nCREATE INDEX IF NOT EXISTS verification_identifier_idx ON verification (identifier);\nCREATE TABLE IF NOT EXISTS passkey (\n  id TEXT PRIMARY KEY,\n  name TEXT,\n  public_key TEXT NOT NULL,\n  user_id TEXT NOT NULL REFERENCES \"user\"(id) ON DELETE CASCADE,\n  credential_id TEXT NOT NULL,\n  counter INTEGER NOT NULL,\n  device_type TEXT NOT NULL,\n  backed_up BOOLEAN NOT NULL DEFAULT false,\n  transports TEXT,\n  aaguid TEXT,\n  created_at TIMESTAMPTZ NOT NULL,\n  updated_at TIMESTAMPTZ\n);\nCREATE INDEX IF NOT EXISTS passkey_user_id_idx ON passkey (user_id);\nCREATE INDEX IF NOT EXISTS passkey_credential_id_idx ON passkey (credential_id);\nCREATE TABLE IF NOT EXISTS \"ssoProvider\" (\n  id TEXT PRIMARY KEY,\n  issuer TEXT NOT NULL,\n  oidc_config TEXT,\n  saml_config TEXT,\n  user_id TEXT NOT NULL REFERENCES \"user\"(id) ON DELETE CASCADE,\n  provider_id TEXT NOT NULL UNIQUE,\n  organization_id TEXT,\n  domain TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS ssoprovider_domain_idx ON \"ssoProvider\" (domain);\n`;\n"],"mappings":";;;;;AACA,MAAa,MAAM"}

package/dist/drizzle-factory-pg.mjs

@@ -0,0 +1,77 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { applyListOptions, buildLifecycle } from "./drizzle-factory.mjs";
+import { eq, getTableColumns } from "drizzle-orm";
+//#region src/drizzle-factory-pg.ts
+function idColumn(table) {
+	const id = getTableColumns(table)["id"];
+	if (!id) throw new Error("Table has no id column");
+	return id;
+}
+function firstRow(rows, what) {
+	const [row] = rows;
+	if (row === void 0) throw new Error(`${what} returned no rows`);
+	return row;
+}
+async function insertOne(drizzle, table, values) {
+	return firstRow(await drizzle.insert(table).values(values).returning(), "Insert");
+}
+async function updateOne(drizzle, table, id, values) {
+	const where = eq(idColumn(table), id);
+	return firstRow(await drizzle.update(table).set(values).where(where).returning(), "Update");
+}
+/**
+* Build a {@link DatabaseAdapter} over any Postgres-compatible Drizzle
+* dialect. Mirrors `createDrizzleAdapter` with Postgres terminal shapes
+* (chains await directly; `returning()` yields arrays).
+*/
+function createDrizzlePgAdapter(db, options) {
+	const drizzle = db;
+	const lifecycle = buildLifecycle(options);
+	return {
+		metadata: options.metadata,
+		tables: options.tables,
+		lifecycle,
+		insert: async (table, values) => await insertOne(drizzle, table, values),
+		update: async (table, id, values) => await updateOne(drizzle, table, id, values),
+		get: async (table, id) => {
+			const where = eq(idColumn(table), id);
+			return (await drizzle.select().from(table).where(where).limit(1))[0] ?? null;
+		},
+		remove: async (table, id) => {
+			const where = eq(idColumn(table), id);
+			await drizzle.delete(table).where(where);
+		},
+		list: async (table, opts = {}) => {
+			return await applyListOptions(drizzle.select().from(table), opts);
+		},
+		count: async (table, where) => await drizzle.$count(table, where),
+		all: async (query) => await drizzle.execute(query),
+		transact: async (fn) => await drizzle.transaction(async (tx) => await fn(buildTxStore(tx)))
+	};
+}
+/** CRUD subset bound to a Postgres transaction handle. */
+function buildTxStore(drizzle) {
+	return {
+		insert: async (table, values) => await insertOne(drizzle, table, values),
+		update: async (table, id, values) => await updateOne(drizzle, table, id, values),
+		get: async (table, id) => await getOne(drizzle, table, id),
+		remove: async (table, id) => {
+			const where = eq(idColumn(table), id);
+			await drizzle.delete(table).where(where);
+		},
+		list: async (table, opts = {}) => {
+			return await applyListOptions(drizzle.select().from(table), opts);
+		},
+		count: async (table, where) => await drizzle.$count(table, where)
+	};
+}
+async function getOne(drizzle, table, id) {
+	const where = eq(idColumn(table), id);
+	return (await drizzle.select().from(table).where(where).limit(1))[0] ?? null;
+}
+//#endregion
+export { createDrizzlePgAdapter };
+
+//# sourceMappingURL=drizzle-factory-pg.mjs.map

package/dist/drizzle-factory-pg.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-factory-pg.mjs","names":[],"sources":["../src/drizzle-factory-pg.ts"],"sourcesContent":["import type {\n  DatabaseAdapter,\n  DrizzleAdapterOptions,\n  ListOptions,\n  TxStore,\n} from \"@storyshelf/core/adapter/database\";\nimport type { AdapterLifecycle } from \"@storyshelf/core/adapter/metadata\";\nimport type { SQL } from \"drizzle-orm\";\nimport type { SQLWrapper } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport { eq, getTableColumns } from \"drizzle-orm\";\nimport { applyListOptions, buildLifecycle } from \"./drizzle-factory.ts\";\n\n/** Chainable select surface of the Postgres Drizzle dialect (directly awaitable). */\ninterface DrizzlePgSelectChain extends Promise<unknown[]> {\n  where(where: SQL): DrizzlePgSelectChain;\n  orderBy(order: SQL): DrizzlePgSelectChain;\n  limit(n: number): DrizzlePgSelectChain;\n  offset(n: number): DrizzlePgSelectChain;\n}\n\n/**\n * Minimal Postgres Drizzle surface consumed by {@link createDrizzlePgAdapter}.\n * Drivers pass their dialect instance as `unknown`; the cast lives here, once.\n */\ninterface DrizzlePgLike {\n  insert(table: Table): {\n    values(values: unknown): { returning(): Promise<unknown[]> };\n  };\n  update(table: Table): {\n    set(values: unknown): { where(where: SQL): { returning(): Promise<unknown[]> } };\n  };\n  select(): { from(table: Table): DrizzlePgSelectChain };\n  delete(table: Table): { where(where: SQL): Promise<unknown> };\n  $count(table: Table, where?: SQL): Promise<number>;\n  execute<T>(query: SQL): Promise<T>;\n  transaction<R>(fn: (tx: unknown) => Promise<R>): Promise<R>;\n}\n\nfunction idColumn(table: Table): SQLWrapper {\n  const id = getTableColumns(table)[\"id\"];\n  if (!id) {\n    throw new Error(\"Table has no id column\");\n  }\n  return id;\n}\n\nfunction firstRow(rows: unknown[], what: string): unknown {\n  const [row] = rows;\n  if (row === undefined) {\n    throw new Error(`${what} returned no rows`);\n  }\n  return row;\n}\n\nasync function insertOne<T extends Table>(\n  drizzle: DrizzlePgLike,\n  table: T,\n  values: T[\"$inferInsert\"],\n): Promise<T[\"$inferSelect\"]> {\n  const rows = await drizzle.insert(table).values(values).returning();\n  return firstRow(rows, \"Insert\") as T[\"$inferSelect\"];\n}\n\nasync function updateOne<T extends Table>(\n  drizzle: DrizzlePgLike,\n  table: T,\n  id: string,\n  values: Partial<T[\"$inferInsert\"]>,\n): Promise<T[\"$inferSelect\"]> {\n  const where = eq(idColumn(table), id);\n  const rows = await drizzle.update(table).set(values).where(where).returning();\n  return firstRow(rows, \"Update\") as T[\"$inferSelect\"];\n}\n\n/**\n * Build a {@link DatabaseAdapter} over any Postgres-compatible Drizzle\n * dialect. Mirrors `createDrizzleAdapter` with Postgres terminal shapes\n * (chains await directly; `returning()` yields arrays).\n */\nexport function createDrizzlePgAdapter(\n  db: unknown,\n  options: DrizzleAdapterOptions,\n): DatabaseAdapter {\n  const drizzle = db as DrizzlePgLike;\n  const lifecycle: AdapterLifecycle = buildLifecycle(options);\n  return {\n    metadata: options.metadata,\n    tables: options.tables,\n    lifecycle,\n    insert: async <T extends Table>(\n      table: T,\n      values: T[\"$inferInsert\"],\n    ): Promise<T[\"$inferSelect\"]> => await insertOne(drizzle, table, values),\n    update: async <T extends Table>(\n      table: T,\n      id: string,\n      values: Partial<T[\"$inferInsert\"]>,\n    ): Promise<T[\"$inferSelect\"]> => await updateOne(drizzle, table, id, values),\n    get: async <T extends Table>(table: T, id: string): Promise<T[\"$inferSelect\"] | null> => {\n      const where = eq(idColumn(table), id);\n      const rows = (await drizzle\n        .select()\n        .from(table)\n        .where(where)\n        .limit(1)) as T[\"$inferSelect\"][];\n      return rows[0] ?? null;\n    },\n    remove: async (table: Table, id: string): Promise<void> => {\n      const where = eq(idColumn(table), id);\n      await drizzle.delete(table).where(where);\n    },\n    list: async <T extends Table>(\n      table: T,\n      opts: ListOptions = {},\n    ): Promise<T[\"$inferSelect\"][]> => {\n      const rows: unknown = await applyListOptions(drizzle.select().from(table), opts);\n      return rows as T[\"$inferSelect\"][];\n    },\n    count: async (table: Table, where?: SQL): Promise<number> => await drizzle.$count(table, where),\n    all: async <T>(query: SQL): Promise<T[]> => await drizzle.execute<T[]>(query),\n    transact: async <R>(fn: (tx: TxStore) => Promise<R>): Promise<R> =>\n      await drizzle.transaction(async (tx) => await fn(buildTxStore(tx as DrizzlePgLike))),\n  };\n}\n\n/** CRUD subset bound to a Postgres transaction handle. */\nfunction buildTxStore(drizzle: DrizzlePgLike): TxStore {\n  return {\n    insert: async (table, values) => await insertOne(drizzle, table, values as never),\n    update: async (table, id, values) => await updateOne(drizzle, table, id, values as never),\n    get: async (table, id) => await getOne(drizzle, table, id),\n    remove: async (table, id) => {\n      const where = eq(idColumn(table), id);\n      await drizzle.delete(table).where(where);\n    },\n    list: async (table, opts: ListOptions = {}) => {\n      const rows: unknown = await applyListOptions(drizzle.select().from(table), opts);\n      return rows as never[];\n    },\n    count: async (table, where) => await drizzle.$count(table, where),\n  };\n}\n\nasync function getOne<T extends Table>(\n  drizzle: DrizzlePgLike,\n  table: T,\n  id: string,\n): Promise<T[\"$inferSelect\"] | null> {\n  const where = eq(idColumn(table), id);\n  const rows = (await drizzle.select().from(table).where(where).limit(1)) as T[\"$inferSelect\"][];\n  return rows[0] ?? null;\n}\n"],"mappings":";;;;;;AAuCA,SAAS,SAAS,OAA0B;CAC1C,MAAM,KAAK,gBAAgB,KAAK,CAAC,CAAC;CAClC,IAAI,CAAC,IACH,MAAM,IAAI,MAAM,wBAAwB;CAE1C,OAAO;AACT;AAEA,SAAS,SAAS,MAAiB,MAAuB;CACxD,MAAM,CAAC,OAAO;CACd,IAAI,QAAQ,KAAA,GACV,MAAM,IAAI,MAAM,GAAG,KAAK,kBAAkB;CAE5C,OAAO;AACT;AAEA,eAAe,UACb,SACA,OACA,QAC4B;CAE5B,OAAO,SAAS,MADG,QAAQ,OAAO,KAAK,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,UAAU,GAC5C,QAAQ;AAChC;AAEA,eAAe,UACb,SACA,OACA,IACA,QAC4B;CAC5B,MAAM,QAAQ,GAAG,SAAS,KAAK,GAAG,EAAE;CAEpC,OAAO,SAAS,MADG,QAAQ,OAAO,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,UAAU,GACtD,QAAQ;AAChC;;;;;;AAOA,SAAgB,uBACd,IACA,SACiB;CACjB,MAAM,UAAU;CAChB,MAAM,YAA8B,eAAe,OAAO;CAC1D,OAAO;EACL,UAAU,QAAQ;EAClB,QAAQ,QAAQ;EAChB;EACA,QAAQ,OACN,OACA,WAC+B,MAAM,UAAU,SAAS,OAAO,MAAM;EACvE,QAAQ,OACN,OACA,IACA,WAC+B,MAAM,UAAU,SAAS,OAAO,IAAI,MAAM;EAC3E,KAAK,OAAwB,OAAU,OAAkD;GACvF,MAAM,QAAQ,GAAG,SAAS,KAAK,GAAG,EAAE;GAMpC,QAAO,MALa,QACjB,OAAO,CAAC,CACR,KAAK,KAAK,CAAC,CACX,MAAM,KAAK,CAAC,CACZ,MAAM,CAAC,EAAA,CACE,MAAM;EACpB;EACA,QAAQ,OAAO,OAAc,OAA8B;GACzD,MAAM,QAAQ,GAAG,SAAS,KAAK,GAAG,EAAE;GACpC,MAAM,QAAQ,OAAO,KAAK,CAAC,CAAC,MAAM,KAAK;EACzC;EACA,MAAM,OACJ,OACA,OAAoB,CAAC,MACY;GAEjC,OAAO,MADqB,iBAAiB,QAAQ,OAAO,CAAC,CAAC,KAAK,KAAK,GAAG,IAAI;EAEjF;EACA,OAAO,OAAO,OAAc,UAAiC,MAAM,QAAQ,OAAO,OAAO,KAAK;EAC9F,KAAK,OAAU,UAA6B,MAAM,QAAQ,QAAa,KAAK;EAC5E,UAAU,OAAU,OAClB,MAAM,QAAQ,YAAY,OAAO,OAAO,MAAM,GAAG,aAAa,EAAmB,CAAC,CAAC;CACvF;AACF;;AAGA,SAAS,aAAa,SAAiC;CACrD,OAAO;EACL,QAAQ,OAAO,OAAO,WAAW,MAAM,UAAU,SAAS,OAAO,MAAe;EAChF,QAAQ,OAAO,OAAO,IAAI,WAAW,MAAM,UAAU,SAAS,OAAO,IAAI,MAAe;EACxF,KAAK,OAAO,OAAO,OAAO,MAAM,OAAO,SAAS,OAAO,EAAE;EACzD,QAAQ,OAAO,OAAO,OAAO;GAC3B,MAAM,QAAQ,GAAG,SAAS,KAAK,GAAG,EAAE;GACpC,MAAM,QAAQ,OAAO,KAAK,CAAC,CAAC,MAAM,KAAK;EACzC;EACA,MAAM,OAAO,OAAO,OAAoB,CAAC,MAAM;GAE7C,OAAO,MADqB,iBAAiB,QAAQ,OAAO,CAAC,CAAC,KAAK,KAAK,GAAG,IAAI;EAEjF;EACA,OAAO,OAAO,OAAO,UAAU,MAAM,QAAQ,OAAO,OAAO,KAAK;CAClE;AACF;AAEA,eAAe,OACb,SACA,OACA,IACmC;CACnC,MAAM,QAAQ,GAAG,SAAS,KAAK,GAAG,EAAE;CAEpC,QAAO,MADa,QAAQ,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC,EAAA,CACzD,MAAM;AACpB"}

package/dist/drizzle-factory.mjs

@@ -0,0 +1,42 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/drizzle-factory.ts
+function applyListOptions(query, opts) {
+	let current = query;
+	if (opts.where) current = current.where(opts.where);
+	if (opts.orderBy) current = current.orderBy(opts.orderBy);
+	if (opts.limit !== void 0) current = current.limit(opts.limit);
+	if (opts.offset !== void 0) current = current.offset(opts.offset);
+	return current;
+}
+/**
+* Build the database lifecycle: migrations run in `setup`, the connection
+* is destroyed in `teardown`, `health` pings when the driver provides one.
+* Teardown tolerates repeated calls (drivers may not).
+*/
+function buildLifecycle(options) {
+	let closed = false;
+	return {
+		setup: async () => {
+			await options.migrate();
+		},
+		teardown: async () => {
+			if (closed) return;
+			closed = true;
+			await options.close();
+		},
+		health: async () => {
+			if (closed) return {
+				ok: false,
+				detail: "database closed"
+			};
+			if (options.ping) await options.ping();
+			return { ok: true };
+		}
+	};
+}
+//#endregion
+export { applyListOptions, buildLifecycle };
+
+//# sourceMappingURL=drizzle-factory.mjs.map

package/dist/drizzle-factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-factory.mjs","names":[],"sources":["../src/drizzle-factory.ts"],"sourcesContent":["import type { DrizzleAdapterOptions, ListOptions } from \"@storyshelf/core/adapter/database\";\nimport type { AdapterLifecycle } from \"@storyshelf/core/adapter/metadata\";\nimport type { SQL } from \"drizzle-orm\";\n\n/** Chainable filter surface shared by dialect select chains. */\nexport interface ChainFilter<C> {\n  where(where: SQL): C;\n  orderBy(order: SQL): C;\n  limit(n: number): C;\n  offset(n: number): C;\n}\n\nexport function applyListOptions<C extends ChainFilter<C>>(query: C, opts: ListOptions): C {\n  let current = query;\n  if (opts.where) {\n    current = current.where(opts.where);\n  }\n  if (opts.orderBy) {\n    current = current.orderBy(opts.orderBy);\n  }\n  if (opts.limit !== undefined) {\n    current = current.limit(opts.limit);\n  }\n  if (opts.offset !== undefined) {\n    current = current.offset(opts.offset);\n  }\n  return current;\n}\n\n/**\n * Build the database lifecycle: migrations run in `setup`, the connection\n * is destroyed in `teardown`, `health` pings when the driver provides one.\n * Teardown tolerates repeated calls (drivers may not).\n */\nexport function buildLifecycle(options: DrizzleAdapterOptions): AdapterLifecycle {\n  let closed = false;\n  return {\n    setup: async () => {\n      await options.migrate();\n    },\n    teardown: async () => {\n      if (closed) {\n        return;\n      }\n      closed = true;\n      await options.close();\n    },\n    health: async () => {\n      if (closed) {\n        return { ok: false, detail: \"database closed\" };\n      }\n      if (options.ping) {\n        await options.ping();\n      }\n      return { ok: true };\n    },\n  };\n}\n"],"mappings":";;;;AAYA,SAAgB,iBAA2C,OAAU,MAAsB;CACzF,IAAI,UAAU;CACd,IAAI,KAAK,OACP,UAAU,QAAQ,MAAM,KAAK,KAAK;CAEpC,IAAI,KAAK,SACP,UAAU,QAAQ,QAAQ,KAAK,OAAO;CAExC,IAAI,KAAK,UAAU,KAAA,GACjB,UAAU,QAAQ,MAAM,KAAK,KAAK;CAEpC,IAAI,KAAK,WAAW,KAAA,GAClB,UAAU,QAAQ,OAAO,KAAK,MAAM;CAEtC,OAAO;AACT;;;;;;AAOA,SAAgB,eAAe,SAAkD;CAC/E,IAAI,SAAS;CACb,OAAO;EACL,OAAO,YAAY;GACjB,MAAM,QAAQ,QAAQ;EACxB;EACA,UAAU,YAAY;GACpB,IAAI,QACF;GAEF,SAAS;GACT,MAAM,QAAQ,MAAM;EACtB;EACA,QAAQ,YAAY;GAClB,IAAI,QACF,OAAO;IAAE,IAAI;IAAO,QAAQ;GAAkB;GAEhD,IAAI,QAAQ,MACV,MAAM,QAAQ,KAAK;GAErB,OAAO,EAAE,IAAI,KAAK;EACpB;CACF;AACF"}

package/dist/index.d.mts

@@ -0,0 +1,50 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import postgres from "postgres";
+import { DatabaseAdapter } from "@storyshelf/core/adapter/database";
+//#region src/index.d.ts
+/**
+ * TLS options for Postgres connections. When `true`, the driver negotiates
+ * TLS with the server's default CA. When an object, `ca`/`cert`/`key` are
+ * forwarded to `postgres.js` for mutual TLS (e.g. GCP Cloud SQL) or custom
+ * RDS bundles.
+ */
+type PostgresSslOptions = boolean | {
+  ca?: string;
+  cert?: string;
+  key?: string;
+};
+/**
+ * Options for creating a Postgres-backed DatabaseAdapter.
+ *
+ * `url` (or `connectionString`) is the Postgres connection string
+ * (`postgres://user:pass@host:5432/db`). For managed providers, see the
+ * deployment guide for per-provider recipes (RDS CA bundle, Cloud SQL
+ * mutual TLS, Supabase pooler port `6543` with `prepare: false`, etc.).
+ *
+ * When `client` is supplied, all other connection options are ignored and
+ * the caller owns the lifecycle of the client. This is the hook for
+ * advanced setups (IAM token refresh, pre-configured TLS, etc.) and for
+ * hermetic tests.
+ */
+interface PostgresDatabaseOptions {
+  url?: string;
+  connectionString?: string;
+  ssl?: PostgresSslOptions;
+  prepare?: boolean;
+  max?: number;
+  idleTimeout?: number;
+  connectTimeout?: number;
+  client?: ReturnType<typeof postgres>;
+}
+/**
+ * Create a Postgres-backed DatabaseAdapter using postgres.js and Drizzle ORM.
+ *
+ * Works with self-hosted Postgres, AWS RDS, GCP Cloud SQL, Supabase, Neon,
+ * and Azure Database for PostgreSQL — all speak the standard wire protocol.
+ * For provider-specific TLS and pooling notes, see the deployment guide.
+ */
+declare function createPostgresDatabase(options: PostgresDatabaseOptions): DatabaseAdapter;
+//#endregion
+export { PostgresDatabaseOptions, PostgresSslOptions, createPostgresDatabase };
+//# sourceMappingURL=index.d.mts.map