@nocode-factory/sanity-kit 2.0.0 → 2.1.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.
@@ -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.1",
4
4
  "description": "Outils Studio de NoCode Factory : Pages (liste + board), Composants, Historique",
5
5
  "license": "UNLICENSED",
6
6
  "private": false,
@@ -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,
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'
@@ -162,8 +163,13 @@ export function PagesTool() {
162
163
  onPerspective={preview.setPerspective}
163
164
  onCustomUrl={preview.setCustomUrl}
164
165
  customUrl={preview.customUrl}
166
+ productionUrl={config.previewUrl}
165
167
  />
166
168
 
169
+ <Box style={{flex: 'none', paddingBottom: 2}}>
170
+ <SharePreview />
171
+ </Box>
172
+
167
173
  {view === 'list' && (
168
174
  <Box style={{flex: 'none', paddingBottom: 2}}>
169
175
  <ColumnVisibility
@@ -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
@@ -0,0 +1,220 @@
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, isProduction} = 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
+ {/* 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
+ <>
122
+ <Text size={0} muted>
123
+ Un lien qui ouvre <b>{environment?.label ?? 'le site'}</b> et permet d'y basculer
124
+ entre brouillons et contenu en ligne. Celui qui l'a n'a besoin d'aucun compte.
125
+ </Text>
126
+
127
+ {!link && (
128
+ <>
129
+ <TextInput
130
+ fontSize={1}
131
+ padding={2}
132
+ radius={2}
133
+ placeholder="À quoi sert ce lien ? (facultatif)"
134
+ value={label}
135
+ onChange={(event) => setLabel(event.currentTarget.value)}
136
+ />
137
+ <Flex gap={1}>
138
+ {DURATIONS.map((duration) => (
139
+ <Button
140
+ key={duration.days}
141
+ mode="ghost"
142
+ fontSize={1}
143
+ padding={2}
144
+ text={duration.label}
145
+ disabled={busy}
146
+ onClick={() => issue(duration.days)}
147
+ />
148
+ ))}
149
+ </Flex>
150
+ </>
151
+ )}
152
+
153
+ {busy && (
154
+ <Flex align="center" gap={2}>
155
+ <Spinner muted />
156
+ <Text size={1} muted>
157
+ Création…
158
+ </Text>
159
+ </Flex>
160
+ )}
161
+
162
+ {error && (
163
+ <Card padding={3} radius={2} tone="critical">
164
+ <Text size={1}>{error}</Text>
165
+ </Card>
166
+ )}
167
+
168
+ {link && (
169
+ <Stack gap={2}>
170
+ <Box
171
+ padding={2}
172
+ style={{
173
+ border: `1px solid ${BORDER}`,
174
+ borderRadius: 3,
175
+ maxHeight: 72,
176
+ overflow: 'auto',
177
+ }}
178
+ >
179
+ <Text size={0} style={{...MONO, wordBreak: 'break-all'}}>
180
+ {link}
181
+ </Text>
182
+ </Box>
183
+
184
+ <Flex gap={2}>
185
+ <Button
186
+ mode="default"
187
+ tone="primary"
188
+ fontSize={1}
189
+ padding={2}
190
+ icon={copied ? CheckmarkIcon : ShareIcon}
191
+ text={copied ? 'Copié' : 'Copier le lien'}
192
+ onClick={copy}
193
+ />
194
+ <Button
195
+ mode="bleed"
196
+ fontSize={1}
197
+ padding={2}
198
+ text="Un autre"
199
+ onClick={() => {
200
+ setLink(null)
201
+ setCopied(false)
202
+ }}
203
+ />
204
+ </Flex>
205
+
206
+ {expiresAt && (
207
+ <Text size={0} muted>
208
+ Valable jusqu'au {new Date(expiresAt).toLocaleDateString('fr-FR')}. Révocable à
209
+ tout moment par NoCode Factory.
210
+ </Text>
211
+ )}
212
+ </Stack>
213
+ )}
214
+ </>
215
+ )}
216
+ </Stack>
217
+ )}
218
+ </InlinePopover>
219
+ )
220
+ }
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.1'