@marinoscar/platform-api 0.1.0-next.3 → 0.1.0-next.4

package/dist/otel-core/sdk/telemetry-gate.d.ts

@@ -1,8 +1,9 @@
 import { type ExportResult } from '@opentelemetry/core';
 import { type Resource } from '@opentelemetry/resources';
-import type { LogRecordExporter, ReadableLogRecord } from '@opentelemetry/sdk-logs';
-import { AggregationTemporality, InstrumentType, type AggregationOption, type PushMetricExporter, type ResourceMetrics } from '@opentelemetry/sdk-metrics';
-import type { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base';
+import type { Context } from '@opentelemetry/api';
+import type { LogRecordExporter, LogRecordProcessor, ReadableLogRecord, SdkLogRecord } from '@opentelemetry/sdk-logs';
+import { AggregationTemporality, InstrumentType, MetricReader, type AggregationOption, type MetricProducer, type PushMetricExporter, type ResourceMetrics } from '@opentelemetry/sdk-metrics';
+import type { ReadableSpan, Span, SpanExporter, SpanProcessor } from '@opentelemetry/sdk-trace-base';
 /**
  * The shape of {@link telemetryGate}.
  *
@@ -113,4 +114,89 @@ export declare class GatedPushMetricExporter implements PushMetricExporter {
     /** Always delegates, whatever the gate says. */
     forceFlush(): Promise<void>;
 }
+/**
+ * Wraps a span processor so it sees spans only while the telemetry gate is open:
+ * `onStart` and `onEnd` are forwarded when the gate is open and dropped when it
+ * is closed. `forceFlush` and `shutdown` always delegate (a flush sends what was
+ * accepted while the gate was open). For the strictest guarantee, build the
+ * processor over a {@link GatedSpanExporter}, which checks at export time.
+ *
+ * `initializeOtel({ spanProcessors })` wraps every processor it is given with
+ * this; use it yourself only when you register a processor another way.
+ *
+ * @example
+ * ```ts
+ * new GatedSpanProcessor(new SimpleSpanProcessor(new ConsoleSpanExporter()));
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare class GatedSpanProcessor implements SpanProcessor {
+    private readonly inner;
+    constructor(inner: SpanProcessor);
+    /** Forwards the span start only while the gate is open. */
+    onStart(span: Span, parentContext: Context): void;
+    /** Forwards the span's ending only while the gate is open. */
+    onEnding(span: Span): void;
+    /** Forwards the finished span only while the gate is open. */
+    onEnd(span: ReadableSpan): void;
+    /** Always delegates, whatever the gate says. */
+    forceFlush(): Promise<void>;
+    /** Always delegates, whatever the gate says: a shutdown must flush even when export is off. */
+    shutdown(): Promise<void>;
+}
+/**
+ * Wraps a log record processor so it sees records only while the telemetry gate
+ * is open (`onEmit` forwards while open, drops while closed). `forceFlush` and
+ * `shutdown` always delegate. For the strictest guarantee, build the processor
+ * over a {@link GatedLogRecordExporter}.
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare class GatedLogRecordProcessor implements LogRecordProcessor {
+    private readonly inner;
+    constructor(inner: LogRecordProcessor);
+    /** Forwards the record only while the gate is open. */
+    onEmit(logRecord: SdkLogRecord, context?: Context): void;
+    /** Always delegates, whatever the gate says. */
+    forceFlush(): Promise<void>;
+    /** Always delegates, whatever the gate says. */
+    shutdown(): Promise<void>;
+}
+/**
+ * Wraps a metric reader so it reads nothing while the telemetry gate is closed.
+ * The inner reader (a periodic exporting reader, a Prometheus pull reader, your
+ * own) is handed a producer that answers an empty collection while the gate is
+ * closed, so there is nothing for it to push or to serve; open, its batches
+ * carry `app.instance.id`. The inner reader keeps its own aggregation,
+ * temporality and cardinality choices.
+ *
+ * ⚠ A push reader's gauges keep the temporality the inner exporter chose
+ * (cumulative by default); build it over a {@link GatedPushMetricExporter} to get
+ * the delta gauges the platform's own metrics use (see that class).
+ *
+ * `initializeOtel({ metricReaders })` wraps every reader it is given with this.
+ *
+ * @example
+ * ```ts
+ * new GatedMetricReader(new PeriodicExportingMetricReader({ exporter: new ConsoleMetricExporter(), exportIntervalMillis: 10_000 }));
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare class GatedMetricReader extends MetricReader {
+    private readonly inner;
+    constructor(inner: MetricReader);
+    /** Hands the inner reader the gated producer instead of the SDK's own. */
+    setMetricProducer(metricProducer: MetricProducer): void;
+    /** Collects through the inner reader, hence through the gated producer. */
+    collect(options?: Parameters<MetricReader['collect']>[0]): ReturnType<MetricReader['collect']>;
+    /** Shuts the inner reader down (always, whatever the gate says). */
+    protected onShutdown(): Promise<void>;
+    /** Flushes the inner reader (always; what it flushes was collected while the gate was open). */
+    protected onForceFlush(): Promise<void>;
+}
 //# sourceMappingURL=telemetry-gate.d.ts.map

package/dist/otel-core/sdk/telemetry-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-gate.d.ts","sourceRoot":"","sources":["../../../src/otel-core/sdk/telemetry-gate.ts"],"names":[],"mappings":"AA+GA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAOhF;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,SAAS,IAAI,OAAO,CAAC;IACrB,uFAAuF;IACvF,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,2EAA2E;IAC3E,UAAU,IAAI,MAAM,CAAC;IACrB,+GAA+G;IAC/G,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,EAAE,aAa3B,CAAC;AAKF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAY1D;AAeD;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY;IAEhD,0FAA0F;IAC1F,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAQnF,+FAA+F;IAC/F,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,gDAAgD;IAChD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,iBAAiB;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,iBAAiB;IAErD,0FAA0F;IAC1F,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAQvF,+FAA+F;IAC/F,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,gDAAgD;IAChD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,uBAAwB,YAAW,kBAAkB;IAMpD,OAAO,CAAC,QAAQ,CAAC,KAAK;IALlC,8FAA8F;IAC9F,QAAQ,CAAC,4BAA4B,EAAE,CAAC,cAAc,EAAE,cAAc,KAAK,sBAAsB,CAAC;IAClG,kEAAkE;IAClE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,KAAK,iBAAiB,CAAC;gBAEtD,KAAK,EAAE,kBAAkB;IAWtD,0FAA0F;IAC1F,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAQtF,+FAA+F;IAC/F,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,gDAAgD;IAChD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}
+{"version":3,"file":"telemetry-gate.d.ts","sourceRoot":"","sources":["../../../src/otel-core/sdk/telemetry-gate.ts"],"names":[],"mappings":"AA4IA,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtH,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,YAAY,EACZ,KAAK,iBAAiB,EAGtB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAOrG;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,SAAS,IAAI,OAAO,CAAC;IACrB,uFAAuF;IACvF,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,2EAA2E;IAC3E,UAAU,IAAI,MAAM,CAAC;IACrB,+GAA+G;IAC/G,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,EAAE,aAa3B,CAAC;AAKF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAY1D;AAeD;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY;IAEhD,0FAA0F;IAC1F,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAQnF,+FAA+F;IAC/F,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,gDAAgD;IAChD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,iBAAiB;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,iBAAiB;IAErD,0FAA0F;IAC1F,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAQvF,+FAA+F;IAC/F,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,gDAAgD;IAChD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,uBAAwB,YAAW,kBAAkB;IAMpD,OAAO,CAAC,QAAQ,CAAC,KAAK;IALlC,8FAA8F;IAC9F,QAAQ,CAAC,4BAA4B,EAAE,CAAC,cAAc,EAAE,cAAc,KAAK,sBAAsB,CAAC;IAClG,kEAAkE;IAClE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,KAAK,iBAAiB,CAAC;gBAEtD,KAAK,EAAE,kBAAkB;IAWtD,0FAA0F;IAC1F,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAQtF,+FAA+F;IAC/F,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,gDAAgD;IAChD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,aAAa;IAEjD,2DAA2D;IAC3D,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI;IAIjD,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI1B,8DAA8D;IAC9D,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAI/B,gDAAgD;IAChD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,+FAA+F;IAC/F,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAG1B;AAED;;;;;;;;GAQG;AACH,qBAAa,uBAAwB,YAAW,kBAAkB;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,kBAAkB;IAEtD,uDAAuD;IACvD,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAIxD,gDAAgD;IAChD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,gDAAgD;IAChD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAG1B;AAwBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY;IAQhD,0EAA0E;IACjE,iBAAiB,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAKhE,2EAA2E;IAClE,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAIvG,oEAAoE;cACpD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C,gGAAgG;cAChF,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAG9C"}

package/dist/otel-core/sdk/telemetry-gate.js

@@ -94,6 +94,35 @@
 //     values. A cache entry built while its source was still pending is
 //     rebuilt once the source has settled.
 //
+// EXTENSIONS ARE GATED TOO (PP-14.18)
+// -----------------------------------------------------------------------------
+//
+// An app can add span processors, log record processors and metric readers to
+// `initializeOtel` (a console exporter in development, a second backend). It
+// hands the SDK objects whose exporters this file cannot see, so each one is
+// wrapped before the SDK gets it:
+//
+//   - `GatedSpanProcessor` / `GatedLogRecordProcessor` forward `onStart`,
+//     `onEnd` and `onEmit` only while the gate is open. Nothing reaches a
+//     wrapped processor while it is closed, so a `SimpleSpanProcessor` that
+//     exports on end exports nothing. `forceFlush` and `shutdown` always
+//     delegate, like the exporters': a flush sends only what was accepted while
+//     the gate was open.
+//
+//   - `GatedMetricReader` hands the inner reader a PRODUCER that answers an
+//     empty collection while the gate is closed (and stamps `app.instance.id`
+//     when it is open). Whatever the inner reader does with that (push it with a
+//     periodic exporter, serve it on a Prometheus scrape) it has nothing to
+//     send or serve while closed.
+//
+// The residual window is the same one the built-in batch processors have: a
+// processor that batches on its own timer may export a batch it accepted
+// shortly BEFORE the gate closed. Where that matters, build the processor over a
+// `GatedSpanExporter` / `GatedLogRecordExporter` / `GatedPushMetricExporter`
+// instead: those check the gate at the moment of export, and they stamp the
+// instance id. `test/otel-core/telemetry-gate.spec.ts` proves nothing exports
+// while the gate is closed, for every kind.
+//
 // SAFE TO IMPORT BEFORE THE SDK STARTS
 // -----------------------------------------------------------------------------
 //
@@ -110,7 +139,7 @@
 // single-instance check (issue #695) guards the package name.
 // =============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GatedPushMetricExporter = exports.GatedLogRecordExporter = exports.GatedSpanExporter = exports.telemetryGate = void 0;
+exports.GatedMetricReader = exports.GatedLogRecordProcessor = exports.GatedSpanProcessor = exports.GatedPushMetricExporter = exports.GatedLogRecordExporter = exports.GatedSpanExporter = exports.telemetryGate = void 0;
 exports.stampResource = stampResource;
 const core_1 = require("@opentelemetry/core");
 const resources_1 = require("@opentelemetry/resources");
@@ -294,4 +323,156 @@ class GatedPushMetricExporter {
     }
 }
 exports.GatedPushMetricExporter = GatedPushMetricExporter;
+/**
+ * Wraps a span processor so it sees spans only while the telemetry gate is open:
+ * `onStart` and `onEnd` are forwarded when the gate is open and dropped when it
+ * is closed. `forceFlush` and `shutdown` always delegate (a flush sends what was
+ * accepted while the gate was open). For the strictest guarantee, build the
+ * processor over a {@link GatedSpanExporter}, which checks at export time.
+ *
+ * `initializeOtel({ spanProcessors })` wraps every processor it is given with
+ * this; use it yourself only when you register a processor another way.
+ *
+ * @example
+ * ```ts
+ * new GatedSpanProcessor(new SimpleSpanProcessor(new ConsoleSpanExporter()));
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+class GatedSpanProcessor {
+    inner;
+    constructor(inner) {
+        this.inner = inner;
+    }
+    /** Forwards the span start only while the gate is open. */
+    onStart(span, parentContext) {
+        if (exports.telemetryGate.isEnabled())
+            this.inner.onStart(span, parentContext);
+    }
+    /** Forwards the span's ending only while the gate is open. */
+    onEnding(span) {
+        if (exports.telemetryGate.isEnabled())
+            this.inner.onEnding?.(span);
+    }
+    /** Forwards the finished span only while the gate is open. */
+    onEnd(span) {
+        if (exports.telemetryGate.isEnabled())
+            this.inner.onEnd(span);
+    }
+    /** Always delegates, whatever the gate says. */
+    forceFlush() {
+        return this.inner.forceFlush();
+    }
+    /** Always delegates, whatever the gate says: a shutdown must flush even when export is off. */
+    shutdown() {
+        return this.inner.shutdown();
+    }
+}
+exports.GatedSpanProcessor = GatedSpanProcessor;
+/**
+ * Wraps a log record processor so it sees records only while the telemetry gate
+ * is open (`onEmit` forwards while open, drops while closed). `forceFlush` and
+ * `shutdown` always delegate. For the strictest guarantee, build the processor
+ * over a {@link GatedLogRecordExporter}.
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+class GatedLogRecordProcessor {
+    inner;
+    constructor(inner) {
+        this.inner = inner;
+    }
+    /** Forwards the record only while the gate is open. */
+    onEmit(logRecord, context) {
+        if (exports.telemetryGate.isEnabled())
+            this.inner.onEmit(logRecord, context);
+    }
+    /** Always delegates, whatever the gate says. */
+    forceFlush() {
+        return this.inner.forceFlush();
+    }
+    /** Always delegates, whatever the gate says. */
+    shutdown() {
+        return this.inner.shutdown();
+    }
+}
+exports.GatedLogRecordProcessor = GatedLogRecordProcessor;
+/** What a gated producer answers while the gate is closed: nothing collected, no error. */
+function emptyCollection() {
+    return { resourceMetrics: { resource: (0, resources_1.resourceFromAttributes)({}), scopeMetrics: [] }, errors: [] };
+}
+/**
+ * The metric producer a {@link GatedMetricReader} gives its inner reader: the
+ * SDK's own producer while the gate is open (its batches stamped with the
+ * instance id), an empty collection while it is closed.
+ */
+class GatedMetricProducer {
+    inner;
+    constructor(inner) {
+        this.inner = inner;
+    }
+    async collect(options) {
+        if (!exports.telemetryGate.isEnabled())
+            return emptyCollection();
+        const result = await this.inner.collect(options);
+        // The gate may have closed while the SDK was collecting: nothing leaves then.
+        if (!exports.telemetryGate.isEnabled())
+            return emptyCollection();
+        return { ...result, resourceMetrics: { ...result.resourceMetrics, resource: stampResource(result.resourceMetrics.resource) } };
+    }
+}
+/**
+ * Wraps a metric reader so it reads nothing while the telemetry gate is closed.
+ * The inner reader (a periodic exporting reader, a Prometheus pull reader, your
+ * own) is handed a producer that answers an empty collection while the gate is
+ * closed, so there is nothing for it to push or to serve; open, its batches
+ * carry `app.instance.id`. The inner reader keeps its own aggregation,
+ * temporality and cardinality choices.
+ *
+ * ⚠ A push reader's gauges keep the temporality the inner exporter chose
+ * (cumulative by default); build it over a {@link GatedPushMetricExporter} to get
+ * the delta gauges the platform's own metrics use (see that class).
+ *
+ * `initializeOtel({ metricReaders })` wraps every reader it is given with this.
+ *
+ * @example
+ * ```ts
+ * new GatedMetricReader(new PeriodicExportingMetricReader({ exporter: new ConsoleMetricExporter(), exportIntervalMillis: 10_000 }));
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+class GatedMetricReader extends sdk_metrics_1.MetricReader {
+    inner;
+    constructor(inner) {
+        super({
+            aggregationSelector: (instrumentType) => inner.selectAggregation(instrumentType),
+            aggregationTemporalitySelector: (instrumentType) => inner.selectAggregationTemporality(instrumentType),
+            cardinalitySelector: (instrumentType) => inner.selectCardinalityLimit(instrumentType),
+        });
+        this.inner = inner;
+    }
+    /** Hands the inner reader the gated producer instead of the SDK's own. */
+    setMetricProducer(metricProducer) {
+        super.setMetricProducer(metricProducer);
+        this.inner.setMetricProducer(new GatedMetricProducer(metricProducer));
+    }
+    /** Collects through the inner reader, hence through the gated producer. */
+    collect(options) {
+        return this.inner.collect(options);
+    }
+    /** Shuts the inner reader down (always, whatever the gate says). */
+    async onShutdown() {
+        await this.inner.shutdown();
+    }
+    /** Flushes the inner reader (always; what it flushes was collected while the gate was open). */
+    async onForceFlush() {
+        await this.inner.forceFlush();
+    }
+}
+exports.GatedMetricReader = GatedMetricReader;
 //# sourceMappingURL=telemetry-gate.js.map

package/dist/otel-core/sdk/telemetry-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-gate.js","sourceRoot":"","sources":["../../../src/otel-core/sdk/telemetry-gate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"telemetry-gate.js","sourceRoot":"","sources":["../../../src/otel-core/sdk/telemetry-gate.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,EAAE;AACF,iDAAiD;AACjD,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,8DAA8D;AAC9D,uEAAuE;AACvE,uEAAuE;AACvE,6EAA6E;AAC7E,4EAA4E;AAC5E,4DAA4D;AAC5D,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,6EAA6E;AAC7E,+EAA+E;AAC/E,+BAA+B;AAC/B,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,4EAA4E;AAC5E,sEAAsE;AACtE,8DAA8D;AAC9D,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,6EAA6E;AAC7E,iEAAiE;AACjE,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,8DAA8D;AAC9D,EAAE;AACF,2DAA2D;AAC3D,gFAAgF;AAChF,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,6EAA6E;AAC7E,sEAAsE;AACtE,0EAA0E;AAC1E,2EAA2E;AAC3E,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,wEAAwE;AACxE,6EAA6E;AAC7E,4EAA4E;AAC5E,2BAA2B;AAC3B,EAAE;AACF,kDAAkD;AAClD,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,8DAA8D;AAC9D,EAAE;AACF,iEAAiE;AACjE,4EAA4E;AAC5E,2EAA2E;AAC3E,yEAAyE;AACzE,sEAAsE;AACtE,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,yEAAyE;AACzE,+EAA+E;AAC/E,2DAA2D;AAC3D,EAAE;AACF,uEAAuE;AACvE,+DAA+D;AAC/D,0EAA0E;AAC1E,2EAA2E;AAC3E,4EAA4E;AAC5E,+EAA+E;AAC/E,2EAA2E;AAC3E,iCAAiC;AACjC,EAAE;AACF,oEAAoE;AACpE,oEAAoE;AACpE,6EAA6E;AAC7E,6EAA6E;AAC7E,wDAAwD;AACxD,EAAE;AACF,2EAA2E;AAC3E,wEAAwE;AACxE,wEAAwE;AACxE,2CAA2C;AAC3C,EAAE;AACF,sCAAsC;AACtC,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,kCAAkC;AAClC,EAAE;AACF,0EAA0E;AAC1E,0EAA0E;AAC1E,4EAA4E;AAC5E,yEAAyE;AACzE,gFAAgF;AAChF,yBAAyB;AACzB,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,iFAAiF;AACjF,4EAA4E;AAC5E,kCAAkC;AAClC,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,iFAAiF;AACjF,6EAA6E;AAC7E,4EAA4E;AAC5E,8EAA8E;AAC9E,4CAA4C;AAC5C,EAAE;AACF,uCAAuC;AACvC,gFAAgF;AAChF,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAC7E,2EAA2E;AAC3E,EAAE;AACF,sEAAsE;AACtE,4EAA4E;AAC5E,uEAAuE;AACvE,8DAA8D;AAC9D,gFAAgF;;;AAmFhF,sCAYC;AA7FD,8CAA0E;AAC1E,wDAAiF;AAGjF,4DAUoC;AAGpC,+CAA0E;AAE1E,IAAI,OAAO,GAAG,KAAK,CAAC;AACpB,IAAI,UAAU,GAAG,iCAAmB,CAAC;AAkBrC;;;;;;;;;;;;;;GAcG;AACU,QAAA,aAAa,GAAkB;IAC1C,SAAS;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,UAAU,CAAC,IAAa;QACtB,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IACD,UAAU;QACR,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,aAAa,CAAC,IAAY;QACxB,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;CACF,CAAC;AAEF,yEAAyE;AACzE,MAAM,OAAO,GAAG,IAAI,OAAO,EAA8C,CAAC;AAE1E;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAAC,QAAkB;IAC9C,MAAM,EAAE,GAAG,UAAU,CAAC;IACtB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAElC,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,sBAAsB,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACrG,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAA,kCAAsB,EAAC,EAAE,CAAC,kCAAoB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAmC,MAAS;IACtE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;QAC3B,QAAQ,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;KACtE,CAAM,CAAC;AACV,CAAC;AAED,MAAM,OAAO,GAAiB,EAAE,IAAI,EAAE,uBAAgB,CAAC,OAAO,EAAE,CAAC;AAEjE;;;;;GAKG;AACH,MAAa,iBAAiB;IACC;IAA7B,YAA6B,KAAmB;QAAnB,UAAK,GAAL,KAAK,CAAc;IAAG,CAAC;IAEpD,0FAA0F;IAC1F,MAAM,CAAC,KAAqB,EAAE,cAA8C;QAC1E,IAAI,CAAC,qBAAa,CAAC,SAAS,EAAE,EAAE,CAAC;YAC/B,cAAc,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,cAAc,CAAC,CAAC;IACpE,CAAC;IAED,+FAA+F;IAC/F,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED,gDAAgD;IAChD,UAAU;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7E,CAAC;CACF;AArBD,8CAqBC;AAED;;;;;GAKG;AACH,MAAa,sBAAsB;IACJ;IAA7B,YAA6B,KAAwB;QAAxB,UAAK,GAAL,KAAK,CAAmB;IAAG,CAAC;IAEzD,0FAA0F;IAC1F,MAAM,CAAC,IAAyB,EAAE,cAA8C;QAC9E,IAAI,CAAC,qBAAa,CAAC,SAAS,EAAE,EAAE,CAAC;YAC/B,cAAc,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,cAAc,CAAC,CAAC;IACnE,CAAC;IAED,+FAA+F;IAC/F,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED,gDAAgD;IAChD,UAAU;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;CACF;AArBD,wDAqBC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,uBAAuB;IAML;IAL7B,8FAA8F;IACrF,4BAA4B,CAA6D;IAClG,kEAAkE;IACzD,iBAAiB,CAAyD;IAEnF,YAA6B,KAAyB;QAAzB,UAAK,GAAL,KAAK,CAAoB;QACpD,MAAM,gBAAgB,GAAG,KAAK,CAAC,4BAA4B,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACzE,IAAI,CAAC,4BAA4B,GAAG,CAAC,cAAc,EAAE,EAAE,CACrD,cAAc,KAAK,4BAAc,CAAC,gBAAgB,IAAI,cAAc,KAAK,4BAAc,CAAC,KAAK;YAC3F,CAAC,CAAC,oCAAsB,CAAC,KAAK;YAC9B,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,cAAc,CAAC,IAAI,oCAAsB,CAAC,UAAU,CAAC,CAAC;QAChF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,0FAA0F;IAC1F,MAAM,CAAC,OAAwB,EAAE,cAA8C;QAC7E,IAAI,CAAC,qBAAa,CAAC,SAAS,EAAE,EAAE,CAAC;YAC/B,cAAc,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;IAC/F,CAAC;IAED,+FAA+F;IAC/F,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED,gDAAgD;IAChD,UAAU;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;CACF;AAnCD,0DAmCC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,kBAAkB;IACA;IAA7B,YAA6B,KAAoB;QAApB,UAAK,GAAL,KAAK,CAAe;IAAG,CAAC;IAErD,2DAA2D;IAC3D,OAAO,CAAC,IAAU,EAAE,aAAsB;QACxC,IAAI,qBAAa,CAAC,SAAS,EAAE;YAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACzE,CAAC;IAED,8DAA8D;IAC9D,QAAQ,CAAC,IAAU;QACjB,IAAI,qBAAa,CAAC,SAAS,EAAE;YAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,IAAkB;QACtB,IAAI,qBAAa,CAAC,SAAS,EAAE;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,gDAAgD;IAChD,UAAU;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,+FAA+F;IAC/F,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;CACF;AA3BD,gDA2BC;AAED;;;;;;;;GAQG;AACH,MAAa,uBAAuB;IACL;IAA7B,YAA6B,KAAyB;QAAzB,UAAK,GAAL,KAAK,CAAoB;IAAG,CAAC;IAE1D,uDAAuD;IACvD,MAAM,CAAC,SAAuB,EAAE,OAAiB;QAC/C,IAAI,qBAAa,CAAC,SAAS,EAAE;YAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED,gDAAgD;IAChD,UAAU;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,gDAAgD;IAChD,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;CACF;AAjBD,0DAiBC;AAED,2FAA2F;AAC3F,SAAS,eAAe;IACtB,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,IAAA,kCAAsB,EAAC,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACrG,CAAC;AAED;;;;GAIG;AACH,MAAM,mBAAmB;IACM;IAA7B,YAA6B,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAEtD,KAAK,CAAC,OAAO,CAAC,OAA8B;QAC1C,IAAI,CAAC,qBAAa,CAAC,SAAS,EAAE;YAAE,OAAO,eAAe,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjD,8EAA8E;QAC9E,IAAI,CAAC,qBAAa,CAAC,SAAS,EAAE;YAAE,OAAO,eAAe,EAAE,CAAC;QACzD,OAAO,EAAE,GAAG,MAAM,EAAE,eAAe,EAAE,EAAE,GAAG,MAAM,CAAC,eAAe,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;IACjI,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,iBAAkB,SAAQ,0BAAY;IACpB;IAA7B,YAA6B,KAAmB;QAC9C,KAAK,CAAC;YACJ,mBAAmB,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,cAAc,CAAC;YAChF,8BAA8B,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC,4BAA4B,CAAC,cAAc,CAAC;YACtG,mBAAmB,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC,cAAc,CAAC;SACtF,CAAC,CAAC;QALwB,UAAK,GAAL,KAAK,CAAc;IAMhD,CAAC;IAED,0EAA0E;IACjE,iBAAiB,CAAC,cAA8B;QACvD,KAAK,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,mBAAmB,CAAC,cAAc,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,2EAA2E;IAClE,OAAO,CAAC,OAAgD;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,oEAAoE;IAC1D,KAAK,CAAC,UAAU;QACxB,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,gGAAgG;IACtF,KAAK,CAAC,YAAY;QAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;CACF;AA7BD,8CA6BC"}

package/dist/settings/data/settings-db.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Query arguments, as the app's client accepts them.
+ *
+ * @stability experimental
+ */
+export type SettingsQueryArgs = Record<string, unknown>;
+/**
+ * One model delegate of the app's client, structurally.
+ *
+ * @typeParam Row - the model's row type.
+ *
+ * @stability experimental
+ */
+export interface SettingsDelegate<Row> {
+    /** `findUnique`. */
+    findUnique<T = Row>(args: SettingsQueryArgs): Promise<T | null>;
+    /** `findFirst`. */
+    findFirst<T = Row>(args: SettingsQueryArgs): Promise<T | null>;
+    /** `create`. */
+    create<T = Row>(args: SettingsQueryArgs): Promise<T>;
+    /** `update`. */
+    update<T = Row>(args: SettingsQueryArgs): Promise<T>;
+    /** `upsert`. */
+    upsert<T = Row>(args: SettingsQueryArgs): Promise<T>;
+    /** `updateMany`. */
+    updateMany(args: SettingsQueryArgs): Promise<SettingsBatchResult>;
+    /** `deleteMany`. */
+    deleteMany(args?: SettingsQueryArgs): Promise<SettingsBatchResult>;
+}
+/**
+ * What a batch write returns.
+ *
+ * @stability experimental
+ */
+export interface SettingsBatchResult {
+    /** How many rows it changed. */
+    count: number;
+}
+/**
+ * A row identified by its id (the users and audit delegates' default shape).
+ *
+ * @stability experimental
+ */
+export interface SettingsIdRow {
+    /** The row's id. */
+    id: string;
+}
+/**
+ * The `users` columns the display-name sync writes.
+ *
+ * @stability experimental
+ */
+export interface SettingsUserRow {
+    /** The user's id. */
+    id: string;
+    /** The display name, or `null`. */
+    displayName: string | null;
+}
+/**
+ * A `system_settings` row.
+ *
+ * @stability experimental
+ */
+export interface SettingsSystemSettingsRow {
+    /** The row's id. */
+    id: string;
+    /** The row's key: `global` (the namespaces document) or a slice's own row (`email`, ...). */
+    key: string;
+    /** The JSON value. */
+    value: unknown;
+    /** The optimistic-concurrency version. */
+    version: number;
+    /** Who last changed it, or `null`. */
+    updatedByUserId: string | null;
+    /** When it last changed. */
+    updatedAt: Date;
+}
+/**
+ * A `user_settings` row.
+ *
+ * @stability experimental
+ */
+export interface SettingsUserSettingsRow {
+    /** The row's id. */
+    id: string;
+    /** The user. */
+    userId: string;
+    /** The JSON value. */
+    value: unknown;
+    /** The optimistic-concurrency version. */
+    version: number;
+    /** When it last changed. */
+    updatedAt: Date;
+}
+/**
+ * An `org_settings` row: one organization's overrides, namespace by namespace
+ * (only the fields each namespace's `org.schema` allows).
+ *
+ * @stability experimental
+ */
+export interface SettingsOrgSettingsRow {
+    /** The row's id. */
+    id: string;
+    /** The organization. */
+    orgId: string;
+    /** The JSON value: namespace key to the org's stored fields. */
+    value: unknown;
+    /** The optimistic-concurrency version. */
+    version: number;
+    /** Who last changed it, or `null`. */
+    updatedByUserId: string | null;
+    /** When it last changed. */
+    updatedAt: Date;
+}
+/**
+ * The app's client, as the settings slice uses it outside an organization's
+ * scope (bound to the core port `PLATFORM_PRISMA`).
+ *
+ * @stability experimental
+ */
+export interface SettingsPrisma {
+    /** `system_settings`. */
+    systemSettings: SettingsDelegate<SettingsSystemSettingsRow>;
+    /** `user_settings`. */
+    userSettings: SettingsDelegate<SettingsUserSettingsRow>;
+    /** `users`: the display-name sync. */
+    user: SettingsDelegate<SettingsUserRow>;
+    /** `audit_events`: the settings audit trail. */
+    auditEvent: SettingsDelegate<SettingsIdRow>;
+}
+/**
+ * The transaction client the host hands to an org-scoped callback: the
+ * `org_settings` delegate under that organization's row-level-security scope,
+ * plus `audit_events` (written in the same transaction, after the write).
+ *
+ * @stability experimental
+ */
+export interface SettingsOrgTx {
+    /** `org_settings`, confined to the scope's organization. */
+    orgSettings: SettingsDelegate<SettingsOrgSettingsRow>;
+    /** `audit_events`. */
+    auditEvent: SettingsDelegate<SettingsIdRow>;
+}
+//# sourceMappingURL=settings-db.d.ts.map

package/dist/settings/data/settings-db.d.ts.map

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

package/dist/settings/data/settings-db.js

@@ -0,0 +1,25 @@
+"use strict";
+// =============================================================================
+// The data the settings slice reads and writes, structurally (issue #733)
+// =============================================================================
+//
+// The slice never imports a generated Prisma client, not even its types (the
+// rule of identity, `identity/data/identity-db.ts`, and sharing): the package
+// is built, type-checked and tested before any app's `prisma generate`, and
+// works with any app that composed the `settings` fragment of
+// `@marinoscar/platform-db`.
+//
+// The tables: `system_settings` (deployment-level, outside RLS: one row per
+// key, `global` plus the rows slices own, such as `email` and
+// `telemetry_connection`), `user_settings` (one row per user) and
+// `org_settings` (one row per organization, FORCEd row-level security on
+// `org_id`, reached only inside a transaction the host's `SETTINGS_DATA` port
+// opened in that organization's scope). `users` (the display-name sync) and
+// `audit_events` (the settings audit trail) are written as they always were.
+//
+// Every delegate method is generic in its result (`findUnique<T = Row>`): a
+// call that `include`s or `select`s names the shape it reads, and the app's
+// client checks the arguments at run time.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=settings-db.js.map

package/dist/settings/data/settings-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-db.js","sourceRoot":"","sources":["../../../src/settings/data/settings-db.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,0EAA0E;AAC1E,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,4EAA4E;AAC5E,8DAA8D;AAC9D,6BAA6B;AAC7B,EAAE;AACF,4EAA4E;AAC5E,8DAA8D;AAC9D,kEAAkE;AAClE,yEAAyE;AACzE,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,2CAA2C;AAC3C,gFAAgF"}

package/dist/settings/data/settings-ownership.d.ts

@@ -0,0 +1,27 @@
+import type { ModelOwnershipDef, UserOwnedModelDef } from '../../core/index';
+/**
+ * The slice's org-owned models for the model ownership registry
+ * (`registerModelOwnership`).
+ *
+ * @example
+ * ```ts
+ * registerModelOwnership(SETTINGS_MODEL_OWNERSHIP);
+ * ```
+ *
+ * @stability experimental
+ */
+export declare const SETTINGS_MODEL_OWNERSHIP: readonly ModelOwnershipDef<'OrgSettings'>[];
+/**
+ * The slice's new model with a foreign key to `User`, for the app's
+ * user-owned-data registry (`registerUserOwnedModels`). `SystemSettings` and
+ * `UserSettings` keep the app's existing entries.
+ *
+ * @example
+ * ```ts
+ * registerUserOwnedModels(SETTINGS_USER_OWNED_MODELS);
+ * ```
+ *
+ * @stability experimental
+ */
+export declare const SETTINGS_USER_OWNED_MODELS: readonly UserOwnedModelDef<'OrgSettings'>[];
+//# sourceMappingURL=settings-ownership.d.ts.map

package/dist/settings/data/settings-ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-ownership.d.ts","sourceRoot":"","sources":["../../../src/settings/data/settings-ownership.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE7E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,iBAAiB,CAAC,aAAa,CAAC,EAM/E,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,iBAAiB,CAAC,aAAa,CAAC,EAQjF,CAAC"}

package/dist/settings/data/settings-ownership.js

@@ -0,0 +1,52 @@
+"use strict";
+// =============================================================================
+// The settings slice's models in the app's data registries (issue #733)
+// =============================================================================
+//
+// `OrgSettings` is the slice's one org table (FORCEd row-level security on
+// org_id, `org_settings_org_isolation`); its `updatedByUserId` only records who
+// last changed it. The app registers both lists in its manifests, beside the
+// platform and sharing entries.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SETTINGS_USER_OWNED_MODELS = exports.SETTINGS_MODEL_OWNERSHIP = void 0;
+/**
+ * The slice's org-owned models for the model ownership registry
+ * (`registerModelOwnership`).
+ *
+ * @example
+ * ```ts
+ * registerModelOwnership(SETTINGS_MODEL_OWNERSHIP);
+ * ```
+ *
+ * @stability experimental
+ */
+exports.SETTINGS_MODEL_OWNERSHIP = [
+    {
+        model: 'OrgSettings',
+        kind: 'org',
+        rationale: "One organization's settings overrides; another organization must never read or change them.",
+    },
+];
+/**
+ * The slice's new model with a foreign key to `User`, for the app's
+ * user-owned-data registry (`registerUserOwnedModels`). `SystemSettings` and
+ * `UserSettings` keep the app's existing entries.
+ *
+ * @example
+ * ```ts
+ * registerUserOwnedModels(SETTINGS_USER_OWNED_MODELS);
+ * ```
+ *
+ * @stability experimental
+ */
+exports.SETTINGS_USER_OWNED_MODELS = [
+    {
+        model: 'OrgSettings',
+        actorFields: ['updatedByUserId'],
+        purge: 'detach',
+        export: 'exclude',
+        rationale: "An organization's configuration; the user only last changed it.",
+    },
+];
+//# sourceMappingURL=settings-ownership.js.map

package/dist/settings/data/settings-ownership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-ownership.js","sourceRoot":"","sources":["../../../src/settings/data/settings-ownership.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,wEAAwE;AACxE,gFAAgF;AAChF,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;AAChF,6EAA6E;AAC7E,gCAAgC;AAChC,gFAAgF;;;AAIhF;;;;;;;;;;GAUG;AACU,QAAA,wBAAwB,GAAgD;IACnF;QACE,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,KAAK;QACX,SAAS,EAAE,6FAA6F;KACzG;CACF,CAAC;AAEF;;;;;;;;;;;GAWG;AACU,QAAA,0BAA0B,GAAgD;IACrF;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,CAAC,iBAAiB,CAAC;QAChC,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,iEAAiE;KAC7E;CACF,CAAC"}