core-services-sdk 1.3.32 → 1.3.34

package/package.json

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

package/src/mongodb/dsl-to-mongo.js

@@ -97,3 +97,22 @@ export function toMongo(query = {}) {
     }),
   )
 }
+
+export function castIsoDates(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map(castIsoDates)
+  }
+  if (obj && typeof obj === 'object') {
+    for (const [key, value] of Object.entries(obj)) {
+      obj[key] = castIsoDates(value)
+    }
+    return obj
+  }
+  if (typeof obj === 'string' && /^\d{4}-\d{2}-\d{2}T/.test(obj)) {
+    const d = new Date(obj)
+    if (!isNaN(d)) {
+      return d
+    }
+  }
+  return obj
+}

package/tests/mongodb/cast-iso-dates.test.js

@@ -0,0 +1,67 @@
+import { describe, it, expect } from 'vitest'
+
+import { castIsoDates } from '../../src/mongodb/dsl-to-mongo.js'
+
+describe('castIsoDates', () => {
+  it('should convert ISO date strings to Date objects', () => {
+    const input = {
+      createdAt: {
+        $gte: '2025-10-08T00:00:00.000Z',
+        $lte: '2025-10-09T23:59:59.999Z',
+      },
+    }
+
+    const output = castIsoDates(structuredClone(input))
+
+    expect(output.createdAt.$gte).toBeInstanceOf(Date)
+    expect(output.createdAt.$lte).toBeInstanceOf(Date)
+    expect(output.createdAt.$gte.toISOString()).toBe('2025-10-08T00:00:00.000Z')
+    expect(output.createdAt.$lte.toISOString()).toBe('2025-10-09T23:59:59.999Z')
+  })
+
+  it('should recursively convert nested ISO strings', () => {
+    const input = {
+      filters: [
+        { time: '2025-09-01T12:00:00.000Z' },
+        { inner: { deep: '2025-09-02T00:00:00.000Z' } },
+      ],
+    }
+
+    const output = castIsoDates(structuredClone(input))
+
+    expect(output.filters[0].time).toBeInstanceOf(Date)
+    expect(output.filters[1].inner.deep).toBeInstanceOf(Date)
+  })
+
+  it('should not modify non-date strings or numbers', () => {
+    const input = {
+      name: 'hello',
+      value: 123,
+      notIso: '2025-09-01', // missing 'T' — not ISO format
+    }
+
+    const output = castIsoDates(structuredClone(input))
+
+    expect(output.name).toBe('hello')
+    expect(output.value).toBe(123)
+    expect(output.notIso).toBe('2025-09-01')
+  })
+
+  it('should handle arrays directly', () => {
+    const input = ['2025-10-01T10:00:00.000Z', 'not-a-date', 5]
+
+    const output = castIsoDates(structuredClone(input))
+
+    expect(output[0]).toBeInstanceOf(Date)
+    expect(output[1]).toBe('not-a-date')
+    expect(output[2]).toBe(5)
+  })
+
+  it('should leave null and undefined unchanged', () => {
+    const input = { a: null, b: undefined }
+    const output = castIsoDates(structuredClone(input))
+
+    expect(output.a).toBeNull()
+    expect(output.b).toBeUndefined()
+  })
+})

package/types/ids/generators.d.ts

@@ -8,3 +8,21 @@ export function generateVerificationId(): string;
 export function generateRolePermissionsId(): string;
 export function generateOnboardingId(): string;
 export function generateSessionId(): string;
+export function generateFileId(): string;
+export function generateEventId(): string;
+export function generateJobId(): string;
+export function generateTaskId(): string;
+export function generateQueueId(): string;
+export function generateMessageId(): string;
+export function generateNotificationId(): string;
+export function generateLogId(): string;
+export function generateAuditId(): string;
+export function generateConfigId(): string;
+export function generateKeyId(): string;
+export function generateMetricId(): string;
+export function generateTagId(): string;
+export function generatePolicyId(): string;
+export function generateProfileId(): string;
+export function generateDeviceId(): string;
+export function generateAlertId(): string;
+export function generateResourceId(): string;

package/types/ids/prefixes.d.ts

@@ -31,4 +31,40 @@ export const ID_PREFIXES: Readonly<{
     ONBOARDING: "onb";
     /** Session mapping ID prefix */
     SESSION: "sess";
+    /** File mapping ID prefix */
+    FILE: "fil";
+    /** Event entity ID prefix */
+    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";
+    /** Audit entity ID prefix */
+    AUDIT: "adt";
+    /** Config entity ID prefix */
+    CONFIG: "cfg";
+    /** Key entity ID prefix */
+    KEY: "key";
+    /** Metric entity ID prefix */
+    METRIC: "met";
+    /** Tag entity ID prefix */
+    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 */
+    RESOURCE: "res";
 }>;

package/types/mongodb/connect.d.ts

@@ -1,4 +1,7 @@
-export function mongoConnect({ uri, serverApi }: {
+export function mongoConnect({ uri, serverApi, timeout, retries, }: {
     uri: string;
     serverApi?: object;
-}): Promise<import("mongodb").MongoClient>;
+    timeout?: number;
+    retries?: number;
+}): Promise<MongoClient>;
+import { MongoClient } from 'mongodb';

package/types/mongodb/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./connect.js";
+export * from "./paginate.js";
 export * from "./dsl-to-mongo.js";
 export * from "./initialize-mongodb.js";
 export * from "./validate-mongo-uri.js";

package/types/mongodb/paginate.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pagination with SQL-like ascending/descending
+ *
+ * @param {import('mongodb').Collection} collection
+ * @param {Object} options
+ * @param {Object} [options.filter={}]
+ * @param {string} [options.cursorField='_id']
+ * @param {string|Date|ObjectId} [options.cursor]
+ * @param {'asc'|'desc'} [options.order='asc']
+ * @param {number} [options.limit=10]
+ */
+export function paginate(collection: import("mongodb").Collection, { limit, projection, filter, cursor, order, cursorField, }?: {
+    filter?: any;
+    cursorField?: string;
+    cursor?: string | Date | ObjectId;
+    order?: "asc" | "desc";
+    limit?: number;
+}): Promise<{
+    order: "desc" | "asc";
+    list: import("mongodb").WithId<import("bson").Document>[];
+    previous: any;
+    next: any;
+}>;
+import { ObjectId } from 'mongodb';

package/types/util/context.d.ts

@@ -0,0 +1,55 @@
+export namespace Context {
+    /**
+     * Run a callback within a given context store.
+     * Everything `await`ed or invoked inside this callback will have access
+     * to the provided store via {@link Context.get}, {@link Context.set}, or {@link Context.all}.
+     *
+     * @template T
+     * @param {Record<string, any>} store
+     * @param {() => T} callback - Function to execute inside the context.
+     * @returns {T} The return value of the callback (sync or async).
+     *
+     * @example
+     * Context.run(
+     *   { correlationId: 'abc123' },
+     *   async () => {
+     *     console.log(Context.get('correlationId')) // "abc123"
+     *   }
+     * )
+     */
+    function run<T>(store: Record<string, any>, callback: () => T): T;
+    /**
+     * Retrieve a single value from the current async context store.
+     *
+     * @template T
+     * @param {string} key - The key of the value to retrieve.
+     * @returns {T|undefined} The stored value, or `undefined` if no store exists or key not found.
+     *
+     * @example
+     * const userId = Context.get('userId')
+     */
+    function get<T>(key: string): T | undefined;
+    /**
+     * Set a single key-value pair in the current async context store.
+     * If there is no active store (i.e. outside of a {@link Context.run}),
+     * this function does nothing.
+     *
+     * @param {string} key - The key under which to store the value.
+     * @param {any} value - The value to store.
+     *
+     * @example
+     * Context.set('tenantId', 'tnt_1234')
+     */
+    function set(key: string, value: any): void;
+    /**
+     * Get the entire store object for the current async context.
+     *
+     * @returns {Record<string, any>} The current store object,
+     * or an empty object if no store exists.
+     *
+     * @example
+     * const all = Context.all()
+     * console.log(all) // { correlationId: 'abc123', userId: 'usr_789' }
+     */
+    function all(): Record<string, any>;
+}

package/types/util/index.d.ts

@@ -2,6 +2,7 @@ export namespace util {
     export { mask };
     export { maskSingle };
 }
+export { Context } from "./context.js";
 import { mask } from './mask-sensitive.js';
 import { maskSingle } from './mask-sensitive.js';
 export { mask, maskSingle };