mvc-kit 2.12.5 → 2.13.1

package/examples/react/FullApp/src/mock/locations.ts

@@ -0,0 +1,76 @@
+import type { LocationState } from '../types/location';
+
+export const mockLocations: LocationState[] = [
+  {
+    id: 'loc1',
+    name: 'Downtown HQ',
+    type: 'office',
+    status: 'active',
+    city: 'New York',
+    state: 'NY',
+    address: '100 Broadway',
+    capacity: 250,
+    managerId: 'u1',
+    createdAt: '2024-01-01T00:00:00Z',
+  },
+  {
+    id: 'loc2',
+    name: 'West Warehouse',
+    type: 'warehouse',
+    status: 'active',
+    city: 'Chicago',
+    state: 'IL',
+    address: '500 Industrial Ave',
+    capacity: 800,
+    managerId: 'u2',
+    createdAt: '2024-02-01T00:00:00Z',
+  },
+  {
+    id: 'loc3',
+    name: 'Main Street Store',
+    type: 'retail',
+    status: 'active',
+    city: 'Los Angeles',
+    state: 'CA',
+    address: '220 Main St',
+    capacity: 50,
+    managerId: 'u5',
+    createdAt: '2024-03-01T00:00:00Z',
+  },
+  {
+    id: 'loc4',
+    name: 'North Office',
+    type: 'office',
+    status: 'maintenance',
+    city: 'Seattle',
+    state: 'WA',
+    address: '75 Pine St',
+    capacity: 120,
+    managerId: 'u7',
+    createdAt: '2024-04-01T00:00:00Z',
+  },
+  {
+    id: 'loc5',
+    name: 'East Distribution Center',
+    type: 'warehouse',
+    status: 'active',
+    city: 'Miami',
+    state: 'FL',
+    address: '1200 Port Blvd',
+    capacity: 1500,
+    managerId: 'u2',
+    createdAt: '2024-05-01T00:00:00Z',
+  },
+  {
+    id: 'loc6',
+    name: 'Harbor Retail',
+    type: 'retail',
+    status: 'inactive',
+    city: 'San Francisco',
+    state: 'CA',
+    address: '45 Pier Ave',
+    capacity: 40,
+    managerId: 'u5',
+    createdAt: '2024-06-01T00:00:00Z',
+  },
+];

package/examples/react/FullApp/src/mock/messages.ts

@@ -0,0 +1,237 @@
+import type { ConversationState } from '../types/conversation';
+import type { MessageState } from '../types/message';
+
+export const mockConversations: ConversationState[] = [
+  {
+    id: 'conv1',
+    participantIds: ['u1', 'u2'],
+    lastMessage: 'Sure, I will review the report today.',
+    lastMessageAt: '2024-07-10T14:30:00Z',
+    unreadCount: 2,
+  },
+  {
+    id: 'conv2',
+    participantIds: ['u1', 'u5'],
+    lastMessage: 'The new store layout looks great!',
+    lastMessageAt: '2024-07-10T11:15:00Z',
+    unreadCount: 0,
+  },
+  {
+    id: 'conv3',
+    participantIds: ['u2', 'u5', 'u6'],
+    lastMessage: 'Meeting moved to 3pm tomorrow.',
+    lastMessageAt: '2024-07-09T17:45:00Z',
+    unreadCount: 1,
+  },
+];
+
+export const mockMessages: MessageState[] = [
+  // conv1: Alice & Bob — extended conversation (~20 messages for Feed pagination)
+  {
+    id: 'msg-c1-01',
+    conversationId: 'conv1',
+    senderId: 'u1',
+    text: 'Good morning Bob! Quick question about the warehouse.',
+    sentAt: '2024-07-10T09:00:00Z',
+  },
+  {
+    id: 'msg-c1-02',
+    conversationId: 'conv1',
+    senderId: 'u2',
+    text: 'Morning Alice! What do you need?',
+    sentAt: '2024-07-10T09:05:00Z',
+  },
+  {
+    id: 'msg-c1-03',
+    conversationId: 'conv1',
+    senderId: 'u1',
+    text: 'Do we have the updated capacity numbers for the Chicago warehouse?',
+    sentAt: '2024-07-10T09:10:00Z',
+  },
+  {
+    id: 'msg-c1-04',
+    conversationId: 'conv1',
+    senderId: 'u2',
+    text: 'Let me check. I think the facilities team sent those over last week.',
+    sentAt: '2024-07-10T09:15:00Z',
+  },
+  {
+    id: 'msg-c1-05',
+    conversationId: 'conv1',
+    senderId: 'u2',
+    text: 'Found it — Chicago is at 85% capacity right now. They expanded the east wing.',
+    sentAt: '2024-07-10T09:25:00Z',
+  },
+  {
+    id: 'msg-c1-06',
+    conversationId: 'conv1',
+    senderId: 'u1',
+    text: 'That is higher than I expected. Are we planning any overflow to the Detroit facility?',
+    sentAt: '2024-07-10T09:30:00Z',
+  },
+  {
+    id: 'msg-c1-07',
+    conversationId: 'conv1',
+    senderId: 'u2',
+    text: 'Yeah, Frank mentioned routing some of the Q3 shipments there. I will get the details.',
+    sentAt: '2024-07-10T09:40:00Z',
+  },
+  {
+    id: 'msg-c1-08',
+    conversationId: 'conv1',
+    senderId: 'u1',
+    text: 'Perfect. Can you also pull the inventory report while you are at it?',
+    sentAt: '2024-07-10T09:45:00Z',
+  },
+  {
+    id: 'msg-c1-09',
+    conversationId: 'conv1',
+    senderId: 'u2',
+    text: 'Sure thing. I will have both ready by lunch.',
+    sentAt: '2024-07-10T09:50:00Z',
+  },
+  {
+    id: 'msg-c1-10',
+    conversationId: 'conv1',
+    senderId: 'u1',
+    text: 'Thanks Bob. Also, did the new barcode scanners arrive?',
+    sentAt: '2024-07-10T10:15:00Z',
+  },
+  {
+    id: 'msg-c1-11',
+    conversationId: 'conv1',
+    senderId: 'u2',
+    text: 'They came in yesterday. The team is setting them up now.',
+    sentAt: '2024-07-10T10:20:00Z',
+  },
+  {
+    id: 'msg-c1-12',
+    conversationId: 'conv1',
+    senderId: 'u1',
+    text: 'Great. Make sure the firmware is updated before they go live.',
+    sentAt: '2024-07-10T10:30:00Z',
+  },
+  {
+    id: 'msg-c1-13',
+    conversationId: 'conv1',
+    senderId: 'u2',
+    text: 'Already on it. IT is handling the firmware updates this afternoon.',
+    sentAt: '2024-07-10T10:45:00Z',
+  },
+  {
+    id: 'msg-c1-14',
+    conversationId: 'conv1',
+    senderId: 'u1',
+    text: 'One more thing — the safety inspection for the loading dock is next Tuesday.',
+    sentAt: '2024-07-10T11:00:00Z',
+  },
+  {
+    id: 'msg-c1-15',
+    conversationId: 'conv1',
+    senderId: 'u2',
+    text: 'Got it on the calendar. I will make sure the dock area is prepped.',
+    sentAt: '2024-07-10T11:15:00Z',
+  },
+  {
+    id: 'msg-c1-16',
+    conversationId: 'conv1',
+    senderId: 'u1',
+    text: 'How is the Chicago shipment going by the way?',
+    sentAt: '2024-07-10T13:00:00Z',
+  },
+  {
+    id: 'msg-c1-17',
+    conversationId: 'conv1',
+    senderId: 'u2',
+    text: 'Running a bit behind. Truck was delayed but should arrive by 3pm.',
+    sentAt: '2024-07-10T13:15:00Z',
+  },
+  {
+    id: 'msg-c1-18',
+    conversationId: 'conv1',
+    senderId: 'u1',
+    text: 'OK keep me posted. Hey did you get a chance to look at the warehouse inventory report?',
+    sentAt: '2024-07-10T14:00:00Z',
+  },
+  {
+    id: 'msg-c1-19',
+    conversationId: 'conv1',
+    senderId: 'u2',
+    text: 'Not yet, been busy with the Chicago shipment all morning.',
+    sentAt: '2024-07-10T14:10:00Z',
+  },
+  {
+    id: 'msg-c1-20',
+    conversationId: 'conv1',
+    senderId: 'u1',
+    text: 'No worries, just need it by end of week. Let me know if you have questions.',
+    sentAt: '2024-07-10T14:20:00Z',
+  },
+  {
+    id: 'msg-c1-21',
+    conversationId: 'conv1',
+    senderId: 'u2',
+    text: 'Sure, I will review the report today.',
+    sentAt: '2024-07-10T14:30:00Z',
+  },
+
+  // conv2: Alice & Eva
+  {
+    id: 'msg5',
+    conversationId: 'conv2',
+    senderId: 'u5',
+    text: 'Alice, I finished the floor plan for the new Main Street layout.',
+    sentAt: '2024-07-10T10:30:00Z',
+  },
+  {
+    id: 'msg6',
+    conversationId: 'conv2',
+    senderId: 'u1',
+    text: 'That was fast! Can you share the mockups?',
+    sentAt: '2024-07-10T10:45:00Z',
+  },
+  {
+    id: 'msg7',
+    conversationId: 'conv2',
+    senderId: 'u5',
+    text: 'Just uploaded them to the shared drive. Check the Locations folder.',
+    sentAt: '2024-07-10T11:00:00Z',
+  },
+  {
+    id: 'msg8',
+    conversationId: 'conv2',
+    senderId: 'u1',
+    text: 'The new store layout looks great!',
+    sentAt: '2024-07-10T11:15:00Z',
+  },
+
+  // conv3: Bob, Eva & Frank
+  {
+    id: 'msg9',
+    conversationId: 'conv3',
+    senderId: 'u2',
+    text: 'Team, we need to discuss the Q3 distribution plan.',
+    sentAt: '2024-07-09T16:00:00Z',
+  },
+  {
+    id: 'msg10',
+    conversationId: 'conv3',
+    senderId: 'u6',
+    text: 'I can put together the shipping estimates by tomorrow.',
+    sentAt: '2024-07-09T16:30:00Z',
+  },
+  {
+    id: 'msg11',
+    conversationId: 'conv3',
+    senderId: 'u5',
+    text: 'Great. Let us sync tomorrow afternoon then.',
+    sentAt: '2024-07-09T17:00:00Z',
+  },
+  {
+    id: 'msg12',
+    conversationId: 'conv3',
+    senderId: 'u2',
+    text: 'Meeting moved to 3pm tomorrow.',
+    sentAt: '2024-07-09T17:45:00Z',
+  },
+];

package/examples/react/FullApp/src/mock/users.ts

@@ -0,0 +1,84 @@
+import type { UserState } from '../types/user';
+
+export const mockUsers: UserState[] = [
+  {
+    id: 'u1',
+    firstName: 'Alice',
+    lastName: 'Johnson',
+    email: 'alice@example.com',
+    role: 'admin',
+    status: 'active',
+    avatarUrl: '',
+    createdAt: '2024-01-15T10:00:00Z',
+  },
+  {
+    id: 'u2',
+    firstName: 'Bob',
+    lastName: 'Smith',
+    email: 'bob@example.com',
+    role: 'manager',
+    status: 'active',
+    avatarUrl: '',
+    createdAt: '2024-02-20T14:30:00Z',
+  },
+  {
+    id: 'u3',
+    firstName: 'Carol',
+    lastName: 'Davis',
+    email: 'carol@example.com',
+    role: 'member',
+    status: 'active',
+    avatarUrl: '',
+    createdAt: '2024-03-10T09:15:00Z',
+  },
+  {
+    id: 'u4',
+    firstName: 'Dan',
+    lastName: 'Wilson',
+    email: 'dan@example.com',
+    role: 'member',
+    status: 'inactive',
+    avatarUrl: '',
+    createdAt: '2024-03-25T16:45:00Z',
+  },
+  {
+    id: 'u5',
+    firstName: 'Eva',
+    lastName: 'Martinez',
+    email: 'eva@example.com',
+    role: 'manager',
+    status: 'active',
+    avatarUrl: '',
+    createdAt: '2024-04-05T11:00:00Z',
+  },
+  {
+    id: 'u6',
+    firstName: 'Frank',
+    lastName: 'Brown',
+    email: 'frank@example.com',
+    role: 'member',
+    status: 'active',
+    avatarUrl: '',
+    createdAt: '2024-05-12T08:30:00Z',
+  },
+  {
+    id: 'u7',
+    firstName: 'Grace',
+    lastName: 'Lee',
+    email: 'grace@example.com',
+    role: 'admin',
+    status: 'active',
+    avatarUrl: '',
+    createdAt: '2024-06-01T13:20:00Z',
+  },
+  {
+    id: 'u8',
+    firstName: 'Henry',
+    lastName: 'Taylor',
+    email: 'henry@example.com',
+    role: 'member',
+    status: 'inactive',
+    avatarUrl: '',
+    createdAt: '2024-06-18T15:10:00Z',
+  },
+];

package/examples/react/FullApp/src/models/LocationFormModel.ts

@@ -0,0 +1,31 @@
+import { Model } from 'mvc-kit';
+import type { ValidationErrors } from 'mvc-kit';
+import type { LocationState } from '../types/location';
+
+export interface LocationFormState {
+  name: string;
+  type: LocationState['type'];
+  city: string;
+  state: string;
+  address: string;
+  capacity: number;
+}
+
+export class LocationFormModel extends Model<LocationFormState> {
+  setName(name: string) { this.set({ name }); }
+  setType(type: LocationFormState['type']) { this.set({ type }); }
+  setCity(city: string) { this.set({ city }); }
+  setStateName(state: string) { this.set({ state }); }
+  setAddress(address: string) { this.set({ address }); }
+  setCapacity(capacity: number) { this.set({ capacity }); }
+
+  protected validate(state: LocationFormState): ValidationErrors<LocationFormState> {
+    const errors: Partial<Record<keyof LocationFormState, string>> = {};
+    if (!state.name.trim()) errors.name = 'Name is required';
+    if (!state.city.trim()) errors.city = 'City is required';
+    if (!state.state.trim()) errors.state = 'State is required';
+    if (!state.address.trim()) errors.address = 'Address is required';
+    if (state.capacity <= 0) errors.capacity = 'Must be greater than 0';
+    return errors;
+  }
+}

package/examples/react/FullApp/src/models/LoginFormModel.ts

@@ -0,0 +1,19 @@
+import { Model } from 'mvc-kit';
+import type { ValidationErrors } from 'mvc-kit';
+
+export interface LoginFormState {
+  email: string;
+  password: string;
+}
+
+export class LoginFormModel extends Model<LoginFormState> {
+  setEmail(email: string) { this.set({ email }); }
+  setPassword(password: string) { this.set({ password }); }
+
+  protected validate(state: LoginFormState): ValidationErrors<LoginFormState> {
+    const errors: Partial<Record<keyof LoginFormState, string>> = {};
+    if (!state.email.includes('@')) errors.email = 'Valid email required';
+    if (state.password.length < 6) errors.password = 'Must be at least 6 characters';
+    return errors;
+  }
+}

package/examples/react/FullApp/src/resources/UsersResource.ts

@@ -0,0 +1,12 @@
+import { Resource, singleton } from 'mvc-kit';
+import type { UserState } from '../types/user';
+import { UserService } from '../services/UserService';
+
+export class UsersResource extends Resource<UserState> {
+  private api = singleton(UserService);
+
+  async loadAll() {
+    const data = await this.api.getAll(this.disposeSignal);
+    this.reset(data);
+  }
+}

package/examples/react/FullApp/src/services/AuthService.ts

@@ -0,0 +1,18 @@
+import { Service, HttpError } from 'mvc-kit';
+import type { UserState } from '../types/user';
+import { mockUsers } from '../mock/users';
+import { mockFetch } from '../mock/delay';
+
+export class AuthService extends Service {
+  async login(email: string, password: string, signal?: AbortSignal): Promise<UserState> {
+    if (!email.includes('@') || password.length < 6) {
+      throw new HttpError(401, 'Invalid credentials');
+    }
+    // Return Alice as the logged-in user
+    return mockFetch({ ...mockUsers[0] }, 400, signal);
+  }
+
+  async logout(signal?: AbortSignal): Promise<void> {
+    await mockFetch(undefined, 200, signal);
+  }
+}

package/examples/react/FullApp/src/services/LocationService.ts

@@ -0,0 +1,23 @@
+import { Service, HttpError } from 'mvc-kit';
+import type { LocationState } from '../types/location';
+import { mockLocations } from '../mock/locations';
+import { mockFetch } from '../mock/delay';
+
+export class LocationService extends Service {
+  async getAll(signal?: AbortSignal): Promise<LocationState[]> {
+    return mockFetch(mockLocations.map(l => ({ ...l })), 300, signal);
+  }
+
+  async getById(id: string, signal?: AbortSignal): Promise<LocationState> {
+    const location = mockLocations.find(l => l.id === id);
+    if (!location) throw new HttpError(404, 'Location not found');
+    return mockFetch({ ...location }, 200, signal);
+  }
+
+  async update(id: string, data: Partial<LocationState>, signal?: AbortSignal): Promise<LocationState> {
+    const idx = mockLocations.findIndex(l => l.id === id);
+    if (idx === -1) throw new HttpError(404, 'Location not found');
+    Object.assign(mockLocations[idx], data);
+    return mockFetch({ ...mockLocations[idx] }, 400, signal);
+  }
+}

package/examples/react/FullApp/src/services/MessageService.ts

@@ -0,0 +1,65 @@
+import { Service } from 'mvc-kit';
+import type { FeedPage } from 'mvc-kit';
+import type { ConversationState } from '../types/conversation';
+import type { MessageState } from '../types/message';
+import { mockConversations, mockMessages } from '../mock/messages';
+import { mockFetch } from '../mock/delay';
+
+export class MessageService extends Service {
+  async getConversations(userId: string, signal?: AbortSignal): Promise<ConversationState[]> {
+    const conversations = mockConversations
+      .filter(c => c.participantIds.includes(userId))
+      .map(c => ({ ...c }));
+    return mockFetch(conversations, 300, signal);
+  }
+
+  async getMessages(
+    conversationId: string,
+    signal?: AbortSignal,
+    options?: { cursor?: string | null; limit?: number },
+  ): Promise<FeedPage<MessageState>> {
+    const limit = options?.limit ?? 8;
+
+    // All messages for this conversation, sorted newest-first
+    let messages = mockMessages
+      .filter(m => m.conversationId === conversationId)
+      .sort((a, b) => new Date(b.sentAt).getTime() - new Date(a.sentAt).getTime());
+
+    // If cursor provided, filter to messages older than cursor
+    if (options?.cursor) {
+      const cursorTime = new Date(options.cursor).getTime();
+      messages = messages.filter(m => new Date(m.sentAt).getTime() < cursorTime);
+    }
+
+    const page = messages.slice(0, limit).map(m => ({ ...m }));
+    const hasMore = messages.length > limit;
+    const cursor = page.length > 0 ? page[page.length - 1].sentAt : null;
+
+    return mockFetch({ items: page, hasMore, cursor }, 250, signal);
+  }
+
+  async sendMessage(
+    conversationId: string,
+    senderId: string,
+    text: string,
+    signal?: AbortSignal,
+  ): Promise<MessageState> {
+    const message: MessageState = {
+      id: `msg-${Date.now()}`,
+      conversationId,
+      senderId,
+      text,
+      sentAt: new Date().toISOString(),
+    };
+    mockMessages.push(message);
+
+    // Update conversation's last message
+    const conv = mockConversations.find(c => c.id === conversationId);
+    if (conv) {
+      conv.lastMessage = text;
+      conv.lastMessageAt = message.sentAt;
+    }
+
+    return mockFetch(message, 200, signal);
+  }
+}

package/examples/react/FullApp/src/services/UserService.ts

@@ -0,0 +1,23 @@
+import { Service, HttpError } from 'mvc-kit';
+import type { UserState } from '../types/user';
+import { mockUsers } from '../mock/users';
+import { mockFetch } from '../mock/delay';
+
+export class UserService extends Service {
+  async getAll(signal?: AbortSignal): Promise<UserState[]> {
+    return mockFetch(mockUsers.map(u => ({ ...u })), 300, signal);
+  }
+
+  async getById(id: string, signal?: AbortSignal): Promise<UserState> {
+    const user = mockUsers.find(u => u.id === id);
+    if (!user) throw new HttpError(404, 'User not found');
+    return mockFetch({ ...user }, 200, signal);
+  }
+
+  async update(id: string, data: Partial<UserState>, signal?: AbortSignal): Promise<UserState> {
+    const idx = mockUsers.findIndex(u => u.id === id);
+    if (idx === -1) throw new HttpError(404, 'User not found');
+    Object.assign(mockUsers[idx], data);
+    return mockFetch({ ...mockUsers[idx] }, 300, signal);
+  }
+}