@decaf-ts/integrations 0.8.0 → 0.10.0

package/lib/types/blob/s3/S3BlobEnvironment.d.cts

@@ -0,0 +1,26 @@
+export interface S3BlobEnvironmentCredentials {
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    sessionToken?: string;
+}
+export interface S3BlobEnvironmentConfig {
+    sourceId: string;
+    bucket: string;
+    region?: string;
+    endpoint?: string;
+    prefix?: string;
+    forcePathStyle?: boolean;
+    autoCreateBucket?: boolean;
+    maxRetries?: number;
+    credentials?: S3BlobEnvironmentCredentials;
+}
+export interface S3BlobEnvironmentShape {
+    blobs: {
+        s3: S3BlobEnvironmentConfig;
+    };
+}
+export declare const S3BlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & S3BlobEnvironmentShape>;

package/lib/types/blob/s3/S3BlobEnvironment.d.mts

@@ -0,0 +1,26 @@
+export interface S3BlobEnvironmentCredentials {
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    sessionToken?: string;
+}
+export interface S3BlobEnvironmentConfig {
+    sourceId: string;
+    bucket: string;
+    region?: string;
+    endpoint?: string;
+    prefix?: string;
+    forcePathStyle?: boolean;
+    autoCreateBucket?: boolean;
+    maxRetries?: number;
+    credentials?: S3BlobEnvironmentCredentials;
+}
+export interface S3BlobEnvironmentShape {
+    blobs: {
+        s3: S3BlobEnvironmentConfig;
+    };
+}
+export declare const S3BlobEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & import("..").BlobCommonEnvironmentShape & S3BlobEnvironmentShape>;

package/lib/types/blob/s3/S3BlobStoreService.d.cts

@@ -1,25 +1,5 @@
-/**
- * @module integrations/blob/s3/service
- * @summary S3-compatible blob store service.
- * @description Blob store backed by AWS S3, MinIO, and Cloudflare R2 via the AWS SDK v3 S3Client.
- */
-import { S3Client } from "@aws-sdk/client-s3";
-import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
-import { BlobStoreService } from "../core/BlobStoreService.d.cts";
-import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobPutOptions, BlobPutResult, BlobUrlOptions, BlobUrlResult, BlobValue, S3BlobStoreServiceConfig } from "../core/BlobTypes.d.cts";
-export declare class S3BlobStoreService extends BlobStoreService<S3Client, S3BlobStoreServiceConfig> {
-    initialize(...args: ContextualArgs<any>): Promise<{
-        config: S3BlobStoreServiceConfig;
-        client: S3Client;
-    }>;
-    put(key: BlobKey, value: BlobValue, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
-    get(key: BlobKey, options?: BlobGetOptions, ...args: MaybeContextualArg<any>): Promise<BlobGetResult>;
-    has(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<boolean>;
-    stat(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<BlobMetadata>;
-    delete(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<void>;
-    copy(fromKey: BlobKey, toKey: BlobKey, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
-    list(options?: BlobListOptions, ...args: MaybeContextualArg<any>): Promise<BlobListResult>;
-    url(key: BlobKey, options?: BlobUrlOptions, ...args: MaybeContextualArg<any>): Promise<BlobUrlResult>;
-    protected parseError(error: unknown): Error;
-    private ensureBucket;
+import { S3CompatibleBlobStoreService } from "./S3CompatibleBlobStoreService.d.cts";
+import type { S3BlobStoreServiceConfig } from "../core/BlobTypes.d.cts";
+export declare class S3BlobStoreService extends S3CompatibleBlobStoreService {
+    protected configFromEnvironment(): S3BlobStoreServiceConfig | undefined;
 }

package/lib/types/blob/s3/S3BlobStoreService.d.mts

@@ -1,25 +1,5 @@
-/**
- * @module integrations/blob/s3/service
- * @summary S3-compatible blob store service.
- * @description Blob store backed by AWS S3, MinIO, and Cloudflare R2 via the AWS SDK v3 S3Client.
- */
-import { S3Client } from "@aws-sdk/client-s3";
-import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
-import { BlobStoreService } from "../core/BlobStoreService.d.mts";
-import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobPutOptions, BlobPutResult, BlobUrlOptions, BlobUrlResult, BlobValue, S3BlobStoreServiceConfig } from "../core/BlobTypes.d.mts";
-export declare class S3BlobStoreService extends BlobStoreService<S3Client, S3BlobStoreServiceConfig> {
-    initialize(...args: ContextualArgs<any>): Promise<{
-        config: S3BlobStoreServiceConfig;
-        client: S3Client;
-    }>;
-    put(key: BlobKey, value: BlobValue, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
-    get(key: BlobKey, options?: BlobGetOptions, ...args: MaybeContextualArg<any>): Promise<BlobGetResult>;
-    has(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<boolean>;
-    stat(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<BlobMetadata>;
-    delete(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<void>;
-    copy(fromKey: BlobKey, toKey: BlobKey, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
-    list(options?: BlobListOptions, ...args: MaybeContextualArg<any>): Promise<BlobListResult>;
-    url(key: BlobKey, options?: BlobUrlOptions, ...args: MaybeContextualArg<any>): Promise<BlobUrlResult>;
-    protected parseError(error: unknown): Error;
-    private ensureBucket;
+import { S3CompatibleBlobStoreService } from "./S3CompatibleBlobStoreService.d.mts";
+import type { S3BlobStoreServiceConfig } from "../core/BlobTypes.d.mts";
+export declare class S3BlobStoreService extends S3CompatibleBlobStoreService {
+    protected configFromEnvironment(): S3BlobStoreServiceConfig | undefined;
 }

package/lib/types/blob/s3/S3CompatibleBlobStoreService.d.cts

@@ -0,0 +1,58 @@
+/**
+ * @module integrations/blob/s3/base-service
+ * @summary S3-compatible blob store base implementation.
+ * @description Shared CRUD implementation backed by the AWS SDK v3 S3Client, used by
+ * the S3, MinIO, and Cloudflare R2 provider services. Deliberately left undecorated:
+ * `@service(...)` on a class whose parent is itself `@service(...)`-decorated breaks
+ * that subclass's inherited field initializers (e.g. `Context` ends up `undefined`).
+ * Each concrete provider below extends this class directly and carries its own
+ * `@service("blob-<provider>")` decorator instead of stacking on top of one another.
+ */
+import { S3Client } from "@aws-sdk/client-s3";
+import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import { BlobStoreService } from "../core/BlobStoreService.d.cts";
+import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobPutOptions, BlobPutResult, BlobUrlOptions, BlobUrlResult, BlobValue, S3BlobStoreServiceConfig } from "../core/BlobTypes.d.cts";
+/**
+ * @description Base implementation for S3-compatible blob stores
+ * @summary Implements the full blob CRUD API on top of the AWS SDK v3
+ * `S3Client` and is shared by the S3, MinIO, and Cloudflare R2 provider
+ * services. Deliberately left undecorated: `@service(...)` on a class whose
+ * parent is itself `@service(...)`-decorated breaks that subclass's inherited
+ * field initializers (e.g. `Context` ends up `undefined`). Each concrete
+ * provider extends this class directly and carries its own
+ * `@service("blob-<provider>")` decorator instead of stacking on top of one
+ * another.
+ * @class S3CompatibleBlobStoreService
+ * @memberOf module:integrations/blob/s3/base-service
+ */
+export declare abstract class S3CompatibleBlobStoreService extends BlobStoreService<S3Client, S3BlobStoreServiceConfig> {
+    /**
+     * @description Initializes the S3 client from config or environment
+     * @summary Resolves the config via `getConfigFromArgs` (explicit config,
+     * then the provider's environment slice). When no config resolves during a
+     * context-bearing auto-boot of an unconfigured provider (e.g. an optional
+     * `blob-minio`/`blob-r2` registered alongside `blob-s3`), returns
+     * `skipInitialization()` so `Service.boot` does not throw; an explicit
+     * `initialize()` with no resolvable config still throws a
+     * `ValidationError`. Requires a `bucket`, builds the `S3Client` (with
+     * optional static credentials), stores config and client, and optionally
+     * creates the bucket when `autoCreateBucket` is set.
+     * @param {...ContextualArgs<any>} args - An optional `S3BlobStoreServiceConfig`, optionally followed by a decaf `Context`
+     * @return {Promise<{config: S3BlobStoreServiceConfig, client: S3Client}>} The resolved config and the constructed `S3Client`
+     * @throws {InternalError} When a resolved config has no `bucket`
+     */
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: S3BlobStoreServiceConfig;
+        client: S3Client;
+    }>;
+    put(key: BlobKey, value: BlobValue, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
+    get(key: BlobKey, options?: BlobGetOptions, ...args: MaybeContextualArg<any>): Promise<BlobGetResult>;
+    has(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<boolean>;
+    stat(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<BlobMetadata>;
+    delete(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<void>;
+    copy(fromKey: BlobKey, toKey: BlobKey, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
+    list(options?: BlobListOptions, ...args: MaybeContextualArg<any>): Promise<BlobListResult>;
+    url(key: BlobKey, options?: BlobUrlOptions, ...args: MaybeContextualArg<any>): Promise<BlobUrlResult>;
+    protected parseError(error: unknown): Error;
+    private ensureBucket;
+}

package/lib/types/blob/s3/S3CompatibleBlobStoreService.d.mts

@@ -0,0 +1,58 @@
+/**
+ * @module integrations/blob/s3/base-service
+ * @summary S3-compatible blob store base implementation.
+ * @description Shared CRUD implementation backed by the AWS SDK v3 S3Client, used by
+ * the S3, MinIO, and Cloudflare R2 provider services. Deliberately left undecorated:
+ * `@service(...)` on a class whose parent is itself `@service(...)`-decorated breaks
+ * that subclass's inherited field initializers (e.g. `Context` ends up `undefined`).
+ * Each concrete provider below extends this class directly and carries its own
+ * `@service("blob-<provider>")` decorator instead of stacking on top of one another.
+ */
+import { S3Client } from "@aws-sdk/client-s3";
+import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
+import { BlobStoreService } from "../core/BlobStoreService.d.mts";
+import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobPutOptions, BlobPutResult, BlobUrlOptions, BlobUrlResult, BlobValue, S3BlobStoreServiceConfig } from "../core/BlobTypes.d.mts";
+/**
+ * @description Base implementation for S3-compatible blob stores
+ * @summary Implements the full blob CRUD API on top of the AWS SDK v3
+ * `S3Client` and is shared by the S3, MinIO, and Cloudflare R2 provider
+ * services. Deliberately left undecorated: `@service(...)` on a class whose
+ * parent is itself `@service(...)`-decorated breaks that subclass's inherited
+ * field initializers (e.g. `Context` ends up `undefined`). Each concrete
+ * provider extends this class directly and carries its own
+ * `@service("blob-<provider>")` decorator instead of stacking on top of one
+ * another.
+ * @class S3CompatibleBlobStoreService
+ * @memberOf module:integrations/blob/s3/base-service
+ */
+export declare abstract class S3CompatibleBlobStoreService extends BlobStoreService<S3Client, S3BlobStoreServiceConfig> {
+    /**
+     * @description Initializes the S3 client from config or environment
+     * @summary Resolves the config via `getConfigFromArgs` (explicit config,
+     * then the provider's environment slice). When no config resolves during a
+     * context-bearing auto-boot of an unconfigured provider (e.g. an optional
+     * `blob-minio`/`blob-r2` registered alongside `blob-s3`), returns
+     * `skipInitialization()` so `Service.boot` does not throw; an explicit
+     * `initialize()` with no resolvable config still throws a
+     * `ValidationError`. Requires a `bucket`, builds the `S3Client` (with
+     * optional static credentials), stores config and client, and optionally
+     * creates the bucket when `autoCreateBucket` is set.
+     * @param {...ContextualArgs<any>} args - An optional `S3BlobStoreServiceConfig`, optionally followed by a decaf `Context`
+     * @return {Promise<{config: S3BlobStoreServiceConfig, client: S3Client}>} The resolved config and the constructed `S3Client`
+     * @throws {InternalError} When a resolved config has no `bucket`
+     */
+    initialize(...args: ContextualArgs<any>): Promise<{
+        config: S3BlobStoreServiceConfig;
+        client: S3Client;
+    }>;
+    put(key: BlobKey, value: BlobValue, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
+    get(key: BlobKey, options?: BlobGetOptions, ...args: MaybeContextualArg<any>): Promise<BlobGetResult>;
+    has(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<boolean>;
+    stat(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<BlobMetadata>;
+    delete(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<void>;
+    copy(fromKey: BlobKey, toKey: BlobKey, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
+    list(options?: BlobListOptions, ...args: MaybeContextualArg<any>): Promise<BlobListResult>;
+    url(key: BlobKey, options?: BlobUrlOptions, ...args: MaybeContextualArg<any>): Promise<BlobUrlResult>;
+    protected parseError(error: unknown): Error;
+    private ensureBucket;
+}

package/lib/types/blob/s3/index.d.cts

@@ -3,6 +3,10 @@
  * @summary S3-compatible blob store exports.
  * @description Re-exports the S3, MinIO, and R2 blob store services.
  */
+export * from "./S3CompatibleBlobStoreService.d.cts";
 export * from "./S3BlobStoreService.d.cts";
+export * from "./S3BlobEnvironment.d.cts";
 export * from "./MinioBlobStoreService.d.cts";
+export * from "./MinioBlobEnvironment.d.cts";
 export * from "./R2BlobStoreService.d.cts";
+export * from "./R2BlobEnvironment.d.cts";

package/lib/types/blob/s3/index.d.mts

@@ -3,6 +3,10 @@
  * @summary S3-compatible blob store exports.
  * @description Re-exports the S3, MinIO, and R2 blob store services.
  */
+export * from "./S3CompatibleBlobStoreService.d.mts";
 export * from "./S3BlobStoreService.d.mts";
+export * from "./S3BlobEnvironment.d.mts";
 export * from "./MinioBlobStoreService.d.mts";
+export * from "./MinioBlobEnvironment.d.mts";
 export * from "./R2BlobStoreService.d.mts";
+export * from "./R2BlobEnvironment.d.mts";

package/lib/types/calendar/CalendarService.d.cts

@@ -0,0 +1,40 @@
+import { MaybeContextualArg, Service } from "@decaf-ts/core";
+import { CalendarFile, CalendarReminderOptions } from "./types.d.cts";
+import { type ICalendarWriter } from "./writers/ICalendarWriter.d.cts";
+/**
+ * Creates interoperable iCalendar medication reminders.
+ *
+ * The service has no static Node imports, so the same module can be bundled
+ * for browsers. Node-only filesystem behavior is loaded dynamically.
+ */
+export declare class CalendarService extends Service {
+    protected writer: ICalendarWriter;
+    createMedicationReminder(options: CalendarReminderOptions, ...args: MaybeContextualArg<any>): Promise<CalendarFile>;
+    createAndStoreReminder(options: CalendarReminderOptions, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createRecurrence;
+    /**
+     * Converts the commonly needed medication schedules.
+     *
+     * Unsupported cron shapes fall back to explicit RDATE occurrences.
+     */
+    private convertSimpleCronToRRule;
+    private parseSimpleCron;
+    private parseCronField;
+    private expandCronDates;
+    private getFirstOccurrence;
+    private createFoldedRDateLines;
+    private formatUtcDate;
+    private formatLocalDate;
+    private foldLines;
+    /**
+     * RFC 5545 content lines should be folded at 75 octets.
+     */
+    private foldLine;
+    private escapeText;
+    private escapeProperty;
+    private escapeParameter;
+    private weekdayToIcs;
+    private createUid;
+    private createFilename;
+    private validateOptions;
+}

package/lib/types/calendar/CalendarService.d.mts

@@ -0,0 +1,40 @@
+import { MaybeContextualArg, Service } from "@decaf-ts/core";
+import { CalendarFile, CalendarReminderOptions } from "./types.d.mts";
+import { type ICalendarWriter } from "./writers/ICalendarWriter.d.mts";
+/**
+ * Creates interoperable iCalendar medication reminders.
+ *
+ * The service has no static Node imports, so the same module can be bundled
+ * for browsers. Node-only filesystem behavior is loaded dynamically.
+ */
+export declare class CalendarService extends Service {
+    protected writer: ICalendarWriter;
+    createMedicationReminder(options: CalendarReminderOptions, ...args: MaybeContextualArg<any>): Promise<CalendarFile>;
+    createAndStoreReminder(options: CalendarReminderOptions, ...args: MaybeContextualArg<any>): Promise<void>;
+    private createRecurrence;
+    /**
+     * Converts the commonly needed medication schedules.
+     *
+     * Unsupported cron shapes fall back to explicit RDATE occurrences.
+     */
+    private convertSimpleCronToRRule;
+    private parseSimpleCron;
+    private parseCronField;
+    private expandCronDates;
+    private getFirstOccurrence;
+    private createFoldedRDateLines;
+    private formatUtcDate;
+    private formatLocalDate;
+    private foldLines;
+    /**
+     * RFC 5545 content lines should be folded at 75 octets.
+     */
+    private foldLine;
+    private escapeText;
+    private escapeProperty;
+    private escapeParameter;
+    private weekdayToIcs;
+    private createUid;
+    private createFilename;
+    private validateOptions;
+}

package/lib/types/calendar/index.d.cts

@@ -0,0 +1,3 @@
+export * from "./validators/cron.d.cts";
+export * from "./types.d.cts";
+export * from "./CalendarService.d.cts";

package/lib/types/calendar/index.d.mts

@@ -0,0 +1,3 @@
+export * from "./validators/cron.d.mts";
+export * from "./types.d.mts";
+export * from "./CalendarService.d.mts";

package/lib/types/calendar/types.d.cts

@@ -0,0 +1,64 @@
+export interface CalendarReminderOptions {
+    /**
+     * Standard 5-field cron:
+     * minute hour day-of-month month day-of-week
+     *
+     * Examples:
+     * "0 9 * * *"       Every day at 09:00
+     * "0 9,21 * * *"    Every day at 09:00 and 21:00
+     * "0 9 * * 1-5"     Weekdays at 09:00
+     */
+    cron: string;
+    title: string;
+    description?: string;
+    location?: string;
+    /**
+     * First date from which occurrences should be calculated.
+     * Defaults to now.
+     */
+    start?: Date;
+    /**
+     * IANA timezone, for example:
+     * "Europe/Lisbon"
+     */
+    timezone?: string;
+    /**
+     * Length of each calendar event.
+     * Defaults to 15 minutes.
+     */
+    durationMinutes?: number;
+    /**
+     * Calendar notification before every occurrence.
+     * Defaults to 10 minutes.
+     */
+    alarmMinutesBefore?: number;
+    /**
+     * Maximum number of generated RDATE occurrences when the cron
+     * expression cannot be converted into a single RRULE.
+     */
+    maxOccurrences?: number;
+    /**
+     * Do not generate occurrences after this date.
+     */
+    until?: Date;
+    uid?: string;
+    organizerEmail?: string;
+    attendeeEmail?: string;
+}
+export interface CalendarFile {
+    filename: string;
+    content: string;
+    mimeType: "text/calendar";
+    bytes: Uint8Array;
+}
+export interface ParsedCron {
+    minute: number[];
+    hour: number[];
+    dayOfMonth: number[] | null;
+    month: number[] | null;
+    dayOfWeek: number[] | null;
+}
+export interface RecurrenceResult {
+    rrule?: string;
+    rdates?: Date[];
+}

package/lib/types/calendar/types.d.mts

@@ -0,0 +1,64 @@
+export interface CalendarReminderOptions {
+    /**
+     * Standard 5-field cron:
+     * minute hour day-of-month month day-of-week
+     *
+     * Examples:
+     * "0 9 * * *"       Every day at 09:00
+     * "0 9,21 * * *"    Every day at 09:00 and 21:00
+     * "0 9 * * 1-5"     Weekdays at 09:00
+     */
+    cron: string;
+    title: string;
+    description?: string;
+    location?: string;
+    /**
+     * First date from which occurrences should be calculated.
+     * Defaults to now.
+     */
+    start?: Date;
+    /**
+     * IANA timezone, for example:
+     * "Europe/Lisbon"
+     */
+    timezone?: string;
+    /**
+     * Length of each calendar event.
+     * Defaults to 15 minutes.
+     */
+    durationMinutes?: number;
+    /**
+     * Calendar notification before every occurrence.
+     * Defaults to 10 minutes.
+     */
+    alarmMinutesBefore?: number;
+    /**
+     * Maximum number of generated RDATE occurrences when the cron
+     * expression cannot be converted into a single RRULE.
+     */
+    maxOccurrences?: number;
+    /**
+     * Do not generate occurrences after this date.
+     */
+    until?: Date;
+    uid?: string;
+    organizerEmail?: string;
+    attendeeEmail?: string;
+}
+export interface CalendarFile {
+    filename: string;
+    content: string;
+    mimeType: "text/calendar";
+    bytes: Uint8Array;
+}
+export interface ParsedCron {
+    minute: number[];
+    hour: number[];
+    dayOfMonth: number[] | null;
+    month: number[] | null;
+    dayOfWeek: number[] | null;
+}
+export interface RecurrenceResult {
+    rrule?: string;
+    rdates?: Date[];
+}

package/lib/types/calendar/validators/cron.d.cts

@@ -0,0 +1,7 @@
+import { Validator, ValidatorOptions } from "@decaf-ts/decorator-validation";
+export declare const CRON_VALIDATION_ERROR_MESSAGE = "Not a valid cron expression";
+export declare class CronValidator extends Validator {
+    constructor(message?: string);
+    hasErrors(value: string, options?: ValidatorOptions): string | undefined;
+}
+export declare const cron: (message?: string) => (target: object, propKey?: any) => any;

package/lib/types/calendar/validators/cron.d.mts

@@ -0,0 +1,7 @@
+import { Validator, ValidatorOptions } from "@decaf-ts/decorator-validation";
+export declare const CRON_VALIDATION_ERROR_MESSAGE = "Not a valid cron expression";
+export declare class CronValidator extends Validator {
+    constructor(message?: string);
+    hasErrors(value: string, options?: ValidatorOptions): string | undefined;
+}
+export declare const cron: (message?: string) => (target: object, propKey?: any) => any;

package/lib/types/calendar/writers/CalendarFsWriter.d.cts

@@ -0,0 +1,6 @@
+import { ICalendarWriter } from "./ICalendarWriter.d.cts";
+import { CalendarFile } from "../types.d.cts";
+import { Context } from "@decaf-ts/core";
+export declare class FsCalenderWriter implements ICalendarWriter {
+    write(file: CalendarFile, ctx: Context<any>): Promise<CalendarFile>;
+}

package/lib/types/calendar/writers/CalendarFsWriter.d.mts

@@ -0,0 +1,6 @@
+import { ICalendarWriter } from "./ICalendarWriter.d.mts";
+import { CalendarFile } from "../types.d.mts";
+import { Context } from "@decaf-ts/core";
+export declare class FsCalenderWriter implements ICalendarWriter {
+    write(file: CalendarFile, ctx: Context<any>): Promise<CalendarFile>;
+}

package/lib/types/calendar/writers/CalenderDownloader.d.cts

@@ -0,0 +1,6 @@
+import { ICalendarWriter } from "./ICalendarWriter.d.cts";
+import { CalendarFile } from "../types.d.cts";
+import { Context } from "@decaf-ts/core";
+export declare class DownloadCalenderWriter implements ICalendarWriter {
+    write(file: CalendarFile, ctx: Context): Promise<CalendarFile>;
+}

package/lib/types/calendar/writers/CalenderDownloader.d.mts

@@ -0,0 +1,6 @@
+import { ICalendarWriter } from "./ICalendarWriter.d.mts";
+import { CalendarFile } from "../types.d.mts";
+import { Context } from "@decaf-ts/core";
+export declare class DownloadCalenderWriter implements ICalendarWriter {
+    write(file: CalendarFile, ctx: Context): Promise<CalendarFile>;
+}

package/lib/types/calendar/writers/ICalendarWriter.d.cts

@@ -0,0 +1,5 @@
+import { CalendarFile } from "../types.d.cts";
+import { Context } from "@decaf-ts/core";
+export interface ICalendarWriter {
+    write(file: CalendarFile, ctx: Context<any>): Promise<CalendarFile>;
+}

package/lib/types/calendar/writers/ICalendarWriter.d.mts

@@ -0,0 +1,5 @@
+import { CalendarFile } from "../types.d.mts";
+import { Context } from "@decaf-ts/core";
+export interface ICalendarWriter {
+    write(file: CalendarFile, ctx: Context<any>): Promise<CalendarFile>;
+}

package/lib/types/graph/engine/catalog/GraphBuiltInRegistrations.d.cts

@@ -0,0 +1,17 @@
+import { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.cts";
+import { GraphNodeCatalogue } from "./GraphNodeCatalogue.d.cts";
+import { type GraphNodeRegistration } from "./GraphNodeRegistration.d.cts";
+/**
+ * Builds the built-in node registrations (DECAF-50 §4.12): every built-in
+ * manifest from {@link GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND} that has a
+ * default executor, paired with that executor as a
+ * {@link GraphNodeRegistration}. Engine-bound executors (loops, switch) are
+ * only included when an `engine` is provided.
+ */
+export declare function builtInGraphNodeRegistrations(engine?: GraphExecutionEngine): GraphNodeRegistration[];
+/**
+ * Registers all built-in graph nodes (see
+ * {@link builtInGraphNodeRegistrations}) into the given
+ * {@link GraphNodeCatalogue} and returns it for chaining.
+ */
+export declare function registerBuiltInGraphNodes(catalogue: GraphNodeCatalogue, engine?: GraphExecutionEngine): GraphNodeCatalogue;

package/lib/types/graph/engine/catalog/GraphBuiltInRegistrations.d.mts

@@ -0,0 +1,17 @@
+import { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.mts";
+import { GraphNodeCatalogue } from "./GraphNodeCatalogue.d.mts";
+import { type GraphNodeRegistration } from "./GraphNodeRegistration.d.mts";
+/**
+ * Builds the built-in node registrations (DECAF-50 §4.12): every built-in
+ * manifest from {@link GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND} that has a
+ * default executor, paired with that executor as a
+ * {@link GraphNodeRegistration}. Engine-bound executors (loops, switch) are
+ * only included when an `engine` is provided.
+ */
+export declare function builtInGraphNodeRegistrations(engine?: GraphExecutionEngine): GraphNodeRegistration[];
+/**
+ * Registers all built-in graph nodes (see
+ * {@link builtInGraphNodeRegistrations}) into the given
+ * {@link GraphNodeCatalogue} and returns it for chaining.
+ */
+export declare function registerBuiltInGraphNodes(catalogue: GraphNodeCatalogue, engine?: GraphExecutionEngine): GraphNodeCatalogue;

package/lib/types/graph/engine/catalog/GraphCatalogueErrors.d.cts

@@ -0,0 +1,13 @@
+import { InternalError, NotFoundError } from "@decaf-ts/db-decorators";
+/** Thrown when a node registration or its manifest fails catalogue validation (e.g. invalid ports, unsafe ids, duplicate kinds). */
+export declare class GraphNodeRegistrationError extends InternalError {
+    constructor(msg: string | Error | unknown);
+}
+/** Thrown when a node kind is not registered in the backend catalogue. */
+export declare class GraphNodeNotFoundError extends NotFoundError {
+    constructor(msg: string | Error | unknown);
+}
+/** Thrown when a declared node method is not registered for a node kind. */
+export declare class GraphNodeMethodNotFoundError extends NotFoundError {
+    constructor(msg: string | Error | unknown);
+}

package/lib/types/graph/engine/catalog/GraphCatalogueErrors.d.mts

@@ -0,0 +1,13 @@
+import { InternalError, NotFoundError } from "@decaf-ts/db-decorators";
+/** Thrown when a node registration or its manifest fails catalogue validation (e.g. invalid ports, unsafe ids, duplicate kinds). */
+export declare class GraphNodeRegistrationError extends InternalError {
+    constructor(msg: string | Error | unknown);
+}
+/** Thrown when a node kind is not registered in the backend catalogue. */
+export declare class GraphNodeNotFoundError extends NotFoundError {
+    constructor(msg: string | Error | unknown);
+}
+/** Thrown when a declared node method is not registered for a node kind. */
+export declare class GraphNodeMethodNotFoundError extends NotFoundError {
+    constructor(msg: string | Error | unknown);
+}