@ampless/admin 0.2.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ampless contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,78 @@
+# @ampless/admin
+
+Admin UI library for [ampless](https://github.com/heavymoons/ampless): post
+editor (Tiptap + Markdown + HTML), media manager (S3 + image processing),
+site/theme settings, locale-aware UI strings, and the Next.js page
+factories that wire it all together.
+
+> **Pre-release / alpha.** Breaking changes possible in any minor version until v1.0.
+
+## Why a library?
+
+The admin UI used to live in the template project. Every bug fix and
+feature meant copy-pasting files between the template and downstream
+sites. Extracting to `@ampless/admin` lets a project run
+`npm update @ampless/admin` to pick up improvements — the same upgrade
+flow as any other dependency.
+
+## Install
+
+```bash
+npm install @ampless/admin@alpha @ampless/runtime@alpha ampless@alpha
+```
+
+Peer-installs: `next`, `react`, `react-dom`, `aws-amplify`,
+`@aws-amplify/adapter-nextjs`.
+
+## Wire-up
+
+Create `lib/admin.ts` in your Next.js project:
+
+```ts
+import outputs from '../amplify_outputs.json'
+import cmsConfig from '../cms.config'
+import { createAdmin } from '@ampless/admin'
+import { ampless } from './ampless'
+
+export const admin = createAdmin({ outputs, cmsConfig, ampless })
+export const t = admin.t
+```
+
+Then expose each admin route as a thin shell:
+
+```tsx
+// app/(admin)/admin/posts/page.tsx
+import { admin } from '@/lib/admin'
+import { createPostsListPage } from '@ampless/admin/pages'
+export default createPostsListPage(admin)
+```
+
+```ts
+// app/api/media/[...path]/route.ts
+import { admin } from '@/lib/admin'
+import { createMediaProxyRoute } from '@ampless/admin/api'
+export const { GET } = createMediaProxyRoute(admin)
+export const runtime = 'nodejs'
+```
+
+## Sub-paths
+
+| Subpath                       | Contains                                            |
+| ----------------------------- | --------------------------------------------------- |
+| `@ampless/admin`              | `createAdmin` factory + `Admin` interface           |
+| `@ampless/admin/pages`        | Page factories — one per admin route                |
+| `@ampless/admin/api`          | API route factories (`createMediaProxyRoute`, ...)  |
+| `@ampless/admin/components`   | Form / editor components for advanced wiring        |
+
+## Locale
+
+`createAdmin({ locale: 'ja' })` switches admin UI strings to Japanese.
+Pass an object literal to override individual strings:
+
+```ts
+createAdmin({
+  outputs,
+  cmsConfig,
+  locale: { sidebar: { brand: 'MySite Admin' } },
+})
+```

package/dist/api/index.d.ts

@@ -0,0 +1,24 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { Admin } from '../index.js';
+import 'ampless';
+import '@ampless/runtime';
+import '../i18n-ByHM_Bho.js';
+import '@aws-amplify/adapter-nextjs';
+
+/**
+ * Build the `/api/media/[...path]` route handler. Proxies uploaded
+ * media through Next.js so embedded `<img src>` URLs stay permanent.
+ * The browser hits `/api/media/<path>`, this route fetches the
+ * short-lived presigned URL via Amplify SSR, then redirects.
+ *
+ * Used when `cms.config.media.delivery !== 's3-direct'` (default).
+ */
+declare function createMediaProxyRoute(admin: Admin): {
+    GET: (_req: NextRequest, ctx: {
+        params: Promise<{
+            path: string[];
+        }>;
+    }) => Promise<NextResponse<unknown>>;
+};
+
+export { createMediaProxyRoute };

package/dist/api/index.js

@@ -0,0 +1,41 @@
+// src/api/media-proxy.ts
+import { NextResponse } from "next/server";
+import { cookies } from "next/headers";
+import { getUrl } from "aws-amplify/storage/server";
+function createMediaProxyRoute(admin) {
+  const { runWithAmplifyServerContext } = admin.amplifyServer;
+  async function GET(_req, ctx) {
+    const { path } = await ctx.params;
+    if (!path.length || path.some(
+      (segment) => !segment || segment === "." || segment === ".." || segment.includes("/") || segment.includes("\\") || segment.includes("\0")
+    )) {
+      return NextResponse.json({ error: "Invalid path" }, { status: 400 });
+    }
+    const objectPath = `public/${path.join("/")}`;
+    try {
+      const url = await runWithAmplifyServerContext({
+        nextServerContext: { cookies },
+        operation: async (amplifyContext) => {
+          const result = await getUrl(amplifyContext, {
+            path: objectPath,
+            options: { expiresIn: 60 * 60 }
+          });
+          return result.url.toString();
+        }
+      });
+      return NextResponse.redirect(url, {
+        status: 302,
+        headers: { "Cache-Control": "public, max-age=300" }
+      });
+    } catch (err) {
+      return NextResponse.json(
+        { error: err instanceof Error ? err.message : "Failed to fetch media" },
+        { status: 404 }
+      );
+    }
+  }
+  return { GET };
+}
+export {
+  createMediaProxyRoute
+};