@openclaw/slack 2026.9.2 → 2026.9.4

package/node_modules/@slack/socket-mode/node_modules/p-queue/readme.md

@@ -0,0 +1,400 @@
+# p-queue [![Build Status](https://travis-ci.com/sindresorhus/p-queue.svg?branch=master)](https://travis-ci.com/github/sindresorhus/p-queue) [![codecov](https://codecov.io/gh/sindresorhus/p-queue/branch/master/graph/badge.svg)](https://codecov.io/gh/sindresorhus/p-queue)
+
+> Promise queue with concurrency control
+
+Useful for rate-limiting async (or sync) operations. For example, when interacting with a REST API or when doing CPU/memory intensive tasks.
+
+## Install
+
+```
+$ npm install p-queue
+```
+
+## Usage
+
+Here we run only one promise at the time. For example, set `concurrency` to 4 to run four promises at the same time.
+
+```js
+const {default: PQueue} = require('p-queue');
+const got = require('got');
+
+const queue = new PQueue({concurrency: 1});
+
+(async () => {
+	await queue.add(() => got('https://sindresorhus.com'));
+	console.log('Done: sindresorhus.com');
+})();
+
+(async () => {
+	await queue.add(() => got('https://avajs.dev'));
+	console.log('Done: avajs.dev');
+})();
+
+(async () => {
+	const task = await getUnicornTask();
+	await queue.add(task);
+	console.log('Done: Unicorn task');
+})();
+```
+
+## API
+
+### PQueue(options?)
+
+Returns a new `queue` instance, which is an [`EventEmitter3`](https://github.com/primus/eventemitter3) subclass.
+
+#### options
+
+Type: `object`
+
+##### concurrency
+
+Type: `number`\
+Default: `Infinity`\
+Minimum: `1`
+
+Concurrency limit.
+
+##### timeout
+
+Type: `number`
+
+Per-operation timeout in milliseconds. Operations fulfill once `timeout` elapses if they haven't already.
+
+##### throwOnTimeout
+
+Type: `boolean`\
+Default: `false`
+
+Whether or not a timeout is considered an exception.
+
+##### autoStart
+
+Type: `boolean`\
+Default: `true`
+
+Whether queue tasks within concurrency limit, are auto-executed as soon as they're added.
+
+##### queueClass
+
+Type: `Function`
+
+Class with a `enqueue` and `dequeue` method, and a `size` getter. See the [Custom QueueClass](#custom-queueclass) section.
+
+##### intervalCap
+
+Type: `number`\
+Default: `Infinity`\
+Minimum: `1`
+
+The max number of runs in the given interval of time.
+
+##### interval
+
+Type: `number`\
+Default: `0`\
+Minimum: `0`
+
+The length of time in milliseconds before the interval count resets. Must be finite.
+
+##### carryoverConcurrencyCount
+
+Type: `boolean`\
+Default: `false`
+
+If `true`, specifies that any [pending](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) Promises, should be carried over into the next interval and counted against the `intervalCap`. If `false`, any of those pending Promises will not count towards the next `intervalCap`.
+
+### queue
+
+`PQueue` instance.
+
+#### .add(fn, options?)
+
+Adds a sync or async task to the queue. Always returns a promise.
+
+##### fn
+
+Type: `Function`
+
+Promise-returning/async function.
+
+#### options
+
+Type: `object`
+
+##### priority
+
+Type: `number`\
+Default: `0`
+
+Priority of operation. Operations with greater priority will be scheduled first.
+
+#### .addAll(fns, options?)
+
+Same as `.add()`, but accepts an array of sync or async functions and returns a promise that resolves when all functions are resolved.
+
+#### .pause()
+
+Put queue execution on hold.
+
+#### .start()
+
+Start (or resume) executing enqueued tasks within concurrency limit. No need to call this if queue is not paused (via `options.autoStart = false` or by `.pause()` method.)
+
+Returns `this` (the instance).
+
+#### .onEmpty()
+
+Returns a promise that settles when the queue becomes empty.
+
+Can be called multiple times. Useful if you for example add additional items at a later time.
+
+#### .onIdle()
+
+Returns a promise that settles when the queue becomes empty, and all promises have completed; `queue.size === 0 && queue.pending === 0`.
+
+The difference with `.onEmpty` is that `.onIdle` guarantees that all work from the queue has finished. `.onEmpty` merely signals that the queue is empty, but it could mean that some promises haven't completed yet.
+
+#### .clear()
+
+Clear the queue.
+
+#### .size
+
+Size of the queue.
+
+#### .sizeBy(options)
+
+Size of the queue, filtered by the given options.
+
+For example, this can be used to find the number of items remaining in the queue with a specific priority level.
+
+```js
+const queue = new PQueue();
+
+queue.add(async () => '🦄', {priority: 1});
+queue.add(async () => '🦄', {priority: 0});
+queue.add(async () => '🦄', {priority: 1});
+
+console.log(queue.sizeBy({priority: 1}));
+//=> 2
+
+console.log(queue.sizeBy({priority: 0}));
+//=> 1
+```
+
+#### .pending
+
+Number of pending promises.
+
+#### [.timeout](#timeout)
+
+#### [.concurrency](#concurrency)
+
+#### .isPaused
+
+Whether the queue is currently paused.
+
+## Events
+
+#### active
+
+Emitted as each item is processed in the queue for the purpose of tracking progress.
+
+```js
+const delay = require('delay');
+const {default: PQueue} = require('p-queue');
+
+const queue = new PQueue({concurrency: 2});
+
+let count = 0;
+queue.on('active', () => {
+	console.log(`Working on item #${++count}.  Size: ${queue.size}  Pending: ${queue.pending}`);
+});
+
+queue.add(() => Promise.resolve());
+queue.add(() => delay(2000));
+queue.add(() => Promise.resolve());
+queue.add(() => Promise.resolve());
+queue.add(() => delay(500));
+```
+#### idle
+
+Emitted every time the queue becomes empty and all promises have completed; `queue.size === 0 && queue.pending === 0`.
+
+```js
+const delay = require('delay');
+const {default: PQueue} = require('p-queue');
+
+const queue = new PQueue();
+
+queue.on('idle', () => {
+	console.log(`Queue is idle.  Size: ${queue.size}  Pending: ${queue.pending}`);
+});
+
+const job1 = queue.add(() => delay(2000));
+const job2 = queue.add(() => delay(500));
+
+await job1;
+await job2;
+// => 'Queue is idle.  Size: 0  Pending: 0'
+
+await queue.add(() => delay(600));
+// => 'Queue is idle.  Size: 0  Pending: 0'
+```
+
+The `idle` event is emitted every time the queue reaches an idle state. On the other hand, the promise the `onIdle()` function returns resolves once the queue becomes idle instead of every time the queue is idle.
+
+#### add
+
+Emitted every time the add method is called and the number of pending or queued tasks is increased.
+
+#### next
+
+Emitted every time a task is completed and the number of pending or queued tasks is decreased.
+
+```js
+const delay = require('delay');
+const {default: PQueue} = require('p-queue');
+
+const queue = new PQueue();
+
+queue.on('add', () => {
+	console.log(`Task is added.  Size: ${queue.size}  Pending: ${queue.pending}`);
+});
+queue.on('next', () => {
+	console.log(`Task is completed.  Size: ${queue.size}  Pending: ${queue.pending}`);
+});
+
+const job1 = queue.add(() => delay(2000));
+const job2 = queue.add(() => delay(500));
+
+await job1;
+await job2;
+//=> 'Task is added.  Size: 0  Pending: 1'
+//=> 'Task is added.  Size: 0  Pending: 2'
+
+await queue.add(() => delay(600));
+//=> 'Task is completed.  Size: 0  Pending: 1'
+//=> 'Task is completed.  Size: 0  Pending: 0'
+```
+
+## Advanced example
+
+A more advanced example to help you understand the flow.
+
+```js
+const delay = require('delay');
+const {default: PQueue} = require('p-queue');
+
+const queue = new PQueue({concurrency: 1});
+
+(async () => {
+	await delay(200);
+
+	console.log(`8. Pending promises: ${queue.pending}`);
+	//=> '8. Pending promises: 0'
+
+	(async () => {
+		await queue.add(async () => '🐙');
+		console.log('11. Resolved')
+	})();
+
+	console.log('9. Added 🐙');
+
+	console.log(`10. Pending promises: ${queue.pending}`);
+	//=> '10. Pending promises: 1'
+
+	await queue.onIdle();
+	console.log('12. All work is done');
+})();
+
+(async () => {
+	await queue.add(async () => '🦄');
+	console.log('5. Resolved')
+})();
+console.log('1. Added 🦄');
+
+(async () => {
+	await queue.add(async () => '🐴');
+	console.log('6. Resolved')
+})();
+console.log('2. Added 🐴');
+
+(async () => {
+	await queue.onEmpty();
+	console.log('7. Queue is empty');
+})();
+
+console.log(`3. Queue size: ${queue.size}`);
+//=> '3. Queue size: 1`
+
+console.log(`4. Pending promises: ${queue.pending}`);
+//=> '4. Pending promises: 1'
+```
+
+```
+$ node example.js
+1. Added 🦄
+2. Added 🐴
+3. Queue size: 1
+4. Pending promises: 1
+5. Resolved 🦄
+6. Resolved 🐴
+7. Queue is empty
+8. Pending promises: 0
+9. Added 🐙
+10. Pending promises: 1
+11. Resolved 🐙
+12. All work is done
+```
+
+## Custom QueueClass
+
+For implementing more complex scheduling policies, you can provide a QueueClass in the options:
+
+```js
+class QueueClass {
+	constructor() {
+		this._queue = [];
+	}
+
+	enqueue(run, options) {
+		this._queue.push(run);
+	}
+
+	dequeue() {
+		return this._queue.shift();
+	}
+
+	get size() {
+		return this._queue.length;
+	}
+
+	filter(options) {
+		return this._queue;
+	}
+}
+```
+
+`p-queue` will call corresponding methods to put and get operations from this queue.
+
+## Related
+
+- [p-limit](https://github.com/sindresorhus/p-limit) - Run multiple promise-returning & async functions with limited concurrency
+- [p-throttle](https://github.com/sindresorhus/p-throttle) - Throttle promise-returning & async functions
+- [p-debounce](https://github.com/sindresorhus/p-debounce) - Debounce promise-returning & async functions
+- [p-all](https://github.com/sindresorhus/p-all) - Run promise-returning & async functions concurrently with optional limited concurrency
+- [More…](https://github.com/sindresorhus/promise-fun)
+
+---
+
+<div align="center">
+	<b>
+		<a href="https://tidelift.com/subscription/pkg/npm-p-queue?utm_source=npm-p-queue&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>
+	</b>
+	<br>
+	<sub>
+		Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.
+	</sub>
+</div>

package/node_modules/@slack/socket-mode/node_modules/p-retry/index.d.ts

@@ -0,0 +1,106 @@
+import {OperationOptions} from 'retry';
+
+declare class AbortErrorClass extends Error {
+	readonly name: 'AbortError';
+	readonly originalError: Error;
+
+	/**
+	Abort retrying and reject the promise.
+
+	@param message - Error message or custom error.
+	*/
+	constructor(message: string | Error);
+}
+
+declare namespace pRetry {
+	interface FailedAttemptError extends Error {
+		readonly attemptNumber: number;
+		readonly retriesLeft: number;
+	}
+
+	interface Options extends OperationOptions {
+		/**
+		Callback invoked on each retry. Receives the error thrown by `input` as the first argument with properties `attemptNumber` and `retriesLeft` which indicate the current attempt number and the number of attempts left, respectively.
+
+		The `onFailedAttempt` function can return a promise. For example, to add a [delay](https://github.com/sindresorhus/delay):
+
+		```
+		import pRetry = require('p-retry');
+		import delay = require('delay');
+
+		const run = async () => { ... };
+
+		(async () => {
+			const result = await pRetry(run, {
+				onFailedAttempt: async error => {
+					console.log('Waiting for 1 second before retrying');
+					await delay(1000);
+				}
+			});
+		})();
+		```
+
+		If the `onFailedAttempt` function throws, all retries will be aborted and the original promise will reject with the thrown error.
+		*/
+		readonly onFailedAttempt?: (error: FailedAttemptError) => void | Promise<void>;
+	}
+
+	type AbortError = AbortErrorClass;
+}
+
+declare const pRetry: {
+	/**
+	Returns a `Promise` that is fulfilled when calling `input` returns a fulfilled promise. If calling `input` returns a rejected promise, `input` is called again until the max retries are reached, it then rejects with the last rejection reason.
+
+	Does not retry on most `TypeErrors`, with the exception of network errors. This is done on a best case basis as different browsers have different [messages](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch#Checking_that_the_fetch_was_successful) to indicate this. 
+	See [whatwg/fetch#526 (comment)](https://github.com/whatwg/fetch/issues/526#issuecomment-554604080)
+
+	@param input - Receives the number of attempts as the first argument and is expected to return a `Promise` or any value.
+	@param options - Options are passed to the [`retry`](https://github.com/tim-kos/node-retry#retryoperationoptions) module.
+
+	@example
+	```
+	import pRetry = require('p-retry');
+	import fetch from 'node-fetch';
+
+	const run = async () => {
+		const response = await fetch('https://sindresorhus.com/unicorn');
+
+		// Abort retrying if the resource doesn't exist
+		if (response.status === 404) {
+			throw new pRetry.AbortError(response.statusText);
+		}
+
+		return response.blob();
+	};
+
+	(async () => {
+		console.log(await pRetry(run, {retries: 5}));
+
+		// With the `onFailedAttempt` option:
+		const result = await pRetry(run, {
+			onFailedAttempt: error => {
+				console.log(`Attempt ${error.attemptNumber} failed. There are ${error.retriesLeft} retries left.`);
+				// 1st request => Attempt 1 failed. There are 4 retries left.
+				// 2nd request => Attempt 2 failed. There are 3 retries left.
+				// …
+			},
+			retries: 5
+		});
+
+		console.log(result);
+	})();
+	```
+	*/
+	<T>(
+		input: (attemptCount: number) => PromiseLike<T> | T,
+		options?: pRetry.Options
+	): Promise<T>;
+
+	AbortError: typeof AbortErrorClass;
+
+	// TODO: remove this in the next major version
+	default: typeof pRetry;
+};
+
+export = pRetry;

package/node_modules/@slack/socket-mode/node_modules/p-retry/index.js

@@ -0,0 +1,85 @@
+'use strict';
+const retry = require('retry');
+
+const networkErrorMsgs = [
+	'Failed to fetch', // Chrome
+	'NetworkError when attempting to fetch resource.', // Firefox
+	'The Internet connection appears to be offline.', // Safari
+	'Network request failed' // `cross-fetch`
+];
+
+class AbortError extends Error {
+	constructor(message) {
+		super();
+
+		if (message instanceof Error) {
+			this.originalError = message;
+			({message} = message);
+		} else {
+			this.originalError = new Error(message);
+			this.originalError.stack = this.stack;
+		}
+
+		this.name = 'AbortError';
+		this.message = message;
+	}
+}
+
+const decorateErrorWithCounts = (error, attemptNumber, options) => {
+	// Minus 1 from attemptNumber because the first attempt does not count as a retry
+	const retriesLeft = options.retries - (attemptNumber - 1);
+
+	error.attemptNumber = attemptNumber;
+	error.retriesLeft = retriesLeft;
+	return error;
+};
+
+const isNetworkError = errorMessage => networkErrorMsgs.includes(errorMessage);
+
+const pRetry = (input, options) => new Promise((resolve, reject) => {
+	options = {
+		onFailedAttempt: () => {},
+		retries: 10,
+		...options
+	};
+
+	const operation = retry.operation(options);
+
+	operation.attempt(async attemptNumber => {
+		try {
+			resolve(await input(attemptNumber));
+		} catch (error) {
+			if (!(error instanceof Error)) {
+				reject(new TypeError(`Non-error was thrown: "${error}". You should only throw errors.`));
+				return;
+			}
+
+			if (error instanceof AbortError) {
+				operation.stop();
+				reject(error.originalError);
+			} else if (error instanceof TypeError && !isNetworkError(error.message)) {
+				operation.stop();
+				reject(error);
+			} else {
+				decorateErrorWithCounts(error, attemptNumber, options);
+
+				try {
+					await options.onFailedAttempt(error);
+				} catch (error) {
+					reject(error);
+					return;
+				}
+
+				if (!operation.retry(error)) {
+					reject(operation.mainError());
+				}
+			}
+		}
+	});
+});
+
+module.exports = pRetry;
+// TODO: remove this in the next major version
+module.exports.default = pRetry;
+
+module.exports.AbortError = AbortError;

package/node_modules/@slack/socket-mode/node_modules/p-retry/license

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.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 in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/node_modules/@slack/socket-mode/node_modules/p-retry/package.json

@@ -0,0 +1,51 @@
+{
+	"name": "p-retry",
+	"version": "4.6.2",
+	"description": "Retry a promise-returning or async function",
+	"license": "MIT",
+	"repository": "sindresorhus/p-retry",
+	"author": {
+		"name": "Sindre Sorhus",
+		"email": "sindresorhus@gmail.com",
+		"url": "sindresorhus.com"
+	},
+	"engines": {
+		"node": ">=8"
+	},
+	"scripts": {
+		"test": "xo && ava && tsd"
+	},
+	"files": [
+		"index.js",
+		"index.d.ts"
+	],
+	"keywords": [
+		"promise",
+		"retry",
+		"retries",
+		"operation",
+		"failed",
+		"rejected",
+		"try",
+		"exponential",
+		"backoff",
+		"attempt",
+		"async",
+		"await",
+		"promises",
+		"concurrently",
+		"concurrency",
+		"parallel",
+		"bluebird"
+	],
+	"dependencies": {
+		"@types/retry": "0.12.0",
+		"retry": "^0.13.1"
+	},
+	"devDependencies": {
+		"ava": "^2.4.0",
+		"delay": "^4.1.0",
+		"tsd": "^0.10.0",
+		"xo": "^0.25.3"
+	}
+}