@se-studio/core-ui 1.0.55 → 1.0.56

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @se-studio/core-ui
 
+## 1.0.56
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+- Updated dependencies
+  - @se-studio/contentful-rest-api@1.0.56
+  - @se-studio/core-data-types@1.0.56
+
 ## 1.0.55
 
 ### Patch Changes

package/CMS_INFRASTRUCTURE.md

@@ -110,9 +110,7 @@ export const rendererConfig = createCmsRendererConfig<MyProjectConfig>({
   },
   visualComponentRenderer: VisualRenderer,
   internalLinkRenderer: InternalLinkRenderer,
-  // Show errors in development mode
-  showUnknownTypeErrors: process.env.NODE_ENV === 'development',
-  showRenderErrors: process.env.NODE_ENV === 'development',
+  buildInformation,
 });
 ```
 
@@ -180,10 +178,9 @@ import { mergeCmsRendererConfig } from "@se-studio/core-ui";
 
 const baseConfig = createCmsRendererConfig({ ... });
 
-// Preview config with all errors displayed
+// Preview config: use buildInformation with isProduction: false to show errors
 export const previewConfig = mergeCmsRendererConfig(baseConfig, {
-  showUnknownTypeErrors: true,
-  showRenderErrors: true,
+  buildInformation: { ...baseConfig.buildInformation, isProduction: false },
 });
 
 // Use in preview routes
@@ -194,15 +191,13 @@ export const previewConfig = mergeCmsRendererConfig(baseConfig, {
 
 ```tsx
 const productionConfig = createCmsRendererConfig({
+  buildInformation: { ...buildInfo, isProduction: true },
   componentMap: { ... },
   collectionMap: { ... },
-  showUnknownTypeErrors: false,
-  showRenderErrors: false,
 });
 
 const developmentConfig = mergeCmsRendererConfig(productionConfig, {
-  showUnknownTypeErrors: true,
-  showRenderErrors: true,
+  buildInformation: { ...buildInfo, isProduction: false },
 });
 
 export const rendererConfig =
@@ -247,16 +242,17 @@ The main configuration type that bundles all renderer maps:
 
 ```tsx
 interface CmsRendererConfig<TConfig extends BaseCmsConfig> {
+  buildInformation: IBuildInformation;
   componentMap: ComponentMap<TConfig>;
   collectionMap: CollectionMap<TConfig>;
   externalComponentMap?: ExternalComponentMap<TConfig>;
   visualComponentRenderer?: VisualComponentRenderer<TConfig>;
   internalLinkRenderer?: InternalLinkRenderer<TConfig>;
-  showUnknownTypeErrors?: boolean;
-  showRenderErrors?: boolean;
 }
 ```
 
+Error panels (unknown types, render errors) are shown when `!buildInformation.isProduction`.
+
 ### Context Types
 
 - `IPageContext<TConfig>`: Page-level context (article, page, tag links)
@@ -268,7 +264,7 @@ interface CmsRendererConfig<TConfig extends BaseCmsConfig> {
 
 ### Unknown Type Warnings
 
-In development mode, the infrastructure displays visual warnings for:
+When not in production (`!buildInformation.isProduction`), the infrastructure displays visual warnings for:
 - Unmapped component/collection types
 - Rendering errors
 - Unused CMS properties
@@ -277,7 +273,7 @@ In development mode, the infrastructure displays visual warnings for:
 
 When a component/collection type isn't mapped:
 1. A warning is logged to console
-2. In dev mode, an error panel is displayed
+2. When not in production, an error panel is displayed
 3. A generic fallback renderer is used
 4. The page continues to render (no crashes)
 
@@ -301,7 +297,7 @@ To migrate an existing project:
 1. Install core-ui: `pnpm add @se-studio/core-ui`
 2. Create ComponentMap and CollectionMap
 3. Replace direct component rendering with CmsContent
-4. Test with `showUnknownTypeErrors={true}` to find missing mappings
+4. Use a non-production build (e.g. `buildInformation.isProduction: false`) to see error panels for missing mappings
 
 ## Examples
 
@@ -320,8 +316,7 @@ See the example apps in this monorepo for complete working implementations:
 - `externalComponentMap`: Map of external component types to renderers (optional)
 - `visualComponentRenderer`: Renderer for Visual content types (optional)
 - `internalLinkRenderer`: Renderer for Internal Link content types (optional)
-- `showUnknownTypeErrors`: Show error panels for unknown types (default: false)
-- `showRenderErrors`: Show error panels for rendering errors (default: false)
+- `buildInformation`: Build config (isProduction, baseUrl, etc.). Error panels are shown when `!buildInformation.isProduction`
 
 ## Future Enhancements
 

package/dist/CmsRendererConfig.d.ts

@@ -5,6 +5,7 @@ import type { CollectionMap, CollectionRenderer, EmbeddedCollectionMap } from '.
 import type { ComponentMap, ComponentRenderer, EmbeddedComponentMap } from './components/CmsComponent';
 import type { InternalLinkRenderer, VisualComponentRenderer } from './components/CmsContent';
 import type { EmbeddedExternalComponentMap, ExternalComponentMap } from './components/CmsExternalComponent';
+import type { IBuildInformation } from './utils/buildPageMetadata';
 export type CmsRendererTypes = {
     ComponentNameType: string;
     ComponentType: any;
@@ -22,7 +23,8 @@ export type CmsRendererTypes = {
  *
  * @example Basic configuration
  * ```tsx
- * const rendererConfig = createCmsRendererConfig<MyProjectConfig>({
+ * const rendererConfig = {
+ *   buildInformation,
  *   componentMap: {
  *     "Hero": HeroComponent,
  *     "CTA": CTAComponent,
@@ -32,25 +34,11 @@ export type CmsRendererTypes = {
  *     "FAQs": FAQCollection,
  *     "Related Articles": RelatedArticles,
  *   },
- *   showUnknownTypeErrors: process.env.NODE_ENV === 'development',
- * });
+ *   // ... other required fields
+ * };
  * ```
  *
- * @example With all renderer types
- * ```tsx
- * const rendererConfig = createCmsRendererConfig<MyProjectConfig>({
- *   componentMap: { ... },
- *   collectionMap: { ... },
- *   externalComponentMap: {
- *     "Contact Form": ContactFormRenderer,
- *     "Newsletter": NewsletterRenderer,
- *   },
- *   visualComponentRenderer: VisualRenderer,
- *   internalLinkRenderer: InternalLinkRenderer,
- *   showUnknownTypeErrors: true,
- *   showRenderErrors: true,
- * });
- * ```
+ * Error panels (unknown types, render errors) are shown when `!buildInformation.isProduction`.
  */
 export interface CmsRendererConfig<TConfig extends CmsRendererTypes = CmsRendererTypes> {
     /**
@@ -136,19 +124,10 @@ export interface CmsRendererConfig<TConfig extends CmsRendererTypes = CmsRendere
         contentContext: IContentContext;
     }>>>;
     /**
-     * Show error panels for unknown content types in development mode (default: false).
-     * When true, displays a visual warning when a component/collection type is not mapped.
-     *
-     * Recommended: Set to `process.env.NODE_ENV === 'development'`
-     */
-    showUnknownTypeErrors: boolean;
-    /**
-     * Show error panels for rendering errors (default: false).
-     * When true, displays error details when a component throws during rendering.
-     *
-     * Recommended: Set to `process.env.NODE_ENV === 'development'`
+     * Build configuration (isProduction, baseUrl, etc.).
+     * Error panels (unknown types, render errors) are shown when `!buildInformation.isProduction`.
      */
-    showRenderErrors: boolean;
+    buildInformation: IBuildInformation;
     defaultComponentRenderer: ComponentRenderer<any>;
     defaultCollectionRenderer: CollectionRenderer<any>;
 }

package/dist/CmsRendererConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CmsRendererConfig.d.ts","sourceRoot":"","sources":["../src/CmsRendererConfig.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kEAAkE,CAAC;AAC9F,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,KAAK,EACV,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,mCAAmC,CAAC;AAE3C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,GAAG,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,GAAG,CAAC;IACpB,yBAAyB,EAAE,MAAM,CAAC;IAClC,qBAAqB,EAAE,GAAG,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB;IACpF;;;;;;;;;;;OAWG;IACH,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;IAEnF,oBAAoB,EAAE,oBAAoB,CACxC,OAAO,CAAC,mBAAmB,CAAC,EAC5B,OAAO,CAAC,eAAe,CAAC,CACzB,CAAC;IAEF;;;;;;;;;;;OAWG;IACH,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACvF,qBAAqB,EAAE,qBAAqB,CAC1C,OAAO,CAAC,oBAAoB,CAAC,EAC7B,OAAO,CAAC,gBAAgB,CAAC,CAC1B,CAAC;IAEF;;;;;;;;;;;OAWG;IACH,oBAAoB,EAAE,oBAAoB,CACxC,OAAO,CAAC,2BAA2B,CAAC,EACpC,OAAO,CAAC,uBAAuB,CAAC,CACjC,CAAC;IACF,4BAA4B,EAAE,4BAA4B,CACxD,OAAO,CAAC,2BAA2B,CAAC,EACpC,OAAO,CAAC,uBAAuB,CAAC,CACjC,CAAC;IAEF;;;;;;;;;;OAUG;IACH,uBAAuB,EAAE,uBAAuB,CAAC;IAEjD;;;;;;;;;;OAUG;IACH,oBAAoB,EAAE,oBAAoB,CAAC;IAE3C;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE,OAAO,CACxB,MAAM,CACJ,MAAM,EACN,KAAK,CAAC,EAAE,CAAC;QACP,WAAW,EAAE,GAAG,CAAC;QACjB,cAAc,EAAE,eAAe,CAAC;KACjC,CAAC,CACH,CACF,CAAC;IAEF;;;;;OAKG;IACH,qBAAqB,EAAE,OAAO,CAAC;IAE/B;;;;;OAKG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B,wBAAwB,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACjD,yBAAyB,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;CACpD"}
+{"version":3,"file":"CmsRendererConfig.d.ts","sourceRoot":"","sources":["../src/CmsRendererConfig.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kEAAkE,CAAC;AAC9F,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,KAAK,EACV,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,GAAG,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,GAAG,CAAC;IACpB,yBAAyB,EAAE,MAAM,CAAC;IAClC,qBAAqB,EAAE,GAAG,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB;IACpF;;;;;;;;;;;OAWG;IACH,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;IAEnF,oBAAoB,EAAE,oBAAoB,CACxC,OAAO,CAAC,mBAAmB,CAAC,EAC5B,OAAO,CAAC,eAAe,CAAC,CACzB,CAAC;IAEF;;;;;;;;;;;OAWG;IACH,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACvF,qBAAqB,EAAE,qBAAqB,CAC1C,OAAO,CAAC,oBAAoB,CAAC,EAC7B,OAAO,CAAC,gBAAgB,CAAC,CAC1B,CAAC;IAEF;;;;;;;;;;;OAWG;IACH,oBAAoB,EAAE,oBAAoB,CACxC,OAAO,CAAC,2BAA2B,CAAC,EACpC,OAAO,CAAC,uBAAuB,CAAC,CACjC,CAAC;IACF,4BAA4B,EAAE,4BAA4B,CACxD,OAAO,CAAC,2BAA2B,CAAC,EACpC,OAAO,CAAC,uBAAuB,CAAC,CACjC,CAAC;IAEF;;;;;;;;;;OAUG;IACH,uBAAuB,EAAE,uBAAuB,CAAC;IAEjD;;;;;;;;;;OAUG;IACH,oBAAoB,EAAE,oBAAoB,CAAC;IAE3C;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE,OAAO,CACxB,MAAM,CACJ,MAAM,EACN,KAAK,CAAC,EAAE,CAAC;QACP,WAAW,EAAE,GAAG,CAAC;QACjB,cAAc,EAAE,eAAe,CAAC;KACjC,CAAC,CACH,CACF,CAAC;IAEF;;;OAGG;IACH,gBAAgB,EAAE,iBAAiB,CAAC;IAEpC,wBAAwB,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACjD,yBAAyB,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;CACpD"}

package/dist/app-helpers.d.ts

@@ -0,0 +1,124 @@
+/**
+ * App-level helper functions for Contentful CMS integration.
+ *
+ * This module provides a factory function that creates commonly-used helper functions
+ * for Next.js apps using the Contentful REST API. These helpers wrap the low-level
+ * API functions with project-specific configuration.
+ *
+ * @example
+ * ```typescript
+ * import { createAppHelpers } from '@se-studio/core-ui';
+ *
+ * const helpers = createAppHelpers({
+ *   converterContext,
+ *   getConfig: getContentfulConfig,
+ *   buildOptions: (options) => buildFetchOptions(options, draftOnly),
+ * });
+ *
+ * export const {
+ *   getAllPageLinks,
+ *   getPageWithErrors,
+ *   getPreviewFieldIdProps,
+ *   // ... etc
+ * } = helpers;
+ * ```
+ */
+import type { ArticleTypeFetchOptions, BaseConverterContext, CmsResponse, ContentfulConfig, FetchOptions, IContentfulCollection, IContentfulPerson, IFetchedTemplate, TagFetchOptions } from '@se-studio/contentful-rest-api';
+import type { BaseCollectionContent, IArticleLink, IArticleTypeLink, IBanner, IBaseArticle, IBaseArticleType, IBaseCustomType, IBasePage, IBaseTag, IContentContext, IInternalLink, IPersonLink } from '@se-studio/core-data-types';
+import type { IContent as IPreviewContent } from './utils/previewUtils';
+/**
+ * Configuration for creating app helpers
+ */
+export interface AppHelpersConfig {
+    /** The converter context with URL calculators and other project-specific settings */
+    converterContext: BaseConverterContext;
+    /** Function to get Contentful config based on preview mode */
+    getConfig: (preview: boolean) => ContentfulConfig;
+    /** Function to build fetch options with project-specific defaults */
+    buildOptions: (options?: Partial<FetchOptions>) => FetchOptions;
+}
+/**
+ * Return type for createAppHelpers factory function.
+ * Contains all the helper functions for fetching content and managing preview.
+ */
+export interface AppHelpers<TPage, TArticle, TArticleType, TTag, TPerson, TCustomType, TCollection> {
+    getAllPageLinks: (options?: FetchOptions) => Promise<IInternalLink[]>;
+    getAllArticleLinks: (options?: FetchOptions) => Promise<IArticleLink[]>;
+    getAllTagLinks: (options?: FetchOptions) => Promise<IInternalLink[]>;
+    getAllPersonLinks: (options?: FetchOptions) => Promise<IInternalLink[]>;
+    getAllArticleTypeLinks: (options?: FetchOptions) => Promise<IArticleTypeLink[]>;
+    getRelatedArticles: (information: TCollection, contentContext: IContentContext, count: number | undefined, options?: FetchOptions) => Promise<IArticleLink[]>;
+    getRelatedPeople: (information: TCollection, contentContext: IContentContext, count: number, options?: FetchOptions) => Promise<IPersonLink[]>;
+    getBannersWithErrors: (options?: FetchOptions) => Promise<CmsResponse<IBanner[] | null>>;
+    getPageWithErrors: (slug: string, options?: FetchOptions) => Promise<CmsResponse<TPage | null>>;
+    getArticleWithErrors: (articleTypeSlug: string, slug: string, options?: FetchOptions) => Promise<CmsResponse<TArticle | null>>;
+    getArticleTypeWithErrors: (slug: string, options?: Partial<ArticleTypeFetchOptions>) => Promise<CmsResponse<TArticleType | null>>;
+    getTagWithErrors: (slug: string, options?: Partial<TagFetchOptions>) => Promise<CmsResponse<TTag | null>>;
+    getPersonWithErrors: (slug: string, options?: Partial<FetchOptions> & {
+        customType?: string;
+    }) => Promise<CmsResponse<TPerson | null>>;
+    getCustomTypeWithErrors: (slug: string, options?: FetchOptions) => Promise<CmsResponse<TCustomType | null>>;
+    getTemplateWithErrors: (cmsLabel: string, options?: FetchOptions) => Promise<CmsResponse<IFetchedTemplate | null>>;
+    getPreviewFieldIdProps: (id?: string, fieldId?: string) => {
+        'data-contentful-entry-id': string | undefined;
+        'data-contentful-asset-id': string | undefined;
+        'data-contentful-field-id': string | undefined;
+    } | undefined;
+    getPreviewAssetIdProps: (assetId?: string) => {
+        'data-contentful-entry-id': string | undefined;
+        'data-contentful-asset-id': string | undefined;
+        'data-contentful-field-id': string | undefined;
+    } | undefined;
+    getPreviewParentProps: (information: IPreviewContent | null | undefined) => {
+        'data-contentful-entry-id': string | undefined;
+        'data-contentful-asset-id': string | undefined;
+        'data-contentful-field-id': string | undefined;
+    } | undefined;
+    getPreviewResponsiveVisualFieldIdProps: (id?: string, visualFieldId?: string, mobileVisualFieldId?: string) => {
+        visualPreviewProps: {
+            'data-contentful-entry-id': string | undefined;
+            'data-contentful-asset-id': string | undefined;
+            'data-contentful-field-id': string | undefined;
+        } | undefined;
+        mobileVisualPreviewProps: {
+            'data-contentful-entry-id': string | undefined;
+            'data-contentful-asset-id': string | undefined;
+            'data-contentful-field-id': string | undefined;
+        } | undefined;
+    };
+}
+/**
+ * Creates a set of helper functions for working with Contentful in Next.js apps.
+ *
+ * This factory function accepts project-specific configuration and returns
+ * a collection of pre-configured helper functions for:
+ * - Fetching links (pages, articles, tags, people, article types)
+ * - Fetching related content (articles, people)
+ * - Fetching full content (pages, articles, article types, tags, people, custom types, templates, banners)
+ * - Preview mode utilities (field IDs, asset IDs, parent props)
+ *
+ * All functions use the provided configuration to automatically handle:
+ * - Converter context for transforming Contentful entries
+ * - Config selection based on preview mode
+ * - Options building with project-specific defaults
+ * - Error logging and handling
+ *
+ * @param config - Configuration object with converter context, config getter, and options builder
+ * @returns Object containing all helper functions
+ *
+ * @example
+ * ```typescript
+ * const helpers = createAppHelpers({
+ *   converterContext: myConverterContext,
+ *   getConfig: getContentfulConfig,
+ *   buildOptions: (options) => buildFetchOptions(options, draftOnly),
+ * });
+ *
+ * // Use the helpers
+ * const pages = await helpers.getAllPageLinks();
+ * const page = await helpers.getPageWithErrors('home');
+ * const previewProps = helpers.getPreviewFieldIdProps(id, 'title');
+ * ```
+ */
+export declare function createAppHelpers<TPage extends IBasePage = IBasePage, TArticle extends IBaseArticle = IBaseArticle, TArticleType extends IBaseArticleType = IBaseArticleType, TTag extends IBaseTag = IBaseTag, TPerson extends IContentfulPerson = IContentfulPerson, TCustomType extends IBaseCustomType = IBaseCustomType, TCollection extends IContentfulCollection<BaseCollectionContent> = IContentfulCollection<BaseCollectionContent>>(config: AppHelpersConfig): AppHelpers<TPage, TArticle, TArticleType, TTag, TPerson, TCustomType, TCollection>;
+//# sourceMappingURL=app-helpers.d.ts.map

package/dist/app-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-helpers.d.ts","sourceRoot":"","sources":["../src/app-helpers.ts"],"names":[],"mappings":"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"}

package/dist/app-helpers.js

@@ -0,0 +1,246 @@
+/**
+ * App-level helper functions for Contentful CMS integration.
+ *
+ * This module provides a factory function that creates commonly-used helper functions
+ * for Next.js apps using the Contentful REST API. These helpers wrap the low-level
+ * API functions with project-specific configuration.
+ *
+ * @example
+ * ```typescript
+ * import { createAppHelpers } from '@se-studio/core-ui';
+ *
+ * const helpers = createAppHelpers({
+ *   converterContext,
+ *   getConfig: getContentfulConfig,
+ *   buildOptions: (options) => buildFetchOptions(options, draftOnly),
+ * });
+ *
+ * export const {
+ *   getAllPageLinks,
+ *   getPageWithErrors,
+ *   getPreviewFieldIdProps,
+ *   // ... etc
+ * } = helpers;
+ * ```
+ */
+import { contentfulAllArticleLinks, contentfulAllArticleTypeLinks, contentfulAllPageLinks, contentfulAllPersonLinks, contentfulAllTagLinks, contentfulArticleRest, contentfulArticleTypeRest, contentfulBannerRest, contentfulCustomTypeRest, contentfulPageRest, contentfulPersonRest, contentfulTagRest, contentfulTemplateRest, } from '@se-studio/contentful-rest-api';
+import { getRelatedArticles as coreGetRelatedArticles, getRelatedPeople as coreGetRelatedPeople, } from './utils/componentUtils';
+import { coreGetPreviewAssetIdProps, coreGetPreviewFieldIdProps, coreGetPreviewParentProps, } from './utils/previewUtils';
+/**
+ * Creates a set of helper functions for working with Contentful in Next.js apps.
+ *
+ * This factory function accepts project-specific configuration and returns
+ * a collection of pre-configured helper functions for:
+ * - Fetching links (pages, articles, tags, people, article types)
+ * - Fetching related content (articles, people)
+ * - Fetching full content (pages, articles, article types, tags, people, custom types, templates, banners)
+ * - Preview mode utilities (field IDs, asset IDs, parent props)
+ *
+ * All functions use the provided configuration to automatically handle:
+ * - Converter context for transforming Contentful entries
+ * - Config selection based on preview mode
+ * - Options building with project-specific defaults
+ * - Error logging and handling
+ *
+ * @param config - Configuration object with converter context, config getter, and options builder
+ * @returns Object containing all helper functions
+ *
+ * @example
+ * ```typescript
+ * const helpers = createAppHelpers({
+ *   converterContext: myConverterContext,
+ *   getConfig: getContentfulConfig,
+ *   buildOptions: (options) => buildFetchOptions(options, draftOnly),
+ * });
+ *
+ * // Use the helpers
+ * const pages = await helpers.getAllPageLinks();
+ * const page = await helpers.getPageWithErrors('home');
+ * const previewProps = helpers.getPreviewFieldIdProps(id, 'title');
+ * ```
+ */
+export function createAppHelpers(config) {
+    const { converterContext, getConfig, buildOptions } = config;
+    // Determine draft mode from buildOptions behavior
+    const testOptions = buildOptions({});
+    const draftOnly = testOptions.preview === true;
+    /**
+     * Generic helper for creating link fetcher functions.
+     * Encapsulates the common pattern of building options, fetching, logging errors, and returning data.
+     */
+    function createLinksFetcher(fetcher, errorLabel) {
+        return (options) => {
+            const fullOptions = buildOptions(options);
+            return fetcher(converterContext, getConfig(fullOptions.preview), fullOptions).then((response) => {
+                if (response.errors.length > 0) {
+                    console.warn(`Errors occurred while fetching ${errorLabel}:`, response.errors);
+                }
+                return response.data;
+            });
+        };
+    }
+    return {
+        // ============================================================================
+        // Link Fetchers
+        // ============================================================================
+        /** Fetch all page links for static params generation and sitemap building */
+        getAllPageLinks: createLinksFetcher(contentfulAllPageLinks, 'page links'),
+        /** Fetch all article links for static params generation and sitemap building */
+        getAllArticleLinks: createLinksFetcher(contentfulAllArticleLinks, 'article links'),
+        /** Fetch all tag links for static params generation and sitemap building */
+        getAllTagLinks: createLinksFetcher(contentfulAllTagLinks, 'tag links'),
+        /** Fetch all person links for static params generation and sitemap building */
+        getAllPersonLinks: createLinksFetcher(contentfulAllPersonLinks, 'person links'),
+        /** Fetch all article type links for static params generation and sitemap building */
+        getAllArticleTypeLinks: createLinksFetcher(contentfulAllArticleTypeLinks, 'article type links'),
+        // ============================================================================
+        // Related Content Helpers
+        // ============================================================================
+        /**
+         * Get related articles for a collection.
+         * Uses the generic core helper with project-specific config.
+         */
+        getRelatedArticles(information, contentContext, count, options) {
+            const fullOptions = buildOptions(options);
+            return coreGetRelatedArticles(information, contentContext, converterContext, getConfig(fullOptions.preview), count, fullOptions);
+        },
+        /**
+         * Get related people for a collection.
+         * Uses the generic core helper with project-specific config.
+         */
+        getRelatedPeople(information, contentContext, count, options) {
+            const fullOptions = buildOptions(options);
+            return coreGetRelatedPeople(information, contentContext, converterContext, getConfig(fullOptions.preview), count, fullOptions);
+        },
+        // ============================================================================
+        // Content Fetch Functions (with error responses)
+        // ============================================================================
+        /**
+         * Fetch all banners from Contentful (returns full CmsResponse for internal use)
+         *
+         * @param options - Optional fetch options (preview, cache, locale, retry)
+         * @returns Promise resolving to CmsResponse with banners data and any errors
+         *
+         * @internal This function is for internal use by page rendering logic
+         */
+        getBannersWithErrors(options) {
+            const fullOptions = buildOptions(options);
+            return contentfulBannerRest(converterContext, getConfig(fullOptions.preview), fullOptions);
+        },
+        /**
+         * Fetch a page from Contentful by slug (returns full CmsResponse for internal use)
+         *
+         * @param slug - The page slug to fetch
+         * @param options - Optional fetch options (preview, cache, locale, retry)
+         * @returns Promise resolving to CmsResponse with page data and any errors
+         *
+         * @internal This function is for internal use by page rendering logic
+         */
+        getPageWithErrors(slug, options) {
+            const fullOptions = buildOptions(options);
+            return contentfulPageRest(converterContext, getConfig(fullOptions.preview), slug, fullOptions);
+        },
+        /**
+         * Fetch an article from Contentful by article type slug and article slug (returns full CmsResponse for internal use)
+         *
+         * @param articleTypeSlug - The article type slug (e.g., 'blog', 'news')
+         * @param slug - The article slug to fetch
+         * @param options - Optional fetch options (preview, cache, locale, retry)
+         * @returns Promise resolving to CmsResponse with article data and any errors
+         *
+         * @internal This function is for internal use by page rendering logic
+         */
+        getArticleWithErrors(articleTypeSlug, slug, options) {
+            const fullOptions = buildOptions(options);
+            return contentfulArticleRest(converterContext, getConfig(fullOptions.preview), slug, articleTypeSlug, fullOptions);
+        },
+        /**
+         * Fetch an article type from Contentful by slug (returns full CmsResponse for internal use)
+         *
+         * @param slug - The article type slug (e.g., 'blog', 'news')
+         * @param options - Optional fetch options (preview, cache, locale, retry, customType)
+         * @returns Promise resolving to CmsResponse with article type data and any errors
+         *
+         * @internal This function is for internal use by page rendering logic
+         */
+        getArticleTypeWithErrors(slug, options) {
+            const fullOptions = buildOptions(options);
+            return contentfulArticleTypeRest(converterContext, getConfig(fullOptions.preview), slug, fullOptions);
+        },
+        /**
+         * Fetch a tag from Contentful by slug (returns full CmsResponse for internal use)
+         *
+         * @param slug - The tag slug to fetch
+         * @param options - Optional fetch options (preview, cache, locale, retry, customType)
+         * @returns Promise resolving to CmsResponse with tag data and any errors
+         *
+         * @internal This function is for internal use by page rendering logic
+         */
+        getTagWithErrors(slug, options) {
+            const fullOptions = buildOptions(options);
+            return contentfulTagRest(converterContext, getConfig(fullOptions.preview), slug, fullOptions);
+        },
+        /**
+         * Fetch a person from Contentful by slug (returns full CmsResponse for internal use)
+         *
+         * @param slug - The person slug to fetch
+         * @param options - Optional fetch options (preview, cache, locale, retry, customType)
+         * @returns Promise resolving to CmsResponse with person data and any errors
+         *
+         * @internal This function is for internal use by page rendering logic
+         */
+        getPersonWithErrors(slug, options) {
+            const fullOptions = buildOptions(options);
+            return contentfulPersonRest(converterContext, getConfig(fullOptions.preview), slug, fullOptions);
+        },
+        /**
+         * Fetch a custom type from Contentful by slug (returns full CmsResponse for internal use)
+         *
+         * Custom types represent index pages for categories like Topics or Resources.
+         *
+         * @param slug - The custom type's slug to fetch (e.g., 'topics', 'resources')
+         * @param options - Optional fetch options (preview, cache, locale, retry)
+         * @returns Promise resolving to CmsResponse with custom type data and any errors
+         *
+         * @internal This function is for internal use by page rendering logic
+         */
+        getCustomTypeWithErrors(slug, options) {
+            const fullOptions = buildOptions(options);
+            return contentfulCustomTypeRest(converterContext, getConfig(fullOptions.preview), slug, fullOptions);
+        },
+        /**
+         * Fetch a template from Contentful by cmsLabel (returns full CmsResponse for internal use)
+         *
+         * Templates are used for shared layouts like the 404 page.
+         *
+         * @param cmsLabel - The template's cmsLabel to fetch (e.g., '404')
+         * @param options - Optional fetch options (preview, cache, locale, retry)
+         * @returns Promise resolving to CmsResponse with template data and any errors
+         *
+         * @internal This function is for internal use by page rendering logic
+         */
+        getTemplateWithErrors(cmsLabel, options) {
+            const fullOptions = buildOptions(options);
+            return contentfulTemplateRest(converterContext, getConfig(fullOptions.preview), cmsLabel, fullOptions);
+        },
+        // ============================================================================
+        // Preview Utilities (wrapped with project draftOnly)
+        // ============================================================================
+        getPreviewFieldIdProps(id, fieldId) {
+            return coreGetPreviewFieldIdProps(id, fieldId, draftOnly);
+        },
+        getPreviewAssetIdProps(assetId) {
+            return coreGetPreviewAssetIdProps(assetId, draftOnly);
+        },
+        getPreviewParentProps(information) {
+            return coreGetPreviewParentProps(information, draftOnly);
+        },
+        getPreviewResponsiveVisualFieldIdProps(id, visualFieldId = 'visual', mobileVisualFieldId = 'mobileVisual') {
+            return {
+                visualPreviewProps: coreGetPreviewFieldIdProps(id, visualFieldId, draftOnly),
+                mobileVisualPreviewProps: coreGetPreviewFieldIdProps(id, mobileVisualFieldId, draftOnly),
+            };
+        },
+    };
+}
+//# sourceMappingURL=app-helpers.js.map

package/dist/app-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-helpers.js","sourceRoot":"","sources":["../src/app-helpers.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"ClientMonitor.d.ts","sourceRoot":"","sources":["../../src/components/ClientMonitor.tsx"],"names":[],"mappings":"AAwbA,UAAU,kBAAkB;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAuBtD,CAAC"}
+{"version":3,"file":"ClientMonitor.d.ts","sourceRoot":"","sources":["../../src/components/ClientMonitor.tsx"],"names":[],"mappings":"AAybA,UAAU,kBAAkB;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA6BtD,CAAC"}

package/dist/components/ClientMonitor.js

@@ -1,5 +1,7 @@
 'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
 import { usePathname } from 'next/navigation';
+import Script from 'next/script';
 import { useEffect } from 'react';
 import { useDocumentVisible } from '../hooks/useDocumentVisible';
 const _observers = new Map();
@@ -386,6 +388,8 @@ export const ClientMonitor = ({ defaultThreshold = 0.2, enableDebug = false, })
         }
         return undefined;
     }, [pathname, isDocumentVisible, roundedDefaultThreshold]);
-    return null;
+    return (_jsx(Script, { id: "welcome", strategy: "afterInteractive", children: `
+console.log("%cDesigned and built by Something Else", "font-weight: bold");
+` }));
 };
 //# sourceMappingURL=ClientMonitor.js.map