@safercity/sdk 0.0.1

package/dist/index.d.ts

@@ -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 };

package/dist/index.js

@@ -0,0 +1,238 @@
+import { BaseClient, createStreamAdapter } from '@safercity/sdk-core';
+export { FetchStreamAdapter, MemoryTokenStorage, SaferCityApiError, WebStreamAdapter, createAuthHeader, createStreamAdapter, getJwtExpiration, isTokenExpired, parseJwtPayload } from '@safercity/sdk-core';
+
+function createSaferCityClient(options) {
+  const baseClient = new BaseClient(options);
+  const streamAdapter = options.streamAdapter ?? createStreamAdapter(options.fetch);
+  return {
+    /**
+     * Access the underlying base client for custom requests
+     */
+    _client: baseClient,
+    /**
+     * Update authentication token
+     */
+    setToken: (token) => baseClient.setToken(token),
+    /**
+     * Update tenant ID
+     */
+    setTenantId: (tenantId) => baseClient.setTenantId(tenantId),
+    /**
+     * Get current configuration
+     */
+    getConfig: () => baseClient.getConfig(),
+    // ==================
+    // Health & System
+    // ==================
+    health: {
+      /**
+       * Check API health status
+       */
+      check: () => baseClient.get("/health")
+    },
+    // ==================
+    // Authentication
+    // ==================
+    auth: {
+      /**
+       * Get current authentication context
+       */
+      whoami: () => baseClient.get("/auth/whoami"),
+      /**
+       * Check if authenticated (optional auth)
+       */
+      check: () => baseClient.get("/auth/optional")
+    },
+    // ==================
+    // OAuth
+    // ==================
+    oauth: {
+      /**
+       * Get access token
+       */
+      token: (body) => baseClient.post("/oauth/token", body),
+      /**
+       * Refresh access token
+       */
+      refresh: (body) => baseClient.post("/oauth/refresh", body),
+      /**
+       * Introspect token
+       */
+      introspect: (body) => baseClient.post("/oauth/introspect", body),
+      /**
+       * Revoke token
+       */
+      revoke: (body) => baseClient.post("/oauth/revoke", body)
+    },
+    // ==================
+    // Tenants
+    // ==================
+    tenants: {
+      /**
+       * Create a new tenant
+       */
+      create: (body) => baseClient.post("/v1/tenants", body),
+      /**
+       * List tenants (admin)
+       */
+      list: (query) => baseClient.get("/v1/tenants", { query })
+    },
+    // ==================
+    // Credentials
+    // ==================
+    credentials: {
+      /**
+       * Exchange setup token for credentials
+       */
+      setup: (body) => baseClient.post("/v1/credentials", body),
+      /**
+       * List credentials
+       */
+      list: () => baseClient.get("/v1/credentials"),
+      /**
+       * Revoke credential
+       */
+      revoke: (credentialId) => baseClient.delete(`/v1/credentials/${credentialId}`)
+    },
+    // ==================
+    // Users
+    // ==================
+    users: {
+      /**
+       * Create user
+       */
+      create: (body) => baseClient.post("/v1/users", body),
+      /**
+       * List users
+       */
+      list: (query) => baseClient.get("/v1/users", { query }),
+      /**
+       * Get user by ID
+       */
+      get: (userId) => baseClient.get(`/v1/users/${userId}`),
+      /**
+       * Update user
+       */
+      update: (userId, body) => baseClient.put(`/v1/users/${userId}`, body),
+      /**
+       * Update user status
+       */
+      updateStatus: (userId, body) => baseClient.patch(`/v1/users/${userId}/status`, body),
+      /**
+       * Delete user
+       */
+      delete: (userId) => baseClient.delete(`/v1/users/${userId}`)
+    },
+    // ==================
+    // Panics
+    // ==================
+    panics: {
+      /**
+       * Create panic
+       */
+      create: (body) => baseClient.post("/v1/panics", body),
+      /**
+       * Get panic by ID
+       */
+      get: (panicId, query) => baseClient.get(`/v1/panics/${panicId}`, { query }),
+      /**
+       * List panics
+       */
+      list: (query) => baseClient.get("/v1/panics", { query }),
+      /**
+       * Update panic location
+       */
+      updateLocation: (panicId, body) => baseClient.put(`/v1/panics/${panicId}/location`, body),
+      /**
+       * Cancel panic
+       */
+      cancel: (panicId, body) => baseClient.put(`/v1/panics/${panicId}/cancel`, body),
+      /**
+       * Stream panic updates (SSE)
+       */
+      streamUpdates: (panicId, options2) => {
+        const config = baseClient.getConfig();
+        const url = `${config.baseUrl}/v1/panics/${panicId}/stream`;
+        return streamAdapter.createEventSource(url, {
+          ...options2,
+          headers: {
+            ...options2?.headers,
+            ...config.token ? { Authorization: `Bearer ${config.token}` } : {}
+          }
+        });
+      }
+    },
+    // ==================
+    // Subscriptions
+    // ==================
+    subscriptions: {
+      /**
+       * List subscription types
+       */
+      listTypes: () => baseClient.get("/v1/subscriptions/types"),
+      /**
+       * Create subscription
+       */
+      create: (body) => baseClient.post("/v1/subscriptions", body),
+      /**
+       * List subscriptions
+       */
+      list: (query) => baseClient.get("/v1/subscriptions", { query }),
+      /**
+       * Get subscription stats
+       */
+      stats: () => baseClient.get("/v1/subscriptions/stats")
+    },
+    // ==================
+    // Notifications
+    // ==================
+    notifications: {
+      /**
+       * Create subscriber
+       */
+      createSubscriber: (body) => baseClient.post("/v1/notifications/subscribers", body),
+      /**
+       * Trigger notification
+       */
+      trigger: (body) => baseClient.post("/v1/notifications/trigger", body),
+      /**
+       * Get user preferences
+       */
+      getPreferences: (userId) => baseClient.get(`/v1/notifications/preferences/${userId}`),
+      /**
+       * Update user preferences
+       */
+      updatePreferences: (userId, body) => baseClient.put(`/v1/notifications/preferences/${userId}`, body)
+    },
+    // ==================
+    // Location Safety
+    // ==================
+    locationSafety: {
+      /**
+       * Check location safety
+       */
+      check: (query) => baseClient.get("/v1/location-safety", { query })
+    },
+    // ==================
+    // Crimes
+    // ==================
+    crimes: {
+      /**
+       * List crimes
+       */
+      list: (query) => baseClient.get("/v1/crimes", { query }),
+      /**
+       * Get crime categories
+       */
+      categories: () => baseClient.get("/v1/crime-categories"),
+      /**
+       * Get crime types
+       */
+      types: () => baseClient.get("/v1/crime-types")
+    }
+  };
+}
+
+export { createSaferCityClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map