hazo_files 3.2.0 → 3.4.0

package/CHANGE_LOG.md

@@ -5,6 +5,41 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 3.4.0 — 2026-09-19
+
+### Changed
+
+- Migrated onto the canonical `hazo_core/i18n` bridge (`createPackageT` /
+  `resolvePackageLocale`), replacing this package's local ~120-line copy at
+  `src/lib/create_package_t.ts` (now deleted). All 13 call sites across
+  `src/ui/components/**` and `src/background_upload/react/use-file-upload-toasts.ts`
+  now import directly from `hazo_core/i18n`. Behavior is unchanged — same
+  flat `src/locales/en.json` fallback catalog, same `{{var}}` mustache
+  interpolation, same optional/no-op `hazo_i18n` registration side effect.
+  `hazo_core` peer bumped to `^2.4.0` (first version shipping the `/i18n`
+  subpath) and `hazo_i18n` peer bumped to `^0.5.0`. Added an "i18n bridge"
+  autotest scenario group to the test-app covering catalog load, key
+  coverage, and interpolation.
+
+## 3.3.0 — 2026-08-13
+
+### Fixed
+
+`HazoFileUploadProvider` handed the live tree a destroyed `UploadManager` after
+a remount. The provider created the manager in a `useRef` and destroyed it in
+its `useEffect` cleanup, but never rebuilt it. Under React StrictMode (dev
+double-mount) or any real remount, the cleanup ran `manager.destroy()`, then the
+re-run setup reused the same destroyed instance — so every `submit_batch` threw
+`UploadManager is destroyed`. The effect now rebuilds the manager when it finds
+a destroyed one and forces a re-render so the context value points at the fresh
+instance.
+
+### Added
+
+- `UploadManager.is_destroyed` getter, so consumers (and the provider) can check
+  lifecycle state without touching internals.
+
+
 ## 3.2.0 — 2026-08-04
 
 ### Fixed

package/dist/background-upload/index.d.mts

@@ -152,6 +152,7 @@ declare class UploadManager {
     private destroyed;
     private readonly config;
     constructor(config?: UploadManagerConfig);
+    get is_destroyed(): boolean;
     on<K extends keyof UploadManagerEvents>(event: K, listener: (data: UploadManagerEvents[K]) => void): () => void;
     submit_batch(options: CreateBatchOptions): string;
     get_jobs_for_group(group_id: string): JobSnapshot[];

package/dist/background-upload/index.d.ts

@@ -152,6 +152,7 @@ declare class UploadManager {
     private destroyed;
     private readonly config;
     constructor(config?: UploadManagerConfig);
+    get is_destroyed(): boolean;
     on<K extends keyof UploadManagerEvents>(event: K, listener: (data: UploadManagerEvents[K]) => void): () => void;
     submit_batch(options: CreateBatchOptions): string;
     get_jobs_for_group(group_id: string): JobSnapshot[];

package/dist/background-upload/index.js

@@ -201,6 +201,9 @@ var UploadManager = class {
     this.emitter.on("job:completed", ({ job }) => this.on_job_settled(job));
     this.emitter.on("job:error", ({ job }) => this.on_job_settled(job));
   }
+  get is_destroyed() {
+    return this.destroyed;
+  }
   on(event, listener) {
     return this.emitter.on(event, listener);
   }

package/dist/background-upload/index.mjs

@@ -172,6 +172,9 @@ var UploadManager = class {
     this.emitter.on("job:completed", ({ job }) => this.on_job_settled(job));
     this.emitter.on("job:error", ({ job }) => this.on_job_settled(job));
   }
+  get is_destroyed() {
+    return this.destroyed;
+  }
   on(event, listener) {
     return this.emitter.on(event, listener);
   }

package/dist/background-upload/react/index.d.mts

@@ -118,6 +118,7 @@ declare class UploadManager {
     private destroyed;
     private readonly config;
     constructor(config?: UploadManagerConfig);
+    get is_destroyed(): boolean;
     on<K extends keyof UploadManagerEvents>(event: K, listener: (data: UploadManagerEvents[K]) => void): () => void;
     submit_batch(options: CreateBatchOptions): string;
     get_jobs_for_group(group_id: string): JobSnapshot[];

package/dist/background-upload/react/index.d.ts

@@ -118,6 +118,7 @@ declare class UploadManager {
     private destroyed;
     private readonly config;
     constructor(config?: UploadManagerConfig);
+    get is_destroyed(): boolean;
     on<K extends keyof UploadManagerEvents>(event: K, listener: (data: UploadManagerEvents[K]) => void): () => void;
     submit_batch(options: CreateBatchOptions): string;
     get_jobs_for_group(group_id: string): JobSnapshot[];

package/dist/background-upload/react/index.js

@@ -217,6 +217,9 @@ var UploadManager = class {
     this.emitter.on("job:completed", ({ job }) => this.on_job_settled(job));
     this.emitter.on("job:error", ({ job }) => this.on_job_settled(job));
   }
+  get is_destroyed() {
+    return this.destroyed;
+  }
   on(event, listener) {
     return this.emitter.on(event, listener);
   }
@@ -317,6 +320,108 @@ var FileUploadContext = (0, import_react.createContext)(null);
 
 // src/background_upload/react/use-file-upload-toasts.ts
 var import_react2 = require("react");
+
+// src/locales/en.json
+var en_default = {
+  "upload_dialog.title": "Upload Files",
+  "upload_dialog.uploading_to": "Uploading to:",
+  "upload_dialog.drop_text": "Drag and drop files here, or",
+  "upload_dialog.browse": "browse",
+  "upload_dialog.files_selected": "{{count}} file(s) selected",
+  "upload_dialog.total": "Total:",
+  "upload_dialog.cancel": "Cancel",
+  "upload_dialog.upload": "Upload",
+  "upload_dialog.select_files_error": "Please select files to upload",
+  "create_folder_dialog.title": "Create New Folder",
+  "create_folder_dialog.creating_in": "Creating folder in:",
+  "create_folder_dialog.name_label": "Folder Name",
+  "create_folder_dialog.name_placeholder": "Enter folder name",
+  "create_folder_dialog.cancel": "Cancel",
+  "create_folder_dialog.submit": "Create Folder",
+  "create_folder_dialog.name_required_error": "Please enter a folder name",
+  "create_folder_dialog.invalid_chars_error": "Folder name contains invalid characters",
+  "rename_dialog.title_folder": "Rename Folder",
+  "rename_dialog.title_file": "Rename File",
+  "rename_dialog.name_label": "New Name",
+  "rename_dialog.name_placeholder": "Enter new name",
+  "rename_dialog.cancel": "Cancel",
+  "rename_dialog.submit": "Rename",
+  "rename_dialog.name_required_error": "Please enter a name",
+  "rename_dialog.invalid_chars_error": "Name contains invalid characters",
+  "delete_confirm_dialog.title_folder": "Delete Folder",
+  "delete_confirm_dialog.title_file": "Delete File",
+  "delete_confirm_dialog.confirm_message": "Are you sure you want to delete",
+  "delete_confirm_dialog.folder_warning": "Warning: This folder and all its contents will be permanently deleted.",
+  "delete_confirm_dialog.cancel": "Cancel",
+  "delete_confirm_dialog.submit": "Delete",
+  "metadata_dialog.title": "File Metadata",
+  "metadata_dialog.close": "Close",
+  "file_actions.new_folder": "New Folder",
+  "file_actions.upload": "Upload",
+  "file_actions.download": "Download",
+  "file_actions.rename": "Rename",
+  "file_actions.delete": "Delete",
+  "file_actions.refresh": "Refresh",
+  "file_list.empty": "This folder is empty",
+  "file_list.header_name": "Name",
+  "file_list.header_size": "Size",
+  "file_list.header_modified": "Modified",
+  "folder_tree.root": "Root",
+  "file_preview.select_prompt": "Select a file to preview",
+  "file_preview.folder_label": "Folder",
+  "file_preview.created_label": "Created:",
+  "file_preview.modified_label": "Modified:",
+  "file_preview.error_loading": "Error loading preview",
+  "file_preview.video_unsupported": "Your browser does not support video playback.",
+  "file_preview.audio_unsupported": "Your browser does not support audio playback.",
+  "file_preview.no_preview": "No preview available",
+  "file_preview.size_label": "Size:",
+  "file_preview.type_label": "Type:",
+  "file_info_panel.no_item_selected": "No item selected",
+  "file_info_panel.no_custom_metadata": "No custom metadata",
+  "file_info_panel.name_label": "Name:",
+  "file_info_panel.path_label": "Path:",
+  "file_info_panel.type_label": "Type:",
+  "file_info_panel.size_label": "Size:",
+  "file_info_panel.created_label": "Created:",
+  "file_info_panel.modified_label": "Modified:",
+  "file_info_panel.storage_label": "Storage:",
+  "file_info_panel.custom_metadata_title": "Custom Metadata",
+  "file_info_panel.type_folder": "Folder",
+  "file_info_panel.type_unknown": "Unknown",
+  "file_browser.load_directory_error": "Failed to load directory",
+  "file_browser.move_item_error": "Failed to move item",
+  "file_browser.upload_file_error": "Failed to upload {{name}}",
+  "file_browser.download_file_error": "Failed to download file",
+  "file_browser.create_folder_error": "Failed to create folder",
+  "file_browser.delete_error": "Failed to delete",
+  "file_browser.rename_error": "Failed to rename",
+  "file_browser.context_menu_view_metadata": "View Metadata",
+  "file_browser.context_menu_rename": "Rename",
+  "file_browser.context_menu_download": "Download",
+  "file_browser.context_menu_delete": "Delete",
+  "use_file_upload_toasts.job_completed": "{{count}} {{file_word}} processed for {{label}}",
+  "use_file_upload_toasts.upload_failed": "Upload failed for {{label}}: {{error}}",
+  "use_file_upload_toasts.action_required": "Action required for {{label}}",
+  "use_file_upload_toasts.action_required_description": "Review and confirm data conflicts",
+  "use_file_upload_toasts.batch_complete": "Batch complete: {{completed}}/{{total}} succeeded",
+  "pattern_preview.title": "Preview",
+  "pattern_preview.no_pattern": "(no pattern defined)",
+  "pattern_preview.file_label": "File:",
+  "pattern_preview.folder_label": "Folder:",
+  "pattern_preview.full_path_label": "Full path:",
+  "pattern_preview.example_note": "Preview uses example values from your variables",
+  "separator_picker.add_label": "Add:",
+  "separator_picker.title_hyphen": "Hyphen",
+  "separator_picker.title_underscore": "Underscore",
+  "separator_picker.title_slash": "Slash (for folder paths)",
+  "separator_picker.title_space": "Space",
+  "separator_picker.title_period": "Period"
+};
+
+// src/background_upload/react/use-file-upload-toasts.ts
+var import_i18n = require("hazo_core/i18n");
+var t_pkg = (0, import_i18n.createPackageT)("hazo_files", en_default);
 var toast_promise = null;
 function get_toast() {
   if (!toast_promise) {
@@ -332,22 +437,26 @@ function useFileUploadToasts(manager) {
         if (!t) return;
         const label = job.group_label || job.group_id;
         const n = job.files.length;
-        t.success(`${n} file${n > 1 ? "s" : ""} processed for ${label}`);
+        t.success(t_pkg("use_file_upload_toasts.job_completed", {
+          count: String(n),
+          file_word: n > 1 ? "files" : "file",
+          label
+        }));
       });
     }));
     unsubs.push(manager.on("job:error", ({ job, error }) => {
       void get_toast().then((t) => {
         if (!t) return;
         const label = job.group_label || job.group_id;
-        t.error(`Upload failed for ${label}: ${error}`);
+        t.error(t_pkg("use_file_upload_toasts.upload_failed", { label, error: String(error) }));
       });
     }));
     unsubs.push(manager.on("job:confirmation_needed", ({ job }) => {
       void get_toast().then((t) => {
         if (!t) return;
         const label = job.group_label || job.group_id;
-        t.info(`Action required for ${label}`, {
-          description: "Review and confirm data conflicts",
+        t.info(t_pkg("use_file_upload_toasts.action_required", { label }), {
+          description: t_pkg("use_file_upload_toasts.action_required_description"),
           duration: 1e4
         });
       });
@@ -356,7 +465,10 @@ function useFileUploadToasts(manager) {
       void get_toast().then((t) => {
         if (!t) return;
         if (batch.failed > 0) {
-          t.warning(`Batch complete: ${batch.completed}/${batch.total} succeeded`);
+          t.warning(t_pkg("use_file_upload_toasts.batch_complete", {
+            completed: String(batch.completed),
+            total: String(batch.total)
+          }));
         }
       });
     }));
@@ -381,7 +493,12 @@ function HazoFileUploadProvider({
   if (!manager_ref.current) {
     manager_ref.current = new UploadManager(config);
   }
+  const [, force_render] = (0, import_react3.useReducer)((n) => n + 1, 0);
   (0, import_react3.useEffect)(() => {
+    if (manager_ref.current.is_destroyed) {
+      manager_ref.current = new UploadManager(config);
+      force_render();
+    }
     const m = manager_ref.current;
     return () => {
       m.destroy();

package/dist/background-upload/react/index.mjs

@@ -1,5 +1,5 @@
 // src/background_upload/react/provider.tsx
-import { useRef, useEffect as useEffect2 } from "react";
+import { useRef, useReducer, useEffect as useEffect2 } from "react";
 
 // src/background_upload/core/upload-manager.ts
 import { generateRequestId as generateRequestId2 } from "hazo_core";
@@ -177,6 +177,9 @@ var UploadManager = class {
     this.emitter.on("job:completed", ({ job }) => this.on_job_settled(job));
     this.emitter.on("job:error", ({ job }) => this.on_job_settled(job));
   }
+  get is_destroyed() {
+    return this.destroyed;
+  }
   on(event, listener) {
     return this.emitter.on(event, listener);
   }
@@ -277,6 +280,108 @@ var FileUploadContext = createContext(null);
 
 // src/background_upload/react/use-file-upload-toasts.ts
 import { useEffect } from "react";
+
+// src/locales/en.json
+var en_default = {
+  "upload_dialog.title": "Upload Files",
+  "upload_dialog.uploading_to": "Uploading to:",
+  "upload_dialog.drop_text": "Drag and drop files here, or",
+  "upload_dialog.browse": "browse",
+  "upload_dialog.files_selected": "{{count}} file(s) selected",
+  "upload_dialog.total": "Total:",
+  "upload_dialog.cancel": "Cancel",
+  "upload_dialog.upload": "Upload",
+  "upload_dialog.select_files_error": "Please select files to upload",
+  "create_folder_dialog.title": "Create New Folder",
+  "create_folder_dialog.creating_in": "Creating folder in:",
+  "create_folder_dialog.name_label": "Folder Name",
+  "create_folder_dialog.name_placeholder": "Enter folder name",
+  "create_folder_dialog.cancel": "Cancel",
+  "create_folder_dialog.submit": "Create Folder",
+  "create_folder_dialog.name_required_error": "Please enter a folder name",
+  "create_folder_dialog.invalid_chars_error": "Folder name contains invalid characters",
+  "rename_dialog.title_folder": "Rename Folder",
+  "rename_dialog.title_file": "Rename File",
+  "rename_dialog.name_label": "New Name",
+  "rename_dialog.name_placeholder": "Enter new name",
+  "rename_dialog.cancel": "Cancel",
+  "rename_dialog.submit": "Rename",
+  "rename_dialog.name_required_error": "Please enter a name",
+  "rename_dialog.invalid_chars_error": "Name contains invalid characters",
+  "delete_confirm_dialog.title_folder": "Delete Folder",
+  "delete_confirm_dialog.title_file": "Delete File",
+  "delete_confirm_dialog.confirm_message": "Are you sure you want to delete",
+  "delete_confirm_dialog.folder_warning": "Warning: This folder and all its contents will be permanently deleted.",
+  "delete_confirm_dialog.cancel": "Cancel",
+  "delete_confirm_dialog.submit": "Delete",
+  "metadata_dialog.title": "File Metadata",
+  "metadata_dialog.close": "Close",
+  "file_actions.new_folder": "New Folder",
+  "file_actions.upload": "Upload",
+  "file_actions.download": "Download",
+  "file_actions.rename": "Rename",
+  "file_actions.delete": "Delete",
+  "file_actions.refresh": "Refresh",
+  "file_list.empty": "This folder is empty",
+  "file_list.header_name": "Name",
+  "file_list.header_size": "Size",
+  "file_list.header_modified": "Modified",
+  "folder_tree.root": "Root",
+  "file_preview.select_prompt": "Select a file to preview",
+  "file_preview.folder_label": "Folder",
+  "file_preview.created_label": "Created:",
+  "file_preview.modified_label": "Modified:",
+  "file_preview.error_loading": "Error loading preview",
+  "file_preview.video_unsupported": "Your browser does not support video playback.",
+  "file_preview.audio_unsupported": "Your browser does not support audio playback.",
+  "file_preview.no_preview": "No preview available",
+  "file_preview.size_label": "Size:",
+  "file_preview.type_label": "Type:",
+  "file_info_panel.no_item_selected": "No item selected",
+  "file_info_panel.no_custom_metadata": "No custom metadata",
+  "file_info_panel.name_label": "Name:",
+  "file_info_panel.path_label": "Path:",
+  "file_info_panel.type_label": "Type:",
+  "file_info_panel.size_label": "Size:",
+  "file_info_panel.created_label": "Created:",
+  "file_info_panel.modified_label": "Modified:",
+  "file_info_panel.storage_label": "Storage:",
+  "file_info_panel.custom_metadata_title": "Custom Metadata",
+  "file_info_panel.type_folder": "Folder",
+  "file_info_panel.type_unknown": "Unknown",
+  "file_browser.load_directory_error": "Failed to load directory",
+  "file_browser.move_item_error": "Failed to move item",
+  "file_browser.upload_file_error": "Failed to upload {{name}}",
+  "file_browser.download_file_error": "Failed to download file",
+  "file_browser.create_folder_error": "Failed to create folder",
+  "file_browser.delete_error": "Failed to delete",
+  "file_browser.rename_error": "Failed to rename",
+  "file_browser.context_menu_view_metadata": "View Metadata",
+  "file_browser.context_menu_rename": "Rename",
+  "file_browser.context_menu_download": "Download",
+  "file_browser.context_menu_delete": "Delete",
+  "use_file_upload_toasts.job_completed": "{{count}} {{file_word}} processed for {{label}}",
+  "use_file_upload_toasts.upload_failed": "Upload failed for {{label}}: {{error}}",
+  "use_file_upload_toasts.action_required": "Action required for {{label}}",
+  "use_file_upload_toasts.action_required_description": "Review and confirm data conflicts",
+  "use_file_upload_toasts.batch_complete": "Batch complete: {{completed}}/{{total}} succeeded",
+  "pattern_preview.title": "Preview",
+  "pattern_preview.no_pattern": "(no pattern defined)",
+  "pattern_preview.file_label": "File:",
+  "pattern_preview.folder_label": "Folder:",
+  "pattern_preview.full_path_label": "Full path:",
+  "pattern_preview.example_note": "Preview uses example values from your variables",
+  "separator_picker.add_label": "Add:",
+  "separator_picker.title_hyphen": "Hyphen",
+  "separator_picker.title_underscore": "Underscore",
+  "separator_picker.title_slash": "Slash (for folder paths)",
+  "separator_picker.title_space": "Space",
+  "separator_picker.title_period": "Period"
+};
+
+// src/background_upload/react/use-file-upload-toasts.ts
+import { createPackageT } from "hazo_core/i18n";
+var t_pkg = createPackageT("hazo_files", en_default);
 var toast_promise = null;
 function get_toast() {
   if (!toast_promise) {
@@ -292,22 +397,26 @@ function useFileUploadToasts(manager) {
         if (!t) return;
         const label = job.group_label || job.group_id;
         const n = job.files.length;
-        t.success(`${n} file${n > 1 ? "s" : ""} processed for ${label}`);
+        t.success(t_pkg("use_file_upload_toasts.job_completed", {
+          count: String(n),
+          file_word: n > 1 ? "files" : "file",
+          label
+        }));
       });
     }));
     unsubs.push(manager.on("job:error", ({ job, error }) => {
       void get_toast().then((t) => {
         if (!t) return;
         const label = job.group_label || job.group_id;
-        t.error(`Upload failed for ${label}: ${error}`);
+        t.error(t_pkg("use_file_upload_toasts.upload_failed", { label, error: String(error) }));
       });
     }));
     unsubs.push(manager.on("job:confirmation_needed", ({ job }) => {
       void get_toast().then((t) => {
         if (!t) return;
         const label = job.group_label || job.group_id;
-        t.info(`Action required for ${label}`, {
-          description: "Review and confirm data conflicts",
+        t.info(t_pkg("use_file_upload_toasts.action_required", { label }), {
+          description: t_pkg("use_file_upload_toasts.action_required_description"),
           duration: 1e4
         });
       });
@@ -316,7 +425,10 @@ function useFileUploadToasts(manager) {
       void get_toast().then((t) => {
         if (!t) return;
         if (batch.failed > 0) {
-          t.warning(`Batch complete: ${batch.completed}/${batch.total} succeeded`);
+          t.warning(t_pkg("use_file_upload_toasts.batch_complete", {
+            completed: String(batch.completed),
+            total: String(batch.total)
+          }));
         }
       });
     }));
@@ -341,7 +453,12 @@ function HazoFileUploadProvider({
   if (!manager_ref.current) {
     manager_ref.current = new UploadManager(config);
   }
+  const [, force_render] = useReducer((n) => n + 1, 0);
   useEffect2(() => {
+    if (manager_ref.current.is_destroyed) {
+      manager_ref.current = new UploadManager(config);
+      force_render();
+    }
     const m = manager_ref.current;
     return () => {
       m.destroy();