@rudderhq/server 0.7.4 → 0.7.6

package/dist/services/workspace-backup-v2.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Node comparator for the v2 backup contract. The archive reader deliberately
+ * supports only the uncompressed ZIP dialect emitted by this module. That
+ * keeps the reader bounded and makes unsupported compression fail closed rather
+ * than silently allowing an unbounded inflate path.
+ */
+export declare const WORKSPACE_BACKUP_V2_VERSION: 2;
+export declare const WORKSPACE_BACKUP_V2_POLICY_VERSION: "workspace-backup-v2-policy-1";
+export declare const WORKSPACE_BACKUP_V2_MANIFEST_PATH: ".rudder-backup/manifest-v2.json";
+export declare const WORKSPACE_BACKUP_V2_MAX_FILE_BYTES: number;
+export declare const WORKSPACE_BACKUP_V2_MAX_TOTAL_BYTES: number;
+export type WorkspaceBackupV2Entry = {
+    path: string;
+    kind: "directory" | "file";
+    byteSize: number;
+    mtimeMs: number | null;
+    mode: number | null;
+    sha256: string | null;
+};
+export type WorkspaceBackupV2Manifest = {
+    version: typeof WORKSPACE_BACKUP_V2_VERSION;
+    policyVersion: typeof WORKSPACE_BACKUP_V2_POLICY_VERSION;
+    identity: {
+        orgId: string;
+        instanceId: string;
+        rootPath: string;
+    };
+    createdAt: string;
+    entries: WorkspaceBackupV2Entry[];
+    treeSha256: string;
+    warnings: string[];
+};
+export type WorkspaceBackupV2Walk = {
+    entries: WorkspaceBackupV2Entry[];
+    warnings: string[];
+    fileCount: number;
+    byteSize: number;
+    treeSha256: string;
+};
+export type WorkspaceBackupV2Artifact = WorkspaceBackupV2Walk & {
+    archive: Buffer;
+    manifest: WorkspaceBackupV2Manifest;
+};
+export type WorkspaceBackupV2NativeArtifact = WorkspaceBackupV2Walk & {
+    artifactPath: string;
+    archiveSha256: string;
+    manifest: WorkspaceBackupV2Manifest;
+};
+export type WorkspaceBackupV2NativeDiagnosticCategory = "capability" | "protocol" | "timeout" | "process" | "integrity" | "publication";
+export type WorkspaceBackupV2NativeDiagnostic = {
+    category: WorkspaceBackupV2NativeDiagnosticCategory;
+    code: string;
+    detail: string;
+    fallbackAllowed: boolean;
+};
+type PublicationOps = {
+    link(source: string, destination: string): Promise<void>;
+    rm(filePath: string): Promise<void>;
+    syncParent(filePath: string): Promise<void>;
+};
+export declare class WorkspaceBackupV2NativeError extends Error {
+    readonly diagnostic: WorkspaceBackupV2NativeDiagnostic;
+    constructor(diagnostic: WorkspaceBackupV2NativeDiagnostic);
+}
+export declare function workspaceBackupV2NativeDiagnostic(error: unknown): WorkspaceBackupV2NativeDiagnostic;
+export declare function formatWorkspaceBackupV2NativeFallback(error: unknown): string;
+export type WorkspaceBackupV2FileArtifact = WorkspaceBackupV2Walk & {
+    artifactPath: string;
+    archiveSha256: string;
+    compressedSize: number;
+    manifest: WorkspaceBackupV2Manifest;
+};
+export type WorkspaceBackupV2ArchiveEntry = {
+    archivePath: string;
+    kind: "directory" | "file";
+    compressedSize: number;
+    byteSize: number;
+    crc32: number;
+    dataOffset: number;
+};
+export type WorkspaceBackupV2ArchiveIndex = {
+    archiveSize: number;
+    manifest: WorkspaceBackupV2Manifest;
+    manifestEntry: WorkspaceBackupV2ArchiveEntry;
+    entries: Map<string, WorkspaceBackupV2ArchiveEntry>;
+};
+export declare function assertSafeWorkspaceBackupV2Path(value: string): string;
+export declare function walkWorkspaceBackupV2(rootPath: string): Promise<WorkspaceBackupV2Walk>;
+export declare function createWorkspaceBackupV2(input: {
+    rootPath: string;
+    orgId: string;
+    instanceId: string;
+    createdAt?: Date;
+}): Promise<WorkspaceBackupV2Artifact>;
+/**
+ * Contract-equivalent Node comparator for the native writer. It keeps only a
+ * bounded per-file Buffer and writes local records sequentially, so the full
+ * archive is never materialized in the JS heap.
+ */
+export declare function createWorkspaceBackupV2File(input: {
+    rootPath: string;
+    orgId: string;
+    instanceId: string;
+    artifactPath: string;
+    createdAt?: Date;
+    additionalWarnings?: string[];
+    beforePublish?: () => Promise<void>;
+    publicationOps?: PublicationOps;
+}): Promise<WorkspaceBackupV2FileArtifact>;
+export declare function resolveNativeArchiveBinary(): string;
+export declare function createWorkspaceBackupV2Native(input: {
+    rootPath: string;
+    orgId: string;
+    instanceId: string;
+    artifactPath: string;
+    createdAt?: Date;
+    beforePublish?: () => Promise<void>;
+    publicationOps?: PublicationOps;
+}): Promise<WorkspaceBackupV2NativeArtifact>;
+export declare function inspectWorkspaceBackupV2(archive: Uint8Array): {
+    manifest: WorkspaceBackupV2Manifest;
+    files: Map<string, Buffer>;
+};
+export declare function inspectWorkspaceBackupV2File(filePath: string): Promise<WorkspaceBackupV2ArchiveIndex>;
+export declare function readWorkspaceBackupV2File(filePath: string, index: WorkspaceBackupV2ArchiveIndex, relativePath: string): Promise<Buffer>;
+export {};
+//# sourceMappingURL=workspace-backup-v2.d.ts.map

package/dist/services/workspace-backup-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-backup-v2.d.ts","sourceRoot":"","sources":["../../src/services/workspace-backup-v2.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAG,CAAU,CAAC;AACtD,eAAO,MAAM,kCAAkC,EAAG,8BAAuC,CAAC;AAC1F,eAAO,MAAM,iCAAiC,EAAG,iCAA0C,CAAC;AAC5F,eAAO,MAAM,kCAAkC,QAAkB,CAAC;AAClE,eAAO,MAAM,mCAAmC,QAAoB,CAAC;AAkBrE,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,OAAO,2BAA2B,CAAC;IAC5C,aAAa,EAAE,OAAO,kCAAkC,CAAC;IACzD,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,GAAG;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,qBAAqB,GAAG;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,yCAAyC,GACjD,YAAY,GACZ,UAAU,GACV,SAAS,GACT,SAAS,GACT,WAAW,GACX,aAAa,CAAC;AAElB,MAAM,MAAM,iCAAiC,GAAG;IAC9C,QAAQ,EAAE,yCAAyC,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,CAAC;AAEF,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,UAAU,EAAE,iCAAiC,CAAC;gBAE3C,UAAU,EAAE,iCAAiC;CAK1D;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,iCAAiC,CAGnG;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,OAAO,UAGnE;AAED,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,GAAG;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,aAAa,EAAE,6BAA6B,CAAC;IAC7C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;CACrD,CAAC;AAuDF,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,UAS5D;AAqCD,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA8C5F;AAeD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAiCrC;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAuEzC;AAwFD,wBAAgB,0BAA0B,WAgBzC;AAiED,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,GAAG,OAAO,CAAC,+BAA+B,CAAC,CA2F3C;AAgKD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG;IAAE,QAAQ,EAAE,yBAAyB,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CASjI;AA8HD,wBAAsB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAS3G;AAED,wBAAsB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,6BAA6B,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa7I"}