@openclaw/slack 2026.6.8-beta.1 → 2026.6.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/api.js CHANGED
@@ -3,7 +3,7 @@ import { a as resolveSlackAccount, i as resolveDefaultSlackAccountId, l as resol
3
3
  import { t as inspectSlackAccount } from "./account-inspect-CdGk6R7l.js";
4
4
  import { i as resolveSlackChannelId, n as normalizeSlackMessagingTarget, r as parseSlackTarget, t as looksLikeSlackTargetId } from "./target-parsing-C7eeWg7M.js";
5
5
  import "./targets-nUqxHGgg.js";
6
- import { a as resolveSlackAutoThreadId, i as resolveSlackChannelType, n as buildSlackThreadingToolContext, r as resetSlackChannelTypeCacheForTest, t as slackPlugin } from "./channel-CdZdGdU5.js";
6
+ import { a as resolveSlackAutoThreadId, i as resolveSlackChannelType, n as buildSlackThreadingToolContext, r as resetSlackChannelTypeCacheForTest, t as slackPlugin } from "./channel-BxD37X5Y.js";
7
7
  import { _ as buildSlackInteractiveBlocks, a as parseSlackBlocksInput, c as resolveSlackGroupRequireMention, d as normalizeAllowList, f as normalizeAllowListLower, g as resolveSlackUserAllowed, h as resolveSlackAllowListMatch, i as SLACK_MAX_BLOCKS, l as resolveSlackGroupToolPolicy, m as normalizeSlackSlug, o as validateSlackBlocksArray, p as normalizeSlackAllowOwnerEntry, u as allowListMatches, v as buildSlackPresentationBlocks } from "./thread-ts-Cffag8e2.js";
8
8
  import { a as getSlackWriteClient, c as resolveSlackWebClientOptions, i as createSlackWriteClient, l as resolveSlackWriteClientOptions, n as createSlackTokenCacheKey, o as SLACK_DEFAULT_RETRY_OPTIONS, r as createSlackWebClient, s as SLACK_WRITE_RETRY_OPTIONS, t as clearSlackWriteClientCacheForTest } from "./client-Cn2WwpcA.js";
9
9
  import { n as extractSlackToolSend, r as listSlackMessageActions } from "./message-tool-api-B9M0zzlQ.js";
@@ -345,6 +345,15 @@ async function handleSlackMessageAction(params) {
345
345
  //#endregion
346
346
  //#region extensions/slack/src/channel-actions.ts
347
347
  let slackActionRuntimePromise$1;
348
+ const SLACK_TOOL_DELIVERY_ACTIONS = new Set([
349
+ "deleteMessage",
350
+ "editMessage",
351
+ "pinMessage",
352
+ "react",
353
+ "sendMessage",
354
+ "unpinMessage",
355
+ "uploadFile"
356
+ ]);
348
357
  async function loadSlackActionRuntime$1() {
349
358
  slackActionRuntimePromise$1 ??= import("./action-runtime.runtime-D05xDf1s.js");
350
359
  return await slackActionRuntimePromise$1;
@@ -361,6 +370,7 @@ function createSlackActions(providerId, options) {
361
370
  return {
362
371
  describeMessageTool: describeSlackMessageTool,
363
372
  extractToolSend: ({ args }) => extractSlackToolSend(args),
373
+ isToolDeliveryAction: ({ args }) => typeof args.action === "string" && SLACK_TOOL_DELIVERY_ACTIONS.has(args.action),
364
374
  prepareSendPayload: ({ ctx, payload }) => ctx.action === "send" ? payload : null,
365
375
  handleAction: async (ctx) => {
366
376
  return await handleSlackMessageAction({
@@ -1,2 +1,2 @@
1
- import { t as slackPlugin } from "./channel-CdZdGdU5.js";
1
+ import { t as slackPlugin } from "./channel-BxD37X5Y.js";
2
2
  export { slackPlugin };
@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [v4.0.5](https://github.com/form-data/form-data/compare/v4.0.4...v4.0.5) - 2025-11-17
9
+
10
+ ### Commits
11
+
12
+ - [Tests] Switch to newer v8 prediction library; enable node 24 testing [`16e0076`](https://github.com/form-data/form-data/commit/16e00765342106876f98a1c9703314006c9e937a)
13
+ - [Dev Deps] update `@ljharb/eslint-config`, `eslint` [`5822467`](https://github.com/form-data/form-data/commit/5822467f0ec21f6ad613c1c90856375e498793c7)
14
+ - [Fix] set Symbol.toStringTag in the proper place [`76d0dee`](https://github.com/form-data/form-data/commit/76d0dee43933b5e167f7f09e5d9cbbd1cf911aa7)
15
+
8
16
  ## [v4.0.4](https://github.com/form-data/form-data/compare/v4.0.3...v4.0.4) - 2025-07-16
9
17
 
10
18
  ### Commits
@@ -158,7 +166,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
158
166
 
159
167
  - feat: add setBoundary method [`55d90ce`](https://github.com/form-data/form-data/commit/55d90ce4a4c22b0ea0647991d85cb946dfb7395b)
160
168
 
161
- ## [v3.0.0](https://github.com/form-data/form-data/compare/v2.5.4...v3.0.0) - 2019-11-05
169
+ ## [v3.0.0](https://github.com/form-data/form-data/compare/v2.5.6...v3.0.0) - 2019-11-05
162
170
 
163
171
  ### Merged
164
172
 
@@ -182,6 +190,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
182
190
  - Pass options to constructor if not used with new [`4bde68e`](https://github.com/form-data/form-data/commit/4bde68e12de1ba90fefad2e7e643f6375b902763)
183
191
  - Make userHeaders optional [`2b4e478`](https://github.com/form-data/form-data/commit/2b4e4787031490942f2d1ee55c56b85a250875a7)
184
192
 
193
+ ## [v2.5.6](https://github.com/form-data/form-data/compare/v2.5.5...v2.5.6) - 2026-06-12
194
+
195
+ ### Commits
196
+
197
+ - [Fix] escape CR, LF, and `"` in field names and filenames [`b620316`](https://github.com/form-data/form-data/commit/b62031603c2d7c329b2a369b49466790f0ba6314)
198
+ - [Dev Deps] update `@ljharb/eslint-config`, `auto-changelog`, `eslint`, `tape` [`12be578`](https://github.com/form-data/form-data/commit/12be578e936fd77eee75e2e656955f5343c4b80f)
199
+ - [Dev Deps] update `js-randomness-predictor` [`46cfd23`](https://github.com/form-data/form-data/commit/46cfd23bd40be14cfa0391e1c5357c4d74098f23)
200
+ - [Tests] use `safe-buffer` so the header-injection test runs on node < 4 [`633044a`](https://github.com/form-data/form-data/commit/633044a57a7b19f41cec2271ffd24afa2f6280af)
201
+ - [Deps] update `hasown` [`e3b96ee`](https://github.com/form-data/form-data/commit/e3b96eef1661bca8ea4297de057b78bf2734e900)
202
+
203
+ ## [v2.5.5](https://github.com/form-data/form-data/compare/v2.5.4...v2.5.5) - 2025-07-18
204
+
205
+ ### Commits
206
+
207
+ - [meta] actually ensure the readme backup isn’t published [`10626c0`](https://github.com/form-data/form-data/commit/10626c0a9b78c7d3fcaa51772265015ee0afc25c)
208
+ - [Fix] use proper dependency [`026abe5`](https://github.com/form-data/form-data/commit/026abe5c5c0489d8a2ccb59d5cfd14fb63078377)
209
+
185
210
  ## [v2.5.4](https://github.com/form-data/form-data/compare/v2.5.3...v2.5.4) - 2025-07-17
186
211
 
187
212
  ### Fixed
@@ -6,11 +6,11 @@ The API of this library is inspired by the [XMLHttpRequest-2 FormData Interface]
6
6
 
7
7
  [xhr2-fd]: http://dev.w3.org/2006/webapi/XMLHttpRequest-2/Overview.html#the-formdata-interface
8
8
 
9
- [![Linux Build](https://img.shields.io/travis/form-data/form-data/v2.5.4.svg?label=linux:4.x-12.x)](https://travis-ci.org/form-data/form-data)
10
- [![MacOS Build](https://img.shields.io/travis/form-data/form-data/v2.5.4.svg?label=macos:4.x-12.x)](https://travis-ci.org/form-data/form-data)
11
- [![Windows Build](https://img.shields.io/travis/form-data/form-data/v2.5.4.svg?label=windows:4.x-12.x)](https://travis-ci.org/form-data/form-data)
9
+ [![Linux Build](https://img.shields.io/travis/form-data/form-data/v2.5.6.svg?label=linux:4.x-12.x)](https://travis-ci.org/form-data/form-data)
10
+ [![MacOS Build](https://img.shields.io/travis/form-data/form-data/v2.5.6.svg?label=macos:4.x-12.x)](https://travis-ci.org/form-data/form-data)
11
+ [![Windows Build](https://img.shields.io/travis/form-data/form-data/v2.5.6.svg?label=windows:4.x-12.x)](https://travis-ci.org/form-data/form-data)
12
12
 
13
- [![Coverage Status](https://img.shields.io/coveralls/form-data/form-data/v2.5.4.svg?label=code+coverage)](https://coveralls.io/github/form-data/form-data?branch=master)
13
+ [![Coverage Status](https://img.shields.io/coveralls/form-data/form-data/v2.5.6.svg?label=code+coverage)](https://coveralls.io/github/form-data/form-data?branch=master)
14
14
  [![Dependency Status](https://img.shields.io/david/form-data/form-data.svg)](https://david-dm.org/form-data/form-data)
15
15
 
16
16
  ## Install
@@ -15,6 +15,11 @@ var setToStringTag = require('es-set-tostringtag');
15
15
  var populate = require('./populate.js');
16
16
  var Buffer = require('safe-buffer').Buffer;
17
17
 
18
+ // escape CR/LF/`"` so a name/filename can't inject headers or smuggle parts; matches the WHATWG HTML multipart/form-data encoding
19
+ function escapeHeaderParam(str) {
20
+ return String(str).replace(/\r/g, '%0D').replace(/\n/g, '%0A').replace(/"/g, '%22');
21
+ }
22
+
18
23
  /**
19
24
  * Create readable "multipart/form-data" streams.
20
25
  * Can be used to submit forms
@@ -190,7 +195,7 @@ FormData.prototype._multiPartHeader = function (field, value, options) {
190
195
  var contents = '';
191
196
  var headers = {
192
197
  // add custom disposition as third element or keep it two elements if not
193
- 'Content-Disposition': ['form-data', 'name="' + field + '"'].concat(contentDisposition || []),
198
+ 'Content-Disposition': ['form-data', 'name="' + escapeHeaderParam(field) + '"'].concat(contentDisposition || []),
194
199
  // if no content type. allow it to be empty array
195
200
  'Content-Type': [].concat(contentType || []),
196
201
  };
@@ -245,7 +250,7 @@ FormData.prototype._getContentDisposition = function (value, options) {
245
250
  }
246
251
 
247
252
  if (filename) {
248
- contentDisposition = 'filename="' + filename + '"';
253
+ contentDisposition = 'filename="' + escapeHeaderParam(filename) + '"';
249
254
  }
250
255
 
251
256
  return contentDisposition;
@@ -2,7 +2,7 @@
2
2
  "author": "Felix Geisendörfer <felix@debuggable.com> (http://debuggable.com/)",
3
3
  "name": "form-data",
4
4
  "description": "A library to create readable \"multipart/form-data\" streams. Can be used to submit forms and file uploads to other web applications.",
5
- "version": "2.5.4",
5
+ "version": "2.5.6",
6
6
  "repository": {
7
7
  "type": "git",
8
8
  "url": "git://github.com/form-data/form-data.git"
@@ -27,10 +27,11 @@
27
27
  "files": "pkgfiles --sort=name",
28
28
  "get-version": "node -e \"console.log(require('./package.json').version)\"",
29
29
  "update-readme": "sed -i.bak 's/\\/master\\.svg/\\/v'$(npm --silent run get-version)'.svg/g' README.md",
30
- "restore-readme": "mv README.md.bak README.md",
30
+ "postupdate-readme": "mv README.md.bak READ.ME.md.bak",
31
+ "restore-readme": "mv READ.ME.md.bak README.md",
31
32
  "prepublish": "not-in-publish || npm run prepublishOnly",
32
- "prepublishOnly": "npm run update-readme",
33
- "postpublish": "npm run restore-readme",
33
+ "prepack": "npm run update-readme",
34
+ "postpack": "npm run restore-readme",
34
35
  "version": "auto-changelog && git add CHANGELOG.md",
35
36
  "postversion": "auto-changelog && git add CHANGELOG.md && git commit --no-edit --amend && git tag -f \"v$(node -e \"console.log(require('./package.json').version)\")\""
36
37
  },
@@ -41,25 +42,25 @@
41
42
  "asynckit": "^0.4.0",
42
43
  "combined-stream": "^1.0.8",
43
44
  "es-set-tostringtag": "^2.1.0",
44
- "has-own": "^1.0.1",
45
+ "hasown": "^2.0.4",
45
46
  "mime-types": "^2.1.35",
46
47
  "safe-buffer": "^5.2.1"
47
48
  },
48
49
  "devDependencies": {
49
- "@ljharb/eslint-config": "^21.2.0",
50
- "auto-changelog": "^2.5.0",
50
+ "@ljharb/eslint-config": "^22.2.3",
51
+ "auto-changelog": "^2.6.0",
51
52
  "browserify": "^13.3.0",
52
53
  "browserify-istanbul": "^2.0.0",
53
54
  "coveralls": "^3.1.1",
54
55
  "cross-spawn": "^4.0.2",
55
56
  "encoding": "^0.1.13",
56
- "eslint": "=8.8.0",
57
+ "eslint": "^8.57.1",
57
58
  "fake": "^0.2.2",
58
59
  "far": "^0.0.7",
59
60
  "formidable": "^1.2.6",
60
61
  "in-publish": "^2.0.1",
61
62
  "istanbul": "^0.4.5",
62
- "js-randomness-predictor": "^1.5.5",
63
+ "js-randomness-predictor": "^3.6.0",
63
64
  "obake": "^0.1.2",
64
65
  "phantomjs-prebuilt": "^2.1.16",
65
66
  "pkgfiles": "^2.3.2",
@@ -68,7 +69,7 @@
68
69
  "request": "~2.87.0",
69
70
  "rimraf": "^2.7.1",
70
71
  "semver": "^6.3.1",
71
- "tape": "^5.9.0"
72
+ "tape": "^5.10.1"
72
73
  },
73
74
  "license": "MIT",
74
75
  "auto-changelog": {
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "@openclaw/slack",
3
- "version": "2026.6.8-beta.1",
3
+ "version": "2026.6.8",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "@openclaw/slack",
9
- "version": "2026.6.8-beta.1",
9
+ "version": "2026.6.8",
10
10
  "dependencies": {
11
11
  "@slack/bolt": "4.7.3",
12
12
  "@slack/types": "2.21.1",
@@ -15,7 +15,7 @@
15
15
  "zod": "4.4.3"
16
16
  },
17
17
  "peerDependencies": {
18
- "openclaw": ">=2026.6.8-beta.1"
18
+ "openclaw": ">=2026.6.8"
19
19
  },
20
20
  "peerDependenciesMeta": {
21
21
  "openclaw": {
@@ -553,16 +553,15 @@
553
553
  }
554
554
  },
555
555
  "node_modules/form-data": {
556
- "version": "2.5.4",
557
- "resolved": "https://registry.npmjs.org/form-data/-/form-data-2.5.4.tgz",
558
- "integrity": "sha512-Y/3MmRiR8Nd+0CUtrbvcKtKzLWiUfpQ7DFVggH8PwmGt/0r7RSy32GuP4hpCJlQNEBusisSx1DLtD8uD386HJQ==",
559
- "deprecated": "This version has an incorrect dependency; please use v2.5.5",
556
+ "version": "2.5.6",
557
+ "resolved": "https://registry.npmjs.org/form-data/-/form-data-2.5.6.tgz",
558
+ "integrity": "sha512-Ogz/E85h9tlfJzpI6TuFpGcHZFhLrb9Gw8wq9v40CxSCPnv7ahKr6Xgtkn0KYCDQJ8DNn5VoMO8EXr9V5PadyA==",
560
559
  "license": "MIT",
561
560
  "dependencies": {
562
561
  "asynckit": "^0.4.0",
563
562
  "combined-stream": "^1.0.8",
564
563
  "es-set-tostringtag": "^2.1.0",
565
- "has-own": "^1.0.1",
564
+ "hasown": "^2.0.4",
566
565
  "mime-types": "^2.1.35",
567
566
  "safe-buffer": "^5.2.1"
568
567
  },
@@ -667,13 +666,6 @@
667
666
  "url": "https://github.com/sponsors/ljharb"
668
667
  }
669
668
  },
670
- "node_modules/has-own": {
671
- "version": "1.0.1",
672
- "resolved": "https://registry.npmjs.org/has-own/-/has-own-1.0.1.tgz",
673
- "integrity": "sha512-RDKhzgQTQfMaLvIFhjahU+2gGnRBK6dYOd5Gd9BzkmnBneOCRYjRC003RIMrdAbH52+l+CnMS4bBCXGer8tEhg==",
674
- "deprecated": "This project is not maintained. Use Object.hasOwn() instead.",
675
- "license": "MIT"
676
- },
677
669
  "node_modules/has-symbols": {
678
670
  "version": "1.1.0",
679
671
  "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@openclaw/slack",
3
- "version": "2026.6.8-beta.1",
3
+ "version": "2026.6.8",
4
4
  "description": "OpenClaw Slack channel plugin for channels, DMs, commands, and app events.",
5
5
  "repository": {
6
6
  "type": "git",
@@ -15,7 +15,7 @@
15
15
  "zod": "4.4.3"
16
16
  },
17
17
  "peerDependencies": {
18
- "openclaw": ">=2026.6.8-beta.1"
18
+ "openclaw": ">=2026.6.8"
19
19
  },
20
20
  "peerDependenciesMeta": {
21
21
  "openclaw": {
@@ -26,7 +26,7 @@
26
26
  "extensions": [
27
27
  "./index.ts"
28
28
  ],
29
- "setupEntry": "./setup-entry.ts",
29
+ "setupEntry": "./dist/setup-entry.js",
30
30
  "channel": {
31
31
  "id": "slack",
32
32
  "label": "Slack",
@@ -60,13 +60,13 @@
60
60
  "allowInvalidConfigRecovery": true
61
61
  },
62
62
  "compat": {
63
- "pluginApi": ">=2026.6.8-beta.1"
63
+ "pluginApi": ">=2026.6.8"
64
64
  },
65
65
  "startup": {
66
66
  "deferConfiguredChannelFullLoadUntilAfterListen": true
67
67
  },
68
68
  "build": {
69
- "openclawVersion": "2026.6.8-beta.1",
69
+ "openclawVersion": "2026.6.8",
70
70
  "bundledDist": false
71
71
  },
72
72
  "release": {
@@ -1,350 +0,0 @@
1
- # Form-Data [![NPM Module](https://img.shields.io/npm/v/form-data.svg)](https://www.npmjs.com/package/form-data) [![Join the chat at https://gitter.im/form-data/form-data](http://form-data.github.io/images/gitterbadge.svg)](https://gitter.im/form-data/form-data)
2
-
3
- A library to create readable ```"multipart/form-data"``` streams. Can be used to submit forms and file uploads to other web applications.
4
-
5
- The API of this library is inspired by the [XMLHttpRequest-2 FormData Interface][xhr2-fd].
6
-
7
- [xhr2-fd]: http://dev.w3.org/2006/webapi/XMLHttpRequest-2/Overview.html#the-formdata-interface
8
-
9
- [![Linux Build](https://img.shields.io/travis/form-data/form-data/v2.5.4.svg?label=linux:4.x-12.x)](https://travis-ci.org/form-data/form-data)
10
- [![MacOS Build](https://img.shields.io/travis/form-data/form-data/v2.5.4.svg?label=macos:4.x-12.x)](https://travis-ci.org/form-data/form-data)
11
- [![Windows Build](https://img.shields.io/travis/form-data/form-data/v2.5.4.svg?label=windows:4.x-12.x)](https://travis-ci.org/form-data/form-data)
12
-
13
- [![Coverage Status](https://img.shields.io/coveralls/form-data/form-data/v2.5.4.svg?label=code+coverage)](https://coveralls.io/github/form-data/form-data?branch=master)
14
- [![Dependency Status](https://img.shields.io/david/form-data/form-data.svg)](https://david-dm.org/form-data/form-data)
15
-
16
- ## Install
17
-
18
- ```
19
- npm install --save form-data
20
- ```
21
-
22
- ## Usage
23
-
24
- In this example we are constructing a form with 3 fields that contain a string,
25
- a buffer and a file stream.
26
-
27
- ``` javascript
28
- var FormData = require('form-data');
29
- var fs = require('fs');
30
-
31
- var form = new FormData();
32
- form.append('my_field', 'my value');
33
- form.append('my_buffer', new Buffer(10));
34
- form.append('my_file', fs.createReadStream('/foo/bar.jpg'));
35
- ```
36
-
37
- Also you can use http-response stream:
38
-
39
- ``` javascript
40
- var FormData = require('form-data');
41
- var http = require('http');
42
-
43
- var form = new FormData();
44
-
45
- http.request('http://nodejs.org/images/logo.png', function(response) {
46
- form.append('my_field', 'my value');
47
- form.append('my_buffer', new Buffer(10));
48
- form.append('my_logo', response);
49
- });
50
- ```
51
-
52
- Or @mikeal's [request](https://github.com/request/request) stream:
53
-
54
- ``` javascript
55
- var FormData = require('form-data');
56
- var request = require('request');
57
-
58
- var form = new FormData();
59
-
60
- form.append('my_field', 'my value');
61
- form.append('my_buffer', new Buffer(10));
62
- form.append('my_logo', request('http://nodejs.org/images/logo.png'));
63
- ```
64
-
65
- In order to submit this form to a web application, call ```submit(url, [callback])``` method:
66
-
67
- ``` javascript
68
- form.submit('http://example.org/', function(err, res) {
69
- // res – response object (http.IncomingMessage) //
70
- res.resume();
71
- });
72
-
73
- ```
74
-
75
- For more advanced request manipulations ```submit()``` method returns ```http.ClientRequest``` object, or you can choose from one of the alternative submission methods.
76
-
77
- ### Custom options
78
-
79
- You can provide custom options, such as `maxDataSize`:
80
-
81
- ``` javascript
82
- var FormData = require('form-data');
83
-
84
- var form = new FormData({ maxDataSize: 20971520 });
85
- form.append('my_field', 'my value');
86
- form.append('my_buffer', /* something big */);
87
- ```
88
-
89
- List of available options could be found in [combined-stream](https://github.com/felixge/node-combined-stream/blob/master/lib/combined_stream.js#L7-L15)
90
-
91
- ### Alternative submission methods
92
-
93
- You can use node's http client interface:
94
-
95
- ``` javascript
96
- var http = require('http');
97
-
98
- var request = http.request({
99
- method: 'post',
100
- host: 'example.org',
101
- path: '/upload',
102
- headers: form.getHeaders()
103
- });
104
-
105
- form.pipe(request);
106
-
107
- request.on('response', function(res) {
108
- console.log(res.statusCode);
109
- });
110
- ```
111
-
112
- Or if you would prefer the `'Content-Length'` header to be set for you:
113
-
114
- ``` javascript
115
- form.submit('example.org/upload', function(err, res) {
116
- console.log(res.statusCode);
117
- });
118
- ```
119
-
120
- To use custom headers and pre-known length in parts:
121
-
122
- ``` javascript
123
- var CRLF = '\r\n';
124
- var form = new FormData();
125
-
126
- var options = {
127
- header: CRLF + '--' + form.getBoundary() + CRLF + 'X-Custom-Header: 123' + CRLF + CRLF,
128
- knownLength: 1
129
- };
130
-
131
- form.append('my_buffer', buffer, options);
132
-
133
- form.submit('http://example.com/', function(err, res) {
134
- if (err) throw err;
135
- console.log('Done');
136
- });
137
- ```
138
-
139
- Form-Data can recognize and fetch all the required information from common types of streams (```fs.readStream```, ```http.response``` and ```mikeal's request```), for some other types of streams you'd need to provide "file"-related information manually:
140
-
141
- ``` javascript
142
- someModule.stream(function(err, stdout, stderr) {
143
- if (err) throw err;
144
-
145
- var form = new FormData();
146
-
147
- form.append('file', stdout, {
148
- filename: 'unicycle.jpg', // ... or:
149
- filepath: 'photos/toys/unicycle.jpg',
150
- contentType: 'image/jpeg',
151
- knownLength: 19806
152
- });
153
-
154
- form.submit('http://example.com/', function(err, res) {
155
- if (err) throw err;
156
- console.log('Done');
157
- });
158
- });
159
- ```
160
-
161
- The `filepath` property overrides `filename` and may contain a relative path. This is typically used when uploading [multiple files from a directory](https://wicg.github.io/entries-api/#dom-htmlinputelement-webkitdirectory).
162
-
163
- For edge cases, like POST request to URL with query string or to pass HTTP auth credentials, object can be passed to `form.submit()` as first parameter:
164
-
165
- ``` javascript
166
- form.submit({
167
- host: 'example.com',
168
- path: '/probably.php?extra=params',
169
- auth: 'username:password'
170
- }, function(err, res) {
171
- console.log(res.statusCode);
172
- });
173
- ```
174
-
175
- In case you need to also send custom HTTP headers with the POST request, you can use the `headers` key in first parameter of `form.submit()`:
176
-
177
- ``` javascript
178
- form.submit({
179
- host: 'example.com',
180
- path: '/surelynot.php',
181
- headers: {'x-test-header': 'test-header-value'}
182
- }, function(err, res) {
183
- console.log(res.statusCode);
184
- });
185
- ```
186
-
187
- ### Methods
188
-
189
- - [_Void_ append( **String** _field_, **Mixed** _value_ [, **Mixed** _options_] )](https://github.com/form-data/form-data#void-append-string-field-mixed-value--mixed-options-).
190
- - [_Array_ getHeaders( [**Array** _userHeaders_] )](https://github.com/form-data/form-data#array-getheaders-array-userheaders-)
191
- - [_String_ getBoundary()](https://github.com/form-data/form-data#string-getboundary)
192
- - [_Buffer_ getBuffer()](https://github.com/form-data/form-data#buffer-getbuffer)
193
- - [_Integer_ getLengthSync()](https://github.com/form-data/form-data#integer-getlengthsync)
194
- - [_Integer_ getLength( **function** _callback_ )](https://github.com/form-data/form-data#integer-getlength-function-callback-)
195
- - [_Boolean_ hasKnownLength()](https://github.com/form-data/form-data#boolean-hasknownlength)
196
- - [_Request_ submit( _params_, **function** _callback_ )](https://github.com/form-data/form-data#request-submit-params-function-callback-)
197
- - [_String_ toString()](https://github.com/form-data/form-data#string-tostring)
198
-
199
- #### _Void_ append( **String** _field_, **Mixed** _value_ [, **Mixed** _options_] )
200
- Append data to the form. You can submit about any format (string, integer, boolean, buffer, etc.). However, Arrays are not supported and need to be turned into strings by the user.
201
- ```javascript
202
- var form = new FormData();
203
- form.append( 'my_string', 'my value' );
204
- form.append( 'my_integer', 1 );
205
- form.append( 'my_boolean', true );
206
- form.append( 'my_buffer', new Buffer(10) );
207
- form.append( 'my_array_as_json', JSON.stringify( ['bird','cute'] ) )
208
- ```
209
-
210
- You may provide a string for options, or an object.
211
- ```javascript
212
- // Set filename by providing a string for options
213
- form.append( 'my_file', fs.createReadStream('/foo/bar.jpg'), 'bar.jpg' );
214
-
215
- // provide an object.
216
- form.append( 'my_file', fs.createReadStream('/foo/bar.jpg'), {filename: 'bar.jpg', contentType: 'image/jpeg', knownLength: 19806} );
217
- ```
218
-
219
- #### _Array_ getHeaders( [**Array** _userHeaders_] )
220
- This method ads the correct `content-type` header to the provided array of `userHeaders`.
221
-
222
- #### _String_ getBoundary()
223
- Return the boundary of the formData. A boundary consists of 26 `-` followed by 24 numbers
224
- for example:
225
- ```javascript
226
- --------------------------515890814546601021194782
227
- ```
228
- _Note: The boundary must be unique and may not appear in the data._
229
-
230
- #### _Buffer_ getBuffer()
231
- Return the full formdata request package, as a Buffer. You can insert this Buffer in e.g. Axios to send multipart data.
232
- ```javascript
233
- var form = new FormData();
234
- form.append( 'my_buffer', Buffer.from([0x4a,0x42,0x20,0x52,0x6f,0x63,0x6b,0x73]) );
235
- form.append( 'my_file', fs.readFileSync('/foo/bar.jpg') );
236
-
237
- axios.post( 'https://example.com/path/to/api',
238
- form.getBuffer(),
239
- form.getHeaders()
240
- )
241
- ```
242
- **Note:** Because the output is of type Buffer, you can only append types that are accepted by Buffer: *string, Buffer, ArrayBuffer, Array, or Array-like Object*. A ReadStream for example will result in an error.
243
-
244
- #### _Integer_ getLengthSync()
245
- Same as `getLength` but synchronous.
246
-
247
- _Note: getLengthSync __doesn't__ calculate streams length._
248
-
249
- #### _Integer_ getLength( **function** _callback_ )
250
- Returns the `Content-Length` async. The callback is used to handle errors and continue once the length has been calculated
251
- ```javascript
252
- this.getLength(function(err, length) {
253
- if (err) {
254
- this._error(err);
255
- return;
256
- }
257
-
258
- // add content length
259
- request.setHeader('Content-Length', length);
260
-
261
- ...
262
- }.bind(this));
263
- ```
264
-
265
- #### _Boolean_ hasKnownLength()
266
- Checks if the length of added values is known.
267
-
268
- #### _Request_ submit( _params_, **function** _callback_ )
269
- Submit the form to a web application.
270
- ```javascript
271
- var form = new FormData();
272
- form.append( 'my_string', 'Hello World' );
273
-
274
- form.submit( 'http://example.com/', function(err, res) {
275
- // res – response object (http.IncomingMessage) //
276
- res.resume();
277
- } );
278
- ```
279
-
280
- #### _String_ toString()
281
- Returns the form data as a string. Don't use this if you are sending files or buffers, use `getBuffer()` instead.
282
-
283
- ### Integration with other libraries
284
-
285
- #### Request
286
-
287
- Form submission using [request](https://github.com/request/request):
288
-
289
- ```javascript
290
- var formData = {
291
- my_field: 'my_value',
292
- my_file: fs.createReadStream(__dirname + '/unicycle.jpg'),
293
- };
294
-
295
- request.post({url:'http://service.com/upload', formData: formData}, function(err, httpResponse, body) {
296
- if (err) {
297
- return console.error('upload failed:', err);
298
- }
299
- console.log('Upload successful! Server responded with:', body);
300
- });
301
- ```
302
-
303
- For more details see [request readme](https://github.com/request/request#multipartform-data-multipart-form-uploads).
304
-
305
- #### node-fetch
306
-
307
- You can also submit a form using [node-fetch](https://github.com/bitinn/node-fetch):
308
-
309
- ```javascript
310
- var form = new FormData();
311
-
312
- form.append('a', 1);
313
-
314
- fetch('http://example.com', { method: 'POST', body: form })
315
- .then(function(res) {
316
- return res.json();
317
- }).then(function(json) {
318
- console.log(json);
319
- });
320
- ```
321
-
322
- #### axios
323
-
324
- In Node.js you can post a file using [axios](https://github.com/axios/axios):
325
- ```javascript
326
- const form = new FormData();
327
- const stream = fs.createReadStream(PATH_TO_FILE);
328
-
329
- form.append('image', stream);
330
-
331
- // In Node.js environment you need to set boundary in the header field 'Content-Type' by calling method `getHeaders`
332
- const formHeaders = form.getHeaders();
333
-
334
- axios.post('http://example.com', form, {
335
- headers: {
336
- ...formHeaders,
337
- },
338
- })
339
- .then(response => response)
340
- .catch(error => error)
341
- ```
342
-
343
- ## Notes
344
-
345
- - ```getLengthSync()``` method DOESN'T calculate length for streams, use ```knownLength``` options as workaround.
346
- - Starting version `2.x` FormData has dropped support for `node@0.10.x`.
347
-
348
- ## License
349
-
350
- Form-Data is released under the [MIT](License) license.
@@ -1,4 +0,0 @@
1
- language: node_js
2
- node_js:
3
- - 0.10
4
- - 0.11
@@ -1,5 +0,0 @@
1
-
2
- 1.0.0 / 2014-07-26
3
- ==================
4
-
5
- * initial commit
@@ -1,22 +0,0 @@
1
- (The MIT License)
2
-
3
- Copyright (c) 2014 Pebble Technology
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining
6
- a copy of this software and associated documentation files (the
7
- 'Software'), to deal in the Software without restriction, including
8
- without limitation the rights to use, copy, modify, merge, publish,
9
- distribute, sublicense, and/or sell copies of the Software, and to
10
- permit persons to whom the Software is furnished to do so, subject to
11
- the following conditions:
12
-
13
- The above copyright notice and this permission notice shall be
14
- included in all copies or substantial portions of the Software.
15
-
16
- THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
17
- EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18
- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
19
- IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
20
- CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
21
- TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
22
- SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -1,5 +0,0 @@
1
-
2
- test:
3
- @./node_modules/.bin/mocha
4
-
5
- .PHONY: test
@@ -1,19 +0,0 @@
1
- #has-own
2
-
3
- [![Build Status](https://travis-ci.org/pebble/has-own.svg?branch=master)](https://travis-ci.org/pebble/has-own)
4
-
5
- Shorthand `Object.prototype.hasOwnProperty.call(obj, name)`.
6
-
7
- ```js
8
- var assert = require('assert');
9
- var hasOwn = require('has-own');
10
-
11
- var o = Object.create(null);
12
- o.name = 'has-own';
13
-
14
- assert(hasOwn('name', o)); // true
15
- ```
16
-
17
- Why another module? Because I like its readability.
18
-
19
- [LICENSE](https://github.com/pebble/has-own/blob/master/LICENSE)
@@ -1,8 +0,0 @@
1
-
2
- var hasOwnProperty = Object.prototype.hasOwnProperty;
3
-
4
- module.exports = exports = function hasOwn(prop, obj) {
5
- return hasOwnProperty.call(obj, prop);
6
- }
7
-
8
- exports.version = require('./package.json').version;
@@ -1,19 +0,0 @@
1
- {
2
- "name": "has-own",
3
- "version": "1.0.1",
4
- "description": "A safer .hasOwnProperty() - hasOwn(name, obj)",
5
- "main": "index.js",
6
- "scripts": {
7
- "test": "make test"
8
- },
9
- "author": "Aaron Heckmann <aaron.heckmann+github@gmail.com>",
10
- "license": "MIT",
11
- "repository": {
12
- "type": "git",
13
- "url": "git://github.com/aheckmann/has-own.git"
14
- },
15
- "homepage": "https://github.com/aheckmann/has-own/",
16
- "devDependencies": {
17
- "mocha": "^6.2.2"
18
- }
19
- }
@@ -1,36 +0,0 @@
1
-
2
- var assert = require('assert');
3
- var hasOwn = require('../');
4
-
5
- describe('hasOwn', function() {
6
- it('works', function(done) {
7
- assert(hasOwn('name', { name: 'hasOwn' }));
8
- done();
9
- });
10
-
11
- it('handles overridden hasOwnProperty fns', function(done) {
12
- var o = { name: 'hasOwn' };
13
- o.hasOwnProperty = function() {}
14
-
15
- assert(hasOwn('name', o));
16
- done();
17
- });
18
-
19
- it('handles object created with Object.create(null)', function(done) {
20
- var o = Object.create(null);
21
- o.name = 'hasOwn';
22
- assert(hasOwn('name', o));
23
- done();
24
- });
25
-
26
- it('returns false when appropriate', function(done) {
27
- var o = { name: 'has-own' };
28
- assert(!hasOwn('age', o));
29
- done();
30
- });
31
-
32
- it('exposes its version', function(done) {
33
- assert('string' == typeof hasOwn.version);
34
- done();
35
- });
36
- });