@geolens/sdk 1.3.0 → 1.4.1

package/dist/client/types.gen.d.ts

@@ -1,6 +1,22 @@
 export type ClientOptions = {
     baseUrl: `${string}://${string}` | (string & {});
 };
+/**
+ * AIAvailabilityResponse
+ *
+ * Public-safe AI readiness signal (builder-audit #338 P1-11).
+ *
+ * Carries a single boolean and intentionally exposes NO provider name, model,
+ * or key detail — it is readable by any non-admin editor holding
+ * ``use_ai_chat`` so the builder can enable/disable chat without the
+ * admin-only ``/admin/ai-status`` endpoint (which leaks provider/key info).
+ */
+export type AiAvailabilityResponse = {
+    /**
+     * Available
+     */
+    available: boolean;
+};
 /**
  * AIStatusResponse
  */
@@ -335,15 +351,15 @@ export type AdminShareTokenResponse = {
     /**
      * Expires At
      */
-    expires_at: string | null;
+    expires_at?: string | null;
     /**
      * Id
      */
-    id: string;
+    id?: string | null;
     /**
      * Is Active
      */
-    is_active: boolean;
+    is_active?: boolean | null;
     /**
      * Map Id
      */
@@ -355,7 +371,7 @@ export type AdminShareTokenResponse = {
     /**
      * Token
      */
-    token: string;
+    token?: string | null;
 };
 /**
  * AdminUserCreate
@@ -1681,6 +1697,18 @@ export type ColumnStatsResponse = {
      * Count
      */
     count?: number;
+    /**
+     * Data Type
+     *
+     * 'categorical' for non-numeric columns; null for numeric.
+     */
+    data_type?: string | null;
+    /**
+     * Distinct Count
+     *
+     * Distinct non-null value count (categorical columns only).
+     */
+    distinct_count?: number | null;
     /**
      * Max
      */
@@ -1884,12 +1912,42 @@ export type ConfigModeResponse = {
  * ConfigResponse
  */
 export type ConfigResponse = {
+    /**
+     * Allow Signup
+     *
+     * Whether self-serve registration is open. Alias for registration_enabled; login UI uses this to show/hide the signup link.
+     */
+    allow_signup?: boolean;
     /**
      * Auth Methods
      *
      * Auth methods contributed by the active AuthExtension. Empty in community; e.g. ['saml'] when the enterprise SAML overlay is installed. Login UI can render conditional sign-in options without needing admin OAuthProvider access.
      */
     auth_methods?: Array<string>;
+    /**
+     * Demo Mode
+     *
+     * When true, logged-in users see a persistent demo-account banner. Default false — self-hosters see no banner.
+     */
+    demo_mode?: boolean;
+    /**
+     * Email Verification Required
+     *
+     * When true, new self-registered users must verify their email before logging in. Default false for back-compat-safe parsing by older clients.
+     */
+    email_verification_required?: boolean;
+    /**
+     * Landing First
+     *
+     * When true, unauthenticated visits to '/' are redirected to '/login' as the product landing page. Default false (search catalog is the root).
+     */
+    landing_first?: boolean;
+    /**
+     * Password Login Enabled
+     *
+     * When false, password login is disabled for users without manage_settings. Default true for back-compat-safe parsing by older clients.
+     */
+    password_login_enabled?: boolean;
     /**
      * Registration Enabled
      *
@@ -5148,6 +5206,92 @@ export type MetadataAssistRequest = {
      */
     dataset_id: string;
 };
+/**
+ * NotificationStatusResponse
+ *
+ * Response for GET /settings/notifications/status/ (NOTIF-05 / NOTIF-06).
+ *
+ * Returns only boolean presence flags — never a secret value (SMTP password,
+ * webhook URL, or webhook secret).
+ */
+export type NotificationStatusResponse = {
+    /**
+     * Notifications Enabled
+     *
+     * Whether the NOTIFICATIONS_ENABLED master toggle is set to true.
+     */
+    notifications_enabled: boolean;
+    /**
+     * Smtp Configured
+     *
+     * Whether an SMTP host is configured (SMTP_HOST is set). Does not echo the host value.
+     */
+    smtp_configured: boolean;
+    /**
+     * Webhook Configured
+     *
+     * Whether a notification webhook URL is configured (NOTIFICATION_WEBHOOK_URL is set). Does not echo the URL.
+     */
+    webhook_configured: boolean;
+};
+/**
+ * NotificationTestChannelResult
+ *
+ * Per-channel result from POST /settings/notifications/test/.
+ *
+ * The ``error`` field contains only the exception type name and a short
+ * safe message — never the SMTP password, webhook URL, or webhook secret
+ * (T-1229-09 / NOTIF-05).
+ */
+export type NotificationTestChannelResult = {
+    /**
+     * Channel
+     *
+     * Channel name, e.g. 'smtp' or 'webhook'.
+     */
+    channel: string;
+    /**
+     * Error
+     *
+     * Safe error string (exception type name + short message) if ok=False, else null. Never contains secrets.
+     */
+    error?: string | null;
+    /**
+     * Ok
+     *
+     * True if the channel delivered the test notification without error.
+     */
+    ok: boolean;
+};
+/**
+ * NotificationTestResponse
+ *
+ * Response for POST /settings/notifications/test/ (NOTIF-06).
+ *
+ * Always returns HTTP 200 — a channel delivery failure is captured in the
+ * per-channel ``channels`` list rather than as a 5xx. Never contains secret
+ * values (T-1229-09 / NOTIF-05).
+ */
+export type NotificationTestResponse = {
+    /**
+     * Channels
+     *
+     * Per-channel delivery results. Empty when no channel is configured.
+     */
+    channels: Array<NotificationTestChannelResult>;
+    /**
+     * Message
+     *
+     * Human-readable summary of the test result.
+     */
+    message: string;
+    /**
+     * Sent
+     *
+     * True if at least one channel successfully delivered the test notification.
+     */
+    sent: boolean;
+};
 /**
  * OAuthProviderCreate
  *
@@ -5231,9 +5375,9 @@ export type OAuthProviderCreate = {
     /**
      * Provider Type
      *
-     * OAuth or SAML provider type. 'google' and 'microsoft' auto-populate the discovery URL; 'oidc' is generic OAuth/OIDC; 'saml' enables SAML SSO (requires enterprise edition).
+     * OAuth or SAML provider type. 'google' and 'microsoft' auto-populate the discovery URL; 'oidc' is generic OAuth/OIDC; 'github' uses GitHub's fixed OAuth2 endpoints (no discovery URL); 'saml' enables SAML SSO (requires enterprise edition).
      */
-    provider_type: 'google' | 'microsoft' | 'oidc' | 'saml';
+    provider_type: 'google' | 'microsoft' | 'oidc' | 'saml' | 'github';
     /**
      * Scopes
      *
@@ -5514,7 +5658,7 @@ export type OAuthProviderUpdate = {
      *
      * New provider type. Rarely changed after creation.
      */
-    provider_type?: 'google' | 'microsoft' | 'oidc' | 'saml' | null;
+    provider_type?: 'google' | 'microsoft' | 'oidc' | 'saml' | 'github' | null;
     /**
      * Scopes
      *
@@ -5604,7 +5748,7 @@ export type OgcCollectionMetadata = {
     /**
      * Itemtype
      *
-     * Type of items in the collection. Always 'feature' for OGC API Features.
+     * Type of items in the collection: 'feature' for vector feature collections, 'coverage' for raster/VRT collections (which expose tiles instead of feature items).
      */
     itemType?: string;
     /**
@@ -6649,6 +6793,12 @@ export type RegisterResponse = {
      * Message
      */
     message: string;
+    /**
+     * Next Step
+     *
+     * Post-registration step for the client to display: 'verify_email' when a verification email was (or, for a swallowed collision, would have been) sent; 'await_approval' for the admin-approval path. None on non-register responses.
+     */
+    next_step?: 'verify_email' | 'await_approval' | null;
 };
 /**
  * RelatedDatasetItem
@@ -6709,6 +6859,17 @@ export type RenameColumnRequest = {
      */
     new_name: string;
 };
+/**
+ * ResendVerificationRequest
+ */
+export type ResendVerificationRequest = {
+    /**
+     * Email
+     *
+     * Email address to resend the verification link to
+     */
+    email: string;
+};
 /**
  * ReservedRenameDetail
  */
@@ -8175,7 +8336,7 @@ export type SublayerOverride = {
     /**
      * Opacity
      *
-     * Per-sublayer opacity (0-1), or null to use the basemap default. Additive on top of BasemapConfig.opacity (the whole-basemap master opacity). IN-02 (Phase 1059 code review): this field is populated via API or a future Phase milestone. The current UI opacity slider in BasemapSublayerEditorScene routes through the legacy sublayerState path (MapBuilderPage.tsx handleSublayerOpacityChange) per D-09 ('OPACITY — existing slider untouched') and does not call updateSublayerOverride. See TODO(BUILDER-SUBLAYER-PERSIST) comment at MapBuilderPage.tsx for the deferral rationale.
+     * Per-sublayer opacity (0-1), or null to use the basemap default. Composes on top of BasemapConfig.opacity (the whole-basemap master opacity): the rendered opacity is override.opacity * master_opacity (builder-audit #338 CORR-01). The UI opacity slider in BasemapSublayerEditorScene persists through this field: MapBuilderPage.handleSublayerOpacityChange -> setBasemapSublayerOpacity -> updateBasemapSublayerOverride writes config.sublayer_overrides[key].opacity.
      */
     opacity?: number | null;
     /**
@@ -8407,6 +8568,12 @@ export type UploadConfigResponse = {
      * Whether presigned S3 uploads are enabled (requires `STORAGE_PROVIDER=s3`).
      */
     presigned_uploads: boolean;
+    /**
+     * Remaining Dataset Quota
+     *
+     * Datasets the caller may still create before hitting the per-user count cap, or null when no count cap is configured (unlimited). Advisory UX hint only — the cap is enforced server-side at upload.
+     */
+    remaining_dataset_quota?: number | null;
 };
 /**
  * UploadResponse
@@ -8488,6 +8655,29 @@ export type UserNameItem = {
      */
     username: string;
 };
+/**
+ * UserQuotaUsage
+ *
+ * Per-user quota usage: current consumption vs configured caps.
+ */
+export type UserQuotaUsage = {
+    /**
+     * Bytes Used
+     */
+    bytes_used: number;
+    /**
+     * Count Cap
+     */
+    count_cap: number;
+    /**
+     * Dataset Count
+     */
+    dataset_count: number;
+    /**
+     * Storage Cap
+     */
+    storage_cap: number;
+};
 /**
  * UserResponse
  */
@@ -8512,6 +8702,10 @@ export type UserResponse = {
      * Last Login At
      */
     last_login_at: string | null;
+    /**
+     * Per-user storage quota usage. Populated only on admin list responses; None when the caller did not load usage (e.g. /auth/me, single-user GET).
+     */
+    quota_usage?: UserQuotaUsage | null;
     /**
      * Roles
      *
@@ -8644,6 +8838,17 @@ export type VectorTileToken = {
      */
     sig: string;
 };
+/**
+ * VerifyEmailRequest
+ */
+export type VerifyEmailRequest = {
+    /**
+     * Token
+     *
+     * Raw opaque verification token from the email link
+     */
+    token: string;
+};
 /**
  * VisibilityCheckResponse
  */
@@ -9840,6 +10045,45 @@ export type CreateUserAdminUsersPostResponses = {
     201: UserResponse;
 };
 export type CreateUserAdminUsersPostResponse = CreateUserAdminUsersPostResponses[keyof CreateUserAdminUsersPostResponses];
+export type ExportUsersCsvAdminUsersExportCsvGetData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/admin/users/export.csv';
+};
+export type ExportUsersCsvAdminUsersExportCsvGetErrors = {
+    /**
+     * Bad request — invalid query parameters or payload
+     */
+    400: ProblemDetail;
+    /**
+     * Unauthorized — missing or invalid credentials
+     */
+    401: ProblemDetail;
+    /**
+     * Forbidden — caller lacks access to this resource
+     */
+    403: ProblemDetail;
+    /**
+     * Not found
+     */
+    404: ProblemDetail;
+    /**
+     * Validation error
+     */
+    422: ProblemDetail;
+    /**
+     * Internal server error
+     */
+    500: ProblemDetail;
+};
+export type ExportUsersCsvAdminUsersExportCsvGetError = ExportUsersCsvAdminUsersExportCsvGetErrors[keyof ExportUsersCsvAdminUsersExportCsvGetErrors];
+export type ExportUsersCsvAdminUsersExportCsvGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: unknown;
+};
 export type ListUserNamesAdminUsersNamesGetData = {
     body?: never;
     path?: never;
@@ -10206,6 +10450,46 @@ export type RejectUserAdminUsersUserIdRejectPostResponses = {
     204: void;
 };
 export type RejectUserAdminUsersUserIdRejectPostResponse = RejectUserAdminUsersUserIdRejectPostResponses[keyof RejectUserAdminUsersUserIdRejectPostResponses];
+export type AiAvailabilityEndpointAiAvailabilityGetData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/ai/availability/';
+};
+export type AiAvailabilityEndpointAiAvailabilityGetErrors = {
+    /**
+     * Bad request — invalid query parameters or payload
+     */
+    400: ProblemDetail;
+    /**
+     * Unauthorized — missing or invalid credentials
+     */
+    401: ProblemDetail;
+    /**
+     * Forbidden — caller lacks access to this resource
+     */
+    403: ProblemDetail;
+    /**
+     * Not found
+     */
+    404: ProblemDetail;
+    /**
+     * Validation error
+     */
+    422: ProblemDetail;
+    /**
+     * Internal server error
+     */
+    500: ProblemDetail;
+};
+export type AiAvailabilityEndpointAiAvailabilityGetError = AiAvailabilityEndpointAiAvailabilityGetErrors[keyof AiAvailabilityEndpointAiAvailabilityGetErrors];
+export type AiAvailabilityEndpointAiAvailabilityGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: AiAvailabilityResponse;
+};
+export type AiAvailabilityEndpointAiAvailabilityGetResponse = AiAvailabilityEndpointAiAvailabilityGetResponses[keyof AiAvailabilityEndpointAiAvailabilityGetResponses];
 export type ChatEndpointAiChatPostData = {
     body: ChatRequest;
     path?: never;
@@ -10997,6 +11281,46 @@ export type MePermissionsAuthMePermissionsGetResponses = {
     200: PermissionsResponse;
 };
 export type MePermissionsAuthMePermissionsGetResponse = MePermissionsAuthMePermissionsGetResponses[keyof MePermissionsAuthMePermissionsGetResponses];
+export type MeUsageAuthMeUsageGetData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/auth/me/usage/';
+};
+export type MeUsageAuthMeUsageGetErrors = {
+    /**
+     * Bad request — invalid query parameters or payload
+     */
+    400: ProblemDetail;
+    /**
+     * Unauthorized — missing or invalid credentials
+     */
+    401: ProblemDetail;
+    /**
+     * Forbidden — caller lacks access to this resource
+     */
+    403: ProblemDetail;
+    /**
+     * Not found
+     */
+    404: ProblemDetail;
+    /**
+     * Validation error
+     */
+    422: ProblemDetail;
+    /**
+     * Internal server error
+     */
+    500: ProblemDetail;
+};
+export type MeUsageAuthMeUsageGetError = MeUsageAuthMeUsageGetErrors[keyof MeUsageAuthMeUsageGetErrors];
+export type MeUsageAuthMeUsageGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: UserQuotaUsage;
+};
+export type MeUsageAuthMeUsageGetResponse = MeUsageAuthMeUsageGetResponses[keyof MeUsageAuthMeUsageGetResponses];
 export type ListPublicProvidersAuthOauthProvidersGetData = {
     body?: never;
     path?: never;
@@ -11201,6 +11525,86 @@ export type RegisterAuthRegisterPostResponses = {
     201: RegisterResponse;
 };
 export type RegisterAuthRegisterPostResponse = RegisterAuthRegisterPostResponses[keyof RegisterAuthRegisterPostResponses];
+export type ResendVerificationAuthResendVerificationPostData = {
+    body: ResendVerificationRequest;
+    path?: never;
+    query?: never;
+    url: '/auth/resend-verification/';
+};
+export type ResendVerificationAuthResendVerificationPostErrors = {
+    /**
+     * Bad request — invalid query parameters or payload
+     */
+    400: ProblemDetail;
+    /**
+     * Unauthorized — missing or invalid credentials
+     */
+    401: ProblemDetail;
+    /**
+     * Forbidden — caller lacks access to this resource
+     */
+    403: ProblemDetail;
+    /**
+     * Not found
+     */
+    404: ProblemDetail;
+    /**
+     * Validation error
+     */
+    422: ProblemDetail;
+    /**
+     * Internal server error
+     */
+    500: ProblemDetail;
+};
+export type ResendVerificationAuthResendVerificationPostError = ResendVerificationAuthResendVerificationPostErrors[keyof ResendVerificationAuthResendVerificationPostErrors];
+export type ResendVerificationAuthResendVerificationPostResponses = {
+    /**
+     * Successful Response
+     */
+    200: RegisterResponse;
+};
+export type ResendVerificationAuthResendVerificationPostResponse = ResendVerificationAuthResendVerificationPostResponses[keyof ResendVerificationAuthResendVerificationPostResponses];
+export type VerifyEmailAuthVerifyEmailPostData = {
+    body: VerifyEmailRequest;
+    path?: never;
+    query?: never;
+    url: '/auth/verify-email/';
+};
+export type VerifyEmailAuthVerifyEmailPostErrors = {
+    /**
+     * Bad request — invalid query parameters or payload
+     */
+    400: ProblemDetail;
+    /**
+     * Unauthorized — missing or invalid credentials
+     */
+    401: ProblemDetail;
+    /**
+     * Forbidden — caller lacks access to this resource
+     */
+    403: ProblemDetail;
+    /**
+     * Not found
+     */
+    404: ProblemDetail;
+    /**
+     * Validation error
+     */
+    422: ProblemDetail;
+    /**
+     * Internal server error
+     */
+    500: ProblemDetail;
+};
+export type VerifyEmailAuthVerifyEmailPostError = VerifyEmailAuthVerifyEmailPostErrors[keyof VerifyEmailAuthVerifyEmailPostErrors];
+export type VerifyEmailAuthVerifyEmailPostResponses = {
+    /**
+     * Successful Response
+     */
+    200: RegisterResponse;
+};
+export type VerifyEmailAuthVerifyEmailPostResponse = VerifyEmailAuthVerifyEmailPostResponses[keyof VerifyEmailAuthVerifyEmailPostResponses];
 export type ListCollectionsEndpointCatalogCollectionsGetData = {
     body?: never;
     path?: never;
@@ -15790,9 +16194,11 @@ export type GetJobStatusByDatasetJobsByDatasetDatasetIdGetErrors = {
 export type GetJobStatusByDatasetJobsByDatasetDatasetIdGetError = GetJobStatusByDatasetJobsByDatasetDatasetIdGetErrors[keyof GetJobStatusByDatasetJobsByDatasetDatasetIdGetErrors];
 export type GetJobStatusByDatasetJobsByDatasetDatasetIdGetResponses = {
     /**
+     * Response Get Job Status By Dataset Jobs By Dataset  Dataset Id  Get
+     *
      * Successful Response
      */
-    200: JobStatusResponse;
+    200: JobStatusResponse | null;
 };
 export type GetJobStatusByDatasetJobsByDatasetDatasetIdGetResponse = GetJobStatusByDatasetJobsByDatasetDatasetIdGetResponses[keyof GetJobStatusByDatasetJobsByDatasetDatasetIdGetResponses];
 export type CleanupStaleJobsJobsCleanupStalePostData = {
@@ -19319,6 +19725,86 @@ export type GetMapDefaultsSettingsMapDefaultsGetResponses = {
     200: MapDefaultsResponse;
 };
 export type GetMapDefaultsSettingsMapDefaultsGetResponse = GetMapDefaultsSettingsMapDefaultsGetResponses[keyof GetMapDefaultsSettingsMapDefaultsGetResponses];
+export type GetNotificationStatusSettingsNotificationsStatusGetData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/settings/notifications/status/';
+};
+export type GetNotificationStatusSettingsNotificationsStatusGetErrors = {
+    /**
+     * Bad request — invalid query parameters or payload
+     */
+    400: ProblemDetail;
+    /**
+     * Unauthorized — missing or invalid credentials
+     */
+    401: ProblemDetail;
+    /**
+     * Forbidden — caller lacks access to this resource
+     */
+    403: ProblemDetail;
+    /**
+     * Not found
+     */
+    404: ProblemDetail;
+    /**
+     * Validation error
+     */
+    422: ProblemDetail;
+    /**
+     * Internal server error
+     */
+    500: ProblemDetail;
+};
+export type GetNotificationStatusSettingsNotificationsStatusGetError = GetNotificationStatusSettingsNotificationsStatusGetErrors[keyof GetNotificationStatusSettingsNotificationsStatusGetErrors];
+export type GetNotificationStatusSettingsNotificationsStatusGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: NotificationStatusResponse;
+};
+export type GetNotificationStatusSettingsNotificationsStatusGetResponse = GetNotificationStatusSettingsNotificationsStatusGetResponses[keyof GetNotificationStatusSettingsNotificationsStatusGetResponses];
+export type SendTestNotificationSettingsNotificationsTestPostData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/settings/notifications/test/';
+};
+export type SendTestNotificationSettingsNotificationsTestPostErrors = {
+    /**
+     * Bad request — invalid query parameters or payload
+     */
+    400: ProblemDetail;
+    /**
+     * Unauthorized — missing or invalid credentials
+     */
+    401: ProblemDetail;
+    /**
+     * Forbidden — caller lacks access to this resource
+     */
+    403: ProblemDetail;
+    /**
+     * Not found
+     */
+    404: ProblemDetail;
+    /**
+     * Validation error
+     */
+    422: ProblemDetail;
+    /**
+     * Internal server error
+     */
+    500: ProblemDetail;
+};
+export type SendTestNotificationSettingsNotificationsTestPostError = SendTestNotificationSettingsNotificationsTestPostErrors[keyof SendTestNotificationSettingsNotificationsTestPostErrors];
+export type SendTestNotificationSettingsNotificationsTestPostResponses = {
+    /**
+     * Successful Response
+     */
+    200: NotificationTestResponse;
+};
+export type SendTestNotificationSettingsNotificationsTestPostResponse = SendTestNotificationSettingsNotificationsTestPostResponses[keyof SendTestNotificationSettingsNotificationsTestPostResponses];
 export type ListOauthProvidersSettingsOauthProvidersGetData = {
     body?: never;
     path?: never;