shutro-erp 0.3.5 → 0.3.7

package/dist/helpdesk/demo.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Helpdesk's demo data (RFC 0008 §5.8): a Support team (Dina and Rahim, assigned in turn, Sunday to Thursday 09:00
+ * to 18:00), a standard SLA and a faster one for urgent tickets, a canned reply, and three tickets from customers —
+ * one answered and waiting on the customer, one urgent, one solved — with the clock refreshed.
+ */
+import type { DemoContext } from '../modules-sdk/index.js';
+export declare function helpdeskDemo(ctx: DemoContext): Promise<string>;

package/dist/helpdesk/demo.js

@@ -0,0 +1,65 @@
+import { refreshSla } from './sla.js';
+const DINA = { login: 'dina', name: 'Dina Rahman', groups: ['helpdesk.manager'] };
+const RAHIM = { login: 'rahim', name: 'Rahim Uddin', groups: ['helpdesk.user'] };
+export async function helpdeskDemo(ctx) {
+    const rahim = await ctx.as(RAHIM, async (raw) => raw.userId);
+    await ctx.as(DINA, async (raw) => {
+        const env = raw;
+        const team = (await env.model('helpdesk.team').create([
+            {
+                name: 'Support',
+                members: { set: [env.userId, rahim] },
+                assignment: 'round_robin',
+            },
+        ])).ids[0];
+        await env.model('helpdesk.sla').create([
+            { name: 'Standard', sequence: 20, team, firstReplyHours: '4', resolveHours: '24' },
+            {
+                name: 'Urgent',
+                sequence: 10,
+                team,
+                priority: 'urgent',
+                firstReplyHours: '1',
+                resolveHours: '8',
+            },
+        ]);
+        await env.model('helpdesk.canned').create([
+            {
+                name: 'Thanks, looking into it',
+                body: 'Dear {{customer}},\n\nThank you for writing about {{ticket}}. We are looking into it and will be back to you soon.\n\n{{agent}}',
+            },
+        ]);
+        const partner = async (name, email) => (await env.model('res.partner').search({ where: { name }, limit: 1 })).ids[0] ??
+            (await env.model('res.partner').create([{ name, email }])).ids[0];
+        const made = await env.model('helpdesk.ticket').create([
+            {
+                subject: 'Invoice INV/2026/0007 shows the wrong VAT',
+                description: 'The VAT on line 2 should be 15%, not 7.5%.',
+                team,
+                partner: await partner('Meghna Mills', 'accounts@meghna.example'),
+                priority: 'normal',
+            },
+            {
+                subject: 'Delivery to the Gazipur warehouse did not arrive',
+                description: 'The order was due yesterday; the line is stopped.',
+                team,
+                partner: await partner('Bengal Steel', 'stores@bengalsteel.example'),
+                priority: 'urgent',
+            },
+            {
+                subject: 'How do I download my statement?',
+                team,
+                partner: await partner('Padma Foods', 'office@padmafoods.example'),
+                priority: 'low',
+            },
+        ]);
+        await env.flush();
+        const [first, , third] = made.ids;
+        if (first !== undefined)
+            await env.model('helpdesk.ticket').browse([first]).wait();
+        if (third !== undefined)
+            await env.model('helpdesk.ticket').browse([third]).solve();
+        await env.asSuperuser({ reason: 'demo helpdesk clock' }, (su) => refreshSla(su));
+    });
+    return 'Helpdesk: the Support team, two SLA policies, a canned reply, three tickets (waiting, urgent, solved).';
+}

package/dist/helpdesk/hours.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Business hours (RFC 0024 §2.4): a team works from `open` to `close` (`HH:MM`) on the days outside its weekend, in
+ * a time zone; SLA targets count only those minutes. Pure functions, without a database.
+ */
+export interface Hours {
+    readonly open: string;
+    readonly close: string;
+    /** JavaScript day numbers off (0: Sunday). */
+    readonly weekend: readonly number[];
+    readonly tz: string;
+}
+/** The weekend of each choice, as JavaScript day numbers. */
+export declare const WEEKENDS: Readonly<Record<string, readonly number[]>>;
+/** The moment `minutes` working minutes after `from`. */
+export declare function addBusinessMinutes(from: Date, minutes: number, hours: Hours): Date;
+/** The working minutes between two moments (0 when `to` is not after `from`). */
+export declare function businessMinutesBetween(from: Date, to: Date, hours: Hours): number;

package/dist/helpdesk/hours.js

@@ -0,0 +1,94 @@
+/**
+ * Business hours (RFC 0024 §2.4): a team works from `open` to `close` (`HH:MM`) on the days outside its weekend, in
+ * a time zone; SLA targets count only those minutes. Pure functions, without a database.
+ */
+/** The weekend of each choice, as JavaScript day numbers. */
+export const WEEKENDS = {
+    fri_sat: [5, 6],
+    sat_sun: [6, 0],
+    fri: [5],
+    none: [],
+};
+const DAY = 86_400_000;
+const minutesOf = (hhmm) => {
+    const [h, m] = hhmm.split(':').map(Number);
+    return h * 60 + m;
+};
+function parts(at, tz) {
+    const out = {};
+    for (const p of new Intl.DateTimeFormat('en-US', {
+        timeZone: tz,
+        hourCycle: 'h23',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+    }).formatToParts(at))
+        if (p.type !== 'literal')
+            out[p.type] = Number(p.value);
+    return {
+        y: out['year'] ?? 0,
+        m: out['month'] ?? 1,
+        d: out['day'] ?? 1,
+        h: out['hour'] ?? 0,
+        min: out['minute'] ?? 0,
+    };
+}
+/** The instant of `minutes` after midnight of the local date `y-m-d` in `tz`. */
+function instant(y, m, d, minutes, tz) {
+    const guess = Date.UTC(y, m - 1, d, 0, minutes);
+    const offset = (t) => {
+        const p = parts(new Date(t), tz);
+        return Date.UTC(p.y, p.m - 1, p.d, p.h, p.min) - t;
+    };
+    const first = guess - offset(guess);
+    return guess - offset(first);
+}
+/** The working window of each local day from the one of `from`, as instants, for at most `days` days. */
+function* windows(from, hours, days = 3660) {
+    const p = parts(from, hours.tz);
+    let day = Date.UTC(p.y, p.m - 1, p.d);
+    const open = minutesOf(hours.open);
+    const close = minutesOf(hours.close);
+    if (close <= open)
+        return;
+    for (let i = 0; i < days; i += 1, day += DAY) {
+        const date = new Date(day);
+        if (hours.weekend.includes(date.getUTCDay()))
+            continue;
+        const y = date.getUTCFullYear();
+        const m = date.getUTCMonth() + 1;
+        const d = date.getUTCDate();
+        yield [instant(y, m, d, open, hours.tz), instant(y, m, d, close, hours.tz)];
+    }
+}
+/** The moment `minutes` working minutes after `from`. */
+export function addBusinessMinutes(from, minutes, hours) {
+    let left = Math.max(0, minutes) * 60_000;
+    const start = from.getTime();
+    for (const [a, b] of windows(from, hours)) {
+        const s = Math.max(a, start);
+        if (s >= b)
+            continue;
+        if (s + left <= b)
+            return new Date(s + left);
+        left -= b - s;
+    }
+    return new Date(start + minutes * 60_000);
+}
+/** The working minutes between two moments (0 when `to` is not after `from`). */
+export function businessMinutesBetween(from, to, hours) {
+    if (to <= from)
+        return 0;
+    let total = 0;
+    for (const [a, b] of windows(from, hours)) {
+        if (a >= to.getTime())
+            break;
+        const s = Math.max(a, from.getTime());
+        const e = Math.min(b, to.getTime());
+        if (e > s)
+            total += e - s;
+    }
+    return Math.round(total / 60_000);
+}

package/dist/helpdesk/i18n/bn.d.ts

@@ -0,0 +1,2 @@
+/** Bangla for the module's labels, keyed by their English text (RFC 0023 §3.1; `pnpm i18n:extract`). */
+export declare const bn: Readonly<Record<string, string>>;

package/dist/helpdesk/i18n/bn.js

@@ -0,0 +1,127 @@
+/** Bangla for the module's labels, keyed by their English text (RFC 0023 §3.1; `pnpm i18n:extract`). */
+export const bn = {
+    'A rating is from one to five.': 'রেটিং এক থেকে পাঁচের মধ্যে হয়।',
+    Active: 'সক্রিয়',
+    Agent: 'এজেন্ট',
+    'Agent (the tickets of their teams)': 'এজেন্ট (নিজ দলের টিকিট)',
+    Agents: 'এজেন্টরা',
+    'An IANA name such as Asia/Dhaka or Asia/Kolkata.': 'IANA নাম, যেমন Asia/Dhaka বা Asia/Kolkata।',
+    'Ask for a rating': 'রেটিং চান',
+    Assignment: 'বণ্টন',
+    'At risk': 'ঝুঁকিতে',
+    'At risk: less than a fifth of the time left; breached: a target passed; met: solved in time.': 'ঝুঁকিতে: সময়ের এক-পঞ্চমাংশেরও কম বাকি; লঙ্ঘিত: একটি লক্ষ্য পেরিয়ে গেছে; পূরণ: সময়মতো সমাধান হয়েছে।',
+    'Average rating': 'গড় রেটিং',
+    Body: 'মূল লেখা',
+    Breached: 'লঙ্ঘিত',
+    'Business hours': 'কার্যসময়',
+    'By hand': 'হাতে',
+    'Canned replies': 'তৈরি উত্তর',
+    'Canned reply': 'তৈরি উত্তর',
+    Close: 'বন্ধ করুন',
+    Closed: 'বন্ধ',
+    Closes: 'বন্ধ হয়',
+    'Closes (HH:MM)': 'বন্ধ হয় (HH:MM)',
+    Company: 'প্রতিষ্ঠান',
+    Configuration: 'কনফিগারেশন',
+    'Created At': 'তৈরির সময়',
+    'Created By': 'তৈরি করেছেন',
+    Customer: 'গ্রাহক',
+    'Customer email': 'গ্রাহকের ইমেইল',
+    'Decides the SLA policy: a policy from a priority covers that one and the ones above.': 'এসএলএ নীতি নির্ধারণ করে: কোনো অগ্রাধিকার থেকে শুরু নীতি সেটি ও তার উপরেরগুলোতে প্রযোজ্য।',
+    Description: 'বিবরণ',
+    'Display Name': 'প্রদর্শিত নাম',
+    'Empty: every customer.': 'খালি: সব গ্রাহক।',
+    'Empty: every team.': 'খালি: সব দল।',
+    'First replied': 'প্রথম উত্তর দেওয়া হয়েছে',
+    'First reply by': 'প্রথম উত্তরের শেষ সময়',
+    'First reply within (hours)': 'প্রথম উত্তর (ঘণ্টার মধ্যে)',
+    'Folded on the board': 'বোর্ডে গুটানো',
+    'Friday and Saturday': 'শুক্রবার ও শনিবার',
+    'Friday only': 'শুধু শুক্রবার',
+    'From priority': 'যে অগ্রাধিকার থেকে',
+    Helpdesk: 'হেল্পডেস্ক',
+    'Helpdesk agent': 'হেল্পডেস্ক এজেন্ট',
+    'Helpdesk manager': 'হেল্পডেস্ক ব্যবস্থাপক',
+    'Helpdesk manager (teams, SLAs, every ticket)': 'হেল্পডেস্ক ব্যবস্থাপক (দল, এসএলএ, সব টিকিট)',
+    'Helpdesk team': 'হেল্পডেস্ক দল',
+    High: 'উচ্চ',
+    'Hours are written HH:MM, the closing after the opening.': 'সময় HH:MM আকারে লিখুন, বন্ধের সময় খোলার পরে।',
+    'How new tickets get their agent: in turn among the agents, or to the one with the fewest open tickets.': 'নতুন টিকিট কীভাবে এজেন্ট পায়: এজেন্টদের মধ্যে পালাক্রমে, অথবা যার খোলা টিকিট সবচেয়ে কম তাকে।',
+    ID: 'আইডি',
+    'In the team’s business hours; waiting on the customer pauses the resolution target.': 'দলের কার্যসময়ের মধ্যে; গ্রাহকের অপেক্ষায় থাকলে সমাধানের লক্ষ্য থেমে থাকে।',
+    'In turn': 'পালাক্রমে',
+    Low: 'নিম্ন',
+    Merged: 'একীভূত',
+    'Merged into': 'যার সাথে একীভূত',
+    Met: 'পূরণ',
+    Mine: 'আমার',
+    Name: 'নাম',
+    'No SLA': 'এসএলএ নেই',
+    'None (every day)': 'নেই (প্রতিদিন)',
+    Normal: 'সাধারণ',
+    'On track': 'ঠিক পথে',
+    Open: 'খোলা',
+    'Open by agent': 'এজেন্ট অনুযায়ী খোলা',
+    'Open tickets': 'খোলা টিকিট',
+    Opens: 'খোলে',
+    'Opens (HH:MM)': 'খোলে (HH:MM)',
+    Outcome: 'ফলাফল',
+    Overview: 'সারসংক্ষেপ',
+    'Paused (working minutes)': 'বিরতি (কার্য মিনিট)',
+    'Placeholders: {{customer}}, {{ticket}}, {{agent}} — filled in when used.': 'প্লেসহোল্ডার: {{customer}}, {{ticket}}, {{agent}} — ব্যবহারের সময় পূরণ হয়।',
+    Priority: 'অগ্রাধিকার',
+    'Rating (1–5)': 'রেটিং (১–৫)',
+    'Rating link': 'রেটিং লিংক',
+    Reference: 'রেফারেন্স',
+    Reopen: 'আবার খুলুন',
+    Resume: 'আবার শুরু করুন',
+    'Saturday and Sunday': 'শনিবার ও রবিবার',
+    Sequence: 'ক্রম',
+    Services: 'সেবা',
+    SLA: 'এসএলএ',
+    'SLA at risk': 'এসএলএ ঝুঁকিতে',
+    'SLA breached': 'এসএলএ লঙ্ঘিত',
+    'SLA policies': 'এসএলএ নীতিমালা',
+    'SLA policy': 'এসএলএ নীতি',
+    'SLA targets count working hours only: from opening to closing, outside the weekend.': 'এসএলএ লক্ষ্যে শুধু কার্যঘণ্টা গোনা হয়: খোলা থেকে বন্ধ পর্যন্ত, সাপ্তাহিক ছুটি বাদে।',
+    Solved: 'সমাধানকৃত',
+    'Solved by': 'সমাধানের শেষ সময়',
+    'Solved this month': 'এই মাসে সমাধানকৃত',
+    'Solved within (hours)': 'সমাধান (ঘণ্টার মধ্যে)',
+    Stage: 'ধাপ',
+    Stages: 'ধাপসমূহ',
+    State: 'অবস্থা',
+    Status: 'অবস্থা',
+    Subject: 'বিষয়',
+    'Targets (business hours)': 'লক্ষ্য (কার্যঘণ্টা)',
+    'Targets are positive, the resolution no sooner than the first reply.': 'লক্ষ্য ধনাত্মক হতে হবে, সমাধানের সময় প্রথম উত্তরের আগে নয়।',
+    Team: 'দল',
+    Teams: 'দলসমূহ',
+    'The customer’s comment': 'গ্রাহকের মন্তব্য',
+    'The first policy that matches a ticket applies.': 'টিকিটের সাথে মেলে এমন প্রথম নীতি প্রযোজ্য হয়।',
+    'The first policy, by sequence, that matches a ticket applies to it.': 'ক্রম অনুযায়ী টিকিটের সাথে মেলে এমন প্রথম নীতি তাতে প্রযোজ্য হয়।',
+    'The teams’ business hours are read in this time zone.': 'দলগুলোর কার্যসময় এই সময় অঞ্চলে ধরা হয়।',
+    Ticket: 'টিকিট',
+    'Ticket solved': 'টিকিট সমাধান হয়েছে',
+    'Ticket stage': 'টিকিটের ধাপ',
+    'Ticket type': 'টিকিটের ধরন',
+    'Ticket types': 'টিকিটের ধরনসমূহ',
+    Tickets: 'টিকিট',
+    'Tickets by SLA': 'এসএলএ অনুযায়ী টিকিট',
+    'Tickets from email, SLAs in business hours, assignment, ratings': 'ইমেইল থেকে টিকিট, কার্যসময়ে এসএলএ, বণ্টন, রেটিং',
+    'Tickets of this priority or higher; empty: every priority.': 'এই অগ্রাধিকার বা তার বেশি টিকিট; খালি: সব অগ্রাধিকার।',
+    'Time waiting on the customer: added to the resolution target.': 'গ্রাহকের অপেক্ষার সময়: সমাধানের লক্ষ্যে যোগ হয়।',
+    'Time zone': 'সময় অঞ্চল',
+    'To the least busy': 'সবচেয়ে কম ব্যস্তকে',
+    Type: 'ধরন',
+    Unassigned: 'অনির্ধারিত',
+    'Updated At': 'হালনাগাদের সময়',
+    'Updated By': 'হালনাগাদ করেছেন',
+    Urgent: 'জরুরি',
+    'Waiting on the customer': 'গ্রাহকের অপেক্ষায়',
+    'Waiting on the customer pauses the resolution clock; a customer’s reply resumes it.': 'গ্রাহকের অপেক্ষায় থাকলে সমাধানের ঘড়ি থেমে থাকে; গ্রাহকের উত্তরে আবার চালু হয়।',
+    'Waiting since': 'অপেক্ষা শুরু',
+    Weekend: 'সাপ্তাহিক ছুটি',
+    'When a ticket is solved, its customer is asked to rate the help (one to five).': 'টিকিট সমাধান হলে গ্রাহককে সহায়তার রেটিং দিতে বলা হয় (এক থেকে পাঁচ)।',
+    'Where replies go when the customer is not a contact yet.': 'গ্রাহক এখনও যোগাযোগ না হলে উত্তর যেখানে যায়।',
+};

package/dist/helpdesk/index.d.ts

@@ -0,0 +1,10 @@
+import { defineModule } from '../modules-sdk/index.js';
+export { addBusinessMinutes, businessMinutesBetween, type Hours, WEEKENDS } from './hours.js';
+export { HelpdeskCanned, HelpdeskSla, HelpdeskStage, HelpdeskTeam, HelpdeskTicket, HelpdeskType, helpdeskShutro, PRIORITIES, } from './module.js';
+export { askRating, hoursOf, pausedSince, rate, refreshSla, timeZoneOf } from './sla.js';
+/** A ticket's values from an email to `helpdesk@`: the first team, the sender as the customer (added when new). */
+export declare function ticketFromEmail(raw: unknown, sender: {
+    readonly address: string;
+    readonly name: string | null;
+}): Promise<Record<string, unknown> | null>;
+export declare const helpdesk: ReturnType<typeof defineModule>;