feat(api): add more implementations

Author: coderbyheart

src/api/bulkOps.ts

@@ -0,0 +1,41 @@
+import { Type, type Static } from '@sinclair/typebox'
+import { ValidationError, validatedFetch } from './validatedFetch.js'
+
+/**
+ * @link https://api.nrfcloud.com/v1/#tag/Bulk-Ops-Requests/operation/FetchBulkOpsRequest
+ */
+export const BulkOpsRequestType = Type.Object({
+	bulkOpsRequestId: Type.String(), // e.g. '01EZZJVDQJPWT7V4FWNVDHNMM5'
+	status: Type.Union([
+		Type.Literal('PENDING'),
+		Type.Literal('IN_PROGRESS'),
+		Type.Literal('FAILED'),
+		Type.Literal('SUCCEEDED'),
+	]),
+})
+
+export const bulkOpsRequests =
+	(
+		{
+			apiKey,
+			endpoint,
+		}: {
+			apiKey: string
+			endpoint: URL
+		},
+		fetchImplementation?: typeof fetch,
+	) =>
+	async (
+		bulkOpsId: string,
+	): Promise<
+		| { error: Error | ValidationError }
+		| { result: Static<typeof BulkOpsRequestType> }
+	> => {
+		const vf = validatedFetch({ endpoint, apiKey }, fetchImplementation)
+		return vf(
+			{
+				resource: `bulk-ops-requests/${encodeURIComponent(bulkOpsId)}`,
+			},
+			BulkOpsRequestType,
+		)
+	}

src/api/groundFix.ts

@@ -0,0 +1,54 @@
+import {
+	accuracy as TAccuracy,
+	lat as TLat,
+	lng as TLng,
+} from '@hello.nrfcloud.com/proto/hello'
+import { Type, type Static } from '@sinclair/typebox'
+import {
+	JSONPayload,
+	ValidationError,
+	validatedFetch,
+} from './validatedFetch.js'
+
+/**
+ * @link https://api.nrfcloud.com/v1/#tag/Ground-Fix
+ */
+export const GroundFixType = Type.Object({
+	lat: TLat, // 63.41999531
+	lon: TLng, // 10.42999506
+	uncertainty: TAccuracy, // 2420
+	fulfilledWith: Type.Literal('SCELL'),
+})
+
+export const groundFix =
+	(
+		{
+			apiKey,
+			endpoint,
+		}: {
+			apiKey: string
+			endpoint: URL
+		},
+		fetchImplementation?: typeof fetch,
+	) =>
+	async (cell: {
+		mcc: string
+		mnc: string
+		eci: number
+		tac: number
+		rsrp: number
+	}): Promise<
+		| { error: Error | ValidationError }
+		| { result: Static<typeof GroundFixType> }
+	> => {
+		const vf = validatedFetch({ endpoint, apiKey }, fetchImplementation)
+		return vf(
+			{
+				resource: 'location/ground-fix',
+				payload: JSONPayload({
+					lte: [cell],
+				}),
+			},
+			GroundFixType,
+		)
+	}

src/api/index.ts

@@ -8,3 +8,6 @@ export * from './deleteAccountDevice.js'
 export * from './getDeviceShadow.js'
 export * from './DeviceShadow.js'
 export * from './updateDeviceShadow.js'
+export * from './serviceToken.js'
+export * from './groundFix.js'
+export * from './bulkOps.js'

src/api/serviceToken.ts

@@ -0,0 +1,32 @@
+import { Type } from '@sinclair/typebox'
+import { validatedFetch } from './validatedFetch.js'
+
+/**
+ * @link https://api.nrfcloud.com/v1/#tag/Account/operation/GetServiceToken
+ */
+export const ServiceToken = Type.Object({
+	token: Type.String(),
+})
+
+export const serviceToken =
+	(
+		fetchImplementation?: typeof fetch,
+		onError?: (error: Error) => void,
+	): ((args: { apiEndpoint: URL; apiKey: string }) => Promise<string>) =>
+	async ({ apiEndpoint, apiKey }) => {
+		const vf = validatedFetch(
+			{ endpoint: apiEndpoint, apiKey },
+			fetchImplementation,
+		)
+		const maybeResult = await vf(
+			{ resource: 'account/service-token' },
+			ServiceToken,
+		)
+
+		if ('error' in maybeResult) {
+			onError?.(maybeResult.error)
+			throw maybeResult.error
+		}
+
+		return maybeResult.result.token
+	}

tsconfig.json

@@ -15,7 +15,10 @@
     "noUncheckedIndexedAccess": true,
     "noUnusedLocals": true,
     "noEmit": true,
-    "verbatimModuleSyntax": true
+    "verbatimModuleSyntax": true,
+    "baseUrl": ".",
+    "rootDir": "."
   },
+  "include": ["src/**/*"],
   "exclude": ["dist/*"]
 }