@content-streamline/nextjs 0.0.4 → 0.0.5

package/dist/cache/file-cache.d.ts

@@ -2,7 +2,25 @@
  * File-based cache for posts
  * Works in Next.js server environment
  */
-import type { Post, PostDetailResponse, CachedPostIndex } from '../types/index.js';
+import type { Post, PostDetailResponse, CachedPostIndex, CacheMetadata } from '../types/index.js';
+/**
+ * Generate a hash of the current API configuration
+ * Used to detect when env vars change
+ */
+export declare function getEnvConfigHash(): string;
+/**
+ * Check if API is currently configured
+ */
+export declare function isAPIConfigured(): boolean;
+/**
+ * Create cache metadata for current state
+ */
+export declare function createCacheMetadata(apiCallSucceeded: boolean): CacheMetadata;
+/**
+ * Validate if cached data should be used
+ * Returns false if cache was created in an invalid state
+ */
+export declare function shouldUseCachedData(metadata: CacheMetadata | undefined, maxAgeMinutes: number): boolean;
 /**
  * Initialize cache directory
  */
@@ -20,15 +38,21 @@ export declare function getCachedPost(id: number, language?: string): Promise<Po
  */
 export declare function getAllCachedPosts(): Promise<Post[]>;
 /**
- * Update the posts index
+ * Update the posts index with metadata
  */
-export declare function updatePostsIndex(posts: Post[]): Promise<void>;
+export declare function updatePostsIndex(posts: Post[], apiCallSucceeded?: boolean): Promise<void>;
 /**
  * Get the posts index
  */
 export declare function getPostsIndex(): Promise<CachedPostIndex | null>;
 /**
- * Check if cache needs refresh (older than specified minutes)
+ * Check if cache needs refresh
+ * Returns true if:
+ * - No cache exists
+ * - Cache is older than maxAgeMinutes
+ * - Cache was created when API was not configured (but is now)
+ * - Cache was created from a failed API call
+ * - API configuration has changed
  */
 export declare function shouldRefreshCache(maxAgeMinutes?: number): Promise<boolean>;
 /**

package/dist/cache/file-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../src/cache/file-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMnF;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAO/C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAa,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAS3G;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CA0BzD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBnE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAOrE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CASrF;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAYhD"}
+{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../src/cache/file-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAMlG;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAIzC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,GAAG,aAAa,CAO5E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CA8BvG;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAO/C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAa,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAS3G;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CA0BzD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,gBAAgB,GAAE,OAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBrG;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAOrE;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBrF;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAYhD"}

package/dist/cache/file-cache.js

@@ -4,9 +4,68 @@
  */
 import { writeFile, readFile, mkdir, readdir, unlink } from 'fs/promises';
 import { join } from 'path';
+import { createHash } from 'crypto';
 const CACHE_DIR = join(process.cwd(), '.next', 'content-streamline-cache');
 const POSTS_INDEX_FILE = join(CACHE_DIR, 'posts-index.json');
 const POSTS_DIR = join(CACHE_DIR, 'posts');
+/**
+ * Generate a hash of the current API configuration
+ * Used to detect when env vars change
+ */
+export function getEnvConfigHash() {
+    const baseUrl = process.env.CONTENT_STREAMLINE_API_BASE_URL || process.env.API_BASE_URL || '';
+    const accessToken = process.env.CONTENT_STREAMLINE_API_ACCESS_TOKEN || process.env.API_ACCESS_TOKEN || '';
+    return createHash('md5').update(`${baseUrl}:${accessToken}`).digest('hex').substring(0, 16);
+}
+/**
+ * Check if API is currently configured
+ */
+export function isAPIConfigured() {
+    const baseUrl = process.env.CONTENT_STREAMLINE_API_BASE_URL || process.env.API_BASE_URL;
+    const accessToken = process.env.CONTENT_STREAMLINE_API_ACCESS_TOKEN || process.env.API_ACCESS_TOKEN;
+    return Boolean(baseUrl && accessToken);
+}
+/**
+ * Create cache metadata for current state
+ */
+export function createCacheMetadata(apiCallSucceeded) {
+    return {
+        timestamp: Date.now(),
+        apiConfigured: isAPIConfigured(),
+        apiCallSucceeded,
+        envConfigHash: getEnvConfigHash(),
+    };
+}
+/**
+ * Validate if cached data should be used
+ * Returns false if cache was created in an invalid state
+ */
+export function shouldUseCachedData(metadata, maxAgeMinutes) {
+    // No metadata means old cache format - don't trust it
+    if (!metadata) {
+        return false;
+    }
+    // Don't use cache if it was created when API wasn't configured
+    // but API is now configured (user added env vars)
+    if (!metadata.apiConfigured && isAPIConfigured()) {
+        return false;
+    }
+    // Don't use cache if API call failed when it was created
+    if (!metadata.apiCallSucceeded) {
+        return false;
+    }
+    // Don't use cache if env config changed (different API credentials)
+    const currentHash = getEnvConfigHash();
+    if (metadata.envConfigHash && metadata.envConfigHash !== currentHash) {
+        return false;
+    }
+    // Check cache age
+    const ageMinutes = (Date.now() - metadata.timestamp) / (1000 * 60);
+    if (ageMinutes > maxAgeMinutes) {
+        return false;
+    }
+    return true;
+}
 /**
  * Initialize cache directory
  */
@@ -71,9 +130,9 @@ export async function getAllCachedPosts() {
     }
 }
 /**
- * Update the posts index
+ * Update the posts index with metadata
  */
-export async function updatePostsIndex(posts) {
+export async function updatePostsIndex(posts, apiCallSucceeded = true) {
     await initCache();
     const index = {
         posts: posts.flatMap(post => post.post_translations.map(translation => ({
@@ -83,6 +142,7 @@ export async function updatePostsIndex(posts) {
             updated_at: post.created_at,
         }))),
         last_sync: new Date().toISOString(),
+        metadata: createCacheMetadata(apiCallSucceeded),
     };
     await writeFile(POSTS_INDEX_FILE, JSON.stringify(index, null, 2), 'utf-8');
 }
@@ -99,12 +159,28 @@ export async function getPostsIndex() {
     }
 }
 /**
- * Check if cache needs refresh (older than specified minutes)
+ * Check if cache needs refresh
+ * Returns true if:
+ * - No cache exists
+ * - Cache is older than maxAgeMinutes
+ * - Cache was created when API was not configured (but is now)
+ * - Cache was created from a failed API call
+ * - API configuration has changed
  */
 export async function shouldRefreshCache(maxAgeMinutes = 60) {
     const index = await getPostsIndex();
     if (!index)
         return true;
+    // Use new metadata-based validation if available
+    if (index.metadata) {
+        return !shouldUseCachedData(index.metadata, maxAgeMinutes);
+    }
+    // Fallback for old cache format without metadata
+    // If API is now configured, refresh to get proper metadata
+    if (isAPIConfigured()) {
+        return true;
+    }
+    // Legacy age check for old cache format
     const lastSync = new Date(index.last_sync);
     const now = new Date();
     const ageMinutes = (now.getTime() - lastSync.getTime()) / (1000 * 60);

package/dist/components/styles.css

@@ -3,107 +3,266 @@
  * You can override these with your own CSS
  */
 
-/* Posts List */
-.content-streamline-posts-list {
+/* ==========================================================================
+   Latest Posts (Featured/Hero Section)
+   ========================================================================== */
+
+.content-streamline-latest-posts {
   display: grid;
-  grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
-  gap: 2rem;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 1.5rem;
   margin: 2rem 0;
 }
 
-.content-streamline-post-card {
+/* First card spans full width on larger screens */
+.content-streamline-latest-posts:has(.content-streamline-latest-card--featured) {
+  grid-template-columns: 1fr;
+}
+
+.content-streamline-latest-posts:has(.content-streamline-latest-card--featured) .content-streamline-latest-card--featured {
+  display: grid;
+  grid-template-columns: 1.2fr 1fr;
+  gap: 2rem;
+}
+
+.content-streamline-latest-posts:has(.content-streamline-latest-card--featured) .content-streamline-latest-card:not(.content-streamline-latest-card--featured) {
+  display: none;
+}
+
+/* When there are multiple cards, show grid */
+.content-streamline-latest-posts:has(.content-streamline-latest-card:nth-child(2)) {
+  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+}
+
+.content-streamline-latest-posts:has(.content-streamline-latest-card:nth-child(2)) .content-streamline-latest-card--featured {
+  grid-column: 1 / -1;
+  display: grid;
+  grid-template-columns: 1.5fr 1fr;
+  gap: 2.5rem;
+}
+
+.content-streamline-latest-posts:has(.content-streamline-latest-card:nth-child(2)) .content-streamline-latest-card:not(.content-streamline-latest-card--featured) {
+  display: flex;
+  flex-direction: column;
+}
+
+.content-streamline-latest-card {
   background: #ffffff;
-  border-radius: 12px;
+  border-radius: 16px;
   overflow: hidden;
   border: 1px solid #e5e7eb;
-  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.06);
-  transition: transform 0.2s, box-shadow 0.2s;
-  display: flex;
-  flex-direction: column;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.05);
+  transition: transform 0.2s ease, box-shadow 0.2s ease;
 }
 
-.content-streamline-post-card:hover {
+.content-streamline-latest-card:hover {
   transform: translateY(-4px);
-  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
+  box-shadow: 0 12px 32px rgba(0, 0, 0, 0.1);
 }
 
-.content-streamline-post-image-link {
+.content-streamline-latest-image-link {
   display: block;
   text-decoration: none;
-  width: 100%;
+  overflow: hidden;
 }
 
-.content-streamline-post-image {
+.content-streamline-latest-card--featured .content-streamline-latest-image-link {
+  border-radius: 16px 0 0 16px;
+}
+
+.content-streamline-latest-image {
   width: 100%;
   aspect-ratio: 16 / 10;
   overflow: hidden;
-  background: #f3f4f6;
+  background: linear-gradient(135deg, #f3f4f6 0%, #e5e7eb 100%);
+}
+
+.content-streamline-latest-card--featured .content-streamline-latest-image {
+  aspect-ratio: 16 / 11;
+  height: 100%;
 }
 
-.content-streamline-post-image img {
+.content-streamline-latest-image img {
   width: 100%;
   height: 100%;
   object-fit: cover;
-  transition: transform 0.3s;
+  transition: transform 0.4s ease;
 }
 
-.content-streamline-post-card:hover .content-streamline-post-image img {
+.content-streamline-latest-card:hover .content-streamline-latest-image img {
   transform: scale(1.05);
 }
 
-.content-streamline-post-content {
+.content-streamline-latest-content {
   padding: 1.5rem;
-  flex: 1;
   display: flex;
   flex-direction: column;
+  justify-content: center;
 }
 
-.content-streamline-post-date {
-  font-size: 0.875rem;
+.content-streamline-latest-card--featured .content-streamline-latest-content {
+  padding: 2rem 2rem 2rem 0;
+}
+
+.content-streamline-latest-date {
+  font-size: 0.8125rem;
   color: #6b7280;
   margin-bottom: 0.75rem;
   text-transform: uppercase;
-  letter-spacing: 0.05em;
+  letter-spacing: 0.08em;
+  font-weight: 500;
 }
 
-.content-streamline-post-title {
-  font-size: 1.5rem;
-  font-weight: 600;
-  margin: 0 0 1rem 0;
-  line-height: 1.3;
+.content-streamline-latest-title {
+  font-size: 1.25rem;
+  font-weight: 700;
+  margin: 0 0 0.75rem 0;
+  line-height: 1.35;
 }
 
-.content-streamline-post-title a {
+.content-streamline-latest-card--featured .content-streamline-latest-title {
+  font-size: 1.75rem;
+  margin-bottom: 1rem;
+}
+
+.content-streamline-latest-title a {
   color: #111827;
   text-decoration: none;
-  transition: color 0.2s;
+  transition: color 0.2s ease;
 }
 
-.content-streamline-post-title a:hover {
+.content-streamline-latest-title a:hover {
   color: #3b82f6;
 }
 
-.content-streamline-post-excerpt {
+.content-streamline-latest-excerpt {
   color: #6b7280;
   line-height: 1.6;
   margin: 0 0 1rem 0;
-  flex: 1;
+  font-size: 0.9375rem;
+  display: -webkit-box;
+  -webkit-line-clamp: 3;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+.content-streamline-latest-card--featured .content-streamline-latest-excerpt {
+  font-size: 1rem;
+  -webkit-line-clamp: 4;
 }
 
-.content-streamline-post-link {
+.content-streamline-latest-link {
   color: #3b82f6;
   text-decoration: none;
-  font-weight: 500;
+  font-weight: 600;
+  font-size: 0.9375rem;
+  transition: color 0.2s ease;
   margin-top: auto;
-  transition: color 0.2s;
 }
 
-.content-streamline-post-link:hover {
+.content-streamline-latest-link:hover {
   color: #2563eb;
-  text-decoration: underline;
 }
 
-/* Post Detail */
+/* ==========================================================================
+   Posts List (Vertical List with Image on Left)
+   ========================================================================== */
+
+.content-streamline-list {
+  display: flex;
+  flex-direction: column;
+  gap: 1.25rem;
+  margin: 2rem 0;
+}
+
+.content-streamline-list-item {
+  display: grid;
+  grid-template-columns: 180px 1fr;
+  gap: 1.25rem;
+  padding: 1rem;
+  background: #ffffff;
+  border-radius: 12px;
+  border: 1px solid #e5e7eb;
+  transition: border-color 0.2s ease, box-shadow 0.2s ease;
+}
+
+.content-streamline-list-item:hover {
+  border-color: #d1d5db;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.05);
+}
+
+.content-streamline-list-image-link {
+  display: block;
+  text-decoration: none;
+  border-radius: 8px;
+  overflow: hidden;
+}
+
+.content-streamline-list-image {
+  width: 100%;
+  aspect-ratio: 16 / 11;
+  overflow: hidden;
+  background: linear-gradient(135deg, #f3f4f6 0%, #e5e7eb 100%);
+  border-radius: 8px;
+}
+
+.content-streamline-list-image img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  transition: transform 0.3s ease;
+}
+
+.content-streamline-list-item:hover .content-streamline-list-image img {
+  transform: scale(1.05);
+}
+
+.content-streamline-list-content {
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  padding: 0.25rem 0;
+}
+
+.content-streamline-list-date {
+  font-size: 0.75rem;
+  color: #9ca3af;
+  margin-bottom: 0.375rem;
+  font-weight: 500;
+}
+
+.content-streamline-list-title {
+  font-size: 1.0625rem;
+  font-weight: 600;
+  margin: 0 0 0.5rem 0;
+  line-height: 1.4;
+}
+
+.content-streamline-list-title a {
+  color: #111827;
+  text-decoration: none;
+  transition: color 0.2s ease;
+}
+
+.content-streamline-list-title a:hover {
+  color: #3b82f6;
+}
+
+.content-streamline-list-excerpt {
+  color: #6b7280;
+  line-height: 1.5;
+  margin: 0;
+  font-size: 0.875rem;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+/* ==========================================================================
+   Post Detail
+   ========================================================================== */
+
 .content-streamline-post-detail {
   max-width: 800px;
   margin: 0 auto;
@@ -298,6 +457,10 @@
   text-align: center;
 }
 
+/* ==========================================================================
+   Empty States
+   ========================================================================== */
+
 .content-streamline-empty,
 .content-streamline-post-not-found {
   text-align: center;
@@ -305,13 +468,59 @@
   color: #6b7280;
 }
 
-/* Responsive */
+/* ==========================================================================
+   Responsive
+   ========================================================================== */
+
+@media (max-width: 1024px) {
+  .content-streamline-latest-posts:has(.content-streamline-latest-card:nth-child(2)) .content-streamline-latest-card--featured {
+    grid-template-columns: 1fr 1fr;
+    gap: 1.5rem;
+  }
+}
+
 @media (max-width: 768px) {
-  .content-streamline-posts-list {
+  /* Latest Posts */
+  .content-streamline-latest-posts {
     grid-template-columns: 1fr;
-    gap: 1.5rem;
+    gap: 1.25rem;
+  }
+
+  .content-streamline-latest-posts:has(.content-streamline-latest-card--featured) .content-streamline-latest-card--featured,
+  .content-streamline-latest-posts:has(.content-streamline-latest-card:nth-child(2)) .content-streamline-latest-card--featured {
+    grid-template-columns: 1fr;
+    gap: 0;
   }
 
+  .content-streamline-latest-card--featured .content-streamline-latest-image-link {
+    border-radius: 16px 16px 0 0;
+  }
+
+  .content-streamline-latest-card--featured .content-streamline-latest-content {
+    padding: 1.5rem;
+  }
+
+  .content-streamline-latest-card--featured .content-streamline-latest-title {
+    font-size: 1.375rem;
+  }
+
+  /* Posts List */
+  .content-streamline-list-item {
+    grid-template-columns: 120px 1fr;
+    gap: 1rem;
+    padding: 0.75rem;
+  }
+
+  .content-streamline-list-title {
+    font-size: 0.9375rem;
+  }
+
+  .content-streamline-list-excerpt {
+    font-size: 0.8125rem;
+    -webkit-line-clamp: 2;
+  }
+
+  /* Post Detail */
   .content-streamline-post-detail {
     padding: 1.5rem 1rem;
   }
@@ -329,3 +538,14 @@
   }
 }
 
+@media (max-width: 480px) {
+  /* Posts List - stack vertically on very small screens */
+  .content-streamline-list-item {
+    grid-template-columns: 1fr;
+    gap: 0.75rem;
+  }
+
+  .content-streamline-list-image {
+    aspect-ratio: 16 / 9;
+  }
+}

package/dist/index.d.ts

@@ -2,8 +2,9 @@
  * Content Streamline Next.js Library
  * Main entry point
  */
-export type { Post, PostDetailResponse, PostTranslation, PostImage, PostsResponse, Pagination, } from './types/index.js';
+export type { Post, PostDetailResponse, PostTranslation, PostImage, PostsResponse, Pagination, CacheMetadata, } from './types/index.js';
 export { getAllPosts, getPost, getPostBySlug, } from './server/index.js';
+export { clearCache, isAPIConfigured, } from './cache/file-cache.js';
 export { PostsList, PostDetail, LatestPosts, } from './components/index.js';
 export type { PostsListProps, PostDetailProps, LatestPostsProps, } from './components/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,IAAI,EACJ,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,aAAa,EACb,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,OAAO,EACP,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,SAAS,EACT,UAAU,EACV,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,IAAI,EACJ,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,aAAa,EACb,UAAU,EACV,aAAa,GACd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,OAAO,EACP,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,UAAU,EACV,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,SAAS,EACT,UAAU,EACV,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -4,5 +4,7 @@
  */
 // Export server functions
 export { getAllPosts, getPost, getPostBySlug, } from './server/index.js';
+// Export cache utilities
+export { clearCache, isAPIConfigured, } from './cache/file-cache.js';
 // Export components
 export { PostsList, PostDetail, LatestPosts, } from './components/index.js';

package/dist/server/index.d.ts

@@ -6,6 +6,10 @@ import type { Post, PostDetailResponse } from '../types/index.js';
 /**
  * Get all posts (with automatic cache refresh)
  * Use this in Server Components or API Routes
+ *
+ * Note: Only successful API responses are cached. Failed API calls
+ * (network errors, auth failures, etc.) will NOT be cached, allowing
+ * subsequent calls to retry the API.
  */
 export declare function getAllPosts(options?: {
     maxCacheAge?: number;
@@ -15,6 +19,9 @@ export declare function getAllPosts(options?: {
 /**
  * Get a single post by ID
  * Use this in Server Components or API Routes
+ *
+ * Note: Only successful API responses are cached. Failed API calls
+ * will NOT be cached, allowing subsequent calls to retry the API.
  */
 export declare function getPost(id: number, options?: {
     language?: string;

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAkBlE;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CA2ClB;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GACA,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAiCpC;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA2BpC;AAGD,YAAY,EACV,IAAI,EACJ,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AA+BlE;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CA2ElB;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GACA,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAoDpC;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA2BpC;AAGD,YAAY,EACV,IAAI,EACJ,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC"}

package/dist/server/index.js

@@ -6,22 +6,40 @@ import { createAPIClient } from '../api/client.js';
 import { getAllCachedPosts, getCachedPost, cachePost, updatePostsIndex, shouldRefreshCache, } from '../cache/file-cache.js';
 /**
  * Get API configuration from environment variables
+ * Returns null if not configured (instead of throwing)
  */
 function getAPIConfig() {
     const baseUrl = process.env.CONTENT_STREAMLINE_API_BASE_URL || process.env.API_BASE_URL;
     const accessToken = process.env.CONTENT_STREAMLINE_API_ACCESS_TOKEN || process.env.API_ACCESS_TOKEN;
     if (!baseUrl || !accessToken) {
-        throw new Error('Missing API configuration. Set CONTENT_STREAMLINE_API_BASE_URL and CONTENT_STREAMLINE_API_ACCESS_TOKEN environment variables.');
+        return null;
     }
     return { baseUrl, accessToken };
 }
+/**
+ * Get API configuration, throwing if not configured
+ * Use this when API is required
+ */
+function requireAPIConfig() {
+    const config = getAPIConfig();
+    if (!config) {
+        throw new Error('Missing API configuration. Set CONTENT_STREAMLINE_API_BASE_URL and CONTENT_STREAMLINE_API_ACCESS_TOKEN environment variables.');
+    }
+    return config;
+}
 /**
  * Get all posts (with automatic cache refresh)
  * Use this in Server Components or API Routes
+ *
+ * Note: Only successful API responses are cached. Failed API calls
+ * (network errors, auth failures, etc.) will NOT be cached, allowing
+ * subsequent calls to retry the API.
  */
 export async function getAllPosts(options) {
     const { maxCacheAge = 15, forceRefresh = false, platform } = options || {};
-    // Check cache freshness
+    // Check if API is configured
+    const apiConfig = getAPIConfig();
+    // Check cache freshness (this also validates cache metadata)
     if (!forceRefresh) {
         const needsRefresh = await shouldRefreshCache(maxCacheAge);
         if (!needsRefresh) {
@@ -40,13 +58,36 @@ export async function getAllPosts(options) {
             }
         }
     }
+    // If API is not configured, return empty array but DON'T cache it
+    if (!apiConfig) {
+        console.warn('Content Streamline: API not configured. Set CONTENT_STREAMLINE_API_BASE_URL and CONTENT_STREAMLINE_API_ACCESS_TOKEN environment variables.');
+        return [];
+    }
     // Fetch from API
-    const { baseUrl, accessToken } = getAPIConfig();
-    const api = createAPIClient(baseUrl, accessToken);
-    const posts = await api.getAllPosts(platform);
-    // Cache all posts
+    let posts;
+    try {
+        const api = createAPIClient(apiConfig.baseUrl, apiConfig.accessToken);
+        posts = await api.getAllPosts(platform);
+    }
+    catch (error) {
+        // API call failed - DON'T cache the error, just return empty
+        // This allows subsequent calls to retry the API
+        console.error('Content Streamline: Failed to fetch posts from API:', error);
+        // Try to return stale cache if available (better than nothing)
+        const staleCached = await getAllCachedPosts();
+        if (staleCached.length > 0) {
+            console.warn('Content Streamline: Returning stale cached data due to API error');
+            if (platform) {
+                return staleCached.filter(post => post.platform.toLowerCase() === platform.toLowerCase());
+            }
+            return staleCached;
+        }
+        return [];
+    }
+    // API call succeeded - cache the results with success metadata
     for (const post of posts) {
         try {
+            const api = createAPIClient(apiConfig.baseUrl, apiConfig.accessToken);
             const fullPost = await api.getPost(post.id, 'markdown');
             await cachePost(fullPost);
         }
@@ -54,17 +95,22 @@ export async function getAllPosts(options) {
             console.error(`Failed to cache post ${post.id}:`, error);
         }
     }
-    // Update index
-    await updatePostsIndex(posts);
+    // Update index with success metadata
+    await updatePostsIndex(posts, true);
     return posts;
 }
 /**
  * Get a single post by ID
  * Use this in Server Components or API Routes
+ *
+ * Note: Only successful API responses are cached. Failed API calls
+ * will NOT be cached, allowing subsequent calls to retry the API.
  */
 export async function getPost(id, options) {
     const { language = 'en', contentFormat = 'markdown', maxCacheAge = 15, forceRefresh = false, } = options || {};
-    // Try cache first
+    // Check if API is configured
+    const apiConfig = getAPIConfig();
+    // Try cache first (cache validation includes metadata checks)
     if (!forceRefresh) {
         const needsRefresh = await shouldRefreshCache(maxCacheAge);
         if (!needsRefresh) {
@@ -74,17 +120,28 @@ export async function getPost(id, options) {
             }
         }
     }
+    // If API is not configured, return null but DON'T cache it
+    if (!apiConfig) {
+        console.warn('Content Streamline: API not configured. Set CONTENT_STREAMLINE_API_BASE_URL and CONTENT_STREAMLINE_API_ACCESS_TOKEN environment variables.');
+        return null;
+    }
     // Fetch from API
     try {
-        const { baseUrl, accessToken } = getAPIConfig();
-        const api = createAPIClient(baseUrl, accessToken);
+        const api = createAPIClient(apiConfig.baseUrl, apiConfig.accessToken);
         const post = await api.getPost(id, contentFormat);
-        // Cache it
+        // API call succeeded - cache it
         await cachePost(post);
         return post;
     }
     catch (error) {
-        console.error(`Failed to fetch post ${id}:`, error);
+        // API call failed - DON'T cache the error
+        // Try to return stale cache if available
+        console.error(`Content Streamline: Failed to fetch post ${id}:`, error);
+        const staleCached = await getCachedPost(id, language);
+        if (staleCached) {
+            console.warn(`Content Streamline: Returning stale cached data for post ${id} due to API error`);
+            return staleCached;
+        }
         return null;
     }
 }

package/dist/types/index.d.ts

@@ -39,6 +39,15 @@ export interface PostsResponse {
 export interface PostDetailResponse extends Post {
     post_translations: PostTranslation[];
 }
+/**
+ * Metadata stored with cache entries to track API state
+ */
+export interface CacheMetadata {
+    timestamp: number;
+    apiConfigured: boolean;
+    apiCallSucceeded: boolean;
+    envConfigHash?: string;
+}
 export interface CachedPostIndex {
     posts: Array<{
         id: number;
@@ -47,5 +56,6 @@ export interface CachedPostIndex {
         updated_at: string;
     }>;
     last_sync: string;
+    metadata?: CacheMetadata;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,IAAI,EAAE,CAAC;CACd;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI;IAC9C,iBAAiB,EAAE,eAAe,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,IAAI,EAAE,CAAC;CACd;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI;IAC9C,iBAAiB,EAAE,eAAe,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@content-streamline/nextjs",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Next.js library for Content Streamline API with reusable components",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",