@onreza/adapter-nitro 0.2.0

package/README.md

@@ -0,0 +1,144 @@
+# @onreza/adapter-nitro
+
+Nitro preset ONREZA для развёртывания [Nuxt](https://nuxt.com), [Analog](https://analogjs.org), [Vinxi](https://vinxi.vercel.app) и standalone [Nitro](https://nitro.build) приложений на платформе ONREZA с поддержкой SSR, hybrid mode, prerendering и ISR.
+
+## Установка
+
+```bash
+npm add @onreza/adapter-nitro
+bun add @onreza/adapter-nitro
+```
+
+## Использование
+
+### Nuxt
+
+```ts
+// nuxt.config.ts
+export default defineNuxtConfig({
+  nitro: {
+    preset: "@onreza/adapter-nitro",
+  },
+});
+```
+
+### Standalone Nitro
+
+```ts
+// nitro.config.ts
+export default defineNitroConfig({
+  preset: "@onreza/adapter-nitro",
+});
+```
+
+### Analog
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import analog from "@analogjs/platform";
+
+export default defineConfig({
+  plugins: [
+    analog({
+      nitro: { preset: "@onreza/adapter-nitro" },
+    }),
+  ],
+});
+```
+
+## Конфигурация
+
+Конфигурация выполняется через стандартные механизмы Nitro — `routeRules`:
+
+```ts
+// nuxt.config.ts или nitro.config.ts
+export default defineNuxtConfig({
+  routeRules: {
+    "/blog/**": { isr: 60 },      // ISR с 60 сек ревалидацией
+    "/about": { prerender: true }, // Static prerender
+    "/api/**": { cors: true },     // CORS для API
+  },
+  nitro: {
+    preset: "@onreza/adapter-nitro",
+  },
+});
+```
+
+### `routeRules.isr`
+
+Включает Incremental Static Regeneration для указанных маршрутов.
+
+| Значение | Описание |
+|----------|----------|
+| `number` | Время ревалидации в секундах |
+| `true` | ISR с дефолтным временем (60 сек) |
+| `{ expiration: number }` | Vercel-совместимый формат |
+
+### `routeRules.swr`
+
+Альтернатива `isr` — Stale-While-Revalidate с аналогичным синтаксисом.
+
+### `routeRules.prerender`
+
+`true` — страница будет отрендерена при сборке и раздаваться как static.
+
+## Поддерживаемые возможности
+
+| Возможность | Статус |
+|-------------|--------|
+| SSR | Поддерживается |
+| Hybrid output | Поддерживается |
+| Static prerender | Поддерживается |
+| API Routes | Поддерживается |
+| ISR / SWR | Поддерживается |
+| Environment Variables | Поддерживается |
+| routeRules | Поддерживается |
+| Nuxt 3 | Поддерживается |
+| Analog | Поддерживается |
+| Standalone Nitro | Поддерживается |
+| Nuxt Server Components | В планах |
+| Image Optimization | В планах |
+
+## Build output
+
+После сборки адаптер генерирует:
+
+```
+.output/
+├── .onreza/
+│   └── manifest.json      # Метаданные билда
+├── server/
+│   └── entry.mjs          # Server handler (fetch контракт)
+├── client/                # Static assets (Nuxt: public/)
+│   └── _nuxt/
+└── prerender/             # Prerendered HTML (опционально)
+```
+
+## Ограничения
+
+ONREZA использует edge runtime (V8 isolate) без доступа к `node_modules`. Это означает:
+
+| Ограничение | Причина | Альтернатива |
+|-------------|---------|--------------|
+| Native модули (Prisma, Sharp, bcrypt) | Нет бинарников в edge | HTTP-based драйверы, внешние API |
+| `fs`, `child_process` | Нет файловой системы | Fetch к API, S3 |
+| Long-running процессы | Таймаут 30 сек | Webhook-based архитектура |
+
+Для работы с базой данных используйте HTTP-драйверы:
+- `@neondatabase/serverless` (Neon)
+- `@planetscale/database` (PlanetScale)
+- Drizzle/Kysely с HTTP адаптерами
+
+## Совместимость
+
+- Nitro >= 2.0.0
+- Nuxt >= 3.0.0
+
+## Документация
+
+[docs.onreza.ru/adapters/nitro](https://docs.onreza.ru/adapters/nitro)
+
+## Лицензия
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { ApiRoute, IsrRoute, OnrezaManifest, Route, RoutePriority, RouteType, SsrRoute, StaticRoute, } from "@onreza/shared";
+export { default } from "./preset/preset.ts";
+export { collectRoutes, routeToRegex } from "./routes.ts";
+export type { NitroPrerenderedRoute, NitroRouteRules, NitroScannedHandler, OnrezaRoute, } from "./types.ts";

package/dist/index.js

@@ -0,0 +1 @@
+import{fileURLToPath as V}from"node:url";import{readFile as _}from"node:fs/promises";import{createRequire as L}from"node:module";import{fileURLToPath as O}from"node:url";import{generateManifest as b,writeManifest as w}from"@onreza/shared";var q={pattern:"^/_nuxt/.*$",priority:100,type:"static"},M={pattern:"^/.*$",priority:0,type:"ssr"};function H(B){return B.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function F(B){let D=B;return D=D.replace(/\*\*/g,"\x00DOUBLE_STAR\x00"),D=D.replace(/\*/g,"\x00SINGLE_STAR\x00"),D=D.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g,"\x00PARAM_$1\x00"),D=H(D),D=D.replace(new RegExp(H("\x00DOUBLE_STAR\x00"),"g"),".*"),D=D.replace(new RegExp(H("\x00SINGLE_STAR\x00"),"g"),"[^/]*"),D=D.replace(new RegExp(`${H("\x00PARAM_")}([a-zA-Z_][a-zA-Z0-9_]*)${H("\x00")}`,"g"),"([^/]+)"),`^${D}/?$`}function N(B){return B.startsWith("/api/")||B==="/api"}function Z(B){if(B===void 0||B===null||B===!1)return null;if(typeof B==="number")return B;if(B===!0)return 60;if(typeof B==="object"&&"expiration"in B&&typeof B.expiration==="number")return B.expiration;return null}function z(B,K){if(K[B]){let Q=K[B],X=Z(Q.isr);if(X!==null)return{revalidate:X};let Y=Z(Q.swr);if(Y!==null)return{revalidate:Y}}for(let[Q,X]of Object.entries(K))if(Q.includes("*")||Q.includes(":")){if(new RegExp(F(Q)).test(B)){let D=Z(X.isr);if(D!==null)return{revalidate:D};let j=Z(X.swr);if(j!==null)return{revalidate:j}}}return null}function U(B,K){if(K[B]?.prerender===!0)return!0;for(let[Q,X]of Object.entries(K))if(X.prerender===!0&&(Q.includes("*")||Q.includes(":"))){if(new RegExp(F(Q)).test(B))return!0}return!1}function y(B){let{handlers:K,prerenderedRoutes:Q=[],routeRules:X}=B,Y=[{...q}],D=new Set,j=!1;for(let $ of Q){if($.skip||$.error)continue;let W=$.route;D.add(W);let G=z(W,X);if(G)Y.push({pattern:F(W),priority:30,revalidate:G.revalidate,src:W,type:"isr"});else Y.push({pattern:F(W),priority:50,src:W,type:"static"})}for(let $ of K){if($.middleware)continue;if(D.has($.route))continue;let W=$.route;if(U(W,X)){let G=z(W,X);if(G)Y.push({pattern:F(W),priority:30,revalidate:G.revalidate,src:W,type:"isr"});else Y.push({pattern:F(W),priority:50,src:W,type:"static"});D.add(W);continue}if(N(W)){j=!0,Y.push({pattern:F(W),priority:20,src:W,type:"api"}),D.add(W);continue}j=!0,D.add(W)}if(j)Y.push({...M});return Y.sort(($,W)=>W.priority-$.priority)}function I(B,K){try{return JSON.parse(B)}catch(Q){throw Error(`Failed to parse ${K}`,{cause:Q})}}async function E(){let B=O(new URL("../../package.json",import.meta.url)),K=await _(B,"utf-8");return I(K,B).version}function k(){let B=L(import.meta.url),K=B.resolve("nitropack/package.json"),X=B("node:fs").readFileSync(K,"utf-8");return I(X,K).version}function A(B){let K=[];for(let Q of B){if(Q.skip||Q.error)continue;if(Q.fileName?.endsWith(".html"))K.push(Q.fileName)}return K}async function J(B){let K=B.scannedHandlers,Q=B._prerenderedRoutes??[],X=B.options.routeRules??{},Y=y({handlers:K,prerenderedRoutes:Q,routeRules:X}),D=A(Q),j=await E(),$=k(),W=b({adapterName:"@onreza/adapter-nitro",adapterVersion:j,frameworkName:"nitro",frameworkVersion:$,prerenderPages:D.length>0?D:void 0,routes:Y});await w(B.options.output.dir,W)}function C(B,K){if(K?.url&&typeof B!=="function"&&B.entry&&typeof B.entry==="string"&&B.entry.startsWith("."))B.entry=V(new URL(B.entry,K.url));return{...B,_meta:K}}var S=C({entry:"./entry",exportConditions:["worker"],hooks:{async compiled(B){await J(B),console.log("[onreza] Generated .onreza/manifest.json")}},output:{publicDir:"{{ output.dir }}/client",serverDir:"{{ output.dir }}/server"},rollupConfig:{output:{entryFileNames:"entry.mjs",format:"esm"}}},{name:"@onreza/adapter-nitro",url:import.meta.url});export{F as routeToRegex,S as default,y as collectRoutes};

package/dist/manifest.d.ts

@@ -0,0 +1,2 @@
+import type { Nitro } from "nitropack";
+export declare function generateOnrezaManifest(nitro: Nitro): Promise<void>;

package/dist/preset/entry.d.ts

@@ -0,0 +1,5 @@
+import "#nitro-internal-pollyfills";
+declare const _default: {
+    fetch(request: Request): Promise<Response>;
+};
+export default _default;

package/dist/preset/entry.js

@@ -0,0 +1 @@
+import"#nitro-internal-pollyfills";import{toWebHandler as C}from"h3";import{useNitroApp as F}from"nitropack/runtime";var G=F(),I=C(G.h3App),B=globalThis.ONREZA?.env;if(B)for(let[j,w]of B.entries())process.env[j]=w;var M={async fetch(j){try{return await I(j)}catch(w){return console.error("[onreza] nitro error:",w),new Response("Internal Server Error",{status:500})}}};export{M as default};

package/dist/preset/preset.d.ts

@@ -0,0 +1,17 @@
+import type { NitroPreset } from "nitropack";
+/**
+ * Preset metadata type (from nitropack/kit)
+ */
+interface NitroPresetMeta {
+    name?: string;
+    stdName?: string;
+    url?: string;
+}
+/**
+ * Extended preset type with internal _meta field
+ */
+type NitroPresetWithMeta = NitroPreset & {
+    _meta?: NitroPresetMeta;
+};
+declare const _default: NitroPresetWithMeta;
+export default _default;

package/dist/preset/preset.js

@@ -0,0 +1 @@
+import{fileURLToPath as V}from"node:url";import{readFile as U}from"node:fs/promises";import{createRequire as _}from"node:module";import{fileURLToPath as L}from"node:url";import{generateManifest as O,writeManifest as b}from"@onreza/shared";var q={pattern:"^/_nuxt/.*$",priority:100,type:"static"},E={pattern:"^/.*$",priority:0,type:"ssr"};function G(B){return B.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function y(B){let D=B;return D=D.replace(/\*\*/g,"\x00DOUBLE_STAR\x00"),D=D.replace(/\*/g,"\x00SINGLE_STAR\x00"),D=D.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g,"\x00PARAM_$1\x00"),D=G(D),D=D.replace(new RegExp(G("\x00DOUBLE_STAR\x00"),"g"),".*"),D=D.replace(new RegExp(G("\x00SINGLE_STAR\x00"),"g"),"[^/]*"),D=D.replace(new RegExp(`${G("\x00PARAM_")}([a-zA-Z_][a-zA-Z0-9_]*)${G("\x00")}`,"g"),"([^/]+)"),`^${D}/?$`}function M(B){return B.startsWith("/api/")||B==="/api"}function H(B){if(B===void 0||B===null||B===!1)return null;if(typeof B==="number")return B;if(B===!0)return 60;if(typeof B==="object"&&"expiration"in B&&typeof B.expiration==="number")return B.expiration;return null}function Z(B,K){if(K[B]){let Q=K[B],X=H(Q.isr);if(X!==null)return{revalidate:X};let Y=H(Q.swr);if(Y!==null)return{revalidate:Y}}for(let[Q,X]of Object.entries(K))if(Q.includes("*")||Q.includes(":")){if(new RegExp(y(Q)).test(B)){let D=H(X.isr);if(D!==null)return{revalidate:D};let j=H(X.swr);if(j!==null)return{revalidate:j}}}return null}function N(B,K){if(K[B]?.prerender===!0)return!0;for(let[Q,X]of Object.entries(K))if(X.prerender===!0&&(Q.includes("*")||Q.includes(":"))){if(new RegExp(y(Q)).test(B))return!0}return!1}function z(B){let{handlers:K,prerenderedRoutes:Q=[],routeRules:X}=B,Y=[{...q}],D=new Set,j=!1;for(let $ of Q){if($.skip||$.error)continue;let W=$.route;D.add(W);let F=Z(W,X);if(F)Y.push({pattern:y(W),priority:30,revalidate:F.revalidate,src:W,type:"isr"});else Y.push({pattern:y(W),priority:50,src:W,type:"static"})}for(let $ of K){if($.middleware)continue;if(D.has($.route))continue;let W=$.route;if(N(W,X)){let F=Z(W,X);if(F)Y.push({pattern:y(W),priority:30,revalidate:F.revalidate,src:W,type:"isr"});else Y.push({pattern:y(W),priority:50,src:W,type:"static"});D.add(W);continue}if(M(W)){j=!0,Y.push({pattern:y(W),priority:20,src:W,type:"api"}),D.add(W);continue}j=!0,D.add(W)}if(j)Y.push({...E});return Y.sort(($,W)=>W.priority-$.priority)}function I(B,K){try{return JSON.parse(B)}catch(Q){throw Error(`Failed to parse ${K}`,{cause:Q})}}async function w(){let B=L(new URL("../../package.json",import.meta.url)),K=await U(B,"utf-8");return I(K,B).version}function k(){let B=_(import.meta.url),K=B.resolve("nitropack/package.json"),X=B("node:fs").readFileSync(K,"utf-8");return I(X,K).version}function A(B){let K=[];for(let Q of B){if(Q.skip||Q.error)continue;if(Q.fileName?.endsWith(".html"))K.push(Q.fileName)}return K}async function J(B){let K=B.scannedHandlers,Q=B._prerenderedRoutes??[],X=B.options.routeRules??{},Y=z({handlers:K,prerenderedRoutes:Q,routeRules:X}),D=A(Q),j=await w(),$=k(),W=O({adapterName:"@onreza/adapter-nitro",adapterVersion:j,frameworkName:"nitro",frameworkVersion:$,prerenderPages:D.length>0?D:void 0,routes:Y});await b(B.options.output.dir,W)}function C(B,K){if(K?.url&&typeof B!=="function"&&B.entry&&typeof B.entry==="string"&&B.entry.startsWith("."))B.entry=V(new URL(B.entry,K.url));return{...B,_meta:K}}var g=C({entry:"./entry",exportConditions:["worker"],hooks:{async compiled(B){await J(B),console.log("[onreza] Generated .onreza/manifest.json")}},output:{publicDir:"{{ output.dir }}/client",serverDir:"{{ output.dir }}/server"},rollupConfig:{output:{entryFileNames:"entry.mjs",format:"esm"}}},{name:"@onreza/adapter-nitro",url:import.meta.url});export{g as default};

package/dist/routes.d.ts

@@ -0,0 +1,11 @@
+import type { Route } from "@onreza/shared";
+import type { NitroRouteConfig } from "nitropack";
+import type { NitroPrerenderedRoute, NitroScannedHandler } from "./types.ts";
+declare function routeToRegex(route: string): string;
+export interface CollectRoutesParams {
+    handlers: NitroScannedHandler[];
+    prerenderedRoutes?: NitroPrerenderedRoute[];
+    routeRules: Record<string, NitroRouteConfig>;
+}
+export declare function collectRoutes(params: CollectRoutesParams): Route[];
+export { routeToRegex };

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+import type { NitroRouteConfig } from "nitropack";
+export interface NitroScannedHandler {
+    handler: string;
+    lazy?: boolean;
+    method?: string;
+    middleware?: boolean;
+    route: string;
+}
+export interface NitroPrerenderedRoute {
+    contentType?: string;
+    contents?: string;
+    data?: unknown;
+    error?: Error;
+    fileName?: string;
+    generateTimeMS?: number;
+    route: string;
+    skip?: boolean;
+}
+export type NitroRouteRules = Record<string, NitroRouteConfig>;
+export interface OnrezaRoute {
+    pattern: string;
+    priority: number;
+    revalidate?: number;
+    src?: string;
+    type: "static" | "ssr" | "api" | "isr";
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@onreza/adapter-nitro",
+  "version": "0.2.0",
+  "description": "ONREZA Nitro adapter for Nuxt, Analog, Vinxi and standalone Nitro",
+  "license": "MIT",
+  "author": "ONREZA OSS <opensource@onreza.ru>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/preset/preset.js",
+      "types": "./dist/preset/preset.d.ts"
+    },
+    "./types": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "keywords": ["nitro-preset", "nuxt", "analog", "vinxi", "onreza"],
+  "scripts": {
+    "build": "bun build.ts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "nitropack": "^2"
+  },
+  "devDependencies": {
+    "@onreza/shared": "0.0.0",
+    "h3": "^1.15.3",
+    "nitropack": "^2.11.12"
+  }
+}