catalyst-relay 0.4.5 → 0.5.0

package/dist/index.d.mts

@@ -91,6 +91,31 @@ interface ClientConfig {
     autoRefresh?: AutoRefreshConfig;
 }
 
+/**
+ * Result type for error handling (Go-style tuples)
+ *
+ * Usage:
+ * const [data, error] = await someFunction();
+ * if (error) {
+ *     console.error(error);
+ *     return;
+ * }
+ * // data is guaranteed non-null
+ */
+type Result<T, E extends Error = Error> = [T, null] | [null, E];
+/**
+ * Async result type alias for convenience
+ */
+type AsyncResult<T, E extends Error = Error> = Promise<Result<T, E>>;
+/**
+ * Create a success result
+ */
+declare function ok<T>(value: T): Result<T, never>;
+/**
+ * Create an error result
+ */
+declare function err<E extends Error = Error>(error: E): Result<never, E>;
+
 /**
  * Reference to an SAP development object
  */
@@ -159,31 +184,6 @@ type ApiResponse<T> = SuccessResponse<T> | ErrorResponse;
  */
 type ErrorCode = 'AUTH_FAILED' | 'SESSION_EXPIRED' | 'SESSION_NOT_FOUND' | 'CSRF_INVALID' | 'OBJECT_LOCKED' | 'OBJECT_NOT_FOUND' | 'TRANSPORT_REQUIRED' | 'ACTIVATION_FAILED' | 'VALIDATION_ERROR' | 'NETWORK_ERROR' | 'UNKNOWN_ERROR';
 
-/**
- * Result type for error handling (Go-style tuples)
- *
- * Usage:
- * const [data, error] = await someFunction();
- * if (error) {
- *     console.error(error);
- *     return;
- * }
- * // data is guaranteed non-null
- */
-type Result<T, E extends Error = Error> = [T, null] | [null, E];
-/**
- * Async result type alias for convenience
- */
-type AsyncResult<T, E extends Error = Error> = Promise<Result<T, E>>;
-/**
- * Create a success result
- */
-declare function ok<T>(value: T): Result<T, never>;
-/**
- * Create an error result
- */
-declare function err<E extends Error = Error>(error: E): Result<never, E>;
-
 /**
  * Session management type definitions
  */
@@ -199,6 +199,25 @@ interface Session {
     /** Session expiration timestamp */
     expiresAt: number;
 }
+/**
+ * Serializable session state for export/import across processes
+ *
+ * Used to transfer authenticated session state from daemon to CLI processes,
+ * allowing session reuse without re-authentication.
+ */
+interface ExportableSessionState {
+    csrfToken: string;
+    session: Session;
+    cookies: Array<{
+        name: string;
+        value: string;
+    }>;
+    authType: AuthType;
+    ssoCertPaths?: {
+        fullChainPath: string;
+        keyPath: string;
+    };
+}
 
 /**
  * Session Refresh via Reentrance Ticket
@@ -517,6 +536,8 @@ interface ADTClient {
     login(): AsyncResult<Session>;
     logout(): AsyncResult<void>;
     refreshSession(): AsyncResult<RefreshResult>;
+    exportSessionState(): ExportableSessionState | null;
+    importSessionState(state: ExportableSessionState): AsyncResult<boolean>;
     read(objects: ObjectRef[]): AsyncResult<ObjectWithContent[]>;
     create(object: ObjectContent, packageName: string, transport?: string): AsyncResult<void>;
     update(object: ObjectContent, transport?: string): AsyncResult<void>;
@@ -537,6 +558,13 @@ interface ADTClient {
     gitDiff(objects: ObjectContent[]): AsyncResult<DiffResult[]>;
     getObjectConfig(): ObjectConfig[];
 }
+
+/**
+ * ADT Client Module
+ *
+ * Exports the ADTClient interface and createClient factory function.
+ */
+
 declare function createClient(config: ClientConfig): Result<ADTClient, Error>;
 
-export { type ADTClient, type ActivationMessage, type ActivationResult, type Aggregation, type ApiResponse, type AsyncResult, type AuthConfig, type AuthType, type BasicAuthConfig, type BasicFilter, type BetweenFilter, type ClientConfig, type ColumnInfo, type DataFrame, type DataPreviewQuery, type Dependency, type DiffResult, type DistinctResult, type ErrorCode, type ErrorResponse, type FolderNode, type ListFilter, type ObjectConfig, type ObjectContent, type ObjectMetadata, type ObjectNode, type ObjectRef, type ObjectWithContent, type Package, type PackageNode, type Parameter, type PreviewSQL, type QueryFilter, type Result, type SamlAuthConfig, type SearchResult, type Session, type Sorting, type SsoAuthConfig, type SuccessResponse, type Transport, type TransportConfig, type TreeQuery, type TreeResponse, type UpsertResult, buildSQLQuery, createClient, err, ok };
+export { type ADTClient, type ActivationMessage, type ActivationResult, type Aggregation, type ApiResponse, type AsyncResult, type AuthConfig, type AuthType, type BasicAuthConfig, type BasicFilter, type BetweenFilter, type ClientConfig, type ColumnInfo, type DataFrame, type DataPreviewQuery, type Dependency, type DiffResult, type DistinctResult, type ErrorCode, type ErrorResponse, type ExportableSessionState, type FolderNode, type ListFilter, type ObjectConfig, type ObjectContent, type ObjectMetadata, type ObjectNode, type ObjectRef, type ObjectWithContent, type Package, type PackageNode, type Parameter, type PreviewSQL, type QueryFilter, type Result, type SamlAuthConfig, type SearchResult, type Session, type Sorting, type SsoAuthConfig, type SuccessResponse, type Transport, type TransportConfig, type TreeQuery, type TreeResponse, type UpsertResult, buildSQLQuery, createClient, err, ok };

package/dist/index.d.ts

@@ -91,6 +91,31 @@ interface ClientConfig {
     autoRefresh?: AutoRefreshConfig;
 }
 
+/**
+ * Result type for error handling (Go-style tuples)
+ *
+ * Usage:
+ * const [data, error] = await someFunction();
+ * if (error) {
+ *     console.error(error);
+ *     return;
+ * }
+ * // data is guaranteed non-null
+ */
+type Result<T, E extends Error = Error> = [T, null] | [null, E];
+/**
+ * Async result type alias for convenience
+ */
+type AsyncResult<T, E extends Error = Error> = Promise<Result<T, E>>;
+/**
+ * Create a success result
+ */
+declare function ok<T>(value: T): Result<T, never>;
+/**
+ * Create an error result
+ */
+declare function err<E extends Error = Error>(error: E): Result<never, E>;
+
 /**
  * Reference to an SAP development object
  */
@@ -159,31 +184,6 @@ type ApiResponse<T> = SuccessResponse<T> | ErrorResponse;
  */
 type ErrorCode = 'AUTH_FAILED' | 'SESSION_EXPIRED' | 'SESSION_NOT_FOUND' | 'CSRF_INVALID' | 'OBJECT_LOCKED' | 'OBJECT_NOT_FOUND' | 'TRANSPORT_REQUIRED' | 'ACTIVATION_FAILED' | 'VALIDATION_ERROR' | 'NETWORK_ERROR' | 'UNKNOWN_ERROR';
 
-/**
- * Result type for error handling (Go-style tuples)
- *
- * Usage:
- * const [data, error] = await someFunction();
- * if (error) {
- *     console.error(error);
- *     return;
- * }
- * // data is guaranteed non-null
- */
-type Result<T, E extends Error = Error> = [T, null] | [null, E];
-/**
- * Async result type alias for convenience
- */
-type AsyncResult<T, E extends Error = Error> = Promise<Result<T, E>>;
-/**
- * Create a success result
- */
-declare function ok<T>(value: T): Result<T, never>;
-/**
- * Create an error result
- */
-declare function err<E extends Error = Error>(error: E): Result<never, E>;
-
 /**
  * Session management type definitions
  */
@@ -199,6 +199,25 @@ interface Session {
     /** Session expiration timestamp */
     expiresAt: number;
 }
+/**
+ * Serializable session state for export/import across processes
+ *
+ * Used to transfer authenticated session state from daemon to CLI processes,
+ * allowing session reuse without re-authentication.
+ */
+interface ExportableSessionState {
+    csrfToken: string;
+    session: Session;
+    cookies: Array<{
+        name: string;
+        value: string;
+    }>;
+    authType: AuthType;
+    ssoCertPaths?: {
+        fullChainPath: string;
+        keyPath: string;
+    };
+}
 
 /**
  * Session Refresh via Reentrance Ticket
@@ -517,6 +536,8 @@ interface ADTClient {
     login(): AsyncResult<Session>;
     logout(): AsyncResult<void>;
     refreshSession(): AsyncResult<RefreshResult>;
+    exportSessionState(): ExportableSessionState | null;
+    importSessionState(state: ExportableSessionState): AsyncResult<boolean>;
     read(objects: ObjectRef[]): AsyncResult<ObjectWithContent[]>;
     create(object: ObjectContent, packageName: string, transport?: string): AsyncResult<void>;
     update(object: ObjectContent, transport?: string): AsyncResult<void>;
@@ -537,6 +558,13 @@ interface ADTClient {
     gitDiff(objects: ObjectContent[]): AsyncResult<DiffResult[]>;
     getObjectConfig(): ObjectConfig[];
 }
+
+/**
+ * ADT Client Module
+ *
+ * Exports the ADTClient interface and createClient factory function.
+ */
+
 declare function createClient(config: ClientConfig): Result<ADTClient, Error>;
 
-export { type ADTClient, type ActivationMessage, type ActivationResult, type Aggregation, type ApiResponse, type AsyncResult, type AuthConfig, type AuthType, type BasicAuthConfig, type BasicFilter, type BetweenFilter, type ClientConfig, type ColumnInfo, type DataFrame, type DataPreviewQuery, type Dependency, type DiffResult, type DistinctResult, type ErrorCode, type ErrorResponse, type FolderNode, type ListFilter, type ObjectConfig, type ObjectContent, type ObjectMetadata, type ObjectNode, type ObjectRef, type ObjectWithContent, type Package, type PackageNode, type Parameter, type PreviewSQL, type QueryFilter, type Result, type SamlAuthConfig, type SearchResult, type Session, type Sorting, type SsoAuthConfig, type SuccessResponse, type Transport, type TransportConfig, type TreeQuery, type TreeResponse, type UpsertResult, buildSQLQuery, createClient, err, ok };
+export { type ADTClient, type ActivationMessage, type ActivationResult, type Aggregation, type ApiResponse, type AsyncResult, type AuthConfig, type AuthType, type BasicAuthConfig, type BasicFilter, type BetweenFilter, type ClientConfig, type ColumnInfo, type DataFrame, type DataPreviewQuery, type Dependency, type DiffResult, type DistinctResult, type ErrorCode, type ErrorResponse, type ExportableSessionState, type FolderNode, type ListFilter, type ObjectConfig, type ObjectContent, type ObjectMetadata, type ObjectNode, type ObjectRef, type ObjectWithContent, type Package, type PackageNode, type Parameter, type PreviewSQL, type QueryFilter, type Result, type SamlAuthConfig, type SearchResult, type Session, type Sorting, type SsoAuthConfig, type SuccessResponse, type Transport, type TransportConfig, type TreeQuery, type TreeResponse, type UpsertResult, buildSQLQuery, createClient, err, ok };