@safercity/sdk 0.0.1

package/README.md

@@ -0,0 +1,161 @@
+# @safercity/sdk
+
+Official SaferCity API client for TypeScript/JavaScript.
+
+## Installation
+
+```bash
+npm install @safercity/sdk
+# or
+bun add @safercity/sdk
+# or
+yarn add @safercity/sdk
+```
+
+## Quick Start
+
+```typescript
+import { createSaferCityClient } from '@safercity/sdk';
+
+const client = createSaferCityClient({
+  baseUrl: 'https://api.safercity.com',
+  token: 'your-jwt-token',
+  tenantId: 'your-tenant-id',
+});
+
+// Health check
+const { data: health } = await client.health.check();
+console.log('API Status:', health.status);
+
+// Get user
+const { data: user } = await client.users.get('user-123');
+console.log('User:', user);
+
+// Create panic
+const { data: panic } = await client.panics.create({
+  userId: 'user-123',
+  latitude: -26.2041,
+  longitude: 28.0473,
+});
+console.log('Panic created:', panic.id);
+```
+
+## Authentication
+
+### JWT Token
+
+```typescript
+const client = createSaferCityClient({
+  baseUrl: 'https://api.safercity.com',
+  token: jwtToken, // Your JWT token
+});
+
+// Update token later
+client.setToken(newToken);
+```
+
+### OAuth Token Flow
+
+```typescript
+const client = createSaferCityClient({
+  baseUrl: 'https://api.safercity.com',
+});
+
+// Get access token
+const { data: tokens } = await client.oauth.token({
+  grant_type: 'client_credentials',
+  tenantId: 'your-tenant-id',
+});
+
+// Set token on client
+client.setToken(tokens.access_token);
+```
+
+## Streaming (SSE)
+
+Stream real-time panic updates:
+
+```typescript
+for await (const event of client.panics.streamUpdates('panic-123')) {
+  console.log('Update:', JSON.parse(event.data));
+}
+```
+
+## API Reference
+
+### Health
+- `client.health.check()` - Check API status
+
+### Authentication
+- `client.auth.whoami()` - Get current auth context
+- `client.oauth.token(body)` - Get access token
+- `client.oauth.refresh(body)` - Refresh token
+- `client.oauth.introspect(body)` - Introspect token
+- `client.oauth.revoke(body)` - Revoke token
+
+### Users
+- `client.users.create(body)` - Create user
+- `client.users.list(query?)` - List users
+- `client.users.get(userId)` - Get user by ID
+- `client.users.update(userId, body)` - Update user
+- `client.users.delete(userId)` - Delete user
+
+### Panics
+- `client.panics.create(body)` - Create panic
+- `client.panics.get(panicId, query?)` - Get panic
+- `client.panics.list(query?)` - List panics
+- `client.panics.updateLocation(panicId, body)` - Update location
+- `client.panics.cancel(panicId, body)` - Cancel panic
+- `client.panics.streamUpdates(panicId)` - Stream updates (SSE)
+
+### Subscriptions
+- `client.subscriptions.listTypes()` - List subscription types
+- `client.subscriptions.create(body)` - Create subscription
+- `client.subscriptions.list(query?)` - List subscriptions
+- `client.subscriptions.stats()` - Get stats
+
+### Location Safety
+- `client.locationSafety.check(query)` - Check location safety
+
+### Crimes
+- `client.crimes.list(query?)` - List crimes
+- `client.crimes.categories()` - Get crime categories
+- `client.crimes.types()` - Get crime types
+
+## Error Handling
+
+```typescript
+import { SaferCityApiError } from '@safercity/sdk';
+
+try {
+  await client.users.get('invalid-id');
+} catch (error) {
+  if (error instanceof SaferCityApiError) {
+    console.log('API Error:', error.error);
+    console.log('Message:', error.message);
+    console.log('Status:', error.status);
+  }
+}
+```
+
+## Custom Fetch
+
+For environments with custom fetch requirements:
+
+```typescript
+import { createSaferCityClient } from '@safercity/sdk';
+
+const client = createSaferCityClient({
+  baseUrl: 'https://api.safercity.com',
+  fetch: customFetchImplementation,
+});
+```
+
+## Related Packages
+
+- `@safercity/sdk-react` - React hooks with TanStack Query
+- `@safercity/sdk-react-native` - React Native support with expo-fetch
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,275 @@
+'use strict';
+
+var sdkCore = require('@safercity/sdk-core');
+
+function createSaferCityClient(options) {
+  const baseClient = new sdkCore.BaseClient(options);
+  const streamAdapter = options.streamAdapter ?? sdkCore.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")
+    }
+  };
+}
+
+Object.defineProperty(exports, "FetchStreamAdapter", {
+  enumerable: true,
+  get: function () { return sdkCore.FetchStreamAdapter; }
+});
+Object.defineProperty(exports, "MemoryTokenStorage", {
+  enumerable: true,
+  get: function () { return sdkCore.MemoryTokenStorage; }
+});
+Object.defineProperty(exports, "SaferCityApiError", {
+  enumerable: true,
+  get: function () { return sdkCore.SaferCityApiError; }
+});
+Object.defineProperty(exports, "WebStreamAdapter", {
+  enumerable: true,
+  get: function () { return sdkCore.WebStreamAdapter; }
+});
+Object.defineProperty(exports, "createAuthHeader", {
+  enumerable: true,
+  get: function () { return sdkCore.createAuthHeader; }
+});
+Object.defineProperty(exports, "createStreamAdapter", {
+  enumerable: true,
+  get: function () { return sdkCore.createStreamAdapter; }
+});
+Object.defineProperty(exports, "getJwtExpiration", {
+  enumerable: true,
+  get: function () { return sdkCore.getJwtExpiration; }
+});
+Object.defineProperty(exports, "isTokenExpired", {
+  enumerable: true,
+  get: function () { return sdkCore.isTokenExpired; }
+});
+Object.defineProperty(exports, "parseJwtPayload", {
+  enumerable: true,
+  get: function () { return sdkCore.parseJwtPayload; }
+});
+exports.createSaferCityClient = createSaferCityClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":["BaseClient","createStreamAdapter","options"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * SaferCity API Client\n * \n * Main client for interacting with the SaferCity multi-tenant API.\n * Provides typed methods for all API endpoints with streaming support.\n */\n\nimport {\n  BaseClient,\n  type SaferCityConfig,\n  type StreamAdapter,\n  createStreamAdapter,\n  type ServerSentEvent,\n  type EventSourceOptions,\n} from '@safercity/sdk-core';\n\nexport interface SaferCityClientOptions extends SaferCityConfig {\n  /**\n   * Custom stream adapter for SSE (auto-detected if not provided)\n   */\n  streamAdapter?: StreamAdapter;\n}\n\n/**\n * Create a SaferCity API client\n */\nexport function createSaferCityClient(options: SaferCityClientOptions) {\n  const baseClient = new BaseClient(options);\n  const streamAdapter = options.streamAdapter ?? createStreamAdapter(options.fetch);\n  \n  return {\n    /**\n     * Access the underlying base client for custom requests\n     */\n    _client: baseClient,\n    \n    /**\n     * Update authentication token\n     */\n    setToken: (token: string | undefined) => baseClient.setToken(token),\n    \n    /**\n     * Update tenant ID\n     */\n    setTenantId: (tenantId: string | undefined) => baseClient.setTenantId(tenantId),\n    \n    /**\n     * Get current configuration\n     */\n    getConfig: () => baseClient.getConfig(),\n\n    // ==================\n    // Health & System\n    // ==================\n    \n    health: {\n      /**\n       * Check API health status\n       */\n      check: () => baseClient.get<{\n        status: string;\n        timestamp: string;\n        panicProviders?: {\n          healthy: boolean;\n          stats?: unknown;\n          providers?: unknown;\n        };\n      }>('/health'),\n    },\n\n    // ==================\n    // Authentication\n    // ==================\n    \n    auth: {\n      /**\n       * Get current authentication context\n       */\n      whoami: () => baseClient.get<{\n        tenantId: string | null;\n        environment: string;\n        scopes: string[];\n        sessionId: string;\n      }>('/auth/whoami'),\n      \n      /**\n       * Check if authenticated (optional auth)\n       */\n      check: () => baseClient.get<{\n        authenticated: boolean;\n        tenantId: string | null;\n      }>('/auth/optional'),\n    },\n\n    // ==================\n    // OAuth\n    // ==================\n    \n    oauth: {\n      /**\n       * Get access token\n       */\n      token: (body: {\n        grant_type: 'client_credentials' | 'refresh_token';\n        tenantId?: string;\n        userId?: string;\n        refresh_token?: string;\n      }) => baseClient.post<{\n        access_token: string;\n        token_type: string;\n        expires_in: number;\n        refresh_token?: string;\n      }>('/oauth/token', body),\n      \n      /**\n       * Refresh access token\n       */\n      refresh: (body: { refresh_token: string }) =>\n        baseClient.post<{\n          access_token: string;\n          token_type: string;\n          expires_in: number;\n          refresh_token?: string;\n        }>('/oauth/refresh', body),\n      \n      /**\n       * Introspect token\n       */\n      introspect: (body: { token: string }) =>\n        baseClient.post<{\n          active: boolean;\n          tenantId?: string;\n          sub?: string;\n          scope?: string;\n          exp?: number;\n        }>('/oauth/introspect', body),\n      \n      /**\n       * Revoke token\n       */\n      revoke: (body: { token: string }) =>\n        baseClient.post<{ success: boolean }>('/oauth/revoke', body),\n    },\n\n    // ==================\n    // Tenants\n    // ==================\n    \n    tenants: {\n      /**\n       * Create a new tenant\n       */\n      create: (body: { name: string; domain?: string }) =>\n        baseClient.post<{\n          tenantId: string;\n          name: string;\n          setupToken: string;\n        }>('/v1/tenants', body),\n      \n      /**\n       * List tenants (admin)\n       */\n      list: (query?: { limit?: number; cursor?: string }) =>\n        baseClient.get<{\n          tenants: Array<{ id: string; name: string }>;\n          hasNext: boolean;\n          cursor?: string;\n        }>('/v1/tenants', { query }),\n    },\n\n    // ==================\n    // Credentials\n    // ==================\n    \n    credentials: {\n      /**\n       * Exchange setup token for credentials\n       */\n      setup: (body: { setupToken: string }) =>\n        baseClient.post<{\n          clientId: string;\n          clientSecret: string;\n          tenantId: string;\n        }>('/v1/credentials', body),\n      \n      /**\n       * List credentials\n       */\n      list: () =>\n        baseClient.get<{\n          credentials: Array<{\n            id: string;\n            clientId: string;\n            createdAt: string;\n            lastUsed?: string;\n          }>;\n        }>('/v1/credentials'),\n      \n      /**\n       * Revoke credential\n       */\n      revoke: (credentialId: string) =>\n        baseClient.delete<{ success: boolean }>(`/v1/credentials/${credentialId}`),\n    },\n\n    // ==================\n    // Users\n    // ==================\n    \n    users: {\n      /**\n       * Create user\n       */\n      create: (body: {\n        email?: string;\n        phone?: string;\n        firstName?: string;\n        lastName?: string;\n        metadata?: Record<string, unknown>;\n      }) => baseClient.post<{ id: string; email?: string; phone?: string }>('/v1/users', body),\n      \n      /**\n       * List users\n       */\n      list: (query?: { limit?: number; cursor?: string; status?: string }) =>\n        baseClient.get<{\n          users: Array<{\n            id: string;\n            email?: string;\n            phone?: string;\n            status: string;\n          }>;\n          hasNext: boolean;\n          cursor?: string;\n        }>('/v1/users', { query }),\n      \n      /**\n       * Get user by ID\n       */\n      get: (userId: string) =>\n        baseClient.get<{\n          id: string;\n          email?: string;\n          phone?: string;\n          firstName?: string;\n          lastName?: string;\n          status: string;\n          metadata?: Record<string, unknown>;\n        }>(`/v1/users/${userId}`),\n      \n      /**\n       * Update user\n       */\n      update: (userId: string, body: {\n        email?: string;\n        phone?: string;\n        firstName?: string;\n        lastName?: string;\n        metadata?: Record<string, unknown>;\n      }) => baseClient.put<{ id: string }>(`/v1/users/${userId}`, body),\n      \n      /**\n       * Update user status\n       */\n      updateStatus: (userId: string, body: { status: string }) =>\n        baseClient.patch<{ id: string; status: string }>(`/v1/users/${userId}/status`, body),\n      \n      /**\n       * Delete user\n       */\n      delete: (userId: string) =>\n        baseClient.delete<{ success: boolean }>(`/v1/users/${userId}`),\n    },\n\n    // ==================\n    // Panics\n    // ==================\n    \n    panics: {\n      /**\n       * Create panic\n       */\n      create: (body: {\n        userId: string;\n        panicTypeId?: string;\n        latitude: number;\n        longitude: number;\n        accuracy?: number;\n        metadata?: Record<string, unknown>;\n      }) => baseClient.post<{\n        id: string;\n        status: string;\n        createdAt: string;\n      }>('/v1/panics', body),\n      \n      /**\n       * Get panic by ID\n       */\n      get: (panicId: string, query?: { userId?: string }) =>\n        baseClient.get<{\n          id: string;\n          userId: string;\n          status: string;\n          latitude: number;\n          longitude: number;\n          createdAt: string;\n          updatedAt?: string;\n        }>(`/v1/panics/${panicId}`, { query }),\n      \n      /**\n       * List panics\n       */\n      list: (query?: {\n        userId?: string;\n        status?: string;\n        limit?: number;\n        cursor?: string;\n      }) => baseClient.get<{\n        panics: Array<{\n          id: string;\n          userId: string;\n          status: string;\n          createdAt: string;\n        }>;\n        hasNext: boolean;\n        cursor?: string;\n      }>('/v1/panics', { query }),\n      \n      /**\n       * Update panic location\n       */\n      updateLocation: (panicId: string, body: {\n        userId: string;\n        latitude: number;\n        longitude: number;\n        accuracy?: number;\n      }) => baseClient.put<{\n        id: string;\n        latitude: number;\n        longitude: number;\n      }>(`/v1/panics/${panicId}/location`, body),\n      \n      /**\n       * Cancel panic\n       */\n      cancel: (panicId: string, body: { userId: string; reason?: string }) =>\n        baseClient.put<{\n          id: string;\n          status: string;\n          cancelledAt: string;\n        }>(`/v1/panics/${panicId}/cancel`, body),\n      \n      /**\n       * Stream panic updates (SSE)\n       */\n      streamUpdates: (\n        panicId: string,\n        options?: EventSourceOptions\n      ): AsyncIterable<ServerSentEvent> => {\n        const config = baseClient.getConfig();\n        const url = `${config.baseUrl}/v1/panics/${panicId}/stream`;\n        \n        return streamAdapter.createEventSource(url, {\n          ...options,\n          headers: {\n            ...options?.headers,\n            ...(config.token ? { Authorization: `Bearer ${config.token}` } : {}),\n          },\n        });\n      },\n    },\n\n    // ==================\n    // Subscriptions\n    // ==================\n    \n    subscriptions: {\n      /**\n       * List subscription types\n       */\n      listTypes: () =>\n        baseClient.get<{\n          types: Array<{\n            id: string;\n            name: string;\n            description?: string;\n            price?: number;\n          }>;\n        }>('/v1/subscriptions/types'),\n      \n      /**\n       * Create subscription\n       */\n      create: (body: {\n        userId: string;\n        subscriptionTypeId: string;\n        status?: string;\n      }) => baseClient.post<{\n        id: string;\n        userId: string;\n        subscriptionTypeId: string;\n        status: string;\n      }>('/v1/subscriptions', body),\n      \n      /**\n       * List subscriptions\n       */\n      list: (query?: {\n        userId?: string;\n        status?: string;\n        limit?: number;\n      }) => baseClient.get<{\n        subscriptions: Array<{\n          id: string;\n          userId: string;\n          subscriptionTypeId: string;\n          status: string;\n        }>;\n      }>('/v1/subscriptions', { query }),\n      \n      /**\n       * Get subscription stats\n       */\n      stats: () =>\n        baseClient.get<{\n          total: number;\n          active: number;\n          byType: Record<string, number>;\n        }>('/v1/subscriptions/stats'),\n    },\n\n    // ==================\n    // Notifications\n    // ==================\n    \n    notifications: {\n      /**\n       * Create subscriber\n       */\n      createSubscriber: (body: {\n        userId: string;\n        email?: string;\n        phone?: string;\n        data?: Record<string, unknown>;\n      }) => baseClient.post<{ subscriberId: string }>('/v1/notifications/subscribers', body),\n      \n      /**\n       * Trigger notification\n       */\n      trigger: (body: {\n        userId: string;\n        workflowId: string;\n        payload?: Record<string, unknown>;\n      }) => baseClient.post<{\n        transactionId: string;\n        status: string;\n      }>('/v1/notifications/trigger', body),\n      \n      /**\n       * Get user preferences\n       */\n      getPreferences: (userId: string) =>\n        baseClient.get<{\n          preferences: Record<string, unknown>;\n        }>(`/v1/notifications/preferences/${userId}`),\n      \n      /**\n       * Update user preferences\n       */\n      updatePreferences: (userId: string, body: {\n        preferences: Record<string, unknown>;\n      }) => baseClient.put<{ success: boolean }>(`/v1/notifications/preferences/${userId}`, body),\n    },\n\n    // ==================\n    // Location Safety\n    // ==================\n    \n    locationSafety: {\n      /**\n       * Check location safety\n       */\n      check: (query: { latitude: number; longitude: number; radius?: number }) =>\n        baseClient.get<{\n          safetyScore: number;\n          riskLevel: string;\n          factors: Array<{ type: string; impact: number }>;\n        }>('/v1/location-safety', { query }),\n    },\n\n    // ==================\n    // Crimes\n    // ==================\n    \n    crimes: {\n      /**\n       * List crimes\n       */\n      list: (query?: {\n        latitude?: number;\n        longitude?: number;\n        radius?: number;\n        type?: string;\n        from?: string;\n        to?: string;\n        limit?: number;\n      }) => baseClient.get<{\n        crimes: Array<{\n          id: string;\n          type: string;\n          latitude: number;\n          longitude: number;\n          occurredAt: string;\n        }>;\n      }>('/v1/crimes', { query }),\n      \n      /**\n       * Get crime categories\n       */\n      categories: () =>\n        baseClient.get<{\n          categories: Array<{ id: string; name: string }>;\n        }>('/v1/crime-categories'),\n      \n      /**\n       * Get crime types\n       */\n      types: () =>\n        baseClient.get<{\n          types: Array<{ id: string; name: string; categoryId: string }>;\n        }>('/v1/crime-types'),\n    },\n  };\n}\n\nexport type SaferCityClient = ReturnType<typeof createSaferCityClient>;\n"]}