@classytic/arc 1.1.0 → 2.1.2

package/dist/plugins/tracing-entry.mjs

@@ -0,0 +1,186 @@
+import { createRequire } from "node:module";
+import fp from "fastify-plugin";
+
+//#region src/plugins/tracing.ts
+const require = createRequire(import.meta.url);
+let trace;
+let context;
+let SpanStatusCode;
+let NodeTracerProvider;
+let BatchSpanProcessor;
+let OTLPTraceExporter;
+let getNodeAutoInstrumentations;
+let isAvailable = false;
+try {
+	const api = require("@opentelemetry/api");
+	trace = api.trace;
+	context = api.context;
+	SpanStatusCode = api.SpanStatusCode;
+	const sdkNode = require("@opentelemetry/sdk-node");
+	NodeTracerProvider = sdkNode.NodeTracerProvider;
+	BatchSpanProcessor = sdkNode.BatchSpanProcessor;
+	OTLPTraceExporter = require("@opentelemetry/exporter-trace-otlp-http").OTLPTraceExporter;
+	require("@opentelemetry/instrumentation-http").HttpInstrumentation;
+	require("@opentelemetry/instrumentation-mongodb").MongoDBInstrumentation;
+	getNodeAutoInstrumentations = require("@opentelemetry/auto-instrumentations-node").getNodeAutoInstrumentations;
+	isAvailable = true;
+} catch (e) {}
+/**
+* Create a tracer provider
+*/
+function createTracerProvider(options) {
+	if (!isAvailable) return null;
+	const { serviceName = "@classytic/arc", exporterUrl = "http://localhost:4318/v1/traces" } = options;
+	const exporter = new OTLPTraceExporter({ url: exporterUrl });
+	const provider = new NodeTracerProvider({ resource: { attributes: {
+		"service.name": serviceName,
+		"service.version": "1.0.0"
+	} } });
+	provider.addSpanProcessor(new BatchSpanProcessor(exporter));
+	provider.register();
+	return provider;
+}
+/**
+* OpenTelemetry Distributed Tracing Plugin
+*/
+async function tracingPlugin(fastify, options = {}) {
+	const { serviceName = "@classytic/arc", autoInstrumentation = true, sampleRate = 1 } = options;
+	if (!isAvailable) {
+		fastify.log.warn("OpenTelemetry not installed. Tracing disabled.");
+		fastify.log.warn("Install: npm install @opentelemetry/api @opentelemetry/sdk-node");
+		return;
+	}
+	if (!createTracerProvider(options)) return;
+	if (autoInstrumentation && getNodeAutoInstrumentations) {
+		const instrumentations = getNodeAutoInstrumentations({
+			"@opentelemetry/instrumentation-http": { enabled: true },
+			"@opentelemetry/instrumentation-mongodb": { enabled: true }
+		});
+		for (const instrumentation of instrumentations) instrumentation.enable();
+		fastify.log.debug("OpenTelemetry auto-instrumentation enabled");
+	}
+	const tracer = trace.getTracer(serviceName);
+	fastify.decorateRequest("tracer", void 0);
+	fastify.addHook("onRequest", async (request, reply) => {
+		if (Math.random() > sampleRate) return;
+		const span = tracer.startSpan(`HTTP ${request.method} ${request.url}`, {
+			kind: 1,
+			attributes: {
+				"http.method": request.method,
+				"http.url": request.url,
+				"http.target": request.routeOptions?.url ?? request.url,
+				"http.host": request.hostname,
+				"http.scheme": request.protocol,
+				"http.user_agent": request.headers["user-agent"]
+			}
+		});
+		request.tracer = {
+			tracer,
+			currentSpan: span
+		};
+		context.with(trace.setSpan(context.active(), span), () => {});
+	});
+	fastify.addHook("onResponse", async (request, reply) => {
+		if (!request.tracer?.currentSpan) return;
+		const span = request.tracer.currentSpan;
+		span.setAttributes({
+			"http.status_code": reply.statusCode,
+			"http.response_content_length": reply.getHeader("content-length")
+		});
+		if (reply.statusCode >= 500) span.setStatus({
+			code: SpanStatusCode.ERROR,
+			message: `HTTP ${reply.statusCode}`
+		});
+		else span.setStatus({ code: SpanStatusCode.OK });
+		span.end();
+	});
+	fastify.addHook("onError", async (request, reply, error) => {
+		if (!request.tracer?.currentSpan) return;
+		const span = request.tracer.currentSpan;
+		span.recordException(error);
+		span.setStatus({
+			code: SpanStatusCode.ERROR,
+			message: error.message
+		});
+	});
+	fastify.log.debug({ serviceName }, "OpenTelemetry tracing enabled");
+}
+/**
+* Utility to create custom spans in your code
+*
+* @example
+* import { createSpan } from '@classytic/arc/plugins';
+*
+* async function expensiveOperation(req) {
+*   return createSpan(req, 'expensiveOperation', async (span) => {
+*     span.setAttribute('custom.attribute', 'value');
+*     return await doWork();
+*   });
+* }
+*/
+function createSpan(request, name, fn, attributes) {
+	if (!isAvailable || !request.tracer) return fn(null);
+	const { tracer, currentSpan } = request.tracer;
+	const span = tracer.startSpan(name, {
+		parent: currentSpan,
+		attributes: attributes || {}
+	}, trace.setSpan(context.active(), currentSpan));
+	return context.with(trace.setSpan(context.active(), span), async () => {
+		try {
+			const result = await fn(span);
+			span.setStatus({ code: SpanStatusCode.OK });
+			return result;
+		} catch (error) {
+			span.recordException(error);
+			span.setStatus({
+				code: SpanStatusCode.ERROR,
+				message: error.message
+			});
+			throw error;
+		} finally {
+			span.end();
+		}
+	});
+}
+/**
+* Decorator to automatically trace repository methods
+*
+* @example
+* class ProductRepository extends Repository {
+*   @traced()
+*   async findActive() {
+*     return this.findAll({ filter: { isActive: true } });
+*   }
+* }
+*/
+function traced(spanName) {
+	return function(target, propertyKey, descriptor) {
+		const originalMethod = descriptor.value;
+		descriptor.value = async function(...args) {
+			const request = args.find((arg) => arg && arg.tracer);
+			if (!request?.tracer) return originalMethod.apply(this, args);
+			return createSpan(request, spanName || `${target.constructor.name}.${propertyKey}`, async (span) => {
+				if (span) {
+					span.setAttribute("db.operation", propertyKey);
+					span.setAttribute("db.system", "mongodb");
+				}
+				return originalMethod.apply(this, args);
+			});
+		};
+		return descriptor;
+	};
+}
+/**
+* Check if OpenTelemetry is available
+*/
+function isTracingAvailable() {
+	return isAvailable;
+}
+var tracing_default = fp(tracingPlugin, {
+	name: "arc-tracing",
+	fastify: "5.x"
+});
+
+//#endregion
+export { createSpan, isTracingAvailable, traced, tracing_default as tracingPlugin };
+//# sourceMappingURL=tracing-entry.mjs.map

package/dist/plugins/tracing-entry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-entry.mjs","names":[],"sources":["../../src/plugins/tracing.ts"],"sourcesContent":["/**\n * OpenTelemetry Distributed Tracing Plugin\n *\n * Traces HTTP requests, repository operations, and MongoDB queries\n * across the entire application lifecycle.\n *\n * @example\n * import { tracingPlugin } from '@classytic/arc/plugins';\n *\n * await fastify.register(tracingPlugin, {\n *   serviceName: 'my-api',\n *   exporterUrl: 'http://localhost:4318/v1/traces', // OTLP endpoint\n * });\n */\n\nimport type { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';\nimport fp from 'fastify-plugin';\nimport { createRequire } from 'node:module';\n\nconst require = createRequire(import.meta.url);\n\n// OpenTelemetry imports (peer dependencies)\nlet trace: any;\nlet context: any;\nlet SpanStatusCode: any;\nlet NodeTracerProvider: any;\nlet BatchSpanProcessor: any;\nlet OTLPTraceExporter: any;\nlet HttpInstrumentation: any;\nlet MongoDBInstrumentation: any;\nlet getNodeAutoInstrumentations: any;\n\n// Try to load OpenTelemetry (optional peer dependency)\nlet isAvailable = false;\ntry {\n  const api = require('@opentelemetry/api');\n  trace = api.trace;\n  context = api.context;\n  SpanStatusCode = api.SpanStatusCode;\n\n  const sdkNode = require('@opentelemetry/sdk-node');\n  NodeTracerProvider = sdkNode.NodeTracerProvider;\n  BatchSpanProcessor = sdkNode.BatchSpanProcessor;\n\n  const exporterTraceOtlp = require('@opentelemetry/exporter-trace-otlp-http');\n  OTLPTraceExporter = exporterTraceOtlp.OTLPTraceExporter;\n\n  const instrHttp = require('@opentelemetry/instrumentation-http');\n  HttpInstrumentation = instrHttp.HttpInstrumentation;\n\n  const instrMongo = require('@opentelemetry/instrumentation-mongodb');\n  MongoDBInstrumentation = instrMongo.MongoDBInstrumentation;\n\n  const autoInstr = require('@opentelemetry/auto-instrumentations-node');\n  getNodeAutoInstrumentations = autoInstr.getNodeAutoInstrumentations;\n\n  isAvailable = true;\n} catch (e) {\n  // OpenTelemetry not installed - plugin will be no-op\n}\n\nexport interface TracingOptions {\n  /**\n   * Service name for traces\n   */\n  serviceName?: string;\n\n  /**\n   * OTLP exporter endpoint URL\n   * @default 'http://localhost:4318/v1/traces'\n   */\n  exporterUrl?: string;\n\n  /**\n   * Enable auto-instrumentation for HTTP, MongoDB, etc.\n   * @default true\n   */\n  autoInstrumentation?: boolean;\n\n  /**\n   * Sample rate (0.0 to 1.0)\n   * @default 1.0 (trace everything)\n   */\n  sampleRate?: number;\n}\n\ninterface TracerContext {\n  tracer: any;\n  currentSpan: any;\n}\n\ndeclare module 'fastify' {\n  interface FastifyRequest {\n    tracer?: TracerContext;\n  }\n}\n\n/**\n * Create a tracer provider\n */\nfunction createTracerProvider(options: TracingOptions) {\n  if (!isAvailable) {\n    return null;\n  }\n\n  const { serviceName = '@classytic/arc', exporterUrl = 'http://localhost:4318/v1/traces' } =\n    options;\n\n  const exporter = new OTLPTraceExporter({\n    url: exporterUrl,\n  });\n\n  const provider = new NodeTracerProvider({\n    resource: {\n      attributes: {\n        'service.name': serviceName,\n        'service.version': '1.0.0',\n      },\n    },\n  });\n\n  provider.addSpanProcessor(new BatchSpanProcessor(exporter));\n  provider.register();\n\n  return provider;\n}\n\n/**\n * OpenTelemetry Distributed Tracing Plugin\n */\nasync function tracingPlugin(fastify: FastifyInstance, options: TracingOptions = {}) {\n  const {\n    serviceName = '@classytic/arc',\n    autoInstrumentation = true,\n    sampleRate = 1.0,\n  } = options;\n\n  // Skip if OpenTelemetry is not available\n  if (!isAvailable) {\n    fastify.log.warn('OpenTelemetry not installed. Tracing disabled.');\n    fastify.log.warn('Install: npm install @opentelemetry/api @opentelemetry/sdk-node');\n    return;\n  }\n\n  // Initialize tracer provider\n  const provider = createTracerProvider(options);\n  if (!provider) {\n    return;\n  }\n\n  // Auto-instrumentation — enable HTTP + MongoDB tracing\n  if (autoInstrumentation && getNodeAutoInstrumentations) {\n    const instrumentations = getNodeAutoInstrumentations({\n      '@opentelemetry/instrumentation-http': {\n        enabled: true,\n      },\n      '@opentelemetry/instrumentation-mongodb': {\n        enabled: true,\n      },\n    });\n    for (const instrumentation of instrumentations) {\n      instrumentation.enable();\n    }\n    fastify.log.debug('OpenTelemetry auto-instrumentation enabled');\n  }\n\n  const tracer = trace.getTracer(serviceName);\n\n  // Add tracer to request\n  fastify.decorateRequest('tracer', undefined);\n\n  // Create span for each HTTP request\n  fastify.addHook('onRequest', async (request: FastifyRequest, reply: FastifyReply) => {\n    // Sampling\n    if (Math.random() > sampleRate) {\n      return;\n    }\n\n    const span = tracer.startSpan(`HTTP ${request.method} ${request.url}`, {\n      kind: 1, // SpanKind.SERVER\n      attributes: {\n        'http.method': request.method,\n        'http.url': request.url,\n        'http.target': request.routeOptions?.url ?? request.url,\n        'http.host': request.hostname,\n        'http.scheme': request.protocol,\n        'http.user_agent': request.headers['user-agent'],\n      },\n    });\n\n    // Store span in request for child spans\n    request.tracer = {\n      tracer,\n      currentSpan: span,\n    };\n\n    // Set active context\n    context.with(trace.setSpan(context.active(), span), () => {\n      // Context is now active for this request\n    });\n  });\n\n  // End span after response\n  fastify.addHook('onResponse', async (request: FastifyRequest, reply: FastifyReply) => {\n    if (!request.tracer?.currentSpan) {\n      return;\n    }\n\n    const span = request.tracer.currentSpan;\n\n    // Add response attributes\n    span.setAttributes({\n      'http.status_code': reply.statusCode,\n      'http.response_content_length': reply.getHeader('content-length'),\n    });\n\n    // Set span status\n    if (reply.statusCode >= 500) {\n      span.setStatus({\n        code: SpanStatusCode.ERROR,\n        message: `HTTP ${reply.statusCode}`,\n      });\n    } else {\n      span.setStatus({ code: SpanStatusCode.OK });\n    }\n\n    span.end();\n  });\n\n  // Error tracking\n  fastify.addHook('onError', async (request: FastifyRequest, reply: FastifyReply, error: Error) => {\n    if (!request.tracer?.currentSpan) {\n      return;\n    }\n\n    const span = request.tracer.currentSpan;\n    span.recordException(error);\n    span.setStatus({\n      code: SpanStatusCode.ERROR,\n      message: error.message,\n    });\n  });\n\n  fastify.log.debug({ serviceName }, 'OpenTelemetry tracing enabled');\n}\n\n/**\n * Utility to create custom spans in your code\n *\n * @example\n * import { createSpan } from '@classytic/arc/plugins';\n *\n * async function expensiveOperation(req) {\n *   return createSpan(req, 'expensiveOperation', async (span) => {\n *     span.setAttribute('custom.attribute', 'value');\n *     return await doWork();\n *   });\n * }\n */\nexport function createSpan<T>(\n  request: FastifyRequest,\n  name: string,\n  fn: (span: any) => Promise<T>,\n  attributes?: Record<string, any>\n): Promise<T> {\n  if (!isAvailable || !request.tracer) {\n    // No tracing available, just execute function\n    return fn(null);\n  }\n\n  const { tracer, currentSpan } = request.tracer;\n\n  const span = tracer.startSpan(\n    name,\n    {\n      parent: currentSpan,\n      attributes: attributes || {},\n    },\n    trace.setSpan(context.active(), currentSpan)\n  );\n\n  return context.with(trace.setSpan(context.active(), span), async () => {\n    try {\n      const result = await fn(span);\n      span.setStatus({ code: SpanStatusCode.OK });\n      return result;\n    } catch (error: any) {\n      span.recordException(error);\n      span.setStatus({\n        code: SpanStatusCode.ERROR,\n        message: error.message,\n      });\n      throw error;\n    } finally {\n      span.end();\n    }\n  });\n}\n\n/**\n * Decorator to automatically trace repository methods\n *\n * @example\n * class ProductRepository extends Repository {\n *   @traced()\n *   async findActive() {\n *     return this.findAll({ filter: { isActive: true } });\n *   }\n * }\n */\nexport function traced(spanName?: string) {\n  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {\n    const originalMethod = descriptor.value;\n\n    descriptor.value = async function (this: any, ...args: any[]) {\n      // Extract request from args if available\n      const request = args.find((arg) => arg && arg.tracer);\n\n      if (!request?.tracer) {\n        // No tracing context, just execute\n        return originalMethod.apply(this, args);\n      }\n\n      const name = spanName || `${target.constructor.name}.${propertyKey}`;\n      return createSpan(request, name, async (span) => {\n        if (span) {\n          span.setAttribute('db.operation', propertyKey);\n          span.setAttribute('db.system', 'mongodb');\n        }\n        return originalMethod.apply(this, args);\n      });\n    };\n\n    return descriptor;\n  };\n}\n\n/**\n * Check if OpenTelemetry is available\n */\nexport function isTracingAvailable(): boolean {\n  return isAvailable;\n}\n\nexport default fp(tracingPlugin, {\n  name: 'arc-tracing',\n  fastify: '5.x',\n});\n"],"mappings":"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"}

package/dist/pluralize-CEweyOEm.mjs

@@ -0,0 +1,87 @@
+//#region src/cli/utils/pluralize.ts
+/**
+* Lightweight English pluralization for the Arc CLI.
+*
+* Covers the common cases developers hit when naming resources:
+*   company  → companies
+*   category → categories
+*   status   → statuses
+*   address  → addresses
+*   person   → people
+*   child    → children
+*   bus      → buses
+*   box      → boxes
+*   quiz     → quizzes
+*   leaf     → leaves
+*   wolf     → wolves
+*
+* No external dependencies — designed to keep the CLI install-free.
+*/
+const IRREGULARS = {
+	person: "people",
+	child: "children",
+	man: "men",
+	woman: "women",
+	mouse: "mice",
+	goose: "geese",
+	tooth: "teeth",
+	foot: "feet",
+	ox: "oxen",
+	datum: "data",
+	medium: "media",
+	index: "indices",
+	matrix: "matrices",
+	vertex: "vertices",
+	criterion: "criteria"
+};
+const UNCOUNTABLES = new Set([
+	"sheep",
+	"fish",
+	"deer",
+	"series",
+	"species",
+	"money",
+	"rice",
+	"information",
+	"equipment",
+	"media",
+	"data"
+]);
+/**
+* Pluralize an English word.
+*
+* @param word - Singular noun (e.g. "company", "product", "person")
+* @returns Plural form (e.g. "companies", "products", "people")
+*/
+function pluralize(word) {
+	const lower = word.toLowerCase();
+	if (UNCOUNTABLES.has(lower)) return word;
+	if (IRREGULARS[lower]) {
+		const plural = IRREGULARS[lower];
+		return word[0] === word[0].toUpperCase() ? plural.charAt(0).toUpperCase() + plural.slice(1) : plural;
+	}
+	if (lower.endsWith("fe")) return word.slice(0, -2) + "ves";
+	if (lower.endsWith("f") && !lower.endsWith("ff") && !lower.endsWith("roof") && !lower.endsWith("chief") && !lower.endsWith("belief")) return word.slice(0, -1) + "ves";
+	if (lower.endsWith("y") && !/[aeiou]y$/i.test(lower)) return word.slice(0, -1) + "ies";
+	if (lower.endsWith("is")) return word.slice(0, -2) + "es";
+	if (new Set([
+		"cactus",
+		"stimulus",
+		"focus",
+		"fungus",
+		"nucleus",
+		"syllabus",
+		"radius",
+		"alumnus",
+		"terminus",
+		"bacillus"
+	]).has(lower)) return word.slice(0, -2) + "i";
+	if (lower.endsWith("z") && !lower.endsWith("zz")) return word + "zes";
+	if (/(?:s|sh|ch|x|zz)$/i.test(lower)) return word + "es";
+	if (lower.endsWith("o") && !/[aeiou]o$/i.test(lower)) return word + "es";
+	return word + "s";
+}
+
+//#endregion
+export { pluralize as t };
+//# sourceMappingURL=pluralize-CEweyOEm.mjs.map

package/dist/pluralize-CEweyOEm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluralize-CEweyOEm.mjs","names":[],"sources":["../src/cli/utils/pluralize.ts"],"sourcesContent":["/**\n * Lightweight English pluralization for the Arc CLI.\n *\n * Covers the common cases developers hit when naming resources:\n *   company  → companies\n *   category → categories\n *   status   → statuses\n *   address  → addresses\n *   person   → people\n *   child    → children\n *   bus      → buses\n *   box      → boxes\n *   quiz     → quizzes\n *   leaf     → leaves\n *   wolf     → wolves\n *\n * No external dependencies — designed to keep the CLI install-free.\n */\n\n// Irregular nouns that can't be handled by suffix rules\nconst IRREGULARS: Record<string, string> = {\n  person: 'people',\n  child: 'children',\n  man: 'men',\n  woman: 'women',\n  mouse: 'mice',\n  goose: 'geese',\n  tooth: 'teeth',\n  foot: 'feet',\n  ox: 'oxen',\n  datum: 'data',\n  medium: 'media',\n  index: 'indices',\n  matrix: 'matrices',\n  vertex: 'vertices',\n  criterion: 'criteria',\n};\n\n// Words that are the same singular and plural\nconst UNCOUNTABLES = new Set([\n  'sheep', 'fish', 'deer', 'series', 'species', 'money',\n  'rice', 'information', 'equipment', 'media', 'data',\n]);\n\n/**\n * Pluralize an English word.\n *\n * @param word - Singular noun (e.g. \"company\", \"product\", \"person\")\n * @returns Plural form (e.g. \"companies\", \"products\", \"people\")\n */\nexport function pluralize(word: string): string {\n  const lower = word.toLowerCase();\n\n  // Uncountable — return as-is\n  if (UNCOUNTABLES.has(lower)) return word;\n\n  // Irregular — preserve original casing of first char\n  if (IRREGULARS[lower]) {\n    const plural = IRREGULARS[lower];\n    return word[0]! === word[0]!.toUpperCase()\n      ? plural.charAt(0).toUpperCase() + plural.slice(1)\n      : plural;\n  }\n\n  // Suffix rules (order matters — most specific first)\n\n  // -fe / -f → -ves  (leaf → leaves, wolf → wolves, knife → knives)\n  if (lower.endsWith('fe')) return word.slice(0, -2) + 'ves';\n  if (lower.endsWith('f') && !lower.endsWith('ff') && !lower.endsWith('roof') && !lower.endsWith('chief') && !lower.endsWith('belief')) {\n    return word.slice(0, -1) + 'ves';\n  }\n\n  // consonant + y → -ies  (company → companies, category → categories)\n  if (lower.endsWith('y') && !/[aeiou]y$/i.test(lower)) {\n    return word.slice(0, -1) + 'ies';\n  }\n\n  // -is → -es  (analysis → analyses, crisis → crises)\n  if (lower.endsWith('is')) return word.slice(0, -2) + 'es';\n\n  // -us → -i  (only Latin-origin words, not status/bus/campus/virus)\n  const LATIN_US_TO_I = new Set([\n    'cactus', 'stimulus', 'focus', 'fungus', 'nucleus',\n    'syllabus', 'radius', 'alumnus', 'terminus', 'bacillus',\n  ]);\n  if (LATIN_US_TO_I.has(lower)) return word.slice(0, -2) + 'i';\n\n  // -z at end → double z + -es  (quiz → quizzes, fez → fezzes)\n  if (lower.endsWith('z') && !lower.endsWith('zz')) return word + 'zes';\n\n  // sibilant endings: -s, -ss, -sh, -ch, -x, -zz → -es\n  if (/(?:s|sh|ch|x|zz)$/i.test(lower)) return word + 'es';\n\n  // -o → -es for common cases (hero → heroes, tomato → tomatoes)\n  // but not for words ending in a vowel + o (radio → radios)\n  if (lower.endsWith('o') && !/[aeiou]o$/i.test(lower)) return word + 'es';\n\n  // Default: just add -s\n  return word + 's';\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAoBA,MAAM,aAAqC;CACzC,QAAQ;CACR,OAAO;CACP,KAAK;CACL,OAAO;CACP,OAAO;CACP,OAAO;CACP,OAAO;CACP,MAAM;CACN,IAAI;CACJ,OAAO;CACP,QAAQ;CACR,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,WAAW;CACZ;AAGD,MAAM,eAAe,IAAI,IAAI;CAC3B;CAAS;CAAQ;CAAQ;CAAU;CAAW;CAC9C;CAAQ;CAAe;CAAa;CAAS;CAC9C,CAAC;;;;;;;AAQF,SAAgB,UAAU,MAAsB;CAC9C,MAAM,QAAQ,KAAK,aAAa;AAGhC,KAAI,aAAa,IAAI,MAAM,CAAE,QAAO;AAGpC,KAAI,WAAW,QAAQ;EACrB,MAAM,SAAS,WAAW;AAC1B,SAAO,KAAK,OAAQ,KAAK,GAAI,aAAa,GACtC,OAAO,OAAO,EAAE,CAAC,aAAa,GAAG,OAAO,MAAM,EAAE,GAChD;;AAMN,KAAI,MAAM,SAAS,KAAK,CAAE,QAAO,KAAK,MAAM,GAAG,GAAG,GAAG;AACrD,KAAI,MAAM,SAAS,IAAI,IAAI,CAAC,MAAM,SAAS,KAAK,IAAI,CAAC,MAAM,SAAS,OAAO,IAAI,CAAC,MAAM,SAAS,QAAQ,IAAI,CAAC,MAAM,SAAS,SAAS,CAClI,QAAO,KAAK,MAAM,GAAG,GAAG,GAAG;AAI7B,KAAI,MAAM,SAAS,IAAI,IAAI,CAAC,aAAa,KAAK,MAAM,CAClD,QAAO,KAAK,MAAM,GAAG,GAAG,GAAG;AAI7B,KAAI,MAAM,SAAS,KAAK,CAAE,QAAO,KAAK,MAAM,GAAG,GAAG,GAAG;AAOrD,KAJsB,IAAI,IAAI;EAC5B;EAAU;EAAY;EAAS;EAAU;EACzC;EAAY;EAAU;EAAW;EAAY;EAC9C,CAAC,CACgB,IAAI,MAAM,CAAE,QAAO,KAAK,MAAM,GAAG,GAAG,GAAG;AAGzD,KAAI,MAAM,SAAS,IAAI,IAAI,CAAC,MAAM,SAAS,KAAK,CAAE,QAAO,OAAO;AAGhE,KAAI,qBAAqB,KAAK,MAAM,CAAE,QAAO,OAAO;AAIpD,KAAI,MAAM,SAAS,IAAI,IAAI,CAAC,aAAa,KAAK,MAAM,CAAE,QAAO,OAAO;AAGpE,QAAO,OAAO"}