@holonograph/client 0.3.0 → 0.4.0

package/dist/index.js

@@ -4769,7 +4769,9 @@ var EvaluationEventKindSchema = external_exports.enum([
 
  "analysis.conformance-fixture",
 
- "analysis.emission-coverage"
+ "analysis.emission-coverage",
+
+ "analysis.delivery-orphan"
 ]);
 var AvailabilityTransitionDirectionSchema = external_exports.enum([
  "reachable->unreachable",
@@ -4957,6 +4959,16 @@ var EmissionCoverageSchema = external_exports.object({
 
  observedAtMs: external_exports.number().int().nonnegative()
 });
+var DeliveryOrphanSchema = external_exports.object({
+
+ darkEventId: external_exports.string().min(1),
+
+ emissionStreamId: external_exports.string().min(1),
+
+ surfaceId: external_exports.string().min(1),
+
+ witnessedAtMs: external_exports.number().int().nonnegative()
+});
 var EvaluationEventSchema = external_exports.object({
 
  eventId: external_exports.string().min(1),
@@ -4967,6 +4979,8 @@ var EvaluationEventSchema = external_exports.object({
 
  correlationId: CorrelationIdSchema,
 
+ emissionStreamId: external_exports.string().min(1).optional(),
+
  lensVersion: external_exports.string().min(1),
 
  kind: EvaluationEventKindSchema.default("evaluation"),
@@ -4989,34 +5003,39 @@ var EvaluationEventSchema = external_exports.object({
 
  conformanceFixtureRecord: ConformanceFixtureRecordSchema.optional(),
 
- emissionCoverage: EmissionCoverageSchema.optional()
+ emissionCoverage: EmissionCoverageSchema.optional(),
+
+ deliveryOrphan: DeliveryOrphanSchema.optional()
 }).refine(
  (e) => {
  if (e.kind === "evaluation") {
- return e.light !== void 0 && e.substrate !== void 0 && e.surface !== void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0 && e.emissionCoverage === void 0;
+ return e.light !== void 0 && e.substrate !== void 0 && e.surface !== void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0 && e.emissionCoverage === void 0 && e.deliveryOrphan === void 0;
  }
  if (e.kind === "availability.transition") {
- return e.availability !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0 && e.emissionCoverage === void 0;
+ return e.availability !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0 && e.emissionCoverage === void 0 && e.deliveryOrphan === void 0;
  }
  if (e.kind === "analysis.noise-floor-calibration") {
- return e.noiseFloorCalibration !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0 && e.emissionCoverage === void 0;
+ return e.noiseFloorCalibration !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0 && e.emissionCoverage === void 0 && e.deliveryOrphan === void 0;
  }
  if (e.kind === "analysis.variance-decomposition") {
- return e.varianceDecomposition !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0 && e.emissionCoverage === void 0;
+ return e.varianceDecomposition !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0 && e.emissionCoverage === void 0 && e.deliveryOrphan === void 0;
  }
  if (e.kind === "analysis.lifecycle-transition") {
- return e.lifecycleTransition !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0 && e.emissionCoverage === void 0;
+ return e.lifecycleTransition !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0 && e.emissionCoverage === void 0 && e.deliveryOrphan === void 0;
  }
  if (e.kind === "analysis.eval-recommendation") {
- return e.evalRecommendation !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.conformanceFixtureRecord === void 0 && e.emissionCoverage === void 0;
+ return e.evalRecommendation !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.conformanceFixtureRecord === void 0 && e.emissionCoverage === void 0 && e.deliveryOrphan === void 0;
  }
  if (e.kind === "analysis.conformance-fixture") {
- return e.conformanceFixtureRecord !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.emissionCoverage === void 0;
+ return e.conformanceFixtureRecord !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.emissionCoverage === void 0 && e.deliveryOrphan === void 0;
+ }
+ if (e.kind === "analysis.emission-coverage") {
+ return e.emissionCoverage !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0 && e.deliveryOrphan === void 0;
  }
- return e.emissionCoverage !== void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0;
+ return e.deliveryOrphan !== void 0 && e.emissionCoverage === void 0 && e.light === void 0 && e.substrate === void 0 && e.surface === void 0 && e.availability === void 0 && e.noiseFloorCalibration === void 0 && e.varianceDecomposition === void 0 && e.lifecycleTransition === void 0 && e.evalRecommendation === void 0 && e.conformanceFixtureRecord === void 0;
  },
  {
- message: "EvaluationEvent shape invariant: each kind requires exactly its corresponding payload and forbids the others. kind='evaluation' \u2192 light+substrate+surface; kind='availability.transition' \u2192 availability; kind='analysis.noise-floor-calibration' \u2192 noiseFloorCalibration; kind='analysis.variance-decomposition' \u2192 varianceDecomposition; kind='analysis.lifecycle-transition' \u2192 lifecycleTransition; kind='analysis.eval-recommendation' \u2192 evalRecommendation; kind='analysis.conformance-fixture' \u2192 conformanceFixtureRecord; kind='analysis.emission-coverage' \u2192 emissionCoverage."
+ message: "EvaluationEvent shape invariant: each kind requires exactly its corresponding payload and forbids the others. kind='evaluation' \u2192 light+substrate+surface; kind='availability.transition' \u2192 availability; kind='analysis.noise-floor-calibration' \u2192 noiseFloorCalibration; kind='analysis.variance-decomposition' \u2192 varianceDecomposition; kind='analysis.lifecycle-transition' \u2192 lifecycleTransition; kind='analysis.eval-recommendation' \u2192 evalRecommendation; kind='analysis.conformance-fixture' \u2192 conformanceFixtureRecord; kind='analysis.emission-coverage' \u2192 emissionCoverage; kind='analysis.delivery-orphan' \u2192 deliveryOrphan."
  }
 );
 function newEventId(occurredAt = new Date()) {
@@ -5527,6 +5546,8 @@ var EvaluationEventEmitter = class {
 
  lastSeq = -1;
 
+ emitsSentinels;
+
  inFlight = null;
  stopped = false;
  constructor(opts) {
@@ -5538,6 +5559,7 @@ var EvaluationEventEmitter = class {
  this.sentinelTargets = this.flushTargets.filter((t) => typeof t.emitSentinel === "function");
  this.now = opts.now ?? Date.now;
  this.streamId = opts.streamId ?? generateStreamId(this.now());
+ this.emitsSentinels = opts.deployment !== "serverless";
  this.onFlushError = opts.onFlushError ?? ((error) => {
  console.warn("[holonograph] emit flush error:", error);
  });
@@ -5554,9 +5576,10 @@ var EvaluationEventEmitter = class {
  this.stopInterval = schedule(() => {
  this.tick();
  }, opts.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS);
- this.stopSentinelInterval = schedule(() => {
+ this.stopSentinelInterval = this.emitsSentinels ? schedule(() => {
  this.sentinelTick();
- }, opts.sentinelIntervalMs ?? DEFAULT_SENTINEL_INTERVAL_MS);
+ }, opts.sentinelIntervalMs ?? DEFAULT_SENTINEL_INTERVAL_MS) : () => {
+ };
  }
 
  enqueue(event) {
@@ -5564,7 +5587,8 @@ var EvaluationEventEmitter = class {
  const seq = this.nextSeq;
  this.nextSeq += 1;
  this.lastSeq = seq;
- const accepted = this.buffer.offer({ event, seq, streamId: this.streamId });
+ const stamped = event.emissionStreamId === void 0 ? { ...event, emissionStreamId: this.streamId } : event;
+ const accepted = this.buffer.offer({ event: stamped, seq, streamId: this.streamId });
  this.accounting.recordOffer(nowMs, accepted);
  this.accounting.maybeRollover(nowMs);
  return event.eventId;
@@ -5581,6 +5605,7 @@ var EvaluationEventEmitter = class {
  }
 
  async emitSentinelNow(final) {
+ if (!this.emitsSentinels) return;
  if (this.sentinelTargets.length === 0) return;
  const sentinel = { streamId: this.streamId, seq: this.lastSeq, final };
  await Promise.all(
@@ -5961,7 +5986,14 @@ var HttpTransport = class {
  otlpOpts.rawResponseLocation = mode === "dual" ? "http-channel" : "store";
  flushTargets.push(new OtlpEventFlushTarget(otlpOpts));
  }
+ if (e.deployment === "serverless" && e.streamId === void 0) {
+ throw new Error(
+ "emit.deployment 'serverless' requires a stable emit.streamId (e.g. the function name) \u2014 a per-request id would make streamCount track calls, not emitters. Completeness for a serverless emitter comes from reconciliation over that stable stream."
+ );
+ }
  const emitterOpts = { flushTargets, lensVersion };
+ if (e.deployment !== void 0) emitterOpts.deployment = e.deployment;
+ if (e.streamId !== void 0) emitterOpts.streamId = e.streamId;
  if (e.bufferSize !== void 0) emitterOpts.bufferSize = e.bufferSize;
  if (e.flushIntervalMs !== void 0) emitterOpts.flushIntervalMs = e.flushIntervalMs;
  if (e.sentinelIntervalMs !== void 0) emitterOpts.sentinelIntervalMs = e.sentinelIntervalMs;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holonograph/client",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "TypeScript HTTP client for a Holonograph lens. Send messages through the lens and report scored outcomes back to it.",
   "license": "MIT",
   "type": "module",