@valon-technologies/gestalt 0.0.1-alpha.17 → 0.0.1-alpha.19

package/src/api.ts

@@ -6,6 +6,26 @@ export interface Subject {
   kind: string;
   displayName: string;
   authSource: string;
+  email: string;
+}
+
+/**
+ * Subject payload authored by provider-side hooks.
+ */
+export interface SubjectInput {
+  id: string;
+  kind: string;
+  displayName: string;
+  authSource: string;
+  email?: string | undefined;
+}
+
+/**
+ * Provider-owned external identity attached to an incoming provider request.
+ */
+export interface ExternalIdentity {
+  type: string;
+  id: string;
 }
 
 /**
@@ -26,6 +46,13 @@ export interface Access {
   role: string;
 }
 
+/**
+ * Describes public host metadata available to provider code.
+ */
+export interface Host {
+  publicBaseUrl: string;
+}
+
 /**
  * Request metadata forwarded to provider handlers by the Gestalt runtime.
  */
@@ -33,8 +60,12 @@ export interface Request {
   token: string;
   connectionParams: Record<string, string>;
   subject: Subject;
+  agentSubject: Subject;
+  externalIdentity: ExternalIdentity;
+  agentExternalIdentity: ExternalIdentity;
   credential: Credential;
   access: Access;
+  host: Host;
   idempotencyKey: string;
   // Workflow callback metadata uses a JSON-style lowerCamelCase object such as
   // runId, target.plugin.pluginName, trigger.scheduleId, and trigger.event.specVersion.
@@ -106,6 +137,10 @@ export function request(
   workflow: Record<string, unknown> = {},
   invocationToken = "",
   idempotencyKey = "",
+  host: Partial<Host> = {},
+  agentSubject: Partial<Subject> = {},
+  externalIdentity: Partial<ExternalIdentity> = {},
+  agentExternalIdentity: Partial<ExternalIdentity> = {},
 ): Request {
   return {
     token,
@@ -117,6 +152,22 @@ export function request(
       kind: subject.kind ?? "",
       displayName: subject.displayName ?? "",
       authSource: subject.authSource ?? "",
+      email: subject.email ?? "",
+    },
+    agentSubject: {
+      id: agentSubject.id ?? "",
+      kind: agentSubject.kind ?? "",
+      displayName: agentSubject.displayName ?? "",
+      authSource: agentSubject.authSource ?? "",
+      email: agentSubject.email ?? "",
+    },
+    externalIdentity: {
+      type: externalIdentity.type ?? "",
+      id: externalIdentity.id ?? "",
+    },
+    agentExternalIdentity: {
+      type: agentExternalIdentity.type ?? "",
+      id: agentExternalIdentity.id ?? "",
     },
     credential: {
       mode: credential.mode ?? "",
@@ -131,6 +182,9 @@ export function request(
     workflow: {
       ...workflow,
     },
+    host: {
+      publicBaseUrl: host.publicBaseUrl ?? "",
+    },
     invocationToken,
     idempotencyKey: idempotencyKey.trim(),
   };

package/src/auth.ts

@@ -1,4 +1,4 @@
-import { RuntimeProvider, type RuntimeProviderOptions } from "./provider.ts";
+import { ProviderBase, type ProviderBaseOptions } from "./provider.ts";
 import type { MaybePromise } from "./api.ts";
 
 /**
@@ -52,7 +52,7 @@ export interface AuthenticationSessionSettings {
 /**
  * Runtime hooks required to implement a Gestalt authentication provider.
  */
-export interface AuthenticationProviderOptions extends RuntimeProviderOptions {
+export interface AuthenticationProviderOptions extends ProviderBaseOptions {
   beginLogin: (
     request: BeginLoginRequest,
   ) => MaybePromise<BeginLoginResponse>;
@@ -68,7 +68,7 @@ export interface AuthenticationProviderOptions extends RuntimeProviderOptions {
 /**
  * Authentication provider implementation consumed by the Gestalt runtime.
  */
-export class AuthenticationProvider extends RuntimeProvider {
+export class AuthenticationProvider extends ProviderBase {
   readonly kind = "authentication" as const;
 
   private readonly beginLoginHandler: AuthenticationProviderOptions["beginLogin"];