@walkeros/core 4.4.0-next-1785261149472 → 4.4.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @walkeros/core
 
-## 4.4.0-next-1785261149472
+## 4.4.0
 
 ### Minor Changes
 
@@ -11,6 +11,19 @@
   `parentEventId`, instead of folding them into a single row. A new optional
   `unattributed` summary reports records the assembly could not attribute to any
   event instead of dropping them silently.
+- 034b1de: Events pushed before the collector runs are now held and replayed at
+  run instead of being dropped, bounded by `queueMax`. `walker init <element>`
+  re-fires load triggers for already-tracked elements, restoring the SPA re-init
+  pattern. Queue sources start consuming at run and no longer acknowledge
+  messages the pipeline did not accept.
+- d00e2bd: A source's `env` is now unambiguously the author's dependency bag:
+  the collector-provided `push`, `elb`, `command`, `logger` and `sources` always
+  win, so setting them in `env` has no effect. Sources that need the pipeline to
+  end elsewhere declare the new `terminus`, which receives the raw event and
+  skips the pipeline entirely; previously an `env.push` silently replaced the
+  pipeline's end and disabled some, but not all, of its stages, and flows that
+  set it should move to `terminus`. Stored flows now also reject unknown keys on
+  a source entry at validation instead of silently ignoring them.
 
 ### Patch Changes
 

package/dist/dev.d.mts

@@ -3867,12 +3867,15 @@ declare namespace collector {
  * - sources: Other registered sources
  * - elb: Public API function (alias for collector.push)
  *
- * Platform-specific sources extend this with their requirements
- * (e.g., window, document, fetch, req, res)
+ * The capability keys above (plus logger) are runtime-owned: the collector
+ * applies them last, so author values for them are ignored. Platform-specific
+ * sources extend the env with their own requirements (e.g., window, document,
+ * fetch, req, res), and those author dependencies pass through untouched.
  *
  * This makes sources:
  * - Platform-agnostic (no direct dependencies)
- * - Testable (mock env for tests)
+ * - Testable (mock author dependencies via env; mock the collector boundary
+ *   via a hand-built Context or InitSource.terminus)
  * - Composable (share env between sources)
  */
 declare const BaseEnvSchema: z.ZodObject<{
@@ -5112,7 +5115,7 @@ declare const SourceSchema: z.ZodObject<{
             update: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 /**
  * Transformer reference schema (Flow.Transformer).
  */
@@ -5419,7 +5422,7 @@ declare const FlowSchema: z.ZodObject<{
                 update: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
-    }, z.core.$strip>>>;
+    }, z.core.$strict>>>;
     destinations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         package: z.ZodOptional<z.ZodString>;
         code: z.ZodOptional<z.ZodObject<{
@@ -5643,7 +5646,7 @@ declare const JsonSchema$1: z.ZodObject<{
                     update: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
-        }, z.core.$strip>>>;
+        }, z.core.$strict>>>;
         destinations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             package: z.ZodOptional<z.ZodString>;
             code: z.ZodOptional<z.ZodObject<{
@@ -6278,7 +6281,7 @@ declare const configJsonSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<
                     update: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
-        }, z.core.$strip>>>;
+        }, z.core.$strict>>>;
         destinations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             package: z.ZodOptional<z.ZodString>;
             code: z.ZodOptional<z.ZodObject<{
@@ -7796,6 +7799,15 @@ interface Instance$5 {
     logger: Instance$3;
     on: OnConfig;
     queue: Events;
+    /**
+     * Events pushed while `allowed === false`, held raw (pre-pipeline) and
+     * replayed FIFO by the run command. Bounded by `config.queueMax`
+     * (drop-oldest). RECORD-immediate/DELIVER-gated, extended to events.
+     */
+    preRunQueue: Array<{
+        event: DeepPartialEvent;
+        options: PushOptions;
+    }>;
     round: number;
     /** Run-scoped W3C trace id, minted on each run and stamped onto events. */
     trace?: string;
@@ -8665,8 +8677,12 @@ interface InitTransformers {
 /**
  * Base Env interface for dependency injection into sources.
  *
- * Sources receive all their dependencies through this environment object,
- * making them platform-agnostic and easily testable.
+ * `env` is the author's dependency bag: platform and vendor dependencies are
+ * injected here, making sources platform-agnostic. The five capabilities the
+ * collector provides (`push`, `command`, `sources`, `elb`, `logger`) are
+ * runtime-owned and applied last, so author values for them are ignored. To
+ * mock the collector boundary in a test, call the factory directly with a
+ * hand-built `Context`, or declare `InitSource.terminus`.
  */
 interface BaseEnv$1 {
     [key: string]: unknown;
@@ -8862,6 +8878,21 @@ type InitSource<T extends TypesGeneric$1 = Types$1> = {
     primary?: boolean;
     next?: Route;
     before?: Route;
+    /**
+     * Replace the collector at the END of this source's pipeline.
+     *
+     * A terminus receives the event exactly as the source emitted it and the
+     * entire pipeline is skipped: no `before`/`next` chains, no source `cache`,
+     * no `state`, no `mapping`, no minted span id, no per-source ingest, no
+     * `respond`, no `status.sources` counting and no observability records.
+     *
+     * This is a TOTAL bypass, deliberately, so there is one thing to know rather
+     * than a list of exceptions. It exists for deterministic capture at the
+     * source→collector boundary (step examples, dev tooling). Production flows
+     * leave it unset. Runtime-only: stored-flow validation rejects unknown
+     * source keys, so a persisted flow cannot carry it.
+     */
+    terminus?: PushFn$1;
     cache?: Cache;
     state?: State | State[];
 };

package/dist/dev.d.ts

@@ -3867,12 +3867,15 @@ declare namespace collector {
  * - sources: Other registered sources
  * - elb: Public API function (alias for collector.push)
  *
- * Platform-specific sources extend this with their requirements
- * (e.g., window, document, fetch, req, res)
+ * The capability keys above (plus logger) are runtime-owned: the collector
+ * applies them last, so author values for them are ignored. Platform-specific
+ * sources extend the env with their own requirements (e.g., window, document,
+ * fetch, req, res), and those author dependencies pass through untouched.
  *
  * This makes sources:
  * - Platform-agnostic (no direct dependencies)
- * - Testable (mock env for tests)
+ * - Testable (mock author dependencies via env; mock the collector boundary
+ *   via a hand-built Context or InitSource.terminus)
  * - Composable (share env between sources)
  */
 declare const BaseEnvSchema: z.ZodObject<{
@@ -5112,7 +5115,7 @@ declare const SourceSchema: z.ZodObject<{
             update: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 /**
  * Transformer reference schema (Flow.Transformer).
  */
@@ -5419,7 +5422,7 @@ declare const FlowSchema: z.ZodObject<{
                 update: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
-    }, z.core.$strip>>>;
+    }, z.core.$strict>>>;
     destinations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         package: z.ZodOptional<z.ZodString>;
         code: z.ZodOptional<z.ZodObject<{
@@ -5643,7 +5646,7 @@ declare const JsonSchema$1: z.ZodObject<{
                     update: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
-        }, z.core.$strip>>>;
+        }, z.core.$strict>>>;
         destinations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             package: z.ZodOptional<z.ZodString>;
             code: z.ZodOptional<z.ZodObject<{
@@ -6278,7 +6281,7 @@ declare const configJsonSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<
                     update: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
-        }, z.core.$strip>>>;
+        }, z.core.$strict>>>;
         destinations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             package: z.ZodOptional<z.ZodString>;
             code: z.ZodOptional<z.ZodObject<{
@@ -7796,6 +7799,15 @@ interface Instance$5 {
     logger: Instance$3;
     on: OnConfig;
     queue: Events;
+    /**
+     * Events pushed while `allowed === false`, held raw (pre-pipeline) and
+     * replayed FIFO by the run command. Bounded by `config.queueMax`
+     * (drop-oldest). RECORD-immediate/DELIVER-gated, extended to events.
+     */
+    preRunQueue: Array<{
+        event: DeepPartialEvent;
+        options: PushOptions;
+    }>;
     round: number;
     /** Run-scoped W3C trace id, minted on each run and stamped onto events. */
     trace?: string;
@@ -8665,8 +8677,12 @@ interface InitTransformers {
 /**
  * Base Env interface for dependency injection into sources.
  *
- * Sources receive all their dependencies through this environment object,
- * making them platform-agnostic and easily testable.
+ * `env` is the author's dependency bag: platform and vendor dependencies are
+ * injected here, making sources platform-agnostic. The five capabilities the
+ * collector provides (`push`, `command`, `sources`, `elb`, `logger`) are
+ * runtime-owned and applied last, so author values for them are ignored. To
+ * mock the collector boundary in a test, call the factory directly with a
+ * hand-built `Context`, or declare `InitSource.terminus`.
  */
 interface BaseEnv$1 {
     [key: string]: unknown;
@@ -8862,6 +8878,21 @@ type InitSource<T extends TypesGeneric$1 = Types$1> = {
     primary?: boolean;
     next?: Route;
     before?: Route;
+    /**
+     * Replace the collector at the END of this source's pipeline.
+     *
+     * A terminus receives the event exactly as the source emitted it and the
+     * entire pipeline is skipped: no `before`/`next` chains, no source `cache`,
+     * no `state`, no `mapping`, no minted span id, no per-source ingest, no
+     * `respond`, no `status.sources` counting and no observability records.
+     *
+     * This is a TOTAL bypass, deliberately, so there is one thing to know rather
+     * than a list of exceptions. It exists for deterministic capture at the
+     * source→collector boundary (step examples, dev tooling). Production flows
+     * leave it unset. Runtime-only: stored-flow validation rejects unknown
+     * source keys, so a persisted flow cannot carry it.
+     */
+    terminus?: PushFn$1;
     cache?: Cache;
     state?: State | State[];
 };