core-services-sdk 1.3.49 → 1.3.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "core-services-sdk",
-  "version": "1.3.49",
+  "version": "1.3.51",
   "main": "src/index.js",
   "type": "module",
   "types": "types/index.d.ts",

package/src/ids/generators.js

@@ -4,12 +4,7 @@ import { ID_PREFIXES } from './prefixes.js'
 /**
  * Generates a new ULID string.
  *
- * ULIDs are 26-character, lexicographically sortable identifiers.
- *
- * @returns {string} A new ULID.
- *
- * @example
- * generateId() // '01HZY3M7K4FJ9A8Q4Y1ZB5NX3T'
+ * @returns {string}
  */
 export const generateId = () => {
   return ulid()
@@ -18,222 +13,140 @@ export const generateId = () => {
 /**
  * Generates a unique ID with the given prefix.
  *
- * @param {string} prefix - A prefix string to prepend to the ULID.
- * @returns {string} A unique ID in the format `${prefix}_${ulid}`.
- *
- * @example
- * generatePrefixedId('usr') // 'usr_01HZY3M7K4FJ9A8Q4Y1ZB5NX3T'
+ * @param {string} prefix
+ * @returns {string}
  */
 export const generatePrefixedId = (prefix) => {
   return `${prefix}_${generateId()}`
 }
 
-/**
- * Generates a user ID with a `usr_` prefix.
- *
- * @returns {string} A user ID.
- */
+/* =========================
+ * Core identity
+ * ========================= */
+
 export const generateUserId = () => generatePrefixedId(ID_PREFIXES.USER)
 
-/**
- * Generates a tenant ID with a `tnt_` prefix.
- *
- * @returns {string} A tenant ID.
- */
 export const generateTenantId = () => generatePrefixedId(ID_PREFIXES.TENANT)
 
-/**
- * Generates a permission ID with a `prm_` prefix.
- *
- * @returns {string} A permission ID.
- */
+export const generateSessionId = () => generatePrefixedId(ID_PREFIXES.SESSION)
+
+export const generateOnboardingId = () =>
+  generatePrefixedId(ID_PREFIXES.ONBOARDING)
+
+/* =========================
+ * Authorization
+ * ========================= */
+
 export const generatePermissionId = () =>
   generatePrefixedId(ID_PREFIXES.PERMISSION)
 
-/**
- * Generates a correlation ID with a `crln_` prefix.
- *
- * @returns {string} A correlation ID.
- */
-export const generateCorrelationId = () =>
-  generatePrefixedId(ID_PREFIXES.CORRELATION)
+export const generateRoleId = () => generatePrefixedId(ID_PREFIXES.ROLE)
+
+export const generateRolePermissionsId = () =>
+  generatePrefixedId(ID_PREFIXES.ROLE_PERMISSION)
 
-/**
- * Generates a verification ID with a `vrf_` prefix.
- *
- * @returns {string} A verification ID.
- */
 export const generateVerificationId = () =>
   generatePrefixedId(ID_PREFIXES.VERIFICATION)
 
-/**
- * Generates a role permissions ID with a `role_` prefix.
- *
- * @returns {string} A role permissions ID.
- */
-export const generateRolePermissionsId = () =>
-  generatePrefixedId(ID_PREFIXES.ROLE_PERMISSIONS)
+/* =========================
+ * Assets & uploads
+ * ========================= */
 
-/**
- * Generates an onboarding ID with a `onb_` prefix.
- *
- * @returns {string} An onboarding ID.
- */
-export const generateOnboardingId = () =>
-  generatePrefixedId(ID_PREFIXES.ONBOARDING)
+export const generateAssetId = () => generatePrefixedId(ID_PREFIXES.ASSET)
 
-/**
- * Generates a session ID with a `sess_` prefix.
- *
- * @returns {string} A session ID.
- */
-export const generateSessionId = () => generatePrefixedId(ID_PREFIXES.SESSION)
+export const generateAssetUploadId = () =>
+  generatePrefixedId(ID_PREFIXES.ASSET_UPLOAD)
+
+/* =========================
+ * Files (legacy)
+ * ========================= */
 
-/**
- * Generates a file ID with a `fil_` prefix.
- *
- * @returns {string} A file ID.
- */
 export const generateFileId = () => generatePrefixedId(ID_PREFIXES.FILE)
 
-/**
- * Generates an event ID with an `evt_` prefix.
- *
- * @returns {string} An event ID.
- */
+/* =========================
+ * Accounting
+ * ========================= */
+
+export const generateSupplierId = () => generatePrefixedId(ID_PREFIXES.SUPPLIER)
+
+export const generateInvoiceId = () => generatePrefixedId(ID_PREFIXES.INVOICE)
+
+export const generateInvoiceItemId = () =>
+  generatePrefixedId(ID_PREFIXES.INVOICE_ITEM)
+
+export const generateInvoiceCorrectionId = () =>
+  generatePrefixedId(ID_PREFIXES.INVOICE_CORRECTION)
+
+/* =========================
+ * AI / document processing
+ * ========================= */
+
+export const generateDocumentDataId = () =>
+  generatePrefixedId(ID_PREFIXES.DOCUMENT_DATA)
+
+/* =========================
+ * Bots / automation
+ * ========================= */
+
+export const generateBotFlowId = () => generatePrefixedId(ID_PREFIXES.BOT_FLOW)
+
+/* =========================
+ * Infra / messaging
+ * ========================= */
+
+export const generateCorrelationId = () =>
+  generatePrefixedId(ID_PREFIXES.CORRELATION)
+
 export const generateEventId = () => generatePrefixedId(ID_PREFIXES.EVENT)
 
-/**
- * Generates a job ID with a `job_` prefix.
- *
- * @returns {string} A job ID.
- */
 export const generateJobId = () => generatePrefixedId(ID_PREFIXES.JOB)
 
-/**
- * Generates a task ID with a `task_` prefix.
- *
- * @returns {string} A task ID.
- */
 export const generateTaskId = () => generatePrefixedId(ID_PREFIXES.TASK)
 
-/**
- * Generates a queue ID with a `que_` prefix.
- *
- * @returns {string} A queue ID.
- */
 export const generateQueueId = () => generatePrefixedId(ID_PREFIXES.QUEUE)
 
-/**
- * Generates a message ID with a `msg_` prefix.
- *
- * @returns {string} A message ID.
- */
 export const generateMessageId = () => generatePrefixedId(ID_PREFIXES.MESSAGE)
 
-/**
- * Generates a notification ID with a `ntf_` prefix.
- *
- * @returns {string} A notification ID.
- */
+/* =========================
+ * Communication
+ * ========================= */
+
+export const generateEmailId = () => generatePrefixedId(ID_PREFIXES.EMAIL)
+
+export const generateIncomingEmailId = () =>
+  generatePrefixedId(ID_PREFIXES.INCOMING_EMAIL)
+
+export const generateImId = () => generatePrefixedId(ID_PREFIXES.IM)
+
 export const generateNotificationId = () =>
   generatePrefixedId(ID_PREFIXES.NOTIFICATION)
 
-/**
- * Generates a log ID with a `log_` prefix.
- *
- * @returns {string} A log ID.
- */
-export const generateLogId = () => generatePrefixedId(ID_PREFIXES.LOG)
+/* =========================
+ * Observability
+ * ========================= */
 
-/**
- * Generates an audit ID with an `adt_` prefix.
- *
- * @returns {string} An audit ID.
- */
 export const generateAuditId = () => generatePrefixedId(ID_PREFIXES.AUDIT)
 
-/**
- * Generates a config ID with a `cfg_` prefix.
- *
- * @returns {string} A config ID.
- */
-export const generateConfigId = () => generatePrefixedId(ID_PREFIXES.CONFIG)
-
-/**
- * Generates a key ID with a `key_` prefix.
- *
- * @returns {string} A key ID.
- */
-export const generateKeyId = () => generatePrefixedId(ID_PREFIXES.KEY)
+export const generateLogId = () => generatePrefixedId(ID_PREFIXES.LOG)
 
-/**
- * Generates a metric ID with a `met_` prefix.
- *
- * @returns {string} A metric ID.
- */
 export const generateMetricId = () => generatePrefixedId(ID_PREFIXES.METRIC)
 
-/**
- * Generates a tag ID with a `tag_` prefix.
- *
- * @returns {string} A tag ID.
- */
-export const generateTagId = () => generatePrefixedId(ID_PREFIXES.TAG)
+/* =========================
+ * Security / config / misc
+ * ========================= */
+
+export const generateKeyId = () => generatePrefixedId(ID_PREFIXES.KEY)
 
-/**
- * Generates a policy ID with a `plc_` prefix.
- *
- * @returns {string} A policy ID.
- */
 export const generatePolicyId = () => generatePrefixedId(ID_PREFIXES.POLICY)
 
-/**
- * Generates a profile ID with a `prf_` prefix.
- *
- * @returns {string} A profile ID.
- */
 export const generateProfileId = () => generatePrefixedId(ID_PREFIXES.PROFILE)
 
-/**
- * Generates a device ID with a `dev_` prefix.
- *
- * @returns {string} A device ID.
- */
 export const generateDeviceId = () => generatePrefixedId(ID_PREFIXES.DEVICE)
 
-/**
- * Generates an alert ID with an `alr_` prefix.
- *
- * @returns {string} An alert ID.
- */
 export const generateAlertId = () => generatePrefixedId(ID_PREFIXES.ALERT)
 
-/**
- * Generates a resource ID with a `res_` prefix.
- *
- * @returns {string} A resource ID.
- */
 export const generateResourceId = () => generatePrefixedId(ID_PREFIXES.RESOURCE)
 
-/**
- * Generates a resource ID with a `ieml_` prefix.
- *
- * @returns {string} An incoming email ID.
- */
-export const generateIncomingEmailId = () =>
-  generatePrefixedId(ID_PREFIXES.INCOMING_EMAIL)
-
-/**
- * Generates a resource ID with a `eml_` prefix.
- *
- * @returns {string} An Email ID.
- */
-export const generateEmailId = () => generatePrefixedId(ID_PREFIXES.EMAIL)
+export const generateTagId = () => generatePrefixedId(ID_PREFIXES.TAG)
 
-/**
- * Generates a resource ID with a `im_` prefix.
- *
- * @returns {string} An Instant Message ID.
- */
-export const generateImId = () => generatePrefixedId(ID_PREFIXES.IM)
+export const generateConfigId = () => generatePrefixedId(ID_PREFIXES.CONFIG)

package/src/ids/prefixes.js

@@ -1,97 +1,93 @@
 /**
  * Mapping of entity types to their unique ID prefixes.
  *
- * These prefixes are prepended to ULIDs to create consistent and identifiable IDs across the system.
- * For example: 'usr_01HZY3M7K4FJ9A8Q4Y1ZB5NX3T'
+ * Prefixes are prepended to ULIDs to create readable,
+ * sortable, and easily identifiable IDs across the system.
+ *
+ * Example:
+ *   ast_01HZY3M7K4FJ9A8Q4Y1ZB5NX3T
  *
  * @readonly
  * @enum {string}
  */
 export const ID_PREFIXES = Object.freeze({
-  /** User entity ID prefix */
+  //////////////////////////////////////////////////////
+  // Core identity
+  //////////////////////////////////////////////////////
   USER: 'usr',
-
-  /** Tenant entity ID prefix */
   TENANT: 'tnt',
+  SESSION: 'sess',
+  ONBOARDING: 'onb',
 
-  /** Permission entity ID prefix */
+  //////////////////////////////////////////////////////
+  // Authorization & access
+  //////////////////////////////////////////////////////
+  ROLE: 'role',
   PERMISSION: 'prm',
-
-  /** Correlation ID prefix (e.g., for tracing requests) */
-  CORRELATION: 'crln',
-
-  /** Verification entity ID prefix (e.g., email/phone code) */
+  ROLE_PERMISSION: 'rprm',
   VERIFICATION: 'vrf',
+  POLICY: 'plc',
+  PROFILE: 'prf',
+  DEVICE: 'dev',
 
-  /** Role-permissions mapping ID prefix */
-  ROLE_PERMISSIONS: 'role',
-
-  /** Onboarding mapping ID prefix */
-  ONBOARDING: 'onb',
-
-  /** Session mapping ID prefix */
-  SESSION: 'sess',
+  //////////////////////////////////////////////////////
+  // Assets & uploads
+  //////////////////////////////////////////////////////
+  ASSET: 'ast',
+  ASSET_UPLOAD: 'aupl',
 
-  /** File mapping ID prefix */
+  // Legacy – kept for backward compatibility
   FILE: 'fil',
 
-  /** Event entity ID prefix */
+  //////////////////////////////////////////////////////
+  // Accounting domain
+  //////////////////////////////////////////////////////
+  SUPPLIER: 'sup',
+  INVOICE: 'inv',
+  INVOICE_ITEM: 'invi',
+  INVOICE_CORRECTION: 'invc',
+
+  //////////////////////////////////////////////////////
+  // AI / document processing
+  //////////////////////////////////////////////////////
+  DOCUMENT_DATA: 'docd',
+
+  //////////////////////////////////////////////////////
+  // Messaging / jobs / infra
+  //////////////////////////////////////////////////////
+  CORRELATION: 'crln',
   EVENT: 'evt',
-
-  /** Job entity ID prefix */
   JOB: 'job',
-
-  /** Task entity ID prefix */
   TASK: 'task',
-
-  /** Queue entity ID prefix */
   QUEUE: 'que',
-
-  /** Message entity ID prefix */
   MESSAGE: 'msg',
-
-  /** Notification entity ID prefix */
   NOTIFICATION: 'ntf',
 
-  /** Log entity ID prefix */
-  LOG: 'log',
+  //////////////////////////////////////////////////////
+  // Communication
+  //////////////////////////////////////////////////////
+  EMAIL: 'eml',
+  INCOMING_EMAIL: 'ieml',
+  IM: 'im',
 
-  /** Audit entity ID prefix */
+  //////////////////////////////////////////////////////
+  // Observability
+  //////////////////////////////////////////////////////
   AUDIT: 'adt',
-
-  /** Config entity ID prefix */
-  CONFIG: 'cfg',
-
-  /** Key entity ID prefix */
-  KEY: 'key',
-
-  /** Metric entity ID prefix */
+  LOG: 'log',
   METRIC: 'met',
 
-  /** Tag entity ID prefix */
+  //////////////////////////////////////////////////////
+  // Misc / config
+  //////////////////////////////////////////////////////
   TAG: 'tag',
-
-  /** Policy entity ID prefix */
-  POLICY: 'plc',
-
-  /** Profile entity ID prefix */
-  PROFILE: 'prf',
-
-  /** Device entity ID prefix */
-  DEVICE: 'dev',
-
-  /** Alert entity ID prefix */
-  ALERT: 'alr',
-
-  /** Resource entity ID prefix */
+  CONFIG: 'cfg',
+  KEY: 'key',
   RESOURCE: 'res',
+  ALERT: 'alr',
 
-  /** Incoming email ID prefix */
-  INCOMING_EMAIL: 'ieml',
-
-  /** Email ID prefix */
-  EMAIL: 'eml',
-
-  /** Instant Message ID prefix */
-  IM: 'im',
+  //////////////////////////////////////////////////////
+  // Bots / automation flows
+  //////////////////////////////////////////////////////
+  BOT_FLOW: 'botf',
 })

package/src/instant-messages/index.js

@@ -2,3 +2,5 @@ export * from './im-platform.js'
 export * from './message-type.js'
 export * from './message-types.js'
 export * from './message-unified-mapper.js'
+export * from './telegram-apis/telegram-apis.js'
+export * from './whatsapp-apis/whatsapp-apis.js'