@fgv/ts-http-storage 5.1.0-5 → 5.1.0-50

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

@@ -1 +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"]}
+{"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  storageReadFileRequest,\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 requestedEncoding = c.req.query('encoding');\n    const parsed = storageReadFileRequest.convert({\n      ...parsePathQuery(c.req.query('path'), c.req.query('namespace')),\n      // Absent leaves `encoding` off the request entirely, so the converter's\n      // optional field stays absent rather than becoming an explicit undefined.\n      ...(requestedEncoding !== undefined ? { encoding: requestedEncoding } : {})\n    });\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

@@ -1,5 +1,5 @@
 import { type Result } from '@fgv/ts-utils';
-import type { IStorageFileResponse, IStoragePathRequest, IStorageSyncRequest, IStorageSyncResponse, IStorageTreeChildrenResponse, IStorageTreeItem, IStorageWriteFileRequest } from './model';
+import type { IStorageFileResponse, IStoragePathRequest, IStorageReadFileRequest, IStorageSyncRequest, IStorageSyncResponse, IStorageTreeChildrenResponse, IStorageTreeItem, IStorageWriteFileRequest } from './model';
 import type { IHttpStorageProviderFactory } from './provider';
 /**
  * Service layer for storage API operations.
@@ -10,7 +10,7 @@ export declare class HttpStorageService {
     constructor(providers: IHttpStorageProviderFactory);
     getItem(request: IStoragePathRequest): Promise<Result<IStorageTreeItem>>;
     getChildren(request: IStoragePathRequest): Promise<Result<IStorageTreeChildrenResponse>>;
-    getFile(request: IStoragePathRequest): Promise<Result<IStorageFileResponse>>;
+    getFile(request: IStorageReadFileRequest): Promise<Result<IStorageFileResponse>>;
     saveFile(request: IStorageWriteFileRequest): Promise<Result<IStorageFileResponse>>;
     deleteFile(request: IStoragePathRequest): Promise<Result<boolean>>;
     createDirectory(request: IStoragePathRequest): Promise<Result<IStorageTreeItem>>;

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

@@ -1 +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"}
+{"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,uBAAuB,EACvB,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,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAQhF,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

@@ -57,7 +57,7 @@ class HttpStorageService {
         if (providerResult.isFailure()) {
             return (0, ts_utils_1.fail)(providerResult.message);
         }
-        return providerResult.value.getFile(request.path);
+        return providerResult.value.getFile(request.path, request.encoding);
     }
     async saveFile(request) {
         const providerResult = this._getProvider(request.namespace);

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

@@ -1 +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"]}
+{"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  IStorageReadFileRequest,\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: IStorageReadFileRequest): 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, request.encoding);\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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-http-storage",
-  "version": "5.1.0-5",
+  "version": "5.1.0-50",
   "description": "Reusable HTTP storage services for FileTree-style backends",
   "main": "lib/index.js",
   "types": "dist/ts-http-storage.d.ts",
@@ -26,7 +26,7 @@
   },
   "dependencies": {
     "hono": "~4.7.11",
-    "@fgv/ts-utils": "5.1.0-5"
+    "@fgv/ts-utils": "5.1.0-50"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.28.2",
@@ -47,9 +47,9 @@
     "typedoc": "~0.28.16",
     "typedoc-plugin-markdown": "~4.9.0",
     "@rushstack/heft-jest-plugin": "1.2.6",
-    "@fgv/ts-utils-jest": "5.1.0-5",
-    "@fgv/heft-dual-rig": "5.1.0-5",
-    "@fgv/typedoc-compact-theme": "5.1.0-5"
+    "@fgv/ts-utils-jest": "5.1.0-50",
+    "@fgv/heft-dual-rig": "5.1.0-50",
+    "@fgv/typedoc-compact-theme": "5.1.0-50"
   },
   "scripts": {
     "build": "heft build --clean",

package/.rush/temp/4f4782db16a13ce96c2b268916d3e8a461b96fcf.tar.log

@@ -1,61 +0,0 @@
-Start time: Thu Mar 26 2026 23:16:04 GMT+0000 (Coordinated Universal Time)
-Invoking "/usr/bin/tar -c -f /home/runner/work/fgv/fgv/common/temp/build-cache/4f4782db16a13ce96c2b268916d3e8a461b96fcf-7741f7dd2e1086e4.temp -z --files-from=-"
-
-======= BEGIN PROCESS INPUT ======
-.rush/temp/operation/build/all.log
-.rush/temp/operation/build/log-chunks.jsonl
-.rush/temp/operation/build/state.json
-dist/ts-http-storage.d.ts
-dist/tsdoc-metadata.json
-lib/index.d.ts
-lib/index.d.ts.map
-lib/index.js
-lib/index.js.map
-lib/packlets/storage/converters.d.ts
-lib/packlets/storage/converters.d.ts.map
-lib/packlets/storage/converters.js
-lib/packlets/storage/converters.js.map
-lib/packlets/storage/fsProvider.d.ts
-lib/packlets/storage/fsProvider.d.ts.map
-lib/packlets/storage/fsProvider.js
-lib/packlets/storage/fsProvider.js.map
-lib/packlets/storage/index.d.ts
-lib/packlets/storage/index.d.ts.map
-lib/packlets/storage/index.js
-lib/packlets/storage/index.js.map
-lib/packlets/storage/model.d.ts
-lib/packlets/storage/model.d.ts.map
-lib/packlets/storage/model.js
-lib/packlets/storage/model.js.map
-lib/packlets/storage/provider.d.ts
-lib/packlets/storage/provider.d.ts.map
-lib/packlets/storage/provider.js
-lib/packlets/storage/provider.js.map
-lib/packlets/storage/routes.d.ts
-lib/packlets/storage/routes.d.ts.map
-lib/packlets/storage/routes.js
-lib/packlets/storage/routes.js.map
-lib/packlets/storage/service.d.ts
-lib/packlets/storage/service.d.ts.map
-lib/packlets/storage/service.js
-lib/packlets/storage/service.js.map
-lib/test/unit/storage/fsProvider.test.d.ts
-lib/test/unit/storage/fsProvider.test.d.ts.map
-lib/test/unit/storage/fsProvider.test.js
-lib/test/unit/storage/fsProvider.test.js.map
-lib/test/unit/storage/routes.test.d.ts
-lib/test/unit/storage/routes.test.d.ts.map
-lib/test/unit/storage/routes.test.js
-lib/test/unit/storage/routes.test.js.map
-lib/test/unit/storage/service.test.d.ts
-lib/test/unit/storage/service.test.d.ts.map
-lib/test/unit/storage/service.test.js
-lib/test/unit/storage/service.test.js.map
-temp/build/typescript/ts_l9Fw4VUO.json
-temp/ts-http-storage.api.json
-temp/ts-http-storage.api.md
-======== END PROCESS INPUT =======
-======= BEGIN PROCESS OUTPUT =======
-======== END PROCESS OUTPUT ========
-
-Exited with code "0"

package/.rush/temp/chunked-rush-logs/ts-http-storage.build.chunks.jsonl

@@ -1,9 +0,0 @@
-{"kind":"O","text":"Invoking: heft build --clean \n"}
-{"kind":"O","text":" ---- build started ---- \n"}
-{"kind":"O","text":"[build:typescript] The TypeScript compiler version 5.9.3 is newer than the latest version that was tested with Heft (5.8); it may not work correctly.\n"}
-{"kind":"O","text":"[build:typescript] Using TypeScript version 5.9.3\n"}
-{"kind":"O","text":"[build:api-extractor] Using API Extractor version 7.57.7\n"}
-{"kind":"O","text":"[build:api-extractor] Analysis will use the bundled TypeScript version 5.8.2\n"}
-{"kind":"O","text":"[build:api-extractor] *** The target project appears to use TypeScript 5.9.3 which is newer than the bundled compiler engine; consider upgrading API Extractor.\n"}
-{"kind":"O","text":" ---- build finished (12.564s) ---- \n"}
-{"kind":"O","text":"-------------------- Finished (12.569s) --------------------\n"}

package/.rush/temp/operation/build/all.log

@@ -1,9 +0,0 @@
-Invoking: heft build --clean 
- ---- build started ---- 
-[build:typescript] The TypeScript compiler version 5.9.3 is newer than the latest version that was tested with Heft (5.8); it may not work correctly.
-[build:typescript] Using TypeScript version 5.9.3
-[build:api-extractor] Using API Extractor version 7.57.7
-[build:api-extractor] Analysis will use the bundled TypeScript version 5.8.2
-[build:api-extractor] *** The target project appears to use TypeScript 5.9.3 which is newer than the bundled compiler engine; consider upgrading API Extractor.
- ---- build finished (12.564s) ---- 
--------------------- Finished (12.569s) --------------------

package/.rush/temp/operation/build/log-chunks.jsonl

@@ -1,9 +0,0 @@
-{"kind":"O","text":"Invoking: heft build --clean \n"}
-{"kind":"O","text":" ---- build started ---- \n"}
-{"kind":"O","text":"[build:typescript] The TypeScript compiler version 5.9.3 is newer than the latest version that was tested with Heft (5.8); it may not work correctly.\n"}
-{"kind":"O","text":"[build:typescript] Using TypeScript version 5.9.3\n"}
-{"kind":"O","text":"[build:api-extractor] Using API Extractor version 7.57.7\n"}
-{"kind":"O","text":"[build:api-extractor] Analysis will use the bundled TypeScript version 5.8.2\n"}
-{"kind":"O","text":"[build:api-extractor] *** The target project appears to use TypeScript 5.9.3 which is newer than the bundled compiler engine; consider upgrading API Extractor.\n"}
-{"kind":"O","text":" ---- build finished (12.564s) ---- \n"}
-{"kind":"O","text":"-------------------- Finished (12.569s) --------------------\n"}

package/.rush/temp/operation/build/state.json

@@ -1,3 +0,0 @@
-{
-  "nonCachedDurationMs": 13084.659738000002
-}