@nimbus-sh/worker 0.1.0

package/dist/git/network-facet.d.ts

@@ -0,0 +1,61 @@
+/**
+ * git-network-facet.ts — Facet-based git clone/fetch/pull.
+ *
+ * Runs isomorphic-git's network operations (clone/fetch/pull) inside a
+ * dynamic worker (LOADER.load) to escape the supervisor DO's CPU budget
+ * and to avoid the known DO fetch() hang in wrangler local dev.
+ *
+ * Architecture:
+ *   - Facet holds a buffered fs adapter: writes accumulate in memory
+ *   - When buffer reaches WAVE_SIZE files or WAVE_BYTES bytes, flush
+ *     via ONE supervisor.writeBatch() RPC (atomic transactionSync).
+ *   - At clone end, a final flush commits remaining buffered state.
+ *   - Reads fall through: buffer → supervisor.readFile / supervisor.stat.
+ *
+ * Why this fixes the hang:
+ *   - CPU-heavy packfile delta resolution runs in facet (own CPU budget)
+ *   - No per-file RPC round-trips — ~1 writeBatch per 500 files
+ *   - Packfile network fetch works (facet fetch is reliable, DO fetch hangs)
+ *   - cf-git's nonBlocking=true option yields to event loop between batches
+ *
+ * See docs/analysis in git-network-facet plan — the canonical write-up lives
+ * in the PR that introduced this file.
+ */
+export type GitNetworkOp = 'clone' | 'fetch' | 'pull' | 'push';
+export interface GitNetworkOpts {
+    op: GitNetworkOp;
+    /** Absolute working tree directory (e.g. "/home/user/project") */
+    dir: string;
+    /** For clone: repository URL */
+    url?: string;
+    /** For fetch/pull: remote name (default "origin") */
+    remote?: string;
+    /** For pull: branch name (default current) */
+    ref?: string;
+    /** Shallow depth; default 1 for clone */
+    depth?: number;
+    /** Username + password/token */
+    auth?: {
+        username: string;
+        password: string;
+    };
+    /** Author (for pull merges) */
+    author?: {
+        name: string;
+        email: string;
+    };
+    /** Timeout (ms). Default 300_000 (5 min). */
+    timeout?: number;
+}
+export interface GitNetworkResult {
+    success: boolean;
+    error?: string;
+    elapsed: number;
+    filesWritten: number;
+    bytesWritten: number;
+}
+/**
+ * Run a git network op inside a facet. Returns when complete or timed out.
+ */
+export declare function execGitNetwork(ctx: DurableObjectState, env: any, opts: GitNetworkOpts): Promise<GitNetworkResult>;
+//# sourceMappingURL=network-facet.d.ts.map

package/dist/git/network-facet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-facet.d.ts","sourceRoot":"","sources":["../../src/git/network-facet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,YAAY,CAAC;IACjB,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,+BAA+B;IAC/B,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,kBAAkB,EACvB,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CA4H3B"}