@adonis-agora/telescope 0.22.0 → 0.24.0

package/dist/src/store.d.ts

@@ -44,6 +44,14 @@ export interface EntryQuery {
      * `@adonis-agora/filter`'s `FilterInput.size` (see {@link EntryQuery.page}).
      */
     size?: number;
+    /**
+     * The caller reads everything but `content`, so a store MAY return `content: null`
+     * instead of loading and parsing it. A hint, not a filter: a store that ignores it
+     * still answers correctly, and callers must not depend on content being absent.
+     * Aggregations over a whole window set it and fetch the content of the few entries
+     * they display afterwards.
+     */
+    omitContent?: boolean;
 }
 /** One row of {@link TelescopeStore.listTraceIds} — a trace and when it was last seen. */
 export interface TraceIdRow {
@@ -69,6 +77,25 @@ export interface BucketCountQuery {
     /** Only entries of this type. */
     type?: string;
 }
+/** A grouping key and how many stored entries carry it. */
+export interface KeyCountRow {
+    key: string;
+    count: number;
+}
+/** What {@link TelescopeStore.countFamilies} counts. */
+export interface FamilyCountQuery {
+    /** How many families to return, busiest first. */
+    limit: number;
+    /** Only entries of this type. */
+    type?: string;
+}
+/** What {@link TelescopeStore.countTags} counts. */
+export interface TagCountQuery {
+    /** How many tags to return, most common first. */
+    limit: number;
+    /** Only tags starting with this prefix. */
+    prefix?: string;
+}
 /** The window + page for {@link TelescopeStore.listTraceIds}. */
 export interface TraceIdQuery {
     /**
@@ -141,5 +168,24 @@ export interface TelescopeStore {
      * scan-and-bucket, which is what this always used to do.
      */
     countByBucket?(query: BucketCountQuery): Promise<BucketCountRow[]>;
+    /**
+     * OPTIONAL fast path for `TelescopeService.topFamilies`: the busiest `familyHash`
+     * values across every stored entry, most entries first, ties going to the family
+     * seen most recently. Without it the service lists the whole table and counts in JS.
+     */
+    countFamilies?(query: FamilyCountQuery): Promise<KeyCountRow[]>;
+    /**
+     * OPTIONAL fast path for `TelescopeService.topTags`: the most common tags across
+     * every stored entry, ties going to the tag seen most recently. Without it the
+     * service lists the whole table and counts in JS.
+     */
+    countTags?(query: TagCountQuery): Promise<KeyCountRow[]>;
 }
+/**
+ * Give a decorating store the optional read methods its inner store has, and only
+ * those: callers detect a capability by the method being there, so a decorator that
+ * always declared them would claim fast paths the store underneath cannot serve, and
+ * one that never did would hide them.
+ */
+export declare function forwardOptionalReads(target: TelescopeStore, inner: TelescopeStore): void;
 //# sourceMappingURL=store.d.ts.map

package/dist/src/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,4CAA4C;IAC5C,KAAK,CAAC,EAAE,IAAI,CAAC;IACb;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0FAA0F;AAC1F,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,MAAM,EAAE,IAAI,CAAC;CACd;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,KAAK,EAAE,IAAI,CAAC;IACZ,8BAA8B;IAC9B,MAAM,EAAE,IAAI,CAAC;IACb,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,yDAAyD;IACzD,KAAK,CAAC,EAAE,IAAI,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEzE,yDAAyD;IACzD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAEvC,mDAAmD;IACnD,IAAI,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAE3C,sCAAsC;IACtC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzB;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3D,iCAAiC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAE1D;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACpE"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"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"}

package/dist/src/store.js

@@ -1,2 +1,17 @@
-export {};
+/** The optional read methods a store may implement on top of the required contract. */
+const OPTIONAL_READS = ['listTraceIds', 'countByBucket', 'countFamilies', 'countTags'];
+/**
+ * Give a decorating store the optional read methods its inner store has, and only
+ * those: callers detect a capability by the method being there, so a decorator that
+ * always declared them would claim fast paths the store underneath cannot serve, and
+ * one that never did would hide them.
+ */
+export function forwardOptionalReads(target, inner) {
+    const writable = target;
+    for (const name of OPTIONAL_READS) {
+        const method = inner[name];
+        if (typeof method === 'function')
+            writable[name] = method.bind(inner);
+    }
+}
 //# sourceMappingURL=store.js.map

package/dist/src/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":""}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AA0MA,uFAAuF;AACvF,MAAM,cAAc,GAAG,CAAC,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,CAAU,CAAC;AAEhG;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAsB,EAAE,KAAqB;IAChF,MAAM,QAAQ,GAAG,MAA4C,CAAC;IAC9D,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,OAAO,MAAM,KAAK,UAAU;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/src/stores/factory.d.ts

@@ -2,6 +2,9 @@ import type { ApplicationService } from '@adonisjs/core/types';
 import type { TelescopeStore } from '../store.js';
 import type { LucidStoreOptions } from './lucid.js';
 import type { InMemoryStoreOptions } from './memory.js';
+import type { ParquetColdStore } from './parquet.js';
+import type { DuckDbEngineOptions } from './parquet_duckdb.js';
+import type { ColdObjectStore, S3LocationOptions } from './parquet_location.js';
 /**
  * Runtime context a {@link StoreProvider} receives when the telescope provider builds the
  * configured store at boot.
@@ -33,6 +36,58 @@ export interface LucidStoreConfig extends LucidStoreOptions {
      */
     connection?: string;
 }
+/**
+ * Where the Parquet cold tier keeps its files: a local directory, an S3 bucket through
+ * the host's own `S3Client`, or any {@link ColdObjectStore}.
+ */
+export type ParquetLocationConfig = {
+    dir: string;
+} | {
+    s3: S3LocationOptions;
+} | ColdObjectStore;
+/**
+ * Which engine reads the cold tier:
+ *
+ * - `'hyparquet'` (default) — pure JavaScript, nothing native, nothing downloaded.
+ * - `'duckdb'` / `{ duckdb: { ... } }` — `@duckdb/node-api` (an optional peer), faster on
+ *   wide scans. Boot fails if it is selected but not installed; there is no silent
+ *   fallback. It never loads DuckDB's `httpfs`/`aws` extensions.
+ */
+export type ParquetEngineConfig = 'hyparquet' | 'duckdb' | {
+    duckdb: DuckDbEngineOptions;
+};
+/** Options for the `parquet` cold-tier driver (used as `storage.tiered({ cold })`). */
+export interface ParquetStoreConfig {
+    location: ParquetLocationConfig;
+    /** Default `'hyparquet'`. */
+    engine?: ParquetEngineConfig;
+    /** Written into file names and rows. Default `<hostname>-<pid>`. */
+    instanceId?: string;
+    /** Rows per row group. Default 10,000. */
+    rowGroupSize?: number;
+    /** Rows per file. Default 200,000. */
+    maxRowsPerFile?: number;
+}
+/** A configured cold tier: a thunk the tiered driver calls at boot. */
+export type ColdStoreProvider = (ctx: StoreContext) => Promise<ParquetColdStore>;
+/** Options for the `tiered` store driver. */
+export interface TieredStoreConfig {
+    /** The hot tier: any driver from this factory (usually `storage.lucid()`) or a store. */
+    hot: StoreProvider | TelescopeStore;
+    /** The cold tier, `storage.parquet({ ... })`. */
+    cold: ColdStoreProvider;
+    /**
+     * How long entries stay hot before `prune` moves them to cold, e.g. `'5m'`. Must be
+     * shorter than `prune.after`, which becomes the cold tier's retention.
+     */
+    hotFor: string | number;
+    /** Hot entries read per page while moving. Default 5,000. */
+    moveBatchSize?: number;
+    /** Entries buffered before a move writes them out as files. Default 50,000. */
+    moveFlushSize?: number;
+    /** Merge each closed hour's files during prune. Default `true`. */
+    compact?: boolean;
+}
 /**
  * The store factory namespace used in `config/telescope.ts`:
  *
@@ -57,5 +112,29 @@ export declare const storage: {
     memory(config?: MemoryStoreConfig): StoreProvider;
     /** A persistent, SQL-backed store on `@adonisjs/lucid` (sqlite / Postgres / MySQL). */
     lucid(config?: LucidStoreConfig): StoreProvider;
+    /**
+     * The Parquet cold tier for {@link storage.tiered}: hourly-partitioned files in a
+     * directory or an S3 bucket. `hyparquet`, `hyparquet-writer` and
+     * `hyparquet-compressors` are optional peers, imported only when this is built;
+     * `@duckdb/node-api` too, and only for `engine: 'duckdb'`.
+     */
+    parquet(config: ParquetStoreConfig): ColdStoreProvider;
+    /**
+     * Hot + cold: entries are recorded into `hot` and moved to `cold` (Parquet) by the
+     * pruner once older than `hotFor`; reads span both. Needs a `prune` block — its
+     * `after` is the cold tier's retention.
+     *
+     * ```ts
+     * stores: {
+     *   tiered: storage.tiered({
+     *     hot: storage.lucid(),
+     *     cold: storage.parquet({ location: { dir: 'storage/telescope' } }),
+     *     hotFor: '5m',
+     *   }),
+     * },
+     * prune: { after: '7d', intervalMs: 60_000 },
+     * ```
+     */
+    tiered(config: TieredStoreConfig): StoreProvider;
 };
 //# sourceMappingURL=factory.d.ts.map

package/dist/src/stores/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/stores/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAqB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,GAAG,EAAE,kBAAkB,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAE3E,6CAA6C;AAC7C,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO;IAClB,+EAA+E;IAC/E,MAAM,UAAS,iBAAiB,GAAQ,aAAa;IAQrD,uFAAuF;IACvF,KAAK,UAAS,gBAAgB,GAAQ,aAAa;CAqBpD,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/stores/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAqB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,GAAG,EAAE,kBAAkB,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAE3E,6CAA6C;AAC7C,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,iBAAiB,CAAA;CAAE,GAAG,eAAe,CAAC;AAElG;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,QAAQ,GAAG;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE3F,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uEAAuE;AACvE,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEjF,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,GAAG,EAAE,aAAa,GAAG,cAAc,CAAC;IACpC,iDAAiD;IACjD,IAAI,EAAE,iBAAiB,CAAC;IACxB;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO;IAClB,+EAA+E;IAC/E,MAAM,UAAS,iBAAiB,GAAQ,aAAa;IAQrD,uFAAuF;IACvF,KAAK,UAAS,gBAAgB,GAAQ,aAAa;IAsBnD;;;;;OAKG;IACH,OAAO,SAAS,kBAAkB,GAAG,iBAAiB;IAgCtD;;;;;;;;;;;;;;;OAeG;IACH,MAAM,SAAS,iBAAiB,GAAG,aAAa;CAkBjD,CAAC"}

package/dist/src/stores/factory.js

@@ -1,3 +1,4 @@
+import { durationToMs } from '../alerts/parse_duration.js';
 /**
  * The store factory namespace used in `config/telescope.ts`:
  *
@@ -44,5 +45,75 @@ export const storage = {
             return new LucidTelescopeStore(client, storeOptions);
         };
     },
+    /**
+     * The Parquet cold tier for {@link storage.tiered}: hourly-partitioned files in a
+     * directory or an S3 bucket. `hyparquet`, `hyparquet-writer` and
+     * `hyparquet-compressors` are optional peers, imported only when this is built;
+     * `@duckdb/node-api` too, and only for `engine: 'duckdb'`.
+     */
+    parquet(config) {
+        return async () => {
+            const [{ ParquetColdStore, loadParquetLibs }, locations] = await Promise.all([
+                import('./parquet.js'),
+                import('./parquet_location.js'),
+            ]);
+            const libs = await loadParquetLibs();
+            const location = 'dir' in config.location && typeof config.location.dir === 'string'
+                ? new locations.DirectoryLocation(config.location.dir)
+                : 's3' in config.location
+                    ? new locations.S3Location(config.location.s3)
+                    : config.location;
+            const engine = config.engine ?? 'hyparquet';
+            return ParquetColdStore.create({
+                location,
+                libs,
+                ...(config.instanceId !== undefined ? { instanceId: config.instanceId } : {}),
+                ...(config.rowGroupSize !== undefined ? { rowGroupSize: config.rowGroupSize } : {}),
+                ...(config.maxRowsPerFile !== undefined ? { maxRowsPerFile: config.maxRowsPerFile } : {}),
+                engine: async (context) => {
+                    if (engine === 'hyparquet') {
+                        const { HyparquetEngine } = await import('./parquet_hyparquet.js');
+                        return new HyparquetEngine(context);
+                    }
+                    const { DuckDbEngine } = await import('./parquet_duckdb.js');
+                    return DuckDbEngine.create(context, engine === 'duckdb' ? {} : engine.duckdb);
+                },
+            });
+        };
+    },
+    /**
+     * Hot + cold: entries are recorded into `hot` and moved to `cold` (Parquet) by the
+     * pruner once older than `hotFor`; reads span both. Needs a `prune` block — its
+     * `after` is the cold tier's retention.
+     *
+     * ```ts
+     * stores: {
+     *   tiered: storage.tiered({
+     *     hot: storage.lucid(),
+     *     cold: storage.parquet({ location: { dir: 'storage/telescope' } }),
+     *     hotFor: '5m',
+     *   }),
+     * },
+     * prune: { after: '7d', intervalMs: 60_000 },
+     * ```
+     */
+    tiered(config) {
+        return async (ctx) => {
+            const hotForMs = durationToMs(config.hotFor);
+            const [{ TieredTelescopeStore }, hot, cold] = await Promise.all([
+                import('./tiered.js'),
+                typeof config.hot === 'function' ? config.hot(ctx) : Promise.resolve(config.hot),
+                config.cold(ctx),
+            ]);
+            return new TieredTelescopeStore({
+                hot,
+                cold,
+                hotForMs,
+                ...(config.moveBatchSize !== undefined ? { moveBatchSize: config.moveBatchSize } : {}),
+                ...(config.moveFlushSize !== undefined ? { moveFlushSize: config.moveFlushSize } : {}),
+                ...(config.compact !== undefined ? { compact: config.compact } : {}),
+            });
+        };
+    },
 };
 //# sourceMappingURL=factory.js.map

package/dist/src/stores/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/stores/factory.ts"],"names":[],"mappings":"AAwCA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,+EAA+E;IAC/E,MAAM,CAAC,MAAM,GAAsB,EAAE;QACnC,OAAO,KAAK,IAAI,EAAE;YAChB,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,UAAU,CAAC;YACrD,OAAO,IAAI,sBAAsB,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACpF,CAAC,CAAC;IACJ,CAAC;IAED,uFAAuF;IACvF,KAAK,CAAC,MAAM,GAAqB,EAAE;QACjC,OAAO,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;YACvB,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YAE3D,2EAA2E;YAC3E,+EAA+E;YAC/E,2EAA2E;YAC3E,2EAA2E;YAC3E,6EAA6E;YAC7E,sEAAsE;YACtE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAE/C,CAAC;YAEF,gFAAgF;YAChF,uEAAuE;YACvE,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,CAAC;YAC5D,OAAO,IAAI,mBAAmB,CAAC,MAAsC,EAAE,YAAY,CAAC,CAAC;QACvF,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/stores/factory.ts"],"names":[],"mappings":"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"}

package/dist/src/stores/lucid.d.ts

@@ -1,5 +1,5 @@
 import { type Entry, type RecordInput } from '../entry.js';
-import type { BucketCountQuery, BucketCountRow, EntryQuery, TelescopeStore, TraceIdQuery, TraceIdRow } from '../store.js';
+import type { BucketCountQuery, BucketCountRow, EntryQuery, FamilyCountQuery, KeyCountRow, TagCountQuery, TelescopeStore, TraceIdQuery, TraceIdRow } from '../store.js';
 /**
  * The table {@link LucidTelescopeStore} reads and writes. Override via
  * {@link LucidStoreOptions.tableName} when `telescope_entries` collides with an
@@ -33,12 +33,13 @@ export interface TelescopeColumns {
  * indexes `list` / `prune` / `topFamilies` lean on, as one statement per array
  * element so each can be issued through Lucid's `rawQuery`.
  *
- * Portable across sqlite / Postgres / MySQL (quoted identifiers, no dialect-only
- * column types). A real deployment should still prefer the bundled migration stub
+ * Identifiers are double-quoted (sqlite / Postgres) unless `dialect` is a Lucid
+ * MySQL dialect name (`mysql` / `mysql2`), which gets backticks and plain
+ * `CREATE INDEX`; the column types are portable. A real deployment should still prefer the bundled migration stub
  * so the schema is versioned, but this lets a store stand itself up in tests and
  * scripts without a migration runner.
  */
-export declare function createTableStatements(tableName?: string): string[];
+export declare function createTableStatements(tableName?: string, dialect?: string): string[];
 /**
  * The marker table backing the fingerprint gate. One row PER owned entries table
  * (keyed by that table's name, so two telescope tables in one database never
@@ -60,6 +61,16 @@ export interface LucidDatabaseLike {
     table(table: string): LucidInsertBuilderLike;
     /** Run a raw SQL statement (DDL, `MAX(sequence)` seed). */
     rawQuery(sql: string, bindings?: unknown[]): Promise<unknown>;
+    /** The dialect, when this is a single connection client. Picks the DDL's identifier quoting. */
+    dialect?: {
+        name: string;
+    };
+    /** The default connection, when this is the `Database` facade. */
+    connection?(): {
+        dialect?: {
+            name: string;
+        };
+    };
 }
 /** The structural query-builder surface the store leans on (Knex-shaped). */
 export interface LucidQueryBuilderLike {
@@ -70,6 +81,8 @@ export interface LucidQueryBuilderLike {
     whereNotNull(column: string): this;
     orderBy(column: string, direction: 'asc' | 'desc'): this;
     groupBy(...columns: string[]): this;
+    /** Group by an expression. Optional: without it, `countByBucket` buckets rows in JS. */
+    groupByRaw?(sql: string, bindings?: unknown[]): this;
     limit(value: number): this;
     offset(value: number): this;
     /** Aggregate MAX with an alias, e.g. `max('created_at as last_at')`. Chainable so it
@@ -81,7 +94,8 @@ export interface LucidQueryBuilderLike {
     first(): Promise<Record<string, unknown> | null>;
 }
 export interface LucidInsertBuilderLike {
-    insert(row: Record<string, unknown>): Promise<unknown>;
+    /** Insert one row, or several in one statement. */
+    insert(row: Record<string, unknown> | Record<string, unknown>[]): Promise<unknown>;
 }
 /** Options for {@link LucidTelescopeStore} (and the `storage.lucid` factory). */
 export interface LucidStoreOptions {
@@ -110,6 +124,15 @@ export interface LucidStoreOptions {
  * `sequence` is seeded from `MAX(sequence)` on first use so it keeps climbing
  * across process restarts.
  *
+ * Writes are buffered: every entry recorded during one tick of the event loop goes
+ * out in one multi-row INSERT (split to stay under each dialect's bind limit), one
+ * statement at a time, so the store never holds more than one pooled connection
+ * for writing and a burst of watcher events costs a handful of round trips instead
+ * of one each. `record()` still resolves once its entry is persisted.
+ *
+ * Every query the store runs is marked as telescope's own work (see
+ * `self_scope.ts`), so the query watcher never records them.
+ *
  * Usually you don't construct this directly: `config/telescope.ts` selects it via
  * `storage.lucid({ ... })` and the provider builds it for you, lazily importing
  * `@adonisjs/lucid` only when the `lucid` driver is the active one.
@@ -122,16 +145,17 @@ export declare class LucidTelescopeStore implements TelescopeStore {
     /** Lazily-resolved init (table creation + sequence seed), run at most once. */
     private ready;
     private sequence;
-    /**
-     * Single-flight write chain: every `record()` insert is queued behind the previous one so the
-     * store holds at most ONE pooled connection at a time. A burst of watcher events can therefore
-     * never exhaust the host app's connection pool (which telescope may share). Reads
-     * (`get`/`list`/`prune`) are user-initiated and low-frequency, so they are intentionally NOT
-     * serialized.
-     */
-    private writeTail;
+    private pending;
+    /** The running drain, while one is scheduled or writing. */
+    private draining;
+    private dropped;
+    private warnedDrop;
     constructor(db: LucidDatabaseLike, options?: LucidStoreOptions);
     record<TContent>(input: RecordInput<TContent>): Promise<Entry<TContent>>;
+    /** Entries dropped because the write buffer was full. */
+    get droppedCount(): number;
+    /** Resolves once every entry recorded so far has been written (or has failed). */
+    flush(): Promise<void>;
     get(id: string): Promise<Entry | null>;
     list(query?: EntryQuery): Promise<Entry[]>;
     /**
@@ -145,29 +169,50 @@ export declare class LucidTelescopeStore implements TelescopeStore {
      */
     listTraceIds(query: TraceIdQuery): Promise<TraceIdRow[]>;
     /**
-     * Per-bucket, per-type counts for the throughput chart.
+     * Per-bucket, per-type counts for the throughput chart, grouped in SQL so one row
+     * per `(bucket, type)` leaves the database instead of one per entry.
      *
-     * The win here is the PROJECTION, not the grouping: the chart needs `created_at`
-     * and `type` and nothing else, but the only way to get them was `list()`, which
-     * does `select('*')` — shipping every row's `content` JSON blob out of the database
-     * and running it through `hydrate()`, to then discard all of it except a timestamp
-     * and a string. Two scalar columns instead of a blob is orders of magnitude less
-     * bytes on the wire and no per-row JSON parse.
-     *
-     * The bucketing itself stays in JS, deliberately. Doing it in SQL needs a raw
-     * select expression (`(created_at - ?) / ?`), and Lucid exposes `groupByRaw` but no
-     * `selectRaw` — the alternative is `rawQuery`, whose result shape differs per driver
-     * (`{ rows }` on Postgres, an array on SQLite). Trading a portability bug for the
-     * second-order win is a bad deal; the row count is what would justify it, and after
-     * the redis-watcher filter that count drops by roughly an order of magnitude. If
-     * this is still hot with a clean table, THAT is when it earns the raw query.
+     * The bucket is `(created_at - start) - ((created_at - start) % bucketMs)`: integer
+     * arithmetic every dialect evaluates the same way, where `/` would be integer
+     * division on some and decimal on MySQL. Each group reports its newest
+     * `created_at`, and the bucket index is computed from that in JS. A builder
+     * without `groupByRaw` gets the per-row projection, bucketed here.
      */
     countByBucket(query: BucketCountQuery): Promise<BucketCountRow[]>;
+    /**
+     * The busiest families, counted by `GROUP BY family_hash` — see
+     * {@link TelescopeStore.countFamilies}.
+     */
+    countFamilies(query: FamilyCountQuery): Promise<KeyCountRow[]>;
+    /**
+     * The most common tags — see {@link TelescopeStore.countTags}. Tags are JSON text,
+     * so they are counted here, reading only the `tags` column a page at a time in
+     * primary-key order.
+     */
+    countTags(query: TagCountQuery): Promise<KeyCountRow[]>;
     count(): Promise<number>;
+    /**
+     * Deletes oldest-first, {@link PRUNE_BATCH_ROWS} rows per statement, each batch
+     * addressed by its newest row's position rather than by id: a backlog of any size
+     * is pruned in bounded statements that never approach a bind limit.
+     */
     prune(olderThan: Date, keepLast?: number): Promise<number>;
     clear(): Promise<void>;
     /** Cap enforcement helper for callers running a scheduled trim. */
     get capacity(): number | null;
+    /** The first row of an ordered query, as a position. */
+    private position;
+    /** Start a drain on the next tick unless one is already running. */
+    private scheduleDrain;
+    /** Write the buffer out, batch by batch, until it is empty. */
+    private drain;
+    /** The oldest pending writes that fit one INSERT. */
+    private takeBatch;
+    /**
+     * One multi-row INSERT. When it fails, its rows are retried one at a time, so a
+     * row the database rejects fails only its own `record()`.
+     */
+    private writeBatch;
     /** Run table creation (optional) + sequence seeding exactly once. */
     private init;
     private doInit;

package/dist/src/stores/lucid.d.ts.map

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