@zyacreatives/shared 1.0.0 → 1.1.0

package/src/schemas/user.ts

@@ -0,0 +1,125 @@
+import { z } from "@hono/zod-openapi";
+
+import {
+  ROLES,
+  USER_STATUSES,
+  ONBOARDING_PAGES,
+  EXPERIENCE_LEVELS,
+  INVESTOR_TYPES,
+  INVESTMENT_SIZES,
+  GEOGRAPHIC_FOCUS,
+} from "../constants";
+import type {
+  Role,
+  UserStatus,
+  OnboardingPage,
+  ExperienceLevel,
+  InvestorType,
+  InvestmentSize,
+  GeographicFocus,
+} from "../constants";
+import { UserSocialGraphEntitySchema } from "./common";
+
+export const BaseUserEntitySchema = z
+  .object({
+    id: z.cuid2().openapi({ example: "cksd0v6q0000s9a5y8z7p3x9" }),
+    email: z.email().openapi({ example: "user@example.com" }),
+    emailVerified: z.boolean().openapi({ example: true }),
+    name: z.string().optional().openapi({ example: "John Doe" }),
+    image: z
+      .string()
+      .optional()
+      .openapi({ example: "https://example.com/avatar.png" }),
+    username: z.string().optional().openapi({ example: "johndoe" }),
+    displayUsername: z.string().optional().openapi({ example: "@johndoe" }),
+    role: z.enum(Object.values(ROLES) as [Role, ...Role[]]).openapi({
+      example: "CREATIVE",
+    }),
+    status: z
+      .enum(Object.values(USER_STATUSES) as [UserStatus, ...UserStatus[]])
+      .openapi({
+        example: "ACTIVE",
+      }),
+    onboardingPage: z
+      .enum(
+        Object.values(ONBOARDING_PAGES) as [OnboardingPage, ...OnboardingPage[]]
+      )
+      .openapi({
+        example: "DONE",
+      }),
+    createdAt: z.iso
+      .datetime()
+      .openapi({ example: "2025-10-13T09:00:00.000Z" }),
+    updatedAt: z.iso
+      .datetime()
+      .openapi({ example: "2025-10-13T09:00:00.000Z" }),
+  })
+  .openapi("BaseUserEntity");
+
+export const MinimalUserSchema = BaseUserEntitySchema.pick({
+  id: true,
+  name: true,
+  email: true,
+  image: true,
+  username: true,
+  role: true,
+}).openapi("MinimalUser");
+
+export const UserEntitySchema = BaseUserEntitySchema.merge(
+  UserSocialGraphEntitySchema
+).openapi("UserEntity");
+
+export const UserProfileEntitySchema = UserEntitySchema.extend({
+  profileType: z.enum(["creative", "brand", "investor"]).optional().openapi({
+    example: "creative",
+  }),
+  bio: z.string().optional().openapi({
+    example: "Passionate digital artist focusing on UI/UX.",
+  }),
+  location: z.string().optional().openapi({
+    example: "Lagos, Nigeria",
+  }),
+  experienceLevel: z
+    .enum(
+      Object.values(EXPERIENCE_LEVELS) as [
+        ExperienceLevel,
+        ...ExperienceLevel[]
+      ]
+    )
+    .optional()
+    .openapi({ example: EXPERIENCE_LEVELS.YEAR_1_3 }),
+  disciplines: z
+    .array(z.string())
+    .optional()
+    .openapi({
+      example: ["ui-ux", "frontend"],
+    }),
+  tags: z
+    .array(z.string())
+    .optional()
+    .openapi({
+      example: ["react", "design", "product"],
+    }),
+  brandName: z.string().optional().openapi({
+    example: "Acme Creative Studio",
+  }),
+  websiteURL: z.string().optional().openapi({
+    example: "https://acme-creative.com",
+  }),
+  investorType: z
+    .enum(Object.values(INVESTOR_TYPES) as [InvestorType, ...InvestorType[]])
+    .optional()
+    .openapi({ example: INVESTOR_TYPES.ANGEL_INVESTOR }),
+  investmentSize: z
+    .enum(
+      Object.values(INVESTMENT_SIZES) as [InvestmentSize, ...InvestmentSize[]]
+    )
+    .optional()
+    .openapi({ example: INVESTMENT_SIZES.BETWEEN_25K_100K }),
+  geographicFocus: z
+    .enum(
+      Object.values(GEOGRAPHIC_FOCUS) as [GeographicFocus, ...GeographicFocus[]]
+    )
+    .optional()
+    .openapi({ example: GEOGRAPHIC_FOCUS.AFRICA }),
+}).openapi("UserProfileEntity");

package/src/types/brand.ts

@@ -0,0 +1,27 @@
+import type { MinimalUser } from "./user";
+
+export type BrandEntity = {
+  id: string;
+  userId: string;
+  brandName: string;
+  searchVector?: string;
+  bio?: string;
+  tags?: string[];
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+export type BrandWithUserEntity = BrandEntity & {
+  user: MinimalUser;
+  disciplines: string[];
+};
+
+export type ListBrandsInput = {
+  query?: string;
+  disciplines?: string[];
+  experienceLevels?: string[];
+  location?: string;
+  tags?: string[];
+  page?: number;
+  perPage?: number;
+};

package/src/types/common.ts

@@ -0,0 +1,11 @@
+export type ProjectSocialGraphEntity = {
+  noOfLikes?: number;
+  noOfComments?: number;
+  noOfBookmarks?: number;
+  noOfViews?: number;
+};
+
+export type UserSocialGraphEntity = {
+  followerCount?: number;
+  followingCount?: number;
+};

package/src/types/creative.ts

@@ -0,0 +1,32 @@
+import type { ExperienceLevel } from "../constants";
+import type { MinimalUser } from "./user";
+
+export type BaseCreativeEntity = {
+  id: string;
+  userId: string;
+  bio?: string;
+  location?: string;
+  experienceLevel?: ExperienceLevel;
+  tags?: string[];
+  disciplines?: string[];
+  user?: any;
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+export type CreativeEntity = BaseCreativeEntity;
+
+export type CreativeWithUserEntity = CreativeEntity & {
+  user: MinimalUser;
+  disciplines: string[];
+};
+
+export type ListCreativesInput = {
+  query?: string;
+  disciplines?: string[];
+  experienceLevels?: string[];
+  location?: string;
+  tags?: string[];
+  page?: number;
+  perPage?: number;
+};

package/src/types/discipline.ts

@@ -0,0 +1,9 @@
+export type DisciplineEntity = {
+  slug: string;
+  name: string;
+  tags?: string[];
+};
+
+export type DisciplineUpdateOutputEntity = {
+  slug: string;
+};

package/src/types/file.ts

@@ -0,0 +1,13 @@
+export type FileEntity = {
+  key: string;
+  id: string;
+  url?: string;
+  createdAt: Date;
+  updatedAt: Date;
+  userId: string;
+  mimeType: string;
+};
+
+export type FileUpdateOutputEntity = {
+  id: string;
+};

package/src/types/index.ts

@@ -0,0 +1,8 @@
+export * from "./brand";
+export * from "./common";
+export * from "./creative";
+export * from "./discipline";
+export * from "./file";
+export * from "./investor";
+export * from "./project";
+export * from "./user";

package/src/types/investor.ts

@@ -0,0 +1,38 @@
+import type {
+  ExperienceLevel,
+  GeographicFocus,
+  InvestmentSize,
+  InvestorType,
+} from "../constants";
+import type { MinimalUser } from "./user";
+
+export type InvestorEntity = {
+  id: string;
+  userId: string;
+  bio?: string;
+  location?: string;
+  experienceLevel?: ExperienceLevel;
+  geographicFocus?: GeographicFocus;
+  investmentSize?: InvestmentSize;
+  investorType?: InvestorType;
+  websiteURL?: string;
+  disciplines?: string[];
+  user?: any;
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+export type InvestorWithUserEntity = InvestorEntity & {
+  user: MinimalUser;
+  disciplines: string[];
+};
+
+export type ListInvestorsInput = {
+  query?: string;
+  disciplines?: string[];
+  experienceLevels?: string[];
+  location?: string;
+  tags?: string[];
+  page?: number;
+  perPage?: number;
+};

package/src/types/project.ts

@@ -0,0 +1,101 @@
+import type { ClientType, CommentStatus, Role } from "../constants";
+import type { ProjectSocialGraphEntity } from "./common";
+import type { BaseUserEntity, MinimalUser } from "./user";
+
+export type ProjectFileEntity = {
+  id: string;
+  projectId: string;
+  fileId: string;
+  order: number;
+  isPlaceholder: boolean;
+};
+
+export type ProjectEntity = {
+  id: string;
+  createdAt: Date;
+  updatedAt: Date;
+  userId: string;
+  title: string;
+  description?: string;
+  overview?: string;
+  url?: string;
+  clientId?: string;
+  clientType?: ClientType;
+  clientName?: string;
+  projectCreatorType: Role;
+  tags?: string[];
+  isFeatured?: boolean;
+  startDate?: Date | null;
+  imagePlaceholderUrl?: string;
+  endDate?: Date | null;
+};
+
+export type ProjectWithFilesEntity = ProjectEntity &
+  ProjectSocialGraphEntity & {
+    projectFiles?: ProjectFileEntity[];
+  };
+
+export type ProjectViewEntity = {
+  id: string;
+  userId?: string;
+  ipAddress?: string;
+  userAgent?: string;
+  projectId: string;
+  sessionId?: string;
+  viewedAt: Date;
+  viewDate: Date;
+};
+
+export type ProjectLikeEntity = {
+  createdAt: Date;
+  userId: string;
+  projectId: string;
+};
+
+export type ProjectCommentEntity = {
+  id: string;
+  status: CommentStatus;
+  createdAt: Date;
+  userId: string;
+  projectId: string;
+  parentCommentId?: string;
+  content: string;
+};
+
+export type ProjectBookmarkEntity = {
+  createdAt: Date;
+  userId: string;
+  projectId: string;
+};
+
+export type MinimalProject = Pick<
+  ProjectEntity,
+  | "id"
+  | "title"
+  | "description"
+  | "tags"
+  | "startDate"
+  | "endDate"
+  | "imagePlaceholderUrl"
+>;
+
+export type ProjectWithClientEntity = MinimalProject & {
+  client: MinimalUser;
+};
+
+export type ProjectWithUserEntity = MinimalProject & {
+  user: Pick<
+    BaseUserEntity,
+    "id" | "name" | "email" | "image" | "username" | "role"
+  >;
+  projectFiles: (ProjectFileEntity & { fileUrl: string })[];
+} & Partial<ProjectSocialGraphEntity>;
+
+export type ListProjectsDto = {
+  query?: string;
+  tags?: string[];
+  clientName?: string;
+  userId?: string;
+  page?: number;
+  perPage?: number;
+};

package/src/types/user.ts

@@ -0,0 +1,60 @@
+import type { OnboardingPage, Role, UserStatus } from "../constants";
+import type { UserSocialGraphEntity } from "./common";
+import type { ProjectBookmarkEntity, ProjectEntity } from "./project";
+
+export type BaseUserEntity = {
+  id: string;
+  email: string;
+  emailVerified: boolean;
+  name?: string;
+  image?: string;
+  username?: string;
+  displayUsername?: string;
+  role: Role;
+  status: UserStatus;
+  onboardingPage: OnboardingPage;
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+export type MinimalUser = Pick<
+  BaseUserEntity,
+  "id" | "name" | "email" | "image" | "username" | "role"
+>;
+
+export type UserEntity = BaseUserEntity & UserSocialGraphEntity;
+
+export type UserProfileEntity = UserEntity & {
+  profileType?: "creative" | "brand" | "investor";
+  bio?: string;
+  location?: string;
+  experienceLevel?: string;
+  disciplines?: any[];
+  tags?: any[];
+  brandName?: string;
+  websiteURL?: string;
+  investorType?: string;
+  investmentSize?: string;
+  geographicFocus?: string;
+};
+
+export type UserWithProjectsEntity = {
+  userId: string;
+  projects: Omit<ProjectEntity, "overview">[];
+};
+
+export type UserWithProjectBookmarksEntity = {
+  userId: string;
+  projectBookmarks: (ProjectBookmarkEntity & {
+    project: Pick<
+      ProjectEntity,
+      | "id"
+      | "title"
+      | "description"
+      | "tags"
+      | "startDate"
+      | "endDate"
+      | "imagePlaceholderUrl"
+    >;
+  })[];
+};

package/tsconfig.json

@@ -1,10 +1,13 @@
 {
   "compilerOptions": {
     "target": "ESNext",
-    "module": "ESNext",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
     "declaration": true,
     "outDir": "dist",
-    "strict": true
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
   },
   "include": ["src"]
 }