@nocode-factory/sanity-kit 2.21.0 → 2.22.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.
package/bin/ncf-kit.mjs CHANGED
@@ -279,6 +279,11 @@ async function doctor() {
279
279
  if (!version) ko('Version du kit', 'non installé dans le studio')
280
280
  else if (latest && version !== latest) warn('Version du kit', `${version} installée, ${latest} disponible : npm install ${PKG}@latest (studio et site)`)
281
281
  else ok('Version du kit', version)
282
+ // Le site embarque aussi le kit (bandeau, garde, liens, valeurs par défaut) : une
283
+ // version différente du Studio = corrections du kit absentes d'un côté.
284
+ const webInstalled = [web, root].map((d) => read(join(d, 'node_modules', PKG, 'package.json'))).find(Boolean)
285
+ const webVersion = webInstalled ? JSON.parse(webInstalled).version : null
286
+ if (webVersion && version && webVersion !== version) warn('Version du kit (site)', `${webVersion} sur le site, ${version} dans le studio : le kit a besoin de la même version des deux côtés ; npm install ${PKG}@latest dans web/ et studio/.`)
282
287
 
283
288
  /* Studio : URLs et clés */
284
289
  const previewUrl = env.SANITY_STUDIO_PREVIEW_URL
@@ -324,25 +329,45 @@ async function doctor() {
324
329
  const chain = [scripts.build, scripts.postbuild].filter(Boolean).join(' ')
325
330
  const runsCheck = /ncf-kit check-environments/.test(chain) || files.some((f) => /\.(m?js|ts)$/.test(f) && chain.includes(f.split('/').pop()) && /ncf-kit[^\n]*check-environments|check-environments/.test(read(f)))
326
331
  runsCheck ? ok('Test prod / préprod', 'lancé après chaque build') : ko('Test prod / préprod', 'le build du site ne lance pas `ncf-kit check-environments` : ajouter "postbuild": "ncf-kit check-environments" dans package.json. Sans lui, une fuite de brouillon en production serait mise en ligne.')
332
+ // Purge de la préprod : un seul webhook Sanity (vers la production), qui RELAIE
333
+ // à la préprod. Sans relais, une page modifiée ou retirée reste servie en préprod.
334
+ if (preprod) {
335
+ const route = files.find((f) => /api\/revalidate\/route\.[jt]s$/.test(f))
336
+ if (!route) ko('Purge de la préprod', "le kit a besoin d'une route /api/revalidate (purge du cache à la publication) ; le projet ne l'a pas : reprendre app/api/revalidate/route.ts du starter, puis le webhook Sanity vers la production.")
337
+ else if (!/PREPROD_URL/.test(read(route))) ko('Purge de la préprod', `le kit a besoin que la production relaie la purge à la préprod (sinon une page retirée du site reste visible en préprod) ; le projet ne l'a pas : relais PREPROD_URL dans ${route.replace(root + '/', '')} (voir le starter), puis PREPROD_URL dans les variables Vercel de Production.`)
338
+ else ok('Purge de la préprod', `${route.replace(root + '/', '')} relaie à PREPROD_URL (variable Vercel de Production)`)
339
+ }
327
340
  }
328
341
 
329
342
  /* Valeurs par défaut des composants : instances, overrides, preview */
330
343
  {
331
344
  const studioFiles = walk(studio)
332
- // LANGUES (site multilingue) : les trois règles des liens vers une page.
345
+ // LANGUES (site multilingue) : ce dont le kit a besoin dans le PROJET pour que
346
+ // les trois règles des liens et la propagation fonctionnent.
333
347
  // 1. pages reliées à leurs traductions (document-internationalization) ;
334
348
  // 2. le choix de la page ne propose que la langue du document, publiées, sans création ;
335
349
  // 3. au rendu, un lien vise la traduction de la page cible dans la langue affichée.
350
+ // Formulation : « le kit a besoin de X (pour Y) ; le projet ne l'a pas : correction ».
336
351
  const locales = String(env.SANITY_STUDIO_LOCALES || '').split(',').map((l) => l.trim()).filter(Boolean)
337
352
  if (locales.length > 1) {
353
+ const need = (what, why, fix) => `le kit a besoin de ${what} (${why}) ; le projet ne l'a pas : ${fix}`
338
354
  const i18nPlugin = studioFiles.some((f) => read(f).includes('documentInternationalization('))
339
- i18nPlugin ? ok('Langues : pages reliées', 'documentInternationalization') : ko('Langues : pages reliées', 'site multilingue sans @sanity/document-internationalization : les pages ne sont pas reliées à leurs traductions (hreflang, bascule de langue).')
355
+ i18nPlugin ? ok('Langues : pages reliées', 'documentInternationalization') : ko('Langues : pages reliées', need('@sanity/document-internationalization', 'hreflang, bascule de langue, propagation', 'ajouter le plugin dans sanity.config.ts (voir le starter).'))
356
+ const kitI18n = /\bi18n\s*:\s*\{[^}]*defaultLocale/.test(config) || studioFiles.some((f) => /\bi18n\s*:\s*\{[^}]*defaultLocale/.test(read(f)) && /ncf/i.test(read(f)))
357
+ kitI18n ? ok('Langues : réglage du kit', 'i18n déclaré') : ko('Langues : réglage du kit', need("l'option i18n de ncfKit", 'propagation aux autres langues, « À traduire », filtre par langue de l\'onglet Pages', "ncfKit({..., i18n: {field: 'language', defaultLocale, locales}}) dans sanity.config.ts."))
340
358
  const picker = studioFiles.find((f) => /disableNew:\s*true/.test(read(f)) && /language == \$lang/.test(read(f)))
341
- picker ? ok('Langues : choix de la page liée', picker.replace(root + '/', '')) : ko('Langues : choix de la page liée', 'le champ « page » des liens doit filtrer sur la langue du document (language == $lang), sans création (disableNew: true) et sans brouillons (voir link.ts du starter).')
359
+ if (!picker) ko('Langues : choix de la page liée', need('un champ « page » des liens filtré', 'règle 2 : langue du document, pages publiées, sans création', 'filter language == $lang et !(_id in path("drafts.**")), disableNew: true (voir link.ts du starter).'))
360
+ else if (!/drafts\.\*\*/.test(read(picker))) ko('Langues : choix de la page liée', need('un filtre sans brouillons', 'règle 2 : une page liée doit être publiée', `ajouter !(_id in path("drafts.**")) au filtre de ${picker.replace(root + '/', '')}.`))
361
+ else ok('Langues : choix de la page liée', picker.replace(root + '/', ''))
362
+ if (picker) /weak:\s*true/.test(read(picker)) ? ok('Liens : référence faible', picker.replace(root + '/', '')) : warn('Liens : référence faible', need('des références faibles (weak: true) sur les liens', '« Retirer du site » et la suppression d\'une page liée ne sont pas bloqués', `weak: true sur la référence « page » de ${picker.replace(root + '/', '')}.`))
342
363
  if (webPkg) {
343
364
  const render = walk(web).find((f) => /translation\.metadata/.test(read(f)) && /resolveLink|LINK_PROJECTION/.test(read(f)))
344
- render ? ok('Langues : lien dans la langue affichée', render.replace(root + '/', '')) : ko('Langues : lien dans la langue affichée', "un lien vers une page doit être rendu vers sa traduction dans la langue affichée (traductions de la page liée via translation.metadata, voir LINK_PROJECTION et resolveLink du starter).")
365
+ render ? ok('Langues : lien dans la langue affichée', render.replace(root + '/', '')) : ko('Langues : lien dans la langue affichée', need('un rendu des liens dans la langue affichée', 'règle 3 : un lien recopié par la propagation doit viser la traduction', 'traductions de la page liée via translation.metadata dans LINK_PROJECTION et resolveLink (voir le starter).'))
345
366
  }
367
+ const ci = walk(join(root, '.github', 'workflows')).some((f) => /check-translations/.test(read(f)))
368
+ ci ? ok('Langues : contrôle des données', 'check-translations en CI') : warn('Langues : contrôle des données', need('un contrôle des données en CI', 'pages sans traduction reliée, liens vers une autre langue', 'studio/scripts/check-translations.ts et son étape dans .github/workflows/ci.yml (voir le starter).'))
369
+ const rules = read(join(root, 'CLAUDE.md'))
370
+ rules && !/trois règles/i.test(rules) && warn('Langues : consignes', need('les trois règles des langues dans CLAUDE.md', 'Claude ne les connaîtrait pas dans ce projet', 'recopier le bloc « LANGUES » du CLAUDE.md du starter.'))
346
371
  }
347
372
  const hasDefaults = studioFiles.some((f) => /defineComponentDefaults\(|name:\s*['"]componentDefaults['"]/.test(read(f)))
348
373
  if (!hasDefaults) {
@@ -371,6 +396,14 @@ async function doctor() {
371
396
  }
372
397
  }
373
398
 
399
+ /* Schéma validé en CI : un document que le schéma refuse bloque le déploiement du Studio */
400
+ {
401
+ const wf = walk(join(root, '.github', 'workflows'))
402
+ wf.some((f) => /sanity schema validate/.test(read(f)))
403
+ ? ok('Schéma validé en CI', 'sanity schema validate')
404
+ : warn('Schéma validé en CI', "le kit a besoin d'un schéma valide (valeurs par défaut des composants générées depuis les sections) ; le projet ne le vérifie pas : étape `npx sanity schema validate` dans .github/workflows/ci.yml (voir le starter). Sinon `sanity deploy` peut échouer sans prévenir.")
405
+ }
406
+
374
407
  /* Captures des composants */
375
408
  const workflows = walk(join(root, '.github', 'workflows'))
376
409
  const captures = workflows.find((f) => /public\/sections/.test(read(f)))
@@ -378,6 +411,28 @@ async function doctor() {
378
411
 
379
412
  /* En ligne */
380
413
  if (!offline) {
414
+ // Purge du cache à la publication : webhook Sanity vers la PRODUCTION
415
+ // (/api/revalidate), qui relaie à la préprod. Sans lui, rien ne se met à jour
416
+ // sur le site avant le prochain build.
417
+ if (previewUrl && !/localhost/.test(previewUrl)) {
418
+ const endpoint = `${previewUrl.replace(/\/+$/, '')}/api/revalidate`
419
+ const route = await probe(endpoint, {method: 'POST', headers: {'content-type': 'application/json'}, body: '{}'})
420
+ if (route.status === 404) ko('Purge du cache (route)', `${endpoint} : 404. Le kit a besoin de la route /api/revalidate en production ; le projet ne l'a pas (ou pas déployée) : reprendre app/api/revalidate/route.ts du starter.`)
421
+ else if (route.status) ok('Purge du cache (route)', `${endpoint} répond (${route.status} sans signature)`)
422
+ const projectId = env.SANITY_STUDIO_PROJECT_ID
423
+ const token = sanityToken()
424
+ if (projectId && token) {
425
+ const list = await request(`${SANITY_API}/v2021-10-04/hooks/projects/${projectId}`, {headers: {authorization: `Bearer ${token}`}})
426
+ const hooks = Array.isArray(list.body) ? list.body : []
427
+ const host = new URL(previewUrl).host
428
+ const hook = hooks.find((h) => typeof h.url === 'string' && /\/api\/revalidate/.test(h.url) && h.url.includes(host))
429
+ if (!list.ok) warn('Purge du cache (webhook)', `webhooks Sanity illisibles (${list.status}) : le jeton administre-t-il ce projet ?`)
430
+ else if (!hook) ko('Purge du cache (webhook)', `le kit a besoin d'un webhook Sanity vers ${endpoint} (purge du cache à la publication, relayée à la préprod) ; le projet ne l'a pas : Sanity → API → Webhooks, avec le secret SANITY_REVALIDATE_SECRET (voir PASSATION du starter).`)
431
+ else if (hook.isDisabled || hook.isDisabledByUser) ko('Purge du cache (webhook)', `webhook « ${hook.name} » désactivé : la publication ne purge plus le cache.`)
432
+ else ok('Purge du cache (webhook)', `« ${hook.name} » → ${hook.url.split('?')[0]}`) // jamais le secret à l'écran
433
+ } else warn('Purge du cache (webhook)', 'non vérifié : SANITY_STUDIO_PROJECT_ID ou jeton Sanity absent (npx sanity login).')
434
+ }
435
+
381
436
  if (previewUrl && !/localhost/.test(previewUrl)) {
382
437
  const r = await probe(previewUrl)
383
438
  r.status && r.status < 500 ? ok('Site en ligne', `${previewUrl} répond (${r.status})`) : ko('Site en ligne', `${previewUrl} : ${r.error ?? r.status}`)
package/dist/index.d.ts CHANGED
@@ -1339,7 +1339,7 @@ export declare function ActorName(props: {
1339
1339
  * quelle version. Recopiée de `package.json` par `npm version` (scripts/sync-version.mjs) ; un test
1340
1340
  * le vérifie.
1341
1341
  */
1342
- export declare const KIT_VERSION = "2.21.0";
1342
+ export declare const KIT_VERSION = "2.22.0";
1343
1343
  /**
1344
1344
  * Données de la page proposées comme colonnes.
1345
1345
  *
package/dist/index.js CHANGED
@@ -1418,7 +1418,7 @@ function explainGrantError(error) {
1418
1418
  * quelle version. Recopiée de `package.json` par `npm version` (scripts/sync-version.mjs) ; un test
1419
1419
  * le vérifie.
1420
1420
  */
1421
- const KIT_VERSION = "2.21.0";
1421
+ const KIT_VERSION = "2.22.0";
1422
1422
  /**
1423
1423
  * Signale ce Studio au service du kit, une fois par montage.
1424
1424
  *
@@ -1745,7 +1745,7 @@ function useKitUpdate() {
1745
1745
  !controller.signal.aborted && body?.version && setLatest(body.version);
1746
1746
  }).catch(() => {}), () => controller.abort();
1747
1747
  }, []);
1748
- let available = !!(latest && !isPrerelease(latest) && compareVersions(latest, "2.21.0") > 0);
1748
+ let available = !!(latest && !isPrerelease(latest) && compareVersions(latest, "2.22.0") > 0);
1749
1749
  return {
1750
1750
  current: KIT_VERSION,
1751
1751
  latest,