@openvtc/trust-tasks 0.23.8 → 0.24.0

package/dist/vtc/rooms/usage/0.1/payload.d.ts

@@ -0,0 +1,880 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/rooms/usage/0.1/payload.schema.json
+ */
+import type { Ext, ScopeLimits, StorageConfigId } from "../../../../_shared/components.js";
+/**
+ * A room-hosting administrator reports the storage and activity of the community's hosted rooms, grouped by room, member, storage config or day. The outer document members are owned by the framework — SPEC §6.3.
+ */
+export interface VTCRoomsUsagePayload {
+    /**
+     * What each row describes. `day` is the daily history of whatever the filter selects.
+     */
+    groupBy: "room" | "member" | "storageConfig" | "day";
+    /**
+     * Every member optional; all given apply together.
+     */
+    filter?: {
+        /**
+         * The room's identifier, as its owner minted it.
+         */
+        roomId?: string;
+        /**
+         * One member's figures, across the `attributed` rooms selected.
+         */
+        member?: string;
+        storageConfig?: StorageConfigId;
+        /**
+         * First UTC day of the range. Default: 29 days before `to`.
+         */
+        from?: string;
+        /**
+         * Last UTC day of the range, inclusive. Default: today.
+         */
+        to?: string;
+    };
+    sort?: {
+        by: "bytes" | "files" | "uploads" | "downloads" | "egressBytes" | "date";
+        order?: "asc" | "desc";
+    };
+    /**
+     * Opaque continuation token from a previous page's `nextCursor`.
+     */
+    cursor?: string;
+    /**
+     * Page size. The community chooses when absent (50 in the reference implementation).
+     */
+    limit?: number;
+    ext?: Ext;
+}
+export interface VTCRoomsUsageResponsePayload {
+    asOf: string;
+    from: string;
+    to: string;
+    /**
+     * @maxItems 100
+     */
+    items: UsageRow[];
+    /**
+     * Present when more remain; pass it as `cursor`.
+     */
+    nextCursor?: string;
+    ext?: Ext;
+}
+/**
+ * One group's figures. Holdings as of the read (or the end of the day, on a `day` row); activity over the range (or the day).
+ */
+export interface UsageRow {
+    /**
+     * Present on a `room` row.
+     */
+    roomId?: string;
+    /**
+     * Present on a `member` row.
+     */
+    member?: string;
+    /**
+     * Present on a `storageConfig` row, and on a `room` row as the room's assigned config.
+     */
+    storageConfig?: StorageConfigId;
+    /**
+     * Present on a `day` row.
+     */
+    date?: string;
+    files: number;
+    bytes: number;
+    reservedBytes: number;
+    uploads: number;
+    downloads: number;
+    egressBytes: number;
+    /**
+     * On a `room` row the room's limits, on a `member` row (one room selected) that member's.
+     */
+    limits?: ScopeLimits;
+    /**
+     * On a `storageConfig` row, the config's capacity when it has one.
+     */
+    capacityBytes?: number;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Ext, ScopeLimits, StorageConfigId };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/vtc/rooms/usage/0.1";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCRoomsUsagePayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/vtc/rooms/usage/0.1#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCRoomsUsageResponsePayload;
+/**
+ * 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/usage/0.1";
+    readonly title: "VTC Rooms — Usage — payload";
+    readonly description: "A room-hosting administrator reports the storage and activity of the community's hosted rooms, grouped by room, member, storage config or day. The outer document members are owned by the framework — SPEC §6.3.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["groupBy"];
+    readonly properties: {
+        readonly groupBy: {
+            readonly type: "string";
+            readonly enum: readonly ["room", "member", "storageConfig", "day"];
+            readonly description: "What each row describes. `day` is the daily history of whatever the filter selects.";
+        };
+        readonly filter: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "Every member optional; all given apply together.";
+            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 member: {
+                    readonly type: "string";
+                    readonly pattern: "^did:";
+                    readonly maxLength: 2048;
+                    readonly description: "One member's figures, across the `attributed` rooms selected.";
+                };
+                readonly storageConfig: {
+                    readonly $ref: "#/$defs/StorageConfigId";
+                };
+                readonly from: {
+                    readonly type: "string";
+                    readonly format: "date";
+                    readonly description: "First UTC day of the range. Default: 29 days before `to`.";
+                };
+                readonly to: {
+                    readonly type: "string";
+                    readonly format: "date";
+                    readonly description: "Last UTC day of the range, inclusive. Default: today.";
+                };
+            };
+        };
+        readonly sort: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["by"];
+            readonly properties: {
+                readonly by: {
+                    readonly type: "string";
+                    readonly enum: readonly ["bytes", "files", "uploads", "downloads", "egressBytes", "date"];
+                };
+                readonly order: {
+                    readonly type: "string";
+                    readonly enum: readonly ["asc", "desc"];
+                };
+            };
+        };
+        readonly cursor: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 1024;
+            readonly description: "Opaque continuation token from a previous page's `nextCursor`.";
+        };
+        readonly limit: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 100;
+            readonly description: "Page size. The community chooses when absent (50 in the reference implementation).";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly UsageRow: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "One group's figures. Holdings as of the read (or the end of the day, on a `day` row); activity over the range (or the day).";
+            readonly required: readonly ["files", "bytes", "reservedBytes", "uploads", "downloads", "egressBytes"];
+            readonly properties: {
+                readonly roomId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 512;
+                    readonly description: "Present on a `room` row.";
+                };
+                readonly member: {
+                    readonly type: "string";
+                    readonly pattern: "^did:";
+                    readonly maxLength: 2048;
+                    readonly description: "Present on a `member` row.";
+                };
+                readonly storageConfig: {
+                    readonly $ref: "#/$defs/StorageConfigId";
+                    readonly description: "Present on a `storageConfig` row, and on a `room` row as the room's assigned config.";
+                };
+                readonly date: {
+                    readonly type: "string";
+                    readonly format: "date";
+                    readonly description: "Present on a `day` row.";
+                };
+                readonly files: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly bytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly reservedBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly uploads: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly downloads: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly egressBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly limits: {
+                    readonly $ref: "#/$defs/ScopeLimits";
+                    readonly description: "On a `room` row the room's limits, on a `member` row (one room selected) that member's.";
+                };
+                readonly capacityBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "On a `storageConfig` row, the config's capacity when it has one.";
+                };
+            };
+        };
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTC Rooms — Usage — response payload";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["asOf", "from", "to", "items"];
+            readonly properties: {
+                readonly asOf: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly from: {
+                    readonly type: "string";
+                    readonly format: "date";
+                };
+                readonly to: {
+                    readonly type: "string";
+                    readonly format: "date";
+                };
+                readonly items: {
+                    readonly type: "array";
+                    readonly maxItems: 100;
+                    readonly items: {
+                        readonly $ref: "#/$defs/UsageRow";
+                    };
+                };
+                readonly nextCursor: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 1024;
+                    readonly description: "Present when more remain; pass it as `cursor`.";
+                };
+                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 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 StorageConfigId: {
+            readonly title: "StorageConfigId";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+            readonly pattern: "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$";
+            readonly description: "A storage config's identifier, chosen by the administrator who creates it and immutable thereafter: lowercase letters, digits and inner hyphens, at most 64 characters (`eu-s3-primary`, `walrus-main`). Unique within the community. Never reused after a config is retired, because blobs name their config by this value.";
+        };
+    };
+};
+/** 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 UsageRow: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "One group's figures. Holdings as of the read (or the end of the day, on a `day` row); activity over the range (or the day).";
+            readonly required: readonly ["files", "bytes", "reservedBytes", "uploads", "downloads", "egressBytes"];
+            readonly properties: {
+                readonly roomId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 512;
+                    readonly description: "Present on a `room` row.";
+                };
+                readonly member: {
+                    readonly type: "string";
+                    readonly pattern: "^did:";
+                    readonly maxLength: 2048;
+                    readonly description: "Present on a `member` row.";
+                };
+                readonly storageConfig: {
+                    readonly $ref: "#/$defs/StorageConfigId";
+                    readonly description: "Present on a `storageConfig` row, and on a `room` row as the room's assigned config.";
+                };
+                readonly date: {
+                    readonly type: "string";
+                    readonly format: "date";
+                    readonly description: "Present on a `day` row.";
+                };
+                readonly files: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly bytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly reservedBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly uploads: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly downloads: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly egressBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly limits: {
+                    readonly $ref: "#/$defs/ScopeLimits";
+                    readonly description: "On a `room` row the room's limits, on a `member` row (one room selected) that member's.";
+                };
+                readonly capacityBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "On a `storageConfig` row, the config's capacity when it has one.";
+                };
+            };
+        };
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTC Rooms — Usage — response payload";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["asOf", "from", "to", "items"];
+            readonly properties: {
+                readonly asOf: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly from: {
+                    readonly type: "string";
+                    readonly format: "date";
+                };
+                readonly to: {
+                    readonly type: "string";
+                    readonly format: "date";
+                };
+                readonly items: {
+                    readonly type: "array";
+                    readonly maxItems: 100;
+                    readonly items: {
+                        readonly $ref: "#/$defs/UsageRow";
+                    };
+                };
+                readonly nextCursor: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 1024;
+                    readonly description: "Present when more remain; pass it as `cursor`.";
+                };
+                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 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 StorageConfigId: {
+            readonly title: "StorageConfigId";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+            readonly pattern: "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$";
+            readonly description: "A storage config's identifier, chosen by the administrator who creates it and immutable thereafter: lowercase letters, digits and inner hyphens, at most 64 characters (`eu-s3-primary`, `walrus-main`). Unique within the community. Never reused after a config is retired, because blobs name their config by this value.";
+        };
+    };
+};
+/**
+ * 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/usage/0.1";
+    readonly isBearer: false;
+    readonly isProofRequired: false;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: false;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/vtc/rooms/usage/0.1";
+        readonly title: "VTC Rooms — Usage — payload";
+        readonly description: "A room-hosting administrator reports the storage and activity of the community's hosted rooms, grouped by room, member, storage config or day. The outer document members are owned by the framework — SPEC §6.3.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["groupBy"];
+        readonly properties: {
+            readonly groupBy: {
+                readonly type: "string";
+                readonly enum: readonly ["room", "member", "storageConfig", "day"];
+                readonly description: "What each row describes. `day` is the daily history of whatever the filter selects.";
+            };
+            readonly filter: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly description: "Every member optional; all given apply together.";
+                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 member: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                        readonly description: "One member's figures, across the `attributed` rooms selected.";
+                    };
+                    readonly storageConfig: {
+                        readonly $ref: "#/$defs/StorageConfigId";
+                    };
+                    readonly from: {
+                        readonly type: "string";
+                        readonly format: "date";
+                        readonly description: "First UTC day of the range. Default: 29 days before `to`.";
+                    };
+                    readonly to: {
+                        readonly type: "string";
+                        readonly format: "date";
+                        readonly description: "Last UTC day of the range, inclusive. Default: today.";
+                    };
+                };
+            };
+            readonly sort: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["by"];
+                readonly properties: {
+                    readonly by: {
+                        readonly type: "string";
+                        readonly enum: readonly ["bytes", "files", "uploads", "downloads", "egressBytes", "date"];
+                    };
+                    readonly order: {
+                        readonly type: "string";
+                        readonly enum: readonly ["asc", "desc"];
+                    };
+                };
+            };
+            readonly cursor: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 1024;
+                readonly description: "Opaque continuation token from a previous page's `nextCursor`.";
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly description: "Page size. The community chooses when absent (50 in the reference implementation).";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly UsageRow: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly description: "One group's figures. Holdings as of the read (or the end of the day, on a `day` row); activity over the range (or the day).";
+                readonly required: readonly ["files", "bytes", "reservedBytes", "uploads", "downloads", "egressBytes"];
+                readonly properties: {
+                    readonly roomId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 512;
+                        readonly description: "Present on a `room` row.";
+                    };
+                    readonly member: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                        readonly description: "Present on a `member` row.";
+                    };
+                    readonly storageConfig: {
+                        readonly $ref: "#/$defs/StorageConfigId";
+                        readonly description: "Present on a `storageConfig` row, and on a `room` row as the room's assigned config.";
+                    };
+                    readonly date: {
+                        readonly type: "string";
+                        readonly format: "date";
+                        readonly description: "Present on a `day` row.";
+                    };
+                    readonly files: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly bytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly reservedBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly uploads: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly downloads: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly egressBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly limits: {
+                        readonly $ref: "#/$defs/ScopeLimits";
+                        readonly description: "On a `room` row the room's limits, on a `member` row (one room selected) that member's.";
+                    };
+                    readonly capacityBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "On a `storageConfig` row, the config's capacity when it has one.";
+                    };
+                };
+            };
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTC Rooms — Usage — response payload";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["asOf", "from", "to", "items"];
+                readonly properties: {
+                    readonly asOf: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly from: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly to: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly items: {
+                        readonly type: "array";
+                        readonly maxItems: 100;
+                        readonly items: {
+                            readonly $ref: "#/$defs/UsageRow";
+                        };
+                    };
+                    readonly nextCursor: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 1024;
+                        readonly description: "Present when more remain; pass it as `cursor`.";
+                    };
+                    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 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 StorageConfigId: {
+                readonly title: "StorageConfigId";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 64;
+                readonly pattern: "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$";
+                readonly description: "A storage config's identifier, chosen by the administrator who creates it and immutable thereafter: lowercase letters, digits and inner hyphens, at most 64 characters (`eu-s3-primary`, `walrus-main`). Unique within the community. Never reused after a config is retired, because blobs name their config by this value.";
+            };
+        };
+    };
+};
+/**
+ * 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/usage/0.1#response";
+    readonly isBearer: false;
+    readonly isProofRequired: false;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: false;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly UsageRow: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly description: "One group's figures. Holdings as of the read (or the end of the day, on a `day` row); activity over the range (or the day).";
+                readonly required: readonly ["files", "bytes", "reservedBytes", "uploads", "downloads", "egressBytes"];
+                readonly properties: {
+                    readonly roomId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 512;
+                        readonly description: "Present on a `room` row.";
+                    };
+                    readonly member: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                        readonly description: "Present on a `member` row.";
+                    };
+                    readonly storageConfig: {
+                        readonly $ref: "#/$defs/StorageConfigId";
+                        readonly description: "Present on a `storageConfig` row, and on a `room` row as the room's assigned config.";
+                    };
+                    readonly date: {
+                        readonly type: "string";
+                        readonly format: "date";
+                        readonly description: "Present on a `day` row.";
+                    };
+                    readonly files: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly bytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly reservedBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly uploads: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly downloads: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly egressBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly limits: {
+                        readonly $ref: "#/$defs/ScopeLimits";
+                        readonly description: "On a `room` row the room's limits, on a `member` row (one room selected) that member's.";
+                    };
+                    readonly capacityBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "On a `storageConfig` row, the config's capacity when it has one.";
+                    };
+                };
+            };
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTC Rooms — Usage — response payload";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["asOf", "from", "to", "items"];
+                readonly properties: {
+                    readonly asOf: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly from: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly to: {
+                        readonly type: "string";
+                        readonly format: "date";
+                    };
+                    readonly items: {
+                        readonly type: "array";
+                        readonly maxItems: 100;
+                        readonly items: {
+                            readonly $ref: "#/$defs/UsageRow";
+                        };
+                    };
+                    readonly nextCursor: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 1024;
+                        readonly description: "Present when more remain; pass it as `cursor`.";
+                    };
+                    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 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 StorageConfigId: {
+                readonly title: "StorageConfigId";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 64;
+                readonly pattern: "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$";
+                readonly description: "A storage config's identifier, chosen by the administrator who creates it and immutable thereafter: lowercase letters, digits and inner hyphens, at most 64 characters (`eu-s3-primary`, `walrus-main`). Unique within the community. Never reused after a config is retired, because blobs name their config by this value.";
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map