PKG -- [fcl-core] split fcl to fcl-core, fcl, and fcl-react-native

package.json

@@ -7,7 +7,8 @@
     "start": "npm run build && lerna run start --parallel",
     "test": "jest",
     "release": "npm run build && npm run changeset publish",
-    "changeset": "changeset"
+    "changeset": "changeset",
+    "clear": "find . -name node_modules -type d -prune -exec rm -rf '{}' + && find . -name dist -type d -prune -exec rm -rf '{}' +"
   },
   "name": "fcl-js",
   "devDependencies": {

packages/config/package.json

@@ -20,7 +20,7 @@
     "@typescript-eslint/eslint-plugin": "^6.5.0",
     "@typescript-eslint/parser": "^6.5.0",
     "eslint": "^8.48.0",
-    "eslint-plugin-jsdoc": "^46.5.1",
+    "eslint-plugin-jsdoc": "^46.9.0",
     "jest": "^29.5.0",
     "typescript": "^4.9.5"
   },
@@ -43,6 +43,6 @@
     "@onflow/util-invariant": "^1.2.1",
     "@onflow/util-logger": "^1.3.1",
     "eslint": "^8.34.0",
-    "eslint-plugin-jsdoc": "^40.0.0"
+    "eslint-plugin-jsdoc": "^46.9.0"
   }
 }

packages/fcl-core/.babelrc

@@ -0,0 +1,7 @@
+{
+  "presets": [
+    [
+      "@babel/preset-env"
+    ]
+  ]
+}

packages/fcl-core/.browserslistrc

@@ -0,0 +1,2 @@
+defaults and supports es6-module
+maintained node versions

packages/fcl-core/.eslintrc.json

@@ -0,0 +1,31 @@
+{
+  "env": {
+    "browser": true,
+    "es2021": true,
+    "jest": true,
+    "node": true
+  },
+  "extends": [
+    "plugin:jsdoc/recommended"
+  ],
+  "plugins": [
+    "jsdoc"
+  ],
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "globals": {
+    "JSX": "readonly"
+  },
+  "ignorePatterns": ["**/dist/"],
+
+  "rules": {
+    "jsdoc/require-jsdoc": 0,
+    "jsdoc/tag-lines": 0,
+    "jsdoc/require-param-description": 0,
+    "jsdoc/valid-types": 0,
+    "jsdoc/require-returns-description": 0,
+    "no-undef": 1
+  }
+}

packages/fcl-core/.gitignore

@@ -0,0 +1 @@
+types/

packages/fcl-core/.npmignore

@@ -0,0 +1,2 @@
+src/
+assets/

packages/fcl-core/README.md

@@ -0,0 +1,40 @@
+# FCL: Flow Client Library
+### Making secure web applications powered by the Flow Blockchain
+
+Flow Client Library (FCL) enables applications to easily integrate with all FCL-compatible wallets and
+other services (e.g. (Coming Soon) profiles, private information, notifications). This offers developers a strong
+foundation to compose their apps with existing building blocks. It’s currently supported for browser
+applications, and will be extended to other platforms.
+
+With FCL, you can:
+
+- Integrate all compatible wallets without any custom code or code injection
+- Authenticate users
+- Query the Flow Blockchain
+- Send transactions (e.g. initializing resources, sending assets, purchasing, etc.)
+- Sign transactions through wallet integration avoiding key management
+
+With FCL, you will eventually be able to:
+
+- Personally sign data via FCL Compatible Wallets
+- Request Additional User info like Emails
+
+## Status
+
+- **Last Updated:** Mar 2nd 2021
+- **Stable:** Yes
+- **Risk of Breaking Change:** Low
+
+The things that exists probably won't be changing much externally, we will be adding new functionality in the near future.
+
+## Install
+
+```bash
+npm install --save @onflow/fcl @onflow/types
+```
+
+## Getting Started
+
+For a detailed guide explaining how to use `@onflow/fcl` to interact with Flow please see the [Flow App Quick Start](https://developers.flow.com/tutorials/flow-app-quickstart)
+
+Having trouble with something? Reach out to us on [Discord](https://discord.gg/k6cZ7QC), we are more than happy to help.

packages/fcl-core/TRANSITIONS.md

@@ -0,0 +1,17 @@
+# Transitions
+
+## 0001 Deprecate `env` config key
+- **Date:** May 26th 2022
+- **Type:** Deprecation of `env` in config
+
+When specifying which flow network for FCL to use, use the `flow.network` config key instead of `env` (e.g. `fcl.config.put("flow.network", "testnet")`).  Permitted values are currently `local`, `canarynet`, `testnet`, `mainnet`.
+
+FCL currently falls back to `env` for the `flow.network` field but this will be removed in a future update.
+
+## 0002 Deprecate `flow.network` config key
+- **Date:** September 26th 2022
+- **Type:** Deprecation of `flow.network` in config
+
+FCL now has a built-in utility to get which flow network to use. Manual specification in config is no longer required
+
+FCL currently falls back to `flow.network` in case of failure but this will be removed in a future update.

packages/fcl-core/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@onflow/fcl-core",
+  "version": "1.8.1",
+  "description": "Flow Client Library",
+  "license": "Apache-2.0",
+  "author": "Dapper Labs <dev@dapperlabs.com>",
+  "homepage": "https://onflow.org",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/onflow/flow-js-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/onflow/flow-js-sdk/issues"
+  },
+  "jest": {
+    "testEnvironment": "jsdom",
+    "globals": {
+      "PACKAGE_CURRENT_VERSION": "TESTVERSION"
+    }
+  },
+  "devDependencies": {
+    "@onflow/fcl-bundle": "^1.4.1",
+    "@onflow/typedefs": "^1.2.1",
+    "@types/estree": "^1.0.1",
+    "@types/jest": "^29.5.4",
+    "@types/node": "^18.13.0",
+    "eslint": "^8.35.0",
+    "eslint-plugin-jsdoc": "^46.9.0",
+    "jest": "^29.5.0",
+    "jest-environment-jsdom": "^29.5.0",
+    "typescript": "^4.9.5"
+  },
+  "source": "src/fcl-core.ts",
+  "main": "dist/fcl-core.js",
+  "module": "dist/fcl-core.module.js",
+  "unpkg": "dist/fcl-core.umd.min.js",
+  "types": "types/fcl-core.d.ts",
+  "scripts": {
+    "pain": "npm publish --tag pain",
+    "alpha": "npm publish --tag alpha",
+    "prepublishOnly": "npm test && npm run build",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "build": "npm run lint && fcl-bundle",
+    "build:types": "tsc --project ./tsconfig-web.json && tsc --noResolve --project ./tsconfig-react-native.json",
+    "start": "fcl-bundle --watch",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "@babel/runtime": "^7.18.6",
+    "@onflow/config": "^1.2.1",
+    "@onflow/interaction": "0.0.11",
+    "@onflow/rlp": "^1.2.1",
+    "@onflow/sdk": "^1.3.1",
+    "@onflow/types": "^1.2.1",
+    "@onflow/util-actor": "^1.3.1",
+    "@onflow/util-address": "^1.2.1",
+    "@onflow/util-invariant": "^1.2.1",
+    "@onflow/util-logger": "^1.3.1",
+    "@onflow/util-semver": "^1.0.1",
+    "@onflow/util-template": "^1.2.1",
+    "@onflow/util-uid": "^1.2.1",
+    "cross-fetch": "^3.1.6"
+  }
+}

packages/fcl-core/src/VERSION.js

@@ -0,0 +1 @@
+export const VERSION = PACKAGE_CURRENT_VERSION || "TESTVERSION"

packages/fcl/src/shared-exports.js → packages/fcl-core/src/fcl-core.ts

@@ -126,3 +126,20 @@ import {watchForChainIdChanges} from "./utils"
 
 // Set chain id default on access node change
 watchForChainIdChanges()
+
+
+export {getMutate} from "./exec/mutate"
+
+export {getCurrentUser} from "./current-user"
+
+export {initServiceRegistry} from "./current-user/exec-service/plugins"
+
+export { isReactNative, setIsReactNative } from './utils/is-react-native'
+
+export {getExecHttpPost} from "./current-user/exec-service/strategies/http-post"
+
+export {normalizePollingResponse} from "./normalizers/service/polling-response"
+export {buildMessageHandler} from "./current-user/exec-service/strategies/utils/buildMessageHandler"
+export {serviceEndpoint} from "./current-user/exec-service/strategies/utils/service-endpoint"
+export {URL} from './utils/url'
+export {CORE_STRATEGIES, FCL_REDIRECT_URL_PARAM_NAME, FCL_RESPONSE_PARAM_NAME } from './utils/constants'

packages/fcl-core/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig",
+  // Change this to match your project
+  "include": ["src/**/*"],
+  "compilerOptions": {
+    "declarationDir": "types",
+    "rootDir": "src",
+  }
+}

packages/fcl-react-native/.babelrc

@@ -0,0 +1,7 @@
+{
+  "presets": [
+    [
+      "@babel/preset-env"
+    ]
+  ]
+}

packages/fcl-react-native/.browserslistrc

@@ -0,0 +1,2 @@
+defaults and supports es6-module
+maintained node versions

packages/fcl-react-native/.eslintrc.json

@@ -0,0 +1,31 @@
+{
+  "env": {
+    "browser": true,
+    "es2021": true,
+    "jest": true,
+    "node": true
+  },
+  "extends": [
+    "plugin:jsdoc/recommended"
+  ],
+  "plugins": [
+    "jsdoc"
+  ],
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "globals": {
+    "JSX": "readonly"
+  },
+  "ignorePatterns": ["**/dist/"],
+
+  "rules": {
+    "jsdoc/require-jsdoc": 0,
+    "jsdoc/tag-lines": 0,
+    "jsdoc/require-param-description": 0,
+    "jsdoc/valid-types": 0,
+    "jsdoc/require-returns-description": 0,
+    "no-undef": 1
+  }
+}

packages/fcl-react-native/.gitignore

@@ -0,0 +1 @@
+types/

packages/fcl-react-native/.npmignore

@@ -0,0 +1 @@
+src/

packages/fcl-react-native/README.md

@@ -0,0 +1,40 @@
+# FCL: Flow Client Library
+### Making secure web applications powered by the Flow Blockchain
+
+Flow Client Library (FCL) enables applications to easily integrate with all FCL-compatible wallets and
+other services (e.g. (Coming Soon) profiles, private information, notifications). This offers developers a strong
+foundation to compose their apps with existing building blocks. It’s currently supported for browser
+applications, and will be extended to other platforms.
+
+With FCL, you can:
+
+- Integrate all compatible wallets without any custom code or code injection
+- Authenticate users
+- Query the Flow Blockchain
+- Send transactions (e.g. initializing resources, sending assets, purchasing, etc.)
+- Sign transactions through wallet integration avoiding key management
+
+With FCL, you will eventually be able to:
+
+- Personally sign data via FCL Compatible Wallets
+- Request Additional User info like Emails
+
+## Status
+
+- **Last Updated:** Mar 2nd 2021
+- **Stable:** Yes
+- **Risk of Breaking Change:** Low
+
+The things that exists probably won't be changing much externally, we will be adding new functionality in the near future.
+
+## Install
+
+```bash
+npm install --save @onflow/fcl @onflow/types
+```
+
+## Getting Started
+
+For a detailed guide explaining how to use `@onflow/fcl` to interact with Flow please see the [Flow App Quick Start](https://developers.flow.com/tutorials/flow-app-quickstart)
+
+Having trouble with something? Reach out to us on [Discord](https://discord.gg/k6cZ7QC), we are more than happy to help.