@plasgos/oidc-client 0.1.0-next.1 → 0.1.0-next.2

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 (45) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/LICENSE +4 -3
  3. package/README.md +22 -13
  4. package/dist/index.cjs +2 -2
  5. package/dist/index.cjs.map +1 -1
  6. package/dist/index.d.cts +2 -2
  7. package/dist/index.d.ts +2 -2
  8. package/dist/index.js +2 -2
  9. package/dist/index.js.map +1 -1
  10. package/dist/service.cjs +1 -1
  11. package/dist/service.cjs.map +1 -1
  12. package/dist/service.d.cts +3 -3
  13. package/dist/service.d.ts +3 -3
  14. package/dist/service.js +1 -1
  15. package/dist/service.js.map +1 -1
  16. package/dist/session.cjs.map +1 -1
  17. package/dist/session.d.cts +2 -2
  18. package/dist/session.d.ts +2 -2
  19. package/dist/session.js.map +1 -1
  20. package/dist/{types-Cncksfeo.d.cts → types-JE0OMyoi.d.cts} +1 -1
  21. package/dist/{types-Cncksfeo.d.ts → types-JE0OMyoi.d.ts} +1 -1
  22. package/docs/consumers.md +90 -0
  23. package/docs/contoh-hitungcuan.md +255 -0
  24. package/docs/contoh-plaslink.md +244 -0
  25. package/docs/error.md +428 -0
  26. package/docs/examples/auth-verify-readme.ts +18 -0
  27. package/docs/examples/config-error.ts +24 -0
  28. package/docs/examples/env.ts +99 -0
  29. package/docs/examples/failure-log.ts +18 -0
  30. package/docs/examples/login-client.ts +46 -0
  31. package/docs/examples/login-flow.ts +186 -0
  32. package/docs/examples/plaslink-connect.ts +48 -0
  33. package/docs/examples/readme.ts +60 -0
  34. package/docs/examples/service-client.ts +105 -0
  35. package/docs/examples/session-store.ts +53 -0
  36. package/docs/examples/webhook-express.ts +46 -0
  37. package/docs/examples/webhook-fetch.ts +60 -0
  38. package/docs/examples/webhook-nestjs.ts +59 -0
  39. package/docs/examples/webhook-testing.ts +60 -0
  40. package/docs/examples/webhook-verifier.ts +143 -0
  41. package/docs/login-web.md +618 -0
  42. package/docs/memulai.md +339 -0
  43. package/docs/server-ke-server.md +275 -0
  44. package/docs/webhook.md +625 -0
  45. package/package.json +3 -2
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/session/cookie-crypto.ts","../src/session/store.ts","../src/session/compact-keys.ts","../src/session/cookie-header.ts","../src/session/handle.ts","../src/session/parsers.ts","../src/core/refresh-lock.ts","../src/session/index.ts"],"sourcesContent":["import { createCipheriv, createDecipheriv, createHash, hkdfSync, randomBytes } from \"node:crypto\";\n\n/*\n * Cookie sealing, wire format v1. AES-256-GCM with one HKDF key per cookie name and the cookie name\n * bound as AAD; a sealed value is `v1.<kid>.<iv>.<ct>.<tag>` (base64url). The format is the one\n * plasgos-shipping-v2 and plasgos-accounts-v2 already use, so a change here logs every user out.\n * Anything that fails to open is null: this module never throws on a sealed input and never puts\n * cookie contents in an error.\n */\n\nconst VERSION = \"v1\";\nconst IV_BYTES = 12;\nconst TAG_BYTES = 16;\nconst B64URL = /^[A-Za-z0-9_-]*$/;\n\n/**\n * The keys of one cookie: `current` seals, every key in `all` (by kid) opens.\n *\n * @example\n * const ring: KeyRing = deriveKeyRing([process.env.SESSION_SECRET ?? \"\"], \"kp\", \"plasgos-shipping-v2\");\n * ring.all.has(ring.current.kid); // true\n */\nexport interface KeyRing {\n /** The key that seals: derived from the first secret. */\n readonly current: { readonly kid: string; readonly key: Buffer };\n /** Every key that opens, by kid. */\n readonly all: ReadonlyMap<string, Buffer>;\n}\n\n/** AAD binds the format version and the cookie name: a v2 format cannot accept relabelled v1 data. */\nfunction aad(cookie: string): Buffer {\n return Buffer.from(`${VERSION}.${cookie}`, \"utf8\");\n}\n\n/**\n * Derives the key ring of one cookie: HKDF-SHA256(secret, hkdfSalt, \"cookie:<cookie>:v1\", 32) per\n * secret. The first secret seals, all of them open; the kid is the first 8 base64url characters of\n * the key's SHA-256. Throws when `secrets` is empty.\n *\n * @example\n * // Rotation: the new secret first, the old one kept until its cookies have expired.\n * const ring = deriveKeyRing([newSecret, oldSecret], \"kp-auth\", \"plasgos-shipping-v2\");\n */\nexport function deriveKeyRing(\n secrets: readonly string[],\n cookie: string,\n hkdfSalt: string,\n): KeyRing {\n const all = new Map<string, Buffer>();\n let current: KeyRing[\"current\"] | undefined;\n for (const secret of secrets) {\n const key = Buffer.from(\n hkdfSync(\"sha256\", Buffer.from(secret, \"utf8\"), hkdfSalt, `cookie:${cookie}:v1`, 32),\n );\n const kid = createHash(\"sha256\").update(key).digest(\"base64url\").slice(0, 8);\n current ??= { kid, key };\n if (!all.has(kid)) all.set(kid, key);\n }\n if (current === undefined) throw new Error(\"deriveKeyRing: at least one secret is required\");\n return { current, all };\n}\n\n/**\n * Seals `value` (as JSON) for the cookie named `cookie` with `ring.current`: AES-256-GCM, a fresh\n * random 96-bit IV, AAD `v1.<cookie>`, wire format `v1.<kid>.<iv>.<ct>.<tag>` (base64url).\n *\n * @example\n * const sealed = sealCookie(\"kp\", { theme: \"dark\" }, ring);\n * // \"v1.<kid>.<iv>.<ct>.<tag>\"\n */\nexport function sealCookie(cookie: string, value: unknown, ring: KeyRing): string {\n const iv = randomBytes(IV_BYTES);\n const cipher = createCipheriv(\"aes-256-gcm\", ring.current.key, iv);\n cipher.setAAD(aad(cookie));\n const ct = Buffer.concat([cipher.update(JSON.stringify(value), \"utf8\"), cipher.final()]);\n const tag = cipher.getAuthTag();\n return [\n VERSION,\n ring.current.kid,\n iv.toString(\"base64url\"),\n ct.toString(\"base64url\"),\n tag.toString(\"base64url\"),\n ].join(\".\");\n}\n\n/** Strict base64url: only the canonical spelling (no padding, no slack bits, no other characters). */\nfunction decode(part: string): Buffer | null {\n if (!B64URL.test(part)) return null;\n const decoded = Buffer.from(part, \"base64url\");\n return decoded.toString(\"base64url\") === part ? decoded : null;\n}\n\n/**\n * Opens a value sealed by {@link sealCookie} for the same cookie name. Returns the value and the kid\n * of the key that opened it (compare with `ring.current.kid` to re-seal after a rotation), or null\n * for anything that does not open: malformed, tampered, another key, another cookie name. Never\n * throws on input.\n *\n * @example\n * const opened = openCookie(\"kp\", sealed, ring);\n * if (opened === null) return null; // no session\n * const needsReseal = opened.kid !== ring.current.kid;\n */\nexport function openCookie(\n cookie: string,\n sealed: string,\n ring: KeyRing,\n): { value: unknown; kid: string } | null {\n try {\n const parts = sealed.split(\".\");\n if (parts.length !== 5) return null;\n const [version, kid, ivPart, ctPart, tagPart] = parts as [string, string, string, string, string];\n if (version !== VERSION) return null;\n const key = ring.all.get(kid);\n if (key === undefined) return null;\n const iv = decode(ivPart);\n const ct = decode(ctPart);\n const tag = decode(tagPart);\n if (iv === null || ct === null || tag === null) return null;\n if (iv.length !== IV_BYTES || tag.length !== TAG_BYTES) return null;\n const decipher = createDecipheriv(\"aes-256-gcm\", key, iv, { authTagLength: TAG_BYTES });\n decipher.setAAD(aad(cookie));\n decipher.setAuthTag(tag);\n const plain = Buffer.concat([decipher.update(ct), decipher.final()]).toString(\"utf8\");\n return { value: JSON.parse(plain) as unknown, kid };\n } catch {\n // A tampered or foreign value fails in node:crypto (auth tag) or in JSON.parse: never a session.\n return null;\n }\n}\n","import { ConfigError, ENVIRONMENTS } from \"@plasgos/auth-shared\";\nimport type { Environment } from \"@plasgos/auth-shared\";\n\nimport type { OidcTransaction } from \"../core/types.js\";\nimport { compactKeyProblems, createKeyCodec } from \"./compact-keys.js\";\nimport { deriveKeyRing, openCookie, sealCookie } from \"./cookie-crypto.js\";\nimport type { KeyRing } from \"./cookie-crypto.js\";\nimport { cookieValue, serialize } from \"./cookie-header.js\";\nimport { createSessionHandle } from \"./handle.js\";\nimport type { SessionData, SessionHandle, SessionSchema } from \"./handle.js\";\nimport { parseAuthPart, parseIdTokenPart, parseTransaction } from \"./parsers.js\";\nimport type { AuthState } from \"./parsers.js\";\n\n/*\n * Sealed session cookies: the app cookie (everything but auth), the auth cookie (tokens and user),\n * the idToken cookie (the ID token, kept for the logout; never in a URL) and the OIDC transaction\n * cookie. Ported from plasgos-shipping-v2 and plasgos-accounts-v2; names, salt and key table are\n * options so each app keeps opening the cookies it already sent. Anything that fails to open is\n * \"no session\": nothing here throws on a cookie or reports its contents.\n */\n\n/** Largest Set-Cookie value a commit emits; browsers drop name plus value above 4096. */\nconst MAX_SET_COOKIE_CHARS = 4000;\n/** Lifetime of the transaction cookie and of the transaction itself. */\nconst TRANSACTION_MAX_AGE_SECONDS = 600;\n/** Tolerated future `created_at` on a transaction (clock skew between instances). */\nconst CLOCK_SKEW_MS = 5000;\nconst MIN_SECRET_BYTES = 32;\nconst COOKIE_NAME = /^[a-z0-9-]{1,32}$/;\nconst ROLES = [\"app\", \"auth\", \"idToken\", \"transaction\"] as const;\n\ntype Role = (typeof ROLES)[number];\ntype CookieNames = Record<Role, string>;\ntype CookieInput = Request | string | null | undefined;\n\n/**\n * What `commit()` reports when a cookie did not fit and was expired instead. Sizes only.\n *\n * @example\n * createSessionStore({\n * ...options,\n * onFailure: (event) => logger.warn(`session cookie ${event.cookie} dropped: ${String(event.size)} chars`),\n * });\n */\nexport type SessionFailureEvent = {\n /** The only kind so far. */\n kind: \"session_too_large\";\n /** The cookie that did not fit. */\n cookie: \"app\" | \"auth\" | \"idToken\";\n /** Length of the refused `Set-Cookie` value, in characters. */\n size: number;\n};\n\n/**\n * A cookie would not fit in a browser. Thrown by `commitApp`, `commitAuth` and `commitIdToken`;\n * `commit()` handles it itself.\n *\n * @example\n * try {\n * headers.append(\"Set-Cookie\", store.commitAuth(session));\n * } catch (error) {\n * if (error instanceof SessionTooLargeError) return loginFailed();\n * throw error;\n * }\n */\nexport class SessionTooLargeError extends Error {\n /** Length of the refused `Set-Cookie` value, in characters. */\n readonly size: number;\n\n /** Message \"Session cookie too large: <size> chars (limit 4000)\"; never the cookie value. */\n constructor(size: number) {\n super(`Session cookie too large: ${String(size)} chars (limit ${String(MAX_SET_COOKIE_CHARS)})`);\n this.name = \"SessionTooLargeError\";\n this.size = size;\n }\n}\n\n/**\n * Options of {@link createSessionStore}. For an app that already has sessions, `hkdfSalt`,\n * `cookies` and `compactKeys` must stay exactly what the app uses today.\n *\n * @example\n * const options: SessionStoreOptions<{ flash?: string }> = {\n * environment: \"production\",\n * secrets: [process.env.SESSION_SECRET ?? \"\"],\n * hkdfSalt: \"my-app\",\n * cookies: { app: \"my\", auth: \"my-auth\", idToken: \"my-idt\", transaction: \"my-oidc\" },\n * authMaxAgeSeconds: 2_592_000,\n * appSchema,\n * };\n */\nexport interface SessionStoreOptions<App extends object> {\n /** The same value the app gives its client. `\"production\"` refuses `hostPrefix: false`. */\n environment: Environment;\n /** One or two secrets, each at least 32 bytes; the first seals, all open. */\n secrets: readonly string[];\n /** HKDF salt, for example `\"plasgos-shipping-v2\"`. */\n hkdfSalt: string;\n /** Logical cookie names (`/^[a-z0-9-]{1,32}$/`, distinct); they feed the key and the AAD. */\n cookies: { app: string; auth: string; idToken: string; transaction: string };\n /** `true` (default): wire name `__Host-<name>` plus `Secure`. `false` only for local http. */\n hostPrefix?: boolean | undefined;\n /** Max-Age of the auth and idToken cookies: a positive integer, or a function of the auth. */\n authMaxAgeSeconds: number | ((auth: AuthState) => number);\n /** Validates the app cookie. Every app field must be optional. */\n appSchema: SessionSchema<Omit<App, \"auth\">>;\n /** The app's compact key table, merged with the core table; omitted means no renaming. */\n compactKeys?: Readonly<Record<string, string>> | undefined;\n /** Receives the overflow fallbacks of `commit()`. Exceptions are swallowed. */\n onFailure?: ((event: SessionFailureEvent) => void) | undefined;\n}\n\n/**\n * What {@link createSessionStore} returns.\n *\n * @example\n * const session = store.read(request);\n * session.update({ auth });\n * for (const cookie of store.commit(session)) headers.append(\"Set-Cookie\", cookie);\n */\nexport interface SessionStore<App extends object> {\n /** Opens the session cookies of a request (or of a raw Cookie header). Never throws on input. */\n read(input: Request | string | null | undefined): SessionHandle<App>;\n /**\n * Every `Set-Cookie` value a dirty session needs (none when clean): the app cookie when the rest\n * changed, then auth and idToken when auth changed. A cookie that does not fit is expired, its\n * data removed from the session, and reported through `onFailure`.\n */\n commit(session: SessionHandle<App>): string[];\n /** The app cookie (everything but auth), a browser-session cookie. Throws SessionTooLargeError. */\n commitApp(session: SessionHandle<App>): string;\n /** The auth cookie: tokens and user, never `id_token`. Throws SessionTooLargeError. */\n commitAuth(session: SessionHandle<App>): string;\n /** The idToken cookie: `auth.id_token` alone. Throws SessionTooLargeError. */\n commitIdToken(session: SessionHandle<App>): string;\n /** Whether the cookies of `auth` would fit, checked before a login is stored. */\n fits(auth: AuthState): { auth: boolean; idToken: boolean };\n /** The transaction, or null when missing, invalid, older than 600 s or over 5 s in the future. */\n readTransaction(input: Request | string | null | undefined, now?: number): OidcTransaction | null;\n /** The `Set-Cookie` value of the transaction cookie (Max-Age 600). */\n commitTransaction(tx: OidcTransaction): string;\n /** The `Set-Cookie` value that expires the transaction cookie. */\n clearTransaction(): string;\n /** Wire names (with __Host- when hostPrefix). */\n readonly cookieNames: Readonly<{ app: string; auth: string; idToken: string; transaction: string }>;\n}\n\ninterface Settings {\n secrets: readonly string[];\n hkdfSalt: string;\n cookies: CookieNames;\n secure: boolean;\n authMaxAge: number | ((auth: AuthState) => number);\n parseApp: (input: unknown) => unknown;\n compactKeys: Readonly<Record<string, string>> | undefined;\n onFailure: ((event: SessionFailureEvent) => void) | undefined;\n}\n\nconst isPositiveInteger = (value: unknown): value is number =>\n typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n value !== null && typeof value === \"object\" && !Array.isArray(value);\n\n/** Checks the untyped options; one ConfigError lists every problem, by field name only. */\nfunction readOptions(raw: unknown): Settings {\n if (!isObject(raw)) throw new ConfigError([\"options must be an object\"]);\n const problems: string[] = [];\n const { environment, hostPrefix, hkdfSalt, secrets, cookies, authMaxAgeSeconds } = raw;\n const { appSchema, compactKeys, onFailure } = raw;\n\n if (typeof environment !== \"string\" || !(ENVIRONMENTS as readonly string[]).includes(environment)) {\n problems.push('environment must be \"sandbox\" or \"production\"');\n }\n if (hostPrefix !== undefined && typeof hostPrefix !== \"boolean\") {\n problems.push(\"hostPrefix must be a boolean\");\n } else if (hostPrefix === false && environment === \"production\") {\n problems.push('hostPrefix: false is not allowed when environment is \"production\"');\n }\n\n if (hkdfSalt === undefined || hkdfSalt === null || hkdfSalt === \"\") {\n problems.push(\"hkdfSalt is required\");\n } else if (typeof hkdfSalt !== \"string\") {\n problems.push(\"hkdfSalt must be a string\");\n }\n\n const secretList =\n Array.isArray(secrets) && secrets.every((secret) => typeof secret === \"string\")\n ? secrets\n : [];\n if (secretList.length < 1 || secretList.length > 2) {\n problems.push(\"secrets must hold one or two values\");\n } else if (secretList.some((secret) => Buffer.byteLength(secret, \"utf8\") < MIN_SECRET_BYTES)) {\n problems.push(\"secrets values must each be at least 32 bytes\");\n }\n\n const names: Partial<CookieNames> = {};\n const given = isObject(cookies) ? cookies : {};\n for (const role of ROLES) {\n const name = Object.hasOwn(given, role) ? given[role] : undefined;\n if (typeof name === \"string\" && COOKIE_NAME.test(name)) names[role] = name;\n else problems.push(`cookies.${role} must match /^[a-z0-9-]{1,32}$/`);\n }\n const nameList = Object.values(names);\n if (nameList.length === ROLES.length && new Set(nameList).size !== ROLES.length) {\n problems.push(\"cookies names must be distinct\");\n }\n\n if (!isPositiveInteger(authMaxAgeSeconds) && typeof authMaxAgeSeconds !== \"function\") {\n problems.push(\"authMaxAgeSeconds must be a positive integer or a function\");\n }\n const parse = isObject(appSchema) ? appSchema[\"parse\"] : undefined;\n if (typeof parse !== \"function\") problems.push(\"appSchema must have a parse function\");\n if (compactKeys !== undefined) problems.push(...compactKeyProblems(compactKeys));\n if (onFailure !== undefined && typeof onFailure !== \"function\") {\n problems.push(\"onFailure must be a function\");\n }\n\n if (problems.length > 0) throw new ConfigError(problems);\n return {\n secrets: secretList,\n hkdfSalt: hkdfSalt as string,\n cookies: names as CookieNames,\n secure: hostPrefix !== false,\n authMaxAge: authMaxAgeSeconds as Settings[\"authMaxAge\"],\n parseApp: (input) => (appSchema as SessionSchema<unknown>).parse(input),\n compactKeys: compactKeys as Settings[\"compactKeys\"],\n onFailure: onFailure as Settings[\"onFailure\"],\n };\n}\n\nfunction checkSize(header: string): string {\n if (header.length > MAX_SET_COOKIE_CHARS) throw new SessionTooLargeError(header.length);\n return header;\n}\n\n/** Runs `commit`; on a size overflow reports it, lets `drop` shrink the session and commits again. */\nfunction withFallback(\n cookie: SessionFailureEvent[\"cookie\"],\n commit: () => string,\n drop: () => void,\n report: (event: SessionFailureEvent) => void,\n): string {\n try {\n return commit();\n } catch (error) {\n if (!(error instanceof SessionTooLargeError)) throw error;\n report({ kind: \"session_too_large\", cookie, size: error.size });\n drop();\n return commit();\n }\n}\n\n/**\n * Creates the session store of an app. Throws one `ConfigError` naming every invalid option.\n *\n * @example\n * const store = createSessionStore<{ flash?: Flash }>({\n * environment: \"sandbox\",\n * secrets: [process.env.SESSION_SECRET ?? \"\"],\n * hkdfSalt: \"my-app\",\n * cookies: { app: \"my\", auth: \"my-auth\", idToken: \"my-idt\", transaction: \"my-oidc\" },\n * authMaxAgeSeconds: 2_592_000,\n * appSchema: { parse: (input) => parseAppCookie(input) },\n * });\n * const session = store.read(request);\n * for (const cookie of store.commit(session)) headers.append(\"Set-Cookie\", cookie);\n */\nexport function createSessionStore<App extends object>(\n options: SessionStoreOptions<App>,\n): SessionStore<App> {\n const settings = readOptions(options);\n const { cookies, secure } = settings;\n const codec = createKeyCodec(settings.compactKeys);\n const ring = (role: Role): KeyRing => rings[role];\n const rings: Record<Role, KeyRing> = {\n app: deriveKeyRing(settings.secrets, cookies.app, settings.hkdfSalt),\n auth: deriveKeyRing(settings.secrets, cookies.auth, settings.hkdfSalt),\n idToken: deriveKeyRing(settings.secrets, cookies.idToken, settings.hkdfSalt),\n transaction: deriveKeyRing(settings.secrets, cookies.transaction, settings.hkdfSalt),\n };\n const wireName = (role: Role): string => (secure ? `__Host-${cookies[role]}` : cookies[role]);\n const cookieNames = Object.freeze({\n app: wireName(\"app\"),\n auth: wireName(\"auth\"),\n idToken: wireName(\"idToken\"),\n transaction: wireName(\"transaction\"),\n });\n\n const headerOf = (input: CookieInput): string | null =>\n typeof input === \"string\" ? input : (input?.headers.get(\"cookie\") ?? null);\n\n /** The opened value of one cookie and the kid that opened it, or null. */\n const open = (header: string | null, role: Role): { value: unknown; kid: string } | null => {\n const raw = cookieValue(header, cookieNames[role]);\n if (raw === null || raw === \"\") return null;\n return openCookie(cookies[role], raw, ring(role));\n };\n\n const seal = (role: Role, value: unknown, maxAge: number | undefined): string =>\n serialize(cookieNames[role], sealCookie(cookies[role], value, ring(role)), maxAge, secure);\n\n const expire = (role: Role): string => serialize(cookieNames[role], \"\", 0, secure);\n\n /** The app part: the schema's result without `auth`, or `{}` when it refuses, throws or is no object. */\n const parseApp = (value: unknown): Record<string, unknown> | null => {\n let parsed: unknown;\n try {\n parsed = settings.parseApp(value);\n } catch {\n // A schema that throws (zod's `parse`) means the same as one that returns null.\n return null;\n }\n if (!isObject(parsed)) return null;\n return Object.fromEntries(Object.entries(parsed).filter(([key]) => key !== \"auth\"));\n };\n\n const authMaxAge = (auth: AuthState): number => {\n const { authMaxAge: setting } = settings;\n if (typeof setting === \"number\") return setting;\n const seconds: unknown = setting(auth);\n if (!isPositiveInteger(seconds)) {\n throw new ConfigError([\"authMaxAgeSeconds must return a positive integer\"]);\n }\n return seconds;\n };\n\n const authCookie = (auth: AuthState): string => {\n const maxAge = authMaxAge(auth);\n const sealed = Object.fromEntries(Object.entries(auth).filter(([key]) => key !== \"id_token\"));\n return seal(\"auth\", codec.compact({ auth: sealed }), maxAge);\n };\n\n const idTokenCookie = (auth: AuthState, idToken: string): string =>\n seal(\"idToken\", codec.compact({ id_token: idToken }), authMaxAge(auth));\n\n const report = (event: SessionFailureEvent): void => {\n try {\n settings.onFailure?.(event);\n } catch {\n // The hook is the app's; its failure must not lose the response's cookies.\n }\n };\n\n const store: SessionStore<App> = {\n cookieNames,\n\n read(input) {\n const header = headerOf(input);\n const appOpened = open(header, \"app\");\n const rest = appOpened === null ? null : parseApp(codec.expand(appOpened.value));\n const authOpened = open(header, \"auth\");\n let auth = authOpened === null ? undefined : parseAuthPart(codec.expand(authOpened.value))?.auth;\n if (auth !== undefined) {\n const idOpened = open(header, \"idToken\");\n const idPart = idOpened === null ? null : parseIdTokenPart(codec.expand(idOpened.value));\n if (idPart !== null) auth = { ...auth, id_token: idPart.id_token };\n }\n const data = { ...rest, ...(auth !== undefined ? { auth } : {}) } as SessionData<App>;\n // Key migration never marks auth dirty: rewriting tokens that were only read could roll back\n // a concurrent refresh. An old-key auth cookie is re-sealed when auth really changes.\n const migrate = rest !== null && appOpened?.kid !== ring(\"app\").current.kid;\n return createSessionHandle<App>(data, false, migrate);\n },\n\n commitApp(session) {\n const rest = Object.fromEntries(\n Object.entries(session.data).filter(([key, value]) => key !== \"auth\" && value !== undefined),\n );\n if (Object.keys(rest).length === 0) return expire(\"app\");\n return checkSize(seal(\"app\", codec.compact(rest), undefined));\n },\n\n commitAuth(session) {\n const { auth } = session.data;\n if (auth === undefined) return expire(\"auth\");\n return checkSize(authCookie(auth));\n },\n\n commitIdToken(session) {\n const { auth } = session.data;\n if (auth?.id_token === undefined || auth.id_token === \"\") return expire(\"idToken\");\n return checkSize(idTokenCookie(auth, auth.id_token));\n },\n\n fits(auth) {\n const idToken = auth.id_token;\n return {\n auth: authCookie(auth).length <= MAX_SET_COOKIE_CHARS,\n idToken:\n idToken === undefined ||\n idToken === \"\" ||\n idTokenCookie(auth, idToken).length <= MAX_SET_COOKIE_CHARS,\n };\n },\n\n commit(session) {\n const out: string[] = [];\n if (session.restDirty) {\n out.push(\n withFallback(\n \"app\",\n () => store.commitApp(session),\n () => {\n // Only the app cookie overflowed: drop its keys, never the tokens.\n for (const key of Object.keys(session.data)) {\n if (key !== \"auth\") session.unset(key as keyof SessionData<App>);\n }\n },\n report,\n ),\n );\n }\n if (!session.authDirty) return out;\n // Auth before idToken: an auth that is dropped here expires both.\n out.push(\n withFallback(\n \"auth\",\n () => store.commitAuth(session),\n () => {\n session.unset(\"auth\");\n },\n report,\n ),\n );\n out.push(\n withFallback(\n \"idToken\",\n () => store.commitIdToken(session),\n () => {\n // The ID token alone is dropped (the logout then has no ticket); the tokens stay.\n const { auth } = session.data;\n if (auth === undefined) return;\n const kept = Object.fromEntries(Object.entries(auth).filter(([key]) => key !== \"id_token\"));\n session.update({ auth: kept } as Parameters<SessionHandle<App>[\"update\"]>[0]);\n },\n report,\n ),\n );\n return out;\n },\n\n readTransaction(input, now = Date.now()) {\n // Long keys: the transaction is never compacted.\n const tx = parseTransaction(open(headerOf(input), \"transaction\")?.value);\n if (tx === null) return null;\n const age = now - tx.created_at;\n // Written as the accepted range, so a clock that is not a number opens nothing.\n if (!(age >= -CLOCK_SKEW_MS && age <= TRANSACTION_MAX_AGE_SECONDS * 1000)) return null;\n return tx;\n },\n\n commitTransaction(tx) {\n return seal(\"transaction\", tx, TRANSACTION_MAX_AGE_SECONDS);\n },\n\n clearTransaction() {\n return expire(\"transaction\");\n },\n };\n return store;\n}\n","/*\n * Compact keys: the session plaintext uses short keys so the largest realistic session stays under\n * the cookie budget. A table is bijective and strict: a key it does not name is dropped in both\n * directions, so an unmapped field can never be written or read back. The core table is what\n * plasgos-shipping-v2 and plasgos-accounts-v2 already seal; changing a pair logs every user out.\n */\n\n/**\n * The pairs of the SDK-owned auth shape: the 11 keys both apps share plus accounts' `remember`.\n * An app's table is merged with it and must agree with it.\n *\n * @example\n * createSessionStore({ ..., compactKeys: { flash: \"fl\", kind: \"k\", message: \"msg\" } });\n * // `auth`, `access_token`, … come from CORE_COMPACT_KEYS\n */\nexport const CORE_COMPACT_KEYS = Object.freeze({\n auth: \"a\",\n access_token: \"at\",\n refresh_token: \"rt\",\n expires_at: \"e\",\n remember: \"r\",\n user: \"u\",\n id: \"i\",\n name: \"n\",\n avatar_url: \"av\",\n email: \"em\",\n id_token: \"idt\",\n auth_time: \"atm\",\n} as const);\n\nconst KEY_PATTERN = /^[A-Za-z0-9_]{1,32}$/;\nconst RESERVED = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n\nconst isKey = (value: unknown): value is string =>\n typeof value === \"string\" && KEY_PATTERN.test(value) && !RESERVED.has(value);\n\n/** Own entries of the core table followed by the app's (the app's may repeat a core pair). */\nfunction mergedEntries(table: object): [string, unknown][] {\n const merged = new Map<string, unknown>(Object.entries(CORE_COMPACT_KEYS));\n for (const [long, short] of Object.entries(table)) merged.set(long, short);\n return [...merged];\n}\n\n/**\n * Problems of an app's compact key table (empty when it can be merged with the core table). A key\n * is echoed only after it passed the syntax check, so a message never carries an arbitrary string.\n *\n * @example\n * compactKeyProblems({ auth: \"x\" }); // ['compactKeys: \"auth\" must map to \"a\"']\n */\nexport function compactKeyProblems(table: unknown): string[] {\n if (table === null || typeof table !== \"object\" || Array.isArray(table)) {\n return [\"compactKeys must be an object\"];\n }\n const entries = Object.entries(table);\n if (entries.some(([long, short]) => !isKey(long) || !isKey(short))) {\n return [\"compactKeys: keys must match /^[A-Za-z0-9_]{1,32}$/ and must not be a reserved name\"];\n }\n\n const problems: string[] = [];\n const core = new Map<string, string>(Object.entries(CORE_COMPACT_KEYS));\n for (const [long, short] of entries) {\n const expected = core.get(long);\n if (expected !== undefined && short !== expected) {\n problems.push(`compactKeys: \"${long}\" must map to \"${expected}\"`);\n }\n }\n if (problems.length > 0) return problems;\n\n const merged = mergedEntries(table) as [string, string][];\n const longs = new Set(merged.map(([long]) => long));\n const seen = new Set<string>();\n const reported = new Set<string>();\n for (const [, short] of merged) {\n if (seen.has(short) && !reported.has(short)) {\n reported.add(short);\n problems.push(`compactKeys: short key \"${short}\" is used twice`);\n }\n seen.add(short);\n if (longs.has(short)) problems.push(`compactKeys: short key \"${short}\" is also a long key`);\n }\n return problems;\n}\n\n/** Renames keys in both directions; see {@link createKeyCodec}. */\nexport interface KeyCodec {\n /** Long keys to short keys, for the plaintext a cookie seals. */\n compact(value: unknown): unknown;\n /** Short keys back to long keys, for an opened cookie. */\n expand(value: unknown): unknown;\n}\n\n/**\n * Renames own keys at every depth (arrays included) and drops a key the table does not name. The\n * table is a Map, so a key such as `constructor` or `__proto__` is looked up as plain data and\n * never through a prototype; a validated table has no reserved name as a target either.\n */\nfunction renameKeys(value: unknown, table: ReadonlyMap<string, string>): unknown {\n if (Array.isArray(value)) return value.map((item) => renameKeys(item, table));\n if (value === null || typeof value !== \"object\") return value;\n const out: Record<string, unknown> = {};\n for (const [key, item] of Object.entries(value)) {\n const mapped = table.get(key);\n if (mapped !== undefined) out[mapped] = renameKeys(item, table);\n }\n return out;\n}\n\nconst IDENTITY: KeyCodec = { compact: (value) => value, expand: (value) => value };\n\n/**\n * The codec of a store. With a table (already checked by {@link compactKeyProblems}) it renames by\n * the core table merged with the app's; without one it is the identity: nothing is renamed and\n * nothing is dropped.\n *\n * @example\n * const codec = createKeyCodec({ flash: \"fl\", kind: \"k\", message: \"msg\" });\n * codec.compact({ flash: { kind: \"info\", message: \"Halo\" }, other: 1 });\n * // { fl: { k: \"info\", msg: \"Halo\" } }\n */\nexport function createKeyCodec(table: Readonly<Record<string, string>> | undefined): KeyCodec {\n if (table === undefined) return IDENTITY;\n const merged = mergedEntries(table) as [string, string][];\n const shorts = new Map(merged);\n const longs = new Map(merged.map(([long, short]) => [short, long]));\n return {\n compact: (value) => renameKeys(value, shorts),\n expand: (value) => renameKeys(value, longs),\n };\n}\n","/*\n * Cookie header plumbing: the one Cookie-header parser and the Set-Cookie serialiser of the session\n * cookies. A sealed value is base64url with dots, so it is never encoded or decoded here.\n */\n\n/**\n * The first value of `name` in a Cookie header, or null. Names and values are trimmed; a pair\n * without `=` is skipped; the value is never decoded.\n *\n * @example\n * cookieValue(\"theme=dark; kp=v1.abc\", \"kp\"); // \"v1.abc\"\n * cookieValue(\"xkp=1\", \"kp\"); // null\n */\nexport function cookieValue(header: string | null | undefined, name: string): string | null {\n if (header === null || header === undefined || header === \"\") return null;\n for (const pair of header.split(\";\")) {\n const eq = pair.indexOf(\"=\");\n if (eq === -1) continue;\n if (pair.slice(0, eq).trim() === name) return pair.slice(eq + 1).trim();\n }\n return null;\n}\n\n/**\n * Serialises `name=value` with the fixed attributes, in the order both apps already send:\n * `Max-Age` (only when defined), `Path=/`, `HttpOnly`, `Secure` (only when `secure`),\n * `SameSite=Lax`. Never `Domain` or `Expires`, as the `__Host-` prefix requires.\n *\n * @example\n * serialize(\"__Host-kp\", sealed, 600, true);\n * // \"__Host-kp=<sealed>; Max-Age=600; Path=/; HttpOnly; Secure; SameSite=Lax\"\n */\nexport function serialize(\n name: string,\n value: string,\n maxAge: number | undefined,\n secure: boolean,\n): string {\n const attrs = [`${name}=${value}`];\n if (maxAge !== undefined) attrs.push(`Max-Age=${String(maxAge)}`);\n attrs.push(\"Path=/\", \"HttpOnly\");\n if (secure) attrs.push(\"Secure\");\n attrs.push(\"SameSite=Lax\");\n return attrs.join(\"; \");\n}\n","import type { AuthState } from \"./parsers.js\";\n\n/*\n * The request's session handle. Loaders, actions and the api client only mutate it; the server\n * layer commits it once through the store. `auth` and everything else are tracked apart because\n * they live in different cookies: a response that only takes a flash must never rewrite the tokens.\n */\n\n/**\n * Validates the app cookie; `null` means \"no app data\". The app's zod schema fits behind it.\n *\n * @example\n * const appSchema: SessionSchema<{ theme?: string }> = {\n * parse: (input) => (isThemeObject(input) ? input : null),\n * };\n */\nexport interface SessionSchema<T> {\n /** Returns the validated app data, or null when `input` is not what the app stored. May throw: that counts as null. */\n parse(input: unknown): T | null;\n}\n\n/**\n * The app's own session fields plus the SDK-owned `auth`.\n *\n * @example\n * type App = { flash?: string };\n * const data: SessionData<App> = store.read(request).data;\n * data.flash; data.auth?.user.id;\n */\nexport type SessionData<App extends object> = Omit<App, \"auth\"> & { auth?: AuthState | undefined };\n\n/**\n * One request's session.\n *\n * @example\n * const session = store.read(request);\n * session.update({ flash: { kind: \"success\", message: \"Tersimpan\" } });\n * session.update({ auth: undefined }); // sign out, the app data stays\n * const setCookies = store.commit(session);\n */\nexport interface SessionHandle<App extends object> {\n /** The current session: the app's fields and `auth` when signed in. */\n readonly data: Readonly<SessionData<App>>;\n /** True when anything has to be written back. */\n readonly dirty: boolean;\n /** Auth changed (login, refresh, logout, destroy). Never set by a key migration alone. */\n readonly authDirty: boolean;\n /** Anything but auth changed, or the app cookie was opened with a retiring secret. */\n readonly restDirty: boolean;\n /** A key given as `undefined` is deleted (works under exactOptionalPropertyTypes). */\n update(patch: { [K in keyof SessionData<App>]?: SessionData<App>[K] | undefined }): void;\n /** Deletes one key; nothing happens when it is absent. */\n unset(key: keyof SessionData<App>): void;\n /** Empties the session; the next commit expires its cookies. */\n destroy(): void;\n}\n\ntype Bag = Record<string, unknown>;\n\n/** `bag` without the keys `drop` selects, as a new object. */\nconst without = (bag: Bag, drop: (key: string, value: unknown) => boolean): Bag =>\n Object.fromEntries(Object.entries(bag).filter(([key, value]) => !drop(key, value)));\n\n/**\n * Opens a handle over `data` (never mutated) with its initial dirty flags.\n *\n * @example\n * const session = createSessionHandle<{ flash?: string }>({}, false, false);\n * session.update({ flash: \"hi\" });\n * session.restDirty; // true\n */\nexport function createSessionHandle<App extends object>(\n data: SessionData<App>,\n authDirty: boolean,\n restDirty: boolean,\n): SessionHandle<App> {\n let bag: Bag = { ...data };\n let auth = authDirty;\n let rest = restDirty;\n return {\n get data() {\n return bag as Readonly<SessionData<App>>;\n },\n get dirty() {\n return auth || rest;\n },\n get authDirty() {\n return auth;\n },\n get restDirty() {\n return rest;\n },\n update(patch) {\n const changes: Bag = { ...patch };\n // Compared by value: storing the tokens that were only read must not rewrite the auth cookie.\n if (\n Object.hasOwn(changes, \"auth\") &&\n JSON.stringify(changes[\"auth\"]) !== JSON.stringify(bag[\"auth\"])\n ) {\n auth = true;\n }\n if (Object.keys(changes).some((key) => key !== \"auth\")) rest = true;\n bag = without({ ...bag, ...changes }, (_key, value) => value === undefined);\n },\n unset(key) {\n if (!Object.hasOwn(bag, key)) return;\n bag = without(bag, (candidate) => candidate === key);\n if (key === \"auth\") auth = true;\n else rest = true;\n },\n destroy() {\n bag = {};\n auth = true;\n rest = true;\n },\n };\n}\n","import type { OidcTransaction } from \"../core/types.js\";\n\n/*\n * What a session cookie may hold, checked on every read. Hand-written equivalents of the zod\n * schemas both apps use (no zod dependency): unknown keys are stripped, a wrong-shaped value is\n * null, and nothing here throws or reports the value it refused. Caps: tokens 4096 chars, other\n * strings 512.\n */\n\n/**\n * The signed-in user as the session keeps it.\n *\n * @example\n * const user: SessionUser = { id: claims.sub, name: claims.name ?? \"\", email: claims.email ?? null, avatar_url: null };\n */\nexport interface SessionUser {\n /** The app's id of the user, usually the ID token `sub`. 1 to 512 characters. */\n id: string;\n /** Display name, at most 512 characters; may be empty. */\n name: string;\n /** Stored by plasgos-shipping-v2 (`null` when unknown); absent in plasgos-accounts-v2. */\n email?: string | null | undefined;\n /** Picture URL, or null. */\n avatar_url: string | null;\n}\n\n/**\n * The tokens and the user of a signed-in session.\n *\n * @example\n * session.update({\n * auth: {\n * access_token: tokens.access_token,\n * refresh_token: tokens.refresh_token,\n * expires_at: accessTokenExpiry(tokens, Date.now()),\n * user: { id: claims.sub, name: \"Budi\", email: null, avatar_url: null },\n * id_token: tokens.id_token,\n * },\n * });\n */\nexport interface AuthState {\n /** 1 to 4096 characters. */\n access_token: string;\n /** 1 to 4096 characters; absent for a client without refresh tokens. */\n refresh_token?: string | undefined;\n /** Epoch seconds. */\n expires_at: number;\n /** The signed-in user. */\n user: SessionUser;\n /** Kept in its own cookie (idToken), only for the logout ticket / id_token_hint. */\n id_token?: string | undefined;\n /** Epoch seconds of the login, kept across refreshes. */\n auth_time?: number | undefined;\n /** Remember-me (accounts); drives authMaxAgeSeconds when it is a function. */\n remember?: boolean | undefined;\n}\n\nconst TOKEN_MAX = 4096;\nconst TEXT_MAX = 512;\n\n/** A JSON object (not null, not an array), read through own properties only. */\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nconst own = (record: Record<string, unknown>, key: string): unknown =>\n Object.hasOwn(record, key) ? record[key] : undefined;\n\nconst isToken = (value: unknown): value is string =>\n typeof value === \"string\" && value.length >= 1 && value.length <= TOKEN_MAX;\n\nconst isText = (value: unknown): value is string =>\n typeof value === \"string\" && value.length <= TEXT_MAX;\n\nconst isRequiredText = (value: unknown): value is string => isText(value) && value.length >= 1;\n\n/** An integer >= 0 (epoch seconds or milliseconds, or a duration). */\nconst isCount = (value: unknown): value is number =>\n typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n\nfunction parseUser(input: unknown): SessionUser | null {\n if (!isRecord(input)) return null;\n const id = own(input, \"id\");\n const name = own(input, \"name\");\n const email = own(input, \"email\");\n const avatar = own(input, \"avatar_url\");\n if (!isRequiredText(id) || !isText(name)) return null;\n if (email !== undefined && email !== null && !isText(email)) return null;\n if (avatar !== null && !isText(avatar)) return null;\n return { id, name, ...(email !== undefined ? { email } : {}), avatar_url: avatar };\n}\n\nfunction parseAuthState(input: unknown): AuthState | null {\n if (!isRecord(input)) return null;\n const accessToken = own(input, \"access_token\");\n const refreshToken = own(input, \"refresh_token\");\n const expiresAt = own(input, \"expires_at\");\n const authTime = own(input, \"auth_time\");\n const remember = own(input, \"remember\");\n const user = parseUser(own(input, \"user\"));\n if (!isToken(accessToken) || !isCount(expiresAt) || user === null) return null;\n if (refreshToken !== undefined && !isToken(refreshToken)) return null;\n if (authTime !== undefined && !isCount(authTime)) return null;\n if (remember !== undefined && typeof remember !== \"boolean\") return null;\n return {\n access_token: accessToken,\n ...(refreshToken !== undefined ? { refresh_token: refreshToken } : {}),\n expires_at: expiresAt,\n ...(remember !== undefined ? { remember } : {}),\n user,\n ...(authTime !== undefined ? { auth_time: authTime } : {}),\n };\n}\n\n/**\n * The auth cookie: `{ auth?: … }` with long keys. `{}` when the object has no `auth`, null when the\n * shape is wrong. `id_token` is stripped: it lives in its own cookie.\n *\n * @example\n * parseAuthPart({ auth: { access_token: \"…\", expires_at: 1767225600, user: { id: \"u\", name: \"\", avatar_url: null } } });\n */\nexport function parseAuthPart(input: unknown): { auth?: AuthState } | null {\n if (!isRecord(input)) return null;\n const raw = own(input, \"auth\");\n if (raw === undefined) return {};\n const auth = parseAuthState(raw);\n return auth === null ? null : { auth };\n}\n\n/**\n * The idToken cookie: `{ id_token }`, 1 to 4096 chars.\n *\n * @example\n * parseIdTokenPart({ id_token: \"eyJ…\" }); // { id_token: \"eyJ…\" }\n */\nexport function parseIdTokenPart(input: unknown): { id_token: string } | null {\n if (!isRecord(input)) return null;\n const idToken = own(input, \"id_token\");\n return isToken(idToken) ? { id_token: idToken } : null;\n}\n\n/**\n * The transaction cookie (long keys, never compacted). Accepts accounts' `reauth` and the SDK's\n * `max_age`; unknown keys are stripped.\n *\n * @example\n * parseTransaction({ state, nonce, code_verifier, return_to: \"/\", created_at: Date.now() });\n */\nexport function parseTransaction(input: unknown): OidcTransaction | null {\n if (!isRecord(input)) return null;\n const state = own(input, \"state\");\n const nonce = own(input, \"nonce\");\n const codeVerifier = own(input, \"code_verifier\");\n const returnTo = own(input, \"return_to\");\n const createdAt = own(input, \"created_at\");\n const reauth = own(input, \"reauth\");\n const maxAge = own(input, \"max_age\");\n if (!isRequiredText(state) || !isRequiredText(nonce) || !isRequiredText(codeVerifier)) return null;\n if (!isText(returnTo) || !isCount(createdAt)) return null;\n if (reauth !== undefined && typeof reauth !== \"boolean\") return null;\n if (maxAge !== undefined && !isCount(maxAge)) return null;\n return {\n state,\n nonce,\n code_verifier: codeVerifier,\n return_to: returnTo,\n created_at: createdAt,\n ...(reauth !== undefined ? { reauth } : {}),\n ...(maxAge !== undefined ? { max_age: maxAge } : {}),\n };\n}\n","import type { TokenSet } from \"@plasgos/auth-shared\";\n\n/*\n * Single-flight refresh. api-main rotates the refresh token on every use, so a second refresh with\n * the same token looks like reuse and revokes the whole grant. Parallel requests of one session\n * therefore share one refresh, and a request that still carries the old token shortly after the\n * rotation gets the same result. Ported from `refresh-lock.server.ts` of plasgos-shipping-v2 and\n * plasgos-accounts-v2. This module has no module-level state: the map belongs to the store that\n * `memoryLockStore()` returns.\n */\n\n/**\n * Where the client keeps refreshes in flight. The key is the SHA-256 of the refresh token, never\n * the token itself. Implement it over a shared store to hold the lock across several instances.\n *\n * @example\n * const redisLock: RefreshLockStore = {\n * run: (key, refresh, reuseMs) => runOnceAcrossInstances(redis, key, refresh, reuseMs),\n * };\n * const client = createOidcClient({ ...options, refreshLock: redisLock });\n */\nexport interface RefreshLockStore {\n /**\n * Runs `refresh` at most once per key among callers sharing this store and gives every caller the same result.\n * A fulfilled result is reused for `reuseMs`; a rejection is not cached.\n */\n run(key: string, refresh: () => Promise<TokenSet>, reuseMs: number): Promise<TokenSet>;\n}\n\ninterface LockEntry {\n promise: Promise<TokenSet>;\n reuseMs: number;\n settledAt?: number;\n}\n\n/**\n * The default lock store: a map in this process, so it only holds within one instance.\n *\n * @example\n * const client = createOidcClient({ ...options, refreshLock: memoryLockStore() });\n */\nexport function memoryLockStore(options: { now?: (() => number) | undefined } = {}): RefreshLockStore {\n const now = options.now ?? Date.now;\n const locks = new Map<string, LockEntry>();\n\n return {\n run(key, refresh, reuseMs) {\n const t = now();\n for (const [storedKey, entry] of locks) {\n if (entry.settledAt !== undefined && t - entry.settledAt >= entry.reuseMs) locks.delete(storedKey);\n }\n const hit = locks.get(key);\n if (hit) return hit.promise;\n\n const entry: LockEntry = { promise: refresh(), reuseMs };\n locks.set(key, entry);\n entry.promise.then(\n () => {\n entry.settledAt = now();\n },\n () => {\n if (locks.get(key) === entry) locks.delete(key);\n },\n );\n return entry.promise;\n },\n };\n}\n","export { deriveKeyRing, openCookie, sealCookie } from \"./cookie-crypto.js\";\nexport type { KeyRing } from \"./cookie-crypto.js\";\nexport type { OidcTransaction } from \"../core/types.js\";\nexport type { SessionData, SessionHandle, SessionSchema } from \"./handle.js\";\nexport type { AuthState, SessionUser } from \"./parsers.js\";\nexport { SessionTooLargeError, createSessionStore } from \"./store.js\";\nexport type { SessionFailureEvent, SessionStore, SessionStoreOptions } from \"./store.js\";\n// The refresh lock is part of the session surface too (plan decision 8). The module is stateless:\n// the map belongs to the store `memoryLockStore()` returns, so both entries may bundle it.\nexport { memoryLockStore } from \"../core/refresh-lock.js\";\nexport type { RefreshLockStore } from \"../core/refresh-lock.js\";\n// The class `createSessionStore` throws for its options: the same class as in the other entries.\nexport { ConfigError } from \"@plasgos/auth-shared\";\n"],"mappings":";AAAA,SAAS,gBAAgB,kBAAkB,YAAY,UAAU,mBAAmB;AAUpF,IAAM,UAAU;AAChB,IAAM,WAAW;AACjB,IAAM,YAAY;AAClB,IAAM,SAAS;AAiBf,SAAS,IAAI,QAAwB;AACnC,SAAO,OAAO,KAAK,GAAG,OAAO,IAAI,MAAM,IAAI,MAAM;AACnD;AAWO,SAAS,cACd,SACA,QACA,UACS;AACT,QAAM,MAAM,oBAAI,IAAoB;AACpC,MAAI;AACJ,aAAW,UAAU,SAAS;AAC5B,UAAM,MAAM,OAAO;AAAA,MACjB,SAAS,UAAU,OAAO,KAAK,QAAQ,MAAM,GAAG,UAAU,UAAU,MAAM,OAAO,EAAE;AAAA,IACrF;AACA,UAAM,MAAM,WAAW,QAAQ,EAAE,OAAO,GAAG,EAAE,OAAO,WAAW,EAAE,MAAM,GAAG,CAAC;AAC3E,gBAAY,EAAE,KAAK,IAAI;AACvB,QAAI,CAAC,IAAI,IAAI,GAAG,EAAG,KAAI,IAAI,KAAK,GAAG;AAAA,EACrC;AACA,MAAI,YAAY,OAAW,OAAM,IAAI,MAAM,gDAAgD;AAC3F,SAAO,EAAE,SAAS,IAAI;AACxB;AAUO,SAAS,WAAW,QAAgB,OAAgB,MAAuB;AAChF,QAAM,KAAK,YAAY,QAAQ;AAC/B,QAAM,SAAS,eAAe,eAAe,KAAK,QAAQ,KAAK,EAAE;AACjE,SAAO,OAAO,IAAI,MAAM,CAAC;AACzB,QAAM,KAAK,OAAO,OAAO,CAAC,OAAO,OAAO,KAAK,UAAU,KAAK,GAAG,MAAM,GAAG,OAAO,MAAM,CAAC,CAAC;AACvF,QAAM,MAAM,OAAO,WAAW;AAC9B,SAAO;AAAA,IACL;AAAA,IACA,KAAK,QAAQ;AAAA,IACb,GAAG,SAAS,WAAW;AAAA,IACvB,GAAG,SAAS,WAAW;AAAA,IACvB,IAAI,SAAS,WAAW;AAAA,EAC1B,EAAE,KAAK,GAAG;AACZ;AAGA,SAAS,OAAO,MAA6B;AAC3C,MAAI,CAAC,OAAO,KAAK,IAAI,EAAG,QAAO;AAC/B,QAAM,UAAU,OAAO,KAAK,MAAM,WAAW;AAC7C,SAAO,QAAQ,SAAS,WAAW,MAAM,OAAO,UAAU;AAC5D;AAaO,SAAS,WACd,QACA,QACA,MACwC;AACxC,MAAI;AACF,UAAM,QAAQ,OAAO,MAAM,GAAG;AAC9B,QAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,UAAM,CAAC,SAAS,KAAK,QAAQ,QAAQ,OAAO,IAAI;AAChD,QAAI,YAAY,QAAS,QAAO;AAChC,UAAM,MAAM,KAAK,IAAI,IAAI,GAAG;AAC5B,QAAI,QAAQ,OAAW,QAAO;AAC9B,UAAM,KAAK,OAAO,MAAM;AACxB,UAAM,KAAK,OAAO,MAAM;AACxB,UAAM,MAAM,OAAO,OAAO;AAC1B,QAAI,OAAO,QAAQ,OAAO,QAAQ,QAAQ,KAAM,QAAO;AACvD,QAAI,GAAG,WAAW,YAAY,IAAI,WAAW,UAAW,QAAO;AAC/D,UAAM,WAAW,iBAAiB,eAAe,KAAK,IAAI,EAAE,eAAe,UAAU,CAAC;AACtF,aAAS,OAAO,IAAI,MAAM,CAAC;AAC3B,aAAS,WAAW,GAAG;AACvB,UAAM,QAAQ,OAAO,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,SAAS,MAAM,CAAC,CAAC,EAAE,SAAS,MAAM;AACpF,WAAO,EAAE,OAAO,KAAK,MAAM,KAAK,GAAc,IAAI;AAAA,EACpD,QAAQ;AAEN,WAAO;AAAA,EACT;AACF;;;ACjIA,SAAS,aAAa,oBAAoB;;;ACenC,IAAM,oBAAoB,OAAO,OAAO;AAAA,EAC7C,MAAM;AAAA,EACN,cAAc;AAAA,EACd,eAAe;AAAA,EACf,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,MAAM;AAAA,EACN,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,UAAU;AAAA,EACV,WAAW;AACb,CAAU;AAEV,IAAM,cAAc;AACpB,IAAM,WAAW,oBAAI,IAAI,CAAC,aAAa,eAAe,WAAW,CAAC;AAElE,IAAM,QAAQ,CAAC,UACb,OAAO,UAAU,YAAY,YAAY,KAAK,KAAK,KAAK,CAAC,SAAS,IAAI,KAAK;AAG7E,SAAS,cAAc,OAAoC;AACzD,QAAM,SAAS,IAAI,IAAqB,OAAO,QAAQ,iBAAiB,CAAC;AACzE,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,KAAK,EAAG,QAAO,IAAI,MAAM,KAAK;AACzE,SAAO,CAAC,GAAG,MAAM;AACnB;AASO,SAAS,mBAAmB,OAA0B;AAC3D,MAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;AACvE,WAAO,CAAC,+BAA+B;AAAA,EACzC;AACA,QAAM,UAAU,OAAO,QAAQ,KAAK;AACpC,MAAI,QAAQ,KAAK,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,GAAG;AAClE,WAAO,CAAC,qFAAqF;AAAA,EAC/F;AAEA,QAAM,WAAqB,CAAC;AAC5B,QAAM,OAAO,IAAI,IAAoB,OAAO,QAAQ,iBAAiB,CAAC;AACtE,aAAW,CAAC,MAAM,KAAK,KAAK,SAAS;AACnC,UAAM,WAAW,KAAK,IAAI,IAAI;AAC9B,QAAI,aAAa,UAAa,UAAU,UAAU;AAChD,eAAS,KAAK,iBAAiB,IAAI,kBAAkB,QAAQ,GAAG;AAAA,IAClE;AAAA,EACF;AACA,MAAI,SAAS,SAAS,EAAG,QAAO;AAEhC,QAAM,SAAS,cAAc,KAAK;AAClC,QAAM,QAAQ,IAAI,IAAI,OAAO,IAAI,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC;AAClD,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,WAAW,oBAAI,IAAY;AACjC,aAAW,CAAC,EAAE,KAAK,KAAK,QAAQ;AAC9B,QAAI,KAAK,IAAI,KAAK,KAAK,CAAC,SAAS,IAAI,KAAK,GAAG;AAC3C,eAAS,IAAI,KAAK;AAClB,eAAS,KAAK,2BAA2B,KAAK,iBAAiB;AAAA,IACjE;AACA,SAAK,IAAI,KAAK;AACd,QAAI,MAAM,IAAI,KAAK,EAAG,UAAS,KAAK,2BAA2B,KAAK,sBAAsB;AAAA,EAC5F;AACA,SAAO;AACT;AAeA,SAAS,WAAW,OAAgB,OAA6C;AAC/E,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,CAAC,SAAS,WAAW,MAAM,KAAK,CAAC;AAC5E,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,QAAM,MAA+B,CAAC;AACtC,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC/C,UAAM,SAAS,MAAM,IAAI,GAAG;AAC5B,QAAI,WAAW,OAAW,KAAI,MAAM,IAAI,WAAW,MAAM,KAAK;AAAA,EAChE;AACA,SAAO;AACT;AAEA,IAAM,WAAqB,EAAE,SAAS,CAAC,UAAU,OAAO,QAAQ,CAAC,UAAU,MAAM;AAY1E,SAAS,eAAe,OAA+D;AAC5F,MAAI,UAAU,OAAW,QAAO;AAChC,QAAM,SAAS,cAAc,KAAK;AAClC,QAAM,SAAS,IAAI,IAAI,MAAM;AAC7B,QAAM,QAAQ,IAAI,IAAI,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;AAClE,SAAO;AAAA,IACL,SAAS,CAAC,UAAU,WAAW,OAAO,MAAM;AAAA,IAC5C,QAAQ,CAAC,UAAU,WAAW,OAAO,KAAK;AAAA,EAC5C;AACF;;;ACpHO,SAAS,YAAY,QAAmC,MAA6B;AAC1F,MAAI,WAAW,QAAQ,WAAW,UAAa,WAAW,GAAI,QAAO;AACrE,aAAW,QAAQ,OAAO,MAAM,GAAG,GAAG;AACpC,UAAM,KAAK,KAAK,QAAQ,GAAG;AAC3B,QAAI,OAAO,GAAI;AACf,QAAI,KAAK,MAAM,GAAG,EAAE,EAAE,KAAK,MAAM,KAAM,QAAO,KAAK,MAAM,KAAK,CAAC,EAAE,KAAK;AAAA,EACxE;AACA,SAAO;AACT;AAWO,SAAS,UACd,MACA,OACA,QACA,QACQ;AACR,QAAM,QAAQ,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE;AACjC,MAAI,WAAW,OAAW,OAAM,KAAK,WAAW,OAAO,MAAM,CAAC,EAAE;AAChE,QAAM,KAAK,UAAU,UAAU;AAC/B,MAAI,OAAQ,OAAM,KAAK,QAAQ;AAC/B,QAAM,KAAK,cAAc;AACzB,SAAO,MAAM,KAAK,IAAI;AACxB;;;ACgBA,IAAM,UAAU,CAAC,KAAU,SACzB,OAAO,YAAY,OAAO,QAAQ,GAAG,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AAU7E,SAAS,oBACd,MACA,WACA,WACoB;AACpB,MAAI,MAAW,EAAE,GAAG,KAAK;AACzB,MAAI,OAAO;AACX,MAAI,OAAO;AACX,SAAO;AAAA,IACL,IAAI,OAAO;AACT,aAAO;AAAA,IACT;AAAA,IACA,IAAI,QAAQ;AACV,aAAO,QAAQ;AAAA,IACjB;AAAA,IACA,IAAI,YAAY;AACd,aAAO;AAAA,IACT;AAAA,IACA,IAAI,YAAY;AACd,aAAO;AAAA,IACT;AAAA,IACA,OAAO,OAAO;AACZ,YAAM,UAAe,EAAE,GAAG,MAAM;AAEhC,UACE,OAAO,OAAO,SAAS,MAAM,KAC7B,KAAK,UAAU,QAAQ,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,GAC9D;AACA,eAAO;AAAA,MACT;AACA,UAAI,OAAO,KAAK,OAAO,EAAE,KAAK,CAAC,QAAQ,QAAQ,MAAM,EAAG,QAAO;AAC/D,YAAM,QAAQ,EAAE,GAAG,KAAK,GAAG,QAAQ,GAAG,CAAC,MAAM,UAAU,UAAU,MAAS;AAAA,IAC5E;AAAA,IACA,MAAM,KAAK;AACT,UAAI,CAAC,OAAO,OAAO,KAAK,GAAG,EAAG;AAC9B,YAAM,QAAQ,KAAK,CAAC,cAAc,cAAc,GAAG;AACnD,UAAI,QAAQ,OAAQ,QAAO;AAAA,UACtB,QAAO;AAAA,IACd;AAAA,IACA,UAAU;AACR,YAAM,CAAC;AACP,aAAO;AACP,aAAO;AAAA,IACT;AAAA,EACF;AACF;;;AC3DA,IAAM,YAAY;AAClB,IAAM,WAAW;AAGjB,SAAS,SAAS,OAAkD;AAClE,SAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,IAAM,MAAM,CAAC,QAAiC,QAC5C,OAAO,OAAO,QAAQ,GAAG,IAAI,OAAO,GAAG,IAAI;AAE7C,IAAM,UAAU,CAAC,UACf,OAAO,UAAU,YAAY,MAAM,UAAU,KAAK,MAAM,UAAU;AAEpE,IAAM,SAAS,CAAC,UACd,OAAO,UAAU,YAAY,MAAM,UAAU;AAE/C,IAAM,iBAAiB,CAAC,UAAoC,OAAO,KAAK,KAAK,MAAM,UAAU;AAG7F,IAAM,UAAU,CAAC,UACf,OAAO,UAAU,YAAY,OAAO,cAAc,KAAK,KAAK,SAAS;AAEvE,SAAS,UAAU,OAAoC;AACrD,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,KAAK,IAAI,OAAO,IAAI;AAC1B,QAAM,OAAO,IAAI,OAAO,MAAM;AAC9B,QAAM,QAAQ,IAAI,OAAO,OAAO;AAChC,QAAM,SAAS,IAAI,OAAO,YAAY;AACtC,MAAI,CAAC,eAAe,EAAE,KAAK,CAAC,OAAO,IAAI,EAAG,QAAO;AACjD,MAAI,UAAU,UAAa,UAAU,QAAQ,CAAC,OAAO,KAAK,EAAG,QAAO;AACpE,MAAI,WAAW,QAAQ,CAAC,OAAO,MAAM,EAAG,QAAO;AAC/C,SAAO,EAAE,IAAI,MAAM,GAAI,UAAU,SAAY,EAAE,MAAM,IAAI,CAAC,GAAI,YAAY,OAAO;AACnF;AAEA,SAAS,eAAe,OAAkC;AACxD,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,cAAc,IAAI,OAAO,cAAc;AAC7C,QAAM,eAAe,IAAI,OAAO,eAAe;AAC/C,QAAM,YAAY,IAAI,OAAO,YAAY;AACzC,QAAM,WAAW,IAAI,OAAO,WAAW;AACvC,QAAM,WAAW,IAAI,OAAO,UAAU;AACtC,QAAM,OAAO,UAAU,IAAI,OAAO,MAAM,CAAC;AACzC,MAAI,CAAC,QAAQ,WAAW,KAAK,CAAC,QAAQ,SAAS,KAAK,SAAS,KAAM,QAAO;AAC1E,MAAI,iBAAiB,UAAa,CAAC,QAAQ,YAAY,EAAG,QAAO;AACjE,MAAI,aAAa,UAAa,CAAC,QAAQ,QAAQ,EAAG,QAAO;AACzD,MAAI,aAAa,UAAa,OAAO,aAAa,UAAW,QAAO;AACpE,SAAO;AAAA,IACL,cAAc;AAAA,IACd,GAAI,iBAAiB,SAAY,EAAE,eAAe,aAAa,IAAI,CAAC;AAAA,IACpE,YAAY;AAAA,IACZ,GAAI,aAAa,SAAY,EAAE,SAAS,IAAI,CAAC;AAAA,IAC7C;AAAA,IACA,GAAI,aAAa,SAAY,EAAE,WAAW,SAAS,IAAI,CAAC;AAAA,EAC1D;AACF;AASO,SAAS,cAAc,OAA6C;AACzE,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,MAAM,IAAI,OAAO,MAAM;AAC7B,MAAI,QAAQ,OAAW,QAAO,CAAC;AAC/B,QAAM,OAAO,eAAe,GAAG;AAC/B,SAAO,SAAS,OAAO,OAAO,EAAE,KAAK;AACvC;AAQO,SAAS,iBAAiB,OAA6C;AAC5E,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,UAAU,IAAI,OAAO,UAAU;AACrC,SAAO,QAAQ,OAAO,IAAI,EAAE,UAAU,QAAQ,IAAI;AACpD;AASO,SAAS,iBAAiB,OAAwC;AACvE,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,QAAQ,IAAI,OAAO,OAAO;AAChC,QAAM,QAAQ,IAAI,OAAO,OAAO;AAChC,QAAM,eAAe,IAAI,OAAO,eAAe;AAC/C,QAAM,WAAW,IAAI,OAAO,WAAW;AACvC,QAAM,YAAY,IAAI,OAAO,YAAY;AACzC,QAAM,SAAS,IAAI,OAAO,QAAQ;AAClC,QAAM,SAAS,IAAI,OAAO,SAAS;AACnC,MAAI,CAAC,eAAe,KAAK,KAAK,CAAC,eAAe,KAAK,KAAK,CAAC,eAAe,YAAY,EAAG,QAAO;AAC9F,MAAI,CAAC,OAAO,QAAQ,KAAK,CAAC,QAAQ,SAAS,EAAG,QAAO;AACrD,MAAI,WAAW,UAAa,OAAO,WAAW,UAAW,QAAO;AAChE,MAAI,WAAW,UAAa,CAAC,QAAQ,MAAM,EAAG,QAAO;AACrD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,eAAe;AAAA,IACf,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,GAAI,WAAW,SAAY,EAAE,OAAO,IAAI,CAAC;AAAA,IACzC,GAAI,WAAW,SAAY,EAAE,SAAS,OAAO,IAAI,CAAC;AAAA,EACpD;AACF;;;AJpJA,IAAM,uBAAuB;AAE7B,IAAM,8BAA8B;AAEpC,IAAM,gBAAgB;AACtB,IAAM,mBAAmB;AACzB,IAAM,cAAc;AACpB,IAAM,QAAQ,CAAC,OAAO,QAAQ,WAAW,aAAa;AAoC/C,IAAM,uBAAN,cAAmC,MAAM;AAAA;AAAA,EAErC;AAAA;AAAA,EAGT,YAAY,MAAc;AACxB,UAAM,6BAA6B,OAAO,IAAI,CAAC,iBAAiB,OAAO,oBAAoB,CAAC,GAAG;AAC/F,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;AAmFA,IAAM,oBAAoB,CAAC,UACzB,OAAO,UAAU,YAAY,OAAO,cAAc,KAAK,KAAK,QAAQ;AAEtE,IAAM,WAAW,CAAC,UAChB,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAGrE,SAAS,YAAY,KAAwB;AAC3C,MAAI,CAAC,SAAS,GAAG,EAAG,OAAM,IAAI,YAAY,CAAC,2BAA2B,CAAC;AACvE,QAAM,WAAqB,CAAC;AAC5B,QAAM,EAAE,aAAa,YAAY,UAAU,SAAS,SAAS,kBAAkB,IAAI;AACnF,QAAM,EAAE,WAAW,aAAa,UAAU,IAAI;AAE9C,MAAI,OAAO,gBAAgB,YAAY,CAAE,aAAmC,SAAS,WAAW,GAAG;AACjG,aAAS,KAAK,+CAA+C;AAAA,EAC/D;AACA,MAAI,eAAe,UAAa,OAAO,eAAe,WAAW;AAC/D,aAAS,KAAK,8BAA8B;AAAA,EAC9C,WAAW,eAAe,SAAS,gBAAgB,cAAc;AAC/D,aAAS,KAAK,mEAAmE;AAAA,EACnF;AAEA,MAAI,aAAa,UAAa,aAAa,QAAQ,aAAa,IAAI;AAClE,aAAS,KAAK,sBAAsB;AAAA,EACtC,WAAW,OAAO,aAAa,UAAU;AACvC,aAAS,KAAK,2BAA2B;AAAA,EAC3C;AAEA,QAAM,aACJ,MAAM,QAAQ,OAAO,KAAK,QAAQ,MAAM,CAAC,WAAW,OAAO,WAAW,QAAQ,IAC1E,UACA,CAAC;AACP,MAAI,WAAW,SAAS,KAAK,WAAW,SAAS,GAAG;AAClD,aAAS,KAAK,qCAAqC;AAAA,EACrD,WAAW,WAAW,KAAK,CAAC,WAAW,OAAO,WAAW,QAAQ,MAAM,IAAI,gBAAgB,GAAG;AAC5F,aAAS,KAAK,+CAA+C;AAAA,EAC/D;AAEA,QAAM,QAA8B,CAAC;AACrC,QAAM,QAAQ,SAAS,OAAO,IAAI,UAAU,CAAC;AAC7C,aAAW,QAAQ,OAAO;AACxB,UAAM,OAAO,OAAO,OAAO,OAAO,IAAI,IAAI,MAAM,IAAI,IAAI;AACxD,QAAI,OAAO,SAAS,YAAY,YAAY,KAAK,IAAI,EAAG,OAAM,IAAI,IAAI;AAAA,QACjE,UAAS,KAAK,WAAW,IAAI,iCAAiC;AAAA,EACrE;AACA,QAAM,WAAW,OAAO,OAAO,KAAK;AACpC,MAAI,SAAS,WAAW,MAAM,UAAU,IAAI,IAAI,QAAQ,EAAE,SAAS,MAAM,QAAQ;AAC/E,aAAS,KAAK,gCAAgC;AAAA,EAChD;AAEA,MAAI,CAAC,kBAAkB,iBAAiB,KAAK,OAAO,sBAAsB,YAAY;AACpF,aAAS,KAAK,4DAA4D;AAAA,EAC5E;AACA,QAAM,QAAQ,SAAS,SAAS,IAAI,UAAU,OAAO,IAAI;AACzD,MAAI,OAAO,UAAU,WAAY,UAAS,KAAK,sCAAsC;AACrF,MAAI,gBAAgB,OAAW,UAAS,KAAK,GAAG,mBAAmB,WAAW,CAAC;AAC/E,MAAI,cAAc,UAAa,OAAO,cAAc,YAAY;AAC9D,aAAS,KAAK,8BAA8B;AAAA,EAC9C;AAEA,MAAI,SAAS,SAAS,EAAG,OAAM,IAAI,YAAY,QAAQ;AACvD,SAAO;AAAA,IACL,SAAS;AAAA,IACT;AAAA,IACA,SAAS;AAAA,IACT,QAAQ,eAAe;AAAA,IACvB,YAAY;AAAA,IACZ,UAAU,CAAC,UAAW,UAAqC,MAAM,KAAK;AAAA,IACtE;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,UAAU,QAAwB;AACzC,MAAI,OAAO,SAAS,qBAAsB,OAAM,IAAI,qBAAqB,OAAO,MAAM;AACtF,SAAO;AACT;AAGA,SAAS,aACP,QACA,QACA,MACA,QACQ;AACR,MAAI;AACF,WAAO,OAAO;AAAA,EAChB,SAAS,OAAO;AACd,QAAI,EAAE,iBAAiB,sBAAuB,OAAM;AACpD,WAAO,EAAE,MAAM,qBAAqB,QAAQ,MAAM,MAAM,KAAK,CAAC;AAC9D,SAAK;AACL,WAAO,OAAO;AAAA,EAChB;AACF;AAiBO,SAAS,mBACd,SACmB;AACnB,QAAM,WAAW,YAAY,OAAO;AACpC,QAAM,EAAE,SAAS,OAAO,IAAI;AAC5B,QAAM,QAAQ,eAAe,SAAS,WAAW;AACjD,QAAM,OAAO,CAAC,SAAwB,MAAM,IAAI;AAChD,QAAM,QAA+B;AAAA,IACnC,KAAK,cAAc,SAAS,SAAS,QAAQ,KAAK,SAAS,QAAQ;AAAA,IACnE,MAAM,cAAc,SAAS,SAAS,QAAQ,MAAM,SAAS,QAAQ;AAAA,IACrE,SAAS,cAAc,SAAS,SAAS,QAAQ,SAAS,SAAS,QAAQ;AAAA,IAC3E,aAAa,cAAc,SAAS,SAAS,QAAQ,aAAa,SAAS,QAAQ;AAAA,EACrF;AACA,QAAM,WAAW,CAAC,SAAwB,SAAS,UAAU,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI;AAC3F,QAAM,cAAc,OAAO,OAAO;AAAA,IAChC,KAAK,SAAS,KAAK;AAAA,IACnB,MAAM,SAAS,MAAM;AAAA,IACrB,SAAS,SAAS,SAAS;AAAA,IAC3B,aAAa,SAAS,aAAa;AAAA,EACrC,CAAC;AAED,QAAM,WAAW,CAAC,UAChB,OAAO,UAAU,WAAW,QAAS,OAAO,QAAQ,IAAI,QAAQ,KAAK;AAGvE,QAAM,OAAO,CAAC,QAAuB,SAAuD;AAC1F,UAAM,MAAM,YAAY,QAAQ,YAAY,IAAI,CAAC;AACjD,QAAI,QAAQ,QAAQ,QAAQ,GAAI,QAAO;AACvC,WAAO,WAAW,QAAQ,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC;AAAA,EAClD;AAEA,QAAM,OAAO,CAAC,MAAY,OAAgB,WACxC,UAAU,YAAY,IAAI,GAAG,WAAW,QAAQ,IAAI,GAAG,OAAO,KAAK,IAAI,CAAC,GAAG,QAAQ,MAAM;AAE3F,QAAM,SAAS,CAAC,SAAuB,UAAU,YAAY,IAAI,GAAG,IAAI,GAAG,MAAM;AAGjF,QAAM,WAAW,CAAC,UAAmD;AACnE,QAAI;AACJ,QAAI;AACF,eAAS,SAAS,SAAS,KAAK;AAAA,IAClC,QAAQ;AAEN,aAAO;AAAA,IACT;AACA,QAAI,CAAC,SAAS,MAAM,EAAG,QAAO;AAC9B,WAAO,OAAO,YAAY,OAAO,QAAQ,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,QAAQ,MAAM,CAAC;AAAA,EACpF;AAEA,QAAM,aAAa,CAAC,SAA4B;AAC9C,UAAM,EAAE,YAAY,QAAQ,IAAI;AAChC,QAAI,OAAO,YAAY,SAAU,QAAO;AACxC,UAAM,UAAmB,QAAQ,IAAI;AACrC,QAAI,CAAC,kBAAkB,OAAO,GAAG;AAC/B,YAAM,IAAI,YAAY,CAAC,kDAAkD,CAAC;AAAA,IAC5E;AACA,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,CAAC,SAA4B;AAC9C,UAAM,SAAS,WAAW,IAAI;AAC9B,UAAM,SAAS,OAAO,YAAY,OAAO,QAAQ,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,QAAQ,UAAU,CAAC;AAC5F,WAAO,KAAK,QAAQ,MAAM,QAAQ,EAAE,MAAM,OAAO,CAAC,GAAG,MAAM;AAAA,EAC7D;AAEA,QAAM,gBAAgB,CAAC,MAAiB,YACtC,KAAK,WAAW,MAAM,QAAQ,EAAE,UAAU,QAAQ,CAAC,GAAG,WAAW,IAAI,CAAC;AAExE,QAAM,SAAS,CAAC,UAAqC;AACnD,QAAI;AACF,eAAS,YAAY,KAAK;AAAA,IAC5B,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,QAAM,QAA2B;AAAA,IAC/B;AAAA,IAEA,KAAK,OAAO;AACV,YAAM,SAAS,SAAS,KAAK;AAC7B,YAAM,YAAY,KAAK,QAAQ,KAAK;AACpC,YAAM,OAAO,cAAc,OAAO,OAAO,SAAS,MAAM,OAAO,UAAU,KAAK,CAAC;AAC/E,YAAM,aAAa,KAAK,QAAQ,MAAM;AACtC,UAAI,OAAO,eAAe,OAAO,SAAY,cAAc,MAAM,OAAO,WAAW,KAAK,CAAC,GAAG;AAC5F,UAAI,SAAS,QAAW;AACtB,cAAM,WAAW,KAAK,QAAQ,SAAS;AACvC,cAAM,SAAS,aAAa,OAAO,OAAO,iBAAiB,MAAM,OAAO,SAAS,KAAK,CAAC;AACvF,YAAI,WAAW,KAAM,QAAO,EAAE,GAAG,MAAM,UAAU,OAAO,SAAS;AAAA,MACnE;AACA,YAAM,OAAO,EAAE,GAAG,MAAM,GAAI,SAAS,SAAY,EAAE,KAAK,IAAI,CAAC,EAAG;AAGhE,YAAM,UAAU,SAAS,QAAQ,WAAW,QAAQ,KAAK,KAAK,EAAE,QAAQ;AACxE,aAAO,oBAAyB,MAAM,OAAO,OAAO;AAAA,IACtD;AAAA,IAEA,UAAU,SAAS;AACjB,YAAM,OAAO,OAAO;AAAA,QAClB,OAAO,QAAQ,QAAQ,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,MAAM,QAAQ,UAAU,UAAU,MAAS;AAAA,MAC7F;AACA,UAAI,OAAO,KAAK,IAAI,EAAE,WAAW,EAAG,QAAO,OAAO,KAAK;AACvD,aAAO,UAAU,KAAK,OAAO,MAAM,QAAQ,IAAI,GAAG,MAAS,CAAC;AAAA,IAC9D;AAAA,IAEA,WAAW,SAAS;AAClB,YAAM,EAAE,KAAK,IAAI,QAAQ;AACzB,UAAI,SAAS,OAAW,QAAO,OAAO,MAAM;AAC5C,aAAO,UAAU,WAAW,IAAI,CAAC;AAAA,IACnC;AAAA,IAEA,cAAc,SAAS;AACrB,YAAM,EAAE,KAAK,IAAI,QAAQ;AACzB,UAAI,MAAM,aAAa,UAAa,KAAK,aAAa,GAAI,QAAO,OAAO,SAAS;AACjF,aAAO,UAAU,cAAc,MAAM,KAAK,QAAQ,CAAC;AAAA,IACrD;AAAA,IAEA,KAAK,MAAM;AACT,YAAM,UAAU,KAAK;AACrB,aAAO;AAAA,QACL,MAAM,WAAW,IAAI,EAAE,UAAU;AAAA,QACjC,SACE,YAAY,UACZ,YAAY,MACZ,cAAc,MAAM,OAAO,EAAE,UAAU;AAAA,MAC3C;AAAA,IACF;AAAA,IAEA,OAAO,SAAS;AACd,YAAM,MAAgB,CAAC;AACvB,UAAI,QAAQ,WAAW;AACrB,YAAI;AAAA,UACF;AAAA,YACE;AAAA,YACA,MAAM,MAAM,UAAU,OAAO;AAAA,YAC7B,MAAM;AAEJ,yBAAW,OAAO,OAAO,KAAK,QAAQ,IAAI,GAAG;AAC3C,oBAAI,QAAQ,OAAQ,SAAQ,MAAM,GAA6B;AAAA,cACjE;AAAA,YACF;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAAA,MACF;AACA,UAAI,CAAC,QAAQ,UAAW,QAAO;AAE/B,UAAI;AAAA,QACF;AAAA,UACE;AAAA,UACA,MAAM,MAAM,WAAW,OAAO;AAAA,UAC9B,MAAM;AACJ,oBAAQ,MAAM,MAAM;AAAA,UACtB;AAAA,UACA;AAAA,QACF;AAAA,MACF;AACA,UAAI;AAAA,QACF;AAAA,UACE;AAAA,UACA,MAAM,MAAM,cAAc,OAAO;AAAA,UACjC,MAAM;AAEJ,kBAAM,EAAE,KAAK,IAAI,QAAQ;AACzB,gBAAI,SAAS,OAAW;AACxB,kBAAM,OAAO,OAAO,YAAY,OAAO,QAAQ,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,QAAQ,UAAU,CAAC;AAC1F,oBAAQ,OAAO,EAAE,MAAM,KAAK,CAAgD;AAAA,UAC9E;AAAA,UACA;AAAA,QACF;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA,IAEA,gBAAgB,OAAO,MAAM,KAAK,IAAI,GAAG;AAEvC,YAAM,KAAK,iBAAiB,KAAK,SAAS,KAAK,GAAG,aAAa,GAAG,KAAK;AACvE,UAAI,OAAO,KAAM,QAAO;AACxB,YAAM,MAAM,MAAM,GAAG;AAErB,UAAI,EAAE,OAAO,CAAC,iBAAiB,OAAO,8BAA8B,KAAO,QAAO;AAClF,aAAO;AAAA,IACT;AAAA,IAEA,kBAAkB,IAAI;AACpB,aAAO,KAAK,eAAe,IAAI,2BAA2B;AAAA,IAC5D;AAAA,IAEA,mBAAmB;AACjB,aAAO,OAAO,aAAa;AAAA,IAC7B;AAAA,EACF;AACA,SAAO;AACT;;;AKpaO,SAAS,gBAAgB,UAAgD,CAAC,GAAqB;AACpG,QAAM,MAAM,QAAQ,OAAO,KAAK;AAChC,QAAM,QAAQ,oBAAI,IAAuB;AAEzC,SAAO;AAAA,IACL,IAAI,KAAK,SAAS,SAAS;AACzB,YAAM,IAAI,IAAI;AACd,iBAAW,CAAC,WAAWA,MAAK,KAAK,OAAO;AACtC,YAAIA,OAAM,cAAc,UAAa,IAAIA,OAAM,aAAaA,OAAM,QAAS,OAAM,OAAO,SAAS;AAAA,MACnG;AACA,YAAM,MAAM,MAAM,IAAI,GAAG;AACzB,UAAI,IAAK,QAAO,IAAI;AAEpB,YAAM,QAAmB,EAAE,SAAS,QAAQ,GAAG,QAAQ;AACvD,YAAM,IAAI,KAAK,KAAK;AACpB,YAAM,QAAQ;AAAA,QACZ,MAAM;AACJ,gBAAM,YAAY,IAAI;AAAA,QACxB;AAAA,QACA,MAAM;AACJ,cAAI,MAAM,IAAI,GAAG,MAAM,MAAO,OAAM,OAAO,GAAG;AAAA,QAChD;AAAA,MACF;AACA,aAAO,MAAM;AAAA,IACf;AAAA,EACF;AACF;;;ACvDA,SAAS,eAAAC,oBAAmB;","names":["entry","ConfigError"]}
1
+ {"version":3,"sources":["../src/session/cookie-crypto.ts","../src/session/store.ts","../src/session/compact-keys.ts","../src/session/cookie-header.ts","../src/session/handle.ts","../src/session/parsers.ts","../src/core/refresh-lock.ts","../src/session/index.ts"],"sourcesContent":["import { createCipheriv, createDecipheriv, createHash, hkdfSync, randomBytes } from \"node:crypto\";\n\n/*\n * Cookie sealing, wire format v1. AES-256-GCM with one HKDF key per cookie name and the cookie name\n * bound as AAD; a sealed value is `v1.<kid>.<iv>.<ct>.<tag>` (base64url). The format is the one\n * plasgos-shipping-v2 and plasgos-accounts-v2 already use, so a change here logs every user out.\n * Anything that fails to open is null: this module never throws on a sealed input and never puts\n * cookie contents in an error.\n */\n\nconst VERSION = \"v1\";\nconst IV_BYTES = 12;\nconst TAG_BYTES = 16;\nconst B64URL = /^[A-Za-z0-9_-]*$/;\n\n/**\n * The keys of one cookie: `current` seals, every key in `all` (by kid) opens.\n *\n * @example\n * const ring: KeyRing = deriveKeyRing([process.env.SESSION_SECRET ?? \"\"], \"kp\", \"plasgos-shipping-v2\");\n * ring.all.has(ring.current.kid); // true\n */\nexport interface KeyRing {\n /** The key that seals: derived from the first secret. */\n readonly current: { readonly kid: string; readonly key: Buffer };\n /** Every key that opens, by kid. */\n readonly all: ReadonlyMap<string, Buffer>;\n}\n\n/** AAD binds the format version and the cookie name: a v2 format cannot accept relabelled v1 data. */\nfunction aad(cookie: string): Buffer {\n return Buffer.from(`${VERSION}.${cookie}`, \"utf8\");\n}\n\n/**\n * Derives the key ring of one cookie: HKDF-SHA256(secret, hkdfSalt, \"cookie:<cookie>:v1\", 32) per\n * secret. The first secret seals, all of them open; the kid is the first 8 base64url characters of\n * the key's SHA-256. Throws when `secrets` is empty.\n *\n * @example\n * // Rotation: the new secret first, the old one kept until its cookies have expired.\n * const ring = deriveKeyRing([newSecret, oldSecret], \"kp-auth\", \"plasgos-shipping-v2\");\n */\nexport function deriveKeyRing(\n secrets: readonly string[],\n cookie: string,\n hkdfSalt: string,\n): KeyRing {\n const all = new Map<string, Buffer>();\n let current: KeyRing[\"current\"] | undefined;\n for (const secret of secrets) {\n const key = Buffer.from(\n hkdfSync(\"sha256\", Buffer.from(secret, \"utf8\"), hkdfSalt, `cookie:${cookie}:v1`, 32),\n );\n const kid = createHash(\"sha256\").update(key).digest(\"base64url\").slice(0, 8);\n current ??= { kid, key };\n if (!all.has(kid)) all.set(kid, key);\n }\n if (current === undefined) throw new Error(\"deriveKeyRing: at least one secret is required\");\n return { current, all };\n}\n\n/**\n * Seals `value` (as JSON) for the cookie named `cookie` with `ring.current`: AES-256-GCM, a fresh\n * random 96-bit IV, AAD `v1.<cookie>`, wire format `v1.<kid>.<iv>.<ct>.<tag>` (base64url).\n *\n * @example\n * const sealed = sealCookie(\"kp\", { theme: \"dark\" }, ring);\n * // \"v1.<kid>.<iv>.<ct>.<tag>\"\n */\nexport function sealCookie(cookie: string, value: unknown, ring: KeyRing): string {\n const iv = randomBytes(IV_BYTES);\n const cipher = createCipheriv(\"aes-256-gcm\", ring.current.key, iv);\n cipher.setAAD(aad(cookie));\n const ct = Buffer.concat([cipher.update(JSON.stringify(value), \"utf8\"), cipher.final()]);\n const tag = cipher.getAuthTag();\n return [\n VERSION,\n ring.current.kid,\n iv.toString(\"base64url\"),\n ct.toString(\"base64url\"),\n tag.toString(\"base64url\"),\n ].join(\".\");\n}\n\n/** Strict base64url: only the canonical spelling (no padding, no slack bits, no other characters). */\nfunction decode(part: string): Buffer | null {\n if (!B64URL.test(part)) return null;\n const decoded = Buffer.from(part, \"base64url\");\n return decoded.toString(\"base64url\") === part ? decoded : null;\n}\n\n/**\n * Opens a value sealed by {@link sealCookie} for the same cookie name. Returns the value and the kid\n * of the key that opened it (compare with `ring.current.kid` to re-seal after a rotation), or null\n * for anything that does not open: malformed, tampered, another key, another cookie name. Never\n * throws on input.\n *\n * @example\n * const opened = openCookie(\"kp\", sealed, ring);\n * if (opened === null) return null; // no session\n * const needsReseal = opened.kid !== ring.current.kid;\n */\nexport function openCookie(\n cookie: string,\n sealed: string,\n ring: KeyRing,\n): { value: unknown; kid: string } | null {\n try {\n const parts = sealed.split(\".\");\n if (parts.length !== 5) return null;\n const [version, kid, ivPart, ctPart, tagPart] = parts as [string, string, string, string, string];\n if (version !== VERSION) return null;\n const key = ring.all.get(kid);\n if (key === undefined) return null;\n const iv = decode(ivPart);\n const ct = decode(ctPart);\n const tag = decode(tagPart);\n if (iv === null || ct === null || tag === null) return null;\n if (iv.length !== IV_BYTES || tag.length !== TAG_BYTES) return null;\n const decipher = createDecipheriv(\"aes-256-gcm\", key, iv, { authTagLength: TAG_BYTES });\n decipher.setAAD(aad(cookie));\n decipher.setAuthTag(tag);\n const plain = Buffer.concat([decipher.update(ct), decipher.final()]).toString(\"utf8\");\n return { value: JSON.parse(plain) as unknown, kid };\n } catch {\n // A tampered or foreign value fails in node:crypto (auth tag) or in JSON.parse: never a session.\n return null;\n }\n}\n","import { ConfigError, ENVIRONMENTS } from \"@plasgos/auth-shared\";\nimport type { Environment } from \"@plasgos/auth-shared\";\n\nimport type { OidcTransaction } from \"../core/types.js\";\nimport { compactKeyProblems, createKeyCodec } from \"./compact-keys.js\";\nimport { deriveKeyRing, openCookie, sealCookie } from \"./cookie-crypto.js\";\nimport type { KeyRing } from \"./cookie-crypto.js\";\nimport { cookieValue, serialize } from \"./cookie-header.js\";\nimport { createSessionHandle } from \"./handle.js\";\nimport type { SessionData, SessionHandle, SessionSchema } from \"./handle.js\";\nimport { parseAuthPart, parseIdTokenPart, parseTransaction } from \"./parsers.js\";\nimport type { AuthState } from \"./parsers.js\";\n\n/*\n * Sealed session cookies: the app cookie (everything but auth), the auth cookie (tokens and user),\n * the idToken cookie (the ID token, kept for the logout; never in a URL) and the OIDC transaction\n * cookie. Ported from plasgos-shipping-v2 and plasgos-accounts-v2; names, salt and key table are\n * options so each app keeps opening the cookies it already sent. Anything that fails to open is\n * \"no session\": nothing here throws on a cookie or reports its contents.\n */\n\n/** Largest Set-Cookie value a commit emits; browsers drop name plus value above 4096. */\nconst MAX_SET_COOKIE_CHARS = 4000;\n/** Lifetime of the transaction cookie and of the transaction itself. */\nconst TRANSACTION_MAX_AGE_SECONDS = 600;\n/** Tolerated future `created_at` on a transaction (clock skew between instances). */\nconst CLOCK_SKEW_MS = 5000;\nconst MIN_SECRET_BYTES = 32;\nconst COOKIE_NAME = /^[a-z0-9-]{1,32}$/;\nconst ROLES = [\"app\", \"auth\", \"idToken\", \"transaction\"] as const;\n\ntype Role = (typeof ROLES)[number];\ntype CookieNames = Record<Role, string>;\ntype CookieInput = Request | string | null | undefined;\n\n/**\n * What `commit()` reports when a cookie did not fit and was expired instead. Sizes only.\n *\n * @example\n * createSessionStore({\n * ...options,\n * onFailure: (event) => logger.warn(`session cookie ${event.cookie} dropped: ${String(event.size)} chars`),\n * });\n */\nexport type SessionFailureEvent = {\n /** The only kind so far. */\n kind: \"session_too_large\";\n /** The cookie that did not fit. */\n cookie: \"app\" | \"auth\" | \"idToken\";\n /** Length of the refused `Set-Cookie` value, in characters. */\n size: number;\n};\n\n/**\n * A cookie would not fit in a browser. Thrown by `commitApp`, `commitAuth` and `commitIdToken`;\n * `commit()` handles it itself.\n *\n * @example\n * try {\n * headers.append(\"Set-Cookie\", store.commitAuth(session));\n * } catch (error) {\n * if (error instanceof SessionTooLargeError) return loginFailed();\n * throw error;\n * }\n */\nexport class SessionTooLargeError extends Error {\n /** Length of the refused `Set-Cookie` value, in characters. */\n readonly size: number;\n\n /** Message \"Session cookie too large: <size> chars (limit 4000)\"; never the cookie value. */\n constructor(size: number) {\n super(`Session cookie too large: ${String(size)} chars (limit ${String(MAX_SET_COOKIE_CHARS)})`);\n this.name = \"SessionTooLargeError\";\n this.size = size;\n }\n}\n\n/**\n * Options of {@link createSessionStore}. For an app that already has sessions, `hkdfSalt`,\n * `cookies` and `compactKeys` must stay exactly what the app uses today.\n *\n * @example\n * const options: SessionStoreOptions<{ flash?: string }> = {\n * environment: \"production\",\n * secrets: [process.env.SESSION_SECRET ?? \"\"],\n * hkdfSalt: \"my-app\",\n * cookies: { app: \"my\", auth: \"my-auth\", idToken: \"my-idt\", transaction: \"my-oidc\" },\n * authMaxAgeSeconds: 2_592_000,\n * appSchema,\n * };\n */\nexport interface SessionStoreOptions<App extends object> {\n /** The same value the app gives its client. `\"production\"` refuses `hostPrefix: false`. */\n environment: Environment;\n /** One or two secrets, each at least 32 bytes; the first seals, all open. */\n secrets: readonly string[];\n /** HKDF salt, for example `\"plasgos-shipping-v2\"`. */\n hkdfSalt: string;\n /** Logical cookie names (`/^[a-z0-9-]{1,32}$/`, distinct); they feed the key and the AAD. */\n cookies: { app: string; auth: string; idToken: string; transaction: string };\n /** `true` (default): wire name `__Host-<name>` plus `Secure`. `false` only for local http. */\n hostPrefix?: boolean | undefined;\n /** Max-Age of the auth and idToken cookies: a positive integer, or a function of the auth. */\n authMaxAgeSeconds: number | ((auth: AuthState) => number);\n /** Validates the app cookie. Every app field must be optional. */\n appSchema: SessionSchema<Omit<App, \"auth\">>;\n /** The app's compact key table, merged with the core table; omitted means no renaming. */\n compactKeys?: Readonly<Record<string, string>> | undefined;\n /** Receives the overflow fallbacks of `commit()`. Exceptions are swallowed. */\n onFailure?: ((event: SessionFailureEvent) => void) | undefined;\n}\n\n/**\n * What {@link createSessionStore} returns.\n *\n * @example\n * const session = store.read(request);\n * session.update({ auth });\n * for (const cookie of store.commit(session)) headers.append(\"Set-Cookie\", cookie);\n */\nexport interface SessionStore<App extends object> {\n /** Opens the session cookies of a request (or of a raw Cookie header). Never throws on input. */\n read(input: Request | string | null | undefined): SessionHandle<App>;\n /**\n * Every `Set-Cookie` value a dirty session needs (none when clean): the app cookie when the rest\n * changed, then auth and idToken when auth changed. A cookie that does not fit is expired, its\n * data removed from the session, and reported through `onFailure`.\n */\n commit(session: SessionHandle<App>): string[];\n /** The app cookie (everything but auth), a browser-session cookie. Throws SessionTooLargeError. */\n commitApp(session: SessionHandle<App>): string;\n /** The auth cookie: tokens and user, never `id_token`. Throws SessionTooLargeError. */\n commitAuth(session: SessionHandle<App>): string;\n /** The idToken cookie: `auth.id_token` alone. Throws SessionTooLargeError. */\n commitIdToken(session: SessionHandle<App>): string;\n /** Whether the cookies of `auth` would fit, checked before a login is stored. */\n fits(auth: AuthState): { auth: boolean; idToken: boolean };\n /** The transaction, or null when missing, invalid, older than 600 s or over 5 s in the future. */\n readTransaction(input: Request | string | null | undefined, now?: number): OidcTransaction | null;\n /** The `Set-Cookie` value of the transaction cookie (Max-Age 600). */\n commitTransaction(tx: OidcTransaction): string;\n /** The `Set-Cookie` value that expires the transaction cookie. */\n clearTransaction(): string;\n /** Wire names (with __Host- when hostPrefix). */\n readonly cookieNames: Readonly<{ app: string; auth: string; idToken: string; transaction: string }>;\n}\n\ninterface Settings {\n secrets: readonly string[];\n hkdfSalt: string;\n cookies: CookieNames;\n secure: boolean;\n authMaxAge: number | ((auth: AuthState) => number);\n parseApp: (input: unknown) => unknown;\n compactKeys: Readonly<Record<string, string>> | undefined;\n onFailure: ((event: SessionFailureEvent) => void) | undefined;\n}\n\nconst isPositiveInteger = (value: unknown): value is number =>\n typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n value !== null && typeof value === \"object\" && !Array.isArray(value);\n\n/** Checks the untyped options; one ConfigError lists every problem, by field name only. */\nfunction readOptions(raw: unknown): Settings {\n if (!isObject(raw)) throw new ConfigError([\"options must be an object\"]);\n const problems: string[] = [];\n const { environment, hostPrefix, hkdfSalt, secrets, cookies, authMaxAgeSeconds } = raw;\n const { appSchema, compactKeys, onFailure } = raw;\n\n if (typeof environment !== \"string\" || !(ENVIRONMENTS as readonly string[]).includes(environment)) {\n problems.push('environment must be \"sandbox\" or \"production\"');\n }\n if (hostPrefix !== undefined && typeof hostPrefix !== \"boolean\") {\n problems.push(\"hostPrefix must be a boolean\");\n } else if (hostPrefix === false && environment === \"production\") {\n problems.push('hostPrefix: false is not allowed when environment is \"production\"');\n }\n\n if (hkdfSalt === undefined || hkdfSalt === null || hkdfSalt === \"\") {\n problems.push(\"hkdfSalt is required\");\n } else if (typeof hkdfSalt !== \"string\") {\n problems.push(\"hkdfSalt must be a string\");\n }\n\n const secretList =\n Array.isArray(secrets) && secrets.every((secret) => typeof secret === \"string\")\n ? secrets\n : [];\n if (secretList.length < 1 || secretList.length > 2) {\n problems.push(\"secrets must hold one or two values\");\n } else if (secretList.some((secret) => Buffer.byteLength(secret, \"utf8\") < MIN_SECRET_BYTES)) {\n problems.push(\"secrets values must each be at least 32 bytes\");\n }\n\n const names: Partial<CookieNames> = {};\n const given = isObject(cookies) ? cookies : {};\n for (const role of ROLES) {\n const name = Object.hasOwn(given, role) ? given[role] : undefined;\n if (typeof name === \"string\" && COOKIE_NAME.test(name)) names[role] = name;\n else problems.push(`cookies.${role} must match /^[a-z0-9-]{1,32}$/`);\n }\n const nameList = Object.values(names);\n if (nameList.length === ROLES.length && new Set(nameList).size !== ROLES.length) {\n problems.push(\"cookies names must be distinct\");\n }\n\n if (!isPositiveInteger(authMaxAgeSeconds) && typeof authMaxAgeSeconds !== \"function\") {\n problems.push(\"authMaxAgeSeconds must be a positive integer or a function\");\n }\n const parse = isObject(appSchema) ? appSchema[\"parse\"] : undefined;\n if (typeof parse !== \"function\") problems.push(\"appSchema must have a parse function\");\n if (compactKeys !== undefined) problems.push(...compactKeyProblems(compactKeys));\n if (onFailure !== undefined && typeof onFailure !== \"function\") {\n problems.push(\"onFailure must be a function\");\n }\n\n if (problems.length > 0) throw new ConfigError(problems);\n return {\n secrets: secretList,\n hkdfSalt: hkdfSalt as string,\n cookies: names as CookieNames,\n secure: hostPrefix !== false,\n authMaxAge: authMaxAgeSeconds as Settings[\"authMaxAge\"],\n parseApp: (input) => (appSchema as SessionSchema<unknown>).parse(input),\n compactKeys: compactKeys as Settings[\"compactKeys\"],\n onFailure: onFailure as Settings[\"onFailure\"],\n };\n}\n\nfunction checkSize(header: string): string {\n if (header.length > MAX_SET_COOKIE_CHARS) throw new SessionTooLargeError(header.length);\n return header;\n}\n\n/** Runs `commit`; on a size overflow reports it, lets `drop` shrink the session and commits again. */\nfunction withFallback(\n cookie: SessionFailureEvent[\"cookie\"],\n commit: () => string,\n drop: () => void,\n report: (event: SessionFailureEvent) => void,\n): string {\n try {\n return commit();\n } catch (error) {\n if (!(error instanceof SessionTooLargeError)) throw error;\n report({ kind: \"session_too_large\", cookie, size: error.size });\n drop();\n return commit();\n }\n}\n\n/**\n * Creates the session store of an app. Throws one `ConfigError` naming every invalid option.\n *\n * @example\n * const store = createSessionStore<{ flash?: Flash }>({\n * environment: \"sandbox\",\n * secrets: [process.env.SESSION_SECRET ?? \"\"],\n * hkdfSalt: \"my-app\",\n * cookies: { app: \"my\", auth: \"my-auth\", idToken: \"my-idt\", transaction: \"my-oidc\" },\n * authMaxAgeSeconds: 2_592_000,\n * appSchema: { parse: (input) => parseAppCookie(input) },\n * });\n * const session = store.read(request);\n * for (const cookie of store.commit(session)) headers.append(\"Set-Cookie\", cookie);\n */\nexport function createSessionStore<App extends object>(\n options: SessionStoreOptions<App>,\n): SessionStore<App> {\n const settings = readOptions(options);\n const { cookies, secure } = settings;\n const codec = createKeyCodec(settings.compactKeys);\n const ring = (role: Role): KeyRing => rings[role];\n const rings: Record<Role, KeyRing> = {\n app: deriveKeyRing(settings.secrets, cookies.app, settings.hkdfSalt),\n auth: deriveKeyRing(settings.secrets, cookies.auth, settings.hkdfSalt),\n idToken: deriveKeyRing(settings.secrets, cookies.idToken, settings.hkdfSalt),\n transaction: deriveKeyRing(settings.secrets, cookies.transaction, settings.hkdfSalt),\n };\n const wireName = (role: Role): string => (secure ? `__Host-${cookies[role]}` : cookies[role]);\n const cookieNames = Object.freeze({\n app: wireName(\"app\"),\n auth: wireName(\"auth\"),\n idToken: wireName(\"idToken\"),\n transaction: wireName(\"transaction\"),\n });\n\n const headerOf = (input: CookieInput): string | null =>\n typeof input === \"string\" ? input : (input?.headers.get(\"cookie\") ?? null);\n\n /** The opened value of one cookie and the kid that opened it, or null. */\n const open = (header: string | null, role: Role): { value: unknown; kid: string } | null => {\n const raw = cookieValue(header, cookieNames[role]);\n if (raw === null || raw === \"\") return null;\n return openCookie(cookies[role], raw, ring(role));\n };\n\n const seal = (role: Role, value: unknown, maxAge: number | undefined): string =>\n serialize(cookieNames[role], sealCookie(cookies[role], value, ring(role)), maxAge, secure);\n\n const expire = (role: Role): string => serialize(cookieNames[role], \"\", 0, secure);\n\n /** The app part: the schema's result without `auth`, or `{}` when it refuses, throws or is no object. */\n const parseApp = (value: unknown): Record<string, unknown> | null => {\n let parsed: unknown;\n try {\n parsed = settings.parseApp(value);\n } catch {\n // A schema that throws (zod's `parse`) means the same as one that returns null.\n return null;\n }\n if (!isObject(parsed)) return null;\n return Object.fromEntries(Object.entries(parsed).filter(([key]) => key !== \"auth\"));\n };\n\n const authMaxAge = (auth: AuthState): number => {\n const { authMaxAge: setting } = settings;\n if (typeof setting === \"number\") return setting;\n const seconds: unknown = setting(auth);\n if (!isPositiveInteger(seconds)) {\n throw new ConfigError([\"authMaxAgeSeconds must return a positive integer\"]);\n }\n return seconds;\n };\n\n const authCookie = (auth: AuthState): string => {\n const maxAge = authMaxAge(auth);\n const sealed = Object.fromEntries(Object.entries(auth).filter(([key]) => key !== \"id_token\"));\n return seal(\"auth\", codec.compact({ auth: sealed }), maxAge);\n };\n\n const idTokenCookie = (auth: AuthState, idToken: string): string =>\n seal(\"idToken\", codec.compact({ id_token: idToken }), authMaxAge(auth));\n\n const report = (event: SessionFailureEvent): void => {\n try {\n settings.onFailure?.(event);\n } catch {\n // The hook is the app's; its failure must not lose the response's cookies.\n }\n };\n\n const store: SessionStore<App> = {\n cookieNames,\n\n read(input) {\n const header = headerOf(input);\n const appOpened = open(header, \"app\");\n const rest = appOpened === null ? null : parseApp(codec.expand(appOpened.value));\n const authOpened = open(header, \"auth\");\n let auth = authOpened === null ? undefined : parseAuthPart(codec.expand(authOpened.value))?.auth;\n if (auth !== undefined) {\n const idOpened = open(header, \"idToken\");\n const idPart = idOpened === null ? null : parseIdTokenPart(codec.expand(idOpened.value));\n if (idPart !== null) auth = { ...auth, id_token: idPart.id_token };\n }\n const data = { ...rest, ...(auth !== undefined ? { auth } : {}) } as SessionData<App>;\n // Key migration never marks auth dirty: rewriting tokens that were only read could roll back\n // a concurrent refresh. An old-key auth cookie is re-sealed when auth really changes.\n const migrate = rest !== null && appOpened?.kid !== ring(\"app\").current.kid;\n return createSessionHandle<App>(data, false, migrate);\n },\n\n commitApp(session) {\n const rest = Object.fromEntries(\n Object.entries(session.data).filter(([key, value]) => key !== \"auth\" && value !== undefined),\n );\n if (Object.keys(rest).length === 0) return expire(\"app\");\n return checkSize(seal(\"app\", codec.compact(rest), undefined));\n },\n\n commitAuth(session) {\n const { auth } = session.data;\n if (auth === undefined) return expire(\"auth\");\n return checkSize(authCookie(auth));\n },\n\n commitIdToken(session) {\n const { auth } = session.data;\n if (auth?.id_token === undefined || auth.id_token === \"\") return expire(\"idToken\");\n return checkSize(idTokenCookie(auth, auth.id_token));\n },\n\n fits(auth) {\n const idToken = auth.id_token;\n return {\n auth: authCookie(auth).length <= MAX_SET_COOKIE_CHARS,\n idToken:\n idToken === undefined ||\n idToken === \"\" ||\n idTokenCookie(auth, idToken).length <= MAX_SET_COOKIE_CHARS,\n };\n },\n\n commit(session) {\n const out: string[] = [];\n if (session.restDirty) {\n out.push(\n withFallback(\n \"app\",\n () => store.commitApp(session),\n () => {\n // Only the app cookie overflowed: drop its keys, never the tokens.\n for (const key of Object.keys(session.data)) {\n if (key !== \"auth\") session.unset(key as keyof SessionData<App>);\n }\n },\n report,\n ),\n );\n }\n if (!session.authDirty) return out;\n // Auth before idToken: an auth that is dropped here expires both.\n out.push(\n withFallback(\n \"auth\",\n () => store.commitAuth(session),\n () => {\n session.unset(\"auth\");\n },\n report,\n ),\n );\n out.push(\n withFallback(\n \"idToken\",\n () => store.commitIdToken(session),\n () => {\n // The ID token alone is dropped (the logout then has no ticket); the tokens stay.\n const { auth } = session.data;\n if (auth === undefined) return;\n const kept = Object.fromEntries(Object.entries(auth).filter(([key]) => key !== \"id_token\"));\n session.update({ auth: kept } as Parameters<SessionHandle<App>[\"update\"]>[0]);\n },\n report,\n ),\n );\n return out;\n },\n\n readTransaction(input, now = Date.now()) {\n // Long keys: the transaction is never compacted.\n const tx = parseTransaction(open(headerOf(input), \"transaction\")?.value);\n if (tx === null) return null;\n const age = now - tx.created_at;\n // Written as the accepted range, so a clock that is not a number opens nothing.\n if (!(age >= -CLOCK_SKEW_MS && age <= TRANSACTION_MAX_AGE_SECONDS * 1000)) return null;\n return tx;\n },\n\n commitTransaction(tx) {\n return seal(\"transaction\", tx, TRANSACTION_MAX_AGE_SECONDS);\n },\n\n clearTransaction() {\n return expire(\"transaction\");\n },\n };\n return store;\n}\n","/*\n * Compact keys: the session plaintext uses short keys so the largest realistic session stays under\n * the cookie budget. A table is bijective and strict: a key it does not name is dropped in both\n * directions, so an unmapped field can never be written or read back. The core table is what\n * plasgos-shipping-v2 and plasgos-accounts-v2 already seal; changing a pair logs every user out.\n */\n\n/**\n * The pairs of the SDK-owned auth shape: the 11 keys both apps share plus accounts' `remember`.\n * An app's table is merged with it and must agree with it.\n *\n * @example\n * createSessionStore({ ..., compactKeys: { flash: \"fl\", kind: \"k\", message: \"msg\" } });\n * // `auth`, `access_token`, … come from CORE_COMPACT_KEYS\n */\nexport const CORE_COMPACT_KEYS = Object.freeze({\n auth: \"a\",\n access_token: \"at\",\n refresh_token: \"rt\",\n expires_at: \"e\",\n remember: \"r\",\n user: \"u\",\n id: \"i\",\n name: \"n\",\n avatar_url: \"av\",\n email: \"em\",\n id_token: \"idt\",\n auth_time: \"atm\",\n} as const);\n\nconst KEY_PATTERN = /^[A-Za-z0-9_]{1,32}$/;\nconst RESERVED = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n\nconst isKey = (value: unknown): value is string =>\n typeof value === \"string\" && KEY_PATTERN.test(value) && !RESERVED.has(value);\n\n/** Own entries of the core table followed by the app's (the app's may repeat a core pair). */\nfunction mergedEntries(table: object): [string, unknown][] {\n const merged = new Map<string, unknown>(Object.entries(CORE_COMPACT_KEYS));\n for (const [long, short] of Object.entries(table)) merged.set(long, short);\n return [...merged];\n}\n\n/**\n * Problems of an app's compact key table (empty when it can be merged with the core table). A key\n * is echoed only after it passed the syntax check, so a message never carries an arbitrary string.\n *\n * @example\n * compactKeyProblems({ auth: \"x\" }); // ['compactKeys: \"auth\" must map to \"a\"']\n */\nexport function compactKeyProblems(table: unknown): string[] {\n if (table === null || typeof table !== \"object\" || Array.isArray(table)) {\n return [\"compactKeys must be an object\"];\n }\n const entries = Object.entries(table);\n if (entries.some(([long, short]) => !isKey(long) || !isKey(short))) {\n return [\"compactKeys: keys must match /^[A-Za-z0-9_]{1,32}$/ and must not be a reserved name\"];\n }\n\n const problems: string[] = [];\n const core = new Map<string, string>(Object.entries(CORE_COMPACT_KEYS));\n for (const [long, short] of entries) {\n const expected = core.get(long);\n if (expected !== undefined && short !== expected) {\n problems.push(`compactKeys: \"${long}\" must map to \"${expected}\"`);\n }\n }\n if (problems.length > 0) return problems;\n\n const merged = mergedEntries(table) as [string, string][];\n const longs = new Set(merged.map(([long]) => long));\n const seen = new Set<string>();\n const reported = new Set<string>();\n for (const [, short] of merged) {\n if (seen.has(short) && !reported.has(short)) {\n reported.add(short);\n problems.push(`compactKeys: short key \"${short}\" is used twice`);\n }\n seen.add(short);\n if (longs.has(short)) problems.push(`compactKeys: short key \"${short}\" is also a long key`);\n }\n return problems;\n}\n\n/** Renames keys in both directions; see {@link createKeyCodec}. */\nexport interface KeyCodec {\n /** Long keys to short keys, for the plaintext a cookie seals. */\n compact(value: unknown): unknown;\n /** Short keys back to long keys, for an opened cookie. */\n expand(value: unknown): unknown;\n}\n\n/**\n * Renames own keys at every depth (arrays included) and drops a key the table does not name. The\n * table is a Map, so a key such as `constructor` or `__proto__` is looked up as plain data and\n * never through a prototype; a validated table has no reserved name as a target either.\n */\nfunction renameKeys(value: unknown, table: ReadonlyMap<string, string>): unknown {\n if (Array.isArray(value)) return value.map((item) => renameKeys(item, table));\n if (value === null || typeof value !== \"object\") return value;\n const out: Record<string, unknown> = {};\n for (const [key, item] of Object.entries(value)) {\n const mapped = table.get(key);\n if (mapped !== undefined) out[mapped] = renameKeys(item, table);\n }\n return out;\n}\n\nconst IDENTITY: KeyCodec = { compact: (value) => value, expand: (value) => value };\n\n/**\n * The codec of a store. With a table (already checked by {@link compactKeyProblems}) it renames by\n * the core table merged with the app's; without one it is the identity: nothing is renamed and\n * nothing is dropped.\n *\n * @example\n * const codec = createKeyCodec({ flash: \"fl\", kind: \"k\", message: \"msg\" });\n * codec.compact({ flash: { kind: \"info\", message: \"Halo\" }, other: 1 });\n * // { fl: { k: \"info\", msg: \"Halo\" } }\n */\nexport function createKeyCodec(table: Readonly<Record<string, string>> | undefined): KeyCodec {\n if (table === undefined) return IDENTITY;\n const merged = mergedEntries(table) as [string, string][];\n const shorts = new Map(merged);\n const longs = new Map(merged.map(([long, short]) => [short, long]));\n return {\n compact: (value) => renameKeys(value, shorts),\n expand: (value) => renameKeys(value, longs),\n };\n}\n","/*\n * Cookie header plumbing: the one Cookie-header parser and the Set-Cookie serialiser of the session\n * cookies. A sealed value is base64url with dots, so it is never encoded or decoded here.\n */\n\n/**\n * The first value of `name` in a Cookie header, or null. Names and values are trimmed; a pair\n * without `=` is skipped; the value is never decoded.\n *\n * @example\n * cookieValue(\"theme=dark; kp=v1.abc\", \"kp\"); // \"v1.abc\"\n * cookieValue(\"xkp=1\", \"kp\"); // null\n */\nexport function cookieValue(header: string | null | undefined, name: string): string | null {\n if (header === null || header === undefined || header === \"\") return null;\n for (const pair of header.split(\";\")) {\n const eq = pair.indexOf(\"=\");\n if (eq === -1) continue;\n if (pair.slice(0, eq).trim() === name) return pair.slice(eq + 1).trim();\n }\n return null;\n}\n\n/**\n * Serialises `name=value` with the fixed attributes, in the order both apps already send:\n * `Max-Age` (only when defined), `Path=/`, `HttpOnly`, `Secure` (only when `secure`),\n * `SameSite=Lax`. Never `Domain` or `Expires`, as the `__Host-` prefix requires.\n *\n * @example\n * serialize(\"__Host-kp\", sealed, 600, true);\n * // \"__Host-kp=<sealed>; Max-Age=600; Path=/; HttpOnly; Secure; SameSite=Lax\"\n */\nexport function serialize(\n name: string,\n value: string,\n maxAge: number | undefined,\n secure: boolean,\n): string {\n const attrs = [`${name}=${value}`];\n if (maxAge !== undefined) attrs.push(`Max-Age=${String(maxAge)}`);\n attrs.push(\"Path=/\", \"HttpOnly\");\n if (secure) attrs.push(\"Secure\");\n attrs.push(\"SameSite=Lax\");\n return attrs.join(\"; \");\n}\n","import type { AuthState } from \"./parsers.js\";\n\n/*\n * The request's session handle. Loaders, actions and the api client only mutate it; the server\n * layer commits it once through the store. `auth` and everything else are tracked apart because\n * they live in different cookies: a response that only takes a flash must never rewrite the tokens.\n */\n\n/**\n * Validates the app cookie; `null` means \"no app data\". The app's zod schema fits behind it.\n *\n * @example\n * const appSchema: SessionSchema<{ theme?: string }> = {\n * parse: (input) => (isThemeObject(input) ? input : null),\n * };\n */\nexport interface SessionSchema<T> {\n /** Returns the validated app data, or null when `input` is not what the app stored. May throw: that counts as null. */\n parse(input: unknown): T | null;\n}\n\n/**\n * The app's own session fields plus the SDK-owned `auth`.\n *\n * @example\n * type App = { flash?: string };\n * const data: SessionData<App> = store.read(request).data;\n * data.flash; data.auth?.user.id;\n */\nexport type SessionData<App extends object> = Omit<App, \"auth\"> & { auth?: AuthState | undefined };\n\n/**\n * One request's session.\n *\n * @example\n * const session = store.read(request);\n * session.update({ flash: { kind: \"success\", message: \"Tersimpan\" } });\n * session.update({ auth: undefined }); // sign out, the app data stays\n * const setCookies = store.commit(session);\n */\nexport interface SessionHandle<App extends object> {\n /** The current session: the app's fields and `auth` when signed in. */\n readonly data: Readonly<SessionData<App>>;\n /** True when anything has to be written back. */\n readonly dirty: boolean;\n /** Auth changed (login, refresh, logout, destroy). Never set by a key migration alone. */\n readonly authDirty: boolean;\n /** Anything but auth changed, or the app cookie was opened with a retiring secret. */\n readonly restDirty: boolean;\n /** A key given as `undefined` is deleted (works under exactOptionalPropertyTypes). */\n update(patch: { [K in keyof SessionData<App>]?: SessionData<App>[K] | undefined }): void;\n /** Deletes one key; nothing happens when it is absent. */\n unset(key: keyof SessionData<App>): void;\n /** Empties the session; the next commit expires its cookies. */\n destroy(): void;\n}\n\ntype Bag = Record<string, unknown>;\n\n/** `bag` without the keys `drop` selects, as a new object. */\nconst without = (bag: Bag, drop: (key: string, value: unknown) => boolean): Bag =>\n Object.fromEntries(Object.entries(bag).filter(([key, value]) => !drop(key, value)));\n\n/**\n * Opens a handle over `data` (never mutated) with its initial dirty flags.\n *\n * @example\n * const session = createSessionHandle<{ flash?: string }>({}, false, false);\n * session.update({ flash: \"hi\" });\n * session.restDirty; // true\n */\nexport function createSessionHandle<App extends object>(\n data: SessionData<App>,\n authDirty: boolean,\n restDirty: boolean,\n): SessionHandle<App> {\n let bag: Bag = { ...data };\n let auth = authDirty;\n let rest = restDirty;\n return {\n get data() {\n return bag as Readonly<SessionData<App>>;\n },\n get dirty() {\n return auth || rest;\n },\n get authDirty() {\n return auth;\n },\n get restDirty() {\n return rest;\n },\n update(patch) {\n const changes: Bag = { ...patch };\n // Compared by value: storing the tokens that were only read must not rewrite the auth cookie.\n if (\n Object.hasOwn(changes, \"auth\") &&\n JSON.stringify(changes[\"auth\"]) !== JSON.stringify(bag[\"auth\"])\n ) {\n auth = true;\n }\n if (Object.keys(changes).some((key) => key !== \"auth\")) rest = true;\n bag = without({ ...bag, ...changes }, (_key, value) => value === undefined);\n },\n unset(key) {\n if (!Object.hasOwn(bag, key)) return;\n bag = without(bag, (candidate) => candidate === key);\n if (key === \"auth\") auth = true;\n else rest = true;\n },\n destroy() {\n bag = {};\n auth = true;\n rest = true;\n },\n };\n}\n","import type { OidcTransaction } from \"../core/types.js\";\n\n/*\n * What a session cookie may hold, checked on every read. Hand-written equivalents of the zod\n * schemas both apps use (no zod dependency): unknown keys are stripped, a wrong-shaped value is\n * null, and nothing here throws or reports the value it refused. Caps: tokens 4096 chars, other\n * strings 512.\n */\n\n/**\n * The signed-in user as the session keeps it.\n *\n * @example\n * const user: SessionUser = { id: claims.sub, name: claims.name ?? \"\", email: claims.email ?? null, avatar_url: null };\n */\nexport interface SessionUser {\n /** The app's id of the user, usually the ID token `sub`. 1 to 512 characters. */\n id: string;\n /** Display name, at most 512 characters; may be empty. */\n name: string;\n /** Stored by plasgos-shipping-v2 (`null` when unknown); absent in plasgos-accounts-v2. */\n email?: string | null | undefined;\n /** Picture URL, or null. */\n avatar_url: string | null;\n}\n\n/**\n * The tokens and the user of a signed-in session.\n *\n * @example\n * session.update({\n * auth: {\n * access_token: tokens.access_token,\n * refresh_token: tokens.refresh_token,\n * expires_at: accessTokenExpiry(tokens, Date.now()),\n * user: { id: claims.sub, name: \"Budi\", email: null, avatar_url: null },\n * id_token: tokens.id_token,\n * },\n * });\n */\nexport interface AuthState {\n /** 1 to 4096 characters. */\n access_token: string;\n /** 1 to 4096 characters; absent for a client without refresh tokens. */\n refresh_token?: string | undefined;\n /** Epoch seconds. */\n expires_at: number;\n /** The signed-in user. */\n user: SessionUser;\n /** Kept in its own cookie (idToken), only for the logout ticket / id_token_hint. */\n id_token?: string | undefined;\n /** Epoch seconds of the login, kept across refreshes. */\n auth_time?: number | undefined;\n /** Remember-me (accounts); drives authMaxAgeSeconds when it is a function. */\n remember?: boolean | undefined;\n}\n\nconst TOKEN_MAX = 4096;\nconst TEXT_MAX = 512;\n\n/** A JSON object (not null, not an array), read through own properties only. */\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nconst own = (record: Record<string, unknown>, key: string): unknown =>\n Object.hasOwn(record, key) ? record[key] : undefined;\n\nconst isToken = (value: unknown): value is string =>\n typeof value === \"string\" && value.length >= 1 && value.length <= TOKEN_MAX;\n\nconst isText = (value: unknown): value is string =>\n typeof value === \"string\" && value.length <= TEXT_MAX;\n\nconst isRequiredText = (value: unknown): value is string => isText(value) && value.length >= 1;\n\n/** An integer >= 0 (epoch seconds or milliseconds, or a duration). */\nconst isCount = (value: unknown): value is number =>\n typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n\nfunction parseUser(input: unknown): SessionUser | null {\n if (!isRecord(input)) return null;\n const id = own(input, \"id\");\n const name = own(input, \"name\");\n const email = own(input, \"email\");\n const avatar = own(input, \"avatar_url\");\n if (!isRequiredText(id) || !isText(name)) return null;\n if (email !== undefined && email !== null && !isText(email)) return null;\n if (avatar !== null && !isText(avatar)) return null;\n return { id, name, ...(email !== undefined ? { email } : {}), avatar_url: avatar };\n}\n\nfunction parseAuthState(input: unknown): AuthState | null {\n if (!isRecord(input)) return null;\n const accessToken = own(input, \"access_token\");\n const refreshToken = own(input, \"refresh_token\");\n const expiresAt = own(input, \"expires_at\");\n const authTime = own(input, \"auth_time\");\n const remember = own(input, \"remember\");\n const user = parseUser(own(input, \"user\"));\n if (!isToken(accessToken) || !isCount(expiresAt) || user === null) return null;\n if (refreshToken !== undefined && !isToken(refreshToken)) return null;\n if (authTime !== undefined && !isCount(authTime)) return null;\n if (remember !== undefined && typeof remember !== \"boolean\") return null;\n return {\n access_token: accessToken,\n ...(refreshToken !== undefined ? { refresh_token: refreshToken } : {}),\n expires_at: expiresAt,\n ...(remember !== undefined ? { remember } : {}),\n user,\n ...(authTime !== undefined ? { auth_time: authTime } : {}),\n };\n}\n\n/**\n * The auth cookie: `{ auth?: … }` with long keys. `{}` when the object has no `auth`, null when the\n * shape is wrong. `id_token` is stripped: it lives in its own cookie.\n *\n * @example\n * parseAuthPart({ auth: { access_token: \"…\", expires_at: 1767225600, user: { id: \"u\", name: \"\", avatar_url: null } } });\n */\nexport function parseAuthPart(input: unknown): { auth?: AuthState } | null {\n if (!isRecord(input)) return null;\n const raw = own(input, \"auth\");\n if (raw === undefined) return {};\n const auth = parseAuthState(raw);\n return auth === null ? null : { auth };\n}\n\n/**\n * The idToken cookie: `{ id_token }`, 1 to 4096 chars.\n *\n * @example\n * parseIdTokenPart({ id_token: \"eyJ…\" }); // { id_token: \"eyJ…\" }\n */\nexport function parseIdTokenPart(input: unknown): { id_token: string } | null {\n if (!isRecord(input)) return null;\n const idToken = own(input, \"id_token\");\n return isToken(idToken) ? { id_token: idToken } : null;\n}\n\n/**\n * The transaction cookie (long keys, never compacted). Accepts accounts' `reauth` and the SDK's\n * `max_age`; unknown keys are stripped.\n *\n * @example\n * parseTransaction({ state, nonce, code_verifier, return_to: \"/\", created_at: Date.now() });\n */\nexport function parseTransaction(input: unknown): OidcTransaction | null {\n if (!isRecord(input)) return null;\n const state = own(input, \"state\");\n const nonce = own(input, \"nonce\");\n const codeVerifier = own(input, \"code_verifier\");\n const returnTo = own(input, \"return_to\");\n const createdAt = own(input, \"created_at\");\n const reauth = own(input, \"reauth\");\n const maxAge = own(input, \"max_age\");\n if (!isRequiredText(state) || !isRequiredText(nonce) || !isRequiredText(codeVerifier)) return null;\n if (!isText(returnTo) || !isCount(createdAt)) return null;\n if (reauth !== undefined && typeof reauth !== \"boolean\") return null;\n if (maxAge !== undefined && !isCount(maxAge)) return null;\n return {\n state,\n nonce,\n code_verifier: codeVerifier,\n return_to: returnTo,\n created_at: createdAt,\n ...(reauth !== undefined ? { reauth } : {}),\n ...(maxAge !== undefined ? { max_age: maxAge } : {}),\n };\n}\n","import type { TokenSet } from \"@plasgos/auth-shared\";\n\n/*\n * Single-flight refresh. Plasgos rotates the refresh token on every use, so a second refresh with\n * the same token looks like reuse and revokes the whole grant. Parallel requests of one session\n * therefore share one refresh, and a request that still carries the old token shortly after the\n * rotation gets the same result. Ported from the refresh lock of plasgos-shipping-v2 and\n * plasgos-accounts-v2. This module has no module-level state: the map belongs to the store that\n * `memoryLockStore()` returns.\n */\n\n/**\n * Where the client keeps refreshes in flight. The key is the SHA-256 of the refresh token, never\n * the token itself. Implement it over a shared store to hold the lock across several instances.\n *\n * @example\n * const redisLock: RefreshLockStore = {\n * run: (key, refresh, reuseMs) => runOnceAcrossInstances(redis, key, refresh, reuseMs),\n * };\n * const client = createOidcClient({ ...options, refreshLock: redisLock });\n */\nexport interface RefreshLockStore {\n /**\n * Runs `refresh` at most once per key among callers sharing this store and gives every caller the same result.\n * A fulfilled result is reused for `reuseMs`; a rejection is not cached.\n */\n run(key: string, refresh: () => Promise<TokenSet>, reuseMs: number): Promise<TokenSet>;\n}\n\ninterface LockEntry {\n promise: Promise<TokenSet>;\n reuseMs: number;\n settledAt?: number;\n}\n\n/**\n * The default lock store: a map in this process, so it only holds within one instance.\n *\n * @example\n * const client = createOidcClient({ ...options, refreshLock: memoryLockStore() });\n */\nexport function memoryLockStore(options: { now?: (() => number) | undefined } = {}): RefreshLockStore {\n const now = options.now ?? Date.now;\n const locks = new Map<string, LockEntry>();\n\n return {\n run(key, refresh, reuseMs) {\n const t = now();\n for (const [storedKey, entry] of locks) {\n if (entry.settledAt !== undefined && t - entry.settledAt >= entry.reuseMs) locks.delete(storedKey);\n }\n const hit = locks.get(key);\n if (hit) return hit.promise;\n\n const entry: LockEntry = { promise: refresh(), reuseMs };\n locks.set(key, entry);\n entry.promise.then(\n () => {\n entry.settledAt = now();\n },\n () => {\n if (locks.get(key) === entry) locks.delete(key);\n },\n );\n return entry.promise;\n },\n };\n}\n","export { deriveKeyRing, openCookie, sealCookie } from \"./cookie-crypto.js\";\nexport type { KeyRing } from \"./cookie-crypto.js\";\nexport type { OidcTransaction } from \"../core/types.js\";\nexport type { SessionData, SessionHandle, SessionSchema } from \"./handle.js\";\nexport type { AuthState, SessionUser } from \"./parsers.js\";\nexport { SessionTooLargeError, createSessionStore } from \"./store.js\";\nexport type { SessionFailureEvent, SessionStore, SessionStoreOptions } from \"./store.js\";\n// The refresh lock is part of the session surface too. The module is stateless:\n// the map belongs to the store `memoryLockStore()` returns, so both entries may bundle it.\nexport { memoryLockStore } from \"../core/refresh-lock.js\";\nexport type { RefreshLockStore } from \"../core/refresh-lock.js\";\n// The class `createSessionStore` throws for its options: the same class as in the other entries.\nexport { ConfigError } from \"@plasgos/auth-shared\";\n"],"mappings":";AAAA,SAAS,gBAAgB,kBAAkB,YAAY,UAAU,mBAAmB;AAUpF,IAAM,UAAU;AAChB,IAAM,WAAW;AACjB,IAAM,YAAY;AAClB,IAAM,SAAS;AAiBf,SAAS,IAAI,QAAwB;AACnC,SAAO,OAAO,KAAK,GAAG,OAAO,IAAI,MAAM,IAAI,MAAM;AACnD;AAWO,SAAS,cACd,SACA,QACA,UACS;AACT,QAAM,MAAM,oBAAI,IAAoB;AACpC,MAAI;AACJ,aAAW,UAAU,SAAS;AAC5B,UAAM,MAAM,OAAO;AAAA,MACjB,SAAS,UAAU,OAAO,KAAK,QAAQ,MAAM,GAAG,UAAU,UAAU,MAAM,OAAO,EAAE;AAAA,IACrF;AACA,UAAM,MAAM,WAAW,QAAQ,EAAE,OAAO,GAAG,EAAE,OAAO,WAAW,EAAE,MAAM,GAAG,CAAC;AAC3E,gBAAY,EAAE,KAAK,IAAI;AACvB,QAAI,CAAC,IAAI,IAAI,GAAG,EAAG,KAAI,IAAI,KAAK,GAAG;AAAA,EACrC;AACA,MAAI,YAAY,OAAW,OAAM,IAAI,MAAM,gDAAgD;AAC3F,SAAO,EAAE,SAAS,IAAI;AACxB;AAUO,SAAS,WAAW,QAAgB,OAAgB,MAAuB;AAChF,QAAM,KAAK,YAAY,QAAQ;AAC/B,QAAM,SAAS,eAAe,eAAe,KAAK,QAAQ,KAAK,EAAE;AACjE,SAAO,OAAO,IAAI,MAAM,CAAC;AACzB,QAAM,KAAK,OAAO,OAAO,CAAC,OAAO,OAAO,KAAK,UAAU,KAAK,GAAG,MAAM,GAAG,OAAO,MAAM,CAAC,CAAC;AACvF,QAAM,MAAM,OAAO,WAAW;AAC9B,SAAO;AAAA,IACL;AAAA,IACA,KAAK,QAAQ;AAAA,IACb,GAAG,SAAS,WAAW;AAAA,IACvB,GAAG,SAAS,WAAW;AAAA,IACvB,IAAI,SAAS,WAAW;AAAA,EAC1B,EAAE,KAAK,GAAG;AACZ;AAGA,SAAS,OAAO,MAA6B;AAC3C,MAAI,CAAC,OAAO,KAAK,IAAI,EAAG,QAAO;AAC/B,QAAM,UAAU,OAAO,KAAK,MAAM,WAAW;AAC7C,SAAO,QAAQ,SAAS,WAAW,MAAM,OAAO,UAAU;AAC5D;AAaO,SAAS,WACd,QACA,QACA,MACwC;AACxC,MAAI;AACF,UAAM,QAAQ,OAAO,MAAM,GAAG;AAC9B,QAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,UAAM,CAAC,SAAS,KAAK,QAAQ,QAAQ,OAAO,IAAI;AAChD,QAAI,YAAY,QAAS,QAAO;AAChC,UAAM,MAAM,KAAK,IAAI,IAAI,GAAG;AAC5B,QAAI,QAAQ,OAAW,QAAO;AAC9B,UAAM,KAAK,OAAO,MAAM;AACxB,UAAM,KAAK,OAAO,MAAM;AACxB,UAAM,MAAM,OAAO,OAAO;AAC1B,QAAI,OAAO,QAAQ,OAAO,QAAQ,QAAQ,KAAM,QAAO;AACvD,QAAI,GAAG,WAAW,YAAY,IAAI,WAAW,UAAW,QAAO;AAC/D,UAAM,WAAW,iBAAiB,eAAe,KAAK,IAAI,EAAE,eAAe,UAAU,CAAC;AACtF,aAAS,OAAO,IAAI,MAAM,CAAC;AAC3B,aAAS,WAAW,GAAG;AACvB,UAAM,QAAQ,OAAO,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,SAAS,MAAM,CAAC,CAAC,EAAE,SAAS,MAAM;AACpF,WAAO,EAAE,OAAO,KAAK,MAAM,KAAK,GAAc,IAAI;AAAA,EACpD,QAAQ;AAEN,WAAO;AAAA,EACT;AACF;;;ACjIA,SAAS,aAAa,oBAAoB;;;ACenC,IAAM,oBAAoB,OAAO,OAAO;AAAA,EAC7C,MAAM;AAAA,EACN,cAAc;AAAA,EACd,eAAe;AAAA,EACf,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,MAAM;AAAA,EACN,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,UAAU;AAAA,EACV,WAAW;AACb,CAAU;AAEV,IAAM,cAAc;AACpB,IAAM,WAAW,oBAAI,IAAI,CAAC,aAAa,eAAe,WAAW,CAAC;AAElE,IAAM,QAAQ,CAAC,UACb,OAAO,UAAU,YAAY,YAAY,KAAK,KAAK,KAAK,CAAC,SAAS,IAAI,KAAK;AAG7E,SAAS,cAAc,OAAoC;AACzD,QAAM,SAAS,IAAI,IAAqB,OAAO,QAAQ,iBAAiB,CAAC;AACzE,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,KAAK,EAAG,QAAO,IAAI,MAAM,KAAK;AACzE,SAAO,CAAC,GAAG,MAAM;AACnB;AASO,SAAS,mBAAmB,OAA0B;AAC3D,MAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;AACvE,WAAO,CAAC,+BAA+B;AAAA,EACzC;AACA,QAAM,UAAU,OAAO,QAAQ,KAAK;AACpC,MAAI,QAAQ,KAAK,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,GAAG;AAClE,WAAO,CAAC,qFAAqF;AAAA,EAC/F;AAEA,QAAM,WAAqB,CAAC;AAC5B,QAAM,OAAO,IAAI,IAAoB,OAAO,QAAQ,iBAAiB,CAAC;AACtE,aAAW,CAAC,MAAM,KAAK,KAAK,SAAS;AACnC,UAAM,WAAW,KAAK,IAAI,IAAI;AAC9B,QAAI,aAAa,UAAa,UAAU,UAAU;AAChD,eAAS,KAAK,iBAAiB,IAAI,kBAAkB,QAAQ,GAAG;AAAA,IAClE;AAAA,EACF;AACA,MAAI,SAAS,SAAS,EAAG,QAAO;AAEhC,QAAM,SAAS,cAAc,KAAK;AAClC,QAAM,QAAQ,IAAI,IAAI,OAAO,IAAI,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC;AAClD,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,WAAW,oBAAI,IAAY;AACjC,aAAW,CAAC,EAAE,KAAK,KAAK,QAAQ;AAC9B,QAAI,KAAK,IAAI,KAAK,KAAK,CAAC,SAAS,IAAI,KAAK,GAAG;AAC3C,eAAS,IAAI,KAAK;AAClB,eAAS,KAAK,2BAA2B,KAAK,iBAAiB;AAAA,IACjE;AACA,SAAK,IAAI,KAAK;AACd,QAAI,MAAM,IAAI,KAAK,EAAG,UAAS,KAAK,2BAA2B,KAAK,sBAAsB;AAAA,EAC5F;AACA,SAAO;AACT;AAeA,SAAS,WAAW,OAAgB,OAA6C;AAC/E,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,CAAC,SAAS,WAAW,MAAM,KAAK,CAAC;AAC5E,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,QAAM,MAA+B,CAAC;AACtC,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC/C,UAAM,SAAS,MAAM,IAAI,GAAG;AAC5B,QAAI,WAAW,OAAW,KAAI,MAAM,IAAI,WAAW,MAAM,KAAK;AAAA,EAChE;AACA,SAAO;AACT;AAEA,IAAM,WAAqB,EAAE,SAAS,CAAC,UAAU,OAAO,QAAQ,CAAC,UAAU,MAAM;AAY1E,SAAS,eAAe,OAA+D;AAC5F,MAAI,UAAU,OAAW,QAAO;AAChC,QAAM,SAAS,cAAc,KAAK;AAClC,QAAM,SAAS,IAAI,IAAI,MAAM;AAC7B,QAAM,QAAQ,IAAI,IAAI,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;AAClE,SAAO;AAAA,IACL,SAAS,CAAC,UAAU,WAAW,OAAO,MAAM;AAAA,IAC5C,QAAQ,CAAC,UAAU,WAAW,OAAO,KAAK;AAAA,EAC5C;AACF;;;ACpHO,SAAS,YAAY,QAAmC,MAA6B;AAC1F,MAAI,WAAW,QAAQ,WAAW,UAAa,WAAW,GAAI,QAAO;AACrE,aAAW,QAAQ,OAAO,MAAM,GAAG,GAAG;AACpC,UAAM,KAAK,KAAK,QAAQ,GAAG;AAC3B,QAAI,OAAO,GAAI;AACf,QAAI,KAAK,MAAM,GAAG,EAAE,EAAE,KAAK,MAAM,KAAM,QAAO,KAAK,MAAM,KAAK,CAAC,EAAE,KAAK;AAAA,EACxE;AACA,SAAO;AACT;AAWO,SAAS,UACd,MACA,OACA,QACA,QACQ;AACR,QAAM,QAAQ,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE;AACjC,MAAI,WAAW,OAAW,OAAM,KAAK,WAAW,OAAO,MAAM,CAAC,EAAE;AAChE,QAAM,KAAK,UAAU,UAAU;AAC/B,MAAI,OAAQ,OAAM,KAAK,QAAQ;AAC/B,QAAM,KAAK,cAAc;AACzB,SAAO,MAAM,KAAK,IAAI;AACxB;;;ACgBA,IAAM,UAAU,CAAC,KAAU,SACzB,OAAO,YAAY,OAAO,QAAQ,GAAG,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AAU7E,SAAS,oBACd,MACA,WACA,WACoB;AACpB,MAAI,MAAW,EAAE,GAAG,KAAK;AACzB,MAAI,OAAO;AACX,MAAI,OAAO;AACX,SAAO;AAAA,IACL,IAAI,OAAO;AACT,aAAO;AAAA,IACT;AAAA,IACA,IAAI,QAAQ;AACV,aAAO,QAAQ;AAAA,IACjB;AAAA,IACA,IAAI,YAAY;AACd,aAAO;AAAA,IACT;AAAA,IACA,IAAI,YAAY;AACd,aAAO;AAAA,IACT;AAAA,IACA,OAAO,OAAO;AACZ,YAAM,UAAe,EAAE,GAAG,MAAM;AAEhC,UACE,OAAO,OAAO,SAAS,MAAM,KAC7B,KAAK,UAAU,QAAQ,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,GAC9D;AACA,eAAO;AAAA,MACT;AACA,UAAI,OAAO,KAAK,OAAO,EAAE,KAAK,CAAC,QAAQ,QAAQ,MAAM,EAAG,QAAO;AAC/D,YAAM,QAAQ,EAAE,GAAG,KAAK,GAAG,QAAQ,GAAG,CAAC,MAAM,UAAU,UAAU,MAAS;AAAA,IAC5E;AAAA,IACA,MAAM,KAAK;AACT,UAAI,CAAC,OAAO,OAAO,KAAK,GAAG,EAAG;AAC9B,YAAM,QAAQ,KAAK,CAAC,cAAc,cAAc,GAAG;AACnD,UAAI,QAAQ,OAAQ,QAAO;AAAA,UACtB,QAAO;AAAA,IACd;AAAA,IACA,UAAU;AACR,YAAM,CAAC;AACP,aAAO;AACP,aAAO;AAAA,IACT;AAAA,EACF;AACF;;;AC3DA,IAAM,YAAY;AAClB,IAAM,WAAW;AAGjB,SAAS,SAAS,OAAkD;AAClE,SAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,IAAM,MAAM,CAAC,QAAiC,QAC5C,OAAO,OAAO,QAAQ,GAAG,IAAI,OAAO,GAAG,IAAI;AAE7C,IAAM,UAAU,CAAC,UACf,OAAO,UAAU,YAAY,MAAM,UAAU,KAAK,MAAM,UAAU;AAEpE,IAAM,SAAS,CAAC,UACd,OAAO,UAAU,YAAY,MAAM,UAAU;AAE/C,IAAM,iBAAiB,CAAC,UAAoC,OAAO,KAAK,KAAK,MAAM,UAAU;AAG7F,IAAM,UAAU,CAAC,UACf,OAAO,UAAU,YAAY,OAAO,cAAc,KAAK,KAAK,SAAS;AAEvE,SAAS,UAAU,OAAoC;AACrD,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,KAAK,IAAI,OAAO,IAAI;AAC1B,QAAM,OAAO,IAAI,OAAO,MAAM;AAC9B,QAAM,QAAQ,IAAI,OAAO,OAAO;AAChC,QAAM,SAAS,IAAI,OAAO,YAAY;AACtC,MAAI,CAAC,eAAe,EAAE,KAAK,CAAC,OAAO,IAAI,EAAG,QAAO;AACjD,MAAI,UAAU,UAAa,UAAU,QAAQ,CAAC,OAAO,KAAK,EAAG,QAAO;AACpE,MAAI,WAAW,QAAQ,CAAC,OAAO,MAAM,EAAG,QAAO;AAC/C,SAAO,EAAE,IAAI,MAAM,GAAI,UAAU,SAAY,EAAE,MAAM,IAAI,CAAC,GAAI,YAAY,OAAO;AACnF;AAEA,SAAS,eAAe,OAAkC;AACxD,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,cAAc,IAAI,OAAO,cAAc;AAC7C,QAAM,eAAe,IAAI,OAAO,eAAe;AAC/C,QAAM,YAAY,IAAI,OAAO,YAAY;AACzC,QAAM,WAAW,IAAI,OAAO,WAAW;AACvC,QAAM,WAAW,IAAI,OAAO,UAAU;AACtC,QAAM,OAAO,UAAU,IAAI,OAAO,MAAM,CAAC;AACzC,MAAI,CAAC,QAAQ,WAAW,KAAK,CAAC,QAAQ,SAAS,KAAK,SAAS,KAAM,QAAO;AAC1E,MAAI,iBAAiB,UAAa,CAAC,QAAQ,YAAY,EAAG,QAAO;AACjE,MAAI,aAAa,UAAa,CAAC,QAAQ,QAAQ,EAAG,QAAO;AACzD,MAAI,aAAa,UAAa,OAAO,aAAa,UAAW,QAAO;AACpE,SAAO;AAAA,IACL,cAAc;AAAA,IACd,GAAI,iBAAiB,SAAY,EAAE,eAAe,aAAa,IAAI,CAAC;AAAA,IACpE,YAAY;AAAA,IACZ,GAAI,aAAa,SAAY,EAAE,SAAS,IAAI,CAAC;AAAA,IAC7C;AAAA,IACA,GAAI,aAAa,SAAY,EAAE,WAAW,SAAS,IAAI,CAAC;AAAA,EAC1D;AACF;AASO,SAAS,cAAc,OAA6C;AACzE,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,MAAM,IAAI,OAAO,MAAM;AAC7B,MAAI,QAAQ,OAAW,QAAO,CAAC;AAC/B,QAAM,OAAO,eAAe,GAAG;AAC/B,SAAO,SAAS,OAAO,OAAO,EAAE,KAAK;AACvC;AAQO,SAAS,iBAAiB,OAA6C;AAC5E,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,UAAU,IAAI,OAAO,UAAU;AACrC,SAAO,QAAQ,OAAO,IAAI,EAAE,UAAU,QAAQ,IAAI;AACpD;AASO,SAAS,iBAAiB,OAAwC;AACvE,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,QAAQ,IAAI,OAAO,OAAO;AAChC,QAAM,QAAQ,IAAI,OAAO,OAAO;AAChC,QAAM,eAAe,IAAI,OAAO,eAAe;AAC/C,QAAM,WAAW,IAAI,OAAO,WAAW;AACvC,QAAM,YAAY,IAAI,OAAO,YAAY;AACzC,QAAM,SAAS,IAAI,OAAO,QAAQ;AAClC,QAAM,SAAS,IAAI,OAAO,SAAS;AACnC,MAAI,CAAC,eAAe,KAAK,KAAK,CAAC,eAAe,KAAK,KAAK,CAAC,eAAe,YAAY,EAAG,QAAO;AAC9F,MAAI,CAAC,OAAO,QAAQ,KAAK,CAAC,QAAQ,SAAS,EAAG,QAAO;AACrD,MAAI,WAAW,UAAa,OAAO,WAAW,UAAW,QAAO;AAChE,MAAI,WAAW,UAAa,CAAC,QAAQ,MAAM,EAAG,QAAO;AACrD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,eAAe;AAAA,IACf,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,GAAI,WAAW,SAAY,EAAE,OAAO,IAAI,CAAC;AAAA,IACzC,GAAI,WAAW,SAAY,EAAE,SAAS,OAAO,IAAI,CAAC;AAAA,EACpD;AACF;;;AJpJA,IAAM,uBAAuB;AAE7B,IAAM,8BAA8B;AAEpC,IAAM,gBAAgB;AACtB,IAAM,mBAAmB;AACzB,IAAM,cAAc;AACpB,IAAM,QAAQ,CAAC,OAAO,QAAQ,WAAW,aAAa;AAoC/C,IAAM,uBAAN,cAAmC,MAAM;AAAA;AAAA,EAErC;AAAA;AAAA,EAGT,YAAY,MAAc;AACxB,UAAM,6BAA6B,OAAO,IAAI,CAAC,iBAAiB,OAAO,oBAAoB,CAAC,GAAG;AAC/F,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;AAmFA,IAAM,oBAAoB,CAAC,UACzB,OAAO,UAAU,YAAY,OAAO,cAAc,KAAK,KAAK,QAAQ;AAEtE,IAAM,WAAW,CAAC,UAChB,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAGrE,SAAS,YAAY,KAAwB;AAC3C,MAAI,CAAC,SAAS,GAAG,EAAG,OAAM,IAAI,YAAY,CAAC,2BAA2B,CAAC;AACvE,QAAM,WAAqB,CAAC;AAC5B,QAAM,EAAE,aAAa,YAAY,UAAU,SAAS,SAAS,kBAAkB,IAAI;AACnF,QAAM,EAAE,WAAW,aAAa,UAAU,IAAI;AAE9C,MAAI,OAAO,gBAAgB,YAAY,CAAE,aAAmC,SAAS,WAAW,GAAG;AACjG,aAAS,KAAK,+CAA+C;AAAA,EAC/D;AACA,MAAI,eAAe,UAAa,OAAO,eAAe,WAAW;AAC/D,aAAS,KAAK,8BAA8B;AAAA,EAC9C,WAAW,eAAe,SAAS,gBAAgB,cAAc;AAC/D,aAAS,KAAK,mEAAmE;AAAA,EACnF;AAEA,MAAI,aAAa,UAAa,aAAa,QAAQ,aAAa,IAAI;AAClE,aAAS,KAAK,sBAAsB;AAAA,EACtC,WAAW,OAAO,aAAa,UAAU;AACvC,aAAS,KAAK,2BAA2B;AAAA,EAC3C;AAEA,QAAM,aACJ,MAAM,QAAQ,OAAO,KAAK,QAAQ,MAAM,CAAC,WAAW,OAAO,WAAW,QAAQ,IAC1E,UACA,CAAC;AACP,MAAI,WAAW,SAAS,KAAK,WAAW,SAAS,GAAG;AAClD,aAAS,KAAK,qCAAqC;AAAA,EACrD,WAAW,WAAW,KAAK,CAAC,WAAW,OAAO,WAAW,QAAQ,MAAM,IAAI,gBAAgB,GAAG;AAC5F,aAAS,KAAK,+CAA+C;AAAA,EAC/D;AAEA,QAAM,QAA8B,CAAC;AACrC,QAAM,QAAQ,SAAS,OAAO,IAAI,UAAU,CAAC;AAC7C,aAAW,QAAQ,OAAO;AACxB,UAAM,OAAO,OAAO,OAAO,OAAO,IAAI,IAAI,MAAM,IAAI,IAAI;AACxD,QAAI,OAAO,SAAS,YAAY,YAAY,KAAK,IAAI,EAAG,OAAM,IAAI,IAAI;AAAA,QACjE,UAAS,KAAK,WAAW,IAAI,iCAAiC;AAAA,EACrE;AACA,QAAM,WAAW,OAAO,OAAO,KAAK;AACpC,MAAI,SAAS,WAAW,MAAM,UAAU,IAAI,IAAI,QAAQ,EAAE,SAAS,MAAM,QAAQ;AAC/E,aAAS,KAAK,gCAAgC;AAAA,EAChD;AAEA,MAAI,CAAC,kBAAkB,iBAAiB,KAAK,OAAO,sBAAsB,YAAY;AACpF,aAAS,KAAK,4DAA4D;AAAA,EAC5E;AACA,QAAM,QAAQ,SAAS,SAAS,IAAI,UAAU,OAAO,IAAI;AACzD,MAAI,OAAO,UAAU,WAAY,UAAS,KAAK,sCAAsC;AACrF,MAAI,gBAAgB,OAAW,UAAS,KAAK,GAAG,mBAAmB,WAAW,CAAC;AAC/E,MAAI,cAAc,UAAa,OAAO,cAAc,YAAY;AAC9D,aAAS,KAAK,8BAA8B;AAAA,EAC9C;AAEA,MAAI,SAAS,SAAS,EAAG,OAAM,IAAI,YAAY,QAAQ;AACvD,SAAO;AAAA,IACL,SAAS;AAAA,IACT;AAAA,IACA,SAAS;AAAA,IACT,QAAQ,eAAe;AAAA,IACvB,YAAY;AAAA,IACZ,UAAU,CAAC,UAAW,UAAqC,MAAM,KAAK;AAAA,IACtE;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,UAAU,QAAwB;AACzC,MAAI,OAAO,SAAS,qBAAsB,OAAM,IAAI,qBAAqB,OAAO,MAAM;AACtF,SAAO;AACT;AAGA,SAAS,aACP,QACA,QACA,MACA,QACQ;AACR,MAAI;AACF,WAAO,OAAO;AAAA,EAChB,SAAS,OAAO;AACd,QAAI,EAAE,iBAAiB,sBAAuB,OAAM;AACpD,WAAO,EAAE,MAAM,qBAAqB,QAAQ,MAAM,MAAM,KAAK,CAAC;AAC9D,SAAK;AACL,WAAO,OAAO;AAAA,EAChB;AACF;AAiBO,SAAS,mBACd,SACmB;AACnB,QAAM,WAAW,YAAY,OAAO;AACpC,QAAM,EAAE,SAAS,OAAO,IAAI;AAC5B,QAAM,QAAQ,eAAe,SAAS,WAAW;AACjD,QAAM,OAAO,CAAC,SAAwB,MAAM,IAAI;AAChD,QAAM,QAA+B;AAAA,IACnC,KAAK,cAAc,SAAS,SAAS,QAAQ,KAAK,SAAS,QAAQ;AAAA,IACnE,MAAM,cAAc,SAAS,SAAS,QAAQ,MAAM,SAAS,QAAQ;AAAA,IACrE,SAAS,cAAc,SAAS,SAAS,QAAQ,SAAS,SAAS,QAAQ;AAAA,IAC3E,aAAa,cAAc,SAAS,SAAS,QAAQ,aAAa,SAAS,QAAQ;AAAA,EACrF;AACA,QAAM,WAAW,CAAC,SAAwB,SAAS,UAAU,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI;AAC3F,QAAM,cAAc,OAAO,OAAO;AAAA,IAChC,KAAK,SAAS,KAAK;AAAA,IACnB,MAAM,SAAS,MAAM;AAAA,IACrB,SAAS,SAAS,SAAS;AAAA,IAC3B,aAAa,SAAS,aAAa;AAAA,EACrC,CAAC;AAED,QAAM,WAAW,CAAC,UAChB,OAAO,UAAU,WAAW,QAAS,OAAO,QAAQ,IAAI,QAAQ,KAAK;AAGvE,QAAM,OAAO,CAAC,QAAuB,SAAuD;AAC1F,UAAM,MAAM,YAAY,QAAQ,YAAY,IAAI,CAAC;AACjD,QAAI,QAAQ,QAAQ,QAAQ,GAAI,QAAO;AACvC,WAAO,WAAW,QAAQ,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC;AAAA,EAClD;AAEA,QAAM,OAAO,CAAC,MAAY,OAAgB,WACxC,UAAU,YAAY,IAAI,GAAG,WAAW,QAAQ,IAAI,GAAG,OAAO,KAAK,IAAI,CAAC,GAAG,QAAQ,MAAM;AAE3F,QAAM,SAAS,CAAC,SAAuB,UAAU,YAAY,IAAI,GAAG,IAAI,GAAG,MAAM;AAGjF,QAAM,WAAW,CAAC,UAAmD;AACnE,QAAI;AACJ,QAAI;AACF,eAAS,SAAS,SAAS,KAAK;AAAA,IAClC,QAAQ;AAEN,aAAO;AAAA,IACT;AACA,QAAI,CAAC,SAAS,MAAM,EAAG,QAAO;AAC9B,WAAO,OAAO,YAAY,OAAO,QAAQ,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,QAAQ,MAAM,CAAC;AAAA,EACpF;AAEA,QAAM,aAAa,CAAC,SAA4B;AAC9C,UAAM,EAAE,YAAY,QAAQ,IAAI;AAChC,QAAI,OAAO,YAAY,SAAU,QAAO;AACxC,UAAM,UAAmB,QAAQ,IAAI;AACrC,QAAI,CAAC,kBAAkB,OAAO,GAAG;AAC/B,YAAM,IAAI,YAAY,CAAC,kDAAkD,CAAC;AAAA,IAC5E;AACA,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,CAAC,SAA4B;AAC9C,UAAM,SAAS,WAAW,IAAI;AAC9B,UAAM,SAAS,OAAO,YAAY,OAAO,QAAQ,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,QAAQ,UAAU,CAAC;AAC5F,WAAO,KAAK,QAAQ,MAAM,QAAQ,EAAE,MAAM,OAAO,CAAC,GAAG,MAAM;AAAA,EAC7D;AAEA,QAAM,gBAAgB,CAAC,MAAiB,YACtC,KAAK,WAAW,MAAM,QAAQ,EAAE,UAAU,QAAQ,CAAC,GAAG,WAAW,IAAI,CAAC;AAExE,QAAM,SAAS,CAAC,UAAqC;AACnD,QAAI;AACF,eAAS,YAAY,KAAK;AAAA,IAC5B,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,QAAM,QAA2B;AAAA,IAC/B;AAAA,IAEA,KAAK,OAAO;AACV,YAAM,SAAS,SAAS,KAAK;AAC7B,YAAM,YAAY,KAAK,QAAQ,KAAK;AACpC,YAAM,OAAO,cAAc,OAAO,OAAO,SAAS,MAAM,OAAO,UAAU,KAAK,CAAC;AAC/E,YAAM,aAAa,KAAK,QAAQ,MAAM;AACtC,UAAI,OAAO,eAAe,OAAO,SAAY,cAAc,MAAM,OAAO,WAAW,KAAK,CAAC,GAAG;AAC5F,UAAI,SAAS,QAAW;AACtB,cAAM,WAAW,KAAK,QAAQ,SAAS;AACvC,cAAM,SAAS,aAAa,OAAO,OAAO,iBAAiB,MAAM,OAAO,SAAS,KAAK,CAAC;AACvF,YAAI,WAAW,KAAM,QAAO,EAAE,GAAG,MAAM,UAAU,OAAO,SAAS;AAAA,MACnE;AACA,YAAM,OAAO,EAAE,GAAG,MAAM,GAAI,SAAS,SAAY,EAAE,KAAK,IAAI,CAAC,EAAG;AAGhE,YAAM,UAAU,SAAS,QAAQ,WAAW,QAAQ,KAAK,KAAK,EAAE,QAAQ;AACxE,aAAO,oBAAyB,MAAM,OAAO,OAAO;AAAA,IACtD;AAAA,IAEA,UAAU,SAAS;AACjB,YAAM,OAAO,OAAO;AAAA,QAClB,OAAO,QAAQ,QAAQ,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,MAAM,QAAQ,UAAU,UAAU,MAAS;AAAA,MAC7F;AACA,UAAI,OAAO,KAAK,IAAI,EAAE,WAAW,EAAG,QAAO,OAAO,KAAK;AACvD,aAAO,UAAU,KAAK,OAAO,MAAM,QAAQ,IAAI,GAAG,MAAS,CAAC;AAAA,IAC9D;AAAA,IAEA,WAAW,SAAS;AAClB,YAAM,EAAE,KAAK,IAAI,QAAQ;AACzB,UAAI,SAAS,OAAW,QAAO,OAAO,MAAM;AAC5C,aAAO,UAAU,WAAW,IAAI,CAAC;AAAA,IACnC;AAAA,IAEA,cAAc,SAAS;AACrB,YAAM,EAAE,KAAK,IAAI,QAAQ;AACzB,UAAI,MAAM,aAAa,UAAa,KAAK,aAAa,GAAI,QAAO,OAAO,SAAS;AACjF,aAAO,UAAU,cAAc,MAAM,KAAK,QAAQ,CAAC;AAAA,IACrD;AAAA,IAEA,KAAK,MAAM;AACT,YAAM,UAAU,KAAK;AACrB,aAAO;AAAA,QACL,MAAM,WAAW,IAAI,EAAE,UAAU;AAAA,QACjC,SACE,YAAY,UACZ,YAAY,MACZ,cAAc,MAAM,OAAO,EAAE,UAAU;AAAA,MAC3C;AAAA,IACF;AAAA,IAEA,OAAO,SAAS;AACd,YAAM,MAAgB,CAAC;AACvB,UAAI,QAAQ,WAAW;AACrB,YAAI;AAAA,UACF;AAAA,YACE;AAAA,YACA,MAAM,MAAM,UAAU,OAAO;AAAA,YAC7B,MAAM;AAEJ,yBAAW,OAAO,OAAO,KAAK,QAAQ,IAAI,GAAG;AAC3C,oBAAI,QAAQ,OAAQ,SAAQ,MAAM,GAA6B;AAAA,cACjE;AAAA,YACF;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAAA,MACF;AACA,UAAI,CAAC,QAAQ,UAAW,QAAO;AAE/B,UAAI;AAAA,QACF;AAAA,UACE;AAAA,UACA,MAAM,MAAM,WAAW,OAAO;AAAA,UAC9B,MAAM;AACJ,oBAAQ,MAAM,MAAM;AAAA,UACtB;AAAA,UACA;AAAA,QACF;AAAA,MACF;AACA,UAAI;AAAA,QACF;AAAA,UACE;AAAA,UACA,MAAM,MAAM,cAAc,OAAO;AAAA,UACjC,MAAM;AAEJ,kBAAM,EAAE,KAAK,IAAI,QAAQ;AACzB,gBAAI,SAAS,OAAW;AACxB,kBAAM,OAAO,OAAO,YAAY,OAAO,QAAQ,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,QAAQ,UAAU,CAAC;AAC1F,oBAAQ,OAAO,EAAE,MAAM,KAAK,CAAgD;AAAA,UAC9E;AAAA,UACA;AAAA,QACF;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA,IAEA,gBAAgB,OAAO,MAAM,KAAK,IAAI,GAAG;AAEvC,YAAM,KAAK,iBAAiB,KAAK,SAAS,KAAK,GAAG,aAAa,GAAG,KAAK;AACvE,UAAI,OAAO,KAAM,QAAO;AACxB,YAAM,MAAM,MAAM,GAAG;AAErB,UAAI,EAAE,OAAO,CAAC,iBAAiB,OAAO,8BAA8B,KAAO,QAAO;AAClF,aAAO;AAAA,IACT;AAAA,IAEA,kBAAkB,IAAI;AACpB,aAAO,KAAK,eAAe,IAAI,2BAA2B;AAAA,IAC5D;AAAA,IAEA,mBAAmB;AACjB,aAAO,OAAO,aAAa;AAAA,IAC7B;AAAA,EACF;AACA,SAAO;AACT;;;AKpaO,SAAS,gBAAgB,UAAgD,CAAC,GAAqB;AACpG,QAAM,MAAM,QAAQ,OAAO,KAAK;AAChC,QAAM,QAAQ,oBAAI,IAAuB;AAEzC,SAAO;AAAA,IACL,IAAI,KAAK,SAAS,SAAS;AACzB,YAAM,IAAI,IAAI;AACd,iBAAW,CAAC,WAAWA,MAAK,KAAK,OAAO;AACtC,YAAIA,OAAM,cAAc,UAAa,IAAIA,OAAM,aAAaA,OAAM,QAAS,OAAM,OAAO,SAAS;AAAA,MACnG;AACA,YAAM,MAAM,MAAM,IAAI,GAAG;AACzB,UAAI,IAAK,QAAO,IAAI;AAEpB,YAAM,QAAmB,EAAE,SAAS,QAAQ,GAAG,QAAQ;AACvD,YAAM,IAAI,KAAK,KAAK;AACpB,YAAM,QAAQ;AAAA,QACZ,MAAM;AACJ,gBAAM,YAAY,IAAI;AAAA,QACxB;AAAA,QACA,MAAM;AACJ,cAAI,MAAM,IAAI,GAAG,MAAM,MAAO,OAAM,OAAO,GAAG;AAAA,QAChD;AAAA,MACF;AACA,aAAO,MAAM;AAAA,IACf;AAAA,EACF;AACF;;;ACvDA,SAAS,eAAAC,oBAAmB;","names":["entry","ConfigError"]}
@@ -119,7 +119,7 @@ interface OidcClientOptions {
119
119
  environment: Environment;
120
120
  /** Bare origin of the provider: browser URLs and the exact `iss` value. */
121
121
  issuer: string;
122
- /** Internal api-main origin for the token, revocation and logout-ticket calls; `http:` allowed. Default: `issuer`. */
122
+ /** Internal Plasgos server origin for the token, revocation and logout-ticket calls; `http:` allowed. Default: `issuer`. */
123
123
  backchannelUrl?: string | undefined;
124
124
  /** Client id of the interactive (login) client. */
125
125
  clientId: string;
@@ -119,7 +119,7 @@ interface OidcClientOptions {
119
119
  environment: Environment;
120
120
  /** Bare origin of the provider: browser URLs and the exact `iss` value. */
121
121
  issuer: string;
122
- /** Internal api-main origin for the token, revocation and logout-ticket calls; `http:` allowed. Default: `issuer`. */
122
+ /** Internal Plasgos server origin for the token, revocation and logout-ticket calls; `http:` allowed. Default: `issuer`. */
123
123
  backchannelUrl?: string | undefined;
124
124
  /** Client id of the interactive (login) client. */
125
125
  clientId: string;
@@ -0,0 +1,90 @@
1
+ # Install paket `@plasgos/*`
2
+
3
+ Panduan ini untuk aplikasi yang memakai paket `@plasgos/oidc-client` atau `@plasgos/auth-verify`. Isinya: cara install di laptop, di Docker, dan di CI, aturan versi, dan lisensi.
4
+
5
+ Paket diterbitkan di npmjs.com (`registry.npmjs.org`) sebagai paket **publik** di scope `@plasgos`, sama seperti paket `@plasgos/*` lain (misalnya `@plasgos/webchat`). Install tidak butuh token, `.npmrc` khusus, atau secret. Repo sumbernya privat; yang publik hanya paket hasil build. Panduan pemakaian ikut di dalam paket `@plasgos/oidc-client` dan `@plasgos/auth-verify` (isinya sama), di folder `docs/`: bisa dibaca di tab **Code** halaman paket di npmjs.com, atau di `node_modules/@plasgos/oidc-client/docs/` atau `node_modules/@plasgos/auth-verify/docs/` setelah install.
6
+
7
+ Status saat ini: `@plasgos/auth-shared`, `@plasgos/oidc-client`, dan `@plasgos/auth-verify` terbit di npmjs.com sebagai pre-release, selalu dengan nomor versi yang sama. Cek versi yang ada dengan `npm view @plasgos/auth-verify versions`.
8
+
9
+ Setelah paket terpasang, lanjut ke [`memulai.md`](memulai.md).
10
+
11
+ ## 1. Install
12
+
13
+ ```bash
14
+ pnpm add @plasgos/oidc-client@<versi> --save-exact
15
+ ```
16
+
17
+ Aplikasi yang menerima webhook dari Plasgos meng-install `@plasgos/auth-verify`, sendiri atau di samping `@plasgos/oidc-client`, dengan versi yang sama:
18
+
19
+ ```bash
20
+ pnpm add @plasgos/auth-verify@<versi> --save-exact
21
+ ```
22
+
23
+ Ganti `<versi>` dengan nomor versi persis (lihat §5). `@plasgos/auth-shared` ikut terpasang dengan versi yang sama, jadi tidak perlu di-install sendiri.
24
+
25
+ Perintah ini sama di laptop, di Docker, dan di CI. Tidak ada token yang perlu dibuat atau diatur.
26
+
27
+ ## 2. `.npmrc` di repo aplikasi
28
+
29
+ Tidak perlu baris apa pun untuk `@plasgos`. Paket diambil dari registry bawaan (`registry.npmjs.org`).
30
+
31
+ Bila `.npmrc` aplikasi masih punya baris yang mengarahkan `@plasgos` ke GitHub Packages, hapus baris itu beserta baris token-nya:
32
+
33
+ ```
34
+ @plasgos:registry=https://npm.pkg.github.com
35
+ //npm.pkg.github.com/:_authToken=${NPM_TOKEN}
36
+ ```
37
+
38
+ Satu scope hanya bisa diarahkan ke satu registry. Selama baris pertama masih ada, semua paket `@plasgos/*` dicari di GitHub Packages dan install gagal. Baris lain di `.npmrc` (misalnya `save-exact=true`) tetap dipakai.
39
+
40
+ ## 3. Dockerfile
41
+
42
+ Install di Docker cukup `pnpm install` biasa. Tidak ada BuildKit secret, `--mount=type=secret`, `ARG`, atau `ENV` untuk token.
43
+
44
+ ```dockerfile
45
+ FROM node:26-trixie-slim AS deps
46
+ WORKDIR /app
47
+ COPY package.json pnpm-lock.yaml ./
48
+ # Node 26 tidak lagi membawa corepack, jadi pnpm dipasang lewat npm (versi dari `packageManager`).
49
+ RUN npm install -g --no-fund --no-audit "$(node -p 'require("./package.json").packageManager')"
50
+ RUN pnpm install --frozen-lockfile
51
+ ```
52
+
53
+ Build-nya:
54
+
55
+ ```bash
56
+ docker build -t app .
57
+ ```
58
+
59
+ Aturan:
60
+
61
+ - Stage `runtime` hanya mengambil `node_modules`, hasil build, dan file yang dibutuhkan saat aplikasi berjalan. Stage itu tidak meng-copy `.npmrc`.
62
+ - Bila Dockerfile aplikasi masih memakai `--mount=type=secret,id=npm_token,…` hanya untuk `@plasgos/*`, mount itu boleh dihapus, begitu juga `--secret id=npm_token,…` di perintah `docker build`.
63
+
64
+ ## 4. CI
65
+
66
+ GitLab CI dan GitHub Actions menjalankan `pnpm install` atau `docker build` seperti biasa, tanpa variable atau secret untuk paket ini.
67
+
68
+ Bila project GitLab aplikasi punya variable `NPM_TOKEN` yang hanya dipakai untuk `@plasgos/*` dari GitHub Packages, variable itu tidak dipakai lagi dan boleh dihapus. Bila workflow GitHub Actions aplikasi memberi `packages: read` dan meneruskan `GITHUB_TOKEN` hanya untuk paket ini, keduanya juga boleh dihapus.
69
+
70
+ ## 5. Versi
71
+
72
+ - Selama versi masih `0.x`, tulis rentang `~0.y.z` di `package.json` aplikasi. Di `0.x`, kenaikan minor dianggap breaking, jadi aplikasi hanya menerima patch secara otomatis. `pnpm add` tidak menulis rentang ini (ia menulis versi persis bila `save-exact=true`, selain itu `^`), jadi ubah rentangnya dengan tangan setelah `pnpm add`.
73
+ - Setelah `1.0.0`, pakai rentang `^`.
74
+ - Versi yang benar-benar terpasang ditentukan lockfile aplikasi. Menaikkan versi berarti membuat PR di repo aplikasi, supaya test aplikasi ikut berjalan.
75
+ - Semua paket `@plasgos/*` di SDK ini dirilis dengan nomor versi yang sama. Aplikasi yang memakai dua paket menaikkan keduanya sekaligus.
76
+ - `@plasgos/auth-shared` tidak di-install langsung. Paket itu ikut terpasang sebagai dependensi `oidc-client` dan `auth-verify`.
77
+
78
+ **Pre-release `next`.** Versi uji terbit sebagai `x.y.z-next.n`. Pre-release hanya di-install dengan nomor versi persis (§1), yang diambil dari halaman paket di npmjs.com atau `CHANGELOG.md` paket. Dist-tag `next` tidak dijamin menunjuk ke versi uji terbaru, jadi jangan meng-install dengan `@next`.
79
+
80
+ Rentang `~0.y.z` tidak pernah cocok dengan pre-release. Sampai rilis stabil pertama terbit, `pnpm add @plasgos/oidc-client` tanpa nomor versi gagal (tidak ada versi di dist-tag `latest`) atau mendapat sebuah pre-release yang tidak Anda pilih. Karena itu selalu install dengan nomor versi persis.
81
+
82
+ Perintah di §1 menulis versi persis (`x.y.z-next.n`) ke `package.json`, dan versi persis tidak pernah pindah sendiri. Bila yang tertulis adalah rentang `^` atau `~` pada pre-release, rentang itu juga menerima rilis stabil di minor yang sama, tetapi lockfile menahan pre-release itu sampai aplikasi menjalankan `pnpm update`. Setelah rilis stabil terbit, ubah versinya menjadi `~0.y.z` lewat PR.
83
+
84
+ **Perbaikan keamanan.** Perbaikan dirilis sebagai patch, dan tim Plasgos memberi tahu tim aplikasi yang memakai paket ini. Naikkan versi, perbarui lockfile, dan deploy secepatnya. Versi yang bermasalah di-deprecate (`npm deprecate`), tidak dihapus, supaya lockfile lama tetap bisa di-install sampai aplikasinya naik versi.
85
+
86
+ ## 6. Isi paket dan lisensi
87
+
88
+ - Paket berisi `dist` (ESM, CJS, `.d.ts`, dan source map), `README.md`, `CHANGELOG.md`, dan `LICENSE`. `@plasgos/oidc-client` dan `@plasgos/auth-verify` juga membawa folder `docs/` dengan isi yang sama: panduan ini dan file contohnya (`docs/examples/`).
89
+ - Source map ikut terbit lengkap dengan `sourcesContent`, supaya stack trace menunjuk ke sumber TypeScript. Karena paketnya publik, sumber TypeScript paket ikut terbaca siapa pun yang mengunduh paket. Ini disengaja.
90
+ - Lisensi: bukan open source. Paket milik Plasgos dan hanya boleh dipakai untuk menghubungkan aplikasi ke layanan Plasgos (login dan API Plasgos) oleh pemegang kredensial client resmi dari Plasgos dan pengembang yang bekerja untuk mereka. Menyalin, mengubah, menerbitkan ulang, atau mendistribusikan paket tanpa izin tertulis Plasgos dilarang. Teks lengkapnya ada di file [`LICENSE`](../LICENSE) di setiap paket.