@safercity/sdk 0.0.1

package/dist/index.d.cts

@@ -0,0 +1,463 @@
+import * as _safercity_sdk_core from '@safercity/sdk-core';
+import { SaferCityConfig, StreamAdapter, BaseClient, EventSourceOptions, ServerSentEvent } from '@safercity/sdk-core';
+export { ApiError, ApiResponse, AuthTokens, EventSourceOptions, FetchStreamAdapter, MemoryTokenStorage, RequestOptions, SaferCityApiError, SaferCityConfig, SaferCityJwtPayload, ServerSentEvent, StreamAdapter, TokenStorage, WebStreamAdapter, createAuthHeader, createStreamAdapter, getJwtExpiration, isTokenExpired, parseJwtPayload } from '@safercity/sdk-core';
+
+interface SaferCityClientOptions extends SaferCityConfig {
+    /**
+     * Custom stream adapter for SSE (auto-detected if not provided)
+     */
+    streamAdapter?: StreamAdapter;
+}
+/**
+ * Create a SaferCity API client
+ */
+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;
+    /**
+     * 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;
+        }>>;
+    };
+    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;
+        }>>;
+    };
+    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;
+        }>>;
+    };
+    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;
+        }>>;
+    };
+    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;
+        }>>;
+    };
+    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;
+        }>>;
+        /**
+         * Stream panic updates (SSE)
+         */
+        streamUpdates: (panicId: string, options?: EventSourceOptions) => AsyncIterable<ServerSentEvent>;
+    };
+    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>;
+        }>>;
+    };
+    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;
+        }>>;
+    };
+    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;
+            }>;
+        }>>;
+    };
+    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;
+            }>;
+        }>>;
+    };
+};
+type SaferCityClient = ReturnType<typeof createSaferCityClient>;
+
+export { type SaferCityClient, type SaferCityClientOptions, createSaferCityClient };