@jondotsoy/configs 0.1.0

package/dist/types/schema.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/source.d.ts

@@ -0,0 +1,19 @@
+/** Passed to `start()`, mirroring a `ReadableStreamDefaultController`. */
+export interface SourceControl<T> {
+    /** Publishes a new full-tree snapshot. */
+    set(value: T): void;
+    /** Marks the source as done; no further `set()` calls are expected. */
+    close(): void;
+}
+/** The object passed to `new Source(...)`, mirroring an `UnderlyingSource` for `ReadableStream`. */
+export interface UnderlyingSource<T> {
+    start(control: SourceControl<T>): void | Promise<void>;
+    close?(): void | Promise<void>;
+    /**
+     * When present, every `control.set(incoming)` call runs `incoming` through `reduce` (along with
+     * the last published value, `null` before the first `set()`) instead of publishing it as-is —
+     * so a source that only ever hands `start()` a partial patch, like an SSE message, can publish
+     * the merged result without keeping its own accumulator variable around.
+     */
+    reduce?(incoming: T, previous: T | null): T;
+}

package/dist/utils/data-types.d.ts

@@ -0,0 +1,20 @@
+export interface DataType<T> {
+    from(value: unknown): T;
+}
+declare const dataTypesRegistry: {
+    number: DataType<number>;
+    string: DataType<string>;
+    boolean: DataType<boolean>;
+    list: DataType<string[]>;
+};
+export type DataTypeName = keyof typeof dataTypesRegistry;
+/** Looks up a converter by name (e.g. from a schema's `field.type`); an unknown name throws. */
+declare function factory(type: string): (typeof dataTypesRegistry)[DataTypeName];
+export declare const DataTypes: {
+    factory: typeof factory;
+    number: DataType<number>;
+    string: DataType<string>;
+    boolean: DataType<boolean>;
+    list: DataType<string[]>;
+};
+export {};

package/dist/utils/dotenv.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Parses dotenv-formatted text (`KEY=VALUE` lines) into a flat string map, following
+ * motdotla/dotenv's syntax (the reference implementation dotenv.org points to). Tolerates
+ * whitespace around `=` (`FOO = bar`, `FOO= bar`, `FOO=bar`), a single-, double-, or
+ * backtick-quoted value (quotes stripped; `\n`/`\r` expand to real newline/carriage-return
+ * characters, but only inside double quotes), and a trailing `# comment` on an unquoted value.
+ * Blank lines, whole-line `#` comments, and a line with no `=` are skipped.
+ */
+declare function parse(text: string): Record<string, string>;
+export declare const DotEnv: {
+    parse: typeof parse;
+};
+export {};

package/dist/utils/store.d.ts

@@ -0,0 +1,44 @@
+/** Return `Unsubscribe` for cleanup run when this subscriber unsubscribes; any other return value is ignored. */
+export type Subscriber<T> = (value: T) => unknown;
+export type Unsubscribe = () => void;
+export type EventListener = () => void;
+export declare class Store<T> {
+    private value;
+    private readonly subscribers;
+    private readonly cleanups;
+    private readonly mountListeners;
+    private readonly unmountListeners;
+    constructor(initial: T);
+    get(): T;
+    set(next: T): void;
+    /** Calls `subscriber` immediately with the current value, then on every subsequent `set`. */
+    subscribe(subscriber: Subscriber<T>): Unsubscribe;
+    /** Calls `subscriber` only on subsequent `set` calls, not with the current value. */
+    listen(subscriber: Subscriber<T>): Unsubscribe;
+    /** Runs `subscriber` and stores its returned cleanup, if any, to run on unsubscribe. */
+    private runSubscriber;
+    /** Fires once a first subscriber is registered (via `subscribe` or `listen`). */
+    private onMount;
+    /** Fires once the last subscriber is removed. */
+    private onUnmount;
+    private addSubscriber;
+    private removeSubscriber;
+    /**
+     * Runs `callback` on mount; if it returns a function, that function runs on unmount.
+     * Returns an unsubscribe that tears down the wiring (running any pending cleanup first).
+     */
+    static onMount<T>(store: Store<T>, callback: () => void | Unsubscribe): Unsubscribe;
+}
+declare function create<T>(initial: T): Store<T>;
+/**
+ * Derives a read-through `Store<R>` from `source` via `selector`. It only subscribes to
+ * `source` while it has subscribers of its own, so mounting/unmounting the computed store
+ * mounts/unmounts `source` in turn.
+ */
+declare function computed<T, R>(source: Store<T>, selector: (value: T) => R): Store<R>;
+export declare const store: {
+    create: typeof create;
+    computed: typeof computed;
+    onMount: typeof Store.onMount;
+};
+export default store;

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@jondotsoy/configs",
+  "version": "0.1.0",
+  "description": "A reactive, typed configuration library backed by pluggable sources (env, fetch, sse, file, literal).",
+  "keywords": [
+    "config",
+    "configuration",
+    "env",
+    "environment-variables",
+    "reactive",
+    "typescript",
+    "source",
+    "sse",
+    "fetch",
+    "file",
+    "json",
+    "dotenv"
+  ],
+  "module": "src/configs.ts",
+  "type": "module",
+  "sideEffects": false,
+  "license": "MIT",
+  "author": {
+    "name": "Jonathan Delgado",
+    "email": "hi@jon.soy",
+    "url": "https://jon.soy"
+  },
+  "homepage": "https://github.com/JonDotsoy/configs#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JonDotsoy/configs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/JonDotsoy/configs/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "_entryPoint": "./src/configs.ts",
+      "types": "./dist/configs.d.ts",
+      "import": "./dist/configs.js"
+    },
+    "./sources/env": {
+      "_entryPoint": "./src/sources/env.ts",
+      "types": "./dist/sources/env.d.ts",
+      "import": "./dist/sources/env.js"
+    },
+    "./sources/fetch": {
+      "_entryPoint": "./src/sources/fetch.ts",
+      "types": "./dist/sources/fetch.d.ts",
+      "import": "./dist/sources/fetch.js"
+    },
+    "./sources/sse": {
+      "_entryPoint": "./src/sources/sse.ts",
+      "types": "./dist/sources/sse.d.ts",
+      "import": "./dist/sources/sse.js"
+    },
+    "./sources/file": {
+      "_entryPoint": "./src/sources/file.ts",
+      "types": "./dist/sources/file.d.ts",
+      "import": "./dist/sources/file.js"
+    },
+    "./sources/literal": {
+      "_entryPoint": "./src/sources/literal.ts",
+      "types": "./dist/sources/literal.d.ts",
+      "import": "./dist/sources/literal.js"
+    }
+  },
+  "scripts": {
+    "build": "bash scripts/build.sh",
+    "build:types": "tsc -p tsconfig.build.json",
+    "test:pack": "bun run scripts/manual-pack-test.ts",
+    "test:integration": "bun test ./test/integration/runtime-imports.ts"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}