@milaboratories/pframes-rs-serv 1.0.61 → 1.0.64

package/dist/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sources":["../src/handler.ts"],"sourcesContent":["import type {\n  IncomingMessage,\n  RequestListener,\n  ServerResponse\n} from 'node:http';\nimport { pipeline } from 'node:stream/promises';\nimport { timingSafeEqual } from 'node:crypto';\nimport type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';\nimport {\n  createETag,\n  getFilenameFromUrl,\n  parseRange,\n  isGetOrHead,\n  isHead,\n  Options,\n  StatusCode,\n  HeaderName,\n  HeaderValue,\n  isGet\n} from './utils';\n\n/** Main request handler for parquet files */\nasync function handleRequest(\n  request: IncomingMessage,\n  response: ServerResponse,\n  store: PFrameInternal.ObjectStore\n): Promise<void> {\n  // RFC 9110 section 6.6.1: Date header should be present in all responses\n  response.sendDate = true;\n  // RFC 9110 section 8.6: Content-Length 0 as default for error responses\n  response.strictContentLength = true;\n  response.setHeader(HeaderName.ContentLength, 0);\n  // Note: setting Content-Length disables Node.js default Transfer-Encoding: chunked\n\n  // RFC 9111 section 5.2: Cache-Control header with public allows to cache authenticated responses\n  response.setHeader(HeaderName.CacheControl, HeaderValue.CacheControl);\n\n  // RFC 9110 section 15.5.6: Method not allowed\n  const method = request.method;\n  if (!isGetOrHead(method)) {\n    response.setHeader(HeaderName.Allow, HeaderValue.Allow);\n    return void response.writeHead(StatusCode.MethodNotAllowed).end();\n  }\n\n  const filename = getFilenameFromUrl(request);\n  if (filename === null) {\n    return void response.writeHead(StatusCode.Gone).end();\n  }\n\n  // From now on we are sure that the response would be a Parquet file\n  response.setHeader(HeaderName.AcceptRanges, HeaderValue.AcceptRanges);\n  response.setHeader(HeaderName.ContentType, HeaderValue.ContentType);\n\n  // RFC 9110 section 8.8.3: ETag header is used for cache versioning\n  const etag = createETag(filename);\n  // RFC 9110 section 8.8.2: Last-Modified header field for cache validation\n  const mtime = new Date(0); // Using fake fixed date since files are immutable\n  // RFC 9111 section 5.2: Cache-Control header with public allows to cache authenticated responses\n  response.setHeader(HeaderName.CacheControl, HeaderValue.CacheControl);\n  response.setHeader(HeaderName.ETag, etag);\n  response.setHeader(HeaderName.LastModified, mtime.toUTCString());\n\n  const options = new Options(request);\n  // RFC 9110 section 13.1.1: If-Match precondition evaluation\n  // RFC 9110 section 13.1.4: If-Unmodified-Since precondition evaluation\n  if (options.preconditionFailed(etag, mtime)) {\n    return void response.writeHead(StatusCode.PreconditionFailed).end();\n  }\n  // RFC 9110 section 13.1.2: If-None-Match precondition evaluation\n  // RFC 9110 section 13.1.3: If-Modified-Since precondition evaluation\n  else if (options.notModified(etag, mtime)) {\n    return void response.writeHead(StatusCode.NotModified).end();\n  }\n\n  const range = parseRange(request);\n  if (range === null) {\n    return void response.writeHead(StatusCode.BadRequest).end();\n  }\n\n  const abortController = new AbortController();\n  request.on('close', () => abortController.abort());\n  const signal = abortController.signal;\n\n  store.request(filename, {\n    method: 'GET',\n    range,\n    signal,\n    // pipeline automatically destroys the streams if they were not gracefully closed\n    callback: async (result) => {\n      if (response.destroyed) return void response.destroy();\n\n      switch (result.type) {\n        case 'InternalError':\n          // object store encountered network error, retry by client can help\n          return void response.writeHead(StatusCode.InternalServerError).end();\n        case 'NotFound':\n          // RFC 9110 section 15.4.5: Not found\n          return void response.writeHead(StatusCode.NotFound).end();\n        case 'RangeNotSatisfiable':\n          // RFC 9110 section 15.5.17: Range not satisfiable\n          response.setHeader(HeaderName.ContentRange, `bytes */${result.size}`);\n          return void response.writeHead(StatusCode.RangeNotSatisfiable).end();\n        case 'Ok':\n          break;\n      }\n\n      if (isGet(method) && !result.data) {\n        // object store implementation is incorrect, retry by client cannot help\n        return void response.writeHead(StatusCode.GatewayTimeout).end();\n      }\n\n      if (range) {\n        // RFC 9110 section 14.4: Partial content response\n        response.setHeader(\n          HeaderName.ContentLength,\n          result.range.end - result.range.start + 1\n        );\n        response.setHeader(\n          HeaderName.ContentRange,\n          `bytes ${result.range.start}-${result.range.end}/${result.size}`\n        );\n        response.writeHead(StatusCode.PartialContent);\n      } else {\n        // RFC 9110 section 15.3.1: OK response\n        response.setHeader(HeaderName.ContentLength, result.size);\n        response.writeHead(StatusCode.Ok);\n      }\n\n      // RFC 9110 section 9.3.2: HEAD method must not return message body\n      if (isHead(method)) {\n        return void response.end();\n      }\n\n      return await pipeline(result.data!, response, { signal }).catch(() => {\n        // Pipeline errors are expected when request is aborted or connection is lost\n        // Response head was already written, so we can't change status code\n        // Just mute the error - pipeline destroys the response stream\n      });\n    }\n  });\n}\n\n/**\n * Create a request handler for serving files from an object store\n * compatible with HTTP/1.1 as defined in RFC 9110 and RFC 9111:\n * - <https://datatracker.ietf.org/doc/html/rfc9110>\n * - <https://datatracker.ietf.org/doc/html/rfc9111>\n *\n * Accepts only paths of the form `/<filename>.parquet`, returns 404 otherwise\n * Assumes that files are immutable (and sets cache headers accordingly)\n */\nexport function createRequestHandler(\n  options: PFrameInternal.RequestHandlerOptions\n): RequestListener {\n  const { store } = options;\n  return (request, response) => void handleRequest(request, response, store);\n}\n\n/** Request authorization middleware */\nfunction authorizeRequest(\n  request: IncomingMessage,\n  response: ServerResponse,\n  handler: RequestListener,\n  authHeader: string\n): void {\n  // RFC 9110 section 6.6.1: Date header should be present in all responses\n  response.sendDate = true;\n  // RFC 9110 section 8.6: Content-Length 0 as default for error responses\n  response.strictContentLength = true;\n  response.setHeader(HeaderName.ContentLength, 0);\n  // Note: setting Content-Length disables Node.js default Transfer-Encoding: chunked\n\n  const actualHeader = request.headers['authorization'];\n\n  // Early length check to avoid unnecessary processing\n  if (!actualHeader || actualHeader.length !== authHeader.length) {\n    // RFC 9110 section 11.6.1: WWW-Authenticate header field\n    response.setHeader(HeaderName.WWWAuthenticate, HeaderValue.WWWAuthenticate);\n    return void response.writeHead(StatusCode.Unauthorized).end();\n  }\n\n  // Use timing-safe comparison to prevent timing attacks\n  // <https://developers.cloudflare.com/workers/examples/protect-against-timing-attacks/>\n  const encoder = new TextEncoder();\n  const receivedBuffer = encoder.encode(actualHeader);\n  const expectedBuffer = encoder.encode(authHeader);\n\n  if (\n    receivedBuffer.byteLength !== expectedBuffer.byteLength ||\n    !timingSafeEqual(receivedBuffer, expectedBuffer)\n  ) {\n    response.setHeader(HeaderName.WWWAuthenticate, HeaderValue.WWWAuthenticate);\n    return void response.writeHead(StatusCode.Unauthorized).end();\n  }\n\n  return handler(request, response);\n}\n\n/** Apply Bearer token authorization to @param handler */\nexport function authorizeRequestHandler(\n  handler: RequestListener,\n  authToken: PFrameInternal.HttpAuthorizationToken\n): RequestListener {\n  const authHeader = `Bearer ${authToken}`;\n  return (request, response) =>\n    authorizeRequest(request, response, handler, authHeader);\n}\n"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+var handler = require('./handler.cjs');
+var fsStore = require('./fs-store.cjs');
+var serve = require('./serve.cjs');
+var _export = require('./export.cjs');
+var parquetServer = require('./parquet-server.cjs');
+
+
+
+exports.authorizeRequestHandler = handler.authorizeRequestHandler;
+exports.createRequestHandler = handler.createRequestHandler;
+exports.FileSystemStore = fsStore.FileSystemStore;
+exports.serve = serve.serve;
+exports.HttpHelpers = _export.HttpHelpers;
+exports.runParquetServer = parquetServer.runParquetServer;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './handler';
+export * from './fs-store';
+export * from './serve';
+export * from './export';
+export * from './parquet-server';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { authorizeRequestHandler, createRequestHandler } from './handler.js';
+export { FileSystemStore } from './fs-store.js';
+export { serve } from './serve.js';
+export { HttpHelpers } from './export.js';
+export { runParquetServer } from './parquet-server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/parquet-server.cjs

@@ -0,0 +1,53 @@
+'use strict';
+
+var commander = require('commander');
+var fsStore = require('./fs-store.cjs');
+var handler = require('./handler.cjs');
+var serve = require('./serve.cjs');
+
+/**
+ * Serves parquet files from the given root directory.
+ * Manages the server lifecycle with graceful shutdown.
+ */
+async function runParquetServer() {
+    const program = new commander.Command();
+    program
+        .name('parquet-server')
+        .description('Serve parquet files from a directory over HTTP(S)')
+        .argument('<root-directory>', 'Root directory containing parquet files')
+        .option('--http', 'Use HTTP instead of HTTPS', false)
+        .option('--no-auth', 'Disable authentication')
+        .action(async (rootDir, options) => {
+        const abortController = new AbortController();
+        process
+            .on('SIGINT', () => abortController.abort())
+            .on('SIGTERM', () => abortController.abort());
+        abortController.signal.throwIfAborted();
+        const store = await fsStore.FileSystemStore.init({
+            rootDir,
+            logger: (level, message) => {
+                const timestamp = new Date(Date.now()).toISOString();
+                console.log(`[${timestamp}] [${level}] ${message}`);
+            }
+        });
+        abortController.signal.throwIfAborted();
+        const handler$1 = handler.createRequestHandler({ store });
+        const server = await serve.serve({
+            handler: handler$1,
+            ...(options.http && { http: true }),
+            ...(!options.auth && { noAuth: true })
+        });
+        abortController.signal.onabort = () => server.stop();
+        abortController.signal.throwIfAborted();
+        console.log(JSON.stringify({
+            url: server.address,
+            ...(server.authToken && { authToken: server.authToken }),
+            ...(server.encodedCaCert && { caCert: server.encodedCaCert })
+        }));
+        await server.stopped;
+    });
+    await program.parseAsync();
+}
+
+exports.runParquetServer = runParquetServer;
+//# sourceMappingURL=parquet-server.cjs.map

package/dist/parquet-server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parquet-server.cjs","sources":["../src/parquet-server.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { FileSystemStore } from './fs-store';\nimport { createRequestHandler } from './handler';\nimport { serve } from './serve';\n\n/**\n * Serves parquet files from the given root directory.\n * Manages the server lifecycle with graceful shutdown.\n */\nexport async function runParquetServer(): Promise<void> {\n  const program = new Command();\n\n  program\n    .name('parquet-server')\n    .description('Serve parquet files from a directory over HTTP(S)')\n    .argument('<root-directory>', 'Root directory containing parquet files')\n    .option('--http', 'Use HTTP instead of HTTPS', false)\n    .option('--no-auth', 'Disable authentication')\n    .action(\n      async (rootDir: string, options: { http: boolean; auth: boolean }) => {\n        const abortController = new AbortController();\n        process\n          .on('SIGINT', () => abortController.abort())\n          .on('SIGTERM', () => abortController.abort());\n        abortController.signal.throwIfAborted();\n\n        const store = await FileSystemStore.init({\n          rootDir,\n          logger: (level, message) => {\n            const timestamp = new Date(Date.now()).toISOString();\n            console.log(`[${timestamp}] [${level}] ${message}`);\n          }\n        });\n        abortController.signal.throwIfAborted();\n        const handler = createRequestHandler({ store });\n\n        const server = await serve({\n          handler,\n          ...(options.http && { http: true }),\n          ...(!options.auth && { noAuth: true })\n        });\n        abortController.signal.onabort = () => server.stop();\n        abortController.signal.throwIfAborted();\n\n        console.log(\n          JSON.stringify({\n            url: server.address,\n            ...(server.authToken && { authToken: server.authToken }),\n            ...(server.encodedCaCert && { caCert: server.encodedCaCert })\n          })\n        );\n\n        await server.stopped;\n      }\n    );\n\n  await program.parseAsync();\n}\n"],"names":["Command","FileSystemStore","handler","createRequestHandler","serve"],"mappings":";;;;;;;AAKA;;;AAGG;AACI,eAAe,gBAAgB,GAAA;AACpC,IAAA,MAAM,OAAO,GAAG,IAAIA,iBAAO,EAAE;IAE7B;SACG,IAAI,CAAC,gBAAgB;SACrB,WAAW,CAAC,mDAAmD;AAC/D,SAAA,QAAQ,CAAC,kBAAkB,EAAE,yCAAyC;AACtE,SAAA,MAAM,CAAC,QAAQ,EAAE,2BAA2B,EAAE,KAAK;AACnD,SAAA,MAAM,CAAC,WAAW,EAAE,wBAAwB;AAC5C,SAAA,MAAM,CACL,OAAO,OAAe,EAAE,OAAyC,KAAI;AACnE,QAAA,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE;QAC7C;aACG,EAAE,CAAC,QAAQ,EAAE,MAAM,eAAe,CAAC,KAAK,EAAE;aAC1C,EAAE,CAAC,SAAS,EAAE,MAAM,eAAe,CAAC,KAAK,EAAE,CAAC;AAC/C,QAAA,eAAe,CAAC,MAAM,CAAC,cAAc,EAAE;AAEvC,QAAA,MAAM,KAAK,GAAG,MAAMC,uBAAe,CAAC,IAAI,CAAC;YACvC,OAAO;AACP,YAAA,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAI;AACzB,gBAAA,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;gBACpD,OAAO,CAAC,GAAG,CAAC,CAAA,CAAA,EAAI,SAAS,CAAA,GAAA,EAAM,KAAK,CAAA,EAAA,EAAK,OAAO,CAAA,CAAE,CAAC;YACrD;AACD,SAAA,CAAC;AACF,QAAA,eAAe,CAAC,MAAM,CAAC,cAAc,EAAE;QACvC,MAAMC,SAAO,GAAGC,4BAAoB,CAAC,EAAE,KAAK,EAAE,CAAC;AAE/C,QAAA,MAAM,MAAM,GAAG,MAAMC,WAAK,CAAC;qBACzBF,SAAO;YACP,IAAI,OAAO,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;AACtC,SAAA,CAAC;AACF,QAAA,eAAe,CAAC,MAAM,CAAC,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE;AACpD,QAAA,eAAe,CAAC,MAAM,CAAC,cAAc,EAAE;AAEvC,QAAA,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CAAC;YACb,GAAG,EAAE,MAAM,CAAC,OAAO;AACnB,YAAA,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;AACxD,YAAA,IAAI,MAAM,CAAC,aAAa,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE;AAC7D,SAAA,CAAC,CACH;QAED,MAAM,MAAM,CAAC,OAAO;AACtB,IAAA,CAAC,CACF;AAEH,IAAA,MAAM,OAAO,CAAC,UAAU,EAAE;AAC5B;;;;"}

package/dist/parquet-server.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Serves parquet files from the given root directory.
+ * Manages the server lifecycle with graceful shutdown.
+ */
+export declare function runParquetServer(): Promise<void>;
+//# sourceMappingURL=parquet-server.d.ts.map

package/dist/parquet-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parquet-server.d.ts","sourceRoot":"","sources":["../src/parquet-server.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgDtD"}

package/dist/parquet-server.js

@@ -0,0 +1,51 @@
+import { Command } from 'commander';
+import { FileSystemStore } from './fs-store.js';
+import { createRequestHandler } from './handler.js';
+import { serve } from './serve.js';
+
+/**
+ * Serves parquet files from the given root directory.
+ * Manages the server lifecycle with graceful shutdown.
+ */
+async function runParquetServer() {
+    const program = new Command();
+    program
+        .name('parquet-server')
+        .description('Serve parquet files from a directory over HTTP(S)')
+        .argument('<root-directory>', 'Root directory containing parquet files')
+        .option('--http', 'Use HTTP instead of HTTPS', false)
+        .option('--no-auth', 'Disable authentication')
+        .action(async (rootDir, options) => {
+        const abortController = new AbortController();
+        process
+            .on('SIGINT', () => abortController.abort())
+            .on('SIGTERM', () => abortController.abort());
+        abortController.signal.throwIfAborted();
+        const store = await FileSystemStore.init({
+            rootDir,
+            logger: (level, message) => {
+                const timestamp = new Date(Date.now()).toISOString();
+                console.log(`[${timestamp}] [${level}] ${message}`);
+            }
+        });
+        abortController.signal.throwIfAborted();
+        const handler = createRequestHandler({ store });
+        const server = await serve({
+            handler,
+            ...(options.http && { http: true }),
+            ...(!options.auth && { noAuth: true })
+        });
+        abortController.signal.onabort = () => server.stop();
+        abortController.signal.throwIfAborted();
+        console.log(JSON.stringify({
+            url: server.address,
+            ...(server.authToken && { authToken: server.authToken }),
+            ...(server.encodedCaCert && { caCert: server.encodedCaCert })
+        }));
+        await server.stopped;
+    });
+    await program.parseAsync();
+}
+
+export { runParquetServer };
+//# sourceMappingURL=parquet-server.js.map

package/dist/parquet-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parquet-server.js","sources":["../src/parquet-server.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { FileSystemStore } from './fs-store';\nimport { createRequestHandler } from './handler';\nimport { serve } from './serve';\n\n/**\n * Serves parquet files from the given root directory.\n * Manages the server lifecycle with graceful shutdown.\n */\nexport async function runParquetServer(): Promise<void> {\n  const program = new Command();\n\n  program\n    .name('parquet-server')\n    .description('Serve parquet files from a directory over HTTP(S)')\n    .argument('<root-directory>', 'Root directory containing parquet files')\n    .option('--http', 'Use HTTP instead of HTTPS', false)\n    .option('--no-auth', 'Disable authentication')\n    .action(\n      async (rootDir: string, options: { http: boolean; auth: boolean }) => {\n        const abortController = new AbortController();\n        process\n          .on('SIGINT', () => abortController.abort())\n          .on('SIGTERM', () => abortController.abort());\n        abortController.signal.throwIfAborted();\n\n        const store = await FileSystemStore.init({\n          rootDir,\n          logger: (level, message) => {\n            const timestamp = new Date(Date.now()).toISOString();\n            console.log(`[${timestamp}] [${level}] ${message}`);\n          }\n        });\n        abortController.signal.throwIfAborted();\n        const handler = createRequestHandler({ store });\n\n        const server = await serve({\n          handler,\n          ...(options.http && { http: true }),\n          ...(!options.auth && { noAuth: true })\n        });\n        abortController.signal.onabort = () => server.stop();\n        abortController.signal.throwIfAborted();\n\n        console.log(\n          JSON.stringify({\n            url: server.address,\n            ...(server.authToken && { authToken: server.authToken }),\n            ...(server.encodedCaCert && { caCert: server.encodedCaCert })\n          })\n        );\n\n        await server.stopped;\n      }\n    );\n\n  await program.parseAsync();\n}\n"],"names":[],"mappings":";;;;;AAKA;;;AAGG;AACI,eAAe,gBAAgB,GAAA;AACpC,IAAA,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;IAE7B;SACG,IAAI,CAAC,gBAAgB;SACrB,WAAW,CAAC,mDAAmD;AAC/D,SAAA,QAAQ,CAAC,kBAAkB,EAAE,yCAAyC;AACtE,SAAA,MAAM,CAAC,QAAQ,EAAE,2BAA2B,EAAE,KAAK;AACnD,SAAA,MAAM,CAAC,WAAW,EAAE,wBAAwB;AAC5C,SAAA,MAAM,CACL,OAAO,OAAe,EAAE,OAAyC,KAAI;AACnE,QAAA,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE;QAC7C;aACG,EAAE,CAAC,QAAQ,EAAE,MAAM,eAAe,CAAC,KAAK,EAAE;aAC1C,EAAE,CAAC,SAAS,EAAE,MAAM,eAAe,CAAC,KAAK,EAAE,CAAC;AAC/C,QAAA,eAAe,CAAC,MAAM,CAAC,cAAc,EAAE;AAEvC,QAAA,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC;YACvC,OAAO;AACP,YAAA,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAI;AACzB,gBAAA,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;gBACpD,OAAO,CAAC,GAAG,CAAC,CAAA,CAAA,EAAI,SAAS,CAAA,GAAA,EAAM,KAAK,CAAA,EAAA,EAAK,OAAO,CAAA,CAAE,CAAC;YACrD;AACD,SAAA,CAAC;AACF,QAAA,eAAe,CAAC,MAAM,CAAC,cAAc,EAAE;QACvC,MAAM,OAAO,GAAG,oBAAoB,CAAC,EAAE,KAAK,EAAE,CAAC;AAE/C,QAAA,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;YACzB,OAAO;YACP,IAAI,OAAO,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;AACtC,SAAA,CAAC;AACF,QAAA,eAAe,CAAC,MAAM,CAAC,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE;AACpD,QAAA,eAAe,CAAC,MAAM,CAAC,cAAc,EAAE;AAEvC,QAAA,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CAAC;YACb,GAAG,EAAE,MAAM,CAAC,OAAO;AACnB,YAAA,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;AACxD,YAAA,IAAI,MAAM,CAAC,aAAa,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE;AAC7D,SAAA,CAAC,CACH;QAED,MAAM,MAAM,CAAC,OAAO;AACtB,IAAA,CAAC,CACF;AAEH,IAAA,MAAM,OAAO,CAAC,UAAU,EAAE;AAC5B;;;;"}

package/dist/serve.cjs

@@ -0,0 +1,120 @@
+'use strict';
+
+var node_http = require('node:http');
+var node_https = require('node:https');
+var helpers = require('@milaboratories/helpers');
+var plModelCommon = require('@milaboratories/pl-model-common');
+var selfsigned = require('selfsigned');
+var node_crypto = require('node:crypto');
+var handler = require('./handler.cjs');
+
+/** Generate a self-signed certificate for localhost */
+async function generateCertificate() {
+    const generateResult = new helpers.Deferred();
+    selfsigned.generate([{ name: 'commonName', value: 'localhost' }], {
+        keySize: 2048,
+        algorithm: 'sha256',
+        extensions: [
+            {
+                name: 'subjectAltName',
+                altNames: [
+                    { type: 2, value: 'localhost' }, // DNS
+                    { type: 7, ip: '127.0.0.1' }, // IPv4
+                    { type: 7, ip: '::1' } // IPv6
+                ]
+            }
+        ]
+    }, (error, result) => {
+        if (error) {
+            generateResult.reject(error);
+        }
+        else {
+            generateResult.resolve(result);
+        }
+    });
+    return await generateResult.promise;
+}
+/** Create an object store URL from the server address info. */
+function createObjectStoreUrl(info, http) {
+    const protocol = http ? 'http' : 'https';
+    switch (info.family) {
+        case 'IPv4':
+            return `${protocol}://${info.address}:${info.port}/`;
+        case 'IPv6':
+            return `${protocol}://[${info.address}]:${info.port}/`;
+        default:
+            throw new plModelCommon.PFrameError(`PFrame helper HTTP(S) server bound to 'localhost' has unknown address family: ${info.family}`);
+    }
+}
+/**
+ * Serve HTTP requests using the provided handler.
+ * Returns a promise that resolves when the server is stopped.
+ */
+async function serve({ handler: handler$1, port = 0, http, noAuth }) {
+    const started = new helpers.Deferred();
+    try {
+        let stopped = null;
+        let authToken;
+        let effectiveHandler = handler$1;
+        if (!noAuth) {
+            authToken = node_crypto.randomUUID();
+            effectiveHandler = handler.authorizeRequestHandler(effectiveHandler, authToken);
+        }
+        // Create HTTP server
+        let certificateBase64;
+        const defaultOptions = {
+            keepAlive: true
+        };
+        let server;
+        if (http) {
+            server = node_http.createServer(defaultOptions, effectiveHandler);
+        }
+        else {
+            const { cert, private: key, public: ca } = await generateCertificate();
+            certificateBase64 = plModelCommon.base64Encode(cert);
+            server = node_https.createServer({ ...defaultOptions, cert, key, ca }, effectiveHandler);
+        }
+        const abortController = new AbortController();
+        server
+            .on('listening', () => {
+            // Cast is safe by specification <https://nodejs.org/api/net.html#serveraddress>
+            const address = createObjectStoreUrl(server.address(), http);
+            stopped = new helpers.Deferred();
+            started.resolve({
+                get address() {
+                    return address;
+                },
+                get authToken() {
+                    return authToken;
+                },
+                get encodedCaCert() {
+                    return certificateBase64;
+                },
+                get stopped() {
+                    return stopped.promise;
+                },
+                stop() {
+                    abortController.abort();
+                    return stopped.promise;
+                }
+            });
+        })
+            .on('error', (err) => {
+            started.reject(err);
+            stopped?.reject(err);
+        })
+            .on('close', () => stopped?.resolve())
+            .listen({
+            host: 'localhost',
+            port,
+            signal: abortController.signal
+        });
+    }
+    catch (error) {
+        started.reject(plModelCommon.ensureError(error));
+    }
+    return started.promise;
+}
+
+exports.serve = serve;
+//# sourceMappingURL=serve.cjs.map

package/dist/serve.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.cjs","sources":["../src/serve.ts"],"sourcesContent":["import {\n  createServer as createHttpServer,\n  type RequestListener,\n  type Server as HttpServer,\n  type ServerOptions\n} from 'node:http';\nimport {\n  createServer as createHttpsServer,\n  type Server as HttpsServer\n} from 'node:https';\nimport type { AddressInfo } from 'node:net';\nimport { Deferred } from '@milaboratories/helpers';\nimport type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';\nimport {\n  base64Encode,\n  Base64Encoded,\n  ensureError,\n  PFrameError\n} from '@milaboratories/pl-model-common';\nimport { generate, type GenerateResult } from 'selfsigned';\nimport { randomUUID } from 'node:crypto';\nimport { authorizeRequestHandler } from './handler';\n\n/** Generate a self-signed certificate for localhost */\nasync function generateCertificate(): Promise<GenerateResult> {\n  const generateResult = new Deferred<GenerateResult>();\n  generate(\n    [{ name: 'commonName', value: 'localhost' }],\n    {\n      keySize: 2048,\n      algorithm: 'sha256',\n      extensions: [\n        {\n          name: 'subjectAltName',\n          altNames: [\n            { type: 2, value: 'localhost' }, // DNS\n            { type: 7, ip: '127.0.0.1' }, // IPv4\n            { type: 7, ip: '::1' } // IPv6\n          ]\n        }\n      ]\n    },\n    (error, result) => {\n      if (error) {\n        generateResult.reject(error);\n      } else {\n        generateResult.resolve(result);\n      }\n    }\n  );\n  return await generateResult.promise;\n}\n\n/** Create an object store URL from the server address info. */\nfunction createObjectStoreUrl(\n  info: AddressInfo,\n  http?: true\n): PFrameInternal.ObjectStoreUrl {\n  const protocol = http ? 'http' : 'https';\n  switch (info.family) {\n    case 'IPv4':\n      return `${protocol}://${info.address}:${info.port}/` as PFrameInternal.ObjectStoreUrl;\n    case 'IPv6':\n      return `${protocol}://[${info.address}]:${info.port}/` as PFrameInternal.ObjectStoreUrl;\n    default:\n      throw new PFrameError(\n        `PFrame helper HTTP(S) server bound to 'localhost' has unknown address family: ${info.family}`\n      );\n  }\n}\n\n/**\n * Serve HTTP requests using the provided handler.\n * Returns a promise that resolves when the server is stopped.\n */\nexport async function serve({\n  handler,\n  port = 0,\n  http,\n  noAuth\n}: PFrameInternal.HttpServerOptions): Promise<PFrameInternal.HttpServer> {\n  const started = new Deferred<PFrameInternal.HttpServer>();\n  try {\n    let stopped: Deferred<void> | null = null;\n\n    let authToken: PFrameInternal.HttpAuthorizationToken | undefined;\n    let effectiveHandler: RequestListener = handler;\n    if (!noAuth) {\n      authToken = randomUUID() as PFrameInternal.HttpAuthorizationToken;\n      effectiveHandler = authorizeRequestHandler(effectiveHandler, authToken);\n    }\n\n    // Create HTTP server\n    let certificateBase64:\n      | Base64Encoded<PFrameInternal.PemCertificate>\n      | undefined;\n    const defaultOptions: ServerOptions = {\n      keepAlive: true\n    };\n    let server: HttpServer | HttpsServer;\n\n    if (http) {\n      server = createHttpServer(defaultOptions, effectiveHandler);\n    } else {\n      const { cert, private: key, public: ca } = await generateCertificate();\n      certificateBase64 = base64Encode(cert as PFrameInternal.PemCertificate);\n      server = createHttpsServer(\n        { ...defaultOptions, cert, key, ca },\n        effectiveHandler\n      );\n    }\n\n    const abortController = new AbortController();\n    server\n      .on('listening', () => {\n        // Cast is safe by specification <https://nodejs.org/api/net.html#serveraddress>\n        const address = createObjectStoreUrl(\n          server.address() as AddressInfo,\n          http\n        );\n        stopped = new Deferred<void>();\n\n        started.resolve({\n          get address(): PFrameInternal.ObjectStoreUrl {\n            return address;\n          },\n          get authToken(): PFrameInternal.HttpAuthorizationToken | undefined {\n            return authToken;\n          },\n          get encodedCaCert():\n            | Base64Encoded<PFrameInternal.PemCertificate>\n            | undefined {\n            return certificateBase64;\n          },\n          get stopped(): Promise<void> {\n            return stopped!.promise;\n          },\n          stop(): Promise<void> {\n            abortController.abort();\n            return stopped!.promise;\n          }\n        });\n      })\n      .on('error', (err) => {\n        started.reject(err);\n        stopped?.reject(err);\n      })\n      .on('close', () => stopped?.resolve())\n      .listen({\n        host: 'localhost',\n        port,\n        signal: abortController.signal\n      });\n  } catch (error: unknown) {\n    started.reject(ensureError(error));\n  }\n\n  return started.promise;\n}\n"],"names":["Deferred","generate","PFrameError","handler","randomUUID","authorizeRequestHandler","createHttpServer","base64Encode","createHttpsServer","ensureError"],"mappings":"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"}

package/dist/serve.d.ts

@@ -0,0 +1,7 @@
+import type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';
+/**
+ * Serve HTTP requests using the provided handler.
+ * Returns a promise that resolves when the server is stopped.
+ */
+export declare function serve({ handler, port, http, noAuth }: PFrameInternal.HttpServerOptions): Promise<PFrameInternal.HttpServer>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AA2D5E;;;GAGG;AACH,wBAAsB,KAAK,CAAC,EAC1B,OAAO,EACP,IAAQ,EACR,IAAI,EACJ,MAAM,EACP,EAAE,cAAc,CAAC,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CA8EvE"}

package/dist/serve.js

@@ -0,0 +1,118 @@
+import { createServer } from 'node:http';
+import { createServer as createServer$1 } from 'node:https';
+import { Deferred } from '@milaboratories/helpers';
+import { base64Encode, ensureError, PFrameError } from '@milaboratories/pl-model-common';
+import { generate } from 'selfsigned';
+import { randomUUID } from 'node:crypto';
+import { authorizeRequestHandler } from './handler.js';
+
+/** Generate a self-signed certificate for localhost */
+async function generateCertificate() {
+    const generateResult = new Deferred();
+    generate([{ name: 'commonName', value: 'localhost' }], {
+        keySize: 2048,
+        algorithm: 'sha256',
+        extensions: [
+            {
+                name: 'subjectAltName',
+                altNames: [
+                    { type: 2, value: 'localhost' }, // DNS
+                    { type: 7, ip: '127.0.0.1' }, // IPv4
+                    { type: 7, ip: '::1' } // IPv6
+                ]
+            }
+        ]
+    }, (error, result) => {
+        if (error) {
+            generateResult.reject(error);
+        }
+        else {
+            generateResult.resolve(result);
+        }
+    });
+    return await generateResult.promise;
+}
+/** Create an object store URL from the server address info. */
+function createObjectStoreUrl(info, http) {
+    const protocol = http ? 'http' : 'https';
+    switch (info.family) {
+        case 'IPv4':
+            return `${protocol}://${info.address}:${info.port}/`;
+        case 'IPv6':
+            return `${protocol}://[${info.address}]:${info.port}/`;
+        default:
+            throw new PFrameError(`PFrame helper HTTP(S) server bound to 'localhost' has unknown address family: ${info.family}`);
+    }
+}
+/**
+ * Serve HTTP requests using the provided handler.
+ * Returns a promise that resolves when the server is stopped.
+ */
+async function serve({ handler, port = 0, http, noAuth }) {
+    const started = new Deferred();
+    try {
+        let stopped = null;
+        let authToken;
+        let effectiveHandler = handler;
+        if (!noAuth) {
+            authToken = randomUUID();
+            effectiveHandler = authorizeRequestHandler(effectiveHandler, authToken);
+        }
+        // Create HTTP server
+        let certificateBase64;
+        const defaultOptions = {
+            keepAlive: true
+        };
+        let server;
+        if (http) {
+            server = createServer(defaultOptions, effectiveHandler);
+        }
+        else {
+            const { cert, private: key, public: ca } = await generateCertificate();
+            certificateBase64 = base64Encode(cert);
+            server = createServer$1({ ...defaultOptions, cert, key, ca }, effectiveHandler);
+        }
+        const abortController = new AbortController();
+        server
+            .on('listening', () => {
+            // Cast is safe by specification <https://nodejs.org/api/net.html#serveraddress>
+            const address = createObjectStoreUrl(server.address(), http);
+            stopped = new Deferred();
+            started.resolve({
+                get address() {
+                    return address;
+                },
+                get authToken() {
+                    return authToken;
+                },
+                get encodedCaCert() {
+                    return certificateBase64;
+                },
+                get stopped() {
+                    return stopped.promise;
+                },
+                stop() {
+                    abortController.abort();
+                    return stopped.promise;
+                }
+            });
+        })
+            .on('error', (err) => {
+            started.reject(err);
+            stopped?.reject(err);
+        })
+            .on('close', () => stopped?.resolve())
+            .listen({
+            host: 'localhost',
+            port,
+            signal: abortController.signal
+        });
+    }
+    catch (error) {
+        started.reject(ensureError(error));
+    }
+    return started.promise;
+}
+
+export { serve };
+//# sourceMappingURL=serve.js.map

package/dist/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sources":["../src/serve.ts"],"sourcesContent":["import {\n  createServer as createHttpServer,\n  type RequestListener,\n  type Server as HttpServer,\n  type ServerOptions\n} from 'node:http';\nimport {\n  createServer as createHttpsServer,\n  type Server as HttpsServer\n} from 'node:https';\nimport type { AddressInfo } from 'node:net';\nimport { Deferred } from '@milaboratories/helpers';\nimport type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';\nimport {\n  base64Encode,\n  Base64Encoded,\n  ensureError,\n  PFrameError\n} from '@milaboratories/pl-model-common';\nimport { generate, type GenerateResult } from 'selfsigned';\nimport { randomUUID } from 'node:crypto';\nimport { authorizeRequestHandler } from './handler';\n\n/** Generate a self-signed certificate for localhost */\nasync function generateCertificate(): Promise<GenerateResult> {\n  const generateResult = new Deferred<GenerateResult>();\n  generate(\n    [{ name: 'commonName', value: 'localhost' }],\n    {\n      keySize: 2048,\n      algorithm: 'sha256',\n      extensions: [\n        {\n          name: 'subjectAltName',\n          altNames: [\n            { type: 2, value: 'localhost' }, // DNS\n            { type: 7, ip: '127.0.0.1' }, // IPv4\n            { type: 7, ip: '::1' } // IPv6\n          ]\n        }\n      ]\n    },\n    (error, result) => {\n      if (error) {\n        generateResult.reject(error);\n      } else {\n        generateResult.resolve(result);\n      }\n    }\n  );\n  return await generateResult.promise;\n}\n\n/** Create an object store URL from the server address info. */\nfunction createObjectStoreUrl(\n  info: AddressInfo,\n  http?: true\n): PFrameInternal.ObjectStoreUrl {\n  const protocol = http ? 'http' : 'https';\n  switch (info.family) {\n    case 'IPv4':\n      return `${protocol}://${info.address}:${info.port}/` as PFrameInternal.ObjectStoreUrl;\n    case 'IPv6':\n      return `${protocol}://[${info.address}]:${info.port}/` as PFrameInternal.ObjectStoreUrl;\n    default:\n      throw new PFrameError(\n        `PFrame helper HTTP(S) server bound to 'localhost' has unknown address family: ${info.family}`\n      );\n  }\n}\n\n/**\n * Serve HTTP requests using the provided handler.\n * Returns a promise that resolves when the server is stopped.\n */\nexport async function serve({\n  handler,\n  port = 0,\n  http,\n  noAuth\n}: PFrameInternal.HttpServerOptions): Promise<PFrameInternal.HttpServer> {\n  const started = new Deferred<PFrameInternal.HttpServer>();\n  try {\n    let stopped: Deferred<void> | null = null;\n\n    let authToken: PFrameInternal.HttpAuthorizationToken | undefined;\n    let effectiveHandler: RequestListener = handler;\n    if (!noAuth) {\n      authToken = randomUUID() as PFrameInternal.HttpAuthorizationToken;\n      effectiveHandler = authorizeRequestHandler(effectiveHandler, authToken);\n    }\n\n    // Create HTTP server\n    let certificateBase64:\n      | Base64Encoded<PFrameInternal.PemCertificate>\n      | undefined;\n    const defaultOptions: ServerOptions = {\n      keepAlive: true\n    };\n    let server: HttpServer | HttpsServer;\n\n    if (http) {\n      server = createHttpServer(defaultOptions, effectiveHandler);\n    } else {\n      const { cert, private: key, public: ca } = await generateCertificate();\n      certificateBase64 = base64Encode(cert as PFrameInternal.PemCertificate);\n      server = createHttpsServer(\n        { ...defaultOptions, cert, key, ca },\n        effectiveHandler\n      );\n    }\n\n    const abortController = new AbortController();\n    server\n      .on('listening', () => {\n        // Cast is safe by specification <https://nodejs.org/api/net.html#serveraddress>\n        const address = createObjectStoreUrl(\n          server.address() as AddressInfo,\n          http\n        );\n        stopped = new Deferred<void>();\n\n        started.resolve({\n          get address(): PFrameInternal.ObjectStoreUrl {\n            return address;\n          },\n          get authToken(): PFrameInternal.HttpAuthorizationToken | undefined {\n            return authToken;\n          },\n          get encodedCaCert():\n            | Base64Encoded<PFrameInternal.PemCertificate>\n            | undefined {\n            return certificateBase64;\n          },\n          get stopped(): Promise<void> {\n            return stopped!.promise;\n          },\n          stop(): Promise<void> {\n            abortController.abort();\n            return stopped!.promise;\n          }\n        });\n      })\n      .on('error', (err) => {\n        started.reject(err);\n        stopped?.reject(err);\n      })\n      .on('close', () => stopped?.resolve())\n      .listen({\n        host: 'localhost',\n        port,\n        signal: abortController.signal\n      });\n  } catch (error: unknown) {\n    started.reject(ensureError(error));\n  }\n\n  return started.promise;\n}\n"],"names":["createHttpServer","createHttpsServer"],"mappings":"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"}

package/dist/utils/etag.cjs

@@ -0,0 +1,10 @@
+'use strict';
+
+function createETag(filename) {
+    // For immutable files, use URL-safe base64 encoded filename as ETag
+    const filenameETag = Buffer.from(filename, 'utf8').toString('base64url');
+    return `"${filenameETag}"`;
+}
+
+exports.createETag = createETag;
+//# sourceMappingURL=etag.cjs.map

package/dist/utils/etag.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"etag.cjs","sources":["../../src/utils/etag.ts"],"sourcesContent":["import type { Branded } from '@milaboratories/pl-model-common';\nimport type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';\n\n/**\n * See <https://datatracker.ietf.org/doc/html/rfc9110#section-8.8.3>\n *\n * Examples:\n *\n * ```text\n * ETag: \"xyzzy\"\n * ETag: W/\"xyzzy\"\n * ```\n */\nexport type Etag = Branded<string, 'Etag'>;\n\nexport function createETag(filename: PFrameInternal.ParquetFileName): Etag {\n  // For immutable files, use URL-safe base64 encoded filename as ETag\n  const filenameETag = Buffer.from(filename, 'utf8').toString('base64url');\n  return `\"${filenameETag}\"` as Etag;\n}\n"],"names":[],"mappings":";;AAeM,SAAU,UAAU,CAAC,QAAwC,EAAA;;AAEjE,IAAA,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;IACxE,OAAO,CAAA,CAAA,EAAI,YAAY,CAAA,CAAA,CAAW;AACpC;;;;"}

package/dist/utils/etag.d.ts

@@ -0,0 +1,15 @@
+import type { Branded } from '@milaboratories/pl-model-common';
+import type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';
+/**
+ * See <https://datatracker.ietf.org/doc/html/rfc9110#section-8.8.3>
+ *
+ * Examples:
+ *
+ * ```text
+ * ETag: "xyzzy"
+ * ETag: W/"xyzzy"
+ * ```
+ */
+export type Etag = Branded<string, 'Etag'>;
+export declare function createETag(filename: PFrameInternal.ParquetFileName): Etag;
+//# sourceMappingURL=etag.d.ts.map

package/dist/utils/etag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../../src/utils/etag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,wBAAgB,UAAU,CAAC,QAAQ,EAAE,cAAc,CAAC,eAAe,GAAG,IAAI,CAIzE"}

package/dist/utils/etag.js

@@ -0,0 +1,8 @@
+function createETag(filename) {
+    // For immutable files, use URL-safe base64 encoded filename as ETag
+    const filenameETag = Buffer.from(filename, 'utf8').toString('base64url');
+    return `"${filenameETag}"`;
+}
+
+export { createETag };
+//# sourceMappingURL=etag.js.map

package/dist/utils/etag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"etag.js","sources":["../../src/utils/etag.ts"],"sourcesContent":["import type { Branded } from '@milaboratories/pl-model-common';\nimport type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';\n\n/**\n * See <https://datatracker.ietf.org/doc/html/rfc9110#section-8.8.3>\n *\n * Examples:\n *\n * ```text\n * ETag: \"xyzzy\"\n * ETag: W/\"xyzzy\"\n * ```\n */\nexport type Etag = Branded<string, 'Etag'>;\n\nexport function createETag(filename: PFrameInternal.ParquetFileName): Etag {\n  // For immutable files, use URL-safe base64 encoded filename as ETag\n  const filenameETag = Buffer.from(filename, 'utf8').toString('base64url');\n  return `\"${filenameETag}\"` as Etag;\n}\n"],"names":[],"mappings":"AAeM,SAAU,UAAU,CAAC,QAAwC,EAAA;;AAEjE,IAAA,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;IACxE,OAAO,CAAA,CAAA,EAAI,YAAY,CAAA,CAAA,CAAW;AACpC;;;;"}

package/dist/utils/filename.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+const PARQUET_FILENAME_REGEX = /^\/([\w\-.]+.parquet)$/;
+function getFilenameFromUrl(request) {
+    const url = request.url;
+    if (url === undefined)
+        return null;
+    const match = url.match(PARQUET_FILENAME_REGEX);
+    if (!match)
+        return null;
+    return match[1];
+}
+
+exports.getFilenameFromUrl = getFilenameFromUrl;
+//# sourceMappingURL=filename.cjs.map

package/dist/utils/filename.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename.cjs","sources":["../../src/utils/filename.ts"],"sourcesContent":["import type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';\nimport type { IncomingMessage } from 'node:http';\n\nconst PARQUET_FILENAME_REGEX = /^\\/([\\w\\-.]+.parquet)$/;\n\nexport function getFilenameFromUrl(\n  request: IncomingMessage\n): PFrameInternal.ParquetFileName | null {\n  const url = request.url;\n  if (url === undefined) return null;\n\n  const match = url.match(PARQUET_FILENAME_REGEX);\n  if (!match) return null;\n\n  return match[1] as PFrameInternal.ParquetFileName;\n}\n"],"names":[],"mappings":";;AAGA,MAAM,sBAAsB,GAAG,wBAAwB;AAEjD,SAAU,kBAAkB,CAChC,OAAwB,EAAA;AAExB,IAAA,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG;IACvB,IAAI,GAAG,KAAK,SAAS;AAAE,QAAA,OAAO,IAAI;IAElC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC;AAC/C,IAAA,IAAI,CAAC,KAAK;AAAE,QAAA,OAAO,IAAI;AAEvB,IAAA,OAAO,KAAK,CAAC,CAAC,CAAmC;AACnD;;;;"}

package/dist/utils/filename.d.ts

@@ -0,0 +1,4 @@
+import type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';
+import type { IncomingMessage } from 'node:http';
+export declare function getFilenameFromUrl(request: IncomingMessage): PFrameInternal.ParquetFileName | null;
+//# sourceMappingURL=filename.d.ts.map

package/dist/utils/filename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename.d.ts","sourceRoot":"","sources":["../../src/utils/filename.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,GACvB,cAAc,CAAC,eAAe,GAAG,IAAI,CAQvC"}

package/dist/utils/filename.js

@@ -0,0 +1,13 @@
+const PARQUET_FILENAME_REGEX = /^\/([\w\-.]+.parquet)$/;
+function getFilenameFromUrl(request) {
+    const url = request.url;
+    if (url === undefined)
+        return null;
+    const match = url.match(PARQUET_FILENAME_REGEX);
+    if (!match)
+        return null;
+    return match[1];
+}
+
+export { getFilenameFromUrl };
+//# sourceMappingURL=filename.js.map

package/dist/utils/filename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename.js","sources":["../../src/utils/filename.ts"],"sourcesContent":["import type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';\nimport type { IncomingMessage } from 'node:http';\n\nconst PARQUET_FILENAME_REGEX = /^\\/([\\w\\-.]+.parquet)$/;\n\nexport function getFilenameFromUrl(\n  request: IncomingMessage\n): PFrameInternal.ParquetFileName | null {\n  const url = request.url;\n  if (url === undefined) return null;\n\n  const match = url.match(PARQUET_FILENAME_REGEX);\n  if (!match) return null;\n\n  return match[1] as PFrameInternal.ParquetFileName;\n}\n"],"names":[],"mappings":"AAGA,MAAM,sBAAsB,GAAG,wBAAwB;AAEjD,SAAU,kBAAkB,CAChC,OAAwB,EAAA;AAExB,IAAA,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG;IACvB,IAAI,GAAG,KAAK,SAAS;AAAE,QAAA,OAAO,IAAI;IAElC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC;AAC/C,IAAA,IAAI,CAAC,KAAK;AAAE,QAAA,OAAO,IAAI;AAEvB,IAAA,OAAO,KAAK,CAAC,CAAC,CAAmC;AACnD;;;;"}

package/dist/utils/headers.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+/** HTTP header names used in the parquet server handler */
+const HeaderName = {
+    AcceptRanges: 'accept-ranges',
+    Allow: 'allow',
+    CacheControl: 'cache-control',
+    ContentLength: 'content-length',
+    ContentRange: 'content-range',
+    ContentType: 'content-type',
+    ETag: 'etag',
+    LastModified: 'last-modified',
+    WWWAuthenticate: 'www-authenticate'
+};
+/** HTTP header values used in the parquet server handler */
+const HeaderValue = {
+    AcceptRanges: 'bytes',
+    Allow: 'GET, HEAD',
+    CacheControl: 'public, immutable, max-age=31536000',
+    ContentType: 'application/octet-stream',
+    WWWAuthenticate: 'Bearer realm="parquet-server"'
+};
+
+exports.HeaderName = HeaderName;
+exports.HeaderValue = HeaderValue;
+//# sourceMappingURL=headers.cjs.map