@teamso/teamso-mcp 0.0.0-stage → 1.2.1

package/dist/utils/api-endpoints.d.ts

@@ -0,0 +1,130 @@
+import type { ApiHttpMethod, ApiQueryValue, TeamsoApiEndpointDescription, TeamsoApiEndpointItem, TeamsoApiModule } from '../types.js';
+/**
+ * Helpers for the generic API tools: defensive projections of the per-user
+ * catalog (`/mcp-catalog`), path and query resolution, request body
+ * validation (JSON Schema 2020-12), example arguments and result truncation.
+ */
+export declare const SIDE_EFFECTS: readonly ["read", "write", "delete", "read_with_writes"];
+export type SideEffect = typeof SIDE_EFFECTS[number];
+export declare const SMS_MODES: readonly ["always", "conditional", "never"];
+export type SmsMode = typeof SMS_MODES[number];
+export declare const HTTP_METHODS: readonly ["GET", "POST", "PUT", "PATCH", "DELETE"];
+export interface ApiEndpointSummary {
+    id: string;
+    method: ApiHttpMethod;
+    path: string;
+    module?: string;
+    moduleTitle?: string;
+    summary?: string;
+    sideEffect: SideEffect;
+    smsCodeRequired: SmsMode;
+    fileResponse: boolean;
+    multipart: boolean;
+    access?: string;
+    conditional?: boolean;
+}
+export interface ApiSmsRequirement {
+    mode: SmsMode;
+    when?: string;
+    preVerify: boolean;
+    credits?: string;
+}
+export interface ApiParameterInfo {
+    name: string;
+    in: string;
+    required: boolean;
+    schema: Record<string, unknown>;
+}
+export interface ApiRequestBodyInfo {
+    required: boolean;
+    validated?: boolean;
+    contentType: string;
+    /** Self-contained JSON Schema 2020-12 (the catalog's `$defs` merged in). */
+    schema: Record<string, unknown>;
+}
+export interface ApiEndpointDetails extends ApiEndpointSummary {
+    accessReason?: string;
+    permission?: string;
+    moduleDescription?: string;
+    responseKind?: string;
+    doc?: string;
+    webScreens: string[];
+    sms: ApiSmsRequirement | null;
+    parameters: ApiParameterInfo[];
+    requestBody: ApiRequestBodyInfo | null;
+    notes: string[];
+    related: string[];
+}
+export declare function toApiEndpointSummary(item: TeamsoApiEndpointItem): ApiEndpointSummary | null;
+export declare function toApiEndpointDetails(description: TeamsoApiEndpointDescription): ApiEndpointDetails | null;
+export declare function toApiModule(module: TeamsoApiModule): {
+    endpointCount: number;
+    allowedCount: number;
+    description?: string | undefined;
+    code: string;
+    title: string;
+} | null;
+/** SMS requirement from `smsCode {mode, when, preVerify, credits}`, else from `smsCodeRequired`. */
+export declare function smsRequirementOf(description: TeamsoApiEndpointDescription): ApiSmsRequirement | null;
+/**
+ * Unknown or missing values never become `read`: a GET with an unrecognised
+ * side effect is handled as a write, so `call_api_read` refuses it.
+ */
+export declare function sideEffectOf(value: unknown, method: ApiHttpMethod): SideEffect;
+export declare function normalizeMethod(value: string | undefined): ApiHttpMethod | undefined;
+/** `"POST /leave"` → `{ method: 'POST', path: '/leave' }`. */
+export declare function splitEndpointId(id: string): {
+    method: ApiHttpMethod;
+    path: string;
+} | null;
+export declare function pathVariables(pattern: string): string[];
+export interface ResolvedPath {
+    path: string;
+    problems: string[];
+}
+/**
+ * Fills `{var}` placeholders. Values travel as single path segments: `/`, `\`, `;`, `%`, control
+ * characters and dot-only values are refused (Teamso's firewall rejects them, and they could change
+ * the route), never silently rewritten.
+ */
+export declare function resolvePath(pattern: string, values?: Record<string, string | number>): ResolvedPath;
+/** Required query parameters that are missing; unknown names are warnings (the API ignores them). */
+export declare function checkQuery(parameters: ApiParameterInfo[], query?: Record<string, ApiQueryValue>): {
+    problems: string[];
+    warnings: string[];
+};
+/** Path with the query string, for display (`/leave/abc?page=1`). */
+export declare function displayPath(path: string, query?: Record<string, ApiQueryValue>): string;
+export interface BodyValidation {
+    /** False when the schema could not be compiled (the body was not checked). */
+    checked: boolean;
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateBody(schema: Record<string, unknown>, value: unknown): BodyValidation;
+/** True for `{type: string, format: binary}` and arrays of it (multipart file parts). */
+export declare function isBinarySchema(schema: unknown): boolean;
+/** A small example value for a schema: required properties first, placeholders for strings. */
+export declare function exampleFromSchema(schema: unknown, root: Record<string, unknown>, depth?: number): unknown;
+export declare const MAX_RESULT_CHARS = 40000;
+export interface ShapedResult {
+    result?: unknown;
+    truncated: boolean;
+    truncation?: {
+        originalChars: number;
+        arrayPath?: string;
+        originalItems?: number;
+        returnedItems?: number;
+        hint: string;
+    };
+    /** First characters of the JSON when no list could be shortened. */
+    resultPreview?: string;
+}
+/**
+ * Keeps results within `maxChars` of JSON. The longest list (the result itself or an array up to
+ * two levels down, e.g. `items`, `content`) is cut to the items that fit; the cut is always reported.
+ */
+export declare function shapeResult(result: unknown, maxChars?: number): ShapedResult;
+export declare function safeStringify(value: unknown, space?: number): string;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=api-endpoints.d.ts.map

package/dist/utils/api-endpoints.d.ts.map

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

package/dist/utils/api-endpoints.js

@@ -0,0 +1,459 @@
+import { createRequire } from 'node:module';
+/**
+ * Helpers for the generic API tools: defensive projections of the per-user
+ * catalog (`/mcp-catalog`), path and query resolution, request body
+ * validation (JSON Schema 2020-12), example arguments and result truncation.
+ */
+export const SIDE_EFFECTS = ['read', 'write', 'delete', 'read_with_writes'];
+export const SMS_MODES = ['always', 'conditional', 'never'];
+export const HTTP_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'];
+// ------------------------------------------------------------ projections
+export function toApiEndpointSummary(item) {
+    const parsedId = splitEndpointId(stringOf(item.id) ?? '');
+    const method = normalizeMethod(stringOf(item.method) ?? parsedId?.method);
+    const path = stringOf(item.path) ?? parsedId?.path;
+    if (!method || !path)
+        return null;
+    const sms = smsRequirementOf(item);
+    return {
+        id: `${method} ${path}`,
+        method,
+        path,
+        ...optional('module', stringOf(item.module)),
+        ...optional('moduleTitle', stringOf(item.moduleTitle)),
+        ...optional('summary', stringOf(item.summary)),
+        sideEffect: sideEffectOf(item.sideEffect, method),
+        smsCodeRequired: sms?.mode ?? 'never',
+        fileResponse: item.fileResponse === true,
+        multipart: item.multipart === true,
+        ...optional('access', stringOf(item.access)),
+        ...(typeof item.conditional === 'boolean' ? { conditional: item.conditional } : {}),
+    };
+}
+export function toApiEndpointDetails(description) {
+    const summary = toApiEndpointSummary(description);
+    if (!summary)
+        return null;
+    const defs = isRecord(description.$defs) ? description.$defs : {};
+    const parameters = (Array.isArray(description.parameters) ? description.parameters : [])
+        .map(toParameterInfo)
+        .filter((parameter) => parameter !== null);
+    // Every {var} of the path is a required path parameter, even when the catalog forgot one.
+    for (const name of pathVariables(summary.path)) {
+        if (!parameters.some(parameter => parameter.in === 'path' && parameter.name === name)) {
+            parameters.push({ name, in: 'path', required: true, schema: { type: 'string' } });
+        }
+    }
+    const body = isRecord(description.requestBody) ? description.requestBody : null;
+    const requestBody = body
+        ? {
+            required: body.required === true,
+            ...(typeof body.validated === 'boolean' ? { validated: body.validated } : {}),
+            contentType: stringOf(body.contentType) ?? (summary.multipart ? 'multipart/form-data' : 'application/json'),
+            schema: withDefs(isRecord(body.schema) ? body.schema : {}, defs),
+        }
+        : null;
+    return {
+        ...summary,
+        ...optional('accessReason', stringOf(description.accessReason)),
+        ...optional('permission', stringOf(description.permission)),
+        ...optional('moduleDescription', stringOf(description.moduleDescription)),
+        ...optional('responseKind', stringOf(description.responseKind)),
+        ...optional('doc', stringOf(description.doc)),
+        webScreens: stringArray(description.webScreens),
+        sms: smsRequirementOf(description),
+        parameters,
+        requestBody,
+        notes: stringArray(description.notes),
+        related: stringArray(description.related),
+    };
+}
+export function toApiModule(module) {
+    const code = stringOf(module.code);
+    if (!code)
+        return null;
+    return {
+        code,
+        title: stringOf(module.title) ?? code,
+        ...optional('description', stringOf(module.description)),
+        endpointCount: numberOf(module.endpointCount) ?? 0,
+        allowedCount: numberOf(module.allowedCount) ?? 0,
+    };
+}
+function toParameterInfo(parameter) {
+    const name = stringOf(parameter?.name);
+    const location = stringOf(parameter?.in);
+    if (!name || !location)
+        return null;
+    return {
+        name,
+        in: location,
+        required: parameter.required === true || location === 'path',
+        schema: isRecord(parameter.schema) ? parameter.schema : {},
+    };
+}
+/** SMS requirement from `smsCode {mode, when, preVerify, credits}`, else from `smsCodeRequired`. */
+export function smsRequirementOf(description) {
+    const detail = isRecord(description.smsCode) ? description.smsCode : null;
+    const flag = description.smsCodeRequired;
+    let mode = 'never';
+    const detailMode = stringOf(detail?.mode)?.toLowerCase();
+    const flagMode = typeof flag === 'string' ? flag.toLowerCase() : undefined;
+    if (detailMode === 'always' || detailMode === 'conditional')
+        mode = detailMode;
+    else if (flagMode === 'always' || flagMode === 'conditional')
+        mode = flagMode;
+    else if (flag === true || (detail && detailMode !== 'never'))
+        mode = 'always';
+    else if (flagMode && flagMode !== 'never' && flagMode !== 'false')
+        mode = 'always';
+    if (mode === 'never')
+        return null;
+    return {
+        mode,
+        ...optional('when', stringOf(detail?.when)),
+        preVerify: detail?.preVerify === true,
+        ...optional('credits', stringOf(detail?.credits)),
+    };
+}
+/**
+ * Unknown or missing values never become `read`: a GET with an unrecognised
+ * side effect is handled as a write, so `call_api_read` refuses it.
+ */
+export function sideEffectOf(value, method) {
+    if (typeof value === 'string' && SIDE_EFFECTS.includes(value))
+        return value;
+    if (method === 'DELETE')
+        return 'delete';
+    if (method !== 'GET')
+        return 'write';
+    return value === undefined || value === null ? 'read' : 'read_with_writes';
+}
+export function normalizeMethod(value) {
+    const upper = value?.trim().toUpperCase();
+    return upper && HTTP_METHODS.includes(upper) ? upper : undefined;
+}
+/** `"POST /leave"` → `{ method: 'POST', path: '/leave' }`. */
+export function splitEndpointId(id) {
+    const match = /^\s*([A-Za-z]+)\s+(\/\S*)\s*$/.exec(id);
+    const method = normalizeMethod(match?.[1]);
+    if (!match || !method)
+        return null;
+    return { method, path: match[2] };
+}
+// ------------------------------------------------------------- path/query
+const PATH_VARIABLE = /\{([^{}:]+)(?::[^{}]*)?\}/g;
+export function pathVariables(pattern) {
+    return [...pattern.matchAll(PATH_VARIABLE)].map(match => match[1].trim());
+}
+/**
+ * Fills `{var}` placeholders. Values travel as single path segments: `/`, `\`, `;`, `%`, control
+ * characters and dot-only values are refused (Teamso's firewall rejects them, and they could change
+ * the route), never silently rewritten.
+ */
+export function resolvePath(pattern, values = {}) {
+    const problems = [];
+    const names = pathVariables(pattern);
+    for (const name of Object.keys(values)) {
+        if (!names.includes(name)) {
+            problems.push(`path_params.${name} is not a placeholder of ${pattern}`
+                + (names.length ? ` (placeholders: ${names.map(item => `{${item}}`).join(', ')})` : ' (it has none)') + '.');
+        }
+    }
+    const path = pattern.replace(PATH_VARIABLE, (_whole, rawName) => {
+        const name = rawName.trim();
+        const raw = values[name];
+        if (raw === undefined || raw === null || String(raw).trim() === '') {
+            problems.push(`path_params.${name} is required (it fills {${name}} in ${pattern}).`);
+            return `{${name}}`;
+        }
+        const value = String(raw).trim();
+        if (value.length > 500 || /[/\\;%\u0000-\u001f\u007f]/.test(value) || /^\.+$/.test(value)) {
+            problems.push(`path_params.${name} cannot be sent as a URL path segment (no "/", "\\", ";", "%", `
+                + 'control characters or dot-only values, at most 500 characters).');
+            return `{${name}}`;
+        }
+        return encodeURIComponent(value).replace(/%3A/gi, ':');
+    });
+    return { path, problems };
+}
+/** Required query parameters that are missing; unknown names are warnings (the API ignores them). */
+export function checkQuery(parameters, query = {}) {
+    const problems = [];
+    const warnings = [];
+    const known = parameters.filter(parameter => parameter.in === 'query');
+    for (const parameter of known) {
+        const value = query[parameter.name];
+        const missing = value === undefined || value === '' || (Array.isArray(value) && value.length === 0);
+        if (parameter.required && missing && parameter.schema.default === undefined) {
+            problems.push(`query.${parameter.name} is required${describeType(parameter.schema)}.`);
+        }
+    }
+    for (const name of Object.keys(query)) {
+        if (!known.some(parameter => parameter.name === name)) {
+            warnings.push(`query.${name} is not a documented parameter of this endpoint; Teamso may ignore it.`);
+        }
+    }
+    for (const parameter of parameters) {
+        if (parameter.in === 'header' && parameter.required && parameter.schema.default === undefined) {
+            warnings.push(`This endpoint expects the header \`${parameter.name}\`, which MCP tools do not send; `
+                + 'the call may fail. Use the Teamso app for it.');
+        }
+    }
+    return { problems, warnings };
+}
+function describeType(schema) {
+    const parts = [stringOf(schema.type), stringOf(schema['x-pattern']) ?? stringOf(schema.format)].filter(Boolean);
+    return parts.length ? ` (${parts.join(', ')})` : '';
+}
+/** Path with the query string, for display (`/leave/abc?page=1`). */
+export function displayPath(path, query = {}) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null || value === '')
+            continue;
+        for (const item of Array.isArray(value) ? value : [value])
+            params.append(key, String(item));
+    }
+    const search = params.toString();
+    return search ? `${path}?${search}` : path;
+}
+let ajv;
+function getAjv() {
+    if (!ajv) {
+        const require = createRequire(import.meta.url);
+        const loaded = require('ajv/dist/2020');
+        const Ajv2020 = loaded.default ?? loaded;
+        // Teamso dates are not RFC 3339 (`yyyy-MM-dd HH:mm`) and `x-*` keywords are hints: check
+        // structure, types, enums and bounds, not formats.
+        ajv = new Ajv2020({ strict: false, allErrors: true, validateFormats: false, logger: false });
+    }
+    return ajv;
+}
+const MAX_VALIDATION_ERRORS = 20;
+export function validateBody(schema, value) {
+    const instance = getAjv();
+    let validate;
+    try {
+        validate = instance.compile(schema);
+    }
+    catch {
+        return { checked: false, valid: true, errors: [] };
+    }
+    try {
+        const valid = validate(value);
+        const errors = (validate.errors ?? []).slice(0, MAX_VALIDATION_ERRORS).map(formatAjvError);
+        return { checked: true, valid, errors: valid ? [] : errors };
+    }
+    finally {
+        // Compiled schemas are cached by object; drop it so a long-running server does not grow.
+        try {
+            instance.removeSchema(schema);
+        }
+        catch {
+            // nothing cached
+        }
+    }
+}
+function formatAjvError(error) {
+    const location = `body${String(error.instancePath ?? '').replace(/\//g, '.')}`;
+    const params = isRecord(error.params) ? error.params : {};
+    if (error.keyword === 'required' && params.missingProperty) {
+        return `${location}.${String(params.missingProperty)} is required.`;
+    }
+    if (error.keyword === 'enum' && Array.isArray(params.allowedValues)) {
+        return `${location} must be one of ${params.allowedValues.map(item => JSON.stringify(item)).join(', ')}.`;
+    }
+    if (error.keyword === 'additionalProperties' && params.additionalProperty) {
+        return `${location}.${String(params.additionalProperty)} is not allowed.`;
+    }
+    return `${location} ${String(error.message ?? 'is invalid')}.`;
+}
+function withDefs(schema, defs) {
+    const merged = { ...schema };
+    if (Object.keys(defs).length > 0) {
+        merged.$defs = { ...(isRecord(schema.$defs) ? schema.$defs : {}), ...defs };
+    }
+    return merged;
+}
+/** True for `{type: string, format: binary}` and arrays of it (multipart file parts). */
+export function isBinarySchema(schema) {
+    if (!isRecord(schema))
+        return false;
+    if (schema.format === 'binary')
+        return true;
+    return schema.type === 'array' && isBinarySchema(schema.items);
+}
+// ---------------------------------------------------------------- examples
+const MAX_EXAMPLE_DEPTH = 4;
+const MAX_EXAMPLE_PROPERTIES = 12;
+/** A small example value for a schema: required properties first, placeholders for strings. */
+export function exampleFromSchema(schema, root, depth = 0) {
+    if (!isRecord(schema))
+        return null;
+    if (schema.default !== undefined)
+        return schema.default;
+    if (Array.isArray(schema.examples) && schema.examples.length)
+        return schema.examples[0];
+    if (Array.isArray(schema.enum) && schema.enum.length)
+        return schema.enum[0];
+    const ref = stringOf(schema.$ref);
+    if (ref) {
+        if (depth >= MAX_EXAMPLE_DEPTH)
+            return {};
+        return exampleFromSchema(resolveRef(ref, root), root, depth + 1);
+    }
+    const type = Array.isArray(schema.type) ? schema.type.find(item => item !== 'null') : schema.type;
+    switch (type) {
+        case 'string': {
+            const pattern = stringOf(schema['x-pattern']);
+            if (schema.format === 'binary')
+                return '<file>';
+            if (pattern)
+                return `<${pattern}>`;
+            if (schema.format === 'date')
+                return '<yyyy-MM-dd>';
+            if (schema.format === 'date-time')
+                return '<yyyy-MM-dd HH:mm>';
+            if (schema.format === 'email')
+                return '<email>';
+            return '<string>';
+        }
+        case 'integer':
+        case 'number':
+            return typeof schema.minimum === 'number' ? schema.minimum : 0;
+        case 'boolean':
+            return false;
+        case 'array':
+            return depth >= MAX_EXAMPLE_DEPTH ? [] : [exampleFromSchema(schema.items, root, depth + 1)];
+        case 'object':
+        default: {
+            if (!isRecord(schema.properties))
+                return type === 'object' || schema['x-open-object'] ? {} : null;
+            if (depth >= MAX_EXAMPLE_DEPTH)
+                return {};
+            const required = stringArray(schema.required);
+            const names = required.length
+                ? required
+                : Object.keys(schema.properties).slice(0, MAX_EXAMPLE_PROPERTIES);
+            const example = {};
+            for (const name of names.slice(0, MAX_EXAMPLE_PROPERTIES)) {
+                example[name] = exampleFromSchema(schema.properties[name], root, depth + 1);
+            }
+            return example;
+        }
+    }
+}
+function resolveRef(ref, root) {
+    if (!ref.startsWith('#/'))
+        return undefined;
+    let node = root;
+    for (const part of ref.slice(2).split('/')) {
+        if (!isRecord(node))
+            return undefined;
+        node = node[part.replace(/~1/g, '/').replace(/~0/g, '~')];
+    }
+    return node;
+}
+// -------------------------------------------------------------- truncation
+export const MAX_RESULT_CHARS = 40_000;
+const PAGING_HINT = 'Ask for less: use the endpoint\'s paging or filter parameters (e.g. `page`/`size` or a '
+    + 'search value in `query`, see describe_api_endpoint) and call again.';
+/**
+ * Keeps results within `maxChars` of JSON. The longest list (the result itself or an array up to
+ * two levels down, e.g. `items`, `content`) is cut to the items that fit; the cut is always reported.
+ */
+export function shapeResult(result, maxChars = MAX_RESULT_CHARS) {
+    const json = safeStringify(result);
+    if (json.length <= maxChars)
+        return { result, truncated: false };
+    const candidate = largestArray(result);
+    if (candidate) {
+        const { path, array } = candidate;
+        let low = 0;
+        let high = array.length;
+        while (low < high) {
+            const middle = Math.ceil((low + high) / 2);
+            const size = safeStringify(replaceAt(result, path, array.slice(0, middle))).length;
+            if (size <= maxChars)
+                low = middle;
+            else
+                high = middle - 1;
+        }
+        if (low > 0) {
+            return {
+                result: replaceAt(result, path, array.slice(0, low)),
+                truncated: true,
+                truncation: {
+                    originalChars: json.length,
+                    arrayPath: path.length ? path.join('.') : '(result)',
+                    originalItems: array.length,
+                    returnedItems: low,
+                    hint: `Only the first ${low} of ${array.length} items are included. ${PAGING_HINT}`,
+                },
+            };
+        }
+    }
+    return {
+        truncated: true,
+        truncation: {
+            originalChars: json.length,
+            hint: `The result is ${json.length} characters of JSON; only the first ${maxChars} are in resultPreview. `
+                + PAGING_HINT,
+        },
+        resultPreview: json.slice(0, maxChars),
+    };
+}
+function largestArray(value) {
+    let best = null;
+    const consider = (path, node) => {
+        if (!Array.isArray(node) || node.length < 2)
+            return;
+        const size = safeStringify(node).length;
+        if (!best || size > best.size)
+            best = { path, array: node, size };
+    };
+    consider([], value);
+    if (isRecord(value)) {
+        for (const [key, child] of Object.entries(value)) {
+            consider([key], child);
+            if (isRecord(child)) {
+                for (const [innerKey, inner] of Object.entries(child))
+                    consider([key, innerKey], inner);
+            }
+        }
+    }
+    return best;
+}
+function replaceAt(value, path, replacement) {
+    if (path.length === 0)
+        return replacement;
+    const [head, ...rest] = path;
+    const record = value;
+    return { ...record, [head]: replaceAt(record[head], rest, replacement) };
+}
+export function safeStringify(value, space) {
+    try {
+        return JSON.stringify(value === undefined ? null : value, null, space) ?? 'null';
+    }
+    catch {
+        return '"[unserializable]"';
+    }
+}
+// ------------------------------------------------------------------ utils
+function stringOf(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value : undefined;
+}
+function numberOf(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function stringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
+}
+function optional(key, value) {
+    return (value === undefined ? {} : { [key]: value });
+}
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=api-endpoints.js.map

package/dist/utils/api-endpoints.js.map

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

package/dist/utils/dates.d.ts

@@ -0,0 +1,27 @@
+export declare const DEFAULT_WORKDAY_START = "09:00";
+export declare const DEFAULT_WORKDAY_END = "18:00";
+export interface WallClockInput {
+    /** `yyyy-MM-dd`. */
+    date: string;
+    /** `HH:mm`, or undefined when only a date was given. */
+    time?: string;
+}
+/** Parses `yyyy-MM-dd`, `yyyy-MM-dd HH:mm` or `yyyy-MM-ddTHH:mm[:ss]`; throws a readable error otherwise. */
+export declare function parseWallClock(value: string, field: string): WallClockInput;
+export declare function formatWallClock(date: string, time: string): string;
+/** `HH:mm` from `HH:mm[:ss]`, or undefined. */
+export declare function toClockTime(value: string | null | undefined): string | undefined;
+export declare const TEAMSO_TIME_ZONE = "Europe/Istanbul";
+/**
+ * `yyyy-MM-dd` from an API date. Instants (epoch millis, ISO strings with an
+ * offset) are read on the Turkey calendar, so a midnight stored in either UTC
+ * or Turkey time lands on the intended day; wall-clock strings
+ * (`yyyy-MM-dd[ HH:mm]`) are taken as they are.
+ */
+export declare function toIsoDay(value: string | number | null | undefined): string | undefined;
+/**
+ * API date-time for display. Instants become Turkey wall clock
+ * (`yyyy-MM-dd HH:mm`), matching the leave dates; other strings are kept.
+ */
+export declare function toDisplayDateTime(value: string | number | null | undefined): string | undefined;
+//# sourceMappingURL=dates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/utils/dates.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAC7C,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,6GAA6G;AAC7G,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAmB3E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKhF;AAED,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AA+BlD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAOtF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAK/F"}