@safercity/sdk 0.1.1 → 0.1.3

package/dist/index.d.cts

@@ -265,24 +265,6 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
             createdAt: string;
             updatedAt?: string;
         }>>;
-        /**
-         * List panics
-         */
-        list: (query?: {
-            userId?: string;
-            status?: string;
-            limit?: number;
-            cursor?: string;
-        }) => Promise<_safercity_sdk_core.ApiResponse<{
-            panics: Array<{
-                id: string;
-                userId: string;
-                status: string;
-                createdAt: string;
-            }>;
-            hasNext: boolean;
-            cursor?: string;
-        }>>;
         /**
          * Update panic location
          */
@@ -352,14 +334,6 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
                 status: string;
             }>;
         }>>;
-        /**
-         * Get subscription stats
-         */
-        stats: () => Promise<_safercity_sdk_core.ApiResponse<{
-            total: number;
-            active: number;
-            byType: Record<string, number>;
-        }>>;
     };
     notifications: {
         /**
@@ -460,19 +434,7 @@ declare function createSaferCityClient(options: SaferCityClientOptions): {
 };
 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;
+interface ServerClientConfig extends Pick<SaferCityConfig, 'baseUrl' | 'timeout' | 'fetch'> {
     /**
      * OAuth credentials for authentication
      */
@@ -481,15 +443,6 @@ interface ServerClientConfig {
      * 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
@@ -518,6 +471,461 @@ declare class ServerClient extends BaseClient {
         status: number;
         headers: Headers;
     }>;
+    /**
+     * Check API health status
+     */
+    get health(): {
+        check: () => Promise<_safercity_sdk_core.ApiResponse<{
+            status: string;
+            timestamp: string;
+            panicProviders?: {
+                healthy: boolean;
+                stats?: unknown;
+                providers?: unknown;
+            };
+        }>>;
+    };
+    /**
+     * Authentication helpers
+     */
+    get 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;
+        }>>;
+    };
+    /**
+     * OAuth helpers
+     */
+    get oauth(): {
+        /**
+         * Get access token
+         */
+        token: (body: {
+            grant_type: "client_credentials" | "refresh_token";
+            tenantId?: string;
+            userId?: string;
+            refresh_token?: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            access_token: string;
+            token_type: string;
+            expires_in: number;
+            refresh_token?: string;
+        }>>;
+        /**
+         * Refresh access token
+         */
+        refresh: (body: {
+            refresh_token: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            access_token: string;
+            token_type: string;
+            expires_in: number;
+            refresh_token?: string;
+        }>>;
+        /**
+         * Introspect token
+         */
+        introspect: (body: {
+            token: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            active: boolean;
+            tenantId?: string;
+            sub?: string;
+            scope?: string;
+            exp?: number;
+        }>>;
+        /**
+         * Revoke token
+         */
+        revoke: (body: {
+            token: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+        }>>;
+    };
+    /**
+     * Tenant helpers
+     */
+    get tenants(): {
+        /**
+         * Create a new tenant
+         */
+        create: (body: {
+            name: string;
+            domain?: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            tenantId: string;
+            name: string;
+            setupToken: string;
+        }>>;
+        /**
+         * List tenants (admin)
+         */
+        list: (query?: {
+            limit?: number;
+            cursor?: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            tenants: Array<{
+                id: string;
+                name: string;
+            }>;
+            hasNext: boolean;
+            cursor?: string;
+        }>>;
+    };
+    /**
+     * Credential helpers
+     */
+    get credentials(): {
+        /**
+         * Exchange setup token for credentials
+         */
+        setup: (body: {
+            setupToken: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            clientId: string;
+            clientSecret: string;
+            tenantId: string;
+        }>>;
+        /**
+         * List credentials
+         */
+        list: () => Promise<_safercity_sdk_core.ApiResponse<{
+            credentials: Array<{
+                id: string;
+                clientId: string;
+                createdAt: string;
+                lastUsed?: string;
+            }>;
+        }>>;
+        /**
+         * Revoke credential
+         */
+        revoke: (credentialId: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+        }>>;
+    };
+    /**
+     * User helpers
+     */
+    get users(): {
+        /**
+         * Create user
+         */
+        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;
+        }>>;
+        /**
+         * List users
+         */
+        list: (query?: {
+            limit?: number;
+            cursor?: string;
+            status?: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            users: Array<{
+                id: string;
+                email?: string;
+                phone?: string;
+                status: string;
+            }>;
+            hasNext: boolean;
+            cursor?: 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
+         */
+        update: (userId: string, body: {
+            email?: string;
+            phone?: string;
+            firstName?: string;
+            lastName?: string;
+            metadata?: Record<string, unknown>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            id: string;
+        }>>;
+        /**
+         * Update user status
+         */
+        updateStatus: (userId: string, body: {
+            status: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            id: string;
+            status: string;
+        }>>;
+        /**
+         * Delete user
+         */
+        delete: (userId: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+        }>>;
+    };
+    /**
+     * Panic helpers (streaming not available in server client)
+     */
+    get 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;
+        }>>;
+        /**
+         * List panics
+         */
+        list: (query?: {
+            userId?: string;
+            status?: string;
+            limit?: number;
+            cursor?: string;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            panics: Array<{
+                id: string;
+                userId: string;
+                status: string;
+                createdAt: string;
+            }>;
+            hasNext: boolean;
+            cursor?: 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;
+        }>>;
+    };
+    /**
+     * Subscription helpers
+     */
+    get 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;
+            }>;
+        }>>;
+        /**
+         * Get subscription stats
+         */
+        stats: () => Promise<_safercity_sdk_core.ApiResponse<{
+            total: number;
+            active: number;
+            byType: Record<string, number>;
+        }>>;
+    };
+    /**
+     * Notification helpers
+     */
+    get 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;
+        }>>;
+        /**
+         * Get user preferences
+         */
+        getPreferences: (userId: string) => Promise<_safercity_sdk_core.ApiResponse<{
+            preferences: Record<string, unknown>;
+        }>>;
+        /**
+         * Update user preferences
+         */
+        updatePreferences: (userId: string, body: {
+            preferences: Record<string, unknown>;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            success: boolean;
+        }>>;
+    };
+    /**
+     * Location safety helpers
+     */
+    get locationSafety(): {
+        /**
+         * Check location safety
+         */
+        check: (query: {
+            latitude: number;
+            longitude: number;
+            radius?: number;
+        }) => Promise<_safercity_sdk_core.ApiResponse<{
+            safetyScore: number;
+            riskLevel: string;
+            factors: Array<{
+                type: string;
+                impact: number;
+            }>;
+        }>>;
+    };
+    /**
+     * Crime helpers
+     */
+    get 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;
+            }>;
+        }>>;
+    };
 }
 /**
  * Create a server-side SaferCity client with automatic OAuth token management