@nexushub/client 0.0.8 → 0.1.0

package/dist/cache-types-B39iNHfE.d.cts

@@ -0,0 +1,9 @@
+interface ILocalCache {
+    isLoaded(): boolean;
+    getPage(slug: string): Promise<any>;
+    getCollection(collectionId: string): Promise<any[] | null>;
+    getGlobals(): Promise<any>;
+    getAllData(): Promise<any>;
+}
+
+export type { ILocalCache as I };

package/dist/cache-types-B39iNHfE.d.ts

@@ -0,0 +1,9 @@
+interface ILocalCache {
+    isLoaded(): boolean;
+    getPage(slug: string): Promise<any>;
+    getCollection(collectionId: string): Promise<any[] | null>;
+    getGlobals(): Promise<any>;
+    getAllData(): Promise<any>;
+}
+
+export type { ILocalCache as I };

package/dist/cli.cjs

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/dist/content/local-cache-client.cjs

@@ -1,8 +1,7 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-OBGZSXTJ.cjs');
-
-// src/content/local-cache-client.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/content/local-cache-client.ts
 var LocalCache = class {
   constructor(customPath) {
+    // Maintain private properties for type parity with the Server version
     this.data = null;
     this.hasLoaded = false;
     this.cachePath = customPath || ".nexus/cache.json";
@@ -15,7 +14,7 @@ var LocalCache = class {
     return false;
   }
   /**
-   * No-op method to maintain API compatibility with the Node version.
+   * No-op method to maintain internal API compatibility.
    */
   load() {
     return;
@@ -24,32 +23,35 @@ var LocalCache = class {
    * Returns null. Browsers should fetch pages from the Remote API
    * or the Memory/Browser cache.
    */
-  getPage(_slug) {
+  async getPage(_slug) {
     return null;
   }
   /**
    * Returns null. Browsers should fetch collections from the Remote API.
    */
-  getCollection(_collectionId) {
+  async getCollection(_collectionId) {
     return null;
   }
   /**
    * Returns null.
    */
-  getGlobals() {
+  async getGlobals() {
     return null;
   }
   /**
    * Returns null.
    */
-  getAllData() {
+  async getAllData() {
     return null;
   }
   /**
    * Dummy helper to match Node implementation.
    */
-  shouldWarnAboutMissingCache(_error) {
-    return false;
+  shouldWarnAboutMissingCache(error) {
+    const isMissing = error.code === "ENOENT";
+    const isMalformed = error instanceof SyntaxError;
+    if (process.env.NODE_ENV !== "development") return false;
+    return !isMissing || isMalformed;
   }
 };
 

package/dist/content/local-cache-client.d.cts

@@ -1,4 +1,4 @@
-import { I as ILocalCache } from '../cache-CtPpNvIZ.cjs';
+import { I as ILocalCache } from '../cache-types-B39iNHfE.cjs';
 
 /**
  * NexusHub LocalCache (Browser Implementation)
@@ -7,10 +7,9 @@ import { I as ILocalCache } from '../cache-CtPpNvIZ.cjs';
  * Since the browser has no access to the Node.js File System (fs), this
  * implementation returns null for all operations.
  *
- * The real logic is located in local-cache.node.ts and is swapped
+ * The real logic is located in local-cache-server.ts and is swapped
  * automatically by the bundler via the "browser" field in package.json.
  */
-
 declare class LocalCache implements ILocalCache {
     private data;
     private hasLoaded;
@@ -22,26 +21,26 @@ declare class LocalCache implements ILocalCache {
      */
     isLoaded(): boolean;
     /**
-     * No-op method to maintain API compatibility with the Node version.
+     * No-op method to maintain internal API compatibility.
      */
     private load;
     /**
      * Returns null. Browsers should fetch pages from the Remote API
      * or the Memory/Browser cache.
      */
-    getPage(_slug: string): any;
+    getPage(_slug: string): Promise<any>;
     /**
      * Returns null. Browsers should fetch collections from the Remote API.
      */
-    getCollection(_collectionId: string): any[] | null;
+    getCollection(_collectionId: string): Promise<any[] | null>;
     /**
      * Returns null.
      */
-    getGlobals(): any;
+    getGlobals(): Promise<any>;
     /**
      * Returns null.
      */
-    getAllData(): any;
+    getAllData(): Promise<any>;
     /**
      * Dummy helper to match Node implementation.
      */

package/dist/content/local-cache-client.d.ts

@@ -1,4 +1,4 @@
-import { I as ILocalCache } from '../cache-CtPpNvIZ.js';
+import { I as ILocalCache } from '../cache-types-B39iNHfE.js';
 
 /**
  * NexusHub LocalCache (Browser Implementation)
@@ -7,10 +7,9 @@ import { I as ILocalCache } from '../cache-CtPpNvIZ.js';
  * Since the browser has no access to the Node.js File System (fs), this
  * implementation returns null for all operations.
  *
- * The real logic is located in local-cache.node.ts and is swapped
+ * The real logic is located in local-cache-server.ts and is swapped
  * automatically by the bundler via the "browser" field in package.json.
  */
-
 declare class LocalCache implements ILocalCache {
     private data;
     private hasLoaded;
@@ -22,26 +21,26 @@ declare class LocalCache implements ILocalCache {
      */
     isLoaded(): boolean;
     /**
-     * No-op method to maintain API compatibility with the Node version.
+     * No-op method to maintain internal API compatibility.
      */
     private load;
     /**
      * Returns null. Browsers should fetch pages from the Remote API
      * or the Memory/Browser cache.
      */
-    getPage(_slug: string): any;
+    getPage(_slug: string): Promise<any>;
     /**
      * Returns null. Browsers should fetch collections from the Remote API.
      */
-    getCollection(_collectionId: string): any[] | null;
+    getCollection(_collectionId: string): Promise<any[] | null>;
     /**
      * Returns null.
      */
-    getGlobals(): any;
+    getGlobals(): Promise<any>;
     /**
      * Returns null.
      */
-    getAllData(): any;
+    getAllData(): Promise<any>;
     /**
      * Dummy helper to match Node implementation.
      */

package/dist/content/local-cache-client.js

@@ -1,8 +1,7 @@
-import "../chunk-3RG5ZIWI.js";
-
 // src/content/local-cache-client.ts
 var LocalCache = class {
   constructor(customPath) {
+    // Maintain private properties for type parity with the Server version
     this.data = null;
     this.hasLoaded = false;
     this.cachePath = customPath || ".nexus/cache.json";
@@ -15,7 +14,7 @@ var LocalCache = class {
     return false;
   }
   /**
-   * No-op method to maintain API compatibility with the Node version.
+   * No-op method to maintain internal API compatibility.
    */
   load() {
     return;
@@ -24,32 +23,35 @@ var LocalCache = class {
    * Returns null. Browsers should fetch pages from the Remote API
    * or the Memory/Browser cache.
    */
-  getPage(_slug) {
+  async getPage(_slug) {
     return null;
   }
   /**
    * Returns null. Browsers should fetch collections from the Remote API.
    */
-  getCollection(_collectionId) {
+  async getCollection(_collectionId) {
     return null;
   }
   /**
    * Returns null.
    */
-  getGlobals() {
+  async getGlobals() {
     return null;
   }
   /**
    * Returns null.
    */
-  getAllData() {
+  async getAllData() {
     return null;
   }
   /**
    * Dummy helper to match Node implementation.
    */
-  shouldWarnAboutMissingCache(_error) {
-    return false;
+  shouldWarnAboutMissingCache(error) {
+    const isMissing = error.code === "ENOENT";
+    const isMalformed = error instanceof SyntaxError;
+    if (process.env.NODE_ENV !== "development") return false;
+    return !isMissing || isMalformed;
   }
 };
 export {

package/dist/content/local-cache-server.cjs

@@ -1,6 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }require('../chunk-OBGZSXTJ.cjs');
-
-// src/content/local-cache-server.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/content/local-cache-server.ts
 var _fs = require('fs'); var _fs2 = _interopRequireDefault(_fs);
 var _path = require('path'); var _path2 = _interopRequireDefault(_path);
 var LocalCache = class {
@@ -45,8 +43,8 @@ var LocalCache = class {
     } catch (error) {
       if (this.shouldWarnAboutMissingCache(error)) {
         console.warn(
-          `\u26A0\uFE0F NexusHub: Local cache not found or invalid at ${this.cachePath}
-   Run \`npx nexus pull\` to generate seed data if you want to work offline.`
+          `\u26A0\uFE0F NexusHub: Local cache invalid at ${this.cachePath}
+   Run \`npx nexus pull\` to fix your seed data.`
         );
       }
     }
@@ -54,7 +52,7 @@ var LocalCache = class {
   /**
    * Retrieve a specific page from the local pages array.
    */
-  getPage(slug) {
+  async getPage(slug) {
     this.load();
     if (!_optionalChain([this, 'access', _4 => _4.data, 'optionalAccess', _5 => _5.pages])) return null;
     const page = this.data.pages.find((p) => p.slug === slug);
@@ -69,7 +67,7 @@ var LocalCache = class {
   /**
    * Retrieve an entire collection from the local collections map.
    */
-  getCollection(collectionId) {
+  async getCollection(collectionId) {
     this.load();
     if (!_optionalChain([this, 'access', _6 => _6.data, 'optionalAccess', _7 => _7.collections])) return null;
     const collection = this.data.collections[collectionId];
@@ -86,14 +84,14 @@ var LocalCache = class {
   /**
    * Retrieve global settings from the local cache.
    */
-  getGlobals() {
+  async getGlobals() {
     this.load();
     return _optionalChain([this, 'access', _8 => _8.data, 'optionalAccess', _9 => _9.globals]) || null;
   }
   /**
    * Returns the entire raw JSON data structure from the cache file.
    */
-  getAllData() {
+  async getAllData() {
     this.load();
     return this.data;
   }

package/dist/content/local-cache-server.d.cts

@@ -1,4 +1,4 @@
-import { I as ILocalCache } from '../cache-CtPpNvIZ.cjs';
+import { I as ILocalCache } from '../cache-types-B39iNHfE.cjs';
 
 declare class LocalCache implements ILocalCache {
     private data;
@@ -18,19 +18,19 @@ declare class LocalCache implements ILocalCache {
     /**
      * Retrieve a specific page from the local pages array.
      */
-    getPage(slug: string): any;
+    getPage(slug: string): Promise<any>;
     /**
      * Retrieve an entire collection from the local collections map.
      */
-    getCollection(collectionId: string): any[] | null;
+    getCollection(collectionId: string): Promise<any[] | null>;
     /**
      * Retrieve global settings from the local cache.
      */
-    getGlobals(): any;
+    getGlobals(): Promise<any>;
     /**
      * Returns the entire raw JSON data structure from the cache file.
      */
-    getAllData(): any;
+    getAllData(): Promise<any>;
     /**
      * Helper to determine if we should bother the user with a warning.
      */

package/dist/content/local-cache-server.d.ts

@@ -1,4 +1,4 @@
-import { I as ILocalCache } from '../cache-CtPpNvIZ.js';
+import { I as ILocalCache } from '../cache-types-B39iNHfE.js';
 
 declare class LocalCache implements ILocalCache {
     private data;
@@ -18,19 +18,19 @@ declare class LocalCache implements ILocalCache {
     /**
      * Retrieve a specific page from the local pages array.
      */
-    getPage(slug: string): any;
+    getPage(slug: string): Promise<any>;
     /**
      * Retrieve an entire collection from the local collections map.
      */
-    getCollection(collectionId: string): any[] | null;
+    getCollection(collectionId: string): Promise<any[] | null>;
     /**
      * Retrieve global settings from the local cache.
      */
-    getGlobals(): any;
+    getGlobals(): Promise<any>;
     /**
      * Returns the entire raw JSON data structure from the cache file.
      */
-    getAllData(): any;
+    getAllData(): Promise<any>;
     /**
      * Helper to determine if we should bother the user with a warning.
      */

package/dist/content/local-cache-server.js

@@ -1,5 +1,3 @@
-import "../chunk-3RG5ZIWI.js";
-
 // src/content/local-cache-server.ts
 import fs from "fs";
 import path from "path";
@@ -45,8 +43,8 @@ var LocalCache = class {
     } catch (error) {
       if (this.shouldWarnAboutMissingCache(error)) {
         console.warn(
-          `\u26A0\uFE0F NexusHub: Local cache not found or invalid at ${this.cachePath}
-   Run \`npx nexus pull\` to generate seed data if you want to work offline.`
+          `\u26A0\uFE0F NexusHub: Local cache invalid at ${this.cachePath}
+   Run \`npx nexus pull\` to fix your seed data.`
         );
       }
     }
@@ -54,7 +52,7 @@ var LocalCache = class {
   /**
    * Retrieve a specific page from the local pages array.
    */
-  getPage(slug) {
+  async getPage(slug) {
     this.load();
     if (!this.data?.pages) return null;
     const page = this.data.pages.find((p) => p.slug === slug);
@@ -69,7 +67,7 @@ var LocalCache = class {
   /**
    * Retrieve an entire collection from the local collections map.
    */
-  getCollection(collectionId) {
+  async getCollection(collectionId) {
     this.load();
     if (!this.data?.collections) return null;
     const collection = this.data.collections[collectionId];
@@ -86,14 +84,14 @@ var LocalCache = class {
   /**
    * Retrieve global settings from the local cache.
    */
-  getGlobals() {
+  async getGlobals() {
     this.load();
     return this.data?.globals || null;
   }
   /**
    * Returns the entire raw JSON data structure from the cache file.
    */
-  getAllData() {
+  async getAllData() {
     this.load();
     return this.data;
   }

package/dist/index.cjs

@@ -1,8 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
-
-var _chunkOBGZSXTJcjs = require('./chunk-OBGZSXTJ.cjs');
-
-// src/config.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/config.ts
 var DEFAULT_API_URL = "http://localhost:3001";
 var DEFAULT_ANALYTICS_URL = "http://localhost:3002";
 var LOCAL_NEST_URL = "http://localhost:3001";
@@ -308,20 +304,42 @@ var BrowserCache = class {
 };
 
 // src/content/cache.ts
-var LocalCacheConstructor;
-if (typeof window === "undefined") {
-  try {
-    const serverPath = "./local-cache-server";
-    LocalCacheConstructor = _chunkOBGZSXTJcjs.__require.call(void 0, serverPath).LocalCache;
-  } catch (e) {
-    LocalCacheConstructor = class Dummy {
-    };
+var LocalCacheProxy = class {
+  constructor(cachePath) {
+    this.instance = null;
+    this.cachePath = cachePath;
   }
-} else {
-  const clientPath = "./local-cache-client";
-  LocalCacheConstructor = _chunkOBGZSXTJcjs.__require.call(void 0, clientPath).LocalCache;
-}
-var LocalCache = LocalCacheConstructor;
+  async getInstance() {
+    if (this.instance) return this.instance;
+    if (typeof window === "undefined") {
+      const mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./content/local-cache-server.cjs")));
+      this.instance = new mod.LocalCache(this.cachePath);
+    } else {
+      const mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./content/local-cache-client.cjs")));
+      this.instance = new mod.LocalCache(this.cachePath);
+    }
+    return this.instance;
+  }
+  isLoaded() {
+    return _optionalChain([this, 'access', _7 => _7.instance, 'optionalAccess', _8 => _8.isLoaded, 'call', _9 => _9()]) || false;
+  }
+  async getPage(slug) {
+    const inst = await this.getInstance();
+    return inst.getPage(slug);
+  }
+  async getCollection(id) {
+    const inst = await this.getInstance();
+    return inst.getCollection(id);
+  }
+  async getGlobals() {
+    const inst = await this.getInstance();
+    return inst.getGlobals();
+  }
+  async getAllData() {
+    const inst = await this.getInstance();
+    return inst.getAllData();
+  }
+};
 
 // src/content/strategies.ts
 var RateLimiter = class {
@@ -391,10 +409,10 @@ var ExponentialBackoff = class {
     return delay;
   }
   isClientError(error) {
-    return _optionalChain([error, 'optionalAccess', _7 => _7.status]) >= 400 && _optionalChain([error, 'optionalAccess', _8 => _8.status]) < 500;
+    return _optionalChain([error, 'optionalAccess', _10 => _10.status]) >= 400 && _optionalChain([error, 'optionalAccess', _11 => _11.status]) < 500;
   }
   isRateLimitError(error) {
-    return _optionalChain([error, 'optionalAccess', _9 => _9.status]) === 429;
+    return _optionalChain([error, 'optionalAccess', _12 => _12.status]) === 429;
   }
 };
 var CircuitBreaker = class {
@@ -508,10 +526,10 @@ function buildQueryString(query) {
   if (query.sort) params.append("sort", query.sort);
   if (query.order) params.append("order", query.order);
   if (query.search) params.append("search", query.search);
-  if (_optionalChain([query, 'access', _10 => _10.include, 'optionalAccess', _11 => _11.length])) {
+  if (_optionalChain([query, 'access', _13 => _13.include, 'optionalAccess', _14 => _14.length])) {
     params.append("include", query.include.join(","));
   }
-  if (_optionalChain([query, 'access', _12 => _12.fields, 'optionalAccess', _13 => _13.length])) {
+  if (_optionalChain([query, 'access', _15 => _15.fields, 'optionalAccess', _16 => _16.length])) {
     params.append("fields", query.fields.join(","));
   }
   if (query.filter) {
@@ -534,7 +552,7 @@ var ContentEngine = class {
   constructor(config) {
     this.config = config;
     this.isServer = typeof window === "undefined";
-    this.localCache = new LocalCache();
+    this.localCache = new LocalCacheProxy();
     this.memoryCache = new MemoryCache({
       maxSize: 500,
       ttl: 5 * 60 * 1e3
@@ -585,7 +603,11 @@ var ContentEngine = class {
       includeMetadata = false
     } = options;
     const cacheKey = `page:${slug}`;
-    const cached = this.checkCaches(cacheKey, forceRefresh, includeMetadata);
+    const cached = await this.checkCaches(
+      cacheKey,
+      forceRefresh,
+      includeMetadata
+    );
     if (cached) {
       if (this.config.debug) console.log(`[NexusHub] \u26A1 Cache hit: ${slug}`);
       return includeMetadata ? cached : cached.data;
@@ -650,7 +672,7 @@ var ContentEngine = class {
     } = options;
     const queryString = buildQueryString(normalizedQuery);
     const cacheKey = `collection:${collectionId}:${queryString}`;
-    const cached = this.checkCaches(
+    const cached = await this.checkCaches(
       cacheKey,
       forceRefresh,
       includeMetadata
@@ -664,7 +686,7 @@ var ContentEngine = class {
       return includeMetadata ? cached : cached.data;
     }
     if (!forceRefresh && process.env.NODE_ENV === "development") {
-      const localCollection = this.localCache.getCollection(collectionId);
+      const localCollection = await this.localCache.getCollection(collectionId);
       if (localCollection) {
         const result = this.applyLocalQuery(
           localCollection,
@@ -789,7 +811,7 @@ var ContentEngine = class {
     }
     return this.requestBatcher.schedule(cacheKey, async () => {
       const params = new URLSearchParams();
-      if (_optionalChain([options, 'access', _14 => _14.include, 'optionalAccess', _15 => _15.length])) {
+      if (_optionalChain([options, 'access', _17 => _17.include, 'optionalAccess', _18 => _18.length])) {
         params.append("include", options.include.join(","));
       }
       const url = `${this.config.apiUrl}/content/${this.config.projectId}/collection/${collectionId}/${itemId}?${params}`;
@@ -822,10 +844,10 @@ var ContentEngine = class {
       q: query,
       limit: (options.limit || 20).toString()
     });
-    if (_optionalChain([options, 'access', _16 => _16.collections, 'optionalAccess', _17 => _17.length])) {
+    if (_optionalChain([options, 'access', _19 => _19.collections, 'optionalAccess', _20 => _20.length])) {
       params.append("collections", options.collections.join(","));
     }
-    if (_optionalChain([options, 'access', _18 => _18.fields, 'optionalAccess', _19 => _19.length])) {
+    if (_optionalChain([options, 'access', _21 => _21.fields, 'optionalAccess', _22 => _22.length])) {
       params.append("fields", options.fields.join(","));
     }
     const url = `${this.config.apiUrl}/content/${this.config.projectId}/search?${params}`;
@@ -886,7 +908,7 @@ var ContentEngine = class {
         }
       };
       eventSource.onerror = () => {
-        _optionalChain([eventSource, 'optionalAccess', _20 => _20.close, 'call', _21 => _21()]);
+        _optionalChain([eventSource, 'optionalAccess', _23 => _23.close, 'call', _24 => _24()]);
         if (isClosed) return;
         const timeout = Math.min(1e3 * Math.pow(2, retryCount), 1e4);
         retryCount++;
@@ -899,14 +921,14 @@ var ContentEngine = class {
     connect();
     return () => {
       isClosed = true;
-      _optionalChain([eventSource, 'optionalAccess', _22 => _22.close, 'call', _23 => _23()]);
+      _optionalChain([eventSource, 'optionalAccess', _25 => _25.close, 'call', _26 => _26()]);
     };
   }
   // --- CACHE MANAGEMENT ---
   /**
    * Check all caches in order of speed
    */
-  checkCaches(key, forceRefresh, includeMetadata) {
+  async checkCaches(key, forceRefresh, includeMetadata) {
     if (forceRefresh) return null;
     if (this.cacheStrategy === "memory") {
       const cached = this.memoryCache.get(key);
@@ -931,7 +953,7 @@ var ContentEngine = class {
     if (process.env.NODE_ENV === "development") {
       if (key.startsWith("page:")) {
         const slug = key.split(":")[1];
-        const local = this.localCache.getPage(slug);
+        const local = await this.localCache.getPage(slug);
         if (local) {
           return {
             data: local,
@@ -1588,8 +1610,8 @@ var AnalyticsEngine = class {
       navigator.share = (data) => {
         this.tracker.send("social_share", {
           method: "native_share_menu",
-          url: _optionalChain([data, 'optionalAccess', _24 => _24.url]) || window.location.href,
-          title: _optionalChain([data, 'optionalAccess', _25 => _25.title])
+          url: _optionalChain([data, 'optionalAccess', _27 => _27.url]) || window.location.href,
+          title: _optionalChain([data, 'optionalAccess', _28 => _28.title])
         });
         return originalShare.apply(navigator, [data]);
       };
@@ -1720,7 +1742,7 @@ var AnalyticsEngine = class {
         this.tracker.send("click", {
           element_type: "link",
           href: link.href,
-          text: _optionalChain([link, 'access', _26 => _26.innerText, 'optionalAccess', _27 => _27.substring, 'call', _28 => _28(0, 50)]),
+          text: _optionalChain([link, 'access', _29 => _29.innerText, 'optionalAccess', _30 => _30.substring, 'call', _31 => _31(0, 50)]),
           id: link.id,
           classes: link.className,
           dataset: { ...link.dataset }
@@ -1730,7 +1752,7 @@ var AnalyticsEngine = class {
       if (button) {
         this.tracker.send("click", {
           element_type: "button",
-          text: _optionalChain([button, 'access', _29 => _29.innerText, 'optionalAccess', _30 => _30.substring, 'call', _31 => _31(0, 50)]),
+          text: _optionalChain([button, 'access', _32 => _32.innerText, 'optionalAccess', _33 => _33.substring, 'call', _34 => _34(0, 50)]),
           id: button.id,
           classes: button.className,
           coordinates: { x: e.clientX, y: e.clientY }
@@ -1800,11 +1822,11 @@ var NexusClient = class {
   constructor(config) {
     const fullConfig = getFullConfig(config);
     this.config = {
-      debug: _optionalChain([config, 'optionalAccess', _32 => _32.debug]) || false,
-      cacheStrategy: _optionalChain([config, 'optionalAccess', _33 => _33.cacheStrategy]) || "memory",
-      revalidateTime: _optionalChain([config, 'optionalAccess', _34 => _34.revalidateTime]) || 60,
-      timeout: _optionalChain([config, 'optionalAccess', _35 => _35.timeout]) || 1e4,
-      retries: _optionalChain([config, 'optionalAccess', _36 => _36.retries]) || 3,
+      debug: _optionalChain([config, 'optionalAccess', _35 => _35.debug]) || false,
+      cacheStrategy: _optionalChain([config, 'optionalAccess', _36 => _36.cacheStrategy]) || "memory",
+      revalidateTime: _optionalChain([config, 'optionalAccess', _37 => _37.revalidateTime]) || 60,
+      timeout: _optionalChain([config, 'optionalAccess', _38 => _38.timeout]) || 1e4,
+      retries: _optionalChain([config, 'optionalAccess', _39 => _39.retries]) || 3,
       ...fullConfig
     };
     this.content = new ContentEngine(this.config);
@@ -2084,4 +2106,4 @@ var VERSION = "0.0.1";
 
 
 
-exports.AnalyticsEngine = AnalyticsEngine; exports.AuthProvider = AuthProvider; exports.BrowserCache = BrowserCache; exports.CacheTags = CacheTags; exports.ContentEngine = ContentEngine; exports.DEFAULT_ANALYTICS_URL = DEFAULT_ANALYTICS_URL; exports.DEFAULT_API_URL = DEFAULT_API_URL; exports.LOCAL_NEST_URL = LOCAL_NEST_URL; exports.LOCAL_RUST_URL = LOCAL_RUST_URL; exports.LocalCache = LocalCache; exports.MemoryCache = MemoryCache; exports.NexusClient = NexusClient; exports.NexusProvider = NexusProvider; exports.VERSION = VERSION; exports.createNexusClient = createNexusClient; exports.getEnvConfig = getEnvConfig; exports.getFullConfig = getFullConfig; exports.mergeConfigs = mergeConfigs; exports.nexus = nexus; exports.useNexusAuth = useNexusAuth; exports.validateConfig = validateConfig;
+exports.AnalyticsEngine = AnalyticsEngine; exports.AuthProvider = AuthProvider; exports.BrowserCache = BrowserCache; exports.CacheTags = CacheTags; exports.ContentEngine = ContentEngine; exports.DEFAULT_ANALYTICS_URL = DEFAULT_ANALYTICS_URL; exports.DEFAULT_API_URL = DEFAULT_API_URL; exports.LOCAL_NEST_URL = LOCAL_NEST_URL; exports.LOCAL_RUST_URL = LOCAL_RUST_URL; exports.LocalCache = LocalCacheProxy; exports.MemoryCache = MemoryCache; exports.NexusClient = NexusClient; exports.NexusProvider = NexusProvider; exports.VERSION = VERSION; exports.createNexusClient = createNexusClient; exports.getEnvConfig = getEnvConfig; exports.getFullConfig = getFullConfig; exports.mergeConfigs = mergeConfigs; exports.nexus = nexus; exports.useNexusAuth = useNexusAuth; exports.validateConfig = validateConfig;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-export { L as LocalCache } from './cache-CtPpNvIZ.cjs';
+import { I as ILocalCache } from './cache-types-B39iNHfE.cjs';
 
 interface MinimalNexusConfig {
     apiUrl?: string;
@@ -397,6 +397,18 @@ declare class BrowserCache {
     private evictOldest;
 }
 
+declare class LocalCacheProxy implements ILocalCache {
+    private instance;
+    private cachePath?;
+    constructor(cachePath?: string);
+    private getInstance;
+    isLoaded(): boolean;
+    getPage(slug: string): Promise<any>;
+    getCollection(id: string): Promise<any[] | null>;
+    getGlobals(): Promise<any>;
+    getAllData(): Promise<any>;
+}
+
 declare const VERSION = "0.0.1";
 
-export { AnalyticsEngine, type AuthContextType, type AuthError, AuthProvider, type AuthState, BrowserCache, type CacheEntry, type CacheMetadata, CacheTags, type CollectionQuery, type CollectionResponse, ContentEngine, type ContentResponse, DEFAULT_ANALYTICS_URL, DEFAULT_API_URL, type ErrorResponse, LOCAL_NEST_URL, LOCAL_RUST_URL, type LoginCredentials, MemoryCache, type MinimalNexusConfig, NexusClient, type NexusConfig, NexusProvider, type RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, mergeConfigs, nexus, useNexusAuth, validateConfig };
+export { AnalyticsEngine, type AuthContextType, type AuthError, AuthProvider, type AuthState, BrowserCache, type CacheEntry, type CacheMetadata, CacheTags, type CollectionQuery, type CollectionResponse, ContentEngine, type ContentResponse, DEFAULT_ANALYTICS_URL, DEFAULT_API_URL, type ErrorResponse, LOCAL_NEST_URL, LOCAL_RUST_URL, LocalCacheProxy as LocalCache, type LoginCredentials, MemoryCache, type MinimalNexusConfig, NexusClient, type NexusConfig, NexusProvider, type RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, mergeConfigs, nexus, useNexusAuth, validateConfig };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-export { L as LocalCache } from './cache-CtPpNvIZ.js';
+import { I as ILocalCache } from './cache-types-B39iNHfE.js';
 
 interface MinimalNexusConfig {
     apiUrl?: string;
@@ -397,6 +397,18 @@ declare class BrowserCache {
     private evictOldest;
 }
 
+declare class LocalCacheProxy implements ILocalCache {
+    private instance;
+    private cachePath?;
+    constructor(cachePath?: string);
+    private getInstance;
+    isLoaded(): boolean;
+    getPage(slug: string): Promise<any>;
+    getCollection(id: string): Promise<any[] | null>;
+    getGlobals(): Promise<any>;
+    getAllData(): Promise<any>;
+}
+
 declare const VERSION = "0.0.1";
 
-export { AnalyticsEngine, type AuthContextType, type AuthError, AuthProvider, type AuthState, BrowserCache, type CacheEntry, type CacheMetadata, CacheTags, type CollectionQuery, type CollectionResponse, ContentEngine, type ContentResponse, DEFAULT_ANALYTICS_URL, DEFAULT_API_URL, type ErrorResponse, LOCAL_NEST_URL, LOCAL_RUST_URL, type LoginCredentials, MemoryCache, type MinimalNexusConfig, NexusClient, type NexusConfig, NexusProvider, type RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, mergeConfigs, nexus, useNexusAuth, validateConfig };
+export { AnalyticsEngine, type AuthContextType, type AuthError, AuthProvider, type AuthState, BrowserCache, type CacheEntry, type CacheMetadata, CacheTags, type CollectionQuery, type CollectionResponse, ContentEngine, type ContentResponse, DEFAULT_ANALYTICS_URL, DEFAULT_API_URL, type ErrorResponse, LOCAL_NEST_URL, LOCAL_RUST_URL, LocalCacheProxy as LocalCache, type LoginCredentials, MemoryCache, type MinimalNexusConfig, NexusClient, type NexusConfig, NexusProvider, type RegisterCredentials, type SiteUser, VERSION, createNexusClient, getEnvConfig, getFullConfig, mergeConfigs, nexus, useNexusAuth, validateConfig };

package/dist/index.js

@@ -1,7 +1,3 @@
-import {
-  __require
-} from "./chunk-3RG5ZIWI.js";
-
 // src/config.ts
 var DEFAULT_API_URL = "http://localhost:3001";
 var DEFAULT_ANALYTICS_URL = "http://localhost:3002";
@@ -308,20 +304,42 @@ var BrowserCache = class {
 };
 
 // src/content/cache.ts
-var LocalCacheConstructor;
-if (typeof window === "undefined") {
-  try {
-    const serverPath = "./local-cache-server";
-    LocalCacheConstructor = __require(serverPath).LocalCache;
-  } catch (e) {
-    LocalCacheConstructor = class Dummy {
-    };
+var LocalCacheProxy = class {
+  constructor(cachePath) {
+    this.instance = null;
+    this.cachePath = cachePath;
   }
-} else {
-  const clientPath = "./local-cache-client";
-  LocalCacheConstructor = __require(clientPath).LocalCache;
-}
-var LocalCache = LocalCacheConstructor;
+  async getInstance() {
+    if (this.instance) return this.instance;
+    if (typeof window === "undefined") {
+      const mod = await import("./content/local-cache-server.js");
+      this.instance = new mod.LocalCache(this.cachePath);
+    } else {
+      const mod = await import("./content/local-cache-client.js");
+      this.instance = new mod.LocalCache(this.cachePath);
+    }
+    return this.instance;
+  }
+  isLoaded() {
+    return this.instance?.isLoaded() || false;
+  }
+  async getPage(slug) {
+    const inst = await this.getInstance();
+    return inst.getPage(slug);
+  }
+  async getCollection(id) {
+    const inst = await this.getInstance();
+    return inst.getCollection(id);
+  }
+  async getGlobals() {
+    const inst = await this.getInstance();
+    return inst.getGlobals();
+  }
+  async getAllData() {
+    const inst = await this.getInstance();
+    return inst.getAllData();
+  }
+};
 
 // src/content/strategies.ts
 var RateLimiter = class {
@@ -534,7 +552,7 @@ var ContentEngine = class {
   constructor(config) {
     this.config = config;
     this.isServer = typeof window === "undefined";
-    this.localCache = new LocalCache();
+    this.localCache = new LocalCacheProxy();
     this.memoryCache = new MemoryCache({
       maxSize: 500,
       ttl: 5 * 60 * 1e3
@@ -585,7 +603,11 @@ var ContentEngine = class {
       includeMetadata = false
     } = options;
     const cacheKey = `page:${slug}`;
-    const cached = this.checkCaches(cacheKey, forceRefresh, includeMetadata);
+    const cached = await this.checkCaches(
+      cacheKey,
+      forceRefresh,
+      includeMetadata
+    );
     if (cached) {
       if (this.config.debug) console.log(`[NexusHub] \u26A1 Cache hit: ${slug}`);
       return includeMetadata ? cached : cached.data;
@@ -650,7 +672,7 @@ var ContentEngine = class {
     } = options;
     const queryString = buildQueryString(normalizedQuery);
     const cacheKey = `collection:${collectionId}:${queryString}`;
-    const cached = this.checkCaches(
+    const cached = await this.checkCaches(
       cacheKey,
       forceRefresh,
       includeMetadata
@@ -664,7 +686,7 @@ var ContentEngine = class {
       return includeMetadata ? cached : cached.data;
     }
     if (!forceRefresh && process.env.NODE_ENV === "development") {
-      const localCollection = this.localCache.getCollection(collectionId);
+      const localCollection = await this.localCache.getCollection(collectionId);
       if (localCollection) {
         const result = this.applyLocalQuery(
           localCollection,
@@ -906,7 +928,7 @@ var ContentEngine = class {
   /**
    * Check all caches in order of speed
    */
-  checkCaches(key, forceRefresh, includeMetadata) {
+  async checkCaches(key, forceRefresh, includeMetadata) {
     if (forceRefresh) return null;
     if (this.cacheStrategy === "memory") {
       const cached = this.memoryCache.get(key);
@@ -931,7 +953,7 @@ var ContentEngine = class {
     if (process.env.NODE_ENV === "development") {
       if (key.startsWith("page:")) {
         const slug = key.split(":")[1];
-        const local = this.localCache.getPage(slug);
+        const local = await this.localCache.getPage(slug);
         if (local) {
           return {
             data: local,
@@ -2072,7 +2094,7 @@ export {
   DEFAULT_API_URL,
   LOCAL_NEST_URL,
   LOCAL_RUST_URL,
-  LocalCache,
+  LocalCacheProxy as LocalCache,
   MemoryCache,
   NexusClient,
   NexusProvider,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nexushub/client",
   "private": false,
-  "version": "0.0.8",
+  "version": "0.1.0",
   "description": "The God-Tier NexusHub SDK",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/cache-CtPpNvIZ.d.cts

@@ -1,11 +0,0 @@
-interface ILocalCache {
-    isLoaded(): boolean;
-    getPage(slug: string): any;
-    getCollection(collectionId: string): any[] | null;
-    getGlobals(): any;
-    getAllData(): any;
-}
-declare const LocalCache: any;
-type LocalCache = ILocalCache;
-
-export { type ILocalCache as I, LocalCache as L };

package/dist/cache-CtPpNvIZ.d.ts

@@ -1,11 +0,0 @@
-interface ILocalCache {
-    isLoaded(): boolean;
-    getPage(slug: string): any;
-    getCollection(collectionId: string): any[] | null;
-    getGlobals(): any;
-    getAllData(): any;
-}
-declare const LocalCache: any;
-type LocalCache = ILocalCache;
-
-export { type ILocalCache as I, LocalCache as L };

package/dist/chunk-3RG5ZIWI.js

@@ -1,10 +0,0 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-export {
-  __require
-};

package/dist/chunk-OBGZSXTJ.cjs

@@ -1,10 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-
-
-exports.__require = __require;