@nsp-labs/agnostic-sdk 1.0.4 → 1.4.0

package/src/generated/openapi.d.ts

@@ -38,6 +38,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/runtime/data/tables/{tableName}/records/aggregate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Aggregate Data records in the authenticated runtime context */
+        post: operations["runtimeDataAggregateRecords"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/runtime/data/tables/{tableName}/records/{recordId}": {
         parameters: {
             query?: never;
@@ -158,10 +175,138 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/runtime/files/buckets/{bucketRef}/uploads": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Create an exact-object runtime upload grant */
+        post: operations["runtimeFilesCreateUpload"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/runtime/files/buckets/{bucketRef}/uploads/{uploadId}/complete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Complete one runtime upload idempotently */
+        post: operations["runtimeFilesCompleteUpload"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/runtime/files/buckets/{bucketRef}/anonymous-upload-sessions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Create a BFF-mediated anonymous upload session */
+        post: operations["RuntimeFilesController_createAnonymousSession"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/runtime/files/buckets/{bucketRef}/anonymous-upload-sessions/claim": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Claim one anonymous upload session for a business object */
+        post: operations["runtimeFilesClaimAnonymousSession"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/runtime/files/buckets/{bucketRef}/objects/{fileId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get one runtime-owned file and its current status */
+        get: operations["runtimeFilesGetObject"];
+        put?: never;
+        post?: never;
+        /** Delete one runtime-owned ready file idempotently */
+        delete: operations["runtimeFilesDeleteObject"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/runtime/files/buckets/{bucketRef}/objects/{fileId}/access": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Authorize runtime-owned private file access */
+        post: operations["RuntimeFilesAccessController_authorize"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/runtime/files/buckets/{bucketRef}/objects/{fileId}/download": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Create a short runtime-owned private download link */
+        post: operations["RuntimeFilesAccessController_download"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        ClaimFileAnonymousSessionDto: {
+            /** @description Opaque claim token returned once with the session. */
+            token: string;
+            /** @example order:order_123 */
+            externalRef: string;
+            /** @example order:order_123 */
+            idempotencyKey: string;
+        };
         CreateDataRecordDto: {
             /**
              * @description Optional record id; generated when omitted
@@ -176,7 +321,128 @@ export interface components {
              */
             values: Record<string, never>;
         };
+        CreateFileAnonymousBffSessionDto: {
+            /** Format: uuid */
+            profileId: string;
+            /** @example https://shop.example.com */
+            origin: string;
+            captchaToken: string;
+            /** @example 203.0.113.10 */
+            clientIp: string;
+            abuseKey?: string;
+        };
+        CreateFileUploadDto: {
+            /** @example invoice.pdf */
+            fileName: string;
+            /** @example application/pdf */
+            contentType: string;
+            size: number;
+            checksumSha256: string;
+            /**
+             * @default private
+             * @enum {string}
+             */
+            access: "private" | "authenticated" | "team" | "public";
+            idempotencyKey: string;
+        };
+        DataAggregateMetricDto: {
+            /**
+             * @example count
+             * @enum {string}
+             */
+            operation: "count" | "sum" | "avg" | "min" | "max";
+            /** @example amount */
+            field?: string;
+            /** @example orders */
+            as: string;
+        };
+        DataAggregateOrderByDto: {
+            /** @example orders */
+            by: string;
+            /**
+             * @example desc
+             * @enum {string}
+             */
+            direction: "asc" | "desc";
+        };
+        DataAggregateQueryDto: {
+            /**
+             * @example {
+             *       "status": "paid"
+             *     }
+             */
+            filter?: {
+                [key: string]: unknown;
+            };
+            /** @example alex */
+            q?: string;
+            /**
+             * @example [
+             *       "status"
+             *     ]
+             */
+            groupBy?: string[];
+            /**
+             * @example [
+             *       {
+             *         "operation": "count",
+             *         "as": "orders"
+             *       },
+             *       {
+             *         "operation": "sum",
+             *         "field": "amount",
+             *         "as": "revenue"
+             *       }
+             *     ]
+             */
+            metrics: components["schemas"]["DataAggregateMetricDto"][];
+            /**
+             * @example [
+             *       {
+             *         "by": "orders",
+             *         "direction": "desc"
+             *       }
+             *     ]
+             */
+            orderBy?: components["schemas"]["DataAggregateOrderByDto"][];
+            /**
+             * @description Maximum groups to return; defaults to 20 for grouped queries
+             * @example 20
+             */
+            limit?: number;
+        };
+        DataAggregateResultDto: {
+            rows: components["schemas"]["DataAggregateRowDto"][];
+            /** @example 20 */
+            limit: number;
+            /** @example false */
+            hasMore: boolean;
+        };
+        DataAggregateRowDto: {
+            /**
+             * @example {
+             *       "status": "paid"
+             *     }
+             */
+            dimensions: {
+                [key: string]: unknown;
+            };
+            /**
+             * @example {
+             *       "orders": 42,
+             *       "revenue": 125000
+             *     }
+             */
+            metrics: {
+                [key: string]: unknown;
+            };
+        };
         DataFieldDto: {
+            /**
+             * Format: uuid
+             * @example uuid
+             */
+            fieldId: string;
             /** @example status */
             name: string;
             /** @example Status */
@@ -286,6 +552,158 @@ export interface components {
              */
             settings: Record<string, never>;
         };
+        FileAccessAuthorizationDto: {
+            file: components["schemas"]["FileObjectDto"];
+            /** @enum {string} */
+            actorType: "runtime" | "platform_user" | "app_user" | "anonymous" | "system";
+            /** @enum {string} */
+            access: "private" | "authenticated" | "team" | "public";
+            /** Format: date-time */
+            authorizedAt: string;
+            /** @example request-123 */
+            requestId: string;
+        };
+        FileAnonymousClaimHandleDto: {
+            /** Format: uuid */
+            fileId: string;
+            /** @enum {string} */
+            status: "ready" | "processing";
+        };
+        FileAnonymousClaimResultDto: {
+            /** Format: uuid */
+            sessionId: string;
+            /** Format: uuid */
+            bucketId: string;
+            /** @example order:order_123 */
+            externalRef: string;
+            /** Format: date-time */
+            claimedAt: string;
+            files: components["schemas"]["FileAnonymousClaimHandleDto"][];
+        };
+        FileAnonymousSessionCredentialsDto: {
+            session: components["schemas"]["FileAnonymousUploadSessionDto"];
+            /** @description Opaque bearer token returned once; keep it out of URLs and logs. */
+            sessionToken: string;
+            /** @description Opaque claim token returned once; keep it out of URLs and logs. */
+            claimToken: string;
+        };
+        FileAnonymousUploadSessionDto: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            profileId: string;
+            /** Format: uuid */
+            bucketId: string;
+            /** @enum {string} */
+            status: "open" | "sealed" | "claimed" | "expired";
+            usedFileCount: number;
+            declaredBytes: number;
+            actualBytes: number;
+            /** Format: date-time */
+            expiresAt: string;
+            /** Format: date-time */
+            sealedAt?: string | null;
+            /** Format: date-time */
+            claimedAt?: string | null;
+        };
+        FileDownloadLinkDto: {
+            /** Format: uri */
+            url: string;
+            /** Format: date-time */
+            expiresAt: string;
+        };
+        FileObjectDto: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            bucketId: string;
+            /** Format: uuid */
+            projectId: string;
+            /** @example production */
+            environment: string;
+            /** @example invoice.pdf */
+            originalName: string;
+            /** @example application/pdf */
+            detectedMime?: string | null;
+            /** @example 1024 */
+            sizeBytes?: number | null;
+            checksumSha256?: string | null;
+            /** @enum {string} */
+            status: "pending_upload" | "uploaded" | "scanning" | "ready" | "verified_unclaimed" | "claimed_ready" | "deleting" | "deleted" | "rejected" | "quarantined" | "expired";
+            /** @enum {string} */
+            access: "private" | "authenticated" | "team" | "public";
+            /** Format: date-time */
+            readyAt?: string | null;
+            /** Format: date-time */
+            deletedAt?: string | null;
+            /** Format: date-time */
+            billableUntil?: string | null;
+            /** Format: date-time */
+            physicalDeleteDueAt?: string | null;
+            /** Format: date-time */
+            physicalDeletedAt?: string | null;
+            /** Format: date-time */
+            expiresAt?: string | null;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: string;
+        };
+        FileUploadCompletionDto: {
+            upload: components["schemas"]["FileUploadSessionDto"];
+            file: components["schemas"]["FileObjectDto"];
+        };
+        FileUploadGrantDto: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            fileId: string;
+            /** Format: uuid */
+            bucketId: string;
+            /** @enum {string} */
+            status: "issued" | "uploaded" | "verifying" | "completed" | "rejected" | "expired";
+            /** @example 1024 */
+            expectedSizeBytes: number;
+            /** Format: date-time */
+            expiresAt: string;
+            /** Format: date-time */
+            completedAt?: string | null;
+            /**
+             * Format: uri
+             * @description Short-lived exact-object PUT URL (default TTL: 10 minutes).
+             */
+            uploadUrl: string;
+            /** Format: date-time */
+            uploadUrlExpiresAt: string;
+            /** @description All headers must be sent unchanged with the PUT request. */
+            requiredHeaders: {
+                [key: string]: string;
+            };
+        };
+        FileUploadSessionDto: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            fileId: string;
+            /** Format: uuid */
+            bucketId: string;
+            /** @enum {string} */
+            status: "issued" | "uploaded" | "verifying" | "completed" | "rejected" | "expired";
+            /** @example 1024 */
+            expectedSizeBytes: number;
+            /** Format: date-time */
+            expiresAt: string;
+            /** Format: date-time */
+            completedAt?: string | null;
+        };
+        FilesErrorDto: {
+            /** @enum {string} */
+            code: "files_bucket_not_found" | "files_bucket_slug_conflict" | "files_bucket_not_empty" | "files_environment_not_found" | "files_object_not_found" | "files_upload_not_found" | "files_access_denied" | "files_policy_rejected" | "files_size_exceeded" | "files_size_mismatch" | "files_upload_mismatch" | "files_type_rejected" | "files_checksum_mismatch" | "files_upload_expired" | "files_object_not_ready" | "files_idempotency_conflict" | "files_balance_required" | "files_rate_limited" | "files_scanner_unavailable" | "files_storage_unavailable" | "files_anonymous_upload_disabled" | "files_origin_not_allowed" | "files_captcha_rejected" | "files_claim_conflict";
+            /** @example Файл ещё не готов к скачиванию. */
+            message: string;
+            /** @example request-123 */
+            requestId?: string;
+        };
         Object: Record<string, never>;
         RuntimeActorMetadataDto: {
             /**
@@ -574,6 +992,7 @@ export interface operations {
                 /** @description Environment key or UI alias: production/prod, staging, development/dev. */
                 environment?: string;
                 limit?: number;
+                /** @description Opaque versioned pagination cursor bound to this exact query. Legacy offset cursors are temporarily accepted. */
                 cursor?: string;
                 /** @description Search text applied across searchable text columns */
                 q?: string;
@@ -651,6 +1070,45 @@ export interface operations {
             };
         };
     };
+    runtimeDataAggregateRecords: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                tableName: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DataAggregateQueryDto"];
+            };
+        };
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DataAggregateResultDto"];
+                };
+            };
+            /** @description Invalid runtime token */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Missing runtime capability */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     runtimeDataDeleteRecord: {
         parameters: {
             query?: never;
@@ -735,6 +1193,7 @@ export interface operations {
                 /** @description Environment key or UI alias: production/prod, staging, development/dev. */
                 environment?: string;
                 limit?: number;
+                /** @description Opaque versioned pagination cursor bound to the saved view version and exact renderer query. */
                 cursor?: string;
             };
             header?: never;
@@ -950,4 +1409,374 @@ export interface operations {
             };
         };
     };
+    runtimeFilesCreateUpload: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                bucketRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateFileUploadDto"];
+            };
+        };
+        responses: {
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileUploadGrantDto"];
+                };
+            };
+            /** @description Invalid runtime token */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+        };
+    };
+    runtimeFilesCompleteUpload: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                bucketRef: string;
+                uploadId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileUploadCompletionDto"];
+                };
+            };
+            /** @description Invalid runtime token */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+        };
+    };
+    RuntimeFilesController_createAnonymousSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                bucketRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateFileAnonymousBffSessionDto"];
+            };
+        };
+        responses: {
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileAnonymousSessionCredentialsDto"];
+                };
+            };
+            /** @description Invalid runtime token */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+        };
+    };
+    runtimeFilesClaimAnonymousSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                bucketRef: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ClaimFileAnonymousSessionDto"];
+            };
+        };
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileAnonymousClaimResultDto"];
+                };
+            };
+            /** @description Invalid runtime token */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+            410: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+        };
+    };
+    runtimeFilesGetObject: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                bucketRef: string;
+                fileId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileObjectDto"];
+                };
+            };
+            /** @description Invalid runtime token */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+        };
+    };
+    runtimeFilesDeleteObject: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                bucketRef: string;
+                fileId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Object tombstoned */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid runtime token */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+        };
+    };
+    RuntimeFilesAccessController_authorize: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                bucketRef: string;
+                fileId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileAccessAuthorizationDto"];
+                };
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FilesErrorDto"];
+                };
+            };
+        };
+    };
+    RuntimeFilesAccessController_download: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                bucketRef: string;
+                fileId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileDownloadLinkDto"];
+                };
+            };
+        };
+    };
 }