@hypersonic-js/admin 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joaquim Dalton-Pereira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const DEFAULT_HIDDEN_MODELS: readonly ["Session", "Account", "Verification"];
+export declare const DEFAULT_PREFIX = "/admin";
+export declare const DEFAULT_PER_PAGE = 20;
+export declare const MAX_PER_PAGE = 100;
+export declare const MAX_RELATED_OPTIONS = 100;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,iDAAkD,CAAA;AACpF,eAAO,MAAM,cAAc,WAAW,CAAA;AACtC,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAClC,eAAO,MAAM,YAAY,MAAM,CAAA;AAC/B,eAAO,MAAM,mBAAmB,MAAM,CAAA"}

package/dist/constants.js

@@ -0,0 +1,6 @@
+export const DEFAULT_HIDDEN_MODELS = ['Session', 'Account', 'Verification'];
+export const DEFAULT_PREFIX = '/admin';
+export const DEFAULT_PER_PAGE = 20;
+export const MAX_PER_PAGE = 100;
+export const MAX_RELATED_OPTIONS = 100;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,cAAc,CAAU,CAAA;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAA;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAClC,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAA;AAC/B,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAA"}

package/dist/crud/pagination.d.ts

@@ -0,0 +1,11 @@
+import type { AdminPaginationMeta, PaginationParams } from '../types.js';
+/**
+ * Parses pagination query parameters from an Express request query object.
+ * Applies sensible defaults and clamps values to safe ranges.
+ */
+export declare function parsePaginationParams(query: Record<string, unknown>): PaginationParams;
+/**
+ * Builds pagination metadata from raw page/perPage/total values.
+ */
+export declare function buildPaginationMeta(page: number, perPage: number, total: number): AdminPaginationMeta;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/crud/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/crud/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGxE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAkBtF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,mBAAmB,CAOrB"}

package/dist/crud/pagination.js

@@ -0,0 +1,31 @@
+import { DEFAULT_PER_PAGE, MAX_PER_PAGE } from '../constants.js';
+/**
+ * Parses pagination query parameters from an Express request query object.
+ * Applies sensible defaults and clamps values to safe ranges.
+ */
+export function parsePaginationParams(query) {
+    const rawPage = Number(query['page']);
+    const rawPerPage = Number(query['perPage']);
+    const page = Number.isFinite(rawPage) && rawPage >= 1 ? Math.floor(rawPage) : 1;
+    const perPage = Number.isFinite(rawPerPage) && rawPerPage >= 1
+        ? Math.min(Math.floor(rawPerPage), MAX_PER_PAGE)
+        : DEFAULT_PER_PAGE;
+    return {
+        page,
+        perPage,
+        skip: (page - 1) * perPage,
+        take: perPage,
+    };
+}
+/**
+ * Builds pagination metadata from raw page/perPage/total values.
+ */
+export function buildPaginationMeta(page, perPage, total) {
+    return {
+        page,
+        perPage,
+        total,
+        totalPages: total === 0 ? 0 : Math.ceil(total / perPage),
+    };
+}
+//# sourceMappingURL=pagination.js.map

package/dist/crud/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/crud/pagination.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEhE;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAA8B;IAClE,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;IAE3C,MAAM,IAAI,GACR,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAEpE,MAAM,OAAO,GACX,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC;QAC5C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC;QAChD,CAAC,CAAC,gBAAgB,CAAA;IAEtB,OAAO;QACL,IAAI;QACJ,OAAO;QACP,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO;QAC1B,IAAI,EAAE,OAAO;KACd,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,OAAe,EACf,KAAa;IAEb,OAAO;QACL,IAAI;QACJ,OAAO;QACP,KAAK;QACL,UAAU,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;KACzD,CAAA;AACH,CAAC"}

package/dist/crud/query.d.ts

@@ -0,0 +1,64 @@
+import type { PrismaClientLike, AdminModelMeta } from '../types.js';
+interface PrismaDelegate {
+    findMany(args: object): Promise<unknown[]>;
+    findUnique(args: object): Promise<unknown>;
+    create(args: object): Promise<unknown>;
+    update(args: object): Promise<unknown>;
+    delete(args: object): Promise<unknown>;
+    count(args: object): Promise<number>;
+}
+/**
+ * Looks up the Prisma model delegate by camelCase model name.
+ * Throws a descriptive error if the delegate is not found.
+ */
+export declare function getDelegate(prisma: PrismaClientLike, modelName: string): PrismaDelegate;
+/**
+ * Coerces raw form string values to the correct JS types based on field metadata.
+ * Skips fields not present in model.formFields to prevent mass-assignment.
+ */
+export declare function coerceData(data: Record<string, unknown>, model: AdminModelMeta): Record<string, unknown>;
+export interface RelatedOption {
+    id: unknown;
+    label: string;
+}
+/**
+ * Fetches a bounded page of related model records and maps them to { id, label }
+ * pairs for use in a <select> dropdown on the admin form.
+ * The label uses the model's displayField; falls back to the idField value.
+ *
+ * @param skip  Number of records to skip — used for load-more pagination.
+ */
+export declare function fetchRelatedOptions(prisma: PrismaClientLike, model: AdminModelMeta, skip?: number): Promise<RelatedOption[]>;
+export interface FindManyResult {
+    records: unknown[];
+    total: number;
+}
+/** Fetches a paginated list of records and the total count in parallel. */
+export declare function findMany(prisma: PrismaClientLike, model: AdminModelMeta, pagination: {
+    skip: number;
+    take: number;
+}): Promise<FindManyResult>;
+/** Returns only the record count for a model — used on the dashboard. */
+export declare function countRecords(prisma: PrismaClientLike, model: AdminModelMeta): Promise<number>;
+/**
+ * Fetches a single record by its primary key.
+ * Returns null for non-numeric id strings on number-type models instead of
+ * passing NaN to Prisma.
+ */
+export declare function findUnique(prisma: PrismaClientLike, model: AdminModelMeta, id: string): Promise<unknown>;
+/** Creates a new record, coercing form values to correct types. */
+export declare function createRecord(prisma: PrismaClientLike, model: AdminModelMeta, data: Record<string, unknown>): Promise<unknown>;
+/**
+ * Updates an existing record by primary key, coercing form values.
+ * Returns null without calling Prisma for non-numeric id strings on number-type
+ * models.
+ */
+export declare function updateRecord(prisma: PrismaClientLike, model: AdminModelMeta, id: string, data: Record<string, unknown>): Promise<unknown>;
+/**
+ * Deletes a record by primary key.
+ * Returns early without calling Prisma for non-numeric id strings on number-type
+ * models.
+ */
+export declare function deleteRecord(prisma: PrismaClientLike, model: AdminModelMeta, id: string): Promise<void>;
+export {};
+//# sourceMappingURL=query.d.ts.map

package/dist/crud/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/crud/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAMnE,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC1C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACrC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAYvF;AAWD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,cAAc,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,cAAc,EACrB,IAAI,SAAI,GACP,OAAO,CAAC,aAAa,EAAE,CAAC,CAO1B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,2EAA2E;AAC3E,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzC,OAAO,CAAC,cAAc,CAAC,CAOzB;AAED,yEAAyE;AACzE,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,cAAc,EACrB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,mEAAmE;AACnE,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,cAAc,EACrB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,cAAc,EACrB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/crud/query.js

@@ -0,0 +1,137 @@
+import { MAX_RELATED_OPTIONS } from '../constants.js';
+/**
+ * Looks up the Prisma model delegate by camelCase model name.
+ * Throws a descriptive error if the delegate is not found.
+ */
+export function getDelegate(prisma, modelName) {
+    const key = modelName.charAt(0).toLowerCase() + modelName.slice(1);
+    const delegate = prisma[key];
+    if (delegate === null || delegate === undefined || typeof delegate !== 'object') {
+        throw new Error(`Admin: Prisma delegate not found for model "${modelName}". ` +
+            `Ensure the model exists in your schema and the client has been generated.`);
+    }
+    return delegate;
+}
+/**
+ * Parses a URL-segment id string to a number.
+ * Returns null for non-numeric strings, preventing NaN from reaching Prisma.
+ */
+function parseNumericId(id) {
+    const parsed = parseInt(id, 10);
+    return isNaN(parsed) ? null : parsed;
+}
+/**
+ * Coerces raw form string values to the correct JS types based on field metadata.
+ * Skips fields not present in model.formFields to prevent mass-assignment.
+ */
+export function coerceData(data, model) {
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        const field = model.formFields.find((f) => f.name === key);
+        if (field === undefined)
+            continue;
+        if (value === '' || value === null || value === undefined) {
+            result[key] = field.isRequired ? undefined : null;
+            continue;
+        }
+        switch (field.prismaType) {
+            case 'Int':
+            case 'Float':
+                result[key] = Number(value);
+                break;
+            case 'Boolean':
+                result[key] = value === 'true' || value === true;
+                break;
+            case 'DateTime':
+                result[key] = new Date(String(value));
+                break;
+            default:
+                result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Fetches a bounded page of related model records and maps them to { id, label }
+ * pairs for use in a <select> dropdown on the admin form.
+ * The label uses the model's displayField; falls back to the idField value.
+ *
+ * @param skip  Number of records to skip — used for load-more pagination.
+ */
+export async function fetchRelatedOptions(prisma, model, skip = 0) {
+    const delegate = getDelegate(prisma, model.name);
+    const records = (await delegate.findMany({ take: MAX_RELATED_OPTIONS, skip }));
+    return records.map((r) => ({
+        id: r[model.idField],
+        label: String(r[model.displayField] ?? r[model.idField] ?? ''),
+    }));
+}
+/** Fetches a paginated list of records and the total count in parallel. */
+export async function findMany(prisma, model, pagination) {
+    const delegate = getDelegate(prisma, model.name);
+    const [records, total] = await Promise.all([
+        delegate.findMany({ skip: pagination.skip, take: pagination.take }),
+        delegate.count({}),
+    ]);
+    return { records, total };
+}
+/** Returns only the record count for a model — used on the dashboard. */
+export async function countRecords(prisma, model) {
+    const delegate = getDelegate(prisma, model.name);
+    return delegate.count({});
+}
+/**
+ * Fetches a single record by its primary key.
+ * Returns null for non-numeric id strings on number-type models instead of
+ * passing NaN to Prisma.
+ */
+export async function findUnique(prisma, model, id) {
+    if (model.idType === 'number') {
+        const idValue = parseNumericId(id);
+        if (idValue === null)
+            return null;
+        const delegate = getDelegate(prisma, model.name);
+        return delegate.findUnique({ where: { [model.idField]: idValue } });
+    }
+    const delegate = getDelegate(prisma, model.name);
+    return delegate.findUnique({ where: { [model.idField]: id } });
+}
+/** Creates a new record, coercing form values to correct types. */
+export async function createRecord(prisma, model, data) {
+    const delegate = getDelegate(prisma, model.name);
+    return delegate.create({ data: coerceData(data, model) });
+}
+/**
+ * Updates an existing record by primary key, coercing form values.
+ * Returns null without calling Prisma for non-numeric id strings on number-type
+ * models.
+ */
+export async function updateRecord(prisma, model, id, data) {
+    if (model.idType === 'number') {
+        const idValue = parseNumericId(id);
+        if (idValue === null)
+            return null;
+        const delegate = getDelegate(prisma, model.name);
+        return delegate.update({ where: { [model.idField]: idValue }, data: coerceData(data, model) });
+    }
+    const delegate = getDelegate(prisma, model.name);
+    return delegate.update({ where: { [model.idField]: id }, data: coerceData(data, model) });
+}
+/**
+ * Deletes a record by primary key.
+ * Returns early without calling Prisma for non-numeric id strings on number-type
+ * models.
+ */
+export async function deleteRecord(prisma, model, id) {
+    if (model.idType === 'number') {
+        const idValue = parseNumericId(id);
+        if (idValue === null)
+            return;
+        const delegate = getDelegate(prisma, model.name);
+        await delegate.delete({ where: { [model.idField]: idValue } });
+        return;
+    }
+    const delegate = getDelegate(prisma, model.name);
+    await delegate.delete({ where: { [model.idField]: id } });
+}
+//# sourceMappingURL=query.js.map

package/dist/crud/query.js.map

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

package/dist/crud/router.d.ts

@@ -0,0 +1,49 @@
+import { Router } from 'express';
+import type { PrismaClientLike, AdminModelMeta, LoggerLike, AdminAuthLike } from '../types.js';
+/** Optional configuration for createAdminRouter. */
+export interface AdminRouterOptions {
+    /**
+     * Full unfiltered model metadata — used when fetching FK dropdown options so
+     * hidden models (e.g. User when showAuthModels is false) can still be queried.
+     * Defaults to `models`.
+     */
+    allMeta?: AdminModelMeta[];
+    /** Optional structured logger. Pass `app.logger` from createApp(). */
+    logger?: LoggerLike;
+    /**
+     * Better Auth instance. When any of the optional admin methods (`createUser`,
+     * `adminUpdateUser`, `removeUser`) are present, the corresponding verb for the
+     * user model is routed through the Better Auth admin API instead of Prisma.
+     */
+    auth?: AdminAuthLike;
+    /**
+     * Name of the Better Auth user model in your Prisma schema.
+     * Defaults to `'User'`.
+     */
+    betterAuthUserModel?: string;
+}
+/**
+ * Builds an Express Router containing all admin CRUD routes.
+ * The router should be mounted at the admin prefix via app.use(prefix, authMiddleware, router).
+ *
+ * @param prisma   Prisma client instance.
+ * @param models   Filtered model list (nav-visible models only).
+ * @param prefix   Route prefix the router is mounted at.
+ * @param options  Optional configuration — see AdminRouterOptions.
+ *
+ * Routes (all relative to mount prefix):
+ *   GET  /                              -> Admin/Dashboard
+ *   GET  /related-options/:relatedModel -> JSON { options, hasMore } for FK load-more
+ *   GET  /:model                        -> Admin/ModelIndex  (paginated list)
+ *   GET  /:model/new                    -> Admin/UserCreate  (when auth.api.createUser present)
+ *                                          Admin/ModelForm   (create form, otherwise)
+ *   GET  /:model/:id                    -> Admin/ModelForm   (edit form)
+ *   POST /:model                        -> Better Auth createUser (when auth.api.createUser present)
+ *                                          create record via Prisma, otherwise
+ *   PATCH /:model/:id                   -> Better Auth adminUpdateUser (when auth.api.adminUpdateUser present)
+ *                                          update record via Prisma, otherwise
+ *   DELETE /:model/:id                  -> Better Auth removeUser (when auth.api.removeUser present)
+ *                                          delete record via Prisma, otherwise
+ */
+export declare function createAdminRouter(prisma: PrismaClientLike, models: AdminModelMeta[], prefix: string, options?: AdminRouterOptions): Router;
+//# sourceMappingURL=router.d.ts.map

package/dist/crud/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/crud/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAEhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AA+B9F,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,EAAE,CAAA;IAC1B,sEAAsE;IACtE,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAuCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,cAAc,EAAE,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAmSR"}