@krantho/media-local 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Descoped
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createLocalFileStore, LocalFileStore } from './local-file-store.js';
+//# 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,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createLocalFileStore, LocalFileStore } from './local-file-store.js';
+//# 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,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/local-file-store.d.ts

@@ -0,0 +1,17 @@
+import type { LocalMediaSection } from '@krantho/config';
+import type { IFileStore, StoredFile } from '@krantho/persistence';
+/** File store on local disk; the host framework serves `dir` at `urlPrefix` */
+export declare class LocalFileStore implements IFileStore {
+    readonly label = "Local disk";
+    readonly location: string;
+    private readonly urlPrefix;
+    constructor(section: LocalMediaSection);
+    put(key: string, bytes: Uint8Array, _contentType: string): Promise<StoredFile>;
+    get(key: string): Promise<Uint8Array | null>;
+    copy(fromKey: string, toKey: string, _contentType: string): Promise<StoredFile>;
+    delete(key: string): Promise<void>;
+    private pathOf;
+    private stored;
+}
+export declare function createLocalFileStore(section: LocalMediaSection): IFileStore;
+//# sourceMappingURL=local-file-store.d.ts.map

package/dist/local-file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-store.d.ts","sourceRoot":"","sources":["../src/local-file-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AASlE,+EAA+E;AAC/E,qBAAa,cAAe,YAAW,UAAU;IAC/C,QAAQ,CAAC,KAAK,gBAAe;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEtB,OAAO,EAAE,iBAAiB;IAKhC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAO9E,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAU5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ/E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,MAAM;CAGf;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAE3E"}

package/dist/local-file-store.js

@@ -0,0 +1,56 @@
+import { copyFile, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/** Flat keys only: no separators, no leading dot — nothing can escape the directory */
+const KEY_PATTERN = /^[a-z0-9][a-z0-9._-]*$/;
+function isNotFound(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+/** File store on local disk; the host framework serves `dir` at `urlPrefix` */
+export class LocalFileStore {
+    label = 'Local disk';
+    location;
+    urlPrefix;
+    constructor(section) {
+        this.location = section.dir;
+        this.urlPrefix = section.urlPrefix;
+    }
+    async put(key, bytes, _contentType) {
+        const path = this.pathOf(key);
+        await mkdir(this.location, { recursive: true });
+        await writeFile(path, bytes);
+        return this.stored(key);
+    }
+    async get(key) {
+        const path = this.pathOf(key);
+        try {
+            return new Uint8Array(await readFile(path));
+        }
+        catch (error) {
+            if (isNotFound(error))
+                return null;
+            throw error;
+        }
+    }
+    async copy(fromKey, toKey, _contentType) {
+        const from = this.pathOf(fromKey);
+        const to = this.pathOf(toKey);
+        await mkdir(this.location, { recursive: true });
+        await copyFile(from, to);
+        return this.stored(toKey);
+    }
+    async delete(key) {
+        await rm(this.pathOf(key), { force: true });
+    }
+    pathOf(key) {
+        if (!KEY_PATTERN.test(key))
+            throw new Error(`Invalid file key: ${key}`);
+        return join(this.location, key);
+    }
+    stored(key) {
+        return { key, url: `${this.urlPrefix}/${key}` };
+    }
+}
+export function createLocalFileStore(section) {
+    return new LocalFileStore(section);
+}
+//# sourceMappingURL=local-file-store.js.map

package/dist/local-file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-store.js","sourceRoot":"","sources":["../src/local-file-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAIhC,uFAAuF;AACvF,MAAM,WAAW,GAAG,wBAAwB,CAAA;AAE5C,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAA;AAC7E,CAAC;AAED,+EAA+E;AAC/E,MAAM,OAAO,cAAc;IAChB,KAAK,GAAG,YAAY,CAAA;IACpB,QAAQ,CAAQ;IACR,SAAS,CAAQ;IAElC,YAAY,OAA0B;QACpC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAA;QAC3B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAiB,EAAE,YAAoB;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC7B,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/C,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC7B,IAAI,CAAC;YACH,OAAO,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAA;YAClC,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,KAAa,EAAE,YAAoB;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACjC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC7B,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/C,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,CAAC;IAEO,MAAM,CAAC,GAAW;QACxB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAA;QACvE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IACjC,CAAC;IAEO,MAAM,CAAC,GAAW;QACxB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,EAAE,EAAE,CAAA;IACjD,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;AACpC,CAAC"}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@krantho/media-local",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.1",
+  "description": "The krantho media file store on local disk, for development and single servers with a persistent volume.",
+  "license": "MIT",
+  "homepage": "https://krantho.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/descoped/krantho.git",
+    "directory": "packages/media-local"
+  },
+  "bugs": {
+    "url": "https://github.com/descoped/krantho/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@krantho/config": "1.0.1",
+    "@krantho/persistence": "1.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.9",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.