@kellanjs/actioncraft 0.2.0 → 0.3.0

package/dist/api.d.ts

@@ -1,49 +0,0 @@
-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

@@ -1,84 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,66 +0,0 @@
-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

@@ -1,129 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"craft-builder.js","sourceRoot":"","sources":["../../src/classes/craft-builder.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAyB,MAAM,eAAe,CAAC;AAEhE,+EAA+E;AAC/E,yDAAyD;AACzD,+EAA+E;AAE/E,MAAM,OAAO,YAAY;IAON,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,qBAAqB;IACrB,6EAA6E;IAE7E;;;OAGG;IACH,MAAM,CACJ,MAAkB;QAQlB,OAAO,IAAI,YAAY,CACrB,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,YAAY,CACrB,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,YAAY,CACrB,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,YAAY,CACrB,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,YAAY,CACrB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,OAAO,EACZ,SAAS,EACT,IAAI,CAAC,QAAQ,CACd,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,CAAC,QAAQ,CAAC;QAOR,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,OAAO,EAAE,IAAI,CAAC,QAAQ;SACvB,CAAC;IACJ,CAAC;CACF;AA2BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,KAAK,CAOnB,OAA+D;IAE/D,MAAM,OAAO,GAAG,OAAO,CACrB,IAAI,YAAY,CACd,EAAY,EACZ,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"}

package/dist/classes/crafter.d.ts

@@ -1,66 +0,0 @@
-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 {};

package/dist/classes/crafter.js

@@ -1,129 +0,0 @@
-import { Executor } from "./executor/executor.js";
-import { INTERNAL } from "./internal.js";
-// ============================================================================
-// CRAFTER CLASS - Configure and define your action
-// ============================================================================
-export class Crafter {
-    _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 Crafter(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 Crafter(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 Crafter(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 Crafter(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 Crafter(this._config, this._schemas, this._errors, callbacks, this._handler);
-    }
-    /**
-     * @returns Internal properties of the Crafter 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 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;
-}
-//# sourceMappingURL=crafter.js.map

package/dist/classes/crafter.js.map

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

package/dist/classes/executor.d.ts

@@ -1,64 +0,0 @@
-import type { CraftedAction } from "../types/actions.js";
-import type { CrafterConfig, CrafterSchemas, CrafterErrors, CrafterCallbacks } from "../types/crafter.js";
-import type { Crafter } from "./crafter.js";
-export declare class Executor<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?;
-    private _actionId?;
-    constructor(crafter: Crafter<TConfig, TSchemas, TErrors, TCallbacks, TData>);
-    /**
-     * Builds and returns the final executable server action.
-     */
-    craft(): CraftedAction<TConfig, TSchemas, TErrors, TData>;
-    /**
-     * Generates a unique identifier for this action instance.
-     */
-    private _generateActionId;
-    /**
-     * Orchestrates action execution (validation, business logic, callbacks, and result formatting.)
-     */
-    private _runAction;
-    /**
-     * Extracts bind arguments, previous state, and input from raw action arguments.
-     */
-    private _extractActionArgs;
-    /**
-     * Transforms internal Result objects to client-facing action result format.
-     */
-    private _toActionResult;
-    /**
-     * Handles uncaught exceptions during action execution.
-     */
-    private _handleThrownError;
-    /**
-     * Validates input using the shared helper.
-     */
-    private _validateInput;
-    /**
-     * Validates bound arguments using the configured bind schemas.
-     */
-    private _validateBindArgs;
-    /**
-     * Validates output data using the configured output schema.
-     */
-    private _validateOutput;
-    /**
-     * Executes the onStart callback if defined.
-     */
-    private _executeOnStartCallback;
-    /**
-     * Executes result-based lifecycle callbacks (onSuccess, onError, onSettled).
-     */
-    private _executeResultCallbacks;
-    /**
-     * Ensures a Result object has the correct action ID.
-     */
-    private _ensureResultActionId;
-    /**
-     * Creates error functions that return a Result object when called by the action handler.
-     */
-    private _buildErrorFunctions;
-}