feat(cache): read cache TTLs from storage settings and renew tracked TMDB details (CACHE-2)

Co-Authored-By: Claude Opus 5.5 <[email protected]>

packages/db/src/cache.ts

@@ -58,6 +58,14 @@ export class PgCache {
     return r.rows.length ? (r.rows[0]!.value as T) : null;
   }
 
+  /** 续期:未过期的条目把 expires_at 推到 now + ttl(只延长不缩短);返回是否有行被续期 */
+  async renew(region: string, key: string, ttl: number): Promise<boolean> {
+    if (ttl <= 0) return false;
+    const r = await sql`update kv_cache set expires_at = greatest(expires_at, now() + make_interval(secs => ${ttl}))
+      where region = ${region} and key = ${key} and expires_at > now()`.execute(this.db);
+    return Number(r.numAffectedRows ?? 0) > 0;
+  }
+
   async exists(region: string, key: string): Promise<boolean> {
     const r =
       await sql`select 1 from kv_cache where region = ${region} and key = ${key} and expires_at > now()`.execute(

packages/db/src/index.ts

@@ -1,5 +1,5 @@
 // 统一从本包取 Kysely 与 sql,避免各包各装一份 kysely
-export { type Kysely, type Selectable, sql, type Transaction } from "kysely";
+export { type Kysely, type RawBuilder, type Selectable, sql, type Transaction } from "kysely";
 export {
   type CachedOptions,
   cachedCall,