hadars 0.2.0 → 0.2.2-rc.0

package/dist/cloudflare.d.cts

@@ -0,0 +1,64 @@
+import { H as HadarsEntryModule, a as HadarsOptions } from './hadars-mKu5txjW.cjs';
+
+/**
+ * Cloudflare Workers adapter for hadars.
+ *
+ * After running `hadars build`, bundle your app with:
+ *
+ *   hadars export cloudflare
+ *
+ * This produces a self-contained `cloudflare.mjs` that you deploy with:
+ *
+ *   wrangler deploy
+ *
+ * Static assets (JS, CSS, fonts) under `.hadars/static/` must be served from
+ * R2 or another CDN — the Worker only handles HTML rendering. Route requests
+ * for static file extensions to R2 and everything else to the Worker.
+ *
+ * @example wrangler.toml
+ *   name = "my-app"
+ *   main = "cloudflare.mjs"
+ *   compatibility_date = "2024-09-23"
+ *   compatibility_flags = ["nodejs_compat"]
+ */
+
+/**
+ * Pre-loaded SSR module and HTML template for single-file Cloudflare bundles
+ * produced by `hadars export cloudflare`. All I/O is eliminated at runtime —
+ * the Worker is fully self-contained.
+ */
+interface CloudflareBundled {
+    /** The compiled SSR module — import it statically in your entry shim. */
+    ssrModule: HadarsEntryModule<any>;
+    /**
+     * The contents of `.hadars/static/out.html` — esbuild inlines this as a
+     * string when `hadars export cloudflare` runs.
+     */
+    outHtml: string;
+}
+/**
+ * The shape of a Cloudflare Workers export object.
+ * Return this as the default export of your Worker entry file.
+ */
+interface CloudflareHandler {
+    fetch(request: Request, env: unknown, ctx: unknown): Promise<Response>;
+}
+/**
+ * Creates a Cloudflare Workers handler from a hadars config and a pre-bundled
+ * SSR module. Use this as the default export of your Worker entry.
+ *
+ * Unlike the Lambda adapter, Cloudflare Workers receive a standard Web
+ * `Request` and return a standard `Response` — no event format conversion is
+ * required. Static assets must be routed to R2/CDN via wrangler rules; this
+ * Worker handles only HTML rendering and API routes.
+ *
+ * @example — generated entry shim (created by `hadars export cloudflare`)
+ * import * as ssrModule from './.hadars/index.ssr.js';
+ * import outHtml from './.hadars/static/out.html';
+ * import { createCloudflareHandler } from 'hadars/cloudflare';
+ * import config from './hadars.config';
+ * export default createCloudflareHandler(config, { ssrModule, outHtml });
+ */
+declare function createCloudflareHandler(options: HadarsOptions, bundled: CloudflareBundled): CloudflareHandler;
+
+export { type CloudflareBundled, type CloudflareHandler, createCloudflareHandler };

package/dist/cloudflare.d.ts

@@ -0,0 +1,64 @@
+import { H as HadarsEntryModule, a as HadarsOptions } from './hadars-mKu5txjW.js';
+
+/**
+ * Cloudflare Workers adapter for hadars.
+ *
+ * After running `hadars build`, bundle your app with:
+ *
+ *   hadars export cloudflare
+ *
+ * This produces a self-contained `cloudflare.mjs` that you deploy with:
+ *
+ *   wrangler deploy
+ *
+ * Static assets (JS, CSS, fonts) under `.hadars/static/` must be served from
+ * R2 or another CDN — the Worker only handles HTML rendering. Route requests
+ * for static file extensions to R2 and everything else to the Worker.
+ *
+ * @example wrangler.toml
+ *   name = "my-app"
+ *   main = "cloudflare.mjs"
+ *   compatibility_date = "2024-09-23"
+ *   compatibility_flags = ["nodejs_compat"]
+ */
+
+/**
+ * Pre-loaded SSR module and HTML template for single-file Cloudflare bundles
+ * produced by `hadars export cloudflare`. All I/O is eliminated at runtime —
+ * the Worker is fully self-contained.
+ */
+interface CloudflareBundled {
+    /** The compiled SSR module — import it statically in your entry shim. */
+    ssrModule: HadarsEntryModule<any>;
+    /**
+     * The contents of `.hadars/static/out.html` — esbuild inlines this as a
+     * string when `hadars export cloudflare` runs.
+     */
+    outHtml: string;
+}
+/**
+ * The shape of a Cloudflare Workers export object.
+ * Return this as the default export of your Worker entry file.
+ */
+interface CloudflareHandler {
+    fetch(request: Request, env: unknown, ctx: unknown): Promise<Response>;
+}
+/**
+ * Creates a Cloudflare Workers handler from a hadars config and a pre-bundled
+ * SSR module. Use this as the default export of your Worker entry.
+ *
+ * Unlike the Lambda adapter, Cloudflare Workers receive a standard Web
+ * `Request` and return a standard `Response` — no event format conversion is
+ * required. Static assets must be routed to R2/CDN via wrangler rules; this
+ * Worker handles only HTML rendering and API routes.
+ *
+ * @example — generated entry shim (created by `hadars export cloudflare`)
+ * import * as ssrModule from './.hadars/index.ssr.js';
+ * import outHtml from './.hadars/static/out.html';
+ * import { createCloudflareHandler } from 'hadars/cloudflare';
+ * import config from './hadars.config';
+ * export default createCloudflareHandler(config, { ssrModule, outHtml });
+ */
+declare function createCloudflareHandler(options: HadarsOptions, bundled: CloudflareBundled): CloudflareHandler;
+
+export { type CloudflareBundled, type CloudflareHandler, createCloudflareHandler };

package/dist/cloudflare.js

@@ -0,0 +1,68 @@
+import {
+  buildHeadHtml,
+  buildSsrHtml,
+  createProxyHandler,
+  createRenderCache,
+  getReactResponse,
+  makePrecontentHtmlGetter,
+  parseRequest
+} from "./chunk-H72BZXOA.js";
+import "./chunk-LY5MTHFV.js";
+import "./chunk-OS3V4CPN.js";
+
+// src/cloudflare.ts
+import "react";
+function createCloudflareHandler(options, bundled) {
+  const fetchHandler = options.fetch;
+  const handleProxy = createProxyHandler(options);
+  const getPrecontentHtml = makePrecontentHtmlGetter(Promise.resolve(bundled.outHtml));
+  const { ssrModule } = bundled;
+  const runHandler = async (req) => {
+    const request = parseRequest(req);
+    if (fetchHandler) {
+      const res = await fetchHandler(request);
+      if (res) return res;
+    }
+    const proxied = await handleProxy(request);
+    if (proxied) return proxied;
+    try {
+      const { default: Component, getInitProps, getFinalProps } = ssrModule;
+      const { head, status, getAppBody, finalize } = await getReactResponse(request, {
+        document: {
+          body: Component,
+          lang: "en",
+          getInitProps,
+          getFinalProps
+        }
+      });
+      if (request.headers.get("Accept") === "application/json") {
+        const { clientProps: clientProps2 } = await finalize();
+        const serverData = clientProps2.__serverData ?? {};
+        return new Response(JSON.stringify({ serverData }), {
+          status,
+          headers: { "Content-Type": "application/json; charset=utf-8" }
+        });
+      }
+      const bodyHtml = await getAppBody();
+      const { clientProps } = await finalize();
+      const headHtml = buildHeadHtml(head);
+      const html = await buildSsrHtml(bodyHtml, clientProps, headHtml, getPrecontentHtml);
+      return new Response(html, {
+        status,
+        headers: { "Content-Type": "text/html; charset=utf-8" }
+      });
+    } catch (err) {
+      console.error("[hadars] SSR render error:", err);
+      return new Response("Internal Server Error", { status: 500 });
+    }
+  };
+  const finalFetch = options.cache ? createRenderCache(options.cache, (req) => runHandler(req)) : (req) => runHandler(req);
+  return {
+    fetch: async (request, _env, ctx) => {
+      return await finalFetch(request, ctx) ?? new Response("Not Found", { status: 404 });
+    }
+  };
+}
+export {
+  createCloudflareHandler
+};

package/dist/{hadars-Bh-V5YXg.d.cts → hadars-mKu5txjW.d.cts}

@@ -1,6 +1,33 @@
-import { MetaHTMLAttributes, LinkHTMLAttributes, StyleHTMLAttributes, ScriptHTMLAttributes } from 'react';
-
-type HadarsGetInitialProps<T extends {}> = (req: HadarsRequest) => Promise<T> | T;
+/**
+ * In-process GraphQL executor passed to `getInitProps` and `paths` during
+ * `hadars export static`. Hadars is executor-agnostic — configure it in
+ * `hadars.config.ts` using any GraphQL library (e.g. `graphql-js`):
+ *
+ * ```ts
+ * import { graphql as gql, buildSchema } from 'graphql';
+ * const schema = buildSchema(`type Query { hello: String }`);
+ * const rootValue = { hello: () => 'world' };
+ *
+ * export default {
+ *   graphql: (query, variables) =>
+ *     gql({ schema, rootValue, source: query, variableValues: variables }),
+ * } satisfies HadarsOptions;
+ * ```
+ */
+type GraphQLExecutor = (query: string, variables?: Record<string, unknown>) => Promise<{
+    data?: any;
+    errors?: ReadonlyArray<{
+        message: string;
+    }>;
+}>;
+/**
+ * Context passed as the second argument to `getInitProps` and `paths`
+ * during `hadars export static`. Not present in dev/run mode.
+ */
+interface HadarsStaticContext {
+    graphql: GraphQLExecutor;
+}
+type HadarsGetInitialProps<T extends {}> = (req: HadarsRequest, ctx?: HadarsStaticContext) => Promise<T> | T;
 type HadarsGetClientProps<T extends {}> = (props: T) => Promise<T> | T;
 type HadarsGetFinalProps<T extends {}> = (props: HadarsProps<T>) => Promise<T> | T;
 type HadarsApp<T extends {}> = React.FC<HadarsProps<T>>;
@@ -10,43 +37,10 @@ type HadarsEntryModule<T extends {}> = {
     getFinalProps?: HadarsGetFinalProps<T>;
     getClientProps?: HadarsGetClientProps<T>;
 };
-interface AppHead {
-    title: string;
-    status: number;
-    meta: Record<string, MetaProps>;
-    link: Record<string, LinkProps>;
-    style: Record<string, StyleProps>;
-    script: Record<string, ScriptProps>;
-}
-type UnsuspendEntry = {
-    status: 'pending';
-    promise: Promise<unknown>;
-} | {
-    status: 'fulfilled';
-    value: unknown;
-} | {
-    status: 'rejected';
-    reason: unknown;
-};
-/** @internal Populated by the framework's render loop — use useServerData() instead. */
-interface AppUnsuspend {
-    cache: Map<string, UnsuspendEntry>;
-}
-interface AppContext {
-    path?: string;
-    head: AppHead;
-    /** @internal Framework use only — use the useServerData() hook instead. */
-    _unsuspend?: AppUnsuspend;
-}
 type HadarsEntryBase = {
     location: string;
-    context: AppContext;
 };
 type HadarsProps<T extends {}> = T & HadarsEntryBase;
-type MetaProps = MetaHTMLAttributes<HTMLMetaElement>;
-type LinkProps = LinkHTMLAttributes<HTMLLinkElement>;
-type StyleProps = StyleHTMLAttributes<HTMLStyleElement>;
-type ScriptProps = ScriptHTMLAttributes<HTMLScriptElement>;
 interface HadarsOptions {
     port?: number;
     entry: string;
@@ -183,6 +177,68 @@ interface HadarsOptions {
         key: string;
         ttl?: number;
     } | null | undefined>;
+    /**
+     * Static export path list. Required for `hadars export static`.
+     *
+     * Return an array of URL paths (e.g. `['/', '/about', '/blog/hello']`) that
+     * should be pre-rendered to HTML files. May be async.
+     *
+     * @example
+     * paths: () => ['/', '/about', '/contact']
+     *
+     * @example
+     * paths: async () => {
+     *   const posts = await fetchBlogPosts();
+     *   return ['/', ...posts.map(p => `/blog/${p.slug}`)];
+     * }
+     */
+    /**
+     * In-process GraphQL executor. Supply this to use the GraphQL data layer
+     * in `paths` and `getInitProps` during `hadars export static`.
+     * Has no effect in `dev` / `run` mode.
+     */
+    graphql?: GraphQLExecutor;
+    paths?: (ctx: HadarsStaticContext) => Promise<string[]> | string[];
+    /**
+     * Gatsby-compatible source plugins to run before `hadars export static`.
+     *
+     * Each entry mirrors Gatsby's `gatsby-config.js` plugin object format:
+     * `{ resolve: 'gatsby-source-contentful', options: { spaceId: '...', accessToken: '...' } }`
+     *
+     * The plugin must export a `sourceNodes` function with the standard Gatsby API.
+     * Hadars provides a thin shim covering the most-used surface:
+     * `actions.createNode`, `createNodeId`, `createContentDigest`, `cache`, `reporter`,
+     * `getNode`, `getNodes`, `getNodesByType`.
+     *
+     * After all sources have run, hadars auto-generates a GraphQL schema from the
+     * collected nodes and makes it available via `config.graphql` in `getInitProps`
+     * and `paths`. Requires `graphql` to be installed in the project.
+     *
+     * @example
+     * sources: [
+     *   {
+     *     resolve: 'gatsby-source-filesystem',
+     *     options: { name: 'posts', path: './content/posts' },
+     *   },
+     * ]
+     */
+    sources?: HadarsSourceEntry[];
+}
+/**
+ * A Gatsby-compatible source plugin entry, matching the format used in
+ * `gatsby-config.js` / `gatsby-config.ts`.
+ */
+interface HadarsSourceEntry {
+    /**
+     * Package name (e.g. `'gatsby-source-contentful'`) or a pre-imported module
+     * object that exports `sourceNodes`. Using a module object lets you pass
+     * local source plugins without publishing them to npm.
+     */
+    resolve: string | {
+        sourceNodes?: (ctx: any, opts?: any) => Promise<void> | void;
+    };
+    /** Plugin options forwarded as the second argument to `sourceNodes`. */
+    options?: Record<string, unknown>;
 }
 type SwcPluginItem = string | [string, Record<string, unknown>] | {
     path: string;
@@ -196,4 +252,4 @@ interface HadarsRequest extends Request {
     cookies: Record<string, string>;
 }
 
-export type { AppContext as A, HadarsEntryModule as H, HadarsOptions as a, HadarsApp as b, HadarsGetClientProps as c, HadarsGetFinalProps as d, HadarsGetInitialProps as e, HadarsProps as f, HadarsRequest as g };
+export type { GraphQLExecutor as G, HadarsEntryModule as H, HadarsOptions as a, HadarsApp as b, HadarsGetClientProps as c, HadarsGetFinalProps as d, HadarsGetInitialProps as e, HadarsProps as f, HadarsRequest as g, HadarsSourceEntry as h, HadarsStaticContext as i };

package/dist/{hadars-Bh-V5YXg.d.ts → hadars-mKu5txjW.d.ts}

@@ -1,6 +1,33 @@
-import { MetaHTMLAttributes, LinkHTMLAttributes, StyleHTMLAttributes, ScriptHTMLAttributes } from 'react';
-
-type HadarsGetInitialProps<T extends {}> = (req: HadarsRequest) => Promise<T> | T;
+/**
+ * In-process GraphQL executor passed to `getInitProps` and `paths` during
+ * `hadars export static`. Hadars is executor-agnostic — configure it in
+ * `hadars.config.ts` using any GraphQL library (e.g. `graphql-js`):
+ *
+ * ```ts
+ * import { graphql as gql, buildSchema } from 'graphql';
+ * const schema = buildSchema(`type Query { hello: String }`);
+ * const rootValue = { hello: () => 'world' };
+ *
+ * export default {
+ *   graphql: (query, variables) =>
+ *     gql({ schema, rootValue, source: query, variableValues: variables }),
+ * } satisfies HadarsOptions;
+ * ```
+ */
+type GraphQLExecutor = (query: string, variables?: Record<string, unknown>) => Promise<{
+    data?: any;
+    errors?: ReadonlyArray<{
+        message: string;
+    }>;
+}>;
+/**
+ * Context passed as the second argument to `getInitProps` and `paths`
+ * during `hadars export static`. Not present in dev/run mode.
+ */
+interface HadarsStaticContext {
+    graphql: GraphQLExecutor;
+}
+type HadarsGetInitialProps<T extends {}> = (req: HadarsRequest, ctx?: HadarsStaticContext) => Promise<T> | T;
 type HadarsGetClientProps<T extends {}> = (props: T) => Promise<T> | T;
 type HadarsGetFinalProps<T extends {}> = (props: HadarsProps<T>) => Promise<T> | T;
 type HadarsApp<T extends {}> = React.FC<HadarsProps<T>>;
@@ -10,43 +37,10 @@ type HadarsEntryModule<T extends {}> = {
     getFinalProps?: HadarsGetFinalProps<T>;
     getClientProps?: HadarsGetClientProps<T>;
 };
-interface AppHead {
-    title: string;
-    status: number;
-    meta: Record<string, MetaProps>;
-    link: Record<string, LinkProps>;
-    style: Record<string, StyleProps>;
-    script: Record<string, ScriptProps>;
-}
-type UnsuspendEntry = {
-    status: 'pending';
-    promise: Promise<unknown>;
-} | {
-    status: 'fulfilled';
-    value: unknown;
-} | {
-    status: 'rejected';
-    reason: unknown;
-};
-/** @internal Populated by the framework's render loop — use useServerData() instead. */
-interface AppUnsuspend {
-    cache: Map<string, UnsuspendEntry>;
-}
-interface AppContext {
-    path?: string;
-    head: AppHead;
-    /** @internal Framework use only — use the useServerData() hook instead. */
-    _unsuspend?: AppUnsuspend;
-}
 type HadarsEntryBase = {
     location: string;
-    context: AppContext;
 };
 type HadarsProps<T extends {}> = T & HadarsEntryBase;
-type MetaProps = MetaHTMLAttributes<HTMLMetaElement>;
-type LinkProps = LinkHTMLAttributes<HTMLLinkElement>;
-type StyleProps = StyleHTMLAttributes<HTMLStyleElement>;
-type ScriptProps = ScriptHTMLAttributes<HTMLScriptElement>;
 interface HadarsOptions {
     port?: number;
     entry: string;
@@ -183,6 +177,68 @@ interface HadarsOptions {
         key: string;
         ttl?: number;
     } | null | undefined>;
+    /**
+     * Static export path list. Required for `hadars export static`.
+     *
+     * Return an array of URL paths (e.g. `['/', '/about', '/blog/hello']`) that
+     * should be pre-rendered to HTML files. May be async.
+     *
+     * @example
+     * paths: () => ['/', '/about', '/contact']
+     *
+     * @example
+     * paths: async () => {
+     *   const posts = await fetchBlogPosts();
+     *   return ['/', ...posts.map(p => `/blog/${p.slug}`)];
+     * }
+     */
+    /**
+     * In-process GraphQL executor. Supply this to use the GraphQL data layer
+     * in `paths` and `getInitProps` during `hadars export static`.
+     * Has no effect in `dev` / `run` mode.
+     */
+    graphql?: GraphQLExecutor;
+    paths?: (ctx: HadarsStaticContext) => Promise<string[]> | string[];
+    /**
+     * Gatsby-compatible source plugins to run before `hadars export static`.
+     *
+     * Each entry mirrors Gatsby's `gatsby-config.js` plugin object format:
+     * `{ resolve: 'gatsby-source-contentful', options: { spaceId: '...', accessToken: '...' } }`
+     *
+     * The plugin must export a `sourceNodes` function with the standard Gatsby API.
+     * Hadars provides a thin shim covering the most-used surface:
+     * `actions.createNode`, `createNodeId`, `createContentDigest`, `cache`, `reporter`,
+     * `getNode`, `getNodes`, `getNodesByType`.
+     *
+     * After all sources have run, hadars auto-generates a GraphQL schema from the
+     * collected nodes and makes it available via `config.graphql` in `getInitProps`
+     * and `paths`. Requires `graphql` to be installed in the project.
+     *
+     * @example
+     * sources: [
+     *   {
+     *     resolve: 'gatsby-source-filesystem',
+     *     options: { name: 'posts', path: './content/posts' },
+     *   },
+     * ]
+     */
+    sources?: HadarsSourceEntry[];
+}
+/**
+ * A Gatsby-compatible source plugin entry, matching the format used in
+ * `gatsby-config.js` / `gatsby-config.ts`.
+ */
+interface HadarsSourceEntry {
+    /**
+     * Package name (e.g. `'gatsby-source-contentful'`) or a pre-imported module
+     * object that exports `sourceNodes`. Using a module object lets you pass
+     * local source plugins without publishing them to npm.
+     */
+    resolve: string | {
+        sourceNodes?: (ctx: any, opts?: any) => Promise<void> | void;
+    };
+    /** Plugin options forwarded as the second argument to `sourceNodes`. */
+    options?: Record<string, unknown>;
 }
 type SwcPluginItem = string | [string, Record<string, unknown>] | {
     path: string;
@@ -196,4 +252,4 @@ interface HadarsRequest extends Request {
     cookies: Record<string, string>;
 }
 
-export type { AppContext as A, HadarsEntryModule as H, HadarsOptions as a, HadarsApp as b, HadarsGetClientProps as c, HadarsGetFinalProps as d, HadarsGetInitialProps as e, HadarsProps as f, HadarsRequest as g };
+export type { GraphQLExecutor as G, HadarsEntryModule as H, HadarsOptions as a, HadarsApp as b, HadarsGetClientProps as c, HadarsGetFinalProps as d, HadarsGetInitialProps as e, HadarsProps as f, HadarsRequest as g, HadarsSourceEntry as h, HadarsStaticContext as i };