@askdkc/dsh-cli 0.11.3

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/presentation/lib/index.d.ts

@@ -0,0 +1,262 @@
+import { CapabilityClient, CapabilityHandlerContext, CapabilityImplementation } from "@dsh-std/connection";
+import { ProtocolCatalog, ProtocolDefinition, ProtocolSupport } from "@dsh-std/core";
+//#region src/index.d.ts
+declare const API_VERSION = "presentation.dsh/v1alpha1";
+declare const OPEN_EXTERNAL_KIND = "OpenExternal";
+declare const COPY_TEXT_KIND = "CopyText";
+declare const NOTIFICATION_KIND = "Notification";
+declare const USER_INTERACTION_KIND = "UserInteraction";
+interface PresentationDescriptor {
+  /** Endpoint identity selected and authenticated by the Host for this invocation. */
+  readonly clientId: string;
+  /** Active Presentation agreements projected into this invocation. */
+  readonly contracts: readonly ProtocolSupport[];
+}
+interface PresentationRequestContext {
+  readonly requestId: string;
+  readonly invocationId: string;
+  readonly origin: string;
+  readonly deadline?: string;
+}
+/** Invocation authority supplied by the Host when it creates scoped clients. */
+interface PresentationInvocationScope {
+  readonly invocationId: string;
+  readonly origin: string;
+  readonly deadline?: string;
+  nextRequestId(): string;
+}
+type PresentationResult<T> = {
+  readonly status: 'submitted';
+  readonly value: T;
+} | {
+  readonly status: 'cancelled';
+} | {
+  readonly status: 'expired';
+} | {
+  readonly status: 'unavailable';
+  readonly reason?: string;
+};
+interface OpenExternalRequest extends PresentationRequestContext {
+  readonly uri: string;
+}
+type OpenExternalInput = Omit<OpenExternalRequest, keyof PresentationRequestContext>;
+interface OpenExternalReceipt {
+  readonly accepted: true;
+}
+interface CopyTextRequest extends PresentationRequestContext {
+  readonly text: string;
+  readonly sensitivity?: 'public' | 'private';
+}
+type CopyTextInput = Omit<CopyTextRequest, keyof PresentationRequestContext>;
+interface CopyTextReceipt {
+  readonly accepted: true;
+}
+interface NotificationRequest extends PresentationRequestContext {
+  readonly text: string;
+  readonly level?: 'info' | 'warning' | 'error';
+  readonly deduplicationKey?: string;
+}
+type NotificationInput = Omit<NotificationRequest, keyof PresentationRequestContext>;
+interface NotificationReceipt {
+  readonly accepted: true;
+}
+type UserInteractionOperation = 'question' | 'approval' | 'secret-input';
+interface UserInteractionRequirementSpec {
+  readonly operations: readonly UserInteractionOperation[];
+  readonly optionalOperations?: readonly UserInteractionOperation[];
+}
+interface UserInteractionLimits {
+  readonly maxConcurrentRequests?: number;
+  readonly maxFields?: number;
+  readonly maxOptionsPerField?: number;
+  readonly maxTextLength?: number;
+}
+interface UserInteractionSupportSpec {
+  readonly operations: readonly UserInteractionOperation[];
+  readonly limits?: UserInteractionLimits;
+}
+interface QuestionOption {
+  readonly id: string;
+  readonly label: string;
+  readonly description?: string;
+}
+interface QuestionFieldBase {
+  readonly id: string;
+  readonly label: string;
+  readonly description?: string;
+  readonly required?: boolean;
+}
+interface TextQuestionField extends QuestionFieldBase {
+  readonly kind: 'text';
+  readonly multiline?: boolean;
+  readonly minLength?: number;
+  readonly maxLength?: number;
+}
+interface SelectQuestionField extends QuestionFieldBase {
+  readonly kind: 'select';
+  readonly multiple?: boolean;
+  readonly options: readonly QuestionOption[];
+}
+interface ConfirmQuestionField extends QuestionFieldBase {
+  readonly kind: 'confirm';
+}
+type QuestionField = TextQuestionField | SelectQuestionField | ConfirmQuestionField;
+interface QuestionRequest extends PresentationRequestContext {
+  readonly kind: 'question';
+  readonly title?: string;
+  readonly description?: string;
+  readonly fields: readonly QuestionField[];
+}
+interface QuestionAnswers {
+  readonly answers: Readonly<Record<string, string | boolean | readonly string[]>>;
+}
+interface ApprovalDetail {
+  readonly label: string;
+  readonly value: string;
+  readonly sensitivity?: 'public' | 'private';
+}
+interface ApprovalRequest extends PresentationRequestContext {
+  readonly kind: 'approval';
+  readonly action: string;
+  readonly summary: string;
+  readonly details?: readonly ApprovalDetail[];
+  readonly risk?: 'low' | 'medium' | 'high';
+}
+interface ApprovalValue {
+  readonly decision: 'approved' | 'denied';
+}
+interface SecretInputRequest extends PresentationRequestContext {
+  readonly kind: 'secret-input';
+  readonly label: string;
+  readonly description?: string;
+  readonly minLength?: number;
+  readonly maxLength?: number;
+}
+interface SecretInputValue {
+  readonly secret: string;
+}
+type UserInteractionRequest = QuestionRequest | ApprovalRequest | SecretInputRequest;
+type UserInteractionValue = QuestionAnswers | ApprovalValue | SecretInputValue;
+type QuestionInput = Omit<QuestionRequest, keyof PresentationRequestContext>;
+type ApprovalInput = Omit<ApprovalRequest, keyof PresentationRequestContext>;
+type SecretInput = Omit<SecretInputRequest, keyof PresentationRequestContext>;
+interface OpenExternalClient {
+  openExternal(input: OpenExternalInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<PresentationResult<OpenExternalReceipt>>;
+}
+interface CopyTextClient {
+  copyText(input: CopyTextInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<PresentationResult<CopyTextReceipt>>;
+}
+interface NotificationClient {
+  notify(input: NotificationInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<PresentationResult<NotificationReceipt>>;
+}
+interface UserInteractionClient {
+  interact(input: QuestionInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<PresentationResult<QuestionAnswers>>;
+  interact(input: ApprovalInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<PresentationResult<ApprovalValue>>;
+  interact(input: SecretInput, options?: {
+    readonly signal?: AbortSignal;
+  }): Promise<PresentationResult<SecretInputValue>>;
+}
+/** Typed Presentation capabilities available to one domain invocation. */
+interface PresentationClients {
+  readonly descriptor: PresentationDescriptor;
+  readonly openExternal?: OpenExternalClient;
+  readonly copyText?: CopyTextClient;
+  readonly notification?: NotificationClient;
+  readonly interaction?: UserInteractionClient;
+  readonly externalRedirect?: ExternalRedirectClient;
+}
+interface OpenExternalHandler {
+  openExternal(request: OpenExternalRequest, context: CapabilityHandlerContext): PresentationResult<OpenExternalReceipt> | Promise<PresentationResult<OpenExternalReceipt>>;
+}
+interface CopyTextHandler {
+  copyText(request: CopyTextRequest, context: CapabilityHandlerContext): PresentationResult<CopyTextReceipt> | Promise<PresentationResult<CopyTextReceipt>>;
+}
+interface NotificationHandler {
+  notify(request: NotificationRequest, context: CapabilityHandlerContext): PresentationResult<NotificationReceipt> | Promise<PresentationResult<NotificationReceipt>>;
+}
+interface UserInteractionHandler {
+  interact(request: QuestionRequest, context: CapabilityHandlerContext): PresentationResult<QuestionAnswers> | Promise<PresentationResult<QuestionAnswers>>;
+  interact(request: ApprovalRequest, context: CapabilityHandlerContext): PresentationResult<ApprovalValue> | Promise<PresentationResult<ApprovalValue>>;
+  interact(request: SecretInputRequest, context: CapabilityHandlerContext): PresentationResult<SecretInputValue> | Promise<PresentationResult<SecretInputValue>>;
+}
+declare const openExternalProtocol: ProtocolDefinition<unknown, unknown, unknown, unknown>;
+declare const copyTextProtocol: ProtocolDefinition<unknown, unknown, unknown, unknown>;
+declare const notificationProtocol: ProtocolDefinition<unknown, unknown, unknown, unknown>;
+declare const openExternalSupport: ProtocolSupport;
+declare const copyTextSupport: ProtocolSupport;
+declare const notificationSupport: ProtocolSupport;
+declare const userInteractionSupport: (spec: UserInteractionSupportSpec) => ProtocolSupport<UserInteractionSupportSpec>;
+declare const userInteractionProtocol: ProtocolDefinition<UserInteractionRequirementSpec, UserInteractionSupportSpec>;
+declare const protocols: readonly ProtocolDefinition[];
+declare function register(catalog: ProtocolCatalog): () => void;
+declare function openExternalClient(client: CapabilityClient, scope: PresentationInvocationScope): OpenExternalClient;
+declare function copyTextClient(client: CapabilityClient, scope: PresentationInvocationScope): CopyTextClient;
+declare function notificationClient(client: CapabilityClient, scope: PresentationInvocationScope): NotificationClient;
+declare function userInteractionClient(client: CapabilityClient, scope: PresentationInvocationScope): UserInteractionClient;
+declare function presentationClients(descriptor: PresentationDescriptor, client: CapabilityClient, scope: PresentationInvocationScope): PresentationClients;
+declare function openExternalImplementation(participantId: string, handler: OpenExternalHandler): CapabilityImplementation;
+declare function copyTextImplementation(participantId: string, handler: CopyTextHandler): CapabilityImplementation;
+declare function notificationImplementation(participantId: string, handler: NotificationHandler): CapabilityImplementation;
+declare function userInteractionImplementation(participantId: string, spec: UserInteractionSupportSpec, handler: UserInteractionHandler): CapabilityImplementation;
+declare function validatePresentationDescriptor(value: unknown): asserts value is PresentationDescriptor;
+declare function validateOpenExternalRequest(value: unknown): asserts value is OpenExternalRequest;
+declare function validateCopyTextRequest(value: unknown): asserts value is CopyTextRequest;
+declare function validateNotificationRequest(value: unknown): asserts value is NotificationRequest;
+declare function validateUserInteractionRequest(value: unknown): asserts value is UserInteractionRequest;
+declare function validateUserInteractionRequirement(value: unknown): UserInteractionRequirementSpec;
+declare function validateUserInteractionSupport(value: unknown): UserInteractionSupportSpec;
+//#endregion
+//#region src/callback.d.ts
+declare const EXTERNAL_REDIRECT_KIND = "ExternalRedirect";
+interface ExternalRedirectRequest extends PresentationRequestContext {
+  readonly mode: 'http-get';
+  /** Exact loopback URI required by the external provider, including an explicit port. */
+  readonly exactRedirectUri?: string;
+}
+interface ExternalRedirectInput {
+  readonly mode?: 'http-get';
+  /** The provider must bind and announce this exact URI or report the request unavailable. */
+  readonly exactRedirectUri?: string;
+}
+interface ExternalRedirectReady {
+  readonly type: 'ready';
+  readonly redirectUri: string;
+  readonly expiresAt?: string;
+}
+interface ExternalRedirectValue {
+  readonly query: Readonly<Record<string, readonly string[]>>;
+}
+interface ExternalRedirectCall {
+  readonly invocationId: string;
+  readonly ready: Promise<ExternalRedirectReady>;
+  readonly result: Promise<PresentationResult<ExternalRedirectValue>>;
+  cancel(reason?: string): void;
+}
+interface ExternalRedirectClient {
+  receive(input?: ExternalRedirectInput, options?: {
+    readonly signal?: AbortSignal;
+  }): ExternalRedirectCall;
+}
+interface ExternalRedirectHandler {
+  receive(request: ExternalRedirectRequest, context: CapabilityHandlerContext<ExternalRedirectReady>): PresentationResult<ExternalRedirectValue> | Promise<PresentationResult<ExternalRedirectValue>>;
+}
+declare const externalRedirectProtocol: import("@dsh-std/core").ProtocolDefinition<unknown, unknown, unknown, unknown>;
+declare const externalRedirectSupport: ProtocolSupport;
+declare function externalRedirectClient(client: CapabilityClient, scope: PresentationInvocationScope): ExternalRedirectClient;
+declare function externalRedirectImplementation(participantId: string, handler: ExternalRedirectHandler): CapabilityImplementation<ExternalRedirectRequest, PresentationResult<ExternalRedirectValue>, ExternalRedirectReady>;
+declare function validateExternalRedirectRequest(value: unknown): asserts value is ExternalRedirectRequest;
+declare function validateExternalRedirectReady(value: unknown): asserts value is ExternalRedirectReady;
+declare function validateExternalRedirectResult(value: unknown): PresentationResult<ExternalRedirectValue>;
+//#endregion
+export { API_VERSION, ApprovalDetail, ApprovalInput, ApprovalRequest, ApprovalValue, COPY_TEXT_KIND, ConfirmQuestionField, CopyTextClient, CopyTextHandler, CopyTextInput, CopyTextReceipt, CopyTextRequest, EXTERNAL_REDIRECT_KIND, ExternalRedirectCall, ExternalRedirectClient, ExternalRedirectHandler, ExternalRedirectInput, ExternalRedirectReady, ExternalRedirectRequest, ExternalRedirectValue, NOTIFICATION_KIND, NotificationClient, NotificationHandler, NotificationInput, NotificationReceipt, NotificationRequest, OPEN_EXTERNAL_KIND, OpenExternalClient, OpenExternalHandler, OpenExternalInput, OpenExternalReceipt, OpenExternalRequest, PresentationClients, PresentationDescriptor, PresentationInvocationScope, PresentationRequestContext, PresentationResult, QuestionAnswers, QuestionField, QuestionInput, QuestionOption, QuestionRequest, SecretInput, SecretInputRequest, SecretInputValue, SelectQuestionField, TextQuestionField, USER_INTERACTION_KIND, UserInteractionClient, UserInteractionHandler, UserInteractionLimits, UserInteractionOperation, UserInteractionRequest, UserInteractionRequirementSpec, UserInteractionSupportSpec, UserInteractionValue, copyTextClient, copyTextImplementation, copyTextProtocol, copyTextSupport, externalRedirectClient, externalRedirectImplementation, externalRedirectProtocol, externalRedirectSupport, notificationClient, notificationImplementation, notificationProtocol, notificationSupport, openExternalClient, openExternalImplementation, openExternalProtocol, openExternalSupport, presentationClients, protocols, register, userInteractionClient, userInteractionImplementation, userInteractionProtocol, userInteractionSupport, validateCopyTextRequest, validateExternalRedirectReady, validateExternalRedirectRequest, validateExternalRedirectResult, validateNotificationRequest, validateOpenExternalRequest, validatePresentationDescriptor, validateUserInteractionRequest, validateUserInteractionRequirement, validateUserInteractionSupport };
+//# sourceMappingURL=index.d.ts.map

package/vendor/dsh-std/packages/command/node_modules/@dsh-std/presentation/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts","../src/callback.ts"],"mappings":"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"}