nextly 0.0.1 → 0.0.2-alpha.0

package/dist/api/media.mjs

@@ -0,0 +1,242 @@
+import {
+  readJsonBody
+} from "../chunk-VQJQHVEV.mjs";
+import {
+  nextlyValidationFromZod
+} from "../chunk-GJNSJU4S.mjs";
+import "../chunk-VWF3JO32.mjs";
+import {
+  withErrorHandler
+} from "../chunk-TO5AFLVQ.mjs";
+import {
+  getCachedNextly
+} from "../chunk-P7NH2OSC.mjs";
+import "../chunk-2OALJTK6.mjs";
+import "../chunk-VJ66NCL4.mjs";
+import "../chunk-R6JJQHFC.mjs";
+import "../chunk-X23WKS3Z.mjs";
+import {
+  getService
+} from "../chunk-X7TXCYYN.mjs";
+import "../chunk-YZNBLFIW.mjs";
+import "../chunk-FQULBZ53.mjs";
+import "../chunk-67GXH6PR.mjs";
+import "../chunk-2TFX4ND3.mjs";
+import "../chunk-W4MGXIRR.mjs";
+import {
+  UpdateMediaInputSchema,
+  UploadMediaInputSchema
+} from "../chunk-NSEFNNU4.mjs";
+import "../chunk-3FA7FKAV.mjs";
+import "../chunk-AGJ6F2T3.mjs";
+import "../chunk-KIMNCZGV.mjs";
+import "../chunk-AK6Z23OX.mjs";
+import "../chunk-INV7QKLG.mjs";
+import "../chunk-GZ6DCQKC.mjs";
+import "../chunk-SBACDPNX.mjs";
+import "../chunk-RJLLGGPG.mjs";
+import "../chunk-V4EQTOA4.mjs";
+import "../chunk-I4JMR3UR.mjs";
+import "../chunk-XZKLBMN6.mjs";
+import "../chunk-IZWPRDC3.mjs";
+import "../chunk-DNNG377Z.mjs";
+import "../chunk-5HMZ644B.mjs";
+import "../chunk-W5KKPZT5.mjs";
+import "../chunk-56WO4WX7.mjs";
+import {
+  withTimezoneFormatting
+} from "../chunk-2W3DVD7S.mjs";
+import "../chunk-TS7GHTG2.mjs";
+import "../chunk-H26B4FYG.mjs";
+import "../chunk-DP3G27G5.mjs";
+import "../chunk-DV6WVX2Q.mjs";
+import "../chunk-UJ2IMJ4W.mjs";
+import "../chunk-EGXBZCGC.mjs";
+import "../chunk-G2AA4QLC.mjs";
+import "../chunk-4MJLT6PZ.mjs";
+import {
+  respondAction,
+  respondDoc,
+  respondList,
+  respondMutation
+} from "../chunk-IUDOC7N7.mjs";
+import "../chunk-LAZXX4HR.mjs";
+import "../chunk-D5HQBNUB.mjs";
+import {
+  NextlyError
+} from "../chunk-NRUWQ5Z7.mjs";
+import "../chunk-VTJADRO3.mjs";
+import "../chunk-5APFUGAD.mjs";
+import "../chunk-7P6ASYW6.mjs";
+
+// src/api/media.ts
+import { z } from "zod";
+async function getMediaService() {
+  await getCachedNextly();
+  return getService("mediaService");
+}
+function createRequestContext() {
+  return {};
+}
+function createAuthenticatedContext(userId) {
+  return {
+    user: {
+      id: userId,
+      email: `${userId}@api.local`,
+      role: "user",
+      permissions: []
+    }
+  };
+}
+var GET = withErrorHandler(
+  async (request) => {
+    const mediaService = await getMediaService();
+    const { searchParams } = new URL(request.url);
+    const context = createRequestContext();
+    const folderIdParam = searchParams.get("folderId");
+    const options = {
+      page: searchParams.get("page") ? Number(searchParams.get("page")) : 1,
+      limit: searchParams.get("limit") ? Number(searchParams.get("limit")) : 24,
+      search: searchParams.get("search") || void 0,
+      type: searchParams.get("type") || void 0,
+      folderId: folderIdParam === "root" ? "root" : folderIdParam || void 0,
+      sortBy: searchParams.get("sortBy") || "uploadedAt",
+      sortOrder: searchParams.get("sortOrder") || "desc"
+    };
+    const result = await mediaService.listMedia(options, context);
+    const page = options.page ?? 1;
+    const limit = Math.max(1, options.limit ?? 24);
+    const total = result.pagination.total;
+    const totalPages = limit > 0 ? Math.ceil(total / limit) : 0;
+    return withTimezoneFormatting(
+      respondList(result.data, {
+        total,
+        page,
+        limit,
+        totalPages,
+        hasNext: page < totalPages,
+        hasPrev: page > 1
+      })
+    );
+  }
+);
+var POST = withErrorHandler(
+  async (request) => {
+    const mediaService = await getMediaService();
+    const formData = await request.formData();
+    const file = formData.get("file");
+    const uploadedBy = formData.get("uploadedBy");
+    const folderId = formData.get("folderId");
+    const errors = [];
+    if (!file) {
+      errors.push({
+        path: "file",
+        code: "REQUIRED",
+        message: "file is required."
+      });
+    }
+    if (!uploadedBy) {
+      errors.push({
+        path: "uploadedBy",
+        code: "REQUIRED",
+        message: "uploadedBy is required."
+      });
+    }
+    if (errors.length > 0) {
+      throw NextlyError.validation({ errors });
+    }
+    const fileEnsured = file;
+    const uploadedByEnsured = uploadedBy;
+    const arrayBuffer = await fileEnsured.arrayBuffer();
+    const buffer = Buffer.from(arrayBuffer);
+    const input = {
+      file: buffer,
+      filename: fileEnsured.name,
+      mimeType: fileEnsured.type,
+      size: fileEnsured.size,
+      uploadedBy: uploadedByEnsured
+    };
+    try {
+      UploadMediaInputSchema.parse(input);
+    } catch (err) {
+      if (err instanceof z.ZodError) throw nextlyValidationFromZod(err);
+      throw err;
+    }
+    const context = createAuthenticatedContext(uploadedByEnsured);
+    const mediaFile = await mediaService.upload(
+      {
+        buffer,
+        filename: fileEnsured.name,
+        mimeType: fileEnsured.type,
+        size: fileEnsured.size,
+        folderId: folderId || void 0
+      },
+      context
+    );
+    return withTimezoneFormatting(
+      respondMutation("Media uploaded.", mediaFile, { status: 201 })
+    );
+  }
+);
+function getMediaById(request, ctx) {
+  return withErrorHandler(
+    async (_req, routeCtx) => {
+      const mediaService = await getMediaService();
+      const { id } = await routeCtx.params;
+      const context = createRequestContext();
+      const mediaFile = await mediaService.findById(id, context);
+      return withTimezoneFormatting(respondDoc(mediaFile));
+    }
+  )(request, ctx);
+}
+function updateMedia(request, ctx) {
+  return withErrorHandler(
+    async (req, routeCtx) => {
+      const mediaService = await getMediaService();
+      const body = await readJsonBody(req);
+      let validated;
+      try {
+        validated = UpdateMediaInputSchema.parse(body);
+      } catch (err) {
+        if (err instanceof z.ZodError) throw nextlyValidationFromZod(err);
+        throw err;
+      }
+      const { id } = await routeCtx.params;
+      const context = createRequestContext();
+      const mediaFile = await mediaService.update(id, validated, context);
+      return withTimezoneFormatting(respondMutation("Media updated.", mediaFile));
+    }
+  )(request, ctx);
+}
+function deleteMedia(request, ctx) {
+  return withErrorHandler(
+    async (_req, routeCtx) => {
+      const mediaService = await getMediaService();
+      const { id } = await routeCtx.params;
+      const context = createRequestContext();
+      await mediaService.delete(id, context);
+      return respondAction("Media deleted.", { id });
+    }
+  )(request, ctx);
+}
+function moveMediaToFolder(request, ctx) {
+  return withErrorHandler(
+    async (req, routeCtx) => {
+      const mediaService = await getMediaService();
+      const { id } = await routeCtx.params;
+      const body = await readJsonBody(req);
+      const folderId = body.folderId;
+      const context = createRequestContext();
+      await mediaService.moveToFolder(id, folderId ?? null, context);
+      return respondAction("Media moved.", { id, folderId: folderId ?? null });
+    }
+  )(request, ctx);
+}
+export {
+  GET,
+  POST,
+  deleteMedia,
+  getMediaById,
+  moveMediaToFolder,
+  updateMedia
+};

package/dist/api/singles-detail.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Singles Detail API Route Handlers for Next.js
+ *
+ * These route handlers can be re-exported in your Next.js application to provide
+ * individual Single management endpoints at /api/singles/[slug].
+ *
+ * Services are auto-initialized on first request using environment variables:
+ * - DB_DIALECT: Database dialect ("postgresql" | "mysql" | "sqlite")
+ * - DATABASE_URL: Database connection string
+ *
+ * @example
+ * ```typescript
+ * // In your Next.js app: app/api/singles/[slug]/route.ts
+ * export { GET, PATCH } from 'nextly/api/singles-detail';
+ * ```
+ *
+ * @module api/singles-detail
+ */
+/**
+ * Context object for dynamic route handlers.
+ * Next.js 15+ requires params to be a Promise.
+ */
+interface RouteContext {
+    params: Promise<{
+        slug: string;
+    }>;
+}
+/**
+ * GET handler for retrieving a Single document by slug.
+ *
+ * This is a public endpoint - no authentication required.
+ * If the Single document doesn't exist, it will be auto-created with default
+ * field values.
+ *
+ * Query Parameters:
+ * - depth: Relationship expansion depth (reserved for future use)
+ * - locale: Locale for localized fields (reserved for future use)
+ * - richTextFormat: Output format for rich text fields ("json" | "html" | "both")
+ *   - "json" (default): Return Lexical JSON structure only
+ *   - "html": Return HTML string only
+ *   - "both": Return object with both { json, html } properties
+ *
+ * Response:
+ * - 200 OK: bare document object (canonical `respondDoc` shape).
+ * - On error: `application/problem+json` per spec §10.1.
+ */
+declare const GET: (request: Request, context: RouteContext) => Promise<Response>;
+/**
+ * PATCH handler for updating a Single document.
+ *
+ * Requires authentication. If the Single document doesn't exist,
+ * it will be auto-created first, then updated with the provided data.
+ *
+ * Note: Singles cannot be deleted. They represent persistent site-wide
+ * configuration that always exists once accessed.
+ *
+ * Request Body:
+ * - Any fields defined in the Single schema
+ * - System fields (id, createdAt) are ignored if included
+ *
+ * Response:
+ * - 200 OK: `{ "message": "...", "item": { ... } }` (updated document).
+ * - On error: `application/problem+json` per spec §10.1.
+ */
+declare const PATCH: (request: Request, context: RouteContext) => Promise<Response>;
+/**
+ * GET handler for retrieving Single schema/metadata by slug.
+ *
+ * This endpoint returns the Single's schema configuration, not the document data.
+ * Useful for Admin UI to understand the field structure.
+ *
+ * Requires authentication.
+ *
+ * Response:
+ * - 200 OK: bare schema object (canonical `respondDoc` shape).
+ * - 401 / 404 / 500: `application/problem+json` per spec §10.1.
+ *
+ * @example
+ * ```bash
+ * curl -H "Authorization: Bearer <token>" \
+ *   "http://localhost:3000/api/singles/site-settings/schema"
+ * # => {"slug":"site-settings","label":"Site Settings","fields":[...]}
+ * ```
+ */
+declare function getSchema(request: Request, slug: string): Promise<Response>;
+
+export { GET, PATCH, getSchema };

package/dist/api/singles-detail.mjs

@@ -0,0 +1,170 @@
+import {
+  requireAuthHeader
+} from "../chunk-WZBYMYVW.mjs";
+import {
+  readJsonBody
+} from "../chunk-VQJQHVEV.mjs";
+import "../chunk-VWF3JO32.mjs";
+import {
+  withErrorHandler
+} from "../chunk-TO5AFLVQ.mjs";
+import {
+  getCachedNextly
+} from "../chunk-P7NH2OSC.mjs";
+import "../chunk-2OALJTK6.mjs";
+import "../chunk-VJ66NCL4.mjs";
+import "../chunk-R6JJQHFC.mjs";
+import "../chunk-X23WKS3Z.mjs";
+import {
+  getService
+} from "../chunk-X7TXCYYN.mjs";
+import "../chunk-YZNBLFIW.mjs";
+import "../chunk-FQULBZ53.mjs";
+import "../chunk-67GXH6PR.mjs";
+import "../chunk-2TFX4ND3.mjs";
+import "../chunk-W4MGXIRR.mjs";
+import {
+  transformRichTextFields
+} from "../chunk-NSEFNNU4.mjs";
+import "../chunk-3FA7FKAV.mjs";
+import "../chunk-AGJ6F2T3.mjs";
+import "../chunk-KIMNCZGV.mjs";
+import "../chunk-AK6Z23OX.mjs";
+import "../chunk-INV7QKLG.mjs";
+import "../chunk-GZ6DCQKC.mjs";
+import "../chunk-SBACDPNX.mjs";
+import "../chunk-RJLLGGPG.mjs";
+import "../chunk-V4EQTOA4.mjs";
+import "../chunk-I4JMR3UR.mjs";
+import "../chunk-XZKLBMN6.mjs";
+import "../chunk-IZWPRDC3.mjs";
+import "../chunk-DNNG377Z.mjs";
+import "../chunk-5HMZ644B.mjs";
+import "../chunk-W5KKPZT5.mjs";
+import "../chunk-56WO4WX7.mjs";
+import {
+  withTimezoneFormatting
+} from "../chunk-2W3DVD7S.mjs";
+import "../chunk-TS7GHTG2.mjs";
+import "../chunk-H26B4FYG.mjs";
+import "../chunk-DP3G27G5.mjs";
+import "../chunk-DV6WVX2Q.mjs";
+import "../chunk-UJ2IMJ4W.mjs";
+import "../chunk-EGXBZCGC.mjs";
+import "../chunk-G2AA4QLC.mjs";
+import "../chunk-4MJLT6PZ.mjs";
+import {
+  respondDoc,
+  respondMutation
+} from "../chunk-IUDOC7N7.mjs";
+import "../chunk-LAZXX4HR.mjs";
+import "../chunk-D5HQBNUB.mjs";
+import {
+  NextlyError
+} from "../chunk-NRUWQ5Z7.mjs";
+import "../chunk-VTJADRO3.mjs";
+import "../chunk-5APFUGAD.mjs";
+import "../chunk-7P6ASYW6.mjs";
+
+// src/api/singles-detail.ts
+async function getSingleEntryService() {
+  await getCachedNextly();
+  return getService("singleEntryService");
+}
+async function getSingleRegistry() {
+  await getCachedNextly();
+  return getService("singleRegistryService");
+}
+function throwFromSingleResult(result, slug) {
+  const logContext = {
+    slug,
+    legacyStatusCode: result.statusCode,
+    legacyMessage: result.message
+  };
+  if (result.errors) logContext.legacyErrors = result.errors;
+  if (result.statusCode === 404) {
+    throw NextlyError.notFound({ logContext });
+  }
+  if (result.statusCode === 400) {
+    throw NextlyError.validation({
+      errors: (result.errors ?? []).map((e) => ({
+        path: e.field ?? "",
+        code: "INVALID",
+        message: e.message
+      })),
+      logContext
+    });
+  }
+  throw NextlyError.internal({ logContext });
+}
+var VALID_RICH_TEXT_FORMATS = ["json", "html", "both"];
+function parseRichTextFormat(value) {
+  if (!value) return "json";
+  const normalized = value.toLowerCase();
+  if (VALID_RICH_TEXT_FORMATS.includes(normalized)) {
+    return normalized;
+  }
+  return "json";
+}
+var GET = withErrorHandler(
+  async (request, context) => {
+    const { slug } = await context.params;
+    const service = await getSingleEntryService();
+    const { searchParams } = new URL(request.url);
+    const depth = searchParams.get("depth") ? parseInt(searchParams.get("depth"), 10) : void 0;
+    const locale = searchParams.get("locale") || void 0;
+    const richTextFormat = parseRichTextFormat(
+      searchParams.get("richTextFormat")
+    );
+    const result = await service.get(slug, { depth, locale });
+    if (!result.success) {
+      throwFromSingleResult(result, slug);
+    }
+    let responseData = result.data;
+    if (richTextFormat !== "json" && result.data) {
+      const registry = await getSingleRegistry();
+      const single = await registry.getSingleBySlug(slug);
+      if (single?.fields && Array.isArray(single.fields)) {
+        responseData = transformRichTextFields(
+          result.data,
+          single.fields,
+          richTextFormat
+        );
+      }
+    }
+    return withTimezoneFormatting(respondDoc(responseData));
+  }
+);
+var PATCH = withErrorHandler(
+  async (request, context) => {
+    requireAuthHeader(request);
+    const { slug } = await context.params;
+    const service = await getSingleEntryService();
+    const body = await readJsonBody(request, { slug });
+    const { searchParams } = new URL(request.url);
+    const locale = searchParams.get("locale") || void 0;
+    const result = await service.update(slug, body, { locale });
+    if (!result.success) {
+      throwFromSingleResult(result, slug);
+    }
+    return withTimezoneFormatting(
+      respondMutation("Single updated.", result.data)
+    );
+  }
+);
+function getSchema(request, slug) {
+  return withErrorHandler(async (req) => {
+    requireAuthHeader(req);
+    const registry = await getSingleRegistry();
+    const single = await registry.getSingleBySlug(slug);
+    if (!single) {
+      throw NextlyError.notFound({ logContext: { slug } });
+    }
+    return respondDoc(single);
+  })(request);
+}
+export {
+  GET,
+  PATCH,
+  getSchema
+};

package/dist/api/singles-schema-detail.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Singles Schema Detail API Route Handlers for Next.js
+ *
+ * These route handlers can be re-exported in your Next.js application to provide
+ * individual Single schema management endpoints at /api/singles/[slug]/schema.
+ *
+ * This is separate from the document endpoints (/api/singles/[slug]) which
+ * handle the actual content/values of a Single.
+ *
+ * Services are auto-initialized on first request using environment variables:
+ * - DB_DIALECT: Database dialect ("postgresql" | "mysql" | "sqlite")
+ * - DATABASE_URL: Database connection string
+ *
+ * @example
+ * ```typescript
+ * // In your Next.js app: app/api/singles/[slug]/schema/route.ts
+ * export { GET, PATCH, DELETE } from 'nextly/api/singles-schema-detail';
+ * ```
+ *
+ * @module api/singles-schema-detail
+ */
+/**
+ * Context object for dynamic route handlers.
+ * Next.js 15+ requires params to be a Promise.
+ */
+interface RouteContext {
+    params: Promise<{
+        slug: string;
+    }>;
+}
+/**
+ * GET handler for retrieving a Single's schema/metadata by slug.
+ *
+ * Requires authentication.
+ */
+declare const GET: (request: Request, context: RouteContext) => Promise<Response>;
+/**
+ * PATCH handler for updating a Single's schema/metadata.
+ *
+ * Requires authentication. The registry returns 403 if the Single is locked
+ * (code-first Singles cannot be modified via API).
+ */
+declare const PATCH: (request: Request, context: RouteContext) => Promise<Response>;
+/**
+ * DELETE handler for removing a Single.
+ *
+ * Requires authentication. The registry returns 403 if the Single is locked
+ * (code-first Singles cannot be deleted via API). Singles require
+ * `force: true` to delete because they represent persistent site-wide
+ * configuration.
+ */
+declare const DELETE: (request: Request, context: RouteContext) => Promise<Response>;
+
+export { DELETE, GET, PATCH };