aws-service-stack 0.18.372 → 0.18.374

package/dist/service/permission.service.d.ts

@@ -0,0 +1,39 @@
+import { Permission } from "../model/role.model";
+/**
+ * PermissionService — cache + orchestration layer for Permission entities.
+ *
+ * Design decisions:
+ * - Read-through cache via PermissionCache (in-flight dedup, TTL).
+ * - Repository handles only DB I/O.
+ * - Cache invalidation on every mutation.
+ * - ~100 roles total, read-heavy → caching makes sense.
+ * - Cache keyed by `perm:{permissionKey}` for deterministic, namespaced lookup.
+ */
+export declare class PermissionService {
+    private readonly repo;
+    private readonly cache;
+    constructor(tableName: string, cacheTtlMs?: number);
+    /** Fetch Permission by composite key (role#resource#scope). Read-through cached. */
+    getPermissionByKey(permissionKey: string): Promise<Permission | null>;
+    /** Fetch Permission by id. Read-through cached. */
+    getPermissionById(id: string): Promise<Permission | null>;
+    /**
+     * Check if the given role+resource+scope has a specific HTTP method allowed.
+     *
+     * Builds the permissionKey `role#resource#scope`, fetches the Permission,
+     * and checks the method map.
+     *
+     * @returns `true` if allowed, `false` otherwise.
+     */
+    hasPermission(role: string, resource: string, scope: string, method: string): Promise<boolean>;
+    createPermission(input: {
+        role: string;
+        resource: string;
+        scope: string;
+        method: Permission["method"];
+    }): Promise<Permission>;
+    updatePermission(id: string, updates: Partial<Pick<Permission, "role" | "resource" | "scope" | "method">>): Promise<Permission>;
+    deletePermission(id: string): Promise<boolean>;
+    listPermissions(): Promise<Permission[]>;
+    clearCache(): void;
+}

package/dist/service/permission.service.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PermissionService = void 0;
+const exception_1 = require("../exception");
+const permission_cache_1 = require("./permission.cache");
+const permission_repo_1 = require("./permission.repo");
+/**
+ * PermissionService — cache + orchestration layer for Permission entities.
+ *
+ * Design decisions:
+ * - Read-through cache via PermissionCache (in-flight dedup, TTL).
+ * - Repository handles only DB I/O.
+ * - Cache invalidation on every mutation.
+ * - ~100 roles total, read-heavy → caching makes sense.
+ * - Cache keyed by `perm:{permissionKey}` for deterministic, namespaced lookup.
+ */
+class PermissionService {
+    repo;
+    cache;
+    constructor(tableName, cacheTtlMs) {
+        this.repo = new permission_repo_1.PermissionRepo(tableName);
+        this.cache = new permission_cache_1.PermissionCache(cacheTtlMs);
+    }
+    // ---------------------------------------------------------------------------
+    // Core lookup
+    // ---------------------------------------------------------------------------
+    /** Fetch Permission by composite key (role#resource#scope). Read-through cached. */
+    async getPermissionByKey(permissionKey) {
+        if (!permissionKey)
+            return null;
+        return this.cache.getOrFetch(`perm:${permissionKey}`, () => this.repo.findByPermissionKey(permissionKey));
+    }
+    /** Fetch Permission by id. Read-through cached. */
+    async getPermissionById(id) {
+        if (!id)
+            return null;
+        return this.cache.getOrFetch(`id:${id}`, () => this.repo.findById(id));
+    }
+    // ---------------------------------------------------------------------------
+    // Permission check
+    // ---------------------------------------------------------------------------
+    /**
+     * Check if the given role+resource+scope has a specific HTTP method allowed.
+     *
+     * Builds the permissionKey `role#resource#scope`, fetches the Permission,
+     * and checks the method map.
+     *
+     * @returns `true` if allowed, `false` otherwise.
+     */
+    async hasPermission(role, resource, scope, method) {
+        if (!role || !resource || !scope || !method)
+            return false;
+        const permissionKey = `${role}#${resource}#${scope}`;
+        const permission = await this.getPermissionByKey(permissionKey);
+        if (!permission?.method)
+            return false;
+        const methodLower = method.toUpperCase();
+        return permission.method[methodLower] === true;
+    }
+    // ---------------------------------------------------------------------------
+    // CRUD — create
+    // ---------------------------------------------------------------------------
+    async createPermission(input) {
+        if (!input.role?.trim()) {
+            throw new exception_1.ErrorHttp({ code: 400, error: "BadRequest" }, "Role is required");
+        }
+        if (!input.resource?.trim()) {
+            throw new exception_1.ErrorHttp({ code: 400, error: "BadRequest" }, "Resource is required");
+        }
+        if (!input.scope?.trim()) {
+            throw new exception_1.ErrorHttp({ code: 400, error: "BadRequest" }, "Scope is required");
+        }
+        // Duplicate check
+        const permissionKey = `${input.role}#${input.resource}#${input.scope}`;
+        const existing = await this.repo.findByPermissionKey(permissionKey);
+        if (existing) {
+            throw new exception_1.ErrorHttp({ code: 409, error: "Conflict" }, `Permission "${permissionKey}" already exists`);
+        }
+        const saved = await this.repo.save({
+            role: input.role.trim(),
+            resource: input.resource.trim(),
+            scope: input.scope.trim(),
+            method: input.method ?? {},
+            permissionKey,
+        });
+        this.cache.clear();
+        return saved;
+    }
+    // ---------------------------------------------------------------------------
+    // CRUD — update
+    // ---------------------------------------------------------------------------
+    async updatePermission(id, updates) {
+        if (!id)
+            throw new exception_1.ErrorHttp({ code: 400, error: "BadRequest" }, "Permission id is required");
+        const existing = await this.repo.findById(id);
+        if (!existing)
+            throw new exception_1.ErrorHttp({ code: 404, error: "NotFound" }, `Permission "${id}" not found`);
+        const data = { id };
+        if (updates.role !== undefined)
+            data.role = updates.role.trim();
+        if (updates.resource !== undefined)
+            data.resource = updates.resource.trim();
+        if (updates.scope !== undefined)
+            data.scope = updates.scope.trim();
+        if (updates.method !== undefined)
+            data.method = updates.method;
+        // Rebuild key if any key component changed
+        const role = data.role ?? existing.role;
+        const resource = data.resource ?? existing.resource;
+        const scope = data.scope ?? existing.scope;
+        data.permissionKey = `${role}#${resource}#${scope}`;
+        // Check for duplicate key if components changed
+        if (data.permissionKey !== existing.permissionKey) {
+            const conflict = await this.repo.findByPermissionKey(data.permissionKey);
+            if (conflict) {
+                throw new exception_1.ErrorHttp({ code: 409, error: "Conflict" }, `Permission "${data.permissionKey}" already exists`);
+            }
+        }
+        const updated = await this.repo.update(data);
+        this.cache.clear();
+        return updated;
+    }
+    // ---------------------------------------------------------------------------
+    // CRUD — delete
+    // ---------------------------------------------------------------------------
+    async deletePermission(id) {
+        if (!id)
+            throw new exception_1.ErrorHttp({ code: 400, error: "BadRequest" }, "Permission id is required");
+        const existing = await this.repo.findById(id);
+        if (!existing)
+            throw new exception_1.ErrorHttp({ code: 404, error: "NotFound" }, `Permission "${id}" not found`);
+        const result = await this.repo.delete(id);
+        this.cache.clear();
+        return result;
+    }
+    // ---------------------------------------------------------------------------
+    // CRUD — list
+    // ---------------------------------------------------------------------------
+    async listPermissions() {
+        const result = await this.repo.scan();
+        return (result.items ?? []);
+    }
+    // ---------------------------------------------------------------------------
+    // Cache control (for testing)
+    // ---------------------------------------------------------------------------
+    clearCache() {
+        this.cache.clear();
+    }
+}
+exports.PermissionService = PermissionService;
+//# sourceMappingURL=permission.service.js.map

package/dist/service/permission.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.service.js","sourceRoot":"","sources":["../../src/service/permission.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Permission } from \"../model/role.model\";\nimport { ErrorHttp } from \"../exception\";\nimport { PermissionCache } from \"./permission.cache\";\nimport { PermissionRepo } from \"./permission.repo\";\n\n/**\n * PermissionService — cache + orchestration layer for Permission entities.\n *\n * Design decisions:\n * - Read-through cache via PermissionCache (in-flight dedup, TTL).\n * - Repository handles only DB I/O.\n * - Cache invalidation on every mutation.\n * - ~100 roles total, read-heavy → caching makes sense.\n * - Cache keyed by `perm:{permissionKey}` for deterministic, namespaced lookup.\n */\nexport class PermissionService {\n  private readonly repo: PermissionRepo;\n  private readonly cache: PermissionCache;\n\n  constructor(tableName: string, cacheTtlMs?: number) {\n    this.repo = new PermissionRepo(tableName);\n    this.cache = new PermissionCache(cacheTtlMs);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Core lookup\n  // ---------------------------------------------------------------------------\n\n  /** Fetch Permission by composite key (role#resource#scope). Read-through cached. */\n  async getPermissionByKey(permissionKey: string): Promise<Permission | null> {\n    if (!permissionKey) return null;\n\n    return this.cache.getOrFetch(`perm:${permissionKey}`, () => this.repo.findByPermissionKey(permissionKey));\n  }\n\n  /** Fetch Permission by id. Read-through cached. */\n  async getPermissionById(id: string): Promise<Permission | null> {\n    if (!id) return null;\n\n    return this.cache.getOrFetch(`id:${id}`, () => this.repo.findById(id));\n  }\n\n  // ---------------------------------------------------------------------------\n  // Permission check\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Check if the given role+resource+scope has a specific HTTP method allowed.\n   *\n   * Builds the permissionKey `role#resource#scope`, fetches the Permission,\n   * and checks the method map.\n   *\n   * @returns `true` if allowed, `false` otherwise.\n   */\n  async hasPermission(role: string, resource: string, scope: string, method: string): Promise<boolean> {\n    if (!role || !resource || !scope || !method) return false;\n\n    const permissionKey = `${role}#${resource}#${scope}`;\n    const permission = await this.getPermissionByKey(permissionKey);\n    if (!permission?.method) return false;\n\n    const methodLower = method.toUpperCase() as keyof Permission[\"method\"];\n\n    return permission.method[methodLower] === true;\n  }\n\n  // ---------------------------------------------------------------------------\n  // CRUD — create\n  // ---------------------------------------------------------------------------\n\n  async createPermission(input: {\n    role: string;\n    resource: string;\n    scope: string;\n    method: Permission[\"method\"];\n  }): Promise<Permission> {\n    if (!input.role?.trim()) {\n      throw new ErrorHttp({ code: 400, error: \"BadRequest\" }, \"Role is required\");\n    }\n    if (!input.resource?.trim()) {\n      throw new ErrorHttp({ code: 400, error: \"BadRequest\" }, \"Resource is required\");\n    }\n    if (!input.scope?.trim()) {\n      throw new ErrorHttp({ code: 400, error: \"BadRequest\" }, \"Scope is required\");\n    }\n\n    // Duplicate check\n    const permissionKey = `${input.role}#${input.resource}#${input.scope}`;\n    const existing = await this.repo.findByPermissionKey(permissionKey);\n    if (existing) {\n      throw new ErrorHttp({ code: 409, error: \"Conflict\" }, `Permission \"${permissionKey}\" already exists`);\n    }\n\n    const saved = await this.repo.save({\n      role: input.role.trim(),\n      resource: input.resource.trim(),\n      scope: input.scope.trim(),\n      method: input.method ?? {},\n      permissionKey,\n    });\n\n    this.cache.clear();\n    return saved;\n  }\n\n  // ---------------------------------------------------------------------------\n  // CRUD — update\n  // ---------------------------------------------------------------------------\n\n  async updatePermission(\n    id: string,\n    updates: Partial<Pick<Permission, \"role\" | \"resource\" | \"scope\" | \"method\">>,\n  ): Promise<Permission> {\n    if (!id) throw new ErrorHttp({ code: 400, error: \"BadRequest\" }, \"Permission id is required\");\n\n    const existing = await this.repo.findById(id);\n    if (!existing) throw new ErrorHttp({ code: 404, error: \"NotFound\" }, `Permission \"${id}\" not found`);\n\n    const data: Partial<Permission> = { id };\n    if (updates.role !== undefined) data.role = updates.role.trim();\n    if (updates.resource !== undefined) data.resource = updates.resource.trim();\n    if (updates.scope !== undefined) data.scope = updates.scope.trim();\n    if (updates.method !== undefined) data.method = updates.method;\n\n    // Rebuild key if any key component changed\n    const role = data.role ?? existing.role;\n    const resource = data.resource ?? existing.resource;\n    const scope = data.scope ?? existing.scope;\n    data.permissionKey = `${role}#${resource}#${scope}`;\n\n    // Check for duplicate key if components changed\n    if (data.permissionKey !== existing.permissionKey) {\n      const conflict = await this.repo.findByPermissionKey(data.permissionKey);\n      if (conflict) {\n        throw new ErrorHttp({ code: 409, error: \"Conflict\" }, `Permission \"${data.permissionKey}\" already exists`);\n      }\n    }\n\n    const updated = await this.repo.update(data);\n\n    this.cache.clear();\n    return updated;\n  }\n\n  // ---------------------------------------------------------------------------\n  // CRUD — delete\n  // ---------------------------------------------------------------------------\n\n  async deletePermission(id: string): Promise<boolean> {\n    if (!id) throw new ErrorHttp({ code: 400, error: \"BadRequest\" }, \"Permission id is required\");\n\n    const existing = await this.repo.findById(id);\n    if (!existing) throw new ErrorHttp({ code: 404, error: \"NotFound\" }, `Permission \"${id}\" not found`);\n\n    const result = await this.repo.delete(id);\n\n    this.cache.clear();\n    return result;\n  }\n\n  // ---------------------------------------------------------------------------\n  // CRUD — list\n  // ---------------------------------------------------------------------------\n\n  async listPermissions(): Promise<Permission[]> {\n    const result = await this.repo.scan();\n    return (result.items ?? []) as Permission[];\n  }\n\n  // ---------------------------------------------------------------------------\n  // Cache control (for testing)\n  // ---------------------------------------------------------------------------\n\n  clearCache(): void {\n    this.cache.clear();\n  }\n}\n"]}

package/dist/utils/date.util.d.ts

@@ -3,16 +3,3 @@ export declare function isValidDate(dateStr: string): boolean;
 export declare function isSameYearMonth(date1: string | Date | Dayjs, date2: string | Date | Dayjs): boolean;
 export declare function isCurrentMonth(date: string | Date | Dayjs): boolean;
 export declare function isFutureMonth(date: string): boolean;
-export declare function addSecondToDate(date: string | Date | Dayjs): Dayjs;
-/**
- * Returns the oldest date string from a list of date strings.
- * @param dateStrList List of date strings (ISO or other formats supported by dayjs).
- * @returns The oldest date string, or an empty string if the list is empty.
- */
-export declare function minDateStr(dateStrList: any[]): string;
-/**
- * Returns the newest date string from a list of date strings.
- * @param dateStrList List of date strings (ISO or other formats supported by dayjs).
- * @returns The newest date string, or an empty string if the list is empty.
- */
-export declare function maxDateStr(dateStrList: any[]): string;

package/dist/utils/date.util.js

@@ -7,9 +7,6 @@ exports.isValidDate = isValidDate;
 exports.isSameYearMonth = isSameYearMonth;
 exports.isCurrentMonth = isCurrentMonth;
 exports.isFutureMonth = isFutureMonth;
-exports.addSecondToDate = addSecondToDate;
-exports.minDateStr = minDateStr;
-exports.maxDateStr = maxDateStr;
 const dayjs_1 = __importDefault(require("dayjs"));
 function isValidDate(dateStr) {
     const d = new Date(dateStr);
@@ -34,36 +31,4 @@ function isFutureMonth(date) {
     // Compare year-month
     return inputYear > currentYear || (inputYear === currentYear && inputMonth > currentMonth);
 }
-function addSecondToDate(date) {
-    return (0, dayjs_1.default)(date).add(1, "second");
-}
-/**
- * Returns the oldest date string from a list of date strings.
- * @param dateStrList List of date strings (ISO or other formats supported by dayjs).
- * @returns The oldest date string, or an empty string if the list is empty.
- */
-function minDateStr(dateStrList) {
-    return minMaxDateStr(dateStrList, false);
-}
-/**
- * Returns the newest date string from a list of date strings.
- * @param dateStrList List of date strings (ISO or other formats supported by dayjs).
- * @returns The newest date string, or an empty string if the list is empty.
- */
-function maxDateStr(dateStrList) {
-    return minMaxDateStr(dateStrList, true);
-}
-function minMaxDateStr(dateStrList, isMax) {
-    if (!dateStrList || dateStrList.length === 0)
-        return "";
-    const filtered = dateStrList.filter((d) => !!d);
-    if (filtered.length === 0)
-        return "";
-    return filtered.reduce((newestDate, current) => {
-        if (isMax)
-            return (0, dayjs_1.default)(current).isAfter((0, dayjs_1.default)(newestDate)) ? current : newestDate;
-        else
-            return (0, dayjs_1.default)(current).isBefore((0, dayjs_1.default)(newestDate)) ? newestDate : current;
-    });
-}
 //# sourceMappingURL=date.util.js.map

package/dist/utils/date.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.util.js","sourceRoot":"","sources":["../../src/utils/date.util.ts"],"names":[],"mappings":";;;;;AAEA,kCAGC;AAED,0CAIC;AAED,wCAEC;AAED,sCAYC;AAED,0CAEC;AAMD,gCAEC;AAOD,gCAEC;AAlDD,kDAAqC;AAErC,SAAgB,WAAW,CAAC,OAAe;IACzC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,eAAe,CAAC,KAA4B,EAAE,KAA4B;IACxF,MAAM,EAAE,GAAG,IAAA,eAAK,EAAC,KAAK,CAAC,CAAC;IACxB,MAAM,EAAE,GAAG,IAAA,eAAK,EAAC,KAAK,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED,SAAgB,cAAc,CAAC,IAA2B;IACxD,OAAO,eAAe,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;IAEzB,yBAAyB;IACzB,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,oBAAoB;IAC7D,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAEtC,qBAAqB;IACrB,OAAO,SAAS,GAAG,WAAW,IAAI,CAAC,SAAS,KAAK,WAAW,IAAI,UAAU,GAAG,YAAY,CAAC,CAAC;AAC7F,CAAC;AAED,SAAgB,eAAe,CAAC,IAA2B;IACzD,OAAO,IAAA,eAAK,EAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AACD;;;;GAIG;AACH,SAAgB,UAAU,CAAC,WAAkB;IAC3C,OAAO,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,WAAkB;IAC3C,OAAO,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,aAAa,CAAC,WAAkB,EAAE,KAAc;IACvD,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAExD,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE;QAC7C,IAAI,KAAK;YAAE,OAAO,IAAA,eAAK,EAAC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAA,eAAK,EAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;;YAC9E,OAAO,IAAA,eAAK,EAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAA,eAAK,EAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;IAChF,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import dayjs, { Dayjs } from \"dayjs\";\n\nexport function isValidDate(dateStr: string): boolean {\n  const d = new Date(dateStr);\n  return !Number.isNaN(d.getTime());\n}\n\nexport function isSameYearMonth(date1: string | Date | Dayjs, date2: string | Date | Dayjs): boolean {\n  const d1 = dayjs(date1);\n  const d2 = dayjs(date2);\n  return d1.isSame(d2, \"month\") && d1.isSame(d2, \"year\");\n}\n\nexport function isCurrentMonth(date: string | Date | Dayjs): boolean {\n  return isSameYearMonth(date, new Date());\n}\n\nexport function isFutureMonth(date: string): boolean {\n  const inputDate = new Date(date);\n  const today = new Date();\n\n  // Extract year and month\n  const inputYear = inputDate.getFullYear();\n  const inputMonth = inputDate.getMonth(); // 0-based (0 = Jan)\n  const currentYear = today.getFullYear();\n  const currentMonth = today.getMonth();\n\n  // Compare year-month\n  return inputYear > currentYear || (inputYear === currentYear && inputMonth > currentMonth);\n}\n\nexport function addSecondToDate(date: string | Date | Dayjs): Dayjs {\n  return dayjs(date).add(1, \"second\");\n}\n/**\n * Returns the oldest date string from a list of date strings.\n * @param dateStrList List of date strings (ISO or other formats supported by dayjs).\n * @returns The oldest date string, or an empty string if the list is empty.\n */\nexport function minDateStr(dateStrList: any[]): string {\n  return minMaxDateStr(dateStrList, false);\n}\n\n/**\n * Returns the newest date string from a list of date strings.\n * @param dateStrList List of date strings (ISO or other formats supported by dayjs).\n * @returns The newest date string, or an empty string if the list is empty.\n */\nexport function maxDateStr(dateStrList: any[]): string {\n  return minMaxDateStr(dateStrList, true);\n}\n\nfunction minMaxDateStr(dateStrList: any[], isMax: boolean): string {\n  if (!dateStrList || dateStrList.length === 0) return \"\";\n\n  const filtered = dateStrList.filter((d) => !!d);\n  if (filtered.length === 0) return \"\";\n\n  return filtered.reduce((newestDate, current) => {\n    if (isMax) return dayjs(current).isAfter(dayjs(newestDate)) ? current : newestDate;\n    else return dayjs(current).isBefore(dayjs(newestDate)) ? newestDate : current;\n  });\n}\n"]}
+{"version":3,"file":"date.util.js","sourceRoot":"","sources":["../../src/utils/date.util.ts"],"names":[],"mappings":";;;;;AACA,kCAGC;AAED,0CAIC;AAED,wCAEC;AAED,sCAYC;AA5BD,kDAAqC;AACrC,SAAgB,WAAW,CAAC,OAAe;IACzC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,eAAe,CAAC,KAA4B,EAAE,KAA4B;IACxF,MAAM,EAAE,GAAG,IAAA,eAAK,EAAC,KAAK,CAAC,CAAC;IACxB,MAAM,EAAE,GAAG,IAAA,eAAK,EAAC,KAAK,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED,SAAgB,cAAc,CAAC,IAA2B;IACxD,OAAO,eAAe,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;IAEzB,yBAAyB;IACzB,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,oBAAoB;IAC7D,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAEtC,qBAAqB;IACrB,OAAO,SAAS,GAAG,WAAW,IAAI,CAAC,SAAS,KAAK,WAAW,IAAI,UAAU,GAAG,YAAY,CAAC,CAAC;AAC7F,CAAC","sourcesContent":["import dayjs, { Dayjs } from \"dayjs\";\nexport function isValidDate(dateStr: string): boolean {\n  const d = new Date(dateStr);\n  return !Number.isNaN(d.getTime());\n}\n\nexport function isSameYearMonth(date1: string | Date | Dayjs, date2: string | Date | Dayjs): boolean {\n  const d1 = dayjs(date1);\n  const d2 = dayjs(date2);\n  return d1.isSame(d2, \"month\") && d1.isSame(d2, \"year\");\n}\n\nexport function isCurrentMonth(date: string | Date | Dayjs): boolean {\n  return isSameYearMonth(date, new Date());\n}\n\nexport function isFutureMonth(date: string): boolean {\n  const inputDate = new Date(date);\n  const today = new Date();\n\n  // Extract year and month\n  const inputYear = inputDate.getFullYear();\n  const inputMonth = inputDate.getMonth(); // 0-based (0 = Jan)\n  const currentYear = today.getFullYear();\n  const currentMonth = today.getMonth();\n\n  // Compare year-month\n  return inputYear > currentYear || (inputYear === currentYear && inputMonth > currentMonth);\n}\n"]}

package/dist/utils/index.d.ts

@@ -12,5 +12,4 @@ export * from "./reflection.util";
 export * from "./validation.util";
 export * from "./opensearch/opensearch.parser";
 export * from "./opensearch/opensearch.transform";
-export * from "./data.util";
 export * from "../function/logger";

package/dist/utils/index.js

@@ -28,6 +28,5 @@ __exportStar(require("./reflection.util"), exports);
 __exportStar(require("./validation.util"), exports);
 __exportStar(require("./opensearch/opensearch.parser"), exports);
 __exportStar(require("./opensearch/opensearch.transform"), exports);
-__exportStar(require("./data.util"), exports);
 __exportStar(require("../function/logger"), exports);
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,sDAAoC;AACpC,+CAA6B;AAC7B,8CAA4B;AAC5B,8CAA4B;AAC5B,mDAAiC;AACjC,6CAA2B;AAC3B,+CAA6B;AAC7B,8CAA4B;AAC5B,qDAAmC;AACnC,oDAAkC;AAClC,oDAAkC;AAClC,iEAA+C;AAC/C,oEAAkD;AAClD,8CAA4B;AAE5B,qDAAmC","sourcesContent":["export * from \"./http/http.util\";\nexport * from \"./http/http-request\";\nexport * from \"./array.util\";\nexport * from \"./auth.util\";\nexport * from \"./date.util\";\nexport * from \"./dynamodb.utils\";\nexport * from \"./env.util\";\nexport * from \"./error.util\";\nexport * from \"./json.util\";\nexport * from \"./opensearch.utils\";\nexport * from \"./reflection.util\";\nexport * from \"./validation.util\";\nexport * from \"./opensearch/opensearch.parser\";\nexport * from \"./opensearch/opensearch.transform\";\nexport * from \"./data.util\";\n\nexport * from \"../function/logger\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,sDAAoC;AACpC,+CAA6B;AAC7B,8CAA4B;AAC5B,8CAA4B;AAC5B,mDAAiC;AACjC,6CAA2B;AAC3B,+CAA6B;AAC7B,8CAA4B;AAC5B,qDAAmC;AACnC,oDAAkC;AAClC,oDAAkC;AAClC,iEAA+C;AAC/C,oEAAkD;AAElD,qDAAmC","sourcesContent":["export * from \"./http/http.util\";\nexport * from \"./http/http-request\";\nexport * from \"./array.util\";\nexport * from \"./auth.util\";\nexport * from \"./date.util\";\nexport * from \"./dynamodb.utils\";\nexport * from \"./env.util\";\nexport * from \"./error.util\";\nexport * from \"./json.util\";\nexport * from \"./opensearch.utils\";\nexport * from \"./reflection.util\";\nexport * from \"./validation.util\";\nexport * from \"./opensearch/opensearch.parser\";\nexport * from \"./opensearch/opensearch.transform\";\n\nexport * from \"../function/logger\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aws-service-stack",
-  "version": "0.18.372",
+  "version": "0.18.374",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "author": "chinggis.systems",
@@ -23,45 +23,45 @@
     "tslib": "^2.8.1"
   },
   "peerDependencies": {
-    "@aws-sdk/client-api-gateway": "^3.999.0",
-    "@aws-sdk/client-apigatewaymanagementapi": "^3.999.0",
-    "@aws-sdk/client-cognito-identity-provider": "^3.999.0",
-    "@aws-sdk/client-dynamodb": "^3.999.0",
-    "@aws-sdk/client-lambda": "^3.999.0",
-    "@aws-sdk/client-pinpoint": "^3.999.0",
-    "@aws-sdk/client-secrets-manager": "^3.999.0",
-    "@aws-sdk/client-sqs": "^3.999.0",
-    "@aws-sdk/credential-provider-node": "^3.972.14",
-    "@aws-sdk/lib-dynamodb": "^3.999.0",
-    "@aws-sdk/s3-request-presigner": "^3.999.0",
-    "@aws-sdk/util-dynamodb": "^3.996.1",
+    "@aws-sdk/client-api-gateway": "^3.907.0",
+    "@aws-sdk/client-apigatewaymanagementapi": "^3.907.0",
+    "@aws-sdk/client-cognito-identity-provider": "^3.907.0",
+    "@aws-sdk/client-dynamodb": "^3.907.0",
+    "@aws-sdk/client-lambda": "^3.907.0",
+    "@aws-sdk/client-pinpoint": "^3.907.0",
+    "@aws-sdk/client-secrets-manager": "^3.907.0",
+    "@aws-sdk/client-sqs": "^3.907.0",
+    "@aws-sdk/credential-provider-node": "^3.907.0",
+    "@aws-sdk/lib-dynamodb": "^3.907.0",
+    "@aws-sdk/s3-request-presigner": "^3.907.0",
+    "@aws-sdk/util-dynamodb": "^3.907.0",
     "@opensearch-project/opensearch": "^3.5.1",
-    "axios": "^1.13.5",
-    "dayjs": "^1.11.19",
-    "elastic-builder": "^4.1.0",
+    "axios": "^1.12.2",
+    "dayjs": "^1.11.10",
+    "elastic-builder": "^3.4.0",
     "lodash.truncate": "^4.4.2",
-    "nodemailer": "^8.0.1",
+    "nodemailer": "^6.9.11",
     "numeral": "^2.0.6",
     "typedi": "0.10.0",
     "yup": "^1.7.1",
-    "zod": "^4.3.6"
+    "zod": "^4.1.12"
   },
   "devDependencies": {
-    "@types/aws-lambda": "^8.10.161",
-    "@types/jest": "^30.0.0",
-    "eslint": "^10.0.2",
-    "@typescript-eslint/eslint-plugin": "^8.56.1",
-    "@typescript-eslint/parser": "^8.56.1",
-    "jest": "^30.2.0",
+    "@types/aws-lambda": "^8.10.149",
+    "@types/jest": "^29.5.14",
+    "eslint": "^8.56.0",
+    "@typescript-eslint/eslint-plugin": "^6.19.1",
+    "@typescript-eslint/parser": "^6.19.1",
+    "jest": "^29.7.0",
     "jest-transform-stub": "^2.0.0",
-    "jsonc-eslint-parser": "^3.1.0",
-    "serverless-offline": "^14.5.0",
+    "jsonc-eslint-parser": "^2.4.0",
+    "serverless-offline": "^14.4.0",
     "serverless-stage-manager": "^1.0.5",
-    "ts-jest": "^29.4.6",
+    "ts-jest": "^29.3.1",
     "ts-node": "^10.9.2",
-    "tsc-alias": "^1.8.16",
-    "typescript": "^5.9.3",
-    "prettier": "^3.8.1",
-    "typescript-transform-paths": "^3.5.6"
+    "tsc-alias": "^1.8.11",
+    "typescript": "^5.8.3",
+    "prettier": "^3.6.2",
+    "typescript-transform-paths": "^3.5.3"
   }
 }

package/dist/utils/data.util.d.ts

@@ -1,20 +0,0 @@
-import { z, ZodType } from "zod";
-type InvalidConfig = boolean | string[];
-/**
- * EntityBuilder generates mock objects from a Zod schema.
- * - Can produce fully valid objects
- * - Can produce random invalid objects (at least one field invalid)
- * - Can produce targeted invalid objects (specific fields)
- * - Arrays are autofilled with multiple elements if `arrayLength` > 1
- */
-export declare class EntityBuilder<T extends ZodType<any, any, any>> {
-    private readonly schema;
-    private readonly invalid;
-    private readonly arrayLength;
-    private seed;
-    constructor(schema: T, invalid?: InvalidConfig, arrayLength?: number);
-    build(): z.infer<T>;
-    private buildFromZod;
-    private shouldInvalidate;
-}
-export {};

package/dist/utils/data.util.js

@@ -1,73 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EntityBuilder = void 0;
-const zod_1 = require("zod");
-/**
- * EntityBuilder generates mock objects from a Zod schema.
- * - Can produce fully valid objects
- * - Can produce random invalid objects (at least one field invalid)
- * - Can produce targeted invalid objects (specific fields)
- * - Arrays are autofilled with multiple elements if `arrayLength` > 1
- */
-class EntityBuilder {
-    schema;
-    invalid;
-    arrayLength;
-    seed = 1;
-    constructor(schema, invalid = true, arrayLength = 1) {
-        this.schema = schema;
-        this.invalid = invalid;
-        this.arrayLength = arrayLength;
-    }
-    build() {
-        return this.buildFromZod(this.schema, this.invalid);
-    }
-    buildFromZod(schema, invalidConfig, path = []) {
-        // Optional / Nullable unwrap
-        if (schema instanceof zod_1.ZodOptional || schema instanceof zod_1.ZodNullable) {
-            const inner = schema._def.innerType;
-            return this.buildFromZod(inner, invalidConfig, path);
-        }
-        if (schema instanceof zod_1.ZodString) {
-            return this.shouldInvalidate(path, invalidConfig) ? "INVALID" : `valid_${path.join("_")}`;
-        }
-        if (schema instanceof zod_1.ZodNumber) {
-            return this.shouldInvalidate(path, invalidConfig) ? -1 : 1;
-        }
-        if (schema instanceof zod_1.ZodBoolean) {
-            return !this.shouldInvalidate(path, invalidConfig);
-        }
-        if (schema instanceof zod_1.ZodArray) {
-            const elementSchema = schema.element;
-            const arr = [];
-            for (let i = 0; i < this.arrayLength; i++) {
-                arr.push(this.buildFromZod(elementSchema, invalidConfig, path.concat([String(i)])));
-            }
-            return arr;
-        }
-        if (schema instanceof zod_1.ZodObject) {
-            const obj = {};
-            const shape = schema.shape;
-            for (const key in shape) {
-                obj[key] = this.buildFromZod(shape[key], invalidConfig, path.concat([key]));
-            }
-            return obj;
-        }
-        // fallback for unsupported types
-        return null;
-    }
-    shouldInvalidate(path, invalidConfig) {
-        if (invalidConfig === false) {
-            // random invalid
-            const x = Math.sin(this.seed++) * 10000;
-            return x - Math.floor(x) > 0.5;
-        }
-        if (Array.isArray(invalidConfig)) {
-            // targeted invalid
-            return invalidConfig.includes(path.join("."));
-        }
-        return false; // valid by default
-    }
-}
-exports.EntityBuilder = EntityBuilder;
-//# sourceMappingURL=data.util.js.map

package/dist/utils/data.util.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"data.util.js","sourceRoot":"","sources":["../../src/utils/data.util.ts"],"names":[],"mappings":"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","sourcesContent":["import { z, ZodArray, ZodBoolean, ZodNullable, ZodNumber, ZodObject, ZodOptional, ZodString, ZodType } from \"zod\";\n\ntype InvalidConfig = boolean | string[];\n\n/**\n * EntityBuilder generates mock objects from a Zod schema.\n * - Can produce fully valid objects\n * - Can produce random invalid objects (at least one field invalid)\n * - Can produce targeted invalid objects (specific fields)\n * - Arrays are autofilled with multiple elements if `arrayLength` > 1\n */\nexport class EntityBuilder<T extends ZodType<any, any, any>> {\n  private seed = 1;\n\n  constructor(\n    private readonly schema: T,\n    private readonly invalid: InvalidConfig = true,\n    private readonly arrayLength: number = 1, // default number of elements in arrays\n  ) {}\n\n  build(): z.infer<T> {\n    return this.buildFromZod(this.schema, this.invalid) as z.infer<T>;\n  }\n\n  private buildFromZod(schema: ZodType<any, any, any>, invalidConfig: InvalidConfig, path: string[] = []): any {\n    // Optional / Nullable unwrap\n    if (schema instanceof ZodOptional || schema instanceof ZodNullable) {\n      const inner = (schema as any)._def.innerType as ZodType<any, any, any>;\n      return this.buildFromZod(inner, invalidConfig, path);\n    }\n\n    if (schema instanceof ZodString) {\n      return this.shouldInvalidate(path, invalidConfig) ? \"INVALID\" : `valid_${path.join(\"_\")}`;\n    }\n\n    if (schema instanceof ZodNumber) {\n      return this.shouldInvalidate(path, invalidConfig) ? -1 : 1;\n    }\n\n    if (schema instanceof ZodBoolean) {\n      return !this.shouldInvalidate(path, invalidConfig);\n    }\n\n    if (schema instanceof ZodArray) {\n      const elementSchema = (schema as ZodArray<any>).element as ZodType<any, any, any>;\n      const arr = [];\n      for (let i = 0; i < this.arrayLength; i++) {\n        arr.push(this.buildFromZod(elementSchema, invalidConfig, path.concat([String(i)])));\n      }\n      return arr;\n    }\n\n    if (schema instanceof ZodObject) {\n      const obj: any = {};\n      const shape = (schema as ZodObject<any>).shape;\n      for (const key in shape) {\n        obj[key] = this.buildFromZod(shape[key], invalidConfig, path.concat([key]));\n      }\n      return obj;\n    }\n\n    // fallback for unsupported types\n    return null;\n  }\n\n  private shouldInvalidate(path: string[], invalidConfig: InvalidConfig): boolean {\n    if (invalidConfig === false) {\n      // random invalid\n      const x = Math.sin(this.seed++) * 10000;\n      return x - Math.floor(x) > 0.5;\n    }\n    if (Array.isArray(invalidConfig)) {\n      // targeted invalid\n      return invalidConfig.includes(path.join(\".\"));\n    }\n    return false; // valid by default\n  }\n}\n"]}