@tmscloud/tbt-knex 0.0.4 → 0.0.6

package/dist/dao/duty-item-progress/duty-item-progress.dao.d.ts

@@ -0,0 +1,59 @@
+import { Knex } from "knex";
+import { IDutyItemProgress, IDutyItemProgressUpdate } from "../../interfaces/duty-item-progress/duty-item-progress.interfaces";
+export declare class DutyItemProgressDAO {
+    private _knex?;
+    private get knex();
+    /**
+     * Create progress records for all items in a duty
+     */
+    createForDuty(dutyId: number, items: {
+        template_item_id: number;
+        item_order: number;
+    }[], trx?: Knex.Transaction): Promise<IDutyItemProgress[]>;
+    /**
+     * Get all progress records for a duty
+     */
+    getByDutyId(dutyId: number): Promise<IDutyItemProgress[]>;
+    /**
+     * Get a single progress record by UUID
+     */
+    getByUuid(uuid: string): Promise<IDutyItemProgress | null>;
+    /**
+     * Get a single progress record by ID
+     */
+    getById(id: number): Promise<IDutyItemProgress | null>;
+    /**
+     * Update a single item's progress status
+     */
+    updateItemStatus(id: number, data: IDutyItemProgressUpdate): Promise<IDutyItemProgress | null>;
+    /**
+     * Increment the loop count for a repeating route item
+     */
+    incrementLoopCount(id: number): Promise<IDutyItemProgress | null>;
+    /**
+     * Create a single code-injected item progress record
+     */
+    createCodeInjectedItem(data: {
+        duty_id: number;
+        route_id: number;
+        item_order: number;
+    }, trx?: Knex.Transaction): Promise<IDutyItemProgress>;
+    /**
+     * Delete a code-injected item (safety: only deletes items with template_item_id IS NULL)
+     */
+    deleteCodeInjectedItem(id: number, trx?: Knex.Transaction): Promise<boolean>;
+    /**
+     * Get all code-injected items for a duty
+     */
+    getCodeInjectedByDutyId(dutyId: number): Promise<IDutyItemProgress[]>;
+    /**
+     * Inject a code-route into a duty's item list.
+     * Handles removing a previous injection, reverting the current item,
+     * shifting item orders, and inserting the new item — all in a transaction.
+     */
+    injectRouteItem(dutyId: number, routeId: number, trx?: Knex.Transaction): Promise<IDutyItemProgress>;
+    /**
+     * Delete all progress records for a duty
+     */
+    deleteByDutyId(dutyId: number): Promise<number>;
+}

package/dist/dao/duty-item-progress/duty-item-progress.dao.js

@@ -0,0 +1,229 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DutyItemProgressDAO = void 0;
+const KnexConnection_1 = __importDefault(require("../../KnexConnection"));
+class DutyItemProgressDAO {
+    get knex() {
+        if (!this._knex) {
+            this._knex = KnexConnection_1.default.getConnection();
+        }
+        return this._knex;
+    }
+    /**
+     * Create progress records for all items in a duty
+     */
+    createForDuty(dutyId, items, trx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (items.length === 0)
+                return [];
+            const qb = trx || this.knex;
+            const records = items.map((item) => ({
+                duty_id: dutyId,
+                template_item_id: item.template_item_id,
+                item_order: item.item_order,
+                status: "pending",
+                loop_count: 0,
+            }));
+            const created = yield qb("duty_item_progress")
+                .insert(records)
+                .returning("*");
+            return created;
+        });
+    }
+    /**
+     * Get all progress records for a duty
+     */
+    getByDutyId(dutyId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.knex("duty_item_progress")
+                .where("duty_id", dutyId)
+                .orderBy("item_order", "asc");
+        });
+    }
+    /**
+     * Get a single progress record by UUID
+     */
+    getByUuid(uuid) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.knex("duty_item_progress")
+                .where("uuid", uuid)
+                .first();
+            return result || null;
+        });
+    }
+    /**
+     * Get a single progress record by ID
+     */
+    getById(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.knex("duty_item_progress")
+                .where("id", id)
+                .first();
+            return result || null;
+        });
+    }
+    /**
+     * Update a single item's progress status
+     */
+    updateItemStatus(id, data) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const updateData = {};
+            if (data.status !== undefined)
+                updateData.status = data.status;
+            if (data.started_at !== undefined)
+                updateData.started_at = data.started_at;
+            if (data.completed_at !== undefined)
+                updateData.completed_at = data.completed_at;
+            if (data.loop_count !== undefined)
+                updateData.loop_count = data.loop_count;
+            if (data.time_at_stop !== undefined)
+                updateData.time_at_stop = data.time_at_stop;
+            updateData.updated_at = new Date();
+            const [result] = yield this.knex("duty_item_progress")
+                .where("id", id)
+                .update(updateData)
+                .returning("*");
+            return result || null;
+        });
+    }
+    /**
+     * Increment the loop count for a repeating route item
+     */
+    incrementLoopCount(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const [result] = yield this.knex("duty_item_progress")
+                .where("id", id)
+                .update({
+                loop_count: this.knex.raw("loop_count + 1"),
+                updated_at: new Date(),
+            })
+                .returning("*");
+            return result || null;
+        });
+    }
+    /**
+     * Create a single code-injected item progress record
+     */
+    createCodeInjectedItem(data, trx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const qb = trx || this.knex;
+            const [created] = yield qb("duty_item_progress")
+                .insert({
+                duty_id: data.duty_id,
+                template_item_id: null,
+                route_id: data.route_id,
+                item_order: data.item_order,
+                status: "pending",
+                loop_count: 0,
+            })
+                .returning("*");
+            return created;
+        });
+    }
+    /**
+     * Delete a code-injected item (safety: only deletes items with template_item_id IS NULL)
+     */
+    deleteCodeInjectedItem(id, trx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const qb = trx || this.knex;
+            const result = yield qb("duty_item_progress")
+                .where("id", id)
+                .whereNull("template_item_id")
+                .delete();
+            return result > 0;
+        });
+    }
+    /**
+     * Get all code-injected items for a duty
+     */
+    getCodeInjectedByDutyId(dutyId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.knex("duty_item_progress")
+                .where("duty_id", dutyId)
+                .whereNull("template_item_id")
+                .orderBy("item_order", "asc");
+        });
+    }
+    /**
+     * Inject a code-route into a duty's item list.
+     * Handles removing a previous injection, reverting the current item,
+     * shifting item orders, and inserting the new item — all in a transaction.
+     */
+    injectRouteItem(dutyId, routeId, trx) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!trx) {
+                return this.knex.transaction((t) => this.injectRouteItem(dutyId, routeId, t));
+            }
+            const allItems = yield trx("duty_item_progress")
+                .where("duty_id", dutyId)
+                .orderBy("item_order", "asc");
+            const previousInjection = allItems.find((i) => i.route_id != null &&
+                i.template_item_id == null &&
+                (i.status === "pending" || i.status === "in_progress"));
+            if (previousInjection) {
+                yield trx("duty_item_progress")
+                    .where("id", previousInjection.id)
+                    .delete();
+                yield trx("duty_item_progress")
+                    .where("duty_id", dutyId)
+                    .where("item_order", ">", previousInjection.item_order)
+                    .decrement("item_order", 1);
+            }
+            const freshItems = yield trx("duty_item_progress")
+                .where("duty_id", dutyId)
+                .orderBy("item_order", "asc");
+            const currentItem = freshItems.find((i) => i.status === "in_progress") ||
+                freshItems.find((i) => i.status === "pending");
+            const insertOrder = currentItem ? currentItem.item_order : 0;
+            if (currentItem && currentItem.status === "in_progress") {
+                yield trx("duty_item_progress")
+                    .where("id", currentItem.id)
+                    .update({
+                    status: "pending",
+                    started_at: null,
+                    completed_at: null,
+                    updated_at: new Date(),
+                });
+            }
+            if (freshItems.length > 0) {
+                yield trx("duty_item_progress")
+                    .where("duty_id", dutyId)
+                    .where("item_order", ">=", insertOrder)
+                    .increment("item_order", 1);
+            }
+            const [created] = yield trx("duty_item_progress")
+                .insert({
+                duty_id: dutyId,
+                route_id: routeId,
+                template_item_id: null,
+                item_order: insertOrder,
+                status: "pending",
+                loop_count: 0,
+            })
+                .returning("*");
+            return created;
+        });
+    }
+    /**
+     * Delete all progress records for a duty
+     */
+    deleteByDutyId(dutyId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.knex("duty_item_progress").where("duty_id", dutyId).delete();
+        });
+    }
+}
+exports.DutyItemProgressDAO = DutyItemProgressDAO;
+//# sourceMappingURL=duty-item-progress.dao.js.map

package/dist/dao/duty-item-progress/duty-item-progress.dao.js.map

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

package/dist/dao/duty-template/duty-template.dao.d.ts

@@ -0,0 +1,66 @@
+import { IDutyTemplate, IDutyTemplateCreate, IDutyTemplateUpdate, IDutyTemplateSegment, IDutyTemplateSegmentCreate, IDutyTemplateItem, IDutyTemplateWithDetails } from "../../interfaces/duty-template/duty-template.interfaces";
+import { IBaseDAO, IDataPaginator } from "../../d.types";
+export declare class DutyTemplateDAO implements IBaseDAO<IDutyTemplate> {
+    private _knex?;
+    private get knex();
+    /**
+     * Parse JSON fields from database results
+     */
+    private parseTemplateJson;
+    /**
+     * Parse JSON fields for items (route join)
+     */
+    private parseItemJson;
+    /**
+     * Base query with event and creator joins
+     */
+    private baseQuery;
+    /**
+     * Get all duty templates with pagination
+     */
+    getAll(page?: number, limit?: number): Promise<IDataPaginator<IDutyTemplate>>;
+    /**
+     * Get all duty templates by event ID
+     */
+    getAllByEventId(eventId: number, page?: number, limit?: number): Promise<IDataPaginator<IDutyTemplate>>;
+    /**
+     * Get all duty templates by event UUID
+     */
+    getAllByEventUuid(eventUuid: string, page?: number, limit?: number): Promise<IDataPaginator<IDutyTemplate>>;
+    /**
+     * Get duty template by ID
+     */
+    getById(id: number): Promise<IDutyTemplate | null>;
+    /**
+     * Get duty template by UUID
+     */
+    getByUuid(uuid: string): Promise<IDutyTemplate | null>;
+    /**
+     * Get duty template by UUID with full details (segments + items)
+     */
+    getByUuidWithDetails(uuid: string): Promise<IDutyTemplateWithDetails | null>;
+    /**
+     * Get segments for a template, each with their items (single batch query for items)
+     */
+    getSegmentsByTemplateId(templateId: number): Promise<IDutyTemplateSegment[]>;
+    /**
+     * Get items for a segment, with route join for route-type items
+     */
+    getItemsBySegmentId(segmentId: number): Promise<IDutyTemplateItem[]>;
+    /**
+     * Create a duty template with optional segments and items (transactional)
+     */
+    create(data: IDutyTemplateCreate): Promise<IDutyTemplate>;
+    /**
+     * Update a duty template by ID (metadata only, not segments)
+     */
+    update(id: number, data: IDutyTemplateUpdate): Promise<IDutyTemplate | null>;
+    /**
+     * Replace all segments and items for a template (transactional)
+     */
+    replaceSegments(templateId: number, segments: IDutyTemplateSegmentCreate[]): Promise<IDutyTemplateSegment[]>;
+    /**
+     * Delete a duty template by ID (soft delete)
+     */
+    delete(id: number): Promise<boolean>;
+}