zerobucket 0.4.0 → 0.6.0

package/dist/{chunk-W2C37XYV.js → chunk-SCPC3QDR.js}

@@ -65,4 +65,4 @@ export {
   StorageError,
   AccessDeniedError
 };
-//# sourceMappingURL=chunk-W2C37XYV.js.map
+//# sourceMappingURL=chunk-SCPC3QDR.js.map

package/dist/{client-WZ4VRCPi.d.cts → client-C7xs1dlr.d.cts}

@@ -125,6 +125,50 @@ interface StreamOptions$1 extends CallOptions {
         end: number;
     };
 }
+/** Filters for maintenance listings (CLI `verify` / `tier`). All optional; combined with AND. */
+interface ImageListOptions {
+    /** Return a random sample of this many images instead of all of them. */
+    sample?: number;
+    limit?: number;
+    /** Only images with size_bytes >= this. */
+    minSize?: number;
+    /** Only images created at least this many days ago. */
+    olderThanDays?: number;
+    /** Only images whose bytes are still in the database (not tiered). */
+    onlyUntiered?: boolean;
+}
+interface ImageListEntry {
+    id: string;
+    /** Bytes live in object storage, not in the database. */
+    tiered: boolean;
+}
+/** Storage statistics for `zerobucket info`. */
+interface StorageInfo {
+    mode: "classic" | "dedup";
+    /** Number of images (references, in dedup mode). */
+    count: number;
+    /** Sum of every image's size_bytes as recorded by the application (logical size). */
+    totalBytes: number;
+    oldest: string | null;
+    newest: string | null;
+    /** Human-readable on-disk size, if the database can tell. */
+    onDisk: string | null;
+    byFormat: {
+        mimeType: string;
+        count: number;
+        bytes: number;
+    }[];
+    /** Classic mode: images currently living in object storage. */
+    tiered?: {
+        count: number;
+        bytes: number;
+    };
+    /** Dedup mode: distinct stored blobs and the bytes they physically occupy. */
+    dedup?: {
+        blobs: number;
+        storedBytes: number;
+    };
+}
 interface StorageBackend {
     /** Resolve once the backend is connected and migrated. Safe to call repeatedly. */
     ready(): Promise<void>;
@@ -153,6 +197,10 @@ interface StorageBackend {
         duplicateReferencesFound: number;
         alreadyMigrated: number;
     }>;
+    /** Maintenance: storage statistics, or null if the tables do not exist yet. */
+    getInfo?(): Promise<StorageInfo | null>;
+    /** Maintenance: list ids matching the filters (oldest first, or random when sampling). */
+    listImages?(opts?: ImageListOptions): Promise<ImageListEntry[]>;
     close(): Promise<void>;
 }
 
@@ -422,4 +470,4 @@ declare function readInput(image: ImageInput, filename: string | undefined, maxB
     filename: string | undefined;
 }>;
 
-export { type BatchDeleteResult as B, type CallOptions as C, DEFAULT_MAX_BYTES as D, type GetOptions as G, type Image as I, type OperationEvent as O, type PreparedRow as P, type Queryable as Q, type StorageBackend as S, type ValidatedContent as V, type WritableLike as W, ZeroBucket as Z, type ObjectStorageLike as a, type StoredRecord as b, type StoredRecordMetadata as c, type StreamOptions$1 as d, type ContentValidator as e, type BatchGetResult as f, type BatchPutResult as g, type BeforeGetHook as h, type BeforePutHook as i, type Connection as j, type ImageInput as k, type ImageMetadata as l, ObjectStorage as m, type ObjectStorageOptions as n, type OptimizationResult as o, type OptimizeOptions as p, type PutManyOptions as q, type PutOptions as r, type SqliteDatabaseLike as s, type StreamOptions as t, type ZeroBucketOptions as u, optimizeImage as v, readInput as w };
+export { type BatchDeleteResult as B, type CallOptions as C, DEFAULT_MAX_BYTES as D, type GetOptions as G, type ImageListOptions as I, type OperationEvent as O, type PreparedRow as P, type Queryable as Q, type StorageBackend as S, type ValidatedContent as V, type WritableLike as W, ZeroBucket as Z, type ObjectStorageLike as a, type StoredRecord as b, type StoredRecordMetadata as c, type StreamOptions$1 as d, type StorageInfo as e, type ImageListEntry as f, type ContentValidator as g, type BatchGetResult as h, type BatchPutResult as i, type BeforeGetHook as j, type BeforePutHook as k, type Connection as l, type Image as m, type ImageInput as n, type ImageMetadata as o, ObjectStorage as p, type ObjectStorageOptions as q, type OptimizationResult as r, type OptimizeOptions as s, type PutManyOptions as t, type PutOptions as u, type SqliteDatabaseLike as v, type StreamOptions as w, type ZeroBucketOptions as x, optimizeImage as y, readInput as z };

package/dist/{client-WZ4VRCPi.d.ts → client-C7xs1dlr.d.ts}

@@ -125,6 +125,50 @@ interface StreamOptions$1 extends CallOptions {
         end: number;
     };
 }
+/** Filters for maintenance listings (CLI `verify` / `tier`). All optional; combined with AND. */
+interface ImageListOptions {
+    /** Return a random sample of this many images instead of all of them. */
+    sample?: number;
+    limit?: number;
+    /** Only images with size_bytes >= this. */
+    minSize?: number;
+    /** Only images created at least this many days ago. */
+    olderThanDays?: number;
+    /** Only images whose bytes are still in the database (not tiered). */
+    onlyUntiered?: boolean;
+}
+interface ImageListEntry {
+    id: string;
+    /** Bytes live in object storage, not in the database. */
+    tiered: boolean;
+}
+/** Storage statistics for `zerobucket info`. */
+interface StorageInfo {
+    mode: "classic" | "dedup";
+    /** Number of images (references, in dedup mode). */
+    count: number;
+    /** Sum of every image's size_bytes as recorded by the application (logical size). */
+    totalBytes: number;
+    oldest: string | null;
+    newest: string | null;
+    /** Human-readable on-disk size, if the database can tell. */
+    onDisk: string | null;
+    byFormat: {
+        mimeType: string;
+        count: number;
+        bytes: number;
+    }[];
+    /** Classic mode: images currently living in object storage. */
+    tiered?: {
+        count: number;
+        bytes: number;
+    };
+    /** Dedup mode: distinct stored blobs and the bytes they physically occupy. */
+    dedup?: {
+        blobs: number;
+        storedBytes: number;
+    };
+}
 interface StorageBackend {
     /** Resolve once the backend is connected and migrated. Safe to call repeatedly. */
     ready(): Promise<void>;
@@ -153,6 +197,10 @@ interface StorageBackend {
         duplicateReferencesFound: number;
         alreadyMigrated: number;
     }>;
+    /** Maintenance: storage statistics, or null if the tables do not exist yet. */
+    getInfo?(): Promise<StorageInfo | null>;
+    /** Maintenance: list ids matching the filters (oldest first, or random when sampling). */
+    listImages?(opts?: ImageListOptions): Promise<ImageListEntry[]>;
     close(): Promise<void>;
 }
 
@@ -422,4 +470,4 @@ declare function readInput(image: ImageInput, filename: string | undefined, maxB
     filename: string | undefined;
 }>;
 
-export { type BatchDeleteResult as B, type CallOptions as C, DEFAULT_MAX_BYTES as D, type GetOptions as G, type Image as I, type OperationEvent as O, type PreparedRow as P, type Queryable as Q, type StorageBackend as S, type ValidatedContent as V, type WritableLike as W, ZeroBucket as Z, type ObjectStorageLike as a, type StoredRecord as b, type StoredRecordMetadata as c, type StreamOptions$1 as d, type ContentValidator as e, type BatchGetResult as f, type BatchPutResult as g, type BeforeGetHook as h, type BeforePutHook as i, type Connection as j, type ImageInput as k, type ImageMetadata as l, ObjectStorage as m, type ObjectStorageOptions as n, type OptimizationResult as o, type OptimizeOptions as p, type PutManyOptions as q, type PutOptions as r, type SqliteDatabaseLike as s, type StreamOptions as t, type ZeroBucketOptions as u, optimizeImage as v, readInput as w };
+export { type BatchDeleteResult as B, type CallOptions as C, DEFAULT_MAX_BYTES as D, type GetOptions as G, type ImageListOptions as I, type OperationEvent as O, type PreparedRow as P, type Queryable as Q, type StorageBackend as S, type ValidatedContent as V, type WritableLike as W, ZeroBucket as Z, type ObjectStorageLike as a, type StoredRecord as b, type StoredRecordMetadata as c, type StreamOptions$1 as d, type StorageInfo as e, type ImageListEntry as f, type ContentValidator as g, type BatchGetResult as h, type BatchPutResult as i, type BeforeGetHook as j, type BeforePutHook as k, type Connection as l, type Image as m, type ImageInput as n, type ImageMetadata as o, ObjectStorage as p, type ObjectStorageOptions as q, type OptimizationResult as r, type OptimizeOptions as s, type PutManyOptions as t, type PutOptions as u, type SqliteDatabaseLike as v, type StreamOptions as w, type ZeroBucketOptions as x, optimizeImage as y, readInput as z };

package/dist/http.d.cts

@@ -1,5 +1,5 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
-import { Z as ZeroBucket } from './client-WZ4VRCPi.cjs';
+import { Z as ZeroBucket } from './client-C7xs1dlr.cjs';
 import 'pg';
 
 /**

package/dist/http.d.ts

@@ -1,5 +1,5 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
-import { Z as ZeroBucket } from './client-WZ4VRCPi.js';
+import { Z as ZeroBucket } from './client-C7xs1dlr.js';
 import 'pg';
 
 /**

package/dist/http.js

@@ -1,7 +1,7 @@
 import {
   AccessDeniedError,
   ImageNotFoundError
-} from "./chunk-W2C37XYV.js";
+} from "./chunk-SCPC3QDR.js";
 
 // src/http.ts
 import { Readable } from "stream";