snack-sdk 3.6.0 → 3.9.0

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 (71) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/build/DependencyResolver.d.ts +2 -1
  3. package/build/DependencyResolver.js +6 -5
  4. package/build/DependencyResolver.js.map +1 -1
  5. package/build/FileUploader.d.ts +2 -1
  6. package/build/FileUploader.js.map +1 -1
  7. package/build/Session.d.ts +6 -1
  8. package/build/Session.js +16 -7
  9. package/build/Session.js.map +1 -1
  10. package/build/State.js +2 -2
  11. package/build/State.js.map +1 -1
  12. package/build/WantedVersions.d.ts +30 -6
  13. package/build/WantedVersions.js +86 -26
  14. package/build/WantedVersions.js.map +1 -1
  15. package/build/defaultConfig.d.ts +2 -3
  16. package/build/defaultConfig.js +4 -4
  17. package/build/defaultConfig.js.map +1 -1
  18. package/build/index.d.ts +2 -2
  19. package/build/index.js +8 -8
  20. package/build/index.js.map +1 -1
  21. package/build/transports/CodeMessageBuilder.d.ts +1 -1
  22. package/build/transports/CodeMessageBuilder.js +2 -2
  23. package/build/transports/CodeMessageBuilder.js.map +1 -1
  24. package/build/transports/Protocol.d.ts +1 -1
  25. package/build/transports/Protocol.js.map +1 -1
  26. package/build/transports/Transport.d.ts +1 -0
  27. package/build/transports/Transport.js +6 -1
  28. package/build/transports/Transport.js.map +1 -1
  29. package/build/transports/types.d.ts +1 -1
  30. package/build/transports/types.js.map +1 -1
  31. package/build/transports/webPlayer.d.ts +2 -1
  32. package/build/transports/webPlayer.js.map +1 -1
  33. package/build/types.d.ts +10 -75
  34. package/build/types.js.map +1 -1
  35. package/build/utils.d.ts +2 -1
  36. package/build/utils.js.map +1 -1
  37. package/package.json +12 -4
  38. package/build/sdk.d.ts +0 -34
  39. package/build/sdk.js +0 -139
  40. package/build/sdk.js.map +0 -1
  41. package/build/sdks/features.d.ts +0 -9
  42. package/build/sdks/features.js +0 -13
  43. package/build/sdks/features.js.map +0 -1
  44. package/build/sdks/index.d.ts +0 -5
  45. package/build/sdks/index.js +0 -124
  46. package/build/sdks/index.js.map +0 -1
  47. package/build/sdks/types.d.ts +0 -21
  48. package/build/sdks/types.js +0 -3
  49. package/build/sdks/types.js.map +0 -1
  50. package/src/DependencyResolver.ts +0 -214
  51. package/src/DevSession.ts +0 -159
  52. package/src/FileUploader.ts +0 -133
  53. package/src/Logger.ts +0 -33
  54. package/src/Session.ts +0 -1280
  55. package/src/State.ts +0 -98
  56. package/src/WantedVersions.ts +0 -56
  57. package/src/defaultConfig.ts +0 -33
  58. package/src/index.ts +0 -31
  59. package/src/sdk.ts +0 -135
  60. package/src/sdks/features.ts +0 -11
  61. package/src/sdks/index.ts +0 -159
  62. package/src/sdks/types.ts +0 -49
  63. package/src/transports/CodeMessageBuilder.ts +0 -221
  64. package/src/transports/Protocol.ts +0 -78
  65. package/src/transports/Transport.ts +0 -270
  66. package/src/transports/index.ts +0 -8
  67. package/src/transports/types.ts +0 -88
  68. package/src/transports/webPlayer.ts +0 -91
  69. package/src/types.ts +0 -287
  70. package/src/utils.ts +0 -70
  71. package/tsconfig.json +0 -28
package/src/State.ts DELETED
@@ -1,98 +0,0 @@
1
- import isEqual from 'lodash/isEqual';
2
-
3
- import { isModulePreloaded } from './sdk';
4
- import { SnackState } from './types';
5
-
6
- export type StateObject<T> = {
7
- [key: string]: T;
8
- };
9
-
10
- export function addObjects<T>(
11
- state: StateObject<T>,
12
- content: { [key: string]: T },
13
- filter?: (a: T, b: T) => boolean
14
- ): StateObject<T> {
15
- let newState: StateObject<T> | null = null;
16
- for (const key in content) {
17
- if (filter ? filter(content[key], state[key]) : !isEqual(content[key], state[key])) {
18
- newState = newState ?? { ...state };
19
- newState[key] = content[key];
20
- }
21
- }
22
- return newState ?? state;
23
- }
24
-
25
- export function addObject<T>(
26
- state: StateObject<T>,
27
- key: string,
28
- content: T,
29
- filter?: (a: T, b: T) => boolean
30
- ): StateObject<T> {
31
- return addObjects(state, { [key]: content }, filter);
32
- }
33
-
34
- export function removeObjects<T>(state: StateObject<T>, keys: string[]): StateObject<T> {
35
- if (!keys.length) return state;
36
- let newState: StateObject<T> | null = null;
37
- keys.forEach((key) => {
38
- if (state[key]) {
39
- newState = newState ?? { ...state };
40
- delete newState[key];
41
- }
42
- });
43
- return newState ?? state;
44
- }
45
-
46
- export function removeObject<T>(state: StateObject<T>, key: string): StateObject<T> {
47
- return removeObjects(state, [key]);
48
- }
49
-
50
- export function updateObjects<T>(
51
- state: StateObject<T>,
52
- content: { [key: string]: T | null },
53
- compareFn: (a: T, b: T) => boolean = isEqual
54
- ): StateObject<T> {
55
- let newState: StateObject<T> | null = null;
56
- for (const key in content) {
57
- const val = content[key];
58
- if (val === null) {
59
- if (state[key]) {
60
- newState = newState ?? { ...state };
61
- delete newState[key];
62
- }
63
- } else if (!compareFn(val, state[key])) {
64
- newState = newState ?? { ...state };
65
- newState[key] = val;
66
- }
67
- }
68
- return newState ?? state;
69
- }
70
-
71
- export function isBusy(state: SnackState): boolean {
72
- return (
73
- !!Object.keys(state.dependencies).find(
74
- (name) => !state.dependencies[name].handle && !isModulePreloaded(name, state.sdkVersion)
75
- ) ||
76
- !!Object.values(state.files).find(
77
- (file) => file.type === 'ASSET' && typeof file.contents !== 'string'
78
- )
79
- );
80
- }
81
-
82
- export function isCodeChanged(state: SnackState, prevState: SnackState) {
83
- return (
84
- state.dependencies !== prevState.dependencies ||
85
- state.files !== prevState.files ||
86
- state.sdkVersion !== prevState.sdkVersion
87
- );
88
- }
89
-
90
- export function isUnsaved(state: SnackState, prevState: SnackState) {
91
- return (
92
- state.dependencies !== prevState.dependencies ||
93
- state.files !== prevState.files ||
94
- state.sdkVersion !== prevState.sdkVersion ||
95
- state.name !== prevState.name ||
96
- state.description !== prevState.description
97
- );
98
- }
@@ -1,56 +0,0 @@
1
- import { Logger } from './Logger';
2
- import sdks from './sdks';
3
- import { SDKVersion, SnackDependencyVersions, SnackError } from './types';
4
- import { fetch } from './utils';
5
-
6
- export type WantedDependencyVersionsCallback = (
7
- sdkVersion: SDKVersion,
8
- result?: SnackDependencyVersions,
9
- error?: SnackError
10
- ) => any;
11
-
12
- export class WantedDependencyVersions {
13
- private readonly callback: WantedDependencyVersionsCallback;
14
- private readonly logger?: Logger;
15
- private sdkVersion?: SDKVersion;
16
- private promise: Promise<any>;
17
-
18
- constructor(options: { logger?: Logger; callback: WantedDependencyVersionsCallback }) {
19
- this.logger = options.logger;
20
- this.callback = options.callback;
21
- this.promise = Promise.resolve();
22
- }
23
-
24
- setSDKVersion(sdkVersion: SDKVersion) {
25
- if (this.sdkVersion !== sdkVersion) {
26
- this.sdkVersion = sdkVersion;
27
- this.promise = this._fetch(sdkVersion);
28
- }
29
- }
30
-
31
- waitForCompletion() {
32
- return this.promise;
33
- }
34
-
35
- private async _fetch(sdkVersion: SDKVersion): Promise<any> {
36
- let json: any;
37
- try {
38
- this.logger?.module('fetching bundledNativeModules for SDK', sdkVersion, '...');
39
- const url = `https://cdn.jsdelivr.net/npm/expo@${encodeURIComponent(
40
- sdks[sdkVersion]?.version || sdkVersion
41
- )}/bundledNativeModules.json`;
42
- const response = await fetch(url);
43
- json = await response.json();
44
- } catch (e) {
45
- if (this.sdkVersion === sdkVersion) {
46
- this.logger?.error(e);
47
- this.callback(sdkVersion, undefined, e);
48
- }
49
- return;
50
- }
51
- if (this.sdkVersion === sdkVersion) {
52
- this.logger?.module('fetched bundledNativeModules for SDK', sdkVersion, json);
53
- this.callback(sdkVersion, json);
54
- }
55
- }
56
- }
@@ -1,33 +0,0 @@
1
- import { SDKVersion, SnackState } from './types';
2
-
3
- export const apiURL: string = 'https://exp.host';
4
- export const snackagerURL: string = 'https://snackager.expo.io';
5
- export const webPlayerURL: string =
6
- 'https://snack-web-player.s3.us-west-1.amazonaws.com/v2/%%SDK_VERSION%%';
7
-
8
- export const sdkVersion: SDKVersion = '42.0.0';
9
-
10
- export const SnackIdentityState: SnackState = {
11
- sdkVersion,
12
- name: '',
13
- description: '',
14
- dependencies: {},
15
- missingDependencies: {},
16
- files: {},
17
- connectedClients: {},
18
- transports: {},
19
- disabled: false,
20
- unsaved: false,
21
- online: false,
22
- url: '',
23
- channel: '',
24
- };
25
-
26
- const defaultConfig = {
27
- apiURL,
28
- snackagerURL,
29
- sdkVersion,
30
- webPlayerURL,
31
- };
32
-
33
- export default defaultConfig;
package/src/index.ts DELETED
@@ -1,31 +0,0 @@
1
- import Snack, {
2
- SnackOptions,
3
- SnackSaveOptions,
4
- SnackStateListener,
5
- SnackLogListener,
6
- } from './Session';
7
- import defaultConfig from './defaultConfig';
8
- import {
9
- isModulePreloaded,
10
- getPreloadedModules,
11
- isValidSemver,
12
- getSupportedSDKVersions,
13
- isFeatureSupported,
14
- standardizeDependencies,
15
- getDeprecatedModule,
16
- } from './sdk';
17
-
18
- export * from './transports';
19
- export * from './types';
20
- export type { SnackOptions, SnackSaveOptions, SnackStateListener, SnackLogListener };
21
- export {
22
- isModulePreloaded,
23
- getPreloadedModules,
24
- isValidSemver,
25
- getSupportedSDKVersions,
26
- isFeatureSupported,
27
- standardizeDependencies,
28
- getDeprecatedModule,
29
- defaultConfig,
30
- Snack,
31
- };
package/src/sdk.ts DELETED
@@ -1,135 +0,0 @@
1
- import semver from 'semver';
2
-
3
- import sdks from './sdks';
4
- import features from './sdks/features';
5
- import { SDKVersion, SDKFeature, SnackDependencies, SnackDependencyVersions } from './types';
6
-
7
- /**
8
- * Checks whether a specific module/dependency is preloaded for the given SDK version.
9
- */
10
- export function isModulePreloaded(
11
- name: string,
12
- sdkVersion: SDKVersion,
13
- coreModulesOnly?: boolean
14
- ): boolean {
15
- const sdk = sdks[sdkVersion];
16
- if (!sdk) return false;
17
- return !!(sdk.coreModules[name] || (!coreModulesOnly && sdk.bundledModules[name]));
18
- }
19
-
20
- /**
21
- * Returns the list of pre-loaded modules for the given SDK version.
22
- */
23
- export function getPreloadedModules(
24
- sdkVersion: SDKVersion,
25
- coreModulesOnly?: boolean
26
- ): { [name: string]: string } {
27
- const sdk = sdks[sdkVersion];
28
- if (!sdk) return {};
29
- return coreModulesOnly
30
- ? sdk.coreModules
31
- : {
32
- ...sdk.coreModules,
33
- ...sdk.bundledModules,
34
- };
35
- }
36
-
37
- export function validateSDKVersion(sdkVersion: SDKVersion): SDKVersion {
38
- if (Object.keys(sdks).indexOf(sdkVersion) < 0) {
39
- throw new Error(
40
- `Invalid SDKVersion, the following versions are supported: ${Object.keys(sdks)}`
41
- );
42
- }
43
- return sdkVersion;
44
- }
45
-
46
- /**
47
- * Checks whether the module is deprecated for the given sdk-version and returns
48
- * the alternative module or error description instead. If the module is not deprecated
49
- * `undefined` is returned.
50
- */
51
- export function getDeprecatedModule(name: string, sdkVersion: SDKVersion): string | undefined {
52
- return sdks[sdkVersion]?.deprecatedModules?.[name];
53
- }
54
-
55
- /**
56
- * Returns the list of supported SDK versions.
57
- */
58
- export function getSupportedSDKVersions(): SDKVersion[] {
59
- return Object.keys(sdks) as SDKVersion[];
60
- }
61
-
62
- /**
63
- * Verifies whether a string is a valid semver.
64
- */
65
- export function isValidSemver(version: string): boolean {
66
- return version === 'latest' || !!semver.validRange(version);
67
- }
68
-
69
- /**
70
- * Checks whether a feature is supported by the given SDK version.
71
- */
72
- export function isFeatureSupported(feature: SDKFeature, sdkVersion: string): boolean {
73
- const featureVersion = features[feature];
74
- if (!featureVersion) {
75
- throw new Error(
76
- `Invalid SDKFeature, the following versions are supported: ${Object.keys(features)}`
77
- );
78
- }
79
- return semver.gte(sdkVersion, featureVersion);
80
- }
81
-
82
- /**
83
- * @internal
84
- */
85
- function standardizePeerDependencies(peerDependencies: any): SnackDependencyVersions {
86
- if (!peerDependencies) {
87
- return peerDependencies;
88
- }
89
- let result: SnackDependencyVersions = peerDependencies;
90
- for (const name in peerDependencies) {
91
- const peerDep = peerDependencies[name];
92
- if (typeof peerDep === 'string' || peerDep === null) {
93
- // :thumbsup: regular peer-dependency
94
- } else if (typeof peerDep === 'object' && typeof peerDep.version === 'string') {
95
- result = result === peerDependencies ? { ...peerDependencies } : result;
96
- result[name] = peerDep.version;
97
- } else {
98
- // Invalid peer-dependency
99
- result = result === peerDependencies ? { ...peerDependencies } : result;
100
- delete result[name];
101
- }
102
- }
103
-
104
- return result;
105
- }
106
-
107
- /**
108
- * Converts older dependency formats into the SnackDependencies type.
109
- */
110
- export function standardizeDependencies(dependencies: any): SnackDependencies {
111
- let result: SnackDependencies = dependencies;
112
- for (const name in dependencies) {
113
- const dep = dependencies[name];
114
- if (typeof dep === 'string') {
115
- result = result === dependencies ? { ...dependencies } : result;
116
- result[name] = {
117
- version: dep,
118
- };
119
- } else if (typeof dep === 'object') {
120
- const peerDependencies = standardizePeerDependencies(dep.peerDependencies);
121
- if (dep.peerDependencies !== peerDependencies) {
122
- result = result === dependencies ? { ...dependencies } : result;
123
- result[name] = {
124
- ...dep,
125
- peerDependencies,
126
- };
127
- }
128
- } else {
129
- // Invalid dependency
130
- result = result === dependencies ? { ...dependencies } : result;
131
- delete result[name];
132
- }
133
- }
134
- return result;
135
- }
@@ -1,11 +0,0 @@
1
- // minimum SDK versions that support snack features
2
- const features = {
3
- MULTIPLE_FILES: '21.0.0',
4
- PROJECT_DEPENDENCIES: '25.0.0',
5
- TYPESCRIPT: '31.0.0',
6
- UNIMODULE_IMPORTS: '33.0.0',
7
- POSTMESSAGE_TRANSPORT: '35.0.0',
8
- VERSIONED_SNACKAGER: '37.0.0',
9
- };
10
-
11
- export default features;
package/src/sdks/index.ts DELETED
@@ -1,159 +0,0 @@
1
- import { SDKSpec } from './types';
2
-
3
- const assets = {
4
- // @expo/snack-static/react-native-logo.png is an alias that is
5
- // implemented in the runtime, and uses by the react-native image docs
6
- '@expo/snack-static/react-native-logo.png': '*',
7
- };
8
-
9
- const unimodules: { [name: string]: '*' } = {
10
- '@unimodules/core': '*',
11
- '@unimodules/react-native-adapter': '*',
12
- };
13
- const legacyUnimoduleInterfaces: { [name: string]: '*' } = {
14
- 'unimodules-barcode-scanner-interface': '*',
15
- 'unimodules-camera-interface': '*',
16
- 'unimodules-constants-interface': '*',
17
- 'unimodules-face-detector-interface': '*',
18
- 'unimodules-file-system-interface': '*',
19
- 'unimodules-font-interface': '*',
20
- 'unimodules-image-loader-interface': '*',
21
- 'unimodules-permissions-interface': '*',
22
- 'unimodules-sensors-interface': '*',
23
- 'unimodules-task-manager-interface': '*',
24
- };
25
-
26
- const sdks: { [version: string]: SDKSpec } = {
27
- '40.0.0': {
28
- version: '^40.0.0',
29
- coreModules: {
30
- ...assets,
31
- ...unimodules,
32
- ...legacyUnimoduleInterfaces,
33
- expo: '40.0.1',
34
- react: '16.13.1',
35
- 'react-native': '0.63.2',
36
- 'react-dom': '*',
37
- 'react-native-web': '*',
38
- },
39
- bundledModules: {
40
- // Packages that require special initialisation (see Modules.tsx)
41
- 'expo-asset': '*',
42
- 'expo-font': '*',
43
- 'react-native-gesture-handler': '*',
44
- 'react-native-safe-area-context': '*',
45
- // 'react-native-vector-icons': '*',
46
- '@expo/vector-icons': '*',
47
-
48
- // Packages that are used internally by the runtime
49
- 'expo-constants': '*',
50
- 'expo-file-system': '*',
51
- 'expo-permissions': '*',
52
- 'expo-updates': '*',
53
- '@react-native-community/async-storage': '*',
54
-
55
- // Common packages that are included for easy of use
56
- 'prop-types': '*',
57
- },
58
- },
59
- '41.0.0': {
60
- version: '^41.0.0',
61
- coreModules: {
62
- ...assets,
63
- ...unimodules,
64
- ...legacyUnimoduleInterfaces,
65
- expo: '41.0.0',
66
- react: '16.13.1',
67
- 'react-native': '0.63.2',
68
- 'react-dom': '*',
69
- 'react-native-web': '*',
70
- },
71
- bundledModules: {
72
- // Packages that require special initialisation (see Modules.tsx)
73
- 'expo-asset': '*',
74
- 'expo-font': '*',
75
- 'react-native-gesture-handler': '*',
76
- 'react-native-safe-area-context': '*',
77
- // 'react-native-vector-icons': '*',
78
- '@expo/vector-icons': '*',
79
-
80
- // Packages that are used internally by the runtime
81
- 'expo-constants': '*',
82
- 'expo-file-system': '*',
83
- 'expo-permissions': '*',
84
- 'expo-updates': '*',
85
- '@react-native-async-storage/async-storage': '*',
86
-
87
- // Common packages that are included for easy of use
88
- 'prop-types': '*',
89
- },
90
- deprecatedModules: {
91
- '@react-native-community/async-storage':
92
- 'Async Storage has moved to new organization: https://github.com/react-native-async-storage/async-storage',
93
- 'expo-permissions':
94
- 'Use permissions getters and requesters in specific modules instead, such as MediaLibrary.getPermissionsAsync() and MediaLibrary.requestPermissionsAsync().',
95
- },
96
- },
97
- '42.0.0': {
98
- version: '^42.0.0',
99
- coreModules: {
100
- ...assets,
101
- ...unimodules,
102
- expo: '42.0.0',
103
- react: '16.13.1',
104
- 'react-native': '0.63.4',
105
- 'react-dom': '*',
106
- 'react-native-web': '*',
107
- },
108
- bundledModules: {
109
- 'expo-asset': '*',
110
- 'expo-font': '*',
111
- 'react-native-gesture-handler': '*',
112
- 'react-native-safe-area-context': '*',
113
- '@expo/vector-icons': '*',
114
- 'expo-constants': '*',
115
- 'expo-file-system': '*',
116
- 'expo-updates': '*',
117
- '@react-native-async-storage/async-storage': '*',
118
- 'prop-types': '*',
119
- },
120
- deprecatedModules: {
121
- '@react-native-community/async-storage':
122
- 'Async Storage has moved to new organization: https://github.com/react-native-async-storage/async-storage',
123
- 'expo-permissions':
124
- 'Use permissions getters and requesters in specific modules instead, such as MediaLibrary.getPermissionsAsync() and MediaLibrary.requestPermissionsAsync().',
125
- },
126
- },
127
- '43.0.0': {
128
- version: '^43.0.0',
129
- coreModules: {
130
- ...assets,
131
- ...unimodules,
132
- expo: '~43.0.0',
133
- react: '17.0.1',
134
- 'react-native': '0.64.2',
135
- 'react-dom': '*',
136
- 'react-native-web': '*',
137
- },
138
- bundledModules: {
139
- 'expo-asset': '*',
140
- 'expo-font': '*',
141
- 'react-native-gesture-handler': '*',
142
- 'react-native-safe-area-context': '*',
143
- '@expo/vector-icons': '*',
144
- 'expo-constants': '*',
145
- 'expo-file-system': '*',
146
- 'expo-updates': '*',
147
- '@react-native-async-storage/async-storage': '*',
148
- 'prop-types': '*',
149
- },
150
- deprecatedModules: {
151
- '@react-native-community/async-storage':
152
- 'Async Storage has moved to new organization: https://github.com/react-native-async-storage/async-storage',
153
- 'expo-permissions':
154
- 'Use permissions getters and requesters in specific modules instead, such as MediaLibrary.getPermissionsAsync() and MediaLibrary.requestPermissionsAsync().',
155
- },
156
- },
157
- };
158
-
159
- export default sdks;
package/src/sdks/types.ts DELETED
@@ -1,49 +0,0 @@
1
- /**
2
- * Version of the sdk to use (e.g. "43.0.0").
3
- */
4
- export type SDKVersion = '40.0.0' | '41.0.0' | '42.0.0' | '43.0.0';
5
-
6
- /** @internal */
7
- export type SDKSpec = {
8
- // Version-spec for the published "expo" package. This version is
9
- // used to fetch compatible package versions. The value is typically
10
- // in the form of "^39.0.0" but may also contain custom specs, such
11
- // as "40.0.0-beta.2".
12
- version: string;
13
-
14
- // Modules that are pre-loaded by the Snack runtime, and which
15
- // the user does not need to add to `package.json`.
16
- // The version for these packages is hardcoded as it cannot be
17
- // resolved using bundledNativeModules.json.
18
- coreModules: {
19
- [name: string]: string;
20
- };
21
-
22
- // Modules that are pre-loaded by the Snack runtime, but which
23
- // are expected to be added as a dependency anyway. This ensures
24
- // that `package.json` is up to date, when downloading the Snack
25
- // as a zip-file. These modules don't have versions defined, but
26
- // instead bundledNativeModules.json should be used to obtain
27
- // the recent version.
28
- bundledModules: {
29
- [name: string]: '*';
30
- };
31
-
32
- // Modules that have been deprecated. The value represents a valid
33
- // a description providing a solution or explanation (eg.
34
- // "expo-permissions": "Use permissions getters and requesters in specific modules instead...""
35
- deprecatedModules?: {
36
- [name: string]: string;
37
- };
38
- };
39
-
40
- /**
41
- * Feature that is supported by the SDK (e.g. "TYPESCRIPT").
42
- */
43
- export type SDKFeature =
44
- | 'MULTIPLE_FILES'
45
- | 'PROJECT_DEPENDENCIES'
46
- | 'TYPESCRIPT'
47
- | 'UNIMODULE_IMPORTS'
48
- | 'POSTMESSAGE_TRANSPORT'
49
- | 'VERSIONED_SNACKAGER';