Skip to main content
← back to extensions

Pointr

@dougschaefer/pointrv2026.10.14.2· 1d agoBEHAVIORS
01README

Pointr Cloud v10 content API toolkit for indoor maps and wayfinding. Authenticates with the license-key client-credentials grant or a Pointr Cloud user (password grant), and records the token's roles and permissions without storing the token. Lists sites, buildings and levels, indexes POIs by scope with external ids and centroids, reads features and published version stamps, and reads webhook configurations and deliveries. Pairs POIs with rooms, desks or other resources from any booking or directory system, as POI external ids or as a link list an application keeps. Feature upserts (PUT only, never the destructive POST replace), external-id assignment and site publishing are dry-run by default.

02Release Notes

Vendor-neutral resource pairing: matchRooms is now matchResources, taking {id, name?, email?} records from any booking or directory system and writing resourceLinks (links, linksJson, proposed external ids). Breaking for 2026.10.14.1 callers. Fixes a mailbox match reported as a name match.

03Behaviors1
@dougschaefer/pointr-contentv2026.10.14.2pointr/content.ts
fn checkAuth()
Exchange the configured credentials for a token and record its grant, roles, permissions and expiry (never the token). Answers whether this credential can edit and publish.
fn listSites()
List sites with their buildings and levels. Writes one `site` resource per site and a `siteIndex`.
fn listPois()
List POIs in a site, building or level scope. Always writes a compact `poiIndex`; writeEach adds one `poi` per feature.
fn getFeature(fid: string)
Read one draft feature by fid.
ArgumentTypeDescription
fidstringFeature identifier (fid)
fn getVersions(siteId?: string)
Read published content version stamps for the client and optionally one site. Compare runs to detect map changes cheaply.
ArgumentTypeDescription
siteId?stringAlso read per-site content versions for this site
fn upsertFeatures()
Add or update draft features in a scope with PUT (never the destructive POST replace). Dry run by default: reports creates vs updates.
fn setExternalIds(assignments: array, dryRun?: boolean)
Set or clear the external id (eid) on draft features by fid, e.g. to the ids of rooms in a booking system. Dry run by default; refuses duplicate eids in one call.
ArgumentTypeDescription
assignmentsarrayfid → eid assignments, e.g. matchResources' proposals; empty is a no-op
dryRun?booleanPlan only: read each feature and report before/after without writing (default true)
fn publishSite(siteId: string, dryRun?: boolean, waitSeconds?: number)
Publish a site's draft content so SDKs and kiosks see it, then poll the status. Dry run by default (reads status only).
ArgumentTypeDescription
siteIdstringSite identifier (sid) to publish
dryRun?booleanReport the site's current publish status without publishing (default true)
waitSeconds?numberPoll the publish status for up to this long
fn listWebhooks(pageSize?: number)
Read content webhook configurations (header values removed) and recent delivery attempts.
ArgumentTypeDescription
pageSize?numberRecent deliveries to read
fn matchResources(pois: array, resources: array, label?: string, overrides?: array)
Pair resources from any system ({id, name?, email?}) with Pointr POIs by override, existing eid, name or mailbox. Writes the fid → resource id links and proposed eid assignments for setExternalIds. Pure computation, no API calls.
ArgumentTypeDescription
poisarrayPOI summaries, normally the `pois` array of a `poiIndex` resource via CEL
resourcesarrayResources to pair ({id, name?, email?}) from any room or booking system, mapped into this shape with CEL
label?stringInstance name for the resourceLinks resource (e.g. the building)
overrides?arrayExplicit resource → POI pairs that win over matching

Resources

authCheck(infinite)— Result of a token exchange: grant used, roles, permissions and expiry from the JWT claims (never the token)
site(infinite)— One site with its buildings and levels (from the outline FeatureCollection)
siteIndex(infinite)— All sites on the client: ids, names, building counts
poi(infinite)— One POI with full GeoJSON geometry and properties
poiIndex(infinite)— Compact POI list for a scope (fid, eid, name, type, building, level, centroid); the input for matchResources
feature(infinite)— One draft feature read by fid
versions(infinite)— Published content version stamps (epoch ints) for the client and optionally one site: cheap change detection
changeSet(infinite)— Planned or applied feature changes: before, after, and whether anything was written
publishStatus(infinite)— Publish status of one site, before and (when not a dry run) after publishing
webhooks(infinite)— Content webhook configurations (header values removed) and recent deliveries
resourceLinks(infinite)— Resource ↔ POI pairing: matches, unmatched and ambiguous resources, the fid → resource id links, and proposed eid assignments
04Previous Versions1
2026.10.14.1

First release: Pointr Cloud v10 content toolkit (sites, POIs, features, versions, webhooks), dry-run-first feature, external-id and publish writes, and Appspace room matching that emits a map card's room-link list.

05Stats
B
80 / 100
Downloads
1
Archive size
25.9 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License1/2partial

    no SPDX license declared

  • Verified public repository0/2missing
Repository
https://github.com/dougschaefer6/swamp-pointr
06Platforms
07Labels
#pointr#wayfinding#indoor-maps#digital-signage#geojson