semola 0.6.0 → 0.6.2

package/README.md

@@ -26,11 +26,12 @@ Type-safe APIs, Redis queues, pub/sub, i18n, caching & auth with tree-shakeable
 | **🔐 Policy**        | Policy-based authorization with type-safe guards       | `semola/policy`   |
 | **🌍 i18n**          | Compile-time validated internationalization            | `semola/i18n`     |
 | **💾 Cache**         | Redis cache wrapper with TTL & automatic serialization | `semola/cache`    |
-| **⏰ Cron**          | In-memory cron scheduler for periodic task execution   | `semola/cron`     |
+| **⏰ Cron**          | In-memory and OS cron scheduler for periodic task execution   | `semola/cron`     |
 | **🔁 Workflow**      | Durable resumable workflows with retries and hooks   | `semola/workflow` |
 | **⚠️ Errors**        | Result-based error handling without try/catch          | `semola/errors`   |
 | **📃 Logging**       | A simple logging utility                               | `semola/logging`  |
 | **⌨️ Prompts**       | Interactive zero-dependency CLI prompts                | `semola/prompts`  |
+| **🖥️ CLI**           | Non-interactive CLI builder with schema validation     | `semola/cli`      |
 | **🗄️ ORM**           | Type-safe data layer with query APIs                   | `semola/orm`      |
 
 ---
@@ -153,18 +154,30 @@ console.log(user);
 ### Schedule Recurring Tasks
 
 ```typescript
-import { Cron } from "semola/cron";
+import { Cron, RetryCronJob } from "semola/cron";
 
 const cleanup = new Cron({
   name: "daily-cleanup",
-  schedule: "0 0 * * *", // Daily at midnight
+  schedule: "@daily",
   handler: async () => {
     await deleteOldLogs();
     await archiveInactiveUsers();
   },
+  retry: new RetryCronJob({
+    maxAttempts: 2,
+    onError: (err) => console.log(`An error: ${err.error.message}`),
+    onFailedAttempt: async ({ attemptNumber, delay, error, retriesLeft }) => {
+      console.log(
+        `Attempt ${attemptNumber} failed. Retrying in ${delay}ms. ${retriesLeft} retries left.`,
+      );
+
+      await recover();
+    },
+  }),
 });
 
-cleanup.start();
+cleanup.run();
+
 ```
 
 ### Query a Database
@@ -317,7 +330,7 @@ _Higher is better for req/sec, lower is better for latency._
 - [API Framework](./docs/api.md) - Type-safe REST API framework with OpenAPI
 - [Queue](./docs/queue.md) - Redis-backed job queue with timeouts & concurrency
 - [PubSub](./docs/pubsub.md) - Type-safe Redis pub/sub
-- [Cron](./docs/cron.md) - In-memory cron scheduler for periodic task execution
+- [Cron](./docs/cron.md) - In-memory and OS cron scheduler for periodic task execution
 - [Workflow](./docs/workflow.md) - Durable and resumable workflows with retries and hooks
 - [Policy](./docs/policy.md) - Policy-based authorization
 - [i18n](./docs/i18n.md) - Type-safe internationalization
@@ -325,6 +338,7 @@ _Higher is better for req/sec, lower is better for latency._
 - [Errors](./docs/errors.md) - Result-based error handling
 - [Logging](./docs/logging.md) - Logging utility
 - [Prompts](./docs/prompts.md) - Interactive CLI prompts
+- [CLI](./docs/cli.md) - Non-interactive CLI builder
 - [ORM](./docs/orm.md) - Type-safe data layer with SQLite support
 
 ---

package/dist/index-DISN0WKZ.d.mts

@@ -0,0 +1,78 @@
+//#region node_modules/@standard-schema/spec/dist/index.d.ts
+/** The Standard Typed interface. This is a base type extended by other specs. */
+interface StandardTypedV1<Input = unknown, Output = Input> {
+  /** The Standard properties. */
+  readonly "~standard": StandardTypedV1.Props<Input, Output>;
+}
+declare namespace StandardTypedV1 {
+  /** The Standard Typed properties interface. */
+  interface Props<Input = unknown, Output = Input> {
+    /** The version number of the standard. */
+    readonly version: 1;
+    /** The vendor name of the schema library. */
+    readonly vendor: string;
+    /** Inferred types associated with the schema. */
+    readonly types?: Types<Input, Output> | undefined;
+  }
+  /** The Standard Typed types interface. */
+  interface Types<Input = unknown, Output = Input> {
+    /** The input type of the schema. */
+    readonly input: Input;
+    /** The output type of the schema. */
+    readonly output: Output;
+  }
+  /** Infers the input type of a Standard Typed. */
+  type InferInput<Schema extends StandardTypedV1> = NonNullable<Schema["~standard"]["types"]>["input"];
+  /** Infers the output type of a Standard Typed. */
+  type InferOutput<Schema extends StandardTypedV1> = NonNullable<Schema["~standard"]["types"]>["output"];
+}
+/** The Standard Schema interface. */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+  /** The Standard Schema properties. */
+  readonly "~standard": StandardSchemaV1.Props<Input, Output>;
+}
+declare namespace StandardSchemaV1 {
+  /** The Standard Schema properties interface. */
+  interface Props<Input = unknown, Output = Input> extends StandardTypedV1.Props<Input, Output> {
+    /** Validates unknown input values. */
+    readonly validate: (value: unknown, options?: StandardSchemaV1.Options | undefined) => Result<Output> | Promise<Result<Output>>;
+  }
+  /** The result interface of the validate function. */
+  type Result<Output> = SuccessResult<Output> | FailureResult;
+  /** The result interface if validation succeeds. */
+  interface SuccessResult<Output> {
+    /** The typed output value. */
+    readonly value: Output;
+    /** A falsy value for `issues` indicates success. */
+    readonly issues?: undefined;
+  }
+  interface Options {
+    /** Explicit support for additional vendor-specific parameters, if needed. */
+    readonly libraryOptions?: Record<string, unknown> | undefined;
+  }
+  /** The result interface if validation fails. */
+  interface FailureResult {
+    /** The issues of failed validation. */
+    readonly issues: ReadonlyArray<Issue>;
+  }
+  /** The issue interface of the failure output. */
+  interface Issue {
+    /** The error message of the issue. */
+    readonly message: string;
+    /** The path of the issue, if any. */
+    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+  }
+  /** The path segment interface of the issue. */
+  interface PathSegment {
+    /** The key representing a path segment. */
+    readonly key: PropertyKey;
+  }
+  /** The Standard types interface. */
+  interface Types<Input = unknown, Output = Input> extends StandardTypedV1.Types<Input, Output> {}
+  /** Infers the input type of a Standard. */
+  type InferInput<Schema extends StandardTypedV1> = StandardTypedV1.InferInput<Schema>;
+  /** Infers the output type of a Standard. */
+  type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;
+}
+//#endregion
+export { StandardSchemaV1 as t };