@helpers4/observable 1.0.1 → 2.0.0-alpha.10

package/README.md

@@ -5,14 +5,62 @@ Every helper is a standalone module and supports tree-shaking, so you can use on
 
 ## @helpers4/observable
 
-A set of helpers for working with observables.
+A set of helpers for working with URLs.
 
 ## Documentation
 
-[https://helpers4.github.io/observable](https://helpers4.github.io/observable)
+[https://helpers4.dev/typescript/categories/observable/](https://helpers4.dev/typescript/categories/observable/)
+
+<!-- AUTOMATIC-METHODS -->
+- combine
+- combineLatest
+<!-- /AUTOMATIC-METHODS -->
 
 ## See
 
-- [@helpers4/observable](https://www.npmjs.com/package/@helpers4/observable)
-- [@helpers4/string](https://www.npmjs.com/package/@helpers4/string)
-- [@helpers4/url](https://www.npmjs.com/package/@helpers4/url)
+<!-- AUTOMATIC-SIBLINGS -->
+- [array](../array)
+- [date](../date)
+- [function](../function)
+- [math](../math)
+- [number](../number)
+- [object](../object)
+- [promise](../promise)
+- [string](../string)
+- [type](../type)
+- [url](../url)
+- [version](../version)
+<!-- /AUTOMATIC-SIBLINGS -->
+
+## All Available Packages
+
+<!-- AUTOMATIC-CATEGORIES-TABLE -->
+| Name | Package | Source Code | Description |
+|------|---------|-------------|-------------|
+| array | [@helpers4/array](https://www.npmjs.com/package/@helpers4/array) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/array) | Array manipulation utilities |
+| date | [@helpers4/date](https://www.npmjs.com/package/@helpers4/date) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/date) | date utilities |
+| function | [@helpers4/function](https://www.npmjs.com/package/@helpers4/function) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/function) | Function utilities and type guards |
+| math | [@helpers4/math](https://www.npmjs.com/package/@helpers4/math) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/math) | math utilities |
+| number | [@helpers4/number](https://www.npmjs.com/package/@helpers4/number) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/number) | number utilities |
+| object | [@helpers4/object](https://www.npmjs.com/package/@helpers4/object) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/object) | Object manipulation utilities |
+| observable | [@helpers4/observable](https://www.npmjs.com/package/@helpers4/observable) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/observable) | Observable utilities and combinators |
+| promise | [@helpers4/promise](https://www.npmjs.com/package/@helpers4/promise) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/promise) | Promise utilities and error handling |
+| string | [@helpers4/string](https://www.npmjs.com/package/@helpers4/string) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/string) | String manipulation and formatting utilities |
+| type | [@helpers4/type](https://www.npmjs.com/package/@helpers4/type) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/type) | type utilities |
+| url | [@helpers4/url](https://www.npmjs.com/package/@helpers4/url) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/url) | URL parsing and manipulation utilities |
+| version | [@helpers4/version](https://www.npmjs.com/package/@helpers4/version) | [Source](https://github.com/helpers4/helpers4/tree/main/helpers/version) | Version string manipulation utilities |
+<!-- /AUTOMATIC-CATEGORIES-TABLE -->
+
+## Contributors
+
+<table>
+<tr>
+    <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">
+        <a href=https://github.com/baxyz>
+            <img src=https://avatars.githubusercontent.com/u/7852177?v=4 width="100;" alt=baxyz/>
+            <br />
+            <sub style="font-size:14px"><b>baxyz</b></sub>
+        </a>
+    </td>
+</tr>
+</table>

package/lib/index.d.ts

@@ -0,0 +1,41 @@
+import { Observable, OperatorFunction, ObservableInputTuple, ObservableInput, ObservedValueOf } from 'rxjs';
+
+/**
+ * This file is part of helpers4.
+ * Copyright (C) 2025 baxyz
+ * SPDX-License-Identifier: LGPL-3.0-or-later
+ */
+
+type combineOptions<T, U> = {
+    readonly preTreatment?: OperatorFunction<readonly [T, U], readonly [T, U]>;
+};
+/**
+ * Combine two observables with a map function and an optional pre-treatment.
+ *
+ * Note: you can use the pre-treatment to add a filter, a distinctUntilChanged,
+ * any other operator that can be used in a pipe, or even an `UntilDestroy`
+ * operator.
+ *
+ * @param source1 first source of data
+ * @param source2 second source of data
+ * @param map way to combine data
+ * @param options options for the combineLatest operator
+ * @returns an observable that emits the result of the map function
+ * @see combineLatestOperator
+ * @see mapOperator
+ * @since 1.0.0
+ */
+declare function combine<T, U, R>(source1: Observable<T>, source2: Observable<U>, map: (c: readonly [T, U]) => R, options?: combineOptions<T, U>): Observable<R>;
+
+/**
+ * This file is part of helpers4.
+ * Copyright (C) 2025 baxyz
+ * SPDX-License-Identifier: LGPL-3.0-or-later
+ */
+
+declare function combineLatest<A extends readonly unknown[]>(sources: readonly [...ObservableInputTuple<A>]): Observable<A>;
+declare function combineLatest<T extends Record<string, ObservableInput<any>>>(sourcesObject: T): Observable<{
+    [K in keyof T]: ObservedValueOf<T[K]>;
+}>;
+
+export { combine, combineLatest };

package/lib/index.js

@@ -0,0 +1,69 @@
+import { combineLatest as combineLatest$1, map, of } from "rxjs";
+//#region helpers/observable/combine.ts
+/**
+* This file is part of helpers4.
+* Copyright (C) 2025 baxyz
+* SPDX-License-Identifier: LGPL-3.0-or-later
+*/
+/**
+* Combine two observables with a map function and an optional pre-treatment.
+*
+* Note: you can use the pre-treatment to add a filter, a distinctUntilChanged,
+* any other operator that can be used in a pipe, or even an `UntilDestroy`
+* operator.
+*
+* @param source1 first source of data
+* @param source2 second source of data
+* @param map way to combine data
+* @param options options for the combineLatest operator
+* @returns an observable that emits the result of the map function
+* @see combineLatestOperator
+* @see mapOperator
+* @since 1.0.0
+*/
+function combine(source1, source2, map$1, options) {
+	if (options?.preTreatment) return combineLatest$1([source1, source2]).pipe(options.preTreatment, map(map$1));
+	else return combineLatest$1([source1, source2]).pipe(map(map$1));
+}
+//#endregion
+//#region helpers/observable/combineLatest.ts
+/**
+* This file is part of helpers4.
+* Copyright (C) 2025 baxyz
+* SPDX-License-Identifier: LGPL-3.0-or-later
+*/
+/**
+* Combines multiple Observables to create an Observable whose values are
+* calculated from the latest values of each of its input Observables.
+*
+* This method relies on {@link combineLatestOperator} of rxjs.
+*
+* The main difference with {@link combineLatestOperator} is in case of empty parameters.
+* If the parameter is empty (empty array or empty object), the result will be
+* also empty.
+*
+* ATTENTION: this version doesn't support `scheduler` nor `mapper` as last
+* argument like in {@link combineLatestOperator}.
+*
+* @see {@link combineLatestOperator}
+* @see {@link combineLatestAll}
+* @see {@link merge}
+* @see {@link withLatestFrom}
+*
+* @param {ObservableInput} [observables] An array of input Observables to combine with each other.
+* An array of Observables must be given as the first argument.
+* @returns {Observable} An Observable of projected values from the most recent
+* values from each input Observable, or an array of the most recent values from
+* each input Observable.
+* @since 1.0.0
+*/
+function combineLatest(input) {
+	if (Array.isArray(input)) {
+		input = input.filter((a) => !!a);
+		return input.length ? combineLatest$1(...input) : of([]);
+	} else return Object.entries(input).filter(([_, v]) => !!v).length ? combineLatest$1(input) : of({});
+}
+//#endregion
+export { combine, combineLatest };
+
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../helpers/observable/combine.ts","../../../helpers/observable/combineLatest.ts"],"sourcesContent":["/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/*\n * This program is under the terms of the GNU Lesser General Public License version 3\n * The full license information can be found in LICENSE in the root directory of this project.\n */\nimport {\n  Observable,\n  OperatorFunction,\n  combineLatest as combineLatestOperator,\n  map as mapOperator,\n} from \"rxjs\";\n\n\ntype combineOptions<T, U> = {\n  readonly preTreatment?: OperatorFunction<readonly [T, U], readonly [T, U]>;\n};\n\n/**\n * Combine two observables with a map function and an optional pre-treatment.\n *\n * Note: you can use the pre-treatment to add a filter, a distinctUntilChanged,\n * any other operator that can be used in a pipe, or even an `UntilDestroy`\n * operator.\n *\n * @param source1 first source of data\n * @param source2 second source of data\n * @param map way to combine data\n * @param options options for the combineLatest operator\n * @returns an observable that emits the result of the map function\n * @see combineLatestOperator\n * @see mapOperator\n * @since 1.0.0\n */\nexport function combine<T, U, R>(\n  source1: Observable<T>,\n  source2: Observable<U>,\n  map: (c: readonly [T, U]) => R,\n  options?: combineOptions<T, U>\n): Observable<R> {\n  if (options?.preTreatment) {\n    return combineLatestOperator([source1, source2]).pipe(\n      options.preTreatment,\n      mapOperator(map)\n    );\n  } else {\n    return combineLatestOperator([source1, source2]).pipe(mapOperator(map));\n  }\n}\n","/**\n * This file is part of helpers4.\n * Copyright (C) 2025 baxyz\n * SPDX-License-Identifier: LGPL-3.0-or-later\n */\n\n/*\n * This program is under the terms of the GNU Lesser General Public License version 3\n * The full license information can be found in LICENSE in the root directory of this project.\n */\nimport {\n  Observable,\n  ObservableInput,\n  ObservableInputTuple,\n  ObservedValueOf,\n  combineLatest as combineLatestOperator,\n  of,\n} from \"rxjs\";\n\n// combineLatest([a, b, c])\nexport function combineLatest<A extends readonly unknown[]>(\n  sources: readonly [...ObservableInputTuple<A>]\n): Observable<A>;\n\n// combineLatest({a, b, c})\nexport function combineLatest<T extends Record<string, ObservableInput<any>>>(\n  sourcesObject: T\n): Observable<{ [K in keyof T]: ObservedValueOf<T[K]> }>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are\n * calculated from the latest values of each of its input Observables.\n *\n * This method relies on {@link combineLatestOperator} of rxjs.\n *\n * The main difference with {@link combineLatestOperator} is in case of empty parameters.\n * If the parameter is empty (empty array or empty object), the result will be\n * also empty.\n *\n * ATTENTION: this version doesn't support `scheduler` nor `mapper` as last\n * argument like in {@link combineLatestOperator}.\n *\n * @see {@link combineLatestOperator}\n * @see {@link combineLatestAll}\n * @see {@link merge}\n * @see {@link withLatestFrom}\n *\n * @param {ObservableInput} [observables] An array of input Observables to combine with each other.\n * An array of Observables must be given as the first argument.\n * @returns {Observable} An Observable of projected values from the most recent\n * values from each input Observable, or an array of the most recent values from\n * each input Observable.\n * @since 1.0.0\n */\nexport function combineLatest(input: any): any {\n  if (Array.isArray(input)) {\n    input = input.filter((a) => !!a);\n    return input.length ? combineLatestOperator(...input) : of([]);\n  } else {\n    return Object.entries(input).filter(([_, v]) => !!v).length\n      ? combineLatestOperator(input)\n      : of({});\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,QACd,SACA,SACA,OACA,SACe;AACf,KAAI,SAAS,aACX,QAAO,gBAAsB,CAAC,SAAS,QAAQ,CAAC,CAAC,KAC/C,QAAQ,cACR,IAAY,MAAI,CACjB;KAED,QAAO,gBAAsB,CAAC,SAAS,QAAQ,CAAC,CAAC,KAAK,IAAY,MAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACI3E,SAAgB,cAAc,OAAiB;AAC7C,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,UAAQ,MAAM,QAAQ,MAAM,CAAC,CAAC,EAAE;AAChC,SAAO,MAAM,SAAS,gBAAsB,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;OAE9D,QAAO,OAAO,QAAQ,MAAM,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,SACjD,gBAAsB,MAAM,GAC5B,GAAG,EAAE,CAAC"}

package/meta/api.json

@@ -0,0 +1,127 @@
+{
+  "category": "observable",
+  "version": "2.0.0-alpha.10",
+  "functions": [
+    {
+      "name": "combine",
+      "kind": "function",
+      "description": "Combine two observables with a map function and an optional pre-treatment.\n\nNote: you can use the pre-treatment to add a filter, a distinctUntilChanged,\nany other operator that can be used in a pipe, or even an `UntilDestroy`\noperator.",
+      "since": "1.0.0",
+      "signatures": [
+        {
+          "signature": "combine<T, U, R>(source1: Observable<T>, source2: Observable<U>, map: function, options?: combineOptions<T, U>): Observable<R>",
+          "description": "Combine two observables with a map function and an optional pre-treatment.\n\nNote: you can use the pre-treatment to add a filter, a distinctUntilChanged,\nany other operator that can be used in a pipe, or even an `UntilDestroy`\noperator.",
+          "params": [
+            {
+              "name": "source1",
+              "type": "Observable<T>",
+              "description": "first source of data"
+            },
+            {
+              "name": "source2",
+              "type": "Observable<U>",
+              "description": "second source of data"
+            },
+            {
+              "name": "map",
+              "type": "function",
+              "description": "way to combine data"
+            },
+            {
+              "name": "options",
+              "type": "combineOptions<T, U>",
+              "description": "options for the combineLatest operator",
+              "optional": true
+            }
+          ],
+          "returns": {
+            "type": "Observable<R>",
+            "description": "an observable that emits the result of the map function"
+          },
+          "typeParameters": [
+            {
+              "name": "T"
+            },
+            {
+              "name": "U"
+            },
+            {
+              "name": "R"
+            }
+          ]
+        }
+      ],
+      "examples": [
+        {
+          "title": "Combine two observables with a map",
+          "description": "Combines the latest values of two observables using a mapping function.",
+          "code": "combine(of(1), of(2), ([a, b]) => a + b)\n// emits 3"
+        }
+      ],
+      "sourceFile": "combine.ts"
+    },
+    {
+      "name": "combineLatest",
+      "kind": "function",
+      "description": "Combines multiple Observables to create an Observable whose values are\ncalculated from the latest values of each of its input Observables.\n\nThis method relies on combineLatestOperator of rxjs.\n\nThe main difference with combineLatestOperator is in case of empty parameters.\nIf the parameter is empty (empty array or empty object), the result will be\nalso empty.\n\nATTENTION: this version doesn't support `scheduler` nor `mapper` as last\nargument like in combineLatestOperator.",
+      "since": "1.0.0",
+      "signatures": [
+        {
+          "signature": "combineLatest<A extends readonly unknown[]>(sources: readonly [ObservableInputTuple<A>]): Observable<A>",
+          "description": "",
+          "params": [
+            {
+              "name": "sources",
+              "type": "readonly [ObservableInputTuple<A>]",
+              "description": ""
+            }
+          ],
+          "returns": {
+            "type": "Observable<A>",
+            "description": ""
+          },
+          "typeParameters": [
+            {
+              "name": "A",
+              "constraint": "readonly unknown[]"
+            }
+          ]
+        },
+        {
+          "signature": "combineLatest<T extends Record<string, ObservableInput<any>>>(sourcesObject: T): Observable<mapped>",
+          "description": "",
+          "params": [
+            {
+              "name": "sourcesObject",
+              "type": "T",
+              "description": ""
+            }
+          ],
+          "returns": {
+            "type": "Observable<mapped>",
+            "description": ""
+          },
+          "typeParameters": [
+            {
+              "name": "T",
+              "constraint": "Record<string, ObservableInput<any>>"
+            }
+          ]
+        }
+      ],
+      "examples": [
+        {
+          "title": "Combine array of observables",
+          "description": "Combines an array of observables into one that emits arrays of their latest values.",
+          "code": "combineLatest([of(1), of(2), of(3)])\n// emits [1, 2, 3]"
+        },
+        {
+          "title": "Handle empty array",
+          "description": "Returns an observable that emits an empty array when given no sources.",
+          "code": "combineLatest([])\n// emits []"
+        }
+      ],
+      "sourceFile": "combineLatest.ts"
+    }
+  ]
+}

package/meta/examples.json

@@ -0,0 +1,30 @@
+{
+  "category": "observable",
+  "functions": [
+    {
+      "name": "combine",
+      "examples": [
+        {
+          "title": "Combine two observables with a map",
+          "description": "Combines the latest values of two observables using a mapping function.",
+          "code": "combine(of(1), of(2), ([a, b]) => a + b)\n// emits 3"
+        }
+      ]
+    },
+    {
+      "name": "combineLatest",
+      "examples": [
+        {
+          "title": "Combine array of observables",
+          "description": "Combines an array of observables into one that emits arrays of their latest values.",
+          "code": "combineLatest([of(1), of(2), of(3)])\n// emits [1, 2, 3]"
+        },
+        {
+          "title": "Handle empty array",
+          "description": "Returns an observable that emits an empty array when given no sources.",
+          "code": "combineLatest([])\n// emits []"
+        }
+      ]
+    }
+  ]
+}

package/meta/licenses.json

@@ -0,0 +1,11 @@
+{
+  "category": "observable",
+  "dependencies": [
+    {
+      "name": "rxjs",
+      "license": "Apache-2.0",
+      "homepage": "https://rxjs.dev",
+      "repository": "https://github.com/reactivex/rxjs"
+    }
+  ]
+}

package/package.json

@@ -1,113 +1,47 @@
 {
   "name": "@helpers4/observable",
-  "version": "1.0.1",
-  "description": "A set of helpers in TS/JS, compatible with tree-shaking, which helps you to manipulate observables.",
-  "main": "build/main/index.js",
-  "typings": "build/main/index.d.ts",
-  "module": "build/module/index.js",
-  "repository": "https://github.com/helpers4/observable",
-  "license": "AGPL-3.0",
+  "version": "2.0.0-alpha.10",
+  "description": "A set of helpers in TS/JS, compatible with tree-shaking, for observable.",
+  "author": "baxyz <baxy@etik.com>",
+  "license": "LGPL-3.0",
+  "homepage": "https://helpers4.dev/typescript/categories/observable/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/helpers4/typescript.git"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    },
+    "./meta/api.json": "./meta/api.json",
+    "./meta/examples.json": "./meta/examples.json",
+    "./meta/licenses.json": "./meta/licenses.json",
+    "./package.json": "./package.json"
+  },
   "keywords": [
-    "helper",
-    "string",
+    "helpers",
     "observable",
-    "typescript",
-    "tree-shaking",
-    "combine"
+    "combine",
+    "combineLatest"
   ],
-  "scripts": {
-    "build": "run-p build:*",
-    "build:main": "tsc -p tsconfig.json",
-    "build:module": "tsc -p tsconfig.module.json",
-    "fix": "run-s fix:*",
-    "fix:prettier": "prettier \"src/**/*.ts\" --write",
-    "fix:lint": "eslint src --ext .ts --fix",
-    "test": "run-s build test:*",
-    "test:lint": "eslint src --ext .ts",
-    "test:prettier": "prettier \"src/**/*.ts\" --list-different",
-    "test:spelling": "cspell \"{README.md,.github/*.md,src/**/*.ts}\"",
-    "test:unit": "nyc --silent ava",
-    "check-cli": "run-s test diff-integration-tests check-integration-tests",
-    "check-integration-tests": "run-s check-integration-test:*",
-    "diff-integration-tests": "mkdir -p diff && rm -rf diff/test && cp -r test diff/test && rm -rf diff/test/test-*/.git && cd diff && git init --quiet && git add -A && git commit --quiet --no-verify --allow-empty -m 'WIP' && echo '\\n\\nCommitted most recent integration test output in the \"diff\" directory. Review the changes with \"cd diff && git diff HEAD\" or your preferred git diff viewer.'",
-    "watch:build": "tsc -p tsconfig.json -w",
-    "watch:test": "nyc --silent ava --watch",
-    "cov": "run-s build test:unit cov:html cov:lcov && open-cli coverage/index.html",
-    "cov:html": "nyc report --reporter=html",
-    "cov:lcov": "nyc report --reporter=lcov",
-    "cov:send": "run-s cov:lcov && codecov",
-    "cov:check": "nyc report && nyc check-coverage --lines 100 --functions 100 --branches 100",
-    "doc": "run-s doc:html && open-cli build/docs/index.html",
-    "doc:html": "typedoc src/index.ts --out build/docs",
-    "doc:json": "typedoc src/index.ts --json build/docs/typedoc.json --pretty",
-    "doc:publish": "gh-pages -m \"[ci skip] Updates\" -d build/docs",
-    "version": "standard-version",
-    "reset-hard": "git clean -dfx && git reset --hard && npm i",
-    "prepare-release": "run-s reset-hard test cov:check doc:html version doc:publish"
-  },
-  "engines": {
-    "node": ">=10"
-  },
-  "devDependencies": {
-    "@ava/typescript": "^1.1.1",
-    "@istanbuljs/nyc-config-typescript": "^1.0.1",
-    "@typescript-eslint/eslint-plugin": "^4.0.1",
-    "@typescript-eslint/parser": "^4.0.1",
-    "ava": "^4.3.3",
-    "codecov": "^3.5.0",
-    "cspell": "^4.1.0",
-    "cz-conventional-changelog": "^3.3.0",
-    "eslint": "^7.8.0",
-    "eslint-config-prettier": "^6.11.0",
-    "eslint-plugin-eslint-comments": "^3.2.0",
-    "eslint-plugin-functional": "^3.0.2",
-    "eslint-plugin-import": "^2.22.0",
-    "gh-pages": "^3.1.0",
-    "npm-run-all": "^4.1.5",
-    "nyc": "^15.1.0",
-    "open-cli": "^7.0.1",
-    "prettier": "^2.1.1",
-    "standard-version": "^9.0.0",
-    "ts-node": "^9.0.0",
-    "typedoc": "^0.23.13",
-    "typescript": "^4.0.2"
-  },
   "files": [
-    "build/main",
-    "build/module",
-    "!**/*.spec.*",
-    "!**/*.json",
-    "CHANGELOG.md",
+    "lib/index.js",
+    "lib/index.d.ts",
+    "lib/index.js.map",
+    "meta/",
     "LICENSE.md",
+    "package.json",
     "README.md"
   ],
-  "ava": {
-    "failFast": true,
-    "timeout": "60s",
-    "typescript": {
-      "rewritePaths": {
-        "src/": "build/main/"
-      }
-    },
-    "files": [
-      "!build/module/**"
-    ]
-  },
-  "config": {
-    "commitizen": {
-      "path": "cz-conventional-changelog"
-    }
-  },
-  "prettier": {
-    "singleQuote": true
-  },
-  "nyc": {
-    "extends": "@istanbuljs/nyc-config-typescript",
-    "exclude": [
-      "**/*.spec.js"
-    ]
+  "engines": {
+    "node": ">=18.0.0"
   },
-  "dependencies": {
-    "rxjs": ">=7"
+  "peerDependencies": {
+    "rxjs": "^7.8.2"
   }
-}
+}

package/CHANGELOG.md

@@ -1,11 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
-
-## 1.0.1 (2022-09-04)
-
-### Features
-
-- :sparkles: first commit ([e711632](https://github.com/helpers4/observable/commit/e711632fbddada8e49ba9bbf589ff698d7c04570))
-
-### 1.0.0 (2022-09-03)

package/build/main/helper/observable.d.ts

@@ -1,21 +0,0 @@
-import { Observable, OperatorFunction } from 'rxjs';
-declare type combineOptions<T, U> = {
-    readonly preTreatment?: OperatorFunction<readonly [T, U], readonly [T, U]>;
-};
-/**
- * Combine two observables with a map function and an optional pre-treatment.
- *
- * Note: you can use the pre-treatment to add a filter, a distinctUntilChanged,
- * any other operator that can be used in a pipe, or even an `UntilDestroy`
- * operator.
- *
- * @param source1 first source of data
- * @param source2 second source of data
- * @param map way to combine data
- * @param options options for the combineLatest operator
- * @returns an observable that emits the result of the map function
- * @see combineLatest
- * @see mapOperator
- */
-export declare function combine<T, U, R>(source1: Observable<T>, source2: Observable<U>, map: (c: readonly [T, U]) => R, options?: combineOptions<T, U>): Observable<R>;
-export {};

package/build/main/helper/observable.js

@@ -1,33 +0,0 @@
-"use strict";
-/*
- * This program is under the terms of the GNU Affero General Public License version 3
- * The full license information can be found in LICENSE in the root directory of this project.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.combine = void 0;
-const rxjs_1 = require("rxjs");
-/**
- * Combine two observables with a map function and an optional pre-treatment.
- *
- * Note: you can use the pre-treatment to add a filter, a distinctUntilChanged,
- * any other operator that can be used in a pipe, or even an `UntilDestroy`
- * operator.
- *
- * @param source1 first source of data
- * @param source2 second source of data
- * @param map way to combine data
- * @param options options for the combineLatest operator
- * @returns an observable that emits the result of the map function
- * @see combineLatest
- * @see mapOperator
- */
-function combine(source1, source2, map, options) {
-    if (options === null || options === void 0 ? void 0 : options.preTreatment) {
-        return (0, rxjs_1.combineLatest)([source1, source2]).pipe(options.preTreatment, (0, rxjs_1.map)(map));
-    }
-    else {
-        return (0, rxjs_1.combineLatest)([source1, source2]).pipe((0, rxjs_1.map)(map));
-    }
-}
-exports.combine = combine;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib2JzZXJ2YWJsZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9oZWxwZXIvb2JzZXJ2YWJsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7OztHQUdHOzs7QUFFSCwrQkFLYztBQU1kOzs7Ozs7Ozs7Ozs7OztHQWNHO0FBQ0gsU0FBZ0IsT0FBTyxDQUNyQixPQUFzQixFQUN0QixPQUFzQixFQUN0QixHQUE4QixFQUM5QixPQUE4QjtJQUU5QixJQUFJLE9BQU8sYUFBUCxPQUFPLHVCQUFQLE9BQU8sQ0FBRSxZQUFZLEVBQUU7UUFDekIsT0FBTyxJQUFBLG9CQUFhLEVBQUMsQ0FBQyxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQzNDLE9BQU8sQ0FBQyxZQUFZLEVBQ3BCLElBQUEsVUFBVyxFQUFDLEdBQUcsQ0FBQyxDQUNqQixDQUFDO0tBQ0g7U0FBTTtRQUNMLE9BQU8sSUFBQSxvQkFBYSxFQUFDLENBQUMsT0FBTyxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLElBQUEsVUFBVyxFQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUM7S0FDakU7QUFDSCxDQUFDO0FBZEQsMEJBY0MifQ==

package/build/main/helper/observable.spec.d.ts

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

package/build/main/helper/observable.spec.js

@@ -1,23 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/*
- * This program is under the terms of the GNU Affero General Public License version 3
- * The full license information can be found in LICENSE in the root directory of this project.
- */
-const ava_1 = __importDefault(require("ava"));
-const rxjs_1 = require("rxjs");
-const observable_1 = require("./observable");
-(0, ava_1.default)('combine', async (t) => {
-    const result = await (0, rxjs_1.firstValueFrom)((0, observable_1.combine)((0, rxjs_1.of)(1), (0, rxjs_1.of)(2), (c) => c[0] + c[1]));
-    return t.is(result, 3);
-});
-(0, ava_1.default)('combine with pretreatment', async (t) => {
-    const result = await (0, rxjs_1.firstValueFrom)((0, observable_1.combine)((0, rxjs_1.of)(1), (0, rxjs_1.of)(2), (c) => c[0] + c[1], {
-        preTreatment: (0, rxjs_1.map)((c) => [c[0], c[1] + 1]),
-    }));
-    return t.is(result, 4);
-});
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib2JzZXJ2YWJsZS5zcGVjLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2hlbHBlci9vYnNlcnZhYmxlLnNwZWMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFBQTs7O0dBR0c7QUFDSCw4Q0FBdUI7QUFDdkIsK0JBQStDO0FBRS9DLDZDQUF1QztBQUV2QyxJQUFBLGFBQUksRUFBQyxTQUFTLEVBQUUsS0FBSyxFQUFFLENBQUMsRUFBRSxFQUFFO0lBQzFCLE1BQU0sTUFBTSxHQUFHLE1BQU0sSUFBQSxxQkFBYyxFQUNqQyxJQUFBLG9CQUFPLEVBQUMsSUFBQSxTQUFFLEVBQUMsQ0FBQyxDQUFDLEVBQUUsSUFBQSxTQUFFLEVBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FDMUMsQ0FBQztJQUNGLE9BQU8sQ0FBQyxDQUFDLEVBQUUsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUM7QUFDekIsQ0FBQyxDQUFDLENBQUM7QUFFSCxJQUFBLGFBQUksRUFBQywyQkFBMkIsRUFBRSxLQUFLLEVBQUUsQ0FBQyxFQUFFLEVBQUU7SUFDNUMsTUFBTSxNQUFNLEdBQUcsTUFBTSxJQUFBLHFCQUFjLEVBQ2pDLElBQUEsb0JBQU8sRUFBQyxJQUFBLFNBQUUsRUFBQyxDQUFDLENBQUMsRUFBRSxJQUFBLFNBQUUsRUFBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRTtRQUN4QyxZQUFZLEVBQUUsSUFBQSxVQUFHLEVBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQztLQUMzQyxDQUFDLENBQ0gsQ0FBQztJQUNGLE9BQU8sQ0FBQyxDQUFDLEVBQUUsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUM7QUFDekIsQ0FBQyxDQUFDLENBQUMifQ==

package/build/main/index.d.ts

@@ -1 +0,0 @@
-export * from './helper/observable';

package/build/main/index.js

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./helper/observable"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLHNEQUFvQyJ9

package/build/module/helper/observable.d.ts

@@ -1,21 +0,0 @@
-import { Observable, OperatorFunction } from 'rxjs';
-declare type combineOptions<T, U> = {
-    readonly preTreatment?: OperatorFunction<readonly [T, U], readonly [T, U]>;
-};
-/**
- * Combine two observables with a map function and an optional pre-treatment.
- *
- * Note: you can use the pre-treatment to add a filter, a distinctUntilChanged,
- * any other operator that can be used in a pipe, or even an `UntilDestroy`
- * operator.
- *
- * @param source1 first source of data
- * @param source2 second source of data
- * @param map way to combine data
- * @param options options for the combineLatest operator
- * @returns an observable that emits the result of the map function
- * @see combineLatest
- * @see mapOperator
- */
-export declare function combine<T, U, R>(source1: Observable<T>, source2: Observable<U>, map: (c: readonly [T, U]) => R, options?: combineOptions<T, U>): Observable<R>;
-export {};