[CHA-188] Added typedoc to package reqs.

.github/workflows/docks.yml

@@ -0,0 +1,42 @@
+name: API Reference
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+    tags:
+      - '*'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      deployments: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Use Node.js 20.x
+        uses: actions/setup-node@v3
+        with:
+          node-version: 20.x
+
+      - name: Install Package Dependencies
+        run: npm ci
+
+      - name: Build Documentation
+        run: npm run docs
+
+      - name: Configure AWS Credentials
+        uses: aws-actions/configure-aws-credentials@v1
+        with:
+          aws-region: eu-west-2
+          role-to-assume: arn:aws:iam::${{ secrets.ABLY_AWS_ACCOUNT_ID_SDK }}:role/ably-labs-sdk-builds-ably-chat-js
+          role-session-name: "${{ github.run_id }}-${{ github.run_number }}"
+
+      - name: Upload Documentation
+        uses: ably/sdk-upload-action@v1
+        with:
+          sourcePath: typedoc/generated
+          githubToken: ${{ secrets.GITHUB_TOKEN }}
+          artifactName: typedoc

package.json

@@ -46,6 +46,7 @@
     "eslint-plugin-react-refresh": "^0.4.6",
     "eslint-plugin-security": "^1.7.1",
     "prettier": "^3.2.5",
+    "typedoc": "^0.25.13",
     "typescript": "^5.4.5",
     "vitest": "^1.4.0"
   },

tsconfig.base.json

@@ -16,5 +16,5 @@
     "allowSyntheticDefaultImports": true,
     "lib": ["DOM", "DOM.Iterable", "ESNext"],
     "types": ["node"]
-  }
+  },
 }

typedoc.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://typedoc.org/schema.json",
+  "entryPoints": ["src/index.ts"],
+  "out": "typedoc/generated",
+  "readme": "typedoc/landing-page.md",
+  "tsconfig": "tsconfig.base.json",
+  "treatWarningsAsErrors": false,
+  "includeVersion": true,
+  "validation": true,
+  "requiredToBeDocumented": [
+    "Accessor",
+    "Class",
+    "Constructor",
+    "Enum",
+    "EnumMember",
+    "Function",
+    "Interface",
+    "Method",
+    "Parameter",
+    "Property",
+    "TypeAlias",
+    "Variable",
+    "Namespace"
+  ]
+}

typedoc/landing-page.md

@@ -0,0 +1,6 @@
+# Ably Chat JavaScript Client Library SDK API Reference
+
+The JavaScript Client Library SDK supports chat functionality over ably realtime. The JavaScript API references are generated from the [Ably Chat JavaScript Client Library SDK source code](https://github.com/ably-labs/ably-chat-js) using [TypeDoc](https://typedoc.org) and structured by classes.
+
+The Chat SDK is built on top of the Ably Realtime SDK and provides a higher-level API for building chat applications. It includes features such as entering/leaving conversations, sending messages, room reactions, presence, typing indicators, and more.
+