@portaidentity/server 1.7.0

package/dist/applications/repository.js

@@ -0,0 +1,367 @@
+/**
+ * Application repository — PostgreSQL data access layer.
+ *
+ * Provides CRUD operations for the `applications` and `application_modules`
+ * tables using parameterized queries. Each function acquires the pool via
+ * `getPool()` and returns mapped Application/ApplicationModule objects.
+ *
+ * This module is the sole interface to the database for application
+ * data. The service layer composes repository + cache + validation.
+ *
+ * Key patterns:
+ * - Dynamic UPDATE query builder for partial updates
+ * - Paginated listing with optional status/search filters
+ * - Whitelisted sort columns to prevent SQL injection
+ * - All rows mapped through `mapRowToApplication()` / `mapRowToModule()`
+ * - Module slug uniqueness scoped to parent application (composite key)
+ */
+import { getPool } from '../lib/database.js';
+import { mapRowToApplication, mapRowToModule } from './types.js';
+import { decodeCursor, buildCursorResult } from '../lib/cursor.js';
+/**
+ * Insert a new application into the database.
+ *
+ * Uses RETURNING * to get the full row back in a single round trip.
+ * The slug must be unique (enforced by the DB unique constraint).
+ *
+ * @param data - Application data to insert
+ * @returns The newly created application
+ * @throws If slug already exists (unique constraint violation)
+ */
+export async function insertApplication(data) {
+    const pool = getPool();
+    const result = await pool.query(`INSERT INTO applications (name, slug, description)
+     VALUES ($1, $2, $3)
+     RETURNING *`, [data.name, data.slug, data.description ?? null]);
+    return mapRowToApplication(result.rows[0]);
+}
+// ---------------------------------------------------------------------------
+// Find
+// ---------------------------------------------------------------------------
+/**
+ * Find an application by its UUID.
+ *
+ * @param id - Application UUID
+ * @returns Application or null if not found
+ */
+export async function findApplicationById(id) {
+    const pool = getPool();
+    const result = await pool.query('SELECT * FROM applications WHERE id = $1', [id]);
+    if (result.rows.length === 0)
+        return null;
+    return mapRowToApplication(result.rows[0]);
+}
+/**
+ * Find an application by its slug.
+ *
+ * Returns applications of any status (active, inactive, archived).
+ * The caller (service layer) is responsible for status-based access control.
+ *
+ * @param slug - Application slug
+ * @returns Application or null if not found
+ */
+export async function findApplicationBySlug(slug) {
+    const pool = getPool();
+    const result = await pool.query('SELECT * FROM applications WHERE slug = $1', [slug]);
+    if (result.rows.length === 0)
+        return null;
+    return mapRowToApplication(result.rows[0]);
+}
+/**
+ * Mapping from UpdateApplicationData keys to database column names.
+ * Used by the dynamic query builder to construct SET clauses.
+ */
+const APP_FIELD_TO_COLUMN = {
+    name: 'name',
+    status: 'status',
+    description: 'description',
+};
+/**
+ * Update an application's fields using a dynamic SET clause.
+ *
+ * Only explicitly provided fields (not undefined) are included in the
+ * UPDATE statement. This allows partial updates without overwriting
+ * fields that weren't specified.
+ *
+ * The `updated_at` column is handled automatically by the DB trigger.
+ *
+ * @param id - Application UUID
+ * @param data - Fields to update (only non-undefined fields are applied)
+ * @returns Updated application
+ * @throws Error if application not found or no fields provided
+ */
+export async function updateApplication(id, data) {
+    const pool = getPool();
+    // Build dynamic SET clause from provided fields
+    const setClauses = [];
+    const values = [id]; // $1 is always the ID
+    let paramIndex = 2;
+    for (const [field, column] of Object.entries(APP_FIELD_TO_COLUMN)) {
+        const value = data[field];
+        // Include the field if it's explicitly set (including null for clearing)
+        if (value !== undefined) {
+            setClauses.push(`${column} = $${paramIndex}`);
+            values.push(value);
+            paramIndex++;
+        }
+    }
+    if (setClauses.length === 0) {
+        throw new Error('No fields to update');
+    }
+    const sql = `UPDATE applications SET ${setClauses.join(', ')} WHERE id = $1 RETURNING *`;
+    const result = await pool.query(sql, values);
+    if (result.rows.length === 0) {
+        throw new Error('Application not found');
+    }
+    return mapRowToApplication(result.rows[0]);
+}
+// ---------------------------------------------------------------------------
+// List
+// ---------------------------------------------------------------------------
+/**
+ * Allowed sort columns — whitelisted to prevent SQL injection.
+ * These are interpolated directly into the SQL ORDER BY clause.
+ */
+const ALLOWED_SORT_COLUMNS = {
+    name: 'name',
+    created_at: 'created_at',
+};
+/**
+ * List applications with pagination, optional status filter, search, and sorting.
+ *
+ * Executes two queries:
+ * 1. COUNT query for total matching rows
+ * 2. Data query with LIMIT/OFFSET for the current page
+ *
+ * Sort column and direction are whitelisted (not parameterized) since
+ * they're SQL identifiers/keywords, not user data values.
+ *
+ * @param options - Pagination, filter, and sort options
+ * @returns Paginated result with applications and metadata
+ */
+export async function listApplications(options) {
+    const pool = getPool();
+    const { page, pageSize, status, search, sortBy, sortOrder } = options;
+    // Build WHERE conditions
+    const conditions = [];
+    const params = [];
+    let paramIndex = 1;
+    if (status) {
+        conditions.push(`status = $${paramIndex}`);
+        params.push(status);
+        paramIndex++;
+    }
+    if (search) {
+        // Search by name or slug using case-insensitive LIKE
+        conditions.push(`(name ILIKE $${paramIndex} OR slug ILIKE $${paramIndex})`);
+        params.push(`%${search}%`);
+        paramIndex++;
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+    // Whitelist sort column and direction to prevent SQL injection
+    const sortColumn = ALLOWED_SORT_COLUMNS[sortBy ?? 'created_at'] ?? 'created_at';
+    const direction = sortOrder === 'asc' ? 'ASC' : 'DESC';
+    // Count total matching rows
+    const countResult = await pool.query(`SELECT COUNT(*) as count FROM applications ${whereClause}`, params);
+    const total = parseInt(countResult.rows[0].count, 10);
+    // Fetch paginated data
+    const offset = (page - 1) * pageSize;
+    const dataResult = await pool.query(`SELECT * FROM applications ${whereClause} ORDER BY ${sortColumn} ${direction} LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`, [...params, pageSize, offset]);
+    return {
+        data: dataResult.rows.map(mapRowToApplication),
+        total,
+        page,
+        pageSize,
+        totalPages: Math.ceil(total / pageSize),
+    };
+}
+/**
+ * List applications with cursor-based keyset pagination.
+ *
+ * Uses `(sort_column, id) > (cursor_sort, cursor_id)` for efficient
+ * paging without COUNT queries. Queries limit+1 rows to detect hasMore.
+ *
+ * @param options - Cursor pagination, filter, and sort options
+ * @returns Cursor-paginated result with applications
+ */
+export async function listApplicationsCursor(options) {
+    const pool = getPool();
+    const limit = Math.min(Math.max(1, options.limit ?? 25), 100);
+    const sortColumn = ALLOWED_SORT_COLUMNS[options.sortBy ?? 'created_at'] ?? 'created_at';
+    const direction = options.sortOrder === 'asc' ? 'ASC' : 'DESC';
+    const comparator = direction === 'ASC' ? '>' : '<';
+    const conditions = [];
+    const params = [];
+    let paramIndex = 1;
+    if (options.cursor) {
+        const decoded = decodeCursor(options.cursor);
+        if (decoded) {
+            if (decoded.s === null) {
+                conditions.push(`(${sortColumn} IS NOT NULL OR (${sortColumn} IS NULL AND id ${comparator} $${paramIndex}))`);
+                params.push(decoded.i);
+                paramIndex++;
+            }
+            else {
+                conditions.push(`(${sortColumn}, id) ${comparator} ($${paramIndex}, $${paramIndex + 1})`);
+                params.push(decoded.s, decoded.i);
+                paramIndex += 2;
+            }
+        }
+    }
+    if (options.status) {
+        conditions.push(`status = $${paramIndex}`);
+        params.push(options.status);
+        paramIndex++;
+    }
+    if (options.search) {
+        conditions.push(`(name ILIKE $${paramIndex} OR slug ILIKE $${paramIndex})`);
+        params.push(`%${options.search}%`);
+        paramIndex++;
+    }
+    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+    const sql = `SELECT * FROM applications ${whereClause} ORDER BY ${sortColumn} ${direction}, id ${direction} LIMIT $${paramIndex}`;
+    params.push(limit + 1);
+    const result = await pool.query(sql, params);
+    const rows = result.rows.map(mapRowToApplication);
+    return buildCursorResult(rows, limit, (app) => sortColumn === 'name' ? app.name : app.createdAt.toISOString(), (app) => app.id);
+}
+// ---------------------------------------------------------------------------
+// Slug existence check
+// ---------------------------------------------------------------------------
+/**
+ * Check if an application slug is already taken in the database.
+ *
+ * Checks across all statuses (active, inactive, archived) because
+ * slugs must be globally unique regardless of application status.
+ *
+ * @param slug - Slug to check
+ * @param excludeId - Optional app ID to exclude (useful for updates)
+ * @returns true if the slug already exists
+ */
+export async function slugExists(slug, excludeId) {
+    const pool = getPool();
+    if (excludeId) {
+        const result = await pool.query('SELECT EXISTS(SELECT 1 FROM applications WHERE slug = $1 AND id != $2) as exists', [slug, excludeId]);
+        return result.rows[0].exists;
+    }
+    const result = await pool.query('SELECT EXISTS(SELECT 1 FROM applications WHERE slug = $1) as exists', [slug]);
+    return result.rows[0].exists;
+}
+/**
+ * Insert a new module into the database for a given application.
+ *
+ * Module slugs are unique within their parent application
+ * (enforced by the composite UNIQUE constraint on application_id + slug).
+ *
+ * @param data - Module data to insert
+ * @returns The newly created module
+ * @throws If composite slug already exists (unique constraint violation)
+ */
+export async function insertModule(data) {
+    const pool = getPool();
+    const result = await pool.query(`INSERT INTO application_modules (application_id, name, slug, description)
+     VALUES ($1, $2, $3, $4)
+     RETURNING *`, [data.applicationId, data.name, data.slug, data.description ?? null]);
+    return mapRowToModule(result.rows[0]);
+}
+// ---------------------------------------------------------------------------
+// Find Module
+// ---------------------------------------------------------------------------
+/**
+ * Find a module by its UUID.
+ *
+ * @param id - Module UUID
+ * @returns ApplicationModule or null if not found
+ */
+export async function findModuleById(id) {
+    const pool = getPool();
+    const result = await pool.query('SELECT * FROM application_modules WHERE id = $1', [id]);
+    if (result.rows.length === 0)
+        return null;
+    return mapRowToModule(result.rows[0]);
+}
+/**
+ * Mapping from UpdateModuleData keys to database column names.
+ * Used by the dynamic query builder to construct SET clauses.
+ */
+const MODULE_FIELD_TO_COLUMN = {
+    name: 'name',
+    status: 'status',
+    description: 'description',
+};
+/**
+ * Update a module's fields using a dynamic SET clause.
+ *
+ * Only explicitly provided fields (not undefined) are included in the
+ * UPDATE statement. The `updated_at` column is handled by the DB trigger.
+ *
+ * @param id - Module UUID
+ * @param data - Fields to update (only non-undefined fields are applied)
+ * @returns Updated module
+ * @throws Error if module not found or no fields provided
+ */
+export async function updateModule(id, data) {
+    const pool = getPool();
+    // Build dynamic SET clause from provided fields
+    const setClauses = [];
+    const values = [id]; // $1 is always the ID
+    let paramIndex = 2;
+    for (const [field, column] of Object.entries(MODULE_FIELD_TO_COLUMN)) {
+        const value = data[field];
+        if (value !== undefined) {
+            setClauses.push(`${column} = $${paramIndex}`);
+            values.push(value);
+            paramIndex++;
+        }
+    }
+    if (setClauses.length === 0) {
+        throw new Error('No fields to update');
+    }
+    const sql = `UPDATE application_modules SET ${setClauses.join(', ')} WHERE id = $1 RETURNING *`;
+    const result = await pool.query(sql, values);
+    if (result.rows.length === 0) {
+        throw new Error('Module not found');
+    }
+    return mapRowToModule(result.rows[0]);
+}
+// ---------------------------------------------------------------------------
+// List Modules
+// ---------------------------------------------------------------------------
+/**
+ * List all modules for a given application.
+ *
+ * Returns all modules regardless of status, ordered by name ascending.
+ * No pagination — modules per application are expected to be small in number.
+ *
+ * @param applicationId - Application UUID
+ * @returns Array of modules for the application
+ */
+export async function listModules(applicationId) {
+    const pool = getPool();
+    const result = await pool.query('SELECT * FROM application_modules WHERE application_id = $1 ORDER BY name ASC', [applicationId]);
+    return result.rows.map(mapRowToModule);
+}
+// ---------------------------------------------------------------------------
+// Module slug existence check
+// ---------------------------------------------------------------------------
+/**
+ * Check if a module slug is already taken within a given application.
+ *
+ * Module slugs are unique within their parent application (composite key).
+ * This check looks at all statuses (active, inactive).
+ *
+ * @param applicationId - Application UUID
+ * @param slug - Module slug to check
+ * @param excludeId - Optional module ID to exclude (useful for updates)
+ * @returns true if the slug already exists within the application
+ */
+export async function moduleSlugExists(applicationId, slug, excludeId) {
+    const pool = getPool();
+    if (excludeId) {
+        const result = await pool.query('SELECT EXISTS(SELECT 1 FROM application_modules WHERE application_id = $1 AND slug = $2 AND id != $3) as exists', [applicationId, slug, excludeId]);
+        return result.rows[0].exists;
+    }
+    const result = await pool.query('SELECT EXISTS(SELECT 1 FROM application_modules WHERE application_id = $1 AND slug = $2) as exists', [applicationId, slug]);
+    return result.rows[0].exists;
+}
+//# sourceMappingURL=repository.js.map

package/dist/applications/repository.js.map

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

package/dist/applications/service.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Application service — business logic orchestrator.
+ *
+ * Composes the repository, cache, slug utilities, and audit log
+ * to provide the complete application management API. All write
+ * operations follow the pattern:
+ *   1. Validate inputs
+ *   2. Perform DB operation (via repository)
+ *   3. Invalidate + re-cache (via cache)
+ *   4. Write audit log (fire-and-forget)
+ *
+ * Read operations check cache first, fall back to DB on miss.
+ *
+ * Status lifecycle rules (different from organizations):
+ *   - deactivate: active → inactive
+ *   - activate:   inactive → active
+ *   - archive:    active|inactive → archived (permanent, cannot be restored)
+ *
+ * Module management:
+ *   - Modules belong to an application (parent must exist)
+ *   - Module slugs are unique within their parent application
+ *   - Module deactivation sets status to inactive
+ */
+import type { Application, ApplicationModule, CreateApplicationInput, UpdateApplicationInput, CreateModuleInput, UpdateModuleInput, ListApplicationsOptions, PaginatedResult } from './types.js';
+import type { ListApplicationsCursorOptions } from './repository.js';
+import type { CursorPaginatedResult } from '../lib/cursor.js';
+/**
+ * Create a new application.
+ *
+ * 1. Generate slug from name if not provided
+ * 2. Validate slug format and reserved words
+ * 3. Check slug uniqueness in the database
+ * 4. Insert application via repository
+ * 5. Cache the new application
+ * 6. Write audit log entry
+ *
+ * @param input - Application creation data
+ * @param actorId - UUID of the user performing the action (for audit)
+ * @returns Created application
+ * @throws ApplicationValidationError if slug is invalid or already taken
+ */
+export declare function createApplication(input: CreateApplicationInput, actorId?: string): Promise<Application>;
+/**
+ * Find an application by ID.
+ * Checks Redis cache first, falls back to database on miss.
+ *
+ * @param id - Application UUID
+ * @returns Application or null if not found
+ */
+export declare function getApplicationById(id: string): Promise<Application | null>;
+/**
+ * Find an application by slug.
+ * Checks Redis cache first, falls back to database on miss.
+ *
+ * @param slug - Application slug
+ * @returns Application or null if not found
+ */
+export declare function getApplicationBySlug(slug: string): Promise<Application | null>;
+/**
+ * Update an application's basic fields (name, description).
+ *
+ * @param id - Application UUID
+ * @param input - Fields to update
+ * @param actorId - UUID of the user performing the action
+ * @returns Updated application
+ * @throws ApplicationNotFoundError if application not found
+ */
+export declare function updateApplication(id: string, input: UpdateApplicationInput, actorId?: string): Promise<Application>;
+/**
+ * List applications with pagination and filtering.
+ * Delegates directly to the repository.
+ *
+ * @param options - Pagination, filter, and sort options
+ * @returns Paginated result
+ */
+export declare function listApplications(options: ListApplicationsOptions): Promise<PaginatedResult<Application>>;
+/**
+ * List applications with cursor-based keyset pagination.
+ * Provides stable, efficient pagination without COUNT queries.
+ *
+ * @param options - Cursor, limit, filter, and sort options
+ * @returns Cursor-paginated result with nextCursor/hasMore
+ */
+export declare function listApplicationsCursor(options: ListApplicationsCursorOptions): Promise<CursorPaginatedResult<Application>>;
+/**
+ * Deactivate an application (active → inactive).
+ *
+ * @param id - Application UUID
+ * @param actorId - UUID of the user performing the action
+ * @throws ApplicationNotFoundError if not found
+ * @throws ApplicationValidationError if not currently active
+ */
+export declare function deactivateApplication(id: string, actorId?: string): Promise<void>;
+/**
+ * Activate an application (inactive → active).
+ *
+ * @param id - Application UUID
+ * @param actorId - UUID of the user performing the action
+ * @throws ApplicationNotFoundError if not found
+ * @throws ApplicationValidationError if not currently inactive
+ */
+export declare function activateApplication(id: string, actorId?: string): Promise<void>;
+/**
+ * Archive an application (active or inactive → archived).
+ *
+ * Archive is a permanent soft-delete — archived applications cannot
+ * be restored (unlike organizations which support restore).
+ *
+ * @param id - Application UUID
+ * @param actorId - UUID of the user performing the action
+ * @throws ApplicationNotFoundError if not found
+ * @throws ApplicationValidationError if already archived
+ */
+export declare function archiveApplication(id: string, actorId?: string): Promise<void>;
+/**
+ * Create a new module within an application.
+ *
+ * 1. Validate the parent application exists
+ * 2. Generate slug from name if not provided
+ * 3. Validate slug format
+ * 4. Check module slug uniqueness within the application
+ * 5. Insert module via repository
+ * 6. Write audit log entry
+ *
+ * @param applicationId - Parent application UUID
+ * @param input - Module creation data
+ * @param actorId - UUID of the user performing the action
+ * @returns Created module
+ * @throws ApplicationNotFoundError if parent application not found
+ * @throws ApplicationValidationError if slug is invalid or taken within app
+ */
+export declare function createModule(applicationId: string, input: CreateModuleInput, actorId?: string): Promise<ApplicationModule>;
+/**
+ * Update a module's basic fields (name, description).
+ *
+ * @param moduleId - Module UUID
+ * @param input - Fields to update
+ * @param actorId - UUID of the user performing the action
+ * @returns Updated module
+ * @throws ApplicationNotFoundError if module not found
+ */
+export declare function updateModule(moduleId: string, input: UpdateModuleInput, actorId?: string): Promise<ApplicationModule>;
+/**
+ * Deactivate a module (set status to inactive).
+ *
+ * @param moduleId - Module UUID
+ * @param actorId - UUID of the user performing the action
+ * @throws ApplicationNotFoundError if module not found
+ * @throws ApplicationValidationError if not currently active
+ */
+export declare function deactivateModule(moduleId: string, actorId?: string): Promise<void>;
+/**
+ * List all modules for an application.
+ * Delegates directly to the repository.
+ *
+ * @param applicationId - Application UUID
+ * @returns Array of modules
+ */
+export declare function listModules(applicationId: string): Promise<ApplicationModule[]>;
+//# sourceMappingURL=service.d.ts.map

package/dist/applications/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/applications/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EAChB,MAAM,YAAY,CAAC;AAepB,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAmB9D;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,EAC7B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAmCtB;AAMD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAWhF;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAWpF;AAMD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,sBAAsB,EAC7B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CA6BtB;AAMD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAEvC;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAE7C;AAgBD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAgBf;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,CAAC,CAqC5B;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,CAAC,CAyB5B;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAErF"}