@foru-ms/sdk 0.1.0 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Foru.ms
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,189 @@
+# @foru-ms/sdk
+
+The official JavaScript/TypeScript SDK for [Foru.ms](https://foru.ms). Build powerful community features directly into your application.
+
+This SDK is fully typed and provides a comprehensive interface to the Foru.ms API.
+
+## Installation
+
+```bash
+npm install @foru-ms/sdk
+# or
+yarn add @foru-ms/sdk
+# or
+pnpm add @foru-ms/sdk
+```
+
+## Setup & Initialization
+
+```typescript
+import { ForumClient } from '@foru-ms/sdk';
+
+const client = new ForumClient({
+  apiKey: 'your_api_key',
+  // baseUrl: 'https://api.foru.ms/v1' // Optional
+});
+
+// Set an authentication token (JWT) for user-scoped requests
+client.setToken('user_jwt_token');
+```
+
+## API Reference
+
+### Auth (`client.auth`)
+
+*   `login(payload: { login: string; password: string })`: Login a user. Returns `{ token: string }`.
+*   `register(payload: RegisterPayload)`: Register a new user.
+*   `me()`: Get specific details of the currently authenticated user.
+*   `forgotPassword(email: string)`: Initiate password reset flow.
+*   `resetPassword(payload: { password: string; oldPassword?: string; email?: string; token?: string })`: Reset password using token or old password.
+
+### Threads (`client.threads`)
+
+*   `list(params: { limit?: number; filter?: 'newest' | 'oldest'; tagId?: string; categoryId?: string; cursor?: string })`: List threads.
+*   `create(payload: CreateThreadPayload)`: Create a new thread.
+*   `retrieve(id: string)`: Get a thread by ID.
+*   `update(id: string, payload: UpdateThreadPayload)`: Update a thread.
+*   `delete(id: string)`: Delete a thread.
+*   `getPosts(id: string, params: { cursor?: string; filter?: 'newest' | 'oldest' })`: Get posts in a thread.
+*   `like(id: string, userId: string, extendedData?: any)`: Like a thread.
+*   `unlike(id: string, userId: string)`: Unlike a thread.
+*   `dislike(id: string, userId: string, extendedData?: any)`: Dislike a thread.
+*   `undislike(id: string, userId: string)`: Remove dislike from a thread.
+*   `subscribe(id: string, userId: string)`: Subscribe to a thread.
+*   `unsubscribe(id: string, userId: string)`: Unsubscribe from a thread.
+*   `vote(id: string, userId: string, optionId: string)`: Vote in a thread poll.
+*   `voteUpdate(id: string, userId: string, optionId: string)`: Change vote.
+*   `unvote(id: string, userId: string)`: Remove vote.
+
+### Posts (`client.posts`)
+
+*   `list(params: { limit?: number; cursor?: string; filter?: 'newest' | 'oldest'; threadId?: string })`: List posts (flat).
+*   `create(payload: CreatePostPayload)`: Create a reply.
+*   `retrieve(id: string)`: Get a post by ID.
+*   `update(id: string, payload: UpdatePostPayload)`: Update a post.
+*   `delete(id: string)`: Delete a post.
+*   `getChildren(id: string, params: { cursor?: string; filter?: 'newest' | 'oldest' })`: Get child posts (nested replies).
+*   `like(id: string, userId: string, extendedData?: any)`: Like a post.
+*   `unlike(id: string, userId: string)`: Unlike a post.
+*   `dislike(id: string, userId: string, extendedData?: any)`: Dislike a post.
+*   `undislike(id: string, userId: string)`: Remove dislike.
+*   `upvote(id: string, userId: string, extendedData?: any)`: Upvote a post.
+*   `unupvote(id: string, userId: string)`: Remove upvote.
+*   `downvote(id: string, userId: string, extendedData?: any)`: Downvote a post.
+*   `undownvote(id: string, userId: string)`: Remove downvote.
+
+### Users (`client.users`)
+
+*   `list(params: { query?: string; filter?: 'newest' | 'oldest'; cursor?: string })`: List users.
+*   `retrieve(id: string)`: Get user by ID.
+*   `create(payload: any)`: Create a user (Admin).
+*   `update(id: string, payload: any)`: Update a user.
+*   `delete(id: string)`: Delete a user.
+*   `getFollowers(id: string, params: { cursor?: string })`: Get user's followers.
+*   `getFollowing(id: string, params: { cursor?: string })`: Get who a user follows.
+*   `follow(id: string, followerId: string, extendedData?: any)`: Follow a user.
+*   `unfollow(id: string, followerId: string)`: Unfollow a user.
+
+### Tags (`client.tags`)
+
+*   `list(params: { query?: string; cursor?: string })`: List tags.
+*   `create(payload: { name: string; description?: string; color?: string; extendedData?: any })`: Create a tag.
+*   `retrieve(id: string, params?: { userId?: string })`: Get a tag.
+*   `update(id: string, payload: any)`: Update a tag.
+*   `delete(id: string)`: Delete a tag.
+*   `subscribe(id: string, userId: string)`: Subscribe to a tag.
+*   `unsubscribe(id: string, userId: string)`: Unsubscribe from a tag.
+*   `listSubscribed(params: { userId: string; cursor?: string })`: List tags a user is subscribed to.
+
+### Notifications (`client.notifications`)
+
+*   `list(params: { userId: string; read?: boolean; filter?: string; cursor?: string })`: List notifications.
+*   `markAllAsRead(userId: string, read?: boolean)`: Bulk update read status.
+*   `create(payload: any)`: Create a notification manually.
+*   `retrieve(id: string)`: Get a notification.
+*   `update(id: string, payload: { read: boolean })`: Update a notification.
+*   `delete(id: string)`: Delete a notification.
+
+### Search (`client.search`)
+
+*   `search(params: { query: string; type: 'threads' | 'posts' | 'users' | 'tags'; cursor?: string })`: Polymorphic search.
+
+### Webhooks (`client.webhooks`)
+
+*   `list()`: List webhooks.
+*   `create(payload: { name: string; url: string; events: string[] })`: Create a webhook.
+*   `retrieve(id: string)`: Get a webhook.
+*   `update(id: string, payload: any)`: Update a webhook.
+*   `delete(id: string)`: Delete a webhook.
+*   `getDeliveries(id: string, params: { cursor?: string })`: Get webhook delivery history.
+
+### Stats (`client.stats`)
+
+*   `get(params?: { filter?: string; threadCursor?: string; postCursor?: string; ... })`: Get instance statistics.
+
+### Integrations (`client.integrations`)
+
+*   `list()`: Get all configured integrations.
+*   `create(payload: { type: string; name: string; config: any })`: Configure an integration (Slack, Discord, etc.).
+*   `retrieve(id: string)`: Get integration details.
+*   `delete(id: string)`: Remove an integration.
+
+### Private Messages (`client.privateMessages`)
+
+*   `list(params: { userId?: string; cursor?: string })`: List private messages.
+*   `create(payload: { title?: string; body: string; recipientId: string; senderId?: string })`: Send a direct message.
+*   `retrieve(id: string)`: Get a message thread.
+*   `reply(id: string, payload: { body: string; senderId: string; recipientId: string })`: Reply to a message.
+*   `delete(id: string)`: Delete a message.
+
+### Reports (`client.reports`)
+
+*   `list(params: { reporterId?: string; reportedId?: string; read?: boolean; cursor?: string })`: List reports.
+*   `create(payload: { reporterId: string; type: string; description?: string; ... })`: Submit a report.
+*   `batchUpdate(payload: { reportIds: string[]; read: boolean })`: Bulk update status.
+*   `retrieve(id: string)`: Get a report.
+*   `update(id: string, payload: any)`: Update report details.
+*   `delete(id: string)`: Delete a report.
+*   `updateStatus(id: string, read: boolean)`: Update read status of a report.
+
+### Roles (`client.roles`)
+
+*   `list(params: { cursor?: string })`: List user roles.
+*   `create(payload: { name: string; description?: string; color?: string })`: Create a new role.
+*   `retrieve(id: string)`: Get a role.
+*   `update(id: string, payload: any)`: Update a role.
+*   `delete(id: string)`: Delete a role.
+
+### SSO (`client.sso`)
+
+*   `list()`: List SSO providers.
+*   `create(payload: { provider: string; domain: string; config: any })`: Configure SSO.
+*   `delete(id: string)`: Remove SSO provider.
+
+## Types
+
+Import interfaces directly from the package:
+
+```typescript
+import { 
+  Thread, Post, User, Tag, Notification, 
+  LoginResponse, RegisterPayload 
+} from '@foru-ms/sdk';
+```
+
+## Error Handling
+
+All methods return a Promise. If the API returns a non-200 status, the Promise rejects with an Error object containing the server message.
+
+```typescript
+try {
+  await client.threads.create({ ... });
+} catch (err: any) {
+  console.error("Error creating thread:", err.message);
+}
+```
+
+## License
+
+MIT

package/dist/Client.d.ts

@@ -3,6 +3,15 @@ import { ThreadsResource } from './resources/Threads';
 import { PostsResource } from './resources/Posts';
 import { UsersResource } from './resources/Users';
 import { TagsResource } from './resources/Tags';
+import { NotificationsResource } from './resources/Notifications';
+import { SearchResource } from './resources/Search';
+import { WebhooksResource } from './resources/Webhooks';
+import { StatsResource } from './resources/Stats';
+import { IntegrationsResource } from './resources/Integrations';
+import { PrivateMessagesResource } from './resources/PrivateMessages';
+import { ReportsResource } from './resources/Reports';
+import { RolesResource } from './resources/Roles';
+import { SSOResource } from './resources/SSO';
 export declare class ForumClient {
     apiKey: string;
     token: string | null;
@@ -12,6 +21,15 @@ export declare class ForumClient {
     posts: PostsResource;
     users: UsersResource;
     tags: TagsResource;
+    notifications: NotificationsResource;
+    search: SearchResource;
+    webhooks: WebhooksResource;
+    stats: StatsResource;
+    integrations: IntegrationsResource;
+    privateMessages: PrivateMessagesResource;
+    reports: ReportsResource;
+    roles: RolesResource;
+    sso: SSOResource;
     constructor(options: {
         apiKey: string;
         baseUrl?: string;

package/dist/Client.js

@@ -6,6 +6,15 @@ const Threads_1 = require("./resources/Threads");
 const Posts_1 = require("./resources/Posts");
 const Users_1 = require("./resources/Users");
 const Tags_1 = require("./resources/Tags");
+const Notifications_1 = require("./resources/Notifications");
+const Search_1 = require("./resources/Search");
+const Webhooks_1 = require("./resources/Webhooks");
+const Stats_1 = require("./resources/Stats");
+const Integrations_1 = require("./resources/Integrations");
+const PrivateMessages_1 = require("./resources/PrivateMessages");
+const Reports_1 = require("./resources/Reports");
+const Roles_1 = require("./resources/Roles");
+const SSO_1 = require("./resources/SSO");
 // Polyfill fetch if needed (e.g. older Node versions)
 const fetch = globalThis.fetch || require('cross-fetch');
 class ForumClient {
@@ -18,6 +27,15 @@ class ForumClient {
         this.posts = new Posts_1.PostsResource(this);
         this.users = new Users_1.UsersResource(this);
         this.tags = new Tags_1.TagsResource(this);
+        this.notifications = new Notifications_1.NotificationsResource(this);
+        this.search = new Search_1.SearchResource(this);
+        this.webhooks = new Webhooks_1.WebhooksResource(this);
+        this.stats = new Stats_1.StatsResource(this);
+        this.integrations = new Integrations_1.IntegrationsResource(this);
+        this.privateMessages = new PrivateMessages_1.PrivateMessagesResource(this);
+        this.reports = new Reports_1.ReportsResource(this);
+        this.roles = new Roles_1.RolesResource(this);
+        this.sso = new SSO_1.SSOResource(this);
     }
     async request(path, options = {}) {
         const headers = {

package/dist/index.d.ts

@@ -5,3 +5,12 @@ export * from './resources/Threads';
 export * from './resources/Posts';
 export * from './resources/Users';
 export * from './resources/Tags';
+export * from './resources/Notifications';
+export * from './resources/Search';
+export * from './resources/Webhooks';
+export * from './resources/Stats';
+export * from './resources/Integrations';
+export * from './resources/PrivateMessages';
+export * from './resources/Reports';
+export * from './resources/Roles';
+export * from './resources/SSO';

package/dist/index.js

@@ -21,3 +21,12 @@ __exportStar(require("./resources/Threads"), exports);
 __exportStar(require("./resources/Posts"), exports);
 __exportStar(require("./resources/Users"), exports);
 __exportStar(require("./resources/Tags"), exports);
+__exportStar(require("./resources/Notifications"), exports);
+__exportStar(require("./resources/Search"), exports);
+__exportStar(require("./resources/Webhooks"), exports);
+__exportStar(require("./resources/Stats"), exports);
+__exportStar(require("./resources/Integrations"), exports);
+__exportStar(require("./resources/PrivateMessages"), exports);
+__exportStar(require("./resources/Reports"), exports);
+__exportStar(require("./resources/Roles"), exports);
+__exportStar(require("./resources/SSO"), exports);

package/dist/resources/Auth.d.ts

@@ -9,4 +9,16 @@ export declare class AuthResource {
     }): Promise<LoginResponse>;
     register(payload: import('../types').RegisterPayload): Promise<import('../types').User>;
     me(): Promise<import('../types').User>;
+    forgotPassword(email: string): Promise<{
+        resetToken?: string;
+        message?: string;
+    }>;
+    resetPassword(payload: {
+        password: string;
+        oldPassword?: string;
+        email?: string;
+        token?: string;
+    }): Promise<{
+        message: string;
+    }>;
 }

package/dist/resources/Auth.js

@@ -26,5 +26,24 @@ class AuthResource {
             method: 'GET',
         });
     }
+    async forgotPassword(email) {
+        return this.client.request('/auth/forgot-password', {
+            method: 'POST',
+            body: JSON.stringify({ email }),
+        });
+    }
+    async resetPassword(payload) {
+        const headers = {};
+        if (payload.token) {
+            headers['Authorization'] = `Bearer ${payload.token}`;
+        }
+        // Remove token from body
+        const { token, ...body } = payload;
+        return this.client.request('/auth/reset-password', {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+        });
+    }
 }
 exports.AuthResource = AuthResource;

package/dist/resources/Integrations.d.ts

@@ -0,0 +1,20 @@
+import { ForumClient } from '../Client';
+import { Integration, IntegrationListResponse } from '../types';
+export declare class IntegrationsResource {
+    private client;
+    constructor(client: ForumClient);
+    list(): Promise<IntegrationListResponse>;
+    create(payload: {
+        type: 'SLACK' | 'DISCORD' | 'SALESFORCE' | 'HUBSPOT' | 'OKTA' | 'AUTH0';
+        name: string;
+        config: any;
+    }): Promise<{
+        integration: Integration;
+    }>;
+    retrieve(id: string): Promise<{
+        integration: Integration;
+    }>;
+    delete(id: string): Promise<{
+        success: boolean;
+    }>;
+}

package/dist/resources/Integrations.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationsResource = void 0;
+class IntegrationsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    async list() {
+        return this.client.request('/integrations', {
+            method: 'GET',
+        });
+    }
+    async create(payload) {
+        return this.client.request('/integrations', {
+            method: 'POST',
+            body: JSON.stringify(payload),
+        });
+    }
+    async retrieve(id) {
+        return this.client.request(`/integrations/${id}`, {
+            method: 'GET',
+        });
+    }
+    async delete(id) {
+        return this.client.request(`/integrations/${id}`, {
+            method: 'DELETE',
+        });
+    }
+}
+exports.IntegrationsResource = IntegrationsResource;

package/dist/resources/Notifications.d.ts

@@ -0,0 +1,32 @@
+import { ForumClient } from '../Client';
+import { NotificationListResponse, Notification } from '../types';
+export declare class NotificationsResource {
+    private client;
+    constructor(client: ForumClient);
+    list(params: {
+        userId: string;
+        read?: boolean;
+        filter?: 'newest' | 'oldest';
+        cursor?: string;
+    }): Promise<NotificationListResponse>;
+    markAllAsRead(userId: string, read?: boolean): Promise<{
+        count: number;
+    }>;
+    retrieve(id: string): Promise<Notification>;
+    update(id: string, payload: {
+        read: boolean;
+    }): Promise<Notification>;
+    delete(id: string): Promise<Notification & {
+        deleted: boolean;
+    }>;
+    create(payload: {
+        threadId?: string;
+        postId?: string;
+        privateMessageId?: string;
+        notifierId: string;
+        notifiedId: string;
+        type: string;
+        description?: string;
+        extendedData?: Record<string, any>;
+    }): Promise<Notification>;
+}

package/dist/resources/Notifications.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationsResource = void 0;
+class NotificationsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    async list(params) {
+        const searchParams = new URLSearchParams();
+        Object.entries(params).forEach(([key, value]) => {
+            if (value !== undefined) {
+                searchParams.append(key, String(value));
+            }
+        });
+        return this.client.request(`/notifications?${searchParams.toString()}`, {
+            method: 'GET',
+        });
+    }
+    async markAllAsRead(userId, read = true) {
+        return this.client.request('/notifications', {
+            method: 'PATCH',
+            body: JSON.stringify({ userId, read }),
+        });
+    }
+    async retrieve(id) {
+        return this.client.request(`/notification/${id}`, {
+            method: 'GET',
+        });
+    }
+    async update(id, payload) {
+        return this.client.request(`/notification/${id}`, {
+            method: 'PATCH',
+            body: JSON.stringify(payload),
+        });
+    }
+    async delete(id) {
+        return this.client.request(`/notification/${id}`, {
+            method: 'DELETE',
+        });
+    }
+    async create(payload) {
+        return this.client.request('/notification', {
+            method: 'POST',
+            body: JSON.stringify(payload),
+        });
+    }
+}
+exports.NotificationsResource = NotificationsResource;

package/dist/resources/Posts.d.ts

@@ -18,4 +18,17 @@ export declare class PostsResource {
     }): Promise<import('../types').Post & {
         deleted: boolean;
     }>;
+    getChildren(id: string, params?: {
+        query?: string;
+        cursor?: string;
+        filter?: 'newest' | 'oldest';
+    }): Promise<any>;
+    like(id: string, userId?: string, extendedData?: any): Promise<any>;
+    unlike(id: string, userId: string): Promise<any>;
+    dislike(id: string, userId?: string, extendedData?: any): Promise<any>;
+    undislike(id: string, userId: string): Promise<any>;
+    upvote(id: string, userId?: string, extendedData?: any): Promise<any>;
+    unupvote(id: string, userId: string): Promise<any>;
+    downvote(id: string, userId?: string, extendedData?: any): Promise<any>;
+    undownvote(id: string, userId: string): Promise<any>;
 }

package/dist/resources/Posts.js

@@ -41,5 +41,60 @@ class PostsResource {
             body: payload ? JSON.stringify(payload) : undefined,
         });
     }
+    async getChildren(id, params) {
+        const searchParams = new URLSearchParams();
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                if (value !== undefined) {
+                    searchParams.append(key, value);
+                }
+            });
+        }
+        return this.client.request(`/post/${id}/posts?${searchParams.toString()}`, { method: 'GET' });
+    }
+    async like(id, userId, extendedData) {
+        return this.client.request(`/post/${id}/likes`, {
+            method: 'POST',
+            body: JSON.stringify({ userId, extendedData }),
+        });
+    }
+    async unlike(id, userId) {
+        return this.client.request(`/post/${id}/likes?userId=${userId}`, {
+            method: 'DELETE',
+        });
+    }
+    async dislike(id, userId, extendedData) {
+        return this.client.request(`/post/${id}/dislikes`, {
+            method: 'POST',
+            body: JSON.stringify({ userId, extendedData }),
+        });
+    }
+    async undislike(id, userId) {
+        return this.client.request(`/post/${id}/dislikes?userId=${userId}`, {
+            method: 'DELETE',
+        });
+    }
+    async upvote(id, userId, extendedData) {
+        return this.client.request(`/post/${id}/upvotes`, {
+            method: 'POST',
+            body: JSON.stringify({ userId, extendedData }),
+        });
+    }
+    async unupvote(id, userId) {
+        return this.client.request(`/post/${id}/upvotes?userId=${userId}`, {
+            method: 'DELETE',
+        });
+    }
+    async downvote(id, userId, extendedData) {
+        return this.client.request(`/post/${id}/downvotes`, {
+            method: 'POST',
+            body: JSON.stringify({ userId, extendedData }),
+        });
+    }
+    async undownvote(id, userId) {
+        return this.client.request(`/post/${id}/downvotes?userId=${userId}`, {
+            method: 'DELETE',
+        });
+    }
 }
 exports.PostsResource = PostsResource;

package/dist/resources/PrivateMessages.d.ts

@@ -0,0 +1,29 @@
+import { ForumClient } from '../Client';
+import { PrivateMessage, PrivateMessageListResponse } from '../types';
+export declare class PrivateMessagesResource {
+    private client;
+    constructor(client: ForumClient);
+    list(params?: {
+        query?: string;
+        userId?: string;
+        filter?: 'newest' | 'oldest';
+        cursor?: string;
+    }): Promise<PrivateMessageListResponse>;
+    create(payload: {
+        title?: string;
+        body: string;
+        recipientId: string;
+        senderId?: string;
+        extendedData?: Record<string, any>;
+    }): Promise<PrivateMessage>;
+    retrieve(id: string): Promise<PrivateMessage>;
+    reply(id: string, payload: {
+        body: string;
+        senderId: string;
+        recipientId: string;
+        extendedData?: Record<string, any>;
+    }): Promise<PrivateMessage>;
+    delete(id: string): Promise<PrivateMessage & {
+        deleted: boolean;
+    }>;
+}

package/dist/resources/PrivateMessages.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrivateMessagesResource = void 0;
+class PrivateMessagesResource {
+    constructor(client) {
+        this.client = client;
+    }
+    async list(params) {
+        const searchParams = new URLSearchParams();
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                if (value !== undefined) {
+                    searchParams.append(key, value);
+                }
+            });
+        }
+        return this.client.request(`/private-messages?${searchParams.toString()}`, {
+            method: 'GET',
+        });
+    }
+    async create(payload) {
+        return this.client.request('/private-message', {
+            method: 'POST',
+            body: JSON.stringify(payload),
+        });
+    }
+    async retrieve(id) {
+        return this.client.request(`/private-message/${id}`, {
+            method: 'GET',
+        });
+    }
+    async reply(id, payload) {
+        return this.client.request(`/private-message/${id}`, {
+            method: 'POST',
+            body: JSON.stringify(payload),
+        });
+    }
+    async delete(id) {
+        return this.client.request(`/private-message/${id}`, {
+            method: 'DELETE',
+        });
+    }
+}
+exports.PrivateMessagesResource = PrivateMessagesResource;