@futdevpro/fsm-dynamo 1.16.39 → 1.20.2

package/build/_enums/time/day-of-week.enum.js

@@ -1,51 +1,51 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyFM_allDaysOfWeekStupid = exports.DyFM_allDaysOfWeekAmericanStyle = exports.DyFM_allDaysOfWeek = exports.DyFM_DayOfWeek = void 0;
-/**
- * Names of the days of the week.
- *
- * @example
- * ```ts
- * const today = DyFM_DayOfWeek.monday;
- * ```
- */
-var DyFM_DayOfWeek;
-(function (DyFM_DayOfWeek) {
-    DyFM_DayOfWeek["monday"] = "monday";
-    DyFM_DayOfWeek["tuesday"] = "tuesday";
-    DyFM_DayOfWeek["wednesday"] = "wednesday";
-    DyFM_DayOfWeek["thursday"] = "thursday";
-    DyFM_DayOfWeek["friday"] = "friday";
-    DyFM_DayOfWeek["saturday"] = "saturday";
-    DyFM_DayOfWeek["sunday"] = "sunday";
-})(DyFM_DayOfWeek || (exports.DyFM_DayOfWeek = DyFM_DayOfWeek = {}));
-/**
- * Every day of the week in an array.
- *
- * @example
- * ```ts
- * const daysOfWeek = DyFM_allDaysOfWeek;
- * console.log(daysOfWeek); // [ 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday', 'sunday' ]
- * ```
- */
-exports.DyFM_allDaysOfWeek = Object.values(DyFM_DayOfWeek);
-/** In U.S. order starting with Sunday
- *
- * @example
- * ```ts
- * const daysOfWeek = DyFM_allDaysOfWeekAmericanStyle;
- * console.log(daysOfWeek); // [ DyFM_DayOfWeek.sunday, DyFM_DayOfWeek.monday, DyFM_DayOfWeek.tuesday, DyFM_DayOfWeek.wednesday, DyFM_DayOfWeek.thursday, DyFM_DayOfWeek.friday, DyFM_DayOfWeek.saturday ]
- * ```
- */
-exports.DyFM_allDaysOfWeekAmericanStyle = [
-    DyFM_DayOfWeek.sunday,
-    DyFM_DayOfWeek.monday,
-    DyFM_DayOfWeek.tuesday,
-    DyFM_DayOfWeek.wednesday,
-    DyFM_DayOfWeek.thursday,
-    DyFM_DayOfWeek.friday,
-    DyFM_DayOfWeek.saturday,
-];
-/** Same as `DyFM_allDaysOfWeekAmericanStyle`. */
-exports.DyFM_allDaysOfWeekStupid = exports.DyFM_allDaysOfWeekAmericanStyle;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_allDaysOfWeekStupid = exports.DyFM_allDaysOfWeekAmericanStyle = exports.DyFM_allDaysOfWeek = exports.DyFM_DayOfWeek = void 0;
+/**
+ * Names of the days of the week.
+ *
+ * @example
+ * ```ts
+ * const today = DyFM_DayOfWeek.monday;
+ * ```
+ */
+var DyFM_DayOfWeek;
+(function (DyFM_DayOfWeek) {
+    DyFM_DayOfWeek["monday"] = "monday";
+    DyFM_DayOfWeek["tuesday"] = "tuesday";
+    DyFM_DayOfWeek["wednesday"] = "wednesday";
+    DyFM_DayOfWeek["thursday"] = "thursday";
+    DyFM_DayOfWeek["friday"] = "friday";
+    DyFM_DayOfWeek["saturday"] = "saturday";
+    DyFM_DayOfWeek["sunday"] = "sunday";
+})(DyFM_DayOfWeek || (exports.DyFM_DayOfWeek = DyFM_DayOfWeek = {}));
+/**
+ * Every day of the week in an array.
+ *
+ * @example
+ * ```ts
+ * const daysOfWeek = DyFM_allDaysOfWeek;
+ * console.log(daysOfWeek); // [ 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday', 'sunday' ]
+ * ```
+ */
+exports.DyFM_allDaysOfWeek = Object.values(DyFM_DayOfWeek);
+/** In U.S. order starting with Sunday
+ *
+ * @example
+ * ```ts
+ * const daysOfWeek = DyFM_allDaysOfWeekAmericanStyle;
+ * console.log(daysOfWeek); // [ DyFM_DayOfWeek.sunday, DyFM_DayOfWeek.monday, DyFM_DayOfWeek.tuesday, DyFM_DayOfWeek.wednesday, DyFM_DayOfWeek.thursday, DyFM_DayOfWeek.friday, DyFM_DayOfWeek.saturday ]
+ * ```
+ */
+exports.DyFM_allDaysOfWeekAmericanStyle = [
+    DyFM_DayOfWeek.sunday,
+    DyFM_DayOfWeek.monday,
+    DyFM_DayOfWeek.tuesday,
+    DyFM_DayOfWeek.wednesday,
+    DyFM_DayOfWeek.thursday,
+    DyFM_DayOfWeek.friday,
+    DyFM_DayOfWeek.saturday,
+];
+/** Same as `DyFM_allDaysOfWeekAmericanStyle`. */
+exports.DyFM_allDaysOfWeekStupid = exports.DyFM_allDaysOfWeekAmericanStyle;
 //# sourceMappingURL=day-of-week.enum.js.map

package/build/_enums/time/month.enum.d.ts

@@ -1,23 +1,23 @@
-/**
- * Enumeration of calendar months.
- *
- * @example
- * ```ts
- * const month = DyFM_Month.january;
- * ```
- */
-export declare enum DyFM_Month {
-    january = "january",
-    february = "february",
-    march = "march",
-    april = "april",
-    may = "may",
-    june = "june",
-    july = "july",
-    august = "august",
-    september = "september",
-    october = "october",
-    november = "november",
-    december = "december"
-}
+/**
+ * Enumeration of calendar months.
+ *
+ * @example
+ * ```ts
+ * const month = DyFM_Month.january;
+ * ```
+ */
+export declare enum DyFM_Month {
+    january = "january",
+    february = "february",
+    march = "march",
+    april = "april",
+    may = "may",
+    june = "june",
+    july = "july",
+    august = "august",
+    september = "september",
+    october = "october",
+    november = "november",
+    december = "december"
+}
 //# sourceMappingURL=month.enum.d.ts.map

package/build/_enums/time/month.enum.js

@@ -1,27 +1,27 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyFM_Month = void 0;
-/**
- * Enumeration of calendar months.
- *
- * @example
- * ```ts
- * const month = DyFM_Month.january;
- * ```
- */
-var DyFM_Month;
-(function (DyFM_Month) {
-    DyFM_Month["january"] = "january";
-    DyFM_Month["february"] = "february";
-    DyFM_Month["march"] = "march";
-    DyFM_Month["april"] = "april";
-    DyFM_Month["may"] = "may";
-    DyFM_Month["june"] = "june";
-    DyFM_Month["july"] = "july";
-    DyFM_Month["august"] = "august";
-    DyFM_Month["september"] = "september";
-    DyFM_Month["october"] = "october";
-    DyFM_Month["november"] = "november";
-    DyFM_Month["december"] = "december";
-})(DyFM_Month || (exports.DyFM_Month = DyFM_Month = {}));
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_Month = void 0;
+/**
+ * Enumeration of calendar months.
+ *
+ * @example
+ * ```ts
+ * const month = DyFM_Month.january;
+ * ```
+ */
+var DyFM_Month;
+(function (DyFM_Month) {
+    DyFM_Month["january"] = "january";
+    DyFM_Month["february"] = "february";
+    DyFM_Month["march"] = "march";
+    DyFM_Month["april"] = "april";
+    DyFM_Month["may"] = "may";
+    DyFM_Month["june"] = "june";
+    DyFM_Month["july"] = "july";
+    DyFM_Month["august"] = "august";
+    DyFM_Month["september"] = "september";
+    DyFM_Month["october"] = "october";
+    DyFM_Month["november"] = "november";
+    DyFM_Month["december"] = "december";
+})(DyFM_Month || (exports.DyFM_Month = DyFM_Month = {}));
 //# sourceMappingURL=month.enum.js.map

package/build/_enums/time/relative-date.enum.d.ts

@@ -1,19 +1,19 @@
-/**
- * Human readable identifiers for relative date ranges.
- *
- * @example
- * ```ts
- * if (range === DyFM_RelativeDate.lastWeek) {
- *   // ...
- * }
- * ```
- */
-export declare enum DyFM_RelativeDate {
-    lastDay = "lastDay",
-    lastWeek = "lastWeek",
-    lastMonth = "lastMonth",
-    lastYear = "lastYear",
-    last10Years = "last10Years",
-    allTime = "allTime"
-}
+/**
+ * Human readable identifiers for relative date ranges.
+ *
+ * @example
+ * ```ts
+ * if (range === DyFM_RelativeDate.lastWeek) {
+ *   // ...
+ * }
+ * ```
+ */
+export declare enum DyFM_RelativeDate {
+    lastDay = "lastDay",
+    lastWeek = "lastWeek",
+    lastMonth = "lastMonth",
+    lastYear = "lastYear",
+    last10Years = "last10Years",
+    allTime = "allTime"
+}
 //# sourceMappingURL=relative-date.enum.d.ts.map

package/build/_enums/time/relative-date.enum.js

@@ -1,23 +1,23 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyFM_RelativeDate = void 0;
-/**
- * Human readable identifiers for relative date ranges.
- *
- * @example
- * ```ts
- * if (range === DyFM_RelativeDate.lastWeek) {
- *   // ...
- * }
- * ```
- */
-var DyFM_RelativeDate;
-(function (DyFM_RelativeDate) {
-    DyFM_RelativeDate["lastDay"] = "lastDay";
-    DyFM_RelativeDate["lastWeek"] = "lastWeek";
-    DyFM_RelativeDate["lastMonth"] = "lastMonth";
-    DyFM_RelativeDate["lastYear"] = "lastYear";
-    DyFM_RelativeDate["last10Years"] = "last10Years";
-    DyFM_RelativeDate["allTime"] = "allTime";
-})(DyFM_RelativeDate || (exports.DyFM_RelativeDate = DyFM_RelativeDate = {}));
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_RelativeDate = void 0;
+/**
+ * Human readable identifiers for relative date ranges.
+ *
+ * @example
+ * ```ts
+ * if (range === DyFM_RelativeDate.lastWeek) {
+ *   // ...
+ * }
+ * ```
+ */
+var DyFM_RelativeDate;
+(function (DyFM_RelativeDate) {
+    DyFM_RelativeDate["lastDay"] = "lastDay";
+    DyFM_RelativeDate["lastWeek"] = "lastWeek";
+    DyFM_RelativeDate["lastMonth"] = "lastMonth";
+    DyFM_RelativeDate["lastYear"] = "lastYear";
+    DyFM_RelativeDate["last10Years"] = "last10Years";
+    DyFM_RelativeDate["allTime"] = "allTime";
+})(DyFM_RelativeDate || (exports.DyFM_RelativeDate = DyFM_RelativeDate = {}));
 //# sourceMappingURL=relative-date.enum.js.map

package/build/_models/control-models/data-model-params.control-model.d.ts

@@ -1,83 +1,83 @@
-import { DyFM_DataModel_Type } from '../../_enums/data-model-type.enum';
-import { DyFM_Metadata } from '../data-models/metadata.data-model';
-import { DyFM_DataProperties, DyFM_DataProperty_Params } from './data-property-params.control-model';
-/**
- * FR-258 / SR-1 — declarative automatic document retention.
- *
- * When a data-model declares `retention`, `DyNTS_App` startup installs a MongoDB TTL index on
- * the record's `__created` Date field, so MongoDB NATIVELY auto-deletes documents older than the
- * configured age. This is the fleet-wide defense against the unbounded-collection-growth class:
- * a collection that grows without bound (logs / history / events / metrics / reports / archives)
- * and is then loaded by an unbounded find pulls 100s of MB into heap → GC-thrash → OOM. TTL keeps
- * the collection bounded with ZERO app-level loading.
- *
- * Declare EITHER `retentionDays` OR `ttlSeconds` (`ttlSeconds` wins if both are set).
- *
- * @example
- * ```ts
- * const params = new DyFM_DataModel_Params<MyLog>({
- *   dataName: 'my_log',
- *   retention: { retentionDays: 14 },   // auto-delete 14 days after creation
- *   properties: { ... },
- * });
- * ```
- */
-export interface DyFM_RetentionSettings {
-    /** Auto-delete documents this many days after their `__created` timestamp. */
-    retentionDays?: number;
-    /** Explicit TTL in seconds; takes precedence over `retentionDays`. */
-    ttlSeconds?: number;
-}
-/**
- * Resolve a {@link DyFM_RetentionSettings} to a positive integer TTL in seconds, or `undefined`
- * when no valid retention is configured (→ no TTL index is installed). `ttlSeconds` wins over
- * `retentionDays`; non-finite or ≤ 0 values are rejected. Pure + side-effect-free (unit-tested).
- */
-export declare function DyFM_resolveRetentionTtlSeconds(retention?: DyFM_RetentionSettings): number | undefined;
-export declare class DyFM_DataModel_Settings<T extends DyFM_Metadata> extends DyFM_Metadata {
-    /** this will be used as db table name, therefore it should be in snake_case,
-     * this also will be used in logs and errors
-     */
-    dataName: string;
-    modelType?: DyFM_DataModel_Type;
-    addArchive?: boolean;
-    /**
-     * If true, the Dynamo NTS will throw an error when trying to modify the data model.
-     *
-     * @default false
-     */
-    forbidModify?: boolean;
-    /**
-     * If true, the Dynamo NTS will throw an error when trying to delete the data model.
-     *
-     * @default false
-     */
-    forbidDelete?: boolean;
-    /**
-     * FR-258 / SR-1 — declarative automatic retention. If set, `DyNTS_App` startup creates a
-     * MongoDB TTL index on `__created`, so MongoDB auto-deletes documents older than the configured
-     * age (no app-level load → prevents the unbounded-growth → OOM class). See {@link DyFM_RetentionSettings}.
-     *
-     * @example { retentionDays: 14 }
-     */
-    retention?: DyFM_RetentionSettings;
-    /**
-     * from these settings we will set the data model properties for the DB.
-     * metadata properties will be added automatically to the data model.
-     */
-    properties: DyFM_DataProperties<T>;
-}
-export declare class DyFM_DataModel_Params<T extends DyFM_Metadata> extends DyFM_DataModel_Settings<T> {
-    readonly stackLocation?: string;
-    constructor(set: DyFM_DataModel_Settings<T>);
-    constructed?(): boolean;
-    /**
-     * BFR-ORGANIZER-001/002 kísérő (generikus): egy property deklarált default-értéke
-     * (`properties[key].default`) — hogy a defaultok EGYETLEN forrásból (a dataParams-ból)
-     * jöjjenek a fogyasztó create-útjain is (pl. `params.priority ?? dataParams.getDefaultValue('priority')`),
-     * ne duplikálódjanak literálként a service-kódban. `undefined`, ha nincs deklarált default.
-     */
-    getDefaultValue?<K extends keyof T>(key: K): T[K] | undefined;
-    setKeysForSubObjectParams?(property: DyFM_DataProperty_Params<any, T>): void;
-}
+import { DyFM_DataModel_Type } from '../../_enums/data-model-type.enum';
+import { DyFM_Metadata } from '../data-models/metadata.data-model';
+import { DyFM_DataProperties, DyFM_DataProperty_Params } from './data-property-params.control-model';
+/**
+ * FR-258 / SR-1 — declarative automatic document retention.
+ *
+ * When a data-model declares `retention`, `DyNTS_App` startup installs a MongoDB TTL index on
+ * the record's `__created` Date field, so MongoDB NATIVELY auto-deletes documents older than the
+ * configured age. This is the fleet-wide defense against the unbounded-collection-growth class:
+ * a collection that grows without bound (logs / history / events / metrics / reports / archives)
+ * and is then loaded by an unbounded find pulls 100s of MB into heap → GC-thrash → OOM. TTL keeps
+ * the collection bounded with ZERO app-level loading.
+ *
+ * Declare EITHER `retentionDays` OR `ttlSeconds` (`ttlSeconds` wins if both are set).
+ *
+ * @example
+ * ```ts
+ * const params = new DyFM_DataModel_Params<MyLog>({
+ *   dataName: 'my_log',
+ *   retention: { retentionDays: 14 },   // auto-delete 14 days after creation
+ *   properties: { ... },
+ * });
+ * ```
+ */
+export interface DyFM_RetentionSettings {
+    /** Auto-delete documents this many days after their `__created` timestamp. */
+    retentionDays?: number;
+    /** Explicit TTL in seconds; takes precedence over `retentionDays`. */
+    ttlSeconds?: number;
+}
+/**
+ * Resolve a {@link DyFM_RetentionSettings} to a positive integer TTL in seconds, or `undefined`
+ * when no valid retention is configured (→ no TTL index is installed). `ttlSeconds` wins over
+ * `retentionDays`; non-finite or ≤ 0 values are rejected. Pure + side-effect-free (unit-tested).
+ */
+export declare function DyFM_resolveRetentionTtlSeconds(retention?: DyFM_RetentionSettings): number | undefined;
+export declare class DyFM_DataModel_Settings<T extends DyFM_Metadata> extends DyFM_Metadata {
+    /** this will be used as db table name, therefore it should be in snake_case,
+     * this also will be used in logs and errors
+     */
+    dataName: string;
+    modelType?: DyFM_DataModel_Type;
+    addArchive?: boolean;
+    /**
+     * If true, the Dynamo NTS will throw an error when trying to modify the data model.
+     *
+     * @default false
+     */
+    forbidModify?: boolean;
+    /**
+     * If true, the Dynamo NTS will throw an error when trying to delete the data model.
+     *
+     * @default false
+     */
+    forbidDelete?: boolean;
+    /**
+     * FR-258 / SR-1 — declarative automatic retention. If set, `DyNTS_App` startup creates a
+     * MongoDB TTL index on `__created`, so MongoDB auto-deletes documents older than the configured
+     * age (no app-level load → prevents the unbounded-growth → OOM class). See {@link DyFM_RetentionSettings}.
+     *
+     * @example { retentionDays: 14 }
+     */
+    retention?: DyFM_RetentionSettings;
+    /**
+     * from these settings we will set the data model properties for the DB.
+     * metadata properties will be added automatically to the data model.
+     */
+    properties: DyFM_DataProperties<T>;
+}
+export declare class DyFM_DataModel_Params<T extends DyFM_Metadata> extends DyFM_DataModel_Settings<T> {
+    readonly stackLocation?: string;
+    constructor(set: DyFM_DataModel_Settings<T>);
+    constructed?(): boolean;
+    /**
+     * BFR-ORGANIZER-001/002 kísérő (generikus): egy property deklarált default-értéke
+     * (`properties[key].default`) — hogy a defaultok EGYETLEN forrásból (a dataParams-ból)
+     * jöjjenek a fogyasztó create-útjain is (pl. `params.priority ?? dataParams.getDefaultValue('priority')`),
+     * ne duplikálódjanak literálként a service-kódban. `undefined`, ha nincs deklarált default.
+     */
+    getDefaultValue?<K extends keyof T>(key: K): T[K] | undefined;
+    setKeysForSubObjectParams?(property: DyFM_DataProperty_Params<any, T>): void;
+}
 //# sourceMappingURL=data-model-params.control-model.d.ts.map