ampless 0.2.0-alpha.5 → 0.2.0-alpha.7

package/README.ja.md

@@ -0,0 +1,49 @@
+> English: [README.md](./README.md)
+> 
+
+# ampless
+
+AWS Amplify 向け CMS コアライブラリ。
+
+> **プレリリース / アルファ版。** v1.0 まではマイナーバージョンでも破壊的変更が入る可能性があります。全文ドキュメントは [ルート README](https://github.com/heavymoons/ampless#readme) を参照してください。
+
+## 概要
+
+`ampless` は [ampless](https://github.com/heavymoons/ampless) CMS を支えるコアライブラリです。以下を公開しています：
+
+- `defineConfig()` — ユーザー向け `cms.config.ts` スキーマ
+- `defineSchema()` — コンテンツタイプ定義（カスタムコンテンツタイプシステムは v0.2 で完成予定）
+- `Post` / `Page` / `Media` / `AuthContext` 共有型
+- プラグインコントラクト（`definePlugin`、`AmplessPlugin`、フック、`PluginRuntimeContext`、イベント型、`escapeXml` / `formatPublicAssetUrl`）
+- DI スタイルの `setPostsProvider()` — テンプレートの Amplify データラッパーが注入します。未設定の場合は API がダミーの投稿を返すため、AWS を接続する前にプロトタイプを作成できます。
+
+通常は `ampless` に直接依存する必要はありません — `create-ampless` のブログテンプレートや `@ampless/plugin-*` が依存パッケージとして取り込みます。独自のプラグインやテーマを作成する場合にのみ直接インストールしてください。
+
+## インストール
+
+```bash
+npm install ampless@alpha
+```
+
+## 使い方
+
+```ts
+import { defineConfig } from 'ampless'
+
+export default defineConfig({
+  site: {
+    name: 'My Blog',
+    url: 'https://example.com',
+  },
+  plugins: [],
+})
+```
+
+## 動作要件
+
+- Node.js >= 20
+- AWS Amplify Gen 2
+
+## ライセンス
+
+[MIT](../../LICENSE)

package/README.md

@@ -1,3 +1,6 @@
+> 日本語版: [README.ja.md](./README.ja.md)
+> 
+
 # ampless
 
 CMS core library for AWS Amplify.

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.5",
+  "version": "0.2.0-alpha.7",
   "description": "Serverless CMS for AWS Amplify",
   "license": "MIT",
   "type": "module",