svelteesp32 1.13.0 → 1.14.0

package/README.md

@@ -12,6 +12,23 @@ In order to be able to easily update OTA, it is important - from the users' poin
 
 This npm package provides a solution for **inserting any JS client application into the ESP web server** (PsychicHttp and also ESPAsyncWebServer (https://github.com/ESP32Async/ESPAsyncWebServer) and ESP-IDF available, PsychicHttp is the default). For this, JS, html, css, font, assets, etc. files must be converted to binary byte array. Npm mode is easy to use and easy to **integrate into your CI/CD pipeline**.
 
+**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 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:**
+
+- **SvelteESP32**: Single-binary OTA updates, CI/CD pipelines, static web content that doesn't change at runtime
+- **SPIFFS/LittleFS**: Dynamic content, user-uploadable files, configuration that changes at runtime
+
 > Starting with version v1.13.0, RC files support npm package variable interpolation
 
 > Starting with version v1.12.0, you can use RC file for configuration
@@ -223,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) {
@@ -309,6 +341,18 @@ At the same time, it can be an advantage that the content is cached by the brows
 
 Typically, the entry point for web applications is the **index.htm or index.html** file. This does not need to be listed in the browser's address bar because web servers know that this file should be served by default. Svelteesp32 also does this: if there is an index.htm or index.html file, it sets it as the main file to be served. So using `http://esp_xxx.local` or just entering the `http://x.y.w.z/` IP address will serve this main file.
 
+**Validation**: By default, svelteesp32 validates that an `index.html` or `index.htm` file exists in your source directory (in the root or any subdirectory). This ensures users won't get a 404 error when visiting your ESP32's root URL.
+
+**Skipping Validation**: If you're building an API-only application (REST endpoints without a web UI) or using a different entry point (e.g., `main.html`), you can skip this validation with the `--no-index-check` flag:
+
+```bash
+# API-only application (no web UI)
+npx svelteesp32 -e psychic -s ./dist -o ./output.h --no-index-check
+
+# Custom entry point (users must visit /main.html explicitly)
+npx svelteesp32 -e psychic -s ./dist -o ./output.h --no-index-check
+```
+
 ### File Exclusion
 
 The `--exclude` option allows you to exclude files from being embedded in the ESP32 firmware using glob patterns. This is useful for excluding source maps, documentation, and test files that shouldn't be part of the deployed application.
@@ -416,23 +460,92 @@ 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                 |
-| ------------- | ------------------------------------------------------------------------------------ | ----------------------- |
-| `-s`          | **Source dist folder contains compiled web files**                                   | (required)              |
-| `-e`          | The engine for which the include file is created (psychic/psychic2/async/espidf)     | psychic                 |
-| `-o`          | Generated output file with path                                                      | `svelteesp32.h`         |
-| `--exclude`   | Exclude files matching glob pattern (repeatable or comma-separated)                  | Default system files    |
-| `--etag`      | Use ETag header for cache (true/false/compiler)                                      | false                   |
-| `--cachetime` | Override no-cache response with a max-age=\<cachetime\> response (seconds)           | 0                       |
-| `--gzip`      | Compress content with gzip (true/false/compiler)                                     | true                    |
-| `--created`   | Include creation time in generated header                                            | false                   |
-| `--version`   | Include a version string in generated header, e.g. `--version=v$npm_package_version` | ''                      |
-| `--espmethod` | Name of generated initialization method                                              | `initSvelteStaticFiles` |
-| `--define`    | Prefix of c++ defines (e.g., SVELTEESP32_COUNT)                                      | `SVELTEESP32`           |
-| `--config`    | Use custom RC file path                                                              | `.svelteesp32rc.json`   |
-| `-h`          | Show help                                                                            |                         |
+| Option             | Description                                                                          | default                 |
+| ------------------ | ------------------------------------------------------------------------------------ | ----------------------- |
+| `-s`               | **Source dist folder contains compiled web files**                                   | (required)              |
+| `-e`               | The engine for which the include file is created (psychic/psychic2/async/espidf)     | psychic                 |
+| `-o`               | Generated output file with path                                                      | `svelteesp32.h`         |
+| `--exclude`        | Exclude files matching glob pattern (repeatable or comma-separated)                  | Default system files    |
+| `--etag`           | Use ETag header for cache (true/false/compiler)                                      | false                   |
+| `--cachetime`      | Override no-cache response with a max-age=\<cachetime\> response (seconds)           | 0                       |
+| `--gzip`           | Compress content with gzip (true/false/compiler)                                     | true                    |
+| `--created`        | Include creation time in generated header                                            | false                   |
+| `--version`        | Include a version string in generated header, e.g. `--version=v$npm_package_version` | ''                      |
+| `--espmethod`      | Name of generated initialization method                                              | `initSvelteStaticFiles` |
+| `--define`         | Prefix of c++ defines (e.g., SVELTEESP32_COUNT)                                      | `SVELTEESP32`           |
+| `--config`         | Use custom RC file path                                                              | `.svelteesp32rc.json`   |
+| `--no-index-check` | Skip validation for index.html/index.htm (for API-only or custom entry points)       | false                   |
+| `-h`               | Show help                                                                            |                         |
 
 ### Configuration File
 
@@ -479,19 +592,20 @@ npx svelteesp32 --config=.svelteesp32rc.prod.json
 
 All CLI options can be specified in the RC file using long-form property names:
 
-| RC Property  | CLI Flag      | Type    | Example                                          |
-| ------------ | ------------- | ------- | ------------------------------------------------ |
-| `engine`     | `-e`          | string  | `"psychic"`, `"psychic2"`, `"async"`, `"espidf"` |
-| `sourcepath` | `-s`          | string  | `"./dist"`                                       |
-| `outputfile` | `-o`          | string  | `"./output.h"`                                   |
-| `etag`       | `--etag`      | string  | `"true"`, `"false"`, `"compiler"`                |
-| `gzip`       | `--gzip`      | string  | `"true"`, `"false"`, `"compiler"`                |
-| `cachetime`  | `--cachetime` | number  | `86400`                                          |
-| `created`    | `--created`   | boolean | `true`, `false`                                  |
-| `version`    | `--version`   | string  | `"v1.0.0"`                                       |
-| `espmethod`  | `--espmethod` | string  | `"initSvelteStaticFiles"`                        |
-| `define`     | `--define`    | string  | `"SVELTEESP32"`                                  |
-| `exclude`    | `--exclude`   | array   | `["*.map", "*.md"]`                              |
+| RC Property    | CLI Flag           | Type    | Example                                          |
+| -------------- | ------------------ | ------- | ------------------------------------------------ |
+| `engine`       | `-e`               | string  | `"psychic"`, `"psychic2"`, `"async"`, `"espidf"` |
+| `sourcepath`   | `-s`               | string  | `"./dist"`                                       |
+| `outputfile`   | `-o`               | string  | `"./output.h"`                                   |
+| `etag`         | `--etag`           | string  | `"true"`, `"false"`, `"compiler"`                |
+| `gzip`         | `--gzip`           | string  | `"true"`, `"false"`, `"compiler"`                |
+| `cachetime`    | `--cachetime`      | number  | `86400`                                          |
+| `created`      | `--created`        | boolean | `true`, `false`                                  |
+| `version`      | `--version`        | string  | `"v1.0.0"`                                       |
+| `espmethod`    | `--espmethod`      | string  | `"initSvelteStaticFiles"`                        |
+| `define`       | `--define`         | string  | `"SVELTEESP32"`                                  |
+| `exclude`      | `--exclude`        | array   | `["*.map", "*.md"]`                              |
+| `noIndexCheck` | `--no-index-check` | boolean | `true`, `false`                                  |
 
 #### CLI Override
 

package/dist/commandLine.d.ts

@@ -10,6 +10,7 @@ interface ICopyFilesArguments {
     created: boolean;
     version: string;
     exclude: string[];
+    noIndexCheck?: boolean;
     help?: boolean;
 }
 interface IRcFileConfig {

package/dist/commandLine.js

@@ -12,6 +12,7 @@ const node_fs_1 = require("node:fs");
 const node_os_1 = require("node:os");
 const node_path_1 = __importDefault(require("node:path"));
 const consoleColor_1 = require("./consoleColor");
+const errorMessages_1 = require("./errorMessages");
 function showHelp() {
     console.log(`
 svelteesp32 - Svelte JS to ESP32 converter
@@ -57,7 +58,8 @@ RC File:
 function validateEngine(value) {
     if (value === 'psychic' || value === 'psychic2' || value === 'async' || value === 'espidf')
         return value;
-    throw new Error(`Invalid engine: ${value}`);
+    console.error((0, errorMessages_1.getInvalidEngineError)(value));
+    process.exit(1);
 }
 function validateTriState(value, name) {
     if (value === 'true' || value === 'false' || value === 'compiler')
@@ -349,6 +351,10 @@ function parseArguments() {
             result.created = true;
             continue;
         }
+        if (argument === '--no-index-check') {
+            result.noIndexCheck = true;
+            continue;
+        }
         if (argument.startsWith('-') && !argument.startsWith('--')) {
             const flag = argument.slice(1);
             const nextArgument = arguments_[index + 1];
@@ -465,8 +471,12 @@ function formatConfiguration(cmdLine) {
     return parts.join(' ');
 }
 exports.cmdLine = parseArguments();
-if (!(0, node_fs_1.existsSync)(exports.cmdLine.sourcepath) || !(0, node_fs_1.statSync)(exports.cmdLine.sourcepath).isDirectory()) {
-    console.error(`Directory ${exports.cmdLine.sourcepath} not exists or not a directory`);
+if (!(0, node_fs_1.existsSync)(exports.cmdLine.sourcepath)) {
+    console.error((0, errorMessages_1.getSourcepathNotFoundError)(exports.cmdLine.sourcepath, 'not_found'));
+    process.exit(1);
+}
+if (!(0, node_fs_1.statSync)(exports.cmdLine.sourcepath).isDirectory()) {
+    console.error((0, errorMessages_1.getSourcepathNotFoundError)(exports.cmdLine.sourcepath, 'not_directory'));
     process.exit(1);
 }
 console.log(`[SvelteESP32] Generate code for ${exports.cmdLine.engine} engine`);

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/errorMessages.d.ts

@@ -0,0 +1,4 @@
+export declare function getMissingIndexError(engine: string): string;
+export declare function getInvalidEngineError(attempted: string): string;
+export declare function getSourcepathNotFoundError(sourcepath: string, reason: 'not_found' | 'not_directory'): string;
+export declare function getMaxUriHandlersHint(engine: string, routeCount: number): string;

package/dist/errorMessages.js

@@ -0,0 +1,146 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMissingIndexError = getMissingIndexError;
+exports.getInvalidEngineError = getInvalidEngineError;
+exports.getSourcepathNotFoundError = getSourcepathNotFoundError;
+exports.getMaxUriHandlersHint = getMaxUriHandlersHint;
+const node_path_1 = __importDefault(require("node:path"));
+const consoleColor_1 = require("./consoleColor");
+function getEngineName(engine) {
+    const names = {
+        psychic: 'PsychicHttpServer',
+        psychic2: 'PsychicHttpServer V2',
+        async: 'ESPAsyncWebServer',
+        espidf: 'ESP-IDF'
+    };
+    return names[engine] ?? engine;
+}
+function getMissingIndexError(engine) {
+    const hints = {
+        psychic: `  1. Add an index.html file to your source directory
+  2. The file will automatically be set as the default route ("/")
+  3. PsychicHttpServer uses: server->defaultEndpoint = ...`,
+        psychic2: `  1. Add an index.html file to your source directory
+  2. The file will automatically be set as the default route ("/")
+  3. PsychicHttpServer V2 uses: server->defaultEndpoint = ...`,
+        async: `  1. Add an index.html file to your source directory
+  2. The file will automatically create a "/" route handler
+  3. ESPAsyncWebServer uses: server.on("/", HTTP_GET, ...)`,
+        espidf: `  1. Add an index.html file to your source directory
+  2. The file will register both "/" and "/index.html" routes
+  3. ESP-IDF uses: httpd_register_uri_handler(server, &route_def_...)`
+    };
+    const hint = hints[engine] ?? hints['psychic'];
+    return ((0, consoleColor_1.redLog)('[ERROR] No index.html or index.htm found in source files') +
+        `
+
+Why this matters:
+  Web applications typically need a default entry point. Without index.html,
+  users visiting http://your-esp32/ will get a 404 error.
+
+How to fix (for ${getEngineName(engine)}):
+${hint}
+
+Alternative:
+  If you use a different entry point (e.g., main.html), you can add --no-index-check flag,
+  but users must navigate to http://your-esp32/main.html explicitly.`);
+}
+function getInvalidEngineError(attempted) {
+    return ((0, consoleColor_1.redLog)(`[ERROR] Invalid engine: '${attempted}'`) +
+        `
+
+Valid engines are:
+  ${(0, consoleColor_1.cyanLog)('• psychic')}    - PsychicHttpServer (ESP32 only, fastest performance)
+  ${(0, consoleColor_1.cyanLog)('• psychic2')}   - PsychicHttpServer V2 (ESP32 only, modern API)
+  ${(0, consoleColor_1.cyanLog)('• async')}      - ESPAsyncWebServer (ESP32/ESP8266 compatible)
+  ${(0, consoleColor_1.cyanLog)('• espidf')}     - Native ESP-IDF web server (ESP32 only, no Arduino)
+
+How to fix:
+  npx svelteesp32 --engine=psychic --sourcepath=./dist
+
+Example RC file (.svelteesp32rc.json):
+  {
+    "engine": "psychic",
+    "sourcepath": "./dist"
+  }
+
+Documentation: https://github.com/hpieroni/svelteesp32#readme`);
+}
+function getSourcepathNotFoundError(sourcepath, reason) {
+    if (reason === 'not_directory')
+        return ((0, consoleColor_1.redLog)(`[ERROR] Source path is not a directory: '${sourcepath}'`) +
+            `
+
+The --sourcepath option must point to a directory containing your built web files,
+not an individual file.
+
+How to fix:
+  npx svelteesp32 --sourcepath=./dist --engine=psychic`);
+    const resolvedPath = node_path_1.default.resolve(sourcepath);
+    const currentDirectory = process.cwd();
+    return ((0, consoleColor_1.redLog)(`[ERROR] Source directory not found: '${sourcepath}'`) +
+        `
+
+Why this matters:
+  SvelteESP32 needs your compiled web assets (HTML, CSS, JS) to convert them
+  into C++ header files for the ESP32.
+
+How to fix:
+  1. Build your frontend application first:
+     • Svelte:  npm run build
+     • React:   npm run build
+     • Vue:     npm run build
+     • Angular: ng build
+
+  2. Verify the build output directory exists:
+     ${(0, consoleColor_1.cyanLog)(`ls -la ${sourcepath}`)}
+
+  3. Check your build tool configuration:
+     • Vite:    vite.config.js → build.outDir
+     • Webpack: webpack.config.js → output.path
+     • Rollup:  rollup.config.js → output.dir
+
+  4. Update your svelteesp32 command to match:
+     ${(0, consoleColor_1.cyanLog)(`npx svelteesp32 --sourcepath=./build --engine=psychic`)}
+
+Current directory: ${currentDirectory}
+Attempted path: ${resolvedPath} (resolved)`);
+}
+function getMaxUriHandlersHint(engine, routeCount) {
+    const recommended = routeCount + 5;
+    const hints = {
+        psychic: `PsychicHttpServer server;
+  server.config.max_uri_handlers = ${recommended};  // Default is 8, you need at least ${routeCount}
+  initSvelteStaticFiles(&server);
+  server.listen(80);`,
+        psychic2: `PsychicHttpServer server;
+  server.config.max_uri_handlers = ${recommended};  // Default is 8, you need at least ${routeCount}
+  initSvelteStaticFiles(&server);
+  server.listen(80);`,
+        espidf: `httpd_config_t config = HTTPD_DEFAULT_CONFIG();
+  config.max_uri_handlers = ${recommended};  // Default is 8, you need at least ${routeCount}
+  httpd_handle_t server = NULL;
+  httpd_start(&server, &config);
+  initSvelteStaticFiles(server);`
+    };
+    const hint = hints[engine];
+    if (!hint)
+        return '';
+    return ((0, consoleColor_1.yellowLog)('[CONFIG TIP] max_uri_handlers configuration') +
+        `
+
+Your generated code includes ${routeCount} routes. Make sure your server can handle them:
+
+For ${getEngineName(engine)}:
+  ${hint}
+
+Recommended formula: max_uri_handlers = file_count + 5 (safety margin)
+
+Runtime symptoms if too low:
+  • Routes not registered (HTTP 404 errors)
+  • ESP_ERR_HTTPD_HANDLERS_FULL error in logs
+  • Some files load, others don't (random behavior)`);
+}

package/dist/file.js

@@ -11,6 +11,7 @@ const picomatch_1 = __importDefault(require("picomatch"));
 const tinyglobby_1 = require("tinyglobby");
 const commandLine_1 = require("./commandLine");
 const consoleColor_1 = require("./consoleColor");
+const errorMessages_1 = require("./errorMessages");
 const findSimilarFiles = (files) => {
     const contentComparer = new Map();
     for (const [filename, content] of files.entries()) {
@@ -79,6 +80,11 @@ const getFiles = () => {
     const duplicates = findSimilarFiles(result);
     for (const sameFiles of duplicates)
         console.log((0, consoleColor_1.yellowLog)(` ${sameFiles.join(', ')} files look like identical`));
+    const hasIndex = [...result.keys()].some((f) => f === 'index.html' || f === 'index.htm' || f.endsWith('/index.html') || f.endsWith('/index.htm'));
+    if (!hasIndex && !commandLine_1.cmdLine.noIndexCheck) {
+        console.error('\n' + (0, errorMessages_1.getMissingIndexError)(commandLine_1.cmdLine.engine));
+        process.exit(1);
+    }
     return result;
 };
 exports.getFiles = getFiles;

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"));
@@ -11,6 +12,7 @@ const mime_types_1 = require("mime-types");
 const commandLine_1 = require("./commandLine");
 const consoleColor_1 = require("./consoleColor");
 const cppCode_1 = require("./cppCode");
+const errorMessages_1 = require("./errorMessages");
 const file_1 = require("./file");
 const GZIP_MIN_SIZE = 1024;
 const GZIP_MIN_REDUCTION_RATIO = 0.85;
@@ -22,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}%)`;
@@ -31,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(),
@@ -39,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)
@@ -48,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) {
@@ -66,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));
 }
@@ -82,3 +89,5 @@ const cppFile = (0, cppCode_1.getCppCode)(sources, filesByExtension);
 (0, node_fs_1.writeFileSync)(commandLine_1.cmdLine.outputfile, cppFile, { flush: true, encoding: 'utf8' });
 console.log(`${summary.filecount} files, ${Math.round(summary.size / 1024)}kB original size, ${Math.round(summary.gzipsize / 1024)}kB gzip size`);
 console.log(`${commandLine_1.cmdLine.outputfile} ${Math.round(cppFile.length / 1024)}kB size`);
+if (commandLine_1.cmdLine.engine === 'psychic' || commandLine_1.cmdLine.engine === 'psychic2' || commandLine_1.cmdLine.engine === 'espidf')
+    console.log('\n' + (0, errorMessages_1.getMaxUriHandlersHint)(commandLine_1.cmdLine.engine, sources.length));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelteesp32",
-  "version": "1.13.0",
+  "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": "^24.10.1",
+    "@types/node": "^25.1.0",
     "@types/picomatch": "^4.0.2",
-    "@typescript-eslint/eslint-plugin": "^8.48.1",
-    "@typescript-eslint/parser": "^8.48.1",
-    "@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",