@m1kapp/kit 0.0.1 → 0.0.3

package/dist/index.d.mts

@@ -438,8 +438,14 @@ interface UseFormSubmitOptions<T> {
     onSuccess?: (data: T) => void;
     onError?: (err: Error) => void;
 }
+/**
+ * Submit function type:
+ * - When V is `void` (fn takes no arguments) → `submit()` needs no args
+ * - Otherwise → `submit(vars: V)` requires the arg
+ */
+type SubmitFn<V> = V extends void ? () => Promise<void> : (vars: V) => Promise<void>;
 interface UseFormSubmitResult<T, V> {
-    submit: (vars: V) => Promise<void>;
+    submit: SubmitFn<V>;
     loading: boolean;
     error: Error | null;
     data: T | undefined;
@@ -450,16 +456,21 @@ interface UseFormSubmitResult<T, V> {
  * Eliminates the try/catch/finally + setState boilerplate from every form.
  *
  * @example
+ * // With args
  * const { submit, loading, error } = useFormSubmit(async (url: string) => {
  *   return api.post<Site>("/api/sites", { url });
  * }, {
- *   onSuccess: () => router.push("/dashboard"),
+ *   onSuccess: (site) => router.push(`/${site.slug}`),
  * });
+ * <button onClick={() => submit(inputValue)}>등록</button>
  *
- * <form onSubmit={e => { e.preventDefault(); submit(input); }}>
- *   <Button loading={loading}>등록</Button>
- *   {error && <p>{error.message}</p>}
- * </form>
+ * @example
+ * // No args (fire-and-forget style)
+ * const { submit: save, loading } = useFormSubmit(
+ *   () => api.put("/api/sites/settings", config),
+ *   { onSuccess: () => setSaved(true) }
+ * );
+ * <button onClick={save}>저장</button>
  */
 declare function useFormSubmit<T, V = void>(fn: (vars: V) => Promise<T>, options?: UseFormSubmitOptions<T>): UseFormSubmitResult<T, V>;
 
@@ -816,7 +827,9 @@ declare class ApiError extends Error {
     readonly status: number;
     readonly statusText: string;
     readonly body: unknown;
-    constructor(status: number, statusText: string, body: unknown);
+    readonly url?: string | undefined;
+    readonly method?: string | undefined;
+    constructor(status: number, statusText: string, body: unknown, url?: string | undefined, method?: string | undefined);
 }
 
 interface ApiClientOptions {
@@ -824,7 +837,7 @@ interface ApiClientOptions {
     headers?: Record<string, string>;
     /** Called before every request — mutate or replace the Request */
     onRequest?: (req: Request) => Request | void;
-    /** Called on every non-2xx response */
+    /** Called on every non-2xx response — includes url and method for debugging */
     onError?: (err: ApiError) => void;
 }
 type RequestOptions = {
@@ -844,6 +857,7 @@ type ApiClient = ReturnType<typeof createApiClient>;
 
 /** Manually invalidate cache entries. Pass a URL to clear one, or nothing to clear all. */
 declare function clearFetchCache(url?: string): void;
+type FetchStatus = "idle" | "loading" | "success" | "error";
 interface UseFetchOptions<T> {
     /** Skip fetching when false (default: true) */
     enabled?: boolean;
@@ -864,6 +878,14 @@ interface UseFetchResult<T> {
     data: T | undefined;
     loading: boolean;
     error: Error | undefined;
+    /**
+     * Lifecycle status:
+     * - `"idle"` — url is null/undefined or `enabled: false`
+     * - `"loading"` — fetch in progress
+     * - `"success"` — data loaded (note: data may be null if the API returned null)
+     * - `"error"` — last fetch failed
+     */
+    status: FetchStatus;
     /** Manually trigger a refetch (ignores cache) */
     refetch: () => void;
 }
@@ -887,6 +909,8 @@ interface UsePollingResult<T> {
     isRunning: boolean;
     stop: () => void;
     start: () => void;
+    /** Immediately trigger a fetch without waiting for the next interval */
+    refetch: () => void;
 }
 declare function usePolling<T>(fetcher: () => Promise<T>, options?: UsePollingOptions<T>): UsePollingResult<T>;
 

package/dist/index.d.ts

@@ -438,8 +438,14 @@ interface UseFormSubmitOptions<T> {
     onSuccess?: (data: T) => void;
     onError?: (err: Error) => void;
 }
+/**
+ * Submit function type:
+ * - When V is `void` (fn takes no arguments) → `submit()` needs no args
+ * - Otherwise → `submit(vars: V)` requires the arg
+ */
+type SubmitFn<V> = V extends void ? () => Promise<void> : (vars: V) => Promise<void>;
 interface UseFormSubmitResult<T, V> {
-    submit: (vars: V) => Promise<void>;
+    submit: SubmitFn<V>;
     loading: boolean;
     error: Error | null;
     data: T | undefined;
@@ -450,16 +456,21 @@ interface UseFormSubmitResult<T, V> {
  * Eliminates the try/catch/finally + setState boilerplate from every form.
  *
  * @example
+ * // With args
  * const { submit, loading, error } = useFormSubmit(async (url: string) => {
  *   return api.post<Site>("/api/sites", { url });
  * }, {
- *   onSuccess: () => router.push("/dashboard"),
+ *   onSuccess: (site) => router.push(`/${site.slug}`),
  * });
+ * <button onClick={() => submit(inputValue)}>등록</button>
  *
- * <form onSubmit={e => { e.preventDefault(); submit(input); }}>
- *   <Button loading={loading}>등록</Button>
- *   {error && <p>{error.message}</p>}
- * </form>
+ * @example
+ * // No args (fire-and-forget style)
+ * const { submit: save, loading } = useFormSubmit(
+ *   () => api.put("/api/sites/settings", config),
+ *   { onSuccess: () => setSaved(true) }
+ * );
+ * <button onClick={save}>저장</button>
  */
 declare function useFormSubmit<T, V = void>(fn: (vars: V) => Promise<T>, options?: UseFormSubmitOptions<T>): UseFormSubmitResult<T, V>;
 
@@ -816,7 +827,9 @@ declare class ApiError extends Error {
     readonly status: number;
     readonly statusText: string;
     readonly body: unknown;
-    constructor(status: number, statusText: string, body: unknown);
+    readonly url?: string | undefined;
+    readonly method?: string | undefined;
+    constructor(status: number, statusText: string, body: unknown, url?: string | undefined, method?: string | undefined);
 }
 
 interface ApiClientOptions {
@@ -824,7 +837,7 @@ interface ApiClientOptions {
     headers?: Record<string, string>;
     /** Called before every request — mutate or replace the Request */
     onRequest?: (req: Request) => Request | void;
-    /** Called on every non-2xx response */
+    /** Called on every non-2xx response — includes url and method for debugging */
     onError?: (err: ApiError) => void;
 }
 type RequestOptions = {
@@ -844,6 +857,7 @@ type ApiClient = ReturnType<typeof createApiClient>;
 
 /** Manually invalidate cache entries. Pass a URL to clear one, or nothing to clear all. */
 declare function clearFetchCache(url?: string): void;
+type FetchStatus = "idle" | "loading" | "success" | "error";
 interface UseFetchOptions<T> {
     /** Skip fetching when false (default: true) */
     enabled?: boolean;
@@ -864,6 +878,14 @@ interface UseFetchResult<T> {
     data: T | undefined;
     loading: boolean;
     error: Error | undefined;
+    /**
+     * Lifecycle status:
+     * - `"idle"` — url is null/undefined or `enabled: false`
+     * - `"loading"` — fetch in progress
+     * - `"success"` — data loaded (note: data may be null if the API returned null)
+     * - `"error"` — last fetch failed
+     */
+    status: FetchStatus;
     /** Manually trigger a refetch (ignores cache) */
     refetch: () => void;
 }
@@ -887,6 +909,8 @@ interface UsePollingResult<T> {
     isRunning: boolean;
     stop: () => void;
     start: () => void;
+    /** Immediately trigger a fetch without waiting for the next interval */
+    refetch: () => void;
 }
 declare function usePolling<T>(fetcher: () => Promise<T>, options?: UsePollingOptions<T>): UsePollingResult<T>;