@cldmv/slothlet 2.11.0 → 3.0.0

package/dist/lib/builders/builder.mjs

@@ -0,0 +1,94 @@
+/*
+	Copyright 2026 CLDMV/Shinrai
+
+	Licensed under the Apache License, Version 2.0 (the "License");
+	you may not use this file except in compliance with the License.
+	You may obtain a copy of the License at
+
+		http://www.apache.org/licenses/LICENSE-2.0
+
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+*/
+
+
+
+
+import { ComponentBase } from "@cldmv/slothlet/factories/component-base";
+
+
+export class Builder extends ComponentBase {
+	static slothletProperty = "builder";
+
+	
+	constructor(slothlet) {
+		super(slothlet);
+	}
+
+	
+	async buildAPI(options) {
+		const {
+			dir,
+			mode = "eager",
+			apiPathPrefix = "",
+			collisionContext = "initial",
+			moduleID,
+			cacheBust = null,
+			fileFilter = null,
+			collisionMode = null
+		} = options;
+
+		
+		if (!dir || typeof dir !== "string") {
+			throw new this.SlothletError(
+				"INVALID_CONFIG_DIR_INVALID",
+				{
+					dir: dir
+				},
+				null,
+				{ validationError: true }
+			);
+		}
+
+		if (mode !== "eager" && mode !== "lazy") {
+			throw new this.SlothletError(
+				"INVALID_CONFIG_MODE_INVALID",
+				{
+					value: mode
+				},
+				null,
+				{ validationError: true }
+			);
+		}
+
+		
+		let rawAPI;
+		if (mode === "eager") {
+			rawAPI = await this.slothlet.modes.eager.buildAPI({
+				dir,
+				apiPathPrefix,
+				collisionContext,
+				moduleID,
+				apiDepth: this.slothlet.config.apiDepth,
+				cacheBust,
+				fileFilter
+			});
+		} else {
+			rawAPI = await this.slothlet.modes.lazy.buildAPI({
+				dir,
+				apiPathPrefix,
+				collisionContext,
+				collisionMode,
+				moduleID,
+				apiDepth: this.slothlet.config.apiDepth,
+				cacheBust,
+				fileFilter
+			});
+		}
+
+		return rawAPI;
+	}
+}