@zssz-soft/common-api 0.0.1

package/README.md

@@ -0,0 +1,64 @@
+# CommonApi
+
+This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 21.0.0.
+
+## Code scaffolding
+
+Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
+
+```bash
+ng generate component component-name
+```
+
+For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
+
+```bash
+ng generate --help
+```
+
+## Building
+
+To build the library, run:
+
+```bash
+ng build common-api
+```
+
+This command will compile your project, and the build artifacts will be placed in the `dist/` directory.
+
+### Publishing the Library
+
+Once the project is built, you can publish your library by following these steps:
+
+1. Navigate to the `dist` directory:
+
+   ```bash
+   cd dist/common-api
+   ```
+
+2. Run the `npm publish` command to publish your library to the npm registry:
+   ```bash
+   npm publish
+   ```
+
+## Running unit tests
+
+To execute unit tests with the [Karma](https://karma-runner.github.io) test runner, use the following command:
+
+```bash
+ng test
+```
+
+## Running end-to-end tests
+
+For end-to-end (e2e) testing, run:
+
+```bash
+ng e2e
+```
+
+Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
+
+## Additional Resources
+
+For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.

package/fesm2022/zssz-soft-common-api.mjs

@@ -0,0 +1,166 @@
+var ActionEnum;
+(function (ActionEnum) {
+    ActionEnum["ALL"] = "all";
+    ActionEnum["VIEW"] = "view";
+    ActionEnum["READ"] = "read";
+    ActionEnum["CREATE"] = "create";
+    ActionEnum["DELETE"] = "delete";
+    ActionEnum["SOME"] = "some";
+    ActionEnum["UPDATE"] = "update";
+})(ActionEnum || (ActionEnum = {}));
+
+var CurrencyEnum;
+(function (CurrencyEnum) {
+    CurrencyEnum["HUF"] = "HUF";
+    CurrencyEnum["EUR"] = "EUR";
+    CurrencyEnum["USD"] = "USD";
+})(CurrencyEnum || (CurrencyEnum = {}));
+const currencies = [CurrencyEnum.HUF, CurrencyEnum.EUR, CurrencyEnum.USD];
+
+const RoleNames = {
+    ADMIN: 'ADMIN',
+    EDITOR: 'EDITOR',
+    OWNER: 'OWNER',
+    USER: 'USER',
+};
+
+class PermissionsService {
+    static permissions = [
+        {
+            label: 'App',
+            items: [
+                {
+                    label: RoleNames.ADMIN,
+                    value: RoleNames.ADMIN,
+                },
+                {
+                    label: RoleNames.USER,
+                    value: RoleNames.USER,
+                },
+            ],
+        },
+    ];
+    static addPermissions(permissions) {
+        PermissionsService.permissions.push(permissions);
+    }
+}
+
+/**
+ * Default pagination constants
+ */
+const DEFAULT_PAGE_SIZE = 10;
+const MAX_PAGE_SIZE = 100;
+/**
+ * Search constants
+ */
+const MIN_SEARCH_LENGTH = 3;
+
+var QueryOperatorEnum;
+(function (QueryOperatorEnum) {
+    QueryOperatorEnum["less"] = "<";
+    QueryOperatorEnum["lessEqual"] = "<=";
+    QueryOperatorEnum["equal"] = "==";
+    QueryOperatorEnum["notEqual"] = "!=";
+    QueryOperatorEnum["greaterEqual"] = ">=";
+    QueryOperatorEnum["greater"] = ">";
+    QueryOperatorEnum["arrayContains"] = "array-contains";
+    QueryOperatorEnum["in"] = "in";
+    QueryOperatorEnum["arrayContainsAny"] = "array-contains-any";
+    QueryOperatorEnum["notIn"] = "not-in";
+})(QueryOperatorEnum || (QueryOperatorEnum = {}));
+var QueryConstraintTypeEnum;
+(function (QueryConstraintTypeEnum) {
+    QueryConstraintTypeEnum["where"] = "where";
+    QueryConstraintTypeEnum["orderBy"] = "orderBy";
+    QueryConstraintTypeEnum["limit"] = "limit";
+    QueryConstraintTypeEnum["limitToLast"] = "limitToLast";
+    QueryConstraintTypeEnum["startAt"] = "startAt";
+    QueryConstraintTypeEnum["startAfter"] = "startAfter";
+    QueryConstraintTypeEnum["endAt"] = "endAt";
+    QueryConstraintTypeEnum["endBefore"] = "endBefore";
+})(QueryConstraintTypeEnum || (QueryConstraintTypeEnum = {}));
+
+/**
+ * Validates if a search term meets minimum length requirement
+ */
+function isValidSearchTerm(term) {
+    return !!term && term.trim().length >= MIN_SEARCH_LENGTH;
+}
+/**
+ * Normalizes a search term (trims and lowercases)
+ */
+function normalizeSearchTerm(term) {
+    return term.trim().toLowerCase();
+}
+
+var EntityTypeEnum;
+(function (EntityTypeEnum) {
+    EntityTypeEnum["Document"] = "document";
+    EntityTypeEnum["Entity"] = "entity";
+    EntityTypeEnum["User"] = "user";
+    EntityTypeEnum["Role"] = "role";
+})(EntityTypeEnum || (EntityTypeEnum = {}));
+
+/**
+ * Common types used across entities
+ */
+/**
+ * User account status
+ */
+var UserStatus;
+(function (UserStatus) {
+    UserStatus["ACTIVE"] = "ACTIVE";
+    UserStatus["INACTIVE"] = "INACTIVE";
+    UserStatus["SUSPENDED"] = "SUSPENDED";
+    UserStatus["PENDING"] = "PENDING";
+})(UserStatus || (UserStatus = {}));
+/**
+ * Common status enumeration
+ */
+var Status;
+(function (Status) {
+    Status["ACTIVE"] = "ACTIVE";
+    Status["INACTIVE"] = "INACTIVE";
+    Status["PENDING"] = "PENDING";
+    Status["ARCHIVED"] = "ARCHIVED";
+})(Status || (Status = {}));
+/**
+ * User roles enumeration
+ */
+var UserRole;
+(function (UserRole) {
+    UserRole["ADMIN"] = "ADMIN";
+    UserRole["USER"] = "USER";
+    UserRole["GUEST"] = "GUEST";
+})(UserRole || (UserRole = {}));
+/**
+ * Priority levels enumeration
+ */
+var Priority;
+(function (Priority) {
+    Priority["LOW"] = "LOW";
+    Priority["MEDIUM"] = "MEDIUM";
+    Priority["HIGH"] = "HIGH";
+    Priority["URGENT"] = "URGENT";
+})(Priority || (Priority = {}));
+/**
+ * Common currency codes
+ */
+var CurrencyCode;
+(function (CurrencyCode) {
+    CurrencyCode["USD"] = "USD";
+    CurrencyCode["EUR"] = "EUR";
+    CurrencyCode["GBP"] = "GBP";
+    CurrencyCode["HUF"] = "HUF";
+})(CurrencyCode || (CurrencyCode = {}));
+
+/*
+ * Public API Surface of common-api
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { ActionEnum, CurrencyCode, CurrencyEnum, DEFAULT_PAGE_SIZE, EntityTypeEnum, MAX_PAGE_SIZE, MIN_SEARCH_LENGTH, PermissionsService, Priority, QueryConstraintTypeEnum, QueryOperatorEnum, RoleNames, Status, UserRole, UserStatus, currencies, isValidSearchTerm, normalizeSearchTerm };
+//# sourceMappingURL=zssz-soft-common-api.mjs.map

package/fesm2022/zssz-soft-common-api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"zssz-soft-common-api.mjs","sources":["../../../projects/common-api/src/lib/action/action.ts","../../../projects/common-api/src/lib/currency/currency.ts","../../../projects/common-api/src/lib/role/role.ts","../../../projects/common-api/src/lib/permission/permissions.service.ts","../../../projects/common-api/src/lib/query/query.constants.ts","../../../projects/common-api/src/lib/query/query.enums.ts","../../../projects/common-api/src/lib/query/query.utils.ts","../../../projects/common-api/src/lib/search/search.ts","../../../projects/common-api/src/lib/types/common-types.ts","../../../projects/common-api/src/public-api.ts","../../../projects/common-api/src/zssz-soft-common-api.ts"],"sourcesContent":["export interface Action {\n  name: string;\n}\n\nexport enum ActionEnum {\n  ALL = 'all',\n  VIEW = 'view',\n  READ = 'read',\n  CREATE = 'create',\n  DELETE = 'delete',\n  SOME = 'some',\n  UPDATE = 'update',\n}\n","export enum CurrencyEnum {\n  HUF = 'HUF',\n  EUR = 'EUR',\n  USD = 'USD',\n}\n\nexport const currencies: CurrencyEnum[] = [CurrencyEnum.HUF, CurrencyEnum.EUR, CurrencyEnum.USD];\n","export interface _Role {\n  editable?: boolean;\n  name: string;\n  permissions: string[];\n}\n\nexport type Role = _Role;\n\nexport const RoleNames = {\n  ADMIN: 'ADMIN',\n  EDITOR: 'EDITOR',\n  OWNER: 'OWNER',\n  USER: 'USER',\n};\n","export interface SelectItem {\n  label?: string;\n  value: any;\n  styleClass?: string;\n  icon?: string;\n  title?: string;\n  disabled?: boolean;\n}\n\nexport interface SelectItemGroup {\n  label: string;\n  value?: any;\n  items: SelectItem[];\n}\n\nimport { RoleNames } from '../role';\n\nexport abstract class PermissionsService {\n  public static permissions: SelectItemGroup[] = [\n    {\n      label: 'App',\n      items: [\n        {\n          label: RoleNames.ADMIN,\n          value: RoleNames.ADMIN,\n        },\n        {\n          label: RoleNames.USER,\n          value: RoleNames.USER,\n        },\n      ],\n    },\n  ];\n\n  public static addPermissions(permissions: SelectItemGroup): void {\n    PermissionsService.permissions.push(permissions);\n  }\n}\n","/**\n * Default pagination constants\n */\nexport const DEFAULT_PAGE_SIZE = 10;\nexport const MAX_PAGE_SIZE = 100;\n\n/**\n * Search constants\n */\nexport const MIN_SEARCH_LENGTH = 3;\n","export enum QueryOperatorEnum {\n  less = '<',\n  lessEqual = '<=',\n  equal = '==',\n  notEqual = '!=',\n  greaterEqual = '>=',\n  greater = '>',\n  arrayContains = 'array-contains',\n  in = 'in',\n  arrayContainsAny = 'array-contains-any',\n  notIn = 'not-in',\n}\n\nexport enum QueryConstraintTypeEnum {\n  where = 'where',\n  orderBy = 'orderBy',\n  limit = 'limit',\n  limitToLast = 'limitToLast',\n  startAt = 'startAt',\n  startAfter = 'startAfter',\n  endAt = 'endAt',\n  endBefore = 'endBefore',\n}\n","import { MIN_SEARCH_LENGTH } from './query.constants';\n\n/**\n * Validates if a search term meets minimum length requirement\n */\nexport function isValidSearchTerm(term: string | undefined | null): boolean {\n  return !!term && term.trim().length >= MIN_SEARCH_LENGTH;\n}\n\n/**\n * Normalizes a search term (trims and lowercases)\n */\nexport function normalizeSearchTerm(term: string): string {\n  return term.trim().toLowerCase();\n}\n","import { QueryConstraintTypeEnum, QueryOperatorEnum } from '../query';\n\nexport const enum EntityTypeEnum {\n  Document = 'document',\n  Entity = 'entity',\n  User = 'user',\n  Role = 'role',\n}\n\nexport interface Searchable {\n  searchParameters: string[];\n}\n\nexport interface SearchParam {\n  entityType: EntityTypeEnum;\n  query: ParamItem<unknown>;\n}\n\nexport interface ParamItem<T> {\n  field: string;\n  queryConstraint: QueryConstraintTypeEnum;\n  operation: QueryOperatorEnum;\n  value: T;\n}\n\nexport type SearchParams = SearchParam[];\n","/**\n * Common types used across entities\n */\n\n/** Entity identifier type */\nexport type EntityId = string;\n\n/** User identifier type */\nexport type UserId = string;\n\n/** Email address type */\nexport type Email = string;\n\n/** Phone number type */\nexport type Phone = string;\n\n/** URL type */\nexport type Url = string;\n\n/** Money amount with currency */\nexport interface Money {\n  amount: number;\n  currency: string; // ISO 4217 currency code\n}\n\n/** Address information */\nexport interface Address {\n  street: string;\n  city: string;\n  state?: string;\n  postalCode: string;\n  country: string;\n}\n\n/** Date range */\nexport interface DateRange {\n  startDate: Date;\n  endDate: Date;\n}\n\n/**\n * User account status\n */\nexport enum UserStatus {\n  ACTIVE = 'ACTIVE',\n  INACTIVE = 'INACTIVE',\n  SUSPENDED = 'SUSPENDED',\n  PENDING = 'PENDING',\n}\n\n/**\n * Common status enumeration\n */\nexport enum Status {\n  ACTIVE = 'ACTIVE',\n  INACTIVE = 'INACTIVE',\n  PENDING = 'PENDING',\n  ARCHIVED = 'ARCHIVED',\n}\n\n/**\n * User roles enumeration\n */\nexport enum UserRole {\n  ADMIN = 'ADMIN',\n  USER = 'USER',\n  GUEST = 'GUEST',\n}\n\n/**\n * Priority levels enumeration\n */\nexport enum Priority {\n  LOW = 'LOW',\n  MEDIUM = 'MEDIUM',\n  HIGH = 'HIGH',\n  URGENT = 'URGENT',\n}\n\n/**\n * Common currency codes\n */\nexport enum CurrencyCode {\n  USD = 'USD',\n  EUR = 'EUR',\n  GBP = 'GBP',\n  HUF = 'HUF',\n}\n","/*\n * Public API Surface of common-api\n */\n\nexport * from './lib/action';\nexport * from './lib/currency';\nexport * from './lib/deletable';\nexport * from './lib/identifiable';\nexport * from './lib/message';\nexport * from './lib/meta';\nexport * from './lib/pagination';\nexport * from './lib/permission';\nexport * from './lib/query';\nexport * from './lib/role';\nexport * from './lib/search';\nexport * from './lib/types';\nexport * from './lib/user';\nexport * from './lib/versionable';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@zssz-soft/common-api",
+  "version": "0.0.1",
+  "description": "Foundation types for the @zssz-soft library ecosystem",
+  "author": "zssz-soft",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zssz-soft/libraries.git",
+    "directory": "projects/common-api"
+  },
+  "homepage": "https://github.com/zssz-soft/libraries/tree/main/projects/common-api",
+  "bugs": {
+    "url": "https://github.com/zssz-soft/libraries/issues"
+  },
+  "keywords": [
+    "angular",
+    "typescript",
+    "api",
+    "types"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@angular/common": "^21.0.0",
+    "@angular/core": "^21.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/zssz-soft-common-api.mjs",
+  "typings": "types/zssz-soft-common-api.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/zssz-soft-common-api.d.ts",
+      "default": "./fesm2022/zssz-soft-common-api.mjs"
+    }
+  }
+}

package/types/zssz-soft-common-api.d.ts

@@ -0,0 +1,362 @@
+interface Action {
+    name: string;
+}
+declare enum ActionEnum {
+    ALL = "all",
+    VIEW = "view",
+    READ = "read",
+    CREATE = "create",
+    DELETE = "delete",
+    SOME = "some",
+    UPDATE = "update"
+}
+
+declare enum CurrencyEnum {
+    HUF = "HUF",
+    EUR = "EUR",
+    USD = "USD"
+}
+declare const currencies: CurrencyEnum[];
+
+interface Deletable {
+    /** Soft delete flag */
+    isDeleted?: boolean;
+    /** Deletion  */
+    deletedAt?: string;
+    /** Deleter user ID */
+    deletedBy?: string;
+}
+
+interface Identifiable {
+    uid: string;
+}
+
+interface Message {
+    severity?: string;
+    summary?: string;
+    detail?: string;
+    id?: any;
+    key?: string;
+    life?: number;
+    sticky?: boolean;
+    closable?: boolean;
+    data?: any;
+    icon?: string;
+    contentStyleClass?: string;
+    styleClass?: string;
+    closeIcon?: string;
+}
+
+interface Meta {
+    /** Creation  */
+    createdAt: string;
+    /** Last update  */
+    updatedAt: string;
+    /** Creator user ID */
+    createdBy?: string;
+    /** Last updater user ID */
+    updatedBy?: string;
+}
+
+/**
+ * Cursor value for pagination - can be any field value or document snapshot
+ */
+type CursorValue = unknown;
+/**
+ * Search options for text-based filtering
+ */
+interface SearchOptions {
+    /** The search term (minimum MIN_SEARCH_LENGTH characters) */
+    term: string;
+    /** Fields to search in */
+    fields: string[];
+}
+/**
+ * Query options for database operations
+ */
+interface QueryOptions {
+    /** Filter conditions */
+    where?: QueryFilter[];
+    /** Sort order - required for cursor-based pagination */
+    orderBy?: QuerySort[];
+    /** Maximum number of results to return */
+    limit?: number;
+    /** Number of results to skip (offset-based pagination - less efficient) */
+    offset?: number;
+    /** Start results after this cursor value (cursor-based pagination) */
+    startAfter?: CursorValue;
+    /** Start results at this cursor value (inclusive) */
+    startAt?: CursorValue;
+    /** End results before this cursor value */
+    endBefore?: CursorValue;
+    /** End results at this cursor value (inclusive) */
+    endAt?: CursorValue;
+    /** Text search options */
+    search?: SearchOptions;
+}
+/**
+ * Extended query options with pagination metadata
+ * Used for paginated queries that need cursor tracking
+ */
+interface PaginatedQueryOptions extends QueryOptions {
+    /** Page number (1-indexed, for UI display) */
+    page?: number;
+    /** Size of each page */
+    pageSize?: number;
+}
+/**
+ * Query filter interface
+ */
+interface QueryFilter {
+    field: string;
+    operator: '==' | '!=' | '<' | '<=' | '>' | '>=' | 'array-contains' | 'array-contains-any' | 'in' | 'not-in';
+    value: unknown;
+}
+/**
+ * Sort direction type
+ */
+type QuerySortDirection = 'asc' | 'desc';
+/**
+ * Query sort interface
+ */
+interface QuerySort {
+    field: string;
+    direction: QuerySortDirection;
+}
+
+/** Pagination parameters (offset-based) */
+interface PaginationOptions {
+    page: number;
+    limit: number;
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+}
+/** Cursor-based pagination parameters (more efficient for Firestore) */
+interface CursorPaginationOptions {
+    /** Number of items per page */
+    pageSize: number;
+    /** Field to sort by */
+    sortBy?: string;
+    /** Sort direction */
+    sortOrder?: 'asc' | 'desc';
+    /** Cursor to start after (for next page) */
+    startAfter?: CursorValue;
+    /** Cursor to end before (for previous page) */
+    endBefore?: CursorValue;
+}
+/** Pagination result */
+interface PaginatedResult<T> {
+    items: T[];
+    totalItems: number;
+    totalPages: number;
+    currentPage: number;
+    hasNext: boolean;
+    hasPrevious: boolean;
+}
+/** Cursor-based pagination result (more efficient for Firestore) */
+interface CursorPaginatedResult<T> {
+    /** The items for the current page */
+    items: T[];
+    /** Whether there are more items after this page */
+    hasNext: boolean;
+    /** Whether there are items before this page */
+    hasPrevious: boolean;
+    /** Cursor for the first item (for previous page navigation) */
+    firstCursor?: CursorValue;
+    /** Cursor for the last item (for next page navigation) */
+    lastCursor?: CursorValue;
+    /** Total count (optional - expensive operation in Firestore) */
+    totalItems?: number;
+}
+
+interface SelectItem {
+    label?: string;
+    value: any;
+    styleClass?: string;
+    icon?: string;
+    title?: string;
+    disabled?: boolean;
+}
+interface SelectItemGroup {
+    label: string;
+    value?: any;
+    items: SelectItem[];
+}
+declare abstract class PermissionsService {
+    static permissions: SelectItemGroup[];
+    static addPermissions(permissions: SelectItemGroup): void;
+}
+
+/**
+ * Default pagination constants
+ */
+declare const DEFAULT_PAGE_SIZE = 10;
+declare const MAX_PAGE_SIZE = 100;
+/**
+ * Search constants
+ */
+declare const MIN_SEARCH_LENGTH = 3;
+
+declare enum QueryOperatorEnum {
+    less = "<",
+    lessEqual = "<=",
+    equal = "==",
+    notEqual = "!=",
+    greaterEqual = ">=",
+    greater = ">",
+    arrayContains = "array-contains",
+    in = "in",
+    arrayContainsAny = "array-contains-any",
+    notIn = "not-in"
+}
+declare enum QueryConstraintTypeEnum {
+    where = "where",
+    orderBy = "orderBy",
+    limit = "limit",
+    limitToLast = "limitToLast",
+    startAt = "startAt",
+    startAfter = "startAfter",
+    endAt = "endAt",
+    endBefore = "endBefore"
+}
+
+/**
+ * Validates if a search term meets minimum length requirement
+ */
+declare function isValidSearchTerm(term: string | undefined | null): boolean;
+/**
+ * Normalizes a search term (trims and lowercases)
+ */
+declare function normalizeSearchTerm(term: string): string;
+
+interface _Role {
+    editable?: boolean;
+    name: string;
+    permissions: string[];
+}
+type Role = _Role;
+declare const RoleNames: {
+    ADMIN: string;
+    EDITOR: string;
+    OWNER: string;
+    USER: string;
+};
+
+declare const enum EntityTypeEnum {
+    Document = "document",
+    Entity = "entity",
+    User = "user",
+    Role = "role"
+}
+interface Searchable {
+    searchParameters: string[];
+}
+interface SearchParam {
+    entityType: EntityTypeEnum;
+    query: ParamItem<unknown>;
+}
+interface ParamItem<T> {
+    field: string;
+    queryConstraint: QueryConstraintTypeEnum;
+    operation: QueryOperatorEnum;
+    value: T;
+}
+type SearchParams = SearchParam[];
+
+/**
+ * Common types used across entities
+ */
+/** Entity identifier type */
+type EntityId = string;
+/** User identifier type */
+type UserId = string;
+/** Email address type */
+type Email = string;
+/** Phone number type */
+type Phone = string;
+/** URL type */
+type Url = string;
+/** Money amount with currency */
+interface Money {
+    amount: number;
+    currency: string;
+}
+/** Address information */
+interface Address {
+    street: string;
+    city: string;
+    state?: string;
+    postalCode: string;
+    country: string;
+}
+/** Date range */
+interface DateRange {
+    startDate: Date;
+    endDate: Date;
+}
+/**
+ * User account status
+ */
+declare enum UserStatus {
+    ACTIVE = "ACTIVE",
+    INACTIVE = "INACTIVE",
+    SUSPENDED = "SUSPENDED",
+    PENDING = "PENDING"
+}
+/**
+ * Common status enumeration
+ */
+declare enum Status {
+    ACTIVE = "ACTIVE",
+    INACTIVE = "INACTIVE",
+    PENDING = "PENDING",
+    ARCHIVED = "ARCHIVED"
+}
+/**
+ * User roles enumeration
+ */
+declare enum UserRole {
+    ADMIN = "ADMIN",
+    USER = "USER",
+    GUEST = "GUEST"
+}
+/**
+ * Priority levels enumeration
+ */
+declare enum Priority {
+    LOW = "LOW",
+    MEDIUM = "MEDIUM",
+    HIGH = "HIGH",
+    URGENT = "URGENT"
+}
+/**
+ * Common currency codes
+ */
+declare enum CurrencyCode {
+    USD = "USD",
+    EUR = "EUR",
+    GBP = "GBP",
+    HUF = "HUF"
+}
+
+interface _User {
+    displayName?: string | null;
+    email: string;
+    firstName?: string;
+    language?: string;
+    lastName?: string;
+    phone?: string;
+    photoURL?: string | null;
+}
+type User = _User & Identifiable;
+
+/**
+ * Versioned entity interface for optimistic locking
+ */
+interface Versionable {
+    /** Version number */
+    version: number;
+}
+
+export { ActionEnum, CurrencyCode, CurrencyEnum, DEFAULT_PAGE_SIZE, EntityTypeEnum, MAX_PAGE_SIZE, MIN_SEARCH_LENGTH, PermissionsService, Priority, QueryConstraintTypeEnum, QueryOperatorEnum, RoleNames, Status, UserRole, UserStatus, currencies, isValidSearchTerm, normalizeSearchTerm };
+export type { Action, Address, CursorPaginatedResult, CursorPaginationOptions, CursorValue, DateRange, Deletable, Email, EntityId, Identifiable, Message, Meta, Money, PaginatedQueryOptions, PaginatedResult, PaginationOptions, ParamItem, Phone, QueryFilter, QueryOptions, QuerySort, QuerySortDirection, Role, SearchOptions, SearchParam, SearchParams, Searchable, SelectItem, SelectItemGroup, Url, User, UserId, Versionable, _Role, _User };