@ustriveneo/partner-sdk 1.0.0

package/README.md

@@ -0,0 +1,253 @@
+# @ustriveneo/partner-sdk
+
+TypeScript SDK for the UStrive Partner API. Enables partners to integrate UStrive's mentorship platform into their applications.
+
+## Installation
+
+```bash
+npm install @ustriveneo/partner-sdk
+```
+
+## Quick Start
+
+```typescript
+import { UStrivePartnerClient } from '@ustriveneo/partner-sdk';
+
+const client = new UStrivePartnerClient({
+  apiKey: 'pk_live_xxx',
+  secret: 'sk_live_yyy',
+});
+```
+
+## Usage
+
+### Create a Student
+
+```typescript
+const user = await client.users.create({
+  firstName: 'Jane',
+  lastName: 'Doe',
+  email: 'jane@example.com',
+  userType: 'STUDENT',
+});
+```
+
+### Search Mentors
+
+```typescript
+const { mentors } = await client.mentors.search({
+  q: 'college applications',
+  limit: 10,
+});
+```
+
+### Get Mentor Profile
+
+```typescript
+const mentor = await client.mentors.get('mentor-id');
+```
+
+### Create a Match
+
+```typescript
+const match = await client.matches.create({
+  studentId: 'student-id',
+  mentorId: 'mentor-id',
+  message: 'Looking forward to working together!',
+});
+```
+
+### Schedule a Session
+
+```typescript
+const session = await client.sessions.create({
+  matchId: 'match-id',
+  startTime: '2026-03-01T14:00:00Z',
+  endTime: '2026-03-01T15:00:00Z',
+  type: 'VIDEO',
+  timezone: { value: 'America/New_York', label: 'Eastern Time' },
+});
+```
+
+### End a Match
+
+```typescript
+await client.matches.end('match-id', {
+  satisfactionRating: 5,
+  feedback: 'Great experience!',
+});
+```
+
+### List User's Matches
+
+```typescript
+const { matches } = await client.matches.listByUser('user-id', {
+  status: 'ACTIVE',
+});
+```
+
+### List User's Sessions
+
+```typescript
+const { sessions } = await client.sessions.listByUser('user-id');
+```
+
+## External Identity & Cognito Integration
+
+The SDK supports linking external user identities (e.g., Cognito `sub`) to UStrive users. This is useful when your application manages its own authentication via Cognito or another identity provider.
+
+### Sync User (Cognito Post Authentication Trigger)
+
+The `sync` method is idempotent and designed to be called on every authentication event. It creates a new user if no match is found, or updates the existing linked user.
+
+```typescript
+// In your Cognito Post Authentication Lambda trigger:
+import { UStrivePartnerClient } from '@ustriveneo/partner-sdk';
+
+const client = new UStrivePartnerClient({
+  apiKey: process.env.USTRIVE_API_KEY!,
+  secret: process.env.USTRIVE_SECRET!,
+});
+
+export const handler = async (event: any) => {
+  const { sub, email, given_name, family_name } = event.request.userAttributes;
+
+  const result = await client.users.sync({
+    externalId: sub,
+    firstName: given_name,
+    lastName: family_name,
+    email: email,
+    userType: 'STUDENT',
+  });
+
+  if (result.created) {
+    console.log('New UStrive user created:', result.id);
+  } else {
+    console.log('Existing UStrive user synced:', result.id);
+  }
+
+  return event;
+};
+```
+
+### Look Up User by External ID
+
+```typescript
+const user = await client.users.getByExternalId('cognito-sub-value');
+console.log('UStrive user ID:', user.id);
+```
+
+### Create User with External ID
+
+You can also provide an `externalId` when creating a user directly:
+
+```typescript
+const user = await client.users.create({
+  firstName: 'Jane',
+  lastName: 'Doe',
+  email: 'jane@example.com',
+  userType: 'STUDENT',
+  externalId: 'cognito-sub-12345',
+});
+```
+
+## Messaging
+
+The SDK provides server-side messaging capabilities for match chat channels.
+
+### Get Stream Token
+
+Generate a client-side token for a user to connect to real-time chat/video:
+
+```typescript
+const { token, apiKey } = await client.messaging.getStreamToken('user-id');
+// Pass token + apiKey to @ustriveneo/partner-realtime on the client
+```
+
+### Send a Message
+
+```typescript
+const message = await client.messaging.sendMessage('match-id', {
+  userId: 'student-id',
+  text: 'Hello mentor!',
+});
+```
+
+### Get Message History
+
+```typescript
+const { messages } = await client.messaging.getMessages('match-id', {
+  limit: 50,
+  offset: 0,
+});
+```
+
+## Calls (Video & Audio)
+
+### Create a Call
+
+```typescript
+const call = await client.calls.create('match-id');
+// Returns: { callId, type, createdAt }
+```
+
+### List Calls
+
+```typescript
+const { calls } = await client.calls.list('match-id');
+```
+
+## Error Handling
+
+```typescript
+import { UStriveError, RateLimitError, NotFoundError } from '@ustriveneo/partner-sdk';
+
+try {
+  const user = await client.users.get('non-existent-id');
+} catch (error) {
+  if (error instanceof NotFoundError) {
+    console.log('User not found');
+  } else if (error instanceof RateLimitError) {
+    console.log(`Rate limited. Retry after ${error.retryAfter} seconds`);
+  } else if (error instanceof UStriveError) {
+    console.log(`API error: ${error.message} (${error.statusCode})`);
+  }
+}
+```
+
+## Configuration
+
+```typescript
+const client = new UStrivePartnerClient({
+  apiKey: 'pk_test_xxx',       // Your public API key
+  secret: 'sk_test_yyy',       // Your secret key
+  baseUrl: 'https://partner-api-dev.ustriveneo.com', // Optional: override for dev/staging
+});
+```
+
+## Authentication
+
+The SDK handles authentication automatically. On the first request, it exchanges your API key and secret for a JWT token (valid for 1 hour). Tokens are refreshed automatically when they expire.
+
+## Webhooks
+
+To receive real-time events (match created, session scheduled, etc.), configure a webhook URL when your partner account is created. Events are delivered as POST requests with an `X-UStrive-Signature` header for verification.
+
+### Verifying Webhook Signatures
+
+```typescript
+import crypto from 'crypto';
+
+function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean {
+  const [tsPart, sigPart] = signature.split(',');
+  const timestamp = tsPart.replace('t=', '');
+  const expectedSig = sigPart.replace('v1=', '');
+
+  const computed = crypto
+    .createHmac('sha256', secret)
+    .update(`${timestamp}.${payload}`)
+    .digest('hex');
+
+  return crypto.timingSafeEqual(Buffer.from(computed), Buffer.from(expectedSig));
+}
+```

package/dist/client.d.ts

@@ -0,0 +1,31 @@
+import { ClientConfig } from './types';
+import { UsersResource } from './resources/users';
+import { MentorsResource } from './resources/mentors';
+import { MatchesResource } from './resources/matches';
+import { SessionsResource } from './resources/sessions';
+import { MessagingResource } from './resources/messaging';
+import { CallsResource } from './resources/calls';
+export declare class UStrivePartnerClient {
+    private apiKey;
+    private secret;
+    private baseUrl;
+    private authToken;
+    users: UsersResource;
+    mentors: MentorsResource;
+    matches: MatchesResource;
+    sessions: SessionsResource;
+    messaging: MessagingResource;
+    calls: CallsResource;
+    constructor(config: ClientConfig);
+    /**
+     * Makes an authenticated HTTP request to the Partner API.
+     * Automatically handles token exchange and refresh.
+     */
+    request<T = any>(method: string, path: string, options?: {
+        body?: any;
+        query?: Record<string, string | number | undefined>;
+    }): Promise<T>;
+    private ensureAuthenticated;
+    private buildUrl;
+    private handleResponse;
+}

package/dist/client.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UStrivePartnerClient = void 0;
+const errors_1 = require("./errors");
+const users_1 = require("./resources/users");
+const mentors_1 = require("./resources/mentors");
+const matches_1 = require("./resources/matches");
+const sessions_1 = require("./resources/sessions");
+const messaging_1 = require("./resources/messaging");
+const calls_1 = require("./resources/calls");
+const DEFAULT_BASE_URL = 'https://partner-api-prod.myustrive.com';
+class UStrivePartnerClient {
+    constructor(config) {
+        this.authToken = null;
+        if (!config.apiKey)
+            throw new Error('apiKey is required');
+        if (!config.secret)
+            throw new Error('secret is required');
+        this.apiKey = config.apiKey;
+        this.secret = config.secret;
+        this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, '');
+        this.users = new users_1.UsersResource(this);
+        this.mentors = new mentors_1.MentorsResource(this);
+        this.matches = new matches_1.MatchesResource(this);
+        this.sessions = new sessions_1.SessionsResource(this);
+        this.messaging = new messaging_1.MessagingResource(this);
+        this.calls = new calls_1.CallsResource(this);
+    }
+    /**
+     * Makes an authenticated HTTP request to the Partner API.
+     * Automatically handles token exchange and refresh.
+     */
+    async request(method, path, options) {
+        await this.ensureAuthenticated();
+        const url = this.buildUrl(path, options?.query);
+        const response = await fetch(url, {
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.authToken.token}`,
+            },
+            body: options?.body ? JSON.stringify(options.body) : undefined,
+        });
+        // If token expired, refresh and retry once
+        if (response.status === 401) {
+            this.authToken = null;
+            await this.ensureAuthenticated();
+            const retryResponse = await fetch(url, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.authToken.token}`,
+                },
+                body: options?.body ? JSON.stringify(options.body) : undefined,
+            });
+            return this.handleResponse(retryResponse);
+        }
+        return this.handleResponse(response);
+    }
+    async ensureAuthenticated() {
+        if (this.authToken && this.authToken.expiresAt > Date.now() + 60000) {
+            return; // Token still valid (with 1 minute buffer)
+        }
+        const response = await fetch(`${this.baseUrl}/partner/v1/auth/token`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ apiKey: this.apiKey, secret: this.secret }),
+        });
+        if (!response.ok) {
+            const body = await response.json().catch(() => ({}));
+            throw new errors_1.AuthenticationError(body.error || 'Failed to authenticate', body);
+        }
+        const data = await response.json();
+        this.authToken = {
+            token: data.token,
+            expiresIn: data.expiresIn,
+            partnerId: data.partnerId,
+            expiresAt: Date.now() + data.expiresIn * 1000,
+        };
+    }
+    buildUrl(path, query) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    async handleResponse(response) {
+        const body = await response.json().catch(() => ({}));
+        if (response.ok) {
+            return body;
+        }
+        const message = body.error || `API error: ${response.status}`;
+        switch (response.status) {
+            case 401:
+                throw new errors_1.AuthenticationError(message, body);
+            case 403:
+                throw new errors_1.ForbiddenError(message, body);
+            case 404:
+                throw new errors_1.NotFoundError(message, body);
+            case 409:
+                throw new errors_1.ConflictError(message, body);
+            case 422:
+                throw new errors_1.ValidationError(message, body);
+            case 429:
+                throw new errors_1.RateLimitError(message, response.headers.get('Retry-After')
+                    ? Number(response.headers.get('Retry-After'))
+                    : undefined, body);
+            default:
+                throw new errors_1.UStriveError(message, response.status, body);
+        }
+    }
+}
+exports.UStrivePartnerClient = UStrivePartnerClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,24 @@
+export declare class UStriveError extends Error {
+    statusCode: number;
+    responseBody: any;
+    constructor(message: string, statusCode: number, responseBody?: any);
+}
+export declare class AuthenticationError extends UStriveError {
+    constructor(message?: string, responseBody?: any);
+}
+export declare class ForbiddenError extends UStriveError {
+    constructor(message?: string, responseBody?: any);
+}
+export declare class NotFoundError extends UStriveError {
+    constructor(message?: string, responseBody?: any);
+}
+export declare class ConflictError extends UStriveError {
+    constructor(message?: string, responseBody?: any);
+}
+export declare class ValidationError extends UStriveError {
+    constructor(message?: string, responseBody?: any);
+}
+export declare class RateLimitError extends UStriveError {
+    retryAfter?: number;
+    constructor(message?: string, retryAfter?: number, responseBody?: any);
+}

package/dist/errors.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitError = exports.ValidationError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.AuthenticationError = exports.UStriveError = void 0;
+class UStriveError extends Error {
+    constructor(message, statusCode, responseBody) {
+        super(message);
+        this.name = 'UStriveError';
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+    }
+}
+exports.UStriveError = UStriveError;
+class AuthenticationError extends UStriveError {
+    constructor(message = 'Authentication failed', responseBody) {
+        super(message, 401, responseBody);
+        this.name = 'AuthenticationError';
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+class ForbiddenError extends UStriveError {
+    constructor(message = 'Access denied', responseBody) {
+        super(message, 403, responseBody);
+        this.name = 'ForbiddenError';
+    }
+}
+exports.ForbiddenError = ForbiddenError;
+class NotFoundError extends UStriveError {
+    constructor(message = 'Resource not found', responseBody) {
+        super(message, 404, responseBody);
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+class ConflictError extends UStriveError {
+    constructor(message = 'Resource conflict', responseBody) {
+        super(message, 409, responseBody);
+        this.name = 'ConflictError';
+    }
+}
+exports.ConflictError = ConflictError;
+class ValidationError extends UStriveError {
+    constructor(message = 'Validation failed', responseBody) {
+        super(message, 422, responseBody);
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+class RateLimitError extends UStriveError {
+    constructor(message = 'Rate limit exceeded', retryAfter, responseBody) {
+        super(message, 429, responseBody);
+        this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+exports.RateLimitError = RateLimitError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,YAAa,SAAQ,KAAK;IAIrC,YAAY,OAAe,EAAE,UAAkB,EAAE,YAAkB;QACjE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAVD,oCAUC;AAED,MAAa,mBAAoB,SAAQ,YAAY;IACnD,YAAY,UAAkB,uBAAuB,EAAE,YAAkB;QACvE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED,MAAa,cAAe,SAAQ,YAAY;IAC9C,YAAY,UAAkB,eAAe,EAAE,YAAkB;QAC/D,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC;AAED,MAAa,aAAc,SAAQ,YAAY;IAC7C,YAAY,UAAkB,oBAAoB,EAAE,YAAkB;QACpE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED,MAAa,aAAc,SAAQ,YAAY;IAC7C,YAAY,UAAkB,mBAAmB,EAAE,YAAkB;QACnE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED,MAAa,eAAgB,SAAQ,YAAY;IAC/C,YAAY,UAAkB,mBAAmB,EAAE,YAAkB;QACnE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,MAAa,cAAe,SAAQ,YAAY;IAG9C,YAAY,UAAkB,qBAAqB,EAAE,UAAmB,EAAE,YAAkB;QAC1F,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AARD,wCAQC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { UStrivePartnerClient } from './client';
+export { UStriveError, AuthenticationError, ForbiddenError, NotFoundError, ConflictError, ValidationError, RateLimitError, } from './errors';
+export type { ClientConfig, UserType, MatchStatus, SessionType, SessionStatus, Timezone, CreateUserInput, UpdateUserInput, User, CreateUserResponse, SyncUserInput, SyncUserResponse, ExternalUserResponse, MentorSearchParams, Mentor, MentorSearchResponse, CreateMatchInput, EndMatchInput, Match, MatchListResponse, EndMatchResponse, CreateSessionInput, Session, SessionListResponse, StreamTokenResponse, Message, MessageAttachment, SendMessageInput, MessageListParams, MessageListResponse, CreateCallInput, CallInfo, CallListResponse, } from './types';

package/dist/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitError = exports.ValidationError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.AuthenticationError = exports.UStriveError = exports.UStrivePartnerClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "UStrivePartnerClient", { enumerable: true, get: function () { return client_1.UStrivePartnerClient; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "UStriveError", { enumerable: true, get: function () { return errors_1.UStriveError; } });
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_1.AuthenticationError; } });
+Object.defineProperty(exports, "ForbiddenError", { enumerable: true, get: function () { return errors_1.ForbiddenError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_1.NotFoundError; } });
+Object.defineProperty(exports, "ConflictError", { enumerable: true, get: function () { return errors_1.ConflictError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_1.RateLimitError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAgD;AAAvC,8GAAA,oBAAoB,OAAA;AAC7B,mCAQkB;AAPhB,sGAAA,YAAY,OAAA;AACZ,6GAAA,mBAAmB,OAAA;AACnB,wGAAA,cAAc,OAAA;AACd,uGAAA,aAAa,OAAA;AACb,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA"}

package/dist/resources/calls.d.ts

@@ -0,0 +1,16 @@
+import type { UStrivePartnerClient } from '../client';
+import type { CreateCallInput, CallInfo, CallListResponse } from '../types';
+export declare class CallsResource {
+    private client;
+    constructor(client: UStrivePartnerClient);
+    /**
+     * Create a video/audio call for a match.
+     * Call type 'default' supports both video and audio — the user's device
+     * chooses camera on/off at join time.
+     */
+    create(matchId: string, _input?: CreateCallInput): Promise<CallInfo>;
+    /**
+     * List call sessions for a match.
+     */
+    list(matchId: string): Promise<CallListResponse>;
+}

package/dist/resources/calls.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallsResource = void 0;
+class CallsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a video/audio call for a match.
+     * Call type 'default' supports both video and audio — the user's device
+     * chooses camera on/off at join time.
+     */
+    async create(matchId, _input) {
+        return this.client.request('POST', `/partner/v1/matches/${matchId}/calls`);
+    }
+    /**
+     * List call sessions for a match.
+     */
+    async list(matchId) {
+        return this.client.request('GET', `/partner/v1/matches/${matchId}/calls`);
+    }
+}
+exports.CallsResource = CallsResource;
+//# sourceMappingURL=calls.js.map

package/dist/resources/calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.js","sourceRoot":"","sources":["../../src/resources/calls.ts"],"names":[],"mappings":";;;AAOA,MAAa,aAAa;IACxB,YAAoB,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;IAEpD;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,MAAwB;QACpD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,uBAAuB,OAAO,QAAQ,CACvC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,uBAAuB,OAAO,QAAQ,CACvC,CAAC;IACJ,CAAC;CACF;AAxBD,sCAwBC"}

package/dist/resources/matches.d.ts

@@ -0,0 +1,25 @@
+import type { UStrivePartnerClient } from '../client';
+import type { CreateMatchInput, Match, EndMatchInput, EndMatchResponse, MatchListResponse } from '../types';
+export declare class MatchesResource {
+    private client;
+    constructor(client: UStrivePartnerClient);
+    /**
+     * Request a match between a student and mentor.
+     */
+    create(input: CreateMatchInput): Promise<Match>;
+    /**
+     * Get match details by ID.
+     */
+    get(matchId: string): Promise<Match>;
+    /**
+     * End a match (unmatch).
+     */
+    end(matchId: string, input?: EndMatchInput): Promise<EndMatchResponse>;
+    /**
+     * List all matches for a user.
+     */
+    listByUser(userId: string, params?: {
+        status?: string;
+        limit?: number;
+    }): Promise<MatchListResponse>;
+}

package/dist/resources/matches.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MatchesResource = void 0;
+class MatchesResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Request a match between a student and mentor.
+     */
+    async create(input) {
+        return this.client.request('POST', '/partner/v1/matches', {
+            body: input,
+        });
+    }
+    /**
+     * Get match details by ID.
+     */
+    async get(matchId) {
+        return this.client.request('GET', `/partner/v1/matches/${matchId}`);
+    }
+    /**
+     * End a match (unmatch).
+     */
+    async end(matchId, input) {
+        return this.client.request('DELETE', `/partner/v1/matches/${matchId}`, {
+            body: input,
+        });
+    }
+    /**
+     * List all matches for a user.
+     */
+    async listByUser(userId, params) {
+        return this.client.request('GET', `/partner/v1/users/${userId}/matches`, { query: { status: params?.status, limit: params?.limit } });
+    }
+}
+exports.MatchesResource = MatchesResource;
+//# sourceMappingURL=matches.js.map

package/dist/resources/matches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matches.js","sourceRoot":"","sources":["../../src/resources/matches.ts"],"names":[],"mappings":";;;AASA,MAAa,eAAe;IAC1B,YAAoB,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;IAEpD;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,KAAuB;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAQ,MAAM,EAAE,qBAAqB,EAAE;YAC/D,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAQ,KAAK,EAAE,uBAAuB,OAAO,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe,EAAE,KAAqB;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAmB,QAAQ,EAAE,uBAAuB,OAAO,EAAE,EAAE;YACvF,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,MAAc,EACd,MAA4C;QAE5C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,qBAAqB,MAAM,UAAU,EACrC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAC5D,CAAC;IACJ,CAAC;CACF;AAzCD,0CAyCC"}

package/dist/resources/mentors.d.ts

@@ -0,0 +1,14 @@
+import type { UStrivePartnerClient } from '../client';
+import type { Mentor, MentorSearchParams, MentorSearchResponse } from '../types';
+export declare class MentorsResource {
+    private client;
+    constructor(client: UStrivePartnerClient);
+    /**
+     * Search mentors available in the partner's branch.
+     */
+    search(params?: MentorSearchParams): Promise<MentorSearchResponse>;
+    /**
+     * Get a mentor's profile by ID (sanitized).
+     */
+    get(mentorId: string): Promise<Mentor>;
+}

package/dist/resources/mentors.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MentorsResource = void 0;
+class MentorsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Search mentors available in the partner's branch.
+     */
+    async search(params) {
+        return this.client.request('GET', '/partner/v1/mentors/search', {
+            query: {
+                q: params?.q,
+                limit: params?.limit,
+                offset: params?.offset,
+            },
+        });
+    }
+    /**
+     * Get a mentor's profile by ID (sanitized).
+     */
+    async get(mentorId) {
+        return this.client.request('GET', `/partner/v1/mentors/${mentorId}`);
+    }
+}
+exports.MentorsResource = MentorsResource;
+//# sourceMappingURL=mentors.js.map

package/dist/resources/mentors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentors.js","sourceRoot":"","sources":["../../src/resources/mentors.ts"],"names":[],"mappings":";;;AAGA,MAAa,eAAe;IAC1B,YAAoB,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;IAEpD;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAA2B;QACtC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAuB,KAAK,EAAE,4BAA4B,EAAE;YACpF,KAAK,EAAE;gBACL,CAAC,EAAE,MAAM,EAAE,CAAC;gBACZ,KAAK,EAAE,MAAM,EAAE,KAAK;gBACpB,MAAM,EAAE,MAAM,EAAE,MAAM;aACvB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAS,KAAK,EAAE,uBAAuB,QAAQ,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF;AAtBD,0CAsBC"}

package/dist/resources/messaging.d.ts

@@ -0,0 +1,20 @@
+import type { UStrivePartnerClient } from '../client';
+import type { StreamTokenResponse, Message, SendMessageInput, MessageListParams, MessageListResponse } from '../types';
+export declare class MessagingResource {
+    private client;
+    constructor(client: UStrivePartnerClient);
+    /**
+     * Generate a Stream token for a user.
+     * Returns the token and the public API key needed to initialize Stream clients.
+     */
+    getStreamToken(userId: string): Promise<StreamTokenResponse>;
+    /**
+     * Get message history for a match's chat channel.
+     */
+    getMessages(matchId: string, params?: MessageListParams): Promise<MessageListResponse>;
+    /**
+     * Send a message to a match's chat channel on behalf of a user.
+     * The userId must be either the studentId or mentorId of the match.
+     */
+    sendMessage(matchId: string, input: SendMessageInput): Promise<Message>;
+}

package/dist/resources/messaging.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagingResource = void 0;
+class MessagingResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Generate a Stream token for a user.
+     * Returns the token and the public API key needed to initialize Stream clients.
+     */
+    async getStreamToken(userId) {
+        return this.client.request('POST', `/partner/v1/users/${userId}/stream-token`);
+    }
+    /**
+     * Get message history for a match's chat channel.
+     */
+    async getMessages(matchId, params) {
+        return this.client.request('GET', `/partner/v1/matches/${matchId}/messages`, { query: { limit: params?.limit, offset: params?.offset } });
+    }
+    /**
+     * Send a message to a match's chat channel on behalf of a user.
+     * The userId must be either the studentId or mentorId of the match.
+     */
+    async sendMessage(matchId, input) {
+        return this.client.request('POST', `/partner/v1/matches/${matchId}/messages`, { body: input });
+    }
+}
+exports.MessagingResource = MessagingResource;
+//# sourceMappingURL=messaging.js.map

package/dist/resources/messaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.js","sourceRoot":"","sources":["../../src/resources/messaging.ts"],"names":[],"mappings":";;;AASA,MAAa,iBAAiB;IAC5B,YAAoB,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;IAEpD;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,qBAAqB,MAAM,eAAe,CAC3C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,MAA0B;QAC3D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,uBAAuB,OAAO,WAAW,EACzC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAC5D,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,KAAuB;QACxD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,uBAAuB,OAAO,WAAW,EACzC,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;IACJ,CAAC;CACF;AApCD,8CAoCC"}

package/dist/resources/sessions.d.ts

@@ -0,0 +1,21 @@
+import type { UStrivePartnerClient } from '../client';
+import type { CreateSessionInput, Session, SessionListResponse } from '../types';
+export declare class SessionsResource {
+    private client;
+    constructor(client: UStrivePartnerClient);
+    /**
+     * Schedule a new session for a match.
+     */
+    create(input: CreateSessionInput): Promise<Session>;
+    /**
+     * Get session details by ID.
+     */
+    get(sessionId: string): Promise<Session>;
+    /**
+     * List all sessions for a user.
+     */
+    listByUser(userId: string, params?: {
+        status?: string;
+        limit?: number;
+    }): Promise<SessionListResponse>;
+}

package/dist/resources/sessions.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionsResource = void 0;
+class SessionsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Schedule a new session for a match.
+     */
+    async create(input) {
+        return this.client.request('POST', '/partner/v1/sessions', {
+            body: input,
+        });
+    }
+    /**
+     * Get session details by ID.
+     */
+    async get(sessionId) {
+        return this.client.request('GET', `/partner/v1/sessions/${sessionId}`);
+    }
+    /**
+     * List all sessions for a user.
+     */
+    async listByUser(userId, params) {
+        return this.client.request('GET', `/partner/v1/users/${userId}/sessions`, { query: { status: params?.status, limit: params?.limit } });
+    }
+}
+exports.SessionsResource = SessionsResource;
+//# sourceMappingURL=sessions.js.map

package/dist/resources/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/resources/sessions.ts"],"names":[],"mappings":";;;AAGA,MAAa,gBAAgB;IAC3B,YAAoB,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;IAEpD;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,KAAyB;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAU,MAAM,EAAE,sBAAsB,EAAE;YAClE,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAU,KAAK,EAAE,wBAAwB,SAAS,EAAE,CAAC,CAAC;IAClF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,MAAc,EACd,MAA4C;QAE5C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,qBAAqB,MAAM,WAAW,EACtC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAC5D,CAAC;IACJ,CAAC;CACF;AAhCD,4CAgCC"}

package/dist/resources/users.d.ts

@@ -0,0 +1,29 @@
+import type { UStrivePartnerClient } from '../client';
+import type { CreateUserInput, CreateUserResponse, User, UpdateUserInput, SyncUserInput, SyncUserResponse, ExternalUserResponse } from '../types';
+export declare class UsersResource {
+    private client;
+    constructor(client: UStrivePartnerClient);
+    /**
+     * Create a new user in the partner's branch.
+     * Optionally provide an externalId to link the user to an external identity.
+     */
+    create(input: CreateUserInput): Promise<CreateUserResponse>;
+    /**
+     * Get a user by ID (sanitized - no PII).
+     */
+    get(userId: string): Promise<User>;
+    /**
+     * Update a user's profile.
+     */
+    update(userId: string, input: UpdateUserInput): Promise<User>;
+    /**
+     * Sync a user by external ID (idempotent).
+     * Designed for Cognito Post Authentication triggers - safe to call on every auth event.
+     * Creates a new user if no match is found, or updates the existing linked user.
+     */
+    sync(input: SyncUserInput): Promise<SyncUserResponse>;
+    /**
+     * Look up a user by their external ID (e.g., Cognito sub).
+     */
+    getByExternalId(externalId: string): Promise<ExternalUserResponse>;
+}

package/dist/resources/users.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsersResource = void 0;
+class UsersResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new user in the partner's branch.
+     * Optionally provide an externalId to link the user to an external identity.
+     */
+    async create(input) {
+        return this.client.request('POST', '/partner/v1/users', {
+            body: input,
+        });
+    }
+    /**
+     * Get a user by ID (sanitized - no PII).
+     */
+    async get(userId) {
+        return this.client.request('GET', `/partner/v1/users/${userId}`);
+    }
+    /**
+     * Update a user's profile.
+     */
+    async update(userId, input) {
+        return this.client.request('PUT', `/partner/v1/users/${userId}`, {
+            body: input,
+        });
+    }
+    /**
+     * Sync a user by external ID (idempotent).
+     * Designed for Cognito Post Authentication triggers - safe to call on every auth event.
+     * Creates a new user if no match is found, or updates the existing linked user.
+     */
+    async sync(input) {
+        return this.client.request('POST', '/partner/v1/users/sync', {
+            body: input,
+        });
+    }
+    /**
+     * Look up a user by their external ID (e.g., Cognito sub).
+     */
+    async getByExternalId(externalId) {
+        return this.client.request('GET', `/partner/v1/users/external/${encodeURIComponent(externalId)}`);
+    }
+}
+exports.UsersResource = UsersResource;
+//# sourceMappingURL=users.js.map

package/dist/resources/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/resources/users.ts"],"names":[],"mappings":";;;AAWA,MAAa,aAAa;IACxB,YAAoB,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;IAEpD;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,KAAsB;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAqB,MAAM,EAAE,mBAAmB,EAAE;YAC1E,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAO,KAAK,EAAE,qBAAqB,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,KAAsB;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAO,KAAK,EAAE,qBAAqB,MAAM,EAAE,EAAE;YACrE,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,KAAoB;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAmB,MAAM,EAAE,wBAAwB,EAAE;YAC7E,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,UAAkB;QACtC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,8BAA8B,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAC/D,CAAC;IACJ,CAAC;CACF;AAjDD,sCAiDC"}

package/dist/types/index.d.ts

@@ -0,0 +1,231 @@
+export interface ClientConfig {
+    apiKey: string;
+    secret: string;
+    baseUrl?: string;
+}
+export interface AuthToken {
+    token: string;
+    expiresIn: number;
+    partnerId: string;
+    expiresAt: number;
+}
+export interface PaginatedResponse<T> {
+    total: number;
+    limit?: number;
+    offset?: number;
+}
+export type UserType = 'STUDENT' | 'MENTOR';
+export type MatchStatus = 'PENDING' | 'ACTIVE' | 'INACTIVE' | 'REJECTED' | 'REMOVED' | 'ENDED' | 'EXPIRED';
+export type SessionType = 'CALL' | 'VIDEO' | 'CHAT';
+export type SessionStatus = 'SCHEDULED' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELLED';
+export interface Timezone {
+    value: string;
+    label?: string;
+    offset?: number;
+    abbrev?: string;
+    altName?: string;
+}
+export interface CreateUserInput {
+    firstName: string;
+    lastName: string;
+    email: string;
+    userType: UserType;
+    profileBio?: string;
+    city?: string;
+    state?: string;
+    externalId?: string;
+}
+export interface UpdateUserInput {
+    firstName?: string;
+    lastName?: string;
+    profileBio?: string;
+    profileTitle?: string;
+    profileCompany?: string;
+    profileLocation?: string;
+    profileWebsite?: string;
+    city?: string;
+    state?: string;
+    gender?: string;
+    profileEthnicity?: string;
+    onboardingCompleted?: boolean;
+    profileCompleted?: boolean;
+}
+export interface User {
+    id: string;
+    firstName: string;
+    lastName: string;
+    profilePictureUrl?: string | null;
+    profileCoverUrl?: string | null;
+    profileBio?: string | null;
+    profileTitle?: string | null;
+    profileCompany?: string | null;
+    profileLocation?: string | null;
+    profileWebsite?: string | null;
+    profileSkills?: string[] | null;
+    profileInterests?: string[] | null;
+    city?: string | null;
+    state?: string | null;
+    bgCheckStatus?: string | null;
+    profileCompleted?: boolean | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+}
+export interface CreateUserResponse {
+    id: string;
+    firstName: string;
+    lastName: string;
+    email: string;
+    userType: UserType;
+    branchSlug: string;
+    externalId?: string;
+    createdAt: string;
+}
+export interface SyncUserInput {
+    externalId: string;
+    firstName: string;
+    lastName: string;
+    email: string;
+    userType: UserType;
+    profileBio?: string;
+    city?: string;
+    state?: string;
+}
+export interface SyncUserResponse {
+    id: string;
+    firstName: string;
+    lastName: string;
+    email?: string;
+    userType?: UserType;
+    externalId: string;
+    branchSlug: string;
+    created: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface ExternalUserResponse extends User {
+    externalId: string;
+}
+export interface MentorSearchParams {
+    q?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface Mentor extends User {
+    available?: boolean;
+    matchCount?: number;
+}
+export interface MentorSearchResponse extends PaginatedResponse<Mentor> {
+    mentors: Mentor[];
+}
+export interface CreateMatchInput {
+    studentId: string;
+    mentorId: string;
+    message?: string;
+}
+export interface EndMatchInput {
+    satisfactionRating?: number;
+    feedback?: string;
+    reason?: string;
+}
+export interface Match {
+    id: string;
+    studentId: string;
+    mentorId: string;
+    branchId: string;
+    status: MatchStatus;
+    streamChatId?: string;
+    matchRequestMessage?: string | null;
+    lastInteractionAt?: string | null;
+    startDate?: string | null;
+    endDate?: string | null;
+    endedAt?: string | null;
+    endReason?: string | null;
+    createdAt: string;
+    updatedAt?: string;
+    student?: User | null;
+    mentor?: User | null;
+}
+export interface MatchListResponse {
+    matches: Match[];
+    total: number;
+}
+export interface EndMatchResponse {
+    success: boolean;
+    matchId: string;
+    message: string;
+}
+export interface CreateSessionInput {
+    matchId: string;
+    startTime: string;
+    endTime: string;
+    type: SessionType;
+    timezone: Timezone;
+    notes?: string;
+}
+export interface Session {
+    id: string;
+    matchId: string;
+    mentorId: string;
+    studentId: string;
+    branchId?: string;
+    startTime: string;
+    endTime: string;
+    type: SessionType;
+    status: SessionStatus;
+    timezone: Timezone;
+    notes?: string | null;
+    meetingLink?: string | null;
+    cancellationReason?: string | null;
+    cancelledAt?: string | null;
+    createdAt: string;
+    updatedAt?: string;
+}
+export interface SessionListResponse {
+    sessions: Session[];
+    total: number;
+}
+export interface StreamTokenResponse {
+    token: string;
+    apiKey: string;
+}
+export interface Message {
+    id: string;
+    text: string;
+    userId: string;
+    attachments?: MessageAttachment[];
+    createdAt: string;
+}
+export interface MessageAttachment {
+    type: string;
+    url: string;
+    name?: string;
+    size?: number;
+}
+export interface SendMessageInput {
+    userId: string;
+    text: string;
+}
+export interface MessageListParams {
+    limit?: number;
+    offset?: number;
+}
+export interface MessageListResponse {
+    messages: Message[];
+}
+export interface CreateCallInput {
+    type?: 'video' | 'audio';
+}
+export interface CallInfo {
+    callId: string;
+    type: string;
+    createdAt: string;
+    endedAt?: string;
+    duration?: number;
+}
+export interface CallListResponse {
+    calls: CallInfo[];
+}
+export interface ApiErrorResponse {
+    error: string;
+    userId?: string;
+}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@ustriveneo/partner-sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for UStrive Partner API",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "ustrive",
+    "partner",
+    "sdk",
+    "mentorship"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "vitest": "^0.34.6"
+  }
+}