@chiselandco/nexus 2.2.6

package/dist/ProjectMenu.d.ts

@@ -0,0 +1,79 @@
+import type { Project, CustomFieldSchema } from "./types";
+export interface ProjectMenuProps {
+    /** Client slug used to fetch projects */
+    clientSlug: string;
+    /** API base URL e.g. "https://nexus.chiselandco.com" */
+    apiBase: string;
+    /**
+     * Optional menu ID to fetch a specific curated menu instead of all projects.
+     * When provided, fetches from /api/v1/clients/{clientSlug}/menus/{menuId}
+     */
+    menuId?: string;
+    /** Base path for project detail links. Defaults to "/projects" */
+    basePath?: string;
+    /** Path for the "View All" link. Defaults to basePath */
+    viewAllPath?: string;
+    /** Optional subtitle paragraph shown above the project cards */
+    subtitle?: string;
+    /** Font family string passed to all inline styles */
+    font?: string;
+    /** Max number of projects to show at once. Defaults to 6 */
+    maxProjects?: number;
+    /** Revalidation period in seconds. Defaults to 86400 (24 hours) */
+    revalidate?: number;
+    /**
+     * Disable all caching. Every request hits the API fresh.
+     * Useful for debugging — do not use in production.
+     */
+    noCache?: boolean;
+}
+/**
+ * createMenuHandler
+ *
+ * Creates a Next.js route handler that fetches and server-caches the menu data.
+ * Drop it into app/api/chisel-menu/route.ts — one line of setup.
+ *
+ * Features:
+ * - Cached for 24 hours by default (override with revalidate option)
+ * - Add ?bust=1 to bypass the cache for a single request (dev/testing)
+ * - Set CHISEL_CACHE_BYPASS=true in env to disable caching for the whole deployment (staging)
+ * - Fetch is tagged with "chisel-menu-{clientSlug}" for revalidateTag() support
+ *
+ * @example
+ * // app/api/chisel-menu/route.ts
+ * import { createMenuHandler } from "project-portfolio"
+ * export const GET = createMenuHandler({ clientSlug: "my-client", apiBase: "https://nexus.chiselandco.com" })
+ *
+ * // Bust the cache manually (one request):
+ * fetch("/api/chisel-menu?bust=1")
+ *
+ * // Invalidate from a CMS webhook:
+ * import { revalidateTag } from "next/cache"
+ * revalidateTag("chisel-menu-my-client")
+ */
+export declare function createMenuHandler({ clientSlug, apiBase, menuId, revalidate, }: {
+    clientSlug: string;
+    apiBase: string;
+    /** Optional menu ID to fetch a specific curated menu instead of all projects */
+    menuId?: string;
+    revalidate?: number;
+}): (request: Request) => Promise<Response>;
+export declare function fetchProjectMenuData({ apiBase, clientSlug, menuId, revalidate, noCache, }: {
+    apiBase: string;
+    clientSlug: string;
+    menuId?: string;
+    revalidate?: number;
+    noCache?: boolean;
+}): Promise<{
+    projects: Project[];
+    schema: CustomFieldSchema[];
+    filterOptions: {
+        id: string;
+        label: string;
+    }[];
+    filterFieldKey: string | null;
+    filterFieldName: string;
+    fieldOptionsMap: Record<string, Record<string, string>>;
+}>;
+export declare function ProjectMenu({ clientSlug, apiBase, menuId, basePath, viewAllPath, subtitle, font, maxProjects, revalidate, noCache, }: ProjectMenuProps): Promise<import("react/jsx-runtime").JSX.Element>;
+//# sourceMappingURL=ProjectMenu.d.ts.map

package/dist/ProjectMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectMenu.d.ts","sourceRoot":"","sources":["../src/ProjectMenu.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAKzD,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,UAAU,EACV,OAAO,EACP,MAAM,EACN,UAAkB,GACnB,EAAE;IACD,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,aACoC,OAAO,uBAmE3C;AAED,wBAAsB,oBAAoB,CAAC,EACzC,OAAO,EACP,UAAU,EACV,MAAM,EACN,UAAkB,EAClB,OAAe,GAChB,EAAE;IACD,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,GAAG,OAAO,CAAC;IACV,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,MAAM,EAAE,iBAAiB,EAAE,CAAA;IAC3B,aAAa,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC9C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACxD,CAAC,CAqBD;AA0DD,wBAAsB,WAAW,CAAC,EAChC,UAAU,EACV,OAAO,EACP,MAAM,EACN,QAAsB,EACtB,WAAW,EACX,QAAQ,EACR,IAA0E,EAC1E,WAAe,EACf,UAAkB,EAClB,OAAe,GAChB,EAAE,gBAAgB,oDAiClB"}

package/dist/ProjectMenu.js

@@ -0,0 +1,170 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cache } from "react";
+import { ProjectMenuClient } from "./ProjectMenuClient";
+const API_KEY = "pk_live_crmsuTIm7NNfb9uEWBCyv88F6kj2YQUR";
+/**
+ * createMenuHandler
+ *
+ * Creates a Next.js route handler that fetches and server-caches the menu data.
+ * Drop it into app/api/chisel-menu/route.ts — one line of setup.
+ *
+ * Features:
+ * - Cached for 24 hours by default (override with revalidate option)
+ * - Add ?bust=1 to bypass the cache for a single request (dev/testing)
+ * - Set CHISEL_CACHE_BYPASS=true in env to disable caching for the whole deployment (staging)
+ * - Fetch is tagged with "chisel-menu-{clientSlug}" for revalidateTag() support
+ *
+ * @example
+ * // app/api/chisel-menu/route.ts
+ * import { createMenuHandler } from "project-portfolio"
+ * export const GET = createMenuHandler({ clientSlug: "my-client", apiBase: "https://nexus.chiselandco.com" })
+ *
+ * // Bust the cache manually (one request):
+ * fetch("/api/chisel-menu?bust=1")
+ *
+ * // Invalidate from a CMS webhook:
+ * import { revalidateTag } from "next/cache"
+ * revalidateTag("chisel-menu-my-client")
+ */
+export function createMenuHandler({ clientSlug, apiBase, menuId, revalidate = 86400, }) {
+    return async function GET(request) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        const bypass = process.env.CHISEL_CACHE_BYPASS === "true" ||
+            new URL(request.url).searchParams.has("bust");
+        const cacheTag = menuId ? `chisel-menu-${clientSlug}-${menuId}` : `chisel-menu-${clientSlug}`;
+        const fetchOpts = bypass
+            ? { cache: "no-store" }
+            : { next: { revalidate, tags: [cacheTag] } };
+        try {
+            // /projects always returns schema + options. Use it in both cases.
+            // When menuId provided: 2 calls — /menus/{slug} for projects, /projects for schema.
+            // Without menuId: 1 call — /projects for everything.
+            const fetches = menuId
+                ? [
+                    fetch(`${apiBase}/api/v1/clients/${clientSlug}/menus/${menuId}?api_key=${API_KEY}`, fetchOpts),
+                    fetch(`${apiBase}/api/v1/clients/${clientSlug}/projects?api_key=${API_KEY}`, fetchOpts),
+                ]
+                : [fetch(`${apiBase}/api/v1/clients/${clientSlug}/projects?api_key=${API_KEY}`, fetchOpts)];
+            const [primaryRes, schemaRes] = await Promise.all(fetches);
+            const primaryJson = primaryRes.ok ? await primaryRes.json() : {};
+            const schemaJson = schemaRes ? (schemaRes.ok ? await schemaRes.json() : {}) : primaryJson;
+            const rawProjects = menuId
+                ? ((_a = primaryJson.projects) !== null && _a !== void 0 ? _a : [])
+                : ((_b = primaryJson.data) !== null && _b !== void 0 ? _b : []);
+            const projects = rawProjects.filter((p) => p.is_published !== false);
+            const schema = (_d = (_c = schemaJson === null || schemaJson === void 0 ? void 0 : schemaJson.client) === null || _c === void 0 ? void 0 : _c.custom_fields_schema) !== null && _d !== void 0 ? _d : [];
+            const fieldOptionsMap = {};
+            for (const field of schema) {
+                const map = {};
+                for (const opt of ((_e = field.options) !== null && _e !== void 0 ? _e : [])) {
+                    if (typeof opt === "object" && opt.id && opt.label) {
+                        map[opt.id] = opt.label;
+                        map[opt.label] = opt.label;
+                    }
+                }
+                fieldOptionsMap[field.key] = map;
+            }
+            const filterField = (_f = schema.find((f) => f.is_filterable && (f.type === "select" || f.type === "multi-select"))) !== null && _f !== void 0 ? _f : null;
+            const filterOptions = filterField
+                ? ((_g = filterField.options) !== null && _g !== void 0 ? _g : []).map((opt) => {
+                    var _a, _b;
+                    if (typeof opt === "string")
+                        return { id: opt.toLowerCase().replace(/\s+/g, "-"), label: opt };
+                    return { id: (_a = opt.id) !== null && _a !== void 0 ? _a : "", label: (_b = opt.label) !== null && _b !== void 0 ? _b : "" };
+                })
+                : [];
+            return Response.json({
+                projects,
+                schema,
+                filterOptions,
+                filterFieldKey: (_h = filterField === null || filterField === void 0 ? void 0 : filterField.key) !== null && _h !== void 0 ? _h : null,
+                filterFieldName: (_j = filterField === null || filterField === void 0 ? void 0 : filterField.name) !== null && _j !== void 0 ? _j : "Project Type",
+                fieldOptionsMap,
+            });
+        }
+        catch (_k) {
+            return Response.json({ projects: [], schema: [], filterOptions: [], filterFieldKey: null, filterFieldName: "Project Type", fieldOptionsMap: {} }, { status: 500 });
+        }
+    };
+}
+export async function fetchProjectMenuData({ apiBase, clientSlug, menuId, revalidate = 86400, noCache = false, }) {
+    var _a, _b, _c, _d;
+    const raw = await _fetchMenuData(apiBase, clientSlug, menuId, revalidate, noCache);
+    const filterField = (_a = raw.schema.find((f) => f.is_filterable && (f.type === "select" || f.type === "multi-select"))) !== null && _a !== void 0 ? _a : null;
+    const filterOptions = filterField
+        ? ((_b = filterField.options) !== null && _b !== void 0 ? _b : []).map((opt) => {
+            var _a, _b, _c;
+            if (typeof opt === "string") {
+                return { id: opt.toLowerCase().replace(/\s+/g, "-"), label: opt };
+            }
+            return { id: (_a = opt.id) !== null && _a !== void 0 ? _a : String((_b = opt.label) !== null && _b !== void 0 ? _b : "").toLowerCase().replace(/\s+/g, "-"), label: (_c = opt.label) !== null && _c !== void 0 ? _c : "" };
+        })
+        : [];
+    return {
+        projects: raw.projects,
+        schema: raw.schema,
+        filterOptions,
+        filterFieldKey: (_c = filterField === null || filterField === void 0 ? void 0 : filterField.key) !== null && _c !== void 0 ? _c : null,
+        filterFieldName: (_d = filterField === null || filterField === void 0 ? void 0 : filterField.name) !== null && _d !== void 0 ? _d : "Project Type",
+        fieldOptionsMap: raw.fieldOptionsMap,
+    };
+}
+const _fetchMenuData = cache(async (apiBase, clientSlug, menuId, revalidate, noCache = false) => {
+    var _a, _b, _c, _d, _e;
+    const fetchOpts = noCache
+        ? { cache: "no-store" }
+        : { next: { revalidate } };
+    try {
+        // /projects always returns schema + options. Use it in both cases.
+        // When menuId provided: 2 calls — /menus/{slug} for projects, /projects for schema.
+        // Without menuId: 1 call — /projects for everything.
+        const fetches = menuId
+            ? [
+                fetch(`${apiBase}/api/v1/clients/${clientSlug}/menus/${menuId}?api_key=${API_KEY}`, fetchOpts),
+                fetch(`${apiBase}/api/v1/clients/${clientSlug}/projects?api_key=${API_KEY}`, fetchOpts),
+            ]
+            : [fetch(`${apiBase}/api/v1/clients/${clientSlug}/projects?api_key=${API_KEY}`, fetchOpts)];
+        const [primaryRes, schemaRes] = await Promise.all(fetches);
+        if (!primaryRes.ok)
+            return { projects: [], schema: [], fieldOptionsMap: {} };
+        const primaryJson = await primaryRes.json();
+        const schemaJson = schemaRes ? (schemaRes.ok ? await schemaRes.json() : {}) : primaryJson;
+        const rawProjects = menuId
+            ? ((_a = primaryJson.projects) !== null && _a !== void 0 ? _a : [])
+            : ((_b = primaryJson.data) !== null && _b !== void 0 ? _b : []);
+        const projects = rawProjects.filter((p) => p.is_published !== false);
+        const schema = (_d = (_c = schemaJson === null || schemaJson === void 0 ? void 0 : schemaJson.client) === null || _c === void 0 ? void 0 : _c.custom_fields_schema) !== null && _d !== void 0 ? _d : [];
+        const fieldOptionsMap = {};
+        for (const field of schema) {
+            const map = {};
+            for (const opt of ((_e = field.options) !== null && _e !== void 0 ? _e : [])) {
+                if (typeof opt === "object" && opt.id && opt.label) {
+                    map[opt.id] = opt.label;
+                    map[opt.label] = opt.label;
+                }
+            }
+            fieldOptionsMap[field.key] = map;
+        }
+        return { projects, schema, fieldOptionsMap };
+    }
+    catch (_f) {
+        return { projects: [], schema: [], fieldOptionsMap: {} };
+    }
+});
+export async function ProjectMenu({ clientSlug, apiBase, menuId, basePath = "/projects", viewAllPath, subtitle, font = "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif", maxProjects = 6, revalidate = 86400, noCache = false, }) {
+    var _a, _b, _c, _d;
+    const { projects, schema, fieldOptionsMap } = await _fetchMenuData(apiBase, clientSlug, menuId, revalidate, noCache);
+    // Find the filterable select field (badge_overlay is our category field)
+    const filterField = (_a = schema.find((f) => f.is_filterable && (f.type === "select" || f.type === "multi-select"))) !== null && _a !== void 0 ? _a : null;
+    // Build filter option list from schema
+    const filterOptions = filterField
+        ? ((_b = filterField.options) !== null && _b !== void 0 ? _b : []).map((opt) => {
+            var _a, _b, _c;
+            if (typeof opt === "string") {
+                return { id: opt.toLowerCase().replace(/\s+/g, "-"), label: opt };
+            }
+            return { id: (_a = opt.id) !== null && _a !== void 0 ? _a : String((_b = opt.label) !== null && _b !== void 0 ? _b : "").toLowerCase().replace(/\s+/g, "-"), label: (_c = opt.label) !== null && _c !== void 0 ? _c : "" };
+        })
+        : [];
+    return (_jsx(ProjectMenuClient, { projects: projects, schema: schema, filterOptions: filterOptions, filterFieldKey: (_c = filterField === null || filterField === void 0 ? void 0 : filterField.key) !== null && _c !== void 0 ? _c : null, filterFieldName: (_d = filterField === null || filterField === void 0 ? void 0 : filterField.name) !== null && _d !== void 0 ? _d : "Project Type", fieldOptionsMap: fieldOptionsMap, subtitle: subtitle, basePath: basePath, viewAllPath: viewAllPath !== null && viewAllPath !== void 0 ? viewAllPath : basePath, font: font, maxProjects: maxProjects }));
+}

package/dist/ProjectMenuClient.d.ts

@@ -0,0 +1,44 @@
+import type { Project, CustomFieldSchema } from "./types";
+export interface ProjectMenuClientProps {
+    /**
+     * URL of a local API route created with createMenuHandler().
+     * Recommended for production — data is server-cached for 24h and never
+     * exposes the upstream API key to the browser.
+     * e.g. dataUrl="/api/chisel-menu"
+     */
+    dataUrl?: string;
+    /**
+     * Pass clientSlug + apiBase to have the component fetch its own data directly.
+     * Use this for quick setup or non-Next.js environments.
+     * For production Next.js apps, prefer dataUrl + createMenuHandler instead.
+     */
+    clientSlug?: string;
+    apiBase?: string;
+    /**
+     * Optional menu slug to fetch a specific curated menu instead of all projects.
+     * When provided, fetches from /api/v1/clients/{clientSlug}/menus/{slug}
+     */
+    menuId?: string;
+    /**
+     * When true, bypasses the module-level data cache and always fetches fresh data.
+     * Also sets fetch cache to "no-store" on all underlying requests.
+     * Useful during development or when projects update frequently.
+     */
+    noCache?: boolean;
+    projects?: Project[];
+    schema?: CustomFieldSchema[];
+    filterOptions?: {
+        id: string;
+        label: string;
+    }[];
+    filterFieldKey?: string | null;
+    filterFieldName?: string;
+    fieldOptionsMap?: Record<string, Record<string, string>>;
+    subtitle?: string;
+    basePath: string;
+    viewAllPath: string;
+    font?: string;
+    maxProjects?: number;
+}
+export declare function ProjectMenuClient({ dataUrl, clientSlug, apiBase, menuId, noCache, projects: projectsProp, schema: schemaProp, filterOptions: filterOptionsProp, filterFieldKey: filterFieldKeyProp, filterFieldName: filterFieldNameProp, fieldOptionsMap: fieldOptionsMapProp, subtitle, basePath, viewAllPath, font, maxProjects, }: ProjectMenuClientProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ProjectMenuClient.d.ts.map

package/dist/ProjectMenuClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectMenuClient.d.ts","sourceRoot":"","sources":["../src/ProjectMenuClient.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAoB,MAAM,SAAS,CAAA;AAa3E,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IACpB,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC5B,aAAa,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC/C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAmBD,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,UAAU,EACV,OAAO,EACP,MAAM,EACN,OAAe,EACf,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,iBAAiB,EAChC,cAAc,EAAE,kBAAkB,EAClC,eAAe,EAAE,mBAAoC,EACrD,eAAe,EAAE,mBAAwB,EACzC,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,IAAmB,EACnB,WAAe,GAChB,EAAE,sBAAsB,2CAqfxB"}