sealtrail 0.1.2 → 0.3.0

package/README.md

@@ -91,6 +91,28 @@ console.log(result.valid);       // true/false
 console.log(result.chainIntact); // hash chain verification
 ```
 
+### Export
+
+```typescript
+// Export events as CSV for compliance reporting
+const csv = await st.events.export({
+  format: "csv",
+  after: "2026-01-01T00:00:00Z",
+  before: "2026-04-01T00:00:00Z",
+  actor: "user_123",           // optional filter
+});
+// csv is a raw string: "id,actor,action,...\nevt_abc,user_123,..."
+
+// Export events as JSON with metadata
+const json = await st.events.export({
+  format: "json",
+  after: "2026-01-01T00:00:00Z",
+  before: "2026-04-01T00:00:00Z",
+});
+console.log(json.export.count);  // number of events
+console.log(json.data);          // AuditEvent[]
+```
+
 ### Chains
 
 ```typescript

package/dist/index.cjs

@@ -120,7 +120,7 @@ function mapError(status, body, retryAfter) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.1.2" : "0.1.2";
+var VERSION = true ? "0.3.0" : "0.1.2";
 
 // src/lib/fetch.ts
 var DEFAULT_BASE_URL = "https://api.sealtrail.dev";
@@ -209,6 +209,10 @@ async function request(config, method, path, options) {
         );
       }
       if (response.ok) {
+        const contentType = response.headers.get("content-type") ?? "";
+        if (contentType.includes("text/")) {
+          return await response.text();
+        }
         return await response.json();
       }
       let errorBody;
@@ -361,6 +365,14 @@ var EventsResource = class extends BaseResource {
   listAutoPaginate(params) {
     return createAutoPaginator((cursor) => this.list({ ...params, cursor }));
   }
+  /**
+   * Export events for compliance reporting (CSV or JSON).
+   */
+  async export(params) {
+    return this.client._request("GET", "/v1/events/export", {
+      query: params
+    });
+  }
 };
 
 // src/client.ts

package/dist/index.d.cts

@@ -78,6 +78,35 @@ interface Chain {
     eventCount: number;
     createdAt: string;
 }
+interface ExportEventsParams {
+    /** Export format */
+    format: "csv" | "json";
+    /** Period start (ISO 8601, required) */
+    after: string;
+    /** Period end (ISO 8601, required) */
+    before: string;
+    /** Filter by actor */
+    actor?: string;
+    /** Filter by action */
+    action?: string;
+    /** Filter by resource */
+    resource?: string;
+    /** Filter by chain ID */
+    chain_id?: string;
+}
+interface ExportJsonResponse {
+    export: {
+        format: "json";
+        generatedAt: string;
+        period: {
+            after: string;
+            before: string;
+        };
+        filters: Record<string, string>;
+        count: number;
+    };
+    data: AuditEvent[];
+}
 interface RequestOptions {
     body?: unknown;
     query?: Record<string, string | number | undefined>;
@@ -130,6 +159,10 @@ declare class EventsResource extends BaseResource {
      * ```
      */
     listAutoPaginate(params?: Omit<ListEventsParams, "cursor">): AsyncIterable<AuditEvent>;
+    /**
+     * Export events for compliance reporting (CSV or JSON).
+     */
+    export(params: ExportEventsParams): Promise<string | ExportJsonResponse>;
 }
 
 declare class SealTrail {
@@ -173,4 +206,4 @@ declare class InternalError extends SealTrailError {
     constructor(message: string, code: string, status: number);
 }
 
-export { type AuditEvent, AuthenticationError, type Chain, ConflictError, type EventListResponse, ForbiddenError, InternalError, type ListEventsParams, type LogEventParams, NotFoundError, QuotaExceededError, RateLimitError, SealTrail, type SealTrailConfig, SealTrailError, ValidationError, type VerifyResult };
+export { type AuditEvent, AuthenticationError, type Chain, ConflictError, type EventListResponse, type ExportEventsParams, type ExportJsonResponse, ForbiddenError, InternalError, type ListEventsParams, type LogEventParams, NotFoundError, QuotaExceededError, RateLimitError, SealTrail, type SealTrailConfig, SealTrailError, ValidationError, type VerifyResult };

package/dist/index.d.ts

@@ -78,6 +78,35 @@ interface Chain {
     eventCount: number;
     createdAt: string;
 }
+interface ExportEventsParams {
+    /** Export format */
+    format: "csv" | "json";
+    /** Period start (ISO 8601, required) */
+    after: string;
+    /** Period end (ISO 8601, required) */
+    before: string;
+    /** Filter by actor */
+    actor?: string;
+    /** Filter by action */
+    action?: string;
+    /** Filter by resource */
+    resource?: string;
+    /** Filter by chain ID */
+    chain_id?: string;
+}
+interface ExportJsonResponse {
+    export: {
+        format: "json";
+        generatedAt: string;
+        period: {
+            after: string;
+            before: string;
+        };
+        filters: Record<string, string>;
+        count: number;
+    };
+    data: AuditEvent[];
+}
 interface RequestOptions {
     body?: unknown;
     query?: Record<string, string | number | undefined>;
@@ -130,6 +159,10 @@ declare class EventsResource extends BaseResource {
      * ```
      */
     listAutoPaginate(params?: Omit<ListEventsParams, "cursor">): AsyncIterable<AuditEvent>;
+    /**
+     * Export events for compliance reporting (CSV or JSON).
+     */
+    export(params: ExportEventsParams): Promise<string | ExportJsonResponse>;
 }
 
 declare class SealTrail {
@@ -173,4 +206,4 @@ declare class InternalError extends SealTrailError {
     constructor(message: string, code: string, status: number);
 }
 
-export { type AuditEvent, AuthenticationError, type Chain, ConflictError, type EventListResponse, ForbiddenError, InternalError, type ListEventsParams, type LogEventParams, NotFoundError, QuotaExceededError, RateLimitError, SealTrail, type SealTrailConfig, SealTrailError, ValidationError, type VerifyResult };
+export { type AuditEvent, AuthenticationError, type Chain, ConflictError, type EventListResponse, type ExportEventsParams, type ExportJsonResponse, ForbiddenError, InternalError, type ListEventsParams, type LogEventParams, NotFoundError, QuotaExceededError, RateLimitError, SealTrail, type SealTrailConfig, SealTrailError, ValidationError, type VerifyResult };

package/dist/index.mjs

@@ -85,7 +85,7 @@ function mapError(status, body, retryAfter) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.1.2" : "0.1.2";
+var VERSION = true ? "0.3.0" : "0.1.2";
 
 // src/lib/fetch.ts
 var DEFAULT_BASE_URL = "https://api.sealtrail.dev";
@@ -174,6 +174,10 @@ async function request(config, method, path, options) {
         );
       }
       if (response.ok) {
+        const contentType = response.headers.get("content-type") ?? "";
+        if (contentType.includes("text/")) {
+          return await response.text();
+        }
         return await response.json();
       }
       let errorBody;
@@ -326,6 +330,14 @@ var EventsResource = class extends BaseResource {
   listAutoPaginate(params) {
     return createAutoPaginator((cursor) => this.list({ ...params, cursor }));
   }
+  /**
+   * Export events for compliance reporting (CSV or JSON).
+   */
+  async export(params) {
+    return this.client._request("GET", "/v1/events/export", {
+      query: params
+    });
+  }
 };
 
 // src/client.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "sealtrail",
-	"version": "0.1.2",
+	"version": "0.3.0",
 	"description": "Official Node.js SDK for the SealTrail cryptographic audit trail API",
 	"type": "module",
 	"sideEffects": false,