@teqconnect/express 0.0.0-stage → 0.1.0

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.
@@ -0,0 +1,10 @@
1
+ import type { AppAuthOptions } from "./options";
2
+ export interface LogoutClaims {
3
+ sub: string;
4
+ sid: string;
5
+ }
6
+ /** JWKS verify; require events backchannel-logout, sub, and sid. */
7
+ export declare function verifyLogoutToken(opts: AppAuthOptions, logoutToken: string): Promise<LogoutClaims>;
8
+ export type SessionStore = (claims: LogoutClaims) => void | Promise<void>;
9
+ /** Clear any sealed session matching sub/sid. The adapter supplies the store. */
10
+ export declare function applyLogout(_opts: AppAuthOptions, claims: LogoutClaims, clear: SessionStore): Promise<void>;
package/dist/index.cjs ADDED
@@ -0,0 +1,445 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key3 of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key3) && key3 !== except)
14
+ __defProp(to, key3, { get: () => from[key3], enumerable: !(desc = __getOwnPropDesc(from, key3)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/index.ts
21
+ var src_exports = {};
22
+ __export(src_exports, {
23
+ AppSessionCredentials: () => AppSessionCredentials,
24
+ COOKIE: () => COOKIE,
25
+ WebhookVerificationError: () => import_sdk5.WebhookVerificationError,
26
+ appScope: () => appScope,
27
+ beginLogin: () => beginLogin,
28
+ expressRawBody: () => expressRawBody,
29
+ finishLogin: () => finishLogin,
30
+ forUser: () => forUser,
31
+ openCookie: () => openCookie,
32
+ replaceTokens: () => replaceTokens,
33
+ resolveAppOptions: () => resolveAppOptions,
34
+ teqAuth: () => teqAuth,
35
+ verifyExpressWebhook: () => verifyExpressWebhook,
36
+ verifyIdToken: () => verifyIdToken,
37
+ verifyLogoutToken: () => verifyLogoutToken
38
+ });
39
+ module.exports = __toCommonJS(src_exports);
40
+
41
+ // src/middleware.ts
42
+ var import_node_crypto = require("crypto");
43
+ var import_sdk4 = require("@teqconnect/sdk");
44
+ var import_jose4 = require("jose");
45
+
46
+ // src/backchannel.ts
47
+ var import_sdk = require("@teqconnect/sdk");
48
+ var import_jose = require("jose");
49
+ var BACKCHANNEL_EVENT = "http://schemas.openid.net/event/backchannel-logout";
50
+ async function verifyLogoutToken(opts, logoutToken) {
51
+ const discovery = await (0, import_sdk.ensureDiscovery)(opts.endpoint);
52
+ const jwks = (0, import_jose.createRemoteJWKSet)(new URL(discovery.jwksUri));
53
+ let payload;
54
+ try {
55
+ ({ payload } = await (0, import_jose.jwtVerify)(logoutToken, jwks, {
56
+ issuer: opts.endpoint,
57
+ audience: opts.clientId,
58
+ algorithms: ["ES256"]
59
+ }));
60
+ } catch (err) {
61
+ throw new import_sdk.AuthenticationError({ message: `invalid logout token: ${err.message}` });
62
+ }
63
+ const events = payload.events;
64
+ if (!events || !(BACKCHANNEL_EVENT in events)) {
65
+ throw new import_sdk.AuthenticationError({ message: "logout token missing backchannel-logout event" });
66
+ }
67
+ if (!payload.sub || !payload.sid) {
68
+ throw new import_sdk.AuthenticationError({ message: "logout token missing sub or sid" });
69
+ }
70
+ return { sub: payload.sub, sid: payload.sid };
71
+ }
72
+ async function applyLogout(_opts, claims, clear) {
73
+ await clear(claims);
74
+ }
75
+
76
+ // src/oidc.ts
77
+ var import_sdk2 = require("@teqconnect/sdk");
78
+ var import_jose2 = require("jose");
79
+ function appScope(extra = "") {
80
+ return "openid profile email offline_access" + (extra ? " " + extra : "");
81
+ }
82
+ function authorizationUrl(authorizationEndpoint, params) {
83
+ const query = new URLSearchParams(params);
84
+ return `${authorizationEndpoint}?${query.toString()}`;
85
+ }
86
+ async function beginLogin(opts, args) {
87
+ const discovery = await (0, import_sdk2.ensureDiscovery)(opts.endpoint);
88
+ const challenge = (0, import_sdk2.pkceS256)(args.codeVerifier);
89
+ return authorizationUrl(discovery.authorizationEndpoint, {
90
+ response_type: "code",
91
+ client_id: opts.clientId,
92
+ redirect_uri: opts.redirectUri,
93
+ scope: appScope(opts.extraScopes),
94
+ state: args.state,
95
+ nonce: args.nonce,
96
+ code_challenge: challenge,
97
+ code_challenge_method: "S256"
98
+ });
99
+ }
100
+ async function postFormBasic(url, clientId, clientSecret, body) {
101
+ const auth = Buffer.from(`${clientId}:${clientSecret}`).toString("base64");
102
+ const res = await fetch(url, {
103
+ method: "POST",
104
+ headers: {
105
+ "Content-Type": "application/x-www-form-urlencoded",
106
+ Authorization: "Basic " + auth,
107
+ Accept: "application/json"
108
+ },
109
+ body: new URLSearchParams(body)
110
+ });
111
+ const json = await res.json().catch(() => ({}));
112
+ if (!res.ok || json?.error) {
113
+ throw new Error(json?.error_description ?? json?.error ?? `token endpoint error ${res.status}`);
114
+ }
115
+ return json;
116
+ }
117
+ async function verifyIdToken(idToken, jwksUri, args) {
118
+ const jwks = (0, import_jose2.createRemoteJWKSet)(new URL(jwksUri));
119
+ const { payload } = await (0, import_jose2.jwtVerify)(idToken, jwks, {
120
+ issuer: args.iss,
121
+ audience: args.aud,
122
+ algorithms: ["ES256"]
123
+ });
124
+ if (payload.nonce !== args.nonce) throw new Error("id token nonce mismatch");
125
+ return payload;
126
+ }
127
+ async function finishLogin(opts, args) {
128
+ const discovery = await (0, import_sdk2.ensureDiscovery)(opts.endpoint);
129
+ const token = await postFormBasic(discovery.tokenEndpoint, opts.clientId, opts.clientSecret, {
130
+ grant_type: "authorization_code",
131
+ code: args.code,
132
+ redirect_uri: opts.redirectUri,
133
+ code_verifier: args.codeVerifier
134
+ });
135
+ const claims = await verifyIdToken(token.id_token, discovery.jwksUri, {
136
+ iss: opts.endpoint,
137
+ aud: opts.clientId,
138
+ nonce: args.expectedNonce
139
+ });
140
+ return {
141
+ sub: claims.sub,
142
+ org_id: claims.org_id,
143
+ // required; ID token claim name is org_id only
144
+ sid: claims.sid,
145
+ access_token: token.access_token,
146
+ refresh_token: token.refresh_token,
147
+ expires_at: new Date(Date.now() + token.expires_in * 1e3).toISOString(),
148
+ profile: claims
149
+ };
150
+ }
151
+
152
+ // src/session.ts
153
+ var import_jose3 = require("jose");
154
+ var COOKIE = "teqconnect_session";
155
+ var MAX_AGE_SECONDS = 43200;
156
+ function cookieOptions(redirectUri) {
157
+ const secure = typeof redirectUri === "string" ? redirectUri.startsWith("https:") : true;
158
+ return { httpOnly: true, secure, sameSite: "lax", path: "/", maxAge: MAX_AGE_SECONDS * 1e3 };
159
+ }
160
+ function key(opts) {
161
+ return opts.sessionSecret.subarray(0, 32);
162
+ }
163
+ async function seal(opts, payload) {
164
+ return new import_jose3.EncryptJWT({ ...payload }).setProtectedHeader({ alg: "dir", enc: "A256GCM" }).setIssuedAt().encrypt(key(opts));
165
+ }
166
+ async function openCookie(opts, cookie) {
167
+ if (!cookie) return null;
168
+ try {
169
+ const { payload } = await (0, import_jose3.jwtDecrypt)(cookie, key(opts), { maxTokenAge: MAX_AGE_SECONDS });
170
+ return payload;
171
+ } catch {
172
+ return null;
173
+ }
174
+ }
175
+
176
+ // src/userClient.ts
177
+ var import_sdk3 = require("@teqconnect/sdk");
178
+ function secondsLeft(expiresAt) {
179
+ return (Date.parse(expiresAt) - Date.now()) / 1e3;
180
+ }
181
+ function replaceTokens(payload, token) {
182
+ return {
183
+ ...payload,
184
+ access_token: token.access_token,
185
+ refresh_token: token.refresh_token ?? payload.refresh_token,
186
+ expires_at: new Date(Date.now() + token.expires_in * 1e3).toISOString()
187
+ };
188
+ }
189
+ var AppSessionCredentials = class {
190
+ constructor(opts, payload, persist) {
191
+ this.opts = opts;
192
+ this.payload = payload;
193
+ this.persist = persist;
194
+ }
195
+ opts;
196
+ payload;
197
+ persist;
198
+ source = "app_session";
199
+ static = false;
200
+ chain = Promise.resolve();
201
+ async getToken() {
202
+ const run = this.chain.then(async () => {
203
+ if (secondsLeft(this.payload.expires_at) >= 60) return this.payload.access_token;
204
+ if (!this.payload.refresh_token) throw new import_sdk3.LoginRequired({ message: "sign in again" });
205
+ const discovery = await (0, import_sdk3.ensureDiscovery)(this.opts.endpoint);
206
+ let token;
207
+ try {
208
+ token = await postFormBasic(discovery.tokenEndpoint, this.opts.clientId, this.opts.clientSecret, {
209
+ grant_type: "refresh_token",
210
+ refresh_token: this.payload.refresh_token
211
+ });
212
+ } catch (err) {
213
+ if (err instanceof import_sdk3.AuthenticationError && err.oauthError === "invalid_grant") {
214
+ throw new import_sdk3.LoginRequired({ message: "sign in again" });
215
+ }
216
+ throw err;
217
+ }
218
+ this.payload = replaceTokens(this.payload, token);
219
+ await this.persist(this.payload);
220
+ return this.payload.access_token;
221
+ });
222
+ this.chain = run.then(
223
+ () => void 0,
224
+ () => void 0
225
+ );
226
+ return run;
227
+ }
228
+ async forceRefresh() {
229
+ this.payload = { ...this.payload, expires_at: (/* @__PURE__ */ new Date(0)).toISOString() };
230
+ await this.getToken();
231
+ }
232
+ };
233
+ function forUser(opts, payload, args) {
234
+ const options = (0, import_sdk3.resolveOptions)({ endpoint: opts.endpoint });
235
+ const credentials = new AppSessionCredentials(opts, payload, args.persist);
236
+ return import_sdk3.TeqConnect._fromCredentials(options, credentials);
237
+ }
238
+
239
+ // src/middleware.ts
240
+ var OIDC_COOKIE = "teqconnect_oidc";
241
+ var OIDC_MAX_AGE_SECONDS = 600;
242
+ function key2(opts) {
243
+ return opts.sessionSecret.subarray(0, 32);
244
+ }
245
+ async function sealOidc(opts, state) {
246
+ return new import_jose4.EncryptJWT({ ...state }).setProtectedHeader({ alg: "dir", enc: "A256GCM" }).setIssuedAt().encrypt(key2(opts));
247
+ }
248
+ async function openOidc(opts, cookie) {
249
+ if (!cookie) return null;
250
+ try {
251
+ const { payload } = await (0, import_jose4.jwtDecrypt)(cookie, key2(opts), { maxTokenAge: OIDC_MAX_AGE_SECONDS });
252
+ return payload;
253
+ } catch {
254
+ return null;
255
+ }
256
+ }
257
+ function revocationId(claims) {
258
+ return `${claims.sub ?? ""}|${claims.sid ?? ""}`;
259
+ }
260
+ function teqAuth(opts, hooks) {
261
+ const revoked = /* @__PURE__ */ new Set();
262
+ return {
263
+ async login(req, res) {
264
+ const state = (0, import_node_crypto.randomBytes)(16).toString("base64url");
265
+ const nonce = (0, import_node_crypto.randomBytes)(16).toString("base64url");
266
+ const codeVerifier = (0, import_sdk4.pkceVerifier)();
267
+ res.cookie(OIDC_COOKIE, await sealOidc(opts, { state, nonce, codeVerifier }), {
268
+ ...cookieOptions(opts.redirectUri),
269
+ // Express cookie maxAge is milliseconds; OIDC_MAX_AGE_SECONDS is seconds.
270
+ maxAge: OIDC_MAX_AGE_SECONDS * 1e3
271
+ });
272
+ res.redirect(await beginLogin(opts, { state, nonce, codeVerifier }));
273
+ },
274
+ async callback(req, res) {
275
+ const oauthError = typeof req.query.error === "string" ? req.query.error : void 0;
276
+ if (oauthError) {
277
+ const description = typeof req.query.error_description === "string" ? req.query.error_description : void 0;
278
+ res.status(400).type("html").send(
279
+ `<h1>Sign-in failed</h1><p><code>${oauthError}</code>${description ? `: ${description}` : ""}</p><p><a href="/auth/login">Try again</a></p>`
280
+ );
281
+ return;
282
+ }
283
+ const pending = await openOidc(opts, req.cookies?.[OIDC_COOKIE]);
284
+ const code = typeof req.query.code === "string" ? req.query.code : void 0;
285
+ const state = typeof req.query.state === "string" ? req.query.state : void 0;
286
+ if (!pending || !code || state !== pending.state) {
287
+ res.status(400).json({ error: "invalid_login_state" });
288
+ return;
289
+ }
290
+ const payload = await finishLogin(opts, {
291
+ code,
292
+ codeVerifier: pending.codeVerifier,
293
+ expectedNonce: pending.nonce
294
+ });
295
+ res.cookie(COOKIE, await seal(opts, payload), cookieOptions(opts.redirectUri));
296
+ res.clearCookie(OIDC_COOKIE, { ...cookieOptions(opts.redirectUri), maxAge: 0 });
297
+ await hooks.onSignedIn(payload);
298
+ res.redirect("/");
299
+ },
300
+ async logout(req, res) {
301
+ const base = { httpOnly: true, sameSite: "lax", path: "/", maxAge: 0 };
302
+ res.clearCookie(COOKIE, { ...base, secure: true });
303
+ res.clearCookie(COOKIE, { ...base, secure: false });
304
+ res.clearCookie(OIDC_COOKIE, { ...base, secure: true });
305
+ res.clearCookie(OIDC_COOKIE, { ...base, secure: false });
306
+ const appDest = opts.postLogoutRedirectUri ?? "/?signedout=1";
307
+ const portalSignOut = `${opts.endpoint.replace(/\/$/, "")}/auth/sign-out?post_logout_redirect_uri=${encodeURIComponent(appDest)}`;
308
+ try {
309
+ const discovery = await (0, import_sdk4.ensureDiscovery)(opts.endpoint);
310
+ if (discovery.endSessionEndpoint) {
311
+ const url = new URL(discovery.endSessionEndpoint);
312
+ url.searchParams.set("client_id", opts.clientId);
313
+ url.searchParams.set("post_logout_redirect_uri", portalSignOut);
314
+ res.redirect(url.toString());
315
+ return;
316
+ }
317
+ } catch {
318
+ }
319
+ res.redirect(portalSignOut);
320
+ },
321
+ async requireUser(req, res, next) {
322
+ const payload = await openCookie(opts, req.cookies?.[COOKIE]);
323
+ if (!payload || revoked.has(revocationId(payload))) {
324
+ res.status(401).json({ error: "login_required" });
325
+ return;
326
+ }
327
+ req.teqUser = payload;
328
+ next();
329
+ },
330
+ async forUser(req, res) {
331
+ const payload = await openCookie(opts, req.cookies?.[COOKIE]);
332
+ if (!payload || revoked.has(revocationId(payload))) throw new import_sdk4.LoginRequired({ message: "sign in again" });
333
+ return forUser(opts, payload, {
334
+ persist: async (next) => {
335
+ if (res) res.cookie(COOKIE, await seal(opts, next), cookieOptions(opts.redirectUri));
336
+ }
337
+ });
338
+ },
339
+ async backchannelLogout(req, res) {
340
+ const logoutToken = typeof req.body?.logout_token === "string" ? req.body.logout_token : void 0;
341
+ if (!logoutToken) {
342
+ res.status(400).json({ error: "missing_logout_token" });
343
+ return;
344
+ }
345
+ try {
346
+ const claims = await verifyLogoutToken(opts, logoutToken);
347
+ await applyLogout(opts, claims, (c) => {
348
+ revoked.add(revocationId(c));
349
+ });
350
+ res.status(200).end();
351
+ } catch {
352
+ res.status(400).json({ error: "invalid_logout_token" });
353
+ }
354
+ }
355
+ };
356
+ }
357
+
358
+ // src/options.ts
359
+ var ENV_ENDPOINTS = {
360
+ test: "https://test.tccloud.io",
361
+ staging: "https://staging.tccloud.io",
362
+ prod: "https://tccloud.io"
363
+ };
364
+ function envEndpoint() {
365
+ if (process.env.TEQCONNECT_ENDPOINT) return process.env.TEQCONNECT_ENDPOINT;
366
+ const env = process.env.TEQCONNECT_ENV;
367
+ if (env && ENV_ENDPOINTS[env]) return ENV_ENDPOINTS[env];
368
+ return void 0;
369
+ }
370
+ function toSecret(value) {
371
+ if (!value) throw new Error("TEQCONNECT_SESSION_SECRET (or sessionSecret) is required");
372
+ const secret = typeof value === "string" ? Buffer.from(value, "utf8") : value;
373
+ if (secret.length < 32) throw new Error("session secret must be at least 32 bytes");
374
+ return secret;
375
+ }
376
+ function resolveAppOptions(overrides = {}) {
377
+ const endpoint = overrides.endpoint ?? envEndpoint();
378
+ if (!endpoint) throw new Error("endpoint is missing: set endpoint, TEQCONNECT_ENDPOINT, or TEQCONNECT_ENV");
379
+ const clientId = overrides.clientId ?? process.env.TEQCONNECT_APP_CLIENT_ID;
380
+ const clientSecret = overrides.clientSecret ?? process.env.TEQCONNECT_APP_CLIENT_SECRET;
381
+ const redirectUri = overrides.redirectUri ?? process.env.TEQCONNECT_APP_REDIRECT_URI;
382
+ if (!clientId || !clientSecret || !redirectUri) {
383
+ throw new Error("client id, client secret, and redirect uri are required");
384
+ }
385
+ return {
386
+ endpoint,
387
+ clientId,
388
+ clientSecret,
389
+ redirectUri,
390
+ sessionSecret: toSecret(overrides.sessionSecret ?? process.env.TEQCONNECT_SESSION_SECRET),
391
+ postLogoutRedirectUri: overrides.postLogoutRedirectUri ?? process.env.TEQCONNECT_APP_POST_LOGOUT_REDIRECT_URI,
392
+ extraScopes: overrides.extraScopes ?? process.env.TEQCONNECT_APP_SCOPES ?? ""
393
+ };
394
+ }
395
+
396
+ // src/webhook.ts
397
+ var import_sdk5 = require("@teqconnect/sdk");
398
+ var import_webhooks = require("@teqconnect/sdk/webhooks");
399
+ function expressRawBody() {
400
+ return (req, _res, next) => {
401
+ const chunks = [];
402
+ req.on("data", (chunk) => {
403
+ chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
404
+ });
405
+ req.on("end", () => {
406
+ req.rawBody = Buffer.concat(chunks);
407
+ next();
408
+ });
409
+ req.on("error", next);
410
+ };
411
+ }
412
+ function verifyExpressWebhook(req, secret) {
413
+ const raw = req.rawBody;
414
+ if (!raw) {
415
+ throw new import_sdk5.WebhookVerificationError({
416
+ code: "MISSING_RAW_BODY",
417
+ message: "raw body required"
418
+ });
419
+ }
420
+ return (0, import_webhooks.verifyWebhook)({
421
+ secret,
422
+ rawBody: raw,
423
+ signature: String(req.headers["teqconnect-signature"] || ""),
424
+ timestamp: String(req.headers["teqconnect-timestamp"] || "")
425
+ });
426
+ }
427
+ // Annotate the CommonJS export names for ESM import in node:
428
+ 0 && (module.exports = {
429
+ AppSessionCredentials,
430
+ COOKIE,
431
+ WebhookVerificationError,
432
+ appScope,
433
+ beginLogin,
434
+ expressRawBody,
435
+ finishLogin,
436
+ forUser,
437
+ openCookie,
438
+ replaceTokens,
439
+ resolveAppOptions,
440
+ teqAuth,
441
+ verifyExpressWebhook,
442
+ verifyIdToken,
443
+ verifyLogoutToken
444
+ });
445
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/index.ts","../src/middleware.ts","../src/backchannel.ts","../src/oidc.ts","../src/session.ts","../src/userClient.ts","../src/options.ts","../src/webhook.ts"],"sourcesContent":["// Public surface of @teqconnect/express — Sign in with TeqConnect + webhook helpers.\n\nexport { teqAuth, type TeqAuthHooks, type OnSignedIn } from \"./middleware\";\nexport { resolveAppOptions, type AppAuthOptions, type AppAuthOverrides } from \"./options\";\nexport { COOKIE, openCookie, type SessionPayload } from \"./session\";\nexport { appScope, beginLogin, finishLogin, verifyIdToken } from \"./oidc\";\nexport { verifyLogoutToken, type LogoutClaims } from \"./backchannel\";\nexport { forUser, AppSessionCredentials, replaceTokens, type PersistSession } from \"./userClient\";\nexport {\n expressRawBody,\n verifyExpressWebhook,\n WebhookVerificationError,\n type WebhookEvent,\n} from \"./webhook\";\n","// Express adapter. The same six operations as Flask and FastAPI: login, callback, logout,\n// requireUser, forUser, backchannelLogout. Adapter only — shared behavior lives in\n// oidc/session/backchannel/userClient. Do not add a parallel auth surface.\n\nimport { randomBytes } from \"node:crypto\";\nimport { ensureDiscovery, LoginRequired, pkceVerifier, type TeqConnect } from \"@teqconnect/sdk\";\nimport { EncryptJWT, jwtDecrypt } from \"jose\";\nimport type { NextFunction, Request, Response } from \"express\";\nimport { applyLogout, type LogoutClaims, verifyLogoutToken } from \"./backchannel\";\nimport { beginLogin, finishLogin } from \"./oidc\";\nimport type { AppAuthOptions } from \"./options\";\nimport { COOKIE, cookieOptions, openCookie, seal, type SessionPayload } from \"./session\";\nimport { forUser as buildUserClient } from \"./userClient\";\n\n/** First sign-in: the app owns Local | TeqConnect | Both. The SDK does not create portal users. */\nexport type OnSignedIn = (payload: SessionPayload) => void | Promise<void>;\n\nexport interface TeqAuthHooks {\n onSignedIn: OnSignedIn;\n}\n\nconst OIDC_COOKIE = \"teqconnect_oidc\";\n/** Login-transaction lifetime in seconds (jose maxTokenAge). */\nconst OIDC_MAX_AGE_SECONDS = 600;\n\ninterface OidcState {\n state: string;\n nonce: string;\n codeVerifier: string;\n}\n\nfunction key(opts: AppAuthOptions): Uint8Array {\n return opts.sessionSecret.subarray(0, 32);\n}\n\nasync function sealOidc(opts: AppAuthOptions, state: OidcState): Promise<string> {\n return new EncryptJWT({ ...state })\n .setProtectedHeader({ alg: \"dir\", enc: \"A256GCM\" })\n .setIssuedAt()\n .encrypt(key(opts));\n}\n\nasync function openOidc(opts: AppAuthOptions, cookie: string | undefined): Promise<OidcState | null> {\n if (!cookie) return null;\n try {\n const { payload } = await jwtDecrypt(cookie, key(opts), { maxTokenAge: OIDC_MAX_AGE_SECONDS });\n return payload as unknown as OidcState;\n } catch {\n return null;\n }\n}\n\nfunction revocationId(claims: { sub?: string; sid?: string }): string {\n return `${claims.sub ?? \"\"}|${claims.sid ?? \"\"}`;\n}\n\nexport function teqAuth(opts: AppAuthOptions, hooks: TeqAuthHooks) {\n // Adapter-supplied store for back-channel logout (sub|sid revocation set).\n const revoked = new Set<string>();\n\n return {\n async login(req: Request, res: Response): Promise<void> {\n const state = randomBytes(16).toString(\"base64url\");\n const nonce = randomBytes(16).toString(\"base64url\");\n const codeVerifier = pkceVerifier();\n res.cookie(OIDC_COOKIE, await sealOidc(opts, { state, nonce, codeVerifier }), {\n ...cookieOptions(opts.redirectUri),\n // Express cookie maxAge is milliseconds; OIDC_MAX_AGE_SECONDS is seconds.\n maxAge: OIDC_MAX_AGE_SECONDS * 1000,\n });\n res.redirect(await beginLogin(opts, { state, nonce, codeVerifier }));\n },\n\n async callback(req: Request, res: Response): Promise<void> {\n const oauthError = typeof req.query.error === \"string\" ? req.query.error : undefined;\n if (oauthError) {\n const description =\n typeof req.query.error_description === \"string\" ? req.query.error_description : undefined;\n res.status(400).type(\"html\").send(\n `<h1>Sign-in failed</h1><p><code>${oauthError}</code>${description ? `: ${description}` : \"\"}</p>` +\n `<p><a href=\"/auth/login\">Try again</a></p>`,\n );\n return;\n }\n const pending = await openOidc(opts, req.cookies?.[OIDC_COOKIE]);\n const code = typeof req.query.code === \"string\" ? req.query.code : undefined;\n const state = typeof req.query.state === \"string\" ? req.query.state : undefined;\n if (!pending || !code || state !== pending.state) {\n res.status(400).json({ error: \"invalid_login_state\" });\n return;\n }\n const payload = await finishLogin(opts, {\n code,\n codeVerifier: pending.codeVerifier,\n expectedNonce: pending.nonce,\n });\n res.cookie(COOKIE, await seal(opts, payload), cookieOptions(opts.redirectUri));\n res.clearCookie(OIDC_COOKIE, { ...cookieOptions(opts.redirectUri), maxAge: 0 });\n await hooks.onSignedIn(payload);\n res.redirect(\"/\");\n },\n\n async logout(req: Request, res: Response): Promise<void> {\n // Clear both Secure and non-Secure variants so http://localhost samples drop\n // cookies that were previously set with Secure=true.\n const base = { httpOnly: true, sameSite: \"lax\" as const, path: \"/\", maxAge: 0 };\n res.clearCookie(COOKIE, { ...base, secure: true });\n res.clearCookie(COOKIE, { ...base, secure: false });\n res.clearCookie(OIDC_COOKIE, { ...base, secure: true });\n res.clearCookie(OIDC_COOKIE, { ...base, secure: false });\n // App confirmation page after the portal finishes signing out.\n const appDest = opts.postLogoutRedirectUri ?? \"/?signedout=1\";\n // end_session → /auth/sign-out (clears portal localStorage) → appDest.\n // Clearing only the OIDC cookie is not enough: a stale portal token makes\n // /auth/sign-in auto-continue and bounce straight back to the app.\n // Build with one encodeURIComponent so it matches the registered client URI.\n const portalSignOut =\n `${opts.endpoint.replace(/\\/$/, \"\")}/auth/sign-out` +\n `?post_logout_redirect_uri=${encodeURIComponent(appDest)}`;\n try {\n const discovery = await ensureDiscovery(opts.endpoint);\n if (discovery.endSessionEndpoint) {\n const url = new URL(discovery.endSessionEndpoint);\n url.searchParams.set(\"client_id\", opts.clientId);\n url.searchParams.set(\"post_logout_redirect_uri\", portalSignOut);\n res.redirect(url.toString());\n return;\n }\n } catch {\n // Fall through to portal sign-out without end_session.\n }\n res.redirect(portalSignOut);\n },\n\n async requireUser(req: Request, res: Response, next: NextFunction): Promise<void> {\n const payload = await openCookie(opts, req.cookies?.[COOKIE]);\n if (!payload || revoked.has(revocationId(payload))) {\n res.status(401).json({ error: \"login_required\" });\n return;\n }\n (req as Request & { teqUser?: SessionPayload }).teqUser = payload;\n next();\n },\n\n async forUser(req: Request, res?: Response): Promise<TeqConnect> {\n const payload = await openCookie(opts, req.cookies?.[COOKIE]);\n if (!payload || revoked.has(revocationId(payload))) throw new LoginRequired({ message: \"sign in again\" });\n return buildUserClient(opts, payload, {\n persist: async (next) => {\n if (res) res.cookie(COOKIE, await seal(opts, next), cookieOptions(opts.redirectUri));\n },\n });\n },\n\n async backchannelLogout(req: Request, res: Response): Promise<void> {\n const logoutToken =\n typeof req.body?.logout_token === \"string\" ? req.body.logout_token : undefined;\n if (!logoutToken) {\n res.status(400).json({ error: \"missing_logout_token\" });\n return;\n }\n try {\n const claims: LogoutClaims = await verifyLogoutToken(opts, logoutToken);\n await applyLogout(opts, claims, (c) => {\n revoked.add(revocationId(c));\n });\n res.status(200).end();\n } catch {\n res.status(400).json({ error: \"invalid_logout_token\" });\n }\n },\n };\n}\n","// Back-channel logout. One-to-one with Python auth/backchannel.py.\n\nimport { AuthenticationError, ensureDiscovery } from \"@teqconnect/sdk\";\nimport { createRemoteJWKSet, jwtVerify } from \"jose\";\nimport type { AppAuthOptions } from \"./options\";\n\nconst BACKCHANNEL_EVENT = \"http://schemas.openid.net/event/backchannel-logout\";\n\nexport interface LogoutClaims {\n sub: string;\n sid: string;\n}\n\n/** JWKS verify; require events backchannel-logout, sub, and sid. */\nexport async function verifyLogoutToken(opts: AppAuthOptions, logoutToken: string): Promise<LogoutClaims> {\n const discovery = await ensureDiscovery(opts.endpoint);\n const jwks = createRemoteJWKSet(new URL(discovery.jwksUri));\n let payload: Record<string, unknown>;\n try {\n ({ payload } = (await jwtVerify(logoutToken, jwks, {\n issuer: opts.endpoint,\n audience: opts.clientId,\n algorithms: [\"ES256\"],\n })) as { payload: Record<string, unknown> });\n } catch (err) {\n throw new AuthenticationError({ message: `invalid logout token: ${(err as Error).message}` });\n }\n const events = payload.events as Record<string, unknown> | undefined;\n if (!events || !(BACKCHANNEL_EVENT in events)) {\n throw new AuthenticationError({ message: \"logout token missing backchannel-logout event\" });\n }\n if (!payload.sub || !payload.sid) {\n throw new AuthenticationError({ message: \"logout token missing sub or sid\" });\n }\n return { sub: payload.sub as string, sid: payload.sid as string };\n}\n\nexport type SessionStore = (claims: LogoutClaims) => void | Promise<void>;\n\n/** Clear any sealed session matching sub/sid. The adapter supplies the store. */\nexport async function applyLogout(\n _opts: AppAuthOptions,\n claims: LogoutClaims,\n clear: SessionStore,\n): Promise<void> {\n await clear(claims);\n}\n","// Shared OIDC for the app sign-in plugin. No second OIDC client inside @teqconnect/sdk; the\n// authorization-code flow lives here. ensureDiscovery / pkce* come from @teqconnect/sdk.\n// One-to-one with Python auth/oidc.py.\n\nimport { ensureDiscovery, pkceS256 } from \"@teqconnect/sdk\";\nimport { createRemoteJWKSet, jwtVerify } from \"jose\";\nimport type { AppAuthOptions } from \"./options\";\nimport type { SessionPayload } from \"./session\";\n\ninterface TokenResponse {\n access_token: string;\n id_token: string;\n refresh_token?: string;\n token_type?: string;\n expires_in: number;\n scope?: string;\n}\n\n/** The app scope string always includes openid, profile, email, and offline_access. */\nexport function appScope(extra = \"\"): string {\n return \"openid profile email offline_access\" + (extra ? \" \" + extra : \"\");\n}\n\nexport function authorizationUrl(authorizationEndpoint: string, params: Record<string, string>): string {\n const query = new URLSearchParams(params);\n return `${authorizationEndpoint}?${query.toString()}`;\n}\n\nexport async function beginLogin(\n opts: AppAuthOptions,\n args: { state: string; nonce: string; codeVerifier: string },\n): Promise<string> {\n const discovery = await ensureDiscovery(opts.endpoint);\n const challenge = pkceS256(args.codeVerifier);\n return authorizationUrl(discovery.authorizationEndpoint, {\n response_type: \"code\",\n client_id: opts.clientId,\n redirect_uri: opts.redirectUri,\n scope: appScope(opts.extraScopes),\n state: args.state,\n nonce: args.nonce,\n code_challenge: challenge,\n code_challenge_method: \"S256\",\n });\n}\n\n/** POST the token endpoint with client_secret_basic (web clients only). */\nexport async function postFormBasic(\n url: string,\n clientId: string,\n clientSecret: string,\n body: Record<string, string>,\n): Promise<TokenResponse> {\n const auth = Buffer.from(`${clientId}:${clientSecret}`).toString(\"base64\");\n const res = await fetch(url, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n Authorization: \"Basic \" + auth,\n Accept: \"application/json\",\n },\n body: new URLSearchParams(body),\n });\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const json: any = await res.json().catch(() => ({}));\n if (!res.ok || json?.error) {\n throw new Error(json?.error_description ?? json?.error ?? `token endpoint error ${res.status}`);\n }\n return json as TokenResponse;\n}\n\n/** Verify alg ES256, kid in JWKS, signature, iss, aud, nonce, and exp. */\nexport async function verifyIdToken(\n idToken: string,\n jwksUri: string,\n args: { iss: string; aud: string; nonce: string },\n): Promise<Record<string, unknown>> {\n const jwks = createRemoteJWKSet(new URL(jwksUri));\n const { payload } = await jwtVerify(idToken, jwks, {\n issuer: args.iss,\n audience: args.aud,\n algorithms: [\"ES256\"],\n });\n if (payload.nonce !== args.nonce) throw new Error(\"id token nonce mismatch\");\n return payload as Record<string, unknown>;\n}\n\nexport async function finishLogin(\n opts: AppAuthOptions,\n args: { code: string; codeVerifier: string; expectedNonce: string },\n): Promise<SessionPayload> {\n const discovery = await ensureDiscovery(opts.endpoint);\n const token = await postFormBasic(discovery.tokenEndpoint, opts.clientId, opts.clientSecret, {\n grant_type: \"authorization_code\",\n code: args.code,\n redirect_uri: opts.redirectUri,\n code_verifier: args.codeVerifier,\n });\n const claims = await verifyIdToken(token.id_token, discovery.jwksUri, {\n iss: opts.endpoint,\n aud: opts.clientId,\n nonce: args.expectedNonce,\n });\n return {\n sub: claims.sub as string,\n org_id: claims.org_id as string, // required; ID token claim name is org_id only\n sid: claims.sid as string | undefined,\n access_token: token.access_token,\n refresh_token: token.refresh_token,\n expires_at: new Date(Date.now() + token.expires_in * 1000).toISOString(),\n profile: claims,\n };\n}\n","// Encrypted session cookie. One-to-one with Python auth/session.py.\n//\n// Cookie name teqconnect_session. HttpOnly Secure SameSite=Lax Path=/ Max-Age=43200.\n// The browser never receives the tokens in a script-readable field.\n\nimport { EncryptJWT, jwtDecrypt } from \"jose\";\nimport type { AppAuthOptions } from \"./options\";\n\nexport const COOKIE = \"teqconnect_session\";\n/** HTTP Max-Age / jose maxTokenAge, in seconds (12 hours). */\nconst MAX_AGE_SECONDS = 43200;\n\n/** Locked fields. profile is the ID-token claims map; sid is present when the token carries it. */\nexport interface SessionPayload {\n sub: string;\n org_id: string;\n access_token: string;\n refresh_token?: string;\n /** Access-token expiry, ISO-8601. */\n expires_at: string;\n /** ID-token claims map. */\n profile: Record<string, unknown>;\n sid?: string;\n}\n\nexport interface CookieOptions {\n httpOnly: boolean;\n secure: boolean;\n sameSite: \"lax\";\n path: string;\n /** Express cookie maxAge is milliseconds. */\n maxAge: number;\n}\n\n/** Secure only when the app redirect URI is https (http://localhost samples cannot set Secure cookies in some browsers). */\nexport function cookieOptions(redirectUri?: string): CookieOptions {\n // Plan Max-Age is 43200 seconds; Express wants milliseconds.\n const secure = typeof redirectUri === \"string\" ? redirectUri.startsWith(\"https:\") : true;\n return { httpOnly: true, secure, sameSite: \"lax\", path: \"/\", maxAge: MAX_AGE_SECONDS * 1000 };\n}\n\nfunction key(opts: AppAuthOptions): Uint8Array {\n // A256GCM needs a 32-byte key; the session secret is at least 32 bytes.\n return opts.sessionSecret.subarray(0, 32);\n}\n\n/** Encrypt the payload; issued_at lets open_cookie enforce the 12h lifetime. */\nexport async function seal(opts: AppAuthOptions, payload: SessionPayload): Promise<string> {\n return new EncryptJWT({ ...payload } as unknown as Record<string, unknown>)\n .setProtectedHeader({ alg: \"dir\", enc: \"A256GCM\" })\n .setIssuedAt()\n .encrypt(key(opts));\n}\n\n/** Decrypt; return null if missing, tampered, or older than Max-Age 43200. */\nexport async function openCookie(opts: AppAuthOptions, cookie: string | undefined): Promise<SessionPayload | null> {\n if (!cookie) return null;\n try {\n const { payload } = await jwtDecrypt(cookie, key(opts), { maxTokenAge: MAX_AGE_SECONDS });\n return payload as unknown as SessionPayload;\n } catch {\n return null;\n }\n}\n\n/** Cookie clearing instructions for the adapter. */\nexport function clearCookie(redirectUri?: string): { name: string; options: CookieOptions } {\n return { name: COOKIE, options: { ...cookieOptions(redirectUri), maxAge: 0 } };\n}\n","// App-session credentials and forUser. One-to-one with Python auth/user_client.py.\n//\n// for_user returns a TeqConnect built only via _fromCredentials with AppSessionCredentials;\n// it refreshes with grant_type=refresh_token plus client_secret_basic. This does not read\n// ~/.teqconnect and does not enter chain.resolve.\n\nimport {\n AuthenticationError,\n ensureDiscovery,\n LoginRequired,\n resolveOptions,\n TeqConnect,\n type Credentials,\n} from \"@teqconnect/sdk\";\nimport { postFormBasic } from \"./oidc\";\nimport type { AppAuthOptions } from \"./options\";\nimport type { SessionPayload } from \"./session\";\n\nexport type PersistSession = (payload: SessionPayload) => void | Promise<void>;\n\nfunction secondsLeft(expiresAt: string): number {\n return (Date.parse(expiresAt) - Date.now()) / 1000;\n}\n\ninterface RefreshResponse {\n access_token: string;\n refresh_token?: string;\n expires_in: number;\n}\n\n/** Replace the access/refresh tokens and expiry; keep sub/org/profile. */\nexport function replaceTokens(payload: SessionPayload, token: RefreshResponse): SessionPayload {\n return {\n ...payload,\n access_token: token.access_token,\n refresh_token: token.refresh_token ?? payload.refresh_token,\n expires_at: new Date(Date.now() + token.expires_in * 1000).toISOString(),\n };\n}\n\nexport class AppSessionCredentials implements Credentials {\n readonly source = \"app_session\";\n readonly static = false;\n private chain: Promise<unknown> = Promise.resolve();\n\n constructor(\n private readonly opts: AppAuthOptions,\n public payload: SessionPayload,\n private readonly persist: PersistSession,\n ) {}\n\n async getToken(): Promise<string> {\n const run = this.chain.then(async () => {\n if (secondsLeft(this.payload.expires_at) >= 60) return this.payload.access_token;\n if (!this.payload.refresh_token) throw new LoginRequired({ message: \"sign in again\" });\n const discovery = await ensureDiscovery(this.opts.endpoint);\n let token: RefreshResponse;\n try {\n token = await postFormBasic(discovery.tokenEndpoint, this.opts.clientId, this.opts.clientSecret, {\n grant_type: \"refresh_token\",\n refresh_token: this.payload.refresh_token,\n });\n } catch (err) {\n if (err instanceof AuthenticationError && err.oauthError === \"invalid_grant\") {\n throw new LoginRequired({ message: \"sign in again\" });\n }\n throw err;\n }\n this.payload = replaceTokens(this.payload, token);\n await this.persist(this.payload);\n return this.payload.access_token;\n });\n this.chain = run.then(\n () => undefined,\n () => undefined,\n );\n return run;\n }\n\n async forceRefresh(): Promise<void> {\n this.payload = { ...this.payload, expires_at: new Date(0).toISOString() };\n await this.getToken();\n }\n}\n\n/** Build a per-request TeqConnect bound to the user's session. */\nexport function forUser(opts: AppAuthOptions, payload: SessionPayload, args: { persist: PersistSession }): TeqConnect {\n const options = resolveOptions({ endpoint: opts.endpoint });\n const credentials = new AppSessionCredentials(opts, payload, args.persist);\n // _fromCredentials is package-private (@internal); it is the only entry for app sessions.\n return (TeqConnect as unknown as {\n _fromCredentials(o: typeof options, c: Credentials): TeqConnect;\n })._fromCredentials(options, credentials);\n}\n","// App sign-in options. Code options win over TEQCONNECT_APP_* / ENDPOINT / ENV.\n// One-to-one with Python auth/options.py.\n\nexport interface AppAuthOptions {\n endpoint: string;\n clientId: string;\n clientSecret: string;\n redirectUri: string;\n /** At least 32 random bytes. */\n sessionSecret: Buffer;\n postLogoutRedirectUri?: string;\n extraScopes: string;\n}\n\nexport interface AppAuthOverrides {\n endpoint?: string;\n clientId?: string;\n clientSecret?: string;\n redirectUri?: string;\n sessionSecret?: Buffer | string;\n postLogoutRedirectUri?: string;\n extraScopes?: string;\n}\n\nconst ENV_ENDPOINTS: Record<string, string> = {\n test: \"https://test.tccloud.io\",\n staging: \"https://staging.tccloud.io\",\n prod: \"https://tccloud.io\",\n};\n\nfunction envEndpoint(): string | undefined {\n if (process.env.TEQCONNECT_ENDPOINT) return process.env.TEQCONNECT_ENDPOINT;\n const env = process.env.TEQCONNECT_ENV;\n if (env && ENV_ENDPOINTS[env]) return ENV_ENDPOINTS[env];\n return undefined;\n}\n\nfunction toSecret(value: Buffer | string | undefined): Buffer {\n if (!value) throw new Error(\"TEQCONNECT_SESSION_SECRET (or sessionSecret) is required\");\n const secret = typeof value === \"string\" ? Buffer.from(value, \"utf8\") : value;\n if (secret.length < 32) throw new Error(\"session secret must be at least 32 bytes\");\n return secret;\n}\n\nexport function resolveAppOptions(overrides: AppAuthOverrides = {}): AppAuthOptions {\n const endpoint = overrides.endpoint ?? envEndpoint();\n if (!endpoint) throw new Error(\"endpoint is missing: set endpoint, TEQCONNECT_ENDPOINT, or TEQCONNECT_ENV\");\n const clientId = overrides.clientId ?? process.env.TEQCONNECT_APP_CLIENT_ID;\n const clientSecret = overrides.clientSecret ?? process.env.TEQCONNECT_APP_CLIENT_SECRET;\n const redirectUri = overrides.redirectUri ?? process.env.TEQCONNECT_APP_REDIRECT_URI;\n if (!clientId || !clientSecret || !redirectUri) {\n throw new Error(\"client id, client secret, and redirect uri are required\");\n }\n return {\n endpoint,\n clientId,\n clientSecret,\n redirectUri,\n sessionSecret: toSecret(overrides.sessionSecret ?? process.env.TEQCONNECT_SESSION_SECRET),\n postLogoutRedirectUri: overrides.postLogoutRedirectUri ?? process.env.TEQCONNECT_APP_POST_LOGOUT_REDIRECT_URI,\n extraScopes: overrides.extraScopes ?? process.env.TEQCONNECT_APP_SCOPES ?? \"\",\n };\n}\n","// Express raw-body capture + verifyWebhook helper. Not OIDC / tc.auth.\n\nimport type { NextFunction, Request, RequestHandler, Response } from \"express\";\nimport { WebhookVerificationError } from \"@teqconnect/sdk\";\nimport { verifyWebhook, type WebhookEvent } from \"@teqconnect/sdk/webhooks\";\n\ntype RawBodyRequest = Request & { rawBody?: Buffer };\n\n/** Capture the exact request bytes on ``req.rawBody`` before JSON parsers run. */\nexport function expressRawBody(): RequestHandler {\n return (req: Request, _res: Response, next: NextFunction) => {\n const chunks: Buffer[] = [];\n req.on(\"data\", (chunk: Buffer | string) => {\n chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n });\n req.on(\"end\", () => {\n (req as RawBodyRequest).rawBody = Buffer.concat(chunks);\n next();\n });\n req.on(\"error\", next);\n };\n}\n\n/** Verify the TeqConnect webhook signature on an Express request that used ``expressRawBody``. */\nexport function verifyExpressWebhook(req: Request, secret: string | string[]): WebhookEvent {\n const raw = (req as RawBodyRequest).rawBody;\n if (!raw) {\n throw new WebhookVerificationError({\n code: \"MISSING_RAW_BODY\",\n message: \"raw body required\",\n });\n }\n return verifyWebhook({\n secret,\n rawBody: raw,\n signature: String(req.headers[\"teqconnect-signature\"] || \"\"),\n timestamp: String(req.headers[\"teqconnect-timestamp\"] || \"\"),\n });\n}\n\nexport { WebhookVerificationError, type WebhookEvent };\n"],"mappings":"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","names":["import_sdk","import_jose","import_sdk","import_jose","import_jose","import_sdk","key","import_sdk"]}
@@ -0,0 +1,7 @@
1
+ export { teqAuth, type TeqAuthHooks, type OnSignedIn } from "./middleware";
2
+ export { resolveAppOptions, type AppAuthOptions, type AppAuthOverrides } from "./options";
3
+ export { COOKIE, openCookie, type SessionPayload } from "./session";
4
+ export { appScope, beginLogin, finishLogin, verifyIdToken } from "./oidc";
5
+ export { verifyLogoutToken, type LogoutClaims } from "./backchannel";
6
+ export { forUser, AppSessionCredentials, replaceTokens, type PersistSession } from "./userClient";
7
+ export { expressRawBody, verifyExpressWebhook, WebhookVerificationError, type WebhookEvent, } from "./webhook";
package/dist/index.js ADDED
@@ -0,0 +1,410 @@
1
+ // src/middleware.ts
2
+ import { randomBytes } from "crypto";
3
+ import { ensureDiscovery as ensureDiscovery4, LoginRequired as LoginRequired2, pkceVerifier } from "@teqconnect/sdk";
4
+ import { EncryptJWT as EncryptJWT2, jwtDecrypt as jwtDecrypt2 } from "jose";
5
+
6
+ // src/backchannel.ts
7
+ import { AuthenticationError, ensureDiscovery } from "@teqconnect/sdk";
8
+ import { createRemoteJWKSet, jwtVerify } from "jose";
9
+ var BACKCHANNEL_EVENT = "http://schemas.openid.net/event/backchannel-logout";
10
+ async function verifyLogoutToken(opts, logoutToken) {
11
+ const discovery = await ensureDiscovery(opts.endpoint);
12
+ const jwks = createRemoteJWKSet(new URL(discovery.jwksUri));
13
+ let payload;
14
+ try {
15
+ ({ payload } = await jwtVerify(logoutToken, jwks, {
16
+ issuer: opts.endpoint,
17
+ audience: opts.clientId,
18
+ algorithms: ["ES256"]
19
+ }));
20
+ } catch (err) {
21
+ throw new AuthenticationError({ message: `invalid logout token: ${err.message}` });
22
+ }
23
+ const events = payload.events;
24
+ if (!events || !(BACKCHANNEL_EVENT in events)) {
25
+ throw new AuthenticationError({ message: "logout token missing backchannel-logout event" });
26
+ }
27
+ if (!payload.sub || !payload.sid) {
28
+ throw new AuthenticationError({ message: "logout token missing sub or sid" });
29
+ }
30
+ return { sub: payload.sub, sid: payload.sid };
31
+ }
32
+ async function applyLogout(_opts, claims, clear) {
33
+ await clear(claims);
34
+ }
35
+
36
+ // src/oidc.ts
37
+ import { ensureDiscovery as ensureDiscovery2, pkceS256 } from "@teqconnect/sdk";
38
+ import { createRemoteJWKSet as createRemoteJWKSet2, jwtVerify as jwtVerify2 } from "jose";
39
+ function appScope(extra = "") {
40
+ return "openid profile email offline_access" + (extra ? " " + extra : "");
41
+ }
42
+ function authorizationUrl(authorizationEndpoint, params) {
43
+ const query = new URLSearchParams(params);
44
+ return `${authorizationEndpoint}?${query.toString()}`;
45
+ }
46
+ async function beginLogin(opts, args) {
47
+ const discovery = await ensureDiscovery2(opts.endpoint);
48
+ const challenge = pkceS256(args.codeVerifier);
49
+ return authorizationUrl(discovery.authorizationEndpoint, {
50
+ response_type: "code",
51
+ client_id: opts.clientId,
52
+ redirect_uri: opts.redirectUri,
53
+ scope: appScope(opts.extraScopes),
54
+ state: args.state,
55
+ nonce: args.nonce,
56
+ code_challenge: challenge,
57
+ code_challenge_method: "S256"
58
+ });
59
+ }
60
+ async function postFormBasic(url, clientId, clientSecret, body) {
61
+ const auth = Buffer.from(`${clientId}:${clientSecret}`).toString("base64");
62
+ const res = await fetch(url, {
63
+ method: "POST",
64
+ headers: {
65
+ "Content-Type": "application/x-www-form-urlencoded",
66
+ Authorization: "Basic " + auth,
67
+ Accept: "application/json"
68
+ },
69
+ body: new URLSearchParams(body)
70
+ });
71
+ const json = await res.json().catch(() => ({}));
72
+ if (!res.ok || json?.error) {
73
+ throw new Error(json?.error_description ?? json?.error ?? `token endpoint error ${res.status}`);
74
+ }
75
+ return json;
76
+ }
77
+ async function verifyIdToken(idToken, jwksUri, args) {
78
+ const jwks = createRemoteJWKSet2(new URL(jwksUri));
79
+ const { payload } = await jwtVerify2(idToken, jwks, {
80
+ issuer: args.iss,
81
+ audience: args.aud,
82
+ algorithms: ["ES256"]
83
+ });
84
+ if (payload.nonce !== args.nonce) throw new Error("id token nonce mismatch");
85
+ return payload;
86
+ }
87
+ async function finishLogin(opts, args) {
88
+ const discovery = await ensureDiscovery2(opts.endpoint);
89
+ const token = await postFormBasic(discovery.tokenEndpoint, opts.clientId, opts.clientSecret, {
90
+ grant_type: "authorization_code",
91
+ code: args.code,
92
+ redirect_uri: opts.redirectUri,
93
+ code_verifier: args.codeVerifier
94
+ });
95
+ const claims = await verifyIdToken(token.id_token, discovery.jwksUri, {
96
+ iss: opts.endpoint,
97
+ aud: opts.clientId,
98
+ nonce: args.expectedNonce
99
+ });
100
+ return {
101
+ sub: claims.sub,
102
+ org_id: claims.org_id,
103
+ // required; ID token claim name is org_id only
104
+ sid: claims.sid,
105
+ access_token: token.access_token,
106
+ refresh_token: token.refresh_token,
107
+ expires_at: new Date(Date.now() + token.expires_in * 1e3).toISOString(),
108
+ profile: claims
109
+ };
110
+ }
111
+
112
+ // src/session.ts
113
+ import { EncryptJWT, jwtDecrypt } from "jose";
114
+ var COOKIE = "teqconnect_session";
115
+ var MAX_AGE_SECONDS = 43200;
116
+ function cookieOptions(redirectUri) {
117
+ const secure = typeof redirectUri === "string" ? redirectUri.startsWith("https:") : true;
118
+ return { httpOnly: true, secure, sameSite: "lax", path: "/", maxAge: MAX_AGE_SECONDS * 1e3 };
119
+ }
120
+ function key(opts) {
121
+ return opts.sessionSecret.subarray(0, 32);
122
+ }
123
+ async function seal(opts, payload) {
124
+ return new EncryptJWT({ ...payload }).setProtectedHeader({ alg: "dir", enc: "A256GCM" }).setIssuedAt().encrypt(key(opts));
125
+ }
126
+ async function openCookie(opts, cookie) {
127
+ if (!cookie) return null;
128
+ try {
129
+ const { payload } = await jwtDecrypt(cookie, key(opts), { maxTokenAge: MAX_AGE_SECONDS });
130
+ return payload;
131
+ } catch {
132
+ return null;
133
+ }
134
+ }
135
+
136
+ // src/userClient.ts
137
+ import {
138
+ AuthenticationError as AuthenticationError2,
139
+ ensureDiscovery as ensureDiscovery3,
140
+ LoginRequired,
141
+ resolveOptions,
142
+ TeqConnect
143
+ } from "@teqconnect/sdk";
144
+ function secondsLeft(expiresAt) {
145
+ return (Date.parse(expiresAt) - Date.now()) / 1e3;
146
+ }
147
+ function replaceTokens(payload, token) {
148
+ return {
149
+ ...payload,
150
+ access_token: token.access_token,
151
+ refresh_token: token.refresh_token ?? payload.refresh_token,
152
+ expires_at: new Date(Date.now() + token.expires_in * 1e3).toISOString()
153
+ };
154
+ }
155
+ var AppSessionCredentials = class {
156
+ constructor(opts, payload, persist) {
157
+ this.opts = opts;
158
+ this.payload = payload;
159
+ this.persist = persist;
160
+ }
161
+ opts;
162
+ payload;
163
+ persist;
164
+ source = "app_session";
165
+ static = false;
166
+ chain = Promise.resolve();
167
+ async getToken() {
168
+ const run = this.chain.then(async () => {
169
+ if (secondsLeft(this.payload.expires_at) >= 60) return this.payload.access_token;
170
+ if (!this.payload.refresh_token) throw new LoginRequired({ message: "sign in again" });
171
+ const discovery = await ensureDiscovery3(this.opts.endpoint);
172
+ let token;
173
+ try {
174
+ token = await postFormBasic(discovery.tokenEndpoint, this.opts.clientId, this.opts.clientSecret, {
175
+ grant_type: "refresh_token",
176
+ refresh_token: this.payload.refresh_token
177
+ });
178
+ } catch (err) {
179
+ if (err instanceof AuthenticationError2 && err.oauthError === "invalid_grant") {
180
+ throw new LoginRequired({ message: "sign in again" });
181
+ }
182
+ throw err;
183
+ }
184
+ this.payload = replaceTokens(this.payload, token);
185
+ await this.persist(this.payload);
186
+ return this.payload.access_token;
187
+ });
188
+ this.chain = run.then(
189
+ () => void 0,
190
+ () => void 0
191
+ );
192
+ return run;
193
+ }
194
+ async forceRefresh() {
195
+ this.payload = { ...this.payload, expires_at: (/* @__PURE__ */ new Date(0)).toISOString() };
196
+ await this.getToken();
197
+ }
198
+ };
199
+ function forUser(opts, payload, args) {
200
+ const options = resolveOptions({ endpoint: opts.endpoint });
201
+ const credentials = new AppSessionCredentials(opts, payload, args.persist);
202
+ return TeqConnect._fromCredentials(options, credentials);
203
+ }
204
+
205
+ // src/middleware.ts
206
+ var OIDC_COOKIE = "teqconnect_oidc";
207
+ var OIDC_MAX_AGE_SECONDS = 600;
208
+ function key2(opts) {
209
+ return opts.sessionSecret.subarray(0, 32);
210
+ }
211
+ async function sealOidc(opts, state) {
212
+ return new EncryptJWT2({ ...state }).setProtectedHeader({ alg: "dir", enc: "A256GCM" }).setIssuedAt().encrypt(key2(opts));
213
+ }
214
+ async function openOidc(opts, cookie) {
215
+ if (!cookie) return null;
216
+ try {
217
+ const { payload } = await jwtDecrypt2(cookie, key2(opts), { maxTokenAge: OIDC_MAX_AGE_SECONDS });
218
+ return payload;
219
+ } catch {
220
+ return null;
221
+ }
222
+ }
223
+ function revocationId(claims) {
224
+ return `${claims.sub ?? ""}|${claims.sid ?? ""}`;
225
+ }
226
+ function teqAuth(opts, hooks) {
227
+ const revoked = /* @__PURE__ */ new Set();
228
+ return {
229
+ async login(req, res) {
230
+ const state = randomBytes(16).toString("base64url");
231
+ const nonce = randomBytes(16).toString("base64url");
232
+ const codeVerifier = pkceVerifier();
233
+ res.cookie(OIDC_COOKIE, await sealOidc(opts, { state, nonce, codeVerifier }), {
234
+ ...cookieOptions(opts.redirectUri),
235
+ // Express cookie maxAge is milliseconds; OIDC_MAX_AGE_SECONDS is seconds.
236
+ maxAge: OIDC_MAX_AGE_SECONDS * 1e3
237
+ });
238
+ res.redirect(await beginLogin(opts, { state, nonce, codeVerifier }));
239
+ },
240
+ async callback(req, res) {
241
+ const oauthError = typeof req.query.error === "string" ? req.query.error : void 0;
242
+ if (oauthError) {
243
+ const description = typeof req.query.error_description === "string" ? req.query.error_description : void 0;
244
+ res.status(400).type("html").send(
245
+ `<h1>Sign-in failed</h1><p><code>${oauthError}</code>${description ? `: ${description}` : ""}</p><p><a href="/auth/login">Try again</a></p>`
246
+ );
247
+ return;
248
+ }
249
+ const pending = await openOidc(opts, req.cookies?.[OIDC_COOKIE]);
250
+ const code = typeof req.query.code === "string" ? req.query.code : void 0;
251
+ const state = typeof req.query.state === "string" ? req.query.state : void 0;
252
+ if (!pending || !code || state !== pending.state) {
253
+ res.status(400).json({ error: "invalid_login_state" });
254
+ return;
255
+ }
256
+ const payload = await finishLogin(opts, {
257
+ code,
258
+ codeVerifier: pending.codeVerifier,
259
+ expectedNonce: pending.nonce
260
+ });
261
+ res.cookie(COOKIE, await seal(opts, payload), cookieOptions(opts.redirectUri));
262
+ res.clearCookie(OIDC_COOKIE, { ...cookieOptions(opts.redirectUri), maxAge: 0 });
263
+ await hooks.onSignedIn(payload);
264
+ res.redirect("/");
265
+ },
266
+ async logout(req, res) {
267
+ const base = { httpOnly: true, sameSite: "lax", path: "/", maxAge: 0 };
268
+ res.clearCookie(COOKIE, { ...base, secure: true });
269
+ res.clearCookie(COOKIE, { ...base, secure: false });
270
+ res.clearCookie(OIDC_COOKIE, { ...base, secure: true });
271
+ res.clearCookie(OIDC_COOKIE, { ...base, secure: false });
272
+ const appDest = opts.postLogoutRedirectUri ?? "/?signedout=1";
273
+ const portalSignOut = `${opts.endpoint.replace(/\/$/, "")}/auth/sign-out?post_logout_redirect_uri=${encodeURIComponent(appDest)}`;
274
+ try {
275
+ const discovery = await ensureDiscovery4(opts.endpoint);
276
+ if (discovery.endSessionEndpoint) {
277
+ const url = new URL(discovery.endSessionEndpoint);
278
+ url.searchParams.set("client_id", opts.clientId);
279
+ url.searchParams.set("post_logout_redirect_uri", portalSignOut);
280
+ res.redirect(url.toString());
281
+ return;
282
+ }
283
+ } catch {
284
+ }
285
+ res.redirect(portalSignOut);
286
+ },
287
+ async requireUser(req, res, next) {
288
+ const payload = await openCookie(opts, req.cookies?.[COOKIE]);
289
+ if (!payload || revoked.has(revocationId(payload))) {
290
+ res.status(401).json({ error: "login_required" });
291
+ return;
292
+ }
293
+ req.teqUser = payload;
294
+ next();
295
+ },
296
+ async forUser(req, res) {
297
+ const payload = await openCookie(opts, req.cookies?.[COOKIE]);
298
+ if (!payload || revoked.has(revocationId(payload))) throw new LoginRequired2({ message: "sign in again" });
299
+ return forUser(opts, payload, {
300
+ persist: async (next) => {
301
+ if (res) res.cookie(COOKIE, await seal(opts, next), cookieOptions(opts.redirectUri));
302
+ }
303
+ });
304
+ },
305
+ async backchannelLogout(req, res) {
306
+ const logoutToken = typeof req.body?.logout_token === "string" ? req.body.logout_token : void 0;
307
+ if (!logoutToken) {
308
+ res.status(400).json({ error: "missing_logout_token" });
309
+ return;
310
+ }
311
+ try {
312
+ const claims = await verifyLogoutToken(opts, logoutToken);
313
+ await applyLogout(opts, claims, (c) => {
314
+ revoked.add(revocationId(c));
315
+ });
316
+ res.status(200).end();
317
+ } catch {
318
+ res.status(400).json({ error: "invalid_logout_token" });
319
+ }
320
+ }
321
+ };
322
+ }
323
+
324
+ // src/options.ts
325
+ var ENV_ENDPOINTS = {
326
+ test: "https://test.tccloud.io",
327
+ staging: "https://staging.tccloud.io",
328
+ prod: "https://tccloud.io"
329
+ };
330
+ function envEndpoint() {
331
+ if (process.env.TEQCONNECT_ENDPOINT) return process.env.TEQCONNECT_ENDPOINT;
332
+ const env = process.env.TEQCONNECT_ENV;
333
+ if (env && ENV_ENDPOINTS[env]) return ENV_ENDPOINTS[env];
334
+ return void 0;
335
+ }
336
+ function toSecret(value) {
337
+ if (!value) throw new Error("TEQCONNECT_SESSION_SECRET (or sessionSecret) is required");
338
+ const secret = typeof value === "string" ? Buffer.from(value, "utf8") : value;
339
+ if (secret.length < 32) throw new Error("session secret must be at least 32 bytes");
340
+ return secret;
341
+ }
342
+ function resolveAppOptions(overrides = {}) {
343
+ const endpoint = overrides.endpoint ?? envEndpoint();
344
+ if (!endpoint) throw new Error("endpoint is missing: set endpoint, TEQCONNECT_ENDPOINT, or TEQCONNECT_ENV");
345
+ const clientId = overrides.clientId ?? process.env.TEQCONNECT_APP_CLIENT_ID;
346
+ const clientSecret = overrides.clientSecret ?? process.env.TEQCONNECT_APP_CLIENT_SECRET;
347
+ const redirectUri = overrides.redirectUri ?? process.env.TEQCONNECT_APP_REDIRECT_URI;
348
+ if (!clientId || !clientSecret || !redirectUri) {
349
+ throw new Error("client id, client secret, and redirect uri are required");
350
+ }
351
+ return {
352
+ endpoint,
353
+ clientId,
354
+ clientSecret,
355
+ redirectUri,
356
+ sessionSecret: toSecret(overrides.sessionSecret ?? process.env.TEQCONNECT_SESSION_SECRET),
357
+ postLogoutRedirectUri: overrides.postLogoutRedirectUri ?? process.env.TEQCONNECT_APP_POST_LOGOUT_REDIRECT_URI,
358
+ extraScopes: overrides.extraScopes ?? process.env.TEQCONNECT_APP_SCOPES ?? ""
359
+ };
360
+ }
361
+
362
+ // src/webhook.ts
363
+ import { WebhookVerificationError } from "@teqconnect/sdk";
364
+ import { verifyWebhook } from "@teqconnect/sdk/webhooks";
365
+ function expressRawBody() {
366
+ return (req, _res, next) => {
367
+ const chunks = [];
368
+ req.on("data", (chunk) => {
369
+ chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
370
+ });
371
+ req.on("end", () => {
372
+ req.rawBody = Buffer.concat(chunks);
373
+ next();
374
+ });
375
+ req.on("error", next);
376
+ };
377
+ }
378
+ function verifyExpressWebhook(req, secret) {
379
+ const raw = req.rawBody;
380
+ if (!raw) {
381
+ throw new WebhookVerificationError({
382
+ code: "MISSING_RAW_BODY",
383
+ message: "raw body required"
384
+ });
385
+ }
386
+ return verifyWebhook({
387
+ secret,
388
+ rawBody: raw,
389
+ signature: String(req.headers["teqconnect-signature"] || ""),
390
+ timestamp: String(req.headers["teqconnect-timestamp"] || "")
391
+ });
392
+ }
393
+ export {
394
+ AppSessionCredentials,
395
+ COOKIE,
396
+ WebhookVerificationError,
397
+ appScope,
398
+ beginLogin,
399
+ expressRawBody,
400
+ finishLogin,
401
+ forUser,
402
+ openCookie,
403
+ replaceTokens,
404
+ resolveAppOptions,
405
+ teqAuth,
406
+ verifyExpressWebhook,
407
+ verifyIdToken,
408
+ verifyLogoutToken
409
+ };
410
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/middleware.ts","../src/backchannel.ts","../src/oidc.ts","../src/session.ts","../src/userClient.ts","../src/options.ts","../src/webhook.ts"],"sourcesContent":["// Express adapter. The same six operations as Flask and FastAPI: login, callback, logout,\n// requireUser, forUser, backchannelLogout. Adapter only — shared behavior lives in\n// oidc/session/backchannel/userClient. Do not add a parallel auth surface.\n\nimport { randomBytes } from \"node:crypto\";\nimport { ensureDiscovery, LoginRequired, pkceVerifier, type TeqConnect } from \"@teqconnect/sdk\";\nimport { EncryptJWT, jwtDecrypt } from \"jose\";\nimport type { NextFunction, Request, Response } from \"express\";\nimport { applyLogout, type LogoutClaims, verifyLogoutToken } from \"./backchannel\";\nimport { beginLogin, finishLogin } from \"./oidc\";\nimport type { AppAuthOptions } from \"./options\";\nimport { COOKIE, cookieOptions, openCookie, seal, type SessionPayload } from \"./session\";\nimport { forUser as buildUserClient } from \"./userClient\";\n\n/** First sign-in: the app owns Local | TeqConnect | Both. The SDK does not create portal users. */\nexport type OnSignedIn = (payload: SessionPayload) => void | Promise<void>;\n\nexport interface TeqAuthHooks {\n onSignedIn: OnSignedIn;\n}\n\nconst OIDC_COOKIE = \"teqconnect_oidc\";\n/** Login-transaction lifetime in seconds (jose maxTokenAge). */\nconst OIDC_MAX_AGE_SECONDS = 600;\n\ninterface OidcState {\n state: string;\n nonce: string;\n codeVerifier: string;\n}\n\nfunction key(opts: AppAuthOptions): Uint8Array {\n return opts.sessionSecret.subarray(0, 32);\n}\n\nasync function sealOidc(opts: AppAuthOptions, state: OidcState): Promise<string> {\n return new EncryptJWT({ ...state })\n .setProtectedHeader({ alg: \"dir\", enc: \"A256GCM\" })\n .setIssuedAt()\n .encrypt(key(opts));\n}\n\nasync function openOidc(opts: AppAuthOptions, cookie: string | undefined): Promise<OidcState | null> {\n if (!cookie) return null;\n try {\n const { payload } = await jwtDecrypt(cookie, key(opts), { maxTokenAge: OIDC_MAX_AGE_SECONDS });\n return payload as unknown as OidcState;\n } catch {\n return null;\n }\n}\n\nfunction revocationId(claims: { sub?: string; sid?: string }): string {\n return `${claims.sub ?? \"\"}|${claims.sid ?? \"\"}`;\n}\n\nexport function teqAuth(opts: AppAuthOptions, hooks: TeqAuthHooks) {\n // Adapter-supplied store for back-channel logout (sub|sid revocation set).\n const revoked = new Set<string>();\n\n return {\n async login(req: Request, res: Response): Promise<void> {\n const state = randomBytes(16).toString(\"base64url\");\n const nonce = randomBytes(16).toString(\"base64url\");\n const codeVerifier = pkceVerifier();\n res.cookie(OIDC_COOKIE, await sealOidc(opts, { state, nonce, codeVerifier }), {\n ...cookieOptions(opts.redirectUri),\n // Express cookie maxAge is milliseconds; OIDC_MAX_AGE_SECONDS is seconds.\n maxAge: OIDC_MAX_AGE_SECONDS * 1000,\n });\n res.redirect(await beginLogin(opts, { state, nonce, codeVerifier }));\n },\n\n async callback(req: Request, res: Response): Promise<void> {\n const oauthError = typeof req.query.error === \"string\" ? req.query.error : undefined;\n if (oauthError) {\n const description =\n typeof req.query.error_description === \"string\" ? req.query.error_description : undefined;\n res.status(400).type(\"html\").send(\n `<h1>Sign-in failed</h1><p><code>${oauthError}</code>${description ? `: ${description}` : \"\"}</p>` +\n `<p><a href=\"/auth/login\">Try again</a></p>`,\n );\n return;\n }\n const pending = await openOidc(opts, req.cookies?.[OIDC_COOKIE]);\n const code = typeof req.query.code === \"string\" ? req.query.code : undefined;\n const state = typeof req.query.state === \"string\" ? req.query.state : undefined;\n if (!pending || !code || state !== pending.state) {\n res.status(400).json({ error: \"invalid_login_state\" });\n return;\n }\n const payload = await finishLogin(opts, {\n code,\n codeVerifier: pending.codeVerifier,\n expectedNonce: pending.nonce,\n });\n res.cookie(COOKIE, await seal(opts, payload), cookieOptions(opts.redirectUri));\n res.clearCookie(OIDC_COOKIE, { ...cookieOptions(opts.redirectUri), maxAge: 0 });\n await hooks.onSignedIn(payload);\n res.redirect(\"/\");\n },\n\n async logout(req: Request, res: Response): Promise<void> {\n // Clear both Secure and non-Secure variants so http://localhost samples drop\n // cookies that were previously set with Secure=true.\n const base = { httpOnly: true, sameSite: \"lax\" as const, path: \"/\", maxAge: 0 };\n res.clearCookie(COOKIE, { ...base, secure: true });\n res.clearCookie(COOKIE, { ...base, secure: false });\n res.clearCookie(OIDC_COOKIE, { ...base, secure: true });\n res.clearCookie(OIDC_COOKIE, { ...base, secure: false });\n // App confirmation page after the portal finishes signing out.\n const appDest = opts.postLogoutRedirectUri ?? \"/?signedout=1\";\n // end_session → /auth/sign-out (clears portal localStorage) → appDest.\n // Clearing only the OIDC cookie is not enough: a stale portal token makes\n // /auth/sign-in auto-continue and bounce straight back to the app.\n // Build with one encodeURIComponent so it matches the registered client URI.\n const portalSignOut =\n `${opts.endpoint.replace(/\\/$/, \"\")}/auth/sign-out` +\n `?post_logout_redirect_uri=${encodeURIComponent(appDest)}`;\n try {\n const discovery = await ensureDiscovery(opts.endpoint);\n if (discovery.endSessionEndpoint) {\n const url = new URL(discovery.endSessionEndpoint);\n url.searchParams.set(\"client_id\", opts.clientId);\n url.searchParams.set(\"post_logout_redirect_uri\", portalSignOut);\n res.redirect(url.toString());\n return;\n }\n } catch {\n // Fall through to portal sign-out without end_session.\n }\n res.redirect(portalSignOut);\n },\n\n async requireUser(req: Request, res: Response, next: NextFunction): Promise<void> {\n const payload = await openCookie(opts, req.cookies?.[COOKIE]);\n if (!payload || revoked.has(revocationId(payload))) {\n res.status(401).json({ error: \"login_required\" });\n return;\n }\n (req as Request & { teqUser?: SessionPayload }).teqUser = payload;\n next();\n },\n\n async forUser(req: Request, res?: Response): Promise<TeqConnect> {\n const payload = await openCookie(opts, req.cookies?.[COOKIE]);\n if (!payload || revoked.has(revocationId(payload))) throw new LoginRequired({ message: \"sign in again\" });\n return buildUserClient(opts, payload, {\n persist: async (next) => {\n if (res) res.cookie(COOKIE, await seal(opts, next), cookieOptions(opts.redirectUri));\n },\n });\n },\n\n async backchannelLogout(req: Request, res: Response): Promise<void> {\n const logoutToken =\n typeof req.body?.logout_token === \"string\" ? req.body.logout_token : undefined;\n if (!logoutToken) {\n res.status(400).json({ error: \"missing_logout_token\" });\n return;\n }\n try {\n const claims: LogoutClaims = await verifyLogoutToken(opts, logoutToken);\n await applyLogout(opts, claims, (c) => {\n revoked.add(revocationId(c));\n });\n res.status(200).end();\n } catch {\n res.status(400).json({ error: \"invalid_logout_token\" });\n }\n },\n };\n}\n","// Back-channel logout. One-to-one with Python auth/backchannel.py.\n\nimport { AuthenticationError, ensureDiscovery } from \"@teqconnect/sdk\";\nimport { createRemoteJWKSet, jwtVerify } from \"jose\";\nimport type { AppAuthOptions } from \"./options\";\n\nconst BACKCHANNEL_EVENT = \"http://schemas.openid.net/event/backchannel-logout\";\n\nexport interface LogoutClaims {\n sub: string;\n sid: string;\n}\n\n/** JWKS verify; require events backchannel-logout, sub, and sid. */\nexport async function verifyLogoutToken(opts: AppAuthOptions, logoutToken: string): Promise<LogoutClaims> {\n const discovery = await ensureDiscovery(opts.endpoint);\n const jwks = createRemoteJWKSet(new URL(discovery.jwksUri));\n let payload: Record<string, unknown>;\n try {\n ({ payload } = (await jwtVerify(logoutToken, jwks, {\n issuer: opts.endpoint,\n audience: opts.clientId,\n algorithms: [\"ES256\"],\n })) as { payload: Record<string, unknown> });\n } catch (err) {\n throw new AuthenticationError({ message: `invalid logout token: ${(err as Error).message}` });\n }\n const events = payload.events as Record<string, unknown> | undefined;\n if (!events || !(BACKCHANNEL_EVENT in events)) {\n throw new AuthenticationError({ message: \"logout token missing backchannel-logout event\" });\n }\n if (!payload.sub || !payload.sid) {\n throw new AuthenticationError({ message: \"logout token missing sub or sid\" });\n }\n return { sub: payload.sub as string, sid: payload.sid as string };\n}\n\nexport type SessionStore = (claims: LogoutClaims) => void | Promise<void>;\n\n/** Clear any sealed session matching sub/sid. The adapter supplies the store. */\nexport async function applyLogout(\n _opts: AppAuthOptions,\n claims: LogoutClaims,\n clear: SessionStore,\n): Promise<void> {\n await clear(claims);\n}\n","// Shared OIDC for the app sign-in plugin. No second OIDC client inside @teqconnect/sdk; the\n// authorization-code flow lives here. ensureDiscovery / pkce* come from @teqconnect/sdk.\n// One-to-one with Python auth/oidc.py.\n\nimport { ensureDiscovery, pkceS256 } from \"@teqconnect/sdk\";\nimport { createRemoteJWKSet, jwtVerify } from \"jose\";\nimport type { AppAuthOptions } from \"./options\";\nimport type { SessionPayload } from \"./session\";\n\ninterface TokenResponse {\n access_token: string;\n id_token: string;\n refresh_token?: string;\n token_type?: string;\n expires_in: number;\n scope?: string;\n}\n\n/** The app scope string always includes openid, profile, email, and offline_access. */\nexport function appScope(extra = \"\"): string {\n return \"openid profile email offline_access\" + (extra ? \" \" + extra : \"\");\n}\n\nexport function authorizationUrl(authorizationEndpoint: string, params: Record<string, string>): string {\n const query = new URLSearchParams(params);\n return `${authorizationEndpoint}?${query.toString()}`;\n}\n\nexport async function beginLogin(\n opts: AppAuthOptions,\n args: { state: string; nonce: string; codeVerifier: string },\n): Promise<string> {\n const discovery = await ensureDiscovery(opts.endpoint);\n const challenge = pkceS256(args.codeVerifier);\n return authorizationUrl(discovery.authorizationEndpoint, {\n response_type: \"code\",\n client_id: opts.clientId,\n redirect_uri: opts.redirectUri,\n scope: appScope(opts.extraScopes),\n state: args.state,\n nonce: args.nonce,\n code_challenge: challenge,\n code_challenge_method: \"S256\",\n });\n}\n\n/** POST the token endpoint with client_secret_basic (web clients only). */\nexport async function postFormBasic(\n url: string,\n clientId: string,\n clientSecret: string,\n body: Record<string, string>,\n): Promise<TokenResponse> {\n const auth = Buffer.from(`${clientId}:${clientSecret}`).toString(\"base64\");\n const res = await fetch(url, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n Authorization: \"Basic \" + auth,\n Accept: \"application/json\",\n },\n body: new URLSearchParams(body),\n });\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const json: any = await res.json().catch(() => ({}));\n if (!res.ok || json?.error) {\n throw new Error(json?.error_description ?? json?.error ?? `token endpoint error ${res.status}`);\n }\n return json as TokenResponse;\n}\n\n/** Verify alg ES256, kid in JWKS, signature, iss, aud, nonce, and exp. */\nexport async function verifyIdToken(\n idToken: string,\n jwksUri: string,\n args: { iss: string; aud: string; nonce: string },\n): Promise<Record<string, unknown>> {\n const jwks = createRemoteJWKSet(new URL(jwksUri));\n const { payload } = await jwtVerify(idToken, jwks, {\n issuer: args.iss,\n audience: args.aud,\n algorithms: [\"ES256\"],\n });\n if (payload.nonce !== args.nonce) throw new Error(\"id token nonce mismatch\");\n return payload as Record<string, unknown>;\n}\n\nexport async function finishLogin(\n opts: AppAuthOptions,\n args: { code: string; codeVerifier: string; expectedNonce: string },\n): Promise<SessionPayload> {\n const discovery = await ensureDiscovery(opts.endpoint);\n const token = await postFormBasic(discovery.tokenEndpoint, opts.clientId, opts.clientSecret, {\n grant_type: \"authorization_code\",\n code: args.code,\n redirect_uri: opts.redirectUri,\n code_verifier: args.codeVerifier,\n });\n const claims = await verifyIdToken(token.id_token, discovery.jwksUri, {\n iss: opts.endpoint,\n aud: opts.clientId,\n nonce: args.expectedNonce,\n });\n return {\n sub: claims.sub as string,\n org_id: claims.org_id as string, // required; ID token claim name is org_id only\n sid: claims.sid as string | undefined,\n access_token: token.access_token,\n refresh_token: token.refresh_token,\n expires_at: new Date(Date.now() + token.expires_in * 1000).toISOString(),\n profile: claims,\n };\n}\n","// Encrypted session cookie. One-to-one with Python auth/session.py.\n//\n// Cookie name teqconnect_session. HttpOnly Secure SameSite=Lax Path=/ Max-Age=43200.\n// The browser never receives the tokens in a script-readable field.\n\nimport { EncryptJWT, jwtDecrypt } from \"jose\";\nimport type { AppAuthOptions } from \"./options\";\n\nexport const COOKIE = \"teqconnect_session\";\n/** HTTP Max-Age / jose maxTokenAge, in seconds (12 hours). */\nconst MAX_AGE_SECONDS = 43200;\n\n/** Locked fields. profile is the ID-token claims map; sid is present when the token carries it. */\nexport interface SessionPayload {\n sub: string;\n org_id: string;\n access_token: string;\n refresh_token?: string;\n /** Access-token expiry, ISO-8601. */\n expires_at: string;\n /** ID-token claims map. */\n profile: Record<string, unknown>;\n sid?: string;\n}\n\nexport interface CookieOptions {\n httpOnly: boolean;\n secure: boolean;\n sameSite: \"lax\";\n path: string;\n /** Express cookie maxAge is milliseconds. */\n maxAge: number;\n}\n\n/** Secure only when the app redirect URI is https (http://localhost samples cannot set Secure cookies in some browsers). */\nexport function cookieOptions(redirectUri?: string): CookieOptions {\n // Plan Max-Age is 43200 seconds; Express wants milliseconds.\n const secure = typeof redirectUri === \"string\" ? redirectUri.startsWith(\"https:\") : true;\n return { httpOnly: true, secure, sameSite: \"lax\", path: \"/\", maxAge: MAX_AGE_SECONDS * 1000 };\n}\n\nfunction key(opts: AppAuthOptions): Uint8Array {\n // A256GCM needs a 32-byte key; the session secret is at least 32 bytes.\n return opts.sessionSecret.subarray(0, 32);\n}\n\n/** Encrypt the payload; issued_at lets open_cookie enforce the 12h lifetime. */\nexport async function seal(opts: AppAuthOptions, payload: SessionPayload): Promise<string> {\n return new EncryptJWT({ ...payload } as unknown as Record<string, unknown>)\n .setProtectedHeader({ alg: \"dir\", enc: \"A256GCM\" })\n .setIssuedAt()\n .encrypt(key(opts));\n}\n\n/** Decrypt; return null if missing, tampered, or older than Max-Age 43200. */\nexport async function openCookie(opts: AppAuthOptions, cookie: string | undefined): Promise<SessionPayload | null> {\n if (!cookie) return null;\n try {\n const { payload } = await jwtDecrypt(cookie, key(opts), { maxTokenAge: MAX_AGE_SECONDS });\n return payload as unknown as SessionPayload;\n } catch {\n return null;\n }\n}\n\n/** Cookie clearing instructions for the adapter. */\nexport function clearCookie(redirectUri?: string): { name: string; options: CookieOptions } {\n return { name: COOKIE, options: { ...cookieOptions(redirectUri), maxAge: 0 } };\n}\n","// App-session credentials and forUser. One-to-one with Python auth/user_client.py.\n//\n// for_user returns a TeqConnect built only via _fromCredentials with AppSessionCredentials;\n// it refreshes with grant_type=refresh_token plus client_secret_basic. This does not read\n// ~/.teqconnect and does not enter chain.resolve.\n\nimport {\n AuthenticationError,\n ensureDiscovery,\n LoginRequired,\n resolveOptions,\n TeqConnect,\n type Credentials,\n} from \"@teqconnect/sdk\";\nimport { postFormBasic } from \"./oidc\";\nimport type { AppAuthOptions } from \"./options\";\nimport type { SessionPayload } from \"./session\";\n\nexport type PersistSession = (payload: SessionPayload) => void | Promise<void>;\n\nfunction secondsLeft(expiresAt: string): number {\n return (Date.parse(expiresAt) - Date.now()) / 1000;\n}\n\ninterface RefreshResponse {\n access_token: string;\n refresh_token?: string;\n expires_in: number;\n}\n\n/** Replace the access/refresh tokens and expiry; keep sub/org/profile. */\nexport function replaceTokens(payload: SessionPayload, token: RefreshResponse): SessionPayload {\n return {\n ...payload,\n access_token: token.access_token,\n refresh_token: token.refresh_token ?? payload.refresh_token,\n expires_at: new Date(Date.now() + token.expires_in * 1000).toISOString(),\n };\n}\n\nexport class AppSessionCredentials implements Credentials {\n readonly source = \"app_session\";\n readonly static = false;\n private chain: Promise<unknown> = Promise.resolve();\n\n constructor(\n private readonly opts: AppAuthOptions,\n public payload: SessionPayload,\n private readonly persist: PersistSession,\n ) {}\n\n async getToken(): Promise<string> {\n const run = this.chain.then(async () => {\n if (secondsLeft(this.payload.expires_at) >= 60) return this.payload.access_token;\n if (!this.payload.refresh_token) throw new LoginRequired({ message: \"sign in again\" });\n const discovery = await ensureDiscovery(this.opts.endpoint);\n let token: RefreshResponse;\n try {\n token = await postFormBasic(discovery.tokenEndpoint, this.opts.clientId, this.opts.clientSecret, {\n grant_type: \"refresh_token\",\n refresh_token: this.payload.refresh_token,\n });\n } catch (err) {\n if (err instanceof AuthenticationError && err.oauthError === \"invalid_grant\") {\n throw new LoginRequired({ message: \"sign in again\" });\n }\n throw err;\n }\n this.payload = replaceTokens(this.payload, token);\n await this.persist(this.payload);\n return this.payload.access_token;\n });\n this.chain = run.then(\n () => undefined,\n () => undefined,\n );\n return run;\n }\n\n async forceRefresh(): Promise<void> {\n this.payload = { ...this.payload, expires_at: new Date(0).toISOString() };\n await this.getToken();\n }\n}\n\n/** Build a per-request TeqConnect bound to the user's session. */\nexport function forUser(opts: AppAuthOptions, payload: SessionPayload, args: { persist: PersistSession }): TeqConnect {\n const options = resolveOptions({ endpoint: opts.endpoint });\n const credentials = new AppSessionCredentials(opts, payload, args.persist);\n // _fromCredentials is package-private (@internal); it is the only entry for app sessions.\n return (TeqConnect as unknown as {\n _fromCredentials(o: typeof options, c: Credentials): TeqConnect;\n })._fromCredentials(options, credentials);\n}\n","// App sign-in options. Code options win over TEQCONNECT_APP_* / ENDPOINT / ENV.\n// One-to-one with Python auth/options.py.\n\nexport interface AppAuthOptions {\n endpoint: string;\n clientId: string;\n clientSecret: string;\n redirectUri: string;\n /** At least 32 random bytes. */\n sessionSecret: Buffer;\n postLogoutRedirectUri?: string;\n extraScopes: string;\n}\n\nexport interface AppAuthOverrides {\n endpoint?: string;\n clientId?: string;\n clientSecret?: string;\n redirectUri?: string;\n sessionSecret?: Buffer | string;\n postLogoutRedirectUri?: string;\n extraScopes?: string;\n}\n\nconst ENV_ENDPOINTS: Record<string, string> = {\n test: \"https://test.tccloud.io\",\n staging: \"https://staging.tccloud.io\",\n prod: \"https://tccloud.io\",\n};\n\nfunction envEndpoint(): string | undefined {\n if (process.env.TEQCONNECT_ENDPOINT) return process.env.TEQCONNECT_ENDPOINT;\n const env = process.env.TEQCONNECT_ENV;\n if (env && ENV_ENDPOINTS[env]) return ENV_ENDPOINTS[env];\n return undefined;\n}\n\nfunction toSecret(value: Buffer | string | undefined): Buffer {\n if (!value) throw new Error(\"TEQCONNECT_SESSION_SECRET (or sessionSecret) is required\");\n const secret = typeof value === \"string\" ? Buffer.from(value, \"utf8\") : value;\n if (secret.length < 32) throw new Error(\"session secret must be at least 32 bytes\");\n return secret;\n}\n\nexport function resolveAppOptions(overrides: AppAuthOverrides = {}): AppAuthOptions {\n const endpoint = overrides.endpoint ?? envEndpoint();\n if (!endpoint) throw new Error(\"endpoint is missing: set endpoint, TEQCONNECT_ENDPOINT, or TEQCONNECT_ENV\");\n const clientId = overrides.clientId ?? process.env.TEQCONNECT_APP_CLIENT_ID;\n const clientSecret = overrides.clientSecret ?? process.env.TEQCONNECT_APP_CLIENT_SECRET;\n const redirectUri = overrides.redirectUri ?? process.env.TEQCONNECT_APP_REDIRECT_URI;\n if (!clientId || !clientSecret || !redirectUri) {\n throw new Error(\"client id, client secret, and redirect uri are required\");\n }\n return {\n endpoint,\n clientId,\n clientSecret,\n redirectUri,\n sessionSecret: toSecret(overrides.sessionSecret ?? process.env.TEQCONNECT_SESSION_SECRET),\n postLogoutRedirectUri: overrides.postLogoutRedirectUri ?? process.env.TEQCONNECT_APP_POST_LOGOUT_REDIRECT_URI,\n extraScopes: overrides.extraScopes ?? process.env.TEQCONNECT_APP_SCOPES ?? \"\",\n };\n}\n","// Express raw-body capture + verifyWebhook helper. Not OIDC / tc.auth.\n\nimport type { NextFunction, Request, RequestHandler, Response } from \"express\";\nimport { WebhookVerificationError } from \"@teqconnect/sdk\";\nimport { verifyWebhook, type WebhookEvent } from \"@teqconnect/sdk/webhooks\";\n\ntype RawBodyRequest = Request & { rawBody?: Buffer };\n\n/** Capture the exact request bytes on ``req.rawBody`` before JSON parsers run. */\nexport function expressRawBody(): RequestHandler {\n return (req: Request, _res: Response, next: NextFunction) => {\n const chunks: Buffer[] = [];\n req.on(\"data\", (chunk: Buffer | string) => {\n chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n });\n req.on(\"end\", () => {\n (req as RawBodyRequest).rawBody = Buffer.concat(chunks);\n next();\n });\n req.on(\"error\", next);\n };\n}\n\n/** Verify the TeqConnect webhook signature on an Express request that used ``expressRawBody``. */\nexport function verifyExpressWebhook(req: Request, secret: string | string[]): WebhookEvent {\n const raw = (req as RawBodyRequest).rawBody;\n if (!raw) {\n throw new WebhookVerificationError({\n code: \"MISSING_RAW_BODY\",\n message: \"raw body required\",\n });\n }\n return verifyWebhook({\n secret,\n rawBody: raw,\n signature: String(req.headers[\"teqconnect-signature\"] || \"\"),\n timestamp: String(req.headers[\"teqconnect-timestamp\"] || \"\"),\n });\n}\n\nexport { WebhookVerificationError, type WebhookEvent };\n"],"mappings":"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","names":["ensureDiscovery","LoginRequired","EncryptJWT","jwtDecrypt","ensureDiscovery","createRemoteJWKSet","jwtVerify","AuthenticationError","ensureDiscovery","ensureDiscovery","AuthenticationError","key","EncryptJWT","jwtDecrypt","ensureDiscovery","LoginRequired"]}
@@ -0,0 +1,17 @@
1
+ import { type TeqConnect } from "@teqconnect/sdk";
2
+ import type { NextFunction, Request, Response } from "express";
3
+ import type { AppAuthOptions } from "./options";
4
+ import { type SessionPayload } from "./session";
5
+ /** First sign-in: the app owns Local | TeqConnect | Both. The SDK does not create portal users. */
6
+ export type OnSignedIn = (payload: SessionPayload) => void | Promise<void>;
7
+ export interface TeqAuthHooks {
8
+ onSignedIn: OnSignedIn;
9
+ }
10
+ export declare function teqAuth(opts: AppAuthOptions, hooks: TeqAuthHooks): {
11
+ login(req: Request, res: Response): Promise<void>;
12
+ callback(req: Request, res: Response): Promise<void>;
13
+ logout(req: Request, res: Response): Promise<void>;
14
+ requireUser(req: Request, res: Response, next: NextFunction): Promise<void>;
15
+ forUser(req: Request, res?: Response): Promise<TeqConnect>;
16
+ backchannelLogout(req: Request, res: Response): Promise<void>;
17
+ };
package/dist/oidc.d.ts ADDED
@@ -0,0 +1,32 @@
1
+ import type { AppAuthOptions } from "./options";
2
+ import type { SessionPayload } from "./session";
3
+ interface TokenResponse {
4
+ access_token: string;
5
+ id_token: string;
6
+ refresh_token?: string;
7
+ token_type?: string;
8
+ expires_in: number;
9
+ scope?: string;
10
+ }
11
+ /** The app scope string always includes openid, profile, email, and offline_access. */
12
+ export declare function appScope(extra?: string): string;
13
+ export declare function authorizationUrl(authorizationEndpoint: string, params: Record<string, string>): string;
14
+ export declare function beginLogin(opts: AppAuthOptions, args: {
15
+ state: string;
16
+ nonce: string;
17
+ codeVerifier: string;
18
+ }): Promise<string>;
19
+ /** POST the token endpoint with client_secret_basic (web clients only). */
20
+ export declare function postFormBasic(url: string, clientId: string, clientSecret: string, body: Record<string, string>): Promise<TokenResponse>;
21
+ /** Verify alg ES256, kid in JWKS, signature, iss, aud, nonce, and exp. */
22
+ export declare function verifyIdToken(idToken: string, jwksUri: string, args: {
23
+ iss: string;
24
+ aud: string;
25
+ nonce: string;
26
+ }): Promise<Record<string, unknown>>;
27
+ export declare function finishLogin(opts: AppAuthOptions, args: {
28
+ code: string;
29
+ codeVerifier: string;
30
+ expectedNonce: string;
31
+ }): Promise<SessionPayload>;
32
+ export {};
@@ -0,0 +1,20 @@
1
+ export interface AppAuthOptions {
2
+ endpoint: string;
3
+ clientId: string;
4
+ clientSecret: string;
5
+ redirectUri: string;
6
+ /** At least 32 random bytes. */
7
+ sessionSecret: Buffer;
8
+ postLogoutRedirectUri?: string;
9
+ extraScopes: string;
10
+ }
11
+ export interface AppAuthOverrides {
12
+ endpoint?: string;
13
+ clientId?: string;
14
+ clientSecret?: string;
15
+ redirectUri?: string;
16
+ sessionSecret?: Buffer | string;
17
+ postLogoutRedirectUri?: string;
18
+ extraScopes?: string;
19
+ }
20
+ export declare function resolveAppOptions(overrides?: AppAuthOverrides): AppAuthOptions;
@@ -0,0 +1,33 @@
1
+ import type { AppAuthOptions } from "./options";
2
+ export declare const COOKIE = "teqconnect_session";
3
+ /** Locked fields. profile is the ID-token claims map; sid is present when the token carries it. */
4
+ export interface SessionPayload {
5
+ sub: string;
6
+ org_id: string;
7
+ access_token: string;
8
+ refresh_token?: string;
9
+ /** Access-token expiry, ISO-8601. */
10
+ expires_at: string;
11
+ /** ID-token claims map. */
12
+ profile: Record<string, unknown>;
13
+ sid?: string;
14
+ }
15
+ export interface CookieOptions {
16
+ httpOnly: boolean;
17
+ secure: boolean;
18
+ sameSite: "lax";
19
+ path: string;
20
+ /** Express cookie maxAge is milliseconds. */
21
+ maxAge: number;
22
+ }
23
+ /** Secure only when the app redirect URI is https (http://localhost samples cannot set Secure cookies in some browsers). */
24
+ export declare function cookieOptions(redirectUri?: string): CookieOptions;
25
+ /** Encrypt the payload; issued_at lets open_cookie enforce the 12h lifetime. */
26
+ export declare function seal(opts: AppAuthOptions, payload: SessionPayload): Promise<string>;
27
+ /** Decrypt; return null if missing, tampered, or older than Max-Age 43200. */
28
+ export declare function openCookie(opts: AppAuthOptions, cookie: string | undefined): Promise<SessionPayload | null>;
29
+ /** Cookie clearing instructions for the adapter. */
30
+ export declare function clearCookie(redirectUri?: string): {
31
+ name: string;
32
+ options: CookieOptions;
33
+ };
@@ -0,0 +1,27 @@
1
+ import { TeqConnect, type Credentials } from "@teqconnect/sdk";
2
+ import type { AppAuthOptions } from "./options";
3
+ import type { SessionPayload } from "./session";
4
+ export type PersistSession = (payload: SessionPayload) => void | Promise<void>;
5
+ interface RefreshResponse {
6
+ access_token: string;
7
+ refresh_token?: string;
8
+ expires_in: number;
9
+ }
10
+ /** Replace the access/refresh tokens and expiry; keep sub/org/profile. */
11
+ export declare function replaceTokens(payload: SessionPayload, token: RefreshResponse): SessionPayload;
12
+ export declare class AppSessionCredentials implements Credentials {
13
+ private readonly opts;
14
+ payload: SessionPayload;
15
+ private readonly persist;
16
+ readonly source = "app_session";
17
+ readonly static = false;
18
+ private chain;
19
+ constructor(opts: AppAuthOptions, payload: SessionPayload, persist: PersistSession);
20
+ getToken(): Promise<string>;
21
+ forceRefresh(): Promise<void>;
22
+ }
23
+ /** Build a per-request TeqConnect bound to the user's session. */
24
+ export declare function forUser(opts: AppAuthOptions, payload: SessionPayload, args: {
25
+ persist: PersistSession;
26
+ }): TeqConnect;
27
+ export {};
@@ -0,0 +1,8 @@
1
+ import type { Request, RequestHandler } from "express";
2
+ import { WebhookVerificationError } from "@teqconnect/sdk";
3
+ import { type WebhookEvent } from "@teqconnect/sdk/webhooks";
4
+ /** Capture the exact request bytes on ``req.rawBody`` before JSON parsers run. */
5
+ export declare function expressRawBody(): RequestHandler;
6
+ /** Verify the TeqConnect webhook signature on an Express request that used ``expressRawBody``. */
7
+ export declare function verifyExpressWebhook(req: Request, secret: string | string[]): WebhookEvent;
8
+ export { WebhookVerificationError, type WebhookEvent };
package/package.json CHANGED
@@ -1,6 +1,43 @@
1
1
  {
2
2
  "name": "@teqconnect/express",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.0",
4
+ "description": "Sign in with TeqConnect for Express.",
5
+ "license": "Apache-2.0",
6
+ "type": "module",
7
+ "engines": {
8
+ "node": ">=20"
9
+ },
10
+ "main": "./dist/index.cjs",
11
+ "module": "./dist/index.js",
12
+ "types": "./dist/index.d.ts",
13
+ "exports": {
14
+ ".": {
15
+ "types": "./dist/index.d.ts",
16
+ "import": "./dist/index.js",
17
+ "require": "./dist/index.cjs"
18
+ }
19
+ },
20
+ "files": [
21
+ "dist"
22
+ ],
23
+ "scripts": {
24
+ "build": "tsup && tsc --emitDeclarationOnly --declaration --outDir dist",
25
+ "typecheck": "tsc --noEmit",
26
+ "test": "vitest run --passWithNoTests"
27
+ },
28
+ "dependencies": {
29
+ "@teqconnect/sdk": ">=0.1 <0.2",
30
+ "jose": "^6.2.17"
31
+ },
32
+ "peerDependencies": {
33
+ "express": "^5.3.0"
34
+ },
35
+ "devDependencies": {
36
+ "@types/express": "^5.0.0",
37
+ "@types/node": "^22.20.5",
38
+ "@typescript/typescript6": "^6.0.0",
39
+ "tsup": "^9.0.0",
40
+ "typescript": "^7.0.2",
41
+ "vitest": "^5.1.1"
42
+ }
43
+ }
package/README.md DELETED
@@ -1,3 +0,0 @@
1
- # Temporary Holding Version
2
-
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.