@jazzmind/busibox-app 3.0.18

package/dist/lib/data/portal-config.js.map

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

package/dist/lib/data/settings.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Data Settings Store
+ *
+ * Manages document processing / ingestion settings via data-api document storage,
+ * replacing the Prisma DataSettings model.
+ *
+ * Pattern follows portal-config-store.ts: single record in a shared data-api document.
+ */
+export type DataSettingsRecord = {
+    id: string;
+    llmCleanupEnabled: boolean;
+    multiFlowEnabled: boolean;
+    maxParallelStrategies: number;
+    markerEnabled: boolean;
+    colpaliEnabled: boolean;
+    entityExtractionEnabled: boolean;
+    chunkSizeMin: number;
+    chunkSizeMax: number;
+    chunkOverlapPct: number;
+    timeoutSmall: number;
+    timeoutMedium: number;
+    timeoutLarge: number;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+};
+export type DataSettingsUpdate = Partial<Omit<DataSettingsRecord, 'id' | 'createdAt' | 'updatedAt' | 'isActive'>>;
+export declare function getDataApiTokenForSettings(userId: string, sessionJwt: string): Promise<{
+    accessToken: string;
+    roleIds: string[];
+}>;
+/**
+ * Get active data processing settings. Returns defaults if no settings exist yet.
+ */
+export declare function getDataSettings(accessToken: string): Promise<DataSettingsRecord>;
+/**
+ * Update data processing settings (upsert). Creates the document and record on first call.
+ */
+export declare function updateDataSettings(accessToken: string, roleIds: string[], updates: DataSettingsUpdate): Promise<DataSettingsRecord>;
+/**
+ * Get default settings without needing a token (for fallback/display).
+ */
+export declare function getDefaultDataSettings(): DataSettingsRecord;
+//# sourceMappingURL=settings.d.ts.map

package/dist/lib/data/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/lib/data/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,uBAAuB,EAAE,OAAO,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC;AA2IlH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CASrD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAO7B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAkC7B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,kBAAkB,CAQ3D"}

package/dist/lib/data/settings.js

@@ -0,0 +1,202 @@
+/**
+ * Data Settings Store
+ *
+ * Manages document processing / ingestion settings via data-api document storage,
+ * replacing the Prisma DataSettings model.
+ *
+ * Pattern follows portal-config-store.ts: single record in a shared data-api document.
+ */
+import { getDataApiUrl } from '../next/api-url';
+import { exchangeWithSubjectToken } from '../authz/next-client';
+import { getSharedRoleIdsForConfig } from './portal-config';
+const DOCUMENT_NAME = 'busibox-portal-data-settings';
+const RECORD_ID = 'active-settings';
+const DEFAULT_SETTINGS = {
+    llmCleanupEnabled: false,
+    multiFlowEnabled: false,
+    maxParallelStrategies: 3,
+    markerEnabled: false,
+    colpaliEnabled: true,
+    entityExtractionEnabled: false,
+    chunkSizeMin: 400,
+    chunkSizeMax: 800,
+    chunkOverlapPct: 0.12,
+    timeoutSmall: 300,
+    timeoutMedium: 600,
+    timeoutLarge: 1200,
+    isActive: true,
+};
+async function dataApiRequest(token, path, init = {}) {
+    const response = await fetch(`${getDataApiUrl()}${path}`, {
+        ...init,
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+            ...(init.headers || {}),
+        },
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        throw new Error(`data-api ${response.status} ${path}: ${text}`);
+    }
+    return (await response.json());
+}
+async function findDocumentId(token) {
+    const list = await dataApiRequest(token, '/data');
+    const existing = (list.documents || []).find((d) => d.name === DOCUMENT_NAME);
+    return existing?.id || null;
+}
+async function ensureDocument(token, roleIds) {
+    const existingId = await findDocumentId(token);
+    if (existingId)
+        return existingId;
+    if (!roleIds.length) {
+        throw new Error('Cannot create shared data-settings document without role IDs');
+    }
+    const created = await dataApiRequest(token, '/data', {
+        method: 'POST',
+        body: JSON.stringify({
+            name: DOCUMENT_NAME,
+            visibility: 'shared',
+            role_ids: roleIds,
+            roleIds: roleIds,
+            sourceApp: 'busibox-portal',
+            enableCache: false,
+            schema: {
+                displayName: 'Data Processing Settings',
+                itemLabel: 'Setting',
+                sourceApp: 'busibox-portal',
+                visibility: 'shared',
+                allowSharing: true,
+            },
+        }),
+    });
+    return created.id;
+}
+async function getSettingsRecord(token, documentId) {
+    const result = await dataApiRequest(token, `/data/${documentId}/query`, {
+        method: 'POST',
+        body: JSON.stringify({
+            where: { field: 'id', op: 'eq', value: RECORD_ID },
+            limit: 1,
+        }),
+    });
+    return result.records?.[0] || null;
+}
+function asBoolean(value, fallback) {
+    if (typeof value === 'boolean')
+        return value;
+    return fallback;
+}
+function asNumber(value, fallback) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string') {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return fallback;
+}
+function normalizeRecord(raw) {
+    const now = new Date().toISOString();
+    if (!raw) {
+        return {
+            id: RECORD_ID,
+            ...DEFAULT_SETTINGS,
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+    return {
+        id: RECORD_ID,
+        llmCleanupEnabled: asBoolean(raw.llmCleanupEnabled, DEFAULT_SETTINGS.llmCleanupEnabled),
+        multiFlowEnabled: asBoolean(raw.multiFlowEnabled, DEFAULT_SETTINGS.multiFlowEnabled),
+        maxParallelStrategies: asNumber(raw.maxParallelStrategies, DEFAULT_SETTINGS.maxParallelStrategies),
+        markerEnabled: asBoolean(raw.markerEnabled, DEFAULT_SETTINGS.markerEnabled),
+        colpaliEnabled: asBoolean(raw.colpaliEnabled, DEFAULT_SETTINGS.colpaliEnabled),
+        entityExtractionEnabled: asBoolean(raw.entityExtractionEnabled, DEFAULT_SETTINGS.entityExtractionEnabled),
+        chunkSizeMin: asNumber(raw.chunkSizeMin, DEFAULT_SETTINGS.chunkSizeMin),
+        chunkSizeMax: asNumber(raw.chunkSizeMax, DEFAULT_SETTINGS.chunkSizeMax),
+        chunkOverlapPct: asNumber(raw.chunkOverlapPct, DEFAULT_SETTINGS.chunkOverlapPct),
+        timeoutSmall: asNumber(raw.timeoutSmall, DEFAULT_SETTINGS.timeoutSmall),
+        timeoutMedium: asNumber(raw.timeoutMedium, DEFAULT_SETTINGS.timeoutMedium),
+        timeoutLarge: asNumber(raw.timeoutLarge, DEFAULT_SETTINGS.timeoutLarge),
+        isActive: asBoolean(raw.isActive, true),
+        createdAt: typeof raw.createdAt === 'string' ? raw.createdAt : now,
+        updatedAt: typeof raw.updatedAt === 'string' ? raw.updatedAt : now,
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export async function getDataApiTokenForSettings(userId, sessionJwt) {
+    const tokenResult = await exchangeWithSubjectToken({
+        userId,
+        sessionJwt,
+        audience: 'data-api',
+        purpose: 'busibox-portal-data-settings',
+    });
+    const roleIds = getSharedRoleIdsForConfig(tokenResult.accessToken, sessionJwt);
+    return { accessToken: tokenResult.accessToken, roleIds };
+}
+/**
+ * Get active data processing settings. Returns defaults if no settings exist yet.
+ */
+export async function getDataSettings(accessToken) {
+    const documentId = await findDocumentId(accessToken);
+    if (!documentId) {
+        return normalizeRecord(null);
+    }
+    const raw = await getSettingsRecord(accessToken, documentId);
+    return normalizeRecord(raw);
+}
+/**
+ * Update data processing settings (upsert). Creates the document and record on first call.
+ */
+export async function updateDataSettings(accessToken, roleIds, updates) {
+    const documentId = await ensureDocument(accessToken, roleIds);
+    const existing = await getSettingsRecord(accessToken, documentId);
+    const current = normalizeRecord(existing);
+    const now = new Date().toISOString();
+    const next = {
+        ...current,
+        ...updates,
+        id: RECORD_ID,
+        isActive: true,
+        updatedAt: now,
+    };
+    if (existing) {
+        await dataApiRequest(accessToken, `/data/${documentId}/records`, {
+            method: 'PUT',
+            body: JSON.stringify({
+                updates: next,
+                where: { field: 'id', op: 'eq', value: RECORD_ID },
+                validate: false,
+            }),
+        });
+    }
+    else {
+        await dataApiRequest(accessToken, `/data/${documentId}/records`, {
+            method: 'POST',
+            body: JSON.stringify({
+                records: [{ ...next, createdAt: now }],
+                validate: false,
+            }),
+        });
+    }
+    return next;
+}
+/**
+ * Get default settings without needing a token (for fallback/display).
+ */
+export function getDefaultDataSettings() {
+    const now = new Date().toISOString();
+    return {
+        id: RECORD_ID,
+        ...DEFAULT_SETTINGS,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+//# sourceMappingURL=settings.js.map

package/dist/lib/data/settings.js.map

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

package/dist/lib/data/tags.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tag utilities for document libraries.
+ *
+ * Tag data comes from data-api document metadata (extractedKeywords).
+ * getLibraryTagGroups aggregates extractedKeywords from library documents
+ * and returns tag groups for the Tags tab.
+ */
+export interface TagGroup {
+    name: string;
+    tags: string[];
+    confidence?: number;
+    documentCount?: number;
+}
+/**
+ * Classify tags into semantic groups using Agent API
+ */
+export declare function classifyTags(tags: string[], options?: {
+    maxGroups?: number;
+    context?: string;
+    userId?: string;
+}): Promise<TagGroup[]>;
+/**
+ * Get tag groups for a library from extractedKeywords.
+ *
+ * Uses classifyTags (Agent API) to group related tags semantically when possible.
+ * Falls back to one-tag-per-group if classification fails or returns empty.
+ * Each group includes documentCount (docs containing any tag in the group).
+ */
+export declare function getLibraryTagGroups(libraryId: string, _refresh: boolean, options: {
+    sessionJwt: string;
+    userId: string;
+}): Promise<TagGroup[]>;
+//# sourceMappingURL=tags.d.ts.map

package/dist/lib/data/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../../src/lib/data/tags.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACtE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAmCrB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,QAAQ,EAAE,CAAC,CA4ErB"}

package/dist/lib/data/tags.js

@@ -0,0 +1,190 @@
+/**
+ * Tag utilities for document libraries.
+ *
+ * Tag data comes from data-api document metadata (extractedKeywords).
+ * getLibraryTagGroups aggregates extractedKeywords from library documents
+ * and returns tag groups for the Tags tab.
+ */
+import { agentApiFetch } from '../agent/agent-api-base';
+import { getAuthzToken } from '../agent/app-client';
+import { getLibraryDocuments } from './libraries';
+/**
+ * Classify tags into semantic groups using Agent API
+ */
+export async function classifyTags(tags, options = {}) {
+    if (tags.length === 0) {
+        return [];
+    }
+    try {
+        let token;
+        if (options.userId) {
+            try {
+                token = await getAuthzToken(options.userId, 'agent-api', []);
+            }
+            catch {
+                // Auth optional for classify-tags
+            }
+        }
+        const response = await agentApiFetch('/classify-tags', {
+            method: 'POST',
+            token,
+            body: JSON.stringify({
+                tags,
+                maxGroups: options.maxGroups || 10,
+                context: options.context,
+            }),
+        });
+        const data = await response.json();
+        return data.groups || [];
+    }
+    catch (error) {
+        // 404 is expected when Agent API doesn't have classify-tags (optional feature)
+        const is404 = error instanceof Error && error.message.includes('404');
+        if (!is404) {
+            console.error('[TAGS] Classification error:', error);
+        }
+        return fallbackGrouping(tags);
+    }
+}
+/**
+ * Get tag groups for a library from extractedKeywords.
+ *
+ * Uses classifyTags (Agent API) to group related tags semantically when possible.
+ * Falls back to one-tag-per-group if classification fails or returns empty.
+ * Each group includes documentCount (docs containing any tag in the group).
+ */
+export async function getLibraryTagGroups(libraryId, _refresh, options) {
+    const { sessionJwt, userId } = options;
+    if (!sessionJwt || !userId) {
+        return [];
+    }
+    try {
+        const documents = await getLibraryDocuments(libraryId, {
+            sortBy: 'createdAt',
+            sortOrder: 'desc',
+            sessionJwt,
+            userId,
+        });
+        const keywordToDocCount = new Map();
+        const docKeywords = new Map(); // docId -> Set of keywords
+        for (const doc of documents) {
+            const docId = String(doc.id ?? '');
+            const keywords = doc.extractedKeywords ?? doc.extracted_keywords ?? [];
+            const kwList = Array.isArray(keywords) ? keywords : [];
+            const seen = new Set();
+            const docKws = new Set();
+            for (const kw of kwList) {
+                const k = String(kw).trim();
+                if (k && !seen.has(k)) {
+                    seen.add(k);
+                    docKws.add(k);
+                    keywordToDocCount.set(k, (keywordToDocCount.get(k) ?? 0) + 1);
+                }
+            }
+            docKeywords.set(docId, docKws);
+        }
+        const allKeywords = Array.from(keywordToDocCount.keys());
+        if (allKeywords.length === 0)
+            return [];
+        // Try semantic grouping via Agent API (groups related tags together)
+        // Fall back to heuristic grouping (prefix/root) when Agent classify-tags is unavailable
+        let tagGroups;
+        try {
+            const classified = await classifyTags(allKeywords, {
+                maxGroups: Math.min(15, Math.max(5, Math.ceil(allKeywords.length / 3))),
+                context: 'library document keywords',
+                userId,
+            });
+            if (classified.length > 0) {
+                tagGroups = classified;
+            }
+            else {
+                tagGroups = heuristicTagGrouping(allKeywords);
+            }
+        }
+        catch {
+            tagGroups = heuristicTagGrouping(allKeywords);
+        }
+        // Compute documentCount for each group: docs that have ANY tag in the group
+        const tagSet = new Set(allKeywords);
+        for (const group of tagGroups) {
+            const groupTags = group.tags.filter(t => tagSet.has(t));
+            if (groupTags.length === 0) {
+                group.documentCount = 0;
+                continue;
+            }
+            let count = 0;
+            for (const docKws of docKeywords.values()) {
+                if (groupTags.some(t => docKws.has(t)))
+                    count++;
+            }
+            group.documentCount = count;
+        }
+        return tagGroups
+            .filter(g => (g.documentCount ?? 0) > 0)
+            .sort((a, b) => (b.documentCount ?? 0) - (a.documentCount ?? 0));
+    }
+    catch (error) {
+        console.error('[TAGS] getLibraryTagGroups error:', error);
+        return [];
+    }
+}
+function fallbackGrouping(tags) {
+    return tags
+        .map((tag) => ({
+        name: tag,
+        tags: [tag],
+        confidence: 0.6,
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Semantic clusters for common terms (used when first-word heuristic would split related tags).
+ * E.g. "cash" and "credit" both map to "Financial".
+ */
+const SEMANTIC_CLUSTERS = {
+    cash: 'Financial',
+    credit: 'Financial',
+    tax: 'Financial',
+    payment: 'Financial',
+    budget: 'Financial',
+    invoice: 'Financial',
+    cost: 'Financial',
+    price: 'Financial',
+    funding: 'Financial',
+    renewable: 'Energy',
+    solar: 'Energy',
+    wind: 'Energy',
+    energy: 'Energy',
+    freeze: 'Process',
+    thaw: 'Process',
+    dewater: 'Process',
+    pour: 'Process',
+    record: 'Process',
+};
+/**
+ * Group tags by semantic clusters first, then by common first word.
+ * E.g. "cash", "credit" -> Financial; "tax", "tax credit" -> Financial; "freeze", "thaw" -> Process.
+ */
+function heuristicTagGrouping(tags) {
+    if (tags.length === 0)
+        return [];
+    const byCluster = new Map();
+    for (const tag of tags) {
+        const lower = tag.toLowerCase();
+        const firstWord = tag.split(/\s+/)[0]?.toLowerCase() || lower;
+        const cluster = SEMANTIC_CLUSTERS[firstWord] ?? SEMANTIC_CLUSTERS[lower] ?? firstWord;
+        const list = byCluster.get(cluster) ?? [];
+        if (!list.includes(tag))
+            list.push(tag);
+        byCluster.set(cluster, list);
+    }
+    return Array.from(byCluster.entries())
+        .map(([name, groupTags]) => ({
+        name,
+        tags: groupTags.sort((a, b) => a.localeCompare(b)),
+        confidence: 0.6,
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=tags.js.map

package/dist/lib/data/tags.js.map

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

package/dist/lib/date-utils.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Date/Time Formatting Utilities
+ *
+ * Provides consistent, timezone-aware date formatting across the application.
+ * All functions automatically convert UTC timestamps to the user's local timezone.
+ */
+/**
+ * Format a date/time string for display with full date and time.
+ * Includes timezone indicator for clarity.
+ *
+ * Note: Timestamps from the database are stored in UTC. If they don't have
+ * a Z suffix, we append one to ensure proper timezone conversion.
+ *
+ * @example formatDateTime('2026-01-22T17:16:11.163071Z') => 'Jan 22, 2026, 12:16 PM EST'
+ * @example formatDateTime('2026-01-22T17:16:11.163071') => 'Jan 22, 2026, 12:16 PM EST' (same, assumes UTC)
+ */
+export declare function formatDateTime(isoString: string | undefined | null): string;
+/**
+ * Format a date string for display (date only, no time).
+ *
+ * @example formatDate('2026-01-22T17:16:11.163071Z') => 'Jan 22, 2026'
+ */
+export declare function formatDate(isoString: string | undefined | null): string;
+/**
+ * Format a time string for display (time only, no date).
+ *
+ * @example formatTime('2026-01-22T17:16:11.163071Z') => '12:16 PM'
+ */
+export declare function formatTime(isoString: string | undefined | null): string;
+/**
+ * Format a time string with seconds for display.
+ *
+ * @example formatTimeWithSeconds('2026-01-22T17:16:11.163071Z') => '12:16:11 PM'
+ */
+export declare function formatTimeWithSeconds(isoString: string | undefined | null): string;
+/**
+ * Format a date/time as a relative string (e.g., "2 hours ago", "in 3 days").
+ * Falls back to absolute date for times more than 7 days away.
+ *
+ * @example formatRelativeTime('2026-01-22T15:16:11.163071Z') => '2 hours ago'
+ */
+export declare function formatRelativeTime(isoString: string | undefined | null): string;
+/**
+ * Format a short relative time string (e.g., "2h ago", "3d").
+ * Good for compact UI elements like lists.
+ *
+ * @example formatShortRelativeTime('2026-01-22T15:16:11.163071Z') => '2h ago'
+ */
+export declare function formatShortRelativeTime(isoString: string | undefined | null): string;
+/**
+ * Format a duration in seconds as a human-readable string.
+ *
+ * @example formatDuration(3661) => '1h 1m 1s'
+ * @example formatDuration(45) => '45s'
+ * @example formatDuration(125.5) => '2m 5.5s'
+ */
+export declare function formatDuration(seconds: number | undefined | null): string;
+/**
+ * Format a timestamp for use in forms (datetime-local input value).
+ * Returns a string in the format 'YYYY-MM-DDTHH:mm' in local timezone.
+ *
+ * @example formatForDateTimeInput('2026-01-22T17:16:11.163071Z') => '2026-01-22T12:16'
+ */
+export declare function formatForDateTimeInput(isoString: string | undefined | null): string;
+/**
+ * Parse a datetime-local input value to ISO string (UTC).
+ * Converts local time to UTC for storage.
+ *
+ * @example parseFromDateTimeInput('2026-01-22T12:16') => '2026-01-22T17:16:00.000Z'
+ */
+export declare function parseFromDateTimeInput(localDateTimeString: string): string | null;
+//# sourceMappingURL=date-utils.d.ts.map

package/dist/lib/date-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../../src/lib/date-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAkB3E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAevE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAcvE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAelF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAkC/E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAgCpF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAyBzE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAkBnF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYjF"}