@nexushub/client 0.0.7 → 0.0.9

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/content/local-cache-client.cjs

@@ -1,8 +1,7 @@
-'use strict';
-
-// 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,33 +23,37 @@ 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;
   }
 };
 
+
 exports.LocalCache = LocalCache;

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

@@ -1,3 +1,5 @@
+import { I as ILocalCache } from '../cache-types-B39iNHfE.cjs';
+
 /**
  * NexusHub LocalCache (Browser Implementation)
  *
@@ -5,10 +7,10 @@
  * 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 {
+declare class LocalCache implements ILocalCache {
     private data;
     private hasLoaded;
     private cachePath;
@@ -19,26 +21,26 @@ declare class LocalCache {
      */
     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,3 +1,5 @@
+import { I as ILocalCache } from '../cache-types-B39iNHfE.js';
+
 /**
  * NexusHub LocalCache (Browser Implementation)
  *
@@ -5,10 +7,10 @@
  * 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 {
+declare class LocalCache implements ILocalCache {
     private data;
     private hasLoaded;
     private cachePath;
@@ -19,26 +21,26 @@ declare class LocalCache {
      */
     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,6 +1,7 @@
 // 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";
@@ -13,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;
@@ -22,33 +23,37 @@ 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 { LocalCache };
+export {
+  LocalCache
+};

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

@@ -1,10 +1,110 @@
-'use strict';
+"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 {
+  constructor(customPath) {
+    this.data = null;
+    this.hasLoaded = false;
+    this.cachePath = customPath || ".nexus/cache.json";
+  }
+  /**
+   * Returns true if the local cache file has been successfully
+   * loaded and parsed into memory.
+   */
+  isLoaded() {
+    return this.hasLoaded;
+  }
+  /**
+   * Reads the cache file from the filesystem.
+   * Internal method called lazily by the getters.
+   */
+  load() {
+    if (typeof window !== "undefined") return;
+    if (this.hasLoaded) return;
+    try {
+      const fullPath = _path2.default.resolve(process.cwd(), this.cachePath);
+      if (_fs2.default.existsSync(fullPath)) {
+        const fileContent = _fs2.default.readFileSync(fullPath, "utf-8");
+        this.data = JSON.parse(fileContent);
+        this.hasLoaded = true;
+        if (process.env.NODE_ENV === "development") {
+          console.log(
+            `\u26A1 NexusHub: Serving content from local cache (${this.cachePath})`
+          );
+          console.log(`   - Pages: ${_optionalChain([this, 'access', _ => _.data, 'access', _2 => _2.pages, 'optionalAccess', _3 => _3.length]) || 0}`);
+          console.log(
+            `   - Collections: ${Object.keys(this.data.collections || {}).length}`
+          );
+          console.log(
+            `   - Globals: ${this.data.globals ? "Loaded" : "Not found"}`
+          );
+        }
+      }
+    } catch (error) {
+      if (this.shouldWarnAboutMissingCache(error)) {
+        console.warn(
+          `\u26A0\uFE0F NexusHub: Local cache invalid at ${this.cachePath}
+   Run \`npx nexus pull\` to fix your seed data.`
+        );
+      }
+    }
+  }
+  /**
+   * Retrieve a specific page from the local pages array.
+   */
+  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);
+    if (!page) {
+      if (process.env.NODE_ENV === "development") {
+        console.warn(`\u26A0\uFE0F NexusHub: Page '${slug}' not found in local cache.`);
+      }
+      return null;
+    }
+    return page.data;
+  }
+  /**
+   * Retrieve an entire collection from the local collections map.
+   */
+  async getCollection(collectionId) {
+    this.load();
+    if (!_optionalChain([this, 'access', _6 => _6.data, 'optionalAccess', _7 => _7.collections])) return null;
+    const collection = this.data.collections[collectionId];
+    if (!collection) {
+      if (process.env.NODE_ENV === "development") {
+        console.warn(
+          `\u26A0\uFE0F NexusHub: Collection '${collectionId}' not found in local cache.`
+        );
+      }
+      return null;
+    }
+    return collection;
+  }
+  /**
+   * Retrieve global settings from the local cache.
+   */
+  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.
+   */
+  async getAllData() {
+    this.load();
+    return this.data;
+  }
+  /**
+   * Helper to determine if we should bother the user with a warning.
+   */
+  shouldWarnAboutMissingCache(error) {
+    const isMissing = error.code === "ENOENT";
+    const isMalformed = error instanceof SyntaxError;
+    if (process.env.NODE_ENV !== "development") return false;
+    return !isMissing || isMalformed;
+  }
+};
 
-var chunk2JRYABGG_cjs = require('../chunk-2JRYABGG.cjs');
 
-
-
-Object.defineProperty(exports, "LocalCache", {
-  enumerable: true,
-  get: function () { return chunk2JRYABGG_cjs.LocalCache; }
-});
+exports.LocalCache = LocalCache;

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

@@ -1,4 +1,6 @@
-declare class LocalCache {
+import { I as ILocalCache } from '../cache-types-B39iNHfE.cjs';
+
+declare class LocalCache implements ILocalCache {
     private data;
     private hasLoaded;
     private cachePath;
@@ -16,19 +18,19 @@ declare class LocalCache {
     /**
      * 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,6 @@
-declare class LocalCache {
+import { I as ILocalCache } from '../cache-types-B39iNHfE.js';
+
+declare class LocalCache implements ILocalCache {
     private data;
     private hasLoaded;
     private cachePath;
@@ -16,19 +18,19 @@ declare class LocalCache {
     /**
      * 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 +1,110 @@
-export { LocalCache } from '../chunk-BPQMAYT3.js';
+// src/content/local-cache-server.ts
+import fs from "fs";
+import path from "path";
+var LocalCache = class {
+  constructor(customPath) {
+    this.data = null;
+    this.hasLoaded = false;
+    this.cachePath = customPath || ".nexus/cache.json";
+  }
+  /**
+   * Returns true if the local cache file has been successfully
+   * loaded and parsed into memory.
+   */
+  isLoaded() {
+    return this.hasLoaded;
+  }
+  /**
+   * Reads the cache file from the filesystem.
+   * Internal method called lazily by the getters.
+   */
+  load() {
+    if (typeof window !== "undefined") return;
+    if (this.hasLoaded) return;
+    try {
+      const fullPath = path.resolve(process.cwd(), this.cachePath);
+      if (fs.existsSync(fullPath)) {
+        const fileContent = fs.readFileSync(fullPath, "utf-8");
+        this.data = JSON.parse(fileContent);
+        this.hasLoaded = true;
+        if (process.env.NODE_ENV === "development") {
+          console.log(
+            `\u26A1 NexusHub: Serving content from local cache (${this.cachePath})`
+          );
+          console.log(`   - Pages: ${this.data.pages?.length || 0}`);
+          console.log(
+            `   - Collections: ${Object.keys(this.data.collections || {}).length}`
+          );
+          console.log(
+            `   - Globals: ${this.data.globals ? "Loaded" : "Not found"}`
+          );
+        }
+      }
+    } catch (error) {
+      if (this.shouldWarnAboutMissingCache(error)) {
+        console.warn(
+          `\u26A0\uFE0F NexusHub: Local cache invalid at ${this.cachePath}
+   Run \`npx nexus pull\` to fix your seed data.`
+        );
+      }
+    }
+  }
+  /**
+   * Retrieve a specific page from the local pages array.
+   */
+  async getPage(slug) {
+    this.load();
+    if (!this.data?.pages) return null;
+    const page = this.data.pages.find((p) => p.slug === slug);
+    if (!page) {
+      if (process.env.NODE_ENV === "development") {
+        console.warn(`\u26A0\uFE0F NexusHub: Page '${slug}' not found in local cache.`);
+      }
+      return null;
+    }
+    return page.data;
+  }
+  /**
+   * Retrieve an entire collection from the local collections map.
+   */
+  async getCollection(collectionId) {
+    this.load();
+    if (!this.data?.collections) return null;
+    const collection = this.data.collections[collectionId];
+    if (!collection) {
+      if (process.env.NODE_ENV === "development") {
+        console.warn(
+          `\u26A0\uFE0F NexusHub: Collection '${collectionId}' not found in local cache.`
+        );
+      }
+      return null;
+    }
+    return collection;
+  }
+  /**
+   * Retrieve global settings from the local cache.
+   */
+  async getGlobals() {
+    this.load();
+    return this.data?.globals || null;
+  }
+  /**
+   * Returns the entire raw JSON data structure from the cache file.
+   */
+  async getAllData() {
+    this.load();
+    return this.data;
+  }
+  /**
+   * Helper to determine if we should bother the user with a warning.
+   */
+  shouldWarnAboutMissingCache(error) {
+    const isMissing = error.code === "ENOENT";
+    const isMalformed = error instanceof SyntaxError;
+    if (process.env.NODE_ENV !== "development") return false;
+    return !isMissing || isMalformed;
+  }
+};
+export {
+  LocalCache
+};