@amityco/ts-sdk 6.35.3-fa3d4ac.0 → 7.0.1-54f1ba3.0

package/src/fileRepository/api/createFile.ts

@@ -1,59 +0,0 @@
-import { getActiveClient } from '~/client/api';
-
-import { ingestInCache } from '~/cache/api/ingestInCache';
-import GlobalFileAccessType from '~/client/utils/GlobalFileAccessType';
-
-/**
- * ```js
- * import { FileRepository } from '@amityco/ts-sdk'
- * const created = await FileRepository.createFile(formData)
- * ```
- *
- * Creates an {@link Amity.File}
- *
- * @param formData The data necessary to create a new {@link Amity.File}
- * @param onProgress The callback to track the upload progress
- * @returns The newly created {@link Amity.File}
- *
- * @category File API
- * @async
- */
-export const createFile = async <T extends Amity.FileType = any>(
-  formData: FormData,
-  onProgress?: (percent: number) => void,
-): Promise<Amity.Cached<Amity.File[]>> => {
-  const client = getActiveClient();
-  client.log('file/createFile', formData);
-
-  const files = formData.getAll('files');
-
-  if (!files.length) throw new Error('The formData object must have a `files` key.');
-
-  const accessType = GlobalFileAccessType.getInstance().getFileAccessType();
-  formData.append('accessType', accessType);
-
-  formData.append('preferredFilename', (files[0] as File).name);
-
-  const headers =
-    'getHeaders' in formData
-      ? (formData as any).getHeaders()
-      : { 'content-type': 'multipart/form-data' };
-
-  const { data } = await client.http.post<Amity.CreateFilePayload<T>>('/api/v4/files', formData, {
-    headers,
-    onUploadProgress({ loaded, total = 100 }) {
-      onProgress && onProgress(Math.round((loaded * 100) / total));
-    },
-  });
-
-  // API-FIX: payload should be serialized properly
-  // const { files } = data
-
-  const cachedAt = client.cache && Date.now();
-  if (client.cache) ingestInCache({ files: data }, { cachedAt });
-
-  return {
-    data,
-    cachedAt,
-  };
-};

package/src/fileRepository/api/createImage.ts

@@ -1,59 +0,0 @@
-import { getActiveClient } from '~/client/api';
-import { ingestInCache } from '~/cache/api/ingestInCache';
-import GlobalFileAccessType from '~/client/utils/GlobalFileAccessType';
-
-/**
- * ```js
- * import { createImage } from '@amityco/ts-sdk'
- * const created = await createImage(formData)
- * ```
- *
- * Creates an {@link Amity.File<'image'>}
- *
- * @param formData The data necessary to create a new {@link Amity.File<'image'>}
- * @param onProgress The callback to track the upload progress
- * @returns The newly created {@link Amity.File<'image'>}
- *
- * @category File API
- * @async
- */
-export const createImage = async (
-  formData: FormData,
-  onProgress?: (percent: number) => void,
-): Promise<Amity.Cached<Amity.File<'image'>[]>> => {
-  const client = getActiveClient();
-  client.log('file/createImage', formData);
-
-  const files = formData.getAll('files');
-
-  if (!files.length) throw new Error('The formData object must have a `files` key.');
-
-  const accessType = GlobalFileAccessType.getInstance().getFileAccessType();
-  formData.append('accessType', accessType);
-
-  formData.append('preferredFilename', (files[0] as File).name);
-
-  const headers =
-    'getHeaders' in formData
-      ? (formData as any).getHeaders()
-      : { 'content-type': 'multipart/form-data' };
-  const { data } = await client.http.post<Amity.CreateFilePayload<'image'>>(
-    '/api/v4/images',
-    formData,
-    {
-      headers,
-      onUploadProgress({ loaded, total = 100 }) {
-        onProgress && onProgress(Math.round((loaded * 100) / total));
-      },
-    },
-  );
-  // API-FIX: payload should be serialized properly
-  // const { files } = data
-  const cachedAt = client.cache && Date.now();
-  if (client.cache) ingestInCache({ files: data }, { cachedAt });
-  return {
-    data,
-    cachedAt,
-  };
-};
-/* end_public_function */

package/src/fileRepository/api/createVideo.ts

@@ -1,69 +0,0 @@
-import { getActiveClient } from '~/client/api';
-
-import { ingestInCache } from '~/cache/api/ingestInCache';
-import GlobalFileAccessType from '~/client/utils/GlobalFileAccessType';
-
-/**
- * ```js
- * import { FileRepository } from '@amityco/ts-sdk'
- * const created = await FileRepository.createVideo(formData)
- * ```
- *
- * Creates an {@link Amity.File<'video'>}
- *
- * @param formData The data necessary to create a new {@link Amity.File<'video'>}
- * @param feedType The {@link Amity.File<'video'>} feed type
- * @param onProgress The callback to track the upload progress
- * @returns The newly uploaded {@link Amity.File<'video'>}
- *
- * @category File API
- * @async
- */
-export const createVideo = async (
-  formData: FormData,
-  feedType?: Amity.ContentFeedType,
-  onProgress?: (percent: number) => void,
-): Promise<Amity.Cached<Amity.File<'video'>[]>> => {
-  const client = getActiveClient();
-  client.log('file/createVideo', formData);
-
-  const files = formData.getAll('files');
-
-  if (!files.length) throw new Error('The formData object must have a `files` key.');
-
-  const accessType = GlobalFileAccessType.getInstance().getFileAccessType();
-  formData.append('accessType', accessType);
-
-  formData.append('preferredFilename', (files[0] as File).name);
-
-  if (feedType) {
-    formData.append('feedType', feedType);
-  }
-
-  const headers =
-    'getHeaders' in formData
-      ? (formData as any).getHeaders()
-      : { 'content-type': 'multipart/form-data' };
-
-  const { data } = await client.http.post<Amity.CreateFilePayload<'video'>>(
-    '/api/v4/videos',
-    formData,
-    {
-      headers,
-      onUploadProgress({ loaded, total = 100 }) {
-        onProgress && onProgress(Math.round((loaded * 100) / total));
-      },
-    },
-  );
-
-  // API-FIX: payload should be serialized properly
-  // const { files } = data
-
-  const cachedAt = client.cache && Date.now();
-  if (client.cache) ingestInCache({ files: data }, { cachedAt });
-
-  return {
-    data,
-    cachedAt,
-  };
-};

package/src/fileRepository/observers/index.ts

@@ -1 +0,0 @@
-export * from './observeFile';

package/src/fileRepository/observers/observeFile.ts

@@ -1,49 +0,0 @@
-import { createQuery, runQuery } from '~/core/query/query';
-
-import { getActiveClient } from '~/client/api';
-
-import { getFile } from '../api';
-
-/**
- * ```js
- * import { observeFile } from '@amityco/ts-sdk'
- *
- * let file = {}
- * const dispose = observeFile(fileId, updated => file = updated)
- * ```
- *
- * Observe all mutation on a given {@link Amity.File}
- *
- * @param fileId the ID of the file to observe
- * @param callback the function to call when new data are available
- * @returns An {@link Amity.Unsubscriber} function to run when willing to stop observing the file
- *
- * @category File Observer
- */
-export const observeFile = <Events extends ['onFetch']>(
-  fileId: string,
-  callback: Amity.ObjectListener<Amity.Snapshot<Amity.File>, Events>,
-): Amity.Unsubscriber => {
-  const { log } = getActiveClient();
-
-  const timestamp = Date.now();
-  log(`observeFile(tmpid: ${timestamp}) > listen`);
-
-  // wrapper function to make sure
-  const router = (result: Amity.Snapshot<Amity.File>, action: Events[number]) => {
-    // filter function
-    if (result.data?.fileId !== fileId) return;
-
-    if (callback instanceof Function) return callback(result);
-
-    if (action !== 'onFetch') callback.onEvent?.(action, result);
-
-    callback[action]?.(result);
-  };
-
-  runQuery(createQuery(getFile, fileId), result => result.data && router(result, 'onFetch'));
-
-  return () => {
-    log(`observeFile(tmpid: ${timestamp}) > dispose`);
-  };
-};

package/src/messageRepository/api/getMessage.ts

@@ -1,102 +0,0 @@
-import { getActiveClient } from '~/client/api';
-
-import { fireEvent } from '~/core/events';
-import { pullFromCache } from '~/cache/api';
-import { ingestInCache } from '~/cache/api/ingestInCache';
-
-import { isInTombstone } from '~/cache/api/isInTombstone';
-import { checkIfShouldGoesToTombstone } from '~/cache/utils';
-import { pushToTombstone } from '~/cache/api/pushToTombstone';
-
-import { prepareMessagePayload } from '../utils';
-import { LinkedObject } from '~/utils/linkedObject';
-
-/**
- * ```js
- * import { getMessage } from '@amityco/ts-sdk'
- * const message = await getMessage('foobar')
- * ```
- *
- * Fetches a {@link Amity.Message} object
- *
- * @param messageId the ID of the {@link Amity.Message} to fetch
- * @returns the associated {@link Amity.Message} object
- *
- * @category Message API
- * @async
- */
-export const getMessage = async (
-  messageId: Amity.Message['messageId'],
-  isLive = false,
-): Promise<Amity.Cached<Amity.Message>> => {
-  const client = getActiveClient();
-  client.log('message/getMessage', messageId);
-
-  if (!isLive) {
-    console.log(
-      'getMessage will be deprecated on 15th November 2022, please use liveMessage instead.',
-    );
-  }
-
-  isInTombstone('message', messageId);
-
-  let data: Amity.ProcessedMessagePayload;
-
-  try {
-    // API-FIX: endpoint should not be /list, parameters should be querystring.
-    const { data: payload } = await client.http.get<Amity.MessagePayload>(
-      `/api/v5/messages/${encodeURIComponent(messageId)}`,
-    );
-
-    data = await prepareMessagePayload(payload);
-  } catch (error) {
-    if (checkIfShouldGoesToTombstone((error as Amity.ErrorResponse)?.code)) {
-      pushToTombstone('message', messageId);
-    }
-
-    throw error;
-  }
-
-  const cachedAt = client.cache && Date.now();
-  if (client.cache) ingestInCache(data, { cachedAt });
-
-  const { messages } = data;
-
-  fireEvent('local.message.fetched', { messages });
-
-  return {
-    data: LinkedObject.message(messages.find(message => message.messageId === messageId)!),
-    cachedAt,
-  };
-};
-
-/**
- * ```js
- * import { getMessage } from '@amityco/ts-sdk'
- * const message = getMessage.locally('foobar')
- * ```
- *
- * Fetches a {@link Amity.Message} object
- *
- * @param messageId the ID of the {@link Amity.Message} to fetch
- * @returns the associated {@link Amity.Message} object
- *
- * @category Message API
- */
-getMessage.locally = (
-  messageId: Amity.Message['messageId'],
-): Amity.Cached<Amity.Message> | undefined => {
-  const client = getActiveClient();
-  client.log('message/getMessage.locally', messageId);
-
-  if (!client.cache) return;
-
-  const cached = pullFromCache<Amity.Message>(['message', 'get', messageId]);
-
-  if (!cached) return;
-
-  return {
-    data: cached.data,
-    cachedAt: cached.cachedAt,
-  };
-};

package/src/messageRepository/api/getMessages.ts

@@ -1,83 +0,0 @@
-import { getActiveClient } from '~/client/api';
-
-import { fireEvent } from '~/core/events';
-import { pullFromCache } from '~/cache/api';
-import { ingestInCache } from '~/cache/api/ingestInCache';
-
-import { prepareMessagePayload } from '../utils';
-import { LinkedObject } from '~/utils/linkedObject';
-
-/**
- * ```js
- * import { getMessages } from '@amityco/ts-sdk'
- * const messages = await getMessages(['foo', 'bar'])
- * ```
- *
- * Fetches a collection of {@link Amity.Message} objects
- *
- * @param messageIds the IDs of the {@link Amity.Message} to fetch
- * @returns the associated collection of {@link Amity.Message} objects
- *
- * @category Message API
- * @async
- */
-export const getMessages = async (
-  messageIds: Amity.Message['messageId'][],
-): Promise<Amity.Cached<Amity.Message[]>> => {
-  const client = getActiveClient();
-  client.log('message/getMessages', messageIds);
-
-  const { data: payload } = await client.http.get<Amity.MessagePayload>(`/api/v5/messages/list`, {
-    params: { messageIds: messageIds.map(encodeURIComponent) },
-  });
-
-  const data = await prepareMessagePayload(payload);
-
-  const cachedAt = client.cache && Date.now();
-  if (client.cache) ingestInCache(data, { cachedAt });
-
-  const { messages } = data;
-
-  fireEvent('local.message.fetched', { messages });
-
-  return {
-    data: messages.map(message => LinkedObject.message(message)),
-    cachedAt,
-  };
-};
-
-/**
- * ```js
- * import { getMessages } from '@amityco/ts-sdk'
- * const messages = getMessages.locally(['foo', 'bar']) ?? []
- * ```
- *
- * Fetches a collection of {@link Amity.Message} objects from cache
- *
- * @param messageIds the IDs of the {@link Amity.Message} to fetch
- * @returns the associated collection of {@link Amity.Message} objects
- *
- * @category Message API
- */
-getMessages.locally = (
-  messageIds: Amity.Message['messageId'][],
-): Amity.Cached<Amity.Message[]> | undefined => {
-  const client = getActiveClient();
-  client.log('message/getMessages.locally', messageIds);
-
-  if (!client.cache) return;
-
-  const cached = messageIds
-    .map(messageId => pullFromCache<Amity.Message>(['message', 'get', messageId])!)
-    .filter(Boolean);
-
-  const messages = cached.map(({ data }) => data);
-  const oldest = cached.sort((a, b) => (a.cachedAt! < b.cachedAt! ? -1 : 1))?.[0];
-
-  if (cached?.length < messageIds.length) return;
-
-  return {
-    data: messages,
-    cachedAt: oldest.cachedAt,
-  };
-};

package/src/messageRepository/observers/observeMessage.ts

@@ -1,94 +0,0 @@
-import { getActiveClient } from '~/client/api';
-
-import { createQuery, runQuery, queryOptions } from '~/core/query';
-import { onMessageMarked, onMessageMarkerFetched } from '~/marker/events';
-import { convertEventPayload } from '~/utils/event';
-
-import { getMessage } from '../api/getMessage';
-
-import { onMessageUpdated, onMessageDeleted } from '../events';
-import { LinkedObject } from '~/utils/linkedObject';
-
-/**
- * ```js
- * import { observeMessage } from '@amityco/ts-sdk'
- *
- * let message = {}
- *
- * const unsub = observeMessage(messageId, updated => message = updated)
- * ```
- *
- * Observe all mutations on a {@link Amity.Message} given a single messageId
- *
- * @param client the client to observe the message with
- * @param messageId the ID of the message to observe
- * @param callback the function to call when new data are available
- * @param policy a query policy option for this observer
- * @returns An {@link Amity.Unsubscriber} function to run when willing to stop observing the message
- *
- * @category Message Observer
- */
-export const observeMessage = <Events extends ['onFetch', 'onUpdate', 'onDelete']>(
-  messageId: Amity.Message['messageId'],
-  callback: Amity.ObjectListener<Amity.Snapshot<Amity.Message>, Events>,
-  policy: Amity.QueryPolicy = 'cache_then_server',
-): Amity.Unsubscriber => {
-  const { log } = getActiveClient();
-
-  const timestamp = Date.now();
-  log(`observeMessage(tmpid: ${timestamp}) > listen`);
-
-  console.log(
-    'observeMessage will be deprecated on 15th November 2022, please use liveMessage instead.',
-  );
-
-  // wrapper function to make sure
-  const router = (result: Amity.Snapshot<Amity.Message>, action: Events[number]) => {
-    // filter function
-    if (result.data?.messageId !== messageId) return;
-
-    if (callback instanceof Function) return callback(result);
-
-    if (action !== 'onFetch') callback.onEvent?.(action, result);
-
-    callback[action]?.(result);
-  };
-
-  const disposers: Amity.Unsubscriber[] = [];
-
-  disposers.push(
-    onMessageUpdated(data =>
-      router({ data: LinkedObject.message(data), loading: false, origin: 'event' }, 'onUpdate'),
-    ),
-    onMessageDeleted(data =>
-      router({ data: LinkedObject.message(data), loading: false, origin: 'event' }, 'onDelete'),
-    ),
-    convertEventPayload(
-      onMessageMarkerFetched,
-      'contentId',
-      'message',
-    )(data =>
-      router({ data: LinkedObject.message(data), loading: false, origin: 'event' }, 'onUpdate'),
-    ),
-    convertEventPayload(
-      onMessageMarked,
-      'contentId',
-      'message',
-    )(data =>
-      router({ data: LinkedObject.message(data), loading: false, origin: 'event' }, 'onUpdate'),
-    ),
-  );
-
-  if (policy !== 'no_fetch') {
-    runQuery(
-      createQuery(getMessage, messageId),
-      result => result.data && router(result, 'onFetch'),
-      queryOptions(policy),
-    );
-  }
-
-  return () => {
-    log(`observeMessages(tmpid: ${timestamp}) > dispose`);
-    disposers.forEach(fn => fn());
-  };
-};

package/src/messageRepository/observers/observeMessages.ts

@@ -1,89 +0,0 @@
-import { getActiveClient } from '~/client/api';
-import { onMessageMarked, onMessageMarkerFetched } from '~/marker/events';
-import { convertEventPayload } from '~/utils/event';
-
-import { LinkedObject } from '~/utils/linkedObject';
-import {
-  onMessageCreatedLocal,
-  onMessageCreatedMqtt,
-  onMessageDeleted,
-  onMessageUpdated,
-} from '../events';
-
-/**
- * ```js
- * import { observeMessages } from '@amityco/ts-sdk'
- *
- * let messages = []
- *
- * const unsubscribe = observeMessages(channelId, message => merge(messages, message))
- * ```
- *
- * Observe all mutations on a list of {@link Amity.Message} for a given {@link Amity.SubChannel} object
- *
- * @param subChannelId the ID of the channel where to observe the messages
- * @param callback the function to call when new data are available
- * @returns An {@link Amity.Unsubscriber} function to run when willing to stop observing the messages
- *
- * @category Message Observer
- */
-export const observeMessages = (
-  subChannelId: Amity.SubChannel['subChannelId'],
-  callback: Amity.ObjectListener<
-    Amity.Snapshot<Amity.Message>,
-    ['onCreate', 'onUpdate', 'onDelete']
-  >,
-): Amity.Unsubscriber => {
-  const { log } = getActiveClient();
-
-  const timestamp = Date.now();
-  log(`observeMessages(tmpid: ${timestamp}) > listen`);
-
-  const disposers: Amity.Unsubscriber[] = [];
-
-  const router = (
-    message: Amity.Snapshot<Amity.Message>,
-    action: 'onCreate' | 'onUpdate' | 'onDelete',
-  ) => {
-    if (message.data?.subChannelId !== subChannelId) return;
-
-    if (callback instanceof Function) return callback(message);
-
-    callback.onEvent?.(action, message);
-    callback[action]?.(message);
-  };
-
-  disposers.push(
-    onMessageCreatedMqtt(data =>
-      router({ data: LinkedObject.message(data), loading: false, origin: 'event' }, 'onCreate'),
-    ),
-    onMessageCreatedLocal(data =>
-      router({ data: LinkedObject.message(data), loading: false, origin: 'event' }, 'onCreate'),
-    ),
-    onMessageUpdated(data =>
-      router({ data: LinkedObject.message(data), loading: false, origin: 'event' }, 'onUpdate'),
-    ),
-    onMessageDeleted(data =>
-      router({ data: LinkedObject.message(data), loading: false, origin: 'event' }, 'onDelete'),
-    ),
-    convertEventPayload(
-      onMessageMarkerFetched,
-      'contentId',
-      'message',
-    )(data =>
-      router({ data: LinkedObject.message(data), loading: false, origin: 'event' }, 'onCreate'),
-    ),
-    convertEventPayload(
-      onMessageMarked,
-      'contentId',
-      'message',
-    )(data =>
-      router({ data: LinkedObject.message(data), loading: false, origin: 'event' }, 'onCreate'),
-    ),
-  );
-
-  return () => {
-    log(`observeMessages(tmpid: ${timestamp}) > dispose`);
-    disposers.forEach(fn => fn());
-  };
-};

package/src/messageRepository/utils/getMessageIdentifierIds.ts

@@ -1,37 +0,0 @@
-import { getActiveClient } from '~/client/api/activeClient';
-import { isLocalId } from '~/core/model';
-
-/*
- * To get message identifier ids used as a cache key for the each message.
- * These ids are used to store in the query stream and use to get messages from cache.
- *
- * The query stream data keeps the message identifier ids as follows:
- * ['server_message_id_1', 'server_message_id_2', 'LOCAL_message_id_1', 'LOCAL_message_id_2']
- *
- * Example use case: Message created locally and then created on the server.
- *
- * 1. Message created locally has `LOCAL_message_id_2` as referenceId.
- * 2. The `message.created` event will be fired from server with message payload that has no the referenceId.
- * 3. SDK use this function to find indentifer id for each message in the payload. If the message is created locally, the identifier id will be the local reference id.
- * 4. The SDK use this identifier ids to check if the message is already in the query stream before appending it.
- *
- * @param The raw message payload from server response
- * @returns The identifier ids of the messages
- */
-export function getMessageIdentifierIds(messages: Amity.RawMessage[]) {
-  const client = getActiveClient();
-  const { objectSyncMap } = client;
-
-  return messages
-    .map(message => {
-      /* NOTE: This logic is used to get identifier id for each message.
-       *
-       * if messageId is a local id, use it as identifier id else get identifier id from objectSyncMap.
-       * if find referenceId in objectSyncMap, this means this message is a local created message. The identifier id will be local message id.
-       * if cannot find identifier id in objectSyncMap, this means this message is not a local created message. The identifier id will be server message id.
-       */
-      if (isLocalId(message.messageId)) return message.messageId;
-      return objectSyncMap.get(message.messageId) ?? message.messageId;
-    })
-    .filter(Boolean);
-}