@twilio/conversations 2.0.0-rc.1 → 2.0.1-canary.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (90) hide show
  1. package/README.md +25 -28
  2. package/dist/browser.js +3125 -3460
  3. package/dist/browser.js.map +1 -1
  4. package/dist/docs/assets/js/search.js +1 -1
  5. package/dist/docs/classes/AggregatedDeliveryReceipt.html +22 -6
  6. package/dist/docs/classes/Client.html +78 -33
  7. package/dist/docs/classes/Conversation.html +33 -17
  8. package/dist/docs/classes/DetailedDeliveryReceipt.html +22 -6
  9. package/dist/docs/classes/Media.html +23 -7
  10. package/dist/docs/classes/Message.html +23 -7
  11. package/dist/docs/classes/MessageBuilder.html +3280 -0
  12. package/dist/docs/classes/Participant.html +23 -7
  13. package/dist/docs/classes/PushNotification.html +24 -8
  14. package/dist/docs/classes/RestPaginator.html +28 -9
  15. package/dist/docs/classes/UnsentMessage.html +3144 -0
  16. package/dist/docs/classes/User.html +25 -9
  17. package/dist/docs/index.html +89 -47
  18. package/dist/docs/interfaces/ClientOptions.html +22 -6
  19. package/dist/docs/interfaces/ConversationState.html +22 -6
  20. package/dist/docs/interfaces/CreateConversationOptions.html +22 -6
  21. package/dist/docs/interfaces/LastMessage.html +22 -6
  22. package/dist/docs/interfaces/Paginator.html +3243 -0
  23. package/dist/docs/interfaces/PushNotificationData.html +3168 -0
  24. package/dist/docs/interfaces/SendEmailOptions.html +22 -6
  25. package/dist/docs/interfaces/SendMediaOptions.html +24 -7
  26. package/dist/docs/modules.html +88 -46
  27. package/dist/lib/aggregated-delivery-receipt.js +227 -0
  28. package/dist/lib/aggregated-delivery-receipt.js.map +1 -0
  29. package/dist/lib/client.js +872 -0
  30. package/dist/lib/client.js.map +1 -0
  31. package/dist/lib/command-executor.js +203 -0
  32. package/dist/lib/command-executor.js.map +1 -0
  33. package/dist/lib/configuration.js +196 -0
  34. package/dist/lib/configuration.js.map +1 -0
  35. package/dist/lib/conversation.js +973 -0
  36. package/dist/lib/conversation.js.map +1 -0
  37. package/dist/lib/data/conversations.js +443 -0
  38. package/dist/lib/data/conversations.js.map +1 -0
  39. package/dist/lib/data/messages.js +341 -0
  40. package/dist/lib/data/messages.js.map +1 -0
  41. package/dist/lib/data/participants.js +313 -0
  42. package/dist/lib/data/participants.js.map +1 -0
  43. package/dist/lib/data/users.js +228 -0
  44. package/dist/lib/data/users.js.map +1 -0
  45. package/dist/lib/detailed-delivery-receipt.js +154 -0
  46. package/dist/lib/detailed-delivery-receipt.js.map +1 -0
  47. package/dist/lib/index.js +167 -0
  48. package/dist/lib/index.js.map +1 -0
  49. package/dist/lib/interfaces/notification-types.js +143 -0
  50. package/dist/lib/interfaces/notification-types.js.map +1 -0
  51. package/dist/lib/logger.js +190 -0
  52. package/dist/lib/logger.js.map +1 -0
  53. package/dist/lib/media.js +213 -0
  54. package/dist/lib/media.js.map +1 -0
  55. package/dist/lib/message-builder.js +209 -0
  56. package/dist/lib/message-builder.js.map +1 -0
  57. package/dist/lib/message.js +450 -0
  58. package/dist/lib/message.js.map +1 -0
  59. package/dist/lib/node_modules/tslib/tslib.es6.js +161 -0
  60. package/dist/lib/node_modules/tslib/tslib.es6.js.map +1 -0
  61. package/dist/lib/packages/conversations/package.json.js +136 -0
  62. package/dist/lib/packages/conversations/package.json.js.map +1 -0
  63. package/dist/lib/participant.js +346 -0
  64. package/dist/lib/participant.js.map +1 -0
  65. package/dist/lib/push-notification.js +152 -0
  66. package/dist/lib/push-notification.js.map +1 -0
  67. package/dist/lib/rest-paginator.js +175 -0
  68. package/dist/lib/rest-paginator.js.map +1 -0
  69. package/dist/lib/services/network.js +205 -0
  70. package/dist/lib/services/network.js.map +1 -0
  71. package/dist/lib/services/typing-indicator.js +235 -0
  72. package/dist/lib/services/typing-indicator.js.map +1 -0
  73. package/dist/lib/unsent-message.js +159 -0
  74. package/dist/lib/unsent-message.js.map +1 -0
  75. package/dist/lib/user.js +392 -0
  76. package/dist/lib/user.js.map +1 -0
  77. package/dist/lib/util/deferred.js +154 -0
  78. package/dist/lib/util/deferred.js.map +1 -0
  79. package/dist/lib/util/index.js +206 -0
  80. package/dist/lib/util/index.js.map +1 -0
  81. package/dist/lib.d.ts +250 -59
  82. package/dist/lib.js +3055 -2919
  83. package/dist/lib.js.map +1 -1
  84. package/dist/twilio-conversations.js +25175 -23918
  85. package/dist/twilio-conversations.min.js +14 -2
  86. package/package.json +16 -14
  87. package/CHANGELOG.md +0 -168
  88. package/dist/post-install.js +0 -29
  89. package/dist/react-native.js +0 -4412
  90. package/dist/react-native.js.map +0 -1
package/README.md CHANGED
@@ -7,33 +7,38 @@ Visit our official site for more detalis: [https://www.twilio.com/conversations]
7
7
 
8
8
  Instantiating and using
9
9
  ------------
10
- To use the library you need [to generate a token](https://www.twilio.com/docs/conversations/create-tokens) and pass it to the conversations Client `create` factory.
10
+ To use the library you need [to generate a token](https://www.twilio.com/docs/conversations/create-tokens) and pass it to the Conversations Client constructor.
11
11
 
12
12
  ### NPM
13
13
  ```
14
14
  npm install --save @twilio/conversations
15
15
  ```
16
16
 
17
- Using this method, you can `require` `twilio-conversations` and then use the client:
17
+ Using this method, you can `require` `twilio-conversations` and then use the
18
+ client:
18
19
  ```
19
- const Conversations = require('@twilio/conversations');
20
- Conversations.Client.create(token).then(client => {
21
- // Use client
22
- });
23
- ```
24
-
25
- Or, if you prefer `async`/`await` syntax:
26
- ```
27
- const Conversations = require('@twilio/conversations');
28
- const client = await Conversations.Client.create(token);
29
- // Use client
20
+ const { Client } = require('@twilio/conversations');
21
+ const client = new Client(token);
22
+ // Before you use the client, subscribe to the `'stateChanged'` event and wait
23
+ // for the `'initialized'` state to be reported.
24
+ client.on('stateChanged', (state) => {
25
+ if (state === 'initialized') {
26
+ // Use the client
27
+ }
28
+ }
30
29
  ```
31
30
 
32
31
  The SDK could also be imported using the ES module syntax:
33
32
  ```
34
- import Conversations from '@twilio/conversations';
35
- const client = await Conversations.Client.create(token);
36
- // Use client
33
+ import { Client } from '@twilio/conversations';
34
+ const client = new Client(token);
35
+ // Before you use the client, subscribe to the `'stateChanged'` event and wait
36
+ // for the `'initialized'` state to be reported.
37
+ client.on('stateChanged', (state) => {
38
+ if (state === 'initialized') {
39
+ // Use the client
40
+ }
41
+ }
37
42
  ```
38
43
 
39
44
  ### CDN
@@ -41,19 +46,11 @@ const client = await Conversations.Client.create(token);
41
46
  Releases of `twilio-conversations.js` are hosted on a CDN, and you can include these
42
47
  directly in your web app using a `<script>` tag.
43
48
  ```html
44
- <script src="https://media.twiliocdn.com/sdk/js/conversations/v1.2/twilio-conversations.min.js"></script>
49
+ <script src="https://media.twiliocdn.com/sdk/js/conversations/v2.0/twilio-conversations.min.js"></script>
45
50
  ```
46
- Using this method, `twilio-conversations.js` will set a browser global `Twilio.Conversations` through which you can use the client :
47
- ```
48
- Twilio.Conversations.Client.create(token).then(client => {
49
- // Use client
50
- });
51
- ```
52
-
53
- or, if you prefer `async`/`await` syntax:
51
+ Using this method, `twilio-conversations.js` will set a browser global `Twilio.Conversations` through which you can use the client:
54
52
  ```
55
- let client = await Twilio.Conversations.Client.create(token);
56
- // Use client
53
+ const client = new Twilio.Conversations.Client(token);
57
54
  ```
58
55
 
59
56
  ### Security
@@ -67,7 +64,7 @@ number. While less flexible it is significantly more secure, which is required b
67
64
  To consume securely use the following script snippet format:
68
65
 
69
66
  ```html
70
- <script src="https://media.twiliocdn.com/sdk/js/conversations/releases/1.2.0/twilio-conversations.min.js"
67
+ <script src="https://media.twiliocdn.com/sdk/js/conversations/releases/2.0.1/twilio-conversations.min.js"
71
68
  integrity="sha256-<HASH FROM THE CHANGELOGS PAGE>"
72
69
  crossorigin="anonymous"></script>
73
70
  ```