@ixfx/process 0.44.0 → 0.56.0

package/dist/src/if-undefined.js

@@ -1,68 +0,0 @@
-import { CancelError } from "./cancel-error.js";
-/**
- * Calls a function if the input value is not undefined.
- * Return value from function is passed to next function in flow.
- *
- * ```js
- * const flow = Process.flow(
- *  Process.max(),
- *  Process.seenLastToUndefined(),
- *  Process.ifNotUndefined(v => {
- *    console.log(`v:`, v);
- *  })
- * );
- * flow(100); // Prints 'v:100'
- * flow(90);  // Nothing happens max value has not changed
- * flow(110); // Prints 'v:110'
- * ```
- * @param fn
- * @returns
- */
-export function ifNotUndefined(fn) {
-    return (value) => {
-        if (value === undefined)
-            return value;
-        const v = fn(value);
-        return v;
-    };
-}
-/**
- * Cancels the remaining flow operations if _undefined_ is an input.
- * See also {@link ifUndefined} or {@link ifNotUndefined}.
- *
- * ```js
- * const c3 = Process.flow(
- *  Basic.max(),
- *  Process.seenLastToUndefined(),
- *  Process.cancelIfUndefined(),
- *  (v => {
- *   console.log(v);
- *  })
- * );
- * c3(100); // Prints '100'
- * c3(90);  // Doesn't print anything since max does not change
- * c3(110); // Prints '110'
- * ```
- * @returns
- */
-export function cancelIfUndefined() {
-    return (value) => {
-        if (value === undefined)
-            throw new CancelError(`cancel`);
-        return value;
-    };
-}
-/**
- * Returns the output of `fn` if the input value is _undefined_.
- * See also: {@link ifNotUndefined} and {@link cancelIfUndefined}.
- * @param fn
- * @returns
- */
-export function ifUndefined(fn) {
-    return (value) => {
-        if (value === undefined)
-            return fn();
-        else
-            return value;
-    };
-}

package/dist/src/index.d.ts

@@ -1,7 +0,0 @@
-export type * from './types.js';
-export * from './basic.js';
-export * from './cancel-error.js';
-export * from './flow.js';
-export * from './if-undefined.js';
-export * from './seen.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAC;AAChC,cAAe,YAAY,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAA"}

package/dist/src/index.js

@@ -1,5 +0,0 @@
-export * from './basic.js';
-export * from './cancel-error.js';
-export * from './flow.js';
-export * from './if-undefined.js';
-export * from './seen.js';

package/dist/src/seen.d.ts

@@ -1,33 +0,0 @@
-import type { Process } from "./types.js";
-/**
- * If a value is same as the previous value, _undefined_ is emitted instead.
- *
- * @param eq Equality function. If not specified, === semantics are used.
- * @returns
- */
-export declare function seenLastToUndefined<TIn>(eq?: (a: TIn, b: TIn) => boolean): Process<TIn, TIn | undefined>;
-/**
- * If a value is same as any previously-seen value, _undefined_ is emitted instead.
- *
- * It stores all previous values and compares against them for each new value.
- * This would likely be not very efficient compared to {@link seenToUndefinedByKey} which uses a one-time computed
- * key and efficient storage of only the keys (using a Set).
- *
- * @param eq Equality function. If not specified, === semantics are used.
- * @returns
- */
-export declare function seenToUndefined<TIn>(eq?: (a: TIn, b: TIn) => boolean): Process<TIn, TIn | undefined>;
-/**
- * If a value is the same as any previously-seen value, _undefined_ is emitted instead.
- *
- * This version uses a function to create a string key of the object, by default JSON.stringify.
- * Thus we don't need to store all previously seen objects, just their keys.
- *
- * Alternatively, if a key function doesn't make sense for the value, use
- * {@link seenToUndefined}, which stores the values (less efficient).
- *
- * @param toString
- * @returns
- */
-export declare function seenToUndefinedByKey<TIn>(toString?: (value: TIn) => string): Process<TIn, TIn | undefined>;
-//# sourceMappingURL=seen.d.ts.map

package/dist/src/seen.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"seen.d.ts","sourceRoot":"","sources":["../../src/seen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC,CAUxG;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC,CAWpG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC,CAU1G"}

package/dist/src/seen.js

@@ -1,70 +0,0 @@
-import { isEqualDefault, toStringDefault } from "./util.js";
-/**
- * If a value is same as the previous value, _undefined_ is emitted instead.
- *
- * @param eq Equality function. If not specified, === semantics are used.
- * @returns
- */
-export function seenLastToUndefined(eq) {
-    if (typeof eq === `undefined`)
-        eq = isEqualDefault;
-    let lastValue;
-    return (value) => {
-        if (value !== lastValue) {
-            lastValue = value;
-            return value;
-        }
-        return undefined;
-    };
-}
-/**
- * If a value is same as any previously-seen value, _undefined_ is emitted instead.
- *
- * It stores all previous values and compares against them for each new value.
- * This would likely be not very efficient compared to {@link seenToUndefinedByKey} which uses a one-time computed
- * key and efficient storage of only the keys (using a Set).
- *
- * @param eq Equality function. If not specified, === semantics are used.
- * @returns
- */
-export function seenToUndefined(eq) {
-    const seen = [];
-    if (typeof eq === `undefined`)
-        eq = isEqualDefault;
-    return (value) => {
-        if (value === undefined)
-            return;
-        for (const s of seen) {
-            if (eq(s, value))
-                return;
-        }
-        seen.push(value);
-        return value;
-    };
-}
-/**
- * If a value is the same as any previously-seen value, _undefined_ is emitted instead.
- *
- * This version uses a function to create a string key of the object, by default JSON.stringify.
- * Thus we don't need to store all previously seen objects, just their keys.
- *
- * Alternatively, if a key function doesn't make sense for the value, use
- * {@link seenToUndefined}, which stores the values (less efficient).
- *
- * @param toString
- * @returns
- */
-export function seenToUndefinedByKey(toString) {
-    const seen = new Set();
-    if (typeof toString === `undefined`)
-        toString = toStringDefault;
-    return (value) => {
-        if (value === undefined)
-            return;
-        const key = toString(value);
-        if (seen.has(key))
-            return;
-        seen.add(key);
-        return value;
-    };
-}

package/dist/src/types.d.ts

@@ -1,51 +0,0 @@
-export type Process<TIn, TOut> = (value: TIn) => TOut;
-export type ProcessFactory<TIn, TOut> = () => Process<TIn, TOut>;
-export type Processors1<T1, T2> = [
-    Process<T1, T2>
-];
-export type Processors2<T1, T2, T3> = [
-    Process<T1, T2>,
-    Process<T2, T3>
-];
-export type Processors3<T1, T2, T3, T4> = [
-    Process<T1, T2>,
-    Process<T2, T3>,
-    Process<T3, T4>
-];
-export type Processors4<T1, T2, T3, T4, T5> = [
-    Process<T1, T2>,
-    Process<T2, T3>,
-    Process<T3, T4>,
-    Process<T4, T5>
-];
-export type Processors5<T1, T2, T3, T4, T5, T6> = [
-    Process<T1, T2>,
-    Process<T2, T3>,
-    Process<T3, T4>,
-    Process<T4, T5>,
-    Process<T5, T6>
-];
-export type Processors<T1, T2, T3, T4, T5, T6> = Processors1<T1, T2> | Processors2<T1, T2, T3> | Processors3<T1, T2, T3, T4> | Processors4<T1, T2, T3, T4, T5> | Processors5<T1, T2, T3, T4, T5, T6>;
-/**
- * A rank function that compares A and B.
- * Returns the highest value, 'a' or 'b'.
- * Returns 'eq' if values are equal
- */
-export type RankFunction<T> = (a: T, b: T) => `a` | `b` | `eq`;
-export type RankOptions = {
-    /**
-     * If set, only values with this JS type are included
-     */
-    includeType?: `string` | `number` | `object` | `boolean`;
-    /**
-     * If _true_, also emits values when they rank equal with current highest.
-     * _false_ by default
-     */
-    emitEqualRanked?: boolean;
-    /**
-     * If _true_, emits the current highest value even if it hasn't changed.
-     * This means it will match the tempo of the incoming stream.
-     */
-    emitRepeatHighest?: boolean;
-};
-//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;AACtD,MAAM,MAAM,cAAc,CAAC,GAAG,EAAE,IAAI,IAAI,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAEjE,MAAM,MAAM,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI;IAChC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;CAChB,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI;IACpC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;CAChB,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI;IACxC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;CAChB,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI;IAC5C,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;CAChB,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI;IAChD,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC;CAChB,CAAA;AACD,MAAM,MAAM,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAGrM;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,GAAG,GAAG,GAAG,GAAG,IAAI,CAAA;AAE9D,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;IACxD;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA"}

package/dist/src/types.js

@@ -1 +0,0 @@
-export {};

package/dist/src/util.d.ts

@@ -1,10 +0,0 @@
-/**
- * Default comparer function is equiv to checking `a === b`.
- * Use {@link isEqualValueDefault} to compare by value, via comparing JSON string representation.
- */
-export declare const isEqualDefault: <T>(a: T, b: T) => boolean;
-/**
- * A default converter to string that uses JSON.stringify if its an object, or the thing itself if it's a string
- */
-export declare const toStringDefault: <V>(itemToMakeStringFor: V) => string;
-//# sourceMappingURL=util.d.ts.map

package/dist/src/util.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,KAAG,OAAkB,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,qBAAqB,CAAC,KAAG,MAGnB,CAAC"}

package/dist/src/util.js

@@ -1,11 +0,0 @@
-/**
- * Default comparer function is equiv to checking `a === b`.
- * Use {@link isEqualValueDefault} to compare by value, via comparing JSON string representation.
- */
-export const isEqualDefault = (a, b) => a === b;
-/**
- * A default converter to string that uses JSON.stringify if its an object, or the thing itself if it's a string
- */
-export const toStringDefault = (itemToMakeStringFor) => typeof itemToMakeStringFor === `string`
-    ? itemToMakeStringFor
-    : JSON.stringify(itemToMakeStringFor);

package/dist/tsconfig.tsbuildinfo

@@ -1 +0,0 @@
-{"root":["../src/basic.ts","../src/cancel-error.ts","../src/flow.ts","../src/if-undefined.ts","../src/index.ts","../src/seen.ts","../src/types.ts","../src/util.ts","../__tests__/process.test.ts"],"version":"5.8.3"}