@kellanjs/actioncraft 0.0.2 → 0.2.0

package/dist/api.d.ts

@@ -0,0 +1,49 @@
+import { ActionBuilder } from "./classes/action-builder.js";
+import { Crafter } from "./classes/crafter.js";
+import type { CraftedAction } from "./types/actions.js";
+import type { CrafterConfig, CrafterSchemas, CrafterErrors, CrafterCallbacks } from "./types/crafter.js";
+/**
+ * Represents the function that the user passes to `craft()` in order to build an action.
+ */
+type CraftFn<TConfig extends CrafterConfig, TSchemas extends CrafterSchemas, TErrors extends CrafterErrors, TCallbacks extends CrafterCallbacks<TConfig, TSchemas, TErrors, TData>, TData> = (crafter: Crafter<CrafterConfig, Record<string, never>, Record<string, never>, Record<string, never>, unknown>) => Crafter<TConfig, TSchemas, TErrors, TCallbacks, TData> | Promise<Crafter<TConfig, TSchemas, TErrors, TCallbacks, TData>>;
+/**
+ * One of two entry points to the Actioncraft system.
+ * It provides you with an empty Crafter instance on which you can call any of the fluent
+ * Crafter methods to configure and define your action.
+ *
+ * Example Usage:
+ * ```ts
+ * const myAction = craft(async (action) => {
+ *   return action
+ *     .config(...)
+ *     .schemas(...)
+ *     .errors(...)
+ *     .handler(...)
+ *     .callbacks(...)
+ * });
+ * ```
+ *
+ * @param craftFn - The function that the user passes to `craft()` in order to build an action.
+ * @returns The fully-typed server action function that can be used in your app.
+ */
+export declare function craft<TConfig extends CrafterConfig, TSchemas extends CrafterSchemas, TErrors extends CrafterErrors, TCallbacks extends CrafterCallbacks<TConfig, TSchemas, TErrors, TData>, TData>(craftFn: CraftFn<TConfig, TSchemas, TErrors, TCallbacks, TData>): CraftedAction<TConfig, TSchemas, TErrors, TData>;
+/**
+ * One of two entry points to the Actioncraft system.
+ * Creates a new ActionBuilder instance for the fluent API that ends with craft().
+ * This provides an alternative syntax for building your server actions.
+ *
+ * Example Usage:
+ * ```ts
+ * const myAction = action()
+ *   .config(...)
+ *   .schemas(...)
+ *   .errors(...)
+ *   .handler(...)
+ *   .callbacks(...)
+ *   .craft();
+ * ```
+ *
+ * @returns A new ActionBuilder instance to start building your action.
+ */
+export declare function action(): ActionBuilder<Record<string, never>, Record<string, never>, Record<string, never>, Record<string, never>, unknown>;
+export {};

package/dist/api.js

@@ -0,0 +1,84 @@
+import { ActionBuilder } from "./classes/action-builder.js";
+import { Crafter } from "./classes/crafter.js";
+import { Executor } from "./classes/executor.js";
+/**
+ * One of two entry points to the Actioncraft system.
+ * It provides you with an empty Crafter instance on which you can call any of the fluent
+ * Crafter methods to configure and define your action.
+ *
+ * Example Usage:
+ * ```ts
+ * const myAction = craft(async (action) => {
+ *   return action
+ *     .config(...)
+ *     .schemas(...)
+ *     .errors(...)
+ *     .handler(...)
+ *     .callbacks(...)
+ * });
+ * ```
+ *
+ * @param craftFn - The function that the user passes to `craft()` in order to build an action.
+ * @returns The fully-typed server action function that can be used in your app.
+ */
+export function craft(craftFn) {
+    const crafter = craftFn(new Crafter({}, {}, {}, {}, undefined));
+    // Handle async crafter functions
+    if (crafter instanceof Promise) {
+        return _craftAsync(crafter);
+    }
+    // Handle sync crafter functions
+    const executor = new Executor(crafter);
+    const craftedAction = executor.craft();
+    return craftedAction;
+}
+/**
+ * Internal helper function to handle async craft functions.
+ * Encapsulates the logic for creating async actions and preserving metadata.
+ */
+function _craftAsync(crafterPromise) {
+    // Resolve the crafter once and cache the resulting action to ensure consistent IDs
+    const actionPromise = crafterPromise.then((resolvedCrafter) => {
+        const executor = new Executor(resolvedCrafter);
+        return executor.craft();
+    });
+    // For async craft functions, we need to return an async action
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const asyncAction = (async (...args) => {
+        // Wait for the cached action to be ready
+        const craftedAction = await actionPromise;
+        // Call the action with the user's arguments
+        return craftedAction(...args);
+    });
+    // We need to preserve the config and ID for the initial() function to work
+    // We'll use the same cached action to ensure consistent metadata
+    actionPromise.then((craftedAction) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        asyncAction.__ac_config = craftedAction.__ac_config;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        asyncAction.__ac_id = craftedAction.__ac_id;
+    });
+    return asyncAction;
+}
+/**
+ * One of two entry points to the Actioncraft system.
+ * Creates a new ActionBuilder instance for the fluent API that ends with craft().
+ * This provides an alternative syntax for building your server actions.
+ *
+ * Example Usage:
+ * ```ts
+ * const myAction = action()
+ *   .config(...)
+ *   .schemas(...)
+ *   .errors(...)
+ *   .handler(...)
+ *   .callbacks(...)
+ *   .craft();
+ * ```
+ *
+ * @returns A new ActionBuilder instance to start building your action.
+ */
+export function action() {
+    return new ActionBuilder({}, {}, {}, {}, undefined);
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAkCjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,KAAK,CAOnB,OAA+D;IAE/D,MAAM,OAAO,GAAG,OAAO,CACrB,IAAI,OAAO,CACT,EAAmB,EACnB,EAA2B,EAC3B,EAA2B,EAC3B,EAA2B,EAC3B,SAAS,CACV,CACF,CAAC;IAEF,iCAAiC;IACjC,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;QAC/B,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,gCAAgC;IAChC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;IAEvC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAOlB,cAEC;IAED,mFAAmF;IACnF,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,EAAE;QAC5D,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,eAAe,CAAC,CAAC;QAC/C,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,+DAA+D;IAC/D,8DAA8D;IAC9D,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;QAC5C,yCAAyC;QACzC,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC;QAE1C,4CAA4C;QAC5C,OAAO,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC;IAChC,CAAC,CAAqD,CAAC;IAEvD,2EAA2E;IAC3E,iEAAiE;IACjE,aAAa,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE;QACnC,8DAA8D;QAC7D,WAAmB,CAAC,WAAW,GAAI,aAAqB,CAAC,WAAW,CAAC;QACtE,8DAA8D;QAC7D,WAAmB,CAAC,OAAO,GAAI,aAAqB,CAAC,OAAO,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,MAAM;IAOpB,OAAO,IAAI,aAAa,CACtB,EAA2B,EAC3B,EAA2B,EAC3B,EAA2B,EAC3B,EAA2B,EAC3B,SAAS,CACV,CAAC;AACJ,CAAC"}

package/dist/classes/action-builder.d.ts

@@ -0,0 +1,59 @@
+import type { Handler, CraftedAction, InferDataFromHandler, HandlerParams } from "../types/actions.js";
+import type { Config, Schemas, Errors, Callbacks } from "../types/builder.js";
+export declare class ActionBuilder<TConfig extends Config, TSchemas extends Schemas, TErrors extends Errors, TCallbacks extends Callbacks<TConfig, TSchemas, TErrors, TData>, TData> {
+    private readonly _config;
+    private readonly _schemas;
+    private readonly _errors;
+    private readonly _callbacks;
+    private readonly _handler?;
+    constructor(config: TConfig, schemas: TSchemas, errors: TErrors, callbacks: TCallbacks, handler?: Handler<TConfig, TSchemas, TErrors, TData>);
+    /**
+     * Defines configuration options for the action.
+     * Resets previously defined handler and callbacks.
+     */
+    config<TNewConfig extends Config>(config: TNewConfig): ActionBuilder<TNewConfig, TSchemas, TErrors, Record<string, never>, unknown>;
+    /**
+     * Defines validation schemas for input, output, and bind arguments.
+     * Resets previously defined handler and callbacks.
+     */
+    schemas<TNewSchemas extends Schemas>(schemas: TNewSchemas): ActionBuilder<TConfig, TNewSchemas, TErrors, Record<string, never>, unknown>;
+    /**
+     * Defines error functions for returning typed errors from the handler.
+     * Resets previously defined handler and callbacks.
+     */
+    errors<const TNewErrors extends Errors>(errors: TNewErrors): ActionBuilder<TConfig, TSchemas, TNewErrors, Record<string, never>, unknown>;
+    /**
+     * Defines the handler function containing the server action's business logic.
+     * Resets previously defined callbacks.
+     */
+    handler<TFn extends (params: HandlerParams<TConfig, TSchemas, TErrors, TData>) => Promise<unknown>>(fn: TFn): ActionBuilder<TConfig, TSchemas, TErrors, Record<string, never>, InferDataFromHandler<TFn>>;
+    /**
+     * Defines lifecycle callbacks to be triggered during the exection of an action.
+     * Must be called after handler() for correct type inference.
+     */
+    callbacks<TNewCallbacks extends Callbacks<TConfig, TSchemas, TErrors, TData>>(callbacks: TNewCallbacks): ActionBuilder<TConfig, TSchemas, TErrors, TNewCallbacks, TData>;
+    /**
+     * Builds and returns the final executable server action.
+     * This is the terminal method for the ActionBuilder fluent API.
+     */
+    craft(): CraftedAction<TConfig, TSchemas, TErrors, TData>;
+}
+/**
+ * One of two entry points to the Actioncraft system.
+ * Creates a new ActionBuilder instance for the fluent API that ends with craft().
+ * This provides an alternative syntax for building your server actions.
+ *
+ * Example Usage:
+ * ```ts
+ * const myAction = action()
+ *   .config(...)
+ *   .schemas(...)
+ *   .errors(...)
+ *   .handler(...)
+ *   .callbacks(...)
+ *   .craft();
+ * ```
+ *
+ * @returns A new ActionBuilder instance to start building your action.
+ */
+export declare function action(): ActionBuilder<Record<string, never>, Record<string, never>, Record<string, never>, Record<string, never>, unknown>;

package/dist/classes/action-builder.js

@@ -0,0 +1,95 @@
+import { CraftBuilder } from "./craft-builder.js";
+import { Executor } from "./executor/executor.js";
+// ============================================================================
+// ACTION BUILDER CLASS - Alternative fluent API syntax ending with craft()
+// ============================================================================
+export class ActionBuilder {
+    _config;
+    _schemas;
+    _errors;
+    _callbacks;
+    _handler;
+    constructor(config, schemas, errors, callbacks, handler) {
+        this._config = config;
+        this._schemas = schemas;
+        this._errors = errors;
+        this._callbacks = callbacks;
+        this._handler = handler;
+    }
+    // --------------------------------------------------------------------------
+    // FLUENT API METHODS (same as CraftBuilder)
+    // --------------------------------------------------------------------------
+    /**
+     * Defines configuration options for the action.
+     * Resets previously defined handler and callbacks.
+     */
+    config(config) {
+        return new ActionBuilder(config, this._schemas, this._errors, {}, undefined);
+    }
+    /**
+     * Defines validation schemas for input, output, and bind arguments.
+     * Resets previously defined handler and callbacks.
+     */
+    schemas(schemas) {
+        return new ActionBuilder(this._config, schemas, this._errors, {}, undefined);
+    }
+    /**
+     * Defines error functions for returning typed errors from the handler.
+     * Resets previously defined handler and callbacks.
+     */
+    errors(errors) {
+        return new ActionBuilder(this._config, this._schemas, errors, {}, undefined);
+    }
+    /**
+     * Defines the handler function containing the server action's business logic.
+     * Resets previously defined callbacks.
+     */
+    handler(fn) {
+        return new ActionBuilder(this._config, this._schemas, this._errors, {}, fn);
+    }
+    /**
+     * Defines lifecycle callbacks to be triggered during the exection of an action.
+     * Must be called after handler() for correct type inference.
+     */
+    callbacks(callbacks) {
+        return new ActionBuilder(this._config, this._schemas, this._errors, callbacks, this._handler);
+    }
+    // --------------------------------------------------------------------------
+    // CRAFT METHOD - Final step to create the action
+    // --------------------------------------------------------------------------
+    /**
+     * Builds and returns the final executable server action.
+     * This is the terminal method for the ActionBuilder fluent API.
+     */
+    craft() {
+        // Convert ActionBuilder to CraftBuilder and use existing Executor logic
+        const builder = new CraftBuilder(this._config, this._schemas, this._errors, this._callbacks, this._handler);
+        const executor = new Executor(builder);
+        return executor.craft();
+    }
+}
+// ============================================================================
+// PUBLIC API FUNCTION
+// ============================================================================
+/**
+ * One of two entry points to the Actioncraft system.
+ * Creates a new ActionBuilder instance for the fluent API that ends with craft().
+ * This provides an alternative syntax for building your server actions.
+ *
+ * Example Usage:
+ * ```ts
+ * const myAction = action()
+ *   .config(...)
+ *   .schemas(...)
+ *   .errors(...)
+ *   .handler(...)
+ *   .callbacks(...)
+ *   .craft();
+ * ```
+ *
+ * @returns A new ActionBuilder instance to start building your action.
+ */
+export function action() {
+    return new ActionBuilder({}, {}, {}, {}, undefined);
+}
+//# sourceMappingURL=action-builder.js.map

package/dist/classes/action-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-builder.js","sourceRoot":"","sources":["../../src/classes/action-builder.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,+EAA+E;AAC/E,2EAA2E;AAC3E,+EAA+E;AAE/E,MAAM,OAAO,aAAa;IAOP,OAAO,CAAU;IACjB,QAAQ,CAAW;IACnB,OAAO,CAAU;IACjB,UAAU,CAAa;IACvB,QAAQ,CAA8C;IAEvE,YACE,MAAe,EACf,OAAiB,EACjB,MAAe,EACf,SAAqB,EACrB,OAAoD;QAEpD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,6EAA6E;IAC7E,4CAA4C;IAC5C,6EAA6E;IAE7E;;;OAGG;IACH,MAAM,CACJ,MAAkB;QAQlB,OAAO,IAAI,aAAa,CACtB,MAAM,EACN,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,OAAO,EACZ,EAA2B,EAC3B,SAAS,CACV,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,OAAO,CACL,OAAoB;QAQpB,OAAO,IAAI,aAAa,CACtB,IAAI,CAAC,OAAO,EACZ,OAAO,EACP,IAAI,CAAC,OAAO,EACZ,EAA2B,EAC3B,SAAS,CACV,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CACJ,MAAkB;QAQlB,OAAO,IAAI,aAAa,CACtB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,QAAQ,EACb,MAAM,EACN,EAA2B,EAC3B,SAAS,CACV,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,OAAO,CAKL,EAAO;QAQP,OAAO,IAAI,aAAa,CACtB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,OAAO,EACZ,EAA2B,EAC3B,EAAoE,CACrE,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,SAAS,CACP,SAAwB;QAExB,OAAO,IAAI,aAAa,CACtB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,OAAO,EACZ,SAAS,EACT,IAAI,CAAC,QAAQ,CACd,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,iDAAiD;IACjD,6EAA6E;IAE7E;;;OAGG;IACH,KAAK;QACH,wEAAwE;QACxE,MAAM,OAAO,GAAG,IAAI,YAAY,CAC9B,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,QAAQ,CACd,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACF;AAED,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,MAAM;IAOpB,OAAO,IAAI,aAAa,CACtB,EAA2B,EAC3B,EAA2B,EAC3B,EAA2B,EAC3B,EAA2B,EAC3B,SAAS,CACV,CAAC;AACJ,CAAC"}

package/dist/classes/craft-builder.d.ts

@@ -0,0 +1,66 @@
+import type { Handler, InferDataFromHandler, HandlerParams, CraftedAction } from "../types/actions.js";
+import type { Config, Schemas, Errors, Callbacks } from "../types/builder.js";
+import { INTERNAL, type CrafterInternals } from "./internal.js";
+export declare class CraftBuilder<TConfig extends Config, TSchemas extends Schemas, TErrors extends Errors, TCallbacks extends Callbacks<TConfig, TSchemas, TErrors, TData>, TData> {
+    private readonly _config;
+    private readonly _schemas;
+    private readonly _errors;
+    private readonly _callbacks;
+    private readonly _handler?;
+    constructor(config: TConfig, schemas: TSchemas, errors: TErrors, callbacks: TCallbacks, handler?: Handler<TConfig, TSchemas, TErrors, TData>);
+    /**
+     * Defines configuration options for the action.
+     * Resets previously defined handler and callbacks.
+     */
+    config<TNewConfig extends Config>(config: TNewConfig): CraftBuilder<TNewConfig, TSchemas, TErrors, Record<string, never>, unknown>;
+    /**
+     * Defines validation schemas for input, output, and bind arguments.
+     * Resets previously defined handler and callbacks.
+     */
+    schemas<TNewSchemas extends Schemas>(schemas: TNewSchemas): CraftBuilder<TConfig, TNewSchemas, TErrors, Record<string, never>, unknown>;
+    /**
+     * Defines error functions for returning typed errors from the handler.
+     * Resets previously defined handler and callbacks.
+     */
+    errors<const TNewErrors extends Errors>(errors: TNewErrors): CraftBuilder<TConfig, TSchemas, TNewErrors, Record<string, never>, unknown>;
+    /**
+     * Defines the handler function containing the server action's business logic.
+     * Resets previously defined callbacks.
+     */
+    handler<TFn extends (params: HandlerParams<TConfig, TSchemas, TErrors, TData>) => Promise<unknown>>(fn: TFn): CraftBuilder<TConfig, TSchemas, TErrors, Record<string, never>, InferDataFromHandler<TFn>>;
+    /**
+     * Defines lifecycle callbacks to be triggered during the exection of an action.
+     * Must be called after handler() for correct type inference.
+     */
+    callbacks<TNewCallbacks extends Callbacks<TConfig, TSchemas, TErrors, TData>>(callbacks: TNewCallbacks): CraftBuilder<TConfig, TSchemas, TErrors, TNewCallbacks, TData>;
+    /**
+     * @returns Internal properties of the CraftBuilder instance
+     */
+    [INTERNAL](): CrafterInternals<TConfig, TSchemas, TErrors, TCallbacks, TData>;
+}
+/**
+ * Represents the function that the user passes to `craft()` in order to build an action.
+ */
+type CraftFn<TConfig extends Config, TSchemas extends Schemas, TErrors extends Errors, TCallbacks extends Callbacks<TConfig, TSchemas, TErrors, TData>, TData> = (builder: CraftBuilder<Config, Record<string, never>, Record<string, never>, Record<string, never>, unknown>) => CraftBuilder<TConfig, TSchemas, TErrors, TCallbacks, TData> | Promise<CraftBuilder<TConfig, TSchemas, TErrors, TCallbacks, TData>>;
+/**
+ * One of two entry points to the Actioncraft system.
+ * It provides you with an empty CraftBuilder instance on which you can call any of the fluent
+ * CraftBuilder methods to configure and define your action.
+ *
+ * Example Usage:
+ * ```ts
+ * const myAction = craft(async (action) => {
+ *   return action
+ *     .config(...)
+ *     .schemas(...)
+ *     .errors(...)
+ *     .handler(...)
+ *     .callbacks(...)
+ * });
+ * ```
+ *
+ * @param craftFn - The function that the user passes to `craft()` in order to build an action.
+ * @returns The fully-typed server action function that can be used in your app.
+ */
+export declare function craft<TConfig extends Config, TSchemas extends Schemas, TErrors extends Errors, TCallbacks extends Callbacks<TConfig, TSchemas, TErrors, TData>, TData>(craftFn: CraftFn<TConfig, TSchemas, TErrors, TCallbacks, TData>): CraftedAction<TConfig, TSchemas, TErrors, TData>;
+export {};

package/dist/classes/craft-builder.js

@@ -0,0 +1,129 @@
+import { Executor } from "./executor/executor.js";
+import { INTERNAL } from "./internal.js";
+// ============================================================================
+// CRAFT BUILDER CLASS - Configure and define your action
+// ============================================================================
+export class CraftBuilder {
+    _config;
+    _schemas;
+    _errors;
+    _callbacks;
+    _handler;
+    constructor(config, schemas, errors, callbacks, handler) {
+        this._config = config;
+        this._schemas = schemas;
+        this._errors = errors;
+        this._callbacks = callbacks;
+        this._handler = handler;
+    }
+    // --------------------------------------------------------------------------
+    // FLUENT API METHODS
+    // --------------------------------------------------------------------------
+    /**
+     * Defines configuration options for the action.
+     * Resets previously defined handler and callbacks.
+     */
+    config(config) {
+        return new CraftBuilder(config, this._schemas, this._errors, {}, undefined);
+    }
+    /**
+     * Defines validation schemas for input, output, and bind arguments.
+     * Resets previously defined handler and callbacks.
+     */
+    schemas(schemas) {
+        return new CraftBuilder(this._config, schemas, this._errors, {}, undefined);
+    }
+    /**
+     * Defines error functions for returning typed errors from the handler.
+     * Resets previously defined handler and callbacks.
+     */
+    errors(errors) {
+        return new CraftBuilder(this._config, this._schemas, errors, {}, undefined);
+    }
+    /**
+     * Defines the handler function containing the server action's business logic.
+     * Resets previously defined callbacks.
+     */
+    handler(fn) {
+        return new CraftBuilder(this._config, this._schemas, this._errors, {}, fn);
+    }
+    /**
+     * Defines lifecycle callbacks to be triggered during the exection of an action.
+     * Must be called after handler() for correct type inference.
+     */
+    callbacks(callbacks) {
+        return new CraftBuilder(this._config, this._schemas, this._errors, callbacks, this._handler);
+    }
+    /**
+     * @returns Internal properties of the CraftBuilder instance
+     */
+    [INTERNAL]() {
+        return {
+            config: this._config,
+            schemas: this._schemas,
+            errors: this._errors,
+            callbacks: this._callbacks,
+            handler: this._handler,
+        };
+    }
+}
+/**
+ * One of two entry points to the Actioncraft system.
+ * It provides you with an empty CraftBuilder instance on which you can call any of the fluent
+ * CraftBuilder methods to configure and define your action.
+ *
+ * Example Usage:
+ * ```ts
+ * const myAction = craft(async (action) => {
+ *   return action
+ *     .config(...)
+ *     .schemas(...)
+ *     .errors(...)
+ *     .handler(...)
+ *     .callbacks(...)
+ * });
+ * ```
+ *
+ * @param craftFn - The function that the user passes to `craft()` in order to build an action.
+ * @returns The fully-typed server action function that can be used in your app.
+ */
+export function craft(craftFn) {
+    const builder = craftFn(new CraftBuilder({}, {}, {}, {}, undefined));
+    // Handle async builder functions
+    if (builder instanceof Promise) {
+        return _craftAsync(builder);
+    }
+    // Handle sync builder functions
+    const executor = new Executor(builder);
+    const craftedAction = executor.craft();
+    return craftedAction;
+}
+/**
+ * Internal helper function to handle async craft functions.
+ * Encapsulates the logic for creating async actions and preserving metadata.
+ */
+function _craftAsync(builderPromise) {
+    // Resolve the builder once and cache the resulting action to ensure consistent IDs
+    const actionPromise = builderPromise.then((resolvedBuilder) => {
+        const executor = new Executor(resolvedBuilder);
+        return executor.craft();
+    });
+    // For async craft functions, we need to return an async action
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const asyncAction = (async (...args) => {
+        // Wait for the cached action to be ready
+        const craftedAction = await actionPromise;
+        // Call the action with the user's arguments
+        return craftedAction(...args);
+    });
+    // We need to preserve the config and ID for the initial() function to work
+    // We'll use the same cached action to ensure consistent metadata
+    actionPromise.then((craftedAction) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        asyncAction.__ac_config = craftedAction.__ac_config;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        asyncAction.__ac_id = craftedAction.__ac_id;
+    });
+    return asyncAction;
+}
+//# sourceMappingURL=craft-builder.js.map

package/dist/classes/craft-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-builder.js","sourceRoot":"","sources":["../../src/classes/craft-builder.ts"],"names":[],"mappings":"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"}

package/dist/classes/crafter.d.ts

@@ -0,0 +1,66 @@
+import type { Handler, InferDataFromHandler, HandlerParams, CraftedAction } from "../types/actions.js";
+import type { CrafterConfig, CrafterSchemas, CrafterErrors, CrafterCallbacks } from "../types/crafter.js";
+import { INTERNAL, type CrafterInternals } from "./internal.js";
+export declare class Crafter<TConfig extends CrafterConfig, TSchemas extends CrafterSchemas, TErrors extends CrafterErrors, TCallbacks extends CrafterCallbacks<TConfig, TSchemas, TErrors, TData>, TData> {
+    private readonly _config;
+    private readonly _schemas;
+    private readonly _errors;
+    private readonly _callbacks;
+    private readonly _handler?;
+    constructor(config: TConfig, schemas: TSchemas, errors: TErrors, callbacks: TCallbacks, handler?: Handler<TConfig, TSchemas, TErrors, TData>);
+    /**
+     * Defines configuration options for the action.
+     * Resets previously defined handler and callbacks.
+     */
+    config<TNewConfig extends CrafterConfig>(config: TNewConfig): Crafter<TNewConfig, TSchemas, TErrors, Record<string, never>, unknown>;
+    /**
+     * Defines validation schemas for input, output, and bind arguments.
+     * Resets previously defined handler and callbacks.
+     */
+    schemas<TNewSchemas extends CrafterSchemas>(schemas: TNewSchemas): Crafter<TConfig, TNewSchemas, TErrors, Record<string, never>, unknown>;
+    /**
+     * Defines error functions for returning typed errors from the handler.
+     * Resets previously defined handler and callbacks.
+     */
+    errors<const TNewErrors extends CrafterErrors>(errors: TNewErrors): Crafter<TConfig, TSchemas, TNewErrors, Record<string, never>, unknown>;
+    /**
+     * Defines the handler function containing the server action's business logic.
+     * Resets previously defined callbacks.
+     */
+    handler<TFn extends (params: HandlerParams<TConfig, TSchemas, TErrors, TData>) => Promise<unknown>>(fn: TFn): Crafter<TConfig, TSchemas, TErrors, Record<string, never>, InferDataFromHandler<TFn>>;
+    /**
+     * Defines lifecycle callbacks to be triggered during the exection of an action.
+     * Must be called after handler() for correct type inference.
+     */
+    callbacks<TNewCallbacks extends CrafterCallbacks<TConfig, TSchemas, TErrors, TData>>(callbacks: TNewCallbacks): Crafter<TConfig, TSchemas, TErrors, TNewCallbacks, TData>;
+    /**
+     * @returns Internal properties of the Crafter instance
+     */
+    [INTERNAL](): CrafterInternals<TConfig, TSchemas, TErrors, TCallbacks, TData>;
+}
+/**
+ * Represents the function that the user passes to `craft()` in order to build an action.
+ */
+type CraftFn<TConfig extends CrafterConfig, TSchemas extends CrafterSchemas, TErrors extends CrafterErrors, TCallbacks extends CrafterCallbacks<TConfig, TSchemas, TErrors, TData>, TData> = (crafter: Crafter<CrafterConfig, Record<string, never>, Record<string, never>, Record<string, never>, unknown>) => Crafter<TConfig, TSchemas, TErrors, TCallbacks, TData> | Promise<Crafter<TConfig, TSchemas, TErrors, TCallbacks, TData>>;
+/**
+ * One of two entry points to the Actioncraft system.
+ * It provides you with an empty Crafter instance on which you can call any of the fluent
+ * Crafter methods to configure and define your action.
+ *
+ * Example Usage:
+ * ```ts
+ * const myAction = craft(async (action) => {
+ *   return action
+ *     .config(...)
+ *     .schemas(...)
+ *     .errors(...)
+ *     .handler(...)
+ *     .callbacks(...)
+ * });
+ * ```
+ *
+ * @param craftFn - The function that the user passes to `craft()` in order to build an action.
+ * @returns The fully-typed server action function that can be used in your app.
+ */
+export declare function craft<TConfig extends CrafterConfig, TSchemas extends CrafterSchemas, TErrors extends CrafterErrors, TCallbacks extends CrafterCallbacks<TConfig, TSchemas, TErrors, TData>, TData>(craftFn: CraftFn<TConfig, TSchemas, TErrors, TCallbacks, TData>): CraftedAction<TConfig, TSchemas, TErrors, TData>;
+export {};