@ipetsadmin/contracts 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+### Changed
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+### Security
+
+## [1.0.0] - 2026-04-02
+
+### Added
+
+- Initial public release of `@ipetsadmin/contracts`.
+- Shared interfaces: `IConfig`, `IApiResponse`, `IPaginatedResponse`, `IServerInit`.
+- `Errors` enum for error class names.
+- Error classes: `BaseError`, `BusinessError`, `ForbiddenError`, `NotFoundError`.
+- MIT license, README, and npm publish tooling (validate, build, Husky, lint-staged).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ipetsadmin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,118 @@
+# @ipetsadmin/contracts
+
+Shared TypeScript types, enums, and error classes for Truffa projects. Published as a scoped npm package (`@ipetsadmin/contracts`).
+
+## Requirements
+
+- Node.js **18.18+** (see `engines` in `package.json`)
+- [pnpm](https://pnpm.io/) is used in this repo (npm/yarn work for consumers)
+
+## Installation
+
+```bash
+pnpm add @ipetsadmin/contracts
+# or
+npm install @ipetsadmin/contracts
+```
+
+For a **scoped public** package, publishing typically uses:
+
+```bash
+pnpm publish --access public
+```
+
+Configure your registry in `.npmrc` if you use GitHub Packages or another host.
+
+### From Git (alternative)
+
+```bash
+pnpm add git+https://github.com/your-org/contracts.git
+pnpm add git+https://github.com/your-org/contracts.git#v1.0.0
+```
+
+## Usage
+
+```typescript
+import {
+  Errors,
+  IConfig,
+  IApiResponse,
+  IPaginatedResponse,
+  IServerInit,
+  BaseError,
+  BusinessError,
+  ForbiddenError,
+  NotFoundError,
+} from '@ipetsadmin/contracts';
+```
+
+Path aliases (`@/…`) apply only inside this package’s source; consumers import from `@ipetsadmin/contracts` as above.
+
+## Development
+
+Install dependencies and (on first clone) install Git hooks:
+
+```bash
+pnpm install
+```
+
+| Script                  | Description                                                |
+| ----------------------- | ---------------------------------------------------------- |
+| `pnpm run build`        | Compile `src/` → `dist/` (TypeScript + path alias rewrite) |
+| `pnpm run clean`        | Remove `dist/`                                             |
+| `pnpm run typecheck`    | `tsc --noEmit` (no emit, full typecheck)                   |
+| `pnpm run lint`         | ESLint with cache (`.eslintcache`)                         |
+| `pnpm run lint:fix`     | ESLint with `--fix`                                        |
+| `pnpm run format`       | Prettier write (respects `.prettierignore`)                |
+| `pnpm run format:check` | Prettier check only                                        |
+| `pnpm run validate`     | `typecheck` → `lint` → `format:check` (use in CI)          |
+
+**Pre-commit:** [Husky](https://typicode.github.io/husky/) runs [lint-staged](https://github.com/lint-staged/lint-staged): ESLint + Prettier on staged `*.ts` / `*.tsx`, Prettier on staged `*.json` / `*.md`.
+
+**Before publish:** `prepublishOnly` runs `validate` then `build`, so broken code should not ship.
+
+### Tooling in this repo
+
+- **ESLint** — `eslint.config.mjs` (flat config), TypeScript type-aware rules via `typescript-eslint`, conflicts with Prettier disabled via `eslint-config-prettier`
+- **Prettier** — `.prettierrc.json`, `.prettierignore`
+- **Editor defaults** — `.editorconfig`
+
+## Publishing
+
+1. Bump the version in `package.json`.
+2. Run `pnpm run validate` and fix any issues.
+3. Publish: `pnpm publish` (or your registry-specific command).
+
+`pnpm run build` runs automatically in `prepublishOnly` after `validate`.
+
+## Package layout
+
+Source lives under `src/`:
+
+- `enums/` — shared enums (e.g. `Errors`)
+- `errors/` — error classes (`BaseError`, domain errors, …)
+- `interfaces/general/` — cross-cutting interfaces (`IConfig`, pagination, API responses, server bootstrap types, …)
+
+The public API is whatever `src/index.ts` re-exports. Additional error classes may exist under `src/errors/` but only appear in consumers if listed in `index.ts`.
+
+## Serverless / private registry notes
+
+- **Private npm:** set `@ipetsadmin:registry=…` and auth in `.npmrc` (or `NPM_TOKEN` in CI).
+- **Git installs:** ensure deploy environments can reach the repo and run `pnpm install` / `npm install` as usual.
+
+### AWS Lambda / Serverless Framework (example)
+
+```yaml
+package:
+  patterns:
+    - '!node_modules/**'
+    - 'node_modules/@ipetsadmin/contracts/**'
+```
+
+### Vercel
+
+Dependencies resolve at build time; ensure registry or Git access is configured for private packages.
+
+## License
+
+See [LICENSE](./LICENSE) (MIT).

package/dist/enums/errors.d.ts

@@ -0,0 +1,17 @@
+export declare enum Errors {
+    NOT_FOUND_ERROR = "NotFoundError",
+    BUSINESS_ERROR = "BusinessError",
+    FORBIDDEN_ERROR = "ForbiddenError",
+    SERVER_ERROR = "ServerError",
+    UNAUTHORIZED_ERROR = "UnauthorizedError",
+    BAD_REQUEST_ERROR = "BadRequestError",
+    UNPROCESSABLE_ENTITY_ERROR = "UnprocessableEntityError",
+    TOO_MANY_REQUESTS_ERROR = "TooManyRequestsError",
+    INTERNAL_SERVER_ERROR = "InternalServerError",
+    SERVICE_UNAVAILABLE_ERROR = "ServiceUnavailableError",
+    GATEWAY_TIMEOUT_ERROR = "GatewayTimeoutError",
+    BAD_GATEWAY_ERROR = "BadGatewayError",
+    PRECONDITION_FAILED_ERROR = "PreconditionFailedError",
+    PAYLOAD_TOO_LARGE_ERROR = "PayloadTooLargeError"
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/enums/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/enums/errors.ts"],"names":[],"mappings":"AAAA,oBAAY,MAAM;IAChB,eAAe,kBAAkB;IACjC,cAAc,kBAAkB;IAChC,eAAe,mBAAmB;IAClC,YAAY,gBAAgB;IAC5B,kBAAkB,sBAAsB;IACxC,iBAAiB,oBAAoB;IACrC,0BAA0B,6BAA6B;IACvD,uBAAuB,yBAAyB;IAChD,qBAAqB,wBAAwB;IAC7C,yBAAyB,4BAA4B;IACrD,qBAAqB,wBAAwB;IAC7C,iBAAiB,oBAAoB;IACrC,yBAAyB,4BAA4B;IACrD,uBAAuB,yBAAyB;CACjD"}

package/dist/enums/errors.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Errors = void 0;
+var Errors;
+(function (Errors) {
+    Errors["NOT_FOUND_ERROR"] = "NotFoundError";
+    Errors["BUSINESS_ERROR"] = "BusinessError";
+    Errors["FORBIDDEN_ERROR"] = "ForbiddenError";
+    Errors["SERVER_ERROR"] = "ServerError";
+    Errors["UNAUTHORIZED_ERROR"] = "UnauthorizedError";
+    Errors["BAD_REQUEST_ERROR"] = "BadRequestError";
+    Errors["UNPROCESSABLE_ENTITY_ERROR"] = "UnprocessableEntityError";
+    Errors["TOO_MANY_REQUESTS_ERROR"] = "TooManyRequestsError";
+    Errors["INTERNAL_SERVER_ERROR"] = "InternalServerError";
+    Errors["SERVICE_UNAVAILABLE_ERROR"] = "ServiceUnavailableError";
+    Errors["GATEWAY_TIMEOUT_ERROR"] = "GatewayTimeoutError";
+    Errors["BAD_GATEWAY_ERROR"] = "BadGatewayError";
+    Errors["PRECONDITION_FAILED_ERROR"] = "PreconditionFailedError";
+    Errors["PAYLOAD_TOO_LARGE_ERROR"] = "PayloadTooLargeError";
+})(Errors || (exports.Errors = Errors = {}));
+//# sourceMappingURL=errors.js.map

package/dist/enums/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/enums/errors.ts"],"names":[],"mappings":";;;AAAA,IAAY,MAeX;AAfD,WAAY,MAAM;IAChB,2CAAiC,CAAA;IACjC,0CAAgC,CAAA;IAChC,4CAAkC,CAAA;IAClC,sCAA4B,CAAA;IAC5B,kDAAwC,CAAA;IACxC,+CAAqC,CAAA;IACrC,iEAAuD,CAAA;IACvD,0DAAgD,CAAA;IAChD,uDAA6C,CAAA;IAC7C,+DAAqD,CAAA;IACrD,uDAA6C,CAAA;IAC7C,+CAAqC,CAAA;IACrC,+DAAqD,CAAA;IACrD,0DAAgD,CAAA;AAClD,CAAC,EAfW,MAAM,sBAAN,MAAM,QAejB"}

package/dist/errors/BaseError.d.ts

@@ -0,0 +1,8 @@
+export default class BaseError extends Error {
+    details?: Record<string, unknown>;
+    toErrorRecord(): {
+        error: string;
+        details?: unknown;
+    };
+}
+//# sourceMappingURL=BaseError.d.ts.map

package/dist/errors/BaseError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseError.d.ts","sourceRoot":"","sources":["../../src/errors/BaseError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,KAAK;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,aAAa,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;CAO7D"}

package/dist/errors/BaseError.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class BaseError extends Error {
+    toErrorRecord() {
+        const obj = { error: this.message };
+        if (this.details) {
+            obj.details = this.details;
+        }
+        return obj;
+    }
+}
+exports.default = BaseError;
+//# sourceMappingURL=BaseError.js.map

package/dist/errors/BaseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseError.js","sourceRoot":"","sources":["../../src/errors/BaseError.ts"],"names":[],"mappings":";;AAAA,MAAqB,SAAU,SAAQ,KAAK;IAEnC,aAAa;QAClB,MAAM,GAAG,GAAyC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1E,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AATD,4BASC"}

package/dist/errors/BusinessError.d.ts

@@ -0,0 +1,6 @@
+import BaseError from '../errors/BaseError';
+export default class BusinessError extends BaseError {
+    details?: Record<string, unknown>;
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=BusinessError.d.ts.map

package/dist/errors/BusinessError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BusinessError.d.ts","sourceRoot":"","sources":["../../src/errors/BusinessError.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAG3C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,SAAS;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACtB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMtE"}

package/dist/errors/BusinessError.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BaseError_1 = __importDefault(require("../errors/BaseError"));
+const errors_1 = require("../enums/errors");
+class BusinessError extends BaseError_1.default {
+    constructor(message, details) {
+        super(message);
+        this.name = errors_1.Errors.BUSINESS_ERROR;
+        this.details = details || {};
+        Object.setPrototypeOf(this, BusinessError.prototype);
+    }
+}
+exports.default = BusinessError;
+//# sourceMappingURL=BusinessError.js.map

package/dist/errors/BusinessError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BusinessError.js","sourceRoot":"","sources":["../../src/errors/BusinessError.ts"],"names":[],"mappings":";;;;;AAAA,mEAA2C;AAC3C,2CAAwC;AAExC,MAAqB,aAAc,SAAQ,mBAAS;IAElD,YAAmB,OAAe,EAAE,OAAiC;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAM,CAAC,cAAc,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AARD,gCAQC"}

package/dist/errors/ForbiddenError.d.ts

@@ -0,0 +1,6 @@
+import BaseError from './BaseError';
+export default class ForbiddenError extends BaseError {
+    details?: Record<string, unknown>;
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=ForbiddenError.d.ts.map

package/dist/errors/ForbiddenError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForbiddenError.d.ts","sourceRoot":"","sources":["../../src/errors/ForbiddenError.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAC;AAGpC,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,SAAS;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACtB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMtE"}

package/dist/errors/ForbiddenError.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BaseError_1 = __importDefault(require("./BaseError"));
+const errors_1 = require("../enums/errors");
+class ForbiddenError extends BaseError_1.default {
+    constructor(message, details) {
+        super(message);
+        this.name = errors_1.Errors.FORBIDDEN_ERROR;
+        this.details = details || {};
+        Object.setPrototypeOf(this, ForbiddenError.prototype);
+    }
+}
+exports.default = ForbiddenError;
+//# sourceMappingURL=ForbiddenError.js.map

package/dist/errors/ForbiddenError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForbiddenError.js","sourceRoot":"","sources":["../../src/errors/ForbiddenError.ts"],"names":[],"mappings":";;;;;AAAA,4DAAoC;AACpC,4CAAyC;AAEzC,MAAqB,cAAe,SAAQ,mBAAS;IAEnD,YAAmB,OAAe,EAAE,OAAiC;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAM,CAAC,eAAe,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF;AARD,iCAQC"}

package/dist/errors/NotFoundError.d.ts

@@ -0,0 +1,6 @@
+import BaseError from './BaseError';
+export default class NotFoundError extends BaseError {
+    details?: Record<string, unknown>;
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=NotFoundError.d.ts.map

package/dist/errors/NotFoundError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotFoundError.d.ts","sourceRoot":"","sources":["../../src/errors/NotFoundError.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAC;AAGpC,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,SAAS;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACtB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMtE"}

package/dist/errors/NotFoundError.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BaseError_1 = __importDefault(require("./BaseError"));
+const errors_1 = require("../enums/errors");
+class NotFoundError extends BaseError_1.default {
+    constructor(message, details) {
+        super(message);
+        this.name = errors_1.Errors.NOT_FOUND_ERROR;
+        this.details = details || {};
+        Object.setPrototypeOf(this, NotFoundError.prototype);
+    }
+}
+exports.default = NotFoundError;
+//# sourceMappingURL=NotFoundError.js.map

package/dist/errors/NotFoundError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotFoundError.js","sourceRoot":"","sources":["../../src/errors/NotFoundError.ts"],"names":[],"mappings":";;;;;AAAA,4DAAoC;AACpC,4CAAyC;AAEzC,MAAqB,aAAc,SAAQ,mBAAS;IAElD,YAAmB,OAAe,EAAE,OAAiC;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAM,CAAC,eAAe,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AARD,gCAQC"}

package/dist/errors/ServerError.d.ts

@@ -0,0 +1,6 @@
+import BaseError from './BaseError';
+export default class ServerError extends BaseError {
+    details?: Record<string, unknown>;
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=ServerError.d.ts.map

package/dist/errors/ServerError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerError.d.ts","sourceRoot":"","sources":["../../src/errors/ServerError.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAC;AAGpC,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,SAAS;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACtB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMtE"}

package/dist/errors/ServerError.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BaseError_1 = __importDefault(require("./BaseError"));
+const errors_1 = require("../enums/errors");
+class ServerError extends BaseError_1.default {
+    constructor(message, details) {
+        super(message);
+        this.name = errors_1.Errors.SERVER_ERROR;
+        this.details = details || {};
+        Object.setPrototypeOf(this, ServerError.prototype);
+    }
+}
+exports.default = ServerError;
+//# sourceMappingURL=ServerError.js.map

package/dist/errors/ServerError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerError.js","sourceRoot":"","sources":["../../src/errors/ServerError.ts"],"names":[],"mappings":";;;;;AAAA,4DAAoC;AACpC,4CAAyC;AAEzC,MAAqB,WAAY,SAAQ,mBAAS;IAEhD,YAAmB,OAAe,EAAE,OAAiC;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAM,CAAC,YAAY,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACF;AARD,8BAQC"}

package/dist/errors/UnauthorizedError.d.ts

@@ -0,0 +1,6 @@
+import BaseError from './BaseError';
+export default class UnauthorizedError extends BaseError {
+    details?: Record<string, unknown>;
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=UnauthorizedError.d.ts.map

package/dist/errors/UnauthorizedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnauthorizedError.d.ts","sourceRoot":"","sources":["../../src/errors/UnauthorizedError.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAC;AAGpC,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,SAAS;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACtB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMtE"}

package/dist/errors/UnauthorizedError.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BaseError_1 = __importDefault(require("./BaseError"));
+const errors_1 = require("../enums/errors");
+class UnauthorizedError extends BaseError_1.default {
+    constructor(message, details) {
+        super(message);
+        this.name = errors_1.Errors.UNAUTHORIZED_ERROR;
+        this.details = details || {};
+        Object.setPrototypeOf(this, UnauthorizedError.prototype);
+    }
+}
+exports.default = UnauthorizedError;
+//# sourceMappingURL=UnauthorizedError.js.map

package/dist/errors/UnauthorizedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnauthorizedError.js","sourceRoot":"","sources":["../../src/errors/UnauthorizedError.ts"],"names":[],"mappings":";;;;;AAAA,4DAAoC;AACpC,4CAAyC;AAEzC,MAAqB,iBAAkB,SAAQ,mBAAS;IAEtD,YAAmB,OAAe,EAAE,OAAiC;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAM,CAAC,kBAAkB,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AARD,oCAQC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './interfaces/general/IConfig';
+export * from './interfaces/general/IPaginatedResponse';
+export * from './interfaces/general/IServerInit';
+export * from './interfaces/general/IApiResponse';
+export * from './enums/errors';
+export * from './errors/BaseError';
+export * from './errors/BusinessError';
+export * from './errors/ForbiddenError';
+export * from './errors/NotFoundError';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yCAAyC,CAAC;AACxD,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./interfaces/general/IConfig"), exports);
+__exportStar(require("./interfaces/general/IPaginatedResponse"), exports);
+__exportStar(require("./interfaces/general/IServerInit"), exports);
+__exportStar(require("./interfaces/general/IApiResponse"), exports);
+__exportStar(require("./enums/errors"), exports);
+__exportStar(require("./errors/BaseError"), exports);
+__exportStar(require("./errors/BusinessError"), exports);
+__exportStar(require("./errors/ForbiddenError"), exports);
+__exportStar(require("./errors/NotFoundError"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAMA,+DAA6C;AAC7C,0EAAwD;AACxD,mEAAiD;AACjD,oEAAkD;AAGlD,iDAA+B;AAG/B,qDAAmC;AACnC,yDAAuC;AACvC,0DAAwC;AACxC,yDAAuC"}

package/dist/interfaces/general/IApiResponse.d.ts

@@ -0,0 +1,9 @@
+import type { IPagination } from '../../interfaces/general/IPagination';
+export interface IApiResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    pagination?: IPagination;
+    error?: string;
+    message?: string;
+}
+//# sourceMappingURL=IApiResponse.d.ts.map

package/dist/interfaces/general/IApiResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IApiResponse.d.ts","sourceRoot":"","sources":["../../../src/interfaces/general/IApiResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/interfaces/general/IApiResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IApiResponse.js.map

package/dist/interfaces/general/IApiResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IApiResponse.js","sourceRoot":"","sources":["../../../src/interfaces/general/IApiResponse.ts"],"names":[],"mappings":""}

package/dist/interfaces/general/IConfig.d.ts

@@ -0,0 +1,26 @@
+export interface IConfig {
+    port: number;
+    cors: {
+        origin: string;
+    };
+    environment: string;
+    apiVersions: string[];
+    mongodbUri?: string;
+    mongodbDbName?: string;
+    maxRequestRateLimit?: number;
+    maxTimeoutRateLimit?: number;
+    jwtSecret?: string;
+    jwtExpirationTime?: string;
+    saltRounds?: number;
+    redisUrl?: string;
+    jwtRecoveryPasswordSecret?: string;
+    jwtRecoveryPasswordExpirationTime?: string;
+    resendApiKey?: string;
+    frontendUrl?: string;
+    emailFromDomain?: string;
+    auth0Domain?: string;
+    auth0ClientId?: string;
+    auth0ClientSecret?: string;
+    auth0Audience?: string;
+}
+//# sourceMappingURL=IConfig.d.ts.map

package/dist/interfaces/general/IConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConfig.d.ts","sourceRoot":"","sources":["../../../src/interfaces/general/IConfig.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,iCAAiC,CAAC,EAAE,MAAM,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/interfaces/general/IConfig.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IConfig.js.map

package/dist/interfaces/general/IConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConfig.js","sourceRoot":"","sources":["../../../src/interfaces/general/IConfig.ts"],"names":[],"mappings":""}

package/dist/interfaces/general/IPaginatedResponse.d.ts

@@ -0,0 +1,6 @@
+import type { IPagination } from '../../interfaces/general/IPagination';
+export interface IPaginatedResponse<T> {
+    data: T[];
+    pagination: IPagination;
+}
+//# sourceMappingURL=IPaginatedResponse.d.ts.map

package/dist/interfaces/general/IPaginatedResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPaginatedResponse.d.ts","sourceRoot":"","sources":["../../../src/interfaces/general/IPaginatedResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,EAAE,WAAW,CAAC;CACzB"}

package/dist/interfaces/general/IPaginatedResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IPaginatedResponse.js.map

package/dist/interfaces/general/IPaginatedResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPaginatedResponse.js","sourceRoot":"","sources":["../../../src/interfaces/general/IPaginatedResponse.ts"],"names":[],"mappings":""}

package/dist/interfaces/general/IPagination.d.ts

@@ -0,0 +1,7 @@
+export interface IPagination {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+}
+//# sourceMappingURL=IPagination.d.ts.map

package/dist/interfaces/general/IPagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPagination.d.ts","sourceRoot":"","sources":["../../../src/interfaces/general/IPagination.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/interfaces/general/IPagination.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IPagination.js.map

package/dist/interfaces/general/IPagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPagination.js","sourceRoot":"","sources":["../../../src/interfaces/general/IPagination.ts"],"names":[],"mappings":""}

package/dist/interfaces/general/IServerInit.d.ts

@@ -0,0 +1,9 @@
+import type { Application } from 'express';
+import type { Logger } from 'winston';
+import type { IConfig } from '../../interfaces/general/IConfig';
+export interface IServerInit {
+    app: Application;
+    config: IConfig;
+    logger: Logger;
+}
+//# sourceMappingURL=IServerInit.d.ts.map

package/dist/interfaces/general/IServerInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IServerInit.d.ts","sourceRoot":"","sources":["../../../src/interfaces/general/IServerInit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,WAAW,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/interfaces/general/IServerInit.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IServerInit.js.map

package/dist/interfaces/general/IServerInit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IServerInit.js","sourceRoot":"","sources":["../../../src/interfaces/general/IServerInit.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@ipetsadmin/contracts",
+  "version": "1.0.0",
+  "description": "Shared types, enums, and interfaces for Truffa projects",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "eslint --fix --max-warnings 0",
+      "prettier --write"
+    ],
+    "*.{json,md}": "prettier --write"
+  },
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "keywords": [
+    "types",
+    "typescript",
+    "shared"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/express": "^5.0.5",
+    "@types/node": "^24.10.0",
+    "eslint": "^10.1.0",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
+    "prettier": "^3.8.1",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.58.0"
+  },
+  "peerDependencies": {
+    "express": "^5.1.0",
+    "mongodb": "^6.2.0",
+    "winston": "^3.18.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && tsc-alias",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --cache --cache-location .eslintcache",
+    "lint:fix": "eslint . --fix --cache --cache-location .eslintcache",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "validate": "pnpm run typecheck && pnpm run lint && pnpm run format:check",
+    "publish:npm": "pnpm publish --access public --no-git-checks"
+  }
+}