@nimbus-sh/core 0.1.0

package/dist/_shared/w7-frame.d.ts

@@ -0,0 +1,79 @@
+/**
+ * W7 v3 — incremental typed records for streamed bulk filesystem writes.
+ * The format is internal: every producer and consumer deploys together.
+ */
+import type { BatchInodeEntry, BatchWritePayload } from '../vfs/sqlite-vfs.js';
+export declare const W7_MAGIC: Uint8Array<ArrayBuffer>;
+export declare const W7_MAX_PATHS_PER_BATCH = 128;
+export declare const W7_MAX_OWNED_PATH_BYTES: number;
+export declare const W7_MAX_RECORD_BYTES: number;
+declare const MODE: "path-atomic-committed-prefix";
+export interface W7BatchSummary {
+    recordCount: number;
+    pathCount: number;
+    deleteCount: number;
+    directoryCount: number;
+    fileCount: number;
+    chunkCount: number;
+    byteCount: number;
+    check: number;
+}
+export interface W7ChunkRetention {
+    readonly bytes: number;
+    release(): void;
+}
+export interface W7DecodeOptions {
+    signal?: AbortSignal;
+    retainChunk?: (byteLength: number, signal?: AbortSignal) => Promise<W7ChunkRetention>;
+}
+type W7DirectoryInode = BatchInodeEntry & {
+    kind: 'directory';
+    isDir: true;
+};
+type W7ContentInode = BatchInodeEntry & {
+    kind: 'file' | 'symlink';
+    isDir: false;
+};
+export type W7DecodedRecord = {
+    type: 'delete';
+    path: string;
+} | {
+    type: 'directory';
+    inode: W7DirectoryInode;
+} | {
+    type: 'file-begin';
+    streamContentId: string;
+    inode: W7ContentInode;
+} | {
+    type: 'file-chunk';
+    streamContentId: string;
+    path: string;
+    chunkId: number;
+    data: Uint8Array;
+    retention: W7ChunkRetention;
+} | {
+    type: 'file-end';
+    streamContentId: string;
+    path: string;
+    size: number;
+    chunkCount: number;
+    check: number;
+} | {
+    type: 'batch-end';
+    summary: W7BatchSummary;
+};
+export interface W7DecodedStream {
+    readonly batchId: string;
+    readonly mode: typeof MODE;
+    readonly records: AsyncIterable<W7DecodedRecord>;
+}
+/** Encode one bounded record per pull; no batch-sized metadata header exists. */
+export declare function encodeWriteBatchStream(payload: BatchWritePayload): ReadableStream<Uint8Array>;
+/**
+ * Parse the v3 preamble eagerly, then expose validated operation records
+ * incrementally. Chunk credit is acquired after its bounded header validates
+ * and before its payload bytes are read or copied.
+ */
+export declare function decodeWriteBatchStream(stream: ReadableStream<Uint8Array>, options?: W7DecodeOptions): Promise<W7DecodedStream>;
+export {};
+//# sourceMappingURL=w7-frame.d.ts.map

package/dist/_shared/w7-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"w7-frame.d.ts","sourceRoot":"","sources":["../../src/_shared/w7-frame.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAEV,eAAe,EACf,iBAAiB,EAElB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,QAAQ,yBAA2C,CAAC;AAOjE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,uBAAuB,QAAY,CAAC;AACjD,eAAO,MAAM,mBAAmB,QAAgD,CAAC;AAYjF,QAAA,MAAM,IAAI,EAAG,8BAAuC,CAAC;AAoCrD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACvF;AAED,KAAK,gBAAgB,GAAG,eAAe,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAAC;AAC7E,KAAK,cAAc,GAAG,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEnF,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAC9C;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,cAAc,CAAC;CACvB,GACD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,gBAAgB,CAAC;CAC7B,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CAClD;AAaD,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAAC,UAAU,CAAC,CAoC7F;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CA4C1B"}