@computec/uibase 1.0.8 → 1.0.10

package/dist-amd/models/interfaces/IAppEngineException.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Interface for AppEngine-specific exceptions that provide structured error information.
+ * This interface defines the contract for exceptions thrown by the AppEngine system,
+ * following the RFC 7807 Problem Details specification with Title and Detail properties.
+ *
+ * AppEngineExceptions are typically used for business logic errors, validation failures,
+ * and other application-specific error conditions that need to be communicated to the UI
+ * with clear, user-friendly information.
+ *
+ * This interface is designed to work with C# backend services that implement
+ * the ProblemDetails standard for consistent error reporting across the application.
+ *
+ * @example
+ * ```typescript
+ * const exception: IAppEngineException = {
+ *   Title: "Validation Error",
+ *   Detail: "The provided email address is not in a valid format"
+ * };
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Business logic error
+ * const businessError: IAppEngineException = {
+ *   Title: "Operation Not Allowed",
+ *   Detail: "Cannot delete a customer that has active orders"
+ * };
+ * ```
+ */
+export default interface IAppEngineException {
+    /**
+     * A short, human-readable summary of the problem.
+     * This should be a brief title that describes the general nature of the error
+     * without including instance-specific details.
+     *
+     * The title should be suitable for display in error dialogs, notifications,
+     * or as a heading for more detailed error information.
+     *
+     * @example "Validation Error", "Authorization Failed", "Resource Not Found"
+     * @example "Operation Not Allowed", "Configuration Error", "Service Unavailable"
+     */
+    Title: string;
+    /**
+     * A human-readable explanation specific to this occurrence of the problem.
+     * This should provide detailed information about what went wrong and,
+     * when possible, guidance on how to resolve the issue.
+     *
+     * The detail should be informative enough for users or developers to understand
+     * the specific error condition and take appropriate action.
+     *
+     * @example "The email field must contain a valid email address format"
+     * @example "You do not have permission to access this resource. Please contact your administrator."
+     * @example "The customer cannot be deleted because they have 3 active orders. Please cancel or complete the orders first."
+     */
+    Detail: string;
+}
+//# sourceMappingURL=IAppEngineException.d.ts.map

package/dist-amd/models/interfaces/IAppEngineException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAppEngineException.d.ts","sourceRoot":"","sources":["../../../src/models/interfaces/IAppEngineException.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,OAAO,WAAW,mBAAmB;IAC3C;;;;;;;;;;OAUG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;;OAWG;IACH,MAAM,EAAE,MAAM,CAAC;CACf"}

package/dist-amd/models/interfaces/IAppEngineException.js

@@ -0,0 +1,4 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/dist-amd/models/interfaces/IDocumentedException.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Interface for AppEngine-specific exceptions that provide structured error information.
+ * This interface defines the contract for exceptions thrown by the AppEngine system,
+ * following the RFC 7807 Problem Details specification with Title and Detail properties.
+ *
+ * AppEngineExceptions are typically used for business logic errors, validation failures,
+ * and other application-specific error conditions that need to be communicated to the UI
+ * with clear, user-friendly information.
+ *
+ * This interface is designed to work with C# backend services that implement
+ * the ProblemDetails standard for consistent error reporting across the application.
+ *
+ * @example
+ * ```typescript
+ * const exception: IAppEngineException = {
+ *   title: "Validation Error",
+ *   detail: "The provided email address is not in a valid format",
+ *   documentationUrl: "https://learn.computec.one"
+ * };
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Business logic error
+ * const businessError: IAppEngineException = {
+ *   title: "Operation Not Allowed",
+ *   detail: "Cannot delete a customer that has active orders",
+ *   documentationUrl: "https://learn.computec.one"
+ * };
+ * ```
+ */
+export default interface IDocumentedException {
+    /**
+     * A short, human-readable summary of the problem.
+     * This should be a brief title that describes the general nature of the error
+     * without including instance-specific details.
+     *
+     * The title should be suitable for display in error dialogs, notifications,
+     * or as a heading for more detailed error information.
+     *
+     * @example "Validation Error", "Authorization Failed", "Resource Not Found"
+     * @example "Operation Not Allowed", "Configuration Error", "Service Unavailable"
+     */
+    title: string;
+    /**
+     * A human-readable explanation specific to this occurrence of the problem.
+     * This should provide detailed information about what went wrong and,
+     * when possible, guidance on how to resolve the issue.
+     *
+     * The detail should be informative enough for users or developers to understand
+     * the specific error condition and take appropriate action.
+     *
+     * @example "The email field must contain a valid email address format"
+     * @example "You do not have permission to access this resource. Please contact your administrator."
+     * @example "The customer cannot be deleted because they have 3 active orders. Please cancel or complete the orders first."
+     */
+    detail: string;
+    documentationUrl: string;
+}
+//# sourceMappingURL=IDocumentedException.d.ts.map

package/dist-amd/models/interfaces/IDocumentedException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDocumentedException.d.ts","sourceRoot":"","sources":["../../../src/models/interfaces/IDocumentedException.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,OAAO,WAAW,oBAAoB;IAC5C;;;;;;;;;;OAUG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;;OAWG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf,gBAAgB,EAAE,MAAM,CAAC;CACzB"}

package/dist-amd/models/interfaces/IDocumentedException.js

@@ -0,0 +1,4 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/dist-amd/models/interfaces/IHttpResponse.d.ts

@@ -0,0 +1,5 @@
+export interface IHttpResponse<T> {
+    data: T;
+    response: Response;
+}
+//# sourceMappingURL=IHttpResponse.d.ts.map

package/dist-amd/models/interfaces/IHttpResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IHttpResponse.d.ts","sourceRoot":"","sources":["../../../src/models/interfaces/IHttpResponse.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,QAAQ,CAAC;CACnB"}

package/dist-amd/models/interfaces/IHttpResponse.js

@@ -0,0 +1,4 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/dist-amd/models/interfaces/IOdataError.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Represents a detailed error entry within an OData error response.
+ * Each detail provides specific information about individual validation errors
+ * or issues that occurred during the operation.
+ *
+ * This follows the OData v4 specification for error detail structures,
+ * commonly used in C# Web API and Entity Framework OData implementations.
+ *
+ * @example
+ * ```typescript
+ * const detail: IODataErrorDetail = {
+ *   code: "FIELD_REQUIRED",
+ *   message: "The Name field is required",
+ *   target: "Name"
+ * };
+ * ```
+ */
+export interface IODataErrorDetail {
+    /**
+     * The error code specific to this detail.
+     * Typically represents a validation rule or specific error type.
+     *
+     * @example "FIELD_REQUIRED", "INVALID_FORMAT", "VALUE_OUT_OF_RANGE"
+     */
+    code?: string;
+    /**
+     * Human-readable description of the specific error.
+     * Should provide clear information about what went wrong.
+     *
+     * @example "The Name field is required", "Invalid email format"
+     */
+    message?: string;
+    /**
+     * The target field, property, or parameter that caused this error.
+     * Helps identify which specific input or data element has the issue.
+     *
+     * @example "Name", "Email", "User.Address.PostalCode"
+     */
+    target?: string;
+}
+/**
+ * Represents the inner error structure containing technical debugging information.
+ * This is typically populated by C# backend services and contains detailed
+ * technical information useful for developers and system administrators.
+ *
+ * Inner errors can be nested to represent a chain of exceptions that led
+ * to the final error condition.
+ *
+ * @example
+ * ```typescript
+ * const innerError: IODataInnerError = {
+ *   message: "Object reference not set to an instance of an object",
+ *   type: "System.NullReferenceException",
+ *   stacktrace: "at MyService.ProcessData()...",
+ *   innererror: {
+ *     message: "Connection timeout",
+ *     type: "System.TimeoutException"
+ *   }
+ * };
+ * ```
+ */
+export interface IODataInnerError {
+    /**
+     * The technical error message from the underlying exception.
+     * Usually contains the actual exception message from the C# backend.
+     *
+     * @example "Object reference not set to an instance of an object"
+     */
+    message?: string;
+    /**
+     * The .NET type name of the exception that occurred.
+     * Useful for developers to understand the specific exception type.
+     *
+     * @example "System.NullReferenceException", "System.ArgumentException"
+     */
+    type?: string;
+    /**
+     * The full stack trace from the C# exception.
+     * Contains detailed information about where the error occurred in the code.
+     *
+     * @example "at MyNamespace.MyClass.MyMethod() in C:\\Source\\MyFile.cs:line 42"
+     */
+    stacktrace?: string;
+    /**
+     * Nested inner error for chained exceptions.
+     * Allows representation of exception chains where one exception caused another.
+     *
+     * @example When a database timeout causes a business logic exception
+     */
+    innererror?: IODataInnerError;
+}
+/**
+ * Represents the core error object structure within an OData error response.
+ * This contains the primary error information including code, message, details,
+ * and optional inner error data.
+ *
+ * This interface is designed to match the OData v4 error format specification
+ * and is typically implemented by C# Web API services using Entity Framework
+ * or ASP.NET Core OData middleware.
+ *
+ * @example
+ * ```typescript
+ * const errorObject: IOdataErrorObject = {
+ *   code: "VALIDATION_FAILED",
+ *   message: "One or more validation errors occurred",
+ *   details: [
+ *     { code: "REQUIRED", message: "Name is required", target: "Name" }
+ *   ],
+ *   innererror: {
+ *     type: "ValidationException",
+ *     message: "Validation failed for entity"
+ *   }
+ * };
+ * ```
+ */
+export interface IOdataErrorObject {
+    /**
+     * The primary error code identifying the type of error.
+     * Represents the main category or type of error that occurred.
+     *
+     * @example "VALIDATION_FAILED", "UNAUTHORIZED", "NOT_FOUND", "INTERNAL_ERROR"
+     */
+    code: string;
+    /**
+     * The primary human-readable error message.
+     * Should provide a clear, user-friendly description of what went wrong.
+     *
+     * @example "One or more validation errors occurred", "Access denied"
+     */
+    message: string;
+    /**
+     * Array of detailed error information.
+     * Contains specific details about individual errors, particularly useful
+     * for validation errors where multiple fields may have issues.
+     */
+    details: IODataErrorDetail[];
+    /**
+     * Optional inner error containing technical debugging information.
+     * Typically includes exception details, stack traces, and other
+     * technical information from the C# backend service.
+     */
+    innererror?: IODataInnerError;
+}
+/**
+ * Represents the complete OData error response structure.
+ * This is the top-level interface that wraps the error object and matches
+ * the standard OData v4 error response format.
+ *
+ * This structure is typically returned by C# Web API services when errors occur,
+ * following the OData specification for error responses.
+ *
+ * @example
+ * ```typescript
+ * // Typical OData error response from C# Web API
+ * const odataErrorResponse: IODataError = {
+ *   error: {
+ *     code: "VALIDATION_FAILED",
+ *     message: "Validation failed",
+ *     details: [
+ *       {
+ *         code: "REQUIRED_FIELD",
+ *         message: "The Name field is required",
+ *         target: "Name"
+ *       }
+ *     ],
+ *     innererror: {
+ *       type: "System.ComponentModel.DataAnnotations.ValidationException",
+ *       message: "Validation failed for one or more entities"
+ *     }
+ *   }
+ * };
+ * ```
+ */
+export interface IODataError {
+    /**
+     * The error object containing all error information.
+     * This follows the OData v4 specification requirement that errors
+     * be wrapped in an "error" property at the root level.
+     */
+    error: IOdataErrorObject;
+}
+//# sourceMappingURL=IOdataError.d.ts.map

package/dist-amd/models/interfaces/IOdataError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IOdataError.d.ts","sourceRoot":"","sources":["../../../src/models/interfaces/IOdataError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,gBAAgB;IAChC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAE7B;;;;OAIG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,WAAW;IAC3B;;;;OAIG;IACH,KAAK,EAAE,iBAAiB,CAAC;CACzB"}

package/dist-amd/models/interfaces/IOdataError.js

@@ -0,0 +1,4 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/dist-amd/models/interfaces/IProblemDetails.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Interface representing the RFC 7807 Problem Details for HTTP APIs specification.
+ * This standard provides a consistent format for returning error information
+ * from HTTP APIs, ensuring machine-readable error responses with human-readable details.
+ *
+ * Problem Details are commonly used in C# ASP.NET Core applications through
+ * the built-in ProblemDetails class and are the standard way to communicate
+ * errors in REST APIs following modern best practices.
+ *
+ * @see {@link https://tools.ietf.org/html/rfc7807 | RFC 7807 - Problem Details for HTTP APIs}
+ *
+ * @example
+ * ```typescript
+ * const problem: IProblemDetails = {
+ *   type: "https://example.com/probs/validation-error",
+ *   title: "Validation Failed",
+ *   status: 400,
+ *   detail: "One or more validation errors occurred",
+ *   instance: "/api/users/123"
+ * };
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Simple error without optional fields
+ * const simpleError: IProblemDetails = {
+ *   title: "Resource Not Found",
+ *   status: 404
+ * };
+ * ```
+ */
+export interface IProblemDetails {
+    /**
+     * A URI reference that identifies the problem type.
+     * This should be a stable identifier that doesn't change over time.
+     * When dereferenced, it should provide human-readable documentation
+     * for the problem type.
+     *
+     * If not provided, it defaults to "about:blank" per RFC 7807.
+     *
+     * @example "https://example.com/probs/validation-error"
+     * @example "https://api.myapp.com/errors/insufficient-funds"
+     * @example "urn:problem-type:authentication-required"
+     */
+    type?: string;
+    /**
+     * A short, human-readable summary of the problem type.
+     * This should not change from occurrence to occurrence of the problem,
+     * except for purposes of localization.
+     *
+     * This is the primary error message that should be displayed to users.
+     *
+     * @example "Validation Failed", "Resource Not Found", "Authentication Required"
+     * @example "Insufficient Funds", "Rate Limit Exceeded", "Service Unavailable"
+     */
+    title: string;
+    /**
+     * The HTTP status code generated by the origin server for this occurrence.
+     * This provides the numeric status code that should be returned in the HTTP response.
+     *
+     * @example 400 // Bad Request
+     * @example 401 // Unauthorized
+     * @example 404 // Not Found
+     * @example 422 // Unprocessable Entity
+     * @example 500 // Internal Server Error
+     */
+    status: number;
+    /**
+     * A human-readable explanation specific to this occurrence of the problem.
+     * This should provide additional context and details about what went wrong
+     * in this particular instance.
+     *
+     * Unlike the title, this can vary from occurrence to occurrence.
+     *
+     * @example "The email field is required and must be a valid email address"
+     * @example "User with ID 123 was not found in the system"
+     * @example "Account balance of $50.00 is insufficient for transaction of $75.00"
+     */
+    detail?: string;
+    /**
+     * A URI reference that identifies the specific occurrence of the problem.
+     * This is typically the request URI that generated the problem, but can be
+     * any URI that helps identify this particular problem instance.
+     *
+     * This is useful for debugging and logging purposes.
+     *
+     * @example "/api/users/123"
+     * @example "/api/orders/456/payments"
+     * @example "https://api.example.com/v1/accounts/789/transfer"
+     */
+    instance?: string;
+}
+//# sourceMappingURL=IProblemDetails.d.ts.map

package/dist-amd/models/interfaces/IProblemDetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProblemDetails.d.ts","sourceRoot":"","sources":["../../../src/models/interfaces/IProblemDetails.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;OASG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist-amd/models/interfaces/IProblemDetails.js

@@ -0,0 +1,4 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/dist-amd/models/interfaces/IValidationProblemDetails.d.ts

@@ -0,0 +1,82 @@
+import { IProblemDetails } from "./IProblemDetails";
+/**
+ * Interface representing validation-specific problem details that extend the RFC 7807 standard.
+ * This interface is designed to handle validation errors from C# ASP.NET Core applications
+ * using model validation, data annotations, and FluentValidation.
+ *
+ * ValidationProblemDetails provides structured information about validation failures,
+ * mapping each field or property to its specific validation error messages.
+ * This allows for detailed, field-specific error reporting in user interfaces.
+ *
+ * This interface corresponds to the ASP.NET Core ValidationProblemDetails class
+ * and is commonly returned by controllers with model validation errors.
+ *
+ * @extends IProblemDetails
+ *
+ * @example
+ * ```typescript
+ * const validationError: IValidationProblemDetails = {
+ *   title: "Validation Failed",
+ *   status: 400,
+ *   detail: "One or more validation errors occurred",
+ *   errors: {
+ *     "Name": ["The Name field is required"],
+ *     "Email": ["Invalid email format", "Email already exists"],
+ *     "Age": ["Age must be between 18 and 120"]
+ *   },
+ *   traceId: "0HMV0LR8T4Q8B:00000001"
+ * };
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Nested property validation errors
+ * const nestedValidation: IValidationProblemDetails = {
+ *   title: "Validation Failed",
+ *   status: 422,
+ *   errors: {
+ *     "Address.Street": ["Street address is required"],
+ *     "Address.PostalCode": ["Invalid postal code format"],
+ *     "ContactInfo.Phone": ["Phone number must be 10 digits"]
+ *   }
+ * };
+ * ```
+ */
+export interface IValidationProblemDetails extends IProblemDetails {
+    /**
+     * A dictionary mapping field names to arrays of validation error messages.
+     * Each key represents a property or field name that failed validation,
+     * and the corresponding value is an array of error messages for that field.
+     *
+     * Field names can include nested properties using dot notation (e.g., "Address.Street")
+     * and array indices (e.g., "Items[0].Name") to represent complex object structures.
+     *
+     * Multiple error messages per field allow for comprehensive validation feedback,
+     * such as when a field fails multiple validation rules.
+     *
+     * @example
+     * ```typescript
+     * {
+     *   "Name": ["The Name field is required"],
+     *   "Email": ["Invalid email format", "Email already exists"],
+     *   "Password": ["Password must be at least 8 characters", "Password must contain uppercase letter"],
+     *   "Address.PostalCode": ["Postal code is required", "Invalid postal code format"]
+     * }
+     * ```
+     */
+    errors: Record<string, string[]>;
+    /**
+     * Optional trace identifier for request tracking and debugging.
+     * This is typically generated by the server to correlate this error response
+     * with server-side logs, making it easier to debug issues in production.
+     *
+     * The trace ID format may vary depending on the logging framework used
+     * (e.g., ASP.NET Core's Activity.TraceId, Application Insights correlation ID).
+     *
+     * @example "0HMV0LR8T4Q8B:00000001"
+     * @example "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+     * @example "req_1234567890abcdef"
+     */
+    traceId?: string;
+}
+//# sourceMappingURL=IValidationProblemDetails.d.ts.map

package/dist-amd/models/interfaces/IValidationProblemDetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IValidationProblemDetails.d.ts","sourceRoot":"","sources":["../../../src/models/interfaces/IValidationProblemDetails.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IACjE;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEjC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist-amd/models/interfaces/IValidationProblemDetails.js

@@ -0,0 +1,4 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/dist-ui5/resources/computec/appengine/uibase/.library

@@ -2,7 +2,7 @@
 <library xmlns="http://www.sap.com/sap.ui.library.xsd">
     <name>computec.appengine.uibase</name>
     <vendor>CompuTec S.A.</vendor>
-    <version>1.0.8</version>
+    <version>1.0.10</version>
     <copyright>Copyright (c) CompuTec S.A.2025</copyright>
     <title>uibase</title>
     <documentation>Core library required by AppEngine plugins</documentation>

package/dist-ui5/resources/computec/appengine/uibase/helpers/WebClientNavigationHelper-dbg.js

@@ -0,0 +1,100 @@
+"use strict";
+
+sap.ui.define([], function () {
+  "use strict";
+
+  function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+  function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function (t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i.return) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine(u), _regeneratorDefine(u, o, "Generator"), _regeneratorDefine(u, n, function () { return this; }), _regeneratorDefine(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function () { return { w: i, m: f }; })(); }
+  function _regeneratorDefine(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine = function (e, r, n, t) { function o(r, n) { _regeneratorDefine(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine(e, r, n, t); }
+  function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+  function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+  function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+  function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+  function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+  function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+  function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+  function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+  /**
+   * Helper for navigating from UIAPI Web Client extensions to AppEngine plugin routes.
+   *
+   * AppEngine plugins are opened via the Web Client hash URL format:
+   * `#webclient-CompuTecWebClientStart-CompuTecWebClientStart&/{pluginId},{route}/{pluginName}`
+   *
+   * Routes containing path separators (e.g. `ctp/4/0`) must be double-encoded
+   * so that both the browser and the SAPUI5 router decode them correctly.
+   */
+  var WebClientNavigationHelper = /*#__PURE__*/function () {
+    function WebClientNavigationHelper() {
+      _classCallCheck(this, WebClientNavigationHelper);
+    }
+    return _createClass(WebClientNavigationHelper, null, [{
+      key: "buildPluginUrl",
+      value:
+      /**
+       * Build the full Web Client hash URL for navigating to an AppEngine plugin route.
+       *
+       * @param pluginId  The plugin identifier (e.g. `"MRP"`)
+       * @param route     The SAPUI5 route path including parameters (e.g. `"ctp/4/0"`, `"wizard"`)
+       * @param pluginName Optional display name; defaults to `pluginId`
+       * @returns The complete hash URL string
+       *
+       * @example
+       * ```typescript
+       * WebClientNavigationHelper.buildPluginUrl("MRP", "ctp/4/0");
+       * // => "#webclient-CompuTecWebClientStart-CompuTecWebClientStart&/MRP,ctp%252F4%252F0/MRP"
+       *
+       * WebClientNavigationHelper.buildPluginUrl("MRP", "wizard");
+       * // => "#webclient-CompuTecWebClientStart-CompuTecWebClientStart&/MRP,wizard/MRP"
+       * ```
+       */
+      function buildPluginUrl(pluginId, route, pluginName) {
+        var encodedRoute = encodeURIComponent(encodeURIComponent(route));
+        return "".concat(WebClientNavigationHelper.HASH_PREFIX, "&/").concat(pluginId, ",").concat(encodedRoute, "/").concat(pluginName !== null && pluginName !== void 0 ? pluginName : pluginId);
+      }
+
+      /**
+       * Navigate to an AppEngine plugin route using the SDKEnv `open` method.
+       *
+       * @param openFn    A function that opens a URL — typically `oEnv.open.bind(oEnv)` or `(url) => oEnv.open(url)`
+       * @param pluginId  The plugin identifier (e.g. `"MRP"`)
+       * @param route     The SAPUI5 route path including parameters (e.g. `"ctp/4/0"`)
+       * @param pluginName Optional display name; defaults to `pluginId`
+       *
+       * @example
+       * ```typescript
+       * // In a UIAPI controller:
+       * import { WebClientNavigationHelper } from "@computec/uibase";
+       *
+       * await WebClientNavigationHelper.openPlugin(
+       *     (url) => oEnv.open(url),
+       *     "MRP",
+       *     `ctp/${docEntry}/${lineNum}`
+       * );
+       * ```
+       */
+    }, {
+      key: "openPlugin",
+      value: (function () {
+        var _openPlugin = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(openFn, pluginId, route, pluginName) {
+          var url;
+          return _regenerator().w(function (_context) {
+            while (1) switch (_context.n) {
+              case 0:
+                url = WebClientNavigationHelper.buildPluginUrl(pluginId, route, pluginName);
+                _context.n = 1;
+                return openFn(url);
+              case 1:
+                return _context.a(2);
+            }
+          }, _callee);
+        }));
+        function openPlugin(_x, _x2, _x3, _x4) {
+          return _openPlugin.apply(this, arguments);
+        }
+        return openPlugin;
+      }())
+    }]);
+  }();
+  _defineProperty(WebClientNavigationHelper, "HASH_PREFIX", "#webclient-CompuTecWebClientStart-CompuTecWebClientStart");
+  return WebClientNavigationHelper;
+});