@nexushub/client 0.0.6 → 0.0.7

package/dist/chunk-2JRYABGG.cjs

@@ -0,0 +1,117 @@
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var fs__default = /*#__PURE__*/_interopDefault(fs);
+var path__default = /*#__PURE__*/_interopDefault(path);
+
+// src/content/local-cache-server.ts
+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__default.default.resolve(process.cwd(), this.cachePath);
+      if (fs__default.default.existsSync(fullPath)) {
+        const fileContent = fs__default.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: ${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 not found or invalid at ${this.cachePath}
+   Run \`npx nexus pull\` to generate seed data if you want to work offline.`
+        );
+      }
+    }
+  }
+  /**
+   * Retrieve a specific page from the local pages array.
+   */
+  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.
+   */
+  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.
+   */
+  getGlobals() {
+    this.load();
+    return this.data?.globals || null;
+  }
+  /**
+   * Returns the entire raw JSON data structure from the cache file.
+   */
+  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;
+  }
+};
+
+exports.LocalCache = LocalCache;

package/dist/chunk-BPQMAYT3.js

@@ -0,0 +1,110 @@
+import fs from 'fs';
+import path from 'path';
+
+// src/content/local-cache-server.ts
+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 not found or invalid at ${this.cachePath}
+   Run \`npx nexus pull\` to generate seed data if you want to work offline.`
+        );
+      }
+    }
+  }
+  /**
+   * Retrieve a specific page from the local pages array.
+   */
+  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.
+   */
+  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.
+   */
+  getGlobals() {
+    this.load();
+    return this.data?.globals || null;
+  }
+  /**
+   * Returns the entire raw JSON data structure from the cache file.
+   */
+  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 };

package/dist/{tools/cli.js → cli.cjs}

@@ -25,12 +25,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // tools/cli.ts
 var import_commander = require("commander");
-var fs = __toESM(require("fs-extra"));
-var import_path = __toESM(require("path"));
-var import_node_fetch = __toESM(require("node-fetch"));
-var import_dotenv = __toESM(require("dotenv"));
-var import_chalk = __toESM(require("chalk"));
-var import_ora = __toESM(require("ora"));
+var fs = __toESM(require("fs-extra"), 1);
+var import_path = __toESM(require("path"), 1);
+var import_node_fetch = __toESM(require("node-fetch"), 1);
+var import_dotenv = __toESM(require("dotenv"), 1);
+var import_chalk = __toESM(require("chalk"), 1);
+var import_ora = __toESM(require("ora"), 1);
 import_dotenv.default.config({ path: import_path.default.resolve(process.cwd(), ".env.local") });
 import_dotenv.default.config({ path: import_path.default.resolve(process.cwd(), ".env") });
 var program = new import_commander.Command();
@@ -612,6 +612,12 @@ async function generateTypes(options) {
 `;
     }
     typeDefs += `}
+`;
+    typeDefs += `/**
+ * Helper type to get the type of a specific collection by its slug
+ */
+`;
+    typeDefs += `export type NexusContent<T extends keyof NexusCollections> = NexusCollections[T];
 `;
     const outputPath = import_path.default.resolve(process.cwd(), options.output);
     await fs.writeFile(outputPath, typeDefs);

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

@@ -0,0 +1,56 @@
+'use strict';
+
+// src/content/local-cache-client.ts
+var LocalCache = class {
+  constructor(customPath) {
+    this.data = null;
+    this.hasLoaded = false;
+    this.cachePath = customPath || ".nexus/cache.json";
+  }
+  /**
+   * Always returns false in the browser as local file caching
+   * is a server-side only feature.
+   */
+  isLoaded() {
+    return false;
+  }
+  /**
+   * No-op method to maintain API compatibility with the Node version.
+   */
+  load() {
+    return;
+  }
+  /**
+   * Returns null. Browsers should fetch pages from the Remote API
+   * or the Memory/Browser cache.
+   */
+  getPage(_slug) {
+    return null;
+  }
+  /**
+   * Returns null. Browsers should fetch collections from the Remote API.
+   */
+  getCollection(_collectionId) {
+    return null;
+  }
+  /**
+   * Returns null.
+   */
+  getGlobals() {
+    return null;
+  }
+  /**
+   * Returns null.
+   */
+  getAllData() {
+    return null;
+  }
+  /**
+   * Dummy helper to match Node implementation.
+   */
+  shouldWarnAboutMissingCache(_error) {
+    return false;
+  }
+};
+
+exports.LocalCache = LocalCache;

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

@@ -0,0 +1,48 @@
+/**
+ * NexusHub LocalCache (Browser Implementation)
+ *
+ * This is a dummy implementation used when the SDK is bundled for the browser.
+ * 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
+ * automatically by the bundler via the "browser" field in package.json.
+ */
+declare class LocalCache {
+    private data;
+    private hasLoaded;
+    private cachePath;
+    constructor(customPath?: string);
+    /**
+     * Always returns false in the browser as local file caching
+     * is a server-side only feature.
+     */
+    isLoaded(): boolean;
+    /**
+     * No-op method to maintain API compatibility with the Node version.
+     */
+    private load;
+    /**
+     * Returns null. Browsers should fetch pages from the Remote API
+     * or the Memory/Browser cache.
+     */
+    getPage(_slug: string): any;
+    /**
+     * Returns null. Browsers should fetch collections from the Remote API.
+     */
+    getCollection(_collectionId: string): any[] | null;
+    /**
+     * Returns null.
+     */
+    getGlobals(): any;
+    /**
+     * Returns null.
+     */
+    getAllData(): any;
+    /**
+     * Dummy helper to match Node implementation.
+     */
+    private shouldWarnAboutMissingCache;
+}
+
+export { LocalCache };

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

@@ -0,0 +1,48 @@
+/**
+ * NexusHub LocalCache (Browser Implementation)
+ *
+ * This is a dummy implementation used when the SDK is bundled for the browser.
+ * 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
+ * automatically by the bundler via the "browser" field in package.json.
+ */
+declare class LocalCache {
+    private data;
+    private hasLoaded;
+    private cachePath;
+    constructor(customPath?: string);
+    /**
+     * Always returns false in the browser as local file caching
+     * is a server-side only feature.
+     */
+    isLoaded(): boolean;
+    /**
+     * No-op method to maintain API compatibility with the Node version.
+     */
+    private load;
+    /**
+     * Returns null. Browsers should fetch pages from the Remote API
+     * or the Memory/Browser cache.
+     */
+    getPage(_slug: string): any;
+    /**
+     * Returns null. Browsers should fetch collections from the Remote API.
+     */
+    getCollection(_collectionId: string): any[] | null;
+    /**
+     * Returns null.
+     */
+    getGlobals(): any;
+    /**
+     * Returns null.
+     */
+    getAllData(): any;
+    /**
+     * Dummy helper to match Node implementation.
+     */
+    private shouldWarnAboutMissingCache;
+}
+
+export { LocalCache };

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

@@ -0,0 +1,54 @@
+// src/content/local-cache-client.ts
+var LocalCache = class {
+  constructor(customPath) {
+    this.data = null;
+    this.hasLoaded = false;
+    this.cachePath = customPath || ".nexus/cache.json";
+  }
+  /**
+   * Always returns false in the browser as local file caching
+   * is a server-side only feature.
+   */
+  isLoaded() {
+    return false;
+  }
+  /**
+   * No-op method to maintain API compatibility with the Node version.
+   */
+  load() {
+    return;
+  }
+  /**
+   * Returns null. Browsers should fetch pages from the Remote API
+   * or the Memory/Browser cache.
+   */
+  getPage(_slug) {
+    return null;
+  }
+  /**
+   * Returns null. Browsers should fetch collections from the Remote API.
+   */
+  getCollection(_collectionId) {
+    return null;
+  }
+  /**
+   * Returns null.
+   */
+  getGlobals() {
+    return null;
+  }
+  /**
+   * Returns null.
+   */
+  getAllData() {
+    return null;
+  }
+  /**
+   * Dummy helper to match Node implementation.
+   */
+  shouldWarnAboutMissingCache(_error) {
+    return false;
+  }
+};
+
+export { LocalCache };

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

@@ -0,0 +1,10 @@
+'use strict';
+
+var chunk2JRYABGG_cjs = require('../chunk-2JRYABGG.cjs');
+
+
+
+Object.defineProperty(exports, "LocalCache", {
+  enumerable: true,
+  get: function () { return chunk2JRYABGG_cjs.LocalCache; }
+});

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

@@ -0,0 +1,38 @@
+declare class LocalCache {
+    private data;
+    private hasLoaded;
+    private cachePath;
+    constructor(customPath?: string);
+    /**
+     * Returns true if the local cache file has been successfully
+     * loaded and parsed into memory.
+     */
+    isLoaded(): boolean;
+    /**
+     * Reads the cache file from the filesystem.
+     * Internal method called lazily by the getters.
+     */
+    private load;
+    /**
+     * Retrieve a specific page from the local pages array.
+     */
+    getPage(slug: string): any;
+    /**
+     * Retrieve an entire collection from the local collections map.
+     */
+    getCollection(collectionId: string): any[] | null;
+    /**
+     * Retrieve global settings from the local cache.
+     */
+    getGlobals(): any;
+    /**
+     * Returns the entire raw JSON data structure from the cache file.
+     */
+    getAllData(): any;
+    /**
+     * Helper to determine if we should bother the user with a warning.
+     */
+    private shouldWarnAboutMissingCache;
+}
+
+export { LocalCache };

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

@@ -0,0 +1,38 @@
+declare class LocalCache {
+    private data;
+    private hasLoaded;
+    private cachePath;
+    constructor(customPath?: string);
+    /**
+     * Returns true if the local cache file has been successfully
+     * loaded and parsed into memory.
+     */
+    isLoaded(): boolean;
+    /**
+     * Reads the cache file from the filesystem.
+     * Internal method called lazily by the getters.
+     */
+    private load;
+    /**
+     * Retrieve a specific page from the local pages array.
+     */
+    getPage(slug: string): any;
+    /**
+     * Retrieve an entire collection from the local collections map.
+     */
+    getCollection(collectionId: string): any[] | null;
+    /**
+     * Retrieve global settings from the local cache.
+     */
+    getGlobals(): any;
+    /**
+     * Returns the entire raw JSON data structure from the cache file.
+     */
+    getAllData(): any;
+    /**
+     * Helper to determine if we should bother the user with a warning.
+     */
+    private shouldWarnAboutMissingCache;
+}
+
+export { LocalCache };

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

@@ -0,0 +1 @@
+export { LocalCache } from '../chunk-BPQMAYT3.js';