@ebarahona/loopback-transport-core 1.0.0

package/dist/server/server-base.js

@@ -0,0 +1,287 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerBase = void 0;
+const rxjs_1 = require("rxjs");
+const debug_1 = require("debug");
+const serializers_1 = require("../serializers");
+const utils_1 = require("../utils");
+const debug = (0, debug_1.default)('loopback:transport:server');
+const DEFAULT_HANDLER_TIMEOUT_MS = 30000;
+/**
+ * Abstract base class for transport servers.
+ *
+ * Manages the handler registry, message dispatching, and serialization.
+ * Each transport (Kafka, RabbitMQ, gRPC, MQTT, NATS) extends this
+ * class and implements listen/close/unwrap.
+ *
+ * Subclasses should:
+ * - Call deserializer.deserialize() on raw broker messages before
+ *   passing them to handleMessage()/handleEvent()
+ * - Call serializer.serialize() on outbound responses
+ * - Call setStatus('connected') in listen() when ready
+ * - Call setStatus('disconnected') in close() when stopped
+ * - Call dispose() only when the server will never be restarted
+ */
+class ServerBase {
+    constructor(options) {
+        this.messageHandlers = new Map();
+        this.statusSubject = new rxjs_1.ReplaySubject(1);
+        this.status$ = this.statusSubject.asObservable();
+        this.serializer = options?.serializer ?? new serializers_1.JsonSerializer();
+        this.deserializer = options?.deserializer ?? new serializers_1.JsonDeserializer();
+        this.handlerTimeoutMs = options?.handlerTimeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS;
+    }
+    /**
+     * Emit a status change. Called by transport adapters in listen() and close().
+     */
+    setStatus(status) {
+        this.statusSubject.next(status);
+    }
+    /**
+     * Permanently complete the status stream. After this call, no further
+     * status emissions are possible and the server instance cannot restart.
+     * Existing subscribers receive the complete notification.
+     *
+     * Call only when the server is being permanently disposed.
+     * Normal close() should call setStatus('disconnected'), NOT dispose().
+     */
+    dispose() {
+        this.statusSubject.next('disconnected');
+        this.statusSubject.complete();
+    }
+    /**
+     * Register a handler for a message pattern.
+     *
+     * For request/response handlers (@messageHandler): duplicate patterns
+     * throw an error. Only one handler per pattern is allowed.
+     *
+     * For event handlers (@eventHandler): multiple handlers on the same
+     * pattern are stored in an array and all execute.
+     *
+     * Mixing @messageHandler and @eventHandler on the same pattern throws.
+     *
+     * Handlers are never mutated. Each server owns its own handler array,
+     * so the same handler object can be safely shared across servers.
+     */
+    addHandler(pattern, handler) {
+        const normalized = this.normalizePattern(pattern);
+        const existing = this.messageHandlers.get(normalized);
+        if (existing) {
+            // Reject mixed handler types on the same pattern
+            if (existing[0].isEventHandler !== handler.isEventHandler) {
+                throw new Error(`Cannot mix @messageHandler and @eventHandler for pattern: ${normalized}. ` +
+                    'A pattern must be exclusively request/response or event, not both.');
+            }
+            // Reject duplicate request/response handlers
+            if (!handler.isEventHandler) {
+                throw new Error(`Handler already registered for pattern: ${normalized}. ` +
+                    'Only one @messageHandler per pattern is allowed. ' +
+                    'Use @eventHandler for multiple handlers on the same pattern.');
+            }
+            // Append event handler to the array
+            existing.push(handler);
+            return;
+        }
+        this.messageHandlers.set(normalized, [handler]);
+    }
+    /**
+     * Get all registered handlers. Returns a defensive copy.
+     */
+    getHandlers() {
+        const copy = new Map();
+        for (const [key, handlers] of this.messageHandlers) {
+            copy.set(key, [...handlers]);
+        }
+        return copy;
+    }
+    /**
+     * Remove all registered handlers.
+     * Called before rebinding on restart to prevent duplicate registration.
+     */
+    clearHandlers() {
+        this.messageHandlers.clear();
+    }
+    /**
+     * Get handlers by pattern. Normalizes the pattern before lookup.
+     * Returns a defensive copy for external consumers.
+     */
+    getHandlersByPattern(pattern) {
+        const handlers = this.lookupHandlers(pattern);
+        return handlers ? [...handlers] : undefined;
+    }
+    /**
+     * Internal handler lookup. Returns the live array for dispatch performance.
+     */
+    lookupHandlers(pattern) {
+        return this.messageHandlers.get(this.normalizePattern(pattern));
+    }
+    /**
+     * Handle a request/response message.
+     *
+     * Invokes the handler and calls respond() with each result value.
+     * Observable subscriptions are tracked and cleaned up on completion,
+     * error, or timeout.
+     *
+     * Returns a HandlerResult that separates response semantics from
+     * broker settlement semantics:
+     *
+     * - `success`: Handler completed normally. Ack the message.
+     * - `handler-error`: Handler threw or Observable errored. The error
+     *   response was already sent to the caller. Ack the message --
+     *   the error was handled as an application-level response.
+     * - `infrastructure-error`: No handler found or framework failure.
+     *   Nack/dead-letter the message.
+     *
+     * Observable handlers that do not complete within handlerTimeoutMs
+     * are terminated with a timeout error (handler-error).
+     *
+     * If respond() throws (adapter publication failure), the error is
+     * caught and returned as infrastructure-error.
+     */
+    async handleMessage(request, respond, context) {
+        // Wrap respond to catch adapter publication failures
+        const safeRespond = (packet) => {
+            try {
+                respond(packet);
+            }
+            catch (err) {
+                debug('respond() failed for pattern [%s]: %O', request.pattern, err);
+                throw err;
+            }
+        };
+        try {
+            return await this.executeHandler(request, safeRespond, context);
+        }
+        catch (err) {
+            return { outcome: 'infrastructure-error', error: err };
+        }
+    }
+    /**
+     * Core handler execution. Separated from handleMessage so that
+     * respond() failures bubble up and are caught by the outer wrapper.
+     */
+    async executeHandler(request, respond, context) {
+        const handlers = this.lookupHandlers(request.pattern);
+        if (!handlers || handlers.length === 0) {
+            const err = `No handler for pattern: ${request.pattern}`;
+            respond({ err: this.serializeError(err), isDisposed: true });
+            return { outcome: 'infrastructure-error', error: new Error(err) };
+        }
+        const handler = handlers[0];
+        let result;
+        try {
+            result = await handler(request.data, context);
+        }
+        catch (err) {
+            respond({ err: this.serializeError(err), isDisposed: true });
+            return { outcome: 'handler-error', error: err };
+        }
+        if ((0, rxjs_1.isObservable)(result)) {
+            const obs = result.pipe((0, rxjs_1.timeout)(this.handlerTimeoutMs));
+            return new Promise((resolve) => {
+                let settled = false;
+                const settle = (result) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    subscription?.unsubscribe();
+                    resolve(result);
+                };
+                let subscription;
+                subscription = obs.subscribe({
+                    next: value => {
+                        if (settled)
+                            return;
+                        try {
+                            respond({ response: value });
+                        }
+                        catch (respondErr) {
+                            settle({ outcome: 'infrastructure-error', error: respondErr });
+                        }
+                    },
+                    error: err => {
+                        if (settled)
+                            return;
+                        if (err instanceof rxjs_1.TimeoutError) {
+                            debug('handler timeout after %dms for pattern [%s]', this.handlerTimeoutMs, request.pattern);
+                        }
+                        try {
+                            respond({ err: this.serializeError(err), isDisposed: true });
+                        }
+                        catch (respondErr) {
+                            settle({ outcome: 'infrastructure-error', error: respondErr });
+                            return;
+                        }
+                        settle({ outcome: 'handler-error', error: err });
+                    },
+                    complete: () => {
+                        if (settled)
+                            return;
+                        try {
+                            respond({ isDisposed: true });
+                        }
+                        catch (respondErr) {
+                            settle({ outcome: 'infrastructure-error', error: respondErr });
+                            return;
+                        }
+                        settle({ outcome: 'success' });
+                    },
+                });
+            });
+        }
+        respond({ response: result, isDisposed: true });
+        return { outcome: 'success' };
+    }
+    /**
+     * Handle a fire-and-forget event.
+     *
+     * Invokes all chained handlers for the pattern.
+     * Errors are logged but not propagated (fire-and-forget semantics).
+     *
+     * Observable event handlers that do not complete within handlerTimeoutMs
+     * are terminated and logged.
+     */
+    async handleEvent(event, context) {
+        const handlers = this.lookupHandlers(event.pattern);
+        if (!handlers || handlers.length === 0)
+            return;
+        for (const handler of handlers) {
+            try {
+                const result = await handler(event.data, context);
+                if ((0, rxjs_1.isObservable)(result)) {
+                    const obs = result.pipe((0, rxjs_1.timeout)(this.handlerTimeoutMs));
+                    await (0, rxjs_1.lastValueFrom)(obs, { defaultValue: undefined });
+                }
+            }
+            catch (err) {
+                if (err instanceof rxjs_1.TimeoutError) {
+                    debug('event handler timeout after %dms for pattern [%s]', this.handlerTimeoutMs, event.pattern);
+                }
+                else {
+                    debug('event handler failed for pattern [%s]: %O', event.pattern, err);
+                }
+            }
+        }
+    }
+    /**
+     * Normalize a pattern to a consistent string key.
+     * Delegates to the shared normalizePattern utility.
+     */
+    normalizePattern(pattern) {
+        return (0, utils_1.normalizePattern)(pattern);
+    }
+    /**
+     * Serialize an error to a string for transport.
+     */
+    serializeError(err) {
+        if (err instanceof rxjs_1.TimeoutError)
+            return 'Handler timeout';
+        if (err instanceof Error)
+            return `${err.name}: ${err.message}`;
+        if (typeof err === 'string')
+            return err;
+        return String(err);
+    }
+}
+exports.ServerBase = ServerBase;
+//# sourceMappingURL=server-base.js.map

package/dist/server/server-base.js.map

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

package/dist/transport-booter.d.ts

@@ -0,0 +1,31 @@
+import { Application, LifeCycleObserver } from '@loopback/core';
+import { HandlerRegistry } from './registry';
+/**
+ * Lifecycle observer that discovers transport handlers after boot
+ * and starts/stops transport servers.
+ *
+ * Runs after all controllers are registered (boot phase complete).
+ * Scans controllers for @messageHandler/@eventHandler metadata,
+ * registers handlers with transport servers, then starts listeners.
+ *
+ * Startup behavior: sequential with deterministic rollback.
+ * Servers start one at a time. If any fails, all previously started
+ * servers are rolled back. No race between concurrent starts.
+ *
+ * Shutdown behavior: best-effort parallel. All servers stop concurrently.
+ * Individual errors are logged but don't prevent other servers from stopping.
+ *
+ * Restart safety: servers are cleared of handlers before rebinding
+ * to prevent duplicate registration on stop/start cycles.
+ */
+export declare class TransportBooter implements LifeCycleObserver {
+    private app;
+    private registry;
+    constructor(app: Application, registry: HandlerRegistry);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Resolve all registered transport servers with their names.
+     */
+    private getServerEntries;
+}

package/dist/transport-booter.js

@@ -0,0 +1,117 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransportBooter = void 0;
+const core_1 = require("@loopback/core");
+const debug_1 = require("debug");
+const registry_1 = require("./registry");
+const keys_1 = require("./keys");
+const debug = (0, debug_1.default)('loopback:transport:booter');
+/**
+ * Lifecycle observer that discovers transport handlers after boot
+ * and starts/stops transport servers.
+ *
+ * Runs after all controllers are registered (boot phase complete).
+ * Scans controllers for @messageHandler/@eventHandler metadata,
+ * registers handlers with transport servers, then starts listeners.
+ *
+ * Startup behavior: sequential with deterministic rollback.
+ * Servers start one at a time. If any fails, all previously started
+ * servers are rolled back. No race between concurrent starts.
+ *
+ * Shutdown behavior: best-effort parallel. All servers stop concurrently.
+ * Individual errors are logged but don't prevent other servers from stopping.
+ *
+ * Restart safety: servers are cleared of handlers before rebinding
+ * to prevent duplicate registration on stop/start cycles.
+ */
+let TransportBooter = class TransportBooter {
+    constructor(app, registry) {
+        this.app = app;
+        this.registry = registry;
+    }
+    async start() {
+        debug('transport booter starting');
+        // Discover handlers from controllers (idempotent: clears first)
+        await this.registry.discoverHandlers(this.app);
+        // Clear existing handlers from servers before rebinding
+        const entries = await this.getServerEntries();
+        for (const { server } of entries) {
+            server.clearHandlers();
+        }
+        // Bind handlers to transport servers
+        await this.registry.bindToServers(this.app);
+        // Start servers sequentially for deterministic rollback
+        const started = [];
+        try {
+            for (const { name, server } of entries) {
+                await server.listen();
+                started.push({ name, server });
+                debug('transport server [%s] started', name);
+            }
+        }
+        catch (err) {
+            debug('startup failed, rolling back %d started servers', started.length);
+            for (const { name, server } of started.reverse()) {
+                try {
+                    await server.close();
+                    debug('transport server [%s] rolled back', name);
+                }
+                catch (closeErr) {
+                    debug('transport server [%s] rollback failed: %O', name, closeErr);
+                }
+            }
+            throw err;
+        }
+        debug('transport booter started (%d handlers, %d servers)', this.registry.getHandlers().size, entries.length);
+    }
+    async stop() {
+        debug('transport booter stopping');
+        const entries = await this.getServerEntries();
+        const results = await Promise.allSettled(entries.map(async ({ name, server }) => {
+            await server.close();
+            debug('transport server [%s] stopped', name);
+        }));
+        const failures = results.filter((r) => r.status === 'rejected');
+        if (failures.length > 0) {
+            debug('%d transport server(s) failed to stop cleanly', failures.length);
+            for (const failure of failures) {
+                debug('transport server shutdown failure: %O', failure.reason);
+            }
+        }
+        debug('transport booter stopped');
+    }
+    /**
+     * Resolve all registered transport servers with their names.
+     */
+    async getServerEntries() {
+        const bindings = this.app.findByTag(keys_1.TRANSPORT_SERVER_TAG);
+        const entries = [];
+        for (const binding of bindings) {
+            const server = await this.app.get(binding.key);
+            const name = String(binding.tagMap?.[keys_1.TRANSPORT_NAME_TAG] ?? binding.key);
+            entries.push({ name, server });
+        }
+        return entries;
+    }
+};
+exports.TransportBooter = TransportBooter;
+exports.TransportBooter = TransportBooter = __decorate([
+    (0, core_1.lifeCycleObserver)('transport'),
+    __param(0, (0, core_1.inject)(core_1.CoreBindings.APPLICATION_INSTANCE)),
+    __param(1, (0, core_1.inject)(keys_1.TransportBindings.HANDLER_REGISTRY)),
+    __metadata("design:paramtypes", [core_1.Application,
+        registry_1.HandlerRegistry])
+], TransportBooter);
+//# sourceMappingURL=transport-booter.js.map

package/dist/transport-booter.js.map

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

package/dist/transport.component.d.ts

@@ -0,0 +1,26 @@
+import { Binding, Component, Constructor, LifeCycleObserver } from '@loopback/core';
+/**
+ * LoopBack 4 component that enables transport-agnostic microservices.
+ *
+ * Registers the core transport extension points:
+ * - HandlerRegistry (singleton): discovers and manages transport handlers
+ * - TransportBooter (lifecycle observer): wires handlers to servers at boot
+ *
+ * The component intentionally stays thin. Discovery, validation,
+ * server binding, and listener lifecycle management live in the
+ * TransportBooter/HandlerRegistry layer so the component remains a
+ * stable package boundary for transport adapters.
+ *
+ * Usage:
+ * ```typescript
+ * const app = new Application();
+ * app.component(TransportComponent);
+ * ```
+ *
+ * Transport adapters can build on top of this component by contributing
+ * server bindings and configuration under TransportBindings.
+ */
+export declare class TransportComponent implements Component {
+    readonly bindings: Binding<unknown>[];
+    readonly lifeCycleObservers: Constructor<LifeCycleObserver>[];
+}

package/dist/transport.component.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransportComponent = void 0;
+const core_1 = require("@loopback/core");
+const keys_1 = require("./keys");
+const registry_1 = require("./registry");
+const transport_booter_1 = require("./transport-booter");
+/**
+ * LoopBack 4 component that enables transport-agnostic microservices.
+ *
+ * Registers the core transport extension points:
+ * - HandlerRegistry (singleton): discovers and manages transport handlers
+ * - TransportBooter (lifecycle observer): wires handlers to servers at boot
+ *
+ * The component intentionally stays thin. Discovery, validation,
+ * server binding, and listener lifecycle management live in the
+ * TransportBooter/HandlerRegistry layer so the component remains a
+ * stable package boundary for transport adapters.
+ *
+ * Usage:
+ * ```typescript
+ * const app = new Application();
+ * app.component(TransportComponent);
+ * ```
+ *
+ * Transport adapters can build on top of this component by contributing
+ * server bindings and configuration under TransportBindings.
+ */
+class TransportComponent {
+    constructor() {
+        this.bindings = [
+            core_1.Binding.bind(keys_1.TransportBindings.HANDLER_REGISTRY)
+                .toClass(registry_1.HandlerRegistry)
+                .inScope(core_1.BindingScope.SINGLETON),
+        ];
+        this.lifeCycleObservers = [
+            transport_booter_1.TransportBooter,
+        ];
+    }
+}
+exports.TransportComponent = TransportComponent;
+//# sourceMappingURL=transport.component.js.map

package/dist/transport.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.component.js","sourceRoot":"","sources":["../src/transport.component.ts"],"names":[],"mappings":";;;AAAA,yCAMwB;AACxB,iCAAyC;AACzC,yCAA2C;AAC3C,yDAAmD;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAa,kBAAkB;IAA/B;QACW,aAAQ,GAAuB;YACtC,cAAO,CAAC,IAAI,CAAC,wBAAiB,CAAC,gBAAgB,CAAC;iBAC7C,OAAO,CAAC,0BAAe,CAAC;iBACxB,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC;SACnC,CAAC;QAEO,uBAAkB,GAAqC;YAC9D,kCAAe;SAChB,CAAC;IACJ,CAAC;CAAA;AAVD,gDAUC"}

package/dist/utils/index.d.ts

@@ -0,0 +1 @@
+export { normalizePattern } from './normalize-pattern';

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePattern = void 0;
+var normalize_pattern_1 = require("./normalize-pattern");
+Object.defineProperty(exports, "normalizePattern", { enumerable: true, get: function () { return normalize_pattern_1.normalizePattern; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,yDAAqD;AAA7C,qHAAA,gBAAgB,OAAA"}

package/dist/utils/normalize-pattern.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Normalize a pattern to a consistent string key.
+ *
+ * Strings pass through as-is. Objects are deep-sorted by key
+ * and JSON-stringified for consistent lookup regardless of
+ * property insertion order.
+ *
+ * Only JSON-compatible values are accepted: strings, finite numbers,
+ * booleans, null, plain objects, and arrays. Non-JSON values
+ * (undefined, functions, symbols, NaN, Infinity, BigInt, Date,
+ * RegExp, Map, Set, class instances) are rejected deterministically.
+ *
+ * Shared (non-circular) object references are allowed. Only true
+ * cycles throw.
+ *
+ * @throws Error on circular references, non-JSON values, or non-plain objects.
+ */
+export declare function normalizePattern(pattern: string | Record<string, unknown>): string;

package/dist/utils/normalize-pattern.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePattern = void 0;
+/**
+ * Normalize a pattern to a consistent string key.
+ *
+ * Strings pass through as-is. Objects are deep-sorted by key
+ * and JSON-stringified for consistent lookup regardless of
+ * property insertion order.
+ *
+ * Only JSON-compatible values are accepted: strings, finite numbers,
+ * booleans, null, plain objects, and arrays. Non-JSON values
+ * (undefined, functions, symbols, NaN, Infinity, BigInt, Date,
+ * RegExp, Map, Set, class instances) are rejected deterministically.
+ *
+ * Shared (non-circular) object references are allowed. Only true
+ * cycles throw.
+ *
+ * @throws Error on circular references, non-JSON values, or non-plain objects.
+ */
+function normalizePattern(pattern) {
+    if (typeof pattern === 'string')
+        return pattern;
+    return stableStringify(pattern, new Set());
+}
+exports.normalizePattern = normalizePattern;
+function isPlainObject(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const proto = Object.getPrototypeOf(obj);
+    return proto === Object.prototype || proto === null;
+}
+function stableStringify(obj, seen) {
+    if (obj === null)
+        return 'null';
+    const type = typeof obj;
+    if (type === 'string' || type === 'boolean') {
+        return JSON.stringify(obj);
+    }
+    if (type === 'number') {
+        const n = obj;
+        if (!Number.isFinite(n)) {
+            throw new Error(`Pattern contains ${String(n)}, which is not JSON-serializable`);
+        }
+        return JSON.stringify(n);
+    }
+    if (type === 'undefined' ||
+        type === 'function' ||
+        type === 'symbol' ||
+        type === 'bigint') {
+        throw new Error(`Pattern contains ${type} value, which is not JSON-serializable`);
+    }
+    // At this point, type === 'object' and obj !== null
+    const o = obj;
+    if (seen.has(o)) {
+        throw new Error('Circular reference detected in pattern object');
+    }
+    if (Array.isArray(o)) {
+        seen.add(o);
+        const result = '[' + o.map(item => stableStringify(item, seen)).join(',') + ']';
+        seen.delete(o);
+        return result;
+    }
+    if (!isPlainObject(o)) {
+        const name = o.constructor?.name ?? 'unknown';
+        throw new Error(`Pattern contains ${name} instance, which is not a plain object`);
+    }
+    seen.add(o);
+    const keys = Object.keys(o).sort();
+    const pairs = keys.map(key => `${JSON.stringify(key)}:${stableStringify(o[key], seen)}`);
+    const result = '{' + pairs.join(',') + '}';
+    seen.delete(o);
+    return result;
+}
+//# sourceMappingURL=normalize-pattern.js.map

package/dist/utils/normalize-pattern.js.map

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