@teamso/teamso-mcp 0.0.0-stage → 1.2.0

package/dist/utils/structured.d.ts

@@ -0,0 +1,89 @@
+import type { z } from 'zod';
+import type { HelpArticle, TeamsoAnnouncement, TeamsoAuthorizedEmployee, TeamsoGoal, TeamsoLeave, TeamsoLeavePolicyAssignment, TeamsoLeaveTypeBalance, TeamsoPayslip, TeamsoPerformancePeriod, TeamsoUser, TeamsoUserListItem, TeamsoUserSummary, TeamsoUserSummaryRef } from '../types.js';
+import type { employeeSummarySchema, goalSchema, helpArticleSummarySchema, leaveSummarySchema, leaveTypeSchema, meOutputSchema, payslipSchema, pendingApprovalSchema, performancePeriodSchema } from '../tools/schemas.js';
+/**
+ * Projections from Teamso API DTOs to the tool output schemas. Every function
+ * returns only schema fields, omitting empty values, so `structuredContent`
+ * validates against the published JSON Schema (which forbids unknown keys).
+ */
+export type HelpArticleSummary = z.infer<typeof helpArticleSummarySchema>;
+export type MeProjection = z.infer<typeof meOutputSchema.user>;
+export type LeaveTypeProjection = z.infer<typeof leaveTypeSchema>;
+export type LeaveSummary = z.infer<typeof leaveSummarySchema>;
+export type PendingApproval = z.infer<typeof pendingApprovalSchema>;
+export type EmployeeSummary = z.infer<typeof employeeSummarySchema>;
+export type PerformancePeriodProjection = z.infer<typeof performancePeriodSchema>;
+export type GoalProjection = z.infer<typeof goalSchema>;
+export type PayslipProjection = z.infer<typeof payslipSchema>;
+export declare const HELP_RESOURCE_PREFIX = "teamso://how-to/";
+export declare const TARGETED_PERFORMANCE_KEY = "targetedPerformance";
+/** Teamso leave `state` codes (`LeaveConstants`). */
+export declare const LEAVE_STATUSES: {
+    readonly pending_approval: 0;
+    readonly approved: 2;
+    readonly rejected: 3;
+    readonly awaiting_usage_approval: 4;
+    readonly completed: 5;
+    readonly awaiting_document: 6;
+};
+export type LeaveStatus = keyof typeof LEAVE_STATUSES;
+export declare function leaveStatusName(code: number | undefined): string;
+export declare function toHelpArticleSummary(article: HelpArticle, lang: string, siteOrigin: string): HelpArticleSummary;
+export declare function absoluteHelpUrl(article: HelpArticle, siteOrigin: string): string;
+export declare function fullNameOf(person: {
+    fullname?: string | null;
+    fullName?: string | null;
+    name?: string | null;
+    secondName?: string | null;
+    surname?: string | null;
+} | null | undefined): string;
+export declare function personRef(person: TeamsoUserSummaryRef | null | undefined): {
+    id: string;
+    fullName: string;
+} | null;
+export declare function toMe(user: TeamsoUser): MeProjection;
+export declare function toLeavePolicy(assignment: TeamsoLeavePolicyAssignment): {
+    leavePolicyUserId: string;
+    id?: string;
+    name?: string;
+};
+export declare function toLeaveType(balance: TeamsoLeaveTypeBalance): LeaveTypeProjection;
+export declare function toLeaveSummary(leave: TeamsoLeave): LeaveSummary;
+export declare function toPendingApproval(leave: TeamsoLeave): PendingApproval;
+/** `closedPayrollPeriods` from a leave mutation result, as display strings. */
+export declare function closedPayrollPeriodsOf(result: unknown): string[];
+export declare function toEmployeeFromList(user: TeamsoUserListItem): EmployeeSummary;
+export declare function toEmployeeFromAuthorized(employee: TeamsoAuthorizedEmployee): EmployeeSummary;
+export declare function toEmployeeProfile(summary: TeamsoUserSummary): {
+    id: string;
+    fullName: string;
+    email?: string;
+    phone?: string;
+    branch?: string;
+    department?: string;
+    position?: string;
+    manager: {
+        id?: string;
+        fullName: string;
+    } | null;
+    workLocation?: string;
+    workplace?: string;
+};
+export declare function toPerformancePeriod(period: TeamsoPerformancePeriod): PerformancePeriodProjection;
+export declare function targetValueOf(goal: TeamsoGoal): number | undefined;
+export declare function toGoal(goal: TeamsoGoal): GoalProjection;
+export declare function toAnnouncement(announcement: TeamsoAnnouncement): {
+    id: string;
+    type?: string;
+    text: string;
+    date?: string;
+    sharedBy?: string;
+    coverPhotoUrl?: string;
+};
+export declare function toPayslip(payslip: TeamsoPayslip): PayslipProjection;
+export declare function roundDays(value: number): number;
+export declare function optionalString(value: string | null | undefined): string | undefined;
+export declare function optionalNumber(value: number | string | null | undefined): number | undefined;
+/** Drops `undefined` fields so optional schema keys are omitted, not `undefined`. */
+export declare function compact<T extends Record<string, unknown>>(value: T): T;
+//# sourceMappingURL=structured.d.ts.map

package/dist/utils/structured.d.ts.map

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

package/dist/utils/structured.js

@@ -0,0 +1,307 @@
+import { toDisplayDateTime, toIsoDay } from './dates.js';
+import { htmlToText } from './text.js';
+export const HELP_RESOURCE_PREFIX = 'teamso://how-to/';
+export const TARGETED_PERFORMANCE_KEY = 'targetedPerformance';
+/** Teamso leave `state` codes (`LeaveConstants`). */
+export const LEAVE_STATUSES = {
+    pending_approval: 0,
+    approved: 2,
+    rejected: 3,
+    awaiting_usage_approval: 4,
+    completed: 5,
+    awaiting_document: 6,
+};
+export function leaveStatusName(code) {
+    const entry = Object.entries(LEAVE_STATUSES).find(([, value]) => value === code);
+    return entry ? entry[0] : code === undefined ? 'unknown' : `unknown_${code}`;
+}
+// ------------------------------------------------------------------- help
+export function toHelpArticleSummary(article, lang, siteOrigin) {
+    return {
+        id: article.id,
+        title: article.title,
+        summary: article.summary ?? '',
+        module: article.dir,
+        roles: article.roles ?? [],
+        url: absoluteHelpUrl(article, siteOrigin),
+        resource: `${HELP_RESOURCE_PREFIX}${article.lang ?? lang}/${article.id}`,
+    };
+}
+export function absoluteHelpUrl(article, siteOrigin) {
+    const url = article.url ?? '';
+    if (/^https?:\/\//.test(url))
+        return url;
+    return `${siteOrigin}${url.startsWith('/') ? '' : '/'}${url}`;
+}
+// ---------------------------------------------------------------- account
+export function fullNameOf(person) {
+    if (!person)
+        return '';
+    const full = person.fullname || person.fullName;
+    if (full && full.trim())
+        return full.trim();
+    return [person.name, person.secondName, person.surname]
+        .filter(part => part && part.trim())
+        .join(' ')
+        .trim();
+}
+export function personRef(person) {
+    if (!person?.id)
+        return null;
+    return { id: person.id, fullName: fullNameOf(person) || person.id };
+}
+export function toMe(user) {
+    const position = user.userTask?.userPosition;
+    const permissions = [...new Set((user.permissions ?? [])
+            .map(permission => permission.code)
+            .filter((code) => Boolean(code)))].sort();
+    return compact({
+        id: user.id,
+        fullName: fullNameOf(user) || user.id,
+        name: optionalString(user.name),
+        surname: optionalString(user.surname),
+        email: optionalString(user.email),
+        personnelId: optionalString(user.personnelId),
+        company: compact({
+            id: optionalString(user.companyId),
+            name: optionalString(user.companyName),
+        }),
+        department: optionalString(position?.department?.name),
+        position: optionalString(position?.name),
+        branch: optionalString(user.branchName?.name),
+        manager: personRef(user.userManager),
+        roles: (user.roles ?? []).map(role => role.name).filter((name) => Boolean(name)),
+        permissions,
+        payrollManager: user.payrollManager === true,
+    });
+}
+// ------------------------------------------------------------------ leave
+export function toLeavePolicy(assignment) {
+    return compact({
+        leavePolicyUserId: assignment.leavePolicyUserId,
+        id: optionalString(assignment.leavePolicy?.id),
+        name: optionalString(assignment.leavePolicy?.name),
+    });
+}
+export function toLeaveType(balance) {
+    const type = balance.leaveTypeRequestModel;
+    return compact({
+        id: type.id,
+        name: type.name || type.id,
+        remainingDays: roundDays(balance.right ?? 0),
+        isDefault: type.primary === true,
+        paid: type.paid === true,
+        limitation: optionalString(type.limitation),
+        dayLimit: typeof type.dayLimit === 'number' && type.dayLimit > 0 ? type.dayLimit : undefined,
+        minDaysPerRequest: optionalNumber(type.leastDayCount),
+        maxDaysPerRequest: optionalNumber(type.mostDayCount),
+        documentRequired: type.documentRequired === true,
+        descriptionRequired: type.descriptionRequired === true,
+        birthdayLeave: type.birthdayLeave === true,
+        countsCalendarDays: type.overriddenHolidays === true,
+    });
+}
+export function toLeaveSummary(leave) {
+    return compact({
+        id: leave.id,
+        leaveTypeId: optionalString(leave.leaveTypeRequestModel?.id ?? leave.leaveTypeId),
+        leaveTypeName: optionalString(leave.leaveTypeRequestModel?.name),
+        start: optionalString(leave.startDate),
+        end: optionalString(leave.endDate),
+        workingDays: typeof leave.totalLeaveDay === 'number' ? roundDays(leave.totalLeaveDay) : undefined,
+        status: leaveStatusName(leave.state),
+        statusCode: leave.state,
+        description: optionalString(leave.description),
+        answer: optionalString(leave.answer),
+        createdAt: toDisplayDateTime(leave.createdAt ?? undefined),
+    });
+}
+export function toPendingApproval(leave) {
+    return compact({
+        leaveId: leave.id,
+        requester: leave.user?.id
+            ? personRef(leave.user)
+            : leave.userId ? { id: leave.userId, fullName: leave.userId } : null,
+        leaveTypeName: optionalString(leave.leaveTypeRequestModel?.name),
+        start: optionalString(leave.startDate),
+        end: optionalString(leave.endDate),
+        workingDays: typeof leave.totalLeaveDay === 'number' ? roundDays(leave.totalLeaveDay) : undefined,
+        description: optionalString(leave.description),
+        approvalStep: leave.approvalQueue,
+        createdAt: toDisplayDateTime(leave.createdAt ?? undefined),
+    });
+}
+/** `closedPayrollPeriods` from a leave mutation result, as display strings. */
+export function closedPayrollPeriodsOf(result) {
+    if (!isRecord(result) || !Array.isArray(result.closedPayrollPeriods))
+        return [];
+    return result.closedPayrollPeriods
+        .map(period => {
+        if (typeof period === 'string')
+            return period;
+        if (isRecord(period)) {
+            const label = period.term ?? period.period ?? period.name ?? period.id;
+            return typeof label === 'string' ? label : JSON.stringify(period);
+        }
+        return String(period);
+    })
+        .filter(Boolean);
+}
+// -------------------------------------------------------------- employees
+export function toEmployeeFromList(user) {
+    const position = user.userTask?.userPosition;
+    return compact({
+        id: user.id,
+        fullName: fullNameOf(user) || user.id,
+        email: optionalString(user.email),
+        personnelId: optionalString(user.personnelId),
+        department: optionalString(position?.department?.name),
+        position: optionalString(position?.name),
+        branch: optionalString(user.branch?.name),
+    });
+}
+export function toEmployeeFromAuthorized(employee) {
+    return compact({
+        id: employee.id,
+        fullName: fullNameOf(employee) || employee.id,
+        email: optionalString(employee.email),
+        personnelId: optionalString(employee.personnelId),
+    });
+}
+export function toEmployeeProfile(summary) {
+    return compact({
+        id: summary.id,
+        fullName: optionalString(summary.fullname) ?? summary.id,
+        email: optionalString(summary.email),
+        phone: optionalString(summary.tel),
+        branch: optionalString(summary.branchName),
+        department: optionalString(summary.departmentName),
+        position: optionalString(summary.positionName),
+        manager: summary.manager || summary.managerId
+            ? compact({
+                id: optionalString(summary.managerId),
+                fullName: optionalString(summary.manager) ?? summary.managerId ?? '',
+            })
+            : null,
+        workLocation: optionalString(summary.workLocation),
+        workplace: optionalString(summary.workPlaceName),
+    });
+}
+// ------------------------------------------------------------ performance
+export function toPerformancePeriod(period) {
+    const scale = [...(period.evaluationScale ?? [])]
+        .sort((a, b) => (a.displayOrder ?? 0) - (b.displayOrder ?? 0))
+        .map(item => compact({
+        label: item.label ?? '',
+        value: optionalNumber(item.value),
+        minPercentage: optionalNumber(item.minPercentage),
+        maxPercentage: optionalNumber(item.maxPercentage),
+    }));
+    return compact({
+        id: period.id,
+        title: period.title,
+        status: optionalString(period.status),
+        startDate: toIsoDay(period.startDate),
+        endDate: toIsoDay(period.endDate),
+        targetEntryStartDate: toIsoDay(period.targetEntryStartDate),
+        targetEntryEndDate: toIsoDay(period.targetEntryEndDate),
+        targetEntryOpen: period.isTargetEntryOpen === true,
+        targetEntryLocked: period.isTargetEntryLocked === true,
+        goalEntryBy: optionalString(period.goalEntryBy),
+        successCriteriaEntryBy: optionalString(period.successCriteriaEntryBy),
+        minimumGoalCount: optionalNumber(period.minimumGoalCount),
+        employeeCanSelectOther: period.employeeCanSelectOther === true,
+        evaluationScale: scale,
+    });
+}
+export function targetValueOf(goal) {
+    if (typeof goal.targetValue === 'number')
+        return goal.targetValue;
+    const scores = goal.targetValueDefinition?.scores ?? [];
+    const target = scores.find(score => score.key === TARGETED_PERFORMANCE_KEY) ?? scores[0];
+    return optionalNumber(target?.value);
+}
+export function toGoal(goal) {
+    const definition = goal.targetValueDefinition;
+    return compact({
+        id: goal.id,
+        userId: optionalString(goal.userId),
+        userFullName: optionalString(goal.userFullName),
+        name: goal.name ?? '',
+        description: optionalString(goal.description),
+        type: optionalString(goal.type),
+        period: optionalString(goal.periodName),
+        status: goal.status ?? 'UNKNOWN',
+        weight: optionalNumber(goal.weight),
+        scaleCriterion: optionalString(definition?.scaleCriterion),
+        currency: optionalString(definition?.currency),
+        otherText: optionalString(definition?.otherText),
+        targetValue: targetValueOf(goal),
+        actualValue: optionalNumber(goal.actualValue),
+        actualText: optionalString(goal.actualText),
+        managerActualValue: optionalNumber(goal.managerActualValue),
+        managerActualText: optionalString(goal.managerActualText),
+        achievementPercentage: optionalNumber(goal.achievementPercentage),
+        // The evaluation result lives in scoreValue/weightedScore; `score` is a legacy column the API leaves null.
+        score: optionalNumber(goal.scoreValue ?? goal.score),
+        weightedScore: optionalNumber(goal.weightedScore),
+        // The owner's period final score once the evaluation chain has finished (same on every goal of the owner).
+        finalScore: optionalNumber(goal.userFinalScore),
+        finalScoreText: optionalString(goal.userFinalScoreText),
+        canApproveGoal: goal.canApproveGoal === true,
+        canReviseGoal: goal.canReviseGoal === true,
+        canEnterActualValue: goal.canEnterActualValue === true,
+        canApproveEvaluation: goal.canApprove === true,
+    });
+}
+// ---------------------------------------------------------- communication
+export function toAnnouncement(announcement) {
+    return compact({
+        id: announcement.id,
+        type: optionalString(announcement.announcementType),
+        text: htmlToText(announcement.announcement),
+        date: optionalString(announcement.date),
+        sharedBy: optionalString(fullNameOf(announcement.sharedUser)),
+        coverPhotoUrl: optionalString(announcement.coverPhotoUrl),
+    });
+}
+// ---------------------------------------------------------------- payroll
+export function toPayslip(payslip) {
+    return compact({
+        id: payslip.id,
+        term: optionalString(payslip.term),
+        status: optionalString(payslip.status),
+        sentToEmployeeAt: optionalString(payslip.sentToEmployeeAt),
+        createdAt: optionalString(payslip.createdAt),
+        canAnswer: payslip.canAnswer === true,
+        userAnswer: optionalString(payslip.userAnswer),
+        managerAnswer: optionalString(payslip.managerAnswer),
+    });
+}
+// ---------------------------------------------------------------- helpers
+export function roundDays(value) {
+    return Math.round(value * 100) / 100;
+}
+export function optionalString(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+export function optionalNumber(value) {
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : undefined;
+    if (typeof value === 'string' && value.trim()) {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    }
+    return undefined;
+}
+/** Drops `undefined` fields so optional schema keys are omitted, not `undefined`. */
+export function compact(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=structured.js.map

package/dist/utils/structured.js.map

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

package/dist/utils/text.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Case- and diacritic-insensitive folding for Turkish text, matching the API's
+ * `SearchTextUtil.normalize`: I/İ/ı collapse onto "i" and every other accent
+ * (ş, ç, ğ, ö, ü) is stripped, so "ozturk" finds "Öztürk".
+ */
+export declare function normalizeSearchText(value: string | null | undefined): string;
+/** True when every whitespace-separated word of the query appears in one of the values. */
+export declare function matchesAllWords(query: string, ...values: Array<string | null | undefined>): boolean;
+/** Plain text from the HTML the announcement editor stores. */
+export declare function htmlToText(html: string | null | undefined): string;
+export declare function truncate(value: string, maxLength: number): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/utils/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAO5E;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,OAAO,CAKnG;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAelE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGjE"}

package/dist/utils/text.js

@@ -0,0 +1,46 @@
+/**
+ * Case- and diacritic-insensitive folding for Turkish text, matching the API's
+ * `SearchTextUtil.normalize`: I/İ/ı collapse onto "i" and every other accent
+ * (ş, ç, ğ, ö, ü) is stripped, so "ozturk" finds "Öztürk".
+ */
+export function normalizeSearchText(value) {
+    if (!value)
+        return '';
+    return value
+        .replace(/[ıI]/g, 'i')
+        .normalize('NFD')
+        .replace(/\p{M}+/gu, '')
+        .toLowerCase();
+}
+/** True when every whitespace-separated word of the query appears in one of the values. */
+export function matchesAllWords(query, ...values) {
+    const words = normalizeSearchText(query).split(/\s+/).filter(Boolean);
+    if (words.length === 0)
+        return true;
+    const haystack = values.map(normalizeSearchText).filter(Boolean).join(' ');
+    return words.every(word => haystack.includes(word));
+}
+/** Plain text from the HTML the announcement editor stores. */
+export function htmlToText(html) {
+    if (!html)
+        return '';
+    return html
+        .replace(/<\s*br\s*\/?>/gi, '\n')
+        .replace(/<\/\s*(p|div|li|h[1-6])\s*>/gi, '\n')
+        .replace(/<[^>]+>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/[ \t]+/g, ' ')
+        .replace(/\s*\n\s*/g, '\n')
+        .trim();
+}
+export function truncate(value, maxLength) {
+    if (value.length <= maxLength)
+        return value;
+    return `${value.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`;
+}
+//# sourceMappingURL=text.js.map

package/dist/utils/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAgC;IAClE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,KAAK;SACT,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,GAAG,MAAwC;IACxF,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,IAA+B;IACxD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC;SAChC,OAAO,CAAC,+BAA+B,EAAE,IAAI,CAAC;SAC9C,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC;SAC1B,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,SAAiB;IACvD,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;AACpE,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** Package version, also sent to the API as `X-Teamso-Client: teamso-mcp/<version>`. */
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAKA,wFAAwF;AACxF,eAAO,MAAM,OAAO,EAAE,MAAgB,CAAC"}

package/dist/version.js

@@ -0,0 +1,6 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+/** Package version, also sent to the API as `X-Teamso-Client: teamso-mcp/<version>`. */
+export const VERSION = version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,wFAAwF;AACxF,MAAM,CAAC,MAAM,OAAO,GAAW,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,88 @@
 {
   "name": "@teamso/teamso-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.2.0",
+  "description": "Official MCP server for Teamso HR — request leave, handle approvals, find colleagues, manage performance goals, read payslips, search the Teamso help center and reach every other Teamso module through permission-checked generic API tools from Cursor, Claude, Windsurf, and any MCP-compatible AI assistant",
+  "type": "module",
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "bin": {
+    "teamso-mcp": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./prompts": {
+      "types": "./dist/prompts/index.d.ts",
+      "default": "./dist/prompts/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "default": "./dist/tools/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "teamso",
+    "hr",
+    "hris",
+    "human-resources",
+    "leave-management",
+    "performance-management",
+    "payroll",
+    "mcp",
+    "model-context-protocol",
+    "cursor",
+    "claude",
+    "windsurf",
+    "llm"
+  ],
+  "author": "Teamso",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Teamsocom/Teamso-MCP.git"
+  },
+  "homepage": "https://teamso.com/docs/mcp-self-hosted",
+  "bugs": {
+    "url": "https://github.com/Teamsocom/Teamso-MCP/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "ajv": "^8.20.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}