@deepsel/cms-utils 1.1.5 → 1.1.6

package/dist/blog/fetchBlogList.d.ts

@@ -1,5 +1,5 @@
-import type { BlogListData } from './types';
-import type { Pagination } from '../page/getPathType';
+import type { BlogListData } from './types.js';
+import type { Pagination } from '../page/getPathType.js';
 interface FetchBlogListProps {
     lang?: string;
     pagination?: Pagination;

package/dist/blog/fetchBlogPost.d.ts

@@ -1,4 +1,4 @@
-import type { BlogPostData } from './types';
+import type { BlogPostData } from './types.js';
 interface FetchBlogPostProps {
     path: string;
     lang?: string;

package/dist/blog/fetchBlogPost.js

@@ -1,4 +1,4 @@
-import { fetchPublicSettings } from '../page';
+import { fetchPublicSettings } from '../page/index.js';
 /**
  * Fetches a single blog post from the backend by language and path
  * Corresponds to GET /blog_post/website/{lang}/{path}

package/dist/blog/index.d.ts

@@ -1,3 +1,3 @@
-export * from './fetchBlogList';
-export * from './fetchBlogPost';
-export * from './types';
+export * from './fetchBlogList.js';
+export * from './fetchBlogPost.js';
+export * from './types.js';

package/dist/blog/index.js

@@ -1,3 +1,3 @@
-export * from './fetchBlogList';
-export * from './fetchBlogPost';
-export * from './types';
+export * from './fetchBlogList.js';
+export * from './fetchBlogPost.js';
+export * from './types.js';

package/dist/blog/types.d.ts

@@ -1,5 +1,5 @@
-import type { SiteSettings } from '../types';
-import type { SeoMetadata, LanguageAlternative } from '../page/types';
+import type { SiteSettings } from '../types.js';
+import type { SeoMetadata, LanguageAlternative } from '../page/types.js';
 export interface BlogPostAuthor {
     id: number;
     display_name?: string;

package/dist/common/utils/cookieUtils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sets a cookie with the given name, value, and expiration days
+ */
+export declare function setCookie(name: string, value: string, days?: number): void;
+/**
+ * Gets a cookie value by name
+ */
+export declare function getCookie(name: string): string | null;
+/**
+ * Removes a cookie by name
+ */
+export declare function removeCookie(name: string): void;

package/dist/common/utils/cookieUtils.js

@@ -0,0 +1,39 @@
+/**
+ * Cookie expiration in days when not specified
+ */
+const COOKIE_DEFAULT_EXPIRY_DAYS = 30;
+/**
+ * Sets a cookie with the given name, value, and expiration days
+ */
+export function setCookie(name, value, days = COOKIE_DEFAULT_EXPIRY_DAYS) {
+    if (typeof document !== 'undefined') {
+        const expiryDate = new Date();
+        expiryDate.setDate(expiryDate.getDate() + days);
+        document.cookie = `${name}=${value}; expires=${expiryDate.toUTCString()}; path=/; SameSite=Lax`;
+    }
+}
+/**
+ * Gets a cookie value by name
+ */
+export function getCookie(name) {
+    if (typeof document !== 'undefined') {
+        const nameEQ = name + '=';
+        const ca = document.cookie.split(';');
+        for (let i = 0; i < ca.length; i++) {
+            let c = ca[i];
+            while (c.charAt(0) === ' ')
+                c = c.substring(1, c.length);
+            if (c.indexOf(nameEQ) === 0)
+                return c.substring(nameEQ.length, c.length);
+        }
+    }
+    return null;
+}
+/**
+ * Removes a cookie by name
+ */
+export function removeCookie(name) {
+    if (typeof document !== 'undefined') {
+        document.cookie = `${name}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;`;
+    }
+}

package/dist/common/utils/index.d.ts

@@ -0,0 +1,48 @@
+export * from './cookieUtils.js';
+export * from './isObjectOrArray.js';
+/**
+ * Builds the full URL for an attachment file
+ * @param backendHost - The backend host URL (e.g. "https://api.example.com")
+ * @param name - The attachment filename
+ * @returns Full URL to serve the attachment, or empty string if name is falsy
+ */
+export declare function getAttachmentUrl(backendHost: string, name: string): string;
+/**
+ * Builds the relative URL for an attachment file (no host)
+ * @param name - The attachment filename
+ * @returns Relative URL to serve the attachment, or empty string if name is falsy
+ */
+export declare function getAttachmentRelativeUrl(name: string): string;
+/**
+ * Extracts the filename from an attachment serve URL
+ * @param url - The attachment URL (e.g. "https://api.example.com/attachment/serve/file.png")
+ * @returns The filename portion of the URL, or empty string if url is falsy
+ */
+export declare function getFileNameFromAttachUrl(url: string): string;
+/**
+ * Triggers a browser download for a file from an attachment URL
+ * @param url - The attachment URL to download from
+ */
+export declare function downloadFromAttachUrl(url: string): void;
+/**
+ * Converts a string to a deterministic hex color via a simple hash
+ */
+export declare function stringToColor(string: string): string;
+/**
+ * Returns a background color and initials string derived from a display name.
+ * Suitable for use in avatar components.
+ */
+export declare function stringAvatar(name: string): {
+    color: string;
+    children: string;
+};
+/**
+ * Extracts the file extension from a filename or URL
+ * @param fileName - The filename or path (e.g. "photo.jpg", "/path/to/file.pdf")
+ * @returns The extension without the dot (e.g. "jpg"), or empty string if none
+ */
+export declare function getFileExtension(fileName: string): string;
+/**
+ * Format file size in human-readable format
+ */
+export declare const formatFileSize: (bytes: number) => string;

package/dist/common/utils/index.js

@@ -0,0 +1,95 @@
+export * from './cookieUtils.js';
+export * from './isObjectOrArray.js';
+/**
+ * Builds the full URL for an attachment file
+ * @param backendHost - The backend host URL (e.g. "https://api.example.com")
+ * @param name - The attachment filename
+ * @returns Full URL to serve the attachment, or empty string if name is falsy
+ */
+export function getAttachmentUrl(backendHost, name) {
+    return name ? `${backendHost}/attachment/serve/${name}` : '';
+}
+/**
+ * Builds the relative URL for an attachment file (no host)
+ * @param name - The attachment filename
+ * @returns Relative URL to serve the attachment, or empty string if name is falsy
+ */
+export function getAttachmentRelativeUrl(name) {
+    return name ? `/attachment/serve/${name}` : '';
+}
+/**
+ * Extracts the filename from an attachment serve URL
+ * @param url - The attachment URL (e.g. "https://api.example.com/attachment/serve/file.png")
+ * @returns The filename portion of the URL, or empty string if url is falsy
+ */
+export function getFileNameFromAttachUrl(url) {
+    return url?.substring(url.lastIndexOf('/') + 1) || '';
+}
+/**
+ * Triggers a browser download for a file from an attachment URL
+ * @param url - The attachment URL to download from
+ */
+export function downloadFromAttachUrl(url) {
+    const downloadUrl = url.includes('?') ? `${url}&download=true` : `${url}?download=true`;
+    fetch(downloadUrl)
+        .then((response) => response.blob())
+        .then((blob) => {
+        const objectUrl = URL.createObjectURL(blob);
+        const link = document.createElement('a');
+        link.href = objectUrl;
+        link.setAttribute('download', getFileNameFromAttachUrl(url));
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+        URL.revokeObjectURL(objectUrl);
+    })
+        .catch((error) => {
+        console.error('Error downloading the file:', error);
+    });
+}
+/**
+ * Converts a string to a deterministic hex color via a simple hash
+ */
+export function stringToColor(string) {
+    let hash = 0;
+    for (let i = 0; i < string.length; i++) {
+        hash = string.charCodeAt(i) + ((hash << 5) - hash);
+    }
+    let color = '#';
+    for (let i = 0; i < 3; i++) {
+        const value = (hash >> (i * 8)) & 0xff;
+        color += `00${value.toString(16)}`.slice(-2);
+    }
+    return color;
+}
+/**
+ * Returns a background color and initials string derived from a display name.
+ * Suitable for use in avatar components.
+ */
+export function stringAvatar(name) {
+    const children = name.includes(' ')
+        ? `${name.split(' ')[0][0]}${name.split(' ')[1][0]}`
+        : (name[0] ?? '');
+    return {
+        color: stringToColor(name),
+        children,
+    };
+}
+/**
+ * Extracts the file extension from a filename or URL
+ * @param fileName - The filename or path (e.g. "photo.jpg", "/path/to/file.pdf")
+ * @returns The extension without the dot (e.g. "jpg"), or empty string if none
+ */
+export function getFileExtension(fileName) {
+    return fileName?.split('.').pop() ?? '';
+}
+/**
+ * Format file size in human-readable format
+ */
+export const formatFileSize = (bytes) => {
+    if (!bytes)
+        return '';
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    return Math.round((bytes / Math.pow(1024, i)) * 100) / 100 + ' ' + sizes[i];
+};

package/dist/common/utils/isObjectOrArray.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Returns true if value is a plain object or array (not null)
+ */
+export declare function isObjectOrArray(value: unknown): boolean;

package/dist/common/utils/isObjectOrArray.js

@@ -0,0 +1,7 @@
+/**
+ * Returns true if value is a plain object or array (not null)
+ */
+export function isObjectOrArray(value) {
+    return (value !== null &&
+        (Array.isArray(value) || Object.prototype.toString.call(value) === '[object Object]'));
+}

package/dist/constants/index.d.ts

@@ -1 +1,2 @@
-export * from './websiteDataTypes';
+export * from './websiteDataTypes.js';
+export * from './pagingTableParams.js';

package/dist/constants/index.js

@@ -1 +1,2 @@
-export * from './websiteDataTypes';
+export * from './websiteDataTypes.js';
+export * from './pagingTableParams.js';

package/dist/constants/pagingTableParams.d.ts

@@ -0,0 +1,8 @@
+/**
+ * URL search parameter keys used for paging and searching in list views
+ */
+export declare const PagingTableParams: {
+    readonly Search: "search";
+    readonly Limit: "limit";
+    readonly Page: "page";
+};

package/dist/constants/pagingTableParams.js

@@ -0,0 +1,8 @@
+/**
+ * URL search parameter keys used for paging and searching in list views
+ */
+export const PagingTableParams = {
+    Search: 'search',
+    Limit: 'limit',
+    Page: 'page',
+};

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-export * from './page';
-export * from './menus';
-export * from './blog';
-export * from './types';
-export * from './constants';
+export * from './blog/index.js';
+export * from './common/utils/index.js';
+export * from './constants/index.js';
+export * from './menus/index.js';
+export * from './page/index.js';
+export * from './types.js';

package/dist/index.js

@@ -1,5 +1,6 @@
-export * from './page';
-export * from './menus';
-export * from './blog';
-export * from './types';
-export * from './constants';
+export * from './blog/index.js';
+export * from './common/utils/index.js';
+export * from './constants/index.js';
+export * from './menus/index.js';
+export * from './page/index.js';
+export * from './types.js';

package/dist/menus/index.d.ts

@@ -1,2 +1,2 @@
-export * from './isActiveMenu';
-export * from './types';
+export * from './isActiveMenu.js';
+export * from './types.js';

package/dist/menus/index.js

@@ -1,2 +1,2 @@
-export * from './isActiveMenu';
-export * from './types';
+export * from './isActiveMenu.js';
+export * from './types.js';

package/dist/menus/isActiveMenu.d.ts

@@ -1,3 +1,3 @@
-import type { MenuItem } from './types';
-import type { WebsiteData } from '../types';
+import type { MenuItem } from './types.js';
+import type { WebsiteData } from '../types.js';
 export declare const isActiveMenu: (menuItem: MenuItem, websiteData: WebsiteData) => boolean;

package/dist/page/fetchPageData.d.ts

@@ -1,4 +1,4 @@
-import type { PageData } from './types';
+import type { PageData } from './types.js';
 interface FetchPageDataProps {
     path: string;
     lang?: string;

package/dist/page/fetchPageData.js

@@ -1,4 +1,4 @@
-import { fetchPublicSettings } from './fetchPublicSettings';
+import { fetchPublicSettings } from './fetchPublicSettings.js';
 /**
  * Fetches page data from the backend by language and slug
  */

package/dist/page/fetchPublicSettings.d.ts

@@ -1,4 +1,4 @@
-import type { SiteSettings } from '../types';
+import type { SiteSettings } from '../types.js';
 /**
  * Fetches public settings from the backend
  */

package/dist/page/fetchSearchResults.d.ts

@@ -1,4 +1,4 @@
-import type { SiteSettings } from '../types';
+import type { SiteSettings } from '../types.js';
 export interface SearchResultItem {
     id: string;
     title: string;

package/dist/page/fetchSearchResults.js

@@ -1,4 +1,4 @@
-import { fetchPublicSettings } from './fetchPublicSettings';
+import { fetchPublicSettings } from './fetchPublicSettings.js';
 /**
  * Fetches search results from the backend.
  * Calls GET /api/v1/page/website_search/{lang}?q=...&limit=...

package/dist/page/getPathType.d.ts

@@ -1,4 +1,4 @@
-import { type WebsiteDataType } from '../constants';
+import { type WebsiteDataType } from '../constants/index.js';
 export interface Pagination {
     page?: number;
     pageSize?: number;

package/dist/page/getPathType.js

@@ -1,4 +1,4 @@
-import { WebsiteDataTypes } from '../constants';
+import { WebsiteDataTypes } from '../constants/index.js';
 export function getPathType(path) {
     let pathType = WebsiteDataTypes.Page;
     let pagination = undefined;

package/dist/page/index.d.ts

@@ -1,7 +1,7 @@
-export * from './fetchPageData';
-export * from './fetchPublicSettings';
-export * from './fetchSearchResults';
-export * from './getAuthToken';
-export * from './parseSlug';
-export * from './types';
-export * from './isCrossingTemplateBoundary';
+export * from './fetchPageData.js';
+export * from './fetchPublicSettings.js';
+export * from './fetchSearchResults.js';
+export * from './getAuthToken.js';
+export * from './parseSlug.js';
+export * from './types.js';
+export * from './isCrossingTemplateBoundary.js';

package/dist/page/index.js

@@ -1,7 +1,7 @@
-export * from './fetchPageData';
-export * from './fetchPublicSettings';
-export * from './fetchSearchResults';
-export * from './getAuthToken';
-export * from './parseSlug';
-export * from './types';
-export * from './isCrossingTemplateBoundary';
+export * from './fetchPageData.js';
+export * from './fetchPublicSettings.js';
+export * from './fetchSearchResults.js';
+export * from './getAuthToken.js';
+export * from './parseSlug.js';
+export * from './types.js';
+export * from './isCrossingTemplateBoundary.js';

package/dist/page/parseSlug.d.ts

@@ -1,5 +1,5 @@
-import type { Pagination } from './getPathType';
-import type { WebsiteDataType } from '../constants';
+import type { Pagination } from './getPathType.js';
+import type { WebsiteDataType } from '../constants/index.js';
 export interface SlugParseResult {
     lang?: string;
     path: string;

package/dist/page/parseSlug.js

@@ -1,5 +1,5 @@
-import { isValidLanguageCode } from './isValidLanguageCode';
-import { getPathType } from './getPathType';
+import { isValidLanguageCode } from './isValidLanguageCode.js';
+import { getPathType } from './getPathType.js';
 /**
  * Parses a slug to determine language and path
  */

package/dist/page/types.d.ts

@@ -1,5 +1,5 @@
-import type { SiteSettings } from '../types';
-import type { MenuItem } from '../menus/types';
+import type { SiteSettings } from '../types.js';
+import type { MenuItem } from '../menus/types.js';
 export interface Language {
     id: number;
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepsel/cms-utils",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "description": "Helper utilities for Deepsel CMS",
   "repository": {
     "type": "git",
@@ -25,6 +25,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./common/utils": {
+      "import": "./dist/common/utils/index.js",
+      "types": "./dist/common/utils/index.d.ts"
     }
   },
   "files": [