@mcp-abap-adt/interfaces-adt 1.0.0

package/dist/service/IAdtService.d.ts

@@ -0,0 +1,84 @@
+import type { ServiceBindingVariant } from '../adt/IAdtServiceBinding';
+export type ServiceBindingType = 'ODATA' | 'INA' | 'SQL';
+export type ServiceBindingVersion = 'V2' | 'V4' | '0001' | '0000' | string;
+export type GeneratedServiceType = 'odatav2' | 'odatav4';
+export type DesiredPublicationState = 'published' | 'unpublished' | 'unchanged';
+export interface IValidateServiceBindingParams {
+    objname: string;
+    serviceDefinition: string;
+    serviceBindingVersion?: string;
+    description?: string;
+    package?: string;
+}
+export interface IGetServiceBindingODataParams {
+    objectname: string;
+    servicename?: string;
+    serviceversion?: string;
+    srvdname?: string;
+}
+export interface IPublishODataV2Params {
+    servicename: string;
+    serviceversion?: string;
+}
+export interface IUnpublishODataV2Params {
+    servicename: string;
+    serviceversion?: string;
+}
+export interface IClassifyServiceBindingParams {
+    objectname: string;
+    bindtype?: string;
+    bindtypeversion?: string;
+    repositoryid?: string;
+    servicename?: string;
+    serviceversion?: string;
+}
+export interface ITransportCheckServiceBindingParams {
+    objectName: string;
+    packageName: string;
+    description?: string;
+    operation?: 'I' | 'U' | 'D';
+}
+export interface ICreateServiceBindingParams {
+    bindingName: string;
+    packageName: string;
+    description: string;
+    serviceDefinitionName: string;
+    serviceName: string;
+    serviceVersion: string;
+    bindingVariant: ServiceBindingVariant;
+    masterLanguage?: string;
+    masterSystem?: string;
+    responsible?: string;
+    transportRequest?: string;
+    runTransportCheck?: boolean;
+    activateAfterCreate?: boolean;
+}
+export interface IReadServiceBindingParams {
+    bindingName: string;
+    version?: 'active' | 'inactive';
+}
+export interface IUpdateServiceBindingParams {
+    bindingName: string;
+    desiredPublicationState: DesiredPublicationState;
+    serviceType: GeneratedServiceType;
+    serviceName: string;
+    serviceVersion?: string;
+}
+export interface ICheckServiceBindingParams {
+    bindingName: string;
+    version?: 'active' | 'inactive';
+}
+export interface IActivateServiceBindingParams {
+    bindingName: string;
+    preauditRequested?: boolean;
+}
+export interface IGenerateServiceBindingParams {
+    serviceType: GeneratedServiceType;
+    bindingName: string;
+    serviceName: string;
+    serviceVersion: string;
+    serviceDefinitionName: string;
+}
+export type ICreateAndGenerateServiceBindingParams = ICreateServiceBindingParams;
+export type ICreateAndGenerateServiceBindingParamsLegacy = ICreateAndGenerateServiceBindingParams;
+//# sourceMappingURL=IAdtService.d.ts.map

package/dist/service/IAdtService.d.ts.map

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

package/dist/service/IAdtService.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/*
+ * `IServiceBindingResults` was here — the readings keyed for the aggregate that
+ * has just gone. Nothing parameterises anything any more, so it named five
+ * answers nobody asks for. A consumer's readings are their own, and the atoms
+ * take them one at a time.
+ */
+/*
+ * `IAdtServiceBinding` was here: a per-object aggregate declaring eight members.
+ *
+ * It is gone, and it is the last of its kind — no other object type ever had
+ * one. It arrived in `bd5926f` with a one-line message and no reasoning, and
+ * 31.0.0 did not reach it: that sweep took out result *shapes*, and a
+ * method-bearing interface was not in its scope. So it was never kept on
+ * purpose; it was never looked at.
+ *
+ * Four of its members no longer exist in any implementation —
+ * `getODataV2ServiceBinding`, `getODataV4ServiceBinding`, `publishODataV2` and
+ * `unpublishODataV2` — because a protocol is a parameter, not a method name.
+ * The other four are a chain step exposed to callers, two operations glued into
+ * one by an `And` in the name, and two members nothing calls.
+ *
+ * What a consumer needs to *call* a binding stayed: every parameter type above,
+ * and the capability atoms, which compose. What an implementation hands back is
+ * its own business, and a consumer names it structurally from the atoms.
+ */

package/dist/serviceKey/IServiceKeyStore.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Interface for storing and retrieving service keys
+ *
+ * Service keys contain UAA credentials and connection URLs.
+ */
+import type { IAuthorizationConfig } from '../auth/IAuthorizationConfig';
+import type { IConfig } from '../auth/IConfig';
+import type { IConnectionConfig } from '../auth/IConnectionConfig';
+export interface IServiceKeyStore {
+    /**
+     * Get raw service key for destination
+     * @param destination Destination name (e.g., "TRIAL")
+     * @returns Service key object (implementation-specific) or null if not found
+     */
+    getServiceKey(destination: string): Promise<IConfig | null>;
+    /**
+     * Get authorization configuration from service key
+     * Returns values needed for obtaining and refreshing tokens
+     * @param destination Destination name (e.g., "TRIAL")
+     * @returns IAuthorizationConfig with actual values or null if not found
+     */
+    getAuthorizationConfig(destination: string): Promise<IAuthorizationConfig | null>;
+    /**
+     * Get connection configuration from service key
+     * Returns values needed for connecting to services
+     * @param destination Destination name (e.g., "TRIAL")
+     * @returns IConnectionConfig with actual values or null if not found
+     */
+    getConnectionConfig(destination: string): Promise<IConnectionConfig | null>;
+}
+//# sourceMappingURL=IServiceKeyStore.d.ts.map

package/dist/serviceKey/IServiceKeyStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IServiceKeyStore.d.ts","sourceRoot":"","sources":["../../src/serviceKey/IServiceKeyStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE5D;;;;;OAKG;IACH,sBAAsB,CACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAExC;;;;;OAKG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CAC7E"}

package/dist/serviceKey/IServiceKeyStore.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Interface for storing and retrieving service keys
+ *
+ * Service keys contain UAA credentials and connection URLs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/session/ISessionStore.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Interface for session stores - stores and retrieves session data
+ *
+ * Session stores handle loading, saving, and managing session data (tokens, configuration).
+ */
+import type { IAuthorizationConfig } from '../auth/IAuthorizationConfig';
+import type { IConfig } from '../auth/IConfig';
+import type { IConnectionConfig } from '../auth/IConnectionConfig';
+export interface ISessionStore {
+    /**
+     * Load session configuration for destination
+     * Returns optional composition of IAuthorizationConfig and IConnectionConfig
+     * Can contain either authorization config, or connection config, or both
+     * @param destination Destination name (e.g., "TRIAL" or "mcp")
+     * @returns IConfig with actual values or null if not found
+     */
+    loadSession(destination: string): Promise<IConfig | null>;
+    /**
+     * Save session configuration for destination
+     * Accepts IConfig (optional composition) or internal representation (for backward compatibility)
+     * @param destination Destination name (e.g., "TRIAL" or "mcp")
+     * @param config IConfig or internal session configuration to save
+     */
+    saveSession(destination: string, config: IConfig | unknown): Promise<void>;
+    /**
+     * Delete session for destination (optional)
+     * @param destination Destination name (e.g., "TRIAL" or "mcp")
+     */
+    deleteSession?(destination: string): Promise<void>;
+    /**
+     * Get authorization configuration with actual values (not file paths)
+     * Returns values needed for obtaining and refreshing tokens
+     * @param destination Destination name (e.g., "TRIAL" or "mcp")
+     * @returns IAuthorizationConfig with actual values or null if not found
+     */
+    getAuthorizationConfig(destination: string): Promise<IAuthorizationConfig | null>;
+    /**
+     * Get connection configuration with actual values (not file paths)
+     * Returns values needed for connecting to services
+     * @param destination Destination name (e.g., "TRIAL" or "mcp")
+     * @returns IConnectionConfig with actual values or null if not found
+     */
+    getConnectionConfig(destination: string): Promise<IConnectionConfig | null>;
+    /**
+     * Set authorization configuration
+     * Updates values needed for obtaining and refreshing tokens
+     * @param destination Destination name (e.g., "TRIAL" or "mcp")
+     * @param config IAuthorizationConfig with values to set
+     */
+    setAuthorizationConfig(destination: string, config: IAuthorizationConfig): Promise<void>;
+    /**
+     * Set connection configuration
+     * Updates values needed for connecting to services
+     * @param destination Destination name (e.g., "TRIAL" or "mcp")
+     * @param config IConnectionConfig with values to set
+     */
+    setConnectionConfig(destination: string, config: IConnectionConfig): Promise<void>;
+}
+//# sourceMappingURL=ISessionStore.d.ts.map

package/dist/session/ISessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISessionStore.d.ts","sourceRoot":"","sources":["../../src/session/ISessionStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E;;;OAGG;IACH,aAAa,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,sBAAsB,CACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAExC;;;;;OAKG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAE5E;;;;;OAKG;IACH,sBAAsB,CACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,mBAAmB,CACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/dist/session/ISessionStore.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Interface for session stores - stores and retrieves session data
+ *
+ * Session stores handle loading, saving, and managing session data (tokens, configuration).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/shared/IReadOptions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared read options for ADT source/metadata operations
+ */
+export interface IReadOptions {
+    withLongPolling?: boolean;
+    accept?: string;
+    version?: 'active' | 'inactive';
+}
+//# sourceMappingURL=IReadOptions.d.ts.map

package/dist/shared/IReadOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IReadOptions.d.ts","sourceRoot":"","sources":["../../src/shared/IReadOptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACjC"}

package/dist/shared/IReadOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/store/StoreErrorCodes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Error codes for store operations
+ * Used by auth-stores package to provide typed errors to auth-broker
+ */
+export declare const STORE_ERROR_CODES: {
+    readonly FILE_NOT_FOUND: "FILE_NOT_FOUND";
+    readonly PARSE_ERROR: "PARSE_ERROR";
+    readonly INVALID_CONFIG: "INVALID_CONFIG";
+    readonly STORAGE_ERROR: "STORAGE_ERROR";
+};
+export type StoreErrorCode = (typeof STORE_ERROR_CODES)[keyof typeof STORE_ERROR_CODES];
+//# sourceMappingURL=StoreErrorCodes.d.ts.map

package/dist/store/StoreErrorCodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoreErrorCodes.d.ts","sourceRoot":"","sources":["../../src/store/StoreErrorCodes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/store/StoreErrorCodes.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Error codes for store operations
+ * Used by auth-stores package to provide typed errors to auth-broker
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORE_ERROR_CODES = void 0;
+exports.STORE_ERROR_CODES = {
+    FILE_NOT_FOUND: 'FILE_NOT_FOUND',
+    PARSE_ERROR: 'PARSE_ERROR',
+    INVALID_CONFIG: 'INVALID_CONFIG',
+    STORAGE_ERROR: 'STORAGE_ERROR',
+};

package/dist/token/AuthType.d.ts

@@ -0,0 +1,43 @@
+/**
+ * OAuth2 Grant Types
+ *
+ * Constants for different OAuth2 authentication flows (grant types)
+ */
+/**
+ * Authorization Code grant type
+ * Standard OAuth2 flow with browser-based authorization
+ */
+export declare const AUTH_TYPE_AUTHORIZATION_CODE: "authorization_code";
+/**
+ * Authorization Code with PKCE grant type
+ * More secure variant for public clients
+ */
+export declare const AUTH_TYPE_AUTHORIZATION_CODE_PKCE: "authorization_code_pkce";
+/**
+ * Password Credentials grant type
+ * Direct username/password authentication
+ */
+export declare const AUTH_TYPE_PASSWORD: "password";
+/**
+ * Client Credentials grant type
+ * Service-to-service authentication
+ */
+export declare const AUTH_TYPE_CLIENT_CREDENTIALS: "client_credentials";
+/**
+ * User token passthrough (external token)
+ */
+export declare const AUTH_TYPE_USER_TOKEN: "user_token";
+/**
+ * Client X509 (mTLS) authentication
+ */
+export declare const AUTH_TYPE_CLIENT_X509: "client_x509";
+/**
+ * SAML 2.0 Bearer Assertion grant type
+ * Used to exchange SAML assertions for OAuth2 access tokens
+ */
+export declare const AUTH_TYPE_SAML2_BEARER: "saml2_bearer";
+/**
+ * Union type for all OAuth2 grant types
+ */
+export type OAuth2GrantType = typeof AUTH_TYPE_AUTHORIZATION_CODE | typeof AUTH_TYPE_AUTHORIZATION_CODE_PKCE | typeof AUTH_TYPE_PASSWORD | typeof AUTH_TYPE_CLIENT_CREDENTIALS | typeof AUTH_TYPE_USER_TOKEN | typeof AUTH_TYPE_CLIENT_X509 | typeof AUTH_TYPE_SAML2_BEARER;
+//# sourceMappingURL=AuthType.d.ts.map

package/dist/token/AuthType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthType.d.ts","sourceRoot":"","sources":["../../src/token/AuthType.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAG,oBAA6B,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,iCAAiC,EAC5C,yBAAkC,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAG,UAAmB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAG,oBAA6B,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAG,YAAqB,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAG,aAAsB,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAG,cAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,4BAA4B,GACnC,OAAO,iCAAiC,GACxC,OAAO,kBAAkB,GACzB,OAAO,4BAA4B,GACnC,OAAO,oBAAoB,GAC3B,OAAO,qBAAqB,GAC5B,OAAO,sBAAsB,CAAC"}

package/dist/token/AuthType.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * OAuth2 Grant Types
+ *
+ * Constants for different OAuth2 authentication flows (grant types)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTH_TYPE_SAML2_BEARER = exports.AUTH_TYPE_CLIENT_X509 = exports.AUTH_TYPE_USER_TOKEN = exports.AUTH_TYPE_CLIENT_CREDENTIALS = exports.AUTH_TYPE_PASSWORD = exports.AUTH_TYPE_AUTHORIZATION_CODE_PKCE = exports.AUTH_TYPE_AUTHORIZATION_CODE = void 0;
+/**
+ * Authorization Code grant type
+ * Standard OAuth2 flow with browser-based authorization
+ */
+exports.AUTH_TYPE_AUTHORIZATION_CODE = 'authorization_code';
+/**
+ * Authorization Code with PKCE grant type
+ * More secure variant for public clients
+ */
+exports.AUTH_TYPE_AUTHORIZATION_CODE_PKCE = 'authorization_code_pkce';
+/**
+ * Password Credentials grant type
+ * Direct username/password authentication
+ */
+exports.AUTH_TYPE_PASSWORD = 'password';
+/**
+ * Client Credentials grant type
+ * Service-to-service authentication
+ */
+exports.AUTH_TYPE_CLIENT_CREDENTIALS = 'client_credentials';
+/**
+ * User token passthrough (external token)
+ */
+exports.AUTH_TYPE_USER_TOKEN = 'user_token';
+/**
+ * Client X509 (mTLS) authentication
+ */
+exports.AUTH_TYPE_CLIENT_X509 = 'client_x509';
+/**
+ * SAML 2.0 Bearer Assertion grant type
+ * Used to exchange SAML assertions for OAuth2 access tokens
+ */
+exports.AUTH_TYPE_SAML2_BEARER = 'saml2_bearer';

package/dist/token/ITokenProvider.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Token Provider interface
+ *
+ * Stateful providers that manage token lifecycle internally.
+ * The provider validates, refreshes, or re-authenticates as needed.
+ */
+import type { ITokenResult } from './ITokenResult';
+/**
+ * Interface for token providers (stateful)
+ */
+export interface ITokenProvider {
+    /**
+     * Get tokens with automatic refresh/relogin logic
+     *
+     * Stateful providers cache tokens internally and handle refresh automatically.
+     * Checks token expiration, refreshes if needed, or triggers login.
+     */
+    getTokens(): Promise<ITokenResult>;
+    /**
+     * Validate JWT token locally (optional)
+     * @param token JWT token to validate
+     * @param serviceUrl Service URL (optional, for services that require URL validation)
+     * @returns Promise that resolves to true if token is valid, false otherwise
+     */
+    validateToken?(token: string, serviceUrl?: string): Promise<boolean>;
+}
+//# sourceMappingURL=ITokenProvider.d.ts.map

package/dist/token/ITokenProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITokenProvider.d.ts","sourceRoot":"","sources":["../../src/token/ITokenProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtE"}

package/dist/token/ITokenProvider.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Token Provider interface
+ *
+ * Stateful providers that manage token lifecycle internally.
+ * The provider validates, refreshes, or re-authenticates as needed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/token/ITokenProviderOptions.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Options for token providers
+ *
+ * Used by ITokenProvider implementations to configure token acquisition behavior.
+ * All options are optional, allowing providers to use sensible defaults.
+ */
+import type { ILogger } from '@mcp-abap-adt/interfaces-utils';
+export interface ITokenProviderOptions {
+    /**
+     * Browser type for browser-based authentication
+     * Supported values: "chrome", "edge", "firefox", "system" (default), "none", "headless"
+     * - "system": Uses system default browser (default)
+     * - "headless": Does not open browser, logs URL and waits for manual callback (for SSH/remote sessions)
+     * - "none": Does not open browser, immediately rejects with error (for automated tests)
+     */
+    browser?: string;
+    /**
+     * Logger instance for logging token provider operations
+     * Uses ILogger interface to allow any logger implementation
+     */
+    logger?: ILogger;
+}
+//# sourceMappingURL=ITokenProviderOptions.d.ts.map

package/dist/token/ITokenProviderOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITokenProviderOptions.d.ts","sourceRoot":"","sources":["../../src/token/ITokenProviderOptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/token/ITokenProviderOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/token/ITokenRefresher.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Token Refresher interface
+ *
+ * Provides token management with automatic refresh capability.
+ * Implementations are created by AuthBroker and injected into connections.
+ *
+ * This enables dependency injection of token refresh logic into connections,
+ * allowing connections to focus on making requests while the refresher
+ * handles all auth/token lifecycle concerns.
+ */
+/**
+ * Interface for token refresher
+ *
+ * Created by AuthBroker for a specific destination.
+ * Injected into JwtAbapConnection to enable automatic token refresh.
+ */
+export interface ITokenRefresher {
+    /**
+     * Get current valid token.
+     *
+     * May return cached token if still valid, or refresh if expired.
+     * Implementation decides when to refresh based on token expiration.
+     *
+     * @returns Promise that resolves to valid JWT token
+     */
+    getToken(): Promise<string>;
+    /**
+     * Force refresh token.
+     *
+     * Always obtains new token from provider, regardless of current token validity.
+     * Saves new token to session store (cache).
+     *
+     * Use this when getToken() returned a token that was rejected by server (401/403).
+     *
+     * @returns Promise that resolves to new JWT token
+     */
+    refreshToken(): Promise<string>;
+}
+//# sourceMappingURL=ITokenRefresher.d.ts.map

package/dist/token/ITokenRefresher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITokenRefresher.d.ts","sourceRoot":"","sources":["../../src/token/ITokenRefresher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5B;;;;;;;;;OASG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC"}

package/dist/token/ITokenRefresher.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Token Refresher interface
+ *
+ * Provides token management with automatic refresh capability.
+ * Implementations are created by AuthBroker and injected into connections.
+ *
+ * This enables dependency injection of token refresh logic into connections,
+ * allowing connections to focus on making requests while the refresher
+ * handles all auth/token lifecycle concerns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/token/ITokenResult.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Token result interface
+ *
+ * Result returned by ITokenProvider.getTokens() method
+ */
+import type { OAuth2GrantType } from './AuthType';
+export interface ITokenResult {
+    /**
+     * Authorization token (access token)
+     */
+    authorizationToken: string;
+    /**
+     * Refresh token (optional, not all grant types provide it)
+     */
+    refreshToken?: string;
+    /**
+     * Authentication type (OAuth2 grant type used)
+     */
+    authType: OAuth2GrantType;
+    /**
+     * Token expiration time in seconds
+     * If not provided, token expiration is determined from JWT exp claim
+     */
+    expiresIn?: number;
+    /**
+     * Token expiration time as absolute timestamp (milliseconds since epoch)
+     * Useful for non-JWT tokens (e.g. SAML assertions).
+     */
+    expiresAt?: number;
+    /**
+     * Token format/type (helps consumers decide how to validate or parse).
+     * If omitted, defaults to JWT assumptions.
+     */
+    tokenType?: 'jwt' | 'saml' | 'opaque';
+}
+//# sourceMappingURL=ITokenResult.d.ts.map

package/dist/token/ITokenResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITokenResult.d.ts","sourceRoot":"","sources":["../../src/token/ITokenResult.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;CACvC"}

package/dist/token/ITokenResult.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Token result interface
+ *
+ * Result returned by ITokenProvider.getTokens() method
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/token/TokenProviderErrorCodes.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Token Provider Error Codes
+ *
+ * Constants for error codes that token providers can throw.
+ * Used to enable better error handling and categorization.
+ */
+/**
+ * Error codes for token provider operations
+ */
+export declare const TOKEN_PROVIDER_ERROR_CODES: {
+    /** Authentication configuration validation failed */
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    /** Token refresh operation failed */
+    readonly REFRESH_ERROR: "REFRESH_ERROR";
+    /** Session data is invalid or incomplete */
+    readonly SESSION_DATA_ERROR: "SESSION_DATA_ERROR";
+    /** Service key data is invalid or incomplete */
+    readonly SERVICE_KEY_ERROR: "SERVICE_KEY_ERROR";
+    /** Browser authentication failed or was cancelled */
+    readonly BROWSER_AUTH_ERROR: "BROWSER_AUTH_ERROR";
+};
+/**
+ * Type for token provider error codes
+ */
+export type TokenProviderErrorCode = (typeof TOKEN_PROVIDER_ERROR_CODES)[keyof typeof TOKEN_PROVIDER_ERROR_CODES];
+//# sourceMappingURL=TokenProviderErrorCodes.d.ts.map

package/dist/token/TokenProviderErrorCodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenProviderErrorCodes.d.ts","sourceRoot":"","sources":["../../src/token/TokenProviderErrorCodes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B;IACrC,qDAAqD;;IAErD,qCAAqC;;IAErC,4CAA4C;;IAE5C,gDAAgD;;IAEhD,qDAAqD;;CAE7C,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/token/TokenProviderErrorCodes.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Token Provider Error Codes
+ *
+ * Constants for error codes that token providers can throw.
+ * Used to enable better error handling and categorization.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOKEN_PROVIDER_ERROR_CODES = void 0;
+/**
+ * Error codes for token provider operations
+ */
+exports.TOKEN_PROVIDER_ERROR_CODES = {
+    /** Authentication configuration validation failed */
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    /** Token refresh operation failed */
+    REFRESH_ERROR: 'REFRESH_ERROR',
+    /** Session data is invalid or incomplete */
+    SESSION_DATA_ERROR: 'SESSION_DATA_ERROR',
+    /** Service key data is invalid or incomplete */
+    SERVICE_KEY_ERROR: 'SERVICE_KEY_ERROR',
+    /** Browser authentication failed or was cancelled */
+    BROWSER_AUTH_ERROR: 'BROWSER_AUTH_ERROR',
+};

package/dist/utils/ITokenRefreshResult.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Token refresh result
+ */
+export interface ITokenRefreshResult {
+    accessToken: string;
+    refreshToken?: string;
+}
+//# sourceMappingURL=ITokenRefreshResult.d.ts.map

package/dist/utils/ITokenRefreshResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITokenRefreshResult.d.ts","sourceRoot":"","sources":["../../src/utils/ITokenRefreshResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/utils/ITokenRefreshResult.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/validation/IHeaderValidationResult.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Header validation result
+ */
+import type { IValidatedAuthConfig } from './IValidatedAuthConfig';
+export interface IHeaderValidationResult {
+    /** Is configuration valid? */
+    isValid: boolean;
+    /** Validated authentication configuration */
+    config?: IValidatedAuthConfig;
+    /** Validation errors */
+    errors: string[];
+    /** Warnings */
+    warnings: string[];
+}
+//# sourceMappingURL=IHeaderValidationResult.d.ts.map