@walkeros/core 0.1.0 → 0.1.2

package/dist/index.d.mts

@@ -16,6 +16,8 @@ interface Config$4 {
     globalsStatic: Properties;
     /** Static session data even on a new run */
     sessionStatic: Partial<SessionData>;
+    /** Source configurations */
+    sources?: InitSources;
     /** Destination configurations */
     destinations?: InitDestinations;
     /** Initial custom properties */
@@ -41,17 +43,11 @@ interface SessionData extends Properties {
     runs?: number;
 }
 interface Sources {
-    [id: string]: CollectorSource;
+    [id: string]: Instance;
 }
 interface Destinations$1 {
     [id: string]: Instance$1;
 }
-interface CollectorSource {
-    type: string;
-    mapping?: unknown;
-    settings?: Record<string, unknown>;
-    elb?: AnyFunction;
-}
 type CommandType = 'action' | 'config' | 'consent' | 'context' | 'destination' | 'elb' | 'globals' | 'hook' | 'init' | 'link' | 'run' | 'user' | 'walker' | string;
 interface Instance$2 {
     push: Fn$1;
@@ -74,12 +70,11 @@ interface Instance$2 {
     version: string;
 }
 
-type collector_CollectorSource = CollectorSource;
 type collector_CommandType = CommandType;
 type collector_SessionData = SessionData;
 type collector_Sources = Sources;
 declare namespace collector {
-  export type { collector_CollectorSource as CollectorSource, collector_CommandType as CommandType, Config$4 as Config, Destinations$1 as Destinations, InitConfig$1 as InitConfig, Instance$2 as Instance, collector_SessionData as SessionData, collector_Sources as Sources };
+  export type { collector_CommandType as CommandType, Config$4 as Config, Destinations$1 as Destinations, InitConfig$1 as InitConfig, Instance$2 as Instance, collector_SessionData as SessionData, collector_Sources as Sources };
 }
 
 interface Contract$1 {
@@ -139,21 +134,21 @@ interface Instance$1<Settings = unknown, Mapping = unknown> {
     queue?: Events;
     dlq?: DLQ;
     type?: string;
-    env?: Environment;
+    env?: Environment$1;
     init?: InitFn<Settings, Mapping>;
     push: PushFn<Settings, Mapping>;
     pushBatch?: PushBatchFn<Settings, Mapping>;
+    on?(event: Types, context?: unknown): void | Promise<void>;
 }
 interface Config$3<Settings = unknown, Mapping = unknown> {
     consent?: Consent;
     settings?: Settings;
     data?: Value | Values;
-    env?: Environment;
+    env?: Environment$1;
     id?: string;
     init?: boolean;
     loadScript?: boolean;
     mapping?: Rules<Rule<Mapping>>;
-    on?: Config$1;
     policy?: Policy;
     queue?: boolean;
     verbose?: boolean;
@@ -164,12 +159,13 @@ type PartialConfig<Settings = unknown, Mapping = unknown> = Config$3<Partial<Set
 interface Policy {
     [key: string]: Value;
 }
-type Init$1 = Partial<Omit<Instance$1, 'push'>> & Pick<Instance$1, 'push'>;
-type InitDestination<Settings = unknown, Mapping = unknown> = Omit<Instance$1<Settings, Mapping>, 'config'> & {
-    config?: Config$3<Settings, Mapping>;
+type Init$1<Settings = unknown, Mapping = unknown> = {
+    code: Instance$1<Settings, Mapping>;
+    config?: Partial<Config$3<Settings, Mapping>>;
+    env?: Partial<Environment$1>;
 };
 interface InitDestinations {
-    [key: string]: InitDestination<any, any>;
+    [key: string]: Init$1<any, any>;
 }
 interface Destinations {
     [key: string]: Instance$1;
@@ -178,7 +174,7 @@ interface Context$1<Settings = unknown, Mapping = unknown> {
     collector: Instance$2;
     config: Config$3<Settings, Mapping>;
     data?: Data$1;
-    env: Environment;
+    env: Environment$1;
 }
 interface PushContext<Settings = unknown, Mapping = unknown> extends Context$1<Settings, Mapping> {
     mapping?: Rule<Mapping>;
@@ -222,7 +218,7 @@ type Result$1 = {
  * their runtime environment requirements. Platform-specific extensions
  * should extend this interface.
  */
-interface Environment {
+interface Environment$1 {
     /**
      * Generic global properties that destinations may require
      * Platform-specific implementations can extend this interface
@@ -233,8 +229,6 @@ interface Environment {
 type destination_Batch<Mapping> = Batch<Mapping>;
 type destination_DLQ = DLQ;
 type destination_Destinations = Destinations;
-type destination_Environment = Environment;
-type destination_InitDestination<Settings = unknown, Mapping = unknown> = InitDestination<Settings, Mapping>;
 type destination_InitDestinations = InitDestinations;
 type destination_InitFn<Settings, Mapping> = InitFn<Settings, Mapping>;
 type destination_PartialConfig<Settings = unknown, Mapping = unknown> = PartialConfig<Settings, Mapping>;
@@ -248,7 +242,7 @@ type destination_PushEvents<Mapping = unknown> = PushEvents<Mapping>;
 type destination_PushFn<Settings, Mapping> = PushFn<Settings, Mapping>;
 type destination_Ref = Ref;
 declare namespace destination {
-  export type { destination_Batch as Batch, Config$3 as Config, Context$1 as Context, destination_DLQ as DLQ, Data$1 as Data, destination_Destinations as Destinations, destination_Environment as Environment, Init$1 as Init, destination_InitDestination as InitDestination, destination_InitDestinations as InitDestinations, destination_InitFn as InitFn, Instance$1 as Instance, destination_PartialConfig as PartialConfig, destination_Policy as Policy, destination_Push as Push, destination_PushBatchContext as PushBatchContext, destination_PushBatchFn as PushBatchFn, destination_PushContext as PushContext, destination_PushEvent as PushEvent, destination_PushEvents as PushEvents, destination_PushFn as PushFn, destination_Ref as Ref, Result$1 as Result };
+  export type { destination_Batch as Batch, Config$3 as Config, Context$1 as Context, destination_DLQ as DLQ, Data$1 as Data, destination_Destinations as Destinations, Environment$1 as Environment, Init$1 as Init, destination_InitDestinations as InitDestinations, destination_InitFn as InitFn, Instance$1 as Instance, destination_PartialConfig as PartialConfig, destination_Policy as Policy, destination_Push as Push, destination_PushBatchContext as PushBatchContext, destination_PushBatchFn as PushBatchFn, destination_PushContext as PushContext, destination_PushEvent as PushEvent, destination_PushEvents as PushEvents, destination_PushFn as PushFn, destination_Ref as Ref, Result$1 as Result };
 }
 
 interface EventFn<R = Promise<PushResult>> {
@@ -261,7 +255,7 @@ interface Fn$1<R = Promise<PushResult>, Config = unknown> extends EventFn<R>, Wa
 interface WalkerCommands<R = Promise<PushResult>, Config = unknown> {
     (event: 'walker config', config: Partial<Config>): R;
     (event: 'walker consent', consent: Consent): R;
-    (event: 'walker destination', destination: Init$1 | Instance$1, config?: Config$3): R;
+    <S, M>(event: 'walker destination', destination: Init$1<S, M> | Instance$1<S, M>, config?: Config$3<S, M>): R;
     <K extends keyof Functions>(event: 'walker hook', name: K, hookFn: Functions[K]): R;
     (event: 'walker on', type: Types, rules: SingleOrArray<Options>): R;
     (event: 'walker user', user: User): R;
@@ -279,18 +273,14 @@ interface PushResult extends Result$1 {
     ok: boolean;
 }
 type Layer = Array<IArguments | DeepPartialEvent | unknown[]>;
-interface RegisterDestination<Destination, Config> {
-    (event: 'walker destination', destination: Destination, config?: Config): Promise<PushResult>;
-}
 
 type elb_EventFn<R = Promise<PushResult>> = EventFn<R>;
 type elb_Layer = Layer;
 type elb_PushData<Config = unknown> = PushData<Config>;
 type elb_PushResult = PushResult;
-type elb_RegisterDestination<Destination, Config> = RegisterDestination<Destination, Config>;
 type elb_WalkerCommands<R = Promise<PushResult>, Config = unknown> = WalkerCommands<R, Config>;
 declare namespace elb {
-  export type { Event$1 as Event, elb_EventFn as EventFn, Fn$1 as Fn, elb_Layer as Layer, elb_PushData as PushData, elb_PushResult as PushResult, elb_RegisterDestination as RegisterDestination, elb_WalkerCommands as WalkerCommands };
+  export type { Event$1 as Event, elb_EventFn as EventFn, Fn$1 as Fn, elb_Layer as Layer, elb_PushData as PushData, elb_PushResult as PushResult, elb_WalkerCommands as WalkerCommands };
 }
 
 /**
@@ -484,46 +474,78 @@ declare namespace schema {
 }
 
 interface Config {
-    type: string;
     id?: string;
     disabled?: boolean;
     settings: AnyObject;
     onError?: AnyFunction;
 }
 type InitConfig = Partial<Config>;
-interface Init<T extends Config = Config, E = AnyFunction> {
-    (collector: Instance$2, config: T): CreateSource<T, E> | Promise<CreateSource<T, E>>;
-}
-interface CreateSource<T extends Config = Config, E = AnyFunction> {
-    source?: Instance<T>;
-    elb?: E;
+/**
+ * Environment interface for dependency injection into sources.
+ *
+ * Sources receive all their dependencies through this environment object,
+ * making them platform-agnostic and easily testable.
+ */
+interface Environment {
+    elb: Fn$1;
+    [key: string]: unknown;
 }
+/**
+ * Source instance returned by Source.Init function.
+ *
+ * Sources are stateless and contain no collector references.
+ * All communication with collector happens via env.elb function.
+ */
 interface Instance<T extends Config = Config> {
     type: string;
     config: T;
-    collector: Instance$2;
+    push: Fn$1;
     destroy?(): void | Promise<void>;
+    on?(event: Types, context?: unknown): void | Promise<void>;
+}
+/**
+ * Source initialization function signature.
+ *
+ * Sources are functions that receive configuration and environment dependencies
+ * and return a stateless instance.
+ *
+ * @param config - Source configuration (settings, type, etc.)
+ * @param env - Environment with elb function and platform APIs (defaults to {})
+ * @returns Source instance or promise of instance
+ */
+type Init<T extends Config = Config> = (config: Partial<T>, env?: Environment) => Instance<T> | Promise<Instance<T>>;
+/**
+ * Source configuration interface for collector initialization.
+ * Similar to destinations, this defines the structure for source definitions.
+ */
+type InitSource<T extends Config = Config> = {
+    code: Init<T>;
+    config?: T;
+    env?: Partial<Environment>;
+};
+/**
+ * Sources configuration for collector.
+ * Maps source IDs to their initialization configurations.
+ */
+interface InitSources {
+    [sourceId: string]: InitSource<any>;
 }
 
 type source_Config = Config;
-type source_CreateSource<T extends Config = Config, E = AnyFunction> = CreateSource<T, E>;
-type source_Init<T extends Config = Config, E = AnyFunction> = Init<T, E>;
+type source_Environment = Environment;
+type source_Init<T extends Config = Config> = Init<T>;
 type source_InitConfig = InitConfig;
+type source_InitSource<T extends Config = Config> = InitSource<T>;
+type source_InitSources = InitSources;
 type source_Instance<T extends Config = Config> = Instance<T>;
 declare namespace source {
-  export type { source_Config as Config, source_CreateSource as CreateSource, source_Init as Init, source_InitConfig as InitConfig, source_Instance as Instance };
+  export type { source_Config as Config, source_Environment as Environment, source_Init as Init, source_InitConfig as InitConfig, source_InitSource as InitSource, source_InitSources as InitSources, source_Instance as Instance };
 }
 
 type AnyObject<T = unknown> = Record<string, T>;
-type Elb = globalThis.WalkerOS.Elb;
+type Elb = Fn$1;
 type AnyFunction = (...args: unknown[]) => unknown;
 type SingleOrArray<T> = T | Array<T>;
-declare global {
-    namespace WalkerOS {
-        interface Elb extends Fn$1 {
-        }
-    }
-}
 type Events = Array<Event>;
 type PartialEvent = Partial<Event>;
 type DeepPartialEvent = DeepPartial<Event>;
@@ -757,39 +779,6 @@ declare function getGrantedConsent(required: Consent | undefined, state?: Consen
  */
 declare function createDestination<Settings = unknown, Mapping = unknown>(baseDestination: Instance$1<Settings, Mapping>, config: Partial<Config$3<Settings, Mapping>>): Instance$1<Settings, Mapping>;
 
-/**
- * Creates a new source function by merging a base source with additional configuration.
- *
- * This utility enables elegant source configuration while avoiding config side-effects
- * that could occur when reusing source functions across multiple collector instances.
- *
- * @template T - The source config type extending Source.Config
- * @template E - The source elb function type
- * @param source - The base source function to extend
- * @param config - Additional configuration to merge with the source's config
- * @returns A new source function with merged configuration
- *
- * @example
- * ```typescript
- * import { createSource } from '@walkeros/core';
- * import { sourceBrowser } from '@walkeros/web-source-browser';
- *
- * const configuredSource = createSource(sourceBrowser, {
- *   settings: {
- *     scope: document.body,
- *     session: true
- *   }
- * });
- *
- * const { elb } = await createCollector({
- *   sources: {
- *     browser: configuredSource
- *   }
- * });
- * ```
- */
-declare function createSource<T extends Config, E = unknown>(source: Init<T, E>, config: Partial<T>): Init<T, E>;
-
 /**
  * Creates a complete event with default values.
  * Used for testing and debugging.
@@ -1120,4 +1109,4 @@ declare function validateEvent(obj: unknown, customContracts?: Contracts): Event
  */
 declare function validateProperty(obj: AnyObject, key: string, value: unknown, schema: Property$1): Property | never;
 
-export { collector as Collector, Const, data as Data, destination as Destination, elb as Elb, flow as Flow, handler as Handler, hooks as Hooks, mapping as Mapping, type MarketingParameters, on as On, request as Request, schema as Schema, type SendDataValue, type SendHeaders, type SendResponse, source as Source, type StorageType, walkeros as WalkerOS, anonymizeIP, assign, castToProperty, castValue, clone, createDestination, createEvent, createSource, debounce, filterValues, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getOS, getOSVersion, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isFunction, isNumber, isObject, isPropertyType, isSameType, isString, onLog, parseUserAgent, requestToData, requestToParameter, setByPath, throttle, throwError, transformData, trim, tryCatch, tryCatchAsync, useHooks, validateEvent, validateProperty };
+export { collector as Collector, Const, data as Data, destination as Destination, elb as Elb, flow as Flow, handler as Handler, hooks as Hooks, mapping as Mapping, type MarketingParameters, on as On, request as Request, schema as Schema, type SendDataValue, type SendHeaders, type SendResponse, source as Source, type StorageType, walkeros as WalkerOS, anonymizeIP, assign, castToProperty, castValue, clone, createDestination, createEvent, debounce, filterValues, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getOS, getOSVersion, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isFunction, isNumber, isObject, isPropertyType, isSameType, isString, onLog, parseUserAgent, requestToData, requestToParameter, setByPath, throttle, throwError, transformData, trim, tryCatch, tryCatchAsync, useHooks, validateEvent, validateProperty };

package/dist/index.d.ts

@@ -16,6 +16,8 @@ interface Config$4 {
     globalsStatic: Properties;
     /** Static session data even on a new run */
     sessionStatic: Partial<SessionData>;
+    /** Source configurations */
+    sources?: InitSources;
     /** Destination configurations */
     destinations?: InitDestinations;
     /** Initial custom properties */
@@ -41,17 +43,11 @@ interface SessionData extends Properties {
     runs?: number;
 }
 interface Sources {
-    [id: string]: CollectorSource;
+    [id: string]: Instance;
 }
 interface Destinations$1 {
     [id: string]: Instance$1;
 }
-interface CollectorSource {
-    type: string;
-    mapping?: unknown;
-    settings?: Record<string, unknown>;
-    elb?: AnyFunction;
-}
 type CommandType = 'action' | 'config' | 'consent' | 'context' | 'destination' | 'elb' | 'globals' | 'hook' | 'init' | 'link' | 'run' | 'user' | 'walker' | string;
 interface Instance$2 {
     push: Fn$1;
@@ -74,12 +70,11 @@ interface Instance$2 {
     version: string;
 }
 
-type collector_CollectorSource = CollectorSource;
 type collector_CommandType = CommandType;
 type collector_SessionData = SessionData;
 type collector_Sources = Sources;
 declare namespace collector {
-  export type { collector_CollectorSource as CollectorSource, collector_CommandType as CommandType, Config$4 as Config, Destinations$1 as Destinations, InitConfig$1 as InitConfig, Instance$2 as Instance, collector_SessionData as SessionData, collector_Sources as Sources };
+  export type { collector_CommandType as CommandType, Config$4 as Config, Destinations$1 as Destinations, InitConfig$1 as InitConfig, Instance$2 as Instance, collector_SessionData as SessionData, collector_Sources as Sources };
 }
 
 interface Contract$1 {
@@ -139,21 +134,21 @@ interface Instance$1<Settings = unknown, Mapping = unknown> {
     queue?: Events;
     dlq?: DLQ;
     type?: string;
-    env?: Environment;
+    env?: Environment$1;
     init?: InitFn<Settings, Mapping>;
     push: PushFn<Settings, Mapping>;
     pushBatch?: PushBatchFn<Settings, Mapping>;
+    on?(event: Types, context?: unknown): void | Promise<void>;
 }
 interface Config$3<Settings = unknown, Mapping = unknown> {
     consent?: Consent;
     settings?: Settings;
     data?: Value | Values;
-    env?: Environment;
+    env?: Environment$1;
     id?: string;
     init?: boolean;
     loadScript?: boolean;
     mapping?: Rules<Rule<Mapping>>;
-    on?: Config$1;
     policy?: Policy;
     queue?: boolean;
     verbose?: boolean;
@@ -164,12 +159,13 @@ type PartialConfig<Settings = unknown, Mapping = unknown> = Config$3<Partial<Set
 interface Policy {
     [key: string]: Value;
 }
-type Init$1 = Partial<Omit<Instance$1, 'push'>> & Pick<Instance$1, 'push'>;
-type InitDestination<Settings = unknown, Mapping = unknown> = Omit<Instance$1<Settings, Mapping>, 'config'> & {
-    config?: Config$3<Settings, Mapping>;
+type Init$1<Settings = unknown, Mapping = unknown> = {
+    code: Instance$1<Settings, Mapping>;
+    config?: Partial<Config$3<Settings, Mapping>>;
+    env?: Partial<Environment$1>;
 };
 interface InitDestinations {
-    [key: string]: InitDestination<any, any>;
+    [key: string]: Init$1<any, any>;
 }
 interface Destinations {
     [key: string]: Instance$1;
@@ -178,7 +174,7 @@ interface Context$1<Settings = unknown, Mapping = unknown> {
     collector: Instance$2;
     config: Config$3<Settings, Mapping>;
     data?: Data$1;
-    env: Environment;
+    env: Environment$1;
 }
 interface PushContext<Settings = unknown, Mapping = unknown> extends Context$1<Settings, Mapping> {
     mapping?: Rule<Mapping>;
@@ -222,7 +218,7 @@ type Result$1 = {
  * their runtime environment requirements. Platform-specific extensions
  * should extend this interface.
  */
-interface Environment {
+interface Environment$1 {
     /**
      * Generic global properties that destinations may require
      * Platform-specific implementations can extend this interface
@@ -233,8 +229,6 @@ interface Environment {
 type destination_Batch<Mapping> = Batch<Mapping>;
 type destination_DLQ = DLQ;
 type destination_Destinations = Destinations;
-type destination_Environment = Environment;
-type destination_InitDestination<Settings = unknown, Mapping = unknown> = InitDestination<Settings, Mapping>;
 type destination_InitDestinations = InitDestinations;
 type destination_InitFn<Settings, Mapping> = InitFn<Settings, Mapping>;
 type destination_PartialConfig<Settings = unknown, Mapping = unknown> = PartialConfig<Settings, Mapping>;
@@ -248,7 +242,7 @@ type destination_PushEvents<Mapping = unknown> = PushEvents<Mapping>;
 type destination_PushFn<Settings, Mapping> = PushFn<Settings, Mapping>;
 type destination_Ref = Ref;
 declare namespace destination {
-  export type { destination_Batch as Batch, Config$3 as Config, Context$1 as Context, destination_DLQ as DLQ, Data$1 as Data, destination_Destinations as Destinations, destination_Environment as Environment, Init$1 as Init, destination_InitDestination as InitDestination, destination_InitDestinations as InitDestinations, destination_InitFn as InitFn, Instance$1 as Instance, destination_PartialConfig as PartialConfig, destination_Policy as Policy, destination_Push as Push, destination_PushBatchContext as PushBatchContext, destination_PushBatchFn as PushBatchFn, destination_PushContext as PushContext, destination_PushEvent as PushEvent, destination_PushEvents as PushEvents, destination_PushFn as PushFn, destination_Ref as Ref, Result$1 as Result };
+  export type { destination_Batch as Batch, Config$3 as Config, Context$1 as Context, destination_DLQ as DLQ, Data$1 as Data, destination_Destinations as Destinations, Environment$1 as Environment, Init$1 as Init, destination_InitDestinations as InitDestinations, destination_InitFn as InitFn, Instance$1 as Instance, destination_PartialConfig as PartialConfig, destination_Policy as Policy, destination_Push as Push, destination_PushBatchContext as PushBatchContext, destination_PushBatchFn as PushBatchFn, destination_PushContext as PushContext, destination_PushEvent as PushEvent, destination_PushEvents as PushEvents, destination_PushFn as PushFn, destination_Ref as Ref, Result$1 as Result };
 }
 
 interface EventFn<R = Promise<PushResult>> {
@@ -261,7 +255,7 @@ interface Fn$1<R = Promise<PushResult>, Config = unknown> extends EventFn<R>, Wa
 interface WalkerCommands<R = Promise<PushResult>, Config = unknown> {
     (event: 'walker config', config: Partial<Config>): R;
     (event: 'walker consent', consent: Consent): R;
-    (event: 'walker destination', destination: Init$1 | Instance$1, config?: Config$3): R;
+    <S, M>(event: 'walker destination', destination: Init$1<S, M> | Instance$1<S, M>, config?: Config$3<S, M>): R;
     <K extends keyof Functions>(event: 'walker hook', name: K, hookFn: Functions[K]): R;
     (event: 'walker on', type: Types, rules: SingleOrArray<Options>): R;
     (event: 'walker user', user: User): R;
@@ -279,18 +273,14 @@ interface PushResult extends Result$1 {
     ok: boolean;
 }
 type Layer = Array<IArguments | DeepPartialEvent | unknown[]>;
-interface RegisterDestination<Destination, Config> {
-    (event: 'walker destination', destination: Destination, config?: Config): Promise<PushResult>;
-}
 
 type elb_EventFn<R = Promise<PushResult>> = EventFn<R>;
 type elb_Layer = Layer;
 type elb_PushData<Config = unknown> = PushData<Config>;
 type elb_PushResult = PushResult;
-type elb_RegisterDestination<Destination, Config> = RegisterDestination<Destination, Config>;
 type elb_WalkerCommands<R = Promise<PushResult>, Config = unknown> = WalkerCommands<R, Config>;
 declare namespace elb {
-  export type { Event$1 as Event, elb_EventFn as EventFn, Fn$1 as Fn, elb_Layer as Layer, elb_PushData as PushData, elb_PushResult as PushResult, elb_RegisterDestination as RegisterDestination, elb_WalkerCommands as WalkerCommands };
+  export type { Event$1 as Event, elb_EventFn as EventFn, Fn$1 as Fn, elb_Layer as Layer, elb_PushData as PushData, elb_PushResult as PushResult, elb_WalkerCommands as WalkerCommands };
 }
 
 /**
@@ -484,46 +474,78 @@ declare namespace schema {
 }
 
 interface Config {
-    type: string;
     id?: string;
     disabled?: boolean;
     settings: AnyObject;
     onError?: AnyFunction;
 }
 type InitConfig = Partial<Config>;
-interface Init<T extends Config = Config, E = AnyFunction> {
-    (collector: Instance$2, config: T): CreateSource<T, E> | Promise<CreateSource<T, E>>;
-}
-interface CreateSource<T extends Config = Config, E = AnyFunction> {
-    source?: Instance<T>;
-    elb?: E;
+/**
+ * Environment interface for dependency injection into sources.
+ *
+ * Sources receive all their dependencies through this environment object,
+ * making them platform-agnostic and easily testable.
+ */
+interface Environment {
+    elb: Fn$1;
+    [key: string]: unknown;
 }
+/**
+ * Source instance returned by Source.Init function.
+ *
+ * Sources are stateless and contain no collector references.
+ * All communication with collector happens via env.elb function.
+ */
 interface Instance<T extends Config = Config> {
     type: string;
     config: T;
-    collector: Instance$2;
+    push: Fn$1;
     destroy?(): void | Promise<void>;
+    on?(event: Types, context?: unknown): void | Promise<void>;
+}
+/**
+ * Source initialization function signature.
+ *
+ * Sources are functions that receive configuration and environment dependencies
+ * and return a stateless instance.
+ *
+ * @param config - Source configuration (settings, type, etc.)
+ * @param env - Environment with elb function and platform APIs (defaults to {})
+ * @returns Source instance or promise of instance
+ */
+type Init<T extends Config = Config> = (config: Partial<T>, env?: Environment) => Instance<T> | Promise<Instance<T>>;
+/**
+ * Source configuration interface for collector initialization.
+ * Similar to destinations, this defines the structure for source definitions.
+ */
+type InitSource<T extends Config = Config> = {
+    code: Init<T>;
+    config?: T;
+    env?: Partial<Environment>;
+};
+/**
+ * Sources configuration for collector.
+ * Maps source IDs to their initialization configurations.
+ */
+interface InitSources {
+    [sourceId: string]: InitSource<any>;
 }
 
 type source_Config = Config;
-type source_CreateSource<T extends Config = Config, E = AnyFunction> = CreateSource<T, E>;
-type source_Init<T extends Config = Config, E = AnyFunction> = Init<T, E>;
+type source_Environment = Environment;
+type source_Init<T extends Config = Config> = Init<T>;
 type source_InitConfig = InitConfig;
+type source_InitSource<T extends Config = Config> = InitSource<T>;
+type source_InitSources = InitSources;
 type source_Instance<T extends Config = Config> = Instance<T>;
 declare namespace source {
-  export type { source_Config as Config, source_CreateSource as CreateSource, source_Init as Init, source_InitConfig as InitConfig, source_Instance as Instance };
+  export type { source_Config as Config, source_Environment as Environment, source_Init as Init, source_InitConfig as InitConfig, source_InitSource as InitSource, source_InitSources as InitSources, source_Instance as Instance };
 }
 
 type AnyObject<T = unknown> = Record<string, T>;
-type Elb = globalThis.WalkerOS.Elb;
+type Elb = Fn$1;
 type AnyFunction = (...args: unknown[]) => unknown;
 type SingleOrArray<T> = T | Array<T>;
-declare global {
-    namespace WalkerOS {
-        interface Elb extends Fn$1 {
-        }
-    }
-}
 type Events = Array<Event>;
 type PartialEvent = Partial<Event>;
 type DeepPartialEvent = DeepPartial<Event>;
@@ -757,39 +779,6 @@ declare function getGrantedConsent(required: Consent | undefined, state?: Consen
  */
 declare function createDestination<Settings = unknown, Mapping = unknown>(baseDestination: Instance$1<Settings, Mapping>, config: Partial<Config$3<Settings, Mapping>>): Instance$1<Settings, Mapping>;
 
-/**
- * Creates a new source function by merging a base source with additional configuration.
- *
- * This utility enables elegant source configuration while avoiding config side-effects
- * that could occur when reusing source functions across multiple collector instances.
- *
- * @template T - The source config type extending Source.Config
- * @template E - The source elb function type
- * @param source - The base source function to extend
- * @param config - Additional configuration to merge with the source's config
- * @returns A new source function with merged configuration
- *
- * @example
- * ```typescript
- * import { createSource } from '@walkeros/core';
- * import { sourceBrowser } from '@walkeros/web-source-browser';
- *
- * const configuredSource = createSource(sourceBrowser, {
- *   settings: {
- *     scope: document.body,
- *     session: true
- *   }
- * });
- *
- * const { elb } = await createCollector({
- *   sources: {
- *     browser: configuredSource
- *   }
- * });
- * ```
- */
-declare function createSource<T extends Config, E = unknown>(source: Init<T, E>, config: Partial<T>): Init<T, E>;
-
 /**
  * Creates a complete event with default values.
  * Used for testing and debugging.
@@ -1120,4 +1109,4 @@ declare function validateEvent(obj: unknown, customContracts?: Contracts): Event
  */
 declare function validateProperty(obj: AnyObject, key: string, value: unknown, schema: Property$1): Property | never;
 
-export { collector as Collector, Const, data as Data, destination as Destination, elb as Elb, flow as Flow, handler as Handler, hooks as Hooks, mapping as Mapping, type MarketingParameters, on as On, request as Request, schema as Schema, type SendDataValue, type SendHeaders, type SendResponse, source as Source, type StorageType, walkeros as WalkerOS, anonymizeIP, assign, castToProperty, castValue, clone, createDestination, createEvent, createSource, debounce, filterValues, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getOS, getOSVersion, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isFunction, isNumber, isObject, isPropertyType, isSameType, isString, onLog, parseUserAgent, requestToData, requestToParameter, setByPath, throttle, throwError, transformData, trim, tryCatch, tryCatchAsync, useHooks, validateEvent, validateProperty };
+export { collector as Collector, Const, data as Data, destination as Destination, elb as Elb, flow as Flow, handler as Handler, hooks as Hooks, mapping as Mapping, type MarketingParameters, on as On, request as Request, schema as Schema, type SendDataValue, type SendHeaders, type SendResponse, source as Source, type StorageType, walkeros as WalkerOS, anonymizeIP, assign, castToProperty, castValue, clone, createDestination, createEvent, debounce, filterValues, getBrowser, getBrowserVersion, getByPath, getDeviceType, getEvent, getGrantedConsent, getHeaders, getId, getMappingEvent, getMappingValue, getMarketingParameters, getOS, getOSVersion, isArguments, isArray, isBoolean, isCommand, isDefined, isElementOrDocument, isFunction, isNumber, isObject, isPropertyType, isSameType, isString, onLog, parseUserAgent, requestToData, requestToParameter, setByPath, throttle, throwError, transformData, trim, tryCatch, tryCatchAsync, useHooks, validateEvent, validateProperty };