build: Added dev/preview mode for the spec

remove unused markdown files

package.json

@@ -1,20 +1,24 @@
 {
-  "name": "plex-api-spec-tests",
+  "name": "plex-api-spec",
   "version": "1.0.0",
-  "description": "",
+  "description": "An open source Plex Media Server API Specification",
-  "main": "index.js",
+  "main": "src/pms-spec.yaml",
   "scripts": {
+    "dev": "redocly preview --product=redoc -d=./src",
+    "stats": "redocly stats ./src/pms-spec.yaml",
     "build": "swagger-cli bundle --dereference ./src/pms-spec.yaml -t yaml -o ./output/plex-media-server-spec-dereferenced.yaml",
+    "build-redocly": "redocly bundle ./src/pms-spec.yaml --ext yaml  -o ./output/plex-media-server-spec-dereferenced.yaml",
     "test": "bun run build && vitest --run",
     "setup-speakeasy-cli": "curl -fsSL https://raw.githubusercontent.com/speakeasy-api/speakeasy/main/install.sh | sh",
     "lint": "speakeasy lint openapi -s ./src/pms-spec.yaml",
     "lint-bundled": "bun run build && speakeasy lint openapi -s ./output/plex-media-server-spec-dereferenced.yaml"
   },
-  "keywords": [],
+  "keywords": ["plex", "api", "specification", "openapi", "swagger"],
-  "author": "",
+  "author": "LukeHagar",
   "license": "ISC",
   "devDependencies": {
     "@modyfi/vite-plugin-yaml": "^1.1.0",
+    "@redocly/cli": "^1.22.0",
     "@types/node": "^22.5.0",
     "swagger-cli": "^4.0.4",
     "typescript": "^5.5.4",

src/pms-spec.yaml

@@ -2,7 +2,7 @@ openapi: 3.1.0
 info:
   version: 0.0.3
   title: Plex-API
-  description: An Open API Spec for interacting with Plex.tv
+  description: An Open API Spec for interacting with Plex.tv and Plex Media Server
   contact:
     name: Luke Hagar
     url: 'https://www.LukeHagar.com'
@@ -27,7 +27,7 @@ servers:
 
 x-speakeasy-globals:
   parameters:
-    - $ref: "./parameters/ClientIdentifier.yaml"
+    - $ref: '#/components/parameters/ClientIdentifier'
 
 security:
   - accessToken: []