@kronos-ts/app 0.1.0

package/dist/slot-registry.js

@@ -0,0 +1,50 @@
+/**
+ * Normalize a factory-or-instance argument into a SlotFactory.
+ * SLT-03: plain instances (non-function values) become `() => instance` internally.
+ */
+function normalizeFactory(factoryOrInstance) {
+    if (typeof factoryOrInstance === "function") {
+        return factoryOrInstance;
+    }
+    const instance = factoryOrInstance;
+    return () => instance;
+}
+/**
+ * SlotRegistry — the storage backing the App's three verbs.
+ * setDefault: ifAbsent (no-op if occupied)
+ * set:        warn on double-set
+ * forceSet:   silent overwrite
+ * (DESIGN.md §6, REQUIREMENTS.md SLT-02.)
+ */
+export class SlotRegistry {
+    slots = new Map();
+    setDefault(slot, factoryOrInstance, meta) {
+        if (this.slots.has(slot))
+            return;
+        this.slots.set(slot, { factory: normalizeFactory(factoryOrInstance), meta });
+    }
+    set(slot, factoryOrInstance) {
+        const existing = this.slots.get(slot);
+        // Provenance check: setDefault always writes a `meta` key (even when its value
+        // is undefined for stateless defaults like serializer / unitOfWorkFactory / tagResolver);
+        // set / forceSet never write the key at all. So `"meta" in existing` identifies a prior
+        // setDefault — those overrides are the expected "extension overrides in-memory default" path
+        // and should NOT warn. Genuine collisions (two set/forceSet calls on the same slot) DO warn.
+        if (existing && !("meta" in existing)) {
+            console.warn(`[kronos] slot "${slot}" override: already set. Use forceSet() to suppress this warning.`);
+        }
+        this.slots.set(slot, { factory: normalizeFactory(factoryOrInstance) });
+    }
+    forceSet(slot, factoryOrInstance) {
+        this.slots.set(slot, { factory: normalizeFactory(factoryOrInstance) });
+    }
+    /** @internal — used by buildResolved and by Plan 02's warning emitter. */
+    getEntry(slot) {
+        return this.slots.get(slot);
+    }
+    /** @internal — used by Plan 02 to iterate registered slots for startup warnings. */
+    has(slot) {
+        return this.slots.has(slot);
+    }
+}
+//# sourceMappingURL=slot-registry.js.map

package/dist/slot-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-registry.js","sourceRoot":"","sources":["../src/slot-registry.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,SAAS,gBAAgB,CACvB,iBAAuD;IAEvD,IAAI,OAAO,iBAAiB,KAAK,UAAU,EAAE,CAAC;QAC5C,OAAO,iBAAmC,CAAA;IAC5C,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAA;IAClC,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAA;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAA;IAEvD,UAAU,CACR,IAAO,EACP,iBAAuD,EACvD,IAAe;QAEf,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAM;QAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,gBAAgB,CAAC,iBAAiB,CAA0B,EAAE,IAAI,EAAE,CAAC,CAAA;IACvG,CAAC;IAED,GAAG,CACD,IAAO,EACP,iBAAuD;QAEvD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACrC,+EAA+E;QAC/E,0FAA0F;QAC1F,wFAAwF;QACxF,6FAA6F;QAC7F,6FAA6F;QAC7F,IAAI,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CACV,kBAAkB,IAAI,mEAAmE,CAC1F,CAAA;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,gBAAgB,CAAC,iBAAiB,CAA0B,EAAE,CAAC,CAAA;IACjG,CAAC;IAED,QAAQ,CACN,IAAO,EACP,iBAAuD;QAEvD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,gBAAgB,CAAC,iBAAiB,CAA0B,EAAE,CAAC,CAAA;IACjG,CAAC;IAED,0EAA0E;IAC1E,QAAQ,CAAqB,IAAO;QAClC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAA6B,CAAA;IACzD,CAAC;IAED,oFAAoF;IACpF,GAAG,CAAC,IAAc;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;CACF"}

package/dist/warnings.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Smallest viable logger interface (D-51) — just `warn(msg: string)`.
+ * Phase 5 only emits startup warnings for in-memory defaults; richer levels
+ * are intentionally NOT in scope.
+ */
+export interface WarningLogger {
+    warn(msg: string): void;
+}
+export interface WarningChannelOptions {
+    /** When true, suppress all warnings (kronos({ quiet: true })). */
+    quiet?: boolean;
+    /** When set, route warnings here instead of console.warn. `quiet` takes precedence over `logger`. */
+    logger?: WarningLogger;
+}
+export interface WarningChannel {
+    emit(msg: string): void;
+}
+export declare function createWarningChannel(options?: WarningChannelOptions): WarningChannel;
+//# sourceMappingURL=warnings.d.ts.map

package/dist/warnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../src/warnings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,qGAAqG;IACrG,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAWxF"}

package/dist/warnings.js

@@ -0,0 +1,14 @@
+export function createWarningChannel(options = {}) {
+    return {
+        emit(msg) {
+            if (options.quiet)
+                return;
+            if (options.logger) {
+                options.logger.warn(msg);
+                return;
+            }
+            console.warn(msg);
+        },
+    };
+}
+//# sourceMappingURL=warnings.js.map

package/dist/warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.js","sourceRoot":"","sources":["../src/warnings.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,oBAAoB,CAAC,UAAiC,EAAE;IACtE,OAAO;QACL,IAAI,CAAC,GAAW;YACd,IAAI,OAAO,CAAC,KAAK;gBAAE,OAAM;YACzB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACxB,OAAM;YACR,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACnB,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@kronos-ts/app",
+  "version": "0.1.0",
+  "description": "Application container for Kronos — the kronos() builder, lifecycle, and extensions.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "author": "Theo Emanuelsson",
+  "homepage": "https://github.com/KronosDB/kronos-ts/tree/main/packages/app#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KronosDB/kronos-ts.git",
+    "directory": "packages/app"
+  },
+  "bugs": {
+    "url": "https://github.com/KronosDB/kronos-ts/issues"
+  },
+  "keywords": [
+    "kronos",
+    "event-sourcing",
+    "cqrs",
+    "dcb",
+    "typescript"
+  ],
+  "sideEffects": false,
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/__tests__",
+    "!src/**/*.test.ts",
+    "!src/**/*.bench.ts"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "dependencies": {
+    "@kronos-ts/common": "workspace:*",
+    "@kronos-ts/messaging": "workspace:*",
+    "@kronos-ts/eventsourcing": "workspace:*",
+    "@kronos-ts/modelling": "workspace:*",
+    "zod": "^4.3.6"
+  }
+}