ldap-rest 0.16.1 → 0.17.0

package/docs/usage/plugins/integrations/james-mail.md

@@ -20,7 +20,7 @@ The `twake/james` plugin automatically synchronizes email address and quota chan
 --plugin twake/james \
 --ldap-flat-schema ./static/schemas/twake/users.json \
 --mail-attribute mail \
---quota-attribute mailQuota \
+--quota-attribute mailQuotaSize \
 --james-webadmin-url http://james:8000 \
 --james-webadmin-token "your-admin-token"
 ```
@@ -37,7 +37,7 @@ DM_JAMES_WEBADMIN_TOKEN="your-admin-token"
 - `--james-webadmin-url`: James WebAdmin API base URL (required)
 - `--james-webadmin-token`: Bearer token for James WebAdmin authentication (optional)
 - `--mail-attribute`: LDAP attribute for email (default: `mail`)
-- `--quota-attribute`: LDAP attribute for quota (default: `mailQuota`)
+- `--quota-attribute`: LDAP attribute for quota (default: `mailQuotaSize`)
 - `--alias-attribute`: LDAP attribute for email aliases (default: `mailAlternateAddress`)
 - `--james-mailbox-type-attribute`: LDAP attribute for mailbox type (default: `twakeMailboxType`)
 
@@ -130,7 +130,7 @@ When a user's quota changes:
    PUT /api/v1/ldap/users/jdoe
    {
      "replace": {
-       "mailQuota": "5000000000"
+       "mailQuotaSize": "5000000000"
      }
    }
    ```
@@ -646,7 +646,7 @@ Alternative authentication methods (Basic Auth, JWT) can be configured via rever
 --plugin twake/james \
 --ldap-flat-schema ./schemas/twake/users.json \
 --mail-attribute mail \
---quota-attribute mailQuota \
+--quota-attribute mailQuotaSize \
 --james-webadmin-url http://james:8000
 ```
 
@@ -663,7 +663,7 @@ Alternative authentication methods (Basic Auth, JWT) can be configured via rever
 --ldap-flat-schema ./schemas/twake/users.json \
 --ldap-flat-schema ./schemas/twake/positions.json \
 --mail-attribute mail \
---quota-attribute mailQuota \
+--quota-attribute mailQuotaSize \
 --james-webadmin-url http://james:8000 \
 --james-webadmin-token "james-admin-token" \
 --static-path ./static \
@@ -770,7 +770,7 @@ curl http://james:8000/users/john.doe@company.com
 curl -X PUT http://localhost:8081/api/v1/ldap/users/jdoe \
   -H "Authorization: Bearer admin-token" \
   -H "Content-Type: application/json" \
-  -d '{"replace": {"mailQuota": "5000000000"}}'
+  -d '{"replace": {"mailQuotaSize": "5000000000"}}'
 
 # Verify in James
 curl http://james:8000/quota/users/jdoe@company.com/size
@@ -780,12 +780,12 @@ curl http://james:8000/quota/users/jdoe@company.com/size
 
 Quota values are in **bytes**:
 
-| Size      | Bytes       | Example                      |
-| --------- | ----------- | ---------------------------- |
-| 1 GB      | 1000000000  | `"mailQuota": "1000000000"`  |
-| 5 GB      | 5000000000  | `"mailQuota": "5000000000"`  |
-| 10 GB     | 10000000000 | `"mailQuota": "10000000000"` |
-| Unlimited | -1          | `"mailQuota": "-1"`          |
+| Size      | Bytes       | Example                          |
+| --------- | ----------- | -------------------------------- |
+| 1 GB      | 1000000000  | `"mailQuotaSize": "1000000000"`  |
+| 5 GB      | 5000000000  | `"mailQuotaSize": "5000000000"`  |
+| 10 GB     | 10000000000 | `"mailQuotaSize": "10000000000"` |
+| Unlimited | -1          | `"mailQuotaSize": "-1"`          |
 
 ## Synchronization Scenarios
 
@@ -941,7 +941,7 @@ hooks: {
 
    ```bash
    --mail-attribute mail
-   --quota-attribute mailQuota
+   --quota-attribute mailQuotaSize
    ```
 
 3. Enable debug logging:

package/docs/usage/plugins/ldap/README.md

@@ -48,6 +48,7 @@ DELETE /api/v1/ldap/groups/{cn}            # Delete group
 GET    /api/v1/ldap/organizations/top                    # Root organization
 GET    /api/v1/ldap/organizations/{dn}/subnodes         # Sub-organizations
 GET    /api/v1/ldap/organizations/{dn}/subnodes/search  # Search
+GET    /api/v1/ldap/organizations/{dn}/search           # Search the whole subtree
 POST   /api/v1/ldap/organizations                       # Create
 PUT    /api/v1/ldap/organizations/{dn}                  # Modify
 POST   /api/v1/ldap/organizations/{dn}/move             # Move

package/docs/usage/plugins/ldap/on-change.md

@@ -8,7 +8,7 @@ LDAP-Rest, and hooks for the attributes other plugins follow.
 ```bash
 --plugin core/ldap/onChange \
 --mail-attribute mail \
---quota-attribute mailQuota
+--quota-attribute mailQuotaSize
 ```
 
 ## Hooks

package/docs/usage/upgrading.md

@@ -4,6 +4,20 @@ What to check before deploying, newest first. Only releases that need a
 decision or a configuration change appear here; see the
 [CHANGELOG](../../CHANGELOG.md) for everything else.
 
+## To 0.17.0
+
+### The quota attribute defaults to `mailQuotaSize`
+
+**Who is affected:** a deployment that loads `twake/james` or
+`core/ldap/onChange`, or runs `bin/sync-james.mjs`, without setting
+`--quota-attribute` (`DM_QUOTA_ATTRIBUTE`).
+
+The default is now `mailQuotaSize`, the attribute the Twake schemas define,
+instead of `mailQuota`. A directory that holds the quota in `mailQuota` must
+set `DM_QUOTA_ATTRIBUTE=mailQuota` (or `--quota-attribute mailQuota`):
+without it, quota changes are no longer sent to the mail server. A deployment
+that already sets the option is unchanged.
+
 ## To 0.16.0
 
 ### Space events need the organization domain attribute

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ldap-rest",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Light directory manager",
   "keywords": [
     "Identity-Manager"

package/static/schemas/twake/users.json

@@ -171,16 +171,6 @@
         "fr": "Autres boîtes"
       }
     },
-    "mailQuota": {
-      "type": "number",
-      "required": false,
-      "role": "emailQuota",
-      "group": "Mailbox Settings",
-      "label": {
-        "en": "Mail quota",
-        "fr": "Quota"
-      }
-    },
     "mailQuotaSize": {
       "type": "number",
       "required": false,