@m5kdev/backend 0.1.0 → 0.1.2

package/dist/src/modules/base/base.repository.d.ts

@@ -0,0 +1,97 @@
+import type { QueryFilters, QueryInput } from "@m5kdev/commons/modules/schemas/query.schema";
+import { type InferInsertModel, type InferSelectModel, type SelectedFields, type SQL } from "drizzle-orm";
+import type { LibSQLDatabase } from "drizzle-orm/libsql";
+import type { SQLiteColumn, SQLiteTableWithColumns } from "drizzle-orm/sqlite-core";
+import { Base } from "#modules/base/base.abstract";
+import { pickColumns, type ServerResultAsync } from "#modules/base/base.dto";
+/** Payload for update/updateMany: id key required (string), other table fields optional. */
+export type TableUpdatePayload<TTable extends SQLiteTableWithColumns<any>, TIdKey extends Extract<keyof InferSelectModel<TTable>, string> = "id"> = Record<TIdKey, string> & Partial<Omit<InferSelectModel<TTable>, TIdKey>>;
+export declare class ConditionBuilder {
+    private conditions;
+    constructor(conditions?: SQL[]);
+    push(condition?: SQL): void;
+    join(type?: "and" | "or"): SQL<unknown> | undefined;
+    [Symbol.iterator](): ArrayIterator<SQL<unknown>>;
+}
+export declare class TableConditionBuilder<TTable extends SQLiteTableWithColumns<any>> extends ConditionBuilder {
+    private table;
+    constructor(table: TTable);
+    applyFilters({ filters }?: {
+        filters?: QueryFilters;
+    }): void;
+}
+export declare const arrayContains: (table: SQLiteColumn, values: string[]) => SQL<unknown> | undefined;
+export declare class BaseRepository<O extends LibSQLDatabase<any>, S extends Record<string, SQLiteTableWithColumns<any>>, R extends Record<string, BaseRepository<any, any, any> | BaseExternaRepository>> extends Base {
+    protected orm: O;
+    protected schema: S;
+    repository?: R;
+    constructor(options: {
+        orm: O;
+        schema: S;
+    }, repository?: R);
+    getConditionBuilder(): ConditionBuilder;
+    getConditionBuilder(table: undefined): ConditionBuilder;
+    getConditionBuilder<TTable extends SQLiteTableWithColumns<any>>(table: TTable): TableConditionBuilder<TTable>;
+    withPagination<TQuery>(query: TQuery, { page, limit }: Pick<QueryInput, "page" | "limit">): TQuery;
+    withSorting<TTable extends SQLiteTableWithColumns<any>, TQuery>(query: TQuery, { sort, order }: Pick<QueryInput, "sort" | "order">, table?: TTable): TQuery;
+    withSortingAndPagination<TTable extends SQLiteTableWithColumns<any>, TQuery>(query: TQuery, { sort, order, page, limit }: Pick<QueryInput, "sort" | "order" | "page" | "limit">, table?: TTable): TQuery;
+    addUserIdFilter(userId: string, query?: QueryInput): QueryInput;
+    helpers: {
+        pickColumns: typeof pickColumns;
+        arrayContains: (table: SQLiteColumn, values: string[]) => SQL<unknown> | undefined;
+        ConditionBuilder: typeof ConditionBuilder;
+    };
+}
+/**
+ * Generic table-bound repository with typed CRUD, returning ServerResultAsync via throwableAsync.
+ *
+ * Example:
+ * const userRepo = new UserRepository(db, schema);
+ * class UserRepository extends BaseTableRepository<typeof schema.user> {
+ *   constructor(db: LibSQLDatabase<typeof schema>, schema: typeof schema) {
+ *     super(db, schema, schema.user);
+ *   }
+ * }
+ */
+export declare class BaseTableRepository<O extends LibSQLDatabase<any>, S extends Record<string, SQLiteTableWithColumns<any>>, R extends Record<string, BaseRepository<any, any, any> | BaseExternaRepository>, TTable extends SQLiteTableWithColumns<any>, TIdKey extends Extract<keyof InferSelectModel<TTable>, string> = "id"> extends BaseRepository<O, S, R> {
+    protected readonly table: TTable;
+    protected readonly idKey: TIdKey;
+    protected readonly idColumn: SQLiteColumn;
+    constructor(options: {
+        orm: O;
+        schema: S;
+        table: TTable;
+        idKey?: TIdKey;
+    }, repository?: R);
+    withSorting<TQuery>(query: TQuery, { sort, order }: Pick<QueryInput, "sort" | "order">, table?: SQLiteTableWithColumns<any>): TQuery;
+    withSortingAndPagination<MTable extends SQLiteTableWithColumns<any>, TQuery>(query: TQuery, { sort, order, page, limit }: Pick<QueryInput, "sort" | "order" | "page" | "limit">, table?: MTable): TQuery;
+    queryList(query?: QueryInput, options?: {
+        conditions?: TableConditionBuilder<TTable>;
+        select?: SelectedFields<SQLiteColumn, TTable>;
+    }, tx?: O): ServerResultAsync<{
+        rows: InferSelectModel<TTable>[];
+        total: number;
+    }>;
+    findById(id: string, tx?: O): ServerResultAsync<InferSelectModel<TTable> | undefined>;
+    findManyById(ids: readonly string[], tx?: O): ServerResultAsync<Array<InferSelectModel<TTable>>>;
+    create(data: InferInsertModel<TTable>, tx?: O): ServerResultAsync<InferSelectModel<TTable>>;
+    createMany(data: readonly InferInsertModel<TTable>[], tx?: O): ServerResultAsync<Array<InferSelectModel<TTable>>>;
+    update(data: TableUpdatePayload<TTable, TIdKey>, tx?: O): ServerResultAsync<InferSelectModel<TTable>>;
+    updateMany(data: readonly TableUpdatePayload<TTable, TIdKey>[], tx?: O): ServerResultAsync<Array<InferSelectModel<TTable>>>;
+    softDeleteById(id: string, tx?: O): ServerResultAsync<{
+        id: string;
+    }>;
+    softDeleteManyById(ids: readonly string[], tx?: O): ServerResultAsync<Array<{
+        id: string;
+    }>>;
+    deleteById(id: string, tx?: O): ServerResultAsync<{
+        id: string;
+    }>;
+    deleteManyById(ids: readonly string[], tx?: O): ServerResultAsync<Array<{
+        id: string;
+    }>>;
+}
+export declare class BaseExternaRepository extends Base {
+    constructor();
+}
+//# sourceMappingURL=base.repository.d.ts.map

package/dist/src/modules/base/base.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.repository.d.ts","sourceRoot":"","sources":["../../../../src/modules/base/base.repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EACZ,UAAU,EACX,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EAIrB,KAAK,cAAc,EACnB,KAAK,GAAG,EACT,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,WAAW,EAAqB,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAKhG,4FAA4F;AAC5F,MAAM,MAAM,kBAAkB,CAC5B,MAAM,SAAS,sBAAsB,CAAC,GAAG,CAAC,EAC1C,MAAM,SAAS,OAAO,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,IAAI,IACnE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7E,qBAAa,gBAAgB;IACf,OAAO,CAAC,UAAU;gBAAV,UAAU,GAAE,GAAG,EAAO;IAI1C,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG;IAIpB,IAAI,CAAC,IAAI,GAAE,KAAK,GAAG,IAAY;IAM/B,CAAC,MAAM,CAAC,QAAQ,CAAC;CAGlB;AAED,qBAAa,qBAAqB,CAChC,MAAM,SAAS,sBAAsB,CAAC,GAAG,CAAC,CAC1C,SAAQ,gBAAgB;IACxB,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,EAAE,MAAM;IAKzB,YAAY,CAAC,EAAE,OAAO,EAAE,GAAE;QAAE,OAAO,CAAC,EAAE,YAAY,CAAA;KAAO;CAG1D;AAED,eAAO,MAAM,aAAa,GAAI,OAAO,YAAY,EAAE,QAAQ,MAAM,EAAE,6BAMlE,CAAC;AAEF,qBAAa,cAAc,CACzB,CAAC,SAAS,cAAc,CAAC,GAAG,CAAC,EAC7B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC,EACrD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,qBAAqB,CAAC,CAC/E,SAAQ,IAAI;IACZ,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;IACjB,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACb,UAAU,CAAC,EAAE,CAAC,CAAC;gBAEV,OAAO,EAAE;QAAE,GAAG,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,CAAC,CAAA;KAAE,EAAE,UAAU,CAAC,EAAE,CAAC;IAM1D,mBAAmB,IAAI,gBAAgB;IACvC,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB;IACvD,mBAAmB,CAAC,MAAM,SAAS,sBAAsB,CAAC,GAAG,CAAC,EAC5D,KAAK,EAAE,MAAM,GACZ,qBAAqB,CAAC,MAAM,CAAC;IAUhC,cAAc,CAAC,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAClD,MAAM;IAIT,WAAW,CAAC,MAAM,SAAS,sBAAsB,CAAC,GAAG,CAAC,EAAE,MAAM,EAC5D,KAAK,EAAE,MAAM,EACb,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,EACnD,KAAK,CAAC,EAAE,MAAM,GACb,MAAM;IAKT,wBAAwB,CAAC,MAAM,SAAS,sBAAsB,CAAC,GAAG,CAAC,EAAE,MAAM,EACzE,KAAK,EAAE,MAAM,EACb,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,EACnF,KAAK,CAAC,EAAE,MAAM,GACb,MAAM;IAKT,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU;IAY/D,OAAO;;+BA1E4B,YAAY,UAAU,MAAM,EAAE;;MA8E/D;CACH;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB,CAC9B,CAAC,SAAS,cAAc,CAAC,GAAG,CAAC,EAC7B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC,EACrD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,qBAAqB,CAAC,EAC/E,MAAM,SAAS,sBAAsB,CAAC,GAAG,CAAC,EAC1C,MAAM,SAAS,OAAO,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,IAAI,CACrE,SAAQ,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/B,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;gBAE9B,OAAO,EAAE;QAAE,GAAG,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,UAAU,CAAC,EAAE,CAAC;IAOhF,WAAW,CAAC,MAAM,EACzB,KAAK,EAAE,MAAM,EACb,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,EACnD,KAAK,CAAC,EAAE,sBAAsB,CAAC,GAAG,CAAC,GAClC,MAAM;IAIA,wBAAwB,CAAC,MAAM,SAAS,sBAAsB,CAAC,GAAG,CAAC,EAAE,MAAM,EAClF,KAAK,EAAE,MAAM,EACb,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,EACnF,KAAK,CAAC,EAAE,MAAM,GACb,MAAM;IAIH,SAAS,CACb,KAAK,CAAC,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,CAAC,EAAE,cAAc,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;KAC/C,EACD,EAAE,CAAC,EAAE,CAAC,GACL,iBAAiB,CAAC;QAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBnE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAcrF,YAAY,CAChB,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,EAAE,CAAC,EAAE,CAAC,GACL,iBAAiB,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAkB/C,MAAM,CACV,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC9B,EAAE,CAAC,EAAE,CAAC,GACL,iBAAiB,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAexC,UAAU,CACd,IAAI,EAAE,SAAS,gBAAgB,CAAC,MAAM,CAAC,EAAE,EACzC,EAAE,CAAC,EAAE,CAAC,GACL,iBAAiB,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAkB/C,MAAM,CACV,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,EAAE,CAAC,EAAE,CAAC,GACL,iBAAiB,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAsBxC,UAAU,CACd,IAAI,EAAE,SAAS,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EACnD,EAAE,CAAC,EAAE,CAAC,GACL,iBAAiB,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IA4B/C,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAkBrE,kBAAkB,CACtB,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,EAAE,CAAC,EAAE,CAAC,GACL,iBAAiB,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAiBrC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAgBjE,cAAc,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAkB/F;AAED,qBAAa,qBAAsB,SAAQ,IAAI;;CAI9C"}

package/dist/src/modules/base/base.repository.js

@@ -0,0 +1,307 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseExternaRepository = exports.BaseTableRepository = exports.BaseRepository = exports.arrayContains = exports.TableConditionBuilder = exports.ConditionBuilder = void 0;
+const drizzle_orm_1 = require("drizzle-orm");
+const neverthrow_1 = require("neverthrow");
+const base_abstract_1 = require("#modules/base/base.abstract");
+const base_dto_1 = require("#modules/base/base.dto");
+const applyPagination_1 = require("#modules/utils/applyPagination");
+const applySorting_1 = require("#modules/utils/applySorting");
+const getConditionsFromFilters_1 = require("#modules/utils/getConditionsFromFilters");
+class ConditionBuilder {
+    conditions;
+    constructor(conditions = []) {
+        this.conditions = conditions;
+        this.conditions = conditions;
+    }
+    push(condition) {
+        if (condition)
+            this.conditions.push(condition);
+    }
+    join(type = "and") {
+        if (this.conditions.length === 0)
+            return undefined;
+        if (this.conditions.length === 1)
+            return this.conditions[0];
+        return type === "and" ? (0, drizzle_orm_1.and)(...this.conditions) : (0, drizzle_orm_1.or)(...this.conditions);
+    }
+    [Symbol.iterator]() {
+        return this.conditions[Symbol.iterator]();
+    }
+}
+exports.ConditionBuilder = ConditionBuilder;
+class TableConditionBuilder extends ConditionBuilder {
+    table;
+    constructor(table) {
+        super();
+        this.table = table;
+    }
+    applyFilters({ filters } = {}) {
+        if (filters && filters.length > 0)
+            (0, getConditionsFromFilters_1.getConditionsFromFilters)(this, filters, this.table);
+    }
+}
+exports.TableConditionBuilder = TableConditionBuilder;
+const arrayContains = (table, values) => {
+    const arrayContains = [];
+    for (const value of values) {
+        arrayContains.push((0, drizzle_orm_1.like)(table, `%"${value}%"`));
+    }
+    return (0, drizzle_orm_1.or)(...arrayContains);
+};
+exports.arrayContains = arrayContains;
+class BaseRepository extends base_abstract_1.Base {
+    orm;
+    schema;
+    repository;
+    constructor(options, repository) {
+        super("repository");
+        this.orm = options.orm;
+        this.schema = options.schema;
+        this.repository = repository;
+    }
+    getConditionBuilder(table) {
+        if (table === undefined) {
+            return new ConditionBuilder();
+        }
+        return new TableConditionBuilder(table);
+    }
+    withPagination(query, { page, limit }) {
+        return (0, applyPagination_1.applyPagination)(query, limit, page);
+    }
+    withSorting(query, { sort, order }, table) {
+        if (!table)
+            throw new Error("No table provided");
+        return (0, applySorting_1.applySorting)(query, table, sort, order);
+    }
+    withSortingAndPagination(query, { sort, order, page, limit }, table) {
+        if (!table)
+            throw new Error("No table provided");
+        return this.withSorting(this.withPagination(query, { page, limit }), { sort, order }, table);
+    }
+    addUserIdFilter(userId, query) {
+        const userIdFilter = {
+            columnId: "userId",
+            type: "string",
+            method: "equals",
+            value: userId,
+        };
+        return query
+            ? { ...query, filters: [...(query?.filters ?? []), userIdFilter] }
+            : { filters: [userIdFilter] };
+    }
+    helpers = {
+        pickColumns: base_dto_1.pickColumns,
+        arrayContains: exports.arrayContains,
+        ConditionBuilder,
+    };
+}
+exports.BaseRepository = BaseRepository;
+/**
+ * Generic table-bound repository with typed CRUD, returning ServerResultAsync via throwableAsync.
+ *
+ * Example:
+ * const userRepo = new UserRepository(db, schema);
+ * class UserRepository extends BaseTableRepository<typeof schema.user> {
+ *   constructor(db: LibSQLDatabase<typeof schema>, schema: typeof schema) {
+ *     super(db, schema, schema.user);
+ *   }
+ * }
+ */
+class BaseTableRepository extends BaseRepository {
+    table;
+    idKey;
+    idColumn;
+    constructor(options, repository) {
+        super({ orm: options.orm, schema: options.schema }, repository);
+        this.table = options.table;
+        this.idKey = options.idKey ?? "id";
+        this.idColumn = this.table[this.idKey];
+    }
+    withSorting(query, { sort, order }, table) {
+        return super.withSorting(query, { sort, order }, table || this.table);
+    }
+    withSortingAndPagination(query, { sort, order, page, limit }, table) {
+        return super.withSortingAndPagination(query, { sort, order, page, limit }, table || this.table);
+    }
+    async queryList(query, options, tx) {
+        return this.throwableAsync(async () => {
+            const db = tx ?? this.orm;
+            const conditions = options?.conditions ?? this.getConditionBuilder(this.table);
+            conditions.applyFilters(query);
+            const whereClause = conditions.join();
+            const rowsQuery = this.withSortingAndPagination((options?.select ? db.select(options.select) : db.select())
+                .from(this.table)
+                .where(whereClause), query || {});
+            const countQuery = db
+                .select({ count: (0, drizzle_orm_1.count)() })
+                .from(this.table)
+                .where(whereClause);
+            const [rows, [totalResult]] = await Promise.all([rowsQuery, countQuery]);
+            return (0, neverthrow_1.ok)({ rows: rows, total: totalResult?.count ?? 0 });
+        });
+    }
+    async findById(id, tx) {
+        return this.throwableAsync(async () => {
+            const db = tx ?? this.orm;
+            const rows = (await db
+                .select()
+                .from(this.table)
+                .where((0, drizzle_orm_1.eq)(this.idColumn, id)));
+            return (0, neverthrow_1.ok)(rows[0]);
+        });
+    }
+    async findManyById(ids, tx) {
+        return this.throwableAsync(async () => {
+            const db = tx ?? this.orm;
+            if (ids.length === 0) {
+                return (0, neverthrow_1.ok)([]);
+            }
+            const rows = (await db
+                .select()
+                .from(this.table)
+                .where((0, drizzle_orm_1.inArray)(this.idColumn, ids)));
+            return (0, neverthrow_1.ok)(rows);
+        });
+    }
+    async create(data, tx) {
+        return this.throwableAsync(async () => {
+            const db = tx ?? this.orm;
+            const rows = (await db
+                .insert(this.table)
+                .values(data)
+                .returning());
+            if (rows.length === 0)
+                return this.error("UNPROCESSABLE_CONTENT");
+            return (0, neverthrow_1.ok)(rows[0]);
+        });
+    }
+    async createMany(data, tx) {
+        return this.throwableAsync(async () => {
+            const db = tx ?? this.orm;
+            if (data.length === 0) {
+                return (0, neverthrow_1.ok)([]);
+            }
+            const rows = (await db
+                .insert(this.table)
+                .values(data)
+                .returning());
+            return (0, neverthrow_1.ok)(rows);
+        });
+    }
+    async update(data, tx) {
+        return this.throwableAsync(async () => {
+            const db = tx ?? this.orm;
+            const single = data;
+            const id = String(single[this.idKey]);
+            const { [this.idKey]: _removed, ...rest } = single;
+            const update = rest;
+            if (this.table.updatedAt)
+                update.updatedAt = new Date();
+            const rows = (await db
+                .update(this.table)
+                .set(update)
+                .where((0, drizzle_orm_1.eq)(this.idColumn, id))
+                .returning());
+            const [row] = rows;
+            if (!row)
+                return this.error("NOT_FOUND");
+            return (0, neverthrow_1.ok)(row);
+        });
+    }
+    async updateMany(data, tx) {
+        return this.throwableAsync(async () => {
+            const db = tx ?? this.orm;
+            if (data.length === 0) {
+                return (0, neverthrow_1.ok)([]);
+            }
+            const results = [];
+            for (const item of data) {
+                const record = item;
+                const id = String(record[this.idKey]);
+                const { [this.idKey]: _removed, ...rest } = record;
+                const update = rest;
+                if (this.table.updatedAt)
+                    update.updatedAt = new Date();
+                const rows = (await db
+                    .update(this.table)
+                    .set(update)
+                    .where((0, drizzle_orm_1.eq)(this.idColumn, id))
+                    .returning());
+                if (rows[0])
+                    results.push(rows[0]);
+            }
+            return (0, neverthrow_1.ok)(results);
+        });
+    }
+    async softDeleteById(id, tx) {
+        return this.throwableAsync(async () => {
+            const db = tx ?? this.orm;
+            if (!this.table.deletedAt)
+                return this.error("METHOD_NOT_SUPPORTED");
+            const rows = await db
+                .update(this.table)
+                .set({ deletedAt: new Date() })
+                .where((0, drizzle_orm_1.eq)(this.idColumn, id))
+                .returning({
+                id: this.idColumn,
+            });
+            if (rows.length === 0)
+                return this.error("NOT_FOUND");
+            return (0, neverthrow_1.ok)(rows[0]);
+        });
+    }
+    async softDeleteManyById(ids, tx) {
+        return this.throwableAsync(async () => {
+            const db = tx ?? this.orm;
+            if (!this.table.deletedAt)
+                return this.error("METHOD_NOT_SUPPORTED");
+            const rows = await db
+                .update(this.table)
+                .set({ deletedAt: new Date() })
+                .where((0, drizzle_orm_1.inArray)(this.idColumn, ids))
+                .returning({
+                id: this.idColumn,
+            });
+            if (rows.length === 0)
+                return this.error("NOT_FOUND");
+            return (0, neverthrow_1.ok)(rows);
+        });
+    }
+    async deleteById(id, tx) {
+        return this.throwableAsync(async () => {
+            const db = tx ?? this.orm;
+            const rows = await db
+                .delete(this.table)
+                .where((0, drizzle_orm_1.eq)(this.idColumn, id))
+                .returning({
+                id: this.idColumn,
+            });
+            if (rows.length === 0)
+                return this.error("NOT_FOUND");
+            return (0, neverthrow_1.ok)(rows[0]);
+        });
+    }
+    async deleteManyById(ids, tx) {
+        return this.throwableAsync(async () => {
+            const db = tx ?? this.orm;
+            if (ids.length === 0) {
+                return (0, neverthrow_1.ok)([]);
+            }
+            const rows = await db
+                .delete(this.table)
+                .where((0, drizzle_orm_1.inArray)(this.idColumn, ids))
+                .returning({
+                id: this.idColumn,
+            });
+            return (0, neverthrow_1.ok)(rows);
+        });
+    }
+}
+exports.BaseTableRepository = BaseTableRepository;
+class BaseExternaRepository extends base_abstract_1.Base {
+    constructor() {
+        super("repository");
+    }
+}
+exports.BaseExternaRepository = BaseExternaRepository;

package/dist/src/modules/base/base.service.d.ts

@@ -0,0 +1,42 @@
+import type { QueryFilter, QueryInput } from "@m5kdev/commons/modules/schemas/query.schema";
+import type { Session, User } from "#modules/auth/auth.lib";
+import { Base } from "#modules/base/base.abstract";
+import type { ServerResult, ServerResultAsync } from "#modules/base/base.dto";
+import { type Entity, type ResourceActionGrant, type ResourceGrant } from "#modules/base/base.grants";
+import type { BaseExternaRepository, BaseRepository } from "#modules/base/base.repository";
+import type { Context } from "#trpc";
+export declare class BaseService<Repositories extends Record<string, BaseRepository<any, any, any> | BaseExternaRepository>, Services extends Record<string, BaseService<any, any>>> extends Base {
+    repository: Repositories;
+    service: Services;
+    constructor(repository?: Repositories, service?: Services);
+    addUserFilter(value: string, query?: QueryInput, columnId?: string, method?: QueryFilter["method"]): QueryInput;
+    addContextFilter(ctx: Awaited<ReturnType<Context>>, include?: {
+        user?: boolean;
+        organization?: boolean;
+        team?: boolean;
+    }, query?: QueryInput, map?: Record<string, {
+        columnId: string;
+        method: QueryFilter["method"];
+    }>): QueryInput;
+}
+export declare class BasePermissionService<Repositories extends Record<string, BaseRepository<any, any, any> | BaseExternaRepository>, Services extends Record<string, BaseService<any, any>>> extends BaseService<Repositories, Services> {
+    grants: ResourceGrant[];
+    constructor(repository: Repositories, service: Services, grants?: ResourceGrant[]);
+    accessGuard<T extends Entity>(ctx: {
+        session: Session;
+        user: User;
+    }, action: string, entities?: T | T[], grants?: ResourceActionGrant[]): ServerResult<true>;
+    accessGuardAsync<T extends Entity>(ctx: {
+        session: Session;
+        user: User;
+    }, action: string, getEntities: () => ServerResultAsync<T | T[] | undefined>, grants?: ResourceActionGrant[]): ServerResultAsync<true>;
+    checkPermission<T extends Entity>(ctx: {
+        session: Session;
+        user: User;
+    }, action: string, entities?: T | T[], grants?: ResourceActionGrant[]): boolean;
+    checkPermissionAsync<T extends Entity>(ctx: {
+        session: Session;
+        user: User;
+    }, action: string, getEntities: () => ServerResultAsync<T | T[] | undefined>, grants?: ResourceActionGrant[]): ServerResultAsync<boolean>;
+}
+//# sourceMappingURL=base.service.d.ts.map

package/dist/src/modules/base/base.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.service.d.ts","sourceRoot":"","sources":["../../../../src/modules/base/base.service.ts"],"names":[],"mappings":"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"}

package/dist/src/modules/base/base.service.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasePermissionService = exports.BaseService = void 0;
+const neverthrow_1 = require("neverthrow");
+const base_abstract_1 = require("#modules/base/base.abstract");
+const base_grants_1 = require("#modules/base/base.grants");
+class BaseService extends base_abstract_1.Base {
+    repository;
+    service;
+    constructor(repository = {}, service = {}) {
+        super("service");
+        this.repository = repository;
+        this.service = service;
+        this.repository = repository;
+        this.service = service;
+    }
+    addUserFilter(value, query, columnId = "userId", method = "equals") {
+        const userFilter = {
+            columnId,
+            type: "string",
+            method,
+            value,
+        };
+        return query
+            ? { ...query, filters: [...(query?.filters ?? []), userFilter] }
+            : { filters: [userFilter] };
+    }
+    addContextFilter(ctx, include = {
+        user: true,
+        organization: false,
+        team: false,
+    }, query, map = {
+        userId: {
+            columnId: "userId",
+            method: "equals",
+        },
+        organizationId: {
+            columnId: "organizationId",
+            method: "equals",
+        },
+        teamId: {
+            columnId: "teamId",
+            method: "equals",
+        },
+    }) {
+        const filters = [];
+        if (include.user) {
+            filters.push({
+                columnId: map.userId.columnId,
+                type: "string",
+                method: map.userId.method,
+                value: ctx.user.id,
+            });
+        }
+        if (include.organization) {
+            filters.push({
+                columnId: map.organizationId.columnId,
+                type: "string",
+                method: map.organizationId.method,
+                value: ctx.session.activeOrganizationId ?? "",
+            });
+        }
+        if (include.team) {
+            filters.push({
+                columnId: map.teamId.columnId,
+                type: "string",
+                method: map.teamId.method,
+                value: ctx.session.activeTeamId ?? "",
+            });
+        }
+        return query ? { ...query, filters: [...(query?.filters ?? []), ...filters] } : { filters };
+    }
+}
+exports.BaseService = BaseService;
+class BasePermissionService extends BaseService {
+    grants;
+    constructor(repository, service, grants = []) {
+        super(repository, service);
+        this.grants = grants;
+    }
+    accessGuard(ctx, action, entities, grants) {
+        const hasPermission = this.checkPermission(ctx, action, entities, grants);
+        if (!hasPermission)
+            return this.error("FORBIDDEN");
+        return (0, neverthrow_1.ok)(true);
+    }
+    async accessGuardAsync(ctx, action, getEntities, grants) {
+        const hasPermission = await this.checkPermissionAsync(ctx, action, getEntities, grants);
+        if (hasPermission.isErr())
+            return (0, neverthrow_1.err)(hasPermission.error);
+        if (!hasPermission.value)
+            return this.error("FORBIDDEN");
+        return (0, neverthrow_1.ok)(true);
+    }
+    checkPermission(ctx, action, entities, grants) {
+        const actionGrants = grants ?? this.grants.filter((grant) => grant.action === action);
+        return (0, base_grants_1.checkPermissionSync)(ctx, actionGrants, entities);
+    }
+    async checkPermissionAsync(ctx, action, getEntities, grants) {
+        const actionGrants = grants ?? this.grants.filter((grant) => grant.action === action);
+        const permission = await (0, base_grants_1.checkPermissionAsync)(ctx, actionGrants, getEntities);
+        if (permission.isErr())
+            return this.error("INTERNAL_SERVER_ERROR", "Failed to check permission", {
+                cause: permission.error,
+            });
+        return (0, neverthrow_1.ok)(permission.value);
+    }
+}
+exports.BasePermissionService = BasePermissionService;

package/dist/src/modules/base/base.types.d.ts

@@ -0,0 +1,2 @@
+export type ServerErrorLayer = "unknown" | "repository" | "service" | "controller" | "auth" | "workflow";
+//# sourceMappingURL=base.types.d.ts.map

package/dist/src/modules/base/base.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.types.d.ts","sourceRoot":"","sources":["../../../../src/modules/base/base.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,MAAM,GACN,UAAU,CAAC"}

package/dist/src/modules/base/base.types.js

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