@hasna/recordings 0.2.14 → 0.3.2

package/dist/server/index.js

@@ -18,7 +18,7 @@ var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // src/version.ts
-var VERSION = "0.2.14";
+var VERSION = "0.3.2";
 
 // src/db/remote-storage.ts
 import pg from "pg";
@@ -82,29 +82,84 @@ class PgAdapterAsync {
 }
 var init_remote_storage = () => {};
 
+// src/lib/retired-deployment-modes.ts
+function normalizeModeToken(value) {
+  return value.trim().toLowerCase().replace(/-/g, "_");
+}
+function asRetiredDeploymentMode(value) {
+  const token = normalizeModeToken(value);
+  return RETIRED_DEPLOYMENT_MODES.includes(token) ? token : null;
+}
+function retiredDeploymentModeError(rawValue, sourceEnvKey, replacement) {
+  const mode = asRetiredDeploymentMode(rawValue);
+  const value = mode === "local" ? replacement.onBox : replacement.offBox;
+  return new Error(`${sourceEnvKey}=${rawValue} names a deployment mode, and deployment modes are removed: ` + `${RETIRED_DEPLOYMENT_MODES.join(" | ")} no longer select anything. ` + `Set ${replacement.envKey}=${value} instead ` + `(${replacement.envKey} takes ${replacement.onBox} or ${replacement.offBox}).`);
+}
+var RETIRED_DEPLOYMENT_MODES;
+var init_retired_deployment_modes = __esm(() => {
+  RETIRED_DEPLOYMENT_MODES = [
+    "local",
+    "self_hosted",
+    "cloud",
+    "remote",
+    "hybrid"
+  ];
+});
+
 // src/server/cloud-config.ts
+function backendReplacement() {
+  return { envKey: DATA_BACKEND_ENV_KEYS[0], onBox: "sqlite", offBox: "postgresql" };
+}
 function resolveCloudDatabaseUrl(env = process.env) {
   return env.HASNA_RECORDINGS_DATABASE_URL || env.RECORDINGS_DATABASE_URL || env.DATABASE_URL || undefined;
 }
+function configuredDataBackend(env = process.env) {
+  for (const key of DATA_BACKEND_ENV_KEYS) {
+    const raw = env[key]?.trim();
+    if (!raw)
+      continue;
+    const token = normalizeModeToken(raw);
+    if (token === "sqlite")
+      return { backend: "sqlite", source: key };
+    if (token === "postgresql" || token === "postgres")
+      return { backend: "postgresql", source: key };
+    if (asRetiredDeploymentMode(raw)) {
+      throw retiredDeploymentModeError(raw, key, backendReplacement());
+    }
+    throw new Error(`${key}=${raw} is not a data backend. Use ${DATA_BACKEND_ENV_KEYS[0]}=sqlite or ` + `${DATA_BACKEND_ENV_KEYS[0]}=postgresql.`);
+  }
+  return null;
+}
+function resolveDataBackend(env = process.env) {
+  const configured = configuredDataBackend(env);
+  if (configured)
+    return configured.backend;
+  return resolveCloudDatabaseUrl(env) ? "postgresql" : "sqlite";
+}
+function isPostgresBackendEnabled(env = process.env) {
+  return resolveDataBackend(env) === "postgresql";
+}
 function resolveSigningSecret(env = process.env) {
   return env.HASNA_RECORDINGS_API_SIGNING_KEY || env.HASNA_API_SIGNING_KEY || env.API_KEY_SIGNING_SECRET || undefined;
 }
 function requireSigningSecret(env = process.env) {
   const signingSecret = resolveSigningSecret(env);
   if (!signingSecret) {
-    throw new Error("Cloud /v1 auth requires a signing secret (HASNA_RECORDINGS_API_SIGNING_KEY / HASNA_API_SIGNING_KEY / API_KEY_SIGNING_SECRET).");
+    throw new Error("The /v1 API requires a signing secret (HASNA_RECORDINGS_API_SIGNING_KEY / HASNA_API_SIGNING_KEY / API_KEY_SIGNING_SECRET).");
   }
   if (Buffer.byteLength(signingSecret, "utf8") < 16) {
-    throw new Error("Cloud /v1 auth signing secret must be at least 16 bytes.");
+    throw new Error("The /v1 API signing secret must be at least 16 bytes.");
   }
   return signingSecret;
 }
-function isCloudModeEnabled(env = process.env) {
-  const mode = (env.HASNA_RECORDINGS_STORAGE_MODE || env.RECORDINGS_STORAGE_MODE || "").toLowerCase();
-  if (mode === "remote" || mode === "hybrid")
-    return true;
-  return Boolean(resolveCloudDatabaseUrl(env));
-}
+var DATA_BACKEND_ENV_KEYS;
+var init_cloud_config = __esm(() => {
+  init_retired_deployment_modes();
+  DATA_BACKEND_ENV_KEYS = [
+    "HASNA_RECORDINGS_STORAGE_MODE",
+    "RECORDINGS_STORAGE_MODE"
+  ];
+});
 
 // src/server/cloud-readiness.ts
 var exports_cloud_readiness = {};
@@ -145,7 +200,11 @@ async function assertCloudSchemaContract(pg2) {
     }
   }
   const idempotencyColumns = columns.filter((column) => column.table_name === "recording_idempotency");
-  const expectedIdempotencyColumns = Object.keys(REQUIRED_COLUMNS.recording_idempotency);
+  const expectedIdempotencySpec = REQUIRED_COLUMNS.recording_idempotency;
+  if (expectedIdempotencySpec === undefined) {
+    throw new Error("cloud schema contract is missing recording_idempotency");
+  }
+  const expectedIdempotencyColumns = Object.keys(expectedIdempotencySpec);
   const unexpectedIdempotencyColumn = idempotencyColumns.find((column) => !expectedIdempotencyColumns.includes(column.column_name));
   if (unexpectedIdempotencyColumn) {
     throw new Error(`cloud schema has unexpected column: recording_idempotency.${unexpectedIdempotencyColumn.column_name}`);
@@ -590,7 +649,11 @@ async function applyRecordedCloudMigrations(pg2, ensureApiKeySchema) {
   for (let version = 0;version < PG_MIGRATIONS.length; version++) {
     if (appliedSet.has(version))
       continue;
-    await pg2.exec(PG_MIGRATIONS[version]);
+    const migration = PG_MIGRATIONS[version];
+    if (migration === undefined) {
+      throw new Error(`Missing PostgreSQL migration at version ${version}`);
+    }
+    await pg2.exec(migration);
     await pg2.run("INSERT INTO _pg_migrations (version) VALUES (?) ON CONFLICT DO NOTHING", version);
   }
   await ensureApiKeySchema();
@@ -608,16 +671,18 @@ var init_migrate_command = __esm(() => {
 var exports_cloud = {};
 __export(exports_cloud, {
   resolveSigningSecret: () => resolveSigningSecret,
+  resolveDataBackend: () => resolveDataBackend,
   resolveCloudDatabaseUrl: () => resolveCloudDatabaseUrl,
   requireSigningSecret: () => requireSigningSecret,
   pingCloudConnectivity: () => pingCloudConnectivity2,
   pingCloud: () => pingCloud,
   migrateCloudSchema: () => migrateCloudSchema,
-  isCloudModeEnabled: () => isCloudModeEnabled,
+  isPostgresBackendEnabled: () => isPostgresBackendEnabled,
   getCloudVerifier: () => getCloudVerifier,
   getCloudPg: () => getCloudPg,
   getApiKeyStore: () => getApiKeyStore,
   ensureCloudSchema: () => ensureCloudSchema,
+  configuredDataBackend: () => configuredDataBackend,
   closeCloud: () => closeCloud,
   RECORDINGS_APP_SLUG: () => RECORDINGS_APP_SLUG
 });
@@ -628,7 +693,7 @@ function getCloudPg() {
     return cachedPg;
   const url = resolveCloudDatabaseUrl();
   if (!url) {
-    throw new Error("Cloud /v1 requires a remote database URL (HASNA_RECORDINGS_DATABASE_URL / RECORDINGS_DATABASE_URL / DATABASE_URL).");
+    throw new Error("The /v1 API requires a PostgreSQL database URL (HASNA_RECORDINGS_DATABASE_URL / RECORDINGS_DATABASE_URL / DATABASE_URL).");
   }
   cachedPg = new PgAdapterAsync(url);
   return cachedPg;
@@ -694,8 +759,10 @@ async function closeCloud() {
 var RECORDINGS_APP_SLUG = "recordings", cachedPg = null, cachedStore = null, cachedVerifier = null, schemaEnsured = null;
 var init_cloud = __esm(() => {
   init_remote_storage();
+  init_cloud_config();
   init_cloud_readiness();
   init_migrate_command();
+  init_cloud_config();
 });
 
 // src/db/errors.ts
@@ -1712,7 +1779,7 @@ function startMcpHttpServer(options) {
 var DEFAULT_MCP_HTTP_PORT = 8873, MCP_HTTP_HOST = "127.0.0.1";
 var init_http = () => {};
 
-// node_modules/zod/v3/helpers/util.js
+// ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/helpers/util.js
 var util, objectUtil, ZodParsedType, getParsedType = (data) => {
   const t = typeof data;
   switch (t) {
@@ -1843,7 +1910,7 @@ var init_util = __esm(() => {
   ]);
 });
 
-// node_modules/zod/v3/ZodError.js
+// ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/ZodError.js
 var ZodIssueCode, quotelessJson = (obj) => {
   const json2 = JSON.stringify(obj, null, 2);
   return json2.replace(/"([^"]+)":/g, "$1:");
@@ -1964,7 +2031,7 @@ var init_ZodError = __esm(() => {
   };
 });
 
-// node_modules/zod/v3/locales/en.js
+// ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/locales/en.js
 var errorMap = (issue, _ctx) => {
   let message;
   switch (issue.code) {
@@ -2071,7 +2138,7 @@ var init_en = __esm(() => {
   en_default = errorMap;
 });
 
-// node_modules/zod/v3/errors.js
+// ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/errors.js
 function setErrorMap(map) {
   overrideErrorMap = map;
 }
@@ -2084,7 +2151,7 @@ var init_errors2 = __esm(() => {
   overrideErrorMap = en_default;
 });
 
-// node_modules/zod/v3/helpers/parseUtil.js
+// ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 function addIssueToContext(ctx, issueData) {
   const overrideMap = getErrorMap();
   const issue = makeIssue({
@@ -2189,10 +2256,10 @@ var init_parseUtil = __esm(() => {
   });
 });
 
-// node_modules/zod/v3/helpers/typeAliases.js
+// ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/helpers/typeAliases.js
 var init_typeAliases = () => {};
 
-// node_modules/zod/v3/helpers/errorUtil.js
+// ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/helpers/errorUtil.js
 var errorUtil;
 var init_errorUtil = __esm(() => {
   (function(errorUtil2) {
@@ -2201,7 +2268,7 @@ var init_errorUtil = __esm(() => {
   })(errorUtil || (errorUtil = {}));
 });
 
-// node_modules/zod/v3/types.js
+// ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/types.js
 class ParseInputLazyPath {
   constructor(parent, value, path, key) {
     this._cachedPath = [];
@@ -5552,7 +5619,7 @@ var init_types = __esm(() => {
   NEVER = INVALID;
 });
 
-// node_modules/zod/v3/external.js
+// ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/external.js
 var exports_external = {};
 __export(exports_external, {
   void: () => voidType,
@@ -5672,7 +5739,7 @@ var init_external = __esm(() => {
   init_ZodError();
 });
 
-// node_modules/zod/index.js
+// ../../node_modules/.bun/zod@3.25.76/node_modules/zod/index.js
 var init_zod = __esm(() => {
   init_external();
   init_external();
@@ -6059,7 +6126,8 @@ function findProjectRecordingsPath(entry) {
 function findRepositoryRoot(start) {
   let dir = start;
   while (true) {
-    if (existsSync(join2(dir, ".git")))
+    const gitPath = join2(dir, ".git");
+    if (isRepositoryMarker(gitPath))
       return dir;
     const parent = dirname2(dir);
     if (parent === dir)
@@ -6067,6 +6135,15 @@ function findRepositoryRoot(start) {
     dir = parent;
   }
 }
+function isRepositoryMarker(gitPath) {
+  try {
+    if (statSync(gitPath).isFile())
+      return true;
+    return existsSync(join2(gitPath, "HEAD"));
+  } catch {
+    return false;
+  }
+}
 function canonicalExistingPath(path) {
   try {
     return realpathSync2(path);
@@ -6095,14 +6172,17 @@ function loadSecretKey(keyName) {
     try {
       const content = readFileSync(candidate, "utf-8");
       const match = content.match(new RegExp(`export\\s+${keyName}\\s*=\\s*"([^"]+)"`));
-      if (match)
-        return match[1];
+      const doubleQuotedValue = match?.[1];
+      if (doubleQuotedValue !== undefined)
+        return doubleQuotedValue;
       const match2 = content.match(new RegExp(`export\\s+${keyName}\\s*=\\s*'([^']+)'`));
-      if (match2)
-        return match2[1];
+      const singleQuotedValue = match2?.[1];
+      if (singleQuotedValue !== undefined)
+        return singleQuotedValue;
       const match3 = content.match(new RegExp(`${keyName}\\s*=\\s*(.+)`));
-      if (match3)
-        return match3[1].trim().replace(/^["']|["']$/g, "");
+      const unquotedValue = match3?.[1];
+      if (unquotedValue !== undefined)
+        return unquotedValue.trim().replace(/^["']|["']$/g, "");
     } catch {}
   }
   return "";
@@ -6247,7 +6327,11 @@ function runMigrations(db) {
   const currentLevel = result?.max_id ?? -1;
   for (let i = currentLevel + 1;i < MIGRATIONS.length; i++) {
     try {
-      db.run(MIGRATIONS[i]);
+      const migration = MIGRATIONS[i];
+      if (migration === undefined) {
+        throw new Error(`Missing SQLite migration at version ${i}`);
+      }
+      db.run(migration);
       db.query("INSERT INTO _migrations (id) VALUES (?)").run(i);
     } catch (e) {
       if (isBenignMigrationError(e)) {
@@ -6284,7 +6368,7 @@ function ensureColumn(db, table, column, definition) {
 function shortUuid2() {
   return crypto.randomUUID().slice(0, 8);
 }
-var _db = null, _adapter = null, MIGRATIONS;
+var _db = null, _adapter = null, MIGRATIONS, CURRENT_MIGRATION_LEVEL;
 var init_database = __esm(() => {
   init_sqlite_adapter();
   init_config();
@@ -6367,6 +6451,7 @@ var init_database = __esm(() => {
   ALTER TABLE agents ADD COLUMN active_project_id TEXT REFERENCES projects(id) ON DELETE SET NULL;
   `
   ];
+  CURRENT_MIGRATION_LEVEL = MIGRATIONS.length - 1;
 });
 
 // src/db/recordings.ts
@@ -6648,24 +6733,28 @@ var init_feedback = __esm(() => {
 function envToken(name) {
   return name.toUpperCase().replace(/-/g, "_");
 }
-function normalizeMode(value) {
-  const normalized = value.trim().toLowerCase().replace(/-/g, "_");
-  if (normalized === "local")
-    return { mode: "local", deprecatedAlias: null };
-  if (normalized === "cloud")
-    return { mode: "cloud", deprecatedAlias: null };
-  if (DEPRECATED_MODE_ALIASES.includes(normalized)) {
-    return { mode: "cloud", deprecatedAlias: normalized };
+function clientStoreReplacement(envKey) {
+  return { envKey, onBox: "sqlite", offBox: "http" };
+}
+function normalizeClientStore(value, sourceEnvKey, replacementEnvKey) {
+  const normalized = normalizeModeToken(value);
+  if (normalized === "sqlite")
+    return "sqlite";
+  if (normalized === "http" || normalized === "https")
+    return "http";
+  if (asRetiredDeploymentMode(value)) {
+    throw retiredDeploymentModeError(value, sourceEnvKey, clientStoreReplacement(replacementEnvKey));
   }
-  throw new Error(`Unknown storage mode: ${value}. Use local or cloud.`);
+  throw new Error(`Unknown client store: ${value}. Use sqlite or http.`);
 }
-function defaultCloudBaseUrl(name) {
-  return `https://${name}.hasna.xyz`;
+function defaultApiBaseUrl(name) {
+  return `http://localhost:8874`;
 }
 function envKeys(name) {
   const token = envToken(name);
   return {
-    modeKeys: [`HASNA_${token}_STORAGE_MODE`, `HASNA_${token}_MODE`, `${token}_STORAGE_MODE`, `${token}_MODE`],
+    storeKeys: [`HASNA_${token}_CLIENT_STORE`, `${token}_CLIENT_STORE`],
+    retiredModeKeys: [`HASNA_${token}_STORAGE_MODE`, `HASNA_${token}_MODE`, `${token}_STORAGE_MODE`, `${token}_MODE`],
     apiUrlKeys: [`HASNA_${token}_API_URL`, `${token}_API_URL`],
     apiKeyKeys: [`HASNA_${token}_API_KEY`, `${token}_API_KEY`]
   };
@@ -6678,6 +6767,20 @@ function firstEnv(env, keys) {
   }
   return null;
 }
+function assertNoRetiredMode(env, keys) {
+  for (const key of keys.retiredModeKeys) {
+    const value = env[key]?.trim();
+    if (!value)
+      continue;
+    const normalized = normalizeModeToken(value);
+    if (SERVER_BACKEND_VALUES.includes(normalized))
+      continue;
+    if (asRetiredDeploymentMode(value)) {
+      throw retiredDeploymentModeError(value, key, clientStoreReplacement(keys.storeKeys[0]));
+    }
+    throw new Error(`${key}=${value} is not a client store. ${key} no longer selects one; ` + `set ${keys.storeKeys[0]}=sqlite or ${keys.storeKeys[0]}=http instead.`);
+  }
+}
 function toV1BaseUrl(apiUrl) {
   const url = new URL(apiUrl);
   if (url.protocol !== "http:" && url.protocol !== "https:") {
@@ -6693,45 +6796,42 @@ function toV1BaseUrl(apiUrl) {
 }
 function resolveTransport(name, env = process.env) {
   const keys = envKeys(name);
-  const modeHit = firstEnv(env, keys.modeKeys);
+  assertNoRetiredMode(env, keys);
+  const storeHit = firstEnv(env, keys.storeKeys);
   const urlHit = firstEnv(env, keys.apiUrlKeys);
   const keyHit = firstEnv(env, keys.apiKeyKeys);
-  let mode = "local";
-  let deprecatedAlias = null;
+  let requested = "sqlite";
   let modeSource = "default";
-  if (modeHit) {
-    const normalized = normalizeMode(modeHit.value);
-    mode = normalized.mode;
-    deprecatedAlias = normalized.deprecatedAlias;
-    modeSource = modeHit.key;
+  if (storeHit) {
+    requested = normalizeClientStore(storeHit.value, storeHit.key, keys.storeKeys[0]);
+    modeSource = storeHit.key;
   } else if (urlHit && keyHit) {
-    mode = "cloud";
+    requested = "http";
     modeSource = "auto:api-url+api-key";
   }
-  if (mode === "local") {
-    return { transport: "local", mode, deprecatedAlias, modeSource, baseUrl: null, apiKeyPresent: Boolean(keyHit), misconfigured: false, warning: null };
+  if (requested === "sqlite") {
+    return { transport: "sqlite", requested, modeSource, baseUrl: null, apiKeyPresent: Boolean(keyHit), misconfigured: false, warning: null };
   }
   if (!keyHit) {
     return {
-      transport: "local",
-      mode,
-      deprecatedAlias,
+      transport: "sqlite",
+      requested,
       modeSource,
       baseUrl: null,
       apiKeyPresent: false,
       misconfigured: true,
-      warning: `${modeSource}=cloud but no API key is set (${keys.apiKeyKeys[0]}). Refusing to route to cloud.`
+      warning: `${modeSource}=http but no API key is set (${keys.apiKeyKeys[0]}). Refusing to route to the API.`
     };
   }
-  const rawUrl = urlHit?.value ?? defaultCloudBaseUrl(name);
+  const rawUrl = urlHit?.value ?? defaultApiBaseUrl(name);
   let baseUrl;
   try {
     baseUrl = toV1BaseUrl(rawUrl);
   } catch (error2) {
     const message = error2 instanceof Error ? error2.message : String(error2);
-    return { transport: "local", mode, deprecatedAlias, modeSource, baseUrl: null, apiKeyPresent: true, misconfigured: true, warning: `Invalid API URL: ${message}.` };
+    return { transport: "sqlite", requested, modeSource, baseUrl: null, apiKeyPresent: true, misconfigured: true, warning: `Invalid API URL: ${message}.` };
   }
-  return { transport: "cloud-http", mode, deprecatedAlias, modeSource, baseUrl, apiKeyPresent: true, misconfigured: false, warning: null };
+  return { transport: "http", requested, modeSource, baseUrl, apiKeyPresent: true, misconfigured: false, warning: null };
 }
 function appendQuery(path, query) {
   if (!query)
@@ -6825,6 +6925,8 @@ function createHttpTransport(options) {
       const jitter = Math.floor(Math.random() * (backoff / 2 + 1));
       await sleep(backoff + jitter);
     }
+    if (last === null)
+      throw new Error(`Request to ${rel} completed without a result`);
     throw last.error;
   }
   return {
@@ -6896,21 +6998,22 @@ function createStorageClient(name, transport) {
 function resolveStorageClient(name, env = process.env, fetchImpl) {
   const resolution = resolveTransport(name, env);
   if (resolution.misconfigured) {
-    throw new Error(resolution.warning ?? `Client for '${name}' is misconfigured for cloud mode.`);
+    throw new Error(resolution.warning ?? `Client for '${name}' is misconfigured for the /v1 API.`);
   }
-  if (resolution.transport === "local" || !resolution.baseUrl) {
-    return { transport: "local", client: null, resolution };
+  if (resolution.transport === "sqlite" || !resolution.baseUrl) {
+    return { transport: "sqlite", client: null, resolution };
   }
   const keys = envKeys(name);
   const apiKey = firstEnv(env, keys.apiKeyKeys)?.value;
   if (!apiKey)
-    throw new Error(`Client for '${name}' resolved to cloud-http without an API key.`);
+    throw new Error(`Client for '${name}' resolved to the /v1 API without an API key.`);
   const transport = createHttpTransport({ name, baseUrl: resolution.baseUrl, apiKey, ...fetchImpl ? { fetchImpl } : {} });
-  return { transport: "cloud-http", client: createStorageClient(name, transport), resolution };
+  return { transport: "http", client: createStorageClient(name, transport), resolution };
 }
-var DEPRECATED_MODE_ALIASES, HasnaHttpError, RETRY_STATUSES, IDEMPOTENT, defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var SERVER_BACKEND_VALUES, HasnaHttpError, RETRY_STATUSES, IDEMPOTENT, defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));
 var init_client = __esm(() => {
-  DEPRECATED_MODE_ALIASES = ["self_hosted", "remote", "hybrid"];
+  init_retired_deployment_modes();
+  SERVER_BACKEND_VALUES = ["sqlite", "postgresql", "postgres"];
   HasnaHttpError = class HasnaHttpError extends Error {
     status;
     method;
@@ -6949,13 +7052,16 @@ function listQuery(filter) {
 }
 function unwrap(res, key) {
   if (res && typeof res === "object" && key in res) {
-    return res[key];
+    const value = res[key];
+    if (value === undefined)
+      throw new Error(`Response field ${key} is undefined`);
+    return value;
   }
   return res;
 }
 function apiStore(client) {
   return {
-    mode: "cloud-http",
+    mode: "http",
     baseUrl: client.baseUrl,
     async createRecording(input, idempotencyKey) {
       const keyCandidate = idempotencyKey === undefined && (input.id === undefined || input.id === null) ? randomUUID2() : idempotencyKey;
@@ -7122,7 +7228,7 @@ function getStore(env = process.env) {
   if (env === process.env && cached)
     return cached;
   const resolved = resolveStorageClient(APP, env);
-  const store = resolved.transport === "cloud-http" ? apiStore(resolved.client) : localStore;
+  const store = resolved.transport === "http" ? apiStore(resolved.client) : localStore;
   if (env === process.env)
     cached = store;
   return store;
@@ -7137,7 +7243,7 @@ var init_store = __esm(() => {
   init_recording_create_identity();
   init_install_maintenance();
   localStore = {
-    mode: "local",
+    mode: "sqlite",
     baseUrl: null,
     async createRecording(input, idempotencyKey) {
       return withLocalStoreReaderLease(() => createRecording2(input, undefined, idempotencyKey));
@@ -8195,13 +8301,13 @@ function buildFetch(options = {}) {
         "Retry-After": String(rl.retryAfter ?? 60)
       });
     }
-    const mode = isCloudModeEnabled() ? "remote" : "local";
+    const mode = resolveDataBackend();
     if ((path === "/health" || path === "/ready" || path === "/version") && method === "GET") {
       if (path === "/version") {
         return jsonResponse({ status: "ok", version: VERSION, mode, name: "recordings" });
       }
       if (path === "/ready") {
-        if (mode === "remote") {
+        if (mode === "postgresql") {
           try {
             await checkCloudAuth();
             await checkCloud();
@@ -8259,12 +8365,13 @@ async function startServer(port, options) {
   };
   process.on("SIGINT", shutdown);
   process.on("SIGTERM", shutdown);
-  const mode = isCloudModeEnabled() ? "remote (A1 pure-remote)" : "local";
+  const mode = resolveDataBackend();
   console.log(`recordings-serve listening on http://${hostname2}:${port} (mode: ${mode})`);
   return server;
 }
 var SECURITY_HEADERS, rateLimitMap, RATE_LIMIT_WINDOW_MS = 60000, RATE_LIMIT_MAX;
 var init_serve = __esm(() => {
+  init_cloud_config();
   init_v1();
   init_openapi();
   SECURITY_HEADERS = {
@@ -8283,9 +8390,9 @@ function parsePort() {
   const arg = process.argv.find((a) => a === "--port" || a.startsWith("--port="));
   if (arg) {
     if (arg.includes("="))
-      return parseInt(arg.split("=")[1], 10) || DEFAULT_PORT;
+      return parseInt(arg.split("=", 2)[1] ?? "", 10) || DEFAULT_PORT;
     const idx = process.argv.indexOf(arg);
-    return parseInt(process.argv[idx + 1], 10) || DEFAULT_PORT;
+    return parseInt(process.argv[idx + 1] ?? "", 10) || DEFAULT_PORT;
   }
   const envPort = process.env.PORT ? parseInt(process.env.PORT, 10) : undefined;
   return envPort || DEFAULT_PORT;
@@ -8311,10 +8418,11 @@ Options:
   -h, --help      display help for command
 
 Commands:
-  migrate         Apply the cloud schema, then exit. Idempotent.
+  migrate         Apply the PostgreSQL schema, then exit. Idempotent.
 
 Environment:
-  HASNA_RECORDINGS_DATABASE_URL   Remote Postgres DSN (enables cloud /v1)
+  HASNA_RECORDINGS_STORAGE_MODE     Data backend: sqlite | postgresql
+  HASNA_RECORDINGS_DATABASE_URL     PostgreSQL DSN (implies postgresql)
   HASNA_RECORDINGS_API_SIGNING_KEY  HMAC signing secret for API-key auth`);
 }
 async function runMigrate() {

package/dist/server/migrate-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate-command.d.ts","sourceRoot":"","sources":["../../src/server/migrate-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAED,oFAAoF;AACpF,wBAAsB,4BAA4B,CAChD,EAAE,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC,EAChD,kBAAkB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,6FAA6F;AAC7F,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjF"}
+{"version":3,"file":"migrate-command.d.ts","sourceRoot":"","sources":["../../src/server/migrate-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAED,oFAAoF;AACpF,wBAAsB,4BAA4B,CAChD,EAAE,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC,EAChD,kBAAkB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,6FAA6F;AAC7F,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjF"}

package/dist/server/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/server/serve.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKnD,CAAC;AAyCF,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACzC;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,IAWtD,KAAK,OAAO,EACZ,QAAQ;IAAE,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,KAC9D,OAAO,CAAC,QAAQ,CAAC,CAqFrB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAqBnH"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/server/serve.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKnD,CAAC;AAyCF,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACzC;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,IAWtD,KAAK,OAAO,EACZ,QAAQ;IAAE,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,KAC9D,OAAO,CAAC,QAAQ,CAAC,CAqFrB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAqBnH"}

package/dist/storage.d.ts

@@ -1,5 +1,5 @@
 export { getStore, __resetStore, APP } from "./store.js";
 export type { Store, RecordingStats, FeedbackInput } from "./store.js";
-export { resolveStorageClient, resolveTransport, createHttpTransport, createStorageClient, toV1BaseUrl, defaultCloudBaseUrl, HasnaHttpError, } from "./http/client.js";
-export type { StorageClient, StorageMode, TransportKind, TransportResolution, HttpTransport, } from "./http/client.js";
+export { resolveStorageClient, resolveTransport, createHttpTransport, createStorageClient, toV1BaseUrl, defaultApiBaseUrl, HasnaHttpError, } from "./http/client.js";
+export type { StorageClient, ClientStore, TransportKind, TransportResolution, HttpTransport, } from "./http/client.js";
 //# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,aAAa,GACd,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,aAAa,GACd,MAAM,kBAAkB,CAAC"}