@questpie/next 0.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,14 @@
+
+$ tsdown
+ℹ tsdown v0.18.4 powered by rolldown v1.0.0-beta.57
+ℹ config file: /Users/drepkovsky/questpie/repos/questpie-cms/packages/next/tsdown.config.ts 
+(node:61187) ExperimentalWarning: Type Stripping is an experimental feature and might change at any time
+(Use `node --trace-warnings ...` to show where the warning was created)
+ℹ entry: src/server.ts
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 2 files
+ℹ dist/server.mjs    0.84 kB │ gzip: 0.43 kB
+ℹ dist/server.d.mts  0.61 kB │ gzip: 0.31 kB
+ℹ 2 files, total: 1.46 kB
+✔ Build complete in 5270ms

package/.turbo/turbo-check-types.log

@@ -0,0 +1 @@
+$ tsc --noEmit

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @questpie/next
+
+## 0.0.1
+
+### Patch Changes
+
+- feat: initial release
+- Updated dependencies
+  - questpie@0.0.1

package/README.md

@@ -0,0 +1,287 @@
+# @questpie/next
+
+Next.js App Router adapter for QUESTPIE CMS.
+
+## Features
+
+- **App Router Support** - Catch-all route handlers for Next.js 13+
+- **Type-Safe Client** - Full TypeScript support with `@questpie/cms/client`
+- **Server Components** - Works with React Server Components
+- **Edge Runtime** - Compatible with Edge Runtime (with limitations)
+
+## Installation
+
+```bash
+bun add @questpie/next @questpie/cms
+```
+
+## Quick Start
+
+### 1. Configure CMS
+
+```typescript
+// src/cms/index.ts
+import { defineQCMS } from "@questpie/cms";
+
+export const cms = defineQCMS()
+  .db({ connectionString: process.env.DATABASE_URL! })
+  .collections({
+    /* your collections */
+  })
+  .auth({
+    baseURL: process.env.NEXT_PUBLIC_URL!,
+    secret: process.env.AUTH_SECRET!,
+  })
+  .build();
+
+export type AppCMS = typeof cms;
+```
+
+### 2. Create Route Handler
+
+```typescript
+// app/api/cms/[...path]/route.ts
+import { questpieNextRouteHandlers } from "@questpie/next";
+import { cms } from "@/cms";
+
+export const { GET, POST, PUT, PATCH, DELETE } = questpieNextRouteHandlers(
+  cms,
+  {
+    basePath: "/api/cms",
+  },
+);
+
+// Enable dynamic rendering
+export const dynamic = "force-dynamic";
+```
+
+### 3. Use the Client
+
+```typescript
+// src/lib/cms-client.ts
+import { createQCMSClient } from "@questpie/cms/client";
+import type { AppCMS } from "@/cms";
+
+export const cmsClient = createQCMSClient<AppCMS>({
+  baseURL: process.env.NEXT_PUBLIC_URL!,
+  basePath: "/api/cms",
+});
+```
+
+## Configuration Options
+
+```typescript
+questpieNextRouteHandlers(cms, {
+  // Base path for CMS routes (must match your route location)
+  basePath: "/api/cms",
+});
+```
+
+## API Routes
+
+The adapter creates the following routes under your base path:
+
+### Collections
+
+| Method | Route                                    | Description          |
+| ------ | ---------------------------------------- | -------------------- |
+| GET    | `/api/cms/collections/:name`             | List items           |
+| POST   | `/api/cms/collections/:name`             | Create item          |
+| GET    | `/api/cms/collections/:name/:id`         | Get item             |
+| PATCH  | `/api/cms/collections/:name/:id`         | Update item          |
+| DELETE | `/api/cms/collections/:name/:id`         | Delete item          |
+| POST   | `/api/cms/collections/:name/:id/restore` | Restore soft-deleted |
+
+### Globals
+
+| Method | Route                    | Description   |
+| ------ | ------------------------ | ------------- |
+| GET    | `/api/cms/globals/:name` | Get global    |
+| PATCH  | `/api/cms/globals/:name` | Update global |
+
+### Storage
+
+| Method | Route                     | Description |
+| ------ | ------------------------- | ----------- |
+| POST   | `/api/cms/storage/upload` | Upload file |
+
+### Authentication
+
+| Method | Route             | Description        |
+| ------ | ----------------- | ------------------ |
+| ALL    | `/api/cms/auth/*` | Better Auth routes |
+
+### Realtime
+
+| Method | Route                                  | Description      |
+| ------ | -------------------------------------- | ---------------- |
+| GET    | `/api/cms/collections/:name/subscribe` | SSE subscription |
+| GET    | `/api/cms/globals/:name/subscribe`     | SSE subscription |
+
+## Usage Examples
+
+### Server Component
+
+```typescript
+// app/posts/page.tsx
+import { cmsClient } from "@/lib/cms-client"
+
+export default async function PostsPage() {
+  const posts = await cmsClient.collections.posts.find({
+    where: { published: true },
+    orderBy: { publishedAt: "desc" },
+    limit: 10,
+  })
+
+  return (
+    <ul>
+      {posts.data.map((post) => (
+        <li key={post.id}>{post.title}</li>
+      ))}
+    </ul>
+  )
+}
+```
+
+### With Relations
+
+```typescript
+const post = await cmsClient.collections.posts.findOne({
+  where: { slug: params.slug },
+  with: {
+    author: true,
+    category: true,
+  },
+});
+```
+
+### Client Component with TanStack Query
+
+```typescript
+"use client";
+
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { cmsClient } from "@/lib/cms-client";
+
+export function PostsList() {
+  const { data: posts } = useQuery({
+    queryKey: ["posts"],
+    queryFn: () => cmsClient.collections.posts.find({ limit: 10 }),
+  });
+
+  const queryClient = useQueryClient();
+
+  const createPost = useMutation({
+    mutationFn: (data: { title: string }) =>
+      cmsClient.collections.posts.create(data),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["posts"] });
+    },
+  });
+
+  // ...
+}
+```
+
+### File Upload
+
+```typescript
+async function uploadFile(file: File) {
+  const formData = new FormData();
+  formData.append("file", file);
+
+  const response = await fetch("/api/cms/storage/upload", {
+    method: "POST",
+    body: formData,
+  });
+
+  return response.json();
+}
+```
+
+### Authentication
+
+```typescript
+// Sign in
+await cmsClient.auth.signIn({
+  email: "user@example.com",
+  password: "password",
+});
+
+// Get session
+const session = await cmsClient.auth.getSession();
+
+// Sign out
+await cmsClient.auth.signOut();
+```
+
+## Server Actions
+
+You can also use the CMS directly in Server Actions:
+
+```typescript
+// app/actions.ts
+"use server";
+
+import { cms } from "@/cms";
+import { revalidatePath } from "next/cache";
+
+export async function createPost(formData: FormData) {
+  const post = await cms.collections.posts.create({
+    title: formData.get("title") as string,
+    content: formData.get("content") as string,
+  });
+
+  revalidatePath("/posts");
+  return post;
+}
+```
+
+## Middleware
+
+Protect routes with Next.js middleware:
+
+```typescript
+// middleware.ts
+import { NextResponse } from "next/server";
+import type { NextRequest } from "next/server";
+
+export function middleware(request: NextRequest) {
+  const session = request.cookies.get("session");
+
+  if (!session && request.nextUrl.pathname.startsWith("/admin")) {
+    return NextResponse.redirect(new URL("/login", request.url));
+  }
+
+  return NextResponse.next();
+}
+
+export const config = {
+  matcher: ["/admin/:path*"],
+};
+```
+
+## Environment Variables
+
+```env
+# Required
+DATABASE_URL=postgresql://...
+NEXT_PUBLIC_URL=http://localhost:3000
+AUTH_SECRET=your-secret-key
+
+# Optional (for storage)
+S3_BUCKET=your-bucket
+S3_REGION=us-east-1
+S3_ACCESS_KEY=...
+S3_SECRET_KEY=...
+```
+
+## Related Packages
+
+- [`@questpie/cms`](../cms) - Core CMS engine
+- [`@questpie/admin`](../admin) - Admin UI
+- [`@questpie/tanstack-query`](../tanstack-query) - TanStack Query integration
+
+## License
+
+MIT

package/dist/server.d.mts

@@ -0,0 +1,15 @@
+import { CMSAdapterConfig, Questpie } from "questpie";
+
+//#region src/server.d.ts
+type NextAdapterConfig = CMSAdapterConfig;
+type NextHandler = (request: Request) => Promise<Response>;
+/**
+ * Create a Next.js-compatible handler for QUESTPIE CMS routes.
+ */
+declare const questpieNext: (cms: Questpie<any>, config?: NextAdapterConfig) => NextHandler;
+/**
+ * Convenience helpers for Next.js route handlers.
+ */
+declare const questpieNextRouteHandlers: (cms: Questpie<any>, config?: NextAdapterConfig) => Record<string, NextHandler>;
+//#endregion
+export { NextAdapterConfig, questpieNext, questpieNextRouteHandlers };

package/dist/server.mjs

@@ -0,0 +1,34 @@
+import { createFetchHandler } from "questpie";
+
+//#region src/server.ts
+const notFoundResponse = () => new Response(JSON.stringify({ error: "Not found" }), {
+	status: 404,
+	headers: { "Content-Type": "application/json" }
+});
+/**
+* Create a Next.js-compatible handler for QUESTPIE CMS routes.
+*/
+const questpieNext = (cms, config = {}) => {
+	const handler = createFetchHandler(cms, config);
+	return async (request) => {
+		return await handler(request) ?? notFoundResponse();
+	};
+};
+/**
+* Convenience helpers for Next.js route handlers.
+*/
+const questpieNextRouteHandlers = (cms, config = {}) => {
+	const handler = questpieNext(cms, config);
+	return {
+		GET: handler,
+		POST: handler,
+		PATCH: handler,
+		DELETE: handler,
+		PUT: handler,
+		OPTIONS: handler,
+		HEAD: handler
+	};
+};
+
+//#endregion
+export { questpieNext, questpieNextRouteHandlers };

package/package.json

@@ -0,0 +1,29 @@
+{
+	"name": "@questpie/next",
+	"version": "0.0.1",
+	"type": "module",
+	"scripts": {
+		"build": "tsdown",
+		"check-types": "tsc --noEmit"
+	},
+	"dependencies": {
+		"questpie": "workspace:*"
+	},
+	"devDependencies": {
+		"@questpie/typescript-config": "workspace:*",
+		"bun-types": "latest",
+		"tsdown": "^0.18.3"
+	},
+	"peerDependencies": {
+		"questpie": "workspace:*"
+	},
+	"exports": {
+		".": {
+			"import": "./dist/server.mjs",
+			"types": "./dist/server.d.mts"
+		}
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}

package/src/server.ts

@@ -0,0 +1,48 @@
+import { createFetchHandler, type CMSAdapterConfig, type Questpie } from "questpie";
+
+export type NextAdapterConfig = CMSAdapterConfig;
+
+type NextHandler = (request: Request) => Promise<Response>;
+
+const notFoundResponse = () =>
+	new Response(JSON.stringify({ error: "Not found" }), {
+		status: 404,
+		headers: {
+			"Content-Type": "application/json",
+		},
+	});
+
+/**
+ * Create a Next.js-compatible handler for QUESTPIE CMS routes.
+ */
+export const questpieNext = (
+	cms: Questpie<any>,
+	config: NextAdapterConfig = {},
+): NextHandler => {
+	const handler = createFetchHandler(cms, config);
+
+	return async (request) => {
+		const response = await handler(request);
+		return response ?? notFoundResponse();
+	};
+};
+
+/**
+ * Convenience helpers for Next.js route handlers.
+ */
+export const questpieNextRouteHandlers = (
+	cms: Questpie<any>,
+	config: NextAdapterConfig = {},
+): Record<string, NextHandler> => {
+	const handler = questpieNext(cms, config);
+
+	return {
+		GET: handler,
+		POST: handler,
+		PATCH: handler,
+		DELETE: handler,
+		PUT: handler,
+		OPTIONS: handler,
+		HEAD: handler,
+	};
+};

package/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "@questpie/typescript-config/bun.json",
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}