@milaboratories/pframes-rs-serv 1.1.0 → 1.1.2

package/dist/serve.d.ts

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

package/dist/serve.d.ts.map

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

package/dist/serve.js

@@ -0,0 +1,101 @@
+import { createServer } from 'node:http';
+import { createServer as createServer$1 } from 'node:https';
+import { Deferred } from '@milaboratories/helpers';
+import { base64Encode, ensureError } from '@milaboratories/pl-model-common';
+import { generate } from 'selfsigned';
+import { randomUUID } from 'node:crypto';
+import { authorizeRequestHandler } from './handler.js';
+
+/** Generate a self-signed certificate for localhost */
+async function generateCertificate() {
+    return await 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, port = 0, noHttps, noAuth }) {
+    const started = new Deferred();
+    try {
+        let stopped = null;
+        let authToken;
+        let effectiveHandler = handler;
+        if (!noAuth) {
+            authToken = randomUUID();
+            effectiveHandler = authorizeRequestHandler(effectiveHandler, authToken);
+        }
+        // Create HTTP server
+        let encodedCaCert;
+        const defaultOptions = {
+            keepAlive: true
+        };
+        let server;
+        if (noHttps) {
+            server = createServer(defaultOptions, effectiveHandler);
+        }
+        else {
+            const { cert, private: key, public: ca } = await generateCertificate();
+            encodedCaCert = base64Encode(cert);
+            server = createServer$1({ ...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 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(ensureError(error));
+    }
+    return started.promise;
+}
+
+export { serve };
+//# sourceMappingURL=serve.js.map

package/dist/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sources":["../src/serve.ts"],"sourcesContent":["import {\n  createServer as createHttpServer,\n  type RequestListener,\n  type Server as HttpServer,\n  type ServerOptions\n} from 'node:http';\nimport {\n  createServer as createHttpsServer,\n  type Server as HttpsServer\n} from 'node:https';\nimport type { AddressInfo } from 'node:net';\nimport { Deferred } from '@milaboratories/helpers';\nimport type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';\nimport {\n  base64Encode,\n  Base64Encoded,\n  ensureError\n} 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":["createHttpServer","createHttpsServer"],"mappings":"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"}

package/dist/utils/etag.cjs

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

package/dist/utils/etag.cjs.map

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

package/dist/utils/etag.d.ts

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

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

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

package/dist/utils/etag.js

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

package/dist/utils/etag.js.map

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

package/dist/utils/filename.cjs

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

package/dist/utils/filename.cjs.map

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

package/dist/utils/filename.d.ts

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

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

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

package/dist/utils/filename.js

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

package/dist/utils/filename.js.map

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

package/dist/utils/headers.cjs

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

package/dist/utils/headers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.cjs","sources":["../../src/utils/headers.ts"],"sourcesContent":["/** HTTP header names used in the parquet server handler */\nexport const HeaderName = {\n  Accept: 'accept',\n  AcceptRanges: 'accept-ranges',\n  Allow: 'allow',\n  Authorization: 'authorization',\n  CacheControl: 'cache-control',\n  Connection: 'connection',\n  ContentLength: 'content-length',\n  ContentRange: 'content-range',\n  ContentType: 'content-type',\n  Date: 'date',\n  ETag: 'etag',\n  IfMatch: 'if-match',\n  IfModifiedSince: 'if-modified-since',\n  IfNoneMatch: 'if-none-match',\n  IfUnmodifiedSince: 'if-unmodified-since',\n  LastModified: 'last-modified',\n  Range: 'range',\n  WWWAuthenticate: 'www-authenticate'\n} as const;\n\n/** HTTP header values used in the parquet server handler */\nexport const HeaderValue = {\n  AcceptRanges: 'bytes',\n  Allow: 'GET, HEAD',\n  CacheControl: 'public, immutable, max-age=31536000',\n  Connection: 'close',\n  ContentType: 'application/octet-stream',\n  WWWAuthenticate: 'Bearer realm=\"parquet-server\"'\n} as const;\n"],"names":[],"mappings":";;AAAA;AACO,MAAM,UAAU,GAAG;AACxB,IACA,YAAY,EAAE,eAAe;AAC7B,IAAA,KAAK,EAAE,OAAO;AACd,IAAA,aAAa,EAAE,eAAe;AAC9B,IAAA,YAAY,EAAE,eAAe;AAC7B,IAAA,UAAU,EAAE,YAAY;AACxB,IAAA,aAAa,EAAE,gBAAgB;AAC/B,IAAA,YAAY,EAAE,eAAe;AAC7B,IAAA,WAAW,EAAE,cAAc;AAC3B,IACA,IAAI,EAAE,MAAM;AACZ,IAIA,YAAY,EAAE,eAAe;AAC7B,IACA,eAAe,EAAE;;AAGnB;AACO,MAAM,WAAW,GAAG;AACzB,IAAA,YAAY,EAAE,OAAO;AACrB,IAAA,KAAK,EAAE,WAAW;AAClB,IAAA,YAAY,EAAE,qCAAqC;AACnD,IAAA,UAAU,EAAE,OAAO;AACnB,IAAA,WAAW,EAAE,0BAA0B;AACvC,IAAA,eAAe,EAAE;;;;;;"}

package/dist/utils/headers.d.ts

@@ -0,0 +1,31 @@
+/** HTTP header names used in the parquet server handler */
+export declare const HeaderName: {
+    readonly Accept: "accept";
+    readonly AcceptRanges: "accept-ranges";
+    readonly Allow: "allow";
+    readonly Authorization: "authorization";
+    readonly CacheControl: "cache-control";
+    readonly Connection: "connection";
+    readonly ContentLength: "content-length";
+    readonly ContentRange: "content-range";
+    readonly ContentType: "content-type";
+    readonly Date: "date";
+    readonly ETag: "etag";
+    readonly IfMatch: "if-match";
+    readonly IfModifiedSince: "if-modified-since";
+    readonly IfNoneMatch: "if-none-match";
+    readonly IfUnmodifiedSince: "if-unmodified-since";
+    readonly LastModified: "last-modified";
+    readonly Range: "range";
+    readonly WWWAuthenticate: "www-authenticate";
+};
+/** HTTP header values used in the parquet server handler */
+export declare const HeaderValue: {
+    readonly AcceptRanges: "bytes";
+    readonly Allow: "GET, HEAD";
+    readonly CacheControl: "public, immutable, max-age=31536000";
+    readonly Connection: "close";
+    readonly ContentType: "application/octet-stream";
+    readonly WWWAuthenticate: "Bearer realm=\"parquet-server\"";
+};
+//# sourceMappingURL=headers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/utils/headers.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;CAmBb,CAAC;AAEX,4DAA4D;AAC5D,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC"}

package/dist/utils/headers.js

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

package/dist/utils/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sources":["../../src/utils/headers.ts"],"sourcesContent":["/** HTTP header names used in the parquet server handler */\nexport const HeaderName = {\n  Accept: 'accept',\n  AcceptRanges: 'accept-ranges',\n  Allow: 'allow',\n  Authorization: 'authorization',\n  CacheControl: 'cache-control',\n  Connection: 'connection',\n  ContentLength: 'content-length',\n  ContentRange: 'content-range',\n  ContentType: 'content-type',\n  Date: 'date',\n  ETag: 'etag',\n  IfMatch: 'if-match',\n  IfModifiedSince: 'if-modified-since',\n  IfNoneMatch: 'if-none-match',\n  IfUnmodifiedSince: 'if-unmodified-since',\n  LastModified: 'last-modified',\n  Range: 'range',\n  WWWAuthenticate: 'www-authenticate'\n} as const;\n\n/** HTTP header values used in the parquet server handler */\nexport const HeaderValue = {\n  AcceptRanges: 'bytes',\n  Allow: 'GET, HEAD',\n  CacheControl: 'public, immutable, max-age=31536000',\n  Connection: 'close',\n  ContentType: 'application/octet-stream',\n  WWWAuthenticate: 'Bearer realm=\"parquet-server\"'\n} as const;\n"],"names":[],"mappings":"AAAA;AACO,MAAM,UAAU,GAAG;AACxB,IACA,YAAY,EAAE,eAAe;AAC7B,IAAA,KAAK,EAAE,OAAO;AACd,IAAA,aAAa,EAAE,eAAe;AAC9B,IAAA,YAAY,EAAE,eAAe;AAC7B,IAAA,UAAU,EAAE,YAAY;AACxB,IAAA,aAAa,EAAE,gBAAgB;AAC/B,IAAA,YAAY,EAAE,eAAe;AAC7B,IAAA,WAAW,EAAE,cAAc;AAC3B,IACA,IAAI,EAAE,MAAM;AACZ,IAIA,YAAY,EAAE,eAAe;AAC7B,IACA,eAAe,EAAE;;AAGnB;AACO,MAAM,WAAW,GAAG;AACzB,IAAA,YAAY,EAAE,OAAO;AACrB,IAAA,KAAK,EAAE,WAAW;AAClB,IAAA,YAAY,EAAE,qCAAqC;AACnD,IAAA,UAAU,EAAE,OAAO;AACnB,IAAA,WAAW,EAAE,0BAA0B;AACvC,IAAA,eAAe,EAAE;;;;;"}

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+export * from './filename';
+export * from './etag';
+export * from './headers';
+export * from './options';
+export * from './range';
+export * from './method';
+export * from './status';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/utils/method.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+function isGetOrHead(method) {
+    return method === 'GET' || method === 'HEAD';
+}
+function isGet(method) {
+    return method === 'GET';
+}
+function isHead(method) {
+    return method === 'HEAD';
+}
+
+exports.isGet = isGet;
+exports.isGetOrHead = isGetOrHead;
+exports.isHead = isHead;
+//# sourceMappingURL=method.cjs.map

package/dist/utils/method.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"method.cjs","sources":["../../src/utils/method.ts"],"sourcesContent":["import type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';\nimport type { IncomingHttpHeaders } from 'node:http';\n\nexport function isGetOrHead(\n  method: IncomingHttpHeaders['method']\n): method is PFrameInternal.HttpMethod {\n  return method === 'GET' || method === 'HEAD';\n}\n\nexport function isGet(\n  method: PFrameInternal.HttpMethod\n): method is Extract<PFrameInternal.HttpMethod, 'GET'> {\n  return method === 'GET';\n}\n\nexport function isHead(\n  method: PFrameInternal.HttpMethod\n): method is Extract<PFrameInternal.HttpMethod, 'HEAD'> {\n  return method === 'HEAD';\n}\n"],"names":[],"mappings":";;AAGM,SAAU,WAAW,CACzB,MAAqC,EAAA;AAErC,IAAA,OAAO,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM;AAC9C;AAEM,SAAU,KAAK,CACnB,MAAiC,EAAA;IAEjC,OAAO,MAAM,KAAK,KAAK;AACzB;AAEM,SAAU,MAAM,CACpB,MAAiC,EAAA;IAEjC,OAAO,MAAM,KAAK,MAAM;AAC1B;;;;;;"}

package/dist/utils/method.d.ts

@@ -0,0 +1,6 @@
+import type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';
+import type { IncomingHttpHeaders } from 'node:http';
+export declare function isGetOrHead(method: IncomingHttpHeaders['method']): method is PFrameInternal.HttpMethod;
+export declare function isGet(method: PFrameInternal.HttpMethod): method is Extract<PFrameInternal.HttpMethod, 'GET'>;
+export declare function isHead(method: PFrameInternal.HttpMethod): method is Extract<PFrameInternal.HttpMethod, 'HEAD'>;
+//# sourceMappingURL=method.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"method.d.ts","sourceRoot":"","sources":["../../src/utils/method.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,wBAAgB,WAAW,CACzB,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GACpC,MAAM,IAAI,cAAc,CAAC,UAAU,CAErC;AAED,wBAAgB,KAAK,CACnB,MAAM,EAAE,cAAc,CAAC,UAAU,GAChC,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,CAErD;AAED,wBAAgB,MAAM,CACpB,MAAM,EAAE,cAAc,CAAC,UAAU,GAChC,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,CAEtD"}

package/dist/utils/method.js

@@ -0,0 +1,12 @@
+function isGetOrHead(method) {
+    return method === 'GET' || method === 'HEAD';
+}
+function isGet(method) {
+    return method === 'GET';
+}
+function isHead(method) {
+    return method === 'HEAD';
+}
+
+export { isGet, isGetOrHead, isHead };
+//# sourceMappingURL=method.js.map

package/dist/utils/method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"method.js","sources":["../../src/utils/method.ts"],"sourcesContent":["import type { PFrameInternal } from '@milaboratories/pl-model-middle-layer';\nimport type { IncomingHttpHeaders } from 'node:http';\n\nexport function isGetOrHead(\n  method: IncomingHttpHeaders['method']\n): method is PFrameInternal.HttpMethod {\n  return method === 'GET' || method === 'HEAD';\n}\n\nexport function isGet(\n  method: PFrameInternal.HttpMethod\n): method is Extract<PFrameInternal.HttpMethod, 'GET'> {\n  return method === 'GET';\n}\n\nexport function isHead(\n  method: PFrameInternal.HttpMethod\n): method is Extract<PFrameInternal.HttpMethod, 'HEAD'> {\n  return method === 'HEAD';\n}\n"],"names":[],"mappings":"AAGM,SAAU,WAAW,CACzB,MAAqC,EAAA;AAErC,IAAA,OAAO,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM;AAC9C;AAEM,SAAU,KAAK,CACnB,MAAiC,EAAA;IAEjC,OAAO,MAAM,KAAK,KAAK;AACzB;AAEM,SAAU,MAAM,CACpB,MAAiC,EAAA;IAEjC,OAAO,MAAM,KAAK,MAAM;AAC1B;;;;"}

package/dist/utils/options.cjs

@@ -0,0 +1,135 @@
+'use strict';
+
+class EtagMatch {
+    etagMatch;
+    constructor(etagMatch) {
+        this.etagMatch = etagMatch;
+    }
+    static parse(etagMatch) {
+        if (etagMatch === undefined)
+            return null;
+        if (etagMatch === '*') {
+            return new EtagMatch({ type: 'wildcard' });
+        }
+        else {
+            return new EtagMatch({
+                type: 'match',
+                value: etagMatch.split(',').map((etag) => etag.trim())
+            });
+        }
+    }
+    matches(etag) {
+        switch (this.etagMatch.type) {
+            case 'match':
+                return this.etagMatch.value.includes(etag);
+            case 'wildcard':
+                return true;
+        }
+    }
+}
+class DateMatch {
+    mtime;
+    constructor(mtime) {
+        this.mtime = mtime;
+    }
+    static parse(dateMatch) {
+        if (dateMatch === undefined)
+            return null;
+        const time = Date.parse(dateMatch);
+        if (isNaN(time))
+            return null;
+        return new DateMatch(new Date(time));
+    }
+    matches(mtime) {
+        return this.mtime.getTime() / 1_000 === mtime.getTime() / 1_000;
+    }
+}
+class Options {
+    /**
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#name-if-match>
+     *
+     * Examples:
+     *
+     * ```text
+     * If-Match: "xyzzy"
+     * If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
+     * If-Match: *
+     * ```
+     */
+    ifMatch;
+    /**
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.2>
+     *
+     * Examples:
+     *
+     * ```text
+     * If-None-Match: "xyzzy"
+     * If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
+     * If-None-Match: *
+     * ```
+     */
+    ifNoneMatch;
+    /**
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.3>
+     *
+     * Examples:
+     *
+     * ```text
+     * If-Modified-Since: Mon, 07 Jan 2002 19:43:36 GMT
+     * ```
+     */
+    ifModifiedSince;
+    /**
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.4>
+     *
+     * Examples:
+     *
+     * ```text
+     * If-Unmodified-Since: Mon, 07 Jan 2002 19:43:36 GMT
+     * ```
+     */
+    ifUnmodifiedSince;
+    constructor(request) {
+        this.ifMatch = EtagMatch.parse(request.headers['if-match']);
+        this.ifNoneMatch = EtagMatch.parse(request.headers['if-none-match']);
+        this.ifModifiedSince = DateMatch.parse(request.headers['if-modified-since']);
+        this.ifUnmodifiedSince = DateMatch.parse(request.headers['if-unmodified-since']);
+    }
+    /**
+     * RFC 9110 section 13.1.1: If-Match precondition evaluation
+     * RFC 9110 section 13.1.4: If-Unmodified-Since precondition evaluation
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.1>
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.4>
+     */
+    preconditionFailed(etag, mtime) {
+        // If-Match precondition takes precedence
+        if (this.ifMatch !== null && !this.ifMatch.matches(etag)) {
+            return true;
+        }
+        // If-Unmodified-Since precondition (only if no If-Match header)
+        if (this.ifMatch === null && this.ifUnmodifiedSince !== null) {
+            return !this.ifUnmodifiedSince.matches(mtime);
+        }
+        return false;
+    }
+    /**
+     * RFC 9110 section 13.1.2: If-None-Match precondition evaluation
+     * RFC 9110 section 13.1.3: If-Modified-Since precondition evaluation
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.2>
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.3>
+     */
+    notModified(etag, mtime) {
+        // If-None-Match takes precedence over If-Modified-Since
+        if (this.ifNoneMatch !== null) {
+            return this.ifNoneMatch.matches(etag);
+        }
+        // If-Modified-Since (only if no If-None-Match header)
+        if (this.ifModifiedSince !== null) {
+            return this.ifModifiedSince.matches(mtime);
+        }
+        return false;
+    }
+}
+
+exports.Options = Options;
+//# sourceMappingURL=options.cjs.map

package/dist/utils/options.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.cjs","sources":["../../src/utils/options.ts"],"sourcesContent":["import type { IncomingMessage } from 'node:http';\nimport type { Etag } from './etag';\n\ntype EtagMatchType =\n  | {\n      type: 'match';\n      value: Etag[];\n    }\n  | {\n      type: 'wildcard';\n    };\n\nclass EtagMatch {\n  private constructor(private readonly etagMatch: EtagMatchType) {}\n\n  static parse(etagMatch: string | undefined): EtagMatch | null {\n    if (etagMatch === undefined) return null;\n    if (etagMatch === '*') {\n      return new EtagMatch({ type: 'wildcard' });\n    } else {\n      return new EtagMatch({\n        type: 'match',\n        value: etagMatch.split(',').map((etag) => etag.trim() as Etag)\n      });\n    }\n  }\n\n  matches(etag: Etag): boolean {\n    switch (this.etagMatch.type) {\n      case 'match':\n        return this.etagMatch.value.includes(etag);\n      case 'wildcard':\n        return true;\n    }\n  }\n}\n\nclass DateMatch {\n  private constructor(private readonly mtime: Date) {}\n\n  static parse(dateMatch: string | undefined): DateMatch | null {\n    if (dateMatch === undefined) return null;\n    const time = Date.parse(dateMatch);\n    if (isNaN(time)) return null;\n    return new DateMatch(new Date(time));\n  }\n\n  matches(mtime: Date): boolean {\n    return this.mtime.getTime() / 1_000 === mtime.getTime() / 1_000;\n  }\n}\n\nexport class Options {\n  /**\n   * See <https://datatracker.ietf.org/doc/html/rfc9110#name-if-match>\n   *\n   * Examples:\n   *\n   * ```text\n   * If-Match: \"xyzzy\"\n   * If-Match: \"xyzzy\", \"r2d2xxxx\", \"c3piozzzz\"\n   * If-Match: *\n   * ```\n   */\n  private ifMatch: EtagMatch | null;\n\n  /**\n   * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.2>\n   *\n   * Examples:\n   *\n   * ```text\n   * If-None-Match: \"xyzzy\"\n   * If-None-Match: \"xyzzy\", \"r2d2xxxx\", \"c3piozzzz\"\n   * If-None-Match: *\n   * ```\n   */\n  private ifNoneMatch: EtagMatch | null;\n\n  /**\n   * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.3>\n   *\n   * Examples:\n   *\n   * ```text\n   * If-Modified-Since: Mon, 07 Jan 2002 19:43:36 GMT\n   * ```\n   */\n  private ifModifiedSince: DateMatch | null;\n\n  /**\n   * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.4>\n   *\n   * Examples:\n   *\n   * ```text\n   * If-Unmodified-Since: Mon, 07 Jan 2002 19:43:36 GMT\n   * ```\n   */\n  private ifUnmodifiedSince: DateMatch | null;\n\n  constructor(request: IncomingMessage) {\n    this.ifMatch = EtagMatch.parse(request.headers['if-match']);\n    this.ifNoneMatch = EtagMatch.parse(request.headers['if-none-match']);\n    this.ifModifiedSince = DateMatch.parse(\n      request.headers['if-modified-since']\n    );\n    this.ifUnmodifiedSince = DateMatch.parse(\n      request.headers['if-unmodified-since']\n    );\n  }\n\n  /**\n   * RFC 9110 section 13.1.1: If-Match precondition evaluation\n   * RFC 9110 section 13.1.4: If-Unmodified-Since precondition evaluation\n   * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.1>\n   * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.4>\n   */\n  preconditionFailed(etag: Etag, mtime: Date): boolean {\n    // If-Match precondition takes precedence\n    if (this.ifMatch !== null && !this.ifMatch.matches(etag)) {\n      return true;\n    }\n\n    // If-Unmodified-Since precondition (only if no If-Match header)\n    if (this.ifMatch === null && this.ifUnmodifiedSince !== null) {\n      return !this.ifUnmodifiedSince.matches(mtime);\n    }\n\n    return false;\n  }\n\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   * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.2>\n   * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.3>\n   */\n  notModified(etag: Etag, mtime: Date): boolean {\n    // If-None-Match takes precedence over If-Modified-Since\n    if (this.ifNoneMatch !== null) {\n      return this.ifNoneMatch.matches(etag);\n    }\n\n    // If-Modified-Since (only if no If-None-Match header)\n    if (this.ifModifiedSince !== null) {\n      return this.ifModifiedSince.matches(mtime);\n    }\n\n    return false;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/utils/options.d.ts

@@ -0,0 +1,64 @@
+import type { IncomingMessage } from 'node:http';
+import type { Etag } from './etag';
+export declare class Options {
+    /**
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#name-if-match>
+     *
+     * Examples:
+     *
+     * ```text
+     * If-Match: "xyzzy"
+     * If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
+     * If-Match: *
+     * ```
+     */
+    private ifMatch;
+    /**
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.2>
+     *
+     * Examples:
+     *
+     * ```text
+     * If-None-Match: "xyzzy"
+     * If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
+     * If-None-Match: *
+     * ```
+     */
+    private ifNoneMatch;
+    /**
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.3>
+     *
+     * Examples:
+     *
+     * ```text
+     * If-Modified-Since: Mon, 07 Jan 2002 19:43:36 GMT
+     * ```
+     */
+    private ifModifiedSince;
+    /**
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.4>
+     *
+     * Examples:
+     *
+     * ```text
+     * If-Unmodified-Since: Mon, 07 Jan 2002 19:43:36 GMT
+     * ```
+     */
+    private ifUnmodifiedSince;
+    constructor(request: IncomingMessage);
+    /**
+     * RFC 9110 section 13.1.1: If-Match precondition evaluation
+     * RFC 9110 section 13.1.4: If-Unmodified-Since precondition evaluation
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.1>
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.4>
+     */
+    preconditionFailed(etag: Etag, mtime: Date): boolean;
+    /**
+     * RFC 9110 section 13.1.2: If-None-Match precondition evaluation
+     * RFC 9110 section 13.1.3: If-Modified-Since precondition evaluation
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.2>
+     * See <https://datatracker.ietf.org/doc/html/rfc9110#section-13.1.3>
+     */
+    notModified(etag: Etag, mtime: Date): boolean;
+}
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/utils/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAmDnC,qBAAa,OAAO;IAClB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,OAAO,CAAmB;IAElC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW,CAAmB;IAEtC;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe,CAAmB;IAE1C;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB,CAAmB;gBAEhC,OAAO,EAAE,eAAe;IAWpC;;;;;OAKG;IACH,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO;IAcpD;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO;CAa9C"}