e34fa2052a
Adds @xuqm/h5-sdk/private entry point with JSON-based initialization, feature gating, and error codes for private deployment scenarios. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
90 行
3.0 KiB
JavaScript
90 行
3.0 KiB
JavaScript
// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
|
|
// See LICENSE in the project root for license information.
|
|
import { TerminalChunkKind } from './ITerminalChunk';
|
|
import { TerminalTransform } from './TerminalTransform';
|
|
var State;
|
|
(function (State) {
|
|
State[State["Okay"] = 0] = "Okay";
|
|
State[State["StderrFragment"] = 1] = "StderrFragment";
|
|
State[State["InsertLinefeed"] = 2] = "InsertLinefeed";
|
|
})(State || (State = {}));
|
|
/**
|
|
* `DiscardStdoutTransform` discards `stdout` chunks while fixing up malformed `stderr` lines.
|
|
*
|
|
* @remarks
|
|
* Suppose that a poorly behaved process produces output like this:
|
|
*
|
|
* ```ts
|
|
* process.stdout.write('Starting operation...\n');
|
|
* process.stderr.write('An error occurred');
|
|
* process.stdout.write('\nFinishing up\n');
|
|
* process.stderr.write('The process completed with errors\n');
|
|
* ```
|
|
*
|
|
* When `stdout` and `stderr` are combined on the console, the mistake in the output would not be noticeable:
|
|
* ```
|
|
* Starting operation...
|
|
* An error occurred
|
|
* Finishing up
|
|
* The process completed with errors
|
|
* ```
|
|
*
|
|
* However, if we discard `stdout`, then `stderr` is missing a newline:
|
|
* ```
|
|
* An error occurredThe process completed with errors
|
|
* ```
|
|
*
|
|
* Tooling scripts can introduce these sorts of problems via edge cases that are difficult to find and fix.
|
|
* `DiscardStdoutTransform` can discard the `stdout` stream and fix up `stderr`:
|
|
*
|
|
* ```
|
|
* An error occurred
|
|
* The process completed with errors
|
|
* ```
|
|
*
|
|
* @privateRemarks
|
|
* This class is experimental and marked as `@beta`. The algorithm may need some fine-tuning, or there may
|
|
* be better solutions to this problem.
|
|
*
|
|
* @beta
|
|
*/
|
|
export class DiscardStdoutTransform extends TerminalTransform {
|
|
constructor(options) {
|
|
super(options);
|
|
this._state = State.Okay;
|
|
}
|
|
onWriteChunk(chunk) {
|
|
if (chunk.text.indexOf('\r') >= 0) {
|
|
throw new Error('DiscardStdoutTransform expects chunks with normalized newlines');
|
|
}
|
|
if (chunk.kind === TerminalChunkKind.Stdout) {
|
|
if (this._state === State.StderrFragment) {
|
|
if (chunk.text.indexOf('\n') >= 0) {
|
|
this._state = State.InsertLinefeed;
|
|
}
|
|
}
|
|
}
|
|
else if (chunk.kind === TerminalChunkKind.Stderr) {
|
|
let correctedText;
|
|
if (this._state === State.InsertLinefeed) {
|
|
correctedText = '\n' + chunk.text;
|
|
}
|
|
else {
|
|
correctedText = chunk.text;
|
|
}
|
|
this.destination.writeChunk({ kind: TerminalChunkKind.Stderr, text: correctedText });
|
|
if (correctedText.length > 0) {
|
|
if (correctedText[correctedText.length - 1] === '\n') {
|
|
this._state = State.Okay;
|
|
}
|
|
else {
|
|
this._state = State.StderrFragment;
|
|
}
|
|
}
|
|
}
|
|
else {
|
|
this.destination.writeChunk(chunk);
|
|
}
|
|
}
|
|
}
|
|
//# sourceMappingURL=DiscardStdoutTransform.js.map
|
