@fragno-dev/core 0.1.7 → 0.1.8

package/dist/fragment-builder-Boh2vNHq.js

@@ -0,0 +1,108 @@
+//#region src/api/fragment-builder.ts
+var FragmentBuilder = class FragmentBuilder {
+	#definition;
+	constructor(definition) {
+		this.#definition = definition;
+	}
+	get definition() {
+		return this.#definition;
+	}
+	get $requiredOptions() {
+		throw new Error("Type only method. Do not call.");
+	}
+	withDependencies(fn) {
+		const providedServices = this.#definition.providedServices;
+		const recastProvidedServices = typeof providedServices === "function" ? providedServices : providedServices;
+		return new FragmentBuilder({
+			name: this.#definition.name,
+			dependencies: (config, options) => {
+				return fn({
+					config,
+					fragnoConfig: options
+				});
+			},
+			services: void 0,
+			additionalContext: this.#definition.additionalContext,
+			usedServices: this.#definition.usedServices,
+			providedServices: recastProvidedServices
+		});
+	}
+	usesService(serviceName, options) {
+		const isOptional = options?.optional ?? false;
+		return new FragmentBuilder({
+			name: this.#definition.name,
+			dependencies: this.#definition.dependencies,
+			services: this.#definition.services,
+			additionalContext: this.#definition.additionalContext,
+			usedServices: {
+				...this.#definition.usedServices,
+				[serviceName]: {
+					name: serviceName,
+					required: !isOptional
+				}
+			},
+			providedServices: this.#definition.providedServices
+		});
+	}
+	providesService(...args) {
+		const defineService = (services) => services;
+		if (args.length === 1) {
+			const [fnOrServices] = args;
+			const servicesCallback = (config, options, deps) => {
+				if (typeof fnOrServices === "function") return fnOrServices({
+					config,
+					fragnoConfig: options,
+					deps,
+					defineService
+				});
+				else return fnOrServices;
+			};
+			return new FragmentBuilder({
+				name: this.#definition.name,
+				dependencies: this.#definition.dependencies,
+				services: servicesCallback,
+				additionalContext: this.#definition.additionalContext,
+				usedServices: this.#definition.usedServices,
+				providedServices: this.#definition.providedServices
+			});
+		} else {
+			const [serviceName, fnOrService] = args;
+			const createService = (config, options, deps) => {
+				if (typeof fnOrService === "function") return fnOrService({
+					config,
+					fragnoConfig: options,
+					deps,
+					defineService
+				});
+				else return fnOrService;
+			};
+			const existingProvidedServices = this.#definition.providedServices;
+			const newProvidedServices = typeof existingProvidedServices === "function" ? (config, options, deps) => {
+				const existing = existingProvidedServices(config, options, deps);
+				const newService = createService(config, options, deps);
+				return {
+					...existing,
+					[serviceName]: newService
+				};
+			} : {
+				...existingProvidedServices,
+				[serviceName]: createService
+			};
+			return new FragmentBuilder({
+				name: this.#definition.name,
+				dependencies: this.#definition.dependencies,
+				services: this.#definition.services,
+				additionalContext: this.#definition.additionalContext,
+				usedServices: this.#definition.usedServices,
+				providedServices: newProvidedServices
+			});
+		}
+	}
+};
+function defineFragment(name) {
+	return new FragmentBuilder({ name });
+}
+
+//#endregion
+export { defineFragment as n, FragmentBuilder as t };
+//# sourceMappingURL=fragment-builder-Boh2vNHq.js.map

package/dist/fragment-builder-Boh2vNHq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-builder-Boh2vNHq.js","names":["#definition","newProvidedServices:\n        | {\n            [K in keyof (TProvidedServices & {\n              [K in TServiceName]: TService;\n            })]: (TProvidedServices & {\n              [K in TServiceName]: TService;\n            })[K];\n          }\n        | ((\n            config: TConfig,\n            options: FragnoPublicConfig,\n            deps: TDeps & TUsedServices,\n          ) => TProvidedServices & { [K in TServiceName]: TService })"],"sources":["../src/api/fragment-builder.ts"],"sourcesContent":["import type { RequestThisContext } from \"./api\";\nimport type { FragnoPublicConfig } from \"./fragment-instantiation\";\nimport type { RequestInputContext } from \"./request-input-context\";\nimport type { RequestOutputContext } from \"./request-output-context\";\n\n/**\n * Metadata for a service dependency\n */\ninterface ServiceMetadata {\n  /** Name of the service */\n  name: string;\n  /** Whether this service is required (false means optional) */\n  required: boolean;\n}\n\nexport type RouteHandler = (\n  this: RequestThisContext,\n  inputContext: RequestInputContext,\n  outputContext: RequestOutputContext,\n) => Promise<Response>;\n\nexport interface FragmentDefinition<\n  TConfig,\n  TDeps = {},\n  TServices = {},\n  TAdditionalContext extends Record<string, unknown> = {},\n  TUsedServices = {},\n  TProvidedServices = {},\n  TThisContext extends RequestThisContext = RequestThisContext,\n> {\n  name: string;\n  dependencies?: (config: TConfig, options: FragnoPublicConfig) => TDeps;\n  services?: (\n    config: TConfig,\n    options: FragnoPublicConfig,\n    deps: TDeps & TUsedServices,\n  ) => TServices;\n  additionalContext?: TAdditionalContext;\n  createHandlerWrapper?: (\n    options: FragnoPublicConfig,\n  ) => (\n    handler: (this: TThisContext, ...args: Parameters<RouteHandler>) => ReturnType<RouteHandler>,\n  ) => RouteHandler;\n  /** Services that this fragment uses (can be required or optional) */\n  usedServices?: {\n    [K in keyof TUsedServices]: ServiceMetadata;\n  };\n  /** Services that this fragment provides to other fragments (can be a factory function or direct object) */\n  providedServices?:\n    | {\n        [K in keyof TProvidedServices]: TProvidedServices[K];\n      }\n    | ((\n        config: TConfig,\n        options: FragnoPublicConfig,\n        deps: TDeps & TUsedServices,\n      ) => TProvidedServices);\n}\n\nexport class FragmentBuilder<\n  const TConfig,\n  const TDeps = {},\n  const TServices = {},\n  const TAdditionalContext extends Record<string, unknown> = {},\n  const TUsedServices = {},\n  const TProvidedServices = {},\n  const TThisContext extends RequestThisContext = RequestThisContext,\n> {\n  #definition: FragmentDefinition<\n    TConfig,\n    TDeps,\n    TServices,\n    TAdditionalContext,\n    TUsedServices,\n    TProvidedServices,\n    TThisContext\n  >;\n\n  constructor(\n    definition: FragmentDefinition<\n      TConfig,\n      TDeps,\n      TServices,\n      TAdditionalContext,\n      TUsedServices,\n      TProvidedServices,\n      TThisContext\n    >,\n  ) {\n    this.#definition = definition;\n  }\n\n  get definition() {\n    return this.#definition;\n  }\n\n  get $requiredOptions(): FragnoPublicConfig {\n    throw new Error(\"Type only method. Do not call.\");\n  }\n\n  withDependencies<TNewDeps>(\n    fn: (\n      context: { config: TConfig; fragnoConfig: FragnoPublicConfig } & TAdditionalContext,\n    ) => TNewDeps,\n  ): FragmentBuilder<\n    TConfig,\n    TNewDeps,\n    {},\n    TAdditionalContext,\n    TUsedServices,\n    TProvidedServices,\n    TThisContext\n  > {\n    // Safe cast: If providedServices is a function, we need to update its signature to use TNewDeps.\n    // This is safe because the function will be called with the new deps at runtime.\n    const providedServices = this.#definition.providedServices;\n    const recastProvidedServices =\n      typeof providedServices === \"function\"\n        ? (providedServices as unknown as (\n            config: TConfig,\n            options: FragnoPublicConfig,\n            deps: TNewDeps & TUsedServices,\n          ) => TProvidedServices)\n        : providedServices;\n\n    return new FragmentBuilder<\n      TConfig,\n      TNewDeps,\n      {},\n      TAdditionalContext,\n      TUsedServices,\n      TProvidedServices,\n      TThisContext\n    >({\n      name: this.#definition.name,\n      dependencies: (config: TConfig, options: FragnoPublicConfig) => {\n        return fn({ config, fragnoConfig: options } as {\n          config: TConfig;\n          fragnoConfig: FragnoPublicConfig;\n        } & TAdditionalContext);\n      },\n      services: undefined,\n      additionalContext: this.#definition.additionalContext,\n      usedServices: this.#definition.usedServices,\n      providedServices: recastProvidedServices,\n    });\n  }\n\n  /**\n   * Declare that this fragment uses a service.\n   * By default, the service is required. Pass { optional: true } to make it optional.\n   *\n   * @example\n   * ```ts\n   * // Required service\n   * defineFragment(\"my-fragment\")\n   *   .usesService<\"email\", IEmailService>(\"email\")\n   *   .providesService(({ deps, define }) => define({\n   *     sendWelcome: () => deps.email.send(...)\n   *   }))\n   *\n   * // Optional service\n   * defineFragment(\"my-fragment\")\n   *   .usesService<\"email\", IEmailService>(\"email\", { optional: true })\n   *   .providesService(({ deps, define }) => define({\n   *     sendWelcome: () => {\n   *       if (deps.email) {\n   *         deps.email.send(...)\n   *       }\n   *     }\n   *   }))\n   * ```\n   */\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    options?: { optional?: false },\n  ): FragmentBuilder<\n    TConfig,\n    TDeps,\n    TServices,\n    TAdditionalContext,\n    TUsedServices & { [K in TServiceName]: TService },\n    TProvidedServices,\n    TThisContext\n  >;\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    options: { optional: true },\n  ): FragmentBuilder<\n    TConfig,\n    TDeps,\n    TServices,\n    TAdditionalContext,\n    TUsedServices & { [K in TServiceName]: TService | undefined },\n    TProvidedServices,\n    TThisContext\n  >;\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    options?: { optional?: boolean },\n  ): FragmentBuilder<\n    TConfig,\n    TDeps,\n    TServices,\n    TAdditionalContext,\n    TUsedServices & { [K in TServiceName]: TService | TService | undefined },\n    TProvidedServices,\n    TThisContext\n  > {\n    const isOptional = options?.optional ?? false;\n    return new FragmentBuilder<\n      TConfig,\n      TDeps,\n      TServices,\n      TAdditionalContext,\n      TUsedServices & { [K in TServiceName]: TService | (TService | undefined) },\n      TProvidedServices,\n      TThisContext\n    >({\n      name: this.#definition.name,\n      dependencies: this.#definition.dependencies,\n      services: this.#definition.services as\n        | ((\n            config: TConfig,\n            options: FragnoPublicConfig,\n            deps: TDeps &\n              (TUsedServices & { [K in TServiceName]: TService | (TService | undefined) }),\n          ) => TServices)\n        | undefined,\n      additionalContext: this.#definition.additionalContext,\n      usedServices: {\n        ...this.#definition.usedServices,\n        [serviceName]: { name: serviceName, required: !isOptional },\n      } as {\n        [K in keyof (TUsedServices & {\n          [K in TServiceName]: TService | (TService | undefined);\n        })]: ServiceMetadata;\n      },\n      providedServices: this.#definition.providedServices,\n    });\n  }\n\n  /**\n   * Define services for this fragment (unnamed) using a callback.\n   * Use the `defineService` function from the callback context for proper typing (optional).\n   */\n  providesService<TNewServices>(\n    fn: (context: {\n      config: TConfig;\n      fragnoConfig: FragnoPublicConfig;\n      deps: TDeps & TUsedServices;\n      defineService: <T>(services: T) => T;\n    }) => TNewServices,\n  ): FragmentBuilder<\n    TConfig,\n    TDeps,\n    TNewServices,\n    TAdditionalContext,\n    TUsedServices,\n    TProvidedServices,\n    TThisContext\n  >;\n\n  /**\n   * Define services for this fragment (unnamed) using a direct object.\n   */\n  providesService<TNewServices>(\n    services: TNewServices,\n  ): FragmentBuilder<\n    TConfig,\n    TDeps,\n    TNewServices,\n    TAdditionalContext,\n    TUsedServices,\n    TProvidedServices,\n    TThisContext\n  >;\n\n  /**\n   * Provide a named service using a callback.\n   * Use the `defineService` function from the callback context for proper typing (optional).\n   *\n   * @example\n   * ```ts\n   * interface IEmailService {\n   *   send(to: string, subject: string, body: string): Promise<void>;\n   * }\n   *\n   * defineFragment(\"email-fragment\")\n   *   .providesService<\"email\", IEmailService>(\"email\", ({ defineService }) => defineService({\n   *     send: async (to, subject, body) => {\n   *       // implementation\n   *     }\n   *   }))\n   * ```\n   */\n  providesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: (context: {\n      config: TConfig;\n      fragnoConfig: FragnoPublicConfig;\n      deps: TDeps & TUsedServices;\n      defineService: <T>(services: T) => T;\n    }) => TService,\n  ): FragmentBuilder<\n    TConfig,\n    TDeps,\n    TServices,\n    TAdditionalContext,\n    TUsedServices,\n    TProvidedServices & { [K in TServiceName]: TService },\n    TThisContext\n  >;\n\n  /**\n   * Provide a named service using a direct object.\n   */\n  providesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    service: TService,\n  ): FragmentBuilder<\n    TConfig,\n    TDeps,\n    TServices,\n    TAdditionalContext,\n    TUsedServices,\n    TProvidedServices & { [K in TServiceName]: TService },\n    TThisContext\n  >;\n\n  providesService<TServiceName extends string, TService>(\n    ...args:\n      | [\n          fnOrServices:\n            | ((context: {\n                config: TConfig;\n                fragnoConfig: FragnoPublicConfig;\n                deps: TDeps & TUsedServices;\n                defineService: <T>(services: T) => T;\n              }) => TService)\n            | TService,\n        ]\n      | [\n          serviceName: TServiceName,\n          fnOrService:\n            | ((context: {\n                config: TConfig;\n                fragnoConfig: FragnoPublicConfig;\n                deps: TDeps & TUsedServices;\n                defineService: <T>(services: T) => T;\n              }) => TService)\n            | TService,\n        ]\n  ):\n    | FragmentBuilder<\n        TConfig,\n        TDeps,\n        TService,\n        TAdditionalContext,\n        TUsedServices,\n        TProvidedServices,\n        TThisContext\n      >\n    | FragmentBuilder<\n        TConfig,\n        TDeps,\n        TServices,\n        TAdditionalContext,\n        TUsedServices,\n        TProvidedServices & { [K in TServiceName]: TService },\n        TThisContext\n      > {\n    // The defineService function is just an identity function at runtime\n    const defineService = <T>(services: T) => services;\n\n    if (args.length === 1) {\n      // Unnamed service\n      const [fnOrServices] = args;\n\n      // Create a callback that provides the full context including defineService\n      const servicesCallback = (\n        config: TConfig,\n        options: FragnoPublicConfig,\n        deps: TDeps & TUsedServices,\n      ): TService => {\n        if (typeof fnOrServices === \"function\") {\n          // It's a factory function - call it with context\n          const fn = fnOrServices as (context: {\n            config: TConfig;\n            fragnoConfig: FragnoPublicConfig;\n            deps: TDeps & TUsedServices;\n            defineService: <T>(services: T) => T;\n          }) => TService;\n          return fn({\n            config,\n            fragnoConfig: options,\n            deps,\n            defineService,\n          });\n        } else {\n          // It's a direct service object\n          return fnOrServices;\n        }\n      };\n\n      return new FragmentBuilder<\n        TConfig,\n        TDeps,\n        TService,\n        TAdditionalContext,\n        TUsedServices,\n        TProvidedServices,\n        TThisContext\n      >({\n        name: this.#definition.name,\n        dependencies: this.#definition.dependencies,\n        services: servicesCallback as (\n          config: TConfig,\n          options: FragnoPublicConfig,\n          deps: TDeps & TUsedServices,\n        ) => TService,\n        additionalContext: this.#definition.additionalContext,\n        usedServices: this.#definition.usedServices,\n        providedServices: this.#definition.providedServices,\n      });\n    } else {\n      // Named service\n      const [serviceName, fnOrService] = args;\n\n      // Create a callback that provides the full context including defineService\n      const createService = (\n        config: TConfig,\n        options: FragnoPublicConfig,\n        deps: TDeps & TUsedServices,\n      ): TService => {\n        if (typeof fnOrService === \"function\") {\n          // It's a factory function - call it with context\n          const fn = fnOrService as (context: {\n            config: TConfig;\n            fragnoConfig: FragnoPublicConfig;\n            deps: TDeps & TUsedServices;\n            defineService: <T>(services: T) => T;\n          }) => TService;\n          return fn({\n            config,\n            fragnoConfig: options,\n            deps,\n            defineService,\n          });\n        } else {\n          // It's a direct service object\n          return fnOrService;\n        }\n      };\n\n      // We need to handle both function and object forms of providedServices\n      const existingProvidedServices = this.#definition.providedServices;\n      const newProvidedServices:\n        | {\n            [K in keyof (TProvidedServices & {\n              [K in TServiceName]: TService;\n            })]: (TProvidedServices & {\n              [K in TServiceName]: TService;\n            })[K];\n          }\n        | ((\n            config: TConfig,\n            options: FragnoPublicConfig,\n            deps: TDeps & TUsedServices,\n          ) => TProvidedServices & { [K in TServiceName]: TService }) =\n        typeof existingProvidedServices === \"function\"\n          ? // If existing is a function, create a new function that calls both\n            (config: TConfig, options: FragnoPublicConfig, deps: TDeps & TUsedServices) => {\n              const existing = existingProvidedServices(config, options, deps);\n              const newService = createService(config, options, deps);\n              return {\n                ...existing,\n                [serviceName]: newService,\n              } as TProvidedServices & { [K in TServiceName]: TService };\n            }\n          : // If existing is an object or undefined, spread it\n            ({\n              ...existingProvidedServices,\n              [serviceName]: createService,\n            } as {\n              [K in keyof (TProvidedServices & {\n                [K in TServiceName]: TService;\n              })]: (TProvidedServices & {\n                [K in TServiceName]: TService;\n              })[K];\n            });\n\n      return new FragmentBuilder<\n        TConfig,\n        TDeps,\n        TServices,\n        TAdditionalContext,\n        TUsedServices,\n        TProvidedServices & { [K in TServiceName]: TService },\n        TThisContext\n      >({\n        name: this.#definition.name,\n        dependencies: this.#definition.dependencies,\n        services: this.#definition.services,\n        additionalContext: this.#definition.additionalContext,\n        usedServices: this.#definition.usedServices,\n        providedServices: newProvidedServices,\n      });\n    }\n  }\n}\nexport function defineFragment<TConfig = {}>(\n  name: string,\n): FragmentBuilder<TConfig, {}, {}, {}, {}, {}, RequestThisContext> {\n  return new FragmentBuilder({\n    name,\n  });\n}\n"],"mappings":";AA2DA,IAAa,kBAAb,MAAa,gBAQX;CACA;CAUA,YACE,YASA;AACA,QAAKA,aAAc;;CAGrB,IAAI,aAAa;AACf,SAAO,MAAKA;;CAGd,IAAI,mBAAuC;AACzC,QAAM,IAAI,MAAM,iCAAiC;;CAGnD,iBACE,IAWA;EAGA,MAAM,mBAAmB,MAAKA,WAAY;EAC1C,MAAM,yBACJ,OAAO,qBAAqB,aACvB,mBAKD;AAEN,SAAO,IAAI,gBAQT;GACA,MAAM,MAAKA,WAAY;GACvB,eAAe,QAAiB,YAAgC;AAC9D,WAAO,GAAG;KAAE;KAAQ,cAAc;KAAS,CAGpB;;GAEzB,UAAU;GACV,mBAAmB,MAAKA,WAAY;GACpC,cAAc,MAAKA,WAAY;GAC/B,kBAAkB;GACnB,CAAC;;CAoDJ,YACE,aACA,SASA;EACA,MAAM,aAAa,SAAS,YAAY;AACxC,SAAO,IAAI,gBAQT;GACA,MAAM,MAAKA,WAAY;GACvB,cAAc,MAAKA,WAAY;GAC/B,UAAU,MAAKA,WAAY;GAQ3B,mBAAmB,MAAKA,WAAY;GACpC,cAAc;IACZ,GAAG,MAAKA,WAAY;KACnB,cAAc;KAAE,MAAM;KAAa,UAAU,CAAC;KAAY;IAC5D;GAKD,kBAAkB,MAAKA,WAAY;GACpC,CAAC;;CA2FJ,gBACE,GAAG,MAwCC;EAEJ,MAAM,iBAAoB,aAAgB;AAE1C,MAAI,KAAK,WAAW,GAAG;GAErB,MAAM,CAAC,gBAAgB;GAGvB,MAAM,oBACJ,QACA,SACA,SACa;AACb,QAAI,OAAO,iBAAiB,WAQ1B,QANW,aAMD;KACR;KACA,cAAc;KACd;KACA;KACD,CAAC;QAGF,QAAO;;AAIX,UAAO,IAAI,gBAQT;IACA,MAAM,MAAKA,WAAY;IACvB,cAAc,MAAKA,WAAY;IAC/B,UAAU;IAKV,mBAAmB,MAAKA,WAAY;IACpC,cAAc,MAAKA,WAAY;IAC/B,kBAAkB,MAAKA,WAAY;IACpC,CAAC;SACG;GAEL,MAAM,CAAC,aAAa,eAAe;GAGnC,MAAM,iBACJ,QACA,SACA,SACa;AACb,QAAI,OAAO,gBAAgB,WAQzB,QANW,YAMD;KACR;KACA,cAAc;KACd;KACA;KACD,CAAC;QAGF,QAAO;;GAKX,MAAM,2BAA2B,MAAKA,WAAY;GAClD,MAAMC,sBAaJ,OAAO,6BAA6B,cAE/B,QAAiB,SAA6B,SAAgC;IAC7E,MAAM,WAAW,yBAAyB,QAAQ,SAAS,KAAK;IAChE,MAAM,aAAa,cAAc,QAAQ,SAAS,KAAK;AACvD,WAAO;KACL,GAAG;MACF,cAAc;KAChB;OAGF;IACC,GAAG;KACF,cAAc;IAChB;AAQP,UAAO,IAAI,gBAQT;IACA,MAAM,MAAKD,WAAY;IACvB,cAAc,MAAKA,WAAY;IAC/B,UAAU,MAAKA,WAAY;IAC3B,mBAAmB,MAAKA,WAAY;IACpC,cAAc,MAAKA,WAAY;IAC/B,kBAAkB;IACnB,CAAC;;;;AAIR,SAAgB,eACd,MACkE;AAClE,QAAO,IAAI,gBAAgB,EACzB,MACD,CAAC"}