@raster-app/sdk 0.1.0-canary-2e1834e

package/dist/__generated__/openapi.d.ts

@@ -0,0 +1,1096 @@
+export interface paths {
+    "/me": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Resolve the credential's organization and library scope. */
+        get: {
+            parameters: {
+                query?: never;
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Me"];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/libraries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create an organization, library, and API key with no account.
+         * @description Anonymous — mints the key, so send no Authorization header. https://raster.app/docs/guides/start-without-an-account
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: email */
+                        email: string;
+                        name?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                organizationId: string;
+                                libraryId: string;
+                                apiKey: string;
+                                /** Format: uri */
+                                claimUrl: string;
+                                /** Format: date-time */
+                                expiresAt: string;
+                                emailSent: boolean;
+                            };
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/organizations/{organizationId}/libraries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List libraries the key can reach. */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Zero-based page index. */
+                    page?: number;
+                    pageSize?: number;
+                };
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Library"][];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+            };
+        };
+        put?: never;
+        /** Create a library in this organization. */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        name: string;
+                        slug?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Created */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Library"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/organizations/{organizationId}/libraries/{libraryId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /** Rename a library. */
+        patch: {
+            parameters: {
+                query?: never;
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                    libraryId: components["parameters"]["LibraryId"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        name: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Library"];
+                        };
+                    };
+                };
+                404: components["responses"]["NotFound"];
+            };
+        };
+        trace?: never;
+    };
+    "/organizations/{organizationId}/libraries/{libraryId}/assets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List assets (paginated, optional tag filter). */
+        get: {
+            parameters: {
+                query?: {
+                    page?: number;
+                    pageSize?: number;
+                    /** @description Comma-separated tag filter, up to 50. */
+                    tags?: string;
+                };
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                    libraryId: components["parameters"]["LibraryId"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Asset"][];
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+            };
+        };
+        put?: never;
+        /** Upload up to 20 files. */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                    libraryId: components["parameters"]["LibraryId"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "multipart/form-data": {
+                        files: string[];
+                        /** @description Attach the uploaded file as a variant of this asset. Send exactly one file with it. The asset must be an original in this library, of the same media kind as the file. */
+                        parentId?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                responseText: string;
+                                assets: components["schemas"]["Asset"][];
+                            };
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+            };
+        };
+        /**
+         * Move up to 100 assets to trash (soft delete).
+         * @description Soft delete — assets stay recoverable from trash until the 30-day reaper. Trashing an asset also trashes its variants; a variant id on its own is rejected with 400.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                    libraryId: components["parameters"]["LibraryId"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        ids: string[];
+                    };
+                };
+            };
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                success: boolean;
+                                message: string;
+                                ids: string[];
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/organizations/{organizationId}/libraries/{libraryId}/assets/{assetId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get one asset by id.
+         * @description Returns the full asset, including its non-destructive variants in the `variants` field; each variant carries its own tags/description — fetch a variant by its id for those.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                    libraryId: components["parameters"]["LibraryId"];
+                    assetId: components["parameters"]["AssetId"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Asset"];
+                        };
+                    };
+                };
+                404: components["responses"]["NotFound"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/organizations/{organizationId}/libraries/{libraryId}/assets/{assetId}/description": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /** Replace one asset's description. */
+        patch: {
+            parameters: {
+                query?: never;
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                    libraryId: components["parameters"]["LibraryId"];
+                    assetId: components["parameters"]["AssetId"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        description: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                assetId: string;
+                                description: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        trace?: never;
+    };
+    "/organizations/{organizationId}/libraries/{libraryId}/assets/{assetId}/promote": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Make a variant the asset's default.
+         * @description The variant's pixels replace what the asset serves, at the SAME URL, so anything already embedding that URL shows the new file. The previous default is preserved as a new variant and keeps the name it had; the asset keeps its id and URL and takes the promoted variant's name. Its description and the tags generated from its image follow the picture — the promoted variant hands over any it carries, and the preserved variant keeps the ones that described it, while tags you added yourself stay on the asset. Rejected while the asset is itself still being processed (a video whose poster has not landed yet). The promote is accepted and the swap completes a moment later; re-fetch the asset to see it reflected.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                    libraryId: components["parameters"]["LibraryId"];
+                    assetId: components["parameters"]["AssetId"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        variantId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                assetId: string;
+                                promotedVariantId: string;
+                                demotedVariantId: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/organizations/{organizationId}/libraries/{libraryId}/assets/tag": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Apply up to 20 tags to up to 100 assets. */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                    libraryId: components["parameters"]["LibraryId"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        assetIds: string[];
+                        tags: string[];
+                    };
+                };
+            };
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                taggedCount: number;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/organizations/{organizationId}/libraries/{libraryId}/assets/untag": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Remove up to 20 tags from up to 100 assets. */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                    libraryId: components["parameters"]["LibraryId"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        assetIds: string[];
+                        tags: string[];
+                    };
+                };
+            };
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                untaggedCount: number;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/organizations/{organizationId}/libraries/{libraryId}/assets/transfer": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Move up to 100 assets to another library.
+         * @description An asset's variants move with it; a variant cannot be transferred on its own — transfer its original and the variants follow.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                    libraryId: components["parameters"]["LibraryId"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        targetLibraryId: string;
+                        assetIds: string[];
+                    };
+                };
+            };
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                transferredCount: number;
+                                sourceLibraryId: string;
+                                targetLibraryId: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/organizations/{organizationId}/libraries/{libraryId}/tags": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List a library's tags by usage count. */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: number;
+                };
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                    libraryId: components["parameters"]["LibraryId"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["Tag"][];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/organizations/{organizationId}/search/assets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Search assets across libraries (ranked, highlighted). */
+        get: {
+            parameters: {
+                query: {
+                    q: string;
+                    /** @description Comma-separated library ids. */
+                    libraries?: string;
+                    page?: number;
+                    pageSize?: number;
+                };
+                header: {
+                    "Api-Version": components["parameters"]["ApiVersion"];
+                };
+                path: {
+                    organizationId: components["parameters"]["OrganizationId"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: components["schemas"]["SearchResult"];
+                        };
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        Error: {
+            error: {
+                /** @example API_KEY_NOT_AUTHORIZED_FOR_LIBRARY */
+                code: string;
+                message: string;
+            };
+        };
+        /** @description What the credential can act on. An API key, or an OAuth token bound to one organization, resolves that organization; a token granted the whole account resolves every organization it belongs to under `organizations`. An OAuth token also carries `user`; an API key does not. */
+        Me: {
+            organizationId: string;
+            organizationName: string | null;
+            plan: string | null;
+            libraries: {
+                library: string;
+                /** @enum {string} */
+                access: "read" | "write";
+            }[];
+            /** @description The account an OAuth access token acts as. */
+            user?: {
+                name: string | null;
+            };
+        } | {
+            organizations: {
+                organizationId: string;
+                organizationName: string | null;
+                plan: string | null;
+                libraries: {
+                    library: string;
+                    /** @enum {string} */
+                    access: "read" | "write";
+                }[];
+            }[];
+            /** @description The account an OAuth access token acts as. */
+            user: {
+                name: string | null;
+            };
+        };
+        /** @description Represents a digital asset with associated metadata. */
+        Asset: {
+            id: string;
+            width: number | null;
+            height: number | null;
+            name: string | null;
+            libraryId: string | null;
+            blurhash: string | null;
+            /**
+             * Format: uri
+             * @description Permanent, public CDN URL for the full-resolution asset. It needs no
+             *     authentication and never expires, so reference it directly as the source URL
+             *     rather than downloading and re-hosting the file.
+             */
+            url: string | null;
+            /**
+             * Format: uri
+             * @deprecated
+             */
+            thumbUrlBlurred: string | null;
+            /**
+             * @description JSON-encoded map of size (the image's longest edge, in pixels) to the CDN
+             *     URL of the image at that size (parse before use). Each URL carries the same
+             *     permanent, public, embed-directly semantics as `url`; pick the size closest to
+             *     your display target.
+             */
+            sizes: string | null;
+            /**
+             * Format: uri
+             * @description Absolute link that opens this asset in the Raster app, for a person to view,
+             *     edit, or manage it. Give it to the user as a link; the source URL is `url`.
+             */
+            appUrl: string | null;
+            /**
+             * @description Non-destructive variants of the asset. Each entry carries its own
+             *     `parentId` pointing back to this asset.
+             */
+            variants: (components["schemas"]["AssetVariant"] | null)[] | null;
+            /**
+             * @description The parentId-model discriminator: `null` on a top-level original, the parent
+             *     asset's id on a variant. A variant is a first-class Asset — tag-filtered and search
+             *     queries return it as its own entry — and `parentId` relates it back to its
+             *     original. May be `null` for originals uploaded before the delta-001 backfill.
+             */
+            parentId: string | null;
+            description: string | null;
+            tags: (string | null)[] | null;
+            /**
+             * @description MIME content type of the asset (e.g. `image/jpeg`, `image/png`).
+             * @example image/jpeg
+             */
+            contentType: string | null;
+            /** @description File size in bytes. May be `null` for older assets with no recorded size. */
+            size: number | null;
+            /**
+             * @description Length of the asset in seconds, for video and audio. `null` on images and on
+             *     videos still being processed.
+             */
+            duration: number | null;
+            /**
+             * @description Details read from the asset's own bytes — how it was captured, and its
+             *     technical format. `null` on assets uploaded before this data was captured.
+             */
+            metadata: components["schemas"]["AssetMetadata"] | null;
+            /** @description Creation time as unix milliseconds. May be `null` for some older assets. */
+            created: number | null;
+            /**
+             * @description Last-modified time as unix milliseconds. Bumped on any field change
+             *     (rename, tag edit, variant-edit save). Useful for cache invalidation and
+             *     "sort by recently updated" UX.
+             */
+            updated: number | null;
+            /**
+             * @description Counter bumped each time the asset's BYTES are replaced at an unchanged
+             *     url — a promoted variant, an edit re-save. Append it to any `url` or
+             *     `sizes` entry as `?v=` to render the current pixels: the same url keeps
+             *     serving the previous bytes to every cache that already holds it.
+             *
+             *     Null on an asset whose bytes have never been replaced — render the bare
+             *     url there, so those assets keep the cache entry they already have.
+             */
+            contentVersion: number | null;
+            /** @description Attribution metadata for the user who uploaded the asset. */
+            uploadedBy: components["schemas"]["Uploader"] | null;
+            approval: components["schemas"]["Approval"] | null;
+        };
+        /** @description Represents a tag associated with assets or libraries. */
+        Tag: {
+            id: string;
+            count: number | null;
+            type: string | null;
+        };
+        /** @description Represents a collection of assets. */
+        Library: {
+            id: string;
+            name: string | null;
+            assetsCount: number | null;
+            /** @deprecated */
+            photosCount: number | null;
+            trashCount: number | null;
+            tags: (components["schemas"]["Tag"] | null)[] | null;
+        };
+        /**
+         * @description Wire shape returned by the `searchAssets` query — `hits` plus the
+         *     corpus-wide `found` total and the resolved 1-based `page`.
+         */
+        SearchResult: {
+            hits: components["schemas"]["SearchHit"][];
+            found: number;
+            page: number;
+        };
+        /** @description Represents a variant of an asset. */
+        AssetVariant: {
+            id: string;
+            parentId: string | null;
+            width: number | null;
+            height: number | null;
+            name: string | null;
+            /** Format: uri */
+            url: string | null;
+            sizes: string | null;
+            /** Format: uri */
+            appUrl: string | null;
+        };
+        /** @description Details read from the asset's own bytes — how it was captured, and its technical format. */
+        AssetMetadata: {
+            /**
+             * @description How the asset was captured, when it carried any such details. `null` when
+             *     it carried none, which is common for screen recordings and anything
+             *     re-encoded.
+             */
+            capture: components["schemas"]["AssetCapture"] | null;
+            /** @description The video's technical stream details. `null` on anything that is not a video. */
+            video: components["schemas"]["VideoStream"] | null;
+        };
+        /** @description Attribution metadata for the user or system that uploaded an asset. */
+        Uploader: {
+            /** @description Display name of the uploader. May be `null`. */
+            name: string | null;
+            /**
+             * Format: uri
+             * @description URL of the uploader's current avatar, read live from their account. May be `null`.
+             */
+            avatarUrl: string | null;
+        };
+        /** @description An asset's approval (delivery) state — who set it, when, and why. */
+        Approval: {
+            state: string;
+            /** @description Email address of the person who set the approval. `null` on a search hit, or when their account has no email address. */
+            setBy: string | null;
+            setAt: number | null;
+            note?: string;
+        };
+        /**
+         * @description A search hit — every public `Asset` field plus optional highlights and a
+         *     relevance score.
+         */
+        SearchHit: {
+            id: string;
+            width: number | null;
+            height: number | null;
+            name: string | null;
+            libraryId: string | null;
+            blurhash: string | null;
+            /** Format: uri */
+            url: string | null;
+            /**
+             * Format: uri
+             * @deprecated
+             */
+            thumbUrlBlurred: string | null;
+            sizes: string | null;
+            /** Format: uri */
+            appUrl: string | null;
+            variants: (components["schemas"]["AssetVariant"] | null)[] | null;
+            parentId: string | null;
+            description: string | null;
+            tags: (string | null)[] | null;
+            contentType: string | null;
+            size: number | null;
+            duration: number | null;
+            metadata: components["schemas"]["AssetMetadata"] | null;
+            created: number | null;
+            updated: number | null;
+            contentVersion: number | null;
+            uploadedBy: components["schemas"]["Uploader"] | null;
+            approval: components["schemas"]["Approval"] | null;
+            /**
+             * @description Highlight snippets — present only when the search matched on the
+             *     corresponding field. Matched terms are wrapped in `<mark>` tags.
+             */
+            highlights?: components["schemas"]["SearchHitHighlights"];
+            /** @description Relevance score for the hit. Optional. */
+            score?: number;
+        };
+        /** @description How an asset was captured — when, on what device, and where. */
+        AssetCapture: {
+            /**
+             * @description When the asset says it was recorded, as written by the device. On a
+             *     re-encoded file this is the time of that encode rather than the original
+             *     recording, so treat it as a hint rather than a reliable capture date.
+             */
+            recordedAt: string | null;
+            /** @description Device maker, e.g. `Apple`. */
+            make: string | null;
+            /** @description Device model, e.g. `iPhone 17 Pro`. */
+            model: string | null;
+            /** @description Capture software or OS version reported by the device. */
+            software: string | null;
+            /** @description Signed decimal degrees. Present only alongside `longitude`. */
+            latitude: number | null;
+            /** @description Signed decimal degrees. */
+            longitude: number | null;
+            /** @description Metres above sea level, when the container recorded one. */
+            altitude: number | null;
+        };
+        /** @description A video's technical stream details — codec, frame rate, bitrate, and audio. */
+        VideoStream: {
+            /** @description Video codec, e.g. `h264`, `hevc`, `vp9`, `av1`. */
+            codec: string;
+            /** @description Frames per second, e.g. `30` or `23.98`. */
+            frameRate: number | null;
+            /** @description Overall bitrate in bits per second, across all streams. */
+            bitrate: number | null;
+            /** @description Whether the video carries an audio track. */
+            hasAudio: boolean;
+            /** @description Audio codec, e.g. `aac`, `opus`. `null` when there is no audio track. */
+            audioCodec: string | null;
+            /** @description Audio channel layout, e.g. `mono`, `stereo`, `5.1`. */
+            audioLayout: string | null;
+            /** @description Audio sample rate in hertz, e.g. `48000`. */
+            audioSampleRate: number | null;
+        };
+        /** @description Highlight snippets returned alongside each `SearchHit`. */
+        SearchHitHighlights: {
+            name?: string;
+            tags?: string[];
+        };
+    };
+    responses: {
+        /** @description Missing or invalid API key. */
+        Unauthorized: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
+        /** @description Resource not found, or the key is not authorized for it. */
+        NotFound: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
+        /** @description Invalid input (BAD_USER_INPUT), quota, or API-version error. */
+        BadRequest: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
+    };
+    parameters: {
+        ApiVersion: string;
+        OrganizationId: string;
+        LibraryId: string;
+        AssetId: string;
+    };
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export type operations = Record<string, never>;