@dereekb/rxjs 13.6.17 → 13.7.0

package/index.cjs.js

@@ -42,6 +42,7 @@ function _class_call_check$9(instance, Constructor) {
  * ```
  *
  * @param path - Relative path from the environment's base asset directory.
+ * @returns A local asset reference with the given path.
  */ function localAsset(path) {
     return {
         sourceType: 'local',
@@ -61,6 +62,7 @@ function _class_call_check$9(instance, Constructor) {
  * ```
  *
  * @param url - Absolute URL with http/https prefix to fetch the asset from.
+ * @returns A remote asset reference with the given URL.
  * @throws Error if the URL does not have a valid http/https prefix.
  */ function remoteAsset(url) {
     if (!util.isWebsiteUrlWithPrefix(url)) {
@@ -90,6 +92,7 @@ function _class_call_check$9(instance, Constructor) {
  * ```
  *
  * @param folder - Base folder path for the assets.
+ * @returns A fluent builder for creating local asset refs within the specified folder.
  */ function assetFolder(folder) {
     var normalizedFolder = folder.endsWith('/') ? folder : folder + '/';
     var builder = {
@@ -126,6 +129,7 @@ function _class_call_check$9(instance, Constructor) {
  * ```
  *
  * @param baseUrl - Base URL with http/https prefix.
+ * @returns A fluent builder for creating remote asset refs under the specified base URL.
  * @throws Error if the base URL does not have a valid http/https prefix.
  */ function remoteAssetBaseUrl(baseUrl) {
     if (!util.isWebsiteUrlWithPrefix(baseUrl)) {
@@ -162,6 +166,7 @@ function _class_call_check$9(instance, Constructor) {
  *
  * @param ref - The asset path reference this instance represents.
  * @param getFn - Promise-based function that loads the asset bytes.
+ * @returns An {@link AssetLoaderAssetInstance} with a cold observable that invokes getFn on each subscription.
  */ function assetLoaderAssetInstance(ref, getFn) {
     return {
         ref: function ref1() {
@@ -189,6 +194,7 @@ function _class_call_check$9(instance, Constructor) {
  * ```
  *
  * @param getFn - Promise-based function that loads any asset's bytes.
+ * @returns An {@link AssetLoader} that creates instances using the provided get function.
  */ function assetLoaderFromGetFn(getFn) {
     var loader = {
         get: function get(ref) {
@@ -217,6 +223,7 @@ function _class_call_check$9(instance, Constructor) {
  * ```
  *
  * @param config - Specifies the local and remote delegate loaders.
+ * @returns An {@link AssetLoader} that routes requests to the appropriate delegate based on source type.
  */ function delegatedAssetLoader(config) {
     var local = config.local, remote = config.remote;
     var loader = {
@@ -374,6 +381,7 @@ function _ts_generator$3(thisArg, body) {
  * ```
  *
  * @param config - Optional fetch configuration with custom fetch function.
+ * @returns An {@link AssetLoader} that loads remote assets via HTTP fetch.
  */ function fetchAssetLoader() {
     var config = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
     var _config_fetch;
@@ -552,6 +560,7 @@ function _ts_generator$2(thisArg, body) {
  * ```
  *
  * @param assets - Map of asset refs to their raw byte data.
+ * @returns An {@link AssetLoader} backed by the provided in-memory map.
  */ function memoryAssetLoader(assets) {
     var getFn = function getFn(ref) {
         return _async_to_generator$2(function() {
@@ -5797,9 +5806,17 @@ function _unsupported_iterable_to_array(o, minLen) {
                 var state;
                 if (inputState != null) {
                     var end = inputState.value != null ? isItemPageIteratorResultEndResult(inputState.value) : undefined;
-                    state = _object_spread_props$1(_object_spread$1({}, inputState), {
-                        hasNextPage: util.invertMaybeBoolean(end)
-                    });
+                    var hasNextPage = util.invertMaybeBoolean(end);
+                    // Reuse the same reference when hasNextPage hasn't changed to avoid
+                    // tricking downstream distinctUntilChanged/scan into treating a
+                    // re-emitted result as a new page (which causes duplicate accumulation).
+                    if (inputState.hasNextPage === hasNextPage) {
+                        state = inputState;
+                    } else {
+                        state = _object_spread_props$1(_object_spread$1({}, inputState), {
+                            hasNextPage: hasNextPage
+                        });
+                    }
                 }
                 return {
                     n: request.n,

package/index.esm.js

@@ -40,6 +40,7 @@ function _class_call_check$9(instance, Constructor) {
  * ```
  *
  * @param path - Relative path from the environment's base asset directory.
+ * @returns A local asset reference with the given path.
  */ function localAsset(path) {
     return {
         sourceType: 'local',
@@ -59,6 +60,7 @@ function _class_call_check$9(instance, Constructor) {
  * ```
  *
  * @param url - Absolute URL with http/https prefix to fetch the asset from.
+ * @returns A remote asset reference with the given URL.
  * @throws Error if the URL does not have a valid http/https prefix.
  */ function remoteAsset(url) {
     if (!isWebsiteUrlWithPrefix(url)) {
@@ -88,6 +90,7 @@ function _class_call_check$9(instance, Constructor) {
  * ```
  *
  * @param folder - Base folder path for the assets.
+ * @returns A fluent builder for creating local asset refs within the specified folder.
  */ function assetFolder(folder) {
     var normalizedFolder = folder.endsWith('/') ? folder : folder + '/';
     var builder = {
@@ -124,6 +127,7 @@ function _class_call_check$9(instance, Constructor) {
  * ```
  *
  * @param baseUrl - Base URL with http/https prefix.
+ * @returns A fluent builder for creating remote asset refs under the specified base URL.
  * @throws Error if the base URL does not have a valid http/https prefix.
  */ function remoteAssetBaseUrl(baseUrl) {
     if (!isWebsiteUrlWithPrefix(baseUrl)) {
@@ -160,6 +164,7 @@ function _class_call_check$9(instance, Constructor) {
  *
  * @param ref - The asset path reference this instance represents.
  * @param getFn - Promise-based function that loads the asset bytes.
+ * @returns An {@link AssetLoaderAssetInstance} with a cold observable that invokes getFn on each subscription.
  */ function assetLoaderAssetInstance(ref, getFn) {
     return {
         ref: function ref1() {
@@ -187,6 +192,7 @@ function _class_call_check$9(instance, Constructor) {
  * ```
  *
  * @param getFn - Promise-based function that loads any asset's bytes.
+ * @returns An {@link AssetLoader} that creates instances using the provided get function.
  */ function assetLoaderFromGetFn(getFn) {
     var loader = {
         get: function get(ref) {
@@ -215,6 +221,7 @@ function _class_call_check$9(instance, Constructor) {
  * ```
  *
  * @param config - Specifies the local and remote delegate loaders.
+ * @returns An {@link AssetLoader} that routes requests to the appropriate delegate based on source type.
  */ function delegatedAssetLoader(config) {
     var local = config.local, remote = config.remote;
     var loader = {
@@ -372,6 +379,7 @@ function _ts_generator$3(thisArg, body) {
  * ```
  *
  * @param config - Optional fetch configuration with custom fetch function.
+ * @returns An {@link AssetLoader} that loads remote assets via HTTP fetch.
  */ function fetchAssetLoader() {
     var config = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
     var _config_fetch;
@@ -550,6 +558,7 @@ function _ts_generator$2(thisArg, body) {
  * ```
  *
  * @param assets - Map of asset refs to their raw byte data.
+ * @returns An {@link AssetLoader} backed by the provided in-memory map.
  */ function memoryAssetLoader(assets) {
     var getFn = function getFn(ref) {
         return _async_to_generator$2(function() {
@@ -5795,9 +5804,17 @@ function _unsupported_iterable_to_array(o, minLen) {
                 var state;
                 if (inputState != null) {
                     var end = inputState.value != null ? isItemPageIteratorResultEndResult(inputState.value) : undefined;
-                    state = _object_spread_props$1(_object_spread$1({}, inputState), {
-                        hasNextPage: invertMaybeBoolean(end)
-                    });
+                    var hasNextPage = invertMaybeBoolean(end);
+                    // Reuse the same reference when hasNextPage hasn't changed to avoid
+                    // tricking downstream distinctUntilChanged/scan into treating a
+                    // re-emitted result as a new page (which causes duplicate accumulation).
+                    if (inputState.hasNextPage === hasNextPage) {
+                        state = inputState;
+                    } else {
+                        state = _object_spread_props$1(_object_spread$1({}, inputState), {
+                            hasNextPage: hasNextPage
+                        });
+                    }
                 }
                 return {
                     n: request.n,

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@dereekb/rxjs",
-  "version": "13.6.17",
+  "version": "13.7.0",
   "peerDependencies": {
     "rxjs": "^7.8.0",
-    "@dereekb/util": "13.6.17"
+    "@dereekb/util": "13.7.0"
   },
   "exports": {
     "./package.json": "./package.json",

package/src/lib/asset/asset.builder.d.ts

@@ -10,6 +10,7 @@ import { type AssetLocalPathRef, type AssetRemotePathRef } from './asset';
  * ```
  *
  * @param path - Relative path from the environment's base asset directory.
+ * @returns A local asset reference with the given path.
  */
 export declare function localAsset(path: SlashPath): AssetLocalPathRef;
 /**
@@ -25,6 +26,7 @@ export declare function localAsset(path: SlashPath): AssetLocalPathRef;
  * ```
  *
  * @param url - Absolute URL with http/https prefix to fetch the asset from.
+ * @returns A remote asset reference with the given URL.
  * @throws Error if the URL does not have a valid http/https prefix.
  */
 export declare function remoteAsset(url: WebsiteUrlWithPrefix): AssetRemotePathRef;
@@ -65,6 +67,7 @@ export interface AssetFolderBuilder {
  * ```
  *
  * @param folder - Base folder path for the assets.
+ * @returns A fluent builder for creating local asset refs within the specified folder.
  */
 export declare function assetFolder(folder: SlashPath): AssetFolderBuilder;
 /**
@@ -107,6 +110,7 @@ export interface RemoteAssetBuilder {
  * ```
  *
  * @param baseUrl - Base URL with http/https prefix.
+ * @returns A fluent builder for creating remote asset refs under the specified base URL.
  * @throws Error if the base URL does not have a valid http/https prefix.
  */
 export declare function remoteAssetBaseUrl(baseUrl: WebsiteUrlWithPrefix): RemoteAssetBuilder;

package/src/lib/asset/asset.loader.d.ts

@@ -13,6 +13,7 @@ import { type AssetPathRef, type AssetLoaderAssetInstance, type AssetLoaderGetFn
  *
  * @param ref - The asset path reference this instance represents.
  * @param getFn - Promise-based function that loads the asset bytes.
+ * @returns An {@link AssetLoaderAssetInstance} with a cold observable that invokes getFn on each subscription.
  */
 export declare function assetLoaderAssetInstance(ref: AssetPathRef, getFn: AssetLoaderGetFn): AssetLoaderAssetInstance;
 /**
@@ -30,5 +31,6 @@ export declare function assetLoaderAssetInstance(ref: AssetPathRef, getFn: Asset
  * ```
  *
  * @param getFn - Promise-based function that loads any asset's bytes.
+ * @returns An {@link AssetLoader} that creates instances using the provided get function.
  */
 export declare function assetLoaderFromGetFn(getFn: AssetLoaderGetFn): AssetLoader;

package/src/lib/asset/asset.loader.delegated.d.ts

@@ -32,5 +32,6 @@ export interface DelegatedAssetLoaderConfig {
  * ```
  *
  * @param config - Specifies the local and remote delegate loaders.
+ * @returns An {@link AssetLoader} that routes requests to the appropriate delegate based on source type.
  */
 export declare function delegatedAssetLoader(config: DelegatedAssetLoaderConfig): AssetLoader;

package/src/lib/asset/asset.loader.fetch.d.ts

@@ -29,5 +29,6 @@ export interface FetchAssetLoaderConfig {
  * ```
  *
  * @param config - Optional fetch configuration with custom fetch function.
+ * @returns An {@link AssetLoader} that loads remote assets via HTTP fetch.
  */
 export declare function fetchAssetLoader(config?: FetchAssetLoaderConfig): AssetLoader;

package/src/lib/asset/asset.loader.memory.d.ts

@@ -17,5 +17,6 @@ import { type AssetPathRef, type AssetLoader } from './asset';
  * ```
  *
  * @param assets - Map of asset refs to their raw byte data.
+ * @returns An {@link AssetLoader} backed by the provided in-memory map.
  */
 export declare function memoryAssetLoader(assets: Map<AssetPathRef, ArrayBuffer>): AssetLoader;