@computec/uibase 1.0.3 → 1.0.6

package/dist/models/UserInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UserInfo.d.ts","sourceRoot":"","sources":["../../src/models/UserInfo.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAGtD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,kBAAkB;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"UserInfo.d.ts","sourceRoot":"","sources":["../../src/models/UserInfo.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAGtD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,kBAAkB;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB,EAAE,MAAM,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,GAAG,EAAE,CAAC;IACtB,eAAe,EAAE,GAAG,EAAE,CAAC;IACvB,oBAAoB,EAAE,GAAG,EAAE,CAAC;CAC5B"}

package/dist/models/ValidationProblemDetails.d.ts

@@ -0,0 +1,19 @@
+import { IValidationProblemDetails } from "./interfaces/IValidationProblemDetails";
+import ProblemDetails from "./ProblemDetails";
+/**
+ * Specialized implementation for validation-specific problem details.
+ * Extends ProblemDetails to handle field-level validation errors
+ * with structured error mapping and optional request tracing.
+ *
+ * @extends ProblemDetails
+ * @implements IValidationProblemDetails
+ */
+export default class ValidationProblemDetails extends ProblemDetails implements IValidationProblemDetails {
+    errors: Record<string, string[]>;
+    traceId: string;
+    get name(): string;
+    get message(): string;
+    get error(): Error;
+    static is(obj: any): obj is IValidationProblemDetails;
+}
+//# sourceMappingURL=ValidationProblemDetails.d.ts.map

package/dist/models/ValidationProblemDetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationProblemDetails.d.ts","sourceRoot":"","sources":["../../src/models/ValidationProblemDetails.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,wBACpB,SAAQ,cACR,YAAW,yBAAyB;IAEpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAM;IACtC,OAAO,EAAE,MAAM,CAAQ;IAEvB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,OAAO,IAAI,MAAM,CAMpB;IAED,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,yBAAyB;CAQrD"}

package/dist/models/ValidationProblemDetails.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ProblemDetails_1 = __importDefault(require("./ProblemDetails"));
+/**
+ * Specialized implementation for validation-specific problem details.
+ * Extends ProblemDetails to handle field-level validation errors
+ * with structured error mapping and optional request tracing.
+ *
+ * @extends ProblemDetails
+ * @implements IValidationProblemDetails
+ */
+class ValidationProblemDetails extends ProblemDetails_1.default {
+    constructor() {
+        super(...arguments);
+        this.errors = {};
+        this.traceId = null;
+    }
+    get name() {
+        return "Validation Problem Details";
+    }
+    get message() {
+        let errorMessage = "";
+        Object.entries(this.errors).forEach(([field, messages]) => {
+            errorMessage += `${field}: ${messages.join(", ")}\n`;
+        });
+        return errorMessage.trim();
+    }
+    get error() {
+        return this;
+    }
+    static is(obj) {
+        if (!ProblemDetails_1.default.is(obj))
+            return false;
+        const candidate = obj;
+        return ("errors" in candidate && typeof candidate.errors === "object" && candidate.errors !== null);
+    }
+}
+exports.default = ValidationProblemDetails;

package/dist/models/Version.d.ts

@@ -0,0 +1,35 @@
+import BaseBusinessObject from "./BaseBusinessObject";
+export default class Version extends BaseBusinessObject {
+    static readonly VERSION_PATTERN: RegExp;
+    private readonly _major;
+    private readonly _minor;
+    private readonly _build;
+    private readonly _revision;
+    private readonly _prerelease;
+    constructor();
+    constructor(version: Version);
+    constructor(version: string);
+    constructor(version: number);
+    constructor(major: number, minor: number, build?: number, revision?: number, prerelease?: string);
+    static tryParse(version: string): {
+        success: boolean;
+        version?: Version;
+    };
+    private static tryParseComponent;
+    static isVersion(obj: any): obj is Partial<Version>;
+    get major(): number;
+    get minor(): number;
+    get build(): number;
+    get revision(): number;
+    get prerelease(): string;
+    static ZERO(): Version;
+    isZero(): boolean;
+    toString(): string;
+    private compare;
+    equals(other: Version): boolean;
+    lessThan(other: Version): boolean;
+    greaterThan(other: Version): boolean;
+    lessThanOrEqual(other: Version): boolean;
+    greaterThanOrEqual(other: Version): boolean;
+}
+//# sourceMappingURL=Version.d.ts.map

package/dist/models/Version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Version.d.ts","sourceRoot":"","sources":["../../src/models/Version.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAEtD,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,kBAAkB;IACtD,gBAAuB,eAAe,SAAgC;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;;gBAG9B,OAAO,EAAE,OAAO;gBAChB,OAAO,EAAE,MAAM;gBACf,OAAO,EAAE,MAAM;gBAE1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM;WA2CN,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG;QACxC,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KAClB;IA4DD,OAAO,CAAC,MAAM,CAAC,iBAAiB;WAalB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;IAS1D,IAAW,KAAK,IAAI,MAAM,CAEzB;IACD,IAAW,KAAK,IAAI,MAAM,CAEzB;IACD,IAAW,KAAK,IAAI,MAAM,CAEzB;IACD,IAAW,QAAQ,IAAI,MAAM,CAE5B;IACD,IAAW,UAAU,IAAI,MAAM,CAE9B;WAEa,IAAI;IAIX,MAAM,IAAI,OAAO;IAIxB,QAAQ,IAAI,MAAM;IAYlB,OAAO,CAAC,OAAO;IA8BR,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI/B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIjC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIpC,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIxC,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAGlD"}

package/dist/models/Version.js

@@ -0,0 +1,185 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BaseBusinessObject_1 = __importDefault(require("./BaseBusinessObject"));
+class Version extends BaseBusinessObject_1.default {
+    constructor(major, minor, build, revision, prerelease) {
+        super();
+        this._major = 0; // Major version number
+        this._minor = 0; // Minor version number
+        this._build = 0; // Build number
+        this._revision = 0; // Revision number
+        this._prerelease = ""; // Prerelease/metadata suffix
+        if (arguments.length === 0)
+            return this;
+        if (Version.isVersion(major)) {
+            this._major = major._major;
+            this._minor = major._minor;
+            this._build = major._build;
+            this._revision = major._revision;
+            this._prerelease = major._prerelease || "";
+        }
+        else if (typeof major === "string") {
+            const parsed = Version.tryParse(major);
+            if (!parsed.success) {
+                throw new Error("Invalid version format. Expected format: 'major.minor[.build][.revision][-prerelease]'");
+            }
+            this._major = parsed.version._major;
+            this._minor = parsed.version._minor;
+            this._build = parsed.version._build;
+            this._revision = parsed.version._revision;
+            this._prerelease = parsed.version._prerelease;
+        }
+        else if (typeof major === "number" && arguments.length === 1) {
+            const padded = major.toString().padStart(7, "0");
+            this._major = parseInt(padded.slice(0, 2), 10);
+            this._minor = parseInt(padded.slice(2, 4), 10);
+            this._build = parseInt(padded.slice(4, 7), 10);
+        }
+        else {
+            this._major = major || 0;
+            this._minor = minor || 0;
+            this._build = build || 0;
+            this._revision = revision || 0;
+            this._prerelease = prerelease || "";
+        }
+    }
+    static tryParse(version) {
+        if (!version) {
+            return { success: false };
+        }
+        let prerelease = "";
+        let prereleasePosition = version.indexOf("-");
+        if (prereleasePosition === -1) {
+            prereleasePosition = version.indexOf("+");
+        }
+        const isPrerelease = prereleasePosition > 1;
+        if (isPrerelease) {
+            prerelease = version.substring(prereleasePosition + 1);
+            version = version.substring(0, prereleasePosition);
+        }
+        const parts = version.split(".");
+        const length = parts.length;
+        if (length < 2 || length > 4) {
+            return { success: false };
+        }
+        const parsedComponents = [];
+        // Parse and validate each component
+        for (let i = 0; i < length; i++) {
+            const component = this.tryParseComponent(parts[i]);
+            if (!component.success) {
+                return { success: false };
+            }
+            parsedComponents.push(component.value);
+        }
+        // Create version based on number of components
+        let parsedVersion;
+        if (length === 2) {
+            parsedVersion = new Version(parsedComponents[0], parsedComponents[1], 0, 0, prerelease);
+        }
+        else if (length === 3) {
+            parsedVersion = new Version(parsedComponents[0], parsedComponents[1], parsedComponents[2], 0, prerelease);
+        }
+        else {
+            parsedVersion = new Version(parsedComponents[0], parsedComponents[1], parsedComponents[2], parsedComponents[3], prerelease);
+        }
+        return { success: true, version: parsedVersion };
+    }
+    static tryParseComponent(component) {
+        const parsed = parseInt(component, 10);
+        if (isNaN(parsed) || parsed < 0) {
+            return { success: false };
+        }
+        return { success: true, value: parsed };
+    }
+    static isVersion(obj) {
+        var _a, _b, _c;
+        if (obj instanceof Version)
+            return true;
+        if (!obj || typeof obj !== "object")
+            return false;
+        if (((_a = obj._major) !== null && _a !== void 0 ? _a : null) === null)
+            return false;
+        if (((_b = obj._minor) !== null && _b !== void 0 ? _b : null) === null)
+            return false;
+        if (((_c = obj._build) !== null && _c !== void 0 ? _c : null) === null)
+            return false;
+        return true;
+    }
+    get major() {
+        return this._major;
+    }
+    get minor() {
+        return this._minor;
+    }
+    get build() {
+        return this._build;
+    }
+    get revision() {
+        return this._revision;
+    }
+    get prerelease() {
+        return this._prerelease;
+    }
+    static ZERO() {
+        return new Version(0, 0, 0);
+    }
+    isZero() {
+        return this._major === 0 && this._minor === 0 && this._build === 0;
+    }
+    toString() {
+        let version = `${this._major.toString()}.${this._minor.toString()}.${this._build.toString()}`;
+        if (this._revision > 0) {
+            version += `.${this._revision.toString()}`;
+        }
+        if (this._prerelease) {
+            version += `-${this._prerelease}`;
+        }
+        return version;
+    }
+    //#region Comparison Methods
+    compare(other) {
+        if (this._major !== other._major) {
+            return this._major - other._major;
+        }
+        if (this._minor !== other._minor) {
+            return this._minor - other._minor;
+        }
+        if (this._build !== other._build) {
+            return this._build - other._build;
+        }
+        if (this._revision !== other._revision) {
+            return this._revision - other._revision;
+        }
+        // Handle prerelease comparison
+        // Normal versions (no prerelease) are greater than prerelease versions
+        if (!this._prerelease && other._prerelease)
+            return 1;
+        if (this._prerelease && !other._prerelease)
+            return -1;
+        // Both have prerelease, compare lexicographically
+        if (this._prerelease && other._prerelease) {
+            return this._prerelease.localeCompare(other._prerelease);
+        }
+        return 0;
+    }
+    equals(other) {
+        return this.compare(other) === 0;
+    }
+    lessThan(other) {
+        return this.compare(other) < 0;
+    }
+    greaterThan(other) {
+        return this.compare(other) > 0;
+    }
+    lessThanOrEqual(other) {
+        return this.compare(other) <= 0;
+    }
+    greaterThanOrEqual(other) {
+        return this.compare(other) >= 0;
+    }
+}
+Version.VERSION_PATTERN = /^\d+(\.\d+){1,3}([-+].+)?$/; // Pattern for version strings with optional prerelease/metadata
+exports.default = Version;

package/dist/models/enums/HeadersContentTypeEnum.d.ts

@@ -2,6 +2,13 @@ declare enum HeadersContentTypeEnum {
     Json = "application/json",
     Text = "text/plain",
     OctetStream = "application/octet-stream",
+    Pdf = "application/pdf",
+    Csv = "text/csv",
+    Excel = "application/vnd.ms-excel",
+    ExcelOpenXml = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    Word = "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    Zip = "application/zip",
+    Xml = "application/xml",
     Null = "null"
 }
 export default HeadersContentTypeEnum;

package/dist/models/enums/HeadersContentTypeEnum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeadersContentTypeEnum.d.ts","sourceRoot":"","sources":["../../../src/models/enums/HeadersContentTypeEnum.ts"],"names":[],"mappings":"AAAA,aAAK,sBAAsB;IACzB,IAAI,qBAAqB;IACzB,IAAI,eAAe;IACnB,WAAW,6BAA6B;IACxC,IAAI,SAAS;CACd;AAED,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"HeadersContentTypeEnum.d.ts","sourceRoot":"","sources":["../../../src/models/enums/HeadersContentTypeEnum.ts"],"names":[],"mappings":"AAAA,aAAK,sBAAsB;IACzB,IAAI,qBAAqB;IACzB,IAAI,eAAe;IACnB,WAAW,6BAA6B;IACxC,GAAG,oBAAoB;IACvB,GAAG,aAAa;IAChB,KAAK,6BAA6B;IAClC,YAAY,sEAAsE;IAClF,IAAI,4EAA4E;IAChF,GAAG,oBAAoB;IACvB,GAAG,oBAAoB;IACvB,IAAI,SAAS;CACd;AAED,eAAe,sBAAsB,CAAC"}

package/dist/models/enums/HeadersContentTypeEnum.js

@@ -5,6 +5,13 @@ var HeadersContentTypeEnum;
     HeadersContentTypeEnum["Json"] = "application/json";
     HeadersContentTypeEnum["Text"] = "text/plain";
     HeadersContentTypeEnum["OctetStream"] = "application/octet-stream";
+    HeadersContentTypeEnum["Pdf"] = "application/pdf";
+    HeadersContentTypeEnum["Csv"] = "text/csv";
+    HeadersContentTypeEnum["Excel"] = "application/vnd.ms-excel";
+    HeadersContentTypeEnum["ExcelOpenXml"] = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+    HeadersContentTypeEnum["Word"] = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+    HeadersContentTypeEnum["Zip"] = "application/zip";
+    HeadersContentTypeEnum["Xml"] = "application/xml";
     HeadersContentTypeEnum["Null"] = "null";
 })(HeadersContentTypeEnum || (HeadersContentTypeEnum = {}));
 exports.default = HeadersContentTypeEnum;

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

@@ -1,7 +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 {
-    Title?: string;
-    Detail?: string;
-    title?: string;
-    detail?: string;
+    /**
+     * 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/models/interfaces/IAppEngineException.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IAppEngineException.d.ts","sourceRoot":"","sources":["../../../src/models/interfaces/IAppEngineException.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,WAAW,mBAAmB;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"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/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/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/models/interfaces/IDocumentedException.js

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

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

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

package/dist/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/models/interfaces/IHttpResponse.js

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

package/dist/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/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"}