@baseplate-dev/utils 0.1.1

package/dist/events/typed-event-emitter.js

@@ -0,0 +1,128 @@
+/**
+ * Class providing typed event emitter functionality.
+ *
+ * @template T - Mapping of event names to payload types.
+ */
+export class TypedEventEmitter {
+    listenerMap = new Map();
+    /**
+     * Abort controller for the event emitter to terminate all async generator listeners.
+     */
+    eventEmitterAbortController = new AbortController();
+    /**
+     * Registers a listener for an event.
+     *
+     * @template K - The event name.
+     * @param eventName - Name of the event.
+     * @param listener - Callback invoked with the event payload.
+     * @param options - Options for the listener.
+     * @returns Function to unregister the listener.
+     */
+    on(eventName, listener, options) {
+        const { signal } = options ?? {};
+        const existingListeners = this.listenerMap.get(eventName) ?? [];
+        this.listenerMap.set(eventName, [
+            ...existingListeners,
+            listener,
+        ]);
+        // Returns a function that unregisters this listener.
+        const unregister = () => {
+            const updatedListeners = (this.listenerMap.get(eventName) ?? []).filter((l) => l !== listener);
+            if (updatedListeners.length > 0) {
+                this.listenerMap.set(eventName, updatedListeners);
+            }
+            else {
+                this.listenerMap.delete(eventName);
+            }
+        };
+        signal?.addEventListener('abort', unregister, {
+            once: true,
+        });
+        return unregister;
+    }
+    /**
+     * Creates an async generator for an event.
+     *
+     * @template K - The event name.
+     * @param eventName - Name of the event.
+     * @param options - Additional options.
+     * @returns An async generator yielding event payloads.
+     */
+    async *onAsync(eventName, options) {
+        // Create a queue to store events when consumer isn't ready
+        const queue = [];
+        let pendingNext;
+        let isDone = false;
+        // Return early if the signal is aborted
+        const eventEmitterAbortSignal = this.eventEmitterAbortController.signal;
+        if (options.signal?.aborted || eventEmitterAbortSignal.aborted)
+            return;
+        function abortHandler() {
+            isDone = true;
+            // trigger dummy event to unblock the consumer
+            pendingNext?.(undefined);
+        }
+        options.signal?.addEventListener('abort', abortHandler, { once: true });
+        eventEmitterAbortSignal.addEventListener('abort', abortHandler, {
+            once: true,
+        });
+        this.on(eventName, (payload) => {
+            if (pendingNext) {
+                pendingNext(payload);
+                pendingNext = undefined;
+            }
+            else {
+                queue.push(payload);
+            }
+        }, { signal: options.signal });
+        // Keep yielding events until done
+        while (!isDone) {
+            const payload = queue.shift() ??
+                (await new Promise((resolve) => {
+                    pendingNext = resolve;
+                }));
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- false positive since isDone is set to true in the abort handler
+            if (isDone)
+                break;
+            yield payload;
+        }
+    }
+    /**
+     * Emits an event with the given payload.
+     *
+     * @template K - The event name.
+     * @param eventName - Name of the event.
+     * @param payload - Payload for the event.
+     */
+    emit(eventName, payload) {
+        const listeners = this.listenerMap.get(eventName) ?? [];
+        for (const listener of listeners) {
+            listener(payload);
+        }
+    }
+    /**
+     * Removes all registered event listeners.
+     *
+     * Note: This is dangerous and should only be used in testing.
+     */
+    clearListeners() {
+        this.listenerMap.clear();
+        this.eventEmitterAbortController.abort();
+    }
+    /**
+     * Aborts the event emitter to terminate all async generator listeners.
+     */
+    abortEventEmitter() {
+        this.eventEmitterAbortController.abort();
+    }
+}
+/**
+ * Creates a typed event emitter that supports event listening and emitting.
+ *
+ * @template T - Mapping of event names to payload types.
+ * @returns An emitter with `on`, `emit`, and `clear` methods.
+ */
+export function createTypedEventEmitter() {
+    return new TypedEventEmitter();
+}
+//# sourceMappingURL=typed-event-emitter.js.map

package/dist/events/typed-event-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-event-emitter.js","sourceRoot":"","sources":["../../src/events/typed-event-emitter.ts"],"names":[],"mappings":"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"}

package/dist/field-map/field-map.d.ts

@@ -0,0 +1,118 @@
+export type FieldContainerDynamicSourceGetter = () => string | undefined;
+export interface FieldContainerOptions {
+    /**
+     * A function that returns the source of the value.
+     *
+     * @returns The source of the value, or undefined if the value is not set.
+     */
+    getDynamicSource?: FieldContainerDynamicSourceGetter;
+}
+/**
+ * Base field container interface
+ */
+export interface FieldContainer<T> {
+    getValue(): T;
+}
+/**
+ * Field container for a single value that cannot be overridden once set
+ */
+export declare class ScalarContainer<T> implements FieldContainer<T> {
+    private _value;
+    protected readonly defaultValue: T;
+    protected isSet: boolean;
+    protected setBySource: string | undefined;
+    protected getDynamicSource: FieldContainerDynamicSourceGetter | undefined;
+    constructor(defaultValue: T, options?: FieldContainerOptions);
+    getValue(): T;
+    set(value: T, source?: string): void;
+}
+export declare class ArrayContainer<T> implements FieldContainer<T[]> {
+    private readonly _stripDuplicates;
+    private _value;
+    constructor(initialValue?: T[], options?: {
+        stripDuplicates?: boolean;
+    });
+    push(...items: T[]): void;
+    getValue(): T[];
+}
+export declare class ObjectContainer<T extends Record<string, unknown>> implements FieldContainer<T> {
+    private readonly map;
+    protected getDynamicSource: FieldContainerDynamicSourceGetter | undefined;
+    constructor(initialValue: T, options?: FieldContainerOptions);
+    set(key: keyof T, value: T[keyof T], source?: string): void;
+    merge(value: Partial<T>, source?: string): void;
+    getValue(): T;
+}
+export declare class MapContainer<K extends string | number | symbol, V> implements FieldContainer<Map<K, V>> {
+    private readonly _value;
+    protected getDynamicSource: FieldContainerDynamicSourceGetter | undefined;
+    constructor(initialValue?: Map<K, V>, options?: FieldContainerOptions);
+    set(key: K, value: V, source?: string): void;
+    merge(value: Map<K, V>, source?: string): void;
+    mergeObj(value: Record<K, V>, source?: string): void;
+    getValue(): Map<K, V>;
+}
+/**
+ * Named field container
+ *
+ * This container stores objects that contains a name field that can be used for
+ * detecting duplicate names.
+ */
+export declare class NamedArrayFieldContainer<V extends {
+    name: string;
+}> implements FieldContainer<V[]> {
+    private readonly _value;
+    protected getDynamicSource: FieldContainerDynamicSourceGetter | undefined;
+    constructor(initialValue?: V[], options?: FieldContainerOptions);
+    add(value: V, source?: string): void;
+    addMany(values: V[], source?: string): void;
+    getValue(): V[];
+}
+export declare class MapOfMapsContainer<K1 extends string | number | symbol, K2 extends string | number | symbol, V> implements FieldContainer<Map<K1, Map<K2, V>>> {
+    private readonly _value;
+    protected getDynamicSource: FieldContainerDynamicSourceGetter | undefined;
+    constructor(initialValue?: Map<K1, Map<K2, V>>, options?: FieldContainerOptions);
+    set(key1: K1, key2: K2, value: V, source?: string): void;
+    merge(key1: K1, value: Map<K2, V>, source?: string): void;
+    mergeObj(key1: K1, value: Record<K2, V>, source?: string): void;
+    getValue(): Map<K1, Map<K2, V>>;
+}
+type InferFieldContainer<T> = T extends FieldContainer<infer U> ? U : never;
+export type FieldMapSchema = Record<string, FieldContainer<unknown>>;
+export type FieldMapValues<S extends FieldMapSchema> = {
+    [K in keyof S]: InferFieldContainer<S[K]>;
+};
+export type FieldMap<S extends FieldMapSchema> = S & {
+    getValues(): FieldMapValues<S>;
+};
+export declare class FieldMapSchemaBuilder {
+    options?: FieldContainerOptions | undefined;
+    constructor(options?: FieldContainerOptions | undefined);
+    scalar<T>(): ScalarContainer<T | undefined>;
+    scalar<T>(defaultValue: T): ScalarContainer<T>;
+    string(): ScalarContainer<string | undefined>;
+    string(defaultValue: string): ScalarContainer<string>;
+    number(): ScalarContainer<number | undefined>;
+    number(defaultValue: number): ScalarContainer<number>;
+    boolean(): ScalarContainer<boolean | undefined>;
+    boolean(defaultValue: boolean): ScalarContainer<boolean>;
+    array<T>(initialValue?: T[], options?: {
+        stripDuplicates?: boolean;
+    }): ArrayContainer<T>;
+    object<T extends Record<string, unknown>>(defaultValue: T): ObjectContainer<T>;
+    map<K extends string | number | symbol, V>(initialValue?: Map<K, V>): MapContainer<K, V>;
+    mapFromObj<V>(initialValue?: Record<string, V>): MapContainer<string, V>;
+    namedArray<V extends {
+        name: string;
+    }>(initialValue?: V[]): NamedArrayFieldContainer<V>;
+    mapOfMaps<K1 extends string | number | symbol, K2 extends string | number | symbol, V>(initialValue?: Map<K1, Map<K2, V>>): MapOfMapsContainer<K1, K2, V>;
+    mapOfMapsFromObj<K2 extends string | number | symbol, V>(initialValue?: Record<string, Record<K2, V>>): MapOfMapsContainer<string, K2, V>;
+}
+export declare function createFieldMapSchemaBuilder<T extends FieldMapSchema>(schemaBuilder: (t: FieldMapSchemaBuilder) => T): (t: FieldMapSchemaBuilder) => T;
+export type InferFieldMapSchemaFromBuilder<T extends (t: FieldMapSchemaBuilder) => FieldMapSchema> = T extends (t: FieldMapSchemaBuilder) => infer U ? U : never;
+/**
+ * Creates a field map with type-safe field definitions
+ */
+export declare function createFieldMap<S extends FieldMapSchema>(schemaBuilder: (t: FieldMapSchemaBuilder) => S, options?: FieldContainerOptions): FieldMap<S>;
+export {};
+//# sourceMappingURL=field-map.d.ts.map

package/dist/field-map/field-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-map.d.ts","sourceRoot":"","sources":["../../src/field-map/field-map.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iCAAiC,GAAG,MAAM,MAAM,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,iCAAiC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,IAAI,CAAC,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,cAAc,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,MAAM,CAAgB;IAC9B,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,SAAS,CAAC,KAAK,UAAS;IACxB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,SAAS,CAAC,gBAAgB,EAAE,iCAAiC,GAAG,SAAS,CAAC;gBAE9D,YAAY,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAK5D,QAAQ,IAAI,CAAC;IAIb,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;CAUrC;AAGD,qBAAa,cAAc,CAAC,CAAC,CAAE,YAAW,cAAc,CAAC,CAAC,EAAE,CAAC;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,MAAM,CAAM;gBAER,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE;IAKvE,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAezB,QAAQ,IAAI,CAAC,EAAE;CAGhB;AAED,qBAAa,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC5D,YAAW,cAAc,CAAC,CAAC,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAGlB;IACF,SAAS,CAAC,gBAAgB,EAAE,iCAAiC,GAAG,SAAS,CAAC;gBAE9D,YAAY,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAU5D,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAa3D,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAO/C,QAAQ,IAAI,CAAC;CAKd;AAGD,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAC7D,YAAW,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGrB;IACF,SAAS,CAAC,gBAAgB,EAAE,iCAAiC,GAAG,SAAS,CAAC;gBAE9D,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAWrE,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAa5C,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAO9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAOpD,QAAQ,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;CAKtB;AAED;;;;;GAKG;AACH,qBAAa,wBAAwB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAC9D,YAAW,cAAc,CAAC,CAAC,EAAE,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGrB;IACF,SAAS,CAAC,gBAAgB,EAAE,iCAAiC,GAAG,SAAS,CAAC;gBAE9D,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAW/D,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAapC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAM3C,QAAQ,IAAI,CAAC,EAAE;CAMhB;AAGD,qBAAa,kBAAkB,CAC7B,EAAE,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EACnC,EAAE,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EACnC,CAAC,CACD,YAAW,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAE9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAMrB;IACF,SAAS,CAAC,gBAAgB,EAAE,iCAAiC,GAAG,SAAS,CAAC;gBAGxE,YAAY,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAClC,OAAO,CAAC,EAAE,qBAAqB;IAoBjC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAiCxD,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAOzD,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAO/D,QAAQ,IAAI,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;CAahC;AAED,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAG5E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AAGrE,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,cAAc,IAAI;KACpD,CAAC,IAAI,MAAM,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC1C,CAAC;AAGF,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,cAAc,IAAI,CAAC,GAAG;IACnD,SAAS,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC;CAChC,CAAC;AAGF,qBAAa,qBAAqB;IACb,OAAO,CAAC,EAAE,qBAAqB;gBAA/B,OAAO,CAAC,EAAE,qBAAqB,YAAA;IAElD,MAAM,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,GAAG,SAAS,CAAC;IAC3C,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAK9C,MAAM,IAAI,eAAe,CAAC,MAAM,GAAG,SAAS,CAAC;IAC7C,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC;IAKrD,MAAM,IAAI,eAAe,CAAC,MAAM,GAAG,SAAS,CAAC;IAC7C,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC;IAKrD,OAAO,IAAI,eAAe,CAAC,OAAO,GAAG,SAAS,CAAC;IAC/C,OAAO,CAAC,YAAY,EAAE,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC;IAKxD,KAAK,CAAC,CAAC,EACL,YAAY,CAAC,EAAE,CAAC,EAAE,EAClB,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GACtC,cAAc,CAAC,CAAC,CAAC;IAIpB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,YAAY,EAAE,CAAC,GACd,eAAe,CAAC,CAAC,CAAC;IAIrB,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EACvC,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GACvB,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAIrB,UAAU,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAOxE,UAAU,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EACnC,YAAY,CAAC,EAAE,CAAC,EAAE,GACjB,wBAAwB,CAAC,CAAC,CAAC;IAI9B,SAAS,CACP,EAAE,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EACnC,EAAE,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EACnC,CAAC,EACD,YAAY,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAOpE,gBAAgB,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EACrD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAC3C,kBAAkB,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;CASrC;AAED,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,cAAc,EAClE,aAAa,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,CAAC,GAC7C,CAAC,CAAC,EAAE,qBAAqB,KAAK,CAAC,CAEjC;AAED,MAAM,MAAM,8BAA8B,CACxC,CAAC,SAAS,CAAC,CAAC,EAAE,qBAAqB,KAAK,cAAc,IACpD,CAAC,SAAS,CAAC,CAAC,EAAE,qBAAqB,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEhE;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,cAAc,EACrD,aAAa,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,CAAC,EAC9C,OAAO,CAAC,EAAE,qBAAqB,GAC9B,QAAQ,CAAC,CAAC,CAAC,CAiBb"}

package/dist/field-map/field-map.js

@@ -0,0 +1,287 @@
+import { sortBy } from 'es-toolkit';
+/**
+ * Field container for a single value that cannot be overridden once set
+ */
+export class ScalarContainer {
+    _value;
+    defaultValue;
+    isSet = false;
+    setBySource;
+    getDynamicSource;
+    constructor(defaultValue, options) {
+        this.defaultValue = defaultValue;
+        this.getDynamicSource = options?.getDynamicSource;
+    }
+    getValue() {
+        return this._value === undefined ? this.defaultValue : this._value;
+    }
+    set(value, source) {
+        if (this.isSet) {
+            throw new Error(`Value has already been set by ${this.setBySource} and cannot be overwritten by ${source}`);
+        }
+        this._value = value;
+        this.isSet = true;
+        this.setBySource = source ?? this.getDynamicSource?.() ?? 'unknown';
+    }
+}
+// Array field container
+export class ArrayContainer {
+    _stripDuplicates;
+    _value;
+    constructor(initialValue, options) {
+        this._stripDuplicates = options?.stripDuplicates ?? false;
+        this._value = initialValue ?? [];
+    }
+    push(...items) {
+        let currentValue = this._value;
+        if (this._stripDuplicates) {
+            // Add items without duplicates
+            const set = new Set([...currentValue, ...items]);
+            currentValue = [...set];
+        }
+        else {
+            // Add all items
+            currentValue = [...currentValue, ...items];
+        }
+        this._value = currentValue;
+    }
+    getValue() {
+        return this._value;
+    }
+}
+export class ObjectContainer {
+    map;
+    getDynamicSource;
+    constructor(initialValue, options) {
+        this.getDynamicSource = options?.getDynamicSource;
+        this.map = new Map(Object.entries(initialValue).map(([key, value]) => [
+            key,
+            { value, setBySource: this.getDynamicSource?.() },
+        ]));
+    }
+    set(key, value, source) {
+        const existingValue = this.map.get(key);
+        if (existingValue?.setBySource) {
+            throw new Error(`Value for key ${key} has already been set by ${existingValue.setBySource} and cannot be overwritten by ${source}`);
+        }
+        this.map.set(key, {
+            value,
+            setBySource: source ?? this.getDynamicSource?.(),
+        });
+    }
+    merge(value, source) {
+        const mergeSource = source ?? this.getDynamicSource?.();
+        for (const [key, val] of Object.entries(value)) {
+            this.set(key, val, mergeSource);
+        }
+    }
+    getValue() {
+        return Object.fromEntries([...this.map.entries()].map(([key, value]) => [key, value.value]));
+    }
+}
+// Map field container
+export class MapContainer {
+    _value;
+    getDynamicSource;
+    constructor(initialValue, options) {
+        this.getDynamicSource = options?.getDynamicSource;
+        const initialMap = initialValue ?? new Map();
+        this._value = new Map([...initialMap.entries()].map(([key, value]) => [
+            key,
+            { value, setBySource: this.getDynamicSource?.() },
+        ]));
+    }
+    set(key, value, source) {
+        const existingValue = this._value.get(key);
+        if (existingValue?.setBySource) {
+            throw new Error(`Value for key ${key} has already been set by ${existingValue.setBySource} and cannot be overwritten by ${source}`);
+        }
+        this._value.set(key, {
+            value,
+            setBySource: source ?? this.getDynamicSource?.(),
+        });
+    }
+    merge(value, source) {
+        const mergeSource = source ?? this.getDynamicSource?.();
+        for (const [key, val] of value.entries()) {
+            this.set(key, val, mergeSource);
+        }
+    }
+    mergeObj(value, source) {
+        const mergeSource = source ?? this.getDynamicSource?.();
+        for (const [key, val] of Object.entries(value)) {
+            this.set(key, val, mergeSource);
+        }
+    }
+    getValue() {
+        return new Map([...this._value.entries()].map(([key, value]) => [key, value.value]));
+    }
+}
+/**
+ * Named field container
+ *
+ * This container stores objects that contains a name field that can be used for
+ * detecting duplicate names.
+ */
+export class NamedArrayFieldContainer {
+    _value;
+    getDynamicSource;
+    constructor(initialValue, options) {
+        this.getDynamicSource = options?.getDynamicSource;
+        const value = initialValue ?? [];
+        this._value = new Map(value.map((val) => [
+            val.name,
+            { value: val, setBySource: this.getDynamicSource?.() },
+        ]));
+    }
+    add(value, source) {
+        const existingValue = this._value.get(value.name);
+        if (existingValue?.setBySource) {
+            throw new Error(`Value for name ${value.name} has already been set by ${existingValue.setBySource} and cannot be overwritten by ${source}`);
+        }
+        this._value.set(value.name, {
+            value,
+            setBySource: source ?? this.getDynamicSource?.(),
+        });
+    }
+    addMany(values, source) {
+        for (const value of values) {
+            this.add(value, source);
+        }
+    }
+    getValue() {
+        return sortBy([...this._value.values()].map((value) => value.value), [(v) => v.name]);
+    }
+}
+// Map of maps field container
+export class MapOfMapsContainer {
+    _value;
+    getDynamicSource;
+    constructor(initialValue, options) {
+        this.getDynamicSource = options?.getDynamicSource;
+        const initialMap = initialValue ?? new Map();
+        this._value = new Map([...initialMap.entries()].map(([key1, innerMap]) => [
+            key1,
+            {
+                value: new Map([...innerMap.entries()].map(([key2, value]) => [
+                    key2,
+                    { value, setBySource: this.getDynamicSource?.() },
+                ])),
+                setBySource: this.getDynamicSource?.(),
+            },
+        ]));
+    }
+    set(key1, key2, value, source) {
+        const existingOuterValue = this._value.get(key1);
+        const sourceToUse = source ?? this.getDynamicSource?.() ?? 'unknown';
+        // If the outer key doesn't exist yet, create a new map for it
+        if (!existingOuterValue) {
+            const newInnerMap = new Map();
+            newInnerMap.set(key2, { value, setBySource: sourceToUse });
+            this._value.set(key1, {
+                value: newInnerMap,
+                setBySource: sourceToUse,
+            });
+            return;
+        }
+        // Check if this specific key1+key2 combination has already been set
+        const existingInnerValue = existingOuterValue.value.get(key2);
+        if (existingInnerValue?.setBySource) {
+            throw new Error(`Value for keys ${key1}+${key2} has already been set by ${existingInnerValue.setBySource} and cannot be overwritten by ${sourceToUse}`);
+        }
+        // Add the new value to the existing inner map
+        existingOuterValue.value.set(key2, {
+            value,
+            setBySource: sourceToUse,
+        });
+    }
+    merge(key1, value, source) {
+        const mergeSource = source ?? this.getDynamicSource?.() ?? 'unknown';
+        for (const [key2, val] of value.entries()) {
+            this.set(key1, key2, val, mergeSource);
+        }
+    }
+    mergeObj(key1, value, source) {
+        const mergeSource = source ?? this.getDynamicSource?.() ?? 'unknown';
+        for (const [key2, val] of Object.entries(value)) {
+            this.set(key1, key2, val, mergeSource);
+        }
+    }
+    getValue() {
+        return new Map([...this._value.entries()].map(([key1, outerValue]) => [
+            key1,
+            new Map([...outerValue.value.entries()].map(([key2, innerValue]) => [
+                key2,
+                innerValue.value,
+            ])),
+        ]));
+    }
+}
+// Schema builder class
+export class FieldMapSchemaBuilder {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    scalar(defaultValue) {
+        return new ScalarContainer(defaultValue, this.options);
+    }
+    string(defaultValue) {
+        return new ScalarContainer(defaultValue, this.options);
+    }
+    number(defaultValue) {
+        return new ScalarContainer(defaultValue, this.options);
+    }
+    boolean(defaultValue) {
+        return new ScalarContainer(defaultValue, this.options);
+    }
+    array(initialValue, options) {
+        return new ArrayContainer(initialValue, options);
+    }
+    object(defaultValue) {
+        return new ObjectContainer(defaultValue, this.options);
+    }
+    map(initialValue) {
+        return new MapContainer(initialValue ?? new Map(), this.options);
+    }
+    mapFromObj(initialValue) {
+        return new MapContainer(new Map(Object.entries(initialValue ?? {})), this.options);
+    }
+    namedArray(initialValue) {
+        return new NamedArrayFieldContainer(initialValue, this.options);
+    }
+    mapOfMaps(initialValue) {
+        return new MapOfMapsContainer(initialValue ?? new Map(), this.options);
+    }
+    mapOfMapsFromObj(initialValue) {
+        const map = new Map();
+        if (initialValue) {
+            for (const [key1, innerObj] of Object.entries(initialValue)) {
+                map.set(key1, new Map(Object.entries(innerObj)));
+            }
+        }
+        return new MapOfMapsContainer(map, this.options);
+    }
+}
+export function createFieldMapSchemaBuilder(schemaBuilder) {
+    return schemaBuilder;
+}
+/**
+ * Creates a field map with type-safe field definitions
+ */
+export function createFieldMap(schemaBuilder, options) {
+    const schema = schemaBuilder(new FieldMapSchemaBuilder(options));
+    // Add getValues method
+    return {
+        ...schema,
+        getValues: () => {
+            const values = {};
+            for (const key of Object.keys(schema)) {
+                const container = schema[key];
+                values[key] = container.getValue();
+            }
+            return values;
+        },
+    };
+}
+//# sourceMappingURL=field-map.js.map

package/dist/field-map/field-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-map.js","sourceRoot":"","sources":["../../src/field-map/field-map.ts"],"names":[],"mappings":"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"}

package/dist/field-map/index.d.ts

@@ -0,0 +1,2 @@
+export * from './field-map.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/field-map/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/field-map/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/field-map/index.js

@@ -0,0 +1,2 @@
+export * from './field-map.js';
+//# sourceMappingURL=index.js.map

package/dist/field-map/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/field-map/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/fs/dir-exists.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Checks if a directory exists
+ * @param filePath - The path to the directory
+ * @returns True if the directory exists, false otherwise
+ */
+export declare function dirExists(filePath: string): Promise<boolean>;
+//# sourceMappingURL=dir-exists.d.ts.map

package/dist/fs/dir-exists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dir-exists.d.ts","sourceRoot":"","sources":["../../src/fs/dir-exists.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIlE"}

package/dist/fs/dir-exists.js

@@ -0,0 +1,12 @@
+import { stat } from 'node:fs/promises';
+/**
+ * Checks if a directory exists
+ * @param filePath - The path to the directory
+ * @returns True if the directory exists, false otherwise
+ */
+export async function dirExists(filePath) {
+    return stat(filePath)
+        .then((file) => file.isDirectory())
+        .catch(() => false);
+}
+//# sourceMappingURL=dir-exists.js.map

package/dist/fs/dir-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dir-exists.js","sourceRoot":"","sources":["../../src/fs/dir-exists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB;IAC9C,OAAO,IAAI,CAAC,QAAQ,CAAC;SAClB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;SAClC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC"}

package/dist/fs/ensure-dir.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Ensures a directory exists, creating it recursively if it doesn't
+ * @param directoryPath - The path to the directory
+ */
+export declare function ensureDir(directoryPath: string): Promise<void>;
+//# sourceMappingURL=ensure-dir.d.ts.map

package/dist/fs/ensure-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-dir.d.ts","sourceRoot":"","sources":["../../src/fs/ensure-dir.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAsB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE"}

package/dist/fs/ensure-dir.js

@@ -0,0 +1,9 @@
+import { mkdir } from 'node:fs/promises';
+/**
+ * Ensures a directory exists, creating it recursively if it doesn't
+ * @param directoryPath - The path to the directory
+ */
+export async function ensureDir(directoryPath) {
+    await mkdir(directoryPath, { recursive: true });
+}
+//# sourceMappingURL=ensure-dir.js.map

package/dist/fs/ensure-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-dir.js","sourceRoot":"","sources":["../../src/fs/ensure-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,aAAqB;IACnD,MAAM,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/fs/file-exists.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Checks if a file exists and is a file
+ * @param filePath - The path to the file
+ * @returns True if the file exists and is a file, false otherwise
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+//# sourceMappingURL=file-exists.d.ts.map

package/dist/fs/file-exists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-exists.d.ts","sourceRoot":"","sources":["../../src/fs/file-exists.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAInE"}