ampless 1.0.0-alpha.37 → 1.0.0-alpha.38

package/dist/index.d.ts

@@ -1361,6 +1361,12 @@ interface Config {
      * field is absent.
      */
     cache?: CacheConfig;
+    /**
+     * Post revision-history knobs. The event-dispatcher Lambda snapshots
+     * each post save into the `PostHistory` table; this controls how long
+     * those snapshots are retained.
+     */
+    history?: HistoryConfig;
 }
 /**
  * Tunables for middleware-computed `Cache-Control`. See
@@ -1385,6 +1391,20 @@ interface CacheConfig {
      */
     deepTtlSeconds?: number;
 }
+/**
+ * Post revision-history tunables, read by the event-dispatcher Lambda
+ * (via the template shell) when snapshotting each post save.
+ */
+interface HistoryConfig {
+    /**
+     * Days to retain each post revision before DynamoDB TTL deletes it.
+     * Default 0 = keep forever (no `ttl` attribute is written). DynamoDB TTL
+     * deletes within ~48h after expiry, so effective retention is
+     * retentionDays + up to ~2 days. Changing this only affects revisions
+     * written afterward — existing rows keep their original expiry.
+     */
+    retentionDays?: number;
+}
 type Role = 'reader' | 'editor' | 'admin';
 interface AuthContext {
     userId: string;
@@ -1415,6 +1435,45 @@ interface ListOptions {
 type CreatePostInput = Omit<Post, 'postId'> & {
     postId?: string;
 };
+/**
+ * One in-memory snapshot of a Post at save time, read back from the
+ * `PostHistory` table (written by the event-dispatcher Lambda on each
+ * Post INSERT/MODIFY — see packages/backend/src/events/dispatcher.ts).
+ *
+ * `body` is already decoded from its AWSJSON wire form (the provider
+ * runs `decodeAwsJson` before handing the row up), so it matches the
+ * `Post['body']` shape for the declared `format`.
+ */
+interface PostRevision {
+    /** Deterministic id `${postId}#${revisedAt}` — unique per save. */
+    postHistoryId: string;
+    postId: string;
+    /** ISO 8601 save time. Also the `byPost` GSI sort key (newest-first). */
+    revisedAt: string;
+    title?: string;
+    slug?: string;
+    excerpt?: string;
+    format?: ContentFormat;
+    body?: unknown;
+    status?: PostStatus;
+    publishedAt?: string;
+    tags?: string[];
+    metadata?: PostMetadata;
+}
+/** Pagination options for `listPostHistory`. */
+interface ListPostHistoryOptions {
+    limit?: number;
+    nextToken?: string;
+}
+/**
+ * A page of revisions newest-first. `nextToken` feeds straight back into
+ * `ListPostHistoryOptions.nextToken` for the next page; `undefined` means
+ * no more rows.
+ */
+interface PostRevisionConnection {
+    items: PostRevision[];
+    nextToken?: string;
+}
 interface PostsProvider {
     list(opts?: ListOptions): Promise<Post[]>;
     get(slug: string): Promise<Post | null>;
@@ -1422,6 +1481,7 @@ interface PostsProvider {
     create(data: CreatePostInput): Promise<Post>;
     update(postId: string, data: Partial<Post>): Promise<Post>;
     remove(postId: string): Promise<void>;
+    listPostHistory(postId: string, options?: ListPostHistoryOptions): Promise<PostRevisionConnection>;
 }
 declare function setPostsProvider(p: PostsProvider): void;
 declare function hasPostsProvider(): boolean;
@@ -1431,6 +1491,13 @@ declare function getPostById(postId: string): Promise<Post | null>;
 declare function createPost(data: CreatePostInput): Promise<Post>;
 declare function updatePost(postId: string, data: Partial<Post>): Promise<Post>;
 declare function deletePost(postId: string): Promise<void>;
+/**
+ * List a post's revision history, newest-first. Backed by the
+ * `PostHistory` `byPost` GSI. Requires a configured provider (the dummy
+ * fallback has no history) — returns an empty connection otherwise so
+ * callers (e.g. the admin history panel) degrade gracefully.
+ */
+declare function listPostHistory(postId: string, options?: ListPostHistoryOptions): Promise<PostRevisionConnection>;
 
 interface KvItem<T = unknown> {
     pk: string;
@@ -1693,4 +1760,4 @@ declare function pickDefaultEntrypoint(files: readonly {
 
 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 MediaMetadata, type MediaProcessingDefaults, type OgImageConfig, type OgImageFont, type OgImageRenderContext, PLUGIN_KEY_PATTERN, type Page, type PluginBooleanField, type PluginCapability, type PluginCodeField, type PluginEventHandler, type PluginHookResult, type PluginJsonField, type PluginMetadata, type PluginNumberField, type PluginPackageManifest, type PluginPublicRenderContext, type PluginRepeatableField, type PluginRepeatableSubField, type PluginRuntimeContext, type PluginSecretField, type PluginSelectField, type PluginSettingField, type PluginSettingsManifest, type PluginTextField, type PluginTextareaField, type PluginUninstallContext, type PluginUrlField, type Post, type PostIndexEventPayload, type PostIndexEventType, type PostMetadata, type PostStatus, type PostsProvider, type PublicBodyDescriptor, type PublicHeadDescriptor, type PublicPostBodyDescriptor, type PublicPostHtmlDescriptor, type PublicPostHtmlPosition, type Role, SITE_CONFIG_PK, type ScriptStrategy, 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, type TrustedPluginRuntimeContext, 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, isValidPluginKey, listPosts, listSiteSettings, mimeTypeFor, parseColorPair, parseLinkList, pickDefaultEntrypoint, resolveLocalized, resolvePluginSettings, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, stringifyLinkList, stripCommonPrefix, themeSettingKey, unflattenSettings, updatePost, validateBundle, validateBundlePath, validatePluginSettingValue, validatePublicAssetKey, 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 HistoryConfig, type ImageDisplay, type KvItem, type KvStore, type LinkListItem, type ListOptions, type ListPostHistoryOptions, type LocalizedString, MAX_BUNDLE_BYTES, type Media, type MediaEventPayload, type MediaEventType, type MediaMetadata, type MediaProcessingDefaults, type OgImageConfig, type OgImageFont, type OgImageRenderContext, PLUGIN_KEY_PATTERN, type Page, type PluginBooleanField, type PluginCapability, type PluginCodeField, type PluginEventHandler, type PluginHookResult, type PluginJsonField, type PluginMetadata, type PluginNumberField, type PluginPackageManifest, type PluginPublicRenderContext, type PluginRepeatableField, type PluginRepeatableSubField, type PluginRuntimeContext, type PluginSecretField, type PluginSelectField, type PluginSettingField, type PluginSettingsManifest, type PluginTextField, type PluginTextareaField, type PluginUninstallContext, type PluginUrlField, type Post, type PostIndexEventPayload, type PostIndexEventType, type PostMetadata, type PostRevision, type PostRevisionConnection, type PostStatus, type PostsProvider, type PublicBodyDescriptor, type PublicHeadDescriptor, type PublicPostBodyDescriptor, type PublicPostHtmlDescriptor, type PublicPostHtmlPosition, type Role, SITE_CONFIG_PK, type ScriptStrategy, 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, type TrustedPluginRuntimeContext, 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, isValidPluginKey, listPostHistory, listPosts, listSiteSettings, mimeTypeFor, parseColorPair, parseLinkList, pickDefaultEntrypoint, resolveLocalized, resolvePluginSettings, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, stringifyLinkList, stripCommonPrefix, themeSettingKey, unflattenSettings, updatePost, validateBundle, validateBundlePath, validatePluginSettingValue, validatePublicAssetKey, validateThemeValue };

package/dist/index.js

@@ -83,6 +83,10 @@ async function deletePost(postId) {
   if (!provider) throw new Error("No posts provider configured. Call setPostsProvider() first.");
   return provider.remove(postId);
 }
+async function listPostHistory(postId, options) {
+  if (!provider) return { items: [] };
+  return provider.listPostHistory(postId, options);
+}
 
 // src/kv.ts
 var store = null;
@@ -794,6 +798,7 @@ export {
   hasPostsProvider,
   isTagListUrl,
   isValidPluginKey,
+  listPostHistory,
   listPosts,
   listSiteSettings,
   mimeTypeFor,

package/package.json

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