@nocode-factory/sanity-kit 2.10.2 → 2.11.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.
@@ -1,6 +1,7 @@
1
- import {draftMode} from 'next/headers'
1
+ import {cookies, draftMode} from 'next/headers'
2
2
  import {NextResponse} from 'next/server'
3
3
  import {isProductionSite} from './environment'
4
+ import {PERSPECTIVE_COOKIE} from './dataMode'
4
5
 
5
6
  export interface DraftModeToggleOptions {
6
7
  /**
@@ -33,6 +34,7 @@ export function ncfDraftModeToggle(options: DraftModeToggleOptions = {}) {
33
34
  return {
34
35
  async GET(request: Request): Promise<Response> {
35
36
  if (isProductionSite()) {
37
+ ;(await draftMode()).disable()
36
38
  return NextResponse.json(
37
39
  {error: 'Le mode brouillon est désactivé en production.'},
38
40
  {status: 403},
@@ -42,8 +44,17 @@ export function ncfDraftModeToggle(options: DraftModeToggleOptions = {}) {
42
44
  const url = new URL(request.url)
43
45
  const draft = await draftMode()
44
46
 
45
- if (url.searchParams.get('enable') === 'false') draft.disable()
46
- else draft.enable()
47
+ // La perspective suit la bascule : sans ça, un passage préalable par Presentation
48
+ // en « publié » laisserait « Brouillons » afficher le contenu en ligne.
49
+ const jar = await cookies()
50
+ const secure = url.protocol === 'https:'
51
+ if (url.searchParams.get('enable') === 'false') {
52
+ draft.disable()
53
+ jar.delete(PERSPECTIVE_COOKIE)
54
+ } else {
55
+ draft.enable()
56
+ jar.set({name: PERSPECTIVE_COOKIE, value: 'drafts', httpOnly: true, path: '/', secure, sameSite: secure ? 'none' : 'lax'})
57
+ }
47
58
 
48
59
  // On revient d'où l'on vient : basculer les données ne doit pas faire
49
60
  // perdre sa place au relecteur. Un chemin relatif seulement — une URL
@@ -0,0 +1,62 @@
1
+ import {cookies, draftMode} from 'next/headers'
2
+ import {PERSPECTIVE_COOKIE} from './dataMode'
3
+ import {NextResponse} from 'next/server'
4
+ import {isProductionSite} from './environment'
5
+ import {previewSecret, SESSION_COOKIE, SESSION_TTL_MS, signPreviewSession} from './previewSession'
6
+
7
+ type Handler = {GET: (request: Request) => Promise<Response>}
8
+
9
+ const isRedirect = (error: unknown): boolean =>
10
+ typeof error === 'object' && error !== null && String((error as {digest?: unknown}).digest ?? '').startsWith('NEXT_REDIRECT')
11
+
12
+ /**
13
+ * Enveloppe de la route d'activation du mode brouillon de Sanity (Presentation).
14
+ *
15
+ * ```ts
16
+ * // app/api/draft-mode/enable/route.ts
17
+ * export const {GET} = ncfEnableDraftMode(defineEnableDraftMode({client: client.withConfig({token})}))
18
+ * ```
19
+ *
20
+ * - **Production : refusée** (et un éventuel mode brouillon est coupé). Le site public
21
+ * ne montre jamais de brouillons : on édite sur la préproduction.
22
+ * - **Préproduction :** une fois le secret validé par Sanity, pose aussi une session de
23
+ * préproduction signée, pour que la garde laisse passer l'iframe de Presentation
24
+ * sans laissez-passer ni connexion.
25
+ */
26
+ export function ncfEnableDraftMode(handler: Handler): Handler {
27
+ return {
28
+ async GET(request: Request): Promise<Response> {
29
+ if (isProductionSite()) {
30
+ // Aucun brouillon en production : on coupe un éventuel mode brouillon et on
31
+ // affiche la page demandée telle qu'en ligne (Presentation la montre sans
32
+ // édition). Chemin relatif seulement : jamais de redirection ouverte.
33
+ ;(await draftMode()).disable()
34
+ ;(await cookies()).delete(PERSPECTIVE_COOKIE)
35
+ const wanted = new URL(request.url).searchParams.get('sanity-preview-pathname') ?? '/'
36
+ const target = wanted.startsWith('/') && !wanted.startsWith('//') ? wanted : '/'
37
+ return NextResponse.redirect(new URL(target, request.url))
38
+ }
39
+ try {
40
+ return await handler.GET(request)
41
+ } catch (error) {
42
+ if (isRedirect(error) && process.env.VERCEL_ENV === 'preview') {
43
+ const secret = previewSecret()
44
+ if (secret) {
45
+ const iframe = request.headers.get('sec-fetch-dest') === 'iframe' && request.headers.get('sec-fetch-site') === 'cross-site'
46
+ ;(await cookies()).set({
47
+ name: SESSION_COOKIE,
48
+ value: await signPreviewSession(secret),
49
+ httpOnly: true,
50
+ path: '/',
51
+ secure: true,
52
+ sameSite: 'none',
53
+ partitioned: iframe,
54
+ maxAge: SESSION_TTL_MS / 1000,
55
+ })
56
+ }
57
+ }
58
+ throw error
59
+ }
60
+ },
61
+ }
62
+ }
@@ -1,5 +1,6 @@
1
1
  import {cookies} from 'next/headers'
2
2
  import {NextResponse, type NextRequest} from 'next/server'
3
+ import {previewSecret, SESSION_COOKIE, verifyPreviewSession} from './previewSession'
3
4
 
4
5
  /** Paramètre d'URL porteur du laissez-passer, et cookie qui le mémorise. */
5
6
  export const GRANT_PARAM = 'ncf_preview'
@@ -94,16 +95,23 @@ export async function ncfPreviewGuard(
94
95
  const clean = request.nextUrl.clone()
95
96
  clean.searchParams.delete(GRANT_PARAM)
96
97
  const response = NextResponse.redirect(clean, {headers: NOINDEX_HEADERS})
98
+ // SameSite=None en HTTPS : le laissez-passer doit aussi valoir dans l'iframe de
99
+ // Presentation (site tiers vu du Studio), où un cookie Lax n'est pas envoyé.
100
+ const https = request.nextUrl.protocol === 'https:'
97
101
  response.cookies.set(GRANT_COOKIE, fromUrl, {
98
102
  httpOnly: true,
99
- sameSite: 'lax',
100
- secure: request.nextUrl.protocol === 'https:',
103
+ sameSite: https ? 'none' : 'lax',
104
+ secure: https,
101
105
  path: '/',
102
106
  maxAge: 60 * 60 * 24 * 30,
103
107
  })
104
108
  return response
105
109
  }
106
110
 
111
+ // Session signée posée par l'activation du mode brouillon (Presentation, après
112
+ // validation du secret par Sanity) : vérifiée localement, sans réseau.
113
+ if (await verifyPreviewSession(request.cookies.get(SESSION_COOKIE)?.value, previewSecret())) return null
114
+
107
115
  const fromCookie = request.cookies.get(GRANT_COOKIE)?.value
108
116
  // `null` et non `NextResponse.next()` : le garde se monte en tête d'un
109
117
  // middleware qui fait autre chose ensuite — langues, redirections, en-têtes.
@@ -0,0 +1,54 @@
1
+ /**
2
+ * Session de préproduction signée (HMAC-SHA256), sans appel réseau.
3
+ *
4
+ * Délivrée par la route d'activation du mode brouillon APRÈS que Sanity a validé le
5
+ * secret de Presentation : l'éditeur connecté au Studio peut ainsi voir la préproduction
6
+ * dans l'iframe de Presentation sans laissez-passer ni connexion. Vérifiée par
7
+ * `ncfPreviewGuard` en Web Crypto (middleware compatible Edge et Node).
8
+ *
9
+ * Clé : `NCF_PREVIEW_SECRET`, sinon le jeton de lecture Sanity du site
10
+ * (`SANITY_API_READ_TOKEN`), secret côté serveur. Sans clé : pas de session.
11
+ */
12
+ export const SESSION_COOKIE = 'ncf_preview_session'
13
+ export const SESSION_TTL_MS = 12 * 60 * 60 * 1000
14
+
15
+ const encoder = new TextEncoder()
16
+
17
+ export function previewSecret(env: Record<string, string | undefined> = process.env): string | null {
18
+ return env.NCF_PREVIEW_SECRET?.trim() || env.SANITY_API_READ_TOKEN?.trim() || null
19
+ }
20
+
21
+ function base64url(bytes: ArrayBuffer): string {
22
+ let binary = ''
23
+ for (const b of new Uint8Array(bytes)) binary += String.fromCharCode(b)
24
+ return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '')
25
+ }
26
+
27
+ async function hmac(secret: string, message: string): Promise<string> {
28
+ const key = await crypto.subtle.importKey('raw', encoder.encode(secret), {name: 'HMAC', hash: 'SHA-256'}, false, ['sign'])
29
+ return base64url(await crypto.subtle.sign('HMAC', key, encoder.encode(message)))
30
+ }
31
+
32
+ /** Comparaison à temps constant (pas d'indice sur la signature attendue). */
33
+ function sameString(a: string, b: string): boolean {
34
+ if (a.length !== b.length) return false
35
+ let diff = 0
36
+ for (let i = 0; i < a.length; i++) diff |= a.charCodeAt(i) ^ b.charCodeAt(i)
37
+ return diff === 0
38
+ }
39
+
40
+ /** Valeur de cookie signée, valable `ttl` ms. */
41
+ export async function signPreviewSession(secret: string, now = Date.now(), ttl = SESSION_TTL_MS): Promise<string> {
42
+ const expires = now + ttl
43
+ return `${expires}.${await hmac(secret, `ncf-preview-session:${expires}`)}`
44
+ }
45
+
46
+ /** Vraie seulement pour une session signée avec cette clé et non expirée. */
47
+ export async function verifyPreviewSession(value: string | undefined | null, secret: string | null, now = Date.now()): Promise<boolean> {
48
+ if (!value || !secret) return false
49
+ const dot = value.indexOf('.')
50
+ if (dot <= 0) return false
51
+ const expires = Number(value.slice(0, dot))
52
+ if (!Number.isFinite(expires) || expires <= now || expires > now + SESSION_TTL_MS + 60_000) return false
53
+ return sameString(value.slice(dot + 1), await hmac(secret, `ncf-preview-session:${expires}`))
54
+ }
package/src/web/server.ts CHANGED
@@ -7,6 +7,10 @@
7
7
  * ```
8
8
  */
9
9
  export {ncfDraftModeToggle} from './draftModeToggle'
10
+ export {ncfEnableDraftMode} from './enableDraftMode'
11
+ export {isDraftData, dataPerspective, PERSPECTIVE_COOKIE} from './dataMode'
12
+ export type {DataPerspective} from './dataMode'
13
+ export {signPreviewSession, verifyPreviewSession, previewSecret, SESSION_COOKIE} from './previewSession'
10
14
  export type {DraftModeToggleOptions} from './draftModeToggle'
11
15
  export {isProductionSite, isPreviewSite} from './environment'
12
16
  export {