@unedio/types 0.0.1

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@unedio/types",
+  "version": "0.0.1",
+  "main": "src/index.ts",
+  "dependencies": {
+    "@hono/zod-openapi": "^1.2.0",
+    "@supabase/supabase-js": "^2.89.0",
+    "@google/generative-ai": "^0.24.1",
+    "jose": "^6.1.3",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/types/api.types.ts

@@ -0,0 +1,423 @@
+/**
+ * API Request and Response types
+ */
+
+import { BillingPlanDetails } from '../utils/stripe';
+
+import {
+  ApplicationStatus,
+  Client,
+  Contact,
+  EmailTemplate,
+  Job,
+  JobApplication,
+  JobApplicationComment,
+  JobApplicationHistory,
+  Note,
+  Plan,
+  SavedCandidate,
+  SeekerProfile,
+  Subscription,
+  User,
+  Workspace,
+  WorkspaceBranding,
+} from './database.types';
+
+export type { Contact } from './database.types';
+
+import {
+  EmailTemplateType,
+  ErrorCode,
+  JobStatus,
+  JobType,
+  UserType,
+  WorkModality,
+  WorkspaceUserRole,
+} from './enums';
+
+// ============================================================================
+// COMMON TYPES
+// ============================================================================
+
+export interface PaginationParams {
+  page?: number;
+  limit?: number;
+  search?: string;
+}
+
+export interface PaginationMeta {
+  page: number;
+  limit: number;
+  total: number;
+  totalPages: number;
+}
+
+export interface ApiResponse<T> {
+  data: T;
+  meta?: PaginationMeta;
+}
+
+export interface ApiError {
+  message: string;
+  code: ErrorCode | string;
+  details: any;
+}
+
+// ============================================================================
+// AUTH
+// ============================================================================
+
+export interface LoginRequest {
+  email: string;
+  password: string;
+}
+
+export interface RegisterRequest {
+  email: string;
+  password: string;
+  name: string;
+  type: UserType;
+}
+
+export interface AuthResponse {
+  user: User;
+  session: {
+    access_token: string;
+    refresh_token: string;
+  };
+}
+
+// ============================================================================
+// USERS
+// ============================================================================
+
+export interface UpdateUserRequest {
+  name?: string;
+  avatarUrl?: string;
+}
+
+// Basic user info for public profiles/lists
+export type PublicUserResponse = Pick<User, 'id' | 'email' | 'name' | 'avatar_url'>;
+
+export type UserResponse = Omit<User, 'external_id'>;
+
+export type AuthUserResponse = UserResponse & {
+  workspace?: (WorkspaceResponse & { role: WorkspaceUserRole }) | null;
+};
+
+// ============================================================================
+// SEEKER PROFILES
+// ============================================================================
+
+export interface UpdateSeekerProfileRequest {
+  fullName?: string;
+  phone?: string;
+  linkedinUrl?: string;
+  city?: string;
+  country?: string;
+  summary?: string;
+  skills?: string[];
+  experienceYears?: number;
+}
+
+export interface SearchSeekersRequest extends PaginationParams {
+  skills?: string[];
+  city?: string;
+  country?: string;
+  minExperience?: number;
+  maxExperience?: number;
+}
+
+export type SeekerProfileResponse = Omit<SeekerProfile, 'last_placed_at_client_id'> & {
+  user: PublicUserResponse;
+};
+
+// ============================================================================
+// WORKSPACES
+// ============================================================================
+
+export interface CreateWorkspaceRequest {
+  name: string;
+  domain?: string;
+  subdomain?: string;
+  workspaceMode?: 'company' | 'agency';
+  language: string;
+}
+
+export interface UpdateWorkspaceRequest {
+  name?: string;
+  domain?: string;
+  customDomainStatus?: string;
+  workspaceMode?: 'company' | 'agency';
+  language?: string;
+}
+
+export interface InviteUserRequest {
+  email: string;
+  role: WorkspaceUserRole;
+}
+
+export type WorkspaceResponse = Workspace & {
+  branding?: BrandingResponse;
+  subscription?: Subscription;
+  membersCount?: number;
+};
+
+export interface ClientResponse extends Client {
+  contacts?: ContactResponse[];
+  notes?: NoteResponse[];
+}
+
+export type ContactResponse = Contact;
+
+export interface WorkspaceMemberResponse {
+  id: string;
+  user: PublicUserResponse;
+  role: WorkspaceUserRole;
+  created_at: string;
+}
+
+// ============================================================================
+// WORKSPACE BRANDING
+// ============================================================================
+
+export interface UpdateBrandingRequest {
+  primaryColor?: string;
+  secondaryColor?: string;
+  fontFamily?: string;
+  logoUrl?: string;
+  faviconUrl?: string;
+}
+
+export type BrandingResponse = Omit<WorkspaceBranding, 'workspace_id'>;
+
+// ============================================================================
+// JOBS
+// ============================================================================
+
+export interface CreateJobRequest {
+  title: string;
+  description: string;
+  workModality?: WorkModality;
+  jobType?: JobType;
+  location?: string;
+  salaryRange?: string;
+  status?: JobStatus;
+}
+
+export interface UpdateJobRequest {
+  title?: string;
+  description?: string;
+  workModality?: WorkModality;
+  jobType?: JobType;
+  location?: string;
+  salaryRange?: string;
+  status?: JobStatus;
+}
+
+export interface ListJobsRequest extends PaginationParams {
+  status?: JobStatus;
+  workModality?: WorkModality;
+  jobType?: JobType;
+  search?: string;
+}
+
+export type JobResponse = Job & {
+  workspace: Pick<Workspace, 'id' | 'name' | 'subdomain'>;
+  recruiter?: PublicUserResponse;
+  client?: Pick<Client, 'id' | 'name'>;
+  contact?: Pick<Contact, 'id' | 'full_name' | 'email'>;
+  applicationsCount?: number;
+  viewsCount?: number;
+};
+
+export interface JobStatsResponse {
+  total_views: number;
+  total_applications: number;
+  views_by_source: Record<string, number>;
+  applications_by_source: Record<string, number>;
+  applications_by_status: Record<string, number>;
+}
+
+// ============================================================================
+// APPLICATIONS
+// ============================================================================
+
+export interface CreateApplicationRequest {
+  jobId: string;
+  source?: string;
+}
+
+export interface UpdateApplicationRequest {
+  statusId?: string;
+}
+
+export interface ListApplicationsRequest extends PaginationParams {
+  jobId?: string;
+  statusId?: string;
+  search?: string;
+}
+
+export type ApplicationResponse = JobApplication & {
+  job: Pick<Job, 'id' | 'title'>;
+  seeker: SeekerProfileResponse;
+  status?: ApplicationStatus;
+  commentsCount?: number;
+};
+
+// ============================================================================
+// APPLICATION STATUSES
+// ============================================================================
+
+export interface CreateStatusRequest {
+  statusName: string;
+  order?: number;
+}
+
+export interface UpdateStatusRequest {
+  statusName?: string;
+  order?: number;
+}
+
+export interface ReorderStatusesRequest {
+  statuses: { id: string; order: number }[];
+}
+
+export type StatusResponse = ApplicationStatus;
+
+// ============================================================================
+// COMMENTS
+// ============================================================================
+
+export interface CreateCommentRequest {
+  commentText: string;
+}
+
+export type CommentResponse = Omit<JobApplicationComment, 'job_application_id' | 'user_id'> & {
+  user: PublicUserResponse;
+};
+
+// ============================================================================
+// HISTORY
+// ============================================================================
+
+export type HistoryResponse = Omit<JobApplicationHistory, 'job_application_id' | 'actor_id'> & {
+  actor?: Pick<User, 'id' | 'name' | 'email'>;
+};
+
+// ============================================================================
+// NOTES
+// ============================================================================
+
+export interface CreateNoteRequest {
+  content: string;
+  seekerId?: string;
+  jobId?: string;
+  clientId?: string;
+  contactId?: string;
+}
+
+export type NoteResponse = Note & {
+  author?: PublicUserResponse;
+};
+
+// ============================================================================
+// EMAIL TEMPLATES
+// ============================================================================
+
+export interface CreateTemplateRequest {
+  name: string;
+  subject: string;
+  bodyText: string;
+  type: EmailTemplateType;
+}
+
+export interface UpdateTemplateRequest {
+  name?: string;
+  subject?: string;
+  bodyText?: string;
+}
+
+export interface SendEmailRequest {
+  to: string;
+  variables?: Record<string, string>;
+}
+
+export type TemplateResponse = EmailTemplate;
+
+// ============================================================================
+// SAVED CANDIDATES
+// ============================================================================
+
+export interface SaveCandidateRequest {
+  seekerId: string;
+  notes?: string;
+}
+
+export interface UpdateSavedCandidateRequest {
+  notes?: string;
+}
+
+export type SavedCandidateResponse = Omit<SavedCandidate, 'added_by'> & {
+  seeker: SeekerProfileResponse;
+  added_by_user?: PublicUserResponse;
+};
+
+// ============================================================================
+// SUBSCRIPTIONS & PLANS
+// ============================================================================
+
+export interface CreateSubscriptionRequest {
+  planId: string;
+  paymentMethodId?: string;
+}
+
+export type PlanResponse = BillingPlanDetails;
+
+export type SubscriptionResponse = Subscription & {
+  plan: Plan | null;
+};
+
+export interface WorkspaceAccessState {
+  read_only: boolean;
+  public_portal_active: boolean;
+  billing_required: boolean;
+  trial_ends_at: string | null;
+  subscription_status: Subscription['status'] | 'none';
+}
+
+export interface WorkspaceSubscriptionResponse {
+  subscription: Subscription | null;
+  limits: {
+    max_jobs: number;
+    max_applications_per_job: number;
+  };
+  plan_details: BillingPlanDetails | null;
+  access: WorkspaceAccessState;
+}
+
+export interface WorkspaceUsageResponse {
+  limits: {
+    max_jobs: number;
+    max_applications_per_job: number;
+  };
+  usage: {
+    jobs: number;
+  };
+  canCreateJob: boolean;
+  access: WorkspaceAccessState;
+  plan_details: BillingPlanDetails | null;
+}
+
+// ============================================================================
+// WAITLIST
+// ============================================================================
+
+export interface WaitlistRequest {
+  email: string;
+}
+
+export interface WaitlistResponse {
+  email: string;
+  created_at: string;
+}