@vestig/next 0.11.4 → 0.13.0

package/dist/wide-events/helpers.d.ts

@@ -0,0 +1,138 @@
+import { getWideEvent, getWideEventElapsed, requireWideEvent } from './context';
+export { getWideEvent, requireWideEvent, getWideEventElapsed };
+/**
+ * Set user information on the current wide event.
+ *
+ * This is a convenience function for setting common user fields.
+ *
+ * @param user - User information to set
+ *
+ * @example
+ * ```typescript
+ * import { setWideEventUser } from '@vestig/next/wide-events'
+ *
+ * // In your auth middleware or route handler
+ * setWideEventUser({
+ *   id: user.id,
+ *   subscription: user.plan,
+ *   role: user.role,
+ * })
+ * ```
+ */
+export declare function setWideEventUser(user: {
+    id?: string;
+    email?: string;
+    name?: string;
+    subscription?: string;
+    role?: string;
+    [key: string]: unknown;
+}): void;
+/**
+ * Set performance metrics on the current wide event.
+ *
+ * @param metrics - Performance metrics to set
+ *
+ * @example
+ * ```typescript
+ * import { setWideEventPerformance } from '@vestig/next/wide-events'
+ *
+ * // After database query
+ * setWideEventPerformance({
+ *   db_query_ms: queryTime,
+ *   db_rows: results.length,
+ * })
+ * ```
+ */
+export declare function setWideEventPerformance(metrics: Record<string, number | string>): void;
+/**
+ * Add a custom field to the current wide event.
+ *
+ * @param category - Field category (e.g., 'order', 'payment', 'feature')
+ * @param key - Field key
+ * @param value - Field value
+ *
+ * @example
+ * ```typescript
+ * import { setWideEventField } from '@vestig/next/wide-events'
+ *
+ * setWideEventField('order', 'id', orderId)
+ * setWideEventField('order', 'total', order.total)
+ * setWideEventField('order', 'items', order.items.length)
+ * ```
+ */
+export declare function setWideEventField(category: string, key: string, value: unknown): void;
+/**
+ * Add multiple fields to a category on the current wide event.
+ *
+ * @param category - Field category
+ * @param fields - Fields to merge
+ *
+ * @example
+ * ```typescript
+ * import { mergeWideEventFields } from '@vestig/next/wide-events'
+ *
+ * mergeWideEventFields('payment', {
+ *   method: 'stripe',
+ *   amount: 9999,
+ *   currency: 'usd',
+ *   status: 'succeeded',
+ * })
+ * ```
+ */
+export declare function mergeWideEventFields(category: string, fields: Record<string, unknown>): void;
+/**
+ * Add feature flag information to the current wide event.
+ *
+ * @param flags - Feature flag values
+ *
+ * @example
+ * ```typescript
+ * import { setWideEventFeatureFlags } from '@vestig/next/wide-events'
+ *
+ * setWideEventFeatureFlags({
+ *   new_checkout: true,
+ *   beta_features: false,
+ *   experiment_id: 'exp-123',
+ * })
+ * ```
+ */
+export declare function setWideEventFeatureFlags(flags: Record<string, boolean | string | number>): void;
+/**
+ * Add error information to the current wide event.
+ *
+ * This should be called when an error occurs during request processing.
+ * The wide event will be marked as 'error' status when finalized.
+ *
+ * @param error - The error that occurred
+ * @param additionalContext - Additional context about the error
+ *
+ * @example
+ * ```typescript
+ * import { setWideEventError } from '@vestig/next/wide-events'
+ *
+ * try {
+ *   await processPayment(order)
+ * } catch (error) {
+ *   setWideEventError(error, { orderId: order.id })
+ *   throw error
+ * }
+ * ```
+ */
+export declare function setWideEventError(error: Error | unknown, additionalContext?: Record<string, unknown>): void;
+/**
+ * Create a timing helper for tracking sub-operations within a request.
+ *
+ * @param name - Name of the operation being timed
+ * @returns A function to call when the operation completes
+ *
+ * @example
+ * ```typescript
+ * import { timeWideEventOperation } from '@vestig/next/wide-events'
+ *
+ * const endDbQuery = timeWideEventOperation('db_users_query')
+ * const users = await db.users.findMany()
+ * endDbQuery()
+ * ```
+ */
+export declare function timeWideEventOperation(name: string): () => void;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/wide-events/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/wide-events/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAG/E,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,CAAA;AAE9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACtC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACtB,GAAG,IAAI,CAWP;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,CAKtF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAKrF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAK5F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,CAK/F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,KAAK,GAAG,OAAO,EACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,IAAI,CAYN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,IAAI,CAU/D"}

package/dist/wide-events/helpers.js

@@ -0,0 +1,182 @@
+import { getWideEvent, getWideEventElapsed, requireWideEvent } from './context';
+// Re-export context functions as helpers
+export { getWideEvent, requireWideEvent, getWideEventElapsed };
+/**
+ * Set user information on the current wide event.
+ *
+ * This is a convenience function for setting common user fields.
+ *
+ * @param user - User information to set
+ *
+ * @example
+ * ```typescript
+ * import { setWideEventUser } from '@vestig/next/wide-events'
+ *
+ * // In your auth middleware or route handler
+ * setWideEventUser({
+ *   id: user.id,
+ *   subscription: user.plan,
+ *   role: user.role,
+ * })
+ * ```
+ */
+export function setWideEventUser(user) {
+    const event = getWideEvent();
+    if (!event)
+        return;
+    // Set userId in context for tail sampling VIP detection
+    if (user.id) {
+        event.setContext({ userId: user.id });
+    }
+    // Set user fields
+    event.merge('user', user);
+}
+/**
+ * Set performance metrics on the current wide event.
+ *
+ * @param metrics - Performance metrics to set
+ *
+ * @example
+ * ```typescript
+ * import { setWideEventPerformance } from '@vestig/next/wide-events'
+ *
+ * // After database query
+ * setWideEventPerformance({
+ *   db_query_ms: queryTime,
+ *   db_rows: results.length,
+ * })
+ * ```
+ */
+export function setWideEventPerformance(metrics) {
+    const event = getWideEvent();
+    if (!event)
+        return;
+    event.merge('performance', metrics);
+}
+/**
+ * Add a custom field to the current wide event.
+ *
+ * @param category - Field category (e.g., 'order', 'payment', 'feature')
+ * @param key - Field key
+ * @param value - Field value
+ *
+ * @example
+ * ```typescript
+ * import { setWideEventField } from '@vestig/next/wide-events'
+ *
+ * setWideEventField('order', 'id', orderId)
+ * setWideEventField('order', 'total', order.total)
+ * setWideEventField('order', 'items', order.items.length)
+ * ```
+ */
+export function setWideEventField(category, key, value) {
+    const event = getWideEvent();
+    if (!event)
+        return;
+    event.set(category, key, value);
+}
+/**
+ * Add multiple fields to a category on the current wide event.
+ *
+ * @param category - Field category
+ * @param fields - Fields to merge
+ *
+ * @example
+ * ```typescript
+ * import { mergeWideEventFields } from '@vestig/next/wide-events'
+ *
+ * mergeWideEventFields('payment', {
+ *   method: 'stripe',
+ *   amount: 9999,
+ *   currency: 'usd',
+ *   status: 'succeeded',
+ * })
+ * ```
+ */
+export function mergeWideEventFields(category, fields) {
+    const event = getWideEvent();
+    if (!event)
+        return;
+    event.merge(category, fields);
+}
+/**
+ * Add feature flag information to the current wide event.
+ *
+ * @param flags - Feature flag values
+ *
+ * @example
+ * ```typescript
+ * import { setWideEventFeatureFlags } from '@vestig/next/wide-events'
+ *
+ * setWideEventFeatureFlags({
+ *   new_checkout: true,
+ *   beta_features: false,
+ *   experiment_id: 'exp-123',
+ * })
+ * ```
+ */
+export function setWideEventFeatureFlags(flags) {
+    const event = getWideEvent();
+    if (!event)
+        return;
+    event.merge('feature_flags', flags);
+}
+/**
+ * Add error information to the current wide event.
+ *
+ * This should be called when an error occurs during request processing.
+ * The wide event will be marked as 'error' status when finalized.
+ *
+ * @param error - The error that occurred
+ * @param additionalContext - Additional context about the error
+ *
+ * @example
+ * ```typescript
+ * import { setWideEventError } from '@vestig/next/wide-events'
+ *
+ * try {
+ *   await processPayment(order)
+ * } catch (error) {
+ *   setWideEventError(error, { orderId: order.id })
+ *   throw error
+ * }
+ * ```
+ */
+export function setWideEventError(error, additionalContext) {
+    const event = getWideEvent();
+    if (!event)
+        return;
+    const err = error instanceof Error ? error : new Error(String(error));
+    event.merge('error', {
+        name: err.name,
+        message: err.message,
+        stack: err.stack?.split('\n').slice(0, 10).join('\n'),
+        ...additionalContext,
+    });
+}
+/**
+ * Create a timing helper for tracking sub-operations within a request.
+ *
+ * @param name - Name of the operation being timed
+ * @returns A function to call when the operation completes
+ *
+ * @example
+ * ```typescript
+ * import { timeWideEventOperation } from '@vestig/next/wide-events'
+ *
+ * const endDbQuery = timeWideEventOperation('db_users_query')
+ * const users = await db.users.findMany()
+ * endDbQuery()
+ * ```
+ */
+export function timeWideEventOperation(name) {
+    const startTime = performance.now();
+    const event = getWideEvent();
+    return () => {
+        const duration = performance.now() - startTime;
+        if (event) {
+            event.set('performance', `${name}_ms`, duration);
+        }
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/wide-events/helpers.js.map

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

package/dist/wide-events/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Wide Events integration for Next.js
+ *
+ * Wide Events (also called Canonical Log Lines) capture comprehensive context
+ * about complete operations in a single structured event, making debugging
+ * and observability significantly easier.
+ *
+ * @example Middleware setup
+ * ```typescript
+ * // middleware.ts
+ * import { createWideEventMiddleware } from '@vestig/next/wide-events'
+ *
+ * export const middleware = createWideEventMiddleware({
+ *   tailSampling: {
+ *     enabled: true,
+ *     alwaysKeepStatuses: ['error'],
+ *     slowThresholdMs: 2000,
+ *     successSampleRate: 0.1,
+ *   },
+ * })
+ * ```
+ *
+ * @example Server Actions
+ * ```typescript
+ * // app/actions/user.ts
+ * 'use server'
+ *
+ * import { withWideEvent, setWideEventUser } from '@vestig/next/wide-events'
+ *
+ * export const createUser = withWideEvent(
+ *   async (data, { event }) => {
+ *     const user = await db.users.create({ data })
+ *     setWideEventUser({ id: user.id, email: user.email })
+ *     return user
+ *   },
+ *   { name: 'action.user.create' }
+ * )
+ * ```
+ *
+ * @example Enriching from route handlers
+ * ```typescript
+ * // app/api/checkout/route.ts
+ * import { getWideEvent, setWideEventField } from '@vestig/next/wide-events'
+ *
+ * export async function POST(request: Request) {
+ *   const event = getWideEvent()
+ *   if (event) {
+ *     event.set('order', 'id', orderId)
+ *     event.set('payment', 'method', 'stripe')
+ *   }
+ *   // ...
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { getWideEvent, requireWideEvent, getWideEventElapsed, runWithWideEvent, runWithWideEventAsync, type WideEventRequestContext, } from './context';
+export { createWideEventMiddleware, wideEventMiddleware, type WideEventMiddlewareOptions, } from './middleware';
+export { setWideEventUser, setWideEventPerformance, setWideEventField, mergeWideEventFields, setWideEventFeatureFlags, setWideEventError, timeWideEventOperation, } from './helpers';
+export { withWideEvent, createWideEventAction, type WideEventActionOptions, type WideEventActionContext, type WideEventServerAction, } from './server-action';
+export type { WideEvent, WideEventBuilder, WideEventConfig, WideEventContext, WideEventEndOptions, WideEventFields, WideEventStatus, TailSamplingConfig, } from 'vestig';
+export { createWideEvent } from 'vestig';
+//# sourceMappingURL=index.d.ts.map

package/dist/wide-events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wide-events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAGH,OAAO,EACN,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,uBAAuB,GAC5B,MAAM,WAAW,CAAA;AAGlB,OAAO,EACN,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,0BAA0B,GAC/B,MAAM,cAAc,CAAA;AAGrB,OAAO,EACN,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,GACtB,MAAM,WAAW,CAAA;AAGlB,OAAO,EACN,aAAa,EACb,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC1B,MAAM,iBAAiB,CAAA;AAGxB,YAAY,EACX,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,kBAAkB,GAClB,MAAM,QAAQ,CAAA;AAGf,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA"}

package/dist/wide-events/index.js

@@ -0,0 +1,67 @@
+/**
+ * Wide Events integration for Next.js
+ *
+ * Wide Events (also called Canonical Log Lines) capture comprehensive context
+ * about complete operations in a single structured event, making debugging
+ * and observability significantly easier.
+ *
+ * @example Middleware setup
+ * ```typescript
+ * // middleware.ts
+ * import { createWideEventMiddleware } from '@vestig/next/wide-events'
+ *
+ * export const middleware = createWideEventMiddleware({
+ *   tailSampling: {
+ *     enabled: true,
+ *     alwaysKeepStatuses: ['error'],
+ *     slowThresholdMs: 2000,
+ *     successSampleRate: 0.1,
+ *   },
+ * })
+ * ```
+ *
+ * @example Server Actions
+ * ```typescript
+ * // app/actions/user.ts
+ * 'use server'
+ *
+ * import { withWideEvent, setWideEventUser } from '@vestig/next/wide-events'
+ *
+ * export const createUser = withWideEvent(
+ *   async (data, { event }) => {
+ *     const user = await db.users.create({ data })
+ *     setWideEventUser({ id: user.id, email: user.email })
+ *     return user
+ *   },
+ *   { name: 'action.user.create' }
+ * )
+ * ```
+ *
+ * @example Enriching from route handlers
+ * ```typescript
+ * // app/api/checkout/route.ts
+ * import { getWideEvent, setWideEventField } from '@vestig/next/wide-events'
+ *
+ * export async function POST(request: Request) {
+ *   const event = getWideEvent()
+ *   if (event) {
+ *     event.set('order', 'id', orderId)
+ *     event.set('payment', 'method', 'stripe')
+ *   }
+ *   // ...
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Context functions
+export { getWideEvent, requireWideEvent, getWideEventElapsed, runWithWideEvent, runWithWideEventAsync, } from './context';
+// Middleware
+export { createWideEventMiddleware, wideEventMiddleware, } from './middleware';
+// Helpers
+export { setWideEventUser, setWideEventPerformance, setWideEventField, mergeWideEventFields, setWideEventFeatureFlags, setWideEventError, timeWideEventOperation, } from './helpers';
+// Server Actions
+export { withWideEvent, createWideEventAction, } from './server-action';
+// Re-export createWideEvent for advanced use cases
+export { createWideEvent } from 'vestig';
+//# sourceMappingURL=index.js.map

package/dist/wide-events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wide-events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,oBAAoB;AACpB,OAAO,EACN,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GAErB,MAAM,WAAW,CAAA;AAElB,aAAa;AACb,OAAO,EACN,yBAAyB,EACzB,mBAAmB,GAEnB,MAAM,cAAc,CAAA;AAErB,UAAU;AACV,OAAO,EACN,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,GACtB,MAAM,WAAW,CAAA;AAElB,iBAAiB;AACjB,OAAO,EACN,aAAa,EACb,qBAAqB,GAIrB,MAAM,iBAAiB,CAAA;AAcxB,mDAAmD;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA"}

package/dist/wide-events/middleware.d.ts

@@ -0,0 +1,65 @@
+import { NextResponse } from 'next/server';
+import type { NextRequest } from 'next/server';
+import { type LogLevel, type SanitizePreset, type TailSamplingConfig } from 'vestig';
+/**
+ * Options for the wide event middleware
+ */
+export interface WideEventMiddlewareOptions {
+    /** Log level for the logger */
+    level?: LogLevel;
+    /** Enable/disable wide event logging */
+    enabled?: boolean;
+    /** PII sanitization preset */
+    sanitize?: SanitizePreset;
+    /** Paths to skip (prefix matching) */
+    skipPaths?: string[];
+    /** Custom header name for request ID */
+    requestIdHeader?: string;
+    /** Use structured JSON output */
+    structured?: boolean;
+    /** Tail sampling configuration for wide events */
+    tailSampling?: TailSamplingConfig;
+}
+/**
+ * Create wide event middleware for Next.js
+ *
+ * This middleware automatically creates a wide event for each request
+ * and populates it with HTTP context. The wide event is available
+ * throughout the request lifecycle via `getWideEvent()`.
+ *
+ * @example
+ * ```typescript
+ * // middleware.ts
+ * import { createWideEventMiddleware } from '@vestig/next/wide-events'
+ *
+ * export const middleware = createWideEventMiddleware({
+ *   skipPaths: ['/health', '/metrics'],
+ *   tailSampling: {
+ *     enabled: true,
+ *     alwaysKeepStatuses: ['error'],
+ *     slowThresholdMs: 2000,
+ *     successSampleRate: 0.1,
+ *   },
+ * })
+ *
+ * export const config = {
+ *   matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
+ * }
+ * ```
+ */
+export declare function createWideEventMiddleware(options?: WideEventMiddlewareOptions): (request: NextRequest) => Promise<NextResponse<unknown>>;
+/**
+ * Pre-configured wide event middleware for direct export
+ *
+ * @example
+ * ```typescript
+ * // middleware.ts
+ * export { wideEventMiddleware as middleware } from '@vestig/next/wide-events'
+ *
+ * export const config = {
+ *   matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
+ * }
+ * ```
+ */
+export declare const wideEventMiddleware: (request: NextRequest) => Promise<NextResponse<unknown>>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/wide-events/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/wide-events/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EACN,KAAK,QAAQ,EAEb,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAMvB,MAAM,QAAQ,CAAA;AAIf;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C,+BAA+B;IAC/B,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iCAAiC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kDAAkD;IAClD,YAAY,CAAC,EAAE,kBAAkB,CAAA;CACjC;AA8BD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,0BAA+B,IAGvC,SAAS,WAAW,oCA2G9D;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,YA1HoB,WAAW,mCA0HD,CAAA"}