@ampless/backend 1.0.0-alpha.71 → 1.0.0-beta.73

package/README.ja.md

@@ -5,14 +5,14 @@
 
 [ampless](https://github.com/heavymoons/ampless) 向け Amplify Gen 2 バックエンドファクトリー。IAM / SQS / DynamoDB ストリームの配線、認証 / データ / ストレージの定義、およびすべてのイベント処理 Lambda を `defineAmplessBackend(...)` ひとつのファクトリーにまとめます。
 
-> **プレリリース / アルファ版。** v1.0 まではマイナーバージョンでも破壊的変更が入る可能性があります。
+> **プレリリース / ベータ版。** v1.0 まではマイナーバージョンでも破壊的変更が入る可能性があります。
 
 テンプレートから切り出すことで、スキャフォールダーを再実行せずに `npm update @ampless/backend` でアップデートできます。バックエンドのバグ修正やインフラ改善はパッケージ経由で届きます。ユーザー側の `amplify/` ツリーは、ファクトリーを組み合わせる 1〜5 行のシェルだけで済みます。
 
 ## インストール
 
 ```bash
-npm install @ampless/backend@alpha ampless@alpha
+npm install @ampless/backend@beta ampless@beta
 ```
 
 ピア依存: `@aws-amplify/backend`（^1）、`aws-cdk-lib`（^2）。CLI スキャフォールダーがテンプレートの `package.json` に互換バージョンをピン留めします。

package/README.md

@@ -5,14 +5,14 @@
 
 Amplify Gen 2 backend factories for [ampless](https://github.com/heavymoons/ampless). Bundles the IAM / SQS / DynamoDB-stream wiring, the auth / data / storage definitions, and every event-processing Lambda behind one `defineAmplessBackend(...)` factory.
 
-> **Pre-release / alpha.** Breaking changes possible in any minor version until v1.0.
+> **Pre-release / beta.** Breaking changes possible in any minor version until v1.0.
 
 Splitting this out of the template lets you `npm update @ampless/backend` without re-running the scaffolder. Backend bug fixes and infrastructure improvements arrive through the package; the user-side `amplify/` tree becomes a handful of 1–5 line shells that compose the factories.
 
 ## Install
 
 ```bash
-npm install @ampless/backend@alpha ampless@alpha
+npm install @ampless/backend@beta ampless@beta
 ```
 
 Peer dependencies: `@aws-amplify/backend` (^1), `aws-cdk-lib` (^2). The CLI scaffolder pins compatible versions in the template's `package.json`.

package/dist/events/processor-trusted.js

@@ -222,7 +222,7 @@ function createProcessorTrustedHandler(opts) {
             }
           } else {
             console.warn(
-              `[trusted-processor] ${label}: ctx.secret("${key}") \u2014 no encryption key found; returning undefined. Run \`npx create-ampless setup-encryption-key\` and rotate secrets.`
+              `[trusted-processor] ${label}: ctx.secret("${key}") \u2014 no encryption key found; returning undefined. Run \`npx create-ampless@beta setup-encryption-key\` and rotate secrets.`
             );
             secretCache.set(cacheKey, void 0);
             return void 0;

package/dist/functions/mcp-handler.js

@@ -4,6 +4,7 @@ import { DynamoDBDocumentClient, GetCommand, UpdateCommand } from "@aws-sdk/lib-
 import { createHash } from "crypto";
 
 // ../mcp-server/dist/index.js
+import { filterSortPostSummaries } from "ampless";
 import {
   decodeAwsJson
 } from "ampless";
@@ -53,11 +54,28 @@ var POST_FIELDS = (
     body
     status
     publishedAt
+    updatedAt
     tags
     metadata
   }
 `
 );
+var POST_SUMMARY_FIELDS = (
+  /* GraphQL */
+  `
+  fragment PostSummaryFields on Post {
+    postId
+    slug
+    title
+    excerpt
+    format
+    status
+    publishedAt
+    updatedAt
+    tags
+  }
+`
+);
 function toCorePost(p) {
   const metadata = decodeAwsJson(p.metadata);
   return {
@@ -69,18 +87,32 @@ function toCorePost(p) {
     body: decodeAwsJson(p.body),
     status: p.status ?? "draft",
     publishedAt: p.publishedAt ?? void 0,
+    updatedAt: p.updatedAt ?? void 0,
     tags: (p.tags ?? []).filter((t) => typeof t === "string"),
     metadata: metadata && typeof metadata === "object" && !Array.isArray(metadata) ? metadata : void 0
   };
 }
+function toPostSummary(p) {
+  return {
+    postId: p.postId,
+    slug: p.slug,
+    title: p.title,
+    excerpt: p.excerpt ?? void 0,
+    format: p.format ?? "markdown",
+    status: p.status ?? "draft",
+    publishedAt: p.publishedAt ?? void 0,
+    updatedAt: p.updatedAt ?? void 0,
+    tags: (p.tags ?? []).filter((t) => typeof t === "string")
+  };
+}
 var QUERY = (
   /* GraphQL */
   `
-  ${POST_FIELDS}
+  ${POST_SUMMARY_FIELDS}
   query ListPosts($filter: ModelPostFilterInput, $limit: Int, $nextToken: String) {
     listPosts(filter: $filter, limit: $limit, nextToken: $nextToken) {
       items {
-        ...PostFields
+        ...PostSummaryFields
       }
       nextToken
     }
@@ -90,29 +122,95 @@ var QUERY = (
 var listPostsSchema = {
   type: "object",
   properties: {
+    query: {
+      type: "string",
+      description: "Case-insensitive substring match over title / slug / tags"
+    },
+    tag: {
+      type: "string",
+      description: "Exact tag filter"
+    },
     status: {
       type: "string",
       enum: ["draft", "published", "all"],
       description: 'Filter by status (default "all")'
     },
-    limit: { type: "integer", minimum: 1, maximum: 100, description: "Max results (default 20)" },
-    nextToken: { type: "string", description: "Pagination cursor from a previous call" }
+    sort: {
+      type: "string",
+      enum: [
+        "updated-desc",
+        "updated-asc",
+        "published-desc",
+        "published-asc",
+        "title-asc",
+        "title-desc"
+      ],
+      description: 'Sort order (default "updated-desc" \u2014 most recently edited first)'
+    },
+    limit: {
+      type: "integer",
+      minimum: 1,
+      maximum: 100,
+      description: "Max results per page (default 20)"
+    },
+    offset: {
+      type: "integer",
+      minimum: 0,
+      description: "Zero-based offset into the filtered result set (default 0)"
+    }
   }
 };
+var VALID_STATUS = /* @__PURE__ */ new Set(["draft", "published", "all"]);
+var VALID_SORT = /* @__PURE__ */ new Set([
+  "updated-desc",
+  "updated-asc",
+  "published-desc",
+  "published-asc",
+  "title-asc",
+  "title-desc"
+]);
+function asString(v) {
+  return typeof v === "string" ? v : void 0;
+}
+function asInt(v, fallback) {
+  const n = Number(v);
+  return Number.isFinite(n) ? Math.trunc(n) : fallback;
+}
 async function listPosts(client, args = {}) {
-  const status = args.status ?? "all";
+  const limit = Math.min(100, Math.max(1, asInt(args.limit, 20)));
+  const offset = Math.max(0, asInt(args.offset, 0));
+  const rawStatus = asString(args.status);
+  const status = rawStatus && VALID_STATUS.has(rawStatus) ? rawStatus : "all";
+  const rawSort = asString(args.sort);
+  const sort = rawSort && VALID_SORT.has(rawSort) ? rawSort : void 0;
+  const query = asString(args.query);
+  const tag = asString(args.tag);
   const filter = {};
   if (status !== "all") filter.status = { eq: status };
   const hasFilter = Object.keys(filter).length > 0;
-  const data = await client.query(QUERY, {
-    filter: hasFilter ? filter : void 0,
-    limit: args.limit ?? 20,
-    nextToken: args.nextToken
+  const allItems = [];
+  let cursor = null;
+  do {
+    const data = await client.query(QUERY, {
+      filter: hasFilter ? filter : void 0,
+      limit: 200,
+      nextToken: cursor
+    });
+    for (const item of data.listPosts.items) {
+      allItems.push(toPostSummary(item));
+    }
+    cursor = data.listPosts.nextToken;
+  } while (cursor);
+  const filtered = filterSortPostSummaries(allItems, {
+    query,
+    tag,
+    sort,
+    // status already applied server-side; pass 'all' to avoid double-filter
+    status: "all"
   });
-  return {
-    posts: data.listPosts.items.map(toCorePost),
-    nextToken: data.listPosts.nextToken
-  };
+  const total = filtered.length;
+  const posts = filtered.slice(offset, offset + limit);
+  return { posts, total, offset, limit };
 }
 var GET_BY_ID = (
   /* GraphQL */
@@ -1547,7 +1645,7 @@ async function commitStaticPost(graphql, storage, args) {
 var tools = [
   {
     name: "list_posts",
-    description: "List posts in the CMS with optional filters by status. Returns up to `limit` posts (default 20) plus a `nextToken` cursor for pagination.",
+    description: "Returns lightweight post summaries (no body \u2014 use get_post for content) with search / sort / filters. `total` reflects the filtered count. Supports query (substring over title/slug/tags), tag (exact), status, sort, limit (1\u2013100, default 20), offset (default 0).",
     inputSchema: listPostsSchema,
     handler: (args, ctx) => listPosts(ctx.graphql, args)
   },

package/dist/functions/plugin-secret-handler.js

@@ -18,13 +18,13 @@ function requireEnv(name) {
 var _encKeyB64 = process.env.PLUGIN_SECRET_ENCRYPTION_KEY;
 if (!_encKeyB64) {
   throw new Error(
-    "[plugin-secret-handler] PLUGIN_SECRET_ENCRYPTION_KEY env var is not set. Run `npx create-ampless setup-encryption-key` and configure pluginSecretEncryptionKey in defineAmplessBackend()."
+    "[plugin-secret-handler] PLUGIN_SECRET_ENCRYPTION_KEY env var is not set. Run `npx create-ampless@beta setup-encryption-key` and configure pluginSecretEncryptionKey in defineAmplessBackend()."
   );
 }
 var _encKeyBuf = Buffer.from(_encKeyB64, "base64");
 if (_encKeyBuf.byteLength !== 32) {
   throw new Error(
-    `[plugin-secret-handler] PLUGIN_SECRET_ENCRYPTION_KEY must encode 32 bytes (got ${_encKeyBuf.byteLength}). Re-run \`npx create-ampless setup-encryption-key\`.`
+    `[plugin-secret-handler] PLUGIN_SECRET_ENCRYPTION_KEY must encode 32 bytes (got ${_encKeyBuf.byteLength}). Re-run \`npx create-ampless@beta setup-encryption-key\`.`
   );
 }
 var ENCRYPTION_KEY = _encKeyBuf;

package/dist/index.d.ts

@@ -24,7 +24,7 @@ interface DefineAmplessBackendOpts {
      * and writes only ciphertext to DDB. The admin browser never touches
      * PluginSecret directly.
      *
-     * Generate and commit the key with `npx create-ampless setup-encryption-key`,
+     * Generate and commit the key with `npx create-ampless@beta setup-encryption-key`,
      * then pass it via `pluginSecretEncryptionKey` below. No AWS credentials
      * required for key provisioning.
      *
@@ -37,7 +37,7 @@ interface DefineAmplessBackendOpts {
      * AES-256-GCM encryption key for plugin secret storage (v2.2).
      *
      * A base64-encoded 32-byte key generated by
-     * `npx create-ampless setup-encryption-key` and stored in
+     * `npx create-ampless@beta setup-encryption-key` and stored in
      * `amplify/secrets/encryption-key.ts` (adjacent to `amplify/backend.ts`).
      *
      * Example wiring in `amplify/backend.ts`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampless/backend",
-  "version": "1.0.0-alpha.71",
+  "version": "1.0.0-beta.73",
   "description": "Amplify Gen 2 backend factories for ampless: auth, data, storage, event processors, API key renewer",
   "license": "MIT",
   "type": "module",
@@ -69,8 +69,8 @@
     "@smithy/protocol-http": "^5.4.4",
     "@smithy/signature-v4": "^5.4.4",
     "fflate": "^0.8.3",
-    "@ampless/mcp-server": "1.0.0-alpha.55",
-    "ampless": "1.0.0-alpha.49"
+    "@ampless/mcp-server": "1.0.0-beta.57",
+    "ampless": "1.0.0-beta.51"
   },
   "peerDependencies": {
     "@aws-amplify/backend": "^1",