ampless 0.2.0-alpha.4 → 0.2.0-alpha.6

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

@@ -452,6 +452,13 @@ interface KvStore {
 }
 declare function setKvStore(s: KvStore): void;
 declare function hasKvStore(): boolean;
+/**
+ * Access the injected `KvStore` directly. Use the site-setting helpers
+ * (`getSiteSetting` etc.) when storing per-site configuration; reach
+ * for this lower-level handle only when you need a different PK
+ * namespace (e.g. `mcp-tokens`).
+ */
+declare function getKvStore(): KvStore;
 declare const SITE_CONFIG_PK: (siteId: string) => string;
 declare function getSiteSetting<T = unknown>(siteId: string, key: string): Promise<T | null>;
 declare function setSiteSetting(siteId: string, key: string, value: unknown): Promise<void>;
@@ -712,4 +719,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, 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, 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 };

package/dist/index.js

@@ -136,6 +136,9 @@ function requireStore() {
   }
   return store;
 }
+function getKvStore() {
+  return requireStore();
+}
 var SITE_CONFIG_PK = (siteId) => `siteconfig:${siteId}`;
 async function getSiteSetting(siteId, key) {
   return requireStore().get(SITE_CONFIG_PK(siteId), key);
@@ -475,6 +478,7 @@ export {
   formatColorPair,
   formatDate,
   formatPublicAssetUrl,
+  getKvStore,
   getPost,
   getPostById,
   getSiteSetting,

package/package.json

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