@swell/cli 0.1.1 → 1.0.1-alpha

package/README.md

@@ -1,6 +1,18 @@
 # @swell/cli
 
-We're in beta: commands and arguments can still change.
+#We're in beta: commands and arguments can still change.#
+
+Install with:
+
+```sh
+npm install -g @swell/cli
+```
+
+If you are using tools for version managing like [asdf](https://asdf-vm.com/), make sure you [reshim](https://asdf-vm.com/manage/core.html#reshim) after install:
+
+```sh
+asdf reshim
+```
 
 # Commands
 
@@ -12,15 +24,10 @@ Commands tend to support the following helper options:
 - --verbose (-v): Boolean, outputs all commands
 - --dry-run: Boolean, dry runs requests that delete data, but doesn't run them
 - --yes (-y): Boolean, answers all confirmation questions with **yes**.
-- --secret-key: String, Enables ephemeral secret-key based authentication for commands
-
-## Store namespaces
-
-All commands accept a `--store` or `-s` option, which allows switching the context of the CLI commands to the selected store. When not in use, all commands refer to the set default store.
 
 ## Login
 
-The `login` command authenticates and stores a user's session locally. Saved sessions can/will be used by other commands, unless a secret key is specified.
+The `admin login` command authenticates and stores a user's session locally. Saved sessions can/will be used by other commands, unless a secret key is specified.
 
 ```sh
 swell login [--username (-u) String] [--password (-p) String] [--set-default Boolean]
@@ -30,54 +37,41 @@ swell login [--username (-u) String] [--password (-p) String] [--set-default Boo
 
 ```sh
 swell login
-swell login --store test
-swell login --store test-default --set-default
-# local login
-ADMIN_API_BASE_URL='http://${STORE_ID}.swell.test:4001/admin/api' swell login
+swell login --set-default
 ```
 
-## Storefront
-
-### Settings
+## Storefronts
 
-Push or pull storefront settings. Scopes include `settings`, `editor` and `menus`.
+List all storefronts associated to logged in user:
 
 ```sh
-# pull => retrieves settings from the server and tries to merge and/or write to a specified JSON file or stdout
-swell settings pull SCOPE [--file (-f) String] [--output (-o) Boolean] [--strategy String]
-
-# push => send settings from a JSON file or stdin to the server
-swell settings push SCOPE [--file (-f) String] [--input (-i) Boolean] [--strategy String]
+swell storefronts list
 ```
 
-### Examples
-
+Retrieves storefront configuration data from the server and writes it to a file if specified or stdout by default. It requires a type to run. Configuration types allowed are "editor", "menus" and "settings":
 ```sh
-swell storefront settings pull settings -f settings/store.json
-swell storefront settings pull settings -f settings/store.json --strategy ours # keeps our version of the file in case of conflicts
-
-swell storefront settings push editor -f settings/editor.json
-swell storefront settings push editor -f settings/editor.json --strategy "set" # overwrites the settings object instead of merging
-
-cat settings/menus.json | swell storefront settings push menus -i --strategy "defaults" # merges remote settings on top of the settings being pushed, as a default mechanism
+swell storefronts pull --id String --type (-t) String [--file (-f) String]
 ```
 
-### SSH Keys
+Send storefront configuration data to the server. Configuration types allowed are "editor", "menus" and "settings":
+```sh
+swell storefronts push --id String --type (-t) String [--file (-f) String] [--strategy (-i) String]
+```
 
-Manage a user's SSH keys to a storefront. Needs session authentication (`swell login`).
+### Examples
 
 ```sh
-swell storefront ssh-keys list
-swell storefront ssh-keys add [--name String]
-swell storefront ssh-keys delete KEY_ID [--dry-run Boolean]
+swell storefronts pull --id P5OzfzLD -t editor
+swell storefronts pull --id P5OzfzLD -t menus -f menus.json
+swell storefronts push --id P5OzfzLD -t editor -s set -f ../origin-storefront/config/editor.json
 ```
 
-### Examples
+### Without logging in
 
 ```sh
-swell storefront ssh-keys list
-swell storefront ssh-keys add --name deploy-key
-swell storefront ssh-keys delete abcdef1234567890
+swell storefronts pull --id P5OzfzLD -t editor --store my-test-store --secret-key my-dev-secret-key
+swell storefronts pull --id P5OzfzLD -t menus -f menus.json --store my-test-store --secret-key my-dev-secret-key
+swell storefronts push --id P5OzfzLD -t editor -s set -f ../origin-storefront/config/editor.json --store my-test-store --secret-key my-dev-secret-key
 ```
 
 ## Model
@@ -85,12 +79,12 @@ swell storefront ssh-keys delete abcdef1234567890
 Push or pull model definitions, including namespaced models (e.g. content models), abstract content models and content fields.
 
 ```sh
-# pull => retrieves a model from the server and tries to merge and/or write to a specified JSON file or stdout
+# pull => retrieves a model from the server and tries to merge and/or write to a specified JSON file or stdout (by default)
 # --content flag toggles between base models and abstract content models or content fields
-swell model pull MODEL_ID [--file (-f) String] [--output (-o) Boolean] [--strategy String] [--content Boolean]
+swell model pull -m MODEL_ID [--file (-f) String] [--strategy (-s) String] [--content Boolean]
 
 # push => send a model definition from a JSON file or stdin to the server
-swell model push [--file (-f) String] [--input (-i) Boolean] [--content Boolean]
+swell model push [--file (-f) String] [--input (-i) stdin] [--content Boolean]
 ```
 
 It is important that the model definition includes some fields depending on the type/source of the model.
@@ -129,32 +123,19 @@ It is important that the model definition includes some fields depending on the
 ### Examples
 
 ```sh
-swell model pull products -f models/products.json
-swell model pull products -f models/products.json --strategy ours # keeps our version of the file in case of conflicts
-swell model pull theme.origin.page --content --f models/page.json # pull a content model
+swell model pull -m products # pull products model and display in stdout
+swell model pull -m theme.origin.page --content -f models/page.json # pull a content model and save it to a file
 
 swell model push -f models/orders.json
-swell model push --content --f models/page.json # push a content model
-```
-
-## Settings
-
-Push or pull store settings (e.g. payments, shipping, etc...)
-
-```sh
-# pull => retrieves settings from the server and tries to merge and/or write to a specified JSON file or stdout
-swell settings pull SCOPE [--file (-f) String] [--output (-o) Boolean] [--strategy String]
-
-# push => send settings from a JSON file or stdin to the server
-swell settings push SCOPE [--file (-f) String] [--input (-i) Boolean] [--strategy String]
+swell model push -c -f models/page.json # push a content model
 ```
 
-### Examples
+### Without logging in
 
 ```sh
-swell settings pull payments -f settings/payments.json
-swell settings pull payments -f settings/payments.json --strategy ours # keeps our version of the file in case of conflicts
+swell model pull -m products --store my-test-store --secret-key my-dev-secret-key
+swell model pull -m theme.origin.page --content -f models/page.json --store my-test-store --secret-key my-dev-secret-key
 
-swell settings push payments -f settings/payments.json
-swell settings push payments -f settings/payments.json --strategy "set" # overwrites the settings object instead of merging
-```
+swell model push -f models/orders.json --store my-test-store --secret-key my-dev-secret-key
+swell model push -c -f models/page.json --store my-test-store --secret-key my-dev-secret-key
+```

package/dist/bin/{multipart-parser-fb5a5deb.js → multipart-parser-97941dba.js}

@@ -1,29 +1,27 @@
 #!/usr/bin/env node
 
-import 'fs';
-import 'path';
-import { F as FormData, a as File } from './swell-2acb6c0f.js';
-import 'assert';
-import 'child_process';
-import 'async_hooks';
-import 'util';
-import 'process';
-import 'os';
-import 'tty';
-import 'stream';
-import 'string_decoder';
-import 'buffer';
-import 'events';
-import 'url';
-import 'http';
-import 'https';
-import 'zlib';
-import 'stream/web';
-import 'net';
-import 'worker_threads';
-import 'readline';
-import 'constants';
-import 'crypto';
+import { F as FormData, a as File } from './swell-cfd63c19.js';
+import 'node:assert';
+import 'node:child_process';
+import 'node:async_hooks';
+import 'node:util';
+import 'node:process';
+import 'node:os';
+import 'node:tty';
+import 'node:fs';
+import 'node:path';
+import 'node:stream';
+import 'node:string_decoder';
+import 'node:buffer';
+import 'node:events';
+import 'node:url';
+import 'node:http';
+import 'node:https';
+import 'node:zlib';
+import 'node:net';
+import 'node:readline';
+import 'node:constants';
+import 'node:crypto';
 
 let s = 0;
 const S = {

package/dist/bin/multipart-parser-fc2dc43e.js

@@ -0,0 +1,456 @@
+#!/usr/bin/env node
+
+import { F as FormData, a as File } from './swell-96dae89a.js';
+import 'node:assert';
+import 'node:child_process';
+import 'node:async_hooks';
+import 'node:util';
+import 'node:process';
+import 'node:os';
+import 'node:tty';
+import 'node:fs';
+import 'node:path';
+import 'node:stream';
+import 'node:string_decoder';
+import 'node:buffer';
+import 'node:events';
+import 'node:url';
+import 'node:http';
+import 'node:https';
+import 'node:zlib';
+import 'node:net';
+import 'node:readline';
+import 'node:constants';
+import 'node:crypto';
+
+let s = 0;
+const S = {
+	START_BOUNDARY: s++,
+	HEADER_FIELD_START: s++,
+	HEADER_FIELD: s++,
+	HEADER_VALUE_START: s++,
+	HEADER_VALUE: s++,
+	HEADER_VALUE_ALMOST_DONE: s++,
+	HEADERS_ALMOST_DONE: s++,
+	PART_DATA_START: s++,
+	PART_DATA: s++,
+	END: s++
+};
+
+let f = 1;
+const F = {
+	PART_BOUNDARY: f,
+	LAST_BOUNDARY: f *= 2
+};
+
+const LF = 10;
+const CR = 13;
+const SPACE = 32;
+const HYPHEN = 45;
+const COLON = 58;
+const A = 97;
+const Z = 122;
+
+const lower = c => c | 0x20;
+
+const noop = () => {};
+
+class MultipartParser {
+	/**
+	 * @param {string} boundary
+	 */
+	constructor(boundary) {
+		this.index = 0;
+		this.flags = 0;
+
+		this.onHeaderEnd = noop;
+		this.onHeaderField = noop;
+		this.onHeadersEnd = noop;
+		this.onHeaderValue = noop;
+		this.onPartBegin = noop;
+		this.onPartData = noop;
+		this.onPartEnd = noop;
+
+		this.boundaryChars = {};
+
+		boundary = '\r\n--' + boundary;
+		const ui8a = new Uint8Array(boundary.length);
+		for (let i = 0; i < boundary.length; i++) {
+			ui8a[i] = boundary.charCodeAt(i);
+			this.boundaryChars[ui8a[i]] = true;
+		}
+
+		this.boundary = ui8a;
+		this.lookbehind = new Uint8Array(this.boundary.length + 8);
+		this.state = S.START_BOUNDARY;
+	}
+
+	/**
+	 * @param {Uint8Array} data
+	 */
+	write(data) {
+		let i = 0;
+		const length_ = data.length;
+		let previousIndex = this.index;
+		let {lookbehind, boundary, boundaryChars, index, state, flags} = this;
+		const boundaryLength = this.boundary.length;
+		const boundaryEnd = boundaryLength - 1;
+		const bufferLength = data.length;
+		let c;
+		let cl;
+
+		const mark = name => {
+			this[name + 'Mark'] = i;
+		};
+
+		const clear = name => {
+			delete this[name + 'Mark'];
+		};
+
+		const callback = (callbackSymbol, start, end, ui8a) => {
+			if (start === undefined || start !== end) {
+				this[callbackSymbol](ui8a && ui8a.subarray(start, end));
+			}
+		};
+
+		const dataCallback = (name, clear) => {
+			const markSymbol = name + 'Mark';
+			if (!(markSymbol in this)) {
+				return;
+			}
+
+			if (clear) {
+				callback(name, this[markSymbol], i, data);
+				delete this[markSymbol];
+			} else {
+				callback(name, this[markSymbol], data.length, data);
+				this[markSymbol] = 0;
+			}
+		};
+
+		for (i = 0; i < length_; i++) {
+			c = data[i];
+
+			switch (state) {
+				case S.START_BOUNDARY:
+					if (index === boundary.length - 2) {
+						if (c === HYPHEN) {
+							flags |= F.LAST_BOUNDARY;
+						} else if (c !== CR) {
+							return;
+						}
+
+						index++;
+						break;
+					} else if (index - 1 === boundary.length - 2) {
+						if (flags & F.LAST_BOUNDARY && c === HYPHEN) {
+							state = S.END;
+							flags = 0;
+						} else if (!(flags & F.LAST_BOUNDARY) && c === LF) {
+							index = 0;
+							callback('onPartBegin');
+							state = S.HEADER_FIELD_START;
+						} else {
+							return;
+						}
+
+						break;
+					}
+
+					if (c !== boundary[index + 2]) {
+						index = -2;
+					}
+
+					if (c === boundary[index + 2]) {
+						index++;
+					}
+
+					break;
+				case S.HEADER_FIELD_START:
+					state = S.HEADER_FIELD;
+					mark('onHeaderField');
+					index = 0;
+					// falls through
+				case S.HEADER_FIELD:
+					if (c === CR) {
+						clear('onHeaderField');
+						state = S.HEADERS_ALMOST_DONE;
+						break;
+					}
+
+					index++;
+					if (c === HYPHEN) {
+						break;
+					}
+
+					if (c === COLON) {
+						if (index === 1) {
+							// empty header field
+							return;
+						}
+
+						dataCallback('onHeaderField', true);
+						state = S.HEADER_VALUE_START;
+						break;
+					}
+
+					cl = lower(c);
+					if (cl < A || cl > Z) {
+						return;
+					}
+
+					break;
+				case S.HEADER_VALUE_START:
+					if (c === SPACE) {
+						break;
+					}
+
+					mark('onHeaderValue');
+					state = S.HEADER_VALUE;
+					// falls through
+				case S.HEADER_VALUE:
+					if (c === CR) {
+						dataCallback('onHeaderValue', true);
+						callback('onHeaderEnd');
+						state = S.HEADER_VALUE_ALMOST_DONE;
+					}
+
+					break;
+				case S.HEADER_VALUE_ALMOST_DONE:
+					if (c !== LF) {
+						return;
+					}
+
+					state = S.HEADER_FIELD_START;
+					break;
+				case S.HEADERS_ALMOST_DONE:
+					if (c !== LF) {
+						return;
+					}
+
+					callback('onHeadersEnd');
+					state = S.PART_DATA_START;
+					break;
+				case S.PART_DATA_START:
+					state = S.PART_DATA;
+					mark('onPartData');
+					// falls through
+				case S.PART_DATA:
+					previousIndex = index;
+
+					if (index === 0) {
+						// boyer-moore derrived algorithm to safely skip non-boundary data
+						i += boundaryEnd;
+						while (i < bufferLength && !(data[i] in boundaryChars)) {
+							i += boundaryLength;
+						}
+
+						i -= boundaryEnd;
+						c = data[i];
+					}
+
+					if (index < boundary.length) {
+						if (boundary[index] === c) {
+							if (index === 0) {
+								dataCallback('onPartData', true);
+							}
+
+							index++;
+						} else {
+							index = 0;
+						}
+					} else if (index === boundary.length) {
+						index++;
+						if (c === CR) {
+							// CR = part boundary
+							flags |= F.PART_BOUNDARY;
+						} else if (c === HYPHEN) {
+							// HYPHEN = end boundary
+							flags |= F.LAST_BOUNDARY;
+						} else {
+							index = 0;
+						}
+					} else if (index - 1 === boundary.length) {
+						if (flags & F.PART_BOUNDARY) {
+							index = 0;
+							if (c === LF) {
+								// unset the PART_BOUNDARY flag
+								flags &= ~F.PART_BOUNDARY;
+								callback('onPartEnd');
+								callback('onPartBegin');
+								state = S.HEADER_FIELD_START;
+								break;
+							}
+						} else if (flags & F.LAST_BOUNDARY) {
+							if (c === HYPHEN) {
+								callback('onPartEnd');
+								state = S.END;
+								flags = 0;
+							} else {
+								index = 0;
+							}
+						} else {
+							index = 0;
+						}
+					}
+
+					if (index > 0) {
+						// when matching a possible boundary, keep a lookbehind reference
+						// in case it turns out to be a false lead
+						lookbehind[index - 1] = c;
+					} else if (previousIndex > 0) {
+						// if our boundary turned out to be rubbish, the captured lookbehind
+						// belongs to partData
+						const _lookbehind = new Uint8Array(lookbehind.buffer, lookbehind.byteOffset, lookbehind.byteLength);
+						callback('onPartData', 0, previousIndex, _lookbehind);
+						previousIndex = 0;
+						mark('onPartData');
+
+						// reconsider the current character even so it interrupted the sequence
+						// it could be the beginning of a new sequence
+						i--;
+					}
+
+					break;
+				case S.END:
+					break;
+				default:
+					throw new Error(`Unexpected state entered: ${state}`);
+			}
+		}
+
+		dataCallback('onHeaderField');
+		dataCallback('onHeaderValue');
+		dataCallback('onPartData');
+
+		// Update properties for the next call
+		this.index = index;
+		this.state = state;
+		this.flags = flags;
+	}
+
+	end() {
+		if ((this.state === S.HEADER_FIELD_START && this.index === 0) ||
+			(this.state === S.PART_DATA && this.index === this.boundary.length)) {
+			this.onPartEnd();
+		} else if (this.state !== S.END) {
+			throw new Error('MultipartParser.end(): stream ended unexpectedly');
+		}
+	}
+}
+
+function _fileName(headerValue) {
+	// matches either a quoted-string or a token (RFC 2616 section 19.5.1)
+	const m = headerValue.match(/\bfilename=("(.*?)"|([^()<>@,;:\\"/[\]?={}\s\t]+))($|;\s)/i);
+	if (!m) {
+		return;
+	}
+
+	const match = m[2] || m[3] || '';
+	let filename = match.slice(match.lastIndexOf('\\') + 1);
+	filename = filename.replace(/%22/g, '"');
+	filename = filename.replace(/&#(\d{4});/g, (m, code) => {
+		return String.fromCharCode(code);
+	});
+	return filename;
+}
+
+async function toFormData(Body, ct) {
+	if (!/multipart/i.test(ct)) {
+		throw new TypeError('Failed to fetch');
+	}
+
+	const m = ct.match(/boundary=(?:"([^"]+)"|([^;]+))/i);
+
+	if (!m) {
+		throw new TypeError('no or bad content-type header, no multipart boundary');
+	}
+
+	const parser = new MultipartParser(m[1] || m[2]);
+
+	let headerField;
+	let headerValue;
+	let entryValue;
+	let entryName;
+	let contentType;
+	let filename;
+	const entryChunks = [];
+	const formData = new FormData();
+
+	const onPartData = ui8a => {
+		entryValue += decoder.decode(ui8a, {stream: true});
+	};
+
+	const appendToFile = ui8a => {
+		entryChunks.push(ui8a);
+	};
+
+	const appendFileToFormData = () => {
+		const file = new File(entryChunks, filename, {type: contentType});
+		formData.append(entryName, file);
+	};
+
+	const appendEntryToFormData = () => {
+		formData.append(entryName, entryValue);
+	};
+
+	const decoder = new TextDecoder('utf-8');
+	decoder.decode();
+
+	parser.onPartBegin = function () {
+		parser.onPartData = onPartData;
+		parser.onPartEnd = appendEntryToFormData;
+
+		headerField = '';
+		headerValue = '';
+		entryValue = '';
+		entryName = '';
+		contentType = '';
+		filename = null;
+		entryChunks.length = 0;
+	};
+
+	parser.onHeaderField = function (ui8a) {
+		headerField += decoder.decode(ui8a, {stream: true});
+	};
+
+	parser.onHeaderValue = function (ui8a) {
+		headerValue += decoder.decode(ui8a, {stream: true});
+	};
+
+	parser.onHeaderEnd = function () {
+		headerValue += decoder.decode();
+		headerField = headerField.toLowerCase();
+
+		if (headerField === 'content-disposition') {
+			// matches either a quoted-string or a token (RFC 2616 section 19.5.1)
+			const m = headerValue.match(/\bname=("([^"]*)"|([^()<>@,;:\\"/[\]?={}\s\t]+))/i);
+
+			if (m) {
+				entryName = m[2] || m[3] || '';
+			}
+
+			filename = _fileName(headerValue);
+
+			if (filename) {
+				parser.onPartData = appendToFile;
+				parser.onPartEnd = appendFileToFormData;
+			}
+		} else if (headerField === 'content-type') {
+			contentType = headerValue;
+		}
+
+		headerValue = '';
+		headerField = '';
+	};
+
+	for await (const chunk of Body) {
+		parser.write(chunk);
+	}
+
+	parser.end();
+
+	return formData;
+}
+
+export { toFormData };