ampless 1.0.0-alpha.15 → 1.0.0-alpha.16

package/dist/index.d.ts

@@ -246,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 {
@@ -281,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';
 /**
@@ -500,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
@@ -513,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;
 
@@ -837,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 PostIndexEventPayload, type PostIndexEventType, 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.15",
+  "version": "1.0.0-alpha.16",
   "description": "Serverless CMS for AWS Amplify",
   "license": "MIT",
   "type": "module",