@shadowob/shared 0.1.1

package/__tests__/constants.test.ts

@@ -0,0 +1,69 @@
+import { describe, expect, it } from 'vitest'
+import { CLIENT_EVENTS, SERVER_EVENTS } from '../src/constants/events'
+import { LIMITS } from '../src/constants/limits'
+
+describe('CLIENT_EVENTS', () => {
+  it('should have all expected client events', () => {
+    expect(CLIENT_EVENTS.CHANNEL_JOIN).toBe('channel:join')
+    expect(CLIENT_EVENTS.CHANNEL_LEAVE).toBe('channel:leave')
+    expect(CLIENT_EVENTS.MESSAGE_SEND).toBe('message:send')
+    expect(CLIENT_EVENTS.MESSAGE_TYPING).toBe('message:typing')
+    expect(CLIENT_EVENTS.PRESENCE_UPDATE).toBe('presence:update')
+  })
+
+  it('should be readonly', () => {
+    const events = CLIENT_EVENTS
+    expect(Object.keys(events)).toHaveLength(5)
+  })
+})
+
+describe('SERVER_EVENTS', () => {
+  it('should have all expected server events', () => {
+    expect(SERVER_EVENTS.MESSAGE_NEW).toBe('message:new')
+    expect(SERVER_EVENTS.MESSAGE_UPDATE).toBe('message:update')
+    expect(SERVER_EVENTS.MESSAGE_DELETE).toBe('message:delete')
+    expect(SERVER_EVENTS.MEMBER_TYPING).toBe('member:typing')
+    expect(SERVER_EVENTS.MEMBER_JOIN).toBe('member:join')
+    expect(SERVER_EVENTS.MEMBER_LEAVE).toBe('member:leave')
+    expect(SERVER_EVENTS.PRESENCE_CHANGE).toBe('presence:change')
+    expect(SERVER_EVENTS.REACTION_ADD).toBe('reaction:add')
+    expect(SERVER_EVENTS.REACTION_REMOVE).toBe('reaction:remove')
+    expect(SERVER_EVENTS.NOTIFICATION_NEW).toBe('notification:new')
+    expect(SERVER_EVENTS.DM_MESSAGE_NEW).toBe('dm:message:new')
+  })
+
+  it('should have 11 server events', () => {
+    expect(Object.keys(SERVER_EVENTS)).toHaveLength(11)
+  })
+})
+
+describe('LIMITS', () => {
+  it('should define message limits', () => {
+    expect(LIMITS.MESSAGE_CONTENT_MAX).toBe(4000)
+    expect(LIMITS.MESSAGES_PER_PAGE).toBe(50)
+  })
+
+  it('should define username limits', () => {
+    expect(LIMITS.USERNAME_MIN).toBe(3)
+    expect(LIMITS.USERNAME_MAX).toBe(32)
+  })
+
+  it('should define file upload limit', () => {
+    expect(LIMITS.FILE_UPLOAD_MAX_SIZE).toBe(10 * 1024 * 1024)
+  })
+
+  it('should define server/channel limits', () => {
+    expect(LIMITS.SERVER_NAME_MAX).toBe(100)
+    expect(LIMITS.CHANNEL_NAME_MAX).toBe(100)
+    expect(LIMITS.SERVERS_PER_USER_MAX).toBe(100)
+    expect(LIMITS.CHANNELS_PER_SERVER_MAX).toBe(200)
+  })
+
+  it('should define invite code length', () => {
+    expect(LIMITS.INVITE_CODE_LENGTH).toBe(8)
+  })
+
+  it('should define password min length', () => {
+    expect(LIMITS.PASSWORD_MIN).toBe(8)
+  })
+})

package/__tests__/utils.test.ts

@@ -0,0 +1,80 @@
+import { describe, expect, it } from 'vitest'
+import { formatDate, generateInviteCode, isValidEmail, slugify } from '../src/utils'
+
+describe('generateInviteCode', () => {
+  it('should generate a string of length 8', () => {
+    const code = generateInviteCode()
+    expect(code).toHaveLength(8)
+  })
+
+  it('should only contain alphanumeric characters', () => {
+    const code = generateInviteCode()
+    expect(code).toMatch(/^[A-Za-z0-9]+$/)
+  })
+
+  it('should generate unique codes', () => {
+    const codes = new Set(Array.from({ length: 100 }, () => generateInviteCode()))
+    expect(codes.size).toBe(100)
+  })
+})
+
+describe('formatDate', () => {
+  it('should format a Date object to ISO string', () => {
+    const date = new Date('2024-01-15T12:30:00Z')
+    expect(formatDate(date)).toBe('2024-01-15T12:30:00.000Z')
+  })
+
+  it('should format a date string to ISO string', () => {
+    const result = formatDate('2024-01-15T12:30:00Z')
+    expect(result).toBe('2024-01-15T12:30:00.000Z')
+  })
+
+  it('should handle various date string formats', () => {
+    const result = formatDate('2024-01-15')
+    expect(result).toContain('2024-01-15')
+  })
+})
+
+describe('isValidEmail', () => {
+  it('should return true for valid emails', () => {
+    expect(isValidEmail('user@example.com')).toBe(true)
+    expect(isValidEmail('first.last@domain.org')).toBe(true)
+    expect(isValidEmail('user+tag@sub.domain.com')).toBe(true)
+  })
+
+  it('should return false for invalid emails', () => {
+    expect(isValidEmail('')).toBe(false)
+    expect(isValidEmail('user')).toBe(false)
+    expect(isValidEmail('user@')).toBe(false)
+    expect(isValidEmail('@domain.com')).toBe(false)
+    expect(isValidEmail('user @domain.com')).toBe(false)
+    expect(isValidEmail('user@domain')).toBe(false)
+  })
+})
+
+describe('slugify', () => {
+  it('should convert text to lowercase slug', () => {
+    expect(slugify('Hello World')).toBe('hello-world')
+  })
+
+  it('should replace special characters with hyphens', () => {
+    expect(slugify('Hello, World!')).toBe('hello-world')
+  })
+
+  it('should trim leading/trailing hyphens', () => {
+    expect(slugify('  Hello World  ')).toBe('hello-world')
+    expect(slugify('---hello---')).toBe('hello')
+  })
+
+  it('should handle multiple consecutive special characters', () => {
+    expect(slugify('hello...world')).toBe('hello-world')
+  })
+
+  it('should keep numbers', () => {
+    expect(slugify('Version 2.0')).toBe('version-2-0')
+  })
+
+  it('should handle empty string', () => {
+    expect(slugify('')).toBe('')
+  })
+})

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@shadowob/shared",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./types": "./src/types/index.ts",
+    "./constants": "./src/constants/index.ts",
+    "./utils": "./src/utils/index.ts"
+  },
+  "dependencies": {
+    "nanoid": "^5.1.5"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/constants/events.ts

@@ -0,0 +1,28 @@
+// ─── Client → Server ───
+
+export const CLIENT_EVENTS = {
+  CHANNEL_JOIN: 'channel:join',
+  CHANNEL_LEAVE: 'channel:leave',
+  MESSAGE_SEND: 'message:send',
+  MESSAGE_TYPING: 'message:typing',
+  PRESENCE_UPDATE: 'presence:update',
+} as const
+
+// ─── Server → Client ───
+
+export const SERVER_EVENTS = {
+  MESSAGE_NEW: 'message:new',
+  MESSAGE_UPDATE: 'message:update',
+  MESSAGE_DELETE: 'message:delete',
+  MEMBER_TYPING: 'member:typing',
+  MEMBER_JOIN: 'member:join',
+  MEMBER_LEAVE: 'member:leave',
+  PRESENCE_CHANGE: 'presence:change',
+  REACTION_ADD: 'reaction:add',
+  REACTION_REMOVE: 'reaction:remove',
+  NOTIFICATION_NEW: 'notification:new',
+  DM_MESSAGE_NEW: 'dm:message:new',
+} as const
+
+export type ClientEvent = (typeof CLIENT_EVENTS)[keyof typeof CLIENT_EVENTS]
+export type ServerEvent = (typeof SERVER_EVENTS)[keyof typeof SERVER_EVENTS]

package/src/constants/index.ts

@@ -0,0 +1,2 @@
+export * from './events'
+export * from './limits'

package/src/constants/limits.ts

@@ -0,0 +1,30 @@
+export const LIMITS = {
+  /** Max message content length */
+  MESSAGE_CONTENT_MAX: 4000,
+  /** Max username length */
+  USERNAME_MAX: 32,
+  /** Min username length */
+  USERNAME_MIN: 3,
+  /** Max display name length */
+  DISPLAY_NAME_MAX: 64,
+  /** Max server name length */
+  SERVER_NAME_MAX: 100,
+  /** Max channel name length */
+  CHANNEL_NAME_MAX: 100,
+  /** Max thread name length */
+  THREAD_NAME_MAX: 100,
+  /** Max file upload size (10MB) */
+  FILE_UPLOAD_MAX_SIZE: 10 * 1024 * 1024,
+  /** Messages per page (cursor pagination) */
+  MESSAGES_PER_PAGE: 50,
+  /** Max servers per user */
+  SERVERS_PER_USER_MAX: 100,
+  /** Max channels per server */
+  CHANNELS_PER_SERVER_MAX: 200,
+  /** Invite code length */
+  INVITE_CODE_LENGTH: 8,
+  /** Password min length */
+  PASSWORD_MIN: 8,
+  /** Max reactions per message per user */
+  REACTIONS_PER_MESSAGE_MAX: 20,
+} as const

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './constants'
+export * from './types'
+export * from './utils'

package/src/types/agent.types.ts

@@ -0,0 +1,44 @@
+export type AgentStatus = 'running' | 'stopped' | 'error'
+
+export type AgentKernelType = 'claude-code' | 'cursor' | 'mcp-server' | 'custom'
+
+export type AgentCapability =
+  | 'chat'
+  | 'code-gen'
+  | 'code-review'
+  | 'research'
+  | 'tools'
+  | 'file-access'
+
+export interface Agent {
+  id: string
+  userId: string
+  kernelType: AgentKernelType
+  config: Record<string, unknown>
+  containerId: string | null
+  status: AgentStatus
+  ownerId: string
+  createdAt: string
+  updatedAt: string
+  user?: {
+    id: string
+    username: string
+    displayName: string
+    avatarUrl: string | null
+  }
+  capabilities?: AgentCapability[]
+}
+
+export interface CreateAgentRequest {
+  name: string
+  kernelType: AgentKernelType
+  config?: Record<string, unknown>
+}
+
+export interface AgentInfo {
+  id: string
+  name: string
+  kernelType: AgentKernelType
+  status: AgentStatus
+  capabilities: AgentCapability[]
+}

package/src/types/channel.types.ts

@@ -0,0 +1,24 @@
+export type ChannelType = 'text' | 'voice' | 'announcement'
+
+export interface Channel {
+  id: string
+  name: string
+  type: ChannelType
+  serverId: string
+  topic: string | null
+  position: number
+  createdAt: string
+  updatedAt: string
+}
+
+export interface CreateChannelRequest {
+  name: string
+  type?: ChannelType
+  topic?: string
+}
+
+export interface UpdateChannelRequest {
+  name?: string
+  topic?: string
+  position?: number
+}

package/src/types/index.ts

@@ -0,0 +1,5 @@
+export * from './agent.types'
+export * from './channel.types'
+export * from './message.types'
+export * from './server.types'
+export * from './user.types'

package/src/types/message.types.ts

@@ -0,0 +1,89 @@
+export interface Message {
+  id: string
+  content: string
+  channelId: string
+  authorId: string
+  threadId: string | null
+  replyToId: string | null
+  isEdited: boolean
+  isPinned: boolean
+  createdAt: string
+  updatedAt: string
+  author?: {
+    id: string
+    username: string
+    displayName: string
+    avatarUrl: string | null
+    isBot: boolean
+  }
+  attachments?: Attachment[]
+  reactions?: ReactionGroup[]
+}
+
+export interface Attachment {
+  id: string
+  messageId: string
+  filename: string
+  url: string
+  contentType: string
+  size: number
+  width: number | null
+  height: number | null
+  createdAt: string
+}
+
+export interface ReactionGroup {
+  emoji: string
+  count: number
+  userIds: string[]
+}
+
+export interface Thread {
+  id: string
+  name: string
+  channelId: string
+  parentMessageId: string
+  creatorId: string
+  isArchived: boolean
+  createdAt: string
+  updatedAt: string
+}
+
+export interface SendMessageRequest {
+  content: string
+  threadId?: string
+  replyToId?: string
+}
+
+export interface UpdateMessageRequest {
+  content: string
+}
+
+export type NotificationType = 'mention' | 'reply' | 'dm' | 'system'
+
+export interface Notification {
+  id: string
+  userId: string
+  type: NotificationType
+  title: string
+  body: string | null
+  referenceId: string | null
+  referenceType: string | null
+  isRead: boolean
+  createdAt: string
+}
+
+export interface DmChannel {
+  id: string
+  userAId: string
+  userBId: string
+  lastMessageAt: string | null
+  createdAt: string
+  otherUser?: {
+    id: string
+    username: string
+    displayName: string
+    avatarUrl: string | null
+    status: string
+  }
+}

package/src/types/server.types.ts

@@ -0,0 +1,38 @@
+export interface Server {
+  id: string
+  name: string
+  iconUrl: string | null
+  ownerId: string
+  inviteCode: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface CreateServerRequest {
+  name: string
+  iconUrl?: string
+}
+
+export interface UpdateServerRequest {
+  name?: string
+  iconUrl?: string
+}
+
+export type MemberRole = 'owner' | 'admin' | 'member'
+
+export interface Member {
+  id: string
+  userId: string
+  serverId: string
+  role: MemberRole
+  nickname: string | null
+  joinedAt: string
+  user?: {
+    id: string
+    username: string
+    displayName: string
+    avatarUrl: string | null
+    status: string
+    isBot: boolean
+  }
+}

package/src/types/user.types.ts

@@ -0,0 +1,40 @@
+export type UserStatus = 'online' | 'idle' | 'dnd' | 'offline'
+
+export interface User {
+  id: string
+  email: string
+  username: string
+  displayName: string
+  avatarUrl: string | null
+  status: UserStatus
+  isBot: boolean
+  createdAt: string
+  updatedAt: string
+}
+
+export interface UserProfile {
+  id: string
+  username: string
+  displayName: string
+  avatarUrl: string | null
+  status: UserStatus
+  isBot: boolean
+}
+
+export interface LoginRequest {
+  email: string
+  password: string
+}
+
+export interface RegisterRequest {
+  email: string
+  username: string
+  displayName: string
+  password: string
+}
+
+export interface AuthResponse {
+  user: User
+  accessToken: string
+  refreshToken: string
+}

package/src/utils/index.ts

@@ -0,0 +1,21 @@
+import { customAlphabet } from 'nanoid'
+
+const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'
+
+export const generateInviteCode = customAlphabet(alphabet, 8)
+
+export function formatDate(date: string | Date): string {
+  const d = typeof date === 'string' ? new Date(date) : date
+  return d.toISOString()
+}
+
+export function isValidEmail(email: string): boolean {
+  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)
+}
+
+export function slugify(text: string): string {
+  return text
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist"
+  },
+  "include": ["src"]
+}