step-node-agent 3.26.3 → 3.26.5

package/node_modules/psl/README.md

@@ -27,32 +27,69 @@ Public Suffix List is a list of all known public suffixes.
 
 Source: http://publicsuffix.org
 
-
 ## Installation
 
+This module is available both for Node.js and the browser. See below for more
+details.
+
 ### Node.js
 
+This module is tested on Node.js v8, v10, v12, v14, v16, v18, v20 and v22. See
+[`.github/workflows/node.js.yml`](.github/workflows/node.js.yml).
+
 ```sh
-npm install --save psl
+npm install psl
+```
+
+#### ESM
+
+From version `v1.13.0` you can now import `psl` as ESM.
+
+```js
+import psl from 'psl';
+```
+
+#### CommonJS
+
+If your project still uses CommonJS, you can continue importing the module like
+in previous versions.
+
+```js
+const psl = require('psl');
 ```
 
 ### Browser
 
-Download [psl.min.js](https://raw.githubusercontent.com/lupomontero/psl/main/dist/psl.min.js)
+#### Using a bundler
+
+If you are using a bundler to build your app, you should be able to `import`
+and/or `require` the module just like in Node.js.
+
+#### ESM (using a CDN)
+
+In modern browsers you can also import the ESM directly from a `CDN`. For
+example:
+
+```js
+import psl from 'https://unpkg.com/psl@latest/dist/psl.mjs';
+```
+
+#### UMD / CommonJS
+
+Finally, you can still download [`dist/psl.umd.cjs`](https://raw.githubusercontent.com/lupomontero/psl/main/dist/psl.umd.cjs)
 and include it in a script tag.
 
 ```html
-<script src="psl.min.js"></script>
+<script src="psl.umd.cjs"></script>
 ```
 
-This script is browserified and wrapped in a [umd](https://github.com/umdjs/umd)
+This script is bundled and wrapped in a [umd](https://github.com/umdjs/umd)
 wrapper so you should be able to use it standalone or together with a module
 loader.
 
 The script is also available on most popular CDNs. For example:
 
-* https://cdnjs.cloudflare.com/ajax/libs/psl/1.9.0/psl.min.js
-* https://unpkg.com/psl@1.9.0/dist/psl.min.js
+* https://unpkg.com/psl@latest/dist/psl.umd.cjs
 
 ## API
 
@@ -66,27 +103,38 @@ properties:
 * `domain`: The domain name is the `sld` + `tld`.
 * `subdomain`: Optional parts left of the domain.
 
-#### Example:
+#### Examples
+
+Parse domain without subdomain:
 
 ```js
-var psl = require('psl');
+import psl from 'psl';
 
-// Parse domain without subdomain
-var parsed = psl.parse('google.com');
+const parsed = psl.parse('google.com');
 console.log(parsed.tld); // 'com'
 console.log(parsed.sld); // 'google'
 console.log(parsed.domain); // 'google.com'
 console.log(parsed.subdomain); // null
+```
+
+Parse domain with subdomain:
+
+```js
+import psl from 'psl';
 
-// Parse domain with subdomain
-var parsed = psl.parse('www.google.com');
+const parsed = psl.parse('www.google.com');
 console.log(parsed.tld); // 'com'
 console.log(parsed.sld); // 'google'
 console.log(parsed.domain); // 'google.com'
 console.log(parsed.subdomain); // 'www'
+```
+
+Parse domain with nested subdomains:
+
+```js
+import psl from 'psl';
 
-// Parse domain with nested subdomains
-var parsed = psl.parse('a.b.c.d.foo.com');
+const parsed = psl.parse('a.b.c.d.foo.com');
 console.log(parsed.tld); // 'com'
 console.log(parsed.sld); // 'foo'
 console.log(parsed.domain); // 'foo.com'
@@ -97,10 +145,10 @@ console.log(parsed.subdomain); // 'a.b.c.d'
 
 Get domain name, `sld` + `tld`. Returns `null` if not valid.
 
-#### Example:
+#### Examples
 
 ```js
-var psl = require('psl');
+import psl from 'psl';
 
 // null input.
 psl.get(null); // null
@@ -153,36 +201,33 @@ whether the domain has a valid Public Suffix.
 #### Example
 
 ```js
-var psl = require('psl');
+import psl from 'psl';
 
 psl.isValid('google.com'); // true
 psl.isValid('www.google.com'); // true
 psl.isValid('x.yz'); // false
 ```
 
-
 ## Testing and Building
 
-Test are written using [`mocha`](https://mochajs.org/) and can be
-run in two different environments: `node` and `phantomjs`.
+There are tests both for Node.js and the browser (using [Playwright](https://playwright.dev)
+and [BrowserStack](https://www.browserstack.com/)).
 
 ```sh
-# This will run `eslint`, `mocha` and `karma`.
+# Run tests in node.
 npm test
+# Run tests in browserstack.
+npm run test:browserstack
 
-# Individual test environments
-# Run tests in node only.
-./node_modules/.bin/mocha test
-# Run tests in phantomjs only.
-./node_modules/.bin/karma start ./karma.conf.js --single-run
+# Update rules from publicsuffix.org
+npm run update-rules
 
-# Build data (parse raw list) and create dist files
+# Build ESM, CJS and UMD and create dist files
 npm run build
 ```
 
 Feel free to fork if you see possible improvements!
 
-
 ## Acknowledgements
 
 * Mozilla Foundation's [Public Suffix List](https://publicsuffix.org/)
@@ -190,12 +235,11 @@ Feel free to fork if you see possible improvements!
   test data.
 * Inspired by [weppos/publicsuffix-ruby](https://github.com/weppos/publicsuffix-ruby)
 
-
 ## License
 
 The MIT License (MIT)
 
-Copyright (c) 2017 Lupo Montero <lupomontero@gmail.com>
+Copyright (c) 2014-2024 Lupo Montero <lupomontero@gmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/node_modules/psl/SECURITY.md

@@ -0,0 +1,13 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 1.x     | :white_check_mark: |
+
+## Reporting a Vulnerability
+
+To report a security vulnerability, please use the
+[Tidelift security contact](https://tidelift.com/security).
+Tidelift will coordinate the fix and disclosure.