@rotorsoft/act 1.23.6 → 1.23.7

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rotorsoft/act",
   "type": "module",
-  "version": "1.23.6",
+  "version": "1.23.7",
   "description": "act core library",
   "keywords": [
     "typescript",

package/dist/@types/internal/autoclose-config.d.ts

@@ -1,142 +0,0 @@
-/**
- * @module autoclose-config
- * @category Internal
- *
- * Defaults, Zod schema, and resolver for the autoclose knobs on
- * {@link ActOptions} (#837 / epic #802). Split out of `act.ts` so the
- * orchestrator file stays focused on the `Act` class and the
- * autoclose surface lives with the cycle + controller that consume
- * it. The validation pattern matches the rest of the framework —
- * Zod schema with `.min().max().default(...)` per field — so the
- * upcoming policy-factory subs (#838 retention, #839 terminal,
- * #840 cardinality) can `.extend(...)` it for their own
- * per-policy options without reinventing range checks.
- *
- * @internal
- */
-import { z } from "zod";
-import type { ActOptions } from "../act.js";
-/**
- * Default {@link ActOptions.autocloseCycleMinutes}: 720 (12 h).
- *
- * @deprecated The knob it defaults is deprecated (#1175) — the
- * off-window re-check is derived from `autocloseWindow` via
- * {@link next_window_open}, so nothing consumes the cadence. Kept so
- * existing imports and the compat validation keep working; removed in
- * the next major.
- */
-export declare const DEFAULT_AUTOCLOSE_CYCLE_MINUTES = 720;
-/**
- * Default {@link ActOptions.closeBatchSize}: 64.
- *
- * @deprecated Dead since #1090 removed the autoclose sweep — nothing
- * pages the store in batches. Kept for compat; removed in the next
- * major.
- */
-export declare const DEFAULT_CLOSE_BATCH_SIZE = 64;
-/**
- * Default {@link ActOptions.closeYieldMs}: 0.
- *
- * @deprecated Dead since #1090 removed the autoclose sweep — there is
- * no truncate loop to yield between. Kept for compat; removed in the
- * next major.
- */
-export declare const DEFAULT_CLOSE_YIELD_MS = 0;
-/**
- * Default time zone for {@link ActOptions.autocloseWindow} when the
- * operator declares a window without one. UTC keeps the contract
- * timezone-explicit; operators who think in local off-hours pass an
- * IANA name.
- */
-export declare const DEFAULT_AUTOCLOSE_WINDOW_TZ = "UTC";
-/**
- * Zod schema for the autoclose knobs on {@link ActOptions}. Same
- * declarative-validation pattern the framework uses elsewhere
- * (`libs/act/src/config.ts`, every event/action schema, every
- * reaction-option shape). Defaults, ranges, and integer constraints
- * live in one place — no parallel `DEFAULT_*` + `*_MIN` / `*_MAX`
- * declarations to keep in sync. Out-of-range values throw `ZodError`
- * at `act().build()` so misconfiguration surfaces at startup, not
- * on the first cycle tick.
- *
- * @internal
- */
-declare const AutocloseOptionsSchema: z.ZodObject<{
-    autocloseCycleMinutes: z.ZodDefault<z.ZodNumber>;
-    closeBatchSize: z.ZodDefault<z.ZodNumber>;
-    closeYieldMs: z.ZodDefault<z.ZodNumber>;
-    closeOnError: z.ZodDefault<z.ZodBoolean>;
-    autocloseWindow: z.ZodOptional<z.ZodObject<{
-        start: z.ZodNumber;
-        end: z.ZodNumber;
-        timeZone: z.ZodDefault<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-/**
- * Resolved autoclose configuration after validation and default
- * expansion. Reachable through the public root (`@rotorsoft/act`) so
- * fields follow the public-camelCase convention and mirror the
- * `ActOptions` knob names directly — no per-resolver renaming layer.
- */
-export type AutocloseConfig = z.infer<typeof AutocloseOptionsSchema>;
-/**
- * Validate and apply defaults for the autoclose knobs on
- * {@link ActOptions}. Called from `act().build()`. Out-of-range
- * values throw `ZodError` at startup, not on the first cycle tick.
- */
-export declare function resolveAutocloseConfig(options: ActOptions | undefined): AutocloseConfig;
-/**
- * The current hour `[0, 23]` in the given IANA time zone, DST-correct
- * via `Intl`. Split out so the window check can be unit-tested without
- * spinning a controller.
- *
- * @internal
- */
-export declare function hour_in_zone(now: Date, timeZone: string): number;
-/**
- * Whether `now` falls inside the configured off-hours window. The
- * window is half-open on hour boundaries — `[start, end)` — and wraps
- * past midnight when `start > end`. With no window configured every
- * tick runs, so callers treat `undefined` as "always in window."
- *
- * On a DST spring-forward day whose `start` hour is skipped, the window
- * would otherwise be closed for the whole day (the `start` hour never
- * occurs). The gap's replacement instant is admitted so autoclose still
- * runs — see {@link is_dst_gap_open}.
- *
- * @internal
- */
-export declare function in_autoclose_window(window: AutocloseConfig["autocloseWindow"], now: Date): boolean;
-/**
- * The next instant the off-hours window opens at or after `now`. The
- * synthesized autoclose reaction defers to this when a tick lands
- * outside the window — parking until the window actually opens instead
- * of blind-polling on a configured cadence (the pre-#1175 behavior,
- * where a poll interval longer than the window could oscillate around
- * it and miss it repeatedly).
- *
- * Walks forward hour by hour and asks `Intl` for the local hour at each
- * step, so DST transitions resolve exactly the way the runtime's zone
- * database says they do — a 23- or 25-hour day never desynchronizes the
- * walk. The window validates as non-empty at build, and every zone hits
- * each `[0, 23]` hour label within any 48-hour span, so the walk always
- * terminates; the bound is a defensive backstop, with "one day out" as
- * the fallback no real zone can reach.
- *
- * Minute/second offsets within the opening hour are preserved from
- * `now` shifted by whole hours — the contract is hour-granular, matching
- * the window's own `[start, end)` hour semantics.
- *
- * On a DST spring-forward day whose `start` hour is skipped, the `start`
- * hour never occurs, so the minute-preserving walk would never match and
- * the window would defer ~24 h. The walk also checks each hour-aligned
- * boundary for the gap opening (see {@link is_dst_gap_open}) and returns
- * that boundary instant — deferring ~1 h to the replacement instant
- * rather than a full day. The boundary is returned as-is (no minute
- * offset): the gap opening is a single transition instant, not a range.
- *
- * @internal
- */
-export declare function next_window_open(window: NonNullable<AutocloseConfig["autocloseWindow"]>, now: Date): Date;
-export {};
-//# sourceMappingURL=autoclose-config.d.ts.map

package/dist/@types/internal/autoclose-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"autoclose-config.d.ts","sourceRoot":"","sources":["../../../src/internal/autoclose-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AAkDjD;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,sBAAsB;;;;;;;;;;iBAgB1B,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,UAAU,GAAG,SAAS,GAC9B,eAAe,CAQjB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOhE;AAsCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,CAAC,iBAAiB,CAAC,EAC1C,GAAG,EAAE,IAAI,GACR,OAAO,CAOT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,EACvD,GAAG,EAAE,IAAI,GACR,IAAI,CAeN"}