@haverstack/blob-adapter-disk 0.6.0

package/LICENSE

@@ -0,0 +1,7 @@
+CC0 1.0 Universal (CC0 1.0) Public Domain Dedication
+
+To the extent possible under law, the Haverstack contributors have waived all
+copyright and related or neighboring rights to Haverstack. This work is
+published from the United States.
+
+https://creativecommons.org/publicdomain/zero/1.0/

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Haverstack — Disk Blob Adapter
+ * -------------------------------------------------------
+ * Implements StackBlobAdapter by storing content-addressed
+ * blobs on the local filesystem. File IDs are SHA-256 hashes
+ * of the content, enabling deduplication: if a file with the
+ * same hash already exists it is not overwritten.
+ */
+import type { StackBlobAdapter, FileId } from '@haverstack/core';
+export declare class DiskBlobAdapter implements StackBlobAdapter {
+    private readonly dir;
+    constructor(dir: string);
+    putAttachment(data: Uint8Array): Promise<FileId>;
+    getAttachment(fileId: FileId): Promise<Uint8Array>;
+    deleteAttachment(fileId: FileId): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAUjE,qBAAa,eAAgB,YAAW,gBAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,MAAM;IAIlC,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAQhD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAMlD,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQtD"}

package/dist/index.js

@@ -0,0 +1,48 @@
+/**
+ * Haverstack — Disk Blob Adapter
+ * -------------------------------------------------------
+ * Implements StackBlobAdapter by storing content-addressed
+ * blobs on the local filesystem. File IDs are SHA-256 hashes
+ * of the content, enabling deduplication: if a file with the
+ * same hash already exists it is not overwritten.
+ */
+import { createHash } from 'node:crypto';
+import { mkdirSync, existsSync } from 'fs';
+import { readFile, writeFile, unlink } from 'fs/promises';
+import { join } from 'path';
+const SHA256_HEX_RE = /^[0-9a-f]{64}$/;
+const assertFileId = (fileId) => {
+    if (!SHA256_HEX_RE.test(fileId)) {
+        throw new Error(`Invalid fileId: expected 64-character lowercase hex string`);
+    }
+};
+export class DiskBlobAdapter {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+        mkdirSync(dir, { recursive: true });
+    }
+    async putAttachment(data) {
+        const fileId = createHash('sha256').update(data).digest('hex');
+        if (!existsSync(join(this.dir, fileId))) {
+            await writeFile(join(this.dir, fileId), data);
+        }
+        return fileId;
+    }
+    async getAttachment(fileId) {
+        assertFileId(fileId);
+        if (!existsSync(join(this.dir, fileId)))
+            throw new Error(`Attachment not found: "${fileId}"`);
+        return readFile(join(this.dir, fileId));
+    }
+    async deleteAttachment(fileId) {
+        assertFileId(fileId);
+        try {
+            await unlink(join(this.dir, fileId));
+        }
+        catch {
+            // Non-fatal — file may already be gone.
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAEvC,MAAM,YAAY,GAAG,CAAC,MAAc,EAAQ,EAAE;IAC5C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;QACtC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAgB;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YACxC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAc;QAChC,YAAY,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,GAAG,CAAC,CAAC;QAC9F,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAc;QACnC,YAAY,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@haverstack/blob-adapter-disk",
+  "version": "0.6.0",
+  "description": "Disk blob adapter for Haverstack",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/haverstack/core",
+    "directory": "packages/blob-adapter-disk"
+  },
+  "license": "CC0-1.0",
+  "keywords": [
+    "haverstack",
+    "disk",
+    "blob",
+    "adapter",
+    "personal data",
+    "storage"
+  ],
+  "dependencies": {
+    "@haverstack/core": "0.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests"
+  }
+}