svelteesp32 1.13.1 → 1.14.0

package/README.md

@@ -14,15 +14,15 @@ This npm package provides a solution for **inserting any JS client application i
 
 **Quick Comparison:**
 
-| Feature               | SvelteESP32                             | Traditional Filesystem (SPIFFS/LittleFS) |
-| --------------------- | --------------------------------------- | ---------------------------------------- |
-| **Single Binary OTA** | ✓ Everything embedded in firmware       | ✗ Requires separate partition upload     |
-| **Gzip Compression**  | ✓ Automatic build-time (>15% reduction) | Manual or runtime compression            |
-| **ETag Support**      | ✓ Built-in MD5 ETags with 304 responses | Manual implementation required           |
-| **CI/CD Integration** | ✓ npm package, simple build step        | Complex with upload_fs tools             |
-| **Memory Efficiency** | Flash only (PROGMEM/const arrays)       | Flash partition + filesystem overhead    |
-| **Performance**       | Direct byte array serving               | Filesystem read overhead                 |
-| **Setup Complexity**  | Include header, call init function      | Partition setup, upload tools, handlers  |
+| Feature               | SvelteESP32                                | Traditional Filesystem (SPIFFS/LittleFS) |
+| --------------------- | ------------------------------------------ | ---------------------------------------- |
+| **Single Binary OTA** | ✓ Everything embedded in firmware          | ✗ Requires separate partition upload     |
+| **Gzip Compression**  | ✓ Automatic build-time (>15% reduction)    | Manual or runtime compression            |
+| **ETag Support**      | ✓ Built-in SHA256 ETags with 304 responses | Manual implementation required           |
+| **CI/CD Integration** | ✓ npm package, simple build step           | Complex with upload_fs tools             |
+| **Memory Efficiency** | Flash only (PROGMEM/const arrays)          | Flash partition + filesystem overhead    |
+| **Performance**       | Direct byte array serving                  | Filesystem read overhead                 |
+| **Setup Complexity**  | Include header, call init function         | Partition setup, upload tools, handlers  |
 
 **When to use:**
 
@@ -240,6 +240,21 @@ const uint8_t datagzip_assets_index_KwubEIf__js[12547] = {0x1f, 0x8b, 0x8, 0x0,
 const uint8_t datagzip_assets_index_Soe6cpLA_css[5368] = {0x1f, 0x8b, 0x8, 0x0, 0x0, ...
 const char * etag_assets_index_KwubEIf__js = "387b88e345cc56ef9091...";
 const char * etag_assets_index_Soe6cpLA_css = "d4f23bc45ef67890ab12...";
+
+// File manifest for runtime introspection
+struct SVELTEESP32_FileInfo {
+  const char* path;
+  uint32_t size;
+  uint32_t gzipSize;
+  const char* etag;
+  const char* contentType;
+};
+const SVELTEESP32_FileInfo SVELTEESP32_FILES[] = {
+  { "/assets/index-KwubEIf-.js", 38850, 12547, etag_assets_index_KwubEIf__js, "text/javascript" },
+  { "/assets/index-Soe6cpLA.css", 32494, 5368, etag_assets_index_Soe6cpLA_css, "text/css" },
+  ...
+};
+const size_t SVELTEESP32_FILE_COUNT = sizeof(SVELTEESP32_FILES) / sizeof(SVELTEESP32_FILES[0]);
 ...
 
 void initSvelteStaticFiles(PsychicHttpServer * server) {
@@ -445,6 +460,74 @@ You can include a blocker error if a named file accidentally missing from the bu
 
 You can use the following c++ directives at the project level if you want to configure the usage there: `SVELTEESP32_ENABLE_ETAG` and `SVELTEESP32_ENABLE_GZIP`. (Do not forget `--etag=compiler` or `--gzip=compiler` command line arg!)
 
+### File Manifest
+
+The generated header includes a file manifest struct and array that allows runtime introspection of all embedded static assets. This is useful for logging, runtime diagnostics, or building a JSON endpoint that lists all served files.
+
+**Generated Structure:**
+
+```c
+// File manifest struct
+struct SVELTEESP32_FileInfo {
+  const char* path;       // URL path (e.g., "/index.html")
+  uint32_t size;          // Original file size in bytes
+  uint32_t gzipSize;      // Compressed size (0 if not gzipped)
+  const char* etag;       // ETag pointer (nullptr if etag disabled)
+  const char* contentType; // MIME type (e.g., "text/html")
+};
+
+// File manifest array
+const SVELTEESP32_FileInfo SVELTEESP32_FILES[] = { ... };
+const size_t SVELTEESP32_FILE_COUNT = sizeof(SVELTEESP32_FILES) / sizeof(SVELTEESP32_FILES[0]);
+```
+
+**Usage Example - List All Files:**
+
+```c
+#include "svelteesp32.h"
+
+void listFiles() {
+  Serial.printf("Embedded files (%d):\n", SVELTEESP32_FILE_COUNT);
+  for (size_t i = 0; i < SVELTEESP32_FILE_COUNT; i++) {
+    const auto& f = SVELTEESP32_FILES[i];
+    Serial.printf("  %s (%d bytes", f.path, f.size);
+    if (f.gzipSize > 0) {
+      Serial.printf(", gzip: %d bytes", f.gzipSize);
+    }
+    Serial.printf(", type: %s)\n", f.contentType);
+  }
+}
+```
+
+**Usage Example - JSON Endpoint:**
+
+```c
+server->on("/api/files", HTTP_GET, [](PsychicRequest* request) {
+  String json = "[";
+  for (size_t i = 0; i < SVELTEESP32_FILE_COUNT; i++) {
+    const auto& f = SVELTEESP32_FILES[i];
+    if (i > 0) json += ",";
+    json += "{\"path\":\"" + String(f.path) + "\",";
+    json += "\"size\":" + String(f.size) + ",";
+    json += "\"gzipSize\":" + String(f.gzipSize) + ",";
+    json += "\"contentType\":\"" + String(f.contentType) + "\"}";
+  }
+  json += "]";
+  PsychicResponse response(request);
+  response.setContentType("application/json");
+  response.setContent(json.c_str(), json.length());
+  return response.send();
+});
+```
+
+**Notes:**
+
+- The manifest is always generated (no CLI flag needed)
+- `gzipSize` is 0 when the file is not gzipped (either too small, poor compression ratio, or gzip disabled)
+- `etag` is `NULL` when etag is disabled (`--etag=false`)
+- The struct and array names use the `--define` prefix (default: `SVELTEESP32`)
+- For ESP-IDF engine, C-compatible `typedef struct` syntax is used instead of C++ `struct`
+
 ### Command line options
 
 | Option             | Description                                                                          | default                 |

package/dist/cppCode.d.ts

@@ -6,7 +6,7 @@ export type CppCodeSource = {
     content: Buffer;
     contentGzip: Buffer;
     isGzip: boolean;
-    md5: string;
+    sha256: string;
 };
 export type CppCodeSources = CppCodeSource[];
 export type ExtensionGroup = {

package/dist/cppCode.js

@@ -81,7 +81,7 @@ const etagArraysSection = `
 {{#switch etag}}
 {{#case "true"}}
   {{#each sources}}
-const char * etag_{{this.dataname}} = "{{this.md5}}";
+const char * etag_{{this.dataname}} = "{{this.sha256}}";
   {{/each}}
 {{/case}}
 {{#case "false"}}
@@ -89,12 +89,30 @@ const char * etag_{{this.dataname}} = "{{this.md5}}";
 {{#case "compiler"}}
 #ifdef {{definePrefix}}_ENABLE_ETAG
   {{#each sources}}
-const char * etag_{{this.dataname}} = "{{this.md5}}";
+const char * etag_{{this.dataname}} = "{{this.sha256}}";
   {{/each}}
 #endif
 {{/case}}
 {{/switch}}
 `;
+const manifestSection = `
+// File manifest struct
+struct {{definePrefix}}_FileInfo {
+  const char* path;
+  uint32_t size;
+  uint32_t gzipSize;
+  const char* etag;
+  const char* contentType;
+};
+
+// File manifest array
+const {{definePrefix}}_FileInfo {{definePrefix}}_FILES[] = {
+{{#each sources}}
+  { "/{{this.filename}}", {{this.length}}, {{this.gzipSizeForManifest}}, {{this.etagForManifest}}, "{{this.mime}}" },
+{{/each}}
+};
+const size_t {{definePrefix}}_FILE_COUNT = sizeof({{definePrefix}}_FILES) / sizeof({{definePrefix}}_FILES[0]);
+`;
 const psychicTemplate = `
 //engine:   PsychicHttpServer
 //config:   {{{config}}}
@@ -116,6 +134,9 @@ ${dataArraysSection(false)}
 //
 ${etagArraysSection}
 
+//
+${manifestSection}
+
 //
 // Http Handlers
 void {{methodName}}(PsychicHttpServer * server) {
@@ -225,6 +246,9 @@ ${dataArraysSection(false)}
 //
 ${etagArraysSection}
 
+//
+${manifestSection}
+
 //
 // Http Handlers
 void {{methodName}}(PsychicHttpServer * server) {
@@ -330,6 +354,9 @@ ${dataArraysSection(true)}
 //
 ${etagArraysSection}
 
+//
+${manifestSection}
+
 //
 // Http Handlers
 void {{methodName}}(AsyncWebServer * server) {
@@ -489,13 +516,15 @@ const getTemplate = (engine) => {
             return asyncTemplate;
     }
 };
-const transformSourceToTemplateData = (s) => ({
+const transformSourceToTemplateData = (s, etag) => ({
     ...s,
     length: s.content.length,
     bytes: [...s.content].map((v) => `${v.toString(10)}`).join(','),
     lengthGzip: s.contentGzip.length,
     bytesGzip: [...s.contentGzip].map((v) => `${v.toString(10)}`).join(','),
-    isDefault: s.filename.startsWith('index.htm')
+    isDefault: s.filename.startsWith('index.htm'),
+    gzipSizeForManifest: s.isGzip ? s.contentGzip.length : 0,
+    etagForManifest: etag === 'false' ? 'NULL' : `etag_${s.dataname}`
 });
 const postProcessCppCode = (code) => code
     .split('\n')
@@ -531,7 +560,7 @@ const getCppCode = (sources, filesByExtension) => {
         fileCount: sources.length.toString(),
         fileSize: sources.reduce((previous, current) => previous + current.content.length, 0).toString(),
         fileGzipSize: sources.reduce((previous, current) => previous + current.contentGzip.length, 0).toString(),
-        sources: sources.map((s) => transformSourceToTemplateData(s)),
+        sources: sources.map((s) => transformSourceToTemplateData(s, commandLine_1.cmdLine.etag)),
         filesByExtension,
         etag: commandLine_1.cmdLine.etag,
         gzip: commandLine_1.cmdLine.gzip,

package/dist/cppCodeEspIdf.d.ts

@@ -1 +1 @@
-export declare const espidfTemplate = "\n//engine:   espidf\n//config:   {{{config}}}\n{{#if created }}\n//created:  {{now}}\n{{/if}}\n//\n\n{{#switch etag}}\n{{#case \"true\"}}\n#ifdef {{definePrefix}}_ENABLE_ETAG\n#warning {{definePrefix}}_ENABLE_ETAG has no effect because it is permanently switched ON\n#endif\n{{/case}}\n{{#case \"false\"}}\n#ifdef {{definePrefix}}_ENABLE_ETAG\n#warning {{definePrefix}}_ENABLE_ETAG has no effect because it is permanently switched OFF\n#endif\n{{/case}}\n{{/switch}}\n\n{{#switch gzip}}\n{{#case \"true\"}}\n#ifdef {{definePrefix}}_ENABLE_GZIP\n#warning {{definePrefix}}_ENABLE_GZIP has no effect because it is permanently switched ON\n#endif\n{{/case}}\n{{#case \"false\"}}\n#ifdef {{definePrefix}}_ENABLE_GZIP\n#warning {{definePrefix}}_ENABLE_GZIP has no effect because it is permanently switched OFF\n#endif\n{{/case}}\n{{/switch}}\n\n//\n{{#if version }}\n#define {{definePrefix}}_VERSION \"{{version}}\"\n{{/if}}\n#define {{definePrefix}}_COUNT {{fileCount}}\n#define {{definePrefix}}_SIZE {{fileSize}}\n#define {{definePrefix}}_SIZE_GZIP {{fileGzipSize}}\n\n//\n{{#each sources}}\n#define {{../definePrefix}}_FILE_{{this.datanameUpperCase}}\n{{/each}}\n\n//\n{{#each filesByExtension}}\n#define {{../definePrefix}}_{{this.extension}}_FILES {{this.count}}\n{{/each}}\n\n#include <stdint.h>\n#include <string.h>\n#include <stdlib.h>\n#include <esp_err.h>\n#include <esp_http_server.h>\n\n//\n{{#switch gzip}}\n{{#case \"true\"}}\n  {{#each sources}}\nconst char datagzip_{{this.dataname}}[{{this.lengthGzip}}] = { {{this.bytesGzip}} };\n  {{/each}}\n{{/case}}\n{{#case \"false\"}}\n  {{#each sources}}\nconst char data_{{this.dataname}}[{{this.length}}] = { {{this.bytes}} };\n  {{/each}}\n{{/case}}\n{{#case \"compiler\"}}\n#ifdef {{definePrefix}}_ENABLE_GZIP\n  {{#each sources}}\nconst char datagzip_{{this.dataname}}[{{this.lengthGzip}}] = { {{this.bytesGzip}} };\n  {{/each}}\n#else\n  {{#each sources}}\nconst char data_{{this.dataname}}[{{this.length}}] = { {{this.bytes}} };\n  {{/each}}\n#endif \n{{/case}}\n{{/switch}}\n\n//\n{{#switch etag}}\n{{#case \"true\"}}\n  {{#each sources}}\nconst char * etag_{{this.dataname}} = \"{{this.md5}}\";\n  {{/each}}\n{{/case}}\n{{#case \"false\"}}\n{{/case}}\n{{#case \"compiler\"}}\n#ifdef {{definePrefix}}_ENABLE_ETAG\n  {{#each sources}}\nconst char * etag_{{this.dataname}} = \"{{this.md5}}\";\n  {{/each}}\n#endif \n{{/case}}\n{{/switch}}\n\n{{#each sources}}\n\nstatic esp_err_t file_handler_{{this.datanameUpperCase}} (httpd_req_t *req)\n{\n{{#switch ../etag}}\n{{#case \"true\"}}\n    size_t hdr_len = httpd_req_get_hdr_value_len(req, \"If-None-Match\");\n    if (hdr_len > 0) {\n        char* hdr_value = malloc(hdr_len + 1);\n        if (httpd_req_get_hdr_value_str(req, \"If-None-Match\", hdr_value, hdr_len + 1) == ESP_OK) {\n            if (strcmp(hdr_value, etag_{{this.dataname}}) == 0) {\n                free(hdr_value);\n                httpd_resp_set_status(req, \"304 Not Modified\");\n                httpd_resp_send(req, NULL, 0);\n                return ESP_OK;\n            }\n        }\n        free(hdr_value);\n    }\n{{/case}}\n{{#case \"compiler\"}}\n  #ifdef {{../definePrefix}}_ENABLE_ETAG\n    size_t hdr_len = httpd_req_get_hdr_value_len(req, \"If-None-Match\");\n    if (hdr_len > 0) {\n        char* hdr_value = malloc(hdr_len + 1);\n        if (httpd_req_get_hdr_value_str(req, \"If-None-Match\", hdr_value, hdr_len + 1) == ESP_OK) {\n            if (strcmp(hdr_value, etag_{{this.dataname}}) == 0) {\n                free(hdr_value);\n                httpd_resp_set_status(req, \"304 Not Modified\");\n                httpd_resp_send(req, NULL, 0);\n                return ESP_OK;\n            }\n        }\n        free(hdr_value);\n    }\n  #endif\n{{/case}}\n{{/switch}}\n    httpd_resp_set_type(req, \"{{this.mime}}\");\n{{#switch ../gzip}}\n{{#case \"true\"}}\n{{#if this.isGzip}}\n    httpd_resp_set_hdr(req, \"Content-Encoding\", \"gzip\");\n{{/if}}\n{{/case}}\n{{#case \"compiler\"}}\n  {{#if this.isGzip}}\n  #ifdef {{../definePrefix}}_ENABLE_GZIP\n    httpd_resp_set_hdr(req, \"Content-Encoding\", \"gzip\");\n  #endif \n  {{/if}}\n{{/case}}\n{{/switch}}\n\n{{#switch ../etag}}\n{{#case \"true\"}}\n{{#../cacheTime}}\n    httpd_resp_set_hdr(req, \"Cache-Control\", \"max-age={{value}}\");\n{{/../cacheTime}}\n{{^../cacheTime}}\n    httpd_resp_set_hdr(req, \"Cache-Control\", \"no-cache\");\n{{/../cacheTime}}\n    httpd_resp_set_hdr(req, \"ETag\", etag_{{this.dataname}});\n{{/case}}\n{{#case \"compiler\"}}\n  #ifdef {{../definePrefix}}_ENABLE_ETAG\n{{#../cacheTime}}\n    httpd_resp_set_hdr(req, \"Cache-Control\", \"max-age={{value}}\");\n{{/../cacheTime}}\n{{^../cacheTime}}\n    httpd_resp_set_hdr(req, \"Cache-Control\", \"no-cache\");\n{{/../cacheTime}}\n    httpd_resp_set_hdr(req, \"ETag\", etag_{{this.dataname}});\n  #endif \n{{/case}}\n{{/switch}}\n\n{{#switch ../gzip}}\n{{#case \"true\"}}\n    httpd_resp_send(req, datagzip_{{this.dataname}}, {{this.lengthGzip}});\n{{/case}}\n{{#case \"false\"}}\n    httpd_resp_send(req, data_{{this.dataname}}, {{this.length}});\n{{/case}}\n{{#case \"compiler\"}}\n  #ifdef {{../definePrefix}}_ENABLE_GZIP\n    httpd_resp_send(req, datagzip_{{this.dataname}}, {{this.lengthGzip}});\n  #else\n    httpd_resp_send(req, data_{{this.dataname}}, {{this.length}});\n  #endif \n{{/case}}\n{{/switch}}\n    return ESP_OK;\n}\n\n{{#if this.isDefault}}\nstatic const httpd_uri_t route_def_{{this.datanameUpperCase}} = {\n    .uri = \"/\",\n    .method = HTTP_GET,\n    .handler = file_handler_{{this.datanameUpperCase}},\n};\n{{/if}}\n\nstatic const httpd_uri_t route_{{this.datanameUpperCase}} = {\n    .uri = \"/{{this.filename}}\",\n    .method = HTTP_GET,\n    .handler = file_handler_{{this.datanameUpperCase}},\n};\n\n{{/each}}\n\n\n\nstatic inline void {{methodName}}(httpd_handle_t server) {\n{{#each sources}}\n{{#if this.isDefault}}\n    httpd_register_uri_handler(server, &route_def_{{this.datanameUpperCase}});\n{{/if}}\n    httpd_register_uri_handler(server, &route_{{this.datanameUpperCase}});\n{{/each}}\n\n}";
+export declare const espidfTemplate = "\n//engine:   espidf\n//config:   {{{config}}}\n{{#if created }}\n//created:  {{now}}\n{{/if}}\n//\n\n{{#switch etag}}\n{{#case \"true\"}}\n#ifdef {{definePrefix}}_ENABLE_ETAG\n#warning {{definePrefix}}_ENABLE_ETAG has no effect because it is permanently switched ON\n#endif\n{{/case}}\n{{#case \"false\"}}\n#ifdef {{definePrefix}}_ENABLE_ETAG\n#warning {{definePrefix}}_ENABLE_ETAG has no effect because it is permanently switched OFF\n#endif\n{{/case}}\n{{/switch}}\n\n{{#switch gzip}}\n{{#case \"true\"}}\n#ifdef {{definePrefix}}_ENABLE_GZIP\n#warning {{definePrefix}}_ENABLE_GZIP has no effect because it is permanently switched ON\n#endif\n{{/case}}\n{{#case \"false\"}}\n#ifdef {{definePrefix}}_ENABLE_GZIP\n#warning {{definePrefix}}_ENABLE_GZIP has no effect because it is permanently switched OFF\n#endif\n{{/case}}\n{{/switch}}\n\n//\n{{#if version }}\n#define {{definePrefix}}_VERSION \"{{version}}\"\n{{/if}}\n#define {{definePrefix}}_COUNT {{fileCount}}\n#define {{definePrefix}}_SIZE {{fileSize}}\n#define {{definePrefix}}_SIZE_GZIP {{fileGzipSize}}\n\n//\n{{#each sources}}\n#define {{../definePrefix}}_FILE_{{this.datanameUpperCase}}\n{{/each}}\n\n//\n{{#each filesByExtension}}\n#define {{../definePrefix}}_{{this.extension}}_FILES {{this.count}}\n{{/each}}\n\n#include <stdint.h>\n#include <string.h>\n#include <stdlib.h>\n#include <esp_err.h>\n#include <esp_http_server.h>\n\n//\n{{#switch gzip}}\n{{#case \"true\"}}\n  {{#each sources}}\nconst char datagzip_{{this.dataname}}[{{this.lengthGzip}}] = { {{this.bytesGzip}} };\n  {{/each}}\n{{/case}}\n{{#case \"false\"}}\n  {{#each sources}}\nconst char data_{{this.dataname}}[{{this.length}}] = { {{this.bytes}} };\n  {{/each}}\n{{/case}}\n{{#case \"compiler\"}}\n#ifdef {{definePrefix}}_ENABLE_GZIP\n  {{#each sources}}\nconst char datagzip_{{this.dataname}}[{{this.lengthGzip}}] = { {{this.bytesGzip}} };\n  {{/each}}\n#else\n  {{#each sources}}\nconst char data_{{this.dataname}}[{{this.length}}] = { {{this.bytes}} };\n  {{/each}}\n#endif \n{{/case}}\n{{/switch}}\n\n//\n{{#switch etag}}\n{{#case \"true\"}}\n  {{#each sources}}\nstatic const char etag_{{this.dataname}}[] = \"{{this.sha256}}\";\n  {{/each}}\n{{/case}}\n{{#case \"false\"}}\n{{/case}}\n{{#case \"compiler\"}}\n#ifdef {{definePrefix}}_ENABLE_ETAG\n  {{#each sources}}\nstatic const char etag_{{this.dataname}}[] = \"{{this.sha256}}\";\n  {{/each}}\n#endif\n{{/case}}\n{{/switch}}\n\n// File manifest struct (C-compatible typedef)\ntypedef struct {\n  const char* path;\n  uint32_t size;\n  uint32_t gzipSize;\n  const char* etag;\n  const char* contentType;\n} {{definePrefix}}_FileInfo;\n\n// File manifest array\nstatic const {{definePrefix}}_FileInfo {{definePrefix}}_FILES[] = {\n{{#each sources}}\n  { \"/{{this.filename}}\", {{this.length}}, {{this.gzipSizeForManifest}}, {{this.etagForManifest}}, \"{{this.mime}}\" },\n{{/each}}\n};\nstatic const size_t {{definePrefix}}_FILE_COUNT = sizeof({{definePrefix}}_FILES) / sizeof({{definePrefix}}_FILES[0]);\n\n{{#each sources}}\n\nstatic esp_err_t file_handler_{{this.datanameUpperCase}} (httpd_req_t *req)\n{\n{{#switch ../etag}}\n{{#case \"true\"}}\n    size_t hdr_len = httpd_req_get_hdr_value_len(req, \"If-None-Match\");\n    if (hdr_len > 0) {\n        char* hdr_value = malloc(hdr_len + 1);\n        if (httpd_req_get_hdr_value_str(req, \"If-None-Match\", hdr_value, hdr_len + 1) == ESP_OK) {\n            if (strcmp(hdr_value, etag_{{this.dataname}}) == 0) {\n                free(hdr_value);\n                httpd_resp_set_status(req, \"304 Not Modified\");\n                httpd_resp_send(req, NULL, 0);\n                return ESP_OK;\n            }\n        }\n        free(hdr_value);\n    }\n{{/case}}\n{{#case \"compiler\"}}\n  #ifdef {{../definePrefix}}_ENABLE_ETAG\n    size_t hdr_len = httpd_req_get_hdr_value_len(req, \"If-None-Match\");\n    if (hdr_len > 0) {\n        char* hdr_value = malloc(hdr_len + 1);\n        if (httpd_req_get_hdr_value_str(req, \"If-None-Match\", hdr_value, hdr_len + 1) == ESP_OK) {\n            if (strcmp(hdr_value, etag_{{this.dataname}}) == 0) {\n                free(hdr_value);\n                httpd_resp_set_status(req, \"304 Not Modified\");\n                httpd_resp_send(req, NULL, 0);\n                return ESP_OK;\n            }\n        }\n        free(hdr_value);\n    }\n  #endif\n{{/case}}\n{{/switch}}\n    httpd_resp_set_type(req, \"{{this.mime}}\");\n{{#switch ../gzip}}\n{{#case \"true\"}}\n{{#if this.isGzip}}\n    httpd_resp_set_hdr(req, \"Content-Encoding\", \"gzip\");\n{{/if}}\n{{/case}}\n{{#case \"compiler\"}}\n  {{#if this.isGzip}}\n  #ifdef {{../definePrefix}}_ENABLE_GZIP\n    httpd_resp_set_hdr(req, \"Content-Encoding\", \"gzip\");\n  #endif \n  {{/if}}\n{{/case}}\n{{/switch}}\n\n{{#switch ../etag}}\n{{#case \"true\"}}\n{{#../cacheTime}}\n    httpd_resp_set_hdr(req, \"Cache-Control\", \"max-age={{value}}\");\n{{/../cacheTime}}\n{{^../cacheTime}}\n    httpd_resp_set_hdr(req, \"Cache-Control\", \"no-cache\");\n{{/../cacheTime}}\n    httpd_resp_set_hdr(req, \"ETag\", etag_{{this.dataname}});\n{{/case}}\n{{#case \"compiler\"}}\n  #ifdef {{../definePrefix}}_ENABLE_ETAG\n{{#../cacheTime}}\n    httpd_resp_set_hdr(req, \"Cache-Control\", \"max-age={{value}}\");\n{{/../cacheTime}}\n{{^../cacheTime}}\n    httpd_resp_set_hdr(req, \"Cache-Control\", \"no-cache\");\n{{/../cacheTime}}\n    httpd_resp_set_hdr(req, \"ETag\", etag_{{this.dataname}});\n  #endif \n{{/case}}\n{{/switch}}\n\n{{#switch ../gzip}}\n{{#case \"true\"}}\n    httpd_resp_send(req, datagzip_{{this.dataname}}, {{this.lengthGzip}});\n{{/case}}\n{{#case \"false\"}}\n    httpd_resp_send(req, data_{{this.dataname}}, {{this.length}});\n{{/case}}\n{{#case \"compiler\"}}\n  #ifdef {{../definePrefix}}_ENABLE_GZIP\n    httpd_resp_send(req, datagzip_{{this.dataname}}, {{this.lengthGzip}});\n  #else\n    httpd_resp_send(req, data_{{this.dataname}}, {{this.length}});\n  #endif \n{{/case}}\n{{/switch}}\n    return ESP_OK;\n}\n\n{{#if this.isDefault}}\nstatic const httpd_uri_t route_def_{{this.datanameUpperCase}} = {\n    .uri = \"/\",\n    .method = HTTP_GET,\n    .handler = file_handler_{{this.datanameUpperCase}},\n};\n{{/if}}\n\nstatic const httpd_uri_t route_{{this.datanameUpperCase}} = {\n    .uri = \"/{{this.filename}}\",\n    .method = HTTP_GET,\n    .handler = file_handler_{{this.datanameUpperCase}},\n};\n\n{{/each}}\n\n\n\nstatic inline void {{methodName}}(httpd_handle_t server) {\n{{#each sources}}\n{{#if this.isDefault}}\n    httpd_register_uri_handler(server, &route_def_{{this.datanameUpperCase}});\n{{/if}}\n    httpd_register_uri_handler(server, &route_{{this.datanameUpperCase}});\n{{/each}}\n\n}";

package/dist/cppCodeEspIdf.js

@@ -88,7 +88,7 @@ const char data_{{this.dataname}}[{{this.length}}] = { {{this.bytes}} };
 {{#switch etag}}
 {{#case "true"}}
   {{#each sources}}
-const char * etag_{{this.dataname}} = "{{this.md5}}";
+static const char etag_{{this.dataname}}[] = "{{this.sha256}}";
   {{/each}}
 {{/case}}
 {{#case "false"}}
@@ -96,12 +96,29 @@ const char * etag_{{this.dataname}} = "{{this.md5}}";
 {{#case "compiler"}}
 #ifdef {{definePrefix}}_ENABLE_ETAG
   {{#each sources}}
-const char * etag_{{this.dataname}} = "{{this.md5}}";
+static const char etag_{{this.dataname}}[] = "{{this.sha256}}";
   {{/each}}
-#endif 
+#endif
 {{/case}}
 {{/switch}}
 
+// File manifest struct (C-compatible typedef)
+typedef struct {
+  const char* path;
+  uint32_t size;
+  uint32_t gzipSize;
+  const char* etag;
+  const char* contentType;
+} {{definePrefix}}_FileInfo;
+
+// File manifest array
+static const {{definePrefix}}_FileInfo {{definePrefix}}_FILES[] = {
+{{#each sources}}
+  { "/{{this.filename}}", {{this.length}}, {{this.gzipSizeForManifest}}, {{this.etagForManifest}}, "{{this.mime}}" },
+{{/each}}
+};
+static const size_t {{definePrefix}}_FILE_COUNT = sizeof({{definePrefix}}_FILES) / sizeof({{definePrefix}}_FILES[0]);
+
 {{#each sources}}
 
 static esp_err_t file_handler_{{this.datanameUpperCase}} (httpd_req_t *req)

package/dist/index.d.ts

@@ -1 +1,7 @@
-export {};
+import { CppCodeSource } from './cppCode';
+declare const shouldUseGzip: (originalSize: number, compressedSize: number) => boolean;
+declare const calculateCompressionRatio: (originalSize: number, compressedSize: number) => number;
+declare const formatCompressionLog: (filename: string, padding: string, originalSize: number, compressedSize: number, useGzip: boolean) => string;
+declare const createSourceEntry: (filename: string, dataname: string, content: Buffer, contentGzip: Buffer, mimeType: string, sha256: string, isGzip: boolean) => CppCodeSource;
+declare const updateExtensionGroup: (extension: string) => void;
+export { calculateCompressionRatio, createSourceEntry, formatCompressionLog, shouldUseGzip, updateExtensionGroup };

package/dist/index.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateExtensionGroup = exports.shouldUseGzip = exports.formatCompressionLog = exports.createSourceEntry = exports.calculateCompressionRatio = void 0;
 const node_crypto_1 = require("node:crypto");
 const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
@@ -23,7 +24,9 @@ const summary = {
 const sources = [];
 const filesByExtension = [];
 const shouldUseGzip = (originalSize, compressedSize) => originalSize > GZIP_MIN_SIZE && compressedSize < originalSize * GZIP_MIN_REDUCTION_RATIO;
+exports.shouldUseGzip = shouldUseGzip;
 const calculateCompressionRatio = (originalSize, compressedSize) => Math.round((compressedSize / originalSize) * 100);
+exports.calculateCompressionRatio = calculateCompressionRatio;
 const formatCompressionLog = (filename, padding, originalSize, compressedSize, useGzip) => {
     const ratio = calculateCompressionRatio(originalSize, compressedSize);
     const sizeInfo = `(${originalSize} -> ${compressedSize} = ${ratio}%)`;
@@ -32,7 +35,8 @@ const formatCompressionLog = (filename, padding, originalSize, compressedSize, u
     const tooSmall = originalSize <= GZIP_MIN_SIZE ? '(too small) ' : '';
     return (0, consoleColor_1.yellowLog)(` [${filename}] ${padding} x gzip unused ${tooSmall}${sizeInfo}`);
 };
-const createSourceEntry = (filename, dataname, content, contentGzip, mimeType, md5, isGzip) => ({
+exports.formatCompressionLog = formatCompressionLog;
+const createSourceEntry = (filename, dataname, content, contentGzip, mimeType, sha256, isGzip) => ({
     filename,
     dataname,
     datanameUpperCase: dataname.toUpperCase(),
@@ -40,8 +44,9 @@ const createSourceEntry = (filename, dataname, content, contentGzip, mimeType, m
     contentGzip: isGzip ? contentGzip : content,
     isGzip,
     mime: mimeType,
-    md5
+    sha256
 });
+exports.createSourceEntry = createSourceEntry;
 const updateExtensionGroup = (extension) => {
     const group = filesByExtension.find((fe) => fe.extension === extension);
     if (group)
@@ -49,6 +54,7 @@ const updateExtensionGroup = (extension) => {
     else
         filesByExtension.push({ extension, count: 1 });
 };
+exports.updateExtensionGroup = updateExtensionGroup;
 console.log('Collecting source files');
 const files = (0, file_1.getFiles)();
 if (files.size === 0) {
@@ -67,12 +73,12 @@ for (const [originalFilename, content] of files) {
     if (extension.startsWith('.'))
         extension = extension.slice(1);
     updateExtensionGroup(extension);
-    const md5 = (0, node_crypto_1.createHash)('md5').update(content).digest('hex');
+    const sha256 = (0, node_crypto_1.createHash)('sha256').update(content).digest('hex');
     summary.size += content.length;
     const zipContent = (0, node_zlib_1.gzipSync)(content, { level: 9 });
     summary.gzipsize += zipContent.length;
     const useGzip = shouldUseGzip(content.length, zipContent.length);
-    sources.push(createSourceEntry(filename, dataname, content, zipContent, mimeType, md5, useGzip));
+    sources.push(createSourceEntry(filename, dataname, content, zipContent, mimeType, sha256, useGzip));
     const padding = ' '.repeat(longestFilename - originalFilename.length);
     console.log(formatCompressionLog(originalFilename, padding, content.length, zipContent.length, useGzip));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelteesp32",
-  "version": "1.13.1",
+  "version": "1.14.0",
   "description": "Convert Svelte (or any frontend) JS application to serve it from ESP32 webserver (PsychicHttp)",
   "author": "BCsabaEngine",
   "license": "ISC",
@@ -61,22 +61,22 @@
   ],
   "devDependencies": {
     "@types/mime-types": "^3.0.1",
-    "@types/node": "^25.0.0",
+    "@types/node": "^25.1.0",
     "@types/picomatch": "^4.0.2",
-    "@typescript-eslint/eslint-plugin": "^8.49.0",
-    "@typescript-eslint/parser": "^8.49.0",
-    "@vitest/coverage-v8": "^4.0.15",
-    "eslint": "^9.39.1",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-unicorn": "^62.0.0",
-    "memfs": "^4.51.1",
+    "memfs": "^4.56.10",
     "nodemon": "^3.1.11",
-    "prettier": "^3.7.4",
+    "prettier": "^3.8.1",
     "ts-node": "^10.9.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.15"
+    "vitest": "^4.0.18"
   },
   "dependencies": {
     "handlebars": "^4.7.8",