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

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 (62) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/LICENSE +4 -3
  3. package/README.md +27 -14
  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 +71 -20
  17. package/dist/session.cjs.map +1 -1
  18. package/dist/session.d.cts +57 -6
  19. package/dist/session.d.ts +57 -6
  20. package/dist/session.js +63 -13
  21. package/dist/session.js.map +1 -1
  22. package/dist/{types-Cncksfeo.d.cts → types-JE0OMyoi.d.cts} +1 -1
  23. package/dist/{types-Cncksfeo.d.ts → types-JE0OMyoi.d.ts} +1 -1
  24. package/docs/bff-express.md +1314 -0
  25. package/docs/consumers.md +98 -0
  26. package/docs/contoh-hitungcuan.md +255 -0
  27. package/docs/contoh-plaslink.md +244 -0
  28. package/docs/error.md +613 -0
  29. package/docs/examples/auth-verify-readme.ts +42 -0
  30. package/docs/examples/bff-express.ts +370 -0
  31. package/docs/examples/bff-proxy.ts +335 -0
  32. package/docs/examples/bff-redis-lock.ts +187 -0
  33. package/docs/examples/bff-revocation.ts +136 -0
  34. package/docs/examples/config-error.ts +24 -0
  35. package/docs/examples/env.ts +150 -0
  36. package/docs/examples/failure-log.ts +18 -0
  37. package/docs/examples/login-client.ts +46 -0
  38. package/docs/examples/login-flow.ts +186 -0
  39. package/docs/examples/plaslink-connect.ts +48 -0
  40. package/docs/examples/readme.ts +60 -0
  41. package/docs/examples/service-client.ts +105 -0
  42. package/docs/examples/session-store.ts +53 -0
  43. package/docs/examples/token-commonjs.cjs +95 -0
  44. package/docs/examples/token-express.ts +56 -0
  45. package/docs/examples/token-fetch.ts +24 -0
  46. package/docs/examples/token-nestjs-jest.ts +77 -0
  47. package/docs/examples/token-nestjs.ts +127 -0
  48. package/docs/examples/token-socket.ts +59 -0
  49. package/docs/examples/token-testing.ts +100 -0
  50. package/docs/examples/token-verifier.ts +132 -0
  51. package/docs/examples/user-events.ts +110 -0
  52. package/docs/examples/webhook-express.ts +46 -0
  53. package/docs/examples/webhook-fetch.ts +60 -0
  54. package/docs/examples/webhook-nestjs.ts +59 -0
  55. package/docs/examples/webhook-testing.ts +60 -0
  56. package/docs/examples/webhook-verifier.ts +197 -0
  57. package/docs/login-web.md +650 -0
  58. package/docs/memulai.md +419 -0
  59. package/docs/server-ke-server.md +287 -0
  60. package/docs/verifikasi-token.md +1219 -0
  61. package/docs/webhook.md +810 -0
  62. package/package.json +3 -2
package/CHANGELOG.md CHANGED
@@ -1,5 +1,32 @@
1
1
  # @plasgos/oidc-client
2
2
 
3
+ ## 0.1.0-next.3
4
+
5
+ ### Minor Changes
6
+
7
+ - ecc836b: Scope dan audience CRM: `crm:access` di `USER_SCOPES` dan `FIRST_PARTY_ONLY_SCOPES` (wajib bersama `resource`), `DEFAULT_AUDIENCES.crm` (`https://api.plasgos.co.id/crm`), dan tujuh scope service baru di `SERVICE_SCOPES` (`users:profile.read`, `users:legacy.read`, `packages:service.read`, `packages:service.write`, `subscriptions:catalog.write`, `subscriptions:read`, `subscriptions:grants.write`). `createOidcClient` kini menolak `crm:access` tanpa `resource` atau pada client pihak ketiga, dan menolak scope service baru di client login.
8
+ - cebfd60: Scope `phone` di `USER_SCOPES`: client login boleh memintanya (pihak pertama dan pihak ketiga), sedangkan `createServiceClient` menolaknya. Klaim `phone_number` dan `phone_number_verified` hanya dikirim bila nomor ponsel akun sudah terverifikasi. Pada login dengan `resource` klaim ada di ID token (dibaca lewat `extraClaims`); tanpa `resource` klaim diambil dari endpoint userinfo.
9
+ - f1b78dd: `createSessionStore` menerima opsi `path` (bawaan `"/"`). Dengan `"/"` tidak ada yang berubah (`__Host-`, `Path=/`). Dengan path lain, misalnya `"/crm/"`, nama cookie memakai `__Secure-` dan setiap cookie yang ditulis atau dihapus memakai `Path` itu, untuk BFF yang berjalan di bawah sub-path. Format cookie dan isi sesi tidak berubah, jadi cookie lama tetap terbaca. `readAccessTokenClaims` di `@plasgos/oidc-client/session` membaca `sid`, `cv`, dan `plasgos_public_id` dari access token milik sesi (tanpa verifikasi; hanya properti milik payload itu sendiri, bukan warisan prototype), untuk pemeriksaan pencabutan di BFF. Panduan `docs/login-web.md` dan `docs/error.md` diperbarui (ikut terbit di kedua paket).
10
+
11
+ ### Patch Changes
12
+
13
+ - da4ecca: Verifikasi access token Plasgos di API milik aplikasi: `createAccessTokenVerifier` (JWKS, RS256, `at+jwt`, `iss` dan `aud` persis, scope, klaim wajib lewat `requireClaims`, `maxAuthAge`, hook `isRevoked`; JWKS yang tidak bisa dibaca dijawab `503`), `@plasgos/auth-verify/express` (`requirePlasgosToken`), dan `@plasgos/auth-verify/nestjs` (`PlasgosAuthModule`, `PlasgosAccessTokenGuard`, `@RequireScopes`, `@RequireRecentAuth`, `@PlasgosPrincipal`; NestJS 11). Ketiganya menjawab penolakan dengan status, `Cache-Control: no-store`, `WWW-Authenticate` bila ada, dan body `{"error":"<errorCode>"}`; middleware Express meneruskan penolakan ke `next(error)` bila respons sudah terkirim atau tidak bisa ditulis, dan error lain yang hanya meminjam nama `AuthVerifyError` diperlakukan sebagai error biasa. Token untuk audience `crm` wajib membawa `cv`. Build CommonJS memuat `jose` di dalamnya, sehingga bisa dipakai aplikasi CommonJS dan Jest tanpa pengaturan tambahan. `AuthVerifyError` ada di `@plasgos/auth-shared`. Panduan baru `docs/verifikasi-token.md` dan `docs/bff-express.md`; `error.md`, `memulai.md`, dan `login-web.md` diperbarui (ikut terbit di kedua paket).
14
+ - e7f5278: `presets.appEvents` di `@plasgos/auth-verify/webhook`: preset untuk endpoint webhook aplikasi yang menerima event pembayaran, langganan, paket, dan user dengan satu secret. Header dan cara verifikasinya sama dengan `presets.payments`; hanya nama preset di hasil verifikasi yang berbeda. Panduan `docs/webhook.md` diperbarui (ikut terbit di kedua paket).
15
+ - Updated dependencies [da4ecca]
16
+ - Updated dependencies [ecc836b]
17
+ - Updated dependencies [cebfd60]
18
+ - @plasgos/auth-shared@0.1.0-next.3
19
+
20
+ ## 0.1.0-next.2
21
+
22
+ ### Patch Changes
23
+
24
+ - 08750ea: Rilis awal `@plasgos/auth-verify` dengan `@plasgos/auth-verify/webhook`: `createWebhookVerifier` dan `verifyWebhook` untuk webhook payments (`presets.payments`) dan pengiriman Plaslink (`presets.plaslinkShipping`), rotasi secret, batas waktu 300 detik, dan batas ukuran. `WebhookVerifyError` ada di `@plasgos/auth-shared`. Panduan baru `docs/webhook.md`; `contoh-hitungcuan.md`, `contoh-plaslink.md`, `error.md`, dan `memulai.md` diperbarui, dan panduan yang terbit di `@plasgos/oidc-client` ikut berubah. Panduan kini juga ikut di paket `@plasgos/auth-verify`. `LICENSE` di ketiga paket kini menyebut setiap paket (`@plasgos/oidc-client`, `@plasgos/auth-verify`, dan `@plasgos/auth-shared`) dan webhook Plasgos. Pesan `ConfigError` `logoutTicket requires backchannelUrl` di `@plasgos/oidc-client` kini menyebut alamat internal server Plasgos (`the internal Plasgos server URL`).
25
+ - 1bbdbc4: Panduan pemakaian kini ikut di paket `@plasgos/oidc-client`, di folder `docs/` (`memulai.md`, `login-web.md`, `server-ke-server.md`, `error.md`, `contoh-hitungcuan.md`, `contoh-plaslink.md`, `consumers.md`, dan file contoh di `docs/examples/`). Panduan bisa dibaca di tab Code halaman paket di npmjs.com atau di `node_modules/@plasgos/oidc-client/docs/`. Tidak ada perubahan kode.
26
+ - Updated dependencies [08750ea]
27
+ - Updated dependencies [1bbdbc4]
28
+ - @plasgos/auth-shared@0.1.0-next.2
29
+
3
30
  ## 0.1.0-next.1
4
31
 
5
32
  ### Patch Changes
package/LICENSE CHANGED
@@ -1,8 +1,9 @@
1
1
  Hak Cipta (c) 2026 Plasgos. Seluruh hak dilindungi.
2
2
 
3
- Perangkat lunak ini (paket npm @plasgos/oidc-client dan @plasgos/auth-shared beserta dokumentasinya) adalah
4
- milik Plasgos dan disediakan HANYA untuk menghubungkan aplikasi ke layanan Plasgos (login Plasgos dan API
5
- Plasgos) oleh pihak yang memiliki kredensial client resmi dari Plasgos, sesuai ketentuan layanan Plasgos.
3
+ Perangkat lunak ini (paket npm @plasgos/oidc-client, @plasgos/auth-verify, dan @plasgos/auth-shared beserta
4
+ dokumentasinya) adalah milik Plasgos dan disediakan HANYA untuk menghubungkan aplikasi ke layanan Plasgos
5
+ (login Plasgos, API Plasgos, dan webhook Plasgos) oleh pihak yang memiliki kredensial client resmi dari
6
+ Plasgos, sesuai ketentuan layanan Plasgos.
6
7
 
7
8
  Pemegang kredensial tersebut dan pengembang yang bekerja untuk mereka boleh memasang dan memanggil perangkat
8
9
  lunak ini di aplikasi mereka untuk keperluan itu. Selain itu, tanpa izin tertulis Plasgos, dilarang menyalin,
package/README.md CHANGED
@@ -8,6 +8,8 @@ Client OIDC Plasgos untuk server Node. Paket ini untuk aplikasi yang **meminta**
8
8
 
9
9
  Hanya untuk server (Node `>=22.22`), tersedia sebagai ESM dan CommonJS. Tidak ada dependensi runtime selain `@plasgos/auth-shared`, yang ikut terpasang dengan versi yang sama.
10
10
 
11
+ **Link `@next`.** Link panduan di README ini (alamat `cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/…`) membuka pre-release yang ditunjuk tag `next` di npm, yang bisa lebih baru atau lebih lama dari versi yang Anda pasang. Untuk versi yang terpasang, baca `node_modules/@plasgos/oidc-client/docs/`.
12
+
11
13
  ## Install
12
14
 
13
15
  Paket ini ada di npmjs.com dan di-install tanpa token. Pakai nomor versi persis, karena versi yang terbit masih pre-release:
@@ -16,7 +18,7 @@ Paket ini ada di npmjs.com dan di-install tanpa token. Pakai nomor versi persis,
16
18
  pnpm add @plasgos/oidc-client@<versi> --save-exact
17
19
  ```
18
20
 
19
- Aturan versi, Docker, dan CI ada di [`docs/consumers.md`](../../docs/consumers.md).
21
+ Aturan versi, Docker, dan CI ada di [`docs/consumers.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/consumers.md).
20
22
 
21
23
  ## Lisensi
22
24
 
@@ -26,11 +28,11 @@ Bukan open source. Paket ini milik Plasgos dan hanya boleh dipakai untuk menghub
26
28
 
27
29
  | Import | Untuk | Panduan |
28
30
  |---|---|---|
29
- | `@plasgos/oidc-client` | Login user: `createOidcClient` | [`login-web.md`](../../docs/guides/login-web.md) |
30
- | `@plasgos/oidc-client/session` | Cookie sesi tersegel: `createSessionStore` | [`login-web.md`](../../docs/guides/login-web.md) |
31
- | `@plasgos/oidc-client/service` | Server ke server: `createServiceClient` | [`server-ke-server.md`](../../docs/guides/server-ke-server.md) |
31
+ | `@plasgos/oidc-client` | Login user: `createOidcClient` | [`login-web.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/login-web.md) |
32
+ | `@plasgos/oidc-client/session` | Cookie sesi tersegel: `createSessionStore` (juga di bawah sub-path dengan `path`), `readAccessTokenClaims` | [`login-web.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/login-web.md) |
33
+ | `@plasgos/oidc-client/service` | Server ke server: `createServiceClient` | [`server-ke-server.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/server-ke-server.md) |
32
34
 
33
- Mulai dari [`docs/guides/memulai.md`](../../docs/guides/memulai.md): paket mana yang dipakai, env, sandbox dan production, scope, dan cara mendapat kredensial.
35
+ Mulai dari [`docs/memulai.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/memulai.md): paket mana yang dipakai, env, sandbox dan production, scope, dan cara mendapat kredensial. Daftar semua panduan ada di [Panduan](#panduan).
34
36
 
35
37
  ## Contoh
36
38
 
@@ -61,7 +63,7 @@ export function login(client: OidcClient, store: SessionStore<object>): Response
61
63
  ```
62
64
  <!-- /snippet -->
63
65
 
64
- Client mengembalikan `startLogin`, `handleCallback`, `refresh`, `ensureFresh`, dan `logout`. Route callback dan logout yang lengkap ada di [`login-web.md`](../../docs/guides/login-web.md).
66
+ Client mengembalikan `startLogin`, `handleCallback`, `refresh`, `ensureFresh`, dan `logout`. Route callback dan logout yang lengkap ada di [`login-web.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/login-web.md).
65
67
 
66
68
  ### `@plasgos/oidc-client/session`: cookie sesi
67
69
 
@@ -86,7 +88,7 @@ export function currentUser(store: SessionStore<object>, request: Request): Sess
86
88
  ```
87
89
  <!-- /snippet -->
88
90
 
89
- Sesi disegel dengan AES-256-GCM (kunci HKDF per cookie, nama cookie terikat sebagai AAD). Cookie yang rusak atau tidak bisa dibuka dianggap tidak ada, tidak pernah menjadi error. Format cookie kompatibel dengan cookie plasgos-shipping-v2 dan plasgos-accounts-v2 yang sudah beredar.
91
+ Sesi disegel dengan AES-256-GCM (kunci HKDF per cookie, nama cookie terikat sebagai AAD). Cookie yang rusak atau tidak bisa dibuka dianggap tidak ada, tidak pernah menjadi error. Format cookie kompatibel dengan cookie aplikasi Plasgos (Kirim Paket dan accounts) yang sudah beredar.
90
92
 
91
93
  ### `@plasgos/oidc-client/service`: server ke server
92
94
 
@@ -114,7 +116,7 @@ Token disimpan di memori dan diminta lagi saat hampir habis. `fetch` mengulang s
114
116
  | Import | Fungsi dan nilai | Type |
115
117
  |---|---|---|
116
118
  | `@plasgos/oidc-client` | `createOidcClient`, `accessTokenExpiry`, `memoryLockStore`, `OidcError`, `ConfigError` | `OidcClient`, `OidcClientOptions`, `StartLoginInput`, `StartLoginResult`, `HandleCallbackOptions`, `CallbackResult`, `VerifiedIdTokenClaims`, `EnsureFreshOptions`, `EnsureFreshResult`, `RefreshableAuth`, `LogoutInput`, `LogoutResult`, `OidcTransaction`, `OidcFetch`, `RefreshLockStore`, `OidcFailureEvent`, `OidcOperation`, `OidcErrorReason`, `OidcUpstream`, `ClientProfile`, `Environment`, `IdTokenClaims`, `TokenSet`, `UserScope` |
117
- | `@plasgos/oidc-client/session` | `createSessionStore`, `SessionTooLargeError`, `memoryLockStore`, `deriveKeyRing`, `sealCookie`, `openCookie`, `ConfigError` | `SessionStore`, `SessionStoreOptions`, `SessionHandle`, `SessionData`, `SessionSchema`, `SessionFailureEvent`, `AuthState`, `SessionUser`, `OidcTransaction`, `RefreshLockStore`, `KeyRing` |
119
+ | `@plasgos/oidc-client/session` | `createSessionStore` (dengan opsi `path` untuk aplikasi di bawah sub-path), `readAccessTokenClaims`, `SessionTooLargeError`, `memoryLockStore`, `deriveKeyRing`, `sealCookie`, `openCookie`, `ConfigError` | `SessionStore`, `SessionStoreOptions`, `SessionHandle`, `SessionData`, `SessionSchema`, `SessionFailureEvent`, `AuthState`, `SessionUser`, `AccessTokenSessionClaims`, `OidcTransaction`, `RefreshLockStore`, `KeyRing` |
118
120
  | `@plasgos/oidc-client/service` | `createServiceClient`, `OidcError`, `ConfigError` | `ServiceClient`, `ServiceClientOptions`, `ServiceScope`, `OidcFailureEvent`, `OidcOperation`, `OidcFetch`, `OidcErrorReason`, `OidcUpstream`, `Environment` |
119
121
 
120
122
  Setiap export punya JSDoc dengan contoh.
@@ -126,12 +128,23 @@ Setiap export punya JSDoc dengan contoh.
126
128
  - Paket tidak pernah menulis log. Setiap kegagalan diserahkan ke hook `onFailure` milik aplikasi.
127
129
  - Pesan error dan event tidak pernah memuat token, code, secret, atau isi cookie.
128
130
 
129
- Arti setiap `reason`, penyebab umum, dan penanganannya ada di [`error.md`](../../docs/guides/error.md).
131
+ Arti setiap `reason`, penyebab umum, dan penanganannya ada di [`error.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/error.md).
130
132
 
131
133
  ## Panduan
132
134
 
133
- - [`memulai.md`](../../docs/guides/memulai.md): mulai dari sini
134
- - [`login-web.md`](../../docs/guides/login-web.md): login user di aplikasi web
135
- - [`server-ke-server.md`](../../docs/guides/server-ke-server.md): memanggil API Plasgos dari server
136
- - [`error.md`](../../docs/guides/error.md): semua error dan `reason`
137
- - [`contoh-hitungcuan.md`](../../docs/guides/contoh-hitungcuan.md), [`contoh-plaslink.md`](../../docs/guides/contoh-plaslink.md): contoh lengkap
135
+ Panduan pemakaian (Bahasa Indonesia) ikut di paket ini, di folder `docs/`. Link di bawah membuka pre-release yang ditunjuk tag `next` secara online (jsDelivr). Untuk versi yang Anda pasang, bacanya di `node_modules/@plasgos/oidc-client/docs/`, atau di tab **Code** halaman paket di npmjs.com.
136
+
137
+ | Panduan | Untuk apa |
138
+ |---|---|
139
+ | [`memulai.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/memulai.md) | Mulai dari sini: paket mana untuk kebutuhan apa, env, sandbox dan production, scope, cara mendapat kredensial |
140
+ | [`login-web.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/login-web.md) | Login user di aplikasi web: route login, callback, logout, sesi cookie, refresh |
141
+ | [`bff-express.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/bff-express.md) | BFF Node/Express untuk SPA atau PWA: lock refresh Redis, sub-path, pencabutan sesi, proxy API dan socket, CSRF |
142
+ | [`server-ke-server.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/server-ke-server.md) | Memanggil API Plasgos dari server tanpa user (`client_credentials`), contoh payments |
143
+ | [`webhook.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/webhook.md) | Menerima webhook dari Plasgos dengan `@plasgos/auth-verify/webhook` |
144
+ | [`verifikasi-token.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/verifikasi-token.md) | Memeriksa access token Plasgos di API sendiri dengan `@plasgos/auth-verify` (Express, NestJS, `Request`) |
145
+ | [`error.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/error.md) | Semua error dan `reason`: arti, penyebab umum, penanganan |
146
+ | [`contoh-hitungcuan.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/contoh-hitungcuan.md) | Contoh lengkap aplikasi yang hanya memakai payments |
147
+ | [`contoh-plaslink.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/contoh-plaslink.md) | Contoh lengkap login seller dan payments |
148
+ | [`consumers.md`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/consumers.md) | Install, Docker, CI, aturan versi, lisensi |
149
+
150
+ File contoh yang dikutip panduan ada di [`docs/examples/`](https://cdn.jsdelivr.net/npm/@plasgos/oidc-client@next/docs/examples/). Semuanya lolos typecheck terhadap versi paket ini.
package/dist/index.cjs CHANGED
@@ -557,7 +557,7 @@ function resolveConfig(raw) {
557
557
  } else if (endSession2 === "form-post") {
558
558
  problems.push('logoutTicket is not used with endSession "form-post"');
559
559
  } else if (!present("backchannelUrl")) {
560
- problems.push("logoutTicket requires backchannelUrl (the internal api-main URL)");
560
+ problems.push("logoutTicket requires backchannelUrl (the internal Plasgos server URL)");
561
561
  }
562
562
  }
563
563
  const logoutTicket = logoutTicketRaw === true || logoutTicketRaw === void 0 && profile === "first-party" && endSession2 === "redirect" && backchannelUrl !== void 0;
@@ -565,7 +565,7 @@ function resolveConfig(raw) {
565
565
  problems.push('endSession must be "redirect" or "form-post"');
566
566
  } else if (
567
567
  // Sandbox is left alone: local development runs the app and the issuer on two ports. The
568
- // provider still answers a cross-origin form POST with 403 (plan decision 14).
568
+ // provider still answers a cross-origin form POST with 403.
569
569
  raw["environment"] === "production" && endSession2 === "form-post" && issuer !== void 0 && redirectUri !== void 0 && new URL(redirectUri).origin !== issuer
570
570
  ) {
571
571
  problems.push('endSession "form-post" requires redirectUri on the issuer origin');