nextly 0.0.1 → 0.0.2-alpha.0

package/dist/api/singles-schema-detail.mjs

@@ -0,0 +1,182 @@
+import {
+  requireAuthHeader
+} from "../chunk-WZBYMYVW.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 {
+  getNextlyLogger
+} from "../chunk-W4MGXIRR.mjs";
+import "../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 {
+  calculateSchemaHash
+} from "../chunk-5HMZ644B.mjs";
+import "../chunk-W5KKPZT5.mjs";
+import "../chunk-56WO4WX7.mjs";
+import "../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-schema-detail.ts
+async function getSingleRegistry() {
+  await getCachedNextly();
+  return getService("singleRegistryService");
+}
+async function getComponentRegistry() {
+  await getCachedNextly();
+  return getService("componentRegistryService");
+}
+var GET = withErrorHandler(
+  async (request, context) => {
+    requireAuthHeader(request);
+    const { slug } = await context.params;
+    const registry = await getSingleRegistry();
+    const single = await registry.getSingle(slug);
+    let enrichedFields = single.fields;
+    try {
+      const componentRegistry = await getComponentRegistry();
+      enrichedFields = await componentRegistry.enrichFieldsWithComponentSchemas(
+        single.fields
+      );
+    } catch (enrichError) {
+      getNextlyLogger().warn({
+        kind: "single-schema-enrichment-failed",
+        slug,
+        err: String(enrichError)
+      });
+    }
+    return respondDoc({
+      ...single,
+      fields: enrichedFields
+    });
+  }
+);
+var PATCH = withErrorHandler(
+  async (request, context) => {
+    requireAuthHeader(request);
+    const { slug } = await context.params;
+    const registry = await getSingleRegistry();
+    let body;
+    try {
+      body = await request.json();
+    } catch {
+      throw NextlyError.validation({
+        errors: [
+          {
+            path: "",
+            code: "invalid_json",
+            message: "Request body is not valid JSON."
+          }
+        ]
+      });
+    }
+    const updateData = {};
+    if (body.label !== void 0) {
+      updateData.label = body.label;
+    }
+    if (body.description !== void 0) {
+      updateData.description = body.description;
+    }
+    if (body.fields !== void 0) {
+      updateData.fields = body.fields;
+      updateData.schemaHash = calculateSchemaHash(
+        body.fields
+      );
+    }
+    const ADMIN_KEYS = [
+      "icon",
+      "group",
+      "order",
+      "sidebarGroup",
+      "hidden"
+    ];
+    const adminOverrides = {};
+    if (body.admin !== void 0) {
+      const admin = body.admin;
+      for (const key of ADMIN_KEYS) {
+        if (admin[key] !== void 0) {
+          adminOverrides[key] = admin[key];
+        }
+      }
+    }
+    for (const key of ADMIN_KEYS) {
+      if (body[key] !== void 0) {
+        adminOverrides[key] = body[key];
+      }
+    }
+    if (Object.keys(adminOverrides).length > 0) {
+      const existing = await registry.getSingle(slug);
+      updateData.admin = {
+        ...existing.admin || {},
+        ...adminOverrides
+      };
+    }
+    if (body.accessRules !== void 0) {
+      updateData.accessRules = body.accessRules;
+    }
+    const updated = await registry.updateSingle(slug, updateData, {
+      source: "ui"
+    });
+    return respondMutation("Single schema updated.", updated);
+  }
+);
+var DELETE = withErrorHandler(
+  async (request, context) => {
+    requireAuthHeader(request);
+    const { slug } = await context.params;
+    const registry = await getSingleRegistry();
+    await registry.deleteSingle(slug, { force: true });
+    return new Response(null, { status: 204 });
+  }
+);
+export {
+  DELETE,
+  GET,
+  PATCH
+};

package/dist/api/singles.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Singles API Route Handlers for Next.js
+ *
+ * These route handlers can be re-exported in your Next.js application to provide
+ * Singles listing endpoints at /api/singles.
+ *
+ * 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/route.ts
+ * export { GET } from 'nextly/api/singles';
+ * ```
+ *
+ * @module api/singles
+ */
+/**
+ * GET handler for listing Singles with pagination and filters.
+ *
+ * Query Parameters:
+ * - source: Filter by source type ("code" | "ui" | "built-in")
+ * - search: Search query for slug and labels
+ * - limit: Maximum results (default: 50, becomes `meta.limit` in response)
+ * - offset: Number of results to skip (default: 0, derives `page` in meta)
+ *
+ * Response:
+ * - 200 OK: `{ "items": [...], "meta": { total, page, limit, totalPages, hasNext, hasPrev } }`
+ * - On error: `application/problem+json` per spec §10.1.
+ */
+declare const GET: (request: Request) => Promise<Response>;
+
+export { GET };

package/dist/api/singles.mjs

@@ -0,0 +1,94 @@
+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 "../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 {
+  respondList
+} from "../chunk-IUDOC7N7.mjs";
+import "../chunk-LAZXX4HR.mjs";
+import "../chunk-D5HQBNUB.mjs";
+import "../chunk-NRUWQ5Z7.mjs";
+import "../chunk-VTJADRO3.mjs";
+import "../chunk-5APFUGAD.mjs";
+import "../chunk-7P6ASYW6.mjs";
+
+// src/api/singles.ts
+async function getSingleRegistry() {
+  await getCachedNextly();
+  return getService("singleRegistryService");
+}
+var GET = withErrorHandler(
+  async (request) => {
+    const registry = await getSingleRegistry();
+    const { searchParams } = new URL(request.url);
+    const source = searchParams.get("source");
+    const search = searchParams.get("search") || void 0;
+    const limit = searchParams.get("limit") ? parseInt(searchParams.get("limit"), 10) : 50;
+    const offset = searchParams.get("offset") ? parseInt(searchParams.get("offset"), 10) : 0;
+    const result = await registry.listSingles({
+      source: source || void 0,
+      search,
+      limit,
+      offset
+    });
+    const safeLimit = Math.max(1, limit);
+    const page = Math.floor(offset / safeLimit) + 1;
+    const totalPages = Math.ceil(result.total / safeLimit);
+    return withTimezoneFormatting(
+      respondList(result.data, {
+        total: result.total,
+        page,
+        limit: safeLimit,
+        totalPages,
+        hasNext: page < totalPages,
+        hasPrev: page > 1
+      })
+    );
+  }
+);
+export {
+  GET
+};

package/dist/api/storage-upload-url.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Storage Upload URL API Route Handler
+ *
+ * Provides an endpoint for generating pre-signed URLs for client-side uploads.
+ * This allows direct-to-storage uploads that bypass serverless platform limits
+ * (e.g., Vercel's 4.5MB request body limit).
+ *
+ * Only available when:
+ * 1. A storage plugin (S3, etc.) is configured for the collection
+ * 2. The collection has `clientUploads: true` in its config
+ * 3. The storage adapter supports pre-signed upload URLs
+ *
+ * @example
+ * ```typescript
+ * // In your Next.js app: app/api/nextly/storage/upload-url/route.ts
+ * export { POST } from 'nextly/api/storage-upload-url';
+ * ```
+ *
+ * Adapter-specific failures (no plugin, `clientUploads` not enabled,
+ * Vercel-Blob `handleUpload` style adapters) collapse to canonical
+ * `NextlyError.validation` shapes; per spec §13.8 the public messages
+ * carry no collection-slug identifier and the slug lives in `logContext`.
+ *
+ * @module api/storage-upload-url
+ */
+/**
+ * POST handler for generating client upload URLs.
+ *
+ * Path: /api/nextly/storage/upload-url
+ *
+ * Request Body (JSON):
+ * - filename: string - Original filename
+ * - mimeType: string - File MIME type
+ * - collection: string - Collection slug
+ * - expiresIn?: number - Optional URL expiry in seconds
+ *
+ * Response Codes:
+ * - 200 OK: Upload URL generated successfully
+ * - 400 Bad Request: Invalid input or client uploads not enabled
+ * - 500 Internal Server Error: URL generation failed
+ *
+ * Response: bare `ClientUploadData` (respondData); see the
+ * `ClientUploadData` type for the field shape (`uploadUrl`, `path`,
+ * `method`, `headers`, `expiresAt`).
+ */
+declare const POST: (request: Request) => Promise<Response>;
+
+export { POST };

package/dist/api/storage-upload-url.mjs

@@ -0,0 +1,202 @@
+import {
+  nextlyValidationFromZod
+} from "../chunk-GJNSJU4S.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 "../chunk-X7TXCYYN.mjs";
+import "../chunk-YZNBLFIW.mjs";
+import "../chunk-FQULBZ53.mjs";
+import "../chunk-67GXH6PR.mjs";
+import "../chunk-2TFX4ND3.mjs";
+import "../chunk-W4MGXIRR.mjs";
+import "../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 "../chunk-2W3DVD7S.mjs";
+import "../chunk-TS7GHTG2.mjs";
+import "../chunk-H26B4FYG.mjs";
+import "../chunk-DP3G27G5.mjs";
+import "../chunk-DV6WVX2Q.mjs";
+import "../chunk-UJ2IMJ4W.mjs";
+import {
+  getMediaStorage
+} from "../chunk-EGXBZCGC.mjs";
+import "../chunk-G2AA4QLC.mjs";
+import "../chunk-4MJLT6PZ.mjs";
+import {
+  respondData
+} 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/storage-upload-url.ts
+import { z } from "zod";
+async function ensureServicesInitialized() {
+  await getCachedNextly();
+}
+var uploadUrlRequestSchema = z.object({
+  filename: z.string().min(1, "filename is required"),
+  mimeType: z.string().min(1, "mimeType is required"),
+  collection: z.string().min(1, "collection is required"),
+  expiresIn: z.number().int().positive().optional()
+});
+var POST = withErrorHandler(
+  async (request) => {
+    await ensureServicesInitialized();
+    let raw;
+    try {
+      raw = await request.json();
+    } catch {
+      throw new NextlyError({
+        code: "VALIDATION_ERROR",
+        publicMessage: "Validation failed.",
+        publicData: {
+          errors: [
+            {
+              path: "",
+              code: "invalid_json",
+              message: "Request body is not valid JSON."
+            }
+          ]
+        },
+        logContext: { reason: "invalid-json-body" }
+      });
+    }
+    let validated;
+    try {
+      validated = uploadUrlRequestSchema.parse(raw);
+    } catch (err) {
+      if (err instanceof z.ZodError) throw nextlyValidationFromZod(err);
+      throw err;
+    }
+    const { filename, mimeType, collection } = validated;
+    const storage = getMediaStorage();
+    if (!storage.supportsClientUploads(collection)) {
+      const config = storage.getCollectionConfig(collection);
+      const adapter = storage.getAdapterForCollection(collection);
+      const adapterInfo = adapter.getInfo?.();
+      const baseLogContext = {
+        collection,
+        adapterType: adapterInfo?.type
+      };
+      if (!config) {
+        throw NextlyError.validation({
+          errors: [
+            {
+              path: "collection",
+              code: "STORAGE_NOT_CONFIGURED",
+              message: "This collection is not configured with a storage plugin."
+            }
+          ],
+          logContext: { ...baseLogContext, reason: "no-storage-plugin" }
+        });
+      }
+      if (!config.clientUploads) {
+        throw NextlyError.validation({
+          errors: [
+            {
+              path: "collection",
+              code: "CLIENT_UPLOADS_DISABLED",
+              message: "Client uploads are not enabled for this collection."
+            }
+          ],
+          logContext: {
+            ...baseLogContext,
+            reason: "clientUploads-not-enabled"
+          }
+        });
+      }
+      if (!adapterInfo?.supportsClientUploads) {
+        throw NextlyError.validation({
+          errors: [
+            {
+              path: "collection",
+              code: "ADAPTER_UNSUPPORTED",
+              message: "The configured storage adapter does not support client uploads."
+            }
+          ],
+          logContext: {
+            ...baseLogContext,
+            reason: "adapter-unsupported"
+          }
+        });
+      }
+      throw NextlyError.validation({
+        errors: [
+          {
+            path: "collection",
+            code: "CLIENT_UPLOADS_DISABLED",
+            message: "Client uploads are not enabled for this collection."
+          }
+        ],
+        logContext: { ...baseLogContext, reason: "unknown" }
+      });
+    }
+    let uploadData;
+    try {
+      uploadData = await storage.getClientUploadUrl(
+        filename,
+        mimeType,
+        collection
+      );
+    } catch (err) {
+      if (err instanceof Error && err.message.toLowerCase().includes("handleupload")) {
+        throw NextlyError.validation({
+          errors: [
+            {
+              path: "collection",
+              code: "ADAPTER_UNSUPPORTED",
+              message: "This storage provider does not support pre-signed upload URLs. Use the standard upload endpoint instead."
+            }
+          ],
+          logContext: {
+            collection,
+            reason: "adapter-no-presigned-urls",
+            cause: err.message
+          }
+        });
+      }
+      throw err;
+    }
+    if (!uploadData) {
+      throw NextlyError.internal({
+        logContext: {
+          collection,
+          reason: "presigned-url-generation-returned-null"
+        }
+      });
+    }
+    return respondData(uploadData);
+  }
+);
+export {
+  POST
+};

package/dist/api/uploads.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Upload API Route Handlers for Next.js
+ *
+ * These route handlers provide collection-specific upload endpoints for the
+ * Nextly admin panel. They can be re-exported in your Next.js application
+ * to provide file upload functionality at /admin/api/collections/[slug]/uploads.
+ *
+ * Unlike the global Media API (/api/media), these endpoints are designed for
+ * collection upload fields where files belong to specific collections.
+ *
+ * **IMPORTANT:** For storage plugins to work, initialize Nextly with your config
+ * via instrumentation.ts before these routes are called.
+ *
+ * @example
+ * ```typescript
+ * // In your Next.js app: app/admin/api/collections/[slug]/uploads/route.ts
+ * export { POST, GET as LIST } from 'nextly/api/uploads';
+ *
+ * // In your Next.js app: app/admin/api/collections/[slug]/uploads/[id]/route.ts
+ * export { GET, DELETE } from 'nextly/api/uploads';
+ * ```
+ *
+ * Endpoints:
+ * - POST /admin/api/collections/[slug]/uploads - Upload file to collection
+ * - GET /admin/api/collections/[slug]/uploads - List uploads for collection
+ * - GET /admin/api/collections/[slug]/uploads/[id] - Get upload metadata
+ * - DELETE /admin/api/collections/[slug]/uploads/[id] - Delete upload
+ *
+ * `UploadServiceResult` (a result-shape, not a throw) is unwrapped via
+ * `throwFromUploadResult`: 404 to `NextlyError.notFound`, 400 to
+ * `NextlyError.validation` with field-level errors, 503 to
+ * `NextlyError.serviceUnavailable`, anything else to `NextlyError.internal`.
+ *
+ * @module api/uploads
+ */
+/** Re-exported for tests that exercise the singleton lifecycle. */
+declare function resetUploadService(): void;
+/**
+ * POST handler for uploading files to a collection.
+ *
+ * Path: /admin/api/collections/[slug]/uploads
+ *
+ * Accepts multipart/form-data with:
+ * - file: File to upload (required)
+ * - _payload: JSON string with additional data (optional)
+ *
+ * Response Codes:
+ * - 201 Created: File uploaded successfully
+ * - 400 Bad Request: Invalid input or missing file
+ * - 401 Unauthorized: Not authenticated
+ * - 500 Internal Server Error: Upload failed
+ *
+ * Response: `{ message, item: UploadResult }` (respondMutation, status 201)
+ * post-processed through `withTimezoneFormatting`.
+ */
+declare const POST: (request: Request, context: {
+    params: Promise<{
+        slug?: string;
+    }>;
+}) => Promise<Response>;
+/**
+ * GET handler — dual-purpose: with `id` returns metadata for a single
+ * upload; without `id` returns the (currently empty) collection list.
+ *
+ * Path: /admin/api/collections/[slug]/uploads/[id]
+ *
+ * Response Codes:
+ * - 200 OK: Metadata retrieved successfully
+ * - 400 Bad Request: Missing collection slug or upload ID
+ * - 404 Not Found: Upload not found
+ * - 500 Internal Server Error: Failed to get metadata
+ *
+ * Response: bare `UploadMetadata` (respondDoc) for single; for list see
+ * `handleList` (paginated `respondList` shape).
+ */
+declare const GET: (request: Request, context: {
+    params: Promise<{
+        slug?: string;
+        id?: string;
+    }>;
+}) => Promise<Response>;
+/**
+ * DELETE handler for removing an upload.
+ *
+ * Path: /admin/api/collections/[slug]/uploads/[id]
+ *
+ * Response Codes:
+ * - 200 OK: Upload deleted successfully
+ * - 400 Bad Request: Missing collection slug or upload ID
+ * - 404 Not Found: Upload not found
+ * - 500 Internal Server Error: Deletion failed
+ *
+ * Response: `{ message, id }` (respondAction; storage delete returns void).
+ */
+declare const DELETE: (_request: Request, context: {
+    params: Promise<{
+        slug?: string;
+        id?: string;
+    }>;
+}) => Promise<Response>;
+/** Alias for GET when used for listing (semantic export). */
+declare const LIST: (request: Request, context: {
+    params: Promise<{
+        slug?: string;
+        id?: string;
+    }>;
+}) => Promise<Response>;
+
+export { DELETE, GET, LIST, POST, resetUploadService };