@fragno-dev/db 0.1.13 → 0.1.15

package/dist/packages/fragno/dist/api/fragment-definition-builder.js

@@ -0,0 +1,320 @@
+//#region ../fragno/dist/api/fragment-definition-builder.js
+/**
+* Builder class for creating fragment definitions.
+* This provides a fluent API for defining fragments with type safety.
+*/
+var FragmentDefinitionBuilder = class FragmentDefinitionBuilder$1 {
+	#name;
+	#dependencies;
+	#baseServices;
+	#namedServices;
+	#privateServices;
+	#serviceDependencies;
+	#createRequestStorage;
+	#createThisContext;
+	#getExternalStorage;
+	#linkedFragments;
+	constructor(name, state) {
+		this.#name = name;
+		if (state) {
+			this.#dependencies = state.dependencies;
+			this.#baseServices = state.baseServices;
+			this.#namedServices = state.namedServices;
+			this.#privateServices = state.privateServices;
+			this.#serviceDependencies = state.serviceDependencies;
+			this.#createRequestStorage = state.createRequestStorage;
+			this.#createThisContext = state.createThisContext;
+			this.#getExternalStorage = state.getExternalStorage;
+			this.#linkedFragments = state.linkedFragments;
+		}
+	}
+	get name() {
+		return this.#name;
+	}
+	/**
+	* Define dependencies for this fragment.
+	* Dependencies are available to services and handlers.
+	*
+	* **IMPORTANT**: This method resets all services, storage, and context configurations.
+	* Always call `withDependencies` early in the builder chain, before defining services
+	* or request storage/context.
+	*
+	* @example
+	* ```typescript
+	* // ✅ GOOD: Dependencies set first
+	* defineFragment("my-fragment")
+	*   .withDependencies(() => ({ apiKey: "..." }))
+	*   .withRequestStorage(({ deps }) => ({ userId: deps.apiKey }))
+	*   .providesService("myService", ...)
+	*
+	* // ❌ BAD: Dependencies set late (erases storage setup)
+	* defineFragment("my-fragment")
+	*   .withRequestStorage(() => ({ userId: "..." }))  // This gets erased!
+	*   .withDependencies(() => ({ apiKey: "..." }))
+	* ```
+	*/
+	withDependencies(fn) {
+		if (this.#baseServices || this.#namedServices || this.#privateServices || this.#createRequestStorage || this.#createThisContext || this.#getExternalStorage) console.warn(`[Fragno] Warning: withDependencies() on fragment "${this.#name}" is resetting previously configured services, request storage, or request context. To avoid this, call withDependencies() earlier in the builder chain, before configuring services or storage.`);
+		return new FragmentDefinitionBuilder$1(this.#name, {
+			dependencies: fn,
+			baseServices: void 0,
+			namedServices: void 0,
+			privateServices: void 0,
+			serviceDependencies: this.#serviceDependencies,
+			createRequestStorage: void 0,
+			createThisContext: void 0,
+			getExternalStorage: void 0,
+			linkedFragments: this.#linkedFragments
+		});
+	}
+	/**
+	* Define base (unnamed) services for this fragment.
+	* Base services are accessible directly on the fragment instance.
+	*/
+	providesBaseService(fn) {
+		return new FragmentDefinitionBuilder$1(this.#name, {
+			dependencies: this.#dependencies,
+			baseServices: fn,
+			namedServices: this.#namedServices,
+			privateServices: this.#privateServices,
+			serviceDependencies: this.#serviceDependencies,
+			createRequestStorage: this.#createRequestStorage,
+			createThisContext: this.#createThisContext,
+			getExternalStorage: this.#getExternalStorage,
+			linkedFragments: this.#linkedFragments
+		});
+	}
+	/**
+	* Provide a named service that other fragments or users can use.
+	* Named services are accessible as fragment.serviceName.method()
+	*/
+	providesService(serviceName, fn) {
+		const newNamedServices = {
+			...this.#namedServices,
+			[serviceName]: fn
+		};
+		return new FragmentDefinitionBuilder$1(this.#name, {
+			dependencies: this.#dependencies,
+			baseServices: this.#baseServices,
+			namedServices: newNamedServices,
+			privateServices: this.#privateServices,
+			serviceDependencies: this.#serviceDependencies,
+			createRequestStorage: this.#createRequestStorage,
+			createThisContext: this.#createThisContext,
+			getExternalStorage: this.#getExternalStorage,
+			linkedFragments: this.#linkedFragments
+		});
+	}
+	/**
+	* Provide a private service that is only accessible to the fragment author.
+	* Private services are NOT exposed on the fragment instance, but can be used
+	* when defining other services (baseServices, namedServices, and other privateServices).
+	* Private services are instantiated in order, so earlier private services are available
+	* to later ones.
+	*/
+	providesPrivateService(serviceName, fn) {
+		const newPrivateServices = {
+			...this.#privateServices,
+			[serviceName]: fn
+		};
+		return new FragmentDefinitionBuilder$1(this.#name, {
+			dependencies: this.#dependencies,
+			baseServices: this.#baseServices,
+			namedServices: this.#namedServices,
+			privateServices: newPrivateServices,
+			serviceDependencies: this.#serviceDependencies,
+			createRequestStorage: this.#createRequestStorage,
+			createThisContext: this.#createThisContext,
+			linkedFragments: this.#linkedFragments
+		});
+	}
+	/**
+	* Declare that this fragment uses a required service provided by the runtime.
+	*/
+	usesService(serviceName) {
+		const newServiceDependencies = {
+			...this.#serviceDependencies,
+			[serviceName]: {
+				name: serviceName,
+				required: true
+			}
+		};
+		return new FragmentDefinitionBuilder$1(this.#name, {
+			dependencies: this.#dependencies,
+			baseServices: this.#baseServices,
+			namedServices: this.#namedServices,
+			privateServices: this.#privateServices,
+			serviceDependencies: newServiceDependencies,
+			createRequestStorage: this.#createRequestStorage,
+			createThisContext: this.#createThisContext,
+			linkedFragments: this.#linkedFragments
+		});
+	}
+	/**
+	* Declare that this fragment uses an optional service provided by the runtime.
+	*/
+	usesOptionalService(serviceName) {
+		const newServiceDependencies = {
+			...this.#serviceDependencies,
+			[serviceName]: {
+				name: serviceName,
+				required: false
+			}
+		};
+		return new FragmentDefinitionBuilder$1(this.#name, {
+			dependencies: this.#dependencies,
+			baseServices: this.#baseServices,
+			namedServices: this.#namedServices,
+			privateServices: this.#privateServices,
+			serviceDependencies: newServiceDependencies,
+			createRequestStorage: this.#createRequestStorage,
+			createThisContext: this.#createThisContext,
+			linkedFragments: this.#linkedFragments
+		});
+	}
+	/**
+	* Define the type and initial data stored in AsyncLocalStorage for per-request isolation.
+	* This should be called before withThisContext if you need to store request-specific data.
+	*
+	* @param initializer Function that returns the initial storage data for each request
+	*
+	* @example
+	* ```typescript
+	* .withRequestStorage(({ config, options, deps }) => ({
+	*   counter: 0,
+	*   userId: deps.currentUserId
+	* }))
+	* .withThisContext(({ storage }) => ({
+	*   serviceContext: {
+	*     get counter() { return storage.getStore()!.counter; }
+	*   },
+	*   handlerContext: {
+	*     get counter() { return storage.getStore()!.counter; }
+	*   }
+	* }))
+	* ```
+	*/
+	withRequestStorage(initializer) {
+		const preservedExternalStorage = this.#getExternalStorage ? this.#getExternalStorage : void 0;
+		return new FragmentDefinitionBuilder$1(this.#name, {
+			dependencies: this.#dependencies,
+			baseServices: this.#baseServices,
+			namedServices: this.#namedServices,
+			privateServices: this.#privateServices,
+			serviceDependencies: this.#serviceDependencies,
+			createRequestStorage: initializer,
+			createThisContext: void 0,
+			getExternalStorage: preservedExternalStorage,
+			linkedFragments: this.#linkedFragments
+		});
+	}
+	/**
+	* Use an externally-provided RequestContextStorage instance.
+	* This allows multiple fragments to share the same storage instance.
+	* Useful when fragments need to coordinate (e.g., database fragments sharing adapter storage).
+	* Note: You must still call withRequestStorage to provide the initial storage data.
+	*
+	* @example
+	* ```typescript
+	* .withExternalRequestStorage(({ options }) =>
+	*   options.databaseAdapter.contextStorage
+	* )
+	* .withRequestStorage(({ options }) => ({
+	*   uow: options.databaseAdapter.db.createUnitOfWork()
+	* }))
+	* ```
+	*/
+	withExternalRequestStorage(getStorage) {
+		return new FragmentDefinitionBuilder$1(this.#name, {
+			dependencies: this.#dependencies,
+			baseServices: this.#baseServices,
+			namedServices: this.#namedServices,
+			privateServices: this.#privateServices,
+			serviceDependencies: this.#serviceDependencies,
+			createRequestStorage: void 0,
+			createThisContext: void 0,
+			getExternalStorage: getStorage,
+			linkedFragments: this.#linkedFragments
+		});
+	}
+	/**
+	* Set the this contexts for services and handlers in this fragment.
+	* Both contexts should contain only methods or getters that read from storage.
+	* This ensures proper per-request isolation via AsyncLocalStorage.
+	*
+	* @example
+	* ```ts
+	* .withThisContext(({ storage }) => ({
+	*   serviceContext: {
+	*     get myNumber() { return storage.getStore()?.myNumber ?? 0; }
+	*   },
+	*   handlerContext: {
+	*     get myNumber() { return storage.getStore()?.myNumber ?? 0; }
+	*   }
+	* }))
+	* ```
+	*/
+	withThisContext(fn) {
+		return new FragmentDefinitionBuilder$1(this.#name, {
+			dependencies: this.#dependencies,
+			baseServices: this.#baseServices,
+			namedServices: this.#namedServices,
+			privateServices: this.#privateServices,
+			serviceDependencies: this.#serviceDependencies,
+			createRequestStorage: this.#createRequestStorage,
+			createThisContext: fn,
+			getExternalStorage: this.#getExternalStorage,
+			linkedFragments: this.#linkedFragments
+		});
+	}
+	/**
+	* Register a linked fragment that will be automatically instantiated.
+	* Linked fragments are service-only (no routes) and share the same config/options as the parent.
+	* All services from the linked fragment will be available as private services.
+	*/
+	withLinkedFragment(name, callback) {
+		const newLinkedFragments = {
+			...this.#linkedFragments,
+			[name]: callback
+		};
+		return new FragmentDefinitionBuilder$1(this.#name, {
+			dependencies: this.#dependencies,
+			baseServices: this.#baseServices,
+			namedServices: this.#namedServices,
+			privateServices: this.#privateServices,
+			serviceDependencies: this.#serviceDependencies,
+			createRequestStorage: this.#createRequestStorage,
+			createThisContext: this.#createThisContext,
+			getExternalStorage: this.#getExternalStorage,
+			linkedFragments: newLinkedFragments
+		});
+	}
+	/**
+	* Extend this builder with a transformation function.
+	* This enables fluent API extensions like `.extend(withDatabase(schema))`.
+	*/
+	extend(transformer) {
+		return transformer(this);
+	}
+	/**
+	* Build the final fragment definition
+	*/
+	build() {
+		return {
+			name: this.#name,
+			dependencies: this.#dependencies,
+			baseServices: this.#baseServices,
+			namedServices: this.#namedServices,
+			privateServices: this.#privateServices,
+			serviceDependencies: this.#serviceDependencies,
+			createRequestStorage: this.#createRequestStorage,
+			createThisContext: this.#createThisContext,
+			getExternalStorage: this.#getExternalStorage,
+			linkedFragments: this.#linkedFragments
+		};
+	}
+};
+
+//#endregion
+export { FragmentDefinitionBuilder };
+//# sourceMappingURL=fragment-definition-builder.js.map

package/dist/packages/fragno/dist/api/fragment-definition-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-definition-builder.js","names":["FragmentDefinitionBuilder","#name","#dependencies","#baseServices","#namedServices","#privateServices","#serviceDependencies","#createRequestStorage","#createThisContext","#getExternalStorage","#linkedFragments"],"sources":["../../../../../../fragno/dist/api/fragment-definition-builder.js"],"sourcesContent":["//#region src/api/fragment-definition-builder.ts\n/**\n* Builder class for creating fragment definitions.\n* This provides a fluent API for defining fragments with type safety.\n*/\nvar FragmentDefinitionBuilder = class FragmentDefinitionBuilder {\n\t#name;\n\t#dependencies;\n\t#baseServices;\n\t#namedServices;\n\t#privateServices;\n\t#serviceDependencies;\n\t#createRequestStorage;\n\t#createThisContext;\n\t#getExternalStorage;\n\t#linkedFragments;\n\tconstructor(name, state) {\n\t\tthis.#name = name;\n\t\tif (state) {\n\t\t\tthis.#dependencies = state.dependencies;\n\t\t\tthis.#baseServices = state.baseServices;\n\t\t\tthis.#namedServices = state.namedServices;\n\t\t\tthis.#privateServices = state.privateServices;\n\t\t\tthis.#serviceDependencies = state.serviceDependencies;\n\t\t\tthis.#createRequestStorage = state.createRequestStorage;\n\t\t\tthis.#createThisContext = state.createThisContext;\n\t\t\tthis.#getExternalStorage = state.getExternalStorage;\n\t\t\tthis.#linkedFragments = state.linkedFragments;\n\t\t}\n\t}\n\tget name() {\n\t\treturn this.#name;\n\t}\n\t/**\n\t* Define dependencies for this fragment.\n\t* Dependencies are available to services and handlers.\n\t*\n\t* **IMPORTANT**: This method resets all services, storage, and context configurations.\n\t* Always call `withDependencies` early in the builder chain, before defining services\n\t* or request storage/context.\n\t*\n\t* @example\n\t* ```typescript\n\t* // ✅ GOOD: Dependencies set first\n\t* defineFragment(\"my-fragment\")\n\t*   .withDependencies(() => ({ apiKey: \"...\" }))\n\t*   .withRequestStorage(({ deps }) => ({ userId: deps.apiKey }))\n\t*   .providesService(\"myService\", ...)\n\t*\n\t* // ❌ BAD: Dependencies set late (erases storage setup)\n\t* defineFragment(\"my-fragment\")\n\t*   .withRequestStorage(() => ({ userId: \"...\" }))  // This gets erased!\n\t*   .withDependencies(() => ({ apiKey: \"...\" }))\n\t* ```\n\t*/\n\twithDependencies(fn) {\n\t\tif (this.#baseServices || this.#namedServices || this.#privateServices || this.#createRequestStorage || this.#createThisContext || this.#getExternalStorage) console.warn(`[Fragno] Warning: withDependencies() on fragment \"${this.#name}\" is resetting previously configured services, request storage, or request context. To avoid this, call withDependencies() earlier in the builder chain, before configuring services or storage.`);\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: fn,\n\t\t\tbaseServices: void 0,\n\t\t\tnamedServices: void 0,\n\t\t\tprivateServices: void 0,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: void 0,\n\t\t\tcreateThisContext: void 0,\n\t\t\tgetExternalStorage: void 0,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Define base (unnamed) services for this fragment.\n\t* Base services are accessible directly on the fragment instance.\n\t*/\n\tprovidesBaseService(fn) {\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: fn,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Provide a named service that other fragments or users can use.\n\t* Named services are accessible as fragment.serviceName.method()\n\t*/\n\tprovidesService(serviceName, fn) {\n\t\tconst newNamedServices = {\n\t\t\t...this.#namedServices,\n\t\t\t[serviceName]: fn\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: newNamedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Provide a private service that is only accessible to the fragment author.\n\t* Private services are NOT exposed on the fragment instance, but can be used\n\t* when defining other services (baseServices, namedServices, and other privateServices).\n\t* Private services are instantiated in order, so earlier private services are available\n\t* to later ones.\n\t*/\n\tprovidesPrivateService(serviceName, fn) {\n\t\tconst newPrivateServices = {\n\t\t\t...this.#privateServices,\n\t\t\t[serviceName]: fn\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: newPrivateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Declare that this fragment uses a required service provided by the runtime.\n\t*/\n\tusesService(serviceName) {\n\t\tconst newServiceDependencies = {\n\t\t\t...this.#serviceDependencies,\n\t\t\t[serviceName]: {\n\t\t\t\tname: serviceName,\n\t\t\t\trequired: true\n\t\t\t}\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: newServiceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Declare that this fragment uses an optional service provided by the runtime.\n\t*/\n\tusesOptionalService(serviceName) {\n\t\tconst newServiceDependencies = {\n\t\t\t...this.#serviceDependencies,\n\t\t\t[serviceName]: {\n\t\t\t\tname: serviceName,\n\t\t\t\trequired: false\n\t\t\t}\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: newServiceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Define the type and initial data stored in AsyncLocalStorage for per-request isolation.\n\t* This should be called before withThisContext if you need to store request-specific data.\n\t*\n\t* @param initializer Function that returns the initial storage data for each request\n\t*\n\t* @example\n\t* ```typescript\n\t* .withRequestStorage(({ config, options, deps }) => ({\n\t*   counter: 0,\n\t*   userId: deps.currentUserId\n\t* }))\n\t* .withThisContext(({ storage }) => ({\n\t*   serviceContext: {\n\t*     get counter() { return storage.getStore()!.counter; }\n\t*   },\n\t*   handlerContext: {\n\t*     get counter() { return storage.getStore()!.counter; }\n\t*   }\n\t* }))\n\t* ```\n\t*/\n\twithRequestStorage(initializer) {\n\t\tconst preservedExternalStorage = this.#getExternalStorage ? this.#getExternalStorage : void 0;\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: initializer,\n\t\t\tcreateThisContext: void 0,\n\t\t\tgetExternalStorage: preservedExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Use an externally-provided RequestContextStorage instance.\n\t* This allows multiple fragments to share the same storage instance.\n\t* Useful when fragments need to coordinate (e.g., database fragments sharing adapter storage).\n\t* Note: You must still call withRequestStorage to provide the initial storage data.\n\t*\n\t* @example\n\t* ```typescript\n\t* .withExternalRequestStorage(({ options }) =>\n\t*   options.databaseAdapter.contextStorage\n\t* )\n\t* .withRequestStorage(({ options }) => ({\n\t*   uow: options.databaseAdapter.db.createUnitOfWork()\n\t* }))\n\t* ```\n\t*/\n\twithExternalRequestStorage(getStorage) {\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: void 0,\n\t\t\tcreateThisContext: void 0,\n\t\t\tgetExternalStorage: getStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Set the this contexts for services and handlers in this fragment.\n\t* Both contexts should contain only methods or getters that read from storage.\n\t* This ensures proper per-request isolation via AsyncLocalStorage.\n\t*\n\t* @example\n\t* ```ts\n\t* .withThisContext(({ storage }) => ({\n\t*   serviceContext: {\n\t*     get myNumber() { return storage.getStore()?.myNumber ?? 0; }\n\t*   },\n\t*   handlerContext: {\n\t*     get myNumber() { return storage.getStore()?.myNumber ?? 0; }\n\t*   }\n\t* }))\n\t* ```\n\t*/\n\twithThisContext(fn) {\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: fn,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t});\n\t}\n\t/**\n\t* Register a linked fragment that will be automatically instantiated.\n\t* Linked fragments are service-only (no routes) and share the same config/options as the parent.\n\t* All services from the linked fragment will be available as private services.\n\t*/\n\twithLinkedFragment(name, callback) {\n\t\tconst newLinkedFragments = {\n\t\t\t...this.#linkedFragments,\n\t\t\t[name]: callback\n\t\t};\n\t\treturn new FragmentDefinitionBuilder(this.#name, {\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: newLinkedFragments\n\t\t});\n\t}\n\t/**\n\t* Extend this builder with a transformation function.\n\t* This enables fluent API extensions like `.extend(withDatabase(schema))`.\n\t*/\n\textend(transformer) {\n\t\treturn transformer(this);\n\t}\n\t/**\n\t* Build the final fragment definition\n\t*/\n\tbuild() {\n\t\treturn {\n\t\t\tname: this.#name,\n\t\t\tdependencies: this.#dependencies,\n\t\t\tbaseServices: this.#baseServices,\n\t\t\tnamedServices: this.#namedServices,\n\t\t\tprivateServices: this.#privateServices,\n\t\t\tserviceDependencies: this.#serviceDependencies,\n\t\t\tcreateRequestStorage: this.#createRequestStorage,\n\t\t\tcreateThisContext: this.#createThisContext,\n\t\t\tgetExternalStorage: this.#getExternalStorage,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t};\n\t}\n};\n/**\n* Create a new fragment definition builder\n*/\nfunction defineFragment(name) {\n\treturn new FragmentDefinitionBuilder(name);\n}\n\n//#endregion\nexport { FragmentDefinitionBuilder, defineFragment };\n//# sourceMappingURL=fragment-definition-builder.js.map"],"mappings":"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"}