nextly 0.0.1 → 0.0.2-alpha.1

package/dist/migrations/postgresql/meta/_journal.json

@@ -0,0 +1,90 @@
+{
+  "version": "7",
+  "dialect": "postgresql",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "7",
+      "when": 1761054746880,
+      "tag": "0000_misty_king_bedlam",
+      "breakpoints": true
+    },
+    {
+      "idx": 1,
+      "version": "7",
+      "when": 1762593297791,
+      "tag": "0001_perpetual_captain_marvel",
+      "breakpoints": true
+    },
+    {
+      "idx": 2,
+      "version": "7",
+      "when": 1763190619818,
+      "tag": "0002_sad_spectrum",
+      "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "7",
+      "when": 1763206212898,
+      "tag": "0003_hesitant_ultron",
+      "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "7",
+      "when": 1763298000000,
+      "tag": "0004_media_table",
+      "breakpoints": true
+    },
+    {
+      "idx": 5,
+      "version": "7",
+      "when": 1764591695874,
+      "tag": "0005_media_folders",
+      "breakpoints": true
+    },
+    {
+      "idx": 6,
+      "version": "7",
+      "when": 1764600000000,
+      "tag": "0006_dynamic_collections_update",
+      "breakpoints": true
+    },
+    {
+      "idx": 7,
+      "version": "7",
+      "when": 1764700000000,
+      "tag": "0007_dynamic_singles",
+      "breakpoints": true
+    },
+    {
+      "idx": 8,
+      "version": "7",
+      "when": 1764800000000,
+      "tag": "0008_dynamic_components",
+      "breakpoints": true
+    },
+    {
+      "idx": 9,
+      "version": "7",
+      "when": 1764900000000,
+      "tag": "0009_user_management_tables",
+      "breakpoints": true
+    },
+    {
+      "idx": 10,
+      "version": "7",
+      "when": 1771408301715,
+      "tag": "0010_api_keys",
+      "breakpoints": true
+    },
+    {
+      "idx": 11,
+      "version": "7",
+      "when": 1741190400000,
+      "tag": "0013_activity_log",
+      "breakpoints": true
+    }
+  ]
+}

package/dist/migrations/sqlite/0000_api_keys.sql

@@ -0,0 +1,34 @@
+-- Migration: Create api_keys table for API Key Authentication (Plan 14)
+-- This migration creates the api_keys table required for programmatic API access
+-- using long-lived secret keys with SHA-256 hashed storage.
+
+-- UP
+
+CREATE TABLE IF NOT EXISTS "api_keys" (
+	"id" text PRIMARY KEY NOT NULL,
+	"name" text NOT NULL,
+	"description" text,
+	"key_hash" text NOT NULL,
+	"key_prefix" text NOT NULL,
+	"token_type" text NOT NULL,
+	"role_id" text REFERENCES "roles"("id") ON DELETE SET NULL,
+	"user_id" text NOT NULL REFERENCES "users"("id") ON DELETE CASCADE,
+	"expires_at" integer,
+	"last_used_at" integer,
+	"is_active" integer NOT NULL DEFAULT 1,
+	"created_at" integer NOT NULL,
+	"updated_at" integer NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS "api_keys_key_hash_unique" ON "api_keys" ("key_hash");
+CREATE INDEX IF NOT EXISTS "api_keys_user_id_idx" ON "api_keys" ("user_id");
+CREATE INDEX IF NOT EXISTS "api_keys_role_id_idx" ON "api_keys" ("role_id");
+CREATE INDEX IF NOT EXISTS "api_keys_is_active_expires_at_idx" ON "api_keys" ("is_active", "expires_at");
+
+-- DOWN
+
+DROP INDEX IF EXISTS "api_keys_is_active_expires_at_idx";
+DROP INDEX IF EXISTS "api_keys_role_id_idx";
+DROP INDEX IF EXISTS "api_keys_user_id_idx";
+DROP INDEX IF EXISTS "api_keys_key_hash_unique";
+DROP TABLE IF EXISTS "api_keys";

package/dist/migrations/sqlite/0001_general_settings.sql

@@ -0,0 +1,20 @@
+-- Migration: Create site_settings table for general application settings
+-- This migration creates the site_settings singleton table.
+-- Only one row ever exists with id = 'default'.
+
+-- UP
+
+CREATE TABLE IF NOT EXISTS "site_settings" (
+	"id" text PRIMARY KEY NOT NULL,
+	"application_name" text,
+	"site_url" text,
+	"admin_email" text,
+	"timezone" text,
+	"date_format" text,
+	"time_format" text,
+	"updated_at" integer NOT NULL
+);
+
+-- DOWN
+
+DROP TABLE IF EXISTS "site_settings";

package/dist/migrations/sqlite/0002_site_settings_logo_url.sql

@@ -0,0 +1,9 @@
+-- Migration: Add logo_url column to site_settings
+
+-- UP
+
+ALTER TABLE "site_settings" ADD COLUMN "logo_url" text;
+
+-- DOWN
+
+-- SQLite does not support DROP COLUMN in older versions; handled via table recreation if needed.

package/dist/migrations/sqlite/0003_activity_log.sql

@@ -0,0 +1,29 @@
+-- Migration: Create activity_log table for Dashboard Activity Feed (Plan 16)
+-- This migration creates the activity_log table that records create/update/delete
+-- actions across all collections for the dashboard activity feed.
+
+-- UP
+
+CREATE TABLE IF NOT EXISTS "activity_log" (
+	"id" text PRIMARY KEY NOT NULL,
+	"user_id" text NOT NULL REFERENCES "users"("id") ON DELETE CASCADE,
+	"user_name" text NOT NULL,
+	"user_email" text NOT NULL,
+	"action" text NOT NULL,
+	"collection" text NOT NULL,
+	"entry_id" text,
+	"entry_title" text,
+	"metadata" text,
+	"created_at" integer NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS "idx_activity_log_created_at" ON "activity_log" ("created_at");
+CREATE INDEX IF NOT EXISTS "idx_activity_log_collection" ON "activity_log" ("collection", "created_at");
+CREATE INDEX IF NOT EXISTS "idx_activity_log_user_id" ON "activity_log" ("user_id", "created_at");
+
+-- DOWN
+
+DROP INDEX IF EXISTS "idx_activity_log_user_id";
+DROP INDEX IF EXISTS "idx_activity_log_collection";
+DROP INDEX IF EXISTS "idx_activity_log_created_at";
+DROP TABLE IF EXISTS "activity_log";

package/dist/migrations/sqlite/0004_image_sizes_and_focal_point.sql

@@ -0,0 +1,29 @@
+-- Migration: Add image_sizes table and focal point / sizes columns to media (SQLite)
+
+-- UP
+
+CREATE TABLE IF NOT EXISTS "image_sizes" (
+	"id" text PRIMARY KEY NOT NULL,
+	"name" text NOT NULL,
+	"width" integer,
+	"height" integer,
+	"fit" text NOT NULL DEFAULT 'inside',
+	"quality" integer NOT NULL DEFAULT 80,
+	"format" text NOT NULL DEFAULT 'auto',
+	"is_default" integer NOT NULL DEFAULT 1,
+	"sort_order" integer NOT NULL DEFAULT 0,
+	"created_at" integer NOT NULL,
+	"updated_at" integer NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS "image_sizes_name_unique" ON "image_sizes" ("name");
+
+ALTER TABLE "media" ADD COLUMN "focal_x" integer;
+ALTER TABLE "media" ADD COLUMN "focal_y" integer;
+ALTER TABLE "media" ADD COLUMN "sizes" text;
+
+-- DOWN
+
+-- SQLite does not support DROP COLUMN before 3.35.0
+-- For older versions, recreate the table without the columns
+DROP TABLE IF EXISTS "image_sizes";

package/dist/migrations/sqlite/0004_site_settings_sidebar.sql

@@ -0,0 +1,11 @@
+-- Migration: Add sidebar customization columns to site_settings
+
+-- UP
+
+ALTER TABLE "site_settings" ADD COLUMN "logo_url_dark" text;
+ALTER TABLE "site_settings" ADD COLUMN "custom_sidebar_groups" text;
+ALTER TABLE "site_settings" ADD COLUMN "plugin_placements" text;
+
+-- DOWN
+
+-- SQLite does not support DROP COLUMN in older versions; handled via table recreation if needed.

package/dist/migrations/sqlite/0005_user_brute_force_protection.sql

@@ -0,0 +1,29 @@
+-- Migration: Custom auth schema additions
+-- Adds brute-force protection columns to users and creates refresh_tokens table.
+-- These were added to the Drizzle schema when custom JWT auth replaced Auth.js
+-- but never got corresponding migration SQL.
+
+-- UP
+
+ALTER TABLE `users` ADD COLUMN `failed_login_attempts` integer NOT NULL DEFAULT 0;
+ALTER TABLE `users` ADD COLUMN `locked_until` integer;
+
+CREATE TABLE IF NOT EXISTS `refresh_tokens` (
+  `id` text PRIMARY KEY NOT NULL,
+  `user_id` text NOT NULL REFERENCES `users`(`id`) ON DELETE CASCADE,
+  `token_hash` text NOT NULL,
+  `user_agent` text,
+  `ip_address` text,
+  `expires_at` integer NOT NULL,
+  `created_at` integer NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS `refresh_tokens_token_hash_idx` ON `refresh_tokens` (`token_hash`);
+CREATE INDEX IF NOT EXISTS `refresh_tokens_user_id_idx` ON `refresh_tokens` (`user_id`);
+CREATE INDEX IF NOT EXISTS `refresh_tokens_expires_at_idx` ON `refresh_tokens` (`expires_at`);
+
+-- DOWN
+
+DROP TABLE IF EXISTS `refresh_tokens`;
+ALTER TABLE `users` DROP COLUMN `locked_until`;
+ALTER TABLE `users` DROP COLUMN `failed_login_attempts`;

package/dist/migrations/sqlite/0006_email_template_attachments.sql

@@ -0,0 +1,12 @@
+-- Migration: Email template default attachments
+-- Adds a nullable `attachments` TEXT column (JSON-serialized) to
+-- email_templates so that templates can carry default media-library
+-- attachments that are merged with per-send attachments at send time.
+
+-- UP
+
+ALTER TABLE `email_templates` ADD COLUMN `attachments` text;
+
+-- DOWN
+
+ALTER TABLE `email_templates` DROP COLUMN `attachments`;

package/dist/migrations/sqlite/0007_media_uploaded_by_nullable.sql

@@ -0,0 +1,111 @@
+-- Migration: Make media.uploaded_by nullable
+-- CLI seeds, data imports, and other system-context uploads may not have a
+-- user to attribute the upload to. Dropping NOT NULL lets these operations
+-- record media without a synthetic "anonymous" user sentinel (which doesn't
+-- exist as a row and broke the foreign-key constraint).
+
+-- UP
+-- SQLite doesn't support ALTER COLUMN to change nullability, so rebuild the
+-- table. No FK targets media.id anywhere in core tables, so the rebuild
+-- doesn't need foreign_keys PRAGMA toggling (the adapter enables FKs at
+-- connect; the migration runner wraps this in a transaction and strips
+-- PRAGMA statements anyway).
+
+CREATE TABLE `media__new` (
+  `id` text PRIMARY KEY NOT NULL,
+  `filename` text NOT NULL,
+  `mime_type` text NOT NULL,
+  `size` integer NOT NULL,
+  `width` integer,
+  `height` integer,
+  `duration` integer,
+  `url` text NOT NULL,
+  `thumbnail_url` text,
+  `focal_x` integer,
+  `focal_y` integer,
+  `sizes` text,
+  `alt_text` text,
+  `caption` text,
+  `tags` text,
+  `folder_id` text REFERENCES `media_folders`(`id`) ON DELETE SET NULL,
+  `uploaded_by` text REFERENCES `users`(`id`) ON DELETE CASCADE,
+  `uploaded_at` integer NOT NULL DEFAULT (unixepoch()),
+  `updated_at` integer NOT NULL DEFAULT (unixepoch())
+);
+--> statement-breakpoint
+
+INSERT INTO `media__new`
+SELECT
+  `id`, `filename`, `mime_type`, `size`, `width`, `height`, `duration`,
+  `url`, `thumbnail_url`, `focal_x`, `focal_y`, `sizes`,
+  `alt_text`, `caption`, `tags`, `folder_id`, `uploaded_by`,
+  `uploaded_at`, `updated_at`
+FROM `media`;
+--> statement-breakpoint
+
+DROP TABLE `media`;
+--> statement-breakpoint
+
+ALTER TABLE `media__new` RENAME TO `media`;
+--> statement-breakpoint
+
+CREATE INDEX `media_uploaded_by_idx` ON `media` (`uploaded_by`);
+--> statement-breakpoint
+CREATE INDEX `media_mime_type_idx` ON `media` (`mime_type`);
+--> statement-breakpoint
+CREATE INDEX `media_uploaded_at_idx` ON `media` (`uploaded_at`);
+--> statement-breakpoint
+CREATE INDEX `media_folder_id_idx` ON `media` (`folder_id`);
+
+-- DOWN
+-- Reverse: re-add NOT NULL by rebuilding the table again.
+-- Rows with NULL uploaded_by are dropped (the WHERE filter) since a NOT NULL
+-- column cannot accept them; backfill the DB before running DOWN if retention
+-- matters.
+
+CREATE TABLE `media__old` (
+  `id` text PRIMARY KEY NOT NULL,
+  `filename` text NOT NULL,
+  `mime_type` text NOT NULL,
+  `size` integer NOT NULL,
+  `width` integer,
+  `height` integer,
+  `duration` integer,
+  `url` text NOT NULL,
+  `thumbnail_url` text,
+  `focal_x` integer,
+  `focal_y` integer,
+  `sizes` text,
+  `alt_text` text,
+  `caption` text,
+  `tags` text,
+  `folder_id` text REFERENCES `media_folders`(`id`) ON DELETE SET NULL,
+  `uploaded_by` text NOT NULL REFERENCES `users`(`id`) ON DELETE CASCADE,
+  `uploaded_at` integer NOT NULL DEFAULT (unixepoch()),
+  `updated_at` integer NOT NULL DEFAULT (unixepoch())
+);
+--> statement-breakpoint
+
+INSERT INTO `media__old`
+SELECT
+  `id`, `filename`, `mime_type`, `size`, `width`, `height`, `duration`,
+  `url`, `thumbnail_url`, `focal_x`, `focal_y`, `sizes`,
+  `alt_text`, `caption`, `tags`, `folder_id`, `uploaded_by`,
+  `uploaded_at`, `updated_at`
+FROM `media`
+WHERE `uploaded_by` IS NOT NULL;
+--> statement-breakpoint
+
+DROP TABLE `media`;
+--> statement-breakpoint
+
+ALTER TABLE `media__old` RENAME TO `media`;
+--> statement-breakpoint
+
+CREATE INDEX `media_uploaded_by_idx` ON `media` (`uploaded_by`);
+--> statement-breakpoint
+CREATE INDEX `media_mime_type_idx` ON `media` (`mime_type`);
+--> statement-breakpoint
+CREATE INDEX `media_uploaded_at_idx` ON `media` (`uploaded_at`);
+--> statement-breakpoint
+CREATE INDEX `media_folder_id_idx` ON `media` (`folder_id`);

package/dist/migrations/sqlite/20260429_000000_000_initial_journal.sql

@@ -0,0 +1,24 @@
+-- Migration: initial_journal
+-- Generated at: 2026-04-29T00:00:00.000Z
+-- Dialect: SQLite
+-- Source: F11 (file-based migration ledger). Bundled with the nextly package
+-- so fresh production databases get the table on first `nextly migrate`.
+-- Synthetic 000000_000 time component so this bundled file sorts BEFORE
+-- any user-generated migration created on the same date.
+
+-- UP
+
+CREATE TABLE IF NOT EXISTS "nextly_migrations" (
+  "id"           TEXT PRIMARY KEY,
+  "filename"     TEXT NOT NULL UNIQUE,
+  "sha256"       TEXT NOT NULL,
+  "applied_at"   INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "applied_by"   TEXT,
+  "duration_ms"  INTEGER,
+  "status"       TEXT NOT NULL CHECK ("status" IN ('applied', 'failed')),
+  "error_json"   TEXT,
+  "rollback_sql" TEXT
+);
+
+CREATE INDEX IF NOT EXISTS "nextly_migrations_applied_at_idx"
+  ON "nextly_migrations" ("applied_at");

package/dist/migrations/sqlite/20260501_000000_journal_batch.sql

@@ -0,0 +1,19 @@
+-- Migration: journal_batch
+-- Generated at: 2026-05-01T00:00:00.000Z
+-- Dialect: SQLite
+-- Source: Phase 5 (Task 24). Adds the `batch` sentinel column to
+-- nextly_migration_journal so audit queries can distinguish HMR/dev
+-- pushes (batch < 0) from production migrations (batch >= 0). The
+-- pipeline sets -1 for source="code" and leaves the default 0 for
+-- everything else. Synthetic 000000_000 time component sorts this
+-- file before any user-generated migration on the same date.
+
+-- UP
+
+ALTER TABLE "nextly_migration_journal" ADD COLUMN "batch" INTEGER NOT NULL DEFAULT 0;
+
+-- DOWN
+
+-- Note: SQLite supports DROP COLUMN since 3.35.0 (Mar 2021). F17
+-- minimum is 3.38, so this is safe.
+ALTER TABLE "nextly_migration_journal" DROP COLUMN "batch";

package/dist/migrations/sqlite/20260501_000001_audit_log.sql

@@ -0,0 +1,24 @@
+-- Append-only event store for security-sensitive auth events.
+-- See packages/nextly/src/domains/audit/ for the writer service.
+
+-- UP
+
+CREATE TABLE IF NOT EXISTS `audit_log` (
+  `id` text PRIMARY KEY NOT NULL,
+  `kind` text NOT NULL,
+  `actor_user_id` text,
+  `target_user_id` text,
+  `ip_address` text,
+  `user_agent` text,
+  `metadata` text,
+  `created_at` integer NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS `audit_log_kind_idx` ON `audit_log` (`kind`);
+CREATE INDEX IF NOT EXISTS `audit_log_actor_user_id_idx` ON `audit_log` (`actor_user_id`);
+CREATE INDEX IF NOT EXISTS `audit_log_target_user_id_idx` ON `audit_log` (`target_user_id`);
+CREATE INDEX IF NOT EXISTS `audit_log_created_at_idx` ON `audit_log` (`created_at`);
+
+-- DOWN
+
+DROP TABLE IF EXISTS `audit_log`;

package/dist/migrations/sqlite/20260504_000000_nextly_meta.sql

@@ -0,0 +1,21 @@
+-- Migration: nextly_meta runtime flags table
+-- Generated at: 2026-05-04T00:00:00.000Z
+-- Dialect: SQLite
+-- Source: Sub-task 2A — dashboard seeding card.
+-- A small key/value/timestamp store for runtime state that doesn't belong
+-- in collection schemas (first consumer: seed.completedAt / seed.skippedAt
+-- flags read by the admin dashboard's SeedDemoContentCard).
+
+-- UP
+
+CREATE TABLE IF NOT EXISTS `nextly_meta` (
+  `key`        text PRIMARY KEY NOT NULL,
+  `value`      text,
+  `updated_at` integer NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS `nextly_meta_updated_at_idx` ON `nextly_meta` (`updated_at`);
+
+-- DOWN
+
+DROP TABLE IF EXISTS `nextly_meta`;

package/dist/migrations/sqlite/20260505_000000_user_management_tables.sql

@@ -0,0 +1,77 @@
+-- Migration: Plan 12 user management + email tables
+-- Generated at: 2026-05-05T00:00:00.000Z
+-- Dialect: SQLite
+-- Source: SQLite was missing the equivalent of postgresql/0009 and
+-- mysql/0005 — without these tables UserExtSchemaService.syncCodeFields
+-- silently fails on first boot, hasMergedFields stays false, the
+-- user_ext table never gets created, and `/authors/[slug]` resolves to
+-- /authors/undefined for blog-template projects on SQLite. Adding the
+-- three tables fixes the cascade.
+
+-- UP
+
+CREATE TABLE IF NOT EXISTS `user_field_definitions` (
+  `id` text PRIMARY KEY NOT NULL,
+  `name` text NOT NULL,
+  `label` text NOT NULL,
+  `type` text NOT NULL,
+  `required` integer NOT NULL DEFAULT 0,
+  `default_value` text,
+  `options` text,
+  `placeholder` text,
+  `description` text,
+  `sort_order` integer NOT NULL DEFAULT 0,
+  `source` text NOT NULL DEFAULT 'ui',
+  `is_active` integer NOT NULL DEFAULT 1,
+  `created_at` integer NOT NULL DEFAULT (strftime('%s', 'now') * 1000),
+  `updated_at` integer NOT NULL DEFAULT (strftime('%s', 'now') * 1000)
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS `user_field_defs_name_unique_idx` ON `user_field_definitions` (`name`);
+CREATE INDEX IF NOT EXISTS `user_field_defs_source_idx` ON `user_field_definitions` (`source`);
+CREATE INDEX IF NOT EXISTS `user_field_defs_is_active_idx` ON `user_field_definitions` (`is_active`);
+CREATE INDEX IF NOT EXISTS `user_field_defs_sort_order_idx` ON `user_field_definitions` (`sort_order`);
+CREATE INDEX IF NOT EXISTS `user_field_defs_created_at_idx` ON `user_field_definitions` (`created_at`);
+
+CREATE TABLE IF NOT EXISTS `email_providers` (
+  `id` text PRIMARY KEY NOT NULL,
+  `name` text NOT NULL,
+  `type` text NOT NULL,
+  `from_email` text NOT NULL,
+  `from_name` text,
+  `configuration` text NOT NULL,
+  `is_default` integer NOT NULL DEFAULT 0,
+  `is_active` integer NOT NULL DEFAULT 1,
+  `created_at` integer NOT NULL DEFAULT (strftime('%s', 'now') * 1000),
+  `updated_at` integer NOT NULL DEFAULT (strftime('%s', 'now') * 1000)
+);
+
+CREATE INDEX IF NOT EXISTS `email_providers_type_idx` ON `email_providers` (`type`);
+CREATE UNIQUE INDEX IF NOT EXISTS `email_providers_default_unique_idx` ON `email_providers` (`is_default`) WHERE `is_default` = 1;
+CREATE INDEX IF NOT EXISTS `email_providers_is_active_idx` ON `email_providers` (`is_active`);
+CREATE INDEX IF NOT EXISTS `email_providers_created_at_idx` ON `email_providers` (`created_at`);
+
+CREATE TABLE IF NOT EXISTS `email_templates` (
+  `id` text PRIMARY KEY NOT NULL,
+  `name` text NOT NULL,
+  `slug` text NOT NULL UNIQUE,
+  `subject` text NOT NULL,
+  `html_content` text NOT NULL,
+  `plain_text_content` text,
+  `variables` text,
+  `use_layout` integer NOT NULL DEFAULT 1,
+  `is_active` integer NOT NULL DEFAULT 1,
+  `provider_id` text,
+  `created_at` integer NOT NULL DEFAULT (strftime('%s', 'now') * 1000),
+  `updated_at` integer NOT NULL DEFAULT (strftime('%s', 'now') * 1000)
+);
+
+CREATE INDEX IF NOT EXISTS `email_templates_is_active_idx` ON `email_templates` (`is_active`);
+CREATE INDEX IF NOT EXISTS `email_templates_provider_id_idx` ON `email_templates` (`provider_id`);
+CREATE INDEX IF NOT EXISTS `email_templates_created_at_idx` ON `email_templates` (`created_at`);
+
+-- DOWN
+
+DROP TABLE IF EXISTS `email_templates`;
+DROP TABLE IF EXISTS `email_providers`;
+DROP TABLE IF EXISTS `user_field_definitions`;

package/dist/next.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Next.js Config Wrapper
+ *
+ * Provides `withNextly()` to automatically configure Next.js for
+ * compatibility with Nextly's server-side packages. This prevents
+ * bundler errors (e.g., "Cannot find package 'pg'") on Vercel and
+ * other serverless platforms.
+ *
+ * @module nextly/next
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // next.config.ts
+ * import { withNextly } from "nextly/next";
+ *
+ * export default withNextly({
+ *   // your Next.js config
+ * });
+ * ```
+ */
+/**
+ * Wraps a Next.js config to add Nextly-required settings.
+ *
+ * Automatically adds server-external packages so database drivers
+ * and adapters are loaded from node_modules at runtime instead of
+ * being bundled (which fails on serverless platforms like Vercel).
+ *
+ * @param nextConfig - Your Next.js configuration
+ * @returns Enhanced Next.js configuration with Nextly compatibility
+ *
+ * @example
+ * ```typescript
+ * // next.config.ts
+ * import { withNextly } from "nextly/next";
+ *
+ * export default withNextly({
+ *   images: {
+ *     remotePatterns: [{ hostname: "example.com" }],
+ *   },
+ * });
+ * ```
+ *
+ * @example With other plugins
+ * ```typescript
+ * import { withNextly } from "nextly/next";
+ *
+ * const nextConfig = {
+ *   reactCompiler: true,
+ * };
+ *
+ * export default withNextly(nextConfig);
+ * ```
+ */
+declare function withNextly<T extends Record<string, unknown>>(nextConfig: T): T;
+
+export { withNextly };

package/dist/next.mjs

@@ -0,0 +1,55 @@
+import "./chunk-7P6ASYW6.mjs";
+
+// src/next.ts
+var NEXTLY_SERVER_EXTERNAL_PACKAGES = [
+  // Nextly core and adapters
+  "nextly",
+  "@nextlyhq/adapter-drizzle",
+  "@nextlyhq/adapter-postgres",
+  "@nextlyhq/adapter-mysql",
+  "@nextlyhq/adapter-sqlite",
+  // Database drivers
+  "pg",
+  "mysql2",
+  "better-sqlite3",
+  // ORM
+  "drizzle-orm",
+  // Auth (jose is a pure ESM package, no native bindings)
+  "jose"
+];
+var NEXTLY_FILE_TRACING_INCLUDES = [
+  "./node_modules/pg/**/*",
+  "./node_modules/pg-*/**/*",
+  "./node_modules/mysql2/**/*",
+  "./node_modules/better-sqlite3/**/*",
+  "./node_modules/@nextlyhq/adapter-postgres/**/*",
+  "./node_modules/@nextlyhq/adapter-mysql/**/*",
+  "./node_modules/@nextlyhq/adapter-sqlite/**/*",
+  "./node_modules/@nextlyhq/adapter-drizzle/**/*",
+  "./node_modules/drizzle-orm/**/*"
+];
+function withNextly(nextConfig) {
+  const existing = nextConfig.serverExternalPackages ?? [];
+  const merged = [
+    .../* @__PURE__ */ new Set([...existing, ...NEXTLY_SERVER_EXTERNAL_PACKAGES])
+  ];
+  const existingExperimental = nextConfig.experimental ?? {};
+  const existingIncludes = existingExperimental.outputFileTracingIncludes ?? {};
+  const existingCatchAll = existingIncludes["/**"] ?? [];
+  return {
+    ...nextConfig,
+    serverExternalPackages: merged,
+    experimental: {
+      ...existingExperimental,
+      outputFileTracingIncludes: {
+        ...existingIncludes,
+        "/**": [
+          .../* @__PURE__ */ new Set([...existingCatchAll, ...NEXTLY_FILE_TRACING_INCLUDES])
+        ]
+      }
+    }
+  };
+}
+export {
+  withNextly
+};