@fgv/ts-http-storage 5.1.0-19 → 5.1.0-20

package/docs/interfaces/IStorageWriteFileRequest.contentType.md

@@ -1,9 +0,0 @@
-[Home](../README.md) > [IStorageWriteFileRequest](./IStorageWriteFileRequest.md) > contentType
-
-## IStorageWriteFileRequest.contentType property
-
-**Signature:**
-
-```typescript
-readonly contentType: string;
-```

package/docs/interfaces/IStorageWriteFileRequest.contents.md

@@ -1,9 +0,0 @@
-[Home](../README.md) > [IStorageWriteFileRequest](./IStorageWriteFileRequest.md) > contents
-
-## IStorageWriteFileRequest.contents property
-
-**Signature:**
-
-```typescript
-readonly contents: string;
-```

package/docs/interfaces/IStorageWriteFileRequest.md

@@ -1,97 +0,0 @@
-[Home](../README.md) > IStorageWriteFileRequest
-
-# Interface: IStorageWriteFileRequest
-
-Request for writing file contents.
-
-**Extends:** [`IStoragePathRequest`](IStoragePathRequest.md)
-
-## Properties
-
-<table><thead><tr><th>
-
-Property
-
-</th><th>
-
-Modifiers
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody>
-<tr><td>
-
-[contents](./IStorageWriteFileRequest.contents.md)
-
-</td><td>
-
-`readonly`
-
-</td><td>
-
-string
-
-</td><td>
-
-
-
-</td></tr>
-<tr><td>
-
-[contentType](./IStorageWriteFileRequest.contentType.md)
-
-</td><td>
-
-`readonly`
-
-</td><td>
-
-string
-
-</td><td>
-
-
-
-</td></tr>
-<tr><td>
-
-[path](./IStoragePathRequest.path.md)
-
-</td><td>
-
-`readonly`
-
-</td><td>
-
-string
-
-</td><td>
-
-
-
-</td></tr>
-<tr><td>
-
-[namespace](./IStoragePathRequest.namespace.md)
-
-</td><td>
-
-`readonly`
-
-</td><td>
-
-string
-
-</td><td>
-
-
-
-</td></tr>
-</tbody></table>

package/docs/type-aliases/StorageItemType.md

@@ -1,11 +0,0 @@
-[Home](../README.md) > StorageItemType
-
-# Type Alias: StorageItemType
-
-Storage item type.
-
-## Type
-
-```typescript
-type StorageItemType = "file" | "directory"
-```

package/docs/type-aliases/StorageNamespace.md

@@ -1,11 +0,0 @@
-[Home](../README.md) > StorageNamespace
-
-# Type Alias: StorageNamespace
-
-Namespace identifier for scoped storage.
-
-## Type
-
-```typescript
-type StorageNamespace = string
-```

package/docs/variables/storageFileResponse.md

@@ -1,9 +0,0 @@
-[Home](../README.md) > storageFileResponse
-
-# Variable: storageFileResponse
-
-Converter for file responses.
-
-## Type
-
-`Converter<IStorageFileResponse>`

package/docs/variables/storagePathRequest.md

@@ -1,9 +0,0 @@
-[Home](../README.md) > storagePathRequest
-
-# Variable: storagePathRequest
-
-Converter for path-based requests.
-
-## Type
-
-`Converter<IStoragePathRequest>`

package/docs/variables/storageSyncRequest.md

@@ -1,9 +0,0 @@
-[Home](../README.md) > storageSyncRequest
-
-# Variable: storageSyncRequest
-
-Converter for sync requests.
-
-## Type
-
-`Converter<IStorageSyncRequest>`

package/docs/variables/storageTreeChildrenResponse.md

@@ -1,9 +0,0 @@
-[Home](../README.md) > storageTreeChildrenResponse
-
-# Variable: storageTreeChildrenResponse
-
-Converter for children list responses.
-
-## Type
-
-`Converter<IStorageTreeChildrenResponse>`

package/docs/variables/storageTreeItem.md

@@ -1,9 +0,0 @@
-[Home](../README.md) > storageTreeItem
-
-# Variable: storageTreeItem
-
-Converter for IStorageTreeItem.
-
-## Type
-
-`Converter<IStorageTreeItem>`

package/docs/variables/storageWriteFileRequest.md

@@ -1,9 +0,0 @@
-[Home](../README.md) > storageWriteFileRequest
-
-# Variable: storageWriteFileRequest
-
-Converter for write-file requests.
-
-## Type
-
-`Converter<IStorageWriteFileRequest>`

package/etc/ts-http-storage.api.md

@@ -1,184 +0,0 @@
-## API Report File for "@fgv/ts-http-storage"
-
-> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
-
-```ts
-
-import { Converter } from '@fgv/ts-utils';
-import { Hono } from 'hono';
-import type { Logging } from '@fgv/ts-utils';
-import { Result } from '@fgv/ts-utils';
-
-// @public
-export function createStorageRoutes(options: ICreateStorageRoutesOptions): Hono;
-
-// @public
-export class FsStorageProvider implements IHttpStorageProvider {
-    constructor(rootPath: string);
-    // (undocumented)
-    createDirectory(itemPath: string): Promise<Result<IStorageTreeItem>>;
-    // (undocumented)
-    deleteFile(itemPath: string): Promise<Result<boolean>>;
-    // (undocumented)
-    getChildren(itemPath: string): Promise<Result<ReadonlyArray<IStorageTreeItem>>>;
-    // (undocumented)
-    getFile(itemPath: string): Promise<Result<IStorageFileResponse>>;
-    // (undocumented)
-    getItem(itemPath: string): Promise<Result<IStorageTreeItem>>;
-    // (undocumented)
-    saveFile(itemPath: string, contents: string, contentType?: string): Promise<Result<IStorageFileResponse>>;
-    // (undocumented)
-    sync(): Promise<Result<IStorageSyncResponse>>;
-}
-
-// @public
-export class FsStorageProviderFactory implements IHttpStorageProviderFactory {
-    constructor(options: IFsStorageProviderFactoryOptions);
-    // (undocumented)
-    forNamespace(namespace?: string): Result<IHttpStorageProvider>;
-}
-
-// @public
-export class HttpStorageService {
-    constructor(providers: IHttpStorageProviderFactory);
-    // (undocumented)
-    createDirectory(request: IStoragePathRequest): Promise<Result<IStorageTreeItem>>;
-    // (undocumented)
-    deleteFile(request: IStoragePathRequest): Promise<Result<boolean>>;
-    // (undocumented)
-    getChildren(request: IStoragePathRequest): Promise<Result<IStorageTreeChildrenResponse>>;
-    // (undocumented)
-    getFile(request: IStoragePathRequest): Promise<Result<IStorageFileResponse>>;
-    // (undocumented)
-    getItem(request: IStoragePathRequest): Promise<Result<IStorageTreeItem>>;
-    // (undocumented)
-    saveFile(request: IStorageWriteFileRequest): Promise<Result<IStorageFileResponse>>;
-    // (undocumented)
-    sync(request: IStorageSyncRequest): Promise<Result<IStorageSyncResponse>>;
-}
-
-// @public
-export interface ICreateStorageRoutesOptions {
-    // (undocumented)
-    readonly logger?: Logging.ILogger;
-    // (undocumented)
-    readonly providers: IHttpStorageProviderFactory;
-}
-
-// @public
-export interface IFsStorageProviderFactoryOptions {
-    // (undocumented)
-    readonly rootPath: string;
-}
-
-// @public
-export interface IHttpStorageProvider {
-    // (undocumented)
-    createDirectory(path: string): Promise<Result<IStorageTreeItem>>;
-    // (undocumented)
-    deleteFile(path: string): Promise<Result<boolean>>;
-    // (undocumented)
-    getChildren(path: string): Promise<Result<ReadonlyArray<IStorageTreeItem>>>;
-    // (undocumented)
-    getFile(path: string): Promise<Result<IStorageFileResponse>>;
-    // (undocumented)
-    getItem(path: string): Promise<Result<IStorageTreeItem>>;
-    // (undocumented)
-    saveFile(path: string, contents: string, contentType?: string): Promise<Result<IStorageFileResponse>>;
-    // (undocumented)
-    sync(): Promise<Result<IStorageSyncResponse>>;
-}
-
-// @public
-export interface IHttpStorageProviderFactory {
-    // (undocumented)
-    forNamespace(namespace?: StorageNamespace): Result<IHttpStorageProvider>;
-}
-
-// @public
-export interface IStorageFileResponse {
-    // (undocumented)
-    readonly contents: string;
-    // (undocumented)
-    readonly contentType?: string;
-    // (undocumented)
-    readonly path: string;
-}
-
-// @public
-export interface IStoragePathRequest {
-    // (undocumented)
-    readonly namespace?: StorageNamespace;
-    // (undocumented)
-    readonly path: string;
-}
-
-// @public
-export interface IStorageSyncRequest {
-    // (undocumented)
-    readonly namespace?: StorageNamespace;
-}
-
-// @public
-export interface IStorageSyncResponse {
-    // (undocumented)
-    readonly synced: number;
-}
-
-// @public
-export interface IStorageTreeChildrenResponse {
-    // (undocumented)
-    readonly children: ReadonlyArray<IStorageTreeItem>;
-    // (undocumented)
-    readonly path: string;
-}
-
-// @public
-export interface IStorageTreeItem {
-    // (undocumented)
-    readonly name: string;
-    // (undocumented)
-    readonly path: string;
-    // (undocumented)
-    readonly type: StorageItemType;
-}
-
-// @public
-export interface IStorageWriteFileRequest extends IStoragePathRequest {
-    // (undocumented)
-    readonly contents: string;
-    // (undocumented)
-    readonly contentType?: string;
-}
-
-// @public
-export function normalizeRequestPath(requestPath: string): string;
-
-// @public
-export function sanitizeNamespace(namespace?: string): Result<string>;
-
-// @public
-export const storageFileResponse: Converter<IStorageFileResponse>;
-
-// @public
-export type StorageItemType = 'file' | 'directory';
-
-// @public
-export type StorageNamespace = string;
-
-// @public
-export const storagePathRequest: Converter<IStoragePathRequest>;
-
-// @public
-export const storageSyncRequest: Converter<IStorageSyncRequest>;
-
-// @public
-export const storageTreeChildrenResponse: Converter<IStorageTreeChildrenResponse>;
-
-// @public
-export const storageTreeItem: Converter<IStorageTreeItem>;
-
-// @public
-export const storageWriteFileRequest: Converter<IStorageWriteFileRequest>;
-
-```

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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,106 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,124 +0,0 @@
-"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