@onreza/adapter-nitro 0.2.2 → 0.3.0

package/README.md

@@ -102,17 +102,56 @@ export default defineNuxtConfig({
 
 ## Build output
 
-После сборки адаптер генерирует:
+После сборки адаптер генерирует структуру, совместимую с [ONREZA Build Output Specification](https://github.com/onreza/platform/blob/main/docs/architecture/BUILD_OUTPUT_SPEC.md):
 
 ```
 .output/
 ├── .onreza/
-│   └── manifest.json      # Метаданные билда
+│   └── manifest.json      # Метаданные билда (версия 1)
 ├── server/
-│   └── entry.mjs          # Server handler (fetch контракт)
-├── client/                # Static assets (Nuxt: public/)
-│   └── _nuxt/
+│   └── entry.mjs          # Server handler (Web fetch контракт)
+├── client/                # Static assets
+│   └── _nuxt/             # Nuxt assets (или _assets/ для Nitro)
 └── prerender/             # Prerendered HTML (опционально)
+    └── about/
+        └── index.html
+```
+
+### Формат manifest.json
+
+Адаптер генерирует манифест версии 1:
+
+```json
+{
+  "version": 1,
+  "adapter": {
+    "name": "@onreza/adapter-nitro",
+    "version": "0.2.1"
+  },
+  "framework": {
+    "name": "nuxt",
+    "version": "3.17.0"
+  },
+  "server": {
+    "entry": "server/entry.mjs",
+    "export": "fetch"
+  },
+  "assets": {
+    "directory": "client",
+    "prefix": "/_nuxt/"
+  },
+  "routes": [
+    { "pattern": "^/_nuxt/.*$", "type": "static", "priority": 100 },
+    { "pattern": "^/api/.*$", "type": "api", "priority": 20 },
+    { "pattern": "^/.*$", "type": "ssr", "priority": 0 }
+  ],
+  "prerender": {
+    "directory": "prerender",
+    "pages": {
+      "/about": { "html": "about/index.html" }
+    }
+  }
+}
 ```
 
 ## Ограничения

package/dist/image/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @onreza/adapter-nitro/image
+ *
+ * Nuxt Image Provider for ONREZA platform image optimization.
+ *
+ * @example
+ * ```ts
+ * // nuxt.config.ts
+ * export default defineNuxtConfig({
+ *   modules: ['@nuxt/image'],
+ *   image: {
+ *     provider: 'onreza',
+ *     providers: {
+ *       onreza: {
+ *         provider: '@onreza/adapter-nitro/image',
+ *         options: {
+ *           sizes: [640, 750, 828, 1080, 1200, 1920],
+ *           quality: 80,
+ *         }
+ *       }
+ *     }
+ *   },
+ *   nitro: {
+ *     preset: '@onreza/adapter-nitro'
+ *   }
+ * });
+ * ```
+ */
+export type { ImageModifiers, OnrezaImageProviderOptions } from "./provider.ts";
+export { createOnrezaImageProvider, default, generateOnrezaImageURL } from "./provider.ts";

package/dist/image/index.js

@@ -0,0 +1 @@
+var J=Object.defineProperty;var X=(x,N)=>{for(var g in N)J(x,g,{get:N[g],enumerable:!0,configurable:!0,set:(R)=>N[g]=()=>R})};var K=[640,750,828,1080,1200,1920,2048,3840];function P(x,N){if(x===void 0)return;if(N.length===0)return console.warn("[onreza:image] No allowed sizes configured, using width as-is"),x;return N.reduce((R,j)=>Math.abs(j-x)<Math.abs(R-x)?j:R)}function V(x){if(!x)return;return{contain:"contain",cover:"cover",fill:"fill",inside:"contain",outside:"cover"}[x]}function G(x,N,g){let R=N.sizes??K,j=N.quality??75;if(x.startsWith("http://")||x.startsWith("https://")||x.startsWith("//"))console.warn(`[onreza:image] External URL detected: "${x}". Platform will validate against allowed domains at runtime.`);if(x.includes("..")||x.includes("%2e")||x.includes("%2E"))throw Error(`[onreza:image] Path traversal detected in src: "${x}"`);let M=new URLSearchParams;if(M.set("url",x),g.width!==void 0){let C=P(g.width,R);if(C!==void 0){if(M.set("w",C.toString()),C!==g.width)console.warn(`[onreza:image] Width ${g.width}px is not in allowed sizes. Using closest: ${C}px.`)}}if(g.height!==void 0)M.set("h",g.height.toString());let k=g.quality??j;if(k<1||k>100)console.warn(`[onreza:image] Quality ${k} is out of range (1-100). Using default: ${j}`),k=j;if(M.set("q",k.toString()),g.format!==void 0){if(!["webp","avif","jpg","jpeg","png","gif"].includes(g.format))console.warn(`[onreza:image] Format "${g.format}" may not be supported. Using as-is.`);M.set("f",g.format)}let n=V(g.fit);if(n!==void 0)M.set("fit",n);if(g.position!==void 0&&!g.fit){let B={bottom:"cover",center:"cover",entropy:"cover",left:"cover",right:"cover",top:"cover"}[g.position];if(B)M.set("fit",B)}if(g.blur!==void 0){let C=Math.max(0,Math.min(250,g.blur));if(C>0)M.set("blur",C.toString())}if(g.dpr!==void 0&&typeof g.dpr==="number"){let C=Math.max(1,Math.min(5,g.dpr));M.set("dpr",C.toString())}return`/_onreza/image?${M.toString()}`}function H(x={}){return{getImage:(N,g)=>{return{url:G(N,x,g)}},name:"onreza"}}function I(x={}){return H(x)}export{G as generateOnrezaImageURL,I as default,H as createOnrezaImageProvider};

package/dist/image/provider.d.ts

@@ -0,0 +1,107 @@
+/**
+ * ONREZA Image Provider for Nuxt/Nitro
+ *
+ * Integration with @nuxt/image for platform image optimization.
+ * Images are optimized at runtime via /_onreza/image endpoint.
+ *
+ * @example
+ * ```ts
+ * // nuxt.config.ts
+ * export default defineNuxtConfig({
+ *   modules: ['@nuxt/image'],
+ *   image: {
+ *     provider: 'onreza',
+ *     providers: {
+ *       onreza: {
+ *         provider: '@onreza/adapter-nitro/image',
+ *         options: {
+ *           // Optional: restrict sizes
+ *           sizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840],
+ *           // Optional: default quality
+ *           quality: 75,
+ *         }
+ *       }
+ *     }
+ *   },
+ *   nitro: {
+ *     preset: '@onreza/adapter-nitro'
+ *   }
+ * });
+ * ```
+ */
+/**
+ * Provider configuration options
+ */
+export interface OnrezaImageProviderOptions {
+    /** Allowed image widths (defaults to platform preset) */
+    sizes?: number[];
+    /** Default quality (1-100, default: 75) */
+    quality?: number;
+}
+/**
+ * Image modifiers from @nuxt/image
+ */
+export interface ImageModifiers {
+    width?: number;
+    height?: number;
+    quality?: number;
+    format?: string;
+    fit?: "cover" | "contain" | "fill" | "inside" | "outside";
+    position?: string;
+    blur?: number;
+    [q: string]: unknown;
+}
+/**
+ * Generate optimized image URL for ONREZA platform
+ *
+ * @param src - Source image path
+ * @param options - Provider options
+ * @param modifiers - Image transformation modifiers
+ * @returns Optimized image URL
+ */
+export declare function generateOnrezaImageURL(src: string, options: OnrezaImageProviderOptions, modifiers: ImageModifiers): string;
+/**
+ * Nuxt Image Provider for ONREZA
+ *
+ * @param providerOptions - Provider configuration from nuxt.config
+ * @returns Provider object with getImage method
+ *
+ * @example
+ * ```ts
+ * // Usage in Nuxt component
+ * <NuxtImg
+ *   src="/images/hero.jpg"
+ *   width="1080"
+ *   quality="80"
+ *   format="webp"
+ * />
+ * ```
+ */
+export declare function createOnrezaImageProvider(providerOptions?: OnrezaImageProviderOptions): {
+    getImage: (src: string, modifiers: ImageModifiers) => {
+        url: string;
+    };
+    name: string;
+};
+/**
+ * Default provider export for @nuxt/image
+ *
+ * Usage in nuxt.config.ts:
+ * ```ts
+ * image: {
+ *   provider: 'onreza',
+ *   providers: {
+ *     onreza: {
+ *       provider: '@onreza/adapter-nitro/image',
+ *       options: { quality: 80 }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export default function onrezaProvider(providerOptions?: OnrezaImageProviderOptions): {
+    getImage: (src: string, modifiers: ImageModifiers) => {
+        url: string;
+    };
+    name: string;
+};

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { ApiRoute, IsrRoute, OnrezaManifest, Route, RoutePriority, RouteType, SsrRoute, StaticRoute, } from "@onreza/shared";
+export type { ApiRoute, EdgeFunctionRoute, FrameworkFeatures, ImageOptimizationConfig, IsrRoute, OnrezaManifest, PlatformBindings, Route, RoutePriority, RouteType, SessionConfig, SkewProtectionConfig, 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";
+export type { OnrezaRoute } from "./types.ts";