ampless 1.0.0-alpha.14 → 1.0.0-alpha.16

package/dist/index.d.ts

@@ -1,7 +1,20 @@
 type ContentEventType = 'content.created' | 'content.updated' | 'content.published' | 'content.unpublished' | 'content.deleted';
 type MediaEventType = 'media.uploaded' | 'media.deleted';
 type SiteSettingsEventType = 'site.settings.updated';
-type EventType = ContentEventType | MediaEventType | SiteSettingsEventType;
+/**
+ * Emitted on every Post mutation (INSERT / MODIFY / REMOVE) with both
+ * the previous and the next projection of the row. Drives index-style
+ * derivation: the built-in trusted-processor handler uses it to keep
+ * the `PostTag` denormalized index in sync without making every write
+ * path (admin, MCP, future REST clients) remember to call a helper.
+ *
+ * Plugins that maintain their own indexes (custom search, sitemaps
+ * with per-tag pages, etc.) can subscribe through the same hook
+ * surface as the other event types — the diff payload is already in
+ * the right shape for "compute add/remove/update".
+ */
+type PostIndexEventType = 'post.index.refresh';
+type EventType = ContentEventType | MediaEventType | SiteSettingsEventType | PostIndexEventType;
 /** Minimal projection of a Post item carried in events (no body, to keep payloads small). */
 interface ContentEventPayload {
     postId: string;
@@ -23,7 +36,17 @@ interface MediaEventPayload {
  */
 interface SiteSettingsEventPayload {
 }
-type EventPayloadOf<T extends EventType> = T extends ContentEventType ? ContentEventPayload : T extends MediaEventType ? MediaEventPayload : T extends SiteSettingsEventType ? SiteSettingsEventPayload : never;
+/**
+ * Diff payload for `post.index.refresh`. `previous` is null on INSERT;
+ * `next` is null on REMOVE; both populated on MODIFY. Subscribers
+ * compute the add / remove / update set from this — see the trusted
+ * processor's `rebuildPostTags` handler for the canonical example.
+ */
+interface PostIndexEventPayload {
+    previous: ContentEventPayload | null;
+    next: ContentEventPayload | null;
+}
+type EventPayloadOf<T extends EventType> = T extends ContentEventType ? ContentEventPayload : T extends MediaEventType ? MediaEventPayload : T extends SiteSettingsEventType ? SiteSettingsEventPayload : T extends PostIndexEventType ? PostIndexEventPayload : never;
 interface AmplessEvent<T extends EventType = EventType> {
     type: T;
     payload: EventPayloadOf<T>;
@@ -223,9 +246,33 @@ type CacheStrategy = 'auto' | 'deep' | 'hot';
  * are free to store their own per-post state here (e.g. SEO overrides,
  * feature flags, A/B variants).
  */
+/**
+ * Per-file metadata recorded on a static post. The static route
+ * reads this to decide whether to stream the bytes back through
+ * Lambda (small files → cached by CloudFront) or to 302-redirect
+ * to a presigned URL (large files → bypass the Lambda response
+ * size envelope). Populated by `upload_static_bundle` /
+ * `commit_static_post` at upload time so the read path never
+ * issues a HEAD round-trip.
+ *
+ * `body.files` (the manifest's flat list) stays the source of truth
+ * for "what's in the bundle"; this map is purely a delivery hint and
+ * may be sparse when older bundles predate the migration.
+ */
+interface StaticPostFileMeta {
+    size: number;
+    mimeType: string;
+}
 interface PostMetadata {
     no_layout?: boolean;
     cache?: CacheStrategy;
+    /**
+     * For `format: 'static'` posts only. Keyed by the bundle-relative
+     * path (same shape as `body.files` entries). Older bundles may
+     * lack this map — readers MUST treat a missing entry as
+     * "fall back to a HEAD lookup".
+     */
+    files?: Record<string, StaticPostFileMeta>;
     [key: string]: unknown;
 }
 interface Post {
@@ -258,12 +305,25 @@ interface Page {
     status: PostStatus;
     publishedAt?: string;
 }
+/**
+ * Asset metadata recorded on the Media row. Currently the only
+ * well-known key is `etag` (the S3 object ETag, captured at upload
+ * time so the media-proxy route can emit it back to the client
+ * without a HEAD round-trip). Free-form by design — themes and
+ * plugins can add their own keys (image dimensions, EXIF strip
+ * status, etc.) without a schema change.
+ */
+interface MediaMetadata {
+    etag?: string;
+    [key: string]: unknown;
+}
 interface Media {
     mediaId: string;
     src: string;
     mimeType: string;
     size: number;
     delivery: 'nextjs' | 's3-direct';
+    metadata?: MediaMetadata;
 }
 type ImageDisplay = 'inline' | 'lightbox';
 /**
@@ -477,9 +537,8 @@ declare function escapeXml(s: string): string;
  *     from DynamoDB (the path used by the trusted processor and the
  *     MCP Lambda).
  *
- * `decodeAwsJson` tolerates both: pass strings through `JSON.parse`,
- * everything else as-is, fall back to the raw string on parse errors
- * so bare-string rows aren't lost.
+ * `decodeAwsJson` handles both: pass strings through `JSON.parse`,
+ * everything else as-is.
  */
 /**
  * Serialise a value for an AWSJSON variable. `undefined` / `null` both
@@ -490,7 +549,7 @@ declare function encodeAwsJson(value: unknown): string;
 /**
  * Deserialise an AWSJSON value from a GraphQL / DynamoDB read.
  * Tolerates both the wire-string shape and the auto-unmarshalled
- * native value. Returns the raw string when `JSON.parse` rejects it.
+ * native value. Throws if the string is not valid JSON.
  */
 declare function decodeAwsJson(value: unknown): unknown;
 
@@ -814,4 +873,4 @@ declare function resolveThemeValues(manifest: ThemeManifest, stored: Record<stri
 
 declare const VERSION = "0.0.1";
 
-export { type AmplessEvent, type AmplessPlugin, type AuthContext, type BundleExtractResult, type CacheConfig, type CacheStrategy, type Config, type ContentEventPayload, type ContentEventType, type ContentFormat, type ContentTypeDefinition, type CreatePostInput, DEFAULT_ENTRYPOINT, type DateFormat, type EventPayloadOf, type EventType, type ExtractedFile, type FieldDefinition, type FieldType, type ImageDisplay, type KvItem, type KvStore, type LinkListItem, type ListOptions, type LocalizedString, MAX_BUNDLE_BYTES, type Media, type MediaEventPayload, type MediaEventType, type MediaProcessingDefaults, type OgImageConfig, type OgImageFont, type OgImageRenderContext, type Page, type PluginEventHandler, type PluginMetadata, type PluginRuntimeContext, type Post, type PostMetadata, type PostStatus, type PostsProvider, type Role, SITE_CONFIG_PK, type SiteSettingsEventPayload, type SiteSettingsEventType, type StaticPostBody, type StreamEventName, TEXT_EXTENSIONS, type ThemeColorField, type ThemeField, type ThemeFieldType, type ThemeFontFamilyField, type ThemeImageField, type ThemeLengthField, type ThemeLinkListField, type ThemeManifest, type ThemeModule, type ThemeRouteContext, type ThemeSelectField, type ThemeTextField, type TrustLevel, VERSION, type ValidationIssue, bundlePrefix, createPost, decodeAwsJson, defineConfig, definePlugin, defineSchema, defineTheme, defineThemeModule, deletePost, deleteSiteSetting, detectContentEvents, encodeAwsJson, escapeXml, extractFirstImageUrl, findAbsolutePathRefs, flattenSettings, formatColorPair, formatDate, formatPublicAssetUrl, getKvStore, getPost, getPostById, getSiteSetting, hasKvStore, hasPostsProvider, isTagListUrl, listPosts, listSiteSettings, mimeTypeFor, parseColorPair, parseLinkList, pickDefaultEntrypoint, resolveLocalized, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, stringifyLinkList, stripCommonPrefix, themeSettingKey, unflattenSettings, updatePost, validateBundle, validateBundlePath, validateThemeValue };
+export { type AmplessEvent, type AmplessPlugin, type AuthContext, type BundleExtractResult, type CacheConfig, type CacheStrategy, type Config, type ContentEventPayload, type ContentEventType, type ContentFormat, type ContentTypeDefinition, type CreatePostInput, DEFAULT_ENTRYPOINT, type DateFormat, type EventPayloadOf, type EventType, type ExtractedFile, type FieldDefinition, type FieldType, type ImageDisplay, type KvItem, type KvStore, type LinkListItem, type ListOptions, type LocalizedString, MAX_BUNDLE_BYTES, type Media, type MediaEventPayload, type MediaEventType, type MediaMetadata, type MediaProcessingDefaults, type OgImageConfig, type OgImageFont, type OgImageRenderContext, type Page, type PluginEventHandler, type PluginMetadata, type PluginRuntimeContext, type Post, type PostIndexEventPayload, type PostIndexEventType, type PostMetadata, type PostStatus, type PostsProvider, type Role, SITE_CONFIG_PK, type SiteSettingsEventPayload, type SiteSettingsEventType, type StaticPostBody, type StaticPostFileMeta, type StreamEventName, TEXT_EXTENSIONS, type ThemeColorField, type ThemeField, type ThemeFieldType, type ThemeFontFamilyField, type ThemeImageField, type ThemeLengthField, type ThemeLinkListField, type ThemeManifest, type ThemeModule, type ThemeRouteContext, type ThemeSelectField, type ThemeTextField, type TrustLevel, VERSION, type ValidationIssue, bundlePrefix, createPost, decodeAwsJson, defineConfig, definePlugin, defineSchema, defineTheme, defineThemeModule, deletePost, deleteSiteSetting, detectContentEvents, encodeAwsJson, escapeXml, extractFirstImageUrl, findAbsolutePathRefs, flattenSettings, formatColorPair, formatDate, formatPublicAssetUrl, getKvStore, getPost, getPostById, getSiteSetting, hasKvStore, hasPostsProvider, isTagListUrl, listPosts, listSiteSettings, mimeTypeFor, parseColorPair, parseLinkList, pickDefaultEntrypoint, resolveLocalized, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, stringifyLinkList, stripCommonPrefix, themeSettingKey, unflattenSettings, updatePost, validateBundle, validateBundlePath, validateThemeValue };

package/dist/index.js

@@ -202,11 +202,7 @@ function encodeAwsJson(value) {
 }
 function decodeAwsJson(value) {
   if (typeof value !== "string") return value;
-  try {
-    return JSON.parse(value);
-  } catch {
-    return value;
-  }
+  return JSON.parse(value);
 }
 
 // src/storage.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ampless",
-  "version": "1.0.0-alpha.14",
+  "version": "1.0.0-alpha.16",
   "description": "Serverless CMS for AWS Amplify",
   "license": "MIT",
   "type": "module",