Repository navigation
Releases
v2.1.0
Minor Changes
-
#23
74a6789- AddNUXT_PUBLIC_LOGIN_NOTICE. When it is set, the sign-in page shows its plain text above the form, for example demo credentials. The default is empty, so the sign-in page does not change. -
#25
f721dfd- AddNUXT_READ_ONLY_EMAILS. A user in this list sees every page that the owner and an operator see: workspace settings, members, the activity log, and system status. The server refuses each change from this user with 403, and the app shows a read-only banner. Many visitors can share one read-only account, so its sign-in skips the limit for each email. The limit for each client stays. "Forgot password" sends no mail to a read-only account. The default is empty, so no user changes.Add
bun run db:seed:demo. It fills an empty workspace with sample members, links, campaigns, clicks, and activity, for a demo install.
v2.0.0
Major Changes
-
- The demo workspaces,
POST /api/auth/demo, andNUXT_DEMO_ENABLED. - The in-app landing page. The documentation site is the public home page.
- Public registration,
/register,POST /api/auth/register, and
NUXT_ALLOW_REGISTRATION. New users join through an invitation. - Turnstile and
NUXT_PUBLIC_TURNSTILE_SITE_KEYandNUXT_TURNSTILE_SECRET_KEY. - The
demosDeletedfield ofPOST /api/jobs/alerts.
- The demo workspaces,
-
- An invite link creates the account for a new teammate. The teammate sets a
password on the invite page.GET /api/workspaces/invitations/preview
returns the workspace name and the invited email.
- An invite link creates the account for a new teammate. The teammate sets a
-
- Multi-workspace mode, workspace subdomains, and the workspace switcher. One
install serves one workspace. Short links on workspace subdomains stop
working. Short links onNUXT_PUBLIC_SHORT_DOMAINkeep working. POST /api/workspaces,DELETE /api/workspaces, and
GET /api/workspaces/slug-available.NUXT_DEPLOYMENT_MODE,NUXT_MULTI_WORKSPACE,NUXT_APP_DOMAIN,
NUXT_SESSION_COOKIE_DOMAIN, andNUXT_RATE_LIMIT_WORKSPACE_PER_DAY, and
NUXT_RATE_LIMIT_SLUG_CHECK_PER_MINUTE. The app ignores them when they are
set.- The
multiWorkspacefield ofGET /api/workspaces. - The
/no-accesspage is new, sono-accessis now a reserved slug. A short link or link prefix namedno-accessstops working. Rename it before the upgrade.
- Multi-workspace mode, workspace subdomains, and the workspace switcher. One
-
- Google and Microsoft sign-in, the
/api/auth/identitiesroutes,
GET /api/auth/providers, the account settings page, and the five
NUXT_OAUTH_*variables. A user who signed in only with a provider uses
"Forgot password" to set a password. - Email verification,
/verify-email, and the/api/auth/verifyroutes. An
invitation proves the email address.
- Google and Microsoft sign-in, the
-
- Vercel and serverless deployment,
vercel.json, andNUXT_SERVERLESS.
Run Masir with Docker or Bun on a server.
- Vercel and serverless deployment,
-
#18
1d4fc97- ### Upgrade notes- Back up the database before the upgrade. The 2.0 migration deletes data,
and Masir has no down migrations. - Masir 2.0 serves one workspace. The migration stops when more than one live
workspace exists. On 1.x, keep one workspace and delete the others. Stay on
1.x if you need several workspaces. - A demo workspace counts as live until 1.x deletes it. Delete demo workspaces before the upgrade.
- The migration permanently deletes soft-deleted workspaces with their links,
Google and Microsoft sign-in records, and email verification tokens. - Stop every instance before the upgrade. 1.x code does not work against the
2.0 schema, so a rolling deploy is not supported for this release. - You can delete the removed environment variables. The app ignores them.
- The
x-vercel-ip-countryfallback is gone. SetNUXT_GEO_COUNTRY_HEADERif your proxy sends the country in another header.
Changed
- The 2.0 migration drops the workspace plan, trial, subscription, demo
expiry, and deletion columns, and the user email verification and avatar
columns.
- Back up the database before the upgrade. The 2.0 migration deletes data,
Patch Changes
-
#21
d46315f-GET /api/admin/statusreports the version frompackage.json. It reported1.0.1for every release before. -
#16
076981b- The documentation site moves tohttps://docs.masir.dev/. The oldhamedniroomand.github.io/masiraddress redirects to it.
All notable changes to Masir are listed here. Changesets writes new sections. The
project uses
Semantic Versioning.
A release that needs an action from you has an Upgrade notes block. Read
the notes for every version between the one you run and the one you install.
v1.1.0
Added
-
Release 2 task study for the four PRD §3 tasks (first link, three-channel
launch, classify 20 links, explain a report), with recruitment criteria,
targets, recording sheet, and results table indocs/product/task-study.md.
Browser fixtures cover three-channel launch and CSV import retry. -
Analytics CSV download for link, campaign, and workspace reports.
GET /api/links/:id/analytics.csv,GET /api/campaigns/:id/analytics.csv, and
GET /api/workspaces/analytics.csvreuse the JSON range filters (periodor
from/to, optionalcompare=previous, plustraffic/attribution).
Each file starts with a definition header (key,label,definition,value)
for metrics and report meta, then abucket,countseries, then breakdown
rows (section,label,count) and workspace/campaign top links
(slug,title,clicks). The value-bearing header is kept instead of a
# metric,definition,range,trafficcomment line so totals sit next to their
definitions; range and traffic stay in meta rows. Report views add a
Download CSV button. Totals match the JSON routes. Notes and link ids are
never included. Formula-like cells stay prefixed by the shared CSV writer. -
Custom analytics ranges, previous-period comparison, and report metadata.
Link, campaign, and workspace analytics acceptfrom/to(YYYY-MM-DD, UTC,
inclusive start, exclusive end, max 366 days) orperiod(not both).
compare=previousreturnspreviousscalars andchangewithpercent: null
when the previous value is 0. Custom-rangemetaincludes timezone, boundaries,
traffic, attribution,earliestEventAt,signals, and a warning whenfrom
is before retained partitions. The three report views add a range picker,
comparison toggle, metadata line, and "No prior data" when percent is null. -
Link trash, restore, and undo.
GET /api/links?trashed=truelists soft-deleted
links.POST /api/links/:id/restoreclearsdeleted_at, invalidates the slug
and aliases, and writeslink_restored. The library adds a Trash view with
restore. Archive, unarchive, and delete show an Undo toast. Purge does not
exist in this version. -
Link responsibility, review date, and archive.
linksgains
responsible_user_id,review_at, andarchived_at. Patch accepts
responsibleUserId,reviewAt, andarchived. List filters add working
archivedandneedsReview. Bulkarchiveis available. Member removal
clears responsibility. Audit events:link_responsible_changed,
link_archived,link_unarchived.GET /api/workspaces/members/options
lists active members for link editors who assign responsibility. -
CSV link import and export.
POST /api/links/import/previewand
POST /api/links/importcreate links from a CSV with preview errors and
idempotent retries.GET /api/links/export.csvdownloads the current library
filters. Template at/templates/links-import.csv. -
Library filters for
campaignId,createdBy(meor a user id), and
archived(defaultfalse) onGET /api/linksandlistLinks. -
POST /api/links/bulkfor tag, untag, and assign-campaign actions on a set
of ids or on a filter (cap 500). Cross-workspace ids answer 404. One audit
eventlinks_bulk_actionis written per request. -
Link library selection, campaign and creator filters, a searchable tag menu
above 15 tags, the My links view, and custom views in localStorage. -
Shared CSV parse and write helpers in
shared/csv.tswith formula-safe cells, pluscsvResponsefor download responses. -
A link-level
utm_mediumoverride. A link value wins over its campaign
medium; clearing it returns to the campaign value. -
POST /api/links/batchcreates up to 20 links from one destination in one
request. Each row carries its ownutmSource,utmMedium,utmContent, and
optionalslug. The create rate limit is charged once per item. An empty
itemslist is refused. On a validation error the whole batch is refused
with 422 androwslisting each failed row. Each created link writes the
samelink_createdaudit event as a single create. Channel presets live in
shared/channel-presets.ts. -
Optional Umami analytics for application page views.
NUXT_PUBLIC_SCRIPTS_UMAMI_ANALYTICS_WEBSITE_IDturns it on with Umami
Cloud.NUXT_PUBLIC_SCRIPTS_UMAMI_ANALYTICS_HOST_URLpoints it at a
self-hosted Umami.NUXT_PUBLIC_SCRIPTS_UMAMI_ANALYTICS_REPLAYS=truealso
loads the Umami recorder for replays and heatmaps. Short-link visitor
responses do not load either script. -
A job runner for maintenance work, with a new
job_runstable. A database
lock makes sure that each job runs one time for each due time, also when
many instances run it at the same time.POST /api/jobs/alertsalso returnsjobs, one
report for each job. -
A
click_event_partitionsjob, fixed at every 24 hours, keeps
click_eventsinserts working on an instance that never restarts. Its job
report includespartitionsReadyThrough. -
A
service_signalstable and operational signal reporting. When a background
event write fails, the redirect reports the error without delay and sets
theevent_writesignal tofailed. A subsequent successful insert resets
the signal took. -
A restricted operator status endpoint
GET /api/admin/statusand page
/settings/statusfor viewing maintenance jobs, service signals, and
partition boundaries.NUXT_OPERATOR_EMAILSconfigures authorized user
emails. -
An attribution snapshot on
click_events(campaign_id,attribution_version,
utm_source,utm_medium,utm_campaign,utm_content) with a partial index
on(campaign_id, created_at). Successful redirects snapshot effective UTM
parameters and campaign ID at click time. -
Attribution mode selection (
currentvsrecorded) on campaign analytics via
GET /api/campaigns/:id/analytics?attribution=.... Recorded mode scopes to
clicks recorded with the campaign at redirect time and groups by snapshot UTM
values. The response reportsmeta: { attribution, legacyCount }. -
Explicit analytics metric definitions in
shared/analytics-metrics.tsand response
metadata (lifetimeClicks,usedVisits,meta: { timezone, period, traffic }).
The link analytics panel presents period clicks, lifetime clicks, daily unique visitor
explanations, remaining visits, loading skeletons, and retryable error states. -
Retained link paths and prefix migration management. When changing a workspace link
prefix withpathMode: 'preserve', the previous prefix is retained inworkspace_link_prefixes,
allowing published URLs and QR codes under the previous path to continue resolving. Retained
paths can be viewed and revoked under workspace settings. -
Configurable link cache TTLs (
NUXT_LINK_CACHE_TTL_SECONDS,
NUXT_LINK_CACHE_MISS_TTL_SECONDS) and shared invalidation across instances
using Redis pub/sub (NUXT_LINK_CACHE_SHARED_INVALIDATION). A failed or
disconnected Redis connection sets thelink_cacheoperational signal to
degraded. -
QR code preview fidelity, client-side PNG rasterization matching SVG styling and logo,
and scanner contrast ratio warnings. -
Release 1 verification test fixtures for published address migration compatibility and
attribution history, along with redirect latency benchmark script (scripts/bench-redirect.ts).
Changed
- Removed the routing preview from link detail and link creation.
- Redirect decision logic is extracted into a pure
decideRedirectfunction in
shared/redirect-decision.ts. The redirect middleware now uses pure decisions
for targeting rules, expiration, schedules, limits, and password gates. - Boot prepares the current month and the next two
click_eventspartitions,
up from the next one. - The internal loop checks every minute for due jobs and runs the first check
30 seconds after boot. When the loop is on,POST /api/jobs/alertsruns
only the jobs that are due. A failed job no longer stops the other jobs. The
route still returns500after a failure. - The app and documentation site now include branded social preview images for
Open Graph and X cards. - The documentation site now has task-based navigation for product users,
operators, API users, and contributors. Every published page and the
VitePress theme were rewritten for the first public release. - The Docker image ships with Sentry compiled in and off.
NUXT_PUBLIC_SENTRY_DSN
turns it on at run time, with no rebuild. WithSENTRY_AUTH_TOKEN,
SENTRY_ORG, andSENTRY_PROJECTthe container also creates the release
and uploads the source maps of its own build to your Sentry when it starts.
The maps travel inside the image and stay out of the directory the server
publishes. Compose no longer takes the Sentry build arguments or the
sentry_auth_tokenbuild secret. - Sentry now starts only with a DSN.
SENTRY_AUTH_TOKEN,SENTRY_ORG,
SENTRY_PROJECT, andSENTRY_URLupload source maps and no longer turn
error reporting on by themselves. NUXT_PUBLIC_SENTRY_RELEASEdefaults to the version of the image.
Fixed
- Campaign detail now opens the shared link creation drawer with its campaign selected.
- Campaign detail and analytics responses now report current link counts. The
campaign list refreshes after link assignments change.
v1.0.1
Fixed
- Compose hands
POSTGRES_PASSWORDto the app asPGPASSWORD, outside the
connection string. A password with%or another URL character no longer
stops the app at boot withURIError. Any character works now, except$,
which.envneeds as$$. - Google Analytics hits go to Google directly. The first-party proxy answered
500on every hit, because Bun'sundicihas noAgent.close().