@pathscale/secure-local-storage-chacha20-poly1305 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Configuration options for the secure local storage
+ */
+export interface SecureStorageConfig {
+    /** Custom hash key for encryption */
+    hashKey?: string;
+    /** Prefix for storage keys */
+    prefix?: string;
+    /** Disabled properties for fingerprint generation */
+    disabledKeys?: FingerprintProperty[];
+    /** Enable debug mode */
+    debug?: boolean;
+}
+/**
+ * Environment configuration for different frameworks
+ */
+export interface EnvironmentConfig {
+    /** React environment prefix */
+    REACT_APP_SECURE_LOCAL_STORAGE_HASH_KEY?: string;
+    REACT_APP_SECURE_LOCAL_STORAGE_PREFIX?: string;
+    REACT_APP_SECURE_LOCAL_STORAGE_DISABLED_KEYS?: string;
+    /** Vite environment prefix */
+    VITE_SECURE_LOCAL_STORAGE_HASH_KEY?: string;
+    VITE_SECURE_LOCAL_STORAGE_PREFIX?: string;
+    VITE_SECURE_LOCAL_STORAGE_DISABLED_KEYS?: string;
+    /** Next.js environment prefix */
+    NEXT_PUBLIC_SECURE_LOCAL_STORAGE_HASH_KEY?: string;
+    NEXT_PUBLIC_SECURE_LOCAL_STORAGE_PREFIX?: string;
+    NEXT_PUBLIC_SECURE_LOCAL_STORAGE_DISABLED_KEYS?: string;
+    /** Default environment variables */
+    SECURE_LOCAL_STORAGE_HASH_KEY?: string;
+    SECURE_LOCAL_STORAGE_PREFIX?: string;
+    SECURE_LOCAL_STORAGE_DISABLED_KEYS?: string;
+}
+/**
+ * Browser fingerprint properties
+ */
+export type FingerprintProperty = 'UserAgent' | 'ScreenPrint' | 'Plugins' | 'Fonts' | 'LocalStorage' | 'SessionStorage' | 'TimeZone' | 'Language' | 'SystemLanguage' | 'Cookie' | 'Canvas' | 'Hostname';
+/**
+ * Supported data types for storage
+ */
+export type StorageValue = string | number | boolean | object | null;
+/**
+ * Storage engine interface
+ */
+export interface StorageEngine {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+    key(index: number): string | null;
+    readonly length: number;
+}
+/**
+ * Encrypted storage item structure
+ */
+export interface EncryptedStorageItem {
+    data: string;
+    type: string;
+    timestamp: number;
+    version: string;
+}
+/**
+ * Browser fingerprint data
+ */
+export interface BrowserFingerprint {
+    userAgent: string;
+    screenPrint: string;
+    plugins: string;
+    fonts: string;
+    localStorage: boolean;
+    sessionStorage: boolean;
+    timeZone: string;
+    language: string;
+    systemLanguage: string;
+    cookie: boolean;
+    canvas: string;
+    hostname: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACrC,wBAAwB;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,uCAAuC,CAAC,EAAE,MAAM,CAAC;IACjD,qCAAqC,CAAC,EAAE,MAAM,CAAC;IAC/C,4CAA4C,CAAC,EAAE,MAAM,CAAC;IAEtD,8BAA8B;IAC9B,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C,uCAAuC,CAAC,EAAE,MAAM,CAAC;IAEjD,iCAAiC;IACjC,yCAAyC,CAAC,EAAE,MAAM,CAAC;IACnD,uCAAuC,CAAC,EAAE,MAAM,CAAC;IACjD,8CAA8C,CAAC,EAAE,MAAM,CAAC;IAExD,oCAAoC;IACpC,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,kCAAkC,CAAC,EAAE,MAAM,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,aAAa,GACb,SAAS,GACT,OAAO,GACP,cAAc,GACd,gBAAgB,GAChB,UAAU,GACV,UAAU,GACV,gBAAgB,GAChB,QAAQ,GACR,QAAQ,GACR,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,IAAI,IAAI,CAAC;IACd,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@pathscale/secure-local-storage-chacha20-poly1305",
+  "version": "1.0.0",
+  "description": "A secure localStorage wrapper using ChaCha20-Poly1305 and browser fingerprinting",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "build:watch": "rollup -c rollup.config.mjs -w",
+    "dev": "rollup -c rollup.config.mjs -w",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm run lint",
+    "preversion": "npm run lint",
+    "version": "npm run build && git add -A dist",
+    "postversion": "git push && git push --tags",
+    "clean": "rimraf dist"
+  },
+  "keywords": [
+    "localstorage",
+    "encryption",
+    "security",
+    "browser-fingerprinting",
+    "typescript",
+    "chacha20-poly1305",
+    "aead",
+    "secure-storage",
+    "privacy",
+    "data-protection",
+    "crypto",
+    "react",
+    "vue",
+    "angular",
+    "vite",
+    "nextjs"
+  ],
+  "author": "Pathscale",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pathscale/secure-local-storage-chacha20-poly1305.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pathscale/secure-local-storage-chacha20-poly1305/issues"
+  },
+  "homepage": "https://github.com/pathscale/secure-local-storage-chacha20-poly1305#readme",
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.2",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@typescript-eslint/eslint-plugin": "^8.46.0",
+    "@typescript-eslint/parser": "^8.46.0",
+    "eslint": "^8.54.0",
+    "rimraf": "^5.0.5",
+    "rollup": "^4.60.3",
+    "tslib": "^2.8.1",
+    "typescript": "^5.3.2"
+  },
+  "dependencies": {
+    "@noble/ciphers": "^2.2.0",
+    "@noble/hashes": "^2.2.0"
+  }
+}