@blokjs/helper 0.2.1 → 0.6.0

package/dist/types/WorkflowOpts.js.map

@@ -1 +1 @@
-{"version":3,"file":"WorkflowOpts.js","sourceRoot":"","sources":["../../src/types/WorkflowOpts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAElE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC;SACL,MAAM,CAAC;QACP,cAAc,EAAE,kBAAkB;QAClC,kBAAkB,EAAE,uBAAuB;KAC3C,CAAC;SACD,GAAG,CAAC,CAAC,CAAC;IACR,OAAO,EAAE,CAAC;SACR,MAAM,CAAC;QACP,cAAc,EAAE,qBAAqB;QACrC,kBAAkB,EAAE,0BAA0B;KAC9C,CAAC;SACD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;IAC9C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAAC,CAAC"}
+{"version":3,"file":"WorkflowOpts.js","sourceRoot":"","sources":["../../src/types/WorkflowOpts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC;SACL,MAAM,CAAC;QACP,cAAc,EAAE,kBAAkB;QAClC,kBAAkB,EAAE,uBAAuB;KAC3C,CAAC;SACD,GAAG,CAAC,CAAC,CAAC;IACR,OAAO,EAAE,CAAC;SACR,MAAM,CAAC;QACP,cAAc,EAAE,qBAAqB;QACrC,kBAAkB,EAAE,0BAA0B;KAC9C,CAAC;SACD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;IAC9C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAIH,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IAC7F,OAAO,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;SAC5C,QAAQ,CAAC,+DAA+D,CAAC;IAC3E,WAAW,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,iFAAiF,CAAC;IAC7F,OAAO,EAAE,CAAC;SACR,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SACnC,QAAQ,EAAE;SACV,QAAQ,CACR,yEAAyE;QACxE,2EAA2E;QAC3E,6EAA6E;QAC7E,sFAAsF,CACvF;IACF,UAAU,EAAE,CAAC;SACX,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,EAAE;SACV,QAAQ,CACR,sFAAsF;QACrF,sFAAsF;QACtF,uFAAuF;QACvF,uFAAuF;QACvF,uEAAuE,CACxE;IACF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oEAAoE,CAAC;CAClH,CAAC,CAAC"}

package/dist/utils/parseDuration.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Parse a duration value to milliseconds.
+ *
+ * Accepts:
+ *   - A non-negative finite number (interpreted as milliseconds)
+ *   - A single-unit string: `"500ms"`, `"30s"`, `"5m"`, `"2h"`, `"1d"`
+ *
+ * Rejects:
+ *   - Negative numbers, NaN, Infinity
+ *   - Empty strings, whitespace-only strings
+ *   - Multi-unit strings (`"1h30m"`) — split into separate fields if needed
+ *   - Fractional values (`"1.5h"`) — express as a smaller unit (`"90m"`)
+ *   - Unknown units (`"5y"`)
+ *
+ * The narrow grammar is deliberate: it makes parsing predictable and
+ * round-trippable. For arbitrarily complex schedules, use the cron trigger.
+ *
+ * @example
+ *   parseDuration(5000)      // → 5000
+ *   parseDuration("500ms")   // → 500
+ *   parseDuration("30s")     // → 30000
+ *   parseDuration("5m")      // → 300000
+ *   parseDuration("2h")      // → 7200000
+ *   parseDuration("1d")      // → 86400000
+ *
+ * @throws Error with a helpful message identifying the offending input.
+ */
+export declare function parseDuration(input: number | string): number;
+/**
+ * Same as {@link parseDuration} but returns null instead of throwing on
+ * invalid input. Useful when validating user-supplied config defensively.
+ */
+export declare function tryParseDuration(input: unknown): number | null;

package/dist/utils/parseDuration.js

@@ -0,0 +1,78 @@
+/**
+ * Parse a duration value to milliseconds.
+ *
+ * Accepts:
+ *   - A non-negative finite number (interpreted as milliseconds)
+ *   - A single-unit string: `"500ms"`, `"30s"`, `"5m"`, `"2h"`, `"1d"`
+ *
+ * Rejects:
+ *   - Negative numbers, NaN, Infinity
+ *   - Empty strings, whitespace-only strings
+ *   - Multi-unit strings (`"1h30m"`) — split into separate fields if needed
+ *   - Fractional values (`"1.5h"`) — express as a smaller unit (`"90m"`)
+ *   - Unknown units (`"5y"`)
+ *
+ * The narrow grammar is deliberate: it makes parsing predictable and
+ * round-trippable. For arbitrarily complex schedules, use the cron trigger.
+ *
+ * @example
+ *   parseDuration(5000)      // → 5000
+ *   parseDuration("500ms")   // → 500
+ *   parseDuration("30s")     // → 30000
+ *   parseDuration("5m")      // → 300000
+ *   parseDuration("2h")      // → 7200000
+ *   parseDuration("1d")      // → 86400000
+ *
+ * @throws Error with a helpful message identifying the offending input.
+ */
+export function parseDuration(input) {
+    if (typeof input === "number") {
+        if (!Number.isFinite(input)) {
+            throw new Error(`Invalid duration: ${input} (must be a finite number).`);
+        }
+        if (input < 0) {
+            throw new Error(`Invalid duration: ${input} (must be >= 0).`);
+        }
+        // Allow fractional ms for raw numbers (e.g. precise jitter math).
+        // Floor to integer ms — sub-ms scheduling is meaningless for setTimeout.
+        return Math.floor(input);
+    }
+    if (typeof input !== "string") {
+        throw new Error(`Invalid duration: ${typeof input} (must be a number or string).`);
+    }
+    const trimmed = input.trim();
+    if (trimmed.length === 0) {
+        throw new Error("Invalid duration: empty string.");
+    }
+    // Single-unit grammar: <integer><unit>
+    // Units: ms (milliseconds), s (seconds), m (minutes), h (hours), d (days)
+    const match = /^(\d+)(ms|s|m|h|d)$/.exec(trimmed);
+    if (!match) {
+        throw new Error(`Invalid duration: ${JSON.stringify(input)}. Expected a non-negative integer followed by a unit (ms, s, m, h, d), e.g. "500ms", "30s", "5m", "2h", "1d". Multi-unit strings ("1h30m") and fractional values ("1.5h") are not supported.`);
+    }
+    const value = Number.parseInt(match[1], 10);
+    const unit = match[2];
+    const multipliers = {
+        ms: 1,
+        s: 1000,
+        m: 60_000,
+        h: 3_600_000,
+        d: 86_400_000,
+    };
+    return value * multipliers[unit];
+}
+/**
+ * Same as {@link parseDuration} but returns null instead of throwing on
+ * invalid input. Useful when validating user-supplied config defensively.
+ */
+export function tryParseDuration(input) {
+    if (typeof input !== "number" && typeof input !== "string")
+        return null;
+    try {
+        return parseDuration(input);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=parseDuration.js.map

package/dist/utils/parseDuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseDuration.js","sourceRoot":"","sources":["../../src/utils/parseDuration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,aAAa,CAAC,KAAsB;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,6BAA6B,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,kBAAkB,CAAC,CAAC;QAC/D,CAAC;QACD,kEAAkE;QAClE,yEAAyE;QACzE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,KAAK,gCAAgC,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACpD,CAAC;IAED,uCAAuC;IACvC,0EAA0E;IAC1E,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACd,qBAAqB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,8LAA8L,CACxO,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtB,MAAM,WAAW,GAA2B;QAC3C,EAAE,EAAE,CAAC;QACL,CAAC,EAAE,IAAI;QACP,CAAC,EAAE,MAAM;QACT,CAAC,EAAE,SAAS;QACZ,CAAC,EAAE,UAAU;KACb,CAAC;IAEF,OAAO,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACxE,IAAI,CAAC;QACJ,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}