ampless 0.2.0-alpha.1 → 0.2.0-alpha.3

package/dist/index.d.ts

@@ -166,8 +166,51 @@ interface AmplessPlugin {
 }
 declare function definePlugin(p: AmplessPlugin): AmplessPlugin;
 
-type ContentFormat = 'tiptap' | 'markdown' | 'html';
+type ContentFormat = 'tiptap' | 'markdown' | 'html' | 'static';
+/**
+ * Body shape for `format: 'static'` posts. The actual asset bytes
+ * live under S3 at `public/static/<siteId>/<slug>/<files...>` — the
+ * body here is the manifest describing which entrypoint to serve and
+ * which files are part of the bundle.
+ *
+ * Stored as JSON in the `body` column (same encoding pattern as the
+ * tiptap doc / html string / markdown string for the other formats).
+ *
+ * Hard constraint enforced at upload time: every asset must reference
+ * other assets in the bundle by **relative path** only. Absolute paths
+ * (`/foo`) and protocol-relative paths (`//cdn.example/foo`) inside
+ * referenced HTML / CSS are rejected so a bundle stays portable across
+ * any URL prefix without rewriting at serve time. See the admin's
+ * StaticUploader for the validation logic.
+ */
+interface StaticPostBody {
+    /** Relative path to the entrypoint inside the bundle (default 'index.html'). */
+    entrypoint: string;
+    /** Every file in the bundle (relative paths). Used for delete cleanup and admin display. */
+    files: string[];
+    /** ISO 8601 timestamp of the most recent upload. */
+    uploadedAt: string;
+}
 type PostStatus = 'draft' | 'published';
+/**
+ * Free-form per-post metadata. The `metadata` JSON column carries
+ * arbitrary key/value pairs; the runtime / themes / plugins each pick
+ * the keys they care about. A handful of well-known keys are owned by
+ * ampless itself and documented here.
+ *
+ * Well-known keys:
+ *   - `no_layout`: when true, the public page is served as bare HTML
+ *     (no theme chrome). The runtime's post dispatcher checks this
+ *     before rendering and redirects to the raw route handler.
+ *
+ * Additional keys are passed through unchanged — themes and plugins
+ * are free to store their own per-post state here (e.g. SEO overrides,
+ * feature flags, A/B variants).
+ */
+interface PostMetadata {
+    no_layout?: boolean;
+    [key: string]: unknown;
+}
 interface Post {
     postId: string;
     siteId: string;
@@ -179,6 +222,7 @@ interface Post {
     status: PostStatus;
     publishedAt?: string;
     tags?: string[];
+    metadata?: PostMetadata;
 }
 interface Page {
     pageId: string;
@@ -351,11 +395,12 @@ declare const DEFAULT_SITE_ID = "default";
 /**
  * Resolve a hostname to a configured siteId.
  *
- * - Single-site mode (no `sites` defined or empty): always returns
- *   `DEFAULT_SITE_ID` regardless of host. The single site catches
- *   every request.
- * - Multi-site mode: looks up the host in each site's `domains` list.
- *   Returns `null` if the host is not registered (caller should 404).
+ * - Single-site mode (no `sites` defined / empty / exactly one entry):
+ *   returns that site's id regardless of host. The single site catches
+ *   every request. Matches `isMultiSite` (≥2 entries = multi).
+ * - Multi-site mode (2+ entries): looks up the host in each site's
+ *   `domains` list. Returns `null` if the host is not registered
+ *   (caller should 404).
  *
  * The host comparison is case-insensitive; ports are not stripped here
  * — pass the bare hostname (e.g. `'site-a.example.com'`).
@@ -645,4 +690,4 @@ declare function resolveThemeValues(manifest: ThemeManifest, stored: Record<stri
 
 declare const VERSION = "0.0.1";
 
-export { type AmplessEvent, type AmplessPlugin, type AuthContext, type Config, type ContentEventPayload, type ContentEventType, type ContentFormat, type ContentTypeDefinition, type CreatePostInput, DEFAULT_SITE_ID, type DateFormat, type EventPayloadOf, type EventType, type FieldDefinition, type FieldType, type ImageDisplay, type KvItem, type KvStore, type LinkListItem, type ListOptions, type LocalizedString, 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 PostStatus, type PostsProvider, type Role, SITE_CONFIG_PK, type SiteConfig, type SiteSettingsEventPayload, type SiteSettingsEventType, type StreamEventName, 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, composeSiteIdSlug, composeSiteIdStatus, createPost, defineConfig, definePlugin, defineSchema, defineTheme, defineThemeModule, deletePost, deleteSiteSetting, detectContentEvents, escapeXml, extractFirstImageUrl, flattenSettings, formatDate, formatPublicAssetUrl, getPost, getPostById, getSiteSetting, hasKvStore, hasPostsProvider, isMultiSite, isTagListUrl, listPosts, listSiteSettings, parseLinkList, resolveLocalized, resolveSiteId, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, siteFor, stringifyLinkList, themeSettingKey, unflattenSettings, updatePost, validateThemeValue };
+export { type AmplessEvent, type AmplessPlugin, type AuthContext, type Config, type ContentEventPayload, type ContentEventType, type ContentFormat, type ContentTypeDefinition, type CreatePostInput, DEFAULT_SITE_ID, type DateFormat, type EventPayloadOf, type EventType, type FieldDefinition, type FieldType, type ImageDisplay, type KvItem, type KvStore, type LinkListItem, type ListOptions, type LocalizedString, 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 SiteConfig, type SiteSettingsEventPayload, type SiteSettingsEventType, type StaticPostBody, type StreamEventName, 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, composeSiteIdSlug, composeSiteIdStatus, createPost, defineConfig, definePlugin, defineSchema, defineTheme, defineThemeModule, deletePost, deleteSiteSetting, detectContentEvents, escapeXml, extractFirstImageUrl, flattenSettings, formatDate, formatPublicAssetUrl, getPost, getPostById, getSiteSetting, hasKvStore, hasPostsProvider, isMultiSite, isTagListUrl, listPosts, listSiteSettings, parseLinkList, resolveLocalized, resolveSiteId, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, siteFor, stringifyLinkList, themeSettingKey, unflattenSettings, updatePost, validateThemeValue };

package/dist/index.js

@@ -96,6 +96,8 @@ function resolveSiteId(host, config) {
   if (!sites || Object.keys(sites).length === 0) {
     return DEFAULT_SITE_ID;
   }
+  const ids = Object.keys(sites);
+  if (ids.length === 1) return ids[0];
   const lower = host.toLowerCase();
   for (const [id, site] of Object.entries(sites)) {
     if (site.domains.some((d) => d.toLowerCase() === lower)) return id;

package/package.json

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