@mxpicture/gcp-functions-common 1.1.76 → 1.1.77

package/dist/helper/helper.annotation.d.ts

@@ -12,6 +12,4 @@ import { DocumentData } from "../types/types.document.js";
  * @returns A partial document containing only the properties that define a default value.
  */
 export declare const annoDocInitial: <T extends DocumentData>(properties: AnnotationsProperty<DecoPropertyBase>[]) => Partial<T>;
-export declare const removeDate: (d: Date) => Date;
-export declare const removeTime: (d: Date) => Date;
 //# sourceMappingURL=helper.annotation.d.ts.map

package/dist/helper/helper.annotation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper.annotation.d.ts","sourceRoot":"","sources":["../../src/helper/helper.annotation.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,YAAY,EACnD,YAAY,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,KAClD,OAAO,CAAC,CAAC,CAiDX,CAAC;AAgBF,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,KAAG,IAKpC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,KAAG,IAMpC,CAAC"}
+{"version":3,"file":"helper.annotation.d.ts","sourceRoot":"","sources":["../../src/helper/helper.annotation.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,YAAY,EACnD,YAAY,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,KAClD,OAAO,CAAC,CAAC,CAiDX,CAAC"}

package/dist/helper/helper.annotation.js

@@ -1,5 +1,6 @@
 import { castDecoBoolean, castDecoDate, castDecoEnum, castDecoNumber, castDecoString, } from "../decorator/deco.cast.js";
 import { DecoDateType } from "../decorator/deco.enum.js";
+import { date1970, now, today } from "./helper.date.js";
 /**
  * Builds a partial document pre-filled with default values from annotation properties.
  *
@@ -52,24 +53,4 @@ export const annoDocInitial = (properties) => {
     }
     return result;
 };
-const date1970 = (offsetDays = 0) => addDays(removeTime(removeDate(new Date())), offsetDays);
-const today = (offsetDays = 0) => addDays(removeDate(new Date()), offsetDays);
-const now = (offsetDays = 0) => addDays(new Date(), offsetDays);
-const addDays = (date, offsetDays) => {
-    date.setDate(date.getDate() + (offsetDays ?? 0));
-    return date;
-};
-export const removeDate = (d) => {
-    d.setUTCFullYear(1970);
-    d.setUTCMonth(0);
-    d.setUTCDate(1);
-    return d;
-};
-export const removeTime = (d) => {
-    d.setUTCHours(0);
-    d.setUTCMinutes(0);
-    d.setUTCSeconds(0);
-    d.setUTCMilliseconds(0);
-    return d;
-};
 //# sourceMappingURL=helper.annotation.js.map

package/dist/helper/helper.annotation.js.map

@@ -1 +1 @@
-{"version":3,"file":"helper.annotation.js","sourceRoot":"","sources":["../../src/helper/helper.annotation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helper.annotation.js","sourceRoot":"","sources":["../../src/helper/helper.annotation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAIzD,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,UAAmD,EACvC,EAAE;IACd,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAsB,CAAC;QAExC,MAAM,aAAa,GACjB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;YACvB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;YACzB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;YACzB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,aAAa,EAAE,CAAC;YAClB,8DAA8D;YAC9D,IAAI,aAAa,CAAC,OAAO;gBAAG,MAAc,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC;YACxE,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,GAAG,GAAgB,IAAI,CAAC;YAE5B,QAAQ,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBAC1B,KAAK,YAAY,CAAC,QAAQ;oBACxB,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;oBACxC,MAAM;gBAER,KAAK,YAAY,CAAC,GAAG;oBACnB,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;oBACnC,MAAM;gBAER,KAAK,YAAY,CAAC,KAAK;oBACrB,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;oBACrC,MAAM;gBAER;oBACE,MAAM;YACV,CAAC;YAED,8DAA8D;YAC9D,IAAI,GAAG;gBAAG,MAAc,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACpC,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;YACnC,8DAA8D;YAC7D,MAAc,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/helper/helper.date.d.ts

@@ -1,26 +1,22 @@
+export declare enum ModifyDateUnit {
+    seconds = "seconds",
+    minutes = "minutes",
+    hours = "hours",
+    days = "days"
+}
+export declare const date1970: (offset?: number | null | undefined, unit?: ModifyDateUnit) => Date;
+export declare const today: (offset?: number | null | undefined, unit?: ModifyDateUnit) => Date;
+export declare const now: (offset?: number | null | undefined, unit?: ModifyDateUnit) => Date;
+export declare const modifyDate: (date: Date, offset: number | null | undefined, unit?: ModifyDateUnit) => Date;
+export declare const removeDate: (d: Date) => Date;
+export declare const removeTime: (d: Date) => Date;
 /**
- * Deeply converts Firestore timestamp fields to JavaScript `Date` objects.
- *
- * @remarks
- * Path segments are separated by "/" and a wildcard may be used
- * to iterate over array elements (e.g. "items/{wildcard}/createdAt").
- *
- * @param data - The data structure to transform (cloned before mutation).
- * @param paths - Slash-delimited paths to fields that should be converted.
- * @returns A deep clone of `data` with the targeted fields converted to `Date`.
+ * Returns a Date in UTC in the allowed window (23:00–06:00).
+ * Strategy:
+ * - base = now + days
+ * - if base hour in [0..5] => keep base (rounded up to next 5 min)
+ * - if base hour in [23] => keep base (rounded up to next 5 min)
+ * - else => task at 23:30:00 UTC same date as base
  */
-export declare const toDatesDeep: <T>(data: T, paths: string[]) => T;
-/**
- * Deeply converts date-like fields to raw {@link FirebaseTimestampRaw} objects.
- *
- * @remarks
- * Accepts JavaScript `Date` objects, numeric millisecond values, and Firestore
- * document objects with `_seconds`/`_nanoseconds` fields. Path segments follow
- * the same convention as {@link toDatesDeep}.
- *
- * @param data - The data structure to transform (cloned before mutation).
- * @param paths - Slash-delimited paths to fields that should be converted.
- * @returns A deep clone of `data` with the targeted fields converted to {@link FirebaseTimestampRaw}.
- */
-export declare const toTimestampsDeep: <T>(data: T, paths: string[]) => T;
+export declare const computeScheduleTimeUtc: (base: Date, hoursFrom: number, hoursTo: number) => Date;
 //# sourceMappingURL=helper.date.d.ts.map

package/dist/helper/helper.date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper.date.d.ts","sourceRoot":"","sources":["../../src/helper/helper.date.ts"],"names":[],"mappings":"AA8DA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,MAAM,EAAE,KAAG,CACf,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,MAAM,EAAE,KAAG,CACf,CAAC"}
+{"version":3,"file":"helper.date.d.ts","sourceRoot":"","sources":["../../src/helper/helper.date.ts"],"names":[],"mappings":"AAAA,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAED,eAAO,MAAM,QAAQ,GACnB,SAAQ,MAAM,GAAG,IAAI,GAAG,SAAa,EACrC,OAAM,cAAoC,SACqB,CAAC;AAElE,eAAO,MAAM,KAAK,GAChB,SAAQ,MAAM,GAAG,IAAI,GAAG,SAAa,EACrC,OAAM,cAAoC,SACS,CAAC;AAEtD,eAAO,MAAM,GAAG,GACd,SAAQ,MAAM,GAAG,IAAI,GAAG,SAAa,EACrC,OAAM,cAAoC,SACH,CAAC;AAE1C,eAAO,MAAM,UAAU,GACrB,MAAM,IAAI,EACV,QAAQ,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,OAAM,cAAoC,KACzC,IAwBF,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,KAAG,IAKpC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,KAAG,IAMpC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,IAAI,EACV,WAAW,MAAM,EACjB,SAAS,MAAM,KACd,IAmBF,CAAC"}

package/dist/helper/helper.date.js

@@ -1,74 +1,70 @@
-import { FirebaseTimestamp, } from "./FirebaseTimestamp.js";
-const _normalizeDate = (value) => !value
-    ? value
-    : typeof value?.toDate === "function"
-        ? value.toDate()
-        : value?._seconds !== undefined
-            ? new Date(value._seconds * 1000 + value._nanoseconds / 1e6)
-            : typeof value === "string"
-                ? new Date(value)
-                : value;
-const _normalizeTimestamp = (value) => {
-    if (value instanceof Date)
-        return FirebaseTimestamp.fromDate(value).raw;
-    if (typeof value === "number")
-        return FirebaseTimestamp.fromMillis(value).raw;
-    if (typeof value === "object")
-        return FirebaseTimestamp.fromDoc(value)?.raw ?? null;
-    if (typeof value === "string")
-        return FirebaseTimestamp.fromIso(value).raw;
-    return null;
-};
-const _applyPath = (
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-obj, pathParts, convert) => {
-    if (!obj)
-        return;
-    const [current, ...rest] = pathParts;
-    if (current === "*") {
-        if (Array.isArray(obj))
-            for (const item of obj)
-                _applyPath(item, rest, convert);
-        return;
-    }
-    if (rest.length === 0) {
-        if (obj[current] !== undefined)
-            obj[current] = convert(obj[current]);
-        return;
+export var ModifyDateUnit;
+(function (ModifyDateUnit) {
+    ModifyDateUnit["seconds"] = "seconds";
+    ModifyDateUnit["minutes"] = "minutes";
+    ModifyDateUnit["hours"] = "hours";
+    ModifyDateUnit["days"] = "days";
+})(ModifyDateUnit || (ModifyDateUnit = {}));
+export const date1970 = (offset = 0, unit = ModifyDateUnit.days) => modifyDate(removeTime(removeDate(new Date())), offset, unit);
+export const today = (offset = 0, unit = ModifyDateUnit.days) => modifyDate(removeDate(new Date()), offset, unit);
+export const now = (offset = 0, unit = ModifyDateUnit.days) => modifyDate(new Date(), offset, unit);
+export const modifyDate = (date, offset, unit = ModifyDateUnit.days) => {
+    offset ??= 0;
+    switch (unit) {
+        case ModifyDateUnit.days:
+            date.setUTCDate(date.getUTCDate() + offset);
+            break;
+        case ModifyDateUnit.hours:
+            date.setUTCHours(date.getUTCHours() + offset);
+            break;
+        case ModifyDateUnit.minutes:
+            date.setUTCMinutes(date.getUTCMinutes() + offset);
+            break;
+        case ModifyDateUnit.seconds:
+            date.setUTCSeconds(date.getUTCSeconds() + offset);
+            break;
+        default:
+            break;
     }
-    _applyPath(obj[current], rest, convert);
+    return date;
 };
-const _convertDeep = (data, paths, convert) => {
-    if (Array.isArray(data))
-        return data.map((item) => _convertDeep(item, paths, convert));
-    const clone = structuredClone(data);
-    for (const path of paths)
-        _applyPath(clone, path.split("/"), convert);
-    return clone;
+export const removeDate = (d) => {
+    d.setUTCFullYear(1970);
+    d.setUTCMonth(0);
+    d.setUTCDate(1);
+    return d;
+};
+export const removeTime = (d) => {
+    d.setUTCHours(0);
+    d.setUTCMinutes(0);
+    d.setUTCSeconds(0);
+    d.setUTCMilliseconds(0);
+    return d;
 };
 /**
- * Deeply converts Firestore timestamp fields to JavaScript `Date` objects.
- *
- * @remarks
- * Path segments are separated by "/" and a wildcard may be used
- * to iterate over array elements (e.g. "items/{wildcard}/createdAt").
- *
- * @param data - The data structure to transform (cloned before mutation).
- * @param paths - Slash-delimited paths to fields that should be converted.
- * @returns A deep clone of `data` with the targeted fields converted to `Date`.
- */
-export const toDatesDeep = (data, paths) => _convertDeep(data, paths, _normalizeDate);
-/**
- * Deeply converts date-like fields to raw {@link FirebaseTimestampRaw} objects.
- *
- * @remarks
- * Accepts JavaScript `Date` objects, numeric millisecond values, and Firestore
- * document objects with `_seconds`/`_nanoseconds` fields. Path segments follow
- * the same convention as {@link toDatesDeep}.
- *
- * @param data - The data structure to transform (cloned before mutation).
- * @param paths - Slash-delimited paths to fields that should be converted.
- * @returns A deep clone of `data` with the targeted fields converted to {@link FirebaseTimestampRaw}.
+ * Returns a Date in UTC in the allowed window (23:00–06:00).
+ * Strategy:
+ * - base = now + days
+ * - if base hour in [0..5] => keep base (rounded up to next 5 min)
+ * - if base hour in [23] => keep base (rounded up to next 5 min)
+ * - else => task at 23:30:00 UTC same date as base
  */
-export const toTimestampsDeep = (data, paths) => _convertDeep(data, paths, _normalizeTimestamp);
+export const computeScheduleTimeUtc = (base, hoursFrom, hoursTo) => {
+    const d = new Date(base.getTime());
+    const hour = d.getUTCHours();
+    let inRange = false;
+    if (hoursFrom > hoursTo)
+        inRange = hour >= hoursFrom || hour < hoursTo;
+    else
+        inRange = hour >= hoursFrom && hour < hoursTo;
+    if (!inRange) {
+        d.setUTCHours(hoursFrom, 0, 0, 0);
+        return d;
+    }
+    // Round up to next 5 minutes to avoid "task in the past by milliseconds" issues
+    const ms = d.getTime();
+    const fiveMin = 5 * 60 * 1000;
+    const rounded = Math.ceil(ms / fiveMin) * fiveMin;
+    return new Date(rounded);
+};
 //# sourceMappingURL=helper.date.js.map

package/dist/helper/helper.date.js.map

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

package/dist/helper/helper.timestamp.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Deeply converts Firestore timestamp fields to JavaScript `Date` objects.
+ *
+ * @remarks
+ * Path segments are separated by "/" and a wildcard may be used
+ * to iterate over array elements (e.g. "items/{wildcard}/createdAt").
+ *
+ * @param data - The data structure to transform (cloned before mutation).
+ * @param paths - Slash-delimited paths to fields that should be converted.
+ * @returns A deep clone of `data` with the targeted fields converted to `Date`.
+ */
+export declare const toDatesDeep: <T>(data: T, paths: string[]) => T;
+/**
+ * Deeply converts date-like fields to raw {@link FirebaseTimestampRaw} objects.
+ *
+ * @remarks
+ * Accepts JavaScript `Date` objects, numeric millisecond values, and Firestore
+ * document objects with `_seconds`/`_nanoseconds` fields. Path segments follow
+ * the same convention as {@link toDatesDeep}.
+ *
+ * @param data - The data structure to transform (cloned before mutation).
+ * @param paths - Slash-delimited paths to fields that should be converted.
+ * @returns A deep clone of `data` with the targeted fields converted to {@link FirebaseTimestampRaw}.
+ */
+export declare const toTimestampsDeep: <T>(data: T, paths: string[]) => T;
+//# sourceMappingURL=helper.timestamp.d.ts.map

package/dist/helper/helper.timestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.timestamp.d.ts","sourceRoot":"","sources":["../../src/helper/helper.timestamp.ts"],"names":[],"mappings":"AA8DA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,MAAM,EAAE,KAAG,CACf,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,MAAM,EAAE,KAAG,CACf,CAAC"}

package/dist/helper/helper.timestamp.js

@@ -0,0 +1,74 @@
+import { FirebaseTimestamp, } from "./FirebaseTimestamp.js";
+const _normalizeDate = (value) => !value
+    ? value
+    : typeof value?.toDate === "function"
+        ? value.toDate()
+        : value?._seconds !== undefined
+            ? new Date(value._seconds * 1000 + value._nanoseconds / 1e6)
+            : typeof value === "string"
+                ? new Date(value)
+                : value;
+const _normalizeTimestamp = (value) => {
+    if (value instanceof Date)
+        return FirebaseTimestamp.fromDate(value).raw;
+    if (typeof value === "number")
+        return FirebaseTimestamp.fromMillis(value).raw;
+    if (typeof value === "object")
+        return FirebaseTimestamp.fromDoc(value)?.raw ?? null;
+    if (typeof value === "string")
+        return FirebaseTimestamp.fromIso(value).raw;
+    return null;
+};
+const _applyPath = (
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+obj, pathParts, convert) => {
+    if (!obj)
+        return;
+    const [current, ...rest] = pathParts;
+    if (current === "*") {
+        if (Array.isArray(obj))
+            for (const item of obj)
+                _applyPath(item, rest, convert);
+        return;
+    }
+    if (rest.length === 0) {
+        if (obj[current] !== undefined)
+            obj[current] = convert(obj[current]);
+        return;
+    }
+    _applyPath(obj[current], rest, convert);
+};
+const _convertDeep = (data, paths, convert) => {
+    if (Array.isArray(data))
+        return data.map((item) => _convertDeep(item, paths, convert));
+    const clone = structuredClone(data);
+    for (const path of paths)
+        _applyPath(clone, path.split("/"), convert);
+    return clone;
+};
+/**
+ * Deeply converts Firestore timestamp fields to JavaScript `Date` objects.
+ *
+ * @remarks
+ * Path segments are separated by "/" and a wildcard may be used
+ * to iterate over array elements (e.g. "items/{wildcard}/createdAt").
+ *
+ * @param data - The data structure to transform (cloned before mutation).
+ * @param paths - Slash-delimited paths to fields that should be converted.
+ * @returns A deep clone of `data` with the targeted fields converted to `Date`.
+ */
+export const toDatesDeep = (data, paths) => _convertDeep(data, paths, _normalizeDate);
+/**
+ * Deeply converts date-like fields to raw {@link FirebaseTimestampRaw} objects.
+ *
+ * @remarks
+ * Accepts JavaScript `Date` objects, numeric millisecond values, and Firestore
+ * document objects with `_seconds`/`_nanoseconds` fields. Path segments follow
+ * the same convention as {@link toDatesDeep}.
+ *
+ * @param data - The data structure to transform (cloned before mutation).
+ * @param paths - Slash-delimited paths to fields that should be converted.
+ * @returns A deep clone of `data` with the targeted fields converted to {@link FirebaseTimestampRaw}.
+ */
+export const toTimestampsDeep = (data, paths) => _convertDeep(data, paths, _normalizeTimestamp);
+//# sourceMappingURL=helper.timestamp.js.map

package/dist/helper/helper.timestamp.js.map

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

package/dist/helper/index.d.ts

@@ -5,4 +5,5 @@ export * from "./helper.date.js";
 export * from "./helper.document.js";
 export * from "./helper.object.js";
 export * from "./helper.string.js";
+export * from "./helper.timestamp.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/helper/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helper/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helper/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/dist/helper/index.js

@@ -6,4 +6,5 @@ export * from "./helper.date.js";
 export * from "./helper.document.js";
 export * from "./helper.object.js";
 export * from "./helper.string.js";
+export * from "./helper.timestamp.js";
 //# sourceMappingURL=index.js.map

package/dist/helper/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helper/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helper/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mxpicture/gcp-functions-common",
-  "version": "1.1.76",
+  "version": "1.1.77",
   "description": "Utils for google cloud functions, publishing both CommonJS and ESM builds",
   "type": "module",
   "author": "MXPicture",