@fgv/ts-http-storage 5.1.0-1

package/lib/packlets/storage/routes.js

@@ -0,0 +1,170 @@
+"use strict";
+/*
+ * Copyright (c) 2026 Erik Fortune
+ *
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStorageRoutes = createStorageRoutes;
+const hono_1 = require("hono");
+const converters_1 = require("./converters");
+const service_1 = require("./service");
+function parsePathQuery(path, namespace) {
+    return {
+        path: path !== null && path !== void 0 ? path : '/',
+        namespace
+    };
+}
+function parseSyncRequest(namespace) {
+    return { namespace };
+}
+/**
+ * Builds storage routes for a Hono app.
+ * @public
+ */
+function createStorageRoutes(options) {
+    const routes = new hono_1.Hono();
+    const service = new service_1.HttpStorageService(options.providers);
+    routes.get('/health', async (c) => {
+        const namespace = c.req.query('namespace');
+        const syncResult = await service.sync(parseSyncRequest(namespace));
+        if (syncResult.isFailure()) {
+            return c.json({ error: syncResult.message }, 500);
+        }
+        return c.json({ status: 'ok', namespace: namespace !== null && namespace !== void 0 ? namespace : 'default' });
+    });
+    routes.get('/tree/item', async (c) => {
+        const parsed = converters_1.storagePathRequest.convert(parsePathQuery(c.req.query('path'), c.req.query('namespace')));
+        if (parsed.isFailure()) {
+            return c.json({ error: `invalid request: ${parsed.message}` }, 400);
+        }
+        const result = await service.getItem(parsed.value);
+        if (result.isFailure()) {
+            return c.json({ error: result.message }, 404);
+        }
+        const converted = converters_1.storageTreeItem.convert(result.value);
+        if (converted.isFailure()) {
+            return c.json({ error: `invalid response: ${converted.message}` }, 500);
+        }
+        return c.json(converted.value);
+    });
+    routes.get('/tree/children', async (c) => {
+        const parsed = converters_1.storagePathRequest.convert(parsePathQuery(c.req.query('path'), c.req.query('namespace')));
+        if (parsed.isFailure()) {
+            return c.json({ error: `invalid request: ${parsed.message}` }, 400);
+        }
+        const result = await service.getChildren(parsed.value);
+        if (result.isFailure()) {
+            return c.json({ error: result.message }, 404);
+        }
+        const converted = converters_1.storageTreeChildrenResponse.convert(result.value);
+        if (converted.isFailure()) {
+            return c.json({ error: `invalid response: ${converted.message}` }, 500);
+        }
+        return c.json(converted.value);
+    });
+    routes.get('/file', async (c) => {
+        const parsed = converters_1.storagePathRequest.convert(parsePathQuery(c.req.query('path'), c.req.query('namespace')));
+        if (parsed.isFailure()) {
+            return c.json({ error: `invalid request: ${parsed.message}` }, 400);
+        }
+        const result = await service.getFile(parsed.value);
+        if (result.isFailure()) {
+            return c.json({ error: result.message }, 404);
+        }
+        const converted = converters_1.storageFileResponse.convert(result.value);
+        if (converted.isFailure()) {
+            return c.json({ error: `invalid response: ${converted.message}` }, 500);
+        }
+        return c.json(converted.value);
+    });
+    routes.put('/file', async (c) => {
+        var _a, _b;
+        const raw = await c.req.json().catch(() => undefined);
+        if (raw === undefined) {
+            return c.json({ error: 'invalid JSON body' }, 400);
+        }
+        const parsed = converters_1.storageWriteFileRequest.convert(raw);
+        if (parsed.isFailure()) {
+            return c.json({ error: `invalid request: ${parsed.message}` }, 400);
+        }
+        const result = await service.saveFile(parsed.value);
+        if (result.isFailure()) {
+            return c.json({ error: result.message }, 400);
+        }
+        const converted = converters_1.storageFileResponse.convert(result.value);
+        if (converted.isFailure()) {
+            return c.json({ error: `invalid response: ${converted.message}` }, 500);
+        }
+        (_a = options.logger) === null || _a === void 0 ? void 0 : _a.detail(`storage write: ${(_b = parsed.value.namespace) !== null && _b !== void 0 ? _b : 'default'}:${parsed.value.path}`);
+        return c.json(converted.value);
+    });
+    routes.delete('/file', async (c) => {
+        var _a, _b;
+        const parsed = converters_1.storagePathRequest.convert(parsePathQuery(c.req.query('path'), c.req.query('namespace')));
+        if (parsed.isFailure()) {
+            return c.json({ error: `invalid request: ${parsed.message}` }, 400);
+        }
+        const result = await service.deleteFile(parsed.value);
+        if (result.isFailure()) {
+            return c.json({ error: result.message }, 404);
+        }
+        (_a = options.logger) === null || _a === void 0 ? void 0 : _a.detail(`storage delete: ${(_b = parsed.value.namespace) !== null && _b !== void 0 ? _b : 'default'}:${parsed.value.path}`);
+        return c.json({ deleted: result.value });
+    });
+    routes.post('/directories', async (c) => {
+        const raw = await c.req.json().catch(() => undefined);
+        if (raw === undefined) {
+            return c.json({ error: 'invalid JSON body' }, 400);
+        }
+        const parsed = converters_1.storagePathRequest.convert(raw);
+        if (parsed.isFailure()) {
+            return c.json({ error: `invalid request: ${parsed.message}` }, 400);
+        }
+        const result = await service.createDirectory(parsed.value);
+        if (result.isFailure()) {
+            return c.json({ error: result.message }, 400);
+        }
+        const converted = converters_1.storageTreeItem.convert(result.value);
+        if (converted.isFailure()) {
+            return c.json({ error: `invalid response: ${converted.message}` }, 500);
+        }
+        return c.json(converted.value);
+    });
+    routes.post('/sync', async (c) => {
+        const raw = await c.req.json().catch(() => ({}));
+        const parsed = converters_1.storageSyncRequest.convert(raw);
+        if (parsed.isFailure()) {
+            return c.json({ error: `invalid request: ${parsed.message}` }, 400);
+        }
+        const result = await service.sync(parsed.value);
+        if (result.isFailure()) {
+            return c.json({ error: result.message }, 500);
+        }
+        return c.json(result.value);
+    });
+    routes.onError((err, c) => {
+        var _a;
+        const message = err instanceof Error ? err.message : String(err);
+        (_a = options.logger) === null || _a === void 0 ? void 0 : _a.error(`storage route error: ${message}`);
+        return c.json({ error: message }, 500);
+    });
+    return routes;
+}
+//# sourceMappingURL=routes.js.map

package/lib/packlets/storage/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/packlets/storage/routes.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Hono } from 'hono';\n\nimport type { Logging } from '@fgv/ts-utils';\n\nimport {\n  storagePathRequest,\n  storageSyncRequest,\n  storageWriteFileRequest,\n  storageTreeChildrenResponse,\n  storageTreeItem,\n  storageFileResponse\n} from './converters';\nimport { HttpStorageService } from './service';\nimport type { IStoragePathRequest, IStorageSyncRequest } from './model';\nimport type { IHttpStorageProviderFactory } from './provider';\n\n/**\n * Options for creating storage routes.\n * @public\n */\nexport interface ICreateStorageRoutesOptions {\n  readonly providers: IHttpStorageProviderFactory;\n  readonly logger?: Logging.ILogger;\n}\n\nfunction parsePathQuery(path: string | undefined, namespace: string | undefined): IStoragePathRequest {\n  return {\n    path: path ?? '/',\n    namespace\n  };\n}\n\nfunction parseSyncRequest(namespace: string | undefined): IStorageSyncRequest {\n  return { namespace };\n}\n\n/**\n * Builds storage routes for a Hono app.\n * @public\n */\nexport function createStorageRoutes(options: ICreateStorageRoutesOptions): Hono {\n  const routes = new Hono();\n  const service = new HttpStorageService(options.providers);\n\n  routes.get('/health', async (c) => {\n    const namespace = c.req.query('namespace');\n    const syncResult = await service.sync(parseSyncRequest(namespace));\n    if (syncResult.isFailure()) {\n      return c.json({ error: syncResult.message }, 500);\n    }\n    return c.json({ status: 'ok', namespace: namespace ?? 'default' });\n  });\n\n  routes.get('/tree/item', async (c) => {\n    const parsed = storagePathRequest.convert(parsePathQuery(c.req.query('path'), c.req.query('namespace')));\n    if (parsed.isFailure()) {\n      return c.json({ error: `invalid request: ${parsed.message}` }, 400);\n    }\n\n    const result = await service.getItem(parsed.value);\n    if (result.isFailure()) {\n      return c.json({ error: result.message }, 404);\n    }\n\n    const converted = storageTreeItem.convert(result.value);\n    if (converted.isFailure()) {\n      return c.json({ error: `invalid response: ${converted.message}` }, 500);\n    }\n    return c.json(converted.value);\n  });\n\n  routes.get('/tree/children', async (c) => {\n    const parsed = storagePathRequest.convert(parsePathQuery(c.req.query('path'), c.req.query('namespace')));\n    if (parsed.isFailure()) {\n      return c.json({ error: `invalid request: ${parsed.message}` }, 400);\n    }\n\n    const result = await service.getChildren(parsed.value);\n    if (result.isFailure()) {\n      return c.json({ error: result.message }, 404);\n    }\n\n    const converted = storageTreeChildrenResponse.convert(result.value);\n    if (converted.isFailure()) {\n      return c.json({ error: `invalid response: ${converted.message}` }, 500);\n    }\n    return c.json(converted.value);\n  });\n\n  routes.get('/file', async (c) => {\n    const parsed = storagePathRequest.convert(parsePathQuery(c.req.query('path'), c.req.query('namespace')));\n    if (parsed.isFailure()) {\n      return c.json({ error: `invalid request: ${parsed.message}` }, 400);\n    }\n\n    const result = await service.getFile(parsed.value);\n    if (result.isFailure()) {\n      return c.json({ error: result.message }, 404);\n    }\n\n    const converted = storageFileResponse.convert(result.value);\n    if (converted.isFailure()) {\n      return c.json({ error: `invalid response: ${converted.message}` }, 500);\n    }\n    return c.json(converted.value);\n  });\n\n  routes.put('/file', async (c) => {\n    const raw = await c.req.json().catch(() => undefined);\n    if (raw === undefined) {\n      return c.json({ error: 'invalid JSON body' }, 400);\n    }\n\n    const parsed = storageWriteFileRequest.convert(raw);\n    if (parsed.isFailure()) {\n      return c.json({ error: `invalid request: ${parsed.message}` }, 400);\n    }\n\n    const result = await service.saveFile(parsed.value);\n    if (result.isFailure()) {\n      return c.json({ error: result.message }, 400);\n    }\n\n    const converted = storageFileResponse.convert(result.value);\n    if (converted.isFailure()) {\n      return c.json({ error: `invalid response: ${converted.message}` }, 500);\n    }\n\n    options.logger?.detail(`storage write: ${parsed.value.namespace ?? 'default'}:${parsed.value.path}`);\n    return c.json(converted.value);\n  });\n\n  routes.delete('/file', async (c) => {\n    const parsed = storagePathRequest.convert(parsePathQuery(c.req.query('path'), c.req.query('namespace')));\n    if (parsed.isFailure()) {\n      return c.json({ error: `invalid request: ${parsed.message}` }, 400);\n    }\n\n    const result = await service.deleteFile(parsed.value);\n    if (result.isFailure()) {\n      return c.json({ error: result.message }, 404);\n    }\n\n    options.logger?.detail(`storage delete: ${parsed.value.namespace ?? 'default'}:${parsed.value.path}`);\n    return c.json({ deleted: result.value });\n  });\n\n  routes.post('/directories', async (c) => {\n    const raw = await c.req.json().catch(() => undefined);\n    if (raw === undefined) {\n      return c.json({ error: 'invalid JSON body' }, 400);\n    }\n\n    const parsed = storagePathRequest.convert(raw);\n    if (parsed.isFailure()) {\n      return c.json({ error: `invalid request: ${parsed.message}` }, 400);\n    }\n\n    const result = await service.createDirectory(parsed.value);\n    if (result.isFailure()) {\n      return c.json({ error: result.message }, 400);\n    }\n\n    const converted = storageTreeItem.convert(result.value);\n    if (converted.isFailure()) {\n      return c.json({ error: `invalid response: ${converted.message}` }, 500);\n    }\n    return c.json(converted.value);\n  });\n\n  routes.post('/sync', async (c) => {\n    const raw = await c.req.json().catch(() => ({}));\n    const parsed = storageSyncRequest.convert(raw);\n    if (parsed.isFailure()) {\n      return c.json({ error: `invalid request: ${parsed.message}` }, 400);\n    }\n\n    const result = await service.sync(parsed.value);\n    if (result.isFailure()) {\n      return c.json({ error: result.message }, 500);\n    }\n\n    return c.json(result.value);\n  });\n\n  routes.onError((err, c) => {\n    const message = err instanceof Error ? err.message : String(err);\n    options.logger?.error(`storage route error: ${message}`);\n    return c.json({ error: message }, 500);\n  });\n\n  return routes;\n}\n"]}

package/lib/packlets/storage/service.d.ts

@@ -0,0 +1,20 @@
+import { type Result } from '@fgv/ts-utils';
+import type { IStorageFileResponse, IStoragePathRequest, IStorageSyncRequest, IStorageSyncResponse, IStorageTreeChildrenResponse, IStorageTreeItem, IStorageWriteFileRequest } from './model';
+import type { IHttpStorageProviderFactory } from './provider';
+/**
+ * Service layer for storage API operations.
+ * @public
+ */
+export declare class HttpStorageService {
+    private readonly _providers;
+    constructor(providers: IHttpStorageProviderFactory);
+    getItem(request: IStoragePathRequest): Promise<Result<IStorageTreeItem>>;
+    getChildren(request: IStoragePathRequest): Promise<Result<IStorageTreeChildrenResponse>>;
+    getFile(request: IStoragePathRequest): Promise<Result<IStorageFileResponse>>;
+    saveFile(request: IStorageWriteFileRequest): Promise<Result<IStorageFileResponse>>;
+    deleteFile(request: IStoragePathRequest): Promise<Result<boolean>>;
+    createDirectory(request: IStoragePathRequest): Promise<Result<IStorageTreeItem>>;
+    sync(request: IStorageSyncRequest): Promise<Result<IStorageSyncResponse>>;
+    private _getProvider;
+}
+//# sourceMappingURL=service.d.ts.map

package/lib/packlets/storage/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/packlets/storage/service.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAQ,KAAK,MAAM,EAAW,MAAM,eAAe,CAAC;AAE3D,OAAO,KAAK,EAEV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE9D;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;gBAEtC,SAAS,EAAE,2BAA2B;IAI5C,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAQxE,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAexF,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAQ5E,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAQlF,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAQlE,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAQhF,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAQtF,OAAO,CAAC,YAAY;CAGrB"}

package/lib/packlets/storage/service.js

@@ -0,0 +1,95 @@
+"use strict";
+/*
+ * Copyright (c) 2026 Erik Fortune
+ *
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpStorageService = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+/**
+ * Service layer for storage API operations.
+ * @public
+ */
+class HttpStorageService {
+    constructor(providers) {
+        this._providers = providers;
+    }
+    async getItem(request) {
+        const providerResult = this._getProvider(request.namespace);
+        if (providerResult.isFailure()) {
+            return (0, ts_utils_1.fail)(providerResult.message);
+        }
+        return providerResult.value.getItem(request.path);
+    }
+    async getChildren(request) {
+        const providerResult = this._getProvider(request.namespace);
+        if (providerResult.isFailure()) {
+            return (0, ts_utils_1.fail)(providerResult.message);
+        }
+        const childrenResult = await providerResult.value.getChildren(request.path);
+        if (childrenResult.isFailure()) {
+            return (0, ts_utils_1.fail)(childrenResult.message);
+        }
+        return (0, ts_utils_1.succeed)({
+            path: request.path,
+            children: childrenResult.value
+        });
+    }
+    async getFile(request) {
+        const providerResult = this._getProvider(request.namespace);
+        if (providerResult.isFailure()) {
+            return (0, ts_utils_1.fail)(providerResult.message);
+        }
+        return providerResult.value.getFile(request.path);
+    }
+    async saveFile(request) {
+        const providerResult = this._getProvider(request.namespace);
+        if (providerResult.isFailure()) {
+            return (0, ts_utils_1.fail)(providerResult.message);
+        }
+        return providerResult.value.saveFile(request.path, request.contents, request.contentType);
+    }
+    async deleteFile(request) {
+        const providerResult = this._getProvider(request.namespace);
+        if (providerResult.isFailure()) {
+            return (0, ts_utils_1.fail)(providerResult.message);
+        }
+        return providerResult.value.deleteFile(request.path);
+    }
+    async createDirectory(request) {
+        const providerResult = this._getProvider(request.namespace);
+        if (providerResult.isFailure()) {
+            return (0, ts_utils_1.fail)(providerResult.message);
+        }
+        return providerResult.value.createDirectory(request.path);
+    }
+    async sync(request) {
+        const providerResult = this._getProvider(request.namespace);
+        if (providerResult.isFailure()) {
+            return (0, ts_utils_1.fail)(providerResult.message);
+        }
+        return providerResult.value.sync();
+    }
+    _getProvider(namespace) {
+        return this._providers.forNamespace(namespace).withErrorFormat((msg) => `provider: ${msg}`);
+    }
+}
+exports.HttpStorageService = HttpStorageService;
+//# sourceMappingURL=service.js.map

package/lib/packlets/storage/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/packlets/storage/service.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { fail, type Result, succeed } from '@fgv/ts-utils';\n\nimport type {\n  IHttpStorageProvider,\n  IStorageFileResponse,\n  IStoragePathRequest,\n  IStorageSyncRequest,\n  IStorageSyncResponse,\n  IStorageTreeChildrenResponse,\n  IStorageTreeItem,\n  IStorageWriteFileRequest\n} from './model';\nimport type { IHttpStorageProviderFactory } from './provider';\n\n/**\n * Service layer for storage API operations.\n * @public\n */\nexport class HttpStorageService {\n  private readonly _providers: IHttpStorageProviderFactory;\n\n  public constructor(providers: IHttpStorageProviderFactory) {\n    this._providers = providers;\n  }\n\n  public async getItem(request: IStoragePathRequest): Promise<Result<IStorageTreeItem>> {\n    const providerResult = this._getProvider(request.namespace);\n    if (providerResult.isFailure()) {\n      return fail(providerResult.message);\n    }\n    return providerResult.value.getItem(request.path);\n  }\n\n  public async getChildren(request: IStoragePathRequest): Promise<Result<IStorageTreeChildrenResponse>> {\n    const providerResult = this._getProvider(request.namespace);\n    if (providerResult.isFailure()) {\n      return fail(providerResult.message);\n    }\n    const childrenResult = await providerResult.value.getChildren(request.path);\n    if (childrenResult.isFailure()) {\n      return fail(childrenResult.message);\n    }\n    return succeed({\n      path: request.path,\n      children: childrenResult.value\n    });\n  }\n\n  public async getFile(request: IStoragePathRequest): Promise<Result<IStorageFileResponse>> {\n    const providerResult = this._getProvider(request.namespace);\n    if (providerResult.isFailure()) {\n      return fail(providerResult.message);\n    }\n    return providerResult.value.getFile(request.path);\n  }\n\n  public async saveFile(request: IStorageWriteFileRequest): Promise<Result<IStorageFileResponse>> {\n    const providerResult = this._getProvider(request.namespace);\n    if (providerResult.isFailure()) {\n      return fail(providerResult.message);\n    }\n    return providerResult.value.saveFile(request.path, request.contents, request.contentType);\n  }\n\n  public async deleteFile(request: IStoragePathRequest): Promise<Result<boolean>> {\n    const providerResult = this._getProvider(request.namespace);\n    if (providerResult.isFailure()) {\n      return fail(providerResult.message);\n    }\n    return providerResult.value.deleteFile(request.path);\n  }\n\n  public async createDirectory(request: IStoragePathRequest): Promise<Result<IStorageTreeItem>> {\n    const providerResult = this._getProvider(request.namespace);\n    if (providerResult.isFailure()) {\n      return fail(providerResult.message);\n    }\n    return providerResult.value.createDirectory(request.path);\n  }\n\n  public async sync(request: IStorageSyncRequest): Promise<Result<IStorageSyncResponse>> {\n    const providerResult = this._getProvider(request.namespace);\n    if (providerResult.isFailure()) {\n      return fail(providerResult.message);\n    }\n    return providerResult.value.sync();\n  }\n\n  private _getProvider(namespace?: string): Result<IHttpStorageProvider> {\n    return this._providers.forNamespace(namespace).withErrorFormat((msg) => `provider: ${msg}`);\n  }\n}\n"]}

package/lib/test/unit/storage/fsProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fsProvider.test.d.ts.map

package/lib/test/unit/storage/fsProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsProvider.test.d.ts","sourceRoot":"","sources":["../../../../src/test/unit/storage/fsProvider.test.ts"],"names":[],"mappings":""}

package/lib/test/unit/storage/fsProvider.test.js

@@ -0,0 +1,106 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const storage_1 = require("../../../packlets/storage");
+describe('sanitizeNamespace', () => {
+    test('returns default when namespace is empty', () => {
+        expect((0, storage_1.sanitizeNamespace)(undefined).isSuccess()).toBe(true);
+        expect((0, storage_1.sanitizeNamespace)('   ').isSuccess()).toBe(true);
+        expect((0, storage_1.sanitizeNamespace)('   ').orThrow()).toBe('default');
+    });
+    test('accepts valid namespace values', () => {
+        const result = (0, storage_1.sanitizeNamespace)('team.alpha_01-dev');
+        expect(result.isSuccess()).toBe(true);
+        expect(result.orThrow()).toBe('team.alpha_01-dev');
+    });
+    test('rejects invalid namespace characters', () => {
+        const result = (0, storage_1.sanitizeNamespace)('../escape');
+        expect(result.isFailure()).toBe(true);
+        expect(result.message).toContain('only [a-zA-Z0-9._-] allowed');
+    });
+});
+describe('FsStorageProvider', () => {
+    let rootPath;
+    beforeEach(() => {
+        rootPath = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'ts-http-storage-test-'));
+    });
+    afterEach(() => {
+        fs_1.default.rmSync(rootPath, { recursive: true, force: true });
+    });
+    test('saves and loads files', async () => {
+        const provider = new storage_1.FsStorageProvider(rootPath);
+        const saveResult = await provider.saveFile('/data/example.txt', 'hello');
+        expect(saveResult.isSuccess()).toBe(true);
+        const fileResult = await provider.getFile('/data/example.txt');
+        expect(fileResult.isSuccess()).toBe(true);
+        expect(fileResult.orThrow()).toEqual({
+            path: '/data/example.txt',
+            contents: 'hello'
+        });
+    });
+    test('lists children in a directory', async () => {
+        const provider = new storage_1.FsStorageProvider(rootPath);
+        await provider.saveFile('/data/one.txt', 'one');
+        await provider.saveFile('/data/two.txt', 'two');
+        const childrenResult = await provider.getChildren('/data');
+        expect(childrenResult.isSuccess()).toBe(true);
+        const childNames = childrenResult
+            .orThrow()
+            .map((child) => child.name)
+            .sort();
+        expect(childNames).toEqual(['one.txt', 'two.txt']);
+    });
+    test('normalizes traversal-like request paths under storage root', async () => {
+        const provider = new storage_1.FsStorageProvider(rootPath);
+        const result = await provider.getItem('../../etc/passwd');
+        expect(result.isFailure()).toBe(true);
+        expect(result.message).toContain('ENOENT');
+        expect(result.message).toContain(path_1.default.join(rootPath, 'etc/passwd'));
+    });
+    test('deletes an existing file', async () => {
+        const provider = new storage_1.FsStorageProvider(rootPath);
+        await provider.saveFile('/data/delete-me.txt', 'temporary');
+        const deleteResult = await provider.deleteFile('/data/delete-me.txt');
+        expect(deleteResult.isSuccess()).toBe(true);
+        expect(deleteResult.orThrow()).toBe(true);
+        const readResult = await provider.getFile('/data/delete-me.txt');
+        expect(readResult.isFailure()).toBe(true);
+    });
+});
+describe('FsStorageProviderFactory', () => {
+    let rootPath;
+    beforeEach(() => {
+        rootPath = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'ts-http-storage-factory-'));
+    });
+    afterEach(() => {
+        fs_1.default.rmSync(rootPath, { recursive: true, force: true });
+    });
+    test('creates namespace-scoped providers', async () => {
+        const factory = new storage_1.FsStorageProviderFactory({ rootPath });
+        const providerResult = factory.forNamespace('team-a');
+        expect(providerResult.isSuccess()).toBe(true);
+        const provider = providerResult.orThrow();
+        const saveResult = await provider.saveFile('/notes.txt', 'namespaced');
+        expect(saveResult.isSuccess()).toBe(true);
+        const expectedPath = path_1.default.join(rootPath, 'team-a', 'notes.txt');
+        expect(fs_1.default.existsSync(expectedPath)).toBe(true);
+    });
+    test('fails for invalid namespace', () => {
+        const factory = new storage_1.FsStorageProviderFactory({ rootPath });
+        const result = factory.forNamespace('bad/name');
+        expect(result.isFailure()).toBe(true);
+        expect(result.message).toContain('only [a-zA-Z0-9._-] allowed');
+    });
+    test('rejects namespace that resolves outside root', () => {
+        const factory = new storage_1.FsStorageProviderFactory({ rootPath });
+        const result = factory.forNamespace('..');
+        expect(result.isFailure()).toBe(true);
+        expect(result.message).toContain('outside root');
+    });
+});
+//# sourceMappingURL=fsProvider.test.js.map

package/lib/test/unit/storage/fsProvider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsProvider.test.js","sourceRoot":"","sources":["../../../../src/test/unit/storage/fsProvider.test.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'fs';\nimport os from 'os';\nimport path from 'path';\n\nimport { FsStorageProvider, FsStorageProviderFactory, sanitizeNamespace } from '../../../packlets/storage';\n\ndescribe('sanitizeNamespace', () => {\n  test('returns default when namespace is empty', () => {\n    expect(sanitizeNamespace(undefined).isSuccess()).toBe(true);\n    expect(sanitizeNamespace('   ').isSuccess()).toBe(true);\n    expect(sanitizeNamespace('   ').orThrow()).toBe('default');\n  });\n\n  test('accepts valid namespace values', () => {\n    const result = sanitizeNamespace('team.alpha_01-dev');\n    expect(result.isSuccess()).toBe(true);\n    expect(result.orThrow()).toBe('team.alpha_01-dev');\n  });\n\n  test('rejects invalid namespace characters', () => {\n    const result = sanitizeNamespace('../escape');\n    expect(result.isFailure()).toBe(true);\n    expect(result.message).toContain('only [a-zA-Z0-9._-] allowed');\n  });\n});\n\ndescribe('FsStorageProvider', () => {\n  let rootPath: string;\n\n  beforeEach(() => {\n    rootPath = fs.mkdtempSync(path.join(os.tmpdir(), 'ts-http-storage-test-'));\n  });\n\n  afterEach(() => {\n    fs.rmSync(rootPath, { recursive: true, force: true });\n  });\n\n  test('saves and loads files', async () => {\n    const provider = new FsStorageProvider(rootPath);\n\n    const saveResult = await provider.saveFile('/data/example.txt', 'hello');\n    expect(saveResult.isSuccess()).toBe(true);\n\n    const fileResult = await provider.getFile('/data/example.txt');\n    expect(fileResult.isSuccess()).toBe(true);\n    expect(fileResult.orThrow()).toEqual({\n      path: '/data/example.txt',\n      contents: 'hello'\n    });\n  });\n\n  test('lists children in a directory', async () => {\n    const provider = new FsStorageProvider(rootPath);\n    await provider.saveFile('/data/one.txt', 'one');\n    await provider.saveFile('/data/two.txt', 'two');\n\n    const childrenResult = await provider.getChildren('/data');\n    expect(childrenResult.isSuccess()).toBe(true);\n\n    const childNames = childrenResult\n      .orThrow()\n      .map((child) => child.name)\n      .sort();\n    expect(childNames).toEqual(['one.txt', 'two.txt']);\n  });\n\n  test('normalizes traversal-like request paths under storage root', async () => {\n    const provider = new FsStorageProvider(rootPath);\n\n    const result = await provider.getItem('../../etc/passwd');\n    expect(result.isFailure()).toBe(true);\n    expect(result.message).toContain('ENOENT');\n    expect(result.message).toContain(path.join(rootPath, 'etc/passwd'));\n  });\n\n  test('deletes an existing file', async () => {\n    const provider = new FsStorageProvider(rootPath);\n    await provider.saveFile('/data/delete-me.txt', 'temporary');\n\n    const deleteResult = await provider.deleteFile('/data/delete-me.txt');\n    expect(deleteResult.isSuccess()).toBe(true);\n    expect(deleteResult.orThrow()).toBe(true);\n\n    const readResult = await provider.getFile('/data/delete-me.txt');\n    expect(readResult.isFailure()).toBe(true);\n  });\n});\n\ndescribe('FsStorageProviderFactory', () => {\n  let rootPath: string;\n\n  beforeEach(() => {\n    rootPath = fs.mkdtempSync(path.join(os.tmpdir(), 'ts-http-storage-factory-'));\n  });\n\n  afterEach(() => {\n    fs.rmSync(rootPath, { recursive: true, force: true });\n  });\n\n  test('creates namespace-scoped providers', async () => {\n    const factory = new FsStorageProviderFactory({ rootPath });\n\n    const providerResult = factory.forNamespace('team-a');\n    expect(providerResult.isSuccess()).toBe(true);\n\n    const provider = providerResult.orThrow();\n    const saveResult = await provider.saveFile('/notes.txt', 'namespaced');\n    expect(saveResult.isSuccess()).toBe(true);\n\n    const expectedPath = path.join(rootPath, 'team-a', 'notes.txt');\n    expect(fs.existsSync(expectedPath)).toBe(true);\n  });\n\n  test('fails for invalid namespace', () => {\n    const factory = new FsStorageProviderFactory({ rootPath });\n    const result = factory.forNamespace('bad/name');\n\n    expect(result.isFailure()).toBe(true);\n    expect(result.message).toContain('only [a-zA-Z0-9._-] allowed');\n  });\n\n  test('rejects namespace that resolves outside root', () => {\n    const factory = new FsStorageProviderFactory({ rootPath });\n    const result = factory.forNamespace('..');\n\n    expect(result.isFailure()).toBe(true);\n    expect(result.message).toContain('outside root');\n  });\n});\n"]}

package/lib/test/unit/storage/routes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=routes.test.d.ts.map

package/lib/test/unit/storage/routes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.test.d.ts","sourceRoot":"","sources":["../../../../src/test/unit/storage/routes.test.ts"],"names":[],"mappings":""}

package/lib/test/unit/storage/routes.test.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ts_utils_1 = require("@fgv/ts-utils");
+const storage_1 = require("../../../packlets/storage");
+class InMemoryProvider {
+    constructor() {
+        this._files = new Map();
+    }
+    _basename(path) {
+        var _a;
+        const parts = path.split('/');
+        return (_a = parts[parts.length - 1]) !== null && _a !== void 0 ? _a : '';
+    }
+    async getItem(path) {
+        if (this._files.has(path)) {
+            return (0, ts_utils_1.succeed)({ path, name: this._basename(path), type: 'file' });
+        }
+        return (0, ts_utils_1.fail)(`${path}: not found`);
+    }
+    async getChildren(path) {
+        const children = [];
+        for (const filePath of this._files.keys()) {
+            if (filePath.startsWith(`${path}/`)) {
+                const name = filePath.substring(path.length + 1);
+                if (!name.includes('/')) {
+                    children.push({ path: filePath, name, type: 'file' });
+                }
+            }
+        }
+        return (0, ts_utils_1.succeed)(children);
+    }
+    async getFile(path) {
+        const contents = this._files.get(path);
+        if (contents === undefined) {
+            return (0, ts_utils_1.fail)(`${path}: not found`);
+        }
+        return (0, ts_utils_1.succeed)({ path, contents });
+    }
+    async saveFile(path, contents) {
+        this._files.set(path, contents);
+        return (0, ts_utils_1.succeed)({ path, contents });
+    }
+    async deleteFile(path) {
+        if (!this._files.has(path)) {
+            return (0, ts_utils_1.fail)(`${path}: not found`);
+        }
+        this._files.delete(path);
+        return (0, ts_utils_1.succeed)(true);
+    }
+    async createDirectory(path) {
+        return (0, ts_utils_1.succeed)({ path, name: this._basename(path), type: 'directory' });
+    }
+    async sync() {
+        return (0, ts_utils_1.succeed)({ synced: this._files.size });
+    }
+}
+class TestProviderFactory {
+    constructor(provider) {
+        this._provider = provider;
+    }
+    forNamespace() {
+        return (0, ts_utils_1.succeed)(this._provider);
+    }
+}
+describe('createStorageRoutes', () => {
+    test('writes then reads a file', async () => {
+        const provider = new InMemoryProvider();
+        const app = (0, storage_1.createStorageRoutes)({ providers: new TestProviderFactory(provider) });
+        const putResponse = await app.request(new Request('http://localhost/file', {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ path: '/data/demo.txt', contents: 'hello' })
+        }));
+        expect(putResponse.status).toBe(200);
+        const getResponse = await app.request(new Request('http://localhost/file?path=/data/demo.txt'));
+        expect(getResponse.status).toBe(200);
+        await expect(getResponse.json()).resolves.toEqual({ path: '/data/demo.txt', contents: 'hello' });
+    });
+    test('returns 400 for invalid put body', async () => {
+        const provider = new InMemoryProvider();
+        const app = (0, storage_1.createStorageRoutes)({ providers: new TestProviderFactory(provider) });
+        const response = await app.request(new Request('http://localhost/file', {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: '{ not-json'
+        }));
+        expect(response.status).toBe(400);
+        const payload = (await response.json());
+        expect(payload.error).toContain('invalid JSON body');
+    });
+    test('returns sync payload from provider', async () => {
+        const provider = new InMemoryProvider();
+        const app = (0, storage_1.createStorageRoutes)({ providers: new TestProviderFactory(provider) });
+        await app.request(new Request('http://localhost/file', {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ path: '/alpha.txt', contents: 'a' })
+        }));
+        const response = await app.request(new Request('http://localhost/sync', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({})
+        }));
+        expect(response.status).toBe(200);
+        await expect(response.json()).resolves.toEqual({ synced: 1 });
+    });
+    test('deletes a file through DELETE /file', async () => {
+        const provider = new InMemoryProvider();
+        const app = (0, storage_1.createStorageRoutes)({ providers: new TestProviderFactory(provider) });
+        await app.request(new Request('http://localhost/file', {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ path: '/data/remove-me.txt', contents: 'gone soon' })
+        }));
+        const deleteResponse = await app.request(new Request('http://localhost/file?path=/data/remove-me.txt', {
+            method: 'DELETE'
+        }));
+        expect(deleteResponse.status).toBe(200);
+        await expect(deleteResponse.json()).resolves.toEqual({ deleted: true });
+        const getResponse = await app.request(new Request('http://localhost/file?path=/data/remove-me.txt'));
+        expect(getResponse.status).toBe(404);
+    });
+});
+//# sourceMappingURL=routes.test.js.map

package/lib/test/unit/storage/routes.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.test.js","sourceRoot":"","sources":["../../../../src/test/unit/storage/routes.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { fail, type Result, succeed } from '@fgv/ts-utils';\n\nimport {\n  createStorageRoutes,\n  type IHttpStorageProvider,\n  type IHttpStorageProviderFactory,\n  type IStorageFileResponse,\n  type IStorageSyncResponse,\n  type IStorageTreeItem\n} from '../../../packlets/storage';\n\nclass InMemoryProvider implements IHttpStorageProvider {\n  private readonly _files: Map<string, string> = new Map();\n\n  private _basename(path: string): string {\n    const parts = path.split('/');\n    return parts[parts.length - 1] ?? '';\n  }\n\n  public async getItem(path: string): Promise<Result<IStorageTreeItem>> {\n    if (this._files.has(path)) {\n      return succeed({ path, name: this._basename(path), type: 'file' as const });\n    }\n    return fail(`${path}: not found`);\n  }\n\n  public async getChildren(path: string): Promise<Result<ReadonlyArray<IStorageTreeItem>>> {\n    const children: IStorageTreeItem[] = [];\n    for (const filePath of this._files.keys()) {\n      if (filePath.startsWith(`${path}/`)) {\n        const name = filePath.substring(path.length + 1);\n        if (!name.includes('/')) {\n          children.push({ path: filePath, name, type: 'file' });\n        }\n      }\n    }\n    return succeed(children);\n  }\n\n  public async getFile(path: string): Promise<Result<IStorageFileResponse>> {\n    const contents = this._files.get(path);\n    if (contents === undefined) {\n      return fail(`${path}: not found`);\n    }\n    return succeed({ path, contents });\n  }\n\n  public async saveFile(path: string, contents: string): Promise<Result<IStorageFileResponse>> {\n    this._files.set(path, contents);\n    return succeed({ path, contents });\n  }\n\n  public async deleteFile(path: string): Promise<Result<boolean>> {\n    if (!this._files.has(path)) {\n      return fail(`${path}: not found`);\n    }\n    this._files.delete(path);\n    return succeed(true);\n  }\n\n  public async createDirectory(path: string): Promise<Result<IStorageTreeItem>> {\n    return succeed({ path, name: this._basename(path), type: 'directory' });\n  }\n\n  public async sync(): Promise<Result<IStorageSyncResponse>> {\n    return succeed({ synced: this._files.size });\n  }\n}\n\nclass TestProviderFactory implements IHttpStorageProviderFactory {\n  private readonly _provider: InMemoryProvider;\n\n  public constructor(provider: InMemoryProvider) {\n    this._provider = provider;\n  }\n\n  public forNamespace(): Result<IHttpStorageProvider> {\n    return succeed(this._provider);\n  }\n}\n\ndescribe('createStorageRoutes', () => {\n  test('writes then reads a file', async () => {\n    const provider = new InMemoryProvider();\n    const app = createStorageRoutes({ providers: new TestProviderFactory(provider) });\n\n    const putResponse = await app.request(\n      new Request('http://localhost/file', {\n        method: 'PUT',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ path: '/data/demo.txt', contents: 'hello' })\n      })\n    );\n    expect(putResponse.status).toBe(200);\n\n    const getResponse = await app.request(new Request('http://localhost/file?path=/data/demo.txt'));\n    expect(getResponse.status).toBe(200);\n    await expect(getResponse.json()).resolves.toEqual({ path: '/data/demo.txt', contents: 'hello' });\n  });\n\n  test('returns 400 for invalid put body', async () => {\n    const provider = new InMemoryProvider();\n    const app = createStorageRoutes({ providers: new TestProviderFactory(provider) });\n\n    const response = await app.request(\n      new Request('http://localhost/file', {\n        method: 'PUT',\n        headers: { 'Content-Type': 'application/json' },\n        body: '{ not-json'\n      })\n    );\n\n    expect(response.status).toBe(400);\n    const payload = (await response.json()) as { error?: string };\n    expect(payload.error).toContain('invalid JSON body');\n  });\n\n  test('returns sync payload from provider', async () => {\n    const provider = new InMemoryProvider();\n    const app = createStorageRoutes({ providers: new TestProviderFactory(provider) });\n\n    await app.request(\n      new Request('http://localhost/file', {\n        method: 'PUT',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ path: '/alpha.txt', contents: 'a' })\n      })\n    );\n\n    const response = await app.request(\n      new Request('http://localhost/sync', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({})\n      })\n    );\n\n    expect(response.status).toBe(200);\n    await expect(response.json()).resolves.toEqual({ synced: 1 });\n  });\n\n  test('deletes a file through DELETE /file', async () => {\n    const provider = new InMemoryProvider();\n    const app = createStorageRoutes({ providers: new TestProviderFactory(provider) });\n\n    await app.request(\n      new Request('http://localhost/file', {\n        method: 'PUT',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ path: '/data/remove-me.txt', contents: 'gone soon' })\n      })\n    );\n\n    const deleteResponse = await app.request(\n      new Request('http://localhost/file?path=/data/remove-me.txt', {\n        method: 'DELETE'\n      })\n    );\n    expect(deleteResponse.status).toBe(200);\n    await expect(deleteResponse.json()).resolves.toEqual({ deleted: true });\n\n    const getResponse = await app.request(new Request('http://localhost/file?path=/data/remove-me.txt'));\n    expect(getResponse.status).toBe(404);\n  });\n});\n"]}