@brftech/filex-core 0.32.0 → 0.33.0

package/dist/index.d.ts

@@ -672,6 +672,15 @@ declare type Density = 'comfortable' | 'compact';
  */
 export declare function deriveKek(password: string, salt: Uint8Array, iterations: number): Promise<CryptoKey>;
 
+/**
+ * The browser's preference, or `en`.
+ *
+ * ⚠ Guarded for a non-browser runtime: this package is imported by SSR and by
+ * unit tests under Node, where `navigator` is absent — and an exception here
+ * would take down the whole explorer over a language choice.
+ */
+export declare function detectLocale(): LocaleCode;
+
 export declare const E2E_DEFAULT_ITERATIONS = 600000;
 
 /** The only escrow algorithm this version understands. */
@@ -1014,7 +1023,7 @@ export declare interface ExplorerConfig {
      */
     onlyOfficeConfig?: string;
     /**
-     * Standalone editor page base — when set, "Aç" on an office file
+     * Standalone editor page base — when set, "Open" on an office file
      * opens `${openPageBase}?path=...&mode=edit` in a new tab instead
      * of the modal preview.
      */
@@ -2221,7 +2230,7 @@ export declare interface OperationInput {
     percent: number | null;
     status: OperationStatus;
     error?: string | null;
-    /** Queue op accepted but not started yet ("Sırada"). */
+    /** Queue op accepted but not started yet ("Queued"). */
     queued?: boolean;
     /** Progress counters for queue ops (3/5 items). */
     doneCount?: number;
@@ -2249,9 +2258,9 @@ export declare interface OperationInput {
  * are registered per row so the panel can route user intent back to the
  * owning surface without the store knowing any transport details.
  *
- * Lifecycle rules (per the İşlem Merkezi contract):
+ * Lifecycle rules (per the Operations Center contract):
  *   - running rows live in `active`;
- *   - done/aborted rows linger in `active` for DONE_LINGER_MS ("bitti"
+ *   - done/aborted rows linger in `active` for DONE_LINGER_MS ("done"
  *     flash) then move to `history` (session-only, capped);
  *   - error rows are STICKY: they stay in `active` until the user
  *     dismisses or retries them — even after the source list swept them
@@ -2435,6 +2444,31 @@ declare interface ResolveEmailResponse {
  */
 export declare function resolveEndpoints(config: ExplorerConfig): EndpointMap;
 
+/**
+ * Resolve the locale to render in.
+ *
+ * Order, and the reasoning for it:
+ *
+ *   1. **What the host asked for.** An explicit `locale` always wins. A host
+ *      that names a language has made a decision, and guessing over it would
+ *      make the prop advisory.
+ *   2. **What the browser asks for**, via `navigator.languages` /
+ *      `navigator.language` — the same signal `Accept-Language` carries, and
+ *      the reason a Turkish reader gets Turkish without the embedder doing
+ *      anything.
+ *   3. **`en`.**
+ *
+ * ⚠ Step 2 makes the same embed render differently for two people. That is
+ * deliberate — it is what "follow the browser" means — but it also means a
+ * screenshot, a test or a bug report about this component must state its
+ * locale, because the component alone no longer determines it. Pass an
+ * explicit `locale` anywhere the answer has to be stable.
+ *
+ * Matching is on the primary subtag, so `tr-TR` and `en-GB` resolve; anything
+ * with no catalogue falls through rather than half-rendering.
+ */
+export declare function resolveLocale(explicit?: LocaleCode | '' | null): LocaleCode;
+
 /** How long an unfinished record is worth keeping. The server sweeps its own
  *  staging after FILEX_UPLOAD_STAGING_TTL (24 h by default); a note that
  *  outlives the bytes it describes only produces a confusing "resuming…" that
@@ -3120,10 +3154,17 @@ export declare interface UploadOptions {
     onDone?: (job: UploadJob, result: UploadResult) => void;
     onError?: (job: UploadJob, err: Error) => void;
     /**
-     * Wait for the backend transfer before resolving. Default false: the node is
-     * listed the moment the commit is accepted, which is the whole point of
-     * staging. `true` is for a caller that must not report success until the
-     * bytes are on the driver.
+     * Wait for the backend transfer before resolving. Defaults to TRUE, because
+     * "the server has the bytes" and "the storage has the bytes" are different
+     * claims and only the second one is an upload.
+     *
+     * ⚠ It used to default to false and no caller ever set it, so the job went
+     * straight to `done` on the 202 — a transfer that failed afterwards in the
+     * ops worker left the user looking at a finished upload for a file that was
+     * never stored (issue #16: every file over the chunk threshold, on every S3
+     * backend). The `transferring` phase is short for a healthy storage and is
+     * the only place a failure can still be shown, so it is the default; pass
+     * false to opt out where the wait is genuinely unwanted.
      */
     waitForTransfer?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brftech/filex-core",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "filex core — Vue 3 source of truth for the filex file manager (FileExplorer + ConnectionsPanel SFCs, composables, types)",
   "type": "module",
   "main": "./dist/filex-core.umd.cjs",