@tensorix/metahub 0.5.8 → 0.6.0

package/dist/core/sync/storage.d.ts

@@ -63,21 +63,38 @@ export interface StoragePutOpts {
 /** The minimal object-store surface storage-sync needs. Implemented per runtime:
  *  Bun.S3Client on the CLI/desktop (storage-s3-bun.ts), aws4fetch SigV4 + fetch
  *  in the browser worker (webui/data/storage-s3-browser.ts). */
+export interface StorageReadResult {
+    bytes: Uint8Array;
+    serverDate: number | null;
+    lastModified: number | null;
+    etag: string | null;
+}
 export interface StorageClient {
+    /** Verified provider preconditions; absence means destructive GC unsupported. */
+    conditionalCreateCapability?(): Promise<boolean>;
+    /** Metadata is from the same response as bytes, never a separate HEAD. */
+    getWithMetadata?(key: string, options: {
+        maxBytes: number;
+    }): Promise<StorageReadResult | null>;
     /** Keys under `prefix`, ascending, optionally only those strictly after
      *  `startAfter`. With `delimiter` ("/"), collapse one level into common
      *  prefixes (their keys end in the delimiter) to discover child "folders"
      *  cheaply — callers must tolerate a backend that ignores it and returns full
      *  keys instead. */
     list(prefix: string, startAfter?: string, delimiter?: string): Promise<StorageObject[]>;
-    get(key: string): Promise<Uint8Array | null>;
+    get(key: string, options?: {
+        maxBytes?: number;
+    }): Promise<Uint8Array | null>;
     put(key: string, body: Uint8Array, opts?: StoragePutOpts): Promise<void>;
     del(key: string): Promise<void>;
 }
-type StorageClientFactory = (config: S3Config) => StorageClient;
+export interface StorageClientOptions {
+    signal?: AbortSignal;
+}
+type StorageClientFactory = (config: S3Config, options?: StorageClientOptions) => StorageClient;
 /** Register this runtime's S3 client builder (see the per-runtime impls). */
 export declare function setStorageClientFactory(f: StorageClientFactory): void;
-export declare function storageClientFor(config: S3Config): StorageClient;
+export declare function storageClientFor(config: S3Config, options?: StorageClientOptions): StorageClient;
 /** Open a bucket's CORS for browser origins (PutBucketCors). Same runtime-adapter
  *  shape as the client factory, but unlike list/get/put/del this one has NO
  *  browser implementation and never will: PutBucketCors needs a Content-MD5 that
@@ -98,9 +115,25 @@ export declare function storageBasePrefix(prefix: string): string;
  *  P-256 private keys live next to keys/main.json, bucket-authoritative so any
  *  elected device can decrypt inbox envelopes. */
 export declare function dropKeysObjectKey(prefix: string): string;
+/** Runtime adapter for gzip; the wire format stays JSONL → gzip → AES-GCM. */
+export interface StorageCompressionCodec {
+    gzip(bytes: Uint8Array): Promise<Uint8Array>;
+    gunzip(bytes: Uint8Array, maxBytes?: number): Promise<Uint8Array>;
+}
+/** Native runtimes install a codec before syncing; null restores web streams. */
+export declare function setStorageCompressionCodec(codec: StorageCompressionCodec | null): void;
+declare function gzip(bytes: Uint8Array): Promise<Uint8Array>;
+declare function gunzip(bytes: Uint8Array, maxBytes?: number): Promise<Uint8Array>;
+export { gzip as gzipStorageBytes, gunzip as gunzipStorageBytes };
 /** Upload a blob's bytes to the bucket (idempotent via If-None-Match). Returns
  *  true when actually written, false when the object already existed. */
-export declare function putBucketBlob(config: S3Config, hash: string, bytes: Uint8Array): Promise<boolean>;
+export interface BucketBlobOptions {
+    db?: DbDriver;
+    signal?: AbortSignal;
+    /** Limit plaintext attachment size; encryption overhead is accounted separately. */
+    maxBytes?: number;
+}
+export declare function putBucketBlob(config: S3Config, hash: string, bytes: Uint8Array, options?: BucketBlobOptions): Promise<boolean>;
 /** Every blob hash the bucket durably holds — one paginated LIST of the `blobs/`
  *  namespace (the client loops continuation tokens internally). Used by the
  *  on-demand clear-presence verify; keeps the `<base>/blobs/<hash>` key layout
@@ -108,7 +141,7 @@ export declare function putBucketBlob(config: S3Config, hash: string, bytes: Uin
  *  anchor as unverified). */
 export declare function listBucketBlobHashes(config: S3Config): Promise<Set<string>>;
 /** Fetch a blob's bytes from the bucket, or null if absent. */
-export declare function getBucketBlob(config: S3Config, hash: string): Promise<Uint8Array | null>;
+export declare function getBucketBlob(config: S3Config, hash: string, options?: BucketBlobOptions): Promise<Uint8Array | null>;
 /** Discover the node prefixes under oplog/. Asks for a delimited (one-level)
  *  listing so a backend that honors it returns just the "<node>/" folders
  *  instead of every segment; nodesFromKeys derives the same node set whether the
@@ -169,6 +202,15 @@ export declare function publishSnapshot(db: DbDriver, client: StorageClient, con
     changes: number;
 } | null>;
 export interface StorageSyncOpts {
+    signal?: AbortSignal;
+    /** Limit own ops uploaded per round. Desktop callers retain the full-push default. */
+    pushLimit?: number;
+    /** Yield between these bounded synchronous ingest transactions. */
+    ingestBatchSize?: number;
+    /** Bound snapshot/segment downloads per round; omitted keeps desktop full pulls. */
+    pullObjectLimit?: number;
+    /** Notify a local owner after each committed ingestion chunk. */
+    onIngest?: () => void;
     /** Publisher-only: publish a snapshot + truncate once this node's own segment
      *  count reaches this. Default 200 — high enough that typical use rarely hits
      *  it, low enough to keep the bucket bounded under heavy publisher use. */
@@ -229,5 +271,4 @@ export interface StorageSyncOpts {
  * { pushed, pulled } like syncWithPeer so peers.ts status writeback is shared.
  */
 export declare function syncWithStorage(db: DbDriver, peerUrl: string, client: StorageClient, config: S3Config, opts?: StorageSyncOpts): Promise<SyncResult>;
-export {};
 //# sourceMappingURL=storage.d.ts.map

package/dist/core/sync/storage.d.ts.map

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

package/dist/core/sync/transport.d.ts

@@ -0,0 +1,4 @@
+/** Bound the complete operation, including response decoding, on runtimes that
+ * do not provide AbortSignal.timeout/any (React Native included). */
+export declare function withSyncBudget<T>(operation: (signal: AbortSignal) => Promise<T>, timeoutMs?: number, signal?: AbortSignal): Promise<T>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/core/sync/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/core/sync/transport.ts"],"names":[],"mappings":"AAAA;qEACqE;AACrE,wBAAsB,cAAc,CAAC,CAAC,EACpC,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9C,SAAS,SAAS,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC,CAsBZ"}

package/dist/core/sync/v2-ingest.d.ts

@@ -0,0 +1,10 @@
+import type { DbDriver } from "../driver.ts";
+import type { BucketBatch } from "./bucket-v2.ts";
+/** Preserve divergent same-register edits before LWW materialization. A deleted
+ * block is terminal; its late text is recoverable but cannot refill current state. */
+export declare function ingestV2Batch(db: DbDriver, batch: BucketBatch): {
+    received: number;
+    skewed: Record<string, number>;
+    poisoned: number;
+};
+//# sourceMappingURL=v2-ingest.d.ts.map

package/dist/core/sync/v2-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2-ingest.d.ts","sourceRoot":"","sources":["../../../src/core/sync/v2-ingest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;sFACsF;AACtF,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW;;;;EAgF7D"}

package/dist/core/sync/v2-maintenance.d.ts

@@ -0,0 +1,10 @@
+import type { RetentionReport } from "./retention-executor.ts";
+import type { DbDriver } from "../driver.ts";
+import type { StorageClient, S3Config } from "./storage.ts";
+/** Durable daily scheduling; bucket time authorizes age, local time never does.
+ * Enabling requires a separately recorded review; default remains dry-run. */
+export declare function maintainV2Workspace(db: DbDriver, client: StorageClient, config: S3Config): Promise<void>;
+/** Call only after the displayed report has been explicitly reviewed. Approval
+ * is workspace-scoped so the next checkpoint can perform delayed cleanup. */
+export declare function approveRetentionReport(db: DbDriver, report: RetentionReport): void;
+//# sourceMappingURL=v2-maintenance.d.ts.map

package/dist/core/sync/v2-maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2-maintenance.d.ts","sourceRoot":"","sources":["../../../src/core/sync/v2-maintenance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAK5D;8EAC8E;AAC9E,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,iBAqB9F;AAED;6EAC6E;AAC7E,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAOlF"}