@gaulatti/giorgia 0.1.98 → 0.1.99

package/README.md

@@ -5,8 +5,11 @@ Server-side renderer and Handlebars template bundle for ModoItaliano pages.
 ## What it does
 
 - Renders canonical content documents into HTML
-- Supports `article-page`, `homepage`, `category-page`, `live-story`, and `404` layouts
+- Supports the layouts declared by the packaged Cronkite manifest, including
+  article, homepage, category, search, 404, coming-soon, live-story,
+  link-in-bio, media, and standalone pages
 - Ships reusable Handlebars templates, partial dependency metadata, and compiled CSS
+- Ships provider-neutral social-image and Remotion short-video renderables
 - Preserves the masthead, footer, and radio player across same-language internal navigation
 
 ## Installation
@@ -18,18 +21,31 @@ npm install @gaulatti/giorgia
 ## Basic usage
 
 ```ts
-import { render } from '@gaulatti/giorgia';
+import { render } from "@gaulatti/giorgia";
 
 const html = render(doc);
 ```
 
-`doc` must match the canonical schema used by the renderer (see [src/types/canonical-article.ts](src/types/canonical-article.ts)).
+`doc` must match the normative canonical schema in
+[src/schemas/canonical-document.schema.json](src/schemas/canonical-document.schema.json).
+TypeScript declarations are generated from that schema; runtime rendering validates
+against the same artifact.
 
 ## Exports
 
 - `@gaulatti/giorgia` -> renderer entrypoint
+- `@gaulatti/giorgia/cronkite-manifest.json` -> data-only CLS capability manifest
+- `@gaulatti/giorgia/video` -> bundleable Remotion short-video entrypoint
+- `@gaulatti/giorgia/schemas/canonical-document.schema.json` -> canonical input contract
+- `@gaulatti/giorgia/schemas/search-manifest.schema.json` and
+  `@gaulatti/giorgia/schemas/search-index.schema.json` -> static-search resource contract
 - `@gaulatti/giorgia/partial-deps.json` -> partial-to-layout dependency map
 
+The root module also exports `cronkiteManifest`, `outletConfig`, `version`,
+`render`, `fontFiles`, `assetFiles`, and `buildInstagramImageHtml`. See
+[docs/cronkite-compatibility.md](docs/cronkite-compatibility.md) for ownership,
+validation, search, and asset-rendering details.
+
 ## Development
 
 ```bash
@@ -37,6 +53,7 @@ npm install
 npm run typecheck
 npm run test:unit
 npm run build
+npm run verify:packed-remotion
 npm run storybook
 ```
 
@@ -50,3 +67,48 @@ Page-local scripts that must run after a content swap use `data-swup-reload-scri
 
 - CI validates typecheck, unit tests, and package build on pull requests and `main` pushes.
 - Package publish is triggered by pushing a `v*` tag.
+- Storybook pull requests build an immutable artifact but receive no AWS token.
+  A push or manual run on `main` deploys that exact artifact to
+  `https://ui.modoitaliano.fm` through the `giorgia-storybook` GitHub
+  environment and short-lived AWS OIDC role
+  `giorgia-storybook-github-deploy`. Storybook deployment never runs
+  `npm publish` or changes the package version.
+
+### Storybook infrastructure and rollback
+
+The Modo Italiano `Loredana` CloudFormation stack owns the dedicated Storybook
+bucket and CloudFront distribution. The workflow resolves outputs
+`LoredanaGiorgiaStorybookBucketName` and
+`LoredanaGiorgiaStorybookDistributionId`; it must never target the Fifthbell
+`ui.fifthbell.com` resources used by Brokaw.
+
+Each build carries `deployment.json` with its repository, package version, run,
+and full Git SHA. Deployment uploads to `/releases/<sha>` and changes the
+CloudFront origin path only after the complete immutable prefix is present.
+The previous origin path is retained and restored automatically if the public
+identity check fails after promotion. A failed build or upload therefore
+cannot partially overwrite the last known-good documentation.
+
+The deployment log records the previous origin path. For an
+operator-authorized manual rollback, fetch the current distribution config and
+ETag, restore only the dedicated S3 origin's `OriginPath` to that recorded
+`/releases/<sha>` value, submit the update with the ETag, wait for CloudFront to
+deploy, and invalidate `/*`. Confirm the public `deployment.json` reports the
+expected prior SHA. Do not delete release prefixes until a separately reviewed
+retention policy exists.
+
+The deployment role must trust only audience `sts.amazonaws.com` and the
+repository's current immutable GitHub OIDC subject:
+
+```text
+repo:modoitaliano@327696306/giorgia@1304750193:environment:giorgia-storybook
+```
+
+Its permissions are limited to `cloudformation:DescribeStacks` for Loredana;
+`s3:ListBucket` and `s3:GetBucketLocation` on the dedicated bucket;
+`s3:GetObject` and `s3:PutObject` on that bucket's `releases/*`; and
+`cloudfront:GetDistribution`,
+`cloudfront:GetDistributionConfig`, `cloudfront:UpdateDistribution`,
+`cloudfront:CreateInvalidation`, and `cloudfront:GetInvalidation` on the one
+Storybook distribution. It has no delete permission. No long-lived AWS key
+belongs in GitHub secrets.

package/dist/cronkite-manifest.d.ts

@@ -0,0 +1,51 @@
+export declare const cronkiteManifest: {
+    readonly contract: "cronkite.cls";
+    readonly contractVersion: 1;
+    readonly package: "@gaulatti/giorgia";
+    readonly version: string;
+    readonly layouts: ["article-page" | "homepage" | "category-page" | "search-page" | "404" | "coming-soon" | "live-story" | "link-in-bio" | "media-page" | "standalone-page", ...("article-page" | "homepage" | "category-page" | "search-page" | "404" | "coming-soon" | "live-story" | "link-in-bio" | "media-page" | "standalone-page")[]];
+    readonly languages: ["es", "en", "it"];
+    readonly collections: {
+        readonly "article-page": "json/articles";
+        readonly "standalone-page": "json/pages";
+    };
+    readonly systemPages: import("./types/cronkite-manifest.generated.js").SystemPage[];
+    readonly renderables: {
+        readonly "search-page": {
+            readonly engine: "handlebars";
+            readonly export: "render";
+            readonly outputMode: "single";
+            readonly lifecycle: "request";
+            readonly contentType: "text/html; charset=utf-8";
+            readonly resources: {
+                readonly "search-manifest": {
+                    readonly key: "search-manifest-{language}.json";
+                    readonly schema: "dist/schemas/search-manifest.schema.json";
+                    readonly contentType: "application/json";
+                    readonly perLanguage: true;
+                };
+            };
+        };
+        readonly "social-image": {
+            readonly engine: "html-raster";
+            readonly export: "buildInstagramImageHtml";
+            readonly contentType: "image/jpeg";
+            readonly width: 1080;
+            readonly height: 1350;
+        };
+        readonly "short-video": {
+            readonly engine: "remotion";
+            readonly entry: "dist/video/index.js";
+            readonly compositionId: "ModoItalianoShort";
+            readonly contentType: "video/mp4";
+        };
+    };
+    readonly capabilities: {
+        readonly fonts: {
+            readonly export: "fontFiles";
+        };
+        readonly assets: {
+            readonly export: "assetFiles";
+        };
+    };
+};

package/dist/cronkite-manifest.js

@@ -0,0 +1,115 @@
+import { layoutNames } from "./layouts.js";
+import { outletConfig } from "./outlet-config.js";
+import { version } from "./version.js";
+const systemPages = [
+    {
+        layout: "404",
+        route: "/{language}/404",
+        key: "html/{language}/404/index.html",
+        cacheControl: "public, max-age=0, must-revalidate",
+        perLanguage: true,
+        copy: {
+            es: {
+                title: "Página no encontrada",
+                description: "La página que buscas no existe.",
+            },
+            en: {
+                title: "Page Not Found",
+                description: "The page you are looking for does not exist.",
+            },
+            it: {
+                title: "Pagina non trovata",
+                description: "La pagina che stai cercando non esiste.",
+            },
+        },
+    },
+    {
+        layout: "search-page",
+        route: "/{language}/search",
+        key: "html/{language}/search/index.html",
+        cacheControl: "public, max-age=0, must-revalidate",
+        perLanguage: true,
+        copy: {
+            es: {
+                title: "Buscar",
+                description: outletConfig.searchDescriptions.es,
+            },
+            en: {
+                title: "Search",
+                description: outletConfig.searchDescriptions.en,
+            },
+            it: {
+                title: "Cerca",
+                description: outletConfig.searchDescriptions.it,
+            },
+        },
+    },
+    {
+        layout: "coming-soon",
+        route: "/{language}/coming-soon",
+        key: "html/{language}/coming-soon/index.html",
+        cacheControl: "public, max-age=0, must-revalidate",
+        perLanguage: true,
+        copy: {
+            es: {
+                title: "Próximamente",
+                description: "Estamos preparando algo especial. Vuelve pronto para descubrirlo.",
+            },
+            en: {
+                title: "Coming soon",
+                description: "We are preparing something special. Come back soon.",
+            },
+            it: {
+                title: "Prossimamente",
+                description: "Stiamo preparando qualcosa di speciale. Torna presto.",
+            },
+        },
+    },
+];
+export const cronkiteManifest = {
+    contract: "cronkite.cls",
+    contractVersion: 1,
+    package: "@gaulatti/giorgia",
+    version,
+    layouts: [...layoutNames],
+    languages: [...outletConfig.supportedLanguages],
+    collections: {
+        "article-page": "json/articles",
+        "standalone-page": "json/pages",
+    },
+    systemPages,
+    renderables: {
+        "search-page": {
+            engine: "handlebars",
+            export: "render",
+            outputMode: "single",
+            lifecycle: "request",
+            contentType: "text/html; charset=utf-8",
+            resources: {
+                "search-manifest": {
+                    key: "search-manifest-{language}.json",
+                    schema: "dist/schemas/search-manifest.schema.json",
+                    contentType: "application/json",
+                    perLanguage: true,
+                },
+            },
+        },
+        "social-image": {
+            engine: "html-raster",
+            export: "buildInstagramImageHtml",
+            contentType: "image/jpeg",
+            width: 1080,
+            height: 1350,
+        },
+        "short-video": {
+            engine: "remotion",
+            entry: "dist/video/index.js",
+            compositionId: "ModoItalianoShort",
+            contentType: "video/mp4",
+        },
+    },
+    capabilities: {
+        fonts: { export: "fontFiles" },
+        assets: { export: "assetFiles" },
+    },
+};

package/dist/cronkite-manifest.json

@@ -0,0 +1,130 @@
+{
+  "contract": "cronkite.cls",
+  "contractVersion": 1,
+  "package": "@gaulatti/giorgia",
+  "version": "0.1.99",
+  "layouts": [
+    "404",
+    "article-page",
+    "homepage",
+    "category-page",
+    "search-page",
+    "coming-soon",
+    "live-story",
+    "link-in-bio",
+    "media-page",
+    "standalone-page"
+  ],
+  "languages": [
+    "es",
+    "en",
+    "it"
+  ],
+  "collections": {
+    "article-page": "json/articles",
+    "standalone-page": "json/pages"
+  },
+  "systemPages": [
+    {
+      "layout": "404",
+      "route": "/{language}/404",
+      "key": "html/{language}/404/index.html",
+      "cacheControl": "public, max-age=0, must-revalidate",
+      "perLanguage": true,
+      "copy": {
+        "es": {
+          "title": "Página no encontrada",
+          "description": "La página que buscas no existe."
+        },
+        "en": {
+          "title": "Page Not Found",
+          "description": "The page you are looking for does not exist."
+        },
+        "it": {
+          "title": "Pagina non trovata",
+          "description": "La pagina che stai cercando non esiste."
+        }
+      }
+    },
+    {
+      "layout": "search-page",
+      "route": "/{language}/search",
+      "key": "html/{language}/search/index.html",
+      "cacheControl": "public, max-age=0, must-revalidate",
+      "perLanguage": true,
+      "copy": {
+        "es": {
+          "title": "Buscar",
+          "description": "Busca noticias de ModoItaliano."
+        },
+        "en": {
+          "title": "Search",
+          "description": "Search ModoItaliano news."
+        },
+        "it": {
+          "title": "Cerca",
+          "description": "Cerca le notizie di ModoItaliano."
+        }
+      }
+    },
+    {
+      "layout": "coming-soon",
+      "route": "/{language}/coming-soon",
+      "key": "html/{language}/coming-soon/index.html",
+      "cacheControl": "public, max-age=0, must-revalidate",
+      "perLanguage": true,
+      "copy": {
+        "es": {
+          "title": "Próximamente",
+          "description": "Estamos preparando algo especial. Vuelve pronto para descubrirlo."
+        },
+        "en": {
+          "title": "Coming soon",
+          "description": "We are preparing something special. Come back soon."
+        },
+        "it": {
+          "title": "Prossimamente",
+          "description": "Stiamo preparando qualcosa di speciale. Torna presto."
+        }
+      }
+    }
+  ],
+  "renderables": {
+    "search-page": {
+      "engine": "handlebars",
+      "export": "render",
+      "outputMode": "single",
+      "lifecycle": "request",
+      "contentType": "text/html; charset=utf-8",
+      "resources": {
+        "search-manifest": {
+          "key": "search-manifest-{language}.json",
+          "schema": "dist/schemas/search-manifest.schema.json",
+          "contentType": "application/json",
+          "perLanguage": true
+        }
+      }
+    },
+    "social-image": {
+      "engine": "html-raster",
+      "export": "buildInstagramImageHtml",
+      "contentType": "image/jpeg",
+      "width": 1080,
+      "height": 1350
+    },
+    "short-video": {
+      "engine": "remotion",
+      "entry": "dist/video/index.js",
+      "compositionId": "ModoItalianoShort",
+      "contentType": "video/mp4"
+    }
+  },
+  "capabilities": {
+    "fonts": {
+      "export": "fontFiles"
+    },
+    "assets": {
+      "export": "assetFiles"
+    }
+  }
+}

package/dist/json-schema-formats.d.ts

@@ -0,0 +1,2 @@
+import type { Ajv2020 } from "ajv/dist/2020.js";
+export declare function addContractFormats(ajv: Ajv2020): void;

package/dist/json-schema-formats.js

@@ -0,0 +1,24 @@
+const rfc3339 = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;
+const uuid = /^(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/i;
+export function addContractFormats(ajv) {
+    ajv.addFormat("date-time", {
+        type: "string",
+        validate: (value) => rfc3339.test(value) && !Number.isNaN(Date.parse(value)),
+    });
+    ajv.addFormat("uri", {
+        type: "string",
+        validate: (value) => {
+            try {
+                const parsed = new URL(value);
+                return Boolean(parsed.protocol);
+            }
+            catch {
+                return false;
+            }
+        },
+    });
+    ajv.addFormat("uuid", {
+        type: "string",
+        validate: (value) => uuid.test(value),
+    });
+}

package/dist/layouts.d.ts

@@ -0,0 +1,14 @@
+export declare const layoutFiles: {
+    readonly "article-page": "article-page.hbs";
+    readonly homepage: "homepage.hbs";
+    readonly "category-page": "category-page.hbs";
+    readonly "search-page": "search-page.hbs";
+    readonly "404": "404.hbs";
+    readonly "coming-soon": "coming-soon.hbs";
+    readonly "live-story": "live-story.hbs";
+    readonly "link-in-bio": "link-in-bio.hbs";
+    readonly "media-page": "media-page.hbs";
+    readonly "standalone-page": "standalone-page.hbs";
+};
+export type LayoutName = keyof typeof layoutFiles;
+export declare const layoutNames: readonly ["article-page" | "homepage" | "category-page" | "search-page" | "404" | "coming-soon" | "live-story" | "link-in-bio" | "media-page" | "standalone-page", ...("article-page" | "homepage" | "category-page" | "search-page" | "404" | "coming-soon" | "live-story" | "link-in-bio" | "media-page" | "standalone-page")[]];

package/dist/layouts.js

@@ -0,0 +1,13 @@
+export const layoutFiles = {
+    "article-page": "article-page.hbs",
+    homepage: "homepage.hbs",
+    "category-page": "category-page.hbs",
+    "search-page": "search-page.hbs",
+    "404": "404.hbs",
+    "coming-soon": "coming-soon.hbs",
+    "live-story": "live-story.hbs",
+    "link-in-bio": "link-in-bio.hbs",
+    "media-page": "media-page.hbs",
+    "standalone-page": "standalone-page.hbs",
+};
+export const layoutNames = Object.freeze(Object.keys(layoutFiles));