@tereo-io/react 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +4 -0
  3. package/README.md +167 -2
  4. package/dist/api.d.ts +11 -0
  5. package/dist/api.d.ts.map +1 -0
  6. package/dist/api.js +62 -0
  7. package/dist/api.js.map +1 -0
  8. package/dist/config.d.ts +69 -0
  9. package/dist/config.d.ts.map +1 -0
  10. package/dist/config.js +41 -0
  11. package/dist/config.js.map +1 -0
  12. package/dist/events.d.ts +48 -0
  13. package/dist/events.d.ts.map +1 -0
  14. package/dist/events.js +129 -0
  15. package/dist/events.js.map +1 -0
  16. package/dist/hooks.d.ts +21 -0
  17. package/dist/hooks.d.ts.map +1 -0
  18. package/dist/hooks.js +46 -0
  19. package/dist/hooks.js.map +1 -0
  20. package/dist/index.d.ts +16 -0
  21. package/dist/index.d.ts.map +1 -0
  22. package/dist/index.js +12 -0
  23. package/dist/index.js.map +1 -0
  24. package/dist/logger.d.ts +3 -0
  25. package/dist/logger.d.ts.map +1 -0
  26. package/dist/logger.js +9 -0
  27. package/dist/logger.js.map +1 -0
  28. package/dist/markers.d.ts +7 -0
  29. package/dist/markers.d.ts.map +1 -0
  30. package/dist/markers.js +15 -0
  31. package/dist/markers.js.map +1 -0
  32. package/dist/permissions.d.ts +4 -0
  33. package/dist/permissions.d.ts.map +1 -0
  34. package/dist/permissions.js +64 -0
  35. package/dist/permissions.js.map +1 -0
  36. package/dist/provider.d.ts +30 -0
  37. package/dist/provider.d.ts.map +1 -0
  38. package/dist/provider.js +213 -0
  39. package/dist/provider.js.map +1 -0
  40. package/dist/refresh.d.ts +15 -0
  41. package/dist/refresh.d.ts.map +1 -0
  42. package/dist/refresh.js +98 -0
  43. package/dist/refresh.js.map +1 -0
  44. package/dist/signIn.d.ts +13 -0
  45. package/dist/signIn.d.ts.map +1 -0
  46. package/dist/signIn.js +134 -0
  47. package/dist/signIn.js.map +1 -0
  48. package/dist/signOut.d.ts +8 -0
  49. package/dist/signOut.d.ts.map +1 -0
  50. package/dist/signOut.js +69 -0
  51. package/dist/signOut.js.map +1 -0
  52. package/dist/storage.d.ts +6 -0
  53. package/dist/storage.d.ts.map +1 -0
  54. package/dist/storage.js +73 -0
  55. package/dist/storage.js.map +1 -0
  56. package/dist/storageLock.d.ts +14 -0
  57. package/dist/storageLock.d.ts.map +1 -0
  58. package/dist/storageLock.js +100 -0
  59. package/dist/storageLock.js.map +1 -0
  60. package/dist/tokens.d.ts +13 -0
  61. package/dist/tokens.d.ts.map +1 -0
  62. package/dist/tokens.js +27 -0
  63. package/dist/tokens.js.map +1 -0
  64. package/package.json +66 -4
  65. package/src/api.ts +82 -0
  66. package/src/config.ts +108 -0
  67. package/src/events.ts +184 -0
  68. package/src/hooks.ts +62 -0
  69. package/src/index.ts +34 -0
  70. package/src/logger.ts +9 -0
  71. package/src/markers.ts +26 -0
  72. package/src/permissions.ts +77 -0
  73. package/src/provider.tsx +291 -0
  74. package/src/refresh.ts +120 -0
  75. package/src/signIn.ts +168 -0
  76. package/src/signOut.ts +85 -0
  77. package/src/storage.ts +80 -0
  78. package/src/storageLock.ts +111 -0
  79. package/src/tokens.ts +38 -0
package/dist/events.js ADDED
@@ -0,0 +1,129 @@
1
+ import { isRefreshRejected } from "./refresh.js";
2
+ // Handshake refusals that say nothing about the token (core's
3
+ // websocket/index.ts); any other refusal is about the token.
4
+ const TRANSIENT_REFUSALS = new Set([
5
+ "Too many connections",
6
+ "Server is shutting down",
7
+ ]);
8
+ // Refusals no new token can change: the login client is not admitted to
9
+ // live events, or the token is a client's own.
10
+ const FINAL_REFUSALS = new Set([
11
+ "This token is not issued for core's API",
12
+ "Invalid token subject",
13
+ ]);
14
+ const RETRY_MIN_MS = 1_000;
15
+ const RETRY_MAX_MS = 60_000;
16
+ const defaultSchedule = (fn, ms) => {
17
+ const id = setTimeout(fn, ms);
18
+ return () => clearTimeout(id);
19
+ };
20
+ /**
21
+ * Core's `/ws` events for the signed-in user. Core authenticates a socket
22
+ * once, at the handshake, and closes it when its token expires or is
23
+ * revoked; socket.io does not reconnect after a server-side close or a
24
+ * handshake the server refused, so this does, with a fresh token. Returns a
25
+ * stop function.
26
+ */
27
+ export const startTereoEvents = (deps) => {
28
+ const schedule = deps.schedule ?? defaultSchedule;
29
+ const log = deps.log ?? (() => { });
30
+ let stopped = false;
31
+ let signedOut = false;
32
+ let retryMs = RETRY_MIN_MS;
33
+ // A token refusal is answered with one refresh; a second refusal stops.
34
+ let refreshedForRefusal = false;
35
+ let cancelRetry = null;
36
+ const socket = deps.createSocket((cb) => cb({ token: deps.accessToken() ?? undefined }));
37
+ const signOut = () => {
38
+ if (signedOut)
39
+ return;
40
+ signedOut = true;
41
+ deps.sessionEnded();
42
+ };
43
+ // "transient" when core did not answer the refresh (offline, timeout,
44
+ // 5xx); a refusal clears the token, which signs the user out.
45
+ const refresh = async () => {
46
+ try {
47
+ await deps.refresh();
48
+ return "ok";
49
+ }
50
+ catch (error) {
51
+ log("Token refresh for the events socket failed", error);
52
+ return isRefreshRejected(error) ? "rejected" : "transient";
53
+ }
54
+ };
55
+ const connectFresh = async () => {
56
+ if (stopped || !deps.accessToken())
57
+ return;
58
+ if (!deps.tokenIsFresh()) {
59
+ const outcome = await refresh();
60
+ if (outcome === "transient")
61
+ retryLater();
62
+ if (outcome !== "ok")
63
+ return;
64
+ }
65
+ if (!stopped && deps.accessToken())
66
+ socket.connect();
67
+ };
68
+ const retryLater = () => {
69
+ if (stopped || cancelRetry)
70
+ return;
71
+ const delay = retryMs;
72
+ retryMs = Math.min(retryMs * 2, RETRY_MAX_MS);
73
+ cancelRetry = schedule(() => {
74
+ cancelRetry = null;
75
+ void connectFresh();
76
+ }, delay);
77
+ };
78
+ socket.on("connect", () => {
79
+ retryMs = RETRY_MIN_MS;
80
+ refreshedForRefusal = false;
81
+ });
82
+ socket.on("disconnect", (reason) => {
83
+ log("Events socket closed", reason);
84
+ if (reason === "io server disconnect")
85
+ void connectFresh();
86
+ });
87
+ socket.on("connect_error", (error) => {
88
+ log("Events socket refused", error.message);
89
+ // Still active: socket.io retries by itself (a network error).
90
+ if (socket.active || stopped)
91
+ return;
92
+ if (TRANSIENT_REFUSALS.has(error.message)) {
93
+ retryLater();
94
+ return;
95
+ }
96
+ if (FINAL_REFUSALS.has(error.message) || refreshedForRefusal) {
97
+ deps.refused?.(error.message);
98
+ return;
99
+ }
100
+ refreshedForRefusal = true;
101
+ void refresh().then((outcome) => {
102
+ if (outcome === "transient") {
103
+ // No new token yet: the next refusal still earns a refresh.
104
+ refreshedForRefusal = false;
105
+ retryLater();
106
+ }
107
+ else if (outcome === "ok" && !stopped && deps.accessToken()) {
108
+ socket.connect();
109
+ }
110
+ });
111
+ });
112
+ socket.on("auth:permissions:changed", (payload) => deps.onEvent({ type: "permissions", payload }));
113
+ socket.on("auth:organization:changed", (payload) => deps.onEvent({ type: "organization", payload }));
114
+ socket.on("auth:session:revoked", (payload) => {
115
+ deps.onEvent({ type: "session-revoked", payload });
116
+ // Sent for each of the user's revoked sessions; only ours signs out.
117
+ if (payload?.sessionId && payload.sessionId === deps.sessionId()) {
118
+ signOut();
119
+ }
120
+ });
121
+ void connectFresh();
122
+ return () => {
123
+ stopped = true;
124
+ cancelRetry?.();
125
+ cancelRetry = null;
126
+ socket.disconnect();
127
+ };
128
+ };
129
+ //# sourceMappingURL=events.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import { type AuthState } from "./provider.js";
2
+ import type { TereoUser } from "./config.js";
3
+ import type { AxiosInstance } from "axios";
4
+ export declare const useAuth: <U extends TereoUser = TereoUser>() => AuthState<U>;
5
+ /** The named API's client, sending the user's access token. */
6
+ export declare const useApi: (name: string) => AxiosInstance;
7
+ /** The named API's client with no token, for cookies or open endpoints. */
8
+ export declare const usePublicApi: (name: string) => AxiosInstance;
9
+ /**
10
+ * Finishes sign-in on the callback route. The exchange runs once per mount,
11
+ * however often `complete` is called (React StrictMode runs effects twice,
12
+ * and the PKCE verifier is single-use).
13
+ */
14
+ export declare const useCompleteSignIn: () => {
15
+ complete: (search: URLSearchParams) => Promise<{
16
+ returnTo: string | null;
17
+ }>;
18
+ error: Error | null;
19
+ isPending: boolean;
20
+ };
21
+ //# sourceMappingURL=hooks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAA2B,MAAM,eAAe,CAAC;AAGxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,SAAS,GAAG,SAAS,OAAK,SAAS,CAAC,CAAC,CAItE,CAAC;AAeF,+DAA+D;AAC/D,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,aACD,CAAC;AAEtC,2EAA2E;AAC3E,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,aACH,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAO;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC5E,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CAoBpB,CAAC"}
package/dist/hooks.js ADDED
@@ -0,0 +1,46 @@
1
+ import { ApiContext, AuthContext } from "./provider.js";
2
+ import { useCallback, useContext, useRef, useState } from "react";
3
+ import { completeSignIn } from "./signIn.js";
4
+ export const useAuth = () => {
5
+ const state = useContext(AuthContext);
6
+ if (!state)
7
+ throw new Error("useAuth must be used within TereoAuthProvider");
8
+ return state;
9
+ };
10
+ const useClient = (name, kind, hook) => {
11
+ const clients = useContext(ApiContext);
12
+ if (!clients)
13
+ throw new Error(`${hook} must be used within TereoAuthProvider`);
14
+ const client = clients[kind][name];
15
+ if (!client)
16
+ throw new Error(`No API named "${name}" in the Tereo config`);
17
+ return client;
18
+ };
19
+ /** The named API's client, sending the user's access token. */
20
+ export const useApi = (name) => useClient(name, "authed", "useApi");
21
+ /** The named API's client with no token, for cookies or open endpoints. */
22
+ export const usePublicApi = (name) => useClient(name, "open", "usePublicApi");
23
+ /**
24
+ * Finishes sign-in on the callback route. The exchange runs once per mount,
25
+ * however often `complete` is called (React StrictMode runs effects twice,
26
+ * and the PKCE verifier is single-use).
27
+ */
28
+ export const useCompleteSignIn = () => {
29
+ const started = useRef(null);
30
+ const [error, setError] = useState(null);
31
+ const [isPending, setIsPending] = useState(false);
32
+ const complete = useCallback((search) => {
33
+ if (!started.current) {
34
+ setIsPending(true);
35
+ started.current = completeSignIn(search)
36
+ .catch((e) => {
37
+ setError(e instanceof Error ? e : new Error(String(e)));
38
+ throw e;
39
+ })
40
+ .finally(() => setIsPending(false));
41
+ }
42
+ return started.current;
43
+ }, []);
44
+ return { complete, error, isPending };
45
+ };
46
+ //# sourceMappingURL=hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,CAAC,MAAM,OAAO,GAAG,GAAkD,EAAE;IACzE,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC7E,OAAO,KAAgC,CAAC;AAC1C,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAChB,IAAY,EACZ,IAAuB,EACvB,IAAY,EACG,EAAE;IACjB,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO;QACV,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,wCAAwC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,uBAAuB,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAiB,EAAE,CACpD,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAEtC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAiB,EAAE,CAC1D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAI/B,EAAE;IACF,MAAM,OAAO,GAAG,MAAM,CAA8C,IAAI,CAAC,CAAC;IAC1E,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,MAAuB,EAAE,EAAE;QACvD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC;iBACrC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;gBACpB,QAAQ,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxD,MAAM,CAAC,CAAC;YACV,CAAC,CAAC;iBACD,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACxC,CAAC,CAAC"}
@@ -0,0 +1,16 @@
1
+ export { resolveConfig, setActiveConfig, activeConfig } from "./config.js";
2
+ export type { ResolvedConfig, StorageKeys, TereoAuthConfig, TereoEvent, TereoUser, } from "./config.js";
3
+ export { hasPermission } from "./permissions.js";
4
+ export type { PermissionRequirement } from "./permissions.js";
5
+ export { readJson, writeJson, removeKey, subscribeKey, useStoredValue, } from "./storage.js";
6
+ export { decodeJwt, readTokens, writeTokens } from "./tokens.js";
7
+ export type { StoredTokens } from "./tokens.js";
8
+ export { clearLoggedOut, clearSignedIn, hasSession, isLoggedOut, markLoggedOut, markSignedIn, } from "./markers.js";
9
+ export { completeSignIn, signIn } from "./signIn.js";
10
+ export { isRefreshRejected, refreshTokens } from "./refresh.js";
11
+ export { endLocalSession, signOut } from "./signOut.js";
12
+ export { createApiClients } from "./api.js";
13
+ export { TereoAuthProvider } from "./provider.js";
14
+ export type { ApiClients, AuthState } from "./provider.js";
15
+ export { useApi, useAuth, useCompleteSignIn, usePublicApi } from "./hooks.js";
16
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,UAAU,EACV,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EACL,QAAQ,EACR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,cAAc,EACd,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,12 @@
1
+ export { resolveConfig, setActiveConfig, activeConfig } from "./config.js";
2
+ export { hasPermission } from "./permissions.js";
3
+ export { readJson, writeJson, removeKey, subscribeKey, useStoredValue, } from "./storage.js";
4
+ export { decodeJwt, readTokens, writeTokens } from "./tokens.js";
5
+ export { clearLoggedOut, clearSignedIn, hasSession, isLoggedOut, markLoggedOut, markSignedIn, } from "./markers.js";
6
+ export { completeSignIn, signIn } from "./signIn.js";
7
+ export { isRefreshRejected, refreshTokens } from "./refresh.js";
8
+ export { endLocalSession, signOut } from "./signOut.js";
9
+ export { createApiClients } from "./api.js";
10
+ export { TereoAuthProvider } from "./provider.js";
11
+ export { useApi, useAuth, useCompleteSignIn, usePublicApi } from "./hooks.js";
12
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,QAAQ,EACR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EACL,cAAc,EACd,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,3 @@
1
+ export declare const debugLog: (...args: unknown[]) => void;
2
+ export declare const errorLog: (...args: unknown[]) => void;
3
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,OAAO,EAAE,KAAG,IAE7C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,OAAO,EAAE,KAAG,IAE7C,CAAC"}
package/dist/logger.js ADDED
@@ -0,0 +1,9 @@
1
+ import { activeConfig } from "./config.js";
2
+ export const debugLog = (...args) => {
3
+ if (activeConfig().debug)
4
+ console.log("[tereo]", ...args);
5
+ };
6
+ export const errorLog = (...args) => {
7
+ console.error("[tereo]", ...args);
8
+ };
9
+ //# sourceMappingURL=logger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAe,EAAQ,EAAE;IACnD,IAAI,YAAY,EAAE,CAAC,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;AAC5D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAe,EAAQ,EAAE;IACnD,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC"}
@@ -0,0 +1,7 @@
1
+ export declare const markSignedIn: () => void;
2
+ export declare const clearSignedIn: () => void;
3
+ export declare const markLoggedOut: () => void;
4
+ export declare const clearLoggedOut: () => void;
5
+ export declare const isLoggedOut: () => boolean;
6
+ export declare const hasSession: () => boolean;
7
+ //# sourceMappingURL=markers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../src/markers.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,QAAO,IACc,CAAC;AAE/C,eAAO,MAAM,aAAa,QAAO,IACQ,CAAC;AAM1C,eAAO,MAAM,aAAa,QAAO,IACc,CAAC;AAEhD,eAAO,MAAM,cAAc,QAAO,IACQ,CAAC;AAE3C,eAAO,MAAM,WAAW,QAAO,OACmB,CAAC;AAEnD,eAAO,MAAM,UAAU,QAAO,OAE8C,CAAC"}
@@ -0,0 +1,15 @@
1
+ import { readJson, removeKey, writeJson } from "./storage.js";
2
+ import { activeConfig } from "./config.js";
3
+ import { readTokens } from "./tokens.js";
4
+ export const markSignedIn = () => writeJson(activeConfig().keys.signedIn, "1");
5
+ export const clearSignedIn = () => removeKey(activeConfig().keys.signedIn);
6
+ // Set by an explicit sign-out and cleared only by the next interactive login
7
+ // (the code exchange). While it is set no session is assumed: if the revoke
8
+ // call failed, the refresh cookie may still be valid, and a silent refresh
9
+ // would sign the user straight back in.
10
+ export const markLoggedOut = () => writeJson(activeConfig().keys.loggedOut, "1");
11
+ export const clearLoggedOut = () => removeKey(activeConfig().keys.loggedOut);
12
+ export const isLoggedOut = () => readJson(activeConfig().keys.loggedOut) !== null;
13
+ export const hasSession = () => !isLoggedOut() &&
14
+ (readJson(activeConfig().keys.signedIn) !== null || readTokens() !== null);
15
+ //# sourceMappingURL=markers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"markers.js","sourceRoot":"","sources":["../src/markers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG,GAAS,EAAE,CACrC,SAAS,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAS,EAAE,CACtC,SAAS,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAE1C,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAS,EAAE,CACtC,SAAS,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAEhD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAS,EAAE,CACvC,SAAS,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,WAAW,GAAG,GAAY,EAAE,CACvC,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAEnD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAY,EAAE,CACtC,CAAC,WAAW,EAAE;IACd,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,UAAU,EAAE,KAAK,IAAI,CAAC,CAAC"}
@@ -0,0 +1,4 @@
1
+ /** One permission, or a list of which any one suffices. */
2
+ export type PermissionRequirement = string | readonly string[];
3
+ export declare const hasPermission: (held: string[], required: PermissionRequirement) => boolean;
4
+ //# sourceMappingURL=permissions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAgB/D,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,EAAE,EACd,UAAU,qBAAqB,KAC9B,OAGmE,CAAC"}
@@ -0,0 +1,64 @@
1
+ const ADMIN_LEVEL = 5;
2
+ const holdsPermission = (held, required) => {
3
+ if (held.includes("admin"))
4
+ return true;
5
+ if (held.includes(required))
6
+ return true;
7
+ for (const userPerm of held) {
8
+ if (isAdminCovering(userPerm, required))
9
+ return true;
10
+ if (hasPermissionLevel(userPerm, required))
11
+ return true;
12
+ }
13
+ return false;
14
+ };
15
+ export const hasPermission = (held, required) => typeof required === "string"
16
+ ? holdsPermission(held, required)
17
+ : required.some((permission) => holdsPermission(held, permission));
18
+ const isAdminCovering = (userPermission, requiredPermission) => {
19
+ const userLevel = getPermissionLevel(userPermission);
20
+ if (userLevel !== ADMIN_LEVEL)
21
+ return false;
22
+ const userBase = getPermissionBase(userPermission);
23
+ const requiredBase = getPermissionBase(requiredPermission);
24
+ if (!userBase)
25
+ return false;
26
+ return requiredBase === userBase || requiredBase.startsWith(userBase + ".");
27
+ };
28
+ const getPermissionLevel = (permission) => {
29
+ const suffix = permission.split(".").pop();
30
+ switch (suffix) {
31
+ case "read":
32
+ return 1;
33
+ case "write":
34
+ return 2;
35
+ case "archive":
36
+ return 3;
37
+ case "delete":
38
+ return 4;
39
+ case "admin":
40
+ return ADMIN_LEVEL;
41
+ default:
42
+ return 0;
43
+ }
44
+ };
45
+ const hasPermissionLevel = (userPermission, requiredPermission) => {
46
+ const userBase = getPermissionBase(userPermission);
47
+ const requiredBase = getPermissionBase(requiredPermission);
48
+ if (userBase !== requiredBase)
49
+ return false;
50
+ const userLevel = getPermissionLevel(userPermission);
51
+ const requiredLevel = getPermissionLevel(requiredPermission);
52
+ // Off-ladder permissions (`webhooks.emit`, `services.approve`) are implied by
53
+ // nothing but themselves or an admin covering them.
54
+ if (requiredLevel === 0)
55
+ return false;
56
+ return userLevel >= requiredLevel;
57
+ };
58
+ const getPermissionBase = (permission) => {
59
+ const parts = permission.split(".");
60
+ if (parts.length <= 1)
61
+ return "";
62
+ return parts.slice(0, -1).join(".");
63
+ };
64
+ //# sourceMappingURL=permissions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"permissions.js","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ import { type PermissionRequirement } from "./permissions.js";
2
+ import { type AxiosInstance } from "axios";
3
+ import { signOut } from "./signOut.js";
4
+ import { signIn } from "./signIn.js";
5
+ import { type TereoAuthConfig, type TereoUser } from "./config.js";
6
+ import { type ReactNode } from "react";
7
+ export interface AuthState<U extends TereoUser = TereoUser> {
8
+ user: U | null;
9
+ isLoading: boolean;
10
+ isSignedIn: boolean;
11
+ /** Whether core's live-update socket is connected. */
12
+ isLive: boolean;
13
+ hasPermission: (required: PermissionRequirement) => boolean;
14
+ signIn: typeof signIn;
15
+ signOut: typeof signOut;
16
+ switchOrganization: (orgId: string) => Promise<void>;
17
+ reloadUser: () => Promise<void>;
18
+ }
19
+ export interface ApiClients {
20
+ authed: Record<string, AxiosInstance>;
21
+ open: Record<string, AxiosInstance>;
22
+ }
23
+ export declare const AuthContext: import("react").Context<AuthState<TereoUser> | null>;
24
+ export declare const ApiContext: import("react").Context<ApiClients | null>;
25
+ /** Needs a `QueryClientProvider` above it. */
26
+ export declare const TereoAuthProvider: ({ config, children, }: {
27
+ config: TereoAuthConfig;
28
+ children: ReactNode;
29
+ }) => import("react").JSX.Element;
30
+ //# sourceMappingURL=provider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAiB,MAAM,kBAAkB,CAAC;AAI7E,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,OAAO,CAAC;AACzD,OAAO,EAAmB,OAAO,EAAE,MAAM,cAAc,CAAC;AAOxD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,SAAS,EAIf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AAEf,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IACxD,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,OAAO,CAAC;IAC5D,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACrC;AAED,eAAO,MAAM,WAAW,sDAAwC,CAAC;AACjE,eAAO,MAAM,UAAU,4CAAyC,CAAC;AA8BjE,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,GAAI,uBAG/B;IACD,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,SAAS,CAAC;CACrB,gCA0MA,CAAC"}
@@ -0,0 +1,213 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { hasPermission } from "./permissions.js";
3
+ import { decodeJwt, readTokens } from "./tokens.js";
4
+ import { useQuery, useQueryClient } from "@tanstack/react-query";
5
+ import { startTereoEvents } from "./events.js";
6
+ import { isAxiosError } from "axios";
7
+ import { endLocalSession, signOut } from "./signOut.js";
8
+ import { useStoredValue } from "./storage.js";
9
+ import { refreshTokens } from "./refresh.js";
10
+ import { createApiClients } from "./api.js";
11
+ import { hasSession } from "./markers.js";
12
+ import { debugLog } from "./logger.js";
13
+ import { io } from "socket.io-client";
14
+ import { signIn } from "./signIn.js";
15
+ import { pathWithoutBase, resolveConfig, setActiveConfig, } from "./config.js";
16
+ import { createContext, useCallback, useEffect, useMemo, useRef, useState, } from "react";
17
+ export const AuthContext = createContext(null);
18
+ export const ApiContext = createContext(null);
19
+ // Every user cached for this client; one identity's entry is that prefix
20
+ // plus its subject and organization.
21
+ const usersKey = (clientId) => ["tereo", "user", clientId];
22
+ const claimOf = (token, claim) => {
23
+ const value = token ? decodeJwt(token)?.[claim] : null;
24
+ return typeof value === "string" ? value : null;
25
+ };
26
+ // A user lookup core refused for the token is not retried; other failures
27
+ // (network, 5xx) are, twice, with backoff.
28
+ const retryUserLookup = (failureCount, error) => {
29
+ const status = isAxiosError(error) ? error.response?.status : undefined;
30
+ if (status === 401 || status === 403)
31
+ return false;
32
+ return failureCount < 2;
33
+ };
34
+ const userLookupDelay = (attempt) => Math.min(1000 * 2 ** attempt, 30_000);
35
+ // Events that arrive together reload the user once.
36
+ const RELOAD_DEBOUNCE_MS = 250;
37
+ const currentRoutePath = (config) => pathWithoutBase(window.location.pathname, config.basePath).replace(/(.)\/+$/, "$1") || "/";
38
+ /** Needs a `QueryClientProvider` above it. */
39
+ export const TereoAuthProvider = ({ config, children, }) => {
40
+ // Set during the first render, so hooks and plain functions such as
41
+ // `signIn` work from the start. The config is read once.
42
+ const [resolved] = useState(() => {
43
+ const r = resolveConfig(config);
44
+ setActiveConfig(r);
45
+ return r;
46
+ });
47
+ const { clientId, keys, apis, loadUser } = resolved;
48
+ const queryClient = useQueryClient();
49
+ const clients = useMemo(() => createApiClients(apis), [apis]);
50
+ const tokens = useStoredValue(keys.tokens);
51
+ const accessToken = tokens?.access_token;
52
+ // Keyed on whose token it is, so a sign-in as someone else or into
53
+ // another organization (here or in another tab) never reads the previous
54
+ // identity's user.
55
+ const userId = useMemo(() => claimOf(accessToken, "sub"), [accessToken]);
56
+ const orgId = useMemo(() => claimOf(accessToken, "org_id"), [accessToken]);
57
+ const queryKey = useMemo(() => [...usersKey(clientId), userId, orgId], [clientId, userId, orgId]);
58
+ // A page load with a session but no token (the access token lives in
59
+ // storage the tab may not have): renew it before deciding anything.
60
+ const [restoring, setRestoring] = useState(() => !tokens && hasSession());
61
+ useEffect(() => {
62
+ if (tokens || !hasSession()) {
63
+ setRestoring(false);
64
+ return;
65
+ }
66
+ // refreshTokens clears what core rejected; other failures leave the
67
+ // next request to retry.
68
+ void refreshTokens()
69
+ .catch(() => { })
70
+ .finally(() => setRestoring(false));
71
+ }, [tokens]);
72
+ const query = useQuery({
73
+ queryKey,
74
+ queryFn: () => loadUser(clients.authed),
75
+ enabled: tokens !== null,
76
+ retry: retryUserLookup,
77
+ retryDelay: userLookupDelay,
78
+ });
79
+ useEffect(() => {
80
+ // Signed out here or in another tab: drop the cached user rather than
81
+ // render it until the redirect lands.
82
+ if (!tokens)
83
+ queryClient.removeQueries({ queryKey: usersKey(clientId) });
84
+ }, [tokens, queryClient, clientId]);
85
+ useEffect(() => {
86
+ if (tokens || restoring || hasSession())
87
+ return;
88
+ if (resolved.isPublicPath(currentRoutePath(resolved)))
89
+ return;
90
+ window.location.href = `${resolved.basePath}${resolved.signedOutPath}`;
91
+ }, [tokens, restoring, resolved]);
92
+ const user = tokens ? (query.data ?? null) : null;
93
+ const check = useCallback((required) => hasPermission(user?.permissions ?? [], required), [user]);
94
+ const switchOrganization = useCallback((orgId) => signIn({ params: { org_id: orgId } }), []);
95
+ const reloadUser = useCallback(() => queryClient.invalidateQueries({ queryKey }), [queryClient, queryKey]);
96
+ const reloadTimer = useRef(null);
97
+ // A new token (exchange, refresh, another tab) may carry other
98
+ // permissions. A new identity changes the key, which loads on its own;
99
+ // the same one is reloaded now, which also covers any pending event
100
+ // reload.
101
+ const lastToken = useRef(accessToken);
102
+ const lastKey = useRef(queryKey);
103
+ useEffect(() => {
104
+ const previousToken = lastToken.current;
105
+ const previousKey = lastKey.current;
106
+ lastToken.current = accessToken;
107
+ lastKey.current = queryKey;
108
+ if (!previousToken || !accessToken || previousToken === accessToken)
109
+ return;
110
+ if (reloadTimer.current)
111
+ clearTimeout(reloadTimer.current);
112
+ reloadTimer.current = null;
113
+ if (previousKey === queryKey)
114
+ void queryClient.invalidateQueries({ queryKey });
115
+ }, [accessToken, queryKey, queryClient]);
116
+ const [isLive, setIsLive] = useState(false);
117
+ // `config` is resolved once, but a callback written inline should see
118
+ // the state of the latest render.
119
+ const onEventRef = useRef(config.onEvent);
120
+ useEffect(() => {
121
+ onEventRef.current = config.onEvent;
122
+ }, [config.onEvent]);
123
+ // The events loop is keyed on the user, not the token: the token (and
124
+ // its sid) rotates on every refresh, and the loop reads the current one
125
+ // at each handshake.
126
+ useEffect(() => {
127
+ if (!resolved.live || !userId)
128
+ return;
129
+ const handleEvent = (event) => {
130
+ onEventRef.current?.(event);
131
+ if (event.type === "session-revoked")
132
+ return;
133
+ if (reloadTimer.current)
134
+ clearTimeout(reloadTimer.current);
135
+ reloadTimer.current = setTimeout(() => {
136
+ reloadTimer.current = null;
137
+ void reloadUser();
138
+ }, RELOAD_DEBOUNCE_MS);
139
+ };
140
+ // Deferred to a microtask so StrictMode's mount, unmount, mount cancels
141
+ // before a handshake starts.
142
+ let stop = null;
143
+ let cancelled = false;
144
+ void Promise.resolve().then(() => {
145
+ if (cancelled)
146
+ return;
147
+ stop = startTereoEvents({
148
+ // socket.io treats a URL's path as a namespace; core serves the
149
+ // socket at `wsPath`, so only the origin goes in the URL.
150
+ createSocket: (auth) => {
151
+ const socket = io(new URL(resolved.coreUrl).origin, {
152
+ path: resolved.wsPath,
153
+ transports: ["websocket", "polling"],
154
+ autoConnect: false,
155
+ auth,
156
+ });
157
+ socket.on("connect", () => setIsLive(true));
158
+ socket.on("disconnect", () => setIsLive(false));
159
+ socket.on("connect_error", () => setIsLive(false));
160
+ return socket;
161
+ },
162
+ accessToken: () => readTokens()?.access_token ?? null,
163
+ tokenIsFresh: () => {
164
+ const stored = readTokens();
165
+ return (!!stored &&
166
+ Date.now() < stored.expiresAt - resolved.tokenExpirationBuffer);
167
+ },
168
+ sessionId: () => {
169
+ const token = readTokens()?.access_token;
170
+ const sid = token ? decodeJwt(token)?.sid : null;
171
+ return typeof sid === "string" ? sid : null;
172
+ },
173
+ refresh: refreshTokens,
174
+ // Core already ended the session: a revoke would fail, and an
175
+ // end-session without a usable hint asks the user to confirm.
176
+ sessionEnded: endLocalSession,
177
+ onEvent: handleEvent,
178
+ refused: (reason) => debugLog("Events socket stopped:", reason),
179
+ log: (message, detail) => debugLog(message, detail),
180
+ });
181
+ });
182
+ return () => {
183
+ cancelled = true;
184
+ if (reloadTimer.current)
185
+ clearTimeout(reloadTimer.current);
186
+ reloadTimer.current = null;
187
+ stop?.();
188
+ setIsLive(false);
189
+ };
190
+ }, [userId, resolved, reloadUser]);
191
+ const value = useMemo(() => ({
192
+ user,
193
+ isLoading: restoring || query.isLoading || query.isFetching,
194
+ isSignedIn: user !== null,
195
+ isLive,
196
+ hasPermission: check,
197
+ signIn,
198
+ signOut,
199
+ switchOrganization,
200
+ reloadUser,
201
+ }), [
202
+ user,
203
+ restoring,
204
+ query.isLoading,
205
+ query.isFetching,
206
+ isLive,
207
+ check,
208
+ switchOrganization,
209
+ reloadUser,
210
+ ]);
211
+ return (_jsx(ApiContext.Provider, { value: clients, children: _jsx(AuthContext.Provider, { value: value, children: children }) }));
212
+ };
213
+ //# sourceMappingURL=provider.js.map