ampless 0.2.0-alpha.6 → 0.2.0-alpha.7

package/dist/index.d.ts

@@ -484,6 +484,51 @@ declare function formatDate(input: Date | string | number, format?: DateFormat,
 
 declare function escapeXml(s: string): string;
 
+/**
+ * Encode / decode helpers for AppSync's AWSJSON scalar.
+ *
+ * Every `a.json()` field in the schema (Post.body, Post.metadata,
+ * Page.body, KvStore.value, ...) carries a *JSON-encoded string* on
+ * the GraphQL wire — regardless of whether the underlying value is a
+ * string, object, or array. That rule holds for both write paths:
+ *
+ *   1. Amplify-generated client (`generateClient<Schema>().models.X.
+ *      create({ body: ... })`) — Amplify does NOT auto-stringify, the
+ *      caller must JSON.stringify before passing the value in.
+ *   2. Raw GraphQL fetch (variables map, e.g. the MCP Lambda) — same
+ *      rule, the variable must be a JSON-encoded string.
+ *
+ * Skipping the stringify for raw string inputs (a common mistake when
+ * `format: 'markdown'`) trips AppSync's variable validator with
+ *
+ *     Variable 'body' has an invalid value.
+ *
+ * On the read side two wire shapes coexist:
+ *
+ *   - JSON-encoded string — what the auto-generated CRUD resolver and
+ *     custom resolvers usually return.
+ *   - Native object / Map — DynamoDBDocumentClient unmarshals
+ *     AWSJSON-stored maps straight into JS objects when read directly
+ *     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 legacy bare-string rows aren't lost.
+ */
+/**
+ * Serialise a value for an AWSJSON variable. `undefined` / `null` both
+ * collapse to the literal string `"null"` (valid JSON) so AppSync sees
+ * a well-formed AWSJSON payload either way.
+ */
+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.
+ */
+declare function decodeAwsJson(value: unknown): unknown;
+
 /**
  * Build the public S3 URL for an object key, in the regional virtual-host
  * style: `https://{bucket}.s3.{region}.amazonaws.com/{key}`. The legacy
@@ -719,4 +764,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 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, formatColorPair, formatDate, formatPublicAssetUrl, getKvStore, getPost, getPostById, getSiteSetting, hasKvStore, hasPostsProvider, isMultiSite, isTagListUrl, listPosts, listSiteSettings, parseColorPair, 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, decodeAwsJson, defineConfig, definePlugin, defineSchema, defineTheme, defineThemeModule, deletePost, deleteSiteSetting, detectContentEvents, encodeAwsJson, escapeXml, extractFirstImageUrl, flattenSettings, formatColorPair, formatDate, formatPublicAssetUrl, getKvStore, getPost, getPostById, getSiteSetting, hasKvStore, hasPostsProvider, isMultiSite, isTagListUrl, listPosts, listSiteSettings, parseColorPair, parseLinkList, resolveLocalized, resolveSiteId, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, siteFor, stringifyLinkList, themeSettingKey, unflattenSettings, updatePost, validateThemeValue };

package/dist/index.js

@@ -234,6 +234,19 @@ function escapeXml(s) {
   return s.replace(/[&<>"']/g, (c) => XML_ESCAPES[c]);
 }
 
+// src/awsjson.ts
+function encodeAwsJson(value) {
+  return JSON.stringify(value ?? null);
+}
+function decodeAwsJson(value) {
+  if (typeof value !== "string") return value;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+}
+
 // src/storage.ts
 function formatPublicAssetUrl(bucket, region, key) {
   return `https://${bucket}.s3.${region}.amazonaws.com/${key}`;
@@ -464,6 +477,7 @@ export {
   composeSiteIdSlug,
   composeSiteIdStatus,
   createPost,
+  decodeAwsJson,
   defineConfig,
   definePlugin,
   defineSchema,
@@ -472,6 +486,7 @@ export {
   deletePost,
   deleteSiteSetting,
   detectContentEvents,
+  encodeAwsJson,
   escapeXml,
   extractFirstImageUrl,
   flattenSettings,

package/package.json

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