@crawlee/fs-storage-native 0.1.5-beta.1 → 0.1.5-beta.2

package/index.d.ts

@@ -1,9 +1,9 @@
 export interface DatasetMetadata {
     id: string;
     name: string | null;
-    accessedAt: string;
-    createdAt: string;
-    modifiedAt: string;
+    accessedAt: Date;
+    createdAt: Date;
+    modifiedAt: Date;
     itemCount: number;
 }
 
@@ -19,9 +19,9 @@ export interface DatasetItemsListPage {
 export interface KeyValueStoreMetadata {
     id: string;
     name: string | null;
-    accessedAt: string;
-    createdAt: string;
-    modifiedAt: string;
+    accessedAt: Date;
+    createdAt: Date;
+    modifiedAt: Date;
 }
 
 export interface KeyValueStoreRecord {
@@ -47,9 +47,9 @@ export interface KeyValueStoreRecordMetadata {
 export interface RequestQueueMetadata {
     id: string;
     name: string | null;
-    accessedAt: string;
-    createdAt: string;
-    modifiedAt: string;
+    accessedAt: Date;
+    createdAt: Date;
+    modifiedAt: Date;
     hadMultipleClients: boolean;
     handledRequestCount: number;
     pendingRequestCount: number;

package/lib.js

@@ -2,7 +2,41 @@ import { createReadStream, createWriteStream } from 'fs';
 import { unlink } from 'fs/promises';
 import { Readable, Writable } from 'stream';
 
-import { DatasetItemIterator, FileSystemKeyValueStoreClient, KvsKeyIterator } from './index.js';
+import {
+    DatasetItemIterator,
+    FileSystemDatasetClient,
+    FileSystemKeyValueStoreClient,
+    FileSystemRequestQueueClient,
+    KvsKeyIterator,
+} from './index.js';
+
+// The core library stores datetimes as ISO-8601 strings (the on-disk format),
+// so they cross the FFI boundary as strings. Convert the standard metadata
+// datetime fields to native JS `Date`s before handing the object to callers.
+const METADATA_DATE_FIELDS = ['accessedAt', 'createdAt', 'modifiedAt'];
+
+function convertMetadataDates(meta) {
+    if (meta) {
+        for (const field of METADATA_DATE_FIELDS) {
+            if (typeof meta[field] === 'string') {
+                meta[field] = new Date(meta[field]);
+            }
+        }
+    }
+    return meta;
+}
+
+// Wrap getMetadata on each client to coerce datetime strings into `Date`s.
+for (const Client of [
+    FileSystemDatasetClient,
+    FileSystemKeyValueStoreClient,
+    FileSystemRequestQueueClient,
+]) {
+    const origGetMetadata = Client.prototype.getMetadata;
+    Client.prototype.getMetadata = async function (...args) {
+        return convertMetadataDates(await origGetMetadata.apply(this, args));
+    };
+}
 
 // Add Symbol.asyncIterator to DatasetItemIterator so users can write:
 //   for await (const item of client.iterateItems()) { ... }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crawlee/fs-storage-native",
-  "version": "0.1.5-beta.1",
+  "version": "0.1.5-beta.2",
   "description": "Low-level Rust-powered napi-rs bindings for Crawlee's filesystem storage. Not intended for direct use in crawlers — depend on @crawlee/fs-storage instead.",
   "homepage": "https://github.com/apify/crawlee-storage",
   "license": "Apache-2.0",
@@ -46,10 +46,10 @@
     "vitest": "^3"
   },
   "optionalDependencies": {
-    "@crawlee/fs-storage-native-darwin-arm64": "0.1.5-beta.1",
-    "@crawlee/fs-storage-native-darwin-x64": "0.1.5-beta.1",
-    "@crawlee/fs-storage-native-linux-x64-gnu": "0.1.5-beta.1",
-    "@crawlee/fs-storage-native-win32-x64-msvc": "0.1.5-beta.1"
+    "@crawlee/fs-storage-native-darwin-arm64": "0.1.5-beta.2",
+    "@crawlee/fs-storage-native-darwin-x64": "0.1.5-beta.2",
+    "@crawlee/fs-storage-native-linux-x64-gnu": "0.1.5-beta.2",
+    "@crawlee/fs-storage-native-win32-x64-msvc": "0.1.5-beta.2"
   },
   "napi": {
     "binaryName": "fs-storage-native",