Skip to content

docs: Project ID location, identity tokens as the sign-in path, current docs links - #210

Merged
boehlerlukas merged 2 commits into
masterfrom
docs/project-id-identity-tokens
Nov 7, 2026
Merged

boehlerlukas merged 2 commits into
masterfrom
docs/project-id-identity-tokens

Conversation

@boehlerlukas

Copy link
Copy Markdown
Contributor

What was wrong

  • README pointed to the Project ID as "(Settings > Project)"; it is under Settings → Project → General.
  • README "Customer identity" link (docs.gleap.ai/documentation/guides/customer-identity) is a 404.
  • README framed the legacy user hash as an alternative ("Instead of a token you can still call identify(userId, data, userHash)"), labelled the token section "(recommended)", and never linked the upgrade guide.
  • "SDK documentation" links used old docs.gleap.ai/documentation/... URLs.
  • Identity key path was given as "Settings > Security > Identity keys" (it is Settings → Security → Customer identity → Identity keys).
  • Typings/JSDoc: InitializeOptions.projectId pointed at "Settings > Project, or the install page"; src/Gleap.js initialize said only "formerly SDK key"; identify had no doc in the typings (and "Indentifies the user session" in src); setUserJwt did not say when to call it; clearIdentity did not say "on logout".
  • docs/custom-widget-domains.md used the placeholder YOUR_PROJECT_SDK_KEY.

What changed

  • README.md: Project ID location and Gleap.initialize({ projectId }) form; section renamed "Sign in with an identity token", calls out that no separate identify is needed; identity key path; links to Customer identity and the JS user identity page; legacy section replaced by an "Older integrations" note pointing to Upgrade to identity tokens and noting that identify(userId, data) alone is an unsigned contact; docs links moved to docs.gleap.ai/en/articles/393|394|395-....
  • index.d.ts: JSDoc for InitializeOptions.projectId, initialize, setUserJwt, setUserJwtProvider, clearIdentity, new JSDoc for identify and its userHash parameter (older integrations, upgrade guide).
  • src/Gleap.js / src/GleapSession.js: same wording in JSDoc / comments only.
  • docs/custom-widget-domains.md: YOUR_PROJECT_ID placeholder.

Comments and docs only, no runtime change. npx jest passes (38 suites, 700 tests).

CHANGELOG 19.6.0 is accurate (Project ID rename) and 19.5.2 already lists the provider-restores-after-reload fix, so it is unchanged.

No version bump: the README and package description on npm only update with the next release.

🤖 Generated with Claude Code

boehlerlukas and others added 2 commits November 7, 2026 18:01
…nt docs links

- README: Project ID under Settings → Project → General, { projectId } form,
  identity key path, working Customer identity link (old one 404s), legacy
  user hash reduced to an "Older integrations" note with the upgrade guide,
  docs.gleap.ai/en/articles links instead of /documentation/ URLs.
- index.d.ts / src JSDoc: initialize names where to find the Project ID;
  setUserJwt says when to call it; identify and its userHash describe the
  hash as older integrations; clearIdentity says call on logout.
- docs/custom-widget-domains.md: YOUR_PROJECT_ID placeholder.

Comments and docs only; no runtime change, no version bump.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The dashboard link now points to app.gleap.ai (app.gleap.io redirects there),
and protected conversation files refer to "Protect new files" under
Settings → Security → Conversation files instead of the former
"Require authenticated file access" (Project settings → User identity).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@boehlerlukas
boehlerlukas merged commit 0c0f7b8 into master Nov 7, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant