@adonis-agora/telescope 0.22.0 → 0.23.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @adonis-agora/telescope
 
+## 0.23.0
+
+### Minor Changes
+
+- [#199](https://github.com/DavideCarvalho/adonis-agora-telescope/pull/199) [`5fd17c2`](https://github.com/DavideCarvalho/adonis-agora-telescope/commit/5fd17c2a51043151155f1a6b46507183c0c41bce) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Add a tiered store: `storage.tiered({ hot, cold: storage.parquet({ location, engine }), hotFor })` keeps a hot driver (usually `storage.lucid()`) minutes deep and, on each prune cycle, moves older entries to hourly Parquet files in a directory or on S3 (through the host's own `S3Client`), deleting them from the hot tier only after the files are written. Reads route hot-then-cold and merge newest-first without duplicates, so `{ page, size }` pages across the tier boundary. The cold tier is read with pure-JS hyparquet by default, or DuckDB (`engine: 'duckdb'`, optional peer `@duckdb/node-api`), which is started with extension auto-load off and external access limited to its data directory, so it never loads `httpfs`/`aws`. New optional peers: `hyparquet`, `hyparquet-writer`, `hyparquet-compressors`, `@duckdb/node-api`, `@aws-sdk/client-s3`. See the new "Scaling storage" docs page.
+
+### Patch Changes
+
+- [#199](https://github.com/DavideCarvalho/adonis-agora-telescope/pull/199) [`5fd17c2`](https://github.com/DavideCarvalho/adonis-agora-telescope/commit/5fd17c2a51043151155f1a6b46507183c0c41bce) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - The Parquet cold tier no longer leaves unhandled promise rejections behind when a file is deleted while it is being read (retention or compaction racing a dashboard read). hyparquet prefetches several byte ranges per file on filtered reads and awaits only the first that fails; the rest used to reject unhandled, which crashes a Node process running with the default `--unhandled-rejections=throw`.
+
 ## 0.22.0
 
 ### Minor Changes

package/dist/src/ai/index.d.ts

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.22.0";
+export declare const VERSION = "0.23.0";
 export type { ResolvedTelescopeAiConfig, TelescopeAiConfig, } from './define_config.js';
 export { DEFAULT_MAX_TOKENS, DEFAULT_MODEL, defineConfig, resolveConfig, } from './define_config.js';
 export type { Diagnosis, DiagnosisConfidence, ExceptionEntryContent } from './diagnoser.js';

package/dist/src/ai/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.22.0';
+export const VERSION = '0.23.0';
 // — config —
 export { DEFAULT_MAX_TOKENS, DEFAULT_MODEL, defineConfig, resolveConfig, } from './define_config.js';
 // — diagnosis model + parsing —

package/dist/src/alerts/index.d.ts

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.22.0";
+export declare const VERSION = "0.23.0";
 export type { AlertChannel, ChannelFetch, ConsoleSink } from './alert_channel.js';
 export { consoleChannel, customChannel, slackChannel, webhookChannel, } from './alert_channel.js';
 export type { AlertDiagnosis, AlertGeoLocation, AlertMetric, AlertPayload, AlertRule, ExceptionAlertContext, GeoLookup, ResolvedAlerts, } from './alert_rule.js';

package/dist/src/alerts/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.22.0';
+export const VERSION = '0.23.0';
 // — channels —
 export { consoleChannel, customChannel, slackChannel, webhookChannel, } from './alert_channel.js';
 // — alerter (exception source → tracker → channels) —

package/dist/src/index.d.ts

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.22.0";
+export declare const VERSION = "0.23.0";
 export { configure } from '../configure.js';
 export type { DiagnoserLike, DiagnosisCoordinatorOptions, DiagnosisSummary, } from './ai/diagnosis_coordinator.js';
 export { DiagnosisCoordinator, formatDiagnosisMarkdown, } from './ai/diagnosis_coordinator.js';
@@ -59,12 +59,19 @@ export { SamplingTelescopeStore } from './sampling/sampling_store.js';
 export type { CountBucket } from './service.js';
 export { TelescopeService } from './service.js';
 export type { EntryQuery, TelescopeStore } from './store.js';
-export type { LucidStoreConfig, MemoryStoreConfig, StoreContext, StoreProvider, } from './stores/factory.js';
+export type { ColdStoreProvider, LucidStoreConfig, MemoryStoreConfig, ParquetEngineConfig, ParquetLocationConfig, ParquetStoreConfig, StoreContext, StoreProvider, TieredStoreConfig, } from './stores/factory.js';
 export { storage } from './stores/factory.js';
 export type { CreateTableOptions, LucidDatabaseLike, LucidInsertBuilderLike, LucidQueryBuilderLike, LucidStoreOptions, TelescopeColumns, } from './stores/lucid.js';
 export { createTableStatements, createTelescopeTable, DEFAULT_TABLE_NAME, LucidTelescopeStore, SCHEMA_META_TABLE_NAME, } from './stores/lucid.js';
 export type { InMemoryStoreOptions } from './stores/memory.js';
 export { InMemoryTelescopeStore } from './stores/memory.js';
+export type { ColdEngineContext, ColdFile, ColdReadEngine, ParquetColdStoreOptions, } from './stores/parquet.js';
+export { ParquetColdStore } from './stores/parquet.js';
+export type { DuckDbEngineOptions } from './stores/parquet_duckdb.js';
+export type { ColdObject, ColdObjectStore, S3ClientLike, S3LocationOptions, } from './stores/parquet_location.js';
+export { DirectoryLocation, S3Location } from './stores/parquet_location.js';
+export type { TieredPruneReport, TieredStoreOptions } from './stores/tiered.js';
+export { TieredTelescopeStore } from './stores/tiered.js';
 export type { EntrySubscriber, Unsubscribe } from './stream/entry_events.js';
 export { EntryEvents } from './stream/entry_events.js';
 export type { StreamOptions, StreamSession } from './stream/stream_handler.js';

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

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

package/dist/src/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.22.0';
+export const VERSION = '0.23.0';
 // Re-export the configure hook from the package root so `node ace configure` finds it
 export { configure } from '../configure.js';
 // — AI diagnosis coordinator (wires the MCP tool + the alerter; SDK-free) —
@@ -51,6 +51,9 @@ export { TelescopeService } from './service.js';
 export { storage } from './stores/factory.js';
 export { createTableStatements, createTelescopeTable, DEFAULT_TABLE_NAME, LucidTelescopeStore, SCHEMA_META_TABLE_NAME, } from './stores/lucid.js';
 export { InMemoryTelescopeStore } from './stores/memory.js';
+export { ParquetColdStore } from './stores/parquet.js';
+export { DirectoryLocation, S3Location } from './stores/parquet_location.js';
+export { TieredTelescopeStore } from './stores/tiered.js';
 // — live-stream (SSE entry-events pub/sub) —
 export { EntryEvents } from './stream/entry_events.js';
 export { DEFAULT_HEARTBEAT_MS, streamEntries } from './stream/stream_handler.js';

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC;AAEhC,sFAAsF;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM5C,4EAA4E;AAC5E,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,+DAA+D;AAC/D,OAAO,EAEL,mBAAmB,EAEnB,sBAAsB,EAMtB,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,6BAA6B,EAE7B,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAElC,mCAAmC;AACnC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAa3F,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAMnC,eAAe;AACf,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAKjE,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAgB5D,oBAAoB;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAUhE,+EAA+E;AAC/E,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAMxB,sEAAsE;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAe9D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,cAAc,EACd,+BAA+B,EAC/B,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAWxD,OAAO,EACL,0BAA0B,EAC1B,UAAU,EACV,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASpD,oEAAoE;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAM9C,qCAAqC;AACrC,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAO/E,gBAAgB;AAChB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,MAAM,EACN,aAAa,EACb,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,yBAAyB;AACzB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,gCAAgC,EAChC,uBAAuB,EACvB,6BAA6B,EAC7B,kBAAkB,EAClB,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAYvB,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,iDAAiD;AACjD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAShD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAS9C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,6CAA6C;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/index.d.ts

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.22.0";
+export declare const VERSION = "0.23.0";
 export type { McpToolName, ResolvedTelescopeMcpConfig, TelescopeMcpConfig, } from './define_config.js';
 export { defineConfig, MCP_TOOL_NAMES, resolveConfig } from './define_config.js';
 export type { DiagnoseExceptionHook, JsonRpcRequest, McpToolSpec, TelescopeMcpServerOptions, } from './server.js';

package/dist/src/mcp/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.22.0';
+export const VERSION = '0.23.0';
 // — config —
 export { defineConfig, MCP_TOOL_NAMES, resolveConfig } from './define_config.js';
 // — server (plain, testable JSON-RPC surface) —

package/dist/src/profiling/index.d.ts

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.22.0";
+export declare const VERSION = "0.23.0";
 export { aggregateCpuProfile } from './aggregate-profile.js';
 export type { CpuProfilerOptions, CpuProfilerResult, InspectorSessionLike, SessionFactory, } from './cpu-profiler.js';
 export { CpuProfiler, defaultSessionFactory } from './cpu-profiler.js';

package/dist/src/profiling/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.22.0';
+export const VERSION = '0.23.0';
 export { aggregateCpuProfile } from './aggregate-profile.js';
 export { CpuProfiler, defaultSessionFactory } from './cpu-profiler.js';
 export { defineConfig, resolveConfig } from './define_config.js';

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/parquet.d.ts

@@ -0,0 +1,184 @@
+import type { Entry } from '../entry.js';
+import type { BucketCountQuery, BucketCountRow, EntryQuery, TraceIdQuery, TraceIdRow } from '../store.js';
+import { type ColdObjectStore } from './parquet_location.js';
+type Hyparquet = typeof import('hyparquet');
+type HyparquetWriter = typeof import('hyparquet-writer');
+type FileMetaData = import('hyparquet').FileMetaData;
+type AsyncBuffer = import('hyparquet').AsyncBuffer;
+type Compressors = import('hyparquet').Compressors;
+/** Row-group time bounds, read from the `created_at` column statistics. */
+export interface RowGroupStats {
+    rowStart: number;
+    rowEnd: number;
+    minMs: number;
+    maxMs: number;
+}
+/** What the cold store knows about one file without reading its rows. */
+export interface ColdFile {
+    key: string;
+    size: number;
+    type: string;
+    hourStartMs: number;
+    numRows: number;
+    minMs: number;
+    maxMs: number;
+    rowGroups: RowGroupStats[];
+}
+/** The libraries both engines share: hyparquet reads footers, hyparquet-writer writes. */
+export interface ParquetLibs {
+    hyparquet: Hyparquet;
+    writer: HyparquetWriter;
+    compressors: Compressors;
+}
+/**
+ * Everything an engine needs to read files: the location, the shared libraries and
+ * the footer cache. Engines never list or write; the cold store hands them the
+ * candidate files already pruned by partition and statistics.
+ */
+export interface ColdEngineContext {
+    location: ColdObjectStore;
+    libs: ParquetLibs;
+    /** Parsed footer of a file (cached). */
+    metadata(file: ColdFile): Promise<FileMetaData>;
+    /** A hyparquet `AsyncBuffer` over a file (ranged reads through the location). */
+    buffer(file: ColdFile): AsyncBuffer;
+}
+/**
+ * A cold-tier reader. `files` arrive pruned by the query's type and time bounds and
+ * sorted newest-first by their newest row; every method must treat a file that has
+ * vanished since it was listed (compaction, retention) as empty.
+ */
+export interface ColdReadEngine {
+    readonly name: 'hyparquet' | 'duckdb';
+    /** The newest `limit` matches (all matches when `limit` is undefined), newest-first. */
+    list(files: ColdFile[], query: EntryQuery, limit: number | undefined): Promise<Entry[]>;
+    get(files: ColdFile[], id: string): Promise<Entry | null>;
+    /** The `limit` most-recently-seen trace ids in `files`, with their newest timestamp. */
+    traceIds(files: ColdFile[], query: Pick<TraceIdQuery, 'before' | 'after'>, limit: number): Promise<TraceIdRow[]>;
+    countByBucket(files: ColdFile[], query: BucketCountQuery): Promise<BucketCountRow[]>;
+    close(): Promise<void>;
+}
+/** Builds a {@link ColdReadEngine} for a store. */
+export type ColdEngineFactory = (context: ColdEngineContext) => ColdReadEngine | Promise<ColdReadEngine>;
+/** Options for {@link ParquetColdStore}. */
+export interface ParquetColdStoreOptions {
+    location: ColdObjectStore;
+    /** Builds the reader, bound to this store's footer cache. */
+    engine: ColdEngineFactory;
+    libs: ParquetLibs;
+    /**
+     * Written into every file name (`<instanceId>-<uuid>.parquet`) and the `instance_id`
+     * column, so files from different pods never collide. Defaults to `<hostname>-<pid>`.
+     */
+    instanceId?: string;
+    /** Rows per row group. Default 10,000. */
+    rowGroupSize?: number;
+    /** Rows per file before a write starts a new file. Default 200,000. */
+    maxRowsPerFile?: number;
+    /** How long a directory listing is reused, in ms. Default 2,000. */
+    listingTtlMs?: number;
+    /** Parsed footers kept in memory. Default 2,000 files. */
+    metadataCacheSize?: number;
+    /** Closed hours compacted per {@link ParquetColdStore.compact} call. Default 4. */
+    compactPartitionsPerRun?: number;
+}
+/**
+ * Entries as hourly-partitioned Parquet files in a {@link ColdObjectStore}:
+ *
+ * ```
+ * type=<type>/dt=<yyyy-mm-dd>/hour=<hh>/<instanceId>-<uuid>.parquet
+ * ```
+ *
+ * Files are append-only and immutable: writing adds files, {@link compact} replaces a
+ * closed hour's files with one merged file (written before the inputs are deleted),
+ * and retention deletes whole files. Rows inside a file are sorted by `created_at, id`
+ * with ~10k-row groups and statistics on, so time-bounded reads skip row groups.
+ *
+ * This is the cold half of `storage.tiered()`; it is not a {@link TelescopeStore} on its
+ * own because recording one entry at a time as Parquet would make one file per entry.
+ */
+export declare class ParquetColdStore {
+    readonly location: ColdObjectStore;
+    engine: ColdReadEngine;
+    readonly instanceId: string;
+    private readonly libs;
+    private readonly rowGroupSize;
+    private readonly maxRowsPerFile;
+    private readonly listingTtlMs;
+    private readonly metadataCacheSize;
+    private readonly compactPartitionsPerRun;
+    private readonly listings;
+    /** Small, per-file stats for every file seen (dropped when the file disappears). */
+    private readonly stats;
+    /** Parsed footers, LRU-bounded (Map iteration order is insertion order). */
+    private readonly footers;
+    /** Build a store and its engine (the engine may need async setup, e.g. DuckDB). */
+    static create(options: ParquetColdStoreOptions): Promise<ParquetColdStore>;
+    private constructor();
+    /**
+     * Write entries as Parquet, one or more files per `(type, hour)`. Resolves to the keys
+     * written, so a caller can delete them again if a later step of its own fails.
+     */
+    write(entries: Entry[]): Promise<string[]>;
+    private encode;
+    /** Entries matching `query`, newest-first, honouring `{ page, size }`. */
+    list(query?: EntryQuery): Promise<Entry[]>;
+    /** The newest `limit` matches with no page offset — what the tiered merge needs. */
+    top(query: EntryQuery, limit: number | undefined): Promise<Entry[]>;
+    get(id: string): Promise<Entry | null>;
+    listTraceIds(query: TraceIdQuery): Promise<TraceIdRow[]>;
+    /** The `limit` most-recently-seen traces, no offset (for the tiered merge). */
+    topTraceIds(query: Pick<TraceIdQuery, 'before' | 'after'>, limit: number): Promise<TraceIdRow[]>;
+    countByBucket(query: BucketCountQuery): Promise<BucketCountRow[]>;
+    /** Rows in the cold tier, from file footers (no rows are read). */
+    count(): Promise<number>;
+    /**
+     * The newest `created_at` the cold tier could hold for `query`, or `null` when it holds
+     * nothing for it. Lets the tiered store skip the cold tier when a page is already
+     * filled by hot entries that are all newer.
+     */
+    newestCreatedAt(query: EntryQuery): Promise<Date | null>;
+    /**
+     * Delete every file whose whole hour is older than `olderThan`, keeping the newest
+     * files of that doomed set until they hold at least `keepLast` rows. Retention is
+     * file-granular: an hour stays until all of it has expired. Resolves to the rows
+     * deleted.
+     */
+    expire(olderThan: Date, keepLast?: number): Promise<number>;
+    /**
+     * Merge the files of closed hours (hours that ended before `closedBefore`) so each
+     * holds one file per {@link ParquetColdStoreOptions.maxRowsPerFile} rows instead of
+     * one per prune cycle. The merged file is written before its inputs are deleted, so
+     * a reader never loses rows; one that lists in between sees both and the merge on
+     * read drops the duplicate ids. Resolves to the number of input files replaced.
+     */
+    compact(closedBefore: Date): Promise<number>;
+    /** Delete every file. */
+    clear(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Files that can hold rows for `query`: its type's prefix only, hours outside the
+     * time bounds dropped by partition, then files outside them dropped by footer stats.
+     * Sorted newest-first by each file's newest row.
+     */
+    private candidates;
+    private list_;
+    private listAll;
+    /** The file with footer stats filled in, or `null` when it no longer exists. */
+    private withStats;
+    /** Parsed footer for a file, through a bounded LRU. */
+    metadata(file: ColdFile): Promise<FileMetaData>;
+    buffer(file: ColdFile): AsyncBuffer;
+    private forget;
+}
+/**
+ * Load the hyparquet trio. They are optional peers (only `storage.tiered()` needs them),
+ * so a missing one fails boot with a message naming it.
+ */
+export declare function loadParquetLibs(): Promise<ParquetLibs>;
+/** Keep the first occurrence of each id (callers pass newest-first lists). */
+export declare function dedupeById(entries: Entry[]): Entry[];
+/** Merge newest-first lists into one newest-first list without duplicate ids. */
+export declare function mergeNewestFirst(...lists: Entry[][]): Entry[];
+export {};
+//# sourceMappingURL=parquet.d.ts.map

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

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