@nocode-factory/sanity-kit 2.1.1 → 2.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +6 -1
- package/dist/index.js +34 -3
- package/dist/index.js.map +1 -1
- package/dist/web-server.d.ts +11 -0
- package/dist/web-server.js +25 -5
- package/dist/web-server.js.map +1 -1
- package/package.json +1 -1
- package/src/config/resolve.ts +49 -2
- package/src/config/types.ts +5 -0
- package/src/version.ts +1 -1
- package/src/web/previewGrant.ts +27 -4
- package/src/web/server.ts +8 -1
package/dist/web-server.d.ts
CHANGED
|
@@ -81,5 +81,16 @@ export declare function hasPreviewGrant(endpoint?: string): Promise<boolean>;
|
|
|
81
81
|
* Rend `null` quand la requête peut suivre son cours.
|
|
82
82
|
*/
|
|
83
83
|
export declare function ncfPreviewGuard(request: NextRequest, options?: PreviewGuardOptions): Promise<NextResponse | null>;
|
|
84
|
+
/**
|
|
85
|
+
* En-têtes posés sur toute réponse de préversion.
|
|
86
|
+
*
|
|
87
|
+
* Une préproduction ne doit jamais être indexée : elle porte du contenu non
|
|
88
|
+
* publié et doublerait le site public en résultats de recherche. Le refus
|
|
89
|
+
* d'accès n'y suffit pas — un moteur peut avoir vu l'URL ailleurs, et une
|
|
90
|
+
* page de refus indexée reste une page indexée.
|
|
91
|
+
*/
|
|
92
|
+
export declare const NOINDEX_HEADERS: {
|
|
93
|
+
'x-robots-tag': string;
|
|
94
|
+
};
|
|
84
95
|
export type { DraftModeToggleOptions, PreviewGuardOptions };
|
|
85
96
|
//# sourceMappingURL=web-server.d.ts.map
|
package/dist/web-server.js
CHANGED
|
@@ -103,7 +103,7 @@ async function ncfPreviewGuard(request, options = {}) {
|
|
|
103
103
|
if (!await checkGrant(fromUrl, endpoint)) return refuse(request);
|
|
104
104
|
let clean = request.nextUrl.clone();
|
|
105
105
|
clean.searchParams.delete(GRANT_PARAM);
|
|
106
|
-
let response = NextResponse.redirect(clean);
|
|
106
|
+
let response = NextResponse.redirect(clean, { headers: NOINDEX_HEADERS });
|
|
107
107
|
return response.cookies.set(GRANT_COOKIE, fromUrl, {
|
|
108
108
|
httpOnly: !0,
|
|
109
109
|
sameSite: "lax",
|
|
@@ -113,9 +113,23 @@ async function ncfPreviewGuard(request, options = {}) {
|
|
|
113
113
|
}), response;
|
|
114
114
|
}
|
|
115
115
|
let fromCookie = request.cookies.get(GRANT_COOKIE)?.value;
|
|
116
|
-
|
|
116
|
+
if (fromCookie && await checkGrant(fromCookie, endpoint)) {
|
|
117
|
+
let response = NextResponse.next();
|
|
118
|
+
for (let [key, value] of Object.entries(NOINDEX_HEADERS)) response.headers.set(key, value);
|
|
119
|
+
return response;
|
|
120
|
+
}
|
|
121
|
+
return refuse(request);
|
|
117
122
|
}
|
|
118
123
|
/**
|
|
124
|
+
* En-têtes posés sur toute réponse de préversion.
|
|
125
|
+
*
|
|
126
|
+
* Une préproduction ne doit jamais être indexée : elle porte du contenu non
|
|
127
|
+
* publié et doublerait le site public en résultats de recherche. Le refus
|
|
128
|
+
* d'accès n'y suffit pas — un moteur peut avoir vu l'URL ailleurs, et une
|
|
129
|
+
* page de refus indexée reste une page indexée.
|
|
130
|
+
*/
|
|
131
|
+
const NOINDEX_HEADERS = { "x-robots-tag": "noindex, nofollow, noarchive, nosnippet" };
|
|
132
|
+
/**
|
|
119
133
|
* Refus explicite, en texte clair.
|
|
120
134
|
*
|
|
121
135
|
* Ni redirection ni page blanche : quelqu'un qui tombe là doit comprendre
|
|
@@ -124,10 +138,16 @@ async function ncfPreviewGuard(request, options = {}) {
|
|
|
124
138
|
function refuse(request) {
|
|
125
139
|
return (request.headers.get("accept") ?? "").includes("text/html") ? new NextResponse(PAGE, {
|
|
126
140
|
status: 401,
|
|
127
|
-
headers: {
|
|
128
|
-
|
|
141
|
+
headers: {
|
|
142
|
+
...NOINDEX_HEADERS,
|
|
143
|
+
"content-type": "text/html; charset=utf-8"
|
|
144
|
+
}
|
|
145
|
+
}) : NextResponse.json({ error: "preview_grant_required" }, {
|
|
146
|
+
status: 401,
|
|
147
|
+
headers: NOINDEX_HEADERS
|
|
148
|
+
});
|
|
129
149
|
}
|
|
130
150
|
const PAGE = "<!doctype html>\n<html lang=\"fr\"><head><meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"robots\" content=\"noindex\">\n<title>Préversion privée</title></head>\n<body style=\"margin:0;min-height:100vh;display:grid;place-items:center;background:#faf9f7;color:#1c1917;font:16px/1.6 ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif\">\n<main style=\"max-width:30rem;padding:2rem;text-align:center\">\n<p style=\"display:inline-flex;align-items:center;gap:.5rem;margin:0 0 1.25rem;padding:.3rem .75rem;border-radius:999px;background:#fef3c7;color:#451a03;font-size:.8125rem;font-weight:500\">\n<span style=\"width:7px;height:7px;border-radius:50%;background:#d97706\"></span>Préversion</p>\n<h1 style=\"margin:0 0 .75rem;font-size:1.375rem;font-weight:600\">Cette version du site est privée</h1>\n<p style=\"margin:0;color:#57534e\">Elle sert à relire des contenus avant leur mise en ligne. Pour y accéder, demandez un lien de partage à votre interlocuteur chez NoCode Factory.</p>\n</main></body></html>";
|
|
131
|
-
export { GRANT_COOKIE, GRANT_PARAM, checkGrant, hasPreviewGrant, isPreviewSite, isProductionSite, ncfDraftModeToggle, ncfPreviewGuard };
|
|
151
|
+
export { GRANT_COOKIE, GRANT_PARAM, NOINDEX_HEADERS, checkGrant, hasPreviewGrant, isPreviewSite, isProductionSite, ncfDraftModeToggle, ncfPreviewGuard };
|
|
132
152
|
|
|
133
153
|
//# sourceMappingURL=web-server.js.map
|
package/dist/web-server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"web-server.js","names":[],"sources":["../src/web/environment.ts","../src/web/draftModeToggle.ts","../src/web/previewGrant.ts"],"sourcesContent":["/**\n * Outils destinés au **front** d'un site, pas au Studio.\n *\n * Ce point d'entrée n'importe ni `sanity` ni `@sanity/ui` : un site qui\n * l'utilise n'embarque pas le Studio dans son bundle.\n */\n\n/**\n * Vrai sur le déploiement public du site.\n *\n * `VERCEL_ENV` plutôt qu'une comparaison d'URL : un alias, un domaine ajouté\n * plus tard ou une préversion nommée comme la production feraient mentir la\n * seconde. Hors Vercel, on considère qu'on n'est pas en production — un\n * environnement inconnu mérite le bandeau plutôt que le silence.\n */\nexport function isProductionSite(): boolean {\n return process.env.VERCEL_ENV === 'production'\n}\n\n/** L'inverse, pour se lire à l'endroit dans un layout. */\nexport const isPreviewSite = (): boolean => !isProductionSite()\n","import {draftMode} from 'next/headers'\nimport {NextResponse} from 'next/server'\nimport {isProductionSite} from './environment'\n\nexport interface DraftModeToggleOptions {\n /**\n * Chemin de repli après la bascule, quand la page d'origine est inconnue.\n * Défaut : la racine.\n */\n fallbackPath?: string\n}\n\n/**\n * Route qui bascule le mode brouillon depuis le site.\n *\n * ```ts\n * // app/api/draft-mode/toggle/route.ts\n * export const {GET} = ncfDraftModeToggle()\n * ```\n *\n * **Refusée en production.** Activer le mode brouillon rend le contenu non\n * publié visible à qui atteint l'URL : acceptable sur une préversion, jamais\n * sur le site public. Ce refus est le seul garde-fou du dispositif — il ne\n * dépend d'aucune configuration, et se trompe du bon côté.\n *\n * La route de Sanity, `defineEnableDraftMode`, reste préférable quand on entre\n * par Presentation : elle vérifie un secret lié à la session de l'éditeur.\n * Celle-ci sert le cas où l'on est déjà sur le site, sans Studio.\n */\nexport function ncfDraftModeToggle(options: DraftModeToggleOptions = {}) {\n const fallback = options.fallbackPath ?? '/'\n\n return {\n async GET(request: Request): Promise<Response> {\n if (isProductionSite()) {\n return NextResponse.json(\n {error: 'Le mode brouillon est désactivé en production.'},\n {status: 403},\n )\n }\n\n const url = new URL(request.url)\n const draft = await draftMode()\n\n if (url.searchParams.get('enable') === 'false') draft.disable()\n else draft.enable()\n\n // On revient d'où l'on vient : basculer les données ne doit pas faire\n // perdre sa place au relecteur. Un chemin relatif seulement — une URL\n // absolue ferait de cette route une redirection ouverte.\n const back = url.searchParams.get('redirect')\n const target = back && back.startsWith('/') && !back.startsWith('//') ? back : fallback\n return NextResponse.redirect(new URL(target, request.url))\n },\n }\n}\n","import {cookies} from 'next/headers'\nimport {NextResponse, type NextRequest} from 'next/server'\n\n/** Paramètre d'URL porteur du laissez-passer, et cookie qui le mémorise. */\nexport const GRANT_PARAM = 'ncf_preview'\nexport const GRANT_COOKIE = 'ncf_preview_grant'\n\nconst DEFAULT_ENDPOINT = 'https://dkoxgivytgsmvqmjvmjt.supabase.co/functions/v1'\n\nexport interface PreviewGuardOptions {\n /** Base des Edge Functions du kit. */\n endpoint?: string\n /** Chemins toujours ouverts, en plus des ressources internes de Next. */\n publicPaths?: string[]\n}\n\n/**\n * Vérifie un laissez-passer auprès du service.\n *\n * Le résultat n'est pas mis en cache : révoquer un lien doit couper l'accès\n * tout de suite, pas à l'expiration d'un cache. Un appel par navigation reste\n * négligeable devant le rendu d'une page.\n */\nexport async function checkGrant(token: string, endpoint = DEFAULT_ENDPOINT): Promise<boolean> {\n if (!token) return false\n try {\n const response = await fetch(\n `${endpoint}/preview-link?token=${encodeURIComponent(token)}`,\n {cache: 'no-store'},\n )\n if (!response.ok) return false\n const body = (await response.json()) as {valid?: boolean}\n return body.valid === true\n } catch {\n // Service injoignable : on refuse. Une porte qui s'ouvre quand la serrure\n // est en panne n'est pas une porte.\n return false\n }\n}\n\n/** Le visiteur a-t-il déjà un laissez-passer valide en cookie ? */\nexport async function hasPreviewGrant(endpoint = DEFAULT_ENDPOINT): Promise<boolean> {\n const token = (await cookies()).get(GRANT_COOKIE)?.value\n return token ? checkGrant(token, endpoint) : false\n}\n\nconst ALWAYS_OPEN = ['/_next/', '/favicon', '/robots.txt', '/sitemap.xml', '/api/draft-mode/']\n\n/**\n * Garde de préversion, à monter dans le middleware du site.\n *\n * ```ts\n * // middleware.ts\n * export async function middleware(request: NextRequest) {\n * const guarded = await ncfPreviewGuard(request)\n * if (guarded) return guarded\n * // … votre middleware\n * }\n * ```\n *\n * Ne fait rien en production : le site public reste public. Sur une\n * préversion, exige un laissez-passer — celui de l'URL, qu'il mémorise en\n * cookie, ou celui déjà mémorisé.\n *\n * Rend `null` quand la requête peut suivre son cours.\n */\nexport async function ncfPreviewGuard(\n request: NextRequest,\n options: PreviewGuardOptions = {},\n): Promise<NextResponse | null> {\n if (process.env.VERCEL_ENV === 'production') return null\n\n const {pathname, searchParams} = request.nextUrl\n const open = [...ALWAYS_OPEN, ...(options.publicPaths ?? [])]\n if (open.some((prefix) => pathname.startsWith(prefix))) return null\n\n const endpoint = options.endpoint ?? DEFAULT_ENDPOINT\n\n // Un laissez-passer dans l'URL : on le valide, on le mémorise, et on retire\n // le paramètre — pour qu'il ne traîne pas dans l'historique ni dans les\n // liens partagés depuis la page.\n const fromUrl = searchParams.get(GRANT_PARAM)\n if (fromUrl) {\n if (!(await checkGrant(fromUrl, endpoint))) return refuse(request)\n\n const clean = request.nextUrl.clone()\n clean.searchParams.delete(GRANT_PARAM)\n const response = NextResponse.redirect(clean)\n response.cookies.set(GRANT_COOKIE, fromUrl, {\n httpOnly: true,\n sameSite: 'lax',\n secure: request.nextUrl.protocol === 'https:',\n path: '/',\n maxAge: 60 * 60 * 24 * 30,\n })\n return response\n }\n\n const fromCookie = request.cookies.get(GRANT_COOKIE)?.value\n if (fromCookie && (await checkGrant(fromCookie, endpoint))) return null\n\n return refuse(request)\n}\n\n/**\n * Refus explicite, en texte clair.\n *\n * Ni redirection ni page blanche : quelqu'un qui tombe là doit comprendre\n * qu'il lui manque un lien, et à qui le demander.\n */\nfunction refuse(request: NextRequest): NextResponse {\n const accepts = request.headers.get('accept') ?? ''\n if (!accepts.includes('text/html')) {\n return NextResponse.json({error: 'preview_grant_required'}, {status: 401})\n }\n\n return new NextResponse(PAGE, {\n status: 401,\n headers: {'content-type': 'text/html; charset=utf-8'},\n })\n}\n\nconst PAGE = `<!doctype html>\n<html lang=\"fr\"><head><meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"robots\" content=\"noindex\">\n<title>Préversion privée</title></head>\n<body style=\"margin:0;min-height:100vh;display:grid;place-items:center;background:#faf9f7;color:#1c1917;font:16px/1.6 ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif\">\n<main style=\"max-width:30rem;padding:2rem;text-align:center\">\n<p style=\"display:inline-flex;align-items:center;gap:.5rem;margin:0 0 1.25rem;padding:.3rem .75rem;border-radius:999px;background:#fef3c7;color:#451a03;font-size:.8125rem;font-weight:500\">\n<span style=\"width:7px;height:7px;border-radius:50%;background:#d97706\"></span>Préversion</p>\n<h1 style=\"margin:0 0 .75rem;font-size:1.375rem;font-weight:600\">Cette version du site est privée</h1>\n<p style=\"margin:0;color:#57534e\">Elle sert à relire des contenus avant leur mise en ligne. Pour y accéder, demandez un lien de partage à votre interlocuteur chez NoCode Factory.</p>\n</main></body></html>`\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,SAAgB,mBAA4B;CAC1C,OAAO,QAAQ,IAAI,eAAe;AACpC;;AAGA,MAAa,sBAA+B,CAAC,iBAAiB;;;;;;;;;;;;;;;;;;ACS9D,SAAgB,mBAAmB,UAAkC,CAAC,GAAG;CACvE,IAAM,WAAW,QAAQ,gBAAgB;CAEzC,OAAO,EACL,MAAM,IAAI,SAAqC;EAC7C,IAAI,iBAAiB,GACnB,OAAO,aAAa,KAClB,EAAC,OAAO,iDAAgD,GACxD,EAAC,QAAQ,IAAG,CACd;EAGF,IAAM,MAAM,IAAI,IAAI,QAAQ,GAAG,GACzB,QAAQ,MAAM,UAAU;EAE9B,AAAI,IAAI,aAAa,IAAI,QAAQ,MAAM,UAAS,MAAM,QAAQ,IACzD,MAAM,OAAO;EAKlB,IAAM,OAAO,IAAI,aAAa,IAAI,UAAU,GACtC,SAAS,QAAQ,KAAK,WAAW,GAAG,KAAK,CAAC,KAAK,WAAW,IAAI,IAAI,OAAO;EAC/E,OAAO,aAAa,SAAS,IAAI,IAAI,QAAQ,QAAQ,GAAG,CAAC;CAC3D,EACF;AACF;;ACnDA,MAAa,cAAc,eACd,eAAe,qBAEtB,mBAAmB;;;;;;;;AAgBzB,eAAsB,WAAW,OAAe,WAAW,kBAAoC;CAC7F,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI;EACF,IAAM,WAAW,MAAM,MACrB,GAAG,SAAS,sBAAsB,mBAAmB,KAAK,KAC1D,EAAC,OAAO,WAAU,CACpB;EAGA,OAFK,SAAS,MAEP,MADa,SAAS,KAAK,EAAA,CACtB,UAAU,KAFG;CAG3B,QAAQ;EAGN,OAAO;CACT;AACF;;AAGA,eAAsB,gBAAgB,WAAW,kBAAoC;CACnF,IAAM,SAAS,MAAM,QAAQ,EAAA,CAAG,IAAI,YAAY,CAAC,EAAE;CACnD,OAAO,QAAQ,WAAW,OAAO,QAAQ,IAAI;AAC/C;AAEA,MAAM,cAAc;CAAC;CAAW;CAAY;CAAe;CAAgB;AAAkB;;;;;;;;;;;;;;;;;;;AAoB7F,eAAsB,gBACpB,SACA,UAA+B,CAAC,GACF;CAC9B,IAAI,QAAQ,IAAI,eAAe,cAAc,OAAO;CAEpD,IAAM,EAAC,UAAU,iBAAgB,QAAQ;CAEzC,IAAI,CADU,GAAG,aAAa,GAAI,QAAQ,eAAe,CAAC,CACnD,CAAC,CAAC,MAAM,WAAW,SAAS,WAAW,MAAM,CAAC,GAAG,OAAO;CAE/D,IAAM,WAAW,QAAQ,YAAY,kBAK/B,UAAU,aAAa,IAAI,WAAW;CAC5C,IAAI,SAAS;EACX,IAAI,CAAE,MAAM,WAAW,SAAS,QAAQ,GAAI,OAAO,OAAO,OAAO;EAEjE,IAAM,QAAQ,QAAQ,QAAQ,MAAM;EACpC,MAAM,aAAa,OAAO,WAAW;EACrC,IAAM,WAAW,aAAa,SAAS,KAAK;EAQ5C,OAPA,SAAS,QAAQ,IAAI,cAAc,SAAS;GAC1C,UAAU;GACV,UAAU;GACV,QAAQ,QAAQ,QAAQ,aAAa;GACrC,MAAM;GACN,QAAQ;EACV,CAAC,GACM;CACT;CAEA,IAAM,aAAa,QAAQ,QAAQ,IAAI,YAAY,CAAC,EAAE;CAGtD,OAFI,cAAe,MAAM,WAAW,YAAY,QAAQ,IAAW,OAE5D,OAAO,OAAO;AACvB;;;;;;;AAQA,SAAS,OAAO,SAAoC;CAMlD,QALgB,QAAQ,QAAQ,IAAI,QAAQ,KAAK,GAAA,CACpC,SAAS,WAAW,IAI1B,IAAI,aAAa,MAAM;EAC5B,QAAQ;EACR,SAAS,EAAC,gBAAgB,2BAA0B;CACtD,CAAC,IANQ,aAAa,KAAK,EAAC,OAAO,yBAAwB,GAAG,EAAC,QAAQ,IAAG,CAAC;AAO7E;AAEA,MAAM,OAAO"}
|
|
1
|
+
{"version":3,"file":"web-server.js","names":[],"sources":["../src/web/environment.ts","../src/web/draftModeToggle.ts","../src/web/previewGrant.ts"],"sourcesContent":["/**\n * Outils destinés au **front** d'un site, pas au Studio.\n *\n * Ce point d'entrée n'importe ni `sanity` ni `@sanity/ui` : un site qui\n * l'utilise n'embarque pas le Studio dans son bundle.\n */\n\n/**\n * Vrai sur le déploiement public du site.\n *\n * `VERCEL_ENV` plutôt qu'une comparaison d'URL : un alias, un domaine ajouté\n * plus tard ou une préversion nommée comme la production feraient mentir la\n * seconde. Hors Vercel, on considère qu'on n'est pas en production — un\n * environnement inconnu mérite le bandeau plutôt que le silence.\n */\nexport function isProductionSite(): boolean {\n return process.env.VERCEL_ENV === 'production'\n}\n\n/** L'inverse, pour se lire à l'endroit dans un layout. */\nexport const isPreviewSite = (): boolean => !isProductionSite()\n","import {draftMode} from 'next/headers'\nimport {NextResponse} from 'next/server'\nimport {isProductionSite} from './environment'\n\nexport interface DraftModeToggleOptions {\n /**\n * Chemin de repli après la bascule, quand la page d'origine est inconnue.\n * Défaut : la racine.\n */\n fallbackPath?: string\n}\n\n/**\n * Route qui bascule le mode brouillon depuis le site.\n *\n * ```ts\n * // app/api/draft-mode/toggle/route.ts\n * export const {GET} = ncfDraftModeToggle()\n * ```\n *\n * **Refusée en production.** Activer le mode brouillon rend le contenu non\n * publié visible à qui atteint l'URL : acceptable sur une préversion, jamais\n * sur le site public. Ce refus est le seul garde-fou du dispositif — il ne\n * dépend d'aucune configuration, et se trompe du bon côté.\n *\n * La route de Sanity, `defineEnableDraftMode`, reste préférable quand on entre\n * par Presentation : elle vérifie un secret lié à la session de l'éditeur.\n * Celle-ci sert le cas où l'on est déjà sur le site, sans Studio.\n */\nexport function ncfDraftModeToggle(options: DraftModeToggleOptions = {}) {\n const fallback = options.fallbackPath ?? '/'\n\n return {\n async GET(request: Request): Promise<Response> {\n if (isProductionSite()) {\n return NextResponse.json(\n {error: 'Le mode brouillon est désactivé en production.'},\n {status: 403},\n )\n }\n\n const url = new URL(request.url)\n const draft = await draftMode()\n\n if (url.searchParams.get('enable') === 'false') draft.disable()\n else draft.enable()\n\n // On revient d'où l'on vient : basculer les données ne doit pas faire\n // perdre sa place au relecteur. Un chemin relatif seulement — une URL\n // absolue ferait de cette route une redirection ouverte.\n const back = url.searchParams.get('redirect')\n const target = back && back.startsWith('/') && !back.startsWith('//') ? back : fallback\n return NextResponse.redirect(new URL(target, request.url))\n },\n }\n}\n","import {cookies} from 'next/headers'\nimport {NextResponse, type NextRequest} from 'next/server'\n\n/** Paramètre d'URL porteur du laissez-passer, et cookie qui le mémorise. */\nexport const GRANT_PARAM = 'ncf_preview'\nexport const GRANT_COOKIE = 'ncf_preview_grant'\n\nconst DEFAULT_ENDPOINT = 'https://dkoxgivytgsmvqmjvmjt.supabase.co/functions/v1'\n\nexport interface PreviewGuardOptions {\n /** Base des Edge Functions du kit. */\n endpoint?: string\n /** Chemins toujours ouverts, en plus des ressources internes de Next. */\n publicPaths?: string[]\n}\n\n/**\n * Vérifie un laissez-passer auprès du service.\n *\n * Le résultat n'est pas mis en cache : révoquer un lien doit couper l'accès\n * tout de suite, pas à l'expiration d'un cache. Un appel par navigation reste\n * négligeable devant le rendu d'une page.\n */\nexport async function checkGrant(token: string, endpoint = DEFAULT_ENDPOINT): Promise<boolean> {\n if (!token) return false\n try {\n const response = await fetch(\n `${endpoint}/preview-link?token=${encodeURIComponent(token)}`,\n {cache: 'no-store'},\n )\n if (!response.ok) return false\n const body = (await response.json()) as {valid?: boolean}\n return body.valid === true\n } catch {\n // Service injoignable : on refuse. Une porte qui s'ouvre quand la serrure\n // est en panne n'est pas une porte.\n return false\n }\n}\n\n/** Le visiteur a-t-il déjà un laissez-passer valide en cookie ? */\nexport async function hasPreviewGrant(endpoint = DEFAULT_ENDPOINT): Promise<boolean> {\n const token = (await cookies()).get(GRANT_COOKIE)?.value\n return token ? checkGrant(token, endpoint) : false\n}\n\nconst ALWAYS_OPEN = ['/_next/', '/favicon', '/robots.txt', '/sitemap.xml', '/api/draft-mode/']\n\n/**\n * Garde de préversion, à monter dans le middleware du site.\n *\n * ```ts\n * // middleware.ts\n * export async function middleware(request: NextRequest) {\n * const guarded = await ncfPreviewGuard(request)\n * if (guarded) return guarded\n * // … votre middleware\n * }\n * ```\n *\n * Ne fait rien en production : le site public reste public. Sur une\n * préversion, exige un laissez-passer — celui de l'URL, qu'il mémorise en\n * cookie, ou celui déjà mémorisé.\n *\n * Rend `null` quand la requête peut suivre son cours.\n */\nexport async function ncfPreviewGuard(\n request: NextRequest,\n options: PreviewGuardOptions = {},\n): Promise<NextResponse | null> {\n if (process.env.VERCEL_ENV === 'production') return null\n\n const {pathname, searchParams} = request.nextUrl\n const open = [...ALWAYS_OPEN, ...(options.publicPaths ?? [])]\n if (open.some((prefix) => pathname.startsWith(prefix))) return null\n\n const endpoint = options.endpoint ?? DEFAULT_ENDPOINT\n\n // Un laissez-passer dans l'URL : on le valide, on le mémorise, et on retire\n // le paramètre — pour qu'il ne traîne pas dans l'historique ni dans les\n // liens partagés depuis la page.\n const fromUrl = searchParams.get(GRANT_PARAM)\n if (fromUrl) {\n if (!(await checkGrant(fromUrl, endpoint))) return refuse(request)\n\n const clean = request.nextUrl.clone()\n clean.searchParams.delete(GRANT_PARAM)\n const response = NextResponse.redirect(clean, {headers: NOINDEX_HEADERS})\n response.cookies.set(GRANT_COOKIE, fromUrl, {\n httpOnly: true,\n sameSite: 'lax',\n secure: request.nextUrl.protocol === 'https:',\n path: '/',\n maxAge: 60 * 60 * 24 * 30,\n })\n return response\n }\n\n const fromCookie = request.cookies.get(GRANT_COOKIE)?.value\n if (fromCookie && (await checkGrant(fromCookie, endpoint))) {\n // Laisser passer, mais jamais sans interdire l'indexation : la page\n // servie est bien du contenu de préproduction.\n const response = NextResponse.next()\n for (const [key, value] of Object.entries(NOINDEX_HEADERS)) {\n response.headers.set(key, value)\n }\n return response\n }\n\n return refuse(request)\n}\n\n/**\n * En-têtes posés sur toute réponse de préversion.\n *\n * Une préproduction ne doit jamais être indexée : elle porte du contenu non\n * publié et doublerait le site public en résultats de recherche. Le refus\n * d'accès n'y suffit pas — un moteur peut avoir vu l'URL ailleurs, et une\n * page de refus indexée reste une page indexée.\n */\nexport const NOINDEX_HEADERS = {\n 'x-robots-tag': 'noindex, nofollow, noarchive, nosnippet',\n}\n\n/**\n * Refus explicite, en texte clair.\n *\n * Ni redirection ni page blanche : quelqu'un qui tombe là doit comprendre\n * qu'il lui manque un lien, et à qui le demander.\n */\nfunction refuse(request: NextRequest): NextResponse {\n const accepts = request.headers.get('accept') ?? ''\n if (!accepts.includes('text/html')) {\n return NextResponse.json(\n {error: 'preview_grant_required'},\n {status: 401, headers: NOINDEX_HEADERS},\n )\n }\n\n return new NextResponse(PAGE, {\n status: 401,\n headers: {...NOINDEX_HEADERS, 'content-type': 'text/html; charset=utf-8'},\n })\n}\n\nconst PAGE = `<!doctype html>\n<html lang=\"fr\"><head><meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<meta name=\"robots\" content=\"noindex\">\n<title>Préversion privée</title></head>\n<body style=\"margin:0;min-height:100vh;display:grid;place-items:center;background:#faf9f7;color:#1c1917;font:16px/1.6 ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif\">\n<main style=\"max-width:30rem;padding:2rem;text-align:center\">\n<p style=\"display:inline-flex;align-items:center;gap:.5rem;margin:0 0 1.25rem;padding:.3rem .75rem;border-radius:999px;background:#fef3c7;color:#451a03;font-size:.8125rem;font-weight:500\">\n<span style=\"width:7px;height:7px;border-radius:50%;background:#d97706\"></span>Préversion</p>\n<h1 style=\"margin:0 0 .75rem;font-size:1.375rem;font-weight:600\">Cette version du site est privée</h1>\n<p style=\"margin:0;color:#57534e\">Elle sert à relire des contenus avant leur mise en ligne. Pour y accéder, demandez un lien de partage à votre interlocuteur chez NoCode Factory.</p>\n</main></body></html>`\n"],"mappings":"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"}
|
package/package.json
CHANGED
package/src/config/resolve.ts
CHANGED
|
@@ -128,6 +128,31 @@ export function resolveConfig(input: NcfKitConfig): ResolvedKitConfig {
|
|
|
128
128
|
}
|
|
129
129
|
|
|
130
130
|
|
|
131
|
+
/**
|
|
132
|
+
* Préproduction déduite de la production, par convention.
|
|
133
|
+
*
|
|
134
|
+
* NoCode Factory assigne à chaque projet un domaine Vercel **fixe** pour la
|
|
135
|
+
* branche `preprod`, de la forme `preview-<projet>.vercel.app`. Fixe parce
|
|
136
|
+
* qu'un lien de partage doit survivre au commit suivant : une URL de
|
|
137
|
+
* déploiement change à chaque poussée, un domaine assigné non.
|
|
138
|
+
*
|
|
139
|
+
* La déduire évite de la déclarer neuf fois. Elle n'est proposée que pour un
|
|
140
|
+
* hôte Vercel — ailleurs la convention ne s'applique pas — et `environments`
|
|
141
|
+
* la remplace dès qu'on la déclare explicitement.
|
|
142
|
+
*/
|
|
143
|
+
export function conventionalPreprodUrl(previewUrl: string | null): string | null {
|
|
144
|
+
if (!previewUrl) return null
|
|
145
|
+
try {
|
|
146
|
+
const url = new URL(previewUrl)
|
|
147
|
+
if (!url.hostname.endsWith('.vercel.app')) return null
|
|
148
|
+
// Une préproduction ne se dérive pas d'une préproduction.
|
|
149
|
+
if (url.hostname.startsWith('preview-')) return null
|
|
150
|
+
return `${url.protocol}//preview-${url.hostname}`
|
|
151
|
+
} catch {
|
|
152
|
+
return null
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
|
|
131
156
|
/**
|
|
132
157
|
* Environnements d'aperçu.
|
|
133
158
|
*
|
|
@@ -147,7 +172,29 @@ function resolveEnvironments(input: NcfKitConfig): NcfEnvironment[] {
|
|
|
147
172
|
.filter((environment) => environment.id && environment.url)
|
|
148
173
|
|
|
149
174
|
const preview = input.previewUrl ? trimTrailingSlash(input.previewUrl.trim()) : null
|
|
150
|
-
if (!preview
|
|
175
|
+
if (!preview) return declared
|
|
176
|
+
|
|
177
|
+
const production = declared.some((environment) => environment.url === preview)
|
|
178
|
+
? []
|
|
179
|
+
: [{id: 'production', label: 'Production', url: preview}]
|
|
180
|
+
|
|
181
|
+
// La préproduction conventionnelle complète la liste, sauf si le projet en
|
|
182
|
+
// a déjà déclaré une — sa déclaration explicite fait foi.
|
|
183
|
+
//
|
|
184
|
+
// On compare l'identifiant autant que l'URL : un projet dont le domaine ne
|
|
185
|
+
// suit pas exactement la convention déclare bien un `preprod`, à une autre
|
|
186
|
+
// adresse. En n'écartant que par l'URL, on en ajoutait un second portant le
|
|
187
|
+
// même identifiant, et la configuration devenait invalide.
|
|
188
|
+
const conventional = conventionalPreprodUrl(preview)
|
|
189
|
+
const hasPreprod =
|
|
190
|
+
declared.some(
|
|
191
|
+
(environment) => environment.url === conventional || environment.id === 'preprod',
|
|
192
|
+
) || input.preprodUrl === false
|
|
193
|
+
|
|
194
|
+
const preprod =
|
|
195
|
+
conventional && !hasPreprod
|
|
196
|
+
? [{id: 'preprod', label: 'Préproduction', url: conventional}]
|
|
197
|
+
: []
|
|
151
198
|
|
|
152
|
-
return [
|
|
199
|
+
return [...production, ...preprod, ...declared]
|
|
153
200
|
}
|
package/src/config/types.ts
CHANGED
|
@@ -167,6 +167,11 @@ export interface NcfKitConfig {
|
|
|
167
167
|
* `ncfAllowedOrigins(config)` les produit.
|
|
168
168
|
*/
|
|
169
169
|
environments?: NcfEnvironment[]
|
|
170
|
+
/**
|
|
171
|
+
* `false` retire la préproduction déduite par convention
|
|
172
|
+
* (`preview-<projet>.vercel.app`). Utile pour un projet qui n'en a pas.
|
|
173
|
+
*/
|
|
174
|
+
preprodUrl?: false
|
|
170
175
|
/**
|
|
171
176
|
* Gabarit d'URL de la capture d'une page, pour afficher la page entière dans
|
|
172
177
|
* le board plutôt qu'une iframe tronquée. Variables : {slug} (chemin sans
|
package/src/version.ts
CHANGED
package/src/web/previewGrant.ts
CHANGED
|
@@ -85,7 +85,7 @@ export async function ncfPreviewGuard(
|
|
|
85
85
|
|
|
86
86
|
const clean = request.nextUrl.clone()
|
|
87
87
|
clean.searchParams.delete(GRANT_PARAM)
|
|
88
|
-
const response = NextResponse.redirect(clean)
|
|
88
|
+
const response = NextResponse.redirect(clean, {headers: NOINDEX_HEADERS})
|
|
89
89
|
response.cookies.set(GRANT_COOKIE, fromUrl, {
|
|
90
90
|
httpOnly: true,
|
|
91
91
|
sameSite: 'lax',
|
|
@@ -97,11 +97,31 @@ export async function ncfPreviewGuard(
|
|
|
97
97
|
}
|
|
98
98
|
|
|
99
99
|
const fromCookie = request.cookies.get(GRANT_COOKIE)?.value
|
|
100
|
-
if (fromCookie && (await checkGrant(fromCookie, endpoint)))
|
|
100
|
+
if (fromCookie && (await checkGrant(fromCookie, endpoint))) {
|
|
101
|
+
// Laisser passer, mais jamais sans interdire l'indexation : la page
|
|
102
|
+
// servie est bien du contenu de préproduction.
|
|
103
|
+
const response = NextResponse.next()
|
|
104
|
+
for (const [key, value] of Object.entries(NOINDEX_HEADERS)) {
|
|
105
|
+
response.headers.set(key, value)
|
|
106
|
+
}
|
|
107
|
+
return response
|
|
108
|
+
}
|
|
101
109
|
|
|
102
110
|
return refuse(request)
|
|
103
111
|
}
|
|
104
112
|
|
|
113
|
+
/**
|
|
114
|
+
* En-têtes posés sur toute réponse de préversion.
|
|
115
|
+
*
|
|
116
|
+
* Une préproduction ne doit jamais être indexée : elle porte du contenu non
|
|
117
|
+
* publié et doublerait le site public en résultats de recherche. Le refus
|
|
118
|
+
* d'accès n'y suffit pas — un moteur peut avoir vu l'URL ailleurs, et une
|
|
119
|
+
* page de refus indexée reste une page indexée.
|
|
120
|
+
*/
|
|
121
|
+
export const NOINDEX_HEADERS = {
|
|
122
|
+
'x-robots-tag': 'noindex, nofollow, noarchive, nosnippet',
|
|
123
|
+
}
|
|
124
|
+
|
|
105
125
|
/**
|
|
106
126
|
* Refus explicite, en texte clair.
|
|
107
127
|
*
|
|
@@ -111,12 +131,15 @@ export async function ncfPreviewGuard(
|
|
|
111
131
|
function refuse(request: NextRequest): NextResponse {
|
|
112
132
|
const accepts = request.headers.get('accept') ?? ''
|
|
113
133
|
if (!accepts.includes('text/html')) {
|
|
114
|
-
return NextResponse.json(
|
|
134
|
+
return NextResponse.json(
|
|
135
|
+
{error: 'preview_grant_required'},
|
|
136
|
+
{status: 401, headers: NOINDEX_HEADERS},
|
|
137
|
+
)
|
|
115
138
|
}
|
|
116
139
|
|
|
117
140
|
return new NextResponse(PAGE, {
|
|
118
141
|
status: 401,
|
|
119
|
-
headers: {'content-type': 'text/html; charset=utf-8'},
|
|
142
|
+
headers: {...NOINDEX_HEADERS, 'content-type': 'text/html; charset=utf-8'},
|
|
120
143
|
})
|
|
121
144
|
}
|
|
122
145
|
|
package/src/web/server.ts
CHANGED
|
@@ -9,5 +9,12 @@
|
|
|
9
9
|
export {ncfDraftModeToggle} from './draftModeToggle'
|
|
10
10
|
export type {DraftModeToggleOptions} from './draftModeToggle'
|
|
11
11
|
export {isProductionSite, isPreviewSite} from './environment'
|
|
12
|
-
export {
|
|
12
|
+
export {
|
|
13
|
+
ncfPreviewGuard,
|
|
14
|
+
checkGrant,
|
|
15
|
+
hasPreviewGrant,
|
|
16
|
+
GRANT_PARAM,
|
|
17
|
+
GRANT_COOKIE,
|
|
18
|
+
NOINDEX_HEADERS,
|
|
19
|
+
} from './previewGrant'
|
|
13
20
|
export type {PreviewGuardOptions} from './previewGrant'
|