@camstack/system 1.2.129 → 1.2.130

package/dist/builtins/sqlite-storage/table-sizes.d.ts

@@ -25,11 +25,21 @@
  * caller runs it ONCE, well after boot, off the critical path — never on the
  * path a config read waits behind.
  */
-/** One `dbstat` group: a table (or index) and the space it occupies. */
+/** What kind of object a `dbstat` group is. An index is an object too. */
+export type SqliteObjectKind = 'table' | 'index' | 'unknown';
+/** One `dbstat` group: an object and the space it occupies. */
 export interface TableSizeRow {
     readonly name: string;
+    /**
+     * `sqlite_master.tbl_name` — for a table this IS the table, for an index it
+     * is the table the index belongs to. Ownership is read from the relation
+     * SQLite already stores; an index name carries none (`idx_b_outbox` only
+     * looks parseable, and `sqlite_autoindex_a:media_1` would parse to nonsense).
+     */
+    readonly tableName: string;
     readonly bytes: number;
     readonly pages: number;
+    readonly kind: SqliteObjectKind;
 }
 /** One line of the report. */
 export interface TableSizeEntry {
@@ -38,14 +48,27 @@ export interface TableSizeEntry {
     readonly pages: number;
     /** Share of the whole file, percent. 0 when the file size is unknown. */
     readonly pct: number;
+    readonly kind: SqliteObjectKind;
+}
+/** Everything one addon prefix owns, tables and their indexes together. */
+export interface OwnerRollup {
+    readonly owner: string;
+    readonly sizeMb: number;
+    readonly objects: number;
 }
 export interface TableSizeReport {
     readonly tables: readonly TableSizeEntry[];
     /** Megabytes held by everything below the cut. */
     readonly otherMb: number;
-    /** How many tables are behind `otherMb`. */
-    readonly otherTables: number;
+    /** How many OBJECTS are behind `otherMb` — tables and indexes alike. */
+    readonly otherObjects: number;
+    readonly tableCount: number;
+    readonly indexCount: number;
+    /** Every owner, biggest first. */
+    readonly byOwner: readonly OwnerRollup[];
 }
+/** The label for anything that is not a per-addon scoped collection. */
+export declare const UNSCOPED_OWNER = "(unscoped)";
 /**
  * Rank tables by the space they hold and keep the top `limit`.
  *
@@ -66,5 +89,7 @@ export declare function summariseTableSizes(rows: readonly TableSizeRow[], total
 export declare const STORAGE_REPORT_DELAY_MS = 60000;
 /** Top-N tables named individually; the remainder is reported as a tail. */
 export declare const STORAGE_REPORT_TOP_N = 10;
+/** Owners named individually in the log line. */
+export declare const STORAGE_REPORT_TOP_OWNERS = 15;
 /** `dbstat` shape, narrowed without a cast. */
 export declare function toTableSizeRow(value: unknown): TableSizeRow | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.129",
+  "version": "1.2.130",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",