sync

README.md

@@ -39,7 +39,9 @@ client
 - Fastify gateway
 - worker
 
-Gateway принимает `/images/{assetId}/v{version}/{preset}?w={width}&q={quality}&f=auto`, выбирает фактический формат по `Accept`, вызывает Backend ensure endpoint и кэширует готовые bytes в L1 memory cache.
+Gateway принимает managed assets через `/images/{assetId}/v{version}/{preset}?w={width}&q={quality}&f=auto`, выбирает фактический формат по `Accept`, вызывает Backend ensure endpoint и кэширует готовые bytes в L1 memory cache.
+
+Gateway также принимает remote source mode для `next/image`/`@unpic/react`: `/p/{project}/remote/{preset}?src={absoluteSourceUrl}&w={width}&q={quality}&f=auto`. В этом режиме source URL проходит allowlist-проверку и трансформируется через imgproxy без предварительной регистрации asset.
 
 ```bash
 cp .env.example .env
@@ -64,6 +66,7 @@ curl -sS -X POST http://localhost:3001/api/assets \
 
 curl -i "http://localhost:8888/images/asset_demo/v1/card?w=640&q=80&f=auto"
 curl -i "http://localhost:8888/images/asset_demo/v1/avatar?f=auto"
+curl -i "http://localhost:8888/p/demo/remote/card?src=https%3A%2F%2Fstorage.yandexcloud.net%2Fshared1318%2Fimg%2F1.jpg&w=640&q=80&f=auto"
 ```
 
 Сейчас доступны static presets из `packages/image-config`: `card`, `hero`, `avatar`. Произвольный single-image режим доступен через `/images/{assetId}/v{version}/custom?...`, если включён `IMAGE_ALLOW_CUSTOM_TRANSFORMS=true`.
@@ -108,3 +111,4 @@ curl -sS -X POST http://localhost:3001/api/assets/asset_demo/variants \
 - `docs/backend-contract-draft.md` - черновик будущего backend-контракта.
 - `docs/imgproxy-contract.md` - контракт с external imgproxy.
 - `docs/next-image-provider.md` - контракт custom provider для `next/image`.
+- `docs/unpic-react-provider.md` - контракт custom transformer для `@unpic/react`.