@lovrozagar/oat 0.1.0

package/dist/reference/spec.js

@@ -0,0 +1,547 @@
+/**
+ * Generates the reference backend's OpenAPI document from the entity model, fully annotated with
+ * the meta tags in the README. This is the "ideal citizen" spec: everything oat wants to know
+ * is declared, so a run against the clean baseline exercises the tag path rather than the
+ * heuristic fallbacks. The conformance suite also serves stripped variants to test the fallbacks.
+ */
+import { POSTGREST } from "./dialect.js";
+import { ENTITIES, JOB, TABLE, fieldsWhere, writableFields } from "./model.js";
+function fieldSchema(field) {
+    const base = { type: field.type };
+    if (field.enum !== undefined)
+        base.enum = [...field.enum];
+    if (field.maxLength !== undefined)
+        base.maxLength = field.maxLength;
+    if (field.generated === true)
+        base.readOnly = true;
+    if (field.nullable === true)
+        return { oneOf: [base, { type: "null" }] };
+    return base;
+}
+function itemSchema(entity) {
+    const properties = {};
+    for (const field of entity.fields)
+        properties[field.name] = fieldSchema(field);
+    return {
+        additionalProperties: false,
+        properties,
+        required: entity.fields.filter((f) => f.required === true).map((f) => f.name),
+        type: "object",
+    };
+}
+function bodySchema(entity, phase) {
+    const properties = {};
+    for (const field of writableFields(entity, phase))
+        properties[field.name] = fieldSchema(field);
+    return {
+        additionalProperties: false,
+        properties,
+        required: phase === "create" ? writableFields(entity, "create").filter((f) => f.required === true).map((f) => f.name) : [],
+        type: "object",
+    };
+}
+/** The collection's property name under a dialect — entity-named, or a fixed key like `data`. */
+function collectionKey(entity, dialect) {
+    return dialect.envelope?.collection ?? entity.plural;
+}
+function listSchema(entity, dialect) {
+    const env = dialect.envelope;
+    /* No envelope: the response *is* the array. A document that says so is the only place oat can
+     * learn it, so the schema has to say it rather than describe a wrapper that does not exist. */
+    if (env === null)
+        return { items: itemSchema(entity), type: "array" };
+    const key = collectionKey(entity, dialect);
+    const properties = {
+        [env.hasMore]: { type: "boolean" },
+        [env.limit]: { minimum: 1, type: "integer" },
+        [env.page]: { oneOf: [{ minimum: 1, type: "integer" }, { type: "null" }] },
+        [env.total]: { minimum: 0, type: "integer" },
+        [key]: { items: itemSchema(entity), type: "array" },
+    };
+    const required = [env.hasMore, env.limit, env.page, env.total, key];
+    if (env.nextCursor !== undefined) {
+        properties[env.nextCursor] = { oneOf: [{ type: "string" }, { type: "null" }] };
+        required.push(env.nextCursor);
+    }
+    return { additionalProperties: false, properties, required, type: "object" };
+}
+function errorSchema(status, key) {
+    return {
+        additionalProperties: false,
+        properties: {
+            error_key: { enum: [key], type: "string" },
+            message: { type: "string" },
+            status: { enum: [status], type: "integer" },
+            success: { const: false },
+        },
+        required: ["error_key", "message", "status", "success"],
+        type: "object",
+    };
+}
+const ERRORS = [
+    [400, "invalid_input"],
+    [401, "unauthorized"],
+    [403, "forbidden"],
+    [404, "not_found"],
+    [415, "unsupported_media_type"],
+];
+function errorResponses(codes) {
+    const out = {};
+    for (const [status, key] of ERRORS) {
+        if (!codes.includes(status))
+            continue;
+        out[String(status)] = {
+            content: { "application/json": { schema: { $ref: `#/components/schemas/Err${status}` } } },
+            description: key,
+        };
+    }
+    return out;
+}
+function jsonResponse(description, schema, headers) {
+    const response = { content: { "application/json": { schema } }, description };
+    if (headers !== undefined)
+        response.headers = headers;
+    return response;
+}
+/** RFC 8288 pagination links, declared only by dialects that actually publish them. */
+function listResponseHeaders(dialect) {
+    if (dialect.envelope !== null)
+        return undefined;
+    return {
+        Link: {
+            description: 'Pagination links; rel="next" is present while further pages remain',
+            schema: { type: "string" },
+        },
+    };
+}
+/**
+ * The sort parameter's description, demonstrating the grammar this dialect expects.
+ *
+ * A document that expects `-created_at` and describes `field.asc` is lying, and oat would infer
+ * the wrong grammar from it — correctly, since the document is the only thing it can read.
+ */
+function sortDescription(dialect) {
+    switch (dialect.sortGrammar ?? "dotted") {
+        case "prefixed":
+            return "Sort by field; prefix with - for descending. e.g. -created_at, name";
+        case "colon":
+            return "Sort: field:asc or field:desc, comma-separated. e.g. created_at:desc";
+        case "spaced":
+            return "Sort: field asc or field desc, comma-separated. e.g. created_at desc";
+        case "dotted":
+            return "Sort: field[.asc|.desc][.nullsfirst|.nullslast], comma-separated";
+    }
+}
+function listQueryParams(dialect, entity) {
+    const p = dialect.params;
+    const filterDescription = dialect.grammar === "postgrest"
+        ? "PostgREST-style filter expression: field.op.value, and(...), or(...)"
+        : "Filter expression: field=op:value, comma-separated. e.g. status=eq:active";
+    const params = [];
+    if (dialect.grammar === "equality") {
+        /* One parameter per filterable field, which *is* the filter language here. Declaring them
+         * individually is the only way a document can express this shape, and it is how oat learns
+         * what may be filtered on. */
+        for (const field of fieldsWhere(entity, "filterable")) {
+            const declared = entity.fields.find((f) => f.name === field);
+            const numeric = declared?.type === "integer" || declared?.type === "number";
+            params.push([
+                field,
+                declared?.enum === undefined
+                    ? { type: numeric ? "number" : "string" }
+                    : { enum: declared.enum, type: "string" },
+                `Exact match on ${field}`,
+            ]);
+        }
+    }
+    else {
+        params.push([p.filter, { type: "string" }, filterDescription]);
+    }
+    params.push([p.order, { type: "string" }, sortDescription(dialect)], [
+        /* JSON:API carries the resource type in the parameter *name*, so the name itself is
+         * part of the grammar and has to be declared per entity. */
+        dialect.selectGrammar === "bracketed" ? `${p.select}[${entity.name}]` : p.select,
+        { type: "string" },
+        "Comma-separated sparse fieldset; * selects all",
+    ], [p.search, { maxLength: 200, type: "string" }, "Free-text search across searchable fields"]);
+    /* Exactly one paging model is published, because that is what a real document does — and a
+     * document advertising a parameter the backend ignores is itself a defect oat reports. */
+    if (p.page !== undefined) {
+        params.push([p.page, { minimum: 1, type: "integer" }, "1-based page number"]);
+    }
+    if (p.offset !== undefined) {
+        params.push([p.offset, { minimum: 0, type: "integer" }, "Number of records to skip"]);
+    }
+    if (p.cursor !== undefined) {
+        params.push([p.cursor, { type: "string" }, "Opaque forward cursor; takes precedence over page"]);
+    }
+    return params;
+}
+function pathParams(entity, includeItem) {
+    const params = entity.parents.map((name) => ({
+        in: "path",
+        name,
+        required: true,
+        schema: { type: "string" },
+        ...(name === "project_id" ? { "x-root": true } : {}),
+    }));
+    if (includeItem) {
+        params.push({ in: "path", name: entity.itemParam, required: true, schema: { type: "string" } });
+    }
+    return params;
+}
+function tenantParam(entity) {
+    return entity.parents[0] ?? "project_id";
+}
+/**
+ * Read routes belonging to an entity's parent, when a write here changes what they serve.
+ *
+ * Only the table/row relationship qualifies in this fixture: a table publishes `row_count`, so a
+ * row write genuinely changes the table's representation. Declaring routes that a write does not
+ * actually affect would make the invalidation check assert something false.
+ */
+function parentReadRoutes(entity) {
+    if (entity.name !== "row")
+        return [];
+    const table = ENTITIES.find((candidate) => candidate.name === "table");
+    if (table === undefined)
+        return [];
+    return [`GET ${table.collectionPath}`, `GET ${table.itemPath}`];
+}
+function buildEntityPaths(entity, dialect) {
+    const listRoute = `GET ${entity.collectionPath}`;
+    const itemRoute = `GET ${entity.itemPath}`;
+    const surface = [listRoute, itemRoute];
+    const title = entity.name[0]?.toUpperCase() + entity.name.slice(1);
+    const query = {
+        /* Declared rather than inferred: the grammar decides what oat can even express. */
+        grammar: dialect.grammar,
+        filterable: fieldsWhere(entity, "filterable"),
+        maxLimit: entity.maxLimit,
+        searchable: fieldsWhere(entity, "searchable"),
+        selectable: entity.fields.map((f) => f.name),
+        sortable: fieldsWhere(entity, "sortable"),
+        stableTiebreak: entity.identity,
+    };
+    const collection = {
+        get: {
+            operationId: `${entity.name}.list`,
+            parameters: [
+                ...pathParams(entity, false),
+                ...listQueryParams(dialect, entity).map(([name, schema, description]) => ({
+                    description,
+                    in: "query",
+                    name,
+                    required: false,
+                    schema,
+                })),
+                {
+                    in: "query",
+                    name: dialect.params.limit,
+                    required: false,
+                    schema: { default: entity.defaultLimit, maximum: entity.maxLimit, minimum: 1, type: "integer" },
+                },
+            ],
+            responses: {
+                "200": jsonResponse(`List ${entity.plural}`, listSchema(entity, dialect), listResponseHeaders(dialect)),
+                ...errorResponses([400, 401, 403, 404]),
+            },
+            summary: `List ${entity.plural}`,
+            tags: [title],
+            "x-entity": { action: "list", identity: entity.identity, name: entity.name },
+            "x-query": query,
+            "x-tenant": tenantParam(entity),
+            ...(entity.softDeleteField === undefined ? {} : { "x-soft-delete": entity.softDeleteField }),
+        },
+        post: {
+            operationId: `${entity.name}.create`,
+            parameters: [
+                ...pathParams(entity, false),
+                /* Declared as an ordinary header parameter, because that is how real APIs publish
+                 * it. oat needs no new meta tag to find this: a create operation naming a header
+                 * whose name reads as an idempotency key is enough to know replay is promised. */
+                {
+                    description: "Client-supplied key. Replaying a request with the same key must return the "
+                        + "original result rather than creating a second record.",
+                    in: "header",
+                    name: "Idempotency-Key",
+                    required: false,
+                    schema: { type: "string" },
+                },
+            ],
+            requestBody: {
+                content: { "application/json": { schema: bodySchema(entity, "create") } },
+                required: true,
+            },
+            responses: {
+                "201": jsonResponse(`Created ${entity.name}`, itemSchema(entity)),
+                ...errorResponses([400, 401, 403, 404, 415]),
+            },
+            summary: `Create ${entity.name}`,
+            tags: [title],
+            "x-entity": { action: "create", identity: entity.identity, name: entity.name },
+            "x-generated": fieldsWhere(entity, "generated"),
+            /*
+             * A create invalidates its own listing, and — where the entity has a parent that
+             * carries a derived value — the parent's routes as well. Declaring it is what makes
+             * the cross-entity consistency testable rather than assumed.
+             */
+            "x-invalidate": [listRoute, ...parentReadRoutes(entity)],
+            "x-tenant": tenantParam(entity),
+        },
+    };
+    const item = {
+        delete: {
+            operationId: `${entity.name}.delete`,
+            parameters: pathParams(entity, true),
+            responses: {
+                "200": jsonResponse(`Deleted ${entity.name}`, itemSchema(entity)),
+                ...errorResponses([400, 401, 403, 404]),
+            },
+            summary: `Delete ${entity.name}`,
+            tags: [title],
+            "x-entity": { action: "delete", identity: entity.identity, name: entity.name },
+            "x-invalidate": surface,
+            "x-tenant": tenantParam(entity),
+            ...(entity.softDeleteField === undefined ? {} : { "x-soft-delete": entity.softDeleteField }),
+        },
+        get: {
+            operationId: `${entity.name}.get`,
+            parameters: pathParams(entity, true),
+            responses: {
+                "200": jsonResponse(entity.name, itemSchema(entity)),
+                ...errorResponses([400, 401, 403, 404]),
+            },
+            summary: `Get ${entity.name}`,
+            tags: [title],
+            "x-entity": { action: "read", identity: entity.identity, name: entity.name },
+            "x-tenant": tenantParam(entity),
+        },
+        patch: {
+            operationId: `${entity.name}.update`,
+            parameters: pathParams(entity, true),
+            requestBody: {
+                content: { "application/json": { schema: bodySchema(entity, "update") } },
+                required: true,
+            },
+            responses: {
+                "200": jsonResponse(`Updated ${entity.name}`, itemSchema(entity)),
+                ...errorResponses([400, 401, 403, 404, 415]),
+            },
+            summary: `Update ${entity.name}`,
+            tags: [title],
+            "x-entity": { action: "update", identity: entity.identity, name: entity.name },
+            /* Declared here as well as on create. Real documents often list server-owned fields
+             * only where they are conspicuous — the fields a caller may not supply — and a tool
+             * that reads just one operation then treats a generated field as client-owned. */
+            "x-generated": fieldsWhere(entity, "generated"),
+            "x-immutable": entity.fields.filter((f) => f.immutable === true).map((f) => f.name),
+            "x-invalidate": surface,
+            "x-tenant": tenantParam(entity),
+        },
+    };
+    return { [entity.collectionPath]: collection, [entity.itemPath]: item };
+}
+export function buildSpec(dialect = POSTGREST) {
+    const paths = {};
+    for (const entity of ENTITIES)
+        Object.assign(paths, buildEntityPaths(entity, dialect));
+    paths[`${TABLE.itemPath}/invites`] = {
+        post: {
+            operationId: "table.invite",
+            parameters: pathParams(TABLE, true),
+            requestBody: {
+                content: {
+                    "application/json": {
+                        schema: {
+                            additionalProperties: false,
+                            properties: { key: { type: "string" } },
+                            required: ["key"],
+                            type: "object",
+                        },
+                    },
+                },
+                required: true,
+            },
+            responses: {
+                "201": jsonResponse("Invite created", {
+                    additionalProperties: false,
+                    properties: { grant_id: { type: "string" }, token: { type: "string" } },
+                    required: ["grant_id", "token"],
+                    type: "object",
+                }),
+                ...errorResponses([400, 401, 403, 404, 415]),
+            },
+            summary: "Invite another principal to read this table",
+            tags: ["Table"],
+            "x-entity": { action: "action", identity: TABLE.identity, name: TABLE.name },
+            "x-invite": {
+                accept: "invite.accept",
+                grantPointer: "$.grant_id",
+                granteeField: "key",
+                invite: "table.invite",
+                revoke: "table.revoke",
+                tokenPointer: "$.token",
+            },
+            "x-tenant": tenantParam(TABLE),
+        },
+    };
+    paths["/v1/invites/{token}/accept"] = {
+        post: {
+            operationId: "invite.accept",
+            parameters: [
+                { in: "path", name: "token", required: true, schema: { type: "string" } },
+            ],
+            responses: {
+                "200": jsonResponse("Invite accepted", {
+                    additionalProperties: false,
+                    properties: { accepted: { type: "boolean" } },
+                    required: ["accepted"],
+                    type: "object",
+                }),
+                ...errorResponses([400, 401, 404]),
+            },
+            summary: "Accept an invite",
+            tags: ["Table"],
+            "x-entity": { action: "action", identity: TABLE.identity, name: TABLE.name },
+        },
+    };
+    paths[`${TABLE.itemPath}/grants/{grant_id}`] = {
+        delete: {
+            operationId: "table.revoke",
+            parameters: [
+                ...pathParams(TABLE, true),
+                { in: "path", name: "grant_id", required: true, schema: { type: "string" } },
+            ],
+            responses: {
+                "200": jsonResponse("Grant revoked", {
+                    additionalProperties: false,
+                    properties: { revoked: { type: "boolean" } },
+                    required: ["revoked"],
+                    type: "object",
+                }),
+                ...errorResponses([400, 401, 403, 404]),
+            },
+            summary: "Revoke a grant",
+            tags: ["Table"],
+            "x-entity": { action: "action", identity: TABLE.identity, name: TABLE.name },
+            "x-tenant": tenantParam(TABLE),
+        },
+    };
+    /* The async lifecycle: a start operation returning a receipt, and a poll route that
+     * eventually reports a terminal state. x-async ties the two together. */
+    paths[`${JOB.collectionPath}/start`] = {
+        post: {
+            operationId: "job.start",
+            parameters: pathParams(JOB, false),
+            requestBody: {
+                content: {
+                    "application/json": {
+                        schema: {
+                            additionalProperties: false,
+                            properties: { name: { maxLength: 128, minLength: 1, type: "string" } },
+                            required: ["name"],
+                            type: "object",
+                        },
+                    },
+                },
+                required: true,
+            },
+            responses: {
+                "202": jsonResponse("Job accepted", {
+                    additionalProperties: false,
+                    properties: { accepted: { type: "boolean" }, job_id: { type: "string" } },
+                    required: ["job_id", "accepted"],
+                    type: "object",
+                }),
+                ...errorResponses([400, 401, 403, 404, 415]),
+            },
+            summary: "Start a job",
+            tags: ["Job"],
+            "x-async": {
+                idFrom: "$.job_id",
+                poll: `GET ${JOB.itemPath}`,
+                pollIntervalMs: 20,
+                successWhen: "status.eq.complete",
+                timeoutMs: 3000,
+                until: "status.in.(complete,failed)",
+            },
+            "x-effects": [{ count: 1, entity: "job", op: "create" }],
+            "x-entity": { action: "action", identity: "id", name: "job" },
+            "x-tenant": tenantParam(JOB),
+        },
+    };
+    paths["/v1/auth/token"] = {
+        post: {
+            operationId: "auth.token",
+            requestBody: {
+                content: {
+                    "application/json": {
+                        schema: {
+                            additionalProperties: false,
+                            properties: { key: { type: "string" } },
+                            required: ["key"],
+                            type: "object",
+                        },
+                    },
+                },
+                required: true,
+            },
+            responses: {
+                "200": jsonResponse("Access token", {
+                    additionalProperties: false,
+                    properties: {
+                        access_token: { type: "string" },
+                        expires_in: { type: "integer" },
+                        project_id: { type: "string" },
+                    },
+                    required: ["access_token", "expires_in", "project_id"],
+                    type: "object",
+                }),
+                ...errorResponses([400, 401, 415]),
+            },
+            security: [],
+            summary: "Exchange an API key for an access token",
+            tags: ["Auth"],
+        },
+    };
+    const schemas = {};
+    for (const [status, key] of ERRORS)
+        schemas[`Err${status}`] = errorSchema(status, key);
+    return {
+        components: {
+            schemas,
+            securitySchemes: { bearer: { bearerFormat: "JWT", scheme: "bearer", type: "http" } },
+        },
+        info: { title: "oat reference backend", version: "1.0.0" },
+        openapi: "3.1.0",
+        paths,
+        security: [{ bearer: [] }],
+        "x-auth-flows": {
+            default: {
+                acquire: { credential: "$.access_token", operationId: "auth.token" },
+                expiresIn: "$.expires_in",
+                inject: { header: "authorization", template: "Bearer {credential}" },
+            },
+        },
+    };
+}
+/** Variant with every oat meta tag removed — exercises the heuristic fallbacks. */
+export function buildUntaggedSpec(dialect = POSTGREST) {
+    const spec = buildSpec(dialect);
+    const strip = (node) => {
+        if (Array.isArray(node))
+            return node.map(strip);
+        if (node === null || typeof node !== "object")
+            return node;
+        const out = {};
+        for (const [key, value] of Object.entries(node)) {
+            if (key.startsWith("x-") && key !== "x-root")
+                continue;
+            out[key] = strip(value);
+        }
+        return out;
+    };
+    return strip(spec);
+}
+//# sourceMappingURL=spec.js.map

package/dist/reference/spec.js.map

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

package/dist/reference/store-api.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Storage contract shared by the reference backends.
+ *
+ * One HTTP server implementation runs against every store, so a defect is defined once and
+ * exercised on each engine. Where two engines disagree about what a defect *does*, that is
+ * itself the finding — SQLite and Postgres differ on NULL ordering, type discipline, collation
+ * and case-insensitive matching, and those are exactly the semantics oat's checks reason about.
+ *
+ * Async throughout, because a real database is: SQLite implementations resolve immediately.
+ */
+import type { EntityDef } from "./model.ts";
+export type Row = Record<string, unknown>;
+export interface QueryParams {
+    filter?: string | undefined;
+    order?: string | undefined;
+    select?: string | undefined;
+    q?: string | undefined;
+    limit?: number | undefined;
+    page?: number | undefined;
+    cursor?: string | undefined;
+}
+export interface QueryOptions {
+    softDeleteField?: string | undefined;
+    /**
+     * Applied to each row *before* the sparse fieldset, so a derived value cannot reintroduce a
+     * column the caller deselected.
+     */
+    transform?: ((row: Row) => Row) | undefined;
+}
+export interface QueryResult {
+    items: Row[];
+    count: number;
+    hasMore: boolean;
+    nextCursor: string | null;
+    page: number | null;
+    limit: number;
+}
+export interface Store {
+    close(): Promise<void>;
+    nextId(prefix: string): string;
+    now(): number;
+    insert(entity: EntityDef, record: Row): Promise<Row>;
+    byId(entity: EntityDef, id: string): Promise<Row | null>;
+    update(entity: EntityDef, id: string, patch: Row): Promise<Row | null>;
+    remove(entity: EntityDef, id: string): Promise<void>;
+    query(entity: EntityDef, scope: Record<string, string>, params: QueryParams, options: QueryOptions): Promise<QueryResult>;
+}
+/** Raised for input the storage layer rejects — surfaces as 400, or 500 under the defect. */
+export declare class SqlError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function encodeCursor(id: string): string;
+export declare function decodeCursor(cursor: string): string;
+/** Splits on commas at paren depth zero — shared by the filter and order grammars. */
+export declare function splitTopLevel(input: string): string[];
+export declare function stripParens(value: string): string;
+export declare function project(row: Row, select: string | undefined, ignore: boolean, excluded?: readonly string[]): Row;
+//# sourceMappingURL=store-api.d.ts.map

package/dist/reference/store-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-api.d.ts","sourceRoot":"","sources":["../../src/reference/store-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEzC,MAAM,WAAW,WAAW;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY;IAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC,GAAG,SAAS,CAAA;CAC3C;AAED,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,GAAG,EAAE,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,KAAK;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IAC9B,GAAG,IAAI,MAAM,CAAA;IACb,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACpD,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAA;IACxD,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAA;IACtE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,KAAK,CACJ,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,WAAW,CAAC,CAAA;CACvB;AAED,6FAA6F;AAC7F,qBAAa,QAAS,SAAQ,KAAK;IAEjC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAIhB;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAerD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,OAAO,CACtB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,OAAO,EAIf,QAAQ,GAAE,SAAS,MAAM,EAAO,GAC9B,GAAG,CAaL"}