@tellescope/sdk 0.0.17 → 0.0.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tellescope/sdk",
-  "version": "0.0.17",
+  "version": "0.0.18",
   "description": "Code for interacting with the Tellescope API",
   "main": "./lib/cjs/sdk.js",
   "module": "./lib/esm/sdk.js",
@@ -30,14 +30,14 @@
   },
   "homepage": "https://github.com/tellescope-os/tellescope#readme",
   "dependencies": {
-    "@tellescope/constants": "^0.0.17",
-    "@tellescope/schema": "^0.0.17",
-    "@tellescope/testing": "^0.0.17",
-    "@tellescope/types-client": "^0.0.17",
-    "@tellescope/types-models": "^0.0.17",
-    "@tellescope/types-utilities": "^0.0.17",
-    "@tellescope/utilities": "^0.0.17",
-    "@tellescope/validation": "^0.0.17",
+    "@tellescope/constants": "^0.0.18",
+    "@tellescope/schema": "^0.0.18",
+    "@tellescope/testing": "^0.0.18",
+    "@tellescope/types-client": "^0.0.18",
+    "@tellescope/types-models": "^0.0.18",
+    "@tellescope/types-utilities": "^0.0.18",
+    "@tellescope/utilities": "^0.0.18",
+    "@tellescope/validation": "^0.0.18",
     "axios": "^0.21.1",
     "form-data": "^4.0.0",
     "socket.io-client": "^4.2.0",
@@ -53,5 +53,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "4f6785b4e580de4f3fceb9bc3d455cc7191cd094"
+  "gitHead": "8019bedb3e6f90e2d26ee71ee989bd05fc1b7ee6"
 }

package/src/enduser.ts

@@ -1,6 +1,7 @@
 import { io } from 'socket.io-client'
 
-import { Session, SessionOptions, APIQuery } from "./session"
+import { Session, SessionOptions } from "./session"
+import { APIQuery } from "./sdk"
 import { url_safe_path } from "@tellescope/utilities"
 
 import { S3PresignedPost, UserIdentity } from "@tellescope/types-utilities"
@@ -14,7 +15,6 @@ import {
   Enduser,
   File,
 } from "@tellescope/types-client"
-import { stringValidator } from "@tellescope/validation";
 
 export interface EnduserSessionOptions extends SessionOptions {}
 
@@ -30,8 +30,9 @@ export const defaultQueries = <N extends keyof ClientModelForName>(
   return {
     createOne: o => s._POST(`/v1/${singularName}`, o),
     createSome: os => s._POST(`/v1/${safeName}`, { create: os }),
-    getOne: (id, filter) => s._GET(`/v1/${singularName}/${id}`, { filter }),
-    getSome: (o) => s._GET(`/v1/${safeName}`, o),
+    getOne: (argument) => typeof argument === 'string' ? s._GET(`/v1/${singularName}/${argument}`)
+                                                       : s._GET(`/v1/${singularName}`, { filter: argument}),
+    getSome: o => s._GET(`/v1/${safeName}`, o),
     updateOne: (id, updates, options) => s._PATCH(`/v1/${singularName}/${id}`, { updates, options }),
     deleteOne: id => s._DELETE(`/v1/${singularName}/${id}`),
   }
@@ -124,8 +125,11 @@ export class EnduserSession extends Session {
     return { authToken, enduser }
   }
 
-  authenticate = async (email: string, password: string) => this.handle_new_session(
-    await this.POST<{email: string, password: string }, { authToken: string, enduser: Enduser }>('/v1/login-enduser', { email, password })
+  authenticate = async (email: string, password: string, o?: { expirationInSeconds?: number }) => this.handle_new_session(
+    await this.POST<
+      {email: string, password: string, expirationInSeconds?: number }, 
+      { authToken: string, enduser: Enduser }
+    >('/v1/login-enduser', { email, password, ...o })
   )
 
   refresh_session = async () => {

package/src/sdk.ts

@@ -1,10 +1,10 @@
 import {
   AttendeeInfo,
   JourneyState, 
-  MeetingStatus, 
   Meeting,
   UserSession,
   MeetingInfo,
+  ReadFilter,
 } from "@tellescope/types-models"
 
 import {
@@ -19,12 +19,18 @@ import {
 import { CustomUpdateOptions, SortOption, S3PresignedPost, UserIdentity } from "@tellescope/types-utilities"
 import { url_safe_path } from "@tellescope/utilities"
 
-import { Session as SessionManager, SessionOptions, Filter } from "./session"
+import { Session as SessionManager, SessionOptions } from "./session"
 
 export * from "./public"
 export * from "./enduser"
 
-export type LoadFunction<T> = (o?: { lastId?: string, limit?: number, sort?: SortOption, threadKey?: string, filter?: Filter<Partial<T>> }) => Promise<T[]>
+export type LoadFunction<T> = (o?: { 
+    lastId?: string, 
+    limit?: number, 
+    sort?: SortOption, 
+    threadKey?: string, 
+    filter?: ReadFilter<T>,
+  }) => Promise<T[]>
 
 export interface APIQuery<
   N extends keyof ClientModelForName, 
@@ -36,7 +42,7 @@ export interface APIQuery<
 {
   createOne: (t: CREATE) => Promise<T>;
   createSome: (ts: CREATE[]) => Promise<{ created: T[], errors: object[] }>;
-  getOne: (id: string, filter?: Filter<Partial<T>>) => Promise<T>;
+  getOne: (argument: string | ReadFilter<T>) => Promise<T>;
   getSome: LoadFunction<T>;
   updateOne: (id: string, updates: UPDATE, options?: CustomUpdateOptions) => Promise<T>;
   deleteOne: (id: string) => Promise<void>;
@@ -52,7 +58,8 @@ export const defaultQueries = <N extends keyof ClientModelForName>(
   return {
     createOne: o => s._POST(`/v1/${singularName}`, o),
     createSome: os => s._POST(`/v1/${safeName}`, { create: os }),
-    getOne: (id, filter) => s._GET(`/v1/${singularName}/${id}`, { filter }),
+    getOne: (argument) => typeof argument === 'string' ? s._GET(`/v1/${singularName}/${argument}`)
+                                                       : s._GET(`/v1/${singularName}`, { filter: argument }),
     getSome: (o) => s._GET(`/v1/${safeName}`, o),
     updateOne: (id, updates, options) => s._PATCH(`/v1/${singularName}/${id}`, { updates, options }),
     deleteOne: id => s._DELETE(`/v1/${singularName}/${id}`),
@@ -173,13 +180,14 @@ export class Session extends SessionManager {
     if (this.AUTO_REFRESH_MS < elapsedSessionMS) { return await this.refresh_session()}
   }
 
-  authenticate = async (email: string, password: string, url?: string) => {
-    if (url) this.host = url
-
-    return this.handle_new_session(
-      await this.POST<{email: string, password: string },  UserSession & { authToken: string }>('/submit-login', { email, password })
-    ) 
-  }
+  authenticate = async (email: string, password: string, o?: { expirationInSeconds?: number }) => (
+    this.handle_new_session(
+      await this.POST<
+        {email: string, password: string, expirationInSeconds?: number }, 
+        UserSession & { authToken: string }
+      >('/submit-login', { email, password, ...o })
+    )
+  ) 
   logout = async () => {
     this.clearState()
     await this.POST('/logout-api').catch(console.error)

package/src/session.ts

@@ -22,6 +22,7 @@ export interface SessionOptions {
   authToken?: string;
   host?: string;
   cacheKey?: string;
+  expirationInSeconds?: number,
   handleUnauthenticated?: () => Promise<void>;
 }
 
@@ -29,24 +30,6 @@ interface RequestOptions {
   refresh_session?: () => Promise<any>,
 }
 
-export type Filter<T> = { [K in keyof T]: T[K] }
-
-export interface APIQuery<
-  N extends keyof ClientModelForName, 
-  T=ClientModelForName[N], 
-  Req=ClientModelForName_required[N], 
-  CREATE=Omit<Req & Partial<T>, keyof ClientModelForName_readonly[N]>, 
-  UPDATE=Omit<Partial<T>, keyof (ClientModelForName_readonly[N] & ClientModelForName_updatesDisabled[N])>,
-> 
-{
-  createOne: (t: CREATE) => Promise<T>;
-  createSome: (ts: CREATE[]) => Promise<{ created: T[], errors: object[] }>;
-  getOne: (id: string, filter?: Filter<Partial<T>>) => Promise<T>;
-  getSome: (o?: { lastId?: string, limit?: number, sort?: SortOption, threadKey?: string }, f?: Filter<Partial<T>>) => Promise<T[]>
-  updateOne: (id: string, updates: UPDATE, options?: CustomUpdateOptions) => Promise<T>;
-  deleteOne: (id: string) => Promise<void>;
-}
-
 const generateBearer = (authToken: string) => `Bearer ${authToken}`
 
 const parseError = (err: any) => {
@@ -71,6 +54,7 @@ export class Session {
   apiKey?: string;
   socket?: Socket;
   handleUnauthenticated?: SessionOptions['handleUnauthenticated']
+  expirationInSeconds?: number;
   socketAuthenticated: boolean;
   userInfo: { businessId?: string };
   sessionStart = Date.now();
@@ -81,6 +65,7 @@ export class Session {
   constructor(o={} as SessionOptions & RequestOptions) {
     this.host= o.host ?? DEFAULT_HOST
     this.apiKey = o.apiKey ?? '';
+    this.expirationInSeconds = o.expirationInSeconds
     this.socket = undefined as Socket | undefined
     this.socketAuthenticated = false
     this.handleUnauthenticated = o.handleUnauthenticated

package/src/tests/public_endpoint_tests.ts

@@ -58,7 +58,7 @@ const enduser_login_tests = async () => {
   log_header("Public Endpoints")
 
   try {
-    await sdk.authenticate(email, password, host)
+    await sdk.authenticate(email, password)
     await sdk.reset_db()
 
     await enduser_login_tests()

package/src/tests/socket_tests.ts

@@ -1,3 +1,4 @@
+import { createHash } from "crypto"
 import {
   assert,
   async_test,
@@ -17,6 +18,7 @@ import { EnduserSession } from "../enduser"
 import { Session, /* APIQuery */ } from "../sdk"
 import { PLACEHOLDER_ID } from "@tellescope/constants"
 
+export const get_sha256 = (s='') => createHash('sha256').update(s).digest('hex')
 
 const host = process.env.TEST_URL || 'http://localhost:8080'
 const [email, password] = [process.env.TEST_EMAIL, process.env.TEST_PASSWORD]
@@ -198,28 +200,89 @@ const enduser_tests = async () => {
   // await user1.api.chats.deleteOne(messageToUser.id)
 }
 
+const TEST_SESSION_DURATION = 2 // seconds
+const SESSION_TIMEOUT_DELAY = 2000 // ms
+const deauthentication_tests = async (byTimeout=false) => {
+  log_header(`Unauthenticated Tests ${byTimeout ? '- With Timeout, requires Worker' : '- With Manual Logout' }`)
+  
+  const enduser = await user1.api.endusers.createOne({ email: "socketenduser@tellescope.com" })
+  await user1.api.endusers.set_password({ id: enduser.id, password: 'enduserPassword!' })
+  await enduserSDK.authenticate(enduser.email as string, 'enduserPassword!', { expirationInSeconds: byTimeout ? TEST_SESSION_DURATION : undefined })
+  await wait(undefined, 25)
+  
+  const room  = await user1.api.chat_rooms.createOne({ 
+    type: 'external', 
+    userIds: [user1.userInfo.id],
+    enduserIds: [enduser.id],
+  })
+
+  const userEvents = [] as ChatMessage[]
+  const enduserEvents = [] as ChatMessage[]
+  user1.subscribe({ [room.id]: 'chats' })
+  enduserSDK.subscribe({ [room.id]: 'chats' }) 
+  user1.handle_events({ 'created-chats': rs => userEvents.push(...rs) }) 
+  enduserSDK.handle_events({ 'created-chats': rs => enduserEvents.push(...rs) }) 
+  await wait(undefined, 10)
+
+  if (!byTimeout) {
+    await enduserSDK.api.endusers.logout()
+  } else {
+    await wait(undefined, TEST_SESSION_DURATION * 1000 + SESSION_TIMEOUT_DELAY) 
+  }
+  await user1.api.chats.createOne({ roomId: room.id, message: "Hello!" })
+  await wait(undefined, 25)
+  assert(objects_equivalent(enduserEvents[0], undefined), 'enduser got message after logout on socket', 'enduser logged out')
+
+  // re-authenticate enduser to send message to user
+  await enduserSDK.authenticate(enduser.email as string, 'enduserPassword!')
+
+  // ensure user logged out appropriately for not receiving message
+  await user1.logout()
+  if (byTimeout) {
+    await user1.authenticate(email, password, { expirationInSeconds: byTimeout ? TEST_SESSION_DURATION : undefined } )
+    await wait(undefined, TEST_SESSION_DURATION * 1000 + SESSION_TIMEOUT_DELAY) 
+  }
+  await enduserSDK.api.chats.createOne({ roomId: room.id, message: "Hello right back!" })
+  await wait(undefined, 25)
+  assert(objects_equivalent(userEvents[0], undefined), 'user got message after logout', 'user logged out')
+
+  // must come before cleanup, so cleanup works
+  await user1.authenticate(email, password), // reauthenticate for later tests as needed
+
+  // cleanup
+  await Promise.all([
+    user1.api.endusers.deleteOne(enduser.id),
+    user1.api.chat_rooms.deleteOne(room.id), // deletes chats as side effect
+  ])
+}
+
 (async () => {
   log_header("Sockets")
 
   try {
-    await user1.authenticate(email, password, host)
+    await user1.authenticate(email, password)
     await user1.reset_db()
-    await user2.authenticate(email2, password2, host) // generate authToken + socket connection for API keyj
+    await user2.authenticate(email2, password2) // generate authToken + socket connection for API keyj
     await wait(undefined, 25)
 
     let loopCount = 0
     while (!(user1.socketAuthenticated && user2.socketAuthenticated) && ++loopCount < 10) {
-      user2.authenticate_socket()
+      if (!user1.socketAuthenticated) user1.authenticate_socket()
+      if (!user2.socketAuthenticated) user2.authenticate_socket()
       await wait(undefined, 100)
     }
     if (loopCount === 10) {
       console.log("Failed to authenticate")
       process.exit()
     }
-    
+
     await enduser_tests()
     await basic_tests()
     await access_tests()
+
+    await deauthentication_tests() // should come last!
+    await deauthentication_tests(true) // should come last!
+
   } catch(err) {
     console.error(err)
   }

package/src/tests/tests.ts

@@ -71,7 +71,7 @@ const userId = '60398b0231a295e64f084fd9'
 //   await sdk.api.endusers.deleteOne(enduser.id)
 // }
 
-const sdk = new Session()
+const sdk = new Session({ host })
 const sdkOther = new Session({ host, apiKey: "ba745e25162bb95a795c5fa1af70df188d93c4d3aac9c48b34a5c8c9dd7b80f7" })
 const enduserSDK = new EnduserSession({ host })
 // const sdkOtherEmail = "sebass@tellescope.com"
@@ -90,8 +90,6 @@ const setup_tests = async () => {
   await async_test('test_online', sdk.test_online, { expectedResult: 'API V1 Online' })
   await async_test('test_authenticated', sdk.test_authenticated, { expectedResult: 'Authenticated!' })
 
-  // console.log(await sdk.api.api_keys.createOne({}))
-
   await async_test(
     'test_authenticated (with API Key)', 
     (new Session({ host, apiKey: '3n5q0SCBT_iUvZz-b9BJtX7o7HQUVJ9v132PgHJNJsg.' /* local test key */  })).test_authenticated, 
@@ -100,7 +98,7 @@ const setup_tests = async () => {
 
   await sdk.logout()
   await async_test<string, string>('test_authenticated - (logout invalidates jwt)', sdk.test_authenticated, { shouldError: true, onError: e => e === 'Unauthenticated' })
-  await sdk.authenticate(email, password, host)
+  await sdk.authenticate(email, password)
   await async_test('test_authenticated (re-authenticated)', sdk.test_authenticated, { expectedResult: 'Authenticated!' })
 
   await async_test('reset_db', () => sdk.reset_db(), passOnVoid)
@@ -191,6 +189,20 @@ const threadKeyTests = async () => {
   ])
 }
 
+const badInputTests = async () => {
+  log_header("Bad Input Tests")
+  await async_test(
+    `_-prefixed fields are not allowed`, 
+    () => sdk.api.endusers.createOne({ email: 'failure@tellescope.com', fields: { "_notallowed": 'hello' } }), 
+    { shouldError: true, onError: e => e.message === "Error parsing field fields: Fields that start with '_' are not allowed" },
+  )
+  await async_test(
+    `_-prefixed fields are not allowed`, 
+    () => sdk.api.notes.createOne({ enduserId: PLACEHOLDER_ID, fields: { "_notallowed": 'hello' } }), 
+    { shouldError: true, onError: e => e.message === "Error parsing field fields: Fields that start with '_' are not allowed" },
+  )
+}
+
 const filterTests = async () => {
   const enduser = await sdk.api.endusers.createOne({ email: 'filtertests@tellescope.com', fname: 'test', fields: { field1: 'value1', field2: 'value2' } })
   const otherEnduser = await sdk.api.endusers.createOne({ email: 'other@tellescope.com' })
@@ -199,6 +211,17 @@ const filterTests = async () => {
     () => sdk.api.endusers.getSome({ filter: { email: 'filtertests@tellescope.com' }}), 
     { onResult: es => es.length === 1 && es[0].id === enduser.id },
   )
+  await async_test(
+    `find enduser by _exists filter`, 
+    () => sdk.api.endusers.getSome({ filter: { fname: { _exists: true } }}), 
+    { onResult: es => es.length === 1 && es[0].id === enduser.id },
+  )
+  await async_test(
+    `find enduser by _exists filter (findOne)`, 
+    // () => sdk.api.endusers.getOne({ fname: { _exists: true } }), 
+    () => sdk.api.endusers.getOne({ fname: { _exists: true } }), 
+    { onResult: e => e.id === enduser.id },
+  )
   await async_test(
     `find enduser by compound filter`, 
     () => sdk.api.endusers.getSome({ filter: { email: 'filtertests@tellescope.com', fname: 'test' }}), 
@@ -419,7 +442,7 @@ const run_generated_tests = async <N extends ModelName>({ queries, model, name,
   }
   await async_test(
     `get-${singularName}`, 
-    () => queries.getOne(_id, filter), 
+    () => queries.getOne(_id), 
     { onResult: d => {
         if (!d?.id) return false
 
@@ -452,7 +475,7 @@ const run_generated_tests = async <N extends ModelName>({ queries, model, name,
   )
   await async_test(
     `get-${singularName} (verify delete)`, 
-    () => queries.getOne(_id, filter), 
+    () => queries.getOne(_id), 
     { shouldError: true, onError: e => e.message === 'Could not find a record for the given id' } 
   )
 }
@@ -840,32 +863,22 @@ const chat_tests = async() => {
   const chat  = await sdk.api.chats.createOne({ roomId: room.id, message: "Hello!" })
   const chat2 = await sdk.api.chats.createOne({ roomId: room.id, message: "Hello..." })
 
-  await async_test(
-    `get-chat (without filter)`, 
-    () => sdk.api.chats.getOne(chat.id), 
-    { shouldError: true, onError: () => true }
-  )
+  // await async_test(
+  //   `get-chat (without filter)`, 
+  //   () => sdk.api.chats.getOne(chat.id), 
+  //   { shouldError: true, onError: () => true }
+  // )
   await async_test(
     `get-chats (without filter)`, 
     () => sdk.api.chats.getSome({}), 
     { shouldError: true, onError: () => true }
   )
-  await async_test(
-    `get-chat (with filter)`, 
-    () => sdk.api.chats.getOne(chat.id, { roomId: room.id }), 
-    { onResult: c => c?.id === chat.id }
-  )
   await async_test(
     `get-chats (with filter)`, 
     () => sdk.api.chats.getSome({ filter: { roomId: room.id } }), 
     { onResult: c => c?.length === 2 }
   )
 
-  await async_test(
-    `get-chat not allowed`, 
-    () => sdk2.api.chats.getOne(chat.id, { roomId: room.id }), 
-    { shouldError: true, onError: e => e.message === 'You do not have permission to access this resource' }
-  )
   await async_test(
     `get-chats not allowed`, 
     () => sdk2.api.chats.getSome({ filter: { roomId: room.id } }), 
@@ -894,12 +907,12 @@ const chat_tests = async() => {
   await wait(undefined, 25)
   await async_test(
     `get-chat (deleted as dependency of room 1)`,
-    () => sdk.api.chats.getOne(chat.id, { roomId: room.id }), 
+    () => sdk.api.chats.getOne(chat.id), 
     { shouldError: true, onError: e => e.message === 'Could not find a record for the given id' }
   )
   await async_test(
     `get-chat (deleted as dependency of room 2)`,
-    () => sdk.api.chats.getOne(chat2.id, { roomId: room.id }), 
+    () => sdk.api.chats.getOne(chat2.id), 
     { shouldError: true, onError: e => e.message === 'Could not find a record for the given id' }
   )
 
@@ -908,12 +921,12 @@ const chat_tests = async() => {
   const sharedChat2 = await sdk2.api.chats.createOne({ roomId: sharedRoom.id, message: "Hello there!", })
   await async_test(
     `get-chat (shared, user1)`,
-    () => sdk.api.chats.getOne(sharedChat.id, { roomId: sharedRoom.id }), 
+    () => sdk.api.chats.getOne(sharedChat.id), 
     { onResult: r => r.id === sharedChat.id }
   )
   await async_test(
     `get-chat (shared, user2)`,
-    () => sdk2.api.chats.getOne(sharedChat.id, { roomId: sharedRoom.id }), 
+    () => sdk2.api.chats.getOne(sharedChat.id), 
     { onResult: r => r.id === sharedChat.id }
   )
   await async_test(
@@ -936,7 +949,7 @@ const chat_tests = async() => {
   await sdk.api.chats.deleteOne(chatNull.id)
   await async_test(
     `get-chat (setNull working)`,
-    () => sdk.api.chats.getOne(chat2Null.id, { roomId: roomNull.id }), 
+    () => sdk.api.chats.getOne(chat2Null.id), 
     { onResult: c => c.replyId === null }
   )
 }
@@ -1058,13 +1071,13 @@ const tests: { [K in keyof ClientModelForName]: () => void } = {
 };
 
 (async () => {
-  await sdk.authenticate(email, password, host)
-
   log_header("API")
-  
+
   try {
+    await sdk.authenticate(email, password)
     await setup_tests()
     await multi_tenant_tests() // should come right after setup tests
+    await badInputTests()
     await filterTests()
     await updatesTests()
     await threadKeyTests()