@encodeagent/platform-helper-util 1.2603.1221241 → 1.2603.1311023

package/README.md

@@ -1,6 +1,6 @@
 # @encodeagent/platform-helper-util
 
-Comprehensive TypeScript utility library for the EncodeAgent platform with AI services, authentication, file handling, web content processing, and more.
+TypeScript utility library for the EncodeAgent platform. Covers string/GUID validation, ID generation, web/URL handling, file type detection, color constants, AI cost calculation, HTML/Markdown conversion, tree data structures, authentication helpers, and structured logging.
 
 ## Installation
 
@@ -10,7 +10,7 @@ npm install @encodeagent/platform-helper-util
 
 ## Requirements
 
-- Node.js >20.0.0 <23.0.0
+- Node.js >=20.0.0 <23.0.0
 - TypeScript 5.2+
 
 ## Usage
@@ -18,261 +18,385 @@ npm install @encodeagent/platform-helper-util
 ### Core Utilities
 
 ```typescript
-import { 
-  isNonEmptyString, 
-  isGuid, 
-  isEmail, 
-  formatString, 
+import {
+  isNonEmptyString,
+  isGuid,
+  isEmail,
+  formatString,
   getTimestamp,
-  numberWithCommas,
-  readableFileSize 
+  readableFileSize
 } from '@encodeagent/platform-helper-util';
 
-isNonEmptyString('hello'); // true
-isGuid('550e8400-e29b-41d4-a716-446655440000'); // true
-isEmail('user@example.com'); // true
-formatString('Hello {0}!', 'World'); // 'Hello World!'
-numberWithCommas(1234567); // '1,234,567'
-readableFileSize(1024); // '1.00 KB'
+isNonEmptyString('hello');                           // true
+isGuid('550e8400-e29b-41d4-a716-446655440000');      // true
+isEmail('user@example.com');                         // true
+formatString('Hello {0}!', 'World');                 // 'Hello World!'
+readableFileSize(1024);                              // '1.00 KB'
 ```
 
-### Authentication & Authorization
+### ID Generation
 
 ```typescript
-import { 
-  checkRecordPrivilege, 
-  hasRole, 
-  isOwner, 
-  checkPrivileges 
-} from '@encodeagent/platform-helper-util';
+import { newGuid, newShortId, slug } from '@encodeagent/platform-helper-util';
 
-const hasAccess = checkRecordPrivilege(record, context, 'read');
-const userHasRole = hasRole(user, 'admin');
-const isRecordOwner = isOwner(record, userId);
+const guid    = newGuid();    // '550e8400-e29b-41d4-a716-446655440000'
+const shortId = newShortId(); // 'rJUWbIHOWM'
+
+// slug — URL-safe identifier from arbitrary text
+slug('Hello World!');                        // 'hello-world'
+slug('file.name', { keepPeriod: true });     // 'file.name'
+slug('my_key',   { keepUnderscore: true });  // 'my_key'
+
+// newShortId — same special-character opts apply
+newShortId({ keepUnderscore: true });  // preserves underscores from shortid output
 ```
 
-### AI Services & LLM Integration
+### Web & URL Utilities
 
 ```typescript
-import { 
-  getAIService, 
-  getLLMRequest, 
-  getAIContext,
-  calculateCost 
+import {
+  isValidUrl,
+  getBaseDomain,
+  getRootDomainFromUrl,
+  getWebLocation,
+  getWebRootUrl,
+  getWebQueryValue,
+  setWebQueryValue,
+  fixUrl
 } from '@encodeagent/platform-helper-util';
 
-const aiService = getAIService('gpt-4');
-const llmRequest = getLLMRequest(prompt, parameters);
-const context = getAIContext(userId, organizationId);
-const cost = calculateCost({ service: aiService, inputQuantity: 1000 });
+isValidUrl('https://example.com');                         // truthy
+getBaseDomain('sub.example.com');                          // 'example.com'
+getRootDomainFromUrl('https://sub.example.com/path');      // 'example.com'
+getWebQueryValue('https://example.com?page=2', 'page');    // '2'
+setWebQueryValue('https://example.com?page=1', 'page', '2'); // 'https://example.com?page=2'
+
+// fixUrl: promotes protocol-relative and root-relative URLs to absolute
+fixUrl('//cdn.example.com/img.png', 'https', '');          // 'https://cdn.example.com/img.png'
+fixUrl('/about', 'https', 'example.com');                  // 'https://example.com/about'
 ```
 
-### File & Content Processing
+### File & Content Type Detection
 
 ```typescript
-import { 
-  getFileType, 
+import {
+  getFileType,
   getContentType,
-  processWebPage,
-  markdownToHtml,
-  htmlToMarkdown,
-  cleanHtml 
+  getFileExtension,
+  getAcceptMIMEs,
+  getAcceptExtension,
+  getAcceptFileExtensions,
+  fileExtensionInTheList,
+  FILE_IMAGE_LIST,
+  FILE_PDF_LIST
 } from '@encodeagent/platform-helper-util';
 
-const fileType = getFileType('document.pdf');
-const contentType = getContentType('.json');
-const webContent = await processWebPage(url, settings);
-const html = markdownToHtml('# Hello World');
-const markdown = htmlToMarkdown('<h1>Hello World</h1>');
+getFileType('photo.jpg');          // 'Photo'
+getFileType('report.pdf');         // 'Document'
+getContentType('data.json');       // 'application/json'
+getFileExtension('archive.tar.gz'); // 'gz'
+
+// Accepted MIME / extension strings for <input accept="...">
+getAcceptMIMEs('image');           // 'image/gif, image/jpeg, ...'
+getAcceptExtension('document');    // '.pdf, .docx, .xlsx, .pptx'
+getAcceptFileExtensions('image');  // '*.gif, *.jpg, ...'
+
+fileExtensionInTheList('photo.png', FILE_IMAGE_LIST); // true
 ```
 
 ### Color Utilities
 
 ```typescript
-import { 
-  getColor, 
-  hexToRgb, 
+import {
+  getColor,
+  getColorTheme,
+  setColorTheme,
+  hexToRgb,
+  hexToRgba,
+  hexToRgbString,
+  hexToRgbaString,
+  rgbToHex,
   isValidHex,
+  isValidRGB,
+  intToHex,
   BLUE,
-  RED 
+  RED,
+  COLORS
 } from '@encodeagent/platform-helper-util';
 
-const color = getColor('primary');
-const rgb = hexToRgb('#FF0000'); // { r: 255, g: 0, b: 0 }
-const isValid = isValidHex('#FF0000'); // true
+// Tailwind-style palette lookup (shades: 50–950)
+getColor('blue', 500);               // '#3b82f6'
+getColor('unknown', 500, 'sky');     // falls back to sky-500
+
+// Full theme object
+getColorTheme('red');                // RED constant
+
+// Hex ↔ RGB conversion
+hexToRgb('#FF0000');                 // { r: 255, g: 0, b: 0 }
+hexToRgba('#FF0000', 0.5);          // { r: 255, g: 0, b: 0, a: 0.5 }
+hexToRgbString('#3b82f6');           // 'rgba(59,130,246)'
+rgbToHex('rgb(59, 130, 246)');      // '#3b82f6'
+isValidHex('#3b82f6');               // true
+isValidRGB('rgba(0,0,0,0.5)');      // true
 ```
 
-### Web & URL Utilities
+### Authentication & Authorization
+
+```typescript
+import {
+  checkRecordPrivilege,
+  hasRole,
+  hasAllRoles,
+  hasAnyRole,
+  isOwner,
+  isMember,
+  checkPrivileges,
+  checkPrivilege,
+  checkLicenses,
+  hasLicense,
+  isReader,
+  isAuthor
+} from '@encodeagent/platform-helper-util';
+
+const canEdit = checkRecordPrivilege(record, context, 'update');
+const userHasRole = hasRole(user, 'admin');
+const owned = isOwner(record, userId);
+```
+
+### AI Services & LLM Integration
 
 ```typescript
-import { 
-  isValidUrl, 
-  getBaseDomain, 
-  fixUrl,
-  getWebQueryValue 
+import {
+  getAiService,
+  getAiServices,
+  getAiModel,
+  getAiModels,
+  getAiPlatform,
+  getAiProvider,
+  getDefaultAiService,
+  getLLMRequest,
+  getLLMParameters,
+  getLLMPrompt,
+  calculateCost
 } from '@encodeagent/platform-helper-util';
 
-const isValid = isValidUrl('https://example.com');
-const domain = getBaseDomain('https://sub.example.com/path');
-const fixedUrl = fixUrl('example.com'); // 'https://example.com'
+const service    = getAiService('gpt-4');
+const request    = getLLMRequest({ ... });
+const cost       = calculateCost({ service, inputQuantity: 1000, outputQuantity: 200 });
 ```
 
 ### Record & Data Management
 
 ```typescript
-import { 
-  getRecordDisplay, 
+import {
+  getRecordDisplay,
   convertRecordForCreate,
   getContextFromRecord,
-  applyRecordSlug 
+  applyRecordSlug,
+  getRecordSlug,
+  getRecordAbstract,
+  getRecordPageMetadata,
+  fromOtherOrganization,
+  isFavorite
+} from '@encodeagent/platform-helper-util';
+
+const display     = getRecordDisplay(record, entity);
+const createReady = convertRecordForCreate(record);
+const context     = getContextFromRecord(record);
+```
+
+### HTML & Markdown Processing
+
+```typescript
+import {
+  markdownToHtml,
+  htmlToMarkdown,
+  normalizeHtmlForMarkdown,
+  cleanHtml,
+  beautifyHtml,
+  removeHtmlAttributes,
+  removeHtmlComments,
+  removeHtmlElements
 } from '@encodeagent/platform-helper-util';
 
-const display = getRecordDisplay(record, entity);
-const createRecord = convertRecordForCreate(record);
-const context = getContextFromRecord(record);
+const html     = markdownToHtml('# Hello World');
+const markdown = htmlToMarkdown('<h1>Hello World</h1>');
+```
+
+### Web Content Processing
+
+```typescript
+import { processWebPage, getMetadata, getRSSFeed } from '@encodeagent/platform-helper-util';
+
+const result = await processWebPage(url, settings);
+const meta   = await getMetadata(url);
+const feed   = await getRSSFeed(feedUrl);
 ```
 
 ### Tree Operations
 
 ```typescript
-import { 
-  getTreeItem, 
-  insertTreeItem, 
+import {
+  getTreeItem,
+  insertTreeItem,
   removeTreeItem,
-  updateTreeItem 
+  replaceTreeItem,
+  updateTreeItem,
+  updateAllTreeItems,
+  getTreeItemPath,
+  getTreeItemHavingPropValue,
+  getTreeItemAndChildrenIds
 } from '@encodeagent/platform-helper-util';
 
-const item = getTreeItem(tree, itemId);
-const newTree = insertTreeItem(tree, parentId, newItem);
-const updatedTree = removeTreeItem(tree, itemId);
+// Find a node by predicate
+const item = getTreeItem(tree, (n) => n.id === targetId);
+
+// Insert relative to a known node
+const updated = insertTreeItem(tree, parentId, newItem, 'children');
+
+// Remove a node by ID
+const pruned = removeTreeItem(tree, itemId);
 ```
 
 ### Caching
 
 ```typescript
-import { 
-  getCache, 
-  setCache, 
-  removeCache 
+import {
+  getCache,
+  setCache,
+  removeCache,
+  getCacheByGroupId,
+  setCacheByGroupId,
+  removeCacheByGroupId,
+  resetCacheByGroupId
 } from '@encodeagent/platform-helper-util';
 
+setCache('myKey', data);
 const cached = getCache('myKey');
-setCache('myKey', data, 60); // Cache for 60 minutes
 removeCache('myKey');
 ```
 
-### ID Generation
+### Object Property Access
 
 ```typescript
-import { 
-  newGuid, 
-  newShortId, 
-  slug 
+import {
+  getPropValueOfObject,
+  getIntValueOfObject,
+  getFloatValueOfObject,
+  getBooleanValueOfObject,
+  getArrayPropValueOfObject,
+  getBooleanPropValue,
+  getObjectPropValue
 } from '@encodeagent/platform-helper-util';
 
-const guid = newGuid(); // '550e8400-e29b-41d4-a716-446655440000'
-const shortId = newShortId(); // 'rJUWbIHOWM'
-const urlSlug = slug('Hello World!'); // 'hello-world'
+// Supports dot-notation for nested paths
+getPropValueOfObject(obj, 'user.address.city');
+
+// Type-coercing accessors with optional defaults
+getIntValueOfObject(obj, 'count', 0);
+getBooleanValueOfObject(obj, 'enabled', false);
+```
+
+### Logging
+
+```typescript
+import { logger, createLogger, LogLevel, Logger } from '@encodeagent/platform-helper-util';
+import type { ILoggerConfig } from '@encodeagent/platform-helper-util';
+
+// Default logger (INFO level)
+logger.info('Starting up');
+logger.warn('Low memory');
+logger.error('Something failed');
+
+// Custom logger
+const log = createLogger({ level: 'debug' });
+log.debug('Detailed trace', { payload });
+log.setLevel('warn');
 ```
 
-## Type Definitions
+### API Helpers
 
-The library exports comprehensive TypeScript types:
+```typescript
+import {
+  sendApiSuccess,
+  sendApiError,
+  sendValidationError,
+  validateContentType,
+  getPostData,
+  getHeaderData,
+  getApiRequestInfo
+} from '@encodeagent/platform-helper-util';
+```
+
+## Key Types
 
 ```typescript
-import type { 
-  IContext, 
-  IError, 
-  IService, 
+import type {
+  IContext,
+  IError,
+  IService,
   ICost,
+  ICostItem,
+  ISurcharge,
+  ICostKey,
   TKeyOwner,
-  TToken,
-  TLLMMessage 
+  IRecord,
+  ILLMRequest,
+  ILLMMessage,
+  IAiModel,
+  TAiModelPlatform,
+  ILoggerConfig,
+  TWebLocation,
+  TColor,
+  TRGB,
+  TRGBA,
+  TFileInfo
 } from '@encodeagent/platform-helper-util';
 ```
 
 ## Constants
 
-Access platform constants and configurations:
-
 ```typescript
-import { 
+import {
   GUID_EMPTY,
   DEFAULT_PASSWORD_RULE,
   COUNTRIES,
   LANGUAGES,
-  ERROR_HTTP_LIST 
+  GENDERS,
+  SURCHARGE,
+  CREDIT_EXCHANGE_RATE,
+  ERROR_HTTP_LIST,
+  // Color palettes
+  BLUE, RED, GREEN, GRAY, SLATE, ZINC, COLORS
 } from '@encodeagent/platform-helper-util';
 ```
 
 ## Development
 
-### Setup
-
 ```bash
 npm install
-```
-
-### Build
-
-```bash
-npm run build
-npm run build:watch
-```
-
-### Test
-
-```bash
-npm test
+npm run build          # compile TypeScript → dist/
+npm run build:watch    # watch mode
+npm test               # run Jest
 npm run test:watch
-```
-
-### Lint
-
-```bash
 npm run lint
 npm run lint:fix
-```
-
-### Clean
-
-```bash
-npm run clean
+npm run format         # auto-format all source files with Prettier
+npm run format:check   # CI check — exits 1 if any file needs formatting
+npm run clean          # remove dist/
 ```
 
 ## Publishing
 
-### Automated Publishing (Recommended)
-
 ```bash
-sh publish.sh
-```
-
-This script will:
-1. Clean previous builds
-2. Run tests
-3. Build the project
-4. Update version automatically
-5. Publish to npm
+# Automated (recommended): clean → test → build → version bump → publish
+sh run-publish.sh
 
-### Manual Publishing
-
-```bash
+# Manual
 npm run prepublishOnly
 npm publish
 ```
 
-## Scripts
-
-- `build` - Compile TypeScript to JavaScript
-- `build:watch` - Watch mode compilation
-- `clean` - Remove dist directory
-- `test` - Run Jest tests
-- `test:watch` - Run tests in watch mode
-- `lint` - Run ESLint
-- `lint:fix` - Fix ESLint issues
-- `prepublishOnly` - Clean and build before publishing
-
 ## License
 
-UNLICENSED - PrimeObjects Software Inc. All rights reserved.
+UNLICENSED — PrimeObjects Software Inc. All rights reserved.

package/dist/api.d.ts

@@ -41,21 +41,41 @@ export interface IApiRequestInfo {
     organizationId?: string;
     solutionId?: string;
 }
+/**
+ * Extracts a minimal, loggable request-identity snapshot from a full `IApiRequestProps` object.
+ * Pulls `userId`, `organizationId`, and `solutionId` from the nested `context` if present.
+ */
 export declare const getApiRequestInfo: (props: IApiRequestProps) => IApiRequestInfo;
 export interface ISendInvalidContentTypeErrorProps extends IApiRequestProps {
     value: string;
 }
+/**
+ * Sends an HTTP 415 Unsupported Media Type error response, informing the client
+ * which `Content-Type` value is required.
+ * @param props.value - The expected Content-Type value (e.g. `"application/json"`)
+ */
 export declare const sendInvalidContentTypeError: (props: ISendInvalidContentTypeErrorProps) => any;
 export interface IValidateContentTypeProps extends IApiRequestProps {
     error: IError;
     value: string;
 }
+/**
+ * Checks that the request's `Content-Type` header contains `props.value`.
+ * Delegates to `validateHeader` with `headerName` fixed to `"Content-Type"`.
+ * Returns `false` (and sends a 415 response via the error prop) when the header does not match.
+ */
 export declare const validateContentType: (props: IValidateContentTypeProps) => boolean;
 export interface IValidateHeaderProps extends IApiRequestProps {
     error: IError;
     headerName: string;
     headerValue: string;
 }
+/**
+ * Checks that a specific request header contains the expected value.
+ * Reads the header using the platform-appropriate API (express / next.js).
+ * Lambda and Azure are not yet implemented and always return `false`.
+ * @returns `true` when the header value contains `props.headerValue`
+ */
 export declare const validateHeader: (props: IValidateHeaderProps) => boolean;
 export interface IApiRequestSuccessProps extends IApiRequestProps {
 }
@@ -75,6 +95,12 @@ export interface IApiRequestErrorResult extends IApiRequestErrorProps {
 /**
  * Send an error API response
  */
+/**
+ * Sends a structured error API response. Merges `package`, `module`, `source`, and `platform`
+ * from `props` into the error object if not already set. Logs the error detail when `logDetail`
+ * is true, and optionally includes the original request body in the response via `includeRequest`.
+ * Lambda and Azure platforms are not yet implemented.
+ */
 export declare const sendApiError: (props: IApiRequestErrorProps) => any;
 /**
  * Handle validation errors from Zod
@@ -93,6 +119,12 @@ export interface IGetPostDataResult {
     error?: any;
     data: Record<string, any>;
 }
+/**
+ * Reads and parses the request body based on platform and `Content-Type` header.
+ * Supports `express` (pre-parsed `req.body` or raw stream fallback) and `nextjs` (`request.json()`).
+ * Lambda and Azure are not yet implemented and return `{ data: {} }`.
+ * Returns `{ error, data: {} }` on parse failure.
+ */
 export declare const getPostData: (props: IGetPostDataProps) => Promise<IGetPostDataResult>;
 export interface IGetHeaderDataProps extends IApiRequestProps {
 }
@@ -104,5 +136,11 @@ export interface IGetHeaderDataResult {
     error?: any;
     data: Record<string, any>;
 }
+/**
+ * Extracts all request headers into a plain lowercase-keyed object.
+ * - `express`: reads from `request.headers` (Node `IncomingHttpHeaders`)
+ * - `nextjs`: reads from `request.headers` (Web `Headers` instance)
+ * Lambda and Azure are not yet implemented and return `{ data: {} }`.
+ */
 export declare const getHeaderData: (props: IGetHeaderDataProps) => Promise<IGetHeaderDataResult>;
 //# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

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