@oronts/vendure-data-hub-plugin 0.1.0

package/dist/src/types/typed-config.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * Typed Pipeline Configuration
+ *
+ * Type-safe utility functions and namespace objects for building pipeline
+ * definitions with compile-time validation. Provides:
+ *
+ * - Namespace objects (Extractors, Operators, Loaders, Exporters, Feeds) with
+ *   factory functions that return correctly-typed adapter configs
+ * - Step factory functions (extractStep, transformStep, etc.) that produce
+ *   PipelineStepDefinition with the correct `type` field
+ * - deriveCapabilities() to auto-derive required permissions from steps
+ * - TypedStep union type covering all typed step definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Feeds = exports.Exporters = exports.Loaders = exports.Operators = exports.Extractors = void 0;
+exports.extractStep = extractStep;
+exports.transformStep = transformStep;
+exports.validateStep = validateStep;
+exports.loadStep = loadStep;
+exports.routeStep = routeStep;
+exports.exportStep = exportStep;
+exports.feedStep = feedStep;
+exports.deriveCapabilities = deriveCapabilities;
+// ============================================================================
+// Step Factory Functions
+// ============================================================================
+function makeStep(key, type, config, extras) {
+    const adapterCode = typeof config.adapterCode === 'string' ? config.adapterCode : undefined;
+    return {
+        key,
+        type,
+        config: config,
+        __adapterCode: adapterCode,
+        ...(extras ?? {}),
+    };
+}
+/** Create a typed EXTRACT step definition. */
+function extractStep(key, config, extras) {
+    return makeStep(key, 'EXTRACT', config, extras);
+}
+/** Create a typed TRANSFORM step definition. */
+function transformStep(key, config, extras) {
+    return makeStep(key, 'TRANSFORM', config, extras);
+}
+/** Create a typed VALIDATE step definition. */
+function validateStep(key, config, extras) {
+    return makeStep(key, 'VALIDATE', config, extras);
+}
+/** Create a typed LOAD step definition. */
+function loadStep(key, config, extras) {
+    return makeStep(key, 'LOAD', config, extras);
+}
+/** Create a typed ROUTE step definition. */
+function routeStep(key, config, extras) {
+    return makeStep(key, 'ROUTE', config, extras);
+}
+/** Create a typed EXPORT step definition. */
+function exportStep(key, config, extras) {
+    return makeStep(key, 'EXPORT', config, extras);
+}
+/** Create a typed FEED step definition. */
+function feedStep(key, config, extras) {
+    return makeStep(key, 'FEED', config, extras);
+}
+exports.Extractors = {
+    csv: (config) => ({ adapterCode: 'csv', ...config }),
+    json: (config) => ({ adapterCode: 'json', ...config }),
+    excel: (config) => ({ adapterCode: 'excel', ...config }),
+    httpApi: (config) => ({ adapterCode: 'httpApi', ...config }),
+    graphql: (config) => ({ adapterCode: 'graphql', ...config }),
+    vendureQuery: (config) => ({ adapterCode: 'vendureQuery', ...config }),
+    webhook: (config) => ({ adapterCode: 'webhook', ...config }),
+    database: (config) => ({ adapterCode: 'database', ...config }),
+    custom: (adapterCode, config) => ({ adapterCode, ...config }),
+};
+exports.Operators = {
+    map: (config) => ({ adapterCode: 'map', ...config }),
+    template: (config) => ({ adapterCode: 'template', ...config }),
+    filter: (config) => ({ adapterCode: 'filter', ...config }),
+    when: (config) => ({ adapterCode: 'when', ...config }),
+    lookup: (config) => ({ adapterCode: 'lookup', ...config }),
+    aggregate: (config) => ({ adapterCode: 'aggregate', ...config }),
+    dedupe: (config) => ({ adapterCode: 'dedupe', ...config }),
+    coerce: (config) => ({ adapterCode: 'coerce', ...config }),
+    enrich: (config) => ({ adapterCode: 'enrich', ...config }),
+    custom: (adapterCode, config) => ({ adapterCode, ...config }),
+};
+exports.Loaders = {
+    productUpsert: (config) => ({ adapterCode: 'productUpsert', ...config }),
+    variantUpsert: (config) => ({ adapterCode: 'variantUpsert', ...config }),
+    customerUpsert: (config) => ({ adapterCode: 'customerUpsert', ...config }),
+    stockAdjust: (config) => ({ adapterCode: 'stockAdjust', ...config }),
+    restPost: (config) => ({ adapterCode: 'restPost', ...config }),
+    orderNote: (config) => ({ adapterCode: 'orderNote', ...config }),
+    orderTransition: (config) => ({ adapterCode: 'orderTransition', ...config }),
+    collectionUpsert: (config) => ({ adapterCode: 'collectionUpsert', ...config }),
+    assetAttach: (config) => ({ adapterCode: 'assetAttach', ...config }),
+    applyCoupon: (config) => ({ adapterCode: 'applyCoupon', ...config }),
+    promotionUpsert: (config) => ({ adapterCode: 'promotionUpsert', ...config }),
+    custom: (adapterCode, config) => ({ adapterCode, ...config }),
+};
+exports.Exporters = {
+    csv: (config) => ({ adapterCode: 'csvExport', ...config }),
+    json: (config) => ({ adapterCode: 'jsonExport', ...config }),
+    xml: (config) => ({ adapterCode: 'xmlExport', ...config }),
+    custom: (adapterCode, config) => ({ adapterCode, ...config }),
+};
+exports.Feeds = {
+    googleMerchant: (config) => ({ adapterCode: 'googleMerchant', ...config }),
+    metaCatalog: (config) => ({ adapterCode: 'metaCatalog', ...config }),
+    amazon: (config) => ({ adapterCode: 'amazonFeed', ...config }),
+    customFeed: (config) => ({ adapterCode: 'customFeed', ...config }),
+    custom: (adapterCode, config) => ({ adapterCode, ...config }),
+};
+// ============================================================================
+// Capability Derivation
+// ============================================================================
+/** Adapter codes that require UpdateCatalog permission */
+const CATALOG_LOADERS = new Set([
+    'productUpsert', 'variantUpsert', 'stockAdjust', 'collectionUpsert', 'assetAttach',
+]);
+/** Adapter codes that require UpdateCustomer permission */
+const CUSTOMER_LOADERS = new Set([
+    'customerUpsert',
+]);
+/** Adapter codes that require UpdateOrder permission */
+const ORDER_LOADERS = new Set([
+    'orderNote', 'orderTransition', 'applyCoupon',
+]);
+/** Adapter codes that require UpdatePromotion permission */
+const PROMOTION_LOADERS = new Set([
+    'promotionUpsert',
+]);
+/** Adapter codes that require UpdateDataHubSettings permission */
+const DATAHUB_LOADERS = new Set([
+    'restPost',
+]);
+function getPermissionForAdapter(adapterCode) {
+    if (CATALOG_LOADERS.has(adapterCode))
+        return 'UpdateCatalog';
+    if (CUSTOMER_LOADERS.has(adapterCode))
+        return 'UpdateCustomer';
+    if (ORDER_LOADERS.has(adapterCode))
+        return 'UpdateOrder';
+    if (PROMOTION_LOADERS.has(adapterCode))
+        return 'UpdatePromotion';
+    if (DATAHUB_LOADERS.has(adapterCode))
+        return 'UpdateDataHubSettings';
+    return undefined;
+}
+function getWriteDomain(adapterCode) {
+    if (adapterCode === 'stockAdjust')
+        return 'INVENTORY';
+    if (CATALOG_LOADERS.has(adapterCode))
+        return 'CATALOG';
+    if (CUSTOMER_LOADERS.has(adapterCode))
+        return 'CUSTOMERS';
+    if (ORDER_LOADERS.has(adapterCode))
+        return 'ORDERS';
+    if (PROMOTION_LOADERS.has(adapterCode))
+        return 'PROMOTIONS';
+    if (DATAHUB_LOADERS.has(adapterCode))
+        return 'CUSTOM';
+    return undefined;
+}
+/**
+ * Derive pipeline capabilities (required permissions and write domains)
+ * from an array of typed step definitions.
+ *
+ * Inspects each step's adapter code and maps it to the required Vendure
+ * permissions and capability domains.
+ *
+ * @param steps - Array of TypedStep definitions (from the step factory functions)
+ * @returns PipelineCapabilities with `requires` and `writes` populated
+ */
+function deriveCapabilities(steps) {
+    const requires = new Set();
+    const writes = new Set();
+    for (const step of steps) {
+        const adapterCode = step.__adapterCode ??
+            (typeof step.config === 'object' && step.config !== null
+                ? step.config.adapterCode
+                : undefined);
+        if (typeof adapterCode !== 'string')
+            continue;
+        const permission = getPermissionForAdapter(adapterCode);
+        if (permission)
+            requires.add(permission);
+        const domain = getWriteDomain(adapterCode);
+        if (domain)
+            writes.add(domain);
+    }
+    return {
+        ...(requires.size > 0 ? { requires: [...requires] } : {}),
+        ...(writes.size > 0 ? { writes: [...writes] } : {}),
+    };
+}
+//# sourceMappingURL=typed-config.js.map

package/dist/src/types/typed-config.js.map

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

package/dist/src/utils/auth-helpers.d.ts

@@ -0,0 +1,14 @@
+import { ConnectionAuthType } from '../constants/index';
+import { SecretResolver as SharedSecretResolver, AuthConfig as SharedAuthConfig } from '../../shared/types';
+/**
+ * AuthConfig used by auth-helpers.
+ */
+export type AuthConfig = Omit<SharedAuthConfig, 'type'> & {
+    type: ConnectionAuthType;
+};
+type SecretResolverFn = (secretCode: string) => Promise<string | undefined>;
+/** Supports: Bearer, API key, and Basic auth. */
+export declare function applyAuthentication(headers: Record<string, string>, auth: AuthConfig | undefined, secretResolver?: SecretResolverFn): Promise<void>;
+export declare function createSecretResolver(secrets: SharedSecretResolver): SecretResolverFn;
+export {};
+//# sourceMappingURL=auth-helpers.d.ts.map

package/dist/src/utils/auth-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/auth-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA8B,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,cAAc,IAAI,oBAAoB,EAAE,UAAU,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE5G;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAEvF,KAAK,gBAAgB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAE5E,iDAAiD;AACjD,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,cAAc,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,oBAAoB,GAC9B,gBAAgB,CAElB"}

package/dist/src/utils/auth-helpers.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyAuthentication = applyAuthentication;
+exports.createSecretResolver = createSecretResolver;
+const index_1 = require("../constants/index");
+/** Supports: Bearer, API key, and Basic auth. */
+async function applyAuthentication(headers, auth, secretResolver) {
+    if (!auth || auth.type === index_1.ConnectionAuthType.NONE) {
+        return;
+    }
+    switch (auth.type) {
+        case index_1.ConnectionAuthType.BEARER: {
+            const token = auth.secretCode && secretResolver
+                ? await secretResolver(auth.secretCode)
+                : auth.token;
+            if (token) {
+                headers[index_1.HTTP_HEADERS.AUTHORIZATION] = `${index_1.AUTH_SCHEMES.BEARER} ${token}`;
+            }
+            break;
+        }
+        case index_1.ConnectionAuthType.API_KEY: {
+            const apiKey = auth.secretCode && secretResolver
+                ? await secretResolver(auth.secretCode)
+                : auth.token;
+            if (apiKey) {
+                const headerName = auth.headerName || index_1.HTTP_HEADERS.X_API_KEY;
+                headers[headerName] = apiKey;
+            }
+            break;
+        }
+        case index_1.ConnectionAuthType.BASIC: {
+            const password = auth.secretCode && secretResolver
+                ? await secretResolver(auth.secretCode)
+                : auth.password || '';
+            let username = auth.username || '';
+            if (!username && auth.usernameSecretCode && secretResolver) {
+                username = await secretResolver(auth.usernameSecretCode) || '';
+            }
+            if (username || password) {
+                const credentials = Buffer.from(`${username}:${password}`).toString('base64');
+                headers[index_1.HTTP_HEADERS.AUTHORIZATION] = `${index_1.AUTH_SCHEMES.BASIC} ${credentials}`;
+            }
+            break;
+        }
+    }
+}
+function createSecretResolver(secrets) {
+    return (secretCode) => secrets.get(secretCode);
+}
+//# sourceMappingURL=auth-helpers.js.map

package/dist/src/utils/auth-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-helpers.js","sourceRoot":"","sources":["../../../src/utils/auth-helpers.ts"],"names":[],"mappings":";;AAWA,kDAgDC;AAED,oDAIC;AAjED,8CAAoF;AAUpF,iDAAiD;AAC1C,KAAK,UAAU,mBAAmB,CACrC,OAA+B,EAC/B,IAA4B,EAC5B,cAAiC;IAEjC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,0BAAkB,CAAC,IAAI,EAAE,CAAC;QACjD,OAAO;IACX,CAAC;IAED,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,0BAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,IAAI,cAAc;gBAC3C,CAAC,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC;gBACvC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YACjB,IAAI,KAAK,EAAE,CAAC;gBACR,OAAO,CAAC,oBAAY,CAAC,aAAa,CAAC,GAAG,GAAG,oBAAY,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YAC5E,CAAC;YACD,MAAM;QACV,CAAC;QAED,KAAK,0BAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,IAAI,cAAc;gBAC5C,CAAC,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC;gBACvC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;YACjB,IAAI,MAAM,EAAE,CAAC;gBACT,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,oBAAY,CAAC,SAAS,CAAC;gBAC7D,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC;YACjC,CAAC;YACD,MAAM;QACV,CAAC;QAED,KAAK,0BAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,IAAI,cAAc;gBAC9C,CAAC,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC;gBACvC,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;YAE1B,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,kBAAkB,IAAI,cAAc,EAAE,CAAC;gBACzD,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC;YACnE,CAAC;YAED,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;gBACvB,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC9E,OAAO,CAAC,oBAAY,CAAC,aAAa,CAAC,GAAG,GAAG,oBAAY,CAAC,KAAK,IAAI,WAAW,EAAE,CAAC;YACjF,CAAC;YACD,MAAM;QACV,CAAC;IACL,CAAC;AACL,CAAC;AAED,SAAgB,oBAAoB,CAChC,OAA6B;IAE7B,OAAO,CAAC,UAAkB,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAC3D,CAAC"}

package/dist/src/utils/code-security.utils.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Code Security Utilities
+ *
+ * Security validation for user-provided code expressions.
+ * Uses defense-in-depth approach with multiple layers of protection.
+ */
+/**
+ * Security configuration for code evaluation
+ */
+export interface CodeSecurityConfig {
+    /** Maximum allowed code length in characters */
+    maxCodeLength: number;
+    /** Maximum allowed condition length in characters */
+    maxConditionLength: number;
+    /** Maximum expression complexity (nested depth + operator count) */
+    maxExpressionComplexity: number;
+    /** Maximum number of property accesses allowed */
+    maxPropertyAccessDepth: number;
+    /** Whether to allow array methods */
+    allowArrayMethods: boolean;
+    /** Whether to allow string methods */
+    allowStringMethods: boolean;
+}
+/**
+ * Default security configuration
+ */
+export declare const DEFAULT_CODE_SECURITY_CONFIG: CodeSecurityConfig;
+/**
+ * Dangerous patterns that indicate potential code injection
+ * Uses multiple regex patterns for defense in depth
+ */
+export declare const DANGEROUS_PATTERNS: {
+    /** Statement terminators and code blocks */
+    readonly STATEMENT_PATTERNS: RegExp;
+    /** Comment patterns that could hide malicious code */
+    readonly COMMENT_PATTERNS: RegExp;
+    /** Escape sequences that could bypass validation */
+    readonly ESCAPE_SEQUENCES: RegExp;
+    /** Unicode escape sequences in various forms (control characters, line/paragraph separators) */
+    readonly UNICODE_ESCAPES: RegExp;
+    /** Octal escape sequences */
+    readonly OCTAL_ESCAPES: RegExp;
+    /** HTML/XML entities that could be used for obfuscation */
+    readonly HTML_ENTITIES: RegExp;
+    /** Base64 encoded content patterns */
+    readonly BASE64_PATTERNS: RegExp;
+    /** String concatenation tricks */
+    readonly STRING_CONCAT_TRICKS: RegExp;
+    /** Bracket notation property access with computed values */
+    readonly COMPUTED_PROPERTY_ACCESS: RegExp;
+};
+/**
+ * Keywords that should never appear in user code
+ * Block list to prevent sandbox escape
+ */
+export declare const DISALLOWED_KEYWORDS: readonly ["eval", "Function", "AsyncFunction", "GeneratorFunction", "AsyncGeneratorFunction", "require", "import", "export", "module", "exports", "class", "new", "extends", "this", "self", "globalThis", "window", "document", "navigator", "location", "history", "localStorage", "sessionStorage", "indexedDB", "fetch", "XMLHttpRequest", "WebSocket", "global", "process", "Buffer", "__dirname", "__filename", "constructor", "prototype", "__proto__", "__defineGetter__", "__defineSetter__", "__lookupGetter__", "__lookupSetter__", "getPrototypeOf", "setPrototypeOf", "defineProperty", "defineProperties", "getOwnPropertyDescriptor", "getOwnPropertyDescriptors", "getOwnPropertyNames", "getOwnPropertySymbols", "Reflect", "Proxy", "arguments", "caller", "callee", "yield", "async", "await", "Promise", "with", "debugger", "setTimeout", "setInterval", "setImmediate", "clearTimeout", "clearInterval", "clearImmediate", "queueMicrotask", "Symbol", "WeakRef", "FinalizationRegistry"];
+/**
+ * Prototype pollution attack patterns
+ */
+export declare const PROTOTYPE_POLLUTION_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
+/**
+ * Validates user code for security issues
+ * Throws an error if any security concern is detected
+ */
+export declare function validateUserCode(code: string, config?: Partial<CodeSecurityConfig>): void;
+/**
+ * Validates condition expressions (more restrictive than general code)
+ */
+export declare function validateConditionExpression(condition: string, config?: Partial<CodeSecurityConfig>): void;
+/**
+ * Creates a frozen sandbox environment with safe globals
+ * All objects are deeply frozen to prevent modification
+ */
+export declare function createCodeSandbox(additionalGlobals?: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=code-security.utils.d.ts.map

package/dist/src/utils/code-security.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-security.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/code-security.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,uBAAuB,EAAE,MAAM,CAAC;IAChC,kDAAkD;IAClD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qCAAqC;IACrC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sCAAsC;IACtC,kBAAkB,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,kBAO1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC3B,4CAA4C;;IAG5C,sDAAsD;;IAGtD,oDAAoD;;IAGpD,gGAAgG;;IAIhG,6BAA6B;;IAG7B,2DAA2D;;IAG3D,sCAAsC;;IAGtC,kCAAkC;;IAGlC,4DAA4D;;CAEtD,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB,i9BAgGtB,CAAC;AAWX;;GAEG;AACH,eAAO,MAAM,4BAA4B,2GAkB/B,CAAC;AAOX;;;GAGG;AACH,wBAAgB,gBAAgB,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM,GACzC,IAAI,CA6BN;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM,GACzC,IAAI,CAuBN;AAmHD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAChD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2IzB"}