@go-mondo/identity-sdk 0.0.1 → 0.0.2-beta.12

package/dist/cjs/authorization/roles/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/authorization/roles/schema.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,UAAU;;;CAGb,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;MAE/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,oBAAoB,CAAC,QAAQ,CAAC;AAIlE,eAAO,MAAM,sBAAsB;;;;MAIjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,sBAAsB,CAAC,QAAQ,CAAC;AAWtE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;MAOU,CAAC;AAClC,MAAM,MAAM,cAAc,GAAG,OAAO,UAAU,CAAC,OAAO,CAAC;AACvD,MAAM,MAAM,IAAI,GAAG,OAAO,UAAU,CAAC,QAAQ,CAAC;AAE9C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;MAOO,CAAC;AACtC,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,QAAQ,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;MAOO,CAAC;AAC5C,MAAM,MAAM,eAAe,GAAG,OAAO,uBAAuB,CAAC,OAAO,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,OAAO,uBAAuB,CAAC,QAAQ,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;MAIO,CAAC;AAC5C,MAAM,MAAM,eAAe,GAAG,OAAO,uBAAuB,CAAC,OAAO,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,OAAO,uBAAuB,CAAC,QAAQ,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;MAIzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAClC,OAAO,8BAA8B,CAAC,QAAQ,CAAC"}

package/dist/cjs/authorization/roles/schema.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoleAssociationReferenceSchema = exports.UpdateRolePayloadSchema = exports.InsertRolePayloadSchema = exports.RolePayloadSchema = exports.RoleSchema = exports.RoleAssociationsSchema = exports.RoleIdPropertySchema = exports.RoleStatus = void 0;
+const arktype_1 = require("arktype");
+const schema_js_1 = require("../../app/schema.js");
+const index_js_1 = require("../../common/index.js");
+const aggregate_js_1 = require("../../common/schema/aggregate.js");
+const metadata_js_1 = require("../../common/schema/metadata.js");
+const schema_js_2 = require("../../customer/schema.js");
+const schema_js_3 = require("../schema.js");
+exports.RoleStatus = {
+    ENABLED: 'enabled',
+    DISABLED: 'disabled',
+};
+exports.RoleIdPropertySchema = (0, arktype_1.type)({
+    id: schema_js_3.RoleIdSchema,
+});
+const StatusSchema = arktype_1.type.enumerated(exports.RoleStatus.ENABLED, exports.RoleStatus.DISABLED);
+exports.RoleAssociationsSchema = (0, arktype_1.type)({
+    apps: schema_js_1.AppIdAssociationsSchema.optional(),
+    permissions: schema_js_3.PermissionIdAssociationsSchema.optional(),
+    users: schema_js_2.UserIdAssociationsSchema.optional(),
+});
+const BaseSchema = exports.RoleIdPropertySchema.and({
+    name: (0, arktype_1.type)('string'),
+    status: StatusSchema,
+    description: (0, arktype_1.type)('string').optional(),
+    apps: aggregate_js_1.AggregateSchema.optional(),
+    users: aggregate_js_1.AggregateSchema.optional(),
+    permissions: aggregate_js_1.AggregateSchema.optional(),
+});
+exports.RoleSchema = BaseSchema.and({
+    createdAt: index_js_1.RequiredDateSchema,
+    updatedAt: index_js_1.RequiredDateSchema,
+    'deletedAt?': index_js_1.OptionalDateSchema,
+    'deactivatedAt?': index_js_1.OptionalDateSchema,
+})
+    .and(exports.RoleIdPropertySchema)
+    .and(metadata_js_1.MetadataMapPropertySchema);
+exports.RolePayloadSchema = BaseSchema.and({
+    createdAt: index_js_1.RequiredDatePayloadSchema,
+    updatedAt: index_js_1.RequiredDatePayloadSchema,
+    'deletedAt?': index_js_1.OptionalDatePayloadSchema,
+    'deactivatedAt?': index_js_1.OptionalDatePayloadSchema,
+})
+    .and(exports.RoleIdPropertySchema)
+    .and(metadata_js_1.MetadataPayloadPropertySchema);
+/**
+ * Insert
+ */
+exports.InsertRolePayloadSchema = (0, arktype_1.type)({
+    id: schema_js_3.RoleIdSchema.default(() => (0, schema_js_3.generateRoleId)()),
+    name: (0, arktype_1.type)('string'),
+    status: StatusSchema.default(exports.RoleStatus.ENABLED),
+    description: (0, arktype_1.type)('string').optional(),
+})
+    .and(exports.RoleAssociationsSchema)
+    .and(metadata_js_1.UpsertMetadataPropertyPayloadSchema);
+/**
+ * Update
+ */
+exports.UpdateRolePayloadSchema = (0, arktype_1.type)({
+    name: (0, arktype_1.type)('string').optional(),
+    status: StatusSchema.optional(),
+    description: (0, arktype_1.type)('string').optional(),
+}).and(metadata_js_1.UpsertMetadataPropertyPayloadSchema);
+/**
+ * Association
+ */
+exports.RoleAssociationReferenceSchema = exports.RoleIdPropertySchema.and({
+    name: (0, arktype_1.type)('string'),
+    status: StatusSchema.default('disabled'),
+    model: "'Role'",
+});

package/dist/cjs/authorization/roles/schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.test.d.ts.map

package/dist/cjs/authorization/roles/schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.test.d.ts","sourceRoot":"","sources":["../../../../src/authorization/roles/schema.test.ts"],"names":[],"mappings":""}

package/dist/cjs/authorization/roles/schema.test.js

@@ -0,0 +1,236 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const arktype_1 = require("arktype");
+const vitest_1 = require("vitest");
+const utils_js_1 = require("../../app/utils.js");
+const schema_js_1 = require("../../customer/schema.js");
+const schema_js_2 = require("../schema.js");
+const schema_js_3 = require("./schema.js");
+(0, vitest_1.describe)('Authorization Roles - Schema', () => {
+    (0, vitest_1.describe)('RoleStatus constants', () => {
+        (0, vitest_1.test)('should have correct status values', () => {
+            (0, vitest_1.expect)(schema_js_3.RoleStatus.ENABLED).toBe('enabled');
+            (0, vitest_1.expect)(schema_js_3.RoleStatus.DISABLED).toBe('disabled');
+        });
+    });
+    (0, vitest_1.describe)('RoleIdPropertySchema', () => {
+        (0, vitest_1.test)('should accept valid id property', () => {
+            const payload = { id: (0, schema_js_2.generateRoleId)() };
+            const result = (0, schema_js_3.RoleIdPropertySchema)(payload);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+            (0, vitest_1.expect)(result).toEqual({ id: payload.id });
+        });
+        (0, vitest_1.test)('should reject missing id', () => {
+            const result = (0, schema_js_3.RoleIdPropertySchema)({});
+            (0, vitest_1.expect)(result).toBeInstanceOf(arktype_1.type.errors);
+        });
+    });
+    (0, vitest_1.describe)('RoleAssociationsSchema', () => {
+        (0, vitest_1.test)('should accept valid associations', () => {
+            const payload = {
+                apps: [(0, utils_js_1.generateAppId)(), (0, utils_js_1.generateAppId)()],
+                permissions: [(0, schema_js_2.generatePermissionId)(), (0, schema_js_2.generatePermissionId)()],
+                users: [(0, schema_js_1.generateUserId)(), (0, schema_js_1.generateUserId)()],
+            };
+            const result = (0, schema_js_3.RoleAssociationsSchema)(payload);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+            (0, vitest_1.expect)(result).toEqual({
+                apps: payload.apps,
+                permissions: payload.permissions,
+                users: payload.users,
+            });
+        });
+        (0, vitest_1.test)('should accept optional associations', () => {
+            const result = (0, schema_js_3.RoleAssociationsSchema)({});
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+            (0, vitest_1.expect)(result).toEqual({});
+        });
+        (0, vitest_1.test)('should accept partial associations', () => {
+            const result = (0, schema_js_3.RoleAssociationsSchema)({
+                permissions: [(0, schema_js_2.generatePermissionId)()],
+                users: undefined,
+            });
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+        });
+        (0, vitest_1.test)('should reject non-array associations', () => {
+            const result = (0, schema_js_3.RoleAssociationsSchema)({
+                apps: 'not-an-array',
+            });
+            (0, vitest_1.expect)(result).toBeInstanceOf(arktype_1.type.errors);
+        });
+    });
+    (0, vitest_1.describe)('RoleSchema', () => {
+        (0, vitest_1.test)('should accept complete role object', () => {
+            const role = {
+                id: (0, schema_js_2.generateRoleId)(),
+                name: 'admin',
+                status: 'enabled',
+                description: 'Administrator role',
+                apps: { ids: [(0, utils_js_1.generateAppId)()], count: 1 },
+                users: { ids: [(0, schema_js_1.generateUserId)()], count: 1 },
+                permissions: { ids: [(0, schema_js_2.generatePermissionId)()], count: 1 },
+                createdAt: new Date(),
+                updatedAt: new Date(),
+                metadata: { key: 'value' },
+            };
+            const result = (0, schema_js_3.RoleSchema)(role);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+        });
+        (0, vitest_1.test)('should accept minimal role object', () => {
+            const role = {
+                id: (0, schema_js_2.generateRoleId)(),
+                name: 'user',
+                status: 'enabled',
+                createdAt: new Date(),
+                updatedAt: new Date(),
+                metadata: {},
+            };
+            const result = (0, schema_js_3.RoleSchema)(role);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+        });
+        (0, vitest_1.test)('should accept role with optional dates', () => {
+            const role = {
+                id: (0, schema_js_2.generateRoleId)(),
+                name: 'user',
+                status: 'disabled',
+                createdAt: new Date(),
+                updatedAt: new Date(),
+                deletedAt: new Date(),
+                deactivatedAt: new Date(),
+                metadata: {},
+            };
+            const result = (0, schema_js_3.RoleSchema)(role);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+        });
+        (0, vitest_1.test)('should reject invalid status', () => {
+            const role = {
+                id: (0, schema_js_2.generateRoleId)(),
+                name: 'admin',
+                status: 'invalid',
+                createdAt: new Date(),
+                updatedAt: new Date(),
+                metadata: {},
+            };
+            const result = (0, schema_js_3.RoleSchema)(role);
+            (0, vitest_1.expect)(result).toBeInstanceOf(arktype_1.type.errors);
+        });
+        (0, vitest_1.test)('should reject missing required fields', () => {
+            const role = {
+                id: (0, schema_js_2.generateRoleId)(),
+                name: 'admin',
+            };
+            const result = (0, schema_js_3.RoleSchema)(role);
+            (0, vitest_1.expect)(result).toBeInstanceOf(arktype_1.type.errors);
+        });
+    });
+    (0, vitest_1.describe)('InsertRolePayloadSchema', () => {
+        (0, vitest_1.test)('should accept complete insert payload', () => {
+            const payload = {
+                id: (0, schema_js_2.generateRoleId)(),
+                name: 'admin',
+                status: 'enabled',
+                description: 'Administrator role',
+                apps: [(0, utils_js_1.generateAppId)()],
+                permissions: [(0, schema_js_2.generatePermissionId)()],
+                users: [(0, schema_js_1.generateUserId)()],
+                metadata: { key: 'value' },
+            };
+            const result = (0, schema_js_3.InsertRolePayloadSchema)(payload);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+        });
+        (0, vitest_1.test)('should accept minimal insert payload', () => {
+            const payload = {
+                name: 'user',
+            };
+            const result = (0, schema_js_3.InsertRolePayloadSchema)(payload);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+            (0, vitest_1.expect)(result.status).toBe('enabled'); // default value
+        });
+        (0, vitest_1.test)('should generate default ID when not provided', () => {
+            const payload = { name: 'admin' };
+            const result = (0, schema_js_3.InsertRolePayloadSchema)(payload);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+            (0, vitest_1.expect)(result.id).toMatch(/^rol_/);
+        });
+        (0, vitest_1.test)('should reject missing name', () => {
+            const result = (0, schema_js_3.InsertRolePayloadSchema)({});
+            (0, vitest_1.expect)(result).toBeInstanceOf(arktype_1.type.errors);
+        });
+        (0, vitest_1.test)('should accept associations in insert payload', () => {
+            const payload = {
+                name: 'moderator',
+                apps: [(0, utils_js_1.generateAppId)(), (0, utils_js_1.generateAppId)()],
+                permissions: [(0, schema_js_2.generatePermissionId)(), (0, schema_js_2.generatePermissionId)()],
+                users: [(0, schema_js_1.generateUserId)()],
+            };
+            const result = (0, schema_js_3.InsertRolePayloadSchema)(payload);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+        });
+    });
+    (0, vitest_1.describe)('UpdateRolePayloadSchema', () => {
+        (0, vitest_1.test)('should accept all optional fields', () => {
+            const payload = {
+                name: 'updated-role',
+                status: 'disabled',
+                description: 'Updated description',
+                metadata: { updated: true },
+            };
+            const result = (0, schema_js_3.UpdateRolePayloadSchema)(payload);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+            (0, vitest_1.expect)(result).toEqual(payload);
+        });
+        (0, vitest_1.test)('should accept empty update payload', () => {
+            const result = (0, schema_js_3.UpdateRolePayloadSchema)({});
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+            (0, vitest_1.expect)(result).toEqual({});
+        });
+        (0, vitest_1.test)('should accept partial updates', () => {
+            const payload = { name: 'new-name' };
+            const result = (0, schema_js_3.UpdateRolePayloadSchema)(payload);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+            (0, vitest_1.expect)(result).toEqual(payload);
+        });
+        (0, vitest_1.test)('should reject invalid status', () => {
+            const payload = { status: 'invalid-status' };
+            const result = (0, schema_js_3.UpdateRolePayloadSchema)(payload);
+            (0, vitest_1.expect)(result).toBeInstanceOf(arktype_1.type.errors);
+        });
+    });
+    (0, vitest_1.describe)('RoleAssociationReferenceSchema', () => {
+        (0, vitest_1.test)('should accept complete association reference', () => {
+            const reference = {
+                id: (0, schema_js_2.generateRoleId)(),
+                name: 'admin',
+                status: 'enabled',
+                model: 'Role',
+            };
+            const result = (0, schema_js_3.RoleAssociationReferenceSchema)(reference);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+            (0, vitest_1.expect)(result).toEqual(reference);
+        });
+        (0, vitest_1.test)('should use default status when not provided', () => {
+            const reference = {
+                id: (0, schema_js_2.generateRoleId)(),
+                name: 'admin',
+                model: 'Role',
+            };
+            const result = (0, schema_js_3.RoleAssociationReferenceSchema)(reference);
+            (0, vitest_1.expect)(result).not.toBeInstanceOf(arktype_1.type.errors);
+            (0, vitest_1.expect)(result.status).toBe('disabled'); // default value
+        });
+        (0, vitest_1.test)('should reject missing required fields', () => {
+            const reference = { id: (0, schema_js_2.generateRoleId)() };
+            const result = (0, schema_js_3.RoleAssociationReferenceSchema)(reference);
+            (0, vitest_1.expect)(result).toBeInstanceOf(arktype_1.type.errors);
+        });
+        (0, vitest_1.test)('should reject invalid model value', () => {
+            const reference = {
+                id: (0, schema_js_2.generateRoleId)(),
+                name: 'admin',
+                model: 'InvalidModel',
+            };
+            const result = (0, schema_js_3.RoleAssociationReferenceSchema)(reference);
+            (0, vitest_1.expect)(result).toBeInstanceOf(arktype_1.type.errors);
+        });
+    });
+});

package/dist/cjs/authorization/schema.d.ts

@@ -0,0 +1,17 @@
+export declare const Model: {
+    readonly Permission: {
+        readonly UIDPrefix: "per";
+    };
+    readonly Role: {
+        readonly UIDPrefix: "rol";
+    };
+};
+export declare function generatePermissionId(): string;
+export declare function generateRoleId(): string;
+export declare const RoleIdSchema: import("arktype/out/methods/string.js").StringType<string, {}>;
+export type RoleId = typeof RoleIdSchema.inferOut;
+export declare const RoleIdAssociationsSchema: import("arktype").BaseType<string[] | undefined, {}>;
+export declare const PermissionIdSchema: import("arktype/out/methods/string.js").StringType<string, {}>;
+export type PermissionId = typeof PermissionIdSchema.inferOut;
+export declare const PermissionIdAssociationsSchema: import("arktype").BaseType<string[] | undefined, {}>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/cjs/authorization/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/authorization/schema.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,KAAK;;;;;;;CAOR,CAAC;AAEX,wBAAgB,oBAAoB,WAEnC;AAED,wBAAgB,cAAc,WAE7B;AAED,eAAO,MAAM,YAAY,gEAAoC,CAAC;AAC9D,MAAM,MAAM,MAAM,GAAG,OAAO,YAAY,CAAC,QAAQ,CAAC;AAElD,eAAO,MAAM,wBAAwB,sDAEpC,CAAC;AAEF,eAAO,MAAM,kBAAkB,gEAA0C,CAAC;AAC1E,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,QAAQ,CAAC;AAE9D,eAAO,MAAM,8BAA8B,sDAE1C,CAAC"}

package/dist/cjs/authorization/schema.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PermissionIdAssociationsSchema = exports.PermissionIdSchema = exports.RoleIdAssociationsSchema = exports.RoleIdSchema = exports.Model = void 0;
+exports.generatePermissionId = generatePermissionId;
+exports.generateRoleId = generateRoleId;
+const arktype_1 = require("arktype");
+const ksuid_1 = __importDefault(require("ksuid"));
+const id_js_1 = require("../common/schema/id.js");
+exports.Model = {
+    Permission: {
+        UIDPrefix: 'per',
+    },
+    Role: {
+        UIDPrefix: 'rol',
+    },
+};
+function generatePermissionId() {
+    return `${exports.Model.Permission.UIDPrefix}_${ksuid_1.default.randomSync().string}`;
+}
+function generateRoleId() {
+    return `${exports.Model.Role.UIDPrefix}_${ksuid_1.default.randomSync().string}`;
+}
+exports.RoleIdSchema = (0, id_js_1.KSUIDSchema)(exports.Model.Role.UIDPrefix);
+exports.RoleIdAssociationsSchema = (0, arktype_1.type)('undefined').or(exports.RoleIdSchema.array());
+exports.PermissionIdSchema = (0, id_js_1.KSUIDSchema)(exports.Model.Permission.UIDPrefix);
+exports.PermissionIdAssociationsSchema = (0, arktype_1.type)('undefined').or(exports.PermissionIdSchema.array());

package/dist/cjs/authorization/schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.test.d.ts.map

package/dist/cjs/authorization/schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.test.d.ts","sourceRoot":"","sources":["../../../src/authorization/schema.test.ts"],"names":[],"mappings":""}

package/dist/cjs/authorization/schema.test.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const schema_js_1 = require("./schema.js");
+(0, vitest_1.describe)('Authorization - Utils', () => {
+    (0, vitest_1.describe)('Model constants', () => {
+        (0, vitest_1.test)('should have correct UID prefixes', () => {
+            (0, vitest_1.expect)(schema_js_1.Model.Permission.UIDPrefix).toBe('per');
+            (0, vitest_1.expect)(schema_js_1.Model.Role.UIDPrefix).toBe('rol');
+        });
+    });
+    (0, vitest_1.describe)('generatePermissionId', () => {
+        (0, vitest_1.test)('should generate ID with correct prefix', () => {
+            const id = (0, schema_js_1.generatePermissionId)();
+            (0, vitest_1.expect)(id).toMatch(/^per_[A-Za-z0-9]+$/);
+        });
+        (0, vitest_1.test)('should generate unique IDs', () => {
+            const id1 = (0, schema_js_1.generatePermissionId)();
+            const id2 = (0, schema_js_1.generatePermissionId)();
+            (0, vitest_1.expect)(id1).not.toBe(id2);
+        });
+        (0, vitest_1.test)('should generate IDs with correct length', () => {
+            const id = (0, schema_js_1.generatePermissionId)();
+            (0, vitest_1.expect)(id.length).toBeGreaterThan(4); // prefix + underscore + KSUID
+        });
+    });
+    (0, vitest_1.describe)('generateRoleId', () => {
+        (0, vitest_1.test)('should generate ID with correct prefix', () => {
+            const id = (0, schema_js_1.generateRoleId)();
+            (0, vitest_1.expect)(id).toMatch(/^rol_[A-Za-z0-9]+$/);
+        });
+        (0, vitest_1.test)('should generate unique IDs', () => {
+            const id1 = (0, schema_js_1.generateRoleId)();
+            const id2 = (0, schema_js_1.generateRoleId)();
+            (0, vitest_1.expect)(id1).not.toBe(id2);
+        });
+        (0, vitest_1.test)('should generate IDs with correct length', () => {
+            const id = (0, schema_js_1.generateRoleId)();
+            (0, vitest_1.expect)(id.length).toBeGreaterThan(4); // prefix + underscore + KSUID
+        });
+    });
+});

package/dist/cjs/common/errors/http.d.ts

@@ -0,0 +1,17 @@
+export type HttpErrorOptions = {
+    statusCode?: number;
+    type?: string;
+    trace?: string;
+    body?: {
+        [key: string]: string;
+    };
+};
+export declare class HttpError extends Error {
+    readonly statusCode: number;
+    readonly type: string;
+    readonly trace?: HttpErrorOptions['trace'];
+    readonly body?: HttpErrorOptions['body'];
+    constructor(message?: string, options?: HttpErrorOptions);
+    get isAuthorizationError(): boolean;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/cjs/common/errors/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../../src/common/errors/http.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE;QACL,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAEF,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBAGvC,OAAO,SAA+D,EACtE,OAAO,CAAC,EAAE,gBAAgB;IAQ5B,IAAI,oBAAoB,IAAI,OAAO,CAElC;CACF"}

package/dist/cjs/common/errors/http.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpError = void 0;
+class HttpError extends Error {
+    statusCode;
+    type;
+    trace;
+    body;
+    constructor(message = 'An unknown error occurred. Please try the operation again.', options) {
+        super(message);
+        this.statusCode = options?.statusCode || 500;
+        this.type = options?.type || 'Unknown';
+    }
+    get isAuthorizationError() {
+        return [401, 403].includes(this.statusCode);
+    }
+}
+exports.HttpError = HttpError;

package/dist/cjs/common/errors/http.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http.test.d.ts.map

package/dist/cjs/common/errors/http.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.test.d.ts","sourceRoot":"","sources":["../../../../src/common/errors/http.test.ts"],"names":[],"mappings":""}

package/dist/cjs/common/errors/http.test.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const http_js_1 = require("./http.js");
+(0, vitest_1.describe)('Common Errors - HTTP', () => {
+    (0, vitest_1.describe)('HttpError', () => {
+        (0, vitest_1.test)('should create error with default message and status', () => {
+            const error = new http_js_1.HttpError();
+            (0, vitest_1.expect)(error.message).toBe('An unknown error occurred. Please try the operation again.');
+            (0, vitest_1.expect)(error.statusCode).toBe(500);
+            (0, vitest_1.expect)(error.type).toBe('Unknown');
+            (0, vitest_1.expect)(error.trace).toBeUndefined();
+            (0, vitest_1.expect)(error.body).toBeUndefined();
+        });
+        (0, vitest_1.test)('should create error with custom message', () => {
+            const error = new http_js_1.HttpError('Custom error message');
+            (0, vitest_1.expect)(error.message).toBe('Custom error message');
+            (0, vitest_1.expect)(error.statusCode).toBe(500);
+            (0, vitest_1.expect)(error.type).toBe('Unknown');
+        });
+        (0, vitest_1.test)('should create error with custom options', () => {
+            const options = {
+                statusCode: 404,
+                type: 'NotFound',
+                trace: 'trace-123',
+                body: { resource: 'user' },
+            };
+            const error = new http_js_1.HttpError('Resource not found', options);
+            (0, vitest_1.expect)(error.message).toBe('Resource not found');
+            (0, vitest_1.expect)(error.statusCode).toBe(404);
+            (0, vitest_1.expect)(error.type).toBe('NotFound');
+            (0, vitest_1.expect)(error.trace).toBeUndefined(); // trace is not assigned in constructor
+            (0, vitest_1.expect)(error.body).toBeUndefined(); // body is not assigned in constructor
+        });
+        (0, vitest_1.test)('should handle partial options', () => {
+            const error = new http_js_1.HttpError('Test error', { statusCode: 400 });
+            (0, vitest_1.expect)(error.message).toBe('Test error');
+            (0, vitest_1.expect)(error.statusCode).toBe(400);
+            (0, vitest_1.expect)(error.type).toBe('Unknown');
+            (0, vitest_1.expect)(error.trace).toBeUndefined();
+            (0, vitest_1.expect)(error.body).toBeUndefined();
+        });
+        (0, vitest_1.test)('should be instance of Error', () => {
+            const error = new http_js_1.HttpError();
+            (0, vitest_1.expect)(error).toBeInstanceOf(Error);
+            (0, vitest_1.expect)(error).toBeInstanceOf(http_js_1.HttpError);
+        });
+        (0, vitest_1.describe)('isAuthorizationError', () => {
+            (0, vitest_1.test)('should return true for 401 status', () => {
+                const error = new http_js_1.HttpError('Unauthorized', { statusCode: 401 });
+                (0, vitest_1.expect)(error.isAuthorizationError).toBe(true);
+            });
+            (0, vitest_1.test)('should return true for 403 status', () => {
+                const error = new http_js_1.HttpError('Forbidden', { statusCode: 403 });
+                (0, vitest_1.expect)(error.isAuthorizationError).toBe(true);
+            });
+            (0, vitest_1.test)('should return false for other status codes', () => {
+                const error400 = new http_js_1.HttpError('Bad Request', { statusCode: 400 });
+                const error404 = new http_js_1.HttpError('Not Found', { statusCode: 404 });
+                const error500 = new http_js_1.HttpError('Internal Error', { statusCode: 500 });
+                (0, vitest_1.expect)(error400.isAuthorizationError).toBe(false);
+                (0, vitest_1.expect)(error404.isAuthorizationError).toBe(false);
+                (0, vitest_1.expect)(error500.isAuthorizationError).toBe(false);
+            });
+            (0, vitest_1.test)('should return false for default status code', () => {
+                const error = new http_js_1.HttpError();
+                (0, vitest_1.expect)(error.isAuthorizationError).toBe(false);
+            });
+        });
+    });
+});

package/dist/cjs/common/errors/validation.d.ts

@@ -0,0 +1,11 @@
+import { HttpError, type HttpErrorOptions } from './http.js';
+export type ValidationErrorOptions = HttpErrorOptions & {
+    fields: {
+        [key: string]: string;
+    };
+};
+export declare class ValidationError extends HttpError {
+    readonly fields: ValidationErrorOptions['fields'];
+    constructor(message: string, options: ValidationErrorOptions);
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/cjs/common/errors/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/common/errors/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG;IACtD,MAAM,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACnC,CAAC;AAEF,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;gBAE/B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB;CAIpE"}

package/dist/cjs/common/errors/validation.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = void 0;
+const http_js_1 = require("./http.js");
+class ValidationError extends http_js_1.HttpError {
+    fields;
+    constructor(message, options) {
+        super(message, options);
+        this.fields = options?.fields;
+    }
+}
+exports.ValidationError = ValidationError;

package/dist/cjs/common/errors/validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

package/dist/cjs/common/errors/validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.d.ts","sourceRoot":"","sources":["../../../../src/common/errors/validation.test.ts"],"names":[],"mappings":""}