@content-streamline/nextjs 0.0.3 → 0.0.5

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 = 60, forceRefresh = false, platform } = options || {};
-    // Check cache freshness
+    const { maxCacheAge = 15, forceRefresh = false, platform } = options || {};
+    // 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 = 60, forceRefresh = false, } = options || {};
-    // Try cache first
+    const { language = 'en', contentFormat = 'markdown', maxCacheAge = 15, forceRefresh = false, } = options || {};
+    // 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.3",
+  "version": "0.0.5",
   "description": "Next.js library for Content Streamline API with reusable components",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",