implab/implabjs-di Files · src/main/ts/interfaces.ts

working on fluent configuration

cin - - Load All Authors

File last commit:

r1:a51ea59f0423 default


                r1:a51ea59f0423

default

Download file

             interfaces.ts
        
                    121 lines
            
             | 5.3 KiB
            
                | video/mp2t
            
             |
                TypeScriptLexer
            
             / src / main / ts / interfaces.ts
          
                    History
                
                 |
                  Source
                 | Raw
                 |Copy content
                 |Copy permalink

        cin
    
working on fluent configuration

              r1
            
      import { ActivationContext } from "./ActivationContext";

        cin
    
initial commit

              r0
            
      export type primitive = number | string | null | undefined | symbol;

      export interface IDestroyable {

          destroy(): void;

      }

        cin
    
working on fluent configuration

              r1
            
      /**

       * @template S Карта доступных зависимостей

       */

        cin
    
initial commit

              r0
            
      export interface Resolver<S extends object> {

        cin
    
working on fluent configuration

              r1
            
          /**

           * Функция для разрешения зависимостей, поддерживает создание фабричных методов,

           * отложенную активацию и значение по-умолчанию для сервисов 

           * @template K Ключ сервиса из {@link S}

           * @template O Тип параметра {@link opts} используется для выведения типа

           *   возвращаемого значения.

           * @param name Ключ сервиса, который будет разрешен.

           * @param {boolean=} opts.lazy Признак того, что требуется отложенная активация,

           *   будет возвращен фабричный метод для получения зависимости. Если не указан,

           *   то считается `false`.

           * @param {any=} opts.default Значение по умолчанию, если в контейнере указанный

           *   сервис не зарегистрирован

           * @returns Либо фабричный метод для получения зависимости, либо значение зависимости

           * @throws Error Если зависимость не найдена и не предоставлено значение по-умолчанию

           */

          <K extends keyof S, O extends { lazy: true; default?: unknown }>(name: K, opts?: O): () => (O extends { default: infer T } ? T : never) | NonNullable<S[K]>;

          <K extends keyof S, O extends { lazy?: false; default?: unknown }>(name: K, opts?: O): (O extends { default: infer T } ? T : never) | NonNullable<S[K]>;

        cin
    
initial commit

              r0
            
      }

      export interface DescriptorBuilder<S extends object, T> {

        cin
    
working on fluent configuration

              r1
            
          /**

           * 

           * @param f

           */

        cin
    
initial commit

              r0
            
          factory(f: (resolve: Resolver<S>) => T): void;

        cin
    
working on fluent configuration

              r1
            
          override<K extends ConfigurableKeys<S>>(name: K, builder: RegistrationBuilder<S, NonNullable<S[K]>>): this;

          override<K extends ConfigurableKeys<S>>(services: { [name in K]: RegistrationBuilder<S, NonNullable<S[K]>> }): this;

        cin
    
initial commit

              r0
            
        cin
    
working on fluent configuration

              r1
            
          lifetime(lifetime: "singleton", typeId: string | number | object): this;

          lifetime(lifetime: ILifetime<T> | Exclude<ActivationType, "singleton">): this;

        cin
    
initial commit

              r0
            
          cleanup(cb: (item: T) => void): this;

          value(v: T): void;

      }

        cin
    
working on fluent configuration

              r1
            
      export type RegistrationBuilder<S extends object, T> = (d: DescriptorBuilder<S, T>) => void;

        cin
    
initial commit

              r0
            
        cin
    
working on fluent configuration

              r1
            
      export type RegistrationBuildersMap<S extends object, K extends ConfigurableKeys<S> = ConfigurableKeys<S>> = {

          [k in K]-?: RegistrationBuilder<ContainerServices<S>, NonNullable<ConfigurableServices<S>[k]>>

      };

        cin
    
initial commit

              r0
            
        cin
    
working on fluent configuration

              r1
            
      export interface Descriptor<S extends object, T> {

        cin
    
initial commit

              r0
            
          activate(context: ActivationContext<S>): T;

      }

        cin
    
working on fluent configuration

              r1
            
      export type ConfigurableDescriptor<S extends object, K extends ConfigurableKeys<S>> = Descriptor<ContainerServices<S>, ConfigurableServices<S>[K]>;

        cin
    
initial commit

              r0
            
        cin
    
working on fluent configuration

              r1
            
      export type RegistrationMap<S extends object, K extends keyof S = keyof S> = {

          [k in K]-?: Descriptor<S, S[k]>;

        cin
    
initial commit

              r0
            
      };

        cin
    
working on fluent configuration

              r1
            
      export interface ProvidedServices<S extends object> {

          container: ServiceLocator<ContainerServices<S>>;

          childContainer: ServiceContainer<S>;

      }

      export type ProvidedKeys = keyof ProvidedServices<object>;

      export type ContainerKeys<S extends object> = keyof ContainerServices<S>;

      export type Mix<S, X> = { [k in keyof (S & X)]: k extends keyof X ? X[k] : S[k & keyof S] };

      export type ContainerServices<S extends object> = Mix<S, ProvidedServices<S>>;

      export type ConfigurableKeys<S extends object> = Exclude<keyof S, ProvidedKeys>;

      export type ConfigurableServices<S extends object> = Pick<S, ConfigurableKeys<S>>;

        cin
    
initial commit

              r0
            
      export interface ServiceLocator<S extends object> {

        cin
    
working on fluent configuration

              r1
            
          resolve<K extends keyof S>(name: K): NonNullable<S[K]>;

          resolve<K extends keyof S, T>(name: K, def: T): NonNullable<S[K]> | T;

        cin
    
initial commit

              r0
            
      }

        cin
    
working on fluent configuration

              r1
            
      export interface LifetimeContainer {

          createLifetime<T>(): ILifetime<T>;

      }

      export interface ServiceContainer<S extends object> extends ServiceLocator<ContainerServices<S>>, LifetimeContainer, IDestroyable {

          register<K extends ConfigurableKeys<S>>(name: K, service: ConfigurableDescriptor<S, K>): void;

          register<K extends ConfigurableKeys<S>>(services: { [k in K]: ConfigurableDescriptor<S, K> }): void;

        cin
    
initial commit

              r0
            
          createChildContainer(): ServiceContainer<S>;

      }

      export type ActivationType = "singleton" | "container" | "hierarchy" | "context" | "call";

      /**

       * Интерфейс для управления жизнью экземпляра объекта. Каждая регистрация имеет

       * свой собственный объект `ILifetime`, который создается при первой активации

       */

        cin
    
working on fluent configuration

              r1
            
      export interface ILifetime<T> {

        cin
    
initial commit

              r0
            
          /** Проверяет, что уже создан экземпляр объекта */

          has(): boolean;

        cin
    
working on fluent configuration

              r1
            
          get(): T;

          initialize(context: ActivationContext<object>): void;

        cin
    
initial commit

              r0
            
        cin
    
working on fluent configuration

              r1
            
          store(item: T, cleanup?: (item: T) => void): void;

      }

        cin
    
initial commit

              r0
            
        cin
    
working on fluent configuration

              r1
            
      export type RequiredKeys<T, K extends keyof T = keyof T> = keyof { [p in K as (T[p] extends undefined ? never : p)]-?: T[p] };

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

cin working on fluent configuration	r1	import { ActivationContext } from "./ActivationContext";

cin initial commit	r0	export type primitive = number \| string \| null \| undefined \| symbol;

		export interface IDestroyable {
		destroy(): void;
		}

cin working on fluent configuration	r1	/**
		* @template S Карта доступных зависимостей
		*/
cin initial commit	r0	export interface Resolver<S extends object> {
cin working on fluent configuration	r1	/**
		* Функция для разрешения зависимостей, поддерживает создание фабричных методов,
		* отложенную активацию и значение по-умолчанию для сервисов
		* @template K Ключ сервиса из {@link S}
		* @template O Тип параметра {@link opts} используется для выведения типа
		* возвращаемого значения.
		* @param name Ключ сервиса, который будет разрешен.
		* @param {boolean=} opts.lazy Признак того, что требуется отложенная активация,
		* будет возвращен фабричный метод для получения зависимости. Если не указан,
		* то считается `false`.
		* @param {any=} opts.default Значение по умолчанию, если в контейнере указанный
		* сервис не зарегистрирован
		* @returns Либо фабричный метод для получения зависимости, либо значение зависимости
		* @throws Error Если зависимость не найдена и не предоставлено значение по-умолчанию
		*/
		<K extends keyof S, O extends { lazy: true; default?: unknown }>(name: K, opts?: O): () => (O extends { default: infer T } ? T : never) \| NonNullable<S[K]>;
		<K extends keyof S, O extends { lazy?: false; default?: unknown }>(name: K, opts?: O): (O extends { default: infer T } ? T : never) \| NonNullable<S[K]>;
cin initial commit	r0	}

		export interface DescriptorBuilder<S extends object, T> {
cin working on fluent configuration	r1
		/**
		*
		* @param f
		*/
cin initial commit	r0	factory(f: (resolve: Resolver<S>) => T): void;

cin working on fluent configuration	r1	override<K extends ConfigurableKeys<S>>(name: K, builder: RegistrationBuilder<S, NonNullable<S[K]>>): this;
		override<K extends ConfigurableKeys<S>>(services: { [name in K]: RegistrationBuilder<S, NonNullable<S[K]>> }): this;
cin initial commit	r0
cin working on fluent configuration	r1	lifetime(lifetime: "singleton", typeId: string \| number \| object): this;
		lifetime(lifetime: ILifetime<T> \| Exclude<ActivationType, "singleton">): this;
cin initial commit	r0
		cleanup(cb: (item: T) => void): this;

		value(v: T): void;
		}

cin working on fluent configuration	r1	export type RegistrationBuilder<S extends object, T> = (d: DescriptorBuilder<S, T>) => void;
cin initial commit	r0
cin working on fluent configuration	r1	export type RegistrationBuildersMap<S extends object, K extends ConfigurableKeys<S> = ConfigurableKeys<S>> = {
		[k in K]-?: RegistrationBuilder<ContainerServices<S>, NonNullable<ConfigurableServices<S>[k]>>
		};
cin initial commit	r0
cin working on fluent configuration	r1	export interface Descriptor<S extends object, T> {
cin initial commit	r0	activate(context: ActivationContext<S>): T;
		}

cin working on fluent configuration	r1	export type ConfigurableDescriptor<S extends object, K extends ConfigurableKeys<S>> = Descriptor<ContainerServices<S>, ConfigurableServices<S>[K]>;
cin initial commit	r0
cin working on fluent configuration	r1	export type RegistrationMap<S extends object, K extends keyof S = keyof S> = {
		[k in K]-?: Descriptor<S, S[k]>;
cin initial commit	r0	};

cin working on fluent configuration	r1	export interface ProvidedServices<S extends object> {
		container: ServiceLocator<ContainerServices<S>>;

		childContainer: ServiceContainer<S>;
		}

		export type ProvidedKeys = keyof ProvidedServices<object>;

		export type ContainerKeys<S extends object> = keyof ContainerServices<S>;

		export type Mix<S, X> = { [k in keyof (S & X)]: k extends keyof X ? X[k] : S[k & keyof S] };

		export type ContainerServices<S extends object> = Mix<S, ProvidedServices<S>>;

		export type ConfigurableKeys<S extends object> = Exclude<keyof S, ProvidedKeys>;

		export type ConfigurableServices<S extends object> = Pick<S, ConfigurableKeys<S>>;
cin initial commit	r0
		export interface ServiceLocator<S extends object> {
cin working on fluent configuration	r1	resolve<K extends keyof S>(name: K): NonNullable<S[K]>;
		resolve<K extends keyof S, T>(name: K, def: T): NonNullable<S[K]> \| T;
cin initial commit	r0	}

cin working on fluent configuration	r1	export interface LifetimeContainer {
		createLifetime<T>(): ILifetime<T>;
		}

		export interface ServiceContainer<S extends object> extends ServiceLocator<ContainerServices<S>>, LifetimeContainer, IDestroyable {

		register<K extends ConfigurableKeys<S>>(name: K, service: ConfigurableDescriptor<S, K>): void;
		register<K extends ConfigurableKeys<S>>(services: { [k in K]: ConfigurableDescriptor<S, K> }): void;
cin initial commit	r0
		createChildContainer(): ServiceContainer<S>;
		}


		export type ActivationType = "singleton" \| "container" \| "hierarchy" \| "context" \| "call";

		/**
		* Интерфейс для управления жизнью экземпляра объекта. Каждая регистрация имеет
		* свой собственный объект `ILifetime`, который создается при первой активации
		*/
cin working on fluent configuration	r1	export interface ILifetime<T> {
cin initial commit	r0	/** Проверяет, что уже создан экземпляр объекта */
		has(): boolean;

cin working on fluent configuration	r1	get(): T;

		initialize(context: ActivationContext<object>): void;
cin initial commit	r0
cin working on fluent configuration	r1	store(item: T, cleanup?: (item: T) => void): void;
		}
cin initial commit	r0
cin working on fluent configuration	r1	export type RequiredKeys<T, K extends keyof T = keyof T> = keyof { [p in K as (T[p] extends undefined ? never : p)]-?: T[p] };