@coworkee/client 0.0.0-stage → 0.0.1024

package/dist/schema.js

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export {};

package/dist/stream.d.ts

@@ -0,0 +1,7 @@
+import { type CoworkeeClientOptions } from './client.ts';
+/** Splits text that arrives in chunks into complete lines; the rest waits for the next chunk. */
+export declare function lineSplitter(): (chunk: string, end?: boolean) => string[];
+/** POSTs JSON and hands every line of the newline-delimited JSON answer (application/x-ndjson) to onEvent as it arrives. */
+export declare function postNdjson<T>(path: string, body: unknown, onEvent: (event: T) => void, options?: CoworkeeClientOptions & {
+    signal?: AbortSignal;
+}): Promise<void>;

package/dist/stream.js

@@ -0,0 +1,33 @@
+import { csrfHeader } from "./client.js";
+import { ApiError, problemOf } from "./errors.js";
+/** Splits text that arrives in chunks into complete lines; the rest waits for the next chunk. */
+export function lineSplitter() {
+    let rest = '';
+    return (chunk, end = false) => {
+        const lines = (rest + chunk).split('\n');
+        rest = end ? '' : lines.pop() ?? '';
+        return lines.map((line) => line.trim()).filter(Boolean);
+    };
+}
+/** POSTs JSON and hands every line of the newline-delimited JSON answer (application/x-ndjson) to onEvent as it arrives. */
+export async function postNdjson(path, body, onEvent, options = {}) {
+    const headers = new Headers({ 'Content-Type': 'application/json', Accept: 'application/x-ndjson' });
+    if (options.token)
+        headers.set('Authorization', `Bearer ${await options.token()}`);
+    else
+        headers.set(csrfHeader.name, csrfHeader.value);
+    const response = await (options.fetch ?? fetch)(`${options.baseUrl ?? ''}${path}`, { method: 'POST', credentials: 'same-origin', headers, body: JSON.stringify(body), signal: options.signal });
+    if (!response.ok)
+        throw new ApiError(response.status, await problemOf(response));
+    const split = lineSplitter();
+    const decoder = new TextDecoder();
+    const reader = response.body?.getReader();
+    if (!reader)
+        return split(await response.text(), true).forEach((line) => onEvent(JSON.parse(line)));
+    for (;;) {
+        const { done, value } = await reader.read();
+        split(done ? decoder.decode() : decoder.decode(value, { stream: true }), done).forEach((line) => onEvent(JSON.parse(line)));
+        if (done)
+            return;
+    }
+}

package/dist/texts.d.ts

@@ -0,0 +1,11 @@
+import { type CoworkeeClientOptions } from './client.ts';
+/** English text → text in the user's language, as the API serves them (library texts, app texts, translations made in the app). */
+export type Texts = Record<string, string>;
+export type Translate = (key: string, ...args: unknown[]) => string;
+export declare function getTexts(culture: string, options?: CoworkeeClientOptions): Promise<Texts>;
+/** Fills {0}, {1}, ... like string.Format; format suffixes ({0:N0}) are ignored. */
+export declare function format(text: string, args: readonly unknown[]): string;
+/** Looks a key up, falls back to the key (the English text) and fills the placeholders. */
+export declare const translator: (texts: Texts) => Translate;
+/** The user's culture: the setting Localization.Culture, else the browser's first language, else English. */
+export declare function pickCulture(setting?: string | null, browser?: readonly string[]): string;

package/dist/texts.js

@@ -0,0 +1,15 @@
+import { apiRequest } from "./client.js";
+export async function getTexts(culture, options) {
+    const result = await apiRequest(`/api/v1/localization/texts/${encodeURIComponent(culture)}`, {}, options);
+    return result?.texts ?? {};
+}
+/** Fills {0}, {1}, ... like string.Format; format suffixes ({0:N0}) are ignored. */
+export function format(text, args) {
+    return args.length === 0 ? text : text.replace(/\{(\d+)(:[^}]*)?\}/g, (match, index) => index in args ? String(args[Number(index)]) : match);
+}
+/** Looks a key up, falls back to the key (the English text) and fills the placeholders. */
+export const translator = (texts) => (key, ...args) => format(texts[key] || key, args);
+/** The user's culture: the setting Localization.Culture, else the browser's first language, else English. */
+export function pickCulture(setting, browser = typeof navigator === 'object' ? navigator.languages ?? [] : []) {
+    return setting?.trim() || browser.find(Boolean) || 'en';
+}

package/dist/theme.d.ts

@@ -0,0 +1,30 @@
+import { type CoworkeeClientOptions } from './client.ts';
+import type { components } from './schema.ts';
+export type Theme = components['schemas']['ThemeDto'];
+export type ColorMode = 'light' | 'dark';
+/** The colors of a theme in one mode, MudBlazor's defaults filled in; keys in camel case (primary, textSecondary, ...). */
+export declare function palette(theme: Theme | undefined, mode: ColorMode): Record<string, string>;
+/** CSS custom properties of the theme: --cw-primary, --cw-surface, --cw-text, ..., --cw-font, --cw-heading-font, --cw-radius. */
+export declare function cssVariables(theme: Theme | undefined, mode: ColorMode): Record<string, string>;
+/** Light or dark: the setting Theme.Mode (light, dark, system) or the operating system's. */
+export declare function resolveMode(setting?: string | null, prefersDark?: boolean): ColorMode;
+/** An address for an img: SVG markup becomes a data URL, data URLs and addresses stay as they are. */
+export declare function logoUrl(logo?: string | null): string | undefined;
+export declare function applyTheme(theme: Theme | undefined, mode: ColorMode, root?: HTMLElement): void;
+/** The theme of the signed-in user's organisation, or the default one (anonymous). */
+export declare const getCurrentTheme: (options?: CoworkeeClientOptions) => Promise<{
+    id: string;
+    name: string;
+    isGlobal: boolean;
+    isDefault: boolean;
+    paletteLight: components["schemas"]["JsonElement"];
+    paletteDark: components["schemas"]["JsonElement"];
+    typography: null | components["schemas"]["JsonElement"];
+    layoutProperties: null | components["schemas"]["JsonElement"];
+    logo: null | string;
+    customCss: null | string;
+    revision: number | string;
+    shadows?: unknown;
+    options?: unknown;
+    isPublished: boolean;
+}>;

package/dist/theme.js

@@ -0,0 +1,65 @@
+import { apiRequest } from "./client.js";
+/** MudBlazor's defaults, which a theme's palette overrides key by key (themes store only what they change). */
+const defaults = {
+    light: {
+        primary: '#594ae2', primaryContrastText: '#ffffff', secondary: '#ff4081', secondaryContrastText: '#ffffff', background: '#ffffff', surface: '#ffffff',
+        textPrimary: '#424242', textSecondary: '#00000089', linesDefault: '#0000001e', appbarBackground: '#594ae2', appbarText: '#ffffff',
+        error: '#f44336', success: '#00c853', warning: '#ff9800', info: '#2196f3',
+    },
+    dark: {
+        primary: '#776be7', primaryContrastText: '#ffffff', secondary: '#ff4081', secondaryContrastText: '#ffffff', background: '#32333d', surface: '#373740',
+        textPrimary: '#ffffffb2', textSecondary: '#ffffff80', linesDefault: '#ffffff1e', appbarBackground: '#27272f', appbarText: '#ffffffb2',
+        error: '#f64e62', success: '#0bba83', warning: '#ffa800', info: '#3299ff',
+    },
+};
+const variables = [
+    ['primary', 'primary'], ['primary-text', 'primaryContrastText'], ['secondary', 'secondary'], ['secondary-text', 'secondaryContrastText'],
+    ['background', 'background'], ['surface', 'surface'], ['text', 'textPrimary'], ['text-secondary', 'textSecondary'], ['lines', 'linesDefault'],
+    ['appbar', 'appbarBackground'], ['appbar-text', 'appbarText'], ['error', 'error'], ['success', 'success'], ['warning', 'warning'], ['info', 'info'],
+];
+const camel = (key) => key.charAt(0).toLowerCase() + key.slice(1);
+const record = (value) => value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+/** The colors of a theme in one mode, MudBlazor's defaults filled in; keys in camel case (primary, textSecondary, ...). */
+export function palette(theme, mode) {
+    const stored = record(mode === 'dark' ? theme?.paletteDark : theme?.paletteLight);
+    return { ...defaults[mode], ...Object.fromEntries(Object.entries(stored).filter(([, value]) => typeof value === 'string').map(([key, value]) => [camel(key), value])) };
+}
+function fontOf(typography, name) {
+    const family = record(record(typography)[name]).FontFamily ?? record(record(typography)[camel(name)]).fontFamily;
+    return Array.isArray(family) && family.length > 0 ? family.map((font) => /[\s"]/.test(String(font)) ? `"${String(font).replace(/"/g, '')}"` : String(font)).join(', ') : undefined;
+}
+/** CSS custom properties of the theme: --cw-primary, --cw-surface, --cw-text, ..., --cw-font, --cw-heading-font, --cw-radius. */
+export function cssVariables(theme, mode) {
+    const colors = palette(theme, mode);
+    const result = Object.fromEntries(variables.map(([name, key]) => [`--cw-${name}`, colors[key]]));
+    const font = fontOf(theme?.typography, 'Default');
+    if (font)
+        result['--cw-font'] = font;
+    const heading = fontOf(theme?.typography, 'H1') ?? font;
+    if (heading)
+        result['--cw-heading-font'] = heading;
+    const layout = record(theme?.layoutProperties);
+    const radius = layout.DefaultBorderRadius ?? layout.defaultBorderRadius;
+    if (typeof radius === 'string' && radius)
+        result['--cw-radius'] = radius;
+    return result;
+}
+/** Light or dark: the setting Theme.Mode (light, dark, system) or the operating system's. */
+export function resolveMode(setting, prefersDark = typeof matchMedia === 'function' && matchMedia('(prefers-color-scheme: dark)').matches) {
+    return setting === 'dark' || setting === 'light' ? setting : prefersDark ? 'dark' : 'light';
+}
+/** An address for an img: SVG markup becomes a data URL, data URLs and addresses stay as they are. */
+export function logoUrl(logo) {
+    const value = logo?.trim();
+    if (!value)
+        return undefined;
+    return value.startsWith('<') ? `data:image/svg+xml;charset=utf-8,${encodeURIComponent(value)}` : value;
+}
+export function applyTheme(theme, mode, root = document.documentElement) {
+    for (const [name, value] of Object.entries(cssVariables(theme, mode)))
+        root.style.setProperty(name, value);
+    root.style.colorScheme = mode;
+    root.dataset.cwMode = mode;
+}
+/** The theme of the signed-in user's organisation, or the default one (anonymous). */
+export const getCurrentTheme = (options) => apiRequest('/api/v1/themes/current', {}, options);