@igstack/app-catalog-backend-core 0.15.0 → 0.17.0

package/src/modules/assets/screenshotRestController.ts

@@ -1,6 +1,7 @@
 import type { Request, Response, Router } from 'express'
 import sharp from 'sharp'
 import { getDbClient } from '../../db'
+import { isNotModified, setRevalidatingCacheHeaders } from './assetCache'
 
 export interface ScreenshotRestControllerConfig {
   /**
@@ -133,6 +134,7 @@ export function registerScreenshotRestController(
           content: true,
           mimeType: true,
           name: true,
+          checksum: true,
         },
       })
 
@@ -141,6 +143,17 @@ export function registerScreenshotRestController(
         return
       }
 
+      // Answered before resizing, so an unchanged screenshot costs no image work.
+      const etag = setRevalidatingCacheHeaders(
+        res,
+        screenshot.checksum,
+        targetSize && targetSize > 0 ? `s${targetSize}` : undefined,
+      )
+      if (isNotModified(req, etag)) {
+        res.status(304).end()
+        return
+      }
+
       let content: Uint8Array | Buffer = screenshot.content
 
       // Resize if size parameter provided
@@ -164,7 +177,6 @@ export function registerScreenshotRestController(
         'Content-Disposition',
         `inline; filename="${screenshot.name}"`,
       )
-      res.setHeader('Cache-Control', 'public, max-age=86400') // Cache for 1 day
 
       // Send binary content
       res.send(content)

package/src/modules/assets/upsertAsset.ts

@@ -27,6 +27,14 @@ export async function upsertAsset({
   })
 
   if (existing) {
+    // Reusing the stored binary must not keep a mimeType we no longer derive:
+    // rows written by an older, wrong derivation would never be corrected.
+    if (existing.mimeType !== mimeType) {
+      await prisma.dbAsset.update({
+        where: { id: existing.id },
+        data: { mimeType },
+      })
+    }
     return existing.id
   }
 

package/src/modules/icons/iconRestController.ts

@@ -3,6 +3,10 @@ import multer from 'multer'
 import { createHash } from 'node:crypto'
 import { getDbClient } from '../../db'
 import { getExtensionFromFilename, getExtensionFromMimeType } from './iconUtils'
+import {
+  isNotModified,
+  setRevalidatingCacheHeaders,
+} from '../assets/assetCache'
 
 // Configure multer for memory storage
 const upload = multer({
@@ -112,6 +116,7 @@ export function registerIconRestController(
           content: true,
           mimeType: true,
           name: true,
+          checksum: true,
         },
       })
 
@@ -120,10 +125,15 @@ export function registerIconRestController(
         return
       }
 
+      const etag = setRevalidatingCacheHeaders(res, icon.checksum)
+      if (isNotModified(req, etag)) {
+        res.status(304).end()
+        return
+      }
+
       // Set appropriate headers
       res.setHeader('Content-Type', icon.mimeType)
       res.setHeader('Content-Disposition', `inline; filename="${icon.name}"`)
-      res.setHeader('Cache-Control', 'public, max-age=86400') // Cache for 1 day
 
       // Send binary content
       res.send(icon.content)

package/src/modules/lighthouseKeeper/tools.ts

@@ -1,8 +1,6 @@
 import type { Tool } from 'ai'
 import { z } from 'zod'
-import { PrismaClient } from '../../generated/prisma/client'
-import { PrismaPg } from '@prisma/adapter-pg'
-import pg from 'pg'
+import { createCorePrismaClient } from '../../db/client'
 import type { AcDatabaseConfig } from '../../middleware/types.js'
 
 // ============================================================================
@@ -27,10 +25,11 @@ function getDatabaseUrl(config: AcDatabaseConfig): string {
 export function createAppCatalogAITools(
   databaseConfig: AcDatabaseConfig,
 ): Record<string, Tool> {
-  const databaseUrl = getDatabaseUrl(databaseConfig)
-  const pool = new pg.Pool({ connectionString: databaseUrl })
-  const adapter = new PrismaPg(pool)
-  const prisma = new PrismaClient({ adapter })
+  const { client: prisma } = createCorePrismaClient({
+    connectionString: getDatabaseUrl(databaseConfig),
+    configuredSchema:
+      'url' in databaseConfig ? undefined : databaseConfig.schema,
+  })
 
   const getAppCardSchema = z.object({
     slug: z.string().describe('The app slug to fetch'),

package/src/types/common/appCatalogTypes.ts

@@ -46,6 +46,13 @@ export interface SourceReference {
 export interface Freshness {
   /** ISO-8601 timestamp the app's sources were last verified, or null if never. */
   lastCheckedAt: string | null
+  /**
+   * ISO-8601 timestamp the source content last actually CHANGED — what the UI
+   * shows as "Updated". Distinct from `lastCheckedAt`: a source can be re-read
+   * repeatedly without changing. Null for entries scanned before this was
+   * tracked, in which case the frontend falls back to `lastCheckedAt`.
+   */
+  lastContentChangeAt: string | null
   /** True when the entry is overdue for a re-check by more than the grace period. */
   isStale: boolean
 }
@@ -118,6 +125,7 @@ export interface Resource {
    */
   lastCheckedAt?: string | null
   nextCheckAfter?: string | null
+  lastContentChangeAt?: string | null
   /** ISO-8601 timestamp of when this entry was first created in the catalog DB. */
   createdAt?: string
 }