Dawarich
@magistr/dawarichv2026.05.25.1
01README
Dawarich self-hosted location-tracking API for swamp — read points, visits, tracks, statistics, digests, geotagged photos, and service health, and update user settings on a Dawarich instance.
Model:
@magistr/dawarich— wraps the Dawarich/api/v1/*API. Methods:health,stats,points,tracked-months,visits,tracks,settings,update-settings,digests, andphotos. Each call persists its result as a swamp data resource for later CEL querying.
Authenticates with an API key from the Dawarich Account settings page; supply it via a vault expression so it is never persisted in cleartext. Date-range filtering and pagination are supported on the points, visits, tracks, and photos methods.
02Release Notes
Merge pull request #5 from umag/extensions/jscad-stl-pair
extensions: add 15 more @magistr extensions + auto-discover CI
03Models
@magistr/dawarichv2026.05.25.1dawarich.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| baseUrl | string | Dawarich instance URL (e.g. https://dawarich.example.com) |
| apiKey | string | API key from Account settings - use vault: ${{ vault.get(vault-name, KEY) }} |
fn health()
Check Dawarich service health
fn stats(year: number, month?: number)
Get monthly statistics
| Argument | Type | Description |
|---|---|---|
| year | number | Year to get stats for |
| month? | number | Month (1-12), omit for yearly |
fn points(startAt?: string, endAt?: string, page?: number, perPage?: number, order?: enum)
Get location points with optional date filtering
| Argument | Type | Description |
|---|---|---|
| startAt? | string | Start date (ISO8601) |
| endAt? | string | End date (ISO8601) |
| page? | number | Page number |
| perPage? | number | Points per page (default 100) |
| order? | enum | Sort order |
fn visits(startAt?: string, endAt?: string, page?: number, perPage?: number)
Get visit records with optional date filtering
| Argument | Type | Description |
|---|---|---|
| startAt? | string | Start date (ISO8601) |
| endAt? | string | End date (ISO8601) |
| page? | number | Page number |
| perPage? | number | Records per page |
fn tracks(startAt?: string, endAt?: string, page?: number)
Get tracks with optional date filtering
| Argument | Type | Description |
|---|---|---|
| startAt? | string | Start date (ISO8601) |
| endAt? | string | End date (ISO8601) |
| page? | number | Page number |
fn settings()
Get user settings
fn digests(year: number, periodType?: enum)
Get yearly or monthly digests
| Argument | Type | Description |
|---|---|---|
| year | number | Digest year |
| periodType? | enum | Period type (default: yearly) |
fn photos(startAt?: string, endAt?: string, page?: number)
Get geotagged photos
| Argument | Type | Description |
|---|---|---|
| startAt? | string | Start date (ISO8601) |
| endAt? | string | End date (ISO8601) |
| page? | number | Page number |
Resources
health(1h)— Service health status
stats(infinite)— Monthly/yearly statistics
points(infinite)— Location points
trackedMonths(infinite)— Months with tracking data
visits(infinite)— Visit records
tracks(infinite)— Track data
settings(infinite)— User settings
digests(infinite)— Yearly/monthly digests
photos(infinite)— Geotagged photos
04Stats
A
100 / 100
Downloads
2
Archive size
6.5 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
Repository
https://github.com/umag/swamp-workspace05Platforms
06Labels