feat: apollo graphql link and server

.github/workflows/build.yml

@@ -1,6 +1,7 @@
 name: Build
 
 on:
+  workflow_dispatch:
   push:
   pull_request:
     branches: [ $default-branch ]

.github/workflows/release.yml

@@ -0,0 +1,117 @@
+name: Test, Build, Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      shouldPublish:
+        description: 'Publish'
+        required: true
+        default: true
+        type: boolean
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Install Node
+        uses: actions/setup-node@v2
+        with:
+          node-version: 12
+
+      - name: Install Yarn
+        run: npm install -g yarn
+
+      - name: Cache dependencies
+        uses: actions/cache@v2
+        with:
+          path: ~/.yarn
+          key: ${{ runner.OS }}-node-${{ hashFiles('**/yarn.lock') }}
+          restore-keys: |
+            ${{ runner.OS }}-node-
+            ${{ runner.OS }}-
+
+      - name: Install dependencies
+        run: yarn --frozen-lockfile
+
+      - name: Lint
+        run: yarn lint
+
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Install Node
+        uses: actions/setup-node@v2
+        with:
+          node-version: 12
+
+      - name: Install Yarn
+        run: npm install -g yarn
+
+      - name: Cache dependencies
+        uses: actions/cache@v2
+        with:
+          path: ~/.yarn
+          key: ${{ runner.OS }}-node-${{ hashFiles('**/yarn.lock') }}
+          restore-keys: |
+            ${{ runner.OS }}-node-
+            ${{ runner.OS }}-
+
+      - name: Install dependencies
+        run: yarn --frozen-lockfile
+
+      - name: Test
+        run: yarn test
+
+  compile_publish:
+    needs:
+      - lint
+      - test
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Install Node
+        uses: actions/setup-node@v2
+        with:
+          node-version: 12
+
+      - name: Install Yarn
+        run: npm install -g yarn
+
+      - name: Cache dependencies
+        uses: actions/cache@v2
+        with:
+          path: ~/.yarn
+          key: ${{ runner.OS }}-node-${{ hashFiles('**/yarn.lock') }}
+          restore-keys: |
+            ${{ runner.OS }}-node-
+            ${{ runner.OS }}-
+
+      - name: Install dependencies
+        run: yarn --frozen-lockfile
+
+      - name: Compile
+        run: yarn build
+
+      - uses: fregante/setup-git-user@v1
+
+      - name: Set NPM Token
+        run: echo //registry.npmjs.org/:_authToken=${NPM_TOKEN} > .npmrc
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Publish
+        if: ${{ github.event.inputs.shouldPublish == 'true' }}
+        run: yarn lerna publish from-package --yes --no-verify-access
+

.gitignore

@@ -96,6 +96,10 @@ yarn-error.log
 # and uncomment the following lines
 # .pnp.*
 
+### npm ###
+# the project uses Yarn so we will not check in package-lock files
+package-lock.json
+
 ### macOS ###
 # General
 .DS_Store

README.md

@@ -1,11 +1,3 @@
-## Under Development
-
-**This branch is a work in progress rewrite of rsocket-js from [Flow](https://flow.org/) to [TypeScript](https://www.typescriptlang.org/). Please see [#158](https://github.com/rsocket/rsocket-js/issues/158).**
-
-**You SHOULD NOT leverage any artifacts published from this branch as all are considered unstable.**
-
-**Please see the [master](https://github.com/rsocket/rsocket-js/tree/master) branch for source used to publish the latest `0.x.x` versions on NPM.**
-
 # [rsocket-js](https://github.com/rsocket/rsocket-js)
 
 [![Build](https://github.com/rsocket/rsocket-js/actions/workflows/build.yml/badge.svg?branch=1.0.x)](https://github.com/rsocket/rsocket-js/actions/workflows/build.yml)
@@ -26,18 +18,39 @@ protocol intended for use in browsers and/or Node.js. From [rsocket.io](http://r
 > - event subscription (infinite stream of many)
 > - channel (bi-directional streams)
 
-## Install
+## Status
+
+This branch contains a rewrite (with significant changes) of rsocket-js from [Flow](https://flow.org/) to [TypeScript](https://www.typescriptlang.org/). Please see [#158](https://github.com/rsocket/rsocket-js/issues/158) for additional details.
+
+The artifacts published from this branch are considered UNSTABLE and may be subject to breaking changes while in preview.
 
-TODO: add install instructions
+**Please see the [master](https://github.com/rsocket/rsocket-js/tree/master) branch for sources related to `0.x.x` versions.**
+
+## Installation
+
+Individual packages published from this monorepo are distributed via NPM.
+
+Packages are independently versioned.
+
+- [rsocket-core](https://www.npmjs.com/package/rsocket-core)
+- [rsocket-messaging](https://www.npmjs.com/package/rsocket-messaging)
+- [rsocket-composite-metadata](https://www.npmjs.com/package/rsocket-composite-metadata)
+- [rsocket-tcp-client](https://www.npmjs.com/package/rsocket-tcp-client)
+- [rsocket-tcp-server](https://www.npmjs.com/package/rsocket-tcp-server)
+- [rsocket-websocket-client](https://www.npmjs.com/package/rsocket-websocket-client)
+- [rsocket-websocket-server](https://www.npmjs.com/package/rsocket-websocket-server)
+- [rsocket-adapter-rxjs](https://www.npmjs.com/package/rsocket-adapter-rxjs)
 
 ## Contributing
 
 TODO: add `CONTRIBUTING.md`
 
-## Documentation
+## Documentation & Examples
+
+See [packages/rsocket-examples](https://github.com/rsocket/rsocket-js/tree/1.0.x-alpha/packages/rsocket-examples/src) for examples.
 
-https://rsocket.io/guides/rsocket-js
+Guides for `0.x.x` versions can be found on https://rsocket.io/guides/rsocket-js.
 
 ## License
 
-TODO: add license
+See LICENSE file.

RELEASE.md

@@ -0,0 +1,23 @@
+# Release
+
+How to publish new releases for this project.
+
+## Versioning
+
+[semver](https://semver.org/) should be followed when deciding new release versions.
+
+You can either set versions in the `package.json` files manually, or use the `lerna version` command to set them via the Lerna CLI. When setting versions manually, you will also need to set the git tags for each package and version.  For this reason, it is recommended you use the `lerna version` command, which will create these tags automatically.
+
+ex: `@rsocket/[email protected]`
+
+Lerna will not push the git tags after creation. You should push the git tags once you are confident in your changes.
+
+## Publishing
+
+The `Test, Build, Release` Workflow on GitHub can be run to [manually trigger](https://docs.github.com/en/actions/managing-workflow-runs/manually-running-a-workflow) publishing of packages to NPM. This workflow will only publish versions which do not already exist on NPM.
+
+The `Test, Build, Release` Workflow will:
+
+- Run automated linting & tests
+- Compile/build various packages
+- Publish built packages to NPM

lerna.json

@@ -4,5 +4,14 @@
   ],
   "version": "independent",
   "useWorkspaces": true,
-  "npmClient": "yarn"
+  "npmClient": "yarn",
+  "command": {
+    "publish": {
+      "message": "chore(release): release"
+    },
+    "version": {
+      "push": false,
+      "allowBranch": ["main", "1.0.x-alpha"]
+    }
+  }
 }