@harborclient/core 0.1.1

package/dist/auth.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Authorization type for the Auth tab; none inherits collection auth at send time.
+ */
+export type AuthType = 'none' | 'basic' | 'bearer' | 'oauth2';
+/**
+ * How OAuth client credentials are sent to the token endpoint.
+ */
+export type OAuth2ClientAuth = 'body' | 'header';
+/**
+ * OAuth 2.0 Client Credentials configuration stored on requests and collections.
+ */
+export interface OAuth2Config {
+    /**
+     * Token endpoint URL.
+     */
+    tokenUrl: string;
+    /**
+     * OAuth client id.
+     */
+    clientId: string;
+    /**
+     * OAuth client secret.
+     */
+    clientSecret: string;
+    /**
+     * Space-delimited OAuth scopes.
+     */
+    scope: string;
+    /**
+     * Optional audience claim for token requests.
+     */
+    audience: string;
+    /**
+     * Whether client credentials are sent in the POST body or as HTTP Basic auth.
+     */
+    clientAuth: OAuth2ClientAuth;
+}
+/**
+ * Basic and bearer credential fields stored together so switching type preserves values.
+ */
+export interface AuthConfig {
+    /**
+     * Selected auth mode; none means no request-level override.
+     */
+    type: AuthType;
+    /**
+     * Username and password for Basic Auth.
+     */
+    basic: {
+        username: string;
+        password: string;
+    };
+    /**
+     * Token value for Bearer Token auth.
+     */
+    bearer: {
+        token: string;
+    };
+    /**
+     * OAuth 2.0 Client Credentials settings.
+     */
+    oauth2: OAuth2Config;
+}
+/**
+ * Result of fetching or refreshing an OAuth 2.0 access token.
+ */
+export interface OAuthFetchTokenResult {
+    /**
+     * Access token returned by the authorization server.
+     */
+    accessToken: string;
+    /**
+     * ISO 8601 expiry timestamp when known.
+     */
+    expiresAt?: string;
+    /**
+     * Token type from the token response, typically Bearer.
+     */
+    tokenType: string;
+}
+/**
+ * Returns a default auth config with type none and empty credentials.
+ *
+ * @returns Empty AuthConfig safe for new requests and collections.
+ */
+export declare function defaultAuth(): AuthConfig;
+/**
+ * Returns empty OAuth 2.0 Client Credentials fields.
+ *
+ * @returns Default OAuth2Config for new auth configs.
+ */
+export declare function defaultOAuth2Config(): OAuth2Config;
+/**
+ * JSON string of {@link defaultAuth} for database column defaults.
+ */
+export declare const DEFAULT_AUTH_JSON: string;
+/**
+ * Flat auth shape exposed by hc.request.auth and hc.collection.auth in scripts.
+ */
+export type ScriptAuthInput = {
+    type?: AuthType;
+    token?: string;
+    username?: string;
+    password?: string;
+    tokenUrl?: string;
+    clientId?: string;
+    clientSecret?: string;
+    scope?: string;
+    audience?: string;
+    clientAuth?: OAuth2ClientAuth;
+};
+/**
+ * Flat field names accepted by hc.*.auth.update().
+ */
+export type ScriptAuthField = keyof ScriptAuthInput;
+/**
+ * Returns the flat auth shape for the active auth type in a config.
+ *
+ * @param auth - Normalized auth configuration.
+ * @returns Flat object suitable for hc.*.auth.get().
+ */
+export declare function flattenAuthConfig(auth: AuthConfig): ScriptAuthInput;
+/**
+ * Merges a flat script auth input onto an existing auth config.
+ *
+ * Preserves credential values in inactive sub-objects so switching type
+ * matches the Auth tab behavior.
+ *
+ * @param current - Current normalized auth configuration.
+ * @param input - Flat partial auth from hc.*.auth.set().
+ * @returns Updated auth config.
+ */
+export declare function applyScriptAuthSet(current: AuthConfig, input: unknown): AuthConfig;
+/**
+ * Updates a single flat auth field on an existing auth config.
+ *
+ * @param current - Current normalized auth configuration.
+ * @param field - Flat field name from hc.*.auth.update().
+ * @param value - New value for the field.
+ * @returns Updated auth config.
+ */
+export declare function applyScriptAuthUpdate(current: AuthConfig, field: unknown, value: unknown): AuthConfig;
+/**
+ * Builds a stable cache key for OAuth token storage.
+ *
+ * @param scope - Whether the auth config belongs to a saved request or collection.
+ * @param id - Saved entity id.
+ * @returns Cache key used by the main-process token store.
+ */
+export declare function buildOAuthCacheKey(scope: 'request' | 'collection' | 'folder', id: number): string;
+/**
+ * Normalizes a partial or legacy auth value from storage into a full AuthConfig.
+ *
+ * @param value - Parsed JSON or unknown field from the database.
+ * @returns Valid AuthConfig with defaults for missing fields.
+ */
+export declare function normalizeAuth(value: unknown): AuthConfig;
+/**
+ * Encodes username and password as a UTF-8-safe Basic Auth credential string.
+ *
+ * @param username - Basic Auth username (already variable-resolved at send time).
+ * @param password - Basic Auth password (already variable-resolved at send time).
+ * @returns Base64-encoded `username:password` suitable for the Authorization header.
+ */
+export declare function encodeBasicAuth(username: string, password: string): string;
+/**
+ * Builds the Authorization header value from an auth config.
+ *
+ * Assumes credential strings are already variable-resolved. Returns null when
+ * type is none or required fields are empty after trimming. OAuth 2.0 tokens
+ * are fetched separately in the main process and are not handled here.
+ *
+ * @param auth - Auth configuration from the request or collection.
+ * @returns Header value such as `Basic …` or `Bearer …`, or null when auth is inactive.
+ */
+export declare function buildAuthHeaderValue(auth: AuthConfig): string | null;
+/**
+ * Builds an Authorization header value from a fetched OAuth access token.
+ *
+ * @param result - Token fetch result from the main process.
+ * @returns Header value such as `Bearer …`, or null when the token is unsafe or empty.
+ */
+export declare function buildOAuthAuthHeaderValue(result: OAuthFetchTokenResult): string | null;
+/**
+ * Resolves {{variable}} placeholders in auth credential fields using a lookup map.
+ *
+ * @param auth - Auth config with raw editor values.
+ * @param substitute - Function that resolves placeholders in a string.
+ * @returns Auth config with substituted credential fields.
+ */
+export declare function resolveAuthVariables(auth: AuthConfig, substitute: (text: string) => string): AuthConfig;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

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

package/dist/auth.js

@@ -0,0 +1,294 @@
+import { hasUnsafeHeaderFieldChars } from './httpHeaders';
+/**
+ * Returns a default auth config with type none and empty credentials.
+ *
+ * @returns Empty AuthConfig safe for new requests and collections.
+ */
+export function defaultAuth() {
+    return {
+        type: 'none',
+        basic: { username: '', password: '' },
+        bearer: { token: '' },
+        oauth2: defaultOAuth2Config()
+    };
+}
+/**
+ * Returns empty OAuth 2.0 Client Credentials fields.
+ *
+ * @returns Default OAuth2Config for new auth configs.
+ */
+export function defaultOAuth2Config() {
+    return {
+        tokenUrl: '',
+        clientId: '',
+        clientSecret: '',
+        scope: '',
+        audience: '',
+        clientAuth: 'body'
+    };
+}
+/**
+ * JSON string of {@link defaultAuth} for database column defaults.
+ */
+export const DEFAULT_AUTH_JSON = JSON.stringify(defaultAuth());
+/**
+ * Returns the flat auth shape for the active auth type in a config.
+ *
+ * @param auth - Normalized auth configuration.
+ * @returns Flat object suitable for hc.*.auth.get().
+ */
+export function flattenAuthConfig(auth) {
+    switch (auth.type) {
+        case 'basic':
+            return {
+                type: 'basic',
+                username: auth.basic.username,
+                password: auth.basic.password
+            };
+        case 'bearer':
+            return {
+                type: 'bearer',
+                token: auth.bearer.token
+            };
+        case 'oauth2':
+            return {
+                type: 'oauth2',
+                tokenUrl: auth.oauth2.tokenUrl,
+                clientId: auth.oauth2.clientId,
+                clientSecret: auth.oauth2.clientSecret,
+                scope: auth.oauth2.scope,
+                audience: auth.oauth2.audience,
+                clientAuth: auth.oauth2.clientAuth
+            };
+        default:
+            return { type: 'none' };
+    }
+}
+/**
+ * Merges a flat script auth input onto an existing auth config.
+ *
+ * Preserves credential values in inactive sub-objects so switching type
+ * matches the Auth tab behavior.
+ *
+ * @param current - Current normalized auth configuration.
+ * @param input - Flat partial auth from hc.*.auth.set().
+ * @returns Updated auth config.
+ */
+export function applyScriptAuthSet(current, input) {
+    if (input == null || typeof input !== 'object') {
+        throw new Error('auth.set requires an auth object');
+    }
+    const record = input;
+    const next = normalizeAuth(current);
+    if (record.type !== undefined) {
+        const type = String(record.type);
+        if (type !== 'none' && type !== 'basic' && type !== 'bearer' && type !== 'oauth2') {
+            throw new Error(`Invalid auth type: ${type}`);
+        }
+        next.type = type;
+    }
+    if (record.token !== undefined) {
+        next.bearer.token = String(record.token);
+    }
+    if (record.username !== undefined) {
+        next.basic.username = String(record.username);
+    }
+    if (record.password !== undefined) {
+        next.basic.password = String(record.password);
+    }
+    if (record.tokenUrl !== undefined) {
+        next.oauth2.tokenUrl = String(record.tokenUrl);
+    }
+    if (record.clientId !== undefined) {
+        next.oauth2.clientId = String(record.clientId);
+    }
+    if (record.clientSecret !== undefined) {
+        next.oauth2.clientSecret = String(record.clientSecret);
+    }
+    if (record.scope !== undefined) {
+        next.oauth2.scope = String(record.scope);
+    }
+    if (record.audience !== undefined) {
+        next.oauth2.audience = String(record.audience);
+    }
+    if (record.clientAuth !== undefined) {
+        const clientAuth = String(record.clientAuth);
+        if (clientAuth !== 'body' && clientAuth !== 'header') {
+            throw new Error(`Invalid oauth2 clientAuth: ${clientAuth}`);
+        }
+        next.oauth2.clientAuth = clientAuth;
+    }
+    return next;
+}
+/**
+ * Updates a single flat auth field on an existing auth config.
+ *
+ * @param current - Current normalized auth configuration.
+ * @param field - Flat field name from hc.*.auth.update().
+ * @param value - New value for the field.
+ * @returns Updated auth config.
+ */
+export function applyScriptAuthUpdate(current, field, value) {
+    const key = String(field);
+    const validFields = [
+        'type',
+        'token',
+        'username',
+        'password',
+        'tokenUrl',
+        'clientId',
+        'clientSecret',
+        'scope',
+        'audience',
+        'clientAuth'
+    ];
+    if (!validFields.includes(key)) {
+        throw new Error(`Invalid auth field: ${key}`);
+    }
+    return applyScriptAuthSet(current, { [key]: value });
+}
+/**
+ * Builds a stable cache key for OAuth token storage.
+ *
+ * @param scope - Whether the auth config belongs to a saved request or collection.
+ * @param id - Saved entity id.
+ * @returns Cache key used by the main-process token store.
+ */
+export function buildOAuthCacheKey(scope, id) {
+    return `${scope}:${id}`;
+}
+/**
+ * Normalizes a partial or legacy auth value from storage into a full AuthConfig.
+ *
+ * @param value - Parsed JSON or unknown field from the database.
+ * @returns Valid AuthConfig with defaults for missing fields.
+ */
+export function normalizeAuth(value) {
+    const fallback = defaultAuth();
+    if (value == null || typeof value !== 'object') {
+        return fallback;
+    }
+    const record = value;
+    const type = record.type === 'basic' ||
+        record.type === 'bearer' ||
+        record.type === 'oauth2' ||
+        record.type === 'none'
+        ? record.type
+        : fallback.type;
+    const basicRecord = record.basic != null && typeof record.basic === 'object'
+        ? record.basic
+        : {};
+    const bearerRecord = record.bearer != null && typeof record.bearer === 'object'
+        ? record.bearer
+        : {};
+    const oauth2Record = record.oauth2 != null && typeof record.oauth2 === 'object'
+        ? record.oauth2
+        : {};
+    return {
+        type,
+        basic: {
+            username: typeof basicRecord.username === 'string' ? basicRecord.username : '',
+            password: typeof basicRecord.password === 'string' ? basicRecord.password : ''
+        },
+        bearer: {
+            token: typeof bearerRecord.token === 'string' ? bearerRecord.token : ''
+        },
+        oauth2: {
+            tokenUrl: typeof oauth2Record.tokenUrl === 'string' ? oauth2Record.tokenUrl : '',
+            clientId: typeof oauth2Record.clientId === 'string' ? oauth2Record.clientId : '',
+            clientSecret: typeof oauth2Record.clientSecret === 'string' ? oauth2Record.clientSecret : '',
+            scope: typeof oauth2Record.scope === 'string' ? oauth2Record.scope : '',
+            audience: typeof oauth2Record.audience === 'string' ? oauth2Record.audience : '',
+            clientAuth: oauth2Record.clientAuth === 'header' ? 'header' : 'body'
+        }
+    };
+}
+/**
+ * Encodes username and password as a UTF-8-safe Basic Auth credential string.
+ *
+ * @param username - Basic Auth username (already variable-resolved at send time).
+ * @param password - Basic Auth password (already variable-resolved at send time).
+ * @returns Base64-encoded `username:password` suitable for the Authorization header.
+ */
+export function encodeBasicAuth(username, password) {
+    const credential = `${username}:${password}`;
+    if (typeof Buffer !== 'undefined') {
+        return Buffer.from(credential, 'utf-8').toString('base64');
+    }
+    const bytes = new TextEncoder().encode(credential);
+    let binary = '';
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    return globalThis.btoa(binary);
+}
+/**
+ * Builds the Authorization header value from an auth config.
+ *
+ * Assumes credential strings are already variable-resolved. Returns null when
+ * type is none or required fields are empty after trimming. OAuth 2.0 tokens
+ * are fetched separately in the main process and are not handled here.
+ *
+ * @param auth - Auth configuration from the request or collection.
+ * @returns Header value such as `Basic …` or `Bearer …`, or null when auth is inactive.
+ */
+export function buildAuthHeaderValue(auth) {
+    if (auth.type === 'none' || auth.type === 'oauth2') {
+        return null;
+    }
+    if (auth.type === 'basic') {
+        const username = auth.basic.username.trim();
+        const password = auth.basic.password;
+        if (!username && !password.trim()) {
+            return null;
+        }
+        return `Basic ${encodeBasicAuth(username, password)}`;
+    }
+    const token = auth.bearer.token.trim();
+    if (!token || hasUnsafeHeaderFieldChars(token)) {
+        return null;
+    }
+    return `Bearer ${token}`;
+}
+/**
+ * Builds an Authorization header value from a fetched OAuth access token.
+ *
+ * @param result - Token fetch result from the main process.
+ * @returns Header value such as `Bearer …`, or null when the token is unsafe or empty.
+ */
+export function buildOAuthAuthHeaderValue(result) {
+    const token = result.accessToken.trim();
+    if (!token || hasUnsafeHeaderFieldChars(token)) {
+        return null;
+    }
+    const tokenType = result.tokenType.trim() || 'Bearer';
+    return `${tokenType} ${token}`;
+}
+/**
+ * Resolves {{variable}} placeholders in auth credential fields using a lookup map.
+ *
+ * @param auth - Auth config with raw editor values.
+ * @param substitute - Function that resolves placeholders in a string.
+ * @returns Auth config with substituted credential fields.
+ */
+export function resolveAuthVariables(auth, substitute) {
+    return {
+        ...auth,
+        basic: {
+            username: substitute(auth.basic.username),
+            password: substitute(auth.basic.password)
+        },
+        bearer: {
+            token: substitute(auth.bearer.token)
+        },
+        oauth2: {
+            tokenUrl: substitute(auth.oauth2.tokenUrl),
+            clientId: substitute(auth.oauth2.clientId),
+            clientSecret: substitute(auth.oauth2.clientSecret),
+            scope: substitute(auth.oauth2.scope),
+            audience: substitute(auth.oauth2.audience),
+            clientAuth: auth.oauth2.clientAuth
+        }
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/bodyRawSend.d.ts

@@ -0,0 +1,25 @@
+import type { BodyType, KeyValue, SendRequestInput } from '@harborclient/http';
+/**
+ * Applies a Raw body override to an outbound send payload.
+ *
+ * When `bodyRaw` is non-null, it becomes the authoritative body for sending (including
+ * the empty string). For multipart/urlencoded, ensures a Content-Type header is present
+ * so the Requester can preserve the boundary / urlencoded media type instead of
+ * normalizing structured JSON.
+ *
+ * @param input - Send payload built from the structured draft / scripts.
+ * @param bodyRaw - Verbatim override from the Raw editor, or null when inactive.
+ * @param bodyType - Active body type (multipart or urlencoded when this applies).
+ * @returns Input with `bodyRaw` set and Content-Type ensured when needed.
+ */
+export declare function applyBodyRawOverride(input: SendRequestInput, bodyRaw: string | null | undefined, bodyType: BodyType): SendRequestInput;
+/**
+ * Ensures an explicit Content-Type header for raw multipart/urlencoded overrides.
+ *
+ * @param headers - Existing request headers.
+ * @param bodyRaw - Verbatim raw body text.
+ * @param bodyType - Active body type.
+ * @returns Headers with Content-Type added when missing for multipart/urlencoded.
+ */
+export declare function ensureRawBodyContentType(headers: KeyValue[], bodyRaw: string, bodyType: BodyType): KeyValue[];
+//# sourceMappingURL=bodyRawSend.d.ts.map

package/dist/bodyRawSend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bodyRawSend.d.ts","sourceRoot":"","sources":["../src/bodyRawSend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG/E;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,QAAQ,EAAE,QAAQ,GACjB,gBAAgB,CAWlB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,QAAQ,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,GACjB,QAAQ,EAAE,CA+BZ"}

package/dist/bodyRawSend.js

@@ -0,0 +1,61 @@
+import { multipartRawContentType } from './multipartRaw';
+/**
+ * Applies a Raw body override to an outbound send payload.
+ *
+ * When `bodyRaw` is non-null, it becomes the authoritative body for sending (including
+ * the empty string). For multipart/urlencoded, ensures a Content-Type header is present
+ * so the Requester can preserve the boundary / urlencoded media type instead of
+ * normalizing structured JSON.
+ *
+ * @param input - Send payload built from the structured draft / scripts.
+ * @param bodyRaw - Verbatim override from the Raw editor, or null when inactive.
+ * @param bodyType - Active body type (multipart or urlencoded when this applies).
+ * @returns Input with `bodyRaw` set and Content-Type ensured when needed.
+ */
+export function applyBodyRawOverride(input, bodyRaw, bodyType) {
+    if (bodyRaw === null || bodyRaw === undefined) {
+        return input;
+    }
+    const headers = ensureRawBodyContentType(input.headers, bodyRaw, bodyType);
+    return {
+        ...input,
+        headers,
+        bodyRaw
+    };
+}
+/**
+ * Ensures an explicit Content-Type header for raw multipart/urlencoded overrides.
+ *
+ * @param headers - Existing request headers.
+ * @param bodyRaw - Verbatim raw body text.
+ * @param bodyType - Active body type.
+ * @returns Headers with Content-Type added when missing for multipart/urlencoded.
+ */
+export function ensureRawBodyContentType(headers, bodyRaw, bodyType) {
+    const hasContentType = headers.some((header) => header.enabled && header.key.trim().toLowerCase() === 'content-type');
+    if (hasContentType) {
+        return headers;
+    }
+    if (bodyType === 'urlencoded') {
+        return [
+            ...headers,
+            {
+                key: 'Content-Type',
+                value: 'application/x-www-form-urlencoded',
+                enabled: true
+            }
+        ];
+    }
+    if (bodyType === 'multipart') {
+        return [
+            ...headers,
+            {
+                key: 'Content-Type',
+                value: multipartRawContentType(bodyRaw),
+                enabled: true
+            }
+        ];
+    }
+    return headers;
+}
+//# sourceMappingURL=bodyRawSend.js.map

package/dist/bodyRawSend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bodyRawSend.js","sourceRoot":"","sources":["../src/bodyRawSend.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAuB,EACvB,OAAkC,EAClC,QAAkB;IAElB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC3E,OAAO;QACL,GAAG,KAAK;QACR,OAAO;QACP,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAmB,EACnB,OAAe,EACf,QAAkB;IAElB,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CACjC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,cAAc,CACjF,CAAC;IACF,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC9B,OAAO;YACL,GAAG,OAAO;YACV;gBACE,GAAG,EAAE,cAAc;gBACnB,KAAK,EAAE,mCAAmC;gBAC1C,OAAO,EAAE,IAAI;aACd;SACF,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC7B,OAAO;YACL,GAAG,OAAO;YACV;gBACE,GAAG,EAAE,cAAc;gBACnB,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC;gBACvC,OAAO,EAAE,IAAI;aACd;SACF,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/builtinThemes.d.ts

@@ -0,0 +1,33 @@
+import type { CustomThemeType } from './types/customTheme';
+/**
+ * Reserved filename stems for built-in appearance themes stored under
+ * `{userData}/custom_themes`.
+ */
+export declare const BUILTIN_THEME_IDS: readonly ["light", "dark", "high-contrast"];
+/**
+ * Built-in theme id type matching persisted `ThemeSource` values.
+ */
+export type BuiltinThemeId = (typeof BUILTIN_THEME_IDS)[number];
+/**
+ * Human-readable labels for built-in themes shown in Installed cards.
+ */
+export declare const BUILTIN_THEME_TITLES: Record<BuiltinThemeId, string>;
+/**
+ * Base appearance mode for each built-in theme id.
+ */
+export declare const BUILTIN_THEME_TYPES: Record<BuiltinThemeId, CustomThemeType>;
+/**
+ * Returns whether a theme id is reserved for a built-in appearance theme.
+ *
+ * @param id - Candidate filename stem.
+ * @returns True when the id matches a built-in theme.
+ */
+export declare function isBuiltinThemeId(id: string): id is BuiltinThemeId;
+/**
+ * Returns whether a persisted theme preference refers to a built-in theme.
+ *
+ * @param theme - Persisted theme preference value.
+ * @returns True when the value is a built-in theme source.
+ */
+export declare function isBuiltinThemeSource(theme: string): theme is BuiltinThemeId;
+//# sourceMappingURL=builtinThemes.d.ts.map

package/dist/builtinThemes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtinThemes.d.ts","sourceRoot":"","sources":["../src/builtinThemes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,6CAA8C,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAI/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,cAAc,EAAE,eAAe,CAIvE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,cAAc,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAE3E"}

package/dist/builtinThemes.js

@@ -0,0 +1,40 @@
+/**
+ * Reserved filename stems for built-in appearance themes stored under
+ * `{userData}/custom_themes`.
+ */
+export const BUILTIN_THEME_IDS = ['light', 'dark', 'high-contrast'];
+/**
+ * Human-readable labels for built-in themes shown in Installed cards.
+ */
+export const BUILTIN_THEME_TITLES = {
+    'light': 'Light',
+    'dark': 'Dark',
+    'high-contrast': 'High contrast'
+};
+/**
+ * Base appearance mode for each built-in theme id.
+ */
+export const BUILTIN_THEME_TYPES = {
+    'light': 'light',
+    'dark': 'dark',
+    'high-contrast': 'high-contrast'
+};
+/**
+ * Returns whether a theme id is reserved for a built-in appearance theme.
+ *
+ * @param id - Candidate filename stem.
+ * @returns True when the id matches a built-in theme.
+ */
+export function isBuiltinThemeId(id) {
+    return BUILTIN_THEME_IDS.includes(id);
+}
+/**
+ * Returns whether a persisted theme preference refers to a built-in theme.
+ *
+ * @param theme - Persisted theme preference value.
+ * @returns True when the value is a built-in theme source.
+ */
+export function isBuiltinThemeSource(theme) {
+    return isBuiltinThemeId(theme);
+}
+//# sourceMappingURL=builtinThemes.js.map