@noego/telemetry 0.0.1

package/dist/maintenance_coordinator.types-B-bZUNvw.d.cts

@@ -0,0 +1,127 @@
+import { T as TelemetryStorageTransport, e as TelemetryStorageTarget, a as TelemetryStorageCapabilities, b as StorageTargetStatus, M as MaintenanceStageResult } from './storage.types-DjuUMinz.cjs';
+import { M as MetricDefinition, f as MetricExtraction } from './query.types-Bntwh6KF.cjs';
+import { d as TelemetryBatch, a as TelemetryBatchValidationLimits, f as TelemetryDropCounter, c as TelemetryBatchReceiver, e as TelemetryAcknowledgement } from './transport.types-BAl_TRtU.cjs';
+
+interface TelemetrySinkPlugin {
+    readonly name: string;
+    readonly supportedSchemaVersions: readonly number[];
+    onCommitted(batch: TelemetryBatch): Promise<void>;
+    close(deadlineMs: number): Promise<void>;
+}
+interface TelemetryMetricPlugin {
+    readonly name: string;
+    readonly definition: MetricDefinition;
+    extract(batch: TelemetryBatch): MetricExtraction;
+}
+
+type TelemetryCollectorOptions = Readonly<{
+    storage: TelemetryStorageTransport | readonly TelemetryStorageTarget[];
+    definitions: readonly MetricDefinition[];
+    sinkPlugins: readonly TelemetrySinkPlugin[];
+    schemaVersions: readonly number[];
+    volatile: boolean;
+    defaultTargetId?: string | null;
+    requiredCapabilities?: readonly (keyof TelemetryStorageCapabilities)[];
+    batchValidation?: Partial<TelemetryBatchValidationLimits>;
+    now: () => number;
+}>;
+type TelemetryCollectorStatus = Readonly<{
+    state: 'created' | 'starting' | 'ready' | 'draining' | 'failed' | 'stopped';
+    acceptedBatches: number;
+    committedEvents: number;
+    rejectedBatches: number;
+    dropCounters: readonly TelemetryDropCounter[];
+    lastFailure: string | null;
+    targets: readonly StorageTargetStatus[];
+}>;
+
+declare class TelemetryCollectorRuntime implements TelemetryBatchReceiver {
+    private readonly options;
+    readonly receiverId = "telemetry-collector";
+    private readonly batchContract;
+    private readonly definitionContract;
+    private readonly storage;
+    private readonly pluginRegistry;
+    private readonly dropCounts;
+    private extractor;
+    private state;
+    private acceptedBatches;
+    private committedEvents;
+    private rejectedBatches;
+    private lastFailure;
+    private readonly pending;
+    constructor(options: TelemetryCollectorOptions);
+    start(): Promise<void>;
+    receive(batch: TelemetryBatch): Promise<TelemetryAcknowledgement>;
+    status(): TelemetryCollectorStatus;
+    stop(deadlineMs: number): Promise<void>;
+    storageTransport(): TelemetryStorageTransport;
+    private acceptBatch;
+    private persistAcceptedBatch;
+    private normalizeStorageAcknowledgement;
+    private normalizeCommittedAcknowledgement;
+    private normalizeRetryableAcknowledgement;
+    private normalizeRejectedAcknowledgement;
+    private normalizeConflictAcknowledgement;
+    private normalizeTargetStates;
+    private normalizeTargetState;
+    private invalidStorageAcknowledgement;
+    private isRecord;
+    private hasExactKeys;
+    private isBoundedText;
+    private isRejectionCode;
+    private isTargetId;
+    private isDeliveryMode;
+    private isDeliveryState;
+    private isAttemptCount;
+    private isTargetReason;
+    private aggregateDropCounters;
+    private dropCounterSnapshot;
+    private safeIdempotencyKey;
+    private validationCode;
+    private errorMessage;
+    private settleExternalShutdown;
+    private mergeExtractions;
+    private normalizeDefinitions;
+    private storageCapabilityError;
+    private resolveStorage;
+    private isStorageTransport;
+}
+
+type MaintenanceLifecycleEvent = Readonly<{
+    type: 'maintenance.started' | 'maintenance.completed' | 'maintenance.failed';
+    occurredAtMs: number;
+    runId: string;
+    payload: Readonly<{
+        stages: readonly MaintenanceStageResult[];
+        failedStage: MaintenanceStageResult['stage'] | null;
+        error: string | null;
+    }>;
+}>;
+type MaintenanceRunResult = Readonly<{
+    kind: 'completed';
+    runId: string;
+    stages: readonly MaintenanceStageResult[];
+}> | Readonly<{
+    kind: 'failed';
+    runId: string;
+    stages: readonly MaintenanceStageResult[];
+    stage: MaintenanceStageResult['stage'];
+    error: string;
+}> | Readonly<{
+    kind: 'skipped';
+    reason: 'already-running' | 'stopped' | 'deadline-exhausted';
+}>;
+type MaintenanceCoordinatorOptions<IntervalHandle = unknown> = Readonly<{
+    storage: TelemetryStorageTransport;
+    intervalMs: number;
+    maxWorkMs: number;
+    maxReclaimPages: number;
+    now: () => number;
+    createRunId: () => string;
+    createInterval: (work: () => void, intervalMs: number) => IntervalHandle;
+    clearInterval: (handle: IntervalHandle) => void;
+    observe: (event: MaintenanceLifecycleEvent) => void;
+}>;
+
+export { type MaintenanceCoordinatorOptions as M, type TelemetrySinkPlugin as T, type TelemetryMetricPlugin as a, type MaintenanceRunResult as b, type MaintenanceLifecycleEvent as c, type TelemetryCollectorOptions as d, TelemetryCollectorRuntime as e, type TelemetryCollectorStatus as f };

package/dist/maintenance_coordinator.types-CBA5y74b.d.ts

@@ -0,0 +1,127 @@
+import { T as TelemetryStorageTransport, e as TelemetryStorageTarget, a as TelemetryStorageCapabilities, b as StorageTargetStatus, M as MaintenanceStageResult } from './storage.types-BTCGVxOM.js';
+import { M as MetricDefinition, f as MetricExtraction } from './query.types-DySoqYop.js';
+import { d as TelemetryBatch, a as TelemetryBatchValidationLimits, f as TelemetryDropCounter, c as TelemetryBatchReceiver, e as TelemetryAcknowledgement } from './transport.types-DDnZoKWi.js';
+
+interface TelemetrySinkPlugin {
+    readonly name: string;
+    readonly supportedSchemaVersions: readonly number[];
+    onCommitted(batch: TelemetryBatch): Promise<void>;
+    close(deadlineMs: number): Promise<void>;
+}
+interface TelemetryMetricPlugin {
+    readonly name: string;
+    readonly definition: MetricDefinition;
+    extract(batch: TelemetryBatch): MetricExtraction;
+}
+
+type TelemetryCollectorOptions = Readonly<{
+    storage: TelemetryStorageTransport | readonly TelemetryStorageTarget[];
+    definitions: readonly MetricDefinition[];
+    sinkPlugins: readonly TelemetrySinkPlugin[];
+    schemaVersions: readonly number[];
+    volatile: boolean;
+    defaultTargetId?: string | null;
+    requiredCapabilities?: readonly (keyof TelemetryStorageCapabilities)[];
+    batchValidation?: Partial<TelemetryBatchValidationLimits>;
+    now: () => number;
+}>;
+type TelemetryCollectorStatus = Readonly<{
+    state: 'created' | 'starting' | 'ready' | 'draining' | 'failed' | 'stopped';
+    acceptedBatches: number;
+    committedEvents: number;
+    rejectedBatches: number;
+    dropCounters: readonly TelemetryDropCounter[];
+    lastFailure: string | null;
+    targets: readonly StorageTargetStatus[];
+}>;
+
+declare class TelemetryCollectorRuntime implements TelemetryBatchReceiver {
+    private readonly options;
+    readonly receiverId = "telemetry-collector";
+    private readonly batchContract;
+    private readonly definitionContract;
+    private readonly storage;
+    private readonly pluginRegistry;
+    private readonly dropCounts;
+    private extractor;
+    private state;
+    private acceptedBatches;
+    private committedEvents;
+    private rejectedBatches;
+    private lastFailure;
+    private readonly pending;
+    constructor(options: TelemetryCollectorOptions);
+    start(): Promise<void>;
+    receive(batch: TelemetryBatch): Promise<TelemetryAcknowledgement>;
+    status(): TelemetryCollectorStatus;
+    stop(deadlineMs: number): Promise<void>;
+    storageTransport(): TelemetryStorageTransport;
+    private acceptBatch;
+    private persistAcceptedBatch;
+    private normalizeStorageAcknowledgement;
+    private normalizeCommittedAcknowledgement;
+    private normalizeRetryableAcknowledgement;
+    private normalizeRejectedAcknowledgement;
+    private normalizeConflictAcknowledgement;
+    private normalizeTargetStates;
+    private normalizeTargetState;
+    private invalidStorageAcknowledgement;
+    private isRecord;
+    private hasExactKeys;
+    private isBoundedText;
+    private isRejectionCode;
+    private isTargetId;
+    private isDeliveryMode;
+    private isDeliveryState;
+    private isAttemptCount;
+    private isTargetReason;
+    private aggregateDropCounters;
+    private dropCounterSnapshot;
+    private safeIdempotencyKey;
+    private validationCode;
+    private errorMessage;
+    private settleExternalShutdown;
+    private mergeExtractions;
+    private normalizeDefinitions;
+    private storageCapabilityError;
+    private resolveStorage;
+    private isStorageTransport;
+}
+
+type MaintenanceLifecycleEvent = Readonly<{
+    type: 'maintenance.started' | 'maintenance.completed' | 'maintenance.failed';
+    occurredAtMs: number;
+    runId: string;
+    payload: Readonly<{
+        stages: readonly MaintenanceStageResult[];
+        failedStage: MaintenanceStageResult['stage'] | null;
+        error: string | null;
+    }>;
+}>;
+type MaintenanceRunResult = Readonly<{
+    kind: 'completed';
+    runId: string;
+    stages: readonly MaintenanceStageResult[];
+}> | Readonly<{
+    kind: 'failed';
+    runId: string;
+    stages: readonly MaintenanceStageResult[];
+    stage: MaintenanceStageResult['stage'];
+    error: string;
+}> | Readonly<{
+    kind: 'skipped';
+    reason: 'already-running' | 'stopped' | 'deadline-exhausted';
+}>;
+type MaintenanceCoordinatorOptions<IntervalHandle = unknown> = Readonly<{
+    storage: TelemetryStorageTransport;
+    intervalMs: number;
+    maxWorkMs: number;
+    maxReclaimPages: number;
+    now: () => number;
+    createRunId: () => string;
+    createInterval: (work: () => void, intervalMs: number) => IntervalHandle;
+    clearInterval: (handle: IntervalHandle) => void;
+    observe: (event: MaintenanceLifecycleEvent) => void;
+}>;
+
+export { type MaintenanceCoordinatorOptions as M, type TelemetrySinkPlugin as T, type TelemetryMetricPlugin as a, type MaintenanceRunResult as b, type MaintenanceLifecycleEvent as c, type TelemetryCollectorOptions as d, TelemetryCollectorRuntime as e, type TelemetryCollectorStatus as f };

package/dist/metric_definition_contract-BR6a_GzF.d.cts

@@ -0,0 +1,12 @@
+import { M as MetricDefinition } from './query.types-Bntwh6KF.cjs';
+import { T as TelemetryResult } from './result.types-171Huujb.cjs';
+
+declare class MetricDefinitionContract {
+    normalize(definition: MetricDefinition): TelemetryResult<MetricDefinition, string>;
+    matches(selector: string, label: string): boolean;
+    private parseSelector;
+    private validateBasic;
+    private matchSegments;
+}
+
+export { MetricDefinitionContract as M };

package/dist/metric_definition_contract-l4i4SaAp.d.ts

@@ -0,0 +1,12 @@
+import { M as MetricDefinition } from './query.types-DySoqYop.js';
+import { T as TelemetryResult } from './result.types-171Huujb.js';
+
+declare class MetricDefinitionContract {
+    normalize(definition: MetricDefinition): TelemetryResult<MetricDefinition, string>;
+    matches(selector: string, label: string): boolean;
+    private parseSelector;
+    private validateBasic;
+    private matchSegments;
+}
+
+export { MetricDefinitionContract as M };