@nocode-factory/sanity-kit 2.1.0 → 2.2.0

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.
@@ -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
@@ -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
- return fromCookie && await checkGrant(fromCookie, endpoint) ? null : refuse(request);
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: { "content-type": "text/html; charset=utf-8" }
128
- }) : NextResponse.json({ error: "preview_grant_required" }, { status: 401 });
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
@@ -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":";;;;;;;;;;;;;;;;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,OAAO,EAAC,SAAS,gBAAe,CAAC;EAQxE,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;CACtD,IAAI,cAAe,MAAM,WAAW,YAAY,QAAQ,GAAI;EAG1D,IAAM,WAAW,aAAa,KAAK;EACnC,KAAK,IAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,eAAe,GACvD,SAAS,QAAQ,IAAI,KAAK,KAAK;EAEjC,OAAO;CACT;CAEA,OAAO,OAAO,OAAO;AACvB;;;;;;;;;AAUA,MAAa,kBAAkB,EAC7B,gBAAgB,0CAClB;;;;;;;AAQA,SAAS,OAAO,SAAoC;CASlD,QARgB,QAAQ,QAAQ,IAAI,QAAQ,KAAK,GAAA,CACpC,SAAS,WAAW,IAO1B,IAAI,aAAa,MAAM;EAC5B,QAAQ;EACR,SAAS;GAAC,GAAG;GAAiB,gBAAgB;EAA0B;CAC1E,CAAC,IATQ,aAAa,KAClB,EAAC,OAAO,yBAAwB,GAChC;EAAC,QAAQ;EAAK,SAAS;CAAe,CACxC;AAOJ;AAEA,MAAM,OAAO"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nocode-factory/sanity-kit",
3
- "version": "2.1.0",
3
+ "version": "2.2.0",
4
4
  "description": "Outils Studio de NoCode Factory : Pages (liste + board), Composants, Historique",
5
5
  "license": "UNLICENSED",
6
6
  "private": false,
@@ -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,23 @@ 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 || declared.some((environment) => environment.url === preview)) return declared
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
+ const conventional = conventionalPreprodUrl(preview)
184
+ const hasPreprod =
185
+ declared.some((environment) => environment.url === conventional) ||
186
+ input.preprodUrl === false
187
+
188
+ const preprod =
189
+ conventional && !hasPreprod
190
+ ? [{id: 'preprod', label: 'Préproduction', url: conventional}]
191
+ : []
151
192
 
152
- return [{id: 'production', label: 'Production', url: preview}, ...declared]
193
+ return [...production, ...preprod, ...declared]
153
194
  }
@@ -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
@@ -27,6 +27,13 @@ export interface PreviewTargetState {
27
27
  pathFor: (url: string | null) => string | null
28
28
  /** URL de la page sur l'environnement choisi, pour l'ouvrir hors du Studio. */
29
29
  siteUrlFor: (url: string | null) => string | null
30
+ /**
31
+ * L'environnement choisi est-il le site public ?
32
+ *
33
+ * Il n'y a rien à y prévisualiser : le bandeau s'y masque et le mode
34
+ * brouillon y est refusé. Partager un lien vers lui ne montrerait rien.
35
+ */
36
+ isProduction: boolean
30
37
  }
31
38
 
32
39
  const STORAGE_PREFIX = 'ncf-kit:preview-target:'
@@ -147,7 +154,12 @@ export function usePreviewTargetState(): PreviewTargetState {
147
154
  [environment],
148
155
  )
149
156
 
157
+ const isProduction = Boolean(
158
+ environment && config.previewUrl && environment.url === config.previewUrl,
159
+ )
160
+
150
161
  return {
162
+ isProduction,
151
163
  environments: allEnvironments,
152
164
  customUrl,
153
165
  setCustomUrl,
@@ -163,6 +163,7 @@ export function PagesTool() {
163
163
  onPerspective={preview.setPerspective}
164
164
  onCustomUrl={preview.setCustomUrl}
165
165
  customUrl={preview.customUrl}
166
+ productionUrl={config.previewUrl}
166
167
  />
167
168
 
168
169
  <Box style={{flex: 'none', paddingBottom: 2}}>
@@ -22,6 +22,8 @@ export interface PreviewTargetProps {
22
22
  /** Rend `false` si l'adresse n'est pas exploitable. */
23
23
  onCustomUrl: (url: string) => boolean
24
24
  customUrl: string | null
25
+ /** URL du site public, pour le signaler dans la liste. */
26
+ productionUrl?: string | null
25
27
  }
26
28
 
27
29
  /**
@@ -38,7 +40,7 @@ export interface PreviewTargetProps {
38
40
  */
39
41
  export function PreviewTarget(props: PreviewTargetProps) {
40
42
  const {environments, environmentId, perspective, onEnvironment, onPerspective} = props
41
- const {onCustomUrl, customUrl} = props
43
+ const {onCustomUrl, customUrl, productionUrl} = props
42
44
  const current = environments.find((environment) => environment.id === environmentId)
43
45
 
44
46
  return (
@@ -89,6 +91,7 @@ export function PreviewTarget(props: PreviewTargetProps) {
89
91
  key={environment.id}
90
92
  environment={environment}
91
93
  selected={environment.id === environmentId}
94
+ isProduction={Boolean(productionUrl) && environment.url === productionUrl}
92
95
  onSelect={() => {
93
96
  onEnvironment(environment.id)
94
97
  close()
@@ -120,6 +123,7 @@ function EnvironmentRow(props: {
120
123
  selected: boolean
121
124
  onSelect: () => void
122
125
  onForget?: () => void
126
+ isProduction?: boolean
123
127
  }) {
124
128
  return (
125
129
  <Flex
@@ -144,7 +148,9 @@ function EnvironmentRow(props: {
144
148
  </Text>
145
149
  {/* L'hôte lève l'ambiguïté entre deux branches au nom voisin. */}
146
150
  <Text size={0} muted textOverflow="ellipsis">
147
- {hostOf(props.environment.url)}
151
+ {/* Le site public se signale : on n'y prévisualise rien, et un lien
152
+ de partage vers lui ne montrerait rien. */}
153
+ {props.isProduction ? 'site public — pas de préversion' : hostOf(props.environment.url)}
148
154
  </Text>
149
155
  </Stack>
150
156
  {/* Seule l'adresse collée s'oublie : les environnements déclarés
@@ -29,7 +29,7 @@ const DURATIONS = [
29
29
  export function SharePreview() {
30
30
  const config = useKitConfig()
31
31
  const client = useKitClient()
32
- const {environment} = usePreviewTarget()
32
+ const {environment, isProduction} = usePreviewTarget()
33
33
 
34
34
  const [link, setLink] = useState<string | null>(null)
35
35
  const [expiresAt, setExpiresAt] = useState<string | null>(null)
@@ -98,6 +98,27 @@ export function SharePreview() {
98
98
  >
99
99
  {() => (
100
100
  <Stack gap={3} padding={2}>
101
+ {/* Partager la production ne montrerait rien : le bandeau s'y masque
102
+ et le mode brouillon y est refusé, pour que du contenu non publié
103
+ ne puisse jamais fuiter en public. */}
104
+ {isProduction ? (
105
+ <Stack gap={3}>
106
+ <Text size={1} weight="semibold">
107
+ Rien à partager sur le site public
108
+ </Text>
109
+ <Text size={0} muted>
110
+ La production n'affiche jamais les brouillons — c'est ce qui protège votre
111
+ contenu non publié. Un lien vers elle ne montrerait rien de plus qu'une
112
+ visite ordinaire.
113
+ </Text>
114
+ <Text size={0} muted>
115
+ Choisissez d'abord une <b>préversion</b> dans le sélecteur d'environnement, à
116
+ gauche : une préproduction déclarée, ou l'adresse d'un déploiement de branche
117
+ que vous y collez.
118
+ </Text>
119
+ </Stack>
120
+ ) : (
121
+ <>
101
122
  <Text size={0} muted>
102
123
  Un lien qui ouvre <b>{environment?.label ?? 'le site'}</b> et permet d'y basculer
103
124
  entre brouillons et contenu en ligne. Celui qui l'a n'a besoin d'aucun compte.
@@ -190,6 +211,8 @@ export function SharePreview() {
190
211
  )}
191
212
  </Stack>
192
213
  )}
214
+ </>
215
+ )}
193
216
  </Stack>
194
217
  )}
195
218
  </InlinePopover>
package/src/version.ts CHANGED
@@ -2,4 +2,4 @@
2
2
  * Version du kit, rapportée au service pour savoir quels projets tournent sur
3
3
  * quelle version. Tenue à jour avec `package.json`.
4
4
  */
5
- export const KIT_VERSION = '2.1.0'
5
+ export const KIT_VERSION = '2.2.0'
@@ -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))) return null
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({error: 'preview_grant_required'}, {status: 401})
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 {ncfPreviewGuard, checkGrant, hasPreviewGrant, GRANT_PARAM, GRANT_COOKIE} from './previewGrant'
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'