@stacknext/core 0.0.0-stage → 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StackNext contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+# @stacknext/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Core wire types, Zod schemas, redaction, configuration, framework span metadata,
+bounded in-memory storage and async transport for [StackNext](https://github.com/marrrkkk/stacknext).
+
+This package is the shared foundation for the StackNext CLI, adapters and app
+instrumentation. Most applications should install `@stacknext/cli` and
+`@stacknext/next` instead of depending on this package directly.
+
+```bash
+npm install --save-dev @stacknext/cli @stacknext/next
+npx stacknext init
+npx stacknext dev
+```
+
+The package is ESM-only, requires Node.js 20.9 or newer and does not perform
+network I/O unless a loopback collector URL and token are supplied.
+
+License: MIT.

package/dist/config-file.d.ts

@@ -0,0 +1,6 @@
+import { type StackNextConfig } from './config.js';
+export declare const CONFIG_FILE_NAME = "stacknext.config.json";
+export declare function configPath(projectDir: string): string;
+export declare function readConfigFile(projectDir: string): Promise<unknown | null>;
+export declare function loadConfig(projectDir: string): Promise<StackNextConfig>;
+//# sourceMappingURL=config-file.d.ts.map

package/dist/config-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.d.ts","sourceRoot":"","sources":["../src/config-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAA;AAEpB,eAAO,MAAM,gBAAgB,0BAA0B,CAAA;AAEvD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAgBhF;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAQ7E"}

package/dist/config-file.js

@@ -0,0 +1,36 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { StackNextConfigError, formatIssues, stackNextConfigSchema, parseStackNextConfig, } from './config.js';
+export const CONFIG_FILE_NAME = 'stacknext.config.json';
+export function configPath(projectDir) {
+    return path.join(projectDir, CONFIG_FILE_NAME);
+}
+export async function readConfigFile(projectDir) {
+    try {
+        const contents = await readFile(configPath(projectDir), 'utf8');
+        try {
+            return JSON.parse(contents);
+        }
+        catch (error) {
+            throw new StackNextConfigError(`Could not parse ${CONFIG_FILE_NAME}`, [error instanceof Error ? error.message : String(error)]);
+        }
+    }
+    catch (error) {
+        if (error instanceof StackNextConfigError)
+            throw error;
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+}
+export async function loadConfig(projectDir) {
+    const raw = await readConfigFile(projectDir);
+    if (raw === null)
+        return parseStackNextConfig({});
+    const result = stackNextConfigSchema.safeParse(raw);
+    if (!result.success) {
+        throw new StackNextConfigError('Invalid StackNext configuration', formatIssues(result.error));
+    }
+    return parseStackNextConfig(raw);
+}
+//# sourceMappingURL=config-file.js.map

package/dist/config-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../src/config-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,GAErB,MAAM,aAAa,CAAA;AAEpB,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAA;AAEvD,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAA;QAC/D,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAY,CAAA;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,oBAAoB,CAC5B,mBAAmB,gBAAgB,EAAE,EACrC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CACzD,CAAA;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,oBAAoB;YAAE,MAAM,KAAK,CAAA;QACtD,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QACnE,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB;IACjD,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAA;IAC5C,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,oBAAoB,CAAC,EAAE,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,oBAAoB,CAAC,iCAAiC,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/F,CAAC;IACD,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAA;AAClC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+export declare const stackNextConfigSchema: z.ZodObject<{
+    projectName: z.ZodOptional<z.ZodString>;
+    dashboard: z.ZodDefault<z.ZodObject<{
+        port: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    collector: z.ZodDefault<z.ZodObject<{
+        maxSpans: z.ZodDefault<z.ZodNumber>;
+        retentionMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    instrumentation: z.ZodDefault<z.ZodObject<{
+        verbose: z.ZodDefault<z.ZodBoolean>;
+        captureFetch: z.ZodDefault<z.ZodBoolean>;
+        captureErrors: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    privacy: z.ZodDefault<z.ZodObject<{
+        captureHeaders: z.ZodDefault<z.ZodBoolean>;
+        captureRequestBodies: z.ZodDefault<z.ZodBoolean>;
+        captureSqlParameters: z.ZodDefault<z.ZodBoolean>;
+        redactSensitiveData: z.ZodDefault<z.ZodLiteral<true>>;
+    }, z.core.$strict>>;
+    database: z.ZodDefault<z.ZodObject<{
+        drizzle: z.ZodDefault<z.ZodBoolean>;
+        prisma: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    diagnostics: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        repeatedQueryMin: z.ZodDefault<z.ZodNumber>;
+        slowSpans: z.ZodDefault<z.ZodObject<{
+            databaseMs: z.ZodDefault<z.ZodNumber>;
+            httpMs: z.ZodDefault<z.ZodNumber>;
+            customMs: z.ZodDefault<z.ZodNumber>;
+            otherMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+        repeatedHttpMin: z.ZodDefault<z.ZodNumber>;
+        errorGrouping: z.ZodDefault<z.ZodBoolean>;
+        errorGroupMin: z.ZodDefault<z.ZodNumber>;
+        maxFindings: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    slowRequestMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type StackNextConfig = z.infer<typeof stackNextConfigSchema>;
+export type StackNextConfigInput = z.input<typeof stackNextConfigSchema>;
+export declare class StackNextConfigError extends Error {
+    readonly issues: string[];
+    constructor(message: string, issues?: string[]);
+}
+export declare function formatIssues(error: z.ZodError): string[];
+export declare function parseStackNextConfig(input: unknown): StackNextConfig;
+export declare const DEFAULT_CONFIG: StackNextConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqFvB,CAAA;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACnE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAExE,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAA;gBAEb,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,EAAO;CASnD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,EAAE,CAKxD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CA4BpE;AAED,eAAO,MAAM,cAAc,EAAE,eAA0C,CAAA"}

package/dist/config.js

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+const portSchema = z.number().int().min(1024).max(65535);
+export const stackNextConfigSchema = z
+    .object({
+    projectName: z.string().min(1).max(200).optional(),
+    dashboard: z
+        .object({
+        port: portSchema.default(4400),
+    })
+        .strict()
+        .default({ port: 4400 }),
+    collector: z
+        .object({
+        maxSpans: z.number().int().min(100).max(100_000).default(5_000),
+        retentionMs: z.number().int().min(30_000).max(86_400_000).default(600_000),
+    })
+        .strict()
+        .default({ maxSpans: 5_000, retentionMs: 600_000 }),
+    instrumentation: z
+        .object({
+        verbose: z.boolean().default(false),
+        captureFetch: z.boolean().default(true),
+        captureErrors: z.boolean().default(true),
+    })
+        .strict()
+        .default({ verbose: false, captureFetch: true, captureErrors: true }),
+    privacy: z
+        .object({
+        captureHeaders: z.boolean().default(false),
+        captureRequestBodies: z.boolean().default(false),
+        captureSqlParameters: z.boolean().default(false),
+        redactSensitiveData: z.literal(true).default(true),
+    })
+        .strict()
+        .default({
+        captureHeaders: false,
+        captureRequestBodies: false,
+        captureSqlParameters: false,
+        redactSensitiveData: true,
+    }),
+    database: z
+        .object({
+        drizzle: z.boolean().default(false),
+        prisma: z.boolean().default(false),
+    })
+        .strict()
+        .default({ drizzle: false, prisma: false }),
+    diagnostics: z
+        .object({
+        enabled: z.boolean().default(true),
+        repeatedQueryMin: z.number().int().min(2).max(100).default(5),
+        slowSpans: z
+            .object({
+            databaseMs: z.number().int().min(1).max(600_000).default(250),
+            httpMs: z.number().int().min(1).max(600_000).default(500),
+            customMs: z.number().int().min(1).max(600_000).default(300),
+            otherMs: z.number().int().min(1).max(600_000).default(500),
+        })
+            .strict()
+            .default({
+            databaseMs: 250,
+            httpMs: 500,
+            customMs: 300,
+            otherMs: 500,
+        }),
+        repeatedHttpMin: z.number().int().min(2).max(100).default(3),
+        errorGrouping: z.boolean().default(true),
+        errorGroupMin: z.number().int().min(2).max(100).default(2),
+        maxFindings: z.number().int().min(10).max(1_000).default(100),
+    })
+        .strict()
+        .default({
+        enabled: true,
+        repeatedQueryMin: 5,
+        slowSpans: {
+            databaseMs: 250,
+            httpMs: 500,
+            customMs: 300,
+            otherMs: 500,
+        },
+        repeatedHttpMin: 3,
+        errorGrouping: true,
+        errorGroupMin: 2,
+        maxFindings: 100,
+    }),
+    slowRequestMs: z.number().int().min(1).max(600_000).default(500),
+})
+    .strict();
+export class StackNextConfigError extends Error {
+    issues;
+    constructor(message, issues = []) {
+        super(issues.length > 0
+            ? `${message}:\n${issues.map((issue) => `  - ${issue}`).join('\n')}`
+            : message);
+        this.name = 'StackNextConfigError';
+        this.issues = issues;
+    }
+}
+export function formatIssues(error) {
+    return error.issues.map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';
+        return `${path}: ${issue.message}`;
+    });
+}
+export function parseStackNextConfig(input) {
+    const result = stackNextConfigSchema.safeParse(input);
+    if (!result.success) {
+        throw new StackNextConfigError('Invalid StackNext configuration', formatIssues(result.error));
+    }
+    const config = result.data;
+    if (config.privacy.captureRequestBodies) {
+        throw new StackNextConfigError('Invalid StackNext configuration', ['privacy.captureRequestBodies: request bodies are not captured by StackNext']);
+    }
+    if (config.privacy.captureSqlParameters) {
+        throw new StackNextConfigError('Invalid StackNext configuration', ['privacy.captureSqlParameters: SQL parameters are not captured by StackNext']);
+    }
+    if (config.privacy.captureHeaders) {
+        throw new StackNextConfigError('Invalid StackNext configuration', ['privacy.captureHeaders: request headers are not captured by StackNext']);
+    }
+    return config;
+}
+export const DEFAULT_CONFIG = parseStackNextConfig({});
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAExD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAClD,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;KAC/B,CAAC;SACD,MAAM,EAAE;SACR,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC1B,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QAC/D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;KAC3E,CAAC;SACD,MAAM,EAAE;SACR,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IACrD,eAAe,EAAE,CAAC;SACf,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACnC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACvC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KACzC,CAAC;SACD,MAAM,EAAE;SACR,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IACvE,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QAC1C,oBAAoB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QAChD,oBAAoB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QAChD,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;KACnD,CAAC;SACD,MAAM,EAAE;SACR,OAAO,CAAC;QACP,cAAc,EAAE,KAAK;QACrB,oBAAoB,EAAE,KAAK;QAC3B,oBAAoB,EAAE,KAAK;QAC3B,mBAAmB,EAAE,IAAI;KAC1B,CAAC;IACJ,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACnC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KACnC,CAAC;SACD,MAAM,EAAE;SACR,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC7C,WAAW,EAAE,CAAC;SACX,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QAClC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7D,SAAS,EAAE,CAAC;aACT,MAAM,CAAC;YACN,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;YAC7D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;YACzD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;YAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;SAC3D,CAAC;aACD,MAAM,EAAE;aACR,OAAO,CAAC;YACP,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,GAAG;YACX,QAAQ,EAAE,GAAG;YACb,OAAO,EAAE,GAAG;SACb,CAAC;QACJ,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5D,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACxC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;KAC9D,CAAC;SACD,MAAM,EAAE;SACR,OAAO,CAAC;QACP,OAAO,EAAE,IAAI;QACb,gBAAgB,EAAE,CAAC;QACnB,SAAS,EAAE;YACT,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,GAAG;YACX,QAAQ,EAAE,GAAG;YACb,OAAO,EAAE,GAAG;SACb;QACD,eAAe,EAAE,CAAC;QAClB,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,GAAG;KACjB,CAAC;IACJ,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;CACjE,CAAC;KACD,MAAM,EAAE,CAAA;AAKX,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,MAAM,CAAU;IAEzB,YAAY,OAAe,EAAE,SAAmB,EAAE;QAChD,KAAK,CACH,MAAM,CAAC,MAAM,GAAG,CAAC;YACf,CAAC,CAAC,GAAG,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACpE,CAAC,CAAC,OAAO,CACZ,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;QACpE,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAA;IACpC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,oBAAoB,CAC5B,iCAAiC,EACjC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAC3B,CAAA;IACH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAA;IAC1B,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;QACxC,MAAM,IAAI,oBAAoB,CAC5B,iCAAiC,EACjC,CAAC,4EAA4E,CAAC,CAC/E,CAAA;IACH,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;QACxC,MAAM,IAAI,oBAAoB,CAC5B,iCAAiC,EACjC,CAAC,4EAA4E,CAAC,CAC/E,CAAA;IACH,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAClC,MAAM,IAAI,oBAAoB,CAC5B,iCAAiC,EACjC,CAAC,uEAAuE,CAAC,CAC1E,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAoB,oBAAoB,CAAC,EAAE,CAAC,CAAA"}

package/dist/coverage.d.ts

@@ -0,0 +1,49 @@
+import { type StackNextSpanCategory } from './framework.js';
+import type { ConnectionInfo, CoverageCategory, CoverageReport, NextOtelVerboseStatus, StackNextDatabaseSource } from './types.js';
+import type { StackNextConfig } from './config.js';
+export interface CoverageSpanTypeEvidence {
+    count: number;
+    lastSeen: number | null;
+}
+export interface CoverageEvidence {
+    sample: {
+        firstEventTime: number | null;
+        lastEventTime: number | null;
+        spanCount: number;
+        errorCount: number;
+        databaseQueryCount: number;
+        requestCount: number;
+        retentionMs: number;
+        errorLastSeen: number | null;
+        queryLastSeen: number | null;
+    };
+    spanTypes: Record<string, CoverageSpanTypeEvidence>;
+    categoryCounts: Record<StackNextSpanCategory, number>;
+    requestRootSpans: number;
+    renderSpans: number;
+    routeHandlerSpans: number;
+    fetchSpans: number;
+    databaseSpans: number;
+    customSpans: number;
+    actionSpans: number;
+    fetchLastSeen: number | null;
+    customLastSeen: number | null;
+    actionLastSeen: number | null;
+    verboseSpanTypes: string[];
+    querySources: Record<StackNextDatabaseSource, number>;
+    querySourceLastSeen: Record<StackNextDatabaseSource, number | null>;
+}
+export interface ComputeCoverageInput {
+    projectName: string;
+    collectorVersion: string;
+    now: number;
+    config: StackNextConfig;
+    connections: ConnectionInfo[];
+    verbose: NextOtelVerboseStatus;
+    evidence: CoverageEvidence;
+}
+export declare function computeCoverage(input: ComputeCoverageInput): CoverageReport;
+export declare function emptyCoverageEvidence(retentionMs?: number): CoverageEvidence;
+export declare function coverageCategoryLabel(category: CoverageCategory): string;
+export declare function isVerboseOnlySpanType(value: string | undefined): boolean;
+//# sourceMappingURL=coverage.d.ts.map

package/dist/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../src/coverage.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAGhB,cAAc,EAGd,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAGlD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE;QACN,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;QAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;QAC5B,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,EAAE,MAAM,CAAA;QAClB,kBAAkB,EAAE,MAAM,CAAA;QAC1B,YAAY,EAAE,MAAM,CAAA;QACpB,WAAW,EAAE,MAAM,CAAA;QACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;QAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAC7B,CAAA;IACD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;IACnD,cAAc,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;IACrD,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAA;IACrD,mBAAmB,EAAE,MAAM,CAAC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;CACpE;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAA;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,eAAe,CAAA;IACvB,WAAW,EAAE,cAAc,EAAE,CAAA;IAC7B,OAAO,EAAE,qBAAqB,CAAA;IAC9B,QAAQ,EAAE,gBAAgB,CAAA;CAC3B;AAoCD,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,cAAc,CAwY3E;AAED,wBAAgB,qBAAqB,CAAC,WAAW,SAAU,GAAG,gBAAgB,CA6B7E;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAaxE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAExE"}