@chrtco/sdk 0.4.1 → 0.6.0

package/dist/fs-adapter-D5iwdb1Q.d.cts

@@ -0,0 +1,33 @@
+/**
+ * Pluggable filesystem surface used by the offline endpoints.
+ *
+ * The core SDK is zero-dependency and can't import `node:*`. Callers bring
+ * their own adapter — `@chrtco/sdk/node` ships the Node 18+ implementation;
+ * future adapters (Bun/Deno-native, React Native, browser-OPFS) slot in the
+ * same shape without touching the endpoint code.
+ *
+ * Paths are plain strings. All methods are async. Streaming SHA-256 lives on
+ * the adapter so each runtime can use its native streaming digest primitive
+ * (Node: `crypto.createHash`; browser-OPFS: chunked `SubtleCrypto` etc.).
+ */
+interface FileSystemAdapter {
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<{
+        size: number;
+    }>;
+    /** Returns a WritableStream for the given path. `append: true` opens in append mode; otherwise the file is truncated. */
+    writeStream(path: string, opts?: {
+        append?: boolean;
+    }): Promise<WritableStream<Uint8Array>>;
+    rename(from: string, to: string): Promise<void>;
+    unlink(path: string): Promise<void>;
+    mkdir(path: string, opts?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    readFile(path: string): Promise<Uint8Array>;
+    writeFile(path: string, data: Uint8Array): Promise<void>;
+    /** Compute SHA-256 of the file at `path`. Lowercase hex. Must stream for large files. */
+    sha256(path: string): Promise<string>;
+}
+
+export type { FileSystemAdapter as F };

package/dist/fs-adapter-D5iwdb1Q.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Pluggable filesystem surface used by the offline endpoints.
+ *
+ * The core SDK is zero-dependency and can't import `node:*`. Callers bring
+ * their own adapter — `@chrtco/sdk/node` ships the Node 18+ implementation;
+ * future adapters (Bun/Deno-native, React Native, browser-OPFS) slot in the
+ * same shape without touching the endpoint code.
+ *
+ * Paths are plain strings. All methods are async. Streaming SHA-256 lives on
+ * the adapter so each runtime can use its native streaming digest primitive
+ * (Node: `crypto.createHash`; browser-OPFS: chunked `SubtleCrypto` etc.).
+ */
+interface FileSystemAdapter {
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<{
+        size: number;
+    }>;
+    /** Returns a WritableStream for the given path. `append: true` opens in append mode; otherwise the file is truncated. */
+    writeStream(path: string, opts?: {
+        append?: boolean;
+    }): Promise<WritableStream<Uint8Array>>;
+    rename(from: string, to: string): Promise<void>;
+    unlink(path: string): Promise<void>;
+    mkdir(path: string, opts?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    readFile(path: string): Promise<Uint8Array>;
+    writeFile(path: string, data: Uint8Array): Promise<void>;
+    /** Compute SHA-256 of the file at `path`. Lowercase hex. Must stream for large files. */
+    sha256(path: string): Promise<string>;
+}
+
+export type { FileSystemAdapter as F };