@everystack/server 0.2.5 → 0.2.6

package/README.md

@@ -156,7 +156,7 @@ interface ImageHandlerConfig {
   bucket: string;          // S3 bucket name
   region?: string;         // AWS region (default: AWS_REGION env)
   pathPrefix?: string;     // URL prefix (default: '/media/')
-  cacheControl?: string;   // Cache-Control header (default: 'public, max-age=60, s-maxage=2592000, stale-while-revalidate=5')
+  cacheControl?: string;   // Cache-Control header (default: 'public, max-age=86400, s-maxage=31536000, stale-while-revalidate=60')
   validateKey?: (key: string) => boolean | Promise<boolean>;  // Optional key validator
   s3Cache?: {              // Persist rendered images to S3 (skip Sharp on repeat requests)
     enabled: boolean;
@@ -185,6 +185,20 @@ const deleted = await deleteImageCache('my-bucket', 'uploads/photo.jpg');
 
 Options: `{ region?: string; prefix?: string }` (prefix defaults to `'cache/'`).
 
+### `purgeImage(bucket, key, options?)`
+
+Delete all S3 cached renders and invalidate CloudFront cache for an image. Combines `deleteImageCache` with KVS path invalidation.
+
+```typescript
+import { purgeImage } from '@everystack/server/image';
+
+const { deleted, invalidated } = await purgeImage('my-bucket', 'uploads/photo.jpg', {
+  kvsArn: process.env.KVS_ARN,
+});
+```
+
+Options: `{ region?: string; prefix?: string; kvsArn?: string; pathPrefix?: string }`. KVS invalidation is skipped when `kvsArn` is omitted.
+
 ### `parseParams(query)`
 
 Validates URL query params into transform options:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everystack/server",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Server runtime primitives for Lambda — event adapters, routing, SSR, image processing",
   "license": "AGPL-3.0-only",
   "publishConfig": {

package/src/image.ts

@@ -30,8 +30,8 @@ export interface ImageHandlerConfig {
   region?: string;
   /** URL path prefix to strip (defaults to '/media/') */
   pathPrefix?: string;
-  /** Cache-Control for image responses.
-   *  Default: 'public, max-age=60, s-maxage=2592000, stale-while-revalidate=5' */
+  /** Cache-Control for image responses and S3 cached renders.
+   *  Default: 'public, max-age=86400, s-maxage=31536000, stale-while-revalidate=60' */
   cacheControl?: string;
   /**
    * Optional key validator. Called before fetching from S3.
@@ -246,7 +246,7 @@ export function createImageHandler(
       const client = new S3Client({ region });
 
       const cacheHeaders = {
-        'Cache-Control': config.cacheControl ?? 'public, max-age=60, s-maxage=2592000, stale-while-revalidate=5',
+        'Cache-Control': config.cacheControl ?? 'public, max-age=86400, s-maxage=31536000, stale-while-revalidate=60',
         'Vary': 'Accept',
       };
 
@@ -405,7 +405,7 @@ export function createImageHandler(
               Key: s3CacheKey,
               Body: processed.data,
               ContentType: processed.contentType,
-              CacheControl: 'public, max-age=2592000',
+              CacheControl: cacheHeaders['Cache-Control'],
             })
           )
           .catch((err: unknown) => {
@@ -478,3 +478,42 @@ export async function deleteImageCache(
 
   return deleted;
 }
+
+/**
+ * Purge an image: delete all S3 cached renders and invalidate CloudFront.
+ *
+ * Call this when an original image is deleted or replaced. Combines
+ * `deleteImageCache()` (S3 cleanup) with KVS path invalidation
+ * (CloudFront cache expiry for all variants of the image).
+ *
+ * KVS invalidation is optional — when `kvsArn` is omitted, only S3
+ * cached renders are deleted.
+ */
+export async function purgeImage(
+  bucket: string,
+  key: string,
+  options?: {
+    region?: string;
+    /** S3 cache prefix. Default: 'cache/' */
+    prefix?: string;
+    /** CloudFront KVS ARN. When provided, invalidates CDN cache. */
+    kvsArn?: string;
+    /** URL path prefix for CDN invalidation. Default: '/media/' */
+    pathPrefix?: string;
+  }
+): Promise<{ deleted: number; invalidated: boolean }> {
+  const deleted = await deleteImageCache(bucket, key, {
+    region: options?.region,
+    prefix: options?.prefix,
+  });
+
+  let invalidated = false;
+  if (options?.kvsArn) {
+    const { invalidateKvsPaths } = await import('./kvs.js');
+    const mediaPath = (options.pathPrefix ?? '/media/') + key;
+    await invalidateKvsPaths(options.kvsArn, [mediaPath]);
+    invalidated = true;
+  }
+
+  return { deleted, invalidated };
+}