@rangka/core 0.0.1

package/dist/db/model-ops.js

@@ -0,0 +1,220 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { sql } from 'kysely';
+import { applyModelFilters, applySearchFilter } from './filter-applier.js';
+import { applyScopeEnforcement } from './scope-enforcer.js';
+import { modelToTableName } from './field-mapper.js';
+import { toCount } from '../helpers/coerce.js';
+import { NotFoundError } from '../errors.js';
+export class KyselyModelOps {
+    db;
+    model;
+    registry;
+    defaultAuth;
+    tableName;
+    constructor(config) {
+        this.db = config.db;
+        this.model = config.model;
+        this.registry = config.registry;
+        this.defaultAuth = config.auth;
+        this.tableName = config.tableName ?? config.model.qualifiedName;
+    }
+    async find(state) {
+        let query = this.buildBaseQuery(state);
+        query = this.applySelect(query, state);
+        query = this.applySorts(query, state);
+        query = this.applyPagination(query, state);
+        const data = await query.execute();
+        return { data: data };
+    }
+    async findWithMeta(state) {
+        const limit = state.limitVal ?? 25;
+        const page = state.pageVal ?? 1;
+        const offset = state.offsetVal ?? (page - 1) * limit;
+        let countQuery = this.buildBaseQuery(state);
+        countQuery = countQuery.select(sql `count(*)`.as('count'));
+        const countResult = await countQuery.executeTakeFirst();
+        const total = toCount(countResult);
+        const totalPages = Math.ceil(total / limit);
+        let query = this.buildBaseQuery(state);
+        query = this.applySelect(query, state);
+        query = this.applySorts(query, state);
+        query = query.limit(limit).offset(offset);
+        const data = await query.execute();
+        return {
+            data: data,
+            meta: { total, page, limit, totalPages },
+        };
+    }
+    async findOne(state) {
+        let query = this.buildBaseQuery(state);
+        query = this.applySelect(query, state);
+        query = this.applySorts(query, state);
+        query = query.limit(1);
+        const result = await query.executeTakeFirst();
+        return result ?? null;
+    }
+    async count(state) {
+        let query = this.buildBaseQuery(state);
+        query = query.select(sql `count(*)`.as('count'));
+        const result = await query.executeTakeFirst();
+        return toCount(result);
+    }
+    async get(id) {
+        let query = this.db.selectFrom(this.tableName).selectAll().where('id', '=', id);
+        if (this.model.traits.includes('soft_delete')) {
+            query = query.where('archived_at', 'is', null);
+        }
+        const result = await query.executeTakeFirst();
+        return result ?? null;
+    }
+    async create(data, _auth) {
+        await this.assignSequenceValues(data);
+        const record = await this.db
+            .insertInto(this.tableName)
+            .values(data)
+            .returningAll()
+            .executeTakeFirstOrThrow();
+        return record;
+    }
+    async update(id, data, _auth) {
+        await this.getOrThrow(id);
+        const record = await this.db
+            .updateTable(this.tableName)
+            .set(data)
+            .where('id', '=', id)
+            .returningAll()
+            .executeTakeFirstOrThrow();
+        return record;
+    }
+    async delete(id, _auth) {
+        const record = await this.getOrThrow(id);
+        await this.cascadeDeleteChildren(id);
+        if (this.model.traits.includes('soft_delete')) {
+            await this.db
+                .updateTable(this.tableName)
+                .set({ archived_at: new Date().toISOString() })
+                .where('id', '=', id)
+                .execute();
+        }
+        else {
+            await this.db.deleteFrom(this.tableName).where('id', '=', id).execute();
+        }
+        return record;
+    }
+    withTransaction(trx) {
+        return new KyselyModelOps({
+            db: trx,
+            model: this.model,
+            registry: this.registry,
+            auth: this.defaultAuth,
+            tableName: modelToTableName(this.model.qualifiedName),
+        });
+    }
+    compile(state) {
+        let query = this.buildBaseQuery(state);
+        query = this.applySelect(query, state);
+        query = this.applySorts(query, state);
+        query = this.applyPagination(query, state);
+        return query.compile();
+    }
+    compileCount(state) {
+        let query = this.buildBaseQuery(state);
+        query = query.select(sql `count(*)`.as('count'));
+        return query.compile();
+    }
+    buildBaseQuery(state) {
+        let query = this.db.selectFrom(this.tableName);
+        if (this.model.traits.includes('soft_delete') && !state.includeArchivedFlag) {
+            query = query.where('archived_at', 'is', null);
+        }
+        query = applyModelFilters(query, state.filters);
+        if (state.searchTerm && state.searchFields && state.searchFields.length > 0) {
+            query = applySearchFilter(query, state.searchTerm, state.searchFields);
+        }
+        if (!state.unscopedFlag && state.auth) {
+            query = applyScopeEnforcement(query, state.auth, {
+                model: this.model,
+                checkOwnership: true,
+            });
+        }
+        return query;
+    }
+    applySelect(query, state) {
+        return state.fieldNames.length > 0 ? query.select(state.fieldNames) : query.selectAll();
+    }
+    applySorts(query, state) {
+        for (const { field, direction } of state.sorts) {
+            query = query.orderBy(field, direction);
+        }
+        return query;
+    }
+    applyPagination(query, state) {
+        if (state.limitVal !== undefined) {
+            query = query.limit(state.limitVal);
+        }
+        if (state.offsetVal !== undefined) {
+            query = query.offset(state.offsetVal);
+        }
+        else if (state.pageVal !== undefined) {
+            const limit = state.limitVal ?? 25;
+            const offset = (state.pageVal - 1) * limit;
+            if (state.limitVal === undefined)
+                query = query.limit(limit);
+            query = query.offset(offset);
+        }
+        return query;
+    }
+    async assignSequenceValues(data) {
+        const sequenceFields = this.model.fields.filter((f) => f.config.type === 'sequence' && !data[f.name]);
+        if (sequenceFields.length === 0)
+            return;
+        for (const field of sequenceFields) {
+            const config = field.config;
+            const result = await this.db
+                .insertInto('naming_sequence')
+                .values({ model: this.model.qualifiedName, field: field.name, next_val: 1 })
+                .onConflict((oc) => oc
+                .columns(['model', 'field'])
+                .doUpdateSet({ next_val: sql `naming_sequence.next_val + 1` }))
+                .returning('next_val')
+                .executeTakeFirstOrThrow();
+            const num = String(result.next_val);
+            const padded = config.digits ? num.padStart(config.digits, '0') : num;
+            data[field.name] = (config.prefix ?? '') + padded;
+        }
+    }
+    async cascadeDeleteChildren(parentId) {
+        const childrenFields = this.model.fields.filter((f) => f.config.type === 'children');
+        if (childrenFields.length === 0)
+            return;
+        for (const field of childrenFields) {
+            const config = field.config;
+            const qualifiedChild = config.model.includes('.')
+                ? config.model
+                : `${this.model.module}.${config.model}`;
+            const childTable = modelToTableName(qualifiedChild);
+            const childModel = this.registry.getModel(qualifiedChild);
+            const isSoftDelete = childModel?.traits.includes('soft_delete');
+            if (isSoftDelete) {
+                await this.db
+                    .updateTable(childTable)
+                    .set({ archived_at: new Date().toISOString() })
+                    .where(config.foreignKey, '=', parentId)
+                    .execute();
+            }
+            else {
+                await this.db
+                    .deleteFrom(childTable)
+                    .where(config.foreignKey, '=', parentId)
+                    .execute();
+            }
+        }
+    }
+    async getOrThrow(id) {
+        const record = await this.get(id);
+        if (!record)
+            throw new NotFoundError(`Record not found: ${id}`);
+        return record;
+    }
+}
+//# sourceMappingURL=model-ops.js.map

package/dist/db/model-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-ops.js","sourceRoot":"","sources":["../../src/db/model-ops.ts"],"names":[],"mappings":"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"}

package/dist/db/scope-enforcer.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedModel } from '../schema/types.js';
+import type { RequestContext } from '../auth/types.js';
+export interface ScopeEnforcementOptions {
+    model?: ResolvedModel;
+    checkOwnership?: boolean;
+}
+export declare function applyScopeEnforcement(query: any, auth: RequestContext | undefined, options?: ScopeEnforcementOptions): any;
+//# sourceMappingURL=scope-enforcer.d.ts.map

package/dist/db/scope-enforcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-enforcer.d.ts","sourceRoot":"","sources":["../../src/db/scope-enforcer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,GAAG,EACV,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,uBAAuB,GAChC,GAAG,CAuBL"}

package/dist/db/scope-enforcer.js

@@ -0,0 +1,22 @@
+export function applyScopeEnforcement(query, auth, options) {
+    if (!auth)
+        return query;
+    let result = query;
+    if (auth.scopeFilters && auth.scopeFilters.length > 0) {
+        for (const filter of auth.scopeFilters) {
+            const operator = filter.operator === 'in' ? 'in' : '=';
+            result = result.where(filter.field, operator, filter.value);
+        }
+    }
+    if (options?.checkOwnership && options.model && auth.permissions && auth.user) {
+        const modelPerms = auth.permissions.models[options.model.qualifiedName];
+        if (modelPerms && modelPerms.read === 'own') {
+            const hasCreatedBy = options.model.fields.some((f) => f.name === 'created_by');
+            if (hasCreatedBy) {
+                result = result.where('created_by', '=', auth.user.id);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=scope-enforcer.js.map

package/dist/db/scope-enforcer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-enforcer.js","sourceRoot":"","sources":["../../src/db/scope-enforcer.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,qBAAqB,CACnC,KAAU,EACV,IAAgC,EAChC,OAAiC;IAEjC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAExB,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YACvD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,IAAI,OAAO,EAAE,cAAc,IAAI,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9E,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACxE,IAAI,UAAU,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC5C,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;YAC/E,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/db/types.d.ts

@@ -0,0 +1,76 @@
+export interface ColumnDefinition {
+    name: string;
+    type: string;
+    nullable: boolean;
+    defaultValue?: string;
+    primaryKey?: boolean;
+}
+export interface ForeignKeyDefinition {
+    name: string;
+    column: string;
+    referencedTable: string;
+    referencedColumn: string;
+}
+export interface CheckConstraintDefinition {
+    name: string;
+    column: string;
+    expression: string;
+}
+export interface IndexDefinition {
+    name: string;
+    table: string;
+    columns: string[];
+    unique: boolean;
+    where?: string;
+}
+export interface TableDefinition {
+    name: string;
+    columns: ColumnDefinition[];
+    foreignKeys: ForeignKeyDefinition[];
+    checkConstraints: CheckConstraintDefinition[];
+    indexes: IndexDefinition[];
+}
+export interface DesiredState {
+    tables: TableDefinition[];
+}
+export interface ActualColumn {
+    name: string;
+    type: string;
+    nullable: boolean;
+    defaultValue: string | null;
+}
+export interface ActualForeignKey {
+    name: string;
+    column: string;
+    referencedTable: string;
+    referencedColumn: string;
+}
+export interface ActualIndex {
+    name: string;
+    columns: string[];
+    unique: boolean;
+}
+export interface ActualCheckConstraint {
+    name: string;
+    column: string;
+    expression: string;
+}
+export interface ActualTable {
+    name: string;
+    columns: ActualColumn[];
+    foreignKeys: ActualForeignKey[];
+    indexes: ActualIndex[];
+    checkConstraints: ActualCheckConstraint[];
+}
+export interface ActualState {
+    tables: ActualTable[];
+}
+export type DdlOperationType = 'CREATE_TABLE' | 'ADD_COLUMN' | 'ALTER_COLUMN_TYPE' | 'ADD_FOREIGN_KEY' | 'ADD_CHECK_CONSTRAINT' | 'CREATE_INDEX' | 'DROP_COLUMN' | 'DROP_TABLE' | 'DROP_FOREIGN_KEY' | 'DROP_INDEX';
+export interface DdlOperation {
+    type: DdlOperationType;
+    table: string;
+    sql: string;
+    destructive: boolean;
+    detail?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/db/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/db/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,gBAAgB,EAAE,yBAAyB,EAAE,CAAC;IAC9C,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,YAAY,GACZ,mBAAmB,GACnB,iBAAiB,GACjB,sBAAsB,GACtB,cAAc,GACd,aAAa,GACb,YAAY,GACZ,kBAAkB,GAClB,YAAY,CAAC;AAEjB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/db/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/db/types.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,19 @@
+export declare class AppError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(statusCode: number, code: string, message: string, details?: unknown);
+}
+export declare class BadRequestError extends AppError {
+    constructor(code: string, message: string, details?: unknown);
+}
+export declare class UnauthorizedError extends AppError {
+    constructor(message: string);
+}
+export declare class ForbiddenError extends AppError {
+    constructor(code: string, message: string, details?: unknown);
+}
+export declare class NotFoundError extends AppError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEtB,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAOjF;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI7D;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI7D;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,37 @@
+export class AppError extends Error {
+    statusCode;
+    code;
+    details;
+    constructor(statusCode, code, message, details) {
+        super(message);
+        this.name = 'AppError';
+        this.statusCode = statusCode;
+        this.code = code;
+        this.details = details;
+    }
+}
+export class BadRequestError extends AppError {
+    constructor(code, message, details) {
+        super(400, code, message, details);
+        this.name = 'BadRequestError';
+    }
+}
+export class UnauthorizedError extends AppError {
+    constructor(message) {
+        super(401, 'UNAUTHORIZED', message);
+        this.name = 'UnauthorizedError';
+    }
+}
+export class ForbiddenError extends AppError {
+    constructor(code, message, details) {
+        super(403, code, message, details);
+        this.name = 'ForbiddenError';
+    }
+}
+export class NotFoundError extends AppError {
+    constructor(message) {
+        super(404, 'NOT_FOUND', message);
+        this.name = 'NotFoundError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,UAAU,CAAS;IACnB,IAAI,CAAS;IACb,OAAO,CAAW;IAElC,YAAY,UAAkB,EAAE,IAAY,EAAE,OAAe,EAAE,OAAiB;QAC9E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB;QAC1D,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1C,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB;QAC1D,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/events/__tests__/bus.test.d.ts

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

package/dist/events/__tests__/bus.test.d.ts.map

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

package/dist/events/__tests__/bus.test.js

@@ -0,0 +1,83 @@
+import { describe, it, expect, vi } from 'vitest';
+import { EventBus } from '../bus.js';
+describe('EventBus', () => {
+    it('registers listeners via on()', () => {
+        const bus = new EventBus();
+        const handler = vi.fn();
+        bus.on('order.created', handler);
+        expect(bus.hasListeners('order.created')).toBe(true);
+        expect(bus.getListeners('order.created')).toHaveLength(1);
+    });
+    it('supports multiple listeners per event', () => {
+        const bus = new EventBus();
+        const h1 = vi.fn();
+        const h2 = vi.fn();
+        bus.on('order.created', h1);
+        bus.on('order.created', h2);
+        expect(bus.getListeners('order.created')).toHaveLength(2);
+    });
+    it('returns false for events with no listeners', () => {
+        const bus = new EventBus();
+        expect(bus.hasListeners('nothing')).toBe(false);
+        expect(bus.getListeners('nothing')).toHaveLength(0);
+    });
+    it('getAllEvents returns all registered event names', () => {
+        const bus = new EventBus();
+        bus.on('a', vi.fn());
+        bus.on('b', vi.fn());
+        bus.on('c', vi.fn());
+        const events = bus.getAllEvents();
+        expect(events).toContain('a');
+        expect(events).toContain('b');
+        expect(events).toContain('c');
+    });
+    describe('sync emit', () => {
+        it('calls listeners inline with { sync: true }', async () => {
+            const bus = new EventBus();
+            const handler = vi.fn().mockResolvedValue(undefined);
+            bus.on('test.event', handler);
+            await bus.emit('test.event', { id: 1 }, { sync: true });
+            expect(handler).toHaveBeenCalledWith({ id: 1 });
+        });
+        it('calls multiple listeners in order', async () => {
+            const bus = new EventBus();
+            const order = [];
+            bus.on('test', async () => {
+                order.push(1);
+            });
+            bus.on('test', async () => {
+                order.push(2);
+            });
+            await bus.emit('test', {}, { sync: true });
+            expect(order).toEqual([1, 2]);
+        });
+        it('does nothing if no listeners registered', async () => {
+            const bus = new EventBus();
+            await expect(bus.emit('unknown', {}, { sync: true })).resolves.toBeUndefined();
+        });
+    });
+    describe('async emit', () => {
+        it('throws if db not set', async () => {
+            const bus = new EventBus();
+            bus.on('test', vi.fn());
+            await expect(bus.emit('test', {})).rejects.toThrow('database not set');
+        });
+        it('emitWithTrx in sync mode calls handlers directly', async () => {
+            const bus = new EventBus();
+            const handler = vi.fn().mockResolvedValue(undefined);
+            bus.on('test', handler);
+            const mockTrx = {};
+            await bus.emitWithTrx('test', { data: 'hi' }, mockTrx, { sync: true });
+            expect(handler).toHaveBeenCalledWith({ data: 'hi' });
+        });
+    });
+    describe('listener source tracking', () => {
+        it('stores source on listener', () => {
+            const bus = new EventBus();
+            bus.on('test', vi.fn(), 'sales-module');
+            const listeners = bus.getListeners('test');
+            expect(listeners[0].source).toBe('sales-module');
+        });
+    });
+});
+//# sourceMappingURL=bus.test.js.map

package/dist/events/__tests__/bus.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.test.js","sourceRoot":"","sources":["../../../src/events/__tests__/bus.test.ts"],"names":[],"mappings":"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"}

package/dist/events/bus.d.ts

@@ -0,0 +1,40 @@
+import type { Kysely } from 'kysely';
+import type { EventListener } from './types.js';
+/**
+ * Simple pub/sub event bus that supports two dispatch modes:
+ * - sync: invoke listeners directly in sequence
+ * - async (default): enqueue the event as a background job via the database
+ */
+export declare class EventBus {
+    private readonly listeners;
+    private db;
+    /** Provide the database connection used for async event dispatch. */
+    setDb(db: Kysely<unknown>): void;
+    /** Register a listener for a specific event. */
+    on(event: string, handler: (payload: unknown) => Promise<void>, source?: string): void;
+    /**
+     * Emit an event. By default, the event is enqueued as a background job.
+     * Pass { sync: true } to invoke listeners immediately in sequence.
+     */
+    emit(event: string, payload: unknown, options?: {
+        sync?: boolean;
+    }): Promise<void>;
+    /**
+     * Emit an event within an existing database transaction.
+     * Sync mode invokes listeners directly; async mode enqueues via the transaction.
+     */
+    emitWithTrx(event: string, payload: unknown, trx: Kysely<unknown>, options?: {
+        sync?: boolean;
+    }): Promise<void>;
+    /** Return all listeners registered for a given event. */
+    getListeners(event: string): EventListener[];
+    /** Return the names of all events that have at least one listener. */
+    getAllEvents(): string[];
+    /** Check whether any listeners are registered for a given event. */
+    hasListeners(event: string): boolean;
+    /** Invoke all listeners for an event synchronously, one after another. */
+    private dispatchSync;
+    /** Enqueue the event as a background job via the database. */
+    private dispatchAsync;
+}
+//# sourceMappingURL=bus.d.ts.map

package/dist/events/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/events/bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2C;IACrE,OAAO,CAAC,EAAE,CAAgC;IAE1C,qEAAqE;IACrE,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI;IAIhC,gDAAgD;IAChD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAOtF;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxF;;;OAGG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,EACpB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3B,OAAO,CAAC,IAAI,CAAC;IAQhB,yDAAyD;IACzD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE;IAI5C,sEAAsE;IACtE,YAAY,IAAI,MAAM,EAAE;IAIxB,oEAAoE;IACpE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAOpC,0EAA0E;YAC5D,YAAY;IAO1B,8DAA8D;YAChD,aAAa;CAM5B"}

package/dist/events/bus.js

@@ -0,0 +1,74 @@
+import { enqueue } from '../jobs/enqueue.js';
+/**
+ * Simple pub/sub event bus that supports two dispatch modes:
+ * - sync: invoke listeners directly in sequence
+ * - async (default): enqueue the event as a background job via the database
+ */
+export class EventBus {
+    listeners = new Map();
+    db = null;
+    /** Provide the database connection used for async event dispatch. */
+    setDb(db) {
+        this.db = db;
+    }
+    /** Register a listener for a specific event. */
+    on(event, handler, source) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, []);
+        }
+        this.listeners.get(event).push({ event, handler, source });
+    }
+    /**
+     * Emit an event. By default, the event is enqueued as a background job.
+     * Pass { sync: true } to invoke listeners immediately in sequence.
+     */
+    async emit(event, payload, options) {
+        if (options?.sync) {
+            await this.dispatchSync(event, payload);
+        }
+        else {
+            await this.dispatchAsync(event, payload);
+        }
+    }
+    /**
+     * Emit an event within an existing database transaction.
+     * Sync mode invokes listeners directly; async mode enqueues via the transaction.
+     */
+    async emitWithTrx(event, payload, trx, options) {
+        if (options?.sync) {
+            await this.dispatchSync(event, payload);
+        }
+        else {
+            await enqueue(trx, `__event:${event}`, payload);
+        }
+    }
+    /** Return all listeners registered for a given event. */
+    getListeners(event) {
+        return this.listeners.get(event) ?? [];
+    }
+    /** Return the names of all events that have at least one listener. */
+    getAllEvents() {
+        return Array.from(this.listeners.keys());
+    }
+    /** Check whether any listeners are registered for a given event. */
+    hasListeners(event) {
+        const eventListeners = this.listeners.get(event);
+        return !!eventListeners && eventListeners.length > 0;
+    }
+    // --- Private dispatch methods ---
+    /** Invoke all listeners for an event synchronously, one after another. */
+    async dispatchSync(event, payload) {
+        const eventListeners = this.listeners.get(event) ?? [];
+        for (const listener of eventListeners) {
+            await listener.handler(payload);
+        }
+    }
+    /** Enqueue the event as a background job via the database. */
+    async dispatchAsync(event, payload) {
+        if (!this.db) {
+            throw new Error('EventBus: database not set. Call setDb() before emitting async events.');
+        }
+        await enqueue(this.db, `__event:${event}`, payload);
+    }
+}
+//# sourceMappingURL=bus.js.map