ampless 1.0.0-alpha.48 → 1.0.0-alpha.49

package/dist/index.d.ts

@@ -1681,6 +1681,34 @@ interface PostRevisionConnection {
     items: PostRevision[];
     nextToken?: string;
 }
+/**
+ * Lightweight row for admin list views — excludes body / metadata.
+ * Body fields (tiptap JSON, markdown source, etc.) can be tens of KB per post;
+ * projecting them out cuts per-post transfer size by 90%+ at scale.
+ *
+ * For list views that only need title / slug / status / dates / tags,
+ * use `listPostSummaries` instead of `listPosts`.
+ *
+ * Scale note: for single-site blogs (hundreds to low thousands of posts),
+ * full client-side fetch + sort/search is fast and eliminates GSI complexity.
+ * If a site grows to many thousands of posts, revisit with a
+ * (status, updatedAt) GSI + server-side pagination.
+ */
+interface PostSummary {
+    postId: string;
+    slug: string;
+    title: string;
+    excerpt?: string;
+    status: 'draft' | 'published';
+    publishedAt?: string;
+    updatedAt?: string;
+    tags: string[];
+}
+/** Options for `listPostSummaries`. */
+interface SummaryListOptions {
+    /** default 'all' */
+    status?: 'draft' | 'published' | 'all';
+}
 interface PostsProvider {
     list(opts?: ListOptions): Promise<Post[]>;
     get(slug: string): Promise<Post | null>;
@@ -1689,6 +1717,17 @@ interface PostsProvider {
     update(postId: string, data: Partial<Post>): Promise<Post>;
     remove(postId: string): Promise<void>;
     listPostHistory(postId: string, options?: ListPostHistoryOptions): Promise<PostRevisionConnection>;
+    /**
+     * Return lightweight summaries for all posts (no body / metadata).
+     * Implementations MUST page through all nextToken values to return the
+     * complete list — the admin list view depends on this for accurate search
+     * and sort.
+     *
+     * Optional: providers that do not implement this fall back to a best-effort
+     * single-page result via `list()` (see `listPostSummaries` fallback path).
+     * The admin provider always implements this.
+     */
+    listSummaries?(opts?: SummaryListOptions): Promise<PostSummary[]>;
 }
 declare function setPostsProvider(p: PostsProvider): void;
 declare function hasPostsProvider(): boolean;
@@ -1705,6 +1744,23 @@ declare function deletePost(postId: string): Promise<void>;
  * callers (e.g. the admin history panel) degrade gracefully.
  */
 declare function listPostHistory(postId: string, options?: ListPostHistoryOptions): Promise<PostRevisionConnection>;
+/**
+ * Return lightweight summaries for all posts (no body / metadata).
+ *
+ * Delegates to `provider.listSummaries()` when available — the admin
+ * provider implements this with a full nextToken loop and selectionSet
+ * projection, ensuring all posts are returned without fetching large body
+ * fields.
+ *
+ * **Fallback**: if the configured provider does not implement `listSummaries`,
+ * falls back to a single page from `provider.list({ status })`. This is
+ * best-effort only — it returns at most one page of results (no pagination).
+ * Providers that need complete summary lists MUST implement `listSummaries`.
+ * A `console.warn` is emitted once to make this visible.
+ *
+ * If no provider is configured, maps DUMMY_POSTS to summaries.
+ */
+declare function listPostSummaries(opts?: SummaryListOptions): Promise<PostSummary[]>;
 
 interface KvItem<T = unknown> {
     pk: string;
@@ -1967,4 +2023,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 ContentFieldRenderer, 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 MarkdownEmbedMatch, 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 PublicPostScriptDescriptor, 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 TiptapNodeHtmlAdapters, type TiptapNodeMarkdownAdapters, type TiptapNodeToHtml, type TiptapNodeToMarkdown, type TiptapRenderNode, 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 };
+export { type AmplessEvent, type AmplessPlugin, type AuthContext, type BundleExtractResult, type CacheConfig, type CacheStrategy, type Config, type ContentEventPayload, type ContentEventType, type ContentFieldRenderer, 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 MarkdownEmbedMatch, 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 PostSummary, type PostsProvider, type PublicBodyDescriptor, type PublicHeadDescriptor, type PublicPostBodyDescriptor, type PublicPostHtmlDescriptor, type PublicPostHtmlPosition, type PublicPostScriptDescriptor, type Role, SITE_CONFIG_PK, type ScriptStrategy, type SiteSettingsEventPayload, type SiteSettingsEventType, type StaticPostBody, type StaticPostFileMeta, type StreamEventName, type SummaryListOptions, 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 TiptapNodeHtmlAdapters, type TiptapNodeMarkdownAdapters, type TiptapNodeToHtml, type TiptapNodeToMarkdown, type TiptapRenderNode, 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, listPostSummaries, 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

@@ -47,6 +47,7 @@ var DUMMY_POSTS = [
 
 // src/core.ts
 var provider = null;
+var warnedSummaryFallback = false;
 function setPostsProvider(p) {
   provider = p;
 }
@@ -87,6 +88,35 @@ async function listPostHistory(postId, options) {
   if (!provider) return { items: [] };
   return provider.listPostHistory(postId, options);
 }
+async function listPostSummaries(opts) {
+  const status = opts?.status ?? "all";
+  if (!provider) {
+    return dummyList({ status }).map(postToSummary);
+  }
+  if (provider.listSummaries) {
+    return provider.listSummaries(opts);
+  }
+  if (!warnedSummaryFallback) {
+    warnedSummaryFallback = true;
+    console.warn(
+      "[ampless] listPostSummaries: provider does not implement listSummaries; falling back to a single-page best-effort via list(). Complete listings require the provider to implement listSummaries."
+    );
+  }
+  const posts = await provider.list({ status });
+  return posts.map(postToSummary);
+}
+function postToSummary(p) {
+  return {
+    postId: p.postId,
+    slug: p.slug,
+    title: p.title,
+    excerpt: p.excerpt,
+    status: p.status,
+    publishedAt: p.publishedAt,
+    updatedAt: p.updatedAt,
+    tags: p.tags ?? []
+  };
+}
 
 // src/kv.ts
 var store = null;
@@ -799,6 +829,7 @@ export {
   isTagListUrl,
   isValidPluginKey,
   listPostHistory,
+  listPostSummaries,
   listPosts,
   listSiteSettings,
   mimeTypeFor,

package/package.json

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