@hasna/shortlinks 0.1.24 → 0.2.1

package/dist/serve/index.js

@@ -4943,8 +4943,8 @@ var require_lib2 = __commonJS((exports, module) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/shortlinks",
-    version: "0.1.24",
-    description: "CLI-only shortlink manager for custom domains, click tracking, Cloudflare setup, and app-owned Postgres runtime support",
+    version: "0.2.1",
+    description: "Shortlink manager for custom domains and click tracking, with local SQLite or self-hosted cloud (/v1 API + bearer key) storage and Cloudflare setup helpers",
     type: "module",
     main: "dist/index.js",
     types: "dist/index.d.ts",
@@ -4970,10 +4970,6 @@ var require_package = __commonJS((exports, module) => {
         types: "./dist/pg-store.d.ts",
         import: "./dist/pg-store.js"
       },
-      "./runtime": {
-        types: "./dist/runtime.d.ts",
-        import: "./dist/runtime.js"
-      },
       "./sdk": {
         types: "./dist/sdk/index.d.ts",
         import: "./dist/sdk/index.js"
@@ -4988,7 +4984,7 @@ var require_package = __commonJS((exports, module) => {
       "SECURITY.md"
     ],
     scripts: {
-      build: "rm -rf dist && bun build src/cli/index.ts src/mcp/index.ts src/serve/index.ts src/sdk/index.ts src/index.ts src/server.ts src/cloudflare.ts src/runtime.ts src/pg-store.ts --root src --outdir dist --target bun --external @modelcontextprotocol/sdk && tsc -p tsconfig.build.json --emitDeclarationOnly --outDir dist",
+      build: "rm -rf dist && bun build src/cli/index.ts src/mcp/index.ts src/serve/index.ts src/sdk/index.ts src/index.ts src/server.ts src/cloudflare.ts src/pg-store.ts --root src --outdir dist --target bun --external @modelcontextprotocol/sdk && tsc -p tsconfig.build.json --emitDeclarationOnly --outDir dist",
       "sdk:generate": "bun run scripts/generate-sdk.ts",
       typecheck: "tsc --noEmit",
       test: "bun test",
@@ -5027,7 +5023,6 @@ var require_package = __commonJS((exports, module) => {
     author: "Andrei Hasna <andrei@hasna.com>",
     license: "Apache-2.0",
     dependencies: {
-      "@hasna/contracts": "0.4.1",
       "@hasna/events": "^0.1.6",
       "@modelcontextprotocol/sdk": "^1.27.1",
       chalk: "^5.4.1",
@@ -5036,6 +5031,7 @@ var require_package = __commonJS((exports, module) => {
       pg: "^8.13.3"
     },
     devDependencies: {
+      "@hasna/contracts": "^0.5.2",
       "@types/pg": "^8.11.11",
       "@types/bun": "^1.2.4",
       typescript: "^5.7.3"
@@ -5043,170 +5039,6 @@ var require_package = __commonJS((exports, module) => {
   };
 });
 
-// src/runtime.ts
-var SHORTLINKS_RUNTIME_ENV = {
-  store: "HASNA_SHORTLINKS_STORE",
-  databaseUrl: "HASNA_SHORTLINKS_DATABASE_URL",
-  databaseSsl: "HASNA_SHORTLINKS_DATABASE_SSL"
-};
-var SHORTLINKS_RUNTIME_FALLBACK_ENV = {
-  store: "SHORTLINKS_STORE",
-  databaseUrl: "SHORTLINKS_DATABASE_URL",
-  databaseSsl: "SHORTLINKS_DATABASE_SSL"
-};
-var CANONICAL_SHORTLINKS_POSTGRES_CLUSTER = "hasna-xyz-infra-apps-prod-postgres";
-var CANONICAL_SHORTLINKS_POSTGRES_DATABASE = "shortlinks";
-var CANONICAL_SHORTLINKS_RUNTIME_SECRET_PATH = "hasna/xyz/opensource/shortlinks/prod/postgres";
-function getCanonicalShortlinksPostgresConfig() {
-  return {
-    cluster: CANONICAL_SHORTLINKS_POSTGRES_CLUSTER,
-    database: CANONICAL_SHORTLINKS_POSTGRES_DATABASE,
-    runtimeSecretPath: CANONICAL_SHORTLINKS_RUNTIME_SECRET_PATH,
-    primaryEnv: SHORTLINKS_RUNTIME_ENV.databaseUrl,
-    fallbackEnv: SHORTLINKS_RUNTIME_FALLBACK_ENV.databaseUrl
-  };
-}
-function parseShortlinksStoreMode(value) {
-  const normalized = clean(value)?.toLowerCase();
-  if (!normalized)
-    return "local";
-  if (normalized === "local" || normalized === "postgres")
-    return normalized;
-  if (normalized === "pg")
-    return "postgres";
-  throw new Error(`${SHORTLINKS_RUNTIME_ENV.store} must be local or postgres`);
-}
-function getShortlinksStoreMode(env = process.env) {
-  return parseShortlinksStoreMode(readRuntimeEnv(env, "store").value);
-}
-function getShortlinksDatabaseUrl(env = process.env) {
-  return readRuntimeEnv(env, "databaseUrl").value;
-}
-function getShortlinksDatabaseSsl(env = process.env) {
-  return parseBoolean(readRuntimeEnv(env, "databaseSsl").value, true);
-}
-function getShortlinksRuntimeEnvName(env, key) {
-  const primary = SHORTLINKS_RUNTIME_ENV[key];
-  if (clean(env[primary]))
-    return primary;
-  return SHORTLINKS_RUNTIME_FALLBACK_ENV[key];
-}
-function loadShortlinksRuntimeConfig(env = process.env) {
-  const mode = getShortlinksStoreMode(env);
-  const databaseUrl = getShortlinksDatabaseUrl(env);
-  return {
-    service: "shortlinks",
-    mode,
-    ...databaseUrl ? {
-      database: {
-        provider: "postgres",
-        url: databaseUrl,
-        ssl: getShortlinksDatabaseSsl(env)
-      }
-    } : {}
-  };
-}
-function assertShortlinksPostgresConfig(config) {
-  if (config.mode !== "postgres")
-    return;
-  if (!config.database?.url) {
-    throw new Error(`${SHORTLINKS_RUNTIME_ENV.databaseUrl} is required when ${SHORTLINKS_RUNTIME_ENV.store}=postgres`);
-  }
-}
-function getShortlinksRuntimeStatus(env = process.env) {
-  const issues = [];
-  const warnings = [];
-  let config;
-  try {
-    config = loadShortlinksRuntimeConfig(env);
-  } catch (error) {
-    issues.push(error instanceof Error ? error.message : String(error));
-    config = { service: "shortlinks", mode: "local" };
-  }
-  try {
-    assertShortlinksPostgresConfig(config);
-  } catch (error) {
-    issues.push(error instanceof Error ? error.message : String(error));
-  }
-  if (config.mode === "local" && config.database?.url) {
-    warnings.push(`${SHORTLINKS_RUNTIME_ENV.store}=local ignores configured Postgres database settings`);
-  }
-  return {
-    ok: issues.length === 0,
-    service: "shortlinks",
-    mode: config.mode,
-    local_default: config.mode === "local",
-    postgres_enabled: config.mode === "postgres",
-    database: {
-      configured: Boolean(config.database?.url),
-      provider: config.database?.provider ?? null,
-      redacted_url: redactDatabaseUrl(config.database?.url),
-      ssl: config.database?.ssl ?? null
-    },
-    env: runtimeEnvStatus(env),
-    canonical: getCanonicalShortlinksPostgresConfig(),
-    issues,
-    warnings,
-    no_network: true
-  };
-}
-function redactDatabaseUrl(value) {
-  if (!value)
-    return null;
-  try {
-    const url = new URL(value);
-    if (url.username)
-      url.username = "***";
-    if (url.password)
-      url.password = "***";
-    for (const key of Array.from(url.searchParams.keys())) {
-      if (isSensitiveQueryKey(key))
-        url.searchParams.set(key, "***");
-    }
-    return url.toString();
-  } catch {
-    return "(redacted)";
-  }
-}
-function runtimeEnvStatus(env) {
-  return Object.fromEntries(Object.entries(SHORTLINKS_RUNTIME_ENV).map(([key, name]) => {
-    const activeName = getShortlinksRuntimeEnvName(env, key);
-    return [
-      key,
-      {
-        name,
-        active_name: activeName,
-        configured: Boolean(clean(env[activeName]))
-      }
-    ];
-  }));
-}
-function readRuntimeEnv(env, key) {
-  const primary = SHORTLINKS_RUNTIME_ENV[key];
-  const primaryValue = clean(env[primary]);
-  if (primaryValue)
-    return { name: primary, value: primaryValue };
-  const fallback = SHORTLINKS_RUNTIME_FALLBACK_ENV[key];
-  return { name: fallback, value: clean(env[fallback]) };
-}
-function parseBoolean(value, fallback) {
-  const normalized = clean(value)?.toLowerCase();
-  if (!normalized)
-    return fallback;
-  if (["1", "true", "yes", "on"].includes(normalized))
-    return true;
-  if (["0", "false", "no", "off"].includes(normalized))
-    return false;
-  throw new Error(`${SHORTLINKS_RUNTIME_ENV.databaseSsl} must be true or false`);
-}
-function isSensitiveQueryKey(key) {
-  return /(?:^|[_-])(pass(?:word)?|pwd|secret|token|credential|auth|api[_-]?key|access[_-]?key)(?:$|[_-])/i.test(key);
-}
-function clean(value) {
-  const trimmed = value?.trim();
-  return trimmed ? trimmed : undefined;
-}
-
 // src/pg-store.ts
 import { createHash } from "crypto";
 
@@ -5508,47 +5340,10 @@ function parseJsonObject(value) {
     return {};
   }
 }
-async function loadPgPool() {
-  const importer = new Function("specifier", "return import(specifier)");
-  const module = await importer("pg");
-  return module.Pool;
-}
 function toPostgresSql(sql) {
   let index = 0;
   return sql.replace(/\?/g, () => `$${++index}`);
 }
-function createPgPoolConfig(connectionString, options = {}) {
-  const ssl = options.ssl ?? true;
-  return {
-    connectionString,
-    ...ssl ? { ssl: { rejectUnauthorized: true } } : { ssl: false }
-  };
-}
-
-class PgPoolAdapter {
-  pool;
-  constructor(pool) {
-    this.pool = pool;
-  }
-  static async create(connectionString, options = {}) {
-    const Pool = await loadPgPool();
-    return new PgPoolAdapter(new Pool(createPgPoolConfig(connectionString, options)));
-  }
-  async get(sql, ...params) {
-    const result = await this.pool.query(toPostgresSql(sql), params);
-    return result.rows[0] ?? null;
-  }
-  async all(sql, ...params) {
-    const result = await this.pool.query(toPostgresSql(sql), params);
-    return result.rows;
-  }
-  async run(sql, ...params) {
-    return this.pool.query(toPostgresSql(sql), params);
-  }
-  async close() {
-    await this.pool.end();
-  }
-}
 function toIsoString(value) {
   if (value instanceof Date)
     return value.toISOString();
@@ -5630,19 +5425,9 @@ class PgShortlinksStore {
   constructor(pg) {
     this.pg = pg;
   }
-  static async fromConnectionString(connectionString, options = {}) {
-    return new PgShortlinksStore(await PgPoolAdapter.create(connectionString, options));
-  }
   static fromQueryClient(client) {
     return new PgShortlinksStore(createKitPgAdapter(client));
   }
-  static async fromEnv(env = process.env) {
-    const connectionString = getShortlinksDatabaseUrl(env);
-    if (!connectionString) {
-      throw new Error("HASNA_SHORTLINKS_DATABASE_URL is required when shortlinks uses the postgres store");
-    }
-    return PgShortlinksStore.fromConnectionString(connectionString, { ssl: getShortlinksDatabaseSsl(env) });
-  }
   async close() {
     await this.pg.close?.();
   }
@@ -5696,6 +5481,13 @@ class PgShortlinksStore {
     `);
     return row ? domainFromRow(row) : null;
   }
+  async deleteDomain(hostnameOrId) {
+    const domain = await this.getDomain(hostnameOrId);
+    if (!domain)
+      throw new Error("Domain not found.");
+    await this.pg.run("DELETE FROM domains WHERE id = ?", domain.id);
+    return domain;
+  }
   async createLink(input) {
     const domain = input.domain ? await this.getDomain(input.domain) : await this.getDefaultDomain();
     if (!domain) {
@@ -5871,52 +5663,6 @@ class PgShortlinksStore {
     throw new Error("Could not generate an unused slug after 32 attempts.");
   }
 }
-async function applyPostgresMigrations(connectionString, migrations, options = {}) {
-  const Pool = await loadPgPool();
-  const pool = new Pool(createPgPoolConfig(connectionString, options));
-  const client = await pool.connect();
-  const run = (sql, ...params) => client.query(toPostgresSql(sql), params);
-  const get = async (sql, ...params) => {
-    const result = await run(sql, ...params);
-    return result.rows[0] ?? null;
-  };
-  const applied = [];
-  const skipped = [];
-  try {
-    await run("BEGIN");
-    await run(`
-      SELECT pg_advisory_xact_lock(hashtext(?))
-    `, "shortlinks:migrations");
-    await run(`
-      CREATE TABLE IF NOT EXISTS _shortlinks_migrations (
-        id INTEGER PRIMARY KEY,
-        service TEXT NOT NULL DEFAULT 'shortlinks',
-        applied_at TIMESTAMPTZ NOT NULL DEFAULT now()
-      )
-    `);
-    for (let i = 0;i < migrations.length; i += 1) {
-      const id = i + 1;
-      const existing = await get("SELECT id FROM _shortlinks_migrations WHERE id = ? LIMIT 1", id);
-      if (existing) {
-        skipped.push(id);
-        continue;
-      }
-      await run(migrations[i]);
-      await run("INSERT INTO _shortlinks_migrations (id, service, applied_at) VALUES (?, ?, now())", id, "shortlinks");
-      applied.push(id);
-    }
-    await run("COMMIT");
-    return { service: "shortlinks", applied, skipped };
-  } catch (error) {
-    try {
-      await run("ROLLBACK");
-    } catch {}
-    throw error;
-  } finally {
-    client.release();
-    await pool.end();
-  }
-}
 
 // node_modules/.pnpm/pg@8.22.0/node_modules/pg/esm/index.mjs
 var import_lib = __toESM(require_lib2(), 1);
@@ -6241,7 +5987,7 @@ class MigrationLedger {
   }
 }
 
-// node_modules/.pnpm/@hasna+contracts@0.4.1/node_modules/@hasna/contracts/dist/auth/index.js
+// node_modules/.pnpm/@hasna+contracts@0.5.2/node_modules/@hasna/contracts/dist/auth/index.js
 import { createHash as createHash3, createHmac, randomBytes as randomBytes3, timingSafeEqual } from "crypto";
 var API_KEY_TOKEN_VERSION = 1;
 var API_KEY_NAMESPACE = "hasna";
@@ -8362,6 +8108,11 @@ function buildOpenApiDocument(version) {
           properties: { deleted: { type: "boolean" }, slug: { type: "string" } },
           required: ["deleted"]
         },
+        DomainDeleteResponse: {
+          type: "object",
+          properties: { deleted: { type: "boolean" }, hostname: { type: "string" } },
+          required: ["deleted"]
+        },
         HealthStatus: probe({ db_latency_ms: { type: "integer" } }),
         ReadyStatus: probe({ pending_migrations: { type: "array", items: { type: "string" } } }),
         VersionInfo: probe({ name: { type: "string" } }),
@@ -8432,6 +8183,19 @@ function buildOpenApiDocument(version) {
           }
         }
       },
+      "/v1/domains/{hostname}": {
+        delete: {
+          operationId: "deleteDomain",
+          summary: "Delete a domain and all of its links and clicks.",
+          security: [{ apiKey: [] }],
+          parameters: [
+            { name: "hostname", in: "path", required: true, schema: { type: "string" } }
+          ],
+          responses: {
+            "200": { content: { "application/json": { schema: { $ref: "#/components/schemas/DomainDeleteResponse" } } } }
+          }
+        }
+      },
       "/v1/links": {
         get: {
           operationId: "listLinks",
@@ -8633,6 +8397,18 @@ function createServeApp(deps) {
       return handleError(c, error);
     }
   });
+  app.delete("/v1/domains/:hostname", async (c) => {
+    const denied = await requireScopes(c, [`${APP_SLUG}:write`]);
+    if (denied)
+      return denied;
+    const hostname2 = c.req.param("hostname");
+    try {
+      const domain = await store.deleteDomain(hostname2);
+      return c.json({ deleted: true, hostname: domain.hostname });
+    } catch (error) {
+      return handleError(c, error);
+    }
+  });
   app.get("/v1/links", async (c) => {
     const denied = await requireScopes(c, [`${APP_SLUG}:read`]);
     if (denied)

package/dist/server.js

@@ -430,6 +430,17 @@ class ShortlinksStore {
     `).get(normalized, hostnameOrId);
     return row ? domainFromRow(row) : null;
   }
+  deleteDomain(hostnameOrId) {
+    const domain = this.getDomain(hostnameOrId);
+    if (!domain)
+      throw new Error("Domain not found.");
+    this.database.db.query("DELETE FROM domains WHERE id = ?").run(domain.id);
+    const config = loadConfig();
+    if (config.defaultDomain && normalizeHostname(config.defaultDomain) === domain.hostname) {
+      updateConfig({ defaultDomain: undefined, publicBaseUrl: undefined });
+    }
+    return domain;
+  }
   getDefaultDomain() {
     const config = loadConfig();
     if (config.defaultDomain) {

package/dist/store-interface.d.ts

@@ -0,0 +1,42 @@
+import type { AddDomainInput, Click, ClickInput, CreateLinkInput, Domain, Link, LinkStats } from "./types.js";
+export interface ListLinksOptions {
+    domain?: string;
+    activeOnly?: boolean;
+    limit?: number;
+}
+export interface TotalStats {
+    domains: number;
+    links: number;
+    clicks: number;
+}
+/**
+ * The single storage surface shared by LocalStore and ApiStore. All methods are
+ * async so one call site works against either transport with no mode branching.
+ */
+export interface Store {
+    /** Which transport backs this store (for banners/diagnostics only). */
+    readonly kind: "local" | "cloud-http";
+    addDomain(input: AddDomainInput): Promise<Domain>;
+    listDomains(): Promise<Domain[]>;
+    getDomain(hostnameOrId: string): Promise<Domain | null>;
+    getDefaultDomain(): Promise<Domain | null>;
+    /**
+     * Delete a domain (by hostname or id) and, via ON DELETE CASCADE, all of its
+     * links and clicks. Returns the deleted domain. Throws when not found.
+     */
+    deleteDomain(hostnameOrId: string): Promise<Domain>;
+    createLink(input: CreateLinkInput): Promise<Link>;
+    listLinks(options?: ListLinksOptions): Promise<Link[]>;
+    getLink(domainOrSlug: string, maybeSlug?: string): Promise<Link | null>;
+    resolve(hostname: string, slug: string): Promise<Link | null>;
+    setLinkActive(domainOrSlug: string, slugOrActive: string | boolean, active?: boolean): Promise<Link>;
+    deleteLink(domainOrSlug: string, maybeSlug?: string): Promise<Link>;
+    /**
+     * Record a click. Only the on-box redirect server does this against a LocalStore;
+     * the cloud API records clicks server-side, so ApiStore rejects this call.
+     */
+    recordClick(link: Link, input?: ClickInput): Promise<Click>;
+    getStats(domainOrSlug: string, maybeSlug?: string): Promise<LinkStats>;
+    totalStats(): Promise<TotalStats>;
+    close(): Promise<void>;
+}

package/dist/store.d.ts

@@ -7,6 +7,7 @@ export declare class ShortlinksStore {
     addDomain(input: AddDomainInput): Domain;
     listDomains(): Domain[];
     getDomain(hostnameOrId: string): Domain | null;
+    deleteDomain(hostnameOrId: string): Domain;
     getDefaultDomain(): Domain | null;
     createLink(input: CreateLinkInput): Link;
     listLinks(options?: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hasna/shortlinks",
-  "version": "0.1.24",
-  "description": "CLI-only shortlink manager for custom domains, click tracking, Cloudflare setup, and app-owned Postgres runtime support",
+  "version": "0.2.1",
+  "description": "Shortlink manager for custom domains and click tracking, with local SQLite or self-hosted cloud (/v1 API + bearer key) storage and Cloudflare setup helpers",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,10 +27,6 @@
       "types": "./dist/pg-store.d.ts",
       "import": "./dist/pg-store.js"
     },
-    "./runtime": {
-      "types": "./dist/runtime.d.ts",
-      "import": "./dist/runtime.js"
-    },
     "./sdk": {
       "types": "./dist/sdk/index.d.ts",
       "import": "./dist/sdk/index.js"
@@ -45,7 +41,7 @@
     "SECURITY.md"
   ],
   "scripts": {
-    "build": "rm -rf dist && bun build src/cli/index.ts src/mcp/index.ts src/serve/index.ts src/sdk/index.ts src/index.ts src/server.ts src/cloudflare.ts src/runtime.ts src/pg-store.ts --root src --outdir dist --target bun --external @modelcontextprotocol/sdk && tsc -p tsconfig.build.json --emitDeclarationOnly --outDir dist",
+    "build": "rm -rf dist && bun build src/cli/index.ts src/mcp/index.ts src/serve/index.ts src/sdk/index.ts src/index.ts src/server.ts src/cloudflare.ts src/pg-store.ts --root src --outdir dist --target bun --external @modelcontextprotocol/sdk && tsc -p tsconfig.build.json --emitDeclarationOnly --outDir dist",
     "sdk:generate": "bun run scripts/generate-sdk.ts",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
@@ -84,7 +80,6 @@
   "author": "Andrei Hasna <andrei@hasna.com>",
   "license": "Apache-2.0",
   "dependencies": {
-    "@hasna/contracts": "0.4.1",
     "@hasna/events": "^0.1.6",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "chalk": "^5.4.1",
@@ -93,6 +88,7 @@
     "pg": "^8.13.3"
   },
   "devDependencies": {
+    "@hasna/contracts": "^0.5.2",
     "@types/pg": "^8.11.11",
     "@types/bun": "^1.2.4",
     "typescript": "^5.7.3"

package/dist/pg-migrations.d.ts

@@ -1 +0,0 @@
-export declare const PG_MIGRATIONS: string[];

package/dist/runtime.d.ts

@@ -1,65 +0,0 @@
-export type ShortlinksStoreMode = "local" | "postgres";
-export type ShortlinksRuntimeEnv = Record<string, string | undefined>;
-export interface ShortlinksPostgresConfig {
-    provider: "postgres";
-    url: string;
-    ssl: boolean;
-}
-export interface ShortlinksRuntimeConfig {
-    service: "shortlinks";
-    mode: ShortlinksStoreMode;
-    database?: ShortlinksPostgresConfig;
-}
-export declare const SHORTLINKS_RUNTIME_ENV: {
-    readonly store: "HASNA_SHORTLINKS_STORE";
-    readonly databaseUrl: "HASNA_SHORTLINKS_DATABASE_URL";
-    readonly databaseSsl: "HASNA_SHORTLINKS_DATABASE_SSL";
-};
-export declare const SHORTLINKS_RUNTIME_FALLBACK_ENV: {
-    readonly store: "SHORTLINKS_STORE";
-    readonly databaseUrl: "SHORTLINKS_DATABASE_URL";
-    readonly databaseSsl: "SHORTLINKS_DATABASE_SSL";
-};
-export declare const CANONICAL_SHORTLINKS_POSTGRES_CLUSTER = "hasna-xyz-infra-apps-prod-postgres";
-export declare const CANONICAL_SHORTLINKS_POSTGRES_DATABASE = "shortlinks";
-export declare const CANONICAL_SHORTLINKS_RUNTIME_SECRET_PATH = "hasna/xyz/opensource/shortlinks/prod/postgres";
-export interface CanonicalShortlinksPostgresConfig {
-    cluster: typeof CANONICAL_SHORTLINKS_POSTGRES_CLUSTER;
-    database: typeof CANONICAL_SHORTLINKS_POSTGRES_DATABASE;
-    runtimeSecretPath: typeof CANONICAL_SHORTLINKS_RUNTIME_SECRET_PATH;
-    primaryEnv: typeof SHORTLINKS_RUNTIME_ENV.databaseUrl;
-    fallbackEnv: typeof SHORTLINKS_RUNTIME_FALLBACK_ENV.databaseUrl;
-}
-export interface RuntimeEnvStatus {
-    name: string;
-    active_name: string;
-    configured: boolean;
-}
-export interface ShortlinksRuntimeStatus {
-    ok: boolean;
-    service: "shortlinks";
-    mode: ShortlinksStoreMode;
-    local_default: boolean;
-    postgres_enabled: boolean;
-    database: {
-        configured: boolean;
-        provider: "postgres" | null;
-        redacted_url: string | null;
-        ssl: boolean | null;
-    };
-    env: Record<keyof typeof SHORTLINKS_RUNTIME_ENV, RuntimeEnvStatus>;
-    canonical: CanonicalShortlinksPostgresConfig;
-    issues: string[];
-    warnings: string[];
-    no_network: true;
-}
-export declare function getCanonicalShortlinksPostgresConfig(): CanonicalShortlinksPostgresConfig;
-export declare function parseShortlinksStoreMode(value: string | undefined): ShortlinksStoreMode;
-export declare function getShortlinksStoreMode(env?: ShortlinksRuntimeEnv): ShortlinksStoreMode;
-export declare function getShortlinksDatabaseUrl(env?: ShortlinksRuntimeEnv): string | undefined;
-export declare function getShortlinksDatabaseSsl(env?: ShortlinksRuntimeEnv): boolean;
-export declare function getShortlinksRuntimeEnvName(env: ShortlinksRuntimeEnv, key: keyof typeof SHORTLINKS_RUNTIME_ENV): string;
-export declare function loadShortlinksRuntimeConfig(env?: ShortlinksRuntimeEnv): ShortlinksRuntimeConfig;
-export declare function assertShortlinksPostgresConfig(config: ShortlinksRuntimeConfig): void;
-export declare function getShortlinksRuntimeStatus(env?: ShortlinksRuntimeEnv): ShortlinksRuntimeStatus;
-export declare function redactDatabaseUrl(value: string | undefined): string | null;