@milaboratories/pframes-rs-serv 1.0.109 → 1.1.0

package/dist/handler.js

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

package/dist/handler.js.map

@@ -1 +0,0 @@
-{"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  isGet,\n  isHead,\n  Options,\n  StatusCode,\n  HeaderName,\n  HeaderValue\n} from './utils';\nimport { isAbortError } from '@milaboratories/pl-model-common';\n\n/** Main request handler for parquet files */\nfunction handleRequest(\n  request: IncomingMessage,\n  response: ServerResponse,\n  store: PFrameInternal.ObjectStore\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  // 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,\n    range,\n    signal,\n    // pipeline automatically destroys the streams if they were not gracefully closed\n    callback: async (result) => {\n      if (request.destroyed) {\n        // request has timed out, close the connection\n        if (response.destroyed) {\n          return;\n        } else if (response.headersSent) {\n          return void response.end();\n        } else {\n          response.setHeader(HeaderName.Connection, HeaderValue.Connection);\n          return void response.writeHead(StatusCode.RequestTimeout).end();\n        }\n      }\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      try {\n        return await pipeline(result.data!, response, { signal });\n      } catch (error: unknown) {\n        if (!isAbortError(error)) throw error;\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 410 Gone 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) => 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[HeaderName.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

@@ -1,18 +0,0 @@
-'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.ParquetServer = parquetServer.ParquetServer;
-exports.runParquetServer = parquetServer.runParquetServer;
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

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

package/dist/index.d.ts

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

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

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

package/dist/index.js.map

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

package/dist/parquet-server.cjs

@@ -1,109 +0,0 @@
-'use strict';
-
-var node_child_process = require('node:child_process');
-var promises = require('node:readline/promises');
-var node_path = require('node:path');
-var node_url = require('node:url');
-var commander = require('commander');
-var _export = require('./export.cjs');
-var plModelCommon = require('@milaboratories/pl-model-common');
-
-var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
-const Options = {
-    NoHttps: '--no-https',
-    NoAuth: '--no-auth',
-    Port: '--port'
-};
-/**
- * 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(Options.NoHttps, 'Downgrade HTTPS to HTTP')
-        .option(Options.NoAuth, 'Disable authorization')
-        .option(`${Options.Port} <number>`, 'Port to listen on', (value) => {
-        const port = parseInt(value, 10);
-        if (isNaN(port) || port < 0 || port > 65535) {
-            throw new commander.InvalidArgumentError('valid port numbers are 0-65535');
-        }
-        return port;
-    }, 0)
-        .action(async (rootDir, options) => {
-        const abortController = new AbortController();
-        process
-            .on('SIGINT', () => abortController.abort())
-            .on('SIGTERM', () => abortController.abort());
-        abortController.signal.throwIfAborted();
-        const store = await _export.HttpHelpers.createFsStore({
-            rootDir,
-            logger: (level, message) => {
-                const timestamp = new Date(Date.now()).toISOString();
-                console.log(`[${timestamp}] [${level}] ${message}`);
-            }
-        });
-        abortController.signal.throwIfAborted();
-        const handler = _export.HttpHelpers.createRequestHandler({ store });
-        const server = await _export.HttpHelpers.createHttpServer({
-            handler,
-            ...(!options.https && { noHttps: true }),
-            ...(!options.auth && { noAuth: true }),
-            port: options.port
-        });
-        abortController.signal.onabort = () => server.stop();
-        abortController.signal.throwIfAborted();
-        const serverInfo = plModelCommon.stringifyJson(server.info);
-        console.log(serverInfo);
-        await server.stopped;
-    });
-    await program.parseAsync();
-}
-/**
- * Reference implementation of a parquet server runner for tests:
- * - Reads the server configuration from the spawned process stdout
- * - Forwards the server logs to the console
- * - Shuts down the server on dispose
- */
-class ParquetServer {
-    #process;
-    #info;
-    #lineReader;
-    constructor(process, info, lineReader) {
-        this.#process = process;
-        this.#info = info;
-        this.#lineReader = lineReader;
-    }
-    get info() {
-        return this.#info;
-    }
-    static async serve(rootDir, options) {
-        const nodeDirname = node_path.dirname(node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('parquet-server.cjs', document.baseURI).href))));
-        const binPath = node_path.join(nodeDirname, '..', 'bin', 'parquet-server.mjs');
-        const serverProcess = node_child_process.spawn('node', [
-            binPath,
-            rootDir,
-            ...(options?.noHttps ? [Options.NoHttps] : []),
-            ...(options?.noAuth ? [Options.NoAuth] : []),
-            ...(options?.port ? [Options.Port, options.port.toString()] : [])
-        ], {
-            stdio: ['ignore', 'pipe', 'ignore']
-        });
-        const lineReader = promises.createInterface({ input: serverProcess.stdout });
-        const firstLine = await lineReader[Symbol.asyncIterator]().next();
-        const serverInfo = plModelCommon.parseJson(firstLine.value);
-        lineReader.on('line', console.log);
-        return new ParquetServer(serverProcess, serverInfo, lineReader);
-    }
-    [Symbol.dispose]() {
-        this.#lineReader.close();
-        this.#process.kill();
-    }
-}
-
-exports.ParquetServer = ParquetServer;
-exports.runParquetServer = runParquetServer;
-//# sourceMappingURL=parquet-server.cjs.map

package/dist/parquet-server.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"parquet-server.cjs","sources":["../src/parquet-server.ts"],"sourcesContent":["import { type ChildProcess, spawn } from 'node:child_process';\nimport { createInterface, type Interface } from 'node:readline/promises';\nimport { join, dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { Command, InvalidArgumentError } from 'commander';\nimport { HttpHelpers } from './export';\nimport {\n  parseJson,\n  stringifyJson,\n  type StringifiedJson\n} from '@milaboratories/pl-model-common';\nimport { type PFrameInternal } from '@milaboratories/pl-model-middle-layer';\n\nconst Options = {\n  NoHttps: '--no-https',\n  NoAuth: '--no-auth',\n  Port: '--port'\n} as const;\n\ntype Info = StringifiedJson<PFrameInternal.HttpServerInfo>;\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(Options.NoHttps, 'Downgrade HTTPS to HTTP')\n    .option(Options.NoAuth, 'Disable authorization')\n    .option(\n      `${Options.Port} <number>`,\n      'Port to listen on',\n      (value) => {\n        const port = parseInt(value, 10);\n        if (isNaN(port) || port < 0 || port > 65535) {\n          throw new InvalidArgumentError('valid port numbers are 0-65535');\n        }\n        return port;\n      },\n      0\n    )\n    .action(\n      async (\n        rootDir: string,\n        options: {\n          https: boolean;\n          auth: boolean;\n          port: number;\n        }\n      ) => {\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 HttpHelpers.createFsStore({\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 = HttpHelpers.createRequestHandler({ store });\n\n        const server = await HttpHelpers.createHttpServer({\n          handler,\n          ...(!options.https && { noHttps: true }),\n          ...(!options.auth && { noAuth: true }),\n          port: options.port\n        });\n        abortController.signal.onabort = () => server.stop();\n        abortController.signal.throwIfAborted();\n\n        const serverInfo: Info = stringifyJson(server.info);\n        console.log(serverInfo);\n\n        await server.stopped;\n      }\n    );\n\n  await program.parseAsync();\n}\n\n/**\n * Reference implementation of a parquet server runner for tests:\n * - Reads the server configuration from the spawned process stdout\n * - Forwards the server logs to the console\n * - Shuts down the server on dispose\n */\nexport class ParquetServer implements Disposable {\n  readonly #process: ChildProcess;\n  readonly #info: PFrameInternal.HttpServerInfo;\n  readonly #lineReader: Interface;\n\n  private constructor(\n    process: ChildProcess,\n    info: PFrameInternal.HttpServerInfo,\n    lineReader: Interface\n  ) {\n    this.#process = process;\n    this.#info = info;\n    this.#lineReader = lineReader;\n  }\n\n  get info(): PFrameInternal.HttpServerInfo {\n    return this.#info;\n  }\n\n  static async serve(\n    rootDir: string,\n    options?: {\n      noHttps?: true;\n      noAuth?: true;\n      port?: number;\n    }\n  ): Promise<ParquetServer> {\n    const nodeDirname = dirname(fileURLToPath(import.meta.url));\n    const binPath = join(nodeDirname, '..', 'bin', 'parquet-server.mjs');\n\n    const serverProcess = spawn(\n      'node',\n      [\n        binPath,\n        rootDir,\n        ...(options?.noHttps ? [Options.NoHttps] : []),\n        ...(options?.noAuth ? [Options.NoAuth] : []),\n        ...(options?.port ? [Options.Port, options.port.toString()] : [])\n      ],\n      {\n        stdio: ['ignore', 'pipe', 'ignore']\n      }\n    );\n\n    const lineReader = createInterface({ input: serverProcess.stdout! });\n\n    const firstLine = await lineReader[Symbol.asyncIterator]().next();\n    const serverInfo = parseJson(firstLine.value as Info);\n\n    lineReader.on('line', console.log);\n\n    return new ParquetServer(serverProcess, serverInfo, lineReader);\n  }\n\n  [Symbol.dispose](): void {\n    this.#lineReader.close();\n    this.#process.kill();\n  }\n}\n"],"names":["Command","InvalidArgumentError","HttpHelpers","stringifyJson","dirname","fileURLToPath","join","spawn","createInterface","parseJson"],"mappings":"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"}

package/dist/parquet-server.d.ts

@@ -1,24 +0,0 @@
-import { type PFrameInternal } from '@milaboratories/pl-model-middle-layer';
-/**
- * Serves parquet files from the given root directory.
- * Manages the server lifecycle with graceful shutdown.
- */
-export declare function runParquetServer(): Promise<void>;
-/**
- * Reference implementation of a parquet server runner for tests:
- * - Reads the server configuration from the spawned process stdout
- * - Forwards the server logs to the console
- * - Shuts down the server on dispose
- */
-export declare class ParquetServer implements Disposable {
-    #private;
-    private constructor();
-    get info(): PFrameInternal.HttpServerInfo;
-    static serve(rootDir: string, options?: {
-        noHttps?: true;
-        noAuth?: true;
-        port?: number;
-    }): Promise<ParquetServer>;
-    [Symbol.dispose](): void;
-}
-//# sourceMappingURL=parquet-server.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"parquet-server.d.ts","sourceRoot":"","sources":["../src/parquet-server.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAU5E;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CA+DtD;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,UAAU;;IAK9C,OAAO;IAUP,IAAI,IAAI,IAAI,cAAc,CAAC,cAAc,CAExC;WAEY,KAAK,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,IAAI,CAAC;QACf,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GACA,OAAO,CAAC,aAAa,CAAC;IA4BzB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAIzB"}

package/dist/parquet-server.js

@@ -1,105 +0,0 @@
-import { spawn } from 'node:child_process';
-import { createInterface } from 'node:readline/promises';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { Command, InvalidArgumentError } from 'commander';
-import { HttpHelpers } from './export.js';
-import { stringifyJson, parseJson } from '@milaboratories/pl-model-common';
-
-const Options = {
-    NoHttps: '--no-https',
-    NoAuth: '--no-auth',
-    Port: '--port'
-};
-/**
- * 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(Options.NoHttps, 'Downgrade HTTPS to HTTP')
-        .option(Options.NoAuth, 'Disable authorization')
-        .option(`${Options.Port} <number>`, 'Port to listen on', (value) => {
-        const port = parseInt(value, 10);
-        if (isNaN(port) || port < 0 || port > 65535) {
-            throw new InvalidArgumentError('valid port numbers are 0-65535');
-        }
-        return port;
-    }, 0)
-        .action(async (rootDir, options) => {
-        const abortController = new AbortController();
-        process
-            .on('SIGINT', () => abortController.abort())
-            .on('SIGTERM', () => abortController.abort());
-        abortController.signal.throwIfAborted();
-        const store = await HttpHelpers.createFsStore({
-            rootDir,
-            logger: (level, message) => {
-                const timestamp = new Date(Date.now()).toISOString();
-                console.log(`[${timestamp}] [${level}] ${message}`);
-            }
-        });
-        abortController.signal.throwIfAborted();
-        const handler = HttpHelpers.createRequestHandler({ store });
-        const server = await HttpHelpers.createHttpServer({
-            handler,
-            ...(!options.https && { noHttps: true }),
-            ...(!options.auth && { noAuth: true }),
-            port: options.port
-        });
-        abortController.signal.onabort = () => server.stop();
-        abortController.signal.throwIfAborted();
-        const serverInfo = stringifyJson(server.info);
-        console.log(serverInfo);
-        await server.stopped;
-    });
-    await program.parseAsync();
-}
-/**
- * Reference implementation of a parquet server runner for tests:
- * - Reads the server configuration from the spawned process stdout
- * - Forwards the server logs to the console
- * - Shuts down the server on dispose
- */
-class ParquetServer {
-    #process;
-    #info;
-    #lineReader;
-    constructor(process, info, lineReader) {
-        this.#process = process;
-        this.#info = info;
-        this.#lineReader = lineReader;
-    }
-    get info() {
-        return this.#info;
-    }
-    static async serve(rootDir, options) {
-        const nodeDirname = dirname(fileURLToPath(import.meta.url));
-        const binPath = join(nodeDirname, '..', 'bin', 'parquet-server.mjs');
-        const serverProcess = spawn('node', [
-            binPath,
-            rootDir,
-            ...(options?.noHttps ? [Options.NoHttps] : []),
-            ...(options?.noAuth ? [Options.NoAuth] : []),
-            ...(options?.port ? [Options.Port, options.port.toString()] : [])
-        ], {
-            stdio: ['ignore', 'pipe', 'ignore']
-        });
-        const lineReader = createInterface({ input: serverProcess.stdout });
-        const firstLine = await lineReader[Symbol.asyncIterator]().next();
-        const serverInfo = parseJson(firstLine.value);
-        lineReader.on('line', console.log);
-        return new ParquetServer(serverProcess, serverInfo, lineReader);
-    }
-    [Symbol.dispose]() {
-        this.#lineReader.close();
-        this.#process.kill();
-    }
-}
-
-export { ParquetServer, runParquetServer };
-//# sourceMappingURL=parquet-server.js.map

package/dist/parquet-server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parquet-server.js","sources":["../src/parquet-server.ts"],"sourcesContent":["import { type ChildProcess, spawn } from 'node:child_process';\nimport { createInterface, type Interface } from 'node:readline/promises';\nimport { join, dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { Command, InvalidArgumentError } from 'commander';\nimport { HttpHelpers } from './export';\nimport {\n  parseJson,\n  stringifyJson,\n  type StringifiedJson\n} from '@milaboratories/pl-model-common';\nimport { type PFrameInternal } from '@milaboratories/pl-model-middle-layer';\n\nconst Options = {\n  NoHttps: '--no-https',\n  NoAuth: '--no-auth',\n  Port: '--port'\n} as const;\n\ntype Info = StringifiedJson<PFrameInternal.HttpServerInfo>;\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(Options.NoHttps, 'Downgrade HTTPS to HTTP')\n    .option(Options.NoAuth, 'Disable authorization')\n    .option(\n      `${Options.Port} <number>`,\n      'Port to listen on',\n      (value) => {\n        const port = parseInt(value, 10);\n        if (isNaN(port) || port < 0 || port > 65535) {\n          throw new InvalidArgumentError('valid port numbers are 0-65535');\n        }\n        return port;\n      },\n      0\n    )\n    .action(\n      async (\n        rootDir: string,\n        options: {\n          https: boolean;\n          auth: boolean;\n          port: number;\n        }\n      ) => {\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 HttpHelpers.createFsStore({\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 = HttpHelpers.createRequestHandler({ store });\n\n        const server = await HttpHelpers.createHttpServer({\n          handler,\n          ...(!options.https && { noHttps: true }),\n          ...(!options.auth && { noAuth: true }),\n          port: options.port\n        });\n        abortController.signal.onabort = () => server.stop();\n        abortController.signal.throwIfAborted();\n\n        const serverInfo: Info = stringifyJson(server.info);\n        console.log(serverInfo);\n\n        await server.stopped;\n      }\n    );\n\n  await program.parseAsync();\n}\n\n/**\n * Reference implementation of a parquet server runner for tests:\n * - Reads the server configuration from the spawned process stdout\n * - Forwards the server logs to the console\n * - Shuts down the server on dispose\n */\nexport class ParquetServer implements Disposable {\n  readonly #process: ChildProcess;\n  readonly #info: PFrameInternal.HttpServerInfo;\n  readonly #lineReader: Interface;\n\n  private constructor(\n    process: ChildProcess,\n    info: PFrameInternal.HttpServerInfo,\n    lineReader: Interface\n  ) {\n    this.#process = process;\n    this.#info = info;\n    this.#lineReader = lineReader;\n  }\n\n  get info(): PFrameInternal.HttpServerInfo {\n    return this.#info;\n  }\n\n  static async serve(\n    rootDir: string,\n    options?: {\n      noHttps?: true;\n      noAuth?: true;\n      port?: number;\n    }\n  ): Promise<ParquetServer> {\n    const nodeDirname = dirname(fileURLToPath(import.meta.url));\n    const binPath = join(nodeDirname, '..', 'bin', 'parquet-server.mjs');\n\n    const serverProcess = spawn(\n      'node',\n      [\n        binPath,\n        rootDir,\n        ...(options?.noHttps ? [Options.NoHttps] : []),\n        ...(options?.noAuth ? [Options.NoAuth] : []),\n        ...(options?.port ? [Options.Port, options.port.toString()] : [])\n      ],\n      {\n        stdio: ['ignore', 'pipe', 'ignore']\n      }\n    );\n\n    const lineReader = createInterface({ input: serverProcess.stdout! });\n\n    const firstLine = await lineReader[Symbol.asyncIterator]().next();\n    const serverInfo = parseJson(firstLine.value as Info);\n\n    lineReader.on('line', console.log);\n\n    return new ParquetServer(serverProcess, serverInfo, lineReader);\n  }\n\n  [Symbol.dispose](): void {\n    this.#lineReader.close();\n    this.#process.kill();\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/serve.cjs

@@ -1,112 +0,0 @@
-'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, noHttps) {
-    const protocol = noHttps ? 'http' : 'https';
-    switch (info.family) {
-        case 'IPv4':
-            return `${protocol}://${info.address}:${info.port}/`;
-        case 'IPv6':
-            return `${protocol}://[${info.address}]:${info.port}/`;
-        default:
-            return `${protocol}://localhost:${info.port}/`;
-    }
-}
-/**
- * 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, noHttps, 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 encodedCaCert;
-        const defaultOptions = {
-            keepAlive: true
-        };
-        let server;
-        if (noHttps) {
-            server = node_http.createServer(defaultOptions, effectiveHandler);
-        }
-        else {
-            const { cert, private: key, public: ca } = await generateCertificate();
-            encodedCaCert = plModelCommon.base64Encode(cert);
-            server = node_https.createServer({ ...defaultOptions, cert, key, ca }, effectiveHandler);
-        }
-        server
-            .on('listening', () => {
-            // Cast is safe by specification <https://nodejs.org/api/net.html#serveraddress>
-            const url = createObjectStoreUrl(server.address(), noHttps);
-            stopped = new helpers.Deferred();
-            started.resolve({
-                get info() {
-                    return { url, authToken, encodedCaCert };
-                },
-                get stopped() {
-                    return stopped.promise;
-                },
-                stop() {
-                    server.close();
-                    return stopped.promise;
-                }
-            });
-        })
-            .on('error', (err) => {
-            started.reject(err);
-            stopped?.reject(err);
-        })
-            .on('close', () => stopped?.resolve())
-            .listen({
-            host: 'localhost',
-            port
-        });
-    }
-    catch (error) {
-        started.reject(plModelCommon.ensureError(error));
-    }
-    return started.promise;
-}
-
-exports.serve = serve;
-//# sourceMappingURL=serve.cjs.map