@milaboratories/pframes-rs-serv 1.1.0 → 1.1.2

package/dist/handler.js

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

@@ -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  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":";;;;;;;;;;;AAsBA;AACA,SAAS,aAAa,CACpB,OAAwB,EACxB,QAAwB,EACxB,KAAiC,EAAA;;AAGjC,IAAA,QAAQ,CAAC,QAAQ,GAAG,IAAI;;AAExB,IAAA,QAAQ,CAAC,mBAAmB,GAAG,IAAI;IACnC,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;;;IAI/C,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC;;AAGrE,IAAA,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM;AAC7B,IAAA,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE;QACxB,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC;AACvD,QAAA,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,GAAG,EAAE;IACnE;AAEA,IAAA,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC;AAC5C,IAAA,IAAI,QAAQ,KAAK,IAAI,EAAE;AACrB,QAAA,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE;IACvD;;IAGA,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC;IACrE,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC;;AAGnE,IAAA,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;;IAEjC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;;IAE1B,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC;IACrE,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC;AACzC,IAAA,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;AAEhE,IAAA,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;;;IAGpC,IAAI,OAAO,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE;AAC3C,QAAA,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,GAAG,EAAE;IACrE;;;SAGK,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE;AACzC,QAAA,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE;IAC9D;AAEA,IAAA,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC;AACjC,IAAA,IAAI,KAAK,KAAK,IAAI,EAAE;AAClB,QAAA,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE;IAC7D;AAEA,IAAA,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE;AAC7C,IAAA,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,eAAe,CAAC,KAAK,EAAE,CAAC;AAClD,IAAA,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM;AAErC,IAAA,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE;QACtB,MAAM;QACN,KAAK;QACL,MAAM;;AAEN,QAAA,QAAQ,EAAE,OAAO,MAAM,KAAI;AACzB,YAAA,IAAI,OAAO,CAAC,SAAS,EAAE;;AAErB,gBAAA,IAAI,QAAQ,CAAC,SAAS,EAAE;oBACtB;gBACF;AAAO,qBAAA,IAAI,QAAQ,CAAC,WAAW,EAAE;AAC/B,oBAAA,OAAO,KAAK,QAAQ,CAAC,GAAG,EAAE;gBAC5B;qBAAO;oBACL,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC;AACjE,oBAAA,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,GAAG,EAAE;gBACjE;YACF;AAEA,YAAA,QAAQ,MAAM,CAAC,IAAI;AACjB,gBAAA,KAAK,eAAe;;AAElB,oBAAA,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,GAAG,EAAE;AACtE,gBAAA,KAAK,UAAU;;AAEb,oBAAA,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE;AAC3D,gBAAA,KAAK,qBAAqB;;AAExB,oBAAA,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,EAAE,CAAA,QAAA,EAAW,MAAM,CAAC,IAAI,CAAA,CAAE,CAAC;AACrE,oBAAA,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,GAAG,EAAE;;YAKxE,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;;AAEjC,gBAAA,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,GAAG,EAAE;YACjE;YAEA,IAAI,KAAK,EAAE;;gBAET,QAAQ,CAAC,SAAS,CAChB,UAAU,CAAC,aAAa,EACxB,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAC1C;gBACD,QAAQ,CAAC,SAAS,CAChB,UAAU,CAAC,YAAY,EACvB,CAAA,MAAA,EAAS,MAAM,CAAC,KAAK,CAAC,KAAK,CAAA,CAAA,EAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAA,CAAA,EAAI,MAAM,CAAC,IAAI,CAAA,CAAE,CACjE;AACD,gBAAA,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,cAAc,CAAC;YAC/C;iBAAO;;gBAEL,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC;AACzD,gBAAA,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC;;AAGA,YAAA,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE;AAClB,gBAAA,OAAO,KAAK,QAAQ,CAAC,GAAG,EAAE;YAC5B;AAEA,YAAA,IAAI;AACF,gBAAA,OAAO,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC;YAC3D;YAAE,OAAO,KAAc,EAAE;AACvB,gBAAA,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;AAAE,oBAAA,MAAM,KAAK;YACvC;QACF;AACD,KAAA,CAAC;AACJ;AAEA;;;;;;;;AAQG;AACG,SAAU,oBAAoB,CAClC,OAA6C,EAAA;AAE7C,IAAA,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO;AACzB,IAAA,OAAO,CAAC,OAAO,EAAE,QAAQ,KAAK,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC;AACvE;AAEA;AACA,SAAS,gBAAgB,CACvB,OAAwB,EACxB,QAAwB,EACxB,OAAwB,EACxB,UAAkB,EAAA;;AAGlB,IAAA,QAAQ,CAAC,QAAQ,GAAG,IAAI;;AAExB,IAAA,QAAQ,CAAC,mBAAmB,GAAG,IAAI;IACnC,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;;IAG/C,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC;;IAG9D,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE;;QAE9D,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,eAAe,EAAE,WAAW,CAAC,eAAe,CAAC;AAC3E,QAAA,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE;IAC/D;;;AAIA,IAAA,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE;IACjC,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;IACnD,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;AAEjD,IAAA,IACE,cAAc,CAAC,UAAU,KAAK,cAAc,CAAC,UAAU;AACvD,QAAA,CAAC,eAAe,CAAC,cAAc,EAAE,cAAc,CAAC,EAChD;QACA,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,eAAe,EAAE,WAAW,CAAC,eAAe,CAAC;AAC3E,QAAA,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE;IAC/D;AAEA,IAAA,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;AACnC;AAEA;AACM,SAAU,uBAAuB,CACrC,OAAwB,EACxB,SAAgD,EAAA;AAEhD,IAAA,MAAM,UAAU,GAAG,CAAA,OAAA,EAAU,SAAS,EAAE;AACxC,IAAA,OAAO,CAAC,OAAO,EAAE,QAAQ,KACvB,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC;AAC5D;;;;"}

package/dist/index.cjs

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

@@ -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 { ParquetServer, 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,109 @@
+'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

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

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

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

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

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

@@ -0,0 +1,103 @@
+'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() {
+    return await 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
+                ]
+            }
+        ]
+    });
+}
+/** 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

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} 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  return await generate([{ name: 'commonName', value: 'localhost' }], {\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}\n\n/** Create an object store URL from the server address info. */\nfunction createObjectStoreUrl(\n  info: AddressInfo,\n  noHttps?: true\n): PFrameInternal.ObjectStoreUrl {\n  const protocol = noHttps ? '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      return `${protocol}://localhost:${info.port}/` as PFrameInternal.ObjectStoreUrl;\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  noHttps,\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 encodedCaCert: Base64Encoded<PFrameInternal.PemCertificate> | undefined;\n    const defaultOptions: ServerOptions = {\n      keepAlive: true\n    };\n    let server: HttpServer | HttpsServer;\n\n    if (noHttps) {\n      server = createHttpServer(defaultOptions, effectiveHandler);\n    } else {\n      const { cert, private: key, public: ca } = await generateCertificate();\n      encodedCaCert = base64Encode(cert as PFrameInternal.PemCertificate);\n      server = createHttpsServer(\n        { ...defaultOptions, cert, key, ca },\n        effectiveHandler\n      );\n    }\n\n    server\n      .on('listening', () => {\n        // Cast is safe by specification <https://nodejs.org/api/net.html#serveraddress>\n        const url = createObjectStoreUrl(\n          server.address() as AddressInfo,\n          noHttps\n        );\n        stopped = new Deferred<void>();\n\n        started.resolve({\n          get info(): PFrameInternal.HttpServerInfo {\n            return { url, authToken, encodedCaCert };\n          },\n          get stopped(): Promise<void> {\n            return stopped!.promise;\n          },\n          stop(): Promise<void> {\n            server.close();\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      });\n  } catch (error: unknown) {\n    started.reject(ensureError(error));\n  }\n\n  return started.promise;\n}\n"],"names":["generate","handler","Deferred","randomUUID","authorizeRequestHandler","createHttpServer","base64Encode","createHttpsServer","ensureError"],"mappings":"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"}