@resiliojs/next 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Resilio contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# @resiliojs/next
+
+Next.js facade for Resilio. Includes the React and Core APIs plus Server Action
+and App Router integrations.
+
+## Install
+
+```bash
+pnpm add @resiliojs/next
+```
+
+Use `@resiliojs/next` in Server Components and Server Actions. Use
+`@resiliojs/next/client` in Client Components.
+
+```tsx
+'use client';
+
+import { useResilioState } from '@resiliojs/next/client';
+
+const [state, action, pending] = useResilioState(updateProfile, {
+  catalog,
+  presentation: { surface: 'profile-form' },
+});
+```
+
+Expected Server Action failures are decoded and dispatched automatically.
+Unexpected exceptions, `redirect()`, `notFound()`, and framework reset semantics
+remain owned by Next.js.
+
+See the [full documentation](https://github.com/noonnofus/resilio#readme).
+
+MIT

package/dist/client.cjs

@@ -0,0 +1,184 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client/index.ts
+var client_exports = {};
+__export(client_exports, {
+  BoundedDedupeStore: () => import_core2.BoundedDedupeStore,
+  PolicyEngine: () => import_core2.PolicyEngine,
+  ResilioErrorBoundary: () => import_react5.ResilioErrorBoundary,
+  ResilioPresentationHost: () => import_react5.ResilioPresentationHost,
+  ResilioPresentationProvider: () => import_react5.ResilioPresentationProvider,
+  ResilioProvider: () => import_react5.ResilioProvider,
+  canonicalStringify: () => import_core2.canonicalStringify,
+  capture: () => import_react5.capture,
+  captureAsync: () => import_react5.captureAsync,
+  createCompositeSink: () => import_core2.createCompositeSink,
+  createConsoleSink: () => import_core2.createConsoleSink,
+  createPresentationEvaluator: () => import_core2.createPresentationEvaluator,
+  createPublicError: () => import_core2.createPublicError,
+  createResilioRootHandlers: () => import_react5.createResilioRootHandlers,
+  decodePublicError: () => import_core2.decodePublicError,
+  defineErrorCatalog: () => import_core2.defineErrorCatalog,
+  defineErrorPolicy: () => import_core2.defineErrorPolicy,
+  definePresentationPolicy: () => import_core2.definePresentationPolicy,
+  err: () => import_core2.err,
+  installResilioBrowserErrorBridge: () => import_react5.installResilioBrowserErrorBridge,
+  isErr: () => import_core2.isErr,
+  isOk: () => import_core2.isOk,
+  isPublicResult: () => import_core2.isPublicResult,
+  ok: () => import_core2.ok,
+  shouldSuppress: () => import_core2.shouldSuppress,
+  stringHash: () => import_core2.stringHash,
+  toActionState: () => toActionState,
+  useOptionalPresentError: () => import_react5.useOptionalPresentError,
+  useOptionalReportError: () => import_react7.useOptionalReportError,
+  usePresentError: () => import_react5.usePresentError,
+  useReportError: () => import_react6.useReportError,
+  useResilio: () => import_react6.useResilio,
+  useResilioAlert: () => import_react5.useResilioAlert,
+  useResilioBrowserErrorBridge: () => import_react5.useResilioBrowserErrorBridge,
+  useResilioHandler: () => import_react5.useResilioHandler,
+  useResilioInline: () => import_react5.useResilioInline,
+  useResilioRouteError: () => useResilioRouteError,
+  useResilioState: () => useResilioState
+});
+module.exports = __toCommonJS(client_exports);
+var import_react5 = require("@resiliojs/react");
+var import_react6 = require("@resiliojs/react");
+var import_react7 = require("@resiliojs/react");
+var import_core2 = require("@resiliojs/core");
+
+// src/action-state.ts
+function toActionState(initialData = null) {
+  return { ok: true, data: initialData };
+}
+
+// src/client/useResilioState.ts
+var import_react = require("react");
+var import_react2 = require("@resiliojs/react");
+var import_core = require("@resiliojs/core");
+function useResilioState(action, options) {
+  const report = (0, import_react2.useOptionalReportError)();
+  const present = (0, import_react2.useOptionalPresentError)();
+  const initialState = {
+    ok: true,
+    data: options.initialData ?? null
+  };
+  const [state, execute, isPending] = (0, import_react.useActionState)(async (prevState, payload) => {
+    const res = await action(prevState, payload);
+    if (res && typeof res === "object" && "ok" in res) {
+      if (!res.ok && res.error) {
+        const decoded = await (0, import_core.decodePublicError)(options.catalog, res.error);
+        if (!decoded.ok) {
+          report?.invalidPublic(decoded.reason, { source: "next.action" });
+          options.onInvalidPublicError?.(decoded.reason);
+          return res;
+        }
+        report?.public(decoded.value, { source: "next.action" });
+        await present?.(decoded.value, {
+          ...options.presentation,
+          source: "next.action"
+        });
+        options.onError?.(decoded.value);
+      } else if (res.ok && res.data != null) {
+        options.onSuccess?.(res.data);
+      }
+    }
+    return res;
+  }, initialState);
+  return [state, execute, isPending];
+}
+
+// src/client/useResilioRouteError.ts
+var import_react3 = require("react");
+var import_react4 = require("@resiliojs/react");
+function useResilioRouteError(error, reset, options = {}) {
+  const report = (0, import_react4.useOptionalReportError)();
+  const reported = (0, import_react3.useRef)(null);
+  const resetTimestamps = (0, import_react3.useRef)([]);
+  const [resetBlocked, setResetBlocked] = (0, import_react3.useState)(false);
+  (0, import_react3.useEffect)(() => {
+    if (reported.current === error) return;
+    reported.current = error;
+    report?.exception(error, {
+      source: "next.route",
+      correlationId: error.digest,
+      context: { digest: error.digest }
+    });
+  }, [error, report]);
+  const guardedReset = (0, import_react3.useCallback)(() => {
+    const now = Date.now();
+    const windowMs = options.resetWindowMs ?? 1e3;
+    const maxResets = options.maxResets ?? 3;
+    resetTimestamps.current = resetTimestamps.current.filter(
+      (timestamp) => now - timestamp < windowMs
+    );
+    if (resetTimestamps.current.length >= maxResets) {
+      setResetBlocked(true);
+      return;
+    }
+    resetTimestamps.current.push(now);
+    reset();
+  }, [options.maxResets, options.resetWindowMs, reset]);
+  return { reset: guardedReset, resetBlocked };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BoundedDedupeStore,
+  PolicyEngine,
+  ResilioErrorBoundary,
+  ResilioPresentationHost,
+  ResilioPresentationProvider,
+  ResilioProvider,
+  canonicalStringify,
+  capture,
+  captureAsync,
+  createCompositeSink,
+  createConsoleSink,
+  createPresentationEvaluator,
+  createPublicError,
+  createResilioRootHandlers,
+  decodePublicError,
+  defineErrorCatalog,
+  defineErrorPolicy,
+  definePresentationPolicy,
+  err,
+  installResilioBrowserErrorBridge,
+  isErr,
+  isOk,
+  isPublicResult,
+  ok,
+  shouldSuppress,
+  stringHash,
+  toActionState,
+  useOptionalPresentError,
+  useOptionalReportError,
+  usePresentError,
+  useReportError,
+  useResilio,
+  useResilioAlert,
+  useResilioBrowserErrorBridge,
+  useResilioHandler,
+  useResilioInline,
+  useResilioRouteError,
+  useResilioState
+});
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client/index.ts","../src/action-state.ts","../src/client/useResilioState.ts","../src/client/useResilioRouteError.ts"],"sourcesContent":["'use client';\n\n// Re-export all React client components from @resiliojs/react\nexport {\n  ResilioProvider,\n  ResilioErrorBoundary,\n  ResilioPresentationHost,\n  ResilioPresentationProvider,\n  usePresentError,\n  useOptionalPresentError,\n  useResilioInline,\n  useResilioAlert,\n  createResilioRootHandlers,\n  capture,\n  captureAsync,\n  useResilioHandler,\n  installResilioBrowserErrorBridge,\n  useResilioBrowserErrorBridge,\n} from '@resiliojs/react';\nexport type {\n  ActivePresentation,\n  FeedbackAdapter,\n  PresentationRenderer,\n  PresentationRendererInput,\n  RendererRegistry,\n  ResilioContextValue,\n  ResilioErrorBoundaryProps,\n  ResilioErrorFallbackProps,\n  ResilioPresentationHostProps,\n  ResilioPresentationProviderProps,\n  ResilioProviderProps,\n} from '@resiliojs/react';\n\nexport { useResilio, useReportError } from '@resiliojs/react';\nexport { useOptionalReportError } from '@resiliojs/react';\n\n// Re-export client-safe utilities from core\nexport { \n  ok, \n  err, \n  isOk, \n  isErr, \n  isPublicResult,\n  defineErrorPolicy, \n  shouldSuppress,\n  defineErrorCatalog,\n  createPublicError,\n  decodePublicError,\n  createConsoleSink,\n  createCompositeSink,\n  PolicyEngine,\n  canonicalStringify,\n  stringHash,\n  BoundedDedupeStore,\n  definePresentationPolicy,\n  createPresentationEvaluator\n} from '@resiliojs/core';\n\nexport type { \n  Result, \n  PublicResult,\n  ResilioError, \n  ResilioErrorKind, \n  ErrorCatalog, \n  PublicError, \n  FeedbackType, \n  ErrorPolicyConfig,\n  ErrorDefinition,\n  ErrorCode,\n  PublicErrorFor,\n  PublicErrorArgs,\n  DecodeResult,\n  ErrorSource,\n  ErrorEvent,\n  ErrorSink,\n  PolicyEntry,\n  PolicyDecision,\n  DedupeContext,\n  DedupePolicy,\n  PolicyEngineOptions,\n  BuiltInChannel,\n  PresentationContext,\n  PresentationDecision,\n  PresentationPlan,\n  PresentationPlanInput,\n  PresentationRule,\n  PresentationPolicyConfig,\n  EvaluatedPresentationDecision,\n  PresentationInvalidReason,\n  PresentationEvaluationResult,\n  PresentationEvaluator,\n  PresentationEvaluatorOptions,\n  PresentationObservationEvent,\n  PresentationObserver\n} from '@resiliojs/core';\n\n// Re-export Next.js client helpers\nexport { toActionState } from '../action-state.js';\n// Export new useResilioState hook\nexport * from './useResilioState.js';\nexport * from './useResilioRouteError.js';\nexport * from '../types.js';\n","import { Result } from '@resiliojs/core';\n\n/**\n * React 19 useActionState 초기화 시그니처에 적합한 성공 상태(Result)의 액션 초기값을 생성합니다.\n */\nexport function toActionState<T, E = unknown>(\n  initialData: T | null = null\n): Result<T | null, E> {\n  return { ok: true, data: initialData };\n}\n","'use client';\n\nimport { useActionState } from 'react';\nimport { useOptionalPresentError, useOptionalReportError } from '@resiliojs/react';\nimport { decodePublicError } from '@resiliojs/core';\nimport type {\n  DecodeFailureReason,\n  ErrorCatalog,\n  PresentationContext,\n  PublicError,\n} from '@resiliojs/core';\nimport type { PublicActionResult } from '../types.js';\n\nexport interface UseResilioStateOptions<TData, TCatalog extends ErrorCatalog> {\n  catalog: TCatalog;\n  initialData?: TData | null;\n  onSuccess?: (data: TData) => void;\n  onError?: (error: PublicError<TCatalog>) => void;\n  onInvalidPublicError?: (reason: DecodeFailureReason) => void;\n  presentation?: Omit<PresentationContext, 'source'>;\n}\n\nexport type ResilioActionState<TData, TCatalog extends ErrorCatalog> =\n  PublicActionResult<TData | null, TCatalog>;\n\n/**\n * Next.js Server Action의 에러 핸들링과 UI 바인딩을 자동화하는 React 19 훅입니다.\n * React 19 useActionState와 동일한 시그니처를 제공하면서, 실패 상태(ok === false) 리턴 시\n * 전역 ResilioProvider에 자동으로 예상 오류를 전달하고 UI 정책을 평가합니다.\n */\nexport function useResilioState<Payload, TData, TCatalog extends ErrorCatalog>(\n  action: (\n    state: ResilioActionState<TData, TCatalog>,\n    payload: Payload,\n  ) => Promise<ResilioActionState<TData, TCatalog>>,\n  options: UseResilioStateOptions<TData, TCatalog>\n) {\n  const report = useOptionalReportError();\n  const present = useOptionalPresentError();\n\n  const initialState: ResilioActionState<TData, TCatalog> = {\n    ok: true,\n    data: options.initialData ?? null,\n  };\n\n  const [state, execute, isPending] = useActionState(async (\n    prevState: ResilioActionState<TData, TCatalog>,\n    payload: Payload,\n  ): Promise<ResilioActionState<TData, TCatalog>> => {\n    const res = await action(prevState, payload);\n    \n    if (res && typeof res === 'object' && 'ok' in res) {\n      if (!res.ok && res.error) {\n        const decoded = await decodePublicError(options.catalog, res.error);\n        if (!decoded.ok) {\n          report?.invalidPublic(decoded.reason, { source: 'next.action' });\n          options.onInvalidPublicError?.(decoded.reason);\n          return res;\n        }\n\n        report?.public(decoded.value, { source: 'next.action' });\n        await present?.(decoded.value, {\n          ...options.presentation,\n          source: 'next.action',\n        });\n        options.onError?.(decoded.value);\n      } else if (res.ok && res.data != null) {\n        options.onSuccess?.(res.data);\n      }\n    }\n    return res;\n  }, initialState);\n\n  return [state, execute, isPending] as const;\n}\n","'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { useOptionalReportError } from '@resiliojs/react';\n\nexport interface UseResilioRouteErrorOptions {\n  maxResets?: number;\n  resetWindowMs?: number;\n}\n\nexport interface ResilioRouteErrorState {\n  reset(): void;\n  resetBlocked: boolean;\n}\n\nexport function useResilioRouteError(\n  error: Error & { digest?: string },\n  reset: () => void,\n  options: UseResilioRouteErrorOptions = {},\n): ResilioRouteErrorState {\n  const report = useOptionalReportError();\n  const reported = useRef<Error | null>(null);\n  const resetTimestamps = useRef<number[]>([]);\n  const [resetBlocked, setResetBlocked] = useState(false);\n\n  useEffect(() => {\n    if (reported.current === error) return;\n    reported.current = error;\n    report?.exception(error, {\n      source: 'next.route',\n      correlationId: error.digest,\n      context: { digest: error.digest },\n    });\n  }, [error, report]);\n\n  const guardedReset = useCallback(() => {\n    const now = Date.now();\n    const windowMs = options.resetWindowMs ?? 1_000;\n    const maxResets = options.maxResets ?? 3;\n    resetTimestamps.current = resetTimestamps.current.filter(\n      (timestamp) => now - timestamp < windowMs,\n    );\n    if (resetTimestamps.current.length >= maxResets) {\n      setResetBlocked(true);\n      return;\n    }\n    resetTimestamps.current.push(now);\n    reset();\n  }, [options.maxResets, options.resetWindowMs, reset]);\n\n  return { reset: guardedReset, resetBlocked };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,IAAAA,gBAeO;AAeP,IAAAA,gBAA2C;AAC3C,IAAAA,gBAAuC;AAGvC,IAAAC,eAmBO;;;ACnDA,SAAS,cACd,cAAwB,MACH;AACrB,SAAO,EAAE,IAAI,MAAM,MAAM,YAAY;AACvC;;;ACPA,mBAA+B;AAC/B,IAAAC,gBAAgE;AAChE,kBAAkC;AA0B3B,SAAS,gBACd,QAIA,SACA;AACA,QAAM,aAAS,sCAAuB;AACtC,QAAM,cAAU,uCAAwB;AAExC,QAAM,eAAoD;AAAA,IACxD,IAAI;AAAA,IACJ,MAAM,QAAQ,eAAe;AAAA,EAC/B;AAEA,QAAM,CAAC,OAAO,SAAS,SAAS,QAAI,6BAAe,OACjD,WACA,YACiD;AACjD,UAAM,MAAM,MAAM,OAAO,WAAW,OAAO;AAE3C,QAAI,OAAO,OAAO,QAAQ,YAAY,QAAQ,KAAK;AACjD,UAAI,CAAC,IAAI,MAAM,IAAI,OAAO;AACxB,cAAM,UAAU,UAAM,+BAAkB,QAAQ,SAAS,IAAI,KAAK;AAClE,YAAI,CAAC,QAAQ,IAAI;AACf,kBAAQ,cAAc,QAAQ,QAAQ,EAAE,QAAQ,cAAc,CAAC;AAC/D,kBAAQ,uBAAuB,QAAQ,MAAM;AAC7C,iBAAO;AAAA,QACT;AAEA,gBAAQ,OAAO,QAAQ,OAAO,EAAE,QAAQ,cAAc,CAAC;AACvD,cAAM,UAAU,QAAQ,OAAO;AAAA,UAC7B,GAAG,QAAQ;AAAA,UACX,QAAQ;AAAA,QACV,CAAC;AACD,gBAAQ,UAAU,QAAQ,KAAK;AAAA,MACjC,WAAW,IAAI,MAAM,IAAI,QAAQ,MAAM;AACrC,gBAAQ,YAAY,IAAI,IAAI;AAAA,MAC9B;AAAA,IACF;AACA,WAAO;AAAA,EACT,GAAG,YAAY;AAEf,SAAO,CAAC,OAAO,SAAS,SAAS;AACnC;;;ACxEA,IAAAC,gBAAyD;AACzD,IAAAA,gBAAuC;AAYhC,SAAS,qBACd,OACA,OACA,UAAuC,CAAC,GAChB;AACxB,QAAM,aAAS,sCAAuB;AACtC,QAAM,eAAW,sBAAqB,IAAI;AAC1C,QAAM,sBAAkB,sBAAiB,CAAC,CAAC;AAC3C,QAAM,CAAC,cAAc,eAAe,QAAI,wBAAS,KAAK;AAEtD,+BAAU,MAAM;AACd,QAAI,SAAS,YAAY,MAAO;AAChC,aAAS,UAAU;AACnB,YAAQ,UAAU,OAAO;AAAA,MACvB,QAAQ;AAAA,MACR,eAAe,MAAM;AAAA,MACrB,SAAS,EAAE,QAAQ,MAAM,OAAO;AAAA,IAClC,CAAC;AAAA,EACH,GAAG,CAAC,OAAO,MAAM,CAAC;AAElB,QAAM,mBAAe,2BAAY,MAAM;AACrC,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,WAAW,QAAQ,iBAAiB;AAC1C,UAAM,YAAY,QAAQ,aAAa;AACvC,oBAAgB,UAAU,gBAAgB,QAAQ;AAAA,MAChD,CAAC,cAAc,MAAM,YAAY;AAAA,IACnC;AACA,QAAI,gBAAgB,QAAQ,UAAU,WAAW;AAC/C,sBAAgB,IAAI;AACpB;AAAA,IACF;AACA,oBAAgB,QAAQ,KAAK,GAAG;AAChC,UAAM;AAAA,EACR,GAAG,CAAC,QAAQ,WAAW,QAAQ,eAAe,KAAK,CAAC;AAEpD,SAAO,EAAE,OAAO,cAAc,aAAa;AAC7C;","names":["import_react","import_core","import_react","import_react"]}

package/dist/client.d.cts

@@ -0,0 +1,35 @@
+export { ActivePresentation, FeedbackAdapter, PresentationRenderer, PresentationRendererInput, RendererRegistry, ResilioContextValue, ResilioErrorBoundary, ResilioErrorBoundaryProps, ResilioErrorFallbackProps, ResilioPresentationHost, ResilioPresentationHostProps, ResilioPresentationProvider, ResilioPresentationProviderProps, ResilioProvider, ResilioProviderProps, capture, captureAsync, createResilioRootHandlers, installResilioBrowserErrorBridge, useOptionalPresentError, useOptionalReportError, usePresentError, useReportError, useResilio, useResilioAlert, useResilioBrowserErrorBridge, useResilioHandler, useResilioInline } from '@resiliojs/react';
+import { ErrorCatalog, PublicError, DecodeFailureReason, PresentationContext } from '@resiliojs/core';
+export { BoundedDedupeStore, BuiltInChannel, DecodeResult, DedupeContext, DedupePolicy, ErrorCatalog, ErrorCode, ErrorDefinition, ErrorEvent, ErrorPolicyConfig, ErrorSink, ErrorSource, EvaluatedPresentationDecision, FeedbackType, PolicyDecision, PolicyEngine, PolicyEngineOptions, PolicyEntry, PresentationContext, PresentationDecision, PresentationEvaluationResult, PresentationEvaluator, PresentationEvaluatorOptions, PresentationInvalidReason, PresentationObservationEvent, PresentationObserver, PresentationPlan, PresentationPlanInput, PresentationPolicyConfig, PresentationRule, PublicError, PublicErrorArgs, PublicErrorFor, PublicResult, ResilioError, ResilioErrorKind, Result, canonicalStringify, createCompositeSink, createConsoleSink, createPresentationEvaluator, createPublicError, decodePublicError, defineErrorCatalog, defineErrorPolicy, definePresentationPolicy, err, isErr, isOk, isPublicResult, ok, shouldSuppress, stringHash } from '@resiliojs/core';
+import { P as PublicActionResult } from './types-kEvjOn-F.cjs';
+export { t as toActionState } from './types-kEvjOn-F.cjs';
+
+interface UseResilioStateOptions<TData, TCatalog extends ErrorCatalog> {
+    catalog: TCatalog;
+    initialData?: TData | null;
+    onSuccess?: (data: TData) => void;
+    onError?: (error: PublicError<TCatalog>) => void;
+    onInvalidPublicError?: (reason: DecodeFailureReason) => void;
+    presentation?: Omit<PresentationContext, 'source'>;
+}
+type ResilioActionState<TData, TCatalog extends ErrorCatalog> = PublicActionResult<TData | null, TCatalog>;
+/**
+ * Next.js Server Action의 에러 핸들링과 UI 바인딩을 자동화하는 React 19 훅입니다.
+ * React 19 useActionState와 동일한 시그니처를 제공하면서, 실패 상태(ok === false) 리턴 시
+ * 전역 ResilioProvider에 자동으로 예상 오류를 전달하고 UI 정책을 평가합니다.
+ */
+declare function useResilioState<Payload, TData, TCatalog extends ErrorCatalog>(action: (state: ResilioActionState<TData, TCatalog>, payload: Payload) => Promise<ResilioActionState<TData, TCatalog>>, options: UseResilioStateOptions<TData, TCatalog>): readonly [ResilioActionState<TData, TCatalog>, (payload: Payload) => void, boolean];
+
+interface UseResilioRouteErrorOptions {
+    maxResets?: number;
+    resetWindowMs?: number;
+}
+interface ResilioRouteErrorState {
+    reset(): void;
+    resetBlocked: boolean;
+}
+declare function useResilioRouteError(error: Error & {
+    digest?: string;
+}, reset: () => void, options?: UseResilioRouteErrorOptions): ResilioRouteErrorState;
+
+export { PublicActionResult, type ResilioActionState, type ResilioRouteErrorState, type UseResilioRouteErrorOptions, type UseResilioStateOptions, useResilioRouteError, useResilioState };

package/dist/client.d.ts

@@ -0,0 +1,35 @@
+export { ActivePresentation, FeedbackAdapter, PresentationRenderer, PresentationRendererInput, RendererRegistry, ResilioContextValue, ResilioErrorBoundary, ResilioErrorBoundaryProps, ResilioErrorFallbackProps, ResilioPresentationHost, ResilioPresentationHostProps, ResilioPresentationProvider, ResilioPresentationProviderProps, ResilioProvider, ResilioProviderProps, capture, captureAsync, createResilioRootHandlers, installResilioBrowserErrorBridge, useOptionalPresentError, useOptionalReportError, usePresentError, useReportError, useResilio, useResilioAlert, useResilioBrowserErrorBridge, useResilioHandler, useResilioInline } from '@resiliojs/react';
+import { ErrorCatalog, PublicError, DecodeFailureReason, PresentationContext } from '@resiliojs/core';
+export { BoundedDedupeStore, BuiltInChannel, DecodeResult, DedupeContext, DedupePolicy, ErrorCatalog, ErrorCode, ErrorDefinition, ErrorEvent, ErrorPolicyConfig, ErrorSink, ErrorSource, EvaluatedPresentationDecision, FeedbackType, PolicyDecision, PolicyEngine, PolicyEngineOptions, PolicyEntry, PresentationContext, PresentationDecision, PresentationEvaluationResult, PresentationEvaluator, PresentationEvaluatorOptions, PresentationInvalidReason, PresentationObservationEvent, PresentationObserver, PresentationPlan, PresentationPlanInput, PresentationPolicyConfig, PresentationRule, PublicError, PublicErrorArgs, PublicErrorFor, PublicResult, ResilioError, ResilioErrorKind, Result, canonicalStringify, createCompositeSink, createConsoleSink, createPresentationEvaluator, createPublicError, decodePublicError, defineErrorCatalog, defineErrorPolicy, definePresentationPolicy, err, isErr, isOk, isPublicResult, ok, shouldSuppress, stringHash } from '@resiliojs/core';
+import { P as PublicActionResult } from './types-kEvjOn-F.js';
+export { t as toActionState } from './types-kEvjOn-F.js';
+
+interface UseResilioStateOptions<TData, TCatalog extends ErrorCatalog> {
+    catalog: TCatalog;
+    initialData?: TData | null;
+    onSuccess?: (data: TData) => void;
+    onError?: (error: PublicError<TCatalog>) => void;
+    onInvalidPublicError?: (reason: DecodeFailureReason) => void;
+    presentation?: Omit<PresentationContext, 'source'>;
+}
+type ResilioActionState<TData, TCatalog extends ErrorCatalog> = PublicActionResult<TData | null, TCatalog>;
+/**
+ * Next.js Server Action의 에러 핸들링과 UI 바인딩을 자동화하는 React 19 훅입니다.
+ * React 19 useActionState와 동일한 시그니처를 제공하면서, 실패 상태(ok === false) 리턴 시
+ * 전역 ResilioProvider에 자동으로 예상 오류를 전달하고 UI 정책을 평가합니다.
+ */
+declare function useResilioState<Payload, TData, TCatalog extends ErrorCatalog>(action: (state: ResilioActionState<TData, TCatalog>, payload: Payload) => Promise<ResilioActionState<TData, TCatalog>>, options: UseResilioStateOptions<TData, TCatalog>): readonly [ResilioActionState<TData, TCatalog>, (payload: Payload) => void, boolean];
+
+interface UseResilioRouteErrorOptions {
+    maxResets?: number;
+    resetWindowMs?: number;
+}
+interface ResilioRouteErrorState {
+    reset(): void;
+    resetBlocked: boolean;
+}
+declare function useResilioRouteError(error: Error & {
+    digest?: string;
+}, reset: () => void, options?: UseResilioRouteErrorOptions): ResilioRouteErrorState;
+
+export { PublicActionResult, type ResilioActionState, type ResilioRouteErrorState, type UseResilioRouteErrorOptions, type UseResilioStateOptions, useResilioRouteError, useResilioState };

package/dist/client.js

@@ -0,0 +1,157 @@
+"use client";
+
+// src/client/index.ts
+import {
+  ResilioProvider,
+  ResilioErrorBoundary,
+  ResilioPresentationHost,
+  ResilioPresentationProvider,
+  usePresentError,
+  useOptionalPresentError as useOptionalPresentError2,
+  useResilioInline,
+  useResilioAlert,
+  createResilioRootHandlers,
+  capture,
+  captureAsync,
+  useResilioHandler,
+  installResilioBrowserErrorBridge,
+  useResilioBrowserErrorBridge
+} from "@resiliojs/react";
+import { useResilio, useReportError } from "@resiliojs/react";
+import { useOptionalReportError as useOptionalReportError3 } from "@resiliojs/react";
+import {
+  ok,
+  err,
+  isOk,
+  isErr,
+  isPublicResult,
+  defineErrorPolicy,
+  shouldSuppress,
+  defineErrorCatalog,
+  createPublicError,
+  decodePublicError as decodePublicError2,
+  createConsoleSink,
+  createCompositeSink,
+  PolicyEngine,
+  canonicalStringify,
+  stringHash,
+  BoundedDedupeStore,
+  definePresentationPolicy,
+  createPresentationEvaluator
+} from "@resiliojs/core";
+
+// src/action-state.ts
+function toActionState(initialData = null) {
+  return { ok: true, data: initialData };
+}
+
+// src/client/useResilioState.ts
+import { useActionState } from "react";
+import { useOptionalPresentError, useOptionalReportError } from "@resiliojs/react";
+import { decodePublicError } from "@resiliojs/core";
+function useResilioState(action, options) {
+  const report = useOptionalReportError();
+  const present = useOptionalPresentError();
+  const initialState = {
+    ok: true,
+    data: options.initialData ?? null
+  };
+  const [state, execute, isPending] = useActionState(async (prevState, payload) => {
+    const res = await action(prevState, payload);
+    if (res && typeof res === "object" && "ok" in res) {
+      if (!res.ok && res.error) {
+        const decoded = await decodePublicError(options.catalog, res.error);
+        if (!decoded.ok) {
+          report?.invalidPublic(decoded.reason, { source: "next.action" });
+          options.onInvalidPublicError?.(decoded.reason);
+          return res;
+        }
+        report?.public(decoded.value, { source: "next.action" });
+        await present?.(decoded.value, {
+          ...options.presentation,
+          source: "next.action"
+        });
+        options.onError?.(decoded.value);
+      } else if (res.ok && res.data != null) {
+        options.onSuccess?.(res.data);
+      }
+    }
+    return res;
+  }, initialState);
+  return [state, execute, isPending];
+}
+
+// src/client/useResilioRouteError.ts
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useOptionalReportError as useOptionalReportError2 } from "@resiliojs/react";
+function useResilioRouteError(error, reset, options = {}) {
+  const report = useOptionalReportError2();
+  const reported = useRef(null);
+  const resetTimestamps = useRef([]);
+  const [resetBlocked, setResetBlocked] = useState(false);
+  useEffect(() => {
+    if (reported.current === error) return;
+    reported.current = error;
+    report?.exception(error, {
+      source: "next.route",
+      correlationId: error.digest,
+      context: { digest: error.digest }
+    });
+  }, [error, report]);
+  const guardedReset = useCallback(() => {
+    const now = Date.now();
+    const windowMs = options.resetWindowMs ?? 1e3;
+    const maxResets = options.maxResets ?? 3;
+    resetTimestamps.current = resetTimestamps.current.filter(
+      (timestamp) => now - timestamp < windowMs
+    );
+    if (resetTimestamps.current.length >= maxResets) {
+      setResetBlocked(true);
+      return;
+    }
+    resetTimestamps.current.push(now);
+    reset();
+  }, [options.maxResets, options.resetWindowMs, reset]);
+  return { reset: guardedReset, resetBlocked };
+}
+export {
+  BoundedDedupeStore,
+  PolicyEngine,
+  ResilioErrorBoundary,
+  ResilioPresentationHost,
+  ResilioPresentationProvider,
+  ResilioProvider,
+  canonicalStringify,
+  capture,
+  captureAsync,
+  createCompositeSink,
+  createConsoleSink,
+  createPresentationEvaluator,
+  createPublicError,
+  createResilioRootHandlers,
+  decodePublicError2 as decodePublicError,
+  defineErrorCatalog,
+  defineErrorPolicy,
+  definePresentationPolicy,
+  err,
+  installResilioBrowserErrorBridge,
+  isErr,
+  isOk,
+  isPublicResult,
+  ok,
+  shouldSuppress,
+  stringHash,
+  toActionState,
+  useOptionalPresentError2 as useOptionalPresentError,
+  useOptionalReportError3 as useOptionalReportError,
+  usePresentError,
+  useReportError,
+  useResilio,
+  useResilioAlert,
+  useResilioBrowserErrorBridge,
+  useResilioHandler,
+  useResilioInline,
+  useResilioRouteError,
+  useResilioState
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client/index.ts","../src/action-state.ts","../src/client/useResilioState.ts","../src/client/useResilioRouteError.ts"],"sourcesContent":["'use client';\n\n// Re-export all React client components from @resiliojs/react\nexport {\n  ResilioProvider,\n  ResilioErrorBoundary,\n  ResilioPresentationHost,\n  ResilioPresentationProvider,\n  usePresentError,\n  useOptionalPresentError,\n  useResilioInline,\n  useResilioAlert,\n  createResilioRootHandlers,\n  capture,\n  captureAsync,\n  useResilioHandler,\n  installResilioBrowserErrorBridge,\n  useResilioBrowserErrorBridge,\n} from '@resiliojs/react';\nexport type {\n  ActivePresentation,\n  FeedbackAdapter,\n  PresentationRenderer,\n  PresentationRendererInput,\n  RendererRegistry,\n  ResilioContextValue,\n  ResilioErrorBoundaryProps,\n  ResilioErrorFallbackProps,\n  ResilioPresentationHostProps,\n  ResilioPresentationProviderProps,\n  ResilioProviderProps,\n} from '@resiliojs/react';\n\nexport { useResilio, useReportError } from '@resiliojs/react';\nexport { useOptionalReportError } from '@resiliojs/react';\n\n// Re-export client-safe utilities from core\nexport { \n  ok, \n  err, \n  isOk, \n  isErr, \n  isPublicResult,\n  defineErrorPolicy, \n  shouldSuppress,\n  defineErrorCatalog,\n  createPublicError,\n  decodePublicError,\n  createConsoleSink,\n  createCompositeSink,\n  PolicyEngine,\n  canonicalStringify,\n  stringHash,\n  BoundedDedupeStore,\n  definePresentationPolicy,\n  createPresentationEvaluator\n} from '@resiliojs/core';\n\nexport type { \n  Result, \n  PublicResult,\n  ResilioError, \n  ResilioErrorKind, \n  ErrorCatalog, \n  PublicError, \n  FeedbackType, \n  ErrorPolicyConfig,\n  ErrorDefinition,\n  ErrorCode,\n  PublicErrorFor,\n  PublicErrorArgs,\n  DecodeResult,\n  ErrorSource,\n  ErrorEvent,\n  ErrorSink,\n  PolicyEntry,\n  PolicyDecision,\n  DedupeContext,\n  DedupePolicy,\n  PolicyEngineOptions,\n  BuiltInChannel,\n  PresentationContext,\n  PresentationDecision,\n  PresentationPlan,\n  PresentationPlanInput,\n  PresentationRule,\n  PresentationPolicyConfig,\n  EvaluatedPresentationDecision,\n  PresentationInvalidReason,\n  PresentationEvaluationResult,\n  PresentationEvaluator,\n  PresentationEvaluatorOptions,\n  PresentationObservationEvent,\n  PresentationObserver\n} from '@resiliojs/core';\n\n// Re-export Next.js client helpers\nexport { toActionState } from '../action-state.js';\n// Export new useResilioState hook\nexport * from './useResilioState.js';\nexport * from './useResilioRouteError.js';\nexport * from '../types.js';\n","import { Result } from '@resiliojs/core';\n\n/**\n * React 19 useActionState 초기화 시그니처에 적합한 성공 상태(Result)의 액션 초기값을 생성합니다.\n */\nexport function toActionState<T, E = unknown>(\n  initialData: T | null = null\n): Result<T | null, E> {\n  return { ok: true, data: initialData };\n}\n","'use client';\n\nimport { useActionState } from 'react';\nimport { useOptionalPresentError, useOptionalReportError } from '@resiliojs/react';\nimport { decodePublicError } from '@resiliojs/core';\nimport type {\n  DecodeFailureReason,\n  ErrorCatalog,\n  PresentationContext,\n  PublicError,\n} from '@resiliojs/core';\nimport type { PublicActionResult } from '../types.js';\n\nexport interface UseResilioStateOptions<TData, TCatalog extends ErrorCatalog> {\n  catalog: TCatalog;\n  initialData?: TData | null;\n  onSuccess?: (data: TData) => void;\n  onError?: (error: PublicError<TCatalog>) => void;\n  onInvalidPublicError?: (reason: DecodeFailureReason) => void;\n  presentation?: Omit<PresentationContext, 'source'>;\n}\n\nexport type ResilioActionState<TData, TCatalog extends ErrorCatalog> =\n  PublicActionResult<TData | null, TCatalog>;\n\n/**\n * Next.js Server Action의 에러 핸들링과 UI 바인딩을 자동화하는 React 19 훅입니다.\n * React 19 useActionState와 동일한 시그니처를 제공하면서, 실패 상태(ok === false) 리턴 시\n * 전역 ResilioProvider에 자동으로 예상 오류를 전달하고 UI 정책을 평가합니다.\n */\nexport function useResilioState<Payload, TData, TCatalog extends ErrorCatalog>(\n  action: (\n    state: ResilioActionState<TData, TCatalog>,\n    payload: Payload,\n  ) => Promise<ResilioActionState<TData, TCatalog>>,\n  options: UseResilioStateOptions<TData, TCatalog>\n) {\n  const report = useOptionalReportError();\n  const present = useOptionalPresentError();\n\n  const initialState: ResilioActionState<TData, TCatalog> = {\n    ok: true,\n    data: options.initialData ?? null,\n  };\n\n  const [state, execute, isPending] = useActionState(async (\n    prevState: ResilioActionState<TData, TCatalog>,\n    payload: Payload,\n  ): Promise<ResilioActionState<TData, TCatalog>> => {\n    const res = await action(prevState, payload);\n    \n    if (res && typeof res === 'object' && 'ok' in res) {\n      if (!res.ok && res.error) {\n        const decoded = await decodePublicError(options.catalog, res.error);\n        if (!decoded.ok) {\n          report?.invalidPublic(decoded.reason, { source: 'next.action' });\n          options.onInvalidPublicError?.(decoded.reason);\n          return res;\n        }\n\n        report?.public(decoded.value, { source: 'next.action' });\n        await present?.(decoded.value, {\n          ...options.presentation,\n          source: 'next.action',\n        });\n        options.onError?.(decoded.value);\n      } else if (res.ok && res.data != null) {\n        options.onSuccess?.(res.data);\n      }\n    }\n    return res;\n  }, initialState);\n\n  return [state, execute, isPending] as const;\n}\n","'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { useOptionalReportError } from '@resiliojs/react';\n\nexport interface UseResilioRouteErrorOptions {\n  maxResets?: number;\n  resetWindowMs?: number;\n}\n\nexport interface ResilioRouteErrorState {\n  reset(): void;\n  resetBlocked: boolean;\n}\n\nexport function useResilioRouteError(\n  error: Error & { digest?: string },\n  reset: () => void,\n  options: UseResilioRouteErrorOptions = {},\n): ResilioRouteErrorState {\n  const report = useOptionalReportError();\n  const reported = useRef<Error | null>(null);\n  const resetTimestamps = useRef<number[]>([]);\n  const [resetBlocked, setResetBlocked] = useState(false);\n\n  useEffect(() => {\n    if (reported.current === error) return;\n    reported.current = error;\n    report?.exception(error, {\n      source: 'next.route',\n      correlationId: error.digest,\n      context: { digest: error.digest },\n    });\n  }, [error, report]);\n\n  const guardedReset = useCallback(() => {\n    const now = Date.now();\n    const windowMs = options.resetWindowMs ?? 1_000;\n    const maxResets = options.maxResets ?? 3;\n    resetTimestamps.current = resetTimestamps.current.filter(\n      (timestamp) => now - timestamp < windowMs,\n    );\n    if (resetTimestamps.current.length >= maxResets) {\n      setResetBlocked(true);\n      return;\n    }\n    resetTimestamps.current.push(now);\n    reset();\n  }, [options.maxResets, options.resetWindowMs, reset]);\n\n  return { reset: guardedReset, resetBlocked };\n}\n"],"mappings":";;;AAGA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,2BAAAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAeP,SAAS,YAAY,sBAAsB;AAC3C,SAAS,0BAAAC,+BAA8B;AAGvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,qBAAAC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;;;ACnDA,SAAS,cACd,cAAwB,MACH;AACrB,SAAO,EAAE,IAAI,MAAM,MAAM,YAAY;AACvC;;;ACPA,SAAS,sBAAsB;AAC/B,SAAS,yBAAyB,8BAA8B;AAChE,SAAS,yBAAyB;AA0B3B,SAAS,gBACd,QAIA,SACA;AACA,QAAM,SAAS,uBAAuB;AACtC,QAAM,UAAU,wBAAwB;AAExC,QAAM,eAAoD;AAAA,IACxD,IAAI;AAAA,IACJ,MAAM,QAAQ,eAAe;AAAA,EAC/B;AAEA,QAAM,CAAC,OAAO,SAAS,SAAS,IAAI,eAAe,OACjD,WACA,YACiD;AACjD,UAAM,MAAM,MAAM,OAAO,WAAW,OAAO;AAE3C,QAAI,OAAO,OAAO,QAAQ,YAAY,QAAQ,KAAK;AACjD,UAAI,CAAC,IAAI,MAAM,IAAI,OAAO;AACxB,cAAM,UAAU,MAAM,kBAAkB,QAAQ,SAAS,IAAI,KAAK;AAClE,YAAI,CAAC,QAAQ,IAAI;AACf,kBAAQ,cAAc,QAAQ,QAAQ,EAAE,QAAQ,cAAc,CAAC;AAC/D,kBAAQ,uBAAuB,QAAQ,MAAM;AAC7C,iBAAO;AAAA,QACT;AAEA,gBAAQ,OAAO,QAAQ,OAAO,EAAE,QAAQ,cAAc,CAAC;AACvD,cAAM,UAAU,QAAQ,OAAO;AAAA,UAC7B,GAAG,QAAQ;AAAA,UACX,QAAQ;AAAA,QACV,CAAC;AACD,gBAAQ,UAAU,QAAQ,KAAK;AAAA,MACjC,WAAW,IAAI,MAAM,IAAI,QAAQ,MAAM;AACrC,gBAAQ,YAAY,IAAI,IAAI;AAAA,MAC9B;AAAA,IACF;AACA,WAAO;AAAA,EACT,GAAG,YAAY;AAEf,SAAO,CAAC,OAAO,SAAS,SAAS;AACnC;;;ACxEA,SAAS,aAAa,WAAW,QAAQ,gBAAgB;AACzD,SAAS,0BAAAC,+BAA8B;AAYhC,SAAS,qBACd,OACA,OACA,UAAuC,CAAC,GAChB;AACxB,QAAM,SAASA,wBAAuB;AACtC,QAAM,WAAW,OAAqB,IAAI;AAC1C,QAAM,kBAAkB,OAAiB,CAAC,CAAC;AAC3C,QAAM,CAAC,cAAc,eAAe,IAAI,SAAS,KAAK;AAEtD,YAAU,MAAM;AACd,QAAI,SAAS,YAAY,MAAO;AAChC,aAAS,UAAU;AACnB,YAAQ,UAAU,OAAO;AAAA,MACvB,QAAQ;AAAA,MACR,eAAe,MAAM;AAAA,MACrB,SAAS,EAAE,QAAQ,MAAM,OAAO;AAAA,IAClC,CAAC;AAAA,EACH,GAAG,CAAC,OAAO,MAAM,CAAC;AAElB,QAAM,eAAe,YAAY,MAAM;AACrC,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,WAAW,QAAQ,iBAAiB;AAC1C,UAAM,YAAY,QAAQ,aAAa;AACvC,oBAAgB,UAAU,gBAAgB,QAAQ;AAAA,MAChD,CAAC,cAAc,MAAM,YAAY;AAAA,IACnC;AACA,QAAI,gBAAgB,QAAQ,UAAU,WAAW;AAC/C,sBAAgB,IAAI;AACpB;AAAA,IACF;AACA,oBAAgB,QAAQ,KAAK,GAAG;AAChC,UAAM;AAAA,EACR,GAAG,CAAC,QAAQ,WAAW,QAAQ,eAAe,KAAK,CAAC;AAEpD,SAAO,EAAE,OAAO,cAAc,aAAa;AAC7C;","names":["useOptionalPresentError","useOptionalReportError","decodePublicError","useOptionalReportError"]}

package/dist/index.cjs

@@ -0,0 +1,167 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  BoundedDedupeStore: () => import_core4.BoundedDedupeStore,
+  PolicyEngine: () => import_core4.PolicyEngine,
+  ResilioEmitter: () => import_core5.ResilioEmitter,
+  ResilioLogger: () => import_core5.ResilioLogger,
+  canonicalStringify: () => import_core4.canonicalStringify,
+  createCompositeSink: () => import_core4.createCompositeSink,
+  createConsoleSink: () => import_core4.createConsoleSink,
+  createPresentationEvaluator: () => import_core4.createPresentationEvaluator,
+  createPublicError: () => import_core4.createPublicError,
+  createResilioAction: () => createResilioAction,
+  createResilioOnRequestError: () => createResilioOnRequestError,
+  decodePublicError: () => import_core4.decodePublicError,
+  defaultConsoleLogger: () => import_core5.defaultConsoleLogger,
+  defineErrorCatalog: () => import_core4.defineErrorCatalog,
+  defineErrorPolicy: () => import_core4.defineErrorPolicy,
+  definePresentationPolicy: () => import_core4.definePresentationPolicy,
+  err: () => import_core4.err,
+  globalResilioEmitter: () => import_core5.globalResilioEmitter,
+  isErr: () => import_core4.isErr,
+  isOk: () => import_core4.isOk,
+  isPublicResult: () => import_core4.isPublicResult,
+  isRetryableError: () => import_core4.isRetryableError,
+  isSuccessfulResilioAction: () => isSuccessfulResilioAction,
+  normalizeError: () => import_core4.normalizeError,
+  ok: () => import_core4.ok,
+  reportRouteError: () => reportRouteError,
+  resilioLogger: () => import_core5.resilioLogger,
+  sanitizeErrorForClient: () => sanitizeErrorForClient,
+  serializeError: () => import_core4.serializeError,
+  shouldSuppress: () => import_core4.shouldSuppress,
+  stringHash: () => import_core4.stringHash,
+  toActionState: () => toActionState,
+  withRetry: () => import_core4.withRetry
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/action.ts
+function createResilioAction(handler) {
+  return handler;
+}
+function isSuccessfulResilioAction(result) {
+  return result.ok === true;
+}
+
+// src/action-state.ts
+function toActionState(initialData = null) {
+  return { ok: true, data: initialData };
+}
+
+// src/serializer.ts
+var import_core = require("@resiliojs/core");
+function sanitizeErrorForClient(error) {
+  if (error.kind === "server" || error.kind === "unknown") {
+    throw new Error("Unexpected server errors must be thrown and handled by the Next.js error boundary.");
+  }
+  return (0, import_core.serializeError)(error);
+}
+
+// src/route-error.ts
+var import_core2 = require("@resiliojs/core");
+var import_core3 = require("@resiliojs/core");
+function createResilioOnRequestError(sink) {
+  return async (error, request, context) => {
+    const safePath = request.path ? request.path.split("?")[0] : "";
+    const digest = getErrorDigest(error);
+    const occurrenceId = Math.random().toString(36).substring(2, 15);
+    const timestamp = Date.now();
+    await (0, import_core2.reportToSinkBestEffort)(sink, {
+      occurrenceId,
+      timestamp,
+      source: "next.request",
+      kind: "exception",
+      error,
+      correlationId: digest,
+      context: {
+        path: safePath,
+        method: request.method,
+        routerKind: context.routerKind,
+        routePath: context.routePath,
+        routeType: context.routeType,
+        renderSource: context.renderSource,
+        revalidateReason: context.revalidateReason,
+        digest
+      }
+    });
+  };
+}
+function getErrorDigest(error) {
+  if (!error || typeof error !== "object" || !("digest" in error)) {
+    return void 0;
+  }
+  return typeof error.digest === "string" ? error.digest : void 0;
+}
+function reportRouteError(error, options = {}) {
+  const normalized = (0, import_core3.normalizeError)(error, {
+    defaultKind: "server",
+    defaultPresentation: "boundary"
+  });
+  if (options.digest) {
+    normalized.code = options.digest;
+  }
+  import_core3.globalResilioEmitter.emit(normalized);
+  return normalized;
+}
+
+// src/index.ts
+var import_core4 = require("@resiliojs/core");
+var import_core5 = require("@resiliojs/core");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BoundedDedupeStore,
+  PolicyEngine,
+  ResilioEmitter,
+  ResilioLogger,
+  canonicalStringify,
+  createCompositeSink,
+  createConsoleSink,
+  createPresentationEvaluator,
+  createPublicError,
+  createResilioAction,
+  createResilioOnRequestError,
+  decodePublicError,
+  defaultConsoleLogger,
+  defineErrorCatalog,
+  defineErrorPolicy,
+  definePresentationPolicy,
+  err,
+  globalResilioEmitter,
+  isErr,
+  isOk,
+  isPublicResult,
+  isRetryableError,
+  isSuccessfulResilioAction,
+  normalizeError,
+  ok,
+  reportRouteError,
+  resilioLogger,
+  sanitizeErrorForClient,
+  serializeError,
+  shouldSuppress,
+  stringHash,
+  toActionState,
+  withRetry
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/action.ts","../src/action-state.ts","../src/serializer.ts","../src/route-error.ts"],"sourcesContent":["// Server-safe exports (safe to import in Server Components & Server Actions)\nexport * from './action.js';\nexport * from './action-state.js';\nexport * from './serializer.js';\nexport * from './route-error.js';\nexport * from './types.js';\n\n// Re-export core types and utilities for single-package DX\nexport { \n  ok, \n  err, \n  isOk, \n  isErr, \n  isPublicResult,\n  normalizeError, \n  serializeError, \n  isRetryableError, \n  withRetry,\n  defineErrorPolicy,\n  shouldSuppress,\n  defineErrorCatalog,\n  createPublicError,\n  decodePublicError,\n  createConsoleSink,\n  createCompositeSink,\n  PolicyEngine,\n  canonicalStringify,\n  stringHash,\n  BoundedDedupeStore,\n  definePresentationPolicy,\n  createPresentationEvaluator\n} from '@resiliojs/core';\n\nexport type { \n  Result, \n  PublicResult,\n  ResilioError, \n  ResilioErrorKind, \n  RetryPolicy, \n  NormalizeOptions, \n  LoggerAdapter,\n  ErrorCatalog,\n  PublicError,\n  FeedbackType,\n  ErrorPolicyConfig,\n  ErrorDefinition,\n  ErrorCode,\n  PublicErrorFor,\n  PublicErrorArgs,\n  DecodeResult,\n  ErrorSource,\n  ErrorEvent,\n  ErrorSink,\n  PolicyEntry,\n  PolicyDecision,\n  DedupeContext,\n  DedupePolicy,\n  PolicyEngineOptions,\n  BuiltInChannel,\n  PresentationContext,\n  PresentationDecision,\n  PresentationPlan,\n  PresentationPlanInput,\n  PresentationRule,\n  PresentationPolicyConfig,\n  EvaluatedPresentationDecision,\n  PresentationInvalidReason,\n  PresentationEvaluationResult,\n  PresentationEvaluator,\n  PresentationEvaluatorOptions,\n  PresentationObservationEvent,\n  PresentationObserver\n} from '@resiliojs/core';\n\nexport { ResilioEmitter, globalResilioEmitter, ResilioLogger, resilioLogger, defaultConsoleLogger } from '@resiliojs/core';\n","import type { ErrorCatalog, ErrorCode } from '@resiliojs/core';\nimport type { PublicActionResult } from './types.js';\n\n/**\n * @deprecated Server Action 전체를 감싸는 래핑 방식은 권장되지 않습니다.\n * 대신 개별 Action에서 직접 `PublicActionResult`를 반환하십시오.\n * 이 호환 helper는 예외를 가로채지 않으며 unexpected exception과 Next.js 제어 흐름을 그대로 전파합니다.\n */\nexport function createResilioAction<\n  TData,\n  TCatalog extends ErrorCatalog,\n  TCodes extends ErrorCode<TCatalog> = ErrorCode<TCatalog>,\n  TArgs extends unknown[] = unknown[],\n>(\n  handler: (...args: TArgs) => Promise<PublicActionResult<TData, TCatalog, TCodes>>,\n): (...args: TArgs) => Promise<PublicActionResult<TData, TCatalog, TCodes>> {\n  return handler;\n}\n\n/**\n * 이미 decode된 Server Action 결과가 성공인지 타입 안전하게 확인합니다.\n */\nexport function isSuccessfulResilioAction<\n  TData,\n  TCatalog extends ErrorCatalog,\n  TCodes extends ErrorCode<TCatalog> = ErrorCode<TCatalog>,\n>(\n  result: PublicActionResult<TData, TCatalog, TCodes>\n): result is { ok: true; data: TData } {\n  return result.ok === true;\n}\n","import { Result } from '@resiliojs/core';\n\n/**\n * React 19 useActionState 초기화 시그니처에 적합한 성공 상태(Result)의 액션 초기값을 생성합니다.\n */\nexport function toActionState<T, E = unknown>(\n  initialData: T | null = null\n): Result<T | null, E> {\n  return { ok: true, data: initialData };\n}\n","import { ResilioError, serializeError } from '@resiliojs/core';\n\nexport function sanitizeErrorForClient(\n  error: ResilioError,\n): ResilioError {\n  if (error.kind === 'server' || error.kind === 'unknown') {\n    throw new Error('Unexpected server errors must be thrown and handled by the Next.js error boundary.');\n  }\n  return serializeError(error);\n}\n","import type { Instrumentation } from 'next';\nimport type { ErrorCatalog, ErrorSink } from '@resiliojs/core';\nimport { reportToSinkBestEffort } from '@resiliojs/core';\n\n/**\n * Next.js 15+ instrumentation.ts의 onRequestError 규격에 맞는 오류 관측성 핸들러를 생성합니다.\n * request headers와 query string은 보안을 위해 기본적으로 전달하지 않습니다.\n */\nexport function createResilioOnRequestError<T extends ErrorCatalog>(\n  sink: ErrorSink<T>\n): Instrumentation.onRequestError {\n  return async (error, request, context) => {\n    const safePath = request.path ? request.path.split('?')[0] : '';\n    const digest = getErrorDigest(error);\n    const occurrenceId = Math.random().toString(36).substring(2, 15);\n    const timestamp = Date.now();\n\n    await reportToSinkBestEffort(sink, {\n      occurrenceId,\n      timestamp,\n      source: 'next.request',\n      kind: 'exception',\n      error,\n      correlationId: digest,\n      context: {\n        path: safePath,\n        method: request.method,\n        routerKind: context.routerKind,\n        routePath: context.routePath,\n        routeType: context.routeType,\n        renderSource: context.renderSource,\n        revalidateReason: context.revalidateReason,\n        digest,\n      },\n    });\n  };\n}\n\nfunction getErrorDigest(error: unknown): string | undefined {\n  if (!error || typeof error !== 'object' || !('digest' in error)) {\n    return undefined;\n  }\n  return typeof error.digest === 'string' ? error.digest : undefined;\n}\n\n// 기존 하위 호환을 위한 레거시 헬퍼\nimport { normalizeError, globalResilioEmitter, ResilioError } from '@resiliojs/core';\n\nexport interface RouteErrorOptions {\n  digest?: string;\n}\n\n/**\n * @deprecated Use createResilioOnRequestError instead.\n */\nexport function reportRouteError(\n  error: unknown,\n  options: RouteErrorOptions = {}\n): ResilioError {\n  const normalized = normalizeError(error, {\n    defaultKind: 'server',\n    defaultPresentation: 'boundary',\n  });\n\n  if (options.digest) {\n    normalized.code = options.digest;\n  }\n\n  globalResilioEmitter.emit(normalized);\n\n  return normalized;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACQO,SAAS,oBAMd,SAC0E;AAC1E,SAAO;AACT;AAKO,SAAS,0BAKd,QACqC;AACrC,SAAO,OAAO,OAAO;AACvB;;;ACzBO,SAAS,cACd,cAAwB,MACH;AACrB,SAAO,EAAE,IAAI,MAAM,MAAM,YAAY;AACvC;;;ACTA,kBAA6C;AAEtC,SAAS,uBACd,OACc;AACd,MAAI,MAAM,SAAS,YAAY,MAAM,SAAS,WAAW;AACvD,UAAM,IAAI,MAAM,oFAAoF;AAAA,EACtG;AACA,aAAO,4BAAe,KAAK;AAC7B;;;ACPA,IAAAA,eAAuC;AA4CvC,IAAAA,eAAmE;AAtC5D,SAAS,4BACd,MACgC;AAChC,SAAO,OAAO,OAAO,SAAS,YAAY;AACxC,UAAM,WAAW,QAAQ,OAAO,QAAQ,KAAK,MAAM,GAAG,EAAE,CAAC,IAAI;AAC7D,UAAM,SAAS,eAAe,KAAK;AACnC,UAAM,eAAe,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,UAAU,GAAG,EAAE;AAC/D,UAAM,YAAY,KAAK,IAAI;AAE3B,cAAM,qCAAuB,MAAM;AAAA,MACjC;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,MACR,MAAM;AAAA,MACN;AAAA,MACA,eAAe;AAAA,MACf,SAAS;AAAA,QACP,MAAM;AAAA,QACN,QAAQ,QAAQ;AAAA,QAChB,YAAY,QAAQ;AAAA,QACpB,WAAW,QAAQ;AAAA,QACnB,WAAW,QAAQ;AAAA,QACnB,cAAc,QAAQ;AAAA,QACtB,kBAAkB,QAAQ;AAAA,QAC1B;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAEA,SAAS,eAAe,OAAoC;AAC1D,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,EAAE,YAAY,QAAQ;AAC/D,WAAO;AAAA,EACT;AACA,SAAO,OAAO,MAAM,WAAW,WAAW,MAAM,SAAS;AAC3D;AAYO,SAAS,iBACd,OACA,UAA6B,CAAC,GAChB;AACd,QAAM,iBAAa,6BAAe,OAAO;AAAA,IACvC,aAAa;AAAA,IACb,qBAAqB;AAAA,EACvB,CAAC;AAED,MAAI,QAAQ,QAAQ;AAClB,eAAW,OAAO,QAAQ;AAAA,EAC5B;AAEA,oCAAqB,KAAK,UAAU;AAEpC,SAAO;AACT;;;AJ/DA,IAAAC,eAuBO;AA2CP,IAAAA,eAAyG;","names":["import_core","import_core"]}

package/dist/index.d.cts

@@ -0,0 +1,37 @@
+import { ErrorCatalog, ErrorCode, ResilioError, ErrorSink } from '@resiliojs/core';
+export { BoundedDedupeStore, BuiltInChannel, DecodeResult, DedupeContext, DedupePolicy, ErrorCatalog, ErrorCode, ErrorDefinition, ErrorEvent, ErrorPolicyConfig, ErrorSink, ErrorSource, EvaluatedPresentationDecision, FeedbackType, LoggerAdapter, NormalizeOptions, PolicyDecision, PolicyEngine, PolicyEngineOptions, PolicyEntry, PresentationContext, PresentationDecision, PresentationEvaluationResult, PresentationEvaluator, PresentationEvaluatorOptions, PresentationInvalidReason, PresentationObservationEvent, PresentationObserver, PresentationPlan, PresentationPlanInput, PresentationPolicyConfig, PresentationRule, PublicError, PublicErrorArgs, PublicErrorFor, PublicResult, ResilioEmitter, ResilioError, ResilioErrorKind, ResilioLogger, Result, RetryPolicy, canonicalStringify, createCompositeSink, createConsoleSink, createPresentationEvaluator, createPublicError, decodePublicError, defaultConsoleLogger, defineErrorCatalog, defineErrorPolicy, definePresentationPolicy, err, globalResilioEmitter, isErr, isOk, isPublicResult, isRetryableError, normalizeError, ok, resilioLogger, serializeError, shouldSuppress, stringHash, withRetry } from '@resiliojs/core';
+import { P as PublicActionResult } from './types-kEvjOn-F.cjs';
+export { t as toActionState } from './types-kEvjOn-F.cjs';
+import { Instrumentation } from 'next';
+
+/**
+ * @deprecated Server Action 전체를 감싸는 래핑 방식은 권장되지 않습니다.
+ * 대신 개별 Action에서 직접 `PublicActionResult`를 반환하십시오.
+ * 이 호환 helper는 예외를 가로채지 않으며 unexpected exception과 Next.js 제어 흐름을 그대로 전파합니다.
+ */
+declare function createResilioAction<TData, TCatalog extends ErrorCatalog, TCodes extends ErrorCode<TCatalog> = ErrorCode<TCatalog>, TArgs extends unknown[] = unknown[]>(handler: (...args: TArgs) => Promise<PublicActionResult<TData, TCatalog, TCodes>>): (...args: TArgs) => Promise<PublicActionResult<TData, TCatalog, TCodes>>;
+/**
+ * 이미 decode된 Server Action 결과가 성공인지 타입 안전하게 확인합니다.
+ */
+declare function isSuccessfulResilioAction<TData, TCatalog extends ErrorCatalog, TCodes extends ErrorCode<TCatalog> = ErrorCode<TCatalog>>(result: PublicActionResult<TData, TCatalog, TCodes>): result is {
+    ok: true;
+    data: TData;
+};
+
+declare function sanitizeErrorForClient(error: ResilioError): ResilioError;
+
+/**
+ * Next.js 15+ instrumentation.ts의 onRequestError 규격에 맞는 오류 관측성 핸들러를 생성합니다.
+ * request headers와 query string은 보안을 위해 기본적으로 전달하지 않습니다.
+ */
+declare function createResilioOnRequestError<T extends ErrorCatalog>(sink: ErrorSink<T>): Instrumentation.onRequestError;
+
+interface RouteErrorOptions {
+    digest?: string;
+}
+/**
+ * @deprecated Use createResilioOnRequestError instead.
+ */
+declare function reportRouteError(error: unknown, options?: RouteErrorOptions): ResilioError;
+
+export { PublicActionResult, type RouteErrorOptions, createResilioAction, createResilioOnRequestError, isSuccessfulResilioAction, reportRouteError, sanitizeErrorForClient };

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { ErrorCatalog, ErrorCode, ResilioError, ErrorSink } from '@resiliojs/core';
+export { BoundedDedupeStore, BuiltInChannel, DecodeResult, DedupeContext, DedupePolicy, ErrorCatalog, ErrorCode, ErrorDefinition, ErrorEvent, ErrorPolicyConfig, ErrorSink, ErrorSource, EvaluatedPresentationDecision, FeedbackType, LoggerAdapter, NormalizeOptions, PolicyDecision, PolicyEngine, PolicyEngineOptions, PolicyEntry, PresentationContext, PresentationDecision, PresentationEvaluationResult, PresentationEvaluator, PresentationEvaluatorOptions, PresentationInvalidReason, PresentationObservationEvent, PresentationObserver, PresentationPlan, PresentationPlanInput, PresentationPolicyConfig, PresentationRule, PublicError, PublicErrorArgs, PublicErrorFor, PublicResult, ResilioEmitter, ResilioError, ResilioErrorKind, ResilioLogger, Result, RetryPolicy, canonicalStringify, createCompositeSink, createConsoleSink, createPresentationEvaluator, createPublicError, decodePublicError, defaultConsoleLogger, defineErrorCatalog, defineErrorPolicy, definePresentationPolicy, err, globalResilioEmitter, isErr, isOk, isPublicResult, isRetryableError, normalizeError, ok, resilioLogger, serializeError, shouldSuppress, stringHash, withRetry } from '@resiliojs/core';
+import { P as PublicActionResult } from './types-kEvjOn-F.js';
+export { t as toActionState } from './types-kEvjOn-F.js';
+import { Instrumentation } from 'next';
+
+/**
+ * @deprecated Server Action 전체를 감싸는 래핑 방식은 권장되지 않습니다.
+ * 대신 개별 Action에서 직접 `PublicActionResult`를 반환하십시오.
+ * 이 호환 helper는 예외를 가로채지 않으며 unexpected exception과 Next.js 제어 흐름을 그대로 전파합니다.
+ */
+declare function createResilioAction<TData, TCatalog extends ErrorCatalog, TCodes extends ErrorCode<TCatalog> = ErrorCode<TCatalog>, TArgs extends unknown[] = unknown[]>(handler: (...args: TArgs) => Promise<PublicActionResult<TData, TCatalog, TCodes>>): (...args: TArgs) => Promise<PublicActionResult<TData, TCatalog, TCodes>>;
+/**
+ * 이미 decode된 Server Action 결과가 성공인지 타입 안전하게 확인합니다.
+ */
+declare function isSuccessfulResilioAction<TData, TCatalog extends ErrorCatalog, TCodes extends ErrorCode<TCatalog> = ErrorCode<TCatalog>>(result: PublicActionResult<TData, TCatalog, TCodes>): result is {
+    ok: true;
+    data: TData;
+};
+
+declare function sanitizeErrorForClient(error: ResilioError): ResilioError;
+
+/**
+ * Next.js 15+ instrumentation.ts의 onRequestError 규격에 맞는 오류 관측성 핸들러를 생성합니다.
+ * request headers와 query string은 보안을 위해 기본적으로 전달하지 않습니다.
+ */
+declare function createResilioOnRequestError<T extends ErrorCatalog>(sink: ErrorSink<T>): Instrumentation.onRequestError;
+
+interface RouteErrorOptions {
+    digest?: string;
+}
+/**
+ * @deprecated Use createResilioOnRequestError instead.
+ */
+declare function reportRouteError(error: unknown, options?: RouteErrorOptions): ResilioError;
+
+export { PublicActionResult, type RouteErrorOptions, createResilioAction, createResilioOnRequestError, isSuccessfulResilioAction, reportRouteError, sanitizeErrorForClient };

package/dist/index.js

@@ -0,0 +1,131 @@
+// src/action.ts
+function createResilioAction(handler) {
+  return handler;
+}
+function isSuccessfulResilioAction(result) {
+  return result.ok === true;
+}
+
+// src/action-state.ts
+function toActionState(initialData = null) {
+  return { ok: true, data: initialData };
+}
+
+// src/serializer.ts
+import { serializeError } from "@resiliojs/core";
+function sanitizeErrorForClient(error) {
+  if (error.kind === "server" || error.kind === "unknown") {
+    throw new Error("Unexpected server errors must be thrown and handled by the Next.js error boundary.");
+  }
+  return serializeError(error);
+}
+
+// src/route-error.ts
+import { reportToSinkBestEffort } from "@resiliojs/core";
+import { normalizeError, globalResilioEmitter } from "@resiliojs/core";
+function createResilioOnRequestError(sink) {
+  return async (error, request, context) => {
+    const safePath = request.path ? request.path.split("?")[0] : "";
+    const digest = getErrorDigest(error);
+    const occurrenceId = Math.random().toString(36).substring(2, 15);
+    const timestamp = Date.now();
+    await reportToSinkBestEffort(sink, {
+      occurrenceId,
+      timestamp,
+      source: "next.request",
+      kind: "exception",
+      error,
+      correlationId: digest,
+      context: {
+        path: safePath,
+        method: request.method,
+        routerKind: context.routerKind,
+        routePath: context.routePath,
+        routeType: context.routeType,
+        renderSource: context.renderSource,
+        revalidateReason: context.revalidateReason,
+        digest
+      }
+    });
+  };
+}
+function getErrorDigest(error) {
+  if (!error || typeof error !== "object" || !("digest" in error)) {
+    return void 0;
+  }
+  return typeof error.digest === "string" ? error.digest : void 0;
+}
+function reportRouteError(error, options = {}) {
+  const normalized = normalizeError(error, {
+    defaultKind: "server",
+    defaultPresentation: "boundary"
+  });
+  if (options.digest) {
+    normalized.code = options.digest;
+  }
+  globalResilioEmitter.emit(normalized);
+  return normalized;
+}
+
+// src/index.ts
+import {
+  ok,
+  err,
+  isOk,
+  isErr,
+  isPublicResult,
+  normalizeError as normalizeError2,
+  serializeError as serializeError2,
+  isRetryableError,
+  withRetry,
+  defineErrorPolicy,
+  shouldSuppress,
+  defineErrorCatalog,
+  createPublicError,
+  decodePublicError,
+  createConsoleSink,
+  createCompositeSink,
+  PolicyEngine,
+  canonicalStringify,
+  stringHash,
+  BoundedDedupeStore,
+  definePresentationPolicy,
+  createPresentationEvaluator
+} from "@resiliojs/core";
+import { ResilioEmitter, globalResilioEmitter as globalResilioEmitter2, ResilioLogger, resilioLogger, defaultConsoleLogger } from "@resiliojs/core";
+export {
+  BoundedDedupeStore,
+  PolicyEngine,
+  ResilioEmitter,
+  ResilioLogger,
+  canonicalStringify,
+  createCompositeSink,
+  createConsoleSink,
+  createPresentationEvaluator,
+  createPublicError,
+  createResilioAction,
+  createResilioOnRequestError,
+  decodePublicError,
+  defaultConsoleLogger,
+  defineErrorCatalog,
+  defineErrorPolicy,
+  definePresentationPolicy,
+  err,
+  globalResilioEmitter2 as globalResilioEmitter,
+  isErr,
+  isOk,
+  isPublicResult,
+  isRetryableError,
+  isSuccessfulResilioAction,
+  normalizeError2 as normalizeError,
+  ok,
+  reportRouteError,
+  resilioLogger,
+  sanitizeErrorForClient,
+  serializeError2 as serializeError,
+  shouldSuppress,
+  stringHash,
+  toActionState,
+  withRetry
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/action.ts","../src/action-state.ts","../src/serializer.ts","../src/route-error.ts","../src/index.ts"],"sourcesContent":["import type { ErrorCatalog, ErrorCode } from '@resiliojs/core';\nimport type { PublicActionResult } from './types.js';\n\n/**\n * @deprecated Server Action 전체를 감싸는 래핑 방식은 권장되지 않습니다.\n * 대신 개별 Action에서 직접 `PublicActionResult`를 반환하십시오.\n * 이 호환 helper는 예외를 가로채지 않으며 unexpected exception과 Next.js 제어 흐름을 그대로 전파합니다.\n */\nexport function createResilioAction<\n  TData,\n  TCatalog extends ErrorCatalog,\n  TCodes extends ErrorCode<TCatalog> = ErrorCode<TCatalog>,\n  TArgs extends unknown[] = unknown[],\n>(\n  handler: (...args: TArgs) => Promise<PublicActionResult<TData, TCatalog, TCodes>>,\n): (...args: TArgs) => Promise<PublicActionResult<TData, TCatalog, TCodes>> {\n  return handler;\n}\n\n/**\n * 이미 decode된 Server Action 결과가 성공인지 타입 안전하게 확인합니다.\n */\nexport function isSuccessfulResilioAction<\n  TData,\n  TCatalog extends ErrorCatalog,\n  TCodes extends ErrorCode<TCatalog> = ErrorCode<TCatalog>,\n>(\n  result: PublicActionResult<TData, TCatalog, TCodes>\n): result is { ok: true; data: TData } {\n  return result.ok === true;\n}\n","import { Result } from '@resiliojs/core';\n\n/**\n * React 19 useActionState 초기화 시그니처에 적합한 성공 상태(Result)의 액션 초기값을 생성합니다.\n */\nexport function toActionState<T, E = unknown>(\n  initialData: T | null = null\n): Result<T | null, E> {\n  return { ok: true, data: initialData };\n}\n","import { ResilioError, serializeError } from '@resiliojs/core';\n\nexport function sanitizeErrorForClient(\n  error: ResilioError,\n): ResilioError {\n  if (error.kind === 'server' || error.kind === 'unknown') {\n    throw new Error('Unexpected server errors must be thrown and handled by the Next.js error boundary.');\n  }\n  return serializeError(error);\n}\n","import type { Instrumentation } from 'next';\nimport type { ErrorCatalog, ErrorSink } from '@resiliojs/core';\nimport { reportToSinkBestEffort } from '@resiliojs/core';\n\n/**\n * Next.js 15+ instrumentation.ts의 onRequestError 규격에 맞는 오류 관측성 핸들러를 생성합니다.\n * request headers와 query string은 보안을 위해 기본적으로 전달하지 않습니다.\n */\nexport function createResilioOnRequestError<T extends ErrorCatalog>(\n  sink: ErrorSink<T>\n): Instrumentation.onRequestError {\n  return async (error, request, context) => {\n    const safePath = request.path ? request.path.split('?')[0] : '';\n    const digest = getErrorDigest(error);\n    const occurrenceId = Math.random().toString(36).substring(2, 15);\n    const timestamp = Date.now();\n\n    await reportToSinkBestEffort(sink, {\n      occurrenceId,\n      timestamp,\n      source: 'next.request',\n      kind: 'exception',\n      error,\n      correlationId: digest,\n      context: {\n        path: safePath,\n        method: request.method,\n        routerKind: context.routerKind,\n        routePath: context.routePath,\n        routeType: context.routeType,\n        renderSource: context.renderSource,\n        revalidateReason: context.revalidateReason,\n        digest,\n      },\n    });\n  };\n}\n\nfunction getErrorDigest(error: unknown): string | undefined {\n  if (!error || typeof error !== 'object' || !('digest' in error)) {\n    return undefined;\n  }\n  return typeof error.digest === 'string' ? error.digest : undefined;\n}\n\n// 기존 하위 호환을 위한 레거시 헬퍼\nimport { normalizeError, globalResilioEmitter, ResilioError } from '@resiliojs/core';\n\nexport interface RouteErrorOptions {\n  digest?: string;\n}\n\n/**\n * @deprecated Use createResilioOnRequestError instead.\n */\nexport function reportRouteError(\n  error: unknown,\n  options: RouteErrorOptions = {}\n): ResilioError {\n  const normalized = normalizeError(error, {\n    defaultKind: 'server',\n    defaultPresentation: 'boundary',\n  });\n\n  if (options.digest) {\n    normalized.code = options.digest;\n  }\n\n  globalResilioEmitter.emit(normalized);\n\n  return normalized;\n}\n","// Server-safe exports (safe to import in Server Components & Server Actions)\nexport * from './action.js';\nexport * from './action-state.js';\nexport * from './serializer.js';\nexport * from './route-error.js';\nexport * from './types.js';\n\n// Re-export core types and utilities for single-package DX\nexport { \n  ok, \n  err, \n  isOk, \n  isErr, \n  isPublicResult,\n  normalizeError, \n  serializeError, \n  isRetryableError, \n  withRetry,\n  defineErrorPolicy,\n  shouldSuppress,\n  defineErrorCatalog,\n  createPublicError,\n  decodePublicError,\n  createConsoleSink,\n  createCompositeSink,\n  PolicyEngine,\n  canonicalStringify,\n  stringHash,\n  BoundedDedupeStore,\n  definePresentationPolicy,\n  createPresentationEvaluator\n} from '@resiliojs/core';\n\nexport type { \n  Result, \n  PublicResult,\n  ResilioError, \n  ResilioErrorKind, \n  RetryPolicy, \n  NormalizeOptions, \n  LoggerAdapter,\n  ErrorCatalog,\n  PublicError,\n  FeedbackType,\n  ErrorPolicyConfig,\n  ErrorDefinition,\n  ErrorCode,\n  PublicErrorFor,\n  PublicErrorArgs,\n  DecodeResult,\n  ErrorSource,\n  ErrorEvent,\n  ErrorSink,\n  PolicyEntry,\n  PolicyDecision,\n  DedupeContext,\n  DedupePolicy,\n  PolicyEngineOptions,\n  BuiltInChannel,\n  PresentationContext,\n  PresentationDecision,\n  PresentationPlan,\n  PresentationPlanInput,\n  PresentationRule,\n  PresentationPolicyConfig,\n  EvaluatedPresentationDecision,\n  PresentationInvalidReason,\n  PresentationEvaluationResult,\n  PresentationEvaluator,\n  PresentationEvaluatorOptions,\n  PresentationObservationEvent,\n  PresentationObserver\n} from '@resiliojs/core';\n\nexport { ResilioEmitter, globalResilioEmitter, ResilioLogger, resilioLogger, defaultConsoleLogger } from '@resiliojs/core';\n"],"mappings":";AAQO,SAAS,oBAMd,SAC0E;AAC1E,SAAO;AACT;AAKO,SAAS,0BAKd,QACqC;AACrC,SAAO,OAAO,OAAO;AACvB;;;ACzBO,SAAS,cACd,cAAwB,MACH;AACrB,SAAO,EAAE,IAAI,MAAM,MAAM,YAAY;AACvC;;;ACTA,SAAuB,sBAAsB;AAEtC,SAAS,uBACd,OACc;AACd,MAAI,MAAM,SAAS,YAAY,MAAM,SAAS,WAAW;AACvD,UAAM,IAAI,MAAM,oFAAoF;AAAA,EACtG;AACA,SAAO,eAAe,KAAK;AAC7B;;;ACPA,SAAS,8BAA8B;AA4CvC,SAAS,gBAAgB,4BAA0C;AAtC5D,SAAS,4BACd,MACgC;AAChC,SAAO,OAAO,OAAO,SAAS,YAAY;AACxC,UAAM,WAAW,QAAQ,OAAO,QAAQ,KAAK,MAAM,GAAG,EAAE,CAAC,IAAI;AAC7D,UAAM,SAAS,eAAe,KAAK;AACnC,UAAM,eAAe,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,UAAU,GAAG,EAAE;AAC/D,UAAM,YAAY,KAAK,IAAI;AAE3B,UAAM,uBAAuB,MAAM;AAAA,MACjC;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,MACR,MAAM;AAAA,MACN;AAAA,MACA,eAAe;AAAA,MACf,SAAS;AAAA,QACP,MAAM;AAAA,QACN,QAAQ,QAAQ;AAAA,QAChB,YAAY,QAAQ;AAAA,QACpB,WAAW,QAAQ;AAAA,QACnB,WAAW,QAAQ;AAAA,QACnB,cAAc,QAAQ;AAAA,QACtB,kBAAkB,QAAQ;AAAA,QAC1B;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAEA,SAAS,eAAe,OAAoC;AAC1D,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,EAAE,YAAY,QAAQ;AAC/D,WAAO;AAAA,EACT;AACA,SAAO,OAAO,MAAM,WAAW,WAAW,MAAM,SAAS;AAC3D;AAYO,SAAS,iBACd,OACA,UAA6B,CAAC,GAChB;AACd,QAAM,aAAa,eAAe,OAAO;AAAA,IACvC,aAAa;AAAA,IACb,qBAAqB;AAAA,EACvB,CAAC;AAED,MAAI,QAAQ,QAAQ;AAClB,eAAW,OAAO,QAAQ;AAAA,EAC5B;AAEA,uBAAqB,KAAK,UAAU;AAEpC,SAAO;AACT;;;AC/DA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAAA;AAAA,EACA,kBAAAC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA2CP,SAAS,gBAAgB,wBAAAC,uBAAsB,eAAe,eAAe,4BAA4B;","names":["normalizeError","serializeError","globalResilioEmitter"]}

package/dist/types-kEvjOn-F.d.cts

@@ -0,0 +1,16 @@
+import { Result, ErrorCatalog, ErrorCode, PublicErrorFor } from '@resiliojs/core';
+
+/**
+ * React 19 useActionState 초기화 시그니처에 적합한 성공 상태(Result)의 액션 초기값을 생성합니다.
+ */
+declare function toActionState<T, E = unknown>(initialData?: T | null): Result<T | null, E>;
+
+type PublicActionResult<TData, TCatalog extends ErrorCatalog, TCodes extends ErrorCode<TCatalog> = ErrorCode<TCatalog>> = {
+    ok: true;
+    data: TData;
+} | {
+    ok: false;
+    error: PublicErrorFor<TCatalog, TCodes>;
+};
+
+export { type PublicActionResult as P, toActionState as t };

package/dist/types-kEvjOn-F.d.ts

@@ -0,0 +1,16 @@
+import { Result, ErrorCatalog, ErrorCode, PublicErrorFor } from '@resiliojs/core';
+
+/**
+ * React 19 useActionState 초기화 시그니처에 적합한 성공 상태(Result)의 액션 초기값을 생성합니다.
+ */
+declare function toActionState<T, E = unknown>(initialData?: T | null): Result<T | null, E>;
+
+type PublicActionResult<TData, TCatalog extends ErrorCatalog, TCodes extends ErrorCode<TCatalog> = ErrorCode<TCatalog>> = {
+    ok: true;
+    data: TData;
+} | {
+    ok: false;
+    error: PublicErrorFor<TCatalog, TCodes>;
+};
+
+export { type PublicActionResult as P, toActionState as t };

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@resiliojs/next",
+  "version": "0.1.0",
+  "description": "Next.js facade for typed public errors and presentation policies",
+  "license": "MIT",
+  "keywords": [
+    "nextjs",
+    "react",
+    "server-actions",
+    "error-handling",
+    "presentation-policy"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/noonnofus/resilio.git",
+    "directory": "packages/next"
+  },
+  "homepage": "https://github.com/noonnofus/resilio#readme",
+  "bugs": {
+    "url": "https://github.com/noonnofus/resilio/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@resiliojs/core": "^0.1.0",
+    "@resiliojs/react": "^0.1.0"
+  },
+  "peerDependencies": {
+    "next": ">=15 <17",
+    "react": ">=18.3 <20",
+    "react-dom": ">=18.3 <20"
+  },
+  "devDependencies": {
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@testing-library/react": "^16.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}