@zyacreatives/shared 1.3.6 → 1.3.7

package/dist/schemas/project.d.ts

@@ -1,38 +1,74 @@
 import { z } from "@hono/zod-openapi";
 export declare const ProjectEntitySchema: z.ZodObject<{
-    id: z.ZodCUID2;
-    createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    userId: z.ZodCUID2;
-    title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
-    overview: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
     url: z.ZodOptional<z.ZodString>;
+    imagePlaceholderUrl: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    startDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    endDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    overview: z.ZodOptional<z.ZodString>;
+    projectCreatorType: z.ZodEnum<{
+        readonly CREATIVE: "CREATIVE";
+        readonly BRAND: "BRAND";
+        readonly INVESTOR: "INVESTOR";
+        readonly ADMIN: "ADMIN";
+    }>;
     clientId: z.ZodOptional<z.ZodString>;
     clientType: z.ZodOptional<z.ZodEnum<{
-        CREATIVE: "CREATIVE";
-        BRAND: "BRAND";
-        NONE: "NONE";
+        readonly CREATIVE: "CREATIVE";
+        readonly BRAND: "BRAND";
+        readonly NONE: "NONE";
     }>>;
     clientName: z.ZodOptional<z.ZodString>;
-    projectCreatorType: z.ZodEnum<{
-        CREATIVE: "CREATIVE";
-        BRAND: "BRAND";
-        INVESTOR: "INVESTOR";
-        ADMIN: "ADMIN";
-    }>;
+    id: z.ZodString;
+    isFeatured: z.ZodOptional<z.ZodBoolean>;
+    createdAt: z.ZodCoercedDate<unknown>;
+    updatedAt: z.ZodCoercedDate<unknown>;
+    userId: z.ZodString;
+    searchVector: z.ZodString;
+}, z.core.$strip>;
+export declare const CreateProjectSchema: z.ZodObject<{
+    userId: z.ZodString;
+    title: z.ZodString;
+    projectCreatorType: z.ZodDefault<z.ZodEnum<{
+        readonly CREATIVE: "CREATIVE";
+        readonly BRAND: "BRAND";
+        readonly INVESTOR: "INVESTOR";
+        readonly ADMIN: "ADMIN";
+    }>>;
+    imagePlaceholderUrl: z.ZodURL;
+    id: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    overview: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    clientId: z.ZodOptional<z.ZodString>;
+    clientType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        readonly CREATIVE: "CREATIVE";
+        readonly BRAND: "BRAND";
+        readonly NONE: "NONE";
+    }>>>;
+    clientName: z.ZodOptional<z.ZodString>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    searchVector: z.ZodOptional<z.ZodString>;
     isFeatured: z.ZodOptional<z.ZodBoolean>;
     startDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     endDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    imagePlaceholderUrl: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        mimeType: z.ZodString;
+        isPlaceholder: z.ZodDefault<z.ZodBoolean>;
+        order: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const ProjectFileEntitySchema: z.ZodObject<{
-    id: z.ZodCUID2;
-    projectId: z.ZodCUID2;
-    url: z.ZodString;
-    mimeType: z.ZodString;
-    fileSize: z.ZodNumber;
+    isPlaceholder: z.ZodBoolean;
+    order: z.ZodNumber;
+    projectId: z.ZodString;
+    id: z.ZodString;
+    fileId: z.ZodString;
 }, z.core.$strip>;
 export declare const ProjectSocialGraphEntitySchema: z.ZodObject<{
     noOfLikes: z.ZodOptional<z.ZodNumber>;
@@ -41,42 +77,43 @@ export declare const ProjectSocialGraphEntitySchema: z.ZodObject<{
     noOfViews: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const ProjectWithFilesEntitySchema: z.ZodObject<{
-    id: z.ZodCUID2;
-    createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    userId: z.ZodCUID2;
-    title: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
-    overview: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
     url: z.ZodOptional<z.ZodString>;
+    imagePlaceholderUrl: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    startDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    endDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    overview: z.ZodOptional<z.ZodString>;
+    projectCreatorType: z.ZodEnum<{
+        readonly CREATIVE: "CREATIVE";
+        readonly BRAND: "BRAND";
+        readonly INVESTOR: "INVESTOR";
+        readonly ADMIN: "ADMIN";
+    }>;
     clientId: z.ZodOptional<z.ZodString>;
     clientType: z.ZodOptional<z.ZodEnum<{
-        CREATIVE: "CREATIVE";
-        BRAND: "BRAND";
-        NONE: "NONE";
+        readonly CREATIVE: "CREATIVE";
+        readonly BRAND: "BRAND";
+        readonly NONE: "NONE";
     }>>;
     clientName: z.ZodOptional<z.ZodString>;
-    projectCreatorType: z.ZodEnum<{
-        CREATIVE: "CREATIVE";
-        BRAND: "BRAND";
-        INVESTOR: "INVESTOR";
-        ADMIN: "ADMIN";
-    }>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    id: z.ZodString;
     isFeatured: z.ZodOptional<z.ZodBoolean>;
-    startDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    endDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    imagePlaceholderUrl: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodCoercedDate<unknown>;
+    updatedAt: z.ZodCoercedDate<unknown>;
+    userId: z.ZodString;
+    searchVector: z.ZodString;
     noOfLikes: z.ZodOptional<z.ZodNumber>;
     noOfComments: z.ZodOptional<z.ZodNumber>;
     noOfBookmarks: z.ZodOptional<z.ZodNumber>;
     noOfViews: z.ZodOptional<z.ZodNumber>;
     projectFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        id: z.ZodCUID2;
-        projectId: z.ZodCUID2;
-        url: z.ZodString;
-        mimeType: z.ZodString;
-        fileSize: z.ZodNumber;
+        isPlaceholder: z.ZodBoolean;
+        order: z.ZodNumber;
+        projectId: z.ZodString;
+        id: z.ZodString;
+        fileId: z.ZodString;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const ProjectViewEntitySchema: z.ZodObject<{

package/dist/schemas/project.js

@@ -1,75 +1,232 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProjectUpdateOutputEntitySchema = exports.ProjectBookmarkEntitySchema = exports.ProjectCommentEntitySchema = exports.ProjectLikeEntitySchema = exports.ProjectViewEntitySchema = exports.ProjectWithFilesEntitySchema = exports.ProjectSocialGraphEntitySchema = exports.ProjectFileEntitySchema = exports.ProjectEntitySchema = void 0;
+exports.ProjectUpdateOutputEntitySchema = exports.ProjectBookmarkEntitySchema = exports.ProjectCommentEntitySchema = exports.ProjectLikeEntitySchema = exports.ProjectViewEntitySchema = exports.ProjectWithFilesEntitySchema = exports.ProjectSocialGraphEntitySchema = exports.ProjectFileEntitySchema = exports.CreateProjectSchema = exports.ProjectEntitySchema = void 0;
 const zod_openapi_1 = require("@hono/zod-openapi");
 const constants_1 = require("../constants");
+const file_1 = require("./file");
 exports.ProjectEntitySchema = zod_openapi_1.z
     .object({
-    id: zod_openapi_1.z.cuid2().openapi({ example: "cksd0v6q0000s9a5y8z7p3x9" }),
-    createdAt: zod_openapi_1.z.coerce
-        .date()
+    description: zod_openapi_1.z.string().optional().openapi({
+        description: "Detailed description of the project, max 1000 characters.",
+        example: "A modern e-commerce mobile application built with React Native.",
+    }),
+    title: zod_openapi_1.z.string().openapi({
+        description: "Title of the project.",
+        example: "E-commerce Mobile App",
+    }),
+    url: zod_openapi_1.z.string().optional().openapi({
+        description: "URL to the project or live demo.",
+        example: "https://example.com/project",
+    }),
+    imagePlaceholderUrl: zod_openapi_1.z.string().url().openapi({
+        description: "URL for the placeholder image of the project.",
+        example: "https://img.com",
+    }),
+    tags: zod_openapi_1.z
+        .array(zod_openapi_1.z.string())
         .optional()
-        .openapi({ example: "2025-10-13T09:00:00.000Z" }),
-    updatedAt: zod_openapi_1.z.coerce
+        .openapi({
+        description: "Array of tags associated with the project.",
+        example: ["react-native", "e-commerce", "mobile"],
+    }),
+    startDate: zod_openapi_1.z.coerce
         .date()
         .optional()
-        .openapi({ example: "2025-10-13T09:00:00.000Z" }),
-    userId: zod_openapi_1.z.cuid2().openapi({ example: "cksd0v6q0000s9a5y8z7p3x9" }),
-    title: zod_openapi_1.z.string().openapi({ example: "Brand Identity Design" }),
-    description: zod_openapi_1.z
-        .string()
-        .optional()
-        .openapi({ example: "A full rebrand for a fashion label." }),
-    overview: zod_openapi_1.z
-        .string()
-        .optional()
-        .openapi({ example: "Detailed project story and outcomes." }),
-    url: zod_openapi_1.z
-        .string()
-        .url()
+        .openapi({
+        description: "Start date of the project.",
+        example: new Date("2024-01-01"),
+    }),
+    endDate: zod_openapi_1.z.coerce
+        .date()
         .optional()
-        .openapi({ example: "https://example.com/project" }),
-    clientId: zod_openapi_1.z.string().optional().openapi({ example: "client_abc123" }),
+        .openapi({
+        description: "End date of the project.",
+        example: new Date("2024-06-30"),
+    }),
+    overview: zod_openapi_1.z.string().optional().openapi({
+        description: "Brief overview of the project.",
+        example: "A comprehensive e-commerce solution for mobile devices.",
+    }),
+    projectCreatorType: zod_openapi_1.z.enum(constants_1.ROLES).openapi({
+        description: "Type of creator who made this project.",
+        example: "CREATIVE",
+    }),
+    clientId: zod_openapi_1.z.string().optional().openapi({
+        description: "CUID2 of the client if this is a client project.",
+        example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    clientType: zod_openapi_1.z.enum(constants_1.CLIENT_TYPES).optional().openapi({
+        description: "Type of client for this project.",
+        example: "BRAND",
+    }),
+    clientName: zod_openapi_1.z.string().optional().openapi({
+        description: "Name of the client.",
+        example: "Acme Corp",
+    }),
+    id: zod_openapi_1.z.string().openapi({
+        description: "CUID2 of the project.",
+        example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    isFeatured: zod_openapi_1.z.boolean().optional().openapi({
+        description: "Whether the project is featured.",
+        example: true,
+    }),
+    createdAt: zod_openapi_1.z.coerce.date().openapi({
+        description: "Timestamp when the project was created.",
+        example: new Date("2024-01-01T00:00:00.000Z"),
+    }),
+    updatedAt: zod_openapi_1.z.coerce.date().openapi({
+        description: "Timestamp when the project was last updated.",
+        example: new Date("2024-06-30T00:00:00.000Z"),
+    }),
+    userId: zod_openapi_1.z.string().openapi({
+        description: "CUID2 of the user who created the project.",
+        example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    searchVector: zod_openapi_1.z.string().openapi({
+        description: "Search vector for full-text search indexing.",
+        example: "ecommerce mobile app react native",
+    }),
+})
+    .openapi({
+    title: "Project DB Entity",
+    description: "Schema representing a project stored in the database.",
+});
+exports.CreateProjectSchema = zod_openapi_1.z
+    .object({
+    userId: zod_openapi_1.z.string().openapi({
+        description: "CUID2 of the user creating the project.",
+        example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    title: zod_openapi_1.z.string().min(1).max(100).openapi({
+        description: "Title of the project, 1–100 characters.",
+        example: "E-commerce Mobile App",
+    }),
+    projectCreatorType: zod_openapi_1.z.enum(constants_1.ROLES).default(constants_1.ROLES.CREATIVE).openapi({
+        description: "Type of creator who made this project.",
+        example: "CREATIVE",
+    }),
+    imagePlaceholderUrl: zod_openapi_1.z.url().openapi({
+        description: "URL for the placeholder image of the project.",
+        example: "https://img.com",
+    }),
+    id: zod_openapi_1.z.string().optional().openapi({
+        description: "CUID2 of the project.",
+        example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    description: zod_openapi_1.z.string().optional().openapi({
+        description: "Detailed description of the project, max 1000 characters.",
+        example: "A modern e-commerce mobile application built with React Native.",
+    }),
+    overview: zod_openapi_1.z.string().optional().openapi({
+        description: "Brief overview of the project.",
+        example: "A comprehensive e-commerce solution for mobile devices.",
+    }),
+    url: zod_openapi_1.z.string().optional().openapi({
+        description: "URL to the project or live demo.",
+        example: "https://example.com/project",
+    }),
+    clientId: zod_openapi_1.z.string().optional().openapi({
+        description: "CUID2 of the client if this is a client project.",
+        example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
     clientType: zod_openapi_1.z
-        .enum(Object.values(constants_1.CLIENT_TYPES))
+        .enum(constants_1.CLIENT_TYPES)
         .optional()
-        .openapi({ example: "BRAND" }),
-    clientName: zod_openapi_1.z.string().optional().openapi({ example: "Nike" }),
-    projectCreatorType: zod_openapi_1.z
-        .enum(Object.values(constants_1.ROLES))
-        .openapi({ example: "CREATIVE" }),
+        .default(constants_1.CLIENT_TYPES.NONE)
+        .openapi({
+        description: "Type of client for this project.",
+        example: "BRAND",
+    }),
+    clientName: zod_openapi_1.z.string().optional().openapi({
+        description: "Name of the client.",
+        example: "Acme Corp",
+    }),
     tags: zod_openapi_1.z
         .array(zod_openapi_1.z.string())
         .optional()
-        .openapi({ example: ["branding", "logo"] }),
-    isFeatured: zod_openapi_1.z.boolean().optional().openapi({ example: false }),
+        .openapi({
+        description: "Array of tags associated with the project.",
+        example: ["react-native", "e-commerce", "mobile"],
+    }),
+    searchVector: zod_openapi_1.z.string().optional().openapi({
+        description: "Search vector for full-text search indexing.",
+        example: "ecommerce mobile app react native",
+    }),
+    isFeatured: zod_openapi_1.z.boolean().optional().openapi({
+        description: "Whether the project is featured.",
+        example: true,
+    }),
     startDate: zod_openapi_1.z.coerce
         .date()
         .optional()
-        .openapi({ example: "2025-06-01T00:00:00.000Z" }),
+        .openapi({
+        description: "Start date of the project.",
+        example: new Date("2024-01-01"),
+    }),
     endDate: zod_openapi_1.z.coerce
         .date()
         .optional()
-        .openapi({ example: "2025-07-15T00:00:00.000Z" }),
-    imagePlaceholderUrl: zod_openapi_1.z
-        .string()
-        .url()
+        .openapi({
+        description: "End date of the project.",
+        example: new Date("2024-06-30"),
+    }),
+    createdAt: zod_openapi_1.z.coerce
+        .date()
+        .optional()
+        .openapi({
+        description: "Timestamp when the project was created.",
+        example: new Date("2024-01-01T00:00:00.000Z"),
+    }),
+    updatedAt: zod_openapi_1.z.coerce
+        .date()
+        .optional()
+        .openapi({
+        description: "Timestamp when the project was last updated.",
+        example: new Date("2024-06-30T00:00:00.000Z"),
+    }),
+    files: zod_openapi_1.z
+        .array(file_1.CreateFileInputSchema.extend({
+        isPlaceholder: zod_openapi_1.z.boolean().default(false),
+        order: zod_openapi_1.z.number().int().default(1),
+    }))
         .optional()
-        .openapi({ example: "https://example.com/project-image.png" }),
+        .openapi({
+        description: "Array of files/images for the project.",
+        example: [],
+    }),
 })
-    .openapi("ProjectEntity");
+    .openapi({
+    title: "Create Project",
+    description: "Schema for creating a new project.",
+});
 exports.ProjectFileEntitySchema = zod_openapi_1.z
     .object({
-    id: zod_openapi_1.z.cuid2().openapi({ example: "pfe_cksd0v6q0000s9a5y8z7p3x9" }),
-    projectId: zod_openapi_1.z.cuid2().openapi({ example: "cksd0v6q0000s9a5y8z7p3x9" }),
-    url: zod_openapi_1.z
-        .string()
-        .url()
-        .openapi({ example: "https://cdn.example.com/project/image.jpg" }),
-    mimeType: zod_openapi_1.z.string().openapi({ example: "image/jpeg" }),
-    fileSize: zod_openapi_1.z.number().int().positive().openapi({ example: 1500000 }), // size in bytes
+    isPlaceholder: zod_openapi_1.z.boolean().openapi({
+        description: "Indicates whether the file is a placeholder.",
+        example: false,
+    }),
+    order: zod_openapi_1.z.number().int().openapi({
+        description: "Order index of the file in the project.",
+        example: 1,
+    }),
+    projectId: zod_openapi_1.z.string().openapi({
+        description: "CUID2 of the project this file belongs to.",
+        example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    id: zod_openapi_1.z.string().openapi({
+        description: "CUID2 of the project file record.",
+        example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    fileId: zod_openapi_1.z.string().openapi({
+        description: "CUID2 of the linked file.",
+        example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
 })
-    .openapi("ProjectFileEntity");
+    .openapi({
+    title: "Project File Entity",
+    description: "Schema representing a file associated with a project.",
+});
 exports.ProjectSocialGraphEntitySchema = zod_openapi_1.z
     .object({
     noOfLikes: zod_openapi_1.z.number().int().optional().openapi({ example: 150 }),

package/dist/schemas/user.d.ts

@@ -149,31 +149,32 @@ export declare const UserProfileEntitySchema: z.ZodObject<{
 export declare const UserWithProjectsEntitySchema: z.ZodObject<{
     userId: z.ZodCUID2;
     projects: z.ZodArray<z.ZodObject<{
-        id: z.ZodCUID2;
-        userId: z.ZodCUID2;
+        id: z.ZodString;
+        userId: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         title: z.ZodString;
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-        updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+        createdAt: z.ZodCoercedDate<unknown>;
+        updatedAt: z.ZodCoercedDate<unknown>;
         url: z.ZodOptional<z.ZodString>;
+        imagePlaceholderUrl: z.ZodString;
+        startDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+        endDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+        projectCreatorType: z.ZodEnum<{
+            readonly CREATIVE: "CREATIVE";
+            readonly BRAND: "BRAND";
+            readonly INVESTOR: "INVESTOR";
+            readonly ADMIN: "ADMIN";
+        }>;
         clientId: z.ZodOptional<z.ZodString>;
         clientType: z.ZodOptional<z.ZodEnum<{
-            CREATIVE: "CREATIVE";
-            BRAND: "BRAND";
-            NONE: "NONE";
+            readonly CREATIVE: "CREATIVE";
+            readonly BRAND: "BRAND";
+            readonly NONE: "NONE";
         }>>;
         clientName: z.ZodOptional<z.ZodString>;
-        projectCreatorType: z.ZodEnum<{
-            CREATIVE: "CREATIVE";
-            BRAND: "BRAND";
-            INVESTOR: "INVESTOR";
-            ADMIN: "ADMIN";
-        }>;
         isFeatured: z.ZodOptional<z.ZodBoolean>;
-        startDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-        endDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-        imagePlaceholderUrl: z.ZodOptional<z.ZodString>;
+        searchVector: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const UserWithProjectBookmarksEntitySchema: z.ZodObject<{
@@ -183,13 +184,13 @@ export declare const UserWithProjectBookmarksEntitySchema: z.ZodObject<{
         userId: z.ZodCUID2;
         projectId: z.ZodCUID2;
         project: z.ZodObject<{
-            id: z.ZodCUID2;
+            id: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
             title: z.ZodString;
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            imagePlaceholderUrl: z.ZodString;
             startDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
             endDate: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-            imagePlaceholderUrl: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/types/project.d.ts

@@ -1,6 +1,5 @@
 import type { ClientType, Role } from "../constants";
-import type { ProjectSocialGraphEntity } from "./common";
-import type { BaseUserEntity, MinimalUser } from "./user";
+import type { MinimalUser } from "./user";
 export type ProjectFileEntity = {
     id: string;
     projectId: string;
@@ -27,9 +26,6 @@ export type ProjectEntity = {
     imagePlaceholderUrl?: string;
     endDate?: Date;
 };
-export type ProjectWithFilesEntity = ProjectEntity & ProjectSocialGraphEntity & {
-    projectFiles?: ProjectFileEntity[];
-};
 export type ProjectViewEntity = {
     id: string;
     userId?: string;
@@ -65,12 +61,11 @@ export type MinimalProject = Pick<ProjectEntity, "id" | "title" | "description"
 export type ProjectWithClientEntity = MinimalProject & {
     client: MinimalUser;
 };
-export type ProjectWithUserEntity = MinimalProject & {
-    user: Pick<BaseUserEntity, "id" | "name" | "email" | "image" | "username" | "role">;
+export type ProjectWithProjectFilesEntity = MinimalProject & {
     projectFiles: (ProjectFileEntity & {
         fileUrl: string;
     })[];
-} & Partial<ProjectSocialGraphEntity>;
+};
 export type ListProjectsInput = {
     query?: string;
     tags?: string[];
@@ -81,13 +76,13 @@ export type ListProjectsInput = {
 };
 export type ProjectWithProjectViewsEntity = MinimalProject & {
     views: ProjectViewEntity[];
-} & Partial<ProjectSocialGraphEntity>;
+};
 export type ProjectWithProjectCommentsEntity = MinimalProject & {
     comments: ProjectCommentEntity[];
-} & Partial<ProjectSocialGraphEntity>;
+};
 export type ProjectWithProjectLikesEntity = MinimalProject & {
     likes: ProjectLikeEntity[];
-} & Partial<ProjectSocialGraphEntity>;
+};
 export type ProjectWithProjectBookmarksEntity = MinimalProject & {
     bookmarks: ProjectBookmarkEntity[];
-} & Partial<ProjectSocialGraphEntity>;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zyacreatives/shared",
-  "version": "1.3.6",
+  "version": "1.3.7",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/schemas/project.ts

@@ -1,74 +1,235 @@
 import { z } from "@hono/zod-openapi";
-import { CLIENT_TYPES, ClientType, Role, ROLES } from "../constants";
-
+import { CLIENT_TYPES, ROLES } from "../constants";
+import { CreateFileInputSchema } from "./file";
 export const ProjectEntitySchema = z
   .object({
-    id: z.cuid2().openapi({ example: "cksd0v6q0000s9a5y8z7p3x9" }),
-    createdAt: z.coerce
-      .date()
+    description: z.string().optional().openapi({
+      description: "Detailed description of the project, max 1000 characters.",
+      example:
+        "A modern e-commerce mobile application built with React Native.",
+    }),
+    title: z.string().openapi({
+      description: "Title of the project.",
+      example: "E-commerce Mobile App",
+    }),
+    url: z.string().optional().openapi({
+      description: "URL to the project or live demo.",
+      example: "https://example.com/project",
+    }),
+    imagePlaceholderUrl: z.string().url().openapi({
+      description: "URL for the placeholder image of the project.",
+      example: "https://img.com",
+    }),
+    tags: z
+      .array(z.string())
       .optional()
-      .openapi({ example: "2025-10-13T09:00:00.000Z" }),
-    updatedAt: z.coerce
+      .openapi({
+        description: "Array of tags associated with the project.",
+        example: ["react-native", "e-commerce", "mobile"],
+      }),
+    startDate: z.coerce
       .date()
       .optional()
-      .openapi({ example: "2025-10-13T09:00:00.000Z" }),
-    userId: z.cuid2().openapi({ example: "cksd0v6q0000s9a5y8z7p3x9" }),
-    title: z.string().openapi({ example: "Brand Identity Design" }),
-    description: z
-      .string()
-      .optional()
-      .openapi({ example: "A full rebrand for a fashion label." }),
-    overview: z
-      .string()
-      .optional()
-      .openapi({ example: "Detailed project story and outcomes." }),
-    url: z
-      .string()
-      .url()
+      .openapi({
+        description: "Start date of the project.",
+        example: new Date("2024-01-01"),
+      }),
+    endDate: z.coerce
+      .date()
       .optional()
-      .openapi({ example: "https://example.com/project" }),
-    clientId: z.string().optional().openapi({ example: "client_abc123" }),
+      .openapi({
+        description: "End date of the project.",
+        example: new Date("2024-06-30"),
+      }),
+    overview: z.string().optional().openapi({
+      description: "Brief overview of the project.",
+      example: "A comprehensive e-commerce solution for mobile devices.",
+    }),
+    projectCreatorType: z.enum(ROLES).openapi({
+      description: "Type of creator who made this project.",
+      example: "CREATIVE",
+    }),
+    clientId: z.string().optional().openapi({
+      description: "CUID2 of the client if this is a client project.",
+      example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    clientType: z.enum(CLIENT_TYPES).optional().openapi({
+      description: "Type of client for this project.",
+      example: "BRAND",
+    }),
+    clientName: z.string().optional().openapi({
+      description: "Name of the client.",
+      example: "Acme Corp",
+    }),
+    id: z.string().openapi({
+      description: "CUID2 of the project.",
+      example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    isFeatured: z.boolean().optional().openapi({
+      description: "Whether the project is featured.",
+      example: true,
+    }),
+    createdAt: z.coerce.date().openapi({
+      description: "Timestamp when the project was created.",
+      example: new Date("2024-01-01T00:00:00.000Z"),
+    }),
+    updatedAt: z.coerce.date().openapi({
+      description: "Timestamp when the project was last updated.",
+      example: new Date("2024-06-30T00:00:00.000Z"),
+    }),
+    userId: z.string().openapi({
+      description: "CUID2 of the user who created the project.",
+      example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    searchVector: z.string().openapi({
+      description: "Search vector for full-text search indexing.",
+      example: "ecommerce mobile app react native",
+    }),
+  })
+  .openapi({
+    title: "Project DB Entity",
+    description: "Schema representing a project stored in the database.",
+  });
+
+export const CreateProjectSchema = z
+  .object({
+    userId: z.string().openapi({
+      description: "CUID2 of the user creating the project.",
+      example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    title: z.string().min(1).max(100).openapi({
+      description: "Title of the project, 1–100 characters.",
+      example: "E-commerce Mobile App",
+    }),
+    projectCreatorType: z.enum(ROLES).default(ROLES.CREATIVE).openapi({
+      description: "Type of creator who made this project.",
+      example: "CREATIVE",
+    }),
+    imagePlaceholderUrl: z.url().openapi({
+      description: "URL for the placeholder image of the project.",
+      example: "https://img.com",
+    }),
+    id: z.string().optional().openapi({
+      description: "CUID2 of the project.",
+      example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    description: z.string().optional().openapi({
+      description: "Detailed description of the project, max 1000 characters.",
+      example:
+        "A modern e-commerce mobile application built with React Native.",
+    }),
+    overview: z.string().optional().openapi({
+      description: "Brief overview of the project.",
+      example: "A comprehensive e-commerce solution for mobile devices.",
+    }),
+    url: z.string().optional().openapi({
+      description: "URL to the project or live demo.",
+      example: "https://example.com/project",
+    }),
+    clientId: z.string().optional().openapi({
+      description: "CUID2 of the client if this is a client project.",
+      example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
     clientType: z
-      .enum(Object.values(CLIENT_TYPES) as [ClientType, ...ClientType[]])
+      .enum(CLIENT_TYPES)
       .optional()
-      .openapi({ example: "BRAND" }),
-    clientName: z.string().optional().openapi({ example: "Nike" }),
-    projectCreatorType: z
-      .enum(Object.values(ROLES) as [Role, ...Role[]])
-      .openapi({ example: "CREATIVE" }),
+      .default(CLIENT_TYPES.NONE)
+      .openapi({
+        description: "Type of client for this project.",
+        example: "BRAND",
+      }),
+    clientName: z.string().optional().openapi({
+      description: "Name of the client.",
+      example: "Acme Corp",
+    }),
     tags: z
       .array(z.string())
       .optional()
-      .openapi({ example: ["branding", "logo"] }),
-    isFeatured: z.boolean().optional().openapi({ example: false }),
+      .openapi({
+        description: "Array of tags associated with the project.",
+        example: ["react-native", "e-commerce", "mobile"],
+      }),
+    searchVector: z.string().optional().openapi({
+      description: "Search vector for full-text search indexing.",
+      example: "ecommerce mobile app react native",
+    }),
+    isFeatured: z.boolean().optional().openapi({
+      description: "Whether the project is featured.",
+      example: true,
+    }),
     startDate: z.coerce
       .date()
       .optional()
-      .openapi({ example: "2025-06-01T00:00:00.000Z" }),
+      .openapi({
+        description: "Start date of the project.",
+        example: new Date("2024-01-01"),
+      }),
     endDate: z.coerce
       .date()
       .optional()
-      .openapi({ example: "2025-07-15T00:00:00.000Z" }),
-    imagePlaceholderUrl: z
-      .string()
-      .url()
+      .openapi({
+        description: "End date of the project.",
+        example: new Date("2024-06-30"),
+      }),
+    createdAt: z.coerce
+      .date()
+      .optional()
+      .openapi({
+        description: "Timestamp when the project was created.",
+        example: new Date("2024-01-01T00:00:00.000Z"),
+      }),
+    updatedAt: z.coerce
+      .date()
+      .optional()
+      .openapi({
+        description: "Timestamp when the project was last updated.",
+        example: new Date("2024-06-30T00:00:00.000Z"),
+      }),
+    files: z
+      .array(
+        CreateFileInputSchema.extend({
+          isPlaceholder: z.boolean().default(false),
+          order: z.number().int().default(1),
+        })
+      )
       .optional()
-      .openapi({ example: "https://example.com/project-image.png" }),
+      .openapi({
+        description: "Array of files/images for the project.",
+        example: [],
+      }),
   })
-  .openapi("ProjectEntity");
+  .openapi({
+    title: "Create Project",
+    description: "Schema for creating a new project.",
+  });
 
 export const ProjectFileEntitySchema = z
   .object({
-    id: z.cuid2().openapi({ example: "pfe_cksd0v6q0000s9a5y8z7p3x9" }),
-    projectId: z.cuid2().openapi({ example: "cksd0v6q0000s9a5y8z7p3x9" }),
-    url: z
-      .string()
-      .url()
-      .openapi({ example: "https://cdn.example.com/project/image.jpg" }),
-    mimeType: z.string().openapi({ example: "image/jpeg" }),
-    fileSize: z.number().int().positive().openapi({ example: 1500000 }), // size in bytes
+    isPlaceholder: z.boolean().openapi({
+      description: "Indicates whether the file is a placeholder.",
+      example: false,
+    }),
+    order: z.number().int().openapi({
+      description: "Order index of the file in the project.",
+      example: 1,
+    }),
+    projectId: z.string().openapi({
+      description: "CUID2 of the project this file belongs to.",
+      example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    id: z.string().openapi({
+      description: "CUID2 of the project file record.",
+      example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
+    fileId: z.string().openapi({
+      description: "CUID2 of the linked file.",
+      example: "ckl1y9xyz0000qv7a0h1efgh4",
+    }),
   })
-  .openapi("ProjectFileEntity");
+  .openapi({
+    title: "Project File Entity",
+    description: "Schema representing a file associated with a project.",
+  });
 
 export const ProjectSocialGraphEntitySchema = z
   .object({

package/src/types/project.ts

@@ -30,11 +30,6 @@ export type ProjectEntity = {
   endDate?: Date;
 };
 
-export type ProjectWithFilesEntity = ProjectEntity &
-  ProjectSocialGraphEntity & {
-    projectFiles?: ProjectFileEntity[];
-  };
-
 export type ProjectViewEntity = {
   id: string;
   userId?: string;
@@ -51,7 +46,6 @@ export type ProjectLikeEntity = {
   userId: string;
   projectId: string;
 };
-
 export type ProjectCommentEntity = {
   id: string;
   createdAt: Date;
@@ -60,17 +54,14 @@ export type ProjectCommentEntity = {
   parentCommentId?: string;
   content: string;
 };
-
 export type ProjectBookmarkEntity = {
   createdAt: Date;
   userId: string;
   projectId: string;
 };
-
 export type ProjectUpdateOutputEntity = {
   id: string;
 };
-
 export type MinimalProject = Pick<
   ProjectEntity,
   | "id"
@@ -86,13 +77,11 @@ 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 ProjectWithProjectFilesEntity = MinimalProject & {
+  projectFiles: (ProjectFileEntity & {
+    fileUrl: string;
+  })[];
+};
 
 export type ListProjectsInput = {
   query?: string;
@@ -105,16 +94,16 @@ export type ListProjectsInput = {
 
 export type ProjectWithProjectViewsEntity = MinimalProject & {
   views: ProjectViewEntity[];
-} & Partial<ProjectSocialGraphEntity>;
+};
 
 export type ProjectWithProjectCommentsEntity = MinimalProject & {
   comments: ProjectCommentEntity[];
-} & Partial<ProjectSocialGraphEntity>;
+};
 
 export type ProjectWithProjectLikesEntity = MinimalProject & {
   likes: ProjectLikeEntity[];
-} & Partial<ProjectSocialGraphEntity>;
+};
 
 export type ProjectWithProjectBookmarksEntity = MinimalProject & {
   bookmarks: ProjectBookmarkEntity[];
-} & Partial<ProjectSocialGraphEntity>;
+};