@fluixi/start 0.1.0-alpha.74 → 0.1.0-alpha.75

package/dist/index.d.ts

@@ -1,25 +1,45 @@
 /**
- * @fluixi/start — the Fluixi meta-framework.
+ * @fluixi/start: the Fluixi meta-framework.
  *
  * Packages the dev server, build, and production SSR server over @fluixi/server +
  * Vite, so apps stop hand-rolling server.mjs. Use the `fluixi` CLI (dev/build/start)
  * or call the commands programmatically.
+ *
+ * **This entry is safe to import from a browser bundle.** Everything that reads the
+ * filesystem, starts a server, or runs the bundler lives behind a subpath instead, and
+ * that is a rule rather than an accident: an app's client entry legitimately wants
+ * `addInterceptor`, and a root export that also carried the dev server put `node:fs`,
+ * `node:http` and esbuild into the page. Vite reports that as
+ * `"resolve" is not exported by "__vite-browser-external"`, from a line nobody wrote.
+ *
+ * What moved, and where it is now:
+ *
+ *   loadConfig, resolveConfig                     `@fluixi/start/config`
+ *   serveNode, createRequestHandler, and the
+ *     rest of the request layer                   `@fluixi/start/handler`
+ *   nodeAdapter, webAdapter, cloudflareAdapter,
+ *     netlifyAdapter, vercelAdapter,
+ *     createProdHandler, ssrBuildOptions          `@fluixi/start/adapter`
+ *   createImageHandler                            `@fluixi/start/image`
+ *   the dev/build/start commands                  `@fluixi/start/commands`
+ *
+ * `defineConfig` stays here, because a config file is the first thing an app writes and
+ * it is only a type-level helper.
  */
-export { defineConfig, resolveConfig, loadConfig } from './config.js';
+export { defineConfig } from './define-config.js';
 export type { FluixiConfig, ResolvedConfig } from './config.js';
 export { html, svg } from '@fluixi/core';
 export { injectApp, injectAppAndHead, splitTemplate } from './document.js';
-export { createRequestHandler, toNodeHandler, nodeToRequest, sendResponse, serveNode, streamDocument, withStaticFiles, } from './handler.js';
-export type { FetchHandler, RenderFn, StreamRenderFn, ServeNodeOptions } from './handler.js';
-export { createProdHandler, nodeAdapter, webAdapter, cloudflareAdapter, netlifyAdapter, vercelAdapter, ssrBuildOptions, } from './adapter.js';
-export type { Adapter, AdapterContext, AdapterBuildContext } from './adapter.js';
 export { createHandlerFrom } from './handler-core.js';
 export type { HandlerParts, ServerModule } from './handler-core.js';
 export { defineMiddleware, composeMiddleware, normalizeMiddleware } from './middleware.js';
 export type { Middleware, MiddlewareNext } from './middleware.js';
 export { addInterceptor, clearInterceptors, fetchWithInterceptors } from './interceptors.js';
 export type { Interceptor } from './interceptors.js';
-export { createImageHandler, imageLoader } from './image.js';
-export type { ImageHandlerOptions, ImageLoaderOptions, ImageTransform, ImageTransformArgs } from './image.js';
+export { imageLoader } from './image-loader.js';
+export type { ImageLoaderOptions } from './image-loader.js';
+export type { ImageHandlerOptions, ImageTransform, ImageTransformArgs } from './image.js';
 export { getRequestLocals, getLocals, type RequestLocals } from '@fluixi/server';
+export type { Adapter, AdapterContext, AdapterBuildContext } from './adapter.js';
+export type { FetchHandler, RenderFn, StreamRenderFn, ServeNodeOptions, } from './handler.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAOzC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,SAAS,EACT,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE7F,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAI9G,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIhE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGpE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIlE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAK1F,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGjF,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjF,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,32 +1,48 @@
 /**
- * @fluixi/start — the Fluixi meta-framework.
+ * @fluixi/start: the Fluixi meta-framework.
  *
  * Packages the dev server, build, and production SSR server over @fluixi/server +
  * Vite, so apps stop hand-rolling server.mjs. Use the `fluixi` CLI (dev/build/start)
  * or call the commands programmatically.
+ *
+ * **This entry is safe to import from a browser bundle.** Everything that reads the
+ * filesystem, starts a server, or runs the bundler lives behind a subpath instead, and
+ * that is a rule rather than an accident: an app's client entry legitimately wants
+ * `addInterceptor`, and a root export that also carried the dev server put `node:fs`,
+ * `node:http` and esbuild into the page. Vite reports that as
+ * `"resolve" is not exported by "__vite-browser-external"`, from a line nobody wrote.
+ *
+ * What moved, and where it is now:
+ *
+ *   loadConfig, resolveConfig                     `@fluixi/start/config`
+ *   serveNode, createRequestHandler, and the
+ *     rest of the request layer                   `@fluixi/start/handler`
+ *   nodeAdapter, webAdapter, cloudflareAdapter,
+ *     netlifyAdapter, vercelAdapter,
+ *     createProdHandler, ssrBuildOptions          `@fluixi/start/adapter`
+ *   createImageHandler                            `@fluixi/start/image`
+ *   the dev/build/start commands                  `@fluixi/start/commands`
+ *
+ * `defineConfig` stays here, because a config file is the first thing an app writes and
+ * it is only a type-level helper.
  */
-export { defineConfig, resolveConfig, loadConfig } from './config.js';
-// The html``/svg`` template tags — so a meta-framework app can author without JSX:
+// Config authoring. The loader is not here: it resolves and reads a file.
+export { defineConfig } from './define-config.js';
+// The html``/svg`` template tags, so a meta-framework app can author without JSX:
 // `import { html } from '@fluixi/start'`. Inert markers; the compiler lowers them.
 export { html, svg } from '@fluixi/core';
-// The commands live at `@fluixi/start/commands`. Re-exporting them here would put
-// the dev server and the bundler behind every runtime import of this package —
-// and a deploy adapter, which inlines everything its entry can reach, would carry
-// vite into a worker.
-// From the leaf, not internal.js: that one reaches the dev server's env loader,
-// and with it vite, which has no business in a runtime import of this package.
+// Document assembly: string work over a template, with nothing to read from disk.
 export { injectApp, injectAppAndHead, splitTemplate } from './document.js';
-// The runtime-neutral request layer — the seam adapters (edge/worker/Bun/Deno) build on.
-export { createRequestHandler, toNodeHandler, nodeToRequest, sendResponse, serveNode, streamDocument, withStaticFiles, } from './handler.js';
-// Deploy adapters: the portable prod handler + the node/web reference adapters.
-export { createProdHandler, nodeAdapter, webAdapter, cloudflareAdapter, netlifyAdapter, vercelAdapter, ssrBuildOptions, } from './adapter.js';
+// The handler's runtime-neutral core. The node/http half is behind `/handler`.
 export { createHandlerFrom } from './handler-core.js';
-// Request middleware — a `(request, next) => Response` chain run before render.
+// Request middleware: a `(request, next) => Response` chain run before render.
 export { defineMiddleware, composeMiddleware, normalizeMiddleware } from './middleware.js';
-// HTTP interceptors — request/response/error pipeline around fetch (server-fn RPC + app fetch).
+// HTTP interceptors: request/response/error pipeline around fetch (server-fn RPC + app
+// fetch). Client-side by nature, and the reason this entry has to stay importable.
 export { addInterceptor, clearInterceptors, fetchWithInterceptors } from './interceptors.js';
-export { createImageHandler, imageLoader } from './image.js';
+// Builds an image URL. The handler that serves it reads files, so it is behind `/image`.
+export { imageLoader } from './image-loader.js';
 // Middleware→render locals bridge: write `getRequestLocals(request).x = …` in middleware;
 // read it back in loaders/server-fns/render via getLocals() (the app entry forwards
-// `request` on the render event — `renderRequestAsync(App, { url, request })`).
+// `request` on the render event: `renderRequestAsync(App, { url, request })`).
 export { getRequestLocals, getLocals } from '@fluixi/server';