@mints-cloud/cxf-codegen 1.0.0

package/README.md

@@ -0,0 +1,117 @@
+# cxf-codegen
+
+Plasmic + CXF integration library for Next.js projects. Provides API call components, server-side rendering helpers, and authentication utilities.
+
+## Installation
+
+```bash
+npm install cxf-codegen
+```
+
+## Setup
+
+Your project needs thin wrapper files that import from this library. The `create-plasmic-app` CLI generates these automatically, but you can also create them manually:
+
+### `pages/_app.tsx`
+
+```tsx
+import "cxf-codegen/register";
+export { default } from "cxf-codegen/pages/app";
+```
+
+### `pages/api/[...path].ts`
+
+```ts
+export { default } from "cxf-codegen/pages/api/cxf";
+```
+
+### `pages/api/assets/[...path].ts`
+
+```ts
+export { default } from "cxf-codegen/pages/api/assets";
+```
+
+### `pages/plasmic-host.tsx`
+
+```tsx
+import "cxf-codegen/register";
+export { default } from "cxf-codegen/pages/plasmic-host";
+```
+
+### `next.config.mjs`
+
+```js
+import { cxfNextConfig } from "cxf-codegen";
+export default cxfNextConfig;
+```
+
+## Environment Variables
+
+Set these in your `.env` file:
+
+```
+CXF_BASE_URL=https://your-cxf-instance.com
+CXF_API_KEY=your-public-api-key
+```
+
+Optional:
+
+```
+CXF_DEV_API_KEY=your-dev-api-key
+CXF_USER_API_KEY=your-user-api-key
+```
+
+## Usage
+
+### ApiCall Component
+
+In Plasmic, use the `ApiCall` component to fetch data:
+
+- **apiType**: `endpoint`, `contact`, `dev`, or `user`
+- **path**: API path (e.g., `me`, `blog-posts`)
+- **method**: HTTP method
+- **params**: Query parameters
+- **body**: Request body (for POST/PATCH/PUT/DELETE)
+
+Data is available via `$ctx.response.*`:
+- `$ctx.response.data` - The response data
+- `$ctx.response.error` - Error message if failed
+- `$ctx.response.loading` - Loading state
+- `$ctx.response.success` - Boolean for success
+- `$ctx.response.failed` - Boolean for failure
+
+### Server-Side Rendering (ISR/SSR)
+
+Use `createServerProps` for pages that need pre-fetched data:
+
+```tsx
+import { ServerPageWrapper, createServerProps, ServerPageProps } from "cxf-codegen";
+import { PlasmicHomepage } from "../components/plasmic/Homepage";
+
+function Homepage(props: ServerPageProps) {
+  return (
+    <ServerPageWrapper {...props}>
+      <PlasmicHomepage />
+    </ServerPageWrapper>
+  );
+}
+
+export default Homepage;
+
+// ISR (default)
+export const { getStaticProps } = createServerProps("/", PlasmicHomepage);
+
+// Or SSR for authenticated pages
+export const { getServerSideProps } = createServerProps("/profile", PlasmicProfile, {
+  mode: "ssr"
+});
+```
+
+## Updating
+
+To update the library across all your projects:
+
+```bash
+npm update cxf-codegen
+```
+

package/dist/components/ApiCall.d.ts

@@ -0,0 +1,19 @@
+import * as React from "react";
+export type ApiType = "endpoint" | "contact" | "dev" | "user";
+export interface ApiCallProps {
+    apiType?: ApiType;
+    path: string;
+    method?: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+    params?: Record<string, any>;
+    body?: Record<string, any>;
+    initialData?: any;
+    autoFetch?: boolean;
+    trigger?: number;
+    onSuccess?: (data: any) => void;
+    onError?: (error: string) => void;
+    loadingContent?: React.ReactNode;
+    children?: React.ReactNode;
+}
+export declare function ApiCall(props: ApiCallProps): import("react/jsx-runtime").JSX.Element | null;
+export default ApiCall;
+//# sourceMappingURL=ApiCall.d.ts.map

package/dist/components/ApiCall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiCall.d.ts","sourceRoot":"","sources":["../../src/components/ApiCall.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,cAAc,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAsBD,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,kDAqD1C;AAED,eAAe,OAAO,CAAC"}

package/dist/components/ApiCall.js

@@ -0,0 +1,92 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiCall = ApiCall;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const React = __importStar(require("react"));
+const host_1 = require("@plasmicapp/host");
+const api_call_hooks_1 = require("../lib/api-call-hooks");
+function trimSlashes(p) {
+    return String(p || "").replace(/^\/+|\/+$/g, "");
+}
+function buildEndpointPath(apiType, rawPath) {
+    const clean = trimSlashes(rawPath);
+    switch (apiType) {
+        case "endpoint":
+            return `v1/endpoints/${clean}`;
+        case "contact":
+            return `v1/${clean}`;
+        case "dev":
+            return `dev/v1/${clean}`;
+        case "user":
+            return `user/v1/${clean}`;
+        default:
+            return clean;
+    }
+}
+function ApiCall(props) {
+    const { apiType = "contact", path, method = "GET", params, body, initialData, autoFetch, trigger, onSuccess, onError, loadingContent, children, } = props;
+    const endpointPath = React.useMemo(() => buildEndpointPath(apiType, path), [apiType, path]);
+    const shouldAutoFetch = autoFetch !== undefined ? autoFetch : method === "GET";
+    const { preloaded, hasExactPreload } = (0, api_call_hooks_1.useIsrPrefetch)(endpointPath, params, method, initialData);
+    const { data, error, loading } = (0, api_call_hooks_1.useApiFetch)({
+        endpointPath,
+        method,
+        params,
+        body,
+        preloaded,
+        hasExactPreload,
+        shouldAutoFetch,
+        trigger,
+        onSuccess,
+        onError,
+        unwrapData: true,
+    });
+    // If no children, render nothing (still performs the call + callbacks)
+    if (!children)
+        return null;
+    // If children exist, respect loadingContent for UX
+    if (loading)
+        return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: loadingContent ?? (0, jsx_runtime_1.jsx)("div", { children: "Loading\u2026" }) });
+    const responseData = {
+        data: error ? null : data,
+        error,
+        loading,
+        success: !loading && !error && data !== null,
+        failed: !loading && error !== null,
+    };
+    return ((0, jsx_runtime_1.jsx)(host_1.DataProvider, { name: "response", data: responseData, children: children }));
+}
+exports.default = ApiCall;

package/dist/components/IsrPageWrapper.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=IsrPageWrapper.d.ts.map

package/dist/components/IsrPageWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsrPageWrapper.d.ts","sourceRoot":"","sources":["../../src/components/IsrPageWrapper.tsx"],"names":[],"mappings":""}

package/dist/components/IsrPageWrapper.js

@@ -0,0 +1 @@
+"use strict";

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { ApiCall, type ApiCallProps, type ApiType } from "./components/ApiCall";
+export { registerCodeComponents } from "./register";
+export { CXF_COOKIE_NAMES, CXF_HEADER_NAMES, type CxfTokens, getTokensFromCookies, buildAuthHeaders, makeAuthenticatedRequest, extractSetCookieHeaders, extractTokensFromSetCookie, buildCookieHeader, getCxfBaseUrl, getCxfApiKey, buildCookieString, setTokensAsCookies, clearAuthCookies, } from "./lib/cxf-auth";
+export { buildQueryString as buildApiQueryString, normalizePath, setAuthCookies, handleError, sendResponse, } from "./lib/api-route-helpers";
+export { useIsrPrefetch, useApiFetch, type PreloadedDataResult, type UseApiFetchOptions, } from "./lib/api-call-hooks";
+export { EndpointDataContext, PrefetchCollectorContext, PrefetchCollectorProvider, ServerPageWrapper, createServerProps, normalizeEndpointPath, buildQueryString, buildEndpointKey, type EndpointConfig, type ServerPageProps, type ServerPageWrapperProps, type PrefetchRequest, } from "./lib/server-props";
+export { CxfApp } from "./pages/app";
+export { PlasmicHost } from "./pages/plasmic-host";
+export { cxfApiHandler } from "./pages/api/cxf";
+export { assetsApiHandler } from "./pages/api/assets";
+export { cxfNextConfig } from "./next.config";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,SAAS,EACd,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,IAAI,mBAAmB,EACvC,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,cAAc,EACd,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cxfNextConfig = exports.assetsApiHandler = exports.cxfApiHandler = exports.PlasmicHost = exports.CxfApp = exports.buildEndpointKey = exports.buildQueryString = exports.normalizeEndpointPath = exports.createServerProps = exports.ServerPageWrapper = exports.PrefetchCollectorProvider = exports.PrefetchCollectorContext = exports.EndpointDataContext = exports.useApiFetch = exports.useIsrPrefetch = exports.sendResponse = exports.handleError = exports.setAuthCookies = exports.normalizePath = exports.buildApiQueryString = exports.clearAuthCookies = exports.setTokensAsCookies = exports.buildCookieString = exports.getCxfApiKey = exports.getCxfBaseUrl = exports.buildCookieHeader = exports.extractTokensFromSetCookie = exports.extractSetCookieHeaders = exports.makeAuthenticatedRequest = exports.buildAuthHeaders = exports.getTokensFromCookies = exports.CXF_HEADER_NAMES = exports.CXF_COOKIE_NAMES = exports.registerCodeComponents = exports.ApiCall = void 0;
+// Main exports
+var ApiCall_1 = require("./components/ApiCall");
+Object.defineProperty(exports, "ApiCall", { enumerable: true, get: function () { return ApiCall_1.ApiCall; } });
+var register_1 = require("./register");
+Object.defineProperty(exports, "registerCodeComponents", { enumerable: true, get: function () { return register_1.registerCodeComponents; } });
+// Library exports
+var cxf_auth_1 = require("./lib/cxf-auth");
+Object.defineProperty(exports, "CXF_COOKIE_NAMES", { enumerable: true, get: function () { return cxf_auth_1.CXF_COOKIE_NAMES; } });
+Object.defineProperty(exports, "CXF_HEADER_NAMES", { enumerable: true, get: function () { return cxf_auth_1.CXF_HEADER_NAMES; } });
+Object.defineProperty(exports, "getTokensFromCookies", { enumerable: true, get: function () { return cxf_auth_1.getTokensFromCookies; } });
+Object.defineProperty(exports, "buildAuthHeaders", { enumerable: true, get: function () { return cxf_auth_1.buildAuthHeaders; } });
+Object.defineProperty(exports, "makeAuthenticatedRequest", { enumerable: true, get: function () { return cxf_auth_1.makeAuthenticatedRequest; } });
+Object.defineProperty(exports, "extractSetCookieHeaders", { enumerable: true, get: function () { return cxf_auth_1.extractSetCookieHeaders; } });
+Object.defineProperty(exports, "extractTokensFromSetCookie", { enumerable: true, get: function () { return cxf_auth_1.extractTokensFromSetCookie; } });
+Object.defineProperty(exports, "buildCookieHeader", { enumerable: true, get: function () { return cxf_auth_1.buildCookieHeader; } });
+Object.defineProperty(exports, "getCxfBaseUrl", { enumerable: true, get: function () { return cxf_auth_1.getCxfBaseUrl; } });
+Object.defineProperty(exports, "getCxfApiKey", { enumerable: true, get: function () { return cxf_auth_1.getCxfApiKey; } });
+Object.defineProperty(exports, "buildCookieString", { enumerable: true, get: function () { return cxf_auth_1.buildCookieString; } });
+Object.defineProperty(exports, "setTokensAsCookies", { enumerable: true, get: function () { return cxf_auth_1.setTokensAsCookies; } });
+Object.defineProperty(exports, "clearAuthCookies", { enumerable: true, get: function () { return cxf_auth_1.clearAuthCookies; } });
+var api_route_helpers_1 = require("./lib/api-route-helpers");
+Object.defineProperty(exports, "buildApiQueryString", { enumerable: true, get: function () { return api_route_helpers_1.buildQueryString; } });
+Object.defineProperty(exports, "normalizePath", { enumerable: true, get: function () { return api_route_helpers_1.normalizePath; } });
+Object.defineProperty(exports, "setAuthCookies", { enumerable: true, get: function () { return api_route_helpers_1.setAuthCookies; } });
+Object.defineProperty(exports, "handleError", { enumerable: true, get: function () { return api_route_helpers_1.handleError; } });
+Object.defineProperty(exports, "sendResponse", { enumerable: true, get: function () { return api_route_helpers_1.sendResponse; } });
+var api_call_hooks_1 = require("./lib/api-call-hooks");
+Object.defineProperty(exports, "useIsrPrefetch", { enumerable: true, get: function () { return api_call_hooks_1.useIsrPrefetch; } });
+Object.defineProperty(exports, "useApiFetch", { enumerable: true, get: function () { return api_call_hooks_1.useApiFetch; } });
+var server_props_1 = require("./lib/server-props");
+Object.defineProperty(exports, "EndpointDataContext", { enumerable: true, get: function () { return server_props_1.EndpointDataContext; } });
+Object.defineProperty(exports, "PrefetchCollectorContext", { enumerable: true, get: function () { return server_props_1.PrefetchCollectorContext; } });
+Object.defineProperty(exports, "PrefetchCollectorProvider", { enumerable: true, get: function () { return server_props_1.PrefetchCollectorProvider; } });
+Object.defineProperty(exports, "ServerPageWrapper", { enumerable: true, get: function () { return server_props_1.ServerPageWrapper; } });
+Object.defineProperty(exports, "createServerProps", { enumerable: true, get: function () { return server_props_1.createServerProps; } });
+Object.defineProperty(exports, "normalizeEndpointPath", { enumerable: true, get: function () { return server_props_1.normalizeEndpointPath; } });
+Object.defineProperty(exports, "buildQueryString", { enumerable: true, get: function () { return server_props_1.buildQueryString; } });
+Object.defineProperty(exports, "buildEndpointKey", { enumerable: true, get: function () { return server_props_1.buildEndpointKey; } });
+// Page exports
+var app_1 = require("./pages/app");
+Object.defineProperty(exports, "CxfApp", { enumerable: true, get: function () { return app_1.CxfApp; } });
+var plasmic_host_1 = require("./pages/plasmic-host");
+Object.defineProperty(exports, "PlasmicHost", { enumerable: true, get: function () { return plasmic_host_1.PlasmicHost; } });
+var cxf_1 = require("./pages/api/cxf");
+Object.defineProperty(exports, "cxfApiHandler", { enumerable: true, get: function () { return cxf_1.cxfApiHandler; } });
+var assets_1 = require("./pages/api/assets");
+Object.defineProperty(exports, "assetsApiHandler", { enumerable: true, get: function () { return assets_1.assetsApiHandler; } });
+// Config exports
+var next_config_1 = require("./next.config");
+Object.defineProperty(exports, "cxfNextConfig", { enumerable: true, get: function () { return next_config_1.cxfNextConfig; } });

package/dist/lib/api-call-hooks.d.ts

@@ -0,0 +1,25 @@
+export interface PreloadedDataResult {
+    preloaded: any;
+    hasExactPreload: boolean;
+}
+export declare function useIsrPrefetch(endpointPath: string | undefined, params: Record<string, any> | undefined, method?: string, initialData?: any): PreloadedDataResult;
+export interface UseApiFetchOptions {
+    endpointPath: string;
+    method?: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+    params?: Record<string, any>;
+    body?: Record<string, any>;
+    preloaded?: any;
+    hasExactPreload?: boolean;
+    shouldAutoFetch?: boolean;
+    trigger?: number;
+    onSuccess?: (data: any) => void;
+    onError?: (error: string) => void;
+    unwrapData?: boolean;
+}
+export declare function useApiFetch(options: UseApiFetchOptions): {
+    data: any;
+    error: string | null;
+    loading: boolean;
+    fetchData: () => (() => void) | undefined;
+};
+//# sourceMappingURL=api-call-hooks.d.ts.map

package/dist/lib/api-call-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-call-hooks.d.ts","sourceRoot":"","sources":["../../src/lib/api-call-hooks.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,GAAG,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EACvC,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,GAAG,GAChB,mBAAmB,CA+CrB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAkCD,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB;;;;;EAyLtD"}

package/dist/lib/api-call-hooks.js

@@ -0,0 +1,267 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useIsrPrefetch = useIsrPrefetch;
+exports.useApiFetch = useApiFetch;
+const React = __importStar(require("react"));
+const server_props_1 = require("./server-props");
+function useIsrPrefetch(endpointPath, params, method, initialData) {
+    const prefetchCollector = React.useContext(server_props_1.PrefetchCollectorContext);
+    const didRegisterRef = React.useRef(false);
+    const isGet = !method || method === "GET";
+    if (typeof window === "undefined" &&
+        prefetchCollector &&
+        !didRegisterRef.current &&
+        endpointPath &&
+        isGet) {
+        try {
+            prefetchCollector.register({ endpointPath, params });
+            didRegisterRef.current = true;
+        }
+        catch (error) {
+            // Silently fail registration errors to avoid breaking the prepass
+            if (process.env.NODE_ENV !== "production") {
+                console.warn(`Failed to register prefetch for ${endpointPath}:`, error);
+            }
+        }
+    }
+    const endpointDataMap = React.useContext(server_props_1.EndpointDataContext);
+    return React.useMemo(() => {
+        if (initialData != null) {
+            return { preloaded: initialData, hasExactPreload: true };
+        }
+        if (!endpointPath || !isGet) {
+            return { preloaded: undefined, hasExactPreload: false };
+        }
+        const runtimeKey = (0, server_props_1.buildEndpointKey)(endpointPath, params);
+        const exact = endpointDataMap?.[runtimeKey];
+        if (exact !== undefined) {
+            return { preloaded: exact, hasExactPreload: true };
+        }
+        const normalizedPath = (0, server_props_1.normalizeEndpointPath)(endpointPath);
+        const matchingKey = Object.keys(endpointDataMap || {}).find((k) => k === normalizedPath || k.startsWith(`${normalizedPath}?`));
+        return matchingKey
+            ? { preloaded: endpointDataMap[matchingKey], hasExactPreload: false }
+            : { preloaded: undefined, hasExactPreload: false };
+    }, [initialData, endpointPath, params, endpointDataMap, isGet]);
+}
+function unwrapResponseData(data, shouldUnwrap) {
+    if (!shouldUnwrap ||
+        !data ||
+        typeof data !== "object" ||
+        Array.isArray(data) ||
+        !("data" in data) ||
+        Object.keys(data).length !== 1) {
+        return data;
+    }
+    return data.data;
+}
+function getUtmParamsFromLocation() {
+    if (typeof window === "undefined")
+        return null;
+    try {
+        const search = window.location?.search || "";
+        if (!search)
+            return null;
+        const usp = new URLSearchParams(search);
+        const utmParams = {};
+        usp.forEach((value, key) => {
+            if (key.toLowerCase().startsWith("utm_") && value) {
+                utmParams[key] = value;
+            }
+        });
+        return Object.keys(utmParams).length > 0 ? utmParams : null;
+    }
+    catch {
+        return null;
+    }
+}
+function useApiFetch(options) {
+    const { endpointPath, method = "GET", params, body, preloaded, hasExactPreload, shouldAutoFetch = true, trigger, onSuccess, onError, unwrapData = false, } = options;
+    // Also check context directly in case preloaded prop hasn't updated yet during hydration
+    const endpointDataMap = React.useContext(server_props_1.EndpointDataContext);
+    const contextData = React.useMemo(() => {
+        if (!endpointPath || method !== "GET")
+            return undefined;
+        const runtimeKey = (0, server_props_1.buildEndpointKey)(endpointPath, params);
+        const exact = endpointDataMap?.[runtimeKey];
+        if (exact !== undefined)
+            return exact;
+        const normalizedPath = (0, server_props_1.normalizeEndpointPath)(endpointPath);
+        const matchingKey = Object.keys(endpointDataMap || {}).find((k) => k === normalizedPath || k.startsWith(`${normalizedPath}?`));
+        return matchingKey ? endpointDataMap[matchingKey] : undefined;
+    }, [endpointPath, params, endpointDataMap, method]);
+    // Use context data if preloaded is not available (hydration case)
+    const effectivePreloaded = preloaded !== undefined ? preloaded : contextData;
+    const hasPreloadedData = effectivePreloaded !== undefined && effectivePreloaded !== null;
+    const [data, setData] = React.useState(effectivePreloaded ?? null);
+    const [error, setError] = React.useState(null);
+    // Only show loading if we don't have preloaded data and should auto-fetch
+    const [loading, setLoading] = React.useState(shouldAutoFetch && !hasPreloadedData);
+    const hasTriggeredSuccessRef = React.useRef(false);
+    const hasTriggeredErrorRef = React.useRef(false);
+    const isHydratingRef = React.useRef(true);
+    const hasCheckedHydrationRef = React.useRef(false);
+    // Mark hydration as complete after first render
+    React.useEffect(() => {
+        if (typeof window !== "undefined" && !hasCheckedHydrationRef.current) {
+            hasCheckedHydrationRef.current = true;
+            // Wait one tick to allow context to be available
+            const timeoutId = setTimeout(() => {
+                isHydratingRef.current = false;
+            }, 0);
+            return () => clearTimeout(timeoutId);
+        }
+    }, []);
+    // Update data when preloaded or context data changes (e.g., during SSR hydration)
+    React.useEffect(() => {
+        if (effectivePreloaded !== undefined && effectivePreloaded !== data) {
+            setData(effectivePreloaded);
+            setLoading(false);
+            // If we get preloaded data during hydration, mark hydration as complete
+            if (isHydratingRef.current)
+                isHydratingRef.current = false;
+        }
+    }, [effectivePreloaded, data]);
+    const fetchData = React.useCallback(() => {
+        if (!endpointPath)
+            return;
+        const controller = new AbortController();
+        (async () => {
+            try {
+                setLoading(true);
+                setError(null);
+                hasTriggeredSuccessRef.current = false;
+                hasTriggeredErrorRef.current = false;
+                const normalizedPath = (0, server_props_1.normalizeEndpointPath)(endpointPath);
+                // Merge current page UTM params into request params for GET requests.
+                // Explicit params take precedence over UTM values if keys overlap.
+                const utmParams = method === "GET" ? getUtmParamsFromLocation() : null;
+                const mergedParams = method === "GET"
+                    ? { ...(utmParams || {}), ...(params || {}) }
+                    : params;
+                const queryString = method === "GET" ? (0, server_props_1.buildQueryString)(mergedParams) : "";
+                const url = `/api/${normalizedPath}${queryString}`;
+                const fetchOptions = {
+                    method,
+                    headers: {
+                        Accept: "application/json",
+                        "Content-Type": "application/json",
+                    },
+                    credentials: "include",
+                    signal: controller.signal,
+                };
+                if (method !== "GET" && body) {
+                    fetchOptions.body = JSON.stringify(body);
+                }
+                const resp = await fetch(url, fetchOptions);
+                if (!resp.ok) {
+                    if (resp.status === 401 || resp.status === 419) {
+                        throw new Error("Authentication required. Please log in again.");
+                    }
+                    const errorText = await resp.text().catch(() => `Request failed (${resp.status})`);
+                    throw new Error(errorText || `Request failed (${resp.status})`);
+                }
+                const contentType = resp.headers.get("content-type") || "";
+                const responseData = contentType.includes("application/json")
+                    ? await resp.json()
+                    : await resp.text();
+                const unwrappedData = unwrapResponseData(responseData, unwrapData);
+                setData(unwrappedData);
+                setError(null);
+            }
+            catch (e) {
+                if (e?.name === "AbortError")
+                    return;
+                setError(e?.message || "Unknown error");
+                setData(null);
+            }
+            finally {
+                setLoading(false);
+            }
+        })();
+        return () => controller.abort();
+    }, [endpointPath, method, params, body, unwrapData]);
+    const prevTriggerRef = React.useRef(trigger);
+    React.useEffect(() => {
+        if (trigger !== undefined && trigger !== prevTriggerRef.current) {
+            prevTriggerRef.current = trigger;
+            if (trigger > 0)
+                fetchData();
+        }
+    }, [trigger, fetchData]);
+    // Only fetch if we should auto-fetch AND we don't have exact preloaded data
+    React.useEffect(() => {
+        // Skip fetch if we already have any preloaded data (exact or fuzzy)
+        if (hasPreloadedData)
+            return;
+        // Skip fetch if auto-fetch is disabled
+        if (!shouldAutoFetch)
+            return;
+        // During hydration, wait a bit to allow context to be available
+        if (isHydratingRef.current && typeof window !== "undefined") {
+            const timeoutId = setTimeout(() => {
+                // Re-check context and preloaded after hydration delay
+                const stillNoData = effectivePreloaded === undefined || effectivePreloaded === null;
+                if (stillNoData && shouldAutoFetch && !hasExactPreload) {
+                    fetchData();
+                }
+            }, 0);
+            return () => clearTimeout(timeoutId);
+        }
+        // Fetch if we don't have preloaded data (non-hydration case)
+        if (!hasPreloadedData) {
+            return fetchData();
+        }
+    }, [shouldAutoFetch, hasExactPreload, hasPreloadedData, effectivePreloaded, fetchData]);
+    React.useEffect(() => {
+        if (data !== null && error === null && !loading && !hasTriggeredSuccessRef.current) {
+            hasTriggeredSuccessRef.current = true;
+            onSuccess?.(data);
+        }
+    }, [data, error, loading, onSuccess]);
+    React.useEffect(() => {
+        if (error !== null && !loading && !hasTriggeredErrorRef.current) {
+            hasTriggeredErrorRef.current = true;
+            onError?.(error);
+        }
+    }, [error, loading, onError]);
+    return {
+        data,
+        error,
+        loading,
+        fetchData,
+    };
+}

package/dist/lib/api-route-helpers.d.ts

@@ -0,0 +1,10 @@
+import type { NextApiRequest, NextApiResponse } from "next";
+export declare function buildQueryString(query: NextApiRequest["query"]): string;
+export declare function normalizePath(pathSegments: string[] | string | undefined): string;
+export declare function setAuthCookies(res: NextApiResponse, tokens: {
+    accessToken: string | null;
+    refreshToken: string | null;
+}): void;
+export declare function handleError(res: NextApiResponse, err: any): void;
+export declare function sendResponse(res: NextApiResponse, response: Response): Promise<void>;
+//# sourceMappingURL=api-route-helpers.d.ts.map

package/dist/lib/api-route-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-route-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/api-route-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAG5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,MAAM,CAavE;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAOjF;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,QAavH;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,QAMzD;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,iBAwB1E"}