@aiquants/auth-core 0.4.0 → 0.6.0

package/dist/index.d.mts

@@ -258,6 +258,43 @@ type AuthAllowlistEntry = (AuthAllowlistEntryBase & {
     groupKey: string;
     groupName: string;
 });
+/**
+ * One group as the upstream directory reports it. 上流ディレクトリが報告するグループ 1 件。
+ *
+ * ⚠️ **この形はディレクトリ連携の境界を 3 つ跨ぐ** — 上流アダプタが読み、永続化層が書き、管理 UI が
+ * 描く。各層で「同じ意味の別の型」を宣言すると、どの境界も構造的部分型で通ってしまい、**上流へ足した
+ * 欄が途中の層で黙って捨てられる**。コンパイラも型検査も何も言わない (実測: 必須欄を足しても
+ * `tsc --strict` は両方の境界で 0 を返す)。だから定義はここ 1 つに置き、各層はこれを import する。
+ *
+ * 正準キーは {@link externalId} である。{@link externalKey} は改名され得るため、比較にも保存にも
+ * 第一キーとして使ってはならない。
+ */
+type AuthDirectoryCatalogGroup = {
+    /** Stable upstream identifier. 上流の安定識別子。 */
+    externalId: string;
+    /** Operator-facing key such as the group address. 運用者向けキー (グループアドレス等)。 */
+    externalKey: string;
+    /** Display name as the upstream reports it. 上流が報告する表示名。 */
+    name: string;
+    /** Free-form description, when the upstream carries one. 上流が持つ場合の説明文。 */
+    description?: string;
+    /** Members the upstream reports for the group. 上流が報告するメンバー数。 */
+    memberCount?: number;
+};
+/**
+ * An upstream group list together with when the upstream was actually observed.
+ * 上流のグループ一覧と、上流を実際に観測した時刻。
+ *
+ * ⚠️ **時刻は省略できない。** この一覧は上流を直に叩いた結果とは限らず、資格情報を持つ別プロセスが
+ * 書いた **写し** であることが多い。時刻を伴わない一覧は「上流の現在」と読まれ、既に消えたグループを
+ * 選ばせる。`observedAt` が `null` は **一度も観測していない** ことを意味し、`groups` が空であることとは
+ * 独立である — 観測できて中身が空だった配備 (借用先の権限が狭い等) を「同期が動いていない」と
+ * 誤診させないため、2 つは必ず別々に運ぶ。
+ */
+type AuthDirectoryCatalogSnapshot = {
+    groups: AuthDirectoryCatalogGroup[];
+    observedAt: Date | null;
+};
 /**
  * Health of the external directory synchronization, surfaced in the admin UI.
  * 管理 UI に表示する外部ディレクトリ同期の健全性。
@@ -269,6 +306,14 @@ type AuthAllowlistEntry = (AuthAllowlistEntryBase & {
 type AuthDirectoryStatus = {
     /** False when directory integration is not wired for this deployment. 未結線なら false。 */
     isEnabled: boolean;
+    /**
+     * Upstream system this deployment synchronizes against, e.g. `"google"`. 同期先の上流システム。
+     *
+     * 新しい連携を作る面は、どの上流へ繋ぐのかを **設定から** 受け取る必要がある。UI 側に
+     * 特定の供給元を焼き込むと、別の上流を使う配備では作った連携が同期側で
+     * 「別プロバイダ」として恒久的に拒否され、赤いバナーとしてしか現れない。
+     */
+    provider: string;
     /** Number of groups whose membership is externally sourced. 外部供給グループの件数。 */
     linkedGroupCount: number;
     /**
@@ -298,4 +343,4 @@ type AuthDirectoryStatus = {
     pendingRequestCount: number;
 };
 
-export { type AuthAllowlistEntry, type AuthAllowlistOwner, type AuthDirectoryMembershipMode, type AuthDirectoryStatus, type AuthGroup, type AuthGroupExternalLink, type AuthGroupMember, type AuthMessages, type AuthUser, type AuthenticationPayload, type GoogleProfileBase, type MyGoogleProfile, type SessionProfile, defaultAuthMessages, emailDomainAllowlist, normalizeAuthEmail, parseAllowlistCsv, resolveAuthMessages };
+export { type AuthAllowlistEntry, type AuthAllowlistOwner, type AuthDirectoryCatalogGroup, type AuthDirectoryCatalogSnapshot, type AuthDirectoryMembershipMode, type AuthDirectoryStatus, type AuthGroup, type AuthGroupExternalLink, type AuthGroupMember, type AuthMessages, type AuthUser, type AuthenticationPayload, type GoogleProfileBase, type MyGoogleProfile, type SessionProfile, defaultAuthMessages, emailDomainAllowlist, normalizeAuthEmail, parseAllowlistCsv, resolveAuthMessages };

package/dist/index.d.ts

@@ -258,6 +258,43 @@ type AuthAllowlistEntry = (AuthAllowlistEntryBase & {
     groupKey: string;
     groupName: string;
 });
+/**
+ * One group as the upstream directory reports it. 上流ディレクトリが報告するグループ 1 件。
+ *
+ * ⚠️ **この形はディレクトリ連携の境界を 3 つ跨ぐ** — 上流アダプタが読み、永続化層が書き、管理 UI が
+ * 描く。各層で「同じ意味の別の型」を宣言すると、どの境界も構造的部分型で通ってしまい、**上流へ足した
+ * 欄が途中の層で黙って捨てられる**。コンパイラも型検査も何も言わない (実測: 必須欄を足しても
+ * `tsc --strict` は両方の境界で 0 を返す)。だから定義はここ 1 つに置き、各層はこれを import する。
+ *
+ * 正準キーは {@link externalId} である。{@link externalKey} は改名され得るため、比較にも保存にも
+ * 第一キーとして使ってはならない。
+ */
+type AuthDirectoryCatalogGroup = {
+    /** Stable upstream identifier. 上流の安定識別子。 */
+    externalId: string;
+    /** Operator-facing key such as the group address. 運用者向けキー (グループアドレス等)。 */
+    externalKey: string;
+    /** Display name as the upstream reports it. 上流が報告する表示名。 */
+    name: string;
+    /** Free-form description, when the upstream carries one. 上流が持つ場合の説明文。 */
+    description?: string;
+    /** Members the upstream reports for the group. 上流が報告するメンバー数。 */
+    memberCount?: number;
+};
+/**
+ * An upstream group list together with when the upstream was actually observed.
+ * 上流のグループ一覧と、上流を実際に観測した時刻。
+ *
+ * ⚠️ **時刻は省略できない。** この一覧は上流を直に叩いた結果とは限らず、資格情報を持つ別プロセスが
+ * 書いた **写し** であることが多い。時刻を伴わない一覧は「上流の現在」と読まれ、既に消えたグループを
+ * 選ばせる。`observedAt` が `null` は **一度も観測していない** ことを意味し、`groups` が空であることとは
+ * 独立である — 観測できて中身が空だった配備 (借用先の権限が狭い等) を「同期が動いていない」と
+ * 誤診させないため、2 つは必ず別々に運ぶ。
+ */
+type AuthDirectoryCatalogSnapshot = {
+    groups: AuthDirectoryCatalogGroup[];
+    observedAt: Date | null;
+};
 /**
  * Health of the external directory synchronization, surfaced in the admin UI.
  * 管理 UI に表示する外部ディレクトリ同期の健全性。
@@ -269,6 +306,14 @@ type AuthAllowlistEntry = (AuthAllowlistEntryBase & {
 type AuthDirectoryStatus = {
     /** False when directory integration is not wired for this deployment. 未結線なら false。 */
     isEnabled: boolean;
+    /**
+     * Upstream system this deployment synchronizes against, e.g. `"google"`. 同期先の上流システム。
+     *
+     * 新しい連携を作る面は、どの上流へ繋ぐのかを **設定から** 受け取る必要がある。UI 側に
+     * 特定の供給元を焼き込むと、別の上流を使う配備では作った連携が同期側で
+     * 「別プロバイダ」として恒久的に拒否され、赤いバナーとしてしか現れない。
+     */
+    provider: string;
     /** Number of groups whose membership is externally sourced. 外部供給グループの件数。 */
     linkedGroupCount: number;
     /**
@@ -298,4 +343,4 @@ type AuthDirectoryStatus = {
     pendingRequestCount: number;
 };
 
-export { type AuthAllowlistEntry, type AuthAllowlistOwner, type AuthDirectoryMembershipMode, type AuthDirectoryStatus, type AuthGroup, type AuthGroupExternalLink, type AuthGroupMember, type AuthMessages, type AuthUser, type AuthenticationPayload, type GoogleProfileBase, type MyGoogleProfile, type SessionProfile, defaultAuthMessages, emailDomainAllowlist, normalizeAuthEmail, parseAllowlistCsv, resolveAuthMessages };
+export { type AuthAllowlistEntry, type AuthAllowlistOwner, type AuthDirectoryCatalogGroup, type AuthDirectoryCatalogSnapshot, type AuthDirectoryMembershipMode, type AuthDirectoryStatus, type AuthGroup, type AuthGroupExternalLink, type AuthGroupMember, type AuthMessages, type AuthUser, type AuthenticationPayload, type GoogleProfileBase, type MyGoogleProfile, type SessionProfile, defaultAuthMessages, emailDomainAllowlist, normalizeAuthEmail, parseAllowlistCsv, resolveAuthMessages };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiquants/auth-core",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Transport-agnostic auth core: shared session/profile types, email/domain allowlist policy, and localizable auth error messages. No framework or provider SDK dependency.",
   "sideEffects": false,
   "main": "dist/index.js",