device-passport 1.0.0 → 1.2.0

package/dist/storage/index.cjs

@@ -0,0 +1,10 @@
+'use strict';
+
+const memory = require('../shared/device-passport.Cjxlv8xI.cjs');
+require('node:fs');
+require('node:path');
+
+
+
+exports.JSONFileStorage = memory.JSONFileStorage;
+exports.MemoryStorage = memory.MemoryStorage;

package/dist/storage/index.d.cts

@@ -0,0 +1,97 @@
+import { S as StorageAdapter } from '../shared/device-passport.DirQmSd4.cjs';
+
+interface MemoryStorageOptions {
+    /**
+     * Whether to deep-clone stored and retrieved objects to prevent external mutations.
+     * Defaults to true.
+     */
+    clone?: boolean;
+}
+/**
+ * In-memory storage adapter.
+ * Useful for ephemeral scraping runs, tests, and caching.
+ */
+declare class MemoryStorage<T = any> implements StorageAdapter<T> {
+    private readonly store;
+    private readonly clone;
+    constructor(options?: MemoryStorageOptions);
+    private deepClone;
+    get(key: string): Promise<T | null>;
+    getSync(key: string): T | null;
+    set(key: string, value: T): Promise<void>;
+    setSync(key: string, value: T): void;
+    has(key: string): Promise<boolean>;
+    hasSync(key: string): boolean;
+    delete(key: string): Promise<boolean>;
+    deleteSync(key: string): boolean;
+    keys(): Promise<string[]>;
+    keysSync(): string[];
+    clear(): Promise<void>;
+    clearSync(): void;
+    get size(): number;
+}
+
+interface JSONFileStorageOptions {
+    /**
+     * Path to the JSON file on disk.
+     */
+    filePath: string;
+    /**
+     * Format JSON with indentation for readability.
+     * Defaults to true.
+     */
+    pretty?: boolean;
+    /**
+     * Auto-save to disk immediately when values change.
+     * Defaults to true.
+     */
+    autoSave?: boolean;
+}
+/**
+ * File-backed JSON storage adapter.
+ * Uses atomic writes via temp-file + renameSync to ensure zero corruption
+ * even if the process is killed mid-write. Automatically creates directories.
+ */
+declare class JSONFileStorage<T = any> implements StorageAdapter<T> {
+    readonly filePath: string;
+    private readonly pretty;
+    private readonly autoSave;
+    private readonly cache;
+    private isLoaded;
+    private writeQueue;
+    constructor(filePathOrOptions: string | JSONFileStorageOptions);
+    /**
+     * Ensure data is loaded from disk into the in-memory cache.
+     */
+    private ensureLoaded;
+    /**
+     * Atomic flush to disk. Writes to a unique temp file in the same directory,
+     * then atomically renames it to target file.
+     */
+    private flushAtomic;
+    /**
+     * Queue a disk write to prevent race conditions during rapid concurrent mutations.
+     */
+    private queueSave;
+    get(key: string): Promise<T | null>;
+    getSync(key: string): T | null;
+    set(key: string, value: T): Promise<void>;
+    setSync(key: string, value: T): void;
+    has(key: string): Promise<boolean>;
+    hasSync(key: string): boolean;
+    delete(key: string): Promise<boolean>;
+    deleteSync(key: string): boolean;
+    keys(): Promise<string[]>;
+    keysSync(): string[];
+    clear(): Promise<void>;
+    clearSync(): void;
+    /**
+     * Explicitly force a flush to disk (useful if autoSave is set to false).
+     */
+    flush(): Promise<void>;
+    flushSync(): void;
+    get size(): number;
+}
+
+export { JSONFileStorage, MemoryStorage, StorageAdapter };
+export type { JSONFileStorageOptions, MemoryStorageOptions };

package/dist/storage/index.d.mts

@@ -0,0 +1,97 @@
+import { S as StorageAdapter } from '../shared/device-passport.DirQmSd4.mjs';
+
+interface MemoryStorageOptions {
+    /**
+     * Whether to deep-clone stored and retrieved objects to prevent external mutations.
+     * Defaults to true.
+     */
+    clone?: boolean;
+}
+/**
+ * In-memory storage adapter.
+ * Useful for ephemeral scraping runs, tests, and caching.
+ */
+declare class MemoryStorage<T = any> implements StorageAdapter<T> {
+    private readonly store;
+    private readonly clone;
+    constructor(options?: MemoryStorageOptions);
+    private deepClone;
+    get(key: string): Promise<T | null>;
+    getSync(key: string): T | null;
+    set(key: string, value: T): Promise<void>;
+    setSync(key: string, value: T): void;
+    has(key: string): Promise<boolean>;
+    hasSync(key: string): boolean;
+    delete(key: string): Promise<boolean>;
+    deleteSync(key: string): boolean;
+    keys(): Promise<string[]>;
+    keysSync(): string[];
+    clear(): Promise<void>;
+    clearSync(): void;
+    get size(): number;
+}
+
+interface JSONFileStorageOptions {
+    /**
+     * Path to the JSON file on disk.
+     */
+    filePath: string;
+    /**
+     * Format JSON with indentation for readability.
+     * Defaults to true.
+     */
+    pretty?: boolean;
+    /**
+     * Auto-save to disk immediately when values change.
+     * Defaults to true.
+     */
+    autoSave?: boolean;
+}
+/**
+ * File-backed JSON storage adapter.
+ * Uses atomic writes via temp-file + renameSync to ensure zero corruption
+ * even if the process is killed mid-write. Automatically creates directories.
+ */
+declare class JSONFileStorage<T = any> implements StorageAdapter<T> {
+    readonly filePath: string;
+    private readonly pretty;
+    private readonly autoSave;
+    private readonly cache;
+    private isLoaded;
+    private writeQueue;
+    constructor(filePathOrOptions: string | JSONFileStorageOptions);
+    /**
+     * Ensure data is loaded from disk into the in-memory cache.
+     */
+    private ensureLoaded;
+    /**
+     * Atomic flush to disk. Writes to a unique temp file in the same directory,
+     * then atomically renames it to target file.
+     */
+    private flushAtomic;
+    /**
+     * Queue a disk write to prevent race conditions during rapid concurrent mutations.
+     */
+    private queueSave;
+    get(key: string): Promise<T | null>;
+    getSync(key: string): T | null;
+    set(key: string, value: T): Promise<void>;
+    setSync(key: string, value: T): void;
+    has(key: string): Promise<boolean>;
+    hasSync(key: string): boolean;
+    delete(key: string): Promise<boolean>;
+    deleteSync(key: string): boolean;
+    keys(): Promise<string[]>;
+    keysSync(): string[];
+    clear(): Promise<void>;
+    clearSync(): void;
+    /**
+     * Explicitly force a flush to disk (useful if autoSave is set to false).
+     */
+    flush(): Promise<void>;
+    flushSync(): void;
+    get size(): number;
+}
+
+export { JSONFileStorage, MemoryStorage, StorageAdapter };
+export type { JSONFileStorageOptions, MemoryStorageOptions };

package/dist/storage/index.d.ts

@@ -0,0 +1,97 @@
+import { S as StorageAdapter } from '../shared/device-passport.DirQmSd4.js';
+
+interface MemoryStorageOptions {
+    /**
+     * Whether to deep-clone stored and retrieved objects to prevent external mutations.
+     * Defaults to true.
+     */
+    clone?: boolean;
+}
+/**
+ * In-memory storage adapter.
+ * Useful for ephemeral scraping runs, tests, and caching.
+ */
+declare class MemoryStorage<T = any> implements StorageAdapter<T> {
+    private readonly store;
+    private readonly clone;
+    constructor(options?: MemoryStorageOptions);
+    private deepClone;
+    get(key: string): Promise<T | null>;
+    getSync(key: string): T | null;
+    set(key: string, value: T): Promise<void>;
+    setSync(key: string, value: T): void;
+    has(key: string): Promise<boolean>;
+    hasSync(key: string): boolean;
+    delete(key: string): Promise<boolean>;
+    deleteSync(key: string): boolean;
+    keys(): Promise<string[]>;
+    keysSync(): string[];
+    clear(): Promise<void>;
+    clearSync(): void;
+    get size(): number;
+}
+
+interface JSONFileStorageOptions {
+    /**
+     * Path to the JSON file on disk.
+     */
+    filePath: string;
+    /**
+     * Format JSON with indentation for readability.
+     * Defaults to true.
+     */
+    pretty?: boolean;
+    /**
+     * Auto-save to disk immediately when values change.
+     * Defaults to true.
+     */
+    autoSave?: boolean;
+}
+/**
+ * File-backed JSON storage adapter.
+ * Uses atomic writes via temp-file + renameSync to ensure zero corruption
+ * even if the process is killed mid-write. Automatically creates directories.
+ */
+declare class JSONFileStorage<T = any> implements StorageAdapter<T> {
+    readonly filePath: string;
+    private readonly pretty;
+    private readonly autoSave;
+    private readonly cache;
+    private isLoaded;
+    private writeQueue;
+    constructor(filePathOrOptions: string | JSONFileStorageOptions);
+    /**
+     * Ensure data is loaded from disk into the in-memory cache.
+     */
+    private ensureLoaded;
+    /**
+     * Atomic flush to disk. Writes to a unique temp file in the same directory,
+     * then atomically renames it to target file.
+     */
+    private flushAtomic;
+    /**
+     * Queue a disk write to prevent race conditions during rapid concurrent mutations.
+     */
+    private queueSave;
+    get(key: string): Promise<T | null>;
+    getSync(key: string): T | null;
+    set(key: string, value: T): Promise<void>;
+    setSync(key: string, value: T): void;
+    has(key: string): Promise<boolean>;
+    hasSync(key: string): boolean;
+    delete(key: string): Promise<boolean>;
+    deleteSync(key: string): boolean;
+    keys(): Promise<string[]>;
+    keysSync(): string[];
+    clear(): Promise<void>;
+    clearSync(): void;
+    /**
+     * Explicitly force a flush to disk (useful if autoSave is set to false).
+     */
+    flush(): Promise<void>;
+    flushSync(): void;
+    get size(): number;
+}
+
+export { JSONFileStorage, MemoryStorage, StorageAdapter };
+export type { JSONFileStorageOptions, MemoryStorageOptions };

package/dist/storage/index.mjs

@@ -0,0 +1,3 @@
+export { J as JSONFileStorage, M as MemoryStorage } from '../shared/device-passport.CyQtcZeD.mjs';
+import 'node:fs';
+import 'node:path';

package/dist/types/index.cjs

@@ -0,0 +1,2 @@
+'use strict';
+