@ng-doc/builder 17.6.16 → 18.0.0-beta.2

package/engine/cache/helpers/is-cache-valid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-cache-valid.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/cache/helpers/is-cache-valid.ts"],"names":[],"mappings":";;AASA,oCAWC;AAnBD,mEAA6D;AAC7D,6CAAyC;AAEzC;;;;GAIG;AACH,SAAgB,YAAY,CAAC,EAAU,EAAE,KAAsB;IAC7D,MAAM,UAAU,GAAoB,IAAA,sBAAS,EAAC,EAAE,CAAC,CAAC;IAClD,MAAM,aAAa,GAAY,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CACtE,CAAC,QAAgB,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,KAAK,IAAA,0CAAkB,EAAC,QAAQ,CAAC,CACpF,CAAC;IACF,MAAM,cAAc,GAAY,UAAU,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC;IACrE,MAAM,kBAAkB,GAAY,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CACtE,CAAC,QAAgB,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,KAAK,SAAS,CACjE,CAAC;IAEF,OAAO,aAAa,IAAI,cAAc,IAAI,kBAAkB,CAAC;AAC/D,CAAC"}

package/engine/{entities/cache → cache}/helpers/load-cache.d.ts

@@ -3,4 +3,4 @@ import { NgDocCachedData } from '../interfaces';
  * Loads cache for given id
  * @param id
  */
-export declare function loadCache(id: string): NgDocCachedData;
+export declare function loadCache<TData>(id: string): NgDocCachedData<TData>;

package/engine/cache/helpers/load-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-cache.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/cache/helpers/load-cache.ts"],"names":[],"mappings":";;AASA,8BASC;;AAlBD,+CAAyB;AAGzB,+DAAyD;AAEzD;;;GAGG;AACH,SAAgB,SAAS,CAAQ,EAAU;IACzC,IAAI,CAAC;QACH,MAAM,aAAa,GAAW,IAAA,sCAAgB,EAAC,EAAE,CAAC,CAAC;QACnD,MAAM,YAAY,GAAW,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAErE,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/engine/{entities/cache → cache}/helpers/update-cache.d.ts

@@ -5,4 +5,4 @@ import { NgDocCachedData } from '../interfaces';
  * @param id - unique id for cache
  * @param cache - cache object
  */
-export declare function updateCache(id: string, cache: NgDocCachedData): void;
+export declare function updateCache<TData>(id: string, cache: NgDocCachedData<TData>): void;

package/engine/cache/helpers/update-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-cache.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/cache/helpers/update-cache.ts"],"names":[],"mappings":";;AAYA,kCASC;;AArBD,+CAAyB;AACzB,mDAA6B;AAG7B,+DAAyD;AAEzD;;;;;GAKG;AACH,SAAgB,WAAW,CAAQ,EAAU,EAAE,KAA6B;IAC1E,MAAM,aAAa,GAAW,IAAA,sCAAgB,EAAC,EAAE,CAAC,CAAC;IACnD,MAAM,YAAY,GAAW,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/engine/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/builder/engine/cache/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,uDAA6B;AAC7B,oDAA0B;AAC1B,uDAA6B"}

package/engine/cache/interfaces/cache-accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-accessor.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/cache/interfaces/cache-accessor.ts"],"names":[],"mappings":""}

package/engine/cache/interfaces/cached-data.d.ts

@@ -0,0 +1,6 @@
+export interface NgDocCachedData<TData = unknown> {
+    version?: string;
+    files?: Record<string, string>;
+    result?: string;
+    data?: TData;
+}

package/engine/cache/interfaces/cached-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-data.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/cache/interfaces/cached-data.ts"],"names":[],"mappings":""}

package/engine/cache/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/cache/interfaces/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,wDAA8B"}

package/engine/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from './operators';
+export * from './stores';
+export * from './triggers';
+export * from './types';
+export * from './variables';
+export * from './watcher';

package/engine/core/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./operators"), exports);
+tslib_1.__exportStar(require("./stores"), exports);
+tslib_1.__exportStar(require("./triggers"), exports);
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./variables"), exports);
+tslib_1.__exportStar(require("./watcher"), exports);
+//# sourceMappingURL=index.js.map

package/engine/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/builder/engine/core/index.ts"],"names":[],"mappings":";;;AAAA,sDAA4B;AAC5B,mDAAyB;AACzB,qDAA2B;AAC3B,kDAAwB;AACxB,sDAA4B;AAC5B,oDAA0B"}

package/engine/core/operators/builder-state.d.ts

@@ -0,0 +1,13 @@
+import { OperatorFunction } from 'rxjs';
+import { BuilderState } from '../types';
+/**
+ * Operator function that transforms a source Observable into an Observable of BuilderState.
+ * It emits a BuilderPending state at the start, then a BuilderDone state when the source emits,
+ * and a BuilderError state if the source errors out.
+ * It also manages a global stack of pending builders.
+ * @param stage
+ * @param tag
+ * @template T The type of the source Observable.
+ * @returns {OperatorFunction<T, BuilderState<T>>} An OperatorFunction that can be used with pipe.
+ */
+export declare function builderState<T>(tag: string): OperatorFunction<T, BuilderState<T>>;

package/engine/core/operators/builder-state.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.builderState = builderState;
+const rxjs_1 = require("rxjs");
+const types_1 = require("../types");
+const stack_1 = require("./stack");
+/**
+ * Operator function that transforms a source Observable into an Observable of BuilderState.
+ * It emits a BuilderPending state at the start, then a BuilderDone state when the source emits,
+ * and a BuilderError state if the source errors out.
+ * It also manages a global stack of pending builders.
+ * @param stage
+ * @param tag
+ * @template T The type of the source Observable.
+ * @returns {OperatorFunction<T, BuilderState<T>>} An OperatorFunction that can be used with pipe.
+ */
+function builderState(tag) {
+    return (source) => source.pipe((0, rxjs_1.map)((result) => new types_1.BuilderDone(tag, result)), (0, rxjs_1.startWith)(new types_1.BuilderPending(tag)), (0, rxjs_1.catchError)((error) => (0, rxjs_1.of)(new types_1.BuilderError(tag, [error]))), (0, stack_1.addToStack)(tag));
+}
+//# sourceMappingURL=builder-state.js.map

package/engine/core/operators/builder-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-state.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/builder-state.ts"],"names":[],"mappings":";;AAeA,oCAQC;AAvBD,+BAAwE;AAExE,oCAAmF;AACnF,mCAAqC;AAErC;;;;;;;;;GASG;AACH,SAAgB,YAAY,CAAI,GAAW;IACzC,OAAO,CAAC,MAAM,EAAE,EAAE,CAChB,MAAM,CAAC,IAAI,CACT,IAAA,UAAG,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,mBAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAC7C,IAAA,gBAAS,EAAC,IAAI,sBAAc,CAAC,GAAG,CAAC,CAAC,EAClC,IAAA,iBAAU,EAAC,CAAC,KAAY,EAAE,EAAE,CAAC,IAAA,SAAE,EAAC,IAAI,oBAAY,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAChE,IAAA,kBAAU,EAAC,GAAG,CAAC,CAChB,CAAC;AACN,CAAC"}

package/engine/core/operators/create-builder.d.ts

@@ -0,0 +1,10 @@
+import { Builder, Trigger } from '../types';
+/**
+ *
+ * @param triggers
+ * @param project
+ * @param main
+ * @param secondary
+ * @param autoStart
+ */
+export declare function createBuilder<T>(triggers: Trigger[], project: () => Builder<T>, autoStart?: boolean): Builder<T>;

package/engine/core/operators/create-builder.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBuilder = createBuilder;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const types_1 = require("../types");
+let builderId = 0;
+const blockedBuilders = new Set();
+/**
+ *
+ * @param triggers
+ * @param project
+ * @param main
+ * @param secondary
+ * @param autoStart
+ */
+function createBuilder(triggers, project, autoStart = true) {
+    const id = builderId++;
+    const main = triggers.filter(types_1.isMainTrigger).map(({ trigger }) => trigger);
+    const secondary = triggers.filter(types_1.isSecondaryTrigger).map(({ trigger }) => trigger);
+    const mainTrigger = (main ? (0, rxjs_1.merge)(...main) : rxjs_1.EMPTY).pipe((0, operators_1.tap)(() => blockedBuilders.clear()));
+    const secondaryTrigger = (secondary ? (0, rxjs_1.merge)(...secondary) : rxjs_1.EMPTY).pipe((0, operators_1.filter)(() => !blockedBuilders.has(id)));
+    return (0, rxjs_1.merge)(mainTrigger, secondaryTrigger).pipe((0, rxjs_1.subscribeOn)(rxjs_1.asyncScheduler), autoStart ? (0, operators_1.startWith)(void 0) : (0, operators_1.tap)(), (0, operators_1.map)(() => id), (0, operators_1.switchMap)(() => {
+        blockedBuilders.add(id);
+        return project().pipe((0, operators_1.tap)((state) => {
+            if ((0, types_1.isBuilderDone)(state) && state.fromCache) {
+                blockedBuilders.delete(id);
+            }
+        }));
+    }));
+}
+//# sourceMappingURL=create-builder.js.map

package/engine/core/operators/create-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-builder.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/create-builder.ts"],"names":[],"mappings":";;AAgBA,sCA8BC;AA9CD,+BAAiE;AACjE,8CAAwE;AAExE,oCAA8F;AAE9F,IAAI,SAAS,GAAW,CAAC,CAAC;AAC1B,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;AAE1C;;;;;;;GAOG;AACH,SAAgB,aAAa,CAC3B,QAAmB,EACnB,OAAyB,EACzB,YAAqB,IAAI;IAEzB,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,qBAAa,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IAC1E,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,0BAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IAEpF,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,YAAK,EAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,YAAK,CAAC,CAAC,IAAI,CAAC,IAAA,eAAG,EAAC,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7F,MAAM,gBAAgB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,YAAK,EAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,YAAK,CAAC,CAAC,IAAI,CACrE,IAAA,kBAAM,EAAC,GAAG,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CACvC,CAAC;IAEF,OAAO,IAAA,YAAK,EAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,IAAI,CAC9C,IAAA,kBAAW,EAAC,qBAAc,CAAC,EAC3B,SAAS,CAAC,CAAC,CAAC,IAAA,qBAAS,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAA,eAAG,GAAE,EACrC,IAAA,eAAG,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EACb,IAAA,qBAAS,EAAC,GAAG,EAAE;QACb,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAExB,OAAO,OAAO,EAAE,CAAC,IAAI,CACnB,IAAA,eAAG,EAAC,CAAC,KAAK,EAAE,EAAE;YACZ,IAAI,IAAA,qBAAa,EAAC,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC5C,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/engine/core/operators/distinct-pending.d.ts

@@ -0,0 +1,6 @@
+import { OperatorFunction } from 'rxjs';
+import { BuilderState } from '../types';
+/**
+ *
+ */
+export declare function distinctPending<T>(): OperatorFunction<BuilderState<T>, BuilderState<T>>;

package/engine/core/operators/distinct-pending.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.distinctPending = distinctPending;
+const rxjs_1 = require("rxjs");
+const types_1 = require("../types");
+/**
+ *
+ */
+function distinctPending() {
+    return (source) => source.pipe((0, rxjs_1.distinctUntilChanged)((a, b) => a.state === b.state && (0, types_1.isBuilderPending)(a)));
+}
+//# sourceMappingURL=distinct-pending.js.map

package/engine/core/operators/distinct-pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distinct-pending.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/distinct-pending.ts"],"names":[],"mappings":";;AAOA,0CAGC;AAVD,+BAA8D;AAE9D,oCAA0D;AAE1D;;GAEG;AACH,SAAgB,eAAe;IAC7B,OAAO,CAAC,MAAM,EAAE,EAAE,CAChB,MAAM,CAAC,IAAI,CAAC,IAAA,2BAAoB,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,IAAI,IAAA,wBAAgB,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5F,CAAC"}

package/engine/core/operators/emit-cache.d.ts

@@ -0,0 +1,17 @@
+import { OperatorFunction } from 'rxjs';
+/**
+ * Creates an RxJS operator that triggers the execution of cached emit functions.
+ * This operator is designed to be used in an RxJS pipeline where caching mechanisms
+ * are in place to temporarily store emit functions. Upon invocation, it iterates over
+ * the `PENDING_CACHE`, executing each cached emit function.
+ *
+ * The `PENDING_CACHE` is expected to be a collection (e.g., array) of functions that
+ * are intended to be executed to emit values or perform actions that were deferred.
+ *
+ * This operator does not alter the stream's data directly but performs side effects
+ * (the execution of emit functions) that may influence the application's state or behavior.
+ * @template T The type of items in the observable stream.
+ * @returns An OperatorFunction<T, T> that maintains the stream's data type and performs
+ * the side effect of executing cached emit functions.
+ */
+export declare function emitCache<T>(): OperatorFunction<T, T>;

package/engine/core/operators/emit-cache.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitCache = emitCache;
+const builder_1 = require("@ng-doc/builder");
+const operators_1 = require("rxjs/operators");
+/**
+ * Creates an RxJS operator that triggers the execution of cached emit functions.
+ * This operator is designed to be used in an RxJS pipeline where caching mechanisms
+ * are in place to temporarily store emit functions. Upon invocation, it iterates over
+ * the `PENDING_CACHE`, executing each cached emit function.
+ *
+ * The `PENDING_CACHE` is expected to be a collection (e.g., array) of functions that
+ * are intended to be executed to emit values or perform actions that were deferred.
+ *
+ * This operator does not alter the stream's data directly but performs side effects
+ * (the execution of emit functions) that may influence the application's state or behavior.
+ * @template T The type of items in the observable stream.
+ * @returns An OperatorFunction<T, T> that maintains the stream's data type and performs
+ * the side effect of executing cached emit functions.
+ */
+function emitCache() {
+    return (source) => {
+        return source.pipe((0, operators_1.tap)(() => {
+            // Iterate over the PENDING_CACHE and execute each emit function
+            builder_1.PENDING_CACHE.forEach((emitCache) => emitCache());
+            // Clear the PENDING_CACHE after all emit functions are executed
+            builder_1.PENDING_CACHE.length = 0;
+        }));
+    };
+}
+//# sourceMappingURL=emit-cache.js.map

package/engine/core/operators/emit-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-cache.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/emit-cache.ts"],"names":[],"mappings":";;AAmBA,8BAWC;AA9BD,6CAAgD;AAEhD,8CAAqC;AAErC;;;;;;;;;;;;;;GAcG;AACH,SAAgB,SAAS;IACvB,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,OAAO,MAAM,CAAC,IAAI,CAChB,IAAA,eAAG,EAAC,GAAG,EAAE;YACP,gEAAgE;YAChE,uBAAa,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;YAClD,gEAAgE;YAChE,uBAAa,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/engine/core/operators/emit-file-output.d.ts

@@ -0,0 +1,7 @@
+import { OperatorFunction } from 'rxjs';
+import { BuilderDone, BuilderError, FileOutput } from '../types';
+/**
+ * An operator function that emits file outputs.
+ * @returns An OperatorFunction that can be used in an RxJS pipe.
+ */
+export declare function emitFileOutput(): OperatorFunction<BuilderDone<FileOutput> | BuilderError, BuilderDone<FileOutput> | BuilderError>;

package/engine/core/operators/emit-file-output.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitFileOutput = emitFileOutput;
+const tslib_1 = require("tslib");
+const core_1 = require("@ng-doc/core");
+const fs_1 = tslib_1.__importDefault(require("fs"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const operators_1 = require("rxjs/operators");
+const types_1 = require("../types");
+/**
+ * An operator function that emits file outputs.
+ * @returns An OperatorFunction that can be used in an RxJS pipe.
+ */
+function emitFileOutput() {
+    return (source) => {
+        return source.pipe((0, operators_1.tap)((state) => {
+            if ((0, types_1.isBuilderDone)(state)) {
+                emitFiles((0, core_1.asArray)(state.result));
+            }
+        }));
+    };
+}
+/**
+ * Writes the content of each file in the provided array to the file system.
+ * @param {FileOutput[]} files - An array of FileOutput objects to be written to the file system.
+ */
+function emitFiles(files) {
+    files.forEach((output) => {
+        const fileContent = fs_1.default.existsSync(output.filePath) && fs_1.default.readFileSync(output.filePath, 'utf-8');
+        if (fileContent !== output.content) {
+            fs_1.default.mkdirSync(path_1.default.dirname(output.filePath), { recursive: true });
+            fs_1.default.writeFileSync(output.filePath, output.content);
+        }
+    });
+}
+//# sourceMappingURL=emit-file-output.js.map

package/engine/core/operators/emit-file-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-file-output.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/emit-file-output.ts"],"names":[],"mappings":";;AAYA,wCAaC;;AAzBD,uCAAuC;AACvC,oDAAoB;AACpB,wDAAwB;AAExB,8CAAqC;AAErC,oCAAgF;AAEhF;;;GAGG;AACH,SAAgB,cAAc;IAI5B,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,OAAO,MAAM,CAAC,IAAI,CAChB,IAAA,eAAG,EAAC,CAAC,KAAK,EAAE,EAAE;YACZ,IAAI,IAAA,qBAAa,EAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,SAAS,CAAC,IAAA,cAAO,EAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAC,KAAmB;IACpC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAkB,EAAE,EAAE;QACnC,MAAM,WAAW,GAAG,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,YAAE,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEhG,IAAI,WAAW,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;YACnC,YAAE,CAAC,SAAS,CAAC,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,YAAE,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/engine/core/operators/entries-emitter.d.ts

@@ -0,0 +1,8 @@
+import { Observable } from 'rxjs';
+import { NgDocBuilderContext } from '../../../interfaces';
+import { AsyncFileOutput, BuilderState, FileOutput } from '../types';
+/**
+ *
+ * @param context
+ */
+export declare function entriesEmitter(context: NgDocBuilderContext): Observable<BuilderState<FileOutput | AsyncFileOutput>>;

package/engine/core/operators/entries-emitter.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entriesEmitter = entriesEmitter;
+const tslib_1 = require("tslib");
+const core_1 = require("@ng-doc/core");
+const fast_glob_1 = require("fast-glob");
+const minimatch_1 = require("minimatch");
+const path_1 = tslib_1.__importDefault(require("path"));
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const helpers_1 = require("../../../helpers");
+const builders_1 = require("../../builders");
+const api_list_1 = require("../../builders/api-list");
+const variables_1 = require("../../variables");
+const watcher_1 = require("../watcher");
+/**
+ *
+ * @param context
+ */
+function entriesEmitter(context) {
+    const entries = (0, fast_glob_1.sync)([
+        (0, helpers_1.posix)(path_1.default.join(context.docsPath, variables_1.PAGE_PATTERN)),
+        (0, helpers_1.posix)(path_1.default.join(context.docsPath, variables_1.API_PATTERN)),
+    ]);
+    return (0, watcher_1.watchFolder)(context.docsPath, 'create').pipe((0, operators_1.map)((events) => events.map((event) => event.path)), (0, operators_1.startWith)(entries), (0, operators_1.map)((events) => events
+        .map((filePath) => {
+        if ((0, minimatch_1.minimatch)(filePath, variables_1.PAGE_PATTERN)) {
+            return (0, builders_1.pageBuilder)(context, path_1.default.resolve(filePath));
+        }
+        if ((0, minimatch_1.minimatch)(filePath, variables_1.API_PATTERN)) {
+            return (0, api_list_1.apiBuilder)(context, path_1.default.resolve(filePath));
+        }
+        return null;
+    })
+        .filter(core_1.isPresent)), (0, operators_1.filter)((builders) => builders.length > 0), (0, rxjs_1.mergeMap)((builders) => (0, rxjs_1.merge)(...builders)));
+}
+//# sourceMappingURL=entries-emitter.js.map

package/engine/core/operators/entries-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries-emitter.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/entries-emitter.ts"],"names":[],"mappings":";;AAmBA,wCA6BC;;AAhDD,uCAAyC;AACzC,yCAAiC;AACjC,yCAAsC;AACtC,wDAAwB;AACxB,+BAAmD;AACnD,8CAAwD;AAExD,8CAAyC;AAEzC,6CAA6C;AAC7C,sDAAqD;AACrD,+CAA4D;AAE5D,wCAAyC;AAEzC;;;GAGG;AACH,SAAgB,cAAc,CAC5B,OAA4B;IAE5B,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC;QACnB,IAAA,eAAK,EAAC,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,wBAAY,CAAC,CAAC;QAChD,IAAA,eAAK,EAAC,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,uBAAW,CAAC,CAAC;KAChD,CAAC,CAAC;IAEH,OAAO,IAAA,qBAAW,EAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,IAAI,CACjD,IAAA,eAAG,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAClD,IAAA,qBAAS,EAAC,OAAO,CAAC,EAClB,IAAA,eAAG,EAAC,CAAC,MAAM,EAAE,EAAE,CACb,MAAM;SACH,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAChB,IAAI,IAAA,qBAAS,EAAC,QAAQ,EAAE,wBAAY,CAAC,EAAE,CAAC;YACtC,OAAO,IAAA,sBAAW,EAAC,OAAO,EAAE,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,IAAA,qBAAS,EAAC,QAAQ,EAAE,uBAAW,CAAC,EAAE,CAAC;YACrC,OAAO,IAAA,qBAAU,EAAC,OAAO,EAAE,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,MAAM,CAAC,gBAAS,CAAC,CACrB,EACD,IAAA,kBAAM,EAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EACzC,IAAA,eAAQ,EAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAA,YAAK,EAAC,GAAG,QAAQ,CAAC,CAAC,CAC3C,CAAC;AACJ,CAAC"}

package/engine/core/operators/factory.d.ts

@@ -0,0 +1,12 @@
+import { ObservableInputTuple } from 'rxjs';
+import { Builder, BuilderState, CacheStrategy } from '../types';
+/**
+ * The factory function is a powerful tool for creating complex builders.
+ * It should be used when you need to build something based on the results of multiple other builders.
+ * @param tag - A string that identifies the builder.
+ * @param builders - An array of Observables of BuilderState.
+ * @param buildFn - A function that takes the results of the successful Observables and returns a Promise.
+ * @param cacheStrategy - An optional CacheStrategy object.
+ * @returns An Observable of BuilderState.
+ */
+export declare function factory<T, R, TCacheData>(tag: string, builders: readonly [...ObservableInputTuple<Array<BuilderState<T>>>], buildFn: (...args: T[]) => Promise<R> | R, cacheStrategy?: CacheStrategy<TCacheData, R>): Builder<R>;

package/engine/core/operators/factory.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.factory = factory;
+const core_1 = require("@ng-doc/core");
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const types_1 = require("../types");
+const distinct_pending_1 = require("./distinct-pending");
+const handle_cache_strategy_1 = require("./handle-cache-strategy");
+const stack_1 = require("./stack");
+let builderId = 0;
+/**
+ * The factory function is a powerful tool for creating complex builders.
+ * It should be used when you need to build something based on the results of multiple other builders.
+ * @param tag - A string that identifies the builder.
+ * @param builders - An array of Observables of BuilderState.
+ * @param buildFn - A function that takes the results of the successful Observables and returns a Promise.
+ * @param cacheStrategy - An optional CacheStrategy object.
+ * @returns An Observable of BuilderState.
+ */
+function factory(tag, builders, buildFn, cacheStrategy) {
+    const id = builderId++;
+    return (0, rxjs_1.combineLatest)(builders).pipe((0, rxjs_1.switchMap)((states) => {
+        /**
+         * If any of the states are pending, return an Observable of BuilderPending.
+         */
+        if (states.some(types_1.isBuilderPending)) {
+            return (0, rxjs_1.of)(new types_1.BuilderPending(tag));
+        }
+        const errors = states.filter(types_1.isBuilderError);
+        /**
+         * If there are any errors in the states, return an Observable of BuilderError.
+         */
+        if (errors.length) {
+            return (0, rxjs_1.of)(new types_1.BuilderError(tag, (0, core_1.asArray)(...errors.map(({ error }) => error))));
+        }
+        /**
+         * If there are no errors or pending states, call the provided function with the results of the successful states.
+         * The result of the function is then mapped to a BuilderDone state.
+         */
+        const buildFnResult = buildFn(...states.map(({ result }) => result));
+        /**
+         * We don't use ObservableInput here because it opens the door to passing an Observable
+         * as the result of the build function which might break the cache strategy, and final state.
+         */
+        return (0, rxjs_1.from)(Promise.resolve(buildFnResult)).pipe((0, rxjs_1.map)((result) => new types_1.BuilderDone(tag, result)), (0, operators_1.catchError)((error) => (0, rxjs_1.of)(new types_1.BuilderError(tag, [error]))), (0, handle_cache_strategy_1.handleCacheStrategy)(`factory${id}`, cacheStrategy, states.every(({ fromCache }) => fromCache)));
+    }), 
+    /**
+     * Prevents emitting the pending state twice in a row.
+     * This can happen if builders start working asynchronously based on some trigger.
+     */
+    (0, distinct_pending_1.distinctPending)(), (0, stack_1.addToStack)(tag));
+}
+//# sourceMappingURL=factory.js.map

package/engine/core/operators/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/factory.ts"],"names":[],"mappings":";;AA6BA,0BAuDC;AApFD,uCAAuC;AACvC,+BAAqF;AACrF,8CAA4C;AAE5C,oCASkB;AAClB,yDAAqD;AACrD,mEAA8D;AAC9D,mCAAqC;AAErC,IAAI,SAAS,GAAW,CAAC,CAAC;AAE1B;;;;;;;;GAQG;AACH,SAAgB,OAAO,CACrB,GAAW,EACX,QAAoE,EACpE,OAAyC,EACzC,aAA4C;IAE5C,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IAEvB,OAAO,IAAA,oBAAa,EAAC,QAAQ,CAAC,CAAC,IAAI,CACjC,IAAA,gBAAS,EAAC,CAAC,MAA8B,EAAE,EAAE;QAC3C;;WAEG;QACH,IAAI,MAAM,CAAC,IAAI,CAAC,wBAAgB,CAAC,EAAE,CAAC;YAClC,OAAO,IAAA,SAAE,EAAC,IAAI,sBAAc,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,sBAAc,CAAC,CAAC;QAE7C;;WAEG;QACH,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,IAAA,SAAE,EAAC,IAAI,oBAAY,CAAC,GAAG,EAAE,IAAA,cAAO,EAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,CAAC;QAED;;;WAGG;QACH,MAAM,aAAa,GAAG,OAAO,CAC3B,GAAI,MAAgC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CACjE,CAAC;QAEF;;;WAGG;QACH,OAAO,IAAA,WAAI,EAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAC9C,IAAA,UAAG,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,mBAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAC7C,IAAA,sBAAU,EAAC,CAAC,KAAY,EAAE,EAAE,CAAC,IAAA,SAAE,EAAC,IAAI,oBAAY,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAChE,IAAA,2CAAmB,EACjB,UAAU,EAAE,EAAE,EACd,aAAa,EACZ,MAAgC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,CACtE,CACF,CAAC;IACJ,CAAC,CAAC;IACF;;;OAGG;IACH,IAAA,kCAAe,GAAE,EACjB,IAAA,kBAAU,EAAC,GAAG,CAAC,CAChB,CAAC;AACJ,CAAC"}

package/engine/core/operators/handle-cache-strategy.d.ts

@@ -0,0 +1,16 @@
+import { OperatorFunction } from 'rxjs';
+import { BuilderState, CacheStrategy } from '../types';
+/**
+ * Disables cache for all builders.
+ */
+export declare function disableCache(): void;
+export declare const PENDING_CACHE: Array<() => void>;
+/**
+ * Handles cache provided cache strategy.
+ * It will skip or restore the builder based on the strategy on the first run and
+ * update the cache on every next run.
+ * @param id
+ * @param strategy - Cache strategy
+ * @param valid
+ */
+export declare function handleCacheStrategy<T, TData>(id: string, strategy?: CacheStrategy<TData, T>, valid?: boolean): OperatorFunction<BuilderState<T>, BuilderState<T>>;

package/engine/core/operators/handle-cache-strategy.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PENDING_CACHE = void 0;
+exports.disableCache = disableCache;
+exports.handleCacheStrategy = handleCacheStrategy;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const cache_1 = require("../../cache");
+const types_1 = require("../types");
+const variables_1 = require("../variables");
+let isCacheEnabled = true;
+/**
+ * Disables cache for all builders.
+ */
+function disableCache() {
+    isCacheEnabled = false;
+}
+const restoredBuilders = new Set();
+exports.PENDING_CACHE = [];
+/**
+ * Handles cache provided cache strategy.
+ * It will skip or restore the builder based on the strategy on the first run and
+ * update the cache on every next run.
+ * @param id
+ * @param strategy - Cache strategy
+ * @param valid
+ */
+function handleCacheStrategy(id, strategy, valid = true) {
+    return (source) => {
+        if (!strategy || !isCacheEnabled)
+            return source;
+        const cache = (0, cache_1.createCache)(undefined, strategy.files?.(), strategy.getData?.() ?? {});
+        const sourceWithCache = source.pipe((0, operators_1.tap)((state) => {
+            if ((0, types_1.isBuilderDone)(state)) {
+                exports.PENDING_CACHE.push(() => (0, cache_1.updateCache)(strategy.id, (0, cache_1.createCache)(undefined, strategy.files?.(), strategy.getData?.() ?? {}, strategy.action === 'restore' ? strategy.toCache(state.result) : undefined)));
+            }
+        }));
+        // If the builder is already restored, return the source with cache.
+        // Since this function is called every time the builder is triggered (because of `switchMap` in
+        // `runBuild` function), we need to make sure that the builder is restored only once
+        if (restoredBuilders.has(id)) {
+            return sourceWithCache;
+        }
+        const isCacheVal = (0, cache_1.isCacheValid)(strategy.id, cache);
+        const isValid = cache && valid && (0, variables_1.isColdStart)() && isCacheVal;
+        const savedCache = (0, cache_1.loadCache)(strategy.id);
+        savedCache.data && strategy.onCacheLoad?.(savedCache.data);
+        restoredBuilders.add(id);
+        switch (strategy.action) {
+            case 'skip':
+                return isValid ? rxjs_1.EMPTY : sourceWithCache;
+            case 'restore':
+                return isValid
+                    ? (0, rxjs_1.of)(new types_1.BuilderDone(strategy.id, strategy.fromCache(savedCache.result ?? ''), true))
+                    : sourceWithCache;
+            default:
+                return source;
+        }
+    };
+}
+//# sourceMappingURL=handle-cache-strategy.js.map

package/engine/core/operators/handle-cache-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-cache-strategy.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/handle-cache-strategy.ts"],"names":[],"mappings":";;;AAYA,oCAEC;AAcD,kDAqDC;AAjFD,+BAAmD;AACnD,8CAAqC;AAErC,uCAAgF;AAChF,oCAAmF;AACnF,4CAA2C;AAE3C,IAAI,cAAc,GAAY,IAAI,CAAC;AAEnC;;GAEG;AACH,SAAgB,YAAY;IAC1B,cAAc,GAAG,KAAK,CAAC;AACzB,CAAC;AAED,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE9B,QAAA,aAAa,GAAsB,EAAE,CAAC;AAEnD;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,EAAU,EACV,QAAkC,EAClC,QAAiB,IAAI;IAErB,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc;YAAE,OAAO,MAAM,CAAC;QAEhD,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAErF,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CACjC,IAAA,eAAG,EAAC,CAAC,KAAK,EAAE,EAAE;YACZ,IAAI,IAAA,qBAAa,EAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,qBAAa,CAAC,IAAI,CAAC,GAAG,EAAE,CACtB,IAAA,mBAAW,EACT,QAAQ,CAAC,EAAE,EACX,IAAA,mBAAW,EACT,SAAS,EACT,QAAQ,CAAC,KAAK,EAAE,EAAE,EAClB,QAAQ,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,EAC1B,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAC3E,CACF,CACF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,oEAAoE;QACpE,+FAA+F;QAC/F,oFAAoF;QACpF,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7B,OAAO,eAAe,CAAC;QACzB,CAAC;QAED,MAAM,UAAU,GAAG,IAAA,oBAAY,EAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,IAAA,uBAAW,GAAE,IAAI,UAAU,CAAC;QAC9D,MAAM,UAAU,GAAG,IAAA,iBAAS,EAAQ,QAAQ,CAAC,EAAE,CAAC,CAAC;QAEjD,UAAU,CAAC,IAAI,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAa,CAAC,CAAC;QACpE,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEzB,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;YACxB,KAAK,MAAM;gBACT,OAAO,OAAO,CAAC,CAAC,CAAC,YAAK,CAAC,CAAC,CAAC,eAAe,CAAC;YAC3C,KAAK,SAAS;gBACZ,OAAO,OAAO;oBACZ,CAAC,CAAC,IAAA,SAAE,EAAC,IAAI,mBAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAM,EAAE,IAAI,CAAC,CAAC;oBAC1F,CAAC,CAAC,eAAe,CAAC;YACtB;gBACE,OAAO,MAAM,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/engine/core/operators/index.d.ts

@@ -0,0 +1,16 @@
+export * from './builder-state';
+export * from './create-builder';
+export * from './distinct-pending';
+export * from './emit-cache';
+export * from './emit-file-output';
+export * from './entries-emitter';
+export * from './factory';
+export * from './handle-cache-strategy';
+export * from './join-builder-states';
+export * from './merge-factory';
+export * from './print-build-progress';
+export * from './print-errors';
+export * from './run-build';
+export * from './stack';
+export * from './when-builders-done';
+export * from './when-done';

package/engine/core/operators/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./builder-state"), exports);
+tslib_1.__exportStar(require("./create-builder"), exports);
+tslib_1.__exportStar(require("./distinct-pending"), exports);
+tslib_1.__exportStar(require("./emit-cache"), exports);
+tslib_1.__exportStar(require("./emit-file-output"), exports);
+tslib_1.__exportStar(require("./entries-emitter"), exports);
+tslib_1.__exportStar(require("./factory"), exports);
+tslib_1.__exportStar(require("./handle-cache-strategy"), exports);
+tslib_1.__exportStar(require("./join-builder-states"), exports);
+tslib_1.__exportStar(require("./merge-factory"), exports);
+tslib_1.__exportStar(require("./print-build-progress"), exports);
+tslib_1.__exportStar(require("./print-errors"), exports);
+tslib_1.__exportStar(require("./run-build"), exports);
+tslib_1.__exportStar(require("./stack"), exports);
+tslib_1.__exportStar(require("./when-builders-done"), exports);
+tslib_1.__exportStar(require("./when-done"), exports);
+//# sourceMappingURL=index.js.map

package/engine/core/operators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/index.ts"],"names":[],"mappings":";;;AAAA,0DAAgC;AAChC,2DAAiC;AACjC,6DAAmC;AACnC,uDAA6B;AAC7B,6DAAmC;AACnC,4DAAkC;AAClC,oDAA0B;AAC1B,kEAAwC;AACxC,gEAAsC;AACtC,0DAAgC;AAChC,iEAAuC;AACvC,yDAA+B;AAC/B,sDAA4B;AAC5B,kDAAwB;AACxB,+DAAqC;AACrC,sDAA4B"}

package/engine/core/operators/join-builder-states.d.ts

@@ -0,0 +1,9 @@
+import { Observable } from 'rxjs';
+import { BuilderState } from '../types';
+/**
+ *
+ * @param tag
+ * @param states
+ * @param project
+ */
+export declare function joinBuilderStates<T, R>(tag: string, states: Array<BuilderState<T>>, project: (...args: T[]) => Observable<BuilderState<R>>): Observable<BuilderState<R>>;

package/engine/core/operators/join-builder-states.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinBuilderStates = joinBuilderStates;
+const core_1 = require("@ng-doc/core");
+const rxjs_1 = require("rxjs");
+const types_1 = require("../types");
+/**
+ *
+ * @param tag
+ * @param states
+ * @param project
+ */
+function joinBuilderStates(tag, states, project) {
+    /**
+     * If any of the states are pending, return an Observable of BuilderPending.
+     */
+    if (states.some(types_1.isBuilderPending)) {
+        return (0, rxjs_1.of)(new types_1.BuilderPending(tag));
+    }
+    const errors = states.filter(types_1.isBuilderError);
+    /**
+     * If there are any errors in the states, return an Observable of BuilderError.
+     */
+    if (errors.length) {
+        return (0, rxjs_1.of)(new types_1.BuilderError(tag, (0, core_1.asArray)(...errors.map(({ error }) => error))));
+    }
+    return project(...states.map(({ result }) => result));
+}
+//# sourceMappingURL=join-builder-states.js.map

package/engine/core/operators/join-builder-states.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-builder-states.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/join-builder-states.ts"],"names":[],"mappings":";;AAkBA,8CAsBC;AAxCD,uCAAuC;AACvC,+BAAsC;AAEtC,oCAOkB;AAElB;;;;;GAKG;AACH,SAAgB,iBAAiB,CAC/B,GAAW,EACX,MAA8B,EAC9B,OAAsD;IAEtD;;OAEG;IACH,IAAI,MAAM,CAAC,IAAI,CAAC,wBAAgB,CAAC,EAAE,CAAC;QAClC,OAAO,IAAA,SAAE,EAAC,IAAI,sBAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,sBAAc,CAAC,CAAC;IAE7C;;OAEG;IACH,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,IAAA,SAAE,EAAC,IAAI,oBAAY,CAAC,GAAG,EAAE,IAAA,cAAO,EAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,OAAO,CAAC,GAAI,MAAgC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AACnF,CAAC"}

package/engine/core/operators/merge-factory.d.ts

@@ -0,0 +1,14 @@
+import { Observable, ObservableInputTuple } from 'rxjs';
+import { BuilderState, BuilderStateTuple, CacheStrategy } from '../types';
+/**
+ * This function merges multiple observables and applies a project function when all observables are done.
+ * It returns an Observable that emits either the value of type A[number] or a BuilderState<T>.
+ * @param tag - A string representing the tag.
+ * @param sources - An array of Observables.
+ * @param project - A function that takes an array of BuilderState<R> and returns a Promise<T>.
+ * @param cacheStrategy - An optional parameter that defines the cache strategy.
+ * @param mapper
+ * @returns An Observable that emits either the value of type A[number] or a BuilderState<T>.
+ */
+export declare function mergeFactory<TCacheData, A extends ReadonlyArray<BuilderState<unknown>>, T, M>(tag: string, sources: [...ObservableInputTuple<A>], project: (...args: [...BuilderStateTuple<A>]) => Promise<T>, cacheStrategy: CacheStrategy<TCacheData, T>, mapper: (source: [...BuilderStateTuple<A>][number]) => M): Observable<BuilderState<T | M>>;
+export declare function mergeFactory<TCacheData, A extends ReadonlyArray<BuilderState<unknown>>, T>(tag: string, sources: [...ObservableInputTuple<A>], project: (...args: [...BuilderStateTuple<A>]) => Promise<T>, cacheStrategy?: CacheStrategy<TCacheData, T>): Observable<A[number] | BuilderState<T>>;