@thinhnguyencth1204/nextcli 0.7.0 → 0.9.0

package/templates/next-base/src/lib/db/prisma.ts

@@ -0,0 +1,23 @@
+import { PrismaPg } from "@prisma/adapter-pg";
+import { PrismaClient } from "@prisma/client";
+import { Pool } from "pg";
+
+declare global {
+  var prisma: PrismaClient | undefined;
+}
+
+const connectionString = process.env.DATABASE_URL;
+if (!connectionString) {
+  throw new Error(
+    "DATABASE_URL is missing. Please set it in your environment.",
+  );
+}
+
+const adapter = new PrismaPg(new Pool({ connectionString }));
+const prisma = global.prisma ?? new PrismaClient({ adapter });
+
+if (process.env.NODE_ENV !== "production") {
+  global.prisma = prisma;
+}
+
+export default prisma;

package/templates/next-base/src/lib/prisma.ts

@@ -0,0 +1,23 @@
+import { PrismaPg } from "@prisma/adapter-pg";
+import { PrismaClient } from "@prisma/client";
+import { Pool } from "pg";
+
+declare global {
+  var prisma: PrismaClient | undefined;
+}
+
+const connectionString = process.env.DATABASE_URL;
+if (!connectionString) {
+  throw new Error(
+    "DATABASE_URL is missing. Please set it in your environment.",
+  );
+}
+
+const adapter = new PrismaPg(new Pool({ connectionString }));
+const prisma = global.prisma ?? new PrismaClient({ adapter });
+
+if (process.env.NODE_ENV !== "production") {
+  global.prisma = prisma;
+}
+
+export default prisma;

package/templates/next-base/src/lib/rich-text/default-image-removal.ts

@@ -0,0 +1,10 @@
+import type { RemoveManagedImageFn } from "@/lib/rich-text";
+
+/**
+ * Default no-op image remover for base-only projects.
+ * After `nextcli add module supabase`, use
+ * `removeSupabaseManagedImage` from `@/lib/supabase/rich-text-image-sync`.
+ */
+export const defaultRemoveManagedImage: RemoveManagedImageFn = async () => {
+  // Intentionally empty — wire Supabase removal when the module is installed.
+};

package/templates/next-base/src/lib/rich-text/image-urls.ts

@@ -0,0 +1,41 @@
+import type { SerializedEditorState } from "lexical";
+
+type LexicalJsonNode = {
+  type?: string;
+  src?: string;
+  children?: LexicalJsonNode[];
+};
+
+function walkNodes(node: LexicalJsonNode, urls: Set<string>): void {
+  if (node.type === "image" && typeof node.src === "string" && node.src) {
+    urls.add(node.src);
+  }
+
+  if (Array.isArray(node.children)) {
+    for (const child of node.children) {
+      walkNodes(child, urls);
+    }
+  }
+}
+
+export function extractImageUrlsFromState(
+  state: SerializedEditorState | null | undefined,
+): string[] {
+  if (!state?.root) {
+    return [];
+  }
+
+  const urls = new Set<string>();
+  walkNodes(state.root as LexicalJsonNode, urls);
+  return [...urls];
+}
+
+export function diffRemovedImageUrls(
+  previous: SerializedEditorState | null | undefined,
+  next: SerializedEditorState | null | undefined,
+): string[] {
+  const previousUrls = extractImageUrlsFromState(previous);
+  const nextUrls = new Set(extractImageUrlsFromState(next));
+
+  return previousUrls.filter((url) => !nextUrls.has(url));
+}

package/templates/next-base/src/lib/rich-text/index.ts

@@ -0,0 +1,12 @@
+export { diffRemovedImageUrls, extractImageUrlsFromState } from "./image-urls";
+export {
+  isSupabaseManagedImageUrl,
+  parseSupabaseStorageUrl,
+  type SupabaseStorageRef,
+} from "./supabase-url";
+export {
+  syncRemovedRichTextImages,
+  type RemoveManagedImageFn,
+  type SyncRemovedImagesOptions,
+} from "./sync-removed-images";
+export { defaultRemoveManagedImage } from "./default-image-removal";

package/templates/next-base/src/lib/rich-text/supabase-url.ts

@@ -0,0 +1,67 @@
+const DEFAULT_BUCKET =
+  process.env.NEXT_PUBLIC_SUPABASE_STORAGE_BUCKET?.trim() || "public";
+
+export type SupabaseStorageRef = {
+  bucket: string;
+  path: string;
+};
+
+function getConfiguredBucket(): string {
+  return (
+    process.env.NEXT_PUBLIC_SUPABASE_STORAGE_BUCKET?.trim() || DEFAULT_BUCKET
+  );
+}
+
+/**
+ * Maps a Supabase public object URL back to `{ bucket, path }`.
+ * Returns null for external URLs or when Supabase env is not configured.
+ */
+export function parseSupabaseStorageUrl(
+  url: string,
+): SupabaseStorageRef | null {
+  const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL?.trim();
+  if (!supabaseUrl) {
+    return null;
+  }
+
+  try {
+    const parsed = new URL(url);
+    const base = new URL(supabaseUrl);
+
+    if (parsed.origin !== base.origin) {
+      return null;
+    }
+
+    const publicPrefix = "/storage/v1/object/public/";
+    if (!parsed.pathname.startsWith(publicPrefix)) {
+      return null;
+    }
+
+    const remainder = parsed.pathname.slice(publicPrefix.length);
+    const slashIndex = remainder.indexOf("/");
+    if (slashIndex <= 0) {
+      return null;
+    }
+
+    const bucket = remainder.slice(0, slashIndex);
+    const path = remainder.slice(slashIndex + 1);
+
+    if (!path) {
+      return null;
+    }
+
+    return { bucket, path };
+  } catch {
+    return null;
+  }
+}
+
+export function isSupabaseManagedImageUrl(url: string): boolean {
+  const ref = parseSupabaseStorageUrl(url);
+  if (!ref) {
+    return false;
+  }
+
+  const configuredBucket = getConfiguredBucket();
+  return ref.bucket === configuredBucket;
+}

package/templates/next-base/src/lib/rich-text/sync-removed-images.ts

@@ -0,0 +1,48 @@
+import type { SerializedEditorState } from "lexical";
+import { diffRemovedImageUrls } from "./image-urls";
+import {
+  isSupabaseManagedImageUrl,
+  parseSupabaseStorageUrl,
+} from "./supabase-url";
+
+export type RemoveManagedImageFn = (
+  url: string,
+  ref: { bucket: string; path: string },
+) => Promise<void>;
+
+export type SyncRemovedImagesOptions = {
+  /** Custom predicate; defaults to Supabase bucket/path URLs for this project. */
+  isManagedUrl?: (url: string) => boolean;
+  /** Injected remover (e.g. Supabase `removeResource`). */
+  removeManagedImage: RemoveManagedImageFn;
+};
+
+/**
+ * Compares previous and next Lexical states, then removes storage objects
+ * for images that disappeared from content. Non-managed URLs are ignored.
+ */
+export async function syncRemovedRichTextImages(
+  previous: SerializedEditorState | null | undefined,
+  next: SerializedEditorState | null | undefined,
+  options: SyncRemovedImagesOptions,
+): Promise<string[]> {
+  const removedUrls = diffRemovedImageUrls(previous, next);
+  const isManaged = options.isManagedUrl ?? isSupabaseManagedImageUrl;
+  const deleted: string[] = [];
+
+  for (const url of removedUrls) {
+    if (!isManaged(url)) {
+      continue;
+    }
+
+    const ref = parseSupabaseStorageUrl(url);
+    if (!ref) {
+      continue;
+    }
+
+    await options.removeManagedImage(url, ref);
+    deleted.push(url);
+  }
+
+  return deleted;
+}

package/templates/next-base/src/lib/supabase/client.ts

@@ -0,0 +1,6 @@
+import { createClient } from "@supabase/supabase-js";
+
+const url = process.env.NEXT_PUBLIC_SUPABASE_URL;
+const anonKey = process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY;
+
+export const supabase = url && anonKey ? createClient(url, anonKey) : null;

package/templates/next-base/src/lib/supabase/rich-text-image-sync.ts

@@ -0,0 +1,28 @@
+import { removeResource } from "@/lib/supabase/storage";
+import {
+  isSupabaseManagedImageUrl,
+  syncRemovedRichTextImages,
+  type RemoveManagedImageFn,
+} from "@/lib/rich-text";
+import type { SerializedEditorState } from "lexical";
+
+export const removeSupabaseManagedImage: RemoveManagedImageFn = async (
+  _url,
+  ref,
+) => {
+  await removeResource(ref.path, ref.bucket);
+};
+
+/**
+ * Deletes Supabase storage objects for images removed from rich text content.
+ * Only URLs belonging to this project's configured Supabase bucket are removed.
+ */
+export async function syncRemovedSupabaseRichTextImages(
+  previous: SerializedEditorState | null | undefined,
+  next: SerializedEditorState | null | undefined,
+) {
+  return syncRemovedRichTextImages(previous, next, {
+    isManagedUrl: isSupabaseManagedImageUrl,
+    removeManagedImage: removeSupabaseManagedImage,
+  });
+}

package/templates/next-base/src/lib/supabase/storage-config.ts

@@ -0,0 +1,69 @@
+export const DEFAULT_STORAGE_BUCKET =
+  process.env.NEXT_PUBLIC_SUPABASE_STORAGE_BUCKET?.trim() || "public";
+
+export const STORAGE_RESOURCE_CATEGORIES = [
+  "images",
+  "documents",
+  "avatars",
+  "misc",
+] as const;
+
+export type StorageResourceCategory =
+  (typeof STORAGE_RESOURCE_CATEGORIES)[number];
+
+const CATEGORY_DEFAULTS: Record<
+  StorageResourceCategory,
+  { maxBytes: number; allowedMimePrefixes: string[] }
+> = {
+  images: { maxBytes: 5 * 1024 * 1024, allowedMimePrefixes: ["image/"] },
+  documents: {
+    maxBytes: 10 * 1024 * 1024,
+    allowedMimePrefixes: [
+      "application/pdf",
+      "application/msword",
+      "application/vnd.",
+      "text/",
+    ],
+  },
+  avatars: { maxBytes: 2 * 1024 * 1024, allowedMimePrefixes: ["image/"] },
+  misc: { maxBytes: 10 * 1024 * 1024, allowedMimePrefixes: [] },
+};
+
+export function getStorageCategoryDefaults(category: StorageResourceCategory) {
+  return CATEGORY_DEFAULTS[category];
+}
+
+export function sanitizeStorageFileName(fileName: string): string {
+  const base = fileName.split(/[/\\]/).pop() ?? "file";
+  const sanitized = base
+    .normalize("NFKD")
+    .replace(/[^\w.\-]+/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-+|-+$/g, "")
+    .slice(0, 120);
+
+  return sanitized || "file";
+}
+
+function sanitizeStorageScope(scope: string): string {
+  const sanitized = scope
+    .trim()
+    .replace(/[^a-zA-Z0-9_-]/g, "-")
+    .replace(/-+/g, "-")
+    .slice(0, 64);
+
+  return sanitized || "shared";
+}
+
+export function buildStorageObjectPath(input: {
+  scope: string;
+  category: StorageResourceCategory;
+  fileName: string;
+  uniqueId?: string;
+}): string {
+  const scope = sanitizeStorageScope(input.scope);
+  const uniqueId = input.uniqueId ?? crypto.randomUUID();
+  const safeName = sanitizeStorageFileName(input.fileName);
+
+  return `${scope}/${input.category}/${uniqueId}-${safeName}`;
+}

package/templates/next-base/src/lib/supabase/storage.ts

@@ -0,0 +1,164 @@
+import { supabase } from "@/lib/supabase/client";
+import {
+  DEFAULT_STORAGE_BUCKET,
+  buildStorageObjectPath,
+  getStorageCategoryDefaults,
+  type StorageResourceCategory,
+} from "@/lib/supabase/storage-config";
+
+export type UploadResourceInput = {
+  file: File | Blob;
+  fileName: string;
+  /** Tenant/user/feature namespace, e.g. user id or `shared`. */
+  scope: string;
+  category?: StorageResourceCategory;
+  bucket?: string;
+  upsert?: boolean;
+  cacheControl?: string;
+  contentType?: string;
+};
+
+export type UploadResourceResult = {
+  bucket: string;
+  path: string;
+  publicUrl: string;
+};
+
+export class StorageHelperError extends Error {
+  constructor(
+    message: string,
+    readonly code:
+      | "NOT_CONFIGURED"
+      | "VALIDATION"
+      | "UPLOAD_FAILED"
+      | "REMOVE_FAILED",
+    readonly cause?: unknown,
+  ) {
+    super(message);
+    this.name = "StorageHelperError";
+  }
+}
+
+function getClient() {
+  if (!supabase) {
+    throw new StorageHelperError(
+      "Supabase is not configured. Set NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY.",
+      "NOT_CONFIGURED",
+    );
+  }
+
+  return supabase;
+}
+
+function resolveContentType(
+  file: File | Blob,
+  override?: string,
+): string | undefined {
+  if (override) {
+    return override;
+  }
+
+  if (file instanceof File && file.type) {
+    return file.type;
+  }
+
+  return undefined;
+}
+
+function assertCategoryRules(
+  category: StorageResourceCategory,
+  file: File | Blob,
+  contentType?: string,
+): void {
+  const { maxBytes, allowedMimePrefixes } =
+    getStorageCategoryDefaults(category);
+
+  if (file.size > maxBytes) {
+    throw new StorageHelperError(
+      `File exceeds ${category} limit of ${maxBytes} bytes.`,
+      "VALIDATION",
+    );
+  }
+
+  if (allowedMimePrefixes.length === 0) {
+    return;
+  }
+
+  const mime = contentType ?? (file instanceof File ? file.type : "");
+
+  if (!mime || !allowedMimePrefixes.some((prefix) => mime.startsWith(prefix))) {
+    throw new StorageHelperError(
+      `File type "${mime || "unknown"}" is not allowed for category "${category}".`,
+      "VALIDATION",
+    );
+  }
+}
+
+export function getResourcePublicUrl(
+  path: string,
+  bucket: string = DEFAULT_STORAGE_BUCKET,
+): string {
+  const client = getClient();
+  const { data } = client.storage.from(bucket).getPublicUrl(path);
+
+  return data.publicUrl;
+}
+
+export async function uploadResource(
+  input: UploadResourceInput,
+): Promise<UploadResourceResult> {
+  const client = getClient();
+  const bucket = input.bucket ?? DEFAULT_STORAGE_BUCKET;
+  const category = input.category ?? "images";
+  const contentType = resolveContentType(input.file, input.contentType);
+
+  assertCategoryRules(category, input.file, contentType);
+
+  const path = buildStorageObjectPath({
+    scope: input.scope,
+    category,
+    fileName: input.fileName,
+  });
+
+  const { error } = await client.storage.from(bucket).upload(path, input.file, {
+    contentType,
+    cacheControl: input.cacheControl ?? "3600",
+    upsert: input.upsert ?? false,
+  });
+
+  if (error) {
+    throw new StorageHelperError(
+      error.message || "Upload failed.",
+      "UPLOAD_FAILED",
+      error,
+    );
+  }
+
+  return {
+    bucket,
+    path,
+    publicUrl: getResourcePublicUrl(path, bucket),
+  };
+}
+
+export async function uploadImage(
+  input: Omit<UploadResourceInput, "category">,
+): Promise<UploadResourceResult> {
+  return uploadResource({ ...input, category: "images" });
+}
+
+export async function removeResource(
+  path: string,
+  bucket: string = DEFAULT_STORAGE_BUCKET,
+): Promise<void> {
+  const client = getClient();
+  const { error } = await client.storage.from(bucket).remove([path]);
+
+  if (error) {
+    throw new StorageHelperError(
+      error.message || "Remove failed.",
+      "REMOVE_FAILED",
+      error,
+    );
+  }
+}

package/templates/next-base/src/types/data-table.ts

@@ -0,0 +1,4 @@
+export type DataTablePaginationState = {
+  pageIndex: number;
+  pageSize: number;
+};

package/templates/next-base/src/types/index.ts

@@ -38,5 +38,3 @@ export type ApiErrorResponse = {
 };
 
 export type ApiResponse<T> = ApiSuccess<T> | ApiErrorResponse;
-
-export * from "@/types/data-table";