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

package/dist/modules/assets/assetRestController.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"assetRestController.mjs","names":[],"sources":["../../../src/modules/assets/assetRestController.ts"],"sourcesContent":["import type { Request, Response, Router } from 'express'\nimport multer from 'multer'\nimport sharp from 'sharp'\nimport { getDbClient } from '../../db'\nimport { getImageFormat, isRasterImage, resizeImage } from './assetUtils'\nimport { upsertAsset } from './upsertAsset'\n\n// Configure multer for memory storage\nconst upload = multer({\n  storage: multer.memoryStorage(),\n  limits: {\n    fileSize: 10 * 1024 * 1024, // 10MB limit\n  },\n  fileFilter: (_req, file, cb) => {\n    // Accept images only\n    if (!file.mimetype.startsWith('image/')) {\n      cb(new Error('Only image files are allowed'))\n      return\n    }\n    cb(null, true)\n  },\n})\n\nexport interface AssetRestControllerConfig {\n  /**\n   * Base path for asset endpoints (e.g., '/api/assets')\n   */\n  basePath: string\n}\n\nexport interface ParseAssetParams {\n  buffer: Buffer\n  originalFilename: string\n  fileSize?: number\n}\n\nexport interface ParseAssetReturn {\n  checksum: string\n  fileSize: number\n  mimeType: string\n  width?: number\n  height?: number\n}\n\n/**\n * Registers REST endpoints for universal asset upload and retrieval\n *\n * Endpoints:\n * - POST {basePath}/upload - Upload a new asset (multipart/form-data)\n * - GET {basePath}/:id - Get asset binary by ID\n * - GET {basePath}/:id/metadata - Get asset metadata only\n * - GET {basePath}/by-name/:name - Get asset binary by name\n */\nexport function registerAssetRestController(\n  router: Router,\n  config: AssetRestControllerConfig,\n): void {\n  const { basePath } = config\n  const prisma = getDbClient()\n\n  // Upload endpoint - accepts multipart/form-data\n  router.post(\n    `${basePath}/upload`,\n    upload.single('asset'),\n    async (req: Request, res: Response) => {\n      try {\n        if (!req.file) {\n          res.status(400).json({ error: 'No file uploaded' })\n          return\n        }\n\n        const name = req.body['name'] as string\n        const assetType = req.body['assetType']\n\n        if (!name) {\n          res.status(400).json({ error: 'Name is required' })\n          return\n        }\n\n        const id = await upsertAsset({\n          prisma,\n          buffer: req.file.buffer,\n          name,\n          originalFilename: req.file.filename,\n          assetType,\n        })\n\n        res.status(201).json({ id })\n      } catch (error) {\n        console.error('Error uploading asset:', error)\n        res.status(500).json({ error: 'Failed to upload asset' })\n      }\n    },\n  )\n\n  // Get asset binary by ID\n  router.get(`${basePath}/:id`, async (req: Request, res: Response) => {\n    try {\n      const { id } = req.params\n\n      const asset = await prisma.dbAsset.findUnique({\n        where: { id },\n        select: {\n          content: true,\n          mimeType: true,\n          name: true,\n          width: true,\n          height: true,\n        },\n      })\n\n      if (!asset) {\n        res.status(404).json({ error: 'Asset not found' })\n        return\n      }\n\n      const resizeEnabled =\n        String(process.env.EH_ASSETS_RESIZE_ENABLED || 'true') === 'true'\n      const wParam = req.query['w'] as string | undefined\n      const width = wParam ? Number.parseInt(wParam, 10) : undefined\n\n      let outBuffer: Uint8Array = asset.content\n      let outMime = asset.mimeType\n\n      const shouldResize =\n        resizeEnabled &&\n        isRasterImage(asset.mimeType) &&\n        !!width &&\n        Number.isFinite(width) &&\n        width > 0\n\n      if (shouldResize) {\n        const fmt = getImageFormat(asset.mimeType) || 'jpeg'\n        const buf = await resizeImage(\n          Buffer.from(asset.content),\n          width,\n          undefined,\n          fmt,\n        )\n        outBuffer = new Uint8Array(buf)\n        outMime = `image/${fmt}`\n      }\n\n      // Set appropriate headers\n      res.setHeader('Content-Type', outMime)\n      res.setHeader('Content-Disposition', `inline; filename=\"${asset.name}\"`)\n      res.setHeader('Cache-Control', 'public, max-age=86400') // Cache for 1 day\n\n      // Send binary content (resized if requested)\n      res.send(outBuffer)\n    } catch (error) {\n      console.error('Error fetching asset:', error)\n      res.status(500).json({ error: 'Failed to fetch asset' })\n    }\n  })\n\n  // Get asset metadata only (no binary content)\n  router.get(\n    `${basePath}/:id/metadata`,\n    async (req: Request, res: Response) => {\n      try {\n        const { id } = req.params\n\n        const asset = await prisma.dbAsset.findUnique({\n          where: { id },\n          select: {\n            id: true,\n            name: true,\n            assetType: true,\n            mimeType: true,\n            fileSize: true,\n            width: true,\n            height: true,\n            createdAt: true,\n            updatedAt: true,\n          },\n        })\n\n        if (!asset) {\n          res.status(404).json({ error: 'Asset not found' })\n          return\n        }\n\n        res.json(asset)\n      } catch (error) {\n        console.error('Error fetching asset metadata:', error)\n        res.status(500).json({ error: 'Failed to fetch asset metadata' })\n      }\n    },\n  )\n\n  // Get asset binary by name\n  router.get(\n    `${basePath}/by-name/:name`,\n    async (req: Request, res: Response) => {\n      try {\n        const { name } = req.params\n\n        const asset = await prisma.dbAsset.findUnique({\n          where: { name },\n          select: {\n            content: true,\n            mimeType: true,\n            name: true,\n            width: true,\n            height: true,\n          },\n        })\n\n        if (!asset) {\n          res.status(404).json({ error: 'Asset not found' })\n          return\n        }\n\n        const resizeEnabled =\n          String(process.env.EH_ASSETS_RESIZE_ENABLED || 'true') === 'true'\n        const wParam = req.query['w'] as string | undefined\n        const width = wParam ? Number.parseInt(wParam, 10) : undefined\n\n        let outBuffer: Uint8Array = asset.content\n        let outMime = asset.mimeType\n\n        const isRaster =\n          asset.mimeType.startsWith('image/') && !asset.mimeType.includes('svg')\n        const shouldResize =\n          resizeEnabled &&\n          isRaster &&\n          !!width &&\n          Number.isFinite(width) &&\n          width > 0\n\n        if (shouldResize) {\n          const fmt = asset.mimeType.includes('png')\n            ? 'png'\n            : asset.mimeType.includes('webp')\n              ? 'webp'\n              : 'jpeg'\n\n          let buf: Buffer\n          const pipeline = sharp(Buffer.from(asset.content)).resize({\n            width,\n            fit: 'inside',\n            withoutEnlargement: true,\n          })\n          if (fmt === 'png') {\n            buf = await pipeline.png().toBuffer()\n            outMime = 'image/png'\n          } else if (fmt === 'webp') {\n            buf = await pipeline.webp().toBuffer()\n            outMime = 'image/webp'\n          } else {\n            buf = await pipeline.jpeg().toBuffer()\n            outMime = 'image/jpeg'\n          }\n          outBuffer = new Uint8Array(buf)\n        }\n\n        // Set appropriate headers\n        res.setHeader('Content-Type', outMime)\n        res.setHeader('Content-Disposition', `inline; filename=\"${asset.name}\"`)\n        res.setHeader('Cache-Control', 'public, max-age=86400') // Cache for 1 day\n\n        // Send binary content (resized if requested)\n        res.send(outBuffer)\n      } catch (error) {\n        console.error('Error fetching asset by name:', error)\n        res.status(500).json({ error: 'Failed to fetch asset' })\n      }\n    },\n  )\n}\n"],"mappings":"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"}
+{"version":3,"file":"assetRestController.mjs","names":[],"sources":["../../../src/modules/assets/assetRestController.ts"],"sourcesContent":["import type { Request, Response, Router } from 'express'\nimport multer from 'multer'\nimport sharp from 'sharp'\nimport { getDbClient } from '../../db'\nimport { getImageFormat, isRasterImage, resizeImage } from './assetUtils'\nimport { upsertAsset } from './upsertAsset'\nimport { isNotModified, setRevalidatingCacheHeaders } from './assetCache'\n\n// Configure multer for memory storage\nconst upload = multer({\n  storage: multer.memoryStorage(),\n  limits: {\n    fileSize: 10 * 1024 * 1024, // 10MB limit\n  },\n  fileFilter: (_req, file, cb) => {\n    // Accept images only\n    if (!file.mimetype.startsWith('image/')) {\n      cb(new Error('Only image files are allowed'))\n      return\n    }\n    cb(null, true)\n  },\n})\n\nexport interface AssetRestControllerConfig {\n  /**\n   * Base path for asset endpoints (e.g., '/api/assets')\n   */\n  basePath: string\n}\n\nexport interface ParseAssetParams {\n  buffer: Buffer\n  originalFilename: string\n  fileSize?: number\n}\n\nexport interface ParseAssetReturn {\n  checksum: string\n  fileSize: number\n  mimeType: string\n  width?: number\n  height?: number\n}\n\n/**\n * Registers REST endpoints for universal asset upload and retrieval\n *\n * Endpoints:\n * - POST {basePath}/upload - Upload a new asset (multipart/form-data)\n * - GET {basePath}/:id - Get asset binary by ID\n * - GET {basePath}/:id/metadata - Get asset metadata only\n * - GET {basePath}/by-name/:name - Get asset binary by name\n */\nexport function registerAssetRestController(\n  router: Router,\n  config: AssetRestControllerConfig,\n): void {\n  const { basePath } = config\n  const prisma = getDbClient()\n\n  // Upload endpoint - accepts multipart/form-data\n  router.post(\n    `${basePath}/upload`,\n    upload.single('asset'),\n    async (req: Request, res: Response) => {\n      try {\n        if (!req.file) {\n          res.status(400).json({ error: 'No file uploaded' })\n          return\n        }\n\n        const name = req.body['name'] as string\n        const assetType = req.body['assetType']\n\n        if (!name) {\n          res.status(400).json({ error: 'Name is required' })\n          return\n        }\n\n        const id = await upsertAsset({\n          prisma,\n          buffer: req.file.buffer,\n          name,\n          originalFilename: req.file.filename,\n          assetType,\n        })\n\n        res.status(201).json({ id })\n      } catch (error) {\n        console.error('Error uploading asset:', error)\n        res.status(500).json({ error: 'Failed to upload asset' })\n      }\n    },\n  )\n\n  // Get asset binary by ID\n  router.get(`${basePath}/:id`, async (req: Request, res: Response) => {\n    try {\n      const { id } = req.params\n\n      const asset = await prisma.dbAsset.findUnique({\n        where: { id },\n        select: {\n          content: true,\n          mimeType: true,\n          name: true,\n          width: true,\n          height: true,\n          checksum: true,\n        },\n      })\n\n      if (!asset) {\n        res.status(404).json({ error: 'Asset not found' })\n        return\n      }\n\n      const resizeEnabled =\n        String(process.env.EH_ASSETS_RESIZE_ENABLED || 'true') === 'true'\n      const wParam = req.query['w'] as string | undefined\n      const width = wParam ? Number.parseInt(wParam, 10) : undefined\n\n      let outBuffer: Uint8Array = asset.content\n      let outMime = asset.mimeType\n\n      const shouldResize =\n        resizeEnabled &&\n        isRasterImage(asset.mimeType) &&\n        !!width &&\n        Number.isFinite(width) &&\n        width > 0\n\n      // Answered before resizing, so an unchanged asset costs no image work.\n      const etag = setRevalidatingCacheHeaders(\n        res,\n        asset.checksum,\n        shouldResize ? `w${width}` : undefined,\n      )\n      if (isNotModified(req, etag)) {\n        res.status(304).end()\n        return\n      }\n\n      if (shouldResize) {\n        const fmt = getImageFormat(asset.mimeType) || 'jpeg'\n        const buf = await resizeImage(\n          Buffer.from(asset.content),\n          width,\n          undefined,\n          fmt,\n        )\n        outBuffer = new Uint8Array(buf)\n        outMime = `image/${fmt}`\n      }\n\n      // Set appropriate headers\n      res.setHeader('Content-Type', outMime)\n      res.setHeader('Content-Disposition', `inline; filename=\"${asset.name}\"`)\n\n      // Send binary content (resized if requested)\n      res.send(outBuffer)\n    } catch (error) {\n      console.error('Error fetching asset:', error)\n      res.status(500).json({ error: 'Failed to fetch asset' })\n    }\n  })\n\n  // Get asset metadata only (no binary content)\n  router.get(\n    `${basePath}/:id/metadata`,\n    async (req: Request, res: Response) => {\n      try {\n        const { id } = req.params\n\n        const asset = await prisma.dbAsset.findUnique({\n          where: { id },\n          select: {\n            id: true,\n            name: true,\n            assetType: true,\n            mimeType: true,\n            fileSize: true,\n            width: true,\n            height: true,\n            createdAt: true,\n            updatedAt: true,\n          },\n        })\n\n        if (!asset) {\n          res.status(404).json({ error: 'Asset not found' })\n          return\n        }\n\n        res.json(asset)\n      } catch (error) {\n        console.error('Error fetching asset metadata:', error)\n        res.status(500).json({ error: 'Failed to fetch asset metadata' })\n      }\n    },\n  )\n\n  // Get asset binary by name\n  router.get(\n    `${basePath}/by-name/:name`,\n    async (req: Request, res: Response) => {\n      try {\n        const { name } = req.params\n\n        const asset = await prisma.dbAsset.findUnique({\n          where: { name },\n          select: {\n            content: true,\n            mimeType: true,\n            name: true,\n            width: true,\n            height: true,\n            checksum: true,\n          },\n        })\n\n        if (!asset) {\n          res.status(404).json({ error: 'Asset not found' })\n          return\n        }\n\n        const resizeEnabled =\n          String(process.env.EH_ASSETS_RESIZE_ENABLED || 'true') === 'true'\n        const wParam = req.query['w'] as string | undefined\n        const width = wParam ? Number.parseInt(wParam, 10) : undefined\n\n        let outBuffer: Uint8Array = asset.content\n        let outMime = asset.mimeType\n\n        const isRaster =\n          asset.mimeType.startsWith('image/') && !asset.mimeType.includes('svg')\n        const shouldResize =\n          resizeEnabled &&\n          isRaster &&\n          !!width &&\n          Number.isFinite(width) &&\n          width > 0\n\n        // Answered before resizing, so an unchanged asset costs no image work.\n        const etag = setRevalidatingCacheHeaders(\n          res,\n          asset.checksum,\n          shouldResize ? `w${width}` : undefined,\n        )\n        if (isNotModified(req, etag)) {\n          res.status(304).end()\n          return\n        }\n\n        if (shouldResize) {\n          const fmt = asset.mimeType.includes('png')\n            ? 'png'\n            : asset.mimeType.includes('webp')\n              ? 'webp'\n              : 'jpeg'\n\n          let buf: Buffer\n          const pipeline = sharp(Buffer.from(asset.content)).resize({\n            width,\n            fit: 'inside',\n            withoutEnlargement: true,\n          })\n          if (fmt === 'png') {\n            buf = await pipeline.png().toBuffer()\n            outMime = 'image/png'\n          } else if (fmt === 'webp') {\n            buf = await pipeline.webp().toBuffer()\n            outMime = 'image/webp'\n          } else {\n            buf = await pipeline.jpeg().toBuffer()\n            outMime = 'image/jpeg'\n          }\n          outBuffer = new Uint8Array(buf)\n        }\n\n        // Set appropriate headers\n        res.setHeader('Content-Type', outMime)\n        res.setHeader('Content-Disposition', `inline; filename=\"${asset.name}\"`)\n\n        // Send binary content (resized if requested)\n        res.send(outBuffer)\n      } catch (error) {\n        console.error('Error fetching asset by name:', error)\n        res.status(500).json({ error: 'Failed to fetch asset' })\n      }\n    },\n  )\n}\n"],"mappings":"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"}

package/dist/modules/assets/assetUtils.mjs

@@ -76,6 +76,7 @@ async function parseAssetMeta(p) {
 			tiff: "image/tiff",
 			gif: "image/gif",
 			heif: "image/heif",
+			svg: "image/svg+xml",
 			raw: "application/octet-stream"
 		}[format] ?? `image/${format}` : "application/octet-stream",
 		fileSize: size || 0

package/dist/modules/assets/assetUtils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"assetUtils.mjs","names":[],"sources":["../../../src/modules/assets/assetUtils.ts"],"sourcesContent":["import { createHash } from 'node:crypto'\nimport type { FormatEnum } from 'sharp'\nimport sharp from 'sharp'\nimport type { ParseAssetParams, ParseAssetReturn } from './assetRestController'\n\n/**\n * Extract image dimensions from a buffer using sharp\n */\nexport async function getImageDimensions(\n  buffer: Buffer,\n): Promise<{ width?: number; height?: number }> {\n  try {\n    const metadata = await sharp(buffer).metadata()\n    return {\n      width: metadata.width,\n      height: metadata.height,\n    }\n  } catch (error) {\n    console.error('Error extracting image dimensions:', error)\n    return { width: undefined, height: undefined }\n  }\n}\n\n/**\n * Resize an image buffer to the specified dimensions\n * @param buffer - The image buffer to resize\n * @param width - Target width (optional)\n * @param height - Target height (optional)\n * @param format - Output format ('png', 'jpeg', 'webp'), auto-detected if not provided\n */\nexport async function resizeImage(\n  buffer: Buffer,\n  width?: number,\n  height?: number,\n  format?: 'png' | 'jpeg' | 'webp',\n): Promise<Buffer> {\n  let pipeline = sharp(buffer)\n\n  // Apply resize if dimensions provided\n  if (width || height) {\n    pipeline = pipeline.resize({\n      width,\n      height,\n      fit: 'inside',\n      withoutEnlargement: true,\n    })\n  }\n\n  // Apply format conversion if specified\n  if (format === 'png') {\n    pipeline = pipeline.png()\n  } else if (format === 'webp') {\n    pipeline = pipeline.webp()\n  } else if (format === 'jpeg') {\n    pipeline = pipeline.jpeg()\n  }\n\n  return pipeline.toBuffer()\n}\n\n/**\n * Generate SHA-256 checksum for a buffer\n */\nexport function generateChecksum(buffer: Buffer): string {\n  return createHash('sha256').update(buffer).digest('hex')\n}\n\n/**\n * Detect image format from mime type\n */\nexport function getImageFormat(\n  mimeType: string,\n): 'png' | 'webp' | 'jpeg' | null {\n  if (mimeType.includes('png')) return 'png'\n  if (mimeType.includes('webp')) return 'webp'\n  if (mimeType.includes('jpeg') || mimeType.includes('jpg')) return 'jpeg'\n  return null\n}\n\n/**\n * Check if a mime type represents a raster image (not SVG)\n */\nexport function isRasterImage(mimeType: string): boolean {\n  return mimeType.startsWith('image/') && !mimeType.includes('svg')\n}\n\nexport async function parseAssetMeta(\n  p: ParseAssetParams,\n): Promise<ParseAssetReturn> {\n  // Get image dimensions using our utility\n  const { width, height, format, size } = await sharp(p.buffer).metadata()\n\n  const formatToMime: Partial<Record<keyof FormatEnum, string>> = {\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    png: 'image/png',\n    webp: 'image/webp',\n    avif: 'image/avif',\n    tiff: 'image/tiff',\n    gif: 'image/gif',\n    heif: 'image/heif',\n    raw: 'application/octet-stream',\n  }\n\n  return {\n    checksum: generateChecksum(p.buffer),\n    width,\n    height,\n    mimeType: format\n      ? (formatToMime[format] ?? `image/${format}`)\n      : 'application/octet-stream',\n    fileSize: size || 0,\n  }\n}\n"],"mappings":";;;;;;;AAQA,eAAsB,mBACpB,QAC8C;AAC9C,KAAI;EACF,MAAM,WAAW,MAAM,MAAM,OAAO,CAAC,UAAU;AAC/C,SAAO;GACL,OAAO,SAAS;GAChB,QAAQ,SAAS;GAClB;UACM,OAAO;AACd,UAAQ,MAAM,sCAAsC,MAAM;AAC1D,SAAO;GAAE,OAAO;GAAW,QAAQ;GAAW;;;;;;;;;;AAWlD,eAAsB,YACpB,QACA,OACA,QACA,QACiB;CACjB,IAAI,WAAW,MAAM,OAAO;AAG5B,KAAI,SAAS,OACX,YAAW,SAAS,OAAO;EACzB;EACA;EACA,KAAK;EACL,oBAAoB;EACrB,CAAC;AAIJ,KAAI,WAAW,MACb,YAAW,SAAS,KAAK;UAChB,WAAW,OACpB,YAAW,SAAS,MAAM;UACjB,WAAW,OACpB,YAAW,SAAS,MAAM;AAG5B,QAAO,SAAS,UAAU;;;;;AAM5B,SAAgB,iBAAiB,QAAwB;AACvD,QAAO,WAAW,SAAS,CAAC,OAAO,OAAO,CAAC,OAAO,MAAM;;;;;AAM1D,SAAgB,eACd,UACgC;AAChC,KAAI,SAAS,SAAS,MAAM,CAAE,QAAO;AACrC,KAAI,SAAS,SAAS,OAAO,CAAE,QAAO;AACtC,KAAI,SAAS,SAAS,OAAO,IAAI,SAAS,SAAS,MAAM,CAAE,QAAO;AAClE,QAAO;;;;;AAMT,SAAgB,cAAc,UAA2B;AACvD,QAAO,SAAS,WAAW,SAAS,IAAI,CAAC,SAAS,SAAS,MAAM;;AAGnE,eAAsB,eACpB,GAC2B;CAE3B,MAAM,EAAE,OAAO,QAAQ,QAAQ,SAAS,MAAM,MAAM,EAAE,OAAO,CAAC,UAAU;AAcxE,QAAO;EACL,UAAU,iBAAiB,EAAE,OAAO;EACpC;EACA;EACA,UAAU,SAhBoD;GAC9D,MAAM;GACN,KAAK;GACL,KAAK;GACL,MAAM;GACN,MAAM;GACN,MAAM;GACN,KAAK;GACL,MAAM;GACN,KAAK;GACN,CAOmB,WAAW,SAAS,WAClC;EACJ,UAAU,QAAQ;EACnB"}
+{"version":3,"file":"assetUtils.mjs","names":[],"sources":["../../../src/modules/assets/assetUtils.ts"],"sourcesContent":["import { createHash } from 'node:crypto'\nimport type { FormatEnum } from 'sharp'\nimport sharp from 'sharp'\nimport type { ParseAssetParams, ParseAssetReturn } from './assetRestController'\n\n/**\n * Extract image dimensions from a buffer using sharp\n */\nexport async function getImageDimensions(\n  buffer: Buffer,\n): Promise<{ width?: number; height?: number }> {\n  try {\n    const metadata = await sharp(buffer).metadata()\n    return {\n      width: metadata.width,\n      height: metadata.height,\n    }\n  } catch (error) {\n    console.error('Error extracting image dimensions:', error)\n    return { width: undefined, height: undefined }\n  }\n}\n\n/**\n * Resize an image buffer to the specified dimensions\n * @param buffer - The image buffer to resize\n * @param width - Target width (optional)\n * @param height - Target height (optional)\n * @param format - Output format ('png', 'jpeg', 'webp'), auto-detected if not provided\n */\nexport async function resizeImage(\n  buffer: Buffer,\n  width?: number,\n  height?: number,\n  format?: 'png' | 'jpeg' | 'webp',\n): Promise<Buffer> {\n  let pipeline = sharp(buffer)\n\n  // Apply resize if dimensions provided\n  if (width || height) {\n    pipeline = pipeline.resize({\n      width,\n      height,\n      fit: 'inside',\n      withoutEnlargement: true,\n    })\n  }\n\n  // Apply format conversion if specified\n  if (format === 'png') {\n    pipeline = pipeline.png()\n  } else if (format === 'webp') {\n    pipeline = pipeline.webp()\n  } else if (format === 'jpeg') {\n    pipeline = pipeline.jpeg()\n  }\n\n  return pipeline.toBuffer()\n}\n\n/**\n * Generate SHA-256 checksum for a buffer\n */\nexport function generateChecksum(buffer: Buffer): string {\n  return createHash('sha256').update(buffer).digest('hex')\n}\n\n/**\n * Detect image format from mime type\n */\nexport function getImageFormat(\n  mimeType: string,\n): 'png' | 'webp' | 'jpeg' | null {\n  if (mimeType.includes('png')) return 'png'\n  if (mimeType.includes('webp')) return 'webp'\n  if (mimeType.includes('jpeg') || mimeType.includes('jpg')) return 'jpeg'\n  return null\n}\n\n/**\n * Check if a mime type represents a raster image (not SVG)\n */\nexport function isRasterImage(mimeType: string): boolean {\n  return mimeType.startsWith('image/') && !mimeType.includes('svg')\n}\n\nexport async function parseAssetMeta(\n  p: ParseAssetParams,\n): Promise<ParseAssetReturn> {\n  // Get image dimensions using our utility\n  const { width, height, format, size } = await sharp(p.buffer).metadata()\n\n  const formatToMime: Partial<Record<keyof FormatEnum, string>> = {\n    jpeg: 'image/jpeg',\n    jpg: 'image/jpeg',\n    png: 'image/png',\n    webp: 'image/webp',\n    avif: 'image/avif',\n    tiff: 'image/tiff',\n    gif: 'image/gif',\n    heif: 'image/heif',\n    svg: 'image/svg+xml',\n    raw: 'application/octet-stream',\n  }\n\n  return {\n    checksum: generateChecksum(p.buffer),\n    width,\n    height,\n    mimeType: format\n      ? (formatToMime[format] ?? `image/${format}`)\n      : 'application/octet-stream',\n    fileSize: size || 0,\n  }\n}\n"],"mappings":";;;;;;;AAQA,eAAsB,mBACpB,QAC8C;AAC9C,KAAI;EACF,MAAM,WAAW,MAAM,MAAM,OAAO,CAAC,UAAU;AAC/C,SAAO;GACL,OAAO,SAAS;GAChB,QAAQ,SAAS;GAClB;UACM,OAAO;AACd,UAAQ,MAAM,sCAAsC,MAAM;AAC1D,SAAO;GAAE,OAAO;GAAW,QAAQ;GAAW;;;;;;;;;;AAWlD,eAAsB,YACpB,QACA,OACA,QACA,QACiB;CACjB,IAAI,WAAW,MAAM,OAAO;AAG5B,KAAI,SAAS,OACX,YAAW,SAAS,OAAO;EACzB;EACA;EACA,KAAK;EACL,oBAAoB;EACrB,CAAC;AAIJ,KAAI,WAAW,MACb,YAAW,SAAS,KAAK;UAChB,WAAW,OACpB,YAAW,SAAS,MAAM;UACjB,WAAW,OACpB,YAAW,SAAS,MAAM;AAG5B,QAAO,SAAS,UAAU;;;;;AAM5B,SAAgB,iBAAiB,QAAwB;AACvD,QAAO,WAAW,SAAS,CAAC,OAAO,OAAO,CAAC,OAAO,MAAM;;;;;AAM1D,SAAgB,eACd,UACgC;AAChC,KAAI,SAAS,SAAS,MAAM,CAAE,QAAO;AACrC,KAAI,SAAS,SAAS,OAAO,CAAE,QAAO;AACtC,KAAI,SAAS,SAAS,OAAO,IAAI,SAAS,SAAS,MAAM,CAAE,QAAO;AAClE,QAAO;;;;;AAMT,SAAgB,cAAc,UAA2B;AACvD,QAAO,SAAS,WAAW,SAAS,IAAI,CAAC,SAAS,SAAS,MAAM;;AAGnE,eAAsB,eACpB,GAC2B;CAE3B,MAAM,EAAE,OAAO,QAAQ,QAAQ,SAAS,MAAM,MAAM,EAAE,OAAO,CAAC,UAAU;AAexE,QAAO;EACL,UAAU,iBAAiB,EAAE,OAAO;EACpC;EACA;EACA,UAAU,SAjBoD;GAC9D,MAAM;GACN,KAAK;GACL,KAAK;GACL,MAAM;GACN,MAAM;GACN,MAAM;GACN,KAAK;GACL,MAAM;GACN,KAAK;GACL,KAAK;GACN,CAOmB,WAAW,SAAS,WAClC;EACJ,UAAU,QAAQ;EACnB"}

package/dist/modules/assets/screenshotRestController.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshotRestController.d.mts","names":[],"sources":["../../../src/modules/assets/screenshotRestController.ts"],"mappings":";;;UAIiB,8BAAA;;AAAjB;;EAIE,QAAA;AAAA;;AAWF;;;;;;;iBAAgB,gCAAA,CACd,MAAA,EAAQ,MAAA,EACR,MAAA,EAAQ,8BAAA"}
+{"version":3,"file":"screenshotRestController.d.mts","names":[],"sources":["../../../src/modules/assets/screenshotRestController.ts"],"mappings":";;;UAKiB,8BAAA;;AAAjB;;EAIE,QAAA;AAAA;;AAWF;;;;;;;iBAAgB,gCAAA,CACd,MAAA,EAAQ,MAAA,EACR,MAAA,EAAQ,8BAAA"}

package/dist/modules/assets/screenshotRestController.mjs

@@ -1,4 +1,5 @@
 import { getDbClient } from "../../db/client.mjs";
+import { isNotModified, setRevalidatingCacheHeaders } from "./assetCache.mjs";
 import sharp from "sharp";
 
 //#region src/modules/assets/screenshotRestController.ts
@@ -90,13 +91,18 @@ function registerScreenshotRestController(router, config) {
 				select: {
 					content: true,
 					mimeType: true,
-					name: true
+					name: true,
+					checksum: true
 				}
 			});
 			if (!screenshot) {
 				res.status(404).json({ error: "Screenshot not found" });
 				return;
 			}
+			if (isNotModified(req, setRevalidatingCacheHeaders(res, screenshot.checksum, targetSize && targetSize > 0 ? `s${targetSize}` : void 0))) {
+				res.status(304).end();
+				return;
+			}
 			let content = screenshot.content;
 			if (targetSize && targetSize > 0) try {
 				content = await sharp(screenshot.content).resize(targetSize, targetSize, {
@@ -108,7 +114,6 @@ function registerScreenshotRestController(router, config) {
 			}
 			res.setHeader("Content-Type", screenshot.mimeType);
 			res.setHeader("Content-Disposition", `inline; filename="${screenshot.name}"`);
-			res.setHeader("Cache-Control", "public, max-age=86400");
 			res.send(content);
 		} catch (error) {
 			console.error("Error fetching screenshot:", error);

package/dist/modules/assets/screenshotRestController.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"screenshotRestController.mjs","names":[],"sources":["../../../src/modules/assets/screenshotRestController.ts"],"sourcesContent":["import type { Request, Response, Router } from 'express'\nimport sharp from 'sharp'\nimport { getDbClient } from '../../db'\n\nexport interface ScreenshotRestControllerConfig {\n  /**\n   * Base path for screenshot endpoints (e.g., '/api/screenshots')\n   */\n  basePath: string\n}\n\n/**\n * Registers REST endpoints for screenshot retrieval\n *\n * Endpoints:\n * - GET {basePath}/app/:appId - Get all screenshots for an app\n * - GET {basePath}/:id - Get screenshot binary by ID\n * - GET {basePath}/:id/metadata - Get screenshot metadata only\n */\nexport function registerScreenshotRestController(\n  router: Router,\n  config: ScreenshotRestControllerConfig,\n): void {\n  const { basePath } = config\n\n  // Get all screenshots for an app\n  router.get(\n    `${basePath}/app/:appSlug`,\n    async (req: Request, res: Response) => {\n      try {\n        const { appSlug } = req.params\n\n        const prisma = getDbClient()\n\n        // Find app by slug\n        const app = await prisma.dbResource.findUnique({\n          where: { slug: appSlug },\n          select: { screenshotIds: true },\n        })\n\n        if (!app) {\n          res.status(404).json({ error: 'App not found' })\n          return\n        }\n\n        // Fetch all screenshots for the app, then sort by screenshotIds order\n        const results = await prisma.dbAsset.findMany({\n          where: {\n            id: { in: app.screenshotIds },\n            assetType: 'screenshot',\n          },\n          select: {\n            id: true,\n            name: true,\n            mimeType: true,\n            fileSize: true,\n            width: true,\n            height: true,\n            createdAt: true,\n          },\n        })\n\n        const screenshots = app.screenshotIds\n          .map((id) => results.find((r) => r.id === id))\n          .filter((r) => r !== undefined)\n\n        res.json(screenshots)\n      } catch (error) {\n        console.error('Error fetching app screenshots:', error)\n        res.status(500).json({ error: 'Failed to fetch screenshots' })\n      }\n    },\n  )\n\n  // Get first screenshot for an app (convenience endpoint)\n  router.get(\n    `${basePath}/app/:appSlug/first`,\n    async (req: Request, res: Response) => {\n      try {\n        const { appSlug } = req.params\n\n        const prisma = getDbClient()\n\n        // Find app by slug\n        const app = await prisma.dbResource.findUnique({\n          where: { slug: appSlug },\n          select: { screenshotIds: true },\n        })\n\n        if (!app || app.screenshotIds.length === 0) {\n          res.status(404).json({ error: 'No screenshots found' })\n          return\n        }\n\n        // Fetch first screenshot\n        const screenshot = await prisma.dbAsset.findUnique({\n          where: { id: app.screenshotIds[0] },\n          select: {\n            id: true,\n            name: true,\n            mimeType: true,\n            fileSize: true,\n            width: true,\n            height: true,\n            createdAt: true,\n          },\n        })\n\n        if (!screenshot) {\n          res.status(404).json({ error: 'Screenshot not found' })\n          return\n        }\n\n        res.json(screenshot)\n      } catch (error) {\n        console.error('Error fetching first screenshot:', error)\n        res.status(500).json({ error: 'Failed to fetch screenshot' })\n      }\n    },\n  )\n\n  // Get screenshot binary by ID\n  router.get(`${basePath}/:id`, async (req: Request, res: Response) => {\n    try {\n      const { id } = req.params\n      const sizeParam = req.query.size as string | undefined\n      const targetSize = sizeParam ? parseInt(sizeParam, 10) : undefined\n\n      const prisma = getDbClient()\n      const screenshot = await prisma.dbAsset.findUnique({\n        where: { id },\n        select: {\n          content: true,\n          mimeType: true,\n          name: true,\n        },\n      })\n\n      if (!screenshot) {\n        res.status(404).json({ error: 'Screenshot not found' })\n        return\n      }\n\n      let content: Uint8Array | Buffer = screenshot.content\n\n      // Resize if size parameter provided\n      if (targetSize && targetSize > 0) {\n        try {\n          content = await sharp(screenshot.content)\n            .resize(targetSize, targetSize, {\n              fit: 'inside',\n              withoutEnlargement: true,\n            })\n            .toBuffer()\n        } catch (resizeError) {\n          console.error('Error resizing screenshot:', resizeError)\n          // Fall back to original if resize fails\n        }\n      }\n\n      // Set appropriate headers\n      res.setHeader('Content-Type', screenshot.mimeType)\n      res.setHeader(\n        'Content-Disposition',\n        `inline; filename=\"${screenshot.name}\"`,\n      )\n      res.setHeader('Cache-Control', 'public, max-age=86400') // Cache for 1 day\n\n      // Send binary content\n      res.send(content)\n    } catch (error) {\n      console.error('Error fetching screenshot:', error)\n      res.status(500).json({ error: 'Failed to fetch screenshot' })\n    }\n  })\n\n  // Get screenshot metadata only (no binary content)\n  router.get(\n    `${basePath}/:id/metadata`,\n    async (req: Request, res: Response) => {\n      try {\n        const { id } = req.params\n\n        const prisma = getDbClient()\n        const screenshot = await prisma.dbAsset.findUnique({\n          where: { id },\n          select: {\n            id: true,\n            name: true,\n            mimeType: true,\n            fileSize: true,\n            width: true,\n            height: true,\n            createdAt: true,\n            updatedAt: true,\n          },\n        })\n\n        if (!screenshot) {\n          res.status(404).json({ error: 'Screenshot not found' })\n          return\n        }\n\n        res.json(screenshot)\n      } catch (error) {\n        console.error('Error fetching screenshot metadata:', error)\n        res.status(500).json({ error: 'Failed to fetch screenshot metadata' })\n      }\n    },\n  )\n}\n"],"mappings":"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"}
+{"version":3,"file":"screenshotRestController.mjs","names":[],"sources":["../../../src/modules/assets/screenshotRestController.ts"],"sourcesContent":["import type { Request, Response, Router } from 'express'\nimport sharp from 'sharp'\nimport { getDbClient } from '../../db'\nimport { isNotModified, setRevalidatingCacheHeaders } from './assetCache'\n\nexport interface ScreenshotRestControllerConfig {\n  /**\n   * Base path for screenshot endpoints (e.g., '/api/screenshots')\n   */\n  basePath: string\n}\n\n/**\n * Registers REST endpoints for screenshot retrieval\n *\n * Endpoints:\n * - GET {basePath}/app/:appId - Get all screenshots for an app\n * - GET {basePath}/:id - Get screenshot binary by ID\n * - GET {basePath}/:id/metadata - Get screenshot metadata only\n */\nexport function registerScreenshotRestController(\n  router: Router,\n  config: ScreenshotRestControllerConfig,\n): void {\n  const { basePath } = config\n\n  // Get all screenshots for an app\n  router.get(\n    `${basePath}/app/:appSlug`,\n    async (req: Request, res: Response) => {\n      try {\n        const { appSlug } = req.params\n\n        const prisma = getDbClient()\n\n        // Find app by slug\n        const app = await prisma.dbResource.findUnique({\n          where: { slug: appSlug },\n          select: { screenshotIds: true },\n        })\n\n        if (!app) {\n          res.status(404).json({ error: 'App not found' })\n          return\n        }\n\n        // Fetch all screenshots for the app, then sort by screenshotIds order\n        const results = await prisma.dbAsset.findMany({\n          where: {\n            id: { in: app.screenshotIds },\n            assetType: 'screenshot',\n          },\n          select: {\n            id: true,\n            name: true,\n            mimeType: true,\n            fileSize: true,\n            width: true,\n            height: true,\n            createdAt: true,\n          },\n        })\n\n        const screenshots = app.screenshotIds\n          .map((id) => results.find((r) => r.id === id))\n          .filter((r) => r !== undefined)\n\n        res.json(screenshots)\n      } catch (error) {\n        console.error('Error fetching app screenshots:', error)\n        res.status(500).json({ error: 'Failed to fetch screenshots' })\n      }\n    },\n  )\n\n  // Get first screenshot for an app (convenience endpoint)\n  router.get(\n    `${basePath}/app/:appSlug/first`,\n    async (req: Request, res: Response) => {\n      try {\n        const { appSlug } = req.params\n\n        const prisma = getDbClient()\n\n        // Find app by slug\n        const app = await prisma.dbResource.findUnique({\n          where: { slug: appSlug },\n          select: { screenshotIds: true },\n        })\n\n        if (!app || app.screenshotIds.length === 0) {\n          res.status(404).json({ error: 'No screenshots found' })\n          return\n        }\n\n        // Fetch first screenshot\n        const screenshot = await prisma.dbAsset.findUnique({\n          where: { id: app.screenshotIds[0] },\n          select: {\n            id: true,\n            name: true,\n            mimeType: true,\n            fileSize: true,\n            width: true,\n            height: true,\n            createdAt: true,\n          },\n        })\n\n        if (!screenshot) {\n          res.status(404).json({ error: 'Screenshot not found' })\n          return\n        }\n\n        res.json(screenshot)\n      } catch (error) {\n        console.error('Error fetching first screenshot:', error)\n        res.status(500).json({ error: 'Failed to fetch screenshot' })\n      }\n    },\n  )\n\n  // Get screenshot binary by ID\n  router.get(`${basePath}/:id`, async (req: Request, res: Response) => {\n    try {\n      const { id } = req.params\n      const sizeParam = req.query.size as string | undefined\n      const targetSize = sizeParam ? parseInt(sizeParam, 10) : undefined\n\n      const prisma = getDbClient()\n      const screenshot = await prisma.dbAsset.findUnique({\n        where: { id },\n        select: {\n          content: true,\n          mimeType: true,\n          name: true,\n          checksum: true,\n        },\n      })\n\n      if (!screenshot) {\n        res.status(404).json({ error: 'Screenshot not found' })\n        return\n      }\n\n      // Answered before resizing, so an unchanged screenshot costs no image work.\n      const etag = setRevalidatingCacheHeaders(\n        res,\n        screenshot.checksum,\n        targetSize && targetSize > 0 ? `s${targetSize}` : undefined,\n      )\n      if (isNotModified(req, etag)) {\n        res.status(304).end()\n        return\n      }\n\n      let content: Uint8Array | Buffer = screenshot.content\n\n      // Resize if size parameter provided\n      if (targetSize && targetSize > 0) {\n        try {\n          content = await sharp(screenshot.content)\n            .resize(targetSize, targetSize, {\n              fit: 'inside',\n              withoutEnlargement: true,\n            })\n            .toBuffer()\n        } catch (resizeError) {\n          console.error('Error resizing screenshot:', resizeError)\n          // Fall back to original if resize fails\n        }\n      }\n\n      // Set appropriate headers\n      res.setHeader('Content-Type', screenshot.mimeType)\n      res.setHeader(\n        'Content-Disposition',\n        `inline; filename=\"${screenshot.name}\"`,\n      )\n\n      // Send binary content\n      res.send(content)\n    } catch (error) {\n      console.error('Error fetching screenshot:', error)\n      res.status(500).json({ error: 'Failed to fetch screenshot' })\n    }\n  })\n\n  // Get screenshot metadata only (no binary content)\n  router.get(\n    `${basePath}/:id/metadata`,\n    async (req: Request, res: Response) => {\n      try {\n        const { id } = req.params\n\n        const prisma = getDbClient()\n        const screenshot = await prisma.dbAsset.findUnique({\n          where: { id },\n          select: {\n            id: true,\n            name: true,\n            mimeType: true,\n            fileSize: true,\n            width: true,\n            height: true,\n            createdAt: true,\n            updatedAt: true,\n          },\n        })\n\n        if (!screenshot) {\n          res.status(404).json({ error: 'Screenshot not found' })\n          return\n        }\n\n        res.json(screenshot)\n      } catch (error) {\n        console.error('Error fetching screenshot metadata:', error)\n        res.status(500).json({ error: 'Failed to fetch screenshot metadata' })\n      }\n    },\n  )\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,SAAgB,iCACd,QACA,QACM;CACN,MAAM,EAAE,aAAa;AAGrB,QAAO,IACL,GAAG,SAAS,gBACZ,OAAO,KAAc,QAAkB;AACrC,MAAI;GACF,MAAM,EAAE,YAAY,IAAI;GAExB,MAAM,SAAS,aAAa;GAG5B,MAAM,MAAM,MAAM,OAAO,WAAW,WAAW;IAC7C,OAAO,EAAE,MAAM,SAAS;IACxB,QAAQ,EAAE,eAAe,MAAM;IAChC,CAAC;AAEF,OAAI,CAAC,KAAK;AACR,QAAI,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,iBAAiB,CAAC;AAChD;;GAIF,MAAM,UAAU,MAAM,OAAO,QAAQ,SAAS;IAC5C,OAAO;KACL,IAAI,EAAE,IAAI,IAAI,eAAe;KAC7B,WAAW;KACZ;IACD,QAAQ;KACN,IAAI;KACJ,MAAM;KACN,UAAU;KACV,UAAU;KACV,OAAO;KACP,QAAQ;KACR,WAAW;KACZ;IACF,CAAC;GAEF,MAAM,cAAc,IAAI,cACrB,KAAK,OAAO,QAAQ,MAAM,MAAM,EAAE,OAAO,GAAG,CAAC,CAC7C,QAAQ,MAAM,MAAM,OAAU;AAEjC,OAAI,KAAK,YAAY;WACd,OAAO;AACd,WAAQ,MAAM,mCAAmC,MAAM;AACvD,OAAI,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,+BAA+B,CAAC;;GAGnE;AAGD,QAAO,IACL,GAAG,SAAS,sBACZ,OAAO,KAAc,QAAkB;AACrC,MAAI;GACF,MAAM,EAAE,YAAY,IAAI;GAExB,MAAM,SAAS,aAAa;GAG5B,MAAM,MAAM,MAAM,OAAO,WAAW,WAAW;IAC7C,OAAO,EAAE,MAAM,SAAS;IACxB,QAAQ,EAAE,eAAe,MAAM;IAChC,CAAC;AAEF,OAAI,CAAC,OAAO,IAAI,cAAc,WAAW,GAAG;AAC1C,QAAI,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,wBAAwB,CAAC;AACvD;;GAIF,MAAM,aAAa,MAAM,OAAO,QAAQ,WAAW;IACjD,OAAO,EAAE,IAAI,IAAI,cAAc,IAAI;IACnC,QAAQ;KACN,IAAI;KACJ,MAAM;KACN,UAAU;KACV,UAAU;KACV,OAAO;KACP,QAAQ;KACR,WAAW;KACZ;IACF,CAAC;AAEF,OAAI,CAAC,YAAY;AACf,QAAI,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,wBAAwB,CAAC;AACvD;;AAGF,OAAI,KAAK,WAAW;WACb,OAAO;AACd,WAAQ,MAAM,oCAAoC,MAAM;AACxD,OAAI,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,8BAA8B,CAAC;;GAGlE;AAGD,QAAO,IAAI,GAAG,SAAS,OAAO,OAAO,KAAc,QAAkB;AACnE,MAAI;GACF,MAAM,EAAE,OAAO,IAAI;GACnB,MAAM,YAAY,IAAI,MAAM;GAC5B,MAAM,aAAa,YAAY,SAAS,WAAW,GAAG,GAAG;GAGzD,MAAM,aAAa,MADJ,aAAa,CACI,QAAQ,WAAW;IACjD,OAAO,EAAE,IAAI;IACb,QAAQ;KACN,SAAS;KACT,UAAU;KACV,MAAM;KACN,UAAU;KACX;IACF,CAAC;AAEF,OAAI,CAAC,YAAY;AACf,QAAI,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,wBAAwB,CAAC;AACvD;;AASF,OAAI,cAAc,KALL,4BACX,KACA,WAAW,UACX,cAAc,aAAa,IAAI,IAAI,eAAe,OACnD,CAC2B,EAAE;AAC5B,QAAI,OAAO,IAAI,CAAC,KAAK;AACrB;;GAGF,IAAI,UAA+B,WAAW;AAG9C,OAAI,cAAc,aAAa,EAC7B,KAAI;AACF,cAAU,MAAM,MAAM,WAAW,QAAQ,CACtC,OAAO,YAAY,YAAY;KAC9B,KAAK;KACL,oBAAoB;KACrB,CAAC,CACD,UAAU;YACN,aAAa;AACpB,YAAQ,MAAM,8BAA8B,YAAY;;AAM5D,OAAI,UAAU,gBAAgB,WAAW,SAAS;AAClD,OAAI,UACF,uBACA,qBAAqB,WAAW,KAAK,GACtC;AAGD,OAAI,KAAK,QAAQ;WACV,OAAO;AACd,WAAQ,MAAM,8BAA8B,MAAM;AAClD,OAAI,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,8BAA8B,CAAC;;GAE/D;AAGF,QAAO,IACL,GAAG,SAAS,gBACZ,OAAO,KAAc,QAAkB;AACrC,MAAI;GACF,MAAM,EAAE,OAAO,IAAI;GAGnB,MAAM,aAAa,MADJ,aAAa,CACI,QAAQ,WAAW;IACjD,OAAO,EAAE,IAAI;IACb,QAAQ;KACN,IAAI;KACJ,MAAM;KACN,UAAU;KACV,UAAU;KACV,OAAO;KACP,QAAQ;KACR,WAAW;KACX,WAAW;KACZ;IACF,CAAC;AAEF,OAAI,CAAC,YAAY;AACf,QAAI,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,wBAAwB,CAAC;AACvD;;AAGF,OAAI,KAAK,WAAW;WACb,OAAO;AACd,WAAQ,MAAM,uCAAuC,MAAM;AAC3D,OAAI,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,uCAAuC,CAAC;;GAG3E"}

package/dist/modules/assets/upsertAsset.mjs

@@ -7,7 +7,13 @@ async function upsertAsset({ prisma, buffer, name, originalFilename, assetType }
 		originalFilename
 	});
 	const existing = await prisma.dbAsset.findUnique({ where: { name } });
-	if (existing) return existing.id;
+	if (existing) {
+		if (existing.mimeType !== mimeType) await prisma.dbAsset.update({
+			where: { id: existing.id },
+			data: { mimeType }
+		});
+		return existing.id;
+	}
 	return (await prisma.dbAsset.create({ data: {
 		name,
 		checksum,

package/dist/modules/assets/upsertAsset.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"upsertAsset.mjs","names":[],"sources":["../../../src/modules/assets/upsertAsset.ts"],"sourcesContent":["import { parseAssetMeta } from './assetUtils'\nimport type { AssetType, PrismaClient } from '../../generated/prisma/client'\n\nexport interface UpsertAssetParams {\n  prisma: PrismaClient\n  buffer: Buffer\n  name: string\n  originalFilename: string\n  assetType: AssetType\n}\n\nexport async function upsertAsset({\n  prisma,\n  buffer,\n  name,\n  originalFilename,\n  assetType,\n}: UpsertAssetParams) {\n  const { checksum, fileSize, width, height, mimeType } = await parseAssetMeta({\n    buffer,\n    originalFilename,\n  })\n\n  // If an asset with the same checksum already exists, reuse it instead of storing duplicate binary.\n  const existing = await prisma.dbAsset.findUnique({\n    where: { name },\n  })\n\n  if (existing) {\n    return existing.id\n  }\n\n  const asset = await prisma.dbAsset.create({\n    data: {\n      name,\n      checksum,\n      assetType,\n      content: new Uint8Array(buffer),\n      mimeType,\n      fileSize,\n      width,\n      height,\n    },\n  })\n  return asset.id\n}\n"],"mappings":";;;AAWA,eAAsB,YAAY,EAChC,QACA,QACA,MACA,kBACA,aACoB;CACpB,MAAM,EAAE,UAAU,UAAU,OAAO,QAAQ,aAAa,MAAM,eAAe;EAC3E;EACA;EACD,CAAC;CAGF,MAAM,WAAW,MAAM,OAAO,QAAQ,WAAW,EAC/C,OAAO,EAAE,MAAM,EAChB,CAAC;AAEF,KAAI,SACF,QAAO,SAAS;AAelB,SAZc,MAAM,OAAO,QAAQ,OAAO,EACxC,MAAM;EACJ;EACA;EACA;EACA,SAAS,IAAI,WAAW,OAAO;EAC/B;EACA;EACA;EACA;EACD,EACF,CAAC,EACW"}
+{"version":3,"file":"upsertAsset.mjs","names":[],"sources":["../../../src/modules/assets/upsertAsset.ts"],"sourcesContent":["import { parseAssetMeta } from './assetUtils'\nimport type { AssetType, PrismaClient } from '../../generated/prisma/client'\n\nexport interface UpsertAssetParams {\n  prisma: PrismaClient\n  buffer: Buffer\n  name: string\n  originalFilename: string\n  assetType: AssetType\n}\n\nexport async function upsertAsset({\n  prisma,\n  buffer,\n  name,\n  originalFilename,\n  assetType,\n}: UpsertAssetParams) {\n  const { checksum, fileSize, width, height, mimeType } = await parseAssetMeta({\n    buffer,\n    originalFilename,\n  })\n\n  // If an asset with the same checksum already exists, reuse it instead of storing duplicate binary.\n  const existing = await prisma.dbAsset.findUnique({\n    where: { name },\n  })\n\n  if (existing) {\n    // Reusing the stored binary must not keep a mimeType we no longer derive:\n    // rows written by an older, wrong derivation would never be corrected.\n    if (existing.mimeType !== mimeType) {\n      await prisma.dbAsset.update({\n        where: { id: existing.id },\n        data: { mimeType },\n      })\n    }\n    return existing.id\n  }\n\n  const asset = await prisma.dbAsset.create({\n    data: {\n      name,\n      checksum,\n      assetType,\n      content: new Uint8Array(buffer),\n      mimeType,\n      fileSize,\n      width,\n      height,\n    },\n  })\n  return asset.id\n}\n"],"mappings":";;;AAWA,eAAsB,YAAY,EAChC,QACA,QACA,MACA,kBACA,aACoB;CACpB,MAAM,EAAE,UAAU,UAAU,OAAO,QAAQ,aAAa,MAAM,eAAe;EAC3E;EACA;EACD,CAAC;CAGF,MAAM,WAAW,MAAM,OAAO,QAAQ,WAAW,EAC/C,OAAO,EAAE,MAAM,EAChB,CAAC;AAEF,KAAI,UAAU;AAGZ,MAAI,SAAS,aAAa,SACxB,OAAM,OAAO,QAAQ,OAAO;GAC1B,OAAO,EAAE,IAAI,SAAS,IAAI;GAC1B,MAAM,EAAE,UAAU;GACnB,CAAC;AAEJ,SAAO,SAAS;;AAelB,SAZc,MAAM,OAAO,QAAQ,OAAO,EACxC,MAAM;EACJ;EACA;EACA;EACA,SAAS,IAAI,WAAW,OAAO;EAC/B;EACA;EACA;EACA;EACD,EACF,CAAC,EACW"}

package/dist/modules/icons/iconRestController.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"iconRestController.d.mts","names":[],"sources":["../../../src/modules/icons/iconRestController.ts"],"mappings":";;;UAsBiB,wBAAA;;AAAjB;;EAIE,QAAA;AAAA;;AAWF;;;;;;;iBAAgB,0BAAA,CACd,MAAA,EAAQ,MAAA,EACR,MAAA,EAAQ,wBAAA"}
+{"version":3,"file":"iconRestController.d.mts","names":[],"sources":["../../../src/modules/icons/iconRestController.ts"],"mappings":";;;UA0BiB,wBAAA;;AAAjB;;EAIE,QAAA;AAAA;;AAWF;;;;;;;iBAAgB,0BAAA,CACd,MAAA,EAAQ,MAAA,EACR,MAAA,EAAQ,wBAAA"}

package/dist/modules/icons/iconRestController.mjs

@@ -1,5 +1,6 @@
 import { getDbClient } from "../../db/client.mjs";
 import { getExtensionFromFilename, getExtensionFromMimeType } from "./iconUtils.mjs";
+import { isNotModified, setRevalidatingCacheHeaders } from "../assets/assetCache.mjs";
 import { createHash } from "node:crypto";
 import multer from "multer";
 
@@ -71,16 +72,20 @@ function registerIconRestController(router, config) {
 				select: {
 					content: true,
 					mimeType: true,
-					name: true
+					name: true,
+					checksum: true
 				}
 			});
 			if (!icon) {
 				res.status(404).json({ error: "Icon not found" });
 				return;
 			}
+			if (isNotModified(req, setRevalidatingCacheHeaders(res, icon.checksum))) {
+				res.status(304).end();
+				return;
+			}
 			res.setHeader("Content-Type", icon.mimeType);
 			res.setHeader("Content-Disposition", `inline; filename="${icon.name}"`);
-			res.setHeader("Cache-Control", "public, max-age=86400");
 			res.send(icon.content);
 		} catch (error) {
 			console.error("Error fetching icon:", error);

package/dist/modules/icons/iconRestController.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"iconRestController.mjs","names":[],"sources":["../../../src/modules/icons/iconRestController.ts"],"sourcesContent":["import type { Request, Response, Router } from 'express'\nimport multer from 'multer'\nimport { createHash } from 'node:crypto'\nimport { getDbClient } from '../../db'\nimport { getExtensionFromFilename, getExtensionFromMimeType } from './iconUtils'\n\n// Configure multer for memory storage\nconst upload = multer({\n  storage: multer.memoryStorage(),\n  limits: {\n    fileSize: 10 * 1024 * 1024, // 10MB limit\n  },\n  fileFilter: (_req, file, cb) => {\n    // Accept images only\n    if (!file.mimetype.startsWith('image/')) {\n      cb(new Error('Only image files are allowed'))\n      return\n    }\n    cb(null, true)\n  },\n})\n\nexport interface IconRestControllerConfig {\n  /**\n   * Base path for icon endpoints (e.g., '/api/icons')\n   */\n  basePath: string\n}\n\n/**\n * Registers REST endpoints for icon upload and retrieval\n *\n * Endpoints:\n * - POST {basePath}/upload - Upload a new icon (multipart/form-data with 'icon' field and 'name' field)\n * - GET {basePath}/:id - Get icon binary by ID\n * - GET {basePath}/:id/metadata - Get icon metadata only\n */\nexport function registerIconRestController(\n  router: Router,\n  config: IconRestControllerConfig,\n): void {\n  const { basePath } = config\n\n  // Upload endpoint - accepts multipart/form-data\n  router.post(\n    `${basePath}/upload`,\n    upload.single('icon'),\n    async (req: Request, res: Response) => {\n      try {\n        if (!req.file) {\n          res.status(400).json({ error: 'No file uploaded' })\n          return\n        }\n\n        let name = req.body['name'] as string\n        if (!name) {\n          res.status(400).json({ error: 'Name is required' })\n          return\n        }\n\n        // Extract extension from original filename or derive from MIME type\n        const extension =\n          getExtensionFromFilename(req.file.originalname) ||\n          getExtensionFromMimeType(req.file.mimetype)\n\n        // Add extension to name if not already present\n        if (!name.includes('.')) {\n          name = `${name}.${extension}`\n        }\n\n        const prisma = getDbClient()\n        const checksum = createHash('sha256')\n          .update(req.file.buffer)\n          .digest('hex')\n        const icon = await prisma.dbAsset.create({\n          data: {\n            name,\n            assetType: 'icon',\n            content: new Uint8Array(req.file.buffer),\n            mimeType: req.file.mimetype,\n            fileSize: req.file.size,\n            checksum,\n          },\n        })\n\n        res.status(201).json({\n          id: icon.id,\n          name: icon.name,\n          mimeType: icon.mimeType,\n          fileSize: icon.fileSize,\n          createdAt: icon.createdAt,\n        })\n      } catch (error) {\n        console.error('Error uploading icon:', error)\n        res.status(500).json({ error: 'Failed to upload icon' })\n      }\n    },\n  )\n\n  // Get icon binary by name (e.g., /api/icons/jira.svg)\n  router.get(`${basePath}/:name`, async (req: Request, res: Response) => {\n    try {\n      const { name } = req.params\n\n      const prisma = getDbClient()\n      const icon = await prisma.dbAsset.findFirst({\n        where: {\n          name,\n          assetType: 'icon',\n        },\n        select: {\n          content: true,\n          mimeType: true,\n          name: true,\n        },\n      })\n\n      if (!icon) {\n        res.status(404).json({ error: 'Icon not found' })\n        return\n      }\n\n      // Set appropriate headers\n      res.setHeader('Content-Type', icon.mimeType)\n      res.setHeader('Content-Disposition', `inline; filename=\"${icon.name}\"`)\n      res.setHeader('Cache-Control', 'public, max-age=86400') // Cache for 1 day\n\n      // Send binary content\n      res.send(icon.content)\n    } catch (error) {\n      console.error('Error fetching icon:', error)\n      res.status(500).json({ error: 'Failed to fetch icon' })\n    }\n  })\n\n  // Get icon metadata only (no binary content)\n  router.get(\n    `${basePath}/:name/metadata`,\n    async (req: Request, res: Response) => {\n      try {\n        const { name } = req.params\n\n        const prisma = getDbClient()\n        const icon = await prisma.dbAsset.findFirst({\n          where: {\n            name,\n            assetType: 'icon',\n          },\n          select: {\n            id: true,\n            name: true,\n            mimeType: true,\n            fileSize: true,\n            createdAt: true,\n            updatedAt: true,\n          },\n        })\n\n        if (!icon) {\n          res.status(404).json({ error: 'Icon not found' })\n          return\n        }\n\n        res.json(icon)\n      } catch (error) {\n        console.error('Error fetching icon metadata:', error)\n        res.status(500).json({ error: 'Failed to fetch icon metadata' })\n      }\n    },\n  )\n}\n"],"mappings":"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"}
+{"version":3,"file":"iconRestController.mjs","names":[],"sources":["../../../src/modules/icons/iconRestController.ts"],"sourcesContent":["import type { Request, Response, Router } from 'express'\nimport multer from 'multer'\nimport { createHash } from 'node:crypto'\nimport { getDbClient } from '../../db'\nimport { getExtensionFromFilename, getExtensionFromMimeType } from './iconUtils'\nimport {\n  isNotModified,\n  setRevalidatingCacheHeaders,\n} from '../assets/assetCache'\n\n// Configure multer for memory storage\nconst upload = multer({\n  storage: multer.memoryStorage(),\n  limits: {\n    fileSize: 10 * 1024 * 1024, // 10MB limit\n  },\n  fileFilter: (_req, file, cb) => {\n    // Accept images only\n    if (!file.mimetype.startsWith('image/')) {\n      cb(new Error('Only image files are allowed'))\n      return\n    }\n    cb(null, true)\n  },\n})\n\nexport interface IconRestControllerConfig {\n  /**\n   * Base path for icon endpoints (e.g., '/api/icons')\n   */\n  basePath: string\n}\n\n/**\n * Registers REST endpoints for icon upload and retrieval\n *\n * Endpoints:\n * - POST {basePath}/upload - Upload a new icon (multipart/form-data with 'icon' field and 'name' field)\n * - GET {basePath}/:id - Get icon binary by ID\n * - GET {basePath}/:id/metadata - Get icon metadata only\n */\nexport function registerIconRestController(\n  router: Router,\n  config: IconRestControllerConfig,\n): void {\n  const { basePath } = config\n\n  // Upload endpoint - accepts multipart/form-data\n  router.post(\n    `${basePath}/upload`,\n    upload.single('icon'),\n    async (req: Request, res: Response) => {\n      try {\n        if (!req.file) {\n          res.status(400).json({ error: 'No file uploaded' })\n          return\n        }\n\n        let name = req.body['name'] as string\n        if (!name) {\n          res.status(400).json({ error: 'Name is required' })\n          return\n        }\n\n        // Extract extension from original filename or derive from MIME type\n        const extension =\n          getExtensionFromFilename(req.file.originalname) ||\n          getExtensionFromMimeType(req.file.mimetype)\n\n        // Add extension to name if not already present\n        if (!name.includes('.')) {\n          name = `${name}.${extension}`\n        }\n\n        const prisma = getDbClient()\n        const checksum = createHash('sha256')\n          .update(req.file.buffer)\n          .digest('hex')\n        const icon = await prisma.dbAsset.create({\n          data: {\n            name,\n            assetType: 'icon',\n            content: new Uint8Array(req.file.buffer),\n            mimeType: req.file.mimetype,\n            fileSize: req.file.size,\n            checksum,\n          },\n        })\n\n        res.status(201).json({\n          id: icon.id,\n          name: icon.name,\n          mimeType: icon.mimeType,\n          fileSize: icon.fileSize,\n          createdAt: icon.createdAt,\n        })\n      } catch (error) {\n        console.error('Error uploading icon:', error)\n        res.status(500).json({ error: 'Failed to upload icon' })\n      }\n    },\n  )\n\n  // Get icon binary by name (e.g., /api/icons/jira.svg)\n  router.get(`${basePath}/:name`, async (req: Request, res: Response) => {\n    try {\n      const { name } = req.params\n\n      const prisma = getDbClient()\n      const icon = await prisma.dbAsset.findFirst({\n        where: {\n          name,\n          assetType: 'icon',\n        },\n        select: {\n          content: true,\n          mimeType: true,\n          name: true,\n          checksum: true,\n        },\n      })\n\n      if (!icon) {\n        res.status(404).json({ error: 'Icon not found' })\n        return\n      }\n\n      const etag = setRevalidatingCacheHeaders(res, icon.checksum)\n      if (isNotModified(req, etag)) {\n        res.status(304).end()\n        return\n      }\n\n      // Set appropriate headers\n      res.setHeader('Content-Type', icon.mimeType)\n      res.setHeader('Content-Disposition', `inline; filename=\"${icon.name}\"`)\n\n      // Send binary content\n      res.send(icon.content)\n    } catch (error) {\n      console.error('Error fetching icon:', error)\n      res.status(500).json({ error: 'Failed to fetch icon' })\n    }\n  })\n\n  // Get icon metadata only (no binary content)\n  router.get(\n    `${basePath}/:name/metadata`,\n    async (req: Request, res: Response) => {\n      try {\n        const { name } = req.params\n\n        const prisma = getDbClient()\n        const icon = await prisma.dbAsset.findFirst({\n          where: {\n            name,\n            assetType: 'icon',\n          },\n          select: {\n            id: true,\n            name: true,\n            mimeType: true,\n            fileSize: true,\n            createdAt: true,\n            updatedAt: true,\n          },\n        })\n\n        if (!icon) {\n          res.status(404).json({ error: 'Icon not found' })\n          return\n        }\n\n        res.json(icon)\n      } catch (error) {\n        console.error('Error fetching icon metadata:', error)\n        res.status(500).json({ error: 'Failed to fetch icon metadata' })\n      }\n    },\n  )\n}\n"],"mappings":"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"}

package/dist/modules/lighthouseKeeper/tools.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.mts","names":[],"sources":["../../../src/modules/lighthouseKeeper/tools.ts"],"mappings":";;;;;;AA0BA;;iBAAgB,uBAAA,CACd,cAAA,EAAgB,gBAAA,GACf,MAAA,SAAe,IAAA;;;;;cAuEL,4BAAA"}
+{"version":3,"file":"tools.d.mts","names":[],"sources":["../../../src/modules/lighthouseKeeper/tools.ts"],"mappings":";;;;;;AAwBA;;iBAAgB,uBAAA,CACd,cAAA,EAAgB,gBAAA,GACf,MAAA,SAAe,IAAA;;;;;cAwEL,4BAAA"}

package/dist/modules/lighthouseKeeper/tools.mjs

@@ -1,6 +1,4 @@
-import { PrismaClient } from "../../generated/prisma/client.mjs";
-import { PrismaPg } from "@prisma/adapter-pg";
-import pg from "pg";
+import { createCorePrismaClient } from "../../db/client.mjs";
 import { z } from "zod";
 
 //#region src/modules/lighthouseKeeper/tools.ts
@@ -14,8 +12,10 @@ function getDatabaseUrl(config) {
 * These tools allow the AI to fetch and inspect app information.
 */
 function createAppCatalogAITools(databaseConfig) {
-	const databaseUrl = getDatabaseUrl(databaseConfig);
-	const prisma = new PrismaClient({ adapter: new PrismaPg(new pg.Pool({ connectionString: databaseUrl })) });
+	const { client: prisma } = createCorePrismaClient({
+		connectionString: getDatabaseUrl(databaseConfig),
+		configuredSchema: "url" in databaseConfig ? void 0 : databaseConfig.schema
+	});
 	return { getAppCard: {
 		description: "Fetch complete app catalog card information by ID. Returns title, description, tags, access request details, links, and all other app metadata.",
 		inputSchema: z.object({ slug: z.string().describe("The app slug to fetch") }),

package/dist/modules/lighthouseKeeper/tools.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tools.mjs","names":[],"sources":["../../../src/modules/lighthouseKeeper/tools.ts"],"sourcesContent":["import type { Tool } from 'ai'\nimport { z } from 'zod'\nimport { PrismaClient } from '../../generated/prisma/client'\nimport { PrismaPg } from '@prisma/adapter-pg'\nimport pg from 'pg'\nimport type { AcDatabaseConfig } from '../../middleware/types.js'\n\n// ============================================================================\n// Database URL Helper\n// ============================================================================\n\nfunction getDatabaseUrl(config: AcDatabaseConfig): string {\n  if ('url' in config) return config.url\n  const { host, port, database, username, password, schema } = config\n  const schemaParam = schema ? `?schema=${schema}` : ''\n  return `postgresql://${username}:${password}@${host}:${port}/${database}${schemaParam}`\n}\n\n// ============================================================================\n// AI Tools for App Catalog\n// ============================================================================\n\n/**\n * Create AI tools for working with app catalog cards.\n * These tools allow the AI to fetch and inspect app information.\n */\nexport function createAppCatalogAITools(\n  databaseConfig: AcDatabaseConfig,\n): Record<string, Tool> {\n  const databaseUrl = getDatabaseUrl(databaseConfig)\n  const pool = new pg.Pool({ connectionString: databaseUrl })\n  const adapter = new PrismaPg(pool)\n  const prisma = new PrismaClient({ adapter })\n\n  const getAppCardSchema = z.object({\n    slug: z.string().describe('The app slug to fetch'),\n  })\n\n  type GetAppCardInput = z.infer<typeof getAppCardSchema>\n\n  const getAppCard: Tool<GetAppCardInput, unknown> = {\n    description:\n      'Fetch complete app catalog card information by ID. Returns title, description, tags, access request details, links, and all other app metadata.',\n    inputSchema: getAppCardSchema,\n    execute: async ({ slug }: { slug: string }) => {\n      try {\n        const app = await prisma.dbResource.findUnique({\n          where: { slug },\n          include: {\n            sourceRefs: true,\n          },\n        })\n\n        if (!app) {\n          return { error: `App not found with slug: ${slug}` }\n        }\n\n        // Return structured card data\n        return {\n          success: true,\n          card: {\n            id: app.id,\n            slug: app.slug,\n            displayName: app.displayName,\n            description: app.description,\n            teams: app.teams,\n            tags: app.tags,\n            appUrl: app.appUrl,\n            links: app.links,\n            iconName: app.iconName,\n            sources: app.sourceRefs.map((ref) => ref.url),\n            notes: app.notes,\n            accessRequest: app.accessRequest,\n            deprecated: app.deprecated,\n            createdAt: app.createdAt,\n            updatedAt: app.updatedAt,\n          },\n        }\n      } catch (error) {\n        return {\n          error: error instanceof Error ? error.message : 'Failed to fetch app',\n        }\n      }\n    },\n  }\n\n  return {\n    getAppCard,\n  }\n}\n\n// ============================================================================\n// System Prompt\n// ============================================================================\n\n/**\n * Default system prompt for AI working with app catalog cards.\n * Use this when configuring lighthouseKeeper for card updates.\n */\nexport const APP_CATALOG_AI_SYSTEM_PROMPT = `You are an assistant that helps update app catalog cards based on information from provided links.\n\nWhen given a link and an app ID:\n1. Use getAppCard to fetch the current card information\n2. Analyze the provided link for relevant information\n3. Output a new card structure with updated information based on the link\n\nReturn the updated card as a structured JSON object matching the card format:\n- displayName: App title\n- description: Full description\n- tags: Array of tags\n- teams: Array of team names\n- appUrl: Main application URL\n- links: Array of {url, title} objects for related links\n- sources: Array of source URLs (documentation, Confluence pages, etc.)\n- accessRequest: Object with approvalMethodSlug, comments, requestPrompt, postApprovalInstructions, roles, approverPersonSlugs, urls\n- notes: Additional notes\n- deprecated: Optional deprecation info with type, replacementSlug, comment\n\nDo NOT save the card to the database. Only output the updated structure.`\n"],"mappings":";;;;;;AAWA,SAAS,eAAe,QAAkC;AACxD,KAAI,SAAS,OAAQ,QAAO,OAAO;CACnC,MAAM,EAAE,MAAM,MAAM,UAAU,UAAU,UAAU,WAAW;AAE7D,QAAO,gBAAgB,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,WAD3C,SAAS,WAAW,WAAW;;;;;;AAYrD,SAAgB,wBACd,gBACsB;CACtB,MAAM,cAAc,eAAe,eAAe;CAGlD,MAAM,SAAS,IAAI,aAAa,EAAE,SADlB,IAAI,SADP,IAAI,GAAG,KAAK,EAAE,kBAAkB,aAAa,CAAC,CACzB,EACS,CAAC;AAsD5C,QAAO,EACL,YA/CiD;EACjD,aACE;EACF,aATuB,EAAE,OAAO,EAChC,MAAM,EAAE,QAAQ,CAAC,SAAS,wBAAwB,EACnD,CAAC;EAQA,SAAS,OAAO,EAAE,WAA6B;AAC7C,OAAI;IACF,MAAM,MAAM,MAAM,OAAO,WAAW,WAAW;KAC7C,OAAO,EAAE,MAAM;KACf,SAAS,EACP,YAAY,MACb;KACF,CAAC;AAEF,QAAI,CAAC,IACH,QAAO,EAAE,OAAO,4BAA4B,QAAQ;AAItD,WAAO;KACL,SAAS;KACT,MAAM;MACJ,IAAI,IAAI;MACR,MAAM,IAAI;MACV,aAAa,IAAI;MACjB,aAAa,IAAI;MACjB,OAAO,IAAI;MACX,MAAM,IAAI;MACV,QAAQ,IAAI;MACZ,OAAO,IAAI;MACX,UAAU,IAAI;MACd,SAAS,IAAI,WAAW,KAAK,QAAQ,IAAI,IAAI;MAC7C,OAAO,IAAI;MACX,eAAe,IAAI;MACnB,YAAY,IAAI;MAChB,WAAW,IAAI;MACf,WAAW,IAAI;MAChB;KACF;YACM,OAAO;AACd,WAAO,EACL,OAAO,iBAAiB,QAAQ,MAAM,UAAU,uBACjD;;;EAGN,EAIA;;;;;;AAWH,MAAa,+BAA+B"}
+{"version":3,"file":"tools.mjs","names":[],"sources":["../../../src/modules/lighthouseKeeper/tools.ts"],"sourcesContent":["import type { Tool } from 'ai'\nimport { z } from 'zod'\nimport { createCorePrismaClient } from '../../db/client'\nimport type { AcDatabaseConfig } from '../../middleware/types.js'\n\n// ============================================================================\n// Database URL Helper\n// ============================================================================\n\nfunction getDatabaseUrl(config: AcDatabaseConfig): string {\n  if ('url' in config) return config.url\n  const { host, port, database, username, password, schema } = config\n  const schemaParam = schema ? `?schema=${schema}` : ''\n  return `postgresql://${username}:${password}@${host}:${port}/${database}${schemaParam}`\n}\n\n// ============================================================================\n// AI Tools for App Catalog\n// ============================================================================\n\n/**\n * Create AI tools for working with app catalog cards.\n * These tools allow the AI to fetch and inspect app information.\n */\nexport function createAppCatalogAITools(\n  databaseConfig: AcDatabaseConfig,\n): Record<string, Tool> {\n  const { client: prisma } = createCorePrismaClient({\n    connectionString: getDatabaseUrl(databaseConfig),\n    configuredSchema:\n      'url' in databaseConfig ? undefined : databaseConfig.schema,\n  })\n\n  const getAppCardSchema = z.object({\n    slug: z.string().describe('The app slug to fetch'),\n  })\n\n  type GetAppCardInput = z.infer<typeof getAppCardSchema>\n\n  const getAppCard: Tool<GetAppCardInput, unknown> = {\n    description:\n      'Fetch complete app catalog card information by ID. Returns title, description, tags, access request details, links, and all other app metadata.',\n    inputSchema: getAppCardSchema,\n    execute: async ({ slug }: { slug: string }) => {\n      try {\n        const app = await prisma.dbResource.findUnique({\n          where: { slug },\n          include: {\n            sourceRefs: true,\n          },\n        })\n\n        if (!app) {\n          return { error: `App not found with slug: ${slug}` }\n        }\n\n        // Return structured card data\n        return {\n          success: true,\n          card: {\n            id: app.id,\n            slug: app.slug,\n            displayName: app.displayName,\n            description: app.description,\n            teams: app.teams,\n            tags: app.tags,\n            appUrl: app.appUrl,\n            links: app.links,\n            iconName: app.iconName,\n            sources: app.sourceRefs.map((ref) => ref.url),\n            notes: app.notes,\n            accessRequest: app.accessRequest,\n            deprecated: app.deprecated,\n            createdAt: app.createdAt,\n            updatedAt: app.updatedAt,\n          },\n        }\n      } catch (error) {\n        return {\n          error: error instanceof Error ? error.message : 'Failed to fetch app',\n        }\n      }\n    },\n  }\n\n  return {\n    getAppCard,\n  }\n}\n\n// ============================================================================\n// System Prompt\n// ============================================================================\n\n/**\n * Default system prompt for AI working with app catalog cards.\n * Use this when configuring lighthouseKeeper for card updates.\n */\nexport const APP_CATALOG_AI_SYSTEM_PROMPT = `You are an assistant that helps update app catalog cards based on information from provided links.\n\nWhen given a link and an app ID:\n1. Use getAppCard to fetch the current card information\n2. Analyze the provided link for relevant information\n3. Output a new card structure with updated information based on the link\n\nReturn the updated card as a structured JSON object matching the card format:\n- displayName: App title\n- description: Full description\n- tags: Array of tags\n- teams: Array of team names\n- appUrl: Main application URL\n- links: Array of {url, title} objects for related links\n- sources: Array of source URLs (documentation, Confluence pages, etc.)\n- accessRequest: Object with approvalMethodSlug, comments, requestPrompt, postApprovalInstructions, roles, approverPersonSlugs, urls\n- notes: Additional notes\n- deprecated: Optional deprecation info with type, replacementSlug, comment\n\nDo NOT save the card to the database. Only output the updated structure.`\n"],"mappings":";;;;AASA,SAAS,eAAe,QAAkC;AACxD,KAAI,SAAS,OAAQ,QAAO,OAAO;CACnC,MAAM,EAAE,MAAM,MAAM,UAAU,UAAU,UAAU,WAAW;AAE7D,QAAO,gBAAgB,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,WAD3C,SAAS,WAAW,WAAW;;;;;;AAYrD,SAAgB,wBACd,gBACsB;CACtB,MAAM,EAAE,QAAQ,WAAW,uBAAuB;EAChD,kBAAkB,eAAe,eAAe;EAChD,kBACE,SAAS,iBAAiB,SAAY,eAAe;EACxD,CAAC;AAsDF,QAAO,EACL,YA/CiD;EACjD,aACE;EACF,aATuB,EAAE,OAAO,EAChC,MAAM,EAAE,QAAQ,CAAC,SAAS,wBAAwB,EACnD,CAAC;EAQA,SAAS,OAAO,EAAE,WAA6B;AAC7C,OAAI;IACF,MAAM,MAAM,MAAM,OAAO,WAAW,WAAW;KAC7C,OAAO,EAAE,MAAM;KACf,SAAS,EACP,YAAY,MACb;KACF,CAAC;AAEF,QAAI,CAAC,IACH,QAAO,EAAE,OAAO,4BAA4B,QAAQ;AAItD,WAAO;KACL,SAAS;KACT,MAAM;MACJ,IAAI,IAAI;MACR,MAAM,IAAI;MACV,aAAa,IAAI;MACjB,aAAa,IAAI;MACjB,OAAO,IAAI;MACX,MAAM,IAAI;MACV,QAAQ,IAAI;MACZ,OAAO,IAAI;MACX,UAAU,IAAI;MACd,SAAS,IAAI,WAAW,KAAK,QAAQ,IAAI,IAAI;MAC7C,OAAO,IAAI;MACX,eAAe,IAAI;MACnB,YAAY,IAAI;MAChB,WAAW,IAAI;MACf,WAAW,IAAI;MAChB;KACF;YACM,OAAO;AACd,WAAO,EACL,OAAO,iBAAiB,QAAQ,MAAM,UAAU,uBACjD;;;EAGN,EAIA;;;;;;AAWH,MAAa,+BAA+B"}

package/dist/types/common/appCatalogTypes.d.mts

@@ -29,6 +29,13 @@ interface SourceReference {
 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;
 }
@@ -98,6 +105,7 @@ 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;
 }

package/dist/types/common/appCatalogTypes.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"appCatalogTypes.d.mts","names":[],"sources":["../../../src/types/common/appCatalogTypes.ts"],"mappings":";;;;;;;;UAmBiB,WAAA;EACf,QAAA;EACA,WAAA;EACA,WAAA;EACA,MAAA;EACA,aAAA,GAAgB,gBAAA;AAAA;;;;;UAWD,eAAA;EACf,UAAA;EACA,GAAA;EACA,SAAA;AAAA;;AAkBF;;;UAXiB,SAAA;EA4BM;EA1BrB,aAAA;EA0DQ;EAxDR,OAAA;AAAA;;;;;UAOe,QAAA;EACf,EAAA;EACA,IAAA;EAMA;EAJA,IAAA;EACA,WAAA;EACA,YAAA;EACA,SAAA;EACA,WAAA;EACA,KAAA;EACA,aAAA,GAAgB,gBAAA;EAChB,KAAA;EACA,IAAA;EACA,MAAA;EACA,KAAA;IAAU,GAAA;IAAa,KAAA;EAAA;EACvB,QAAA;EACA,aAAA;EACA,OAAA,cAAqB,eAAA;EACrB,UAAA;IAWA,0HATE,IAAA,iCAWM;IATN,eAAA,WAeF;IAbE,OAAA;EAAA;EAmBF;EAhBA,QAAA;EAoBA;EAlBA,SAAA;EAoBQ;EAlBR,KAAA,GAAQ,WAAA;EAyBI;EArBZ,UAAA;EA4BA;EA1BA,IAAA;EA4BS;EA1BT,UAAA;EA8Be;EA5Bf,OAAA;;EAEA,eAAA;EA4BI;EA1BJ,0BAAA;EA6BoC;EA3BpC,cAAA;EA+BwB;EA7BxB,KAAA,GAAQ,MAAA;EA2BR;;;;;;EApBA,SAAA,GAAY,SAAA;EAyBO;;;;;EAnBnB,aAAA;EACA,cAAA;EAmBM;EAjBN,SAAA;AAAA;AAAA,UAIe,WAAA;EACf,EAAA;EACA,IAAA;AAAA;AAAA,UAGe,qBAAA;EACf,MAAA;EACA,WAAA;EACA,WAAA;EACA,MAAA,EAAQ,gBAAA;AAAA;AAAA,KAGL,gBAAA,8BAA8C,CAAA,eAC/C,IAAA,CAAK,CAAA,EAAG,IAAA;AAAA,KAGA,iBAAA,GAAoB,gBAAA,CAC9B,cAAA;AAAA,UAIe,gBAAA;EACf,KAAA;EACA,WAAA;EACA,WAAA;AAAA;AAAA,UAGe,WAAA;EACf,WAAA;EACA,GAAA;EAFe;EAIf,GAAA;;EAEA,MAAA;AAAA;AAAA,UAGe,cAAA;EACf,OAAA,GAAU,WAAA;EACV,QAAA,GAAW,WAAA;EACX,WAAA,GAAc,WAAA;AAAA;AAAA,UAGC,cAAA;EACf,SAAA,EAAW,QAAA;EACX,eAAA,EAAiB,qBAAA;EACjB,eAAA,EAAiB,iBAAA;EACjB,OAAA,EAAS,MAAA;EACT,MAAA,EAAQ,KAAA;EACR,QAAA,GAAW,cAAA;AAAA"}
+{"version":3,"file":"appCatalogTypes.d.mts","names":[],"sources":["../../../src/types/common/appCatalogTypes.ts"],"mappings":";;;;;;;;UAmBiB,WAAA;EACf,QAAA;EACA,WAAA;EACA,WAAA;EACA,MAAA;EACA,aAAA,GAAgB,gBAAA;AAAA;;;;;UAWD,eAAA;EACf,UAAA;EACA,GAAA;EACA,SAAA;AAAA;;;;;UAOe,SAAA;EAkBA;EAhBf,aAAA;;;;;;;EAOA,mBAAA;EAiEqB;EA/DrB,OAAA;AAAA;;;;;UAOe,QAAA;EACf,EAAA;EACA,IAAA;EAQgB;EANhB,IAAA;EACA,WAAA;EACA,YAAA;EACA,SAAA;EACA,WAAA;EACA,KAAA;EACA,aAAA,GAAgB,gBAAA;EAChB,KAAA;EACA,IAAA;EACA,MAAA;EACA,KAAA;IAAU,GAAA;IAAa,KAAA;EAAA;EACvB,QAAA;EACA,aAAA;EACA,OAAA,cAAqB,eAAA;EACrB,UAAA;IAiBA,0HAfE,IAAA,iCAmBF;IAjBE,eAAA,WAqBF;IAnBE,OAAA;EAAA;EAyBF;EAtBA,QAAA;EA6BA;EA3BA,SAAA;EAiCA;EA/BA,KAAA,GAAQ,WAAA;EAiCR;EA7BA,UAAA;EA+BS;EA7BT,IAAA;EAiCe;EA/Bf,UAAA;;EAEA,OAAA;EA+BI;EA7BJ,eAAA;EAgCoC;EA9BpC,0BAAA;EAkCwB;EAhCxB,cAAA;EA8BA;EA5BA,KAAA,GAAQ,MAAA;EA8BR;;;;AACD;;EAxBC,SAAA,GAAY,SAAA;EA0BqC;;;;;EApBjD,aAAA;EACA,cAAA;EACA,mBAAA;EAkBiD;EAhBjD,SAAA;AAAA;AAAA,UAIe,WAAA;EACf,EAAA;EACA,IAAA;AAAA;AAAA,UAGe,qBAAA;EACf,MAAA;EACA,WAAA;EACA,WAAA;EACA,MAAA,EAAQ,gBAAA;AAAA;AAAA,KAGL,gBAAA,8BAA8C,CAAA,eAC/C,IAAA,CAAK,CAAA,EAAG,IAAA;AAAA,KAGA,iBAAA,GAAoB,gBAAA,CAC9B,cAAA;AAAA,UAIe,gBAAA;EACf,KAAA;EACA,WAAA;EACA,WAAA;AAAA;AAAA,UAGe,WAAA;EACf,WAAA;EACA,GAAA;EAF0B;EAI1B,GAAA;EAFA;EAIA,MAAA;AAAA;AAAA,UAGe,cAAA;EACf,OAAA,GAAU,WAAA;EACV,QAAA,GAAW,WAAA;EACX,WAAA,GAAc,WAAA;AAAA;AAAA,UAGC,cAAA;EACf,SAAA,EAAW,QAAA;EACX,eAAA,EAAiB,qBAAA;EACjB,eAAA,EAAiB,iBAAA;EACjB,OAAA,EAAS,MAAA;EACT,MAAA,EAAQ,KAAA;EACR,QAAA,GAAW,cAAA;AAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@igstack/app-catalog-backend-core",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Backend core library for App Catalog",
   "homepage": "https://github.com/lislon/app-catalog",
   "repository": {
@@ -45,8 +45,8 @@
     "tsyringe": "^4.10.0",
     "yaml": "^2.8.0",
     "zod": "^4.3.5",
-    "@igstack/app-catalog-shared-core": "0.15.0",
-    "@igstack/app-catalog-table-sync": "0.15.0"
+    "@igstack/app-catalog-table-sync": "0.17.0",
+    "@igstack/app-catalog-shared-core": "0.17.0"
   },
   "devDependencies": {
     "@tanstack/vite-config": "^0.4.3",
@@ -73,7 +73,7 @@
   "engines": {
     "node": ">=24"
   },
-  "gitHead": "e021e223f8da284a81e2204908587d55b2f87b6a",
+  "gitHead": "c7c8e9105727375dce326320db3259b9ef2f9ceb",
   "scripts": {
     "build": "tsdown",
     "build:lenient": "tsdown",

package/prisma/schema.prisma

@@ -164,10 +164,13 @@ model DbResource {
   accessComments             String?
   /// [SubResourceExtra]
   extra                      Json?
-  // Freshness (autoupdate scan): when sources were last verified and when the
-  // next check is due. Nullable — apps that have never been scanned carry null.
+  // Freshness (autoupdate scan): when sources were last verified, when the next
+  // check is due, and when the source content last actually changed (what the UI
+  // shows as "Updated" — a source can be re-read without changing).
+  // Nullable — apps that have never been scanned carry null.
   lastCheckedAt              DateTime?
   nextCheckAfter             DateTime?
+  lastContentChangeAt        DateTime?
   createdAt                  DateTime          @default(now())
   updatedAt                  DateTime          @updatedAt
 

package/src/__tests__/assetMime.test.ts

@@ -0,0 +1,74 @@
+import { describe, expect, it, vi } from 'vitest'
+import { parseAssetMeta } from '../modules/assets/assetUtils'
+import { upsertAsset } from '../modules/assets/upsertAsset'
+import type { PrismaClient } from '../generated/prisma/client'
+
+const SVG = Buffer.from(
+  '<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32"><rect width="32" height="32" fill="#123456"/></svg>',
+)
+
+describe('parseAssetMeta mime derivation', () => {
+  it('serves SVG as image/svg+xml, not the invalid image/svg', async () => {
+    const meta = await parseAssetMeta({
+      buffer: SVG,
+      originalFilename: 'example-icon.svg',
+    })
+
+    expect(meta.mimeType).toBe('image/svg+xml')
+  })
+})
+
+describe('upsertAsset mimeType repair', () => {
+  const fakePrisma = (existing: { id: string; mimeType: string } | null) => {
+    const update = vi.fn().mockResolvedValue(existing)
+    const create = vi.fn().mockResolvedValue({ id: 'created' })
+    const prisma = {
+      dbAsset: {
+        findUnique: vi.fn().mockResolvedValue(existing),
+        update,
+        create,
+      },
+    } as unknown as PrismaClient
+
+    return { prisma, update, create }
+  }
+
+  it('rewrites a stale mimeType on an already-stored asset', async () => {
+    const { prisma, update } = fakePrisma({
+      id: 'existing',
+      mimeType: 'image/svg',
+    })
+
+    const id = await upsertAsset({
+      prisma,
+      buffer: SVG,
+      name: 'example-icon',
+      originalFilename: 'example-icon.svg',
+      assetType: 'icon',
+    })
+
+    expect(id).toBe('existing')
+    expect(update).toHaveBeenCalledWith({
+      where: { id: 'existing' },
+      data: { mimeType: 'image/svg+xml' },
+    })
+  })
+
+  it('leaves an already-correct asset untouched', async () => {
+    const { prisma, update } = fakePrisma({
+      id: 'existing',
+      mimeType: 'image/svg+xml',
+    })
+
+    const id = await upsertAsset({
+      prisma,
+      buffer: SVG,
+      name: 'example-icon',
+      originalFilename: 'example-icon.svg',
+      assetType: 'icon',
+    })
+
+    expect(id).toBe('existing')
+    expect(update).not.toHaveBeenCalled()
+  })
+})

package/src/__tests__/dbSchema.test.ts

@@ -0,0 +1,129 @@
+/**
+ * Unit tests for schema-per-branch DB isolation (#44).
+ * Tests the logic that maps DB_SCHEMA env → pg pool options.
+ */
+import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import {
+  buildPgSchemaOptions,
+  resolveDbSchema,
+  verifyDbSchema,
+} from '../db/client'
+
+const original = process.env.DB_SCHEMA
+
+beforeEach(() => {
+  // The helper reads the env directly, so each case states its own world.
+  delete process.env.DB_SCHEMA
+})
+
+afterEach(() => {
+  if (original === undefined) delete process.env.DB_SCHEMA
+  else process.env.DB_SCHEMA = original
+})
+
+describe('DB_SCHEMA schema-per-branch isolation (#44)', () => {
+  it('returns empty object when DB_SCHEMA is unset (public schema implicit)', () => {
+    expect(buildPgSchemaOptions(undefined)).toEqual({})
+  })
+
+  it('returns empty object when DB_SCHEMA is empty string', () => {
+    expect(buildPgSchemaOptions('')).toEqual({})
+  })
+
+  it('sets search_path on the pool when DB_SCHEMA is set', () => {
+    expect(buildPgSchemaOptions('preview_feat-my-branch')).toEqual({
+      options: '-c search_path=preview_feat-my-branch',
+    })
+  })
+
+  it('handles schema names with underscores and hyphens', () => {
+    const result = buildPgSchemaOptions('preview_feature-123')
+    expect(result).toEqual({ options: '-c search_path=preview_feature-123' })
+  })
+
+  it('falls back to DB_SCHEMA when no schema is passed', () => {
+    // The middleware pool has no schema in its config when it is given a plain
+    // url, so the env var is the only thing standing between a preview env and
+    // the shared `public` tables.
+    process.env.DB_SCHEMA = 'preview_from-env'
+    expect(buildPgSchemaOptions()).toEqual({
+      options: '-c search_path=preview_from-env',
+    })
+  })
+
+  it('lets DB_SCHEMA override a schema from the app config', () => {
+    // The deployment knows it is a preview; the config server does not, and its
+    // baked `public` would otherwise undo the isolation.
+    process.env.DB_SCHEMA = 'preview_from-env'
+    expect(buildPgSchemaOptions('public')).toEqual({
+      options: '-c search_path=preview_from-env',
+    })
+  })
+
+  it('uses the configured schema when DB_SCHEMA is unset', () => {
+    expect(buildPgSchemaOptions('public')).toEqual({
+      options: '-c search_path=public',
+    })
+  })
+})
+
+describe('resolveDbSchema', () => {
+  it('is undefined when nothing configures a schema', () => {
+    expect(resolveDbSchema()).toBeUndefined()
+    expect(resolveDbSchema('')).toBeUndefined()
+  })
+
+  it('prefers DB_SCHEMA over the configured schema', () => {
+    process.env.DB_SCHEMA = 'preview_from-env'
+    expect(resolveDbSchema('public')).toBe('preview_from-env')
+  })
+
+  it('falls back to the configured schema', () => {
+    expect(resolveDbSchema('public')).toBe('public')
+  })
+})
+
+describe('verifyDbSchema fail-fast (#82)', () => {
+  const poolReturning = (schema: string | null) =>
+    ({
+      query: async () => ({ rows: [{ schema }] }),
+    }) as unknown as Parameters<typeof verifyDbSchema>[0]
+
+  it('stays quiet for a deployment with no isolation to verify', async () => {
+    await expect(
+      verifyDbSchema(poolReturning('public')),
+    ).resolves.toBeUndefined()
+  })
+
+  it('passes when the database resolves the expected schema', async () => {
+    process.env.DB_SCHEMA = 'preview_feat-my-branch'
+    await expect(
+      verifyDbSchema(poolReturning('preview_feat-my-branch')),
+    ).resolves.toBeUndefined()
+  })
+
+  it('checks a deployment isolated by config alone, without DB_SCHEMA', async () => {
+    await expect(
+      verifyDbSchema(poolReturning('public'), 'preview_feat-my-branch'),
+    ).rejects.toThrow(/current_schema\(\) to "public"/)
+  })
+
+  it('accepts the name Postgres kept when the schema is over 63 bytes', async () => {
+    // CREATE SCHEMA and search_path truncate identically, so a long branch slug
+    // is still isolated - failing it here would crash-loop a healthy preview env.
+    const long = 'preview_' + 'b'.repeat(70)
+    process.env.DB_SCHEMA = long
+    await expect(
+      verifyDbSchema(poolReturning(long.slice(0, 63))),
+    ).resolves.toBeUndefined()
+  })
+
+  it('throws when a missing schema falls the connection through to public', async () => {
+    // Postgres skips a search_path entry that does not exist, which would let a
+    // preview env quietly read and overwrite the shared catalog.
+    process.env.DB_SCHEMA = 'preview_feat-my-branch'
+    await expect(verifyDbSchema(poolReturning('public'))).rejects.toThrow(
+      /current_schema\(\) to "public"/,
+    )
+  })
+})