astro-accelerator-utils 0.3.102 → 0.3.103

package/lib/v1/accelerator.mjs

@@ -1,5 +1,6 @@
 import { Authors } from './authors.mjs';
 import { Cache } from './cache.mjs';
+import { resolveCacheMaxAge } from './cache-max-age.mjs';
 import { DateFormatter } from './dates.mjs';
 import { Markdown } from './markdown.mjs';
 import { Navigation } from './navigation.mjs';
@@ -19,7 +20,7 @@ export class Accelerator {
      * @param {Site} site
      */
     constructor(site) {
-        this.cacheMaxAge = site.cacheMaxAge;
+        this.cacheMaxAge = resolveCacheMaxAge(site.cacheMaxAge);
         this.dateOptions = site.dateOptions;
         this.shortDateOptions = site.shortDateOptions;
         this.siteUrl = site.url;

package/lib/v1/cache-max-age.d.mts

@@ -0,0 +1,10 @@
+export declare const DEV_CACHE_MAX_AGE = 30;
+export declare const BUILD_CACHE_MAX_AGE = 300;
+/**
+ * Resolves cache TTL from the environment and optional site config.
+ * Astro dev (`pnpm dev`) sets NODE_ENV to "development" → 30 seconds.
+ * Production builds use the configured value, or 5 minutes by default.
+ * @param {number | undefined} configuredMaxAge
+ * @returns {number}
+ */
+export declare function resolveCacheMaxAge(configuredMaxAge: number | undefined): number;

package/lib/v1/cache-max-age.mjs

@@ -0,0 +1,17 @@
+export const DEV_CACHE_MAX_AGE = 30;
+export const BUILD_CACHE_MAX_AGE = 300;
+
+/**
+ * Resolves cache TTL from the environment and optional site config.
+ * Astro dev (`pnpm dev`) sets NODE_ENV to "development" → 30 seconds.
+ * Production builds use the configured value, or 5 minutes by default.
+ * @param {number | undefined} configuredMaxAge
+ * @returns {number}
+ */
+export function resolveCacheMaxAge(configuredMaxAge) {
+    if (process.env.NODE_ENV === 'development') {
+        return DEV_CACHE_MAX_AGE;
+    }
+
+    return configuredMaxAge ?? BUILD_CACHE_MAX_AGE;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astro-accelerator-utils",
-  "version": "0.3.102",
+  "version": "0.3.103",
   "description": "Astro utilities for Astro Accelerator.",
   "main": "index.mjs",
   "type": "module",

package/types/Site.d.ts

@@ -25,7 +25,7 @@ export type Site = {
     pageSize: number;
     pageLinks: number;
     rssLimit: number;
-    cacheMaxAge: number;
+    cacheMaxAge?: number;
     featureFlags: {
         stickyNav: {
             top: number;