devsense-php-ls 1.0.17329 → 1.0.17357

package/README.md

@@ -2,13 +2,79 @@
 
 This package provides language server for PHP.
 
-## Language Server
+## 🧠 Language Server
 
 The language server executable is a binary platform specific file installed as a dependency, located at `node_modules/devsense-php-ls-$os-$cpu/dist/devsense.php.ls`.
 
-Upon starting, the process is controlled using Language Server Protocol according to https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/ through STDIN/STDOUT.
+## 🧬 Protocol
 
-## Protocol Extensions
+Upon starting, the language server is controlled using the Language Server Protocol according to https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/ through STDIN/STDOUT.
 
-_to be specified_
+There are several additions:
 
+- `"initialize"` method, parameter:
+
+```json
+{
+    "initializationOptions": {
+        "0": "<license signature>",
+        // VSCode settings and their values listed on
+        // https://docs.devsense.com/vscode/configuration/
+        // "setting-id": "value",
+    },
+
+    // process of the client so
+    // LS will automatically kill itself if client exits
+    "processId": 123456,
+    
+    // ...
+}
+```
+
+- `"devsense/loadStatus"` notification sent from server to client.
+
+## 🔐 Activation
+
+The language server provides free features and premium features which needs to be activated.
+
+**_Note to developers:_** To unlock the premium features of this package, please follow the steps below:
+
+1. **Purchase a License:**
+   User needs to purchase license on our official purchase page: [https://www.devsense.com/purchase](https://www.devsense.com/purchase)
+
+2. **Generate License Signature:**
+   User will go to the following page to validate license to receive the license **SIGNATURE**: [https://www.devsense.com/purchase/validation](https://www.devsense.com/purchase/validation)
+
+3. **Activate Premium Features**
+   Pass the license signature into the language server's `initialize` method, `"initializationOptions"` property:
+   ```json
+   {
+     "initializationOptions": {
+        "0": "<SIGNATURE>",
+        ...
+     },
+     ...
+   }`
+   ```
+
+   Or store the license signature into environment variable `DEVSENSE_PHP_LS_LICENSE`.
+
+   ```shell
+   SET DEVSENSE_PHP_LS_LICENSE="<SIGNATURE>"
+   ```
+
+If you encounter any issues during the activation process, please refer to our documentation or contact support.
+
+## 📜 Agreement
+
+By including this package as a dependency in your project—whether for personal, commercial, or open-source use—you agree to the following:
+
+* **Attribution is required**: You must include a visible link to this README file in your project documentation (e.g. in your `README.md`, about page, or developer docs).
+* This is to ensure that end users and developers are aware:
+
+  * Who the original authors and maintainers of this package are
+  * How to access premium features, including purchasing and activation steps
+
+This visibility helps support ongoing development and ensures fair use under our freemium model.
+
+> If you cannot comply with this requirement or need a custom license, please [contact us](https://www.devsense.com/) for a commercial agreement.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#! /usr/bin/env node
+export declare namespace Devsense.PHP.LS {
+    /** Language server binary file name. */
+    const FileName = "devsense.php.ls";
+    /** Gets full path to the language server binary file. */
+    function languageServerPath(): string;
+}

package/dist/index.js

@@ -0,0 +1,2 @@
+#! /usr/bin/env node
+"use strict";var v=Object.create;var s=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var g=Object.getPrototypeOf,y=Object.prototype.hasOwnProperty;var z=(e,o)=>{for(var t in o)s(e,t,{get:o[t],enumerable:!0})},l=(e,o,t,r)=>{if(o&&typeof o=="object"||typeof o=="function")for(let n of b(o))!y.call(e,n)&&n!==t&&s(e,n,{get:()=>o[n],enumerable:!(r=_(o,n))||r.enumerable});return e};var c=(e,o,t)=>(t=e!=null?v(g(e)):{},l(o||!e||!e.__esModule?s(t,"default",{value:e,enumerable:!0}):t,e)),F=e=>l(s({},"__esModule",{value:!0}),e);var N={};z(N,{Devsense:()=>h});module.exports=F(N);var a=require("os"),i=c(require("fs")),f=c(require("path")),h;(o=>{let e;(r=>{let t;(p=>{p.FileName="devsense.php.ls";function j(){let u=`devsense-php-ls-${(0,a.platform)()}-${(0,a.arch)()}`;for(let x of["..","../..","../node_modules","node_modules"]){let m=f.resolve(__dirname,x,u);if(i.existsSync(m))for(let $ of[p.FileName,`${p.FileName}.exe`]){let d=f.normalize(`${m}/dist/${$}`);if(i.existsSync(d))return d}}}p.languageServerPath=j})(t=r.LS||={})})(e=o.PHP||={})})(h||={});0&&(module.exports={Devsense});

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "devsense-php-ls",
-  "version": "1.0.17329",
+  "version": "1.0.17357",
   "description": "Devsense PHP Language Server",
-  "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "os": [
     "darwin",
@@ -25,11 +24,11 @@
     "language server"
   ],
   "optionalDependencies": {
-    "devsense-php-ls-darwin-arm64": "^1.0.17329",
-    "devsense-php-ls-darwin-x64": "^1.0.17329",
-    "devsense-php-ls-linux-arm64": "^1.0.17329",
-    "devsense-php-ls-linux-x64": "^1.0.17329",
-    "devsense-php-ls-win32-arm64": "^1.0.17329",
-    "devsense-php-ls-win32-x64": "^1.0.17329"
+    "devsense-php-ls-darwin-arm64": "^1.0.17357",
+    "devsense-php-ls-darwin-x64": "^1.0.17357",
+    "devsense-php-ls-linux-arm64": "^1.0.17357",
+    "devsense-php-ls-linux-x64": "^1.0.17357",
+    "devsense-php-ls-win32-arm64": "^1.0.17357",
+    "devsense-php-ls-win32-x64": "^1.0.17357"
   }
 }

package/.vscode/launch.json

@@ -1,25 +0,0 @@
-{
-    // Use IntelliSense to learn about possible attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    "version": "0.2.0",
-    "configurations": [
-
-        {
-            "type": "node",
-            "request": "launch",
-            "cwd": "${workspaceFolder}",
-            "runtimeArgs": [
-                "--import=tsx",
-            ],
-            "console": "integratedTerminal",
-            "args": [
-                "src/index.ts"
-            ],
-            "name": "Run",
-            "skipFiles": [
-                "<node_internals>/**"
-            ]
-        }
-    ]
-}

package/.vscode/tasks.json

@@ -1,15 +0,0 @@
-{
-	"version": "2.0.0",
-	"tasks": [
-        {
-            "type": "npm",
-            "script": "build",
-            "group": {
-                "kind": "build",
-                "isDefault": true
-            },
-            "problemMatcher": [],
-            "label": "Build"
-        }
-    ]
-}