@drakkar.software/starfish-client 3.0.0-alpha.39 → 3.0.0-alpha.40

package/dist/client.d.ts

@@ -370,4 +370,33 @@ export declare class StarfishClient {
      * Binary collections use last-write-wins (no conflict detection).
      */
     pushBlob(path: string, data: ArrayBuffer | Uint8Array | Blob, contentType: string): Promise<BlobPushResult>;
+    /**
+     * Push an Apache Parquet file to a Parquet collection.
+     *
+     * Thin wrapper over {@link pushBlob} that fixes `Content-Type` to
+     * `application/vnd.apache.parquet` so the S3 object is tagged correctly
+     * for DuckDB and CDN consumption.
+     *
+     * @example
+     * ```ts
+     * const parquetBytes = await generateParquet(rows)
+     * const result = await client.pushParquet("/push/analytics/alice/q1.parquet", parquetBytes)
+     * console.log("stored hash:", result.hash)
+     * ```
+     */
+    pushParquet(path: string, data: ArrayBuffer | Uint8Array | Blob): Promise<BlobPushResult>;
+    /**
+     * Pull an Apache Parquet file from a Parquet collection.
+     *
+     * Thin wrapper over {@link pullBlob} for API symmetry with
+     * {@link pushParquet}.
+     *
+     * @example
+     * ```ts
+     * const result = await client.pullParquet("/pull/analytics/alice/q1.parquet")
+     * // result.data        → ArrayBuffer
+     * // result.contentType → "application/vnd.apache.parquet"
+     * ```
+     */
+    pullParquet(path: string): Promise<BlobPullResult>;
 }

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export type { RevocationList, RevocationEntry, RevokedSubject, BuildRevocationLi
 export type { PullResult, PushSuccess, PullKeyringProjection } from "@drakkar.software/starfish-protocol";
 export { StarfishClient, pullWasFromCache } from "./client.js";
 export type { BlobPullResult, BlobPushResult, AppendPullOptions, PullOptions, BatchPullOptions, BatchPullResult, BatchPullEntry, } from "./client.js";
+export { PARQUET_MIME_TYPE, PARQUET_MIME_TYPES } from "@drakkar.software/starfish-protocol";
 export { SyncManager, AbortError } from "./sync.js";
 export type { SyncManagerOptions, SyncSigner } from "./sync.js";
 export { AppendLogCursor, AppendAuthorError, checkpointOf } from "./append-log.js";

package/dist/index.js

@@ -18,6 +18,8 @@ import {
   HEADER_PUB,
   HEADER_CONTENT_TYPE,
   HEADER_ACCEPT,
+  PARQUET_MIME_TYPE as PARQUET_MIME_TYPE_VALUE,
+  PARQUET_MIME_TYPES as PARQUET_MIME_TYPES_VALUE,
   signAppendAuthor,
   signRequest,
   stableStringify
@@ -731,8 +733,51 @@ var StarfishClient = class {
     }
     return res.json();
   }
+  /**
+   * Push an Apache Parquet file to a Parquet collection.
+   *
+   * Thin wrapper over {@link pushBlob} that fixes `Content-Type` to
+   * `application/vnd.apache.parquet` so the S3 object is tagged correctly
+   * for DuckDB and CDN consumption.
+   *
+   * @example
+   * ```ts
+   * const parquetBytes = await generateParquet(rows)
+   * const result = await client.pushParquet("/push/analytics/alice/q1.parquet", parquetBytes)
+   * console.log("stored hash:", result.hash)
+   * ```
+   */
+  async pushParquet(path, data) {
+    return this.pushBlob(path, data, PARQUET_MIME_TYPE_VALUE);
+  }
+  /**
+   * Pull an Apache Parquet file from a Parquet collection.
+   *
+   * Thin wrapper over {@link pullBlob} for API symmetry with
+   * {@link pushParquet}.
+   *
+   * @example
+   * ```ts
+   * const result = await client.pullParquet("/pull/analytics/alice/q1.parquet")
+   * // result.data        → ArrayBuffer
+   * // result.contentType → "application/vnd.apache.parquet"
+   * ```
+   */
+  async pullParquet(path) {
+    const result = await this.pullBlob(path);
+    if (!PARQUET_MIME_TYPES_VALUE.includes(result.contentType)) {
+      throw new StarfishHttpError(
+        415,
+        `Expected a Parquet content-type, got: ${result.contentType}`
+      );
+    }
+    return result;
+  }
 };
 
+// src/index.ts
+import { PARQUET_MIME_TYPE, PARQUET_MIME_TYPES } from "@drakkar.software/starfish-protocol";
+
 // src/sync.ts
 import {
   AUTHOR_PUBKEY_FIELD as AUTHOR_PUBKEY_FIELD2,
@@ -2143,6 +2188,8 @@ export {
   AppendLogCursor,
   ConflictError,
   ENCRYPTED_KEY,
+  PARQUET_MIME_TYPE,
+  PARQUET_MIME_TYPES,
   SnapshotHistory,
   StarfishClient,
   StarfishHttpError,