@kellanjs/actioncraft 0.2.0 → 0.3.0

package/dist/core/validation.js

@@ -1,70 +0,0 @@
-import { standardParse } from "../standard-schema.js";
-import { INTERNAL_ERROR_TYPES, EXTERNAL_ERROR_TYPES } from "../types/errors.js";
-import { ok, err } from "../types/result.js";
-import { createValidationError, createInternalLogicError, formatValidationIssues, } from "./errors.js";
-/**
- * Validate input using the configured input schema.
- */
-export async function validateInput(schemas, config, rawInput, actionId) {
-    if (!schemas.inputSchema) {
-        return ok(undefined, actionId);
-    }
-    const result = await standardParse(schemas.inputSchema, rawInput);
-    if (Array.isArray(result.issues) && result.issues.length > 0) {
-        const format = config.validationErrorFormat ?? "flattened";
-        const baseError = formatValidationIssues(result.issues, format);
-        const inputValidationError = createValidationError(EXTERNAL_ERROR_TYPES.INPUT_VALIDATION, "Input validation failed", baseError);
-        return err(inputValidationError, actionId);
-    }
-    if (!result.issues && "value" in result) {
-        return ok(result.value, actionId);
-    }
-    // Should never happen
-    const logicErr = createInternalLogicError("Unexpected validation state in input validation: neither success nor failure");
-    return err(logicErr, actionId);
-}
-/**
- * Validate bound arguments using configured bind schemas.
- */
-export async function validateBindArgs(schemas, config, bindArgs, actionId) {
-    if (!schemas.bindSchemas) {
-        return ok([], actionId);
-    }
-    const validated = [];
-    for (let i = 0; i < schemas.bindSchemas.length; i++) {
-        const schema = schemas.bindSchemas[i];
-        const arg = bindArgs[i];
-        const result = await standardParse(schema, arg);
-        if (Array.isArray(result.issues) && result.issues.length > 0) {
-            const format = config.validationErrorFormat ?? "flattened";
-            const baseError = formatValidationIssues(result.issues, format);
-            const bindError = createValidationError(EXTERNAL_ERROR_TYPES.BIND_ARGS_VALIDATION, "Bind arguments validation failed", baseError);
-            return err(bindError, actionId);
-        }
-        if ("value" in result) {
-            validated.push(result.value);
-        }
-    }
-    return ok(validated, actionId);
-}
-/**
- * Validate action output using configured output schema.
- */
-export async function validateOutput(schemas, config, data, actionId) {
-    if (!schemas.outputSchema) {
-        return ok(data, actionId);
-    }
-    const result = await standardParse(schemas.outputSchema, data);
-    if (Array.isArray(result.issues) && result.issues.length > 0) {
-        const format = config.validationErrorFormat ?? "flattened";
-        const baseError = formatValidationIssues(result.issues, format);
-        const outputError = createValidationError(INTERNAL_ERROR_TYPES.OUTPUT_VALIDATION, "Output validation failed", baseError);
-        return err(outputError, actionId);
-    }
-    if (!result.issues && "value" in result) {
-        return ok(result.value, actionId);
-    }
-    const logicErr = createInternalLogicError("Unexpected validation state in output validation: neither success nor failure");
-    return err(logicErr, actionId);
-}
-//# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

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

package/dist/craft.d.ts

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

package/dist/craft.js

@@ -1,62 +0,0 @@
-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;
-}
-//# sourceMappingURL=craft.js.map

package/dist/craft.js.map

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

package/dist/error.d.ts

@@ -1,31 +0,0 @@
-import type { CraftedAction } from "./types/actions.js";
-import type { BaseError } from "./types/errors.js";
-import type { InferErrors } from "./types/inference.js";
-/**
- * Error wrapper that provides standard Error semantics while preserving
- * the original Actioncraft error data in the cause property.
- */
-export declare class ActioncraftError<TErrorData extends BaseError = BaseError> extends Error {
-    readonly cause: TErrorData;
-    readonly actionId?: string;
-    constructor(errorData: TErrorData, actionId?: string);
-}
-/**
- * Type guard to check if an error is an ActioncraftError.
- *
- * When called with just an error, performs basic structural validation.
- * When called with an error and action, performs verified action ID checking.
- *
- * @param error - The unknown error to check
- * @param action - Optional action for verified checking and type inference
- * @returns Type predicate indicating if error is ActioncraftError
- */
-export declare function isActioncraftError<TAction extends CraftedAction<any, any, any, any>>(error: unknown, action?: TAction): error is ActioncraftError<TAction extends undefined ? BaseError : InferErrors<TAction>>;
-/**
- * Utility to extract the action ID from a crafted action.
- * Useful for debugging and logging purposes.
- *
- * @param action - The crafted action
- * @returns The action ID if available, undefined otherwise
- */
-export declare function getActionId<TAction extends CraftedAction<any, any, any, any>>(action: TAction): string | undefined;

package/dist/error.js

@@ -1,71 +0,0 @@
-/**
- * Error wrapper that provides standard Error semantics while preserving
- * the original Actioncraft error data in the cause property.
- */
-export class ActioncraftError extends Error {
-    cause;
-    actionId;
-    constructor(errorData, actionId) {
-        super(`Actioncraft Error: ${errorData.type}${"message" in errorData ? ` - ${errorData.message}` : ""}`);
-        this.name = "ActioncraftError";
-        this.cause = errorData;
-        this.actionId = actionId;
-        // Ensure proper prototype chain for instanceof checks
-        Object.setPrototypeOf(this, ActioncraftError.prototype);
-    }
-}
-/**
- * Type guard to check if an error is an ActioncraftError.
- *
- * When called with just an error, performs basic structural validation.
- * When called with an error and action, performs verified action ID checking.
- *
- * @param error - The unknown error to check
- * @param action - Optional action for verified checking and type inference
- * @returns Type predicate indicating if error is ActioncraftError
- */
-export function isActioncraftError(error, action) {
-    if (!(error instanceof ActioncraftError)) {
-        return false;
-    }
-    // Verify the cause property exists and has the expected BaseError structure
-    const cause = error.cause;
-    if (!cause || typeof cause !== "object") {
-        return false;
-    }
-    // Verify the cause has a type property that's a string (required by BaseError)
-    if (!("type" in cause) || typeof cause.type !== "string") {
-        return false;
-    }
-    // If message exists, it should be a string (optional in BaseError)
-    if ("message" in cause &&
-        cause.message !== undefined &&
-        typeof cause.message !== "string") {
-        return false;
-    }
-    // If no action provided, just do structural validation
-    if (!action) {
-        return true;
-    }
-    // If action provided, verify the action ID matches
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const actionId = action.__ac_id;
-    // Both action and error must have IDs for verification to be possible
-    if (!actionId || !error.actionId) {
-        return false;
-    }
-    // Check if the error's action ID matches the action's ID
-    return error.actionId === actionId;
-}
-/**
- * Utility to extract the action ID from a crafted action.
- * Useful for debugging and logging purposes.
- *
- * @param action - The crafted action
- * @returns The action ID if available, undefined otherwise
- */
-export function getActionId(action) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    return action.__ac_id;
-}
-//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,gBAEX,SAAQ,KAAK;IACY,KAAK,CAAa;IAC3B,QAAQ,CAAU;IAElC,YAAY,SAAqB,EAAE,QAAiB;QAClD,KAAK,CACH,sBAAsB,SAAS,CAAC,IAAI,GAClC,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EACvD,EAAE,CACH,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,sDAAsD;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAIhC,KAAc,EACd,MAAgB;IAIhB,IAAI,CAAC,CAAC,KAAK,YAAY,gBAAgB,CAAC,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4EAA4E;IAC5E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+EAA+E;IAC/E,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,mEAAmE;IACnE,IACE,SAAS,IAAI,KAAK;QAClB,KAAK,CAAC,OAAO,KAAK,SAAS;QAC3B,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EACjC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uDAAuD;IACvD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mDAAmD;IACnD,8DAA8D;IAC9D,MAAM,QAAQ,GAAI,MAAc,CAAC,OAA6B,CAAC;IAE/D,sEAAsE;IACtE,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,yDAAyD;IACzD,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAGzB,MAAe;IACf,8DAA8D;IAC9D,OAAQ,MAAc,CAAC,OAA6B,CAAC;AACvD,CAAC"}

package/dist/initial.d.ts

@@ -1,14 +0,0 @@
-import type { InferResult } from "./types/inference.js";
-/**
- * Creates an appropriate initial state for any action based on its configuration.
- * The initial state uses the action's real ID for consistency with actual results.
- *
- * For useActionState actions: returns StatefulApiResult with error and values
- * For functional format actions: returns Result.err() with error
- * For regular actions: returns ApiResult with error
- *
- * Usage:
- * - useActionState: const [state, action] = useActionState(myAction, initial(myAction))
- * - useState: const [state, setState] = useState(initial(myAction))
- */
-export declare function initial<TAction>(action: TAction): InferResult<TAction>;

package/dist/initial.js

@@ -1,47 +0,0 @@
-import { EXTERNAL_ERROR_TYPES } from "./types/errors.js";
-import { err } from "./types/result.js";
-/**
- * Creates an appropriate initial state for any action based on its configuration.
- * The initial state uses the action's real ID for consistency with actual results.
- *
- * For useActionState actions: returns StatefulApiResult with error and values
- * For functional format actions: returns Result.err() with error
- * For regular actions: returns ApiResult with error
- *
- * Usage:
- * - useActionState: const [state, action] = useActionState(myAction, initial(myAction))
- * - useState: const [state, setState] = useState(initial(myAction))
- */
-export function initial(action) {
-    const error = {
-        type: EXTERNAL_ERROR_TYPES.INITIAL_STATE,
-        message: "Action has not been executed yet",
-    };
-    // Attempt to read the action ID created during craft()
-    const actionId = 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    action?.__ac_id ?? "unknown";
-    // Attempt to read the Actioncraft config attached during craft()
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const cfg = action?.__ac_config;
-    // Functional format -> Result<_, _>
-    if (cfg?.resultFormat === "functional") {
-        return err(error, actionId);
-    }
-    // useActionState enabled -> StatefulApiResult
-    if (cfg?.useActionState) {
-        return {
-            success: false,
-            error,
-            values: undefined,
-            __ac_id: actionId,
-        };
-    }
-    // Default ApiResult shape
-    return {
-        success: false,
-        error,
-        __ac_id: actionId,
-    };
-}
-//# sourceMappingURL=initial.js.map

package/dist/initial.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"initial.js","sourceRoot":"","sources":["../src/initial.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAExC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,OAAO,CAAU,MAAe;IAC9C,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,oBAAoB,CAAC,aAAa;QACxC,OAAO,EAAE,kCAAkC;KACnC,CAAC;IAEX,uDAAuD;IACvD,MAAM,QAAQ;IACZ,8DAA8D;IAC5D,MAAc,EAAE,OAA8B,IAAI,SAAS,CAAC;IAEhE,iEAAiE;IACjE,8DAA8D;IAC9D,MAAM,GAAG,GAAI,MAAc,EAAE,WAEhB,CAAC;IAEd,oCAAoC;IACpC,IAAI,GAAG,EAAE,YAAY,KAAK,YAAY,EAAE,CAAC;QACvC,OAAO,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAoC,CAAC;IACjE,CAAC;IAED,8CAA8C;IAC9C,IAAI,GAAG,EAAE,cAAc,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,KAAc;YACvB,KAAK;YACL,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,QAAQ;SACiB,CAAC;IACvC,CAAC;IAED,0BAA0B;IAC1B,OAAO;QACL,OAAO,EAAE,KAAc;QACvB,KAAK;QACL,OAAO,EAAE,QAAQ;KACiB,CAAC;AACvC,CAAC"}

package/dist/types/config.d.ts

@@ -1,84 +0,0 @@
-import type { StandardSchemaV1 } from "../standard-schema.js";
-import type { InferCraftedActionResult } from "./actions.js";
-import type { AllPossibleErrors, ErrorDefinition, UserDefinedError } from "./errors.js";
-import type { CallbackMetadata } from "./shared.js";
-/**
- * Custom logging interface for ActionCraft.
- */
-export type CrafterLogger = {
-    /** Called when callback functions fail */
-    error?: (message: string, error: unknown) => void;
-    /** Called when ActionCraft detects internal bugs */
-    warn?: (message: string, details?: unknown) => void;
-};
-/**
- * Configuration options for building actions.
- */
-export type CrafterConfig = {
-    /**
-     * Result format returned by actions.
-     * "api" returns {success, data/error}, "functional" returns {type, value/error}.
-     * Ignored when useActionState is enabled.
-     */
-    resultFormat?: "api" | "functional";
-    /**
-     * Validation error structure.
-     * "flattened" returns array of {path, message}, "nested" groups by field.
-     */
-    validationErrorFormat?: "flattened" | "nested";
-    /**
-     * Enables React useActionState compatibility.
-     * Action accepts prevState parameter and returns a stateful result.
-     */
-    useActionState?: boolean;
-    /**
-     * Custom handler for unexpected thrown errors.
-     * Transforms exceptions into structured error objects.
-     */
-    handleThrownError?: (error: unknown) => UserDefinedError;
-    /**
-     * Logger for ActionCraft internal events.
-     */
-    logger?: CrafterLogger;
-};
-/**
- * Schema definitions for validating inputs and outputs.
- */
-export type CrafterSchemas = {
-    /** Validates input values passed to the action */
-    inputSchema?: StandardSchemaV1;
-    /** Validates success data returned from the action */
-    outputSchema?: StandardSchemaV1;
-    /** Array of schemas for validating bound arguments */
-    bindSchemas?: readonly StandardSchemaV1[];
-};
-/**
- * Custom error types that actions can return.
- * Each property is a function that creates a typed error object.
- */
-export type CrafterErrors = Record<string, ErrorDefinition>;
-/**
- * Lifecycle hooks that run during action execution.
- * Callback errors are logged but do not affect action results.
- */
-export type CrafterCallbacks<TConfig extends CrafterConfig, TSchemas extends CrafterSchemas, TErrors extends CrafterErrors, TData> = {
-    /** Called when action starts executing, before any validation. */
-    onStart?: (params: {
-        metadata: CallbackMetadata<TConfig, TSchemas, TErrors, TData>;
-    }) => Promise<void> | void;
-    /** Called when action fails. */
-    onError?: (params: {
-        error: AllPossibleErrors<TErrors, TConfig, TSchemas>;
-        metadata: CallbackMetadata<TConfig, TSchemas, TErrors, TData>;
-    }) => Promise<void> | void;
-    /** Called when action succeeds. */
-    onSuccess?: (params: {
-        data: TData;
-        metadata: CallbackMetadata<TConfig, TSchemas, TErrors, TData>;
-    }) => Promise<void> | void;
-    /** Called after action finishes, regardless of success or failure. */
-    onSettled?: (params: {
-        result: InferCraftedActionResult<TConfig, TSchemas, TErrors, TData>;
-        metadata: CallbackMetadata<TConfig, TSchemas, TErrors, TData>;
-    }) => Promise<void> | void;
-};

package/dist/types/config.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":""}

package/dist/types/crafter.d.ts

@@ -1,87 +0,0 @@
-import type { StandardSchemaV1 } from "../standard-schema.js";
-import type { InferCraftedActionResult } from "./actions.js";
-import type { AllPossibleErrors, ErrorDefinition, UserDefinedError } from "./errors.js";
-import type { CallbackMetadata } from "./shared.js";
-/**
- * Custom logging interface for Actioncraft.
- */
-export type Logger = {
-    /** Called when callback functions fail */
-    error?: (message: string, error: unknown) => void;
-    /** Called when Actioncraft detects internal bugs */
-    warn?: (message: string, details?: unknown) => void;
-};
-/**
- * Configuration options for crafting actions.
- */
-export type Config = {
-    /**
-     * Result format returned by actions.
-     * "api" returns {success, data/error}, "functional" returns {type, value/error}.
-     * Ignored when useActionState is enabled.
-     * @default "api"
-     */
-    resultFormat?: "api" | "functional";
-    /**
-     * Validation error structure.
-     * "flattened" returns array of {path, message}, "nested" groups by field.
-     * @default "flattened"
-     */
-    validationErrorFormat?: "flattened" | "nested";
-    /**
-     * Enables React useActionState compatibility.
-     * Action accepts prevState parameter and returns a stateful result.
-     * @default false
-     */
-    useActionState?: boolean;
-    /**
-     * Custom handler for unexpected thrown errors.
-     * Transforms exceptions into structured error objects.
-     */
-    handleThrownError?: (error: unknown) => UserDefinedError;
-    /**
-     * Logger for Actioncraft internal events.
-     */
-    logger?: Logger;
-};
-/**
- * Schema definitions for validating inputs and outputs.
- */
-export type Schemas = {
-    /** Validates input values passed to the action */
-    inputSchema?: StandardSchemaV1;
-    /** Validates success data returned from the action */
-    outputSchema?: StandardSchemaV1;
-    /** Array of schemas for validating bound arguments */
-    bindSchemas?: readonly StandardSchemaV1[];
-};
-/**
- * Custom error types that actions can return.
- * Each property is a function that creates a typed error object.
- */
-export type Errors = Record<string, ErrorDefinition>;
-/**
- * Lifecycle hooks that run during action execution.
- * Callback errors are logged but do not affect action results.
- */
-export type Callbacks<TConfig extends Config, TSchemas extends Schemas, TErrors extends Errors, TData> = {
-    /** Called when action starts executing, before any validation. */
-    onStart?: (params: {
-        metadata: CallbackMetadata<TConfig, TSchemas, TErrors, TData>;
-    }) => Promise<void> | void;
-    /** Called when action fails. */
-    onError?: (params: {
-        error: AllPossibleErrors<TErrors, TConfig, TSchemas>;
-        metadata: CallbackMetadata<TConfig, TSchemas, TErrors, TData>;
-    }) => Promise<void> | void;
-    /** Called when action succeeds. */
-    onSuccess?: (params: {
-        data: TData;
-        metadata: CallbackMetadata<TConfig, TSchemas, TErrors, TData>;
-    }) => Promise<void> | void;
-    /** Called after action finishes, regardless of success or failure. */
-    onSettled?: (params: {
-        result: InferCraftedActionResult<TConfig, TSchemas, TErrors, TData>;
-        metadata: CallbackMetadata<TConfig, TSchemas, TErrors, TData>;
-    }) => Promise<void> | void;
-};

package/dist/types/crafter.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=crafter.js.map

package/dist/types/crafter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"crafter.js","sourceRoot":"","sources":["../../src/types/crafter.ts"],"names":[],"mappings":""}