files.com 1.1.309 → 1.1.310

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4ba4caf21009c3188cf188a280d1f76adec2660ef522e47fb906d54d205ad8c
-  data.tar.gz: c4d36691238441dc50f125d296ca955217a3ef6824def876465f1b259c78f847
+  metadata.gz: 6ce1185b83e43ac2f0ed150a9a155b9b185a5c507a336662d68ea32474163693
+  data.tar.gz: 1b6381d8c2a4fbbaec22c4a59272028716cfe2a5457126a60d2f86a5ba2e2ac0
 SHA512:
-  metadata.gz: 8d8e630bcdbb2ff30f14f06d86176aa41863305c20d2011d151b86663fb98ffea8ceb07e935fd39a7d7abc0ec2b912fafc767337597cec18bc8ef0b97493063f
-  data.tar.gz: 5c22b138cac4106b3da4078ecb7d4eef19a933d2cbe61eb345ce49c7168687eb75ffbf9f89c2e9528f5114665051198e5929730663a347900a236d2ed14c7dd3
+  metadata.gz: 67e3746e74cec4bccfb809c4a266f942ba02ee0182d316913acf9a43b7a77d5afa9eb1de19c40bdbbeab6f5f3fa43117406a82c88f814ad666c55b8b6e64fc9a
+  data.tar.gz: 3dd482ab685b322663c2b28a2ee657c65431537e77dc4d9c0255a1d92fc341cdc7bac6b31e61968eeb9902e8bf0b668921d24b7e0717431206b6fd8cf52e2323

data/README.md

@@ -335,6 +335,61 @@ rescue Files::Error => e
 end
 ```
 
+## Paths
+
+Working with paths in Files.com involves several important considerations. Understanding how path comparisons are applied helps developers ensure consistency and accuracy across all interactions with the platform.
+<div></div>
+
+### Capitalization
+
+Files.com compares paths in a **case-insensitive** manner. This means path segments are treated as equivalent regardless of letter casing.
+
+For example, all of the following resolve to the same internal path:
+
+| Path Variant                          | Interpreted As              |
+|---------------------------------------|------------------------------|
+| `Documents/Reports/Q1.pdf`            | `documents/reports/q1.pdf`  |
+| `documents/reports/q1.PDF`            | `documents/reports/q1.pdf`  |
+| `DOCUMENTS/REPORTS/Q1.PDF`            | `documents/reports/q1.pdf`  |
+
+This behavior applies across:
+- API requests
+- Folder and file lookup operations
+- Automations and workflows
+
+See also: [Case Sensitivity Documentation](https://www.files.com/docs/files-and-folders/case-sensitivity/)
+
+### Slashes
+
+All path parameters in Files.com (API, SDKs, CLI, automations, integrations) must **omit leading and trailing slashes**. Paths are always treated as **absolute and slash-delimited**, so only internal `/` separators are used and never at the start or end of the string.
+
+####  Path Slash Examples
+| Path                              | Valid? | Notes                         |
+|-----------------------------------|--------|-------------------------------|
+| `folder/subfolder/file.txt`       |   ✅   | Correct, internal separators only |
+| `/folder/subfolder/file.txt`      |   ❌   | Leading slash not allowed     |
+| `folder/subfolder/file.txt/`      |   ❌   | Trailing slash not allowed    |
+| `//folder//file.txt`              |   ❌   | Duplicate separators not allowed |
+
+<div></div>
+
+### Unicode Normalization
+
+Files.com normalizes all paths using [Unicode NFC (Normalization Form C)](https://www.unicode.org/reports/tr15/#Norm_Forms) before comparison. This ensures consistency across different representations of the same characters.
+
+For example, the following two paths are treated as equivalent after NFC normalization:
+
+| Input                                  | Normalized Form       |
+|----------------------------------------|------------------------|
+| `uploads/\u0065\u0301.txt`             | `uploads/é.txt`        |
+| `docs/Café/Report.txt`                 | `docs/Café/Report.txt` |
+
+- All input must be UTF‑8 encoded.
+- Precomposed and decomposed characters are unified.
+- This affects search, deduplication, and comparisons across SDKs.
+
+<div></div>
+
 ## Foreign Language Support
 
 The Files.com Ruby SDK supports localized responses by using the `Files.language` configuration attribute.
@@ -609,10 +664,6 @@ rescue Files::Error => e
 end
 ```
 
-## Case Sensitivity
-
-The Files.com API compares files and paths in a case-insensitive manner. For related documentation see [Case Sensitivity Documentation](https://www.files.com/docs/files-and-folders/file-system-semantics/case-sensitivity).
-
 ## Mock Server
 
 Files.com publishes a Files.com API server, which is useful for testing your use of the Files.com

data/_VERSION

@@ -1 +1 @@
-1.1.309
+1.1.310

data/lib/files.com/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Files
-  VERSION = "1.1.309"
+  VERSION = "1.1.310"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.309
+  version: 1.1.310
 platform: ruby
 authors:
 - files.com