@rockster/core 0.0.4 → 0.1.0

package/tasks/functions/task-message-operations.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryTaskMessages = queryTaskMessages;
+exports.createTaskMessage = createTaskMessage;
+exports.retryTaskMessage = retryTaskMessage;
+const common_1 = require("@rockster/common");
+const tasks_1 = require("@rockster/common/tasks");
+const execute_post_1 = require("../../command/functions/execute-post");
+const use_repository_1 = require("../../database/functions/use-repository");
+const execute_query_1 = require("../../query/functions/execute-query");
+const generate_entity_id_1 = require("./generate-entity-id");
+const request_context_1 = require("../../core/contexts/request-context");
+const task_hook_1 = require("../interfaces/task-hook");
+const run_task_post_hooks_1 = require("./run-task-post-hooks");
+const validate_task_payload_1 = require("./validate-task-payload");
+function isTaskObjectNote(task) {
+    return typeof task === "object" && task != null && "objectKey" in task;
+}
+function resolveTaskObject(task) {
+    if (isTaskObjectNote(task)) {
+        return task;
+    }
+    return core.storage.findObject(task);
+}
+const createEmptyRequestContext = () => ({
+    response: {},
+    request: {},
+    pendings: [],
+    callbacks: {
+        success: [],
+        error: [],
+    },
+    onSuccess: async () => { },
+    onError: async () => { },
+});
+function resolveRequestContext(options) {
+    return options?.requestContext
+        ?? request_context_1.requestContextStore.getStore()
+        ?? createEmptyRequestContext();
+}
+/** Same semantics as {@link TaskController.query}. */
+async function queryTaskMessages(content) {
+    return (0, execute_query_1.executeQuery)({ content });
+}
+async function createTaskMessage(task, payload, options) {
+    const object = resolveTaskObject(task);
+    const skipPhases = new Set(options?.skipPhases ?? []);
+    const requestContext = resolveRequestContext(options);
+    const Payload = object.payload();
+    if (!skipPhases.has(task_hook_1.taskHookPhase.beforeValidation)) {
+        await (0, run_task_post_hooks_1.runTaskPostHooks)(object, task_hook_1.taskHookPhase.beforeValidation, {
+            payload,
+            requestContext,
+        });
+        await (0, validate_task_payload_1.validateTaskPayload)(Payload, payload);
+    }
+    const data = {
+        id: (0, generate_entity_id_1.generateEntityId)(),
+        partitionId: object.nextPartitionId(),
+        payload,
+        createdAt: new Date(),
+        lastModifiedAt: new Date(),
+    };
+    if (!skipPhases.has(task_hook_1.taskHookPhase.beforeExecute)) {
+        await (0, run_task_post_hooks_1.runTaskPostHooks)(object, task_hook_1.taskHookPhase.beforeExecute, {
+            payload,
+            requestContext,
+            message: data,
+        });
+    }
+    return (0, execute_post_1.executePost)({
+        type: "create",
+        target: object.MessageModel,
+        idProperty: "id",
+        data,
+    });
+}
+/** Same semantics as {@link TaskController.retry}. */
+async function retryTaskMessage(object, message) {
+    const repository = (0, use_repository_1.useRepository)(object.MessageModel);
+    const stored = await repository.findOneBy({
+        id: message.id,
+    });
+    if (!stored || stored.status !== tasks_1.TaskMessageStatus.failed) {
+        throw new common_1.BadRequestError({
+            message: `Reprocessing unavailable for this task`,
+        });
+    }
+    const data = {
+        payload: message.payload,
+        lastModifiedAt: new Date(),
+        status: tasks_1.TaskMessageStatus.pending,
+    };
+    await repository.update({
+        id: message.id,
+        partitionId: stored.partitionId,
+    }, data);
+    return { ...stored, ...data };
+}
+//# sourceMappingURL=task-message-operations.js.map

package/tasks/functions/task-message-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-message-operations.js","sourceRoot":"./","sources":["tasks/functions/task-message-operations.ts"],"names":[],"mappings":"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"}

package/tasks/functions/validate-task-payload.d.ts

@@ -0,0 +1,2 @@
+import { Instantiable } from "@rockster/common";
+export declare const validateTaskPayload: (Payload: Instantiable, payload: unknown) => Promise<void>;

package/tasks/functions/validate-task-payload.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTaskPayload = void 0;
+const class_pipe_1 = require("@rockster/class-pipe");
+const global_1 = require("../../global");
+const validateTaskPayload = async (Payload, payload) => {
+    const sanitized = {};
+    const errors = await (0, class_pipe_1.validate)(Payload, payload, sanitized, {
+        groups: [global_1.actionGroups.create],
+    });
+    if (errors) {
+        throw errors;
+    }
+    if (payload && typeof payload === "object" && !Array.isArray(payload)) {
+        Object.assign(payload, sanitized);
+    }
+};
+exports.validateTaskPayload = validateTaskPayload;
+//# sourceMappingURL=validate-task-payload.js.map

package/tasks/functions/validate-task-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-task-payload.js","sourceRoot":"./","sources":["tasks/functions/validate-task-payload.ts"],"names":[],"mappings":";;;AACA,qDAAgD;AAChD,yCAA4C;AAErC,MAAM,mBAAmB,GAAG,KAAK,EACrC,OAAqB,EACrB,OAAgB,EACF,EAAE;IAChB,MAAM,SAAS,GAAG,EAA6B,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAQ,EAC1B,OAAO,EACP,OAAO,EACP,SAAS,EACT;QACG,MAAM,EAAE,CAAC,qBAAY,CAAC,MAAM,CAAC;KAC/B,CACH,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACV,MAAM,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrE,MAAM,CAAC,MAAM,CAAC,OAAiB,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;AACJ,CAAC,CAAC;AArBW,QAAA,mBAAmB,uBAqB9B"}

package/tasks/hook-constants.d.ts

@@ -0,0 +1,2 @@
+export declare const TASK_PAYLOAD_KEY = "TASK_PAYLOAD";
+export declare const TASK_MESSAGE_KEY = "TASK_MESSAGE";

package/tasks/hook-constants.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TASK_MESSAGE_KEY = exports.TASK_PAYLOAD_KEY = void 0;
+exports.TASK_PAYLOAD_KEY = 'TASK_PAYLOAD';
+exports.TASK_MESSAGE_KEY = 'TASK_MESSAGE';
+//# sourceMappingURL=hook-constants.js.map

package/tasks/hook-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-constants.js","sourceRoot":"./","sources":["tasks/hook-constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,gBAAgB,GAAG,cAAc,CAAC;AAClC,QAAA,gBAAgB,GAAG,cAAc,CAAC"}

package/tasks/index.d.ts

@@ -1,5 +1,8 @@
 export * from './interfaces';
 export * from './decorators';
+export * from './hook-constants';
+export * from './functions/create-task-hook';
 export * from './functions/throw-task-error';
+export * from './functions/task-message-operations';
 export * from './tasks.module';
 export * from './models';

package/tasks/index.js

@@ -16,7 +16,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./interfaces"), exports);
 __exportStar(require("./decorators"), exports);
+__exportStar(require("./hook-constants"), exports);
+__exportStar(require("./functions/create-task-hook"), exports);
 __exportStar(require("./functions/throw-task-error"), exports);
+__exportStar(require("./functions/task-message-operations"), exports);
 __exportStar(require("./tasks.module"), exports);
 __exportStar(require("./models"), exports);
 //# sourceMappingURL=index.js.map

package/tasks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"./","sources":["tasks/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,+CAA6B;AAC7B,+DAA6C;AAC7C,iDAA+B;AAC/B,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"./","sources":["tasks/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,+CAA6B;AAC7B,mDAAiC;AACjC,+DAA6C;AAC7C,+DAA6C;AAC7C,sEAAoD;AACpD,iDAA+B;AAC/B,2CAAyB"}

package/tasks/interfaces/compiled-task-post-hooks.d.ts

@@ -0,0 +1,17 @@
+import { Dictionary } from "@rockster/common";
+import { IRequestContext } from "../../core/interfaces/request-context";
+import { ITaskMessage } from "@rockster/common/tasks";
+export type TaskPostHookInitialData = Dictionary<unknown> & {
+    payload: unknown;
+    requestContext?: IRequestContext;
+    message?: Partial<ITaskMessage>;
+};
+export type TaskPostHookHandle = {
+    (initialData: TaskPostHookInitialData): Promise<void>;
+    interceptorName: string;
+    phase: string;
+};
+export type CompiledTaskPostHooks = {
+    beforeValidation: TaskPostHookHandle[];
+    beforeExecute: TaskPostHookHandle[];
+};

package/tasks/interfaces/compiled-task-post-hooks.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=compiled-task-post-hooks.js.map

package/tasks/interfaces/compiled-task-post-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-task-post-hooks.js","sourceRoot":"./","sources":["tasks/interfaces/compiled-task-post-hooks.ts"],"names":[],"mappings":""}

package/tasks/interfaces/index.d.ts

@@ -1,5 +1,8 @@
 export * from './task-naming';
 export * from './task-object';
+export * from './task-hook';
+export * from './task-post-hook';
+export * from './compiled-task-post-hooks';
 export * from './task-post-intercept';
 export * from './task-runner';
 export * from './task-search-intercept';

package/tasks/interfaces/index.js

@@ -16,6 +16,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./task-naming"), exports);
 __exportStar(require("./task-object"), exports);
+__exportStar(require("./task-hook"), exports);
+__exportStar(require("./task-post-hook"), exports);
+__exportStar(require("./compiled-task-post-hooks"), exports);
 __exportStar(require("./task-post-intercept"), exports);
 __exportStar(require("./task-runner"), exports);
 __exportStar(require("./task-search-intercept"), exports);

package/tasks/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"./","sources":["tasks/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,gDAA8B;AAC9B,wDAAsC;AACtC,gDAA8B;AAC9B,0DAAwC;AACxC,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"./","sources":["tasks/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,gDAA8B;AAC9B,8CAA4B;AAC5B,mDAAiC;AACjC,6DAA2C;AAC3C,wDAAsC;AACtC,gDAA8B;AAC9B,0DAAwC;AACxC,kDAAgC"}

package/tasks/interfaces/task-hook.d.ts

@@ -0,0 +1,16 @@
+import { Instantiable } from "@rockster/common";
+export declare const taskHookPhase: {
+    readonly beforeValidation: "taskHook.beforeValidation";
+    readonly beforeExecute: "taskHook.beforeExecute";
+};
+export type TaskHookPhase = typeof taskHookPhase[keyof typeof taskHookPhase];
+export type TaskHookDef = {
+    name: string;
+    phase: TaskHookPhase;
+    executor: Instantiable;
+};
+export type TaskHook = TaskHookDef & {
+    instance?: {
+        intercept(...args: unknown[]): Promise<unknown>;
+    };
+};

package/tasks/interfaces/task-hook.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taskHookPhase = void 0;
+exports.taskHookPhase = {
+    beforeValidation: 'taskHook.beforeValidation',
+    beforeExecute: 'taskHook.beforeExecute',
+};
+//# sourceMappingURL=task-hook.js.map

package/tasks/interfaces/task-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-hook.js","sourceRoot":"./","sources":["tasks/interfaces/task-hook.ts"],"names":[],"mappings":";;;AAEa,QAAA,aAAa,GAAG;IAC1B,gBAAgB,EAAE,2BAA2B;IAC7C,aAAa,EAAE,wBAAwB;CAChC,CAAC"}

package/tasks/interfaces/task-object.d.ts

@@ -4,6 +4,8 @@ import { IObject } from "../../core";
 import { ITaskSettings } from "./task-settings";
 import { PgTableWithColumns } from "drizzle-orm/pg-core";
 import { ITaskNaming } from "./task-naming";
+import { CompiledTaskPostHooks } from "./compiled-task-post-hooks";
+import { TaskPostHook } from "./task-post-hook";
 import { TaskPostIntercept } from "./task-post-intercept";
 export interface ITaskObject extends IObject {
     type: ObjectType.task;
@@ -16,4 +18,6 @@ export interface ITaskObject extends IObject {
     naming: ITaskNaming;
     nextPartitionId: () => number;
     postInterceptors?: TaskPostIntercept[];
+    postHooks?: TaskPostHook[];
+    compiledPostHooks?: CompiledTaskPostHooks;
 }

package/tasks/interfaces/task-post-hook.d.ts

@@ -0,0 +1,2 @@
+import { TaskHookDef } from "./task-hook";
+export type TaskPostHook = TaskHookDef;

package/{database/interfaces/protector.js → tasks/interfaces/task-post-hook.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=protector.js.map
+//# sourceMappingURL=task-post-hook.js.map

package/tasks/interfaces/task-post-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-post-hook.js","sourceRoot":"./","sources":["tasks/interfaces/task-post-hook.ts"],"names":[],"mappings":""}

package/tasks/interfaces/task-settings.d.ts

@@ -1,4 +1,5 @@
 import { GetTypeCallback } from "@rockster/common";
+import { TaskPostHook } from "./task-post-hook";
 import { TaskPostIntercept } from "./task-post-intercept";
 export interface ITaskSettings<T> {
     /**Executor for any message */
@@ -13,5 +14,9 @@ export interface ITaskSettings<T> {
     retentionDays?: number;
     /**limit: 100. Indicates how many messages the runner will recieve to proccess*/
     messagesLimit?: number;
+    /**
+     * @deprecated Use `postHooks` instead.
+     */
     postInterceptors?: TaskPostIntercept[];
+    postHooks?: TaskPostHook[];
 }

package/tasks/services/task-runner.service.d.ts

@@ -9,15 +9,36 @@ type TaskRunner = {
     runner: ITaskRunner<any>;
     repository: Repository<ITaskMessage>;
 };
+/**
+ * Worker-side task dispatcher: claims pending rows with `SKIP LOCKED`, runs runners concurrently
+ * up to {@link TaskRunnerService.maxConcurrentTaskMessages}, without blocking the poll interval on
+ * long-running `onRun` handlers.
+ */
 export declare class TaskRunnerService {
-    private static running;
+    /**
+     * Max concurrent task **messages** being executed at once (per worker thread / process).
+     * Tune here if workloads need more / less parallelism.
+     */
+    static readonly maxConcurrentTaskMessages = 50;
+    /** @deprecated Reserved for future graceful shutdown hooks; not read by the runner today. */
     private static done;
     tasks: TaskRunner[];
+    /** Messages currently in `onRun` or DB update after run (best-effort counter). */
+    private inFlightCount;
+    /** Serializes {@link fillPool} so two ticks cannot claim overlapping capacity. */
+    private drainChain;
     activeTimer(): void;
     constructor();
+    /** How many task messages are executing right now (0 … {@link maxConcurrentTaskMessages}). */
+    getConcurrentInFlight(): number;
     startRunner(object: ObjectNote<ITaskObject>): Promise<void>;
-    protected processMessages(): Promise<void>;
-    protected eachMessage(task: TaskRunner, message: TaskMessage<any>): Promise<void>;
+    protected scheduleFillPool(): void;
+    /**
+     * Claims pending messages up to remaining global capacity and **starts** them without awaiting
+     * completion (each execution decrements {@link inFlightCount} in `finally`).
+     */
+    protected fillPool(): Promise<void>;
+    protected executeTaskMessage(task: TaskRunner, message: TaskMessage<any>): Promise<void>;
     protected mapMessage(row: any): TaskMessage<any>;
 }
 export {};

package/tasks/services/task-runner.service.js

@@ -15,13 +15,28 @@ const get_pending_task_script_1 = require("../functions/get-pending-task-script"
 const use_repository_1 = require("../../database/functions/use-repository");
 const tasks_1 = require("@rockster/common/tasks");
 const class_injector_1 = require("@rockster/class-injector");
+/**
+ * Worker-side task dispatcher: claims pending rows with `SKIP LOCKED`, runs runners concurrently
+ * up to {@link TaskRunnerService.maxConcurrentTaskMessages}, without blocking the poll interval on
+ * long-running `onRun` handlers.
+ */
 let TaskRunnerService = TaskRunnerService_1 = class TaskRunnerService {
     activeTimer() {
         TaskRunnerService_1.done = true;
     }
     constructor() {
         this.tasks = [];
-        setInterval(() => this.processMessages(), 500);
+        /** Messages currently in `onRun` or DB update after run (best-effort counter). */
+        this.inFlightCount = 0;
+        /** Serializes {@link fillPool} so two ticks cannot claim overlapping capacity. */
+        this.drainChain = Promise.resolve();
+        setInterval(() => {
+            this.scheduleFillPool();
+        }, 500);
+    }
+    /** How many task messages are executing right now (0 … {@link maxConcurrentTaskMessages}). */
+    getConcurrentInFlight() {
+        return this.inFlightCount;
     }
     async startRunner(object) {
         const runner = await (0, class_injector_1.createInstance)(object.objectClass);
@@ -29,51 +44,69 @@ let TaskRunnerService = TaskRunnerService_1 = class TaskRunnerService {
         this.tasks.push({
             object: object,
             runner: runner,
-            repository: repository
+            repository: repository,
         });
     }
-    async processMessages() {
-        try {
-            if (TaskRunnerService_1.running)
-                return;
-            TaskRunnerService_1.running = true;
-            for (const task of this.tasks) {
-                const query = (0, get_pending_task_script_1.getPendingTaskScript)(task.object.naming, core.workerId);
-                const messages = (await task.repository.query(query))[0];
-                await Promise.all(messages.map((message) => this.eachMessage(task, this.mapMessage(message))));
+    scheduleFillPool() {
+        this.drainChain = this.drainChain
+            .then(() => this.fillPool())
+            .catch(() => {
+            // Swallow: next interval will retry; avoid breaking the chain.
+        });
+    }
+    /**
+     * Claims pending messages up to remaining global capacity and **starts** them without awaiting
+     * completion (each execution decrements {@link inFlightCount} in `finally`).
+     */
+    async fillPool() {
+        const max = TaskRunnerService_1.maxConcurrentTaskMessages;
+        for (const task of this.tasks) {
+            while (this.inFlightCount < max) {
+                const room = max - this.inFlightCount;
+                const query = (0, get_pending_task_script_1.getPendingTaskScript)(task.object.naming, core.workerId, room);
+                const rows = (await task.repository.query(query))[0];
+                const rawMessages = Array.isArray(rows) ? rows : [];
+                if (rawMessages.length === 0) {
+                    break;
+                }
+                for (const row of rawMessages) {
+                    const message = this.mapMessage(row);
+                    this.inFlightCount++;
+                    void this.executeTaskMessage(task, message).finally(() => {
+                        this.inFlightCount--;
+                    });
+                }
             }
-            TaskRunnerService_1.running = false;
-        }
-        catch (error) {
-            TaskRunnerService_1.running = false;
         }
     }
-    async eachMessage(task, message) {
+    async executeTaskMessage(task, message) {
         const stopwatch = getTimer();
         try {
             stopwatch.start();
-            await task
-                .runner
-                .onRun({
-                message: message
+            await task.runner.onRun({
+                message: message,
             });
             await task.repository.update({
                 id: message.id,
-                partitionId: message.partitionId
+                partitionId: message.partitionId,
             }, {
                 status: tasks_1.TaskMessageStatus.completed,
                 lastModifiedAt: new Date(),
                 runtimeMs: stopwatch.stop(),
-                payload: message.payload
+                payload: message.payload,
             });
         }
         catch (error) {
             const taskError = error;
-            taskError.infos = getErrorInfos(error).message;
-            const isExpose = error.constructor.name !== 'Error';
+            const { message: errorDetail } = getErrorInfos(error);
+            taskError.infos = errorDetail;
+            if (errorDetail?.trim()) {
+                taskError.message = errorDetail.trim().split("\n")[0].trim();
+            }
+            const isExpose = error.constructor.name !== "Error";
             await task.repository.update({
                 id: message.id,
-                partitionId: message.partitionId
+                partitionId: message.partitionId,
             }, {
                 status: tasks_1.TaskMessageStatus.failed,
                 lastModifiedAt: new Date(),
@@ -81,7 +114,7 @@ let TaskRunnerService = TaskRunnerService_1 = class TaskRunnerService {
                 runtimeMs: stopwatch.stop(),
                 internalError: taskError,
                 error: isExpose ? taskError : null,
-                payload: message.payload
+                payload: message.payload,
             });
         }
     }
@@ -96,12 +129,17 @@ let TaskRunnerService = TaskRunnerService_1 = class TaskRunnerService {
             error: row.error,
             internalError: row.internal_error,
             payload: row.payload,
-            runtimeMs: row.runtime_ms
+            runtimeMs: row.runtime_ms,
         };
     }
 };
 exports.TaskRunnerService = TaskRunnerService;
-TaskRunnerService.running = false;
+/**
+ * Max concurrent task **messages** being executed at once (per worker thread / process).
+ * Tune here if workloads need more / less parallelism.
+ */
+TaskRunnerService.maxConcurrentTaskMessages = 50;
+/** @deprecated Reserved for future graceful shutdown hooks; not read by the runner today. */
 TaskRunnerService.done = false;
 exports.TaskRunnerService = TaskRunnerService = TaskRunnerService_1 = __decorate([
     (0, class_injector_1.Injectable)(),

package/tasks/services/task-runner.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-runner.service.js","sourceRoot":"./","sources":["tasks/services/task-runner.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-runner.service.js","sourceRoot":"./","sources":["tasks/services/task-runner.service.ts"],"names":[],"mappings":"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"}

package/database/functions/use-protector.d.ts

@@ -1,2 +0,0 @@
-import { Instantiable } from "@rockster/common";
-export declare const useProtector: (target: Instantiable) => import("../interfaces").Protector;

package/database/functions/use-protector.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useProtector = void 0;
-const useProtector = (target) => {
-    const object = core
-        .storage
-        .findObject(target);
-    return object?.protector;
-};
-exports.useProtector = useProtector;
-//# sourceMappingURL=use-protector.js.map

package/database/functions/use-protector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-protector.js","sourceRoot":"./","sources":["database/functions/use-protector.ts"],"names":[],"mappings":";;;AAIO,MAAM,YAAY,GAAG,CAAC,MAAoB,EAAE,EAAE;IAClD,MAAM,MAAM,GAAG,IAAI;SACf,OAAO;SACP,UAAU,CAAC,MAAM,CACO,CAAC;IAC7B,OAAO,MAAM,EAAE,SAAS,CAAC;AAC5B,CAAC,CAAA;AANY,QAAA,YAAY,gBAMxB"}

package/database/interfaces/protector.d.ts

@@ -1,51 +0,0 @@
-import { Dictionary, Instantiable } from "@rockster/common";
-import { EntityManager, SelectQueryBuilder } from "typeorm";
-export type IsAuthorizedHandle = {
-    (args: {
-        userId: string;
-        keys: string[];
-        contextId?: string;
-        entityManager?: EntityManager;
-        context?: string;
-    }): Promise<void>;
-};
-export type GetUserPermissionsHandle = {
-    (args: {
-        userId: string;
-        targetUserId: string;
-        contextId: string;
-        entityManager?: EntityManager;
-        context: string;
-    }): Promise<string[]>;
-};
-export type SetUserPermissionsHandle = {
-    (args: {
-        userId: string;
-        targetUserId: string;
-        contextId: string;
-        entityManager?: EntityManager;
-        context: string;
-        accessKeys: string[];
-    }): Promise<void>;
-};
-export type Protector = {
-    target: Instantiable;
-    rootCondition?: (args: {
-        rootAlias: string;
-        queryBuilder: SelectQueryBuilder<any>;
-        userId: string;
-        contextParams: Dictionary<any>;
-    }) => SelectQueryBuilder<any>;
-    relationCondition?: (args: {
-        userId: string;
-        contextParams: Dictionary<any>;
-        alias: string;
-        rootPath: Instantiable;
-    }) => string;
-    canRemove?: (userId: string, entityId: string, entityManager?: EntityManager) => Promise<void>;
-    canModify?: <Entity>(userId: string, value: Entity, entityManager?: EntityManager) => Promise<void>;
-    canCreate?: <Entity>(userId: string, value: Entity, entityManager?: EntityManager) => Promise<void>;
-    isAuthorized?: IsAuthorizedHandle;
-    getUserPermissions?: GetUserPermissionsHandle;
-    setUserPermissions?: SetUserPermissionsHandle;
-};

package/database/interfaces/protector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"protector.js","sourceRoot":"./","sources":["database/interfaces/protector.ts"],"names":[],"mappings":""}