sliftutils 1.7.9 → 1.7.11

package/storage/remoteStorage/cliArgs.d.ts

@@ -0,0 +1 @@
+export declare function getArg(name: string): string | undefined;

package/storage/remoteStorage/cliArgs.ts

@@ -0,0 +1,9 @@
+export function getArg(name: string): string | undefined {
+    let index = process.argv.indexOf(`--${name}`);
+    if (index < 0) return undefined;
+    let value = process.argv[index + 1];
+    if (!value || value.startsWith("--")) {
+        throw new Error(`Missing value for --${name}`);
+    }
+    return value;
+}

package/storage/remoteStorage/createArchives.d.ts

@@ -0,0 +1,85 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { IArchives, RemoteConfig, RemoteConfigBase, HostedConfig, BackblazeConfig, ArchiveFileInfo, ArchivesConfig, ArchivesSyncStatus } from "../IArchives";
+export declare function createApiArchives(source: HostedConfig | BackblazeConfig): IArchives;
+export declare class ArchivesChain implements IArchives {
+    private configured;
+    private activeConfig;
+    private statePromise;
+    private initRetryDelay;
+    private initRetryTimer;
+    private pollTimer;
+    private disposed;
+    constructor(config: RemoteConfig | RemoteConfigBase);
+    getDebugName(): string;
+    private getState;
+    private init;
+    private buildSources;
+    private startConfigPoll;
+    private checkForNewConfig;
+    private run;
+    private runWrite;
+    private request;
+    waitingForAccess(): Promise<{
+        link: string;
+        machineId: string;
+        ip: string;
+    } | undefined>;
+    get(fileName: string, config?: {
+        range?: {
+            start: number;
+            end: number;
+        };
+    }): Promise<Buffer | undefined>;
+    get2(fileName: string, config?: {
+        range?: {
+            start: number;
+            end: number;
+        };
+    }): Promise<{
+        data: Buffer;
+        writeTime: number;
+        size: number;
+    } | undefined>;
+    getInfo(fileName: string): Promise<{
+        writeTime: number;
+        size: number;
+    } | undefined>;
+    private selectCoveringSources;
+    private runOnApi;
+    find(prefix: string, config?: {
+        shallow?: boolean;
+        type: "files" | "folders";
+    }): Promise<string[]>;
+    findInfo(prefix: string, config?: {
+        shallow?: boolean;
+        type: "files" | "folders";
+    }): Promise<ArchiveFileInfo[]>;
+    getChangesAfter(time: number): Promise<ArchiveFileInfo[]>;
+    getSyncStatus(): Promise<ArchivesSyncStatus>;
+    getConfig(): Promise<ArchivesConfig>;
+    /** True only when EVERY write-receiving source would accept our writes (partial write access
+     *  desynchronizes sources, so it counts as no access). */
+    hasWriteAccess(): Promise<boolean>;
+    private assertNotBareVariableShard;
+    set(fileName: string, data: Buffer, config?: {
+        lastModified?: number;
+    }): Promise<void>;
+    del(fileName: string): Promise<void>;
+    /** Writes a key containing the VARIABLE_SHARD sentinel: picks the lowest-latency up write
+     *  shard, materializes the key with a random value inside that shard's route, writes it, and
+     *  returns the FULL key actually written (the caller needs it to ever read the value back).
+     *  Unlike normal writes this CAN move to another shard when the preferred one is down (error +
+     *  socket down, same rule as reads) - each shard receives a different key, so write
+     *  consistency is preserved. */
+    setVariableShard(key: string, data: Buffer, config?: {
+        lastModified?: number;
+    }): Promise<string>;
+    setLargeFile(config: {
+        path: string;
+        getNextData(): Promise<Buffer | undefined>;
+    }): Promise<void>;
+    getURL(path: string): Promise<string>;
+    dispose(): void;
+}
+export declare function createArchives(config: RemoteConfig | RemoteConfigBase): ArchivesChain;