@safercity/sdk 0.1.2 → 0.2.0

package/dist/index.d.ts

@@ -2,36 +2,524 @@ import * as _safercity_sdk_core from '@safercity/sdk-core';
 import { SaferCityConfig, StreamAdapter, BaseClient, EventSourceOptions, ServerSentEvent, OAuthCredentials, TokenStorage } from '@safercity/sdk-core';
 export { ApiError, ApiResponse, AuthMode, AuthTokens, ClientModeConfig, CookieModeConfig, DirectModeConfig, EventSourceOptions, FetchStreamAdapter, MemoryTokenStorage, OAuthCredentials, ProxyModeConfig, RequestOptions, SaferCityApiError, SaferCityConfig, SaferCityJwtPayload, ServerSentEvent, StreamAdapter, TokenManager, TokenManagerConfig, TokenStorage, WebStreamAdapter, createAuthHeader, createStreamAdapter, getJwtExpiration, isTokenExpired, parseJwtPayload } from '@safercity/sdk-core';
 
+interface PanicInformationRecord {
+    id: string;
+    tenantId: string;
+    userId: string;
+    phoneNumber: string;
+    firstName: string;
+    lastName: string;
+    idNumber: string;
+    duressCode?: string;
+    emergencyContacts: Array<{
+        name: string;
+        phoneNumber: string;
+        relationship?: string;
+    }> | null;
+    scaExternalId?: string | null;
+    scbExternalId?: string | null;
+    sccExternalId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
 interface SaferCityClientOptions extends SaferCityConfig {
     /**
-     * Custom stream adapter for SSE (auto-detected if not provided)
+     * User ID for user-scoped operations
+     */
+    userId?: string;
+    /**
+     * Custom stream adapter for SSE (auto-detected if not provided)
+     */
+    streamAdapter?: StreamAdapter;
+}
+/**
+ * Create a SaferCity API client
+ *
+ * This client exposes user-scoped endpoints only.
+ * For admin/server operations, use `createServerClient` instead.
+ */
+declare function createSaferCityClient(options: SaferCityClientOptions): {
+    /**
+     * Access the underlying base client for custom requests
+     */
+    _client: BaseClient;
+    /**
+     * Update authentication token
+     */
+    setToken: (token: string | undefined) => void;
+    /**
+     * Update tenant ID
+     */
+    setTenantId: (tenantId: string | undefined) => void;
+    /**
+     * Update user ID
+     */
+    setUserId: (nextUserId: string | undefined) => void;
+    /**
+     * Get current user ID
+     */
+    getUserId: () => string | undefined;
+    /**
+     * Get current configuration
+     */
+    getConfig: () => Readonly<SaferCityConfig>;
+    health: {
+        /**
+         * Check API health status
+         */
+        check: () => Promise<_safercity_sdk_core.ApiResponse<{
+            status: string;
+            timestamp: string;
+            panicProviders?: {
+                healthy: boolean;
+                stats?: unknown;
+                providers?: unknown;
+            };
+        }>>;
+    };
+    auth: {
+        /**
+         * Get current authentication context
+         */
+        whoami: () => Promise<_safercity_sdk_core.ApiResponse<{
+            tenantId: string | null;
+            environment: string;
+            scopes: string[];
+            sessionId: string;
+        }>>;
+        /**
+         * Check if authenticated (optional auth)
+         */
+        check: () => Promise<_safercity_sdk_core.ApiResponse<{
+            authenticated: boolean;
+            tenantId: string | null;
+        }>>;
+    };
+    users: {
+        /**
+         * Create user (used by tenant apps to register users)
+         */
+        create: (body: {
+            email?: string;
+            phone?: string;
+            firstName?: string;
+            lastName?: string;
+            metadata?: Record<string, unknown>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            id: string;
+            email?: string;
+            phone?: string;
+        }>>;
+        /**
+         * Get user by ID
+         */
+        get: (userId?: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            id: string;
+            email?: string;
+            phone?: string;
+            firstName?: string;
+            lastName?: string;
+            status: string;
+            metadata?: Record<string, unknown>;
+        }>>;
+        /**
+         * Update user (user can update self)
+         */
+        update: (userId: string | undefined, body: {
+            email?: string;
+            phone?: string;
+            firstName?: string;
+            lastName?: string;
+            metadata?: Record<string, unknown>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            id: string;
+        }>>;
+    };
+    panics: {
+        /**
+         * Create panic
+         */
+        create: (body: {
+            userId?: string;
+            panicTypeId?: string;
+            latitude: number;
+            longitude: number;
+            accuracy?: number;
+            metadata?: Record<string, unknown>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            id: string;
+            status: string;
+            createdAt: string;
+        }>>;
+        /**
+         * Get panic by ID
+         */
+        get: (panicId: string, query?: {
+            userId?: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            id: string;
+            userId: string;
+            status: string;
+            latitude: number;
+            longitude: number;
+            createdAt: string;
+            updatedAt?: string;
+        }>>;
+        /**
+         * Update panic location
+         */
+        updateLocation: (panicId: string, body: {
+            userId?: string;
+            latitude: number;
+            longitude: number;
+            accuracy?: number;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            id: string;
+            latitude: number;
+            longitude: number;
+        }>>;
+        /**
+         * Cancel panic
+         */
+        cancel: (panicId: string, body: {
+            userId?: string;
+            reason?: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            id: string;
+            status: string;
+            cancelledAt: string;
+        }>>;
+        /**
+         * Get available panic types for a user
+         */
+        types: (userId?: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            types: Array<{
+                id: string;
+                name: string;
+                description?: string;
+            }>;
+        }>>;
+        /**
+         * Stream panic updates (SSE)
+         */
+        streamUpdates: (panicId: string, options?: EventSourceOptions) => AsyncIterable<ServerSentEvent>;
+    };
+    panicInformation: {
+        /**
+         * Create panic information profile
+         */
+        create: (body: {
+            userId?: string;
+            phoneNumber: string;
+            firstName: string;
+            lastName: string;
+            idNumber: string;
+            duressCode?: string;
+            emergencyContacts?: Array<{
+                name: string;
+                phoneNumber: string;
+                relationship?: string;
+            }>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: PanicInformationRecord;
+            message: string;
+        }>>;
+        /**
+         * Get panic information by ID
+         */
+        get: (id: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: PanicInformationRecord;
+        }>>;
+        /**
+         * Get panic information by user ID
+         */
+        getByUser: (userId?: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: PanicInformationRecord;
+        }>>;
+        /**
+         * Update panic information
+         */
+        update: (id: string, body: {
+            phoneNumber?: string;
+            firstName?: string;
+            lastName?: string;
+            idNumber?: string;
+            duressCode?: string;
+            emergencyContacts?: Array<{
+                name: string;
+                phoneNumber: string;
+                relationship?: string;
+            }>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: PanicInformationRecord;
+            message: string;
+        }>>;
+        /**
+         * Delete panic information
+         */
+        delete: (id: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            message: string;
+        }>>;
+        /**
+         * Validate user eligibility for panic services
+         */
+        validateEligibility: (userId?: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: {
+                eligible: boolean;
+                subscriptionActive: boolean;
+                profileComplete: boolean;
+                reasons: string[];
+                panicInformation: PanicInformationRecord | null;
+                subscriptionDetails: {
+                    usedSeats: number;
+                    userHasActiveSubscription: boolean;
+                } | null;
+            };
+        }>>;
+    };
+    subscriptions: {
+        /**
+         * List subscription types
+         */
+        listTypes: () => Promise<_safercity_sdk_core.ApiResponse<{
+            types: Array<{
+                id: string;
+                name: string;
+                description?: string;
+                price?: number;
+            }>;
+        }>>;
+        /**
+         * Create subscription
+         */
+        create: (body: {
+            userId?: string;
+            subscriptionTypeId: string;
+            status?: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            id: string;
+            userId: string;
+            subscriptionTypeId: string;
+            status: string;
+        }>>;
+        /**
+         * List subscriptions
+         */
+        list: (query?: {
+            userId?: string;
+            status?: string;
+            limit?: number;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            subscriptions: Array<{
+                id: string;
+                userId: string;
+                subscriptionTypeId: string;
+                status: string;
+            }>;
+        }>>;
+        /**
+         * Subscribe a user to a subscription type
+         */
+        subscribeUser: (body: {
+            userId?: string;
+            subscriptionTypeId: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            id: string;
+            userId: string;
+            subscriptionTypeId: string;
+            status: string;
+        }>>;
+    };
+    notifications: {
+        /**
+         * Create subscriber
+         */
+        createSubscriber: (body: {
+            userId?: string;
+            email?: string;
+            phone?: string;
+            data?: Record<string, unknown>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            subscriberId: string;
+        }>>;
+        /**
+         * Trigger notification
+         */
+        trigger: (body: {
+            userId?: string;
+            workflowId: string;
+            payload?: Record<string, unknown>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            transactionId: string;
+            status: string;
+        }>>;
+        /**
+         * Bulk trigger notifications
+         */
+        bulkTrigger: (body: {
+            userIds: string[];
+            workflowId: string;
+            payload?: Record<string, unknown>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            transactionIds: string[];
+            status: string;
+        }>>;
+        /**
+         * Get user preferences
+         */
+        getPreferences: (userId?: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            preferences: Record<string, unknown>;
+        }>>;
+        /**
+         * Update user preferences
+         */
+        updatePreferences: (userId: string | undefined, body: {
+            preferences: Record<string, unknown>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+        }>>;
+    };
+    locationSafety: {
+        /**
+         * Check location safety
+         */
+        check: (body: {
+            latitude: number;
+            longitude: number;
+            radius?: number;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            safetyScore: number;
+            riskLevel: string;
+            factors: Array<{
+                type: string;
+                impact: number;
+            }>;
+        }>>;
+    };
+    banner: {
+        /**
+         * Get crime banner data for a location
+         */
+        get: (body: {
+            latitude: number;
+            longitude: number;
+            radius?: number;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: {
+                totalCrimes: number;
+                categories: Array<{
+                    name: string;
+                    count: number;
+                }>;
+                period: string;
+            };
+        }>>;
+    };
+    crimes: {
+        /**
+         * List crimes
+         */
+        list: (query?: {
+            latitude?: number;
+            longitude?: number;
+            radius?: number;
+            type?: string;
+            from?: string;
+            to?: string;
+            limit?: number;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            crimes: Array<{
+                id: string;
+                type: string;
+                latitude: number;
+                longitude: number;
+                occurredAt: string;
+            }>;
+        }>>;
+        /**
+         * Get crime categories
+         */
+        categories: () => Promise<_safercity_sdk_core.ApiResponse<{
+            categories: Array<{
+                id: string;
+                name: string;
+            }>;
+        }>>;
+        /**
+         * Get crime types
+         */
+        types: () => Promise<_safercity_sdk_core.ApiResponse<{
+            types: Array<{
+                id: string;
+                name: string;
+                categoryId: string;
+            }>;
+        }>>;
+        /**
+         * Get crime categories with their types
+         */
+        categoriesWithTypes: () => Promise<_safercity_sdk_core.ApiResponse<{
+            categories: Array<{
+                id: string;
+                name: string;
+                types: Array<{
+                    id: string;
+                    name: string;
+                }>;
+            }>;
+        }>>;
+    };
+};
+type SaferCityClient = ReturnType<typeof createSaferCityClient>;
+
+interface ServerClientConfig extends Pick<SaferCityConfig, 'baseUrl' | 'timeout' | 'fetch'> {
+    /**
+     * OAuth credentials for authentication
      */
-    streamAdapter?: StreamAdapter;
+    auth: OAuthCredentials;
+    /**
+     * Custom token storage (defaults to in-memory)
+     */
+    tokenStore?: TokenStorage;
 }
 /**
- * Create a SaferCity API client
+ * Server client that wraps the base client with automatic OAuth token management
  */
-declare function createSaferCityClient(options: SaferCityClientOptions): {
+declare class ServerClient extends BaseClient {
+    private tokenManager;
+    constructor(config: ServerClientConfig);
     /**
-     * Access the underlying base client for custom requests
+     * Get a valid access token
      */
-    _client: BaseClient;
+    getAccessToken(): Promise<string>;
     /**
-     * Update authentication token
+     * Force refresh the token
      */
-    setToken: (token: string | undefined) => void;
+    refreshToken(): Promise<string>;
     /**
-     * Update tenant ID
+     * Clear stored tokens
      */
-    setTenantId: (tenantId: string | undefined) => void;
+    clearTokens(): void;
     /**
-     * Get current configuration
+     * Make an authenticated request
+     * Automatically adds the Authorization header with a valid token
      */
-    getConfig: () => Readonly<SaferCityConfig>;
-    health: {
-        /**
-         * Check API health status
-         */
+    protected request<T>(method: string, path: string, options?: Parameters<BaseClient['request']>[2]): Promise<{
+        data: T;
+        status: number;
+        headers: Headers;
+    }>;
+    /**
+     * Check API health status
+     */
+    get health(): {
         check: () => Promise<_safercity_sdk_core.ApiResponse<{
             status: string;
             timestamp: string;
@@ -42,7 +530,10 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
             };
         }>>;
     };
-    auth: {
+    /**
+     * Authentication helpers
+     */
+    get auth(): {
         /**
          * Get current authentication context
          */
@@ -60,7 +551,10 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
             tenantId: string | null;
         }>>;
     };
-    oauth: {
+    /**
+     * OAuth helpers
+     */
+    get oauth(): {
         /**
          * Get access token
          */
@@ -107,7 +601,10 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
             success: boolean;
         }>>;
     };
-    tenants: {
+    /**
+     * Tenant helpers
+     */
+    get tenants(): {
         /**
          * Create a new tenant
          */
@@ -134,7 +631,10 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
             cursor?: string;
         }>>;
     };
-    credentials: {
+    /**
+     * Credential helpers
+     */
+    get credentials(): {
         /**
          * Exchange setup token for credentials
          */
@@ -163,7 +663,10 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
             success: boolean;
         }>>;
     };
-    users: {
+    /**
+     * User helpers
+     */
+    get users(): {
         /**
          * Create user
          */
@@ -235,7 +738,10 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
             success: boolean;
         }>>;
     };
-    panics: {
+    /**
+     * Panic helpers (streaming not available in server client)
+     */
+    get panics(): {
         /**
          * Create panic
          */
@@ -308,11 +814,20 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
             cancelledAt: string;
         }>>;
         /**
-         * Stream panic updates (SSE)
+         * Get available panic types for a user
          */
-        streamUpdates: (panicId: string, options?: EventSourceOptions) => AsyncIterable<ServerSentEvent>;
+        types: (userId: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            types: Array<{
+                id: string;
+                name: string;
+                description?: string;
+            }>;
+        }>>;
     };
-    subscriptions: {
+    /**
+     * Subscription helpers
+     */
+    get subscriptions(): {
         /**
          * List subscription types
          */
@@ -360,8 +875,23 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
             active: number;
             byType: Record<string, number>;
         }>>;
+        /**
+         * Subscribe a user to a subscription type
+         */
+        subscribeUser: (body: {
+            userId: string;
+            subscriptionTypeId: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            id: string;
+            userId: string;
+            subscriptionTypeId: string;
+            status: string;
+        }>>;
     };
-    notifications: {
+    /**
+     * Notification helpers
+     */
+    get notifications(): {
         /**
          * Create subscriber
          */
@@ -384,6 +914,17 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
             transactionId: string;
             status: string;
         }>>;
+        /**
+         * Bulk trigger notifications
+         */
+        bulkTrigger: (body: {
+            userIds: string[];
+            workflowId: string;
+            payload?: Record<string, unknown>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            transactionIds: string[];
+            status: string;
+        }>>;
         /**
          * Get user preferences
          */
@@ -399,11 +940,113 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
             success: boolean;
         }>>;
     };
-    locationSafety: {
+    /**
+     * Panic information helpers
+     */
+    get panicInformation(): {
+        /**
+         * Create panic information profile
+         */
+        create: (body: {
+            userId: string;
+            phoneNumber: string;
+            firstName: string;
+            lastName: string;
+            idNumber: string;
+            duressCode?: string;
+            emergencyContacts?: Array<{
+                name: string;
+                phoneNumber: string;
+                relationship?: string;
+            }>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: PanicInformationRecord;
+            message: string;
+        }>>;
+        /**
+         * List panic information records
+         */
+        list: (query?: {
+            limit?: number;
+            offset?: number;
+            userId?: string;
+            idNumber?: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: PanicInformationRecord[];
+            pagination: {
+                limit: number;
+                offset: number;
+                hasMore: boolean;
+            };
+        }>>;
+        /**
+         * Get panic information by ID
+         */
+        get: (id: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: PanicInformationRecord;
+        }>>;
+        /**
+         * Get panic information by user ID
+         */
+        getByUser: (userId: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: PanicInformationRecord;
+        }>>;
+        /**
+         * Update panic information
+         */
+        update: (id: string, body: {
+            phoneNumber?: string;
+            firstName?: string;
+            lastName?: string;
+            idNumber?: string;
+            duressCode?: string;
+            emergencyContacts?: Array<{
+                name: string;
+                phoneNumber: string;
+                relationship?: string;
+            }>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: PanicInformationRecord;
+            message: string;
+        }>>;
+        /**
+         * Delete panic information
+         */
+        delete: (id: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            message: string;
+        }>>;
+        /**
+         * Validate user eligibility for panic services
+         */
+        validateEligibility: (userId: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: {
+                eligible: boolean;
+                subscriptionActive: boolean;
+                profileComplete: boolean;
+                reasons: string[];
+                panicInformation: PanicInformationRecord | null;
+                subscriptionDetails: {
+                    usedSeats: number;
+                    userHasActiveSubscription: boolean;
+                } | null;
+            };
+        }>>;
+    };
+    /**
+     * Location safety helpers
+     */
+    get locationSafety(): {
         /**
          * Check location safety
          */
-        check: (query: {
+        check: (body: {
             latitude: number;
             longitude: number;
             radius?: number;
@@ -416,7 +1059,33 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
             }>;
         }>>;
     };
-    crimes: {
+    /**
+     * Banner helpers
+     */
+    get banner(): {
+        /**
+         * Get crime banner data for a location
+         */
+        get: (body: {
+            latitude: number;
+            longitude: number;
+            radius?: number;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+            data: {
+                totalCrimes: number;
+                categories: Array<{
+                    name: string;
+                    count: number;
+                }>;
+                period: string;
+            };
+        }>>;
+    };
+    /**
+     * Crime helpers
+     */
+    get crimes(): {
         /**
          * List crimes
          */
@@ -456,68 +1125,20 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
                 categoryId: string;
             }>;
         }>>;
+        /**
+         * Get crime categories with their types
+         */
+        categoriesWithTypes: () => Promise<_safercity_sdk_core.ApiResponse<{
+            categories: Array<{
+                id: string;
+                name: string;
+                types: Array<{
+                    id: string;
+                    name: string;
+                }>;
+            }>;
+        }>>;
     };
-};
-type SaferCityClient = ReturnType<typeof createSaferCityClient>;
-
-/**
- * Server-side SaferCity Client
- *
- * For backend applications that need to authenticate with OAuth client credentials.
- * Handles automatic token management and refresh.
- */
-
-interface ServerClientConfig {
-    /**
-     * SaferCity API base URL
-     * @default "https://api.safercity.com"
-     */
-    baseUrl?: string;
-    /**
-     * OAuth credentials for authentication
-     */
-    auth: OAuthCredentials;
-    /**
-     * Custom token storage (defaults to in-memory)
-     */
-    tokenStore?: TokenStorage;
-    /**
-     * Request timeout in milliseconds
-     * @default 30000
-     */
-    timeout?: number;
-    /**
-     * Custom fetch implementation
-     */
-    fetch?: typeof fetch;
-}
-/**
- * Server client that wraps the base client with automatic OAuth token management
- */
-declare class ServerClient extends BaseClient {
-    private tokenManager;
-    constructor(config: ServerClientConfig);
-    /**
-     * Get a valid access token
-     */
-    getAccessToken(): Promise<string>;
-    /**
-     * Force refresh the token
-     */
-    refreshToken(): Promise<string>;
-    /**
-     * Clear stored tokens
-     */
-    clearTokens(): void;
-    /**
-     * Make an authenticated request
-     * Automatically adds the Authorization header with a valid token
-     */
-    protected request<T>(method: string, path: string, options?: Parameters<BaseClient['request']>[2]): Promise<{
-        data: T;
-        status: number;
-        headers: Headers;
-    }>;
 }
 /**
  * Create a server-side SaferCity client with automatic OAuth token management
@@ -544,6 +1165,10 @@ declare function createServerClient(config: ServerClientConfig): ServerClient;
  * with automatic tenant authentication.
  */
 
+type EndpointPattern = string | {
+    method?: string;
+    path: string;
+};
 interface ProxyConfig {
     /**
      * OAuth client ID
@@ -580,6 +1205,14 @@ interface ProxyConfig {
      * Custom fetch implementation
      */
     fetch?: typeof fetch;
+    /**
+     * Explicitly allowed endpoints for proxy forwarding
+     */
+    allowedEndpoints?: EndpointPattern[];
+    /**
+     * Explicitly blocked endpoints for proxy forwarding
+     */
+    blockedEndpoints?: EndpointPattern[];
 }
 /**
  * Create a Next.js App Router handler for proxying SaferCity API requests
@@ -674,4 +1307,4 @@ declare function createProxyHandler(config: ProxyConfig): (request: {
     body: unknown;
 }>;
 
-export { type ProxyConfig, type SaferCityClient, type SaferCityClientOptions, ServerClient, type ServerClientConfig, createExpressMiddleware, createNextHandler, createProxyHandler, createSaferCityClient, createServerClient };
+export { type EndpointPattern, type PanicInformationRecord, type ProxyConfig, type SaferCityClient, type SaferCityClientOptions, ServerClient, type ServerClientConfig, createExpressMiddleware, createNextHandler, createProxyHandler, createSaferCityClient, createServerClient };