@harborclient/core 0.1.1

package/dist/plugin/catalog.js

@@ -0,0 +1,248 @@
+import { z } from 'zod';
+import { sanitizePluginCatalogCategories } from './catalogCategories';
+/**
+ * Public URL of the generated plugin catalog served from harborclient.com.
+ */
+export const PLUGIN_CATALOG_URL = 'https://harborclient.com/plugin_catalog.json';
+/**
+ * Public URL of the generated theme catalog served from harborclient.com.
+ */
+export const THEME_CATALOG_URL = 'https://harborclient.com/theme_catalog.json';
+/**
+ * Public URL of the official HarborClient plugin signing key served from harborclient.com.
+ */
+export const PLUGIN_SIGNING_PUBLIC_KEY_URL = 'https://harborclient.com/plugins/harborclient.key';
+/**
+ * Public URL of the trusted plugin signing key registry served from harborclient.com.
+ */
+export const PLUGIN_TRUSTED_KEYS_URL = 'https://harborclient.com/plugins/trusted.json';
+const pluginManifestId = z
+    .string()
+    .min(3)
+    .regex(/^[a-zA-Z][a-zA-Z0-9.-]*\.[a-zA-Z][a-zA-Z0-9.-]+$/);
+/**
+ * Validates that a catalog entry points at a public GitHub repository over HTTPS.
+ *
+ * @param url - Repository URL from the catalog source file.
+ * @returns Trimmed URL when valid.
+ */
+function parseGitHubRepoUrl(url) {
+    const trimmed = url.trim();
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        throw new Error(`Plugin catalog repoUrl is not valid: ${url}`);
+    }
+    if (parsed.protocol !== 'https:') {
+        throw new Error(`Plugin catalog repoUrl must use https://: ${url}`);
+    }
+    if (parsed.hostname !== 'github.com') {
+        throw new Error(`Plugin catalog repoUrl must be hosted on github.com: ${url}`);
+    }
+    const segments = parsed.pathname.split('/').filter(Boolean);
+    if (segments.length < 2) {
+        throw new Error(`Plugin catalog repoUrl must include owner and repository: ${url}`);
+    }
+    return trimmed;
+}
+const catalogThemeContributionSchema = z.object({
+    id: z.string().min(1),
+    title: z.string().min(1),
+    type: z.enum(['light', 'dark', 'high-contrast'])
+});
+/**
+ * Zod schema for one curated plugin or theme marketplace listing.
+ */
+export const pluginCatalogEntrySchema = z.object({
+    id: pluginManifestId,
+    name: z.string().min(1),
+    version: z.string().min(1),
+    summary: z.string().min(1),
+    author: z.string().min(1),
+    categories: z.array(z.string().min(1)).transform(sanitizePluginCatalogCategories),
+    repoUrl: z.string().min(1).transform(parseGitHubRepoUrl),
+    ref: z.string().min(1).optional(),
+    homepage: z.string().url().optional(),
+    icon: z.string().url().optional(),
+    /** Absolute URL or repository-relative path (e.g. `screenshot.png`). */
+    screenshot: z.string().min(1).optional(),
+    /** Absolute URLs or repository-relative paths for marketplace thumbnails. */
+    screenshots: z.array(z.string().min(1)).optional(),
+    /** Inlined Markdown description fetched from the plugin repository at build time. */
+    description: z.string().min(1).optional(),
+    minAppVersion: z.string().min(1).optional(),
+    /** Theme contributions copied from manifest.contributes.themes at catalog build time. */
+    contributes: z
+        .object({
+        themes: z.array(catalogThemeContributionSchema).optional()
+    })
+        .optional()
+});
+/**
+ * Zod schema for the plugin marketplace catalog document.
+ */
+export const pluginCatalogSchema = z.object({
+    schemaVersion: z.literal(1),
+    plugins: z.array(pluginCatalogEntrySchema)
+});
+/**
+ * Zod schema for the theme marketplace catalog document.
+ */
+export const themeCatalogSchema = z.object({
+    schemaVersion: z.literal(1),
+    themes: z.array(pluginCatalogEntrySchema)
+});
+/**
+ * Parses and validates a plugin catalog payload.
+ *
+ * @param raw - Unknown JSON value from disk or an HTTP response.
+ * @returns Validated catalog with unique plugin ids.
+ * @throws When the payload is invalid or contains duplicate ids.
+ */
+export function parsePluginCatalog(raw) {
+    const parsed = pluginCatalogSchema.parse(raw);
+    const seen = new Set();
+    for (const entry of parsed.plugins) {
+        if (seen.has(entry.id)) {
+            throw new Error(`Plugin catalog contains duplicate id: ${entry.id}`);
+        }
+        seen.add(entry.id);
+    }
+    return parsed;
+}
+/**
+ * Parses and validates a theme catalog payload.
+ *
+ * @param raw - Unknown JSON value from disk or an HTTP response.
+ * @returns Validated catalog with unique theme plugin ids.
+ * @throws When the payload is invalid or contains duplicate ids.
+ */
+export function parseThemeCatalog(raw) {
+    const parsed = themeCatalogSchema.parse(raw);
+    const seen = new Set();
+    for (const entry of parsed.themes) {
+        if (seen.has(entry.id)) {
+            throw new Error(`Theme catalog contains duplicate id: ${entry.id}`);
+        }
+        seen.add(entry.id);
+    }
+    return parsed;
+}
+const pluginTrustedKeyEntrySchema = z.object({
+    author: z.string().min(1),
+    key: z.string().url()
+});
+/**
+ * Parses and validates a trusted plugin signing key registry payload.
+ *
+ * @param raw - Unknown JSON value from disk or an HTTP response.
+ * @returns Validated trusted key entries with unique key URLs.
+ * @throws When the payload is invalid or contains duplicate key URLs.
+ */
+export function parsePluginTrustedKeys(raw) {
+    const parsed = z.array(pluginTrustedKeyEntrySchema).parse(raw);
+    const seen = new Set();
+    for (const entry of parsed) {
+        if (seen.has(entry.key)) {
+            throw new Error(`Plugin trusted keys contain duplicate key URL: ${entry.key}`);
+        }
+        seen.add(entry.key);
+    }
+    return parsed;
+}
+/**
+ * Validates that a plugin source URL uses http or https and returns the trimmed value.
+ *
+ * @param url - Catalog or trusted registry URL from user settings.
+ * @returns Trimmed URL when valid.
+ */
+function parsePluginSourceUrl(url) {
+    const trimmed = url.trim();
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        throw new Error(`Plugin source URL is not valid: ${url}`);
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new Error(`Plugin source URL must use http:// or https://: ${url}`);
+    }
+    return trimmed;
+}
+const pluginSourceSchema = z.object({
+    url: z.string().min(1).transform(parsePluginSourceUrl),
+    enabled: z.boolean()
+});
+/**
+ * Zod schema for persisted plugin catalog and trusted-key source settings.
+ */
+export const pluginSourcesSchema = z.object({
+    catalogs: z.array(pluginSourceSchema),
+    trusted: z.array(pluginSourceSchema)
+});
+/**
+ * Returns the built-in HarborClient catalog and trusted-key endpoints, enabled by default.
+ *
+ * @returns Default plugin source settings with HarborClient URLs first in each list.
+ */
+export function getDefaultPluginSources() {
+    return {
+        catalogs: [{ url: PLUGIN_CATALOG_URL, enabled: true }],
+        trusted: [{ url: PLUGIN_TRUSTED_KEYS_URL, enabled: true }]
+    };
+}
+/**
+ * Deduplicates plugin source rows by URL while preserving the first occurrence.
+ *
+ * @param sources - Raw or normalized plugin source rows.
+ * @returns Sources with duplicate URLs removed.
+ */
+function dedupePluginSources(sources) {
+    const seen = new Set();
+    const deduped = [];
+    for (const source of sources) {
+        if (seen.has(source.url)) {
+            continue;
+        }
+        seen.add(source.url);
+        deduped.push(source);
+    }
+    return deduped;
+}
+/**
+ * Normalizes persisted plugin source settings with trimmed URLs and deduplication.
+ *
+ * @param raw - Unknown settings from storage or user input.
+ * @returns Validated settings, or defaults when both lists are empty after normalization.
+ */
+export function normalizePluginSources(raw) {
+    const parsed = pluginSourcesSchema.safeParse(raw);
+    if (!parsed.success) {
+        return getDefaultPluginSources();
+    }
+    const catalogs = dedupePluginSources(parsed.data.catalogs);
+    const trusted = dedupePluginSources(parsed.data.trusted);
+    if (catalogs.length === 0 && trusted.length === 0) {
+        return getDefaultPluginSources();
+    }
+    return { catalogs, trusted };
+}
+/**
+ * Returns whether a plugin source URL is hosted on harborclient.com or a subdomain.
+ *
+ * @param url - Catalog or trusted registry URL to inspect.
+ * @returns True when the hostname is harborclient.com or ends with .harborclient.com.
+ */
+export function isHarborClientEndpoint(url) {
+    try {
+        const hostname = new URL(url.trim()).hostname.toLowerCase();
+        return hostname === 'harborclient.com' || hostname.endsWith('.harborclient.com');
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=catalog.js.map

package/dist/plugin/catalog.js.map

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

package/dist/plugin/catalogCategories.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Canonical marketplace plugin category slugs in display order.
+ */
+export declare const PLUGIN_CATALOG_CATEGORIES: readonly ["requests", "auth", "environments", "import", "scripting", "logging", "jwt", "response", "themes", "light", "dark", "high-contrast", "collections", "editor", "testing", "export", "graphql", "websocket", "mock", "debugging", "security", "sidebar", "utilities"];
+/**
+ * One allowed plugin marketplace category slug.
+ */
+export type PluginCatalogCategory = (typeof PLUGIN_CATALOG_CATEGORIES)[number];
+/**
+ * Human-readable labels for marketplace category slugs shown in UI.
+ */
+export declare const PLUGIN_CATALOG_CATEGORY_LABELS: Record<PluginCatalogCategory, string>;
+/**
+ * Returns whether a string is a recognized plugin marketplace category slug.
+ *
+ * @param value - Raw category string from catalog JSON.
+ * @returns True when the value is a predefined category slug.
+ */
+export declare function isPluginCatalogCategory(value: string): value is PluginCatalogCategory;
+/**
+ * Keeps only predefined category slugs, preserving order and removing duplicates.
+ *
+ * Unknown categories from catalog entries are dropped so third-party catalogs
+ * cannot introduce uncontrolled filter labels in the marketplace UI.
+ *
+ * @param categories - Raw category strings from a catalog entry.
+ * @returns Sanitized category slugs, which may be empty when none are recognized.
+ */
+export declare function sanitizePluginCatalogCategories(categories: string[]): PluginCatalogCategory[];
+//# sourceMappingURL=catalogCategories.d.ts.map

package/dist/plugin/catalogCategories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogCategories.d.ts","sourceRoot":"","sources":["../../src/plugin/catalogCategories.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,yBAAyB,+QAwB5B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAwBhF,CAAC;AAIF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,qBAAqB,CAErF;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,qBAAqB,EAAE,CAa7F"}

package/dist/plugin/catalogCategories.js

@@ -0,0 +1,88 @@
+/**
+ * Canonical marketplace plugin category slugs in display order.
+ */
+export const PLUGIN_CATALOG_CATEGORIES = [
+    'requests',
+    'auth',
+    'environments',
+    'import',
+    'scripting',
+    'logging',
+    'jwt',
+    'response',
+    'themes',
+    'light',
+    'dark',
+    'high-contrast',
+    'collections',
+    'editor',
+    'testing',
+    'export',
+    'graphql',
+    'websocket',
+    'mock',
+    'debugging',
+    'security',
+    'sidebar',
+    'utilities'
+];
+/**
+ * Human-readable labels for marketplace category slugs shown in UI.
+ */
+export const PLUGIN_CATALOG_CATEGORY_LABELS = {
+    'requests': 'Requests',
+    'auth': 'Authentication',
+    'environments': 'Environments',
+    'import': 'Import',
+    'scripting': 'Scripting',
+    'logging': 'Logging',
+    'jwt': 'JWT',
+    'response': 'Response',
+    'themes': 'Themes',
+    'light': 'Light',
+    'dark': 'Dark',
+    'high-contrast': 'High Contrast',
+    'collections': 'Collections',
+    'editor': 'Editor',
+    'testing': 'Testing',
+    'export': 'Export',
+    'graphql': 'GraphQL',
+    'websocket': 'WebSocket',
+    'mock': 'Mocking',
+    'debugging': 'Debugging',
+    'security': 'Security',
+    'sidebar': 'Sidebar',
+    'utilities': 'Utilities'
+};
+const categorySet = new Set(PLUGIN_CATALOG_CATEGORIES);
+/**
+ * Returns whether a string is a recognized plugin marketplace category slug.
+ *
+ * @param value - Raw category string from catalog JSON.
+ * @returns True when the value is a predefined category slug.
+ */
+export function isPluginCatalogCategory(value) {
+    return categorySet.has(value);
+}
+/**
+ * Keeps only predefined category slugs, preserving order and removing duplicates.
+ *
+ * Unknown categories from catalog entries are dropped so third-party catalogs
+ * cannot introduce uncontrolled filter labels in the marketplace UI.
+ *
+ * @param categories - Raw category strings from a catalog entry.
+ * @returns Sanitized category slugs, which may be empty when none are recognized.
+ */
+export function sanitizePluginCatalogCategories(categories) {
+    const seen = new Set();
+    const sanitized = [];
+    for (const category of categories) {
+        if (!isPluginCatalogCategory(category) || seen.has(category)) {
+            continue;
+        }
+        seen.add(category);
+        sanitized.push(category);
+    }
+    return sanitized;
+}
+//# sourceMappingURL=catalogCategories.js.map

package/dist/plugin/catalogCategories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogCategories.js","sourceRoot":"","sources":["../../src/plugin/catalogCategories.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,UAAU;IACV,MAAM;IACN,cAAc;IACd,QAAQ;IACR,WAAW;IACX,SAAS;IACT,KAAK;IACL,UAAU;IACV,QAAQ;IACR,OAAO;IACP,MAAM;IACN,eAAe;IACf,aAAa;IACb,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,SAAS;IACT,WAAW;IACX,MAAM;IACN,WAAW;IACX,UAAU;IACV,SAAS;IACT,WAAW;CACH,CAAC;AAOX;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAA0C;IACnF,UAAU,EAAE,UAAU;IACtB,MAAM,EAAE,gBAAgB;IACxB,cAAc,EAAE,cAAc;IAC9B,QAAQ,EAAE,QAAQ;IAClB,WAAW,EAAE,WAAW;IACxB,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,KAAK;IACZ,UAAU,EAAE,UAAU;IACtB,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,MAAM;IACd,eAAe,EAAE,eAAe;IAChC,aAAa,EAAE,aAAa;IAC5B,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,SAAS;IACpB,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,WAAW;IACxB,MAAM,EAAE,SAAS;IACjB,WAAW,EAAE,WAAW;IACxB,UAAU,EAAE,UAAU;IACtB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,WAAW;CACzB,CAAC;AAEF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,yBAAyB,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,+BAA+B,CAAC,UAAoB;IAClE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC9C,MAAM,SAAS,GAA4B,EAAE,CAAC;IAE9C,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7D,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/plugin/customThemeExport.d.ts

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+import type { CustomTheme, CustomThemeExport, CustomThemeImportDraft, CustomThemeType } from '../types/customTheme';
+import type { ThemeSource } from '../types/settings';
+/**
+ * Zod schema for saving a custom theme from the Designer form.
+ */
+export declare const customThemeSaveInputSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    type: z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+        "high-contrast": "high-contrast";
+    }>;
+    colors: z.ZodRecord<z.ZodString, z.ZodString>;
+    metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    stylesheet: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod schema for portable custom theme export files.
+ */
+export declare const customThemeExportSchema: z.ZodObject<{
+    harborclientVersion: z.ZodLiteral<1>;
+    harborclientExport: z.ZodLiteral<"theme">;
+    theme: z.ZodRecord<z.ZodString, z.ZodString>;
+    metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    title: z.ZodString;
+    type: z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+        "high-contrast": "high-contrast";
+    }>;
+    stylesheet: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Validates a parsed JSON object as a custom theme export file.
+ *
+ * @param data - Raw parsed JSON from disk or an import dialog.
+ * @returns Validated export envelope.
+ * @throws When the file is not a valid theme export.
+ */
+export declare function validateCustomThemeExport(data: unknown): CustomThemeExport;
+/**
+ * Converts a stored custom theme to its on-disk export envelope.
+ *
+ * @param theme - Custom theme with id and palette values.
+ * @returns Portable export envelope without the id field.
+ */
+export declare function customThemeToEnvelope(theme: CustomTheme): CustomThemeExport;
+/**
+ * Converts a validated export envelope and filename stem into a custom theme record.
+ *
+ * @param id - Filename stem for the theme.
+ * @param envelope - Validated export envelope.
+ * @returns Custom theme record for renderer and IPC consumers.
+ */
+export declare function envelopeToCustomTheme(id: string, envelope: CustomThemeExport): CustomTheme;
+/**
+ * Converts an import draft from a validated export envelope.
+ *
+ * @param envelope - Validated export envelope.
+ * @returns Draft values for the Designer form without saving.
+ */
+export declare function envelopeToImportDraft(envelope: CustomThemeExport): CustomThemeImportDraft;
+/**
+ * Serializes a custom theme id into a persisted theme preference value.
+ *
+ * @param id - Custom theme filename stem.
+ * @returns Theme source string stored via theme:get/set.
+ */
+export declare function formatCustomThemeValue(id: string): ThemeSource;
+/**
+ * Parses a persisted custom theme preference.
+ *
+ * @param value - Raw theme setting from storage.
+ * @returns Custom theme id when the value is custom-scoped.
+ */
+export declare function parseCustomThemeSource(value: string): {
+    id: string;
+} | null;
+/**
+ * Returns whether a string is a valid custom theme id for filenames.
+ *
+ * @param id - Candidate filename stem.
+ * @returns True when the id is safe to use as `<id>.json`.
+ */
+export declare function isValidCustomThemeId(id: string): boolean;
+/**
+ * Type guard for custom theme appearance values.
+ *
+ * @param value - Candidate appearance mode.
+ * @returns True when the value is a supported custom theme type.
+ */
+export declare function isCustomThemeType(value: string): value is CustomThemeType;
+//# sourceMappingURL=customThemeExport.d.ts.map

package/dist/plugin/customThemeExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customThemeExport.d.ts","sourceRoot":"","sources":["../../src/plugin/customThemeExport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAwIrD;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;iBAOrC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;iBAQK,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAW1E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAgB3E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,WAAW,CAS1F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,sBAAsB,CAQzF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE"}