@m5kdev/backend 0.6.0 → 0.8.0

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

@@ -0,0 +1,123 @@
+import { ServerResultAsync, pickColumns } from "./base.dto.mjs";
+import { Base } from "./base.abstract.mjs";
+import { InferInsertModel, InferSelectModel, SQL, SelectedFields } from "drizzle-orm";
+import { SQLiteColumn, SQLiteTableWithColumns } from "drizzle-orm/sqlite-core";
+import { QueryFilters, QueryInput } from "@m5kdev/commons/modules/schemas/query.schema";
+import { LibSQLDatabase } from "drizzle-orm/libsql";
+
+//#region src/modules/base/base.repository.d.ts
+/** Payload for update/updateMany: id key required (string), other table fields optional. */
+type TableUpdatePayload<TTable extends SQLiteTableWithColumns<any>, TIdKey extends Extract<keyof InferSelectModel<TTable>, string> = "id"> = Record<TIdKey, string> & Partial<Omit<InferSelectModel<TTable>, TIdKey>>;
+declare class ConditionBuilder {
+  private conditions;
+  constructor(conditions?: SQL[]);
+  push(condition?: SQL): void;
+  join(type?: "and" | "or"): SQL<unknown> | undefined;
+  [Symbol.iterator](): ArrayIterator<SQL<unknown>>;
+}
+declare class TableConditionBuilder<TTable extends SQLiteTableWithColumns<any>> extends ConditionBuilder {
+  private table;
+  constructor(table: TTable);
+  applyFilters({
+    filters
+  }?: {
+    filters?: QueryFilters;
+  }): void;
+}
+declare const arrayContains: (table: SQLiteColumn, values: string[]) => SQL<unknown> | undefined;
+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>;
+  throwableQuery<T>(fn: () => Promise<T>): ServerResultAsync<T>;
+  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);
+ *   }
+ * }
+ */
+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;
+  }>>;
+}
+declare class BaseExternaRepository extends Base {
+  constructor();
+}
+//#endregion
+export { BaseExternaRepository, BaseRepository, BaseTableRepository, ConditionBuilder, TableConditionBuilder, TableUpdatePayload, arrayContains };
+//# sourceMappingURL=base.repository.d.mts.map

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

@@ -0,0 +1,250 @@
+import { ServerError } from "../../utils/errors.mjs";
+import { applyPagination } from "../utils/applyPagination.mjs";
+import { applySorting } from "../utils/applySorting.mjs";
+import { getConditionsFromFilters } from "../utils/getConditionsFromFilters.mjs";
+import { Base } from "./base.abstract.mjs";
+import { pickColumns } from "./base.dto.mjs";
+import { and, count, eq, inArray, like, or } from "drizzle-orm";
+import { ok } from "neverthrow";
+//#region src/modules/base/base.repository.ts
+var ConditionBuilder = class {
+	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 void 0;
+		if (this.conditions.length === 1) return this.conditions[0];
+		return type === "and" ? and(...this.conditions) : or(...this.conditions);
+	}
+	[Symbol.iterator]() {
+		return this.conditions[Symbol.iterator]();
+	}
+};
+var TableConditionBuilder = class extends ConditionBuilder {
+	table;
+	constructor(table) {
+		super();
+		this.table = table;
+	}
+	applyFilters({ filters } = {}) {
+		if (filters && filters.length > 0) getConditionsFromFilters(this, filters, this.table);
+	}
+};
+const arrayContains = (table, values) => {
+	const arrayContains = [];
+	for (const value of values) arrayContains.push(like(table, `%"${value}%"`));
+	return or(...arrayContains);
+};
+var BaseRepository = class extends Base {
+	orm;
+	schema;
+	repository;
+	constructor(options, repository) {
+		super("repository");
+		this.orm = options.orm;
+		this.schema = options.schema;
+		this.repository = repository;
+	}
+	getConditionBuilder(table) {
+		if (table === void 0) return new ConditionBuilder();
+		return new TableConditionBuilder(table);
+	}
+	throwableQuery(fn) {
+		return this.throwablePromise(() => fn(), (error) => new ServerError({
+			code: "INTERNAL_SERVER_ERROR",
+			layer: "repository",
+			layerName: this.constructor.name,
+			message: "Database query failed",
+			cause: error
+		}));
+	}
+	withPagination(query, { page, limit }) {
+		return applyPagination(query, limit, page);
+	}
+	withSorting(query, { sort, order }, table) {
+		if (!table) throw new Error("No table provided");
+		return 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,
+		arrayContains,
+		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);
+*   }
+* }
+*/
+var BaseTableRepository = class 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: count() }).from(this.table).where(whereClause);
+			const [rows, [totalResult]] = await Promise.all([rowsQuery, countQuery]);
+			return ok({
+				rows,
+				total: totalResult?.count ?? 0
+			});
+		});
+	}
+	async findById(id, tx) {
+		return this.throwableAsync(async () => {
+			return ok((await (tx ?? this.orm).select().from(this.table).where(eq(this.idColumn, id)))[0]);
+		});
+	}
+	async findManyById(ids, tx) {
+		return this.throwableAsync(async () => {
+			const db = tx ?? this.orm;
+			if (ids.length === 0) return ok([]);
+			return ok(await db.select().from(this.table).where(inArray(this.idColumn, ids)));
+		});
+	}
+	async create(data, tx) {
+		return this.throwableAsync(async () => {
+			const rows = await (tx ?? this.orm).insert(this.table).values(data).returning();
+			if (rows.length === 0) return this.error("UNPROCESSABLE_CONTENT");
+			return ok(rows[0]);
+		});
+	}
+	async createMany(data, tx) {
+		return this.throwableAsync(async () => {
+			const db = tx ?? this.orm;
+			if (data.length === 0) return ok([]);
+			return ok(await db.insert(this.table).values(data).returning());
+		});
+	}
+	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 = /* @__PURE__ */ new Date();
+			const [row] = await db.update(this.table).set(update).where(eq(this.idColumn, id)).returning();
+			if (!row) return this.error("NOT_FOUND");
+			return ok(row);
+		});
+	}
+	async updateMany(data, tx) {
+		return this.throwableAsync(async () => {
+			const db = tx ?? this.orm;
+			if (data.length === 0) return 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 = /* @__PURE__ */ new Date();
+				const rows = await db.update(this.table).set(update).where(eq(this.idColumn, id)).returning();
+				if (rows[0]) results.push(rows[0]);
+			}
+			return 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: /* @__PURE__ */ new Date() }).where(eq(this.idColumn, id)).returning({ id: this.idColumn });
+			if (rows.length === 0) return this.error("NOT_FOUND");
+			return 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: /* @__PURE__ */ new Date() }).where(inArray(this.idColumn, ids)).returning({ id: this.idColumn });
+			if (rows.length === 0) return this.error("NOT_FOUND");
+			return ok(rows);
+		});
+	}
+	async deleteById(id, tx) {
+		return this.throwableAsync(async () => {
+			const rows = await (tx ?? this.orm).delete(this.table).where(eq(this.idColumn, id)).returning({ id: this.idColumn });
+			if (rows.length === 0) return this.error("NOT_FOUND");
+			return ok(rows[0]);
+		});
+	}
+	async deleteManyById(ids, tx) {
+		return this.throwableAsync(async () => {
+			const db = tx ?? this.orm;
+			if (ids.length === 0) return ok([]);
+			return ok(await db.delete(this.table).where(inArray(this.idColumn, ids)).returning({ id: this.idColumn }));
+		});
+	}
+};
+var BaseExternaRepository = class extends Base {
+	constructor() {
+		super("repository");
+	}
+};
+//#endregion
+export { BaseExternaRepository, BaseRepository, BaseTableRepository, ConditionBuilder, TableConditionBuilder, arrayContains };
+
+//# sourceMappingURL=base.repository.mjs.map

package/dist/src/modules/base/base.repository.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.repository.mjs","names":[],"sources":["../../../../src/modules/base/base.repository.ts"],"sourcesContent":["import type {\r\n  QueryFilter,\r\n  QueryFilters,\r\n  QueryInput,\r\n} from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport {\r\n  and,\r\n  count,\r\n  eq,\r\n  type InferInsertModel,\r\n  type InferSelectModel,\r\n  inArray,\r\n  like,\r\n  or,\r\n  type SelectedFields,\r\n  type SQL,\r\n} from \"drizzle-orm\";\r\nimport type { LibSQLDatabase } from \"drizzle-orm/libsql\";\r\nimport type { SQLiteColumn, SQLiteTableWithColumns } from \"drizzle-orm/sqlite-core\";\r\nimport { ok } from \"neverthrow\";\r\nimport { ServerError } from \"../../utils/errors\";\r\nimport { applyPagination } from \"../utils/applyPagination\";\r\nimport { applySorting } from \"../utils/applySorting\";\r\nimport { getConditionsFromFilters } from \"../utils/getConditionsFromFilters\";\r\nimport { Base } from \"./base.abstract\";\r\nimport { pickColumns, type ServerResult, type ServerResultAsync } from \"./base.dto\";\r\n\r\n/** Payload for update/updateMany: id key required (string), other table fields optional. */\r\nexport type TableUpdatePayload<\r\n  TTable extends SQLiteTableWithColumns<any>,\r\n  TIdKey extends Extract<keyof InferSelectModel<TTable>, string> = \"id\",\r\n> = Record<TIdKey, string> & Partial<Omit<InferSelectModel<TTable>, TIdKey>>;\r\n\r\nexport class ConditionBuilder {\r\n  constructor(private conditions: SQL[] = []) {\r\n    this.conditions = conditions;\r\n  }\r\n\r\n  push(condition?: SQL) {\r\n    if (condition) this.conditions.push(condition);\r\n  }\r\n\r\n  join(type: \"and\" | \"or\" = \"and\") {\r\n    if (this.conditions.length === 0) return undefined;\r\n    if (this.conditions.length === 1) return this.conditions[0];\r\n    return type === \"and\" ? and(...this.conditions) : or(...this.conditions);\r\n  }\r\n\r\n  [Symbol.iterator]() {\r\n    return this.conditions[Symbol.iterator]();\r\n  }\r\n}\r\n\r\nexport class TableConditionBuilder<\r\n  TTable extends SQLiteTableWithColumns<any>,\r\n> extends ConditionBuilder {\r\n  private table: TTable;\r\n\r\n  constructor(table: TTable) {\r\n    super();\r\n    this.table = table;\r\n  }\r\n\r\n  applyFilters({ filters }: { filters?: QueryFilters } = {}) {\r\n    if (filters && filters.length > 0) getConditionsFromFilters(this, filters, this.table);\r\n  }\r\n}\r\n\r\nexport const arrayContains = (table: SQLiteColumn, values: string[]) => {\r\n  const arrayContains: SQL[] = [];\r\n  for (const value of values) {\r\n    arrayContains.push(like(table, `%\"${value}%\"`));\r\n  }\r\n  return or(...arrayContains);\r\n};\r\n\r\nexport class BaseRepository<\r\n  O extends LibSQLDatabase<any>,\r\n  S extends Record<string, SQLiteTableWithColumns<any>>,\r\n  R extends Record<string, BaseRepository<any, any, any> | BaseExternaRepository>,\r\n> extends Base {\r\n  protected orm: O;\r\n  protected schema: S;\r\n  public repository?: R;\r\n\r\n  constructor(options: { orm: O; schema: S }, repository?: R) {\r\n    super(\"repository\");\r\n    this.orm = options.orm;\r\n    this.schema = options.schema;\r\n    this.repository = repository;\r\n  }\r\n  getConditionBuilder(): ConditionBuilder;\r\n  getConditionBuilder(table: undefined): ConditionBuilder;\r\n  getConditionBuilder<TTable extends SQLiteTableWithColumns<any>>(\r\n    table: TTable\r\n  ): TableConditionBuilder<TTable>;\r\n  getConditionBuilder<TTable extends SQLiteTableWithColumns<any>>(\r\n    table?: TTable\r\n  ): ConditionBuilder | TableConditionBuilder<TTable> {\r\n    if (table === undefined) {\r\n      return new ConditionBuilder();\r\n    }\r\n    return new TableConditionBuilder(table);\r\n  }\r\n  throwableQuery<T>(fn: () => Promise<T>): ServerResultAsync<T> {\r\n    return this.throwablePromise(\r\n      () => fn(),\r\n      (error) =>\r\n        new ServerError({\r\n          code: \"INTERNAL_SERVER_ERROR\",\r\n          layer: \"repository\",\r\n          layerName: this.constructor.name,\r\n          message: \"Database query failed\",\r\n          cause: error,\r\n        })\r\n    );\r\n  }\r\n\r\n  withPagination<TQuery>(\r\n    query: TQuery,\r\n    { page, limit }: Pick<QueryInput, \"page\" | \"limit\">\r\n  ): TQuery {\r\n    return applyPagination(query, limit, page);\r\n  }\r\n\r\n  withSorting<TTable extends SQLiteTableWithColumns<any>, TQuery>(\r\n    query: TQuery,\r\n    { sort, order }: Pick<QueryInput, \"sort\" | \"order\">,\r\n    table?: TTable\r\n  ): TQuery {\r\n    if (!table) throw new Error(\"No table provided\");\r\n    return applySorting(query, table, sort, order);\r\n  }\r\n\r\n  withSortingAndPagination<TTable extends SQLiteTableWithColumns<any>, TQuery>(\r\n    query: TQuery,\r\n    { sort, order, page, limit }: Pick<QueryInput, \"sort\" | \"order\" | \"page\" | \"limit\">,\r\n    table?: TTable\r\n  ): TQuery {\r\n    if (!table) throw new Error(\"No table provided\");\r\n    return this.withSorting(this.withPagination(query, { page, limit }), { sort, order }, table);\r\n  }\r\n\r\n  addUserIdFilter(userId: string, query?: QueryInput): QueryInput {\r\n    const userIdFilter: QueryFilter = {\r\n      columnId: \"userId\",\r\n      type: \"string\",\r\n      method: \"equals\",\r\n      value: userId,\r\n    };\r\n    return query\r\n      ? { ...query, filters: [...(query?.filters ?? []), userIdFilter] }\r\n      : { filters: [userIdFilter] };\r\n  }\r\n\r\n  helpers = {\r\n    pickColumns,\r\n    arrayContains,\r\n    ConditionBuilder,\r\n  };\r\n}\r\n\r\n/**\r\n * Generic table-bound repository with typed CRUD, returning ServerResultAsync via throwableAsync.\r\n *\r\n * Example:\r\n * const userRepo = new UserRepository(db, schema);\r\n * class UserRepository extends BaseTableRepository<typeof schema.user> {\r\n *   constructor(db: LibSQLDatabase<typeof schema>, schema: typeof schema) {\r\n *     super(db, schema, schema.user);\r\n *   }\r\n * }\r\n */\r\nexport class BaseTableRepository<\r\n  O extends LibSQLDatabase<any>,\r\n  S extends Record<string, SQLiteTableWithColumns<any>>,\r\n  R extends Record<string, BaseRepository<any, any, any> | BaseExternaRepository>,\r\n  TTable extends SQLiteTableWithColumns<any>,\r\n  TIdKey extends Extract<keyof InferSelectModel<TTable>, string> = \"id\",\r\n> extends BaseRepository<O, S, R> {\r\n  protected readonly table: TTable;\r\n  protected readonly idKey: TIdKey;\r\n  protected readonly idColumn: SQLiteColumn;\r\n\r\n  constructor(options: { orm: O; schema: S; table: TTable; idKey?: TIdKey }, repository?: R) {\r\n    super({ orm: options.orm, schema: options.schema }, repository);\r\n    this.table = options.table;\r\n    this.idKey = options.idKey ?? (\"id\" as TIdKey);\r\n    this.idColumn = (this.table as any)[this.idKey] as SQLiteColumn;\r\n  }\r\n\r\n  override withSorting<TQuery>(\r\n    query: TQuery,\r\n    { sort, order }: Pick<QueryInput, \"sort\" | \"order\">,\r\n    table?: SQLiteTableWithColumns<any>\r\n  ): TQuery {\r\n    return super.withSorting(query, { sort, order }, table || this.table);\r\n  }\r\n\r\n  override withSortingAndPagination<MTable extends SQLiteTableWithColumns<any>, TQuery>(\r\n    query: TQuery,\r\n    { sort, order, page, limit }: Pick<QueryInput, \"sort\" | \"order\" | \"page\" | \"limit\">,\r\n    table?: MTable\r\n  ): TQuery {\r\n    return super.withSortingAndPagination(query, { sort, order, page, limit }, table || this.table);\r\n  }\r\n\r\n  async queryList(\r\n    query?: QueryInput,\r\n    options?: {\r\n      conditions?: TableConditionBuilder<TTable>;\r\n      select?: SelectedFields<SQLiteColumn, TTable>;\r\n    },\r\n    tx?: O\r\n  ): ServerResultAsync<{ rows: InferSelectModel<TTable>[]; total: number }> {\r\n    return this.throwableAsync(async () => {\r\n      type Row = InferSelectModel<TTable>;\r\n\r\n      const db = tx ?? this.orm;\r\n      const conditions = options?.conditions ?? this.getConditionBuilder(this.table);\r\n      conditions.applyFilters(query);\r\n      const whereClause = conditions.join();\r\n      const rowsQuery = this.withSortingAndPagination(\r\n        (options?.select ? db.select(options.select) : db.select())\r\n          .from(this.table as any)\r\n          .where(whereClause),\r\n        query || {}\r\n      );\r\n      const countQuery = db\r\n        .select({ count: count() })\r\n        .from(this.table as any)\r\n        .where(whereClause);\r\n      const [rows, [totalResult]] = await Promise.all([rowsQuery, countQuery]);\r\n\r\n      return ok({ rows: rows as Row[], total: totalResult?.count ?? 0 });\r\n    });\r\n  }\r\n\r\n  async findById(id: string, tx?: O): ServerResultAsync<InferSelectModel<TTable> | undefined> {\r\n    return this.throwableAsync(async () => {\r\n      const db = tx ?? this.orm;\r\n      type Row = InferSelectModel<TTable>;\r\n\r\n      const rows = (await db\r\n        .select()\r\n        .from(this.table as any)\r\n        .where(eq(this.idColumn as SQLiteColumn, id))) as Row[];\r\n\r\n      return ok(rows[0]);\r\n    });\r\n  }\r\n\r\n  async findManyById(\r\n    ids: readonly string[],\r\n    tx?: O\r\n  ): ServerResultAsync<Array<InferSelectModel<TTable>>> {\r\n    return this.throwableAsync(async () => {\r\n      const db = tx ?? this.orm;\r\n      type Row = InferSelectModel<TTable>;\r\n\r\n      if (ids.length === 0) {\r\n        return ok<Row[]>([]);\r\n      }\r\n\r\n      const rows = (await db\r\n        .select()\r\n        .from(this.table as any)\r\n        .where(inArray(this.idColumn as SQLiteColumn, ids as string[]))) as Row[];\r\n\r\n      return ok(rows);\r\n    });\r\n  }\r\n\r\n  async create(\r\n    data: InferInsertModel<TTable>,\r\n    tx?: O\r\n  ): ServerResultAsync<InferSelectModel<TTable>> {\r\n    return this.throwableAsync(async () => {\r\n      const db = tx ?? this.orm;\r\n      type Row = InferSelectModel<TTable>;\r\n\r\n      const rows = (await db\r\n        .insert(this.table as any)\r\n        .values(data as any)\r\n        .returning()) as unknown as Row[];\r\n\r\n      if (rows.length === 0) return this.error(\"UNPROCESSABLE_CONTENT\");\r\n      return ok(rows[0] as Row);\r\n    });\r\n  }\r\n\r\n  async createMany(\r\n    data: readonly InferInsertModel<TTable>[],\r\n    tx?: O\r\n  ): ServerResultAsync<Array<InferSelectModel<TTable>>> {\r\n    return this.throwableAsync(async () => {\r\n      const db = tx ?? this.orm;\r\n      type Row = InferSelectModel<TTable>;\r\n\r\n      if (data.length === 0) {\r\n        return ok<Row[]>([]);\r\n      }\r\n\r\n      const rows = (await db\r\n        .insert(this.table as any)\r\n        .values(data as any)\r\n        .returning()) as unknown as Row[];\r\n\r\n      return ok(rows as Row[]);\r\n    });\r\n  }\r\n\r\n  async update(\r\n    data: TableUpdatePayload<TTable, TIdKey>,\r\n    tx?: O\r\n  ): ServerResultAsync<InferSelectModel<TTable>> {\r\n    return this.throwableAsync(async () => {\r\n      const db = tx ?? this.orm;\r\n      type Row = InferSelectModel<TTable>;\r\n\r\n      const single = data as Record<string, unknown>;\r\n      const id = String(single[this.idKey]);\r\n      const { [this.idKey]: _removed, ...rest } = single;\r\n      const update = rest;\r\n      if (this.table.updatedAt) (update as any).updatedAt = new Date();\r\n      const rows = (await db\r\n        .update(this.table as any)\r\n        .set(update as unknown as Partial<InferInsertModel<TTable>>)\r\n        .where(eq(this.idColumn as SQLiteColumn, id))\r\n        .returning()) as unknown as Row[];\r\n      const [row] = rows;\r\n\r\n      if (!row) return this.error(\"NOT_FOUND\");\r\n      return ok(row) as ServerResult<Row>;\r\n    });\r\n  }\r\n\r\n  async updateMany(\r\n    data: readonly TableUpdatePayload<TTable, TIdKey>[],\r\n    tx?: O\r\n  ): ServerResultAsync<Array<InferSelectModel<TTable>>> {\r\n    return this.throwableAsync(async () => {\r\n      const db = tx ?? this.orm;\r\n      type Row = InferSelectModel<TTable>;\r\n\r\n      if (data.length === 0) {\r\n        return ok<Row[]>([]);\r\n      }\r\n\r\n      const results: Row[] = [];\r\n      for (const item of data) {\r\n        const record = item as Record<string, unknown>;\r\n        const id = String(record[this.idKey]);\r\n        const { [this.idKey]: _removed, ...rest } = record;\r\n        const update = rest;\r\n        if (this.table.updatedAt) (update as any).updatedAt = new Date();\r\n        const rows = (await db\r\n          .update(this.table as any)\r\n          .set(update as unknown as Partial<InferInsertModel<TTable>>)\r\n          .where(eq(this.idColumn as SQLiteColumn, id))\r\n          .returning()) as unknown as Row[];\r\n        if (rows[0]) results.push(rows[0]);\r\n      }\r\n\r\n      return ok(results) as ServerResult<Row[]>;\r\n    });\r\n  }\r\n\r\n  async softDeleteById(id: string, tx?: O): ServerResultAsync<{ id: string }> {\r\n    return this.throwableAsync(async () => {\r\n      const db = tx ?? this.orm;\r\n      if (!this.table.deletedAt) return this.error(\"METHOD_NOT_SUPPORTED\");\r\n\r\n      const rows = await db\r\n        .update(this.table as any)\r\n        .set({ deletedAt: new Date() })\r\n        .where(eq(this.idColumn as SQLiteColumn, id))\r\n        .returning({\r\n          id: this.idColumn as SQLiteColumn,\r\n        });\r\n\r\n      if (rows.length === 0) return this.error(\"NOT_FOUND\");\r\n      return ok(rows[0] as { id: string });\r\n    });\r\n  }\r\n\r\n  async softDeleteManyById(\r\n    ids: readonly string[],\r\n    tx?: O\r\n  ): ServerResultAsync<Array<{ id: string }>> {\r\n    return this.throwableAsync(async () => {\r\n      const db = tx ?? this.orm;\r\n      if (!this.table.deletedAt) return this.error(\"METHOD_NOT_SUPPORTED\");\r\n\r\n      const rows = await db\r\n        .update(this.table as any)\r\n        .set({ deletedAt: new Date() })\r\n        .where(inArray(this.idColumn as SQLiteColumn, ids as string[]))\r\n        .returning({\r\n          id: this.idColumn as SQLiteColumn,\r\n        });\r\n      if (rows.length === 0) return this.error(\"NOT_FOUND\");\r\n      return ok(rows as { id: string }[]);\r\n    });\r\n  }\r\n\r\n  async deleteById(id: string, tx?: O): ServerResultAsync<{ id: string }> {\r\n    return this.throwableAsync(async () => {\r\n      const db = tx ?? this.orm;\r\n\r\n      const rows = await db\r\n        .delete(this.table as any)\r\n        .where(eq(this.idColumn as SQLiteColumn, id))\r\n        .returning({\r\n          id: this.idColumn as SQLiteColumn,\r\n        });\r\n\r\n      if (rows.length === 0) return this.error(\"NOT_FOUND\");\r\n      return ok(rows[0] as { id: string });\r\n    });\r\n  }\r\n\r\n  async deleteManyById(ids: readonly string[], tx?: O): ServerResultAsync<Array<{ id: string }>> {\r\n    return this.throwableAsync(async () => {\r\n      const db = tx ?? this.orm;\r\n\r\n      if (ids.length === 0) {\r\n        return ok<{ id: string }[]>([]);\r\n      }\r\n\r\n      const rows = await db\r\n        .delete(this.table as any)\r\n        .where(inArray(this.idColumn as SQLiteColumn, ids as string[]))\r\n        .returning({\r\n          id: this.idColumn as SQLiteColumn,\r\n        });\r\n\r\n      return ok(rows as { id: string }[]);\r\n    });\r\n  }\r\n}\r\n\r\nexport class BaseExternaRepository extends Base {\r\n  constructor() {\r\n    super(\"repository\");\r\n  }\r\n}\r\n"],"mappings":"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"}

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

@@ -0,0 +1,44 @@
+import { ServerResult, ServerResultAsync } from "./base.dto.mjs";
+import { Base } from "./base.abstract.mjs";
+import { AuthenticatedActor } from "./base.actor.mjs";
+import { Entity, ResourceActionGrant, ResourceGrant } from "./base.grants.mjs";
+import { PermissionServiceProcedureBuilder, ServiceProcedure, ServiceProcedureAccessConfig, ServiceProcedureAccessEntitiesConfig, ServiceProcedureAccessStateConfig, ServiceProcedureArgs, ServiceProcedureBuilder, ServiceProcedureContext, ServiceProcedureContextFilterScope, ServiceProcedureContextFilteredInput, ServiceProcedureEntityStepName, ServiceProcedureInputMapper } from "./base.procedure.mjs";
+import { QueryFilter, QueryInput } from "@m5kdev/commons/modules/schemas/query.schema";
+
+//#region src/modules/base/base.service.d.ts
+declare class BaseService<Repositories extends Record<string, Base>, Services extends Record<string, Base>, DefaultContext extends ServiceProcedureContext = ServiceProcedureContext> extends Base {
+  repository: Repositories;
+  service: Services;
+  constructor(repository?: Repositories, service?: Services);
+  addUserFilter(value: string, query?: undefined, columnId?: string, method?: QueryFilter["method"]): QueryInput;
+  addUserFilter<TQuery extends QueryInput>(value: string, query: TQuery, columnId?: string, method?: QueryFilter["method"]): TQuery;
+  protected procedure<TInput, TCtx extends ServiceProcedureContext = DefaultContext>(name: string): ServiceProcedureBuilder<TInput, TCtx, Repositories, Services>;
+  addContextFilter(actor: AuthenticatedActor, include?: {
+    user?: boolean;
+    organization?: boolean;
+    team?: boolean;
+  }, query?: undefined, map?: Record<string, {
+    columnId: string;
+    method: QueryFilter["method"];
+  }>): QueryInput;
+  addContextFilter<TQuery extends QueryInput>(actor: AuthenticatedActor, include: {
+    user?: boolean;
+    organization?: boolean;
+    team?: boolean;
+  } | undefined, query: TQuery, map?: Record<string, {
+    columnId: string;
+    method: QueryFilter["method"];
+  }>): TQuery;
+}
+declare class BasePermissionService<Repositories extends Record<string, Base>, Services extends Record<string, Base>, DefaultContext extends ServiceProcedureContext = ServiceProcedureContext> extends BaseService<Repositories, Services, DefaultContext> {
+  grants: ResourceGrant[];
+  constructor(repository: Repositories, service: Services, grants?: ResourceGrant[]);
+  accessGuard<T extends Entity>(actor: AuthenticatedActor, action: string, entities?: T | T[], grants?: ResourceActionGrant[]): ServerResult<true>;
+  accessGuardAsync<T extends Entity>(actor: AuthenticatedActor, action: string, getEntities: () => ServerResultAsync<T | T[] | undefined>, grants?: ResourceActionGrant[]): ServerResultAsync<true>;
+  protected procedure<TInput, TCtx extends ServiceProcedureContext = DefaultContext>(name: string): PermissionServiceProcedureBuilder<TInput, TCtx, Repositories, Services>;
+  checkPermission<T extends Entity>(actor: AuthenticatedActor, action: string, entities?: T | T[], grants?: ResourceActionGrant[]): boolean;
+  checkPermissionAsync<T extends Entity>(actor: AuthenticatedActor, action: string, getEntities: () => ServerResultAsync<T | T[] | undefined>, grants?: ResourceActionGrant[]): ServerResultAsync<boolean>;
+}
+//#endregion
+export { BasePermissionService, BaseService, type PermissionServiceProcedureBuilder, type ServiceProcedure, type ServiceProcedureAccessConfig, type ServiceProcedureAccessEntitiesConfig, type ServiceProcedureAccessStateConfig, type ServiceProcedureArgs, type ServiceProcedureBuilder, type ServiceProcedureContext, type ServiceProcedureContextFilterScope, type ServiceProcedureContextFilteredInput, type ServiceProcedureEntityStepName, type ServiceProcedureInputMapper };
+//# sourceMappingURL=base.service.d.mts.map

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

@@ -0,0 +1,116 @@
+import { validateActor } from "./base.actor.mjs";
+import { Base } from "./base.abstract.mjs";
+import { checkPermissionAsync, checkPermissionSync } from "./base.grants.mjs";
+import { createPermissionServiceProcedureBuilder, createServiceProcedureBuilder } from "./base.procedure.mjs";
+import { err, ok } from "neverthrow";
+//#region src/modules/base/base.service.ts
+var BaseService = class extends Base {
+	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] };
+	}
+	procedure(name) {
+		return createServiceProcedureBuilder(this, {
+			name,
+			steps: []
+		});
+	}
+	addContextFilter(actor, 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: actor.userId
+		});
+		if (include.organization) {
+			if (!validateActor(actor, "organization")) throw new Error("Organization-scoped context filter requires an organization actor");
+			filters.push({
+				columnId: map.organizationId.columnId,
+				type: "string",
+				method: map.organizationId.method,
+				value: actor.organizationId
+			});
+		}
+		if (include.team) {
+			if (!validateActor(actor, "team")) throw new Error("Team-scoped context filter requires a team actor");
+			filters.push({
+				columnId: map.teamId.columnId,
+				type: "string",
+				method: map.teamId.method,
+				value: actor.teamId
+			});
+		}
+		return query ? {
+			...query,
+			filters: [...query?.filters ?? [], ...filters]
+		} : { filters };
+	}
+};
+var BasePermissionService = class extends BaseService {
+	grants;
+	constructor(repository, service, grants = []) {
+		super(repository, service);
+		this.grants = grants;
+	}
+	accessGuard(actor, action, entities, grants) {
+		if (!this.checkPermission(actor, action, entities, grants)) return this.error("FORBIDDEN");
+		return ok(true);
+	}
+	async accessGuardAsync(actor, action, getEntities, grants) {
+		const hasPermission = await this.checkPermissionAsync(actor, action, getEntities, grants);
+		if (hasPermission.isErr()) return err(hasPermission.error);
+		if (!hasPermission.value) return this.error("FORBIDDEN");
+		return ok(true);
+	}
+	procedure(name) {
+		return createPermissionServiceProcedureBuilder(this, {
+			name,
+			steps: []
+		});
+	}
+	checkPermission(actor, action, entities, grants) {
+		return checkPermissionSync(actor, grants ?? this.grants.filter((grant) => grant.action === action), entities);
+	}
+	async checkPermissionAsync(actor, action, getEntities, grants) {
+		const permission = await checkPermissionAsync(actor, grants ?? this.grants.filter((grant) => grant.action === action), getEntities);
+		if (permission.isErr()) return this.error("INTERNAL_SERVER_ERROR", "Failed to check permission", { cause: permission.error });
+		return ok(permission.value);
+	}
+};
+//#endregion
+export { BasePermissionService, BaseService };
+
+//# sourceMappingURL=base.service.mjs.map

package/dist/src/modules/base/base.service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.service.mjs","names":[],"sources":["../../../../src/modules/base/base.service.ts"],"sourcesContent":["import type { QueryFilter, QueryInput } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport { err, ok } from \"neverthrow\";\r\nimport { Base } from \"./base.abstract\";\r\nimport { type AuthenticatedActor, validateActor } from \"./base.actor\";\r\nimport type { ServerResult, ServerResultAsync } from \"./base.dto\";\r\nimport {\r\n  checkPermissionAsync,\r\n  checkPermissionSync,\r\n  type Entity,\r\n  type ResourceActionGrant,\r\n  type ResourceGrant,\r\n} from \"./base.grants\";\r\nimport {\r\n  createPermissionServiceProcedureBuilder,\r\n  createServiceProcedureBuilder,\r\n  type PermissionServiceProcedureBuilder,\r\n  type ServiceProcedureBuilder,\r\n  type ServiceProcedureContext,\r\n} from \"./base.procedure\";\r\n\r\nexport type {\r\n  PermissionServiceProcedureBuilder,\r\n  ServiceProcedure,\r\n  ServiceProcedureAccessConfig,\r\n  ServiceProcedureAccessEntitiesConfig,\r\n  ServiceProcedureAccessStateConfig,\r\n  ServiceProcedureArgs,\r\n  ServiceProcedureBuilder,\r\n  ServiceProcedureContext,\r\n  ServiceProcedureContextFilteredInput,\r\n  ServiceProcedureContextFilterScope,\r\n  ServiceProcedureEntityStepName,\r\n  ServiceProcedureInputMapper,\r\n} from \"./base.procedure\";\r\n\r\nexport class BaseService<\r\n  Repositories extends Record<string, Base>,\r\n  Services extends Record<string, Base>,\r\n  DefaultContext extends ServiceProcedureContext = ServiceProcedureContext,\r\n> extends Base {\r\n  constructor(\r\n    public repository: Repositories = {} as Repositories,\r\n    public service: Services = {} as Services\r\n  ) {\r\n    super(\"service\");\r\n    this.repository = repository;\r\n    this.service = service;\r\n  }\r\n\r\n  addUserFilter(\r\n    value: string,\r\n    query?: undefined,\r\n    columnId?: string,\r\n    method?: QueryFilter[\"method\"]\r\n  ): QueryInput;\r\n  addUserFilter<TQuery extends QueryInput>(\r\n    value: string,\r\n    query: TQuery,\r\n    columnId?: string,\r\n    method?: QueryFilter[\"method\"]\r\n  ): TQuery;\r\n  addUserFilter(\r\n    value: string,\r\n    query?: QueryInput,\r\n    columnId = \"userId\",\r\n    method: QueryFilter[\"method\"] = \"equals\"\r\n  ): QueryInput {\r\n    const userFilter: QueryFilter = {\r\n      columnId,\r\n      type: \"string\",\r\n      method,\r\n      value,\r\n    };\r\n    return query\r\n      ? { ...query, filters: [...(query?.filters ?? []), userFilter] }\r\n      : { filters: [userFilter] };\r\n  }\r\n\r\n  protected procedure<TInput, TCtx extends ServiceProcedureContext = DefaultContext>(\r\n    name: string\r\n  ): ServiceProcedureBuilder<TInput, TCtx, Repositories, Services> {\r\n    return createServiceProcedureBuilder(this, { name, steps: [] });\r\n  }\r\n\r\n  addContextFilter(\r\n    actor: AuthenticatedActor,\r\n    include?: { user?: boolean; organization?: boolean; team?: boolean },\r\n    query?: undefined,\r\n    map?: Record<string, { columnId: string; method: QueryFilter[\"method\"] }>\r\n  ): QueryInput;\r\n  addContextFilter<TQuery extends QueryInput>(\r\n    actor: AuthenticatedActor,\r\n    include: { user?: boolean; organization?: boolean; team?: boolean } | undefined,\r\n    query: TQuery,\r\n    map?: Record<string, { columnId: string; method: QueryFilter[\"method\"] }>\r\n  ): TQuery;\r\n  addContextFilter(\r\n    actor: AuthenticatedActor,\r\n    include: { user?: boolean; organization?: boolean; team?: boolean } = {\r\n      user: true,\r\n      organization: false,\r\n      team: false,\r\n    },\r\n    query?: QueryInput,\r\n    map: Record<string, { columnId: string; method: QueryFilter[\"method\"] }> = {\r\n      userId: {\r\n        columnId: \"userId\",\r\n        method: \"equals\",\r\n      },\r\n      organizationId: {\r\n        columnId: \"organizationId\",\r\n        method: \"equals\",\r\n      },\r\n      teamId: {\r\n        columnId: \"teamId\",\r\n        method: \"equals\",\r\n      },\r\n    }\r\n  ): QueryInput {\r\n    const filters: QueryFilter[] = [];\r\n\r\n    if (include.user) {\r\n      filters.push({\r\n        columnId: map.userId.columnId,\r\n        type: \"string\",\r\n        method: map.userId.method,\r\n        value: actor.userId,\r\n      });\r\n    }\r\n    if (include.organization) {\r\n      if (!validateActor(actor, \"organization\")) {\r\n        throw new Error(\"Organization-scoped context filter requires an organization actor\");\r\n      }\r\n      filters.push({\r\n        columnId: map.organizationId.columnId,\r\n        type: \"string\",\r\n        method: map.organizationId.method,\r\n        value: actor.organizationId!,\r\n      });\r\n    }\r\n    if (include.team) {\r\n      if (!validateActor(actor, \"team\")) {\r\n        throw new Error(\"Team-scoped context filter requires a team actor\");\r\n      }\r\n      filters.push({\r\n        columnId: map.teamId.columnId,\r\n        type: \"string\",\r\n        method: map.teamId.method,\r\n        value: actor.teamId!,\r\n      });\r\n    }\r\n    return query ? { ...query, filters: [...(query?.filters ?? []), ...filters] } : { filters };\r\n  }\r\n}\r\n\r\nexport class BasePermissionService<\r\n  Repositories extends Record<string, Base>,\r\n  Services extends Record<string, Base>,\r\n  DefaultContext extends ServiceProcedureContext = ServiceProcedureContext,\r\n> extends BaseService<Repositories, Services, DefaultContext> {\r\n  grants: ResourceGrant[];\r\n  constructor(repository: Repositories, service: Services, grants: ResourceGrant[] = []) {\r\n    super(repository, service);\r\n    this.grants = grants;\r\n  }\r\n\r\n  accessGuard<T extends Entity>(\r\n    actor: AuthenticatedActor,\r\n    action: string,\r\n    entities?: T | T[],\r\n    grants?: ResourceActionGrant[]\r\n  ): ServerResult<true> {\r\n    const hasPermission = this.checkPermission(actor, action, entities, grants);\r\n    if (!hasPermission) return this.error(\"FORBIDDEN\");\r\n    return ok(true);\r\n  }\r\n\r\n  async accessGuardAsync<T extends Entity>(\r\n    actor: AuthenticatedActor,\r\n    action: string,\r\n    getEntities: () => ServerResultAsync<T | T[] | undefined>,\r\n    grants?: ResourceActionGrant[]\r\n  ): ServerResultAsync<true> {\r\n    const hasPermission = await this.checkPermissionAsync(actor, action, getEntities, grants);\r\n    if (hasPermission.isErr()) return err(hasPermission.error);\r\n    if (!hasPermission.value) return this.error(\"FORBIDDEN\");\r\n    return ok(true);\r\n  }\r\n\r\n  protected override procedure<TInput, TCtx extends ServiceProcedureContext = DefaultContext>(\r\n    name: string\r\n  ): PermissionServiceProcedureBuilder<TInput, TCtx, Repositories, Services> {\r\n    return createPermissionServiceProcedureBuilder(this, { name, steps: [] });\r\n  }\r\n\r\n  checkPermission<T extends Entity>(\r\n    actor: AuthenticatedActor,\r\n    action: string,\r\n    entities?: T | T[],\r\n    grants?: ResourceActionGrant[]\r\n  ): boolean {\r\n    const actionGrants = grants ?? this.grants.filter((grant) => grant.action === action);\r\n    return checkPermissionSync(actor, actionGrants, entities);\r\n  }\r\n\r\n  async checkPermissionAsync<T extends Entity>(\r\n    actor: AuthenticatedActor,\r\n    action: string,\r\n    getEntities: () => ServerResultAsync<T | T[] | undefined>,\r\n    grants?: ResourceActionGrant[]\r\n  ): ServerResultAsync<boolean> {\r\n    const actionGrants = grants ?? this.grants.filter((grant) => grant.action === action);\r\n    const permission = await checkPermissionAsync(actor, actionGrants, getEntities);\r\n    if (permission.isErr())\r\n      return this.error(\"INTERNAL_SERVER_ERROR\", \"Failed to check permission\", {\r\n        cause: permission.error,\r\n      });\r\n    return ok(permission.value);\r\n  }\r\n}\r\n"],"mappings":"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"}

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

@@ -0,0 +1,5 @@
+//#region src/modules/base/base.types.d.ts
+type ServerErrorLayer = "unknown" | "repository" | "service" | "controller" | "auth" | "workflow";
+//#endregion
+export { ServerErrorLayer };
+//# sourceMappingURL=base.types.d.mts.map