@nexttylabs/echo 0.2.0

package/lib/upload/file-validator.ts

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+export const MAX_FILE_SIZE = 5 * 1024 * 1024;
+
+export const ALLOWED_MIME_TYPES = [
+  "image/png",
+  "image/jpeg",
+  "image/jpg",
+  "image/gif",
+  "application/pdf",
+] as const;
+
+export type AllowedMimeType = (typeof ALLOWED_MIME_TYPES)[number];
+
+export type FileValidationResult =
+  | { valid: true; mimeType: AllowedMimeType }
+  | { valid: false; error: string; code: "INVALID_FILE_TYPE" | "FILE_TOO_LARGE" };
+
+export function validateFile(file: File): FileValidationResult {
+  if (file.size > MAX_FILE_SIZE) {
+    return {
+      valid: false,
+      error: "文件大小不能超过 5MB",
+      code: "FILE_TOO_LARGE",
+    };
+  }
+
+  if (!ALLOWED_MIME_TYPES.includes(file.type as AllowedMimeType)) {
+    return {
+      valid: false,
+      error: "不支持的文件类型",
+      code: "INVALID_FILE_TYPE",
+    };
+  }
+
+  return { valid: true, mimeType: file.type as AllowedMimeType };
+}

package/lib/upload/storage.ts

@@ -0,0 +1,59 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { mkdir, unlink, writeFile } from "fs/promises";
+import { randomUUID } from "crypto";
+import { join } from "path";
+
+export interface StoredFile {
+  fileName: string;
+  filePath: string;
+  fullPath: string;
+}
+
+export function generateUniqueFileName(originalName: string): string {
+  const ext = originalName.split(".").pop() ?? "";
+  const uuid = randomUUID();
+  return ext ? `${uuid}.${ext}` : uuid;
+}
+
+export async function saveFile(
+  file: File,
+  uploadDir: string = "public/uploads",
+): Promise<StoredFile> {
+  await mkdir(uploadDir, { recursive: true });
+
+  const uniqueFileName = generateUniqueFileName(file.name);
+  const fullPath = join(uploadDir, uniqueFileName);
+
+  const buffer = Buffer.from(await file.arrayBuffer());
+  await writeFile(fullPath, buffer);
+
+  return {
+    fileName: file.name,
+    filePath: fullPath.replace(/^public\//, ""),
+    fullPath,
+  };
+}
+
+export async function deleteFile(fullPath: string): Promise<void> {
+  try {
+    await unlink(fullPath);
+  } catch (error) {
+    console.error("Failed to delete file:", fullPath, error);
+  }
+}

package/lib/utils/format.ts

@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+export function formatFileSize(bytes: number): string {
+  if (!Number.isFinite(bytes) || bytes === 0) return "0 B";
+
+  const k = 1024;
+  const sizes = ["B", "KB", "MB", "GB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;
+}

package/lib/utils/slug.ts

@@ -0,0 +1,28 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+export function generateSlug(name: string): string {
+  const base = name
+    .toLowerCase()
+    .trim()
+    .replace(/\s+/g, "-")
+    .replace(/[^\w-]/g, "")
+    .replace(/--+/g, "-");
+
+  const suffix = Math.random().toString(36).slice(2, 6);
+  return `${base}-${suffix}`;
+}

package/lib/utils.ts

@@ -0,0 +1,23 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/lib/validations/auth.ts

@@ -0,0 +1,56 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { z } from "zod";
+
+export const userRoleSchema = z.enum([
+  "admin",
+  "product_manager",
+  "developer",
+  "customer_support",
+  "customer",
+]);
+
+export type UserRoleInput = z.infer<typeof userRoleSchema>;
+
+export const passwordSchema = z
+  .string()
+  .min(8, "密码至少需要 8 个字符")
+  .regex(/[A-Z]/, "密码必须包含大写字母")
+  .regex(/[a-z]/, "密码必须包含小写字母")
+  .regex(/[0-9!@#$%^&*]/, "密码必须包含数字或特殊字符");
+
+export const registerSchema = z.object({
+  name: z.string().min(1, "请输入您的姓名").max(100),
+  email: z.string().email("请输入有效的邮箱地址").max(255).toLowerCase(),
+  password: passwordSchema,
+});
+
+export type RegisterInput = z.infer<typeof registerSchema>;
+
+export const loginSchema = z.object({
+  email: z
+    .string()
+    .min(1, "请输入邮箱地址")
+    .email("请输入有效的邮箱地址")
+    .max(255)
+    .toLowerCase(),
+  password: z.string().min(1, "请输入密码"),
+  rememberMe: z.boolean().optional(),
+});
+
+export type LoginInput = z.infer<typeof loginSchema>;

package/lib/validations/comment.ts

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { z } from "zod";
+
+const baseCommentContent = z
+  .string()
+  .min(1, "评论内容不能为空")
+  .max(5000, "评论内容不能超过 5000 字符");
+
+export const createCommentSchema = z.object({
+  content: baseCommentContent,
+  isInternal: z.boolean().default(true),
+});
+
+export const createGuestCommentSchema = z.object({
+  content: baseCommentContent,
+  authorName: z
+    .string()
+    .min(1, "请输入您的姓名")
+    .max(100, "姓名不能超过 100 字符"),
+  authorEmail: z
+    .string()
+    .email("请输入有效的邮箱地址")
+    .max(255, "邮箱不能超过 255 字符"),
+  isInternal: z.literal(false).default(false),
+});
+
+export type CreateCommentInput = z.infer<typeof createCommentSchema>;
+export type CreateGuestCommentInput = z.infer<typeof createGuestCommentSchema>;

package/lib/validations/feedback.ts

@@ -0,0 +1,51 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { z } from "zod";
+
+export const FeedbackStatusEnum = z.enum([
+  "new",
+  "in-progress",
+  "planned",
+  "completed",
+  "closed",
+]);
+
+export type FeedbackStatus = z.infer<typeof FeedbackStatusEnum>;
+
+export const STATUS_LABELS: Record<FeedbackStatus, string> = {
+  new: "新接收",
+  "in-progress": "处理中",
+  planned: "已规划",
+  completed: "已完成",
+  closed: "已关闭",
+};
+
+export const STATUS_COLORS: Record<FeedbackStatus, string> = {
+  new: "bg-blue-100 text-blue-800 dark:bg-blue-900 dark:text-blue-200",
+  "in-progress": "bg-yellow-100 text-yellow-800 dark:bg-yellow-900 dark:text-yellow-200",
+  planned: "bg-purple-100 text-purple-800 dark:bg-purple-900 dark:text-purple-200",
+  completed: "bg-green-100 text-green-800 dark:bg-green-900 dark:text-green-200",
+  closed: "bg-gray-100 text-gray-800 dark:bg-gray-700 dark:text-gray-200",
+};
+
+export const updateFeedbackStatusSchema = z.object({
+  status: FeedbackStatusEnum,
+  comment: z.string().optional(),
+});
+
+export type UpdateFeedbackStatusInput = z.infer<typeof updateFeedbackStatusSchema>;

package/lib/validations/invitations.ts

@@ -0,0 +1,23 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { z } from "zod";
+
+export const createInvitationSchema = z.object({
+  email: z.string().email().max(255).toLowerCase(),
+  role: z.string().min(1).max(50),
+});

package/lib/validations/organizations.ts

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { z } from "zod";
+
+export const createOrganizationSchema = z.object({
+  name: z.string().min(1).max(100),
+  description: z.string().max(500).optional(),
+});
+
+export const organizationMemberRoleSchema = z.enum([
+  "admin",
+  "product_manager",
+  "developer",
+  "customer_support",
+]);
+
+export type OrganizationMemberRoleInput = z.infer<
+  typeof organizationMemberRoleSchema
+>;

package/lib/validations/projects.ts

@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { z } from "zod";
+
+export const createProjectSchema = z.object({
+  name: z.string().min(1, "Project name is required").max(100, "Name too long"),
+  description: z.string().max(500, "Description too long").optional(),
+});
+
+export type CreateProjectInput = z.infer<typeof createProjectSchema>;
+
+export const widgetConfigSchema = z.object({
+  theme: z.enum(["light", "dark", "auto"]),
+  primaryColor: z.string().regex(/^#[0-9A-Fa-f]{6}$/, "Invalid color format"),
+  buttonText: z.string().min(1).max(50),
+  buttonPosition: z.enum(["bottom-right", "bottom-left", "top-right", "top-left"]),
+  fields: z.object({
+    showType: z.boolean(),
+    showPriority: z.boolean(),
+    showDescription: z.boolean(),
+    requireEmail: z.boolean(),
+  }),
+  types: z.array(z.enum(["bug", "feature", "issue", "other"])).min(1),
+  customCSS: z.string().max(5000).optional(),
+});
+
+export const updateProjectSchema = z.object({
+  name: z.string().min(1).max(100).optional(),
+  description: z.string().max(500).optional(),
+  widgetConfig: widgetConfigSchema.optional(),
+});
+
+export type WidgetConfig = z.infer<typeof widgetConfigSchema>;
+export type UpdateProjectInput = z.infer<typeof updateProjectSchema>;

package/lib/validators/feedback.ts

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { z } from "zod";
+
+export const feedbackTypeEnum = z.enum(["bug", "feature", "issue", "other"]);
+
+export const priorityEnum = z.enum(["low", "medium", "high"]);
+
+export const customerInfoSchema = z.object({
+  name: z.string().min(1, "customerNameRequired").max(100, "customerNameMax100"),
+  email: z.string().email("emailInvalid"),
+  phone: z.string().optional(),
+});
+
+export const baseFeedbackSchema = z.object({
+  title: z
+    .string()
+    .min(1, "titleRequired")
+    .max(200, "titleMax200"),
+  description: z
+    .string()
+    .min(1, "descriptionRequired")
+    .max(5000, "descriptionMax5000"),
+  type: feedbackTypeEnum.optional(),
+  priority: priorityEnum.optional(),
+});
+
+export const feedbackSchema = baseFeedbackSchema.extend({
+  submittedOnBehalf: z.boolean().optional().default(false),
+  customerInfo: customerInfoSchema.optional(),
+  isAnonymous: z.boolean().optional().default(false),
+});
+
+export const updateFeedbackSchema = baseFeedbackSchema.pick({
+  title: true,
+  description: true,
+});
+
+export type BaseFeedbackInput = z.infer<typeof baseFeedbackSchema>;
+export type FeedbackInput = z.infer<typeof feedbackSchema>;
+export type CustomerInfoInput = z.infer<typeof customerInfoSchema>;
+export type UpdateFeedbackInput = z.infer<typeof updateFeedbackSchema>;

package/lib/validators/index.ts

@@ -0,0 +1,18 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+export * from "./feedback";

package/lib/webhooks/events.ts

@@ -0,0 +1,73 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+export const WEBHOOK_EVENTS = {
+  FEEDBACK_CREATED: "feedback.created",
+  FEEDBACK_UPDATED: "feedback.updated",
+  FEEDBACK_DELETED: "feedback.deleted",
+  FEEDBACK_STATUS_CHANGED: "feedback.status_changed",
+
+  COMMENT_CREATED: "comment.created",
+  COMMENT_UPDATED: "comment.updated",
+  COMMENT_DELETED: "comment.deleted",
+
+  USER_INVITED: "user.invited",
+  USER_JOINED: "user.joined",
+  USER_REMOVED: "user.removed",
+} as const;
+
+export type WebhookEventType =
+  (typeof WEBHOOK_EVENTS)[keyof typeof WEBHOOK_EVENTS];
+
+export interface WebhookPayload {
+  id: string;
+  event: WebhookEventType;
+  timestamp: string;
+  data: unknown;
+  organizationId: string;
+}
+
+export interface FeedbackCreatedPayload extends WebhookPayload {
+  event: "feedback.created";
+  data: {
+    feedbackId: string;
+    title: string;
+    description: string;
+    type: string;
+    priority: string;
+    status: string;
+    organizationId: string;
+    createdAt: string;
+  };
+}
+
+export interface FeedbackUpdatedPayload extends WebhookPayload {
+  event: "feedback.updated";
+  data: {
+    feedbackId: string;
+    changes: Record<string, { old: unknown; new: unknown }>;
+  };
+}
+
+export interface FeedbackStatusChangedPayload extends WebhookPayload {
+  event: "feedback.status_changed";
+  data: {
+    feedbackId: string;
+    oldStatus: string;
+    newStatus: string;
+  };
+}

package/lib/webhooks/index.ts

@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2026 Echo Team
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+export * from "./events";
+export * from "./sender";
+export * from "./retry";
+export * from "./verify";