@kellanjs/actioncraft 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kellanjs/actioncraft",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Fluent, type-safe builder for Next.js server actions.",
   "keywords": [
     "next.js",
@@ -49,7 +49,7 @@
     "ci": "npm run lint && npm run build && npm run check-format && npm run check-exports && npm run test"
   },
   "peerDependencies": {
-    "next": "^15.0.0",
+    "next": "^15.0.0 || ^16.0.0",
     "react": "^19.0.0"
   },
   "peerDependenciesMeta": {
@@ -59,16 +59,16 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
-    "@eslint/js": "^9.30.1",
+    "@eslint/js": "^9.39.0",
     "@trivago/prettier-plugin-sort-imports": "^5.2.2",
-    "eslint": "^9.30.1",
-    "next": "^15.0.0",
+    "eslint": "^9.39.0",
+    "next": "^16.0.0",
     "prettier": "^3.6.2",
-    "react": "^19.0.0",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.35.1",
-    "vitest": "^3.2.4",
-    "zod": "^4.1.5",
+    "react": "^19.2.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.2",
+    "vitest": "^4.0.6",
+    "zod": "^4.1.12",
     "zod-form-data": "^3.0.1"
   }
 }

package/dist/actioncraft-error.d.ts

@@ -1,23 +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>>;

package/dist/actioncraft-error.js

@@ -1,60 +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;
-}
-//# sourceMappingURL=actioncraft-error.js.map

package/dist/actioncraft-error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"actioncraft-error.js","sourceRoot":"","sources":["../src/actioncraft-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"}

package/dist/actioncraft-prev.d.ts

@@ -1,93 +0,0 @@
-import type { ActionImpl, ActionImplParams, CraftedAction, InferDataFromActionImpl } from "./types/actions.js";
-import type { CrafterCallbacks, CrafterConfig, CrafterErrors, CrafterSchemas } from "./types/config.js";
-import type { InferResult } from "./types/inference.js";
-/**
- * Builder class for creating type-safe server actions with validation, error handling, and callbacks.
- */
-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 _actionImpl?;
-    constructor(config: TConfig, schemas: TSchemas, errors: TErrors, callbacks: TCallbacks, actionImpl?: ActionImpl<TConfig, TSchemas, TErrors, TData>);
-    /**
-     * Defines validation schemas for input, output, and bind arguments.
-     * Resets previously defined actions and callbacks.
-     */
-    schemas<TNewSchemas extends CrafterSchemas>(schemas: TNewSchemas): Crafter<TConfig, TNewSchemas, TErrors, Record<string, never>, unknown>;
-    /**
-     * Defines error functions for returning typed errors from actions.
-     * Resets previously defined actions and callbacks.
-     */
-    errors<const TNewErrors extends CrafterErrors>(errors: TNewErrors): Crafter<TConfig, TSchemas, TNewErrors, Record<string, never>, unknown>;
-    /**
-     * Defines the action implementation function containing business logic.
-     * Resets previously defined callbacks.
-     */
-    action<TFn extends (params: ActionImplParams<TConfig, TSchemas, TErrors, TData>) => Promise<unknown>>(fn: TFn): Crafter<TConfig, TSchemas, TErrors, Record<string, never>, InferDataFromActionImpl<TFn>>;
-    /**
-     * Defines lifecycle callbacks for action execution.
-     * Must be called after action() for correct type inference.
-     */
-    callbacks<TNewCallbacks extends CrafterCallbacks<TConfig, TSchemas, TErrors, TData>>(callbacks: TNewCallbacks): Crafter<TConfig, TSchemas, TErrors, TNewCallbacks, TData>;
-    /**
-     * Builds and returns the final executable action function.
-     */
-    craft(): CraftedAction<TConfig, TSchemas, TErrors, TData>;
-    /** Orchestrates action execution including 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;
-    /**
-     * Creates error functions that return Result objects when called by action implementations.
-     */
-    private _buildErrorFunctions;
-}
-/**
- * Creates a new Crafter instance for building type-safe server actions.
- */
-export declare function create<TConfig extends CrafterConfig = CrafterConfig>(config?: TConfig): Crafter<TConfig, Record<string, never>, Record<string, never>, Record<string, never>, unknown>;
-/**
- * Creates an appropriate initial state for any action based on its configuration.
- *
- * 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>;
-export {};

package/dist/actioncraft-prev.js

@@ -1,387 +0,0 @@
-import { unstable_rethrow } from "next/navigation.js";
-import { safeExecuteCallback } from "./core/callbacks.js";
-import { createImplicitReturnErrorResult, createUnhandledErrorResult, } from "./core/errors.js";
-import { log } from "./core/logging.js";
-import { convertToClientError, serializeRawInput, } from "./core/transformation.js";
-import { validateBindArgs, validateInput, validateOutput, } from "./core/validation.js";
-import { EXTERNAL_ERROR_TYPES, } from "./types/errors.js";
-import { err, isErr, isOk, isResultErr, isResultOk } from "./types/result.js";
-// ============================================================================
-// CRAFTER CLASS - TYPE-SAFE ACTION BUILDER
-// ============================================================================
-/**
- * Builder class for creating type-safe server actions with validation, error handling, and callbacks.
- */
-class Crafter {
-    _config;
-    _schemas;
-    _errors;
-    _callbacks;
-    _actionImpl;
-    constructor(config, schemas, errors, callbacks, actionImpl) {
-        this._config = config;
-        this._schemas = schemas;
-        this._errors = errors;
-        this._callbacks = callbacks;
-        this._actionImpl = actionImpl;
-    }
-    // --------------------------------------------------------------------------
-    // FLUENT API METHODS
-    // --------------------------------------------------------------------------
-    /**
-     * Defines validation schemas for input, output, and bind arguments.
-     * Resets previously defined actions and callbacks.
-     */
-    schemas(schemas) {
-        return new Crafter(this._config, schemas, this._errors, {}, undefined);
-    }
-    /**
-     * Defines error functions for returning typed errors from actions.
-     * Resets previously defined actions and callbacks.
-     */
-    errors(errors) {
-        return new Crafter(this._config, this._schemas, errors, {}, undefined);
-    }
-    /**
-     * Defines the action implementation function containing business logic.
-     * Resets previously defined callbacks.
-     */
-    action(fn) {
-        return new Crafter(this._config, this._schemas, this._errors, {}, fn);
-    }
-    /**
-     * Defines lifecycle callbacks for action execution.
-     * Must be called after action() for correct type inference.
-     */
-    callbacks(callbacks) {
-        return new Crafter(this._config, this._schemas, this._errors, callbacks, this._actionImpl);
-    }
-    /**
-     * Builds and returns the final executable action function.
-     */
-    craft() {
-        if (!this._actionImpl) {
-            throw new Error("Action implementation is not defined. Call .action() before calling .craft().");
-        }
-        const craftedAction = (...args) => {
-            return this._runAction(args);
-        };
-        // Attach the action's config for runtime inspection (used by `initial()`)
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        craftedAction.__ac_config = this._config;
-        return craftedAction;
-    }
-    // --------------------------------------------------------------------------
-    // ACTION EXECUTION
-    // --------------------------------------------------------------------------
-    /** Orchestrates action execution including validation, business logic, callbacks, and result formatting. */
-    async _runAction(args) {
-        // We know this exists because craft() verifies it
-        const actionImpl = this._actionImpl;
-        // Extract bindArgs, prevState, and input from the raw args
-        const { bindArgs: rawBindArgs, prevState, input: rawInput, } = this._extractActionArgs(args);
-        // Check for custom error handler
-        const handleThrownErrorFn = this._config.handleThrownError
-            ? (error) => err(this._config.handleThrownError(error))
-            : null;
-        // Execute onStart callback before any processing
-        await this._executeOnStartCallback({
-            rawInput,
-            rawBindArgs,
-            prevState,
-            validatedInput: undefined,
-            validatedBindArgs: undefined,
-        });
-        // Track validation state for error handling
-        let validatedInput = undefined;
-        let validatedBindArgs = undefined;
-        try {
-            // Validate input and return on failure
-            const inputValidation = await this._validateInput(rawInput);
-            if (!isOk(inputValidation)) {
-                await this._executeResultCallbacks(inputValidation, {
-                    rawInput,
-                    rawBindArgs,
-                    prevState,
-                    validatedInput,
-                    validatedBindArgs,
-                });
-                return this._toActionResult(inputValidation, rawInput);
-            }
-            // Update validation state
-            validatedInput = inputValidation.value;
-            // Validate bound arguments and return on failure
-            const bindArgsValidation = await this._validateBindArgs(rawBindArgs);
-            if (!isOk(bindArgsValidation)) {
-                await this._executeResultCallbacks(bindArgsValidation, {
-                    rawInput,
-                    rawBindArgs,
-                    prevState,
-                    validatedInput,
-                    validatedBindArgs,
-                });
-                return this._toActionResult(bindArgsValidation, rawInput);
-            }
-            // Update validation state
-            validatedBindArgs = bindArgsValidation.value;
-            // Execute the user's action implementation
-            const actionImplResult = await actionImpl({
-                input: inputValidation.value,
-                bindArgs: bindArgsValidation.value,
-                errors: this._buildErrorFunctions(),
-                metadata: { rawInput, rawBindArgs, prevState },
-            });
-            // Return on `undefined` (implicit return error)
-            if (actionImplResult === undefined) {
-                const implicitReturnError = createImplicitReturnErrorResult();
-                await this._executeResultCallbacks(implicitReturnError, {
-                    rawInput,
-                    rawBindArgs,
-                    prevState,
-                    validatedInput,
-                    validatedBindArgs,
-                });
-                return this._toActionResult(implicitReturnError, rawInput);
-            }
-            let finalResult;
-            // Process different return types from the action
-            if (isResultErr(actionImplResult)) {
-                finalResult = actionImplResult;
-            }
-            else {
-                const outputData = isResultOk(actionImplResult)
-                    ? actionImplResult.value
-                    : actionImplResult;
-                finalResult = await this._validateOutput(outputData);
-            }
-            // Execute callbacks and return final result
-            await this._executeResultCallbacks(finalResult, {
-                rawInput,
-                rawBindArgs,
-                prevState,
-                validatedInput,
-                validatedBindArgs,
-            });
-            // Use validated input for the values field on a successful run
-            const inputForValues = isOk(finalResult)
-                ? this._schemas.inputSchema
-                    ? inputValidation.value
-                    : rawInput
-                : rawInput;
-            return this._toActionResult(finalResult, inputForValues);
-        }
-        catch (error) {
-            // Re-throw Next.js framework errors
-            unstable_rethrow(error);
-            // Handle unexpected thrown errors
-            try {
-                const errorResult = this._handleThrownError(error, handleThrownErrorFn);
-                await this._executeResultCallbacks(errorResult, {
-                    rawInput,
-                    rawBindArgs,
-                    prevState,
-                    validatedInput,
-                    validatedBindArgs,
-                });
-                return this._toActionResult(errorResult, rawInput);
-            }
-            catch (handlerError) {
-                // If we catch another error here, then we're done
-                log(this._config.logger, "warn", "Error handling failure - both primary error and error handler threw", { primaryError: error, handlerError });
-                return this._toActionResult(createUnhandledErrorResult(), rawInput);
-            }
-        }
-    }
-    /**
-     * Extracts bind arguments, previous state, and input from raw action arguments.
-     */
-    _extractActionArgs(args) {
-        const numBindSchemas = this._schemas.bindSchemas?.length ?? 0;
-        if (this._config.useActionState) {
-            return {
-                bindArgs: args.slice(0, numBindSchemas),
-                prevState: args[numBindSchemas],
-                input: args[numBindSchemas + 1],
-            };
-        }
-        return {
-            bindArgs: args.slice(0, numBindSchemas),
-            // When useActionState is disabled the prevState parameter is never
-            // present, so we cast to never (or undefined) to satisfy the type.
-            prevState: undefined,
-            input: args[numBindSchemas],
-        };
-    }
-    // --------------------------------------------------------------------------
-    // RESULT TRANSFORMATION
-    // --------------------------------------------------------------------------
-    /**
-     * Transforms internal Result objects to client-facing action result format.
-     */
-    _toActionResult(result, inputForValues) {
-        // Convert internal errors to client-facing errors
-        const clientResult = isOk(result) ? result : err(convertToClientError(result.error));
-        // Handle useActionState format (always returns StatefulApiResult)
-        if (this._config.useActionState) {
-            if (isOk(clientResult)) {
-                const successValues = this._schemas.inputSchema
-                    ? inputForValues
-                    : serializeRawInput(inputForValues);
-                return {
-                    success: true,
-                    data: clientResult.value,
-                    values: successValues,
-                };
-            }
-            return {
-                success: false,
-                error: clientResult.error,
-                values: serializeRawInput(inputForValues),
-            };
-        }
-        const format = this._config.resultFormat ?? "api";
-        // Return functional format if configured
-        if (format === "functional") {
-            return clientResult;
-        }
-        // Default API format
-        if (isOk(clientResult)) {
-            return {
-                success: true,
-                data: clientResult.value,
-            };
-        }
-        return {
-            success: false,
-            error: clientResult.error,
-        };
-    }
-    // --------------------------------------------------------------------------
-    // ERROR HANDLING
-    // --------------------------------------------------------------------------
-    /**
-     * Handles uncaught exceptions during action execution.
-     */
-    _handleThrownError(error, customHandler) {
-        const caughtErrorResult = customHandler
-            ? customHandler(error)
-            : createUnhandledErrorResult();
-        return caughtErrorResult;
-    }
-    // --------------------------------------------------------------------------
-    // VALIDATION
-    // --------------------------------------------------------------------------
-    /**
-     * Validates input using the shared helper.
-     */
-    _validateInput(rawInput) {
-        return validateInput(this._schemas, this._config, rawInput);
-    }
-    /**
-     * Validates bound arguments using the configured bind schemas.
-     */
-    _validateBindArgs(bindArgs) {
-        return validateBindArgs(this._schemas, this._config, bindArgs);
-    }
-    /**
-     * Validates output data using the configured output schema.
-     */
-    _validateOutput(data) {
-        return validateOutput(this._schemas, this._config, data);
-    }
-    // --------------------------------------------------------------------------
-    // CALLBACKS
-    // --------------------------------------------------------------------------
-    /**
-     * Executes the onStart callback if defined.
-     */
-    async _executeOnStartCallback(metadata) {
-        const callbacks = this._callbacks;
-        if (callbacks.onStart) {
-            await safeExecuteCallback(() => callbacks.onStart({ metadata }), "onStart", (level, msg, details) => log(this._config.logger, level, msg, details));
-        }
-    }
-    /**
-     * Executes result-based lifecycle callbacks (onSuccess, onError, onSettled).
-     */
-    async _executeResultCallbacks(result, metadata) {
-        const callbacks = this._callbacks;
-        // Success path
-        if (isOk(result)) {
-            await safeExecuteCallback(callbacks.onSuccess
-                ? () => callbacks.onSuccess({ data: result.value, metadata })
-                : undefined, "onSuccess", (level, msg, details) => log(this._config.logger, level, msg, details));
-        }
-        // Error path
-        if (isErr(result)) {
-            await safeExecuteCallback(callbacks.onError
-                ? () => callbacks.onError({ error: result.error, metadata })
-                : undefined, "onError", (level, msg, details) => log(this._config.logger, level, msg, details));
-        }
-        // onSettled always runs, regardless of result
-        const finalResult = this._toActionResult(result);
-        await safeExecuteCallback(callbacks.onSettled
-            ? () => callbacks.onSettled({ result: finalResult, metadata })
-            : undefined, "onSettled", (level, msg, details) => log(this._config.logger, level, msg, details));
-    }
-    // --------------------------------------------------------------------------
-    // UTILITY METHODS
-    // --------------------------------------------------------------------------
-    /**
-     * Creates error functions that return Result objects when called by action implementations.
-     */
-    _buildErrorFunctions() {
-        const errorFns = {};
-        for (const [key, errorDefFn] of Object.entries(this._errors)) {
-            errorFns[key] = ((...args) => err(errorDefFn(...args)));
-        }
-        return errorFns;
-    }
-}
-// ============================================================================
-// PUBLIC API EXPORTS
-// ============================================================================
-/**
- * Creates a new Crafter instance for building type-safe server actions.
- */
-export function create(config) {
-    return new Crafter(config ?? {}, {}, {}, {}, undefined);
-}
-/**
- * Creates an appropriate initial state for any action based on its configuration.
- *
- * 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 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);
-    }
-    // useActionState enabled -> StatefulApiResult
-    if (cfg?.useActionState) {
-        return {
-            success: false,
-            error,
-            values: undefined,
-        };
-    }
-    // Default ApiResult shape
-    return {
-        success: false,
-        error,
-    };
-}
-//# sourceMappingURL=actioncraft-prev.js.map

package/dist/actioncraft-prev.js.map

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