@lossless.org/client 0.1.0

package/dist_ts/objectstorage/classes.watcher.js

@@ -0,0 +1,249 @@
+// classes.watcher.ts
+import * as plugins from './plugins.js';
+import * as interfaces from './interfaces.js';
+import { EventEmitter } from 'node:events';
+/**
+ * BucketWatcher monitors a storage bucket for changes (add/modify/delete)
+ * using a polling-based approach. Designed to follow the SmartdataDbWatcher pattern.
+ *
+ * @example
+ * ```typescript
+ * const watcher = bucket.createWatcher({ prefix: 'uploads/', pollIntervalMs: 3000 });
+ *
+ * // RxJS Observable pattern
+ * watcher.changeSubject.subscribe((change) => {
+ *   console.log('Change:', change);
+ * });
+ *
+ * // EventEmitter pattern
+ * watcher.on('change', (change) => console.log(change));
+ * watcher.on('error', (err) => console.error(err));
+ *
+ * await watcher.start();
+ * await watcher.readyDeferred.promise; // Wait for initial state
+ *
+ * // Later...
+ * await watcher.stop();
+ * ```
+ */
+export class BucketWatcher extends EventEmitter {
+    /** Deferred that resolves when initial state is built and watcher is ready */
+    readyDeferred = plugins.smartpromise.defer();
+    /** Observable for receiving change events (supports RxJS operators) */
+    changeSubject;
+    // Internal subjects and state
+    rawSubject;
+    previousState;
+    pollIntervalId = null;
+    isPolling = false;
+    isStopped = false;
+    // Configuration
+    bucketRef;
+    prefix;
+    pollIntervalMs;
+    bufferTimeMs;
+    includeInitial;
+    pageSize;
+    constructor(bucketRef, options = {}) {
+        super();
+        this.bucketRef = bucketRef;
+        this.prefix = options.prefix ?? '';
+        this.pollIntervalMs = options.pollIntervalMs ?? 5000;
+        this.bufferTimeMs = options.bufferTimeMs;
+        this.includeInitial = options.includeInitial ?? false;
+        this.pageSize = options.pageSize ?? 1000;
+        // Initialize state tracking
+        this.previousState = new Map();
+        // Initialize raw subject for emitting changes
+        this.rawSubject = new plugins.smartrx.rxjs.Subject();
+        // Configure the public observable with optional buffering
+        if (this.bufferTimeMs && this.bufferTimeMs > 0) {
+            this.changeSubject = this.rawSubject.pipe(plugins.smartrx.rxjs.ops.bufferTime(this.bufferTimeMs), plugins.smartrx.rxjs.ops.filter((events) => events.length > 0));
+        }
+        else {
+            this.changeSubject = this.rawSubject.asObservable();
+        }
+    }
+    /**
+     * Start watching the bucket for changes
+     */
+    async start() {
+        if (this.pollIntervalId !== null) {
+            console.log('BucketWatcher is already running');
+            return;
+        }
+        this.isStopped = false;
+        // Build initial state
+        await this.buildInitialState();
+        // Emit initial state as 'add' events if configured
+        if (this.includeInitial) {
+            for (const state of this.previousState.values()) {
+                this.emitChange({
+                    type: 'add',
+                    key: state.key,
+                    size: state.size,
+                    etag: state.etag,
+                    lastModified: state.lastModified,
+                    bucket: this.bucketRef.name,
+                });
+            }
+        }
+        // Mark as ready
+        this.readyDeferred.resolve();
+        // Start polling loop
+        this.pollIntervalId = setInterval(() => {
+            this.poll().catch((err) => {
+                this.emit('error', err);
+            });
+        }, this.pollIntervalMs);
+    }
+    /**
+     * Stop watching the bucket
+     */
+    async stop() {
+        this.isStopped = true;
+        if (this.pollIntervalId !== null) {
+            clearInterval(this.pollIntervalId);
+            this.pollIntervalId = null;
+        }
+        // Wait for any in-progress poll to complete
+        while (this.isPolling) {
+            await new Promise((resolve) => setTimeout(resolve, 50));
+        }
+        this.rawSubject.complete();
+    }
+    /**
+     * Alias for stop() - for consistency with other APIs
+     */
+    async close() {
+        return this.stop();
+    }
+    /**
+     * Build the initial state by listing all objects with metadata
+     */
+    async buildInitialState() {
+        this.previousState.clear();
+        for await (const obj of this.listObjectsWithMetadata()) {
+            if (obj.Key) {
+                this.previousState.set(obj.Key, {
+                    key: obj.Key,
+                    etag: obj.ETag ?? '',
+                    size: obj.Size ?? 0,
+                    lastModified: obj.LastModified ?? new Date(0),
+                });
+            }
+        }
+    }
+    /**
+     * Poll for changes by comparing current state against previous state
+     */
+    async poll() {
+        // Guard against overlapping polls
+        if (this.isPolling || this.isStopped) {
+            return;
+        }
+        this.isPolling = true;
+        try {
+            // Build current state
+            const currentState = new Map();
+            for await (const obj of this.listObjectsWithMetadata()) {
+                if (this.isStopped) {
+                    break;
+                }
+                if (obj.Key) {
+                    currentState.set(obj.Key, {
+                        key: obj.Key,
+                        etag: obj.ETag ?? '',
+                        size: obj.Size ?? 0,
+                        lastModified: obj.LastModified ?? new Date(0),
+                    });
+                }
+            }
+            if (!this.isStopped) {
+                this.detectChanges(currentState);
+                this.previousState = currentState;
+            }
+        }
+        catch (err) {
+            this.emit('error', err);
+        }
+        finally {
+            this.isPolling = false;
+        }
+    }
+    /**
+     * Detect changes between current and previous state
+     */
+    detectChanges(currentState) {
+        // Detect added and modified objects
+        for (const [key, current] of currentState) {
+            const previous = this.previousState.get(key);
+            if (!previous) {
+                // New object - emit 'add' event
+                this.emitChange({
+                    type: 'add',
+                    key: current.key,
+                    size: current.size,
+                    etag: current.etag,
+                    lastModified: current.lastModified,
+                    bucket: this.bucketRef.name,
+                });
+            }
+            else if (previous.etag !== current.etag ||
+                previous.size !== current.size ||
+                previous.lastModified.getTime() !== current.lastModified.getTime()) {
+                // Object modified - emit 'modify' event
+                this.emitChange({
+                    type: 'modify',
+                    key: current.key,
+                    size: current.size,
+                    etag: current.etag,
+                    lastModified: current.lastModified,
+                    bucket: this.bucketRef.name,
+                });
+            }
+        }
+        // Detect deleted objects
+        for (const [key, previous] of this.previousState) {
+            if (!currentState.has(key)) {
+                // Object deleted - emit 'delete' event
+                this.emitChange({
+                    type: 'delete',
+                    key: previous.key,
+                    bucket: this.bucketRef.name,
+                });
+            }
+        }
+    }
+    /**
+     * Emit a change event via both RxJS Subject and EventEmitter
+     */
+    emitChange(event) {
+        this.rawSubject.next(event);
+        this.emit('change', event);
+    }
+    /**
+     * List objects with full metadata (ETag, Size, LastModified)
+     * This is a private method that yields full _Object data, not just keys
+     */
+    async *listObjectsWithMetadata() {
+        let continuationToken;
+        do {
+            if (this.isStopped) {
+                return;
+            }
+            const command = new plugins.s3.ListObjectsV2Command({
+                Bucket: this.bucketRef.name,
+                Prefix: this.prefix,
+                MaxKeys: this.pageSize,
+                ContinuationToken: continuationToken,
+            });
+            const response = await this.bucketRef.smartbucketRef.storageClient.send(command);
+            for (const obj of response.Contents || []) {
+                yield obj;
+            }
+            continuationToken = response.NextContinuationToken;
+        } while (continuationToken);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy53YXRjaGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvb2JqZWN0c3RvcmFnZS9jbGFzc2VzLndhdGNoZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEscUJBQXFCO0FBRXJCLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sS0FBSyxVQUFVLE1BQU0saUJBQWlCLENBQUM7QUFFOUMsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUUzQzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0F1Qkc7QUFDSCxNQUFNLE9BQU8sYUFBYyxTQUFRLFlBQVk7SUFDN0MsOEVBQThFO0lBQ3ZFLGFBQWEsR0FBRyxPQUFPLENBQUMsWUFBWSxDQUFDLEtBQUssRUFBRSxDQUFDO0lBRXBELHVFQUF1RTtJQUNoRSxhQUFhLENBQXFHO0lBRXpILDhCQUE4QjtJQUN0QixVQUFVLENBQStEO0lBQ3pFLGFBQWEsQ0FBOEM7SUFDM0QsY0FBYyxHQUEwQyxJQUFJLENBQUM7SUFDN0QsU0FBUyxHQUFHLEtBQUssQ0FBQztJQUNsQixTQUFTLEdBQUcsS0FBSyxDQUFDO0lBRTFCLGdCQUFnQjtJQUNDLFNBQVMsQ0FBUztJQUNsQixNQUFNLENBQVM7SUFDZixjQUFjLENBQVM7SUFDdkIsWUFBWSxDQUFVO0lBQ3RCLGNBQWMsQ0FBVTtJQUN4QixRQUFRLENBQVM7SUFFbEMsWUFBWSxTQUFpQixFQUFFLFVBQTRDLEVBQUU7UUFDM0UsS0FBSyxFQUFFLENBQUM7UUFFUixJQUFJLENBQUMsU0FBUyxHQUFHLFNBQVMsQ0FBQztRQUMzQixJQUFJLENBQUMsTUFBTSxHQUFHLE9BQU8sQ0FBQyxNQUFNLElBQUksRUFBRSxDQUFDO1FBQ25DLElBQUksQ0FBQyxjQUFjLEdBQUcsT0FBTyxDQUFDLGNBQWMsSUFBSSxJQUFJLENBQUM7UUFDckQsSUFBSSxDQUFDLFlBQVksR0FBRyxPQUFPLENBQUMsWUFBWSxDQUFD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

package/dist_ts/objectstorage/helpers.d.ts

@@ -0,0 +1,25 @@
+import * as plugins from './plugins.js';
+import * as interfaces from './interfaces.js';
+export declare const reducePathDescriptorToPath: (pathDescriptorArg: interfaces.IPathDecriptor) => Promise<string>;
+export interface IStorageWarning {
+    code: string;
+    message: string;
+}
+export interface INormalizedStorageConfig {
+    endpointUrl: string;
+    host: string;
+    protocol: 'http' | 'https';
+    port?: number;
+    region: string;
+    credentials: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+    forcePathStyle: boolean;
+}
+export declare function normalizeStorageDescriptor(input: plugins.tsclass.storage.IStorageDescriptor, logger?: {
+    warn: (msg: string) => void;
+}): {
+    normalized: INormalizedStorageConfig;
+    warnings: IStorageWarning[];
+};

package/dist_ts/objectstorage/helpers.js

@@ -0,0 +1,215 @@
+import * as plugins from './plugins.js';
+import * as interfaces from './interfaces.js';
+export const reducePathDescriptorToPath = async (pathDescriptorArg) => {
+    let returnPath = ``;
+    if (pathDescriptorArg.directory) {
+        if (pathDescriptorArg.path && plugins.path.isAbsolute(pathDescriptorArg.path)) {
+            console.warn('Directory is being ignored when path is absolute.');
+            returnPath = pathDescriptorArg.path;
+        }
+        else if (pathDescriptorArg.path) {
+            returnPath = plugins.path.join(pathDescriptorArg.directory.getBasePath(), pathDescriptorArg.path);
+        }
+    }
+    else if (pathDescriptorArg.path) {
+        returnPath = pathDescriptorArg.path;
+    }
+    else {
+        throw new Error('You must specify either a path or a directory.');
+    }
+    if (returnPath.startsWith('/')) {
+        returnPath = returnPath.substring(1);
+    }
+    return returnPath;
+};
+function coerceBooleanMaybe(value) {
+    if (typeof value === 'boolean')
+        return { value };
+    if (typeof value === 'string') {
+        const v = value.trim().toLowerCase();
+        if (v === 'true' || v === '1') {
+            return {
+                value: true,
+                warning: {
+                    code: 'SBK_S3_COERCED_USESSL',
+                    message: `Coerced useSsl='${value}' (string) to boolean true.`
+                }
+            };
+        }
+        if (v === 'false' || v === '0') {
+            return {
+                value: false,
+                warning: {
+                    code: 'SBK_S3_COERCED_USESSL',
+                    message: `Coerced useSsl='${value}' (string) to boolean false.`
+                }
+            };
+        }
+    }
+    return { value: undefined };
+}
+function coercePortMaybe(port) {
+    if (port === undefined || port === null || port === '')
+        return { value: undefined };
+    const n = typeof port === 'number' ? port : Number(String(port).trim());
+    if (!Number.isFinite(n) || !Number.isInteger(n) || n <= 0 || n > 65535) {
+        return {
+            value: undefined,
+            warning: {
+                code: 'SBK_S3_INVALID_PORT',
+                message: `Invalid port '${String(port)}' - expected integer in [1..65535].`
+            }
+        };
+    }
+    return { value: n };
+}
+function sanitizeEndpointString(raw) {
+    const warnings = [];
+    let s = String(raw ?? '').trim();
+    if (s !== String(raw ?? '')) {
+        warnings.push({
+            code: 'SBK_S3_TRIMMED_ENDPOINT',
+            message: 'Trimmed surrounding whitespace from endpoint.'
+        });
+    }
+    return { value: s, warnings };
+}
+function parseEndpointHostPort(endpoint, provisionalProtocol) {
+    let url;
+    const extras = {};
+    // Check if endpoint already has a scheme
+    const hasScheme = /^https?:\/\//i.test(endpoint);
+    // Try parsing as full URL first
+    try {
+        if (hasScheme) {
+            url = new URL(endpoint);
+        }
+        else {
+            // Not a full URL; try host[:port] by attaching provisional scheme
+            // Remove anything after first '/' for safety
+            const cleanEndpoint = endpoint.replace(/\/.*/, '');
+            url = new URL(`${provisionalProtocol}://${cleanEndpoint}`);
+        }
+    }
+    catch (e) {
+        throw new Error(`Unable to parse endpoint '${endpoint}'.`);
+    }
+    // Check for dropped components
+    if (url.username || url.password)
+        extras.droppedCreds = true;
+    if (url.pathname && url.pathname !== '/')
+        extras.droppedPath = true;
+    if (url.search)
+        extras.droppedQuery = true;
+    const hadScheme = hasScheme;
+    const host = url.hostname; // hostnames lowercased by URL; IPs preserved
+    const port = url.port ? Number(url.port) : undefined;
+    return { hadScheme, host, port, extras };
+}
+export function normalizeStorageDescriptor(input, logger) {
+    const warnings = [];
+    const logWarn = (w) => {
+        warnings.push(w);
+        if (logger) {
+            logger.warn(`[SmartBucket] ${w.code}: ${w.message}`);
+        }
+        else {
+            console.warn(`[SmartBucket] ${w.code}: ${w.message}`);
+        }
+    };
+    // Coerce and sanitize inputs
+    const { value: coercedUseSsl, warning: useSslWarn } = coerceBooleanMaybe(input.useSsl);
+    if (useSslWarn)
+        logWarn(useSslWarn);
+    const { value: coercedPort, warning: portWarn } = coercePortMaybe(input.port);
+    if (portWarn)
+        logWarn(portWarn);
+    const { value: endpointStr, warnings: endpointSanWarnings } = sanitizeEndpointString(input.endpoint);
+    endpointSanWarnings.forEach(logWarn);
+    if (!endpointStr) {
+        throw new Error('Storage endpoint is required (got empty string). Provide hostname or URL.');
+    }
+    // Provisional protocol selection for parsing host:port forms
+    const provisionalProtocol = coercedUseSsl === false ? 'http' : 'https';
+    const { hadScheme, host, port: epPort, extras } = parseEndpointHostPort(endpointStr, provisionalProtocol);
+    if (extras.droppedCreds) {
+        logWarn({
+            code: 'SBK_S3_DROPPED_CREDENTIALS',
+            message: 'Ignored credentials in endpoint URL.'
+        });
+    }
+    if (extras.droppedPath) {
+        logWarn({
+            code: 'SBK_S3_DROPPED_PATH',
+            message: 'Removed path segment from endpoint URL; S3 endpoint should be host[:port] only.'
+        });
+    }
+    if (extras.droppedQuery) {
+        logWarn({
+            code: 'SBK_S3_DROPPED_QUERY',
+            message: 'Removed query string from endpoint URL; S3 endpoint should be host[:port] only.'
+        });
+    }
+    // Final protocol decision
+    let finalProtocol;
+    if (hadScheme) {
+        // Scheme from endpoint wins
+        const schemeFromEndpoint = endpointStr.trim().toLowerCase().startsWith('http://') ? 'http' : 'https';
+        finalProtocol = schemeFromEndpoint;
+        if (typeof coercedUseSsl === 'boolean') {
+            const expected = coercedUseSsl ? 'https' : 'http';
+            if (expected !== finalProtocol) {
+                logWarn({
+                    code: 'SBK_S3_SCHEME_CONFLICT',
+                    message: `useSsl=${String(coercedUseSsl)} conflicts with endpoint scheme '${finalProtocol}'; using endpoint scheme.`
+                });
+            }
+        }
+    }
+    else {
+        if (typeof coercedUseSsl === 'boolean') {
+            finalProtocol = coercedUseSsl ? 'https' : 'http';
+        }
+        else {
+            finalProtocol = 'https';
+            logWarn({
+                code: 'SBK_S3_GUESSED_PROTOCOL',
+                message: "No scheme in endpoint and useSsl not provided; defaulting to 'https'."
+            });
+        }
+    }
+    // Final port decision
+    let finalPort = undefined;
+    if (coercedPort !== undefined && epPort !== undefined && coercedPort !== epPort) {
+        logWarn({
+            code: 'SBK_S3_PORT_CONFLICT',
+            message: `Port in config (${coercedPort}) conflicts with endpoint port (${epPort}); using config port.`
+        });
+        finalPort = coercedPort;
+    }
+    else {
+        finalPort = (coercedPort !== undefined) ? coercedPort : epPort;
+    }
+    // Build canonical endpoint URL (origin only, no trailing slash)
+    const url = new URL(`${finalProtocol}://${host}`);
+    if (finalPort !== undefined)
+        url.port = String(finalPort);
+    const endpointUrl = url.origin;
+    const region = input.region || 'us-east-1';
+    return {
+        normalized: {
+            endpointUrl,
+            host,
+            protocol: finalProtocol,
+            port: finalPort,
+            region,
+            credentials: {
+                accessKeyId: input.accessKey,
+                secretAccessKey: input.accessSecret,
+            },
+            forcePathStyle: true,
+        },
+        warnings,
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVscGVycy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL29iamVjdHN0b3JhZ2UvaGVscGVycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUN4QyxPQUFPLEtBQUssVUFBVSxNQUFNLGlCQUFpQixDQUFDO0FBRTlDLE1BQU0sQ0FBQyxNQUFNLDBCQUEwQixHQUFHLEtBQUssRUFBRSxpQkFBNEMsRUFBbUIsRUFBRTtJQUNoSCxJQUFJLFVBQVUsR0FBRyxFQUFFLENBQUE7SUFDbkIsSUFBSSxpQkFBaUIsQ0FBQyxTQUFTLEVBQUUsQ0FBQztRQUNoQyxJQUFJLGlCQUFpQixDQUFDLElBQUksSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxpQkFBaUIsQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO1lBQzlFLE9BQU8sQ0FBQyxJQUFJLENBQUMsbURBQW1ELENBQUMsQ0FBQztZQUNsRSxVQUFVLEdBQUcsaUJBQWlCLENBQUMsSUFBSSxDQUFDO1FBQ3RDLENBQUM7YUFBTSxJQUFJLGlCQUFpQixDQUFDLElBQUksRUFBRSxDQUFDO1lBQ2xDLFVBQVUsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxpQkFBaUIsQ0FBQyxTQUFTLENBQUMsV0FBVyxFQUFFLEVBQUUsaUJBQWlCLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDcEcsQ0FBQztJQUNILENBQUM7U0FBTSxJQUFJLGlCQUFpQixDQUFDLElBQUksRUFBRSxDQUFDO1FBQ2xDLFVBQVUsR0FBRyxpQkFBaUIsQ0FBQyxJQUFJLENBQUM7SUFDdEMsQ0FBQztTQUFNLENBQUM7UUFDTixNQUFNLElBQUksS0FBSyxDQUFDLGdEQUFnRCxDQUFDLENBQUM7SUFDcEUsQ0FBQztJQUNELElBQUksVUFBVSxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO1FBQy9CLFVBQVUsR0FBRyxVQUFVLENB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

package/dist_ts/objectstorage/index.d.ts

@@ -0,0 +1,13 @@
+export * from './classes.smartbucket.js';
+export * from './classes.bucket.js';
+export * from './classes.exactuploaderror.js';
+export * from './classes.exactpathpurgeerror.js';
+export * from './classes.directory.js';
+export * from './classes.file.js';
+export * from './classes.listcursor.js';
+export * from './classes.metadata.js';
+export * from './classes.trash.js';
+export * from './classes.watcher.js';
+export * from './interfaces.js';
+export { ObjectStorageConnection } from './classes.connection.js';
+export type { IObjectStorageConnectionOptions } from './classes.connection.js';

package/dist_ts/objectstorage/index.js

@@ -0,0 +1,13 @@
+export * from './classes.smartbucket.js';
+export * from './classes.bucket.js';
+export * from './classes.exactuploaderror.js';
+export * from './classes.exactpathpurgeerror.js';
+export * from './classes.directory.js';
+export * from './classes.file.js';
+export * from './classes.listcursor.js';
+export * from './classes.metadata.js';
+export * from './classes.trash.js';
+export * from './classes.watcher.js';
+export * from './interfaces.js';
+export { ObjectStorageConnection } from './classes.connection.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9vYmplY3RzdG9yYWdlL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsMEJBQTBCLENBQUM7QUFDekMsY0FBYyxxQkFBcUIsQ0FBQztBQUNwQyxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsa0NBQWtDLENBQUM7QUFDakQsY0FBYyx3QkFBd0IsQ0FBQztBQUN2QyxjQUFjLG1CQUFtQixDQUFDO0FBQ2xDLGNBQWMseUJBQXlCLENBQUM7QUFDeEMsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLG9CQUFvQixDQUFDO0FBQ25DLGNBQWMsc0JBQXNCLENBQUM7QUFDckMsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxPQUFPLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQyJ9