@nocode-factory/sanity-kit 2.0.0 → 2.1.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,3 +1,4 @@
1
+ import { NextRequest, NextResponse } from "next/server.js";
1
2
  interface DraftModeToggleOptions {
2
3
  /**
3
4
  * Chemin de repli après la bascule, quand la page d'origine est inconnue.
@@ -42,5 +43,43 @@ export declare function ncfDraftModeToggle(options?: DraftModeToggleOptions): {
42
43
  export declare function isProductionSite(): boolean;
43
44
  /** L'inverse, pour se lire à l'endroit dans un layout. */
44
45
  export declare const isPreviewSite: () => boolean;
45
- export type { DraftModeToggleOptions };
46
+ /** Paramètre d'URL porteur du laissez-passer, et cookie qui le mémorise. */
47
+ export declare const GRANT_PARAM = "ncf_preview";
48
+ export declare const GRANT_COOKIE = "ncf_preview_grant";
49
+ interface PreviewGuardOptions {
50
+ /** Base des Edge Functions du kit. */
51
+ endpoint?: string;
52
+ /** Chemins toujours ouverts, en plus des ressources internes de Next. */
53
+ publicPaths?: string[];
54
+ }
55
+ /**
56
+ * Vérifie un laissez-passer auprès du service.
57
+ *
58
+ * Le résultat n'est pas mis en cache : révoquer un lien doit couper l'accès
59
+ * tout de suite, pas à l'expiration d'un cache. Un appel par navigation reste
60
+ * négligeable devant le rendu d'une page.
61
+ */
62
+ export declare function checkGrant(token: string, endpoint?: string): Promise<boolean>;
63
+ /** Le visiteur a-t-il déjà un laissez-passer valide en cookie ? */
64
+ export declare function hasPreviewGrant(endpoint?: string): Promise<boolean>;
65
+ /**
66
+ * Garde de préversion, à monter dans le middleware du site.
67
+ *
68
+ * ```ts
69
+ * // middleware.ts
70
+ * export async function middleware(request: NextRequest) {
71
+ * const guarded = await ncfPreviewGuard(request)
72
+ * if (guarded) return guarded
73
+ * // … votre middleware
74
+ * }
75
+ * ```
76
+ *
77
+ * Ne fait rien en production : le site public reste public. Sur une
78
+ * préversion, exige un laissez-passer — celui de l'URL, qu'il mémorise en
79
+ * cookie, ou celui déjà mémorisé.
80
+ *
81
+ * Rend `null` quand la requête peut suivre son cours.
82
+ */
83
+ export declare function ncfPreviewGuard(request: NextRequest, options?: PreviewGuardOptions): Promise<NextResponse | null>;
84
+ export type { DraftModeToggleOptions, PreviewGuardOptions };
46
85
  //# sourceMappingURL=web-server.d.ts.map
@@ -1,4 +1,4 @@
1
- import { draftMode } from "next/headers.js";
1
+ import { cookies, draftMode } from "next/headers.js";
2
2
  import { NextResponse } from "next/server.js";
3
3
  /**
4
4
  * Outils destinés au **front** d'un site, pas au Studio.
@@ -46,6 +46,88 @@ function ncfDraftModeToggle(options = {}) {
46
46
  return NextResponse.redirect(new URL(target, request.url));
47
47
  } };
48
48
  }
49
- export { isPreviewSite, isProductionSite, ncfDraftModeToggle };
49
+ /** Paramètre d'URL porteur du laissez-passer, et cookie qui le mémorise. */
50
+ const GRANT_PARAM = "ncf_preview", GRANT_COOKIE = "ncf_preview_grant", DEFAULT_ENDPOINT = "https://dkoxgivytgsmvqmjvmjt.supabase.co/functions/v1";
51
+ /**
52
+ * Vérifie un laissez-passer auprès du service.
53
+ *
54
+ * Le résultat n'est pas mis en cache : révoquer un lien doit couper l'accès
55
+ * tout de suite, pas à l'expiration d'un cache. Un appel par navigation reste
56
+ * négligeable devant le rendu d'une page.
57
+ */
58
+ async function checkGrant(token, endpoint = DEFAULT_ENDPOINT) {
59
+ if (!token) return !1;
60
+ try {
61
+ let response = await fetch(`${endpoint}/preview-link?token=${encodeURIComponent(token)}`, { cache: "no-store" });
62
+ return response.ok ? (await response.json()).valid === !0 : !1;
63
+ } catch {
64
+ return !1;
65
+ }
66
+ }
67
+ /** Le visiteur a-t-il déjà un laissez-passer valide en cookie ? */
68
+ async function hasPreviewGrant(endpoint = DEFAULT_ENDPOINT) {
69
+ let token = (await cookies()).get(GRANT_COOKIE)?.value;
70
+ return token ? checkGrant(token, endpoint) : !1;
71
+ }
72
+ const ALWAYS_OPEN = [
73
+ "/_next/",
74
+ "/favicon",
75
+ "/robots.txt",
76
+ "/sitemap.xml",
77
+ "/api/draft-mode/"
78
+ ];
79
+ /**
80
+ * Garde de préversion, à monter dans le middleware du site.
81
+ *
82
+ * ```ts
83
+ * // middleware.ts
84
+ * export async function middleware(request: NextRequest) {
85
+ * const guarded = await ncfPreviewGuard(request)
86
+ * if (guarded) return guarded
87
+ * // … votre middleware
88
+ * }
89
+ * ```
90
+ *
91
+ * Ne fait rien en production : le site public reste public. Sur une
92
+ * préversion, exige un laissez-passer — celui de l'URL, qu'il mémorise en
93
+ * cookie, ou celui déjà mémorisé.
94
+ *
95
+ * Rend `null` quand la requête peut suivre son cours.
96
+ */
97
+ async function ncfPreviewGuard(request, options = {}) {
98
+ if (process.env.VERCEL_ENV === "production") return null;
99
+ let { pathname, searchParams } = request.nextUrl;
100
+ if ([...ALWAYS_OPEN, ...options.publicPaths ?? []].some((prefix) => pathname.startsWith(prefix))) return null;
101
+ let endpoint = options.endpoint ?? DEFAULT_ENDPOINT, fromUrl = searchParams.get(GRANT_PARAM);
102
+ if (fromUrl) {
103
+ if (!await checkGrant(fromUrl, endpoint)) return refuse(request);
104
+ let clean = request.nextUrl.clone();
105
+ clean.searchParams.delete(GRANT_PARAM);
106
+ let response = NextResponse.redirect(clean);
107
+ return response.cookies.set(GRANT_COOKIE, fromUrl, {
108
+ httpOnly: !0,
109
+ sameSite: "lax",
110
+ secure: request.nextUrl.protocol === "https:",
111
+ path: "/",
112
+ maxAge: 2592e3
113
+ }), response;
114
+ }
115
+ let fromCookie = request.cookies.get(GRANT_COOKIE)?.value;
116
+ return fromCookie && await checkGrant(fromCookie, endpoint) ? null : refuse(request);
117
+ }
118
+ /**
119
+ * Refus explicite, en texte clair.
120
+ *
121
+ * Ni redirection ni page blanche : quelqu'un qui tombe là doit comprendre
122
+ * qu'il lui manque un lien, et à qui le demander.
123
+ */
124
+ function refuse(request) {
125
+ return (request.headers.get("accept") ?? "").includes("text/html") ? new NextResponse(PAGE, {
126
+ status: 401,
127
+ headers: { "content-type": "text/html; charset=utf-8" }
128
+ }) : NextResponse.json({ error: "preview_grant_required" }, { status: 401 });
129
+ }
130
+ 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 };
50
132
 
51
133
  //# sourceMappingURL=web-server.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"web-server.js","names":[],"sources":["../src/web/environment.ts","../src/web/draftModeToggle.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"],"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"}
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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nocode-factory/sanity-kit",
3
- "version": "2.0.0",
3
+ "version": "2.1.0",
4
4
  "description": "Outils Studio de NoCode Factory : Pages (liste + board), Composants, Historique",
5
5
  "license": "UNLICENSED",
6
6
  "private": false,
package/src/index.ts CHANGED
@@ -172,6 +172,9 @@ export {
172
172
  export type {PreviewPerspective, PresentationOptions} from './lib/studioLinks'
173
173
  export {usePreviewTarget} from './context/PreviewTargetContext'
174
174
  export {NcfPreviewHeader, ncfPreviewComponents} from './tools/presentation/PreviewHeader'
175
+ export {SharePreview} from './tools/pages/SharePreview'
176
+ export {requestPreviewGrant, explainGrantError} from './lib/service'
177
+ export type {PreviewGrant} from './lib/service'
175
178
  export type {PreviewTargetState} from './hooks/usePreviewTarget'
176
179
  export type {Change, ChangeKind, Segment} from './lib/diff'
177
180
  export {announce, fetchTimeline, fetchDetail} from './lib/service'
@@ -86,3 +86,39 @@ export async function fetchDetail(
86
86
  ): Promise<HistoryDetail> {
87
87
  return post(`${endpoint}/history`, {key, mode: 'detail', eventId}, signal)
88
88
  }
89
+
90
+
91
+ /* --- Laissez-passer de préversion --- */
92
+
93
+ export interface PreviewGrant {
94
+ token: string
95
+ expiresAt: string
96
+ issuedBy: string
97
+ }
98
+
99
+ /**
100
+ * Demande un laissez-passer au service.
101
+ *
102
+ * Le jeton Sanity de l'éditeur accompagne la demande : c'est lui, et rien
103
+ * d'autre, qui prouve au service qu'on a accès au projet. Sans lui la demande
104
+ * est refusée — le kit étant public, un identifiant de projet ne prouve rien.
105
+ */
106
+ export async function requestPreviewGrant(
107
+ endpoint: string,
108
+ payload: {projectId: string; dataset: string; sanityToken: string; label?: string; days?: number},
109
+ signal?: AbortSignal,
110
+ ): Promise<PreviewGrant> {
111
+ return post<PreviewGrant>(`${endpoint}/preview-link`, payload, signal)
112
+ }
113
+
114
+ /** Messages du service, rendus lisibles pour un éditeur. */
115
+ export function explainGrantError(error: unknown): string {
116
+ const code = error instanceof Error ? error.message : String(error)
117
+ if (code === 'missing_sanity_token') {
118
+ return "Votre session Sanity n'expose pas de jeton : impossible de prouver votre accès au projet."
119
+ }
120
+ if (code === 'no_project_access') return "Votre compte n'a pas accès à ce projet Sanity."
121
+ if (code === 'project_inactive') return "Ce projet n'est pas actif chez NoCode Factory."
122
+ if (code === 'unknown_project') return "Ce projet n'est pas enregistré chez NoCode Factory."
123
+ return "Le lien n'a pas pu être créé."
124
+ }
@@ -8,6 +8,7 @@ import {usePages} from '../../hooks/usePages'
8
8
  import {useDocumentColumns} from '../../hooks/useDocumentColumns'
9
9
  import {usePreviewTarget} from '../../context/PreviewTargetContext'
10
10
  import {PreviewTarget} from './PreviewTarget'
11
+ import {SharePreview} from './SharePreview'
11
12
  import {filterRows, sortRows, type PageRow, type SortDirection, type SortKey} from '../../lib/pages'
12
13
  import {groupPageRows, type GroupBy} from '../../lib/grouping'
13
14
  import {resolveColorBy, type ColorBy} from '../../lib/colors'
@@ -164,6 +165,10 @@ export function PagesTool() {
164
165
  customUrl={preview.customUrl}
165
166
  />
166
167
 
168
+ <Box style={{flex: 'none', paddingBottom: 2}}>
169
+ <SharePreview />
170
+ </Box>
171
+
167
172
  {view === 'list' && (
168
173
  <Box style={{flex: 'none', paddingBottom: 2}}>
169
174
  <ColumnVisibility
@@ -0,0 +1,197 @@
1
+ import {useCallback, useState} from 'react'
2
+ import {Box, Button, Card, Flex, Spinner, Stack, Text, TextInput} from '@sanity/ui'
3
+ import {ShareIcon} from '@sanity/icons/Share'
4
+ import {CheckmarkIcon} from '@sanity/icons/Checkmark'
5
+ import {InlinePopover} from '../../ui/Popover'
6
+ import {useKitConfig} from '../../context/KitContext'
7
+ import {useKitClient} from '../../hooks/useKitClient'
8
+ import {usePreviewTarget} from '../../context/PreviewTargetContext'
9
+ import {explainGrantError, requestPreviewGrant} from '../../lib/service'
10
+ import {BORDER, MONO} from '../../ui/tokens'
11
+
12
+ /** Durées proposées. Au-delà d'un mois, un lien oublié traîne trop longtemps. */
13
+ const DURATIONS = [
14
+ {days: 1, label: '1 jour'},
15
+ {days: 7, label: '7 jours'},
16
+ {days: 30, label: '30 jours'},
17
+ ]
18
+
19
+ /**
20
+ * Délivre un lien de préversion à partager.
21
+ *
22
+ * Le lien **est** l'autorisation : celui qui le reçoit voit le site de
23
+ * préproduction et peut y basculer entre brouillons et contenu en ligne, sans
24
+ * compte ni connexion. C'est tout l'intérêt pour faire relire un client.
25
+ *
26
+ * Il n'est délivré qu'à qui a déjà accès au projet Sanity — le service le
27
+ * vérifie auprès de Sanity, il ne croit pas le Studio sur parole.
28
+ */
29
+ export function SharePreview() {
30
+ const config = useKitConfig()
31
+ const client = useKitClient()
32
+ const {environment} = usePreviewTarget()
33
+
34
+ const [link, setLink] = useState<string | null>(null)
35
+ const [expiresAt, setExpiresAt] = useState<string | null>(null)
36
+ const [busy, setBusy] = useState(false)
37
+ const [error, setError] = useState<string | null>(null)
38
+ const [copied, setCopied] = useState(false)
39
+ const [label, setLabel] = useState('')
40
+
41
+ const endpoint = config.serviceEndpoint
42
+ const {projectId, dataset, token} = client.config()
43
+
44
+ const issue = useCallback(
45
+ async (days: number) => {
46
+ if (!endpoint || !projectId || !dataset || !environment) return
47
+ setBusy(true)
48
+ setError(null)
49
+ setCopied(false)
50
+ try {
51
+ const grant = await requestPreviewGrant(endpoint, {
52
+ projectId,
53
+ dataset,
54
+ sanityToken: token ?? '',
55
+ label: label.trim() || undefined,
56
+ days,
57
+ })
58
+ const url = new URL(environment.url)
59
+ url.searchParams.set('ncf_preview', grant.token)
60
+ setLink(url.toString())
61
+ setExpiresAt(grant.expiresAt)
62
+ } catch (cause) {
63
+ setError(explainGrantError(cause))
64
+ } finally {
65
+ setBusy(false)
66
+ }
67
+ },
68
+ [endpoint, projectId, dataset, environment, token, label],
69
+ )
70
+
71
+ const copy = async () => {
72
+ if (!link) return
73
+ try {
74
+ await navigator.clipboard.writeText(link)
75
+ setCopied(true)
76
+ } catch {
77
+ // Presse-papiers refusé : le champ reste sélectionnable à la main.
78
+ setCopied(false)
79
+ }
80
+ }
81
+
82
+ if (!endpoint) return null
83
+
84
+ return (
85
+ <InlinePopover
86
+ width={320}
87
+ trigger={({toggle}) => (
88
+ <Button
89
+ mode="bleed"
90
+ fontSize={1}
91
+ padding={2}
92
+ icon={ShareIcon}
93
+ text="Partager la préversion"
94
+ title="Créer un lien que n'importe qui peut ouvrir, sans compte"
95
+ onClick={toggle}
96
+ />
97
+ )}
98
+ >
99
+ {() => (
100
+ <Stack gap={3} padding={2}>
101
+ <Text size={0} muted>
102
+ Un lien qui ouvre <b>{environment?.label ?? 'le site'}</b> et permet d'y basculer
103
+ entre brouillons et contenu en ligne. Celui qui l'a n'a besoin d'aucun compte.
104
+ </Text>
105
+
106
+ {!link && (
107
+ <>
108
+ <TextInput
109
+ fontSize={1}
110
+ padding={2}
111
+ radius={2}
112
+ placeholder="À quoi sert ce lien ? (facultatif)"
113
+ value={label}
114
+ onChange={(event) => setLabel(event.currentTarget.value)}
115
+ />
116
+ <Flex gap={1}>
117
+ {DURATIONS.map((duration) => (
118
+ <Button
119
+ key={duration.days}
120
+ mode="ghost"
121
+ fontSize={1}
122
+ padding={2}
123
+ text={duration.label}
124
+ disabled={busy}
125
+ onClick={() => issue(duration.days)}
126
+ />
127
+ ))}
128
+ </Flex>
129
+ </>
130
+ )}
131
+
132
+ {busy && (
133
+ <Flex align="center" gap={2}>
134
+ <Spinner muted />
135
+ <Text size={1} muted>
136
+ Création…
137
+ </Text>
138
+ </Flex>
139
+ )}
140
+
141
+ {error && (
142
+ <Card padding={3} radius={2} tone="critical">
143
+ <Text size={1}>{error}</Text>
144
+ </Card>
145
+ )}
146
+
147
+ {link && (
148
+ <Stack gap={2}>
149
+ <Box
150
+ padding={2}
151
+ style={{
152
+ border: `1px solid ${BORDER}`,
153
+ borderRadius: 3,
154
+ maxHeight: 72,
155
+ overflow: 'auto',
156
+ }}
157
+ >
158
+ <Text size={0} style={{...MONO, wordBreak: 'break-all'}}>
159
+ {link}
160
+ </Text>
161
+ </Box>
162
+
163
+ <Flex gap={2}>
164
+ <Button
165
+ mode="default"
166
+ tone="primary"
167
+ fontSize={1}
168
+ padding={2}
169
+ icon={copied ? CheckmarkIcon : ShareIcon}
170
+ text={copied ? 'Copié' : 'Copier le lien'}
171
+ onClick={copy}
172
+ />
173
+ <Button
174
+ mode="bleed"
175
+ fontSize={1}
176
+ padding={2}
177
+ text="Un autre"
178
+ onClick={() => {
179
+ setLink(null)
180
+ setCopied(false)
181
+ }}
182
+ />
183
+ </Flex>
184
+
185
+ {expiresAt && (
186
+ <Text size={0} muted>
187
+ Valable jusqu'au {new Date(expiresAt).toLocaleDateString('fr-FR')}. Révocable à
188
+ tout moment par NoCode Factory.
189
+ </Text>
190
+ )}
191
+ </Stack>
192
+ )}
193
+ </Stack>
194
+ )}
195
+ </InlinePopover>
196
+ )
197
+ }
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.0.0'
5
+ export const KIT_VERSION = '2.1.0'
@@ -0,0 +1,134 @@
1
+ import {cookies} from 'next/headers'
2
+ import {NextResponse, type NextRequest} from 'next/server'
3
+
4
+ /** Paramètre d'URL porteur du laissez-passer, et cookie qui le mémorise. */
5
+ export const GRANT_PARAM = 'ncf_preview'
6
+ export const GRANT_COOKIE = 'ncf_preview_grant'
7
+
8
+ const DEFAULT_ENDPOINT = 'https://dkoxgivytgsmvqmjvmjt.supabase.co/functions/v1'
9
+
10
+ export interface PreviewGuardOptions {
11
+ /** Base des Edge Functions du kit. */
12
+ endpoint?: string
13
+ /** Chemins toujours ouverts, en plus des ressources internes de Next. */
14
+ publicPaths?: string[]
15
+ }
16
+
17
+ /**
18
+ * Vérifie un laissez-passer auprès du service.
19
+ *
20
+ * Le résultat n'est pas mis en cache : révoquer un lien doit couper l'accès
21
+ * tout de suite, pas à l'expiration d'un cache. Un appel par navigation reste
22
+ * négligeable devant le rendu d'une page.
23
+ */
24
+ export async function checkGrant(token: string, endpoint = DEFAULT_ENDPOINT): Promise<boolean> {
25
+ if (!token) return false
26
+ try {
27
+ const response = await fetch(
28
+ `${endpoint}/preview-link?token=${encodeURIComponent(token)}`,
29
+ {cache: 'no-store'},
30
+ )
31
+ if (!response.ok) return false
32
+ const body = (await response.json()) as {valid?: boolean}
33
+ return body.valid === true
34
+ } catch {
35
+ // Service injoignable : on refuse. Une porte qui s'ouvre quand la serrure
36
+ // est en panne n'est pas une porte.
37
+ return false
38
+ }
39
+ }
40
+
41
+ /** Le visiteur a-t-il déjà un laissez-passer valide en cookie ? */
42
+ export async function hasPreviewGrant(endpoint = DEFAULT_ENDPOINT): Promise<boolean> {
43
+ const token = (await cookies()).get(GRANT_COOKIE)?.value
44
+ return token ? checkGrant(token, endpoint) : false
45
+ }
46
+
47
+ const ALWAYS_OPEN = ['/_next/', '/favicon', '/robots.txt', '/sitemap.xml', '/api/draft-mode/']
48
+
49
+ /**
50
+ * Garde de préversion, à monter dans le middleware du site.
51
+ *
52
+ * ```ts
53
+ * // middleware.ts
54
+ * export async function middleware(request: NextRequest) {
55
+ * const guarded = await ncfPreviewGuard(request)
56
+ * if (guarded) return guarded
57
+ * // … votre middleware
58
+ * }
59
+ * ```
60
+ *
61
+ * Ne fait rien en production : le site public reste public. Sur une
62
+ * préversion, exige un laissez-passer — celui de l'URL, qu'il mémorise en
63
+ * cookie, ou celui déjà mémorisé.
64
+ *
65
+ * Rend `null` quand la requête peut suivre son cours.
66
+ */
67
+ export async function ncfPreviewGuard(
68
+ request: NextRequest,
69
+ options: PreviewGuardOptions = {},
70
+ ): Promise<NextResponse | null> {
71
+ if (process.env.VERCEL_ENV === 'production') return null
72
+
73
+ const {pathname, searchParams} = request.nextUrl
74
+ const open = [...ALWAYS_OPEN, ...(options.publicPaths ?? [])]
75
+ if (open.some((prefix) => pathname.startsWith(prefix))) return null
76
+
77
+ const endpoint = options.endpoint ?? DEFAULT_ENDPOINT
78
+
79
+ // Un laissez-passer dans l'URL : on le valide, on le mémorise, et on retire
80
+ // le paramètre — pour qu'il ne traîne pas dans l'historique ni dans les
81
+ // liens partagés depuis la page.
82
+ const fromUrl = searchParams.get(GRANT_PARAM)
83
+ if (fromUrl) {
84
+ if (!(await checkGrant(fromUrl, endpoint))) return refuse(request)
85
+
86
+ const clean = request.nextUrl.clone()
87
+ clean.searchParams.delete(GRANT_PARAM)
88
+ const response = NextResponse.redirect(clean)
89
+ response.cookies.set(GRANT_COOKIE, fromUrl, {
90
+ httpOnly: true,
91
+ sameSite: 'lax',
92
+ secure: request.nextUrl.protocol === 'https:',
93
+ path: '/',
94
+ maxAge: 60 * 60 * 24 * 30,
95
+ })
96
+ return response
97
+ }
98
+
99
+ const fromCookie = request.cookies.get(GRANT_COOKIE)?.value
100
+ if (fromCookie && (await checkGrant(fromCookie, endpoint))) return null
101
+
102
+ return refuse(request)
103
+ }
104
+
105
+ /**
106
+ * Refus explicite, en texte clair.
107
+ *
108
+ * Ni redirection ni page blanche : quelqu'un qui tombe là doit comprendre
109
+ * qu'il lui manque un lien, et à qui le demander.
110
+ */
111
+ function refuse(request: NextRequest): NextResponse {
112
+ const accepts = request.headers.get('accept') ?? ''
113
+ if (!accepts.includes('text/html')) {
114
+ return NextResponse.json({error: 'preview_grant_required'}, {status: 401})
115
+ }
116
+
117
+ return new NextResponse(PAGE, {
118
+ status: 401,
119
+ headers: {'content-type': 'text/html; charset=utf-8'},
120
+ })
121
+ }
122
+
123
+ const PAGE = `<!doctype html>
124
+ <html lang="fr"><head><meta charset="utf-8">
125
+ <meta name="viewport" content="width=device-width,initial-scale=1">
126
+ <meta name="robots" content="noindex">
127
+ <title>Préversion privée</title></head>
128
+ <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">
129
+ <main style="max-width:30rem;padding:2rem;text-align:center">
130
+ <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">
131
+ <span style="width:7px;height:7px;border-radius:50%;background:#d97706"></span>Préversion</p>
132
+ <h1 style="margin:0 0 .75rem;font-size:1.375rem;font-weight:600">Cette version du site est privée</h1>
133
+ <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>
134
+ </main></body></html>`
package/src/web/server.ts CHANGED
@@ -9,3 +9,5 @@
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'
13
+ export type {PreviewGuardOptions} from './previewGrant'