@relayfile/adapter-confluence 0.1.0

package/discovery/confluence/.adapter.md

@@ -0,0 +1,72 @@
+# Confluence adapter
+
+The Confluence adapter exposes spaces and pages under `/confluence`, with writeback routes for creating, updating, and deleting pages.
+
+Read-only mounts:
+- `/confluence/spaces/<spaceIdOrKey>.json` - Space records.
+- `/confluence/pages/<pageId>.json` - Flat page records.
+- `/confluence/spaces/<spaceIdOrKey>/pages/<pageId>.json` - Space-scoped page records.
+
+Resources:
+
+| Resource | Schema | Create example | ID pattern | What it does |
+|---|---|---|---|---|
+| `/confluence/pages/<id>.json` | `/confluence/pages/.schema.json` | `/confluence/pages/.create.example.json` | `^(?:[A-Za-z0-9_.~-]+--)?\d+$` | Creates a Confluence page when `spaceId` is supplied in the document. |
+| `/confluence/spaces/{spaceIdOrKey}/pages/<id>.json` | `/confluence/spaces/{spaceIdOrKey}/pages/.schema.json` | `/confluence/spaces/{spaceIdOrKey}/pages/.create.example.json` | `^(?:[A-Za-z0-9_.~-]+--)?\d+$` | Creates a Confluence page in the space named by the path. |
+
+## Operations
+
+| To... | Do... |
+|---|---|
+| Read | `cat <id>.json` |
+| Edit | Write a partial JSON object to `<id>.json`. Only included mutable fields PATCH; fields marked `readOnly` in `.schema.json` are rejected. |
+| Create | Write JSON to any non-canonical filename such as `create request.json`. The adapter creates the record at `<real-id>.json` and rewrites the draft as `{ "created": "<real-id>", "path": "<resource>/<real-id>.json", "url": "<provider-url>" }`. |
+| Delete | `rm <id>.json` for canonical ids. |
+
+## ID Patterns
+- `/confluence/pages/<id>.json`: `^(?:[A-Za-z0-9_.~-]+--)?\d+$`. Filenames that do not match this pattern are treated as create drafts.
+- `/confluence/spaces/{spaceIdOrKey}/pages/<id>.json`: `^(?:[A-Za-z0-9_.~-]+--)?\d+$`. Filenames that do not match this pattern are treated as create drafts.
+
+## Write field contracts
+
+### Create Confluence page
+
+Resource: `/confluence/pages/<id>.json`
+Schema: `/confluence/pages/.schema.json`
+Create example: `/confluence/pages/.create.example.json`
+Required fields: `title`, `spaceId`, `body`.
+Optional fields: `status`, `parentId`, `version`.
+
+Fields:
+
+- `title` (required, string) - Page title.
+- `spaceId` (required, string) - Confluence space id.
+- `status` (optional, enum) - Page status. Defaults to current. Allowed values: `current`, `draft`.
+- `parentId` (optional, string) - Optional parent page id.
+- `body` (required, one of string, object) - Confluence page body as a storage-format string or a body object with `value`/`representation` or `storage.value`.
+- `version` (optional, object) - Optional synced version object. Updates increment `version.number` when present.
+- `version.number` (optional, integer) - Current Confluence version number.
+- `version.message` (optional, string) - Version message.
+- `version.minorEdit` (optional, boolean) - Whether the update is a minor edit.
+
+### Create Confluence space page
+
+Resource: `/confluence/spaces/{spaceIdOrKey}/pages/<id>.json`
+Schema: `/confluence/spaces/{spaceIdOrKey}/pages/.schema.json`
+Create example: `/confluence/spaces/{spaceIdOrKey}/pages/.create.example.json`
+Required fields: `title`, `body`.
+Optional fields: `status`, `parentId`, `version`.
+
+Fields:
+
+- `title` (required, string) - Page title.
+- `status` (optional, enum) - Page status. Defaults to current. Allowed values: `current`, `draft`.
+- `parentId` (optional, string) - Optional parent page id.
+- `body` (required, one of string, object) - Confluence page body as a storage-format string or a body object with `value`/`representation` or `storage.value`.
+- `version` (optional, object) - Optional synced version object. Updates increment `version.number` when present.
+- `version.number` (optional, integer) - Current Confluence version number.
+- `version.message` (optional, string) - Version message.
+- `version.minorEdit` (optional, boolean) - Whether the update is a minor edit.
+
+## Create Examples
+Read the resource `.schema.json` first, then use the sibling `.create.example.json` as a minimal create document. The example intentionally omits read-only fields.

package/discovery/confluence/pages/.create.example.json

@@ -0,0 +1,5 @@
+{
+  "title": "Replace example page title",
+  "spaceId": "12345",
+  "body": "<p>Replace example page body.</p>"
+}

package/discovery/confluence/pages/.schema.json

@@ -0,0 +1,171 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Confluence page",
+  "type": "object",
+  "required": [
+    "title",
+    "spaceId",
+    "body"
+  ],
+  "properties": {
+    "title": {
+      "type": "string",
+      "description": "Page title.",
+      "minLength": 1
+    },
+    "spaceId": {
+      "type": "string",
+      "description": "Confluence space id."
+    },
+    "status": {
+      "enum": [
+        "current",
+        "draft"
+      ],
+      "description": "Page status. Defaults to current."
+    },
+    "parentId": {
+      "type": "string",
+      "description": "Optional parent page id."
+    },
+    "body": {
+      "description": "Confluence page body as a storage-format string or a body object with `value`/`representation` or `storage.value`.",
+      "oneOf": [
+        {
+          "type": "string",
+          "minLength": 1
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": [
+            "value",
+            "representation"
+          ],
+          "properties": {
+            "value": {
+              "type": "string",
+              "minLength": 1
+            },
+            "representation": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": [
+            "storage"
+          ],
+          "properties": {
+            "storage": {
+              "type": "object",
+              "additionalProperties": true,
+              "required": [
+                "value"
+              ],
+              "properties": {
+                "value": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "representation": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "version": {
+      "type": "object",
+      "description": "Optional synced version object. Updates increment `version.number` when present.",
+      "properties": {
+        "number": {
+          "type": "integer",
+          "description": "Current Confluence version number.",
+          "minimum": 1
+        },
+        "message": {
+          "type": "string",
+          "description": "Version message."
+        },
+        "minorEdit": {
+          "type": "boolean",
+          "description": "Whether the update is a minor edit."
+        }
+      },
+      "additionalProperties": true
+    },
+    "id": {
+      "type": "string",
+      "description": "Provider canonical record id.",
+      "readOnly": true
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Provider creation timestamp.",
+      "readOnly": true
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Provider last update timestamp.",
+      "readOnly": true
+    },
+    "url": {
+      "type": "string",
+      "format": "uri",
+      "description": "Provider URL for the record.",
+      "readOnly": true
+    },
+    "identifier": {
+      "type": "string",
+      "description": "Provider human-readable identifier or key.",
+      "readOnly": true
+    },
+    "provider": {
+      "type": "string",
+      "description": "Relayfile provider name.",
+      "readOnly": true
+    },
+    "objectType": {
+      "type": "string",
+      "description": "Relayfile object type.",
+      "readOnly": true
+    },
+    "objectId": {
+      "type": "string",
+      "description": "Relayfile object id.",
+      "readOnly": true
+    },
+    "workspaceId": {
+      "type": "string",
+      "description": "Relayfile workspace id.",
+      "readOnly": true
+    },
+    "connectionId": {
+      "type": "string",
+      "description": "Relayfile connection id.",
+      "readOnly": true
+    },
+    "_webhook": {
+      "type": "object",
+      "description": "Provider webhook metadata captured during sync.",
+      "readOnly": true,
+      "additionalProperties": true
+    },
+    "_connection": {
+      "type": "object",
+      "description": "Relayfile connection metadata captured during sync.",
+      "readOnly": true,
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false,
+  "description": "Full resource record schema. Fields marked readOnly are synced from the provider and cannot be written by agents."
+}

package/discovery/confluence/spaces/{spaceIdOrKey}/pages/.create.example.json

@@ -0,0 +1,4 @@
+{
+  "title": "Replace example page title",
+  "body": "<p>Replace example page body.</p>"
+}

package/discovery/confluence/spaces/{spaceIdOrKey}/pages/.schema.json

@@ -0,0 +1,166 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Confluence space page",
+  "type": "object",
+  "required": [
+    "title",
+    "body"
+  ],
+  "properties": {
+    "title": {
+      "type": "string",
+      "description": "Page title.",
+      "minLength": 1
+    },
+    "status": {
+      "enum": [
+        "current",
+        "draft"
+      ],
+      "description": "Page status. Defaults to current."
+    },
+    "parentId": {
+      "type": "string",
+      "description": "Optional parent page id."
+    },
+    "body": {
+      "description": "Confluence page body as a storage-format string or a body object with `value`/`representation` or `storage.value`.",
+      "oneOf": [
+        {
+          "type": "string",
+          "minLength": 1
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": [
+            "value",
+            "representation"
+          ],
+          "properties": {
+            "value": {
+              "type": "string",
+              "minLength": 1
+            },
+            "representation": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": true,
+          "required": [
+            "storage"
+          ],
+          "properties": {
+            "storage": {
+              "type": "object",
+              "additionalProperties": true,
+              "required": [
+                "value"
+              ],
+              "properties": {
+                "value": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "representation": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "version": {
+      "type": "object",
+      "description": "Optional synced version object. Updates increment `version.number` when present.",
+      "properties": {
+        "number": {
+          "type": "integer",
+          "description": "Current Confluence version number.",
+          "minimum": 1
+        },
+        "message": {
+          "type": "string",
+          "description": "Version message."
+        },
+        "minorEdit": {
+          "type": "boolean",
+          "description": "Whether the update is a minor edit."
+        }
+      },
+      "additionalProperties": true
+    },
+    "id": {
+      "type": "string",
+      "description": "Provider canonical record id.",
+      "readOnly": true
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Provider creation timestamp.",
+      "readOnly": true
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Provider last update timestamp.",
+      "readOnly": true
+    },
+    "url": {
+      "type": "string",
+      "format": "uri",
+      "description": "Provider URL for the record.",
+      "readOnly": true
+    },
+    "identifier": {
+      "type": "string",
+      "description": "Provider human-readable identifier or key.",
+      "readOnly": true
+    },
+    "provider": {
+      "type": "string",
+      "description": "Relayfile provider name.",
+      "readOnly": true
+    },
+    "objectType": {
+      "type": "string",
+      "description": "Relayfile object type.",
+      "readOnly": true
+    },
+    "objectId": {
+      "type": "string",
+      "description": "Relayfile object id.",
+      "readOnly": true
+    },
+    "workspaceId": {
+      "type": "string",
+      "description": "Relayfile workspace id.",
+      "readOnly": true
+    },
+    "connectionId": {
+      "type": "string",
+      "description": "Relayfile connection id.",
+      "readOnly": true
+    },
+    "_webhook": {
+      "type": "object",
+      "description": "Provider webhook metadata captured during sync.",
+      "readOnly": true,
+      "additionalProperties": true
+    },
+    "_connection": {
+      "type": "object",
+      "description": "Relayfile connection metadata captured during sync.",
+      "readOnly": true,
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false,
+  "description": "Full resource record schema. Fields marked readOnly are synced from the provider and cannot be written by agents."
+}

package/dist/__tests__/confluence-adapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=confluence-adapter.test.d.ts.map

package/dist/__tests__/confluence-adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confluence-adapter.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/confluence-adapter.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/confluence-adapter.test.js

@@ -0,0 +1,150 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { ConfluenceAdapter, } from '../confluence-adapter.js';
+import { computeConfluencePath, confluencePagePath, confluenceSpacePath, } from '../path-mapper.js';
+import { resolveConfluenceReadRequest } from '../queries.js';
+import { ReadOnlyFieldError, resolveConfluenceDeleteRequest, resolveConfluenceWritebackRequest, } from '../writeback.js';
+function createClient() {
+    return {
+        writes: [],
+        deletes: [],
+        async writeFile(input) {
+            this.writes.push(input);
+            return { created: true };
+        },
+        async deleteFile(input) {
+            this.deletes.push(input);
+        },
+    };
+}
+function createAdapter(client = createClient()) {
+    const provider = {
+        name: 'confluence',
+        async proxy() {
+            return { status: 200, headers: {}, data: {} };
+        },
+        async healthCheck() {
+            return true;
+        },
+    };
+    return new ConfluenceAdapter(client, provider, { connectionId: 'conn-confluence' });
+}
+describe('ConfluenceAdapter', () => {
+    it('computes deterministic Confluence paths', () => {
+        assert.equal(computeConfluencePath('space', '12345', { title: 'Engineering Docs' }), '/confluence/spaces/engineering-docs--12345.json');
+        assert.equal(computeConfluencePath('page', '98765', { title: 'Release Plan', spaceId: '12345' }), '/confluence/spaces/12345/pages/release-plan--98765.json');
+    });
+    it('materializes spaces and pages from Nango-style sync records', () => {
+        const adapter = createAdapter();
+        assert.deepEqual(adapter.materializeSpace({ id: '12345', key: 'ENG', name: 'Engineering' }), {
+            path: '/confluence/spaces/engineering--12345.json',
+            payload: {
+                provider: 'confluence',
+                objectType: 'space',
+                objectId: '12345',
+                payload: { id: '12345', key: 'ENG', name: 'Engineering' },
+            },
+        });
+        assert.equal(adapter.materializePage({ id: '98765', title: 'Release Plan', spaceId: '12345' }).path, '/confluence/spaces/12345/pages/release-plan--98765.json');
+    });
+    it('ingests page events with space relations and body comments', async () => {
+        const client = createClient();
+        const adapter = createAdapter(client);
+        const result = await adapter.ingestWebhook('workspace-1', {
+            provider: 'confluence',
+            eventType: 'page.updated',
+            objectType: 'page',
+            objectId: '98765',
+            payload: {
+                id: '98765',
+                title: 'Release Plan',
+                status: 'current',
+                spaceId: '12345',
+                body: { storage: { value: '<p>Ship carefully.</p>', representation: 'storage' } },
+            },
+        });
+        assert.equal(result.filesWritten, 1);
+        assert.equal(client.writes[0]?.path, '/confluence/spaces/12345/pages/release-plan--98765.json');
+        assert.deepEqual(client.writes[0]?.semantics?.relations, [
+            confluenceSpacePath('12345'),
+        ]);
+        assert.equal(client.writes[0]?.semantics?.comments?.[0], 'Ship carefully.');
+    });
+    it('resolves Confluence read requests to Cloud REST API v2 paths', () => {
+        assert.deepEqual(resolveConfluenceReadRequest('/confluence/pages'), {
+            action: 'list_pages',
+            method: 'GET',
+            endpoint: '/wiki/api/v2/pages',
+            query: { limit: '100', 'body-format': 'storage' },
+        });
+        assert.deepEqual(resolveConfluenceReadRequest('/confluence/spaces/12345/pages'), {
+            action: 'list_space_pages',
+            method: 'GET',
+            endpoint: '/wiki/api/v2/pages',
+            query: { limit: '100', 'body-format': 'storage', 'space-id': '12345' },
+        });
+        assert.deepEqual(resolveConfluenceReadRequest('/confluence/pages/release-plan--98765.json'), {
+            action: 'get_page',
+            method: 'GET',
+            endpoint: '/wiki/api/v2/pages/98765',
+            query: { 'body-format': 'storage', 'get-draft': 'true' },
+        });
+    });
+    it('resolves nested page creates with the space id from the path', () => {
+        assert.deepEqual(resolveConfluenceWritebackRequest('/confluence/spaces/12345/pages/draft.json', JSON.stringify({
+            title: 'Release Plan',
+            body: '<p>Ship carefully.</p>',
+        })), {
+            action: 'create_page',
+            method: 'POST',
+            endpoint: '/wiki/api/v2/pages',
+            body: {
+                spaceId: '12345',
+                status: 'current',
+                title: 'Release Plan',
+                body: { representation: 'storage', value: '<p>Ship carefully.</p>' },
+            },
+        });
+    });
+    it('resolves page updates and increments synced version numbers', () => {
+        assert.deepEqual(resolveConfluenceWritebackRequest('/confluence/pages/release-plan--98765.json', JSON.stringify({
+            provider: 'confluence',
+            objectType: 'page',
+            objectId: '98765',
+            workspaceId: 'workspace-1',
+            payload: {
+                title: 'Release Plan',
+                status: 'current',
+                spaceId: '12345',
+                version: { number: 7, message: 'sync update', minorEdit: true },
+                body: { storage: { value: '<p>Updated.</p>', representation: 'storage' } },
+            },
+        })), {
+            action: 'update_page',
+            method: 'PUT',
+            endpoint: '/wiki/api/v2/pages/98765',
+            body: {
+                id: '98765',
+                status: 'current',
+                title: 'Release Plan',
+                body: { representation: 'storage', value: '<p>Updated.</p>' },
+                spaceId: '12345',
+                version: { number: 8, message: 'sync update', minorEdit: true },
+            },
+        });
+    });
+    it('resolves page deletes and rejects read-only fields', () => {
+        assert.deepEqual(resolveConfluenceDeleteRequest('/confluence/pages/release-plan--98765.json'), {
+            action: 'delete_page',
+            method: 'DELETE',
+            endpoint: '/wiki/api/v2/pages/98765',
+        });
+        assert.throws(() => resolveConfluenceWritebackRequest('/confluence/pages/draft.json', JSON.stringify({
+            id: '98765',
+            title: 'Release Plan',
+            spaceId: '12345',
+            body: '<p>Ship carefully.</p>',
+        })), ReadOnlyFieldError);
+    });
+});
+//# sourceMappingURL=confluence-adapter.test.js.map

package/dist/__tests__/confluence-adapter.test.js.map

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

package/dist/confluence-adapter.d.ts

@@ -0,0 +1,44 @@
+import type { ConnectionProvider } from '@relayfile/sdk';
+export type { ConnectionProvider, ProxyRequest, ProxyResponse } from '@relayfile/sdk';
+export type { DeleteFileInput, FileSemantics, RelayFileClientLike, WriteFileInput, WriteFileResult, } from './types.js';
+import { type ConfluenceAdapterConfig, type ConfluenceNormalizedEvent, type ConfluencePage, type ConfluenceSpace, type FileSemantics, type RelayFileClientLike } from './types.js';
+export interface IngestError {
+    path: string;
+    error: string;
+}
+export interface IngestResult {
+    filesWritten: number;
+    filesUpdated: number;
+    filesDeleted: number;
+    paths: string[];
+    errors: IngestError[];
+}
+export declare class ConfluenceAdapter {
+    protected readonly client: RelayFileClientLike;
+    protected readonly provider: ConnectionProvider;
+    readonly config: ConfluenceAdapterConfig;
+    readonly name = "confluence";
+    readonly version = "0.1.0";
+    constructor(client: RelayFileClientLike, provider: ConnectionProvider, config?: ConfluenceAdapterConfig);
+    supportedEvents(): string[];
+    computePath(objectType: string, objectId: string, options?: {
+        title?: string;
+        spaceId?: string;
+    }): string;
+    computeSemantics(objectType: string, objectId: string, payload: Record<string, unknown>): FileSemantics;
+    ingestWebhook(workspaceId: string, event: ConfluenceNormalizedEvent | Record<string, unknown>): Promise<IngestResult>;
+    writeBack(path: string, content: string): import("./types.js").ConfluenceWritebackRequest;
+    materializeSpace(space: ConfluenceSpace): {
+        path: string;
+        payload: Record<string, unknown>;
+    };
+    materializePage(page: ConfluencePage): {
+        path: string;
+        payload: Record<string, unknown>;
+    };
+    protected normalizeEvent(event: ConfluenceNormalizedEvent | Record<string, unknown>): ConfluenceNormalizedEvent;
+    protected pathForEvent(event: ConfluenceNormalizedEvent): string;
+    protected isDeleteEvent(event: ConfluenceNormalizedEvent): boolean;
+    protected renderContent(workspaceId: string, event: ConfluenceNormalizedEvent, deleted: boolean): string;
+}
+//# sourceMappingURL=confluence-adapter.d.ts.map

package/dist/confluence-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confluence-adapter.d.ts","sourceRoot":"","sources":["../src/confluence-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACtF,YAAY,EACV,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AAOpB,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAID,qBAAa,iBAAiB;IAK1B,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB;IAC9C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB;IAC/C,QAAQ,CAAC,MAAM,EAAE,uBAAuB;IAN1C,QAAQ,CAAC,IAAI,gBAA4B;IACzC,QAAQ,CAAC,OAAO,WAAW;gBAGN,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,kBAAkB,EACtC,MAAM,GAAE,uBAA4B;IAG/C,eAAe,IAAI,MAAM,EAAE;IAW3B,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,MAAM;IAI7G,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa;IAsCjG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAuC3H,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAIvC,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;IAY5F,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;IAYzF,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,yBAAyB;IAgC/G,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM;IAShE,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO;IAIlE,SAAS,CAAC,aAAa,CACrB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,yBAAyB,EAChC,OAAO,EAAE,OAAO,GACf,MAAM;CAeV"}