Compare commits
14 Commits
Author | SHA1 | Date | |
---|---|---|---|
e3427c2498 | |||
a400a0a04c | |||
91392e8bd5 | |||
d161d6613a | |||
7a14e67f4f | |||
465ccfec40 | |||
3adb16d1f8 | |||
a9230ca790 | |||
788f2665c2 | |||
7b678cc856 | |||
12c9d8cc9d | |||
3a2dc1c37e | |||
1f67bc0e1e | |||
b15ddd987c |
10
package.json
10
package.json
@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "@push.rocks/smartstream",
|
"name": "@push.rocks/smartstream",
|
||||||
"version": "3.0.12",
|
"version": "3.0.19",
|
||||||
"private": false,
|
"private": false,
|
||||||
"description": "simplifies access to node streams",
|
"description": "simplifies access to node streams",
|
||||||
"main": "dist_ts/index.js",
|
"main": "dist_ts/index.js",
|
||||||
@ -24,12 +24,14 @@
|
|||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@git.zone/tsbuild": "^2.1.66",
|
"@git.zone/tsbuild": "^2.1.66",
|
||||||
"@git.zone/tsrun": "^1.2.44",
|
"@git.zone/tsrun": "^1.2.44",
|
||||||
"@git.zone/tstest": "^1.0.77",
|
"@git.zone/tstest": "^1.0.84",
|
||||||
"@push.rocks/smartfile": "^10.0.37",
|
"@push.rocks/smartdelay": "^3.0.5",
|
||||||
|
"@push.rocks/smartfile": "^11.0.0",
|
||||||
"@push.rocks/tapbundle": "^5.0.15",
|
"@push.rocks/tapbundle": "^5.0.15",
|
||||||
"@types/node": "^20.8.10"
|
"@types/node": "^20.9.0"
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
|
"@push.rocks/lik": "^6.0.6",
|
||||||
"@push.rocks/smartpromise": "^4.0.3",
|
"@push.rocks/smartpromise": "^4.0.3",
|
||||||
"@push.rocks/smartrx": "^3.0.7"
|
"@push.rocks/smartrx": "^3.0.7"
|
||||||
},
|
},
|
||||||
|
454
pnpm-lock.yaml
generated
454
pnpm-lock.yaml
generated
File diff suppressed because it is too large
Load Diff
0
readme_instructions.md
Normal file
0
readme_instructions.md
Normal file
57
test/backpressure.ts
Normal file
57
test/backpressure.ts
Normal file
@ -0,0 +1,57 @@
|
|||||||
|
import { SmartDuplex, type ISmartDuplexOptions, StreamWrapper } from '../ts/index.js';
|
||||||
|
|
||||||
|
import * as smartdelay from '@push.rocks/smartdelay';
|
||||||
|
|
||||||
|
async function testBackpressure() {
|
||||||
|
const stream1 = new SmartDuplex({
|
||||||
|
objectMode: true,
|
||||||
|
handleBackpressure: true,
|
||||||
|
writeFunction: async (chunk, tools) => {
|
||||||
|
console.log(`processed chunk ${chunk} in stream 1`);
|
||||||
|
return chunk; // Fast processing
|
||||||
|
}
|
||||||
|
});
|
||||||
|
const stream2 = new SmartDuplex({
|
||||||
|
objectMode: true,
|
||||||
|
handleBackpressure: true,
|
||||||
|
writeFunction: async (chunk, tools) => {
|
||||||
|
await new Promise(resolve => setTimeout(resolve, 100)); // Slow processing
|
||||||
|
console.log(`processed chunk ${chunk} in stream 2`);
|
||||||
|
return chunk;
|
||||||
|
}
|
||||||
|
}); // This stream processes data more slowly
|
||||||
|
const stream3 = new SmartDuplex({
|
||||||
|
handleBackpressure: false,
|
||||||
|
writeFunction: async (chunk, tools) => {
|
||||||
|
console.log(`finished chunk ${chunk} in stream 3`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
stream1.pipe(stream2).pipe(stream3);
|
||||||
|
|
||||||
|
let backpressured = false;
|
||||||
|
for (let i = 1; i < 100; i++) {
|
||||||
|
const canContinue = stream1.write(`Chunk ${i}`, 'utf8');
|
||||||
|
if (!canContinue) {
|
||||||
|
backpressured = true;
|
||||||
|
console.log(`Backpressure at chunk ${i}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
stream1.end();
|
||||||
|
|
||||||
|
stream1.on('finish', () => {
|
||||||
|
console.log('Stream 1 finished processing.');
|
||||||
|
});
|
||||||
|
stream2.on('finish', () => {
|
||||||
|
console.log('Stream 2 finished processing.');
|
||||||
|
});
|
||||||
|
stream3.on('finish', () => {
|
||||||
|
console.log('Stream 3 finished processing.');
|
||||||
|
if (!backpressured) {
|
||||||
|
console.log('No backpressure was observed.');
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
testBackpressure();
|
@ -5,7 +5,9 @@ import * as fs from 'fs';
|
|||||||
|
|
||||||
tap.test('should create a SmartStream from a Buffer', async () => {
|
tap.test('should create a SmartStream from a Buffer', async () => {
|
||||||
const bufferData = Buffer.from('This is a test buffer');
|
const bufferData = Buffer.from('This is a test buffer');
|
||||||
const smartStream = SmartDuplex.fromBuffer(bufferData);
|
const smartStream = SmartDuplex.fromBuffer(bufferData, {
|
||||||
|
handleBackpressure: false,
|
||||||
|
});
|
||||||
|
|
||||||
let receivedData = Buffer.alloc(0);
|
let receivedData = Buffer.alloc(0);
|
||||||
|
|
||||||
@ -25,7 +27,9 @@ tap.test('should create a SmartStream from an Observable', async () => {
|
|||||||
const observableData = 'Observable test data';
|
const observableData = 'Observable test data';
|
||||||
const testObservable = smartrx.rxjs.of(Buffer.from(observableData));
|
const testObservable = smartrx.rxjs.of(Buffer.from(observableData));
|
||||||
|
|
||||||
const smartStream = SmartDuplex.fromObservable(testObservable);
|
const smartStream = SmartDuplex.fromObservable(testObservable, {
|
||||||
|
handleBackpressure: false,
|
||||||
|
});
|
||||||
|
|
||||||
let receivedData = Buffer.alloc(0);
|
let receivedData = Buffer.alloc(0);
|
||||||
|
|
||||||
|
@ -29,7 +29,7 @@ tap.test('should handle a read stream', async (tools) => {
|
|||||||
},
|
},
|
||||||
})
|
})
|
||||||
]);
|
]);
|
||||||
// await streamWrapper.run();
|
await streamWrapper.run();
|
||||||
});
|
});
|
||||||
|
|
||||||
tap.test('should create a valid Intake', async (tools) => {
|
tap.test('should create a valid Intake', async (tools) => {
|
||||||
|
@ -3,6 +3,6 @@
|
|||||||
*/
|
*/
|
||||||
export const commitinfo = {
|
export const commitinfo = {
|
||||||
name: '@push.rocks/smartstream',
|
name: '@push.rocks/smartstream',
|
||||||
version: '3.0.12',
|
version: '3.0.19',
|
||||||
description: 'simplifies access to node streams'
|
description: 'simplifies access to node streams'
|
||||||
}
|
}
|
||||||
|
@ -14,7 +14,8 @@ export interface IStreamFinalFunction<rT> {
|
|||||||
(toolsArg: IStreamTools): Promise<rT>;
|
(toolsArg: IStreamTools): Promise<rT>;
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface SmartStreamOptions<TInput, TOutput> extends DuplexOptions {
|
export interface ISmartDuplexOptions<TInput, TOutput> extends DuplexOptions {
|
||||||
|
handleBackpressure?: boolean;
|
||||||
readFunction?: () => Promise<void>;
|
readFunction?: () => Promise<void>;
|
||||||
writeFunction?: IStreamWriteFunction<TInput, TOutput>;
|
writeFunction?: IStreamWriteFunction<TInput, TOutput>;
|
||||||
finalFunction?: IStreamFinalFunction<TOutput>;
|
finalFunction?: IStreamFinalFunction<TOutput>;
|
||||||
@ -23,23 +24,23 @@ export interface SmartStreamOptions<TInput, TOutput> extends DuplexOptions {
|
|||||||
|
|
||||||
export class SmartDuplex<TInput = any, TOutput = any> extends Duplex {
|
export class SmartDuplex<TInput = any, TOutput = any> extends Duplex {
|
||||||
// STATIC
|
// STATIC
|
||||||
static fromBuffer(buffer: Buffer, options?: DuplexOptions): SmartDuplex {
|
static fromBuffer(buffer: Buffer, options?: ISmartDuplexOptions<any, any>): SmartDuplex {
|
||||||
const smartStream = new SmartDuplex(options);
|
const smartDuplex = new SmartDuplex(options);
|
||||||
process.nextTick(() => {
|
process.nextTick(() => {
|
||||||
smartStream.push(buffer);
|
smartDuplex.push(buffer);
|
||||||
smartStream.push(null); // Signal the end of the data
|
smartDuplex.push(null); // Signal the end of the data
|
||||||
});
|
});
|
||||||
return smartStream;
|
return smartDuplex;
|
||||||
}
|
}
|
||||||
|
|
||||||
static fromObservable(
|
static fromObservable(
|
||||||
observable: plugins.smartrx.rxjs.Observable<any>,
|
observable: plugins.smartrx.rxjs.Observable<any>,
|
||||||
options?: DuplexOptions
|
options?: ISmartDuplexOptions<any, any>
|
||||||
): SmartDuplex {
|
): SmartDuplex {
|
||||||
const smartStream = new SmartDuplex(options);
|
const smartStream = new SmartDuplex(options);
|
||||||
smartStream.observableSubscription = observable.subscribe({
|
smartStream.observableSubscription = observable.subscribe({
|
||||||
next: (data) => {
|
next: (data) => {
|
||||||
if (!smartStream.push(data)) {
|
if (!smartStream.push(data) && smartStream.handleBackpressure) {
|
||||||
// Pause the observable if the stream buffer is full
|
// Pause the observable if the stream buffer is full
|
||||||
smartStream.observableSubscription?.unsubscribe();
|
smartStream.observableSubscription?.unsubscribe();
|
||||||
smartStream.once('drain', () => {
|
smartStream.once('drain', () => {
|
||||||
@ -109,15 +110,17 @@ export class SmartDuplex<TInput = any, TOutput = any> extends Duplex {
|
|||||||
|
|
||||||
// INSTANCE
|
// INSTANCE
|
||||||
private readFunction?: () => Promise<void>;
|
private readFunction?: () => Promise<void>;
|
||||||
|
private handleBackpressure: boolean;
|
||||||
private writeFunction?: IStreamWriteFunction<TInput, TOutput>;
|
private writeFunction?: IStreamWriteFunction<TInput, TOutput>;
|
||||||
private finalFunction?: IStreamFinalFunction<TOutput>;
|
private finalFunction?: IStreamFinalFunction<TOutput>;
|
||||||
private observableSubscription?: plugins.smartrx.rxjs.Subscription;
|
private observableSubscription?: plugins.smartrx.rxjs.Subscription;
|
||||||
|
|
||||||
constructor(optionsArg?: SmartStreamOptions<TInput, TOutput>) {
|
constructor(optionsArg?: ISmartDuplexOptions<TInput, TOutput>) {
|
||||||
super(optionsArg);
|
super(optionsArg);
|
||||||
this.readFunction = optionsArg?.readFunction;
|
this.readFunction = optionsArg?.readFunction;
|
||||||
this.writeFunction = optionsArg?.writeFunction;
|
this.writeFunction = optionsArg?.writeFunction;
|
||||||
this.finalFunction = optionsArg?.finalFunction;
|
this.finalFunction = optionsArg?.finalFunction;
|
||||||
|
this.handleBackpressure = optionsArg?.handleBackpressure ?? true;
|
||||||
}
|
}
|
||||||
|
|
||||||
public async _read(size: number): Promise<void> {
|
public async _read(size: number): Promise<void> {
|
||||||
@ -126,6 +129,8 @@ export class SmartDuplex<TInput = any, TOutput = any> extends Duplex {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
private asyncWritePromiseObjectmap = new plugins.lik.ObjectMap<Promise<any>>();
|
||||||
|
|
||||||
// Ensure the _write method types the chunk as TInput and encodes TOutput
|
// Ensure the _write method types the chunk as TInput and encodes TOutput
|
||||||
public async _write(chunk: TInput, encoding: string, callback: (error?: Error | null) => void) {
|
public async _write(chunk: TInput, encoding: string, callback: (error?: Error | null) => void) {
|
||||||
if (!this.writeFunction) {
|
if (!this.writeFunction) {
|
||||||
@ -141,19 +146,39 @@ export class SmartDuplex<TInput = any, TOutput = any> extends Duplex {
|
|||||||
};
|
};
|
||||||
|
|
||||||
try {
|
try {
|
||||||
|
const writeDeferred = plugins.smartpromise.defer();
|
||||||
|
this.asyncWritePromiseObjectmap.add(writeDeferred.promise);
|
||||||
const modifiedChunk = await this.writeFunction(chunk, tools);
|
const modifiedChunk = await this.writeFunction(chunk, tools);
|
||||||
if (modifiedChunk) {
|
if (modifiedChunk) {
|
||||||
if (!this.push(modifiedChunk)) {
|
const drainDeferred = plugins.smartpromise.defer();
|
||||||
// Handle backpressure if necessary
|
this.once('drain', () => {
|
||||||
}
|
drainDeferred.resolve();
|
||||||
}
|
});
|
||||||
|
const canPushMore = this.push(modifiedChunk);
|
||||||
|
if (!canPushMore) {
|
||||||
|
await drainDeferred.promise;
|
||||||
|
console.log('jojojo');
|
||||||
callback();
|
callback();
|
||||||
|
writeDeferred.resolve();
|
||||||
|
} else {
|
||||||
|
callback();
|
||||||
|
writeDeferred.resolve();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
callback();
|
||||||
|
writeDeferred.resolve();
|
||||||
|
}
|
||||||
|
writeDeferred.resolve();
|
||||||
|
writeDeferred.promise.then(() => {
|
||||||
|
this.asyncWritePromiseObjectmap.remove(writeDeferred.promise);
|
||||||
|
});
|
||||||
} catch (err) {
|
} catch (err) {
|
||||||
callback(err);
|
callback(err);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
public async _final(callback: (error?: Error | null) => void) {
|
public async _final(callback: (error?: Error | null) => void) {
|
||||||
|
await Promise.all(this.asyncWritePromiseObjectmap.getArray());
|
||||||
if (this.finalFunction) {
|
if (this.finalFunction) {
|
||||||
const tools: IStreamTools = {
|
const tools: IStreamTools = {
|
||||||
truncate: () => callback(),
|
truncate: () => callback(),
|
||||||
@ -166,10 +191,10 @@ export class SmartDuplex<TInput = any, TOutput = any> extends Duplex {
|
|||||||
this.push(finalChunk);
|
this.push(finalChunk);
|
||||||
}
|
}
|
||||||
} catch (err) {
|
} catch (err) {
|
||||||
|
this.push(null);
|
||||||
callback(err);
|
callback(err);
|
||||||
|
return;
|
||||||
}
|
}
|
||||||
} else {
|
|
||||||
// nothing here
|
|
||||||
}
|
}
|
||||||
this.push(null);
|
this.push(null);
|
||||||
callback();
|
callback();
|
||||||
|
@ -1,4 +1,5 @@
|
|||||||
import { Transform, type TransformCallback, type TransformOptions } from 'stream';
|
import { Transform, type TransformCallback, type TransformOptions } from 'stream';
|
||||||
|
import { SmartDuplex } from './smartstream.classes.smartduplex.js';
|
||||||
|
|
||||||
export interface AsyncTransformFunction<TInput, TOutput> {
|
export interface AsyncTransformFunction<TInput, TOutput> {
|
||||||
(chunkArg: TInput): Promise<TOutput>;
|
(chunkArg: TInput): Promise<TOutput>;
|
||||||
@ -7,20 +8,14 @@ export interface AsyncTransformFunction<TInput, TOutput> {
|
|||||||
export function createTransformFunction<TInput, TOutput>(
|
export function createTransformFunction<TInput, TOutput>(
|
||||||
asyncFunction: AsyncTransformFunction<TInput, TOutput>,
|
asyncFunction: AsyncTransformFunction<TInput, TOutput>,
|
||||||
options?: TransformOptions
|
options?: TransformOptions
|
||||||
): Transform {
|
): SmartDuplex {
|
||||||
const transformStream = new Transform({
|
const smartDuplexStream = new SmartDuplex({
|
||||||
...options,
|
...options,
|
||||||
objectMode: true, // Ensure we operate in object mode
|
writeFunction: async (chunkArg, toolsArg) => {
|
||||||
async transform(chunk: TInput, encoding: string, callback: TransformCallback) {
|
const result = await asyncFunction(chunkArg);
|
||||||
try {
|
return result;
|
||||||
const transformed = await asyncFunction(chunk);
|
|
||||||
this.push(transformed);
|
|
||||||
callback();
|
|
||||||
} catch (error) {
|
|
||||||
callback(error instanceof Error ? error : new Error(String(error)));
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
return transformStream;
|
return smartDuplexStream;
|
||||||
}
|
}
|
@ -4,8 +4,9 @@ import * as stream from 'stream';
|
|||||||
export { stream };
|
export { stream };
|
||||||
|
|
||||||
// pushrocks scope
|
// pushrocks scope
|
||||||
|
import * as lik from '@push.rocks/lik';
|
||||||
import * as smartpromise from '@push.rocks/smartpromise';
|
import * as smartpromise from '@push.rocks/smartpromise';
|
||||||
import * as smartrx from '@push.rocks/smartrx';
|
import * as smartrx from '@push.rocks/smartrx';
|
||||||
|
|
||||||
export { smartpromise, smartrx };
|
export { lik, smartpromise, smartrx };
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user