@ereo/client 0.1.13 → 0.1.19

package/dist/await.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @ereo/client - Await Component for Streaming SSR
+ *
+ * Used with React Suspense to render deferred data from loaders.
+ * Works with the `defer()` function from @ereo/data.
+ */
+import { type ReactNode, type ReactElement } from 'react';
+/**
+ * Deferred data structure from @ereo/data defer() function.
+ */
+export interface DeferredData<T> {
+    promise: Promise<T>;
+    status: 'pending' | 'resolved' | 'rejected';
+    value?: T;
+    error?: Error;
+}
+/**
+ * Props for the Await component.
+ */
+export interface AwaitProps<T> {
+    /**
+     * The deferred data promise to resolve.
+     * Usually comes from a loader using `defer()`.
+     */
+    resolve: DeferredData<T> | Promise<T>;
+    /**
+     * Render function called with resolved data.
+     * Also accepts a React element directly.
+     */
+    children: ((data: T) => ReactNode) | ReactNode;
+    /**
+     * Optional fallback UI to show when the promise rejects.
+     * If not provided, the error will propagate to the nearest error boundary.
+     */
+    errorElement?: ReactNode;
+}
+/**
+ * Await component for rendering deferred data in streaming SSR.
+ *
+ * Must be used inside a `<Suspense>` boundary.
+ * Works with deferred data from `@ereo/data`'s `defer()` function.
+ *
+ * @example
+ * ```tsx
+ * import { Suspense } from 'react';
+ * import { Await } from '@ereo/client';
+ * import { defer, createLoader } from '@ereo/data';
+ *
+ * export const loader = createLoader({
+ *   load: async () => ({
+ *     // Critical data loaded immediately
+ *     post: await db.posts.find(id),
+ *     // Non-critical data deferred
+ *     comments: defer(db.comments.findByPost(id)),
+ *   })
+ * });
+ *
+ * export default function Post({ loaderData }) {
+ *   return (
+ *     <article>
+ *       <h1>{loaderData.post.title}</h1>
+ *
+ *       <Suspense fallback={<CommentsSkeleton />}>
+ *         <Await resolve={loaderData.comments}>
+ *           {(comments) => <CommentList comments={comments} />}
+ *         </Await>
+ *       </Suspense>
+ *     </article>
+ *   );
+ * }
+ * ```
+ *
+ * @example With error handling
+ * ```tsx
+ * <Suspense fallback={<Loading />}>
+ *   <Await
+ *     resolve={loaderData.comments}
+ *     errorElement={<div>Failed to load comments</div>}
+ *   >
+ *     {(comments) => <CommentList comments={comments} />}
+ *   </Await>
+ * </Suspense>
+ * ```
+ */
+export declare function Await<T>({ resolve, children, errorElement, }: AwaitProps<T>): ReactElement;
+/**
+ * Helper to resolve deferred data.
+ * Can be used in loaders or components to wait for deferred data.
+ *
+ * @param deferred - The deferred data to resolve
+ * @returns Promise that resolves to the data
+ */
+export declare function resolveAwait<T>(deferred: DeferredData<T>): Promise<T>;
+//# sourceMappingURL=await.d.ts.map

package/dist/await.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"await.d.ts","sourceRoot":"","sources":["../src/await.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAc,EACZ,KAAK,SAAS,EACd,KAAK,YAAY,EAGlB,MAAM,OAAO,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IAC5C,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B;;;OAGG;IACH,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEtC;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC,GAAG,SAAS,CAAC;IAE/C;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B;AA0FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EACvB,OAAO,EACP,QAAQ,EACR,YAAY,GACb,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,YAAY,CAS9B;AAcD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3E"}

package/dist/index.d.ts

@@ -24,6 +24,8 @@ export { Form, FormProvider, useFormContext, useSubmit, useFetcher, useActionDat
 export type { FormProps, ActionResult, SubmissionState, SubmitOptions, FetcherState, Fetcher, FormContextValue, FormNavigationState, } from './form';
 export { ErrorBoundary, RouteErrorBoundary, useErrorBoundary, useRouteError, isRouteErrorResponse, createRouteErrorResponse, withErrorBoundary, RouteError, } from './error-boundary';
 export type { ErrorBoundaryProps, RouteErrorResponse, RouteErrorBoundaryProps, UseErrorBoundaryReturn, } from './error-boundary';
+export { Await, resolveAwait } from './await';
+export type { AwaitProps, DeferredData } from './await';
 /**
  * Initialize the client runtime.
  * Call this in your entry point.

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1985,6 +1985,75 @@ class RouteError extends Error {
     };
   }
 }
+// src/await.tsx
+import { jsxDEV as jsxDEV3, Fragment } from "react/jsx-dev-runtime";
+var promiseCache = new WeakMap;
+function trackPromise(promise) {
+  let tracked = promiseCache.get(promise);
+  if (!tracked) {
+    tracked = { status: "pending" };
+    promiseCache.set(promise, tracked);
+    promise.then((value) => {
+      tracked.status = "fulfilled";
+      tracked.value = value;
+    }, (reason) => {
+      tracked.status = "rejected";
+      tracked.reason = reason;
+    });
+  }
+  if (tracked.status === "pending") {
+    throw promise;
+  }
+  if (tracked.status === "rejected") {
+    throw tracked.reason;
+  }
+  return tracked.value;
+}
+function AwaitInner({
+  promise,
+  children,
+  errorElement
+}) {
+  try {
+    const data = trackPromise(promise);
+    if (typeof children === "function") {
+      return /* @__PURE__ */ jsxDEV3(Fragment, {
+        children: children(data)
+      }, undefined, false, undefined, this);
+    }
+    return /* @__PURE__ */ jsxDEV3(Fragment, {
+      children
+    }, undefined, false, undefined, this);
+  } catch (error) {
+    if (error instanceof Promise) {
+      throw error;
+    }
+    if (errorElement !== undefined) {
+      return /* @__PURE__ */ jsxDEV3(Fragment, {
+        children: errorElement
+      }, undefined, false, undefined, this);
+    }
+    throw error;
+  }
+}
+function Await({
+  resolve,
+  children,
+  errorElement
+}) {
+  const promise = isDeferredData(resolve) ? resolve.promise : resolve;
+  return /* @__PURE__ */ jsxDEV3(AwaitInner, {
+    promise,
+    errorElement,
+    children
+  }, undefined, false, undefined, this);
+}
+function isDeferredData(value) {
+  return typeof value === "object" && value !== null && "promise" in value && "status" in value;
+}
+async function resolveAwait(deferred) {
+  return deferred.promise;
+}
 
 // src/index.ts
 function initClient() {
@@ -2024,6 +2093,7 @@ export {
   setupAutoPrefetch,
   serializeFormData,
   router,
+  resolveAwait,
   resetIslandCounter,
   registerIslandComponents,
   registerIslandComponent,
@@ -2079,6 +2149,7 @@ export {
   ErrorContext,
   ErrorBoundary,
   EreoProvider,
+  Await,
   ActionDataProvider,
   ActionDataContext
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ereo/client",
-  "version": "0.1.13",
+  "version": "0.1.19",
   "license": "MIT",
   "author": "Ereo Team",
   "homepage": "https://ereo.dev",