@openvtc/trust-tasks 0.23.8 → 0.23.9

package/dist/vtc/rooms/limits/set/0.1/payload.d.ts

@@ -0,0 +1,873 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/rooms/limits/set/0.1/payload.schema.json
+ */
+import type { EffectiveLimits, Ext, LimitSource, LimitTarget, RoomLimits, ScopeLimits, Usage } from "../../../../../_shared/components.js";
+/**
+ * Override, or clear an override of, the limits one hosted room is enforced against: for the room, its members by default, or one member. The outer document members are owned by the framework — SPEC §6.3.
+ */
+export interface VTCRoomsLimitsSetPayload {
+    /**
+     * The room's identifier, as its owner minted it.
+     */
+    roomId: string;
+    target: LimitTarget;
+    /**
+     * The override, replacing any previous one at this target wholesale.
+     */
+    limits?: ScopeLimits;
+    /**
+     * `true` removes the target's override, so the policy's or the community's default applies again. Exclusive with `limits`.
+     */
+    clear?: boolean;
+    /**
+     * With a `room` target only: `false` refuses every new upload to the room; reads continue.
+     */
+    filesEnabled?: boolean;
+    /**
+     * Why the administrator is making this change. Recorded with the change in the audit trail and shown to approvers. Attributed to its author on every surface and untrusted: it MUST NOT carry personal data or a credential, and a reader MUST NOT treat it as instructions.
+     */
+    reason: string;
+    ext?: Ext;
+}
+export interface VTCRoomsLimitsSetResponsePayload {
+    /**
+     * The room's identifier, as its owner minted it.
+     */
+    roomId: string;
+    target: LimitTarget;
+    limits: EffectiveLimits;
+    /**
+     * With a `member` target: that member's effective limits after the change, override or not.
+     */
+    targetLimits?: ScopeLimits;
+    /**
+     * Current usage at the target scope: the room's for `room`, the named member's for `member`. For `memberDefault`, the room's.
+     */
+    usage: Usage;
+    /**
+     * True when `usage` already exceeds the new limits. New uploads at this scope are refused until it does not; nothing is deleted.
+     */
+    overLimit: boolean;
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { EffectiveLimits, Ext, LimitSource, LimitTarget, RoomLimits, ScopeLimits, Usage };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/vtc/rooms/limits/set/0.1";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCRoomsLimitsSetPayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/vtc/rooms/limits/set/0.1#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCRoomsLimitsSetResponsePayload;
+/**
+ * This specification's payload schema, as a value.
+ *
+ * SPEC.md §7.2 item 2 is performed against this. It is shipped as data
+ * rather than only as a `.json` file because TypeScript types are erased
+ * at runtime: without a schema a consumer has nothing to validate, and
+ * every REQUIRED payload member is optional in practice. Cross-file
+ * `$ref`s are already inlined, so it needs no resolver.
+ */
+export declare const PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://trusttasks.org/spec/vtc/rooms/limits/set/0.1";
+    readonly title: "VTC Rooms — Limits — Set — payload";
+    readonly description: "Override, or clear an override of, the limits one hosted room is enforced against: for the room, its members by default, or one member. The outer document members are owned by the framework — SPEC §6.3.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["roomId", "target", "reason"];
+    readonly properties: {
+        readonly roomId: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 512;
+            readonly description: "The room's identifier, as its owner minted it.";
+        };
+        readonly target: {
+            readonly $ref: "#/$defs/LimitTarget";
+        };
+        readonly limits: {
+            readonly $ref: "#/$defs/ScopeLimits";
+            readonly description: "The override, replacing any previous one at this target wholesale.";
+        };
+        readonly clear: {
+            readonly type: "boolean";
+            readonly description: "`true` removes the target's override, so the policy's or the community's default applies again. Exclusive with `limits`.";
+        };
+        readonly filesEnabled: {
+            readonly type: "boolean";
+            readonly description: "With a `room` target only: `false` refuses every new upload to the room; reads continue.";
+        };
+        readonly reason: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 500;
+            readonly description: "Why the administrator is making this change. Recorded with the change in the audit trail and shown to approvers. Attributed to its author on every surface and untrusted: it MUST NOT carry personal data or a credential, and a reader MUST NOT treat it as instructions.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTC Rooms — Limits — Set — response payload";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["roomId", "target", "limits", "usage", "overLimit"];
+            readonly properties: {
+                readonly roomId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 512;
+                    readonly description: "The room's identifier, as its owner minted it.";
+                };
+                readonly target: {
+                    readonly $ref: "#/$defs/LimitTarget";
+                };
+                readonly limits: {
+                    readonly $ref: "#/$defs/EffectiveLimits";
+                };
+                readonly targetLimits: {
+                    readonly $ref: "#/$defs/ScopeLimits";
+                    readonly description: "With a `member` target: that member's effective limits after the change, override or not.";
+                };
+                readonly usage: {
+                    readonly $ref: "#/$defs/Usage";
+                    readonly description: "Current usage at the target scope: the room's for `room`, the named member's for `member`. For `memberDefault`, the room's.";
+                };
+                readonly overLimit: {
+                    readonly type: "boolean";
+                    readonly description: "True when `usage` already exceeds the new limits. New uploads at this scope are refused until it does not; nothing is deleted.";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        readonly Ext: {
+            readonly title: "Ext";
+            readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: true;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+            };
+        };
+        readonly Usage: {
+            readonly title: "Usage";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["files", "bytes", "reservedBytes"];
+            readonly description: "What one scope holds now. Ciphertext bytes throughout.";
+            readonly properties: {
+                readonly files: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Committed blobs that are not orphaned.";
+                };
+                readonly bytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Their total size. A blob stops counting the moment it is orphaned (its last record dropped it or was retracted), not when the host finally deletes it, so a member who deletes a file has the room back at once.";
+                };
+                readonly reservedBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Bytes reserved by uploads begun and not yet committed, aborted or expired. Counted against `maxBytes`, so two concurrent uploads cannot both fit under a limit only one of them fits.";
+                };
+                readonly reservedFiles: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Uploads begun and not yet committed, aborted or expired. Counted against `maxFiles`.";
+                };
+            };
+        };
+        readonly ScopeLimits: {
+            readonly title: "ScopeLimits";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "Limits at one scope. Every member is optional: an absent member means the scope sets no limit of that kind, and the next wider scope's limit, or the host's ceiling, governs. All sizes are ciphertext bytes.";
+            readonly properties: {
+                readonly maxFiles: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "The number of committed blobs the scope may hold. 0 refuses every upload at this scope.";
+                };
+                readonly maxFileBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: 1073741824;
+                    readonly description: "The largest single blob the scope accepts. Never above 1 GiB, the transfer ceiling (BlobManifest).";
+                };
+                readonly maxBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "The total size of the committed and reserved blobs the scope may hold.";
+                };
+            };
+        };
+        readonly EffectiveLimits: {
+            readonly title: "EffectiveLimits";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["limits", "roomSource", "memberSource"];
+            readonly description: "The limits a room is enforced against now, with where each scope's came from.";
+            readonly properties: {
+                readonly limits: {
+                    readonly $ref: "#/$defs/RoomLimits";
+                };
+                readonly roomSource: {
+                    readonly $ref: "#/$defs/LimitSource";
+                };
+                readonly memberSource: {
+                    readonly $ref: "#/$defs/LimitSource";
+                };
+                readonly hostCeilingBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: 1073741824;
+                    readonly description: "The host-wide largest-file ceiling, which no room or member limit can exceed.";
+                };
+            };
+        };
+        readonly LimitSource: {
+            readonly title: "LimitSource";
+            readonly type: "string";
+            readonly enum: readonly ["policy", "override", "default"];
+            readonly description: "Where an effective limit came from. `policy`: the community's rooms policy at the room's creation. `override`: an administrator's vtc/rooms/limits/set. `default`: the community's configured defaults, where neither applies. The host-wide ceiling bounds all three.";
+        };
+        readonly RoomLimits: {
+            readonly title: "RoomLimits";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["filesEnabled"];
+            readonly description: "How much a host is willing to store for one room, at the room and per member. A hosting decision, set by the host and never by anything in the room's credentials. An upload must fit every scope at once: the object against the smallest `maxFileBytes` that applies, and the member and the room with the file added.";
+            readonly properties: {
+                readonly filesEnabled: {
+                    readonly type: "boolean";
+                    readonly description: "False refuses every rooms/blobs/* upload for the room. Reads of blobs already stored continue.";
+                };
+                readonly room: {
+                    readonly $ref: "#/$defs/ScopeLimits";
+                    readonly description: "Limits on the room as a whole.";
+                };
+                readonly member: {
+                    readonly $ref: "#/$defs/ScopeLimits";
+                    readonly description: "Limits on each member's own uploads in this room, unless that member has an override. A member is the subject at the root of the authority chain they present, never the key that signed, so an agent acting on an attenuated chain spends its member's allowance. Not applied on a `private` room, where the host cannot tell members apart; the room and object limits still hold there.";
+                };
+            };
+        };
+        readonly LimitTarget: {
+            readonly title: "LimitTarget";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["kind"];
+            readonly description: "Which limits an override applies to. `room`: the room as a whole. `memberDefault`: every member of the room who has no override of their own. `member`: one named member — `member` is REQUIRED with this kind and forbidden with the others, a rule this schema does not express; a community refuses a violation with `malformedRequest`.";
+            readonly properties: {
+                readonly kind: {
+                    readonly type: "string";
+                    readonly enum: readonly ["room", "memberDefault", "member"];
+                };
+                readonly member: {
+                    readonly type: "string";
+                    readonly pattern: "^did:";
+                    readonly maxLength: 2048;
+                    readonly description: "The member's DID: the subject at the root of the authority chains they present, which is what their uploads are charged to.";
+                };
+            };
+        };
+    };
+};
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export declare const RESPONSE_PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $ref: "#/$defs/Response";
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTC Rooms — Limits — Set — response payload";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["roomId", "target", "limits", "usage", "overLimit"];
+            readonly properties: {
+                readonly roomId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 512;
+                    readonly description: "The room's identifier, as its owner minted it.";
+                };
+                readonly target: {
+                    readonly $ref: "#/$defs/LimitTarget";
+                };
+                readonly limits: {
+                    readonly $ref: "#/$defs/EffectiveLimits";
+                };
+                readonly targetLimits: {
+                    readonly $ref: "#/$defs/ScopeLimits";
+                    readonly description: "With a `member` target: that member's effective limits after the change, override or not.";
+                };
+                readonly usage: {
+                    readonly $ref: "#/$defs/Usage";
+                    readonly description: "Current usage at the target scope: the room's for `room`, the named member's for `member`. For `memberDefault`, the room's.";
+                };
+                readonly overLimit: {
+                    readonly type: "boolean";
+                    readonly description: "True when `usage` already exceeds the new limits. New uploads at this scope are refused until it does not; nothing is deleted.";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        readonly Ext: {
+            readonly title: "Ext";
+            readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: true;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+            };
+        };
+        readonly Usage: {
+            readonly title: "Usage";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["files", "bytes", "reservedBytes"];
+            readonly description: "What one scope holds now. Ciphertext bytes throughout.";
+            readonly properties: {
+                readonly files: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Committed blobs that are not orphaned.";
+                };
+                readonly bytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Their total size. A blob stops counting the moment it is orphaned (its last record dropped it or was retracted), not when the host finally deletes it, so a member who deletes a file has the room back at once.";
+                };
+                readonly reservedBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Bytes reserved by uploads begun and not yet committed, aborted or expired. Counted against `maxBytes`, so two concurrent uploads cannot both fit under a limit only one of them fits.";
+                };
+                readonly reservedFiles: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Uploads begun and not yet committed, aborted or expired. Counted against `maxFiles`.";
+                };
+            };
+        };
+        readonly ScopeLimits: {
+            readonly title: "ScopeLimits";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "Limits at one scope. Every member is optional: an absent member means the scope sets no limit of that kind, and the next wider scope's limit, or the host's ceiling, governs. All sizes are ciphertext bytes.";
+            readonly properties: {
+                readonly maxFiles: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "The number of committed blobs the scope may hold. 0 refuses every upload at this scope.";
+                };
+                readonly maxFileBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: 1073741824;
+                    readonly description: "The largest single blob the scope accepts. Never above 1 GiB, the transfer ceiling (BlobManifest).";
+                };
+                readonly maxBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "The total size of the committed and reserved blobs the scope may hold.";
+                };
+            };
+        };
+        readonly EffectiveLimits: {
+            readonly title: "EffectiveLimits";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["limits", "roomSource", "memberSource"];
+            readonly description: "The limits a room is enforced against now, with where each scope's came from.";
+            readonly properties: {
+                readonly limits: {
+                    readonly $ref: "#/$defs/RoomLimits";
+                };
+                readonly roomSource: {
+                    readonly $ref: "#/$defs/LimitSource";
+                };
+                readonly memberSource: {
+                    readonly $ref: "#/$defs/LimitSource";
+                };
+                readonly hostCeilingBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: 1073741824;
+                    readonly description: "The host-wide largest-file ceiling, which no room or member limit can exceed.";
+                };
+            };
+        };
+        readonly LimitSource: {
+            readonly title: "LimitSource";
+            readonly type: "string";
+            readonly enum: readonly ["policy", "override", "default"];
+            readonly description: "Where an effective limit came from. `policy`: the community's rooms policy at the room's creation. `override`: an administrator's vtc/rooms/limits/set. `default`: the community's configured defaults, where neither applies. The host-wide ceiling bounds all three.";
+        };
+        readonly RoomLimits: {
+            readonly title: "RoomLimits";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["filesEnabled"];
+            readonly description: "How much a host is willing to store for one room, at the room and per member. A hosting decision, set by the host and never by anything in the room's credentials. An upload must fit every scope at once: the object against the smallest `maxFileBytes` that applies, and the member and the room with the file added.";
+            readonly properties: {
+                readonly filesEnabled: {
+                    readonly type: "boolean";
+                    readonly description: "False refuses every rooms/blobs/* upload for the room. Reads of blobs already stored continue.";
+                };
+                readonly room: {
+                    readonly $ref: "#/$defs/ScopeLimits";
+                    readonly description: "Limits on the room as a whole.";
+                };
+                readonly member: {
+                    readonly $ref: "#/$defs/ScopeLimits";
+                    readonly description: "Limits on each member's own uploads in this room, unless that member has an override. A member is the subject at the root of the authority chain they present, never the key that signed, so an agent acting on an attenuated chain spends its member's allowance. Not applied on a `private` room, where the host cannot tell members apart; the room and object limits still hold there.";
+                };
+            };
+        };
+        readonly LimitTarget: {
+            readonly title: "LimitTarget";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["kind"];
+            readonly description: "Which limits an override applies to. `room`: the room as a whole. `memberDefault`: every member of the room who has no override of their own. `member`: one named member — `member` is REQUIRED with this kind and forbidden with the others, a rule this schema does not express; a community refuses a violation with `malformedRequest`.";
+            readonly properties: {
+                readonly kind: {
+                    readonly type: "string";
+                    readonly enum: readonly ["room", "memberDefault", "member"];
+                };
+                readonly member: {
+                    readonly type: "string";
+                    readonly pattern: "^did:";
+                    readonly maxLength: 2048;
+                    readonly description: "The member's DID: the subject at the root of the authority chains they present, which is what their uploads are charged to.";
+                };
+            };
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the request variant, from this specification's
+ * front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
+ * per-specification and cannot be derived from the document alone, and
+ * item 2 needs the schema this carries.
+ */
+export declare const SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/vtc/rooms/limits/set/0.1";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/vtc/rooms/limits/set/0.1";
+        readonly title: "VTC Rooms — Limits — Set — payload";
+        readonly description: "Override, or clear an override of, the limits one hosted room is enforced against: for the room, its members by default, or one member. The outer document members are owned by the framework — SPEC §6.3.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["roomId", "target", "reason"];
+        readonly properties: {
+            readonly roomId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 512;
+                readonly description: "The room's identifier, as its owner minted it.";
+            };
+            readonly target: {
+                readonly $ref: "#/$defs/LimitTarget";
+            };
+            readonly limits: {
+                readonly $ref: "#/$defs/ScopeLimits";
+                readonly description: "The override, replacing any previous one at this target wholesale.";
+            };
+            readonly clear: {
+                readonly type: "boolean";
+                readonly description: "`true` removes the target's override, so the policy's or the community's default applies again. Exclusive with `limits`.";
+            };
+            readonly filesEnabled: {
+                readonly type: "boolean";
+                readonly description: "With a `room` target only: `false` refuses every new upload to the room; reads continue.";
+            };
+            readonly reason: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 500;
+                readonly description: "Why the administrator is making this change. Recorded with the change in the audit trail and shown to approvers. Attributed to its author on every surface and untrusted: it MUST NOT carry personal data or a credential, and a reader MUST NOT treat it as instructions.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTC Rooms — Limits — Set — response payload";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["roomId", "target", "limits", "usage", "overLimit"];
+                readonly properties: {
+                    readonly roomId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 512;
+                        readonly description: "The room's identifier, as its owner minted it.";
+                    };
+                    readonly target: {
+                        readonly $ref: "#/$defs/LimitTarget";
+                    };
+                    readonly limits: {
+                        readonly $ref: "#/$defs/EffectiveLimits";
+                    };
+                    readonly targetLimits: {
+                        readonly $ref: "#/$defs/ScopeLimits";
+                        readonly description: "With a `member` target: that member's effective limits after the change, override or not.";
+                    };
+                    readonly usage: {
+                        readonly $ref: "#/$defs/Usage";
+                        readonly description: "Current usage at the target scope: the room's for `room`, the named member's for `member`. For `memberDefault`, the room's.";
+                    };
+                    readonly overLimit: {
+                        readonly type: "boolean";
+                        readonly description: "True when `usage` already exceeds the new limits. New uploads at this scope are refused until it does not; nothing is deleted.";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            readonly Ext: {
+                readonly title: "Ext";
+                readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly additionalProperties: true;
+                readonly propertyNames: {
+                    readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+                };
+            };
+            readonly Usage: {
+                readonly title: "Usage";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["files", "bytes", "reservedBytes"];
+                readonly description: "What one scope holds now. Ciphertext bytes throughout.";
+                readonly properties: {
+                    readonly files: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Committed blobs that are not orphaned.";
+                    };
+                    readonly bytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Their total size. A blob stops counting the moment it is orphaned (its last record dropped it or was retracted), not when the host finally deletes it, so a member who deletes a file has the room back at once.";
+                    };
+                    readonly reservedBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Bytes reserved by uploads begun and not yet committed, aborted or expired. Counted against `maxBytes`, so two concurrent uploads cannot both fit under a limit only one of them fits.";
+                    };
+                    readonly reservedFiles: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Uploads begun and not yet committed, aborted or expired. Counted against `maxFiles`.";
+                    };
+                };
+            };
+            readonly ScopeLimits: {
+                readonly title: "ScopeLimits";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly description: "Limits at one scope. Every member is optional: an absent member means the scope sets no limit of that kind, and the next wider scope's limit, or the host's ceiling, governs. All sizes are ciphertext bytes.";
+                readonly properties: {
+                    readonly maxFiles: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "The number of committed blobs the scope may hold. 0 refuses every upload at this scope.";
+                    };
+                    readonly maxFileBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 1073741824;
+                        readonly description: "The largest single blob the scope accepts. Never above 1 GiB, the transfer ceiling (BlobManifest).";
+                    };
+                    readonly maxBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "The total size of the committed and reserved blobs the scope may hold.";
+                    };
+                };
+            };
+            readonly EffectiveLimits: {
+                readonly title: "EffectiveLimits";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["limits", "roomSource", "memberSource"];
+                readonly description: "The limits a room is enforced against now, with where each scope's came from.";
+                readonly properties: {
+                    readonly limits: {
+                        readonly $ref: "#/$defs/RoomLimits";
+                    };
+                    readonly roomSource: {
+                        readonly $ref: "#/$defs/LimitSource";
+                    };
+                    readonly memberSource: {
+                        readonly $ref: "#/$defs/LimitSource";
+                    };
+                    readonly hostCeilingBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 1073741824;
+                        readonly description: "The host-wide largest-file ceiling, which no room or member limit can exceed.";
+                    };
+                };
+            };
+            readonly LimitSource: {
+                readonly title: "LimitSource";
+                readonly type: "string";
+                readonly enum: readonly ["policy", "override", "default"];
+                readonly description: "Where an effective limit came from. `policy`: the community's rooms policy at the room's creation. `override`: an administrator's vtc/rooms/limits/set. `default`: the community's configured defaults, where neither applies. The host-wide ceiling bounds all three.";
+            };
+            readonly RoomLimits: {
+                readonly title: "RoomLimits";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["filesEnabled"];
+                readonly description: "How much a host is willing to store for one room, at the room and per member. A hosting decision, set by the host and never by anything in the room's credentials. An upload must fit every scope at once: the object against the smallest `maxFileBytes` that applies, and the member and the room with the file added.";
+                readonly properties: {
+                    readonly filesEnabled: {
+                        readonly type: "boolean";
+                        readonly description: "False refuses every rooms/blobs/* upload for the room. Reads of blobs already stored continue.";
+                    };
+                    readonly room: {
+                        readonly $ref: "#/$defs/ScopeLimits";
+                        readonly description: "Limits on the room as a whole.";
+                    };
+                    readonly member: {
+                        readonly $ref: "#/$defs/ScopeLimits";
+                        readonly description: "Limits on each member's own uploads in this room, unless that member has an override. A member is the subject at the root of the authority chain they present, never the key that signed, so an agent acting on an attenuated chain spends its member's allowance. Not applied on a `private` room, where the host cannot tell members apart; the room and object limits still hold there.";
+                    };
+                };
+            };
+            readonly LimitTarget: {
+                readonly title: "LimitTarget";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["kind"];
+                readonly description: "Which limits an override applies to. `room`: the room as a whole. `memberDefault`: every member of the room who has no override of their own. `member`: one named member — `member` is REQUIRED with this kind and forbidden with the others, a rule this schema does not express; a community refuses a violation with `malformedRequest`.";
+                readonly properties: {
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly enum: readonly ["room", "memberDefault", "member"];
+                    };
+                    readonly member: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                        readonly description: "The member's DID: the subject at the root of the authority chains they present, which is what their uploads are charged to.";
+                    };
+                };
+            };
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
+ * tracks the *issuer* party's requirement because a response swaps the
+ * parties (§7.3 item 5).
+ */
+export declare const RESPONSE_SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/vtc/rooms/limits/set/0.1#response";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTC Rooms — Limits — Set — response payload";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["roomId", "target", "limits", "usage", "overLimit"];
+                readonly properties: {
+                    readonly roomId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 512;
+                        readonly description: "The room's identifier, as its owner minted it.";
+                    };
+                    readonly target: {
+                        readonly $ref: "#/$defs/LimitTarget";
+                    };
+                    readonly limits: {
+                        readonly $ref: "#/$defs/EffectiveLimits";
+                    };
+                    readonly targetLimits: {
+                        readonly $ref: "#/$defs/ScopeLimits";
+                        readonly description: "With a `member` target: that member's effective limits after the change, override or not.";
+                    };
+                    readonly usage: {
+                        readonly $ref: "#/$defs/Usage";
+                        readonly description: "Current usage at the target scope: the room's for `room`, the named member's for `member`. For `memberDefault`, the room's.";
+                    };
+                    readonly overLimit: {
+                        readonly type: "boolean";
+                        readonly description: "True when `usage` already exceeds the new limits. New uploads at this scope are refused until it does not; nothing is deleted.";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            readonly Ext: {
+                readonly title: "Ext";
+                readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly additionalProperties: true;
+                readonly propertyNames: {
+                    readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+                };
+            };
+            readonly Usage: {
+                readonly title: "Usage";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["files", "bytes", "reservedBytes"];
+                readonly description: "What one scope holds now. Ciphertext bytes throughout.";
+                readonly properties: {
+                    readonly files: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Committed blobs that are not orphaned.";
+                    };
+                    readonly bytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Their total size. A blob stops counting the moment it is orphaned (its last record dropped it or was retracted), not when the host finally deletes it, so a member who deletes a file has the room back at once.";
+                    };
+                    readonly reservedBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Bytes reserved by uploads begun and not yet committed, aborted or expired. Counted against `maxBytes`, so two concurrent uploads cannot both fit under a limit only one of them fits.";
+                    };
+                    readonly reservedFiles: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Uploads begun and not yet committed, aborted or expired. Counted against `maxFiles`.";
+                    };
+                };
+            };
+            readonly ScopeLimits: {
+                readonly title: "ScopeLimits";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly description: "Limits at one scope. Every member is optional: an absent member means the scope sets no limit of that kind, and the next wider scope's limit, or the host's ceiling, governs. All sizes are ciphertext bytes.";
+                readonly properties: {
+                    readonly maxFiles: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "The number of committed blobs the scope may hold. 0 refuses every upload at this scope.";
+                    };
+                    readonly maxFileBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 1073741824;
+                        readonly description: "The largest single blob the scope accepts. Never above 1 GiB, the transfer ceiling (BlobManifest).";
+                    };
+                    readonly maxBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "The total size of the committed and reserved blobs the scope may hold.";
+                    };
+                };
+            };
+            readonly EffectiveLimits: {
+                readonly title: "EffectiveLimits";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["limits", "roomSource", "memberSource"];
+                readonly description: "The limits a room is enforced against now, with where each scope's came from.";
+                readonly properties: {
+                    readonly limits: {
+                        readonly $ref: "#/$defs/RoomLimits";
+                    };
+                    readonly roomSource: {
+                        readonly $ref: "#/$defs/LimitSource";
+                    };
+                    readonly memberSource: {
+                        readonly $ref: "#/$defs/LimitSource";
+                    };
+                    readonly hostCeilingBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 1073741824;
+                        readonly description: "The host-wide largest-file ceiling, which no room or member limit can exceed.";
+                    };
+                };
+            };
+            readonly LimitSource: {
+                readonly title: "LimitSource";
+                readonly type: "string";
+                readonly enum: readonly ["policy", "override", "default"];
+                readonly description: "Where an effective limit came from. `policy`: the community's rooms policy at the room's creation. `override`: an administrator's vtc/rooms/limits/set. `default`: the community's configured defaults, where neither applies. The host-wide ceiling bounds all three.";
+            };
+            readonly RoomLimits: {
+                readonly title: "RoomLimits";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["filesEnabled"];
+                readonly description: "How much a host is willing to store for one room, at the room and per member. A hosting decision, set by the host and never by anything in the room's credentials. An upload must fit every scope at once: the object against the smallest `maxFileBytes` that applies, and the member and the room with the file added.";
+                readonly properties: {
+                    readonly filesEnabled: {
+                        readonly type: "boolean";
+                        readonly description: "False refuses every rooms/blobs/* upload for the room. Reads of blobs already stored continue.";
+                    };
+                    readonly room: {
+                        readonly $ref: "#/$defs/ScopeLimits";
+                        readonly description: "Limits on the room as a whole.";
+                    };
+                    readonly member: {
+                        readonly $ref: "#/$defs/ScopeLimits";
+                        readonly description: "Limits on each member's own uploads in this room, unless that member has an override. A member is the subject at the root of the authority chain they present, never the key that signed, so an agent acting on an attenuated chain spends its member's allowance. Not applied on a `private` room, where the host cannot tell members apart; the room and object limits still hold there.";
+                    };
+                };
+            };
+            readonly LimitTarget: {
+                readonly title: "LimitTarget";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["kind"];
+                readonly description: "Which limits an override applies to. `room`: the room as a whole. `memberDefault`: every member of the room who has no override of their own. `member`: one named member — `member` is REQUIRED with this kind and forbidden with the others, a rule this schema does not express; a community refuses a violation with `malformedRequest`.";
+                readonly properties: {
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly enum: readonly ["room", "memberDefault", "member"];
+                    };
+                    readonly member: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                        readonly description: "The member's DID: the subject at the root of the authority chains they present, which is what their uploads are charged to.";
+                    };
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map