@appport/contract-builder 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +396 -0
- package/dist/compatibility.d.ts +24 -0
- package/dist/compatibility.d.ts.map +1 -0
- package/dist/compatibility.js +86 -0
- package/dist/compatibility.js.map +1 -0
- package/dist/contract.d.ts +258 -0
- package/dist/contract.d.ts.map +1 -0
- package/dist/contract.js +316 -0
- package/dist/contract.js.map +1 -0
- package/dist/diff.d.ts +32 -0
- package/dist/diff.d.ts.map +1 -0
- package/dist/diff.js +110 -0
- package/dist/diff.js.map +1 -0
- package/dist/generators/python-server.d.ts +13 -0
- package/dist/generators/python-server.d.ts.map +1 -0
- package/dist/generators/python-server.js +193 -0
- package/dist/generators/python-server.js.map +1 -0
- package/dist/generators/stubs.d.ts +10 -0
- package/dist/generators/stubs.d.ts.map +1 -0
- package/dist/generators/stubs.js +58 -0
- package/dist/generators/stubs.js.map +1 -0
- package/dist/generators/typescript-server.d.ts +12 -0
- package/dist/generators/typescript-server.d.ts.map +1 -0
- package/dist/generators/typescript-server.js +190 -0
- package/dist/generators/typescript-server.js.map +1 -0
- package/dist/hooks.d.ts +73 -0
- package/dist/hooks.d.ts.map +1 -0
- package/dist/hooks.js +55 -0
- package/dist/hooks.js.map +1 -0
- package/dist/index.d.ts +10 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +10 -0
- package/dist/index.js.map +1 -0
- package/dist/manifest.d.ts +23 -0
- package/dist/manifest.d.ts.map +1 -0
- package/dist/manifest.js +148 -0
- package/dist/manifest.js.map +1 -0
- package/dist/validate.d.ts +12 -0
- package/dist/validate.d.ts.map +1 -0
- package/dist/validate.js +238 -0
- package/dist/validate.js.map +1 -0
- package/package.json +29 -0
package/dist/diff.js
ADDED
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Compare two contracts and produce a diff.
|
|
3
|
+
*/
|
|
4
|
+
export function diffContracts(from, to) {
|
|
5
|
+
const diff = {
|
|
6
|
+
capabilities: [],
|
|
7
|
+
events: [],
|
|
8
|
+
requirements: [],
|
|
9
|
+
hasBreakingChanges: false
|
|
10
|
+
};
|
|
11
|
+
// Build lookup maps
|
|
12
|
+
const fromCapabilities = new Map(from.capabilities.map(c => [`${c.name}@${c.version}`, c]));
|
|
13
|
+
const toCapabilities = new Map(to.capabilities.map(c => [`${c.name}@${c.version}`, c]));
|
|
14
|
+
const fromEvents = new Map(from.events.map(e => [`${e.name}@${e.version}`, e]));
|
|
15
|
+
const toEvents = new Map(to.events.map(e => [`${e.name}@${e.version}`, e]));
|
|
16
|
+
const fromRequirements = new Map((from.requires || []).map(r => [r.name, r]));
|
|
17
|
+
const toRequirements = new Map((to.requires || []).map(r => [r.name, r]));
|
|
18
|
+
// Find capability changes
|
|
19
|
+
for (const [key, toCap] of toCapabilities) {
|
|
20
|
+
if (!fromCapabilities.has(key)) {
|
|
21
|
+
diff.capabilities.push({
|
|
22
|
+
type: "added",
|
|
23
|
+
name: toCap.name,
|
|
24
|
+
version: toCap.version
|
|
25
|
+
});
|
|
26
|
+
}
|
|
27
|
+
else {
|
|
28
|
+
const fromCap = fromCapabilities.get(key);
|
|
29
|
+
// Check if input/output schemas changed
|
|
30
|
+
if (JSON.stringify(fromCap.input) !== JSON.stringify(toCap.input) ||
|
|
31
|
+
JSON.stringify(fromCap.output) !== JSON.stringify(toCap.output)) {
|
|
32
|
+
// This is a simplification - a more sophisticated diff would check input additions
|
|
33
|
+
diff.capabilities.push({
|
|
34
|
+
type: "modified",
|
|
35
|
+
name: toCap.name,
|
|
36
|
+
version: toCap.version
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
for (const [key, fromCap] of fromCapabilities) {
|
|
42
|
+
if (!toCapabilities.has(key)) {
|
|
43
|
+
diff.capabilities.push({
|
|
44
|
+
type: "removed",
|
|
45
|
+
name: fromCap.name,
|
|
46
|
+
version: fromCap.version,
|
|
47
|
+
breaking: true
|
|
48
|
+
});
|
|
49
|
+
diff.hasBreakingChanges = true;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
// Find event changes
|
|
53
|
+
for (const [key, toEvent] of toEvents) {
|
|
54
|
+
if (!fromEvents.has(key)) {
|
|
55
|
+
diff.events.push({
|
|
56
|
+
type: "added",
|
|
57
|
+
name: toEvent.name,
|
|
58
|
+
version: toEvent.version
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
for (const [key, fromEvent] of fromEvents) {
|
|
63
|
+
if (!toEvents.has(key)) {
|
|
64
|
+
diff.events.push({
|
|
65
|
+
type: "removed",
|
|
66
|
+
name: fromEvent.name,
|
|
67
|
+
version: fromEvent.version
|
|
68
|
+
});
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
// Find requirement changes
|
|
72
|
+
for (const [name, toReq] of toRequirements) {
|
|
73
|
+
if (!fromRequirements.has(name)) {
|
|
74
|
+
diff.requirements.push({
|
|
75
|
+
type: "added",
|
|
76
|
+
name: toReq.name,
|
|
77
|
+
versionConstraint: toReq.versionConstraint
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
else {
|
|
81
|
+
const fromReq = fromRequirements.get(name);
|
|
82
|
+
// Check if version constraint or provider changed
|
|
83
|
+
if (fromReq.versionConstraint !== toReq.versionConstraint ||
|
|
84
|
+
JSON.stringify(fromReq.provider) !== JSON.stringify(toReq.provider)) {
|
|
85
|
+
// Changing version constraint might be breaking if it becomes more restrictive
|
|
86
|
+
const breaking = fromReq.versionConstraint !== toReq.versionConstraint;
|
|
87
|
+
diff.requirements.push({
|
|
88
|
+
type: "modified",
|
|
89
|
+
name: toReq.name,
|
|
90
|
+
versionConstraint: toReq.versionConstraint,
|
|
91
|
+
breaking
|
|
92
|
+
});
|
|
93
|
+
if (breaking) {
|
|
94
|
+
diff.hasBreakingChanges = true;
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
for (const [name, fromReq] of fromRequirements) {
|
|
100
|
+
if (!toRequirements.has(name)) {
|
|
101
|
+
diff.requirements.push({
|
|
102
|
+
type: "removed",
|
|
103
|
+
name: fromReq.name,
|
|
104
|
+
versionConstraint: fromReq.versionConstraint
|
|
105
|
+
});
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
return diff;
|
|
109
|
+
}
|
|
110
|
+
//# sourceMappingURL=diff.js.map
|
package/dist/diff.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"diff.js","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { Contract } from "../contract.js";
|
|
2
|
+
export interface GeneratedPythonServer {
|
|
3
|
+
"appport/config.py": string;
|
|
4
|
+
"appport/__init__.py": string;
|
|
5
|
+
"appport/capabilities.py": string;
|
|
6
|
+
"appport/events.py": string;
|
|
7
|
+
"appport/server.py": string;
|
|
8
|
+
"requirements.txt": string;
|
|
9
|
+
"README.md": string;
|
|
10
|
+
[key: string]: string;
|
|
11
|
+
}
|
|
12
|
+
export declare function generatePythonServer(contract: Contract): GeneratedPythonServer;
|
|
13
|
+
//# sourceMappingURL=python-server.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"python-server.d.ts","sourceRoot":"","sources":["../../src/generators/python-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAqC,MAAM,gBAAgB,CAAC;AAElF,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yBAAyB,EAAE,MAAM,CAAC;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AA6BD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,qBAAqB,CAqK9E"}
|
|
@@ -0,0 +1,193 @@
|
|
|
1
|
+
function snakeCase(str) {
|
|
2
|
+
return str
|
|
3
|
+
.replace(/\./g, "_")
|
|
4
|
+
.replace(/([a-z])([A-Z])/g, "$1_$2")
|
|
5
|
+
.toLowerCase();
|
|
6
|
+
}
|
|
7
|
+
function pascalCase(str) {
|
|
8
|
+
return str
|
|
9
|
+
.split(".")
|
|
10
|
+
.map(part => part.charAt(0).toUpperCase() + part.slice(1))
|
|
11
|
+
.join("");
|
|
12
|
+
}
|
|
13
|
+
function formatPythonType(schema) {
|
|
14
|
+
if (!schema || typeof schema !== "object")
|
|
15
|
+
return "Any";
|
|
16
|
+
const type = schema.type;
|
|
17
|
+
if (type === "string")
|
|
18
|
+
return "str";
|
|
19
|
+
if (type === "number")
|
|
20
|
+
return "float";
|
|
21
|
+
if (type === "integer")
|
|
22
|
+
return "int";
|
|
23
|
+
if (type === "boolean")
|
|
24
|
+
return "bool";
|
|
25
|
+
if (type === "object")
|
|
26
|
+
return "dict";
|
|
27
|
+
if (type === "array")
|
|
28
|
+
return "list";
|
|
29
|
+
return "Any";
|
|
30
|
+
}
|
|
31
|
+
export function generatePythonServer(contract) {
|
|
32
|
+
const appId = contract.application.id;
|
|
33
|
+
const appName = contract.application.name;
|
|
34
|
+
const appVersion = contract.application.version;
|
|
35
|
+
const capabilityDefs = contract.capabilities
|
|
36
|
+
.map(cap => {
|
|
37
|
+
const funcName = snakeCase(cap.name);
|
|
38
|
+
const returnType = formatPythonType(cap.output);
|
|
39
|
+
return `@appport.capability(
|
|
40
|
+
name="${cap.name}",
|
|
41
|
+
version=${cap.version},
|
|
42
|
+
description="${(cap.description || "").replace(/\\/g, "\\\\").replace(/"/g, '\\"')}",
|
|
43
|
+
authorization=${JSON.stringify(cap.authorization || [])}
|
|
44
|
+
)
|
|
45
|
+
async def ${funcName}(input_data: dict) -> ${returnType}:
|
|
46
|
+
"""
|
|
47
|
+
${cap.description || "Capability handler"}
|
|
48
|
+
"""
|
|
49
|
+
raise NotImplementedError("Implement ${cap.name}")
|
|
50
|
+
`;
|
|
51
|
+
})
|
|
52
|
+
.join("\n\n");
|
|
53
|
+
const eventDefs = contract.events
|
|
54
|
+
.map(event => {
|
|
55
|
+
const varName = snakeCase(event.name);
|
|
56
|
+
return `${varName} = {
|
|
57
|
+
"name": "${event.name}",
|
|
58
|
+
"version": ${event.version},
|
|
59
|
+
"description": "${(event.description || "").replace(/\\/g, "\\\\").replace(/"/g, '\\"')}",
|
|
60
|
+
"authorization": ${JSON.stringify(event.authorization || [])}
|
|
61
|
+
}`;
|
|
62
|
+
})
|
|
63
|
+
.join("\n\n");
|
|
64
|
+
return {
|
|
65
|
+
"appport/config.py": `"""
|
|
66
|
+
AppPort application configuration for ${appName}
|
|
67
|
+
"""
|
|
68
|
+
|
|
69
|
+
APPLICATION_ID = "${appId}"
|
|
70
|
+
APPLICATION_NAME = "${appName}"
|
|
71
|
+
APPLICATION_VERSION = "${appVersion}"
|
|
72
|
+
DESCRIPTION = "${(contract.application.description || "").replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"
|
|
73
|
+
|
|
74
|
+
# Supported transports
|
|
75
|
+
TRANSPORTS = ["http", "websocket"]
|
|
76
|
+
|
|
77
|
+
# Authorization
|
|
78
|
+
DEFAULT_AUTHORIZATION = []
|
|
79
|
+
`,
|
|
80
|
+
"appport/__init__.py": `"""
|
|
81
|
+
${appName} AppPort application
|
|
82
|
+
"""
|
|
83
|
+
|
|
84
|
+
__version__ = "${appVersion}"
|
|
85
|
+
__all__ = ["create_server", "capabilities", "events"]
|
|
86
|
+
`,
|
|
87
|
+
"appport/capabilities.py": `"""
|
|
88
|
+
Capability handlers for ${appName}
|
|
89
|
+
"""
|
|
90
|
+
|
|
91
|
+
import asyncio
|
|
92
|
+
from typing import Any, AsyncGenerator
|
|
93
|
+
|
|
94
|
+
${capabilityDefs}
|
|
95
|
+
`,
|
|
96
|
+
"appport/events.py": `"""
|
|
97
|
+
Event definitions for ${appName}
|
|
98
|
+
"""
|
|
99
|
+
|
|
100
|
+
${eventDefs}
|
|
101
|
+
|
|
102
|
+
# All events
|
|
103
|
+
EVENTS = {
|
|
104
|
+
${contract.events.map(e => `"${e.name}": ${snakeCase(e.name)}`).join(",\n ")}
|
|
105
|
+
}
|
|
106
|
+
`,
|
|
107
|
+
"appport/server.py": `"""
|
|
108
|
+
AppPort server for ${appName}
|
|
109
|
+
"""
|
|
110
|
+
|
|
111
|
+
import asyncio
|
|
112
|
+
import logging
|
|
113
|
+
from typing import Any, Callable
|
|
114
|
+
|
|
115
|
+
from appport.config import APPLICATION_ID, APPLICATION_NAME, APPLICATION_VERSION
|
|
116
|
+
from appport.capabilities import *
|
|
117
|
+
from appport.events import EVENTS
|
|
118
|
+
|
|
119
|
+
logger = logging.getLogger(__name__)
|
|
120
|
+
|
|
121
|
+
class AppPortServer:
|
|
122
|
+
def __init__(self):
|
|
123
|
+
self.id = APPLICATION_ID
|
|
124
|
+
self.name = APPLICATION_NAME
|
|
125
|
+
self.version = APPLICATION_VERSION
|
|
126
|
+
self.capabilities = {}
|
|
127
|
+
self.events = EVENTS
|
|
128
|
+
self._setup_capabilities()
|
|
129
|
+
|
|
130
|
+
def _setup_capabilities(self):
|
|
131
|
+
"""Register all capabilities"""
|
|
132
|
+
# Capabilities are auto-registered via decorators
|
|
133
|
+
pass
|
|
134
|
+
|
|
135
|
+
async def run(self, host: str = "127.0.0.1", port: int = 4317):
|
|
136
|
+
"""Start the server"""
|
|
137
|
+
logger.info(f"Starting AppPort server: {self.name} ({self.id})")
|
|
138
|
+
logger.info(f"Listening on {host}:{port}")
|
|
139
|
+
|
|
140
|
+
# Start HTTP server
|
|
141
|
+
# Implementation depends on your preferred web framework
|
|
142
|
+
# (e.g., FastAPI, aiohttp, etc.)
|
|
143
|
+
raise NotImplementedError("Server implementation required")
|
|
144
|
+
|
|
145
|
+
async def main():
|
|
146
|
+
server = AppPortServer()
|
|
147
|
+
await server.run()
|
|
148
|
+
|
|
149
|
+
if __name__ == "__main__":
|
|
150
|
+
asyncio.run(main())
|
|
151
|
+
`,
|
|
152
|
+
"requirements.txt": `# AppPort Python dependencies
|
|
153
|
+
# Add your project dependencies here
|
|
154
|
+
`,
|
|
155
|
+
"README.md": `# ${appName} - Python Implementation
|
|
156
|
+
|
|
157
|
+
This is a Python implementation of the ${appName} AppPort contract.
|
|
158
|
+
|
|
159
|
+
## Structure
|
|
160
|
+
|
|
161
|
+
- \`config.py\` - Application configuration
|
|
162
|
+
- \`capabilities.py\` - Capability handlers
|
|
163
|
+
- \`events.py\` - Event definitions
|
|
164
|
+
- \`server.py\` - Server implementation
|
|
165
|
+
|
|
166
|
+
## Getting Started
|
|
167
|
+
|
|
168
|
+
1. Install dependencies:
|
|
169
|
+
\`\`\`bash
|
|
170
|
+
pip install -r requirements.txt
|
|
171
|
+
\`\`\`
|
|
172
|
+
|
|
173
|
+
2. Implement capability handlers in \`capabilities.py\`
|
|
174
|
+
|
|
175
|
+
3. Run the server:
|
|
176
|
+
\`\`\`bash
|
|
177
|
+
python -m appport.server
|
|
178
|
+
\`\`\`
|
|
179
|
+
|
|
180
|
+
## Development
|
|
181
|
+
|
|
182
|
+
\`\`\`bash
|
|
183
|
+
python -m pip install -e .
|
|
184
|
+
pytest
|
|
185
|
+
\`\`\`
|
|
186
|
+
|
|
187
|
+
## AppPort Contract
|
|
188
|
+
|
|
189
|
+
This implementation conforms to the AppPort contract defined in the parent project.
|
|
190
|
+
`
|
|
191
|
+
};
|
|
192
|
+
}
|
|
193
|
+
//# sourceMappingURL=python-server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"python-server.js","sourceRoot":"","sources":["../../src/generators/python-server.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { ContractCapability, ContractEvent } from "../contract.js";
|
|
2
|
+
/**
|
|
3
|
+
* Generate a stub for a single capability.
|
|
4
|
+
*/
|
|
5
|
+
export declare function generateCapabilitySkeleton(capability: ContractCapability): string;
|
|
6
|
+
/**
|
|
7
|
+
* Generate a stub for a single event.
|
|
8
|
+
*/
|
|
9
|
+
export declare function generateEventSkeleton(event: ContractEvent): string;
|
|
10
|
+
//# sourceMappingURL=stubs.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"stubs.d.ts","sourceRoot":"","sources":["../../src/generators/stubs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAExE;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAqCjF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAelE"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Generate a stub for a single capability.
|
|
3
|
+
*/
|
|
4
|
+
export function generateCapabilitySkeleton(capability) {
|
|
5
|
+
const camelCaseStr = (str) => str
|
|
6
|
+
.replace(/\./g, " ")
|
|
7
|
+
.replace(/\w\S*/g, (w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
|
|
8
|
+
.replace(/\s+/g, "");
|
|
9
|
+
const functionName = camelCaseStr(capability.name);
|
|
10
|
+
const varName = functionName[0].toLowerCase() + functionName.slice(1);
|
|
11
|
+
return `import { define${capability.kind === "stream" ? "Stream" : ""}Capability } from "@appport/core";
|
|
12
|
+
import { s } from "@appport/schema";
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* ${capability.name}@${capability.version}
|
|
16
|
+
* ${capability.description || ""}
|
|
17
|
+
*/
|
|
18
|
+
export const ${varName} = define${capability.kind === "stream" ? "Stream" : ""}Capability({
|
|
19
|
+
name: "${capability.name}",
|
|
20
|
+
version: ${capability.version},
|
|
21
|
+
description: "${capability.description || ""}",
|
|
22
|
+
${capability.authorization && capability.authorization.length > 0 ? `authorization: [${capability.authorization.map(a => `"${a}"`).join(", ")}],` : "authorization: [],"}
|
|
23
|
+
${capability.idempotency ? `idempotency: "${capability.idempotency}",` : ""}
|
|
24
|
+
${capability.concurrency ? `concurrency: ${JSON.stringify(capability.concurrency)},` : ""}
|
|
25
|
+
input: ${JSON.stringify(capability.input)},
|
|
26
|
+
output: ${JSON.stringify(capability.output)},
|
|
27
|
+
${capability.kind === "stream"
|
|
28
|
+
? `async handler(input, context) {
|
|
29
|
+
return (async function* () {
|
|
30
|
+
throw new Error("Not implemented");
|
|
31
|
+
})();
|
|
32
|
+
}`
|
|
33
|
+
: `async handler(input, context) {
|
|
34
|
+
throw new Error("Not implemented");
|
|
35
|
+
}`}
|
|
36
|
+
});
|
|
37
|
+
`;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Generate a stub for a single event.
|
|
41
|
+
*/
|
|
42
|
+
export function generateEventSkeleton(event) {
|
|
43
|
+
return `import type { JSONSchema } from "@appport/protocol";
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* ${event.name}@${event.version}
|
|
47
|
+
* ${event.description || ""}
|
|
48
|
+
*/
|
|
49
|
+
export const ${event.name.replace(/\./g, "")} = {
|
|
50
|
+
name: "${event.name}",
|
|
51
|
+
version: ${event.version},
|
|
52
|
+
description: "${event.description || ""}",
|
|
53
|
+
${event.authorization && event.authorization.length > 0 ? `authorization: [${event.authorization.map(a => `"${a}"`).join(", ")}],` : "authorization: [],"}
|
|
54
|
+
payload: ${JSON.stringify(event.payload)}
|
|
55
|
+
};
|
|
56
|
+
`;
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=stubs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"stubs.js","sourceRoot":"","sources":["../../src/generators/stubs.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,UAA8B;IACvE,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,EAAE,CACnC,GAAG;SACA,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9E,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEzB,MAAM,YAAY,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEvE,OAAO,kBAAkB,UAAU,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;;;;KAIlE,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,OAAO;KACrC,UAAU,CAAC,WAAW,IAAI,EAAE;;eAElB,OAAO,YAAY,UAAU,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;WACnE,UAAU,CAAC,IAAI;aACb,UAAU,CAAC,OAAO;kBACb,UAAU,CAAC,WAAW,IAAI,EAAE;IAC1C,UAAU,CAAC,aAAa,IAAI,UAAU,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB;IACtK,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,UAAU,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE;IACzE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;WAChF,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC;IACzC,UAAU,CAAC,IAAI,KAAK,QAAQ;QAC5B,CAAC,CAAC;;;;IAIF;QACA,CAAC,CAAC;;IAEF;;CAEH,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAoB;IACxD,OAAO;;;KAGJ,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO;KAC3B,KAAK,CAAC,WAAW,IAAI,EAAE;;eAEb,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;WACjC,KAAK,CAAC,IAAI;aACR,KAAK,CAAC,OAAO;kBACR,KAAK,CAAC,WAAW,IAAI,EAAE;IACrC,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB;aAC9I,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;;CAEzC,CAAC;AACF,CAAC"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Contract } from "../contract.js";
|
|
2
|
+
export interface GeneratedTypescriptServer {
|
|
3
|
+
"appport/config.ts": string;
|
|
4
|
+
"appport/capabilities/index.ts": string;
|
|
5
|
+
"appport/events.ts": string;
|
|
6
|
+
"appport/server.ts": string;
|
|
7
|
+
"appport/client.ts": string;
|
|
8
|
+
"appport/README.md": string;
|
|
9
|
+
[key: string]: string;
|
|
10
|
+
}
|
|
11
|
+
export declare function generateTypescriptServer(contract: Contract): GeneratedTypescriptServer;
|
|
12
|
+
//# sourceMappingURL=typescript-server.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"typescript-server.d.ts","sourceRoot":"","sources":["../../src/generators/typescript-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAqC,MAAM,gBAAgB,CAAC;AAElF,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+BAA+B,EAAE,MAAM,CAAC;IACxC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAqID,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,yBAAyB,CA0EtF"}
|
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
function formatJsonSchema(schema, indent = 0) {
|
|
2
|
+
const spaces = " ".repeat(indent);
|
|
3
|
+
const nextSpaces = " ".repeat(indent + 2);
|
|
4
|
+
const entries = Object.entries(schema);
|
|
5
|
+
if (entries.length === 0) {
|
|
6
|
+
return "{}";
|
|
7
|
+
}
|
|
8
|
+
const lines = entries.map(([key, value]) => {
|
|
9
|
+
if (value === null || value === undefined)
|
|
10
|
+
return "";
|
|
11
|
+
if (typeof value === "object" && !Array.isArray(value)) {
|
|
12
|
+
return `${nextSpaces}${key}: ${formatJsonSchema(value, indent + 2)},`;
|
|
13
|
+
}
|
|
14
|
+
else if (Array.isArray(value)) {
|
|
15
|
+
const items = value.map(item => typeof item === "object" ? formatJsonSchema(item, indent + 4) : JSON.stringify(item)).join(", ");
|
|
16
|
+
return `${nextSpaces}${key}: [${items}],`;
|
|
17
|
+
}
|
|
18
|
+
else {
|
|
19
|
+
return `${nextSpaces}${key}: ${JSON.stringify(value)},`;
|
|
20
|
+
}
|
|
21
|
+
}).filter(Boolean);
|
|
22
|
+
return `{\n${lines.join("\n")}\n${spaces}}`;
|
|
23
|
+
}
|
|
24
|
+
function camelCase(str) {
|
|
25
|
+
return str
|
|
26
|
+
.replace(/\./g, " ")
|
|
27
|
+
.replace(/\w\S*/g, (w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
|
|
28
|
+
.replace(/\s+/g, "");
|
|
29
|
+
}
|
|
30
|
+
function generateCapabilityFile(capability) {
|
|
31
|
+
const functionName = camelCase(capability.name);
|
|
32
|
+
const varName = functionName[0].toLowerCase() + functionName.slice(1);
|
|
33
|
+
const inputSchema = JSON.stringify(capability.input, null, 4).split("\n").map((line, i) => i === 0 ? line : " " + line).join("\n");
|
|
34
|
+
const outputSchema = JSON.stringify(capability.output, null, 4).split("\n").map((line, i) => i === 0 ? line : " " + line).join("\n");
|
|
35
|
+
return `import { define${capability.kind === "stream" ? "Stream" : ""}Capability } from "@appport/core";
|
|
36
|
+
import { s } from "@appport/schema";
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* ${capability.name}@${capability.version}
|
|
40
|
+
* ${capability.description || ""}
|
|
41
|
+
*/
|
|
42
|
+
export const ${varName} = define${capability.kind === "stream" ? "Stream" : ""}Capability({
|
|
43
|
+
name: "${capability.name}",
|
|
44
|
+
version: ${capability.version},
|
|
45
|
+
description: "${(capability.description || "").replace(/\\/g, "\\\\").replace(/"/g, '\\"')}",
|
|
46
|
+
${capability.authorization && capability.authorization.length > 0 ? `authorization: [${capability.authorization.map(a => `"${a}"`).join(", ")}],` : "authorization: [],"}
|
|
47
|
+
${capability.idempotency ? `idempotency: "${capability.idempotency}",` : ""}
|
|
48
|
+
${capability.concurrency ? `concurrency: ${JSON.stringify(capability.concurrency)},` : ""}
|
|
49
|
+
input: ${inputSchema},
|
|
50
|
+
output: ${outputSchema},
|
|
51
|
+
${capability.kind === "stream"
|
|
52
|
+
? `async handler(input, context) {
|
|
53
|
+
return (async function* () {
|
|
54
|
+
throw new Error("Not implemented");
|
|
55
|
+
})();
|
|
56
|
+
}`
|
|
57
|
+
: `async handler(input, context) {
|
|
58
|
+
throw new Error("Not implemented");
|
|
59
|
+
}`}
|
|
60
|
+
});
|
|
61
|
+
`;
|
|
62
|
+
}
|
|
63
|
+
function generateCapabilitiesIndex(capabilities) {
|
|
64
|
+
const imports = capabilities
|
|
65
|
+
.map(cap => {
|
|
66
|
+
const functionName = camelCase(cap.name);
|
|
67
|
+
const varName = functionName[0].toLowerCase() + functionName.slice(1);
|
|
68
|
+
const fileName = cap.name.replace(/\./g, "-");
|
|
69
|
+
return `import { ${varName} } from "./${fileName}.js";`;
|
|
70
|
+
})
|
|
71
|
+
.join("\n");
|
|
72
|
+
const exports = capabilities
|
|
73
|
+
.map(cap => {
|
|
74
|
+
const functionName = camelCase(cap.name);
|
|
75
|
+
const varName = functionName[0].toLowerCase() + functionName.slice(1);
|
|
76
|
+
return varName;
|
|
77
|
+
})
|
|
78
|
+
.join(",\n ");
|
|
79
|
+
return `${imports}
|
|
80
|
+
|
|
81
|
+
export const capabilities = [
|
|
82
|
+
${exports}
|
|
83
|
+
];
|
|
84
|
+
`;
|
|
85
|
+
}
|
|
86
|
+
function generateEventsFile(events) {
|
|
87
|
+
if (events.length === 0) {
|
|
88
|
+
return `/**
|
|
89
|
+
* Define application events here.
|
|
90
|
+
* Events are published when capabilities emit them.
|
|
91
|
+
*/
|
|
92
|
+
|
|
93
|
+
export const events = [];
|
|
94
|
+
`;
|
|
95
|
+
}
|
|
96
|
+
const eventDefs = events
|
|
97
|
+
.map(event => {
|
|
98
|
+
const payloadSchema = JSON.stringify(event.payload, null, 2).split("\n").map((line, i) => i === 0 ? line : " " + line).join("\n");
|
|
99
|
+
return `export const ${event.name.replace(/\./g, "")} = {
|
|
100
|
+
name: "${event.name}",
|
|
101
|
+
version: ${event.version},
|
|
102
|
+
description: "${(event.description || "").replace(/\\/g, "\\\\").replace(/"/g, '\\"')}",
|
|
103
|
+
${event.authorization && event.authorization.length > 0 ? `authorization: [${event.authorization.map(a => `"${a}"`).join(", ")}],` : "authorization: [],"}
|
|
104
|
+
payload: ${payloadSchema}
|
|
105
|
+
};`;
|
|
106
|
+
})
|
|
107
|
+
.join("\n\n");
|
|
108
|
+
const eventsList = events
|
|
109
|
+
.map(event => `${event.name.replace(/\./g, "")}`)
|
|
110
|
+
.join(",\n ");
|
|
111
|
+
return `${eventDefs}
|
|
112
|
+
|
|
113
|
+
export const events = [
|
|
114
|
+
${eventsList}
|
|
115
|
+
];
|
|
116
|
+
`;
|
|
117
|
+
}
|
|
118
|
+
export function generateTypescriptServer(contract) {
|
|
119
|
+
const appId = contract.application.id;
|
|
120
|
+
const appName = contract.application.name;
|
|
121
|
+
const appVersion = contract.application.version;
|
|
122
|
+
return {
|
|
123
|
+
"appport/config.ts": `import { defineApplication } from "@appport/core";
|
|
124
|
+
|
|
125
|
+
export default defineApplication({
|
|
126
|
+
applicationId: "${appId}",
|
|
127
|
+
applicationName: "${appName}",
|
|
128
|
+
applicationVersion: "${appVersion}",
|
|
129
|
+
outDir: "./appport/generated"
|
|
130
|
+
});
|
|
131
|
+
`,
|
|
132
|
+
"appport/capabilities/index.ts": generateCapabilitiesIndex(contract.capabilities),
|
|
133
|
+
...Object.fromEntries(contract.capabilities.map(cap => [
|
|
134
|
+
`appport/capabilities/${cap.name.replace(/\./g, "-")}.ts`,
|
|
135
|
+
generateCapabilityFile(cap)
|
|
136
|
+
])),
|
|
137
|
+
"appport/events.ts": generateEventsFile(contract.events),
|
|
138
|
+
"appport/server.ts": `import { createServer } from "@appport/server/node";
|
|
139
|
+
import { createInProcessTransport } from "@appport/transport-inprocess";
|
|
140
|
+
import { createHttpTransport } from "@appport/transport-http";
|
|
141
|
+
import { createWebSocketTransport } from "@appport/transport-websocket";
|
|
142
|
+
import config from "./config.js";
|
|
143
|
+
import { capabilities } from "./capabilities/index.js";
|
|
144
|
+
|
|
145
|
+
const server = createServer(config, capabilities);
|
|
146
|
+
server.advertiseTransport(createInProcessTransport());
|
|
147
|
+
server.advertiseTransport(createHttpTransport());
|
|
148
|
+
server.advertiseTransport(createWebSocketTransport());
|
|
149
|
+
|
|
150
|
+
export { server };
|
|
151
|
+
`,
|
|
152
|
+
"appport/client.ts": `import { createClient } from "@appport/client";
|
|
153
|
+
|
|
154
|
+
/**
|
|
155
|
+
* Create a typed client for this application.
|
|
156
|
+
* Usage: const app = await createAppClient(transport);
|
|
157
|
+
*/
|
|
158
|
+
export async function createAppClient(transport: any) {
|
|
159
|
+
return createClient(transport);
|
|
160
|
+
}
|
|
161
|
+
`,
|
|
162
|
+
"appport/README.md": `# ${appName} AppPort Contract
|
|
163
|
+
|
|
164
|
+
This directory contains the AppPort contract for ${appName}.
|
|
165
|
+
|
|
166
|
+
## Structure
|
|
167
|
+
|
|
168
|
+
- \`config.ts\` - Application configuration
|
|
169
|
+
- \`capabilities/\` - Capability implementations
|
|
170
|
+
- \`events.ts\` - Event definitions
|
|
171
|
+
- \`server.ts\` - Server setup
|
|
172
|
+
- \`client.ts\` - Client factory
|
|
173
|
+
|
|
174
|
+
## Getting Started
|
|
175
|
+
|
|
176
|
+
1. Implement the handler functions in \`capabilities/\`
|
|
177
|
+
2. Run \`appport dev\` to start the development server
|
|
178
|
+
3. Test with the Studio UI at http://localhost:4317/studio
|
|
179
|
+
|
|
180
|
+
## Development
|
|
181
|
+
|
|
182
|
+
\`\`\`bash
|
|
183
|
+
npm run dev # Start development server
|
|
184
|
+
npm run build # Build generated artifacts
|
|
185
|
+
npm run test # Run tests
|
|
186
|
+
\`\`\`
|
|
187
|
+
`
|
|
188
|
+
};
|
|
189
|
+
}
|
|
190
|
+
//# sourceMappingURL=typescript-server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"typescript-server.js","sourceRoot":"","sources":["../../src/generators/typescript-server.ts"],"names":[],"mappings":"AAYA,SAAS,gBAAgB,CAAC,MAAc,EAAE,SAAiB,CAAC;IAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACzC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,OAAO,GAAG,UAAU,GAAG,GAAG,KAAK,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC;QACxE,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAC7B,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CACrF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,OAAO,GAAG,UAAU,GAAG,GAAG,MAAM,KAAK,IAAI,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,UAAU,GAAG,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,OAAO,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,MAAM,GAAG,CAAC;AAC9C,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG;SACP,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9E,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,sBAAsB,CAAC,UAA8B;IAC5D,MAAM,YAAY,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEvE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpI,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEtI,OAAO,kBAAkB,UAAU,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;;;;KAIlE,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,OAAO;KACrC,UAAU,CAAC,WAAW,IAAI,EAAE;;eAElB,OAAO,YAAY,UAAU,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;WACnE,UAAU,CAAC,IAAI;aACb,UAAU,CAAC,OAAO;kBACb,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;IACxF,UAAU,CAAC,aAAa,IAAI,UAAU,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB;IACtK,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,UAAU,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE;IACzE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;WAChF,WAAW;YACV,YAAY;IACpB,UAAU,CAAC,IAAI,KAAK,QAAQ;QAC5B,CAAC,CAAC;;;;IAIF;QACA,CAAC,CAAC;;IAEF;;CAEH,CAAC;AACF,CAAC;AAED,SAAS,yBAAyB,CAAC,YAAkC;IACnE,MAAM,OAAO,GAAG,YAAY;SACzB,GAAG,CAAC,GAAG,CAAC,EAAE;QACT,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9C,OAAO,YAAY,OAAO,cAAc,QAAQ,OAAO,CAAC;IAC1D,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,OAAO,GAAG,YAAY;SACzB,GAAG,CAAC,GAAG,CAAC,EAAE;QACT,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvE,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;SACD,IAAI,CAAC,OAAO,CAAC,CAAC;IAEjB,OAAO,GAAG,OAAO;;;IAGf,OAAO;;CAEV,CAAC;AACF,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAuB;IACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;;;;;;CAMV,CAAC;IACA,CAAC;IAED,MAAM,SAAS,GAAG,MAAM;SACrB,GAAG,CAAC,KAAK,CAAC,EAAE;QACX,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnI,OAAO,gBAAgB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;WAC/C,KAAK,CAAC,IAAI;aACR,KAAK,CAAC,OAAO;kBACR,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;IACnF,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB;aAC9I,aAAa;GACvB,CAAC;IACA,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,MAAM,UAAU,GAAG,MAAM;SACtB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;SAChD,IAAI,CAAC,OAAO,CAAC,CAAC;IAEjB,OAAO,GAAG,SAAS;;;IAGjB,UAAU;;CAEb,CAAC;AACF,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAkB;IACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;IAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC;IAEhD,OAAO;QACL,mBAAmB,EAAE;;;oBAGL,KAAK;sBACH,OAAO;yBACJ,UAAU;;;CAGlC;QACG,+BAA+B,EAAE,yBAAyB,CAAC,QAAQ,CAAC,YAAY,CAAC;QACjF,GAAG,MAAM,CAAC,WAAW,CACnB,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,wBAAwB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK;YACzD,sBAAsB,CAAC,GAAG,CAAC;SAC5B,CAAC,CACH;QACD,mBAAmB,EAAE,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC;QACxD,mBAAmB,EAAE;;;;;;;;;;;;;CAaxB;QACG,mBAAmB,EAAE;;;;;;;;;CASxB;QACG,mBAAmB,EAAE,KAAK,OAAO;;mDAEc,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuBzD;KACE,CAAC;AACJ,CAAC"}
|