nextly 0.0.1 → 0.0.2-alpha.1

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

@@ -0,0 +1,50 @@
+/**
+ * Components Detail API Route Handlers for Next.js
+ *
+ * These route handlers can be re-exported in your Next.js application to provide
+ * individual component management endpoints at /api/components/[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/components/[slug]/route.ts
+ * export { GET, PATCH, DELETE } from 'nextly/api/components-detail';
+ * ```
+ *
+ * @module api/components-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 component by slug.
+ *
+ * Requires authentication.
+ */
+declare const GET: (request: Request, context: RouteContext) => Promise<Response>;
+/**
+ * PATCH handler for updating a component.
+ *
+ * Requires authentication. The registry returns 403 (mapped to LOCKED in
+ * `logContext`) if the component is locked (code-first components cannot be
+ * modified via API).
+ */
+declare const PATCH: (request: Request, context: RouteContext) => Promise<Response>;
+/**
+ * DELETE handler for removing a component.
+ *
+ * Requires authentication. The registry returns 403 if the component is
+ * locked, or 409 if it is referenced by other entities.
+ */
+declare const DELETE: (request: Request, context: RouteContext) => Promise<Response>;
+
+export { DELETE, GET, PATCH };

package/dist/api/components-detail.mjs

@@ -0,0 +1,132 @@
+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 "../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/components-detail.ts
+async function getComponentRegistry() {
+  await getCachedNextly();
+  return getService("componentRegistryService");
+}
+var GET = withErrorHandler(
+  async (request, context) => {
+    requireAuthHeader(request);
+    const { slug } = await context.params;
+    const registry = await getComponentRegistry();
+    const component = await registry.getComponent(slug);
+    return respondDoc(component);
+  }
+);
+var PATCH = withErrorHandler(
+  async (request, context) => {
+    requireAuthHeader(request);
+    const { slug } = await context.params;
+    const registry = await getComponentRegistry();
+    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
+      );
+    }
+    if (body.admin !== void 0) {
+      updateData.admin = body.admin;
+    }
+    const updated = await registry.updateComponent(slug, updateData, {
+      source: "ui"
+    });
+    return respondMutation("Component updated.", updated);
+  }
+);
+var DELETE = withErrorHandler(
+  async (request, context) => {
+    requireAuthHeader(request);
+    const { slug } = await context.params;
+    const registry = await getComponentRegistry();
+    await registry.deleteComponent(slug);
+    return new Response(null, { status: 204 });
+  }
+);
+export {
+  DELETE,
+  GET,
+  PATCH
+};

package/dist/api/components.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Components API Route Handlers for Next.js
+ *
+ * These route handlers can be re-exported in your Next.js application to provide
+ * component definition management endpoints at /api/components.
+ *
+ * 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/components/route.ts
+ * export { GET, POST } from 'nextly/api/components';
+ * ```
+ *
+ * @module api/components
+ */
+/**
+ * GET handler for listing components with pagination and filters.
+ *
+ * This is a public endpoint - no authentication required.
+ * Used by Admin UI to load component list for navigation.
+ *
+ * Query Parameters:
+ * - source: Filter by source type ("code" | "ui")
+ * - search: Search query for slug and label
+ * - limit: Maximum results (default: 50)
+ * - offset: Number of results to skip (default: 0)
+ *
+ * Response Codes:
+ * - 200 OK: Components list retrieved successfully
+ * - 500 Internal Server Error: Failed to fetch components
+ *
+ * @param request - Next.js Request object
+ * @returns Response with JSON component list and pagination meta
+ *
+ * @example
+ * ```bash
+ * curl "http://localhost:3000/api/components?source=ui&limit=10"
+ * # => {"items":[...],"meta":{"total":5,"page":1,"limit":10,"totalPages":1,"hasNext":false,"hasPrev":false}}
+ * ```
+ */
+declare const GET: (request: Request) => Promise<Response>;
+/**
+ * POST handler for creating a new UI component.
+ *
+ * Requires authentication. Creates a new component with source="ui" and locked=false.
+ *
+ * Request Body:
+ * - slug: Unique identifier (lowercase, letters/numbers/hyphens)
+ * - label: Display name for the component
+ * - description: Optional description
+ * - fields: Array of field configurations
+ * - admin: Optional admin UI configuration (category, icon, hidden, description, imageURL)
+ *
+ * Response Codes:
+ * - 201 Created: Component created successfully
+ * - 400 Bad Request: Invalid input
+ * - 401 Unauthorized: Authentication required
+ * - 409 Conflict: Component with slug already exists
+ * - 500 Internal Server Error: Creation failed
+ *
+ * @param request - Next.js Request object with JSON body
+ * @returns Response with JSON created component
+ */
+declare const POST: (request: Request) => Promise<Response>;
+
+export { GET, POST };

package/dist/api/components.mjs

@@ -0,0 +1,144 @@
+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 {
+  clampLimit2 as clampLimit
+} 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 {
+  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 {
+  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/components.ts
+import { z } from "zod";
+async function getComponentRegistry() {
+  await getCachedNextly();
+  return getService("componentRegistryService");
+}
+var createComponentSchema = z.object({
+  slug: z.string().min(1, "Slug is required").max(255, "Slug must be 255 characters or less").regex(
+    /^[a-z][a-z0-9-]*$/,
+    "Slug must start with a letter and contain only lowercase letters, numbers, and hyphens"
+  ),
+  label: z.string().min(1, "Label is required"),
+  description: z.string().optional(),
+  fields: z.array(z.any()),
+  // Field validation is complex, handled by service
+  admin: z.object({
+    category: z.string().optional(),
+    icon: z.string().optional(),
+    hidden: z.boolean().optional(),
+    description: z.string().optional(),
+    imageURL: z.string().optional()
+  }).optional()
+});
+var GET = withErrorHandler(async (request) => {
+  const registry = await getComponentRegistry();
+  const { searchParams } = new URL(request.url);
+  const source = searchParams.get("source");
+  const search = searchParams.get("search") || void 0;
+  const limit = clampLimit(searchParams.get("limit"), { defaultLimit: 50 });
+  const offset = searchParams.get("offset") ? parseInt(searchParams.get("offset"), 10) : 0;
+  const result = await registry.listComponents({
+    source: source || void 0,
+    search,
+    limit,
+    offset
+  });
+  const safeLimit = Math.max(1, limit);
+  const page = Math.floor(offset / safeLimit) + 1;
+  const totalPages = result.total > 0 ? Math.ceil(result.total / safeLimit) : 0;
+  return respondList(result.data, {
+    total: result.total,
+    page,
+    limit: safeLimit,
+    totalPages,
+    hasNext: page < totalPages,
+    hasPrev: page > 1
+  });
+});
+var POST = withErrorHandler(async (request) => {
+  const authHeader = request.headers.get("Authorization");
+  if (!authHeader) {
+    throw NextlyError.authRequired();
+  }
+  const registry = await getComponentRegistry();
+  const body = await request.json();
+  const parsed = createComponentSchema.safeParse(body);
+  if (!parsed.success) {
+    throw nextlyValidationFromZod(parsed.error);
+  }
+  const validated = parsed.data;
+  const tableName = validated.slug.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+  const schemaHash = calculateSchemaHash(validated.fields);
+  const component = await registry.registerComponent({
+    slug: validated.slug,
+    label: validated.label,
+    tableName,
+    description: validated.description,
+    fields: validated.fields,
+    admin: validated.admin,
+    source: "ui",
+    locked: false,
+    schemaHash
+  });
+  return respondMutation("Component created.", component, { status: 201 });
+});
+export {
+  GET,
+  POST
+};

package/dist/api/email-providers-default.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Email Provider Default API Route Handler for Next.js
+ *
+ * Sets a specific email provider as the default. The previous default
+ * provider is unset atomically in a transaction.
+ * Re-export in your Next.js application at /api/email-providers/[id]/default.
+ *
+ * @example
+ * ```typescript
+ * // In your Next.js app: app/api/email-providers/[id]/default/route.ts
+ * export { PATCH } from 'nextly/api/email-providers-default';
+ * ```
+ *
+ * @module api/email-providers-default
+ */
+interface RouteContext {
+    params: Promise<{
+        id: string;
+    }>;
+}
+/**
+ * PATCH handler for setting an email provider as the default.
+ *
+ * Requires authentication. Unsets the previous default provider and sets
+ * the specified provider as default in a single transaction.
+ *
+ * No request body required; the provider ID is in the URL path.
+ *
+ * Response Codes:
+ * - 200 OK: Provider set as default successfully
+ * - 401 Unauthorized: Authentication required
+ * - 404 Not Found: Provider with ID does not exist
+ * - 500 Internal Server Error: Operation failed
+ *
+ * Response: `{ "data": EmailProvider }`; updated provider with `isDefault:
+ * true` and masked configuration.
+ */
+declare const PATCH: (request: Request, context: RouteContext) => Promise<Response>;
+
+export { PATCH };

package/dist/api/email-providers-default.mjs

@@ -0,0 +1,75 @@
+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 "../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 "../chunk-EGXBZCGC.mjs";
+import "../chunk-G2AA4QLC.mjs";
+import "../chunk-4MJLT6PZ.mjs";
+import {
+  respondAction
+} from "../chunk-IUDOC7N7.mjs";
+import "../chunk-LAZXX4HR.mjs";
+import {
+  container
+} from "../chunk-D5HQBNUB.mjs";
+import "../chunk-NRUWQ5Z7.mjs";
+import "../chunk-VTJADRO3.mjs";
+import "../chunk-5APFUGAD.mjs";
+import "../chunk-7P6ASYW6.mjs";
+
+// src/api/email-providers-default.ts
+async function getEmailProviderService() {
+  await getCachedNextly();
+  return container.get("emailProviderService");
+}
+var PATCH = withErrorHandler(
+  async (request, context) => {
+    requireAuthHeader(request);
+    const { id } = await context.params;
+    const service = await getEmailProviderService();
+    const provider = await service.setDefault(id);
+    return respondAction("Default email provider updated.", { provider });
+  }
+);
+export {
+  PATCH
+};

package/dist/api/email-providers-detail.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Email Providers Detail API Route Handlers for Next.js
+ *
+ * These route handlers can be re-exported in your Next.js application to provide
+ * individual email provider management endpoints at /api/email-providers/[id].
+ *
+ * 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/email-providers/[id]/route.ts
+ * export { GET, PATCH, DELETE } from 'nextly/api/email-providers-detail';
+ * ```
+ *
+ * Auth is a header-only presence check; real verification lives downstream.
+ *
+ * @module api/email-providers-detail
+ */
+interface RouteContext {
+    params: Promise<{
+        id: string;
+    }>;
+}
+/**
+ * GET handler for retrieving a single email provider by ID.
+ *
+ * Requires authentication. Returns provider with masked configuration.
+ *
+ * Response Codes:
+ * - 200 OK: Provider retrieved successfully
+ * - 401 Unauthorized: Authentication required
+ * - 404 Not Found: Provider with ID does not exist
+ * - 500 Internal Server Error: Failed to fetch provider
+ *
+ * Response: `{ "data": EmailProvider }`
+ */
+declare const GET: (request: Request, context: RouteContext) => Promise<Response>;
+/**
+ * PATCH handler for updating an email provider.
+ *
+ * Requires authentication. Provider `type` cannot be changed after creation.
+ * Configuration is re-encrypted before storage.
+ *
+ * Request Body (all fields optional):
+ * - name: Display name
+ * - fromEmail: From email address
+ * - fromName: From display name
+ * - configuration: Provider-specific config object
+ * - isActive: Enable/disable provider
+ *
+ * Response Codes:
+ * - 200 OK: Provider updated successfully
+ * - 400 Bad Request: Invalid JSON body
+ * - 401 Unauthorized: Authentication required
+ * - 404 Not Found: Provider with ID does not exist
+ * - 500 Internal Server Error: Update failed
+ *
+ * Response: `{ "data": EmailProvider }`; updated provider with masked
+ * configuration.
+ */
+declare const PATCH: (request: Request, context: RouteContext) => Promise<Response>;
+/**
+ * DELETE handler for removing an email provider.
+ *
+ * Requires authentication. Cannot delete the default provider; set another
+ * provider as default first.
+ *
+ * Response Codes:
+ * - 200 OK: Provider deleted successfully
+ * - 401 Unauthorized: Authentication required
+ * - 403 Forbidden: Cannot delete the default provider
+ * - 404 Not Found: Provider with ID does not exist
+ * - 500 Internal Server Error: Deletion failed
+ *
+ * Response: `{ "data": { "success": true } }`
+ */
+declare const DELETE: (request: Request, context: RouteContext) => Promise<Response>;
+
+export { DELETE, GET, PATCH };