Trackunit serverless-utils

The @trackunit/serverless-utils package provides utilities for building serverless extensions in the Iris App SDK.

This library is exposed publicly for use in the Trackunit Iris App SDK.

For more info and a full guide on Iris App SDK Development, please visit our Developer Hub.

Installation

yarn add @trackunit/serverless-utils

API

getSecret

Fetches secrets from the SDK Server in production, or from environment variables during local development.

import { getSecret } from "@trackunit/serverless-utils";

// In a Hono route handler
app.get("/data", async (c) => {
  const apiKey = await getSecret({ context: c, secretKey: "API_KEY" });
  // Use apiKey...
});

Local development: Copy .env.example to .env and set the secret with the same name as secretKey (e.g., API_KEY=xxx). Generated serverless extensions include dotenv which loads .env automatically.

Production: Secrets are automatically fetched from the SDK Server using request context headers.

getUserToken

Retrieves the user token from request headers (without "Bearer " prefix):

import { getUserToken } from "@trackunit/serverless-utils";

app.get("/data", async (c) => {
  const token = getUserToken({ context: c });
  if (!token) {
    return c.json({ error: "Unauthorized" }, 401);
  }
  // Use token for authenticated API calls...
});

ACCOUNT_ADMIN_IRIS_APP_TOKEN_HEADER

Header key constant used by the SDK Server to pass admin tokens to serverless functions.

import { ACCOUNT_ADMIN_IRIS_APP_TOKEN_HEADER } from "@trackunit/serverless-utils";
// Value: "tu-account-admin-iris-app-token"

Trackunit

This package was developed by Trackunit ApS. Trackunit is the leading SaaS-based IoT solution for the construction industry, offering an ecosystem of hardware, fleet management software & telematics.