@neohm/nestend 3.0.5 → 3.1.0

package/README.md

@@ -87,7 +87,7 @@ app.useGlobalInterceptors(
 | Entities          | `RootEntity`, `CommonEntity`, `CommonAdminEntity`, `UserEntity`, `AdminUserEntity`, `SystemRoleEntity`, `SystemAdminRoleEntity`, ...                      | uuid PK, soft deletes, `created_by`, jsonb `attributes`; entity-level `findOneOrNew`, `softDelete`, `hardDelete`, `restore`, `paginate` statics                                                                                                                   |
 | Migrations        | `CreateSysUsersTable...` (26 files, one per table), `MigrationUtility`, `SeederUtility`                                                                   | fluent `this.string()`, `this.numeric()`, `addRecord()` seeding                                                                                                                                                                                                   |
 | Queue             | `QueueModule`, `QueueService`, `CommonJob`, `JobConsumer`                                                                                                 | BullMQ `@Processor`/`WorkerHost` consumer; auto-discovered jobs, duplicate prevention, recurring schedulers, 1-day TTL, retries, failures persisted to `sys_failed_jobs`                                                                                          |
-| Scheduled events  | `SystemScheduledTaskEntity`, `ScheduledEventEntity`, `SetScheduledEventJob`, `DispatchScheduledEventJob`                                                  | schedule definitions in `sys_scheduled_tasks` → events in `sys_scheduled_events`; worker-driven materialisation + fire-once dispatch, cadence via `SCHEDULED_EVENT_MIN`                                                                                           |
+| Scheduled events  | `SystemScheduledTaskEntity`, `ScheduledEventEntity`, `SetScheduledEventJob`, `DispatchScheduledEventJob`, `ScheduleResolver`                               | schedule definitions in `sys_scheduled_tasks` → events in `sys_scheduled_events`; interval / cron / once specs with timezones, drift-free slots, horizon materialisation, catch-up + overlap policies, fire-once dispatch with backoff, cadence via `SCHEDULED_EVENT_MIN` |
 | Auth              | `AuthModule`, `AuthService.validateRole()`, `Auth`, `JwtMiddleware`, `GoogleAuthService`                                                                  | imperative auth (open by default); JwtMiddleware resolves the user into `Auth`'s AsyncLocalStorage context per request; access + rotating refresh tokens; session-based logout invalidation (`sys_auth_sessions`); Google SSO via ID token at `POST /auth/google` |
 | Admin auth        | `AdminAuthService.validateRole()`, `AdminAuth`, `AdminJwtMiddleware`, `AdminAuthController` (`/admin/auth`)                                               | fully separate stack for back-office admins — own users table (`sys_admin_users`), own roles (`sys_admin_roles`/`sys_auser_roles`), own sessions/refresh tokens (shared tables, `is_admin` flag)                                                                  |
 | API keys          | `ApiKeyService`, `ApiKeyGuard` / `ApiKeyMiddleware`, `@ApiKeyScopes()`, `ScopeEntity`, `ApiScopeEntity`                                                   | hashed keys in `sys_api_keys` (admin-owned), scopes, expiry/revocation, `x-api-key` header; normalized scopes catalogue in `sys_scopes`/`sys_api_scopes`                                                                                                          |
@@ -270,6 +270,8 @@ admin with the `admin` role can grant `sys_admin_roles` to other admins via
 | `BULL_JOB_TTL_SECONDS`              | `86400`       | Retention (seconds) for completed/failed jobs before removal from the queue + Redis (default 1 day) |
 | `MAX_JOB_RETRIES`                   | `3`           | Max attempts per job (BullMQ `attempts` default) and the scheduled-event retry ceiling              |
 | `SCHEDULED_EVENT_MIN`               | `0`           | `SetScheduledEventJob` cadence in minutes (every N minutes); `0`/unset disables self-scheduling     |
+| `SCHEDULED_EVENT_HORIZON_MIN`       | _(derived)_   | How far ahead occurrences are materialised; defaults to 2× the cadence, floored at one minute       |
+| `SCHEDULED_EVENT_BATCH`             | `500`         | Occurrences dispatched per pass                                                                     |
 | `ENABLE_SCHEDULED_EVENTS_EXECUTION` | _unset_       | Must be exactly `true` to arm scheduled-event materialisation and dispatch                          |
 
 #### Jobs
@@ -327,10 +329,10 @@ therefore invisible to `retryJob(jobId)`. API instances leave
 Recurring work is event-driven (off the BullMQ worker), not a reconciliation
 loop. Two tables back it:
 
-| Table                  | Entity                      | Role                                                                                                                                   |
-| ---------------------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| `sys_scheduled_tasks`  | `SystemScheduledTaskEntity` | a schedule definition (`identifier`, `name`, `start_from`, `schedule_interval`, `enabled`, `next_upsert_at`)                           |
-| `sys_scheduled_events` | `ScheduledEventEntity`      | one row per fire time (`job_id` → task, `scheduled_at`, `started_at`, `failed_at`, `total_attempts`, `active`); one task → many events |
+| Table                  | Entity                      | Role                                                                                                                                                                                    |
+| ---------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `sys_scheduled_tasks`  | `SystemScheduledTaskEntity` | a schedule definition (`identifier`, `name`, `start_from`, `schedule`, `timezone`, `payload`, `catch_up_policy`, `max_catchup`, `overlap_policy`, `jitter_sec`, `enabled`, `next_upsert_at`) |
+| `sys_scheduled_events` | `ScheduledEventEntity`      | one row per fire time (`job_id` → task, `scheduled_at`, `status`, `next_attempt_at`, `started_at`, `failed_at`, `total_attempts`, `active`); one task → many events                       |
 
 `JobConsumer` enrols `SetScheduledEventJob` as a recurring scheduler once **both**
 the worker's Redis connection is ready and the application has bootstrapped —
@@ -343,37 +345,135 @@ the worker is ready rather than one cadence later.
 
 Cadence comes from `SCHEDULED_EVENT_MIN` — every N minutes (`0`/unset disables it).
 BullMQ keys the scheduler on the job identifier, so re-running on each boot
-**upserts** rather than duplicates. Per-task schedules are separate: each
-`sys_scheduled_tasks` row carries its own `{hour, min, sec}` `schedule_interval`.
-
-Each tick, `SetScheduledEventJob.handle()` materialises due
-`sys_scheduled_events` rows from enabled `sys_scheduled_tasks` (using
-`ScheduleUtility.addInterval`) and triggers `DispatchScheduledEventJob`, which
-enqueues each due event's job. Set `ENABLE_SCHEDULED_EVENTS_EXECUTION=true` to
-arm it — the value must be exactly `true`.
-
-Each occurrence fires **once**. A pass claims an event by stamping `started_at`
-under a `started_at IS NULL` condition, incrementing `total_attempts` in the same
-statement, and only enqueues if that claim affected a row — so two concurrent
-passes cannot both dispatch it. Stamped rows are excluded from the due set. A
-failed enqueue releases the claim (`started_at` back to null) and records
-`failed_at`/`error`, so the event is retried on later ticks until `total_attempts`
-reaches `MAX_JOB_RETRIES` (default 3).
-
-Because the claim is written before the enqueue, dispatch is **at-most-once**: if
-the process dies in the window between them, that occurrence is skipped rather
-than dispatched twice. Once a job is on the queue, BullMQ's own `attempts` governs
-its retries.
+**upserts** rather than duplicates. Set `ENABLE_SCHEDULED_EVENTS_EXECUTION=true` to
+arm materialisation and dispatch — the value must be exactly `true`.
+
+##### Schedule kinds
+
+Each task's `schedule` column is a discriminated JSONB spec, so expressing a new
+kind of "when" never changes the schema:
+
+| `kind`     | Shape                                     | Example                                     |
+| ---------- | ----------------------------------------- | ------------------------------------------- |
+| `interval` | `{ kind, day?, hour?, min?, sec? }`       | `{ kind: 'interval', hour: 6 }`             |
+| `cron`     | `{ kind, expression }` (5- or 6-field)    | `{ kind: 'cron', expression: '0 2 * * MON' }` |
+| `once`     | `{ kind }` — fires at `start_from`, then retires | `{ kind: 'once' }`                    |
+
+`cron` is what expresses day-, weekday- and month-based schedules, evaluated in the
+task's `timezone` (IANA name, default `UTC`) so a local wall time stays put across
+DST. Each kind is advanced by a pure `ScheduleResolver` registered in
+`baseScheduleResolverMaps`; adding a kind means adding a resolver, not touching the
+materialiser. Rows written before `schedule` carried a `kind` are read as intervals
+by `ScheduleUtility.normalise`, so no backfill is needed.
+
+##### Slots are derived from slots, not from `now`
+
+`next_upsert_at` is the cursor — the next slot not yet materialised — and every slot
+is computed from the **previous slot**. Anchoring on `now` instead would fold each
+pass's lateness into the next fire time permanently: an hourly task polled every
+five minutes would slide by up to five minutes per occurrence, roughly two hours a
+day. `start_from` is itself the first candidate slot, so a task fires at the time it
+was asked to start rather than one interval later.
+
+##### Horizon materialisation
+
+A pass materialises every slot up to `now + horizon`, not one slot at a time. The
+horizon defaults to twice the driver cadence (`SCHEDULED_EVENT_HORIZON_MIN`
+overrides it, floored at a minute), so an occurrence always exists before it comes
+due. The cadence therefore bounds only how far ahead work is prepared — it is **not
+a floor on schedule granularity**. A `{ sec: 30 }` task materialises every
+30-second slot even when the driver polls every few minutes.
+
+##### Catch-up, overlap and jitter
+
+What happens to fire times missed while the scheduler was down is a per-task
+decision (`catch_up_policy`), not an accident:
+
+| Policy         | Behaviour                                                                  |
+| -------------- | -------------------------------------------------------------------------- |
+| `skip_missed`  | advance past them, materialise nothing                                     |
+| `fire_once`    | **default** — materialise only the most recent elapsed slot                |
+| `fire_all`     | materialise every elapsed slot, retaining the most recent `max_catchup`    |
+
+Discarded slots are counted and logged; a silent gap would read as "nothing was
+scheduled". The elapsed-slot walk is bounded by `ScheduleDefault.MAX_SCAN`, and a
+fast-forward is logged too.
+
+`overlap_policy: skip_when_due_pending` holds the cursor while an already-due
+occurrence of the same task is still undispatched. It suppresses **dispatch
+backlog**, not overlapping runs — once an occurrence is on the queue its completion
+lives in BullMQ and is invisible here. Nothing is discarded when it engages: the
+slots stay unmaterialised and the catch-up policy decides later. `jitter_sec` adds a
+random spread to each fire time so tasks sharing a schedule do not stampede; the
+jitter lands on the occurrence, never on the cursor, so it cannot accumulate.
+
+##### Creating and editing a task
+
+`POST /api/admin/scheduled-tasks` is an upsert. `AddScheduledTaskDto` extends
+`CommonPayloadDto`, so it carries an optional `id`: send one to edit that task, omit
+it to create. `identifier`, `name` and `schedule` are required by the DTO either way;
+`identifier` uniqueness is checked in the processor, excluding the row being edited.
+
+Changing what the schedule **means** — `schedule`, `timezone` or `start_from` —
+additionally re-seats the cursor and soft-deletes occurrences that are `pending` and
+not yet due, both in one transaction with the save so a materialisation pass landing
+mid-edit cannot leave stale slots behind. Already-due occurrences are kept (the old
+schedule genuinely asked for that work), and anything `claimed`/`enqueued`/`failed`/
+`abandoned` is left alone. Schedules are compared by meaning — interval millisecond
+sum, cron expression — so renaming a task or editing its payload never moves its
+fire times.
+
+The cursor is seeded by `seedScheduleCursor`, not set to `start_from` directly: the
+materialiser trusts the cursor to be a real slot of the series. `start_from` is only
+a valid slot for `interval` (which re-anchors onto it) and `once` (whose only slot it
+is); a cron series snaps forward to its first real slot at or after the anchor, so a
+`0 2 * * MON` task doesn't fire once at whatever minute it was saved. A past
+`start_from` is clamped to `now` for the recurring kinds, so creating a task doesn't
+hand the catch-up policy a backlog it never asked for.
+
+##### Occurrence lifecycle
+
+`status` carries where an occurrence is; `active` is orthogonal and carries
+suppression by the parent task.
+
+| Status      | Meaning                                                                              |
+| ----------- | ------------------------------------------------------------------------------------ |
+| `pending`   | awaiting dispatch; `next_attempt_at` gates eligibility                               |
+| `claimed`   | a pass owns it — a row stuck here means the process died between claim and enqueue    |
+| `enqueued`  | handed to the queue (terminal); BullMQ's own `attempts` governs it from there         |
+| `failed`    | last enqueue failed; retried once `next_attempt_at` passes                            |
+| `abandoned` | attempts exhausted — terminal and queryable, not merely absent from the due set       |
+
+Each occurrence fires **once**. A pass claims an event by moving it to `claimed`
+under a still-dispatchable condition, incrementing `total_attempts` in the same
+statement, and only enqueues if that claim affected a row — so two concurrent passes
+cannot both dispatch it. Because the claim is written before the enqueue, dispatch
+is **at-most-once**: if the process dies between them the occurrence is skipped
+rather than dispatched twice, and it stays visible as `claimed`.
+
+A failed enqueue releases the claim, records `failed_at`/`error`, and pushes
+`next_attempt_at` out by an exponential backoff (60s doubling per attempt, capped at
+an hour), so a broken task is not retried on every tick. Once `total_attempts`
+reaches `MAX_JOB_RETRIES` (default 3) the occurrence is moved to `abandoned`.
+Dispatch reads oldest-first, bounded by `SCHEDULED_EVENT_BATCH` (default 500); the
+`(status, scheduled_at)` index seeks to the due set and already yields it in
+`ORDER BY` order.
 
 Materialisation is safe to run concurrently — `BULL_WORKERS` defaults to 2, and
-several worker instances may share one queue. Each due task is **claimed** before
-its event is created: a conditional `UPDATE` re-asserts `next_upsert_at < now`
-while advancing it, so a second racing pass matches zero rows and skips the task.
-The claim and the insert share a transaction, so a crash between them cannot
-advance the schedule without creating the occurrence it accounted for.
-`SystemScheduledTaskJob` (via `SystemScheduledTaskSubscriber`) keeps events in
-step with task changes — toggling `active` when a task is enabled/disabled and
-soft-deleting events when a task is removed.
+several worker instances may share one queue. Each task's slots are **claimed**
+before their events are created: a conditional `UPDATE` re-asserts
+`next_upsert_at < horizonEnd` while advancing the cursor, so a second racing pass
+matches zero rows and skips the task. The claim and the inserts share a transaction,
+so a crash between them cannot advance the cursor without creating the occurrences
+it accounted for. `SystemScheduledTaskJob` (via `SystemScheduledTaskSubscriber`)
+keeps events in step with task changes — toggling `active` when a task is
+enabled/disabled and soft-deleting events when a task is removed.
+
+> `sys_scheduled_events` is append-only — nothing in the package prunes it, and
+> horizon materialisation writes a row per slot. Bounding it with a retention sweep
+> over terminal rows (`enqueued`, `abandoned`) older than a cutoff is left to the
+> application; the `(status, scheduled_at)` index covers that delete. Never prune
+> `pending` or `failed` rows — those are live work.
 
 `DispatchScheduledEventJob` enqueues each due event under **the scheduled task's
 own `identifier`**, so register a job in your app whose identifier matches the
@@ -643,12 +743,12 @@ pass the actor to a processor.
 
 | Route                              | Min. role       | Processor                    |
 | ---------------------------------- | --------------- | ---------------------------- |
-| `POST /admin/tenants`              | super admin     | `TenantDataProcessor`        |
+| `POST /admin/tenants`              | super admin     | `TenantDataProcessor` (upsert — send `id` to update) |
 | `POST /admin/tenants/list`         | admin           | `TenantListProcessor`        |
 | `POST /admin/users/clients`        | super admin     | `ClientUserDataProcessor`    |
 | `POST /admin/users/clients/bulk`   | super admin     | `BulkUserDataProcessor`      |
 | `POST /admin/users/admins`         | admin           | `AdminUserDataProcessor`     |
-| `POST /admin/scheduled-tasks`      | content manager | `ScheduledTaskDataProcessor` |
+| `POST /admin/scheduled-tasks`      | content manager | `ScheduledTaskDataProcessor` (upsert — send `id` to update) |
 | `POST /admin/scheduled-tasks/list` | content reader  | `ScheduledTaskListProcessor` |
 
 List endpoints are `POST .../list` with the filter payload in the body (a
@@ -678,6 +778,30 @@ Onboarding a tenant (`tenant-onboarded`) or a single client user
 `AdminModule` imports `NotificationModule` and `SystemPropertyModule`; bulk
 registration deliberately sends nothing.
 
+##### Create vs. update
+
+Creation DTOs extend `CommonPayloadDto`, which carries an optional UUID `id`. Where a
+processor supports it, sending an `id` turns the same `POST` into an update.
+
+The processor loads the row when an `id` is present, falls back to `Entity.create()`
+when it isn't, then assigns every field and saves — one path, no create/update
+branching. Required fields stay **required in the DTO** (`@IsNotEmpty()`, `@IsString()`,
+…), so the payload always describes the whole record and validation stays where the
+decorators are. Omitting an *optional* field leaves it unchanged on an edit, since
+TypeORM skips `undefined` properties on update.
+
+Processors only validate what decorators cannot see: whether the `id` exists, and
+uniqueness against other rows. Uniqueness checks (tenant `slug`, scheduled-task
+`identifier`) exclude the row being edited — they run in code rather than as DB
+constraints, so resaving a record must not collide with itself.
+
+| Processor | Update | Notes |
+| --------- | ------ | ----- |
+| `TenantDataProcessor` | yes | Never re-runs onboarding: `onboarded_at`, `created_by` and the welcome email belong to first registration |
+| `ScheduledTaskDataProcessor` | yes | Changing `schedule`/`timezone`/`start_from` also re-seats the cursor and drops not-yet-due occurrences |
+| `ClientUserDataProcessor`, `AdminUserDataProcessor` | not yet | Their DTOs carry `id`, but the processors are still create-only. Password and role changes are intended to get their own endpoints rather than riding on an upsert |
+| `BulkUserDataProcessor` | n/a | `AddBulkUsersDto` is a batch wrapper, not a record; each `BulkUserItemDto` carries an `id` |
+
 Data processors extend `CommonDataProcessor` and are created per request
 (`new XxxDataProcessor(...deps).process(dto)`); list processors return a
 `PaginatedResult`. Bulk registration validates the entire batch before any insert.

package/dist/admin/admin.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin.module.d.ts","sourceRoot":"","sources":["../../src/admin/admin.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAIvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAc9D,qBAMa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAE,kBAAuB,GAAG,aAAa;CAcjE"}
+{"version":3,"file":"admin.module.d.ts","sourceRoot":"","sources":["../../src/admin/admin.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAIvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAY9D,qBAMa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAE,kBAAuB,GAAG,aAAa;CAcjE"}

package/dist/admin/admin.module.js

@@ -14,7 +14,6 @@ const tenant_module_1 = require("../tenant/tenant.module");
 const es6_classes_1 = require("./es6.classes");
 const notification_module_1 = require("../notification/notification.module");
 const system_property_module_1 = require("../common/system.property.module");
-const [AdminAccessService] = es6_classes_1.es6Classes.services;
 let AdminModule = AdminModule_1 = class AdminModule {
     static register(options = {}) {
         return {

package/dist/admin/admin.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin.module.js","sourceRoot":"","sources":["../../src/admin/admin.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,qDAAiD;AACjD,2DAAuD;AACvD,+CAA2C;AAE3C,6EAAyE;AACzE,6EAAwE;AAGxE,MAAM,CAAC,kBAAkB,CAAC,GAAG,wBAAU,CAAC,QAAQ,CAAC;AAkB1C,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,UAA8B,EAAE;QAC9C,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,OAAO,EAAE;gBACP,wBAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC5B,4BAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC9B,wCAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACpC,6CAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC;aACvC;YACD,WAAW,EAAE,CAAC,GAAG,wBAAU,CAAC,WAAW,CAAC;YACxC,SAAS,EAAE,CAAC,GAAG,wBAAU,CAAC,QAAQ,CAAC;YACnC,OAAO,EAAE,CAAC,GAAG,wBAAU,CAAC,QAAQ,CAAC;SAClC,CAAC;IACJ,CAAC;CACF,CAAA;AAfY,kCAAW;sBAAX,WAAW;IANvB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,wBAAU,EAAE,4BAAY,EAAE,wCAAkB,EAAE,6CAAoB,CAAC;QAC7E,WAAW,EAAE,CAAC,GAAG,wBAAU,CAAC,WAAW,CAAC;QACxC,SAAS,EAAE,CAAC,GAAG,wBAAU,CAAC,QAAQ,CAAC;QACnC,OAAO,EAAE,CAAC,GAAG,wBAAU,CAAC,QAAQ,CAAC;KAClC,CAAC;GACW,WAAW,CAevB"}
+{"version":3,"file":"admin.module.js","sourceRoot":"","sources":["../../src/admin/admin.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,qDAAiD;AACjD,2DAAuD;AACvD,+CAA2C;AAE3C,6EAAyE;AACzE,6EAAwE;AAmBjE,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,UAA8B,EAAE;QAC9C,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,OAAO,EAAE;gBACP,wBAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC5B,4BAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC9B,wCAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACpC,6CAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC;aACvC;YACD,WAAW,EAAE,CAAC,GAAG,wBAAU,CAAC,WAAW,CAAC;YACxC,SAAS,EAAE,CAAC,GAAG,wBAAU,CAAC,QAAQ,CAAC;YACnC,OAAO,EAAE,CAAC,GAAG,wBAAU,CAAC,QAAQ,CAAC;SAClC,CAAC;IACJ,CAAC;CACF,CAAA;AAfY,kCAAW;sBAAX,WAAW;IANvB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,wBAAU,EAAE,4BAAY,EAAE,wCAAkB,EAAE,6CAAoB,CAAC;QAC7E,WAAW,EAAE,CAAC,GAAG,wBAAU,CAAC,WAAW,CAAC;QACxC,SAAS,EAAE,CAAC,GAAG,wBAAU,CAAC,QAAQ,CAAC;QACnC,OAAO,EAAE,CAAC,GAAG,wBAAU,CAAC,QAAQ,CAAC;KAClC,CAAC;GACW,WAAW,CAevB"}

package/dist/admin/controllers/admin.scheduled.task.controller.d.ts

@@ -6,7 +6,7 @@ export declare class AdminScheduledTaskController {
     private readonly adminAccessService;
     private readonly sqlService;
     constructor(adminAccessService: AdminAccessService, sqlService: SqlService);
-    add(dto: AddScheduledTaskDto): Promise<import("../..").SystemScheduledTaskEntity>;
+    save(dto: AddScheduledTaskDto): Promise<import("../..").SystemScheduledTaskEntity>;
     list(dto: ScheduledTaskListDto): Promise<{
         records: import("../..").SqlRow[];
         total: number;

package/dist/admin/controllers/admin.scheduled.task.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin.scheduled.task.controller.d.ts","sourceRoot":"","sources":["../../../src/admin/controllers/admin.scheduled.task.controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,qBAGa,4BAA4B;IAErC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,kBAAkB,EAAE,kBAAkB,EACtC,UAAU,EAAE,UAAU;IAQnC,GAAG,CAAS,GAAG,EAAE,mBAAmB;IAUpC,IAAI,CAAS,GAAG,EAAE,oBAAoB;;;;;;;CAI7C"}
+{"version":3,"file":"admin.scheduled.task.controller.d.ts","sourceRoot":"","sources":["../../../src/admin/controllers/admin.scheduled.task.controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,qBAGa,4BAA4B;IAErC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,kBAAkB,EAAE,kBAAkB,EACtC,UAAU,EAAE,UAAU;IASnC,IAAI,CAAS,GAAG,EAAE,mBAAmB;IAUrC,IAAI,CAAS,GAAG,EAAE,oBAAoB;;;;;;;CAI7C"}

package/dist/admin/controllers/admin.scheduled.task.controller.js

@@ -26,7 +26,7 @@ let AdminScheduledTaskController = class AdminScheduledTaskController {
         this.adminAccessService = adminAccessService;
         this.sqlService = sqlService;
     }
-    async add(dto) {
+    async save(dto) {
         const { user } = await this.adminAccessService.validateContentManager();
         return new scheduled_task_data_processor_1.ScheduledTaskDataProcessor(user).process(dto);
     }
@@ -39,14 +39,14 @@ exports.AdminScheduledTaskController = AdminScheduledTaskController;
 __decorate([
     (0, common_1.Post)(),
     (0, swagger_1.ApiOperation)({
-        summary: 'Add a scheduled task.',
-        description: 'Requires at least the global content manager role.',
+        summary: 'Add or update a scheduled task.',
+        description: 'Send an `id` to edit that task, or omit it to create one; omitted optional fields keep their stored value. Changing `schedule`, `timezone` or `start_from` re-seats the cursor and discards occurrences that were materialised under the old schedule but are not yet due. Requires at least the global content manager role.',
     }),
     __param(0, (0, common_1.Body)()),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [add_scheduled_task_dto_1.AddScheduledTaskDto]),
     __metadata("design:returntype", Promise)
-], AdminScheduledTaskController.prototype, "add", null);
+], AdminScheduledTaskController.prototype, "save", null);
 __decorate([
     (0, common_1.Post)('list'),
     (0, swagger_1.ApiOperation)({

package/dist/admin/controllers/admin.scheduled.task.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin.scheduled.task.controller.js","sourceRoot":"","sources":["../../../src/admin/controllers/admin.scheduled.task.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAwD;AACxD,6CAAuE;AACvE,mEAA+D;AAC/D,2EAAsE;AACtE,8FAAwF;AACxF,8FAAwF;AACxF,2EAAqE;AACrE,6EAAuE;AAKhE,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IACvC,YACmB,kBAAsC,EACtC,UAAsB;QADtB,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,eAAU,GAAV,UAAU,CAAY;IACtC,CAAC;IAOE,AAAN,KAAK,CAAC,GAAG,CAAS,GAAwB;QACxC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,sBAAsB,EAAE,CAAC;QACxE,OAAO,IAAI,0DAA0B,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAOK,AAAN,KAAK,CAAC,IAAI,CAAS,GAAyB;QAC1C,MAAM,IAAI,CAAC,kBAAkB,CAAC,qBAAqB,EAAE,CAAC;QACtD,OAAO,IAAI,0DAA0B,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;CACF,CAAA;AAzBY,oEAA4B;AAWjC;IALL,IAAA,aAAI,GAAE;IACN,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,uBAAuB;QAChC,WAAW,EAAE,oDAAoD;KAClE,CAAC;IACS,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAM,4CAAmB;;uDAGzC;AAOK;IALL,IAAA,aAAI,EAAC,MAAM,CAAC;IACZ,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,0CAA0C;QACnD,WAAW,EAAE,mDAAmD;KACjE,CAAC;IACU,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAM,8CAAoB;;wDAG3C;uCAxBU,4BAA4B;IAHxC,IAAA,iBAAO,EAAC,yBAAyB,CAAC;IAClC,IAAA,uBAAa,GAAE;IACf,IAAA,mBAAU,EAAC,2BAA2B,CAAC;qCAGC,yCAAkB;QAC1B,wBAAU;GAH9B,4BAA4B,CAyBxC"}
+{"version":3,"file":"admin.scheduled.task.controller.js","sourceRoot":"","sources":["../../../src/admin/controllers/admin.scheduled.task.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAwD;AACxD,6CAAuE;AACvE,mEAA+D;AAC/D,2EAAsE;AACtE,8FAAwF;AACxF,8FAAwF;AACxF,2EAAqE;AACrE,6EAAuE;AAKhE,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IACvC,YACmB,kBAAsC,EACtC,UAAsB;QADtB,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,eAAU,GAAV,UAAU,CAAY;IACtC,CAAC;IAQE,AAAN,KAAK,CAAC,IAAI,CAAS,GAAwB;QACzC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,sBAAsB,EAAE,CAAC;QACxE,OAAO,IAAI,0DAA0B,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAOK,AAAN,KAAK,CAAC,IAAI,CAAS,GAAyB;QAC1C,MAAM,IAAI,CAAC,kBAAkB,CAAC,qBAAqB,EAAE,CAAC;QACtD,OAAO,IAAI,0DAA0B,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;CACF,CAAA;AA1BY,oEAA4B;AAYjC;IANL,IAAA,aAAI,GAAE;IACN,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,iCAAiC;QAC1C,WAAW,EACT,+TAA+T;KAClU,CAAC;IACU,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAM,4CAAmB;;wDAG1C;AAOK;IALL,IAAA,aAAI,EAAC,MAAM,CAAC;IACZ,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,0CAA0C;QACnD,WAAW,EAAE,mDAAmD;KACjE,CAAC;IACU,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAM,8CAAoB;;wDAG3C;uCAzBU,4BAA4B;IAHxC,IAAA,iBAAO,EAAC,yBAAyB,CAAC;IAClC,IAAA,uBAAa,GAAE;IACf,IAAA,mBAAU,EAAC,2BAA2B,CAAC;qCAGC,yCAAkB;QAC1B,wBAAU;GAH9B,4BAA4B,CA0BxC"}

package/dist/admin/controllers/admin.tenant.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin.tenant.controller.d.ts","sourceRoot":"","sources":["../../../src/admin/controllers/admin.tenant.controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wDAAwD,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAEtF,qBAGa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,wBAAwB;IACzC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;gBAHrB,kBAAkB,EAAE,kBAAkB,EACtC,UAAU,EAAE,UAAU,EACtB,wBAAwB,EAAE,wBAAwB,EAClD,qBAAqB,EAAE,qBAAqB;IAQzD,OAAO,CAAS,GAAG,EAAE,YAAY;IAejC,IAAI,CAAS,GAAG,EAAE,aAAa;;;;;;;CAItC"}
+{"version":3,"file":"admin.tenant.controller.d.ts","sourceRoot":"","sources":["../../../src/admin/controllers/admin.tenant.controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wDAAwD,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAEtF,qBAGa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,wBAAwB;IACzC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;gBAHrB,kBAAkB,EAAE,kBAAkB,EACtC,UAAU,EAAE,UAAU,EACtB,wBAAwB,EAAE,wBAAwB,EAClD,qBAAqB,EAAE,qBAAqB;IASzD,OAAO,CAAS,GAAG,EAAE,YAAY;IAejC,IAAI,CAAS,GAAG,EAAE,aAAa;;;;;;;CAItC"}

package/dist/admin/controllers/admin.tenant.controller.js

@@ -43,8 +43,8 @@ exports.AdminTenantController = AdminTenantController;
 __decorate([
     (0, common_1.Post)(),
     (0, swagger_1.ApiOperation)({
-        summary: 'Onboard (register) a new client tenant.',
-        description: 'Requires the global super admin role.',
+        summary: 'Onboard a new client tenant, or update an existing one.',
+        description: 'Send an `id` to edit that tenant; omit it to onboard a new one. Omitted optional fields keep their stored value. An edit never re-runs onboarding — `onboarded_at`, `created_by` and the welcome email belong to first registration. Requires the global super admin role.',
     }),
     __param(0, (0, common_1.Body)()),
     __metadata("design:type", Function),

package/dist/admin/controllers/admin.tenant.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin.tenant.controller.js","sourceRoot":"","sources":["../../../src/admin/controllers/admin.tenant.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAwD;AACxD,6CAAuE;AACvE,mEAA+D;AAC/D,2EAAsE;AACtE,8EAAyE;AACzE,8EAAyE;AACzE,2DAAsD;AACtD,6DAAwD;AACxD,uGAAkG;AAClG,2FAAsF;AAK/E,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YACmB,kBAAsC,EACtC,UAAsB,EACtB,wBAAkD,EAClD,qBAA4C;QAH5C,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,eAAU,GAAV,UAAU,CAAY;QACtB,6BAAwB,GAAxB,wBAAwB,CAA0B;QAClD,0BAAqB,GAArB,qBAAqB,CAAuB;IAC5D,CAAC;IAOE,AAAN,KAAK,CAAC,OAAO,CAAS,GAAiB;QACrC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,CAAC;QAEpE,OAAO,IAAI,2CAAmB,CAC5B,IAAI,EACJ,IAAI,CAAC,wBAAwB,EAC7B,IAAI,CAAC,qBAAqB,CAC3B,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAOK,AAAN,KAAK,CAAC,IAAI,CAAS,GAAkB;QACnC,MAAM,IAAI,CAAC,kBAAkB,CAAC,aAAa,EAAE,CAAC;QAC9C,OAAO,IAAI,2CAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;CACF,CAAA;AAhCY,sDAAqB;AAa1B;IALL,IAAA,aAAI,GAAE;IACN,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,yCAAyC;QAClD,WAAW,EAAE,uCAAuC;KACrD,CAAC;IACa,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAM,6BAAY;;oDAQtC;AAOK;IALL,IAAA,aAAI,EAAC,MAAM,CAAC;IACZ,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EAAE,0CAA0C;KACxD,CAAC;IACU,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAM,+BAAa;;iDAGpC;gCA/BU,qBAAqB;IAHjC,IAAA,iBAAO,EAAC,iBAAiB,CAAC;IAC1B,IAAA,uBAAa,GAAE;IACf,IAAA,mBAAU,EAAC,mBAAmB,CAAC;qCAGS,yCAAkB;QAC1B,wBAAU;QACI,qDAAwB;QAC3B,+CAAqB;GALpD,qBAAqB,CAgCjC"}
+{"version":3,"file":"admin.tenant.controller.js","sourceRoot":"","sources":["../../../src/admin/controllers/admin.tenant.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAwD;AACxD,6CAAuE;AACvE,mEAA+D;AAC/D,2EAAsE;AACtE,8EAAyE;AACzE,8EAAyE;AACzE,2DAAsD;AACtD,6DAAwD;AACxD,uGAAkG;AAClG,2FAAsF;AAK/E,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YACmB,kBAAsC,EACtC,UAAsB,EACtB,wBAAkD,EAClD,qBAA4C;QAH5C,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,eAAU,GAAV,UAAU,CAAY;QACtB,6BAAwB,GAAxB,wBAAwB,CAA0B;QAClD,0BAAqB,GAArB,qBAAqB,CAAuB;IAC5D,CAAC;IAQE,AAAN,KAAK,CAAC,OAAO,CAAS,GAAiB;QACrC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,CAAC;QAEpE,OAAO,IAAI,2CAAmB,CAC5B,IAAI,EACJ,IAAI,CAAC,wBAAwB,EAC7B,IAAI,CAAC,qBAAqB,CAC3B,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAOK,AAAN,KAAK,CAAC,IAAI,CAAS,GAAkB;QACnC,MAAM,IAAI,CAAC,kBAAkB,CAAC,aAAa,EAAE,CAAC;QAC9C,OAAO,IAAI,2CAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;CACF,CAAA;AAjCY,sDAAqB;AAc1B;IANL,IAAA,aAAI,GAAE;IACN,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,yDAAyD;QAClE,WAAW,EACT,4QAA4Q;KAC/Q,CAAC;IACa,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAM,6BAAY;;oDAQtC;AAOK;IALL,IAAA,aAAI,EAAC,MAAM,CAAC;IACZ,IAAA,sBAAY,EAAC;QACZ,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EAAE,0CAA0C;KACxD,CAAC;IACU,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAM,+BAAa;;iDAGpC;gCAhCU,qBAAqB;IAHjC,IAAA,iBAAO,EAAC,iBAAiB,CAAC;IAC1B,IAAA,uBAAa,GAAE;IACf,IAAA,mBAAU,EAAC,mBAAmB,CAAC;qCAGS,yCAAkB;QAC1B,wBAAU;QACI,qDAAwB;QAC3B,+CAAqB;GALpD,qBAAqB,CAiCjC"}

package/dist/admin/dtos/add.admin.user.dto.d.ts

@@ -1,4 +1,5 @@
-export declare class AddAdminUserDto {
+import { CommonPayloadDto } from '../../common/dtos/common.payload.dto';
+export declare class AddAdminUserDto extends CommonPayloadDto {
     name: string;
     email: string;
     username: string;

package/dist/admin/dtos/add.admin.user.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.admin.user.dto.d.ts","sourceRoot":"","sources":["../../../src/admin/dtos/add.admin.user.dto.ts"],"names":[],"mappings":"AAcA,qBAAa,eAAe;IAI1B,IAAI,EAAE,MAAM,CAAC;IAKb,KAAK,EAAE,MAAM,CAAC;IAKd,QAAQ,EAAE,MAAM,CAAC;IAMjB,QAAQ,EAAE,MAAM,CAAC;IAUjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAKnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC"}
+{"version":3,"file":"add.admin.user.dto.d.ts","sourceRoot":"","sources":["../../../src/admin/dtos/add.admin.user.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAGxE,qBAAa,eAAgB,SAAQ,gBAAgB;IAInD,IAAI,EAAE,MAAM,CAAC;IAKb,KAAK,EAAE,MAAM,CAAC;IAKd,QAAQ,EAAE,MAAM,CAAC;IAMjB,QAAQ,EAAE,MAAM,CAAC;IAUjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAKnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC"}

package/dist/admin/dtos/add.admin.user.dto.js

@@ -12,7 +12,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AddAdminUserDto = void 0;
 const class_validator_1 = require("class-validator");
 const swagger_1 = require("@nestjs/swagger");
-class AddAdminUserDto {
+const common_payload_dto_1 = require("../../common/dtos/common.payload.dto");
+class AddAdminUserDto extends common_payload_dto_1.CommonPayloadDto {
 }
 exports.AddAdminUserDto = AddAdminUserDto;
 __decorate([

package/dist/admin/dtos/add.admin.user.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"add.admin.user.dto.js","sourceRoot":"","sources":["../../../src/admin/dtos/add.admin.user.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAUyB;AACzB,6CAAmE;AAGnE,MAAa,eAAe;CAoC3B;AApCD,0CAoCC;AAhCC;IAHC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACpC,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;6CACF;AAKb;IAHC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC5C,IAAA,yBAAO,GAAE;IACT,IAAA,2BAAS,EAAC,GAAG,CAAC;;8CACD;AAKd;IAHC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACpC,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;iDACE;AAMjB;IAJC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACrD,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,CAAC,CAAC;IACZ,IAAA,2BAAS,EAAC,EAAE,CAAC;;iDACG;AAUjB;IARC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,gDAAgD;KAC9D,CAAC;IACD,IAAA,yBAAO,GAAE;IACT,IAAA,8BAAY,EAAC,CAAC,CAAC;IACf,IAAA,wBAAM,EAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;iDACX;AAKnB;IAHC,IAAA,6BAAmB,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;IACnE,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;mDACsB"}
+{"version":3,"file":"add.admin.user.dto.js","sourceRoot":"","sources":["../../../src/admin/dtos/add.admin.user.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAUyB;AACzB,6CAAmE;AACnE,6EAAwE;AAGxE,MAAa,eAAgB,SAAQ,qCAAgB;CAoCpD;AApCD,0CAoCC;AAhCC;IAHC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACpC,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;6CACF;AAKb;IAHC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC5C,IAAA,yBAAO,GAAE;IACT,IAAA,2BAAS,EAAC,GAAG,CAAC;;8CACD;AAKd;IAHC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACpC,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;iDACE;AAMjB;IAJC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACrD,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,CAAC,CAAC;IACZ,IAAA,2BAAS,EAAC,EAAE,CAAC;;iDACG;AAUjB;IARC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,gDAAgD;KAC9D,CAAC;IACD,IAAA,yBAAO,GAAE;IACT,IAAA,8BAAY,EAAC,CAAC,CAAC;IACf,IAAA,wBAAM,EAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;iDACX;AAKnB;IAHC,IAAA,6BAAmB,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;IACnE,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;mDACsB"}

package/dist/admin/dtos/add.scheduled.task.dto.d.ts

@@ -1,13 +1,24 @@
-export declare class ScheduleIntervalDto {
+import { CommonPayloadDto } from '../../common/dtos/common.payload.dto';
+import { CatchUpPolicy, OverlapPolicy, ScheduleKind } from '../../common/enums/schedule.enum';
+export declare class ScheduleDto {
+    kind: ScheduleKind;
+    day?: number;
     hour?: number;
     min?: number;
     sec?: number;
+    expression?: string;
 }
-export declare class AddScheduledTaskDto {
+export declare class AddScheduledTaskDto extends CommonPayloadDto {
     identifier: string;
     name: string;
     start_from?: string;
-    schedule_interval: ScheduleIntervalDto;
+    schedule: ScheduleDto;
+    timezone?: string;
+    payload?: Record<string, unknown>;
+    catch_up_policy?: CatchUpPolicy;
+    max_catchup?: number;
+    overlap_policy?: OverlapPolicy;
+    jitter_sec?: number;
     enabled?: boolean;
 }
 //# sourceMappingURL=add.scheduled.task.dto.d.ts.map

package/dist/admin/dtos/add.scheduled.task.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.scheduled.task.dto.d.ts","sourceRoot":"","sources":["../../../src/admin/dtos/add.scheduled.task.dto.ts"],"names":[],"mappings":"AAcA,qBAAa,mBAAmB;IAK9B,IAAI,CAAC,EAAE,MAAM,CAAC;IAMd,GAAG,CAAC,EAAE,MAAM,CAAC;IAMb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAGD,qBAAa,mBAAmB;IAI9B,UAAU,EAAE,MAAM,CAAC;IAKnB,IAAI,EAAE,MAAM,CAAC;IAQb,UAAU,CAAC,EAAE,MAAM,CAAC;IAKpB,iBAAiB,EAAE,mBAAmB,CAAC;IAKvC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}
+{"version":3,"file":"add.scheduled.task.dto.d.ts","sourceRoot":"","sources":["../../../src/admin/dtos/add.scheduled.task.dto.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EACL,aAAa,EACb,aAAa,EAEb,YAAY,EACb,MAAM,kCAAkC,CAAC;AAW1C,qBAAa,WAAW;IAGtB,IAAI,EAAE,YAAY,CAAC;IAOnB,GAAG,CAAC,EAAE,MAAM,CAAC;IAOb,IAAI,CAAC,EAAE,MAAM,CAAC;IAOd,GAAG,CAAC,EAAE,MAAM,CAAC;IAOb,GAAG,CAAC,EAAE,MAAM,CAAC;IASb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,qBAAa,mBAAoB,SAAQ,gBAAgB;IAQvD,UAAU,EAAE,MAAM,CAAC;IAMnB,IAAI,EAAE,MAAM,CAAC;IASb,UAAU,CAAC,EAAE,MAAM,CAAC;IAUpB,QAAQ,EAAE,WAAW,CAAC;IAStB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAQlB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAUlC,eAAe,CAAC,EAAE,aAAa,CAAC;IAUhC,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,cAAc,CAAC,EAAE,aAAa,CAAC;IAU/B,UAAU,CAAC,EAAE,MAAM,CAAC;IAKpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/admin/dtos/add.scheduled.task.dto.js

@@ -9,64 +9,159 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AddScheduledTaskDto = exports.ScheduleIntervalDto = void 0;
+exports.AddScheduledTaskDto = exports.ScheduleDto = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const swagger_1 = require("@nestjs/swagger");
-class ScheduleIntervalDto {
+const common_payload_dto_1 = require("../../common/dtos/common.payload.dto");
+const schedule_enum_1 = require("../../common/enums/schedule.enum");
+const schedule_validator_1 = require("../../common/validators/schedule.validator");
+class ScheduleDto {
 }
-exports.ScheduleIntervalDto = ScheduleIntervalDto;
+exports.ScheduleDto = ScheduleDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: schedule_enum_1.ScheduleKind, example: schedule_enum_1.ScheduleKind.INTERVAL }),
+    (0, class_validator_1.IsEnum)(schedule_enum_1.ScheduleKind),
+    __metadata("design:type", String)
+], ScheduleDto.prototype, "kind", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ default: 0, minimum: 0 }),
+    (0, class_validator_1.ValidateIf)((dto) => dto.kind === schedule_enum_1.ScheduleKind.INTERVAL),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], ScheduleDto.prototype, "day", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({ default: 0, minimum: 0 }),
+    (0, class_validator_1.ValidateIf)((dto) => dto.kind === schedule_enum_1.ScheduleKind.INTERVAL),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsInt)(),
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
-], ScheduleIntervalDto.prototype, "hour", void 0);
+], ScheduleDto.prototype, "hour", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({ default: 0, minimum: 0 }),
+    (0, class_validator_1.ValidateIf)((dto) => dto.kind === schedule_enum_1.ScheduleKind.INTERVAL),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsInt)(),
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
-], ScheduleIntervalDto.prototype, "min", void 0);
+], ScheduleDto.prototype, "min", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({ default: 0, minimum: 0 }),
+    (0, class_validator_1.ValidateIf)((dto) => dto.kind === schedule_enum_1.ScheduleKind.INTERVAL),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsInt)(),
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
-], ScheduleIntervalDto.prototype, "sec", void 0);
-class AddScheduledTaskDto {
+], ScheduleDto.prototype, "sec", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Required when kind is cron. 5-field or 6-field expression.',
+        example: '0 2 * * MON',
+    }),
+    (0, class_validator_1.ValidateIf)((dto) => dto.kind === schedule_enum_1.ScheduleKind.CRON),
+    (0, class_validator_1.IsString)(),
+    (0, schedule_validator_1.IsCronExpression)(),
+    __metadata("design:type", String)
+], ScheduleDto.prototype, "expression", void 0);
+class AddScheduledTaskDto extends common_payload_dto_1.CommonPayloadDto {
 }
 exports.AddScheduledTaskDto = AddScheduledTaskDto;
 __decorate([
-    (0, swagger_1.ApiProperty)({ example: 'cleanup.expired.tokens' }),
+    (0, swagger_1.ApiProperty)({
+        description: 'Must match the identifier of a registered job.',
+        example: 'cleanup.expired.tokens',
+    }),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.MaxLength)(255),
     __metadata("design:type", String)
 ], AddScheduledTaskDto.prototype, "identifier", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({ example: 'Cleanup expired tokens' }),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.MaxLength)(255),
     __metadata("design:type", String)
 ], AddScheduledTaskDto.prototype, "name", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
-        description: 'When the task first becomes due (ISO 8601). Defaults to now.',
-        example: '2026-07-01T00:00:00.000Z',
+        description: 'First candidate fire time (ISO 8601), and the slot a `once` task uses. Defaults to now.',
+        example: '2026-08-01T02:00:00.000Z',
     }),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsISO8601)(),
     __metadata("design:type", String)
 ], AddScheduledTaskDto.prototype, "start_from", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: ScheduleIntervalDto }),
+    (0, swagger_1.ApiProperty)({
+        type: ScheduleDto,
+        description: 'Changing it re-seats the cursor and discards not-yet-due occurrences.',
+    }),
+    (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.ValidateNested)(),
-    (0, class_transformer_1.Type)(() => ScheduleIntervalDto),
-    __metadata("design:type", ScheduleIntervalDto)
-], AddScheduledTaskDto.prototype, "schedule_interval", void 0);
+    (0, class_transformer_1.Type)(() => ScheduleDto),
+    __metadata("design:type", ScheduleDto)
+], AddScheduledTaskDto.prototype, "schedule", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'IANA zone the schedule is evaluated in.',
+        default: schedule_enum_1.ScheduleDefault.TIMEZONE,
+        example: 'Asia/Kathmandu',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, schedule_validator_1.IsTimezone)(),
+    __metadata("design:type", String)
+], AddScheduledTaskDto.prototype, "timezone", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Passed to the dispatched job as its payload.',
+        example: { batch_size: 500 },
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], AddScheduledTaskDto.prototype, "payload", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        enum: schedule_enum_1.CatchUpPolicy,
+        default: schedule_enum_1.CatchUpPolicy.FIRE_ONCE,
+        description: 'What happens to fire times missed while the scheduler was down.',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(schedule_enum_1.CatchUpPolicy),
+    __metadata("design:type", String)
+], AddScheduledTaskDto.prototype, "catch_up_policy", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        default: schedule_enum_1.ScheduleDefault.MAX_CATCHUP,
+        minimum: 1,
+        description: 'Slots this task may materialise in one pass.',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], AddScheduledTaskDto.prototype, "max_catchup", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ enum: schedule_enum_1.OverlapPolicy, default: schedule_enum_1.OverlapPolicy.ALLOW }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(schedule_enum_1.OverlapPolicy),
+    __metadata("design:type", String)
+], AddScheduledTaskDto.prototype, "overlap_policy", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        default: 0,
+        minimum: 0,
+        description: 'Random spread added to each fire time, in seconds.',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], AddScheduledTaskDto.prototype, "jitter_sec", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({ default: true }),
     (0, class_validator_1.IsOptional)(),